/* Copyright (C) 1996-1997 Id Software, Inc. Copyright (C) 1997 Greg Lewis 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA See file, 'COPYING', for details. */ // writebsp.c #include #include #include #include #include #include #include using nlohmann::json; static contentflags_t RemapContentsForExport(const contentflags_t &content) { if (content.extended & CFLAGS_DETAIL_FENCE) { /* * A bit of a hack for Q2, to ensure that structural faces which are completely covered by CFLAGS_DETAIL_FENCE * still render. * * If we export the detail fence leaf as CONTENTS_SOLID, Q2 engines will refuse to render the covered sturctural * face because of a short-circuit in GL_DrawLeaf. */ if (options.target_game->id == GAME_QUAKE_II) { return { Q2_CONTENTS_WINDOW, 0 }; } /* * This is for func_detail_wall.. we want to write a solid leaf that has faces, * because it may be possible to see inside (fence textures). * * Normally solid leafs are not written and just referenced as leaf 0. */ return options.target_game->create_solid_contents(); } return content; } /** * Returns the output plane number */ size_t ExportMapPlane(size_t planenum) { qbsp_plane_t &plane = map.planes.at(planenum); if (plane.outputplanenum.has_value()) return plane.outputplanenum.value(); // already output. const size_t newIndex = map.bsp.dplanes.size(); dplane_t &dplane = map.bsp.dplanes.emplace_back(); dplane.normal[0] = plane.normal[0]; dplane.normal[1] = plane.normal[1]; dplane.normal[2] = plane.normal[2]; dplane.dist = plane.dist; dplane.type = plane.type; plane.outputplanenum = newIndex; return newIndex; } size_t ExportMapTexinfo(size_t texinfonum) { mtexinfo_t &src = map.mtexinfos.at(texinfonum); if (src.outputnum.has_value()) return src.outputnum.value(); // this will be the index of the exported texinfo in the BSP lump const size_t i = map.bsp.texinfo.size(); gtexinfo_t &dest = map.bsp.texinfo.emplace_back(); // make sure we don't write any non-native flags. // e.g. Quake only accepts 0 or TEX_SPECIAL. if (!src.flags.is_valid(options.target_game)) { FError("Internal error: Texinfo {} has invalid surface flags {}", texinfonum, src.flags.native); } dest.flags = src.flags; dest.miptex = src.miptex; dest.vecs = src.vecs; strcpy(dest.texture.data(), map.texinfoTextureName(texinfonum).c_str()); dest.value = map.miptex[src.miptex].value; src.outputnum = i; if (src.next != -1) { map.bsp.texinfo[i].nexttexinfo = ExportMapTexinfo(src.next); } return i; } //=========================================================================== /* ================== ExportClipNodes ================== */ static size_t ExportClipNodes(mapentity_t *entity, node_t *node) { if (node->planenum == PLANENUM_LEAF) { return node->contents.native; } /* emit a clipnode */ const size_t nodenum = map.bsp.dclipnodes.size(); map.bsp.dclipnodes.emplace_back(); const int child0 = ExportClipNodes(entity, node->children[0]); const int child1 = ExportClipNodes(entity, node->children[1]); // Careful not to modify the vector while using this clipnode pointer bsp2_dclipnode_t &clipnode = map.bsp.dclipnodes[nodenum]; clipnode.planenum = ExportMapPlane(node->planenum); clipnode.children[0] = child0; clipnode.children[1] = child1; return nodenum; } /* ================== ExportClipNodes Called after the clipping hull is completed. Generates a disk format representation. This gets real ugly. Gets called twice per entity, once for each clip hull. First time just store away data, second time fix up reference points to accomodate new data interleaved with old. ================== */ void ExportClipNodes(mapentity_t *entity, node_t *nodes, const int hullnum) { auto &model = map.bsp.dmodels.at(entity->outputmodelnumber.value()); model.headnode[hullnum] = ExportClipNodes(entity, nodes); } //=========================================================================== /* ================== ExportLeaf ================== */ static void ExportLeaf(mapentity_t *entity, node_t *node) { mleaf_t &dleaf = map.bsp.dleafs.emplace_back(); const contentflags_t remapped = RemapContentsForExport(node->contents); if (!remapped.is_valid(options.target_game, false)) { FError("Internal error: On leaf {}, tried to save invalid contents type {}", map.bsp.dleafs.size() - 1, remapped.to_string(options.target_game)); } dleaf.contents = remapped.native; /* * write bounding box info */ dleaf.mins = qv::floor(node->bounds.mins()); dleaf.maxs = qv::ceil(node->bounds.maxs()); dleaf.visofs = -1; // no vis info yet // write the marksurfaces dleaf.firstmarksurface = static_cast(map.bsp.dleaffaces.size()); for (auto &face : node->markfaces) { if (!options.includeSkip && map.mtexinfos.at(face->texinfo).flags.is_skip) continue; // FIXME: this can happen when compiling some Q2 maps // as Q1. if (!face->outputnumber.has_value()) continue; /* emit a marksurface */ map.bsp.dleaffaces.push_back(face->outputnumber.value()); /* grab tjunction split faces */ for (auto &fragment : face->fragments) { map.bsp.dleaffaces.push_back(fragment.outputnumber.value()); } } dleaf.nummarksurfaces = static_cast(map.bsp.dleaffaces.size()) - dleaf.firstmarksurface; dleaf.area = node->area; dleaf.cluster = node->viscluster; dleaf.firstleafbrush = node->firstleafbrush; dleaf.numleafbrushes = node->numleafbrushes; } /* ================== ExportDrawNodes ================== */ static void ExportDrawNodes(mapentity_t *entity, node_t *node) { const size_t ourNodeIndex = map.bsp.dnodes.size(); bsp2_dnode_t *dnode = &map.bsp.dnodes.emplace_back(); dnode->mins = qv::floor(node->bounds.mins()); dnode->maxs = qv::ceil(node->bounds.maxs()); dnode->planenum = ExportMapPlane(node->planenum); dnode->firstface = node->firstface; dnode->numfaces = node->numfaces; // recursively output the other nodes for (size_t i = 0; i < 2; i++) { if (node->children[i]->planenum == PLANENUM_LEAF) { // In Q2, all leaves must have their own ID even if they share solidity. if (options.target_game->id != GAME_QUAKE_II && node->children[i]->contents.is_solid(options.target_game)) { dnode->children[i] = PLANENUM_LEAF; } else { int32_t nextLeafIndex = static_cast(map.bsp.dleafs.size()); const int32_t childnum = -(nextLeafIndex + 1); dnode->children[i] = childnum; ExportLeaf(entity, node->children[i]); } } else { const int32_t childnum = static_cast(map.bsp.dnodes.size()); dnode->children[i] = childnum; ExportDrawNodes(entity, node->children[i]); // Important: our dnode pointer may be invalid after the recursive call, if the vector got resized. // So re-set the pointer. dnode = &map.bsp.dnodes[ourNodeIndex]; } } // DarkPlaces asserts that the leaf numbers are different // if mod_bsp_portalize is 1 (default) // The most likely way it could fail is if both sides are the // shared CONTENTS_SOLID leaf (-1) Q_assert(!(dnode->children[0] == -1 && dnode->children[1] == -1)); Q_assert(dnode->children[0] != dnode->children[1]); } /* ================== ExportDrawNodes ================== */ void ExportDrawNodes(mapentity_t *entity, node_t *headnode, int firstface) { // populate model struct (which was emitted previously) dmodelh2_t &dmodel = map.bsp.dmodels.at(entity->outputmodelnumber.value()); dmodel.headnode[0] = static_cast(map.bsp.dnodes.size()); dmodel.firstface = firstface; dmodel.numfaces = static_cast(map.bsp.dfaces.size()) - firstface; const size_t mapleafsAtStart = map.bsp.dleafs.size(); if (headnode->planenum == PLANENUM_LEAF) ExportLeaf(entity, headnode); else ExportDrawNodes(entity, headnode); // count how many leafs were exported by the above calls dmodel.visleafs = static_cast(map.bsp.dleafs.size() - mapleafsAtStart); /* remove the headnode padding */ for (size_t i = 0; i < 3; i++) { dmodel.mins[i] = headnode->bounds.mins()[i] + SIDESPACE + 1; dmodel.maxs[i] = headnode->bounds.maxs()[i] - SIDESPACE - 1; } } //============================================================================= /* ================== BeginBSPFile ================== */ void BeginBSPFile(void) { // First edge must remain unused because 0 can't be negated map.bsp.dedges.emplace_back(); Q_assert(map.bsp.dedges.size() == 1); // Leave room for leaf 0 (must be solid) auto &solid_leaf = map.bsp.dleafs.emplace_back(); solid_leaf.contents = options.target_game->create_solid_contents().native; Q_assert(map.bsp.dleafs.size() == 1); } /* * Writes extended texinfo flags to a file so they can be read by the light tool. * Used for phong shading and other lighting settings on func_detail. */ static void WriteExtendedTexinfoFlags(void) { auto file = std::filesystem::path(options.szBSPName).replace_extension("texinfo.json"); bool needwrite = false; if (std::filesystem::exists(file)) { std::filesystem::remove(file); } for (auto &texinfo : map.mtexinfos) { if (texinfo.flags.needs_write()) { // this texinfo uses some extended flags, write them to a file needwrite = true; break; } } if (!needwrite) return; // sort by output texinfo number std::vector texinfos_sorted(map.mtexinfos); std::sort(texinfos_sorted.begin(), texinfos_sorted.end(), [](const mtexinfo_t &a, const mtexinfo_t &b) { return a.outputnum < b.outputnum; }); json texinfofile = json::object(); for (const auto &tx : texinfos_sorted) { if (!tx.outputnum.has_value() || !tx.flags.needs_write()) continue; json t = json::object(); if (tx.flags.is_skip) { t["is_skip"] = tx.flags.is_skip; } if (tx.flags.is_hint) { t["is_hint"] = tx.flags.is_hint; } if (tx.flags.no_dirt) { t["no_dirt"] = tx.flags.no_dirt; } if (tx.flags.no_shadow) { t["no_shadow"] = tx.flags.no_shadow; } if (tx.flags.no_bounce) { t["no_bounce"] = tx.flags.no_bounce; } if (tx.flags.no_minlight) { t["no_minlight"] = tx.flags.no_minlight; } if (tx.flags.no_expand) { t["no_expand"] = tx.flags.no_expand; } if (tx.flags.light_ignore) { t["light_ignore"] = tx.flags.light_ignore; } if (tx.flags.phong_angle) { t["phong_angle"] = tx.flags.phong_angle; } if (tx.flags.phong_angle_concave) { t["phong_angle_concave"] = tx.flags.phong_angle_concave; } if (tx.flags.minlight) { t["minlight"] = tx.flags.minlight; } if (!qv::emptyExact(tx.flags.minlight_color)) { t["minlight_color"] = tx.flags.minlight_color; } if (tx.flags.light_alpha) { t["light_alpha"] = tx.flags.light_alpha; } texinfofile[std::to_string(*tx.outputnum)].swap(t); } std::ofstream(file, std::ios_base::out | std::ios_base::binary) << texinfofile; } /* ============= WriteBSPFile ============= */ static void WriteBSPFile() { bspdata_t bspdata{}; bspdata.bsp = std::move(map.bsp); bspdata.version = &bspver_generic; if (map.needslmshifts) { bspdata.bspx.copy("LMSHIFT", map.exported_lmshifts.data(), map.exported_lmshifts.size()); } if (!map.exported_bspxbrushes.empty()) { bspdata.bspx.copy("BRUSHLIST", map.exported_bspxbrushes.data(), map.exported_bspxbrushes.size()); } if (!ConvertBSPFormat(&bspdata, options.target_version)) { const bspversion_t *extendedLimitsFormat = options.target_version->extended_limits; if (!extendedLimitsFormat) { FError("No extended limits version of {} available", options.target_version->name); } LogPrint("NOTE: limits exceeded for {} - switching to {}\n", options.target_version->name, extendedLimitsFormat->name); Q_assert(ConvertBSPFormat(&bspdata, extendedLimitsFormat)); } options.szBSPName.replace_extension("bsp"); WriteBSPFile(options.szBSPName, &bspdata); LogPrint("Wrote {}\n", options.szBSPName); PrintBSPFileSizes(&bspdata); } /* ================== FinishBSPFile ================== */ void FinishBSPFile(void) { options.fVerbose = true; LogPrint(LOG_PROGRESS, "---- {} ----\n", __func__); if (map.bsp.dvertexes.empty()) { // First vertex must remain unused because edge references it map.bsp.dvertexes.emplace_back(); Q_assert(map.bsp.dvertexes.size() == 1); } WriteExtendedTexinfoFlags(); WriteBSPFile(); options.fVerbose = options.fAllverbose; } /* ================== UpdateBSPFileEntitiesLump ================== */ void UpdateBSPFileEntitiesLump() { bspdata_t bspdata; options.szBSPName.replace_extension("bsp"); // load the .bsp LoadBSPFile(options.szBSPName, &bspdata); bspdata.version->game->init_filesystem(options.szBSPName); ConvertBSPFormat(&bspdata, &bspver_generic); mbsp_t &bsp = std::get(bspdata.bsp); // replace the existing entities lump with map's exported entities bsp.dentdata = std::move(map.bsp.dentdata); // write the .bsp back to disk ConvertBSPFormat(&bspdata, bspdata.loadversion); WriteBSPFile(options.szBSPName, &bspdata); LogPrint("Wrote {}\n", options.szBSPName); }