---

cgul.h

Go to the documentation of this file.

/* LIBGUL - Geometry Utility Library
 * Copyright (C) 1998-1999 Norbert Irmer
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library 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 CGUL_H
#define CGUL_H

#if defined(__MINGW32__) || defined(_MSC_VER)
  #define GULDECL __declspec(dllimport)
  #define GULCALL __cdecl
  #define CCALL   __cdecl 
#else
  #define GULDECL
  #define GULCALL
  #define CCALL
#endif

#ifdef __cplusplus
extern "C" {
#endif

/*------------------------------------------------------------------
   data types
-------------------------------------------------------------------*/

typedef struct
{
  double x,y,z;
}
GULpoint;

typedef struct
{
  double x,y;
}
GULpoint2;

/*---------------------------------------------------------------------
  with this function you can change the functions which are used for
  malloc/free of return arrays (for example necessary when using 'dbg_malloc'
  in the application, since in the dll the normal malloc is used)
----------------------------------------------------------------------*/

GULDECL void GULCALL GUL_set_malloc_func( void *(CCALL *func)(size_t) );
GULDECL void GULCALL GUL_set_free_func( void (CCALL *func)(void *) );

/*-------------------------------------------------------------------*//**
  executes the MBA algorithm and constructs a 3-dimensional surface
  from the results (x,y are linear mappings of u and v ).
  when 'minimize' is set, the base rectangle in the xy-plane is
  chosen so that its area is minimal                                    

  input arrays:

  datPoints  : array of data-points
  StdDevs    : standard deviations of the data points (if useStdDevs = 0,
               all assumed as beeing one)

  output arrays are reserved by the function and have the dimensions:

  retU     : nu + pu + 2
  retV     : nv + pv + 2
  retPw    : nv + 1 
  retPw[i] : nu + 1   (i=0,..,nv)
                                                                        */
/* ---------------------------------------------------------------------*/

GULDECL void GULCALL GUL_SurfaceOverXYPlane(
          int nDatPoints, GULpoint *datPoints,
          int useStdDevs, double *StdDevs,
          int minimize, int nIter,
          int pu, int pv,
          int *ret_nu, double **retU,
          int *ret_nv, double **retV,
          GULpoint ***retPw );

/*-------------------------------------------------------------------*//**
  creates a surface with the MBA algorithm. 'Dat' contains the 3d
  values and 'Dom' the locations in the parametric domain 
  (output arrays are reserved automatically)                            */
/* ---------------------------------------------------------------------*/
GULDECL void GULCALL GUL_MBASurface( 
          int nDatPoints, GULpoint *datPoints, GULpoint2 *domPoints, 
          int nIter, int pu, int pv,
          int *ret_nu, double **retU,
          int *ret_nv, double **retV,
          GULpoint ***retPw );


/*-------------------------------------------------------------------
  Calculates a matrix wich transforms points given in a local coordinate
  system at a point 'B' into the world coordinate system.
  An additional point is required (both in world coordinates
  (=P) and local coordinates (=Pb)). 'Ab' must contain the coordinates
  of the origin in the local coordinate system at 'B'.
  Both coordinate systems must be orthonormal, and memory for 'T' (a 4x4
  matrix) must be reserved by the caller.
-------------------------------------------------------------------*/
GULDECL void GULCALL GUL_CommonCoordinateSystem( 
          GULpoint B, GULpoint P, GULpoint Ab, GULpoint Pb,
          double **T );



#ifdef __cplusplus
}
#endif

#endif

---