JSCamera
지도 카메라 설정을 위한 API입니다.
Module.getViewCamera API를 생성합니다.
var camera = Module.getViewCamera();Properties
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()
카메라의 고도를 낮춥니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.AltitudeDown();AltitudeUp()
카메라의 고도를 높입니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.AltitudeUp();AngleDown()
카메라의 기울기 각도를 낮춥니다.
회전을 지원하지 않는 평면 모드에서는 작동하지 않습니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.AngleDown();AngleUp()
카메라의 기울기 각도를 높입니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.AngleUp();FOVDecrease()
카메라의 FOV를 줄입니다.
Module.getViewCamera().FOVDecrease();FOVIncrease()
카메라의 FOV를 높입니다.
Module.getViewCamera().FOVIncrease();getMapZoomLevel() → number
카메라 고도에서 가시화 된 지형 정밀 레벨 정보를 반환합니다.
Return
number: 현재 가시화 지형 레벨.
var API = {
JSCamera : Module.getViewCamera();
};
var ZoomLevel= API.JSCamera.getMapZoomLevel();look(from, to) → boolean
두 점을 사용하여 카메라를 이동합니다.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function init 참조.
Module.getViewCamera().look(new Module.JSVector3D(129.128265, 35.171834, 500.0), new Module.JSVector3D(129.128265, 35.161834, 10.0));MapRender()
3D 지도 화면을 갱신합니다.
Module.getViewCamera().MapRender();move(position, tilt, direct, speed)
카메라를 지정된 위치, 기울기, 방향을 설정합니다.
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
Sample
function init 참조.
Module.getViewCamera().move(new Module.JSVector3D(129.128265, 35.171834, 500.0), 70, 0, 0);moveDist(location, tilt, direct, dist, speed)
카메라를 지정된 위치, 기울기, 방향, 거리, 속도를 설정합니다.
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
dist
number
(현재 미적용).
speed
number
카메라 이동속도 (기본 1).
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()
카메라를 현재 위치에서 뒤로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveDown();MoveLeft()
카메라를 현재 위치에서 왼쪽으로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLeft();moveLonLat(longitude, latitude)
카메라를 지정된 위치(경도, 위도)를 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLat(127.0273188, 37.4977981);moveLonLatAlt(x, y, z, type)
카메라를 지정된 위치(경도, 위도, 고도)를 설정합니다.
x
number
카메라 위치 경도 좌표 (degrees 단위).
y
number
카메라 위치 위도 좌표 (degrees 단위).
z
number
카메라 위치 고도 좌표 (meter 단위).
type
boolean
카메라 이동 애니메이션 적용 유무.
Sample
function init 참조.
var height = Module.getMap().getTerrHeight(126.92836647767662, 37.52439503321471);moveLonLatAltOval(longitude, latitude, altitude, speed)
카메라를 지정된 위치(경도, 위도, 고도) 이동 시 확대/축소 애니메이션을 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
altitude
number
카메라 위치 고도 좌표 (meter 단위).
speed
number
카메라 이동속도 (기본 1).
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLatAltOval(127.0273188, 37.4977981, 500.0, 1);moveLonLatBoundary(min, max) → boolean
최소 좌표점, 최대 좌표점을 이용한 카메라 이동 및 완료 이벤트를 설정합니다.
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
최소 좌표점, 최대 좌표점을 이용한 카메라 이동 및 완료 이벤트를 설정합니다.
Return
true : 설정 성공.
false : 설정 실패.
실패 조건
JSCamera.MoveBoundaryOption 구성 태그가 누락된 경우.
Sample
function moveTestArea 참조.
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)
카메라를 지정된 위치(경도, 위도) 이동 시 애니메이션 효과를 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
speed
number
카메라 이동속도 (기본 1).
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLonLatOval(127.0273188, 37.4977981, 1);moveOval(position, tilt, direct, speed)
카메라를 지정된 위치(경도, 위도, 고도) 이동 시 애니메이션 효과를 설정합니다.
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
Sample
function initPage 참조.
Module.getViewCamera().moveOval(new Module.JSVector3D(129.128265, 35.171834, 500.0), 70, 0, 1);moveOvalDist(location, tilt, Direct, speed)
카메라를 지정된 위치(경도, 위도, 고도)로 부터 기울기 방향을 기준으로 거리를 적용한 좌표를 설정한다.
카메라 이동시 확대/축소 애니메이션 효과 설정한다.
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
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()
카메라를 현재 위치에서 오른쪽으로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveRight();MoveUp()
카메라를 현재 위치에서 앞으로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveUp();pauseAutoMove(pause) → boolean
카메라 자동 이동 시 일시 중지를 설정합니다.
pause
boolean
자동 이동 설정. true: 멈춤. false: 시작.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function pauseCameraAutoMove 참조.
Module.getViewCamera().pauseAutoMove(true);reset()
카메라의 속성 정보를 초기화 상태로 설정합니다.
Module.getViewCamera().reset();rotateLeft()
카메라를 현재 왼쪽으로 회전합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.rotateLeft();rotateRight()
카메라를 현재 오른쪽으로 회전합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.rotateRight();getDistance(), setDistance(Dist) → number
카메라 시점, 위치 간의 거리를 설정 및 반환합니다.
Dist
number
카메라 시야 거리 (meters 단위).
var dist = Module.getViewCamera().getDistance();
Module.getViewCamera().setDistance(500.0);setAutoMovePosition(coordinates) → boolean
카메라의 자동 이동 좌표 목록을 설정합니다.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
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
카메라의 자동 이동 중 카메라의 이동 간격 발생 프레임을을 설정합니다.
speed
number
카메라 이동 애니메이션 발생 프레임 수.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
Module.getViewCamera().setAutoMoveWaitFrame(3);setAutoMoveRoundPositions(center, distance, altitude, startAngle, endAngle, type) → boolean
카메라의 원형 이동 경로를 설정합니다.
distance
number
카메라 회전 반지름 거리 (meter 단위).
altitude
number
카메라 위치 고도 좌표 (meter 단위).
startAngle
number
카메라 초기 시야 방향
endAngle
number
카메라 종료 시야 방향
type
boolean
카메라 이동 방향 설정 (true: 반시계 방향, false: 시계 방향)
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
Module.getViewCamera().setAutoMoveRoundPositions(new Module.JSVector3D(129.12732457984308, 35.171000072302796, 4.0), 400.0, 350.0, -130.0, -160.0, true);SetCameraShakeEffect(type) → boolean
카메라 흔들림 효과를 설정합니다.
type
boolean
카메라 흔들링 유무 설정.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function ShakeCamera 참조.
Module.getViewCamera().SetCameraShakeEffect(true);SetCameraShakeStrength(value) → boolean
카메라 흔들림 강도를 설정합니다.
value
number
카메라 흔들링 강도 (1 ~ 100).
Return
true : 설정 성공.
false : 설정 실패.
Sample
function SetShakeEffectStrength 참조.
Module.getViewCamera().SetCameraShakeStrength(50);setPermitUnderGround(type)
지하에서 카메라 이동 유무를 설정합니다.
type
boolean
지하 이동 true: 이동 가능. false: 이동 금지.
Module.getViewCamera().setPermitUnderGround(true);startAutoMove() → boolean
카메라 자동 이동을 시작합니다.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function startCameraAutoMove 참조.
Module.getViewCamera().startAutoMove();stopAutoMove() → boolean
카메라 자동 이동을 종료합니다.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function stopCameraAutoMove 참조.
Module.getViewCamera().stopAutoMove();viewNorth()
카메라가 정복 방향을 바라보도록 회전 합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.viewNorth();ZoomIn()
화면 중심 위치를 기준으로 카메라 확대를 실행합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.ZoomIn();ZoomOut()
화면 중심 위치를 기준으로 카메라 축소를 실행합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.ZoomOut();Zoom(screenX, screenY, distance)
화면 특정 좌표를 기준으로 카메라 확대/축소를 실행합니다.
screenX
number
화면의 X 좌표(정수)
screenY
number
화면의 Y 좌표(정수)
distance
number
확대/축소 거리. 양수면 줌아웃, 음수면 줌인.
Return
true: 확대/축소 성공
false: 확대/축소 실패
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.Zoom(0, 0, 100.0); // Zoom Out
API.JSCamera.Zoom(0, 0, -100.0); // Zoom InsetVideoInfo(option) → string
비디오 텍스쳐를 생성합니다.
url
string
미디어 URL 경로.
dronemode
boolean
중심 좌표 (경도, 위도, 고도).
streaming
boolean
비디오 스트리밍 설정.
objectmapping
boolean
건물 매핑 설정.
alpha
number
비디오 투명값 설정.
zoom
number
비디오 배율 설정.
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 참조.
clearVideo() → boolean
비디오 텍스쳐를 초기화 합니다.
Return
true : 초기화 성공.
false : 초기화 실패.
실패 조건
비디오 텍스쳐가 없을 경우.
비디오 데이터가 없을 경우.
비디오 경로가 없을 경우.
Sample
See function setTilt.
Getter / Setter
getAnimationSpeed(), setAnimationSpeed(speed) → number
카메라 이동 애니메이션의 속도를 설정합니다.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
Return
number: 카메라 이동 애니메이션 적용 속도.
Sample
function setEvent 참조.
var speed = Module.getViewCamera().getAnimationSpeed();
Module.getViewCamera().setAnimationSpeed(5);getDirect(), setDirect(direct) → number
카메라의 현재 방향 각도를 설정 및 반환합니다.
방향각도 값의 범위는 -180도 ~ 180도 사이 입니다.
0도: 북쪽
+90도: 동쪽
180도 or -180도: 남쪽
-90도: 서쪽
direct
number
카메라 좌우 회전.
Return
number: 카메라 좌우 회전값 반환 (degree 단위).
Sample
function setDirect 참조.
var API = {
JSCamera : Module.getViewCamera();
};
var direct= API.JSCamera.getDirect();
Module.getViewCamera().setDirect(0);getAltitude(), setAltitude(alt) → number
카메라 고도를 설정 및 반환합니다.
alt
number
카메라 위치 고도 좌표 (meter 단위).
Return
number: 카메라 위치 고도 좌표 (meter 단위).
Sample
function setAltitude 참조.
var API = {
JSCamera : Module.getViewCamera();
};
var altitude = API.JSCamera.getAltitude();
Module.getViewCamera().setAltitude(1000);getFov(), setFov(fov) → number
카메라의 화각을 설정 및 반환 합니다.
Return
number: 카메라 시야 화각 반환 (degree 단위).
Sample
function setFOV 참조.
var API = {
JSCamera : Module.getViewCamera();
};
var FOV= API.JSCamera.getFOV();
Module.getViewCamera().setFov(50);getCenterPoint() → JSVector3D
화면 중심의 지도 좌표를 반환합니다.
Return
JSVector3D: 반환 성공
Module.getViewCamera().getCenterPoint();getLocation() → JSVector3D
카메라 위치 좌표를 반환합니다.
Return
JSVector3D: 카메라 위치 좌표 (경도, 위도, 고도)를 성공적으로 반환.
null: 카메라 위치 좌표 반환에 실패.
var API = {
JSCamera : Module.getViewCamera();
};
var location = API.JSCamera.getLocation();getTargetLocation() → JSVector3D
카메라 타겟 좌표를 반환합니다.
Return
JSVector3D: 카메라 타겟 좌표 (경도, 위도, 고도)를 반환.
카메라 이동 애니메이션이 적용된 상태에서 카메라의 최종 목적지 좌표를 반환.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
var targetLoc = API.JSCamera.getTargetLocation();setLocation(position) → boolean
카메라 위치 좌표를 설정합니다.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function setMove 참조.
Module.getViewCamera().setLocation(new Module.JSVector3D(129.128265, 35.171834, 500.0));getMoveMode(), setMoveMode(type) → boolean
1인칭, 3인칭 카메라 회전 모드를 설정 및 반환 합니다.
type
boolean
카메라 회전 모드.
Return
카메라 모드 반환.
true: 1인칭 시점 회전 모드.
false: 3인칭 시점 회전 모드.
Sample
function setPerson 참조.
Module.getViewCamera().getMoveMode();
Module.getViewCamera().setMoveMode(true);setLimitCamera(type)
카메라 이동 제한 여부를 설정합니다.
type
boolean
카메라 이동 제한 여부
Description
카메라 이동 경계 박스 제한과 고도 제한을 설정/해제 합니다.
true : 제한 설정
false : 제한 해제
Sample
Module.getViewCamera().setLimitCamera(true); // 설정
Module.getViewCamera().setLimitCamera(false); // 해제setLimitRectAlt(minX, minY, maxX, maxY, altitude)
카메라 이동 경계 박스를 설정합니다.
minX
number
경도의 최솟값
minY
number
위도의 최솟값
maxX
number
경도의 최댓값
maxY
number
위도의 최댓값
altitude
number
카메라 제한 고도값 (meters 단위)
Description
카메라 이동 경계 박스를 설정합니다.
Module.getViewCamera().setLimitRectAlt(126.920355, 37.520472, 126.930938, 37.529579, 1000);getLimitAltitude(), setLimitAltitude(alt) → number
카메라 제한 고도값을 설정 및 반환합니다.
alt
number
카메라 제한 고도값 (meters 단위).
Return
number: 카메라 제한 고도값 반환 (meter 단위).
Sample
function initPage 참조.
var API = {
JSCamera : Module.getViewCamera();
};
var limitAltitude = API.JSCamera.getLimitAltitude();
Module.getViewCamera().setLimitAltitude(3000);getLimitTilt(), setLimitTilt(tilt) → number
카메라 제한 기울기 각도를 설정 및 반환합니다.
tilt
number
카메라 제한 기울기 각도 (degree 단위).
Return
number: 카메라 제한 기울기 각도를 반환합니다 (degree 단위).
Sample
function initPage 참조.
var API = {
JSCamera : Module.getViewCamera();
};
var limitTilt = API.JSCamera.getLimitTilt();
Module.getViewCamera().setLimitTilt(80);getTilt(), setTilt(tilt) → number
카메라 기울기 각도를 설정 및 반환합니다.
tilt
number
카메라 기울기 각도 (degree 단위).
Return
number: 카메라 기울기 각도를 반환합니다 (degree 단위).
Sample
See function setTilt.
var API = {
JSCamera : Module.getViewCamera();
};
var currentTilt = API.JSCamera.getTilt();
Module.getViewCamera().setTilt(80);moveFrontBack(delta)
카메라를 현재 시점 방향 기준으로 앞 또는 뒤로 이동합니다.
delta
number
이동 거리. 양수면 앞으로, 음수면 뒤로 이동.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveFrontBack(10.0); // 앞으로 10 이동
API.JSCamera.moveFrontBack(-5.0); // 뒤로 5 이동moveLeftRight(delta)
카메라를 현재 시점 기준으로 좌우로 이동합니다.
delta
number
이동 거리. 양수면 오른쪽, 음수면 왼쪽으로 이동.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLeftRight(10.0); // 오른쪽으로 이동
API.JSCamera.moveLeftRight(-10.0); // 왼쪽으로 이동moveFront()
카메라를 현재 시점 방향으로 전진시킵니다. 1인칭(FPS) 모드일 경우 지형 고도에 따라 자동으로 고도를 조정합니다.
Description
기본 이동 거리(delta)는 내부 설정값(
getMoveDelta)을 따릅니다.FPS 모드 활성화 시, 이동 후 지형 높이에 맞춰 카메라 고도가 자동 보정됩니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveFront();moveBack()
카메라를 뒤로 이동합니다.
Description
카메라를 뒤로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveBack();moveLeft()
카메라를 현재 위치에서 왼쪽으로 이동합니다.
Description
카메라를 좌측 방향으로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveLeft();moveRight()
카메라를 현재 시점 기준으로 오른쪽으로 이동합니다.
Description
카메라를 오른쪽으로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveRight();rotateUp()
카메라를 위쪽으로 회전합니다.
Description
카메라의 X축 기준 기울기(틸트)를 감소시켜 위로 올립니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.rotateUp();rotateDown()
카메라를 아래쪽으로 회전합니다.
Description
카메라의 X축 기준 기울기(틸트)를 증가시켜 아래로 내립니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.rotateDown();moveUp()
카메라를 현재 위치에서 위로 이동합니다.
Description
카메라를 현재 위치에서 위로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveUp();moveDown()
카메라를 현재 위치에서 아래로 이동합니다.
Description
카메라를 시점 기준 아래로 이동합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.moveDown();getCameraSpeed(), setCameraSpeed(speed) → number
카메라의 이동 속도를 설정 및 반환합니다.
speed
number
카메라 이동 속도(정수)
var API = {
JSCamera : Module.getViewCamera();
};
var speed = API.JSCamera.getCameraSpeed();
Module.getViewCamera().setCameraSpeed(5);setTraceTarget(target) → boolean
카메라의 추적 대상을 설정합니다.
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
추적 대상의 추적 활성화 여부를 설정합니다.
active
boolean
true: 추적 활성화, false: 비활성화
Return
true: 설정 성공false: 설정 실패 (내부 엔진 미정의 상태 등)
Description
setTraceTarget()으로 설정한 대상에 대해 추적을 켜거나 끌 수 있습니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setTraceActive(true); // 추적 시작
API.JSCamera.setTraceActive(false); // 추적 중단bankLeft()
카메라를 왼쪽으로 기울입니다.
Description
카메라의 롤(Roll) 축을 따라 왼쪽으로 회전(기울기)합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.bankLeft();bankRight()
카메라를 오른쪽으로 기울입니다.
Description
카메라의 롤(Roll) 축을 따라 오른쪽으로 회전(기울기)합니다.
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.bankRight();setPlayerMode(mode) → void
1인칭 카메라 모드에서 플레이어 모드(물리 기반)를 활성화/비활성화 합니다.
mode
boolean
플레이어 모드 true: 활성화 false: 비활성화
Description
1인칭 지형 결합 모드와 함께 활성화 되어 있을 때, 점프가 가능하며 자연스러운 중력 낙하 효과가 적용됩니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setPlayerMode(true); // 플레이어 모드 활성화
API.JSCamera.setPlayerMode(false); // 플레이어 모드 비활성화isGround() → boolean
1인칭 카메라 모드에서 카메라가 현재 지면에 닿아 있는지 여부를 반환합니다.
Return
true : 지면에 닿아 있음.
false : 지면과 닿아 있지 않음 또는 플레이어 모드가 비활성화
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.isGround();jump() → void
1인칭 카메라 지형결합 모드, 플레이어 모드에서 카메라가 자연스럽게 공중으로 올라갔다가 떨어집니다.
Description
1인칭 지형 결합 모드와 플레이어 모드가 모두 활성화된 상태에서만 동작합니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setUnionMode(true);
API.JSCamera.setPlayerMode(true);
API.JSCamera.jump();getJumpForce(), setJumpForce(jumpForce) → number
초기 점프 속도(점프 세기)를 설정 및 반환합니다.
jumpForce
number
초기 점프 속도(점프 세기)
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setJumpForce(30.0); // 기본값 10.0
var jumpForce = API.JSCamera.getJumpForce();getGravity(), setGravity(gravity) → number
카메라 중력을 설정 및 반환합니다.
gravity
number
카메라 중력
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setGravity(1.62); // 기본값 9.8
var gravity = API.JSCamera.getGravity();getTimeStep(), setTimeStep(timeStep) → number
카메라 점프/낙하 동작의 시간 간격을 설정 및 반환합니다.
timeStep
number
점프/낙하 시간 간격
Description
한 프레임 당 점프/낙하 동작의 간격을 설정합니다.
timeStep이 작을 수록 구간을 더 촘촘하게 잘라 점프/낙하 속도가 느려집니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setTimeStep(0.08); // 기본값 0.05
var timeStep = API.JSCamera.getTimeStep();setLandingElevation(elevation) → void
플레이어 모드에서 카메라의 착지 고도를 설정합니다.
elevation
number
카메라의 착지 고도
Description
카메라가 플레이어 모드인 경우에만 실행됩니다.
점프/낙하 시 카메라는 설정한 고도에 착지합니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setLandingElevation(20.0);setLandingElevationToTerrain() → void
플레이어 모드에서 카메라의 착지 고도를 현재 지형 고도로 설정합니다.
Description
카메라가 플레이어 모드인 경우에만 실행됩니다.
점프/낙하 시 카메라는 설정한 시점의 지형 고도에 착지합니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setLandingElevationToTerrain();setUnionMode(mode) → void
1인칭 카메라 모드에서 지형 결합을 실행합니다.
mode
boolean
카메라 지형 결합 true: 실행 false: 해제
Description
카메라가 1인칭 모드인 경우에만 실행됩니다.
Sample
var API = {
JSCamera : Module.getViewCamera();
};
API.JSCamera.setUnionMode(true); // 실행
API.JSCamera.setUnionMode(false); // 해제setAutoMovePath(pathList) → boolean
카메라 자동 이동 경로를 설정합니다.
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);AltitudeUp()
카메라의 고도를 높입니다. 내부적으로는 현재 시점을 기준으로 일정한 틸트, 방향값을 유지하면서, 고도를 증가시켜 새로운 위치로 카메라를 이동시킵니다.
클래스
JSCamera
반환값
없음
파라미터
없음
설명
현재 카메라의 위치에서 고도를 증가시킨 위치로 카메라를 이동시킵니다. 시점(lookAt)은 그대로 유지하며, 틸트와 방향(heading)도 유지됩니다. 고도 증가는 내부 정의된 일정한 거리만큼 수행됩니다.
관련 API
moveLookAt, SetCamera, SetHeading
var API = {
JSCamera : Module.getViewCamera()
};
API.JSCamera.AltitudeUp();moveLookAt(lookAt, tilt, direct, distance) → void
특정 지점을 기준으로 카메라를 이동시킵니다.
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);setViewMode(vMode) → void
카메라의 뷰 모드를 설정합니다.
vMode
int
뷰 모드 타입. 정수값으로 지정되며, 엔진 내부에서 정의된 시점 모드로 전환됩니다.
Return
없음 (void)
Description
카메라의 뷰 모드를 설정합니다.
vMode는 엔진 내부에 정의된 값으로, 예를 들어 기본 뷰, 3인칭 추적 뷰, 탑다운 뷰 등으로 전환될 수 있습니다.설정 후
UpdateFrame()을 호출하여 프레임 갱신을 즉시 반영합니다.
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.
complete
function
이동 완료 콜백 함수.
Last updated
Was this helpful?