PK_CURVE_embed_in_surf_o_t

struct PK_CURVE_embed_in_surf_o_s
    {
    int                 o_t_version;   --- option structure version
    PK_LOGICAL_t        have_curve_interval;
                                       --- whether have interval specifying
                                       --- sub-part of curve (PK_LOGICAL_false)
    PK_INTERVAL_t       curve_interval;--- parameteric interval of curve to
                                       --- be embedded (0.0, 1.0)
    PK_GEOM_copy_t      copy_curve;    --- whether to copy curve before
                                       --- embedding (PK_GEOM_copy_auto_c)
    PK_embed_adjust_t   geom_adjust;   --- whether to extend surface or adjust
                                       --- curve if curve outside limits
                                       --- (PK_embed_adjust_su_c)
    PK_LOGICAL_t        have_adjustment_limit;
                                       --- whether the 'adjustment_limit' is
                                       --- set (PK_LOGICAL_false)
    double              adjustment_limit;
                                       --- limit of divergence
                                       --- between curve and any
                                       --- adjustment of it
    PK_embed_report_t   report;        --- specify when to write a report
                                       --- giving additional information on
                                       --- the outcome
                                       --- (PK_embed_report_never_c)
    };
typedef struct PK_CURVE_embed_in_surf_o_s PK_CURVE_embed_in_surf_o_t;


This options structure holds optional controls for PK_CURVE_embed_in_surf_2.

Used in:

PK_CURVE_embed_in_surf_2

Description of fields:

'o_t_version'           Version number of option structure.

'have_curve_interval'   Logical indicating whether we wish to specify the
                        parametric interval on the curve to embed in the
                        surface. If set to PK_LOGICAL_true the section
                        of curve specified by the parametric range given
                        in 'curve_interval' will be embedded. If set to
                        PK_LOGICAL_false the whole of the curve will be
                        embedded into the surface.

'curve_interval'        Interval indicating the section.

'copy_curve'            Whether to embed the given curve itself
                        whenever possible (PK_GEOM_copy_auto_c) or to
                        always embed a newly constructed copy of the
                        required curve section (PK_GEOM_copy_always_c).
                        The value PK_GEOM_copy_never_c is not supported.

'geom_adjust'           Whether to extend the surface (PK_embed_adjust_su_c)
                        or adjust the curve (PK_embed_adjust_cu_out_c) if
                        the curve is outside the surface limits.

'have_adjustment_limit' This field controls whether the associated
                        'adjustment_limit' is used.

'adjustment_limit'      If 'have_adjustment_limit' is PK_LOGICAL_true
                        this field must be set to a positive value and
                        specifies the maximum distance permissible between
                        a curve and any adjustment of it made to fit it
                        within the limits of the surface.
                        If 'have_adjustment_limit' is PK_LOGICAL_false then
                        the maximum distance allowed between a curve and any
                        adjustment of it will be the current session precision.

'report'                Specifies when further information on the result of
                        the embedding is to be written into a report record
                        of type PK_REPORT_record_3_t with 'status' value
                        PK_REPORT_3_embed_curve_c.

                        PK_embed_report_never_c: never write a report
                        PK_embed_report_always_c: always write a report
                        PK_embed_report_failing_c: write a report only when
                        the call to embed a curve fails.