PK_FACE_change_radiate_o_t

struct PK_FACE_change_radiate_o_s
    {
    int             o_t_version;        --- version number of option structure
    PK_LOGICAL_t    have_axis;          --- whether the axis of rotation is
                                        --- supplied (PK_LOGICAL_false)
    PK_AXIS1_sf_t   axis;               --- the axis of rotation
    double          axial_displacement; --- shift along 'axis' (0.0)
    PK_radiate_step_t
                    radiate_step;       --- whether to create a radiate
                                        --- step face
                                        --- (PK_radiate_step_no_c)
    };
typedef struct PK_FACE_change_radiate_o_s PK_FACE_change_radiate_o_t;


This structure contains radiate-specific optional controls for PK_FACE_change.


Specific Errors:
    PK_ERROR_unsupported_operation  (MILD)    The supplied 'axis' is not an
                                              axis of rotation of the face's
                                              surface.

    PK_ERROR_bad_combination        (MILD)    There is no 'axis' supplied when
                                              surfaces of the set of faces for
                                              the same radiate operation don't
                                              have a common and unique axis of
                                              rotation.
                                              Non-zero 'axial_displacement'
                                              is specified without supplied
                                              'axis'.

Used in:

PK_FACE_change_opts_t

Description of fields:



'have_axis'             When set to PK_LOGICAL_true, 'axis' is supplied
                        as the axis of rotation of the face's surface.
                        Otherwise, an axis is extracted from the definition
                        of the surface.


'axis'                  This is the supplied axis of rotation of the face's
                        surface.


'axial_displacement'    Radiated surface is moved along 'axis' by this
                        amount.


'radiate_step'          A "boundary edge" is an edge between a face which is
                        being radiated and one which is not, or between two
                        faces being radiated differently.

                        If this option is set to PK_radiate_step_no_c, then
                        no step faces will be created.

                        If set to PK_radiate_step_smooth_c, then step faces
                        will be created along all smooth boundary edges.

                        If set to PK_radiate_step_all_c, step faces will be
                        created at both sharp and smooth edges.

                        If set to PK_radiate_step_not_coi_c, step faces are
                        created at all edges except those where the surface
                        of the step would be coincident with the surface of
                        the adjacent face.

                        If set to PK_radiate_step_smooth_site_c, step faces
                        are created at all smooth boundary edges but will
                        not be created if this can be done by growing site
                        faces.

                        See here for more information.