OpenShot Library | libopenshot  0.3.1
ReaderBase.h
Go to the documentation of this file.
1 
9 // Copyright (c) 2008-2019 OpenShot Studios, LLC
10 //
11 // SPDX-License-Identifier: LGPL-3.0-or-later
12 
13 #ifndef OPENSHOT_READER_BASE_H
14 #define OPENSHOT_READER_BASE_H
15 
16 #include <map>
17 #include <memory>
18 #include <mutex>
19 #include <iostream>
20 #include <string>
21 #include <vector>
22 
23 #include "ChannelLayouts.h"
24 #include "Fraction.h"
25 #include "Json.h"
26 
27 namespace openshot
28 {
29  class CacheBase;
30  class ClipBase;
31  class Frame;
38  struct ReaderInfo
39  {
40  bool has_video;
41  bool has_audio;
43  float duration;
44  int64_t file_size;
45  int height;
46  int width;
52  std::string vcodec;
53  int64_t video_length;
56  bool interlaced_frame; // Are the contents of this frame interlaced
57  bool top_field_first; // Which interlaced field should be displayed first
58  std::string acodec;
61  int channels;
65  std::map<std::string, std::string> metadata;
66  };
67 
75  class ReaderBase
76  {
77  protected:
79  std::recursive_mutex getFrameMutex;
81 
82  public:
83 
85  ReaderBase();
86 
89 
91  openshot::ClipBase* ParentClip();
92 
94  void ParentClip(openshot::ClipBase* new_clip);
95 
97  virtual void Close() = 0;
98 
100  void DisplayInfo(std::ostream* out=&std::cout);
101 
103  virtual openshot::CacheBase* GetCache() = 0;
104 
111  virtual std::shared_ptr<openshot::Frame> GetFrame(int64_t number) = 0;
112 
114  virtual bool IsOpen() = 0;
115 
117  virtual std::string Name() = 0;
118 
119  // Get and Set JSON methods
120  virtual std::string Json() const = 0;
121  virtual void SetJson(const std::string value) = 0;
122  virtual Json::Value JsonValue() const = 0;
123  virtual void SetJsonValue(const Json::Value root) = 0;
124 
126  virtual void Open() = 0;
127 
128  virtual ~ReaderBase() = default;
129  };
130 
131 }
132 
133 #endif
Header file for Fraction class.
int width
The width of the video (in pixesl)
Definition: ReaderBase.h:46
float duration
Length of time (in seconds)
Definition: ReaderBase.h:43
This abstract class is the base class, used by all readers in libopenshot.
Definition: ReaderBase.h:75
bool has_video
Determines if this file has a video stream.
Definition: ReaderBase.h:40
int64_t file_size
Size of file (in bytes)
Definition: ReaderBase.h:44
int audio_bit_rate
The bit rate of the audio stream (in bytes)
Definition: ReaderBase.h:59
bool has_audio
Determines if this file has an audio stream.
Definition: ReaderBase.h:41
int audio_stream_index
The index of the audio stream.
Definition: ReaderBase.h:63
int64_t video_length
The number of frames in the video stream.
Definition: ReaderBase.h:53
int height
The height of the video (in pixels)
Definition: ReaderBase.h:45
openshot::Fraction video_timebase
The video timebase determines how long each frame stays on the screen.
Definition: ReaderBase.h:55
std::recursive_mutex getFrameMutex
Mutex for multiple threads.
Definition: ReaderBase.h:79
Header file for JSON class.
This class represents a fraction.
Definition: Fraction.h:30
std::map< std::string, std::string > metadata
An optional map/dictionary of metadata for this reader.
Definition: ReaderBase.h:65
This struct contains info about a media file, such as height, width, frames per second, etc...
Definition: ReaderBase.h:38
openshot::ChannelLayout channel_layout
The channel layout (mono, stereo, 5 point surround, etc...)
Definition: ReaderBase.h:62
Header file for ChannelLayout class.
All cache managers in libopenshot are based on this CacheBase class.
Definition: CacheBase.h:34
bool has_single_image
Determines if this file only contains a single image.
Definition: ReaderBase.h:42
ChannelLayout
This enumeration determines the audio channel layout (such as stereo, mono, 5 point surround...
This abstract class is the base class, used by all clips in libopenshot.
Definition: ClipBase.h:33
openshot::ReaderInfo info
Information about the current media file.
Definition: ReaderBase.h:88
openshot::Fraction audio_timebase
The audio timebase determines how long each audio packet should be played.
Definition: ReaderBase.h:64
std::string vcodec
The name of the video codec used to encode / decode the video stream.
Definition: ReaderBase.h:52
openshot::ClipBase * clip
Pointer to the parent clip instance (if any)
Definition: ReaderBase.h:80
This namespace is the default namespace for all code in the openshot library.
Definition: Compressor.h:28
int pixel_format
The pixel format (i.e. YUV420P, RGB24, etc...)
Definition: ReaderBase.h:47
openshot::Fraction display_ratio
The ratio of width to height of the video stream (i.e. 640x480 has a ratio of 4/3) ...
Definition: ReaderBase.h:51
int video_bit_rate
The bit rate of the video stream (in bytes)
Definition: ReaderBase.h:49
openshot::Fraction pixel_ratio
The pixel ratio of the video stream as a fraction (i.e. some pixels are not square) ...
Definition: ReaderBase.h:50
int channels
The number of audio channels used in the audio stream.
Definition: ReaderBase.h:61
int video_stream_index
The index of the video stream.
Definition: ReaderBase.h:54
openshot::Fraction fps
Frames per second, as a fraction (i.e. 24/1 = 24 fps)
Definition: ReaderBase.h:48
std::string acodec
The name of the audio codec used to encode / decode the video stream.
Definition: ReaderBase.h:58
int sample_rate
The number of audio samples per second (44100 is a common sample rate)
Definition: ReaderBase.h:60