X-RAY 모드
X-RAY 모드는 외형 모델에 의해 가려진 내부 모델을 하이라이트하여 가시화하는 기능입니다.
X-RAY 모드 활성화
조회 중인 모델이 있는 경우에만 X-RAY 모드를 활성화할 수 있습니다.
// 조회 중인 모델이 있는 경우에만 동작
if (!Connector.IsOpenDocument()) return;
// X-RAY 모드 활성화
Connector.SetModelXrayMode(true);
하이라이트 대상 모델 설정
X-RAY 모드에서 하이라이트할 모델을 지정합니다.
// 단일 모델
Connector.SetSelectedCustom(3, true);
// 복수 모델
Connector.SetSelectedCustomMulti(new int[] { 3, 8 }, true);
참고 사항
- 하이라이트 대상 모델은 원본 색상으로 표시됩니다.
- 다른 색상으로 표시하고자 할 경우
색상 변경 API를 이용해 모델 색상을 변경해야 합니다.
X-RAY 모델 하이라이트 예시

선택 제어 관련 참고
X-RAY 모드에서 다음과 같은 제어가 가능합니다.
- 하이라이트 대상 모델만 선택 가능
- 투명 처리된 외형 모델은 선택 불가 처리 가능
이를 위해 다음 API를 활용할 수 있습니다.
SetSkipSelectByTransparentColor
→ 투명 처리된 모델에 대해 선택 차단
하이라이트 대상 변경 및 제거
하이라이트 대상 모델을 변경하거나 제거할 수 있습니다.
// 단일 모델 제거
Connector.SetSelectedCustom(3, false);
// 복수 모델 제거
Connector.SetSelectedCustomMulti(new int[] { 3, 8 }, false);
// 전체 제거 (초기화)
Connector.ClearAllSelectedCustom();
X-RAY 모드 종료
// X-RAY 모드 비활성화
Connector.SetModelXrayMode(false);