/* 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 component) 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; std::shared_ptr crop(Crop crop) 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; } bool has_alpha() const; 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(); std::pair, dcp::Size> crop_source_pointers(Crop crop) const; 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