 |
PK_FACE_make_neutral_sheet_o_t |
|
struct PK_FACE_make_neutral_sheet_o_s
{
int o_t_version; --- version number of option structure
PK_LOGICAL_t extend_and_fill_holes;
--- Extend, and fill holes in, multiple
--- face sheets
--- (PK_LOGICAL_true)
PK_LOGICAL_t have_tolerance; --- whether tolerance value is provided
--- (PK_LOGICAL_false)
double tolerance; --- tolerance on surface offsets
--- (0.0)
int n_methods; --- number of construction methods
--- (0)
const PK_neutral_method_t
*methods; --- array of construction methods
--- (NULL)
PK_LOGICAL_t make_sheet; --- whether to create a neutral sheet
--- (PK_LOGICAL_true)
PK_neutral_face_overlap_t
overlap; --- whether to enforce face overlaps
--- (PK_neutral_face_overlap_no_c)
PK_local_ops_update_t
update; --- update flag
--- (PK_local_ops_update_default_c)
};
typedef struct PK_FACE_make_neutral_sheet_o_s PK_FACE_make_neutral_sheet_o_t;
This options structure holds optional controls for
PK_FACE_make_neutral_sheet_2.
Used in:
PK_FACE_make_neutral_sheet_2
Description of fields:
'extend_and_fill_holes' This option controls whether multiple face sheets are
made large enough for trimming purposes against other
neutral sheets and side faces by extending and filling
holes.
'have_tolerance' Whether a tolerance has been provided. If this is
PK_LOGICAL_true, then 'tolerance' is used to determine
whether faces are offsets of each other. If this is
PK_LOGICAL_false, then 'tolerance' is ignored and faces
are only considered offsets if their surfaces are
geometrically exact offsets.
'tolerance' Tolerance for approximate offset classification.
'n_methods' Number of construction methods to use. Currently this
may only be set to one or zero. If zero, then the
default method PK_neutral_method_mid_offset_c will be
used for all face pairs. If 'n_methods' is neither zero
nor one, the error PK_ERROR_invalid_methods will be
returned.
'methods' The construction methods to use. Possible methods are:
PK_neutral_method_mid_offset_c:
Create neutral surfaces by offsetting between sets
of offset faces. If there are faces that are not
suitable offsets of each other, this method will
fail.
PK_neutral_method_offset_left_c:
Create neutral surfaces by offsetting the left set
of faces. Faces from opposite sides need not be
offsets of each other, but must not intersect.
PK_neutral_method_medial_c:
Create neutral surfaces that are within tolerance
of the theoretical medial surface. This method is
suitable for face sets that are not tolerant
offsets of each other.
Currently only one method may be supplied. If 'methods'
contains an array of more than one element, the error
PK_ERROR_invalid_methods will be returned.
'make_sheet' Whether to create a neutral sheet. If this is
PK_LOGICAL_true, then the function will create a
neutral sheet. If this is PK_LOGICAL_false, then no
neutral sheet will be created, but construction data
will still be reported in the Parasolid Report.
'overlap' Whether to enforce considering face overlaps when
making neutral sheets. If this is set to the value
PK_neutral_face_overlap_no_c then a neutral sheet may
in some circumstances be created despite the face
sets not overlapping. If this is set to the value
PK_neutral_face_overlap_yes_c then a neutral sheet
will not be created if the face sets do not overlap.
'update' The default value allows applications to take
advantage of the latest enhancements of the generic
algorithms supporting Parasolid local operations
functions. To maintain consistency when rebuilding
models created in a previous version of Parasolid,
a non-default value should be specified.
The default value is PK_local_ops_update_default_c