Panda3D
|
A cylindrical lens. More...
#include "cylindricalLens.h"
Public Member Functions | |
CylindricalLens (const CylindricalLens ©) | |
virtual TypeHandle | force_init_type () |
virtual TypeHandle | get_type () const |
void | operator= (const CylindricalLens ©) |
virtual | PT (Lens) make_copy() const |
Static Public Member Functions | |
static TypeHandle | get_class_type () |
static void | init_type () |
Protected Member Functions | |
virtual bool | do_extrude (const Lens::CData *lens_cdata, const LPoint3 &point2d, LPoint3 &near_point, LPoint3 &far_point) const |
Given a 2-d point in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner, compute the corresponding vector in space that maps to this point, if such a vector can be determined. | |
virtual bool | do_extrude_vec (const Lens::CData *lens_cdata, const LPoint3 &point2d, LVector3 &vec) const |
Given a 2-d point in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner, compute the vector that corresponds to the view direction. | |
virtual bool | do_project (const Lens::CData *lens_cdata, const LPoint3 &point3d, LPoint3 &point2d) const |
Given a 3-d point in space, determine the 2-d point this maps to, in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner. | |
virtual PN_stdfloat | film_to_fov (PN_stdfloat film_size, PN_stdfloat focal_length, bool horiz) const |
Given a width (or height) on the film and a focal length, compute the field of view in degrees. | |
virtual PN_stdfloat | fov_to_film (PN_stdfloat fov, PN_stdfloat focal_length, bool horiz) const |
Given a field of view in degrees and a focal length, compute the correspdonding width (or height) on the film. | |
virtual PN_stdfloat | fov_to_focal_length (PN_stdfloat fov, PN_stdfloat film_size, bool horiz) const |
Given a field of view in degrees and a width (or height) on the film, compute the focal length of the lens. |
A cylindrical lens.
This is the kind of lens generally used for extremely wide panoramic shots. It behaves like a normal perspective lens in the vertical direction, but it is non-linear in the horizontal dimension: a point on the film corresponds to a point in space in linear proportion to its angle to the camera, not to its straight-line distance from the center.
This allows up to 360 degree lenses in the horizontal dimension, with relatively little distortion. The distortion is not very apparent between two relatively nearby points on the film, but it becomes increasingly evident as you compare points widely spaced on the film.
Definition at line 40 of file cylindricalLens.h.
bool CylindricalLens::do_extrude | ( | const Lens::CData * | lens_cdata, |
const LPoint3 & | point2d, | ||
LPoint3 & | near_point, | ||
LPoint3 & | far_point | ||
) | const [protected, virtual] |
Given a 2-d point in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner, compute the corresponding vector in space that maps to this point, if such a vector can be determined.
The vector is returned by indicating the points on the near plane and far plane that both map to the indicated 2-d point.
The z coordinate of the 2-d point is ignored.
Returns true if the vector is defined, or false otherwise.
Reimplemented from Lens.
Definition at line 54 of file cylindricalLens.cxx.
bool CylindricalLens::do_extrude_vec | ( | const Lens::CData * | lens_cdata, |
const LPoint3 & | point2d, | ||
LVector3 & | vec | ||
) | const [protected, virtual] |
Given a 2-d point in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner, compute the vector that corresponds to the view direction.
This will be parallel to the normal on the surface (the far plane) corresponding to the lens shape at this point.
See the comment block on Lens::extrude_vec_impl() for a more in-depth comment on the meaning of this vector.
The z coordinate of the 2-d point is ignored.
Returns true if the vector is defined, or false otherwise.
Reimplemented from Lens.
Definition at line 100 of file cylindricalLens.cxx.
bool CylindricalLens::do_project | ( | const Lens::CData * | lens_cdata, |
const LPoint3 & | point3d, | ||
LPoint3 & | point2d | ||
) | const [protected, virtual] |
Given a 3-d point in space, determine the 2-d point this maps to, in the range (-1,1) in both dimensions, where (0,0) is the center of the lens and (-1,-1) is the lower-left corner.
Some lens types also set the z coordinate of the 2-d point to a value in the range (-1, 1), where 1 represents a point on the near plane, and -1 represents a point on the far plane.
Returns true if the 3-d point is in front of the lens and within the viewing frustum (in which case point2d is filled in), or false otherwise.
Reimplemented from Lens.
Definition at line 133 of file cylindricalLens.cxx.
References LVecBase2f::length().
PN_stdfloat CylindricalLens::film_to_fov | ( | PN_stdfloat | film_size, |
PN_stdfloat | focal_length, | ||
bool | horiz | ||
) | const [protected, virtual] |
Given a width (or height) on the film and a focal length, compute the field of view in degrees.
If horiz is true, this is in the horizontal direction; otherwise, it is in the vertical direction (some lenses behave differently in each direction).
Reimplemented from Lens.
Definition at line 218 of file cylindricalLens.cxx.
PN_stdfloat CylindricalLens::fov_to_film | ( | PN_stdfloat | fov, |
PN_stdfloat | focal_length, | ||
bool | horiz | ||
) | const [protected, virtual] |
Given a field of view in degrees and a focal length, compute the correspdonding width (or height) on the film.
If horiz is true, this is in the horizontal direction; otherwise, it is in the vertical direction (some lenses behave differently in each direction).
Reimplemented from Lens.
Definition at line 182 of file cylindricalLens.cxx.
PN_stdfloat CylindricalLens::fov_to_focal_length | ( | PN_stdfloat | fov, |
PN_stdfloat | film_size, | ||
bool | horiz | ||
) | const [protected, virtual] |
Given a field of view in degrees and a width (or height) on the film, compute the focal length of the lens.
If horiz is true, this is in the horizontal direction; otherwise, it is in the vertical direction (some lenses behave differently in each direction).
Reimplemented from Lens.
Definition at line 200 of file cylindricalLens.cxx.