script info added

This commit is contained in:
KAiZ 2019-11-13 10:27:48 +05:30
parent b2c3cea4ce
commit bdd266a829

24
src/README.md Normal file
View file

@ -0,0 +1,24 @@
## Cursor Theme Source
- Do not edit cursor assets directly (i.e. those in the "../_Theme_name_/out/X11/_Theme_name_" folder)!
- To modify the cursors, edit source SVG file found in this directory and render them with the appropriate script.
- To edit the cursors you will need `inkscape` installed and to build and the render the cursor set you'll need `python-pil` and `x11-apps` installed.
## Render Scripts
For simplified development, has various scripts to render and build the cursor set are provided
- [**render-cursors.py**](../render-cursors.py) will render the cursor PNG assets into **bitmaps** at the appropriate sizes; ran by passing the source filename to it: `../render-cursors.py ./Bibata_Classic/source-cursors.svg` (e.g. Bibata Classic)
- [**x11-make.sh**](../x11-make.sh) builds the cursor assets into a Xcursor set
- [**w32-make.sh**](../w32-make.sh) builds the cursor assets into a Windows cursor set
## Cursor SVG source
The [source SVG](./Bibata_Classic/source-cursors.svg) (e.g. Bibata Classic) for the cursors is laid out in such a way to make editing/creating cursors simple, with a variety of layers:
- `hotspots` shows the exact point where the cursor is active within the 24x24 region (hidden by default)
- `slices` is read by the render script and each 24x24 square had an ID that is the cursor file name (hidden by default)
- `cursors` pretty self-explanatory, these are the drawn cursors
- `labels` are just labels
Both the busy cursors (the large and pointer versions) require 60 different assets to achieve a 60 FPS animation when compiled.