Skip to content

Add the buffer mapping explainer #1600

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kvark merged 4 commits into from
Apr 8, 2021
Merged

Add the buffer mapping explainer #1600

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1e812b8
Add the buffer mapping explainer
Kangz Apr 6, 2021
70c65be
explainer: use data-no-idl to prevent IDL parsing
kainino0x Apr 6, 2021
b66d756
use highlight=idl instead of class=idl to prevent generating idl index
kainino0x Apr 6, 2021
a335282
Address @kvark's comments
Kangz Apr 8, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
use highlight=idl instead of class=idl to prevent generating idl index
  • Loading branch information
@kainino0x
kainino0x committed Apr 6, 2021
commit b66d75685e3304df8b92d7071caf3a20b3103551
6 changes: 3 additions & 3 deletions explainer/index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -251,7 +251,7 @@ When an application requests to map a buffer, it initiates a transfer of the buf
At this time, the GPU may still need to finish executing some operations that use the buffer, so the transfer doesn't complete until all previously-enqueued GPU operations are finished.
That's why mapping a buffer is an asynchronous operation (we'll discuss the other arguments below):

<xmp class=idl data-no-idl>
<xmp highlight=idl>
typedef [EnforceRange] unsigned long GPUMapModeFlags;
interface GPUMapMode {
const GPUFlagsConstant READ = 0x0001;
Expand Down Expand Up @@ -283,7 +283,7 @@ partial interface GPUBuffer {
Once the application has finished using the buffer on the CPU, it can transfer ownership back to the GPU by unmapping it.
This is an immediate operation that makes the application lose all access to the buffer on the CPU (i.e. detaches `ArrayBuffers`):

<xmp class=idl data-no-idl>
<xmp highlight=idl>
partial interface GPUBuffer {
undefined unmap();
};
Expand Down Expand Up @@ -340,7 +340,7 @@ This way the browser knows which parts of the underlying `GPUBuffer` have been "

The range must be within the range requested in `mapAsync()`.

<xmp class=idl data-no-idl>
<xmp highlight=idl>
partial interface GPUBuffer {
ArrayBuffer getMappedRange(optional GPUSize64 offset = 0,
optional GPUSize64 size);
Expand Down