Version: 2021.2
LanguageEnglish
  • C#

PhotoCaptureFrame.TryGetProjectionMatrix

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public bool TryGetProjectionMatrix(float nearClipPlane, float farClipPlane, out Matrix4x4 projectionMatrix);

Declaration

public bool TryGetProjectionMatrix(out Matrix4x4 projectionMatrix);

Parameters

nearClipPlane The near clip plane distance.
farClipPlane The far clip plane distance.
projectionMatrix A matrix to be populated by the Projection Matrix.

Returns

bool True if a valid matrix is returned or false otherwise. This will be false if the frame has no location data.

Description

This method will return the projection matrix at the time the photo was captured if location data if available.

If the near and far clip values are not specified, then the projection matrix returned will be the raw HoloLens projection matrix. However if the near and far clip values are provided, they will be encoded into the returned projection matrix. The provided near and far clip values will be validated prior to encoding them into the projection matrix. The near clip value will be set to 0.01 if the provided value is less than 0.01. Likewise, if the far clip value is less than the near clip value then the far clip value will be set to the near clip value plus 0.01.

If location data is unavailable then the projection matrix will be set to the identity matrix.