update docs for rendermax

develop
myk002 2022-07-29 16:31:37 -07:00
parent eef7812bf6
commit a7011421b4
No known key found for this signature in database
GPG Key ID: 8A39CA0FA0C16E78
2 changed files with 29 additions and 22 deletions

@ -1,18 +1,32 @@
rendermax rendermax
========= =========
A collection of renderer replacing/enhancing filters. For better effect try changing the Tags:
black color in palette to non totally black. See :forums:`128487` for more info. :dfhack-keybind:`rendermax`
Options: Modify the map lighting. This plugin provides a collection of OpenGL lighting
filters that affect how the map is drawn to the screen.
:trippy: Randomizes the color of each tiles. Used for fun, or testing. Usage:
:light: Enable lighting engine.
:light reload: Reload the settings file.
:light sun <x>|cycle: Set time to <x> (in hours) or set it to df time cycle.
:occlusionON, occlusionOFF: Show debug occlusion info.
:disable: Disable any filter that is enabled.
An image showing lava and dragon breath. Not pictured here: sunlight, shining items/plants, ``rendermax light``
materials that color the light etc... Light the map tiles realisitically. Outside tiles are light during the day
and dark at night. Inside tiles are always dark unless a nearby unit is
lighting it up, as if they were carrying torches.
``rendermax light sun <hour>|cycle``
Set the outside lighting to correspond with the specified day hour (1-24),
or specify ``cycle`` to have the lighting follow the sun (which is the
default).
``rendermax light reload``
Reload the lighting settings file.
``rendermax trippy``
Randomize the color of each tile. Used for fun, or testing.
``rendermax disable``
Disable any ``rendermax`` lighting filters that are currently active.
An image showing lava and dragon breath. Not pictured here: sunlight, shining
items/plants, materials that color the light etc.
.. image:: ../images/rendermax.png .. image:: ../images/rendermax.png
For better visibility, try changing the black color in palette to non totally
black. See :forums:`128487` for more info.

@ -49,16 +49,9 @@ static command_result rendermax(color_ostream &out, vector <string> & parameters
DFhackCExport command_result plugin_init (color_ostream &out, std::vector <PluginCommand> &commands) DFhackCExport command_result plugin_init (color_ostream &out, std::vector <PluginCommand> &commands)
{ {
commands.push_back(PluginCommand( commands.push_back(PluginCommand(
"rendermax", "switch rendering engine.", rendermax, false, "rendermax",
" rendermax trippy\n" "Modify the map lighting.",
" rendermax truecolor red|green|blue|white\n" rendermax));
" rendermax lua\n"
" rendermax light - lighting engine\n"
" rendermax light reload - reload the settings file\n"
" rendermax light sun <x>|cycle - set time to x (in hours) or cycle (same effect if x<0)\n"
" rendermax light occlusionON|occlusionOFF - debug the occlusion map\n"
" rendermax disable\n"
));
return CR_OK; return CR_OK;
} }
@ -331,7 +324,7 @@ static command_result rendermax(color_ostream &out, vector <string> & parameters
return CR_WRONG_USAGE; return CR_WRONG_USAGE;
if(!enabler->renderer->uses_opengl()) if(!enabler->renderer->uses_opengl())
{ {
out.printerr("Sorry, this plugin needs open gl enabled printmode. Try STANDARD or other non-2D\n"); out.printerr("Sorry, this plugin needs open GL-enabled printmode. Try STANDARD or other non-2D.\n");
return CR_FAILURE; return CR_FAILURE;
} }
string cmd=parameters[0]; string cmd=parameters[0];