Region

Region.Txt

This file allows you to mask off regions of your skin, i.e. make them clear. By specifying regions you can create skins that no longer square, but have rounded or diagonal edges. This is accomplished by specifying the points of a polygon. Only the pixels that are inside the polygon will be displayed.

Regions

Header
To create a region, first type in the header for the window you want to mask

[Normal] Main window
[Equalizer] Equalizer window

Values
Next, create two values called NumPoints and PointList

NumPoints= the number of points in each polygon
PointList= the list of points

PointList
Points are given in X,Y pairs. X can be any value from 0-275 and Y 0-116.

The point values can be separated by commas or spaces, but all points must remain on the same line! So, to make things easier to read, I separate pairs with commas, points with one space, and polygons with three spaces.
Winamp will close the polygon for you, meaning that it will connect the last point to the first.
It doesn't matter which point is first, or which direction you go around the polygon, but all points must be consecutive.
Pixels intersected on the top-left sides are drawn, but pixels intersected on the bottom-right sides are are not. So the bottom-right points have to be extended an extra pixel in many cases.
Create your regions in doublesize mode. Because the resolution is 4x higher, pixels might show through that don't in normal mode.

Examples
These examples are all found in Region.Txt. To use a particular region, just uncomment it. If multiple regions are uncommented, Winamp will use the first one.

Default region
This first example defines a polygon with points at each corner of the window, so everything is displayed.

[Normal] NumPoints=4 PointList=0,0 275,0 275,116 0,116

Separated
The first polygon outlines the title bar. The second outlines the main window minus the top three rows of pixels. This gives the effect of the title bar floating above the window.

Numpoints=4,4 PointList=0,0 275,0 275,15 0,15 0,18 275,18 275,116 0,116

Jaggies
Who said polygons have to be square? This example puts serrated edges on the skin.

NumPoints=22 PointList=275,0 275,53 268,60 275,67 268,74 275,81 268,88 275,95 268,102 275,109 268,116 0,116 0,63 7,56 0,49 7,42 0,35 7,28 0,21 7,14 0,7 7,0

Where's the title?
This region is a little more complicated. The polygon runs across the top of the window, cuts down, circles the title box, comes back up, and continues around the window.

NumPoints=10 PointList=0,0 111,0 111,34 266,34 266,27 111,27 111,0 275,0 275,116 0,116