Panda3D
Public Member Functions | Static Public Member Functions | Protected Member Functions

FisheyeLens Class Reference

A fisheye lens. More...

#include "fisheyeLens.h"

Inheritance diagram for FisheyeLens:
Lens TypedWritableReferenceCount TypedWritable ReferenceCount TypedObject MemoryBase MemoryBase

List of all members.

Public Member Functions

 FisheyeLens (const FisheyeLens &copy)
virtual TypeHandle force_init_type ()
virtual TypeHandle get_type () const
void operator= (const FisheyeLens &copy)
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.

Detailed Description

A fisheye lens.

This nonlinear lens introduces a spherical distortion to the image, which is minimal at small angles from the lens, and increases at larger angles from the lens. The field of view may extend to 360 degrees.

Definition at line 30 of file fisheyeLens.h.


Member Function Documentation

bool FisheyeLens::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 67 of file fisheyeLens.cxx.

References LVecBase2f::length().

Referenced by do_extrude_vec().

bool FisheyeLens::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 131 of file fisheyeLens.cxx.

References do_extrude().

bool FisheyeLens::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 160 of file fisheyeLens.cxx.

References LVecBase3f::length(), and LVecBase2f::normalize().

PN_stdfloat FisheyeLens::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 254 of file fisheyeLens.cxx.

PN_stdfloat FisheyeLens::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 226 of file fisheyeLens.cxx.

PN_stdfloat FisheyeLens::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 240 of file fisheyeLens.cxx.


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations