Version 1.2

Peoples General DAT Tool

© Luis Guzmán

 

 
OVERVIEW
 

This is a windows program to maintenance SSI Peoples General DAT and S16 files.
 

I made this program to help on handling PeG DAT files and S126 files, but be aware this tool does not includes any graphic editor, as there are many good ones all over around..

This tool includes all features you can find on Progi's Dat Tool 3.1.1 - though not limited to use a DAT file called MODGEN - and on Fred Chlanda PeG Util plus some others only found here.

 
 

Index

Installation
Getting started
S16 Maintenance Tool
DAT Maintenance Tool
S16 Maker tool
Shp to S16 converter tool
 

Installation

To install, just copy the executable file wherever you like, no additional files are required to run.

Once you run first time and define folders and files, they will be remembered, but no files are loaded automatic, you must load using recent files menu.

As with all my other ˇutilities, settings are stored and retrieved form windows registry so no configuration files are used..

All options can be accessed through a menu option and most of them also using the toolbar; place mouse upon a button and a short tooltip will pop up with a short explanation.

back to index
 

Getting started

There are four tools inside this utility::

  1. S16 Tool.
    This tool lets you scan your s16 files in the folder you define and insert, append or remove single icons from any s16 file. You can also extract icons as bitmap files (surely to use as starting point to make other icons or to repaint and later reinsert) , Program will start here
    .

  2. Dat Tool.
    Here you should load a Dat file (no need to be named modgen.dat ) to work with. Then you can scan all the s16 files it contents.
    You can insert, append, replace or remove any single s16 file without unpacking/repacking the whole Dat file, You can also extract any single s16 file to disk or unpack all of them. Of course you can create new Dat files by repacking all s16 files in a folder.
    There is no SAVE, nor SAVE AS options as any action you can use, will update the file on disk though a back up copies will be saved (but be aware each change will update that copy). Last six files opened are saved as recent files, for quick re-loading.
     

  3. S16 Maker
    This tool allows creating s16 files from bitmaps. A list with bitmap files in the folder you define will be shown to help you to pick the proper ones.
    Normal method would  be to doble-clicking on each bitmap having a single icon to add to the s16  file. You can reorder or remove any at any time before proceding. There are also an express mode to make 9 clones of a bitmap into a s16 file (later you can replace with the properly faced one).
     

  4.  Shp to S16 converter.
    As you can expect, this tool allows to convert PG2 Shp files into PeG-S16. Compression will be selected automatic for each icon based on smaller size as possible. You can preview both the Shp file and the converted S16 even before converting.
    Conversion can be done on a single Shp base or selecting several Shp files to batch convert.
     

When converting  Bitmaps into S16 files you should remember this:

  1. Only Bitmaps 8 bits (256 palette colors),  24 bits or 32 bits can be used.

  2. Bitmap's width and height will become icon total width and height

  3. For bitmaps 24 or 32 bits, all pixels with a color RGB(220,220,248) will be taken as transparent and so skipped or converted into PeG transparent color RGB(248,0,248).

  4. For bitmap 8 bits  (256 palette colors),  index #159 - RGB(248,228,216) will be taken as transparent as I understand it was saved from a PG2 icon..
     

back to index
 

S16 Maintenance Tool

This is the start window and as I said before, this view lets you scan your s16 files in the folder to make any changes you need.

You will see this toolbar:


  
    2     3        4      5     6      7      8       9     10    11

  1. S16 Maker tool
  2. Dat Maintenance tool
  3. Shp to S16 converter
  4. Normal icon view
  5. Zoom X 2
  6. Zoom X 3
  7. Collage
  8. Mirror
  9. Extract as S16
  10. Save as BMP
  11. Save all icons as BMP
  12. About

An a list of all S16 files within your folder and for the one selected, all the icons contained and its stats as size, offset, ...
Either you select to see as single icon or a collage starting on selected icon, there is always one selected and stat refers to that icon.
More common options to change appearance as available both on toolbar and as buttons. But main actions are only available using buttons.

Icons Options

In order to use a Bitmap to convert into an icon it should be:

  1. 8 bits (256 palette colors) or  24 bits /  32 bits

  2. Bitmap's width and height will become icon total width and height

  3. For bitmaps 24 or 32 bits, all pixels with a color RGB(220,220,248) will be taken as transparent and so skipped or converted into PeG transparent color RGB(248,0,248).
    For 8 bits bitmap,  index 159 - RGB(248,228,216) will be taken as transparent as I understand it was saved from a PG2 icon..
     

back to

DAT Maintenance Tool

This view will be blank until you load a Dat file.

Once you have loaded a DAT file you will get a list of  S16 files within it on left hand side.


  
    2     3        4          5     6        7      8     9        10   11   12    13    14    15   16     17    18    19      20    21    22     23

  1. S16 Maker toole
  2. S16 Maintenance too
  3. Shp to S16 converter
  4. Load DAT (and recent files)
  5. Repack (create DAT)
  6. Extract all S16 files
  7. Show all S16
  8. Show only 9 icons files
  9. Show only no 9 icons files
  10. normal view
  11. Zoom X 2
  12. Zoom X 3
  13. Zoom X 4
  14. Zoom X 5
  15. Collage
  16. Mirror
  17. Extract as S16
  18. Save as BMP
  19. Save all icons as BMP
  20. Replace S16
  21. Remove S16
  22. Add S16
  23. About

You have many options to select how to draw the pictures and some buttons to scroll icons within a S16 file I think it is intuitive enough as to need further instructions, just try a little to get used of it. At any time if any icon is bigger that picture box, icon will be resized to fit into, so check size and position reading the info upon picture box. Even if viewing as a collage, there is one selected icon whose data is shown.

As usually a Dat file has many items, there are a filter feature to isolate the items you are interested.
First choice is to isolate all icons having 9 icons or not having 9 icons and then set a further condition based on icon name:

 MAIN Options:

This last 3 options will update DAT file on disk, so no need to change name or whatever. A back up copy will be saved each time the tool modifies DAT file on disk, it will be numbered to avoid over-witting any valid data.

I think this options cover anything you could need to tweak your DAT file anyway you can need, but if you found there is something missing, do not hesitate to tell me.
 

 back to index index

S16 Maker

This option will pop up a new window showing all bitmaps availables in a folder for creating new S16 files.
You can select a different folder at any time and last one selected will be remembered next time you use this option, and all bitmaps within that folder will be shown.

There are only two options

Bitmap size and type (resolution) is shown as well as Pixel (0,0) color to allow checking it has the proper values.

back to index
 

Shp-S16 Converter

This option allows converting PG2 Shp files into PeG-S16 files.
It also will pop up a new window showing all  PG2-Shp files within the folder you select.You can select a different folder at any time and last one selected will be remembered next time you use this option. You need to define also a  folder  to store converted PeG-S16 files.

By default only files not converted yet will be included (I mean files with a common file name will be excluded) but you can turn it to see all files.

A collage will be drawn for selected Shp file but you can see how it would be onverted by checking ON  a switch, then background will turn into a grey one instead of the blue default.+

You can convert a single Shp or many - all Shp you select will be converted when you click on  Make S16  Button
 

back to index