cell.h

Go to the documentation of this file.

/*
** Jo Sega Saturn Engine
** Copyright (c) 2012-2026, Johannes Fetz (johannesfetz@gmail.com)
** All rights reserved.
**
** Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions are met:
**     * Redistributions of source code must retain the above copyright
**       notice, this list of conditions and the following disclaimer.
**     * Redistributions in binary form must reproduce the above copyright
**       notice, this list of conditions and the following disclaimer in the
**       documentation and/or other materials provided with the distribution.
**     * Neither the name of the Johannes Fetz nor the
**       names of its contributors may be used to endorse or promote products
**       derived from this software without specific prior written permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
** DISCLAIMED. IN NO EVENT SHALL Johannes Fetz BE LIABLE FOR ANY
** DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
 
#ifndef __JO_CELL_H__
# define __JO_CELL_H__
 
#if defined(JO_COMPILE_WITH_LEVEL_SUPPORT) && defined(JO_COMPILE_WITH_3D_SUPPORT)

# define JO_CELL_MAX                        (48)
# define JO_CELL_MAX_PORTALS                (96)
# define JO_CELL_MAX_DRAWN                  (12)

typedef struct
{
    jo_3d_mesh                      *mesh;          // Model of the cell (world coordinates), JO_NULL: none
    jo_3d_mesh                      *reflection;    // Simpler model drawn in its mirrors (a polished floor), JO_NULL: its model
    jo_pos3D_fixed                  center;         // Bounding sphere of the model
    int                             radius;
    int                             x0;             // Box where the player can walk (world units)
    int                             z0;
    int                             x1;
    int                             z1;
    int                             floor0;         // Floor (Saturn Y): see JO_LEVEL_CELL_SLOPE_xxx
    int                             floor1;
    unsigned short                  slope;
    unsigned short                  first_portal;
    unsigned short                  portal_count;
    short                           yaw;            // The box is turned around its center (degrees)
    jo_fixed                        cos;            // Of the yaw (0 and 1: not turned)
    jo_fixed                        sin;
}                                   jo_cell;

typedef struct
{
    jo_pos3D_fixed                  points[4];      // Corners (world space)
    unsigned short                  cell;           // Cell seen through it
    unsigned short                  kind;           // JO_LEVEL_PORTAL_xxx
}                                   jo_cell_portal;

int                                 jo_cells_load(jo_level * const level);

void                                jo_cells_free(void);

int                                 jo_cells_count(void);

bool                                jo_cells_have_exits(void);

const jo_cell                       *jo_cells_get(const int index);

int                                 jo_cells_outside_view(jo_3d_rect * const rect);

int                                 jo_cell_floor(const jo_cell * const cell, const int x, const int z);

int                                 jo_cells_find(const jo_fixed x, const jo_fixed y, const jo_fixed z, const int step);

bool                                jo_cells_floor(const jo_fixed x, const jo_fixed y, const jo_fixed z, const int step, int * const floor);

bool                                jo_cells_is_walkable(const jo_fixed x, const jo_fixed y, const jo_fixed z, const int radius, const int step);

int                                 jo_cells_draw(const jo_pos3D_fixed * const camera);

int                                 jo_cells_prepare(const jo_pos3D_fixed * const camera);

void                                jo_cells_draw_prepared(const bool slave);

void                                jo_cells_draw_prepared_part(const bool slave, const int part, const int handicap);

void                                jo_cells_draw_prepared_share(const bool slave, const int part, const int share);

bool                                jo_cells_draw_mirror(void (*draw_more)(void));

bool                                jo_cells_mirror_is_floor(void);

void                                jo_cells_set_window_distance(const int distance);

bool                                jo_cells_view_rect_at(const jo_pos3D_fixed * const position, jo_3d_rect * const rect);

bool                                jo_cells_seen_through(const int index, jo_3d_rect * const rect);

bool                                jo_cells_seen_through_window(const int index);

bool                                jo_cells_is_drawn(const int index);

int                                 jo_cells_close_portals(const jo_fixed x, const jo_fixed z, const int radius, const bool closed);

int                                 jo_cells_depth_bias_at(const jo_fixed x, const jo_fixed y, const jo_fixed z);

int                                 jo_cells_object_cell(const jo_fixed x, const jo_fixed y, const jo_fixed z);

int                                 jo_cells_depth_bias_of(const int cell);

unsigned short                      jo_cells_generation(void);

bool                                jo_cells_ray_hit(const jo_pos3D_fixed * const origin, const jo_pos3D_fixed * const dir, const jo_fixed max_t,
                                                     jo_fixed * const t, jo_pos3D_fixed * const normal);

int                                 jo_cells_add_point_light_meshes(const bool shadows);
 
#endif /* !JO_COMPILE_WITH_LEVEL_SUPPORT && JO_COMPILE_WITH_3D_SUPPORT */
 
#endif /* !__JO_CELL_H__ */
 
/*
** END OF FILE
*/