Lens Distortion Schemas#
Array defaults longer than three entries are truncated for display with .... Read the schema files shipped in the ovrtx package for the complete defaults.
API Schemas#
OmniLensDistortionFthetaAPI#
Defines properties for setting up a lensdistortion represented by the NVIDIA f-theta model.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “ftheta” |
|
Width of the calibrated sensor |
|
Height of the calibrated sensor |
|
|
|
|
|
|
|
|
|
|
|
|
|
OmniLensDistortionKannalaBrandtK3API#
Defines properties for setting up a lens distortion represented by Kannala-Brandt model.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “kannalaBrandtK3” |
|
Width of the calibrated sensor |
|
Height of the calibrated sensor |
|
|
|
|
|
|
|
|
|
|
|
OmniLensDistortionRadTanThinPrismAPI#
Defines properties for setting up a lensdistortion represented by a radial-tangent thin-prism model.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “radTanThinPrism” |
|
Width of the calibrated sensor |
|
Height of the calibrated sensor |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OmniLensDistortionLutAPI#
Defines lens distortion by a pre-generated lookup table, allowing any model to be mapped to the RTX camera by generating two lookup tables, one for the ray entering, one for the ray leaving, which are used by the renderer to transform rays entering or leaving the lens system.
Use the example script provided to see how to convert a custom lens model to the table format.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “lut” |
|
Width of the calibrated sensor |
|
Height of the calibrated sensor |
|
|
|
Lookup table stored as an RGB image file where each RGB pixel value is the XYZ direction of rays entering the lens system in local camera space. |
|
Lookup table stored as an RGB image file where each RG pixel value is the [0, 1] U,V coordinate in normalized screen space where the ray for that pixel is emitted from on the image plane. |
OmniLensDistortionOmniDirectionalStereoAPI#
Defines properties for Omni-Directional Stereo (ODS) camera projection. This schema configures a single-eye ODS camera. isLeftEye selects the eye: true = left eye, false = right eye. interpupillaryDistance (IPD, meters) sets eye separation, with symmetric offsets of -IPD/2 for left and +IPD/2 for right. A stereo ODS output can be composed from left/right eye cameras, commonly stacked vertically (top/bottom).
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “omniDirectionalStereo” |
|
Whether this camera represents the left eye in the stereo pair. |
|
Interpupillary distance (IPD), also known as distance between the eyes, in meters. |
OmniLensDistortionOpenCvFisheyeAPI#
Defines properties for applying the OpenCV fisheye model.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “opencvFisheye” |
|
Size of the image in pixels |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OmniLensDistortionOpenCvPinholeAPI#
Defines properties for applying the OpenCV pinhole model.
Inherits from: APISchemaBase
Can only apply to: Camera
Properties#
USD declaration |
Description |
|---|---|
|
Allowed tokens: “opencvPinhole” |
|
Size of the image in pixels |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|