Skip to content

hfSectionVisualizer Remote Control Window and File

Remote-only

  • Use these commands first to identify the running instance and confirm that remote control is working.
hfSectionVisualizer --remote list
hfSectionVisualizer --remote target <set|show|clear> [id]
hfSectionVisualizer --remote [--target <id>] status
hfSectionVisualizer --remote [--target <id>] ping
hfSectionVisualizer --remote [--target <id>] focus
hfSectionVisualizer --remote [--target <id>] maximize
hfSectionVisualizer --remote [--target <id>] minimize
hfSectionVisualizer --remote [--target <id>] [--timeout-ms <ms>] script <file>
hfSectionVisualizer --remote [--target <id>] script-save [file]
  • target: manage the local default target used when --target is omitted; see 2.1 Choosing the target window

Window State

hfSectionVisualizer --remote [--target <id>] focus
hfSectionVisualizer --remote [--target <id>] maximize
hfSectionVisualizer --remote [--target <id>] minimize
  • focus restores the window if needed, then raises and activates it.
  • maximize switches the target window to the maximized state, then raises and activates it.
  • minimize minimizes the target window.
  • These commands are remote-only UI helpers: they do not change section-model data and they do not append canonical command tails to Remote Control History.

Example:

hfSectionVisualizer --remote maximize
hfSectionVisualizer --remote focus
hfSectionVisualizer --remote minimize

File

  • Use these commands to create, open, save, or close section models from scripts or batch flows.
hfSectionVisualizer --remote [--target <id>] new [--discard-unsaved]
hfSectionVisualizer --remote [--target <id>] open <file>
hfSectionVisualizer --remote [--target <id>] save [file]
hfSectionVisualizer --remote [--target <id>] quit [--discard-unsaved]
  • new, open, quit:
  • if unsaved changes exist and the current file already has a path, auto-save first
  • if unsaved changes exist and there is no current file path, fail with SAVE_PATH_REQUIRED
  • new --discard-unsaved:
  • discards unsaved changes without auto-save
  • does not show the GUI save confirmation dialog
  • use it only when the caller intentionally wants a non-interactive discard
  • quit --discard-unsaved:
  • discards unsaved changes without auto-save
  • does not show the GUI save confirmation dialog
  • closes the target window immediately after the remote request is accepted
  • save [file]:
  • without [file], save to current file
  • with [file], save there and update the current file path