/*
- Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
+ Copyright (C) 2012-2016 Carl Hetherington <cth@carlh.net>
- This program is free software; you can redistribute it and/or modify
+ This file is part of DCP-o-matic.
+
+ DCP-o-matic 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,
+ DCP-o-matic 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., 675 Mass Ave, Cambridge, MA 02139, USA.
+ along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
*/
* @brief A set of classes to describe video images.
*/
-#ifndef DVDOMATIC_IMAGE_H
-#define DVDOMATIC_IMAGE_H
+#ifndef DCPOMATIC_IMAGE_H
+#define DCPOMATIC_IMAGE_H
-#include <string>
-#include <boost/shared_ptr.hpp>
+#include "position.h"
+#include "position_image.h"
+#include "types.h"
extern "C" {
-#include <libavcodec/avcodec.h>
-#include <libavfilter/avfilter.h>
+#include <libavutil/pixfmt.h>
}
-#include "util.h"
-
-class Scaler;
-class RGBFrameImage;
-class SimpleImage;
-
-/** @class Image
- * @brief Parent class for wrappers of some image, in some format, that
- * can present a set of components and a size in pixels.
- *
- * This class also has some conversion / processing methods.
- *
- * The main point of this class (and its subclasses) is to abstract
- * details of FFmpeg's memory management and varying data formats.
- */
-class Image
+#include <dcp/colour_conversion.h>
+#include <boost/shared_ptr.hpp>
+#include <boost/enable_shared_from_this.hpp>
+
+struct AVFrame;
+class Socket;
+
+class Image : public boost::enable_shared_from_this<Image>
{
public:
- Image (PixelFormat p)
- : _pixel_format (p)
- {}
-
- virtual ~Image () {}
-
- /** @return Array of pointers to arrays of the component data */
- virtual uint8_t ** data () const = 0;
-
- /** @return Array of sizes of the data in each line, in bytes (without any alignment padding bytes) */
- virtual int * line_size () const = 0;
-
- /** @return Array of strides for each line (including any alignment padding bytes) */
- virtual int * stride () const = 0;
-
- /** @return Size of the image, in pixels */
- virtual Size size () const = 0;
-
- int components () const;
- int lines (int) const;
- boost::shared_ptr<Image> scale_and_convert_to_rgb (Size, int, Scaler const *) const;
- boost::shared_ptr<Image> scale (Size, Scaler const *) const;
- boost::shared_ptr<Image> post_process (std::string) const;
- void alpha_blend (boost::shared_ptr<Image> image, Position pos);
-
+ Image (AVPixelFormat p, dcp::Size s, bool aligned, int extra_pixels = 0);
+ explicit Image (AVFrame *);
+ explicit Image (Image const &);
+ Image (boost::shared_ptr<const Image>, bool);
+ Image& operator= (Image const &);
+ ~Image ();
+
+ uint8_t * const * data () const;
+ int const * line_size () const;
+ int const * stride () const;
+ dcp::Size size () const;
+ bool aligned () const;
+
+ int planes () const;
+ int vertical_factor (int) const;
+ int horizontal_factor (int) const;
+ dcp::Size sample_size (int) const;
+ float bytes_per_pixel (int) const;
+
+ boost::shared_ptr<Image> convert_pixel_format (dcp::YUVToRGB yuv_to_rgb, AVPixelFormat out_format, bool aligned, bool fast) const;
+ boost::shared_ptr<Image> scale (dcp::Size out_size, dcp::YUVToRGB yuv_to_rgb, AVPixelFormat out_format, bool aligned, bool fast) const;
+ boost::shared_ptr<Image> crop_scale_window (
+ Crop crop, dcp::Size inter_size, dcp::Size out_size, dcp::YUVToRGB yuv_to_rgb, AVPixelFormat out_format, bool aligned, bool fast
+ ) const;
+
void make_black ();
-
- PixelFormat pixel_format () const {
+ void make_transparent ();
+ void alpha_blend (boost::shared_ptr<const Image> image, Position<int> pos);
+ void copy (boost::shared_ptr<const Image> image, Position<int> pos);
+ void fade (float);
+
+ void read_from_socket (boost::shared_ptr<Socket>);
+ void write_to_socket (boost::shared_ptr<Socket>) const;
+
+ AVPixelFormat pixel_format () const {
return _pixel_format;
}
-private:
- PixelFormat _pixel_format; ///< FFmpeg's way of describing the pixel format of this Image
-};
+ size_t memory_used () const;
-/** @class FilterBufferImage
- * @brief An Image that is held in an AVFilterBufferRef.
- */
-class FilterBufferImage : public Image
-{
-public:
- FilterBufferImage (PixelFormat, AVFilterBufferRef *);
- ~FilterBufferImage ();
+ dcp::Data as_png () const;
- uint8_t ** data () const;
- int * line_size () const;
- int * stride () const;
- Size size () const;
+ static boost::shared_ptr<const Image> ensure_aligned (boost::shared_ptr<const Image> image);
private:
- AVFilterBufferRef* _buffer;
-};
+ friend struct pixel_formats_test;
-/** @class SimpleImage
- * @brief An Image for which memory is allocated using a `simple' av_malloc().
- */
-class SimpleImage : public Image
-{
-public:
- SimpleImage (PixelFormat, Size);
- ~SimpleImage ();
-
- uint8_t ** data () const;
- int * line_size () const;
- int * stride () const;
- Size size () const;
-
-private:
- Size _size; ///< size in pixels
- uint8_t** _data; ///< array of pointers to components
- int* _line_size; ///< array of sizes of the data in each line, in pixels (without any alignment padding bytes)
- int* _stride; ///< array of strides for each line (including any alignment padding bytes)
+ void allocate ();
+ void swap (Image &);
+ void yuv_16_black (uint16_t, bool);
+ static uint16_t swap_16 (uint16_t);
+ dcp::Size _size;
+ AVPixelFormat _pixel_format; ///< FFmpeg's way of describing the pixel format of this Image
+ uint8_t** _data; ///< array of pointers to components
+ int* _line_size; ///< array of sizes of the data in each line, in bytes (without any alignment padding bytes)
+ int* _stride; ///< array of strides for each line, in bytes (including any alignment padding bytes)
+ bool _aligned;
+ int _extra_pixels;
};
-/** @class RGBFrameImage
- * @brief An RGB image that is held within an AVFrame.
- */
-class RGBFrameImage : public Image
-{
-public:
- RGBFrameImage (Size);
- ~RGBFrameImage ();
-
- uint8_t ** data () const;
- int * line_size () const;
- int * stride () const;
- Size size () const;
- AVFrame * frame () const {
- return _frame;
- }
-
-private:
- Size _size;
- AVFrame* _frame;
- uint8_t* _data;
-};
+extern PositionImage merge (std::list<PositionImage> images);
+extern bool operator== (Image const & a, Image const & b);
#endif