File: README

package info (click to toggle)
comixcursors 0.6.1-4
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 880 kB
  • ctags: 35
  • sloc: sh: 567; makefile: 87
file content (329 lines) | stat: -rw-r--r-- 17,480 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
#
# The original Comix Cursors sources README
#

INSTALLATION

You need to have the ImageMagick (www.imagemagick.org)
tools and Inkscape (www.inkscape.org) installed, to run
the installation script!

If you have, issue

# ./install.bash

This will read the basic cursors from the svg files, add
a blurred and scaled shadow, tint the icons and compose 
them into a single png image. After all the images have
bee processed, the script will invoke "make" and "make 
install", to create the xcursor files and install them 
into you personal cursors folder (~/.icons/). 
Thanks to uga and the RedDot cursor theme for the basic
skeleton and Makefile. 

Read the file INSTALLATION for installation details. 


CUSTOMIZE YOUR CURSORS

Despite the actual svg files a lot of customization can be
done while composing the images. 

All configuration options are in the "CONFIG" file, which gets
processed by the install and svg2png scripts. Some options
can also get passed to the svg2png script, issue "./svg2png.bash"
for a list of them.

The "svg2png.bash" script is used by the "install.bash"
script, so when you want to batch-process you svgs you can 
either add as many options to the command line as you want, 
or edit the default values in the CONFIG file.

Pitfalls:

- KDE's control center Mouse Theme Installation does not support symlinks
  in the packed archives (tar). This produces *big* overhead for syncing 
  the different naming schemes.  
- Gnome puts different cursor sizes in one xcursor file, which might be 
  ment the way to do, but what about memory? They sure know. And Gnome 
  supports distinct cursor sizes only (16,24,32,48). 
- If you are missing some cursors issue "# export XCURSOR_DISCOVER=1" 
  and re-start the application to find the corresponding cursor hash. 
  Report it to me or link it yourself in the ~/incons directory. 


NAMING CURSORS

There is a cursor conventions specification (Oct 2003):

	http://www.freedesktop.org/Standards/cursor-spec

	X-cursor    					The X window system logo. 
	default						Default cursor. Indicates the interface is idle and prepared to accept commands from the user. Used to manipulate basic user interface elements like buttons and scrollbars. Usually a left pointing diagonal arrow. 
	right-arrow					Inverted version of the default cursor. This cursor is used in Motif when a popup menu or a drop down combo-box is open, to indicate that the widget has grabbed the mouse. Typically rendered as a right pointing diagonal arrow. 
	up-arrow					Up pointing arrow cursor. This cursor is typically used to identify an insertion point. 
	text						Text input cursor. Indicates that the cursor is in a region in which horizontal text can be selected and possibly edited. Typically rendered as a vertical I-beam. 
	vertical-text					Text input cursor. Indicates that the cursor is in a region in which vertical text can be selected and possibly edited. Typically rendered as a horizontal I-beam. 
	pointer						Indicates that the object below the cursor is clickable. This cursor is typically used for links in web browsers. It shouldn't be abused for pushbuttons and other UI elements where it's otherwise apparent by the design of the widget that it's a clickable object. Often rendered as a pointing hand. 
	crosshair					Crosshair cursor. Typically used for precision drawing or manipulation of an area. 
	help						Help cursor. Indicates that the system is in a context help mode, and if the user clicks an object a small window will open up to provide usage information for that object. The context help mode is typically activated by clicking a help button on the titlebar of a window that provides context help. Often rendered as the default cursor with a question mark symbol next to it. 
	progress					Default cursor + busy cursor. Indicates a pending activity which may asynchronously affect the interface but which is not blocking commands from the user. 
	wait						Busy cursor. Indicates that the interface is not prepared to accept commands from the user and is blocked on some external resource. Often rendered as a watch or an hourglass. 
	copy						!DnD copy cursor. Indicates that a copy of the dragged object will be created in the area below the cursor if dropped. Typically rendered as the default cursor with a small plus sign next to it. 
	alias						!DnD link cursor. Indicates that a link to the original location of the dragged object will be created in the area below the cursor if dropped. Typically rendered as the default cursor with a small curved arrow next to it. 
	no-drop						!DnD no-drop cursor. Indicates that the dragged object can't be dropped in the region below the cursor. Typically rendered as the default cursor with a small circle with a diagonal line through it. Can be identical to not-allowed. 
	not-allowed					Forbidden cursor. Indicates that a particular region is invalid for the current operation. Often rendered as circle with a diagonal line through it. 
	cell						The thick plus sign cursor that's typically used in spread-sheet applications to select cells. 
	all-scroll					Scroll/move cursor. Used to indicate that moving the mouse will also move the UI element below the cursor. Often rendered as a combined vertical and horizontal twin-headed arrow. 
	context-menu					Indicates that a context menu is available for the object underneath the cursor. Typically rendered as the default cursor with a small menu-like graphic next to it. 
	row-resize					Horizontal splitter bar cursor. Indicates that the bar below the cursor can be moved up and down to resize the objects it separates. Used when it's not apparent if the object below the cursor is just a visual separator between two other UI elements, or an object that can be manipulated. Usually rendered as a vertical twin-headed arrow, split in the middle by a horizontal line. 
	col-resize					Vertical splitter bar cursor. Indicates that the bar below the cursor can be moved left and right to resize the objects it separates. Used when it's not apparent if the object below the cursor is just a visual separator between two other UI elements, or an object that can be manipulated. Usually rendered as a horizonal twin-headed arrow, split in the middle by a vertical line. 
	e-resize					Indicates that the cursor is over the right edge of a window, and that the edge can be clicked and dragged in order to resize the window horizontally. 
	ne-resize					Indicates that the cursor is over the top-right edge of a window, and that the edge can be clicked and dragged in order to resize the window diagonally. 
	nw-resize					Indicates that the cursor is over the top-left edge of a window, and that the edge can be clicked and dragged in order to resize the window diagonally. 
	n-resize					Indicates that the cursor is over the top edge of a window, and that the edge can be clicked and dragged in order to resize the window vertically. 
	se-resize					Indicates that the cursor is over the bottom-right edge of a window, and that the edge can be clicked and dragged in order to resize the window diagonally. 
	sw-resize					Indicates that the cursor is over the bottom-left edge of a window, and that the edge can be clicked and dragged in order to resize the window diagonally. 
	s-resize					Indicates that the cursor is over the bottom edge of a window, and that the edge can be clicked and dragged in order to resize the window vertically. 
	w-resize					Indicates that the cursor is over the left edge of a window, and that the edge can be clicked and dragged in order to resize the window horizontally. 
	ew-resize					Horizontal resizing cursor. Indicates that cursor is over the the left or right edge of a window, and that ithe edge can be clicked and dragged to resize the window horizontally. Typically rendered as a horizontal twin-headed arrow. 
	ns-resize					Vertical resizing cursor. Indicates that cursor is over the the top or bottom edge of a window, and that the edge can be clicked and dragged to resize the window vertically. Typically rendered as a verticaly twin-headed arrow. 
	nesw-resize					Back-diagonal resizing cursor. Indicates that the UI element below the cursor is the top-right or bottom-left corner of a window, and that it can be clicked and dragged to resize the window diagonally. Typically a twin-headed arrow. 
	nwse-resize					Forward-diagonal resizing cursor. Indicates that the UI element below the cursor is the top-left or bottom-right corner of a window, and that it can be clicked and dragged to resize the window diagonally. Typically a twin-headed arrow.

This is the current xorg naming convention (CursorName.c, cursor.bdf):

	x_cursor				XC_X_cursor
	arrow					XC_arrow
	based_arrow_down			XC_based_arrow_down
	based_arrow_up				XC_based_arrow_up
	boat					XC_boat
	bogosity				XC_bogosity
	bottom_left_corner			XC_bottom_left_corner
	bottom_right_corner			XC_bottom_right_corner
	bottom_side				XC_bottom_side
	bottom_tee				XC_bottom_tee
	box_spiral				XC_box_spiral
	center_ptr				XC_center_ptr
	circle					XC_circle
	clock					XC_clock
	coffee_mug				XC_coffee_mug
	cross					XC_cross
	cross_reverse				XC_cross_reverse
	crosshair				XC_crosshair
	diamond_cross				XC_diamond_cross
	dot					XC_dot
	dotbox					XC_dotbox
	double_arrow				XC_double_arrow
	draft_large				XC_draft_large
	draft_small				XC_draft_small
	draped_box				XC_draped_box
	exchange				XC_exchange
	fleur					XC_fleur
	gobbler					XC_gobbler
	gumby					XC_gumby
	hand1					XC_hand1
	hand2					XC_hand2
	heart					XC_heart
	icon					XC_icon
	iron_cross				XC_iron_cross
	left_ptr				XC_left_ptr
	left_side				XC_left_side
	left_tee				XC_left_tee
	leftbutton				XC_leftbutton
	ll_angle				XC_ll_angle
	lr_angle				XC_lr_angle
	man					XC_man
	middlebutton				XC_middlebutton
	mouse					XC_mouse
	pencil					XC_pencil
	pirate					XC_pirate
	plus					XC_plus
	question_arrow				XC_question_arrow
	right_ptr				XC_right_ptr
	right_side				XC_right_side
	right_tee				XC_right_tee
	rightbutton				XC_rightbutton
	rtl_logo				XC_rtl_logo
	sailboat				XC_sailboat
	sb_down_arrow				XC_sb_down_arrow
	sb_h_double_arrow			XC_sb_h_double_arrow
	sb_left_arrow				XC_sb_left_arrow
	sb_right_arrow				XC_sb_right_arrow
	sb_up_arrow				XC_sb_up_arrow
	sb_v_double_arrow			XC_sb_v_double_arrow
	shuttle					XC_shuttle
	sizing					XC_sizing
	spider					XC_spider
	spraycan				XC_spraycan
	star					XC_star
	target					XC_target
	tcross					XC_tcross
	top_left_arrow				XC_top_left_arrow
	top_left_corner				XC_top_left_corner
	top_right_corner			XC_top_right_corner
	top_side				XC_top_side
	top_tee					XC_top_tee
	trek					XC_trek
	ul_angle				XC_ul_angle
	umbrella				XC_umbrella
	ur_angle				XC_ur_angle
	watch					XC_watch
	xterm					XC_xterm


This is the current (Qt4) cursor name scheme (qcursor.cpp, qcursor_x11.cpp):

	Qt::ArrowCursor             left_ptr
	Qt::UpArrowCursor           up_arrow
	Qt::CrossCursor             cross
	Qt::WaitCursor              wait
	Qt::BusyCursor              left_ptr_watch
	Qt::IBeamCursor             ibeam
	Qt::SizeVerCursor           size_ver
	Qt::SizeHorCursor           size_hor
	Qt::SizeBDiagCursor         size_bdiag
	Qt::SizeFDiagCursor         size_fdiag
	Qt::SizeAllCursor           size_all
	Qt::SplitVCursor            split_v
	Qt::SplitHCursor            split_h
	Qt::PointingHandCursor      pointing_hand
	Qt::ForbiddenCursor         forbidden
	Qt::WhatsThisCursor         whats_this

    # map Q cursor to X cursor
    Qt::ArrowCursor:			XC_left_ptr;
    Qt::UpArrowCursor:			XC_center_ptr;
    Qt::CrossCursor:			XC_crosshair;
    Qt::WaitCursor:			XC_watch;
    Qt::IBeamCursor:			XC_xterm;
    Qt::SizeAllCursor:			XC_fleur;
    Qt::PointingHandCursor:		XC_hand2;
    Qt::SizeBDiagCursor:		XC_top_right_corner;
    Qt::SizeFDiagCursor:		XC_bottom_right_corner;
    Qt::BlankCursor:
    Qt::SizeVerCursor:			XC_sb_v_double_arrow;
    Qt::SplitVCursor:			XC_sb_v_double_arrow;
    Qt::SizeHorCursor:			XC_sb_h_double_arrow;
    Qt::SplitHCursor:			XC_sb_h_double_arrow;
    Qt::WhatsThisCursor:		XC_question_arrow;
    Qt::ForbiddenCursor:		XC_circle;
    Qt::BusyCursor:			XC_watch;

This is the current Gnome curser names (gdk_enums.def)

	# x-cursor				GDK_X_CURSOR
	arrow					GDK_ARROW
	based-arrow-down			GDK_BASED_ARROW_DOWN
	based-arrow-up				GDK_BASED_ARROW_UP
	boat					GDK_BOAT
	bogosity				GDK_BOGOSITY
	bottom-left-corner			GDK_BOTTOM_LEFT_CORNER
	bottom-right-corner			GDK_BOTTOM_RIGHT_CORNER
	bottom-side				GDK_BOTTOM_SIDE
	bottom-tee				GDK_BOTTOM_TEE
	box-spiral				GDK_BOX_SPIRAL
	center-ptr				GDK_CENTER_PTR
	circle					GDK_CIRCLE
	clock					GDK_CLOCK
	coffee-mug				GDK_COFFEE_MUG
	cross					GDK_CROSS
	cross-reverse				GDK_CROSS_REVERSE
	crosshair				GDK_CROSSHAIR
	diamond-cross				GDK_DIAMOND_CROSS
	dot					GDK_DO
	dotbox					GDK_DOTBOX
	double-arrow				GDK_DOUBLE_ARROW
	draft-large				GDK_DRAFT_LARGE
	draft-small				GDK_DRAFT_SMALL
	draped-box				GDK_DRAPED_BOX
	exchange				GDK_EXCHANGE
	fleur					GDK_FLEUR
	gobbler					GDK_GOBBLER
	gumby					GDK_GUMBY
	hand1					GDK_HAND1
	hand2					GDK_HAND2
	heart					GDK_HEART
	icon					GDK_ICON
	iron-cross				GDK_IRON_CROSS
	left-ptr				GDK_LEFT_PTR
	left-side				GDK_LEFT_SIDE
	left-tee				GDK_LEFT_TEE
	leftbutton				GDK_LEFTBUTTON
	ll-angle				GDK_LL_ANGLE
	lr-angle				GDK_LR_ANGLE
	man					GDK_MAN
	middlebutton				GDK_MIDDLEBUTTON
	mouse					GDK_MOUSE
	pencil					GDK_PENCIL
	pirate					GDK_PIRATE
	plus					GDK_PLUS
	question-arrow				GDK_QUESTION_ARROW
	right-ptr				GDK_RIGHT_PTR
	right-side				GDK_RIGHT_SIDE
	right-tee				GDK_RIGHT_TEE
	rightbutton				GDK_RIGHTBUTTON
	rtl-logo				GDK_RTL_LOGO
	sailboat				GDK_SAILBOAT
	sb-down-arrow				GDK_SB_DOWN_ARROW
	sb-h-double-arrow			GDK_SB_H_DOUBLE_ARROW
	sb-left-arrow				GDK_SB_LEFT_ARROW
	sb-right-arrow				GDK_SB_RIGHT_ARROW
	sb-up-arrow				GDK_SB_UP_ARROW
	sb-v-double-arrow			GDK_SB_V_DOUBLE_ARROW
	shuttle					GDK_SHUTTLE
	sizing					GDK_SIZING
	spider					GDK_SPIDER
	spraycan				GDK_SPRAYCAN
	star					GDK_STAR
	target					GDK_TARGET
	tcross					GDK_TCROSS
	top-left-arrow				GDK_TOP_LEFT_ARROW
	top-left-corner				GDK_TOP_LEFT_CORNER
	top-right-corner			GDK_TOP_RIGHT_CORNER
	top-side				GDK_TOP_SIDE
	top-tee					GDK_TOP_TEE
	trek					GDK_TREK
	ul-angle				GDK_UL_ANGLE
	umbrella				GDK_UMBRELLA
	ur-angle				GDK_UR_ANGLE
	watch					GDK_WATCH
	xterm					GDK_XTERM
	last-cursor				GDK_LAST_CURSOR
	# cursor-is-pixmap			GDK_CURSOR_IS_PIXMAP

CSS3 Cursors (http://www.w3.org/TR/css3-ui/#cursor0)

	auto 				The UA determines the cursor to display based on the current context. 
	default 			The platform-dependent default cursor. Often rendered as an arrow. 
	none 				No cursor is rendered for the element. 
	context-menu 			A context menu is available for the object under the cursor. Often rendered as an arrow with a small menu-like graphic next to it. 
	help 				Help is available for the object under the cursor. Often rendered as a question mark or a balloon. 
	pointer 			The cursor is a pointer that indicates a link. 
	progress 			A progress indicator. The program is performing some processing, but is different from 'wait' in that the user may still interact with the program. Often rendered as a spinning beach ball, or an arrow with a watch or hourglass. 
	wait 				Indicates that the program is busy and the user should wait. Often rendered as a watch or hourglass. 
	cell 				Indicates that a cell or set of cells may be selected. Often rendered as a thick plus-sign with a dot in the middle. 
	crosshair 			A simple crosshair (e.g., short line segments resembling a "+" sign). Often used to indicate a two dimensional bitmap selection mode. 
	text 				Indicates text that may be selected. Often rendered as a vertical I-beam. User agents may automatically display a horizontal I-beam/cursor (e.g. same as the 'vertical-text' keyword) for vertical text, or for that matter, any angle of I-beam/cursor for text that is rendered at any particular angle. 
	vertical-text 			Indicates vertical-text that may be selected. Often rendered as a horizontal I-beam. 
	alias 				Indicates an alias of/shortcut to something is to be created. Often rendered as an arrow with a small curved arrow next to it. 
	copy 				Indicates something is to be copied. Often rendered as an arrow with a small plus sign next to it. 
	move 				Indicates something is to be moved. 
	no-drop 			Indicates that the dragged item cannot be dropped at the current cursor location. Often rendered as a hand or pointer with a small circle with a line through it. 
	not-allowed 			Indicates that the requested action will not be carried out. Often rendered as a circle with a line through it. 
	e-resize
	n-resize
	ne-resize
	nw-resize
	s-resize
	se-resize
	sw-resize,
	w-resize  			Indicates that some edge is to be moved. For example, the 'se-resize' cursor is used when the movement starts from the south-east corner of the box. 
	ew-resize
	ns-resize
	nesw-resize
	nwse-resize 	 		Indicates a bidirectional resize cursor. 
	col-resize 			Indicates that the item/column can be resized horizontally. Often rendered as arrows pointing left and right with a vertical bar separating them. 
	row-resize 			Indicates that the item/row can be resized vertically. Often rendered as arrows pointing up and down with a horizontal bar separating them. 
	all-scroll 			Indicates that the something can be scrolled in any direction. Often rendered as arrows pointing up, down, left, and right with a dot in the middle.