Debian Codegraph @

README

raw
1 The original Comix Cursors sources README
2 #########################################
3
4 The official ComixCursors releases can be found on opendesktop.org:
5 <http://opendesktop.org/content/show.php/ComixCursors?content=32627>
6
7 COPYRIGHT
8 =========
9
10 Refer to the ‘COPYING’ file for copyright statement and grant of
11 license.
12
13
14 INSTALLATION
15 ============
16
17 Refer to the ‘INSTALL’ file for requirements and detailed instructions
18 to build and install.
19
20
21 KNOWN ISSUES
22 ============
23
24 * nVIDIA graphics cards:
25
26 If you experience the cursor shadow looking strange, e.g. with the i
27 christmas theme, or the whole cursor appear gray when it's supposed to be
28 white, disable hardware cursor rendering.
29
30 In the xorg.conf file in the device section insert the HWCursor line
31 below::
32
33 Section "Device"
34 Driver "nvidia"
35 ...
36 Option "HWCursor" "off"
37 EndSection
38
39 * If you are using KDE version prior to 4.0 you might experience that
40 KDE's control center Mouse Theme Installation does not support symlinks
41 in the packed archives (tar). Consider updating KDE.
42
43 * Gnome supports multiple cursor sizes in one cursor theme, but only
44 distinct sizes: 16, 24, 32, and 48 pixels.
45
46 There is no known Gnome 3 application for setting the size of the mouse
47 cursor. You need to set the desired size in pixels as the value of the
48 DConf setting ‘org.gnome.desktop.interface.cursor-size’. You can use
49 ‘dconf-editor’ (from the ‘dconf-tools’ package) or ‘gsettings’ to change
50 DConf settings.
51
52 * If you are missing some cursors issue "# export XCURSOR_DISCOVER=1"
53 and re-start the application to find the corresponding cursor hash.
54 Report it to us or link it yourself in the ~/.icons directory.
55
56
57 NAMING CURSORS
58 ==============
59
60 The cursors are named according to the current freedesktop.org cursor
61 conventions specification (draft):
62
63 <http://www.freedesktop.org/Standards/cursor-spec>
64
65 Other cursors are provided as symlinks by name or hash.
66
67
68 X-cursor The X window system logo.
69 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.
70 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.
71 up-arrow Up pointing arrow cursor. This cursor is typically used to identify an insertion point.
72 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.
73 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.
74 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.
75 crosshair Crosshair cursor. Typically used for precision drawing or manipulation of an area.
76 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.
77 progress Default cursor + busy cursor. Indicates a pending activity which may asynchronously affect the interface but which is not blocking commands from the user.
78 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.
79 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.
80 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.
81 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.
82 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.
83 cell The thick plus sign cursor that's typically used in spread-sheet applications to select cells.
84 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.
85 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.
86 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.
87 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.
88 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.
89 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.
90 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.
91 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.
92 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.
93 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.
94 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.
95 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.
96 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.
97 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.
98 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.
99 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.
100
101 This is the current xorg naming convention (CursorName.c, cursor.bdf):
102
103 x_cursor XC_X_cursor
104 arrow XC_arrow
105 based_arrow_down XC_based_arrow_down
106 based_arrow_up XC_based_arrow_up
107 boat XC_boat
108 bogosity XC_bogosity
109 bottom_left_corner XC_bottom_left_corner
110 bottom_right_corner XC_bottom_right_corner
111 bottom_side XC_bottom_side
112 bottom_tee XC_bottom_tee
113 box_spiral XC_box_spiral
114 center_ptr XC_center_ptr
115 circle XC_circle
116 clock XC_clock
117 coffee_mug XC_coffee_mug
118 cross XC_cross
119 cross_reverse XC_cross_reverse
120 crosshair XC_crosshair
121 diamond_cross XC_diamond_cross
122 dot XC_dot
123 dotbox XC_dotbox
124 double_arrow XC_double_arrow
125 draft_large XC_draft_large
126 draft_small XC_draft_small
127 draped_box XC_draped_box
128 exchange XC_exchange
129 fleur XC_fleur
130 gobbler XC_gobbler
131 gumby XC_gumby
132 hand1 XC_hand1
133 hand2 XC_hand2
134 heart XC_heart
135 icon XC_icon
136 iron_cross XC_iron_cross
137 left_ptr XC_left_ptr
138 left_side XC_left_side
139 left_tee XC_left_tee
140 leftbutton XC_leftbutton
141 ll_angle XC_ll_angle
142 lr_angle XC_lr_angle
143 man XC_man
144 middlebutton XC_middlebutton
145 mouse XC_mouse
146 pencil XC_pencil
147 pirate XC_pirate
148 plus XC_plus
149 question_arrow XC_question_arrow
150 right_ptr XC_right_ptr
151 right_side XC_right_side
152 right_tee XC_right_tee
153 rightbutton XC_rightbutton
154 rtl_logo XC_rtl_logo
155 sailboat XC_sailboat
156 sb_down_arrow XC_sb_down_arrow
157 sb_h_double_arrow XC_sb_h_double_arrow
158 sb_left_arrow XC_sb_left_arrow
159 sb_right_arrow XC_sb_right_arrow
160 sb_up_arrow XC_sb_up_arrow
161 sb_v_double_arrow XC_sb_v_double_arrow
162 shuttle XC_shuttle
163 sizing XC_sizing
164 spider XC_spider
165 spraycan XC_spraycan
166 star XC_star
167 target XC_target
168 tcross XC_tcross
169 top_left_arrow XC_top_left_arrow
170 top_left_corner XC_top_left_corner
171 top_right_corner XC_top_right_corner
172 top_side XC_top_side
173 top_tee XC_top_tee
174 trek XC_trek
175 ul_angle XC_ul_angle
176 umbrella XC_umbrella
177 ur_angle XC_ur_angle
178 watch XC_watch
179 xterm XC_xterm
180
181 This is the current (Qt4) cursor name scheme (qcursor.cpp, qcursor_x11.cpp):
182
183 Qt::ArrowCursor left_ptr
184 Qt::UpArrowCursor up_arrow
185 Qt::CrossCursor cross
186 Qt::WaitCursor wait
187 Qt::BusyCursor left_ptr_watch
188 Qt::IBeamCursor ibeam
189 Qt::SizeVerCursor size_ver
190 Qt::SizeHorCursor size_hor
191 Qt::SizeBDiagCursor size_bdiag
192 Qt::SizeFDiagCursor size_fdiag
193 Qt::SizeAllCursor size_all
194 Qt::SplitVCursor split_v
195 Qt::SplitHCursor split_h
196 Qt::PointingHandCursor pointing_hand
197 Qt::ForbiddenCursor forbidden
198 Qt::WhatsThisCursor whats_this
199
200 My denominated map of QCursor to XCursor:
201
202 Qt::ArrowCursor XC_left_ptr;
203 Qt::UpArrowCursor XC_center_ptr;
204 Qt::CrossCursor XC_crosshair;
205 Qt::WaitCursor XC_watch;
206 Qt::IBeamCursor XC_xterm;
207 Qt::SizeAllCursor XC_fleur;
208 Qt::PointingHandCursor XC_hand2;
209 Qt::SizeBDiagCursor XC_top_right_corner;
210 Qt::SizeFDiagCursor XC_bottom_right_corner;
211 Qt::BlankCursor
212 Qt::SizeVerCursor XC_sb_v_double_arrow;
213 Qt::SplitVCursor XC_sb_v_double_arrow;
214 Qt::SizeHorCursor XC_sb_h_double_arrow;
215 Qt::SplitHCursor XC_sb_h_double_arrow;
216 Qt::WhatsThisCursor XC_question_arrow;
217 Qt::ForbiddenCursor XC_circle;
218 Qt::BusyCursor XC_watch;
219
220 This is the current Gnome curser names (gdk_enums.def)
221
222 # x-cursor GDK_X_CURSOR
223 arrow GDK_ARROW
224 based-arrow-down GDK_BASED_ARROW_DOWN
225 based-arrow-up GDK_BASED_ARROW_UP
226 boat GDK_BOAT
227 bogosity GDK_BOGOSITY
228 bottom-left-corner GDK_BOTTOM_LEFT_CORNER
229 bottom-right-corner GDK_BOTTOM_RIGHT_CORNER
230 bottom-side GDK_BOTTOM_SIDE
231 bottom-tee GDK_BOTTOM_TEE
232 box-spiral GDK_BOX_SPIRAL
233 center-ptr GDK_CENTER_PTR
234 circle GDK_CIRCLE
235 clock GDK_CLOCK
236 coffee-mug GDK_COFFEE_MUG
237 cross GDK_CROSS
238 cross-reverse GDK_CROSS_REVERSE
239 crosshair GDK_CROSSHAIR
240 diamond-cross GDK_DIAMOND_CROSS
241 dot GDK_DO
242 dotbox GDK_DOTBOX
243 double-arrow GDK_DOUBLE_ARROW
244 draft-large GDK_DRAFT_LARGE
245 draft-small GDK_DRAFT_SMALL
246 draped-box GDK_DRAPED_BOX
247 exchange GDK_EXCHANGE
248 fleur GDK_FLEUR
249 gobbler GDK_GOBBLER
250 gumby GDK_GUMBY
251 hand1 GDK_HAND1
252 hand2 GDK_HAND2
253 heart GDK_HEART
254 icon GDK_ICON
255 iron-cross GDK_IRON_CROSS
256 left-ptr GDK_LEFT_PTR
257 left-side GDK_LEFT_SIDE
258 left-tee GDK_LEFT_TEE
259 leftbutton GDK_LEFTBUTTON
260 ll-angle GDK_LL_ANGLE
261 lr-angle GDK_LR_ANGLE
262 man GDK_MAN
263 middlebutton GDK_MIDDLEBUTTON
264 mouse GDK_MOUSE
265 pencil GDK_PENCIL
266 pirate GDK_PIRATE
267 plus GDK_PLUS
268 question-arrow GDK_QUESTION_ARROW
269 right-ptr GDK_RIGHT_PTR
270 right-side GDK_RIGHT_SIDE
271 right-tee GDK_RIGHT_TEE
272 rightbutton GDK_RIGHTBUTTON
273 rtl-logo GDK_RTL_LOGO
274 sailboat GDK_SAILBOAT
275 sb-down-arrow GDK_SB_DOWN_ARROW
276 sb-h-double-arrow GDK_SB_H_DOUBLE_ARROW
277 sb-left-arrow GDK_SB_LEFT_ARROW
278 sb-right-arrow GDK_SB_RIGHT_ARROW
279 sb-up-arrow GDK_SB_UP_ARROW
280 sb-v-double-arrow GDK_SB_V_DOUBLE_ARROW
281 shuttle GDK_SHUTTLE
282 sizing GDK_SIZING
283 spider GDK_SPIDER
284 spraycan GDK_SPRAYCAN
285 star GDK_STAR
286 target GDK_TARGET
287 tcross GDK_TCROSS
288 top-left-arrow GDK_TOP_LEFT_ARROW
289 top-left-corner GDK_TOP_LEFT_CORNER
290 top-right-corner GDK_TOP_RIGHT_CORNER
291 top-side GDK_TOP_SIDE
292 top-tee GDK_TOP_TEE
293 trek GDK_TREK
294 ul-angle GDK_UL_ANGLE
295 umbrella GDK_UMBRELLA
296 ur-angle GDK_UR_ANGLE
297 watch GDK_WATCH
298 xterm GDK_XTERM
299 last-cursor GDK_LAST_CURSOR
300 # cursor-is-pixmap GDK_CURSOR_IS_PIXMAP
301
302 CSS3 Cursors (http://www.w3.org/TR/css3-ui/#cursor0)
303
304 auto The UA determines the cursor to display based on the current context.
305 default The platform-dependent default cursor. Often rendered as an arrow.
306 none No cursor is rendered for the element.
307 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.
308 help Help is available for the object under the cursor. Often rendered as a question mark or a balloon.
309 pointer The cursor is a pointer that indicates a link.
310 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.
311 wait Indicates that the program is busy and the user should wait. Often rendered as a watch or hourglass.
312 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.
313 crosshair A simple crosshair (e.g., short line segments resembling a "+" sign). Often used to indicate a two dimensional bitmap selection mode.
314 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.
315 vertical-text Indicates vertical-text that may be selected. Often rendered as a horizontal I-beam.
316 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.
317 copy Indicates something is to be copied. Often rendered as an arrow with a small plus sign next to it.
318 move Indicates something is to be moved.
319 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.
320 not-allowed Indicates that the requested action will not be carried out. Often rendered as a circle with a line through it.
321 e-resize
322 n-resize
323 ne-resize
324 nw-resize
325 s-resize
326 se-resize
327 sw-resize,
328 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.
329 ew-resize
330 ns-resize
331 nesw-resize
332 nwse-resize Indicates a bidirectional resize cursor.
333 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.
334 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.
335 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.
336
337
338 ..
339 Local variables:
340 coding: utf-8
341 mode: text
342 mode: rst
343 End:
344 vim: fileencoding=utf-8 filetype=rst :