CameraIntrinsics Class

Definition

Represents the intrinsics that describe the camera distortion model.

public ref class CameraIntrinsics sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CameraIntrinsics final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Devices.Core.ICameraIntrinsicsFactory, 458752, "Windows.Foundation.UniversalApiContract")]
class CameraIntrinsics final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CameraIntrinsics
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Devices.Core.ICameraIntrinsicsFactory), 458752, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraIntrinsics
function CameraIntrinsics(focalLength, principalPoint, radialDistortion, tangentialDistortion, imageWidth, imageHeight)
Public NotInheritable Class CameraIntrinsics
Inheritance
Object Platform::Object IInspectable CameraIntrinsics
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Version history

Windows version SDK version Value added
1607 14393 DistortPoint
1607 14393 DistortPoints
1607 14393 UndistortedProjectionTransform
1607 14393 UndistortPoint
1607 14393 UndistortPoints

Constructors

CameraIntrinsics(Vector2, Vector2, Vector3, Vector2, UInt32, UInt32)

Constructs an instance of a CameraIntrinsics.

Properties

FocalLength

Gets the focal length of the camera.

ImageHeight

Gets the image height of the camera, in pixels.

ImageWidth

Gets the image width of the camera, in pixels.

PrincipalPoint

Gets the principal point of the camera.

RadialDistortion

Gets the radial distortion coefficient of the camera.

TangentialDistortion

Gets the tangential distortion coefficient of the camera.

UndistortedProjectionTransform

Gets a matrix that transforms a 2D coordinate in meters on the image plane to video frame pixel coordinates without compensating for the distortion model of the camera. The 2D point resulting from this transformation will not accurately map to the pixel coordinate in a video frame unless the app applies its own distortion compensation. This is useful for apps that choose to implement GPU-based distortion compensation instead of using UndistortPoint, which uses the CPU to compute the distortion compensation.

Methods

DistortPoint(Point)

Applies the distortion model of the camera to an undistorted point so that the resulting point's location is distorted as if it were captured by the camera's lens.

DistortPoints(Point[], Point[])

Applies the distortion model of the camera to an array of undistorted points so that the resulting points' locations are distorted as if they were captured by the camera's lens.

ProjectManyOntoFrame(Vector3[], Point[])

Projects an array of camera space points into screen space pixel coordinates.

ProjectOntoFrame(Vector3)

Projects a camera space point into screen space pixel coordinates.

UndistortPoint(Point)

Transforms a point to compensate for the distortion model of the camera, resulting in an undistorted point.

UndistortPoints(Point[], Point[])

Transforms an array of points to compensate for the distortion model of the camera, resulting in an array of undistorted points.

UnprojectAtUnitDepth(Point)

Unprojects pixel coordinates into a camera space ray from the camera origin, expressed as a X, Y coordinates on a plane one meter from the camera.

UnprojectPixelsAtUnitDepth(Point[], Vector2[])

Unprojects an array of pixel coordinates into an array of camera space rays from the camera origin, expressed as a X, Y coordinates on a plane one meter from the camera.

Applies to

See also