Ever needed to convert a GRP from PTC to a GRP in SB? Probably not; but just in case, here's a tool that does just that!
PTCGRPConv is a command-line utility for converting a PTC-format GRP file into a SB-format GRP file. The generated file (with headers) can then be transferred with a utility of your choice to SmileBASIC.
Features
- Cross-platform: Runs anywhere with an installed C#/.NET 4.5.1 runtime.
- Supports COL files for GRPs that require custom palettes (default palette already included and need not be specified!)
- Fast and (relatively) easy to use
Setup
- Check if your C# runtime is installed/up to date:
- For Windows: Be sure at least .NET Framework 4.5.1 is installed.
- For Linux: Install and update the complete Mono runtime package for your distribution.
- For Mac: I honestly have no idea.
- Download the PTCGRPConv package:
- Extract the ZIP file
Instructions
How to run
For Windows, open a Command Prompt and navigate to the PTCGRPConv folder. Be sure the files you wish to use for conversion are in the same folder. Then, run the following command:
ptcgrpconv.exe args...
args... is the argument list, which is explained below.
For Linux, the process is much the same. However, the command is different.
mono ptcgrpconv.exe args...
Arguments
In its simplest form, the command accepts two arguments. The first is the source GRP you want to convert, and the second is the output file. The output file need not exist; it is created automatically if it doesn't. Use this form if the GRP doesn't require a custom palette.
ptcgrpconv.exe ingrp outgrp
If the GRP requires a custom palette, then pass the palette option like so:
ptcgrpconv.exe -palette incol ingrp outgrp
The
incol argument is a PTC COL file.
