2 Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
3 Taken from code Copyright (C) 2010-2011 Terrence Meiczinger
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 #include <libdcp/picture_mxf_writer.h>
24 /** @file src/dcp_video_frame.h
25 * @brief A single frame of video destined for a DCP.
29 class ServerDescription;
35 /** @class EncodedData
36 * @brief Container for J2K-encoded data.
38 class EncodedData : public boost::noncopyable
41 /** @param s Size of data, in bytes */
44 EncodedData (boost::filesystem::path);
46 virtual ~EncodedData ();
48 void send (boost::shared_ptr<Socket> socket);
49 void write (boost::shared_ptr<const Film>, int, Eyes) const;
50 void write_info (boost::shared_ptr<const Film>, int, Eyes, dcp::FrameInfo) const;
53 uint8_t* data () const {
57 /** @return data size, in bytes */
63 uint8_t* _data; ///< data
64 int _size; ///< data size in bytes
67 /** @class LocallyEncodedData
68 * @brief EncodedData that was encoded locally; this class
69 * just keeps a pointer to the data, but does no memory
72 class LocallyEncodedData : public EncodedData
75 /** @param d Data (which will be copied by this class)
76 * @param s Size of data, in bytes.
78 LocallyEncodedData (uint8_t* d, int s);
81 /** @class RemotelyEncodedData
82 * @brief EncodedData that is being read from a remote server;
83 * this class allocates and manages memory for the data.
85 class RemotelyEncodedData : public EncodedData
88 RemotelyEncodedData (int s);
91 /** @class DCPVideoFrame
92 * @brief A single frame of video destined for a DCP.
94 * Given an Image and some settings, this class knows how to encode
95 * the image to J2K either on the local host or on a remote server.
97 * Objects of this class are used for the queue that we keep
98 * of images that require encoding.
100 class DCPVideoFrame : public boost::noncopyable
103 DCPVideoFrame (boost::shared_ptr<const Image>, int, Eyes, ColourConversion, int, int, Resolution, boost::shared_ptr<Log>);
104 DCPVideoFrame (boost::shared_ptr<const Image>, boost::shared_ptr<const cxml::Node>, boost::shared_ptr<Log>);
106 boost::shared_ptr<EncodedData> encode_locally ();
107 boost::shared_ptr<EncodedData> encode_remotely (ServerDescription);
119 void add_metadata (xmlpp::Element *) const;
121 boost::shared_ptr<const Image> _image;
122 int _frame; ///< frame index within the DCP's intrinsic duration
124 ColourConversion _conversion;
125 int _frames_per_second; ///< Frames per second that we will use for the DCP
126 int _j2k_bandwidth; ///< J2K bandwidth to use
127 Resolution _resolution; ///< Resolution (2K or 4K)
129 boost::shared_ptr<Log> _log; ///< log