X-Git-Url: http://git.code-monkey.de/?a=blobdiff_plain;f=src%2Frb_edje.c;h=50ba39b4369a613393ada20ff00e67098f65019e;hb=fdbac22e73a61f2c87c799a6b9753176708bf9a2;hp=57509cfc37044e2e0bff0b69e831017bd64556f3;hpb=3a9c35673bdd0dc885f7474865be23d6d0061789;p=ruby-edje.git
diff --git a/src/rb_edje.c b/src/rb_edje.c
index 57509cf..50ba39b 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 66 2004-08-12 19:37:52Z 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 edje.
+ */
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 edje.
+ */
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 eet into edje. group 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 edje.
+ */
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 edje.
+ */
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 edje has a part called part,
+ * 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 Edje::Part
object that corresponds to
+ * part_name. If there's no part with that name in edje,
+ * 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 edje.
+ * The block is passed the Edje::Part
object
+ * of which the text changed.
+ */
static VALUE c_on_text_changed (VALUE self)
{
GET_OBJ (self, RbEdje, e);
@@ -190,26 +255,43 @@ 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 edje.
+ *
+ * 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));
}
+/*
+ * call-seq:
+ * edje.on_signal(signal, source) { |signal, source| block } => nil
+ *
+ * Registers a callback that will get called when signal
+ * is emitted by source.
+ * The block is passed two strings, signal and source, which identify
+ * the emission.
+ */
static VALUE c_on_signal (VALUE self, VALUE signal, VALUE src)
{
VALUE cb;
@@ -233,6 +315,12 @@ static VALUE c_on_signal (VALUE self, VALUE signal, VALUE src)
return Qnil;
}
+/*
+ * call-seq:
+ * edje.play? => true or false
+ *
+ * Returns true if edje is in play mode, else returns false.
+ */
static VALUE c_play_get (VALUE self)
{
GET_OBJ (self, RbEdje, e);
@@ -240,6 +328,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 edje to play resp. pause mode.
+ */
static VALUE c_play_set (VALUE self, VALUE val)
{
GET_OBJ (self, RbEdje, e);
@@ -251,6 +345,12 @@ static VALUE c_play_set (VALUE self, VALUE val)
return Qnil;
}
+/*
+ * call-seq:
+ * edje.animation? => true or false
+ *
+ * Returns the animation state of edje.
+ */
static VALUE c_animation_get (VALUE self)
{
GET_OBJ (self, RbEdje, e);
@@ -258,6 +358,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 edje.
+ */
static VALUE c_animation_set (VALUE self, VALUE val)
{
GET_OBJ (self, RbEdje, e);