aioprt.h

Go to the documentation of this file.

/* Operational Roles and Analysis for AIs
   Copyright (C) 2005 Eric A. McDonald.

Xconq 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.  See the file COPYING.  */

namespace Xconq {
namespace AI {


enum OpRole_Type {
    OR_NONE = 0,
    OR_SHUTTLE,
    OR_CONSTRUCTOR,
    /* (TODO: Insert new oproles here.) */
    OR_Total
};


enum OpRole_Outcome {
    ORO_INVALID = 0,
    ORO_FAILED,
    ORO_OK,
    ORO_HANDLED_TACTICAL
    // TODO: Insert new oprole outcomes here.
};


struct OpRole {
    /* Basic Info */
    int id;
    OpRole_Type type;
    /* Extended Info */
    int dedication;
    int execs_this_turn;
    int fails_this_turn;
    /* (TODO: Graft in tasks queue here.) */
    /* Overhead */
    OpRole *next;
    OpRole *next_by_type;
    Side *side;
};


/* TEMPORARY: Side-related AI management.
    Should be moved to new files in the future. */


struct AI_Side {
    /* Scorekeeper-related information. */
    AI_SKAnalysis *sk_analyses;
    /* Operational roles. */
    OpRole *oproles;
    OpRole *oproles_free;
    OpRole **oprole_buckets;
    /* Overhead. */
    Side *side;
};

extern void create_side_ai(Side *side);
extern AI_Side * get_side_ai(Side *side);


#define OR_BLK_SZ       200


#define for_all_oproles(side,oprole) \
    for ((oprole) = (get_side_ai(side) ? get_side_ai(side)->oproles : NULL); \
         (oprole); (oprole) = (oprole)->next)


#define for_all_oproles_by_type(side,type,oprole) \
    for ((oprole) = (get_side_ai(side) ? \
                        get_side_ai(side)->oprole_buckets[type] : NULL); \
         (oprole); (oprole) = (oprole)->next_by_type)

extern void allocate_oproles(Side *side, int nodesnum = OR_BLK_SZ);
extern OpRole *acquire_oprole(Side *side, int id, OpRole_Type type);
extern void release_oprole(OpRole *oprole);
extern OpRole *find_oprole(Side *side, int id);

/* Construction */

extern int choose_utype_to_construct(OpRole *oprole, int *uscore);
extern Unit *choose_transport_to_construct_in(
    int u2, Side *side, UnitView *uview, int upchain = FALSE);
extern Task *generate_construction_task(Unit *unit, int u2);
extern int choose_construction_or_repair(OpRole *oprole);
extern OpRole_Outcome handle_constructor_oprole(OpRole *oprole);

/* General Operational Role Handling */

extern void handle_oprole(OpRole *oprole);
extern void handle_oproles(Side *side);

} // namespace Xconq::AI
} // namespace Xconq

---