콘텐츠로 이동

hfVisualizer 원격 제어 Node

node

hfVisualizer --remote [--target <id>] node <id> <x,y,z> [--nset <name>]
  • preprocessing mode에서 node 하나를 생성하거나 갱신합니다.
  • <id>는 양의 정수여야 합니다.
  • <x,y,z>는 유한한 수치 3개여야 합니다.
  • <id>가 아직 없으면 새 node를 생성합니다.
  • <id>가 이미 있으면 해당 node 좌표를 갱신합니다.
  • --nset은 선택 사항이며, 새 node를 만들 때만 사용할 수 있습니다.
  • Node Table의 생성과 좌표 수정에 대한 canonical IPC/CLI 형식입니다.

예시:

hfVisualizer --remote node 101 0,0,0
hfVisualizer --remote node 101 10,20,30

node-copy

hfVisualizer --remote [--target <id>] node-copy <translate-copy|translate-move|rotate-copy|rotate-move> [--source <text>] --direction-axis <text> [--distance-angle <text>] [--start-id <id>] [--nset <name>] [--merge-node <on|off>]
  • GUI Copy Node와 같은 작업을 수행합니다.
  • --source는 nset-expression 문법을 사용합니다.
  • 1,2,3, 1:3, 1:9:2 같은 정수 id 패턴
  • 기존 nset 이름
  • 현재 UI node selection을 뜻하는 __selected__
  • 집합에서 제외하는 -token
  • --source를 생략하면 기본값은 __selected__입니다.
  • --direction-axis는 GUI와 같은 숫자 반복 형식을 사용합니다.
  • translate: dx,dy,dz
  • rotate: x1,y1,z1,x2,y2,z2
  • --distance-angle도 GUI와 같은 반복 문법을 사용합니다. 예: 1,2,2@1.5, 20,30,2@15
  • translate-copy, rotate-copy는 --start-id가 필요합니다.
  • translate-move는 --distance-angle을 사용하지 않습니다.
  • --nset은 선택 사항이며, GUI와 같이 원본/결과 node를 해당 nset에 넣습니다.
  • --merge-node 기본값은 on입니다.

예시:

hfVisualizer --remote node-copy translate-copy --source "__selected__" --direction-axis 1,0,0 --distance-angle 100,2@50 --start-id 1001 --nset COPIED --merge-node on
hfVisualizer --remote node-copy rotate-move --source "TOP_NODES,-__selected__" --direction-axis 0,0,0,0,0,1 --distance-angle 15

node-delete

hfVisualizer --remote [--target <id>] node-delete <ids|__selected__>
  • preprocessing mode에서 id 패턴 또는 현재 node selection으로 node를 삭제합니다.
  • GUI와 같은 safe delete 동작을 사용합니다.
  • <ids>는 1,2,3, 1:5, 1:9:2 같은 정수 id 패턴을 받습니다.
  • __selected__는 현재 node selection으로 해석됩니다.
  • Node Table 행 삭제에 대한 canonical IPC/CLI 형식입니다.
  • 검증 규칙:
  • preprocessing mode 전용
  • 요청한 모든 id가 삭제 시작 전에 존재해야 함
  • __selected__는 비어 있지 않은 현재 node selection이 필요함
  • 부분 삭제 동작:
  • safe delete 과정에서 일부 node가 남을 수 있음
  • 이 경우 DELETE_PARTIAL과 함께 requestedIds, deletedIds, remainingIds, 개수, canonical scriptTail을 반환함
  • 모델이 실제로 바뀌었으므로 적용된 tail은 Remote Control History에도 그대로 기록됨

예시:

hfVisualizer --remote node-delete 101:105
hfVisualizer --remote node-delete __selected__