Optionalnotify: DestroyNotifyStatic$gtypeReturn a copy of size bytes from mem starting from offset. This copy is
guaranteed to be writable. size can be set to -1 to return a copy
from offset to the end of the memory region.
offset to copy from
size to copy, or -1 to copy to the end of the memory region
a new copy of mem if the copy succeeded, null otherwise.
Get the current size, offset and maxsize of mem.
the current size of mem
Check if mem1 and mem2 share the memory with a common parent memory object
and that the memory is contiguous.
If this is the case, the memory of mem1 and mem2 can be merged
efficiently by performing gst_memory_share() on the parent object from
the returned offset.
true if the memory is contiguous and of a common parent.
Check if mem if allocated with an allocator for mem_type.
a memory type
true if mem was allocated from an allocator for mem_type.
Create a Gst.Memory object that is mapped with flags. If mem is mappable
with flags, this function returns the mapped mem directly. Otherwise a
mapped copy of mem is returned.
This function takes ownership of old mem and returns a reference to a new
Gst.Memory.
a Gst.Memory object mapped with flags or null when a mapping is not possible.
Fill info with the pointer and sizes of the memory in mem that can be
accessed according to flags.
This function can return false for various reasons:
mem is not accessible with the given flags.info and its contents remain valid for as long as mem is valid and
until gst_memory_unmap() is called.
For each gst_memory_map() call, a corresponding gst_memory_unmap() call
should be done.
true if the map operation was successful.
Resize the memory region. mem should be writable and offset + size should be
less than the maxsize of mem.
#GST_MEMORY_FLAG_ZERO_PREFIXED and #GST_MEMORY_FLAG_ZERO_PADDED will be cleared when offset or padding is increased respectively.
a new offset
a new size
Return a shared copy of size bytes from mem starting from offset. No
memory copy is performed and the memory region is simply shared. The result
is guaranteed to be non-writable. size can be set to -1 to return a shared
copy from offset to the end of the memory region.
offset to share from
size to share, or -1 to share to the end of the memory region
a new Gst.Memory.
Staticnew_Optionalnotify: DestroyNotify
GstMemory is a lightweight refcounted object that wraps a region of memory. They are typically used to manage the data of a Gst.Buffer.
A GstMemory object has an allocated region of memory of maxsize. The maximum size does not change during the lifetime of the memory object. The memory also has an offset and size property that specifies the valid range of memory in the allocated region.
Memory is usually created by allocators with a
gst_allocator_alloc()method call. Whennullis used as the allocator, the default allocator will be used.New allocators can be registered with
gst_allocator_register(). Allocators are identified by name and can be retrieved withgst_allocator_find().gst_allocator_set_default()can be used to change the default allocator.New memory can be created with
gst_memory_new_wrapped()that wraps the memory allocated elsewhere.Refcounting of the memory block is performed with
gst_memory_ref()andgst_memory_unref().The size of the memory can be retrieved and changed with
gst_memory_get_sizes()andgst_memory_resize()respectively.Getting access to the data of the memory is performed with
gst_memory_map(). The call will return a pointer to offset bytes into the region of memory. After the memory access is completed,gst_memory_unmap()should be called.Memory can be copied with
gst_memory_copy(), which will return a writable copy.gst_memory_share()will create a new memory block that shares the memory with an existing memory block at a custom offset and with a custom size.Memory can be efficiently merged when
gst_memory_is_span()returnstrue.