ds_surface.h

/* Copyright (C) 2017 - 2024, Thornwave Labs Inc - All Rights Reserved.
 * Unauthorized copying of this file, via any medium is strictly prohibited.
 * Proprietary and confidential.
 * Written by Razvan Turiac <razvan.turiac@thornwave.com>
*/
 
#ifndef _DS_SURFACE_H
#define _DS_SURFACE_H
 
#include <stdint.h>
#include <stddef.h>
 
#include <ds_color.h>
#include <ds_types.h>
#include <ds_geometry.h>
#include <ds_allocator.h>
 
 
 
class DsSurface
{
public:
    DsSurface(int32_t width, int32_t height, const DsRotation &rotation, DsColorMode cmode, bool palette_has_alpha, size_t palette_size, ds_malloc_t fb_malloc, ds_free_t fb_free, uint32_t alignment = 32, size_t extra_data = 0);
    
 
    DsSurface(uint32_t* stream, size_t size);
 
 
    DsSurface(const DsSurface &src);
 
 
    ~DsSurface();
 
 
 
    DsSize getSize(void) const;
 
    
    DsRect getRegion(void) const;
 
 
    void setUser(void* user);
 
    
    void* getUser(void);
    
 
    DsRotation getRotation(void) const;
 
    
    int32_t getPhysicalWidth(void) const;
 
    int32_t getPhysicalHeight(void) const;
 
 
    uint32_t getBpp(void) const;
 
 
    uint32_t getPitch(void) const;
 
    uint32_t getPitchPx(void) const;
 
 
    DsColorMode getColorMode(void) const;
 
    uint8_t* getPixels(void);
 
    size_t getFrameBufferSize(void) const;
 
    uint16_t getPaletteSize(void) const;
    
    bool doesPaletteHaveAlpha(void) const;
    
    uint8_t* getPalette(void);
 
    
    DsSurface getSubSurface(const DsRect &rect) const;
 
 
    void clear(DsColor color);
 
 
    void putPixel(int32_t x, int32_t y, DsColor color);
 
 
    void copy(int32_t x, int32_t y, const DsSurface &src, DsAlphaMode alpha_mode, DsColor color);
 
 
    void copy(int32_t x, int32_t y, const DsSurface &src, const DsRect &src_area, DsAlphaMode alpha_mode, DsColor color)
    {
        const DsSurface sub_surface = src.getSubSurface(src_area);
        copy(x, y, sub_surface, alpha_mode, color);
    }
 
 
    void blend(int32_t x, int32_t y, const DsSurface &src, DsAlphaMode alpha_mode, DsColor color);
 
    
    void blend(int32_t x, int32_t y, const DsSurface &src, const DsRect &src_area, DsAlphaMode alpha_mode, DsColor color)
    {
        const DsSurface sub_surface = src.getSubSurface(src_area);
        blend(x, y, sub_surface, alpha_mode, color);
    }
 
 
    void blendAligned(const DsSurface &src, DsAlphaMode alpha_mode, DsColor color, const DsRect &boundary, const DsAlignment &alignment, const DsPoint &offset = DsPoint(0, 0));
 
    void invert(void);
 
    void replaceColor(DsColor match_color, bool match_mask_a, bool match_mask_r, bool match_mask_g, bool match_mask_b, 
                        DsColor new_color, bool new_mask_a, bool new_mask_r, bool new_mask_g, bool new_mask_b);
 
 
    void replaceColor(const DsSurface &src, bool replace_a, bool replace_r, bool replace_g, bool replace_b);
 
    
    void replaceAlpha(const DsSurface &alpha_only_src);
 
 
    void rotateFrameBuffer(DsRotation rotation);
 
    size_t saveStream(uint32_t* stream);
 
 
    void rotateXY(int32_t &x, int32_t &y) const;
    
    void rotateXY(float &x, float &y) const;
 
    void rotateWH(int32_t &w, int32_t &h) const;
 
    void rotateWH(float &w, float &h) const;
    
    void rotateRect(DsRect &rect) const;
    
    void rotateRect(DsFRect &rect) const;
 
    void unrotateRect(DsRect &rect) const;
 
    void unrotateRect(DsFRect &rect) const;
 
private:
    friend class DsRenderer;
    friend class DsScreen;
    friend class DsView;
 
    void* mUser;
 
    ds_malloc_t mFbMalloc;
    ds_free_t mFbFree;
 
    DsRotation mRotation;
 
    int32_t mWidth;             
    int32_t mHeight;            
 
    DsColorMode mColorMode;     
    size_t mExtraData;          
    size_t mAlignment;
 
    size_t mBytesPerPixel;      
    size_t mPitch;              
    
    size_t mPitchPx;            
    
    bool mPaletteHasAlpha;          
    size_t mPaletteSize;
 
    DsRect mClipRegion;
 
    uint8_t* mPixels;           
    uint8_t* mPalette;
    
    size_t computePitch(size_t with);
 
    void setClipRegion(const DsRect &region);
 
 
    DsRect getClipRegion(void) const;
 
 
    void resetClipRegion(void);
};
 
 
#endif