1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=utf-8"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows"> 8<title>TMCCJPEGDecGetSizeEX</title> 9<LINK rel="stylesheet" href="../../CSS/revolution.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">TMCCJPEGDecGetSizeEX</h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <revolution/tmcc_jpeg.h></CODE><BR> <BR> 20 <PRE><CODE>s32 TMCCJPEGDecGetSizeEx( 21 void *pWorkArea, 22 void *pJpegStream, 23 u32 jpegStreamSize, 24 GXTexFmt texFormat, 25 s32 resolution, 26 u16 srcX, 27 u16 srcY, 28 u16 srcWidth, 29 u16 srcHeight, 30 <A href="TMCCJPEGJpegSize.html">TMCCJPEGJpegSize</A> *jpegSize 31); 32</CODE></PRE></dd> 33</dl> 34 35<h2>Arguments</h2> 36<TABLE border="1" width="100%"> 37 <TBODY> 38 <TR> 39<TD width="13%"><EM><STRONG>*pWorkArea</STRONG></EM></TD> 40<TD width="87%">Configure the starting address of the work area. 41 42</TD> 43 </TR> 44 <TR> 45<TD width="13%"><EM><STRONG>*pJpegStream</STRONG></EM></TD> 46<TD width="87%">Configure the starting address of the input JPEG data.<BR>(The starting address for the JPEG data should be 32-byte aligned. A <CODE>TMCC_JPEG_OPT_ERR</CODE> error code is returned if not 32-byte aligned.） 47 48 49 50</TD> 51 </TR> 52 <TR> 53<TD width="13%"><EM><STRONG>jpegStreamSize</STRONG></EM></TD> 54<TD width="87%">Specify the size of the input JPEG data. 55 56 57</TD> 58 </TR> 59 60 <TR> 61<TD width="13%"><EM><STRONG>texFormat</STRONG></EM></TD> 62<TD width="87%">Specify the texture format. <br>(A <CODE>TMCC_JPEG_TEXT_ERR</CODE> error code is returned for input that is neither <CODE>GX_TF_RGB565</CODE> nor <CODE>GX_TF_RGBA8</CODE>.） 63</TD> 64 </TR> 65 66 <TR> 67<TD width="13%"><EM><STRONG>resolution</STRONG></EM></TD> 68<TD width="87%">Configure the resolution-reduction conversion level.<br>(A <CODE>TMCC_JPEG_OPT_ERR</CODE> error code is returned for input that is not 1, 2, 4, or 8.） 69 70</TD> 71 </TR> 72 73 74 <TR> 75<TD width="13%"><EM><STRONG>srcX</STRONG></EM></TD> 76<TD width="87%">Specify the upper-left X coordinate of the expanded region. Only a multiple of 32 can be set (including 0).<BR>(The error code <CODE>TMCC_JPEG_OPT_ERR</CODE> is returned for input that does not satisfy conditions.)</TD> 77 </TR> 78 <TR> 79<TD width="13%"><EM><STRONG>srcY</STRONG></EM></TD> 80<TD width="87%">Specify the upper-left Y coordinate of the expanded region. Only zero or a multiple of 32 can be set.<BR> (The error code <CODE>TMCC_JPEG_OPT_ERR</CODE> is returned for invalid input.)</TD> 81 </TR> 82 83 <TR> 84<TD width="13%"><EM><STRONG>srcWidth</STRONG></EM></TD> 85<TD width="87%">Specify the width of the expanded region. Multiples of 32 greater than or equal to 32 (that is, not zero) or the size to the right end of the source image can be input.<BR> (The error code <CODE>TMCC_JPEG_OPT_ERR</CODE> is returned for invalid input.)</TD> 86 </TR> 87 88 <TR> 89<TD width="13%"><EM><STRONG>srcHeight</STRONG></EM></TD> 90<TD width="87%">Specify the height of the expanded region. Multiples of 32 greater than or equal to 32 (that is, not zero) or the size to the bottom end of the source image can be input.<BR> (The error code <CODE>TMCC_JPEG_OPT_ERR</CODE> is returned for invalid input.)</TD> 91 </TR> 92 <TR> 93<TD width="13%"><EM><STRONG>*jpegSize</STRONG></EM></TD> 94<TD width="87%">Size information for the JPEG data.<br>(See the <A href="TMCCJPEGJpegSize.html">TMCCJPEGJpegSize</A> structure.) 95 96 97 98</TD> 99 </TR> 100 101 102 103 </TBODY> 104</TABLE> 105 106 107<h2>Return Values</h2> 108<TABLE border="1"> 109 <TBODY> 110 <TR> 111 <TD width="30%"><CODE>0</CODE></TD> 112<TD width="70%">Function completed successfully.</TD> 113 </TR> 114 <TR> 115<TD width="30%"><CODE>Negative</CODE></TD> 116<TD width="70%">Abnormal exit (error code).</TD> 117 </TR> 118 </TBODY> 119</TABLE> 120 121<H2>Description</H2> 122<P>Gets the number of pixels in the specified region of the JPEG input data. <BR> 123</P> 124 125<h2>See Also</h2> 126<p><CODE><A href="TMCCJPEGJpegSize.html">TMCCJPEGJpegSize</A></CODE><BR><A href="errorcode.html">Error Codes</A></p> 127<H2>Revision History</H2> 128<P> 1292009/10/19 Made changes to the description of the <CODE>include</CODE> file in line with integration into the Revolution SDK.<BR>2008/03/11 Changed the type for the <CODE>srcX</CODE>, <CODE>srcY</CODE>, <CODE>srcWidth</CODE>, and <CODE>srcHeight</CODE> arguments.<BR> 2007/02/02 Initial version.</P> 130<hr><p>CONFIDENTIAL</p></body> 131</html> 132