콘텐츠로 이동

Tutorial 05

Selection and Visibility

목표

이 튜토리얼은 hfVisualizer에서 가장 자주 반복되는 두 작업을 설명합니다.

  • 무엇을 선택할 것인가
  • 무엇을 보이거나 숨길 것인가

현재 원격 제어 기준으로 selection과 visibility는 서로 밀접하게 연결되어 있습니다.

1. selection은 작업 집합을 만든다

selection은 이후 명령이 사용할 작업 대상을 정하는 단계입니다.

대표 예:

  • node-delete __selected__
  • element-divide parametric --source __selected__
  • nset PICKED --content "__selected__"

기본 문법:

hfVisualizer --remote select <kind> <items|none> [--mode <current|union|intersection|xor|cur-diff-prev|prev-diff-cur>]

2. 선택 대상 종류

자주 쓰는 종류는 다음과 같습니다.

  • node
  • element
  • surface
  • edge
  • constraint
  • load
  • sensor

예시:

hfVisualizer --remote select node 1:20
hfVisualizer --remote select element 101:140 --mode union
hfVisualizer --remote select edge "17-42-23,31-32"
hfVisualizer --remote select surface "2@1:40"

일부 예시에서는 가독성을 위해 큰따옴표를 유지했습니다. PowerShell이나 cmd.exe에서 큰따옴표는 명령줄 인자 하나를 묶는 역할만 하므로, 1:20, 1496-1494,1817-1496, 2@1:40처럼 공백이 없는 토큰은 큰따옴표 유무와 관계없이 동일하게 동작합니다.

3. __selected__를 활용한다

후속 명령에서 현재 selection을 다시 쓰고 싶을 때 __selected__가 유용합니다.

hfVisualizer --remote select node 1:10
hfVisualizer --remote nset PICKED --content "__selected__"
hfVisualizer --remote node-delete __selected__

이 패턴을 익혀 두면 GUI에서 한 번 선택하고 원격 제어에서 이어받는 흐름도 자연스럽습니다.

4. visibility는 render view 기준이다

visibility는 모델 자체를 바꾸지 않고, 특정 render view에서만 보이거나 숨기게 합니다.

기본 문법:

hfVisualizer --remote visibility <kind> <items|all> <on|off>
hfVisualizer --remote --view-id r1 visibility <kind> <items|all> <on|off>

핵심 규칙:

  • 기본 대상은 activeRenderView
  • --view-id를 쓰면 다른 render view를 직접 조정 가능
  • 전역 all-view visibility가 아니라 ModelTree 체크박스와 같은 성격

5. visibility 대상 종류

자주 쓰는 종류:

  • node
  • element
  • node-set
  • element-set
  • constraint
  • load
  • surface
  • construction
  • sensor

예시:

hfVisualizer --remote visibility node 1:10 off
hfVisualizer --remote visibility element all on
hfVisualizer --remote visibility node-set TOP_NODES off
hfVisualizer --remote --view-id r1 visibility surface S1,S2 on

6. 추천 workflow

다음 순서가 안정적입니다.

  1. select로 작업 대상을 만든다
  2. 필요하면 visibility로 화면을 정리한다
  3. 편집 명령을 적용한다
  4. 결과를 확인한 뒤 다시 select none으로 정리한다

예시:

hfVisualizer --remote select element 201:240
hfVisualizer --remote visibility element 201:240 off
hfVisualizer --remote select none

7. 주의할 점

  • selection은 현재 선택 상태를 바꾸고
  • visibility는 현재 render view의 표시 상태를 바꿉니다.

둘은 비슷해 보여도 저장되는 대상이 다릅니다.

같이 보면 좋은 문서

다음 문서