 |
PK_FACE_change_taper_o_t |
|
struct PK_FACE_change_taper_o_s
{
int o_t_version; --- version number of option
--- structure
PK_EDGE_array_t tapered_edges; --- tapered step edges [NF]
PK_EDGE_array_t normal_edges; --- normal step edges [NF]
PK_taper_method_t method; --- main face taper method
--- (PK_taper_method_curve_c) [PF]
PK_taper_smooth_step_t taper_smooth_step;
--- whether to create step faces
--- (PK_taper_smooth_step_no_c) [NF]
PK_taper_step_face_t taper_step_face;
--- step face between taper
--- faces
--- (PK_taper_step_face_no_c) [NF]
PK_taper_laminar_edge_t position; --- defines how to process
--- laminar boundaries
--- (PK_taper_laminar_edge_normal_c)
int n_parting_edges;
--- number of parting edges (0) [NF]
const PK_ENTITY_t *parting_edges; --- parting body step edges (NULL)
--- [NF]
PK_BODY_t parting_body; --- parting body (PK_ENTITY_null)
--- [NF]
};
typedef struct PK_FACE_change_taper_o_s PK_FACE_change_taper_o_t;
This structure contains taper-specific optional controls for PK_FACE_change
Specific Errors:
PK_ERROR_unsuitable_topology (MILD) Parting body is not sheet.
PK_ERROR_bad_combination (MILD) Option 'parting_edges' specified
without also specifying
'parting_body'.
Option 'parting_body' specified
without also specifying
'parting_edges'.
Some entries of 'parting_edges'
also in 'tapered_edges' or
'normal_edges'.
A parting edge has the same taper
face on both sides.
A parting edge is laminar.
A parting body is specified for
taper faces belonging to
different bodies.
PK_ERROR_bad_combination (SERIOUS) A parting edge is between a
blend operation face and one
of the defining faces of the
blend.
Used in:
PK_FACE_change_opts_t
Description of fields:
'tapered_edges' Edges which will give rise to tapered step faces.
These faces' surfaces will satisfy the taper
condition. Edges in this array should NOT also
appear in the 'normal_edges' array.
'normal_edges' Edges which will give rise to normal step faces.
These faces' surfaces are ruled surfaces normal
to the relevant original taper face.
These surfaces do NOT necessarily satisfy the taper
condition. Edges in this array should NOT also
appear in the 'tapered_edges' array.
'method' Taper method to construct main taper faces' surfaces.
Supported methods are:
PK_taper_method_curve_c : curve method
PK_taper_method_surface_c : surface method
PK_taper_method_isocline_c : isocline method
PK_taper_method_normal_c : normal method
The default value is PK_taper_method_curve_c.
For more details on taper surfaces refer to the
#Definitions of Isocline Curves and Surfaces#DOC0144#
section of the Functional Description.
Note that the only values supported for facet geometry
are PK_taper_method_isocline_c,
PK_taper_method_curve_c and PK_taper_method_surface_c.
'taper_smooth_step' A "boundary edge" is an edge between a face which is
being tapered and one which is not.
If this option is set to PK_taper_smooth_step_yes_c
then side faces will be created along any smooth
boundary edges (if appropriate - for example no side
faces will be created if the tapered surface remains
coincident with the smooth edge). Setting this option
to PK_taper_smooth_step_yes_c has no effect on the
result if there are no smooth boundary edges.
'taper_step_face' If this option is set to PK_taper_step_face_yes_c
step faces will be created between taper faces which
get separated during taper operation. An example is
smooth edges between taper faces, and multiple taper
angles are specified.
If the option is set to PK_taper_step_face_no_c, a
trim solution between taper faces is attempted.
If the option is set to PK_taper_preserve_smooth_c,
multiple taper angles cannot be specified. Smoothly
connected taper faces need to specify a constant taper
angle.
See here for more information.
'position' Specifies how to process laminar edge boundaries.
If the value is PK_taper_laminar_edge_normal_c,
geometry for the laminar edge is produced by
projecting the edge geometry along the taper surface
normal. This is the default behaviour.
If the value is PK_taper_laminar_edge_draw_c,
geometry for the laminar edge is produced by
intersecting the taper surface with a local surface,
constructed orthogonal to draw direction along the
laminar edge.
For more information, see here.
'n_parting_edges' Number of parting edges.
The default is 0.
'parting_edges' Edges which will give rise to step faces created
from a parting body. The parting edges must be
coincident with the parting body. They should NOT
also appear in 'tapered_edges' or 'normal_edges'.
The default is NULL.
See here for more information.
'parting_body' The body used to create step faces from the parting
edges. It must be a sheet body.
The default is PK_ENTITY_null.