Skip to content

hfVisualizer Remote Control Display

Use display commands when you want to change how the current model is shown without changing the model data itself.

By default these commands target activeRenderView. Use --view-id <rN> when you want to operate on a different render view without changing currentView or activeRenderView.

representation

hfVisualizer --remote [--target <id>] [--view-id <rN>] representation <surface|wireframe|both>
  • Sets the main render representation mode.
  • Available values are surface, wireframe, and both.

transparency

hfVisualizer --remote [--target <id>] [--view-id <rN>] transparency <on|off>
  • Turns transparent rendering on or off for the target render view.

element-shrink

hfVisualizer --remote [--target <id>] [--view-id <rN>] element-shrink <on|off>
  • Turns element shrink display on or off for the target render view.

section-view

hfVisualizer --remote [--target <id>] [--view-id <rN>] section-view <on|off>
  • Turns section-view clipping on or off for the target render view.

parallel-projection

hfVisualizer --remote [--target <id>] [--view-id <rN>] parallel-projection <on|off>
  • Switches the target render view between perspective and parallel projection.

shading-color

hfVisualizer --remote [--target <id>] [--view-id <rN>] shading-color <none|element-type|section>
  • Selects the shading-color source for the target render view.
  • Available values are none, element-type, and section.

display-control

hfVisualizer --remote [--target <id>] [--view-id <rN>] display-control <item> <on|off>
  • Controls display toggles in the target render view.
  • <item> values:
  • origin-axes
  • corner-axes
  • grid
  • dimension-box
  • node
  • node-label
  • element-label
  • ecs
  • sensor-label
  • These items work in both preprocessing and postprocessing modes.

grid-spacing

hfVisualizer --remote [--target <id>] [--view-id <rN>] grid-spacing get
hfVisualizer --remote [--target <id>] [--view-id <rN>] grid-spacing set <value>
  • get returns the current grid spacing of the target render view as JSON.
  • set changes only the spacing value. It does not turn grid display on or off.
  • set <value> requires a positive finite number.

camera

hfVisualizer --remote [--target <id>] [--view-id <rN>] camera get
hfVisualizer --remote [--target <id>] [--view-id <rN>] camera fit
hfVisualizer --remote [--target <id>] [--view-id <rN>] camera view <iso-z|iso-y|iso-x|+x|-x|+y|-y|+z|-z>
hfVisualizer --remote [--target <id>] [--view-id <rN>] camera rotate <+x|-x|+y|-y|+z|-z>
hfVisualizer --remote [--target <id>] [--view-id <rN>] camera set --position <x,y,z> --focal-point <x,y,z> --view-up <x,y,z> [--projection <perspective|parallel>] [--view-angle <deg>] [--parallel-scale <value>] [--clipping-range <near,far>] [--roll <deg>] [--reset-clipping <on|off>]
  • Use camera get to read the current camera state as JSON.
  • Use camera fit, camera view, and camera rotate to change the active camera quickly.
  • camera set requires:
  • different position and focal-point
  • non-zero view-up

visibility

hfVisualizer --remote [--target <id>] [--view-id <rN>] visibility <node|element|node-set|element-set|constraint|load|surface|construction|sensor> <items|all> <on|off>
  • Sets model-object visibility in the target render view.
  • Behavior matches ModelTree checkbox visibility, not global all-view visibility.
  • GUI ModelTree checkbox changes append the same canonical visibility ... tails to Remote Control History and *.ipc.txt.
  • Target selectors:
  • node|element: use id,id,... or all
  • node-set|element-set: use name,name,...
  • constraint|load|surface|construction|sensor: use name,name,... or all
  • construction covers both splines and construction lines by name.

Example:

hfVisualizer --remote representation both
hfVisualizer --remote display-control origin-axes on
hfVisualizer --remote grid-spacing set 500
hfVisualizer --remote camera fit
hfVisualizer --remote visibility construction "SplineA,CLine1" off