orpt

orpt chooses which way the normals of shell elements point, for the n commands that follow it.

Syntax

orpt + x y z
orpt - x y z
orpt off
orpt flip
  • + x y z: toward the point.
  • - x y z: away from the point.
  • off: the default, the increasing index of the shell partition’s direction, on a mirrored lattice too (see n).
  • flip: the inverse of the default.

The sign is a word of its own: write orpt - 5 90 1, with a space before the first coordinate.

What it does

orpt is a setting. It changes no element by itself; every n issued after it reorders its region’s shells by the choice in force at that moment, and a later orpt leaves the earlier n alone. The setting persists from part to part until another orpt changes it, as a session setting does: an n in a second part reads the orpt of the first unless the second part gives its own. The point is read in the part’s own coordinates, after every projection: in a cylinder part it is a radius, an angle in degrees and a height.

When James applies it

Immediately, as a setting; the shells move when each n is applied after the part’s twenty-one steps.

Rules James adds

  • Of the commands TrueGrid lists as reading orpt, James builds n alone in this version.
  • A point that is ambiguous for a curved surface (the manual’s own warning) is read element by element; an element whose normal is at right angles to the line to the point keeps the default order.

Diagnostics

  • E1401: the mode is not +, -, off or flip, or a coordinate is missing.
  • E0412: orpt outside a part.

Example

The script tests/corpus/236-orpt-bad-mode/input.tg, which make test runs:

c the sign is a word of its own, with a space before the first coordinate
block -1 -3;1 3;1 2;0 2 0 2 0 1
orpt -5 90 1
orpt + 1 2
endpart

Both lines are refused, the first because -5 is a number and not the sign, the second because a coordinate is missing. James prints the message in tests/corpus/236-orpt-bad-mode/expected.diag.txt:

input.tg:3:6: error [E1401]: 'orpt' mode must be +, -, off or flip, got -5
input.tg:4:1: error [E1401]: 'orpt' expects three coordinates after +, got the end of the line
james: 2 errors, 0 warnings

See also

  • n: the command that applies the choice.

James 0.8.0.

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