PK_EDGE_set_blend_chamfer

PK_ERROR_code_t                       PK_EDGE_set_blend_chamfer
(
--- received arguments ---
int                                   n_edges,        --- no. of edges to blend
const PK_EDGE_t                       edges[],        --- edges to have
                                                      --- blends set
double                                range_2,        --- offset of face
                                                      --- opposite first face
double                                range_1,        --- offset of first face
const PK_FACE_t                       faces[],        --- faces of first range
                                                      --- (optional)
const PK_EDGE_set_blend_chamfer_o_t  *options,        --- options structure
                                                      --- [PF]

--- returned arguments ---
int                            *const n_blend_edges,  --- number of edges with
                                                      --- blends set
PK_EDGE_t                     **const blend_edges     --- edges with blends
                                                      --- set
)


This function sets edges to have a chamfer blend.

This function offers partial support for facet geometry [PF]


Specific Errors:
    PK_ERROR_bad_blend_param     illegal combination of blend properties
                                 (MILD)

    PK_ERROR_general_body        'edges' are from a general body
                                 (MILD)

    PK_ERROR_tolerance_too_loose the supplied or edge tolerance is too large
                                 compared to the given ranges
                                 (MILD)

    PK_ERROR_bad_tolerance       specified tolerance is too tight
                                 (MILD)



Attaches unfixed chamfer blends to a given array of edges.

The argument 'range_1' is the range associated with the first face in 'faces',
if supplied, or the range associated with the face of the first fin of the
first edge in 'edges' otherwise. 'range_2' is the other range. Note that if
'faces' are supplied then this array should be of length 'n_edges', but
currently only the first face in 'faces' will have any effect. If
greater control is required over the sides to which the ranges should be
applied then PK_EDGE_set_blend_chain can be used instead of
PK_EDGE_set_blend_chamfer. One of 'range_1' and 'range_2' must be greater
than twice the maximum tolerance of all edges in 'edges' and the specified
'tolerance' in 'properties'.

A successful result will produce a new blend attribute. It will return
the edge(s) to which the blend attribute is attached in the array
'blend_edges'.

See PK_BODY_fix_blends for making the blends a part of the topology.

Blends can be created on general bodies, so long as the portion of the body in
the neighbourhood of the blend is locally manifold.