Camera get_frustum undocumented

beegor

Hi, Can anyone tell me what exactly Camera.get_frustum() returns. I see it's Array but what exactly the elements of this array represent?

Thanks!

cybereality

You are correct, it's not in the docs.

I went looking in the source code, and I found some clues, maybe that will help.

get_frustum() returns the result of get_projection_planes() on the camera transform: https://github.com/godotengine/godot/blob/master/scene/3d/camera.cpp#L637

get_projection_planes() returns 6 Plane objects (for the bounding planes of the frustum), in the order Near, Far, Left, Top, Right, Bottom: https://github.com/godotengine/godot/blob/master/core/math/camera_matrix.cpp#L305

Plane is documented here: https://docs.godotengine.org/en/3.1/classes/class_plane.html

Hope that helps.

Calinou

A pull request was recently merged to document it :)

Returns the camera's frustum planes in world-space units as an array of [Plane]s in the following order: near, far, left, top, right, bottom. Not to be confused with [member frustum_offset].

beegor

@cybereality , @Calinou thank you both for helpful answers.
BR