callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

added an inline gtk-doc stub to be filled in. Someone please fill this

Browse Source 
2003-11-15 Henrik Brix Andersen <brix@gimp.org>

* libgimpmath/gimpmatrix.c (gimp_matrix4_to_deg): added an inline
gtk-doc stub to be filled in. Someone please fill this in...

* devel-docs/libgimpmath/tmpl/gimpmatrix.sgml
* devel-docs/libgimpmath/tmpl/gimpvector.sgml
* devel-docs/libgimpmath/tmpl/gimpmath.sgml: added descriptions

* devel-docs/libgimpmath/libgimpmath-sections.txt: reordered functions

* libgimpmath/gimpvector.[ch]: reordered functions here as well to
be consistent, touched up the inline gtk-docs
This commit is contained in:
Henrik Brix Andersen
2003-11-15 15:30:34 +00:00
committed by Henrik Brix Andersen
parent 050a543543
commit 9fe95e9c15
8 changed files with 803 additions and 781 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
ChangeLog
View File

@ -1,3 +1,17 @@
2003-11-15 Henrik Brix Andersen <brix@gimp.org>
* libgimpmath/gimpmatrix.c (gimp_matrix4_to_deg): added an inline
gtk-doc stub to be filled in. Someone please fill this in...
* devel-docs/libgimpmath/tmpl/gimpmatrix.sgml
* devel-docs/libgimpmath/tmpl/gimpvector.sgml
* devel-docs/libgimpmath/tmpl/gimpmath.sgml: added descriptions
* devel-docs/libgimpmath/libgimpmath-sections.txt: reordered functions
* libgimpmath/gimpvector.[ch]: reordered functions here as well to
be consistent, touched up the inline gtk-docs
2003-11-15 Sven Neumann <sven@gimp.org> 2003-11-15 Sven Neumann <sven@gimp.org>
* plug-ins/common/gih.c (gih_load_one_brush): add an alpha channel * plug-ins/common/gih.c (gih_load_one_brush): add an alpha channel

54
devel-docs/libgimpmath/libgimpmath-sections.txt
View File

@ -48,43 +48,43 @@ GimpVector2
GimpVector3 GimpVector3
GimpVector4 GimpVector4
gimp_vector2_new gimp_vector2_new
gimp_vector2_set
gimp_vector2_length
gimp_vector2_length_val
gimp_vector2_mul
gimp_vector2_mul_val
gimp_vector2_normalize
gimp_vector2_normalize_val
gimp_vector2_neg
gimp_vector2_neg_val
gimp_vector2_add
gimp_vector2_add_val
gimp_vector2_sub
gimp_vector2_sub_val
gimp_vector2_inner_product gimp_vector2_inner_product
gimp_vector2_inner_product_val gimp_vector2_inner_product_val
gimp_vector2_cross_product gimp_vector2_cross_product
gimp_vector2_cross_product_val gimp_vector2_cross_product_val
gimp_vector2_length
gimp_vector2_length_val
gimp_vector2_normalize
gimp_vector2_normalize_val
gimp_vector2_mul
gimp_vector2_mul_val
gimp_vector2_sub
gimp_vector2_sub_val
gimp_vector2_set
gimp_vector2_add
gimp_vector2_add_val
gimp_vector2_neg
gimp_vector2_neg_val
gimp_vector2_rotate gimp_vector2_rotate
gimp_vector2_rotate_val gimp_vector2_rotate_val
gimp_vector3_new
gimp_vector3_set
gimp_vector3_length
gimp_vector3_length_val
gimp_vector3_mul
gimp_vector3_mul_val
gimp_vector3_normalize
gimp_vector3_normalize_val
gimp_vector3_neg
gimp_vector3_neg_val
gimp_vector3_add
gimp_vector3_add_val
gimp_vector3_sub
gimp_vector3_sub_val
gimp_vector3_inner_product gimp_vector3_inner_product
gimp_vector3_inner_product_val gimp_vector3_inner_product_val
gimp_vector3_cross_product gimp_vector3_cross_product
gimp_vector3_cross_product_val gimp_vector3_cross_product_val
gimp_vector3_length
gimp_vector3_length_val
gimp_vector3_normalize
gimp_vector3_normalize_val
gimp_vector3_mul
gimp_vector3_mul_val
gimp_vector3_sub
gimp_vector3_sub_val
gimp_vector3_set
gimp_vector3_new
gimp_vector3_add
gimp_vector3_add_val
gimp_vector3_neg
gimp_vector3_neg_val
gimp_vector3_rotate gimp_vector3_rotate
gimp_vector3_rotate_val gimp_vector3_rotate_val
gimp_vector_2d_to_3d gimp_vector_2d_to_3d

33
devel-docs/libgimpmath/tmpl/gimpmath.sgml
View File

@ -6,7 +6,8 @@ Mathematical definitions and macros.
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<para> <para>
Mathematical definitions and macros. Mathematical definitions and macros. These macros should be used
rather than the ones from math.h for enhanced portability.
</para> </para>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->
@ -16,57 +17,59 @@ Mathematical definitions and macros.
<!-- ##### MACRO RINT ##### --> <!-- ##### MACRO RINT ##### -->
<para> <para>
This macro rounds its argument @x to an integer value in floating point
format.
</para> </para>
@x: @x: the value to be rounded.
<!-- ##### MACRO ROUND ##### --> <!-- ##### MACRO ROUND ##### -->
<para> <para>
This macro rounds its argument @x to the nearest integer.
</para> </para>
@x: @x: the value to be rounded.
<!-- ##### MACRO SQR ##### --> <!-- ##### MACRO SQR ##### -->
<para> <para>
This macro squares its argument @x.
</para> </para>
@x: @x: the value to be squared.
<!-- ##### MACRO MAX255 ##### --> <!-- ##### MACRO MAX255 ##### -->
<para> <para>
This macro limits it argument @a, an (0-511) int, to 255.
</para> </para>
@a: @a: the value to be limited.
<!-- ##### MACRO CLAMP0255 ##### --> <!-- ##### MACRO CLAMP0255 ##### -->
<para> <para>
This macro clamps its argument @a, an int32-range int, between 0 and
255 inclusive.
</para> </para>
@a: @a: the value to be clamped.
<!-- ##### MACRO gimp_deg_to_rad ##### --> <!-- ##### MACRO gimp_deg_to_rad ##### -->
<para> <para>
This macro converts its argument @angle from degree to radian.
</para> </para>
@angle: @angle: the angle to be converted.
<!-- ##### MACRO gimp_rad_to_deg ##### --> <!-- ##### MACRO gimp_rad_to_deg ##### -->
<para> <para>
This macro converts its argument @angle from radian to degree.
</para> </para>
@angle: @angle: the angle to be converted.

6
devel-docs/libgimpmath/tmpl/gimpmatrix.sgml
View File

@ -26,21 +26,21 @@ basic matrix manipulations and tests.
<!-- ##### STRUCT GimpMatrix2 ##### --> <!-- ##### STRUCT GimpMatrix2 ##### -->
<para> <para>
A two by two matrix.
</para> </para>
@coeff: @coeff:
<!-- ##### STRUCT GimpMatrix3 ##### --> <!-- ##### STRUCT GimpMatrix3 ##### -->
<para> <para>
A three by three matrix.
</para> </para>
@coeff: @coeff:
<!-- ##### STRUCT GimpMatrix4 ##### --> <!-- ##### STRUCT GimpMatrix4 ##### -->
<para> <para>
A four by four matrix.
</para> </para>
@coeff: @coeff:

514
devel-docs/libgimpmath/tmpl/gimpvector.sgml
View File

@ -20,7 +20,7 @@ Utilities to set up and manipulate vectors.
<!-- ##### STRUCT GimpVector2 ##### --> <!-- ##### STRUCT GimpVector2 ##### -->
<para> <para>
A two dimensional vector.
</para> </para>
@x: @x:
@ -28,7 +28,7 @@ Utilities to set up and manipulate vectors.
<!-- ##### STRUCT GimpVector3 ##### --> <!-- ##### STRUCT GimpVector3 ##### -->
<para> <para>
A three dimensional vector.
</para> </para>
@x: @x:
@ -37,7 +37,7 @@ Utilities to set up and manipulate vectors.
<!-- ##### STRUCT GimpVector4 ##### --> <!-- ##### STRUCT GimpVector4 ##### -->
<para> <para>
A four dimensional vector.
</para> </para>
@x: @x:
@ -55,6 +55,127 @@ Utilities to set up and manipulate vectors.
@Returns: @Returns:
<!-- ##### FUNCTION gimp_vector2_set ##### -->
<para>
</para>
@vector:
@x:
@y:
<!-- ##### FUNCTION gimp_vector2_length ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_length_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_mul ##### -->
<para>
</para>
@vector:
@factor:
<!-- ##### FUNCTION gimp_vector2_mul_val ##### -->
<para>
</para>
@vector:
@factor:
@Returns:
<!-- ##### FUNCTION gimp_vector2_normalize ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector2_normalize_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_neg ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector2_neg_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_add ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector2_add_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector2_sub ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector2_sub_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector2_inner_product ##### --> <!-- ##### FUNCTION gimp_vector2_inner_product ##### -->
<para> <para>
@ -95,127 +216,6 @@ Utilities to set up and manipulate vectors.
@Returns: @Returns:
<!-- ##### FUNCTION gimp_vector2_length ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_length_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_normalize ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector2_normalize_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_mul ##### -->
<para>
</para>
@vector:
@factor:
<!-- ##### FUNCTION gimp_vector2_mul_val ##### -->
<para>
</para>
@vector:
@factor:
@Returns:
<!-- ##### FUNCTION gimp_vector2_sub ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector2_sub_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector2_set ##### -->
<para>
</para>
@vector:
@x:
@y:
<!-- ##### FUNCTION gimp_vector2_add ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector2_add_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector2_neg ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector2_neg_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector2_rotate ##### --> <!-- ##### FUNCTION gimp_vector2_rotate ##### -->
<para> <para>
@ -235,6 +235,139 @@ Utilities to set up and manipulate vectors.
@Returns: @Returns:
<!-- ##### FUNCTION gimp_vector3_new ##### -->
<para>
</para>
@x:
@y:
@z:
@Returns:
<!-- ##### FUNCTION gimp_vector3_set ##### -->
<para>
</para>
@vector:
@x:
@y:
@z:
<!-- ##### FUNCTION gimp_vector3_length ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_length_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_mul ##### -->
<para>
</para>
@vector:
@factor:
<!-- ##### FUNCTION gimp_vector3_mul_val ##### -->
<para>
</para>
@vector:
@factor:
@Returns:
<!-- ##### FUNCTION gimp_vector3_normalize ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector3_normalize_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_neg ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector3_neg_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_add ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector3_add_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector3_sub ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector3_sub_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector3_inner_product ##### --> <!-- ##### FUNCTION gimp_vector3_inner_product ##### -->
<para> <para>
@ -275,139 +408,6 @@ Utilities to set up and manipulate vectors.
@Returns: @Returns:
<!-- ##### FUNCTION gimp_vector3_length ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_length_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_normalize ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector3_normalize_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_mul ##### -->
<para>
</para>
@vector:
@factor:
<!-- ##### FUNCTION gimp_vector3_mul_val ##### -->
<para>
</para>
@vector:
@factor:
@Returns:
<!-- ##### FUNCTION gimp_vector3_sub ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector3_sub_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector3_set ##### -->
<para>
</para>
@vector:
@x:
@y:
@z:
<!-- ##### FUNCTION gimp_vector3_new ##### -->
<para>
</para>
@x:
@y:
@z:
@Returns:
<!-- ##### FUNCTION gimp_vector3_add ##### -->
<para>
</para>
@result:
@vector1:
@vector2:
<!-- ##### FUNCTION gimp_vector3_add_val ##### -->
<para>
</para>
@vector1:
@vector2:
@Returns:
<!-- ##### FUNCTION gimp_vector3_neg ##### -->
<para>
</para>
@vector:
<!-- ##### FUNCTION gimp_vector3_neg_val ##### -->
<para>
</para>
@vector:
@Returns:
<!-- ##### FUNCTION gimp_vector3_rotate ##### --> <!-- ##### FUNCTION gimp_vector3_rotate ##### -->
<para> <para>

9
libgimpmath/gimpmatrix.c
View File

@ -484,6 +484,15 @@ gimp_matrix3_is_simple (const GimpMatrix3 *matrix)
return TRUE; return TRUE;
} }
/**
* gimp_matrix4_to_deg:
* @matrix:
* @a:
* @b:
* @c:
*
*
**/
void void
gimp_matrix4_to_deg (const GimpMatrix4 *matrix, gimp_matrix4_to_deg (const GimpMatrix4 *matrix,
gdouble *a, gdouble *a,

850
libgimpmath/gimpvector.c
View File

File diff suppressed because it is too large Load Diff

104
libgimpmath/gimpvector.h
View File

@ -49,6 +49,31 @@ struct _GimpVector4
/* Two dimensional vector functions */ /* Two dimensional vector functions */
/* ================================ */ /* ================================ */
GimpVector2 gimp_vector2_new (gdouble x,
gdouble y);
void gimp_vector2_set (GimpVector2 *vector,
gdouble x,
gdouble y);
gdouble gimp_vector2_length (const GimpVector2 *vector);
gdouble gimp_vector2_length_val (GimpVector2 vector);
void gimp_vector2_mul (GimpVector2 *vector,
gdouble factor);
GimpVector2 gimp_vector2_mul_val (GimpVector2 vector,
gdouble factor);
void gimp_vector2_normalize (GimpVector2 *vector);
GimpVector2 gimp_vector2_normalize_val (GimpVector2 vector);
void gimp_vector2_neg (GimpVector2 *vector);
GimpVector2 gimp_vector2_neg_val (GimpVector2 vector);
void gimp_vector2_add (GimpVector2 *result,
const GimpVector2 *vector1,
const GimpVector2 *vector2);
GimpVector2 gimp_vector2_add_val (GimpVector2 vector1,
GimpVector2 vector2);
void gimp_vector2_sub (GimpVector2 *result,
const GimpVector2 *vector1,
const GimpVector2 *vector2);
GimpVector2 gimp_vector2_sub_val (GimpVector2 vector1,
GimpVector2 vector2);
gdouble gimp_vector2_inner_product (const GimpVector2 *vector1, gdouble gimp_vector2_inner_product (const GimpVector2 *vector1,
const GimpVector2 *vector2); const GimpVector2 *vector2);
gdouble gimp_vector2_inner_product_val (GimpVector2 vector1, gdouble gimp_vector2_inner_product_val (GimpVector2 vector1,
@ -57,31 +82,6 @@ GimpVector2 gimp_vector2_cross_product (const GimpVector2 *vector1,
const GimpVector2 *vector2); const GimpVector2 *vector2);
GimpVector2 gimp_vector2_cross_product_val (GimpVector2 vector1, GimpVector2 gimp_vector2_cross_product_val (GimpVector2 vector1,
GimpVector2 vector2); GimpVector2 vector2);
gdouble gimp_vector2_length (const GimpVector2 *vector);
gdouble gimp_vector2_length_val (GimpVector2 vector);
void gimp_vector2_normalize (GimpVector2 *vector);
GimpVector2 gimp_vector2_normalize_val (GimpVector2 vector);
void gimp_vector2_mul (GimpVector2 *vector,
gdouble factor);
GimpVector2 gimp_vector2_mul_val (GimpVector2 vector,
gdouble factor);
void gimp_vector2_sub (GimpVector2 *result,
const GimpVector2 *vector1,
const GimpVector2 *vector2);
GimpVector2 gimp_vector2_sub_val (GimpVector2 vector1,
GimpVector2 vector2);
void gimp_vector2_set (GimpVector2 *vector,
gdouble x,
gdouble y);
GimpVector2 gimp_vector2_new (gdouble x,
gdouble y);
void gimp_vector2_add (GimpVector2 *result,
const GimpVector2 *vector1,
const GimpVector2 *vector2);
GimpVector2 gimp_vector2_add_val (GimpVector2 vector1,
GimpVector2 vector2);
void gimp_vector2_neg (GimpVector2 *vector);
GimpVector2 gimp_vector2_neg_val (GimpVector2 vector);
void gimp_vector2_rotate (GimpVector2 *vector, void gimp_vector2_rotate (GimpVector2 *vector,
gdouble alpha); gdouble alpha);
GimpVector2 gimp_vector2_rotate_val (GimpVector2 vector, GimpVector2 gimp_vector2_rotate_val (GimpVector2 vector,
@ -90,6 +90,33 @@ GimpVector2 gimp_vector2_rotate_val (GimpVector2 vector,
/* Three dimensional vector functions */ /* Three dimensional vector functions */
/* ================================== */ /* ================================== */
GimpVector3 gimp_vector3_new (gdouble x,
gdouble y,
gdouble z);
void gimp_vector3_set (GimpVector3 *vector,
gdouble x,
gdouble y,
gdouble z);
gdouble gimp_vector3_length (const GimpVector3 *vector);
gdouble gimp_vector3_length_val (GimpVector3 vector);
void gimp_vector3_mul (GimpVector3 *vector,
gdouble factor);
GimpVector3 gimp_vector3_mul_val (GimpVector3 vector,
gdouble factor);
void gimp_vector3_normalize (GimpVector3 *vector);
GimpVector3 gimp_vector3_normalize_val (GimpVector3 vector);
void gimp_vector3_neg (GimpVector3 *vector);
GimpVector3 gimp_vector3_neg_val (GimpVector3 vector);
void gimp_vector3_add (GimpVector3 *result,
const GimpVector3 *vector1,
const GimpVector3 *vector2);
GimpVector3 gimp_vector3_add_val (GimpVector3 vector1,
GimpVector3 vector2);
void gimp_vector3_sub (GimpVector3 *result,
const GimpVector3 *vector1,
const GimpVector3 *vector2);
GimpVector3 gimp_vector3_sub_val (GimpVector3 vector1,
GimpVector3 vector2);
gdouble gimp_vector3_inner_product (const GimpVector3 *vector1, gdouble gimp_vector3_inner_product (const GimpVector3 *vector1,
const GimpVector3 *vector2); const GimpVector3 *vector2);
gdouble gimp_vector3_inner_product_val (GimpVector3 vector1, gdouble gimp_vector3_inner_product_val (GimpVector3 vector1,
@ -98,33 +125,6 @@ GimpVector3 gimp_vector3_cross_product (const GimpVector3 *vector1,
const GimpVector3 *vector2); const GimpVector3 *vector2);
GimpVector3 gimp_vector3_cross_product_val (GimpVector3 vector1, GimpVector3 gimp_vector3_cross_product_val (GimpVector3 vector1,
GimpVector3 vector2); GimpVector3 vector2);
gdouble gimp_vector3_length (const GimpVector3 *vector);
gdouble gimp_vector3_length_val (GimpVector3 vector);
void gimp_vector3_normalize (GimpVector3 *vector);
GimpVector3 gimp_vector3_normalize_val (GimpVector3 vector);
void gimp_vector3_mul (GimpVector3 *vector,
gdouble factor);
GimpVector3 gimp_vector3_mul_val (GimpVector3 vector,
gdouble factor);
void gimp_vector3_sub (GimpVector3 *result,
const GimpVector3 *vector1,
const GimpVector3 *vector2);
GimpVector3 gimp_vector3_sub_val (GimpVector3 vector1,
GimpVector3 vector2);
void gimp_vector3_set (GimpVector3 *vector,
gdouble x,
gdouble y,
gdouble z);
GimpVector3 gimp_vector3_new (gdouble x,
gdouble y,
gdouble z);
void gimp_vector3_add (GimpVector3 *result,
const GimpVector3 *vector1,
const GimpVector3 *vector2);
GimpVector3 gimp_vector3_add_val (GimpVector3 vector1,
GimpVector3 vector2);
void gimp_vector3_neg (GimpVector3 *vector);
GimpVector3 gimp_vector3_neg_val (GimpVector3 vector);
void gimp_vector3_rotate (GimpVector3 *vector, void gimp_vector3_rotate (GimpVector3 *vector,
gdouble alpha, gdouble alpha,
gdouble beta, gdouble beta,