p_defines.h revision 88426780479743036993a0fcd112232d2792690a
1/************************************************************************** 2 * 3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4 * All Rights Reserved. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a 7 * copy of this software and associated documentation files (the 8 * "Software"), to deal in the Software without restriction, including 9 * without limitation the rights to use, copy, modify, merge, publish, 10 * distribute, sub license, and/or sell copies of the Software, and to 11 * permit persons to whom the Software is furnished to do so, subject to 12 * the following conditions: 13 * 14 * The above copyright notice and this permission notice (including the 15 * next paragraph) shall be included in all copies or substantial portions 16 * of the Software. 17 * 18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25 * 26 **************************************************************************/ 27 28#ifndef PIPE_DEFINES_H 29#define PIPE_DEFINES_H 30 31#include "p_compiler.h" 32 33#ifdef __cplusplus 34extern "C" { 35#endif 36 37/** 38 * Gallium error codes. 39 * 40 * - A zero value always means success. 41 * - A negative value always means failure. 42 * - The meaning of a positive value is function dependent. 43 */ 44enum pipe_error { 45 PIPE_OK = 0, 46 PIPE_ERROR = -1, /**< Generic error */ 47 PIPE_ERROR_BAD_INPUT = -2, 48 PIPE_ERROR_OUT_OF_MEMORY = -3, 49 PIPE_ERROR_RETRY = -4 50 /* TODO */ 51}; 52 53 54#define PIPE_BLENDFACTOR_ONE 0x1 55#define PIPE_BLENDFACTOR_SRC_COLOR 0x2 56#define PIPE_BLENDFACTOR_SRC_ALPHA 0x3 57#define PIPE_BLENDFACTOR_DST_ALPHA 0x4 58#define PIPE_BLENDFACTOR_DST_COLOR 0x5 59#define PIPE_BLENDFACTOR_SRC_ALPHA_SATURATE 0x6 60#define PIPE_BLENDFACTOR_CONST_COLOR 0x7 61#define PIPE_BLENDFACTOR_CONST_ALPHA 0x8 62#define PIPE_BLENDFACTOR_SRC1_COLOR 0x9 63#define PIPE_BLENDFACTOR_SRC1_ALPHA 0x0A 64#define PIPE_BLENDFACTOR_ZERO 0x11 65#define PIPE_BLENDFACTOR_INV_SRC_COLOR 0x12 66#define PIPE_BLENDFACTOR_INV_SRC_ALPHA 0x13 67#define PIPE_BLENDFACTOR_INV_DST_ALPHA 0x14 68#define PIPE_BLENDFACTOR_INV_DST_COLOR 0x15 69#define PIPE_BLENDFACTOR_INV_CONST_COLOR 0x17 70#define PIPE_BLENDFACTOR_INV_CONST_ALPHA 0x18 71#define PIPE_BLENDFACTOR_INV_SRC1_COLOR 0x19 72#define PIPE_BLENDFACTOR_INV_SRC1_ALPHA 0x1A 73 74#define PIPE_BLEND_ADD 0 75#define PIPE_BLEND_SUBTRACT 1 76#define PIPE_BLEND_REVERSE_SUBTRACT 2 77#define PIPE_BLEND_MIN 3 78#define PIPE_BLEND_MAX 4 79 80#define PIPE_LOGICOP_CLEAR 0 81#define PIPE_LOGICOP_NOR 1 82#define PIPE_LOGICOP_AND_INVERTED 2 83#define PIPE_LOGICOP_COPY_INVERTED 3 84#define PIPE_LOGICOP_AND_REVERSE 4 85#define PIPE_LOGICOP_INVERT 5 86#define PIPE_LOGICOP_XOR 6 87#define PIPE_LOGICOP_NAND 7 88#define PIPE_LOGICOP_AND 8 89#define PIPE_LOGICOP_EQUIV 9 90#define PIPE_LOGICOP_NOOP 10 91#define PIPE_LOGICOP_OR_INVERTED 11 92#define PIPE_LOGICOP_COPY 12 93#define PIPE_LOGICOP_OR_REVERSE 13 94#define PIPE_LOGICOP_OR 14 95#define PIPE_LOGICOP_SET 15 96 97#define PIPE_MASK_R 0x1 98#define PIPE_MASK_G 0x2 99#define PIPE_MASK_B 0x4 100#define PIPE_MASK_A 0x8 101#define PIPE_MASK_RGBA 0xf 102#define PIPE_MASK_Z 0x10 103#define PIPE_MASK_S 0x20 104#define PIPE_MASK_ZS 0x30 105#define PIPE_MASK_RGBAZS (PIPE_MASK_RGBA|PIPE_MASK_ZS) 106 107 108/** 109 * Inequality functions. Used for depth test, stencil compare, alpha 110 * test, shadow compare, etc. 111 */ 112#define PIPE_FUNC_NEVER 0 113#define PIPE_FUNC_LESS 1 114#define PIPE_FUNC_EQUAL 2 115#define PIPE_FUNC_LEQUAL 3 116#define PIPE_FUNC_GREATER 4 117#define PIPE_FUNC_NOTEQUAL 5 118#define PIPE_FUNC_GEQUAL 6 119#define PIPE_FUNC_ALWAYS 7 120 121/** Polygon fill mode */ 122#define PIPE_POLYGON_MODE_FILL 0 123#define PIPE_POLYGON_MODE_LINE 1 124#define PIPE_POLYGON_MODE_POINT 2 125 126/** Polygon face specification, eg for culling */ 127#define PIPE_FACE_NONE 0 128#define PIPE_FACE_FRONT 1 129#define PIPE_FACE_BACK 2 130#define PIPE_FACE_FRONT_AND_BACK (PIPE_FACE_FRONT | PIPE_FACE_BACK) 131 132/** Stencil ops */ 133#define PIPE_STENCIL_OP_KEEP 0 134#define PIPE_STENCIL_OP_ZERO 1 135#define PIPE_STENCIL_OP_REPLACE 2 136#define PIPE_STENCIL_OP_INCR 3 137#define PIPE_STENCIL_OP_DECR 4 138#define PIPE_STENCIL_OP_INCR_WRAP 5 139#define PIPE_STENCIL_OP_DECR_WRAP 6 140#define PIPE_STENCIL_OP_INVERT 7 141 142/** Texture types. 143 * See the documentation for info on PIPE_TEXTURE_RECT vs PIPE_TEXTURE_2D */ 144enum pipe_texture_target { 145 PIPE_BUFFER = 0, 146 PIPE_TEXTURE_1D = 1, 147 PIPE_TEXTURE_2D = 2, 148 PIPE_TEXTURE_3D = 3, 149 PIPE_TEXTURE_CUBE = 4, 150 PIPE_TEXTURE_RECT = 5, 151 PIPE_TEXTURE_1D_ARRAY = 6, 152 PIPE_TEXTURE_2D_ARRAY = 7, 153 PIPE_MAX_TEXTURE_TYPES 154}; 155 156#define PIPE_TEX_FACE_POS_X 0 157#define PIPE_TEX_FACE_NEG_X 1 158#define PIPE_TEX_FACE_POS_Y 2 159#define PIPE_TEX_FACE_NEG_Y 3 160#define PIPE_TEX_FACE_POS_Z 4 161#define PIPE_TEX_FACE_NEG_Z 5 162#define PIPE_TEX_FACE_MAX 6 163 164#define PIPE_TEX_WRAP_REPEAT 0 165#define PIPE_TEX_WRAP_CLAMP 1 166#define PIPE_TEX_WRAP_CLAMP_TO_EDGE 2 167#define PIPE_TEX_WRAP_CLAMP_TO_BORDER 3 168#define PIPE_TEX_WRAP_MIRROR_REPEAT 4 169#define PIPE_TEX_WRAP_MIRROR_CLAMP 5 170#define PIPE_TEX_WRAP_MIRROR_CLAMP_TO_EDGE 6 171#define PIPE_TEX_WRAP_MIRROR_CLAMP_TO_BORDER 7 172 173/* Between mipmaps, ie mipfilter 174 */ 175#define PIPE_TEX_MIPFILTER_NEAREST 0 176#define PIPE_TEX_MIPFILTER_LINEAR 1 177#define PIPE_TEX_MIPFILTER_NONE 2 178 179/* Within a mipmap, ie min/mag filter 180 */ 181#define PIPE_TEX_FILTER_NEAREST 0 182#define PIPE_TEX_FILTER_LINEAR 1 183 184#define PIPE_TEX_COMPARE_NONE 0 185#define PIPE_TEX_COMPARE_R_TO_TEXTURE 1 186 187/** 188 * Clear buffer bits 189 */ 190/** All color buffers currently bound */ 191#define PIPE_CLEAR_COLOR (1 << 0) 192#define PIPE_CLEAR_DEPTH (1 << 1) 193#define PIPE_CLEAR_STENCIL (1 << 2) 194/** Depth/stencil combined */ 195#define PIPE_CLEAR_DEPTHSTENCIL (PIPE_CLEAR_DEPTH | PIPE_CLEAR_STENCIL) 196 197/** 198 * Transfer object usage flags 199 */ 200enum pipe_transfer_usage { 201 /** 202 * Resource contents read back (or accessed directly) at transfer 203 * create time. 204 */ 205 PIPE_TRANSFER_READ = (1 << 0), 206 207 /** 208 * Resource contents will be written back at transfer_destroy 209 * time (or modified as a result of being accessed directly). 210 */ 211 PIPE_TRANSFER_WRITE = (1 << 1), 212 213 /** 214 * Read/modify/write 215 */ 216 PIPE_TRANSFER_READ_WRITE = PIPE_TRANSFER_READ | PIPE_TRANSFER_WRITE, 217 218 /** 219 * The transfer should map the texture storage directly. The driver may 220 * return NULL if that isn't possible, and the state tracker needs to cope 221 * with that and use an alternative path without this flag. 222 * 223 * E.g. the state tracker could have a simpler path which maps textures and 224 * does read/modify/write cycles on them directly, and a more complicated 225 * path which uses minimal read and write transfers. 226 */ 227 PIPE_TRANSFER_MAP_DIRECTLY = (1 << 2), 228 229 /** 230 * Discards the memory within the mapped region. 231 * 232 * It should not be used with PIPE_TRANSFER_READ. 233 * 234 * See also: 235 * - OpenGL's ARB_map_buffer_range extension, MAP_INVALIDATE_RANGE_BIT flag. 236 */ 237 PIPE_TRANSFER_DISCARD_RANGE = (1 << 8), 238 239 /** 240 * Fail if the resource cannot be mapped immediately. 241 * 242 * See also: 243 * - Direct3D's D3DLOCK_DONOTWAIT flag. 244 * - Mesa3D's MESA_MAP_NOWAIT_BIT flag. 245 * - WDDM's D3DDDICB_LOCKFLAGS.DonotWait flag. 246 */ 247 PIPE_TRANSFER_DONTBLOCK = (1 << 9), 248 249 /** 250 * Do not attempt to synchronize pending operations on the resource when mapping. 251 * 252 * It should not be used with PIPE_TRANSFER_READ. 253 * 254 * See also: 255 * - OpenGL's ARB_map_buffer_range extension, MAP_UNSYNCHRONIZED_BIT flag. 256 * - Direct3D's D3DLOCK_NOOVERWRITE flag. 257 * - WDDM's D3DDDICB_LOCKFLAGS.IgnoreSync flag. 258 */ 259 PIPE_TRANSFER_UNSYNCHRONIZED = (1 << 10), 260 261 /** 262 * Written ranges will be notified later with 263 * pipe_context::transfer_flush_region. 264 * 265 * It should not be used with PIPE_TRANSFER_READ. 266 * 267 * See also: 268 * - pipe_context::transfer_flush_region 269 * - OpenGL's ARB_map_buffer_range extension, MAP_FLUSH_EXPLICIT_BIT flag. 270 */ 271 PIPE_TRANSFER_FLUSH_EXPLICIT = (1 << 11), 272 273 /** 274 * Discards all memory backing the resource. 275 * 276 * It should not be used with PIPE_TRANSFER_READ. 277 * 278 * This is equivalent to: 279 * - OpenGL's ARB_map_buffer_range extension, MAP_INVALIDATE_BUFFER_BIT 280 * - BufferData(NULL) on a GL buffer 281 * - Direct3D's D3DLOCK_DISCARD flag. 282 * - WDDM's D3DDDICB_LOCKFLAGS.Discard flag. 283 * - D3D10 DDI's D3D10_DDI_MAP_WRITE_DISCARD flag 284 * - D3D10's D3D10_MAP_WRITE_DISCARD flag. 285 */ 286 PIPE_TRANSFER_DISCARD_WHOLE_RESOURCE = (1 << 12) 287 288}; 289 290 291/* 292 * Resource binding flags -- state tracker must specify in advance all 293 * the ways a resource might be used. 294 */ 295#define PIPE_BIND_DEPTH_STENCIL (1 << 0) /* create_surface */ 296#define PIPE_BIND_RENDER_TARGET (1 << 1) /* create_surface */ 297#define PIPE_BIND_BLENDABLE (1 << 2) /* create_surface */ 298#define PIPE_BIND_SAMPLER_VIEW (1 << 3) /* create_sampler_view */ 299#define PIPE_BIND_VERTEX_BUFFER (1 << 4) /* set_vertex_buffers */ 300#define PIPE_BIND_INDEX_BUFFER (1 << 5) /* draw_elements */ 301#define PIPE_BIND_CONSTANT_BUFFER (1 << 6) /* set_constant_buffer */ 302#define PIPE_BIND_DISPLAY_TARGET (1 << 8) /* flush_front_buffer */ 303#define PIPE_BIND_TRANSFER_WRITE (1 << 9) /* get_transfer */ 304#define PIPE_BIND_TRANSFER_READ (1 << 10) /* get_transfer */ 305#define PIPE_BIND_STREAM_OUTPUT (1 << 11) /* set_stream_output_buffers */ 306#define PIPE_BIND_CURSOR (1 << 16) /* mouse cursor */ 307#define PIPE_BIND_CUSTOM (1 << 17) /* state-tracker/winsys usages */ 308#define PIPE_BIND_GLOBAL (1 << 18) /* set_global_binding */ 309#define PIPE_BIND_SHADER_RESOURCE (1 << 19) /* set_shader_resources */ 310#define PIPE_BIND_COMPUTE_RESOURCE (1 << 20) /* set_compute_resources */ 311 312/* The first two flags above were previously part of the amorphous 313 * TEXTURE_USAGE, most of which are now descriptions of the ways a 314 * particular texture can be bound to the gallium pipeline. The two flags 315 * below do not fit within that and probably need to be migrated to some 316 * other place. 317 * 318 * It seems like scanout is used by the Xorg state tracker to ask for 319 * a texture suitable for actual scanout (hence the name), which 320 * implies extra layout constraints on some hardware. It may also 321 * have some special meaning regarding mouse cursor images. 322 * 323 * The shared flag is quite underspecified, but certainly isn't a 324 * binding flag - it seems more like a message to the winsys to create 325 * a shareable allocation. 326 */ 327#define PIPE_BIND_SCANOUT (1 << 14) /* */ 328#define PIPE_BIND_SHARED (1 << 15) /* get_texture_handle ??? */ 329 330 331/* Flags for the driver about resource behaviour: 332 */ 333#define PIPE_RESOURCE_FLAG_GEN_MIPS (1 << 0) /* Driver performs autogen mips */ 334#define PIPE_RESOURCE_FLAG_DRV_PRIV (1 << 16) /* driver/winsys private */ 335#define PIPE_RESOURCE_FLAG_ST_PRIV (1 << 24) /* state-tracker/winsys private */ 336 337/* Hint about the expected lifecycle of a resource. 338 */ 339#define PIPE_USAGE_DEFAULT 0 /* many uploads, draws intermixed */ 340#define PIPE_USAGE_DYNAMIC 1 /* many uploads, draws intermixed */ 341#define PIPE_USAGE_STATIC 2 /* same as immutable?? */ 342#define PIPE_USAGE_IMMUTABLE 3 /* no change after first upload */ 343#define PIPE_USAGE_STREAM 4 /* upload, draw, upload, draw */ 344#define PIPE_USAGE_STAGING 5 /* supports data transfers from the GPU to the CPU */ 345 346 347/** 348 * Shaders 349 */ 350#define PIPE_SHADER_VERTEX 0 351#define PIPE_SHADER_FRAGMENT 1 352#define PIPE_SHADER_GEOMETRY 2 353#define PIPE_SHADER_COMPUTE 3 354#define PIPE_SHADER_TYPES 4 355 356 357/** 358 * Primitive types: 359 */ 360#define PIPE_PRIM_POINTS 0 361#define PIPE_PRIM_LINES 1 362#define PIPE_PRIM_LINE_LOOP 2 363#define PIPE_PRIM_LINE_STRIP 3 364#define PIPE_PRIM_TRIANGLES 4 365#define PIPE_PRIM_TRIANGLE_STRIP 5 366#define PIPE_PRIM_TRIANGLE_FAN 6 367#define PIPE_PRIM_QUADS 7 368#define PIPE_PRIM_QUAD_STRIP 8 369#define PIPE_PRIM_POLYGON 9 370#define PIPE_PRIM_LINES_ADJACENCY 10 371#define PIPE_PRIM_LINE_STRIP_ADJACENCY 11 372#define PIPE_PRIM_TRIANGLES_ADJACENCY 12 373#define PIPE_PRIM_TRIANGLE_STRIP_ADJACENCY 13 374#define PIPE_PRIM_MAX 14 375 376 377/** 378 * Query object types 379 */ 380#define PIPE_QUERY_OCCLUSION_COUNTER 0 381#define PIPE_QUERY_OCCLUSION_PREDICATE 1 382#define PIPE_QUERY_TIMESTAMP 2 383#define PIPE_QUERY_TIMESTAMP_DISJOINT 3 384#define PIPE_QUERY_TIME_ELAPSED 4 385#define PIPE_QUERY_PRIMITIVES_GENERATED 5 386#define PIPE_QUERY_PRIMITIVES_EMITTED 6 387#define PIPE_QUERY_SO_STATISTICS 7 388#define PIPE_QUERY_SO_OVERFLOW_PREDICATE 8 389#define PIPE_QUERY_GPU_FINISHED 9 390#define PIPE_QUERY_PIPELINE_STATISTICS 10 391#define PIPE_QUERY_TYPES 11 392 393 394/** 395 * Conditional rendering modes 396 */ 397#define PIPE_RENDER_COND_WAIT 0 398#define PIPE_RENDER_COND_NO_WAIT 1 399#define PIPE_RENDER_COND_BY_REGION_WAIT 2 400#define PIPE_RENDER_COND_BY_REGION_NO_WAIT 3 401 402 403/** 404 * Point sprite coord modes 405 */ 406#define PIPE_SPRITE_COORD_UPPER_LEFT 0 407#define PIPE_SPRITE_COORD_LOWER_LEFT 1 408 409 410/** 411 * Texture swizzles 412 */ 413#define PIPE_SWIZZLE_RED 0 414#define PIPE_SWIZZLE_GREEN 1 415#define PIPE_SWIZZLE_BLUE 2 416#define PIPE_SWIZZLE_ALPHA 3 417#define PIPE_SWIZZLE_ZERO 4 418#define PIPE_SWIZZLE_ONE 5 419 420 421#define PIPE_TIMEOUT_INFINITE 0xffffffffffffffffull 422 423/** 424 * Implementation capabilities/limits which are queried through 425 * pipe_screen::get_param() 426 */ 427enum pipe_cap { 428 PIPE_CAP_NPOT_TEXTURES = 1, 429 PIPE_CAP_TWO_SIDED_STENCIL = 2, 430 PIPE_CAP_MAX_DUAL_SOURCE_RENDER_TARGETS = 4, 431 PIPE_CAP_ANISOTROPIC_FILTER = 5, 432 PIPE_CAP_POINT_SPRITE = 6, 433 PIPE_CAP_MAX_RENDER_TARGETS = 7, 434 PIPE_CAP_OCCLUSION_QUERY = 8, 435 PIPE_CAP_TIMER_QUERY = 9, 436 PIPE_CAP_TEXTURE_SHADOW_MAP = 10, 437 PIPE_CAP_TEXTURE_SWIZZLE = 11, 438 PIPE_CAP_MAX_TEXTURE_2D_LEVELS = 12, 439 PIPE_CAP_MAX_TEXTURE_3D_LEVELS = 13, 440 PIPE_CAP_MAX_TEXTURE_CUBE_LEVELS = 14, 441 PIPE_CAP_TEXTURE_MIRROR_CLAMP = 25, 442 PIPE_CAP_BLEND_EQUATION_SEPARATE = 28, 443 PIPE_CAP_SM3 = 29, /*< Shader Model, supported */ 444 PIPE_CAP_MAX_STREAM_OUTPUT_BUFFERS = 30, 445 PIPE_CAP_PRIMITIVE_RESTART = 31, 446 /** Maximum texture image units accessible from vertex and fragment shaders 447 * combined */ 448 PIPE_CAP_MAX_COMBINED_SAMPLERS = 32, 449 /** blend enables and write masks per rendertarget */ 450 PIPE_CAP_INDEP_BLEND_ENABLE = 33, 451 /** different blend funcs per rendertarget */ 452 PIPE_CAP_INDEP_BLEND_FUNC = 34, 453 PIPE_CAP_DEPTHSTENCIL_CLEAR_SEPARATE = 35, 454 PIPE_CAP_MAX_TEXTURE_ARRAY_LAYERS = 36, 455 PIPE_CAP_TGSI_FS_COORD_ORIGIN_UPPER_LEFT = 37, 456 PIPE_CAP_TGSI_FS_COORD_ORIGIN_LOWER_LEFT = 38, 457 PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_HALF_INTEGER = 39, 458 PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_INTEGER = 40, 459 PIPE_CAP_DEPTH_CLIP_DISABLE = 41, 460 PIPE_CAP_SHADER_STENCIL_EXPORT = 42, 461 PIPE_CAP_TGSI_INSTANCEID = 43, 462 PIPE_CAP_VERTEX_ELEMENT_INSTANCE_DIVISOR = 44, 463 PIPE_CAP_FRAGMENT_COLOR_CLAMPED = 45, 464 PIPE_CAP_MIXED_COLORBUFFER_FORMATS = 46, 465 PIPE_CAP_SEAMLESS_CUBE_MAP = 47, 466 PIPE_CAP_SEAMLESS_CUBE_MAP_PER_TEXTURE = 48, 467 PIPE_CAP_SCALED_RESOLVE = 49, 468 PIPE_CAP_MIN_TEXEL_OFFSET = 50, 469 PIPE_CAP_MAX_TEXEL_OFFSET = 51, 470 PIPE_CAP_CONDITIONAL_RENDER = 52, 471 PIPE_CAP_TEXTURE_BARRIER = 53, 472 PIPE_CAP_MAX_STREAM_OUTPUT_SEPARATE_COMPONENTS = 55, 473 PIPE_CAP_MAX_STREAM_OUTPUT_INTERLEAVED_COMPONENTS = 56, 474 PIPE_CAP_STREAM_OUTPUT_PAUSE_RESUME = 57, 475 PIPE_CAP_TGSI_CAN_COMPACT_VARYINGS = 58, /* temporary */ 476 PIPE_CAP_TGSI_CAN_COMPACT_CONSTANTS = 59, /* temporary */ 477 PIPE_CAP_VERTEX_COLOR_UNCLAMPED = 60, 478 PIPE_CAP_VERTEX_COLOR_CLAMPED = 61, 479 PIPE_CAP_GLSL_FEATURE_LEVEL = 62, 480 PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION = 63, 481 PIPE_CAP_USER_VERTEX_BUFFERS = 64, 482 PIPE_CAP_VERTEX_BUFFER_OFFSET_4BYTE_ALIGNED_ONLY = 65, 483 PIPE_CAP_VERTEX_BUFFER_STRIDE_4BYTE_ALIGNED_ONLY = 66, 484 PIPE_CAP_VERTEX_ELEMENT_SRC_OFFSET_4BYTE_ALIGNED_ONLY = 67, 485 PIPE_CAP_COMPUTE = 68, 486 PIPE_CAP_USER_INDEX_BUFFERS = 69, 487 PIPE_CAP_USER_CONSTANT_BUFFERS = 70, 488 PIPE_CAP_CONSTANT_BUFFER_OFFSET_ALIGNMENT = 71, 489 PIPE_CAP_START_INSTANCE = 72, 490 PIPE_CAP_QUERY_TIMESTAMP = 73 491}; 492 493/** 494 * Implementation limits which are queried through 495 * pipe_screen::get_paramf() 496 */ 497enum pipe_capf 498{ 499 PIPE_CAPF_MAX_LINE_WIDTH = 15, 500 PIPE_CAPF_MAX_LINE_WIDTH_AA = 16, 501 PIPE_CAPF_MAX_POINT_WIDTH = 17, 502 PIPE_CAPF_MAX_POINT_WIDTH_AA = 18, 503 PIPE_CAPF_MAX_TEXTURE_ANISOTROPY = 19, 504 PIPE_CAPF_MAX_TEXTURE_LOD_BIAS = 20, 505 PIPE_CAPF_GUARD_BAND_LEFT = 21, 506 PIPE_CAPF_GUARD_BAND_TOP = 22, 507 PIPE_CAPF_GUARD_BAND_RIGHT = 23, 508 PIPE_CAPF_GUARD_BAND_BOTTOM = 24 509}; 510 511/* Shader caps not specific to any single stage */ 512enum pipe_shader_cap 513{ 514 PIPE_SHADER_CAP_MAX_INSTRUCTIONS = 0, /* if 0, it means the stage is unsupported */ 515 PIPE_SHADER_CAP_MAX_ALU_INSTRUCTIONS = 1, 516 PIPE_SHADER_CAP_MAX_TEX_INSTRUCTIONS = 2, 517 PIPE_SHADER_CAP_MAX_TEX_INDIRECTIONS = 3, 518 PIPE_SHADER_CAP_MAX_CONTROL_FLOW_DEPTH = 4, 519 PIPE_SHADER_CAP_MAX_INPUTS = 5, 520 PIPE_SHADER_CAP_MAX_CONSTS = 6, 521 PIPE_SHADER_CAP_MAX_CONST_BUFFERS = 7, 522 PIPE_SHADER_CAP_MAX_TEMPS = 8, 523 PIPE_SHADER_CAP_MAX_ADDRS = 9, 524 PIPE_SHADER_CAP_MAX_PREDS = 10, 525 /* boolean caps */ 526 PIPE_SHADER_CAP_TGSI_CONT_SUPPORTED = 11, 527 PIPE_SHADER_CAP_INDIRECT_INPUT_ADDR = 12, 528 PIPE_SHADER_CAP_INDIRECT_OUTPUT_ADDR = 13, 529 PIPE_SHADER_CAP_INDIRECT_TEMP_ADDR = 14, 530 PIPE_SHADER_CAP_INDIRECT_CONST_ADDR = 15, 531 PIPE_SHADER_CAP_SUBROUTINES = 16, /* BGNSUB, ENDSUB, CAL, RET */ 532 PIPE_SHADER_CAP_INTEGERS = 17, 533 PIPE_SHADER_CAP_MAX_TEXTURE_SAMPLERS = 18, 534 PIPE_SHADER_CAP_PREFERRED_IR = 19 535}; 536 537/** 538 * Shader intermediate representation. 539 */ 540enum pipe_shader_ir 541{ 542 PIPE_SHADER_IR_TGSI, 543 PIPE_SHADER_IR_LLVM 544}; 545 546/** 547 * Compute-specific implementation capability. They can be queried 548 * using pipe_screen::get_compute_param. 549 */ 550enum pipe_compute_cap 551{ 552 PIPE_COMPUTE_CAP_IR_TARGET, 553 PIPE_COMPUTE_CAP_GRID_DIMENSION, 554 PIPE_COMPUTE_CAP_MAX_GRID_SIZE, 555 PIPE_COMPUTE_CAP_MAX_BLOCK_SIZE, 556 PIPE_COMPUTE_CAP_MAX_THREADS_PER_BLOCK, 557 PIPE_COMPUTE_CAP_MAX_GLOBAL_SIZE, 558 PIPE_COMPUTE_CAP_MAX_LOCAL_SIZE, 559 PIPE_COMPUTE_CAP_MAX_PRIVATE_SIZE, 560 PIPE_COMPUTE_CAP_MAX_INPUT_SIZE 561}; 562 563/** 564 * Composite query types 565 */ 566 567/** 568 * Query result for PIPE_QUERY_SO_STATISTICS. 569 */ 570struct pipe_query_data_so_statistics 571{ 572 uint64_t num_primitives_written; 573 uint64_t primitives_storage_needed; 574}; 575 576/** 577 * Query result for PIPE_QUERY_TIMESTAMP_DISJOINT. 578 */ 579struct pipe_query_data_timestamp_disjoint 580{ 581 uint64_t frequency; 582 boolean disjoint; 583}; 584 585/** 586 * Query result for PIPE_QUERY_PIPELINE_STATISTICS. 587 */ 588struct pipe_query_data_pipeline_statistics 589{ 590 uint64_t ia_vertices; /**< Num vertices read by the vertex fetcher. */ 591 uint64_t ia_primitives; /**< Num primitives read by the vertex fetcher. */ 592 uint64_t vs_invocations; /**< Num vertex shader invocations. */ 593 uint64_t gs_invocations; /**< Num geometry shader invocations. */ 594 uint64_t gs_primitives; /**< Num primitives output by a geometry shader. */ 595 uint64_t c_invocations; /**< Num primitives sent to the rasterizer. */ 596 uint64_t c_primitives; /**< Num primitives that were rendered. */ 597 uint64_t ps_invocations; /**< Num pixel shader invocations. */ 598 uint64_t hs_invocations; /**< Num hull shader invocations. */ 599 uint64_t ds_invocations; /**< Num domain shader invocations. */ 600 uint64_t cs_invocations; /**< Num compute shader invocations. */ 601}; 602 603/** 604 * Query result (returned by pipe_context::get_query_result). 605 */ 606union pipe_query_result 607{ 608 /* PIPE_QUERY_OCCLUSION_PREDICATE */ 609 /* PIPE_QUERY_SO_OVERFLOW_PREDICATE */ 610 /* PIPE_QUERY_GPU_FINISHED */ 611 boolean b; 612 613 /* PIPE_QUERY_OCCLUSION_COUNTER */ 614 /* PIPE_QUERY_TIMESTAMP */ 615 /* PIPE_QUERY_TIME_ELAPSED */ 616 /* PIPE_QUERY_PRIMITIVES_GENERATED */ 617 /* PIPE_QUERY_PRIMITIVES_EMITTED */ 618 uint64_t u64; 619 620 /* PIPE_QUERY_SO_STATISTICS */ 621 struct pipe_query_data_so_statistics so_statistics; 622 623 /* PIPE_QUERY_TIMESTAMP_DISJOINT */ 624 struct pipe_query_data_timestamp_disjoint timestamp_disjoint; 625 626 /* PIPE_QUERY_PIPELINE_STATISTICS */ 627 struct pipe_query_data_pipeline_statistics pipeline_statistics; 628}; 629 630union pipe_color_union 631{ 632 float f[4]; 633 int i[4]; 634 unsigned int ui[4]; 635}; 636 637#ifdef __cplusplus 638} 639#endif 640 641#endif 642