Tk Source Code

View Ticket
Login
2026-10-23
13:14 • Closed ticket [e1d86b04]: -cursor options: documentation plus 6 other changes artifact: a7c29b25 user: jan.nijtmans
2026-10-22
14:42
Fix [e1d86b048b]: -cursor options: documentation improvements check-in: e281821b user: jan.nijtmans tags: core-9-0-branch
14:41
Fix [e1d86b048b]: -cursor options: documentation improvements check-in: 250b737f user: jan.nijtmans tags: trunk, main
2026-10-09
12:25 • Ticket [e1d86b04] -cursor options: documentation status still Open with 4 other changes artifact: 406c91b4 user: jan.nijtmans
2026-10-08
15:31 • Ticket [e1d86b04]: 3 changes artifact: ac1e1766 user: serhiy.storchaka
15:30
Fix [e1d86b048b]: -cursor options: documentation. Fix the corrupted reference to the X cursor font (cursorfont.h), document that the cursor colors are only supported on X11 and are ignored for a cursor with two colors if a cursor theme is used, replace the obsolete description of Macintosh cursor resources, and document that the files of the @sourceName forms are X bitmap files which must define the hot spot. check-in: 428d9b1b user: serhiy.storchaka tags: cursor-file-tests
2020-08-18
19:05 • Ticket [e1d86b04] -cursor options: documentation status still Open with 4 other changes artifact: 9decfc35 user: fvogel
2019-12-01
16:03 • New ticket [e1d86b04]. artifact: b16381f6 user: bll

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.