1 /*
2  *  Empire - A multi-player, client/server Internet based war game.
3  *  Copyright (C) 1986-2021, Dave Pare, Jeff Bailey, Thomas Ruschak,
4  *                Ken Stevens, Steve McClure, Markus Armbruster
5  *
6  *  Empire is free software: you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation, either version 3 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
18  *
19  *  ---
20  *
21  *  See files README, COPYING and CREDITS in the root of the source
22  *  tree for related information and legal notices.  It is expected
23  *  that future projects/authors will amend these files as needed.
24  *
25  *  ---
26  *
27  *  plane.h: Definitions for planes and plane types
28  *
29  *  Known contributors to this file:
30  *     Dave Pare, 1986
31  *     Ken Stevens, 1995
32  *     Steve McClure, 1998
33  *     Markus Armbruster, 2004-2020
34  */
35 
36 #ifndef PLANE_H
37 #define PLANE_H
38 
39 #include "file.h"
40 #include "item.h"
41 #include "queue.h"
42 #include "types.h"
43 
44 #define PLANE_MINEFF	10
45 
46 struct plnstr {
47     /* initial part must match struct empobj */
48     signed ef_type: 8;
49     unsigned pln_seqno: 12;
50     unsigned pln_generation: 12;
51     int pln_uid;		/* unit ID (plane #) */
52     time_t pln_timestamp;	/* Last time this plane was touched */
53     natid pln_own;		/* owning country */
54     coord pln_x;		/* plane x-y */
55     coord pln_y;
56     signed char pln_type;	/* index in plchr[] */
57     signed char pln_effic;	/* actually "training" */
58     signed char pln_mobil;	/* plane mobility */
59     unsigned char pln_off;	/* repairs stopped? */
60     short pln_tech;		/* plane's tech level */
61     char pln_wing;		/* like fleet */
62     coord pln_opx;		/* Op sector coords */
63     coord pln_opy;		/* Op sector coords */
64     short pln_mission;		/* mission code */
65     short pln_radius;		/* mission radius */
66     /* end of part matching struct empobj */
67     unsigned char pln_range;	/* total distance, not radius */
68     signed char pln_harden;	/* for missiles */
69     int pln_ship;		/* UID of carrier, or -1 */
70     int pln_land;		/* UID of transporting land unit, or -1 */
71     int pln_flags;		/* State of the plane */
72     short pln_access;		/* Last tick mob was updated (MOB_ACCESS) */
73     float pln_theta;		/* position in orbital sine wave */
74 };
75 
76 #define PLN_LAUNCHED	bit(0)	/* Flying (satellite: in orbit) */
77 #define PLN_SYNCHRONOUS	bit(1)	/* A satellite in geo-synchronous orbit */
78 #define PLN_AIRBURST	bit(2)	/* Airburst the nuke we're armed with */
79 
80 struct plchrstr {
81     char *pl_name;		/* full name of type of plane */
82     short pl_mat[I_MAX+1];	/* materials to build 100% */
83 				/* only I_LCM, I_HCM, I_MILIT non-zero */
84     int pl_bwork;		/* work to build 100% */
85     int pl_tech;		/* tech needed to build */
86     int pl_cost;		/* how much it costs to build */
87     int pl_acc;			/* bombing accuracy (higher the better) */
88     int pl_load;		/* bomb load, also for carrying cargo */
89     int pl_att;			/* air-air attack/defense strengths */
90     int pl_def;
91     int pl_range;		/* how many sectors it can fly */
92     int pl_fuel;		/* fuel consumption */
93     int pl_stealth;		/* how stealthy is it? */
94     int pl_flags;		/* description of capability */
95     signed char pl_type;	/* index in plchr[] */
96 };
97 
98 #define P_B	bit(0)		/* bombing factor only for bombing */
99 #define P_T	bit(1)		/* tactical bombing ability */
100 #define P_F	bit(2)		/* interceptor/escort */
101 #define P_C	bit(3)		/* bombing factor for transport only */
102 #define P_V	bit(4)		/* vtol ability */
103 #define P_M	bit(5)		/* missile, used only once, can't be intercepted */
104 #define P_L	bit(6)		/* light plane, lands on carriers */
105 #define P_S	bit(7)		/* Spy ability */
106 #define P_I	bit(8)		/* Imaging ability (advanced spying) */
107 #define P_O	bit(9)		/* Orbital ability (a satellite) */
108 /* unused	bit(10) */
109 #define P_N	bit(11)		/* Nuclear RV interceptor (ABM) */
110 /* unused	bit(12) */
111 #define P_E	bit(13)		/* extra light */
112 #define P_K	bit(14)		/* chopper */
113 #define P_A	bit(15)		/* ASW (Anti-Sub Warfare) */
114 #define P_P	bit(16)		/* paradropping */
115 #define P_ESC	bit(17)		/* escort */
116 #define P_MINE	bit(18)		/* can lay mines */
117 #define P_SWEEP	bit(19)		/* can sweep mines */
118 #define P_MAR	bit(20)		/* missile can hit ships */
119 
120 #define PM_R	bit(0)		/* Recon mission */
121 #define PM_S	bit(1)		/* Mine-sweeping mission */
122 
123 	/* internal to "fly" module -- really shouldn't be here */
124 
125 struct plist {
126     struct emp_qelem queue;	/* list of planes */
127     int load;			/* number of bombs or items carried */
128     short pstage;		/* plague stage */
129     struct plchrstr *pcp;	/* pointer to desc of plane */
130     struct plnstr plane;	/* struct plane */
131 };
132 
133 #define getplane(n, p) ef_read(EF_PLANE, (n), (p))
134 #define putplane(n, p) ef_write(EF_PLANE, (n), (p))
135 #define getplanep(n) ((struct plnstr *)ef_ptr(EF_PLANE, (n)))
136 
137 #define PLCHR_SZ 128
138 extern struct plchrstr plchr[PLCHR_SZ];
139 
140 struct shiplist {
141     int uid;
142     struct shiplist *next;
143 };
144 
145 extern int pl_att(struct plchrstr *, int);
146 extern int pl_def(struct plchrstr *, int);
147 extern int pl_acc(struct plchrstr *, int);
148 extern int pl_range(struct plchrstr *, int);
149 extern int pl_load(struct plchrstr *, int);
150 extern int pln_att(struct plnstr *);
151 extern int pln_def(struct plnstr *);
152 extern int pln_acc(struct plnstr *);
153 extern int pln_range_max(struct plnstr *);
154 extern int pln_load(struct plnstr *);
155 
156 /* src/lib/common/cargo.c */
157 extern void pln_carrier_change(struct plnstr *, int, int, int);
158 extern int pln_first_on_ship(struct shpstr *);
159 extern int pln_first_on_land(struct lndstr *);
160 extern int pln_next_on_unit(int);
161 
162 /* src/lib/subs/aircombat.c */
163 extern int ac_flak_dam(int, int, int);
164 extern void ac_encounter(struct emp_qelem *, struct emp_qelem *, coord,
165 			 coord, char *, int);
166 extern int ac_damage_plane(struct plnstr *, natid, int, int, char *);
167 
168 /* src/lib/subs/aswplnsubs.c */
169 extern int on_shiplist(int, struct shiplist *);
170 extern void add_shiplist(int, struct shiplist **);
171 extern void free_shiplist(struct shiplist **);
172 
173 #endif
174