Skip to content

Latest commit

 

History

History

cursors

README.md

Breeze Cursors

Editing the SVGs

SVG cursors are individual ".svg" files in the "{Breeze,Breeze_Light}/src/svg" directory.

The canvas size should correspond to a nominal size (reported to apps, and shown in the cursor KCM) of 24.

Each SVG must contain an invisible rectangle with the id hotspot. The top-left corner of the rectangle defines the hotspot of the cursor. It doesn't have to be at integer coordinates. When exporting the cursor to pixmap format, the hotspot will be rounded to the floor.

Building the Cursors

Because building cursors requires Inkscape, it's not integrated into the normal cmake build. After making changes to the SVGs, you should manually build the cursor theme:

  1. Ensure you have Inkscape and xcursorgen installed.
  2. "cd" into the "Breeze" and "Breeze_Light" directory and run "../src/build.sh" script. The script will first use Inkscape to render SVGs into PNGs in the "build" directory, then use xcursorgen to generate the X11 cursor theme in the "Breeze/Breeze" or "Breeze_Light/Breeze_Light" directory.
  3. Commit changes in the theme directories to git.

SVG cursor format

In addition to the standard XCursor format in "cursors" directory, the original SVGs are also deployed in the "cursors_scalable" directory. See "cursors_scalable.md" for the spec.