Update copyright notice

[empserver] / src / lib / update / bp.c

diff --git a/src/lib/update/bp.c b/src/lib/update/bp.c
index d6bd3f0b9cc0739ae8e7d0116c8b1d4b728afb59..d81fbe777bb246bec35e83e543f04e8e04ccd91e 100644 (file)
--- a/src/lib/update/bp.c
+++ b/src/lib/update/bp.c
@@ -1,6 +1,6 @@
 /*
  *  Empire - A multi-player, client/server Internet based war game.
- *  Copyright (C) 1986-2007, Dave Pare, Jeff Bailey, Thomas Ruschak,
+ *  Copyright (C) 1986-2009, Dave Pare, Jeff Bailey, Thomas Ruschak,
  *                           Ken Stevens, Steve McClure
  *
  *  This program is free software; you can redistribute it and/or modify
@@ -25,66 +25,122 @@
  *
  *  ---
  *
- *  bp.c: Functions for build pointer (bp) handling
- * 
+ *  bp.c: The `build pointer' (bp) map
+ *
  *  Known contributors to this file:
  *     Ville Virrankoski, 1996
  *     Markus Armbruster, 2007
  */
 
+/*
+ * Some commands call update functions to simulate the update.
+ * Naturally, these functions must not change game state then.
+ * Instead, they track values separate data structure, namely the bp
+ * map.
+ */
+
 #include <config.h>
 
 #include "budg.h"
 #include "update.h"
 
+/* Item types we want to track.  */
+enum bp_item_idx {
+    BP_NONE = -1,              /* not tracked */
+    BP_MILIT, BP_LCM, BP_HCM,
+    BP_MAX = BP_HCM
+};
+
+/*
+ * Stuff to track for a sector.
+ * A bp map is an array of these.
+ */
 struct bp {
-    int val[7];
+    short bp_item[BP_MAX + 1];
+    short bp_avail;
 };
 
-static int bud_key[I_MAX + 2] =
-    { 1, 2, 3, 4, 0, 0, 0, 0, 0, 0, 5, 6, 0, 0, 7 };
+/* Map i_type to enum bp_item_idx.  */
+static enum bp_item_idx bud_key[I_MAX + 1] = {
+    BP_NONE, BP_MILIT, BP_NONE, BP_NONE,
+    BP_NONE, BP_NONE, BP_NONE, BP_NONE, BP_NONE, BP_NONE,
+    BP_LCM, BP_HCM, BP_NONE, BP_NONE
+};
 
+/* Return pointer to the element of BP belonging to SP.  */
 static struct bp *
 bp_ref(struct bp *bp, struct sctstr *sp)
 {
-    return &bp[sp->sct_x + sp->sct_y * WORLD_X];
+    return &bp[sp->sct_uid];
 }
 
+/*
+ * Return the item value tracked in BP for sector SP's item COMM.
+ * COMM must be a tracked item type.
+ */
 int
-gt_bg_nmbr(struct bp *bp, struct sctstr *sp, i_type comm)
+bp_get_item(struct bp *bp, struct sctstr *sp, i_type comm)
 {
-    int cm;
+    enum bp_item_idx idx = bud_key[comm];
 
-    if ((cm = bud_key[comm]) == 0)
+    if (CANT_HAPPEN(idx < 0))
        return sp->sct_item[comm];
-    return bp_ref(bp, sp)->val[cm - 1];
+    return bp_ref(bp, sp)->bp_item[idx];
 }
 
+/* Set the item value tracked in BP for sector SP's item COMM.  */
 void
-pt_bg_nmbr(struct bp *bp, struct sctstr *sp, i_type comm, int amount)
+bp_put_item(struct bp *bp, struct sctstr *sp, i_type comm, int amount)
 {
-    int cm;
+    enum bp_item_idx idx = bud_key[comm];
 
-    if ((cm = bud_key[comm]) != 0)
-       bp_ref(bp, sp)->val[cm - 1] = amount;
+    if (idx >= 0)
+       bp_ref(bp, sp)->bp_item[idx] = amount;
 }
 
+/* Set the item values tracked in BP for sector SP from VEC.  */
 void
-fill_update_array(struct bp *bp, struct sctstr *sp)
+bp_put_items(struct bp *bp, struct sctstr *sp, short *vec)
 {
-    int k;
+    enum bp_item_idx idx;
     struct bp *p = bp_ref(bp, sp);
     i_type i;
 
     for (i = I_NONE + 1; i <= I_MAX; i++) {
-       if ((k = bud_key[i]) != 0)
-           p->val[k - 1] = sp->sct_item[i];
+       idx = bud_key[i];
+       if (idx >= 0)
+           p->bp_item[idx] = vec[i];
     }
-    p->val[bud_key[I_MAX + 1] - 1] = sp->sct_avail;
 }
 
+/* Return avail tracked in BP for sector SP.  */
+int
+bp_get_avail(struct bp *bp, struct sctstr *sp)
+{
+    return bp_ref(bp, sp)->bp_avail;
+}
+
+/* Set avail tracked in BP for sector SP.  */
+void
+bp_put_avail(struct bp *bp, struct sctstr *sp, int amount)
+{
+    bp_ref(bp, sp)->bp_avail = amount;
+}
+
+/* Set the values tracked in BP for sector SP to the values in SP.  */
+void
+bp_set_from_sect(struct bp *bp, struct sctstr *sp)
+{
+    bp_put_items(bp, sp, sp->sct_item);
+    bp_put_avail(bp, sp, sp->sct_avail);
+}
+
+/*
+ * Return a new bp map.
+ * Caller should pass it to free() when done with it.
+ */
 struct bp *
-alloc_bp(void)
+bp_alloc(void)
 {
-    return calloc(WORLD_X * WORLD_Y, sizeof(struct bp));
+    return calloc(WORLD_SZ(), sizeof(struct bp));
 }