X-Git-Url: http://git.code-monkey.de/?p=ruby-edje.git;a=blobdiff_plain;f=src%2Frb_edje.c;h=711df113b0d1a4bf259242d1d1dd55477f2ff7b1;hp=57509cfc37044e2e0bff0b69e831017bd64556f3;hb=2a5118f22e227a5ce2c2a46e6a4bdc4f6bc86ca2;hpb=3a9c35673bdd0dc885f7474865be23d6d0061789

diff --git a/src/rb_edje.c b/src/rb_edje.c
index 57509cf..711df11 100644
--- a/src/rb_edje.c
+++ b/src/rb_edje.c
@@ -1,5 +1,5 @@
 /*
- * $Id: rb_edje.c 51 2004-08-01 10:19:02Z tilman $
+ * $Id: rb_edje.c 129 2004-10-22 17:03:35Z tilman $
  *
  * Copyright (C) 2004 Tilman Sauerbeck (tilman at code-monkey de)
  *
@@ -49,6 +49,12 @@ static void c_free (RbEdje *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];
@@ -72,6 +78,12 @@ 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);
@@ -81,6 +93,12 @@ static VALUE c_freeze (VALUE self)
 	return Qnil;
 }
 
+/*
+ * call-seq:
+ *  edje.thaw => nil
+ *
+ * Thaws <i>edje</i>.
+ */
 static VALUE c_thaw (VALUE self)
 {
 	GET_OBJ (self, RbEdje, e);
@@ -90,6 +108,13 @@ static VALUE c_thaw (VALUE self)
 	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);
@@ -104,6 +129,13 @@ static VALUE c_load (VALUE self, VALUE eet, VALUE group)
 	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;
@@ -115,6 +147,13 @@ static VALUE c_get_size_min (VALUE self)
 	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;
@@ -126,6 +165,13 @@ static VALUE c_get_size_max (VALUE self)
 	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;
@@ -139,6 +185,14 @@ static VALUE c_part_exists_get (VALUE self, VALUE 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;
@@ -146,8 +200,10 @@ static VALUE c_part_get (VALUE self, VALUE name)
 	GET_OBJ (self, RbEdje, e);
 	Check_Type (name, T_STRING);
 
-	if (!edje_object_part_exists (e->real.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 (part = rb_hash_aref (e->parts, name))) {
 		part = TO_PART (self, name);
@@ -175,6 +231,15 @@ static void on_text_changed (void *data, Evas_Object *eo,
 	            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);
@@ -190,34 +255,59 @@ static VALUE c_on_text_changed (VALUE 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.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;
@@ -227,12 +317,17 @@ static VALUE c_on_signal (VALUE self, VALUE signal, VALUE src)
 
 	edje_object_signal_callback_add (e->real.real,
 	                                 StringValuePtr (signal),
-	                                 StringValuePtr (src), on_signal,
-	                                 (void *) cb);
+	                                 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);
@@ -240,6 +335,12 @@ static VALUE c_play_get (VALUE self)
 	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);
@@ -251,6 +352,12 @@ static VALUE c_play_set (VALUE self, VALUE val)
 	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);
@@ -258,6 +365,12 @@ static VALUE c_animation_get (VALUE self)
 	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);
@@ -269,6 +382,19 @@ static VALUE c_animation_set (VALUE self, VALUE val)
 	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;
+}
+
 void Init_Edje (void)
 {
 	cEdje = rb_define_class_under (mEdje, "Edje", cEvasObject);
@@ -283,9 +409,10 @@ 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);
 }