.TH "SDL_CreateCursor" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" .SH "NAME"SDL_CreateCursor\- Creates a new mouse cursor\&..SH "SYNOPSIS".PP\fB#include "SDL\&.h".sp\fBSDL_Cursor *\fBSDL_CreateCursor\fP\fR(\fBUint8 *data, Uint8 *mask, int w, int h, int hot_x, int hot_y\fR);.SH "DESCRIPTION".PPCreate a cursor using the specified \fBdata\fR and \fBmask\fR (in MSB format)\&. The cursor width must be a multiple of 8 bits\&..PPThe cursor is created in black and white according to the following: .TP 20\fBData / Mask\fR\fBResulting pixel on screen\fR.TP 200 / 1White.TP 201 / 1Black.TP 200 / 0Transparent.TP 201 / 0Inverted color if possible, black if not\&..PPCursors created with this function must be freed with \fISDL_FreeCursor\fR\&..SH "EXAMPLE".PP.nf\f(CW/* 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);}\fR.fi.PP.SH "SEE ALSO".PP\fI\fBSDL_FreeCursor\fP\fR, \fI\fBSDL_SetCursor\fP\fR, \fI\fBSDL_ShowCursor\fP\fR...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01