Merge Debian packaging for release “0.9-1”.
[debian_comixcursors.git] / CURSORNAMES.md
blob329dda8ce27688035179f3646e0d86081061b748
1 The cursors are named according to the current freedesktop.org cursor
2 conventions specification (draft):
4     <http://www.freedesktop.org/Standards/cursor-spec>
6 Other cursors are provided as symlinks by name or hash.
9     X-cursor           The X window system logo.
10     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.
11     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.
12     up-arrow           Up pointing arrow cursor. This cursor is typically used to identify an insertion point.
13     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.
14     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.
15     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.
16     crosshair          Crosshair cursor. Typically used for precision drawing or manipulation of an area.
17     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.
18     progress           Default cursor + busy cursor. Indicates a pending activity which may asynchronously affect the interface but which is not blocking commands from the user.
19     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.
20     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.
21     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.
22     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.
23     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.
24     cell               The thick plus sign cursor that's typically used in spread-sheet applications to select cells.
25     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.
26     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.
27     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.
28     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.
29     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.
30     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.
31     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.
32     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.
33     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.
34     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.
35     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.
36     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.
37     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.
38     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.
39     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.
40     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.
42 This is the current xorg naming convention (CursorName.c, cursor.bdf):
44     x_cursor           XC_X_cursor
45     arrow              XC_arrow
46     based_arrow_down   XC_based_arrow_down
47     based_arrow_up     XC_based_arrow_up
48     boat               XC_boat
49     bogosity           XC_bogosity
50     bottom_left_corner XC_bottom_left_corner
51     bottom_right_corner XC_bottom_right_corner
52     bottom_side        XC_bottom_side
53     bottom_tee         XC_bottom_tee
54     box_spiral         XC_box_spiral
55     center_ptr         XC_center_ptr
56     circle             XC_circle
57     clock              XC_clock
58     coffee_mug         XC_coffee_mug
59     cross              XC_cross
60     cross_reverse      XC_cross_reverse
61     crosshair          XC_crosshair
62     diamond_cross      XC_diamond_cross
63     dot                XC_dot
64     dotbox             XC_dotbox
65     double_arrow       XC_double_arrow
66     draft_large        XC_draft_large
67     draft_small        XC_draft_small
68     draped_box         XC_draped_box
69     exchange           XC_exchange
70     fleur              XC_fleur
71     gobbler            XC_gobbler
72     gumby              XC_gumby
73     hand1              XC_hand1
74     hand2              XC_hand2
75     heart              XC_heart
76     icon               XC_icon
77     iron_cross         XC_iron_cross
78     left_ptr           XC_left_ptr
79     left_side          XC_left_side
80     left_tee           XC_left_tee
81     leftbutton         XC_leftbutton
82     ll_angle           XC_ll_angle
83     lr_angle           XC_lr_angle
84     man                XC_man
85     middlebutton       XC_middlebutton
86     mouse              XC_mouse
87     pencil             XC_pencil
88     pirate             XC_pirate
89     plus               XC_plus
90     question_arrow     XC_question_arrow
91     right_ptr          XC_right_ptr
92     right_side         XC_right_side
93     right_tee          XC_right_tee
94     rightbutton        XC_rightbutton
95     rtl_logo           XC_rtl_logo
96     sailboat           XC_sailboat
97     sb_down_arrow      XC_sb_down_arrow
98     sb_h_double_arrow  XC_sb_h_double_arrow
99     sb_left_arrow      XC_sb_left_arrow
100     sb_right_arrow     XC_sb_right_arrow
101     sb_up_arrow        XC_sb_up_arrow
102     sb_v_double_arrow  XC_sb_v_double_arrow
103     shuttle            XC_shuttle
104     sizing             XC_sizing
105     spider             XC_spider
106     spraycan           XC_spraycan
107     star               XC_star
108     target             XC_target
109     tcross             XC_tcross
110     top_left_arrow     XC_top_left_arrow
111     top_left_corner    XC_top_left_corner
112     top_right_corner   XC_top_right_corner
113     top_side           XC_top_side
114     top_tee            XC_top_tee
115     trek               XC_trek
116     ul_angle           XC_ul_angle
117     umbrella           XC_umbrella
118     ur_angle           XC_ur_angle
119     watch              XC_watch
120     xterm              XC_xterm
122 This is the current (Qt4) cursor name scheme (qcursor.cpp, qcursor_x11.cpp):
124     Qt::ArrowCursor    left_ptr
125     Qt::UpArrowCursor  up_arrow
126     Qt::CrossCursor    cross
127     Qt::WaitCursor     wait
128     Qt::BusyCursor     left_ptr_watch
129     Qt::IBeamCursor    ibeam
130     Qt::SizeVerCursor  size_ver
131     Qt::SizeHorCursor  size_hor
132     Qt::SizeBDiagCursor size_bdiag
133     Qt::SizeFDiagCursor size_fdiag
134     Qt::SizeAllCursor  size_all
135     Qt::SplitVCursor   split_v
136     Qt::SplitHCursor   split_h
137     Qt::PointingHandCursor pointing_hand
138     Qt::ForbiddenCursor forbidden
139     Qt::WhatsThisCursor whats_this
141 My denominated map of QCursor to XCursor:
143     Qt::ArrowCursor    XC_left_ptr;
144     Qt::UpArrowCursor  XC_center_ptr;
145     Qt::CrossCursor    XC_crosshair;
146     Qt::WaitCursor     XC_watch;
147     Qt::IBeamCursor    XC_xterm;
148     Qt::SizeAllCursor  XC_fleur;
149     Qt::PointingHandCursor XC_hand2;
150     Qt::SizeBDiagCursor XC_top_right_corner;
151     Qt::SizeFDiagCursor XC_bottom_right_corner;
152     Qt::BlankCursor
153     Qt::SizeVerCursor  XC_sb_v_double_arrow;
154     Qt::SplitVCursor   XC_sb_v_double_arrow;
155     Qt::SizeHorCursor  XC_sb_h_double_arrow;
156     Qt::SplitHCursor   XC_sb_h_double_arrow;
157     Qt::WhatsThisCursor XC_question_arrow;
158     Qt::ForbiddenCursor XC_circle;
159     Qt::BusyCursor     XC_watch;
161 This is the current Gnome curser names (gdk_enums.def)
163     # x-cursor         GDK_X_CURSOR
164     arrow              GDK_ARROW
165     based-arrow-down   GDK_BASED_ARROW_DOWN
166     based-arrow-up     GDK_BASED_ARROW_UP
167     boat               GDK_BOAT
168     bogosity           GDK_BOGOSITY
169     bottom-left-corner GDK_BOTTOM_LEFT_CORNER
170     bottom-right-corner GDK_BOTTOM_RIGHT_CORNER
171     bottom-side        GDK_BOTTOM_SIDE
172     bottom-tee         GDK_BOTTOM_TEE
173     box-spiral         GDK_BOX_SPIRAL
174     center-ptr         GDK_CENTER_PTR
175     circle             GDK_CIRCLE
176     clock              GDK_CLOCK
177     coffee-mug         GDK_COFFEE_MUG
178     cross              GDK_CROSS
179     cross-reverse      GDK_CROSS_REVERSE
180     crosshair          GDK_CROSSHAIR
181     diamond-cross      GDK_DIAMOND_CROSS
182     dot                GDK_DO
183     dotbox             GDK_DOTBOX
184     double-arrow       GDK_DOUBLE_ARROW
185     draft-large        GDK_DRAFT_LARGE
186     draft-small        GDK_DRAFT_SMALL
187     draped-box         GDK_DRAPED_BOX
188     exchange           GDK_EXCHANGE
189     fleur              GDK_FLEUR
190     gobbler            GDK_GOBBLER
191     gumby              GDK_GUMBY
192     hand1              GDK_HAND1
193     hand2              GDK_HAND2
194     heart              GDK_HEART
195     icon               GDK_ICON
196     iron-cross         GDK_IRON_CROSS
197     left-ptr           GDK_LEFT_PTR
198     left-side          GDK_LEFT_SIDE
199     left-tee           GDK_LEFT_TEE
200     leftbutton         GDK_LEFTBUTTON
201     ll-angle           GDK_LL_ANGLE
202     lr-angle           GDK_LR_ANGLE
203     man                GDK_MAN
204     middlebutton       GDK_MIDDLEBUTTON
205     mouse              GDK_MOUSE
206     pencil             GDK_PENCIL
207     pirate             GDK_PIRATE
208     plus               GDK_PLUS
209     question-arrow     GDK_QUESTION_ARROW
210     right-ptr          GDK_RIGHT_PTR
211     right-side         GDK_RIGHT_SIDE
212     right-tee          GDK_RIGHT_TEE
213     rightbutton        GDK_RIGHTBUTTON
214     rtl-logo           GDK_RTL_LOGO
215     sailboat           GDK_SAILBOAT
216     sb-down-arrow      GDK_SB_DOWN_ARROW
217     sb-h-double-arrow  GDK_SB_H_DOUBLE_ARROW
218     sb-left-arrow      GDK_SB_LEFT_ARROW
219     sb-right-arrow     GDK_SB_RIGHT_ARROW
220     sb-up-arrow        GDK_SB_UP_ARROW
221     sb-v-double-arrow  GDK_SB_V_DOUBLE_ARROW
222     shuttle            GDK_SHUTTLE
223     sizing             GDK_SIZING
224     spider             GDK_SPIDER
225     spraycan           GDK_SPRAYCAN
226     star               GDK_STAR
227     target             GDK_TARGET
228     tcross             GDK_TCROSS
229     top-left-arrow     GDK_TOP_LEFT_ARROW
230     top-left-corner    GDK_TOP_LEFT_CORNER
231     top-right-corner   GDK_TOP_RIGHT_CORNER
232     top-side           GDK_TOP_SIDE
233     top-tee            GDK_TOP_TEE
234     trek               GDK_TREK
235     ul-angle           GDK_UL_ANGLE
236     umbrella           GDK_UMBRELLA
237     ur-angle           GDK_UR_ANGLE
238     watch              GDK_WATCH
239     xterm              GDK_XTERM
240     last-cursor        GDK_LAST_CURSOR
241     # cursor-is-pixmap GDK_CURSOR_IS_PIXMAP
243 CSS3 Cursors (http://www.w3.org/TR/css3-ui/#cursor0)
245     auto               The UA determines the cursor to display based on the current context.
246     default            The platform-dependent default cursor. Often rendered as an arrow.
247     none               No cursor is rendered for the element.
248     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.
249     help               Help is available for the object under the cursor. Often rendered as a question mark or a balloon.
250     pointer            The cursor is a pointer that indicates a link.
251     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.
252     wait               Indicates that the program is busy and the user should wait. Often rendered as a watch or hourglass.
253     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.
254     crosshair          A simple crosshair (e.g., short line segments resembling a "+" sign). Often used to indicate a two dimensional bitmap selection mode.
255     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.
256     vertical-text      Indicates vertical-text that may be selected. Often rendered as a horizontal I-beam.
257     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.
258     copy               Indicates something is to be copied. Often rendered as an arrow with a small plus sign next to it.
259     move               Indicates something is to be moved.
260     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.
261     not-allowed        Indicates that the requested action will not be carried out. Often rendered as a circle with a line through it.
262     e-resize
263     n-resize
264     ne-resize
265     nw-resize
266     s-resize
267     se-resize
268     sw-resize,
269     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.
270     ew-resize
271     ns-resize
272     nesw-resize
273     nwse-resize        Indicates a bidirectional resize cursor.
274     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.
275     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.
276     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.