URL: https://graphicscomputing.fr/cgp/reference/camera_orbit_euler/
Description: Camera orbiting around a center, oriented by two angles (keeps the up direction).

# camera_orbit_euler

Camera orbiting around a center, oriented by two angles (keeps the up direction).

Fields:

- `float roll` - Twist angle in radians around the view direction, 0 by default (not used in standard orbit mode).
- `float pitch` - Up/down rotation angle in radians around the local x axis, 0 by default.
- `float yaw` - Left/right rotation angle in radians around axis_of_rotation, 0 by default.
- `vec3 axis_of_rotation` - Up direction of the orbit when pitch = 0, around which yaw rotates, (0,1,0) by default.
- `vec3 center_of_rotation` - Point the camera orbits around and looks at, (0,0,0) by default.
- `float distance_to_center` - Distance between the camera position and center_of_rotation, 5 by default.

Functions taking it:

- `intersection_structure picking_plane_orthogonal_to_camera(vec2 const& screen_position, vec3 const& plane_position, camera_generic_base const& camera, camera_projection_perspective const& projection)` - Intersects the camera ray through the screen position (relative coordinates) with the plane through plane_position orthogonal to the front direction of the camera.
- `picking_structure picking_spheres(vec2 const& screen_click, numarray<vec3> const& spheres_centers, float spheres_radius, camera_generic_base const& camera, camera_projection_perspective const& projection)` - Cast a ray through a screen position (normalized device coordinates) and return the closest hit among spheres of common radius, with its index, position and normal.
- `picking_structure picking_mesh_vertex_as_sphere(vec2 const& screen_click, numarray<vec3> const& vertex_position, numarray<vec3> const& vertex_normal, float picking_distance, camera_generic_base const& camera, camera_projection_perspective const& projection)` - Casts the camera ray through the screen position and returns the closest vertex whose sphere of radius picking_distance it hits, with the hit point, the vertex normal and the vertex index (active is false if none).
