GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DRAW_TRANS_SPRITE (3)

NAME

draw_trans_sprite - Draws a sprite blending it with the destination. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

#include <allegro.h>

void draw_trans_sprite(BITMAP *bmp, BITMAP *sprite, int x, int y);

DESCRIPTION

Uses the global color_map table or truecolor blender functions to overlay the sprite on top of the existing image. This must only be used after you have set up the color mapping table (for 256-color modes) or blender functions (for truecolor modes). Because it involves reading as well as writing the bitmap memory, translucent drawing is very slow if you draw directly to video RAM, so wherever possible you should use a memory bitmap instead. Example:

   /* Some one time initialisation code. */
   COLOR_MAP global_trans_table;
   create_trans_table(&global_trans_table, my_palette,
                      128, 128, 128, NULL);
   ...
   if (get_color_depth() == 8)
      color_map = &global_trans_table;
   else
      set_trans_blender(128, 128, 128, 128);
  
   draw_trans_sprite(buffer, ghost_sprite, x, y);

The bitmap and sprite must normally be in the same color depth, but as a special case you can draw 32 bit RGBA format sprites onto any hicolor or truecolor bitmap, as long as you call set_alpha_blender() first, and you can draw 8-bit alpha images onto a 32-bit RGBA destination, as long as you call set_write_alpha_blender() first. As draw_sprite() this function skips transparent pixels, except if the source sprite is an 8-bit image; if this is the case, you should pay attention to properly set up your color map table for index 0.

SEE ALSO

draw_sprite(3), draw_lit_sprite(3), draw_trans_rle_sprite(3), color_map(3), set_trans_blender(3), set_alpha_blender(3), set_write_alpha_blender(3), bitmap_mask_color(3), exalpha(3), exblend(3), exlights(3), exrotscl(3), extrans(3), exxfade(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro DRAW_TRANS_SPRITE (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.