• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*!
2  * \copy
3  *     Copyright (c)  2009-2013, Cisco Systems
4  *     All rights reserved.
5  *
6  *     Redistribution and use in source and binary forms, with or without
7  *     modification, are permitted provided that the following conditions
8  *     are met:
9  *
10  *        * Redistributions of source code must retain the above copyright
11  *          notice, this list of conditions and the following disclaimer.
12  *
13  *        * Redistributions in binary form must reproduce the above copyright
14  *          notice, this list of conditions and the following disclaimer in
15  *          the documentation and/or other materials provided with the
16  *          distribution.
17  *
18  *     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  *     "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  *     LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21  *     FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
22  *     COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23  *     INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
24  *     BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25  *     LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26  *     CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  *     LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
28  *     ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  *     POSSIBILITY OF SUCH DAMAGE.
30  *
31  *
32  * \file    picture_handle.h
33  *
34  * \brief   picture pData handling
35  *
36  * \date    5/20/2009 Created
37  *
38  *************************************************************************************/
39 #if !defined(WELS_ENCODER_PICTURE_HANDLE_H__)
40 #define WELS_ENCODER_PICTURE_HANDLE_H__
41 
42 #include "picture.h"
43 #include "typedefs.h"
44 #include "memory_align.h"
45 
46 namespace WelsEnc {
47 /*!
48  * \brief   alloc picture pData with borders for each plane based width and height of picture
49  * \param   kiWidth                 width of picture in pixels
50  * \param   kiHeight                height of picture in pixels
51  * \param   bNeedMbInfo             need pData allocation
52  * \pram    iNeedFeatureStorage     need storage for FME
53  * \return  successful if effective picture pointer returned, otherwise failed with NULL
54  */
55 SPicture* AllocPicture (CMemoryAlign* pMa, const int32_t kiWidth, const int32_t kiHeight, bool bNeedMbInfo,
56                         int32_t iNeedFeatureStorage);
57 
58 /*!
59  * \brief   free picture pData planes
60  * \param   pic     picture pointer to be destoryed
61  * \return  none
62  */
63 void FreePicture (CMemoryAlign* pMa, SPicture** ppPic);
64 
65 }
66 #endif//WELS_ENCODER_PICTURE_HANDLE_H__
67