canvas/canvas/image.h

Go to the documentation of this file.

/*
 * Copyright (C) 2013-2015 Paul Davis <paul@linuxaudiosystems.com>
 * Copyright (C) 2013 Robin Gareus <robin@gareus.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#ifndef __CANVAS_IMAGE__
#define __CANVAS_IMAGE__
 
#include <cstdint>
#include <memory>
 
#include <boost/shared_array.hpp>
 
#include "canvas/visibility.h"
#include "canvas/item.h"
 
typedef void (*ImageReleaseCallback)(uint8_t *d, void *arg);
 
namespace ArdourCanvas {
 
 
class LIBCANVAS_API Image : public Item
{
public:
    Image (Canvas *, Cairo::Format, int width, int height);
    Image (Item*, Cairo::Format, int width, int height);
 
    struct Data {
        Data (uint8_t *d, int w, int h, int s, Cairo::Format fmt)
                : data (d)
                , width (w)
                , height (h)
                , stride (s)
                , format (fmt)
                , destroy_callback(NULL)
                , destroy_arg(NULL)
        {}
 
        virtual ~Data () {
                if (destroy_callback) {
                        destroy_callback(data, destroy_arg);
                } else {
                        delete [] data;
                }
        }
 
        uint8_t* data;
        int width;
        int height;
        int stride;
        Cairo::Format format;
        ImageReleaseCallback  destroy_callback;
        void* destroy_arg;
    };
 
    std::shared_ptr<Data> get_image (bool allocate_data = true);
 
 
    void put_image (std::shared_ptr<Data>);
 
    void render (Rect const &, Cairo::RefPtr<Cairo::Context>) const;
    void compute_bounding_box () const;
 
private:
    Cairo::Format            _format;
    int                      _width;
    int                      _height;
    mutable std::shared_ptr<Data>  _current;
    std::shared_ptr<Data>  _pending;
    mutable bool             _need_render;
    mutable Cairo::RefPtr<Cairo::Surface> _surface;
 
    void accept_data ();
    PBD::Signal0<void> DataReady;
    PBD::ScopedConnectionList data_connections;
};
 
}
#endif