Tk Source Code

View Ticket
Login
Ticket UUID: e1d86b048b9c9c4ea8133e79b3b7afc0b212ea
Title: -cursor options: documentation
Type: Bug Version: 8.6.10
Submitter: bll Created on: 2019-12-01 16:03:55
Subsystem: 31. Cursor Names Assigned To: jan.nijtmans
Priority: 5 Medium Severity: Minor
Status: Closed Last Modified: 2026-10-23 13:14:54
Resolution: Fixed Closed By: jan.nijtmans
    Closed on: 2026-10-23 13:14:54
Description:
The wiki page:
   [https://wiki.tcl-lang.org/page/custom+cursors]
claims that cursors can change colors, but that doesn't seem to work.

The following possibilities are listed:

name ?fgColor? ?bgColor?
@sourceName maskName fgColor bgColor
@sourceName

I tried the first, and it does not seem to work (on a pre-defined cursor).
According to the wiki page, the @sourcename form works on windows and X11.

I tried the .xbm file on X11 and that does not seem to work.

If any of these options work any more they should be documented.
I guess if none are working, the documentation is correct.
User Comments: jan.nijtmans added on 2026-10-23 13:14:54:

Fixed in [250b737f|trunk] and core-9-0-branch

Many thanks!


jan.nijtmans added on 2026-10-09 12:25:07:

I'll have to look at "make dist", making sure the additional cursors will be included into the distribution tar.gz.


serhiy.storchaka added on 2026-10-08 15:31:54:

Fixed in branch cursor-file-tests, [428d9b1bb2]. The colors of a named cursor are only supported on X11, and if a cursor theme is used (with the Xcursor library, the default on most current desktops), a cursor with two colors is shown with the colors of the theme; a cursor with only fgColor is still drawn in that color. Windows and macOS ignore the colors. This is now documented. The files of the @sourceName forms are X bitmap files, and the source file must define the hot spot (x_hot, y_hot), otherwise the cursor spec is rejected; this is now documented too. The outdated description of Macintosh cursor resources is replaced.