' ----------------------------------------
' File to DSi Petit Computer resource data
'                                         
'          DSPCBMP converter version 2.00 
' ----------------------------------------

@INFO

This is a tool. 
It is possible to convert a text file, 1-256 colors bitmapped image,
and binary data to the PTC file and DATA statement for Petit Computer. 

The function to extract a text file and bitmapped image data
from a PTC file is also attached. 

> 256 or less colors paletted BMP image => PTC file ( containing a CHR resource )
> 256 or less colors paletted BMP image => PTC file ( containing a GRP resource )
> TXT file ( BASIC programs in ) (*1)   => PTC file ( containing a PRG resource )
> other files                           => PTC file ( containing a GRP resource which packed up binary data )
> PTC file                              => TXT file / BMP files

*1 : text charset is supported "S-JIS" only.



@HOW_TO_USE
It starts in a double click and chooses the kind to convert. 
Next, the file to convert is directly chosen
or dragged and dropped in a window. 

A PTC file will be created if it succeeds in a conversion. 
The created PTC file can be used by Petit Computer
by converting to QR Code by the official site of Petit Computer, etc. 


@NOTES
The file which a file name finishes as _COL.PTC contains a color palette. 
The file which a file name finishes as _CHR(number).PTC contains BG/sprite. 
The file which a file name finishes as _GRP.PTC contains a GRP picture. 
The file which a file name finishes as _SCR.PTC contains BG screen data. 
The file which a file name finishes as _MEM.PTC contains a MEM$ character string. 

The thing changed into the text created together with a PTC file
at DATA-statement form is indicated. 
Please use if needed. 

A setup which does not output a text file as an option can also be specified. 


@CAUTION
 > About the conversion to BG/sprite. 
The color which can be used by BG/sprite
is a "15 color x16 pattern + transparent color." 

The palette of the multiple of the palette numbers 0 and 16
becomes transparent color treatment regardless of specification of a color. 
Moreover, the picture which specifies the palette number 16 or subsequent ones
is transposed to the palette numbers 0-15 in the case of a conversion. 

The palette for BG also influences the font used by the display (PRINT command) of a console. 
If you do not want to change a character color, it is necessary to write that it writes
out in DATA-statement form and a program does not overwrite an applicable palette number. 

The palette which subtracted 1 from the multiple of 16 is used with the font. 
For example, they are 15 and 255 grades. 
However, other palettes may be carried out when BGF0 is being rewritten by CHRSET. 

 > About a conversion in a GRP picture. 
The image for graphics (GRP resource) is not 256 colors
but a "255 color + transparent color." 

With the specification of Petit Computer, the palette number 0 certainly
becomes a transparent color regardless of specification of a color. 


@OPTIONS
The following item can be set up with an option menu. 
A setup of an option is saved at an ini file. 
Deletion of an ini file will initialize a setup. 

 > Save to...
The preservation place of the converted file can be chosen. 
When a check mark is inputted for "Make 'PTC' folder", a subfolder is made to
the specified conservative field place, and a file is saved there. 

 > Common settings
It is changed whether the text file to which the DATA statement was written is created. 
The form of the DATA statement at the time of converting in
GRP (graphics) form can also be changed here. 

If it is a hexadecimal number, a return will be carried out every 32 dots,
and if it is a decimal number, a return will be carried out every 16 dots. 

 > CHR resource settings
In the case of a conversion, it can be chosen whether the original image size is maintained. 

When a check mark is inputted, the row of the original image
is maintained and is arranged in the specified size. 
As the method of the conversion in that case, it writes out as an image of 128x128,
writes out as an image of 256x64, or can choose either. 
In addition, it is the form of 256x64 which can be
intelligibly displayed on Petit Computer by the attached editor CHRED. 

When a check is removed, an image is rearranged per one sprite
and it writes out by consecutive numbers. 
In that case, in the case of the size which the original image
cannot divide among the size of sprite, a conversion goes wrong. 
BG/font goes wrong, when size is not a multiple of 8. 

 > PRG text settings
If a check mark is attached and the character of 100 or
more characters is written to one line, a conversion will go wrong. 

When the check was removed and it is converted, 
The 100th character will be changed into a newline character by Petit Computer,
and the character which originally existed will be erased. 

 > PTC file settings
The method of preservation of the program taken out from a PTC file and an image can be changed. 
When a check is put into "Make text at S-JIS char set in program data", and taking out a program
from a PTC file, all are converted to the multi-byte character of the Shift-JIS code. 
The character which cannot be displayed with PC is replaced by other characters. 
When a check is removed, it saves with a single byte. 

When a check is put into "Escape smaller or bigger code's chars",all characters other than
the alphabet, a sign, and katakana are transposed to \(hexadecimal number of double figures). 
By the preservation to a text, and the conversion to PTC,
if a setup of an escape is not the same, it will not become. 


@DELETE
 > About uninstallation. 
Registry has not changed. 
Uninstallation is completed by deleting a file and a folder. 


@HISTORY
v2.00
  > The function which creates a PTC package was added. 
  > The conversion function of a SCR resource and a MEM resource was added. 
  > Translation of http://www.excite.co.jp/was used for the notation of a manual. 
      - The mistake in English translation is not my responsibility! :-)
  > Bug fixed.
      - bug : The conversion of the COL resource had outputted the value which is not right. 

v1.56
  > Create file size fixed for 4 byte times.
  > Bug fixed.
      - bug: show 'failed' counts in PRG formated PTC files convert successfully.

v1.55
  > Bug fixed.
      - bug: 1bit image has not been successfully converted.

v1.54
  > The English version was created.


@END