JSFigure

지도 내 3D figure 객체 생성 및 설정하기 위한 API 입니다.

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

JSFigure Type Constants

let figure = Module.createFigure("ID");

Properties

Name	Type	Description
isplayer	boolean	비디오 실행 여부.
videoStreaming	boolean	비디오 스트리밍 여부.
axisX	boolean	좌우 반전.
axisY	boolean	상하 반전.

Function

getAngle() → number

객체의 Y축 중심 회전 각도(degree 단위)를 반환합니다.

Information

• Return

  • number: 반환 성공.

  • -999.0: 반환 실패.

Template

var dAngle = figure.getAngle();

getBoundary() → JSAABBox3D

객체의 공간 영역 좌표(경도, 위도, 고도)를 반환합니다.

Information

• Return

  • JSAABBox3D: 반환 성공.

  • null: 반환 실패.

Template

var boundary = figure.getBoundary();
var boundary_min = boundary.min;
var boundary_max = boundary.max;

getCenter() → JSVector3D

객체의 중심 좌표(경도, 위도, 고도)를 반환합니다.

Information

• Return

  • JSVector3D: 반환 성공.

  • null: 반환 실패.

Template

var vCenter = figure.getCenter();
var dCenterLon = vCenter.Longitude;
var dCenterLat = vCenter.Latitude;
var dCenterAlt = vCenter.Altitude;

getExtent() → number

객체의 공간 영역의 장축 거리를 반환합니다.

Information

• Return

  • number: 거리 반환 성공.

Template

var bExtends = figure.getExtent();

getFigureType() → number

객체의 figure 타입을 반환합니다.

JSFigure Type Constants

Information

• Return

  • number: 반환 성공.

  • -1: 반환 실패.

Template

var figureType = figure.getFigureType();

getId() → string

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

Information

• Return

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

  • null: 객체가 null인 경우.

Template

var strKey = object.getId();

getPosition() → JSVector3D

객체의 바닥면 중심 좌표(경도, 위도, 고도)를 반환합니다.

Information

• Return

  • JSVector3D: 반환 성공.

  • null: 반환 실패.

Template

let position = figure.getPosition();
let longitude = position.x;
let latitude = position.y;
let altitude = position.z;

getSize() → JSVector3D

객체의 해당되는 3차원 축의 크기(meter 단위)를 반환합니다.

Information

• Return

  • JSVector3D: 반환 성공.

  • null: 반환 실패.

Template

let size = figure.getSize();
let width = size.x;
let height = size.y;
let depth = size.z;

setAngle(angle) → boolean

객체의 Y축 중심 회전 각도를 설정합니다.

Information

Name	Type	Description
angle	number	회전 각도 (degree 단위).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

  • 실패 조건

    • 입력 변수값(angle)이 0 ~ 360 범위를 벗어난 값이 입력된 경우.

Template

figure.setAngle(50.0);

setDepth(depth) → boolean

객체의 Z축 깊이를 설정합니다.

Information

Name	Type	Description
depth	number	깊이 값.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

figure.setDepth(200.0);

setHeight(height) → boolean

객체의 Y축 높이를 설정합니다.

Information

Name	Type	Description
height	number	높이(meter 단위).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

figure.setHeight(100.0);

setWidth(width) → boolean

객체의 X축 너비를 설정합니다.

Information

Name	Type	Description
width	number	너비(meter 단위).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

figure.setWidth(130.0);

setPosition(position) → boolean

객체의 바닥면 중심 좌표(경도, 위도, 고도)를 설정합니다.

Information

Name	Type	Description
position	JSVector3D	바닥면 중심 위치(경도, 위도, 고도).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

var vPos = new Module.JSVector3D("127.0273188", "37.4977981", "30.0");
figure.setPosition(vPos);

setSize(width, height, depth) → boolean

객체의 해당되는 3차원 축의 크기(meter 단위)를 설정합니다.

Information

Name	Type	Description
width	number	너비(meter 단위).
height	number	높이(meter 단위).
depth	number	깊이(meter 단위).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

Template

figure.setSize(50.0, 100.0, 150.0);

setledBoard(option) → string

전광판 객체를 생성합니다.

Information

Name	Type	Description
url	string	미디어 URL 경로.
streaming	boolean	비디오 스트리밍 설정.
xaxis	boolean	좌우 반전 설정.
yaxis	boolean	상하 반전 설정.

• Return

  • success : 텍스쳐 생성 성공.

  • 실패 조건

    • null : 생성된 객체가 없을 경우.

    • url tag isn't exist : url 태그가 없을 경우.

    • streaming tag isn't exist. : streaming 태그가 없을 경우.

• Sample

  • function createBoard 참조.

  • Sandbox_LED Display

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");

getStyle(), setStyle(style) → JSPolygonStyle

JSPolygonStyle에 적용된 객체의 스타일을 설정합니다.

적용 가능한 스타일(업데이트 될 수 있음 JSPolygonStyle)

Information

Name	Type	Description
style	JSPolygonStyle	객체 스타일.

• Return

  • (JSPolygonStyle): 설정 성공.

  • null: 설정 실패.

Template

var figure = new Module.JSFigure();
var figureStyle = figure.getStyle();
// ... or ...
var figure = new Module.JSFigure();
var figureStyle = new Module.JSFigureStyle();
//...
figure.setStyle(figureStyle);

getVisible(), setVisible(visible) → boolean

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

Information

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

• Return

  • true: 객체 가시화 상태.

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

Template

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