prevnext   » SZS: Wiimms SZS Tools » wkclt: Wiimms KCL Tool » wkclt octree

wkclt octree

For each point, the octree of the source file is traversed to find and print the related triangles. A point is either a comma separated list with 3 parser expressions (one for each coordinate) or a vector expression.

Contents

1.   Syntax

wkclt OCTREE source point...

2.   Options

Options
Option Param Description
-i --ignore Ignore non existing source files without warning.
-B --brief Print the 0-based tringle index instead of the triangle coordinates.
-l --long If set, print a calculation log. If set twice, print a calculation log for each octree traversing step.
-c --const list Define a const value, that is used by the internal encoders as predefined global variable. This option allow conditional encodings of text files. It can be used multiple times to allow multiple definitions.

Parameter list is a comma separated list of terms and a term is name=expression. The expression is calculated by the text parser.

--scale vector[@origin] Transform the data: Scale all KMP coordinates and size values by 'vector'. Negative values mirror the coordinates. Each parameter is either a vector expression or a comma separated list of coordinates ('x,z' or 'x,y,z'). If the origin is not set, use 0,0,0 instead.

Transformations are calculated in the order SCALE, SHIFT, ROTATE.

--shift vector Transform the data: Add 'vector' to all KMP coordinates. 'vector' is either a vector expression or a comma separated list of coordinates ('x,z' or 'x,y,z').

Transformations are calculated in the order SCALE, SHIFT, ROTATE.

--xss x1old,x1new,x2old,x2new --xss (x-scale-shift) calculates the X values of --scale and --shift, so that the old values are transformed to the new values.
--yss y1old,y1new,y2old,y2new --yss (y-scale-shift) calculates the Y values of --scale and --shift, so that the old values are transformed to the new values.
--zss z1old,z1new,z2old,z2new --zss (z-scale-shift) calculates the Z values of --scale and --shift, so that the old values are transformed to the new values.
--hrot degree[@origin] Transform the data: Rotate all KMP coordinates and rotation values horizontal counterclockwise by the angle 'degree'. Each parameter is either a vector expression or a comma separated list of coordinates ('x,z' or 'x,y,z'). If the origin is not set, use 0,0,0 instead.

Transformations are calculated in the order SCALE, SHIFT, ROTATE.

--kcl list Set global options for KCL processing. Parameter 'list' is a comma separated list of keywords. A minus sign before a keyword disables an option. Each occurence of the option will only change the current settings. Keyword DEFAULT resets the default settings (=NORMALS) and RESET disables all. The other allowed keywords are: FAST, NORMALS, OUT-SWAP, IN-SWAP, AUTO, CLIP, DROP and SORT.
--kcl-flag joblist Modify the KCL flag of KCL files. A comma separated job list in the format 'srclist=dest' is expected. 'srclist' is a plus sign separated list with single values like <val>, T<type> and <val>/<mask> or ranges like <val>:<val>, T<type>:<type> and <val>:<val>/<mask>. '<val>' is a complete KCL flag in the range of 0..0xffff. '<type>' are only the base types in the range of 0..0x1f. If <mask> is present, it marks the relevant bits. For the T<type> variant, the mask is set to 0x1f.

All KCL flags of the source list are assigned to the new value 'dest', but only the set bits of '<mask>' are modified. A later definition overrides the previous one.

Example: T0:2 = 6, 0x20/0xf0 + 0x1234 = 0x5678

--kcl-script script After reading a KCL source file, the text file 'script' is executed by the internal text parser. The script should use the parser functions tri$*() to read and modify the triangle values.