M-File Help: CatadioptricCamera View code for CatadioptricCamera

CatadioptricCamera

Catadioptric camera class

A concrete class for a catadioptric camera, subclass of Camera.

Methods

project project world points to image plane
plot plot/return world point on image plane
hold control hold for image plane
ishold test figure hold for image plane
clf clear image plane
figure figure holding the image plane
mesh draw shape represented as a mesh
point draw homogeneous points on image plane
line draw homogeneous lines on image plane
plot_camera draw camera
rpy set camera attitude
move copy of Camera after motion
centre get world coordinate of camera centre
delete object destructor
char convert camera parameters to string
display display camera parameters

Properties (read/write)

npix image dimensions in pixels (2x1)
pp intrinsic: principal point (2x1)
rho intrinsic: pixel dimensions (2x1) [metres]
f intrinsic: focal length [metres]
p intrinsic: tangential distortion parameters
T extrinsic: camera pose as homogeneous transformation

Properties (read only)

nu number of pixels in u-direction
nv number of pixels in v-direction
u0 principal point u-coordinate
v0 principal point v-coordinate

Notes

See also

CentralCamera, Camera


CatadioptricCamera.CatadioptricCamera

Create central projection camera object

C = CatadioptricCamera() creates a central projection camera with canonic parameters: f=1 and name='canonic'.

C = CatadioptricCamera(options) as above but with specified parameters.

Options

'name', N Name of camera
'focal', F Focal length (metres)
'default' Default camera parameters: 1024x1024, f=8mm, 10um pixels, camera at origin, optical axis is z-axis, u- and v-axes parallel to x- and y-axes respectively.
'projection', M Catadioptric model: 'equiangular' (default), 'sine', 'equisolid', 'stereographic'
'k', K Parameter for the projection model
'maxangle', A The maximum viewing angle above the horizontal plane.
'resolution', N Image plane resolution: NxN or N=[W H].
'sensor', S Image sensor size in metres (2x1)
'centre', P Principal point (2x1)
'pixel', S Pixel size: SxS or S=[W H].
'noise', SIGMA Standard deviation of additive Gaussian noise added to returned image projections
'pose', T Pose of the camera as a homogeneous transformation

Notes

See also

Camera, fisheyecamera, CatadioptricCamera, SphericalCamera


CatadioptricCamera.project

Project world points to image plane

uv = C.project(p, options) are the image plane coordinates for the world points p. The columns of p (3xN) are the world points and the columns of uv (2xN) are the corresponding image plane points.

Options

'Tobj', T Transform all points by the homogeneous transformation T before projecting them to the camera image plane.
'Tcam', T Set the camera pose to the homogeneous transformation T before projecting points to the camera image plane. Temporarily overrides the current camera pose C.T.

See also

Camera.plot


 

© 1990-2012 Peter Corke.