PK_LATTICE_make_patterned

PK_ERROR_code_t                      PK_LATTICE_make_patterned
(
--- received arguments ---
PK_LATTICE_t                         lattice,      --- core lattice
const PK_LATTICE_make_patterned_o_t *options,      --- options

--- returned arguments ---
PK_LATTICE_make_patterned_r_t *const results       --- results
)


This function creates a lattice made of patterned repetitions of the given
lattice.


Specific Errors:
    PK_ERROR_inconsistent_data      The data is contradictory, insufficient
                                    or excessive. Matched lrods or lballs
                                    have different radii. The core encroaches
                                    on cells beyond its direct adjacencies.
                                    (MILD)
    PK_ERROR_invalid_geometry       A lattice with invalid geometry has been
                                    provided or would be produced. (MILD)
    PK_ERROR_pattern_failed         Failed to create a patterned lattice.
                                    (MILD/SERIOUS)


This function creates a lattice comprised of repetitions of the given
'lattice' in the form of the given pattern.

The 'cell' tessellates to create a pattern of cells containing copies
of the core 'lattice' whose union forms the result lattice. The 'bounds'
determines the number of repetitions of the 'cell' used in each
direction. Optionally a 'form' and/or 'callback' may be supplied to relocate
and deform the pattern. If both are supplied the callback is applied after
any deformation from the 'form'.

Matches between adjacent repetitions are defined by coincident lballs and
lrods.