Skip to content

hfVisualizer Remote Control Construction

construction

hfVisualizer --remote construction <type> <name> (--content <text> | --content-file <file>)
  • Creates or updates one *Construction, TYPE=<type>, Name=<name> definition.
  • Exactly one of --content or --content-file is required.
  • construction runs only in preprocessing mode.
  • Supported construction types are Line and Spline.
  • <name> must be non-empty and uses the same single-token normalization as GUI edits.
  • The command builds the keyword header first and applies the remaining lines as the block body.
  • When the result is a construction line, hfVisualizer also updates the current construction-line selection to that object, matching the GUI widget behavior.
  • Names created here can be used directly by commands such as select spline, select construction-line, and visibility construction.
  • Successful execution is recorded by script-save as a canonical construction ... --content ... tail.

Example:

hfVisualizer --remote construction Line grid_x --content "0, 0, 0, 10, 0, 0\n0, 5, 0, 10, 5, 0"

construction-rename

hfVisualizer --remote construction-rename <old-name> <new-name>
  • Available only in preprocessing mode.
  • Both names must be non-empty and use the same single-token normalization as GUI edits.
  • The source name must exist.
  • The target name must not collide with another construction unless it normalizes to the same name, in which case the command succeeds as a no-op.
  • The render pipeline is refreshed so ModelTree visibility state stays aligned with the renamed construction object.
  • Successful execution is recorded by script-save as a canonical construction-rename ... tail.

Example:

hfVisualizer --remote construction-rename grid_x guide_x

construction-delete

hfVisualizer --remote construction-delete <name>
  • Available only in preprocessing mode.
  • <name> must be non-empty and must resolve to an existing construction object.
  • The command uses the same delete path as ModelTree delete.
  • Existing construction delete guards are preserved. For example, a spline still cannot be deleted while it is referenced by a line sensor.
  • Successful execution is recorded by script-save as a canonical construction-delete ... tail.

Example:

hfVisualizer --remote construction-delete guide_x