UF_FACET_parameters_s (view source)
Defined in: uf_facet.h
Also known as:
- UF_FACET_parameters_t
- UF_FACET_parameters_p_t
- UF_FACET_parameters_c_t
- UF_FACET_parameters_pc_t
Overview
From V14.0, the name of this structure was changed from
UF_FACET_faceting_params_s to UF_FACET_parameters_s. Programs written prior
to V14.0 that used this structure must be rewritten.
Please note the following items:
. When a solid body is faceted the faceter is always requested to ensure that
the vertices of facets in adjacent faces match along model edges.
. A macro (UF_FACET_INIT_PARAMETERS) is provided to initialize the structure
to some reasonable value. This macro initializes the version field to the
current version correctly. If this version field is set by the user's
program, the behavior of the program becomes unpredictable.
. The CAM users should ensure that the following guidelines are followed when
faceting to ensure that the model that is generated is marked for use by
CAM processors. If the model does not meet the minimum faceting parametric
requirements, the model is not useable for the CAM processors and the
processors might regenerate the model.
1. Set the variables in the UF_FACET_parameters_t structure as follows:
- max_facet_edges = 3
- number_storage_type = FACET_TYPE_DOUBLE
- specify_surface_tolerance = true
- surface_dist_tolerance <= 0.0381 (mm)
- curve_dist_tolerance <= 0.0381 (mm)
- surface_angular_tolerance <= 0.4
- specify_curve_tolerance = true
- curve_angular_tolerance <= 0.4
- specify_parameters = true
- specify_view_direction = true
- silh_view_direction[0] = tool_axis i component
- silh_view_direction[1] = tool_axis j component
- silh_view_direction[2] = tool_axis k component
- silh_chord_tolerance <= surface_dist_tolerance/2.0
2. Create the facet model on the geometry by using this module.
3. Use the function UF_CAM_PREPRO_mark_model_as_cam to mark the facet
model for recognition by CAM processors.
UF_FACET_faceting_params_s is used both for representing the default faceting
parameters, and for the faceting parameters used to facet a particular solid.
The default faceting parameters are inquired using
UF_FACET_ask_default_parameters and set with UF_FACET_set_default_parameters.
At the start of an Open API program the default faceting parameters are:
max_facet_edges = 3
specify_surface_tolerance = false
specify_curve_tolerance = false
specify_convex_facets = true
specify_max_facet_size = false
number_storage_type = UF_FACET_TYPE_FLOAT
specify_view_direction = false
specify_parameters = false
store_face_tags = false
The following string defined constants specify NULL values for all facet_ids,
vertex_ids, and edge_ids.
UF_FACET_NULL_FACET_ID
UF_FACET_NULL_VERTEX_ID
UF_FACET_NULL_EDGE_ID
Data Members
version
int
max_facet_edges
int
specify_surface_tolerance
surface_dist_tolerance
double
surface_angular_tolerance
double
specify_curve_tolerance
curve_dist_tolerance
double
curve_angular_tolerance
double
curve_max_length
double
specify_convex_facets
specify_max_facet_size
max_facet_size
double
number_storage_type
int
specify_parameters
specify_view_direction
silh_view_direction [ 3 ]
double
silh_chord_tolerance
double
store_face_tags
If UF_FACET_INIT_PARAMETERS macro
is used this field will be initialized
with the proper value. All calls to
the functions
UF_FACET_ask_default_parameters and
UF_FACET_ask_model_parameters
should be preceeded by the use of the
macro to ensure proper initialization of
this member.