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 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>ppmconv*</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">ppmconv* <IMG src="../image/NTR.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></H1>
41<H2>Description</H2>
42<P>The <CODE>ppmconv/ppmconv8/ppmconvbg</CODE> tools are used to change the full-color ppm format image to a C source format.</P>
43<H2>Using the Tool</H2>
44<H3>Start Command</H3>
45<H4>ppmconv*</H4>
46<P><CODE>% ppmconv PPM_FILE</CODE></P>
47<P> Loads the image file in the full-color <CODE>ppm</CODE> format that is designated by <CODE>PPM_FILE</CODE>, converts it to a 16-bit color bitmap, and outputs the C source file that can be directly used by the program.</P>
48<H4>ppmconv8</H4>
49<P><CODE>% ppmconv8 PPM_FILE LABEL_NAME</CODE></P>
50<P> Loads the image file in the full-color <CODE>ppm</CODE> format that is designated by <CODE>PPM_FILE</CODE>, converts it to an 8-bit INDEX color bitmap, and outputs the C source file that can be directly used by the program. The <CODE>ppm</CODE> format image file to be loaded must be reduced to 256 colors or less in advance using another image editing tool. The name of the array of the palette and the pixel data string are generated using <code>LABEL_NAME</code>.</P>
51<H4>ppmconvbg</H4>
52<P><CODE>% ppmconvbg [-a LABEL_NAME] [-b] [-c 4|-c 8] [-p] [-i] PPM_FILE OUTPUT_FILE</CODE></P>
53<P> Loads the image file in the full-color <CODE>ppm</CODE> format that is designated by <CODE>PPM_FILE</CODE> and outputs the data to <CODE>OUTPUT_FILE</CODE> according to the conditions designated by the following options:</P>
54<BLOCKQUOTE>
55<DL>
56<DT><CODE>-a LABEL_NAME</CODE>
57<DD>Outputs in a C source format<BR> Outputs in a format that can be compiled. The name of the array of the palette and the pixel data string are generated using <CODE>LABEL_NAME</CODE>.
58<DT><CODE>-b</CODE>
59<DD>Outputs in a binary format <BR> This is convenient when performing processes such as further compression on the output data. The output data is in a binary format by default.<BR>
60<DT><CODE>-c 4 or -c 8</CODE>
61<DD>The number of bits of the color palette<BR> Designates <CODE>-c 4</CODE> when 16-color and <CODE>-c 8</CODE> when 256-color. The default is 256-color.<BR>The <CODE>ppm</CODE> format file that will be input must be reduced to the number of colors designated here or less.<BR>
62<DT><CODE>-p</CODE>
63<DD>Outputs only palette data.<BR>
64<DT><CODE>-i</CODE>
65<DD>Outputs only the pixel data (the color index value).<BR>
66</DL>
67</BLOCKQUOTE>
68<H2>Location</H2>
69<P><CODE>$TwlSDK/tools/bin/ppmconv.exe</CODE><BR> <CODE>$TwlSDK/tools/bin/ppmconv8.exe<BR> $TwlSDK/tools/bin/ppmconvbg.exe</CODE></P>
70<H2>See Also</H2>
71<P><A href="../demos/gx/gxdemos.html"><code>gx/UnitTours/2D_BmpBg_MainRam</code></A><BR> <A href="../demos/gx/gxdemos.html"><code>gx/UnitTours/2D_CharBg_256BMP</code></A></P>
72<H2>Revision History</H2>
73<P>2004/08/26 Initial version.</P>
74<hr><p>CONFIDENTIAL</p></body>
75</HTML>