Package ch.bailu.gtk.gst

Klasse DeviceProvider

java.lang.Object

ch.bailu.gtk.type.Type

ch.bailu.gtk.type.Pointer

ch.bailu.gtk.gobject.Object

ch.bailu.gtk.type.PropertyHolder

ch.bailu.gtk.gst.DeviceProvider

Alle implementierten Schnittstellen:

PointerInterface

public class DeviceProvider
extends PropertyHolder

A #GstDeviceProvider subclass is provided by a plugin that handles devices
if there is a way to programmatically list connected devices. It can also
optionally provide updates to the list of connected devices.

Each #GstDeviceProvider subclass is a singleton, a plugin should
normally provide a single subclass for all devices.

Applications would normally use a #GstDeviceMonitor to monitor devices
from all relevant providers.

https://gstreamer.freedesktop.org/documentation/gstreamer/gi-index.html

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static interface	DeviceProvider.OnProviderHidden
static interface	DeviceProvider.OnProviderUnhidden

Von Klasse geerbte verschachtelte Klassen/Schnittstellen ch.bailu.gtk.gobject.Object

Object.OnBindingTransformFunc, Object.OnDestroyNotify, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
static final String	SIGNAL_ON_PROVIDER_HIDDEN
static final String	SIGNAL_ON_PROVIDER_UNHIDDEN

Von Klasse geerbte Felder ch.bailu.gtk.gobject.Object

SIGNAL_ON_NOTIFY

Von Klasse geerbte Felder ch.bailu.gtk.type.Pointer

NULL

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
DeviceProvider(PointerContainer pointer)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
boolean	canMonitor()
void	deviceAdd(Device device)	Posts a message on the provider's #GstBus to inform applications that a new device has been added.
void	deviceChanged(Device device, Device changed_device)	This function is used when @changed_device was modified into its new form @device.
void	deviceRemove(Device device)	Posts a message on the provider's #GstBus to inform applications that a device has been removed.
Bus	getBus()	Gets the #GstBus of this #GstDeviceProvider
static ClassHandler	getClassHandler()
List	getDevices()	Gets a list of devices that this provider understands.
DeviceProviderFactory	getFactory()	Retrieves the factory that was used to create this device provider.
static int	getInstanceSize()
Str	getMetadata(Str key)	Get metadata with @key in @provider.
Str	getMetadata(String key)	Get metadata with @key in @provider.
static long	getParentTypeID()
static TypeSystem.TypeSize	getParentTypeSize()
static long	getTypeID()
static TypeSystem.TypeSize	getTypeSize()
void	hideProvider(Str name)	Make @provider hide the devices from the factory with @name.
void	hideProvider(String name)	Make @provider hide the devices from the factory with @name.
boolean	isStarted()	This function can be used to know if the @provider was successfully started.
SignalHandler	onProviderHidden(DeviceProvider.OnProviderHidden signal)	Connect to signal "provider-hidden".
SignalHandler	onProviderUnhidden(DeviceProvider.OnProviderUnhidden signal)	Connect to signal "provider-unhidden".
static boolean	register(Plugin plugin, Str name, int rank, long type)	Create a new device providerfactory capable of instantiating objects of the @type and add the factory to @plugin.
boolean	start()	Starts providering the devices.
void	stop()	Decreases the use-count by one.
void	unhideProvider(Str name)	Make @provider unhide the devices from factory @name.
void	unhideProvider(String name)	Make @provider unhide the devices from factory @name.

Von Klasse geerbte Methoden ch.bailu.gtk.type.PropertyHolder

getBooleanProperty, getIntProperty, getObjectProperty, getStringProperty, getStrProperty, setBooleanProperty, setIntProperty, setObjectProperty, setStringProperty, setStrProperty

Von Klasse geerbte Methoden ch.bailu.gtk.gobject.Object

addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref

Von Klasse geerbte Methoden ch.bailu.gtk.type.Pointer

asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks

Von Klasse geerbte Methoden ch.bailu.gtk.type.Type

asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull

Von Klasse geerbte Methoden java.lang.Object

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

Von Schnittstelle geerbte Methoden ch.bailu.gtk.type.PointerInterface

asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull

Felddetails

SIGNAL_ON_PROVIDER_HIDDEN

public static final String SIGNAL_ON_PROVIDER_HIDDEN

Siehe auch:

• Konstantenfeldwerte

SIGNAL_ON_PROVIDER_UNHIDDEN

public static final String SIGNAL_ON_PROVIDER_UNHIDDEN

Siehe auch:

• Konstantenfeldwerte

Konstruktordetails

DeviceProvider

public DeviceProvider(PointerContainer pointer)

Methodendetails

getClassHandler

public static ClassHandler getClassHandler()

canMonitor

public boolean canMonitor()

Gibt zurück:

deviceAdd

public void deviceAdd(@Nonnull
 Device device)

Posts a message on the provider's #GstBus to inform applications that
a new device has been added.

This is for use by subclasses.

@device's reference count will be incremented, and any floating reference
will be removed (see gst_object_ref_sink()).

Parameter:

device - a #GstDevice that has been added

deviceChanged

public void deviceChanged(@Nonnull
 Device device,
 @Nonnull
 Device changed_device)

This function is used when @changed_device was modified into its new form
@device. This will post a `DEVICE_CHANGED` message on the bus to let
the application know that the device was modified. #GstDevice is immutable
for MT. safety purposes so this is an "atomic" way of letting the application
know when a device was modified.

Parameter:

device - the new version of @changed_device

changed_device - the old version of the device that has been updated

deviceRemove

public void deviceRemove(@Nonnull
 Device device)

Posts a message on the provider's #GstBus to inform applications that
a device has been removed.

This is for use by subclasses.

Parameter:

device - a #GstDevice that has been removed

getBus

public Bus getBus()

Gets the #GstBus of this #GstDeviceProvider

Gibt zurück:

a #GstBus

getDevices

public List getDevices()

Gets a list of devices that this provider understands. This may actually
probe the hardware if the provider is not currently started.

If the provider has been started, this will returned the same #GstDevice
objedcts that have been returned by the #GST_MESSAGE_DEVICE_ADDED messages.

Gibt zurück:

a #GList of #GstDevice

getFactory

public DeviceProviderFactory getFactory()

Retrieves the factory that was used to create this device provider.

Gibt zurück:

the #GstDeviceProviderFactory used for creating this device provider. no refcounting is needed.

getMetadata

public Str getMetadata(@Nonnull
 Str key)

Get metadata with @key in @provider.

Parameter:

key - the key to get

Gibt zurück:

the metadata for @key.

getMetadata

public Str getMetadata(String key)

Get metadata with @key in @provider.

Parameter:

key - the key to get

Gibt zurück:

the metadata for @key.

hideProvider

public void hideProvider(@Nonnull
 Str name)

Make @provider hide the devices from the factory with @name.

This function is used when @provider will also provide the devices reported
by provider factory @name. A monitor should stop monitoring the
device provider with @name to avoid duplicate devices.

Parameter:

name - a provider factory name

hideProvider

public void hideProvider(String name)

Make @provider hide the devices from the factory with @name.

This function is used when @provider will also provide the devices reported
by provider factory @name. A monitor should stop monitoring the
device provider with @name to avoid duplicate devices.

Parameter:

name - a provider factory name

isStarted

public boolean isStarted()

This function can be used to know if the @provider was successfully started.

Gibt zurück:

start

public boolean start()

Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED
and #GST_MESSAGE_DEVICE_REMOVED messages to be posted on the provider's bus
when devices are added or removed from the system.

Since the #GstDeviceProvider is a singleton,
gst_device_provider_start() may already have been called by another
user of the object, gst_device_provider_stop() needs to be called the same
number of times.

After this function has been called, gst_device_provider_get_devices() will
return the same objects that have been received from the
#GST_MESSAGE_DEVICE_ADDED messages and will no longer probe.

Gibt zurück:

%TRUE if the device providering could be started

stop

public void stop()

Decreases the use-count by one. If the use count reaches zero, this
#GstDeviceProvider will stop providering the devices. This needs to be
called the same number of times that gst_device_provider_start() was called.

unhideProvider

public void unhideProvider(@Nonnull
 Str name)

Make @provider unhide the devices from factory @name.

This function is used when @provider will no longer provide the devices
reported by provider factory @name. A monitor should start
monitoring the devices from provider factory @name in order to see
all devices again.

Parameter:

name - a provider factory name

unhideProvider

public void unhideProvider(String name)

Make @provider unhide the devices from factory @name.

This function is used when @provider will no longer provide the devices
reported by provider factory @name. A monitor should start
monitoring the devices from provider factory @name in order to see
all devices again.

Parameter:

name - a provider factory name

onProviderHidden

public SignalHandler onProviderHidden(DeviceProvider.OnProviderHidden signal)

Connect to signal "provider-hidden".
See DeviceProvider.OnProviderHidden.onProviderHidden(ch.bailu.gtk.type.Str) for signal description.
Field SIGNAL_ON_PROVIDER_HIDDEN contains original signal name and can be used as resource reference.

Parameter:

signal - callback function (lambda).

Gibt zurück:

SignalHandler. Can be used to disconnect signal and to release callback function.

onProviderUnhidden

public SignalHandler onProviderUnhidden(DeviceProvider.OnProviderUnhidden signal)

Connect to signal "provider-unhidden".
See DeviceProvider.OnProviderUnhidden.onProviderUnhidden(ch.bailu.gtk.type.Str) for signal description.
Field SIGNAL_ON_PROVIDER_UNHIDDEN contains original signal name and can be used as resource reference.

Parameter:

signal - callback function (lambda).

Gibt zurück:

SignalHandler. Can be used to disconnect signal and to release callback function.

register

public static boolean register(@Nullable
 Plugin plugin,
 @Nonnull
 Str name,
 int rank,
 long type)

Create a new device providerfactory capable of instantiating objects of the
@type and add the factory to @plugin.

Parameter:

plugin - #GstPlugin to register the device provider with, or %NULL for a static device provider.

name - name of device providers of this type

rank - rank of device provider (higher rank means more importance when autoplugging)

type - GType of device provider to register

Gibt zurück:

%TRUE, if the registering succeeded, %FALSE on error

getTypeID

public static long getTypeID()

getParentTypeID

public static long getParentTypeID()

getTypeSize

public static TypeSystem.TypeSize getTypeSize()

getParentTypeSize

public static TypeSystem.TypeSize getParentTypeSize()

getInstanceSize

public static int getInstanceSize()