Improving precision in your vertex transform

WebGL and OpenGL ES do not support 64-bit math, but you can emulate it with some extra footwork in the vertex shader.

First of all, if you’re interested in this post, then you might be interested 3D Engine Design for Virtual Globes, a really neat book from Patrick Cozzi and Kevin Ring. It has an entire chapter about precision, and much more.

After some map imagery loads in, you’ll see two interactive WebGL canvases below. The blue crosshairs are located at a lookout point in César Chávez park, just north of the Berkeley Marina. This happens to be the favorite spot of my two kids, whom you can see if you zoom in far enough. Try zooming and panning as you would with Google Maps.

Loading...
Loading...

After zooming in enough to see my “kids”, you might notice that the left canvas has jittery crosshairs, but the right one doesn’t. The left canvas uses a traditional model-view-projection matrix, while the right canvas pretends that the camera is at (0,0,0) when computing the MVP, then performs translation manually in the vertex shader. The GLSL for this is shown below.

attribute vec3 a_position;
uniform mat4 u_mvp;
uniform vec3 u_eyepos;
uniform vec3 u_eyepos_lowpart;

void main()
{
    vec3 p = a_position - u_eyepos;
    p -= u_eyepos_lowpart;
    gl_Position = u_mvp * vec4(p, 1.0);
}

Note that we’re sending the eye position to the GPU using two uniforms: a high part and a low part. The following CPU-side code can be used to extract these two parts:

void split_double(double input, float* hipart, float* lopart)
{
    *hipart = (float) input;
    double delta = input - ((double) *hipart);
    *lopart = (float) delta;
}

If you’re using JavaScript instead of C, you might be able to use Float32Array to perform the double-to-float cast seen in the above snippet.

64-bit Vertices

So far we’ve only described how to handle 64-bit camera position, which is sufficient for the above demo. What if we need 64-bit vertices as well? Again, we can split each double into two floats before sending it to the GPU. This time it’s more costly, since the VBO will grow by 2x and the vertex shader will become a bit more complex.

I haven’t fully tested this, but here’s a GLSL port of the “double-single” routines used in the DSFUN90, an old math precision library based on the work of none other than Donald Knuth!

attribute vec3 a_position;
attribute vec3 a_position_lowpart;
uniform mat4 u_mvp;
uniform vec3 u_eyepos;
uniform vec3 u_eyepos_lowpart;

void main()
{
    vec3 t1 = a_position_lowpart - u_eyepos_lowpart;
    vec3 e = t1 - a_position_lowpart;
    vec3 t2 = ((-u_eyepos_lowpart - e) + (a_position_lowpart - (t1 - e))) + a_position - u_eyepos;
    vec3 high_delta = t1 + t2;
    vec3 low_delta = t2 - (high_delta - t1);
    vec3 p = high_delta + low_delta;
    gl_Position = u_mvp * vec4(p, 1.0);
}

Some Footnotes

The map demo on this page was built using a small C99 library that I’ve been working on, running it through Emscripten with the flags MODULARIZE=1 and PRECISE_F32=1. If you don’t use PRECISE_F32, then Emscripten will use doubles even for float variables, thus breaking the split_double code.

To obtain map textures for the demo, I used the really awesome Static maps API from mapbox.com.

References