// SPDX-License-Identifier: GPL-2.0 #ifndef EQUIPMENT_H #define EQUIPMENT_H #include "gas.h" #include #include #include struct dive; enum cylinderuse {OC_GAS, DILUENT, OXYGEN, NOT_USED, NUM_GAS_USE}; // The different uses for cylinders extern const char *cylinderuse_text[NUM_GAS_USE]; struct cylinder_type_t { volume_t size; pressure_t workingpressure; std::string description; /* "LP85", "AL72", "AL80", "HP100+" or whatever */ }; struct cylinder_t { cylinder_type_t type; struct gasmix gasmix = gasmix_air; pressure_t start, end, sample_start, sample_end; depth_t depth; bool manually_added = false; volume_t gas_used; volume_t deco_gas_used; enum cylinderuse cylinder_use = OC_GAS; bool bestmix_o2 = false; bool bestmix_he = false; cylinder_t(); ~cylinder_t(); }; /* Table of cylinders. * This is a crazy class: it is basically a std::vector<>, but overrides * the [] accessor functions and allows out-of-bound accesses. * This is used in the planner, which uses "max_index + 1" for the * surface air cylinder. * Note: an out-of-bound access returns a reference to an object with * static linkage that MUST NOT be written into. * Yes, this is all very mad, but it grew historically. */ struct cylinder_table : public std::vector { cylinder_t &operator[](size_t i); const cylinder_t &operator[](size_t i) const; }; struct weightsystem_t { weight_t weight; const char *description; /* "integrated", "belt", "ankle" */ bool auto_filled; /* weight was automatically derived from the type */ }; static const weightsystem_t empty_weightsystem = { { 0 }, 0, false }; /* Table of weightsystems. Attention: this stores weightsystems, * *not* pointers * to weightsystems. This has two crucial * consequences: * 1) Pointers to weightsystems are not stable. They may be * invalidated if the table is reallocated. * 2) add_to_weightsystem_table(), etc. takes ownership of the * weightsystem. Notably of the description string */ struct weightsystem_table { int nr, allocated; weightsystem_t *weightsystems; }; extern enum cylinderuse cylinderuse_from_text(const char *text); extern void copy_weights(const struct weightsystem_table *s, struct weightsystem_table *d); extern weightsystem_t clone_weightsystem(weightsystem_t ws); extern void free_weightsystem(weightsystem_t ws); extern void copy_cylinder_types(const struct dive *s, struct dive *d); extern void add_cloned_weightsystem(struct weightsystem_table *t, weightsystem_t ws); extern cylinder_t *add_empty_cylinder(struct cylinder_table *t); extern cylinder_t *get_cylinder(struct dive *d, int idx); extern const cylinder_t *get_cylinder(const struct dive *d, int idx); extern cylinder_t *get_or_create_cylinder(struct dive *d, int idx); extern bool same_weightsystem(weightsystem_t w1, weightsystem_t w2); extern void remove_cylinder(struct dive *dive, int idx); extern void remove_weightsystem(struct dive *dive, int idx); extern void set_weightsystem(struct dive *dive, int idx, weightsystem_t ws); extern void reset_cylinders(struct dive *dive, bool track_gas); extern int gas_volume(const cylinder_t *cyl, pressure_t p); /* Volume in mliter of a cylinder at pressure 'p' */ extern int find_best_gasmix_match(struct gasmix mix, const struct cylinder_table &cylinders); extern void fill_default_cylinder(const struct dive *dive, cylinder_t *cyl); /* dive is needed to fill out MOD, which depends on salinity. */ extern cylinder_t default_cylinder(const struct dive *d); extern cylinder_t create_new_manual_cylinder(const struct dive *dive); /* dive is needed to fill out MOD, which depends on salinity. */ extern void add_default_cylinder(struct dive *dive); extern int first_hidden_cylinder(const struct dive *d); #ifdef DEBUG_CYL extern void dump_cylinders(struct dive *dive, bool verbose); #endif /* Weightsystem table functions */ extern void clear_weightsystem_table(struct weightsystem_table *); extern void add_to_weightsystem_table(struct weightsystem_table *, int idx, weightsystem_t ws); /* Cylinder table functions */ extern void add_cylinder(struct cylinder_table *, int idx, cylinder_t cyl); void get_gas_string(struct gasmix gasmix, char *text, int len); const char *gasname(struct gasmix gasmix); struct ws_info { std::string name; weight_t weight; }; extern std::vector ws_info_table; extern weight_t get_weightsystem_weight(const std::string &name); // returns 0 if not found extern void add_weightsystem_description(const weightsystem_t &); struct tank_info { std::string name; int cuft, ml, psi, bar; }; extern std::vector tank_info_table; extern struct tank_info *get_tank_info(std::vector &table, const std::string &name); extern void set_tank_info_data(std::vector &table, const std::string &name, volume_t size, pressure_t working_pressure); extern std::pair extract_tank_info(const struct tank_info &info); extern std::pair get_tank_info_data(const std::vector &table, const std::string &name); extern void add_cylinder_description(const cylinder_type_t &); extern void reset_tank_info_table(std::vector &table); #endif // EQUIPMENT_H