Sets the pixels in a rectangular subregion of
texture from a Wayland SHM buffer.
Generally this would be used in response to wl_surface.damage event in a compositor in order to update the texture with the damaged region. This is just a convenience wrapper around getting the SHM buffer pointer and calling set_region. See that function for a description of the level parameter.
<note>Since the storage for a Texture is allocated lazily then if the given
texture has not previously been allocated then this api can return false and
throw an exceptional throws if there is not enough memory to allocate storage for
The X offset within the source bufer to copy from
The Y offset within the source bufer to copy from
The width of the region to copy
The height of the region to copy
The source buffer
The X offset within the texture to copy to
The Y offset within the texture to copy to
The mipmap level of the texture to copy to
true if the subregion upload was successful, and false otherwise