summaryrefslogtreecommitdiff
path: root/docs/random
diff options
context:
space:
mode:
authorChristophe Fergeau <teuf@gnome.org>2004-11-03 18:49:59 +0000
committerChristophe Fergeau <teuf@gnome.org>2004-11-03 18:49:59 +0000
commita3bdc2c334cc79f3ce2f0796702dcd030d27d3c0 (patch)
tree51c394bd147d2c58145a7b30778a7d2a2eefd28b /docs/random
parent074dc0340cabd675ddd9130568de1194678b4a71 (diff)
docs/random/signal: added notes about using BOXED for GstBuffer signal marshallers, not POINTER
Original commit message from CVS: 2004-11-03 Christophe Fergeau <teuf@gnome.org> * docs/random/signal: added notes about using BOXED for GstBuffer signal marshallers, not POINTER
Diffstat (limited to 'docs/random')
-rw-r--r--docs/random/signal12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/random/signal b/docs/random/signal
new file mode 100644
index 000000000..679a36c12
--- /dev/null
+++ b/docs/random/signal
@@ -0,0 +1,12 @@
+Random notes on signals:
+
+* Use a BOXED (and not a POINTER) marshaller when your signal will have a
+ GstBuffer argument:
+
+g_signal_new ("handoff", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GstIdentityClass, handoff), NULL, NULL,
+ gst_marshal_VOID__BOXED, G_TYPE_NONE, 1,
+ GST_TYPE_BUFFER | G_SIGNAL_TYPE_STATIC_SCOPE);
+
+* For GstBuffers arguments, consider using G_SIGNAL_TYPE_STATIC_SCOPE as it
+ can prevent an extra copy of the buffer