steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

gpu.buffers: "with-mapped-buffer-array" helper word that wraps a mapped GL buffer in a specialized-array for easy inspection

db4
Joe Groff 2010-05-14 16:54:06 -07:00
parent e32e0f1423
commit 20305432a9
2 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
extra/gpu/buffers/buffers-docs.factor
View File

@ -1,6 +1,6 @@
! (c)2009 Joe Groff bsd license ! (c)2009 Joe Groff bsd license
USING: alien byte-arrays destructors help.markup help.syntax kernel math USING: alien alien.data byte-arrays destructors help.markup help.syntax
quotations ; kernel math quotations ;
IN: gpu.buffers IN: gpu.buffers
HELP: <buffer-ptr> HELP: <buffer-ptr>
@ -207,6 +207,13 @@ HELP: with-mapped-buffer
} }
{ $description "Maps " { $snippet "buffer" } " into CPU address space with " { $snippet "access" } " for the dynamic extent of " { $snippet "quot" } ". " { $snippet "quot" } " is called with a pointer to the mapped memory on top of the stack." } ; { $description "Maps " { $snippet "buffer" } " into CPU address space with " { $snippet "access" } " for the dynamic extent of " { $snippet "quot" } ". " { $snippet "quot" } " is called with a pointer to the mapped memory on top of the stack." } ;
HELP: with-mapped-buffer-array
{ $values
{ "buffer" buffer } { "access" buffer-access-mode } { "c-type" "a C type" } { "quot" { $quotation "( ..a array -- ..b )" } }
}
{ $description "Maps " { $snippet "buffer" } " into CPU address space with " { $snippet "access" } " for the dynamic extent of " { $snippet "quot" } ". " { $snippet "quot" } " is called with the pointer to the mapped memory wrapped in a specialized array of " { $snippet "c-type" } "." }
{ $notes "The appropriate specialized array vocabulary must be loaded; otherwise, an error will be thrown. The vocabulary can be loaded with the " { $link require-c-array } " word. See the " { $vocab-link "specialized-arrays" } " vocabulary for details on the underlying sequence type constructed." } ;
{ allocate-buffer allocate-byte-array buffer-size update-buffer read-buffer copy-buffer with-mapped-buffer } related-words { allocate-buffer allocate-byte-array buffer-size update-buffer read-buffer copy-buffer with-mapped-buffer } related-words
HELP: write-access HELP: write-access
@ -240,7 +247,7 @@ ARTICLE: "gpu.buffers" "Buffer objects"
read-buffer read-buffer
copy-buffer copy-buffer
with-mapped-buffer with-mapped-buffer
} with-mapped-buffer-array
; } ;
ABOUT: "gpu.buffers" ABOUT: "gpu.buffers"

6
extra/gpu/buffers/buffers.factor
View File

@ -1,5 +1,5 @@
! (c)2009 Joe Groff bsd license ! (c)2009 Joe Groff bsd license
USING: accessors alien alien.c-types arrays byte-arrays USING: accessors alien alien.c-types alien.data arrays byte-arrays
combinators destructors gpu kernel locals math opengl opengl.gl combinators destructors gpu kernel locals math opengl opengl.gl
typed ui.gadgets.worlds variants ; typed ui.gadgets.worlds variants ;
IN: gpu.buffers IN: gpu.buffers
@ -140,6 +140,10 @@ TYPED:: copy-buffer ( to-buffer-ptr: buffer-ptr from-buffer-ptr: buffer-ptr size
target glUnmapBuffer drop ; inline target glUnmapBuffer drop ; inline
:: with-mapped-buffer-array ( ..a buffer access c-type quot: ( ..a array -- ..b ) -- ..b )
buffer buffer-size c-type heap-size /i :> len
buffer access [ len c-type <c-direct-array> quot call ] with-mapped-buffer ; inline
:: with-bound-buffer ( ..a buffer target quot: ( ..a -- ..b ) -- ..b ) :: with-bound-buffer ( ..a buffer target quot: ( ..a -- ..b ) -- ..b )
target gl-target buffer glBindBuffer target gl-target buffer glBindBuffer
quot call ; inline quot call ; inline