Projection

用于 3D 投影变换的 4×4 矩阵。

描述

用于 3D 投影变换的 4×4 矩阵，可以表示平移、旋转、缩放、剪切和透视分割等变换，由四个 Vector4 列组成。

对于纯粹的线性变换（平移、旋转和缩放），建议使用 Transform3D，因为它的性能更强，内存占用更少。

在内部作为 Camera3D 的投影矩阵使用。

备注

通过 C# 使用这个 API 时有显著的不同。详见 C# API 与 GDScript 的差异。

属性

构造函数

方法

操作符

常量

PLANE_NEAR = 0

该投影的近裁剪平面的索引值。

PLANE_FAR = 1

该投影的远裁剪平面的索引值。

PLANE_LEFT = 2

该投影的左裁剪平面的索引值。

PLANE_TOP = 3

该投影的上裁剪平面的索引值。

PLANE_RIGHT = 4

该投影的右裁剪平面的索引值。

PLANE_BOTTOM = 5

该投影的下裁剪平面的索引值。

IDENTITY = Projection(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1)

未定义变换的 Projection。对其他数据结构使用时，不会进行任何变换。

ZERO = Projection(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)

所有值都初始化为 0 的 Projection。对其他数据结构使用时，会进行清零操作。

属性说明

Vector4 w = Vector4(0, 0, 0, 1)

投影矩阵的 W 向量（第 3 列）。相当于数组索引 3。

Vector4 x = Vector4(1, 0, 0, 0)

投影矩阵的 X 向量（第 0 列）。相当于数组索引 0。

Vector4 y = Vector4(0, 1, 0, 0)

投影矩阵的 Y 向量（第 1 列）。相当于数组索引 1。

Vector4 z = Vector4(0, 0, 1, 0)

投影矩阵的 Z 向量（第 2 列）。相当于数组索引 2。

构造函数说明

Projection Projection ( )

构造默认初始化为 IDENTITY 的 Projection。

Projection Projection ( Projection from )

构造给定 Projection 的副本。

Projection Projection ( Transform3D from )

将 Projection 作为给定 Transform3D 的副本进行构造。

Projection Projection ( Vector4 x_axis, Vector4 y_axis, Vector4 z_axis, Vector4 w_axis )

从四个 Vector4 值（矩阵列）构造 Projection。

方法说明

Projection create_depth_correction ( bool flip_y ) static

创建新的 Projection，将位置从深度 -1 到 1 的范围投影到 0 到 1 的范围，并将投影后的位置根据 flip_y 垂直翻转。

Projection create_fit_aabb ( AABB aabb ) static

创建新的 Projection，将给定的投影进行缩放，从而适应投影空间中的给定 AABB。

Projection create_for_hmd ( int eye, float aspect, float intraocular_dist, float display_width, float display_to_lens, float oversample, float z_near, float z_far ) static

创建新的 Projection，将位置投影至头戴显示器中，使用给定的 X:Y 纵横比、双眼间距、显示器宽度、到镜头的距离、过采样系数以及深度裁剪平面。

eye 设为 1 时创建的是左眼投影，设为 2 时则为右眼。

Projection create_frustum ( float left, float right, float bottom, float top, float z_near, float z_far ) static

创建新的 Projection，将位置投影至平截头台中，平截头台由给定的裁剪平面指定。

Projection create_frustum_aspect ( float size, float aspect, Vector2 offset, float z_near, float z_far, bool flip_fov=false ) static

创建新的 Projection，将位置投影至平截头台中，平截头台由给定的大小、X:Y 纵横比、偏移量以及裁剪平面指定。

flip_fov 决定投影视野是否按对角线翻转。

Projection create_light_atlas_rect ( Rect2 rect ) static

创建新的 Projection，将位置投影至给定的 Rect2。

Projection create_orthogonal ( float left, float right, float bottom, float top, float z_near, float z_far ) static

创建新的 Projection，使用给定裁剪平面的正交投影对位置进行投影。

Projection create_orthogonal_aspect ( float size, float aspect, float z_near, float z_far, bool flip_fov=false ) static

创建新的 Projection，使用正交投影对位置进行投影，正交投影由给定的大小、X:Y 纵横比以及裁剪平面指定。

flip_fov 决定投影视野是否按对角线翻转。

Projection create_perspective ( float fovy, float aspect, float z_near, float z_far, bool flip_fov=false ) static

创建新的 Projection，使用透视投影对位置进行投影，透视投影由给定的 Y 轴视野（单位为度）、X:Y 纵横比以及裁剪平面指定。

flip_fov 决定投影视野是否按对角线翻转。

Projection create_perspective_hmd ( float fovy, float aspect, float z_near, float z_far, bool flip_fov, int eye, float intraocular_dist, float convergence_dist ) static

创建新的 Projection，使用透视投影对位置进行投影，透视投影由给定的 Y 轴视野（单位为度）、X:Y 纵横比以及裁剪平面指定。投影会针对头戴显示器进行调整，使用给定的双眼间距以及与能够聚焦的点的距离。

eye 设为 1 时创建的是左眼投影，设为 2 时则为右眼。

flip_fov 决定投影视野是否按对角线翻转。

float determinant ( ) const

返回一个标量值，该标量值是区域被该矩阵缩放的有符号系数。如果符号是负的，则矩阵翻转该区域的方向。

行列式可用于计算矩阵的可逆性或求解涉及矩阵的线性方程组，以及其他应用。

Projection flipped_y ( ) const

返回这个 Projection 的副本，Y 列中数值的符号都进行了翻转。

float get_aspect ( ) const

返回该 Projection 视口的 X:Y 纵横比。

Vector2 get_far_plane_half_extents ( ) const

返回投影远裁剪平面的尺寸除以二。

float get_fov ( ) const

返回该投影的水平视野（单位为度）。

float get_fovy ( float fovx, float aspect ) static

返回与给定水平视场（以度为单位）和长宽比相关联的投影的垂直视场（以度为单位）。

float get_lod_multiplier ( ) const

返回这个 Projection 对可见细节级别的缩放系数。

int get_pixels_per_meter ( int for_pixel_width ) const

在该 Projection 被应用后，返回每米显示的具有给定像素宽度的像素数。

Plane get_projection_plane ( int plane ) const

返回这个 Projection 的裁剪平面，索引由 plane 给定。

plane 应该等于 PLANE_NEAR、PLANE_FAR、PLANE_LEFT、PLANE_TOP、PLANE_RIGHT 或 PLANE_BOTTOM。

Vector2 get_viewport_half_extents ( ) const

返回视口平面的尺寸除以二，这个 Projection 会把位置投影至该平面。

float get_z_far ( ) const

返回该 Projection 中的距离，超过这个距离的位置会被裁剪。

float get_z_near ( ) const

返回该 Projection 中的距离，未达到这个距离的位置会被裁剪。

Projection inverse ( ) const

返回执行这个 Projection 的逆投影变换的 Projection。

bool is_orthogonal ( ) const

如果该 Projection 进行的是正交投影，则返回 true。

Projection jitter_offseted ( Vector2 offset ) const

返回一个 Projection，X 和 Y 的取值由给定的 Vector2 和最后一列中对应的第一个和第二个值相加而来。

Projection perspective_znear_adjusted ( float new_znear ) const

返回一个 Projection，将其近裁剪距离调整为 new_znear。

注意：原始的 Projection 必须为透视投影。

操作符说明

bool operator != ( Projection right )

如果投影不相等，则返回 true。

注意：由于浮点精度误差，即使投影实际上相等，也可能会返回 true 。可能会在 Godot 的未来版本中添加 is_equal_approx 方法。

Projection operator * ( Projection right )

返回一个 Projection，应用了这个 Projection 和 right 的组合变换。

Vector4 operator * ( Vector4 right )

使用这个 Projection 矩阵将给定的 Vector4 进行投影（相乘）。

bool operator == ( Projection right )

如果投影相等，则返回 true。

注意：由于浮点精度错误，即使投影实际上相等，也可能会返回 false。可能会在 Godot 的未来版本中添加 is_equal_approx 方法。

Vector4 operator [] ( int index )

返回具有给定索引的 Projection 的列。

索引按以下顺序排列：x、y、z、w。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.