PK_GEOM_enlarge_o_t

struct PK_GEOM_enlarge_o_s
    {
    int              o_t_version;       --- version number of options structure
    PK_ITEM_t        destination;       --- destination for enlarged geometries
                                        --- (PK_ITEM_null)
    PK_LOGICAL_t     have_trimming_box; --- whether a trimming box has been
                                        --- provided (PK_LOGICAL_false)
    PK_BOX_t         trimming_box;      --- box to trim enlarged gemetries
    double           tolerance;         --- tolerance to use when approximating
                                        --- enlarged geometries (1.0e-5)
};
typedef struct PK_GEOM_enlarge_o_s PK_GEOM_enlarge_o_t;


The structure contains the optional controls for PK_GEOM_enlarge.


Specific Errors:
    PK_ERROR_bad_item                       The destination is not a part or a
                                            partition. (MILD)

Used in:

PK_GEOM_enlarge

'destination'         Destination for enlarged geometries (see below).
                      The default is PK_ITEM_null.

'have_trimming_box'   Whether 'trimming_box' is supplied.

'trimming_box'        If 'have_trimming_box' is set to PK_LOGICAL_true then
                      this three-space box will be used to trim the enlarged
                      geometries.

'tolerance'           If an approximation is required, this option controls the
                      fitting of the resultant geometries.

destination:
------------
Specifies the destination for the enlarged geometries. It can take a partition,
PK_PARTITION_t, or a part, PK_PART_t, but no other PK_ITEM_t. Alternatively it
may be set to PK_ITEM_null.

If a partition is supplied through 'destination' then all enlarged geometries
will be created as orphan geometry in the supplied partition.

If a part is supplied through 'destination' then all enlarged geometries will
be attached to the supplied part as construction geometry.

If 'destination' is set to PK_ITEM_null then each enlarged geometry will be
created as orphan geometry in the corresponding input geometry's partition.

The behaviour is summarised in the following table:

-------------------------------------------------------------------------------
| Type of input |                       'destination'                         |
|   geometry    |    PK_ITEM_null     |    PK_PART_t    |    PK_PARTITION_t   |
-------------------------------------------------------------------------------
| Orphan        |  Orphan in original | Construction in | Orphan in supplied  |
| geometry      |  partition          | supplied part   | partition           |
-------------------------------------------------------------------------------