CameraIntrinsics Class

Definition

Namespace:

Windows.Media.Devices.Core

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)]
/// [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)]
[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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

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.

See also

• Camera stream coordinate mapper sample
• Camera stream correlation sample