drawType in example conflicts with docs and type annotation

[bchirlsbiodigital]

Refer to the following code from the dynamic buffers example:

    const arrays = {
      spread: { data: spreadArray, numComponents: 1 },
      height: { data: heightArray, numComponents: 1, drawType: gl.DYNAMIC_DRAW },
    };
    const bufferInfo = twgl.createBufferInfoFromArrays(gl, arrays);

If I'm following the documentation correctly, each array passed to createBufferInfoFromArrays should be an ArraySpec, which does not include the drawType property. It looks like the function does actually use the property, so I think it's the docs/types that are incomplete not the example.

Could you please clarify here or update the example, docs or types to reflect the proper way to set drawType on an attribute?

Thanks!

[greggman]

drawType is optional

twgl.js/src/attributes.js

Line 204 in 42291da

* @property {number} [drawType] the draw type passed to gl.bufferData. Default = gl.STATIC_DRAW

if it's not specified twgl will use STATIC_DRAW

twgl.js/src/attributes.js

Line 90 in 42291da

gl.bufferData(type, array, drawType || STATIC_DRAW);

It's copied to the attribute info you linked to but if it's not set it will still be undefined and so still use STATIC_DRAW.

As for why set it, it's a hint to WebGL that you're going to update the buffer often, 'hint' means it's not required as it's only a hint.