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=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<title>MI_UncompressRL*</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">MI_UncompressRL* <IMG src="../../image/NTR.gif" width="23" height="12" border="0" align="middle"><IMG src="../../image/TWL.gif" width="23" height="12" border="0" align="middle"></h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <nitro/mi.h></CODE><BR> <BR> <CODE>void MI_UncompressRL8( const void* srcp, void* destp );</CODE><br> <CODE>void MI_UncompressRL16( const void* srcp, void* destp );</CODE><br> <CODE>void MI_UncompressRL32( const void* srcp, void* destp );</CODE></dd> 20</dl> 21<h2>Arguments</h2> 22<TABLE border="1" width="100%"> 23 <TBODY> 24 <TR> 25<TD width="13%"><EM><STRONG>srcp</STRONG></EM></TD> 26<TD width="87%">The source address where run-length compressed data is stored.</TD> 27 </TR> 28 <TR> 29<TD width="13%"><EM><STRONG>destp</STRONG></EM></TD> 30<TD width="87%">Destination address for decompression.</TD> 31 </TR> 32 </TBODY> 33</TABLE> 34 35<h2>Return Values</h2> 36<p>None.</p> 37 38<H2>Description</H2> 39<P>This function decompresses run-length compressed data and writes the data to the specified region of memory. The source address must be aligned to a 4-byte boundary.</P> 40<P><code>MI_UncompressRL8</code> writes in 8-bit units.<BR> On NITRO, you cannot decompress directly to VRAM.<BR><BR> <code>MI_UncompressRL16</code> writes in 16-bit units.<BR>You can decompress directly to VRAM, even on NITRO.<BR><BR><BR> <CODE>MI_UncompressRL32()</CODE> writes in 32-bit units. <BR>This allows faster processing than would be possible using either the <CODE>MI_UncompressRL8</CODE> or <CODE>MI_UncompressRL16</CODE> function.<BR>You can decompress directly to VRAM, even on NITRO. 41</P> 42 43<h2>Internal Operation</h2> 44<P>Processing only takes place on the CPU, without the use of a system call or DMA.</P> 45 46<h2>See Also</h2> 47<p><CODE><A href="MI_UncompressLZ.html">MI_UncompressLZ*</A><BR> <A href="MI_UncompressHuffman.html">MI_UncompressHuffman</A><BR> <A href="MI_UnfilterDiff.html">MI_UnfilterDiff*</A><BR><A href="../../svc/SVC_UncompressRL.html">SVC_UncompressRL*</A><BR> <A href="MI_ReadUncompRL.html">MI_ReadUncompRL</A><BR> <A href="MI_CompressRL.html">MI_CompressRL</A><br></CODE></p> 48 49<H2>Revision History</H2> 50<P> 512008/07/02 Added a 32-bit version of the function. Revised the description of internal operations.<BR>2005/03/02 Deleted recommendation to align data size to a multiple of 4 bytes.<br /> 2004/05/28 Fixed the Internal Operation description.<br> 2004/01/30 Initial version.</P> 52<hr><p>CONFIDENTIAL</p></body> 53</html> 54
