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

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

Information

Template

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

AltitudeUp()

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

Information

Template

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

AngleDown()

카메라의 기울기 각도를 낮춥니다.

회전을 지원하지 않는 평면 모드에서는 작동하지 않습니다.

Information

Template

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

AngleUp()

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

Information

Template

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

FOVDecrease()

카메라의 FOV를 줄입니다.

Information

Template

Module.getViewCamera().FOVDecrease();

FOVIncrease()

카메라의 FOV를 높입니다.

Information

Template

Module.getViewCamera().FOVIncrease();

getMapZoomLevel() -> number

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

Information

• Return

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

Template

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

look(from, to) → boolean

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

Information

Name	Type	Description
from	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).
to	JSVector3D	카메라가 보고 있는 위치 좌표(경도, 위도, 고도).

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function init 참조.

  • Sandbox_Circular Path Movement

Template

Module.getViewCamera().look(new Module.JSVector3D(129.128265, 35.171834, 500.0), new Module.JSVector3D(129.128265, 35.161834, 10.0));

MapRender()

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

Information

Template

Module.getViewCamera().MapRender();

move(position, tilt, direct, speed)

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

Information

Name	Type	Description
position	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).
tilt	number	카메라 기울기.
direct	number	카메라 좌우 회전.
speed	number	카메라 이동 속도 (1.0 ~ 10.0).

• Sample

  • function init 참조.

  • Sandbox_Position Movement

Template

Module.getViewCamera().move(new Module.JSVector3D(129.128265, 35.171834, 500.0), 70, 0, 0);

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

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

Information

Name	Type	Description
location	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).
tilt	number	카메라 기울기.
direct	number	카메라 좌우 회전.
dist	number	(현재 미적용).
speed	number	카메라 이동속도 (기본 1).

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var vTargetPos = new Module.JSVector3D(longitude, latitude, altitude);
API.JSCamera.moveDist(vTargetPos, 45.0, 90.0, 1, 0.0);

MoveDown()

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

Information

Template

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

MoveLeft()

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

Information

Template

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

moveLonLat(longitude, latitude)

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

Information

Name	Type	Description
longitude	number	카메라 위치 경도 좌표 (degrees 단위).
latitude	number	카메라 위치 위도 좌표 (degrees 단위).

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLat(127.0273188, 37.4977981);

moveLonLatAlt(x, y, z, type)

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

Information

Name	Type	Description
x	number	카메라 위치 경도 좌표 (degrees 단위).
y	number	카메라 위치 위도 좌표 (degrees 단위).
z	number	카메라 위치 고도 좌표 (meter 단위).
type	boolean	카메라 이동 애니메이션 적용 유무.

• Sample

  • function init 참조.

  • Sandbox_Path Movement

Template

var height = Module.getMap().getTerrHeight(126.92836647767662, 37.52439503321471);

moveLonLatAltOval(longitude, latitude, altitude, speed)

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

Information

Name	Type	Description
longitude	number	카메라 위치 경도 좌표 (degrees 단위).
latitude	number	카메라 위치 위도 좌표 (degrees 단위).
altitude	number	카메라 위치 고도 좌표 (meter 단위).
speed	number	카메라 이동속도 (기본 1).

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLatAltOval(127.0273188, 37.4977981, 500.0, 1);

moveLonLatBoundarybyJson(option) → string

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

Information

Name	Type	Description
option	JSCamera.MoveBoundaryOption	속성 정보.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

  • 실패 조건

    • JSCamera.MoveBoundaryOption 구성 태그가 누락된 경우.
• Sample

  • function moveTestArea 참조.

  • Sandbox_Camera Area Setting

Template

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)

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

Information

Name	Type	Description
longitude	number	카메라 위치 경도 좌표 (degrees 단위).
latitude	number	카메라 위치 위도 좌표 (degrees 단위).
speed	number	카메라 이동속도 (기본 1).

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLatOval(127.0273188, 37.4977981, 1);

moveOval(position, tilt, direct, speed)

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

Information

Name	Type	Description
position	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).
tilt	number	카메라 기울기.
direct	number	카메라 좌우 회전.
speed	number	카메라 이동 속도 (1.0 ~ 10.0).

• Sample

  • function initPage 참조.

  • Sandbox_Landscape View

Template

Module.getViewCamera().moveOval(new Module.JSVector3D(129.128265, 35.171834, 500.0), 70, 0, 1);

moveOvalDist(location, tilt, Direct, speed)

카메라를 지정된 위치(경도, 위도, 고도)로 부터 기울기 방향을 기준으로 거리를 적용한 좌표를 설정한다.

카메라 이동시 확대/축소 애니메이션 효과 설정한다.

Information

Name	Type	Description
location	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).
tilt	number	카메라 기울기.
direct	number	카메라 좌우 회전.
speed	number	카메라 이동 속도 (1.0 ~ 10.0).

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var vTargetPos = new Module.JSVector3D(longitude, latitude, altitude);
API.JSCamera.moveOvalDist(vTargetPos, 45.0, 90.0, 0.0, 1);

MoveRight()

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

Information

Template

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

MoveUp()

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

Information

Template

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

pauseAutoMove(pause) -> boolean

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

Information

Name	Type	Description
pause	boolean	자동 이동 설정. true: 멈춤. false: 시작.

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function pauseCameraAutoMove 참조.

  • Sandbox_Path Movement

Template

Module.getViewCamera().pauseAutoMove(true);

reset()

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

Information

Template

Module.getViewCamera().reset();

rotateLeft()

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

Information

Template

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

rotateRight()

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

Information

Template

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

setDistance(Dist)

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

Information

Name	Type	Description
Dist	number	카메라 시야 거리 (meters 단위).

Template

Module.getViewCamera().setDistance(500.0);

setAltitude(alt)

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

Information

Name	Type	Description
alt	number	카메라 위치 고도 좌표 (meter 단위).

• Sample

  • function setAltitude 참조.

  • Sandbox_Camera Setting

Template

Module.getViewCamera().setAltitude(1000);

setAutoMovePosition(coordinates) → boolean

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

Information

Name	Type	Description
coordinates	JSVec3Array	자동 이동 경로의 좌표 목록.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function setAutoMovePosition 참조.

  • Sandbox_Path Movement

Template

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

setAutoMoveWaitFrame(speed) → boolean

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

Information

Name	Type	Description
speed	number	카메라 이동 애니메이션 발생 프레임 수.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function setAutoMovePosition 참조.

  • Sandbox_Path Movement

Template

Module.getViewCamera().setAutoMoveWaitFrame(3);

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

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

Information

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

Template

Module.getViewCamera().setAutoMoveRoundPositions(new Module.JSVector3D(129.12732457984308, 35.171000072302796, 4.0), 400.0, 350.0, -130.0, -160.0, true);

SetCameraShakeEffect(type) → boolean

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

Information

Name	Type	Description
type	boolean	카메라 흔들링 유무 설정.

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function ShakeCamera 참조.

  • Sandbox_Camera Shake

Template

Module.getViewCamera().SetCameraShakeEffect(true);

SetCameraShakeStrength(value) → boolean

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

Information

Name	Type	Description
value	number	카메라 흔들링 강도 (1 ~ 100).

• Return

  • true : 설정 성공.

  • false : 설정 실패.

• Sample

  • function SetShakeEffectStrength 참조.

  • Sandbox_Camera Shake

Template

Module.getViewCamera().SetCameraShakeStrength(50);

setPermitUnderGround(type)

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

Information

Name	Type	Description
type	boolean	지하 이동 true: 이동 가능. false: 이동 금지.

Template

Module.getViewCamera().setPermitUnderGround(true);

startAutoMove() → boolean

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

Information

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function startCameraAutoMove 참조.

  • Sandbox_Path Movement

Template

Module.getViewCamera().startAutoMove();

stopAutoMove() → boolean

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

Information

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function stopCameraAutoMove 참조.

  • Sandbox_Path Movement

Template

Module.getViewCamera().stopAutoMove();

viewNorth()

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

Information

Template

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

ZoomIn()

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

Information

Template

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

ZoomOut()

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

Information

Template

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

getLocation() -> JSVector3D

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

Information

• Return

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

Template

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

setLocation(position) → boolean

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

Information

Name	Type	Description
position	JSVector3D	카메라 위치 좌표 (경도, 위도, 고도).

• Return

  • true: 설정 성공.

  • false: 설정 실패.

• Sample

  • function setMove 참조.

  • Sandbox_Camera Setting

Template

Module.getViewCamera().setLocation(new Module.JSVector3D(129.128265, 35.171834, 500.0));

setVideoInfo(option) -> string

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

Information

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

Template

clearVideo() -> boolean

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

Information

• Return

  • true : 초기화 성공.

  • false : 초기화 실패.

  • 실패 조건

    • 비디오 텍스쳐가 없을 경우.

    • 비디오 데이터가 없을 경우.

    • 비디오 경로가 없을 경우.

• Sample

  • See function setTilt.

  • Sandbox_Video Texture

Template

Getter / Setter

getAnimationSpeed(), setAnimationSpeed(speed) -> number

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

Information

Name	Type	Description
speed	number	카메라 이동 속도 (1.0 ~ 10.0).

• Return

  • number: 카메라 이동 애니메이션 적용 속도.

• Sample

  • function setEvent 참조.

  • Sandbox_Path Movement

Template

var speed = Module.getViewCamera().getAnimationSpeed();
Module.getViewCamera().setAnimationSpeed(5);

getDirect(), setDirect(direct) -> number

카메라의 현재 방향 각도를 설정 및 반환합니다.

방향각도 값의 범위는 -180도 ~ 180도 사이 입니다.

• 0도: 북쪽

• +90도: 동쪽

• 180도 or -180도: 남쪽

• -90도: 서쪽

Information

Name	Type	Description
direct	number	카메라 좌우 회전.

• Return

  • number: 카메라 좌우 회전값 반환 (degree 단위).

• Sample

  • function setDirect 참조.

  • Sandbox_Camera Setting

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var direct= API.JSCamera.getDirect();
Module.getViewCamera().setDirect(0);

getFov(), setFov(fov) -> number

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

Information

Name	Type	Description
fov	JSVector2D	카메라 화각.

• Return

  • number: 카메라 시야 화각 반환 (degree 단위).

• Sample

  • function setFOV 참조.

  • Sandbox_Camera Setting

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var FOV= API.JSCamera.getFOV();
Module.getViewCamera().setFov(50);

getMoveMode(), setMoveMode(type) -> boolean

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

Information

Name	Type	Description
type	boolean	카메라 회전 모드.

• Return

  • 카메라 모드 반환.

    • true: 1인칭 시점 회전 모드.

    • false: 3인칭 시점 회전 모드.

• Sample

  • function setPerson 참조.

  • Sandbox_Camera Setting

Template

Module.getViewCamera().getMoveMode();
Module.getViewCamera().setMoveMode(true);

getLimitAltitude(), setLimitAltitude(alt) -> number

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

Information

Name	Type	Description
alt	number	카메라 제한 고도값 (meters 단위).

• Return

  • number: 카메라 제한 고도값 반환 (meter 단위).

• Sample

  • function initPage 참조.

  • Sandbox_Path Movement

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var limitAltitude = API.JSCamera.getLimitAltitude();
Module.getViewCamera().setLimitAltitude(3000);

getLimitTilt(), setLimitTilt(tilt) -> number

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

Information

Name	Type	Description
tilt	number	카메라 제한 기울기 각도 (degree 단위).

• Return

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

• Sample

  • function initPage 참조.

  • Sandbox_Camera Path Movement

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var limitTilt = API.JSCamera.getLimitTilt();
Module.getViewCamera().setLimitTilt(80);

getTilt(), setTilt(tilt) -> number

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

Information

Name	Type	Description
tilt	number	카메라 기울기 각도 (degree 단위).

• Return

  • number: 카메라 기울기 각도를 반환합니다 (degree 단위).

• Sample

  • See function setTilt.

  • Sandbox_Camera Setting

Template

var API = {
    JSCamera : Module.getViewCamera();
};
var currentTilt = API.JSCamera.getTilt();
Module.getViewCamera().setTilt(80);

moveFrontBack(delta)

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

Information

Name	Type	Description
delta	number	이동 거리. 양수면 앞으로, 음수면 뒤로 이동.

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.moveFrontBack(10.0); // 앞으로 10 이동
API.JSCamera.moveFrontBack(-5.0); // 뒤로 5 이동

moveLeftRight(delta)

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

Information

Name	Type	Description
delta	number	이동 거리. 양수면 오른쪽, 음수면 왼쪽으로 이동.

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLeftRight(10.0); // 오른쪽으로 이동
API.JSCamera.moveLeftRight(-10.0); // 왼쪽으로 이동

moveFront()

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

Information

• Description

  • 기본 이동 거리(delta)는 내부 설정값(getMoveDelta)을 따릅니다.

  • FPS 모드 활성화 시, 이동 후 지형 높이에 맞춰 카메라 고도가 자동 보정됩니다.

Template

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

moveBack()

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

Information

• Description

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

Template

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

moveLeft()

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

Information

• Description

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

Template

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

moveRight()

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

Information

• Description

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

Template

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

rotateUp()

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

Information

• Description

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

Template

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

rotateDown()

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

Information

• Description

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

Template

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

moveUp()

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

Information

• Description

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

Template

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

moveDown()

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

Information

• Description

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

Template

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

setTraceTarget(target) → boolean

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

Information

Name	Type	Description
target	JSTraceTarget	추적 대상 객체입니다.

• Return

  • true: 추적 대상 설정 성공

  • false: 대상이 유효하지 않거나 설정 실패

• Description

  • 지정된 객체를 카메라가 지속적으로 따라가도록 설정합니다.

Template

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

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

Information

Name	Type	Description
active	boolean	true: 추적 활성화, false: 비활성화

• Return

  • true: 설정 성공

  • false: 설정 실패 (내부 엔진 미정의 상태 등)

• Description

  • setTraceTarget()으로 설정한 대상에 대해 추적을 켜거나 끌 수 있습니다.

Template

var API = {
    JSCamera : Module.getViewCamera();
};
API.JSCamera.setTraceActive(true);  // 추적 시작
API.JSCamera.setTraceActive(false); // 추적 중단

bankLeft()

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

Information

• Description

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

Template

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

bankRight()

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

Information

• Description

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

Template

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

setAutoMovePath(pathList) → boolean

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

Information

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

• Description

  • 최소 2개 이상의 경로 지점을 포함해야 합니다.

  • 각 경로 지점에는 position(JSVector3D), direction(number), tilt(number)가 포함됩니다.

  • 입력값이 유효하지 않으면 경로는 등록되지 않습니다.

Template

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

AltitudeUp()

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

Information

항목	설명
클래스	JSCamera
반환값	없음
파라미터	없음
설명	현재 카메라의 위치에서 고도를 증가시킨 위치로 카메라를 이동시킵니다. 시점(lookAt)은 그대로 유지하며, 틸트와 방향(heading)도 유지됩니다. 고도 증가는 내부 정의된 일정한 거리만큼 수행됩니다.
관련 API	moveLookAt, SetCamera, SetHeading

Template

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

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

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

Information

Name	Type	Description
lookAt	JSVector3D	카메라가 바라볼 대상의 위치. 위도(Y), 경도(X), 고도(Z) 값으로 구성됩니다.
tilt	number	카메라의 상하 기울기 각도 (단위: 도, degree)
direct	number	카메라의 방위각, 즉 수평 방향 (단위: 도, degree)
distance	number	lookAt 지점으로부터 카메라까지의 거리 (단위: meter)

• Return

  • 없음 (void)

• Description

  • 지정한 위치를 중심으로, 입력받은 틸트와 방향, 거리 값을 기반으로 카메라의 시점을 설정합니다.

  • 내부적으로 구면 좌표계를 사용하여 카메라 위치를 계산하고, SetCamera() 및 SetHeading()을 호출하여 반영합니다.

Template

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

setViewMode(vMode) → void

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

Information

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

• Return

  • 없음 (void)

• Description

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

  • vMode는 엔진 내부에 정의된 값으로, 예를 들어 기본 뷰, 3인칭 추적 뷰, 탑다운 뷰 등으로 전환될 수 있습니다.

  • 설정 후 UpdateFrame()을 호출하여 프레임 갱신을 즉시 반영합니다.

Template

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

// 예: 0 = 기본 뷰, 1 = 3인칭 뷰 등 (정의는 엔진에 따라 다름)
API.JSCamera.setViewMode(1);

Type Definitions

JSCamera.MoveBoundaryOption

Options for moving the camera based on area information.

Name	Type	Description
boundary	Rect2D	카메라 이동 경계 박스.
complete	function	이동 완료 콜백 함수.