/usr/include/itl/prayer.h is in libitl-dev 0.7.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 | /************************************************************************
* $Id: prayer.h 2186 2009-03-09 14:19:57Z thamer $
*
* ------------
* Description:
* ------------
* Copyright (c) 2003-2006, 2009, Arabeyes, Thamer Mahmoud
*
* A full featured Muslim Prayer Times calculator
*
*
* -----------------
* Revision Details: (Updated by Revision Control System)
* -----------------
* $Date: 2009-03-09 17:19:57 +0300 (Mon, 09 Mar 2009) $
* $Author: thamer $
* $Revision: 2186 $
* $Source$
*
* (www.arabeyes.org - under LGPL license - see COPYING file)
************************************************************************/
#ifndef _PRAYER_ENGINE_
#define _PRAYER_ENGINE_
#include <math.h>
#ifdef __cplusplus
extern "C" {
#endif
/* This holds the current date info. */
typedef struct
{
int day;
int month;
int year;
} Date ;
/* This holds the location info. */
typedef struct
{
double degreeLong; /* Longitude in decimal degree. */
double degreeLat; /* Latitude in decimal degree. */
double gmtDiff; /* GMT difference at regular time. */
int dst; /* Daylight savings time switch (0 if not used).
Setting this to 1 should add 1 hour to all the
calculated prayer times */
double seaLevel; /* Height above Sea level in meters */
double pressure; /* Atmospheric pressure in millibars (the
astronomical standard value is 1010) */
double temperature; /* Temperature in Celsius degree (the astronomical
standard value is 10) */
} Location ;
/* This structure holds the calculation method used. NOTE: Before explicitly
setting any of these values, it is more safe to default initialize them
by calling 'getMethod(0, &method)' */
typedef struct
{
double fajrAng; /* Fajr angle */
double ishaaAng; /* Ishaa angle */
double imsaakAng; /* The angle difference between Imsaak and Fajr (
default is 1.5)*/
int fajrInv; /* Fajr Interval is the amount of minutes between
Fajr and Shurooq (0 if not used) */
int ishaaInv; /* Ishaa Interval is the amount if minutes between
Ishaa and Maghrib (0 if not used) */
int imsaakInv; /* Imsaak Interval is the amount of minutes between
Imsaak and Fajr. The default is 10 minutes before
Fajr if Fajr Interval is set */
int round; /* Method used for rounding seconds:
0: No Rounding. "Prayer.seconds" is set to the
amount of computed seconds.
1: Normal Rounding. If seconds are equal to
30 or above, add 1 minute. Sets
"Prayer.seconds" to zero.
2: Special Rounding. Similar to normal rounding
but we always round down for Shurooq and
Imsaak times. (default)
3: Aggressive Rounding. Similar to Special
Rounding but we add 1 minute if the seconds
value is equal to 1 second or more. */
int mathhab; /* Assr prayer shadow ratio:
1: Shaf'i (default)
2: Hanafi */
double nearestLat; /* Latitude Used for the 'Nearest Latitude' extreme
methods. The default is 48.5 */
int extreme; /* Extreme latitude calculation method (see
below) */
int offset; /* Enable Offsets switch (set this to 1 to
activate). This option allows you to add or
subtract any amount of minutes to the daily
computed prayer times based on values (in
minutes) for each prayer in the offList array */
double offList[6]; /* For Example: If you want to add 30 seconds to
Maghrib and subtract 2 minutes from Ishaa:
offset = 1
offList[4] = 0.5
offList[5] = -2
..and than call getPrayerTimes as usual. */
} Method ;
/*
Supported methods for Extreme Latitude calculations (Method.extreme) -
(see the file "./doc/method-info.txt" for details) :
0: none. if unable to calculate, leave as 99:99
1: Nearest Latitude: All prayers Always
2: Nearest Latitude: Fajr Ishaa Always
3: Nearest Latitude: Fajr Ishaa if invalid
4: Nearest Good Day: All prayers Always
5: Nearest Good Day: Fajr Ishaa if invalid (default)
6: 1/7th of Night: Fajr Ishaa Always
7: 1/7th of Night: Fajr Ishaa if invalid
8: 1/7th of Day: Fajr Ishaa Always
9: 1/7th of Day: Fajr Ishaa if invalid
10: Half of the Night: Fajr Ishaa Always
11: Half of the Night: Fajr Ishaa if invalid
12: Minutes from Shorooq/Maghrib: Fajr Ishaa Always (e.g. Maghrib=Ishaa)
13: Minutes from Shorooq/Maghrib: Fajr Ishaa If invalid
*/
/* This function is used to auto fill the Method structure with predefined
data. The supported auto-fill methods for calculations at normal
circumstances are:
0: none. Set to default or 0
1: Egyptian General Authority of Survey
2: University of Islamic Sciences, Karachi (Shaf'i)
3: University of Islamic Sciences, Karachi (Hanafi)
4: Islamic Society of North America
5: Muslim World League (MWL)
6: Umm Al-Qurra, Saudi Arabia
7: Fixed Ishaa Interval (always 90)
8: Egyptian General Authority of Survey (Egypt)
(see the file "./doc/method-info.txt" for more details)
*/
void getMethod(int n, Method* conf);
/* This structure holds the prayer time output for a single prayer. */
typedef struct
{
int hour; /* prayer time hour */
int minute; /* prayer time minute */
int second; /* prayer time second */
int isExtreme; /* Extreme calculation status. The 'getPrayerTimes'
function sets this variable to 1 to indicate that
this particular prayer time has been calculated
through extreme latitude methods and NOT by
conventional means of calculation. */
} Prayer ;
/* The "getPrayerTimes" function fills an array of six Prayer structures
"Prayer[6]". This list contains the prayer minutes and hours information
like this:
- Prayer[0].minute is today's Fajr minutes
- Prayer[1].hour is today's Shorooq hours
- ... and so on until...
- Prayer[5].minute is today's Ishaa minutes
*/
void getPrayerTimes (const Location*, const Method*, const Date*, Prayer*);
/* Extended prayer times */
void getImsaak (const Location*, const Method*, const Date*, Prayer*);
void getNextDayImsaak (const Location*, const Method*, const Date*, Prayer*);
void getNextDayFajr (const Location*, const Method*, const Date*, Prayer*);
/* utilities */
int getDayofYear (int year, int month, int day);
double dms2Decimal (int deg, int min, double sec, char dir);
void decimal2Dms (double decimal, int *deg, int *min, double *sec);
/* Qibla */
double getNorthQibla(const Location* location);
#ifdef __cplusplus
}
#endif
#endif /* _PRAYER_ENGINE_ */
|