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
|
.TH al_use_transform 3 "" "Allegro reference manual"
.SH NAME
.PP
al_use_transform \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro.h>
void\ al_use_transform(const\ ALLEGRO_TRANSFORM\ *trans)
\f[]
.fi
.SH DESCRIPTION
.PP
Sets the transformation to be used for the the drawing operations on the
target bitmap (each bitmap maintains its own transformation).
Every drawing operation after this call will be transformed using this
transformation.
Call this function with an identity transformation to return to the
default behaviour.
.PP
This function does nothing if there is no target bitmap.
.PP
The parameter is passed by reference as an optimization to avoid the
overhead of stack copying.
The reference will not be stored in the Allegro library so it is safe to
pass references to local variables.
.IP
.nf
\f[C]
void\ setup_my_transformation(void)
{
\ \ \ ALLEGRO_TRANSFORM\ transform;
\ \ \ al_translate_transform(&transform,\ 5,\ 10);
\ \ \ al_use_transform(&transform);
}
\f[]
.fi
.PP
\f[I]Parameters:\f[]
.IP \[bu] 2
trans \- Transformation to use
.SH SEE ALSO
.PP
al_get_current_transform(3), al_transform_coordinates(3)
|
