traderoutes.h

Go to the documentation of this file.

/***********************************************************************
 Freeciv - Copyright (C) 1996 - A Kjeldberg, L Gregersen, P Unold
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.
 
   This program 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 General Public License for more details.
***********************************************************************/
#ifndef FC__TRADEROUTES_H
#define FC__TRADEROUTES_H
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* utility */
#include "support.h" /* bool */
 
struct city;
struct city_list;
 
/* What to do with previously established trade routes that are now illegal.
 * Used in the network protocol. */
enum trade_route_illegal_cancelling
  {
    TRI_ACTIVE                        = 0, /* Keep them active */
    TRI_INACTIVE                      = 1, /* They are inactive */
    TRI_CANCEL                        = 2, /* Completely cancel them */
    TRI_LAST                          = 3
  };
 
/* Values used in the network protocol. */
enum trade_route_type {
  TRT_NATIONAL                        = 0,
  TRT_NATIONAL_IC                     = 1, /* Intercontinental */
  TRT_IN                              = 2,
  TRT_IN_IC                           = 3, /* International intercontinental */
  TRT_ALLY                            = 4,
  TRT_ALLY_IC                         = 5,
  TRT_ENEMY                           = 6,
  TRT_ENEMY_IC                        = 7,
  TRT_TEAM                            = 8,
  TRT_TEAM_IC                         = 9,
  TRT_LAST                            = 10
};
 
/* Values used in the network protocol. */
#define SPECENUM_NAME trade_route_bonus_type
#define SPECENUM_VALUE0 TBONUS_NONE
#define SPECENUM_VALUE0NAME "None"
#define SPECENUM_VALUE1 TBONUS_GOLD
#define SPECENUM_VALUE1NAME "Gold"
#define SPECENUM_VALUE2 TBONUS_SCIENCE
#define SPECENUM_VALUE2NAME "Science"
#define SPECENUM_VALUE3 TBONUS_BOTH
#define SPECENUM_VALUE3NAME "Both"
#include "specenum_gen.h"
 
/* Values used in the network protocol. */
#define SPECENUM_NAME route_direction
#define SPECENUM_VALUE0 RDIR_NONE
#define SPECENUM_VALUE0NAME N_("?routedir:None")
#define SPECENUM_VALUE1 RDIR_FROM
#define SPECENUM_VALUE1NAME N_("?routedir:From")
#define SPECENUM_VALUE2 RDIR_TO
#define SPECENUM_VALUE2NAME N_("?routedir:To")
#define SPECENUM_VALUE3 RDIR_BIDIRECTIONAL
#define SPECENUM_VALUE3NAME N_("?routedir:Bidirectional")
#include "specenum_gen.h"
 
struct trade_route_settings {
  int trade_pct;
  enum trade_route_illegal_cancelling cancelling;
  enum trade_route_bonus_type bonus_type;
};
 
struct goods_type;
 
struct trade_route {
  int partner;
  int value;
  enum route_direction dir;
  struct goods_type *goods;
};
 
/* get 'struct trade_route_list' and related functions: */
#define SPECLIST_TAG trade_route
#define SPECLIST_TYPE struct trade_route
#include "speclist.h"
 
#define trade_route_list_iterate(trade_route_list, proute) \
  TYPED_LIST_ITERATE(struct trade_route, trade_route_list, proute)
#define trade_route_list_iterate_end LIST_ITERATE_END
 
unsigned max_trade_routes(const struct city *pcity);
enum trade_route_type cities_trade_route_type(const struct city *pcity1,
                                              const struct city *pcity2);
int trade_route_type_trade_pct(enum trade_route_type type);
 
void trade_route_types_init(void);
const char *trade_route_type_name(enum trade_route_type type);
enum trade_route_type trade_route_type_by_name(const char *name);
 
const char *trade_route_cancelling_type_name(enum trade_route_illegal_cancelling type);
enum trade_route_illegal_cancelling trade_route_cancelling_type_by_name(const char *name);
 
struct trade_route_settings *
trade_route_settings_by_type(enum trade_route_type type);
 
bool can_cities_trade(const struct city *pc1, const struct city *pc2);
bool can_establish_trade_route(const struct city *pc1, const struct city *pc2,
                               int priority);
bool have_cities_trade_route(const struct city *pc1, const struct city *pc2);
int trade_base_between_cities(const struct city *pc1, const struct city *pc2);
int trade_from_route(const struct city *pc1, const struct trade_route *route,
                     int base);
int city_num_trade_routes(const struct city *pcity);
int max_trade_prod(const struct city *pcity);
int get_caravan_enter_city_trade_bonus(const struct city *pc1,
                                       const struct city *pc2,
                                       const struct unit_type *ut,
                                       struct goods_type *pgood,
                                       const bool establish_trade);
int city_trade_removable(const struct city *pcity, int priority,
                         struct trade_route_list *would_remove);
 
#define trade_routes_iterate(c, proute)                     \
do {                                                        \
  trade_route_list_iterate(c->routes, proute) {
 
#define trade_routes_iterate_end                            \
  } trade_route_list_iterate_end;                           \
} while (FALSE)
 
#define trade_routes_iterate_safe(c, proute)                \
{                                                           \
  struct city *c##_proute = c;                              \
  int _routes##_size = trade_route_list_size(c##_proute->routes); \
                                                            \
  if (_routes##_size > 0) {                                 \
    struct trade_route *_routes##_saved[_routes##_size];    \
    int _routes##_index;                                    \
                                                            \
    _routes##_size = 0;                                     \
    trade_routes_iterate(c##_proute, _proute) {             \
      _routes##_saved[_routes##_size++] = _proute;          \
    } trade_routes_iterate_end;                             \
    for (_routes##_index = 0;                               \
         _routes##_index < _routes##_size;                  \
         _routes##_index++) {                               \
      struct trade_route *proute = _routes##_saved[_routes##_index];
 
#define trade_routes_iterate_safe_end                       \
    }                                                       \
  }                                                         \
}
 
#define trade_partners_iterate(c, p)                        \
do {                                                        \
  trade_routes_iterate(c, _proute_) {                       \
    struct city *p = game_city_by_number(_proute_->partner);
 
#define trade_partners_iterate_end                          \
  } trade_routes_iterate_end;                               \
} while (FALSE);
 
/* Used in the network protocol. */
#define SPECENUM_NAME goods_flag_id
#define SPECENUM_VALUE0 GF_BIDIRECTIONAL
#define SPECENUM_VALUE0NAME "Bidirectional"
#define SPECENUM_VALUE1 GF_DEPLETES
#define SPECENUM_VALUE1NAME "Depletes"
#define SPECENUM_VALUE2 GF_SELF_PROVIDED
#define SPECENUM_VALUE2NAME "Self-Provided"
#define SPECENUM_COUNT GF_COUNT
#define SPECENUM_BITVECTOR bv_goods_flags
#include "specenum_gen.h"
 
/* Some places assume this to be bigger than any actual goods priority */
#define GOODS_HIGH_PRIORITY 100
 
struct goods_type
{
  int id;
  struct name_translation name;
  bool ruledit_disabled; /* Does not really exist - hole in goods array */
 
  struct requirement_vector reqs;
 
  int from_pct;
  int to_pct;
  int onetime_pct;
 
  int select_priority;
  int replace_priority;
 
  bv_goods_flags flags;
 
  struct strvec *helptext;
};
 
void goods_init(void);
void goods_free(void);
 
Goods_type_id goods_index(const struct goods_type *pgood);
Goods_type_id goods_number(const struct goods_type *pgood);
 
struct goods_type *goods_by_number(Goods_type_id id);
 
const char *goods_name_translation(struct goods_type *pgood);
const char *goods_rule_name(struct goods_type *pgood);
struct goods_type *goods_by_rule_name(const char *name);
struct goods_type *goods_by_translated_name(const char *name);
 
bool goods_has_flag(const struct goods_type *pgood, enum goods_flag_id flag);
 
bool goods_can_be_provided(const struct city *pcity,
                           const struct goods_type *pgood,
                           const struct unit *punit);
struct goods_type *goods_from_city_to_unit(const struct city *src,
                                           const struct unit *punit);
struct goods_type *unit_current_goods(const struct unit *punit,
                                      const struct city *homecity);
bool city_receives_goods(const struct city *pcity,
                         const struct goods_type *pgood);
 
#define goods_type_iterate(_p)                                \
{                                                             \
  int _i_;                                                    \
  for (_i_ = 0; _i_ < game.control.num_goods_types ; _i_++) { \
    struct goods_type *_p = goods_by_number(_i_);
 
#define goods_type_iterate_end                       \
  }                                                  \
}
 
#define goods_type_re_active_iterate(_p)                      \
  goods_type_iterate(_p) {                                    \
    if (!_p->ruledit_disabled) {
 
#define goods_type_re_active_iterate_end                      \
    }                                                         \
  } goods_type_iterate_end;
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* FC__TRADEROUTES_H */