internal static void SetRotation(this MmalCameraComponent camera, int rotation)
{
var rot = ((rotation % 360) / 90) * 90;
MmalLog.Logger.LogDebug($"Setting rotation: {rot}");
camera.StillPort.SetParameter(MmalParameterRotation, rot);
}
internal static void SetDrc(this MmalCameraComponent camera, MmalParameterDrcStrengthType strength)
{
var drc = new MmalParameterDrcType(
new MmalParameterHeaderType(MmalParameterDynamicRangeCompression, Marshal.SizeOf <MmalParameterDrcType>()),
strength);
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &drc.Hdr), "Unable to set DRC");
}
public Camera()
{
BcmHost.Initialize();
_camera = new MmalCameraComponent();
_cameraDisposables = new List <IDisposable>();
CurrentState = new CurrentState(_camera);
}
internal static void SetFlips(this MmalCameraComponent camera, MmalParamMirrorType flips)
{
var mirror = new MmalParameterMirrorType(
new MmalParameterHeaderType(MmalParameterMirror, Marshal.SizeOf <MmalParameterMirrorType>()),
flips);
MmalCheck(MmalPort.SetParameter(camera.StillPort.Ptr, &mirror.Hdr), "Unable to set flips");
MmalCheck(MmalPort.SetParameter(camera.VideoPort.Ptr, &mirror.Hdr), "Unable to set flips");
}
internal static void SetSensorMode(this MmalCameraComponent camera)
{
var currentMode = (int)camera.Control.GetParameter(MmalParameterCameraCustomSensorConfig);
// Don't try and set the sensor mode if we aren't changing it.
if (currentMode != 0 || CameraConfig.SensorMode != 0)
{
camera.Control.SetParameter(MmalParameterCameraCustomSensorConfig, CameraConfig.SensorMode);
}
}
internal static void SetImageFx(this MmalCameraComponent camera, MmalParamImagefxType imageFx)
{
MmalLog.Logger.LogDebug($"Setting Image FX: {imageFx}");
var imgFx = new MmalParameterImageFxType(
new MmalParameterHeaderType(MmalParameterImageEffect, Marshal.SizeOf <MmalParameterImageFxType>()),
imageFx);
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &imgFx.Hdr), "Unable to set image fx");
}
internal static void SetAwbMode(this MmalCameraComponent camera, MmalParamAwbmodeType mode)
{
MmalLog.Logger.LogDebug($"Setting AWB mode: {mode}");
var awbMode = new MmalParameterAwbModeType(
new MmalParameterHeaderType(MmalParameterAwbMode, Marshal.SizeOf <MmalParameterAwbModeType>()),
mode);
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &awbMode.Hdr), "Unable to set awb mode");
}
internal static void SetExposureMeteringMode(this MmalCameraComponent camera, MmalParamExposuremeteringmodeType mode)
{
MmalLog.Logger.LogDebug($"Setting exposure metering mode: {mode}");
var expMode = new MmalParameterExposuremeteringmodeType(
new MmalParameterHeaderType(MmalParameterExpMeteringMode, Marshal.SizeOf <MmalParameterExposuremeteringmodeType>()),
mode);
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &expMode.Hdr), "Unable to set exposure metering mode");
}
internal static void SetShutterSpeed(this MmalCameraComponent camera, int speed)
{
MmalLog.Logger.LogDebug($"Setting shutter speed: {speed}");
if (speed > 6000000)
{
MmalLog.Logger.LogWarning("Shutter speed exceeds upper supported limit of 6000ms. Undefined behaviour may result.");
}
camera.Control.SetParameter(MmalParameterShutterSpeed, speed);
}
internal static void SetAnalogGain(this MmalCameraComponent camera, double analogGain)
{
if (analogGain > 0 && (analogGain < 1.0 || analogGain > 8.0))
{
throw new ArgumentOutOfRangeException(nameof(analogGain), "Invalid analog gain settings. Value must be between 1.0 and 8.0.");
}
var num = (int)analogGain * 65536;
camera.Control.SetParameter(MmalParameterAnalogGain, new MmalRational(num, 65536));
}
internal static void SetExposureCompensation(this MmalCameraComponent camera, int expCompensation)
{
MmalLog.Logger.LogDebug($"Setting exposure compensation: {expCompensation}");
if (expCompensation < -10 || expCompensation > 10)
{
throw new ArgumentOutOfRangeException(nameof(expCompensation), expCompensation, "Invalid exposure compensation value. Valid values (-10 - 10)");
}
camera.Control.SetParameter(MmalParameterExposureComp, expCompensation);
}
internal static void SetDigitalGain(this MmalCameraComponent camera, double digitalGain)
{
if (digitalGain > 0 && (digitalGain < 1.0 || digitalGain > 255.0))
{
throw new ArgumentOutOfRangeException(nameof(digitalGain), "Invalid digital gain settings. Value must be between 1.0 and 255.0.");
}
var num = (int)digitalGain * 65536;
camera.Control.SetParameter(MmalParameterDigitalGain, new MmalRational(num, 65536));
}
internal static void SetIso(this MmalCameraComponent camera, int iso)
{
MmalLog.Logger.LogDebug($"Setting Iso: {iso}");
// 0 = auto
if ((iso < 100 || iso > 800) && iso > 0)
{
throw new ArgumentOutOfRangeException(nameof(iso), iso, "Invalid Iso setting. Valid values: 100 - 800");
}
camera.Control.SetParameter(MmalParameterIso, iso);
}
internal static void SetZoom(this MmalCameraComponent camera, Zoom rect)
{
if (rect.X > 1.0 || rect.Y > 1.0 || rect.Height > 1.0 || rect.Width > 1.0)
{
throw new ArgumentOutOfRangeException(nameof(rect), "Invalid zoom settings. Value mustn't be greater than 1.0");
}
var crop = new MmalParameterInputCropType(
new MmalParameterHeaderType(MmalParameterInputCrop, Marshal.SizeOf <MmalParameterInputCropType>()),
new MmalRect(Convert.ToInt32(65536 * rect.X), Convert.ToInt32(65536 * rect.Y), Convert.ToInt32(65536 * rect.Width), Convert.ToInt32(65536 * rect.Height)));
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &crop.Hdr), "Unable to set zoom");
}
internal static void SetColourFx(this MmalCameraComponent camera, ColorEffects colorFx)
{
MmalLog.Logger.LogDebug("Setting colour effects");
var(_, u, v) = MmalColor.RgbToYuvBytes(colorFx.Color);
var colFx = new MmalParameterColorFxType(
new MmalParameterHeaderType(MmalParameterColorEffect, Marshal.SizeOf <MmalParameterColorFxType>()),
colorFx.Enable ? 1 : 0,
u,
v);
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &colFx.Hdr), "Unable to set colour fx");
}
internal static void SetSharpness(this MmalCameraComponent camera, int sharpness)
{
MmalLog.Logger.LogDebug($"Setting sharpness: {sharpness}");
var value = new MmalRational(sharpness, 100);
if (sharpness >= -100 && sharpness <= 100)
{
camera.Control.SetParameter(MmalParameterSharpness, value);
}
else
{
throw new Exception("Invalid sharpness value");
}
}
internal static void SetBrightness(this MmalCameraComponent camera, int brightness)
{
MmalLog.Logger.LogDebug($"Setting brightness: {brightness}");
var value = new MmalRational(brightness, 100);
if (brightness >= 0 && brightness <= 100)
{
camera.Control.SetParameter(MmalParameterBrightness, value);
}
else
{
throw new Exception("Invalid brightness value");
}
}
internal static void SetSaturation(this MmalCameraComponent camera, int saturation)
{
MmalLog.Logger.LogDebug($"Setting saturation: {saturation}");
var value = new MmalRational(saturation, 100);
if (saturation >= -100 && saturation <= 100)
{
camera.Control.SetParameter(MmalParameterSaturation, value);
}
else
{
throw new Exception("Invalid saturation value");
}
}
internal static void SetContrast(this MmalCameraComponent camera, int contrast)
{
MmalLog.Logger.LogDebug($"Setting contrast: {contrast}");
var value = new MmalRational(contrast, 100);
if (contrast >= -100 && contrast <= 100)
{
camera.Control.SetParameter(MmalParameterContrast, value);
}
else
{
throw new Exception("Invalid contrast value");
}
}
internal static void SetAwbGains(this MmalCameraComponent camera, double rGain, double bGain)
{
MmalLog.Logger.LogDebug($"Setting AWB gains: {rGain}, {bGain}");
if (CameraConfig.AwbMode != MmalParamAwbmodeType.MmalParamAwbmodeOff && (rGain > 0 || bGain > 0))
{
throw new PiCameraError("AWB Mode must be off when setting AWB gains");
}
var awbGains = new MmalParameterAwbGainsType(
new MmalParameterHeaderType(MmalParameterCustomAwbGains, Marshal.SizeOf <MmalParameterAwbGainsType>()),
new MmalRational((int)(rGain * 65536), 65536),
new MmalRational((int)(bGain * 65536), 65536));
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &awbGains.Hdr), "Unable to set awb gains");
}
internal static uint GetIso(this MmalCameraComponent camera)
{
return(camera.Control.GetParameter(MmalParameterIso));
}
internal static uint GetShutterSpeed(this MmalCameraComponent camera)
{
return(camera.Control.GetParameter(MmalParameterShutterSpeed));
}
internal static double GetDigitalGain(this MmalCameraComponent camera)
{
return(camera.Control.GetParameter(MmalParameterDigitalGain));
}
internal static double GetAnalogGain(this MmalCameraComponent camera)
{
return((double)camera.Control.GetParameter(MmalParameterAnalogGain));
}
internal static void SetVideoStabilisation(this MmalCameraComponent camera, bool vstabilisation)
{
MmalLog.Logger.LogDebug($"Setting video stabilisation: {vstabilisation}");
camera.Control.SetParameter(MmalParameterVideoStabilisation, vstabilisation);
}
internal static void SetBurstMode(this MmalCameraComponent camera, bool burstMode)
{
camera.StillPort.SetParameter(MmalParameterCameraBurstCapture, burstMode);
}
internal static void SetStatsPass(this MmalCameraComponent camera, bool statsPass)
{
camera.Control.SetParameter(MmalParameterCaptureStatsPass, statsPass);
}
internal static void SetCameraConfig(this MmalCameraComponent camera, MmalParameterCameraConfigType value)
{
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, &value.Hdr), "Unable to set camera config.");
}
internal CurrentState(MmalCameraComponent camera)
{
_camera = camera;
}
internal static void SetAnnotateSettings(this MmalCameraComponent camera)
{
if (CameraConfig.Annotate == null)
{
return;
}
var sb = new StringBuilder();
var showShutter = 0;
var showAnalogGain = 0;
var showLens = 0;
var showCaf = 0;
var showMotion = 0;
var showFrame = 0;
var enableTextBackground = 0;
var customTextColor = 0;
var customTextY = (byte)0;
var customTextU = (byte)0;
var customTextV = (byte)0;
var customBackgroundColor = 0;
var customBackgroundY = (byte)0;
var customBackgroundU = (byte)0;
var customBackgroundV = (byte)0;
var justify = CameraConfig.Annotate.Justify;
var xOffset = CameraConfig.Annotate.XOffset;
var yOffset = CameraConfig.Annotate.YOffset;
if (!string.IsNullOrEmpty(CameraConfig.Annotate.CustomText))
{
sb.Append(CameraConfig.Annotate.CustomText + " ");
}
if (CameraConfig.Annotate.ShowDateText)
{
sb.Append(DateTime.Now.ToString(CameraConfig.Annotate.DateFormat) + " ");
}
if (CameraConfig.Annotate.ShowTimeText)
{
sb.Append(DateTime.Now.ToString(CameraConfig.Annotate.TimeFormat) + " ");
}
if (CameraConfig.Annotate.ShowShutterSettings)
{
showShutter = 1;
}
if (CameraConfig.Annotate.ShowGainSettings)
{
showAnalogGain = 1;
}
if (CameraConfig.Annotate.ShowLensSettings)
{
showLens = 1;
}
if (CameraConfig.Annotate.ShowCafSettings)
{
showCaf = 1;
}
if (CameraConfig.Annotate.ShowMotionSettings)
{
showMotion = 1;
}
if (CameraConfig.Annotate.ShowFrameNumber)
{
showFrame = 1;
}
if (CameraConfig.Annotate.AllowCustomBackgroundColour)
{
enableTextBackground = 1;
}
var textSize = Convert.ToByte(CameraConfig.Annotate.TextSize);
if (CameraConfig.Annotate.TextColour != Color.Empty)
{
customTextColor = 1;
var(y, u, v) = MmalColor.RgbToYuvBytes(CameraConfig.Annotate.TextColour);
customTextY = y;
customTextU = u;
customTextV = v;
}
if (CameraConfig.Annotate.BgColour != Color.Empty)
{
customBackgroundColor = 1;
var(y, u, v) = MmalColor.RgbToYuvBytes(CameraConfig.Annotate.BgColour);
customBackgroundY = y;
customBackgroundU = u;
customBackgroundV = v;
}
// .NET Core has an issue with marshalling arrays "ByValArray". The array being passed MUST equal the size
// specified in the "SizeConst" field or you will receive an exception. Mono does not have this restriction
// and is quite happy to pass an array of a lower size if asked. In order to get around this, I am creating
// an array equaling "SizeConst" and copying the contents of the annotation text into it, minus the EOL character.
var text = sb.ToString() + char.MinValue;
var arr = new byte[MmalCameraAnnotateMaxTextLenV3];
var bytes = Encoding.ASCII.GetBytes(text);
Array.Copy(bytes, arr, bytes.Length);
var strV4 = new MmalParameterCameraAnnotateV4Type(
new MmalParameterHeaderType(MmalParameterAnnotate, Marshal.SizeOf <MmalParameterCameraAnnotateV4Type>() + (arr.Length - 1)),
1, showShutter, showAnalogGain, showLens,
showCaf, showMotion, showFrame, enableTextBackground,
customBackgroundColor, customBackgroundY, customBackgroundU, customBackgroundV, 0, customTextColor,
customTextY, customTextU, customTextV, textSize, arr, (int)justify, xOffset, yOffset);
var ptrV4 = Marshal.AllocHGlobal(Marshal.SizeOf <MmalParameterCameraAnnotateV4Type>() + (arr.Length - 1));
Marshal.StructureToPtr(strV4, ptrV4, false);
try
{
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, (MmalParameterHeaderType *)ptrV4), "Unable to set annotate");
}
catch
{
Marshal.FreeHGlobal(ptrV4);
ptrV4 = IntPtr.Zero;
MmalLog.Logger.LogWarning("Unable to set V4 annotation structure. Trying V3. Please update firmware to latest version.");
var str = new MmalParameterCameraAnnotateV3Type(
new MmalParameterHeaderType(MmalParameterAnnotate, Marshal.SizeOf <MmalParameterCameraAnnotateV3Type>() + (arr.Length - 1)),
1, showShutter, showAnalogGain, showLens,
showCaf, showMotion, showFrame, enableTextBackground,
customBackgroundColor, customBackgroundY, customBackgroundU, customBackgroundV, 0, customTextColor,
customTextY, customTextU, customTextV, textSize, arr);
var ptr = Marshal.AllocHGlobal(Marshal.SizeOf <MmalParameterCameraAnnotateV3Type>() + (arr.Length - 1));
Marshal.StructureToPtr(str, ptr, false);
try
{
MmalCheck(MmalPort.SetParameter(camera.Control.Ptr, (MmalParameterHeaderType *)ptr), "Unable to set annotate V3.");
}
finally
{
Marshal.FreeHGlobal(ptr);
}
}
finally
{
if (ptrV4 != IntPtr.Zero)
{
Marshal.FreeHGlobal(ptrV4);
}
}
}
