KhronosGroup / KhronosGroup/WebGL

Add non-normative note to multi-draw extensions about types of typed arrays

Open
#3,506 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
2.9k
Forks
704
Avg merge
2d 9h
Merged PRs (30d)
4

Description

On the webgl-dev-list a colleague just pointed out a performance hazard which affects the multi-draw extensions in particular due to the large numbers of typed arrays these APIs take:
https://groups.google.com/g/webgl-dev-list/c/ChKpSHZNbI8/m/p8-YTM0gCQAJ

We should add non-normative notes to the multi-draw extensions highlighting to users to exactly match the type of the typed array when calling the APIs (e.g. Int32Array and Uint32Array), or otherwise expensive conversions will be silently triggered.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the linked webgl-dev-list discussion and the multi-draw extension specifications or documentation. Add non-normative notes explaining that callers should match typed-array types such as Int32Array and Uint32Array to avoid expensive silent conversions; the work is done when the relevant multi-draw extensions contain this guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.