JSCamera

지도 카메라 설정을 위한 API입니다.

Module.getViewCamera API를 생성합니다.

var camera = Module.getViewCamera();

Properties

Name

Type

Description

videoStreaming

boolean

비디오 스트리밍 여부.

videoFar

number

비디오 최대 가시거리.

videoFovX

number

화각 넓이.

videoFovY

number

화각 높이.

videoAlpha

number

비디오 투명값.

videoAxisX

boolean

좌우 반전.

videoAxisY

boolean

상하 반전.

videoZoom

number

비디오 배율.

videoFarPlane

boolean

비디오 뒷배경 여부.

videoResolution

number

비디오 해상도.

videoObjectMapping

boolean

건물 매핑 여부.

videoIsplayer

boolean

비디오 재생 여부.

Function

AltitudeDown()

카메라의 고도를 낮춥니다.

AltitudeUp()

카메라의 고도를 높입니다.

AngleDown()

카메라의 기울기 각도를 낮춥니다.
회전을 지원하지 않는 평면 모드에서는 작동하지 않습니다.

AngleUp()

카메라의 기울기 각도를 높입니다.

FOVDecrease()

카메라의 FOV를 줄입니다.

FOVIncrease()

카메라의 FOV를 높입니다.

getMapZoomLevel() → number

카메라 고도에서 가시화 된 지형 정밀 레벨 정보를 반환합니다.

Return
- number: 현재 가시화 지형 레벨.

getMapScale() → number

직교 투영시 축척을 반환합니다.

Return
- number: 1cm에 대한 축척.

setLookAt(f_altitude, f_longitude, f_latitude, t_altitude, t_longitude, t_latitude) → boolean

두 점을 사용하여 카메라를 이동합니다.

Name

Type

Description

f_altitude

number

카메라 위치 고도 좌표 (degrees 단위).

f_altitude

number

카메라 위치 고도 좌표 (degrees 단위).

f_longitude

number

카메라 위치 경도 좌표 (degrees 단위).

f_latitude

number

카메라 위치 위도 좌표 (degrees 단위).

t_altitude

number

카메라가 보고 있는 위치 고도 좌표(degrees 단위).

t_longitude

number

카메라가 보고 있는 위치 경도 좌표(degrees 단위).

t_latitude

number

카메라가 보고 있는 위치 위도 좌표(degrees 단위).

Return
- true : 설정 성공.
- false : 설정 실패.

look(from, to) → boolean

두 점을 사용하여 카메라를 이동합니다.

Name

Type

Description

from

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

JSVector3D

카메라가 보고 있는 위치 좌표(경도, 위도, 고도).

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function init 참조.
- Sandbox_Circular Path Movement

getLookPosition(distance) → JSVector3D

카메라가 바라보는 점의 좌표를 반환합니다.

Name

Type

Description

distance

number

카메라에서부터 바라보는 지점까지의 거리.

Return
- JSVector3D : 카메라가 보는 방향으로 distance 만큼 진행한 좌표.

setSmoothMove(type) → void

카메라의 부드러운 움직임을 설정합니다.

Name

Type

Description

type

boolean

Smooth Move true: 활성화 false: 비활성화

Description
- 카메라 이동 시 현재 위치와 다음 위치 사이를 보간하여 더 자연스러운 움직임을 구현합니다.

MapRender()

3D 지도 화면을 갱신합니다.

move(position, tilt, direct, speed)

카메라를 지정된 위치, 기울기, 방향을 설정합니다.

Name

Type

Description

position

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

tilt

number

카메라 기울기.

direct

number

카메라 좌우 회전.

speed

number

카메라 이동 속도 (1.0 ~ 10.0).

Sample
- function init 참조.
- Sandbox_Position Movement

moveDist(location, tilt, direct, dist, speed)

카메라를 지정된 위치, 기울기, 방향, 거리, 속도를 설정합니다.

Name

Type

Description

location

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

tilt

number

카메라 기울기.

direct

number

카메라 좌우 회전.

dist

number

(현재 미적용).

speed

number

카메라 이동속도 (기본 1).

MoveDown()

카메라를 현재 위치에서 뒤로 이동합니다.

MoveLeft()

카메라를 현재 위치에서 왼쪽으로 이동합니다.

moveLonLat(longitude, latitude)

카메라를 지정된 위치(경도, 위도)를 설정합니다.

Name

Type

Description

longitude

number

카메라 위치 경도 좌표 (degrees 단위).

latitude

number

카메라 위치 위도 좌표 (degrees 단위).

moveLonLatAlt(x, y, z, type)

카메라를 지정된 위치(경도, 위도, 고도)를 설정합니다.

Name

Type

Description

number

카메라 위치 경도 좌표 (degrees 단위).

number

카메라 위치 위도 좌표 (degrees 단위).

number

카메라 위치 고도 좌표 (meter 단위).

type

boolean

카메라 이동 애니메이션 적용 유무.

Sample
- function init 참조.
- Sandbox_Path Movement

moveLonLatAltOval(longitude, latitude, altitude, speed)

카메라를 지정된 위치(경도, 위도, 고도) 이동 시 확대/축소 애니메이션을 설정합니다.

Name

Type

Description

longitude

number

카메라 위치 경도 좌표 (degrees 단위).

latitude

number

카메라 위치 위도 좌표 (degrees 단위).

altitude

number

카메라 위치 고도 좌표 (meter 단위).

speed

number

카메라 이동속도 (기본 1).

moveLonLatBoundary(min, max) → boolean

최소 좌표점, 최대 좌표점을 이용한 카메라 이동 및 완료 이벤트를 설정합니다.

Name

Type

Description

min

JSVector2D

2차원 경위도 min 좌표

max

JSVector2D

2차원 경위도 max 좌표

Return
- true : 설정 성공.
- false : 설정 실패

var API = {
    JSCamera : Module.getViewCamera();
};
var Boundary = {
    min : new Module.JSVector2D(min_longitude, min_latitude);
    max : new Module.JSVector2D(max_longitude, max_latitude);
}
API.JSCamera.moveLonLatBoundary(Boundary.min, Boundary.max);

moveLonLatBoundarybyJson(option) → string

최소 좌표점, 최대 좌표점을 이용한 카메라 이동 및 완료 이벤트를 설정합니다.

Name

Type

Description

option

JSCamera.MoveBoundaryOption

속성 정보.

Return
- true : 설정 성공.
- false : 설정 실패.
- 실패 조건
  - JSCamera.MoveBoundaryOption 구성 태그가 누락된 경우.
Sample
- function moveTestArea 참조.
- Sandbox_Camera Area Setting

function complete(...args) {
    console.log(args);
}

let json = {
    boundary: {
        // Camera movement position
        min: new Module.JSVector2D(area_min_lon, area_min_lat), // Bottom left
        max: new Module.JSVector2D(area_max_lon, area_max_lat), // Top right
    },
    complete: complete, // Callback after movement completion
};

moveLonLatOval(longitude, latitude, speed)

카메라를 지정된 위치(경도, 위도) 이동 시 애니메이션 효과를 설정합니다.

Name

Type

Description

longitude

number

카메라 위치 경도 좌표 (degrees 단위).

latitude

number

카메라 위치 위도 좌표 (degrees 단위).

speed

number

카메라 이동속도 (기본 1).

moveOval(position, tilt, direct, speed)

카메라를 지정된 위치(경도, 위도, 고도) 이동 시 애니메이션 효과를 설정합니다.

Name

Type

Description

position

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

tilt

number

카메라 기울기.

direct

number

카메라 좌우 회전.

speed

number

카메라 이동 속도 (1.0 ~ 10.0).

Sample
- function initPage 참조.
- Sandbox_Landscape View

moveOvalDist(location, tilt, Direct, speed)

카메라를 지정된 위치(경도, 위도, 고도)로 부터 기울기 방향을 기준으로 거리를 적용한 좌표를 설정한다.
카메라 이동시 확대/축소 애니메이션 효과 설정한다.

Name

Type

Description

location

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

tilt

number

카메라 기울기.

direct

number

카메라 좌우 회전.

speed

number

카메라 이동 속도 (1.0 ~ 10.0).

MoveRight()

카메라를 현재 위치에서 오른쪽으로 이동합니다.

MoveUp()

카메라를 현재 위치에서 앞으로 이동합니다.

pauseAutoMove(pause) → boolean

카메라 자동 이동 시 일시 중지를 설정합니다.

Name

Type

Description

pause

boolean

자동 이동 설정. true: 멈춤. false: 시작.

Return
- true: 설정 성공.
- false: 설정 실패.
Sample
- function pauseCameraAutoMove 참조.
- Sandbox_Path Movement

reset()

카메라의 속성 정보를 초기화 상태로 설정합니다.

rotateLeft()

카메라를 현재 왼쪽으로 회전합니다.

rotateRight()

카메라를 현재 오른쪽으로 회전합니다.

getDistance(), setDistance(Dist) → number

카메라 시점, 위치 간의 거리를 설정 및 반환합니다.

Name

Type

Description

Dist

number

카메라 시야 거리 (meters 단위).

setAutoMovePosition(coordinates) → boolean

카메라의 자동 이동 좌표 목록을 설정합니다.

Name

Type

Description

coordinates

JSVec3Array

자동 이동 경로의 좌표 목록.

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function setAutoMovePosition 참조.
- Sandbox_Path Movement

var vMovePositionList = new Module.JSVec3Array();
vMovePositionList.push(new Module.JSVector3D(129.12695440075726, 35.16601614946393, 50.0));
vMovePositionList.push(new Module.JSVector3D(129.12188858001704, 35.173578909363805, 50.0));
vMovePositionList.push(new Module.JSVector3D(129.12027302076595, 35.17489727168604, 50.0));
vMovePositionList.push(new Module.JSVector3D(129.1193336034672, 35.176296224587475, 50.0));
Module.getViewCamera().setAutoMovePosition(vMovePositionList);

insertAutoMovePosition(coordinates, direct, tilt) → boolean

카메라의 자동 이동 좌표 목록에 새로운 좌표를 추가합니다.

Name

Type

Description

coordinates

JSVector3D

추가할 좌표. 경도, 위도, 고도로 구성. (degrees 단위)

tilt

number

카메라의 상하 기울기 각도 (단위: 도, degree).

direct

number

카메라의 방위각, 즉 수평 방향 (단위: 도, degree)

Return
- true : 설정 성공.
- false : 설정 실패.

setAutoMoveWaitFrame(speed) → boolean

카메라의 자동 이동 중 카메라의 이동 간격 발생 프레임을을 설정합니다.

Name

Type

Description

speed

number

카메라 이동 애니메이션 발생 프레임 수.

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function setAutoMovePosition 참조.
- Sandbox_Path Movement

SetAutoMoveIntrerval(interval) → boolean

카메라의 자동 이동 중 카메라의 한 구간 이동 간격을 설정합니다.

Name

Type

Description

interval

number

카메라 한 구간 이동 간격.

Return
- true : 설정 성공.
- false : 설정 실패.

setAutoMoveRoundPositions(center, distance, altitude, startAngle, endAngle, type) → boolean

카메라의 원형 이동 경로를 설정합니다.

Name

Type

Description

center

JSVector3D

카메라 회전 중심 좌표(경도, 위도, 고도)

distance

number

카메라 회전 반지름 거리 (meter 단위).

altitude

number

카메라 위치 고도 좌표 (meter 단위).

startAngle

number

카메라 초기 시야 방향

endAngle

number

카메라 종료 시야 방향

type

boolean

카메라 이동 방향 설정 (true: 반시계 방향, false: 시계 방향)

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function setAutoMovePosition 참조.
- Sandbox_Circular Path Movement

SetCameraShakeEffect(type) → boolean

카메라 흔들림 효과를 설정합니다.

Name

Type

Description

type

boolean

카메라 흔들링 유무 설정.

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function ShakeCamera 참조.
- Sandbox_Camera Shake

SetCameraShakeStrength(value) → boolean

카메라 흔들림 강도를 설정합니다.

Name

Type

Description

value

number

카메라 흔들링 강도 (1 ~ 100).

Return
- true : 설정 성공.
- false : 설정 실패.
Sample
- function SetShakeEffectStrength 참조.
- Sandbox_Camera Shake

setPermitUnderGround(type)

지하에서 카메라 이동 유무를 설정합니다.

Name

Type

Description

type

boolean

지하 이동 true: 이동 가능. false: 이동 금지.

startAutoMove() → boolean

카메라 자동 이동을 시작합니다.

Return
- true: 설정 성공.
- false: 설정 실패.
Sample
- function startCameraAutoMove 참조.
- Sandbox_Path Movement

stopAutoMove() → boolean

카메라 자동 이동을 종료합니다.

Return
- true: 설정 성공.
- false: 설정 실패.
Sample
- function stopCameraAutoMove 참조.
- Sandbox_Path Movement

viewNorth()

카메라가 정복 방향을 바라보도록 회전 합니다.

ZoomIn()

화면 중심 위치를 기준으로 카메라 확대를 실행합니다.

ZoomOut()

화면 중심 위치를 기준으로 카메라 축소를 실행합니다.

Zoom(screenX, screenY, distance)

화면 특정 좌표를 기준으로 카메라 확대/축소를 실행합니다.

Name

Type

Description

screenX

number

화면의 X 좌표(정수)

screenY

number

화면의 Y 좌표(정수)

distance

number

확대/축소 거리. 양수면 줌아웃, 음수면 줌인.

Return
- true: 확대/축소 성공
- false: 확대/축소 실패

setVideoInfo(option) → string

비디오 텍스쳐를 생성합니다.

Name

Type

Description

url

string

미디어 URL 경로.

dronemode

boolean

중심 좌표 (경도, 위도, 고도).

streaming

boolean

비디오 스트리밍 설정.

objectmapping

boolean

건물 매핑 설정.

alpha

number

비디오 투명값 설정.

zoom

number

비디오 배율 설정.

fov

Size2D

비디오 화각 설정.

xaxis

boolean

비디오 좌우 반전 설정.

yaxis

boolean

비디오 상하 반전 설정.

resolution

number

비디오 해상도 설정.

farplane

boolean

뒷배경 설정.

Return
- success : 텍스쳐 생성 성공.
- 실패 조건
  - url tag isn't exist : url 태그가 없을 경우.
  - streaming tag isn't exist : streaming 태그가 없을 경우.
Sample
- function createCCTV, createCCTVDrone 참조.
- Sandbox_Video Texture

clearVideo() → boolean

비디오 텍스쳐를 초기화 합니다.

Return
- true : 초기화 성공.
- false : 초기화 실패.
- 실패 조건
  - 비디오 텍스쳐가 없을 경우.
  - 비디오 데이터가 없을 경우.
  - 비디오 경로가 없을 경우.
Sample
- See function setTilt.
- Sandbox_Video Texture

Getter / Setter

getAnimationSpeed(), setAnimationSpeed(speed) → number

카메라 이동 애니메이션의 속도를 설정합니다.

Name

Type

Description

speed

number

카메라 이동 속도 (1.0 ~ 10.0).

Return
- number: 카메라 이동 애니메이션 적용 속도.
Sample
- function setEvent 참조.
- Sandbox_Path Movement

getDirect(), setDirect(direct) → number

카메라의 현재 방향 각도를 설정 및 반환합니다.
방향각도 값의 범위는 -180도 ~ 180도 사이 입니다.
0도: 북쪽
+90도: 동쪽
180도 or -180도: 남쪽
-90도: 서쪽

Name

Type

Description

direct

number

카메라 좌우 회전.

Return
- number: 카메라 좌우 회전값 반환 (degree 단위).
Sample
- function setDirect 참조.
- Sandbox_Camera Setting

getAltitude(), setAltitude(alt) → number

카메라 고도를 설정 및 반환합니다.

Name

Type

Description

alt

number

카메라 위치 고도 좌표 (meter 단위).

Return
- number: 카메라 위치 고도 좌표 (meter 단위).
Sample
- function setAltitude 참조.
- Sandbox_Camera Setting

getFov(), setFov(fov) → number

카메라의 화각을 설정 및 반환 합니다.

Name

Type

Description

fov

JSVector2D

카메라 화각.

Return
- number: 카메라 시야 화각 반환 (degree 단위).
Sample
- function setFOV 참조.
- Sandbox_Camera Setting

getCenterPoint() → JSVector3D

화면 중심의 지도 좌표를 반환합니다.

Return
- JSVector3D: 반환 성공

getLocation() → JSVector3D

카메라 위치 좌표를 반환합니다.

Return
- JSVector3D: 카메라 위치 좌표 (경도, 위도, 고도)를 성공적으로 반환.
- null: 카메라 위치 좌표 반환에 실패.

getTargetLocation() → JSVector3D

카메라 타겟 좌표를 반환합니다.

Return
- JSVector3D: 카메라 타겟 좌표 (경도, 위도, 고도)를 반환.
- 카메라 이동 애니메이션이 적용된 상태에서 카메라의 최종 목적지 좌표를 반환.
Sample
- Sandbox_Camera Jump

setLocation(position) → boolean

카메라 위치 좌표를 설정합니다.

Name

Type

Description

position

JSVector3D

카메라 위치 좌표 (경도, 위도, 고도).

Return
- true: 설정 성공.
- false: 설정 실패.
Sample
- function setMove 참조.
- Sandbox_Camera Setting

getMoveMode(), setMoveMode(type) → boolean

1인칭, 3인칭 카메라 회전 모드를 설정 및 반환 합니다.

Name

Type

Description

type

boolean

카메라 회전 모드.

Return
- 카메라 모드 반환.
  - true: 1인칭 시점 회전 모드.
  - false: 3인칭 시점 회전 모드.
Sample
- function setPerson 참조.
- Sandbox_Camera Setting

setLimitCamera(type)

카메라 이동 제한 여부를 설정합니다.

Name

Type

Description

type

boolean

카메라 이동 제한 여부

Description
- 카메라 이동 경계 박스 제한과 고도 제한을 설정/해제 합니다.
  - true : 제한 설정
  - false : 제한 해제
Sample
- Sandbox_Camera Limit

setLimitRectAlt(minX, minY, maxX, maxY, altitude)

카메라 이동 경계 박스를 설정합니다.

Name

Type

Description

minX

number

경도의 최솟값

minY

number

위도의 최솟값

maxX

number

경도의 최댓값

maxY

number

위도의 최댓값

altitude

number

카메라 제한 고도값 (meters 단위)

Description
- 카메라 이동 경계 박스를 설정합니다.

getLimitAltitude(), setLimitAltitude(alt) → number

카메라 제한 고도값을 설정 및 반환합니다.

Name

Type

Description

alt

number

카메라 제한 고도값 (meters 단위).

Return
- number: 카메라 제한 고도값 반환 (meter 단위).
Sample
- function initPage 참조.
- Sandbox_Path Movement

getLimitTilt(), setLimitTilt(tilt) → number

카메라 제한 기울기 각도를 설정 및 반환합니다.

Name

Type

Description

tilt

number

카메라 제한 기울기 각도 (degree 단위).

Return
- number: 카메라 제한 기울기 각도를 반환합니다 (degree 단위).
Sample
- function initPage 참조.
- Sandbox_Camera Path Movement

getLimitminTilt(), setLimitminTilt(tilt) → number

카메라 제한 기울기 최소 각도를 설정 및 반환합니다.

Name

Type

Description

tilt

number

카메라 제한 기울기 최소 각도 (degree 단위).

Return
- number: 카메라 제한 기울기 최소 각도를 반환합니다 (degree 단위).

getLimitmaxTilt(), setLimitmaxTilt(tilt) → number

카메라 제한 기울기 최대 각도를 설정 및 반환합니다.

Name

Type

Description

tilt

number

카메라 제한 기울기 최대 각도 (degree 단위).

Return
- number: 카메라 제한 기울기 최대 각도를 반환합니다 (degree 단위).

getTilt(), setTilt(tilt) → number

카메라 기울기 각도를 설정 및 반환합니다.

Name

Type

Description

tilt

number

카메라 기울기 각도 (degree 단위).

Return
- number: 카메라 기울기 각도를 반환합니다 (degree 단위).
Sample
- See function setTilt.
- Sandbox_Camera Setting

moveFrontBack(delta)

카메라를 현재 시점 방향 기준으로 앞 또는 뒤로 이동합니다.

Name

Type

Description

delta

number

이동 거리. 양수면 앞으로, 음수면 뒤로 이동.

moveLeftRight(delta)

카메라를 현재 시점 기준으로 좌우로 이동합니다.

Name

Type

Description

delta

number

이동 거리. 양수면 오른쪽, 음수면 왼쪽으로 이동.

moveFront()

카메라를 현재 시점 방향으로 전진시킵니다. 1인칭(FPS) 모드일 경우 지형 고도에 따라 자동으로 고도를 조정합니다.

Description
- 기본 이동 거리(delta)는 내부 설정값(getMoveDelta)을 따릅니다.
- FPS 모드 활성화 시, 이동 후 지형 높이에 맞춰 카메라 고도가 자동 보정됩니다.

moveBack()

카메라를 뒤로 이동합니다.

Description
- 카메라를 뒤로 이동합니다.

moveLeft()

카메라를 현재 위치에서 왼쪽으로 이동합니다.

Description
- 카메라를 좌측 방향으로 이동합니다.

moveRight()

카메라를 현재 시점 기준으로 오른쪽으로 이동합니다.

Description
- 카메라를 오른쪽으로 이동합니다.

rotateUp()

카메라를 위쪽으로 회전합니다.

Description
- 카메라의 X축 기준 기울기(틸트)를 감소시켜 위로 올립니다.

rotateDown()

카메라를 아래쪽으로 회전합니다.

Description
- 카메라의 X축 기준 기울기(틸트)를 증가시켜 아래로 내립니다.

moveUp()

카메라를 현재 위치에서 위로 이동합니다.

Description
- 카메라를 현재 위치에서 위로 이동합니다.

moveDown()

카메라를 현재 위치에서 아래로 이동합니다.

Description
- 카메라를 시점 기준 아래로 이동합니다.

getCameraSpeed(), setCameraSpeed(speed) → number

카메라의 이동 속도를 설정 및 반환합니다.

Name

Type

Description

speed

number

카메라 이동 속도(정수)

setTraceTarget(target) → boolean

카메라의 추적 대상을 설정합니다.

Name

Type

Description

target

JSTraceTarget

추적 대상 객체입니다.

Return
- true: 추적 대상 설정 성공
- false: 대상이 유효하지 않거나 설정 실패
Description
- 지정된 객체를 카메라가 지속적으로 따라가도록 설정합니다.

var traceTarget = Module.createTraceTarget(model.getId());
traceTarget.set({
    object: model,
    tilt: 45.0,
    direction: 0.0,
    distance: 100.0,
});

var camera = Module.getViewCamera();
camera.setTraceTarget(traceTarget);

setTraceActive(active) → boolean

추적 대상의 추적 활성화 여부를 설정합니다.

Name

Type

Description

active

boolean

true: 추적 활성화, false: 비활성화

Return
- true: 설정 성공
- false: 설정 실패 (내부 엔진 미정의 상태 등)
Description
- setTraceTarget()으로 설정한 대상에 대해 추적을 켜거나 끌 수 있습니다.

ReleaseTrace() → boolean

카메라의 추적 대상을 삭제합니다.

Description
- 설정된 카메라의 추적 대상을 삭제합니다.

bankLeft()

카메라를 왼쪽으로 기울입니다.

Description
- 카메라의 롤(Roll) 축을 따라 왼쪽으로 회전(기울기)합니다.

bankRight()

카메라를 오른쪽으로 기울입니다.

Description
- 카메라의 롤(Roll) 축을 따라 오른쪽으로 회전(기울기)합니다.

setPlayerMode(mode) → void

1인칭 카메라 모드에서 플레이어 모드(물리 기반)를 활성화/비활성화 합니다.

Name

Type

Description

mode

boolean

플레이어 모드 true: 활성화 false: 비활성화

Description
- 1인칭 지형 결합 모드와 함께 활성화 되어 있을 때, 점프가 가능하며 자연스러운 중력 낙하 효과가 적용됩니다.
Sample
- Sandbox_View Mode

isGround() → boolean

1인칭 카메라 모드에서 카메라가 현재 지면에 닿아 있는지 여부를 반환합니다.

Description
- 플레이어 모드가 활성화된 상태에서만 지면 여부를 판별합니다.
- true일 때만 점프가 가능합니다.
Return
- true : 지면에 닿아 있음.
- false : 지면과 닿아 있지 않음 또는 플레이어 모드가 비활성화
Sample
- Sandbox_Camera Jump

jump() → void

1인칭 카메라 지형결합 모드, 플레이어 모드에서 카메라가 자연스럽게 공중으로 올라갔다가 떨어집니다.

Description
- 1인칭 지형 결합 모드와 플레이어 모드가 모두 활성화된 상태에서만 동작합니다.
- 점프 세기, 중력, 시간 간격을 조절할 수 있습니다.
Sample
- Sandbox_Camera Jump

getJumpForce(), setJumpForce(jumpForce) → number

초기 점프 속도(점프 세기)를 설정 및 반환합니다.

Name

Type

Description

jumpForce

number

초기 점프 속도(점프 세기)

Sample
- Sandbox_Camera Jump

getGravity(), setGravity(gravity) → number

카메라 중력을 설정 및 반환합니다.

Name

Type

Description

gravity

number

카메라 중력

Sample
- Sandbox_Camera Jump

getTimeStep(), setTimeStep(timeStep) → number

카메라 점프/낙하 동작의 시간 간격을 설정 및 반환합니다.

Name

Type

Description

timeStep

number

점프/낙하 시간 간격

Description
- 한 프레임 당 점프/낙하 동작의 간격을 설정합니다.
- timeStep이 작을 수록 구간을 더 촘촘하게 잘라 점프/낙하 속도가 느려집니다.
Sample
- Sandbox_Camera Jump

setLandingElevation(elevation) → void

플레이어 모드에서 카메라의 착지 고도를 설정합니다.

Name

Type

Description

elevation

number

카메라의 착지 고도

Description
- 카메라가 플레이어 모드인 경우에만 실행됩니다.
- 점프/낙하 시 카메라는 설정한 고도에 착지합니다.
Sample
- Sandbox_View Mode

setLandingElevationToTerrain() → void

플레이어 모드에서 카메라의 착지 고도를 현재 지형 고도로 설정합니다.

Description
- 카메라가 플레이어 모드인 경우에만 실행됩니다.
- 점프/낙하 시 카메라는 설정한 시점의 지형 고도에 착지합니다.
Sample
- Sandbox_View Mode

setUnionMode(mode) → void

1인칭 카메라 모드에서 지형 결합을 실행합니다.

Name

Type

Description

mode

boolean

카메라 지형 결합 true: 실행 false: 해제

Description
- 카메라가 1인칭 모드인 경우에만 실행됩니다.
Sample
- Sandbox_View Mode

setAutoMovePath(pathList) → boolean

카메라 자동 이동 경로를 설정합니다.

Name

Type

Description

pathList

Array

이동 경로를 구성하는 지점 목록입니다. 각 요소는 { position, direction, tilt } 객체로 구성됩니다.

Description
- 최소 2개 이상의 경로 지점을 포함해야 합니다.
- 각 경로 지점에는 position(JSVector3D), direction(number), tilt(number)가 포함됩니다.
- 입력값이 유효하지 않으면 경로는 등록되지 않습니다.

var API = {
    JSCamera : Module.getViewCamera();
};

var pathList = [
    { position: new Module.JSVector3D(129.128265, 35.171834, 500), direction: 0.0, tilt: 80.0 },
    { position: new Module.JSVector3D(129.128500, 35.172000, 500), direction: 20.0, tilt: 85.0 }
];

API.JSCamera.setAutoMovePath(pathList);

setLockOrientationAutoMove(type) → void

카메라 방향/틸트 고정 여부를 설정합니다.

Name

Type

Description

type

boolean

카메라 방향/틸트 고정 여부 설정 (true: 고정, false: 고정 해제)

Description
- 카메라 방향과 틸트의 고정 여부를 설정합니다.
- 기본값은 true 입니다.

clearAutoMovePosition() → boolean

설정된 카메라 자동 이동 좌표 목록을 삭제합니다.

Return
- true : 삭제 성공.
- false : 삭제 실패.

AltitudeUp()

카메라의 고도를 높입니다. 내부적으로는 현재 시점을 기준으로 일정한 틸트, 방향값을 유지하면서, 고도를 증가시켜 새로운 위치로 카메라를 이동시킵니다.

항목

설명

클래스

JSCamera

반환값

없음

파라미터

없음

설명

현재 카메라의 위치에서 고도를 증가시킨 위치로 카메라를 이동시킵니다. 시점(lookAt)은 그대로 유지하며, 틸트와 방향(heading)도 유지됩니다. 고도 증가는 내부 정의된 일정한 거리만큼 수행됩니다.

moveLookAt(lookAt, tilt, direct, distance) → void

특정 지점을 기준으로 카메라를 이동시킵니다.

Name

Type

Description

lookAt

JSVector3D

카메라가 바라볼 대상의 위치. 위도(Y), 경도(X), 고도(Z) 값으로 구성됩니다.

tilt

number

카메라의 상하 기울기 각도 (단위: 도, degree)

direct

number

카메라의 방위각, 즉 수평 방향 (단위: 도, degree)

distance

number

lookAt 지점으로부터 카메라까지의 거리 (단위: meter)

Return
- 없음 (void)
Description
- 지정한 위치를 중심으로, 입력받은 틸트와 방향, 거리 값을 기반으로 카메라의 시점을 설정합니다.
- 내부적으로 구면 좌표계를 사용하여 카메라 위치를 계산하고, SetCamera() 및 SetHeading()을 호출하여 반영합니다.

var API = {
    JSCamera : Module.getViewCamera()
};

var lookAt = new Module.JSVector3D();
lookAt.X = 126.9780; // 경도
lookAt.Y = 37.5665;  // 위도
lookAt.Z = 300.0;    // 고도 (meter)

API.JSCamera.moveLookAt(lookAt, 45.0, 90.0, 1000.0);

setViewAt(longitude, latitude, altitude, tilt, direct) → void

특정 지점을 바라보도록 카메라를 설정합니다.
입력 변수값(altitude, tilt, heading)을 적용하여 카메라를 설정합니다.

Name

Type

Description

longitude

number

카메라가 바라볼 위치의 경도 좌표 (degrees 단위).

latitude

number

카메라가 바라볼 위치의 위도 좌표 (degrees 단위)

altitude

number

카메라 위치 고도 좌표 (meter 단위).

tilt

number

카메라의 상하 기울기 각도 (단위: 도, degree).

direct

number

카메라의 방위각, 즉 수평 방향 (단위: 도, degree)

Return
- 없음 (void)
Description
- 지정한 위치를 중심으로, 입력받은 고도값과 틸트, 방향을 기반으로 카메라의 시점을 설정합니다.
- 바라보는 지점의 고도는 0이며, SetCamera() 및 SetHeading()을 호출하여 반영합니다.

setViewMode(vMode) → void

카메라의 뷰 모드를 설정합니다.

Name

Type

Description

vMode

int

뷰 모드 타입. 정수값으로 지정되며, 엔진 내부에서 정의된 시점 모드로 전환됩니다.

Return
- 없음 (void)
Description
- 카메라의 뷰 모드를 설정합니다.
- vMode는 엔진 내부에 정의된 값으로, 예를 들어 기본 뷰, 3인칭 추적 뷰, 탑다운 뷰 등으로 전환될 수 있습니다.
- 설정 후 UpdateFrame()을 호출하여 프레임 갱신을 즉시 반영합니다.

Type Definitions

JSCamera.MoveBoundaryOption

Options for moving the camera based on area information.

Name

Type

Description

boundary

Rect2D

카메라 이동 경계 박스.

complete

function

이동 완료 콜백 함수.

PreviousCamera NextLayer

Last updated 3 months ago

hashtagProperties

hashtagFunction

hashtagAltitudeDown()

hashtagAltitudeUp()

hashtagAngleDown()

hashtagAngleUp()

hashtagFOVDecrease()

hashtagFOVIncrease()

hashtaggetMapZoomLevel() → number

hashtaggetMapScale() → number

hashtagsetLookAt(f_altitude, f_longitude, f_latitude, t_altitude, t_longitude, t_latitude) → boolean

hashtaglook(from, to) → boolean

hashtaggetLookPosition(distance) → JSVector3D

hashtagsetSmoothMove(type) → void

hashtagMapRender()

hashtagmove(position, tilt, direct, speed)

hashtagmoveDist(location, tilt, direct, dist, speed)

hashtagMoveDown()

hashtagMoveLeft()

hashtagmoveLonLat(longitude, latitude)

hashtagmoveLonLatAlt(x, y, z, type)

hashtagmoveLonLatAltOval(longitude, latitude, altitude, speed)

hashtagmoveLonLatBoundary(min, max) → boolean

hashtagmoveLonLatBoundarybyJson(option) → string

hashtagmoveLonLatOval(longitude, latitude, speed)

hashtagmoveOval(position, tilt, direct, speed)

hashtagmoveOvalDist(location, tilt, Direct, speed)

hashtagMoveRight()

hashtagMoveUp()

hashtagpauseAutoMove(pause) → boolean

hashtagreset()

hashtagrotateLeft()

hashtagrotateRight()

hashtaggetDistance(), setDistance(Dist) → number

hashtagsetAutoMovePosition(coordinates) → boolean

hashtaginsertAutoMovePosition(coordinates, direct, tilt) → boolean

hashtagsetAutoMoveWaitFrame(speed) → boolean

hashtagSetAutoMoveIntrerval(interval) → boolean

hashtagsetAutoMoveRoundPositions(center, distance, altitude, startAngle, endAngle, type) → boolean

hashtagSetCameraShakeEffect(type) → boolean

hashtagSetCameraShakeStrength(value) → boolean

hashtagsetPermitUnderGround(type)

hashtagstartAutoMove() → boolean

hashtagstopAutoMove() → boolean

hashtagviewNorth()

hashtagZoomIn()

hashtagZoomOut()

hashtagZoom(screenX, screenY, distance)

hashtagsetVideoInfo(option) → string

hashtagclearVideo() → boolean

hashtagGetter / Setter

hashtaggetAnimationSpeed(), setAnimationSpeed(speed) → number

hashtaggetDirect(), setDirect(direct) → number

hashtaggetAltitude(), setAltitude(alt) → number

hashtaggetFov(), setFov(fov) → number

hashtaggetCenterPoint() → JSVector3D

hashtaggetLocation() → JSVector3D

hashtaggetTargetLocation() → JSVector3D

hashtagsetLocation(position) → boolean

hashtaggetMoveMode(), setMoveMode(type) → boolean

hashtagsetLimitCamera(type)

hashtagsetLimitRectAlt(minX, minY, maxX, maxY, altitude)

hashtaggetLimitAltitude(), setLimitAltitude(alt) → number

hashtaggetLimitTilt(), setLimitTilt(tilt) → number

hashtaggetLimitminTilt(), setLimitminTilt(tilt) → number

hashtaggetLimitmaxTilt(), setLimitmaxTilt(tilt) → number

hashtaggetTilt(), setTilt(tilt) → number

hashtagmoveFrontBack(delta)

hashtagmoveLeftRight(delta)

hashtagmoveFront()

hashtagmoveBack()

hashtagmoveLeft()

hashtagmoveRight()

hashtagrotateUp()

hashtagrotateDown()

hashtagmoveUp()

hashtagmoveDown()

hashtaggetCameraSpeed(), setCameraSpeed(speed) → number

hashtagsetTraceTarget(target) → boolean

hashtagsetTraceActive(active) → boolean

Properties

Function

AltitudeDown()

AltitudeUp()

AngleDown()

AngleUp()

FOVDecrease()

FOVIncrease()

getMapZoomLevel() → number

getMapScale() → number

setLookAt(f_altitude, f_longitude, f_latitude, t_altitude, t_longitude, t_latitude) → boolean

look(from, to) → boolean

getLookPosition(distance) → JSVector3D

setSmoothMove(type) → void

MapRender()

move(position, tilt, direct, speed)

moveDist(location, tilt, direct, dist, speed)

MoveDown()

MoveLeft()

moveLonLat(longitude, latitude)

moveLonLatAlt(x, y, z, type)

moveLonLatAltOval(longitude, latitude, altitude, speed)

moveLonLatBoundary(min, max) → boolean

moveLonLatBoundarybyJson(option) → string

moveLonLatOval(longitude, latitude, speed)

moveOval(position, tilt, direct, speed)

moveOvalDist(location, tilt, Direct, speed)

MoveRight()

MoveUp()

pauseAutoMove(pause) → boolean

reset()

rotateLeft()

rotateRight()

getDistance(), setDistance(Dist) → number

setAutoMovePosition(coordinates) → boolean

insertAutoMovePosition(coordinates, direct, tilt) → boolean

setAutoMoveWaitFrame(speed) → boolean

SetAutoMoveIntrerval(interval) → boolean

setAutoMoveRoundPositions(center, distance, altitude, startAngle, endAngle, type) → boolean

SetCameraShakeEffect(type) → boolean

SetCameraShakeStrength(value) → boolean

setPermitUnderGround(type)

startAutoMove() → boolean

stopAutoMove() → boolean

viewNorth()

ZoomIn()

ZoomOut()

Zoom(screenX, screenY, distance)

setVideoInfo(option) → string

clearVideo() → boolean

Getter / Setter

getAnimationSpeed(), setAnimationSpeed(speed) → number

getDirect(), setDirect(direct) → number

getAltitude(), setAltitude(alt) → number

getFov(), setFov(fov) → number

getCenterPoint() → JSVector3D

getLocation() → JSVector3D

getTargetLocation() → JSVector3D

setLocation(position) → boolean

getMoveMode(), setMoveMode(type) → boolean

setLimitCamera(type)

setLimitRectAlt(minX, minY, maxX, maxY, altitude)

getLimitAltitude(), setLimitAltitude(alt) → number

getLimitTilt(), setLimitTilt(tilt) → number

getLimitminTilt(), setLimitminTilt(tilt) → number

getLimitmaxTilt(), setLimitmaxTilt(tilt) → number

getTilt(), setTilt(tilt) → number

moveFrontBack(delta)

moveLeftRight(delta)

moveFront()

moveBack()

moveLeft()

moveRight()

rotateUp()

rotateDown()

moveUp()

moveDown()

getCameraSpeed(), setCameraSpeed(speed) → number

setTraceTarget(target) → boolean

setTraceActive(active) → boolean