PK_FACE_intersect_surf_o_t

struct PK_FACE_intersect_surf_o_s
    {
    int                     o_t_version;    --- version number of option
                                            --- structure
    PK_LOGICAL_t            have_box;       --- whether box provided
                                            --- (PK_LOGICAL_false)
    PK_BOX_t                box;            --- box of interest
    PK_LOGICAL_t            have_uvbox_1;   --- whether box provided for face
                                            --- (PK_LOGICAL_false) [NF]
    PK_UVBOX_t              uvbox_1;        --- uvbox for face [NF]
    PK_LOGICAL_t            have_uvbox_2;   --- whether box provided for surf
                                            --- (PK_LOGICAL_false) [NF]
    PK_UVBOX_t              uvbox_2;        --- uvbox for surf [NF]
    PK_LOGICAL_t            have_vector;    --- whether seed vector provided
                                            --- (PK_LOGICAL_false)
    PK_VECTOR_t             vector;         --- only return branch containing
                                            --- the seed
    PK_mixed_intersection_t mixed_curve_category;
                                            --- return polyline, classic, or
                                            --- both as the intersection curve
                                            --- (PK_mixed_intersection_pline_c)
    double                  tolerance;      --- for future use
    };

typedef struct PK_FACE_intersect_surf_o_s PK_FACE_intersect_surf_o_t;



Holds optional controls on intersections between a face and a surface.


Specific Errors:

Used in:

PK_FACE_intersect_surf

The option structure defines options applicable to the intersection of a
face and a surface.

 The option 'have_box' indicates whether a box has been specified
 (default = PK_LOGICAL_false)

 The option 'box' enables a 3-space box of interest to be supplied. The
 box may be used to improve performance. The intersection curves returned
 are not guaranteed to lie within the bounds of the box.

 The option 'have_uvbox_1' indicates whether a uvbox_1 has been specified.
 The option 'have_uvbox_2' indicates whether a uvbox_2 has been specified.

 The options 'uvbox_1' and 'uvbox_2' enable the supplying of parameter boxes
 for the face and the surface respectively. Again these
 boxes are only used to constrain the region of interest for performance
 purposes. The intersection curves returned are not trimmed to lie
 within the boundaries of the parameter box/es.
 Four parameters should be supplied to define the parameter box, U-min,
 U-max, V-min and V-max.

 The option 'have_vector' indicates whether a vector has been specified.

 The option 'vector' enables a point on a branch of the intersection to be
 specified (by supplying the x, y, and z coordinates). For this
 case only the branch of the intersection on which this point lies will be
 returned.

 The option 'mixed_curve_category' specifies the desired curve type of the
 curve returned for mixed intersections. It has no effect on other
 intersections.
 (default = PK_mixed_intersection_pline_c)

 Note that non-default values are not currently supported for
 mixed_curve_category.