Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
scene_polygon3d(3)		 Allegro manual 	      scene_polygon3d(3)

NAME
     scene_polygon3d,  scene_polygon3d_f - Puts a polygon in the scene rendering
     list. Allegro game programming library.

SYNOPSIS
     #include <allegro.h>

     int scene_polygon3d(int type, BITMAP *texture, int vc, V3D *vtx[]);

     int scene_polygon3d_f(int type, BITMAP *texture, int vc, V3D_f *vtx[]);

DESCRIPTION
     Puts a polygon in the rendering list. Nothing is really  rendered	at  this
     moment. Should be called between clear_scene() and render_scene().

     Arguments	are  the  same as for polygon3d(), except the bitmap is missing.
     The one passed to clear_scene() will be used.

     Unlike polygon3d(),  the  polygon	may  be  concave  or  self-intersecting.
     Shapes that penetrate one another may look OK, but they are not really han-
     dled by this code.

     Note  that the texture is stored as a pointer only, and you should keep the
     actual bitmap around until render_scene(), where it is used.

     Since the FLAT style is implemented with the  low-level  hline()  function,
     the  FLAT	style is subject to DRAW_MODEs. All these modes are valid. Along
     with the polygon, this mode will be stored for the  rendering  moment,  and
     also  all	the other related variables (color_map pointer, pattern pointer,
     anchor, blender values).

     The settings of the CPU_MMX and CPU_3DNOW	flags  of  the	cpu_capabilities
     global variable on entry in this routine affect the choice of low-level asm
     routine that will be used by render_scene() for this polygon.

RETURN VALUE
     Returns  zero  on success, or a negative number if it won't be rendered for
     lack of a rendering routine.

SEE ALSO
     create_scene(3), clear_scene(3), render_scene(3),	destroy_scene(3),  poly-
     gon3d(3), cpu_capabilities(3), exscn3d(3)

Allegro 			  version 4.4.3 	      scene_polygon3d(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=scene_polygon3d_f&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help