File: al_draw_rotated_bitmap.3

package info (click to toggle)
allegro5 2%3A5.2.2-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 23,032 kB
  • sloc: ansic: 120,340; cpp: 15,707; objc: 4,805; python: 2,915; java: 2,195; sh: 887; xml: 86; makefile: 49; perl: 37; pascal: 24
file content (54 lines) | stat: -rw-r--r-- 1,448 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
.TH "al_draw_rotated_bitmap" "3" "" "Allegro reference manual" ""
.SH NAME
.PP
al_draw_rotated_bitmap \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro.h>

void\ al_draw_rotated_bitmap(ALLEGRO_BITMAP\ *bitmap,
\ \ \ float\ cx,\ float\ cy,\ float\ dx,\ float\ dy,\ float\ angle,\ int\ flags)
\f[]
.fi
.SH DESCRIPTION
.PP
Draws a rotated version of the given bitmap to the target bitmap.
The bitmap is rotated by \[aq]angle\[aq] radians clockwise.
.PP
The point at cx/cy relative to the upper left corner of the bitmap will
be drawn at dx/dy and the bitmap is rotated around this point.
If cx,cy is 0,0 the bitmap will rotate around its upper left corner.
.IP \[bu] 2
cx \- center x (relative to the bitmap)
.IP \[bu] 2
cy \- center y (relative to the bitmap)
.IP \[bu] 2
dx \- destination x
.IP \[bu] 2
dy \- destination y
.IP \[bu] 2
angle \- angle by which to rotate (radians)
.IP \[bu] 2
flags \- same as for al_draw_bitmap(3)
.PP
Example
.IP
.nf
\f[C]
float\ w\ =\ al_get_bitmap_width(bitmap);
float\ h\ =\ al_get_bitmap_height(bitmap);
al_draw_rotated_bitmap(bitmap,\ w\ /\ 2,\ h\ /\ 2,\ x,\ y,\ ALLEGRO_PI\ /\ 2,\ 0);
\f[]
.fi
.PP
The above code draws the bitmap centered on x/y and rotates it 90°
clockwise.
.PP
See al_draw_bitmap(3) for a note on restrictions on which bitmaps can be
drawn where.
.SH SEE ALSO
.PP
al_draw_bitmap(3), al_draw_bitmap_region(3), al_draw_scaled_bitmap(3),
al_draw_scaled_rotated_bitmap(3)