Package org.freedesktop.gstreamer.gst

Class TracerRecord

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.freedesktop.gstreamer.gst.GstObject

org.freedesktop.gstreamer.gst.TracerRecord

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class TracerRecord
extends GstObject

Tracing modules will create instances of this class to announce the data they will log and create a log formatter.

Since:

1.8

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TracerRecord.Builder<B extends TracerRecord.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	TracerRecord.TracerRecordClass

Nested classes/interfaces inherited from class org.freedesktop.gstreamer.gst.GstObject

GstObject.DeepNotifyCallback, GstObject.Object$Impl, GstObject.ObjectClass

Nested classes/interfaces inherited from class org.gnome.gobject.InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback

Constructor Summary

Constructors

Constructor	Description
TracerRecord()	Creates a new TracerRecord.
TracerRecord(MemorySegment address)	Create a TracerRecord proxy instance for the provided memory address.
TracerRecord(String name, String firstfield, Object... varargs)	Create a new tracer record.

Method Summary

Modifier and Type	Method	Description
protected TracerRecord	asParent()	Returns this instance as if it were its parent type.
static TracerRecord.Builder<? extends TracerRecord.Builder>	builder()	A TracerRecord.Builder object constructs a TracerRecord with the specified properties.
static @Nullable Type	getType()	Get the GType of the TracerRecord class
void	log(Object... varargs)	Serialzes the trace event into the log.

Methods inherited from class org.freedesktop.gstreamer.gst.GstObject

addControlBinding, checkUniqueness, deepNotify, defaultDeepNotify, defaultError, emitDeepNotify, getControlBinding, getControlRate, getGValueArray, getMemoryLayout, getName, getParent, getPathString, getValue, getValueArray, hasActiveControlBindings, hasAncestor, hasAsAncestor, hasAsParent, onDeepNotify, ref, refSink, removeControlBinding, replace, setControlBindingDisabled, setControlBindingsDisabled, setControlRate, setName, setParent, suggestNextSync, syncValues, unparent, unref

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Constructor Details

TracerRecord

public TracerRecord(MemorySegment address)

Create a TracerRecord proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

TracerRecord

public TracerRecord(String name,
 String firstfield,
 Object... varargs)

Create a new tracer record. The record instance can be used to efficiently log entries using gst_tracer_record_log(). null terminator required after the last argument.

The name without the ".class" suffix will be used for the log records. There must be fields for each value that gets logged where the field name is the value name. The field must be a GstStructure describing the value. The sub structure must contain a field called 'type' of G_TYPE_GTYPE that contains the GType of the value. The resulting GstTracerRecord will take ownership of the field structures.

The way to deal with optional values is to log an additional boolean before the optional field, that if true signals that the optional field is valid and false signals that the optional field should be ignored. One must still log a placeholder value for the optional field though. Please also note, that pointer type values must not be NULL - the underlying serialisation can not handle that right now.

Please note that this is still under discussion and subject to change.

Parameters:

name - name of new record, must end on ".class".

firstfield - name of first field to set

varargs - additional arguments

Since:

1.8

TracerRecord

public TracerRecord()

Creates a new TracerRecord.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the TracerRecord class

Returns:

the GType

asParent

protected TracerRecord asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GstObject

log

public void log(Object... varargs)

Serialzes the trace event into the log.

Right now this is using the gstreamer debug log with the level TRACE (7) and the category "GST_TRACER".

Please note that this is still under discussion and subject to change.

Parameters:

varargs - the args as described in the spec-

Since:

1.8

builder

public static TracerRecord.Builder<? extends TracerRecord.Builder> builder()

A TracerRecord.Builder object constructs a TracerRecord with the specified properties. Use the various set...() methods to set properties, and finish construction with TracerRecord.Builder.build().

Returns:

the builder object