JSBillboard

지도 내 전파 범위 3차원 모델 객체를 생성 및 설정하기 위한 API 입니다.

Module.createBillboard() API를 생성합니다.

var object = Module.createBillboard("ID");

Function

getId() → string

객체의 고유 명칭을 반환 합니다.

Information

• Return

  • string: 객체 설명 문자열이 성공적으로 반환.

  • null: 객체가 null인 경우.

Template

var strKey = object.getId();

set(position, icon, width, height) → boolean

빌보드 객체 생성 옵션을 설정합니다..

Information

Name	Type	Description
position	JSVector3D	빌보드 위치 좌표(경도, 위도, 고도) 기준은 중하단.
icon	JSIcon	객체의 이미지 아이콘.
width	number	객체의 가로 표현 크기(미터).
height	number	객체의 세로 표현 크기(미터).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function createBillboard 참조.

  • Sandbox_Billboard

Template

setImage(position, data, width, height) → boolean

빌보드 객체 생성 옵션을 설정합니다.

data 변수는 Uint8Array 기반의 바이너리 배열 데이터 입니다..

Information

Name	Type	Description
position	JSVector3D	빌보드 위치 좌표(경도, 위도, 고도) 기준은 중하단.
data	object	이미지 바이너리 데이터.
width	number	이미지의 너비.
height	number	이미지의 높이.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function createBillboard 참조.

  • Sandbox_Billboard Text

Template

setSizeScale(x, y, z) → boolean

객체의 크기 배율을 설정합니다.

각 항목은 0보다 큰 값으로 설정합니다..

Information

Name	Type	Description
x	number	x축 배율.
y	number	y축 배율.
z	number	z축 배율.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

setSizeFix(type) → boolean

객체의 표현 크기를 고정 또는 가변으로 설정합니다.

Information

Name	Type	Description
type	boolean	true: 고정 크기 설정. false: 가변 크기 설정.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setBillboardFixSize 참조.

  • Sandbox_Billboard Size Option

Template

setRotationMode(type) → boolean

빌보드 객체의 회전 옵션을 설정합니다.

Information

Name	Type	Description
type	boolean	true: 화면 정면 고정. false: 좌우만 고정, 상하 가변 회전.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setBillboardRotationMode 참조.

  • Sandbox_Billboard Rotation Option

Template

Getter / Setter

getDescription(), setDescription(desc) → string

객체에 대한 설명을 설정합니다.

Information

Name	Type	Description
desc	string	설명 문자열.

• Return

  • string: 객체 설명 문자열이 성공적으로 반환.

  • null: 객체가 null인 경우.

Template

var strDesc = object.getDescription();
// ... or ...
object.setDescription("First Object.");

getName(), setName(name) → string

객체 이름을 설정합니다.

Information

Name	Type	Description
name	string	객체 이름.

• Return

  • string: 객체 이름을 성공적을 반환

  • null: 객체가 null인 경우.

Template

var objName = object.getName();
// ... or ...
object.setName("MyObject");

getVisible(), setVisible(visible) → boolean

객체의 가시화 유무를 설정합니다.

Information

Name	Type	Description
visible	boolean	true: 객체 가시화. false: 객체 비가시화.

• Return

  • true: 객체 가시화 상태.

  • false: 객체 비가시화 상태.

Template

var objName = object.getName();
// ... or ...
object.setVisible(true);

setVerticalLine(options)

빌보드 객체에 수직선(altitude 방향)을 표시합니다.

수직선은 시각적 참조용으로 사용되며, 고도 차이나 위치 강조 시 유용합니다.

Information

Name	Type	Description
visible	boolean	수직선 가시화 여부.
width	number	수직선의 너비 (기본값: 1.0).
color	JSColor	수직선 색상 (기본값: rgba(255,255,255,150)).
altitude	number	수직선 끝 점 고도. 빌보드 시작점에서 아래로 이 고도까지 선이 이어집니다.

• 모든 옵션이 생략되면 "Parameter Not Found." 에러를 반환합니다.

• altitude 값이 설정되면 내부 수직선 객체가 새로 생성됩니다.

Template

var obj = Module.getObjectById("Billboard_1");

obj.setVerticalLine({
    visible: true,
    width: 2.0,
    color: new Module.JSColor(255, 100, 100, 200),
    altitude: 50.0
});