Difference between revisions of "love.data.newDataView"

m
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{newin|[[0.11.0]]|110|type=function}}
+
{{newin|[[11.0]]|110|type=function}}
 
Creates a new Data referencing a subsection of an existing Data object.
 
Creates a new Data referencing a subsection of an existing Data object.
 
  {{newobjectnotice}}
 
  {{newobjectnotice}}
Line 15: Line 15:
  
 
== Notes ==
 
== Notes ==
[[Data:getString]] and [[Data:getPointer]] will return the original Data object's contents, with the view's offset and size applied.
+
[[Data:getString]], [[Data:getPointer]] and [[Data:getFFIPointer]] will return the original Data object's contents, with the view's offset and size applied where applicable.
  
 
== See Also ==
 
== See Also ==

Latest revision as of 13:46, 10 June 2023

Available since LÖVE 11.0
This function is not supported in earlier versions.

Creates a new Data referencing a subsection of an existing Data object.

O.png This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!  



Function

Synopsis

view = love.data.newDataView( data, offset, size )

Arguments

Data data
The Data object to reference.
number offset
The offset of the subsection to reference, in bytes.
number size
The size in bytes of the subsection to reference.

Returns

Data view
The new Data view.

Notes

Data:getString, Data:getPointer and Data:getFFIPointer will return the original Data object's contents, with the view's offset and size applied where applicable.

See Also

Other Languages