콘텐츠로 이동

hfVisualizer 원격 제어 개요

hfVisualizer 명령

이 문서는 스크립트, 터미널, 자동화 도구에서 hfVisualizer를 제어하기 위한 기본 참고 문서입니다. 처음 사용할 때는 list, status, open, save, 창 상태 명령(focus, maximize, minimize)부터 익힌 뒤 selection 또는 preprocessing 명령으로 확장하는 것을 권장합니다.

명령 그룹

  • Remote-only 보조 명령: list, target, status, ping, focus, maximize, minimize, script, script-save
  • View: view
  • 창과 파일: open, save, import, export, write-scene, write-program-shot, quit
  • 표시와 선택: select, visibility, representation, transparency, camera, view
  • 전처리 정의와 모델 이력: undo, redo, coordinatesystem, coordinatesystem-activate, coordinatesystem-rename, coordinatesystem-delete, construction, construction-rename, construction-delete, function, function-rename, function-delete, material, material-rename, material-delete, load, load-rename, load-delete, sensor, sensor-rename, sensor-delete, section, section-rename, section-delete, step, step-rename, step-delete, history, history-rename, history-delete, nset, nset-rename, nset-delete, elset, elset-rename, elset-delete, surface
  • 해석과 후처리: check-model, run-analysis, unlock-model, step-delete-from, post-*

모델링 참고

  • 정의 계열 명령은 script-save에 저장되는 canonical tail 형식을 그대로 사용합니다.
  • coordinatesystem, construction, function, material, load, sensor, section, step, history, nset, elset 계열은 생성/수정뿐 아니라 이름 변경과 삭제까지 ModelTree 동작에 맞춰 remote command로 사용할 수 있습니다. coordinatesystem-activate는 User 좌표계의 TreeMenu 체크/해제 동작을 render view 기준으로 그대로 재현하며, 이름을 주면 활성화하고 none을 주면 해제합니다.
  • 대부분의 정의 계열 명령은 postprocessing mode에서 잠겨 있지만, 현재 HDB를 직접 바꿀 수 있는 소수의 GUI 예외 경로인 environment-info set, nset, elset, step Post ..., step-delete-from ..., history PostHistory ...는 postprocessing mode에서도 수정할 수 있습니다.
  • step, history, nset, elset의 rename/delete는 remote 실행을 비대화식으로 유지하고 postprocessing 확인창을 피하기 위해 preprocessing mode에서만 사용할 수 있습니다.
  • undo, redo는 선언형 definition text가 아니라 현재 세션의 preprocessing model-history stack을 다시 적용하는 명령입니다.
  • 모든 정의 계열 명령은 --content <text> 또는 --content-file <file> 중 하나를 받습니다.

결과 출력

  • 성공했다고 해서 모든 명령이 같은 양의 결과 JSON을 출력하는 것은 아닙니다.
  • 항상 결과 JSON을 출력하는 대표 명령은 list, target, status, undo, redo, environment-*, grid-spacing, camera, view입니다.
  • post-step get, post-frame get, post-scalar get, post-vector get, post-contour ... get, post-scale ... get 같은 조회형 postprocessing 명령도 결과 JSON을 출력합니다.
  • 대부분의 파일 동작, 생성/수정/삭제 명령, 단순 토글 명령은 성공/실패만 반환합니다.
  • scriptTail 같은 내부 필드는 Remote Control History와 script-save 기록에만 사용되고, 일반 결과 JSON에는 노출되지 않습니다.