Initialize parts and callbacks hashes on first usage.
[ruby-edje.git] / src / rb_edje.c
index c85e594bed7d4e3fe3375023a99dbb66c63fb237..1605ceb4a210837debf895f23feb4016b0636614 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * $Id: rb_edje.c 48 2004-07-31 13:46:07Z tilman $
+ * $Id: rb_edje.c 307 2005-03-23 17:30:30Z tilman $
  *
  * Copyright (C) 2004 Tilman Sauerbeck (tilman at code-monkey de)
  *
 #include <ruby.h>
 
 #include <Edje.h>
-#include <rb_evas.h>
-#include <rb_evas_object.h>
+#include <evas/rb_evas.h>
+#include <evas/rb_evas_object.h>
 
 #define __RB_EDJE_C
+#include "rb_edje.h"
 #include "rb_edje_main.h"
 #include "rb_part.h"
-
-typedef struct {
-       Evas_Object *real;
-       VALUE parts;
-       VALUE callbacks;
-} RbEdje;
+#include "rb_messages.h"
 
 VALUE cEdje;
 
@@ -40,32 +36,46 @@ static void c_mark (RbEdje *e)
 {
        c_evas_object_mark (&e->real);
 
-       rb_gc_mark (e->parts);
-       rb_gc_mark (e->callbacks);
+       if (!NIL_P (e->parts))
+               rb_gc_mark (e->parts);
+
+       if (!NIL_P (e->callbacks))
+               rb_gc_mark (e->callbacks);
+
+       if (!NIL_P (e->on_text_changed_cb))
+               rb_gc_mark (e->on_text_changed_cb);
 }
 
 static void c_free (RbEdje *e)
 {
-       c_evas_object_free (&e->real);
+       c_evas_object_free (&e->real, false);
+       free (e);
 
        edje_shutdown ();
 }
 
+/*
+ * call-seq:
+ *  Edje::Edje.new(evas) => edje
+ *
+ * Creates an Edje::Edje object.
+ */
 static VALUE c_new (VALUE klass, VALUE evas)
 {
        VALUE self, argv[1];
-       RbEdje *edje;
+       RbEdje *edje = NULL;
 
        CHECK_CLASS (evas, cEvas);
-       GET_OBJ (evas, Evas *, e);
+       GET_OBJ (evas, RbEvas, e);
 
        edje_init ();
 
        self = Data_Make_Struct (klass, RbEdje, c_mark, c_free, edje);
 
-       edje->real = edje_object_add (*e);
-       edje->parts = rb_hash_new ();
-       edje->callbacks = rb_ary_new ();
+       edje->real.real = edje_object_add (e->real);
+       edje->parts = Qnil;
+       edje->callbacks = Qnil;
+       edje->on_text_changed_cb = Qnil;
 
        argv[0] = evas;
        rb_obj_call_init (self, 1, argv);
@@ -73,24 +83,43 @@ static VALUE c_new (VALUE klass, VALUE evas)
        return self;
 }
 
+/*
+ * call-seq:
+ *  edje.freeze => nil
+ *
+ * Freezes <i>edje</i>.
+ */
 static VALUE c_freeze (VALUE self)
 {
        GET_OBJ (self, RbEdje, e);
 
-       edje_object_freeze (e->real);
+       edje_object_freeze (e->real.real);
 
        return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.thaw => nil
+ *
+ * Thaws <i>edje</i>.
+ */
 static VALUE c_thaw (VALUE self)
 {
        GET_OBJ (self, RbEdje, e);
 
-       edje_object_thaw (e->real);
+       edje_object_thaw (e->real.real);
 
        return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.load(eet, group) => nil
+ *
+ * Loads <i>eet</i> into <i>edje</i>. <i>group</i> is the
+ * name of the group to be displayed.
+ */
 static VALUE c_load (VALUE self, VALUE eet, VALUE group)
 {
        GET_OBJ (self, RbEdje, e);
@@ -98,35 +127,56 @@ static VALUE c_load (VALUE self, VALUE eet, VALUE group)
        Check_Type (eet, T_STRING);
        Check_Type (group, T_STRING);
 
-       if (!edje_object_file_set (e->real, StringValuePtr (eet),
+       if (!edje_object_file_set (e->real.real, StringValuePtr (eet),
                                   StringValuePtr (group)))
                rb_raise (rb_eException, "Cannot load eet");
 
        return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.get_size_min => array
+ *
+ * Returns an array that contains the minimum size
+ * of <i>edje</i>.
+ */
 static VALUE c_get_size_min (VALUE self)
 {
        int w = 0, h = 0;
 
        GET_OBJ (self, RbEdje, e);
 
-       edje_object_size_min_get (e->real, &w, &h);
+       edje_object_size_min_get (e->real.real, &w, &h);
 
        return rb_ary_new3 (2, INT2FIX (w), INT2FIX (h));
 }
 
+/*
+ * call-seq:
+ *  edje.get_size_max => array
+ *
+ * Returns an array that contains the maximum size
+ * of <i>edje</i>.
+ */
 static VALUE c_get_size_max (VALUE self)
 {
        int w = 0, h = 0;
 
        GET_OBJ (self, RbEdje, e);
 
-       edje_object_size_max_get (e->real, &w, &h);
+       edje_object_size_max_get (e->real.real, &w, &h);
 
        return rb_ary_new3 (2, INT2FIX (w), INT2FIX (h));
 }
 
+/*
+ * call-seq:
+ *  edje.part_exists?(part) => true or false
+ *
+ * Returns true if <i>edje</i> has a part called <i>part</i>,
+ * else returns false.
+ */
 static VALUE c_part_exists_get (VALUE self, VALUE name)
 {
        int r;
@@ -135,21 +185,33 @@ static VALUE c_part_exists_get (VALUE self, VALUE name)
 
        Check_Type (name, T_STRING);
 
-       r = edje_object_part_exists (e->real, StringValuePtr (name));
+       r = edje_object_part_exists (e->real.real, StringValuePtr (name));
 
        return r ? Qtrue : Qfalse;
 }
 
+/*
+ * call-seq:
+ *  edje.part(part_name) => part
+ *
+ * Returns the <code>Edje::Part</code> object that corresponds to
+ * <i>part_name</i>. If there's no part with that name in <i>edje</i>,
+ * an exception is raised.
+ */
 static VALUE c_part_get (VALUE self, VALUE name)
 {
        VALUE part;
 
        GET_OBJ (self, RbEdje, e);
-
        Check_Type (name, T_STRING);
 
-       if (!edje_object_part_exists (e->real, StringValuePtr (name)))
+       if (!edje_object_part_exists (e->real.real, StringValuePtr (name))) {
+               rb_raise (rb_eException, "Unknown part name");
                return Qnil;
+       }
+
+       if (NIL_P (e->parts))
+               e->parts = rb_hash_new ();
 
        if (NIL_P (part = rb_hash_aref (e->parts, name))) {
                part = TO_PART (self, name);
@@ -159,13 +221,36 @@ static VALUE c_part_get (VALUE self, VALUE name)
        return part;
 }
 
-static void on_text_changed (void *data, Evas_Object *e,
-                             const char *part)
+static void on_text_changed (void *data, Evas_Object *eo,
+                             const char *part_name)
 {
-       rb_funcall ((VALUE) data, rb_intern ("call"), 1,
-                   rb_str_new2 (part));
+       VALUE self = (VALUE) data, part, name;
+
+       GET_OBJ (self, RbEdje, e);
+
+       name = rb_str_new2 (part_name);
+
+       if (NIL_P (e->parts))
+               e->parts = rb_hash_new ();
+
+       if (NIL_P (part = rb_hash_aref (e->parts, name))) {
+               part = TO_PART (self, name);
+               rb_hash_aset (e->parts, name, part);
+       }
+
+       rb_funcall (e->on_text_changed_cb,
+                   rb_intern ("call"), 1, part);
 }
 
+/*
+ * call-seq:
+ *  edje.on_text_changed { |part_obj| block }
+ *
+ * Registers a callback that will get called when the text
+ * of any part is changed in <i>edje</i>.
+ * The block is passed the <code>Edje::Part</code> object
+ * of which the text changed.
+ */
 static VALUE c_on_text_changed (VALUE self)
 {
        GET_OBJ (self, RbEdje, e);
@@ -173,86 +258,173 @@ static VALUE c_on_text_changed (VALUE self)
        if (!rb_block_given_p ())
                return Qnil;
 
-       edje_object_text_change_cb_set (e->real, on_text_changed,
-                                       (void *) rb_block_proc ());
+       e->on_text_changed_cb = rb_block_proc ();
+
+       edje_object_text_change_cb_set (e->real.real, on_text_changed,
+                                       (void *) self);
 
        return Qnil;
 }
 
-static VALUE c_emit_signal (VALUE self, VALUE emission, VALUE source)
+/*
+ * call-seq:
+ *  edje.emit_signal(signal, source) => nil
+ *
+ * Emits a signal to <i>edje</i>.
+ *
+ *  edje.emit_signal("signal_foo", "part_bar") #=> nil
+ */
+static VALUE c_emit_signal (VALUE self, VALUE signal, VALUE source)
 {
        GET_OBJ (self, RbEdje, e);
 
-       Check_Type (emission, T_STRING);
+       Check_Type (signal, T_STRING);
        Check_Type (source, T_STRING);
 
-       edje_object_signal_emit (e->real, StringValuePtr (emission),
+       edje_object_signal_emit (e->real.real, StringValuePtr (signal),
                                 StringValuePtr (source));
 
        return Qnil;
 }
 
 static void on_signal (void *data, Evas_Object *o,
-                       const char *emission, const char *src)
+                       const char *signal, const char *src)
 {
        rb_funcall ((VALUE) data, rb_intern ("call"), 2,
-                   rb_str_new2 (emission), rb_str_new2 (src));
+                   rb_str_new2 (signal), rb_str_new2 (src));
 }
 
-static VALUE c_on_signal (VALUE self, VALUE signal, VALUE src)
+/*
+ * call-seq:
+ *  edje.on_signal(signal [, source]) { |signal, source| block } => nil
+ *
+ * Registers a callback that will get called when <i>signal</i>
+ * is emitted by <i>source</i>.
+ * If source is nil, "*" will be used instead.
+ * The block is passed two strings, signal and source, which identify
+ * the emission.
+ */
+static VALUE c_on_signal (int argc, VALUE *argv, VALUE self)
 {
-       VALUE cb;
+       VALUE signal, src, cb;
+       char *ssrc = "*";
 
        GET_OBJ (self, RbEdje, e);
 
+       rb_scan_args (argc, argv, "11", &signal, &src);
+
        Check_Type (signal, T_STRING);
-       Check_Type (src, T_STRING);
+
+       if (!NIL_P (src)) {
+               Check_Type (src, T_STRING);
+               ssrc = StringValuePtr (src);
+       }
 
        if (!rb_block_given_p ())
                return Qnil;
 
        cb = rb_block_proc ();
+
+       if (NIL_P (e->callbacks))
+               e->callbacks = rb_ary_new ();
+
        rb_ary_push (e->callbacks, cb);
 
-       edje_object_signal_callback_add (e->real, StringValuePtr (signal),
-                                        StringValuePtr (src), on_signal,
-                                        (void *) cb);
+       edje_object_signal_callback_add (e->real.real,
+                                        StringValuePtr (signal),
+                                        ssrc, on_signal, (void *) cb);
 
        return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.play? => true or false
+ *
+ * Returns true if <i>edje</i> is in play mode, else returns false.
+ */
 static VALUE c_play_get (VALUE self)
 {
        GET_OBJ (self, RbEdje, e);
 
-       return edje_object_play_get (e->real) ? Qtrue : Qfalse;
+       return edje_object_play_get (e->real.real) ? Qtrue : Qfalse;
 }
 
+/*
+ * call-seq:
+ *  edje.play(true or false)
+ *
+ * Sets <i>edje</i> to play resp. pause mode.
+ */
 static VALUE c_play_set (VALUE self, VALUE val)
 {
        GET_OBJ (self, RbEdje, e);
 
        CHECK_BOOL(val);
 
-       edje_object_play_set (e->real, val == Qtrue);
+       edje_object_play_set (e->real.real, val == Qtrue);
 
        return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.animation? => true or false
+ *
+ * Returns the animation state of <i>edje</i>.
+ */
 static VALUE c_animation_get (VALUE self)
 {
        GET_OBJ (self, RbEdje, e);
 
-       return edje_object_animation_get (e->real) ? Qtrue : Qfalse;
+       return edje_object_animation_get (e->real.real) ? Qtrue : Qfalse;
 }
 
+/*
+ * call-seq:
+ *  edje.animation(true or false)
+ *
+ * Sets the animation state of <i>edje</i>.
+ */
 static VALUE c_animation_set (VALUE self, VALUE val)
 {
        GET_OBJ (self, RbEdje, e);
 
        CHECK_BOOL(val);
 
-       edje_object_animation_set (e->real, val == Qtrue);
+       edje_object_animation_set (e->real.real, val == Qtrue);
+
+       return Qnil;
+}
+
+static VALUE c_data_get (VALUE self, VALUE key)
+{
+       const char *s;
+
+       GET_OBJ (self, RbEdje, e);
+
+       Check_Type (key, T_STRING);
+
+       s = edje_object_data_get (e->real.real, StringValuePtr (key));
+
+       return s ? rb_str_new2 (s) : Qnil;
+}
+
+static VALUE c_send_message (VALUE self, VALUE msg)
+{
+       VALUE m;
+       Edje_Message_Type type;
+       int id;
+
+       GET_OBJ (self, RbEdje, e);
+
+       CHECK_CLASS (msg, cMsg);
+
+       type = NUM2INT (rb_iv_get (msg, "@type"));
+       id = NUM2INT (rb_iv_get (msg, "@id"));
+       m = rb_funcall (msg, rb_intern ("serialize"), 0, NULL);
+
+       edje_object_message_send (e->real.real, type, id, (void *) m);
 
        return Qnil;
 }
@@ -271,9 +443,11 @@ void Init_Edje (void)
        rb_define_method (cEdje, "part", c_part_get, 1);
        rb_define_method (cEdje, "on_text_changed", c_on_text_changed, 0);
        rb_define_method (cEdje, "emit_signal", c_emit_signal, 2);
-       rb_define_method (cEdje, "on_signal", c_on_signal, 2);
+       rb_define_method (cEdje, "on_signal", c_on_signal, -1);
        rb_define_method (cEdje, "play?", c_play_get, 0);
        rb_define_method (cEdje, "play=", c_play_set, 1);
        rb_define_method (cEdje, "animation?", c_animation_get, 0);
        rb_define_method (cEdje, "animation=", c_animation_set, 1);
+       rb_define_method (cEdje, "data", c_data_get, 1);
+       rb_define_method (cEdje, "send_message", c_send_message, 1);
 }