PK_ERROR_code_t  PK_CURVE_make_curve_reversed
(
--- received arguments ---
PK_CURVE_t        curve,        --- curve

--- returned arguments ---
PK_CURVE_t *const reverse       --- reversed curve
)


This function makes a new curve which is coincident with the given curve
but whose parameter increases in the opposite direction along the curve.
It does not support reversal of foreign geometry curves.


Specific Errors:
    PK_ERROR_unsuitable_entity      curve type is not supported


The returned curve will contain (at least) all that part of the given
curve which lies within its size box.

If the given curve is periodic then the returned curve will be periodic.

The returned curve will be in the same partition as the received curve.

Note that :

 - no relationship is defined between the parameterisation of the
   given curve and that of the returned curve except that these
   are in opposite directions.

 - if a received curve is bounded, the returned curve need not be
   bounded or bounded as tightly.

 - the concrete class of the returned curve is not constrained to
   be the same as that of the received curve.