콘텐츠로 이동

hfVisualizer 원격 제어 CoordinateSystem

coordinatesystem

hfVisualizer --remote coordinatesystem <type> <name> (--content <text> | --content-file <file>)
  • *CoordinateSystem, TYPE=<type>, Name=<name> 정의 하나를 생성하거나 갱신합니다.
  • --content와 --content-file 중 정확히 하나가 필요합니다.
  • coordinatesystem은 preprocessing mode에서만 동작합니다.
  • 지원하는 좌표계 type은 User, Orientation, Beam입니다.
  • <name>은 비어 있으면 안 되고 GUI 편집과 같은 single-token 정규화를 적용합니다.
  • 명령은 keyword header를 먼저 만들고 나머지 줄을 block 본문으로 적용합니다.
  • 여기서 만든 이름은 이후 element-update --beam-cs, element-update --orientation-cs 같은 명령에서 그대로 참조할 수 있습니다.
  • 성공하면 script-save에 canonical coordinatesystem ... --content ... tail이 기록됩니다.

예시:

hfVisualizer --remote coordinatesystem User girder_cs --content "1, 0, 0\n0, 0, 1\n0, 1, 0"

coordinatesystem-rename

hfVisualizer --remote coordinatesystem-rename <old-name> <new-name>
  • preprocessing mode에서만 사용할 수 있습니다.
  • 두 이름 모두 비어 있으면 안 되고 GUI 편집과 같은 single-token 정규화를 적용합니다.
  • 기존 이름이 실제로 존재해야 합니다.
  • 새 이름이 다른 좌표계와 충돌하면 실패하고, 정규화 결과가 같은 이름이면 no-op으로 성공합니다.
  • 성공하면 script-save에 canonical coordinatesystem-rename ... tail이 기록됩니다.

예시:

hfVisualizer --remote coordinatesystem-rename girder_cs girder_local

coordinatesystem-activate

hfVisualizer --remote [--view-id <rN>] coordinatesystem-activate <name|none>
  • 지정한 User 좌표계를 대상 render view의 체크된 active user coordinate system으로 설정합니다.
  • 한 User 좌표계를 활성화하면 같은 render view에 있던 기존 active User 좌표계는 자동으로 해제됩니다.
  • 현재 모델과 대상 render view가 있으면 사용할 수 있으며 preprocessing mode로 제한되지 않습니다.
  • User 좌표계만 사용할 수 있습니다. Orientation, Beam 좌표계를 주면 오류를 반환합니다.
  • none을 주면 대상 render view의 active User 좌표계를 해제합니다.
  • --view-id <rN>을 주면 특정 render view를 대상으로 하고, 생략하면 active render view를 사용합니다.
  • TreeMenu 체크/해제와 같은 render-view 경로를 사용하므로 해당 render view에 대해서만 active UCS, 즉 2차원 datum 대상 좌표계가 바뀌거나 해제됩니다.
  • 성공하면 script-save에 canonical coordinatesystem-activate ... tail이 기록됩니다.

예시:

hfVisualizer --remote coordinatesystem-activate girder_local

hfVisualizer --remote coordinatesystem-activate none

coordinatesystem-delete

hfVisualizer --remote coordinatesystem-delete <name>
  • preprocessing mode에서만 사용할 수 있습니다.
  • <name>은 비어 있으면 안 되고 기존 좌표계 이름이어야 합니다.
  • ModelTree Delete와 같은 삭제 경로를 사용하므로 하중과 구속의 좌표계 참조 정리, beam assignment 해제, active user coordinate system 정리가 동일하게 적용됩니다.
  • 성공하면 script-save에 canonical coordinatesystem-delete ... tail이 기록됩니다.

예시:

hfVisualizer --remote coordinatesystem-delete girder_local