Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
ex_iso_astar.c
Go to the documentation of this file.
1/*
2 * Nilorea Library
3 * Copyright (C) 2005-2026 Castagnier Mickael
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
14 * implied. See the License for the specific language governing
15 * permissions and limitations under the License.
16 *
17 * SPDX-License-Identifier: Apache-2.0
18 */
19
45#include <stdio.h>
46#include <stdlib.h>
47#include <string.h>
48#include <math.h>
49
50#include "nilorea/n_common.h"
51#include "nilorea/n_log.h"
52#include "nilorea/n_astar.h"
56
57#ifndef M_PI
58#define M_PI 3.14159265358979323846
59#endif
60
61/* Map configuration */
62#define MAP_W 20
63#define MAP_H 20
64#define NUM_TERRAINS 4
65#define MAX_HEIGHT 5
66#define TILE_WIDTH 64.0f
67
68static const char* terrain_names[] = {"Grass", "Sand", "Water", "Rock"};
69
70/* Print a simple ASCII view of the map */
71static void print_map_ascii(const ISO_MAP* map, const ASTAR_PATH* path) {
72 /* Build a grid of characters */
73 char grid[MAP_H][MAP_W];
74 for (int y = 0; y < map->height; y++) {
75 for (int x = 0; x < map->width; x++) {
76 int t = iso_map_get_terrain(map, x, y);
77 int h = iso_map_get_height(map, x, y);
78 int ab = iso_map_get_ability(map, x, y);
79 if (ab == BLCK) {
80 grid[y][x] = '#';
81 } else if (t == 2) { /* water */
82 grid[y][x] = '~';
83 } else {
84 grid[y][x] = (char)('0' + h);
85 }
86 }
87 }
88
89 /* Overlay the A* path */
90 if (path) {
91 for (int i = 0; i < path->length; i++) {
92 int px = path->nodes[i].x;
93 int py = path->nodes[i].y;
94 if (px >= 0 && px < MAP_W && py >= 0 && py < MAP_H) {
95 if (i == 0)
96 grid[py][px] = 'S'; /* start */
97 else if (i == path->length - 1)
98 grid[py][px] = 'G'; /* goal */
99 else
100 grid[py][px] = '*'; /* path */
101 }
102 }
103 }
104
105 printf("\n ");
106 for (int x = 0; x < map->width; x++) printf("%d", x % 10);
107 printf("\n");
108 for (int y = 0; y < map->height; y++) {
109 printf("%2d", y);
110 for (int x = 0; x < map->width; x++) {
111 printf("%c", grid[y][x]);
112 }
113 printf("\n");
114 }
115 printf("\nLegend: #=blocked ~=water 0-5=height S=start G=goal *=path\n");
116}
117
118/* Build a test map with varied terrain and obstacles */
119static void build_test_map(ISO_MAP* map) {
120 /* Fill with grass at height 0 */
121 for (int y = 0; y < map->height; y++) {
122 for (int x = 0; x < map->width; x++) {
123 iso_map_set_terrain(map, x, y, 0); /* grass */
124 iso_map_set_height(map, x, y, 0);
125 iso_map_set_ability(map, x, y, WALK);
126 }
127 }
128
129 /* Sand strip along the bottom */
130 for (int x = 0; x < map->width; x++) {
131 for (int y = 15; y < 18; y++) {
132 iso_map_set_terrain(map, x, y, 1); /* sand */
133 }
134 }
135
136 /* Water river through the middle */
137 for (int y = 8; y < 11; y++) {
138 for (int x = 0; x < map->width; x++) {
139 iso_map_set_terrain(map, x, y, 2); /* water */
140 iso_map_set_ability(map, x, y, BLCK);
141 }
142 }
143 /* Bridge over the river */
144 for (int y = 8; y < 11; y++) {
145 iso_map_set_terrain(map, 10, y, 3); /* rock bridge */
146 iso_map_set_height(map, 10, y, 1);
147 iso_map_set_ability(map, 10, y, WALK);
148 }
149
150 /* Rocky hills in the top-right */
151 for (int y = 1; y < 6; y++) {
152 for (int x = 14; x < 19; x++) {
153 iso_map_set_terrain(map, x, y, 3); /* rock */
154 iso_map_set_height(map, x, y, 2 + (x + y) % 3);
155 }
156 }
157
158 /* Wall obstacle */
159 for (int y = 3; y < 7; y++) {
160 iso_map_set_ability(map, 7, y, BLCK);
161 iso_map_set_height(map, 7, y, MAX_HEIGHT);
162 }
163
164 /* Another small wall */
165 for (int x = 3; x < 7; x++) {
166 iso_map_set_ability(map, x, 13, BLCK);
167 iso_map_set_height(map, x, 13, MAX_HEIGHT);
168 }
169}
170
171/* Demo 1: Isometric engine features */
172static void demo_iso_engine(ISO_MAP* map) {
173 printf("=== DEMO 1: Isometric Engine ===\n\n");
174
175 /* Show projection info */
176 printf("Projection: classic 2:1 (%.1f deg)\n", map->proj.angle_deg);
177 printf(" half_w=%.1f half_h=%.1f tile_lift=%.1f\n\n",
178 map->proj.half_w, map->proj.half_h, map->proj.tile_lift);
179
180 /* Map-to-screen conversion */
181 printf("Coordinate conversion examples (map -> screen):\n");
182 int test_coords[][3] = {{0, 0, 0}, {5, 5, 0}, {10, 0, 0}, {0, 10, 0}, {10, 10, 2}};
183 for (int i = 0; i < 5; i++) {
184 float sx, sy;
185 iso_map_to_screen(map, test_coords[i][0], test_coords[i][1],
186 test_coords[i][2], &sx, &sy);
187 printf(" Map(%d,%d) h=%d -> Screen(%.1f, %.1f)\n",
188 test_coords[i][0], test_coords[i][1], test_coords[i][2], sx, sy);
189 }
190
191 /* Screen-to-map conversion */
192 printf("\nReverse conversion examples (screen -> map):\n");
193 float test_screen[][2] = {{32.0f, 16.0f}, {200.0f, 100.0f}, {0.0f, 320.0f}};
194 for (int i = 0; i < 3; i++) {
195 int mx, my;
196 iso_screen_to_map(map, test_screen[i][0], test_screen[i][1], &mx, &my);
197 printf(" Screen(%.0f, %.0f) -> Map(%d, %d)\n",
198 test_screen[i][0], test_screen[i][1], mx, my);
199 }
200
201 /* Height interpolation */
202 printf("\nHeight interpolation at fractional coordinates:\n");
203 float test_frac[][2] = {{10.0f, 9.0f}, {10.5f, 9.5f}, {15.0f, 3.0f}, {15.5f, 3.5f}};
204 for (int i = 0; i < 4; i++) {
205 float h = iso_map_interpolate_height(map, test_frac[i][0], test_frac[i][1]);
206 printf(" Height at (%.1f, %.1f) = %.2f\n", test_frac[i][0], test_frac[i][1], h);
207 }
208
209 /* Terrain transitions */
210 printf("\nTerrain transitions (edge/corner bitmasks):\n");
211 int trans_coords[][2] = {{9, 8}, {10, 7}, {14, 6}, {6, 15}};
212 for (int i = 0; i < 4; i++) {
213 int edge, corner;
214 int tx = trans_coords[i][0], ty = trans_coords[i][1];
215 iso_map_calc_transitions(map, tx, ty, &edge, &corner);
216 printf(" (%2d,%2d) terrain=%s edge=0x%X corner=0x%X\n",
217 tx, ty, terrain_names[iso_map_get_terrain(map, tx, ty)], edge, corner);
218 }
219
220 /* Corner heights for smooth rendering */
221 printf("\nCorner heights for smooth rendering:\n");
222 int corner_coords[][2] = {{10, 9}, {15, 3}, {7, 5}};
223 for (int i = 0; i < 3; i++) {
224 float hn, he, hs, hw;
225 int cx = corner_coords[i][0], cy = corner_coords[i][1];
226 iso_map_corner_heights(map, cx, cy, &hn, &he, &hs, &hw);
227 printf(" (%2d,%2d) h=%d corners: N=%.1f E=%.1f S=%.1f W=%.1f\n",
228 cx, cy, iso_map_get_height(map, cx, cy), hn, he, hs, hw);
229 }
230
231 /* Save and reload */
232 printf("\nMap save/load test:\n");
233 int saved = iso_map_save(map, "test_iso_map.bin");
234 printf(" Save: %s\n", saved ? "OK" : "FAILED");
235 ISO_MAP* loaded = iso_map_load("test_iso_map.bin");
236 if (loaded) {
237 int match = 1;
238 for (int y = 0; y < map->height && match; y++)
239 for (int x = 0; x < map->width && match; x++)
240 if (iso_map_get_terrain(map, x, y) != iso_map_get_terrain(loaded, x, y) ||
241 iso_map_get_height(map, x, y) != iso_map_get_height(loaded, x, y) ||
242 iso_map_get_ability(map, x, y) != iso_map_get_ability(loaded, x, y))
243 match = 0;
244 printf(" Load: OK (data %s)\n", match ? "matches" : "MISMATCH");
245 iso_map_free(&loaded);
246 } else {
247 printf(" Load: FAILED\n");
248 }
249 remove("test_iso_map.bin");
250}
251
252/* Demo 2: A* pathfinding on the isometric map */
253static ASTAR_PATH* demo_astar(const ISO_MAP* map) {
254 printf("\n=== DEMO 2: A* Pathfinding ===\n\n");
255
256 /* Create ASTAR_GRID from the ISO_MAP */
257 ASTAR_GRID* grid = n_astar_grid_new(map->width, map->height, 1);
258 if (!grid) {
259 printf("Failed to create A* grid\n");
260 return NULL;
261 }
262
263 /* Populate walkability from map abilities */
264 for (int y = 0; y < map->height; y++) {
265 for (int x = 0; x < map->width; x++) {
266 int ab = iso_map_get_ability(map, x, y);
267 uint8_t walkable = (ab == WALK || ab == SWIM) ? 1 : 0;
268 n_astar_grid_set_walkable(grid, x, y, 0, walkable);
269
270 /* Higher terrain costs more */
271 int h = iso_map_get_height(map, x, y);
272 n_astar_grid_set_cost(grid, x, y, 0, ASTAR_COST_CARDINAL + h * 200);
273 }
274 }
275
276 /* Find path from top-left area to bottom-right area */
277 int sx = 2, sy = 2, gx = 17, gy = 17;
278 printf("Finding path from (%d,%d) to (%d,%d)...\n", sx, sy, gx, gy);
279
280 ASTAR_PATH* path = n_astar_find_path(grid, sx, sy, 0, gx, gy, 0,
283 if (path) {
284 printf("Path found! Length: %d nodes, Cost: %d (x1000)\n",
285 path->length, path->cost);
286 printf("Path: ");
287 for (int i = 0; i < path->length; i++) {
288 if (i > 0) printf(" -> ");
289 printf("(%d,%d)", path->nodes[i].x, path->nodes[i].y);
290 }
291 printf("\n");
292 } else {
293 printf("No path found!\n");
294 }
295
296 /* Try a second path that must cross the river via the bridge */
297 printf("\nFinding path from (2,5) to (2,15) (must use bridge)...\n");
298 ASTAR_PATH* path2 = n_astar_find_path(grid, 2, 5, 0, 2, 15, 0,
301 if (path2) {
302 printf("Path found! Length: %d nodes, Cost: %d\n", path2->length, path2->cost);
303 printf("Path: ");
304 for (int i = 0; i < path2->length; i++) {
305 if (i > 0) printf(" -> ");
306 printf("(%d,%d)", path2->nodes[i].x, path2->nodes[i].y);
307 }
308 printf("\n");
309 n_astar_path_free(path2);
310 } else {
311 printf("No path found!\n");
312 }
313
314 /* Try an impossible path */
315 printf("\nFinding path from (0,0) to blocked cell (7,4)...\n");
316 ASTAR_PATH* path3 = n_astar_find_path(grid, 0, 0, 0, 7, 4, 0,
319 printf("Result: %s\n", path3 ? "Found (unexpected!)" : "No path (correct - cell is blocked)");
320 if (path3) n_astar_path_free(path3);
321
322 n_astar_grid_free(grid);
323 return path;
324}
325
326/* Demo 3: Dead reckoning simulation along the A* path */
327static void demo_dead_reckoning(const ISO_MAP* map, const ASTAR_PATH* path) {
328 printf("\n=== DEMO 3: Dead Reckoning Along A* Path ===\n\n");
329
330 if (!path || path->length < 2) {
331 printf("No valid path for dead reckoning demo\n");
332 return;
333 }
334
335 /* Create trajectory from A* path waypoints */
337 if (!traj) {
338 printf("Failed to create trajectory\n");
339 return;
340 }
341
342 double move_speed = 3.0; /* tiles per second */
343 double t = 0.0;
344 for (int i = 0; i < path->length; i++) {
345 PHYSICS state;
346 memset(&state, 0, sizeof(state));
347 state.position[0] = (double)path->nodes[i].x;
348 state.position[1] = (double)path->nodes[i].y;
349
350 /* Compute velocity as direction to next waypoint */
351 if (i < path->length - 1) {
352 double dx = (double)(path->nodes[i + 1].x - path->nodes[i].x);
353 double dy = (double)(path->nodes[i + 1].y - path->nodes[i].y);
354 double dist = sqrt(dx * dx + dy * dy);
355 if (dist > 0.001) {
356 state.speed[0] = dx / dist * move_speed;
357 state.speed[1] = dy / dist * move_speed;
358 }
359 }
360
361 trajectory_add_point(traj, &state, t);
362
363 /* Time to next waypoint */
364 if (i < path->length - 1) {
365 double dx = (double)(path->nodes[i + 1].x - path->nodes[i].x);
366 double dy = (double)(path->nodes[i + 1].y - path->nodes[i].y);
367 double dist = sqrt(dx * dx + dy * dy);
368 t += dist / move_speed;
369 }
370 }
371
372 double total_time = t;
373 printf("Trajectory total time: %.2f seconds (%d waypoints)\n\n", total_time, path->length);
374
375 /* Create dead reckoning entity with PVB blending */
377 if (!dr) {
378 printf("Failed to create DR entity\n");
379 trajectory_delete(&traj);
380 return;
381 }
382
383 /* Simulation: "true" entity follows trajectory exactly.
384 * Network sends updates every 0.5 seconds.
385 * DR entity receives updates and extrapolates/blends between them. */
386 double sim_dt = 0.05; /* simulation timestep (50ms) */
387 double send_interval = 0.5; /* network update interval */
388 double last_send = -send_interval; /* force initial send */
389
390 printf("Time | True Pos | DR Pos | Error | Height | Updates\n");
391 printf("------+---------------+---------------+-------+--------+--------\n");
392
393 for (double sim_t = 0.0; sim_t <= total_time + 0.1; sim_t += sim_dt) {
394 /* Compute "true" position from trajectory */
395 VECTOR3D true_pos;
396 trajectory_get_position(traj, sim_t, true_pos);
397
398 /* Compute true velocity */
399 VECTOR3D true_vel;
400 trajectory_get_speed(traj, sim_t, true_vel);
401
402 /* Simulate periodic network updates */
403 if (sim_t - last_send >= send_interval) {
404 DR_VEC3 pos = dr_vec3(true_pos[0], true_pos[1], 0.0);
405 DR_VEC3 vel = dr_vec3(true_vel[0], true_vel[1], 0.0);
406 DR_VEC3 acc = dr_vec3_zero();
407 dr_entity_receive_state(dr, &pos, &vel, &acc, sim_t);
408 last_send = sim_t;
409 }
410
411 /* Compute DR display position */
412 DR_VEC3 dr_pos;
413 dr_entity_compute(dr, sim_t, &dr_pos);
414
415 /* Compute error */
416 double err = sqrt((dr_pos.x - true_pos[0]) * (dr_pos.x - true_pos[0]) +
417 (dr_pos.y - true_pos[1]) * (dr_pos.y - true_pos[1]));
418
419 /* Get terrain height at DR position */
420 float h = iso_map_interpolate_height(map, (float)dr_pos.x, (float)dr_pos.y);
421
422 /* Print at regular intervals */
423 double print_interval = 0.5;
424 double mod = fmod(sim_t, print_interval);
425 if (mod < sim_dt || sim_t < sim_dt) {
426 printf("%5.2f | (%5.2f,%5.2f) | (%5.2f,%5.2f) | %5.3f | %6.2f | %d\n",
427 sim_t,
428 true_pos[0], true_pos[1],
429 dr_pos.x, dr_pos.y,
430 err, h, dr->update_count);
431 }
432 }
433
434 /* Show blending mode comparison */
435 printf("\n--- Convergence Mode Comparison ---\n");
436 const char* mode_names[] = {"Snap", "PVB", "Cubic"};
438
439 for (int m = 0; m < 3; m++) {
440 DR_ENTITY* test_dr = dr_entity_create(DR_ALGO_VEL_ACC, modes[m], 0.5, 0.3);
441 double total_err = 0.0;
442 int samples = 0;
443 last_send = -send_interval;
444
445 for (double sim_t = 0.0; sim_t <= total_time; sim_t += sim_dt) {
446 VECTOR3D tp, tv;
447 trajectory_get_position(traj, sim_t, tp);
448 trajectory_get_speed(traj, sim_t, tv);
449
450 if (sim_t - last_send >= send_interval) {
451 DR_VEC3 p = dr_vec3(tp[0], tp[1], 0.0);
452 DR_VEC3 v = dr_vec3(tv[0], tv[1], 0.0);
453 DR_VEC3 a = dr_vec3_zero();
454 dr_entity_receive_state(test_dr, &p, &v, &a, sim_t);
455 last_send = sim_t;
456 }
457
458 DR_VEC3 dp;
459 dr_entity_compute(test_dr, sim_t, &dp);
460
461 double err = sqrt((dp.x - tp[0]) * (dp.x - tp[0]) +
462 (dp.y - tp[1]) * (dp.y - tp[1]));
463 total_err += err;
464 samples++;
465 }
466
467 printf(" %-6s: avg error = %.4f over %d samples\n",
468 mode_names[m], total_err / (double)samples, samples);
469 dr_entity_destroy(&test_dr);
470 }
471
472 /* Threshold check demo */
473 printf("\n--- Threshold Check Demo ---\n");
475 DR_VEC3 init_pos = dr_vec3(path->nodes[0].x, path->nodes[0].y, 0.0);
476 dr_entity_set_position(owner_dr, &init_pos, NULL, NULL, 0.0);
477
478 int updates_sent = 0;
479 for (double sim_t = 0.0; sim_t <= total_time; sim_t += sim_dt) {
480 VECTOR3D tp, tv;
481 trajectory_get_position(traj, sim_t, tp);
482 trajectory_get_speed(traj, sim_t, tv);
483 DR_VEC3 true_p = dr_vec3(tp[0], tp[1], 0.0);
484 DR_VEC3 true_v = dr_vec3(tv[0], tv[1], 0.0);
485 DR_VEC3 true_a = dr_vec3_zero();
486
487 if (dr_entity_check_threshold(owner_dr, &true_p, &true_v, &true_a, sim_t)) {
488 dr_entity_receive_state(owner_dr, &true_p, &true_v, &true_a, sim_t);
489 updates_sent++;
490 }
491 }
492 printf(" With threshold=1.0 tile: sent %d updates over %.1f seconds\n",
493 updates_sent, total_time);
494 printf(" (vs %d with fixed 0.5s interval)\n", (int)(total_time / send_interval) + 1);
495 dr_entity_destroy(&owner_dr);
496
498 trajectory_delete(&traj);
499}
500
501/* Demo 4: A* pathfinding standalone test */
502static void demo_astar_standalone(void) {
503 printf("\n=== DEMO 4: A* Pathfinding Standalone Tests ===\n\n");
504
505 /* Create a 10x10 grid with some walls */
506 ASTAR_GRID* grid = n_astar_grid_new(10, 10, 1);
507 if (!grid) {
508 printf("Failed to create grid\n");
509 return;
510 }
511
512 /* Build a maze-like layout */
513 n_astar_grid_set_rect_blocked(grid, 2, 0, 0, 2, 5, 0);
514 n_astar_grid_set_rect_blocked(grid, 4, 3, 0, 4, 9, 0);
515 n_astar_grid_set_rect_blocked(grid, 6, 0, 0, 6, 6, 0);
516 n_astar_grid_set_rect_blocked(grid, 8, 3, 0, 8, 9, 0);
517
518 /* Print the grid */
519 printf("10x10 maze grid (. = open, # = wall):\n ");
520 for (int x = 0; x < 10; x++) printf("%d", x);
521 printf("\n");
522 for (int y = 0; y < 10; y++) {
523 printf("%d ", y);
524 for (int x = 0; x < 10; x++) {
525 printf("%c", n_astar_grid_get_walkable(grid, x, y, 0) ? '.' : '#');
526 }
527 printf("\n");
528 }
529
530 /* Test different heuristics */
531 const char* heur_names[] = {"Manhattan", "Euclidean", "Chebyshev"};
532 ASTAR_HEURISTIC heurs[] = {
536
537 printf("\nPaths from (0,0) to (9,9) with different heuristics:\n");
538 for (int h = 0; h < 3; h++) {
539 ASTAR_PATH* p = n_astar_find_path(grid, 0, 0, 0, 9, 9, 0,
540 ASTAR_ALLOW_DIAGONAL, heurs[h]);
541 if (p) {
542 printf(" %-10s: length=%2d cost=%5d ",
543 heur_names[h], p->length, p->cost);
544 for (int i = 0; i < p->length && i < 15; i++) {
545 if (i > 0) printf("->");
546 printf("(%d,%d)", p->nodes[i].x, p->nodes[i].y);
547 }
548 if (p->length > 15) printf("...");
549 printf("\n");
551 } else {
552 printf(" %-10s: no path\n", heur_names[h]);
553 }
554 }
555
556 /* Cardinal-only vs diagonal */
557 printf("\nCardinal-only vs diagonal movement:\n");
558 ASTAR_PATH* p_card = n_astar_find_path(grid, 0, 0, 0, 9, 9, 0,
561 ASTAR_PATH* p_diag = n_astar_find_path(grid, 0, 0, 0, 9, 9, 0,
564 if (p_card) printf(" Cardinal: length=%d cost=%d\n", p_card->length, p_card->cost);
565 if (p_diag) printf(" Diagonal: length=%d cost=%d\n", p_diag->length, p_diag->cost);
566 if (p_card) n_astar_path_free(p_card);
567 if (p_diag) n_astar_path_free(p_diag);
568
569 n_astar_grid_free(grid);
570}
571
572/* Main */
573int main(int argc, char* argv[]) {
574 (void)argc;
575 (void)argv;
576
578
579 printf("Nilorea Library: Isometric + A* + Dead Reckoning Demo\n");
580 printf("======================================================\n");
581
582 /* Create the isometric map */
584 if (!map) {
585 fprintf(stderr, "Failed to create map\n");
586 return EXIT_FAILURE;
587 }
588
589 /* Set projection */
591
592 /* Build the test map */
593 build_test_map(map);
594
595 /* Show ASCII map overview */
596 printf("\nMap overview (%dx%d, %d terrains, max height %d):\n",
598 print_map_ascii(map, NULL);
599
600 /* Demo 1: Isometric engine */
601 demo_iso_engine(map);
602
603 /* Demo 2: A* pathfinding on the map */
604 ASTAR_PATH* path = demo_astar(map);
605
606 /* Show map with path overlaid */
607 if (path) {
608 printf("\nMap with A* path overlaid:\n");
609 print_map_ascii(map, path);
610 }
611
612 /* Demo 3: Dead reckoning along the path */
613 demo_dead_reckoning(map, path);
614
615 /* Demo 4: A* standalone tests */
617
618 /* Cleanup */
619 if (path) n_astar_path_free(path);
620 iso_map_free(&map);
621
622 printf("\n=== All demos complete ===\n");
623 return EXIT_SUCCESS;
624}
int main(void)
#define MAP_H
#define MAP_W
#define MAX_HEIGHT
static const char * terrain_names[8]
#define NUM_TERRAINS
static ASTAR_PATH * demo_astar(const ISO_MAP *map)
static void demo_astar_standalone(void)
static void demo_iso_engine(ISO_MAP *map)
#define TILE_WIDTH
static void build_test_map(ISO_MAP *map)
static void print_map_ascii(const ISO_MAP *map, const ASTAR_PATH *path)
static void demo_dead_reckoning(const ISO_MAP *map, const ASTAR_PATH *path)
int x
grid X coordinate
Definition n_astar.h:116
int cost
total path cost (x1000 fixed-point)
Definition n_astar.h:125
ASTAR_NODE * nodes
array of path nodes from start to goal
Definition n_astar.h:123
int y
grid Y coordinate
Definition n_astar.h:117
int length
number of nodes in the path
Definition n_astar.h:124
ASTAR_PATH * n_astar_find_path(const ASTAR_GRID *grid, int sx, int sy, int sz, int gx, int gy, int gz, int diagonal, ASTAR_HEURISTIC heuristic)
Find a path using A* search.
Definition n_astar.c:485
void n_astar_grid_set_cost(ASTAR_GRID *grid, int x, int y, int z, int cost)
Set a cell's movement cost multiplier.
Definition n_astar.c:312
uint8_t n_astar_grid_get_walkable(const ASTAR_GRID *grid, int x, int y, int z)
Get a cell's walkability.
Definition n_astar.c:299
ASTAR_HEURISTIC
Heuristic function selection for h(n) estimation.
Definition n_astar.h:106
#define ASTAR_ALLOW_DIAGONAL
Movement mode: 8-dir (2D) or 26-dir (3D)
Definition n_astar.h:76
void n_astar_grid_free(ASTAR_GRID *grid)
Free a grid and all its internal data.
Definition n_astar.c:271
#define ASTAR_COST_CARDINAL
Default cost for straight movement (fixed-point x1000)
Definition n_astar.h:79
#define ASTAR_CARDINAL_ONLY
Movement mode: 4-dir (2D) or 6-dir (3D)
Definition n_astar.h:74
void n_astar_grid_set_rect_blocked(ASTAR_GRID *grid, int x1, int y1, int z1, int x2, int y2, int z2)
Set a rectangular region as blocked (wall)
Definition n_astar.c:340
void n_astar_path_free(ASTAR_PATH *path)
Free a path returned by n_astar_find_path.
Definition n_astar.c:759
void n_astar_grid_set_walkable(ASTAR_GRID *grid, int x, int y, int z, uint8_t walkable)
Set a cell's walkability.
Definition n_astar.c:286
ASTAR_GRID * n_astar_grid_new(int width, int height, int depth)
Create a new grid for A* pathfinding.
Definition n_astar.c:235
@ ASTAR_HEURISTIC_EUCLIDEAN
straight-line distance
Definition n_astar.h:108
@ ASTAR_HEURISTIC_CHEBYSHEV
max of axis deltas (optimal for 8-dir)
Definition n_astar.h:109
@ ASTAR_HEURISTIC_MANHATTAN
sum of axis deltas (optimal for 4-dir)
Definition n_astar.h:107
Grid structure holding walkability, costs, and dimensions.
Definition n_astar.h:153
The computed path result.
Definition n_astar.h:122
double x
X component.
double y
Y component.
int update_count
Number of state updates received.
void dr_entity_destroy(DR_ENTITY **entity_ptr)
Destroy a dead reckoning entity and set the pointer to NULL.
static DR_VEC3 dr_vec3(double x, double y, double z)
Create a DR_VEC3 from components.
void dr_entity_compute(DR_ENTITY *entity, double time, DR_VEC3 *out_pos)
Compute the dead reckoned display position at a given time.
DR_ENTITY * dr_entity_create(DR_ALGO algo, DR_BLEND blend_mode, double pos_threshold, double blend_time)
Create a new dead reckoning entity.
DR_BLEND
Dead reckoning convergence/blending mode.
bool dr_entity_check_threshold(const DR_ENTITY *entity, const DR_VEC3 *true_pos, const DR_VEC3 *true_vel, const DR_VEC3 *true_acc, double time)
Check whether the owner's true state has diverged from the dead reckoned prediction beyond the config...
static DR_VEC3 dr_vec3_zero(void)
Zero vector.
void dr_entity_receive_state(DR_ENTITY *entity, const DR_VEC3 *pos, const DR_VEC3 *vel, const DR_VEC3 *acc, double time)
Receive a new authoritative state update from the network.
void dr_entity_set_position(DR_ENTITY *entity, const DR_VEC3 *pos, const DR_VEC3 *vel, const DR_VEC3 *acc, double time)
Force-set entity position without triggering convergence blending.
@ DR_BLEND_CUBIC
Cubic Bezier spline convergence.
@ DR_BLEND_PVB
Projective Velocity Blending (recommended)
@ DR_BLEND_SNAP
Snap instantly to new state (no smoothing)
@ DR_ALGO_VEL_ACC
Velocity + acceleration: P(t) = P0 + V0*t + 0.5*A0*t^2.
Dead reckoned entity with extrapolation and convergence state.
3D vector used for position, velocity, and acceleration
int height
map height in tiles (Y axis)
float tile_lift
vertical pixel offset per height unit
float angle_deg
current projection angle in degrees
float half_w
half-width of a tile in pixels (horizontal extent)
float half_h
half-height of a tile in pixels (vertical extent)
int width
map width in tiles (X axis)
ISO_PROJECTION proj
current projection parameters
void iso_map_set_height(ISO_MAP *map, int mx, int my, int h)
Set the height at a cell (clamped to [0, max_height])
#define SWIM
FLAG of a swimmable tile.
ISO_MAP * iso_map_new(int width, int height, int num_terrains, int max_height)
Create a new height-aware isometric map.
int iso_map_save(const ISO_MAP *map, const char *filename)
Save ISO_MAP to a binary file.
#define WALK
FLAG of a walkable tile.
ISO_MAP * iso_map_load(const char *filename)
Load ISO_MAP from a binary file.
void iso_map_set_ability(ISO_MAP *map, int mx, int my, int ab)
Set the ability at a cell.
int iso_map_get_terrain(const ISO_MAP *map, int mx, int my)
Get the terrain type at a cell.
int iso_map_get_ability(const ISO_MAP *map, int mx, int my)
Get the ability at a cell.
void iso_map_to_screen(const ISO_MAP *map, int mx, int my, int h, float *screen_x, float *screen_y)
Convert map tile coordinates to screen pixel coordinates.
void iso_map_calc_transitions(const ISO_MAP *map, int mx, int my, int *edge_bits, int *corner_bits)
Compute terrain transition bitmasks for a cell (Article 934).
void iso_map_set_projection(ISO_MAP *map, int preset, float tile_width)
Set projection parameters from a preset and tile width.
void iso_map_free(ISO_MAP **map_ptr)
Free an ISO_MAP and set the pointer to NULL.
void iso_map_set_terrain(ISO_MAP *map, int mx, int my, int terrain)
Set the terrain type at a cell.
void iso_screen_to_map(const ISO_MAP *map, float screen_x, float screen_y, int *mx, int *my)
Convert screen pixel coordinates to map tile coordinates.
int iso_map_get_height(const ISO_MAP *map, int mx, int my)
Get the height at a cell.
float iso_map_interpolate_height(const ISO_MAP *map, float fx, float fy)
Bilinear height interpolation at fractional map coordinates.
#define ISO_PROJ_CLASSIC
Projection ID: classic 2:1 isometric (~26.565 degree angle)
#define BLCK
FLAG of a stopping tile.
void iso_map_corner_heights(const ISO_MAP *map, int mx, int my, float *h_n, float *h_e, float *h_s, float *h_w)
Compute average corner heights for smooth tile rendering (Article 2026).
Height-aware isometric map with terrain and height layers, per-cell height values,...
void set_log_level(const int log_level)
Set the global log level value ( static int LOG_LEVEL )
Definition n_log.c:121
#define LOG_NOTICE
normal but significant condition
Definition n_log.h:80
VECTOR3D speed
vx,vy,vz actual speed
Definition n_3d.h:76
VECTOR3D position
x,y,z actual position
Definition n_3d.h:74
double VECTOR3D[3]
struct of a point
Definition n_3d.h:59
structure of the physics of an object
Definition n_3d.h:70
int trajectory_get_position(TRAJECTORY *traj, double time_val, VECTOR3D out)
Compute position at a given time.
TRAJECTORY * trajectory_new(int nb_components)
Allocate and initialize a new TRAJECTORY.
int trajectory_add_point(TRAJECTORY *traj, const PHYSICS *state, double time_val)
Add a waypoint to the multi-point trajectory path.
void trajectory_delete(TRAJECTORY **traj)
Free a TRAJECTORY and set the pointer to NULL.
#define TRAJECTORY_2D
use 2 components (x,y) for trajectory computation
int trajectory_get_speed(TRAJECTORY *traj, double time_val, VECTOR3D out)
Compute velocity at a given time.
structure holding all data for trajectory interpolation / extrapolation
A* Pathfinding API for 2D and 3D grids.
Common headers and low-level functions & define.
Dead Reckoning API for latency hiding in networked games.
Isometric/axonometric tile engine with height maps, terrain transitions, and A* pathfinding integrati...
Generic log system.
Trajectory interpolation and dead reckoning for 2D/3D networked simulations.