adjust extensions

From Wiki

Jump to: navigation, search
(wrong version)
 
(47 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Notice|small=left|text='''Transcluded by [[Sword of Moonlight Extension Library/list of extensions]].'''}}
 +
 
<onlyinclude>
 
<onlyinclude>
−
====*blackened_tint====
 
  
−
====*blackened_tint2====
+
====Restructuring of [Adjust]====
 +
The old version of this section is available here[http://en.swordofmoonlight.org/w/index.php?title=Sword_of_Moonlight_Extension_Library/adjust_extensions&oldid=1633]. Many extensions changed with SomEx ver. 1.2.0.8.
 +
 
 +
*The map setting extensions were combined into the fov_ group and simplified as much as possible.
 +
 
 +
*The pc_..._speed_multiplier group was removed. See the [[#Number]] section for how to directly set the _WALK, _DASH, and _TURN constants.
 +
 
 +
*The pov_baseline_adjustment extension was replace by [[#player_character_stature]].
 +
 
 +
*The sway and bob_..._multiplier extensions were removed along with do_sway. The sway can now be directly set by [[#player_character_bob2]] however bob_frequency_multiplier is still awaiting its replacement.
 +
 
 +
*The menu and onscreen display element ..._opacity_multiplier extensions were removed. The ..._opacity_adjustment extensions need to reproduce the math taking into account the incoming opacity values.
 +
 
 +
====abyss_depth====
 +
{{Ex/inival|1.2.0.8|real numbers|establishes the depth below a map tile that cannot be passed upon penalty of death, ie. game over. By default it is -10. This replaces abyss_event_adjustment|real}}
 +
 
 +
'''2017 note: Does [[Som2k]] work this way? In practice the -10 death point rarely triggers and or may only apply to tile types that are marked as special "pits."'''
 +
 
 +
====blackened_tint...====
 +
{{anchor|blackened_tint}}
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the black tint that is a backdrop for text and menus. The default value is 80000000, or half black. Note that there is a second black tint that is applied over the first black tint. Refer to [[#blackened_tint2]]|color}}
 +
 
 +
'''blackened_tint2'''
 +
{{anchor|blackened_tint2}}
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the second layer of black tint. Refer to [[#blackened_tint]]. The default value is 64000000, or quarter black. Note that this is the tint that is used by [[#do_pause]] when the game is paused|color}}
 +
 
 +
====blue_flash_tint====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the blue flash that is triggered by in game events. The default value is ff0000ff, or pure blue. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear|color}}
 +
 
 +
====character_identifier====
 +
{{Ex/inival|1.2.1.14|real numbers|generates custom character identifiers to be used as parameters to other extensions and to be included by [[SomEx/list_of_numbers#pc|pc]]. This number receives an input (a parameter) that is encoded by [[SomEx/list_of_numbers#id|id]]. These are default identifiers. The purpose of this extension is to remap and or combine identifiers.
 +
 
 +
Historically Sword of Moonlight segregates would-be characters into four classes. These classes are enemy, NPC, object, and PC. Unless this segregation is by some method obliterated, then this extension will receive a two-part number to be decoded by [[SomEx/list_of_numbers#di|4096di]] and 4097di in order to obtain a [[SOM_PRM]] item number and character class, respectively. Class number 0 is enemies; 1 NPCs; 2 objects; 3 the PC.
 +
 
 +
''There is a second parameter that is the [[SOM_MAP]] content identifier, which may be used to further specialize character identifiers.''
  
−
====*blue_flash_tint====
+
The PC's number is 12288, since their item number is 0. In a multi-PC scenario this extension could, for example, take a [[SomEx/list_of_numbers#c|counter]] into consideration|number}}
  
−
====bob_distance_multiplier====
+
====fov_fogline_saturation====
−
{{Ex/inival|1.0.0.1|real numbers|multiplies the walking effect(s) experienced by the player}}
+
{{Ex/inival|1.2.0.8|base 256 identifiers|overrides the color of the level's fog. As of 1.2.0.8 there isn't a way to retrieve the current level's fog parameters, so if this extension is used the fog's color setting in [[SOM_MAP]] should be disregarded|id}}
  
−
<div style="border:3px double darkcyan; padding:0 1ex">
+
====fov_fogline_adjustment...====
−
{{Ombox|type=notice|text='''Does not apply to [[#do_bob]].'''}}
+
{{anchor|fov_fogline_adjustment}}
−
''A multiplier of -1 is generally recommended in order to invert the bob effect. In reality when people walk the eye level does not gain any height, and a negative effect ensures the player will not be able to see anything that they shouldn't by bobbing up over visual obstacles.''
+
{{anchor|fov_fogline_adjustment2}}
−
</div>
+
{{Ex/inival|1.2.0.8|positive real numbers|specifies the beginning and effective end of the fog. When the part after ''adjustment'' is omitted, the starting point of the fog is specified in terms of meters. Note that in [[SOM_MAP]] this is represented by a fraction of the way to the back of the fog; not so here. The unadjusted value is provided.  
  
−
====draw_distance_multiplier====
+
'''fov_fogline_adjustment2''' specifies the end point of the fog. If the level does not have a sky/backdrop then the in game scene shall comes to an end at this point. The unadjusted value is provided. This value is equivalent to SOM_MAP's per map visibility setting. Refer to [[#fov_skyline_adjustment2]]|real}}
−
{{Ex/inival|1.0.0.1|positive real numbers|multiplies the draw distance uniformly across [[SOM_MAP#Draw Distance|maps]]}}
 
  
−
====fog_pullback_factor====
+
====fov_frustum_multiplier====
−
{{Ex/inival|1.0.0.1|real numbers|pulls the fog to the player as the value approaches 1. It is then averaged with [[#fog_pushback_factor]] to determine where fog will begin}}
+
''Since 1.2.0.8 the default is 1.2. The default will revert back to 1 as soon as this makeshift extension is no longer of general use.''
  
−
====fog_pushback_factor====
+
{{Ex/inival|1.1.1.5|real numbers|multiplies the horizontal angle of what is visible to Sword of Moonlight in game. It can be game dependent, but you may need to increase this (from 1) to create gutters along the sides of the field of vision if you notice map tiles disappearing (along the sides) especially when moving quickly with analog controls. Generally the higher the turn speed the more you might need to lean on this. Note that this is not a fix for problems of this nature in widescreen mode. See [[#do_fix_fov_in_memory]] (or [[#do_fix_any_trivial]]) in that case|real}}
−
{{Ex/inival|1.0.0.1|positive real numbers|pushes the fog away from the player arriving at the [[SOM_MAP#Draw Distance|draw distance]] when the value reaches 1. It is then averaged with [[#fog_pullback_factor]] to determine where fog will begin}}
 
  
−
====fog_saturate_multiplier====
+
''This can also be a means to work with map tiles that have "eaves" far outside of 2x2 meters (the natural size of a single tile) however generally speaking this is not recommended in terms of best practices.''
−
{{Ex/inival|1.0.0.1|positive real numbers|multiplies the distance at which fog becomes fully saturated}}
 
  
−
====*fov_frustum_multiplier====
+
====fov_sky_and_fog_minima...====
 +
{{anchor|fov_sky_and_fog_minima}}
 +
{{Ex/inival|1.2.0.8|real numbers between 0.025 and 1|is expressed as a fraction of the end of both the fog and the sky/backdrop so that it should cover the same amount of pixels at any given distance. By default it is 0.025 and cannot be made less that this. This is to ensure that there is always a soft transition where the end of the fog and sky blend into the scenery. The sky transition is dependent upon [[#do_alphafog]], which is also enabled by [[#do_fog]]|real}}
  
−
====*green_flash_tint====
+
'''fov_sky_and_fog_minima2'''
 +
{{anchor|fov_sky_and_fog_minima2}}<br>
 +
{{Ex/inival|1.2.0.10|real numbers between 0.025 and 1|is available to set the fog minimum independent of the sky/backdrop minimum. If not explicitly set, it is identical to [[#fov_sky_and_fog_minima]]|real}}
  
−
====*highlight_opacity_adjustment====
+
====fov_sky_and_fog_powers...====
 +
{{anchor|fov_sky_and_fog_powers|fov_sky_and_fog_powers2}}
 +
{{Ex/inival|1.2.0.10|positive real numbers|exponentiates the sky/backdrop and fog. By default it is 1, or linear. Values around 0.5, or the square root, produce a sharp cutoff along the fog horizon, and so are not recommended. Values above 1 create an ever thicker fog. At present this extension must be set to a constant value, and so values between 0.75 and 1.5 are recommended. Furthermore it only applies to per pixel fog using the recommended custom Sword of Moonlight "shaders". '''Since 1.2.1.8''' the fog exponent can be set independently of the sky/backdrop's with '''fov_sky_and_fog_powers2'''. (1.2.1.8 corrects a bug that reversed the values in the "shader.") If it is not explicitly set it is identical to [[#fov_sky_and_fog_power]]|real}}
  
−
====*highlight_opacity_multiplier====
+
====fov_skyline_adjustment...====
 +
{{anchor|fov_skyline_adjustment}}
 +
{{anchor|fov_skyline_adjustment2}}
 +
{{Ex/inival|1.2.0.8|positive real numbers|specifies the beginning and effective end of the sky. When the part after ''adjustment'' is omitted, the starting point of the sky is specified in terms of meters. The unadjusted value is provided. Note that by default the start of the sky is equal to the end of the sky.
  
−
====*hud_gauge_depleted_half_tint====
+
'''fov_skyline_adjustment2''' specifies the end point of the sky. If the level does not have a sky/backdrop both fov_skyline_adjustment and fov_skyline_adjustment2 should be disregarded. Otherwise [[#fov_fogline_adjustment2]] cannot be greater than fov_skyline_adjustment2 and so will be scaled back if necessary. Refer to [[#fov_sky_and_fog_minima]]|real}}
  
−
====*hud_gauge_opacity_adjustment====
+
====green_flash_tint====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the green flash that is triggered by in game events. The default value is ff00ff00, or pure green. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear|color}}
  
−
====*hud_gauge_opacity_multiplier====
+
====highlight_opacity_adjustment====
 +
{{Ex/inival|1.2.0.8|real numbers between 0.06 and 1|adjusts the opacity of the flashing menu paneling. The unadjusted opacity is supplied|real}}
  
−
====*lettering_contrast====
+
====hud_gauge_depleted_half_tint====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the gauges when emptied. The default is unspecified, as of 1.1.1.5 it is 55808080. To emulate Sword of Moonlight you can use a value of 00 to make only the filled portions of the gauges visible|color}}
  
−
====*lettering_tint====
+
''The depleted gauges were needed by [[#do_st]] to emulate [[Shadow Tower]]. It is simpler to just leave them as a permanent fixture. Plus it just looks nice.''
  
−
====*pc_dash_speed_multiplier====
+
====hud_gauge_opacity_adjustment====
 +
{{Ex/inival|1.2.0.8|real numbers between 0 and 1|adjusts the opacity of the HUD (heads up display) gauges. Note that the emptied halves of the gauges are unaffected. Refer to [[#hud_gauge_depleted_half_tint]]. The unadjusted opacity is supplied|real}}
  
−
====*pc_turn_speed_multiplier====
+
====lettering_contrast====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the in-game text's "shadows". The default color is 464646. Partial transparency is not supported as of 1.1.1.5. Refer to [[#lettering_tint]]|color}}
  
−
====*pc_walk_speed_multiplier====
+
''What this actually does is recolor text that is the color of Sword of Moonlight's shadows. Refer to [[#system_fonts_contrast]] and [[#status_fonts_contrast]].''
  
−
====pov_baseline_in_meters====
+
'''''Tip: this is the only way to change the default color for dialogue text and subtitles. Just avoid making the system and status fonts the same color and you can recolor all three independently.'''''
−
{{Ex/inival|1.0.0.1|real numbers|adds to the player's eye level -- as of 1.0.0.1 arms are not <b>yet</b> adjusted accordingly}}
 
  
−
<i>pov_baseline_in_meters was originally setup for [[Trismegistus]]. Trismegistus does away with combat elements, and therefore the arm thing funnily enough was not a problem. Nevertheless the arms are an oversight.</i>
+
====lettering_tint====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the in-game text. The default color is dcdcdc. Partial transparency is not supported as of 1.1.1.5. Refer to [[#lettering_contrast]]|color}}
  
−
====*red_flash_tint====
+
''What this actually does is recolor text that is the color of Sword of Moonlight's text. Refer to [[#system_fonts_tint]] and [[#status_fonts_tint]].''
  
−
====sky_ambience_factor====
+
'''''Tip: this is the only way to change the default shadow color for dialogue text and subtitles. Just avoid making the system and status fonts the same color and you can recolor all three independently.'''''
  
−
''Missing as of 1.1.1.5. Will come back eventually.''
+
====npc_shadows_modulation====
 +
{{Ex/inival|1.2.0.8|negative real numbers|scales the opacity of the [[NPC]]-style shadows. By default it is -1 (note: not 1; positive values are reserved for per red, green, blue factors) and if set to 0 the shadows will be invisible &mdash; however DO NOT DO THIS as a way to hide the shadows. Use [[#npc_shadows_multiplier]] instead so that you might benefit your frame rate|real}}
  
−
{{Ex/inival|1.0.0.1|real numbers|colorizes the sky to match the global ambient light at 1}}
+
====npc_shadows_multiplier====
 +
{{Ex/inival|1.2.0.8|positive real numbers|scales the [[NPC]]-style shadows. By default it is 1. To disable these shadows it's correct to set this extension to 0. Refer to [[#player_character_shadow]]|real}}
  
−
====sky_emissive_factor====
+
====npc_shadows_saturation====
 +
{{Ex/inival|1.2.0.8|base 256 identifiers|overrides the color of the [[NPC]]-style shadows. By default it is id(0,0,0) or 0 or black|id}}
  
−
''Missing as of 1.1.1.5. Will come back eventually.''
+
====paneling_opacity_adjustment====
 +
{{Ex/inival|1.2.1.14|real numbers between 0 and 1|adjusts the opacity of the menu paneling. The unadjusted opacity is supplied. Historically this value is always 0.5|real}}
  
−
This extension is planned but not yet implemented. It will brighten the sky above 1 and darkens it below 1. It's meant to balance out the colours produced by [[#sky_ambience_factor]].
+
====red_flash_tint====
 +
{{Ex/inival|1.1.1.5|hexadecimal color codes|replaces the color of the red flash that is triggered by in game events. The default value is ffff0000, or pure red. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear|color}}
  
−
====sky_distance_multiplier====
+
''Sword of Moonlight displays this flash if the player character receives damage in order to elicit a sensation of pain from the player. If interested in modulating this effect, refer first to [[#do_red]].''
−
{{Ex/inival|1.0.0.1|positive real numbers|works like [[#draw_distance_multiplier]], however it only applies to [[SOM_MAP|maps]] with skies. It supersedes '''draw_distance_multiplier'''}}
 
  
−
====sky_fadeline_multiplier====
+
====start_blackout_factor====
−
{{Ex/inival|1.0.0.1|real numbers between 0 and 1|determines a point between the fog saturation distance at 0 and the sky distance at 1 and smoothly blends things beyond that point into the sky. As if the sky is a second layer of fog beyond the first}}
+
{{Ex/inival|1.1.1.5|real numbers|changes the way the title screen options are masked. As the value approaches 1 the transparency effect is replaced by a darkening effect. This is especially useful if the title screen is not a flat color behind the text. Note that as of 1.1.1.5 the title screen elements, pushstart.bmp etc., have black pixels knocked out like every other texture|real}}
  
−
====*start_blackout_factor====
+
''If you are considering your options. It is recommended that you first see if [[#do_start]] is implemented or not (it is not as of 1.1.1.5) and use that if so. It simply uses text in place of images. Text is much less work for translators to deal with. It is not clear how or if start_blackout_factor will interplay with do_start.''
  
−
====*sway_distance_multiplier====
+
====start_tint====
 +
{{Ex/inival|1.1.2.?|hexadecimal color codes|replaces the color of the start menu text or image. Refer to [[#do_start]]|color}}
  
 
</onlyinclude>
 
</onlyinclude>

Latest revision as of 02:26, 16 February 2018

!
 Transcluded by Sword of Moonlight Extension Library / list of extensions.


Restructuring of [Adjust][edit]

The old version of this section is available here[1]. Many extensions changed with SomEx ver. 1.2.0.8.

  • The map setting extensions were combined into the fov_ group and simplified as much as possible.
  • The pc_..._speed_multiplier group was removed. See the #Number section for how to directly set the _WALK, _DASH, and _TURN constants.
  • The sway and bob_..._multiplier extensions were removed along with do_sway. The sway can now be directly set by #player_character_bob2 however bob_frequency_multiplier is still awaiting its replacement.
  • The menu and onscreen display element ..._opacity_multiplier extensions were removed. The ..._opacity_adjustment extensions need to reproduce the math taking into account the incoming opacity values.

abyss_depth[edit]

Introduced around 1.2.0.8, this extension establishes the depth below a map tile that cannot be passed upon penalty of death, ie. game over. By default it is -10. This replaces abyss_event_adjustment. Values are limited to real numbers.[#]

2017 note: Does Som2k work this way? In practice the -10 death point rarely triggers and or may only apply to tile types that are marked as special "pits."

blackened_tint...[edit]

Introduced around 1.1.1.5, this extension replaces the color of the black tint that is a backdrop for text and menus. The default value is 80000000, or half black. Note that there is a second black tint that is applied over the first black tint. Refer to #blackened_tint2. Values are limited to hexadecimal color codes.[#]

blackened_tint2 Introduced around 1.1.1.5, this extension replaces the color of the second layer of black tint. Refer to #blackened_tint. The default value is 64000000, or quarter black. Note that this is the tint that is used by #do_pause when the game is paused. Values are limited to hexadecimal color codes.[#]

blue_flash_tint[edit]

Introduced around 1.1.1.5, this extension replaces the color of the blue flash that is triggered by in game events. The default value is ff0000ff, or pure blue. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear. Values are limited to hexadecimal color codes.[#]

character_identifier[edit]

Introduced around 1.2.1.14, this extension generates custom character identifiers to be used as parameters to other extensions and to be included by pc. This number receives an input (a parameter) that is encoded by id. These are default identifiers. The purpose of this extension is to remap and or combine identifiers.

Historically Sword of Moonlight segregates would-be characters into four classes. These classes are enemy, NPC, object, and PC. Unless this segregation is by some method obliterated, then this extension will receive a two-part number to be decoded by 4096di and 4097di in order to obtain a SOM_PRM item number and character class, respectively. Class number 0 is enemies; 1 NPCs; 2 objects; 3 the PC.

There is a second parameter that is the SOM_MAP content identifier, which may be used to further specialize character identifiers.

The PC's number is 12288, since their item number is 0. In a multi-PC scenario this extension could, for example, take a counter into consideration. Values are limited to real numbers.[#]

fov_fogline_saturation[edit]

Introduced around 1.2.0.8, this extension overrides the color of the level's fog. As of 1.2.0.8 there isn't a way to retrieve the current level's fog parameters, so if this extension is used the fog's color setting in SOM_MAP should be disregarded. Values are limited to base 256 identifiers.[#]

fov_fogline_adjustment...[edit]

Introduced around 1.2.0.8, this extension specifies the beginning and effective end of the fog. When the part after adjustment is omitted, the starting point of the fog is specified in terms of meters. Note that in SOM_MAP this is represented by a fraction of the way to the back of the fog; not so here. The unadjusted value is provided.

fov_fogline_adjustment2 specifies the end point of the fog. If the level does not have a sky/backdrop then the in game scene shall comes to an end at this point. The unadjusted value is provided. This value is equivalent to SOM_MAP's per map visibility setting. Refer to #fov_skyline_adjustment2. Values are limited to positive real numbers.[#]

fov_frustum_multiplier[edit]

Since 1.2.0.8 the default is 1.2. The default will revert back to 1 as soon as this makeshift extension is no longer of general use.

Introduced around 1.1.1.5, this extension multiplies the horizontal angle of what is visible to Sword of Moonlight in game. It can be game dependent, but you may need to increase this (from 1) to create gutters along the sides of the field of vision if you notice map tiles disappearing (along the sides) especially when moving quickly with analog controls. Generally the higher the turn speed the more you might need to lean on this. Note that this is not a fix for problems of this nature in widescreen mode. See #do_fix_fov_in_memory (or #do_fix_any_trivial) in that case. Values are limited to real numbers.[#]

This can also be a means to work with map tiles that have "eaves" far outside of 2x2 meters (the natural size of a single tile) however generally speaking this is not recommended in terms of best practices.

fov_sky_and_fog_minima...[edit]

Introduced around 1.2.0.8, this extension is expressed as a fraction of the end of both the fog and the sky/backdrop so that it should cover the same amount of pixels at any given distance. By default it is 0.025 and cannot be made less that this. This is to ensure that there is always a soft transition where the end of the fog and sky blend into the scenery. The sky transition is dependent upon #do_alphafog, which is also enabled by #do_fog. Values are limited to real numbers between 0.025 and 1.[#]

fov_sky_and_fog_minima2
Introduced around 1.2.0.10, this extension is available to set the fog minimum independent of the sky/backdrop minimum. If not explicitly set, it is identical to #fov_sky_and_fog_minima. Values are limited to real numbers between 0.025 and 1.[#]

fov_sky_and_fog_powers...[edit]

Introduced around 1.2.0.10, this extension exponentiates the sky/backdrop and fog. By default it is 1, or linear. Values around 0.5, or the square root, produce a sharp cutoff along the fog horizon, and so are not recommended. Values above 1 create an ever thicker fog. At present this extension must be set to a constant value, and so values between 0.75 and 1.5 are recommended. Furthermore it only applies to per pixel fog using the recommended custom Sword of Moonlight "shaders". Since 1.2.1.8 the fog exponent can be set independently of the sky/backdrop's with fov_sky_and_fog_powers2. (1.2.1.8 corrects a bug that reversed the values in the "shader.") If it is not explicitly set it is identical to #fov_sky_and_fog_power. Values are limited to positive real numbers.[#]

fov_skyline_adjustment...[edit]

Introduced around 1.2.0.8, this extension specifies the beginning and effective end of the sky. When the part after adjustment is omitted, the starting point of the sky is specified in terms of meters. The unadjusted value is provided. Note that by default the start of the sky is equal to the end of the sky.

fov_skyline_adjustment2 specifies the end point of the sky. If the level does not have a sky/backdrop both fov_skyline_adjustment and fov_skyline_adjustment2 should be disregarded. Otherwise #fov_fogline_adjustment2 cannot be greater than fov_skyline_adjustment2 and so will be scaled back if necessary. Refer to #fov_sky_and_fog_minima. Values are limited to positive real numbers.[#]

green_flash_tint[edit]

Introduced around 1.1.1.5, this extension replaces the color of the green flash that is triggered by in game events. The default value is ff00ff00, or pure green. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component, but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear. Values are limited to hexadecimal color codes.[#]

highlight_opacity_adjustment[edit]

Introduced around 1.2.0.8, this extension adjusts the opacity of the flashing menu paneling. The unadjusted opacity is supplied. Values are limited to real numbers between 0.06 and 1.[#]

hud_gauge_depleted_half_tint[edit]

Introduced around 1.1.1.5, this extension replaces the color of the gauges when emptied. The default is unspecified, as of 1.1.1.5 it is 55808080. To emulate Sword of Moonlight you can use a value of 00 to make only the filled portions of the gauges visible. Values are limited to hexadecimal color codes.[#]

The depleted gauges were needed by #do_st to emulate Shadow Tower. It is simpler to just leave them as a permanent fixture. Plus it just looks nice.

hud_gauge_opacity_adjustment[edit]

Introduced around 1.2.0.8, this extension adjusts the opacity of the HUD (heads up display) gauges. Note that the emptied halves of the gauges are unaffected. Refer to #hud_gauge_depleted_half_tint. The unadjusted opacity is supplied. Values are limited to real numbers between 0 and 1.[#]

lettering_contrast[edit]

Introduced around 1.1.1.5, this extension replaces the color of the in-game text's "shadows". The default color is 464646. Partial transparency is not supported as of 1.1.1.5. Refer to #lettering_tint. Values are limited to hexadecimal color codes.[#]

What this actually does is recolor text that is the color of Sword of Moonlight's shadows. Refer to #system_fonts_contrast and #status_fonts_contrast.

Tip: this is the only way to change the default color for dialogue text and subtitles. Just avoid making the system and status fonts the same color and you can recolor all three independently.

lettering_tint[edit]

Introduced around 1.1.1.5, this extension replaces the color of the in-game text. The default color is dcdcdc. Partial transparency is not supported as of 1.1.1.5. Refer to #lettering_contrast. Values are limited to hexadecimal color codes.[#]

What this actually does is recolor text that is the color of Sword of Moonlight's text. Refer to #system_fonts_tint and #status_fonts_tint.

Tip: this is the only way to change the default shadow color for dialogue text and subtitles. Just avoid making the system and status fonts the same color and you can recolor all three independently.

npc_shadows_modulation[edit]

Introduced around 1.2.0.8, this extension scales the opacity of the NPC-style shadows. By default it is -1 (note: not 1; positive values are reserved for per red, green, blue factors) and if set to 0 the shadows will be invisible — however DO NOT DO THIS as a way to hide the shadows. Use #npc_shadows_multiplier instead so that you might benefit your frame rate. Values are limited to negative real numbers.[#]

npc_shadows_multiplier[edit]

Introduced around 1.2.0.8, this extension scales the NPC-style shadows. By default it is 1. To disable these shadows it's correct to set this extension to 0. Refer to #player_character_shadow. Values are limited to positive real numbers.[#]

npc_shadows_saturation[edit]

Introduced around 1.2.0.8, this extension overrides the color of the NPC-style shadows. By default it is id(0,0,0) or 0 or black. Values are limited to base 256 identifiers.[#]

paneling_opacity_adjustment[edit]

Introduced around 1.2.1.14, this extension adjusts the opacity of the menu paneling. The unadjusted opacity is supplied. Historically this value is always 0.5. Values are limited to real numbers between 0 and 1.[#]

red_flash_tint[edit]

Introduced around 1.1.1.5, this extension replaces the color of the red flash that is triggered by in game events. The default value is ffff0000, or pure red. Note that the flash begins fully opaque and then tails off. The blending mode is not based on the alpha component but the color is divided by the alpha component as a courtesy, and if the color is fully transparent, the flash will not appear. Values are limited to hexadecimal color codes.[#]

Sword of Moonlight displays this flash if the player character receives damage in order to elicit a sensation of pain from the player. If interested in modulating this effect, refer first to #do_red.

start_blackout_factor[edit]

Introduced around 1.1.1.5, this extension changes the way the title screen options are masked. As the value approaches 1 the transparency effect is replaced by a darkening effect. This is especially useful if the title screen is not a flat color behind the text. Note that as of 1.1.1.5 the title screen elements, pushstart.bmp etc., have black pixels knocked out like every other texture. Values are limited to real numbers.[#]

If you are considering your options. It is recommended that you first see if #do_start is implemented or not (it is not as of 1.1.1.5) and use that if so. It simply uses text in place of images. Text is much less work for translators to deal with. It is not clear how or if start_blackout_factor will interplay with do_start.

start_tint[edit]

Introduced around 1.1.2.?, this extension replaces the color of the start menu text or image. Refer to #do_start. Values are limited to hexadecimal color codes.[#]


Retrieved from "http://en.swordofmoonlight.org/w/index.php?title=Sword_of_Moonlight_Extension_Library/adjust_extensions&oldid=2622"