67 |
68 |
The aim of this game is to programmatically control a cannon to shoot
69 | and destroy hordes of enemies. The cannon exposes a JavaScript API for you
70 | to use to control it. You will find some examples and a
71 | complete API reference below.
72 |
73 |
Every time an enemy reaches the cannon, the cannon
74 | loses 1 health point (out of 10). Once health goes down to 0, you lose.
75 |
76 |
The cannon can basically perform two actions: it can
77 | shoot or self-repair from damage taken. Both actions will require some
78 | time for the cannon to be ready again.
79 |
80 |
81 |
You can aim the cannon using the function
82 | this.setCannonAngle (A), which takes as a parameter
83 | the angle you want to point the cannon at, measured in radians, counter-clockwise,
84 | starting from the horizontal (which means, 0 is horizontal, Math.PI / is
85 | vertical). The cannon has a minimum and maximum angle, which you can
86 | respectively read in the variables cannonMinAngle and cannonMaxAngle.
87 | When the function is called, the cannon starts moving towards the wanted
88 | angle. You can check what angle it currently is at using the function
89 | this.getCannonAngle().
90 |
91 |
92 |
93 |
Using the function this.shoot(), the
94 | cannon will shoot if ready. After shooting, it will have to reload and
95 | won't be able to shoot for a while.
96 |
97 |
98 |
99 |
You can recover your cannon's health with the function
100 | this.repair(). As for shooting, this will take some
101 | time for the cannon to be ready again to shoot or repair. Repair reload
102 | time is twice as long as shoot reload time.
103 |
104 |
105 |
106 |
You can access information about the enemies via the
107 | this.getEnemies() function. Enemies can come
108 | both on the ground or in the air. The pattern they will follow depends
109 | on the test you choose.
110 |
111 |
112 |
113 |
The score will be calculated as follows:
114 | [survived time] + 5*[kills] + 20*[accuracy] - [repairs]
115 |
116 |
117 |
118 |
setup: function () { /* Miscellaneous setup things here */ },
119 |
120 | update: function () {
121 | this.shoot(); // Shoots the cannon
122 | }
123 |
124 |
125 |
setup: function() {
126 | this.setCannonAngle ( cannonMaxAngle );
127 | },
128 |
129 | update: function () {
130 | // Moves the cannon from up to down continuously
131 | if ( this.getCannonAngle() == cannonMaxAngle )
132 | this.setCannonAngle ( cannonMinAngle );
133 | if ( this.getCannonAngle() == cannonMinAngle )
134 | this.setCannonAngle ( cannonMaxAngle );
135 |
136 | this.shoot();
137 | }
138 |
139 |
140 |
setup: function () { /* Miscellaneous setup things here */ },
141 |
142 | update: function () {
143 | if ( this.hp() < 5 ) // EMERGENCY! Low health => repair
144 | this.repair();
145 |
146 | this.shoot();
147 | }
148 |
149 |
150 |
151 |
152 | this.shoot():
153 | shoots the cannon; it works only if the cannon
154 | is ready; you can check that programmatically via the
155 | this.ready() function. The function returns 1
156 | if the cannon could shoot, 0 otherwise.
157 |
158 |
159 |
160 | this.repair():
161 | repairs your cannon, restoring 1 hit point; it
162 | works only if the cannon is ready; you can check that programmatically via the
163 | this.ready() function. The function returns 1
164 | if the cannon could repair, 0 otherwise.
165 |
166 |
167 |
168 | this.setCannonAngle(A):
169 | tells the cannon to move to angle A, given in radians
170 | (0 means horizontal, Math.PI/2 means vertical - note that cannon angle has
171 | a maximum and a minimum, see more here).
172 |
173 |
174 |
175 | this.getCannonAngle():
176 | returns current cannon angle, in radians; 0 means
177 | horizontal and Math.PI/2 means vertical (note that cannon angle has
178 | a maximum and a minimum, see more here).
179 |
180 |
181 |
182 | this.getEnemies():
183 | returns the current alive enemies as an array;
184 | each element of the array is a two-element array [x,y], where x is
185 | the x coordinate of the enemy (0 is the cannon's base center position)
186 | and y is the vertical coordinate (0 is the ground). Enemies are sorted
187 | in ascending x order, so that the first element of the array is always
188 | the closest to the cannon.
189 |
190 |
191 |
192 | this.ready():
193 | returns 1 if the cannon is ready to shoot,
194 | or repair 0 otherwise.
195 |
196 |
197 |
198 | this.hp():
199 | returns the amount of hit points left the cannon has.
200 |
201 |
202 |
203 | this.mark(i):
204 | you can use this function to mark the enemy of index i.
205 | The marked enemy is graphically highlighted. You can use this function for
206 | debugging purposes; you can mark only one enemy at a time, so the only
207 | actually marked enemy will be the last one on which this function was called.
208 |
209 |
210 |
211 | this.unmark():
212 | removes the mark from the currently marked enemy.
213 |
214 |
215 |
216 |
217 | cannonShootSpeed:
218 | the speed of the cannon projectile when shot.
219 |
220 |
221 |
222 | g:
223 | gravity force.
224 |
225 |
226 |
227 | controllerT:
228 | game time in seconds between two subsequent calls of the update() function
229 | (game time is measured with respect to the timer in the top left corner of game screen).
230 |
231 |
232 |
233 | cannonMinAngle:
234 | minimum cannon angle.
235 |
236 |
237 |
238 | cannonMaxAngle:
239 | maximum cannon angle.
240 |
241 |