loadpng.hpp

Go to the documentation of this file.

/**
 * @file loadpng.hpp
 * @brief PNG image loading and saving utilities via SDL.
 */
#ifndef __LOADPNG_H__
#define __LOADPNG_H__
#include"SDL.h"
 
/** @namespace png
 *  @brief Utilities for loading and saving PNG images. */
namespace png {
 
    /**
     * @brief Load a PNG file into an SDL_Surface.
     * @param file Path to the PNG file.
     * @return Newly allocated SDL_Surface, or nullptr on failure.
     */
    SDL_Surface *LoadPNG(const char* file);
 
    /**
     * @brief Save an SDL_Texture to a PNG file.
     * @param texture  Source texture.
     * @param renderer Renderer used to read back the texture pixels.
     * @param filename Destination file path.
     * @return @c true on success, @c false on failure.
     */
    bool SavePNG(SDL_Texture* texture, SDL_Renderer* renderer, const char* filename);
 
    /**
     * @brief Save a raw RGBA pixel buffer to a PNG file.
     * @param filename Destination file path.
     * @param buffer   Pointer to the raw RGBA pixel data.
     * @param w        Image width in pixels.
     * @param h        Image height in pixels.
     * @return @c true on success, @c false on failure.
     */
    bool SavePNG_RGBA(const char *filename, void *buffer, int w, int h);
}
#endif