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

FreeBSD Manual Pages

  
 
  

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

NAME
     clip3d_f  - Clips the polygon given in vtx using floating point math, Alle-
     gro game programming library.

SYNOPSIS
     #include <allegro.h>

     int clip3d_f(int type, float  min_z,  float  max_z,  int  vc,  const  V3D_f
     *vtx[], V3D_f *vout[], V3D_f *vtmp[], int out[]);

DESCRIPTION
     Clips  the  polygon given in `vtx'. The number of vertices is `vc', the re-
     sult goes in `vout', and `vtmp' and `out' are needed for internal purposes.
     The pointers in `vtx', `vout' and `vtmp' must point to valid  V3D_f  struc-
     tures.

     As  additional  vertices may appear in the process of clipping, so the size
     of `vout', `vtmp' and `out' should be at least vc * (1.5 ^ n), where `n' is
     the number of clipping planes (5 or 6), and `^' denotes "to the power of".

     The frustum (viewing volume) is defined by -z<x<z, -z<y<z, 0<min_z<z<max_z.
     If  max_z<=min_z, the z<max_z clipping is not done. As you can  see,  clip-
     ping is done in the camera space, with perspective in mind, so this routine
     should be called after you apply the camera matrix, but before the perspec-
     tive  projection. The routine will correctly interpolate u, v, and c in the
     vertex structure. However, no provision is made for high/truecolor GCOL.

RETURN VALUE
     Returns the number of vertices after clipping is done.

SEE ALSO
     polygon3d(3), clip3d(3), excamera(3), exscn3d(3)

Allegro 			  version 4.4.3 		     clip3d_f(3)

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

home | help