Files
xfce-winxp-tc/tools/bldutils/README.MD

33 lines
1.5 KiB
Markdown

# Build Utilities
This directory contains tools used by build processes.
## Tools Available
Below describes each tool in this directory.
### bldmaps
`bldmaps.py` is used to create the symbolic links via a `mappings` file.
This script is used mainly for the cursors, icons, and sounds, so that there can be one 'dumping ground' (`res/` directory) and then the actual XDG filenames just point to the resources.
The mapping file is quite simply just a text file in the form:
```
symlink_name-->target_resource
```
### bldtheme
`bldtheme.py` is used to compose the graphics for the *Windows Classic* theme (either the GTK2 theme used by everything, or the actual *Windows Classic* theme for the GTK3 bits).
It scans an input directory looking for files that need composing and files that should just go straight to output:
For files that need composing, there must be a `*.src.png` file for the graphic, and a `*.mask.png` that will be used to apply the colour scheme to it.
For files that don't need composing (just copy to output), name the file `*.static.png`.
### compcurs
`compcurs.py` is used to compile the X11 cursor images from source graphics, and a configuration (which defines the hotspot of the cursor).
It is quite self explanitory, PNGs for graphics, and it will glob for `*.cfg` files to start compiling from.
## If you're stuck
For specific details on usages, you can pass `--help` to each script to get the parameter information. The above should give you enough context to understand how each tool is used, should you ever need them.