thorvg.h

 
#ifndef _THORVG_H_
#define _THORVG_H_
 
#include <memory>
#include <string>
 
#ifdef TVG_BUILD
    #ifdef _MSC_VER
        #define TVG_EXPORT __declspec(dllexport)
        #define TVG_DEPRECATED __declspec(deprecated)
    #else
        #define TVG_EXPORT __attribute__ ((visibility ("default")))
        #define TVG_DEPRECATED __attribute__ ((__deprecated__))
    #endif
#else
    #define TVG_EXPORT
    #define TVG_DEPRECATED
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define _TVG_DECLARE_PRIVATE(A) \
protected: \
    struct Impl; \
    Impl* pImpl; \
    A(const A&) = delete; \
    const A& operator=(const A&) = delete; \
    A()
 
#define _TVG_DISABLE_CTOR(A) \
    A() = delete; \
    ~A() = delete
 
#define _TVG_DECLARE_ACCESSOR() \
    friend Canvas; \
    friend Scene; \
    friend Picture; \
    friend IteratorModule; \
 
 
#define _TVG_DECALRE_IDENTIFIER() \
    auto id() const { return _id; } \
protected: \
    unsigned _id
 
namespace tvg
{
 
class RenderMethod;
class IteratorModule;
class Scene;
class Picture;
class Canvas;
 
enum class TVG_EXPORT Result
{
    Success = 0,           
    InvalidArguments,      
    InsufficientCondition, 
    FailedAllocation,      
    MemoryCorruption,      
    NonSupport,            
    Unknown                
};
 
enum class TVG_EXPORT PathCommand
{
    Close = 0, 
    MoveTo,    
    LineTo,    
    CubicTo    
};
 
enum class TVG_EXPORT StrokeCap
{
    Square = 0, 
    Round,      
    Butt        
};
 
enum class TVG_EXPORT StrokeJoin
{
    Bevel = 0, 
    Round,     
    Miter      
};
 
enum class TVG_EXPORT FillSpread
{
    Pad = 0, 
    Reflect, 
    Repeat   
};
 
enum class TVG_EXPORT FillRule
{
    Winding = 0, 
    EvenOdd      
};
 
enum class TVG_EXPORT CompositeMethod
{
    None = 0,     
    ClipPath,     
    AlphaMask,    
    InvAlphaMask  
};
 
enum class TVG_EXPORT CanvasEngine
{
    Sw = (1 << 1), 
    Gl = (1 << 2)  
};
 
 
struct Point
{
    float x, y;
};
 
 
struct Matrix
{
    float e11, e12, e13;
    float e21, e22, e23;
    float e31, e32, e33;
};
 
 
class TVG_EXPORT Paint
{
public:
    virtual ~Paint();
 
    Result rotate(float degree) noexcept;
 
    Result scale(float factor) noexcept;
 
    Result translate(float x, float y) noexcept;
 
    Result transform(const Matrix& m) noexcept;
 
    Matrix transform() noexcept;
 
    Result opacity(uint8_t o) noexcept;
 
    Result composite(std::unique_ptr<Paint> target, CompositeMethod method) noexcept;
 
    TVG_DEPRECATED Result bounds(float* x, float* y, float* w, float* h) const noexcept;
 
 
    Result bounds(float* x, float* y, float* w, float* h, bool transformed) const noexcept;
 
 
    Paint* duplicate() const noexcept;
 
    uint8_t opacity() const noexcept;
 
    CompositeMethod composite(const Paint** target) const noexcept;
 
    _TVG_DECLARE_ACCESSOR();
    _TVG_DECALRE_IDENTIFIER();
    _TVG_DECLARE_PRIVATE(Paint);
};
 
 
class TVG_EXPORT Fill
{
public:
    struct ColorStop
    {
        float offset; 
        uint8_t r;    
        uint8_t g;    
        uint8_t b;    
        uint8_t a;    
    };
 
    virtual ~Fill();
 
    Result colorStops(const ColorStop* colorStops, uint32_t cnt) noexcept;
 
    Result spread(FillSpread s) noexcept;
 
    uint32_t colorStops(const ColorStop** colorStops) const noexcept;
 
    FillSpread spread() const noexcept;
 
    Fill* duplicate() const noexcept;
 
    _TVG_DECALRE_IDENTIFIER();
    _TVG_DECLARE_PRIVATE(Fill);
};
 
 
class TVG_EXPORT Canvas
{
public:
    Canvas(RenderMethod*);
    virtual ~Canvas();
 
    Result reserve(uint32_t n) noexcept;
 
    virtual Result push(std::unique_ptr<Paint> paint) noexcept;
 
    virtual Result clear(bool free = true) noexcept;
 
    virtual Result update(Paint* paint = nullptr) noexcept;
 
    virtual Result draw() noexcept;
 
    virtual Result sync() noexcept;
 
    _TVG_DECLARE_PRIVATE(Canvas);
};
 
 
class TVG_EXPORT LinearGradient final : public Fill
{
public:
    ~LinearGradient();
 
    Result linear(float x1, float y1, float x2, float y2) noexcept;
 
    Result linear(float* x1, float* y1, float* x2, float* y2) const noexcept;
 
    static std::unique_ptr<LinearGradient> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(LinearGradient);
};
 
 
class TVG_EXPORT RadialGradient final : public Fill
{
public:
    ~RadialGradient();
 
    Result radial(float cx, float cy, float radius) noexcept;
 
    Result radial(float* cx, float* cy, float* radius) const noexcept;
 
    static std::unique_ptr<RadialGradient> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(RadialGradient);
};
 
 
class TVG_EXPORT Shape final : public Paint
{
public:
    ~Shape();
 
    Result reset() noexcept;
 
    Result moveTo(float x, float y) noexcept;
 
    Result lineTo(float x, float y) noexcept;
 
    Result cubicTo(float cx1, float cy1, float cx2, float cy2, float x, float y) noexcept;
 
    Result close() noexcept;
 
    Result appendRect(float x, float y, float w, float h, float rx, float ry) noexcept;
 
    Result appendCircle(float cx, float cy, float rx, float ry) noexcept;
 
    Result appendArc(float cx, float cy, float radius, float startAngle, float sweep, bool pie) noexcept;
 
    Result appendPath(const PathCommand* cmds, uint32_t cmdCnt, const Point* pts, uint32_t ptsCnt) noexcept;
 
    Result stroke(float width) noexcept;
 
    Result stroke(uint8_t r, uint8_t g, uint8_t b, uint8_t a) noexcept;
 
    Result stroke(std::unique_ptr<Fill> f) noexcept;
 
    Result stroke(const float* dashPattern, uint32_t cnt) noexcept;
 
    Result stroke(StrokeCap cap) noexcept;
 
    Result stroke(StrokeJoin join) noexcept;
 
    Result fill(uint8_t r, uint8_t g, uint8_t b, uint8_t a) noexcept;
 
    Result fill(std::unique_ptr<Fill> f) noexcept;
 
    Result fill(FillRule r) noexcept;
 
    uint32_t pathCommands(const PathCommand** cmds) const noexcept;
 
    uint32_t pathCoords(const Point** pts) const noexcept;
 
    const Fill* fill() const noexcept;
 
    Result fillColor(uint8_t* r, uint8_t* g, uint8_t* b, uint8_t* a) const noexcept;
 
    FillRule fillRule() const noexcept;
 
    float strokeWidth() const noexcept;
 
    Result strokeColor(uint8_t* r, uint8_t* g, uint8_t* b, uint8_t* a) const noexcept;
 
    const Fill* strokeFill() const noexcept;
 
    uint32_t strokeDash(const float** dashPattern) const noexcept;
 
    StrokeCap strokeCap() const noexcept;
 
    StrokeJoin strokeJoin() const noexcept;
 
    static std::unique_ptr<Shape> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(Shape);
};
 
 
class TVG_EXPORT Picture final : public Paint
{
public:
    ~Picture();
 
    Result load(const std::string& path) noexcept;
 
    TVG_DEPRECATED Result load(const char* data, uint32_t size, bool copy = false) noexcept;
 
    Result load(const char* data, uint32_t size, const std::string& mimeType, bool copy = false) noexcept;
 
    Result size(float w, float h) noexcept;
 
    Result size(float* w, float* h) const noexcept;
 
    const uint32_t* data(uint32_t* w, uint32_t* h) const noexcept;
 
    Result load(uint32_t* data, uint32_t w, uint32_t h, bool copy) noexcept;
 
    Result viewbox(float* x, float* y, float* w, float* h) const noexcept;
 
    static std::unique_ptr<Picture> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(Picture);
};
 
 
class TVG_EXPORT Scene final : public Paint
{
public:
    ~Scene();
 
    Result push(std::unique_ptr<Paint> paint) noexcept;
 
    Result reserve(uint32_t size) noexcept;
 
    Result clear(bool free = true) noexcept;
 
    static std::unique_ptr<Scene> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(Scene);
};
 
 
class TVG_EXPORT SwCanvas final : public Canvas
{
public:
    ~SwCanvas();
 
    enum Colorspace
    {
        ABGR8888 = 0, 
        ARGB8888      
    };
 
    enum MempoolPolicy
    {
        Default = 0, 
        Shareable,   
        Individual   
    };
 
    Result target(uint32_t* buffer, uint32_t stride, uint32_t w, uint32_t h, Colorspace cs) noexcept;
 
    Result mempool(MempoolPolicy policy) noexcept;
 
    static std::unique_ptr<SwCanvas> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(SwCanvas);
};
 
 
class TVG_EXPORT GlCanvas final : public Canvas
{
public:
    ~GlCanvas();
 
    Result target(uint32_t* buffer, uint32_t stride, uint32_t w, uint32_t h) noexcept;
 
    static std::unique_ptr<GlCanvas> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(GlCanvas);
};
 
 
class TVG_EXPORT Initializer final
{
public:
    static Result init(CanvasEngine engine, uint32_t threads) noexcept;
 
    static Result term(CanvasEngine engine) noexcept;
 
    _TVG_DISABLE_CTOR(Initializer);
};
 
 
class TVG_EXPORT Saver
{
public:
    ~Saver();
 
    Result save(std::unique_ptr<Paint> paint, const std::string& path, bool compress = true) noexcept;
 
    Result sync() noexcept;
 
    static std::unique_ptr<Saver> gen() noexcept;
 
    _TVG_DECLARE_PRIVATE(Saver);
};
 
} //namespace
 
#ifdef __cplusplus
}
#endif
 
#endif //_THORVG_H_