OpenUT99-Plus
Unreal Engine 1, rebuilt from scratch
Loading...
Searching...
No Matches
level.h
Go to the documentation of this file.
1// Level geometry: Model (BSP) and Level. Spec: docs/formats/level.md; reference: tools/umodel.py
2#pragma once
3#include <cstdint>
4#include <string>
5#include <vector>
6
7#include "upkg.h"
8
9namespace ut {
10
11struct Node {
12 float plane[4];
13 uint64_t zone_mask;
14 uint8_t flags;
16 uint8_t zone[2], num_vertices;
17 int32_t leaf[2];
18};
19
20struct Surf {
21 int32_t texture; // object ref
22 uint32_t flags; // poly flags
23 int32_t base, normal, texture_u, texture_v, light_map, brush_poly; // base: points; others: vectors; light_map -1 = none
24 int16_t pan_u, pan_v;
25 int32_t actor;
26};
27
28struct Vert { int32_t point, side; };
29
30struct LightMap {
31 int32_t data_offset;
33 int32_t uclamp, vclamp;
34 float uscale, vscale;
35 int32_t light_actors; // first index into Model::lights; list ends at a 0 entry
36};
37
38struct Model {
39 std::vector<Vec3> vectors, points;
40 std::vector<Node> nodes;
41 std::vector<Surf> surfs;
42 std::vector<Vert> verts;
43 std::vector<LightMap> lightmaps;
44 std::vector<uint8_t> light_bits;
45 std::vector<int32_t> lights;
46 // Leaf hulls: at a node's collision_bound, the convex solid behind it as node refs (bit 0x40000000: plane
47 // flipped) up to -1, then its bounding box as 6 f32 (min, max). See level.md (collision hulls).
48 std::vector<int32_t> leaf_hulls;
49 std::vector<int32_t> zone_actors; // object refs, index = zone number
50 int32_t polys = 0;
51};
52
53struct ReachSpec { // a path between two navigation points (built by the editor)
54 int32_t distance, start, end; // start, end: object refs
56 uint8_t pruned;
57};
58
59struct Level {
60 std::vector<int32_t> actors; // object refs, 0 = deleted slot
61 int32_t model = 0;
62 std::vector<ReachSpec> reach_specs;
63};
64
65// Poly flag bits (public UE1 names, unverified).
66enum : uint32_t {
68 PF_TwoSided = 0x100, PF_Unlit = 0x400000, PF_Portal = 0x4000000,
69};
70
71Model read_model(const Package& p, const Export& e); // validated with validate_model; throws on bad data
72// Throws std::runtime_error unless every index the engine follows is in range (package data is untrusted).
73void validate_model(const Model& m);
74Level read_level(const Package& p, const Export& e);
75size_t model_end(const Package& p, const Export& e); // offset after the Model data (for cross-checks)
76
77struct Vertex { float x, y, z, u, v, lu = 0, lv = 0; }; // lu, lv: lightmap atlas coordinates
78
79// Triangle fan of a BSP node's polygon; UVs in texture units (texel coordinate / texture size).
80std::vector<Vertex> node_triangles(const Model& m, const Node& n, int usize, int vsize);
81
82} // namespace ut
Definition collision.cpp:7
void validate_model(const Model &m)
Definition level.cpp:101
size_t model_end(const Package &p, const Export &e)
Definition level.cpp:133
Level read_level(const Package &p, const Export &e)
Definition level.cpp:142
Model read_model(const Package &p, const Export &e)
Definition level.cpp:88
@ PF_TwoSided
Definition level.h:68
@ PF_Unlit
Definition level.h:68
@ PF_Portal
Definition level.h:68
@ PF_Masked
Definition level.h:67
@ PF_FakeBackdrop
Definition level.h:67
@ PF_Invisible
Definition level.h:67
@ PF_Modulated
Definition level.h:67
@ PF_Translucent
Definition level.h:67
std::vector< Vertex > node_triangles(const Model &m, const Node &n, int usize, int vsize)
Definition level.cpp:168
Definition level.h:59
std::vector< int32_t > actors
Definition level.h:60
std::vector< ReachSpec > reach_specs
Definition level.h:62
int32_t model
Definition level.h:61
Definition level.h:30
float uscale
Definition level.h:34
Vec3 pan
Definition level.h:32
int32_t light_actors
Definition level.h:35
int32_t uclamp
Definition level.h:33
float vscale
Definition level.h:34
int32_t data_offset
Definition level.h:31
int32_t vclamp
Definition level.h:33
Definition level.h:38
std::vector< uint8_t > light_bits
Definition level.h:44
std::vector< int32_t > zone_actors
Definition level.h:49
std::vector< LightMap > lightmaps
Definition level.h:43
std::vector< int32_t > lights
Definition level.h:45
std::vector< Vert > verts
Definition level.h:42
std::vector< int32_t > leaf_hulls
Definition level.h:48
std::vector< Vec3 > points
Definition level.h:39
std::vector< Vec3 > vectors
Definition level.h:39
int32_t polys
Definition level.h:50
std::vector< Surf > surfs
Definition level.h:41
std::vector< Node > nodes
Definition level.h:40
Definition level.h:11
uint64_t zone_mask
Definition level.h:13
int32_t collision_bound
Definition level.h:15
int32_t render_bound
Definition level.h:15
uint8_t flags
Definition level.h:14
float plane[4]
Definition level.h:12
int32_t surf
Definition level.h:15
int32_t back
Definition level.h:15
int32_t plane_index
Definition level.h:15
uint8_t num_vertices
Definition level.h:16
int32_t front
Definition level.h:15
uint8_t zone[2]
Definition level.h:16
int32_t leaf[2]
Definition level.h:17
int32_t vert_pool
Definition level.h:15
Definition level.h:53
int32_t collision_radius
Definition level.h:55
int32_t distance
Definition level.h:54
uint8_t pruned
Definition level.h:56
int32_t end
Definition level.h:54
int32_t start
Definition level.h:54
int32_t reach_flags
Definition level.h:55
int32_t collision_height
Definition level.h:55
Definition level.h:20
int16_t pan_v
Definition level.h:24
int32_t texture_v
Definition level.h:23
int32_t base
Definition level.h:23
int32_t brush_poly
Definition level.h:23
int32_t actor
Definition level.h:25
int32_t texture_u
Definition level.h:23
int32_t normal
Definition level.h:23
int32_t light_map
Definition level.h:23
int32_t texture
Definition level.h:21
uint32_t flags
Definition level.h:22
int16_t pan_u
Definition level.h:24
Definition upkg.h:66
Definition level.h:28
int32_t side
Definition level.h:28
int32_t point
Definition level.h:28
Definition level.h:77
float lv
Definition level.h:77
float u
Definition level.h:77
float y
Definition level.h:77
float x
Definition level.h:77
float v
Definition level.h:77
float z
Definition level.h:77
float lu
Definition level.h:77