카메라

공개 클래스 Camera

장면을 보는 시각을 결정하는 가상 카메라를 나타냅니다.

카메라가 ArSceneView의 일부인 경우 카메라는 ARCore의 카메라 포즈를 자동으로 추적합니다. 또한 다음 메서드를 호출하면 UnsupportedOperationException이 발생합니다.

• setParent(NodeParent) - 카메라의 부모는 변경할 수 없으며 항상 장면입니다.
• setLocalPosition(Vector3) - 카메라의 위치는 변경할 수 없으며 ARCore 카메라 포즈로 제어됩니다.
• setLocalRotation(Quaternion) - 카메라의 회전은 변경할 수 없으며 ARCore 카메라 포즈로 제어됩니다.
• setWorldPosition(Vector3) - 카메라의 위치는 변경할 수 없으며 ARCore 카메라 포즈로 제어됩니다.
• setWorldRotation(Quaternion) - 카메라의 회전은 변경할 수 없으며 ARCore 카메라 포즈로 제어됩니다.

Node의 다른 모든 기능이 지원됩니다. 카메라의 위치 및 회전에 액세스하거나 카메라에 충돌 도형을 할당하거나 카메라에 하위 요소를 추가할 수 있습니다. 카메라를 사용 중지하면 렌더링이 사용 중지됩니다.

공개 메서드

float	getFarClipPlane()
float	getNearClipPlane() 가져오기
float	getVerticalFovDegrees() 카메라의 수직 시야를 가져옵니다.
레이	screenPointToRay(부동 소수점 수 x, 부동 소수점 수 y) 카메라와 가까운 평면에서 화면 공간의 특정 지점을 통과하는 세계 공간의 광선을 계산합니다.
void	setLocalPosition(Vector3 위치) 카메라의 위치를 설정합니다.
void	setLocalRotation(Quaternion 회전) 카메라 회전을 설정합니다.
void	setParent(NodeParent 상위) 지원되지 않는 작업입니다.
void	setVerticalFovDegrees(float verticalFov) 비 AR 카메라의 수직 시야를 도 단위로 설정합니다.
void	setWorldPosition(Vector3 위치) 카메라의 위치를 설정합니다.
void	setWorldRotation(Quaternion 회전) 카메라 회전을 설정합니다.
벡터3	worldToScreenPoint(Vector3 포인트) 월드 공간의 위치를 화면 공간으로 변환합니다.

상속된 메서드

출처: com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListener lifecycleListener) 노드 수명 주기 이벤트가 발생할 때 호출될 리스너를 추가합니다.
void	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) 노드의 변환이 변경될 때 호출될 리스너를 추가합니다.
void	callOnHierarchy(소비자 노드) 계층 구조를 순회하고 각 노드 (이 노드 포함)에서 메서드를 호출합니다.
최종 부울	canAddChild(Node 하위 요소, StringBuilder failedReason)
노드	findInHierarchy(조건자 &노드 조건) 계층 구조를 탐색하여 조건을 충족하는 첫 번째 노드 (이 노드 포함)를 찾습니다.
최종 Vector3	getBack() 이 노드의 월드 공간 뒤로 벡터 (+z)를 가져옵니다.
CollisionShape	getCollisionShape() 이 노드와 충돌에 사용할 도형을 가져옵니다.
최종 Vector3	getDown() 이 노드의 월드 공간 다운 벡터 (-y)를 가져옵니다.
최종 Vector3	getForward() 이 노드의 월드 공간 정방향 벡터 (-z)를 가져옵니다.
최종 Vector3	getLeft() 이 노드의 월드 공간 왼쪽 벡터 (-x)를 가져옵니다.
약간	getLight() 변경 가능한 현재 광원을 가져옵니다.
최종 Vector3	getLocalPosition() 상위 (로컬 공간)를 기준으로 노드 위치의 사본을 가져옵니다.
최종 사원수	getLocalRotation() 상위 요소 (로컬 공간)를 기준으로 노드 회전의 사본을 가져옵니다.
최종 Vector3	getLocalScale() 상위 (로컬 공간)를 기준으로 노드 배율의 사본을 가져옵니다.
최종 문자열	getName() 노드 이름을 반환합니다.
최종 노드	getParent() 이 노드의 상위 요소를 반환합니다.
렌더링 가능	getRenderable() 이 노드에 표시할 렌더링 가능 항목을 가져옵니다.
최종 Vector3	getRight() 이 노드의 월드 공간 오른쪽 벡터 (+x)를 가져옵니다.
최종 장면	get scene() 이 노드가 포함된 장면을 반환합니다. 장면에 속하지 않는 경우 null을 반환합니다.
최종 Vector3	getUp() 이 노드의 월드 공간 위로 벡터 (+y)를 가져옵니다.
최종 Vector3	getWorldPosition() 노드 월드 위치의 사본을 가져옵니다.
최종 사원수	getWorldRotation() 노드 월드 공간 회전의 사본을 가져옵니다.
최종 Vector3	getWorldScale() 노드 공간 간 노드의 사본을 가져옵니다.
최종 부울	isActive() 노드가 활성 상태이면 true를 반환합니다.
최종 부울	isDescendantOf(NodeParent 상위 항목) 지정된 노드 상위 노드가 이 노드의 상위 항목인지 재귀적으로 확인합니다.
최종 부울	isEnabled() 이 노드의 사용 설정된 상태를 가져옵니다.
boolean	isTopLevel() 이 노드가 최상위 수준이면 true를 반환합니다.
최종 Vector3	localToWorldDirection(Vector3 방향) 이 노드의 로컬 공간에서 월드 공간으로 방향을 변환합니다.
최종 Vector3	localToWorldPoint(Vector3 포인트) 이 노드의 로컬 공간의 지점을 월드 공간으로 변환합니다.
void	onActivate() 이 노드가 활성화되면 처리합니다.
최종 무효	onAddChild(Node 하위)
void	on비활성화() 이 노드가 비활성화될 때 처리합니다.
최종 무효	onRemoveChild(Node 하위 요소)
boolean	onTouchEvent(HitTestResult hitTestResult, MotionEventMotionEvent) 이 노드를 터치하면 처리됩니다.
void	onTransformChange(노드 originNode) 이 노드의 변환이 변경되면 처리합니다.
void	onUpdate(FrameTime 프레임 시간) 이 노드가 업데이트될 때 처리합니다.
void	removeLifecycleListener(Node.LifecycleListener lifecycleListener) 노드 수명 주기 이벤트가 발생할 때 호출될 리스너를 삭제합니다.
void	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) 노드의 변환이 변경될 때 호출될 리스너를 삭제합니다.
void	setCollisionShape(CollisionShape collisionShape) 이 Node의 충돌을 감지하는 데 사용되는 도형을 설정합니다.
최종 무효	setEnabled(부울 사용 설정됨) 이 노드의 사용 상태를 설정합니다.
void	setLight(Light 조명) 표시할 Light를 설정합니다.
void	setLocalPosition(Vector3 위치) 이 노드의 위치를 상위 요소 (local-space)를 기준으로 설정합니다.
void	setLocalRotation(Quaternion 회전) 이 노드의 상위 요소 (local-space)를 기준으로 이 노드의 회전을 설정합니다.
void	setLocalScale(Vector3 배율) 이 노드의 크기를 상위 노드 (local-space)를 기준으로 설정합니다.
최종 무효	setLookDirection(Vector3 LookDirection) 세계 공간에서 노드가 향하는 방향을 설정합니다.
최종 무효	setLookDirection(Vector3 LookDirection, Vector3 upDirection) 세계 공간에서 노드가 향하는 방향을 설정합니다.
최종 무효	setName(문자열 이름) 이 노드의 이름을 설정합니다.
void	setOnTapListener(Node.OnTapListener onTapListener) 이 노드를 탭할 때 호출할 콜백을 등록합니다.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) 터치 이벤트가 이 노드로 전달되면 호출될 콜백을 등록합니다.
void	setParent(NodeParent 상위) 이 노드의 상위 노드를 변경합니다.
void	setRenderable(렌더링 가능 렌더링 가능) 이 노드에 표시할 Renderable를 설정합니다.
void	setWorldPosition(Vector3 위치) 이 노드의 월드 공간 위치를 설정합니다.
void	setWorldRotation(Quaternion 회전) 이 노드의 월드 공간 회전을 설정합니다.
void	setWorldScale(Vector3 배율) 이 노드의 월드 공간 규모를 설정합니다.
문자열	toString ()
최종 Vector3	worldToLocalDirection(Vector3 방향) 월드 공간에서 이 노드의 로컬 공간으로 방향을 변환합니다.
최종 Vector3	worldToLocalPoint(Vector3 포인트) 월드 공간의 지점을 이 노드의 로컬 공간으로 변환합니다.

com.google.ar.sceneform.NodeParent 클래스에서

최종 무효	addChild(노드 하위 요소) 노드를 이 NodeParent의 하위로 추가합니다.
void	callOnHierarchy(소비자 노드) 계층 구조를 순회하고 각 노드에서 메서드를 호출합니다.
boolean	canAddChild(Node 하위 요소, StringBuilder failedReason)
노드	findByName(문자열 이름) 계층 구조를 탐색하여 지정된 이름의 첫 번째 노드를 찾습니다.
노드	findInHierarchy(조건자 &노드 조건) 계층 구조를 탐색하여 조건을 충족하는 첫 번째 노드를 찾습니다.
최종 목록<노드>	getChildren() 이 상위 요소의 변경 불가능한 목록을 반환합니다.
void	onAddChild(Node 하위)
void	onRemoveChild(Node 하위 요소)
최종 무효	removeChild(Node 하위) 이 NodeParent의 하위에서 노드를 삭제합니다.

java.lang.Object 클래스에서 상속됨

객체	clone()
boolean	equals(Object arg0)
void	최종()
최종 클래스</#gt;	getClass
int	hashCode()
최종 무효	notify()
최종 무효	notifyAll()
문자열	toString
최종 무효	wait(long arg0, int arg1)
최종 무효	wait(long arg0)
최종 무효	wait()

공개 메서드

public float getFarClipPlane ()

public float getNearClipPlane ()

public float getVerticalFovDegrees ()

카메라의 수직 시야를 가져옵니다.

AR 카메라인 경우 ARCore의 카메라 정보를 기반으로 계산되며 기기마다 다를 수 있습니다. ARCore 세션이 재개된 후 첫 번째 프레임이 생성될 때까지 계산될 수 없으며, 이 경우 IllegalStateException이 발생합니다.

그렇지 않으면 setVerticalFovDegrees(float)에서 설정한 값(기본값: 90도)이 반환됩니다.

예외 처리

IllegalStateException	ARCore가 재개된 후 첫 번째 프레임 전에 호출되는 경우

public Ray screenPointToRay (float x, float y)

카메라와 가까운 평면에서 화면 공간의 특정 지점을 통과하는 세계 공간의 광선을 계산합니다. 화면 공간은 Android 기기 화면 좌표로, 상위 왼쪽 = (0, 0) BottomRight = (화면 너비, 화면 높이) 기기 좌표 공간은 기기의 방향에 영향을 받지 않습니다.

매개변수

x	기기 화면 좌표의 X 위치
y	기기 화면 좌표의 Y 위치입니다.

public void setLocalPosition (Vector3 위치)

카메라의 위치를 설정합니다. 카메라는 항상 isTopLevel()이므로 setWorldPosition(Vector3)와 동일하게 작동합니다.

카메라가 ArSceneView의 일부인 경우 지원되지 않는 작업입니다. ARCore 카메라 자세로 제어되므로 카메라의 위치를 변경할 수 없습니다.

매개변수

position	적용할 위치입니다.

public void setLocalRotation (Quaternion 회전)

카메라 회전을 설정합니다. 카메라는 항상 isTopLevel()이므로 setWorldRotation(Quaternion)와 동일하게 작동합니다.

카메라가 ArSceneView의 일부인 경우 지원되지 않는 작업입니다. ARCore 카메라 자세로 제어되므로 카메라의 회전을 변경할 수 없습니다.

매개변수

회전	적용할 회전입니다.

public void setParent (NodeParent parent)

지원되지 않는 작업입니다. 카메라의 부모는 변경할 수 없습니다. 항상 장면이기 때문입니다.

매개변수

parent	이 노드의 하위 요소가 될 새 상위 노드입니다. null이면 이 노드가 상위 노드에서 분리됩니다.

public void setVerticalFovDegrees (float verticalFov)

비 AR 카메라의 수직 시야를 도 단위로 설정합니다. AR 카메라인 경우 ARCore에서 초점을 가져오며 설정할 수 없으므로 예외가 발생합니다. 기본값은 90도입니다.

매개변수

verticalFov

예외 처리

지원되지 않는 예외	AR 카메라인 경우

public void setWorldPosition (Vector3 위치)

카메라의 위치를 설정합니다. 카메라는 항상 isTopLevel()이므로 setLocalPosition(Vector3)와 동일하게 작동합니다.

카메라가 ArSceneView의 일부인 경우 지원되지 않는 작업입니다. ARCore 카메라 자세로 제어되므로 카메라의 위치를 변경할 수 없습니다.

매개변수

position	적용할 위치입니다.

public void setWorldRotation (Quaternion 회전)

카메라 회전을 설정합니다. 카메라는 항상 isTopLevel()이므로 setLocalRotation(Quaternion)와 동일하게 작동합니다.

카메라가 ArSceneView의 일부인 경우 지원되지 않는 작업입니다. ARCore 카메라 자세로 제어되므로 카메라의 회전을 변경할 수 없습니다.

매개변수

회전	적용할 회전입니다.

public Vector3 worldToScreenPoint (Vector3 포인트)

월드 공간의 위치를 화면 공간으로 변환합니다.

X 값은 점이 표시 영역 왼쪽에 있을 때 음수 값이며, 점은 표시 영역 내에 있을 때 0과 SceneView 너비 사이, 점이 표시 영역 오른쪽에 있을 때 너비보다 큽니다.

지점이 표시 영역 아래에 있으면 Y 값이 음수, 지점이 표시 영역 내에 있을 때 SceneView의 높이가 0과 높이 사이이고 점이 표시 영역 위에 있을 때의 높이보다 큽니다.

반환 값이 2D 좌표이므로 Z 값은 항상 0입니다.

매개변수

point	변환할 공간

반환 값

• 화면 공간의 점을 나타내는 새로운 벡터입니다.