Search
lxdream.org :: lxdream/src/pvr2/scene.h
lxdream 0.9.1
released Jun 29
Download Now
filename src/pvr2/scene.h
changeset 1066:ddffe9d2b332
prev878:c498ba66e851
prev645:a7392098299c
next1133:f3da7d810d5c
author nkeynes
date Sun Jul 05 13:53:48 2009 +1000 (13 years ago)
permissions -rw-r--r--
last change No-op merge lxdream-render to remove head (actually long since merged)
file annotate diff log raw
nkeynes@635
     1
/**
nkeynes@636
     2
 * $Id$
nkeynes@635
     3
 *
nkeynes@736
     4
 * PVR2 scene description structure (pvr2-private)
nkeynes@635
     5
 *
nkeynes@635
     6
 * Copyright (c) 2005 Nathan Keynes.
nkeynes@635
     7
 *
nkeynes@635
     8
 * This program is free software; you can redistribute it and/or modify
nkeynes@635
     9
 * it under the terms of the GNU General Public License as published by
nkeynes@635
    10
 * the Free Software Foundation; either version 2 of the License, or
nkeynes@635
    11
 * (at your option) any later version.
nkeynes@635
    12
 *
nkeynes@635
    13
 * This program is distributed in the hope that it will be useful,
nkeynes@635
    14
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
nkeynes@635
    15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
nkeynes@635
    16
 * GNU General Public License for more details.
nkeynes@635
    17
 */
nkeynes@635
    18
nkeynes@736
    19
#ifndef lxdream_scene_H
nkeynes@736
    20
#define lxdream_scene_H 1
nkeynes@736
    21
nkeynes@736
    22
#ifdef __cplusplus
nkeynes@736
    23
extern "C" {
nkeynes@736
    24
#endif
nkeynes@635
    25
nkeynes@635
    26
/************************* Intermediate vertex buffer ************************/
nkeynes@635
    27
nkeynes@635
    28
typedef enum { 
nkeynes@635
    29
    SORT_NEVER = 0, 
nkeynes@645
    30
    SORT_TILEFLAG = 1, /* In this mode, sorting is controlled by the per-segment flag */
nkeynes@635
    31
    SORT_ALWAYS = 2 
nkeynes@635
    32
} tile_sort_mode_t;
nkeynes@635
    33
nkeynes@863
    34
typedef enum { SHADOW_NONE=0, SHADOW_CHEAP=1, SHADOW_FULL=2 } shadow_mode_t;
nkeynes@863
    35
nkeynes@863
    36
nkeynes@635
    37
struct vertex_struct {
nkeynes@635
    38
    float u,v;
nkeynes@639
    39
    float x,y,z;
nkeynes@687
    40
    float rgba[4];
nkeynes@687
    41
    float offset_rgba[4];
nkeynes@635
    42
};
nkeynes@635
    43
nkeynes@635
    44
struct polygon_struct {
nkeynes@635
    45
    uint32_t *context;
nkeynes@635
    46
    uint32_t vertex_count; // number of vertexes in polygon
nkeynes@645
    47
    uint32_t tex_id;
nkeynes@635
    48
    int32_t vertex_index; // index of first vertex in vertex buffer
nkeynes@645
    49
    uint32_t mod_tex_id;
nkeynes@635
    50
    int32_t mod_vertex_index; // index of first modified vertex in vertex buffer
nkeynes@635
    51
    struct polygon_struct *next; // chain for tri/quad arrays
nkeynes@635
    52
};
nkeynes@635
    53
nkeynes@635
    54
void pvr2_scene_init(void);
nkeynes@635
    55
void pvr2_scene_read(void);
nkeynes@635
    56
void pvr2_scene_shutdown();
nkeynes@635
    57
nkeynes@669
    58
uint32_t pvr2_scene_buffer_width();
nkeynes@669
    59
uint32_t pvr2_scene_buffer_height();
nkeynes@669
    60
nkeynes@669
    61
extern unsigned char *video_base;
nkeynes@635
    62
nkeynes@635
    63
/**
nkeynes@635
    64
 * Maximum possible size of the vertex buffer. This is figured as follows:
nkeynes@635
    65
 * PVR2 polygon buffer is limited to 4MB. The tightest polygon format 
nkeynes@635
    66
 * is 3 vertexes in 48 bytes = 16 bytes/vertex, (shadow triangle) 
nkeynes@635
    67
 * (the next tightest is 8 vertex in 140 bytes (6-strip colour-only)).
nkeynes@635
    68
 * giving a theoretical maximum of 262144 vertexes.
nkeynes@635
    69
 * The expanded structure is 44 bytes/vertex, giving 
nkeynes@635
    70
 * 11534336 bytes...
nkeynes@635
    71
 */
nkeynes@635
    72
#define MAX_VERTEXES 262144
nkeynes@635
    73
#define MAX_VERTEX_BUFFER_SIZE (MAX_VERTEXES*sizeof(struct vertex_struct))
nkeynes@635
    74
nkeynes@635
    75
/**
nkeynes@635
    76
 * Maximum polygons - smallest is 1 polygon in 48 bytes, giving
nkeynes@687
    77
 * 87381, plus 1 for the background
nkeynes@635
    78
 * 
nkeynes@635
    79
 */
nkeynes@635
    80
#define MAX_POLYGONS 87382
nkeynes@635
    81
#define MAX_POLY_BUFFER_SIZE (MAX_POLYGONS*sizeof(struct polygon_struct))
nkeynes@635
    82
#define BUF_POLY_MAP_SIZE (4 MB)
nkeynes@635
    83
nkeynes@635
    84
/*************************************************************************/
nkeynes@635
    85
nkeynes@635
    86
/* Scene data - this structure holds all the intermediate data used during
nkeynes@635
    87
 * the rendering process. 
nkeynes@635
    88
 *
nkeynes@635
    89
 * Special note: if vbo_supported == FALSE, then vertex_array points to a
nkeynes@635
    90
 * malloced chunk of system RAM. Otherwise, vertex_array will be either NULL
nkeynes@635
    91
 * (if the VBO is unmapped), or a pointer into a chunk of GL managed RAM
nkeynes@635
    92
 * (possibly direct-mapped VRAM).
nkeynes@635
    93
 */
nkeynes@635
    94
struct pvr2_scene_struct {
nkeynes@635
    95
    /** GL ID of the VBO used by the scene (or 0 if VBOs are not in use). */
nkeynes@635
    96
    GLuint vbo_id;
nkeynes@635
    97
    /** Pointer to the vertex array data, or NULL for unmapped VBOs */
nkeynes@635
    98
    struct vertex_struct *vertex_array;
nkeynes@635
    99
    /** Current allocated size (in bytes) of the vertex array */
nkeynes@635
   100
    uint32_t vertex_array_size;
nkeynes@635
   101
    /** Total number of vertexes in the scene (note modified vertexes
nkeynes@635
   102
     * count for 2 vertexes */
nkeynes@635
   103
    uint32_t vertex_count;
nkeynes@635
   104
nkeynes@635
   105
    /** Pointer to the polygon data for the scene (main ram). 
nkeynes@635
   106
     * This will always have room for at least MAX_POLYGONS */
nkeynes@635
   107
    struct polygon_struct *poly_array;
nkeynes@687
   108
    /** Pointer to the background polygon. This is always a quad, and
nkeynes@687
   109
     * normally the last member of poly_array */
nkeynes@687
   110
    struct polygon_struct *bkgnd_poly;
nkeynes@635
   111
    /** Total number of polygons in the scene */
nkeynes@635
   112
    uint32_t poly_count;
nkeynes@635
   113
nkeynes@635
   114
    /** Image bounds in 3D - x1,x2,y1,y2,z1,z2 
nkeynes@635
   115
     * x and y values are determined by the clip planes, while z values are
nkeynes@635
   116
     * determined from the vertex data itself.
nkeynes@635
   117
     */
nkeynes@635
   118
    float bounds[6];
nkeynes@635
   119
nkeynes@635
   120
    /* Total size of the image buffer, determined by the tile map used to
nkeynes@635
   121
     * render the scene */
nkeynes@635
   122
    uint32_t buffer_width, buffer_height;
nkeynes@635
   123
nkeynes@635
   124
    /** Specifies the translucency auto-sort mode for the scene */
nkeynes@635
   125
    tile_sort_mode_t sort_mode;
nkeynes@863
   126
    
nkeynes@863
   127
    shadow_mode_t shadow_mode;
nkeynes@635
   128
nkeynes@847
   129
    float fog_lut_colour[4];
nkeynes@847
   130
    float fog_vert_colour[4];
nkeynes@847
   131
    
nkeynes@635
   132
    /** Pointer to the start of the tile segment list in PVR2 VRAM (32-bit) */
nkeynes@635
   133
    struct tile_segment *segment_list;
nkeynes@639
   134
    /** Map from PVR2 polygon address to an element of poly_array. */
nkeynes@635
   135
    struct polygon_struct **buf_to_poly_map;
nkeynes@635
   136
    /** Pointer to the start of the raw polygon buffer in PVR2 VRAM (32-bit).
nkeynes@635
   137
     * Also only used during parsing */
nkeynes@635
   138
    uint32_t *pvr2_pbuf;
nkeynes@635
   139
    /** Current vertex index during parsing */
nkeynes@635
   140
    uint32_t vertex_index;
nkeynes@635
   141
};
nkeynes@635
   142
nkeynes@635
   143
/**
nkeynes@635
   144
 * Current scene structure. Note this should only be written to by vertex bufer
nkeynes@635
   145
 * functions
nkeynes@635
   146
 */
nkeynes@635
   147
extern struct pvr2_scene_struct pvr2_scene;
nkeynes@635
   148
nkeynes@736
   149
#ifdef __cplusplus
nkeynes@736
   150
}
nkeynes@736
   151
#endif
nkeynes@635
   152
nkeynes@736
   153
#endif /* !lxdream_scene_H */
.