a5e03f077f7bbbbb63ffaf6f0438075253d43b5f
[platform/upstream/gstreamer.git] / gst / playback / gstplaysinkconvertbin.c
1 /* GStreamer
2  * Copyright (C) <2011> Sebastian Dröge <sebastian.droege@collabora.co.uk>
3  * Copyright (C) <2011> Vincent Penquerch <vincent.penquerch@collabora.co.uk>
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public
16  * License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  */
20
21 #ifdef HAVE_CONFIG_H
22 #include "config.h"
23 #endif
24
25 #include "gstplaysinkconvertbin.h"
26
27 #include <gst/pbutils/pbutils.h>
28 #include <gst/gst-i18n-plugin.h>
29
30 GST_DEBUG_CATEGORY_STATIC (gst_play_sink_convert_bin_debug);
31 #define GST_CAT_DEFAULT gst_play_sink_convert_bin_debug
32
33 #define parent_class gst_play_sink_convert_bin_parent_class
34
35 static gboolean gst_play_sink_convert_bin_sink_setcaps (GstPlaySinkConvertBin *
36     self, GstCaps * caps);
37
38 G_DEFINE_TYPE (GstPlaySinkConvertBin, gst_play_sink_convert_bin, GST_TYPE_BIN);
39
40 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src",
41     GST_PAD_SRC,
42     GST_PAD_ALWAYS,
43     GST_STATIC_CAPS_ANY);
44
45 static GstStaticPadTemplate sinktemplate = GST_STATIC_PAD_TEMPLATE ("sink",
46     GST_PAD_SINK,
47     GST_PAD_ALWAYS,
48     GST_STATIC_CAPS_ANY);
49
50 static gboolean
51 is_raw_caps (GstCaps * caps, gboolean audio)
52 {
53   gint i, n;
54   GstStructure *s;
55   const gchar *name;
56   const gchar *prefix = audio ? "audio/x-raw" : "video/x-raw";
57
58   n = gst_caps_get_size (caps);
59   for (i = 0; i < n; i++) {
60     s = gst_caps_get_structure (caps, i);
61     name = gst_structure_get_name (s);
62     if (g_str_equal (name, prefix))
63       return TRUE;
64   }
65
66   return FALSE;
67 }
68
69 static void
70 gst_play_sink_convert_bin_post_missing_element_message (GstPlaySinkConvertBin *
71     self, const gchar * name)
72 {
73   GstMessage *msg;
74
75   msg = gst_missing_element_message_new (GST_ELEMENT_CAST (self), name);
76   gst_element_post_message (GST_ELEMENT_CAST (self), msg);
77 }
78
79 static void
80 distribute_running_time (GstElement * element, const GstSegment * segment)
81 {
82   GstEvent *event;
83   GstPad *pad;
84
85   pad = gst_element_get_static_pad (element, "sink");
86
87   gst_pad_send_event (pad, gst_event_new_flush_start ());
88   gst_pad_send_event (pad, gst_event_new_flush_stop (FALSE));
89
90   if (segment->format != GST_FORMAT_UNDEFINED) {
91     event = gst_event_new_segment (segment);
92     gst_pad_send_event (pad, event);
93   }
94
95   gst_object_unref (pad);
96 }
97
98 void
99 gst_play_sink_convert_bin_add_conversion_element (GstPlaySinkConvertBin * self,
100     GstElement * el)
101 {
102   self->conversion_elements = g_list_append (self->conversion_elements, el);
103   gst_bin_add (GST_BIN (self), gst_object_ref (el));
104 }
105
106 GstElement *
107 gst_play_sink_convert_bin_add_conversion_element_factory (GstPlaySinkConvertBin
108     * self, const char *factory, const char *name)
109 {
110   GstElement *el;
111
112   el = gst_element_factory_make (factory, name);
113   if (el == NULL) {
114     gst_play_sink_convert_bin_post_missing_element_message (self, factory);
115     GST_ELEMENT_WARNING (self, CORE, MISSING_PLUGIN,
116         (_("Missing element '%s' - check your GStreamer installation."),
117             factory),
118         (self->audio ? "audio rendering might fail" :
119             "video rendering might fail"));
120   } else {
121     gst_play_sink_convert_bin_add_conversion_element (self, el);
122   }
123   return el;
124 }
125
126 void
127 gst_play_sink_convert_bin_add_identity (GstPlaySinkConvertBin * self)
128 {
129   if (self->identity)
130     return;
131
132   self->identity = gst_element_factory_make ("identity", "identity");
133   if (self->identity == NULL) {
134     gst_play_sink_convert_bin_post_missing_element_message (self, "identity");
135     GST_ELEMENT_WARNING (self, CORE, MISSING_PLUGIN,
136         (_("Missing element '%s' - check your GStreamer installation."),
137             "identity"), (self->audio ?
138             "audio rendering might fail" : "video rendering might fail")
139
140         );
141   } else {
142     g_object_set (self->identity, "silent", TRUE, "signal-handoffs", FALSE,
143         NULL);
144     gst_bin_add (GST_BIN_CAST (self), self->identity);
145   }
146 }
147
148 static void
149 gst_play_sink_convert_bin_set_targets (GstPlaySinkConvertBin * self,
150     gboolean passthrough)
151 {
152   GstPad *pad;
153   GstElement *head, *tail;
154
155   GST_DEBUG_OBJECT (self, "Setting pad targets with passthrough %d",
156       passthrough);
157   if (self->conversion_elements == NULL || passthrough) {
158     GST_DEBUG_OBJECT (self, "no conversion elements, using identity (%p) as "
159         "head/tail", self->identity);
160     if (!passthrough) {
161       GST_WARNING_OBJECT (self,
162           "Doing passthrough as no converter elements were added");
163     }
164     head = tail = self->identity;
165   } else {
166     head = GST_ELEMENT (g_list_first (self->conversion_elements)->data);
167     tail = GST_ELEMENT (g_list_last (self->conversion_elements)->data);
168     GST_DEBUG_OBJECT (self, "conversion elements in use, picking "
169         "head:%s and tail:%s", GST_OBJECT_NAME (head), GST_OBJECT_NAME (tail));
170   }
171
172   g_return_if_fail (head != NULL);
173   g_return_if_fail (tail != NULL);
174
175   pad = gst_element_get_static_pad (head, "sink");
176   GST_DEBUG_OBJECT (self, "Ghosting bin sink pad to %" GST_PTR_FORMAT, pad);
177   gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->sinkpad), pad);
178   gst_object_unref (pad);
179
180   pad = gst_element_get_static_pad (tail, "src");
181   GST_DEBUG_OBJECT (self, "Ghosting bin src pad to %" GST_PTR_FORMAT, pad);
182   gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->srcpad), pad);
183   gst_object_unref (pad);
184 }
185
186 static void
187 gst_play_sink_convert_bin_remove_element (GstElement * element,
188     GstPlaySinkConvertBin * self)
189 {
190   gst_element_set_state (element, GST_STATE_NULL);
191   gst_object_unref (element);
192   gst_bin_remove (GST_BIN_CAST (self), element);
193 }
194
195 static void
196 gst_play_sink_convert_bin_on_element_added (GstElement * element,
197     GstPlaySinkConvertBin * self)
198 {
199   gst_element_sync_state_with_parent (element);
200   distribute_running_time (element, &self->segment);
201 }
202
203 static GstPadProbeReturn
204 pad_blocked_cb (GstPad * pad, GstPadProbeInfo * info, gpointer user_data)
205 {
206   GstPlaySinkConvertBin *self = user_data;
207   GstPad *peer;
208   GstCaps *caps;
209   gboolean raw;
210
211   GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
212   GST_DEBUG_OBJECT (self, "Pad blocked");
213
214   /* There must be a peer at this point */
215   peer = gst_pad_get_peer (self->sinkpad);
216   caps = gst_pad_get_current_caps (peer);
217   if (!caps)
218     caps = gst_pad_query_caps (peer, NULL);
219   gst_object_unref (peer);
220
221   raw = is_raw_caps (caps, self->audio);
222   GST_DEBUG_OBJECT (self, "Caps %" GST_PTR_FORMAT " are raw: %d", caps, raw);
223   gst_caps_unref (caps);
224
225   if (raw == self->raw)
226     goto unblock;
227   self->raw = raw;
228
229   gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->sinkpad), NULL);
230   gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->srcpad), NULL);
231
232   if (raw) {
233     GST_DEBUG_OBJECT (self, "Switching to raw conversion pipeline");
234
235     if (self->conversion_elements)
236       g_list_foreach (self->conversion_elements,
237           (GFunc) gst_play_sink_convert_bin_on_element_added, self);
238   } else {
239
240     GST_DEBUG_OBJECT (self, "Switch to passthrough pipeline");
241
242     gst_play_sink_convert_bin_on_element_added (self->identity, self);
243   }
244
245   gst_play_sink_convert_bin_set_targets (self, !raw);
246
247 unblock:
248   self->sink_proxypad_block_id = 0;
249   GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
250
251   return GST_PAD_PROBE_REMOVE;
252 }
253
254 static gboolean
255 gst_play_sink_convert_bin_sink_event (GstPad * pad, GstObject * parent,
256     GstEvent * event)
257 {
258   GstPlaySinkConvertBin *self = GST_PLAY_SINK_CONVERT_BIN (parent);
259   gboolean ret;
260
261   switch (GST_EVENT_TYPE (event)) {
262     case GST_EVENT_CAPS:
263     {
264       GstCaps *caps;
265
266       gst_event_parse_caps (event, &caps);
267       ret = gst_play_sink_convert_bin_sink_setcaps (self, caps);
268       break;
269     }
270     default:
271       break;
272   }
273
274   ret = gst_pad_event_default (pad, parent, gst_event_ref (event));
275
276   if (GST_EVENT_TYPE (event) == GST_EVENT_SEGMENT) {
277     GstSegment seg;
278
279     GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
280     gst_event_copy_segment (event, &seg);
281
282     GST_DEBUG_OBJECT (self, "Segment before %" GST_SEGMENT_FORMAT,
283         &self->segment);
284     self->segment = seg;
285     GST_DEBUG_OBJECT (self, "Segment after %" GST_SEGMENT_FORMAT,
286         &self->segment);
287     GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
288   } else if (GST_EVENT_TYPE (event) == GST_EVENT_FLUSH_STOP) {
289     GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
290     GST_DEBUG_OBJECT (self, "Resetting segment");
291     gst_segment_init (&self->segment, GST_FORMAT_UNDEFINED);
292     GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
293   }
294
295   gst_event_unref (event);
296
297   return ret;
298 }
299
300 static void
301 block_proxypad (GstPlaySinkConvertBin * self)
302 {
303   if (self->sink_proxypad_block_id == 0) {
304     self->sink_proxypad_block_id =
305         gst_pad_add_probe (self->sink_proxypad,
306         GST_PAD_PROBE_TYPE_BLOCK_DOWNSTREAM, pad_blocked_cb, self, NULL);
307   }
308 }
309
310 static void
311 unblock_proxypad (GstPlaySinkConvertBin * self)
312 {
313   if (self->sink_proxypad_block_id != 0) {
314     gst_pad_remove_probe (self->sink_proxypad, self->sink_proxypad_block_id);
315     self->sink_proxypad_block_id = 0;
316   }
317 }
318
319 static gboolean
320 gst_play_sink_convert_bin_sink_setcaps (GstPlaySinkConvertBin * self,
321     GstCaps * caps)
322 {
323   GstStructure *s;
324   const gchar *name;
325   gboolean reconfigure = FALSE;
326   gboolean raw;
327
328   GST_DEBUG_OBJECT (self, "setcaps");
329   GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
330   s = gst_caps_get_structure (caps, 0);
331   name = gst_structure_get_name (s);
332
333   if (self->audio) {
334     raw = g_str_equal (name, "audio/x-raw");
335   } else {
336     raw = g_str_equal (name, "video/x-raw");
337   }
338
339   GST_DEBUG_OBJECT (self, "raw %d, self->raw %d, blocked %d",
340       raw, self->raw, gst_pad_is_blocked (self->sink_proxypad));
341
342   if (raw) {
343     if (!gst_pad_is_blocked (self->sink_proxypad)) {
344       GstPad *target = gst_ghost_pad_get_target (GST_GHOST_PAD (self->sinkpad));
345
346       if (!self->raw || (target && !gst_pad_query_accept_caps (target, caps))) {
347         if (!self->raw)
348           GST_DEBUG_OBJECT (self, "Changing caps from non-raw to raw");
349         else
350           GST_DEBUG_OBJECT (self, "Changing caps in an incompatible way");
351
352         reconfigure = TRUE;
353         block_proxypad (self);
354       }
355
356       if (target)
357         gst_object_unref (target);
358     }
359   } else {
360     if (self->raw && !gst_pad_is_blocked (self->sink_proxypad)) {
361       GST_DEBUG_OBJECT (self, "Changing caps from raw to non-raw");
362       reconfigure = TRUE;
363       block_proxypad (self);
364     }
365   }
366
367   /* Otherwise the setcaps below fails */
368   if (reconfigure) {
369     gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->sinkpad), NULL);
370     gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (self->srcpad), NULL);
371   }
372
373   GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
374
375   GST_DEBUG_OBJECT (self, "Setting sink caps %" GST_PTR_FORMAT, caps);
376
377   return TRUE;
378 }
379
380 static GstCaps *
381 gst_play_sink_convert_bin_getcaps (GstPad * pad, GstCaps * filter)
382 {
383   GstPlaySinkConvertBin *self =
384       GST_PLAY_SINK_CONVERT_BIN (gst_pad_get_parent (pad));
385   GstCaps *ret;
386   GstPad *otherpad, *peer;
387
388   GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
389   if (pad == self->srcpad) {
390     otherpad = self->sinkpad;
391   } else if (pad == self->sinkpad) {
392     otherpad = self->srcpad;
393   } else {
394     GST_ERROR_OBJECT (pad, "Not one of our pads");
395     otherpad = NULL;
396   }
397
398   if (otherpad) {
399     peer = gst_pad_get_peer (otherpad);
400     if (peer) {
401       GstCaps *peer_caps = gst_pad_query_caps (peer, filter);
402       gst_object_unref (peer);
403       if (self->converter_caps && is_raw_caps (peer_caps, self->audio)) {
404         ret = gst_caps_merge (peer_caps, gst_caps_ref (self->converter_caps));
405       } else {
406         ret = peer_caps;
407       }
408     } else {
409       ret = gst_caps_ref (self->converter_caps);
410     }
411   } else {
412     ret = gst_caps_new_any ();
413   }
414   GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
415
416   gst_object_unref (self);
417
418   GST_DEBUG_OBJECT (pad, "Returning caps %" GST_PTR_FORMAT, ret);
419
420   return ret;
421 }
422
423 static gboolean
424 gst_play_sink_convert_bin_acceptcaps (GstPad * pad, GstCaps * caps)
425 {
426   GstCaps *allowed_caps;
427   gboolean ret;
428
429   allowed_caps = gst_pad_query_caps (pad, NULL);
430   ret = gst_caps_is_subset (caps, allowed_caps);
431   gst_caps_unref (allowed_caps);
432
433   return ret;
434 }
435
436 static gboolean
437 gst_play_sink_convert_bin_query (GstPad * pad, GstObject * parent,
438     GstQuery * query)
439 {
440   gboolean res = FALSE;
441
442   switch (GST_QUERY_TYPE (query)) {
443     case GST_QUERY_ACCEPT_CAPS:
444     {
445       GstCaps *caps;
446
447       gst_query_parse_accept_caps (query, &caps);
448       gst_query_set_accept_caps_result (query,
449           gst_play_sink_convert_bin_acceptcaps (pad, caps));
450       res = TRUE;
451       break;
452     }
453     case GST_QUERY_CAPS:
454     {
455       GstCaps *filter, *caps;
456
457       gst_query_parse_caps (query, &filter);
458       caps = gst_play_sink_convert_bin_getcaps (pad, filter);
459       gst_query_set_caps_result (query, caps);
460       gst_caps_unref (caps);
461       res = TRUE;
462       break;
463     }
464     default:
465       res = gst_pad_query_default (pad, parent, query);
466       break;
467   }
468   return res;
469 }
470
471 void
472 gst_play_sink_convert_bin_remove_elements (GstPlaySinkConvertBin * self)
473 {
474   if (self->conversion_elements) {
475     g_list_foreach (self->conversion_elements,
476         (GFunc) gst_play_sink_convert_bin_remove_element, self);
477     g_list_free (self->conversion_elements);
478     self->conversion_elements = NULL;
479   }
480   if (self->converter_caps) {
481     gst_caps_unref (self->converter_caps);
482     self->converter_caps = NULL;
483   }
484 }
485
486 static void
487 gst_play_sink_convert_bin_dispose (GObject * object)
488 {
489   GstPlaySinkConvertBin *self = GST_PLAY_SINK_CONVERT_BIN_CAST (object);
490
491   gst_play_sink_convert_bin_remove_elements (self);
492
493   G_OBJECT_CLASS (parent_class)->dispose (object);
494 }
495
496 static void
497 gst_play_sink_convert_bin_finalize (GObject * object)
498 {
499   GstPlaySinkConvertBin *self = GST_PLAY_SINK_CONVERT_BIN_CAST (object);
500
501   gst_object_unref (self->sink_proxypad);
502   g_mutex_clear (&self->lock);
503
504   G_OBJECT_CLASS (parent_class)->finalize (object);
505 }
506
507 void
508 gst_play_sink_convert_bin_cache_converter_caps (GstPlaySinkConvertBin * self)
509 {
510   GstElement *head;
511   GstPad *pad;
512
513   if (self->converter_caps) {
514     gst_caps_unref (self->converter_caps);
515     self->converter_caps = NULL;
516   }
517
518   if (!self->conversion_elements) {
519     GST_INFO_OBJECT (self, "No conversion elements");
520     return;
521   }
522
523   head = GST_ELEMENT (g_list_first (self->conversion_elements)->data);
524   pad = gst_element_get_static_pad (head, "sink");
525   if (!pad) {
526     GST_WARNING_OBJECT (self, "No sink pad found");
527     return;
528   }
529
530   self->converter_caps = gst_pad_query_caps (pad, NULL);
531   GST_INFO_OBJECT (self, "Converter caps: %" GST_PTR_FORMAT,
532       self->converter_caps);
533
534   gst_object_unref (pad);
535 }
536
537 static GstStateChangeReturn
538 gst_play_sink_convert_bin_change_state (GstElement * element,
539     GstStateChange transition)
540 {
541   GstStateChangeReturn ret;
542   GstPlaySinkConvertBin *self = GST_PLAY_SINK_CONVERT_BIN_CAST (element);
543
544   switch (transition) {
545     case GST_STATE_CHANGE_PAUSED_TO_READY:
546       GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
547       unblock_proxypad (self);
548       GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
549       break;
550     case GST_STATE_CHANGE_READY_TO_PAUSED:
551       GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
552       gst_segment_init (&self->segment, GST_FORMAT_UNDEFINED);
553       gst_play_sink_convert_bin_set_targets (self, TRUE);
554       self->raw = FALSE;
555       GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
556       break;
557     default:
558       break;
559   }
560
561   ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
562   if (ret == GST_STATE_CHANGE_FAILURE)
563     return ret;
564
565   switch (transition) {
566     case GST_STATE_CHANGE_PAUSED_TO_READY:
567       GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
568       gst_segment_init (&self->segment, GST_FORMAT_UNDEFINED);
569       gst_play_sink_convert_bin_set_targets (self, TRUE);
570       self->raw = FALSE;
571       GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
572       break;
573     case GST_STATE_CHANGE_READY_TO_PAUSED:
574       GST_PLAY_SINK_CONVERT_BIN_LOCK (self);
575       unblock_proxypad (self);
576       GST_PLAY_SINK_CONVERT_BIN_UNLOCK (self);
577       break;
578     default:
579       break;
580   }
581
582   return ret;
583 }
584
585 static void
586 gst_play_sink_convert_bin_class_init (GstPlaySinkConvertBinClass * klass)
587 {
588   GObjectClass *gobject_class;
589   GstElementClass *gstelement_class;
590
591   GST_DEBUG_CATEGORY_INIT (gst_play_sink_convert_bin_debug,
592       "playsinkconvertbin", 0, "play bin");
593
594   gobject_class = (GObjectClass *) klass;
595   gstelement_class = (GstElementClass *) klass;
596
597   gobject_class->dispose = gst_play_sink_convert_bin_dispose;
598   gobject_class->finalize = gst_play_sink_convert_bin_finalize;
599
600   gst_element_class_add_pad_template (gstelement_class,
601       gst_static_pad_template_get (&srctemplate));
602   gst_element_class_add_pad_template (gstelement_class,
603       gst_static_pad_template_get (&sinktemplate));
604   gst_element_class_set_static_metadata (gstelement_class,
605       "Player Sink Converter Bin", "Bin/Converter",
606       "Convenience bin for audio/video conversion",
607       "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
608
609   gstelement_class->change_state =
610       GST_DEBUG_FUNCPTR (gst_play_sink_convert_bin_change_state);
611 }
612
613 static void
614 gst_play_sink_convert_bin_init (GstPlaySinkConvertBin * self)
615 {
616   GstPadTemplate *templ;
617
618   g_mutex_init (&self->lock);
619   gst_segment_init (&self->segment, GST_FORMAT_UNDEFINED);
620
621   templ = gst_static_pad_template_get (&sinktemplate);
622   self->sinkpad = gst_ghost_pad_new_no_target_from_template ("sink", templ);
623   gst_pad_set_event_function (self->sinkpad,
624       GST_DEBUG_FUNCPTR (gst_play_sink_convert_bin_sink_event));
625   gst_pad_set_query_function (self->sinkpad,
626       GST_DEBUG_FUNCPTR (gst_play_sink_convert_bin_query));
627
628   self->sink_proxypad =
629       GST_PAD_CAST (gst_proxy_pad_get_internal (GST_PROXY_PAD (self->sinkpad)));
630
631   gst_element_add_pad (GST_ELEMENT_CAST (self), self->sinkpad);
632   gst_object_unref (templ);
633
634   templ = gst_static_pad_template_get (&srctemplate);
635   self->srcpad = gst_ghost_pad_new_no_target_from_template ("src", templ);
636   gst_pad_set_query_function (self->srcpad,
637       GST_DEBUG_FUNCPTR (gst_play_sink_convert_bin_query));
638   gst_element_add_pad (GST_ELEMENT_CAST (self), self->srcpad);
639   gst_object_unref (templ);
640
641   gst_play_sink_convert_bin_add_identity (self);
642 }