331 lines
11 KiB
C
331 lines
11 KiB
C
|
/*
|
||
|
|
* Copyright (C) 2007 The Android Open Source Project
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef ANDROID_PIXELFLINGER_H
|
||
|
|
#define ANDROID_PIXELFLINGER_H
|
||
|
|
|
||
|
|
#include <stdint.h>
|
||
|
|
#include <sys/types.h>
|
||
|
|
|
||
|
|
#include <pixelflinger/format.h>
|
||
|
|
|
||
|
|
// GGL types
|
||
|
|
|
||
|
|
typedef int8_t GGLbyte; // b
|
||
|
|
typedef int16_t GGLshort; // s
|
||
|
|
typedef int32_t GGLint; // i
|
||
|
|
typedef ssize_t GGLsizei; // i
|
||
|
|
typedef int32_t GGLfixed; // x
|
||
|
|
typedef int32_t GGLclampx; // x
|
||
|
|
typedef float GGLfloat; // f
|
||
|
|
typedef float GGLclampf; // f
|
||
|
|
typedef double GGLdouble; // d
|
||
|
|
typedef double GGLclampd; // d
|
||
|
|
typedef uint8_t GGLubyte; // ub
|
||
|
|
typedef uint8_t GGLboolean; // ub
|
||
|
|
typedef uint16_t GGLushort; // us
|
||
|
|
typedef uint32_t GGLuint; // ui
|
||
|
|
typedef unsigned int GGLenum; // ui
|
||
|
|
typedef unsigned int GGLbitfield; // ui
|
||
|
|
typedef void GGLvoid;
|
||
|
|
typedef int32_t GGLfixed32;
|
||
|
|
typedef int32_t GGLcolor;
|
||
|
|
typedef int32_t GGLcoord;
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#define GGL_MAX_VIEWPORT_DIMS 4096
|
||
|
|
#define GGL_MAX_TEXTURE_SIZE 4096
|
||
|
|
#define GGL_MAX_ALIASED_POINT_SIZE 0x7FFFFFF
|
||
|
|
#define GGL_MAX_SMOOTH_POINT_SIZE 2048
|
||
|
|
#define GGL_MAX_SMOOTH_LINE_WIDTH 2048
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// All these names are compatible with their OpenGL equivalents
|
||
|
|
// some of them are listed only for completeness
|
||
|
|
enum GGLNames {
|
||
|
|
GGL_FALSE = 0,
|
||
|
|
GGL_TRUE = 1,
|
||
|
|
|
||
|
|
// enable/disable
|
||
|
|
GGL_SCISSOR_TEST = 0x0C11,
|
||
|
|
GGL_TEXTURE_2D = 0x0DE1,
|
||
|
|
GGL_ALPHA_TEST = 0x0BC0,
|
||
|
|
GGL_BLEND = 0x0BE2,
|
||
|
|
GGL_COLOR_LOGIC_OP = 0x0BF2,
|
||
|
|
GGL_DITHER = 0x0BD0,
|
||
|
|
GGL_STENCIL_TEST = 0x0B90,
|
||
|
|
GGL_DEPTH_TEST = 0x0B71,
|
||
|
|
GGL_AA = 0x80000001,
|
||
|
|
GGL_W_LERP = 0x80000004,
|
||
|
|
GGL_POINT_SMOOTH_NICE = 0x80000005,
|
||
|
|
|
||
|
|
// buffers, pixel drawing/reading
|
||
|
|
GGL_COLOR = 0x1800,
|
||
|
|
|
||
|
|
// fog
|
||
|
|
GGL_FOG = 0x0B60,
|
||
|
|
|
||
|
|
// shade model
|
||
|
|
GGL_FLAT = 0x1D00,
|
||
|
|
GGL_SMOOTH = 0x1D01,
|
||
|
|
|
||
|
|
// Texture parameter name
|
||
|
|
GGL_TEXTURE_MIN_FILTER = 0x2801,
|
||
|
|
GGL_TEXTURE_MAG_FILTER = 0x2800,
|
||
|
|
GGL_TEXTURE_WRAP_S = 0x2802,
|
||
|
|
GGL_TEXTURE_WRAP_T = 0x2803,
|
||
|
|
GGL_TEXTURE_WRAP_R = 0x2804,
|
||
|
|
|
||
|
|
// Texture Filter
|
||
|
|
GGL_NEAREST = 0x2600,
|
||
|
|
GGL_LINEAR = 0x2601,
|
||
|
|
GGL_NEAREST_MIPMAP_NEAREST = 0x2700,
|
||
|
|
GGL_LINEAR_MIPMAP_NEAREST = 0x2701,
|
||
|
|
GGL_NEAREST_MIPMAP_LINEAR = 0x2702,
|
||
|
|
GGL_LINEAR_MIPMAP_LINEAR = 0x2703,
|
||
|
|
|
||
|
|
// Texture Wrap Mode
|
||
|
|
GGL_CLAMP = 0x2900,
|
||
|
|
GGL_REPEAT = 0x2901,
|
||
|
|
GGL_CLAMP_TO_EDGE = 0x812F,
|
||
|
|
|
||
|
|
// Texture Env Mode
|
||
|
|
GGL_REPLACE = 0x1E01,
|
||
|
|
GGL_MODULATE = 0x2100,
|
||
|
|
GGL_DECAL = 0x2101,
|
||
|
|
GGL_ADD = 0x0104,
|
||
|
|
|
||
|
|
// Texture Env Parameter
|
||
|
|
GGL_TEXTURE_ENV_MODE = 0x2200,
|
||
|
|
GGL_TEXTURE_ENV_COLOR = 0x2201,
|
||
|
|
|
||
|
|
// Texture Env Target
|
||
|
|
GGL_TEXTURE_ENV = 0x2300,
|
||
|
|
|
||
|
|
// Texture coord generation
|
||
|
|
GGL_TEXTURE_GEN_MODE = 0x2500,
|
||
|
|
GGL_S = 0x2000,
|
||
|
|
GGL_T = 0x2001,
|
||
|
|
GGL_R = 0x2002,
|
||
|
|
GGL_Q = 0x2003,
|
||
|
|
GGL_ONE_TO_ONE = 0x80000002,
|
||
|
|
GGL_AUTOMATIC = 0x80000003,
|
||
|
|
|
||
|
|
// AlphaFunction
|
||
|
|
GGL_NEVER = 0x0200,
|
||
|
|
GGL_LESS = 0x0201,
|
||
|
|
GGL_EQUAL = 0x0202,
|
||
|
|
GGL_LEQUAL = 0x0203,
|
||
|
|
GGL_GREATER = 0x0204,
|
||
|
|
GGL_NOTEQUAL = 0x0205,
|
||
|
|
GGL_GEQUAL = 0x0206,
|
||
|
|
GGL_ALWAYS = 0x0207,
|
||
|
|
|
||
|
|
// LogicOp
|
||
|
|
GGL_CLEAR = 0x1500, // 0
|
||
|
|
GGL_AND = 0x1501, // s & d
|
||
|
|
GGL_AND_REVERSE = 0x1502, // s & ~d
|
||
|
|
GGL_COPY = 0x1503, // s
|
||
|
|
GGL_AND_INVERTED = 0x1504, // ~s & d
|
||
|
|
GGL_NOOP = 0x1505, // d
|
||
|
|
GGL_XOR = 0x1506, // s ^ d
|
||
|
|
GGL_OR = 0x1507, // s | d
|
||
|
|
GGL_NOR = 0x1508, // ~(s | d)
|
||
|
|
GGL_EQUIV = 0x1509, // ~(s ^ d)
|
||
|
|
GGL_INVERT = 0x150A, // ~d
|
||
|
|
GGL_OR_REVERSE = 0x150B, // s | ~d
|
||
|
|
GGL_COPY_INVERTED = 0x150C, // ~s
|
||
|
|
GGL_OR_INVERTED = 0x150D, // ~s | d
|
||
|
|
GGL_NAND = 0x150E, // ~(s & d)
|
||
|
|
GGL_SET = 0x150F, // 1
|
||
|
|
|
||
|
|
// blending equation & function
|
||
|
|
GGL_ZERO = 0, // SD
|
||
|
|
GGL_ONE = 1, // SD
|
||
|
|
GGL_SRC_COLOR = 0x0300, // D
|
||
|
|
GGL_ONE_MINUS_SRC_COLOR = 0x0301, // D
|
||
|
|
GGL_SRC_ALPHA = 0x0302, // SD
|
||
|
|
GGL_ONE_MINUS_SRC_ALPHA = 0x0303, // SD
|
||
|
|
GGL_DST_ALPHA = 0x0304, // SD
|
||
|
|
GGL_ONE_MINUS_DST_ALPHA = 0x0305, // SD
|
||
|
|
GGL_DST_COLOR = 0x0306, // S
|
||
|
|
GGL_ONE_MINUS_DST_COLOR = 0x0307, // S
|
||
|
|
GGL_SRC_ALPHA_SATURATE = 0x0308, // S
|
||
|
|
|
||
|
|
// clear bits
|
||
|
|
GGL_DEPTH_BUFFER_BIT = 0x00000100,
|
||
|
|
GGL_STENCIL_BUFFER_BIT = 0x00000400,
|
||
|
|
GGL_COLOR_BUFFER_BIT = 0x00004000,
|
||
|
|
|
||
|
|
// errors
|
||
|
|
GGL_NO_ERROR = 0,
|
||
|
|
GGL_INVALID_ENUM = 0x0500,
|
||
|
|
GGL_INVALID_VALUE = 0x0501,
|
||
|
|
GGL_INVALID_OPERATION = 0x0502,
|
||
|
|
GGL_STACK_OVERFLOW = 0x0503,
|
||
|
|
GGL_STACK_UNDERFLOW = 0x0504,
|
||
|
|
GGL_OUT_OF_MEMORY = 0x0505
|
||
|
|
};
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
GGLsizei version; // always set to sizeof(GGLSurface)
|
||
|
|
GGLuint width; // width in pixels
|
||
|
|
GGLuint height; // height in pixels
|
||
|
|
GGLint stride; // stride in pixels
|
||
|
|
GGLubyte* data; // pointer to the bits
|
||
|
|
GGLubyte format; // pixel format
|
||
|
|
GGLubyte rfu[3]; // must be zero
|
||
|
|
// these values are dependent on the used format
|
||
|
|
union {
|
||
|
|
GGLint compressedFormat;
|
||
|
|
GGLint vstride;
|
||
|
|
};
|
||
|
|
void* reserved;
|
||
|
|
} GGLSurface;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// immediate rendering
|
||
|
|
void (*pointx)(void *con, const GGLcoord* v, GGLcoord r);
|
||
|
|
void (*linex)(void *con,
|
||
|
|
const GGLcoord* v0, const GGLcoord* v1, GGLcoord width);
|
||
|
|
void (*recti)(void* c, GGLint l, GGLint t, GGLint r, GGLint b);
|
||
|
|
void (*trianglex)(void* c,
|
||
|
|
GGLcoord const* v0, GGLcoord const* v1, GGLcoord const* v2);
|
||
|
|
|
||
|
|
// scissor
|
||
|
|
void (*scissor)(void* c, GGLint x, GGLint y, GGLsizei width, GGLsizei height);
|
||
|
|
|
||
|
|
// Set the textures and color buffers
|
||
|
|
void (*activeTexture)(void* c, GGLuint tmu);
|
||
|
|
void (*bindTexture)(void* c, const GGLSurface* surface);
|
||
|
|
void (*colorBuffer)(void* c, const GGLSurface* surface);
|
||
|
|
void (*readBuffer)(void* c, const GGLSurface* surface);
|
||
|
|
void (*depthBuffer)(void* c, const GGLSurface* surface);
|
||
|
|
void (*bindTextureLod)(void* c, GGLuint tmu, const GGLSurface* surface);
|
||
|
|
|
||
|
|
// enable/disable features
|
||
|
|
void (*enable)(void* c, GGLenum name);
|
||
|
|
void (*disable)(void* c, GGLenum name);
|
||
|
|
void (*enableDisable)(void* c, GGLenum name, GGLboolean en);
|
||
|
|
|
||
|
|
// specify the fragment's color
|
||
|
|
void (*shadeModel)(void* c, GGLenum mode);
|
||
|
|
void (*color4xv)(void* c, const GGLclampx* color);
|
||
|
|
// specify color iterators (16.16)
|
||
|
|
void (*colorGrad12xv)(void* c, const GGLcolor* grad);
|
||
|
|
|
||
|
|
// specify Z coordinate iterators (0.32)
|
||
|
|
void (*zGrad3xv)(void* c, const GGLfixed32* grad);
|
||
|
|
|
||
|
|
// specify W coordinate iterators (16.16)
|
||
|
|
void (*wGrad3xv)(void* c, const GGLfixed* grad);
|
||
|
|
|
||
|
|
// specify fog iterator & color (16.16)
|
||
|
|
void (*fogGrad3xv)(void* c, const GGLfixed* grad);
|
||
|
|
void (*fogColor3xv)(void* c, const GGLclampx* color);
|
||
|
|
|
||
|
|
// specify blending parameters
|
||
|
|
void (*blendFunc)(void* c, GGLenum src, GGLenum dst);
|
||
|
|
void (*blendFuncSeparate)(void* c, GGLenum src, GGLenum dst,
|
||
|
|
GGLenum srcAlpha, GGLenum dstAplha);
|
||
|
|
|
||
|
|
// texture environnement (REPLACE / MODULATE / DECAL / BLEND)
|
||
|
|
void (*texEnvi)(void* c, GGLenum target,
|
||
|
|
GGLenum pname,
|
||
|
|
GGLint param);
|
||
|
|
|
||
|
|
void (*texEnvxv)(void* c, GGLenum target,
|
||
|
|
GGLenum pname, const GGLfixed* params);
|
||
|
|
|
||
|
|
// texture parameters (Wrapping, filter)
|
||
|
|
void (*texParameteri)(void* c, GGLenum target,
|
||
|
|
GGLenum pname,
|
||
|
|
GGLint param);
|
||
|
|
|
||
|
|
// texture iterators (16.16)
|
||
|
|
void (*texCoord2i)(void* c, GGLint s, GGLint t);
|
||
|
|
void (*texCoord2x)(void* c, GGLfixed s, GGLfixed t);
|
||
|
|
|
||
|
|
// s, dsdx, dsdy, scale, t, dtdx, dtdy, tscale
|
||
|
|
// This api uses block floating-point for S and T texture coordinates.
|
||
|
|
// All values are given in 16.16, scaled by 'scale'. In other words,
|
||
|
|
// set scale to 0, for 16.16 values.
|
||
|
|
void (*texCoordGradScale8xv)(void* c, GGLint tmu, const int32_t* grad8);
|
||
|
|
|
||
|
|
void (*texGeni)(void* c, GGLenum coord, GGLenum pname, GGLint param);
|
||
|
|
|
||
|
|
// masking
|
||
|
|
void (*colorMask)(void* c, GGLboolean red,
|
||
|
|
GGLboolean green,
|
||
|
|
GGLboolean blue,
|
||
|
|
GGLboolean alpha);
|
||
|
|
|
||
|
|
void (*depthMask)(void* c, GGLboolean flag);
|
||
|
|
|
||
|
|
void (*stencilMask)(void* c, GGLuint mask);
|
||
|
|
|
||
|
|
// alpha func
|
||
|
|
void (*alphaFuncx)(void* c, GGLenum func, GGLclampx ref);
|
||
|
|
|
||
|
|
// depth func
|
||
|
|
void (*depthFunc)(void* c, GGLenum func);
|
||
|
|
|
||
|
|
// logic op
|
||
|
|
void (*logicOp)(void* c, GGLenum opcode);
|
||
|
|
|
||
|
|
// clear
|
||
|
|
void (*clear)(void* c, GGLbitfield mask);
|
||
|
|
void (*clearColorx)(void* c,
|
||
|
|
GGLclampx r, GGLclampx g, GGLclampx b, GGLclampx a);
|
||
|
|
void (*clearDepthx)(void* c, GGLclampx depth);
|
||
|
|
void (*clearStencil)(void* c, GGLint s);
|
||
|
|
|
||
|
|
// framebuffer operations
|
||
|
|
void (*copyPixels)(void* c, GGLint x, GGLint y,
|
||
|
|
GGLsizei width, GGLsizei height, GGLenum type);
|
||
|
|
void (*rasterPos2x)(void* c, GGLfixed x, GGLfixed y);
|
||
|
|
void (*rasterPos2i)(void* c, GGLint x, GGLint y);
|
||
|
|
} GGLContext;
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// construct / destroy the context
|
||
|
|
ssize_t gglInit(GGLContext** context);
|
||
|
|
ssize_t gglUninit(GGLContext* context);
|
||
|
|
|
||
|
|
GGLint gglBitBlti(
|
||
|
|
GGLContext* c,
|
||
|
|
int tmu,
|
||
|
|
GGLint crop[4],
|
||
|
|
GGLint where[4]);
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
};
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
#endif // ANDROID_PIXELFLINGER_H
|