Camera QML Type

장면이 렌더링될 시점을 정의합니다. 더 보기...

이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

• 상속된 멤버를 포함한 모든 멤버 목록
• 사용 중단된 멤버

속성

• aspectRatio : real
• bottom : real
• exposure : real
• farPlane : real
• fieldOfView : real
• left : real
• lens : CameraLens
• nearPlane : real
• position : vector3d
• projectionMatrix : matrix4x4
• projectionType : enumeration
• right : real
• top : real
• transform : Transform
• upVector : vector3d
• viewCenter : vector3d
• viewVector : vector3d

방법

• void pan(real angle)
• void pan(real angle, vector3d axis)
• void panAboutViewCenter(real angle)
• void panAboutViewCenter(real angle, vector3d axis)
• quaternion panRotation(real angle)
• void roll(real angle)
• void rollAboutViewCenter(real angle)
• quaternion rollRotation(real angle)
• void rotate(quaternion q)
• void rotateAboutViewCenter(quaternion q)
• quaternion rotation(real angle, vector3d axis)
• void tilt(real angle)
• void tiltAboutViewCenter(real angle)
• quaternion tiltRotation(real angle)
• void translate(vector3d vLocal, enumeration option)
• void translateWorld(vector3d vWorld, enumeration option)
• void viewAll()
• void viewEntity(Entity entity)
• void viewSphere(vector3d center, real radius)

상세 설명

부동산 관련 서류

aspectRatio : real

카메라의 현재 화면 비율을 유지합니다.

bottom : real

카메라의 현재 하단 위치를 저장합니다.

이 속성은 ` projectionType `가 `CameraLens.OrthographicProjection`인 경우에만 적용됩니다.

exposure : real

카메라의 현재 노출 값을 저장합니다.

기본값은 0.0입니다.

Qt 3D Extras에 포함된 MetalRoughMaterial은 현재 카메라 노출을 활용하는 유일한 제공된 머티리얼입니다. 음수 값을 지정하면 머티리얼이 더 어두워지고, 양수 값을 지정하면 더 밝아집니다.

사용자 정의 머티리얼은 이 값을 다르게 해석할 수도 있습니다.

farPlane : real

카메라의 현재 원근 평면(far plane)을 유지합니다. farPlane보다 카메라에서 더 멀리 떨어진 오브젝트는 렌더링되지 않습니다.

fieldOfView : real

카메라의 현재 수직 시야각(도)을 저장합니다.

aspectRatio 와 함께 이 속성은 카메라에 얼마나 많은 장면이 보이는지를 결정합니다. 이러한 측면에서, 이 속성은 촬영하고자 하는 장면의 범위에 따라 광각 렌즈(수평 시야각이 넓은 렌즈)나 망원 렌즈(수평 시야각이 좁은 렌즈)를 선택하는 것과 유사하다고 생각할 수 있습니다.

fieldOfView는 projectionType 가 CameraLens.PerspectiveProjection일 때만 적용됩니다.

left : real

카메라의 현재 좌좌표를 저장합니다.

이 속성은 ` projectionType `가 `CameraLens.OrthographicProjection`일 때만 적용됩니다.

lens : CameraLens [read-only]

카메라의 CameraLens 컴포넌트를 포함합니다.

nearPlane : real

현재 카메라를 카메라의 근접 평면 근처에 위치시킵니다. nearPlane보다 카메라에 더 가까운 오브젝트는 렌더링되지 않습니다.

position : vector3d

카메라의 현재 위치를 상위 엔티티를 기준으로 한 좌표계에서 저장합니다.

projectionMatrix : matrix4x4

카메라의 현재 투영 행렬을 저장합니다.

projectionType : enumeration

카메라 투영 방식의 유형을 저장합니다. 기본값은 CameraLens.PerspectiveProjection입니다.

• CameraLens.OrthographicProjection - 평행한 선은 평행하게 보입니다. 물체는 거리와 상관없이 동일한 크기로 보입니다.
• CameraLens.PerspectiveProjection - 평행한 선들이 멀리서 만나게 보입니다. 물체는 카메라에서 멀어질수록 작아 보이는 것처럼 보입니다.
• CameraLens.FrustumProjection
• CameraLens.CustomProjection

Qt3DRender::QCameraLens::ProjectionType도 참조하십시오 .

right : real

카메라의 현재 투영 방식을 저장합니다.

이 속성은 ` projectionType `가 `CameraLens.OrthographicProjection`일 때만 적용됩니다.

top : real

카메라의 현재 상단 위치를 저장합니다.

이 속성은 ` projectionType `가 `CameraLens.OrthographicProjection`인 경우에만 적용됩니다.

transform : Transform [read-only]

카메라의 Transform 컴포넌트를 포함합니다.

upVector : vector3d

카메라의 현재 상향 벡터를 부모 엔티티를 기준으로 한 좌표계에서 저장합니다.

up 벡터는 카메라 상단이 향하고 있는 방향을 나타냅니다. 사진을 찍는 상황을 생각해 보세요. 위치를 잡고 카메라를 피사체 쪽으로 향한 후, 카메라를 좌우로 회전시켜 세로 사진이나 가로 사진(혹은 비스듬한 각도의 사진!)을 찍을 수 있습니다. upVector를 사용하면 이러한 움직임을 제어할 수 있습니다.

viewCenter : vector3d

카메라의 현재 시점 중심을 상위 엔티티를 기준으로 한 좌표로 저장합니다.

직관적으로 말하면, viewCenter는 카메라가 향하고 있는 위치입니다.

viewVector : vector3d [read-only]

카메라의 시선 벡터를 부모 엔티티를 기준으로 한 좌표계에서 저장합니다.

이 벡터는 카메라(position)에서 대상(viewCenter)까지의 변위를 나타냅니다.

메서드 문서

void pan(real angle)

카메라의 팬 각도를 angle 만큼(도 단위) 조정합니다.

void pan(real angle, vector3d axis)

axis 에서 뷰 중심을 기준으로 카메라 팬 각도를 angle 도만큼 조정합니다.

void panAboutViewCenter(real angle)

뷰 중심을 기준으로 카메라의 팬 각도를 angle 도만큼 조정합니다.

void panAboutViewCenter(real angle, vector3d axis)

axis 에서 뷰 중심을 기준으로 카메라 팬 각도를 angle 도만큼 조정합니다.

quaternion panRotation(real angle)

angle 를 기준으로 계산된 팬 회전 각도를 도 단위로 반환하며, 이 값을 사용하여 카메라의 Y축을 중심으로 한 팬 또는 좌우 회전을 조정합니다.

void roll(real angle)

카메라 롤을 angle 만큼(도 단위) 조정합니다.

void rollAboutViewCenter(real angle)

카메라 롤을 뷰 센터를 기준으로 angle 도만큼 조정합니다.

quaternion rollRotation(real angle)

angle 를 기준으로 계산된 롤 회전 각도를 도 단위로 반환하며, 이 값은 카메라의 Z축을 중심으로 한 좌우 롤 또는 기울기 회전을 조정하는 데 사용됩니다.

void rotate(quaternion q)

q 에서 쿼터니언을 사용하여 카메라를 회전합니다.

void rotateAboutViewCenter(quaternion q)

q 에서 쿼터니언을 사용하여 뷰 중심을 기준으로 카메라를 회전합니다.

quaternion rotation(real angle, vector3d axis)

angle 를 기준으로 계산된 회전 각도를 도(degree) 단위로, 그리고 선택된 axis 에서 측정된 값으로 반환합니다.

void tilt(real angle)

카메라의 기울기 각도를 angle 만큼(도 단위) 조정합니다.

void tiltAboutViewCenter(real angle)

뷰 중심을 기준으로 카메라의 기울기를 angle 도만큼 조정합니다.

quaternion tiltRotation(real angle)

angle 를 기준으로 계산된 틸트 회전 각도를 도 단위로 반환하며, 이 값을 사용하여 카메라의 틸트 또는 X축 상하 회전을 조정할 수 있습니다.

void translate(vector3d vLocal, enumeration option)

카메라의 위치와 시야 벡터를 로컬 좌표계에서 ` vLocal `만큼 변환합니다. ` option `를 사용하면 시야 중심을 변환할지 여부를 설정할 수 있습니다.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Qt3DRender::QCamera::CameraTranslationOption도 참조하십시오 .

void translateWorld(vector3d vWorld, enumeration option)

카메라의 위치와 시야 벡터를 월드 좌표계에서 vWorld 만큼 변환합니다. ‘ option ’를 통해 시야 중심을 변환할지 여부를 설정할 수 있습니다.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Qt3DRender::QCamera::CameraTranslationOption도 참조하십시오 .

void viewAll()

카메라의 중심점( viewCenter )이 씬의 경계 볼륨 중심이 되고, 씬 전체가 뷰포트에 들어갈 수 있도록 카메라를 회전 및 이동합니다.

Qt3D.Render::Camera::projectionType도 참조하십시오 .

void viewEntity(Entity entity)

카메라의 중심( viewCenter )이 엔티티의 경계 볼륨(bounding volume)의 중심이 되도록 카메라를 회전 및 이동시키고, 엔티티의 전체 경계 볼륨( entity )이 뷰포트 내에 모두 들어오도록 합니다.

참조: Qt3D.Render::Camera::projectionType.

void viewSphere(vector3d center, real radius)

카메라의 원점( viewCenter )이 center 이 되도록 카메라를 회전 및 이동하고, radius 크기의 구가 뷰포트에 들어맞도록 합니다.

Qt3D.Render::Camera::projectionType도 참조하십시오 .