1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
|
/*
* 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 M4PTO3GPP_InternalTypes.h
* @brief Picture to 3gpp Service internal definitions
* @note This file contains all enum and types not visible to the external world.
******************************************************************************
*/
#ifndef __M4PTO3GPP_INTERNALTYPES_H__
#define __M4PTO3GPP_INTERNALTYPES_H__
#define M4PTO3GPP_VERSION_MAJOR 3
#define M4PTO3GPP_VERSION_MINOR 0
#define M4PTO3GPP_VERSION_REVISION 6
/**
* M4PTO3GPP public API and types */
#include "M4PTO3GPP_API.h"
#include "M4_Utils.h"
/**
* Internally used modules */
#include "M4WRITER_common.h" /* Write 3GPP file */
#include "M4READER_Common.h" /* Read AMR file */
#include "M4ENCODER_common.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
******************************************************************************
* enum M4PTO3GPP_States
* @brief Main state machine of the M4PTO3GPP.
******************************************************************************
*/
typedef enum
{
M4PTO3GPP_kState_CREATED = 0, /**< M4PTO3GPP_Init has been called */
M4PTO3GPP_kState_OPENED = 1, /**< M4PTO3GPP_Open has been called */
M4PTO3GPP_kState_READY = 2, /**< Step can be called */
M4PTO3GPP_kState_FINISHED = 3, /**< Transcoding is finished */
M4PTO3GPP_kState_CLOSED = 4 /**< Output file has been created */
}
M4PTO3GPP_States;
/**
******************************************************************************
* enum M4PTO3GPP_StreamState
* @brief State of a media stream encoding (audio or video).
******************************************************************************
*/
typedef enum
{
M4PTO3GPP_kStreamState_NOSTREAM = 0, /**< No stream present */
M4PTO3GPP_kStreamState_STARTED = 1, /**< The stream encoding is in progress */
M4PTO3GPP_kStreamState_FINISHED = 2 /**< The stream has finished encoding */
}
M4PTO3GPP_StreamState;
/*
* Definition of max AU size */
#define M4PTO3GPP_VIDEO_MIN_COMPRESSION_RATIO 0.8F /**< Max AU size will be 0.8 times the
YUV4:2:0 frame size */
#define M4PTO3GPP_VIDEO_AU_SIZE_TO_CHUNCK_SIZE_RATIO 1.2F /**< Max chunk size will be 1.2 times
the max AU size */
#define M4PTO3GPP_AUDIO_MAX_AU_SIZE 1000 /**< AAC max AU size seems to be
about 850 bytes */
#define M4PTO3GPP_AUDIO_MAX_CHUNK_SIZE 5000
/**
******************************************************************************
* enum anonymous enum
* @brief enum to keep track of the encoder state
******************************************************************************
*/
enum
{
M4PTO3GPP_kNoEncoder,
M4PTO3GPP_kEncoderClosed,
M4PTO3GPP_kEncoderStopped,
M4PTO3GPP_kEncoderRunning
};
/**
******************************************************************************
* structure M4PTO3GPP_InternalContext
* @brief This structure defines the M4PTO3GPP context (private)
* @note This structure is used for all M4PTO3GPP calls to store the context
******************************************************************************
*/
typedef struct
{
/**
* M4PTO3GPP main variables */
M4PTO3GPP_States m_State; /**< M4PTO3GPP internal state */
M4PTO3GPP_Params m_Params; /**< M4PTO3GPP parameters, set by the user */
M4PTO3GPP_StreamState m_VideoState; /**< State of the video encoding */
M4PTO3GPP_StreamState m_AudioState; /**< State of the audio encoding */
/**
* OSAL file read/write functions */
M4OSA_FileReadPointer* pOsalFileRead; /**< OSAL file read functions,
to be provided by user */
M4OSA_FileWriterPointer* pOsalFileWrite; /**< OSAL file write functions,
to be provided by user */
/**
* Reader stuff */
M4_AccessUnit* m_pReaderAudioAU; /**< Read audio access unit */
M4_AudioStreamHandler* m_pReaderAudioStream;/**< Description of the read audio stream */
/**
* Writer stuff */
M4SYS_AccessUnit m_WriterVideoAU; /**< Written video access unit */
M4SYS_AccessUnit m_WriterAudioAU; /**< Written audio access unit */
M4ENCODER_Header* m_pEncoderHeader; /**< Sequence header returned by the
encoder at encoder create (if any) */
M4SYS_StreamDescription* m_pWriterVideoStream; /**< Description of the written
video stream */
M4SYS_StreamDescription* m_pWriterAudioStream; /**< Description of the written
audio stream */
M4WRITER_StreamVideoInfos* m_pWriterVideoStreamInfo; /**< Video properties of the written
video stream */
M4WRITER_StreamAudioInfos* m_pWriterAudioStreamInfo; /**< Audio properties of the written
audio stream */
/**
* Contexts of the used modules */
M4OSA_Void* m_pAudioReaderContext; /**< Context of the audio reader module*/
M4OSA_Void* m_p3gpWriterContext; /**< Context of the 3GP writer module */
M4OSA_Void* m_pMp4EncoderContext; /**< Mp4 encoder context */
M4OSA_UInt32 m_eEncoderState;
/**
* Reader Interfaces */
M4READER_GlobalInterface* m_pReaderGlobInt; /**< Reader common interface, global part */
M4READER_DataInterface* m_pReaderDataInt; /**< Reader common interface, data part */
/**
* Writer Interfaces */
M4WRITER_GlobalInterface* m_pWriterGlobInt; /**< Writer common interface, global part */
M4WRITER_DataInterface* m_pWriterDataInt; /**< Writer common interface, data part */
/**
* Encoder Interfaces */
M4ENCODER_GlobalInterface* m_pEncoderInt; /**< Encoder common interface */
M4OSA_Void* m_pEncoderExternalAPI;
M4OSA_Void* m_pEncoderUserData;
/**
* */
M4VIFI_ImagePlane* pSavedPlane;
M4OSA_UInt32 uiSavedDuration;
/**
* Video rate control stuff */
M4_MediaTime m_dLastVideoRegulCts; /**< Last time (CTS) the video bitrate
regulation has been called */
M4_MediaTime m_mtCts; /**< Current video cts */
M4_MediaTime m_mtNextCts; /**< Next video CTS to transcode */
M4_MediaTime m_mtAudioCts; /**< Current audio cts */
M4_MediaTime m_AudioOffSet; /**< Audio Offset to add to the cts in loop mode*/
M4_MediaTime m_PrevAudioCts; /**< Previous audio cts for AAC looping */
M4_MediaTime m_DeltaAudioCts; /**< Delta audio cts for AAC looping */
M4OSA_UInt32 m_CurrentFileSize; /**< Current Output file size */
M4OSA_UInt32 m_MaxFileSize; /**< Max Output file size */
M4OSA_Bool m_IsLastPicture; /**< A boolean that signals to the encoder that
this is the last frame to be encoded*/
M4OSA_Bool m_bLastInternalCallBack;
M4OSA_UInt32 m_NbCurrentFrame; /**< Index of the current YUV frame encoded */
/**
* Audio padding mode */
M4OSA_Bool m_bAudioPaddingSilence; /**< A boolean that signals that audio
AU will be padded by silence */
} M4PTO3GPP_InternalContext;
/**
******************************************************************************
* M4OSA_ERR M4PTO3GPP_applyVPP(M4VPP_Context pContext, M4VIFI_ImagePlane* pPlaneIn,
* M4VIFI_ImagePlane* pPlaneOut)
* @brief Call an external callback to get the picture to encode
* @note It is called by the video encoder
* @param pContext (IN) VPP context, which actually is the M4PTO3GPP
* internal context in our case
* @param pPlaneIn (IN) Contains the image
* @param pPlaneOut (IN/OUT) Pointer to an array of 3 planes that will contain the
* output YUV420 image read with the m_pPictureCallbackFct
* @return M4NO_ERROR: No error
* @return Any error returned by an underlaying module
******************************************************************************
*/
M4OSA_ERR M4PTO3GPP_applyVPP(M4VPP_Context pContext, M4VIFI_ImagePlane* pPlaneIn,
M4VIFI_ImagePlane* pPlaneOut);
#ifdef __cplusplus
}
#endif
#endif /* __M4PTO3GPP_INTERNALTYPES_H__ */
|
