omxVCM4P2_DecodeVLCZigzag_IntraDCVLC.c revision 78e52bfac041d71ce53b5b13c2abf78af742b09d
178e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar/* 278e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * Copyright (C) 2007-2008 ARM Limited 378e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * 478e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * Licensed under the Apache License, Version 2.0 (the "License"); 578e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * you may not use this file except in compliance with the License. 678e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * You may obtain a copy of the License at 778e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * 878e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * http://www.apache.org/licenses/LICENSE-2.0 978e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * 1078e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * Unless required by applicable law or agreed to in writing, software 1178e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * distributed under the License is distributed on an "AS IS" BASIS, 1278e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1378e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * See the License for the specific language governing permissions and 1478e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * limitations under the License. 1578e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar * 1678e52bfac041d71ce53b5b13c2abf78af742b09dLajos Molnar */ 170c1bc742181ded4930842b46e9507372f0b1b963James Dong/** 180c1bc742181ded4930842b46e9507372f0b1b963James Dong * 190c1bc742181ded4930842b46e9507372f0b1b963James Dong * File Name: omxVCM4P2_DecodeVLCZigzag_IntraDCVLC.c 200c1bc742181ded4930842b46e9507372f0b1b963James Dong * OpenMAX DL: v1.0.2 210c1bc742181ded4930842b46e9507372f0b1b963James Dong * Revision: 9641 220c1bc742181ded4930842b46e9507372f0b1b963James Dong * Date: Thursday, February 7, 2008 230c1bc742181ded4930842b46e9507372f0b1b963James Dong * 240c1bc742181ded4930842b46e9507372f0b1b963James Dong * 250c1bc742181ded4930842b46e9507372f0b1b963James Dong * 260c1bc742181ded4930842b46e9507372f0b1b963James Dong * 270c1bc742181ded4930842b46e9507372f0b1b963James Dong * Description: 280c1bc742181ded4930842b46e9507372f0b1b963James Dong * Contains modules for zigzag scanning and VLC decoding 290c1bc742181ded4930842b46e9507372f0b1b963James Dong * for intra block. 300c1bc742181ded4930842b46e9507372f0b1b963James Dong * 310c1bc742181ded4930842b46e9507372f0b1b963James Dong */ 320c1bc742181ded4930842b46e9507372f0b1b963James Dong 330c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "omxtypes.h" 340c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armOMX.h" 350c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "omxVC.h" 360c1bc742181ded4930842b46e9507372f0b1b963James Dong 370c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armVC.h" 380c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armCOMM_Bitstream.h" 390c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armCOMM.h" 400c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armVCM4P2_Huff_Tables_VLC.h" 410c1bc742181ded4930842b46e9507372f0b1b963James Dong#include "armVCM4P2_ZigZag_Tables.h" 420c1bc742181ded4930842b46e9507372f0b1b963James Dong 430c1bc742181ded4930842b46e9507372f0b1b963James Dong 440c1bc742181ded4930842b46e9507372f0b1b963James Dong 450c1bc742181ded4930842b46e9507372f0b1b963James Dong 460c1bc742181ded4930842b46e9507372f0b1b963James Dong/** 470c1bc742181ded4930842b46e9507372f0b1b963James Dong * Function: omxVCM4P2_DecodeVLCZigzag_IntraDCVLC (6.2.5.2.2) 480c1bc742181ded4930842b46e9507372f0b1b963James Dong * 490c1bc742181ded4930842b46e9507372f0b1b963James Dong * Description: 500c1bc742181ded4930842b46e9507372f0b1b963James Dong * Performs VLC decoding and inverse zigzag scan of AC and DC coefficients 510c1bc742181ded4930842b46e9507372f0b1b963James Dong * for one intra block. Two versions of the function (DCVLC and ACVLC) are 520c1bc742181ded4930842b46e9507372f0b1b963James Dong * provided in order to support the two different methods of processing DC 530c1bc742181ded4930842b46e9507372f0b1b963James Dong * coefficients, as described in [ISO14496-2], subclause 7.4.1.4, Intra DC 540c1bc742181ded4930842b46e9507372f0b1b963James Dong * Coefficient Decoding for the Case of Switched VLC Encoding. 550c1bc742181ded4930842b46e9507372f0b1b963James Dong * 560c1bc742181ded4930842b46e9507372f0b1b963James Dong * Input Arguments: 570c1bc742181ded4930842b46e9507372f0b1b963James Dong * 580c1bc742181ded4930842b46e9507372f0b1b963James Dong * ppBitStream - pointer to the pointer to the current byte in the 590c1bc742181ded4930842b46e9507372f0b1b963James Dong * bitstream buffer 600c1bc742181ded4930842b46e9507372f0b1b963James Dong * pBitOffset - pointer to the bit position in the current byte referenced 610c1bc742181ded4930842b46e9507372f0b1b963James Dong * by *ppBitStream. The parameter *pBitOffset is valid in the 620c1bc742181ded4930842b46e9507372f0b1b963James Dong * range [0-7]. 630c1bc742181ded4930842b46e9507372f0b1b963James Dong * Bit Position in one byte: |Most Least| 640c1bc742181ded4930842b46e9507372f0b1b963James Dong * *pBitOffset |0 1 2 3 4 5 6 7| 650c1bc742181ded4930842b46e9507372f0b1b963James Dong * predDir - AC prediction direction; used to select the zigzag scan 660c1bc742181ded4930842b46e9507372f0b1b963James Dong * pattern; takes one of the following values: 670c1bc742181ded4930842b46e9507372f0b1b963James Dong * - OMX_VC_NONE - AC prediction not used; 680c1bc742181ded4930842b46e9507372f0b1b963James Dong * performs classical zigzag scan. 690c1bc742181ded4930842b46e9507372f0b1b963James Dong * - OMX_VC_HORIZONTAL - Horizontal prediction; 700c1bc742181ded4930842b46e9507372f0b1b963James Dong * performs alternate-vertical zigzag scan; 710c1bc742181ded4930842b46e9507372f0b1b963James Dong * - OMX_VC_VERTICAL - Vertical prediction; 720c1bc742181ded4930842b46e9507372f0b1b963James Dong * performs alternate-horizontal zigzag scan. 730c1bc742181ded4930842b46e9507372f0b1b963James Dong * shortVideoHeader - binary flag indicating presence of 740c1bc742181ded4930842b46e9507372f0b1b963James Dong * short_video_header; escape modes 0-3 are used if 750c1bc742181ded4930842b46e9507372f0b1b963James Dong * shortVideoHeader==0, and escape mode 4 is used when 760c1bc742181ded4930842b46e9507372f0b1b963James Dong * shortVideoHeader==1. 770c1bc742181ded4930842b46e9507372f0b1b963James Dong * videoComp - video component type (luminance or chrominance) of the 780c1bc742181ded4930842b46e9507372f0b1b963James Dong * current block 790c1bc742181ded4930842b46e9507372f0b1b963James Dong * 800c1bc742181ded4930842b46e9507372f0b1b963James Dong * Output Arguments: 810c1bc742181ded4930842b46e9507372f0b1b963James Dong * 820c1bc742181ded4930842b46e9507372f0b1b963James Dong * ppBitStream - *ppBitStream is updated after the block is decoded such 830c1bc742181ded4930842b46e9507372f0b1b963James Dong * that it points to the current byte in the bit stream buffer 840c1bc742181ded4930842b46e9507372f0b1b963James Dong * pBitOffset - *pBitOffset is updated such that it points to the current 850c1bc742181ded4930842b46e9507372f0b1b963James Dong * bit position in the byte pointed by *ppBitStream 860c1bc742181ded4930842b46e9507372f0b1b963James Dong * pDst - pointer to the coefficient buffer of current block; must be 870c1bc742181ded4930842b46e9507372f0b1b963James Dong * 4-byte aligned. 880c1bc742181ded4930842b46e9507372f0b1b963James Dong * 890c1bc742181ded4930842b46e9507372f0b1b963James Dong * Return Value: 900c1bc742181ded4930842b46e9507372f0b1b963James Dong * 910c1bc742181ded4930842b46e9507372f0b1b963James Dong * OMX_Sts_NoErr - no error 920c1bc742181ded4930842b46e9507372f0b1b963James Dong * OMX_Sts_BadArgErr - bad arguments, if: 930c1bc742181ded4930842b46e9507372f0b1b963James Dong * - At least one of the following pointers is NULL: 940c1bc742181ded4930842b46e9507372f0b1b963James Dong * ppBitStream, *ppBitStream, pBitOffset, pDst 950c1bc742181ded4930842b46e9507372f0b1b963James Dong * - *pBitOffset exceeds [0,7] 960c1bc742181ded4930842b46e9507372f0b1b963James Dong * - preDir exceeds [0,2] 970c1bc742181ded4930842b46e9507372f0b1b963James Dong * - pDst is not 4-byte aligned 980c1bc742181ded4930842b46e9507372f0b1b963James Dong * OMX_Sts_Err - if: 990c1bc742181ded4930842b46e9507372f0b1b963James Dong * - In DecodeVLCZigzag_IntraDCVLC, dc_size > 12 1000c1bc742181ded4930842b46e9507372f0b1b963James Dong * - At least one of mark bits equals zero 1010c1bc742181ded4930842b46e9507372f0b1b963James Dong * - Illegal stream encountered; code cannot be located in VLC table 1020c1bc742181ded4930842b46e9507372f0b1b963James Dong * - Forbidden code encountered in the VLC FLC table. 1030c1bc742181ded4930842b46e9507372f0b1b963James Dong * - The number of coefficients is greater than 64 1040c1bc742181ded4930842b46e9507372f0b1b963James Dong * 1050c1bc742181ded4930842b46e9507372f0b1b963James Dong */ 1060c1bc742181ded4930842b46e9507372f0b1b963James Dong 1070c1bc742181ded4930842b46e9507372f0b1b963James DongOMXResult omxVCM4P2_DecodeVLCZigzag_IntraDCVLC( 1080c1bc742181ded4930842b46e9507372f0b1b963James Dong const OMX_U8 ** ppBitStream, 1090c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_INT * pBitOffset, 1100c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_S16 * pDst, 1110c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_U8 predDir, 1120c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_INT shortVideoHeader, 1130c1bc742181ded4930842b46e9507372f0b1b963James Dong OMXVCM4P2VideoComponent videoComp 1140c1bc742181ded4930842b46e9507372f0b1b963James Dong) 1150c1bc742181ded4930842b46e9507372f0b1b963James Dong{ 1160c1bc742181ded4930842b46e9507372f0b1b963James Dong /* Dummy initilaization to remove compilation error */ 1170c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_S8 DCValueSize = 0; 1180c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_U16 powOfSize, fetchDCbits; 1190c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_U8 start = 1; 1200c1bc742181ded4930842b46e9507372f0b1b963James Dong 1210c1bc742181ded4930842b46e9507372f0b1b963James Dong /* Argument error checks */ 1220c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf(ppBitStream == NULL, OMX_Sts_BadArgErr); 1230c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf(*ppBitStream == NULL, OMX_Sts_BadArgErr); 1240c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf(pBitOffset == NULL, OMX_Sts_BadArgErr); 1250c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf(pDst == NULL, OMX_Sts_BadArgErr); 1260c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf(!armIs4ByteAligned(pDst), OMX_Sts_BadArgErr); 1270c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf((*pBitOffset < 0) || (*pBitOffset > 7), OMX_Sts_BadArgErr); 1280c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetArgErrIf((predDir > 2), OMX_Sts_BadArgErr); 1290c1bc742181ded4930842b46e9507372f0b1b963James Dong 1300c1bc742181ded4930842b46e9507372f0b1b963James Dong /* Insert the code into the bitstream */ 1310c1bc742181ded4930842b46e9507372f0b1b963James Dong if (videoComp == OMX_VC_LUMINANCE) 1320c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1330c1bc742181ded4930842b46e9507372f0b1b963James Dong DCValueSize = armUnPackVLC32(ppBitStream, 1340c1bc742181ded4930842b46e9507372f0b1b963James Dong pBitOffset, armVCM4P2_aIntraDCLumaIndex); 1350c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1360c1bc742181ded4930842b46e9507372f0b1b963James Dong else if (videoComp == OMX_VC_CHROMINANCE) 1370c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1380c1bc742181ded4930842b46e9507372f0b1b963James Dong DCValueSize = armUnPackVLC32(ppBitStream, 1390c1bc742181ded4930842b46e9507372f0b1b963James Dong pBitOffset, armVCM4P2_aIntraDCChromaIndex); 1400c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1410c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetDataErrIf(DCValueSize == -1, OMX_Sts_Err); 1420c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetDataErrIf(DCValueSize > 12, OMX_Sts_Err); 1430c1bc742181ded4930842b46e9507372f0b1b963James Dong 1440c1bc742181ded4930842b46e9507372f0b1b963James Dong 1450c1bc742181ded4930842b46e9507372f0b1b963James Dong if (DCValueSize == 0) 1460c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1470c1bc742181ded4930842b46e9507372f0b1b963James Dong pDst[0] = 0; 1480c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1490c1bc742181ded4930842b46e9507372f0b1b963James Dong else 1500c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1510c1bc742181ded4930842b46e9507372f0b1b963James Dong fetchDCbits = (OMX_U16) armGetBits(ppBitStream, pBitOffset, \ 1520c1bc742181ded4930842b46e9507372f0b1b963James Dong DCValueSize); 1530c1bc742181ded4930842b46e9507372f0b1b963James Dong 1540c1bc742181ded4930842b46e9507372f0b1b963James Dong if ( (fetchDCbits >> (DCValueSize - 1)) == 0) 1550c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1560c1bc742181ded4930842b46e9507372f0b1b963James Dong /* calulate pow */ 1570c1bc742181ded4930842b46e9507372f0b1b963James Dong powOfSize = (1 << DCValueSize); 1580c1bc742181ded4930842b46e9507372f0b1b963James Dong 1590c1bc742181ded4930842b46e9507372f0b1b963James Dong pDst[0] = (OMX_S16) (fetchDCbits ^ (powOfSize - 1)); 1600c1bc742181ded4930842b46e9507372f0b1b963James Dong pDst[0] = -pDst[0]; 1610c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1620c1bc742181ded4930842b46e9507372f0b1b963James Dong else 1630c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1640c1bc742181ded4930842b46e9507372f0b1b963James Dong pDst[0] = fetchDCbits; 1650c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1660c1bc742181ded4930842b46e9507372f0b1b963James Dong 1670c1bc742181ded4930842b46e9507372f0b1b963James Dong if (DCValueSize > 8) 1680c1bc742181ded4930842b46e9507372f0b1b963James Dong { 1690c1bc742181ded4930842b46e9507372f0b1b963James Dong /* reading and checking the marker bit*/ 1700c1bc742181ded4930842b46e9507372f0b1b963James Dong armRetDataErrIf (armGetBits(ppBitStream, pBitOffset, 1) == 0, \ 1710c1bc742181ded4930842b46e9507372f0b1b963James Dong OMX_Sts_Err); 1720c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1730c1bc742181ded4930842b46e9507372f0b1b963James Dong } 1740c1bc742181ded4930842b46e9507372f0b1b963James Dong 1750c1bc742181ded4930842b46e9507372f0b1b963James Dong return armVCM4P2_DecodeVLCZigzag_Intra( 1760c1bc742181ded4930842b46e9507372f0b1b963James Dong ppBitStream, 1770c1bc742181ded4930842b46e9507372f0b1b963James Dong pBitOffset, 1780c1bc742181ded4930842b46e9507372f0b1b963James Dong pDst, 1790c1bc742181ded4930842b46e9507372f0b1b963James Dong predDir, 1800c1bc742181ded4930842b46e9507372f0b1b963James Dong shortVideoHeader, 1810c1bc742181ded4930842b46e9507372f0b1b963James Dong start); 1820c1bc742181ded4930842b46e9507372f0b1b963James Dong} 1830c1bc742181ded4930842b46e9507372f0b1b963James Dong 1840c1bc742181ded4930842b46e9507372f0b1b963James Dong/* End of file */ 1850c1bc742181ded4930842b46e9507372f0b1b963James Dong 186