SDL::Camera Struct Reference

The opaque structure used to identify an opened SDL camera. More...

Inheritance diagram for SDL::Camera:

Public Member Functions
constexpr	Camera (CameraRaw resource) noexcept
	Constructs from raw Camera.
constexpr	Camera (const Camera &other)=delete
	Copy constructor.
constexpr	Camera (Camera &&other) noexcept
	Move constructor.
constexpr	Camera (const CameraRef &other)=delete
constexpr	Camera (CameraRef &&other)=delete
	Camera (CameraID instance_id, OptionalRef< const CameraSpec > spec={})
	Open a video recording device (a "camera").
	~Camera ()
	Destructor.
constexpr Camera &	operator= (Camera &&other) noexcept
	Assignment operator.
Camera &	operator= (const Camera &other)=delete
	Assignment operator.
void	Close ()
	Use this function to shut down camera processing and close the camera device.
CameraPermissionState	GetPermissionState ()
	Query if camera access has been approved by the user.
CameraID	GetID ()
	Get the instance ID of an opened camera.
PropertiesRef	GetProperties ()
	Get the properties associated with an opened camera.
std::optional< CameraSpec >	GetFormat ()
	Get the spec that a camera is using when generating images.
CameraFrame	AcquireFrame (Uint64 *timestampNS=nullptr)
	Acquire a frame.
void	ReleaseFrame (CameraFrame &&lock)
	Release a frame of video acquired from a camera.
constexpr	ResourceBase (RawPointer resource)
	Constructs from resource pointer.
constexpr	ResourceBase (std::nullptr_t=nullptr)
	Constructs null/invalid.
Public Member Functions inherited from SDL::ResourceBase< CameraRaw >
constexpr	ResourceBase (RawPointer resource)
	Constructs from resource pointer.
constexpr	operator bool () const
	Converts to bool.
constexpr auto	operator<=> (const ResourceBase &other) const=default
	Comparison.
constexpr RawConstPointer	operator-> () const noexcept
	member access to underlying resource pointer.
constexpr RawPointer	get () const noexcept
	Retrieves underlying resource pointer.
constexpr RawPointer	release () noexcept
	Retrieves underlying resource pointer and clear this.

Additional Inherited Members
Public Types inherited from SDL::ResourceBase< CameraRaw >
using	RawPointer
	The underlying raw pointer type.
using	RawConstPointer
	The underlying const raw pointer type.

Detailed Description

The opaque structure used to identify an opened SDL camera.

Since

This struct is available since SDL 3.2.0.

Category:

Resource

Constructor & Destructor Documentation

Camera()

SDL::Camera::Camera ( CameraRaw resource )

inlineexplicitconstexprnoexcept

Constructs from raw Camera.

Parameters

resource

a CameraRaw to be wrapped.

This assumes the ownership, call release() if you need to take back.

---

The documentation for this struct was generated from the following file:

• SDL3pp/SDL3pp_camera.h