plucky (3) scene_polygon3d.3alleg4.gz

Provided by: allegro4-doc_4.4.3.1-5_all bug

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 handled 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(3alleg4),     clear_scene(3alleg4),      render_scene(3alleg4),      destroy_scene(3alleg4),
       polygon3d(3alleg4), cpu_capabilities(3alleg4), exscn3d(3alleg4)