unreal.LiveLinkOpenTrackIOLens

class unreal.LiveLinkOpenTrackIOLens(custom: None = [], distortion: None = [], distortion_offset: LiveLinkOpenTrackIOLens_DistortionOffset = Ellipsis, encoders: LiveLinkOpenTrackIOLens_Encoders = Ellipsis, entrance_pupil_offset: float = 0.0, exposure_falloff: LiveLinkOpenTrackIOLens_ExposureFalloff = Ellipsis, f_stop: OpenTrackIOOptionalFloat = Ellipsis, pinhole_focal_length: OpenTrackIOOptionalFloat = Ellipsis, focus_distance: OpenTrackIOOptionalFloat = Ellipsis, projection_offset: LiveLinkOpenTrackIOLens_DistortionOffset = Ellipsis, raw_encoders: LiveLinkOpenTrackIOLens_RawEncoders = Ellipsis, t_stop: OpenTrackIOOptionalFloat = Ellipsis)

Bases: StructBase

Live Link Open Track IOLens

C++ Source:

  • Plugin: LiveLinkOpenTrackIO

  • Module: LiveLinkOpenTrackIO

  • File: LiveLinkOpenTrackIOTypes.h

Editor Properties: (see get_editor_property/set_editor_property)

  • custom (Array[float]): [Read-Write] This list provides optional additional custom coefficients that can extend the existing lens model. The meaning of and how these characteristics are to be applied to a virtual camera would require negotiation between a particular producer and consumer.

  • distortion (Array[LiveLinkOpenTrackIOLens_DistortionCoeff]): [Read-Write] A list of Distortion objects that each define the coefficients for calculating the distortion characteristics of a lens comprising radial distortion coefficients of the spherical distortion (k1-N) and (optionally) the tangential distortion (p1-N). The key ’model’ names the distortion model. Typical values for ’model’ include “Brown-Conrady D-U” when mapping distorted to undistorted coordinates, and “Brown-Conrady U-D” when mapping undistorted to undistorted coordinates. If not provided, the default model is “Brown-Conrady D-U”.

  • distortion_offset (LiveLinkOpenTrackIOLens_DistortionOffset): [Read-Write] Offset in x and y of the centre of distortion of the virtual camera in millimeter

  • encoders (LiveLinkOpenTrackIOLens_Encoders): [Read-Write] Normalised real numbers (0-1) for focus, iris and zoom

  • entrance_pupil_offset (float): [Read-Write] Offset of the entrance pupil relative to the nominal imaging plane (positive if the entrance pupil is located on the side of the nominal imaging plane that is towards the object, and negative otherwise). Measured in meters as in a render engine it is often applied in the virtual camera’s transform chain.

  • exposure_falloff (LiveLinkOpenTrackIOLens_ExposureFalloff): [Read-Write] Coefficients for calculating the exposure fall-off (vignetting) of a lens

  • f_stop (OpenTrackIOOptionalFloat): [Read-Write] The linear f-number of the lens, equal to the focal length divided by the diameter of the entrance pupil.

  • focus_distance (OpenTrackIOOptionalFloat): [Read-Write] Focus distance/position of the lens in meters.

  • pinhole_focal_length (OpenTrackIOOptionalFloat): [Read-Write] Distance between the pinhole and the image plane in the simple CGI pinhole camera model. (millimeters)

  • projection_offset (LiveLinkOpenTrackIOLens_DistortionOffset): [Read-Write] Offset in x and y of the centre of perspective projection of the virtual camera

  • raw_encoders (LiveLinkOpenTrackIOLens_RawEncoders): [Read-Write] Raw encoder values.

  • t_stop (OpenTrackIOOptionalFloat): [Read-Write] T-stop: Linear t-number of the lens, equal to the F-number of the lens divided by the square root of the transmittance of the lens.

property custom: None

[Read-Write] This list provides optional additional custom coefficients that can extend the existing lens model. The meaning of and how these characteristics are to be applied to a virtual camera would require negotiation between a particular producer and consumer.

Type:

(Array[float])

property distortion: None

[Read-Write] A list of Distortion objects that each define the coefficients for calculating the distortion characteristics of a lens comprising radial distortion coefficients of the spherical distortion (k1-N) and (optionally) the tangential distortion (p1-N). The key ’model’ names the distortion model. Typical values for ’model’ include “Brown-Conrady D-U” when mapping distorted to undistorted coordinates, and “Brown-Conrady U-D” when mapping undistorted to undistorted coordinates. If not provided, the default model is “Brown-Conrady D-U”.

Type:

(Array[LiveLinkOpenTrackIOLens_DistortionCoeff])

property distortion_offset: LiveLinkOpenTrackIOLens_DistortionOffset

[Read-Write] Offset in x and y of the centre of distortion of the virtual camera in millimeter

Type:

(LiveLinkOpenTrackIOLens_DistortionOffset)

property encoders: LiveLinkOpenTrackIOLens_Encoders

[Read-Write] Normalised real numbers (0-1) for focus, iris and zoom

Type:

(LiveLinkOpenTrackIOLens_Encoders)

property entrance_pupil_offset: float

[Read-Write] Offset of the entrance pupil relative to the nominal imaging plane (positive if the entrance pupil is located on the side of the nominal imaging plane that is towards the object, and negative otherwise). Measured in meters as in a render engine it is often applied in the virtual camera’s transform chain.

Type:

(float)

property exposure_falloff: LiveLinkOpenTrackIOLens_ExposureFalloff

[Read-Write] Coefficients for calculating the exposure fall-off (vignetting) of a lens

Type:

(LiveLinkOpenTrackIOLens_ExposureFalloff)

property f_stop: OpenTrackIOOptionalFloat

[Read-Write] The linear f-number of the lens, equal to the focal length divided by the diameter of the entrance pupil.

Type:

(OpenTrackIOOptionalFloat)

property focus_distance: OpenTrackIOOptionalFloat

[Read-Write] Focus distance/position of the lens in meters.

Type:

(OpenTrackIOOptionalFloat)

property pinhole_focal_length: OpenTrackIOOptionalFloat

[Read-Write] Distance between the pinhole and the image plane in the simple CGI pinhole camera model. (millimeters)

Type:

(OpenTrackIOOptionalFloat)

property projection_offset: LiveLinkOpenTrackIOLens_DistortionOffset

[Read-Write] Offset in x and y of the centre of perspective projection of the virtual camera

Type:

(LiveLinkOpenTrackIOLens_DistortionOffset)

property raw_encoders: LiveLinkOpenTrackIOLens_RawEncoders

[Read-Write] Raw encoder values.

Type:

(LiveLinkOpenTrackIOLens_RawEncoders)

property t_stop: OpenTrackIOOptionalFloat

Linear t-number of the lens, equal to the F-number of the lens divided by the square root of the transmittance of the lens.

Type:

(OpenTrackIOOptionalFloat)

Type:

[Read-Write] T-stop