dive.h

   1 #ifndef DIVE_H
   2 #define DIVE_H
   3
   4 #include <stdlib.h>
   5 #include <time.h>
   6
   7 #include <glib.h>
   8 #include <libxml/tree.h>
   9
  10 /*
  11  * Some silly typedefs to make our units very explicit.
  12  *
  13  * Also, the units are chosen so that values can be expressible as
  14  * integers, so that we never have FP rounding issues. And they
  15  * are small enough that converting to/from imperial units doesn't
  16  * really matter.
  17  *
  18  * We also strive to make '0' a meaningless number saying "not
  19  * initialized", since many values are things that may not have
  20  * been reported (eg cylinder pressure or temperature from dive
  21  * computers that don't support them). But sometimes -1 is an even
  22  * more explicit way of saying "not there".
  23  *
  24  * Thus "millibar" for pressure, for example, or "millikelvin" for
  25  * temperatures. Doing temperatures in celsius or fahrenheit would
  26  * make for loss of precision when converting from one to the other,
  27  * and using millikelvin is SI-like but also means that a temperature
  28  * of '0' is clearly just a missing temperature or cylinder pressure.
  29  *
  30  * Also strive to use units that can not possibly be mistaken for a
  31  * valid value in a "normal" system without conversion. If the max
  32  * depth of a dive is '20000', you probably didn't convert from mm on
  33  * output, or if the max depth gets reported as "0.2ft" it was either
  34  * a really boring dive, or there was some missing input conversion,
  35  * and a 60-ft dive got recorded as 60mm.
  36  *
  37  * Doing these as "structs containing value" means that we always
  38  * have to explicitly write out those units in order to get at the
  39  * actual value. So there is hopefully little fear of using a value
  40  * in millikelvin as Fahrenheit by mistake.
  41  *
  42  * We don't actually use these all yet, so maybe they'll change, but
  43  * I made a number of types as guidelines.
  44  */
  45 typedef struct {
  46         int seconds;
  47 } duration_t;
  48
  49 typedef struct {
  50         int mm;
  51 } depth_t;
  52
  53 typedef struct {
  54         int mbar;
  55 } pressure_t;
  56
  57 typedef struct {
  58         int mkelvin;
  59 } temperature_t;
  60
  61 typedef struct {
  62         int mliter;
  63 } volume_t;
  64
  65 typedef struct {
  66         int permille;
  67 } fraction_t;
  68
  69 typedef struct {
  70         int grams;
  71 } weight_t;
  72
  73 struct gasmix {
  74         fraction_t o2;
  75         fraction_t he;
  76 };
  77
  78 typedef struct {
  79         volume_t size;
  80         pressure_t workingpressure;
  81         const char *description;        /* "LP85", "AL72", "AL80", "HP100+" or whatever */
  82 } cylinder_type_t;
  83
  84 typedef struct {
  85         cylinder_type_t type;
  86         struct gasmix gasmix;
  87         pressure_t start, end, sample_start, sample_end;
  88 } cylinder_t;
  89
  90 typedef struct {
  91         weight_t weight;
  92         const char *description;        /* "integrated", "belt", "ankle" */
  93 } weightsystem_t;
  94
  95 extern int cylinder_none(void *_data);
  96 extern int weightsystem_none(void *_data);
  97
  98 extern int get_pressure_units(unsigned int mb, const char **units);
  99 extern double get_depth_units(unsigned int mm, int *frac, const char **units);
 100 extern double get_volume_units(unsigned int ml, int *frac, const char **units);
 101 extern double get_temp_units(unsigned int mk, const char **units);
 102 extern double get_weight_units(unsigned int grams, int *frac, const char **units);
 103
 104 static inline double grams_to_lbs(int grams)
 105 {
 106         return grams / 453.6;
 107 }
 108
 109 static inline int lbs_to_grams(double lbs)
 110 {
 111         return lbs * 453.6 + 0.5;
 112 }
 113
 114 static inline double ml_to_cuft(int ml)
 115 {
 116         return ml / 28316.8466;
 117 }
 118
 119 static inline double cuft_to_l(double cuft)
 120 {
 121         return cuft * 28.3168466;
 122 }
 123
 124 static inline double mm_to_feet(int mm)
 125 {
 126         return mm * 0.00328084;
 127 }
 128
 129 static inline unsigned long feet_to_mm(double feet)
 130 {
 131         return feet * 304.8 + 0.5;
 132 }
 133
 134 static inline int to_feet(depth_t depth)
 135 {
 136         return mm_to_feet(depth.mm) + 0.5;
 137 }
 138
 139 static inline double mkelvin_to_C(int mkelvin)
 140 {
 141         return (mkelvin - 273150) / 1000.0;
 142 }
 143
 144 static inline double mkelvin_to_F(int mkelvin)
 145 {
 146         return mkelvin * 9 / 5000.0 - 459.670;
 147 }
 148
 149 static inline unsigned long F_to_mkelvin(double f)
 150 {
 151         return (f-32) * 1000 / 1.8 + 273150.5;
 152 }
 153
 154 static inline int to_C(temperature_t temp)
 155 {
 156         if (!temp.mkelvin)
 157                 return 0;
 158         return mkelvin_to_C(temp.mkelvin) + 0.5;
 159 }
 160
 161 static inline int to_F(temperature_t temp)
 162 {
 163         if (!temp.mkelvin)
 164                 return 0;
 165         return mkelvin_to_F(temp.mkelvin) + 0.5;
 166 }
 167
 168 static inline int to_K(temperature_t temp)
 169 {
 170         if (!temp.mkelvin)
 171                 return 0;
 172         return (temp.mkelvin + 499)/1000;
 173 }
 174
 175 static inline double psi_to_bar(double psi)
 176 {
 177         return psi / 14.5037738;
 178 }
 179
 180 static inline unsigned long psi_to_mbar(double psi)
 181 {
 182         return psi_to_bar(psi)*1000 + 0.5;
 183 }
 184
 185 static inline int to_PSI(pressure_t pressure)
 186 {
 187         return pressure.mbar * 0.0145037738 + 0.5;
 188 }
 189
 190 static inline double bar_to_atm(double bar)
 191 {
 192         return bar / 1.01325;
 193 }
 194
 195 static inline double to_ATM(pressure_t pressure)
 196 {
 197         return pressure.mbar / 1013.25;
 198 }
 199
 200 static inline int mbar_to_PSI(int mbar)
 201 {
 202         pressure_t p = {mbar};
 203         return to_PSI(p);
 204 }
 205
 206 struct sample {
 207         duration_t time;
 208         depth_t depth;
 209         temperature_t temperature;
 210         pressure_t cylinderpressure;
 211         int cylinderindex;
 212 };
 213
 214 /*
 215  * Events are currently pretty meaningless. This is
 216  * just based on the random data that libdivecomputer
 217  * gives us. I'm not sure what a real "architected"
 218  * event model would actually look like, but right
 219  * now you can associate a list of events with a dive,
 220  * and we'll do something about it.
 221  */
 222 struct event {
 223         struct event *next;
 224         duration_t time;
 225         int type, flags, value;
 226         char name[];
 227 };
 228
 229 #define MAX_CYLINDERS (8)
 230 #define MAX_WEIGHTSYSTEMS (4)
 231
 232 struct dive {
 233         int number;
 234         time_t when;
 235         char *location;
 236         char *notes;
 237         char *divemaster, *buddy;
 238         int rating;
 239         double latitude, longitude;
 240         depth_t maxdepth, meandepth;
 241         duration_t duration, surfacetime;
 242         depth_t visibility;
 243         temperature_t airtemp, watertemp;
 244         cylinder_t cylinder[MAX_CYLINDERS];
 245         weightsystem_t weightsystem[MAX_WEIGHTSYSTEMS];
 246         int sac, otu;
 247         struct event *events;
 248         int samples, alloc_samples;
 249         struct sample sample[];
 250 };
 251
 252 /*
 253  * We keep our internal data in well-specified units, but
 254  * the input and output may come in some random format. This
 255  * keeps track of those units.
 256  */
 257 /* turns out in Win32 PASCAL is defined as a calling convention */
 258 #ifdef WIN32
 259 #undef PASCAL
 260 #endif
 261 struct units {
 262         enum { METERS, FEET } length;
 263         enum { LITER, CUFT } volume;
 264         enum { BAR, PSI, PASCAL } pressure;
 265         enum { CELSIUS, FAHRENHEIT, KELVIN } temperature;
 266         enum { KG, LBS } weight;
 267 };
 268
 269 extern const struct units SI_units, IMPERIAL_units;
 270 extern struct units input_units, output_units;
 271
 272 extern int verbose;
 273
 274 struct dive_table {
 275         int nr, allocated, preexisting;
 276         struct dive **dives;
 277 };
 278
 279 extern struct dive_table dive_table;
 280
 281 extern int selected_dive;
 282 #define current_dive (get_dive(selected_dive))
 283
 284 static inline struct dive *get_dive(unsigned int nr)
 285 {
 286         if (nr >= dive_table.nr)
 287                 return NULL;
 288         return dive_table.dives[nr];
 289 }
 290
 291 extern void parse_xml_init(void);
 292 extern void parse_xml_buffer(const char *url, const char *buf, int size, GError **error);
 293 extern void set_filename(const char *filename);
 294
 295 extern void parse_file(const char *filename, GError **error);
 296
 297 #ifdef XSLT
 298 extern xmlDoc *test_xslt_transforms(xmlDoc *doc);
 299 #endif
 300
 301 extern void show_dive_info(struct dive *);
 302
 303 extern void show_dive_equipment(struct dive *);
 304
 305 extern void show_dive_stats(struct dive *);
 306
 307 extern void update_dive(struct dive *new_dive);
 308 extern void save_dives(const char *filename);
 309
 310 static inline unsigned int dive_size(int samples)
 311 {
 312         return sizeof(struct dive) + samples*sizeof(struct sample);
 313 }
 314
 315 extern time_t utc_mktime(struct tm *tm);
 316
 317 extern struct dive *alloc_dive(void);
 318 extern void record_dive(struct dive *dive);
 319 extern void delete_dive(struct dive *dive);
 320
 321 extern struct sample *prepare_sample(struct dive **divep);
 322 extern void finish_sample(struct dive *dive);
 323
 324 extern void report_dives(gboolean imported);
 325 extern struct dive *fixup_dive(struct dive *dive);
 326 extern struct dive *try_to_merge(struct dive *a, struct dive *b);
 327
 328 extern void renumber_dives(int nr);
 329
 330 extern void add_event(struct dive *dive, int time, int type, int flags, int value, const char *name);
 331
 332 /* UI related protopypes */
 333
 334 extern void init_ui(int *argcp, char ***argvp);
 335
 336 extern void run_ui(void);
 337 extern void exit_ui(void);
 338
 339 extern void report_error(GError* error);
 340
 341 extern void add_cylinder_description(cylinder_type_t *);
 342 extern void add_weightsystem_description(weightsystem_t *);
 343 extern void add_people(const char *string);
 344 extern void add_location(const char *string);
 345 extern void remember_event(const char *eventname);
 346 extern void evn_foreach(void (*callback)(const char *, int *, void *), void *data);
 347
 348 extern int add_new_dive(struct dive *dive);
 349 extern int edit_dive_info(struct dive *dive);
 350 extern void dive_list_update_dives(void);
 351 extern void flush_divelist(struct dive *dive);
 352
 353 #define DIVE_ERROR_PARSE 1
 354
 355 const char *weekday(int wday);
 356 const char *monthname(int mon);
 357
 358 #define UTF8_DEGREE "\xc2\xb0"
 359 #define UTF8_SUBSCRIPT_2 "\xe2\x82\x82"
 360 #define UTF8_WHITESTAR "\xe2\x98\x86"
 361 #define UTF8_BLACKSTAR "\xe2\x98\x85"
 362 #define ZERO_STARS      UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR
 363 #define ONE_STARS       UTF8_BLACKSTAR UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR
 364 #define TWO_STARS       UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_WHITESTAR UTF8_WHITESTAR UTF8_WHITESTAR
 365 #define THREE_STARS     UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_WHITESTAR UTF8_WHITESTAR
 366 #define FOUR_STARS      UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_WHITESTAR
 367 #define FIVE_STARS      UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR UTF8_BLACKSTAR
 368 extern const char *star_strings[];
 369
 370 #define AIR_PERMILLE 209
 371
 372 #endif /* DIVE_H */