utility.h

/*
 *  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 General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *  
 *  Copyright (C) 2000 - 2005 Liam Girdwood  
 */
 
#ifndef _LN_UTILITY_H
#define _LN_UTILITY_H
 
#include <libnova/ln_types.h>
 
#ifdef __WIN32__
#include <time.h>
// cbrt replacement
#define cbrt(x)   pow(x,1.0/3.0)
#endif 
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
const char LIBNOVA_EXPORT *ln_get_version(void);
 
double LIBNOVA_EXPORT ln_get_dec_location(char *s);
 
 
const char LIBNOVA_EXPORT *ln_get_humanr_location(double location);
 
/*
* \fn double ln_get_rect_distance(struct ln_rect_posn *a, struct ln_rect_posn *b)
* \ingroup misc
*/
double LIBNOVA_EXPORT ln_get_rect_distance(struct ln_rect_posn *a,
    struct ln_rect_posn *b);
 
double LIBNOVA_EXPORT ln_rad_to_deg(double radians);
 
double LIBNOVA_EXPORT ln_deg_to_rad(double degrees);
 
double LIBNOVA_EXPORT ln_hms_to_deg(struct ln_hms *hms);
 
void LIBNOVA_EXPORT ln_deg_to_hms(double degrees, struct ln_hms *hms);
 
double LIBNOVA_EXPORT ln_hms_to_rad(struct ln_hms *hms);
 
void LIBNOVA_EXPORT ln_rad_to_hms(double radians, struct ln_hms *hms);
 
double LIBNOVA_EXPORT ln_dms_to_deg(struct ln_dms *dms);
 
void LIBNOVA_EXPORT ln_deg_to_dms(double degrees, struct ln_dms *dms);
 
double LIBNOVA_EXPORT ln_dms_to_rad(struct ln_dms *dms);
 
void LIBNOVA_EXPORT ln_rad_to_dms(double radians, struct ln_dms *dms);
 
void LIBNOVA_EXPORT ln_hequ_to_equ(struct lnh_equ_posn *hpos,
    struct ln_equ_posn *pos);
    
void LIBNOVA_EXPORT ln_equ_to_hequ(struct ln_equ_posn *pos,
    struct lnh_equ_posn *hpos);
    
void LIBNOVA_EXPORT ln_hhrz_to_hrz(struct lnh_hrz_posn *hpos,
    struct ln_hrz_posn *pos);
    
void LIBNOVA_EXPORT ln_hrz_to_hhrz(struct ln_hrz_posn *pos,
    struct lnh_hrz_posn *hpos);
 
const char LIBNOVA_EXPORT * ln_hrz_to_nswe(struct ln_hrz_posn *pos);
    
void LIBNOVA_EXPORT ln_hlnlat_to_lnlat(struct lnh_lnlat_posn *hpos,
    struct ln_lnlat_posn *pos);
    
void LIBNOVA_EXPORT ln_lnlat_to_hlnlat(struct ln_lnlat_posn *pos,
    struct lnh_lnlat_posn *hpos);
 
void LIBNOVA_EXPORT ln_add_secs_hms(struct ln_hms *hms, double seconds);
 
void LIBNOVA_EXPORT ln_add_hms(struct ln_hms *source, struct ln_hms *dest);
 
double LIBNOVA_EXPORT ln_range_degrees(double angle);
 
double LIBNOVA_EXPORT ln_range_radians(double angle);
double LIBNOVA_EXPORT ln_range_radians2(double angle);
 
/*
* \fn double ln_get_light_time(double dist)
* \brief Convert units of AU into light days.
* \ingroup conversion
*/
double LIBNOVA_EXPORT ln_get_light_time(double dist);
 
double LIBNOVA_EXPORT ln_interpolate3(double n, double y1, double y2, double y3);
 
double LIBNOVA_EXPORT ln_interpolate5(double n, double y1, double y2, double y3,
    double y4, double y5);
 
double LIBNOVA_EXPORT ln_find_max(double (*func) (double, double *),
    double from, double to, double *arg);
 
double LIBNOVA_EXPORT ln_find_zero(double (*func) (double, double *),
    double from, double to, double *arg);
 
#ifdef __WIN32__
 
/* Catches calls to the POSIX gmtime_r and converts them to a related WIN32 version. */
struct tm *gmtime_r (time_t *t, struct tm *gmt);
 
#ifndef __MINGW__
/* Catches calls to the POSIX gettimeofday and converts them to a related WIN32 version. */
int gettimeofday(struct timeval *tp, struct timezone *tzp);
#endif // !__MINGW__
 
/* Catches calls to the POSIX strtok_r and converts them to a related WIN32 version. */
char *strtok_r(char *str, const char *sep, char **last);
 
#endif /* __WIN32__ */
 
/* C89 substitutions for C99 functions. */
#ifdef __C89_SUB__
 
/* Simple cube root */
double cbrt(double x);
 
#endif /* __C89_SUB__ */
 
#if defined(__WIN32__) || defined(sun) || defined(__C89_SUB__)
 
/* Not a Number function generator */
double nan(const char *code);
 
#endif /* defined(__WIN32__) || defined(sun) || defined(__C89_SUB__) */
 
#ifdef __cplusplus
};
#endif
 
#endif