Package org.freedesktop.gstreamer.gst

Class CapsFeatures

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.freedesktop.gstreamer.gst.CapsFeatures

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class CapsFeatures
extends ProxyInstance

GstCapsFeatures can optionally be set on a GstCaps to add requirements for additional features for a specific GstStructure. Caps structures with the same name but with a non-equal set of caps features are not compatible. If a pad supports multiple sets of features it has to add multiple equal structures with different feature sets to the caps.

Empty GstCapsFeatures are equivalent with the GstCapsFeatures that only contain GST_CAPS_FEATURE_MEMORY_SYSTEM_MEMORY. ANY GstCapsFeatures as created by gst_caps_features_new_any() are equal to any other GstCapsFeatures and can be used to specify that any GstCapsFeatures would be supported, e.g. for elements that don't touch buffer memory. GstCaps with ANY GstCapsFeatures are considered non-fixed and during negotiation some GstCapsFeatures have to be selected.

Examples for caps features would be the requirement of a specific GstMemory types or the requirement of having a specific GstMeta on the buffer. Features are given as a string of the format memory:GstMemoryTypeName or meta:GstMetaAPIName.

Constructor Summary

Constructors

Constructor	Description
CapsFeatures(MemorySegment address)	Create a CapsFeatures proxy instance for the provided memory address.
CapsFeatures(String feature1, Object... varargs)	Creates a new GstCapsFeatures with the given features.

Method Summary

Modifier and Type	Method	Description
void	add(String feature)	Adds feature to this CapsFeatures.
void	addId(Quark feature)	Adds feature to this CapsFeatures.
static CapsFeatures	any()	Creates a new, ANY GstCapsFeatures.
boolean	contains(String feature)	Checks if this CapsFeatures contains feature.
boolean	containsId(Quark feature)	Checks if this CapsFeatures contains feature.
CapsFeatures	copy()	Duplicates a GstCapsFeatures and all its values.
static CapsFeatures	empty()	Creates a new, empty GstCapsFeatures.
void	free()	Frees a GstCapsFeatures and all its values.
static CapsFeatures	fromString(String features)	Creates a GstCapsFeatures from a string representation.
String	getNth(int i)	Returns the i-th feature of this CapsFeatures.
Quark	getNthId(int i)	Returns the i-th feature of this CapsFeatures.
int	getSize()	Returns the number of features in this CapsFeatures.
static Type	getType()	Get the GType of the CapsFeatures class
static CapsFeatures	id(Quark feature1, Object... varargs)	Creates a new GstCapsFeatures with the given features.
boolean	isAny()	Checks if this CapsFeatures is GST_CAPS_FEATURES_ANY.
boolean	isEqual(CapsFeatures features2)	Checks if this CapsFeatures and features2 are equal.
void	remove(String feature)	Removes feature from this CapsFeatures.
void	removeId(Quark feature)	Removes feature from this CapsFeatures.
boolean	setParentRefcount(MemorySegment refcount)	Sets the parent_refcount field of GstCapsFeatures.
static CapsFeatures	single(String feature)	Creates a new GstCapsFeatures with a single feature.
String	toString()	Converts this CapsFeatures to a human-readable string representation.

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

CapsFeatures

public CapsFeatures(MemorySegment address)

Create a CapsFeatures proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

CapsFeatures

public CapsFeatures(String feature1,
 Object... varargs)

Creates a new GstCapsFeatures with the given features. The last argument must be null.

Parameters:

feature1 - name of first feature to set

varargs - additional features

Method Details

getType

public static Type getType()

Get the GType of the CapsFeatures class

Returns:

the GType

any

public static CapsFeatures any()

Creates a new, ANY GstCapsFeatures. This will be equal to any other GstCapsFeatures but caps with these are unfixed.

Returns:

a new, ANY GstCapsFeatures

empty

public static CapsFeatures empty()

Creates a new, empty GstCapsFeatures.

Returns:

a new, empty GstCapsFeatures

id

public static CapsFeatures id(Quark feature1,
 Object... varargs)

Creates a new GstCapsFeatures with the given features. The last argument must be 0.

Parameters:

feature1 - name of first feature to set

varargs - additional features

Returns:

a new, empty GstCapsFeatures

single

public static CapsFeatures single(String feature)

Creates a new GstCapsFeatures with a single feature.

Parameters:

feature - The feature

Returns:

a new GstCapsFeatures

fromString

public static CapsFeatures fromString(String features)

Creates a GstCapsFeatures from a string representation.

Parameters:

features - a string representation of a GstCapsFeatures.

Returns:

a new GstCapsFeatures or null when the string could not be parsed.

add

public void add(String feature)

Adds feature to this CapsFeatures.

Parameters:

feature - a feature.

addId

public void addId(Quark feature)

Adds feature to this CapsFeatures.

Parameters:

feature - a feature.

contains

public boolean contains(String feature)

Checks if this CapsFeatures contains feature.

Parameters:

feature - a feature

Returns:

true if this CapsFeatures contains feature.

containsId

public boolean containsId(Quark feature)

Checks if this CapsFeatures contains feature.

Parameters:

feature - a feature

Returns:

true if this CapsFeatures contains feature.

copy

public CapsFeatures copy()

Duplicates a GstCapsFeatures and all its values.

Returns:

a new GstCapsFeatures.

free

public void free()

Frees a GstCapsFeatures and all its values. The caps features must not have a parent when this function is called.

getNth

public String getNth(int i)

Returns the i-th feature of this CapsFeatures.

Parameters:

i - index of the feature

Returns:

The i-th feature of this CapsFeatures.

getNthId

public Quark getNthId(int i)

Returns the i-th feature of this CapsFeatures.

Parameters:

i - index of the feature

Returns:

The i-th feature of this CapsFeatures.

getSize

public int getSize()

Returns the number of features in this CapsFeatures.

Returns:

The number of features in this CapsFeatures.

isAny

public boolean isAny()

Checks if this CapsFeatures is GST_CAPS_FEATURES_ANY.

Returns:

true if this CapsFeatures is GST_CAPS_FEATURES_ANY.

isEqual

public boolean isEqual(CapsFeatures features2)

Checks if this CapsFeatures and features2 are equal.

Parameters:

features2 - a GstCapsFeatures.

Returns:

true if this CapsFeatures and features2 are equal.

remove

public void remove(String feature)

Removes feature from this CapsFeatures.

Parameters:

feature - a feature.

removeId

public void removeId(Quark feature)

Removes feature from this CapsFeatures.

Parameters:

feature - a feature.

setParentRefcount

public boolean setParentRefcount(MemorySegment refcount)

Sets the parent_refcount field of GstCapsFeatures. This field is used to determine whether a caps features is mutable or not. This function should only be called by code implementing parent objects of GstCapsFeatures, as described in the MT refcounting design document.

Parameters:

refcount - a pointer to the parent's refcount

Returns:

true if the parent refcount could be set.

toString

public String toString()

Converts this CapsFeatures to a human-readable string representation.

For debugging purposes its easier to do something like this:

GST_LOG ("features is %" GST_PTR_FORMAT, features);
 

This prints the features in human readable form.

Overrides:

toString in class Object

Returns:

a pointer to string allocated by g_malloc().