h264.h - mozsearch

Enable keyboard shortcuts

/*

 *  Copyright (c) 2015 The WebRTC project authors. All Rights Reserved.

 *  Use of this source code is governed by a BSD-style license

 *  that can be found in the LICENSE file in the root of the source

 *  tree. An additional intellectual property rights grant can be found

 *  in the file PATENTS.  All contributing project authors may

 *  be found in the AUTHORS file in the root of the source tree.

*/

#ifndef MODULES_VIDEO_CODING_CODECS_H264_INCLUDE_H264_H_

#define MODULES_VIDEO_CODING_CODECS_H264_INCLUDE_H264_H_

#include <memory>

#include <string>

#include <vector>

#include "absl/base/nullability.h"

#include "api/environment/environment.h"

#include "api/video_codecs/h264_profile_level_id.h"

#include "api/video_codecs/scalability_mode.h"

#include "api/video_codecs/sdp_video_format.h"

#include "api/video_codecs/video_decoder.h"

#include "api/video_codecs/video_encoder.h"

#include "modules/video_coding/codecs/h264/include/h264_globals.h"

#include "rtc_base/system/rtc_export.h"

namespace webrtc {

// Creates an H264 SdpVideoFormat entry with specified paramters.

RTC_EXPORT SdpVideoFormat

CreateH264Format(H264Profile profile,

                 H264Level level,

                 const std::string& packetization_mode,

                 bool add_scalability_modes = false);

// Set to disable the H.264 encoder/decoder implementations that are provided if

// `rtc_use_h264` build flag is true (if false, this function does nothing).

// This function should only be called before or during WebRTC initialization

// and is not thread-safe.

RTC_EXPORT void DisableRtcUseH264();

// Returns a vector with all supported internal H264 encode profiles that we can

// negotiate in SDP, in order of preference.

std::vector<SdpVideoFormat> SupportedH264Codecs(

    bool add_scalability_modes = false);

// Returns a vector with all supported internal H264 decode profiles that we can

// negotiate in SDP, in order of preference. This will be available for receive

// only connections.

std::vector<SdpVideoFormat> SupportedH264DecoderCodecs();

class RTC_EXPORT H264Encoder {

 public:

  // If H.264 is supported (any implementation).

  static bool IsSupported();

  static bool SupportsScalabilityMode(ScalabilityMode scalability_mode);

};

struct H264EncoderSettings {

  // Use factory function rather than constructor to allow to create

  // `H264EncoderSettings` with designated initializers.

  static H264EncoderSettings Parse(const SdpVideoFormat& format);

  H264PacketizationMode packetization_mode =

      H264PacketizationMode::NonInterleaved;

};

absl::Nonnull<std::unique_ptr<VideoEncoder>> CreateH264Encoder(

    const Environment& env,

    H264EncoderSettings settings = {});

class RTC_EXPORT H264Decoder : public VideoDecoder {

 public:

  static std::unique_ptr<H264Decoder> Create();

  static bool IsSupported();

  ~H264Decoder() override {}

};

}  // namespace webrtc

#endif  // MODULES_VIDEO_CODING_CODECS_H264_INCLUDE_H264_H_