detail extensions

Revision as of 07:59, 21 January 2013

Extensions in this section complement those of the #Option section. Each Option extension takes the form do_..., where each Detail extension takes the form ..._... where the first parts (...) are identical to one another. If the Option extension is turned off the corresponding Detail extensions have no part to play.

alphafog_skyflood_constant

Introduced around 1.0.0.1, this extension is part of an effect that blends the horizon into the sky domes that are part of Sword of Moonlight. The sky is fully transparent at #alphafog_skyfloor_constant and becomes fully opaque as the vertical distance from the floor approaches 1 in sky model coordinates.

This constant can be thought of as scaling the sky along the vertical axis, so that the larger the scaling the slighter the gradient. The default value is 8.

Note that internally this value simply sets a shader preprocessor macro that is used by the default shader set. Values are limited to real numbers.[#]

alphafog_skyfloor_constant

Introduced around 1.0.0.1, this extension is part of an effect that blends the horizon into the sky domes that are part of Sword of Moonlight. The default value is -0.125 or the lowest point of the sky domes. Any part of the sky below this point will be made completely invisible as it blends into the horizon. Refer to #alphafog_skyflood_constant.

Note that internally this value simply sets a shader preprocessor macro that is used by the default shader set. Care should be taken when featuring custom sky models. Values are limited to real numbers.[#]

ambient_contribution

Introduced around 1.0.0.1, this extension sets the percentage of a light that will be converted into ambient light. The default percentage is not specified. Historically it is and has been 0.15, or 15%. This is unlikely to change, however it doesn't hurt to set this manually, even if 15% is alright with you. Some caution should be observed. Refer to #do_ambient. Values are limited to real numbers between 0 and 1.[#]

bob_frequency_multiplier

Introduced around 1.1.1.5, this extension multiplies the number of times the walking effect will loop over the distance of a meter when moving at full walking speed. Each loop can be thought of as a single step. An increased frequency amounts to a shorter stride. A decrease a longer stride. Values are limited to real numbers.[#]

cursor_hourglass_ms_timeout

Introduced around 1.0.0.1, this extension sets the number of milliseconds that a game may be "unresponsive" before an "hourglass" icon will be made to appear to indicate that the game is working behind the scene.

The default value is 0. Which is converted into an internal default timeout that has historically been fixed at 250ms, or a quarter of a second. You might need to use a larger value if the icon is a nuisance. Values are limited to positive whole numbers.[#]

Note that the game may or may not be in fact working or may only be partially working. The real intent is to make the game appear responsive to put the player at ease and stop Windows' "not responding" protocol.

*escape_analog_gaits

Introduced around 1.1.1.5, this extension is undocumented. Values are limited to series of real numbers.[#]

*escape_analog_modes

Introduced around 1.1.1.5, this extension is undocumented. Values are limited to series of analog modes as described above.

log_initial_timeout

Introduced around 1.0.0.1, this extension sets the number of refresh frames to log to a log file before logging is no longer performed. This is a diagnostic tool. A log file can grow very large and logging can make a game unplayable under different circumstances. The default setting is 0. The default behavior is to log until manually disabled. Refer to #log_subsequent_timeout. Values are limited to positive whole numbers.[#]

*log_subsequent_timeout

Introduced around 1.0.0.1, this extension sets the number of refresh frames to log whenever logging is manually enabled before automatically disabling logging. The default setting is 0. The default behavior is to enable logging until manually disabled. Refer to #log_initial_timeout. Values are limited to positive whole numbers.[#]

*mipmaps_maximum_anisotropy

Introduced around 1.0.0.1, this extension is undocumented. Values are limited to positive whole numbers.[#]