Main Page | Data Structures | File List | Data Fields | Globals

render.h File Reference

Main header file for the KISS Renderer. More...

#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <malloc.h>
#include <sps2lib.h>
#include <sps2tags.h>
#include <sps2util.h>
#include <sps2regstructs.h>
#include <geommath/geommath.h>
#include <intmd/intmdloader.h>
#include <samples/common/p2lassert.h>
#include "render_buffer.h"
#include "render_dma.h"
#include "render_load.h"
#include "render_matrix.h"
#include "render_vif.h"
#include "render_util.h"

Go to the source code of this file.

Data Structures

struct  bufferinfo
 Information about a buffer. More...

union  qw_t
 A union to allow easy access to the fields of a uint128. More...


Defines

#define BLOCK_SIZE   4096
 Maximum size (in bytes) of a DMA block.

#define DATABUFFER_SIZE   (8192 * 1024)
 Size (in bytes) of the global data buffer.

#define CHAINBUFFER_SIZE   4096
 Size (in bytes) of the global DMA chain buffer.

#define VERTS_PER_PACKET   84
 Maximum number of vertices per VIF packet.

#define Render_SetBGColour(x)   DPUT_GS_BGCOLOR(x)
 A macro to remap SPS2's set background colour function.


Detailed Description

Main header file for the KISS Renderer.

This is the only header file you need to #include to use the renderer in your code.


Define Documentation

#define BLOCK_SIZE   4096
 

Maximum size (in bytes) of a DMA block.

This value should be equal to the size of the DMA blocks provided by SPS2. Data to be transferred via DMA must be located in a physically contiguous block. The current version of SPS2 provides 4K blocks of contiguous memory.

#define CHAINBUFFER_SIZE   4096
 

Size (in bytes) of the global DMA chain buffer.

The global DMA chain buffer contains per-frame DMA chain mode tags. It is double buffered for rendering. Increase this value if you receive a no block available error when rendering a large number of models in a single frame.

#define DATABUFFER_SIZE   (8192 * 1024)
 

Size (in bytes) of the global data buffer.

The global data buffer contains static data (data that does not change on a per-frame basis). This buffer must be large enough to hold geometry and texture data for the model(s) to be rendered. Increase this value if you receive a no block available error when loading large models.

#define Render_SetBGColour  )     DPUT_GS_BGCOLOR(x)
 

A macro to remap SPS2's set background colour function.

Parameters:
x An integer in the format 0xRRGGBB.

#define VERTS_PER_PACKET   84
 

Maximum number of vertices per VIF packet.

The maximum number of vertices uploaded to VU memory for processing in one batch.

Warning:
Do not increase this value - it has been chosen to upload the maximum number of vertices without overrunning the VU input buffer.


Generated on Wed Apr 28 20:49:12 2004 for KISS Renderer by doxygen 1.3.6-20040222