Source code
Revision control
Copy as Markdown
Other Tools
<!--
Copyright (c) 2019 The Khronos Group Inc.
Use of this source code is governed by an MIT-style license that can be
found in the LICENSE.txt file.
-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>WebGL OES_texture_half_float Conformance Tests</title>
<link rel="stylesheet" href="../../resources/js-test-style.css"/>
<script src="../../js/js-test-pre.js"></script>
<script src="../../js/webgl-test-utils.js"></script>
</head>
<body>
<div id="description"></div>
<canvas id="canvas" style="width: 50px; height: 50px;"> </canvas>
<canvas id="canvas2d" style="width: 50px; height: 50px;"> </canvas>
<div id="console"></div>
<script id="testFragmentShader" type="x-shader/x-fragment">
precision mediump float;
uniform sampler2D tex;
uniform vec4 subtractor;
varying vec2 texCoord;
void main()
{
vec4 color = texture2D(tex, texCoord);
if (abs(color.r - subtractor.r) +
abs(color.g - subtractor.g) +
abs(color.b - subtractor.b) +
abs(color.a - subtractor.a) < 8.0) {
gl_FragColor = vec4(0.0, 1.0, 0.0, 1.0);
} else {
gl_FragColor = vec4(1.0, 0.0, 0.0, 1.0);
}
}
</script>
<!-- Shaders for testing half-floating-point render targets -->
<script id="floatingPointFragmentShader" type="x-shader/x-fragment">
void main()
{
gl_FragColor = vec4(10000.0, 10000.0, 10000.0, 10000.0);
}
</script>
<script>
"use strict"
description("This test verifies the functionality of OES_texture_half_float with null/non-null ArrayBufferView");
debug("");
var wtu = WebGLTestUtils;
var canvas = document.getElementById("canvas");
var colorCanvas = document.getElementById("canvas2d");
colorCanvas.width = 2;
colorCanvas.height = 2;
var ctx = colorCanvas.getContext("2d");
ctx.fillStyle = "rgb(255,0,0)";
ctx.fillRect(0, 0, 2, 2);
var gl = wtu.create3DContext(canvas);
// This constant must be defined in order to run the texture creation test without the extension enabled.
var halfFloatOESEnum = 0x8D61;
var ext = null;
if (!gl) {
testFailed("WebGL context does not exists");
} else {
testPassed("WebGL context exists");
// Verify that allocation of texture fails if extension is not enabled
runTextureCreationTest(false);
ext = gl.getExtension("OES_texture_half_float")
if (!ext) {
testPassed("No OES_texture_half_float support. This is legal");
} else {
testPassed("Successfully enabled OES_texture_half_float extension");
var program = wtu.setupTexturedQuad(gl);
// Check if creation of texture succeed's with various formats and null ArrayBufferView
var formats = [
{ format: gl.RGBA, expected: [255, 0, 0, 255], },
{ format: gl.RGB, expected: [255, 0, 0, 255], },
{ format: gl.LUMINANCE, expected: [255, 255, 255, 255], },
{ format: gl.ALPHA, expected: [ 0, 0, 0, 255], },
{ format: gl.LUMINANCE_ALPHA, expected: [255, 255, 255, 255], },
];
formats.forEach(function(f) {
runTextureCreationTest(true, f.format, null, f.expected);
});
// Texture creation should fail when passed with non-null, non-Uint16 ArrayBufferView
formats.forEach(function(f) {
var width = 2;
var height = 2;
var format = f.format;
// Float32Array
var float32Data = new Float32Array(width * height * getNumberOfChannels(format));
for (var ii = 0; ii < float32Data.length; ii++) {
float32Data[ii] = 1000;
}
runTextureCreationTest(true, format, float32Data, null);
// Int16Array
var int16Data = new Int16Array(width * height * getNumberOfChannels(format));
for (var ii = 0; ii < int16Data.length; ii++) {
int16Data[ii] = 1000;
}
runTextureCreationTest(true, format, int16Data, null);
});
// Test that Uint16 encoded half float values can be used as texture data.
// First test that values in the 0-1 range can be written and read.
var halfFloatOneThird = 0x3555; // Half float 1/3
var uint16Formats = [
{ format: gl.RGBA, expected: [85, 85, 85, 85], },
{ format: gl.RGB, expected: [85, 85, 85, 255], },
{ format: gl.LUMINANCE, expected: [85, 85, 85, 255], },
{ format: gl.ALPHA, expected: [ 0, 0, 0, 85], },
{ format: gl.LUMINANCE_ALPHA, expected: [85, 85, 85, 85], },
];
uint16Formats.forEach(function(f) {
var width = 2;
var height = 2;
var format = f.format;
var uint16Data = new Uint16Array(width * height * getNumberOfChannels(format));
for (var ii = 0; ii < uint16Data.length; ii++) {
uint16Data[ii] = halfFloatOneThird;
}
runTextureCreationTest(true, format, uint16Data, f.expected);
});
// Next check that values outside the 0-1 range can be written.
var halfFloatTenK = 0x70E2; // Half float 10000
var uint16Formats2 = [
{ format: gl.RGBA, subtractor: [10000, 10000, 10000, 10000], requireRenderable: true},
{ format: gl.RGB, subtractor: [10000, 10000, 10000, 1], requireRenderable: false},
];
uint16Formats2.forEach(function(f) {
var width = 2;
var height = 2;
var format = f.format;
var uint16Data = new Uint16Array(width * height * getNumberOfChannels(format));
for (var ii = 0; ii < uint16Data.length; ii++) {
uint16Data[ii] = halfFloatTenK;
}
runRenderTest(format, f.subtractor, uint16Data, f.requireRenderable);
});
(function() {
debug("");
var renderable = isRenderable(gl, ext);
var renderableExtName = "EXT_color_buffer_half_float";
var supported = gl.getSupportedExtensions().includes(renderableExtName);
if (renderable && !supported) {
testFailed("RGBA/HALF_FLOAT_OES is color renderable but " + renderableExtName + " not exposed");
} else if (supported && !renderable) {
testFailed(renderableExtName + " is exposed but RGBA/HALF_FLOAT_OES is not color renderable");
}
if (supported) {
runRenderTest(gl.RGBA, [10000, 10000, 10000, 10000], null, true);
runRenderTest(gl.RGB, [10000, 10000, 10000, 1], null, false);
runFramebufferTest();
}
})();
// Check of getExtension() returns same object
runUniqueObjectTest();
}
}
function isRenderable(gl, ext) {
var tex = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, tex);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, ext.HALF_FLOAT_OES, null);
var fb = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, fb);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, tex, 0);
var status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
gl.deleteFramebuffer(fb);
gl.deleteTexture(tex);
return status == gl.FRAMEBUFFER_COMPLETE;
}
function getNumberOfChannels(format)
{
if (format == gl.RGBA)
return 4;
else if (format == gl.RGB)
return 3;
else if (format == gl.LUMINANCE || format == gl.ALPHA)
return 1;
else if (format == gl.LUMINANCE_ALPHA)
return 2;
}
function allocateTexture()
{
var texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "texture parameter setup should succeed");
return texture;
}
function runTextureCreationTest(extensionEnabled, opt_format, opt_data, opt_expected)
{
var format = opt_format || gl.RGBA;
var data = opt_data || null;
var expectSuccess = true;
if (!extensionEnabled || !opt_expected)
expectSuccess = false;
debug("Testing texture creation with extension " + (extensionEnabled ? "enabled" : "disabled") +
", format " + wtu.glEnumToString(gl, format) + ", and data " + (data ? "non-null" : "null") +
". Expect " + (expectSuccess ? "Success" : "Failure"));
var texture = allocateTexture();
var width = 2;
var height = 2;
gl.texImage2D(gl.TEXTURE_2D, 0, format, width, height, 0, format, halfFloatOESEnum, data);
if(!extensionEnabled) {
wtu.glErrorShouldBe(gl, gl.INVALID_ENUM, "Half floating point texture must be disallowed if OES_texture_half_float isn't enabled");
return;
} else if (!opt_expected) {
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "Half floating point texture allocation must be disallowed when ArrayBufferView is not-null and not-Uint16");
return;
} else {
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "Half floating point texture allocation should succeed if OES_texture_half_float is enabled");
if (!data) {
gl.texImage2D(gl.TEXTURE_2D, 0, format, format, halfFloatOESEnum, colorCanvas);
}
wtu.clearAndDrawUnitQuad(gl);
wtu.checkCanvas(gl, opt_expected);
// Check that linear fails.
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
wtu.clearAndDrawUnitQuad(gl);
wtu.checkCanvas(gl, [0, 0, 0, 255], "should be black");
}
}
function checkRenderingResults()
{
wtu.checkCanvas(gl, [0, 255, 0, 255], "should be green");
}
function runRenderTest(format, subtractor, data, requireRenderable)
{
var formatString = wtu.glEnumToString(gl, format);
debug("");
if (!data) {
debug("Testing half floating point " + formatString + " render target");
} else {
debug("Testing half floating point " + formatString + " from a Uint16Array");
}
var texture = allocateTexture();
var width = 2;
var height = 2;
gl.texImage2D(gl.TEXTURE_2D, 0, format, width, height, 0, format, ext.HALF_FLOAT_OES, data);
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "Half floating point texture allocation should succeed if OES_texture_half_float is enabled");
if (!data) {
// Try to use this texture as render target
var fbo = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
gl.bindTexture(gl.TEXTURE_2D, null);
// It is legal for a WebGL implementation exposing the OES_texture_half_float extension to
// support half floating point textures but not as attachments to framebuffer objects.
if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) != gl.FRAMEBUFFER_COMPLETE) {
if (requireRenderable) {
testFailed(formatString + " render targets not supported.");
} else {
debug(formatString + " render targets not supported -- this is legal");
}
return;
}
var renderProgram =
wtu.setupProgram(gl,
[wtu.simpleVertexShader, "floatingPointFragmentShader"],
['vPosition'],
[0]);
wtu.drawUnitQuad(gl);
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "Rendering to half floating point texture should succeed");
}
// Now sample from the half floating-point texture and verify we got the correct values.
var texturedShaders = [
wtu.simpleTextureVertexShader,
"testFragmentShader"
];
var testProgram =
wtu.setupProgram(gl,
[wtu.simpleTextureVertexShader, "testFragmentShader"],
['vPosition', 'texCoord0'],
[0, 1]);
var quadParameters = wtu.setupUnitQuad(gl, 0, 1);
gl.bindFramebuffer(gl.FRAMEBUFFER, null);
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.useProgram(testProgram);
gl.uniform4fv(gl.getUniformLocation(testProgram, "subtractor"), subtractor);
wtu.drawUnitQuad(gl);
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "rendering from half floating point texture should succeed");
checkRenderingResults();
}
function runUniqueObjectTest()
{
debug("");
debug("Testing that getExtension() returns the same object each time");
ext = null;
gl.getExtension("OES_texture_half_float").myProperty = 2;
webglHarnessCollectGarbage();
shouldBe('gl.getExtension("OES_texture_half_float").myProperty', '2');
}
// Make sure we can call readPixels with the passed in arrayBufferConstructor and that the color
// channels are the ones we expect. If there is a mismatch between the glType and arrayBuffer type,
// fail the test.
function verifyReadPixelsColors(red, green, blue, alpha, alphaRGB, glFormat, glType, arrayBufferConstructor) {
var typeName = wtu.glEnumToString(gl, glType);
debug(wtu.glEnumToString(gl, glFormat) + " framebuffer with " + typeName + " readback.");
var arrayBuffer = new arrayBufferConstructor(4);
gl.readPixels(0, 0, 1, 1, gl.RGBA, glType, arrayBuffer);
wtu.glErrorShouldBe(gl, gl.NO_ERROR, "readPixels should return NO_ERROR when reading " + typeName + " data.");
assertMsg(arrayBuffer[0] === red, "Red channel should be " + red + " for " + typeName + " readPixels. Received: " + arrayBuffer[0]);
assertMsg(arrayBuffer[1] === green, "Green channel should be " + green + " for " + typeName + " readPixels. Received: " + arrayBuffer[1]);
assertMsg(arrayBuffer[2] === blue, "Blue channel should be " + blue + " for " + typeName + " readPixels. Received: " + arrayBuffer[2]);
if (glFormat === gl.RGBA) {
assertMsg(arrayBuffer[3] === alpha, "Alpha channel should be " + alpha + " for " + typeName + " readPixels. Received: " + arrayBuffer[3]);
} else if (glFormat === gl.RGB) {
assertMsg(arrayBuffer[3] === alphaRGB, "Alpha channel should be " + alphaRGB + " for " + typeName + " readPixels. Received: " + arrayBuffer[3]);
}
// Make sure any arrayBuffer types that are not equal to arrayBufferConstructor fail readPixels.
if (arrayBufferConstructor !== Uint8Array) {
arrayBuffer = new Uint8Array(4);
gl.readPixels(0, 0, 1, 1, gl.RGBA, glType, arrayBuffer);
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "readPixels should return INVALID_OPERATION when reading mismatched types. " + Uint8Array.toString());
}
if (arrayBufferConstructor !== Float32Array) {
arrayBuffer = new Float32Array(4);
gl.readPixels(0, 0, 1, 1, gl.RGBA, glType, arrayBuffer);
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "readPixels should return INVALID_OPERATION when reading mismatched types. " + Float32Array.toString());
}
if (arrayBufferConstructor !== Uint16Array) {
arrayBuffer = new Uint16Array(4);
gl.readPixels(0, 0, 1, 1, gl.RGBA, glType, arrayBuffer);
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "readPixels should return INVALID_OPERATION when reading mismatched types. " + Uint16Array.toString());
}
}
// Verify that half float textures attached to frame buffers function correctly with regard to framebuffer
// completness, IMPLEMENTATION_COLOR_READ_FORMAT/TYPE and readPixels
function runFramebufferTest() {
debug("");
debug("Framebuffer Tests");
var texture = allocateTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
var fbo = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
debug("Ensure non-color-renderable formats [LUMINANCE, LUMINANCE_ALPHA, ALPHA] fail.");
var arrayBufferFloatOutput = new Float32Array(4); // 4 color channels
[gl.LUMINANCE, gl.LUMINANCE_ALPHA, gl.ALPHA].forEach(function(badFormat) {
debug(wtu.glEnumToString(gl, badFormat) + " framebuffer");
gl.texImage2D(gl.TEXTURE_2D, 0, badFormat, 1, 1, 0, badFormat, ext.HALF_FLOAT_OES, null);
shouldBe("gl.checkFramebufferStatus(gl.FRAMEBUFFER)", "gl.FRAMEBUFFER_INCOMPLETE_ATTACHMENT");
shouldBeNull("gl.getParameter(gl.IMPLEMENTATION_COLOR_READ_FORMAT)");
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "IMPLEMENTATION_COLOR_READ_FORMAT should fail for incomplete framebuffers.");
shouldBeNull("gl.getParameter(gl.IMPLEMENTATION_COLOR_READ_TYPE)");
wtu.glErrorShouldBe(gl, gl.INVALID_OPERATION, "IMPLEMENTATION_COLOR_READ_TYPE should fail for incomplete framebuffers.");
gl.readPixels(0, 0, 1, 1, gl.RGBA, gl.FLOAT, arrayBufferFloatOutput);
wtu.glErrorShouldBe(gl, gl.INVALID_FRAMEBUFFER_OPERATION , "readPixels should fail on incomplete framebuffers.");
debug("");
});
debug("Ensure color renderable formats [RGBA, RGB] succeed.");
var arrayBufferHalfFloatInput = new Uint16Array(4); // 4 color channels
arrayBufferHalfFloatInput[0] = 0; // 0 in half float
arrayBufferHalfFloatInput[1] = 0x3400; // 0.25 in half float
arrayBufferHalfFloatInput[2] = 0x3800; // 0.50 in half float
arrayBufferHalfFloatInput[3] = 0x3A00; // 0.75 in half float
[gl.RGBA, gl.RGB].forEach(function(goodFormat) {
debug(wtu.glEnumToString(gl, goodFormat) + " framebuffer tests");
debug("");
gl.texImage2D(gl.TEXTURE_2D, 0, goodFormat, 1, 1, 0, goodFormat, ext.HALF_FLOAT_OES, arrayBufferHalfFloatInput);
if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) == gl.FRAMEBUFFER_COMPLETE) {
// Per the OES_color_buffer_half_float, RGBA/FLOAT should always succeed for readPixels
verifyReadPixelsColors(
0.00, // red
0.25, // green
0.50, // blue
0.75, // alpha
1.0, // alphaRGB
goodFormat,
gl.FLOAT,
Float32Array);
var implementationColorReadFormat = gl.getParameter(gl.IMPLEMENTATION_COLOR_READ_FORMAT);
assertMsg(implementationColorReadFormat === gl.RGBA || implementationColorReadFormat === gl.RGB,
"IMPLEMENTATION_COLOR_READ_FORMAT should be color renderable: RGBA or RGB. Received: " + wtu.glEnumToString(gl, implementationColorReadFormat));
var implementationColorReadType = gl.getParameter(gl.IMPLEMENTATION_COLOR_READ_TYPE);
// There is nothing in the specifications that keeps the
// implementation color read format and type from being the
// same as the implicitly supported one. For this reason, keep
// gl.FLOAT as one of the valid options.
assertMsg(implementationColorReadType === gl.UNSIGNED_BYTE ||
implementationColorReadType === gl.FLOAT ||
implementationColorReadType === ext.HALF_FLOAT_OES ||
implementationColorReadType === gl.UNSIGNED_SHORT_4_4_4_4 ||
implementationColorReadType === gl.UNSIGNED_SHORT_5_5_5_1 ||
implementationColorReadType === gl.UNSIGNED_SHORT_5_6_5,
"IMPLEMENTATION_COLOR_READ_TYPE must be one of UNSIGNED_BYTE, UNSIGNED_SHORT_4_4_4_4, UNSIGNED_SHORT_5_5_5_1, UNSIGNED_SHORT_5_6_5, FLOAT, or HALF_FLOAT_OES. " +
"Received: " + wtu.glEnumToString(gl, implementationColorReadType));
// Test the RGBA/HALF_FLOAT_OES combination
if (implementationColorReadFormat === gl.RGBA && implementationColorReadType === ext.HALF_FLOAT_OES) {
verifyReadPixelsColors(
0, // red
0x3400, // green
0x3800, // blue
0x3A00, // alpha
0x3C00, // alphaRGB
goodFormat,
ext.HALF_FLOAT_OES,
Uint16Array);
}
}
debug("");
});
}
debug("");
var successfullyParsed = true;
</script>
<script src="../../js/js-test-post.js"></script>
</body>
</html>