GI.Gst.Structs.Buffer

Buffers are the basic unit of data transfer in GStreamer. They contain the timing and offset along with other arbitrary metadata that is associated with the Memory blocks that the buffer contains.

Buffers are usually created with bufferNew. After a buffer has been created one will typically allocate memory for it and add it to the buffer. The following example creates a buffer that can hold a given video frame with a given width, height and bits per plane.

C code

 GstBuffer *buffer;
 GstMemory *memory;
 gint size, width, height, bpp;
 ...
 size = width * height * bpp;
 buffer = gst_buffer_new ();
 memory = gst_allocator_alloc (NULL, size, NULL);
 gst_buffer_insert_memory (buffer, -1, memory);
 ...

Alternatively, use bufferNewAllocate to create a buffer with preallocated data of a given size.

Buffers can contain a list of Memory objects. You can retrieve how many memory objects with bufferNMemory and you can get a pointer to memory with bufferPeekMemory

A buffer will usually have timestamps, and a duration, but neither of these are guaranteed (they may be set to CLOCK_TIME_NONE). Whenever a meaningful value can be given for these, they should be set. The timestamps and duration are measured in nanoseconds (they are GstClockTime values).

The buffer DTS refers to the timestamp when the buffer should be decoded and is usually monotonically increasing. The buffer PTS refers to the timestamp when the buffer content should be presented to the user and is not always monotonically increasing.

A buffer can also have one or both of a start and an end offset. These are media-type specific. For video buffers, the start offset will generally be the frame number. For audio buffers, it will be the number of samples produced so far. For compressed data, it could be the byte offset in a source or destination file. Likewise, the end offset will be the offset of the end of the buffer. These can only be meaningfully interpreted if you know the media type of the buffer (the preceding CAPS event). Either or both can be set to BUFFER_OFFSET_NONE.

gst_buffer_ref() is used to increase the refcount of a buffer. This must be done when you want to keep a handle to the buffer after pushing it to the next element. The buffer refcount determines the writability of the buffer, a buffer is only writable when the refcount is exactly 1, i.e. when the caller has the only reference to the buffer.

To efficiently create a smaller buffer out of an existing one, you can use bufferCopyRegion. This method tries to share the memory objects between the two buffers.

If a plug-in wants to modify the buffer data or metadata in-place, it should first obtain a buffer that is safe to modify by using gst_buffer_make_writable(). This function is optimized so that a copy will only be made when it is necessary.

Several flags of the buffer can be set and unset with the GST_BUFFER_FLAG_SET() and GST_BUFFER_FLAG_UNSET() macros. Use GST_BUFFER_FLAG_IS_SET() to test if a certain BufferFlags flag is set.

Buffers can be efficiently merged into a larger buffer with bufferAppend. Copying of memory will only be done when absolutely needed.

Arbitrary extra metadata can be set on a buffer with bufferAddMeta. Metadata can be retrieved with bufferGetMeta. See also Meta

An element should either unref the buffer or push it out on a src pad using padPush (see Pad).

Buffers are usually freed by unreffing them with gst_buffer_unref(). When the refcount drops to 0, any memory and metadata pointed to by the buffer is unreffed as well. Buffers allocated from a BufferPool will be returned to the pool when the refcount drops to 0.

The ParentBufferMeta is a meta which can be attached to a Buffer to hold a reference to another buffer that is only released when the child Buffer is released.

Typically, ParentBufferMeta is used when the child buffer is directly using the Memory of the parent buffer, and wants to prevent the parent buffer from being returned to a buffer pool until the Memory is available for re-use. (Since 1.6)

Exported types

newtype Buffer

Constructors

Buffer (ManagedPtr Buffer)

Instances

BoxedObject Buffer

Methods

boxedType :: Buffer -> IO GType

(~) AttrOpTag tag AttrSet => Constructible Buffer tag

Methods

new :: MonadIO m => (ManagedPtr Buffer -> Buffer) -> [AttrOp Buffer tag] -> m Buffer

((~) * info (ResolveBufferMethod t Buffer), MethodInfo * info Buffer p) => IsLabel t (Buffer -> p)

Methods

fromLabel :: Proxy# Symbol t -> Buffer -> p

((~) * info (ResolveBufferMethod t Buffer), MethodInfo * info Buffer p) => IsLabelProxy t (Buffer -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> Buffer -> p

HasAttributeList * Buffer

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferUnsetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferUnsetFlagsMethodInfo Buffer -> signature -> s

((~) * signature (MapInfo -> m ()), MonadIO m) => MethodInfo * BufferUnmapMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferUnmapMethodInfo Buffer -> signature -> s

((~) * signature (Int64 -> m ()), MonadIO m) => MethodInfo * BufferSetSizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferSetSizeMethodInfo Buffer -> signature -> s

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferSetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferSetFlagsMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> Int64 -> Int64 -> m Bool), MonadIO m) => MethodInfo * BufferResizeRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferResizeRangeMethodInfo Buffer -> signature -> s

((~) * signature (Int64 -> Int64 -> m ()), MonadIO m) => MethodInfo * BufferResizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferResizeMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceMemoryRangeMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceAllMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Meta -> m Bool), MonadIO m) => MethodInfo * BufferRemoveMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMetaMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> m ()), MonadIO m) => MethodInfo * BufferRemoveMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMemoryRangeMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> m ()), MonadIO m) => MethodInfo * BufferRemoveMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMemoryMethodInfo Buffer -> signature -> s

((~) * signature (m ()), MonadIO m) => MethodInfo * BufferRemoveAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveAllMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferPrependMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferPrependMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> m Memory), MonadIO m) => MethodInfo * BufferPeekMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferPeekMemoryMethodInfo Buffer -> signature -> s

((~) * signature (m Word32), MonadIO m) => MethodInfo * BufferNMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferNMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> Word8 -> Word64 -> m Word64), MonadIO m) => MethodInfo * BufferMemsetMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMemsetMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> ByteString -> m Int32), MonadIO m) => MethodInfo * BufferMemcmpMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMemcmpMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> [MapFlags] -> m (Bool, MapInfo)), MonadIO m) => MethodInfo * BufferMapRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMapRangeMethodInfo Buffer -> signature -> s

((~) * signature ([MapFlags] -> m (Bool, MapInfo)), MonadIO m) => MethodInfo * BufferMapMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMapMethodInfo Buffer -> signature -> s

((~) * signature (Ptr () -> m (Maybe Meta)), MonadIO m) => MethodInfo * BufferIterateMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIterateMetaMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> m Bool), MonadIO m) => MethodInfo * BufferIsMemoryRangeWritableMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIsMemoryRangeWritableMethodInfo Buffer -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * BufferIsAllMemoryWritableMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIsAllMemoryWritableMethodInfo Buffer -> signature -> s

((~) * signature (Int32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferInsertMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferInsertMemoryMethodInfo Buffer -> signature -> s

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferHasFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferHasFlagsMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> m (Word64, Word64, Word64)), MonadIO m) => MethodInfo * BufferGetSizesRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizesRangeMethodInfo Buffer -> signature -> s

((~) * signature (m (Word64, Word64, Word64)), MonadIO m) => MethodInfo * BufferGetSizesMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizesMethodInfo Buffer -> signature -> s

((~) * signature (m Word64), MonadIO m) => MethodInfo * BufferGetSizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizeMethodInfo Buffer -> signature -> s

((~) * signature (GType -> m (Maybe Meta)), MonadIO m) => MethodInfo * BufferGetMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMetaMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> Int32 -> m Memory), MonadIO m) => MethodInfo * BufferGetMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMemoryRangeMethodInfo Buffer -> signature -> s

((~) * signature (Word32 -> m Memory), MonadIO m) => MethodInfo * BufferGetMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMemoryMethodInfo Buffer -> signature -> s

((~) * signature (m [BufferFlags]), MonadIO m) => MethodInfo * BufferGetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetFlagsMethodInfo Buffer -> signature -> s

((~) * signature (m Memory), MonadIO m) => MethodInfo * BufferGetAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetAllMemoryMethodInfo Buffer -> signature -> s

((~) * signature (BufferForeachMetaFunc -> m Bool), MonadIO m) => MethodInfo * BufferForeachMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferForeachMetaMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> Word64 -> m (Bool, Word32, Word32, Word64)), MonadIO m) => MethodInfo * BufferFindMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferFindMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> ByteString -> m Word64), MonadIO m) => MethodInfo * BufferFillMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferFillMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> Word64 -> m ByteString), MonadIO m) => MethodInfo * BufferExtractDupMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferExtractDupMethodInfo Buffer -> signature -> s

((~) * signature (Word64 -> Ptr () -> Word64 -> m Word64), MonadIO m) => MethodInfo * BufferExtractMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferExtractMethodInfo Buffer -> signature -> s

((~) * signature ([BufferCopyFlags] -> Word64 -> Word64 -> m Buffer), MonadIO m) => MethodInfo * BufferCopyRegionMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyRegionMethodInfo Buffer -> signature -> s

((~) * signature (Buffer -> [BufferCopyFlags] -> Word64 -> Word64 -> m Bool), MonadIO m) => MethodInfo * BufferCopyIntoMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyIntoMethodInfo Buffer -> signature -> s

((~) * signature (m Buffer), MonadIO m) => MethodInfo * BufferCopyDeepMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyDeepMethodInfo Buffer -> signature -> s

((~) * signature (Buffer -> Int64 -> Int64 -> m Buffer), MonadIO m) => MethodInfo * BufferAppendRegionMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendRegionMethodInfo Buffer -> signature -> s

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferAppendMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendMemoryMethodInfo Buffer -> signature -> s

((~) * signature (Buffer -> m Buffer), MonadIO m) => MethodInfo * BufferAppendMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendMethodInfo Buffer -> signature -> s

((~) * signature (Structure -> m ProtectionMeta), MonadIO m) => MethodInfo * BufferAddProtectionMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddProtectionMetaMethodInfo Buffer -> signature -> s

((~) * signature (Buffer -> m ParentBufferMeta), MonadIO m) => MethodInfo * BufferAddParentBufferMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddParentBufferMetaMethodInfo Buffer -> signature -> s

((~) * signature (MetaInfo -> Ptr () -> m Meta), MonadIO m) => MethodInfo * BufferAddMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddMetaMethodInfo Buffer -> signature -> s

type AttributeList Buffer

type AttributeList Buffer

newZeroBuffer :: MonadIO m => m Buffer

Construct a Buffer struct initialized to zero.

noBuffer :: Maybe Buffer

Methods

addMeta

data BufferAddMetaMethodInfo

Instances

((~) * signature (MetaInfo -> Ptr () -> m Meta), MonadIO m) => MethodInfo * BufferAddMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddMetaMethodInfo Buffer -> signature -> s

bufferAddMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> MetaInfo

info: a MetaInfo

-> Ptr ()

params: params for info

-> m Meta

Returns: the metadata for the api in info on buffer.

Add metadata for info to buffer using the parameters in params.

addParentBufferMeta

data BufferAddParentBufferMetaMethodInfo

Instances

((~) * signature (Buffer -> m ParentBufferMeta), MonadIO m) => MethodInfo * BufferAddParentBufferMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddParentBufferMetaMethodInfo Buffer -> signature -> s

bufferAddParentBufferMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> Buffer

ref: a Buffer to ref

-> m ParentBufferMeta

Returns: The ParentBufferMeta that was added to the buffer

Add a ParentBufferMeta to buffer that holds a reference on ref until the buffer is freed.

Since: 1.6

addProtectionMeta

data BufferAddProtectionMetaMethodInfo

Instances

((~) * signature (Structure -> m ProtectionMeta), MonadIO m) => MethodInfo * BufferAddProtectionMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAddProtectionMetaMethodInfo Buffer -> signature -> s

bufferAddProtectionMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: Buffer holding an encrypted sample, to which protection metadata should be added.

-> Structure

info: a Structure holding cryptographic information relating to the sample contained in buffer. This function takes ownership of info.

-> m ProtectionMeta

Returns: a pointer to the added ProtectionMeta if successful; Nothing if unsuccessful.

Attaches protection metadata to a Buffer.

Since: 1.6

append

data BufferAppendMethodInfo

Instances

((~) * signature (Buffer -> m Buffer), MonadIO m) => MethodInfo * BufferAppendMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendMethodInfo Buffer -> signature -> s

bufferAppend

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buf1: the first source Buffer to append.

-> Buffer

buf2: the second source Buffer to append.

-> m Buffer

Returns: the new Buffer that contains the memory of the two source buffers.

Append all the memory from buf2 to buf1. The result buffer will contain a concatenation of the memory of buf1 and buf2.

appendMemory

data BufferAppendMemoryMethodInfo

Instances

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferAppendMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendMemoryMethodInfo Buffer -> signature -> s

bufferAppendMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Memory

mem: a Memory.

-> m ()

Append the memory block mem to buffer. This function takes ownership of mem and thus doesn't increase its refcount.

This function is identical to bufferInsertMemory with an index of -1. See bufferInsertMemory for more details.

appendRegion

data BufferAppendRegionMethodInfo

Instances

((~) * signature (Buffer -> Int64 -> Int64 -> m Buffer), MonadIO m) => MethodInfo * BufferAppendRegionMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferAppendRegionMethodInfo Buffer -> signature -> s

bufferAppendRegion

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buf1: the first source Buffer to append.

-> Buffer

buf2: the second source Buffer to append.

-> Int64

offset: the offset in buf2

-> Int64

size: the size or -1 of buf2

-> m Buffer

Returns: the new Buffer that contains the memory of the two source buffers.

Append size bytes at offset from buf2 to buf1. The result buffer will contain a concatenation of the memory of buf1 and the requested region of buf2.

copyDeep

data BufferCopyDeepMethodInfo

Instances

((~) * signature (m Buffer), MonadIO m) => MethodInfo * BufferCopyDeepMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyDeepMethodInfo Buffer -> signature -> s

bufferCopyDeep

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buf: a Buffer.

-> m Buffer

Returns: a new copy of buf.

Create a copy of the given buffer. This will make a newly allocated copy of the data the source buffer contains.

Since: 1.6

copyInto

data BufferCopyIntoMethodInfo

Instances

((~) * signature (Buffer -> [BufferCopyFlags] -> Word64 -> Word64 -> m Bool), MonadIO m) => MethodInfo * BufferCopyIntoMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyIntoMethodInfo Buffer -> signature -> s

bufferCopyInto

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

dest: a destination Buffer

-> Buffer

src: a source Buffer

-> [BufferCopyFlags]

flags: flags indicating what metadata fields should be copied.

-> Word64

offset: offset to copy from

-> Word64

size: total size to copy. If -1, all data is copied.

-> m Bool

Returns: True if the copying succeeded, False otherwise.

Copies the information from src into dest.

If dest already contains memory and flags contains GST_BUFFER_COPY_MEMORY, the memory from src will be appended to dest.

flags indicate which fields will be copied.

copyRegion

data BufferCopyRegionMethodInfo

Instances

((~) * signature ([BufferCopyFlags] -> Word64 -> Word64 -> m Buffer), MonadIO m) => MethodInfo * BufferCopyRegionMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferCopyRegionMethodInfo Buffer -> signature -> s

bufferCopyRegion

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

parent: a Buffer.

-> [BufferCopyFlags]

flags: the BufferCopyFlags

-> Word64

offset: the offset into parent Buffer at which the new sub-buffer begins.

-> Word64

size: the size of the new Buffer sub-buffer, in bytes. If -1, all data is copied.

-> m Buffer

Returns: the new Buffer or Nothing if the arguments were invalid.

Creates a sub-buffer from parent at offset and size. This sub-buffer uses the actual memory space of the parent buffer. This function will copy the offset and timestamp fields when the offset is 0. If not, they will be set to CLOCK_TIME_NONE and BUFFER_OFFSET_NONE. If offset equals 0 and size equals the total size of buffer, the duration and offset end fields are also copied. If not they will be set to CLOCK_TIME_NONE and BUFFER_OFFSET_NONE.

MT safe.

extract

data BufferExtractMethodInfo

Instances

((~) * signature (Word64 -> Ptr () -> Word64 -> m Word64), MonadIO m) => MethodInfo * BufferExtractMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferExtractMethodInfo Buffer -> signature -> s

bufferExtract

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word64

offset: the offset to extract

-> Ptr ()

dest: the destination address

-> Word64

size: the size to extract

-> m Word64

Returns: The amount of bytes extracted. This value can be lower than size when buffer did not contain enough data.

Copy size bytes starting from offset in buffer to dest.

extractDup

data BufferExtractDupMethodInfo

Instances

((~) * signature (Word64 -> Word64 -> m ByteString), MonadIO m) => MethodInfo * BufferExtractDupMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferExtractDupMethodInfo Buffer -> signature -> s

bufferExtractDup

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> Word64

offset: the offset to extract

-> Word64

size: the size to extract

-> m ByteString

Extracts a copy of at most size bytes the data at offset into newly-allocated memory. dest must be freed using free when done.

Since: 1.0.10

fill

data BufferFillMethodInfo

Instances

((~) * signature (Word64 -> ByteString -> m Word64), MonadIO m) => MethodInfo * BufferFillMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferFillMethodInfo Buffer -> signature -> s

bufferFill

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word64

offset: the offset to fill

-> ByteString

src: the source address

-> m Word64

Returns: The amount of bytes copied. This value can be lower than size when buffer did not contain enough data.

Copy size bytes from src to buffer at offset.

findMemory

data BufferFindMemoryMethodInfo

Instances

((~) * signature (Word64 -> Word64 -> m (Bool, Word32, Word32, Word64)), MonadIO m) => MethodInfo * BufferFindMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferFindMemoryMethodInfo Buffer -> signature -> s

bufferFindMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word64

offset: an offset

-> Word64

size: a size

-> m (Bool, Word32, Word32, Word64)

Returns: True when size bytes starting from offset could be found in buffer and idx, length and skip will be filled.

Find the memory blocks that span size bytes starting from offset in buffer.

When this function returns True, idx will contain the index of the first memory block where the byte for offset can be found and length contains the number of memory blocks containing the size remaining bytes. skip contains the number of bytes to skip in the memory block at idx to get to the byte for offset.

size can be -1 to get all the memory blocks after idx.

foreachMeta

data BufferForeachMetaMethodInfo

Instances

((~) * signature (BufferForeachMetaFunc -> m Bool), MonadIO m) => MethodInfo * BufferForeachMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferForeachMetaMethodInfo Buffer -> signature -> s

bufferForeachMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> BufferForeachMetaFunc

func: a BufferForeachMetaFunc to call

-> m Bool

Returns: False when func returned False for one of the metadata.

Call func with userData for each meta in buffer.

func can modify the passed meta pointer or its contents. The return value of func define if this function returns or if the remaining metadata items in the buffer should be skipped.

getAllMemory

data BufferGetAllMemoryMethodInfo

Instances

((~) * signature (m Memory), MonadIO m) => MethodInfo * BufferGetAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetAllMemoryMethodInfo Buffer -> signature -> s

bufferGetAllMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m Memory

Returns: a Memory that contains the merged memory. Use gst_memory_unref () after usage.

Get all the memory block in buffer. The memory blocks will be merged into one large Memory.

getFlags

data BufferGetFlagsMethodInfo

Instances

((~) * signature (m [BufferFlags]), MonadIO m) => MethodInfo * BufferGetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetFlagsMethodInfo Buffer -> signature -> s

bufferGetFlags

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> m [BufferFlags]

Returns: the flags set on this buffer.

Get the BufferFlags flags set on this buffer.

Since: 1.10

getMaxMemory

bufferGetMaxMemory

Arguments

:: (HasCallStack, MonadIO m)

=> m Word32

Returns: the maximum amount of memory blocks that a buffer can hold.

Get the maximum amount of memory blocks that a buffer can hold. This is a compile time constant that can be queried with the function.

When more memory blocks are added, existing memory blocks will be merged together to make room for the new block.

Since: 1.2

getMemory

data BufferGetMemoryMethodInfo

Instances

((~) * signature (Word32 -> m Memory), MonadIO m) => MethodInfo * BufferGetMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMemoryMethodInfo Buffer -> signature -> s

bufferGetMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> m Memory

Returns: a Memory that contains the data of the memory block at idx. Use gst_memory_unref () after usage.

Get the memory block at index idx in buffer.

getMemoryRange

data BufferGetMemoryRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> m Memory), MonadIO m) => MethodInfo * BufferGetMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMemoryRangeMethodInfo Buffer -> signature -> s

bufferGetMemoryRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length

-> m Memory

Returns: a Memory that contains the merged data of length blocks starting at idx. Use gst_memory_unref () after usage.

Get length memory blocks in buffer starting at idx. The memory blocks will be merged into one large Memory.

If length is -1, all memory starting from idx is merged.

getMeta

data BufferGetMetaMethodInfo

Instances

((~) * signature (GType -> m (Maybe Meta)), MonadIO m) => MethodInfo * BufferGetMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetMetaMethodInfo Buffer -> signature -> s

bufferGetMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> GType

api: the GType of an API

-> m (Maybe Meta)

Returns: the metadata for api on buffer.

Get the metadata for api on buffer. When there is no such metadata, Nothing is returned. If multiple metadata with the given api are attached to this buffer only the first one is returned. To handle multiple metadata with a given API use bufferIterateMeta or bufferForeachMeta instead and check the meta->info.api member for the API type.

getSize

data BufferGetSizeMethodInfo

Instances

((~) * signature (m Word64), MonadIO m) => MethodInfo * BufferGetSizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizeMethodInfo Buffer -> signature -> s

bufferGetSize

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m Word64

Returns: total size of the memory blocks in buffer.

Get the total size of the memory blocks in buffer.

getSizes

data BufferGetSizesMethodInfo

Instances

((~) * signature (m (Word64, Word64, Word64)), MonadIO m) => MethodInfo * BufferGetSizesMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizesMethodInfo Buffer -> signature -> s

bufferGetSizes

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m (Word64, Word64, Word64)

Returns: total size of the memory blocks in buffer.

Get the total size of the memory blocks in b.

When not Nothing, offset will contain the offset of the data in the first memory block in buffer and maxsize will contain the sum of the size and offset and the amount of extra padding on the last memory block. offset and maxsize can be used to resize the buffer memory blocks with bufferResize.

getSizesRange

data BufferGetSizesRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> m (Word64, Word64, Word64)), MonadIO m) => MethodInfo * BufferGetSizesRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferGetSizesRangeMethodInfo Buffer -> signature -> s

bufferGetSizesRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length

-> m (Word64, Word64, Word64)

Returns: total size of length memory blocks starting at idx in buffer.

Get the total size of length memory blocks stating from idx in buffer.

When not Nothing, offset will contain the offset of the data in the memory block in buffer at idx and maxsize will contain the sum of the size and offset and the amount of extra padding on the memory block at idx + length -1. offset and maxsize can be used to resize the buffer memory blocks with bufferResizeRange.

hasFlags

data BufferHasFlagsMethodInfo

Instances

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferHasFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferHasFlagsMethodInfo Buffer -> signature -> s

bufferHasFlags :: (HasCallStack, MonadIO m) => Buffer -> [BufferFlags] -> m Bool

No description available in the introspection data.

insertMemory

data BufferInsertMemoryMethodInfo

Instances

((~) * signature (Int32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferInsertMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferInsertMemoryMethodInfo Buffer -> signature -> s

bufferInsertMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Int32

idx: the index to add the memory at, or -1 to append it to the end

-> Memory

mem: a Memory.

-> m ()

Insert the memory block mem to buffer at idx. This function takes ownership of mem and thus doesn't increase its refcount.

Only bufferGetMaxMemory can be added to a buffer. If more memory is added, existing memory blocks will automatically be merged to make room for the new memory.

isAllMemoryWritable

data BufferIsAllMemoryWritableMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * BufferIsAllMemoryWritableMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIsAllMemoryWritableMethodInfo Buffer -> signature -> s

bufferIsAllMemoryWritable

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m Bool

Returns: True if all memory blocks in buffer are writable

Check if all memory blocks in buffer are writable.

Note that this function does not check if buffer is writable, use gst_buffer_is_writable() to check that if needed.

Since: 1.4

isMemoryRangeWritable

data BufferIsMemoryRangeWritableMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> m Bool), MonadIO m) => MethodInfo * BufferIsMemoryRangeWritableMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIsMemoryRangeWritableMethodInfo Buffer -> signature -> s

bufferIsMemoryRangeWritable

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length should not be 0

-> m Bool

Returns: True if the memory range is writable

Check if length memory blocks in buffer starting from idx are writable.

length can be -1 to check all the memory blocks after idx.

Note that this function does not check if buffer is writable, use gst_buffer_is_writable() to check that if needed.

Since: 1.4

iterateMeta

data BufferIterateMetaMethodInfo

Instances

((~) * signature (Ptr () -> m (Maybe Meta)), MonadIO m) => MethodInfo * BufferIterateMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferIterateMetaMethodInfo Buffer -> signature -> s

bufferIterateMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> Ptr ()

state: an opaque state pointer

-> m (Maybe Meta)

Returns: The next Meta or Nothing when there are no more items.

Retrieve the next Meta after current. If state points to Nothing, the first metadata is returned.

state will be updated with an opaque state pointer

map

data BufferMapMethodInfo

Instances

((~) * signature ([MapFlags] -> m (Bool, MapInfo)), MonadIO m) => MethodInfo * BufferMapMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMapMethodInfo Buffer -> signature -> s

bufferMap

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> [MapFlags]

flags: flags for the mapping

-> m (Bool, MapInfo)

Returns: True if the map succeeded and info contains valid data.

This function fills info with the MapInfo of all merged memory blocks in buffer.

flags describe the desired access of the memory. When flags is GST_MAP_WRITE, buffer should be writable (as returned from gst_buffer_is_writable()).

When buffer is writable but the memory isn't, a writable copy will automatically be created and returned. The readonly copy of the buffer memory will then also be replaced with this writable copy.

The memory in info should be unmapped with bufferUnmap after usage.

mapRange

data BufferMapRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> [MapFlags] -> m (Bool, MapInfo)), MonadIO m) => MethodInfo * BufferMapRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMapRangeMethodInfo Buffer -> signature -> s

bufferMapRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length

-> [MapFlags]

flags: flags for the mapping

-> m (Bool, MapInfo)

Returns: True if the map succeeded and info contains valid data.

This function fills info with the MapInfo of length merged memory blocks starting at idx in buffer. When length is -1, all memory blocks starting from idx are merged and mapped.

flags describe the desired access of the memory. When flags is GST_MAP_WRITE, buffer should be writable (as returned from gst_buffer_is_writable()).

When buffer is writable but the memory isn't, a writable copy will automatically be created and returned. The readonly copy of the buffer memory will then also be replaced with this writable copy.

The memory in info should be unmapped with bufferUnmap after usage.

memcmp

data BufferMemcmpMethodInfo

Instances

((~) * signature (Word64 -> ByteString -> m Int32), MonadIO m) => MethodInfo * BufferMemcmpMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMemcmpMethodInfo Buffer -> signature -> s

bufferMemcmp

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word64

offset: the offset in buffer

-> ByteString

mem: the memory to compare

-> m Int32

Returns: 0 if the memory is equal.

Compare size bytes starting from offset in buffer with the memory in mem.

memset

data BufferMemsetMethodInfo

Instances

((~) * signature (Word64 -> Word8 -> Word64 -> m Word64), MonadIO m) => MethodInfo * BufferMemsetMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferMemsetMethodInfo Buffer -> signature -> s

bufferMemset

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word64

offset: the offset in buffer

-> Word8

val: the value to set

-> Word64

size: the size to set

-> m Word64

Returns: The amount of bytes filled. This value can be lower than size when buffer did not contain enough data.

Fill buf with size bytes with val starting from offset.

nMemory

data BufferNMemoryMethodInfo

Instances

((~) * signature (m Word32), MonadIO m) => MethodInfo * BufferNMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferNMemoryMethodInfo Buffer -> signature -> s

bufferNMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m Word32

Returns: the number of memory blocks this buffer is made of.

Get the amount of memory blocks that this buffer has. This amount is never larger than what bufferGetMaxMemory returns.

new

bufferNew

Arguments

:: (HasCallStack, MonadIO m)

=> m Buffer

Returns: the new Buffer.

Creates a newly allocated buffer without any data.

MT safe.

newAllocate

bufferNewAllocate

Arguments

:: (HasCallStack, MonadIO m, IsAllocator a)

=> Maybe a

allocator: the Allocator to use, or Nothing to use the default allocator

-> Word64

size: the size in bytes of the new buffer's data.

-> Maybe AllocationParams

params: optional parameters

-> m (Maybe Buffer)

Returns: a new Buffer, or Nothing if the memory couldn't be allocated.

Tries to create a newly allocated buffer with data of the given size and extra parameters from allocator. If the requested amount of memory can't be allocated, Nothing will be returned. The allocated buffer memory is not cleared.

When allocator is Nothing, the default memory allocator will be used.

Note that when size == 0, the buffer will not have memory associated with it.

MT safe.

newWrapped

bufferNewWrapped

Arguments

:: (HasCallStack, MonadIO m)

=> ByteString

data: data to wrap

-> m Buffer

Returns: a new Buffer

Creates a new buffer that wraps the given data. The memory will be freed with g_free and will be marked writable.

MT safe.

newWrappedFull

bufferNewWrappedFull

Arguments

:: (HasCallStack, MonadIO m)

=> [MemoryFlags]

flags: MemoryFlags

-> ByteString

data: data to wrap

-> Word64

maxsize: allocated size of data

-> Word64

offset: offset in data

-> Maybe DestroyNotify

notify: called with userData when the memory is freed

-> m Buffer

Returns: a new Buffer

Allocate a new buffer that wraps the given memory. data must point to maxsize of memory, the wrapped buffer will have the region from offset and size visible.

When the buffer is destroyed, notify will be called with userData.

The prefix/padding must be filled with 0 if flags contains GST_MEMORY_FLAG_ZERO_PREFIXED and GST_MEMORY_FLAG_ZERO_PADDED respectively.

peekMemory

data BufferPeekMemoryMethodInfo

Instances

((~) * signature (Word32 -> m Memory), MonadIO m) => MethodInfo * BufferPeekMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferPeekMemoryMethodInfo Buffer -> signature -> s

bufferPeekMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> m Memory

Returns: the Memory at idx.

Get the memory block at idx in buffer. The memory block stays valid until the memory block in buffer is removed, replaced or merged, typically with any call that modifies the memory in buffer.

prependMemory

data BufferPrependMemoryMethodInfo

Instances

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferPrependMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferPrependMemoryMethodInfo Buffer -> signature -> s

bufferPrependMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Memory

mem: a Memory.

-> m ()

Prepend the memory block mem to buffer. This function takes ownership of mem and thus doesn't increase its refcount.

This function is identical to bufferInsertMemory with an index of 0. See bufferInsertMemory for more details.

removeAllMemory

data BufferRemoveAllMemoryMethodInfo

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * BufferRemoveAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveAllMemoryMethodInfo Buffer -> signature -> s

bufferRemoveAllMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> m ()

Remove all the memory blocks in buffer.

removeMemory

data BufferRemoveMemoryMethodInfo

Instances

((~) * signature (Word32 -> m ()), MonadIO m) => MethodInfo * BufferRemoveMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMemoryMethodInfo Buffer -> signature -> s

bufferRemoveMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> m ()

Remove the memory block in b at index i.

removeMemoryRange

data BufferRemoveMemoryRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> m ()), MonadIO m) => MethodInfo * BufferRemoveMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMemoryRangeMethodInfo Buffer -> signature -> s

bufferRemoveMemoryRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length

-> m ()

Remove length memory blocks in buffer starting from idx.

length can be -1, in which case all memory starting from idx is removed.

removeMeta

data BufferRemoveMetaMethodInfo

Instances

((~) * signature (Meta -> m Bool), MonadIO m) => MethodInfo * BufferRemoveMetaMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferRemoveMetaMethodInfo Buffer -> signature -> s

bufferRemoveMeta

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> Meta

meta: a Meta

-> m Bool

Returns: True if the metadata existed and was removed, False if no such metadata was on buffer.

Remove the metadata for meta on buffer.

replaceAllMemory

data BufferReplaceAllMemoryMethodInfo

Instances

((~) * signature (Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceAllMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceAllMemoryMethodInfo Buffer -> signature -> s

bufferReplaceAllMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Memory

mem: a Memory

-> m ()

Replaces all memory in buffer with mem.

replaceMemory

data BufferReplaceMemoryMethodInfo

Instances

((~) * signature (Word32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceMemoryMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceMemoryMethodInfo Buffer -> signature -> s

bufferReplaceMemory

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Memory

mem: a Memory

-> m ()

Replaces the memory block at index idx in buffer with mem.

replaceMemoryRange

data BufferReplaceMemoryRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> Memory -> m ()), MonadIO m) => MethodInfo * BufferReplaceMemoryRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferReplaceMemoryRangeMethodInfo Buffer -> signature -> s

bufferReplaceMemoryRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length should not be 0

-> Memory

mem: a Memory

-> m ()

Replaces length memory blocks in buffer starting at idx with mem.

If length is -1, all memory starting from idx will be removed and replaced with mem.

buffer should be writable.

resize

data BufferResizeMethodInfo

Instances

((~) * signature (Int64 -> Int64 -> m ()), MonadIO m) => MethodInfo * BufferResizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferResizeMethodInfo Buffer -> signature -> s

bufferResize

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Int64

offset: the offset adjustment

-> Int64

size: the new size or -1 to just adjust the offset

-> m ()

Set the offset and total size of the memory blocks in buffer.

resizeRange

data BufferResizeRangeMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> Int64 -> Int64 -> m Bool), MonadIO m) => MethodInfo * BufferResizeRangeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferResizeRangeMethodInfo Buffer -> signature -> s

bufferResizeRange

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Word32

idx: an index

-> Int32

length: a length

-> Int64

offset: the offset adjustment

-> Int64

size: the new size or -1 to just adjust the offset

-> m Bool

Returns: True if resizing succeeded, False otherwise.

Set the total size of the length memory blocks starting at idx in buffer

setFlags

data BufferSetFlagsMethodInfo

Instances

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferSetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferSetFlagsMethodInfo Buffer -> signature -> s

bufferSetFlags

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> [BufferFlags]

flags: the BufferFlags to set.

-> m Bool

Returns: True if flags were successfully set on buffer.

Sets one or more buffer flags on a buffer.

Since: 1.10

setSize

data BufferSetSizeMethodInfo

Instances

((~) * signature (Int64 -> m ()), MonadIO m) => MethodInfo * BufferSetSizeMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferSetSizeMethodInfo Buffer -> signature -> s

bufferSetSize

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> Int64

size: the new size

-> m ()

Set the total size of the memory blocks in buffer.

unmap

data BufferUnmapMethodInfo

Instances

((~) * signature (MapInfo -> m ()), MonadIO m) => MethodInfo * BufferUnmapMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferUnmapMethodInfo Buffer -> signature -> s

bufferUnmap

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer.

-> MapInfo

info: a MapInfo

-> m ()

Release the memory previously mapped with bufferMap.

unsetFlags

data BufferUnsetFlagsMethodInfo

Instances

((~) * signature ([BufferFlags] -> m Bool), MonadIO m) => MethodInfo * BufferUnsetFlagsMethodInfo Buffer signature

Methods

overloadedMethod :: MethodProxy BufferUnsetFlagsMethodInfo Buffer -> signature -> s

bufferUnsetFlags

Arguments

:: (HasCallStack, MonadIO m)

=> Buffer

buffer: a Buffer

-> [BufferFlags]

flags: the BufferFlags to clear

-> m Bool

Returns: true if flags is successfully cleared from buffer.

Clears one or more buffer flags.

Since: 1.10

Properties

dts

buffer_dts :: AttrLabelProxy "dts"

getBufferDts :: MonadIO m => Buffer -> m Word64

setBufferDts :: MonadIO m => Buffer -> Word64 -> m ()

duration

buffer_duration :: AttrLabelProxy "duration"

getBufferDuration :: MonadIO m => Buffer -> m Word64

setBufferDuration :: MonadIO m => Buffer -> Word64 -> m ()

miniObject

buffer_miniObject :: AttrLabelProxy "miniObject"

getBufferMiniObject :: MonadIO m => Buffer -> m MiniObject

offset

buffer_offset :: AttrLabelProxy "offset"

getBufferOffset :: MonadIO m => Buffer -> m Word64

setBufferOffset :: MonadIO m => Buffer -> Word64 -> m ()

offsetEnd

buffer_offsetEnd :: AttrLabelProxy "offsetEnd"

getBufferOffsetEnd :: MonadIO m => Buffer -> m Word64

setBufferOffsetEnd :: MonadIO m => Buffer -> Word64 -> m ()

pool

buffer_pool :: AttrLabelProxy "pool"

clearBufferPool :: MonadIO m => Buffer -> m ()

getBufferPool :: MonadIO m => Buffer -> m (Maybe BufferPool)

setBufferPool :: MonadIO m => Buffer -> Ptr BufferPool -> m ()

pts

buffer_pts :: AttrLabelProxy "pts"

getBufferPts :: MonadIO m => Buffer -> m Word64

setBufferPts :: MonadIO m => Buffer -> Word64 -> m ()