SDL3pp_surface.h

#ifndef SDL3PP_SURFACE_H_
#define SDL3PP_SURFACE_H_
 
#include <SDL3/SDL_surface.h>
#include "SDL3pp_blendmode.h"
#include "SDL3pp_error.h"
#include "SDL3pp_iostream.h"
#include "SDL3pp_optionalRef.h"
#include "SDL3pp_pixels.h"
#include "SDL3pp_properties.h"
#include "SDL3pp_rect.h"
#include "SDL3pp_spanRef.h"
#include "SDL3pp_strings.h"
#include "SDL3pp_version.h"
 
namespace SDL {
 
// Forward decl
struct Surface;
 
using SurfaceRaw = SDL_Surface*;
 
struct SurfaceParam
{
  SurfaceRaw value; 
 
  constexpr SurfaceParam(SurfaceRaw value)
    : value(value)
  {
  }
 
  constexpr SurfaceParam(std::nullptr_t _ = nullptr)
    : value(nullptr)
  {
  }
 
  constexpr explicit operator bool() const { return !!value; }
 
  constexpr auto operator<=>(const SurfaceParam& other) const = default;
 
  constexpr operator SurfaceRaw() const { return value; }
 
  constexpr auto operator->() { return value; }
};
 
struct SurfaceConstParam
{
  const SurfaceRaw value; 
 
  constexpr SurfaceConstParam(const SurfaceRaw value)
    : value(value)
  {
  }
 
  constexpr SurfaceConstParam(SurfaceParam value)
    : value(value.value)
  {
  }
 
  constexpr SurfaceConstParam(std::nullptr_t _ = nullptr)
    : value(nullptr)
  {
  }
 
  constexpr explicit operator bool() const { return !!value; }
 
  constexpr auto operator<=>(const SurfaceConstParam& other) const = default;
 
  constexpr operator const SurfaceRaw() const { return value; }
 
  constexpr auto operator->() { return value; }
};
 
using SurfaceFlags = Uint32;
 
constexpr SurfaceFlags SURFACE_PREALLOCATED =
  SDL_SURFACE_PREALLOCATED; 
 
constexpr SurfaceFlags SURFACE_LOCK_NEEDED =
  SDL_SURFACE_LOCK_NEEDED; 
 
constexpr SurfaceFlags SURFACE_LOCKED =
  SDL_SURFACE_LOCKED; 
 
constexpr SurfaceFlags SURFACE_SIMD_ALIGNED = SDL_SURFACE_SIMD_ALIGNED;
 
constexpr bool MustLock(SurfaceConstParam S) { return SDL_MUSTLOCK((S.value)); }
 
using ScaleMode = SDL_ScaleMode;
 
#if SDL_VERSION_ATLEAST(3, 2, 10)
 
constexpr ScaleMode SCALEMODE_INVALID = SDL_SCALEMODE_INVALID; 
 
#endif // SDL_VERSION_ATLEAST(3, 2, 10)
 
constexpr ScaleMode SCALEMODE_NEAREST =
  SDL_SCALEMODE_NEAREST; 
 
constexpr ScaleMode SCALEMODE_LINEAR =
  SDL_SCALEMODE_LINEAR; 
 
using FlipMode = SDL_FlipMode;
 
constexpr FlipMode FLIP_NONE = SDL_FLIP_NONE; 
 
constexpr FlipMode FLIP_HORIZONTAL = SDL_FLIP_HORIZONTAL; 
 
constexpr FlipMode FLIP_VERTICAL = SDL_FLIP_VERTICAL; 
 
class Surface
{
  SurfaceRaw m_resource = nullptr;
 
public:
  constexpr Surface() = default;
 
  constexpr explicit Surface(const SurfaceRaw resource)
    : m_resource(resource)
  {
  }
 
  constexpr Surface(const Surface& other) { ++m_resource->refcount; }
 
  constexpr Surface(Surface&& other)
    : Surface(other.release())
  {
  }
 
  Surface(const PointRaw& size, PixelFormat format)
    : m_resource(CheckError(SDL_CreateSurface(size.x, size.y, format)))
  {
  }
 
  Surface(const PointRaw& size, PixelFormat format, void* pixels, int pitch)
    : m_resource(CheckError(
        SDL_CreateSurfaceFrom(size.x, size.y, format, pixels, pitch)))
  {
  }
 
  Surface(StringParam file);
 
  Surface(IOStreamParam src, bool closeio = false);
 
  static constexpr Surface Borrow(SurfaceParam resource)
  {
    if (resource) {
      ++resource.value->refcount;
      return Surface(resource.value);
    }
    return {};
  }
 
  static Surface LoadBMP(IOStreamParam src, bool closeio = false);
 
  static Surface LoadBMP(StringParam file);
 
  constexpr const SurfaceRaw operator->() const { return m_resource; }
 
  constexpr SurfaceRaw operator->() { return m_resource; }
 
  ~Surface() { SDL_DestroySurface(m_resource); }
 
  Surface& operator=(Surface other)
  {
    std::swap(m_resource, other.m_resource);
    return *this;
  }
 
  constexpr SurfaceRaw get() const { return m_resource; }
 
  constexpr SurfaceRaw release()
  {
    auto r = m_resource;
    m_resource = nullptr;
    return r;
  }
 
  constexpr auto operator<=>(const Surface& other) const = default;
 
  constexpr bool operator==(std::nullptr_t _) const { return !m_resource; }
 
  constexpr explicit operator bool() const { return !!m_resource; }
 
  constexpr operator SurfaceParam() const { return {m_resource}; }
 
  void Destroy();
 
  constexpr bool MustLock() const { return SDL::MustLock(m_resource); }
 
  PropertiesRef GetProperties() const;
 
  void SetColorspace(Colorspace colorspace);
 
  Colorspace GetColorspace() const;
 
  Palette CreatePalette();
 
  void SetPalette(PaletteParam palette);
 
  Palette GetPalette() const;
 
  void AddAlternateImage(SurfaceParam image);
 
  bool HasAlternateImages() const;
 
  OwnArray<SurfaceRaw> GetImages() const;
 
  void RemoveAlternateImages();
 
  void Lock();
 
  void Unlock();
 
  void SaveBMP(IOStreamParam dst, bool closeio = false) const;
 
  void SaveBMP(StringParam file) const;
 
  void SetRLE(bool enabled);
 
  bool HasRLE() const;
 
  void SetColorKey(std::optional<Uint32> key);
 
  void ClearColorKey();
 
  bool HasColorKey() const;
 
  std::optional<Uint32> GetColorKey() const;
 
  void SetColorMod(Uint8 r, Uint8 g, Uint8 b);
 
  void GetColorMod(Uint8* r, Uint8* g, Uint8* b) const;
 
  void SetAlphaMod(Uint8 alpha);
 
  Uint8 GetAlphaMod() const;
 
  void SetMod(Color color);
 
  Color GetMod() const;
 
  void SetBlendMode(BlendMode blendMode);
 
  BlendMode GetBlendMode() const;
 
  bool SetClipRect(OptionalRef<const RectRaw> rect);
 
  void ResetClipRect();
 
  Rect GetClipRect() const;
 
  void Flip(FlipMode flip);
 
  Surface Duplicate() const;
 
  Surface Scale(const PointRaw& size, ScaleMode scaleMode) const;
 
  Surface Convert(PixelFormat format) const;
 
  Surface Convert(PixelFormat format,
                  PaletteParam palette,
                  Colorspace colorspace,
                  PropertiesParam props) const;
 
  void PremultiplyAlpha(bool linear);
 
  void Clear(const FColorRaw& c);
 
  void FillRect(OptionalRef<const RectRaw> rect, Uint32 color);
 
  void Fill(Uint32 color);
 
  void FillRects(SpanRef<const RectRaw> rects, Uint32 color);
 
  void Blit(SurfaceParam src,
            OptionalRef<const RectRaw> srcrect,
            OptionalRef<const RectRaw> dstrect);
 
  void BlitAt(SurfaceParam src,
              OptionalRef<const RectRaw> srcrect,
              const PointRaw& dstpos);
 
  void BlitUnchecked(SurfaceParam src,
                     const RectRaw& srcrect,
                     const RectRaw& dstrect);
 
  void BlitScaled(SurfaceParam src,
                  OptionalRef<const RectRaw> srcrect,
                  OptionalRef<const RectRaw> dstrect,
                  ScaleMode scaleMode);
 
  void BlitUncheckedScaled(SurfaceParam src,
                           const RectRaw& srcrect,
                           const RectRaw& dstrect,
                           ScaleMode scaleMode);
 
#if SDL_VERSION_ATLEAST(3, 4, 0)
 
  void Stretch(SurfaceParam src,
               OptionalRef<RectRaw> srcrect,
               OptionalRef<RectRaw> dstrect,
               ScaleMode scaleMode);
 
#endif // SDL_VERSION_ATLEAST(3, 4, 0)
 
  void BlitTiled(SurfaceParam src,
                 OptionalRef<const RectRaw> srcrect,
                 OptionalRef<const RectRaw> dstrect);
 
  void BlitTiledWithScale(SurfaceParam src,
                          OptionalRef<const RectRaw> srcrect,
                          float scale,
                          SDL_ScaleMode scaleMode,
                          OptionalRef<const RectRaw> dstrect);
 
  void Blit9Grid(SurfaceParam src,
                 OptionalRef<const RectRaw> srcrect,
                 int left_width,
                 int right_width,
                 int top_height,
                 int bottom_height,
                 OptionalRef<const RectRaw> dstrect,
                 float scale = 1,
                 SDL_ScaleMode scaleMode = SCALEMODE_NEAREST);
 
  Uint32 MapRGB(Uint8 r, Uint8 g, Uint8 b) const;
 
  Uint32 MapRGBA(ColorRaw c) const;
 
  void ReadPixel(const PointRaw& p,
                 Uint8* r,
                 Uint8* g,
                 Uint8* b,
                 Uint8* a) const;
 
  Color ReadPixel(const PointRaw& p) const;
 
  void ReadPixelFloat(const PointRaw& p,
                      float* r,
                      float* g,
                      float* b,
                      float* a) const;
 
  FColor ReadPixelFloat(const PointRaw& p) const;
 
  void WritePixel(const PointRaw& p, ColorRaw c);
 
  void WritePixelFloat(const PointRaw& p, const FColorRaw& c);
 
  constexpr int GetWidth() const;
 
  constexpr int GetHeight() const;
 
  constexpr Point GetSize() const;
 
  constexpr int GetPitch() const;
 
  constexpr PixelFormat GetFormat() const;
 
  constexpr void* GetPixels() const;
};
 
inline Surface CreateSurface(const PointRaw& size, PixelFormat format)
{
  return Surface(size, format);
}
 
inline Surface CreateSurfaceFrom(const PointRaw& size,
                                 PixelFormat format,
                                 void* pixels,
                                 int pitch)
{
  return Surface(size, format, pixels, pitch);
}
 
inline void DestroySurface(SurfaceRaw surface) { SDL_DestroySurface(surface); }
 
inline void Surface::Destroy() { DestroySurface(release()); }
 
inline PropertiesRef GetSurfaceProperties(SurfaceConstParam surface)
{
  return {CheckError(SDL_GetSurfaceProperties(surface))};
}
 
inline PropertiesRef Surface::GetProperties() const
{
  return SDL::GetSurfaceProperties(m_resource);
}
 
namespace prop::Surface {
 
constexpr auto SDR_WHITE_POINT_FLOAT = SDL_PROP_SURFACE_SDR_WHITE_POINT_FLOAT;
 
constexpr auto HDR_HEADROOM_FLOAT = SDL_PROP_SURFACE_HDR_HEADROOM_FLOAT;
 
constexpr auto TONEMAP_OPERATOR_STRING =
  SDL_PROP_SURFACE_TONEMAP_OPERATOR_STRING;
 
#if SDL_VERSION_ATLEAST(3, 2, 6)
 
constexpr auto HOTSPOT_X_NUMBER = SDL_PROP_SURFACE_HOTSPOT_X_NUMBER;
 
constexpr auto HOTSPOT_Y_NUMBER = SDL_PROP_SURFACE_HOTSPOT_Y_NUMBER;
 
#endif // SDL_VERSION_ATLEAST(3, 2, 6)
 
} // namespace prop::Surface
 
inline void SetSurfaceColorspace(SurfaceParam surface, Colorspace colorspace)
{
  CheckError(SDL_SetSurfaceColorspace(surface, colorspace));
}
 
inline void Surface::SetColorspace(Colorspace colorspace)
{
  SDL::SetSurfaceColorspace(m_resource, colorspace);
}
 
inline Colorspace GetSurfaceColorspace(SurfaceConstParam surface)
{
  return SDL_GetSurfaceColorspace(surface);
}
 
inline Colorspace Surface::GetColorspace() const
{
  return SDL::GetSurfaceColorspace(m_resource);
}
 
inline Palette CreateSurfacePalette(SurfaceParam surface)
{
  return Palette::Borrow(CheckError(SDL_CreateSurfacePalette(surface)));
}
 
inline Palette Surface::CreatePalette()
{
  return SDL::CreateSurfacePalette(m_resource);
}
 
inline void SetSurfacePalette(SurfaceParam surface, PaletteParam palette)
{
  CheckError(SDL_SetSurfacePalette(surface, palette));
}
 
inline void Surface::SetPalette(PaletteParam palette)
{
  SDL::SetSurfacePalette(m_resource, palette);
}
 
inline Palette GetSurfacePalette(SurfaceConstParam surface)
{
  return Palette::Borrow(SDL_GetSurfacePalette(surface));
}
 
inline Palette Surface::GetPalette() const
{
  return SDL::GetSurfacePalette(m_resource);
}
 
inline void AddSurfaceAlternateImage(SurfaceParam surface, SurfaceParam image)
{
  CheckError(SDL_AddSurfaceAlternateImage(surface, image));
}
 
inline void Surface::AddAlternateImage(SurfaceParam image)
{
  SDL::AddSurfaceAlternateImage(m_resource, image);
}
 
inline bool SurfaceHasAlternateImages(SurfaceConstParam surface)
{
  return SDL_SurfaceHasAlternateImages(surface);
}
 
inline bool Surface::HasAlternateImages() const
{
  return SDL::SurfaceHasAlternateImages(m_resource);
}
 
inline OwnArray<SurfaceRaw> GetSurfaceImages(SurfaceConstParam surface)
{
  int count = 0;
  auto data = SDL_GetSurfaceImages(surface, &count);
  return OwnArray<SurfaceRaw>(CheckError(data), count);
}
 
inline OwnArray<SurfaceRaw> Surface::GetImages() const
{
  return SDL::GetSurfaceImages(m_resource);
}
 
inline void RemoveSurfaceAlternateImages(SurfaceParam surface)
{
  SDL_RemoveSurfaceAlternateImages(surface);
}
 
inline void Surface::RemoveAlternateImages()
{
  SDL::RemoveSurfaceAlternateImages(m_resource);
}
 
inline void LockSurface(SurfaceParam surface)
{
  CheckError(SDL_LockSurface(surface));
}
 
inline void Surface::Lock() { SDL::LockSurface(m_resource); }
 
inline void UnlockSurface(SurfaceParam surface) { SDL_UnlockSurface(surface); }
 
inline void Surface::Unlock() { SDL::UnlockSurface(m_resource); }
 
inline Surface LoadBMP(IOStreamParam src, bool closeio = false)
{
  return Surface(SDL_LoadBMP_IO(src, closeio));
}
 
inline Surface LoadBMP(StringParam file) { return Surface(SDL_LoadBMP(file)); }
 
inline Surface Surface::LoadBMP(IOStreamParam src, bool closeio)
{
  return SDL::LoadBMP(src, closeio);
}
 
inline Surface Surface::LoadBMP(StringParam file)
{
  return SDL::LoadBMP(std::move(file));
}
 
inline void SaveBMP(SurfaceConstParam surface,
                    IOStreamParam dst,
                    bool closeio = false)
{
  CheckError(SDL_SaveBMP_IO(surface, dst, closeio));
}
 
inline void SaveBMP(SurfaceConstParam surface, StringParam file)
{
  CheckError(SDL_SaveBMP(surface, file));
}
 
inline void Surface::SaveBMP(IOStreamParam dst, bool closeio) const
{
  SDL::SaveBMP(m_resource, dst, closeio);
}
 
inline void Surface::SaveBMP(StringParam file) const
{
  SDL::SaveBMP(m_resource, std::move(file));
}
 
inline void SetSurfaceRLE(SurfaceParam surface, bool enabled)
{
  CheckError(SDL_SetSurfaceRLE(surface, enabled));
}
 
inline void Surface::SetRLE(bool enabled)
{
  SDL::SetSurfaceRLE(m_resource, enabled);
}
 
inline bool SurfaceHasRLE(SurfaceConstParam surface)
{
  return SDL_SurfaceHasRLE(surface);
}
 
inline bool Surface::HasRLE() const { return SDL::SurfaceHasRLE(m_resource); }
 
inline void SetSurfaceColorKey(SurfaceParam surface, std::optional<Uint32> key)
{
  CheckError(SDL_SetSurfaceColorKey(surface, key.has_value(), key.value_or(0)));
}
 
inline void Surface::SetColorKey(std::optional<Uint32> key)
{
  SDL::SetSurfaceColorKey(m_resource, key);
}
 
inline void ClearSurfaceColorKey(SurfaceParam surface)
{
  SetSurfaceColorKey(surface, std::nullopt);
}
 
inline void Surface::ClearColorKey() { SDL::ClearSurfaceColorKey(m_resource); }
 
inline bool SurfaceHasColorKey(SurfaceConstParam surface)
{
  return SDL_SurfaceHasColorKey(surface);
}
 
inline bool Surface::HasColorKey() const
{
  return SDL::SurfaceHasColorKey(m_resource);
}
 
inline std::optional<Uint32> GetSurfaceColorKey(SurfaceConstParam surface)
{
  if (Uint32 key; SDL_GetSurfaceColorKey(surface, &key)) return key;
  return std::nullopt;
}
 
inline std::optional<Uint32> Surface::GetColorKey() const
{
  return SDL::GetSurfaceColorKey(m_resource);
}
 
inline void SetSurfaceColorMod(SurfaceParam surface, Uint8 r, Uint8 g, Uint8 b)
{
  CheckError(SDL_SetSurfaceColorMod(surface, r, g, b));
}
 
inline void Surface::SetColorMod(Uint8 r, Uint8 g, Uint8 b)
{
  SDL::SetSurfaceColorMod(m_resource, r, g, b);
}
 
inline void GetSurfaceColorMod(SurfaceConstParam surface,
                               Uint8* r,
                               Uint8* g,
                               Uint8* b)
{
  CheckError(SDL_GetSurfaceColorMod(surface, r, g, b));
}
 
inline void Surface::GetColorMod(Uint8* r, Uint8* g, Uint8* b) const
{
  SDL::GetSurfaceColorMod(m_resource, r, g, b);
}
 
inline void SetSurfaceAlphaMod(SurfaceParam surface, Uint8 alpha)
{
  CheckError(SDL_SetSurfaceAlphaMod(surface, alpha));
}
 
inline void Surface::SetAlphaMod(Uint8 alpha)
{
  SDL::SetSurfaceAlphaMod(m_resource, alpha);
}
 
inline Uint8 GetSurfaceAlphaMod(SurfaceConstParam surface)
{
  Uint8 alpha;
  CheckError(SDL_GetSurfaceAlphaMod(surface, &alpha));
  return alpha;
}
 
inline Uint8 Surface::GetAlphaMod() const
{
  return SDL::GetSurfaceAlphaMod(m_resource);
}
 
inline void SetSurfaceMod(SurfaceParam surface, Color color)
{
  SetSurfaceColorMod(surface, color.r, color.g, color.b);
  SetSurfaceAlphaMod(surface, color.a);
}
 
inline void Surface::SetMod(Color color) { SetSurfaceMod(m_resource, color); }
 
inline Color GetSurfaceMod(SurfaceConstParam surface)
{
  Color c;
  GetSurfaceColorMod(surface, &c.r, &c.g, &c.b);
  c.a = GetSurfaceAlphaMod(surface);
  return c;
}
 
inline Color Surface::GetMod() const { return SDL::GetSurfaceMod(m_resource); }
 
inline void SetSurfaceBlendMode(SurfaceParam surface, BlendMode blendMode)
{
  CheckError(SDL_SetSurfaceBlendMode(surface, blendMode));
}
 
inline void Surface::SetBlendMode(BlendMode blendMode)
{
  SDL::SetSurfaceBlendMode(m_resource, blendMode);
}
 
inline BlendMode GetSurfaceBlendMode(SurfaceConstParam surface)
{
  BlendMode blendmode;
  CheckError(SDL_GetSurfaceBlendMode(surface, &blendmode));
  return blendmode;
}
 
inline BlendMode Surface::GetBlendMode() const
{
  return SDL::GetSurfaceBlendMode(m_resource);
}
 
inline bool SetSurfaceClipRect(SurfaceParam surface,
                               OptionalRef<const RectRaw> rect)
{
  return SDL_SetSurfaceClipRect(surface, rect);
}
 
inline bool Surface::SetClipRect(OptionalRef<const RectRaw> rect)
{
  return SDL::SetSurfaceClipRect(m_resource, rect);
}
 
inline void ResetSurfaceClipRect(SurfaceParam surface)
{
  SetSurfaceClipRect(surface, std::nullopt);
}
 
inline void Surface::ResetClipRect() { SDL::ResetSurfaceClipRect(m_resource); }
 
inline Rect GetSurfaceClipRect(SurfaceConstParam surface)
{
  Rect r;
  CheckError(SDL_GetSurfaceClipRect(surface, &r));
  return r;
}
 
inline Rect Surface::GetClipRect() const
{
  return SDL::GetSurfaceClipRect(m_resource);
}
 
inline void FlipSurface(SurfaceParam surface, FlipMode flip)
{
  CheckError(SDL_FlipSurface(surface, flip));
}
 
inline void Surface::Flip(FlipMode flip) { SDL::FlipSurface(m_resource, flip); }
 
inline Surface DuplicateSurface(SurfaceConstParam surface)
{
  return Surface(SDL_DuplicateSurface(surface));
}
 
inline Surface Surface::Duplicate() const
{
  return SDL::DuplicateSurface(m_resource);
}
 
inline Surface ScaleSurface(SurfaceConstParam surface,
                            const PointRaw& size,
                            ScaleMode scaleMode)
{
  return Surface(SDL_ScaleSurface(surface, size.x, size.y, scaleMode));
}
 
inline Surface Surface::Scale(const PointRaw& size, ScaleMode scaleMode) const
{
  return SDL::ScaleSurface(m_resource, size, scaleMode);
}
 
inline Surface ConvertSurface(SurfaceConstParam surface, PixelFormat format)
{
  return Surface(SDL_ConvertSurface(surface, format));
}
 
inline Surface Surface::Convert(PixelFormat format) const
{
  return SDL::ConvertSurface(m_resource, format);
}
 
inline Surface ConvertSurfaceAndColorspace(SurfaceConstParam surface,
                                           PixelFormat format,
                                           PaletteParam palette,
                                           Colorspace colorspace,
                                           PropertiesParam props)
{
  return Surface{SDL_ConvertSurfaceAndColorspace(
    surface, format, palette, colorspace, props)};
}
 
inline Surface Surface::Convert(PixelFormat format,
                                PaletteParam palette,
                                Colorspace colorspace,
                                PropertiesParam props) const
{
  return SDL::ConvertSurfaceAndColorspace(
    m_resource, format, palette, colorspace, props);
}
 
inline void ConvertPixels(const PointRaw& size,
                          PixelFormat src_format,
                          const void* src,
                          int src_pitch,
                          PixelFormat dst_format,
                          void* dst,
                          int dst_pitch)
{
  CheckError(SDL_ConvertPixels(
    size.x, size.y, src_format, src, src_pitch, dst_format, dst, dst_pitch));
}
 
inline void ConvertPixelsAndColorspace(const PointRaw& size,
                                       PixelFormat src_format,
                                       Colorspace src_colorspace,
                                       PropertiesParam src_properties,
                                       const void* src,
                                       int src_pitch,
                                       PixelFormat dst_format,
                                       Colorspace dst_colorspace,
                                       PropertiesParam dst_properties,
                                       void* dst,
                                       int dst_pitch)
{
  CheckError(SDL_ConvertPixelsAndColorspace(size.x,
                                            size.y,
                                            src_format,
                                            src_colorspace,
                                            src_properties,
                                            src,
                                            src_pitch,
                                            dst_format,
                                            dst_colorspace,
                                            dst_properties,
                                            dst,
                                            dst_pitch));
}
 
inline void PremultiplyAlpha(const PointRaw& size,
                             PixelFormat src_format,
                             const void* src,
                             int src_pitch,
                             PixelFormat dst_format,
                             void* dst,
                             int dst_pitch,
                             bool linear)
{
  CheckError(SDL_PremultiplyAlpha(size.x,
                                  size.y,
                                  src_format,
                                  src,
                                  src_pitch,
                                  dst_format,
                                  dst,
                                  dst_pitch,
                                  linear));
}
 
inline void PremultiplySurfaceAlpha(SurfaceParam surface, bool linear)
{
  CheckError(SDL_PremultiplySurfaceAlpha(surface, linear));
}
 
inline void Surface::PremultiplyAlpha(bool linear)
{
  SDL::PremultiplySurfaceAlpha(m_resource, linear);
}
 
inline void ClearSurface(SurfaceParam surface, const FColorRaw& c)
{
  CheckError(SDL_ClearSurface(surface, c.r, c.g, c.b, c.a));
}
 
inline void Surface::Clear(const FColorRaw& c)
{
  SDL::ClearSurface(m_resource, c);
}
 
inline void FillSurfaceRect(SurfaceParam dst,
                            OptionalRef<const RectRaw> rect,
                            Uint32 color)
{
  CheckError(SDL_FillSurfaceRect(dst, rect, color));
}
 
inline void Surface::FillRect(OptionalRef<const RectRaw> rect, Uint32 color)
{
  SDL::FillSurfaceRect(m_resource, rect, color);
}
 
inline void FillSurface(SurfaceParam dst, Uint32 color)
{
  FillSurfaceRect(dst, std::nullopt, color);
}
 
inline void Surface::Fill(Uint32 color) { SDL::FillSurface(m_resource, color); }
 
inline void FillSurfaceRects(SurfaceParam dst,
                             SpanRef<const RectRaw> rects,
                             Uint32 color)
{
  CheckError(SDL_FillSurfaceRects(dst, rects.data(), rects.size(), color));
}
 
inline void Surface::FillRects(SpanRef<const RectRaw> rects, Uint32 color)
{
  SDL::FillSurfaceRects(m_resource, rects, color);
}
 
inline void BlitSurface(SurfaceParam src,
                        OptionalRef<const RectRaw> srcrect,
                        SurfaceParam dst,
                        OptionalRef<const RectRaw> dstrect)
{
  CheckError(SDL_BlitSurface(src, srcrect, dst, dstrect));
}
 
inline void Surface::Blit(SurfaceParam src,
                          OptionalRef<const RectRaw> srcrect,
                          OptionalRef<const RectRaw> dstrect)
{
  SDL::BlitSurface(src, srcrect, m_resource, dstrect);
}
 
inline void Surface::BlitAt(SurfaceParam src,
                            OptionalRef<const RectRaw> srcrect,
                            const PointRaw& dstpos)
{
  Blit(src, srcrect, Rect{dstpos, {}});
}
 
inline void BlitSurfaceAt(SurfaceParam src,
                          OptionalRef<const RectRaw> srcrect,
                          SurfaceParam dst,
                          const PointRaw& dstpos)
{
  BlitSurface(src, srcrect, dst, SDL_Rect{dstpos.x, dstpos.y});
}
 
inline void BlitSurfaceUnchecked(SurfaceParam src,
                                 const RectRaw& srcrect,
                                 SurfaceParam dst,
                                 const RectRaw& dstrect)
{
  CheckError(SDL_BlitSurfaceUnchecked(src, &srcrect, dst, &dstrect));
}
 
inline void Surface::BlitUnchecked(SurfaceParam src,
                                   const RectRaw& srcrect,
                                   const RectRaw& dstrect)
{
  SDL::BlitSurfaceUnchecked(src, srcrect, m_resource, dstrect);
}
 
inline void BlitSurfaceScaled(SurfaceParam src,
                              OptionalRef<const RectRaw> srcrect,
                              SurfaceParam dst,
                              OptionalRef<const RectRaw> dstrect,
                              ScaleMode scaleMode)
{
  CheckError(SDL_BlitSurfaceScaled(src, srcrect, dst, dstrect, scaleMode));
}
 
inline void Surface::BlitScaled(SurfaceParam src,
                                OptionalRef<const RectRaw> srcrect,
                                OptionalRef<const RectRaw> dstrect,
                                ScaleMode scaleMode)
{
  SDL::BlitSurfaceScaled(src, srcrect, m_resource, dstrect, scaleMode);
}
 
inline void BlitSurfaceUncheckedScaled(SurfaceParam src,
                                       const RectRaw& srcrect,
                                       SurfaceParam dst,
                                       const RectRaw& dstrect,
                                       ScaleMode scaleMode)
{
  CheckError(
    SDL_BlitSurfaceUncheckedScaled(src, &srcrect, dst, &dstrect, scaleMode));
}
 
inline void Surface::BlitUncheckedScaled(SurfaceParam src,
                                         const RectRaw& srcrect,
                                         const RectRaw& dstrect,
                                         ScaleMode scaleMode)
{
  SDL::BlitSurfaceUncheckedScaled(src, srcrect, m_resource, dstrect, scaleMode);
}
 
#if SDL_VERSION_ATLEAST(3, 4, 0)
 
inline void StretchSurface(SurfaceParam src,
                           OptionalRef<RectRaw> srcrect,
                           SurfaceParam dst,
                           OptionalRef<RectRaw> dstrect,
                           ScaleMode scaleMode)
{
  CheckError(SDL_StretchSurface(src, srcrect, dst, dstrect, scaleMode));
}
 
inline void Surface::Stretch(SurfaceParam src,
                             OptionalRef<RectRaw> srcrect,
                             OptionalRef<RectRaw> dstrect,
                             ScaleMode scaleMode)
{
  SDL::StretchSurface(src, srcrect, m_resource, dstrect, scaleMode);
}
 
#endif // SDL_VERSION_ATLEAST(3, 4, 0)
 
inline void BlitSurfaceTiled(SurfaceParam src,
                             OptionalRef<const RectRaw> srcrect,
                             SurfaceParam dst,
                             OptionalRef<const RectRaw> dstrect)
{
  CheckError(SDL_BlitSurfaceTiled(src, srcrect, dst, dstrect));
}
 
inline void Surface::BlitTiled(SurfaceParam src,
                               OptionalRef<const RectRaw> srcrect,
                               OptionalRef<const RectRaw> dstrect)
{
  SDL::BlitSurfaceTiled(src, srcrect, m_resource, dstrect);
}
 
inline void BlitSurfaceTiledWithScale(SurfaceParam src,
                                      OptionalRef<const RectRaw> srcrect,
                                      float scale,
                                      SDL_ScaleMode scaleMode,
                                      SurfaceParam dst,
                                      OptionalRef<const RectRaw> dstrect)
{
  CheckError(SDL_BlitSurfaceTiledWithScale(
    src, srcrect, scale, scaleMode, dst, dstrect));
}
 
inline void Surface::BlitTiledWithScale(SurfaceParam src,
                                        OptionalRef<const RectRaw> srcrect,
                                        float scale,
                                        SDL_ScaleMode scaleMode,
                                        OptionalRef<const RectRaw> dstrect)
{
  SDL::BlitSurfaceTiledWithScale(
    src, srcrect, scale, scaleMode, m_resource, dstrect);
}
 
inline void BlitSurface9Grid(SurfaceParam src,
                             OptionalRef<const RectRaw> srcrect,
                             int left_width,
                             int right_width,
                             int top_height,
                             int bottom_height,
                             SurfaceParam dst,
                             OptionalRef<const RectRaw> dstrect,
                             float scale = 1,
                             SDL_ScaleMode scaleMode = SCALEMODE_NEAREST)
{
  CheckError(SDL_BlitSurface9Grid(src,
                                  srcrect,
                                  left_width,
                                  right_width,
                                  top_height,
                                  bottom_height,
                                  scale,
                                  scaleMode,
                                  dst,
                                  dstrect));
}
 
inline void Surface::Blit9Grid(SurfaceParam src,
                               OptionalRef<const RectRaw> srcrect,
                               int left_width,
                               int right_width,
                               int top_height,
                               int bottom_height,
                               OptionalRef<const RectRaw> dstrect,
                               float scale,
                               SDL_ScaleMode scaleMode)
{
  SDL::BlitSurface9Grid(src,
                        srcrect,
                        left_width,
                        right_width,
                        top_height,
                        bottom_height,
                        m_resource,
                        dstrect,
                        scale,
                        scaleMode);
}
 
inline Uint32 MapSurfaceRGB(SurfaceConstParam surface,
                            Uint8 r,
                            Uint8 g,
                            Uint8 b)
{
  return SDL_MapSurfaceRGB(surface, r, g, b);
}
 
inline Uint32 Surface::MapRGB(Uint8 r, Uint8 g, Uint8 b) const
{
  return SDL::MapSurfaceRGB(m_resource, r, g, b);
}
 
inline Uint32 MapSurfaceRGBA(SurfaceConstParam surface, ColorRaw c)
{
  return SDL_MapSurfaceRGBA(surface, c.r, c.g, c.b, c.a);
}
 
inline Uint32 Surface::MapRGBA(ColorRaw c) const
{
  return SDL::MapSurfaceRGBA(m_resource, c);
}
 
inline void ReadSurfacePixel(SurfaceConstParam surface,
                             const PointRaw& p,
                             Uint8* r,
                             Uint8* g,
                             Uint8* b,
                             Uint8* a)
{
  CheckError(SDL_ReadSurfacePixel(surface, p.x, p.y, r, g, b, a));
}
 
inline Color ReadSurfacePixel(SurfaceConstParam surface, const PointRaw& p)
{
  Color c;
  ReadSurfacePixel(surface, p, &c.r, &c.g, &c.b, &c.a);
  return c;
}
 
inline void Surface::ReadPixel(const PointRaw& p,
                               Uint8* r,
                               Uint8* g,
                               Uint8* b,
                               Uint8* a) const
{
  SDL::ReadSurfacePixel(m_resource, p, r, g, b, a);
}
 
inline Color Surface::ReadPixel(const PointRaw& p) const
{
  return SDL::ReadSurfacePixel(m_resource, p);
}
 
inline void ReadSurfacePixelFloat(SurfaceConstParam surface,
                                  const PointRaw& p,
                                  float* r,
                                  float* g,
                                  float* b,
                                  float* a)
{
  CheckError(SDL_ReadSurfacePixelFloat(surface, p.x, p.y, r, g, b, a));
}
 
inline FColor ReadSurfacePixelFloat(SurfaceConstParam surface,
                                    const PointRaw& p)
{
  FColor c;
  ReadSurfacePixelFloat(surface, p, &c.r, &c.g, &c.b, &c.a);
  return c;
}
 
inline void Surface::ReadPixelFloat(const PointRaw& p,
                                    float* r,
                                    float* g,
                                    float* b,
                                    float* a) const
{
  SDL::ReadSurfacePixelFloat(m_resource, p, r, g, b, a);
}
 
inline FColor Surface::ReadPixelFloat(const PointRaw& p) const
{
  return SDL::ReadSurfacePixelFloat(m_resource, p);
}
 
inline void WriteSurfacePixel(SurfaceParam surface,
                              const PointRaw& p,
                              ColorRaw c)
{
  CheckError(SDL_WriteSurfacePixel(surface, p.x, p.y, c.r, c.g, c.b, c.a));
}
 
inline void Surface::WritePixel(const PointRaw& p, ColorRaw c)
{
  SDL::WriteSurfacePixel(m_resource, p, c);
}
 
inline void WriteSurfacePixelFloat(SurfaceParam surface,
                                   const PointRaw& p,
                                   const FColorRaw& c)
{
  CheckError(SDL_WriteSurfacePixelFloat(surface, p.x, p.y, c.r, c.g, c.b, c.a));
}
 
inline void Surface::WritePixelFloat(const PointRaw& p, const FColorRaw& c)
{
  SDL::WriteSurfacePixelFloat(m_resource, p, c);
}
 
constexpr int GetSurfaceWidth(SurfaceConstParam surface) { return surface->w; }
 
constexpr int Surface::GetWidth() const
{
  return SDL::GetSurfaceWidth(m_resource);
}
 
constexpr int GetSurfaceHeight(SurfaceConstParam surface) { return surface->h; }
 
constexpr int Surface::GetHeight() const
{
  return SDL::GetSurfaceHeight(m_resource);
}
 
constexpr Point GetSurfaceSize(SurfaceConstParam surface)
{
  return Point(surface->w, surface->h);
}
 
constexpr Point Surface::GetSize() const
{
  return SDL::GetSurfaceSize(m_resource);
}
 
constexpr int GetSurfacePitch(SurfaceConstParam surface)
{
  return surface->pitch;
}
 
constexpr int Surface::GetPitch() const
{
  return SDL::GetSurfacePitch(m_resource);
}
 
constexpr PixelFormat GetSurfaceFormat(SurfaceConstParam surface)
{
  return surface->format;
}
 
constexpr PixelFormat Surface::GetFormat() const
{
  return SDL::GetSurfaceFormat(m_resource);
}
 
constexpr void* GetSurfacePixels(SurfaceConstParam surface)
{
  return surface->pixels;
}
 
constexpr void* Surface::GetPixels() const
{
  return SDL::GetSurfacePixels(m_resource);
}
 
 
} // namespace SDL
 
#endif /* SDL3PP_SURFACE_H_ */