Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
masked_blit(3)			 Allegro manual 		  masked_blit(3)

NAME
     masked_blit - Copies a rectangle skipping pixels with the mask color. Alle-
     gro game programming library.

SYNOPSIS
     #include <allegro.h>

     void  masked_blit(BITMAP *source, BITMAP *dest, int source_x, int source_y,
     int dest_x, int dest_y, int width, int height);

DESCRIPTION
     Like blit(), but skips transparent pixels, which are marked by  a	zero  in
     256-color	modes  or  bright pink for truecolor data (maximum red and blue,
     zero green), and requires the source and destination bitmaps to be  of  the
     same color depth. The source and destination regions must not overlap.  Ex-
     ample:

	BITMAP *hud_overlay;
	...
	/* Paint hud overlay on the screen. */
	masked_blit(hud_overlay, screen, 0, 0, 0, 0,
		    hud_overlay->w, hud_overlay->h);

     If the GFX_HW_VRAM_BLIT_MASKED bit in the gfx_capabilities flag is set, the
     current  driver supports hardware accelerated masked blits from one part of
     the screen onto another. This is extremely fast, so when this flag  is  set
     it  may  be  worth  storing some of your more frequently used sprites in an
     offscreen portion of the video memory.

     Warning: if the hardware acceleration flag is not set,  masked_blit()  will
     not  work correctly when used with a source image in system or video memory
     so the latter must be a memory bitmap.

SEE ALSO
     blit(3),  masked_stretch_blit(3),	 draw_sprite(3),   bitmap_mask_color(3),
     ex12bit(3), expat(3)

Allegro 			  version 4.4.3 		  masked_blit(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=masked_blit&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help