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