Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

set_clip_rect(3alleg4) [opendarwin man page]

set_clip_rect(3alleg4)						  Allegro manual					    set_clip_rect(3alleg4)

set_clip_rect - Sets the clipping rectangle of a bitmap. Allegro game programming library. SYNOPSIS
#include <allegro.h> void set_clip_rect(BITMAP *bitmap, int x1, int y1, int x2, int y2); DESCRIPTION
Each bitmap has an associated clipping rectangle, which is the area of the image that it is OK to draw onto. Nothing will be drawn to posi- tions outside this space. This function sets the clipping rectangle for the specified bitmap. Pass the coordinates of the top-left and bot- tom-right corners of the clipping rectangle in this order; these are both inclusive, i.e. set_clip_rect(bitmap, 16, 16, 32, 32) will allow drawing to (16, 16) and (32, 32), but not to (15, 15) and (33, 33). Drawing operations will be performed (at least partially) on the bitmap as long as the first coordinates of its clipping rectangle are not greater than the second coordinates and its intersection with the actual image is non-empty. If either condition is not fulfilled, drawing will be turned off for the bitmap, e.g. set_clip_rect(bmp, 0, 0, -1, -1); /* disable drawing on bmp */ Note that passing "out-of-bitmap" coordinates is allowed, but they are likely to be altered (and so the coordinates returned by get_clip_rect() will be different). However, such modifications are guaranteed to preserve the external effect of the clipping rectangle, that is not to modify the actual area of the image that it is OK to draw onto. SEE ALSO
get_clip_rect(3alleg4), add_clip_rect(3alleg4), set_clip_state(3alleg4), get_clip_state(3alleg4), ex12bit(3alleg4), excamera(3alleg4) Allegro version 4.4.2 set_clip_rect(3alleg4)

Check Out this Related Man Page

draw_sprite(3alleg4)						  Allegro manual					      draw_sprite(3alleg4)

draw_sprite - Draws a copy of the sprite onto the destination bitmap. Allegro game programming library. SYNOPSIS
#include <allegro.h> void draw_sprite(BITMAP *bmp, BITMAP *sprite, int x, int y); DESCRIPTION
Draws a copy of the sprite bitmap onto the destination bitmap at the specified position. This is almost the same as blit(sprite, bmp, 0, 0, x, y, sprite->w, sprite->h), but it uses a masked drawing mode where transparent pixels are skipped, so the background image will show through the masked parts of the sprite. Transparent pixels are marked by a zero in 256-color modes or bright pink for truecolor data (maxi- mum red and blue, zero green). Example: BITMAP *spaceship; ... draw_sprite(screen, spaceship, x, y); If the GFX_HW_VRAM_BLIT_MASKED bit in the gfx_capabilities flag is set, the current driver supports hardware accelerated sprite drawing when the source image is a video memory bitmap or a sub-bitmap of the screen. 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, draw_sprite() will not work correctly when used with a sprite image in system or video memory so the latter must be a memory bitmap. Although generally not supporting graphics of mixed color depths, as a special case this function can be used to draw 256-color source images onto truecolor destination bitmaps, so you can use palette effects on specific sprites within a truecolor program. SEE ALSO
draw_sprite_v_flip(3alleg4), draw_trans_sprite(3alleg4), draw_lit_sprite(3alleg4), draw_gouraud_sprite(3alleg4), stretch_sprite(3alleg4), rotate_sprite(3alleg4), draw_character_ex(3alleg4), draw_rle_sprite(3alleg4), draw_compiled_sprite(3alleg4), masked_blit(3alleg4), blit(3alleg4), bitmap_mask_color(3alleg4), exsprite(3alleg4) Allegro version 4.4.2 draw_sprite(3alleg4)
Man Page