Allegro Version 4.9.2 (SVN) | Function Index When the user receives a resize event from a resizable display, if they wish the display to be resized they must call this function to let the graphics driver know that it can now resize the display. Returns whether or not a bitmap is already locked. Clear a complete display, but confined by the clipping rectangle. Clone a bitmap “exactly”, formats can be different. Convert the given mask color to an alpha channel in the bitmap. Creates a new bitmap using the bitmap format and flags for the current thread. Create a display, or window, with the specified dimensions. Create a new, empty event queue, returning a pointer to object if successful. Create a mouse cursor from the bitmap provided. Creates a sub-bitmap of the parent, at the specified coordinates and of the specified size. Return the number of seconds since the Allegro library was initialised. Destroys the given bitmap, freeing all resources used by it. Destroy a display. Destroy the event queue specified. Free the memory used by the given cursor. Draws an unscaled, unrotated bitmap at the given position to the current target bitmap (see al_set_target_bitmap). Draws a region of the given bitmap to the target bitmap. Draws a line to the current target. Draws a single pixel at x, y. Draws a rectangle to the current target. Draws a rotated version of the given bitmap to the target bitmap. Like al_draw_rotated_bitmap, but can also scale the bitmap. Draws a scaled version of the given bitmap to the target bitmap. Drop the next event packet from the queue. Return true if the event queue specified is currently empty. Copies or updates the front and back buffers so that what has been drawn previously on the currently selected display becomes visible on screen. Drops all events, if any, from the queue. Return a special bitmap representing the back-buffer of the current display. Return the flags user to create the bitmap. Returns the pixel format of a bitmap. Returns the height of a bitmap in pixels. Returns the width of a bitmap in pixels. Returns the active blender for the current thread. Gets the clipping rectangle of the target bitmap. Query for the current display in the calling thread. Gets the flags of the current display. Gets the pixel format of the current display. Gets the height of the current display. Retrieves a display mode. Gets the refresh rate of the current display. Gets the width of the current display. Return a special bitmap representing the front-buffer of the current display. Get a handle for joystick number NUM on the system. Return the name of the given axis. Return the name of the given button. Return the name of the given joystick. Get the current joystick state. Return the flags of the given “stick”. Return the name of the given “stick”. Return a pointer to an object representing the keyboard, that can be used as an event source. Save the state of the keyboard specified at the time the function is called into the structure pointed to by RET_STATE. Return a pointer to an object representing the mouse, that can be used as an event source. Return the number of buttons on the mouse. Return the number of buttons on the mouse. Save the state of the mouse specified at the time the function is called into the structure pointed to by RET_STATE. Returns the flags used for newly created bitmaps. Returns the format used for newly created bitmaps. Gets the current flags used for newly created displays. Gets the current pixel format used for newly created displays. Gets the current refresh rate used for newly created displays. Take the next event packet out of the event queue specified, and copy the contents into RET_EVENT, returning true. Get the number of available fullscreen display modes for the current set of display parameters. Return the number of axes on the given “stick”. Return the number of buttons on the joystick. Return the number of “sticks” on the given joystick. Returns the list of OpenGL extensions supported by Allegro, for the current display. Helper to get the address of an OpenGL symbol Get a pixel’s color value from the specified bitmap. Extract the mouse axis value from the saved state. Return the target bitmap of the current display. Return the timer’s counter value. Return the timer’s speed, in seconds. Hide the mouse cursor in the current display of the calling thread. Install a joystick driver, returning true if successful. Install a keyboard driver. Install a mouse driver. Install a new timer. D3D and OpenGL allow sharing a texture in a way so it can be used for multiple windows. Returns true if al_install_mouse was called successfully. This function is a helper to determine whether an OpenGL extension is available on the current display or not. Return true if the key specified was held down in the state specified. Converts the given keycode to a description of the key. Load a bitmap from a file using the bitmap format and flags of the current thread. Lock an entire bitmap for reading or writing. Like al_lock_bitmap, but only locks a specific area of the bitmap. Convert r, g, b (ranging from 0-255) into an ALLEGRO_COLOR, using 255 for alpha. Convert r, g, b, (ranging from 0.0f-1.0f) into an ALLEGRO_COLOR, using 1.0f for alpha. Convert r, g, b, a (ranging from 0-255) into an ALLEGRO_COLOR. Convert r, g, b, a (ranging from 0.0f-1.0f) into an ALLEGRO_COLOR. Return true if the mouse button specified was held down in the state specified. Return the number of joysticks on the system (depending on the OS this may not be accurate). Returns the OpenGL version number of the client (the computer the program is running on), for the current DISPLAY. Copy the contents of the next event packet in the event queue specified into RET_EVENT and return true. Draw a single pixel on the target bitmap. Register the event source with the event queue specified. Release a previously ‘gotten’ joystick object. Resize the current display. Waits for the specified number seconds. Sets the function to use for blending for the current thread. Set the region of the target bitmap or display that pixels get clipped to. Change the current display for the calling thread. Changes the icon associated with the current display (window). Overrides the state of the keyboard LED indicators. Customise the memory management functions used by the library. Set the given mouse axis to the given value. Set the given mouse cursor to be the current mouse cursor. Sets the area of the screen within which the mouse can move. Set the mouse wheel position to the given value. Try to position the mouse at the given coordinates. Set the mouse wheel position to the given value. Sets the flags to use for newly created bitmaps. Sets the pixel format for newly created bitmaps. Sets various flags for display creation. Set the pixel format for al displays created after this call. Sets the refresh rate to use for newly created displays. Set the given system mouse cursor to be the current mouse cursor. Select the bitmap to which all subsequent drawing operations in the calling thread will draw. Change a timer’s counter value. Set the timer’s speed, i.e. Make a mouse cursor visible in the current display of the calling thread. Start the timer specified. Stop the timer specified. Return true if the timer specified is currently started. Uninstalls the active joystick driver. Uninstalls the active keyboard driver, if any. Uninstalls the active mouse driver, if any. Uninstall the timer specified. Unlock a previously locked bitmap or bitmap region. Retrieves components of an ALLEGRO_COLOR, ignoring alpha Components will range from 0-255. Retrieves components of an ALLEGRO_COLOR, ignoring alpha. Retrieves components of an ALLEGRO_COLOR. Retrieves components of an ALLEGRO_COLOR. Unregister an event source with an event queue. Update the the front buffer from the backbuffer in the specified region. Wait until the event queue specified is non-empty. Wait until the event queue specified is non-empty. Wait for the beginning of a vertical retrace. |