【GStreamer开发】GStreamer基础教程15——继承Clutter

目标

Clutter是一个开源的库，用来创建快速、可移植和动态的GUI。GStreamer可以通过cluttersink这个element把clutter集成进来，允许视频像纹理一样使用。本教程会展示：

如何把GStreamer pipeline的视频输出在clutter里面作为纹理来处理

介绍

连接GStreamer和clutter的流程实际上非常简单。我们必须使用cluttersink这个element（或者autocluttersink）并把它作为视频的sink。通过texture这个属性，这个element接受一个被GStreamer刷新的clutter的纹理。

一个3D的媒体播放器

[objc] view
plain copy

1. <span style="font-size:14px;">#include <clutter-gst/clutter-gst.h>
2. /* Setup the video texture once its size is known */
3. void size_change (ClutterActor *texture, gint width, gint height, gpointer user_data) {
4. ClutterActor *stage;
5. gfloat new_x, new_y, new_width, new_height;
6. gfloat stage_width, stage_height;
7. ClutterAnimation *animation = NULL;
8. stage = clutter_actor_get_stage (texture);
9. if (stage == NULL)
10. return;
11. clutter_actor_get_size (stage, &stage_width, &stage_height);
12. /* Center video on window and calculate new size preserving aspect ratio */
13. new_height = (height * stage_width) / width;
14. if (new_height <= stage_height) {
15. new_width = stage_width;
16. ;
17. ;
18. } else {
19. new_width  = (width * stage_height) / height;
20. new_height = stage_height;
21. ;
22. ;
23. }
24. clutter_actor_set_position (texture, new_x, new_y);
25. clutter_actor_set_size (texture, new_width, new_height);
26. .0, stage_width / 2, 0, 0);
27. /* Animate it */
28. 0000, "rotation-angle-y", 360.0, NULL);
29. clutter_animation_set_loop (animation, TRUE);
30. }
31. int main(int argc, charchar *argv[]) {
32. GstElement *pipeline, *sink;
33. ClutterTimeline *timeline;
34. ClutterActor *stage, *texture;
35. /* clutter-gst takes care of initializing Clutter and GStreamer */
36. if (clutter_gst_init (&argc, &argv) != CLUTTER_INIT_SUCCESS) {
37. g_error ("Failed to initialize clutter\n");
38. ;
39. }
40. stage = clutter_stage_get_default ();
41. /* Make a timeline */
42. 000);
43. g_object_set(timeline, "loop", TRUE, NULL);
44. /* Create new texture and disable slicing so the video is properly mapped onto it */
45. texture = CLUTTER_ACTOR (g_object_new (CLUTTER_TYPE_TEXTURE, "disable-slicing", TRUE, NULL));
46. g_signal_connect (texture, "size-change", G_CALLBACK (size_change), NULL);
47. /* Build the GStreamer pipeline */
48. pipeline = gst_parse_launch ("playbin2 uri=http://docs.gstreamer.com/media/sintel_trailer-480p.webm", NULL);
49. /* Instantiate the Clutter sink */
50. sink = gst_element_factory_make ("autocluttersink", NULL);
51. if (sink == NULL) {
52. /* Revert to the older cluttersink, in case autocluttersink was not found */
53. sink = gst_element_factory_make ("cluttersink", NULL);
54. }
55. if (sink == NULL) {
56. g_printerr ("Unable to find a Clutter sink.\n");
57. ;
58. }
59. /* Link GStreamer with Clutter by passing the Clutter texture to the Clutter sink*/
60. g_object_set (sink, "texture", texture, NULL);
61. /* Add the Clutter sink to the pipeline */
62. g_object_set (pipeline, "video-sink", sink, NULL);
63. /* Start playing */
64. gst_element_set_state (pipeline, GST_STATE_PLAYING);
65. /* start the timeline */
66. clutter_timeline_start (timeline);
67. /* Add texture to the stage, and show it */
68. clutter_group_add (CLUTTER_GROUP (stage), texture);
69. clutter_actor_show_all (stage);
70. clutter_main();
71. /* Free resources */
72. gst_element_set_state (pipeline, GST_STATE_NULL);
73. gst_object_unref (pipeline);
74. ;
75. }
76. </span>

工作流程

这篇教程的目的不是教你如何使用clutter，而是如何把它集成到GStreamer里来。这个工作通过clutter-gst库来完成，所以它的头文件必须包含进来。

[objc] view
plain copy

1. <span style="font-size:14px;">#include <clutter-gst/clutter-gst.h></span>

这个库的第一件事是初始化GStreamer和Clutter，所以你调用clutter-gst-init()方法而不是自己来初始化。

[objc] view
plain copy

1. /* clutter-gst takes care of initializing Clutter and GStreamer */
2. if (clutter_gst_init (&argc, &argv) != CLUTTER_INIT_SUCCESS) {
3. g_error ("Failed to initialize clutter\n");
4. ;
5. }

GStreamer视频是作为Clutter的纹理来播放，所以我们需要创建一个纹理。请记住关闭纹理的切片：

[objc] view
plain copy

1. /* Create new texture and disable slicing so the video is properly mapped onto it */
2. texture = CLUTTER_ACTOR (g_object_new (CLUTTER_TYPE_TEXTURE, "disable-slicing", TRUE, NULL));
3. g_signal_connect (texture, "size-change", G_CALLBACK (size_change), NULL);

我们注册size-change信号，这样我们一旦知道视频的尺寸之后就可以做最后的设置。

[objc] view
plain copy

1. /* Instantiate the Clutter sink */
2. sink = gst_element_factory_make ("autocluttersink", NULL);
3. if (sink == NULL) {
4. /* Revert to the older cluttersink, in case autocluttersink was not found */
5. sink = gst_element_factory_make ("cluttersink", NULL);
6. }
7. if (sink == NULL) {
8. g_printerr ("Unable to find a Clutter sink.\n");
9. ;
10. }

正确创建的Clutter sink element是autocluttersink，这个element工作起来或多或少的像autovideosink。然而，autocluttersink在2012.7后发布的SDK里面才有，如果找不到这个element，那么创建cluttersink来代替。

[objc] view
plain copy

1. /* Link GStreamer with Clutter by passing the Clutter texture to the Clutter sink*/
2. g_object_set (sink, "texture", texture, NULL);

这个纹理是GStreamer唯一需要了解的关于Clutter的内容。

[objc] view
plain copy

1. /* Add the Clutter sink to the pipeline */
2. g_object_set (pipeline, "video-sink", sink, NULL);

最后，告诉playbin2使用我们创建的sink而不是默认的。

然后GStreamer的pipeline和Clutter的timeline就开始工作了。一旦pipeline获得了视频的尺寸，我们在收到一个通知后更新Clutter的纹理，调用size_change的回调。这个方法会把纹理设置正确地尺寸，把它输出到窗口的中心然后开始做动画旋转（仅供演示使用），当然，这个和GStreamer就没有任何关系了。