diff --git a/docs/Complete_list_of_command_line_parameters.htm b/docs/Complete_list_of_command_line_parameters.htm
index 572239ea..0a48f470 100644
--- a/docs/Complete_list_of_command_line_parameters.htm
+++ b/docs/Complete_list_of_command_line_parameters.htm
@@ -102,16 +102,18 @@ td.formatted_questions ol { margin-top: 0px; margin-bottom: 0px; }
Common options¶
-
-
- -connect address: Talk to a NetRadiant instance using a specific XML based protocol-force: Allow reading some broken/unsupported BSP files e.g. when decompiling, may also crash-connect address: Talk to a NetRadiant instance using a specific XML based protocol-force: Allow reading some broken/unsupported BSP files e.g. when decompiling, may crash. Also enables decompilation of model autoclip brushes.-fs_basepath path: Sets the given path as main directory of the game (can be used more than once to look in multiple paths)-fs_forbiddenpath pattern: Pattern to ignore directories, pk3, and pk3dir; example pak?.pk3 (can be used more than once to look for multiple patterns)-fs_game gamename: Sets extra game directory name to additionally load mod's resources from at higher priority (by default for Q3A 'baseq3' is loaded, -fs_game cpma will also load 'cpma'; can be used more than once)-fs_basegame gamename: Overrides default game directory name (e.g. Q3A uses 'baseq3', OpenArena 'baseoa', so -game quake3 -fs_basegame baseoa for OA )-fs_homebase dir: Specifies where the user home directory name is on Linux (default for Q3A: .q3a)-game gamename: Load settings for the given game (default: quake3)-fs_home dir: Specifies where the user home directory is on Linux-fs_homebase dir: Specifies game home directory relative to user home directory on Linux (default for Q3A: .q3a)-fs_homepath path: Sets the given path as the game home directory name (fs_home + fs_homebase)-fs_pakpath path: Specify a package directory (can be used more than once to look in multiple paths)-game gamename: Load settings for the given game (default: quake3), -help -game lists available games-subdivisions F: multiplier for patch subdivisions quality-threads N: number of threads to use-v: Verbose modeBSP stage¶
-
-
- -bsp ... filename.map: Switch that enters this stage-bsp ... filename.map: Switch that enters this stage-altsplit: Alternate BSP tree splitting weights (should give more fps)-celshader shadername: Sets a global cel shader name-clipdepth F: Model autoclip brushes thickness, default = 2-custinfoparms: Read scripts/custinfoparms.txt-debugclip: Make model autoclip brushes visible, using shaders debugclip, debugclip2-debuginset: Push all triangle vertexes towards the triangle center-debugportals: Make BSP portals visible in the map-debugsurfaces: Color the vertexes according to the index of the surface-deep: Use detail brushes in the BSP tree, but at lowest priority (should give more fps)-de F: Distance epsilon for plane snapping etc.-fakemap: Write fakemap.map containing all world brushes-flares: Turn on support for flares (TEST?)-flares: Turn on support for flares-flat: Enable flat shading (good for combining with -celshader)-fulldetail: Treat detail brushes as structural ones-keeplights: Keep light entities in the BSP file after compile-leaktest: Abort if a leak was found-maxarea: Use Max Area face surface generation-meta: Combine adjacent triangles of the same texture to surfaces (ALWAYS USE THIS)-metaadequatescore N: Adequate score for adding triangles to meta surfaces-metagoodscore N: Good score for adding triangles to meta surfaces-minsamplesize N: Sets minimum lightmap resolution in luxels/qu-mi N: Sets the maximum number of indexes per surface-mv N: Sets the maximum number of vertices of a lightmapped surface-noflares: Turn off support for flares-nofog: Turn off support for fog volumes-nohint: Turn off support for hint brushes-noob: Assign surfaceparm noob to all map surfaces (Q3A:Defrag mod no-overbounces flag)-nosRGB: Treat colors and textures as linear colorspace-nosRGBcolor: Treat shader and light entity colors as linear colorspace-nosRGBtex: Treat textures as linear colorspace-nosubdivide: Turn off support for q3map_tessSize (breaks water vertex deforms)-notjunc: Do not fix T-junctions (causes cracks between triangles, do not use)-nowater: Turn off support for water, slime or lava (Stef, this is for you)-samplesize N: Sets default lightmap resolution in luxels/qu-skyfix: Turn sky box into six surfaces to work around ATI problems-snap N: Snap brush bevel planes to the given number of units-sRGBcolor: Treat shader and light entity colors as sRGB colorspace-sRGBtex: Treat textures as sRGB colorspace-tempname filename.map: Read the MAP file from the given file name-verboseentities: Enable -v only for map entities, not for the world
VIS stage¶
-
-
- -vis ... filename.map: Switch that enters this stage-vis ... filename.map: Switch that enters this stage-fast: Very fast and crude vis calculation-hint: Merge all but hint portals-mergeportals: The less crude half of -merge, makes vis sometimes much faster but doesn't hurt fps usually-merge: Faster but still okay vis calculation-nopassage: Just use PortalFlow vis (usually less fps)-nosort: Do not sort the portals before calculating vis (usually slower)-passageOnly: Just use PassageFlow vis (usually less fps)-saveprt: Keep the PRT file after running vis (so you can run vis again)-v -v: Extra verbose mode for cluster debug
LIGHT stage¶
-
-
- -light ... filename.map: Switch that enters this stage-light ... filename.map: Switch that enters this stage-approx N: Vertex light approximation tolerance (never use in conjunction with deluxemapping)-areascale F, -area F: Scaling factor for area lights (surfacelight)-backsplash Fscale Fdistance: scale area lights backsplash fraction + set distance globally; (distance < -900 to omit distance setting); default = 1 23; real area lights have no backsplash (scale = 0); q3map_backsplash shader keyword overrides this setting-border: Add a red border to lightmaps for debugging-bouncecolorratio F: 0..1 ratio of colorizing light sample by texture-bouncegrid: Also compute radiosity on the light grid-bounceonly: Only compute radiosity-bouncescale F: Scaling factor for radiosity-bounce N: Number of bounces for radiosity-brightness F: Scaling factor for resulting lightmaps brightness-cheapgrid: Use -cheap style lighting for radiosity-cheap: Abort vertex light calculations when white is reached-compensate F: Lightmap compensate (darkening factor applied after everything else)-contrast F: -255 .. 255 lighting contrast, default = 0-cpma: CPMA vertex lighting mode-custinfoparms: Read scripts/custinfoparms.txt-dark: Darken lightmap seams-debugdeluxe: Show deluxemaps on the lightmap-debugnormals: Color the lightmaps according to the direction of the surface normal-debugorigin: Color the lightmaps according to the origin of the luxels-debugsamplesize: display all of 'surface too large for desired samplesize+lightmapsize' warnings-debugsurfaces, -debugsurface: Color the lightmaps according to the index of the surface-debug: Mark the lightmaps according to the cluster: unmapped clusters get yellow, occluded ones get pink, flooded ones get blue overlay color, otherwise red-deluxemode 0: Use modelspace deluxemaps (DarkPlaces)-export: Export lightmaps when compile finished (like -export mode)-exposure F: Lightmap exposure to better support overbright spots-external: Force external lightmaps even if at size of internal lightmaps-extlmhacksize N or N N: External lightmaps hack size: similar to -lightmapsize N: Size of lightmaps to generate (must be a power of two), but instead of native external lightmaps enables hack to reference them in autogenerated shader (for vanilla Q3 etc)-extradist F: Extra distance for lights in map units-extravisnudge: Broken feature to nudge the luxel origin to a better vis cluster-extrawide: Deprecated alias for -super 2 -filter-extra: Deprecated alias for -super 2-faster: Use a faster falloff curve for lighting; also implies -fast-fastgrid: Use -fast style lighting for the light grid-fast: Ignore tiny light contributions-fill: Fill lightmap colors from surrounding pixels to improve JPEG compression-fillpink: Fill unoccupied lightmap pixels with pink colour-filter: Lightmap filtering-floodlight: Enable floodlight (zero-effort somewhat decent lighting)-gamma F: Lightmap gamma-gridambientdirectionality F: Ambient directional lighting received (default: 0.0)-gridambientscale F: Scaling factor for the light grid ambient components only-griddirectionality F: Directional lighting received (default: 1.0)-gridscale F: Scaling factor for the light grid only-keeplights: Keep light entities in the BSP file after compile-lightanglehl 0: Disable half lambert light angle attenuation-lightanglehl 1: Enable half lambert light angle attenuation-lightmapdir directory: Directory to store external lightmaps (default: same as map name without extension)-lightmapsize N: Size of lightmaps to generate (must be a power of two)-lomem: Low memory but slower lighting mode-minsamplesize N: Sets minimum lightmap resolution in luxels/qu-nocollapse: Do not collapse identical lightmaps-nodeluxe, -nodeluxemap: Disable deluxemapping-nofastpoint: Disable fast point light calculation-nogrid: Disable grid light calculation (makes all entities fullbright)-nolightmapsearch: Do not optimize lightmap packing for GPU memory usage (as doing so costs fps)-nolm: Skip lightmaps calculation-normalmap: Color the lightmaps according to the direction of the surface normal (TODO is this identical to -debugnormals?)-nosRGB: Treat colors, textures, and lightmaps as linear colorspace-nosRGBcolor: Treat shader and light entity colors as linear colorspace-nosRGBlight: Write lightmaps as linear colorspace-nosRGBtex: Treat textures as linear colorspace-nostyle, -nostyles: Disable support for light styles-nosurf: Disable tracing against surfaces (only uses BSP nodes then)-notrace: Disable shadow occlusion-novertex: Disable vertex lighting-novertex: Disable vertex lighting; optional (0..1) value sets constant vertex light globally-patchshadows: Cast shadows from patches-pointscale F, -point F: Scaling factor for point lights (light entities)-pointscale F, -point F: Scaling factor for spherical and spot point lights (light entities)-q3: Use nonlinear falloff curve by default (like Q3A)-randomsamples: Use random sampling for lightmaps-rawlightmapsizelimit N: Sets maximum lightmap resolution in luxels/qu (only affects patches if used -patchmeta in BSP stage)-samplescale F: Scales all lightmap resolutions-samplesize N: Sets default lightmap resolution in luxels/qu-samplessearchboxsize N: Search box size (1 to 4) for lightmap adaptive supersampling-samples N: Adaptive supersampling quality-saturation F: Lighting saturation: default = 1, > 1 = saturate, 0 = grayscale, < 0 = complementary colors-scale F: Scaling factor for all light types-shadeangle A: Angle for phong shading-shade: Enable phong shading at default shade angle-skyscale F, -sky F: Scaling factor for sky and sun light-slowallocate: Use old (a bit more careful, but much slower) lightmaps packing algorithm-smooth: Deprecated alias for -samples 2-sphericalscale F, -spherical F: Scaling factor for spherical point light entities-spotscale F, -spot F: Scaling factor for spot point light entities-sRGB: Treat colors, textures, and lightmaps as sRGB colorspace-sRGBcolor: Treat shader and light entity colors as sRGB colorspace-sRGBlight: Write lightmaps as sRGB colorspace-sRGBtex: Treat textures as sRGB colorspace-style, -styles: Enable support for light styles-sunonly: Only compute sun light-super N, -supersample N: Ordered grid supersampling quality-thresh F: Triangle subdivision threshold-trianglecheck: Broken check that should ensure luxels apply to the right triangle-trisoup: Convert brush faces to triangle soup-vertexscale F: Scaling factor for resulting vertex light values-wolf: Use linear falloff curve by default (like W:ET)
Analyzing BSP-like file structure¶
-
-
- -analyze ... filename.bsp: Switch that enters this mode-analyze ... filename.bsp: Switch that enters this mode-lumpswap: Swap byte order in the lumps
Converting & Decompiling¶
-
-
- -convert ... filename.bsp: Switch that enters this mode-de number: Distance epsilon for the conversion-format converter: Select the converter (available: map, ase, or game names)-ne F: Normal epsilon for the conversion-shadersasbitmap: (only for ase) use the shader names as *BITMAP key so they work as prefabs-convert ... filename.bsp: Switch that enters this mode-deluxemapsastexcoord: Save deluxemap names and texcoords instead of textures (only when writing ase and obj)-de F: Distance epsilon for the conversion (only when reading map)-fast: fast bsp to map conversion mode (without texture alignments)-format converter: Select the converter, default ase (available: map, map_bp, ase, obj, or game names)-lightmapsastexcoord: Save lightmap names and texcoords instead of textures (only when writing ase and obj)-meta: Combine adjacent triangles of the same texture to surfaces (only when reading map)-ne F: Normal epsilon for the conversion (only when reading map)-patchmeta: Turn patches into triangle meshes for display (only when reading map)-readbsp: Force converting bsp to selected format-readmap: Force converting map to selected format-shadersasbitmap: Save shader names as bitmap names in the model so it works as a prefab (only when writing ase and obj)
Exporting lightmaps¶
-
-
- -export filename.bsp: Copies lightmaps from the BSP to filename/lightmap_0000.tga ff
-
-
- Fixing AAS checksum¶
-
-
-
- -fixaas filename.bsp: Switch that enters this mode
-
-
- Get info about BSP file¶
-
-
-
- -info filename.bsp: Switch that enters this mode-export filename.bsp: Copies lightmaps from the BSP to filename/lightmap_0000.tga ff
Importing lightmaps¶
-
-
- -import filename.bsp: Copies lightmaps from filename/lightmap_0000.tga ff into the BSP-import filename.bsp: Copies lightmaps from filename/lightmap_0000.tga ff into the BSP
+
+
+ Exporting entities¶
+
+ -exportents filename.bsp: Exports the entities to a text file (.ent)
+
+
+ Fixing AAS checksum¶
+
+ -fixaas filename.bsp: Writes BSP checksum to AAS file, so that it's accepted as valid by engine
+
+
+ Get info about BSP file¶
+
+ -info filename.bsp .. filenameN.bsp: Switch that enters this mode
MiniMap¶
-
-
- -minimap ... filename.bsp: Creates a minimap of the BSP, by default writes to ../gfx/filename_mini.tga-minimap ... filename.bsp: Creates a minimap of the BSP, by default writes to ../gfx/filename_mini.tga-autolevel: Automatically level brightness and contrast-black: Write the minimap as a black-on-transparency RGBA32 image-boost F: Sets the contrast boost value (higher values make a brighter image); contrast boost is somewhat similar to gamma, but continuous even at zero-border F: Sets the amount of border pixels relative to the total image size-brightness F: Sets brightness value to add to minimap values-contrast F: Sets contrast value to scale minimap values (doesn't affect brightness)-gray: Write the minimap as a white-on-black GRAY8 image-keepaspect: Ensure the aspect ratio is kept (the minimap is then letterboxed to keep aspect)-minmax xmin ymin zmin xmax ymax zmax: Forces specific map dimensions (note: the minimap actually uses these dimensions, scaled to the target size while keeping aspect with centering, and 1/64 of border appended to all sides)-noautolevel: Do not automatically level brightness and contrast-nokeepaspect: Do not ensure the aspect ratio is kept (makes it easier to use the image in your code, but looks bad together with sharpening)-o filename.tga: Sets the output file name-random N: Sets the randomized supersampling count (cannot be combined with -samples)
- Scaling¶
-
-
+ BSP Scaling¶
- -scale S filename.bsp: Scale uniformly-scale SX SY SZ filename.bsp: Scale non-uniformly-scale -tex S filename.bsp: Scale uniformly without texture lock-scale -tex SX SY SZ filename.bsp: Scale non-uniformly without texture lock-scale [options] S filename.bsp: Scale uniformly-scale [options] SX SY SZ filename.bsp: Scale non-uniformly-tex: Option to scale without texture lock-spawn_ref F: Option to vertically offset info_player_* entities (adds spawn_ref, scales, subtracts spawn_ref)
+
+
+ BSP Shift¶
+
+ -shift S filename.bsp: Shift uniformly-shift SX SY SZ filename.bsp: Shift non-uniformly
+
+
+ PK3 creation¶
+
+ -pk3 ... filename.bsp: Creates a pk3 for the BSP (complete Q3 support). Using file 'gamename.exclude' to exclude vanilla game resources.-complevel N: Set compression level (-1 .. 10); 0 = uncompressed, -1 = 6, 10 = ultra zlib incompatible preset-dbg: Print wall of debug text, useful for .exclude file creation-png: include png textures, at highest priority; taking tga, jpg by default
+
+
+ Maps repack creation¶
+
+ -repack ... filename.bsp or filenames.txt: Creates repack of BSP(s) (complete Q3 support). Rips off only used shaders to new shader file. Using file 'gamename.exclude' to exclude vanilla game resources and 'repack.exclude' to exclude resources of existing repack.-analyze: Only print bsp resource references and exit-complevel N: Set compression level (-1 .. 10); 0 = uncompressed, -1 = 6, 10 = ultra zlib incompatible preset-dbg: Print wall of debug text-png: include png textures, at highest priority; taking tga, jpg by default
+
+
+ BSP json export/import¶
+
+ -json ... filename.bsp: Export/import BSP to/from json text files for debugging and editing purposes-unpack: Unpack BSP to json-pack: Pack json to BSP
diff --git a/tools/quake3/q3map2/help.cpp b/tools/quake3/q3map2/help.cpp
index ae3a1079..74bc3598 100644
--- a/tools/quake3/q3map2/help.cpp
+++ b/tools/quake3/q3map2/help.cpp
@@ -39,7 +39,7 @@ struct HelpOption
const char* description;
};
-void HelpOptions(const char* group_name, int indentation, int width, struct HelpOption* options, int count)
+void HelpOptions(const char* group_name, int indentation, int width, const std::vector& options)
{
indentation *= 2;
char* indent = safe_malloc(indentation+1);
@@ -51,30 +51,29 @@ void HelpOptions(const char* group_name, int indentation, int width, struct Help
memset(indent, ' ', indentation);
indent[indentation] = 0;
- int i;
- for ( i = 0; i < count; i++ )
+ for ( auto&& option : options )
{
- int printed = printf("%s%-24s ", indent, options[i].name);
- int descsz = strlen(options[i].description);
+ int printed = printf("%s%-24s ", indent, option.name);
+ int descsz = strlen(option.description);
int j = 0;
while ( j < descsz && descsz-j > width - printed )
{
if ( j != 0 )
printf("%s%26c",indent,' ');
int fragment = width - printed;
- while ( fragment > 0 && options[i].description[j+fragment-1] != ' ')
+ while ( fragment > 0 && option.description[j+fragment-1] != ' ')
fragment--;
- j += fwrite(options[i].description+j, sizeof(char), fragment, stdout);
+ j += fwrite(option.description+j, sizeof(char), fragment, stdout);
putchar('\n');
printed = indentation+26;
}
if ( j == 0 )
{
- printf("%s\n",options[i].description+j);
+ printf("%s\n",option.description+j);
}
else if ( j < descsz )
{
- printf("%s%26c%s\n",indent,' ',options[i].description+j);
+ printf("%s%26c%s\n",indent,' ',option.description+j);
}
}
@@ -85,12 +84,13 @@ void HelpOptions(const char* group_name, int indentation, int width, struct Help
void HelpBsp()
{
- struct HelpOption bsp[] = {
+ const std::vector options = {
{"-bsp [options] ", "Switch that enters this stage"},
{"-altsplit", "Alternate BSP tree splitting weights (should give more fps)"},
- {"-bspfile ", "BSP file to write"},
{"-celshader ", "Sets a global cel shader name"},
+ {"-clipdepth ", "Model autoclip brushes thickness, default = 2"},
{"-custinfoparms", "Read scripts/custinfoparms.txt"},
+ {"-debugclip", "Make model autoclip brushes visible, using shaders debugclip, debugclip2"},
{"-debuginset", "Push all triangle vertexes towards the triangle center"},
{"-debugportals", "Make BSP portals visible in the map"},
{"-debugsurfaces", "Color the vertexes according to the index of the surface"},
@@ -102,7 +102,6 @@ void HelpBsp()
{"-fulldetail", "Treat detail brushes as structural ones"},
{"-keeplights", "Keep light entities in the BSP file after compile"},
{"-leaktest", "Abort if a leak was found"},
- {"-linfile ", "Line file to write"},
{"-maxarea", "Use Max Area face surface generation"},
{"-meta", "Combine adjacent triangles of the same texture to surfaces (ALWAYS USE THIS)"},
{"-metaadequatescore ", "Adequate score for adding triangles to meta surfaces"},
@@ -116,6 +115,7 @@ void HelpBsp()
{"-noflares", "Turn off support for flares"},
{"-nofog", "Turn off support for fog volumes"},
{"-nohint", "Turn off support for hint brushes"},
+ {"-noob", "Assign surfaceparm noob to all map surfaces (Q3A:Defrag mod no-overbounces flag)"},
{"-nosRGB", "Treat colors and textures as linear colorspace"},
{"-nosRGBcolor", "Treat shader and light entity colors as linear colorspace"},
{"-nosRGBtex", "Treat textures as linear colorspace"},
@@ -125,52 +125,53 @@ void HelpBsp()
{"-np ", "Force all surfaces to be nonplanar with a given shade angle"},
{"-onlyents", "Only update entities in the BSP"},
{"-patchmeta", "Turn patches into triangle meshes for display"},
- {"-prtfile ", "Portal file to write"},
{"-rename", "Append suffix to miscmodel shaders (needed for SoF2)"},
{"-samplesize ", "Sets default lightmap resolution in luxels/qu"},
{"-skyfix", "Turn sky box into six surfaces to work around ATI problems"},
{"-snap ", "Snap brush bevel planes to the given number of units"},
- {"-srffile ", "Surface file to write"},
{"-sRGBcolor", "Treat shader and light entity colors as sRGB colorspace"},
{"-sRGBtex", "Treat textures as sRGB colorspace"},
{"-tempname ", "Read the MAP file from the given file name"},
{"-verboseentities", "Enable `-v` only for map entities, not for the world"},
};
- HelpOptions("BSP Stage", 0, 80, bsp, std::size(bsp));
+ HelpOptions("BSP Stage", 0, 80, options);
}
void HelpVis()
{
- struct HelpOption vis[] = {
+ const std::vector options = {
{"-vis [options] ", "Switch that enters this stage"},
{"-fast", "Very fast and crude vis calculation"},
+ {"-hint", "Merge all but hint portals"},
{"-mergeportals", "The less crude half of `-merge`, makes vis sometimes much faster but doesn't hurt fps usually"},
{"-merge", "Faster but still okay vis calculation"},
{"-nopassage", "Just use PortalFlow vis (usually less fps)"},
{"-nosort", "Do not sort the portals before calculating vis (usually slower)"},
{"-passageOnly", "Just use PassageFlow vis (usually less fps)"},
- {"-prtfile ", "Portal file to read"},
{"-saveprt", "Keep the Portal file after running vis (so you can run vis again)"},
{"-v -v", "Extra verbose mode for cluster debug"}, // q3map2 common takes first -v
};
- HelpOptions("VIS Stage", 0, 80, vis, std::size(vis));
+ HelpOptions("VIS Stage", 0, 80, options);
}
void HelpLight()
{
- struct HelpOption light[] = {
+ const std::vector options = {
{"-light [options] ", "Switch that enters this stage"},
{"-approx ", "Vertex light approximation tolerance (never use in conjunction with deluxemapping)"},
- {"-areascale ", "Scaling factor for area lights (surfacelight)"},
+ {"-areascale , -area ", "Scaling factor for area lights (surfacelight)"},
+ {"-backsplash ", "scale area lights backsplash fraction + set distance globally; (distance < -900 to omit distance setting); default = 1 23; real area lights have no backsplash (scale = 0); q3map_backsplash shader keyword overrides this setting"},
{"-border", "Add a red border to lightmaps for debugging"},
+ {"-bouncecolorratio ", "0..1 ratio of colorizing light sample by texture"},
{"-bouncegrid", "Also compute radiosity on the light grid"},
{"-bounceonly", "Only compute radiosity"},
{"-bouncescale ", "Scaling factor for radiosity"},
{"-bounce ", "Number of bounces for radiosity"},
- {"-bspfile ", "BSP file to write"},
+ {"-brightness ", "Scaling factor for resulting lightmaps brightness"},
{"-cheapgrid", "Use `-cheap` style lighting for radiosity"},
{"-cheap", "Abort vertex light calculations when white is reached"},
{"-compensate ", "Lightmap compensate (darkening factor applied after everything else)"},
+ {"-contrast ", "-255 .. 255 lighting contrast, default = 0"},
{"-cpma", "CPMA vertex lighting mode"},
{"-custinfoparms", "Read scripts/custinfoparms.txt"},
{"-dark", "Darken lightmap seams"},
@@ -179,6 +180,7 @@ void HelpLight()
{"-debugdeluxe", "Show deluxemaps on the lightmap"},
{"-debugnormals", "Color the lightmaps according to the direction of the surface normal"},
{"-debugorigin", "Color the lightmaps according to the origin of the luxels"},
+ {"-debugsamplesize", "display all of 'surface too large for desired samplesize+lightmapsize' warnings"},
{"-debugsurfaces, -debugsurface", "Color the lightmaps according to the index of the surface"},
{"-debug", "Mark the lightmaps according to the cluster: unmapped clusters get yellow, occluded ones get pink, flooded ones get blue overlay color, otherwise red"},
{"-deluxemode 0", "Use modelspace deluxemaps (DarkPlaces)"},
@@ -195,17 +197,17 @@ void HelpLight()
{"-export", "Export lightmaps when compile finished (like `-export` mode)"},
{"-exposure ", "Lightmap exposure to better support overbright spots"},
{"-external", "Force external lightmaps even if at size of internal lightmaps"},
+ {"-extlmhacksize ", "External lightmaps hack size: similar to -lightmapsize N: Size of lightmaps to generate (must be a power of two), but instead of native external lightmaps enables hack to reference them in autogenerated shader (for vanilla Q3 etc)"},
{"-extradist ", "Extra distance for lights in map units"},
{"-extravisnudge", "Broken feature to nudge the luxel origin to a better vis cluster"},
{"-extrawide", "Deprecated alias for `-super 2 -filter`"},
{"-extra", "Deprecated alias for `-super 2`"},
-// {"-fastallocate", "Use `-fastallocate` to trade lightmap size against allocation time (useful with hi res lightmaps on large maps: reduce allocation time from days to minutes for only some extra bytes)"},
- {"-slowallocate", "Use old (a bit more careful, but much slower) lightmaps packing algorithm"},
{"-fastbounce", "Use `-fast` style lighting for radiosity"},
{"-faster", "Use a faster falloff curve for lighting; also implies `-fast`"},
{"-fastgrid", "Use `-fast` style lighting for the light grid"},
{"-fast", "Ignore tiny light contributions"},
{"-fill", "Fill lightmap colors from surrounding pixels to improve JPEG compression"},
+ {"-fillpink", "Fill unoccupied lightmap pixels with pink colour"},
{"-filter", "Lightmap filtering"},
{"-floodlight", "Enable floodlight (zero-effort somewhat decent lighting)"},
{"-gamma ", "Lightmap gamma"},
@@ -225,6 +227,7 @@ void HelpLight()
{"-nofastpoint", "Disable fast point light calculation"},
{"-nogrid", "Disable grid light calculation (makes all entities fullbright)"},
{"-nolightmapsearch", "Do not optimize lightmap packing for GPU memory usage (as doing so costs fps)"},
+ {"-nolm", "Skip lightmaps calculation"},
{"-normalmap", "Color the lightmaps according to the direction of the surface normal (TODO is this identical to `-debugnormals`?)"},
{"-nosRGB", "Treat colors, textures, and lightmaps as linear colorspace"},
{"-nosRGBcolor", "Treat shader and light entity colors as linear colorspace"},
@@ -233,9 +236,9 @@ void HelpLight()
{"-nostyle, -nostyles", "Disable support for light styles"},
{"-nosurf", "Disable tracing against surfaces (only uses BSP nodes then)"},
{"-notrace", "Disable shadow occlusion"},
- {"-novertex", "Disable vertex lighting"},
+ {"-novertex", "Disable vertex lighting; optional (0..1) value sets constant vertex light globally"},
{"-patchshadows", "Cast shadows from patches"},
- {"-pointscale ", "Scaling factor for spherical and spot point lights (light entities)"},
+ {"-pointscale , -point ", "Scaling factor for spherical and spot point lights (light entities)"},
{"-q3", "Use nonlinear falloff curve by default (like Q3A)"},
{"-randomsamples", "Use random sampling for lightmaps"},
{"-rawlightmapsizelimit ", "Sets maximum lightmap resolution in luxels/qu (only affects patches if used -patchmeta in BSP stage)"},
@@ -243,57 +246,69 @@ void HelpLight()
{"-samplesize ", "Sets default lightmap resolution in luxels/qu"},
{"-samplessearchboxsize ", "Search box size (1 to 4) for lightmap adaptive supersampling"},
{"-samples ", "Adaptive supersampling quality"},
+ {"-saturation ", "Lighting saturation: default = 1, > 1 = saturate, 0 = grayscale, < 0 = complementary colors"},
{"-scale ", "Scaling factor for all light types"},
{"-shadeangle ", "Angle for phong shading"},
{"-shade", "Enable phong shading at default shade angle"},
- {"-skyscale ", "Scaling factor for sky and sun light"},
+ {"-skyscale , -sky ", "Scaling factor for sky and sun light"},
+ {"-slowallocate", "Use old (a bit more careful, but much slower) lightmaps packing algorithm"},
{"-smooth", "Deprecated alias for `-samples 2`"},
- {"-sphericalscale ", "Scaling factor for spherical point light entities"},
- {"-spotscale ", "Scaling factor for spot point light entities"},
- {"-srffile ", "Surface file to read"},
+ {"-sphericalscale , -spherical ", "Scaling factor for spherical point light entities"},
+ {"-spotscale , -spot ", "Scaling factor for spot point light entities"},
{"-sRGB", "Treat colors, textures, and lightmaps as sRGB colorspace"},
{"-sRGBcolor", "Treat shader and light entity colors as sRGB colorspace"},
{"-sRGBlight", "Write lightmaps as sRGB colorspace"},
{"-sRGBtex", "Treat textures as sRGB colorspace"},
{"-style, -styles", "Enable support for light styles"},
{"-sunonly", "Only compute sun light"},
- {"-super ", "Ordered grid supersampling quality"},
+ {"-super , -supersample ", "Ordered grid supersampling quality"},
{"-thresh ", "Triangle subdivision threshold"},
{"-trianglecheck", "Broken check that should ensure luxels apply to the right triangle"},
{"-trisoup", "Convert brush faces to triangle soup"},
+ {"-vertexscale ", "Scaling factor for resulting vertex light values"},
{"-wolf", "Use linear falloff curve by default (like W:ET)"},
};
- HelpOptions("Light Stage", 0, 80, light, std::size(light));
+ HelpOptions("Light Stage", 0, 80, options);
}
void HelpAnalyze()
{
- struct HelpOption analyze[] = {
+ const std::vector options = {
{"-analyze [options] ", "Switch that enters this mode"},
{"-lumpswap", "Swap byte order in the lumps"},
};
- HelpOptions("Analyzing BSP-like file structure", 0, 80, analyze, std::size(analyze));
+ HelpOptions("Analyzing BSP-like file structure", 0, 80, options);
}
void HelpScale()
{
- struct HelpOption scale[] = {
+ const std::vector options = {
{"-scale [options] ", "Scale uniformly"},
{"-scale [options] ", "Scale non-uniformly"},
- {"-tex", "Scale without texture lock"},
- {"-spawn_ref ", "Vertical offset for info_player_* entities (adds spawn_ref, scales, subtracts spawn_ref)"},
+ {"-tex", "Option to scale without texture lock"},
+ {"-spawn_ref ", "Option to vertically offset info_player_* entities (adds spawn_ref, scales, subtracts spawn_ref)"},
};
- HelpOptions("Scaling", 0, 80, scale, std::size(scale));
+ HelpOptions("BSP Scaling", 0, 80, options);
+}
+
+void HelpShift()
+{
+ const std::vector options = {
+ {"-shift ", "Shift uniformly"},
+ {"-shift ", "Shift non-uniformly"},
+ };
+ HelpOptions("BSP Shift", 0, 80, options);
}
void HelpConvert()
{
- struct HelpOption convert[] = {
+ const std::vector options = {
{"-convert [options] ", "Switch that enters this mode"},
{"-deluxemapsastexcoord", "Save deluxemap names and texcoords instead of textures (only when writing ase and obj)"},
{"-de ", "Distance epsilon for the conversion (only when reading map)"},
+ {"-fast", "fast bsp to map conversion mode (without texture alignments)"},
{"-format ", "Select the converter, default ase (available: map, map_bp, ase, obj, or game names)"},
{"-lightmapsastexcoord", "Save lightmap names and texcoords instead of textures (only when writing ase and obj)"},
{"-meta", "Combine adjacent triangles of the same texture to surfaces (only when reading map)"},
@@ -304,56 +319,56 @@ void HelpConvert()
{"-shadersasbitmap", "Save shader names as bitmap names in the model so it works as a prefab (only when writing ase and obj)"},
};
- HelpOptions("Converting & Decompiling", 0, 80, convert, std::size(convert));
+ HelpOptions("Converting & Decompiling", 0, 80, options);
}
void HelpExport()
{
- struct HelpOption exportl[] = {
+ const std::vector options = {
{"-export ", "Copies lightmaps from the BSP to `filename/lightmap_0000.tga` ff"}
};
- HelpOptions("Exporting lightmaps", 0, 80, exportl, std::size(exportl));
-}
-
-void HelpExportEnts()
-{
- struct HelpOption exportents[] = {
- {"-exportents ", "Exports the entities to a text file (.ent)"},
- };
- HelpOptions("ExportEnts Stage", 0, 80, exportents, std::size(exportents));
-}
-
-void HelpFixaas()
-{
- struct HelpOption fixaas[] = {
- {"-fixaas ", "Switch that enters this mode"},
- };
-
- HelpOptions("Fixing AAS checksum", 0, 80, fixaas, std::size(fixaas));
-}
-
-void HelpInfo()
-{
- struct HelpOption info[] = {
- {"-info ", "Switch that enters this mode"},
- };
-
- HelpOptions("Get info about BSP file", 0, 80, info, std::size(info));
+ HelpOptions("Exporting lightmaps", 0, 80, options);
}
void HelpImport()
{
- struct HelpOption import[] = {
+ const std::vector options = {
{"-import ", "Copies lightmaps from `filename/lightmap_0000.tga` ff into the BSP"},
};
- HelpOptions("Importing lightmaps", 0, 80, import, std::size(import));
+ HelpOptions("Importing lightmaps", 0, 80, options);
+}
+
+void HelpExportEnts()
+{
+ const std::vector options = {
+ {"-exportents ", "Exports the entities to a text file (.ent)"},
+ };
+ HelpOptions("ExportEnts Stage", 0, 80, options);
+}
+
+void HelpFixaas()
+{
+ const std::vector options = {
+ {"-fixaas ", "Writes BSP checksum to AAS file, so that it's accepted as valid by engine"},
+ };
+
+ HelpOptions("Fixing AAS checksum", 0, 80, options);
+}
+
+void HelpInfo()
+{
+ const std::vector options = {
+ {"-info ", "Switch that enters this mode"},
+ };
+
+ HelpOptions("Get info about BSP file", 0, 80, options);
}
void HelpMinimap()
{
- struct HelpOption minimap[] = {
+ const std::vector options = {
{"-minimap [options] ", "Creates a minimap of the BSP, by default writes to `../gfx/filename_mini.tga`"},
{"-autolevel", "Automatically level brightness and contrast"},
{"-black", "Write the minimap as a black-on-transparency RGBA32 image"},
@@ -374,14 +389,50 @@ void HelpMinimap()
{"-white", "Write the minimap as a white-on-transparency RGBA32 image"},
};
- HelpOptions("MiniMap", 0, 80, minimap, std::size(minimap));
+ HelpOptions("MiniMap", 0, 80, options);
+}
+
+void HelpPk3()
+{
+ const std::vector options = {
+ {"-pk3 [options] ", "Creates a pk3 for the BSP (complete Q3 support). Using file 'gamename.exclude' to exclude vanilla game resources."},
+ {"-complevel ", "Set compression level (-1 .. 10); 0 = uncompressed, -1 = 6, 10 = ultra zlib incompatible preset"},
+ {"-dbg", "Print wall of debug text, useful for .exclude file creation"},
+ {"-png", "include png textures, at highest priority; taking tga, jpg by default"},
+ };
+
+ HelpOptions("PK3 creation", 0, 80, options);
+}
+
+void HelpRepack()
+{
+ const std::vector options = {
+ {"-repack [options] ", "Creates repack of BSP(s) (complete Q3 support). Rips off only used shaders to new shader file. Using file 'gamename.exclude' to exclude vanilla game resources and 'repack.exclude' to exclude resources of existing repack."},
+ {"-analyze", "Only print bsp resource references and exit"},
+ {"-complevel ", "Set compression level (-1 .. 10); 0 = uncompressed, -1 = 6, 10 = ultra zlib incompatible preset"},
+ {"-dbg", "Print wall of debug text"},
+ {"-png", "include png textures, at highest priority; taking tga, jpg by default"},
+ };
+
+ HelpOptions("Maps repack creation", 0, 80, options);
+}
+
+void HelpJson()
+{
+ const std::vector options = {
+ {"-json [options] ", "Export/import BSP to/from json text files for debugging and editing purposes"},
+ {"-unpack", "Unpack BSP to json"},
+ {"-pack", "Pack json to BSP"},
+ };
+
+ HelpOptions("BSP json export/import", 0, 80, options);
}
void HelpCommon()
{
- struct HelpOption common[] = {
+ const std::vector options = {
{"-connect ", "Talk to a NetRadiant instance using a specific XML based protocol"},
- {"-force", "Allow reading some broken/unsupported BSP files e.g. when decompiling, may also crash"},
+ {"-force", "Allow reading some broken/unsupported BSP files e.g. when decompiling, may crash. Also enables decompilation of model autoclip brushes."},
{"-fs_basepath ", "Sets the given path as main directory of the game (can be used more than once to look in multiple paths)"},
{"-fs_forbiddenpath ", "Pattern to ignore directories, pk3, and pk3dir; example pak?.pk3 (can be used more than once to look for multiple patterns)"},
{"-fs_game ", "Sets extra game directory name to additionally load mod's resources from at higher priority (by default for Q3A 'baseq3' is loaded, -fs_game cpma will also load 'cpma'; can be used more than once)"},
@@ -389,9 +440,6 @@ void HelpCommon()
{"-fs_home ", "Specifies where the user home directory is on Linux"},
{"-fs_homebase ", "Specifies game home directory relative to user home directory on Linux (default for Q3A: .q3a)"},
{"-fs_homepath ", "Sets the given path as the game home directory name (fs_home + fs_homebase)"},
- {"-fs_nobasepath", "Do not load base paths in VFS, imply -fs_nomagicpath"},
- {"-fs_nomagicpath", "Do not try to guess base path magically"},
- {"-fs_nohomepath", "Do not load home path in VFS"},
{"-fs_pakpath ", "Specify a package directory (can be used more than once to look in multiple paths)"},
{"-game ", "Load settings for the given game (default: quake3), -help -game lists available games"},
{"-subdivisions ", "multiplier for patch subdivisions quality"},
@@ -399,7 +447,7 @@ void HelpCommon()
{"-v", "Verbose mode"}
};
- HelpOptions("Common Options", 0, 80, common, std::size(common));
+ HelpOptions("Common Options", 0, 80, options);
}
@@ -416,19 +464,23 @@ void HelpMain(const char* arg)
HelpCommon();
- struct HelpOption stages[] = {
+ const std::vector stages = {
{"-bsp", "BSP Stage"},
{"-vis", "VIS Stage"},
{"-light", "Light Stage"},
{"-analyze", "Analyzing BSP-like file structure"},
{"-scale", "Scaling"},
+ {"-shift", "Shift"},
{"-convert", "Converting & Decompiling"},
{"-export", "Exporting lightmaps"},
+ {"-import", "Importing lightmaps"},
{"-exportents", "Exporting entities"},
{"-fixaas", "Fixing AAS checksum"},
{"-info", "Get info about BSP file"},
- {"-import", "Importing lightmaps"},
{"-minimap", "MiniMap"},
+ {"-pk3", "PK3 creation"},
+ {"-repack", "Maps repack creation"},
+ {"-json", "BSP json export/import"},
};
void(*help_funcs[])() = {
HelpBsp,
@@ -436,13 +488,17 @@ void HelpMain(const char* arg)
HelpLight,
HelpAnalyze,
HelpScale,
+ HelpShift,
HelpConvert,
HelpExport,
+ HelpImport,
HelpExportEnts,
HelpFixaas,
HelpInfo,
- HelpImport,
HelpMinimap,
+ HelpPk3,
+ HelpRepack,
+ HelpJson,
};
if ( !strEmptyOrNull( arg ) )
@@ -450,8 +506,7 @@ void HelpMain(const char* arg)
if ( arg[0] == '-' )
arg++;
- unsigned i;
- for ( i = 0; i < std::size(stages); i++ )
+ for ( size_t i = 0; i < stages.size(); ++i )
if ( striEqual(arg, stages[i].name+1) )
{
help_funcs[i]();
@@ -463,5 +518,5 @@ void HelpMain(const char* arg)
}
}
- HelpOptions("Stages", 0, 80, stages, std::size(stages));
+ HelpOptions("Stages", 0, 80, stages);
}
diff --git a/tools/quake3/q3map2/light.cpp b/tools/quake3/q3map2/light.cpp
index 538493d2..39ada471 100644
--- a/tools/quake3/q3map2/light.cpp
+++ b/tools/quake3/q3map2/light.cpp
@@ -2395,10 +2395,6 @@ int LightMain( Args& args ){
Sys_Printf( "Faster mode enabled\n" );
}
-// while ( args.takeArg( "-fastallocate" ) ) {
-// fastAllocate = true;
-// Sys_Printf( "Fast allocation mode enabled\n" );
-// }
while ( args.takeArg( "-slowallocate" ) ) {
fastAllocate = false;
Sys_Printf( "Slow allocation mode enabled\n" );