Posted: Mon Jun 27, 2011 2:32 pm Post subject:
VPLEdit - A VPL file editor for TS/RA2.
Subject description: GUI editor for voxels.vpl file.
NOTE: This software is no longer being actively supported and is provided as-is.
VPLEdit - A VPL file editor for TS/RA2
About
This tool I initially made for my own needs, in order to be able to edit TS/RA2 voxels.vpl file (Incase someone needs more info about what's it all about, read through this thread) without using hex editor by visualizing the data as what it's supposed to represent: different palette colors. It is not there to completely replace hex editor as a tool, since if you know what you're doing you make edits to voxels.vpl faster by using hex editor than with this tool, but I reckon people find something like this bit easier to use.
Main Features
* An ability to edit voxels.vpl color index data - choose an index from VPL section color table, then either input the desired palette index using text field or choose a color from palette color table. You can change the current section from the listbox.
* An ability to edit voxels.vpl file header flags, found under Edit -> Edit header flags.
* The program automatically makes backup of the vpl file when you open one in the same directory as original, named FILENAME_backup.vpl where FILENAME stands for the filename of original file without extension.
Usage
Since the program was done using Java programming language, you are going to need JRE (Java Runtime Environment) to run it. Unless your system already has the most recent version of JRE installed, I recommend getting it from here.
After that, running the program (vpledit.jar) should be as easy as just clicking the jar icon. This applies for Windows systems, atleast. As I've never touched any other OS than Windows, I have no idea how this would work for other types of operating systems such as UNIX-based ones
Alternate way to run this program (on a Windows system) if you have JRE installed, would be from command prompt using the following:
Where PATHTO_JAVA.EXE is the full path to java.exe on your computer, for example "C:\Program Files\Java\jre6\bin\java.exe" (You also need the quotes if the path has spaces like the example one has), PATHTO_VPLEDIT.JAR would be the path to the jar file itself, such as "C:\Stuff\vpledit.jar".
Last two are optional parameters for defining the vpl and palette files to use, respectively.
During startup, the program will search for files named voxels.vpl and unit.pal from the directory where you ran the program from. Should it not find the voxels.vpl file, it will prompt user to choose one using file browser. Closing the browser without choosing file shuts down the program. Similarly, if palette file is not found, user can choose one instead. However, if you don't choose a palette file the program will simply use a built-in one that matches Red Alert 2 unittem.pal file.
You can also load another vpl file or palette file while using the program by using options under "File" menu.
Other stuff
I don't have anything else to say, really. If you encounter problems trying to get the program to work or bugs in the behaviour, please post in this topic or throw me a private message about it. Considering this is first version, I am not expecting completely flawless behaviour, altough my focus was on the reliability and functionality rather than performance. I hope other people also find this tool as useful as I do.
Download VPLEdit Version 1.2.0 here.
If you wish to mirror this program at somewhere else, please note me of it beforehand. Last edited by Starkku on Fri Dec 21, 2018 2:02 pm; edited 7 times in total QUICK_EDIT
Bumping here... I've read it many times.
I'm still unsure of this tool's use.
The voxels just appear darker.
Is that the intention of this tool? _________________
Tore wrote:
Oh noes Nod32 must have found some GDI32 in the art.ini file!
Bumping here... I've read it many times.
I'm still unsure of this tool's use.
The voxels just appear darker.
Is that the intention of this tool?
Voxels.vpl file is split into 32 sections each containing 256 bytes which contain values corresponding to unit*.pal colors. Each one of those 256 bytes also corresponds to unit*.pal color indices on their own, in order from 0-255.
Basically you can think of it as a conversion table. You use, let's say color 15 to color your voxel, in-game depending on the facing, it gets turned into whatever color corresponds to the value of 16th byte of a particular section in voxels.vpl file. How the sections are assigned to voxel normal values is quite unclear, but the pattern in the voxels.vpl isn't - with colors getting lighter each step you take towards section 32 from the first one. If you don't get what I mean, just try the tool yourselves. It should be pretty clear then.
You can edit this file to make voxels look darker in-game. You can edit this file to fix inconsistencies Westwood left to the system. You can edit this file to make use of unused color slots in unit*.pal file. The list goes on. So far I haven't seen too many people really do anything with it. For example, in past few years I've been in this modding community I've seen a good few people yearn for custom voxel color schemes, something that's very well possible now. _________________ Last edited by Starkku on Fri Nov 25, 2011 11:23 am; edited 2 times in total QUICK_EDIT
Okay thanks for clearing that up, man. Will have to try this when I get home. In the meantime....make more useful tools in your spare time! _________________
Tore wrote:
Oh noes Nod32 must have found some GDI32 in the art.ini file!
Just a minor update, I uploaded version 1.1.0 and removed the old one.
Changes in version 1.1.0 * Color of the selection indicator for color tables is now determined by the color of the table cell (think of OS Palette Editor).
* Bunch of graphical and other glitches relating to color table cell selection handling, when re-loading VPL file have now been fixed.
* Cleaned up & optimized some code.
If someone encounters bugs, just throw me a PM or post here. I'll try to fix them. I don't think any further actual features are necessary, though. _________________ QUICK_EDIT
Excuse me for the bump, but I have an issue with the interface. The bottom row of the palette goes beyond the window border, making it almost impossible to select these indexes. There's no way to resize the window.
The VPL color table and the palette are also fused together, though I can live with that.
I am not really actively supporting this software anymore. Fixing the myriad of usability issues and generally sloppy code on backend that it has would require sizable amount of work I'd rather spend on making a better alternative from scratch.
That said, since there probably are not any decent alternatives around currently, I went ahead and tried to address this issue (although I am not entirely sure what's causing it in the first place since I cannot reproduce it), made the window resizable and did couple of other minor changes. Should be available from the link in the initial post. _________________ QUICK_EDIT
It was a DPI scaling issue. With the resizable UI, it gets solved. Even if there is a little clipping on the colors at 125% scaling, it can now be streched to solve it.
If not supporting, why not make it open source? QUICK_EDIT
It was a DPI scaling issue. With the resizable UI, it gets solved. Even if there is a little clipping on the colors at 125% scaling, it can now be streched to solve it.
If not supporting, why not make it open source?
DPI scaling came to mind, but I could not reproduce it even with higher DPI setting, so I wondered if it really could have been because of that. Whatever, as long as it is usable now.
Not keen on making the mess that this tool is open source. _________________ QUICK_EDIT
I remember when i said i never heard that vpl files can be edited since 2017. _________________ If you are a MetalHead (Heavy Metal Fan) and don't want to be a metalhead, Just remove your metal ball from your head. �:p .
QUICK_EDIT
You can post new topics in this forum You can reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum You cannot attach files in this forum You can download files in this forum