Region Generator v1.0

[ Details | Review | Screenshot | Author's Notes | Download ]

Author:
Homepage:		http://www.skinmaster.co.uk
Rating:
File Size:		1.556 KB
Released:		06/08/1999
License:		Freeware

Whereas other editors allow you to manually trace transparent regions with your mouse, Region Generator v1.0 goes a step further and automatically traces your skin and saves the transparency data to your region.txt. For the utility to work, your main.bmp must be reduced to two colors, an "in" and "out" color. The latter is to be used for the transparent regions. The used trace algorithm starts at the top left and searches each row for the first "out"-colored pixel and then follows the path until it gets stuck. This happens if your skin has multiple transparent sections. In that case you will have to create a template for each region, in order to have them each traced automatically. The output can then be manually combined in your region.txt. Region Generator is limited to creating transparencies for Winamp's main window. Support for the equalizer window is not implemented.

Region Generator Version 1.0 From Michael Soft.

Copyright and Trademarks:
WinAmp etc are copyright NULLSOFT and used in passing mention, if this upsets them sorry.

As for Region Generator, it is CopyLeft, MichaelSoft (A joke name and if Microsoft object sorry). That means you are free to redistribute this application as much as you like, provided you don't charge for it in anyway. No putting it on Cover Disks or on any distributed CD's without my written (not electronic) permission.

Source:
When I have cleared it up and added a couple of bits and bobs I will distribute the Source Code (VB6) from my home page http://metalmachine.freeserve.co.uk

Program:

Region Generator is designed to create region.txt files for the main window in WinAmp. The way to use it is as follows:

1. Get your lovely main skin template and create a mask in one solid colour of the area you want visible (use a layer possibly, or make sure you back up the original and draw over it), then colour the rest in with another colour.
2. Save the mask (without destroying the base of your skin!), it should be 275 x 116 pixels.
3. Run Region.exe, click file, load or hit ctrl-l, browse to your file and load it.
4. Select in, out and trace colours. (With the in/out/trace buttons or left click on the image to select in, right to select out colour.)
   The program will then follow the border between the in and out colours, marking it (temporarily) with the trace colour (So you can see where it's traced)
5. Manually make any adjustments to the region.txt panel, and copy and paste into a file, or click save or file,save to create a new text file.

Limitations:
Currectly Region Generator starts at top left and searches each row in turn for a path start and then follows the path until it gets stuck. It currently only looks for one path, then it finishes searching. If you have multiple seperated in regions then you will have to trace each individually then combine the data.

There should always be a 1 pixel wide clear border round the edge, or the algoritm will get stuck.

Grids as follows:
00000
01000
00110

Where '1' is an "in" pixel and '0' an out pixel (i.e. diagonal connectivity) will cause problems with the algorithm so make sure there are none.

Also if your line doubles back ensure there is a 2 pixel gap between "in" regions at least to allow the edge to go back through.

Bug reports and suggestions to