/
r_world.h
190 lines (162 loc) · 6.97 KB
/
r_world.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
/** @file r_world.h World Setup and Refresh.
*
* @authors Copyright © 2003-2013 Jaakko Keränen <jaakko.keranen@iki.fi>
* @authors Copyright © 2006-2013 Daniel Swanson <danij@dengine.net>
*
* @par License
* GPL: http://www.gnu.org/licenses/gpl.html
*
* <small>This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by the
* Free Software Foundation; either version 2 of the License, or (at your
* option) any later version. This program is distributed in the hope that it
* will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
* Public License for more details. You should have received a copy of the GNU
* General Public License along with this program; if not, see:
* http://www.gnu.org/licenses</small>
*/
#ifndef LIBDENG_MAP_WORLD_H
#define LIBDENG_MAP_WORLD_H
#include <de/Observers>
#include <de/Vector>
#include "resource/r_data.h"
#include "map/vertex.h"
#include "map/sector.h"
#include "map/sidedef.h"
#include "map/plane.h"
#include "map/sidedef.h"
/// @todo The MapChange audience belongs in a class.
DENG2_DECLARE_AUDIENCE(MapChange, void currentMapChanged())
DENG2_EXTERN_AUDIENCE(MapChange)
extern float rendSkyLight; // cvar
extern byte rendSkyLightAuto; // cvar
extern float rendLightWallAngle;
extern byte rendLightWallAngleSmooth;
extern boolean ddMapSetup;
extern boolean firstFrameAfterLoad;
// Sky flags.
#define SIF_DRAW_SPHERE 0x1 ///< Always draw the sky sphere.
/**
* Sector light color may be affected by the sky light color.
*/
de::Vector3f const &R_GetSectorLightColor(Sector const §or);
float R_DistAttenuateLightLevel(float distToViewer, float lightLevel);
/**
* The DOOM lighting model applies a light level delta to everything when
* e.g. the player shoots.
*
* @return Calculated delta.
*/
float R_ExtraLightDelta();
/**
* @return @c > 0 if @a lightlevel passes the min max limit condition.
*/
float R_CheckSectorLight(float lightlevel, float min, float max);
boolean R_SectorContainsSkySurfaces(Sector const *sec);
void R_ClearSectorFlags();
/**
* Returns pointers to the line's vertices in such a fashion that @c verts[0]
* is the leftmost vertex and @c verts[1] is the rightmost vertex, when the
* @a line lies at the edge of @a sector.
*/
void R_OrderVertices(LineDef *line, Sector const *sector, Vertex *verts[2]);
/**
* Determine the map space Z coordinates of a wall section.
*
* @param section Identifier of the section to determine coordinates for.
* @param lineFlags @ref ldefFlags.
* @param frontSec Sector in front of the wall.
* @param backSec Sector behind the wall. Can be @c NULL
* @param frontDef Definition for the front side. Can be @c NULL
* @param backDef Definition for the back side. Can be @c NULL
*
* Return values:
* @param low Z map space coordinate at the bottom of the wall section.
* @param hi Z map space coordinate at the top of the wall section.
* @param matOffset Surface space material coordinate offset. Can be @c NULL
*
* @return @c true iff the determined wall section height is @c >0
*/
boolean R_FindBottomTop(SideDefSection section, int lineFlags,
Sector const *frontSec, Sector const *backSec, SideDef const *frontDef, SideDef const *backDef,
coord_t *low, coord_t *hi, pvec2f_t matOffset = 0);
/**
* Find the "sharp" Z coordinate range of the opening between sectors @a frontSec
* and @a backSec. The open range is defined as the gap between foor and ceiling on
* the front side clipped by the floor and ceiling planes on the back side (if present).
*
* @param frontSec Sector on the front side.
* @param backSec Sector on the back side. Can be @c NULL.
* @param bottom Bottom Z height is written here. Can be @c NULL.
* @param top Top Z height is written here. Can be @c NULL.
*
* @return Height of the open range.
*/
coord_t R_OpenRange(Sector const *frontSec, Sector const *backSec, coord_t *retBottom, coord_t *retTop);
/// Same as @ref R_OpenRange() but works with the "visual" (i.e., smoothed) plane
/// height coordinates rather than the "sharp" coordinates.
coord_t R_VisOpenRange(Sector const *frontSec, Sector const *backSec, coord_t *retBottom, coord_t *retTop);
#ifdef __CLIENT__
/**
* @param lineFlags @ref ldefFlags.
* @param frontSec Sector in front of the wall.
* @param backSec Sector behind the wall. Can be @c NULL
* @param frontDef Definition for the front side. Can be @c NULL
* @param backDef Definition for the back side. Can be @c NULL
* @param ignoreOpacity @c true= material opacity should be ignored.
*
* @return @c true iff SideDef @a frontDef has a "middle" Material which completely
* covers the open range defined by sectors @a frontSec and @a backSec.
*/
boolean R_MiddleMaterialCoversOpening(int lineFlags, Sector const *frontSec,
Sector const *backSec, SideDef const *frontDef, SideDef const *backDef,
boolean ignoreOpacity = true);
/**
* Same as @ref R_MiddleMaterialCoversOpening except all arguments are derived from
* the specified linedef @a line.
*
* @note Anything calling this is likely working at the wrong level (should work with
* hedges instead).
*/
boolean R_MiddleMaterialCoversLineOpening(LineDef const *line, int side, boolean ignoreOpacity);
#endif // __CLIENT__
boolean R_UpdateSector(Sector *sec, boolean forceUpdate);
boolean R_UpdatePlane(Plane *pln, boolean forceUpdate);
/// @return Current glow strength for the plane.
float R_GlowStrength(Plane const *pln);
LineOwner *R_GetVtxLineOwner(Vertex const *vtx, LineDef const *line);
#ifdef __CLIENT__
/**
* A neighbour is a line that shares a vertex with 'line', and faces the
* specified sector.
*/
LineDef *R_FindLineNeighbor(Sector const *sector, LineDef const *line,
LineOwner const *own, boolean antiClockwise, binangle_t *diff);
LineDef *R_FindSolidLineNeighbor(Sector const *sector, LineDef const *line,
LineOwner const *own, boolean antiClockwise, binangle_t *diff);
/**
* A line's align neighbor is a line that shares a vertex with 'line' and
* whos orientation is aligned with it (thus, making it unnecessary to have
* a shadow between them. In practice, they would be considered a single,
* long sidedef by the shadow generator).
*/
LineDef *R_FindLineAlignNeighbor(Sector const *sec, LineDef const *line,
LineOwner const *own, boolean antiClockwise, int alignment);
/**
* Find a backneighbour for the given line. They are the neighbouring line
* in the backsector of the imediate line neighbor.
*/
LineDef *R_FindLineBackNeighbor(Sector const *sector, LineDef const *line,
LineOwner const *own, boolean antiClockwise, binangle_t *diff);
#endif // __CLIENT__
/**
* @defgroup skyCapFlags Sky Cap Flags
* @ingroup flags
*/
///@{
#define SKYCAP_LOWER 0x1
#define SKYCAP_UPPER 0x2
///@}
coord_t R_SkyCapZ(BspLeaf *bspLeaf, int skyCap);
#endif /* LIBDENG_MAP_WORLD_H */