cycorsy

cycorsy sets the frame of reference of a cylinder part: the frame of reference the part is placed in, from its first step.

Syntax

cycorsy trans ;

trans is a list of transform operators, as for tr, ending in ;.

What it does

A cylinder part is built about its own axis, and the frame places it from the first step, so a projection onto a global surface acts at the part’s final location. The stored coordinates stay cylindrical, and the conversion at the part’s end folds the frame in. The last cycorsy of a part is the one applied; the command is not cumulative.

When James applies it

From the part’s first step; the last cycorsy of a part governs.

Rules James adds

  • The operators are tr’s: mx, my, mz, v, rx, ry, rz, raxis, inv and the scalings. The manual’s scv, dv, rxy, ryz, rzx, tf and ftf are refused as tr refuses them.
  • cycorsy belongs to a cylinder part; in a block part it is an error.
  • A reflecting operator, an odd number of negative scale factors such as xsca -1, mirrors the part. James reorders the hexes of a mirrored part and notes the part as inverted, as for a decreasing coordinate list, but it leaves the shells in their index order, so a mirrored part’s shells have their normals on the opposite side from the unmirrored part’s. A shell pipe under cycorsy xsca -1 ... has its normals toward the axis where the unmirrored pipe has them away. orpt and n turn them back; the parts chapter gives the rule.
  • Where the command stands in the script does not matter: James applies every command in its hierarchy order and the frame from the first step.

Diagnostics

  • E1404: cycorsy in a block part.
  • E0503: an operator James does not have.
  • E0412: cycorsy outside a part.

Example

The script tests/corpus/239-cycorsy-block-part/input.tg, which make test runs:

c the frame of reference belongs to a cylinder part
block 1 3;1 3;1 3;0 1 0 1 0 1
cycorsy rx 90;
endpart

James prints the message in tests/corpus/239-cycorsy-block-part/expected.diag.txt:

input.tg:3:1: error [E1404]: 'cycorsy' applies to a cylinder part; part 1 is a block part
james: 1 error, 0 warnings

See also

  • cylinder: the part this command places.
  • tr: the operators and their meaning.

James 0.8.0.

This site uses Just the Docs, a documentation theme for Jekyll.