+2005-11-23 Wim Taymans <wim@fluendo.com>
+
+ * docs/gst/gstreamer-sections.txt:
+ * gst/glib-compat.c:
+ * gst/gsttagsetter.c:
+ * gst/gstvalue.c:
+ * gst/net/gstnetclientclock.c:
+ * gst/net/gstnettimepacket.h:
+ Doc updates.
+
2005-11-23 Thomas Vander Stichele <thomas at apestaart dot org>
* docs/faq/using.xml:
thread_list
</SECTION>
-
<SECTION>
<FILE>gstbin</FILE>
<TITLE>GstBin</TITLE>
GST_CLOCK_COND
GST_CLOCK_TIMED_WAIT
GST_CLOCK_WAIT
-GST_CLOCK_SLAVE_LOCK
-GST_CLOCK_SLAVE_UNLOCK
gst_clock_add_observation
gst_clock_set_master
gst_clock_get_master
GST_TYPE_CLOCK_RETURN
GST_TYPE_CLOCK_TIME
<SUBSECTION Private>
+GST_CLOCK_SLAVE_LOCK
+GST_CLOCK_SLAVE_UNLOCK
gst_clock_get_type
gst_clock_entry_type_get_type
gst_clock_flags_get_type
<TITLE>GstCompat</TITLE>
<SUBSECTION Standard>
<SUBSECTION Private>
+g_mkdir_with_parents
+gst_flags_get_first_value
+g_value_dup_gst_object
</SECTION>
-
<SECTION>
<FILE>gstconfig</FILE>
<SUBSECTION Private>
gst_segment_init
gst_segment_new
gst_segment_free
-gst_segment_get_type
gst_segment_set_duration
gst_segment_set_last_stop
gst_segment_set_newsegment
gst_segment_to_stream_time
<SUBSECTION Standard>
GST_TYPE_SEGMENT
+gst_segment_get_type
<SUBSECTION Private>
</SECTION>
#endif
-/* This version is copied from GLib 2.8.
+/**
+ * gst_flags_get_first_value:
+ * @flags_class: a #GFlagsClass
+ * @value: the value
+ *
+ * Returns the first GFlagsValue which is set in value.
+ *
+ * This version is copied from GLib 2.8.
* In GLib 2.6, it didn't check for a flag value being NULL, hence it
* hits an infinite loop in our flags serialize function
+ *
+ * Returns: the first GFlagsValue which is set in value, or NULL if none is set.
*/
GFlagsValue *
gst_flags_get_first_value (GFlagsClass * flags_class, guint value)
/* Adapted from g_value_dup_object to use gst_object_ref */
#include "gstobject.h"
+/**
+ * g_value_dup_gst_object:
+ * @value: the #GstObject value to dup
+ *
+ * Get the contents of a G_TYPE_OBJECT derived GValue, increasing its reference count.
+ * This function exists because of unsafe reference counting in old glib versions.
+ *
+ * Returns: object content of value, should be unreferenced with gst_object_unref()
+ * when no longer needed.
+ */
GObject *
g_value_dup_gst_object (const GValue * value)
{
}
/**
- * gst_tag_setter_tag_add_valist:
+ * gst_tag_setter_add_tag_valist:
* @setter: a #GstTagSetter
* @mode: the mode to use
* @tag: tag to set
g_value_copy (end, &vals[1]);
}
+/**
+ * gst_value_set_fraction_range_full:
+ * @value: a GValue initialized to GST_TYPE_FRACTION_RANGE
+ * @numerator_start: the numerator start of the range
+ * @denominator_start: the denominator start of the range
+ * @numerator_end: the numerator end of the range
+ * @denominator_end: the denominator end of the range
+ *
+ * Sets @value to the range specified by @numerator_start/@denominator_start
+ * and @numerator_end/@denominator_end.
+ */
void
gst_value_set_fraction_range_full (GValue * value,
int numerator_start, int denominator_start,
}
}
+/**
+ * gst_net_client_clock_new:
+ * @name: a name for the clock
+ * @remote_address: the address of the remote clock provider
+ * @remote_port: the port of the remote clock provider
+ * @base_time: initial time of the clock
+ *
+ * Create a new #GstNetClientClock that will report the time
+ * provided by the #GstNetClockProvider on @remote_address and
+ * @remote_port.
+ *
+ * Returns: a new #GstClock that receives a time from the remote
+ * clock.
+ */
GstClock *
gst_net_client_clock_new (gchar * name, const gchar * remote_address,
gint remote_port, GstClockTime base_time)
#include <netinet/in.h>
#include <arpa/inet.h>
+/**
+ * GST_NET_TIME_PACKET_SIZE:
+ *
+ * The size of the packets sent between network clocks.
+ */
#define GST_NET_TIME_PACKET_SIZE 16
typedef struct _GstNetTimePacket GstNetTimePacket;
+/**
+ * GstNetTimePacket:
+ * @local_time: the local time when this packet was sent
+ * @remote_time: the remote time observation
+ *
+ * Content of a #GstNetTimePacket.
+ */
struct _GstNetTimePacket {
GstClockTime local_time;
GstClockTime remote_time;
}
}
+/**
+ * gst_net_client_clock_new:
+ * @name: a name for the clock
+ * @remote_address: the address of the remote clock provider
+ * @remote_port: the port of the remote clock provider
+ * @base_time: initial time of the clock
+ *
+ * Create a new #GstNetClientClock that will report the time
+ * provided by the #GstNetClockProvider on @remote_address and
+ * @remote_port.
+ *
+ * Returns: a new #GstClock that receives a time from the remote
+ * clock.
+ */
GstClock *
gst_net_client_clock_new (gchar * name, const gchar * remote_address,
gint remote_port, GstClockTime base_time)
#include <netinet/in.h>
#include <arpa/inet.h>
+/**
+ * GST_NET_TIME_PACKET_SIZE:
+ *
+ * The size of the packets sent between network clocks.
+ */
#define GST_NET_TIME_PACKET_SIZE 16
typedef struct _GstNetTimePacket GstNetTimePacket;
+/**
+ * GstNetTimePacket:
+ * @local_time: the local time when this packet was sent
+ * @remote_time: the remote time observation
+ *
+ * Content of a #GstNetTimePacket.
+ */
struct _GstNetTimePacket {
GstClockTime local_time;
GstClockTime remote_time;