gimp/libgimpmath/gimpmath.h

153 lines
3.6 KiB
C
Raw Normal View History

/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* gimpmath.h
1999-09-02 04:31:56 +08:00
*
* This library is free software: you can redistribute it and/or
1999-11-18 05:13:50 +08:00
* modify it under the terms of the GNU Lesser General Public
1999-09-02 04:31:56 +08:00
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
1999-09-02 04:31:56 +08:00
*
* 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.
1999-09-02 04:31:56 +08:00
*
1999-11-18 05:13:50 +08:00
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
* <https://www.gnu.org/licenses/>.
1999-09-02 04:31:56 +08:00
*/
#ifndef __GIMP_MATH_H__
#define __GIMP_MATH_H__
1999-09-02 04:31:56 +08:00
1999-09-02 04:31:56 +08:00
#include <math.h>
#ifdef HAVE_IEEEFP_H
#include <ieeefp.h>
#endif
1999-09-02 04:31:56 +08:00
#ifdef G_OS_WIN32
#include <float.h>
#endif
#define __GIMP_MATH_H_INSIDE__
#include <libgimpmath/gimpmathtypes.h>
#include <libgimpmath/gimpmatrix.h>
#include <libgimpmath/gimpvector.h>
#undef __GIMP_MATH_H_INSIDE__
bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. 2001-11-23 Sven Neumann <sven@gimp.org> * configure.in: bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. Removed GDK_DISABLE_COMPAT_H and GTK_DISABLE_COMPAT_H from our default CFLAGS since they don't exist any longer. * RELEASE-TO-CVS.patch: removed since the glib/gtk+ API is supposed to be frozen now. * HACKING: removed reference to RELEASE-TO-CVS.patch * app/gui/menus.c * app/tools/gimptexttool.c: applied RELEASE-TO-CVS.patch to conform to the new GTK+/Pango API. * app/core/Makefile.am: generate marshallers with gimp_marshal prefix. * app/core/gimpmarshal.list: added all marshallers we use. * app/core/gimpmarshal.[ch]: regenerated. * app/[lots of .c files]: use gimp_marshal_* for all marshallers. * data/images/ * app/app_procs.c * app/gui/splash.c: * libgimpbase/Makefile.am * libgimpbase/gimpbase.h * libgimpbase/gimputils.[ch]: removed since they are no longer needed. * app/gimprc.c * plug-ins/common/ps.c * plug-ins/gdyntext/gdyntext.c * plug-ins/gdyntext/gdyntextcompat.c * plug-ins/gfig/gfig.c * plug-ins/gflare/gflare.c * plug-ins/script-fu/script-fu-scripts.c: use glib functions instead of gimp_strescape() and gimpstrcompress(). * cleaned up all header files: use G_BEGIN_DECLS/G_END_DECLS, declared all _get_type function as G_GNUC_CONST. * tools/pdbgen/enumcode.pl * tools/pdbgen/lib.pl: make them generate header files using G_BEGIN_DECLS/G_END_DECLS. * pixmaps/Makefile.am * pixmaps/wilber3.xpm: removed ... * data/images/tips_wilber.png: ... and added here as PNG * app/gui/tips-dialog.c: load the Wilber on demand using GdkPixbuf. * data/images/gimp_splash.ppm: removed ... * data/images/gimp_splash.png: ... and added as PNG * app/app_procs.c * app/gui/splash.[ch]: load the splash image using GdkPixbuf. * app/gui/about-dialog.c: sink the GtkPreview.
2001-11-23 07:46:13 +08:00
G_BEGIN_DECLS
/**
* SECTION: gimpmath
* @title: GimpMath
* @short_description: Mathematical definitions and macros.
1999-09-02 04:31:56 +08:00
*
* Mathematical definitions and macros for use both by the GIMP
* application and plug-ins. These macros should be used rather than
2010-07-02 20:48:24 +08:00
* the ones from &lt;math.h&gt; for enhanced portability.
**/
1999-09-02 04:31:56 +08:00
/**
* RINT:
* @x: the value to be rounded
*
* This macro rounds its argument @x to an integer value in floating
* point format. Use RINT() instead of rint().
**/
#if defined (HAVE_RINT) && 0
/* note: rint() depends on the current floating-point rounding mode. when the
* rounding mode is FE_TONEAREST, it, in parctice, breaks ties to even. this
* is different from 'floor (x + 0.5)', which breaks ties up. in other words
* 'rint (2.5) == 2.0', while 'floor (2.5 + 0.5) == 3.0'. this is asking for
* trouble, so let's just use the latter.
*/
1999-09-02 04:31:56 +08:00
#define RINT(x) rint(x)
#else
#define RINT(x) floor ((x) + 0.5)
#endif
/**
* ROUND:
* @x: the value to be rounded.
*
* This macro rounds its positive argument @x to the nearest integer.
**/
1999-09-02 04:31:56 +08:00
#define ROUND(x) ((int) ((x) + 0.5))
/**
* SIGNED_ROUND:
* @x: the value to be rounded.
*
* This macro rounds its argument @x to the nearest integer.
**/
#define SIGNED_ROUND(x) ((int) RINT (x))
/**
* SQR:
* @x: the value to be squared.
*
* This macro squares its argument @x.
**/
1999-09-02 04:31:56 +08:00
#define SQR(x) ((x) * (x))
/**
* MAX255:
* @a: the value to be limited.
*
* This macro limits it argument @a, an (0-511) int, to 255.
**/
1999-09-02 04:31:56 +08:00
#define MAX255(a) ((a) | (((a) & 256) - (((a) & 256) >> 8)))
/**
* CLAMP0255:
* @a: the value to be clamped.
*
* This macro clamps its argument @a, an int32-range int, between 0
* and 255 inclusive.
**/
1999-09-02 04:31:56 +08:00
#define CLAMP0255(a) CLAMP(a,0,255)
/**
* SAFE_CLAMP:
* @x: the value to be limited.
* @low: the lower limit.
* @high: the upper limit.
*
* Ensures that @x is between the limits set by @low and @high,
* even if @x is NaN. If @low is greater than @high, or if either
* of them is NaN, the result is undefined.
*
* Since: 2.10
**/
#define SAFE_CLAMP(x, low, high) ((x) > (low) ? (x) < (high) ? (x) : (high) : (low))
/**
* gimp_deg_to_rad:
* @angle: the angle to be converted.
*
* This macro converts its argument @angle from degree to radian.
**/
#define gimp_deg_to_rad(angle) ((angle) * (2.0 * G_PI) / 360.0)
/**
* gimp_rad_to_deg:
* @angle: the angle to be converted.
*
* This macro converts its argument @angle from radian to degree.
**/
#define gimp_rad_to_deg(angle) ((angle) * 360.0 / (2.0 * G_PI))
bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. 2001-11-23 Sven Neumann <sven@gimp.org> * configure.in: bumped version number to 1.3.1. Require Glib/GTK+-1.3.11 and Pango-0.22. Removed GDK_DISABLE_COMPAT_H and GTK_DISABLE_COMPAT_H from our default CFLAGS since they don't exist any longer. * RELEASE-TO-CVS.patch: removed since the glib/gtk+ API is supposed to be frozen now. * HACKING: removed reference to RELEASE-TO-CVS.patch * app/gui/menus.c * app/tools/gimptexttool.c: applied RELEASE-TO-CVS.patch to conform to the new GTK+/Pango API. * app/core/Makefile.am: generate marshallers with gimp_marshal prefix. * app/core/gimpmarshal.list: added all marshallers we use. * app/core/gimpmarshal.[ch]: regenerated. * app/[lots of .c files]: use gimp_marshal_* for all marshallers. * data/images/ * app/app_procs.c * app/gui/splash.c: * libgimpbase/Makefile.am * libgimpbase/gimpbase.h * libgimpbase/gimputils.[ch]: removed since they are no longer needed. * app/gimprc.c * plug-ins/common/ps.c * plug-ins/gdyntext/gdyntext.c * plug-ins/gdyntext/gdyntextcompat.c * plug-ins/gfig/gfig.c * plug-ins/gflare/gflare.c * plug-ins/script-fu/script-fu-scripts.c: use glib functions instead of gimp_strescape() and gimpstrcompress(). * cleaned up all header files: use G_BEGIN_DECLS/G_END_DECLS, declared all _get_type function as G_GNUC_CONST. * tools/pdbgen/enumcode.pl * tools/pdbgen/lib.pl: make them generate header files using G_BEGIN_DECLS/G_END_DECLS. * pixmaps/Makefile.am * pixmaps/wilber3.xpm: removed ... * data/images/tips_wilber.png: ... and added here as PNG * app/gui/tips-dialog.c: load the Wilber on demand using GdkPixbuf. * data/images/gimp_splash.ppm: removed ... * data/images/gimp_splash.png: ... and added as PNG * app/app_procs.c * app/gui/splash.[ch]: load the splash image using GdkPixbuf. * app/gui/about-dialog.c: sink the GtkPreview.
2001-11-23 07:46:13 +08:00
G_END_DECLS
1999-09-02 04:31:56 +08:00
#endif /* __GIMP_MATH_H__ */