1scene_polygon3d(3)              Allegro manual              scene_polygon3d(3)
2
3
4

NAME

6       scene_polygon3d,  scene_polygon3d_f  - Puts a polygon in the scene ren‐
7       dering list. Allegro game programming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       int scene_polygon3d(int type, BITMAP *texture, int vc, V3D *vtx[]);
14
15       int scene_polygon3d_f(int type, BITMAP *texture, int vc, V3D_f *vtx[]);
16

DESCRIPTION

18       Puts a polygon in the rendering list. Nothing  is  really  rendered  at
19       this moment. Should be called between clear_scene() and render_scene().
20
21       Arguments  are  the same as for polygon3d(), except the bitmap is miss‐
22       ing.  The one passed to clear_scene() will be used.
23
24       Unlike polygon3d(), the polygon may be  concave  or  self-intersecting.
25       Shapes  that penetrate one another may look OK, but they are not really
26       handled by this code.
27
28       Note that the texture is stored as a pointer only, and you should  keep
29       the actual bitmap around until render_scene(), where it is used.
30
31       Since  the  FLAT  style is implemented with the low-level hline() func‐
32       tion, the FLAT style is subject to  DRAW_MODEs.  All  these  modes  are
33       valid. Along with the polygon, this mode will be stored for the render‐
34       ing moment,  and  also  all  the  other  related  variables  (color_map
35       pointer, pattern pointer, anchor, blender values).
36
37       The settings of the CPU_MMX and CPU_3DNOW flags of the cpu_capabilities
38       global variable on entry in this routine affect the choice of low-level
39       asm routine that will be used by render_scene() for this polygon.
40

RETURN VALUE

42       Returns  zero  on success, or a negative number if it won't be rendered
43       for lack of a rendering routine.
44
45

SEE ALSO

47       create_scene(3),  clear_scene(3),  render_scene(3),   destroy_scene(3),
48       polygon3d(3), cpu_capabilities(3), exscn3d(3)
49
50
51
52Allegro                          version 4.2.3              scene_polygon3d(3)
Impressum