2000-02-18 16:00:19 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
gimpvector
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2000-02-18 19:59:02 +00:00
|
|
|
Utilities to set up and manipulate vectors.
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2000-05-28 00:00:28 +00:00
|
|
|
Utilities to set up and manipulate vectors.
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2000-02-18 19:59:02 +00:00
|
|
|
#GimpMatrix3
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
#GimpMatrix4
|
2000-02-18 16:00:19 +00:00
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_inner_product ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_inner_product_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_cross_product ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_cross_product_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_length ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
@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:
|
|
|
|
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_set ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_new_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-02-18 16:00:19 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_add ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@result:
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_add_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
2001-05-04 20:39:29 +00:00
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_neg ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_neg_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
2001-05-04 20:39:29 +00:00
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector2_rotate ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@alpha:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector2_rotate_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@alpha:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_inner_product ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_inner_product_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_cross_product ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_cross_product_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_length ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
2001-05-04 20:39:29 +00:00
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_length_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_normalize ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_normalize_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
2001-05-04 20:39:29 +00:00
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_mul ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@factor:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_mul_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@factor:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_sub ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@result:
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_sub_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
2001-05-04 20:39:29 +00:00
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_set ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
2001-05-04 20:39:29 +00:00
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@z:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_new ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@z:
|
|
|
|
@Returns:
|
2000-02-18 16:00:19 +00:00
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_add ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
@result:
|
2000-02-18 16:00:19 +00:00
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_add_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector1:
|
|
|
|
@vector2:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_neg ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_neg_val ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector3_rotate ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@alpha:
|
|
|
|
@beta:
|
|
|
|
@gamma:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector3_rotate_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@vector:
|
|
|
|
@alpha:
|
|
|
|
@beta:
|
|
|
|
@gamma:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector_2d_to_3d ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@sx:
|
|
|
|
@sy:
|
|
|
|
@w:
|
|
|
|
@h:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@vp:
|
|
|
|
@p:
|
|
|
|
|
|
|
|
|
2001-05-04 20:39:29 +00:00
|
|
|
<!-- ##### FUNCTION gimp_vector_2d_to_3d_val ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@sx:
|
|
|
|
@sy:
|
|
|
|
@w:
|
|
|
|
@h:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@vp:
|
|
|
|
@p:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_vector_3d_to_2d ##### -->
|
2000-02-18 16:00:19 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@sx:
|
|
|
|
@sy:
|
|
|
|
@w:
|
|
|
|
@h:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@vp:
|
|
|
|
@p:
|
|
|
|
|
|
|
|
|