constants-and-properties.html (17853B)
1 <!-- 2 Copyright (c) 2019 The Khronos Group Inc. 3 Use of this source code is governed by an MIT-style license that can be 4 found in the LICENSE.txt file. 5 --> 6 <!DOCTYPE html> 7 <html> 8 <head> 9 <meta charset="utf-8"> 10 <title>WebGL Constants and Properties Test</title> 11 <link rel="stylesheet" href="../../resources/js-test-style.css"/> 12 <script src="../../js/js-test-pre.js"></script> 13 <script src="../../js/webgl-test-utils.js"></script> 14 </head> 15 <body> 16 <div id="description"></div> 17 <div id="console"></div> 18 <canvas id="canvas" style="width: 50px; height: 50px;"> </canvas> 19 <script> 20 "use strict"; 21 description("This test ensures that the WebGL context has all the constants and (non-function) properties in the specification."); 22 23 var constants = { 24 /* ClearBufferMask */ 25 DEPTH_BUFFER_BIT : 0x00000100, 26 STENCIL_BUFFER_BIT : 0x00000400, 27 COLOR_BUFFER_BIT : 0x00004000, 28 29 /* BeginMode */ 30 POINTS : 0x0000, 31 LINES : 0x0001, 32 LINE_LOOP : 0x0002, 33 LINE_STRIP : 0x0003, 34 TRIANGLES : 0x0004, 35 TRIANGLE_STRIP : 0x0005, 36 TRIANGLE_FAN : 0x0006, 37 38 /* AlphaFunction (not supported in ES20) */ 39 /* NEVER */ 40 /* LESS */ 41 /* EQUAL */ 42 /* LEQUAL */ 43 /* GREATER */ 44 /* NOTEQUAL */ 45 /* GEQUAL */ 46 /* ALWAYS */ 47 48 /* BlendingFactorDest */ 49 ZERO : 0, 50 ONE : 1, 51 SRC_COLOR : 0x0300, 52 ONE_MINUS_SRC_COLOR : 0x0301, 53 SRC_ALPHA : 0x0302, 54 ONE_MINUS_SRC_ALPHA : 0x0303, 55 DST_ALPHA : 0x0304, 56 ONE_MINUS_DST_ALPHA : 0x0305, 57 58 /* BlendingFactorSrc */ 59 /* ZERO */ 60 /* ONE */ 61 DST_COLOR : 0x0306, 62 ONE_MINUS_DST_COLOR : 0x0307, 63 SRC_ALPHA_SATURATE : 0x0308, 64 /* SRC_ALPHA */ 65 /* ONE_MINUS_SRC_ALPHA */ 66 /* DST_ALPHA */ 67 /* ONE_MINUS_DST_ALPHA */ 68 69 /* BlendEquationSeparate */ 70 FUNC_ADD : 0x8006, 71 BLEND_EQUATION : 0x8009, 72 BLEND_EQUATION_RGB : 0x8009, /* same as BLEND_EQUATION */ 73 BLEND_EQUATION_ALPHA : 0x883D, 74 75 /* BlendSubtract */ 76 FUNC_SUBTRACT : 0x800A, 77 FUNC_REVERSE_SUBTRACT : 0x800B, 78 79 /* Separate Blend Functions */ 80 BLEND_DST_RGB : 0x80C8, 81 BLEND_SRC_RGB : 0x80C9, 82 BLEND_DST_ALPHA : 0x80CA, 83 BLEND_SRC_ALPHA : 0x80CB, 84 CONSTANT_COLOR : 0x8001, 85 ONE_MINUS_CONSTANT_COLOR : 0x8002, 86 CONSTANT_ALPHA : 0x8003, 87 ONE_MINUS_CONSTANT_ALPHA : 0x8004, 88 BLEND_COLOR : 0x8005, 89 90 /* Buffer Objects */ 91 ARRAY_BUFFER : 0x8892, 92 ELEMENT_ARRAY_BUFFER : 0x8893, 93 ARRAY_BUFFER_BINDING : 0x8894, 94 ELEMENT_ARRAY_BUFFER_BINDING : 0x8895, 95 96 STREAM_DRAW : 0x88E0, 97 STATIC_DRAW : 0x88E4, 98 DYNAMIC_DRAW : 0x88E8, 99 100 BUFFER_SIZE : 0x8764, 101 BUFFER_USAGE : 0x8765, 102 103 CURRENT_VERTEX_ATTRIB : 0x8626, 104 105 /* CullFaceMode */ 106 FRONT : 0x0404, 107 BACK : 0x0405, 108 FRONT_AND_BACK : 0x0408, 109 110 /* DepthFunction */ 111 /* NEVER */ 112 /* LESS */ 113 /* EQUAL */ 114 /* LEQUAL */ 115 /* GREATER */ 116 /* NOTEQUAL */ 117 /* GEQUAL */ 118 /* ALWAYS */ 119 120 /* EnableCap */ 121 /* TEXTURE_2D */ 122 CULL_FACE : 0x0B44, 123 BLEND : 0x0BE2, 124 DITHER : 0x0BD0, 125 STENCIL_TEST : 0x0B90, 126 DEPTH_TEST : 0x0B71, 127 SCISSOR_TEST : 0x0C11, 128 POLYGON_OFFSET_FILL : 0x8037, 129 SAMPLE_ALPHA_TO_COVERAGE : 0x809E, 130 SAMPLE_COVERAGE : 0x80A0, 131 132 /* ErrorCode */ 133 NO_ERROR : 0, 134 INVALID_ENUM : 0x0500, 135 INVALID_VALUE : 0x0501, 136 INVALID_OPERATION : 0x0502, 137 OUT_OF_MEMORY : 0x0505, 138 139 /* FrontFaceDirection */ 140 CW : 0x0900, 141 CCW : 0x0901, 142 143 /* GetPName */ 144 LINE_WIDTH : 0x0B21, 145 ALIASED_POINT_SIZE_RANGE : 0x846D, 146 ALIASED_LINE_WIDTH_RANGE : 0x846E, 147 CULL_FACE_MODE : 0x0B45, 148 FRONT_FACE : 0x0B46, 149 DEPTH_RANGE : 0x0B70, 150 DEPTH_WRITEMASK : 0x0B72, 151 DEPTH_CLEAR_VALUE : 0x0B73, 152 DEPTH_FUNC : 0x0B74, 153 STENCIL_CLEAR_VALUE : 0x0B91, 154 STENCIL_FUNC : 0x0B92, 155 STENCIL_FAIL : 0x0B94, 156 STENCIL_PASS_DEPTH_FAIL : 0x0B95, 157 STENCIL_PASS_DEPTH_PASS : 0x0B96, 158 STENCIL_REF : 0x0B97, 159 STENCIL_VALUE_MASK : 0x0B93, 160 STENCIL_WRITEMASK : 0x0B98, 161 STENCIL_BACK_FUNC : 0x8800, 162 STENCIL_BACK_FAIL : 0x8801, 163 STENCIL_BACK_PASS_DEPTH_FAIL : 0x8802, 164 STENCIL_BACK_PASS_DEPTH_PASS : 0x8803, 165 STENCIL_BACK_REF : 0x8CA3, 166 STENCIL_BACK_VALUE_MASK : 0x8CA4, 167 STENCIL_BACK_WRITEMASK : 0x8CA5, 168 VIEWPORT : 0x0BA2, 169 SCISSOR_BOX : 0x0C10, 170 /* SCISSOR_TEST */ 171 COLOR_CLEAR_VALUE : 0x0C22, 172 COLOR_WRITEMASK : 0x0C23, 173 UNPACK_ALIGNMENT : 0x0CF5, 174 PACK_ALIGNMENT : 0x0D05, 175 MAX_TEXTURE_SIZE : 0x0D33, 176 MAX_VIEWPORT_DIMS : 0x0D3A, 177 SUBPIXEL_BITS : 0x0D50, 178 RED_BITS : 0x0D52, 179 GREEN_BITS : 0x0D53, 180 BLUE_BITS : 0x0D54, 181 ALPHA_BITS : 0x0D55, 182 DEPTH_BITS : 0x0D56, 183 STENCIL_BITS : 0x0D57, 184 POLYGON_OFFSET_UNITS : 0x2A00, 185 /* POLYGON_OFFSET_FILL */ 186 POLYGON_OFFSET_FACTOR : 0x8038, 187 TEXTURE_BINDING_2D : 0x8069, 188 SAMPLE_BUFFERS : 0x80A8, 189 SAMPLES : 0x80A9, 190 SAMPLE_COVERAGE_VALUE : 0x80AA, 191 SAMPLE_COVERAGE_INVERT : 0x80AB, 192 193 /* GetTextureParameter */ 194 /* TEXTURE_MAG_FILTER */ 195 /* TEXTURE_MIN_FILTER */ 196 /* TEXTURE_WRAP_S */ 197 /* TEXTURE_WRAP_T */ 198 199 COMPRESSED_TEXTURE_FORMATS : 0x86A3, 200 201 /* HintMode */ 202 DONT_CARE : 0x1100, 203 FASTEST : 0x1101, 204 NICEST : 0x1102, 205 206 /* HintTarget */ 207 GENERATE_MIPMAP_HINT : 0x8192, 208 209 /* DataType */ 210 BYTE : 0x1400, 211 UNSIGNED_BYTE : 0x1401, 212 SHORT : 0x1402, 213 UNSIGNED_SHORT : 0x1403, 214 INT : 0x1404, 215 UNSIGNED_INT : 0x1405, 216 FLOAT : 0x1406, 217 218 /* PixelFormat */ 219 DEPTH_COMPONENT : 0x1902, 220 ALPHA : 0x1906, 221 RGB : 0x1907, 222 RGBA : 0x1908, 223 LUMINANCE : 0x1909, 224 LUMINANCE_ALPHA : 0x190A, 225 226 /* PixelType */ 227 /* UNSIGNED_BYTE */ 228 UNSIGNED_SHORT_4_4_4_4 : 0x8033, 229 UNSIGNED_SHORT_5_5_5_1 : 0x8034, 230 UNSIGNED_SHORT_5_6_5 : 0x8363, 231 232 /* Shaders */ 233 FRAGMENT_SHADER : 0x8B30, 234 VERTEX_SHADER : 0x8B31, 235 MAX_VERTEX_ATTRIBS : 0x8869, 236 MAX_VERTEX_UNIFORM_VECTORS : 0x8DFB, 237 MAX_VARYING_VECTORS : 0x8DFC, 238 MAX_COMBINED_TEXTURE_IMAGE_UNITS : 0x8B4D, 239 MAX_VERTEX_TEXTURE_IMAGE_UNITS : 0x8B4C, 240 MAX_TEXTURE_IMAGE_UNITS : 0x8872, 241 MAX_FRAGMENT_UNIFORM_VECTORS : 0x8DFD, 242 SHADER_TYPE : 0x8B4F, 243 DELETE_STATUS : 0x8B80, 244 LINK_STATUS : 0x8B82, 245 VALIDATE_STATUS : 0x8B83, 246 ATTACHED_SHADERS : 0x8B85, 247 ACTIVE_UNIFORMS : 0x8B86, 248 ACTIVE_ATTRIBUTES : 0x8B89, 249 SHADING_LANGUAGE_VERSION : 0x8B8C, 250 CURRENT_PROGRAM : 0x8B8D, 251 252 /* StencilFunction */ 253 NEVER : 0x0200, 254 LESS : 0x0201, 255 EQUAL : 0x0202, 256 LEQUAL : 0x0203, 257 GREATER : 0x0204, 258 NOTEQUAL : 0x0205, 259 GEQUAL : 0x0206, 260 ALWAYS : 0x0207, 261 262 /* StencilOp */ 263 /* ZERO */ 264 KEEP : 0x1E00, 265 REPLACE : 0x1E01, 266 INCR : 0x1E02, 267 DECR : 0x1E03, 268 INVERT : 0x150A, 269 INCR_WRAP : 0x8507, 270 DECR_WRAP : 0x8508, 271 272 /* StringName */ 273 VENDOR : 0x1F00, 274 RENDERER : 0x1F01, 275 VERSION : 0x1F02, 276 277 /* TextureMagFilter */ 278 NEAREST : 0x2600, 279 LINEAR : 0x2601, 280 281 /* TextureMinFilter */ 282 /* NEAREST */ 283 /* LINEAR */ 284 NEAREST_MIPMAP_NEAREST : 0x2700, 285 LINEAR_MIPMAP_NEAREST : 0x2701, 286 NEAREST_MIPMAP_LINEAR : 0x2702, 287 LINEAR_MIPMAP_LINEAR : 0x2703, 288 289 /* TextureParameterName */ 290 TEXTURE_MAG_FILTER : 0x2800, 291 TEXTURE_MIN_FILTER : 0x2801, 292 TEXTURE_WRAP_S : 0x2802, 293 TEXTURE_WRAP_T : 0x2803, 294 295 /* TextureTarget */ 296 TEXTURE_2D : 0x0DE1, 297 TEXTURE : 0x1702, 298 299 TEXTURE_CUBE_MAP : 0x8513, 300 TEXTURE_BINDING_CUBE_MAP : 0x8514, 301 TEXTURE_CUBE_MAP_POSITIVE_X : 0x8515, 302 TEXTURE_CUBE_MAP_NEGATIVE_X : 0x8516, 303 TEXTURE_CUBE_MAP_POSITIVE_Y : 0x8517, 304 TEXTURE_CUBE_MAP_NEGATIVE_Y : 0x8518, 305 TEXTURE_CUBE_MAP_POSITIVE_Z : 0x8519, 306 TEXTURE_CUBE_MAP_NEGATIVE_Z : 0x851A, 307 MAX_CUBE_MAP_TEXTURE_SIZE : 0x851C, 308 309 /* TextureUnit */ 310 TEXTURE0 : 0x84C0, 311 TEXTURE1 : 0x84C1, 312 TEXTURE2 : 0x84C2, 313 TEXTURE3 : 0x84C3, 314 TEXTURE4 : 0x84C4, 315 TEXTURE5 : 0x84C5, 316 TEXTURE6 : 0x84C6, 317 TEXTURE7 : 0x84C7, 318 TEXTURE8 : 0x84C8, 319 TEXTURE9 : 0x84C9, 320 TEXTURE10 : 0x84CA, 321 TEXTURE11 : 0x84CB, 322 TEXTURE12 : 0x84CC, 323 TEXTURE13 : 0x84CD, 324 TEXTURE14 : 0x84CE, 325 TEXTURE15 : 0x84CF, 326 TEXTURE16 : 0x84D0, 327 TEXTURE17 : 0x84D1, 328 TEXTURE18 : 0x84D2, 329 TEXTURE19 : 0x84D3, 330 TEXTURE20 : 0x84D4, 331 TEXTURE21 : 0x84D5, 332 TEXTURE22 : 0x84D6, 333 TEXTURE23 : 0x84D7, 334 TEXTURE24 : 0x84D8, 335 TEXTURE25 : 0x84D9, 336 TEXTURE26 : 0x84DA, 337 TEXTURE27 : 0x84DB, 338 TEXTURE28 : 0x84DC, 339 TEXTURE29 : 0x84DD, 340 TEXTURE30 : 0x84DE, 341 TEXTURE31 : 0x84DF, 342 ACTIVE_TEXTURE : 0x84E0, 343 344 /* TextureWrapMode */ 345 REPEAT : 0x2901, 346 CLAMP_TO_EDGE : 0x812F, 347 MIRRORED_REPEAT : 0x8370, 348 349 /* Uniform Types */ 350 FLOAT_VEC2 : 0x8B50, 351 FLOAT_VEC3 : 0x8B51, 352 FLOAT_VEC4 : 0x8B52, 353 INT_VEC2 : 0x8B53, 354 INT_VEC3 : 0x8B54, 355 INT_VEC4 : 0x8B55, 356 BOOL : 0x8B56, 357 BOOL_VEC2 : 0x8B57, 358 BOOL_VEC3 : 0x8B58, 359 BOOL_VEC4 : 0x8B59, 360 FLOAT_MAT2 : 0x8B5A, 361 FLOAT_MAT3 : 0x8B5B, 362 FLOAT_MAT4 : 0x8B5C, 363 SAMPLER_2D : 0x8B5E, 364 SAMPLER_CUBE : 0x8B60, 365 366 /* Vertex Arrays */ 367 VERTEX_ATTRIB_ARRAY_ENABLED : 0x8622, 368 VERTEX_ATTRIB_ARRAY_SIZE : 0x8623, 369 VERTEX_ATTRIB_ARRAY_STRIDE : 0x8624, 370 VERTEX_ATTRIB_ARRAY_TYPE : 0x8625, 371 VERTEX_ATTRIB_ARRAY_NORMALIZED : 0x886A, 372 VERTEX_ATTRIB_ARRAY_POINTER : 0x8645, 373 VERTEX_ATTRIB_ARRAY_BUFFER_BINDING : 0x889F, 374 375 /* Read Format */ 376 IMPLEMENTATION_COLOR_READ_TYPE : 0x8B9A, 377 IMPLEMENTATION_COLOR_READ_FORMAT : 0x8B9B, 378 379 /* Shader Source */ 380 COMPILE_STATUS : 0x8B81, 381 382 /* Shader Precision-Specified Types */ 383 LOW_FLOAT : 0x8DF0, 384 MEDIUM_FLOAT : 0x8DF1, 385 HIGH_FLOAT : 0x8DF2, 386 LOW_INT : 0x8DF3, 387 MEDIUM_INT : 0x8DF4, 388 HIGH_INT : 0x8DF5, 389 390 /* Framebuffer Object. */ 391 FRAMEBUFFER : 0x8D40, 392 RENDERBUFFER : 0x8D41, 393 394 RGBA4 : 0x8056, 395 RGB5_A1 : 0x8057, 396 RGB565 : 0x8D62, 397 DEPTH_COMPONENT16 : 0x81A5, 398 STENCIL_INDEX8 : 0x8D48, 399 DEPTH_STENCIL : 0x84F9, 400 401 RENDERBUFFER_WIDTH : 0x8D42, 402 RENDERBUFFER_HEIGHT : 0x8D43, 403 RENDERBUFFER_INTERNAL_FORMAT : 0x8D44, 404 RENDERBUFFER_RED_SIZE : 0x8D50, 405 RENDERBUFFER_GREEN_SIZE : 0x8D51, 406 RENDERBUFFER_BLUE_SIZE : 0x8D52, 407 RENDERBUFFER_ALPHA_SIZE : 0x8D53, 408 RENDERBUFFER_DEPTH_SIZE : 0x8D54, 409 RENDERBUFFER_STENCIL_SIZE : 0x8D55, 410 411 FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE : 0x8CD0, 412 FRAMEBUFFER_ATTACHMENT_OBJECT_NAME : 0x8CD1, 413 FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL : 0x8CD2, 414 FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE : 0x8CD3, 415 416 COLOR_ATTACHMENT0 : 0x8CE0, 417 DEPTH_ATTACHMENT : 0x8D00, 418 STENCIL_ATTACHMENT : 0x8D20, 419 DEPTH_STENCIL_ATTACHMENT : 0x821A, 420 421 NONE : 0, 422 423 FRAMEBUFFER_COMPLETE : 0x8CD5, 424 FRAMEBUFFER_INCOMPLETE_ATTACHMENT : 0x8CD6, 425 FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT : 0x8CD7, 426 FRAMEBUFFER_INCOMPLETE_DIMENSIONS : 0x8CD9, 427 FRAMEBUFFER_UNSUPPORTED : 0x8CDD, 428 429 FRAMEBUFFER_BINDING : 0x8CA6, 430 RENDERBUFFER_BINDING : 0x8CA7, 431 MAX_RENDERBUFFER_SIZE : 0x84E8, 432 433 INVALID_FRAMEBUFFER_OPERATION : 0x0506, 434 435 /* WebGL-specific enums */ 436 UNPACK_FLIP_Y_WEBGL : 0x9240, 437 UNPACK_PREMULTIPLY_ALPHA_WEBGL : 0x9241, 438 CONTEXT_LOST_WEBGL : 0x9242, 439 UNPACK_COLORSPACE_CONVERSION_WEBGL : 0x9243, 440 BROWSER_DEFAULT_WEBGL : 0x9244 441 }; 442 443 // Other non-function properties on the WebGL object 444 var otherProperties = { 445 drawingBufferWidth : "number", 446 drawingBufferHeight : "number", 447 drawingBufferColorSpace : "string", 448 unpackColorSpace : "string", 449 canvas : "implementation-dependent" 450 }; 451 452 // Properties to be ignored (as a list of strings) because they were 453 // added in versions of the spec that are backward-compatible with 454 // this version 455 var ignoredProperties = [ 456 ]; 457 458 // Constants removed from the WebGL spec compared to ES 2.0 459 var removedConstants = { 460 NUM_COMPRESSED_TEXTURE_FORMATS : 0x86A2, 461 FIXED : 0x140C, 462 ACTIVE_UNIFORM_MAX_LENGTH : 0x8B87, 463 ACTIVE_ATTRIBUTE_MAX_LENGTH : 0x8B8A, 464 EXTENSIONS : 0x1F03, 465 INFO_LOG_LENGTH : 0x8B84, 466 SHADER_SOURCE_LENGTH : 0x8B88, 467 SHADER_COMPILER : 0x8DFA, 468 SHADER_BINARY_FORMATS : 0x8DF8, 469 NUM_SHADER_BINARY_FORMATS : 0x8DF9, 470 }; 471 472 function assertProperty(v, p) { 473 if (p in v) { 474 return true; 475 } else { 476 testFailed("Property does not exist: " + p) 477 return false; 478 } 479 } 480 481 function assertNoProperty(v, p) { 482 if (p in v) { 483 testFailed("Property is defined and should not be: " + p) 484 return false; 485 } else { 486 return true; 487 } 488 } 489 490 function assertMsg_(bool, msg) { 491 if (!bool) // show only failures to avoid spamming result list 492 assertMsg(bool, msg); 493 return bool; 494 } 495 496 debug(""); 497 debug("Canvas.getContext"); 498 499 var canvas = document.getElementById("canvas"); 500 var wtu = WebGLTestUtils; 501 var gl = wtu.create3DContext(canvas); 502 var passed = true; 503 for (var i in constants) { 504 var r = assertProperty(gl, i) && assertMsg_(gl[i] == constants[i], "Property "+i+" value test "+gl[i]+" == "+constants[i]); 505 passed = passed && r; 506 } 507 if (passed) { 508 testPassed("All WebGL constants found to have correct values."); 509 } 510 passed = true; 511 for (var i in removedConstants) { 512 var r = assertNoProperty(gl, i); 513 passed = passed && r; 514 } 515 if (passed) { 516 testPassed("All constants removed from WebGL spec were absent from WebGL context."); 517 } 518 var extended = false; 519 for (var i in gl) { 520 if (constants[i] !== undefined) { 521 // OK; known constant 522 } else if (ignoredProperties.indexOf(i) != -1) { 523 // OK; constant that should be ignored because it was added in a later version of the spec 524 } else if (otherProperties[i] !== undefined && 525 (otherProperties[i] == "implementation-dependent" || typeof gl[i] == otherProperties[i])) { 526 // OK; known property of known type 527 } else if (typeof gl[i] != "function" && removedConstants[i] === undefined) { 528 if (!extended) { 529 extended = true; 530 testFailed("Also found the following extra properties:"); 531 } 532 testFailed(i); 533 } 534 } 535 536 if (!extended) { 537 testPassed("No extra properties found on WebGL context."); 538 } 539 540 debug(""); 541 var successfullyParsed = true; 542 </script> 543 <script src="../../js/js-test-post.js"></script> 544 545 </body> 546 </html>