Cluttermm progrmming

Clutter這是一個相當不錯的open source project。
在第一次看到是在jserv的blog，之後就相當喜愛。
只可惜一直沒機會把玩一番。

一次的偶然之中，朋友希望能用C++ binding for clutter設計一些東西，
雖然計劃最後告吹(被打)，但為了不讓那一陣子的努力化為烏有，
覺得還是可以分享一些東西，也做一個小記錄。

C++ binding clutter就稱為cluttermm。可以在這裡下載得到。
自己懶得包deb了，所以不會tarball安裝的...請參考鳥哥的Linux私房菜吧(煙)

stage算是clutter的最主要的部份之一。
每一個clutter的程式，最少都包含了一個stage。

stage範例如下：

1. #include <cluttermm.h>
2. 
   
3. int main(int argc, char *argv[])
4. {
5. Clutter::init(&argc, &argv);
6. 
   
7. Clutter::Color color(0x61, 0x64, 0x8c, 0xff);
8. 
   
9. Glib::RefPtr<Clutter::Stage> stage = Clutter::Stage::get_default();
10. stage->set_size(200, 200);
11. stage->set_color(color);
12. stage->show();
13. 
    
14. Clutter::main();
15. 
    
16. return 0;
17. }

這範例算得上是hello world級的程式囉。
第9行宣告並建立一個stage的Clutter:Stage的物件後，
就利用set_size, set_color及show等成員函式，設定屬性。
最後由Clutter::main()執行。

有了stage，總得對Clutter的signal做一個介紹

1. #include <cluttermm.h>
2. #include <iostream>
3. 
   
4. bool on_button_press(Clutter::ButtonEvent *event, const Glib::RefPtr<Clutter::Stage>& stage)
5. {
6. Glib::RefPtr<Clutter::Actor> e = stage->get_actor_at_pos(event->x, event->y);
7. 
   
8. std::cout << "*** (x, y) = ( " << event->x << ", " << event->y << ")" << std::endl;
9. 
   
10. return true;
11. 
    
12. }
13. 
    
14. bool on_key_release(Clutter::KeyEvent *event)
15. {
16. std::cout << "*** key press event (key:" << Clutter::key_event_symbol(event) << ") ***\n";
17. 
    
18. if(Clutter::key_event_symbol(event) == CLUTTER_q)
19. Clutter::main_quit();
20. 
    
21. return false;
22. 
    
23. }
24. 
    
25. int main(int argc, char *argv[])
26. {
27. Clutter::init(&argc, &argv);
28. 
    
29. Clutter::Color color(0x61, 0x64, 0x8c, 0xff);
30. 
    
31. Glib::RefPtr<Clutter::Stage> stage = Clutter::Stage::get_default();
32. stage->set_size(200, 200);
33. stage->set_color(color);
34. stage->signal_button_press_event().connect(sigc::bind(sigc::ptr_fun(on_button_press), stage));
35. stage->signal_key_release_event().connect(sigc::ptr_fun(on_key_release));
36. stage->show();
37. 
    
38. Clutter::main();
39. 
    
40. return 0;
41. }
42. 
    

signal這範例，是由stage範例延伸而來的。(紅色為新增之部份)
主要就是註冊了二個event：button_press及key_release。

• button_press就是在stage中按下滑鼠的左鍵後，會被呼叫的動作
• key_release則是在鍵盤上按下任一按鍵，會被呼叫的動作

在介紹了stage及signal後，當然不能少了actor。
Clutter中，actor有著相當多的分類：

• Base actors

- ClutterRectangle — An actor that displays a simple rectangle.

- ClutterTexture — An actor for displaying and manipulating images.

- ClutterCloneTexture — Actor for cloning existing textures in an efficient way.

- ClutterLabel — Actor for displaying text

- ClutterEntry — A single line text entry actor

• Container actors

- ClutterGroup — Actor class containing multiple children. actors.

- ClutterStage — Top level visual element to which actors are placed.

僅以label做為範例介紹(被拖走)：

1. #include <cluttermm.h>
2. #include <iostream>
3. 
   
4. bool on_button_press(Clutter::ButtonEvent *event, const Glib::RefPtr<Clutter::Label>& label)
5. {
6. int x;
7. int y;
8. label->get_position(x, y);
9. label->set_position(x+2, y+2);
10. 
    
11. return true;
12. }
13. 
    
14. bool on_button_release(Clutter::ButtonEvent *event, const Glib::RefPtr<Clutter::Label>& label)
15. {
16. int x;
17. int y;
18. label->get_position(x, y);
19. label->set_position(x-2, y-2);
20. 
    
21. return true;
22. }
23. 
    
24. bool on_key_release(Clutter::KeyEvent *event)
25. {
26. std::cout << "*** key press event (key:" << Clutter::key_event_symbol(event) << ") ***\n";
27. 
    
28. if(Clutter::key_event_symbol(event) == CLUTTER_q)
29. Clutter::main_quit();
30. 
    
31. return false;
32. 
    
33. }
34. 
    
35. int main(int argc, char *argv[])
36. {
37. Clutter::init(&argc, &argv);
38. 
    
39. Clutter::Color color(0x61, 0x64, 0x8c, 0xff);
40. Clutter::Color actor(0xFF, 0xBB, 0xAA, 0xff);
41. 
    
42. Glib::RefPtr<Clutter::Stage> stage = Clutter::Stage::get_default();
43. Glib::RefPtr<Clutter::Label> label = Clutter::Label::create("Sans 12", "test", actor);
44. stage->set_size(200, 200);
45. stage->set_color(color);
46. stage->signal_button_press_event().connect(sigc::bind(sigc::ptr_fun(on_button_press), label));
47. stage->signal_button_release_event().connect(sigc::bind(sigc::ptr_fun(on_button_release), label));
48. stage->signal_key_release_event().connect(sigc::ptr_fun(on_key_release));
49. stage->show();
50. 
    
51. label->set_size(40, 40);
52. label->set_position(20, 20);
53. label->show();
54. 
    
55. stage->add_actor(label);
56. 
    
57. Clutter::main();
58. 
    
59. return 0;
60. }

這個範例效果相當地簡單，在stage中按下了滑鼠左鍵後，會將字型做一平移，
等到滑鼠左鍵被放開，就恢復原狀。

當actor產生後，總是要有stage才能有其用處，所以
Clutter利用add_actor()將actor的物件，加入stage之中。