dpsoftrast.h

   1
   2 #ifndef DPSOFTRAST_H
   3 #define DPSOFTRAST_H
   4
   5 #include <stdlib.h>
   6
   7 #define DPSOFTRAST_MAXMIPMAPS 16
   8 #define DPSOFTRAST_TEXTURE_MAXSIZE (1<<(DPSOFTRAST_MAXMIPMAPS - 1))
   9 #define DPSOFTRAST_MAXTEXTUREUNITS 16
  10 #define DPSOFTRAST_MAXTEXCOORDARRAYS 8
  11
  12 // type of pixels in texture (some of these are converted to BGRA8 on update)
  13 #define DPSOFTRAST_TEXTURE_FORMAT_BGRA8 0
  14 #define DPSOFTRAST_TEXTURE_FORMAT_DEPTH 1
  15 #define DPSOFTRAST_TEXTURE_FORMAT_RGBA8 2
  16 #define DPSOFTRAST_TEXTURE_FORMAT_ALPHA8 3
  17 #define DPSOFTRAST_TEXTURE_FORMAT_COMPAREMASK 3
  18
  19 // modifier flags for texture (can not be changed after creation)
  20 #define DPSOFTRAST_TEXTURE_FLAG_MIPMAP 4
  21 #define DPSOFTRAST_TEXTURE_FLAG_CUBEMAP 8
  22 #define DPSOFTRAST_TEXTURE_FLAG_USEALPHA 16
  23 #define DPSOFTRAST_TEXTURE_FLAG_CLAMPTOEDGE 32
  24
  25 typedef enum DPSOFTRAST_TEXTURE_FILTER_e
  26 {
  27         DPSOFTRAST_TEXTURE_FILTER_NEAREST = 0,
  28         DPSOFTRAST_TEXTURE_FILTER_LINEAR = 1,
  29         DPSOFTRAST_TEXTURE_FILTER_NEAREST_MIPMAP_TRIANGLE = 2,
  30         DPSOFTRAST_TEXTURE_FILTER_LINEAR_MIPMAP_TRIANGLE = 3,
  31 }
  32 DPSOFTRAST_TEXTURE_FILTER;
  33
  34 void DPSOFTRAST_Init(int width, int height, int numthreads, int interlace, unsigned int *colorpixels, unsigned int *depthpixels);
  35 void DPSOFTRAST_Shutdown(void);
  36 void DPSOFTRAST_Flush(void);
  37 void DPSOFTRAST_Finish(void);
  38
  39 int DPSOFTRAST_Texture_New(int flags, int width, int height, int depth);
  40 void DPSOFTRAST_Texture_Free(int index);
  41 void DPSOFTRAST_Texture_UpdatePartial(int index, int mip, const unsigned char *pixels, int blockx, int blocky, int blockwidth, int blockheight);
  42 void DPSOFTRAST_Texture_UpdateFull(int index, const unsigned char *pixels);
  43 int DPSOFTRAST_Texture_GetWidth(int index, int mip);
  44 int DPSOFTRAST_Texture_GetHeight(int index, int mip);
  45 int DPSOFTRAST_Texture_GetDepth(int index, int mip);
  46 unsigned char *DPSOFTRAST_Texture_GetPixelPointer(int index, int mip);
  47 void DPSOFTRAST_Texture_Filter(int index, DPSOFTRAST_TEXTURE_FILTER filter);
  48
  49 void DPSOFTRAST_SetRenderTargets(int width, int height, unsigned int *depthpixels, unsigned int *colorpixels0, unsigned int *colorpixels1, unsigned int *colorpixels2, unsigned int *colorpixels3);
  50 void DPSOFTRAST_Viewport(int x, int y, int width, int height);
  51 void DPSOFTRAST_ClearColor(float r, float g, float b, float a);
  52 void DPSOFTRAST_ClearDepth(float d);
  53 void DPSOFTRAST_ColorMask(int r, int g, int b, int a);
  54 void DPSOFTRAST_DepthTest(int enable);
  55 void DPSOFTRAST_ScissorTest(int enable);
  56 void DPSOFTRAST_Scissor(float x, float y, float width, float height);
  57
  58 void DPSOFTRAST_BlendFunc(int smodulate, int dmodulate);
  59 void DPSOFTRAST_BlendSubtract(int enable);
  60 void DPSOFTRAST_DepthMask(int enable);
  61 void DPSOFTRAST_DepthFunc(int comparemode);
  62 void DPSOFTRAST_DepthRange(float range0, float range1);
  63 void DPSOFTRAST_PolygonOffset(float alongnormal, float intoview);
  64 void DPSOFTRAST_CullFace(int mode);
  65 void DPSOFTRAST_AlphaTest(int enable);
  66 void DPSOFTRAST_AlphaFunc(int alphafunc, float alphavalue);
  67 void DPSOFTRAST_Color4f(float r, float g, float b, float a);
  68 void DPSOFTRAST_GetPixelsBGRA(int blockx, int blocky, int blockwidth, int blockheight, unsigned char *outpixels);
  69 void DPSOFTRAST_CopyRectangleToTexture(int index, int mip, int tx, int ty, int sx, int sy, int width, int height);
  70 void DPSOFTRAST_SetTexture(int unitnum, int index);
  71
  72 void DPSOFTRAST_SetVertexPointer(const float *vertex3f, size_t stride);
  73 void DPSOFTRAST_SetColorPointer(const float *color4f, size_t stride);
  74 void DPSOFTRAST_SetColorPointer4ub(const unsigned char *color4ub, size_t stride);
  75 void DPSOFTRAST_SetTexCoordPointer(int unitnum, int numcomponents, size_t stride, const float *texcoordf);
  76
  77 typedef enum gl20_texunit_e
  78 {
  79         // postprocess shaders, and generic shaders:
  80         GL20TU_FIRST = 0,
  81         GL20TU_SECOND = 1,
  82         GL20TU_GAMMARAMPS = 2,
  83         // standard material properties
  84         GL20TU_NORMAL = 0,
  85         GL20TU_COLOR = 1,
  86         GL20TU_GLOSS = 2,
  87         GL20TU_GLOW = 3,
  88         // material properties for a second material
  89         GL20TU_SECONDARY_NORMAL = 4,
  90         GL20TU_SECONDARY_COLOR = 5,
  91         GL20TU_SECONDARY_GLOSS = 6,
  92         GL20TU_SECONDARY_GLOW = 7,
  93         // material properties for a colormapped material
  94         // conflicts with secondary material
  95         GL20TU_PANTS = 4,
  96         GL20TU_SHIRT = 7,
  97         // fog fade in the distance
  98         GL20TU_FOGMASK = 8,
  99         // compiled ambient lightmap and deluxemap
 100         GL20TU_LIGHTMAP = 9,
 101         GL20TU_DELUXEMAP = 10,
 102         // refraction, used by water shaders
 103         GL20TU_REFRACTION = 3,
 104         // reflection, used by water shaders, also with normal material rendering
 105         // conflicts with secondary material
 106         GL20TU_REFLECTION = 7,
 107         // rtlight attenuation (distance fade) and cubemap filter (projection texturing)
 108         // conflicts with lightmap/deluxemap
 109         GL20TU_ATTENUATION = 9,
 110         GL20TU_CUBE = 10,
 111         GL20TU_SHADOWMAP2D = 15,
 112         GL20TU_CUBEPROJECTION = 12,
 113         // rtlight prepass data (screenspace depth and normalmap)
 114         GL20TU_SCREENDEPTH = 13,
 115         GL20TU_SCREENNORMALMAP = 14,
 116         // lightmap prepass data (screenspace diffuse and specular from lights)
 117         GL20TU_SCREENDIFFUSE = 11,
 118         GL20TU_SCREENSPECULAR = 12,
 119         // fake reflections
 120         GL20TU_REFLECTMASK = 5,
 121         GL20TU_REFLECTCUBE = 6,
 122         GL20TU_FOGHEIGHTTEXTURE = 14
 123 }
 124 gl20_texunit;
 125
 126 typedef enum gles2_attrib_e
 127 {
 128         GLES2ATTRIB_POSITION = 0,
 129         GLES2ATTRIB_COLOR = 1,
 130         GLES2ATTRIB_TEXCOORD0 = 2,
 131         GLES2ATTRIB_TEXCOORD1 = 3,
 132         GLES2ATTRIB_TEXCOORD2 = 4,
 133         GLES2ATTRIB_TEXCOORD3 = 5,
 134         GLES2ATTRIB_TEXCOORD4 = 6,
 135         GLES2ATTRIB_TEXCOORD5 = 7,
 136         GLES2ATTRIB_TEXCOORD6 = 8,
 137         GLES2ATTRIB_TEXCOORD7 = 9,
 138 }
 139 gles2_attrib;
 140
 141 // this enum selects which of the glslshadermodeinfo entries should be used
 142 typedef enum shadermode_e
 143 {
 144         SHADERMODE_GENERIC, ///< (particles/HUD/etc) vertex color, optionally multiplied by one texture
 145         SHADERMODE_POSTPROCESS, ///< postprocessing shader (r_glsl_postprocess)
 146         SHADERMODE_DEPTH_OR_SHADOW, ///< (depthfirst/shadows) vertex shader only
 147         SHADERMODE_FLATCOLOR, ///< (lightmap) modulate texture by uniform color (q1bsp, q3bsp)
 148         SHADERMODE_VERTEXCOLOR, ///< (lightmap) modulate texture by vertex colors (q3bsp)
 149         SHADERMODE_LIGHTMAP, ///< (lightmap) modulate texture by lightmap texture (q1bsp, q3bsp)
 150         SHADERMODE_FAKELIGHT, ///< (fakelight) modulate texture by "fake" lighting (no lightmaps, no nothing)
 151         SHADERMODE_LIGHTDIRECTIONMAP_MODELSPACE, ///< (lightmap) use directional pixel shading from texture containing modelspace light directions (q3bsp deluxemap)
 152         SHADERMODE_LIGHTDIRECTIONMAP_TANGENTSPACE, ///< (lightmap) use directional pixel shading from texture containing tangentspace light directions (q1bsp deluxemap)
 153         SHADERMODE_LIGHTDIRECTION, ///< (lightmap) use directional pixel shading from fixed light direction (q3bsp)
 154         SHADERMODE_LIGHTSOURCE, ///< (lightsource) use directional pixel shading from light source (rtlight)
 155         SHADERMODE_REFRACTION, ///< refract background (the material is rendered normally after this pass)
 156         SHADERMODE_WATER, ///< refract background and reflection (the material is rendered normally after this pass)
 157         SHADERMODE_SHOWDEPTH, ///< (debugging) renders depth as color
 158         SHADERMODE_DEFERREDGEOMETRY, ///< (deferred) render material properties to screenspace geometry buffers
 159         SHADERMODE_DEFERREDLIGHTSOURCE, ///< (deferred) use directional pixel shading from light source (rtlight) on screenspace geometry buffers
 160         SHADERMODE_COUNT
 161 }
 162 shadermode_t;
 163
 164 typedef enum shaderpermutation_e
 165 {
 166         SHADERPERMUTATION_DIFFUSE = 1<<0, ///< (lightsource) whether to use directional shading
 167         SHADERPERMUTATION_VERTEXTEXTUREBLEND = 1<<1, ///< indicates this is a two-layer material blend based on vertex alpha (q3bsp)
 168         SHADERPERMUTATION_VIEWTINT = 1<<2, ///< view tint (postprocessing only), use vertex colors (generic only)
 169         SHADERPERMUTATION_COLORMAPPING = 1<<3, ///< indicates this is a colormapped skin
 170         SHADERPERMUTATION_SATURATION = 1<<4, ///< saturation (postprocessing only)
 171         SHADERPERMUTATION_FOGINSIDE = 1<<5, ///< tint the color by fog color or black if using additive blend mode
 172         SHADERPERMUTATION_FOGOUTSIDE = 1<<6, ///< tint the color by fog color or black if using additive blend mode
 173         SHADERPERMUTATION_FOGHEIGHTTEXTURE = 1<<7, ///< fog color and density determined by texture mapped on vertical axis
 174         SHADERPERMUTATION_GAMMARAMPS = 1<<8, ///< gamma (postprocessing only)
 175         SHADERPERMUTATION_CUBEFILTER = 1<<9, ///< (lightsource) use cubemap light filter
 176         SHADERPERMUTATION_GLOW = 1<<10, ///< (lightmap) blend in an additive glow texture
 177         SHADERPERMUTATION_BLOOM = 1<<11, ///< bloom (postprocessing only)
 178         SHADERPERMUTATION_SPECULAR = 1<<12, ///< (lightsource or deluxemapping) render specular effects
 179         SHADERPERMUTATION_POSTPROCESSING = 1<<13, ///< user defined postprocessing (postprocessing only)
 180         SHADERPERMUTATION_REFLECTION = 1<<14, ///< normalmap-perturbed reflection of the scene infront of the surface, preformed as an overlay on the surface
 181         SHADERPERMUTATION_OFFSETMAPPING = 1<<15, ///< adjust texcoords to roughly simulate a displacement mapped surface
 182         SHADERPERMUTATION_OFFSETMAPPING_RELIEFMAPPING = 1<<16, ///< adjust texcoords to accurately simulate a displacement mapped surface (requires OFFSETMAPPING to also be set!)
 183         SHADERPERMUTATION_SHADOWMAP2D = 1<<17, ///< (lightsource) use shadowmap texture as light filter
 184         SHADERPERMUTATION_SHADOWMAPPCF = 1<<18, ///< (lightsource) use percentage closer filtering on shadowmap test results
 185         SHADERPERMUTATION_SHADOWMAPPCF2 = 1<<19, ///< (lightsource) use higher quality percentage closer filtering on shadowmap test results
 186         SHADERPERMUTATION_SHADOWSAMPLER = 1<<20, ///< (lightsource) use hardware shadowmap test
 187         SHADERPERMUTATION_SHADOWMAPVSDCT = 1<<21, ///< (lightsource) use virtual shadow depth cube texture for shadowmap indexing
 188         SHADERPERMUTATION_SHADOWMAPORTHO = 1<<22, //< (lightsource) use orthographic shadowmap projection
 189         SHADERPERMUTATION_DEFERREDLIGHTMAP = 1<<23, ///< (lightmap) read Texture_ScreenDiffuse/Specular textures and add them on top of lightmapping
 190         SHADERPERMUTATION_ALPHAKILL = 1<<24, ///< (deferredgeometry) discard pixel if diffuse texture alpha below 0.5
 191         SHADERPERMUTATION_REFLECTCUBE = 1<<25, ///< fake reflections using global cubemap (not HDRI light probe)
 192         SHADERPERMUTATION_NORMALMAPSCROLLBLEND = 1<<26, // (water) counter-direction normalmaps scrolling
 193         SHADERPERMUTATION_LIMIT = 1<<27, ///< size of permutations array
 194         SHADERPERMUTATION_COUNT = 27 ///< size of shaderpermutationinfo array
 195 }
 196 shaderpermutation_t;
 197
 198 typedef enum DPSOFTRAST_UNIFORM_e
 199 {
 200         DPSOFTRAST_UNIFORM_Texture_First,
 201         DPSOFTRAST_UNIFORM_Texture_Second,
 202         DPSOFTRAST_UNIFORM_Texture_GammaRamps,
 203         DPSOFTRAST_UNIFORM_Texture_Normal,
 204         DPSOFTRAST_UNIFORM_Texture_Color,
 205         DPSOFTRAST_UNIFORM_Texture_Gloss,
 206         DPSOFTRAST_UNIFORM_Texture_Glow,
 207         DPSOFTRAST_UNIFORM_Texture_SecondaryNormal,
 208         DPSOFTRAST_UNIFORM_Texture_SecondaryColor,
 209         DPSOFTRAST_UNIFORM_Texture_SecondaryGloss,
 210         DPSOFTRAST_UNIFORM_Texture_SecondaryGlow,
 211         DPSOFTRAST_UNIFORM_Texture_Pants,
 212         DPSOFTRAST_UNIFORM_Texture_Shirt,
 213         DPSOFTRAST_UNIFORM_Texture_FogHeightTexture,
 214         DPSOFTRAST_UNIFORM_Texture_FogMask,
 215         DPSOFTRAST_UNIFORM_Texture_Lightmap,
 216         DPSOFTRAST_UNIFORM_Texture_Deluxemap,
 217         DPSOFTRAST_UNIFORM_Texture_Attenuation,
 218         DPSOFTRAST_UNIFORM_Texture_Cube,
 219         DPSOFTRAST_UNIFORM_Texture_Refraction,
 220         DPSOFTRAST_UNIFORM_Texture_Reflection,
 221         DPSOFTRAST_UNIFORM_Texture_ShadowMap2D,
 222         DPSOFTRAST_UNIFORM_Texture_CubeProjection,
 223         DPSOFTRAST_UNIFORM_Texture_ScreenDepth,
 224         DPSOFTRAST_UNIFORM_Texture_ScreenNormalMap,
 225         DPSOFTRAST_UNIFORM_Texture_ScreenDiffuse,
 226         DPSOFTRAST_UNIFORM_Texture_ScreenSpecular,
 227         DPSOFTRAST_UNIFORM_Texture_ReflectMask,
 228         DPSOFTRAST_UNIFORM_Texture_ReflectCube,
 229         DPSOFTRAST_UNIFORM_Alpha,
 230         DPSOFTRAST_UNIFORM_BloomBlur_Parameters,
 231         DPSOFTRAST_UNIFORM_ClientTime,
 232         DPSOFTRAST_UNIFORM_Color_Ambient,
 233         DPSOFTRAST_UNIFORM_Color_Diffuse,
 234         DPSOFTRAST_UNIFORM_Color_Specular,
 235         DPSOFTRAST_UNIFORM_Color_Glow,
 236         DPSOFTRAST_UNIFORM_Color_Pants,
 237         DPSOFTRAST_UNIFORM_Color_Shirt,
 238         DPSOFTRAST_UNIFORM_DeferredColor_Ambient,
 239         DPSOFTRAST_UNIFORM_DeferredColor_Diffuse,
 240         DPSOFTRAST_UNIFORM_DeferredColor_Specular,
 241         DPSOFTRAST_UNIFORM_DeferredMod_Diffuse,
 242         DPSOFTRAST_UNIFORM_DeferredMod_Specular,
 243         DPSOFTRAST_UNIFORM_DistortScaleRefractReflect,
 244         DPSOFTRAST_UNIFORM_EyePosition,
 245         DPSOFTRAST_UNIFORM_FogColor,
 246         DPSOFTRAST_UNIFORM_FogHeightFade,
 247         DPSOFTRAST_UNIFORM_FogPlane,
 248         DPSOFTRAST_UNIFORM_FogPlaneViewDist,
 249         DPSOFTRAST_UNIFORM_FogRangeRecip,
 250         DPSOFTRAST_UNIFORM_LightColor,
 251         DPSOFTRAST_UNIFORM_LightDir,
 252         DPSOFTRAST_UNIFORM_LightPosition,
 253         DPSOFTRAST_UNIFORM_OffsetMapping_Scale,
 254         DPSOFTRAST_UNIFORM_PixelSize,
 255         DPSOFTRAST_UNIFORM_ReflectColor,
 256         DPSOFTRAST_UNIFORM_ReflectFactor,
 257         DPSOFTRAST_UNIFORM_ReflectOffset,
 258         DPSOFTRAST_UNIFORM_RefractColor,
 259         DPSOFTRAST_UNIFORM_Saturation,
 260         DPSOFTRAST_UNIFORM_ScreenCenterRefractReflect,
 261         DPSOFTRAST_UNIFORM_ScreenScaleRefractReflect,
 262         DPSOFTRAST_UNIFORM_ScreenToDepth,
 263         DPSOFTRAST_UNIFORM_ShadowMap_Parameters,
 264         DPSOFTRAST_UNIFORM_ShadowMap_TextureScale,
 265         DPSOFTRAST_UNIFORM_SpecularPower,
 266         DPSOFTRAST_UNIFORM_UserVec1,
 267         DPSOFTRAST_UNIFORM_UserVec2,
 268         DPSOFTRAST_UNIFORM_UserVec3,
 269         DPSOFTRAST_UNIFORM_UserVec4,
 270         DPSOFTRAST_UNIFORM_ViewTintColor,
 271         DPSOFTRAST_UNIFORM_ViewToLightM1,
 272         DPSOFTRAST_UNIFORM_ViewToLightM2,
 273         DPSOFTRAST_UNIFORM_ViewToLightM3,
 274         DPSOFTRAST_UNIFORM_ViewToLightM4,
 275         DPSOFTRAST_UNIFORM_ModelToLightM1,
 276         DPSOFTRAST_UNIFORM_ModelToLightM2,
 277         DPSOFTRAST_UNIFORM_ModelToLightM3,
 278         DPSOFTRAST_UNIFORM_ModelToLightM4,
 279         DPSOFTRAST_UNIFORM_TexMatrixM1,
 280         DPSOFTRAST_UNIFORM_TexMatrixM2,
 281         DPSOFTRAST_UNIFORM_TexMatrixM3,
 282         DPSOFTRAST_UNIFORM_TexMatrixM4,
 283         DPSOFTRAST_UNIFORM_BackgroundTexMatrixM1,
 284         DPSOFTRAST_UNIFORM_BackgroundTexMatrixM2,
 285         DPSOFTRAST_UNIFORM_BackgroundTexMatrixM3,
 286         DPSOFTRAST_UNIFORM_BackgroundTexMatrixM4,
 287         DPSOFTRAST_UNIFORM_ModelViewProjectionMatrixM1,
 288         DPSOFTRAST_UNIFORM_ModelViewProjectionMatrixM2,
 289         DPSOFTRAST_UNIFORM_ModelViewProjectionMatrixM3,
 290         DPSOFTRAST_UNIFORM_ModelViewProjectionMatrixM4,
 291         DPSOFTRAST_UNIFORM_ModelViewMatrixM1,
 292         DPSOFTRAST_UNIFORM_ModelViewMatrixM2,
 293         DPSOFTRAST_UNIFORM_ModelViewMatrixM3,
 294         DPSOFTRAST_UNIFORM_ModelViewMatrixM4,
 295         DPSOFTRAST_UNIFORM_PixelToScreenTexCoord,
 296         DPSOFTRAST_UNIFORM_ModelToReflectCubeM1,
 297         DPSOFTRAST_UNIFORM_ModelToReflectCubeM2,
 298         DPSOFTRAST_UNIFORM_ModelToReflectCubeM3,
 299         DPSOFTRAST_UNIFORM_ModelToReflectCubeM4,
 300         DPSOFTRAST_UNIFORM_ShadowMapMatrixM1,
 301         DPSOFTRAST_UNIFORM_ShadowMapMatrixM2,
 302         DPSOFTRAST_UNIFORM_ShadowMapMatrixM3,
 303         DPSOFTRAST_UNIFORM_ShadowMapMatrixM4,
 304         DPSOFTRAST_UNIFORM_BloomColorSubtract,
 305         DPSOFTRAST_UNIFORM_NormalmapScrollBlend,
 306         DPSOFTRAST_UNIFORM_TOTAL
 307 }
 308 DPSOFTRAST_UNIFORM;
 309
 310 void DPSOFTRAST_SetShader(int mode, int permutation);
 311 #define DPSOFTRAST_Uniform1f(index, v0) DPSOFTRAST_Uniform4f(index, v0, 0, 0, 0)
 312 #define DPSOFTRAST_Uniform2f(index, v0, v1) DPSOFTRAST_Uniform4f(index, v0, v1, 0, 0)
 313 #define DPSOFTRAST_Uniform3f(index, v0, v1, v2) DPSOFTRAST_Uniform4f(index, v0, v1, v2, 0)
 314 void DPSOFTRAST_Uniform4f(DPSOFTRAST_UNIFORM index, float v0, float v1, float v2, float v3);
 315 void DPSOFTRAST_Uniform4fv(DPSOFTRAST_UNIFORM index, const float *v);
 316 void DPSOFTRAST_UniformMatrix4fv(DPSOFTRAST_UNIFORM index, int arraysize, int transpose, const float *v);
 317 void DPSOFTRAST_Uniform1i(DPSOFTRAST_UNIFORM index, int i0);
 318
 319 void DPSOFTRAST_DrawTriangles(int firstvertex, int numvertices, int numtriangles, const int *element3i, const unsigned short *element3s);
 320
 321 #endif // DPSOFTRAST_H