|
Camera Class Function Manual |
|
|
Camera Class Function Manual |
Purpose
To determine a correction of lens radial distortion at a given x y photo coordinate. This function compute a correction from the current lens distortion correction table of the camera, using linear interpolation.
The sign of the correction vector will be opposite to that in the distortion table.
Class
Camera
Usage
{Pt2D} ret = object.COR_RDD({double} argm1, {double} argm2)
argm1 = x photo coordinate at which correction to be determined
argm2 = y photo coordinate at which correction to be determined
Example:
|
->a = camera() ->cor = a.cor_rdd(10, -112) -> |
See also (class function)
vecrdd, pp
Purpose
To report the focal length of the cemera.
Class
Camera
Usage
{double} ret = object.FOCAL()
Example:
|
->c = cam.focal() -> |
See also (class function)
vecrdd, pp
Purpose
To report the offset of GPS receiver from the perspective center of the camera.
Class
Camera
Usage
{Pt3D} ret = object.GPSOFFSET()
Example:
|
->xyz = cam.gpsoffset() -> |
See also (class function)
vecrdd, pp
Purpose
To report the ID of the camera.
Class
Camera
Usage
{int} ret = object.ID()
Example:
|
->id = cam.id() -> |
See also (class function)
vecrdd, pp
Purpose
To initialize a camera object.
Class
Camera
Usage
{void} object.INIT({double} argm1, {VecIdPt2D} argm2)
argm1 = focal length of the camera
argm2 = a vector containing list of fiducial marks' ID and x y coordinates
Example:
|
->a = camera() |
See also (class function)
vecrdd, pp
Purpose
To load a Camera object saved as Noobeed format. It is actually a sort of documentation file, and it is an ASCII file.
If file name extension is omitted, the function will add default extension to the file. The default extension of the camera file is ".txt".
Unless the path name is given in the file names, the function will search for the files in the current working directory, defined by command "set path".
The detail structure of the documentation file is described in function "save".
Class
Camera
Usage
{void} object.LOAD({String} argm1)
argm1 = file name for the documentation file (default extension is ".txt")
Example:
|
->a = camera() ->a.load("cam_WILD_27568") -> |
See also (class function)
save
Purpose
To report the name of the camera.
Class
Camera
Usage
{String} ret = object.NAME()
Example:
|
->camera_name = cam.name() -> |
See also (class function)
vecrdd, pp
Purpose
To report the coordinate of the principal point, more correctly the calibrated principal point or principal point of symmetry PPS .
It should be mention that the coordinate of PPS might not be the same as that given in the camera documentation file, when a camera object is initialized. It will get change if the flying direction is not the same as the direction of the x axis of the fiducial mark coordinate system. More details are in Understanding Coordinate System.
Class
Camera
Usage
{Pt2D} ret = object.PP()
Example:
|
->xy_pp = cam.pp() -> |
See also (class function)
vecrdd
Purpose
To save a camera object as Noobeed format. The function creates one documentation files.
The documentation file will have an extension ".txt". It is actually an ASCII file and must have exactly 7or 8 lines (not including comment lines) , as below. When the lens distortion data are not given, the camera documentation file will have only 7 lines, otherwise 8 lines.
|
if a file name extension is not given, the function assumes an extension of ".txt".
if a path name is not include in the specified file name, the function will save the data in the current data path, set by command "set path".
Class
Camera
Usage
{void} object.SAVE({String} argm1)
argm1 = documentation file name
Example:
|
->cam.save("cam_WILD_27589") -> |
See also (class function)
load
Purpose
To report the coordinate of fiducial marks's IDs and coordinates, as a vector of IdPt2D object.
Class
Camera
Usage
{VecIdPt2D} ret = object.VECFIDUCIAL()
Example:
|
->v =
a.vecfiducial() |
See also (class function)
vecrdd
Purpose
To report lens radial distortions of the camera.
The radial distortion table is stored as a vector of 2D point objects, VecPt2D, in which x coordinate actually represents radial distance from the center of the photo and y coordinate represents the radial distortion at the particular radial distance.
Class
Camera
Usage
{VecIdPt2D} ret = object.VECFIDUCIAL()
Example:
|
->v = a.vecrdd() -> |
See also (class function)
cor_rdd