PK_GEOM_render_o_t

struct PK_GEOM_render_o_s
    {
    int                  o_t_version;         --- Option structure version
    PK_render_param_t    param;               --- Whether to draw parametric
                                              --- hatch lines
                                              --- (PK_render_param_no_c)
    double               param_u;             --- Spacing of hatch lines in
                                              --- surface u directions
                                              --- (0.0)
    double               param_v;             --- Spacing of hatch lines in
                                              --- surface v directions
                                              --- (0.0)
    int                  param_u_number;      --- Number of u direction hatch
                                              --- lines. Used only when 'param'
                                              --- set to
                                              --- PK_render_param_number_free_c
                                              --- ( 0 )
    int                  param_v_number;      --- Number of v direction hatch
                                              --- lines. Used only when 'param'
                                              --- set to
                                              --- PK_render_param_number_free_c
                                              --- ( 0 )
    PK_render_boundary_t boundary;            --- Whether to render surface
                                              --- boundaries
                                              --- (PK_render_boundary_yes_c)
    PK_render_bcurve_t   bcurve;              --- Method for rendering bcurves
                                              --- (PK_render_bcurve_polyline_c)
    PK_render_lattice_t  lattice;             --- Method for rendering lattices
                                              --- (PK_render_lattice_line_c)
    PK_LOGICAL_t         have_curve_chord_tol;--- Whether curve_chord_tol is
                                              --- set
                                              --- (PK_LOGICAL_false)
    double               curve_chord_tol;     --- Chordal tolerance between
                                              --- a curve and its rendered
                                              --- representation in model units
                                              --- (0.0)
    PK_LOGICAL_t         have_curve_chord_max;--- Whether curve_chord_max is
                                              --- set
                                              --- (PK_LOGICAL_false)
    double               curve_chord_max;     --- Maximum chord length in model
                                              --- units
                                              --- (0.0)
    PK_LOGICAL_t         have_curve_chord_ang;--- Whether curve_chord_ang is
                                              --- set
                                              --- (PK_LOGICAL_false)
    double               curve_chord_ang;     --- Maximum angle between
                                              --- adjacent chords
                                              --- (0.0)
    };
typedef struct PK_GEOM_render_o_s PK_GEOM_render_o_t;



Controls for the PK_GEOM_render options structure.


Specific Errors:

    PK_ERROR_bad_parameter          'param' is PK_render_param_spaced_c or
                                    PK_render_param_spaced_free_c but 'param_u'
                                    and 'param_v' have not been specified
                                    OR
                                    'param' is PK_render_param_number_free_c
                                    but 'param_u_number' and 'param_v_number'
                                    have not been specified
                                    (MILD)
    PK_ERROR_bad_tolerance          'have_curve_chord_tol' is PK_LOGICAL_true
                                    and 'curve_chord_tol' is less than the
                                    value returned by PK_SESSION_ask_precision
                                    OR
                                    'have_curve_chord_max' is PK_LOGICAL_true
                                    and 'curve_chord_max' is less than the
                                    value returned by PK_SESSION_ask_precision
                                    OR
                                    'have_curve_chord_ang' is PK_LOGICAL_true
                                    and 'curve_chord_ang' is less than the
                                    value returned by
                                    PK_SESSION_ask_angle_precision
                                    (MILD)

Used in:

PK_GEOM_render

This structure provides control over:

    - whether surface boundary and hatch lines are required
    - the rendering style to be used for B-curves
    - the rendering style to be used for lattices
    - the tolerances to be used when generating geometric information for GO

Each control tolerance is passed as a pair of values, consisting of a
PK_LOGICAL_t flag and a double precision value. If a specific tolerance
is required, the variable is set to a strictly positive value and the
associated flag set to PK_LOGICAL_true.

If Parasolid is to use its internal tolerance defaults, the associated flag is
set to PK_LOGICAL_false (and no use made of the associated tolerance argument).
This is the default state set by the PK_GEOM_render_o_m macro.