JSTyphoon

지도 내 태풍을 표현하는 객체를 생성 및 설정하기 위한 API 입니다.

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

var object = Module.createTyphoon("id");

Function

create(position, size, alt) → boolean

태풍 객체의 위치와 크기를 설정합니다.

Information

Name	Type	Description
position	JSVector3D	중심 좌표 (경도, 위도, 고도).
size	number	크기.
alt	number	높이.

• Return

  • true: 생성 성공.

  • false: 생성 실패.

Template

var vPosition = new Module.JSVector3D(126.7824826, 35.0119469, 15.2752179);
typhoon.create(vPosition, 500.0, 150.0);

createbyJson(options) → object

태풍 객체를 생성합니다.

Information

Name	Type	Description
option	JSTyphoon.CreateOptions	속성 정보.

• Return

  • .result : API 성공 유무 상태 ( 1 : 성공, 0 : 실패)

  • .name : 동작 API 명칭

  • .return : API 반환 정보 ( object : 정상적인 반환값, 문자열 : 실패 에러 코드)

• Sample

  • function initPage 참조.

  • Sandbox_Typhoon

Template

let json = {
    id: "Typhoon",
    size: 800,
    height: 1000,
    position: new Module.JSVector3D(126.7852637, 35.0183227, 30.0),
    complete: complete,
    damage: {
        size: 500,
        altitude: 10,
        color: new Module.JSColor(200, 0, 0, 255),
        unionterrain: false,
    },
};

getId() → string

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

Information

• Return

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

  • null: 객체가 null인 경우.

Template

var strKey = object.getId();

moveStart()

태풍 객체 이동 이벤트를 동작 합니다.

moveList()를 통해 추가된 좌표로 태풍이 이동합니다.

태풍 객체 이동 이벤트 종료 후 위치로 초기화합니다.

Information

• Sample

  • function moveTyphoon 참조.

  • Sandbox_Typhoon

Template

moveEnd()

태풍 객체 이동 이벤트를 종료합니다.

태풍 객체 이동 이벤트 종료 후 위치로 초기화합니다.

Information

• Sample

  • function stopTyphoon 참조.

  • Sandbox_Typhoon

Template

moveList(list)

태풍 객체을 이동 정점 좌표(경도, 위도, 고도)을 추가합니다.

입력된 정점 좌표를 순차적으로 이동합니다.

Information

Name	Type	Description
list	Collection	이동 좌표 목록

• Sample

  • function moveTyphoon 참조.

  • Sandbox_Typhoon

Template

var movePosition = new Module.Collection();
movePosition.add(new Module.JSVector3D(126.77599416643791, 35.02714918251881, 34.293371013365686));
movePosition.add(new Module.JSVector3D(126.78374897355015, 35.03318059967435, 35.54886215366423));
movePosition.add(new Module.JSVector3D(126.79212321528658, 35.03203801070689, 25.686076117679477));
movePosition.add(new Module.JSVector3D(126.79408620811664, 35.019259090964134, 29.999966450035572));

setDamageRange(danger, size, alt, color)

태풍 객체의 피해 범위를 설정합니다.

Information

Name	Type	Description
danger	boolean	true: '위험' 상태 가시화. false: '경도' 상태 가시화.
size	number	피해 범위(in meter).
alt	number	피해 범위 출력 해발고도(in meter).
color	JSColor	표시 색상값.

Template

var rangeColor = new Module.JSColor(255, 255, 255, 0);
typhoon.setDamageRange(true, 300.0, 10.0, rangeColor);

setRotationSpeed(speed)

태풍 객체의 회전 속도를 설정합니다..

Information

Name	Type	Description
speed	number	회전 속도.

• Sample

  • function setTyphoonSpeed 참조.

  • Sandbox_Typhoon

Template

setSize(radius, alt)

태풍 객체 크기를 설정 합니다.

Information

Name	Type	Description
radius	number	태풍 반경.
alt	number	태풍 높이.

Template

typhoon.setSize(500.0, 150.0);

setSpeed(speed)

태풍 이동 속도를 설정합니다.

Information

Name	Type	Description
speed	number	이동 속도.

• Sample

  • function setTyphoonSpeed 참조.

  • Sandbox_Typhoon

Template

setUnionTerrain(type)

태풍 객체를 구성하는 영향권 범위 가시화 옵션을 설정합니다.

영향권 범위를 지형 결합 유무를 설정합니다.

Information

Name	Type	Description
type	boolean	true: 지형 결합 가시화(RTT). false: 일반 기시화.

• Sample

  • function setDamageRangeDisplay 참조.

  • Sandbox_Typhoon

Template

setTextureURL(url)

태풍 객체를 구성하는 이미지를 설정합니다.

Information

Name	Type	Description
url	string	이미지 url.

Template

typhoon.setTextureURL("./image/Typhoon.png");

setVisibleDamageRange(type)

태풍 객체를 구성하는 영향권 범위 가시화 유무 설정합니다.

Information

Name	Type	Description
type	boolean	true: 영향권 범위 가시화. false: 영향권 범위 비가시화.

• Sample

  • function setDamageRangeDisplay 참조.

  • Sandbox_Typhoon

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

Type Definitions

JSTyphoon.CreateOptions

태풍 객체 생성 옵션.

Name	Type	Attributes	Default	Description
id	string			고유 명칭.
position	JSVector3D			중심 좌표 (경도, 위도, 고도).
size	number	optional	500	태풍 크기 (in meters).
height	number	optional	100	태풍 높이 (in meters).
complete	function	optional		이동 이벤트 완료 시 동작하는 callback.
damage	JSTypoon.CreateOptions.Damage	optional		영향권 생성 속성 정보.

JSTyphoon.CreateOptions.Damage

Typhoon impact range object creation options.

Name	Type	Attributes	Default	Description
size	number	optional	500	영향권 크기 (in meters).
altitude	number	optional	10	영향권 생성 고도 (in meters).
unionterrain	boolean	optional	false	지형 결합 유무.
color	JSColor	optional	JSColor(200, 255, 0, 0)	생상값.