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
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
|
/*
* 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 M4WRITER_common.h
* @brief VES writers shell interface.
* @note This file defines the types internally used by the VES to abstract writers
******************************************************************************
*/
#ifndef __M4WRITER_COMMON_H__
#define __M4WRITER_COMMON_H__
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
#include "M4OSA_Types.h"
#include "M4OSA_FileWriter.h" /* for M4OSA_FileWriterPointer */
#include "M4OSA_FileReader.h" /* for M4OSA_FileWriterPointer */
#include "M4OSA_OptionID.h" /* for M4OSA_OPTION_ID_CREATE() */
#include "M4OSA_CoreID.h" /* for M4WRITER_COMMON */
#include "M4SYS_Stream.h" /* for M4SYS_StreamID */
#include "M4SYS_AccessUnit.h" /* for M4SYS_AccessUnit */
/**
******************************************************************************
* MP4W Errors & Warnings definition
******************************************************************************
*/
#define M4WAR_WRITER_STOP_REQ M4OSA_ERR_CREATE(M4_WAR, M4WRITER_COMMON ,0x000001)
/**
******************************************************************************
* enum M4WRITER_OutputFileType
* @brief This enum defines the avalaible output file format.
******************************************************************************
*/
typedef enum
{
M4WRITER_kUnknown=-1,
M4WRITER_k3GPP=0, /**< 3GPP compliant file */
M4WRITER_kAVI=1, /**< AVI file */
M4WRITER_kAMR=2, /**< AMR file */
M4WRITER_kNETWORK3GPP=3, /**< 3GPP via TCP */
M4WRITER_kPCM=4, /**< PCM file */
M4WRITER_kJPEG=5, /**< JPEG EXIF writer */
M4WRITER_kMP3=6, /**< MP3 writer */
M4WRITER_kType_NB /* number of writers, keep it as last enum entry */
} M4WRITER_OutputFileType;
/**
******************************************************************************
* enum M4WRITER_OptionID
* @brief This enums defines all avalaible options. All the reuturned values are in
* M4OSA_UInt32 type.
******************************************************************************
*/
typedef enum {
M4WRITER_kMaxAUSize = M4OSA_OPTION_ID_CREATE (M4_READ|M4_WRITE, M4WRITER_COMMON, 0x01),
M4WRITER_kMaxChunckSize = M4OSA_OPTION_ID_CREATE (M4_READ|M4_WRITE, M4WRITER_COMMON, 0x02),
M4WRITER_kFileSize = M4OSA_OPTION_ID_CREATE (M4_READ , \
M4WRITER_COMMON, 0x03), /**< File size if the process was ended when we call the method */
M4WRITER_kFileSizeAudioEstimated= M4OSA_OPTION_ID_CREATE (M4_READ ,\
M4WRITER_COMMON, 0x04), /**< File size if the process was ended when we call the
method, estimated size for audio */
M4WRITER_kEmbeddedString = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x05), /**< String embedded at the end of the file(SW - VES) */
M4WRITER_kEmbeddedVersion = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x06), /**< Version embedded at the end of the file */
M4WRITER_kIntegrationTag = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x07), /**< String embedded at the end of the file (char[60]
for integration purpose) */
M4WRITER_kMaxFileSize = M4OSA_OPTION_ID_CREATE (M4_WRITE , \
M4WRITER_COMMON, 0x08), /**< Maximum file size limitation */
M4WRITER_kMaxFileDuration = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x09), /**< Maximum file duration limitation */
M4WRITER_kSetFtypBox = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x0A), /**< Set 'ftyp' atom */
M4WRITER_kMetaData = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x0B), /**< Additionnal information to set in the file */
M4WRITER_kDSI = M4OSA_OPTION_ID_CREATE (M4_WRITE , \
M4WRITER_COMMON, 0x0C), /**< To set DSI of the file (Decoder specifc info) */
M4WRITER_kJpegReserveFPData = M4OSA_OPTION_ID_CREATE (M4_WRITE ,\
M4WRITER_COMMON, 0x0D), /**< Reserve some space in the file for JPEG fast
processing data */
M4WRITER_kJpegSetFPData = M4OSA_OPTION_ID_CREATE (M4_WRITE , \
M4WRITER_COMMON, 0x0E), /**< Write Fast Processing Data in the file*/
/* + CRLV6775 -H.264 trimming */
M4WRITER_kMUL_PPS_SPS = M4OSA_OPTION_ID_CREATE (M4_WRITE , M4WRITER_COMMON, 0x0F)
/* - CRLV6775 -H.264 trimming */
} M4WRITER_OptionID;
/**
******************************************************************************
* struct M4WRITER_Header
* @brief This structure defines the buffer where an header is put.
******************************************************************************
*/
typedef struct
{
M4OSA_MemAddr8 pBuf; /**< Buffer for the header */
M4OSA_UInt32 Size; /**< Size of the data */
} M4WRITER_Header;
/**
******************************************************************************
* struct M4WRITER_StreamVideoInfos
* @brief This structure defines the specific video stream infos, extension to
* M4SYS_StreamDescription.
******************************************************************************
*/
typedef struct {
M4OSA_UInt32 height; /**< Frame height */
M4OSA_UInt32 width; /**< Frame Width */
M4OSA_Double fps; /**< Targetted framerate of the video */
M4WRITER_Header Header; /**< Sequence header of the video stream,
member set to NULL if no header present */
} M4WRITER_StreamVideoInfos;
/**
******************************************************************************
* struct M4WRITER_StreamAudioInfos
* @brief This structure defines the specific audio stream infos, extension to
M4SYS_StreamDescription.
******************************************************************************
*/
typedef struct {
M4OSA_UInt32 nbSamplesPerSec; /**< Number of Samples per second */
M4OSA_UInt16 nbBitsPerSample; /**< Number of Bits in 1 sample */
M4OSA_UInt16 nbChannels; /**< Number of channels */
M4WRITER_Header Header; /**< Decoder Specific Info of the audiostream,
member set to NULL if no DSI present */
} M4WRITER_StreamAudioInfos;
/**
******************************************************************************
* enum M4WRITER_Orientation
* @brief This enum defines the possible orientation of a frame as described
* in the EXIF standard.
******************************************************************************
*/
typedef enum
{
M4WRITER_OrientationUnknown = 0,
M4WRITER_OrientationTopLeft,
M4WRITER_OrientationTopRight,
M4WRITER_OrientationBottomRight,
M4WRITER_OrientationBottomLeft,
M4WRITER_OrientationLeftTop,
M4WRITER_OrientationRightTop,
M4WRITER_OrientationRightBottom,
M4WRITER_OrientationLeftBottom
}M4WRITER_Orientation ;
/**
******************************************************************************
* struct M4WRITER_MetaData
* @brief This structure defines all the meta data to store in the encoded file.
******************************************************************************
*/
typedef struct
{
M4OSA_Char* Description ;
M4OSA_Char* PhoneManufacturer ;
M4OSA_Char* PhoneModel ;
M4OSA_Char* Artist ;
M4OSA_Char* Copyright ;
M4OSA_Char* Software ;
M4OSA_Char* CreationDate;
M4WRITER_Orientation Orientation ;
M4OSA_UInt32 Width ;
M4OSA_UInt32 Height ;
M4OSA_UInt32 ThumbnailWidth ;
M4OSA_UInt32 ThumbnailHeight ;
M4OSA_Bool ThumbnailPresence ;
}M4WRITER_MetaData;
typedef void* M4WRITER_Context;
typedef M4OSA_ERR (M4WRITER_openWrite) (M4WRITER_Context* hContext,\
void* outputFileDescriptor,\
M4OSA_FileWriterPointer* pFileWriterPointer,\
void* tempFileDescriptor, \
M4OSA_FileReadPointer* pFileReaderPointer);
typedef M4OSA_ERR (M4WRITER_addStream) (M4WRITER_Context pContext,\
M4SYS_StreamDescription*streamDescription);
typedef M4OSA_ERR (M4WRITER_startWriting) (M4WRITER_Context pContext);
typedef M4OSA_ERR (M4WRITER_closeWrite) (M4WRITER_Context pContext);
typedef M4OSA_ERR (M4WRITER_setOption) (M4WRITER_Context pContext, \
M4OSA_UInt32 optionID, \
M4OSA_DataOption optionValue);
typedef M4OSA_ERR (M4WRITER_getOption) (M4WRITER_Context pContext, \
M4OSA_UInt32 optionID, \
M4OSA_DataOption optionValue);
/**
******************************************************************************
* struct M4WRITER_GlobalInterface
* @brief Defines all the functions required for a writer shell.
******************************************************************************
*/
typedef struct _M4WRITER_GlobalInterface
{
M4WRITER_openWrite* pFctOpen;
M4WRITER_addStream* pFctAddStream;
M4WRITER_startWriting* pFctStartWriting;
M4WRITER_closeWrite* pFctCloseWrite;
M4WRITER_setOption* pFctSetOption;
M4WRITER_getOption* pFctGetOption;
} M4WRITER_GlobalInterface;
typedef M4OSA_ERR M4WRITER_startAU(M4WRITER_Context pContext, M4SYS_StreamID streamID,\
M4SYS_AccessUnit* pAU);
typedef M4OSA_ERR M4WRITER_processAU(M4WRITER_Context pContext, M4SYS_StreamID streamID,\
M4SYS_AccessUnit* pAU);
/**
******************************************************************************
* struct M4WRITER_DataInterface
* @brief Defines all the functions required to write data with a writer shell.
******************************************************************************
*/
typedef struct _M4WRITER_DataInterface
{
M4WRITER_startAU* pStartAU;
M4WRITER_processAU* pProcessAU;
M4WRITER_Context pWriterContext;
} M4WRITER_DataInterface;
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /*__M4WRITER_COMMON_H__*/
|
