q3map2/help: list supported games

[xonotic/netradiant.git] / tools / quake3 / q3map2 / help.c

diff --git a/tools/quake3/q3map2/help.c b/tools/quake3/q3map2/help.c
index 1c99d3c417b605af6ff97f614e59a2a866832117..5f5664d79e57f45196fbeb2ca751aa8c998970c4 100644 (file)
--- a/tools/quake3/q3map2/help.c
+++ b/tools/quake3/q3map2/help.c
@@ -68,6 +68,7 @@ void HelpOptions(const char* group_name, int indentation, int width, struct Help
                        putchar('\n');
                        printed = indentation+26;
                }
+
                if ( j == 0 )
                {
                        printf("%s\n",options[i].description+j);
@@ -97,6 +98,7 @@ void HelpBsp()
                {"-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"},
+               {"-fastmeta", "Use small lightmap/surface verts/number maximum numbers (like Q3A), to be used with `-meta`"},
                {"-flares", "Turn on support for flares"},
                {"-flat", "Enable flat shading (good for combining with -celshader)"},
                {"-fulldetail", "Treat detail brushes as structural ones"},
@@ -104,13 +106,16 @@ void HelpBsp()
                {"-leaktest", "Abort if a leak was found"},
                {"-linfile <filename.lin>", "Line file to write"},
                {"-maxarea", "Use Max Area face surface generation"},
+               {"-maxlightmapvertices <N>", "Sets the maximum number of vertices per lightmapped surface"},
+               {"-maxsurfaceindexes <N>", "Sets the maximum number of indexes per surface"},
+               {"-maxsurfacevertices <N>", "Sets the maximum number of vertices per surface"},
                {"-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"},
                {"-metamaxbboxdistance <F>", "Maximum bounding box distance for 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"},
+               {"-mi <N>", "Deprecated alias for `-maxsurfaceindexes`"},
+               {"-mv <N>", "Deprecated alias for `-maxlightmapverts`"},
                {"-ne <F>", "Normal epsilon for plane snapping etc."},
                {"-nocurves", "Turn off support for patches"},
                {"-nodetail", "Leave out detail brushes"},
@@ -139,6 +144,7 @@ void HelpBsp()
                {"-tmpout", "Write the BSP file to /tmp"},
                {"-verboseentities", "Enable `-v` only for map entities, not for the world"},
        };
+
        HelpOptions("BSP Stage", 0, 80, bsp, sizeof(bsp)/sizeof(struct HelpOption));
 }
 
@@ -159,6 +165,7 @@ void HelpVis()
                {"-tmpout", "Use /tmp folder for output"},
                {"-v -v", "Extra verbose mode for cluster debug"}, // q3map2 common takes first -v
        };
+
        HelpOptions("VIS Stage", 0, 80, vis, sizeof(vis)/sizeof(struct HelpOption));
 }
 
@@ -207,10 +214,11 @@ void HelpLight()
                {"-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)"},
+               {"-fastallocate",  "Trade lightmap size against packing time (useful with hi res lightmaps on large maps: reduce allocation time from days to minutes for only some extra bytes)"},
                {"-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"},
+               {"-fastlightmapsearch", "Deprecated alias for `-fastallocate`"},
                {"-fast", "Ignore tiny light contributions"},
                {"-fill", "Fill lightmap colors from surrounding pixels to improve JPEG compression"},
                {"-filter", "Lightmap filtering"},
@@ -230,6 +238,7 @@ void HelpLight()
                {"-lomem", "Low memory but slower lighting mode"},
                {"-lowquality", "Low quality floodlight (appears to currently break floodlight)"},
                {"-minsamplesize <N>", "Sets minimum lightmap resolution in luxels/qu"},
+               {"-nobouncestore", "Do not store BSP, lightmap and shader files between bounces"},
                {"-nocollapse", "Do not collapse identical lightmaps"},
                {"-nodeluxe, -nodeluxemap", "Disable deluxemapping"},
                {"-nofastpoint", "Disable fast point light calculation"},
@@ -257,6 +266,7 @@ void HelpLight()
                {"-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 (default)"},
                {"-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"},
@@ -295,6 +305,7 @@ void HelpScale()
                {"-tex", "Scale without texture lock"},
                {"-spawn_ref <F>", "Vertical offset for info_player_* entities (adds spawn_ref, scales, subtracts spawn_ref)"},
        };
+
        HelpOptions("Scaling", 0, 80, scale, sizeof(scale)/sizeof(struct HelpOption));
 }
 
@@ -410,7 +421,38 @@ void HelpCommon()
        };
 
        HelpOptions("Common Options", 0, 80, common, sizeof(common)/sizeof(struct HelpOption));
+}
+
+void HelpGames()
+{
+       printf("Games:\n");
+       qboolean begin = qtrue;
+
+       // TODO: sort alphabetically
+       for ( unsigned i = 0, length = 0; games[ i ].arg != NULL; i++ )
+       {
+               // 3 for two whitespaces at the beginning and one (optional) comma a the end
+               if ( length + 3 + strlen( games[ i ].arg ) > 80 )
+               {
+                       printf(",\n");
+                       length = 0;
+                       begin = qtrue;
+               }
+
+               if ( begin )
+               {
+                       printf("  %s", games[ i ].arg );
+                       begin = qfalse;
+               }
+               else
+               {
+                       printf(", %s", games[ i ].arg );
+               }
+
+               length += 2 + strlen( games[ i ].arg );
+       }
 
+       printf("\n\n");
 }
 
 void HelpMain(const char* arg)
@@ -420,6 +462,8 @@ void HelpMain(const char* arg)
 
        HelpCommon();
 
+       HelpGames();
+
        struct HelpOption stages[] = {
                {"-bsp", "BSP Stage"},
                {"-vis", "VIS Stage"},
@@ -434,6 +478,7 @@ void HelpMain(const char* arg)
                {"-import", "Importing lightmaps"},
                {"-minimap", "MiniMap"},
        };
+
        void(*help_funcs[])() = {
                HelpBsp,
                HelpVis,