gimp/libgimpmath/gimpmatrix.h

/* LIBGIMP - The GIMP Library
 * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
 *
 * gimpmatrix.h
 * Copyright (C) 1998 Jay Cox <jaycox@earthlink.net>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#ifndef __GIMP_MATRIX_H__
#define __GIMP_MATRIX_H__

G_BEGIN_DECLS

/* For information look into the C source or the html documentation */

struct _GimpMatrix2
{
  gdouble coeff[2][2];
};

struct _GimpMatrix3
{
  gdouble coeff[3][3];
};

struct _GimpMatrix4
{
  gdouble coeff[4][4];
};


void          gimp_matrix2_identity        (GimpMatrix2       *matrix);
void          gimp_matrix2_mult            (const GimpMatrix2 *matrix1,
					    GimpMatrix2       *matrix2);

void          gimp_matrix3_identity        (GimpMatrix3       *matrix);
void          gimp_matrix3_mult            (const GimpMatrix3 *matrix1,
					    GimpMatrix3       *matrix2);
void          gimp_matrix3_translate       (GimpMatrix3       *matrix,
					    gdouble            x,
					    gdouble            y);
void          gimp_matrix3_scale           (GimpMatrix3       *matrix,
					    gdouble            x,
					    gdouble            y);
void          gimp_matrix3_rotate          (GimpMatrix3       *matrix,
					    gdouble            theta);
void          gimp_matrix3_xshear          (GimpMatrix3       *matrix,
					    gdouble            amount);
void          gimp_matrix3_yshear          (GimpMatrix3       *matrix,
					    gdouble            amount);
void          gimp_matrix3_affine          (GimpMatrix3       *matrix,
                                            gdouble            a,
                                            gdouble            b,
                                            gdouble            c,
                                            gdouble            d,
                                            gdouble            e,
                                            gdouble            f);

gdouble       gimp_matrix3_determinant     (const GimpMatrix3 *matrix);
void          gimp_matrix3_invert          (GimpMatrix3       *matrix);

gboolean      gimp_matrix3_is_diagonal     (const GimpMatrix3 *matrix);
gboolean      gimp_matrix3_is_identity     (const GimpMatrix3 *matrix);
gboolean      gimp_matrix3_is_simple       (const GimpMatrix3 *matrix);

void          gimp_matrix3_transform_point (const GimpMatrix3 *matrix,
					    gdouble            x,
					    gdouble            y,
					    gdouble           *newx,
					    gdouble           *newy);

void          gimp_matrix4_to_deg          (const GimpMatrix4 *matrix,
					    gdouble           *a,
					    gdouble           *b,
					    gdouble           *c);


G_END_DECLS

#endif /* __GIMP_MATRIX_H__ */