Name: WlzCMeshTransformVtx - transforms vertices using a constrained mesh transform.

Synopsis

WlzCMeshTransformVtx [-h] [-i] [-o<output file>] [-f<input file>] [<transform>]

Options

-h	Help, prints usage message.
-i	Invert the transform after reading.
-o	Output file.
-f	Input file.
-x	Interpolation value, with 0 <= ivalue <= 1.
-s	Number of intermediate interpolations.
-b	Output object file body
-e	Output object file extension (default wlz)

Description: Reads a constrained mesh transform and input vertices objects and outputs transformed vertices.

Example

WlzCMeshTransformVtx -i -o new.num -f in.num tx.wlz

Reads a constrained mesh transform from the file tx.wlz and inverts it as instructed by the -i flag. Vertices are then read from the file in.num, transformed and written to the file out.num.

The input vertices must be in the format:

<x> <y> <z>

That is three double precission numbers per line seperated by whitespace. If the transform is in 2D then the last number (which must be present) can have any value as it will not be used. Partly transformed vertices can be generated if interpolation values between 0 and 1 are given(0 means no transformation) Alternatively a set of interpolations covering the full range of transformation is computed if the number of interpolations is given. For this, the output base filename and its extension must be supplied. The output vertices will be in the format:

<e> <x> <y> <z>

Here the first number is an integer corresponding to the Woolz error code for the transformation of the vertex (value is zero for no error). The remaining three numbers are the double precission transformed vertex. For 2D the z coordinate will still be present, but will have value zero.

File: WlzCMeshTransformVtx.c

See Also: WlzIntro(1)