/* Copyright (C) 2012-2016 Carl Hetherington 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. 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 DCP-o-matic. If not, see . */ /** @file src/image.h * @brief A set of classes to describe video images. */ #ifndef DCPOMATIC_IMAGE_H #define DCPOMATIC_IMAGE_H #include "crop.h" #include "position.h" #include "position_image.h" #include "video_range.h" extern "C" { #include } #include #include struct AVFrame; class Socket; class Image : public std::enable_shared_from_this { public: enum class Alignment { COMPACT, PADDED }; Image (AVPixelFormat p, dcp::Size s, Alignment alignment); explicit Image (AVFrame const *, Alignment alignment); explicit Image (Image const &); Image (std::shared_ptr, Alignment alignment); Image& operator= (Image const &); ~Image (); uint8_t * const * data () const; /** @return array of sizes of the data in each line, in bytes (not including any alignment padding) */ int const * line_size () const; /** @return array of sizes of the data in each line, in bytes (including any alignment padding) */ int const * stride () const; dcp::Size size () const; Alignment alignment () 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; std::shared_ptr convert_pixel_format (dcp::YUVToRGB yuv_to_rgb, AVPixelFormat out_format, Alignment alignment, bool fast) const; std::shared_ptr scale (dcp::Size out_size, dcp::YUVToRGB yuv_to_rgb, AVPixelFormat out_format, Alignment alignment, bool fast) const; std::shared_ptr crop_scale_window ( Crop crop, dcp::Size inter_size, dcp::Size out_size, dcp::YUVToRGB yuv_to_rgb, VideoRange video_range, AVPixelFormat out_format, VideoRange out_video_range, Alignment alignment, bool fast ) const; void make_black (); void make_transparent (); void alpha_blend (std::shared_ptr image, Position pos); void copy (std::shared_ptr image, Position pos); void fade (float); void read_from_socket (std::shared_ptr); void write_to_socket (std::shared_ptr) const; AVPixelFormat pixel_format () const { return _pixel_format; } size_t memory_used () const; static std::shared_ptr ensure_alignment (std::shared_ptr image, Alignment alignment); private: friend struct pixel_formats_test; friend struct make_part_black_test; void allocate (); void swap (Image &); void make_part_black (int x, int w); void yuv_16_black (uint16_t, bool); static uint16_t swap_16 (uint16_t); void video_range_to_full_range (); 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) Alignment _alignment; }; extern PositionImage merge (std::list images, Image::Alignment alignment); extern bool operator== (Image const & a, Image const & b); #endif