【GStreamer开发】GStreamer播放教程05——色彩平衡

目标

亮度，对比度，色度和饱和度都是常见的视频调节参数，也是GStreamer里面设置色彩平衡的参数。本教程将展示：

如何发现可用的色彩平衡通道

如何改变它们

介绍

《GStreamer基础教程05——集成GUI工具》里面已经解释了GObject接口：应用通过它们来获得特定功能，而不用去管具体的element的实现。

playbin2实现了色彩平衡的接口（gstcolorbalance），这就可以设置色彩平衡了。如果playbin2里面的任何一个element支持了这个接口，playbin2就仅仅简单地把应用的设置传给element，否则就会在pipeline中增加一个色彩平衡的element。

这个接口允许查询可用的色彩平衡通道（gstcolorbalancechannel），包括它们的名字和值得有效区间，然后调整当前的值。

色彩平衡例子

[objc] view
plain copy

1. #include <string.h>
2. #include <gst/gst.h>
3. #include <gst/interfaces/colorbalance.h>
4. typedef struct _CustomData {
5. GstElement *pipeline;
6. GMainLoop *loop;
7. } CustomData;
8. /* Process a color balance command */
9. static void update_color_channel (const gchar *channel_name, gboolean increase, GstColorBalance *cb) {
10. gdouble step;
11. gint value;
12. GstColorBalanceChannel *channel = NULL;
13. const GList *channels, *l;
14. /* Retrieve the list of channels and locate the requested one */
15. channels = gst_color_balance_list_channels (cb);
16. for (l = channels; l != NULL; l = l->next) {
17. GstColorBalanceChannel *tmp = (GstColorBalanceChannel *)l->data;
18. if (g_strrstr (tmp->label, channel_name)) {
19. channel = tmp;
20. break;
21. }
22. }
23. if (!channel)
24. return;
25. /* Change the channel's value */
26. .1 * (channel->max_value - channel->min_value);
27. value = gst_color_balance_get_value (cb, channel);
28. if (increase) {
29. value = (gint)(value + step);
30. if (value > channel->max_value)
31. value = channel->max_value;
32. } else {
33. value = (gint)(value - step);
34. if (value < channel->min_value)
35. value = channel->min_value;
36. }
37. gst_color_balance_set_value (cb, channel, value);
38. }
39. /* Output the current values of all Color Balance channels */
40. static void print_current_values (GstElement *pipeline) {
41. const GList *channels, *l;
42. /* Output Color Balance values */
43. channels = gst_color_balance_list_channels (GST_COLOR_BALANCE (pipeline));
44. for (l = channels; l != NULL; l = l->next) {
45. GstColorBalanceChannel *channel = (GstColorBalanceChannel *)l->data;
46. gint value = gst_color_balance_get_value (GST_COLOR_BALANCE (pipeline), channel);
47. g_print ("%s: %3d%% ", channel->label,
48. 100 * (value - channel->min_value) / (channel->max_value - channel->min_value));
49. }
50. g_print ("\n");
51. }
52. /* Process keyboard input */
53. static gboolean handle_keyboard (GIOChannel *source, GIOCondition cond, CustomData *data) {
54. gchar *str = NULL;
55. if (g_io_channel_read_line (source, &str, NULL, NULL, NULL) != G_IO_STATUS_NORMAL) {
56. return TRUE;
57. }
58. ])) {
59. case 'c':
60. ]), GST_COLOR_BALANCE (data->pipeline));
61. break;
62. case 'b':
63. ]), GST_COLOR_BALANCE (data->pipeline));
64. break;
65. case 'h':
66. ]), GST_COLOR_BALANCE (data->pipeline));
67. break;
68. case 's':
69. ]), GST_COLOR_BALANCE (data->pipeline));
70. break;
71. case 'q':
72. g_main_loop_quit (data->loop);
73. break;
74. default:
75. break;
76. }
77. g_free (str);
78. print_current_values (data->pipeline);
79. return TRUE;
80. }
81. int main(int argc, charchar *argv[]) {
82. CustomData data;
83. GstStateChangeReturn ret;
84. GIOChannel *io_stdin;
85. /* Initialize GStreamer */
86. gst_init (&argc, &argv);
87. /* Initialize our data structure */
88. , sizeof (data));
89. /* Print usage map */
90. g_print (
91. "USAGE: Choose one of the following options, then press enter:\n"
92. " 'C' to increase contrast, 'c' to decrease contrast\n"
93. " 'B' to increase brightness, 'b' to decrease brightness\n"
94. " 'H' to increase hue, 'h' to decrease hue\n"
95. " 'S' to increase saturation, 's' to decrease saturation\n"
96. " 'Q' to quit\n");
97. /* Build the pipeline */
98. data.pipeline = gst_parse_launch ("playbin2 uri=http://docs.gstreamer.com/media/sintel_trailer-480p.webm", NULL);
99. /* Add a keyboard watch so we get notified of keystrokes */
100. #ifdef _WIN32
101. 2_new_fd (fileno (stdin));
102. #else
103. io_stdin = g_io_channel_unix_new (fileno (stdin));
104. #endif
105. g_io_add_watch (io_stdin, G_IO_IN, (GIOFunc)handle_keyboard, &data);
106. /* Start playing */
107. ret = gst_element_set_state (data.pipeline, GST_STATE_PLAYING);
108. if (ret == GST_STATE_CHANGE_FAILURE) {
109. g_printerr ("Unable to set the pipeline to the playing state.\n");
110. gst_object_unref (data.pipeline);
111. ;
112. }
113. print_current_values (data.pipeline);
114. /* Create a GLib Main Loop and set it to run */
115. data.loop = g_main_loop_new (NULL, FALSE);
116. g_main_loop_run (data.loop);
117. /* Free resources */
118. g_main_loop_unref (data.loop);
119. g_io_channel_unref (io_stdin);
120. gst_element_set_state (data.pipeline, GST_STATE_NULL);
121. gst_object_unref (data.pipeline);
122. ;
123. }

工作流程

main()函数非常的简单。用一个playbin2的建立pipeline，注册一个键盘处理函数来监控按键。

[objc] view
plain copy

1. /* Output the current values of all Color Balance channels */
2. static void print_current_values (GstElement *pipeline) {
3. const GList *channels, *l;
4. /* Output Color Balance values */
5. channels = gst_color_balance_list_channels (GST_COLOR_BALANCE (pipeline));
6. for (l = channels; l != NULL; l = l->next) {
7. GstColorBalanceChannel *channel = (GstColorBalanceChannel *)l->data;
8. gint value = gst_color_balance_get_value (GST_COLOR_BALANCE (pipeline), channel);
9. g_print ("%s: %3d%% ", channel->label,
10. 100 * (value - channel->min_value) / (channel->max_value - channel->min_value));
11. }
12. g_print ("\n");
13. }

这个方法展示了如何获得通道的列表并打印所有通道当前的值。这是通过gst_color_balance_list_channels()方法来实现的，它会返回一个GList结构，我们遍历这个结构即可。

在这个列表里面的每一个element都是GstColorBalanceChannel结构，包括通道名，最小值和最大值。然后就可以在每个通道调用gst_color_balance_get_value()方法来获得当前值。

在这个例子中，当前值常常用占最大值的百分比来显示。

[objc] view
plain copy

1. /* Process a color balance command */
2. static void update_color_channel (const gchar *channel_name, gboolean increase, GstColorBalance *cb) {
3. gdouble step;
4. gint value;
5. GstColorBalanceChannel *channel = NULL;
6. const GList *channels, *l;
7. /* Retrieve the list of channels and locate the requested one */
8. channels = gst_color_balance_list_channels (cb);
9. for (l = channels; l != NULL; l = l->next) {
10. GstColorBalanceChannel *tmp = (GstColorBalanceChannel *)l->data;
11. if (g_strrstr (tmp->label, channel_name)) {
12. channel = tmp;
13. break;
14. }
15. }
16. if (!channel)
17. return;

这个方法通过指定通道名来确定通道，然后根据操作增加或者减少值。另外，通道列表的获得后是根据指定的名字来解析获得通道的。很显然，这个列表只应该解析一次，指向通道的指针需要保持在比一个字符串更高效的数据结构中。

[objc] view
plain copy

1. /* Change the channel's value */
2. .1 * (channel->max_value - channel->min_value);
3. value = gst_color_balance_get_value (cb, channel);
4. if (increase) {
5. value = (gint)(value + step);
6. if (value > channel->max_value)
7. value = channel->max_value;
8. } else {
9. value = (gint)(value - step);
10. if (value < channel->min_value)
11. value = channel->min_value;
12. }
13. gst_color_balance_set_value (cb, channel, value);

然后就获得当前通道的值，修改它但确保它的值有效，使用gst_color_balance_set_value()来设置。

其它没有什么了。运行一下这个程序实际看一下效果。