G3_Begin

# G3*_Begin

## C Specification

      #include <nitro/gx/g3imm.h>
      #include <nitro/gx/g3b.h>
      #include <nitro/gx/g3c.h>

      void G3_Begin(GXBegin primitive);

      // Below are APIs for creating the display list (command list)
      void G3B_Begin(GXDLInfo* info, GXBegin primitive);
      void G3C_Begin(GXDLInfo* info, GXBegin primitive);
      void G3BS_Begin(GXDLInfo* info, GXBegin primitive);
      void G3CS_Begin(GXDLInfo* info, GXBegin primitive);

## Arguments

info | Command List Information
primitive | Primitive type

## Return Values

None.

## Description

This function declares the start of the vertex list. `primitive` specifies the primitive type created by the vertex list.

`GX_BEGIN_TRIANGLES` | Multiple triangle polygons
`GX_BEGIN_QUADS` | Multiple quadrilateral polygons
`GX_BEGIN_TRIANGLE_STRIP` | Triangle strip polygon
`GX_BEGIN_QUAD_STRIP` | Quadrilateral strip polygon

The following indicates the type definition for `GXBegin` types.

    typedef enum
    {
        GX_BEGIN_TRIANGLES = 0,
        GX_BEGIN_QUADS = 1,
        GX_BEGIN_TRIANGLE_STRIP = 2,
        GX_BEGIN_QUAD_STRIP = 3
    }
    GXBegin;

## See Also

G3*_End

## Revision History

01/19/2004 Initial version