cinelerra-5.0/cinelerra/videodevice.h

   1
   2 /*
   3  * CINELERRA
   4  * Copyright (C) 2008 Adam Williams <broadcast at earthling dot net>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  */
  21
  22 #ifndef VIDEODEVICE_H
  23 #define VIDEODEVICE_H
  24
  25 #include "asset.inc"
  26 #include "assets.inc"
  27 #include "audio1394.inc"
  28 #include "audiodevice.inc"
  29 #include "bccapture.inc"
  30 #include "bctimer.h"
  31 #include "canvas.inc"
  32 #include "channel.inc"
  33 #include "channeldb.inc"
  34 #include "device1394output.inc"
  35 #include "devicempeginput.inc"
  36 #include "edl.inc"
  37 #include "file.inc"
  38 #include "guicast.h"
  39 #include "mwindow.inc"
  40 #include "mutex.inc"
  41 #include "preferences.inc"
  42 #include "recordmonitor.inc"
  43 #include "thread.h"
  44 #include "picture.inc"
  45 #include "vdevicebase.inc"
  46 #include "vdevice1394.inc"
  47 #include "vdevicebuz.inc"
  48 #include "vdevicelml.inc"
  49 #include "vdevicev4l.inc"
  50 #include "vdevicex11.inc"
  51 #include "videoconfig.inc"
  52 #include "videowindow.inc"
  53
  54
  55 // The keepalive thread runs continuously during recording.
  56 // If the recording thread doesn't reset still_alive, failed is incremented.
  57 // Failed is set to 0 if the recording thread resets still_alive.
  58 // It calls goose_input in the VideoDevice.  The input driver should
  59 // trap goose_input and restart itself asynchronous of the recording thread.
  60
  61 // Number of seconds for keepalive to freak out
  62 #define KEEPALIVE_DELAY 0.5
  63
  64 class VideoDevice;
  65
  66 class KeepaliveThread : public Thread
  67 {
  68 public:
  69         KeepaliveThread(VideoDevice *device);
  70         ~KeepaliveThread();
  71
  72         void run();
  73         int reset_keepalive();   // Call after frame capture to reset counter
  74         int get_failed();
  75         int start_keepalive();
  76         int stop();
  77
  78         Timer timer;
  79         int still_alive;
  80         int failed;
  81         int interrupted;
  82         VideoDevice *device;
  83         Mutex *startup_lock;
  84         int capturing;
  85 };
  86
  87 class VideoDevice
  88 {
  89 public:
  90 // MWindow is required where picture settings are used, to get the defaults.
  91         VideoDevice(MWindow *mwindow = 0);
  92         ~VideoDevice();
  93
  94         int close_all();
  95
  96 // ===================================== Recording
  97         int open_input(VideoInConfig *config,
  98                 int input_x,
  99                 int input_y,
 100                 float input_z,
 101                 double frame_rate);
 102
 103 // Call the constructor of the desired device.
 104 // Used by fix_asset and open_input
 105         VDeviceBase* new_device_base();
 106
 107 // Used for dvb interface
 108         VDeviceBase* get_input_base();
 109 // Used for calling OpenGL functions
 110         VDeviceBase* get_output_base();
 111
 112 // Return 1 if the data is compressed.
 113 // Called by Record::run to determine if compression option is fixed.
 114 // Called by RecordVideo::rewind_file to determine if FileThread should call
 115 // write_compressed_frames or write_frames.
 116         static int is_compressed(int driver, int use_file, int use_fixed);
 117         int is_compressed(int use_file, int use_fixed);
 118
 119 // Load the specific channeldb for the device type
 120         static void load_channeldb(ChannelDB *channeldb, VideoInConfig *vconfig_in);
 121         static void save_channeldb(ChannelDB *channeldb, VideoInConfig *vconfig_in);
 122
 123
 124 // Return codec to store on disk if compressed
 125         void fix_asset(Asset *asset, int driver);
 126         static const char* drivertostr(int driver);
 127 // Get the best colormodel for recording given the file format.
 128 // Must be called between open_input and read_buffer.
 129         int get_best_colormodel(Asset *asset);
 130 // drop frames
 131         int drop_frames(int frames);
 132 // Specify the audio device opened concurrently with this video device
 133         int set_adevice(AudioDevice *adevice);
 134 // Return 1 if capturing locked up
 135         int get_failed();
 136 // Interrupt a crashed DV device
 137         int interrupt_crash();
 138 // Schedule capture size to be changed.
 139         int set_translation(int input_x, int input_y);
 140 // Change the channel
 141         int set_channel(Channel *channel);
 142         int set_captioning(int mode);
 143 // Set the quality of the JPEG compressor
 144         void set_quality(int quality);
 145 // Change field order
 146         int set_field_order(int odd_field_first);
 147 // Set frames to clear after translation change.
 148         int set_latency_counter(int value);
 149 // Values from -100 to 100
 150         int set_picture(PictureConfig *picture);
 151         int capture_frame(int frame_number);  // Start the frame_number capturing
 152         int read_buffer(VFrame *frame);  // Read the next frame off the device
 153         int has_signal();
 154         int create_channeldb(ArrayList<Channel*> *channeldb);
 155         int frame_to_vframe(VFrame *frame, unsigned char *input); // Translate the captured frame to a VFrame
 156         int initialize();
 157         ArrayList<Channel*>* get_inputs();
 158 // Create new input source if it doesn't match device_name.
 159 // Otherwise return it.
 160         Channel* new_input_source(char *device_name);
 161         BC_Bitmap* get_bitmap();
 162         DeviceMPEGInput *mpeg_device();
 163
 164 // Used by all devices to cause fd's to be not copied in fork operations.
 165         int set_cloexec_flag(int desc, int value);
 166
 167 // ================================== Playback
 168         int open_output(VideoOutConfig *config,
 169                                         float rate,
 170                                         int out_w,
 171                                         int out_h,
 172                                         Canvas *output,
 173                                         int single_frame);
 174         void set_cpus(int cpus);
 175 // Slippery is only used for hardware compression drivers
 176         int start_playback();
 177         int interrupt_playback();
 178 // Get output buffer for playback using colormodel.
 179 // colormodel argument should be as close to best_colormodel as possible
 180         void new_output_buffer(VFrame **output, int colormodel);
 181         int wait_for_startup();
 182         int wait_for_completion();
 183         int output_visible();     // Whether the output is visible or not.
 184         int stop_playback();
 185         void goose_input();
 186         long current_position();     // last frame rendered
 187         double get_timestamp();      // timestamp last frame
 188         double device_timestamp();   // device presentation timestamp
 189 // absolute frame of last frame in buffer.
 190 // The EDL parameter is passed to Canvas and can be 0.
 191         int write_buffer(VFrame *output, EDL *edl);
 192 // record menu auto config update
 193         void auto_update(double rate, int width, int height);
 194         int config_updated();
 195         void config_update();
 196         int get_iwidth() { return capture_w; }
 197         int get_iheight() { return capture_h; }
 198         double get_irate() { return frame_rate; }
 199 // record raw stream on file descr fd, to close use fd=-1
 200 //  bsz records up to bsz bytes of past buffer data in first_write
 201         int start_toc(const char *path, const char *toc_path);
 202         int start_record(int fd, int bsz=0);
 203         int stop_record();
 204         int total_video_streams();
 205 // skimming
 206         int get_video_pid(int track);
 207         int get_video_info(int track, int &pid, double &framerate,
 208                 int &width, int &height, char *title=0);
 209         int get_thumbnail(int stream, int64_t &position,
 210                 unsigned char *&thumbnail, int &ww, int &hh);
 211         int set_skimming(int track, int skim, skim_fn fn, void *vp);
 212
 213 // Flag when output is interrupted
 214         int interrupt;
 215 // Compression format in use by the output device
 216         int output_format;
 217         int is_playing_back;
 218 // Audio device to share data with
 219         AudioDevice *adevice;
 220 // Reading data from the audio device.  This is set by the video device.
 221         int sharing;
 222 // Synchronize the close devices
 223         int done_sharing;
 224         Mutex *sharing_lock;
 225
 226 // frame rates
 227         float orate, irate;
 228 // timer for displaying frames in the current buffer
 229         Timer buffer_timer;
 230 // timer for getting frame rate
 231         Timer rate_timer;
 232 // size of output frame being fed to device during playback
 233         int out_w, out_h;
 234 // modes
 235         int r, w;
 236 // time from start of previous frame to start of next frame in ms
 237         long frame_delay;
 238 // CPU count for MJPEG compression
 239         int cpus;
 240
 241
 242         int is_recording; // status of thread
 243         double frame_rate; // Frame rate to set in device
 244         double timestamp;
 245 // Location of input frame in captured frame
 246         int frame_in_capture_x1, frame_in_capture_x2, frame_in_capture_y1, frame_in_capture_y2;
 247         int capture_in_frame_x1, capture_in_frame_x2, capture_in_frame_y1, capture_in_frame_y2;
 248 // Size of raw captured frame
 249         int capture_w, capture_h;
 250         int input_x, input_y;
 251         float input_z;
 252 // Captured frame size can only be changed when ready
 253         int new_input_x, new_input_y;
 254         float new_input_z;
 255         int frame_resized;
 256 // When the frame is resized, need to clear all the buffer frames.
 257         int latency_counter;
 258         int capturing;
 259         int swap_bytes;
 260         int in_config_updated;
 261
 262
 263 // All the input sources on the device
 264         ArrayList<Channel*> input_sources;
 265         int odd_field_first;
 266 // Quality for the JPEG compressor
 267         int quality;
 268 // Single frame mode for playback
 269         int single_frame;
 270
 271 // Copy of the most recent channel set by set_channel
 272         Channel *channel;
 273 // Flag for subdevice to change channels when it has a chance
 274         int channel_changed;
 275         Mutex *channel_lock;
 276
 277 // Copy of the most recent picture controls
 278         int picture_changed;
 279         PictureConfig *picture;
 280         Mutex *picture_lock;
 281
 282
 283 // Change the capture size when ready
 284         int update_translation();
 285
 286         VDeviceBase *input_base;
 287         VDeviceBase *output_base;
 288         VideoInConfig *in_config;
 289         VideoOutConfig *out_config;
 290         KeepaliveThread *keepalive;
 291         MWindow *mwindow;
 292 };
 293
 294
 295
 296 #endif