GI.Gst.Objects.ControlBinding

A base class for value mapping objects that attaches control sources to gobject properties. Such an object is taking one or more ControlSource instances, combines them and maps the resulting value to the type and value range of the bound property.

Exported types

newtype ControlBinding

Memory-managed wrapper type.

Constructors

ControlBinding (ManagedPtr ControlBinding)

Instances

Eq ControlBinding

Defined in GI.Gst.Objects.ControlBinding

Methods

(==) :: ControlBinding -> ControlBinding -> Bool

(/=) :: ControlBinding -> ControlBinding -> Bool

GObject ControlBinding

Defined in GI.Gst.Objects.ControlBinding

ManagedPtrNewtype ControlBinding

Defined in GI.Gst.Objects.ControlBinding

Methods

toManagedPtr :: ControlBinding -> ManagedPtr ControlBinding

TypedObject ControlBinding

Defined in GI.Gst.Objects.ControlBinding

Methods

glibType :: IO GType

HasParentTypes ControlBinding

Defined in GI.Gst.Objects.ControlBinding

IsGValue (Maybe ControlBinding)

Convert ControlBinding to and from GValue. See toGValue and fromGValue.

Defined in GI.Gst.Objects.ControlBinding

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe ControlBinding -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe ControlBinding)

type ParentTypes ControlBinding

Defined in GI.Gst.Objects.ControlBinding

type ParentTypes ControlBinding = '[Object, Object]

class (GObject o, IsDescendantOf ControlBinding o) => IsControlBinding o

Type class for types which can be safely cast to ControlBinding, for instance with toControlBinding.

Instances

(GObject o, IsDescendantOf ControlBinding o) => IsControlBinding o

Defined in GI.Gst.Objects.ControlBinding

toControlBinding :: (MonadIO m, IsControlBinding o) => o -> m ControlBinding

Cast to ControlBinding, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

addControlBinding, bindProperty, bindPropertyFull, defaultError, forceFloating, freezeNotify, getv, hasActiveControlBindings, hasAncestor, hasAsAncestor, hasAsParent, isDisabled, isFloating, notify, notifyByPspec, ref, refSink, removeControlBinding, runDispose, stealData, stealQdata, suggestNextSync, syncValues, thawNotify, unparent, unref, watchClosure.

Getters

getControlBinding, getControlRate, getData, getGValueArray, getName, getParent, getPathString, getProperty, getQdata, getValue.

Setters

setControlBindingDisabled, setControlBindingsDisabled, setControlRate, setData, setDataFull, setDisabled, setName, setParent, setProperty.

getGValueArray

controlBindingGetGValueArray

Arguments

:: (HasCallStack, MonadIO m, IsControlBinding a)

=> a

binding: the control binding

-> Word64

timestamp: the time that should be processed

-> Word64

interval: the time spacing between subsequent values

-> [GValue]

values: array to put control-values in

-> m Bool

Returns: True if the given array could be filled, False otherwise

Gets a number of GValues for the given controlled property starting at the requested time. The array values need to hold enough space for nValues of Value.

This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample.

getValue

controlBindingGetValue

Arguments

:: (HasCallStack, MonadIO m, IsControlBinding a)

=> a

binding: the control binding

-> Word64

timestamp: the time the control-change should be read from

-> m (Maybe GValue)

Returns: the GValue of the property at the given time, or Nothing if the property isn't controlled.

Gets the value for the given controlled property at the requested time.

isDisabled

controlBindingIsDisabled

Arguments

:: (HasCallStack, MonadIO m, IsControlBinding a)

=> a

binding: the control binding

-> m Bool

Returns: True if the binding is inactive

Check if the control binding is disabled.

setDisabled

controlBindingSetDisabled

Arguments

:: (HasCallStack, MonadIO m, IsControlBinding a)

=> a

binding: the control binding

-> Bool

disabled: boolean that specifies whether to disable the controller or not.

-> m ()

This function is used to disable a control binding for some time, i.e. objectSyncValues will do nothing.

syncValues

controlBindingSyncValues

Arguments

:: (HasCallStack, MonadIO m, IsControlBinding a, IsObject b)

=> a

binding: the control binding

-> b

object: the object that has controlled properties

-> Word64

timestamp: the time that should be processed

-> Word64

lastSync: the last time this was called

-> m Bool

Returns: True if the controller value could be applied to the object property, False otherwise

Sets the property of the object, according to the GstControlSources that handle them and for the given timestamp.

If this function fails, it is most likely the application developers fault. Most probably the control sources are not setup correctly.

Properties

name

No description available in the introspection data.

constructControlBindingName :: (IsControlBinding o, MonadIO m) => Text -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “name” property. This is rarely needed directly, but it is used by new.

getControlBindingName :: (MonadIO m, IsControlBinding o) => o -> m (Maybe Text)

Get the value of the “name” property. When overloading is enabled, this is equivalent to

get controlBinding #name

object

No description available in the introspection data.

constructControlBindingObject :: (IsControlBinding o, MonadIO m, IsObject a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “object” property. This is rarely needed directly, but it is used by new.

getControlBindingObject :: (MonadIO m, IsControlBinding o) => o -> m (Maybe Object)

Get the value of the “object” property. When overloading is enabled, this is equivalent to

get controlBinding #object