1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>compBLZ</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9<STYLE type="text/css">
10<!--
11.sample_source{
12  background-color : #e8e8e8;
13}
14H3{
15  color : teal;
16}
17.command_list{
18  margin-bottom : 16pt;
19}
20.command_desc{
21  }
22.command_item{
23  margin-top : 16pt;
24  background-color : #e8e8e8;
25}
26.blockquoted_table {
27  border : 1px;
28  width : 80%;
29}
30TD,TH{
31  border-color  : #c0d8d8;
32  padding       : 1pt 4pt 1pt 4pt;
33  border-width  : 1px;
34  border-style  : solid;
35}
36-->
37</STYLE>
38</HEAD>
39<BODY>
40<H1 align="left">compBLZ <IMG src="../image/NTR.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></H1>
41<H2>Description</H2>
42<P> <CODE>compBLZ</CODE> is a tool that creates compressed data in a format that can be handled by the <CODE><A href="../mi/uncompress/MI_SecureUncompressBLZ.html">MI_SecureUncompressBLZ()</A></CODE> command. BLZ format is a compression format based on the LZ format that uses reverse decompression to reduce the amount of memory consumed.</P>
43<P> See the uncompressBLZ demo in the MI sample demos for how to decompress this data in an application.</P>
44<H2>Using the Tool</H2>
45<H3>Start Command</H3>
46<P><CODE>% compBLZ  [-d] [-e suffix] [-o outputFile] &lt;inputFile&gt;<BR>
47</P>
48
49<P> The input file specified in <CODE>inputFile</CODE> will be compressed in BLZ format.</P>
50<P>The <CODE>-d</CODE> option displays messages throughout the duration of the compression.</P>
51<P>The <CODE>-e</CODE> option can be used to specify the file extension to be added to the filename after compression. The default is <CODE>_BLZ.bin</CODE>.<BR><BR>With the <code>-o</code> option, the file name of the output file can be designated.<BR> If nothing is specified, the output file is created with the name (<EM>the main input file name</EM>)_(<EM>file extension specified in the <CODE>-e</CODE> option</EM>).<BR>
52</P>
53
54<P>A footer like the one below will be added to the BLZ data. Each member will be based on the ending address of the BLZ data buffer.<BR><BR> <CODE>typedef struct<BR> {<BR> u32 bufferTop:24; // Offset to the starting address of the compressed region.<BR> u32 compressBottom:8; // Offset to the starting address of this footer.<BR> u32 originalBottom; // Offset to the ending address of the buffer after decompression.<BR> } CompFooter;<BR></CODE></CODE></P>
55
56<H2>Location</H2>
57<P><CODE>$TwlSDK/tools/bin/compBLZ.exe</CODE></P>
58<H2>See Also</H2>
59<P><CODE><A href="../mi/uncompress/MI_SecureUncompressBLZ.html">MI_SecureUncompressBLZ</A></CODE>, <A href="../demos/mi/midemos.html">MI Sample Demos</A></P>
60<H2>Revision History</H2>
61<P>2008/06/23 Initial version.</P><BR>
62<hr><p>CONFIDENTIAL</p></body>
63</HTML>