Add missing types and sections in the API documentation.

Fix the ClutterBehaviourBspline header file. Fix typos in
ClutterBehaviourRotate API documentation.
This commit is contained in:
Emmanuele Bassi 2007-04-16 10:25:53 +00:00
parent 05eedd6f8f
commit 6f6950f4cc
6 changed files with 77 additions and 52 deletions

View File

@ -43,7 +43,7 @@
* Each time the behaviour reaches a point on the path, the "knot-reached"
* signal is emitted.
*
* Since: 0.3
* Since: 0.4
*/
#include "clutter-fixed.h"
@ -638,7 +638,7 @@ clutter_behaviour_bspline_init (ClutterBehaviourBspline * self)
*
* Return value: a #ClutterBehaviour
*
* Since: 0.3
* Since: 0.4
*/
ClutterBehaviour *
clutter_behaviour_bspline_new (ClutterAlpha *alpha,
@ -724,7 +724,7 @@ clutter_behaviour_bspline_append_spline (ClutterBehaviourBspline * bs,
* a temporary chache, and only when there are enough control points to
* create a new bezier curve will the bspline extended.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_append_knot (ClutterBehaviourBspline * bs,
@ -777,13 +777,14 @@ clutter_behaviour_bspline_append_knots_valist (ClutterBehaviourBspline *bs,
/**
* clutter_behaviour_bspline_append:
* @bs: a #ClutterBehaviourBspline
* @knots: a NULL-terminated array of #ClutterKnot control points.
* @first_knot: first #ClutterKnot
* @VarArgs: a NULL-terminated array of #ClutterKnot control points.
*
* Appends a bezier spline defined by the last control point of bezier spline
* bs and the array of #ClutterKnot control points to the orginal bezier spline
* bs.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_append (ClutterBehaviourBspline * bs,
@ -809,7 +810,7 @@ clutter_behaviour_bspline_append (ClutterBehaviourBspline * bs,
* offset is not one of the on-curve points, the bspline will be
* truncated at the nearest preceeding on-curve point.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_truncate (ClutterBehaviourBspline *bs,
@ -846,7 +847,7 @@ clutter_behaviour_bspline_truncate (ClutterBehaviourBspline *bs,
*
* Empties a bspline.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_clear (ClutterBehaviourBspline * bs)
@ -882,7 +883,7 @@ clutter_behaviour_bspline_clear (ClutterBehaviourBspline * bs)
* Joins a copy of bezier spline bs2 onto the end of bezier spline bs1; bs2 is
* not modified.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_join (ClutterBehaviourBspline * bs1,
@ -928,7 +929,7 @@ clutter_behaviour_bspline_join (ClutterBehaviourBspline * bs1,
* bspline will be split at the nearest on-curve point before the offset.
* The original bspline is shortened appropriately.
*
* Since: 0.3
* Since: 0.4
*/
ClutterBehaviourBspline *
clutter_behaviour_bspline_split (ClutterBehaviourBspline * bs, guint offset)
@ -972,13 +973,13 @@ clutter_behaviour_bspline_split (ClutterBehaviourBspline * bs, guint offset)
/**
* clutter_behaviour_bspline_adjust:
* @bs: a #ClutterBehaviourBspline
* @index: an index of control point to ajdust
* @offset: an index of control point to ajdust
* @knot: a #ClutterKnot with new coordinances for the control point.
*
* Change the coordinaces of control point at index to those represented by
* the knot.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_adjust (ClutterBehaviourBspline * bs,
@ -1052,7 +1053,7 @@ clutter_behaviour_bspline_adjust (ClutterBehaviourBspline * bs,
* the origin of a bspline is given by the position of the first control point
* of the first bezier curve.)
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_set_origin (ClutterBehaviourBspline * bs,
@ -1086,7 +1087,7 @@ clutter_behaviour_bspline_set_origin (ClutterBehaviourBspline * bs,
*
* Gets the origin of the bezier.
*
* Since: 0.3
* Since: 0.4
*/
void
clutter_behaviour_bspline_get_origin (ClutterBehaviourBspline * bs,

View File

@ -60,7 +60,9 @@ typedef struct _ClutterBehaviourBsplineClass ClutterBehaviourBsplineClass;
struct _ClutterBehaviourBspline
{
ClutterBehaviour parent;
ClutterBehaviour parent_instance;
/*< private >*/
ClutterBehaviourBsplinePrivate *priv;
};
@ -80,34 +82,25 @@ struct _ClutterBehaviourBsplineClass
GType clutter_behaviour_bspline_get_type (void) G_GNUC_CONST;
ClutterBehaviour *clutter_behaviour_bspline_new (ClutterAlpha *alpha,
const ClutterKnot * points,
guint n_points);
const ClutterKnot *knots,
guint n_knots);
void clutter_behaviour_bspline_append_knot (ClutterBehaviourBspline *bs,
const ClutterKnot *knot);
void clutter_behaviour_bspline_append (ClutterBehaviourBspline *bs,
const ClutterKnot *first_knot,
...) G_GNUC_NULL_TERMINATED;
void clutter_behaviour_bspline_truncate (ClutterBehaviourBspline *bs,
guint offset);
void clutter_behaviour_bspline_join (ClutterBehaviourBspline *bs1,
ClutterBehaviourBspline *bs2);
ClutterBehaviourBspline * clutter_behaviour_bspline_split (ClutterBehaviourBspline * bs,
ClutterBehaviour *clutter_behaviour_bspline_split (ClutterBehaviourBspline *bs,
guint offset);
void clutter_behaviour_bspline_clear (ClutterBehaviourBspline *bs);
void clutter_behaviour_bspline_adjust (ClutterBehaviourBspline *bs,
guint offset,
ClutterKnot *knot);
void clutter_behaviour_bspline_set_origin (ClutterBehaviourBspline *bs,
ClutterKnot *knot);
void clutter_behaviour_bspline_get_origin (ClutterBehaviourBspline *bs,
ClutterKnot *knot);

View File

@ -308,7 +308,7 @@ clutter_behaviour_rotate_new (ClutterAlpha *alpha,
* @axis: the rotation axis
* @direction: the rotation direction
* @angle_begin: the starting angle, in fixed point notation
* @andle_end: the final angle, in fixed point notation
* @angle_end: the final angle, in fixed point notation
*
* Creates a new #ClutterBehaviourRotate. This is the fixed point version
* of clutter_behaviour_rotate_new().

View File

@ -79,8 +79,10 @@
<title>Clutter Behaviours</title>
<xi:include href="xml/clutter-alpha.xml"/>
<xi:include href="xml/clutter-behaviour.xml"/>
<xi:include href="xml/clutter-behaviour-bspline.xml"/>
<xi:include href="xml/clutter-behaviour-opacity.xml"/>
<xi:include href="xml/clutter-behaviour-path.xml"/>
<xi:include href="xml/clutter-behaviour-rotate.xml"/>
<xi:include href="xml/clutter-behaviour-scale.xml"/>
</chapter>
<chapter>

View File

@ -470,6 +470,32 @@ ClutterBehaviourScalePrivate
clutter_behaviour_scale_get_type
</SECTION>
<SECTION>
<FILE>clutter-behaviour-bspline</FILE>
<TITLE>ClutterBehaviourBspline</TITLE>
ClutterBehaviourBspline
ClutterBehaviourBsplineClass
clutter_behaviour_bspline_new
clutter_behaviour_bspline_append_knot
clutter_behaviour_bspline_append
clutter_behaviour_bspline_truncate
clutter_behaviour_bspline_join
clutter_behaviour_bspline_split
clutter_behaviour_bspline_clear
clutter_behaviour_bspline_adjust
clutter_behaviour_bspline_set_origin
clutter_behaviour_bspline_get_origin
<SUBSECTION Standard>
CLUTTER_BEHAVIOUR_BSPLINE
CLUTTER_BEHAVIOUR_BSPLINE_CLASS
CLUTTER_IS_BEHAVIOUR_BSPLINE
CLUTTER_IS_BEHAVIOUR_BSPLINE_CLASS
CLUTTER_BEHAVIOUR_BSPLINE_GET_CLASS
<SUBSECTION Private>
ClutterBehaviourBsplinePrivate
clutter_behaviour_bspline_get_type
</SECTION>
<SECTION>
<FILE>clutter-backend</FILE>
<TITLE>ClutterBackend</TITLE>

View File

@ -11,6 +11,9 @@ clutter_timeline_get_type
clutter_media_get_type
clutter_behaviour_get_type
clutter_alpha_get_type
clutter_behaviour_bspline_get_type
clutter_behaviour_opacity_get_type
clutter_behaviour_path_get_type
clutter_behaviour_rotate_get_type
clutter_behaviour_scale_get_type
clutter_backend_get_type