/// <summary>
/// Update the MLCamera characteristics.
/// </summary>
/// <returns>
/// MLResult.Result will be <c>MLResult.Code.Ok</c> if obtained camera characteristic handle successfully.
/// MLResult.Result will be <c>MLResult.Code.InvalidParam</c> if failed to obtain camera characteristic handle due to invalid input parameter.
/// MLResult.Result will be <c>MLResult.Code.MediaGenericUnexpectedNull</c> if failed to capture raw image due to null pointer.
/// MLResult.Result will be <c>MLResult.Code.AllocFailed</c> if failed to allocate memory.
/// MLResult.Result will be <c>MLResult.Code.PrivilegeDenied</c> if a required permission is missing.
/// </returns>
internal MLResult PopulateCharacteristics()
{
MLResult.Code resultCode;
ulong cameraCharacteristicsHandle = MagicLeapNativeBindings.InvalidHandle;
resultCode = MLCameraNativeBindings.MLCameraGetCameraCharacteristics(ref cameraCharacteristicsHandle);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get camera characteristics for MLCamera. Reason: {0}", result);
return(result);
}
ulong controlAEModeCount = 0;
IntPtr controlAEAvailableModesData = IntPtr.Zero;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAEAvailableModes(cameraCharacteristicsHandle, ref controlAEAvailableModesData, ref controlAEModeCount);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get camera control AE available modes for MLCamera. Reason: {0}", result);
return(result);
}
this.ControlAEModesAvailable = new List <MLCamera.MetadataControlAEMode>();
int[] controlAEModeArray = new int[controlAEModeCount];
Marshal.Copy(controlAEAvailableModesData, controlAEModeArray, 0, (int)controlAEModeCount);
for (int i = 0; i < controlAEModeArray.Length; ++i)
{
this.ControlAEModesAvailable.Add((MLCamera.MetadataControlAEMode)controlAEModeArray[i]);
}
ulong colorCorrectionAberrationModeCount = 0;
IntPtr colorCorrectionAberrationModesData = IntPtr.Zero;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetColorCorrectionAvailableAberrationModes(cameraCharacteristicsHandle, ref colorCorrectionAberrationModesData, ref colorCorrectionAberrationModeCount);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get color correction aberration modes available for MLCamera. Reason: {0}", result);
return(result);
}
this.ColorCorrectionAberrationModesAvailable = new List <MLCamera.MetadataColorCorrectionAberrationMode>((int)colorCorrectionAberrationModeCount);
int[] aberrationModeArray = new int[colorCorrectionAberrationModeCount];
Marshal.Copy(colorCorrectionAberrationModesData, aberrationModeArray, 0, (int)colorCorrectionAberrationModeCount);
for (int i = 0; i < aberrationModeArray.Length; ++i)
{
this.ColorCorrectionAberrationModesAvailable.Add((MLCamera.MetadataColorCorrectionAberrationMode)aberrationModeArray[i]);
}
int[] compensationRange = new int[2];
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAECompensationRange(cameraCharacteristicsHandle, compensationRange);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get control AE compensation range. Reason: {0}", result);
return(result);
}
this.AECompensationRange = new AECompensationRangeValues(compensationRange[0], compensationRange[1]);
MLCameraNativeBindings.MLCameraMetadataRationalNative rational = new MLCameraNativeBindings.MLCameraMetadataRationalNative();
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAECompensationStep(cameraCharacteristicsHandle, ref rational);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get control AE compensation step. Reason: {0}", result);
return(result);
}
this.AECompensationStepNumerator = rational.Numerator;
this.AECompensationStepDenominator = rational.Denominator;
this.AECompensationStep = (float)this.AECompensationStepNumerator / (float)this.AECompensationStepDenominator;
float availableMaxDigitalZoom = 0.0f;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetScalerAvailableMaxDigitalZoom(cameraCharacteristicsHandle, ref availableMaxDigitalZoom);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get max available digital zoom. Reason: {0}", result);
return(result);
}
this.AvailableMaxDigitalZoom = availableMaxDigitalZoom;
int sensorOrientation = 0;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetSensorOrientation(cameraCharacteristicsHandle, ref sensorOrientation);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get sensor orientation. Reason: {0}", result);
return(result);
}
this.SensorOrientation = sensorOrientation;
MLCamera.MetadataControlAELock controlAELockAvailable = 0;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAELockAvailable(cameraCharacteristicsHandle, ref controlAELockAvailable);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get control AE lock available. Reason: {0}", result);
return(result);
}
this.ControlAELockAvailable = controlAELockAvailable;
ulong controlAWBModeCount = 0;
IntPtr controlAWBAvailableModesData = IntPtr.Zero;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAWBAvailableModes(cameraCharacteristicsHandle, ref controlAWBAvailableModesData, ref controlAWBModeCount);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get camera control ABW available modes for MLCamera. Reason: {0}", result);
return(result);
}
this.ControlAWBModesAvailable = new List <MLCamera.MetadataControlAWBMode>();
int[] awbModeArray = new int[controlAWBModeCount];
Marshal.Copy(controlAWBAvailableModesData, awbModeArray, 0, (int)controlAWBModeCount);
for (int i = 0; i < awbModeArray.Length; ++i)
{
this.ControlAWBModesAvailable.Add((MLCamera.MetadataControlAWBMode)awbModeArray[i]);
}
MLCamera.MetadataControlAWBLock controlAWBLockAvailable = 0;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetControlAWBLockAvailable(cameraCharacteristicsHandle, ref controlAWBLockAvailable);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get control AWB lock available. Reason: {0}", result);
return(result);
}
this.ControlAWBLockAvailable = controlAWBLockAvailable;
int[] sensorInfoActiveArraySize = new int[4];
resultCode = MLCameraNativeBindings.MLCameraMetadataGetSensorInfoActiveArraySize(cameraCharacteristicsHandle, sensorInfoActiveArraySize);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get sensor info active array size. Reason: {0}", result);
return(result);
}
this.SensorInfoActiveArraySize = new SensorInfoActiveArraySizeValues(
sensorInfoActiveArraySize[0],
sensorInfoActiveArraySize[1],
sensorInfoActiveArraySize[2],
sensorInfoActiveArraySize[3]);
ulong scalerProcessedSizesCount = 0;
IntPtr scalerProcessedSizesData = IntPtr.Zero;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetScalerProcessedSizes(cameraCharacteristicsHandle, ref scalerProcessedSizesData, ref scalerProcessedSizesCount);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get scaler processed sizes. Reason: {0}", result);
return(result);
}
int[] scalerProcessedSizesDataArray = new int[scalerProcessedSizesCount];
Marshal.Copy(scalerProcessedSizesData, scalerProcessedSizesDataArray, 0, (int)scalerProcessedSizesCount);
this.ScalerProcessedSizes = new List <ScalerProcessedSize>((int)scalerProcessedSizesCount);
for (int i = 0; i < (int)scalerProcessedSizesCount; i += 2)
{
int width = scalerProcessedSizesDataArray[i];
int height = scalerProcessedSizesDataArray[i + 1];
ScalerProcessedSize newSize = new ScalerProcessedSize(width, height);
this.ScalerProcessedSizes.Add(newSize);
}
ulong streamConfigurationsCount = 0;
IntPtr streamConfigurationsData = IntPtr.Zero;
resultCode = MLCameraNativeBindings.MLCameraMetadataGetScalerAvailableStreamConfigurations(cameraCharacteristicsHandle, ref streamConfigurationsData, ref streamConfigurationsCount);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get scaler available stream configurations. Reason: {0}", result);
return(result);
}
int[] streamConfigurationsDataArray = new int[streamConfigurationsCount];
Marshal.Copy(streamConfigurationsData, streamConfigurationsDataArray, 0, (int)streamConfigurationsCount);
this.ScalerAvailableStreamConfigurations = new List <StreamConfiguration>();
for (int i = 0; i < (int)streamConfigurationsCount; i += 4)
{
StreamConfiguration config = new StreamConfiguration(
(MLCamera.MetadataScalerAvailableFormats)streamConfigurationsDataArray[i],
streamConfigurationsDataArray[i + 1],
streamConfigurationsDataArray[i + 2],
(MLCamera.MetadataScalerAvailableStreamConfigurations)streamConfigurationsDataArray[i + 3]);
this.ScalerAvailableStreamConfigurations.Add(config);
}
int[] sensorInfoSensitivityRange = new int[2];
resultCode = MLCameraNativeBindings.MLCameraMetadataGetSensorInfoSensitivityRange(cameraCharacteristicsHandle, sensorInfoSensitivityRange);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get sensor info sensitivity range. Reason: {0}", result);
return(result);
}
this.SensorInfoSensitivityRange = new SensorInfoSensitivityRangeValues(sensorInfoSensitivityRange[0], sensorInfoSensitivityRange[1]);
long[] sensorInfoExposureTimeRange = new long[2];
resultCode = MLCameraNativeBindings.MLCameraMetadataGetSensorInfoExposureTimeRange(cameraCharacteristicsHandle, sensorInfoExposureTimeRange);
if (!MLResult.IsOK(resultCode))
{
MLResult result = MLResult.Create(resultCode);
MLPluginLog.ErrorFormat("MLCamera.GeneralSettings.PopulateCharacteristics failed to get sensor info exposure time range. Reason: {0}", result);
return(result);
}
this.SensorInfoExposureTimeRange = new SensorInfoExposureTimeRangeValues(sensorInfoExposureTimeRange[0], sensorInfoExposureTimeRange[1]);
return(MLResult.Create(MLResult.Code.Ok));
}