spp

spp is meant to project a region along rays onto a surface, through a template mesh. In this version of James it is read and checked, and then refused for want of tmplt.

Syntax

spp imin jmin kmin imax jmax kmax direction x y z template

The first six numbers are a region, as for lin. direction is one of i, j, k, id, jd and kd. x y z are three real numbers that give a point or a vector for the rays. template is the number of a template.

What it does

A template comes from the command tmplt, which James does not support yet, so no script can define one. James reads every argument of spp and reports a malformed one with its usual code. It then refuses the command, whatever the arguments are. James builds tmplt and spp together in milestone M14, with the commands accuracy and npll; the compatibility chapter lists them all.

When James applies it

The IR does not store spp. A well-formed spp is refused while James builds the part. spp is legal only in the Part phase. James refuses it in the Control and Merge phases (E0412).

Rules James adds

  • Every spp is an error (E0804): the template it names is not defined.
  • A second error, E0805, is for a template whose node count does not match the region. No script can reach it in this version, because no template exists.

Diagnostics

  • E0804: the template is not defined.
  • E0102: a reduced index lies outside the part.
  • E0106: a range of the region is written high to low.

Example

The script tests/corpus/070-spp-undefined-template-rejected/input.tg, which make test runs:

block 1 2 3;1 2 3;1 2 3; 0 1 2; 0 1 2; 0 1 2;
spp 1 1 1 2 2 2 k 0 0 0 1
endpart

James reads the region, the direction k, the three numbers and the template 1, and then refuses the template. It prints this and exits with 1, as tests/corpus/070-spp-undefined-template-rejected/expected.diag.txt holds:

input.tg:2:25: error [E0804]: spp template 1 is not defined
james: 1 error, 0 warnings

See also

  • sf: projects a region onto a surface that James does have.
  • patch: attaches a face to the four sides of a surface and projects it, which James does build.
  • Compatibility: the commands James refuses.

James 0.8.0.

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