ericw-tools/vis/vis.cc

805 lines
22 KiB
C++

// vis.c
#include <climits>
#include <cstdint>
#include <vis/leafbits.hh>
#include <vis/vis.hh>
#include <common/log.hh>
#include <common/bsputils.hh>
#include <common/fs.hh>
#include <common/parallel.hh>
#include <fmt/chrono.h>
/* Use some GCC builtins */
#if !defined(ffsl) && defined(__GNUC__)
#define ffsl __builtin_ffsl
#elif defined(_WIN32)
#include <intrin.h>
inline int ffsl(long int val)
{
unsigned long indexout;
unsigned char res = _BitScanForward(&indexout, val);
if (!res)
return 0;
else
return indexout + 1;
}
#endif
/*
* If the portal file is "PRT2" format, then the leafs we are dealing with are
* really clusters of leaves. So, after the vis job is done we need to expand
* the clusters to the real leaf numbers before writing back to the bsp file.
*/
int numportals;
int portalleafs; /* leafs (PRT1) or clusters (PRT2) */
int portalleafs_real; /* real no. of leafs after expanding PRT2 clusters. Not used for Q2. */
std::vector<visportal_t> portals; // always numportals * 2; front and back
std::vector<leaf_t> leafs;
int c_portaltest, c_portalpass, c_portalcheck, c_mightseeupdate;
int c_noclip = 0;
bool showgetleaf = true;
static std::vector<uint8_t> vismap;
uint32_t originalvismapsize;
std::vector<uint8_t> uncompressed;
int leafbytes; // (portalleafs+63)>>3
int leaflongs;
int leafbytes_real; // (portalleafs_real+63)>>3, not used for Q2.
namespace settings
{
setting_group vis_output_group{"Output", 200, expected_source::commandline};
setting_group vis_advanced_group{"Advanced", 300, expected_source::commandline};
void vis_settings::initialize(int argc, const char **argv)
{
try {
token_parser_t p(argc - 1, argv + 1, {"command line"});
auto remainder = parse(p);
if (remainder.size() <= 0 || remainder.size() > 1) {
print_help();
}
sourceMap = DefaultExtension(remainder[0], "bsp");
} catch (parse_exception &ex) {
logging::print(ex.what());
print_help();
}
}
} // namespace settings
settings::vis_settings vis_options;
fs::path portalfile, statefile, statetmpfile;
/*
==================
AllocStackWinding
Return a pointer to a free fixed winding on the stack
==================
*/
viswinding_t *AllocStackWinding(pstack_t &stack)
{
for (size_t i = 0; i < STACK_WINDINGS; i++) {
if (!stack.windings_used[i]) {
stack.windings[i].clear();
stack.windings_used[i] = true;
return &stack.windings[i];
}
}
FError("failed");
}
/*
==================
FreeStackWinding
As long as the winding passed in is local to the stack, free it. Otherwise,
do nothing (the winding either belongs to a portal or another stack
structure further up the call chain).
==================
*/
void FreeStackWinding(viswinding_t *&w, pstack_t &stack)
{
if (w >= stack.windings && w <= &stack.windings[STACK_WINDINGS]) {
stack.windings_used[w - stack.windings] = false;
w = nullptr;
}
}
/*
==================
ClipStackWinding
Clips the winding to the plane, returning the new winding on the positive
side. Frees the input winding (if on stack). If the resulting winding would
have too many points, the clip operation is aborted and the original winding
is returned.
==================
*/
viswinding_t *ClipStackWinding(viswinding_t *in, pstack_t &stack, const qplane3d &split)
{
vec_t *dists = (vec_t *)alloca(sizeof(vec_t) * (in->size() + 1));
int *sides = (int *)alloca(sizeof(int) * (in->size() + 1));
int counts[3];
int i, j;
/* Fast test first */
vec_t dot = split.distance_to(in->origin);
if (dot < -in->radius) {
FreeStackWinding(in, stack);
return nullptr;
} else if (dot > in->radius) {
return in;
}
if (in->size() > MAX_WINDING)
FError("in->numpoints > MAX_WINDING ({} > {})", in->size(), MAX_WINDING);
counts[0] = counts[1] = counts[2] = 0;
/* determine sides for each point */
for (i = 0; i < in->size(); i++) {
dot = split.distance_to((*in)[i]);
dists[i] = dot;
if (dot > VIS_ON_EPSILON)
sides[i] = SIDE_FRONT;
else if (dot < -VIS_ON_EPSILON)
sides[i] = SIDE_BACK;
else {
sides[i] = SIDE_ON;
}
counts[sides[i]]++;
}
sides[i] = sides[0];
dists[i] = dists[0];
// ericw -- coplanar portals: return without clipping. Otherwise when two portals are less than ON_EPSILON apart,
// one will get fully clipped away and we can't see through it causing
// https://github.com/ericwa/ericw-tools/issues/261
if (counts[SIDE_ON] == in->size()) {
return in;
}
if (!counts[0]) {
FreeStackWinding(in, stack);
return nullptr;
}
if (!counts[1])
return in;
auto neww = AllocStackWinding(stack);
neww->origin = in->origin;
neww->radius = in->radius;
for (i = 0; i < in->size(); i++) {
const qvec3d &p1 = (*in)[i];
if (sides[i] == SIDE_ON) {
if (neww->size() == MAX_WINDING_FIXED)
goto noclip;
neww->push_back(p1);
continue;
}
if (sides[i] == SIDE_FRONT) {
if (neww->size() == MAX_WINDING_FIXED)
goto noclip;
neww->push_back(p1);
}
if (sides[i + 1] == SIDE_ON || sides[i + 1] == sides[i])
continue;
/* generate a split point */
const qvec3d &p2 = (*in)[(i + 1) % in->size()];
qvec3d mid;
vec_t fraction = dists[i] / (dists[i] - dists[i + 1]);
for (j = 0; j < 3; j++) {
/* avoid round off error when possible */
if (split.normal[j] == 1)
mid[j] = split.dist;
else if (split.normal[j] == -1)
mid[j] = -split.dist;
else
mid[j] = p1[j] + fraction * (p2[j] - p1[j]);
}
if (neww->size() == MAX_WINDING_FIXED)
goto noclip;
neww->push_back(mid);
}
FreeStackWinding(in, stack);
return neww;
noclip:
FreeStackWinding(neww, stack);
c_noclip++;
return in;
}
//============================================================================
#include <mutex>
static std::mutex portal_mutex;
static std::atomic_int64_t portalIndex;
/*
=============
GetNextPortal
Returns the next portal for a thread to work on
Returns the portals from the least complex, so the later ones can reuse
the earlier information.
=============
*/
visportal_t *GetNextPortal(void)
{
visportal_t *ret = nullptr;
uint32_t min = INT_MAX;
portal_mutex.lock();
for (auto &p : portals) {
if (p.nummightsee < min && p.status == pstat_none) {
min = p.nummightsee;
ret = &p;
}
}
if (ret) {
ret->status = pstat_working;
}
portal_mutex.unlock();
return ret;
}
/*
=============
UpdateMightSee
Called after completing a portal and finding that the source leaf is no
longer visible from the dest leaf. Visibility is symetrical, so the reverse
must also be true. Update mightsee for any portals on the source leaf which
haven't yet started processing.
Called with the lock held.
=============
*/
static void UpdateMightsee(const leaf_t &source, const leaf_t &dest)
{
size_t leafnum = &dest - leafs.data();
for (size_t i = 0; i < source.numportals; i++) {
visportal_t *p = source.portals[i];
if (p->status != pstat_none) {
continue;
}
if (p->mightsee[leafnum]) {
p->mightsee[leafnum] = false;
p->nummightsee--;
c_mightseeupdate++;
}
}
}
/*
=============
PortalCompleted
Mark the portal completed and propogate new vis information across
to the complementry portals.
Called with the lock held.
=============
*/
static void PortalCompleted(visportal_t *completed)
{
int i, j, k, bit, numblocks;
int leafnum;
const visportal_t *p, *p2;
uint32_t changed;
portal_mutex.lock();
completed->status = pstat_done;
/*
* For each portal on the leaf, check the leafs we eliminated from
* mightsee during the full vis so far.
*/
const leaf_t &myleaf = leafs[completed->leaf];
for (i = 0; i < myleaf.numportals; i++) {
p = myleaf.portals[i];
if (p->status != pstat_done)
continue;
auto might = p->mightsee.data();
auto vis = p->visbits.data();
numblocks = (portalleafs + leafbits_t::mask) >> leafbits_t::shift;
for (j = 0; j < numblocks; j++) {
changed = might[j] & ~vis[j];
if (!changed)
continue;
/*
* If any of these changed bits are still visible from another
* portal, we can't update yet.
*/
for (k = 0; k < myleaf.numportals; k++) {
if (k == i)
continue;
p2 = myleaf.portals[k];
if (p2->status == pstat_done)
changed &= ~p2->visbits.data()[j];
else
changed &= ~p2->mightsee.data()[j];
if (!changed)
break;
}
/*
* Update mightsee for any of the changed bits that survived
*/
while (changed) {
bit = ffsl(changed) - 1;
changed &= ~nth_bit(bit);
leafnum = (j << leafbits_t::shift) + bit;
UpdateMightsee(leafs[leafnum], myleaf);
}
}
}
portal_mutex.unlock();
}
time_point starttime, endtime, statetime;
static duration stateinterval;
/*
==============
LeafThread
==============
*/
void LeafThread(size_t)
{
visportal_t *p;
portal_mutex.lock();
/* Save state if sufficient time has elapsed */
auto now = I_FloatTime();
if (now > statetime + stateinterval) {
statetime = now;
SaveVisState();
}
portal_mutex.unlock();
p = GetNextPortal();
if (!p)
return;
PortalFlow(p);
PortalCompleted(p);
logging::print(logging::flag::VERBOSE, "portal:{:4} mightsee:{:4} cansee:{:4}\n", (ptrdiff_t)(p - portals.data()),
p->nummightsee, p->numcansee);
}
/*
===============
LeafFlow
Builds the entire visibility list for a leaf
===============
*/
int64_t totalvis;
static std::vector<uint8_t> compressed;
static void ClusterFlow(int clusternum, leafbits_t &buffer, mbsp_t *bsp)
{
leaf_t *leaf;
uint8_t *outbuffer;
int i, j;
int numvis, numblocks;
const visportal_t *p;
/*
* Collect visible bits from all portals into buffer
*/
leaf = &leafs[clusternum];
numblocks = (portalleafs + leafbits_t::mask) >> leafbits_t::shift;
for (i = 0; i < leaf->numportals; i++) {
p = leaf->portals[i];
if (p->status != pstat_done)
FError("portal not done");
for (j = 0; j < numblocks; j++)
buffer.data()[j] |= p->visbits.data()[j];
}
// ericw -- this seems harmless and the fix for https://github.com/ericwa/ericw-tools/issues/261
// causes it to happen a lot.
// if (TestLeafBit(buffer, clusternum))
// logging::print("WARNING: Leaf portals saw into cluster ({})\n", clusternum);
buffer[clusternum] = true;
/*
* Now expand the clusters into the full leaf visibility map
*/
numvis = 0;
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
outbuffer = uncompressed.data() + clusternum * leafbytes;
for (i = 0; i < portalleafs; i++) {
if (buffer[i]) {
outbuffer[i >> 3] |= nth_bit(i & 7);
numvis++;
}
}
} else {
outbuffer = uncompressed.data() + clusternum * leafbytes_real;
for (i = 0; i < portalleafs_real; i++) {
if (buffer[bsp->dleafs[i + 1].cluster]) {
outbuffer[i >> 3] |= nth_bit(i & 7);
numvis++;
}
}
}
/*
* compress the bit string
*/
logging::print(logging::flag::VERBOSE, "cluster {:4} : {:4} visible\n", clusternum, numvis);
/*
* increment totalvis by
* (# of real leafs in this cluster) x (# of real leafs visible from this cluster)
*/
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
// FIXME: not sure what this is supposed to be?
totalvis += numvis;
} else {
for (i = 0; i < portalleafs_real; i++) {
if (bsp->dleafs[i + 1].cluster == clusternum) {
totalvis += numvis;
}
}
}
compressed.clear();
/* Allocate for worst case where RLE might grow the data (unlikely) */
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
CompressRow(outbuffer, (portalleafs + 7) >> 3, std::back_inserter(compressed));
} else {
CompressRow(outbuffer, (portalleafs_real + 7) >> 3, std::back_inserter(compressed));
}
/* leaf 0 is a common solid */
int32_t visofs = vismap.size();
bsp->dvis.set_bit_offset(VIS_PVS, clusternum, visofs);
// Set pointers
if (bsp->loadversion->game->id != GAME_QUAKE_II) {
for (i = 0; i < portalleafs_real; i++) {
if (bsp->dleafs[i + 1].cluster == clusternum) {
bsp->dleafs[i + 1].visofs = visofs;
}
}
}
std::copy(compressed.begin(), compressed.end(), std::back_inserter(vismap));
}
/*
==================
CalcPortalVis
==================
*/
void CalcPortalVis(const mbsp_t *bsp)
{
// fastvis just uses mightsee for a very loose bound
if (vis_options.fast.value()) {
for (auto &p : portals) {
p.visbits = p.mightsee;
p.status = pstat_done;
}
return;
}
/*
* Count the already completed portals in case we loaded previous state
*/
int32_t startcount = 0;
for (auto &p : portals) {
if (p.status == pstat_done) {
startcount++;
}
}
portalIndex = startcount;
logging::parallel_for(startcount, numportals * 2, LeafThread);
SaveVisState();
logging::print(logging::flag::VERBOSE, "portalcheck: {} portaltest: {} portalpass: {}\n", c_portalcheck,
c_portaltest, c_portalpass);
logging::print(logging::flag::VERBOSE, "c_vistest: {} c_mighttest: {} c_mightseeupdate {}\n", c_vistest,
c_mighttest, c_mightseeupdate);
}
/*
==================
CalcVis
==================
*/
void CalcVis(mbsp_t *bsp)
{
int i;
if (LoadVisState()) {
logging::print("Loaded previous state. Resuming progress...\n");
} else {
logging::print("Calculating Base Vis:\n");
BasePortalVis();
}
logging::print("Calculating Full Vis:\n");
CalcPortalVis(bsp);
//
// assemble the leaf vis lists by oring and compressing the portal lists
//
logging::print("Expanding clusters...\n");
leafbits_t buffer(portalleafs);
for (i = 0; i < portalleafs; i++) {
ClusterFlow(i, buffer, bsp);
buffer.clear();
}
int64_t avg = totalvis;
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
avg /= static_cast<int64_t>(portalleafs);
logging::print("average clusters visible: {}\n", avg);
} else {
avg /= static_cast<int64_t>(portalleafs_real);
logging::print("average leafs visible: {}\n", avg);
}
}
// ===========================================================================
#include <fstream>
#include <common/prtfile.hh>
/*
============
LoadPortals
============
*/
static void LoadPortals(const fs::path &name, mbsp_t *bsp)
{
const prtfile_t prtfile = LoadPrtFile(name, bsp->loadversion);
portalleafs = prtfile.portalleafs;
portalleafs_real = prtfile.portalleafs_real;
/* Allocate for worst case where RLE might grow the data (unlikely) */
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
compressed.reserve(max(1, (portalleafs * 2) / 8));
} else {
compressed.reserve(max(1, (portalleafs_real * 2) / 8));
}
numportals = prtfile.portals.size();
if (bsp->loadversion->game->id != GAME_QUAKE_II) {
// since q2bsp has native cluster support, we shouldn't look at portalleafs_real at all.
logging::print("{:6} leafs\n", portalleafs_real);
}
logging::print("{:6} clusters\n", portalleafs);
logging::print("{:6} portals\n", numportals);
leafbytes = ((portalleafs + 63) & ~63) >> 3;
leaflongs = leafbytes / sizeof(long);
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
// not used in Q2
leafbytes_real = 0;
} else {
leafbytes_real = ((portalleafs_real + 63) & ~63) >> 3;
}
// each file portal is split into two memory portals
portals.resize(numportals * 2);
leafs.resize(portalleafs);
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
originalvismapsize = portalleafs * ((portalleafs + 7) / 8);
} else {
originalvismapsize = portalleafs_real * ((portalleafs_real + 7) / 8);
}
bsp->dvis.resize(portalleafs);
vismap.reserve(originalvismapsize * 2);
auto dest_portal_it = portals.begin();
for (auto source_portal_it = prtfile.portals.begin(); source_portal_it != prtfile.portals.end();
source_portal_it++) {
const auto &sourceportal = *source_portal_it;
qplane3d plane;
{
auto &p = *dest_portal_it;
p.winding = viswinding_t{sourceportal.winding.begin(), sourceportal.winding.end()};
// calc plane
plane = p.winding.plane();
// create forward portal
auto &l = leafs[sourceportal.leafnums[0]];
if (l.numportals == MAX_PORTALS_ON_LEAF)
FError("Leaf with too many portals");
l.portals[l.numportals] = &p;
l.numportals++;
p.plane = -plane;
p.leaf = sourceportal.leafnums[1];
dest_portal_it++;
}
{
auto &p = *dest_portal_it;
// create backwards portal
auto &l = leafs[sourceportal.leafnums[1]];
if (l.numportals == MAX_PORTALS_ON_LEAF)
FError("Leaf with too many portals");
l.portals[l.numportals] = &p;
l.numportals++;
// Create a reverse winding
const auto flipped = sourceportal.winding.flip();
p.winding = viswinding_t{flipped.begin(), flipped.end()};
p.plane = plane;
p.leaf = sourceportal.leafnums[0];
dest_portal_it++;
}
}
// Q2 doesn't need this, it's PRT1 has the data we need
if (bsp->loadversion->game->id == GAME_QUAKE_II) {
return;
}
// Copy cluster mapping from .prt file
for (int i = 1; i < prtfile.dleafinfos.size(); ++i) {
bsp->dleafs[i].cluster = prtfile.dleafinfos[i].cluster;
}
}
void vis_reset()
{
// FIXME: clear other data
vis_options.reset();
}
int vis_main(int argc, const char **argv)
{
vis_reset();
bspdata_t bspdata;
const bspversion_t *loadversion;
vis_options.run(argc, argv);
vis_options.sourceMap.replace_extension("bsp");
logging::init(fs::path(vis_options.sourceMap)
.replace_filename(vis_options.sourceMap.stem().string() + "-vis")
.replace_extension("log"),
vis_options);
stateinterval = std::chrono::minutes(5); /* 5 minutes */
starttime = statetime = I_FloatTime();
LoadBSPFile(vis_options.sourceMap, &bspdata);
bspdata.version->game->init_filesystem(vis_options.sourceMap, vis_options);
loadversion = bspdata.version;
ConvertBSPFormat(&bspdata, &bspver_generic);
mbsp_t &bsp = std::get<mbsp_t>(bspdata.bsp);
if (vis_options.phsonly.value()) {
if (bsp.loadversion->game->id != GAME_QUAKE_II) {
FError("need a Q2-esque BSP for -phsonly");
}
portalleafs = bsp.dvis.bit_offsets.size();
leafbytes = ((portalleafs + 63) & ~63) >> 3;
leaflongs = leafbytes / sizeof(long);
if (bsp.loadversion->game->id == GAME_QUAKE_II) {
originalvismapsize = portalleafs * ((portalleafs + 7) / 8);
}
} else {
portalfile = fs::path(vis_options.sourceMap).replace_extension("prt");
LoadPortals(portalfile, &bsp);
statefile = fs::path(vis_options.sourceMap).replace_extension("vis");
statetmpfile = fs::path(vis_options.sourceMap).replace_extension("vi0");
if (bsp.loadversion->game->id != GAME_QUAKE_II) {
uncompressed.resize(portalleafs * leafbytes_real);
} else {
uncompressed.resize(portalleafs * leafbytes);
}
CalcVis(&bsp);
logging::print("c_noclip: {}\n", c_noclip);
logging::print("c_chains: {}\n", c_chains);
bsp.dvis.bits = std::move(vismap);
bsp.dvis.bits.shrink_to_fit();
logging::print("visdatasize:{} compressed from {}\n", bsp.dvis.bits.size(), originalvismapsize);
}
// no ambient sounds for Q2
if (bsp.loadversion->game->id != GAME_QUAKE_II) {
CalcAmbientSounds(&bsp);
} else {
CalcPHS(&bsp);
}
/* Convert data format back if necessary */
ConvertBSPFormat(&bspdata, loadversion);
WriteBSPFile(vis_options.sourceMap, &bspdata);
endtime = I_FloatTime();
logging::print("{:.2} elapsed\n", (endtime - starttime));
if (vis_options.autoclean.value()) {
CleanVisState();
}
logging::close();
return 0;
}
int vis_main(const std::vector<std::string> &args)
{
std::vector<const char *> argPtrs;
for (const std::string &arg : args) {
argPtrs.push_back(arg.data());
}
return vis_main(argPtrs.size(), argPtrs.data());
}