Linux Certif

Toute la documentation sur la certification Linux LPI

SDL_CreateCursor

NAME

SDL_CreateCursor - Creates a new mouse cursor.

SYNOPSIS

#include "SDL.h"

SDL_Cursor *SDL_CreateCursor(Uint8 *data, Uint8 *mask, int w, int h, int hot_x, int hot_y);

DESCRIPTION

Create a cursor using the specified data and mask (in MSB format). The cursor width must be a multiple of 8 bits.

The cursor is created in black and white according to the following:

Data / Mask

Resulting pixel on screen

0 / 1

White

1 / 1

Black

0 / 0

Transparent

1 / 0

Inverted color if possible, black if not.

Cursors created with this function must be freed with SDL_FreeCursor.

EXAMPLE

 /* Stolen from the mailing list */
 /* Creates a new mouse cursor from an XPM */
 
 
 /* XPM */
 static const char *arrow[] = {
   /* width height num_colors chars_per_pixel */
   "    32    32        3            1",
   /* colors */
   "X c #000000",
   ". c #ffffff",
   "  c None",
   /* pixels */
   "X                               ",
   "XX                              ",
   "X.X                             ",
   "X..X                            ",
   "X...X                           ",
   "X....X                          ",
   "X.....X                         ",
   "X......X                        ",
   "X.......X                       ",
   "X........X                      ",
   "X.....XXXXX                     ",
   "X..X..X                         ",
   "X.X X..X                        ",
   "XX  X..X                        ",
   "X    X..X                       ",
   "     X..X                       ",
   "      X..X                      ",
   "      X..X                      ",
   "       XX                       ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "                                ",
   "0,0"
 };
 
 static SDL_Cursor *init_system_cursor(const char *image[])
 {
   int i, row, col;
   Uint8 data[4*32];
   Uint8 mask[4*32];
   int hot_x, hot_y;
 
   i = -1;
   for ( row=0; row<32; ++row ) {
     for ( col=0; col<32; ++col ) {
       if ( col % 8 ) {
         data[i] <<= 1;
         mask[i] <<= 1;
       } else {
         ++i;
         data[i] = mask[i] = 0;
       }
       switch (image[4+row][col]) {
         case 'X':
           data[i] |= 0x01;
           k[i] |= 0x01;
           break;
         case '.':
           mask[i] |= 0x01;
           break;
         case ' ':
           break;
       }
     }
   }
   sscanf(image[4+row], "%d,%d", &hot_x, &hot_y);
   return SDL_CreateCursor(data, mask, 32, 32, hot_x, hot_y);
 }
 

SEE ALSO

SDL_FreeCursor, SDL_SetCursor, SDL_ShowCursor