Skip to content

hfVisualizer Remote Control Material

material

hfVisualizer --remote [--target <id>] material <type> <name> (--content <text> | --content-file <file>)
  • Creates or updates one *Material, TYPE=<type>, Name=<name> definition.
  • Exactly one of --content or --content-file is required.
  • material runs only in preprocessing mode.
  • <type> and <name> must not be empty.
  • Content is passed directly to readMaterialModification() after the IPC layer prepends the *Material keyword line.
  • Inside --content, use \n for line breaks. \\n stays literal.
  • Empty content is rejected.
  • The command updates the current database in place and refreshes the render pipeline.

Example:

hfVisualizer --remote material IsoElasticity STEEL --content "210000,0.3,1.2e-5,7.85e-9"
hfVisualizer --remote material GapHook GAP1 --content-file D:\Work\gap-material.txt

material-rename

hfVisualizer --remote [--target <id>] material-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 material unless it normalizes to the same name, in which case the command succeeds as a no-op.
  • Successful execution is recorded by script-save as a canonical material-rename ... tail.

Example:

hfVisualizer --remote material-rename STEEL STEEL_MAIN

material-delete

hfVisualizer --remote [--target <id>] material-delete <name>
  • Available only in preprocessing mode.
  • name must be non-empty and must resolve to an existing material.
  • The command uses the same delete path as ModelTree delete.
  • Existing delete guards are preserved. For example, delete still fails when the material is referenced by a section.
  • Successful execution is recorded by script-save as a canonical material-delete ... tail.

Example:

hfVisualizer --remote material-delete STEEL_MAIN