[Swfdec-commits] 4 commits - doc/Makefile.am doc/swfdec-sections.txt swfdec/swfdec_as_context.c swfdec/swfdec_as_context.h swfdec/swfdec_as_frame.h swfdec/swfdec_as_internal.h swfdec/swfdec_gc_object.c

Benjamin Otte company at kemper.freedesktop.org
Thu Sep 4 11:09:22 PDT 2008


 doc/Makefile.am             |    5 +++++
 doc/swfdec-sections.txt     |   34 +++++++++++++++++++---------------
 swfdec/swfdec_as_context.c  |   15 ++++++---------
 swfdec/swfdec_as_context.h  |    2 --
 swfdec/swfdec_as_frame.h    |    1 -
 swfdec/swfdec_as_internal.h |    1 +
 swfdec/swfdec_gc_object.c   |   13 ++++++++++++-
 7 files changed, 43 insertions(+), 28 deletions(-)

New commits:
commit 8c7f3e792f2cc616a0f9012df7f1b129af8920df
Author: Benjamin Otte <otte at gnome.org>
Date:   Thu Sep 4 20:06:21 2008 +0200

    document SwfdecGcObjectClass, too

diff --git a/swfdec/swfdec_gc_object.c b/swfdec/swfdec_gc_object.c
index 82c0f11..db14c01 100644
--- a/swfdec/swfdec_gc_object.c
+++ b/swfdec/swfdec_gc_object.c
@@ -47,7 +47,18 @@
  * SwfdecGcObject:
  *
  * If you want to add custom objects to the garbage collection lifecycle, you
- * need to subclass this object as this object is abstract. 
+ * need to subclass this object as this object is abstract. Note that you have
+ * to provide a valid #SwfdecAsContext whenever you construct objects of this
+ * type.
+ */
+
+/**
+ * SwfdecGcObjectClass:
+ * @mark: Called in the mark phase of garbage collection. Mark all the 
+ *        garbage-collected object you still use here using the marking 
+ *        functions such as swfdec_gc_object_mark() or swfdec_as_string_mark()
+ *
+ * This is the base class for garbage-collected objects.
  */
 
 enum {
commit ae8a7afddc366f726ae7d47e2084705ce4303f83
Author: Benjamin Otte <otte at gnome.org>
Date:   Thu Sep 4 19:55:23 2008 +0200

    more documentation fixes

diff --git a/doc/swfdec-sections.txt b/doc/swfdec-sections.txt
index 59028b0..6ffd617 100644
--- a/doc/swfdec-sections.txt
+++ b/doc/swfdec-sections.txt
@@ -367,6 +367,11 @@ SWFDEC_TYPE_GTK_SOCKET
 </SECTION>
 
 <SECTION>
+<FILE>Internals</FILE>
+<TITLE>Internals of the script engine</TITLE>
+</SECTION>
+
+<SECTION>
 <FILE>SwfdecGcObject</FILE>
 <TITLE>SwfdecGcObject</TITLE>
 SwfdecGcObject
@@ -436,7 +441,6 @@ swfdec_as_context_try_use_mem
 swfdec_as_context_unuse_mem
 swfdec_as_context_gc
 swfdec_as_context_maybe_gc
-swfdec_as_context_run
 swfdec_as_context_throw
 swfdec_as_context_catch
 swfdec_as_context_get_time
diff --git a/swfdec/swfdec_as_context.c b/swfdec/swfdec_as_context.c
index 46d8128..df4766c 100644
--- a/swfdec/swfdec_as_context.c
+++ b/swfdec/swfdec_as_context.c
@@ -46,9 +46,9 @@
 
 /**
  * SECTION:Internals
- * @title: Internals and garbage collection
+ * @title: Internals of the script engine
  * @short_description: understanding internals such as garbage collection
- * @see_also: #SwfdecAsContext
+ * @see_also: #SwfdecAsContext, #SwfdecGcObject
  *
  * This section deals with the internals of the Swfdec Actionscript engine. You
  * should probably read this first when trying to write code with it. If you're
@@ -67,13 +67,10 @@
  * lookups.
  *
  * The script engine starts its life when it is initialized via 
- * swfdec_as_context_startup (). At that point, the basic objects are created.
- * After this function has been called, you can start executing code. All code
- * execution happens by creating a new #SwfdecAsFrame and then calling 
- * swfdec_as_context_run() to execute it. This function is the single entry 
- * point for code execution. Convenience functions exist that make executing 
- * code easy, most notably swfdec_as_object_run() and 
- * swfdec_as_object_call().
+ * swfdec_as_context_startup(). At that point, the basic objects are created.
+ * After this function has been called, you can start executing code. Code
+ * execution happens by calling swfdec_as_function_call_full() or convenience
+ * wrappers like swfdec_as_object_run() or swfdec_as_object_call().
  *
  * It is also easily possible to extend the environment by adding new objects.
  * In fact, without doing so, the environment is pretty bare as it just contains
commit aa5339dab28a25a9f5ed66c7fc3312faba10518a
Author: Benjamin Otte <otte at gnome.org>
Date:   Thu Sep 4 19:55:12 2008 +0200

    make swfdec_as_context_run() private

diff --git a/swfdec/swfdec_as_context.h b/swfdec/swfdec_as_context.h
index 9bf4aef..41b5651 100644
--- a/swfdec/swfdec_as_context.h
+++ b/swfdec/swfdec_as_context.h
@@ -129,8 +129,6 @@ void		swfdec_as_string_mark		(const char *		string);
 void		swfdec_as_context_gc		(SwfdecAsContext *	context);
 void		swfdec_as_context_maybe_gc	(SwfdecAsContext *	context);
 
-void		swfdec_as_context_run		(SwfdecAsContext *	context);
-
 
 G_END_DECLS
 #endif
diff --git a/swfdec/swfdec_as_internal.h b/swfdec/swfdec_as_internal.h
index db0af8f..04d88f3 100644
--- a/swfdec/swfdec_as_internal.h
+++ b/swfdec/swfdec_as_internal.h
@@ -42,6 +42,7 @@ void		swfdec_as_function_init_context		(SwfdecAsContext *	context);
 
 /* swfdec_as_context.c */
 gboolean	swfdec_as_context_check_continue (SwfdecAsContext *	context);
+void		swfdec_as_context_run		(SwfdecAsContext *	context);
 void		swfdec_as_context_run_init_script (SwfdecAsContext *	context,
 						 const guint8 *		data,
 						 gsize			length,
commit e23fc2821cc5b2e48f3973318bf3f3920a6b0229
Author: Benjamin Otte <otte at gnome.org>
Date:   Thu Sep 4 19:46:47 2008 +0200

    make doc build use the right symbols

diff --git a/doc/Makefile.am b/doc/Makefile.am
index d090ab2..cf3c9fa 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -78,6 +78,9 @@ IGNORE_HFILES= \
 	swfdec_audio_load.h \
 	swfdec_audio_stream.h \
 	swfdec_audio_swf_stream.h \
+	swfdec_bitmap_data.h \
+	swfdec_bitmap_movie.h \
+	swfdec_bitmap_pattern.h \
 	swfdec_bits.h \
 	swfdec_bots.h \
 	swfdec_button.h \
@@ -90,6 +93,7 @@ IGNORE_HFILES= \
 	swfdec_codec_gst.h \
 	swfdec_color.h \
 	swfdec_color_as.h \
+	swfdec_color_transform_as.h \
 	swfdec_constant_pool.h \
 	swfdec_debug.h \
 	swfdec_debugger.h \
@@ -153,6 +157,7 @@ IGNORE_HFILES= \
 	swfdec_text_buffer.h \
 	swfdec_text_layout.h \
 	swfdec_text_format.h \
+	swfdec_transform_as.h \
 	swfdec_types.h \
 	swfdec_utils.h \
 	swfdec_video.h \
diff --git a/doc/swfdec-sections.txt b/doc/swfdec-sections.txt
index 5ab3a9a..59028b0 100644
--- a/doc/swfdec-sections.txt
+++ b/doc/swfdec-sections.txt
@@ -262,7 +262,6 @@ SWFDEC_TYPE_TIME_VAL
 SwfdecAsContextState
 SwfdecAsDeleteReturn
 SwfdecLoaderDataType
-SwfdecLoaderRequest
 swfdec_loader_data_type_get_extension
 SwfdecAlignment
 SwfdecKey
@@ -368,11 +367,22 @@ SWFDEC_TYPE_GTK_SOCKET
 </SECTION>
 
 <SECTION>
-<FILE>Internals</FILE>
-<TITLE>Internals</TITLE>
-swfdec_as_object_mark
+<FILE>SwfdecGcObject</FILE>
+<TITLE>SwfdecGcObject</TITLE>
+SwfdecGcObject
+SwfdecGcObjectClass
+swfdec_gc_object_get_context
+swfdec_gc_object_mark
 swfdec_as_string_mark
 swfdec_as_value_mark
+<SUBSECTION Standard>
+swfdec_gc_object_get_type
+SWFDEC_GC_OBJECT
+SWFDEC_GC_OBJECT_CLASS
+SWFDEC_GC_OBJECT_GET_CLASS
+SWFDEC_IS_GC_OBJECT
+SWFDEC_IS_GC_OBJECT_CLASS
+SWFDEC_TYPE_GC_OBJECT
 </SECTION>
 
 <SECTION>
@@ -450,7 +460,6 @@ SwfdecAsObject
 swfdec_as_object_new
 swfdec_as_object_new_empty
 swfdec_as_object_create
-swfdec_as_object_add
 swfdec_as_object_set_constructor
 SwfdecAsVariableFlag
 swfdec_as_object_get_variable
@@ -516,9 +525,9 @@ SwfdecAsFunction
 SwfdecAsNative
 SwfdecAsNativeFunction
 swfdec_as_function_call
+swfdec_as_function_call_full
 swfdec_as_native_function_new
 swfdec_as_native_function_set_construct_type
-swfdec_as_native_function_set_object_type
 swfdec_as_native_function_check
 swfdec_as_native_function_checkv
 SWFDEC_AS_CHECK
@@ -546,7 +555,6 @@ SWFDEC_TYPE_AS_NATIVE_FUNCTION
 <TITLE>SwfdecAsFrame</TITLE>
 SwfdecAsFrame
 swfdec_as_frame_get_next
-swfdec_as_frame_get_function_name
 swfdec_as_frame_get_script
 swfdec_as_frame_get_this
 SwfdecAsStackIterator
@@ -554,16 +562,8 @@ swfdec_as_stack_iterator_init
 swfdec_as_stack_iterator_init_arguments
 swfdec_as_stack_iterator_next
 <SUBSECTION Standard>
-swfdec_as_frame_get_type
 SwfdecAsScope
 SwfdecAsStack
-SwfdecAsFrameClass
-SWFDEC_AS_FRAME
-SWFDEC_AS_FRAME_CLASS
-SWFDEC_AS_FRAME_GET_CLASS
-SWFDEC_IS_AS_FRAME
-SWFDEC_IS_AS_FRAME_CLASS
-SWFDEC_TYPE_AS_FRAME
 </SECTION>
 
 <SECTION>
diff --git a/swfdec/swfdec_as_frame.h b/swfdec/swfdec_as_frame.h
index 29b850e..a24f81a 100644
--- a/swfdec/swfdec_as_frame.h
+++ b/swfdec/swfdec_as_frame.h
@@ -25,7 +25,6 @@
 
 G_BEGIN_DECLS
 
-typedef struct _SwfdecAsFrameClass SwfdecAsFrameClass;
 typedef struct _SwfdecAsStackIterator SwfdecAsStackIterator;
 
 struct _SwfdecAsStackIterator {


More information about the Swfdec-commits mailing list