masked_stretch_blit(3alleg4) [centos man page]

masked_stretch_blit(3alleg4)					  Allegro manual				      masked_stretch_blit(3alleg4)

NAME

       masked_stretch_blit - Scales a rectangular area skipping pixels with the mask color. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void masked_stretch_blit(BITMAP *source, BITMAP *dest, int source_x, source_y, source_w, source_h, int dest_x, dest_y, dest_w, dest_h);

DESCRIPTION

       Like  masked_blit(),  except  it  can  scale images (so the source and destination rectangles don't need to be the same size). This routine
       doesn't do as much safety checking as the regular masked_blit(): in particular you must take care not to copy from areas outside the source
       bitmap. Moreover, the source must be a memory bitmap. Example:

	  BITMAP *hud_overlay;
	  ...
	  /* Stretch hud overlay over the screen. */
	  masked_stretch_blit(hud_overlay, screen, 0, 0,
			      hud_overlay->w, hud_overlay->h,
			      0, 0, SCREEN_W, SCREEN_H);

SEE ALSO

       blit(3alleg4), masked_blit(3alleg4), stretch_blit(3alleg4), stretch_sprite(3alleg4)

Allegro 							   version 4.4.2				      masked_stretch_blit(3alleg4)

masked_blit(3alleg4)						  Allegro manual					      masked_blit(3alleg4)

NAME

       masked_blit - Copies a rectangle skipping pixels with the mask color. Allegro 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.  Example:

	  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(3alleg4), masked_stretch_blit(3alleg4), draw_sprite(3alleg4), bitmap_mask_color(3alleg4), ex12bit(3alleg4), expat(3alleg4)

Allegro 							   version 4.4.2					      masked_blit(3alleg4)