Output images can have an arbitrary aspect ratio. The output size and aspect ratio are requested by setting the output resolution (
- See also
- triclopsSetResolution() ). However, cameras are calibrated with a fixed aspect ratio. Therefore rectification is carried out by using an internal image with the same aspect ratio as that of the calibrated camera. The size of the internal image is determined to contain centrally the requested output size. An output image structure, with the requested aspect ratio, will be constructed by shallow copy from the internal image.
Retrieves the aspect ratio of the calibrated camera.
This function retrieves the aspect ratio ( the number of columns to rows ratio) of the calibrated camera.
- Parameters
-
context | The context which to retrieve the aspect ratio value from. |
aspectRatio | A pointer to the location containing the retrieved value of the aspect ratio. |
- Returns
- An error code representing the outcome of the function
- Return values
-
TriclopsErrorOk | The function completed successfully. |
TriclopsInvalidContext | The provided context is invalid |
Determines the optimal number of columns.
This function determines the optimal number of rectified cols as a function of the expected number of rows of the rectified image and the aspect ratio of the calibrated camera.
- Parameters
-
context | The context which to retrieve the aspect ratio value from. |
nrows | The chosen height of the resulting image |
ncols | The width computed using the camera's optimal aspect ratio and the given height |
- Returns
- An error code representing the outcome of the function
- Return values
-
TriclopsErrorOk | The function completed successfully. |
TriclopsInvalidContext | The provided context is invalid |
- See also
- triclopsGetCalAspectRatio()
-
triclopsGetOptimalNumRows()
Determines the optimal number of rows.
This function determines the optimal number of rectified rows as a function of the expected number of columns of the rectified image and the aspect ratio of the calibrated camera.
- Parameters
-
context | The context which to retrieve the aspect ratio from. |
ncols | The chosen width of the resulting image |
nrows | The height computed using the camera's optimal aspect ratio and the given width |
- Returns
- An error code representing the outcome of the function
- Return values
-
TriclopsErrorOk | The function completed successfully. |
TriclopsInvalidContext | The provided context is invalid |
- See also
- triclopsGetCalAspectRatio()
-
triclopsGetOptimalNumColumns()