SDL3pp_camera.h

#ifndef SDL3PP_CAMERA_H_
#define SDL3PP_CAMERA_H_
 
#include <SDL3/SDL_camera.h>
#include "SDL3pp_error.h"
#include "SDL3pp_pixels.h"
#include "SDL3pp_properties.h"
#include "SDL3pp_stdinc.h"
#include "SDL3pp_surface.h"
 
namespace SDL {
 
// Forward decl
struct Camera;
 
using CameraRaw = SDL_Camera*;
 
// Forward decl
struct CameraRef;
 
struct CameraParam
{
  CameraRaw value; 
 
  constexpr CameraParam(CameraRaw value)
    : value(value)
  {
  }
 
  constexpr CameraParam(std::nullptr_t _ = nullptr)
    : value(nullptr)
  {
  }
 
  constexpr explicit operator bool() const { return !!value; }
 
  constexpr auto operator<=>(const CameraParam& other) const = default;
 
  constexpr operator CameraRaw() const { return value; }
};
 
using CameraID = SDL_CameraID;
 
using CameraSpec = SDL_CameraSpec;
 
using CameraPosition = SDL_CameraPosition;
 
constexpr CameraPosition CAMERA_POSITION_UNKNOWN =
  SDL_CAMERA_POSITION_UNKNOWN; 
 
constexpr CameraPosition CAMERA_POSITION_FRONT_FACING =
  SDL_CAMERA_POSITION_FRONT_FACING; 
 
constexpr CameraPosition CAMERA_POSITION_BACK_FACING =
  SDL_CAMERA_POSITION_BACK_FACING; 
 
class Camera
{
  CameraRaw m_resource = nullptr;
 
public:
  constexpr Camera() = default;
 
  constexpr explicit Camera(const CameraRaw resource)
    : m_resource(resource)
  {
  }
 
  constexpr Camera(const Camera& other) = delete;
 
  constexpr Camera(Camera&& other)
    : Camera(other.release())
  {
  }
 
  constexpr Camera(const CameraRef& other) = delete;
 
  constexpr Camera(CameraRef&& other) = delete;
 
  Camera(CameraID instance_id, OptionalRef<const CameraSpec> spec = {})
    : m_resource(SDL_OpenCamera(instance_id, spec))
  {
  }
 
  ~Camera() { SDL_CloseCamera(m_resource); }
 
  Camera& operator=(Camera other)
  {
    std::swap(m_resource, other.m_resource);
    return *this;
  }
 
  constexpr CameraRaw get() const { return m_resource; }
 
  constexpr CameraRaw release()
  {
    auto r = m_resource;
    m_resource = nullptr;
    return r;
  }
 
  constexpr auto operator<=>(const Camera& other) const = default;
 
  constexpr bool operator==(std::nullptr_t _) const { return !m_resource; }
 
  constexpr explicit operator bool() const { return !!m_resource; }
 
  constexpr operator CameraParam() const { return {m_resource}; }
 
  void Close();
 
  int GetPermissionState();
 
  CameraID GetID();
 
  PropertiesRef GetProperties();
 
  std::optional<CameraSpec> GetFormat();
 
  Surface AcquireFrame(Uint64* timestampNS = nullptr);
 
  void ReleaseFrame(SurfaceParam frame);
};
 
struct CameraRef : Camera
{
  CameraRef(CameraParam resource)
    : Camera(resource.value)
  {
  }
 
  CameraRef(const CameraRef& other)
    : Camera(other.get())
  {
  }
 
  ~CameraRef() { release(); }
};
 
inline int GetNumCameraDrivers() { return SDL_GetNumCameraDrivers(); }
 
inline const char* GetCameraDriver(int index)
{
  return SDL_GetCameraDriver(index);
}
 
inline const char* GetCurrentCameraDriver()
{
  return SDL_GetCurrentCameraDriver();
}
 
inline OwnArray<CameraID> GetCameras()
{
  int count;
  auto data = SDL_GetCameras(&count);
  return OwnArray<CameraID>(data, count);
}
 
inline OwnArray<CameraSpec*> GetCameraSupportedFormats(CameraID instance_id)
{
  int count;
  auto data = SDL_GetCameraSupportedFormats(instance_id, &count);
  return OwnArray<CameraSpec*>(data, count);
}
 
inline const char* GetCameraName(CameraID instance_id)
{
  return SDL_GetCameraName(instance_id);
}
 
inline CameraPosition GetCameraPosition(CameraID instance_id)
{
  return SDL_GetCameraPosition(instance_id);
}
 
inline Camera OpenCamera(CameraID instance_id,
                         OptionalRef<const CameraSpec> spec = {})
{
  return Camera(instance_id, spec);
}
 
inline int GetCameraPermissionState(CameraParam camera)
{
  return SDL_GetCameraPermissionState(camera);
}
 
inline int Camera::GetPermissionState()
{
  return SDL::GetCameraPermissionState(m_resource);
}
 
inline CameraID GetCameraID(CameraParam camera)
{
  return CheckError(SDL_GetCameraID(camera));
}
 
inline CameraID Camera::GetID() { return SDL::GetCameraID(m_resource); }
 
inline PropertiesRef GetCameraProperties(CameraParam camera)
{
  return {CheckError(SDL_GetCameraProperties(camera))};
}
 
inline PropertiesRef Camera::GetProperties()
{
  return SDL::GetCameraProperties(m_resource);
}
 
inline std::optional<CameraSpec> GetCameraFormat(CameraParam camera)
{
  if (CameraSpec spec; SDL_GetCameraFormat(camera, &spec)) return spec;
  return std::nullopt;
}
 
inline std::optional<CameraSpec> Camera::GetFormat()
{
  return SDL::GetCameraFormat(m_resource);
}
 
inline Surface AcquireCameraFrame(CameraParam camera,
                                  Uint64* timestampNS = nullptr)
{
  return Surface::Borrow(SDL_AcquireCameraFrame(camera, timestampNS));
}
 
inline Surface Camera::AcquireFrame(Uint64* timestampNS)
{
  return SDL::AcquireCameraFrame(m_resource, timestampNS);
}
 
inline void ReleaseCameraFrame(CameraParam camera, SurfaceParam frame)
{
  SDL_ReleaseCameraFrame(camera, frame);
}
 
inline void Camera::ReleaseFrame(SurfaceParam frame)
{
  SDL::ReleaseCameraFrame(m_resource, frame);
}
 
inline void CloseCamera(CameraRaw camera) { SDL_CloseCamera(camera); }
 
inline void Camera::Close() { CloseCamera(release()); }
 
 
} // namespace SDL
 
#endif /* SDL3PP_CAMERA_H_ */