mirror of
https://github.com/ful1e5/Bibata_Cursor.git
synced 2025-06-05 17:14:34 -04:00
24 lines
1.5 KiB
Markdown
24 lines
1.5 KiB
Markdown
## 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.
|