Advanced Description

This section is detailed for advanced users that need to write the scripts by themselves. After reading this section, the user may be able to understand the script examples available at https://altairone.com/.

Regarding general information about newFASANT scripts, the next considerations must be taken into account:
  • Blank lines may be inserted to get a more readable file.
  • Comments start with "#" character. Every sentences of the current line that are written after this character will be omitted.
  • Every line run a new order. However, a line may be split in so many lines as desired, as stated in the below specification.
  • Character " \" is the Escape character, so the next character will be omitted. It is usually inserted to split an order in multiple lines and then to obtain a more readable file.
  • Order lines start with the command name.
The following specifications are applied to most of commands that may be loaded in script files:
  • set command creates new parameters, specified by its name and values (it may be fixed values, range values or even functions)
  • -n option set the output name of the resulting elements within the current command. Be careful to provide unique names to every command; otherwise the console will not load the script after detecting repeated output names.
  • -s option list the selected objects as input arguments to the current command. It is used in commands that require the selection of objects as input.
  • -p option list the required parameters for the current command.
  • -t option list the transformation matrix of the reference plane required for using the current command. It is the next 4x4 matrix with the below specifications:
    column0 column1 column2 column3
    row0 m00 m01 m02 m03
    row1 m10 m11 m12 m13
    row2 m20 m21 m22 m23
    row3 m30 m31 m32 m33
    • the matrix is written in rows as: -t m00 m01 m02 m03 m10 m11 m12 m13 m20 m21 m22 m23 m30 m31 m32 m33
    • the elements m00 m10 m20 within column0 defines the X unitary vector-direction of the reference plane.
    • the elements m01 m11 m22 within column1 defines the Y unitary vector-direction of the reference plane.
    • the elements m02 m12 m22 within column2 defines the Z unitary vector-direction of the reference plane.
    • the elements m00 m10 m20 within column3 defines the X Y Z point where the reference plane is centered.
    • the elements m30 m31 m32 m33 withinrow3 are always set to 0 0 0 1 respectively.
  • -c option is only available in some commands, and it may be used with different purposes:
    • It indicates that the current command will generate a copyof the input objects. It may be used in commands such as: symmetric,...
    • It indicates that the current command will generated a closedobject. Otherwise, only the side surfaces are generated. It may be used in commands such as: cylinder, cone, ogive,...
    • It indicates that the current command will have cuttingobjects that will not be modified. It is only used in split options, such as splitSurfaces, splitCurves,...