OpenH264 & h264_impl for webrtc iOS

/*! * \copy * Copyright (c) 2013, Cisco Systems * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * */ #ifndef WELS_VIDEO_CODEC_APPLICATION_DEFINITION_H__ #define WELS_VIDEO_CODEC_APPLICATION_DEFINITION_H__ /** * @file codec_app_def.h * @brief Data and /or structures introduced in Cisco OpenH264 application */ #include "codec_def.h" /* Constants */ #define MAX_TEMPORAL_LAYER_NUM 4 #define MAX_SPATIAL_LAYER_NUM 4 #define MAX_QUALITY_LAYER_NUM 4 #define MAX_LAYER_NUM_OF_FRAME 128 #define MAX_NAL_UNITS_IN_LAYER 128 ///< predetermined here, adjust it later if need #define MAX_RTP_PAYLOAD_LEN 1000 #define AVERAGE_RTP_PAYLOAD_LEN 800 #define SAVED_NALUNIT_NUM_TMP ( (MAX_SPATIAL_LAYER_NUM*MAX_QUALITY_LAYER_NUM) + 1 + MAX_SPATIAL_LAYER_NUM ) ///< SPS/PPS + SEI/SSEI + PADDING_NAL #define MAX_SLICES_NUM_TMP ( ( MAX_NAL_UNITS_IN_LAYER - SAVED_NALUNIT_NUM_TMP ) / 3 ) #define AUTO_REF_PIC_COUNT -1 ///< encoder selects the number of reference frame automatically #define UNSPECIFIED_BIT_RATE 0 ///< to do: add detail comment /** * @brief Struct of OpenH264 version */ /// /// E.g. SDK version is 1.2.0.0, major version number is 1, minor version number is 2, and revision number is 0. typedef struct _tagVersion { unsigned int uMajor; ///< The major version number unsigned int uMinor; ///< The minor version number unsigned int uRevision; ///< The revision number unsigned int uReserved; ///< The reserved number, it should be 0. } OpenH264Version; /** * @brief Decoding status */ typedef enum { /** * Errors derived from bitstream parsing */ dsErrorFree = 0x00, ///< bit stream error-free dsFramePending = 0x01, ///< need more throughput to generate a frame output, dsRefLost = 0x02, ///< layer lost at reference frame with temporal id 0 dsBitstreamError = 0x04, ///< error bitstreams(maybe broken internal frame) the decoder cared dsDepLayerLost = 0x08, ///< dependented layer is ever lost dsNoParamSets = 0x10, ///< no parameter set NALs involved dsDataErrorConcealed = 0x20, ///< current data error concealed specified /** * Errors derived from logic level */ dsInvalidArgument = 0x1000, ///< invalid argument specified dsInitialOptExpected = 0x2000, ///< initializing operation is expected dsOutOfMemory = 0x4000, ///< out of memory due to new request /** * ANY OTHERS? */ dsDstBufNeedExpan = 0x8000 ///< actual picture size exceeds size of dst pBuffer feed in decoder, so need expand its size } DECODING_STATE; /** * @brief Option types introduced in SVC encoder application */ typedef enum { ENCODER_OPTION_DATAFORMAT = 0, ENCODER_OPTION_IDR_INTERVAL, ///< IDR period,0/-1 means no Intra period (only the first frame); lager than 0 means the desired IDR period, must be multiple of (2^temporal_layer) ENCODER_OPTION_SVC_ENCODE_PARAM_BASE, ///< structure of Base Param ENCODER_OPTION_SVC_ENCODE_PARAM_EXT, ///< structure of Extension Param ENCODER_OPTION_FRAME_RATE, ///< maximal input frame rate, current supported range: MAX_FRAME_RATE = 30,MIN_FRAME_RATE = 1 ENCODER_OPTION_BITRATE, ENCODER_OPTION_MAX_BITRATE, ENCODER_OPTION_INTER_SPATIAL_PRED, ENCODER_OPTION_RC_MODE, ENCODER_PADDING_PADDING, ///< 0:disable padding;1:padding ENCODER_OPTION_PROFILE, ///< assgin the profile for each layer ENCODER_OPTION_LEVEL, ///< assgin the level for each layer ENCODER_OPTION_NUMBER_REF, ///< the number of refererence frame ENCODER_OPTION_DELIVERY_STATUS, ///< the delivery info which is a feedback from app level ENCODER_LTR_RECOVERY_REQUEST, ENCODER_LTR_MARKING_FEEDBACK, ENCODER_LTR_MARKING_PERIOD, ENCODER_OPTION_LTR, ///< 0:disable LTR;larger than 0 enable LTR; LTR number is fixed to be 2 in current encoder ENCODER_OPTION_COMPLEXITY, ENCODER_OPTION_ENABLE_SSEI, ///< enable SSEI: true--enable ssei; false--disable ssei ENCODER_OPTION_ENABLE_PREFIX_NAL_ADDING, ///< enable prefix: true--enable prefix; false--disable prefix ENCODER_OPTION_ENABLE_SPS_PPS_ID_ADDITION, ///< enable pSps/pPps id addition: true--enable pSps/pPps id; false--disable pSps/pPps id addistion ENCODER_OPTION_CURRENT_PATH, ENCODER_OPTION_DUMP_FILE, ///< dump layer reconstruct frame to a specified file ENCODER_OPTION_TRACE_LEVEL, ///< trace info based on the trace level ENCODER_OPTION_TRACE_CALLBACK, ///< a void (*)(void* context, int level, const char* message) function which receives log messages ENCODER_OPTION_TRACE_CALLBACK_CONTEXT, ///< context info of trace callback ENCODER_OPTION_GET_STATISTICS, ///< read only ENCODER_OPTION_STATISTICS_LOG_INTERVAL, ///< log interval in millisecond ENCODER_OPTION_IS_LOSSLESS_LINK, ///< advanced algorithmetic settings ENCODER_OPTION_BITS_VARY_PERCENTAGE ///< bit vary percentage } ENCODER_OPTION; /** * @brief Option types introduced in decoder application */ typedef enum { DECODER_OPTION_DATAFORMAT = 0, ///< color format, now supports 23 only (I420) DECODER_OPTION_END_OF_STREAM, ///< end of stream flag DECODER_OPTION_VCL_NAL, ///< feedback whether or not have VCL NAL in current AU for application layer DECODER_OPTION_TEMPORAL_ID, ///< feedback temporal id for application layer DECODER_OPTION_FRAME_NUM, ///< feedback current decoded frame number DECODER_OPTION_IDR_PIC_ID, ///< feedback current frame belong to which IDR period DECODER_OPTION_LTR_MARKING_FLAG, ///< feedback wether current frame mark a LTR DECODER_OPTION_LTR_MARKED_FRAME_NUM, ///< feedback frame num marked by current Frame DECODER_OPTION_ERROR_CON_IDC, ///< not finished yet, indicate decoder error concealment status, in progress DECODER_OPTION_TRACE_LEVEL, DECODER_OPTION_TRACE_CALLBACK, ///< a void (*)(void* context, int level, const char* message) function which receives log messages DECODER_OPTION_TRACE_CALLBACK_CONTEXT,///< context info of trace callbac DECODER_OPTION_GET_STATISTICS } DECODER_OPTION; /** * @brief Enumerate the type of error concealment methods */ typedef enum { ERROR_CON_DISABLE = 0, ERROR_CON_FRAME_COPY, ERROR_CON_SLICE_COPY, ERROR_CON_FRAME_COPY_CROSS_IDR, ERROR_CON_SLICE_COPY_CROSS_IDR, ERROR_CON_SLICE_COPY_CROSS_IDR_FREEZE_RES