본문으로 건너뛰기

FAQ

노트

자주 하는 질문들을 모아 놓은 곳입니다.

어떻게 시작하나요?​

홈페이지로 올려보고 싶어요!​

화면에 License error! 창이 뜨고 3D 모델이 보이지 않아요!​

경고

라이선스 서버를 연결하지 않으면 해당 문제가 발생합니다.

  • 라이선스 서버 연결 방법: 3.0 · 2.1
  • 이미 설정했는데도 문제가 발생한다면
    라이선스 에러 메시지를 참고해주세요.

노트는 어떻게 생성하나요?​

모델이 나오지 않고 개발자 도구(F12)에 wasm 에러가 표시돼요​

public 폴더와 src 폴더가 있는데 VIZCore3D는 어디에 넣어야 하나요?​

정보

React / Vue / Angular 등 프레임워크 환경에서는
public 폴더와 src 폴더의 역할이 다르므로 아래 가이드를 참고해주세요.

  • 프레임워크 구성: 3.0 · 2.1을 참고해주세요.

뷰어를 헤더·사이드바가 있는 화면 안에 넣었더니 모델 트리·검색 패널이 안 보여요​

  • 임베딩 가이드를 참고해주세요.
  • 개발자 도구 콘솔에 [VIZWide3D] 경고가 있으면 경고에 적힌 코드 항목부터 확인해주세요.

VIZCore3D는 서버 성능의 영향을 받나요?​

  • VIZCore3D는 JavaScript(JS) 기반 라이브러리로
    웹 브라우저에서 실행되는 클라이언트 측 렌더링 엔진입니다.
  • 서버에서는 3D 경량 모델(VIZW)의 스트림 정보만 전달하며,
    렌더링 성능은 주로 사용자 PC 환경의 영향을 받습니다.

모델을 선택하면 반환되는 ID 정보로 무엇을 할 수 있나요?​

  • VIZCore3D의 선택 이벤트(3.0 · 2.1)를 통해
    ID를 포함한 다양한 모델 정보를 확인할 수 있습니다.
  • 해당 ID는 모델 정보를 조회하거나
    모델 형상을 제어할 때 가장 많이 사용되는 핵심 식별자입니다.

모델 ID 정보는 항상 동일한가요?​

노트

모델 ID 변경 가능성을 고려한 개발이 필요하다면
개발 가이드를 참고해주세요.

  • 단일 VIZW 파일
    • 모델 ID는 항상 동일합니다.
  • 분할된 VIZW 파일
    • 로딩 순서 및 로딩되는 모델 개수에 따라
      모델 ID가 변경될 수 있습니다.
    • 따라서 시스템 개발 시 모델 ID 변경 가능성을 반드시 고려해야 합니다.