• Home
  • History
  • Annotate
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1  /* ------------------------------------------------------------------
2   * Copyright (C) 1998-2009 PacketVideo
3   *
4   * Licensed under the Apache License, Version 2.0 (the "License");
5   * you may not use this file except in compliance with the License.
6   * You may obtain a copy of the License at
7   *
8   *      http://www.apache.org/licenses/LICENSE-2.0
9   *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13   * express or implied.
14   * See the License for the specific language governing permissions
15   * and limitations under the License.
16   * -------------------------------------------------------------------
17   */
18  #ifndef _MP4DEC_API_H_
19  #define _MP4DEC_API_H_
20  
21  #include "m4vh263_decoder_pv_types.h"
22  
23  // #define PV_TOLERATE_VOL_ERRORS
24  #define PV_MEMORY_POOL
25  
26  #ifndef _PV_TYPES_
27  #define _PV_TYPES_
28  
29  typedef uint Bool;
30  
31  #define PV_CODEC_INIT  0
32  #define PV_CODEC_STOP  1
33  #endif
34  
35  #define PV_TRUE  1
36  #define PV_FALSE 0
37  
38  #ifndef OSCL_IMPORT_REF
39  #define OSCL_IMPORT_REF /* empty */
40  #endif
41  #ifndef OSCL_EXPORT_REF
42  #define OSCL_EXPORT_REF /* empty */
43  #endif
44  
45  /* flag for post-processing  4/25/00 */
46  
47  #ifdef DEC_NOPOSTPROC
48  #undef PV_POSTPROC_ON   /* enable compilation of post-processing code */
49  #else
50  #define PV_POSTPROC_ON
51  #endif
52  
53  #define PV_NO_POST_PROC 0
54  #define PV_DEBLOCK 1
55  #define PV_DERING  2
56  
57  
58  
59  #include "visual_header.h" // struct VolInfo is defined
60  
61  
62  /**@name Structure and Data Types
63   * These type definitions specify the input / output from the PVMessage
64   * library.
65   */
66  
67  /*@{*/
68  /* The application has to allocate space for this structure */
69  typedef struct tagOutputFrame
70  {
71      uint8       *data;          /* pointer to output YUV buffer */
72      uint32      timeStamp;      /* time stamp */
73  } OutputFrame;
74  
75  typedef struct tagApplicationData
76  {
77      int layer;          /* current video layer */
78      void *object;       /* some optional data field */
79  } applicationData;
80  
81  /* Application controls, this structed shall be allocated */
82  /*    and initialized in the application.                 */
83  typedef struct tagvideoDecControls
84  {
85      /* The following fucntion pointer is copied to BitstreamDecVideo structure  */
86      /*    upon initialization and never used again. */
87      int (*readBitstreamData)(uint8 *buf, int nbytes_required, void *appData);
88      applicationData appData;
89  
90      uint8 *outputFrame;
91      void *videoDecoderData;     /* this is an internal pointer that is only used */
92      /* in the decoder library.   */
93  #ifdef PV_MEMORY_POOL
94      int32 size;
95  #endif
96      int nLayers;
97      /* pointers to VOL data for frame-based decoding. */
98      uint8 *volbuf[2];           /* maximum of 2 layers for now */
99      int32 volbuf_size[2];
100  
101  } VideoDecControls;
102  
103  typedef enum
104  {
105      H263_MODE = 0, MPEG4_MODE, UNKNOWN_MODE
106  } MP4DecodingMode;
107  
108  typedef enum
109  {
110      MP4_I_FRAME, MP4_P_FRAME, MP4_B_FRAME, MP4_BAD_FRAME
111  } MP4FrameType;
112  
113  typedef struct tagVopHeaderInfo
114  {
115      int     currLayer;
116      uint32  timestamp;
117      MP4FrameType    frameType;
118      int     refSelCode;
119      int16       quantizer;
120  } VopHeaderInfo;
121  
122  /*--------------------------------------------------------------------------*
123   * VideoRefCopyInfo:
124   * OMAP DSP specific typedef structure, to support the user (ARM) copying
125   * of a Reference Frame into the Video Decoder.
126   *--------------------------------------------------------------------------*/
127  typedef struct tagVideoRefCopyInfoPtr
128  {
129      uint8   *yChan;             /* The Y component frame the user can copy a new reference to */
130      uint8   *uChan;             /* The U component frame the user can copy a new reference to */
131      uint8   *vChan;             /* The V component frame the user can copy a new reference to */
132      uint8   *currentVop;        /* The Vop for video the user can copy a new reference to */
133  } VideoRefCopyInfoPtr;
134  
135  typedef struct tagVideoRefCopyInfoData
136  {
137      int16   width;              /* Width */
138      int16   height;             /* Height */
139      int16   realWidth;          /* Non-padded width, not a multiple of 16. */
140      int16   realHeight;         /* Non-padded height, not a multiple of 16. */
141  } VideoRefCopyInfoData;
142  
143  typedef struct tagVideoRefCopyInfo
144  {
145      VideoRefCopyInfoData data;
146      VideoRefCopyInfoPtr ptrs;
147  } VideoRefCopyInfo;
148  
149  /*@}*/
150  
151  #ifdef __cplusplus
152  extern "C"
153  {
154  #endif
155  
156  
157      OSCL_IMPORT_REF Bool    PVInitVideoDecoder(VideoDecControls *decCtrl, uint8 *volbuf[], int32 *volbuf_size, int nLayers, int width, int height, MP4DecodingMode mode);
158      Bool    PVAllocVideoData(VideoDecControls *decCtrl, int width, int height, int nLayers);
159      OSCL_IMPORT_REF Bool    PVCleanUpVideoDecoder(VideoDecControls *decCtrl);
160      Bool    PVResetVideoDecoder(VideoDecControls *decCtrl);
161      OSCL_IMPORT_REF void    PVSetReferenceYUV(VideoDecControls *decCtrl, uint8 *refYUV);
162      Bool    PVDecSetReference(VideoDecControls *decCtrl, uint8 *refYUV, uint32 timestamp);
163      Bool    PVDecSetEnhReference(VideoDecControls *decCtrl, uint8 *refYUV, uint32 timestamp);
164      OSCL_IMPORT_REF Bool    PVDecodeVideoFrame(VideoDecControls *decCtrl, uint8 *bitstream[], uint32 *timestamp, int32 *buffer_size, uint use_ext_timestamp[], uint8* currYUV);
165      Bool    PVDecodeVopHeader(VideoDecControls *decCtrl, uint8 *buffer[], uint32 timestamp[], int32 buffer_size[], VopHeaderInfo *header_info, uint use_ext_timestamp[], uint8 *currYUV);
166      Bool    PVDecodeVopBody(VideoDecControls *decCtrl, int32 buffer_size[]);
167      void    PVDecPostProcess(VideoDecControls *decCtrl, uint8 *outputYUV);
168      OSCL_IMPORT_REF void    PVGetVideoDimensions(VideoDecControls *decCtrl, int32 *display_width, int32 *display_height);
169      OSCL_IMPORT_REF void    PVGetBufferDimensions(VideoDecControls *decCtrl, int32 *buf_width, int32 *buf_height);
170      OSCL_IMPORT_REF void    PVSetPostProcType(VideoDecControls *decCtrl, int mode);
171      uint32  PVGetVideoTimeStamp(VideoDecControls *decoderControl);
172      int     PVGetDecBitrate(VideoDecControls *decCtrl);
173      int     PVGetDecFramerate(VideoDecControls *decCtrl);
174      uint8   *PVGetDecOutputFrame(VideoDecControls *decCtrl);
175      int     PVGetLayerID(VideoDecControls *decCtrl);
176      int32   PVGetDecMemoryUsage(VideoDecControls *decCtrl);
177      OSCL_IMPORT_REF MP4DecodingMode PVGetDecBitstreamMode(VideoDecControls *decCtrl);
178      Bool    PVExtractVolHeader(uint8 *video_buffer, uint8 *vol_header, int32 *vol_header_size);
179      int32   PVLocateFrameHeader(uint8 *video_buffer, int32 vop_size);
180      int32   PVLocateH263FrameHeader(uint8 *video_buffer, int32 vop_size);
181      Bool    PVGetVolInfo(VideoDecControls *decCtrl, VolInfo *pVolInfo); // BX 6/24/04
182      Bool    IsIntraFrame(VideoDecControls *decoderControl);
183  
184  #ifdef __cplusplus
185  }
186  #endif
187  #endif /* _MP4DEC_API_H_ */
188  
189