git.sesse.net Git - nageru/blob - shared/mux.h

   1 #ifndef _MUX_H
   2 #define _MUX_H 1
   3
   4 // Wrapper around an AVFormat mux.
   5
   6 extern "C" {
   7 #include <libavcodec/avcodec.h>
   8 #include <libavformat/avformat.h>
   9 }
  10
  11 #include <sys/types.h>
  12 #include <atomic>
  13 #include <condition_variable>
  14 #include <functional>
  15 #include <mutex>
  16 #include <string>
  17 #include <utility>
  18 #include <thread>
  19 #include <vector>
  20
  21 #include "shared/timebase.h"
  22
  23 struct MuxMetrics {
  24         // “written” will usually be equal video + audio + mux overhead,
  25         // except that there could be buffered packets that count in audio or video
  26         // but not yet in written.
  27         std::atomic<int64_t> metric_video_bytes{0}, metric_audio_bytes{0}, metric_written_bytes{0};
  28
  29         // Registers in global_metrics.
  30         void init(const std::vector<std::pair<std::string, std::string>> &labels);
  31
  32         void reset()
  33         {
  34                 metric_video_bytes = 0;
  35                 metric_audio_bytes = 0;
  36                 metric_written_bytes = 0;
  37         }
  38 };
  39
  40 inline AVColorSpace get_color_space(bool ycbcr_rec709_coefficients)
  41 {
  42         if (ycbcr_rec709_coefficients) {
  43                 return AVCOL_SPC_BT709;
  44         } else {
  45                 return AVCOL_SPC_SMPTE170M;
  46         }
  47 }
  48
  49 class Mux {
  50 public:
  51         enum Codec {
  52                 CODEC_H264,
  53                 CODEC_NV12,  // Uncompressed 4:2:0.
  54                 CODEC_MJPEG
  55         };
  56         enum WithAudio {
  57                 WITH_AUDIO,
  58                 WITHOUT_AUDIO
  59         };
  60         enum WriteStrategy {
  61                 // add_packet() will write the packet immediately, unless plugged.
  62                 WRITE_FOREGROUND,
  63
  64                 // All writes will happen on a separate thread, so add_packet()
  65                 // won't block. Use this if writing to a file and you might be
  66                 // holding a mutex (because blocking I/O with a mutex held is
  67                 // not good). Note that this will clone every packet, so it has
  68                 // higher overhead.
  69                 WRITE_BACKGROUND,
  70         };
  71
  72         // Takes ownership of avctx. <write_callback> will be called every time
  73         // a write has been made to the video stream (id 0), with the pts of
  74         // the just-written frame. (write_callback can be nullptr.)
  75         // Does not take ownership of <metrics>; elements in there, if any,
  76         // will be added to.
  77         Mux(AVFormatContext *avctx, int width, int height, Codec video_codec, const std::string &video_extradata, const AVCodecParameters *audio_codecpar, AVColorSpace color_space, WithAudio with_audio, int time_base, std::function<void(int64_t)> write_callback, WriteStrategy write_strategy, const std::vector<MuxMetrics *> &metrics);
  78         ~Mux();
  79         void add_packet(const AVPacket &pkt, int64_t pts, int64_t dts, AVRational timebase = { 1, TIMEBASE }, int stream_index_override = -1);
  80
  81         // As long as the mux is plugged, it will not actually write anything to disk,
  82         // just queue the packets. Once it is unplugged, the packets are reordered by pts
  83         // and written. This is primarily useful if you might have two different encoders
  84         // writing to the mux at the same time (because one is shutting down), so that
  85         // pts might otherwise come out-of-order.
  86         //
  87         // You can plug and unplug multiple times; only when the plug count reaches zero,
  88         // something will actually happen.
  89         void plug();
  90         void unplug();
  91
  92 private:
  93         // If write_strategy == WRITE_FOREGORUND, Must be called with <mu> held.
  94         void write_packet_or_die(const AVPacket &pkt, int64_t unscaled_pts);
  95         void thread_func();
  96
  97         WriteStrategy write_strategy;
  98
  99         std::mutex mu;
 100
 101         // These are only in use if write_strategy == WRITE_BACKGROUND.
 102         std::atomic<bool> writer_thread_should_quit{false};
 103         std::thread writer_thread;
 104
 105         AVFormatContext *avctx;  // Protected by <mu>, iff write_strategy == WRITE_BACKGROUND.
 106         int plug_count = 0;  // Protected by <mu>.
 107
 108         // Protected by <mu>. If write_strategy == WRITE_FOREGROUND,
 109         // this is only in use when plugging.
 110         struct QueuedPacket {
 111                 AVPacket *pkt;
 112                 int64_t unscaled_pts;
 113         };
 114         std::vector<QueuedPacket> packet_queue;
 115         std::condition_variable packet_queue_ready;
 116
 117         AVStream *avstream_video, *avstream_audio;
 118
 119         std::function<void(int64_t)> write_callback;
 120         std::vector<MuxMetrics *> metrics;
 121
 122         friend struct PacketBefore;
 123 };
 124
 125 #endif  // !defined(_MUX_H)