@ -1,11 +1,10 @@
//! CAM service
//! Camera service
//!
//!
//! The CAM service provides access to the cameras. Cameras can return 2D images
//! The CAM service provides access to the cameras. Cameras can return images
//! in the form of byte vectors which can be used for display or other usage s.
//! in the form of byte vectors which can be displayed or used in other way s.
use crate ::error ::ResultCode ; use crate ::error ::{ Error , ResultCode } ;
use crate ::services ::gspgpu ::FramebufferFormat ; use crate ::services ::gspgpu ::FramebufferFormat ;
use bitflags ::bitflags ;
use ctru_sys ::Handle ; use ctru_sys ::Handle ;
use std ::time ::Duration ; use std ::time ::Duration ;
@ -21,191 +20,169 @@ pub struct Cam {
pub both_outer_cams : BothOutwardCam , pub both_outer_cams : BothOutwardCam ,
} }
bitflags ! { /// Flag to pass to [Camera::flip_image]
/// A set of flags to be passed to [Camera::flip_image]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamFlip : u32 { pub enum FlipMode {
const NONE = ctru_sys ::FLIP_NONE ; None = ctru_sys ::FLIP_NONE ,
const HORIZONTAL = ctru_sys ::FLIP_HORIZONTAL ; Horizontal = ctru_sys ::FLIP_HORIZONTAL ,
const VERTICAL = ctru_sys ::FLIP_VERTICAL ; Vertical = ctru_sys ::FLIP_VERTICAL ,
const REVERSE = ctru_sys ::FLIP_REVERSE ; Reverse = ctru_sys ::FLIP_REVERSE ,
}
} }
bitflags ! { /// Flag to pass to [Camera::set_view_size]
/// A set of flags to be passed to [Camera::set_view_size]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamSize : u32 { pub enum ViewSize {
const VGA = ctru_sys ::SIZE_VGA ; TopLCD = ctru_sys ::SIZE_CTR_TOP_LCD ,
const QVGA = ctru_sys ::SIZE_QVGA ; /// Equivalent to QVga
const QQVGA = ctru_sys ::SIZE_QQVGA ; BottomLCD = ctru_sys ::SIZE_CTR_BOTTOM_LCD ,
const CIF = ctru_sys ::SIZE_CIF ; Vga = ctru_sys ::SIZE_VGA ,
const QCIF = ctru_sys ::SIZE_QCIF ; QQVga = ctru_sys ::SIZE_QQVGA ,
const DS_LCD = ctru_sys ::SIZE_DS_LCD ; Cif = ctru_sys ::SIZE_CIF ,
const DS_LCD_X4 = ctru_sys ::SIZE_DS_LCDx4 ; QCif = ctru_sys ::SIZE_QCIF ,
const CTR_TOP_LCD = ctru_sys ::SIZE_CTR_TOP_LCD ; /// Nintendo DS Screen
const CTR_BOTTOM_LCD = ctru_sys ::SIZE_CTR_BOTTOM_LCD ; DS = ctru_sys ::SIZE_DS_LCD ,
} /// Nintendo DS Screen x4
DSX4 = ctru_sys ::SIZE_DS_LCDx4 ,
} }
bitflags ! { /// Flag to pass to [Camera::set_frame_rate]
/// A set of flags to be passed to [Camera::set_frame_rate]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamFrameRate : u32 { pub enum FrameRate {
const RATE_15 = ctru_sys ::FRAME_RATE_15 ; Fps15 = ctru_sys ::FRAME_RATE_15 ,
const RATE_15_TO_5 = ctru_sys ::FRAME_RATE_15_TO_5 ; Fps15To5 = ctru_sys ::FRAME_RATE_15_TO_5 ,
const RATE_15_TO_2 = ctru_sys ::FRAME_RATE_15_TO_2 ; Fps15To2 = ctru_sys ::FRAME_RATE_15_TO_2 ,
const RATE_10 = ctru_sys ::FRAME_RATE_10 ; Fps10 = ctru_sys ::FRAME_RATE_10 ,
const RATE_8_5 = ctru_sys ::FRAME_RATE_8_5 ; Fps8_5 = ctru_sys ::FRAME_RATE_8_5 ,
const RATE_5 = ctru_sys ::FRAME_RATE_5 ; Fps5 = ctru_sys ::FRAME_RATE_5 ,
const RATE_20 = ctru_sys ::FRAME_RATE_20 ; Fps20 = ctru_sys ::FRAME_RATE_20 ,
const RATE_20_TO_5 = ctru_sys ::FRAME_RATE_20_TO_5 ; Fps20To5 = ctru_sys ::FRAME_RATE_20_TO_5 ,
const RATE_30 = ctru_sys ::FRAME_RATE_30 ; Fps30 = ctru_sys ::FRAME_RATE_30 ,
const RATE_30_TO_5 = ctru_sys ::FRAME_RATE_30_TO_5 ; Fps30To5 = ctru_sys ::FRAME_RATE_30_TO_5 ,
const RATE_15_TO_10 = ctru_sys ::FRAME_RATE_15_TO_10 ; Fps15To10 = ctru_sys ::FRAME_RATE_15_TO_10 ,
const RATE_20_TO_10 = ctru_sys ::FRAME_RATE_20_TO_10 ; Fps20To10 = ctru_sys ::FRAME_RATE_20_TO_10 ,
const RATE_30_TO_10 = ctru_sys ::FRAME_RATE_30_TO_10 ; Fps30To10 = ctru_sys ::FRAME_RATE_30_TO_10 ,
}
} }
bitflags ! { /// Flag to pass to [Camera::set_white_balance] or
/// A set of flags to be passed to [Camera::set_white_balance] or
/// [Camera::set_white_balance_without_base_up]
/// [Camera::set_white_balance_without_base_up]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamWhiteBalance : u32 { pub enum WhiteBalance {
const AUTO = ctru_sys ::WHITE_BALANCE_AUTO ; /// Normal
const BALANCE_3200K = ctru_sys ::WHITE_BALANCE_3200K ; Auto = ctru_sys ::WHITE_BALANCE_AUTO ,
const BALANCE_4150K = ctru_sys ::WHITE_BALANCE_4150K ; /// Tungsten
const BALANCE_5200K = ctru_sys ::WHITE_BALANCE_5200K ; Temp3200K = ctru_sys ::WHITE_BALANCE_3200K ,
const BALANCE_6000K = ctru_sys ::WHITE_BALANCE_6000K ; /// Fluorescent Light
const BALANCE_7000K = ctru_sys ::WHITE_BALANCE_7000K ; Temp4150K = ctru_sys ::WHITE_BALANCE_4150K ,
/// Daylight
const NORMAL = ctru_sys ::WHITE_BALANCE_NORMAL ; Temp5200K = ctru_sys ::WHITE_BALANCE_5200K ,
const TUNGSTEN = ctru_sys ::WHITE_BALANCE_TUNGSTEN ; /// Cloudy/Horizon
const WHITE_FLUORESCENT_LIGHT = ctru_sys ::WHITE_BALANCE_WHITE_FLUORESCENT_LIGHT ; Temp6000K = ctru_sys ::WHITE_BALANCE_6000K ,
const DAYLIGHT = ctru_sys ::WHITE_BALANCE_DAYLIGHT ; ///Shade
const CLOUDY = ctru_sys ::WHITE_BALANCE_CLOUDY ; Temp7000K = ctru_sys ::WHITE_BALANCE_7000K ,
const HORIZON = ctru_sys ::WHITE_BALANCE_HORIZON ;
const SHADE = ctru_sys ::WHITE_BALANCE_SHADE ;
}
} }
bitflags ! { /// Flag to pass to [Camera::set_photo_mode]
/// A set of flags to be passed to [Camera::set_photo_mode]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamPhotoMode : u32 { pub enum PhotoMode {
const NORMAL = ctru_sys ::PHOTO_MODE_NORMAL ; Normal = ctru_sys ::PHOTO_MODE_NORMAL ,
const PORTRAIT = ctru_sys ::PHOTO_MODE_PORTRAIT ; Portrait = ctru_sys ::PHOTO_MODE_PORTRAIT ,
const LANDSCAPE = ctru_sys ::PHOTO_MODE_LANDSCAPE ; Landscape = ctru_sys ::PHOTO_MODE_LANDSCAPE ,
const NIGHTVIEW = ctru_sys ::PHOTO_MODE_NIGHTVIEW ; NightView = ctru_sys ::PHOTO_MODE_NIGHTVIEW ,
const LETTER = ctru_sys ::PHOTO_MODE_LETTER ; Letter = ctru_sys ::PHOTO_MODE_LETTER ,
}
} }
bitflags ! { /// Flag to pass to [Camera::set_effect]
/// A set of flags to be passed to [Camera::set_effect]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamEffect : u32 { pub enum Effect {
const NONE = ctru_sys ::EFFECT_NONE ; None = ctru_sys ::EFFECT_NONE ,
const MONO = ctru_sys ::EFFECT_MONO ; Mono = ctru_sys ::EFFECT_MONO ,
const SEPIA = ctru_sys ::EFFECT_SEPIA ; Sepia = ctru_sys ::EFFECT_SEPIA ,
const NEGATIVE = ctru_sys ::EFFECT_NEGATIVE ; Negative = ctru_sys ::EFFECT_NEGATIVE ,
const NEGAFILM = ctru_sys ::EFFECT_NEGAFILM ; Negafilm = ctru_sys ::EFFECT_NEGAFILM ,
const SEPIA01 = ctru_sys ::EFFECT_SEPIA01 ; Sepia01 = ctru_sys ::EFFECT_SEPIA01 ,
}
} }
bitflags ! { /// Flag to pass to [Camera::set_contrast]
/// A set of flags to be passed to [Camera::set_contrast]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamContrast : u32 { pub enum Contrast {
const PATTERN_01 = ctru_sys ::CONTRAST_PATTERN_01 ; /// OFF
const PATTERN_02 = ctru_sys ::CONTRAST_PATTERN_02 ; Low = ctru_sys ::CONTRAST_LOW ,
const PATTERN_03 = ctru_sys ::CONTRAST_PATTERN_03 ; /// Brightness ratio: 70
const PATTERN_04 = ctru_sys ::CONTRAST_PATTERN_04 ; Normal = ctru_sys ::CONTRAST_NORMAL ,
const PATTERN_05 = ctru_sys ::CONTRAST_PATTERN_05 ; /// Brightness ratio: 90
const PATTERN_06 = ctru_sys ::CONTRAST_PATTERN_06 ; High = ctru_sys ::CONTRAST_HIGH ,
const PATTERN_07 = ctru_sys ::CONTRAST_PATTERN_07 ;
const PATTERN_08 = ctru_sys ::CONTRAST_PATTERN_08 ;
const PATTERN_09 = ctru_sys ::CONTRAST_PATTERN_09 ;
const PATTERN_10 = ctru_sys ::CONTRAST_PATTERN_10 ;
const PATTERN_11 = ctru_sys ::CONTRAST_PATTERN_11 ;
const LOW = ctru_sys ::CONTRAST_LOW ;
const NORMAL = ctru_sys ::CONTRAST_NORMAL ;
const HIGH = ctru_sys ::CONTRAST_HIGH ;
}
} }
bitflags ! { /// Flag to pass to [Camera::set_lens_correction]
/// A set of flags to be passed to [Camera::set_lens_correction]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default) ] #[ repr(u32) ]
pub struct CamLensCorrection : u32 { pub enum LensCorrection {
const OFF = ctru_sys ::LENS_CORRECTION_OFF ; Off = ctru_sys ::LENS_CORRECTION_DARK ,
const ON_70 = ctru_sys ::LENS_CORRECTION_ON_70 ; Normal = ctru_sys ::LENS_CORRECTION_NORMAL ,
const ON_90 = ctru_sys ::LENS_CORRECTION_ON_90 ; Bright = ctru_sys ::LENS_CORRECTION_BRIGHT ,
}
const DARK = ctru_sys ::LENS_CORRECTION_DARK ; /// Flag to pass to [Camera::set_output_format]
const NORMAL = ctru_sys ::LENS_CORRECTION_NORMAL ; #[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
const BRIGHT = ctru_sys ::LENS_CORRECTION_BRIGHT ; #[ repr(u32) ]
} pub enum OutputFormat {
Yuv422 = ctru_sys ::OUTPUT_YUV_422 ,
Rgb565 = ctru_sys ::OUTPUT_RGB_565 ,
} }
bitflags ! { /// Flag to pass to [Cam::play_shutter_sound]
/// A set of flags to be passed to [Camera::set_output_format]
#[ derive(Copy, Clone, Debug, PartialEq, Eq) ]
#[ derive(Default )] #[ repr(u32 )]
pub struct CamOutputFormat : u32 { pub enum ShutterSound {
const YUV_422 = ctru_sys ::OUTPUT_YUV_422 ; Normal = ctru_sys ::SHUTTER_SOUND_TYPE_NORMAL ,
const RGB_565 = ctru_sys ::OUTPUT_RGB_565 ; Movie = ctru_sys ::SHUTTER_SOUND_TYPE_MOVIE ,
} MovieEnd = ctru_sys ::SHUTTER_SOUND_TYPE_MOVIE_END ,
} }
impl TryFrom < FramebufferFormat > for Cam OutputFormat { impl TryFrom < FramebufferFormat > for OutputFormat {
type Error = ( ) ; type Error = ( ) ;
fn try_from ( value : FramebufferFormat ) -> Result < Self , Self ::Error > { fn try_from ( value : FramebufferFormat ) -> Result < Self , Self ::Error > {
match value { match value {
FramebufferFormat ::Rgb565 = > Ok ( CamOutputFormat ::RGB_ 565) , FramebufferFormat ::Rgb565 = > Ok ( OutputFormat ::Rgb 565) ,
_ = > Err ( ( ) ) , _ = > Err ( ( ) ) ,
} }
} }
} }
impl TryFrom < Cam OutputFormat> for FramebufferFormat { impl TryFrom < OutputFormat > for FramebufferFormat {
type Error = ( ) ; type Error = ( ) ;
fn try_from ( value : Cam OutputFormat) -> Result < Self , Self ::Error > { fn try_from ( value : OutputFormat ) -> Result < Self , Self ::Error > {
match value { match value {
CamOutputFormat ::RGB_ 565 = > Ok ( FramebufferFormat ::Rgb565 ) , OutputFormat ::Rgb 565 = > Ok ( FramebufferFormat ::Rgb565 ) ,
_ = > Err ( ( ) ) , _ = > Err ( ( ) ) ,
} }
} }
} }
bitflags ! {
/// A set of flags to be passed to [Cam::play_shutter_sound]
#[ derive(Default) ]
pub struct CamShutterSoundType : u32 {
const NORMAL = ctru_sys ::SHUTTER_SOUND_TYPE_NORMAL ;
const MOVIE = ctru_sys ::SHUTTER_SOUND_TYPE_MOVIE ;
const MOVIE_END = ctru_sys ::SHUTTER_SOUND_TYPE_MOVIE_END ;
}
}
/// Struct containing coordinates passed to [Camera::set_trimming_params].
/// Struct containing coordinates passed to [Camera::set_trimming_params].
pub struct CamTrimmingParams { #[ derive(Clone, Copy, Debug, PartialEq, Eq) ]
pub struct TrimmingParams {
x_start : i16 , x_start : i16 ,
y_start : i16 , y_start : i16 ,
x_end : i16 , x_end : i16 ,
y_end : i16 , y_end : i16 ,
} }
impl Cam TrimmingParams { impl TrimmingParams {
/// Creates a new [CamTrimmingParams] and guarantees the start coordinates are less than or
/// Creates a new [CamTrimmingParams] and guarantees the start coordinates are less than or
/// equal to the end coordinates.
/// equal to the end coordinates.
///
///
/// `x_start <= x_end && y_start <= y_end`
/// `x_start <= x_end && y_start <= y_end`
pub fn new ( x_start : i16 , y_start : i16 , x_end : i16 , y_end : i16 ) -> Cam TrimmingParams { pub fn new ( x_start : i16 , y_start : i16 , x_end : i16 , y_end : i16 ) -> TrimmingParams {
assert! ( x_start < = x_end & & y_start < = y_end ) ; assert! ( x_start < = x_end & & y_start < = y_end ) ;
Self { Self {
x_start , x_start ,
@ -217,11 +194,11 @@ impl CamTrimmingParams {
} }
/// Represents data used by the camera to calibrate image quality
/// Represents data used by the camera to calibrate image quality
#[ derive(Default) ] #[ derive(Default, Clone, Copy, Debug ) ]
pub struct ImageQualityCalibrationData ( pub ctru_sys ::CAMU_ImageQualityCalibrationData ) ; pub struct ImageQualityCalibrationData ( pub ctru_sys ::CAMU_ImageQualityCalibrationData ) ;
/// Represents data used by the camera to calibrate image quality when using both outward cameras
/// Represents data used by the camera to calibrate image quality when using both outward cameras
#[ derive(Default) ] #[ derive(Default, Clone, Copy, Debug ) ]
pub struct StereoCameraCalibrationData ( pub ctru_sys ::CAMU_StereoCameraCalibrationData ) ; pub struct StereoCameraCalibrationData ( pub ctru_sys ::CAMU_StereoCameraCalibrationData ) ;
/// Represents the camera on the inside of the 3DS
/// Represents the camera on the inside of the 3DS
@ -307,7 +284,7 @@ pub trait Camera {
/// Returns the maximum amount of transfer bytes based on the view size, trimming, and other
/// Returns the maximum amount of transfer bytes based on the view size, trimming, and other
/// modifications set to the camera
/// modifications set to the camera
fn get_transfer_bytes ( & self ) -> crate ::Result < u32 > { fn transfer_byte_count ( & self ) -> crate ::Result < u32 > {
unsafe { unsafe {
let mut transfer_bytes = 0 ; let mut transfer_bytes = 0 ;
ResultCode ( ctru_sys ::CAMU_GetTransferBytes ( ResultCode ( ctru_sys ::CAMU_GetTransferBytes (
@ -336,8 +313,8 @@ pub trait Camera {
} }
} }
/// Sets trimming parameters based on coordinates specified inside a [Cam TrimmingParams]
/// Sets trimming parameters based on coordinates specified inside a [TrimmingParams]
fn set_trimming_params ( & mut self , params : Cam TrimmingParams) -> crate ::Result < ( ) > { fn set_trimming_params ( & mut self , params : TrimmingParams ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetTrimmingParams ( ResultCode ( ctru_sys ::CAMU_SetTrimmingParams (
self . port_as_raw ( ) , self . port_as_raw ( ) ,
@ -350,8 +327,8 @@ pub trait Camera {
} }
} }
/// Returns the set [CamTrimmingParams] from the camera
/// Returns the [TrimmingParams] set
fn get_ trimming_params( & self ) -> crate ::Result < Cam TrimmingParams> { fn trimming_params ( & self ) -> crate ::Result < TrimmingParams > {
unsafe { unsafe {
let mut x_start = 0 ; let mut x_start = 0 ;
let mut y_start = 0 ; let mut y_start = 0 ;
@ -365,7 +342,7 @@ pub trait Camera {
self . port_as_raw ( ) , self . port_as_raw ( ) ,
) ) ? ; ) ) ? ;
Ok ( Cam TrimmingParams { Ok ( TrimmingParams {
x_start , x_start ,
y_start , y_start ,
x_end , x_end ,
@ -378,7 +355,7 @@ pub trait Camera {
/// The new width will be `trim_width / 2` to the left and right of the center.
/// The new width will be `trim_width / 2` to the left and right of the center.
/// The new height will be `trim_height / 2` above and below the center.
/// The new height will be `trim_height / 2` above and below the center.
fn set_trimming_params_center ( fn set_trimming_params_center (
& self , & mut self ,
trim_width : i16 , trim_width : i16 ,
trim_height : i16 , trim_height : i16 ,
cam_width : i16 , cam_width : i16 ,
@ -404,27 +381,27 @@ pub trait Camera {
} }
} }
/// Sets the white balance mod of the camera based on the passed [Cam WhiteBalance] argument
/// Sets the white balance mod of the camera based on the passed [WhiteBalance] argument
fn set_white_balance ( & mut self , white_balance : Cam WhiteBalance) -> crate ::Result < ( ) > { fn set_white_balance ( & mut self , white_balance : WhiteBalance ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetWhiteBalance ( ResultCode ( ctru_sys ::CAMU_SetWhiteBalance (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
white_balance . bits ( ) , white_balance . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the white balance mode of the camera based on the passed [Cam WhiteBalance] argument
/// Sets the white balance mode of the camera based on the passed [WhiteBalance] argument
// TODO: Explain base up
// TODO: Explain base up
fn set_white_balance_without_base_up ( fn set_white_balance_without_base_up (
& mut self , & mut self ,
white_balance : Cam WhiteBalance, white_balance : WhiteBalance ,
) -> crate ::Result < ( ) > { ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetWhiteBalanceWithoutBaseUp ( ResultCode ( ctru_sys ::CAMU_SetWhiteBalanceWithoutBaseUp (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
white_balance . bits ( ) , white_balance . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
@ -484,12 +461,12 @@ pub trait Camera {
} }
} }
/// Sets the flip direction of the camera's image based on the passed [Cam Flip] argument
/// Sets the flip direction of the camera's image based on the passed [FlipMode ] argument
fn flip_image ( & mut self , flip : Cam Flip) -> crate ::Result < ( ) > { fn flip_image ( & mut self , flip : FlipMode ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_FlipImage ( ResultCode ( ctru_sys ::CAMU_FlipImage (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
flip . bits ( ) , flip . into ( ) ,
ctru_sys ::CONTEXT_A , ctru_sys ::CONTEXT_A ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
@ -530,82 +507,82 @@ pub trait Camera {
} }
} }
/// Sets the view size of the camera based on the passed [Cam Size] argument.
/// Sets the view size of the camera based on the passed [View Size] argument.
fn set_view_size ( & mut self , size : Cam Size) -> crate ::Result < ( ) > { fn set_view_size ( & mut self , size : View Size) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetSize ( ResultCode ( ctru_sys ::CAMU_SetSize (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
size . bits ( ) , size . into ( ) ,
ctru_sys ::CONTEXT_A , ctru_sys ::CONTEXT_A ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the frame rate of the camera based on the passed [Cam FrameRate] argument.
/// Sets the frame rate of the camera based on the passed [FrameRate] argument.
fn set_frame_rate ( & mut self , frame_rate : Cam FrameRate) -> crate ::Result < ( ) > { fn set_frame_rate ( & mut self , frame_rate : FrameRate ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetFrameRate ( ResultCode ( ctru_sys ::CAMU_SetFrameRate (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
frame_rate . bits ( ) , frame_rate . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the photo mode of the camera based on the passed [Cam PhotoMode] argument.
/// Sets the photo mode of the camera based on the passed [PhotoMode] argument.
fn set_photo_mode ( & mut self , photo_mode : Cam PhotoMode) -> crate ::Result < ( ) > { fn set_photo_mode ( & mut self , photo_mode : PhotoMode ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetPhotoMode ( ResultCode ( ctru_sys ::CAMU_SetPhotoMode (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
photo_mode . bits ( ) , photo_mode . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the effect of the camera based on the passed [Cam Effect] argument.
/// Sets the effect of the camera based on the passed [Effect] argument.
///
///
/// Multiple effects can be set at once by combining the bitflags of [CamEffect]
/// Multiple effects can be set at once by combining the bitflags of [CamEffect]
fn set_effect ( & mut self , effect : Cam Effect) -> crate ::Result < ( ) > { fn set_effect ( & mut self , effect : Effect ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetEffect ( ResultCode ( ctru_sys ::CAMU_SetEffect (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
effect . bits ( ) , effect . into ( ) ,
ctru_sys ::CONTEXT_A , ctru_sys ::CONTEXT_A ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the contrast of the camera based on the passed [CamC ontrast] argument.
/// Sets the contrast of the camera based on the passed [Contrast] argument.
fn set_contrast ( & mut self , contrast : CamC ontrast ) -> crate ::Result < ( ) > { fn set_contrast ( & mut self , contrast : Contrast ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetContrast ( ResultCode ( ctru_sys ::CAMU_SetContrast (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
contrast . bits ( ) , contrast . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the lens correction of the camera based on the passed [Cam LensCorrection] argument.
/// Sets the lens correction of the camera based on the passed [LensCorrection] argument.
fn set_lens_correction ( & mut self , lens_correction : Cam LensCorrection) -> crate ::Result < ( ) > { fn set_lens_correction ( & mut self , lens_correction : LensCorrection ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetLensCorrection ( ResultCode ( ctru_sys ::CAMU_SetLensCorrection (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
lens_correction . bits ( ) , lens_correction . into ( ) ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
/// Sets the output format of the camera based on the passed [Cam OutputFormat] argument.
/// Sets the output format of the camera based on the passed [OutputFormat] argument.
fn set_output_format ( & mut self , format : Cam OutputFormat) -> crate ::Result < ( ) > { fn set_output_format ( & mut self , format : OutputFormat ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetOutputFormat ( ResultCode ( ctru_sys ::CAMU_SetOutputFormat (
self . camera_as_raw ( ) , self . camera_as_raw ( ) ,
format . bits ( ) , format . into ( ) ,
ctru_sys ::CONTEXT_A , ctru_sys ::CONTEXT_A ,
) ) ? ; ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
@ -687,7 +664,7 @@ pub trait Camera {
} }
/// Returns the current [ImageQualityCalibrationData] for the camera
/// Returns the current [ImageQualityCalibrationData] for the camera
fn get_ image_quality_calibration_data( & self ) -> crate ::Result < ImageQualityCalibrationData > { fn image_quality_calibration_data ( & self ) -> crate ::Result < ImageQualityCalibrationData > {
unsafe { unsafe {
let mut data = ImageQualityCalibrationData ::default ( ) ; let mut data = ImageQualityCalibrationData ::default ( ) ;
ResultCode ( ctru_sys ::CAMU_GetImageQualityCalibrationData ( & mut data . 0 ) ) ? ; ResultCode ( ctru_sys ::CAMU_GetImageQualityCalibrationData ( & mut data . 0 ) ) ? ;
@ -704,7 +681,7 @@ pub trait Camera {
} }
} }
/// Requests the camera to take a picture and returns a vector containing the image bytes .
/// Requests the camera to take a picture and write it in a buffer .
///
///
/// # Errors
/// # Errors
///
///
@ -717,10 +694,11 @@ pub trait Camera {
/// * `timeout` - Duration to wait for the image
/// * `timeout` - Duration to wait for the image
fn take_picture ( fn take_picture (
& mut self , & mut self ,
buffer : & mut [ u8 ] ,
width : u16 , width : u16 ,
height : u16 , height : u16 ,
timeout : Duration , timeout : Duration ,
) -> crate ::Result < Vec < u8 > > { ) -> crate ::Result < ( ) > {
let transfer_unit = unsafe { let transfer_unit = unsafe {
let mut buf_size = 0 ; let mut buf_size = 0 ;
ResultCode ( ctru_sys ::CAMU_GetMaxBytes ( ResultCode ( ctru_sys ::CAMU_GetMaxBytes (
@ -731,10 +709,6 @@ pub trait Camera {
Ok ::< u32 , i32 > ( buf_size ) Ok ::< u32 , i32 > ( buf_size )
} ? ; } ? ;
let screen_size = u32 ::from ( width ) * u32 ::from ( width ) * 2 ;
let mut buf = vec! [ 0 u8 ; usize ::try_from ( screen_size ) . unwrap ( ) ] ;
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_SetTransferBytes ( ResultCode ( ctru_sys ::CAMU_SetTransferBytes (
self . port_as_raw ( ) , self . port_as_raw ( ) ,
@ -744,6 +718,14 @@ pub trait Camera {
) ) ? ; ) ) ? ;
} ; } ;
let screen_size : usize = usize ::from ( width ) * usize ::from ( height ) * 2 ;
if buffer . len ( ) < screen_size {
return Err ( Error ::BufferTooShort {
provided : buffer . len ( ) ,
wanted : screen_size ,
} ) ;
}
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_Activate ( self . camera_as_raw ( ) ) ) ? ; ResultCode ( ctru_sys ::CAMU_Activate ( self . camera_as_raw ( ) ) ) ? ;
ResultCode ( ctru_sys ::CAMU_ClearBuffer ( self . port_as_raw ( ) ) ) ? ; ResultCode ( ctru_sys ::CAMU_ClearBuffer ( self . port_as_raw ( ) ) ) ? ;
@ -754,25 +736,30 @@ pub trait Camera {
let mut completion_handle : Handle = 0 ; let mut completion_handle : Handle = 0 ;
ResultCode ( ctru_sys ::CAMU_SetReceiving ( ResultCode ( ctru_sys ::CAMU_SetReceiving (
& mut completion_handle , & mut completion_handle ,
buf . as_mut_ptr ( ) as * mut ::libc ::c_void , buffer . as_mut_ptr ( ) . cast ( ) ,
self . port_as_raw ( ) , self . port_as_raw ( ) ,
screen_size , screen_size as u32 ,
transfer_unit . try_into ( ) . unwrap ( ) , transfer_unit . try_into ( ) . unwrap ( ) ,
) ) ? ; ) ) ? ;
Ok ::< Handle , i32 > ( completion_handle ) Ok ::< Handle , i32 > ( completion_handle )
} ? ; } ? ;
unsafe { unsafe {
ResultCode ( ctru_sys ::svcWaitSynchronization ( // Panicking without closing an SVC handle causes an ARM exception, we have to handle it carefully (TODO: SVC module)
let wait_result = ResultCode ( ctru_sys ::svcWaitSynchronization (
receive_event , receive_event ,
timeout . as_nanos ( ) . try_into ( ) . unwrap ( ) , timeout . as_nanos ( ) . try_into ( ) . unwrap ( ) ,
) ) ? ; ) ) ;
// We close everything first, then we check for possible errors
let _ = ctru_sys ::svcCloseHandle ( receive_event ) ; // We wouldn't return the error even if there was one, so no use of ResultCode is needed
ResultCode ( ctru_sys ::CAMU_StopCapture ( self . port_as_raw ( ) ) ) ? ; ResultCode ( ctru_sys ::CAMU_StopCapture ( self . port_as_raw ( ) ) ) ? ;
ResultCode ( ctru_sys ::svcCloseHandle ( receive_event ) ) ? ;
ResultCode ( ctru_sys ::CAMU_Activate ( ctru_sys ::SELECT_NONE ) ) ? ; ResultCode ( ctru_sys ::CAMU_Activate ( ctru_sys ::SELECT_NONE ) ) ? ;
wait_result ? ;
} ; } ;
Ok ( buf ) Ok ( ( ) )
} }
} }
@ -784,7 +771,7 @@ impl Cam {
/// This function will return an error if the service was unable to be initialized.
/// This function will return an error if the service was unable to be initialized.
/// Since this service requires no special or elevated permissions, errors are
/// Since this service requires no special or elevated permissions, errors are
/// rare in practice.
/// rare in practice.
pub fn init ( ) -> crate ::Result < Cam > { pub fn new ( ) -> crate ::Result < Cam > {
unsafe { unsafe {
ResultCode ( ctru_sys ::camInit ( ) ) ? ; ResultCode ( ctru_sys ::camInit ( ) ) ? ;
Ok ( Cam { Ok ( Cam {
@ -796,10 +783,10 @@ impl Cam {
} }
} }
/// Plays the specified sound based on the [Cam ShutterSoundType ] argument
/// Plays the specified sound based on the [ShutterSound] argument
pub fn play_shutter_sound ( & self , sound : Cam ShutterSoundType ) -> crate ::Result < ( ) > { pub fn play_shutter_sound ( & self , sound : ShutterSound ) -> crate ::Result < ( ) > {
unsafe { unsafe {
ResultCode ( ctru_sys ::CAMU_PlayShutterSound ( sound . bits ( ) ) ) ? ; ResultCode ( ctru_sys ::CAMU_PlayShutterSound ( sound . into ( ) ) ) ? ;
Ok ( ( ) ) Ok ( ( ) )
} }
} }
@ -810,3 +797,14 @@ impl Drop for Cam {
unsafe { ctru_sys ::camExit ( ) } ; unsafe { ctru_sys ::camExit ( ) } ;
} }
} }
from_impl ! ( FlipMode , ctru_sys ::CAMU_Flip ) ;
from_impl ! ( ViewSize , ctru_sys ::CAMU_Size ) ;
from_impl ! ( FrameRate , ctru_sys ::CAMU_FrameRate ) ;
from_impl ! ( WhiteBalance , ctru_sys ::CAMU_WhiteBalance ) ;
from_impl ! ( PhotoMode , ctru_sys ::CAMU_PhotoMode ) ;
from_impl ! ( Effect , ctru_sys ::CAMU_Effect ) ;
from_impl ! ( Contrast , ctru_sys ::CAMU_Contrast ) ;
from_impl ! ( LensCorrection , ctru_sys ::CAMU_LensCorrection ) ;
from_impl ! ( OutputFormat , ctru_sys ::CAMU_OutputFormat ) ;
from_impl ! ( ShutterSound , ctru_sys ::CAMU_ShutterSoundType ) ;
AzureMarker
2 years ago