JSCamera
지도 카메라 설정을 위한 API입니다.
Module.getViewCamera API를 생성합니다.
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()
카메라의 고도를 낮춥니다.
AltitudeUp()
카메라의 고도를 높입니다.
AngleDown()
카메라의 기울기 각도를 낮춥니다.
회전을 지원하지 않는 평면 모드에서는 작동하지 않습니다.
AngleUp()
카메라의 기울기 각도를 높입니다.
FOVDecrease()
카메라의 FOV를 줄입니다.
FOVIncrease()
카메라의 FOV를 높입니다.
getMapZoomLevel() -> number
카메라 고도에서 가시화 된 지형 정밀 레벨 정보를 반환합니다.
Return
number: 현재 가시화 지형 레벨.
look(from, to) → boolean
두 점을 사용하여 카메라를 이동합니다.
from
카메라 위치 좌표 (경도, 위도, 고도).
to
카메라가 보고 있는 위치 좌표(경도, 위도, 고도).
Return
true : 설정 성공.
false : 설정 실패.
Sample
function init 참조.
MapRender()
3D 지도 화면을 갱신합니다.
move(position, tilt, direct, speed)
카메라를 지정된 위치, 기울기, 방향을 설정합니다.
position
카메라 위치 좌표 (경도, 위도, 고도).
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
Sample
function init 참조.
moveDist(location, tilt, direct, dist, speed)
카메라를 지정된 위치, 기울기, 방향, 거리, 속도를 설정합니다.
location
카메라 위치 좌표 (경도, 위도, 고도).
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
dist
number
(현재 미적용).
speed
number
카메라 이동속도 (기본 1).
MoveDown()
카메라를 현재 위치에서 뒤로 이동합니다.
MoveLeft()
카메라를 현재 위치에서 왼쪽으로 이동합니다.
moveLonLat(longitude, latitude)
카메라를 지정된 위치(경도, 위도)를 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
moveLonLatAlt(x, y, z, type)
카메라를 지정된 위치(경도, 위도, 고도)를 설정합니다.
x
number
카메라 위치 경도 좌표 (degrees 단위).
y
number
카메라 위치 위도 좌표 (degrees 단위).
z
number
카메라 위치 고도 좌표 (meter 단위).
type
boolean
카메라 이동 애니메이션 적용 유무.
Sample
function init 참조.
moveLonLatAltOval(longitude, latitude, altitude, speed)
카메라를 지정된 위치(경도, 위도, 고도) 이동 시 확대/축소 애니메이션을 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
altitude
number
카메라 위치 고도 좌표 (meter 단위).
speed
number
카메라 이동속도 (기본 1).
moveLonLatBoundarybyJson(option) → string
최소 좌표점, 최대 좌표점을 이용한 카메라 이동 및 완료 이벤트를 설정합니다..
option
속성 정보.
Return
true : 설정 성공.
false : 설정 실패.
실패 조건
JSCamera.MoveBoundaryOption 구성 태그가 누락된 경우.
Sample
function moveTestArea 참조.
moveLonLatOval(longitude, latitude, speed)
카메라를 지정된 위치(경도, 위도) 이동 시 애니메이션 효과를 설정합니다.
longitude
number
카메라 위치 경도 좌표 (degrees 단위).
latitude
number
카메라 위치 위도 좌표 (degrees 단위).
speed
number
카메라 이동속도 (기본 1).
moveOval(position, tilt, direct, speed)
카메라를 지정된 위치(경도, 위도, 고도) 이동 시 애니메이션 효과를 설정합니다.
position
카메라 위치 좌표 (경도, 위도, 고도).
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
Sample
function initPage 참조.
moveOvalDist(location, tilt, Direct, speed)
카메라를 지정된 위치(경도, 위도, 고도)로 부터 기울기 방향을 기준으로 거리를 적용한 좌표를 설정한다.
카메라 이동시 확대/축소 애니메이션 효과 설정한다.
location
카메라 위치 좌표 (경도, 위도, 고도).
tilt
number
카메라 기울기.
direct
number
카메라 좌우 회전.
speed
number
카메라 이동 속도 (1.0 ~ 10.0).
MoveRight()
카메라를 현재 위치에서 오른쪽으로 이동합니다.
MoveUp()
카메라를 현재 위치에서 앞으로 이동합니다.
pauseAutoMove(pause) -> boolean
카메라 자동 이동 시 일시 중지를 설정합니다.
pause
boolean
자동 이동 설정. true: 멈춤. false: 시작.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function pauseCameraAutoMove 참조.
reset()
카메라의 속성 정보를 초기화 상태로 설정합니다.
rotateLeft()
카메라를 현재 왼쪽으로 회전합니다.
rotateRight()
카메라를 현재 오른쪽으로 회전합니다.
setDistance(Dist)
카메라 시점, 위치 간의 거리를 설정합니다.
Dist
number
카메라 시야 거리 (meters 단위).
setAltitude(alt)
카메라 고도를 설정합니다.
alt
number
카메라 위치 고도 좌표 (meter 단위).
Sample
function setAltitude 참조.
setAutoMovePosition(coordinates) → boolean
카메라의 자동 이동 좌표 목록을 설정합니다.
coordinates
자동 이동 경로의 좌표 목록.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
setAutoMoveWaitFrame(speed) → boolean
카메라의 자동 이동 중 카메라의 이동 간격 발생 프레임을을 설정합니다.
speed
number
카메라 이동 애니메이션 발생 프레임 수.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
setAutoMoveRoundPositions(center, distance, altitude, startAngle, endAngle, type) → boolean
카메라의 원형 이동 경로를 설정합니다.
center
카메라 회전 중심 좌표(경도, 위도, 고도)
distance
number
카메라 회전 반지름 거리 (meter 단위).
altitude
number
카메라 위치 고도 좌표 (meter 단위).
startAngle
number
카메라 초기 시야 방향
endAngle
number
카메라 종료 시야 방향
type
boolean
카메라 이동 방향 설정 (true: 반시계 방향, false: 시계 방향)
Return
true : 설정 성공.
false : 설정 실패.
Sample
function setAutoMovePosition 참조.
SetCameraShakeEffect(type) → boolean
카메라 흔들림 효과를 설정합니다.
type
boolean
카메라 흔들링 유무 설정.
Return
true : 설정 성공.
false : 설정 실패.
Sample
function ShakeCamera 참조.
SetCameraShakeStrength(value) → boolean
카메라 흔들림 강도를 설정합니다.
value
number
카메라 흔들링 강도 (1 ~ 100).
Return
true : 설정 성공.
false : 설정 실패.
Sample
function SetShakeEffectStrength 참조.
setPermitUnderGround(type)
지하에서 카메라 이동 유무를 설정합니다.
type
boolean
지하 이동 true: 이동 가능. false: 이동 금지.
startAutoMove() → boolean
카메라 자동 이동을 시작합니다.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function startCameraAutoMove 참조.
stopAutoMove() → boolean
카메라 자동 이동을 종료합니다.
Return
true: 설정 성공.
false: 설정 실패.
Sample
function stopCameraAutoMove 참조.
viewNorth()
카메라가 정복 방향을 바라보도록 회전 합니다.
ZoomIn()
화면 중심 위치를 기준으로 카메라 확대를 실행합니다.
ZoomOut()
화면 중심 위치를 기준으로 카메라 축소를 실행합니다.
getLocation() -> JSVector3D
카메라 위치 좌표를 반환합니다.
Return
JSVector3D: 카메라 위치 좌표 (경도, 위도, 고도)를 성공적으로 반환.
null: 카메라 위치 좌표 반환에 실패.
setLocation(position) → boolean
카메라 위치 좌표를 설정합니다.
position
카메라 위치 좌표 (경도, 위도, 고도).
Return
true: 설정 성공.
false: 설정 실패.
Sample
function setMove 참조.
setVideoInfo(option) -> string
비디오 텍스쳐를 생성합니다.
url
string
미디어 URL 경로.
dronemode
boolean
중심 좌표 (경도, 위도, 고도).
streaming
boolean
비디오 스트리밍 설정.
objectmapping
boolean
건물 매핑 설정.
alpha
number
비디오 투명값 설정.
zoom
number
비디오 배율 설정.
fov
비디오 화각 설정.
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 참조.
getDirect(), setDirect(direct) -> number
카메라의 현재 방향 각도를 설정 및 반환합니다.
방향각도 값의 범위는 -180도 ~ 180도 사이 입니다.
0도: 북쪽
+90도: 동쪽
180도 or -180도: 남쪽
-90도: 서쪽
direct
number
카메라 좌우 회전.
Return
number: 카메라 좌우 회전값 반환 (degree 단위).
Sample
function setDirect 참조.
getFov(), setFov(fov) -> number
카메라의 화각 설정 및 반환 합니다.
fov
카메라 화각.
Return
number: 카메라 시야 화각 반환 (degree 단위).
Sample
function setFOV 참조.
getMoveMode(), setMoveMode(type) -> boolean
1인칭, 3인칭 카메라 회전 모드를 설정 및 반환 합니다.
type
boolean
카메라 회전 모드.
Return
카메라 모드 반환.
true: 1인칭 시점 회전 모드.
false: 3인칭 시점 회전 모드.
Sample
function setPerson 참조.
getLimitAltitude(), setLimitAltitude(alt) -> number
카메라 제한 고도값을 설정 및 반환합니다.
alt
number
카메라 제한 고도값 (meters 단위).
Return
number: 카메라 제한 고도값 반환 (meter 단위).
Sample
function initPage 참조.
getLimitTilt(), setLimitTilt(tilt) -> number
카메라 제한 기울기 각도를 설정 및 반환합니다.
tilt
number
카메라 제한 기울기 각도 (degree 단위).
Return
number: 카메라 제한 기울기 각도를 반환합니다 (degree 단위).
Sample
function initPage 참조.
getTilt(), setTilt(tilt) -> number
카메라 기울기 각도를 설정 및 반환합니다.
tilt
number
카메라 기울기 각도 (degree 단위).
Return
number: 카메라 기울기 각도를 반환합니다 (degree 단위).
Sample
See function setTilt.
moveFrontBack(delta)
카메라를 현재 시점 방향 기준으로 앞 또는 뒤로 이동합니다.
delta
number
이동 거리. 양수면 앞으로, 음수면 뒤로 이동.
moveLeftRight(delta)
카메라를 현재 시점 기준으로 좌우로 이동합니다.
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
카메라를 시점 기준 아래로 이동합니다.
setTraceTarget(target) → boolean
카메라의 추적 대상을 설정합니다.
target
JSTraceTarget
추적 대상 객체입니다.
Return
true
: 추적 대상 설정 성공false
: 대상이 유효하지 않거나 설정 실패
Description
지정된 객체를 카메라가 지속적으로 따라가도록 설정합니다.
setTraceActive(active) → boolean
추적 대상의 추적 활성화 여부를 설정합니다.
active
boolean
true
: 추적 활성화, false
: 비활성화
Return
true
: 설정 성공false
: 설정 실패 (내부 엔진 미정의 상태 등)
Description
setTraceTarget()
으로 설정한 대상에 대해 추적을 켜거나 끌 수 있습니다.
bankLeft()
카메라를 왼쪽으로 기울입니다.
Description
카메라의 롤(Roll) 축을 따라 왼쪽으로 회전(기울기)합니다.
bankRight()
카메라를 오른쪽으로 기울입니다.
Description
카메라의 롤(Roll) 축을 따라 오른쪽으로 회전(기울기)합니다.
setAutoMovePath(pathList) → boolean
카메라 자동 이동 경로를 설정합니다.
pathList
Array
이동 경로를 구성하는 지점 목록입니다. 각 요소는 { position, direction, tilt }
객체로 구성됩니다.
Description
최소 2개 이상의 경로 지점을 포함해야 합니다.
각 경로 지점에는
position
(JSVector3D),direction
(number),tilt
(number)가 포함됩니다.입력값이 유효하지 않으면 경로는 등록되지 않습니다.
AltitudeUp()
카메라의 고도를 높입니다. 내부적으로는 현재 시점을 기준으로 일정한 틸트, 방향값을 유지하면서, 고도를 증가시켜 새로운 위치로 카메라를 이동시킵니다.
클래스
JSCamera
반환값
없음
파라미터
없음
설명
현재 카메라의 위치에서 고도를 증가시킨 위치로 카메라를 이동시킵니다. 시점(lookAt)은 그대로 유지하며, 틸트와 방향(heading)도 유지됩니다. 고도 증가는 내부 정의된 일정한 거리만큼 수행됩니다.
관련 API
moveLookAt
, SetCamera
, SetHeading
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()
을 호출하여 반영합니다.
setViewMode(vMode) → void
카메라의 뷰 모드를 설정합니다.
vMode
int
뷰 모드 타입. 정수값으로 지정되며, 엔진 내부에서 정의된 시점 모드로 전환됩니다.
Return
없음 (void)
Description
카메라의 뷰 모드를 설정합니다.
vMode
는 엔진 내부에 정의된 값으로, 예를 들어 기본 뷰, 3인칭 추적 뷰, 탑다운 뷰 등으로 전환될 수 있습니다.설정 후
UpdateFrame()
을 호출하여 프레임 갱신을 즉시 반영합니다.
Type Definitions
JSCamera.MoveBoundaryOption
Options for moving the camera based on area information.
boundary
카메라 이동 경계 박스.
complete
function
이동 완료 콜백 함수.
Last updated
Was this helpful?