xref: /frameworks/av/libvideoeditor/vss/common/inc/M4_VideoEditingCommon.h

/*
 * Copyright (C) 2011 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/**
 ******************************************************************************
 * @file    M4_VideoEditingCommon.h
 * @brief    Video Editing (VSS3GPP, MCS, PTO3GPP) common definitions
 * @note
 ******************************************************************************
*/

#ifndef __M4_VIDEOEDITINGCOMMON_H__
#define __M4_VIDEOEDITINGCOMMON_H__

#ifdef __cplusplus
extern "C" {
#endif

/**
 *    Version */
/* CHANGE_VERSION_HERE */
#define M4VIDEOEDITING_VERSION_MAJOR    3
#define M4VIDEOEDITING_VERSION_MINOR    1
#define M4VIDEOEDITING_VERSION_REVISION    0

#define M4VIDEOEDITING_VIDEO_UNKNOWN_PROFILE 0x7fffffff
#define M4VIDEOEDITING_VIDEO_UNKNOWN_LEVEL 0x7fffffff

/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_FileType
 * @brief    This enum defines the file format type to be used
 ******************************************************************************
*/
typedef enum {
    M4VIDEOEDITING_kFileType_3GPP        = 0,      /**< 3GPP file media type : input & output */
    M4VIDEOEDITING_kFileType_MP4         = 1,      /**< MP4  file media type : input          */
    M4VIDEOEDITING_kFileType_AMR         = 2,      /**< AMR  file media type : input & output */
    M4VIDEOEDITING_kFileType_MP3         = 3,      /**< MP3  file media type : input          */
    M4VIDEOEDITING_kFileType_PCM         = 4,      /**< PCM RAW file media type : input    RC */
    M4VIDEOEDITING_kFileType_JPG         = 5,      /**< STILL PICTURE FEATURE: JPG file media
                                                        type : input AND OUTPUT */
    M4VIDEOEDITING_kFileType_BMP         = 6,      /**< STILL PICTURE FEATURE: BMP file media
                                                        type : input only */
    M4VIDEOEDITING_kFileType_GIF         = 7,      /**< STILL PICTURE FEATURE: GIF file media
                                                        type : input only */
    M4VIDEOEDITING_kFileType_PNG         = 8,      /**< STILL PICTURE FEATURE: PNG file media
                                                        type : input only */
    M4VIDEOEDITING_kFileType_ARGB8888    = 9,      /**< STILL PICTURE FEATURE: ARGB8888 file
                                                        media type : input only */
    M4VIDEOEDITING_kFileType_M4V         = 10,     /**< M4V  file media type : input only     */
    M4VIDEOEDITING_kFileType_Unsupported = 255     /**< Unsupported file media type           */
} M4VIDEOEDITING_FileType;


/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_VideoFormat
 * @brief    This enum defines the avalaible video compression formats.
 ******************************************************************************
*/
typedef enum
{
    M4VIDEOEDITING_kNoneVideo = 0, /**< Video not present */
    M4VIDEOEDITING_kH263 = 1, /**< H263 video */
    M4VIDEOEDITING_kH264 = 2,    /**< H264 video */
    M4VIDEOEDITING_kMPEG4 = 3, /**< MPEG-4 video */
    M4VIDEOEDITING_kNullVideo = 254,  /**< Do not care video type, use NULL encoder */
    M4VIDEOEDITING_kUnsupportedVideo = 255    /**< Unsupported video stream type */
} M4VIDEOEDITING_VideoFormat;

/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_AudioFormat
 * @brief    This enum defines the avalaible audio format.
 * @note    HE_AAC, HE_AAC_v2 and MP3 can not be used for the output audio format
 ******************************************************************************
*/
typedef enum {
    M4VIDEOEDITING_kNoneAudio            = 0,    /**< Audio not present */
    M4VIDEOEDITING_kAMR_NB              = 1,    /**< AMR Narrow Band audio */
    M4VIDEOEDITING_kAAC                    = 2,    /**< AAC audio */
    M4VIDEOEDITING_kAACplus                = 3,    /**< AAC+ audio */
    M4VIDEOEDITING_keAACplus             = 4,    /**< Enhanced AAC+ audio */
    M4VIDEOEDITING_kMP3                 = 5,    /**< MP3 audio */
    M4VIDEOEDITING_kEVRC                = 6,    /**< EVRC audio */
    M4VIDEOEDITING_kPCM                 = 7,    /**< PCM audio */
    M4VIDEOEDITING_kNullAudio           = 254,  /**< Do not care audio type, use NULL encoder */
    M4VIDEOEDITING_kUnsupportedAudio    = 255    /**< Unsupported audio stream type */
} M4VIDEOEDITING_AudioFormat;

/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_VideoFrameSize
 * @brief    This enum defines the available output frame sizes.
 ******************************************************************************
*/
typedef enum
{
    M4VIDEOEDITING_kSQCIF=0, /**< SQCIF 128x96  */
    M4VIDEOEDITING_kQQVGA,   /**< QQVGA 160x120 */
    M4VIDEOEDITING_kQCIF,    /**< QCIF  176x144 */
    M4VIDEOEDITING_kQVGA,    /**< QVGA  320x240 */
    M4VIDEOEDITING_kCIF,     /**< CIF   352x288 */
    M4VIDEOEDITING_kVGA,     /**< VGA   640x480 */
/* +PR LV5807 */
    M4VIDEOEDITING_kWVGA,    /**< WVGA 800x480 */
    M4VIDEOEDITING_kNTSC,    /**< NTSC 720x480 */
/* -PR LV5807 */

/* +CR Google */
    M4VIDEOEDITING_k640_360,  /**< 640x360 */
    M4VIDEOEDITING_k854_480,  /**< 854x480 */
    M4VIDEOEDITING_k1280_720, /**< 720p 1280x720 */
    M4VIDEOEDITING_k1080_720, /**< 720p 1080x720 */
    M4VIDEOEDITING_k960_720,  /**< 720p 960x720 */
    M4VIDEOEDITING_k1920_1080 /**<1080p 1920x1080*/
/* -CR Google */

} M4VIDEOEDITING_VideoFrameSize;


/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_Videoframerate
 * @brief    This enum defines the available video framerates.
 ******************************************************************************
*/
typedef enum
{
    M4VIDEOEDITING_k5_FPS = 0,
    M4VIDEOEDITING_k7_5_FPS,
    M4VIDEOEDITING_k10_FPS,
    M4VIDEOEDITING_k12_5_FPS,
    M4VIDEOEDITING_k15_FPS,
    M4VIDEOEDITING_k20_FPS,
    M4VIDEOEDITING_k25_FPS,
    M4VIDEOEDITING_k30_FPS
} M4VIDEOEDITING_VideoFramerate;


/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_AudioSamplingFrequency
 * @brief    This enum defines the available output audio sampling frequencies
 * @note    8 kHz is the only supported frequency for AMR-NB output
 * @note    16 kHz is the only supported frequency for AAC output
 * @note    The recommended practice is to use the Default value when setting the encoding parameters
 ******************************************************************************
*/
typedef enum {
    M4VIDEOEDITING_kDefault_ASF    = 0,    /**< Default Audio Sampling Frequency for selected
                                                 Audio output format */
    M4VIDEOEDITING_k8000_ASF    = 8000,    /**< Note: Default audio Sampling Frequency for
                                                    AMR-NB output */
    M4VIDEOEDITING_k11025_ASF    = 11025,
    M4VIDEOEDITING_k12000_ASF    = 12000,
    M4VIDEOEDITING_k16000_ASF    = 16000,    /**< Note: Default audio Sampling Frequency
                                                     for AAC output */
    M4VIDEOEDITING_k22050_ASF    = 22050,
    M4VIDEOEDITING_k24000_ASF    = 24000,
    M4VIDEOEDITING_k32000_ASF    = 32000,
    M4VIDEOEDITING_k44100_ASF    = 44100,
    M4VIDEOEDITING_k48000_ASF    = 48000

} M4VIDEOEDITING_AudioSamplingFrequency;


/**
 ******************************************************************************
 * enum        M4VIDEOEDITING_Bitrate
 * @brief    This enum defines the available audio or video bitrates.
 ******************************************************************************
*/
typedef enum
{
    M4VIDEOEDITING_kVARIABLE_KBPS = -1,     /* no regulation */
    M4VIDEOEDITING_kUndefinedBitrate = 0,   /* undefined */
    M4VIDEOEDITING_k8_KBPS = 8000,
    M4VIDEOEDITING_k9_2_KBPS = 9200,        /* evrc only */
    M4VIDEOEDITING_k12_2_KBPS = 12200,      /* amr only */
    M4VIDEOEDITING_k16_KBPS = 16000,
    M4VIDEOEDITING_k24_KBPS = 24000,
    M4VIDEOEDITING_k32_KBPS = 32000,
    M4VIDEOEDITING_k40_KBPS = 40000,
    M4VIDEOEDITING_k48_KBPS = 48000,
    M4VIDEOEDITING_k56_KBPS = 56000,
    M4VIDEOEDITING_k64_KBPS = 64000,
    M4VIDEOEDITING_k80_KBPS = 80000,
    M4VIDEOEDITING_k96_KBPS = 96000,
    M4VIDEOEDITING_k112_KBPS = 112000,
    M4VIDEOEDITING_k128_KBPS = 128000,
    M4VIDEOEDITING_k160_KBPS = 160000,
    M4VIDEOEDITING_k192_KBPS = 192000,
    M4VIDEOEDITING_k224_KBPS = 224000,
    M4VIDEOEDITING_k256_KBPS = 256000,
    M4VIDEOEDITING_k288_KBPS = 288000,
    M4VIDEOEDITING_k320_KBPS = 320000,
    M4VIDEOEDITING_k384_KBPS = 384000,
    M4VIDEOEDITING_k512_KBPS = 512000,
    M4VIDEOEDITING_k800_KBPS = 800000,
/*+ New Encoder bitrates */
    M4VIDEOEDITING_k2_MBPS = 2000000,
    M4VIDEOEDITING_k5_MBPS = 5000000,
    M4VIDEOEDITING_k8_MBPS = 8000000,
/*- New Encoder bitrates */
} M4VIDEOEDITING_Bitrate;


/**
 ******************************************************************************
 * structure    M4VIDEOEDITING_FtypBox
 * @brief        Information to build the 'ftyp' atom
 ******************************************************************************
*/
#define M4VIDEOEDITING_MAX_COMPATIBLE_BRANDS 10
typedef struct
{
    /* All brand fields are actually char[4] stored in big-endian integer format */

    M4OSA_UInt32    major_brand;           /* generally '3gp4'            */
    M4OSA_UInt32    minor_version;         /* generally '0000' or 'x.x '  */
    M4OSA_UInt32    nbCompatibleBrands;    /* number of compatible brands */
    M4OSA_UInt32    compatible_brands[M4VIDEOEDITING_MAX_COMPATIBLE_BRANDS]; /* array of
                                                                         max compatible brands */

} M4VIDEOEDITING_FtypBox;

/* Some useful brands */
#define M4VIDEOEDITING_BRAND_0000  0x00000000
#define M4VIDEOEDITING_BRAND_3G2A  0x33673261
#define M4VIDEOEDITING_BRAND_3GP4  0x33677034
#define M4VIDEOEDITING_BRAND_3GP5  0x33677035
#define M4VIDEOEDITING_BRAND_3GP6  0x33677036
#define M4VIDEOEDITING_BRAND_AVC1  0x61766331
#define M4VIDEOEDITING_BRAND_EMP   0x656D7020
#define M4VIDEOEDITING_BRAND_ISOM  0x69736F6D
#define M4VIDEOEDITING_BRAND_MP41  0x6D703431
#define M4VIDEOEDITING_BRAND_MP42  0x6D703432
#define M4VIDEOEDITING_BRAND_VFJ1  0x76666A31

/**
 ******************************************************************************
 * enum     M4VIDEOEDITING_ClipProperties
 * @brief   This structure gathers the information related to an input file
 ******************************************************************************
*/
typedef struct {

    /**
     * Common */
    M4OSA_Bool                          bAnalysed;           /**< Flag to know if the file has
                                                                  been already analysed or not */
    M4OSA_UInt8                         Version[3];          /**< Version of the libraries used to
                                                                  perform the clip analysis */
    M4OSA_UInt32                        uiClipDuration;      /**< Clip duration (in ms) */
    M4VIDEOEDITING_FileType             FileType;            /**< .3gp, .amr, .mp3 */
    M4VIDEOEDITING_FtypBox              ftyp;                /**< 3gp 'ftyp' atom, major_brand =
                                                                    0 if not used */

    /**
     * Video */
    M4VIDEOEDITING_VideoFormat          VideoStreamType;     /**< Format of the video stream */
    M4OSA_UInt32                        uiClipVideoDuration; /**< Video track duration (in ms) */
    M4OSA_UInt32                        uiVideoBitrate;      /**< Video average bitrate (in bps)*/
    M4OSA_UInt32                        uiVideoMaxAuSize;    /**< Maximum Access Unit size of the
                                                                  video stream */
    M4OSA_UInt32                        uiVideoWidth;        /**< Video frame width */
    M4OSA_UInt32                        uiVideoHeight;       /**< Video frame height */
    M4OSA_UInt32                        uiVideoTimeScale;    /**< Video time scale */
    M4OSA_Float                         fAverageFrameRate;   /**< Average frame rate of the video
                                                                  stream */
    M4OSA_Int32 uiVideoLevel;   /**< video level*/
    M4OSA_Int32 uiVideoProfile; /**< video profile */

    M4OSA_Bool                          bMPEG4dataPartition; /**< MPEG-4 uses data partitioning */
    M4OSA_Bool                          bMPEG4rvlc;          /**< MPEG-4 uses RVLC tool */
    M4OSA_Bool                          bMPEG4resynchMarker; /**< MPEG-4 stream uses Resynch
                                                                   Marker */

    /**
     * Audio */
    M4VIDEOEDITING_AudioFormat          AudioStreamType;     /**< Format of the audio stream */
    M4OSA_UInt32                        uiClipAudioDuration; /**< Audio track duration (in ms) */
    M4OSA_UInt32                        uiAudioBitrate;      /**< Audio average bitrate (in bps) */
    M4OSA_UInt32                        uiAudioMaxAuSize;    /**< Maximum Access Unit size of the
                                                                    audio stream */
    M4OSA_UInt32                        uiNbChannels;        /**< Number of channels
                                                                    (1=mono, 2=stereo) */
    M4OSA_UInt32                        uiSamplingFrequency; /**< Sampling audio frequency
                                                           (8000 for amr, 16000 or more for aac) */
    M4OSA_UInt32                        uiExtendedSamplingFrequency; /**< Extended frequency for
                                                                         AAC+, eAAC+ streams */
    M4OSA_UInt32                        uiDecodedPcmSize;    /**< Size of the decoded PCM data */

    /**
     * Video editing compatibility chart */
    M4OSA_Bool      bVideoIsEditable;                        /**< Video stream can be decoded and
                                                                 re-encoded */
    M4OSA_Bool      bAudioIsEditable;                        /**< Audio stream can be decoded and
                                                                  re-encoded */
    M4OSA_Bool      bVideoIsCompatibleWithMasterClip;        /**< Video properties match reference
                                                                  clip properties */
    M4OSA_Bool      bAudioIsCompatibleWithMasterClip;        /**< Audio properties match reference
                                                                   clip properties */

    /**
     * Still Picture */
    M4OSA_UInt32                        uiStillPicWidth;        /**< Image width */
    M4OSA_UInt32                        uiStillPicHeight;       /**< Image height */
    M4OSA_UInt32                        uiClipAudioVolumePercentage;
    M4OSA_Bool                          bSetImageData;

    M4OSA_Int32     videoRotationDegrees;        /**< Video rotation degree */

} M4VIDEOEDITING_ClipProperties;


#ifdef __cplusplus
    }
#endif

#endif /* __M4_VIDEOEDITINGCOMMON_H__ */