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 <dcp/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;
34 class PlayerVideoFrame;
36 /** @class EncodedData
37 * @brief Container for J2K-encoded data.
39 class EncodedData : public boost::noncopyable
42 /** @param s Size of data, in bytes */
45 EncodedData (boost::filesystem::path);
47 virtual ~EncodedData ();
49 void send (boost::shared_ptr<Socket> socket);
50 void write (boost::shared_ptr<const Film>, int, Eyes) const;
51 void write_info (boost::shared_ptr<const Film>, int, Eyes, dcp::FrameInfo) const;
54 uint8_t* data () const {
58 /** @return data size, in bytes */
64 uint8_t* _data; ///< data
65 int _size; ///< data size in bytes
68 /** @class LocallyEncodedData
69 * @brief EncodedData that was encoded locally; this class
70 * just keeps a pointer to the data, but does no memory
73 class LocallyEncodedData : public EncodedData
76 /** @param d Data (which will be copied by this class)
77 * @param s Size of data, in bytes.
79 LocallyEncodedData (uint8_t* d, int s);
82 /** @class RemotelyEncodedData
83 * @brief EncodedData that is being read from a remote server;
84 * this class allocates and manages memory for the data.
86 class RemotelyEncodedData : public EncodedData
89 RemotelyEncodedData (int s);
92 /** @class DCPVideoFrame
93 * @brief A single frame of video destined for a DCP.
95 * Given an Image and some settings, this class knows how to encode
96 * the image to J2K either on the local host or on a remote server.
98 * Objects of this class are used for the queue that we keep
99 * of images that require encoding.
101 class DCPVideoFrame : public boost::noncopyable
104 DCPVideoFrame (boost::shared_ptr<const PlayerVideoFrame>, int, int, int, Resolution, boost::shared_ptr<Log>);
105 DCPVideoFrame (boost::shared_ptr<const PlayerVideoFrame>, cxml::ConstNodePtr, boost::shared_ptr<Log>);
107 boost::shared_ptr<EncodedData> encode_locally ();
108 boost::shared_ptr<EncodedData> encode_remotely (ServerDescription);
118 void add_metadata (xmlpp::Element *) const;
120 boost::shared_ptr<const PlayerVideoFrame> _frame;
121 int _index; ///< frame index within the DCP's intrinsic duration
122 int _frames_per_second; ///< Frames per second that we will use for the DCP
123 int _j2k_bandwidth; ///< J2K bandwidth to use
124 Resolution _resolution; ///< Resolution (2K or 4K)
126 boost::shared_ptr<Log> _log; ///< log