### Resource Image Conversion Utility - Using the Utility (OS/2, Windows)

You can convert your images through either the graphical interface or the command line.

Converting Your Images Using the Graphical Interface
Complete the following steps to convert your images to the appropriate platform:

1. Under Options, select Image preselection in order to designate the predefined size and color combinations (called members) that you want to be automatically selected when you open the image tha tyou will be converting. (The default is to preselect all the available layers or members).
2. From the File pull down menu, select Open and choose an image that you wish to convert.
3. Choose the platform of the image that you wish to convert to by selecting Windows or OS/2 from the Format drop down menu (the default is Windows).
4. Under the Mode option, on the action bar, you must specify whether your image should be treated individually or as a group of images.

   Group | In this mode only one name field will be displayed and all of the layers, which you select, will be saved to one image. Each layer will have a check mark option box beside it; simply de-select, or select, those layers that you wish to be included in your final converted image. (The default is for all of the layers, specified in Image Preselection, to be selected). Type the pathname and name for converted image in the Save to field provided, or select an existing pathname and name using the Select Filename option, under File, from the action bar menu. Notes: In order to use the Select Filename option, your cursor must have focus on the Save to box. You cannot use the group save option with a Windows bitmap as the Windows operating system does not support multi-layered bitmap images.
   Items | This mode allows you to save each layer to an individual file. You must specify a different name, in the Save to field, for each layer that you wish to convert to a separate file. If you do not specify a name for the layer it will not be converted. Type the pathname and name that you want the converted layer to be called in the individual Save to fields provided, or select existing pathnames and names using the Select Filename option, under File, from the action bar menu. Note: Since the Windows operating environment does not support multimember bitmap images, the Group option is not available for bitmaps being converted to Windows; the image will default to the Items mode.

5. Select Save, under File, from the action bar menu to save your new image(s). You must have an entry in the Save to field(s) to use this option.

Converting Your Images Using the Command Line Processor
For conversions from the command line processor, use the command as follows:

>     ibmpcnv (w | o) [d] [h | ?] filein fileout

where:

-w | Save as Windows resource
-o | Save as OS/2 2.x or higher resource
-d | Convert directory contents
-h | Display command line help
-? | Display command line help
filein | Input file (if -d, use input directory)
fileout | Output file (if -d, use output directory)

Notes:

1. These parameters are not case sensitive.
2. A "/" may be used instead of "-" as a deliminator for the parameters.
3. The input and output filenames that you specify, when converting a single file, must be different from each other.
4. The ibmpcnv utility only allows you to save members as Item images, it is not recommended if you need to maintain certain size and color specifications in your converted image.
5. Only .BMP, .PTR, .ICO, and .CUR images can be converted with ths utility.
6. If the images that you wish to convert are not in the same directory as the installed utility, then you need to specify the pathname along with each of the filein and fileout name parameters.

Example of Command Line Conversions
To convert a Windows icon, called river.ico, to an OS/2 format, you would type the following:

>     ibmpcnv -o river.ico os2river.ico

To convert an OS/2 directory of icons (in a directory called os2icos), to a Windows format (to be saved in a directory called winicos), you would type the following:

>     ibmpcnv -w -d c:\os2icos c:\winicos

Resource Conversion Utility - An Overview