OCS Smolensk - Extended Functionality

<h1>OCS Smolensk - Extended Functionality</h1>
This version of the module adds the Extended Funtionality template to the standard OCS module.

<h2>1. Combat Units</h2>
<h3>Mode</H3> 
There are two changes related to the mode menu:
<ul>
<li>Move Mode - a unit in Move mode has a white/black box displayed around the unit's Movement Allowance
<li>Reserve Mode - use Ctrl-R to place a Reserve Marker; if the menu option is greyed out, then there are no reserve markers available in the holding box
</ul>
<h3>Multi-Step Units</h3>

<h4>Step Losses</h4>
Step losses for multi-step units are controlled from the unit, using the 'Lose Step' (Ctrl-Z) and 'Gain Step' (Ctrl-X) menu options. These are greyed out when not applicable. (e.g. a full strength unit cannot gain a step) The  unit step losses are shown in the currently selected display style when the unit gains or loses a step.

<h4>Display Options</h4>
Step losses can be displayed either as a Step Loss marker (default style) or as text at the left side of the unit. This allows for enhanced Fog of War as the text does not change the stack size. Use the menu option 'Display Loss as Step Loss Marker/Text' to toggle between the two display styles. When the display style is changed the appropriate deathhead marker or text is shown.
<p>
When the step loss marker display style is selected, a marker is automatically placed, increased, reduced, or removed as the unit loses or gains steps. Any newly placed step loss marker retains the Masked status of the unit.
<p>
If a step loss marker gets separated from the owning unit, then use the menu option 'Send to Owner' (Alt-B) to return it to the owning unit. 
<p>
When the text display style is selected, the step losses are displayed at the left side of the counter in red text in a white box. 
<p>
The text can be shown or hidden with the 'Show/Hide Step Loss Text' menu option. The text will display when the unit has lost 0 steps, and will only be removed when the 'Show/Hide' option is changed to Hide or the style is changed to step loss marker. The default setting is 'Show'. (Note that there is no visual indication that a unit has lost steps but the text is currently hidden.)
<p>
For those seeking increased Fog Of War there is also the ability to place a 0-step loss marker. This is only available when the display style is set to step loss marker and the unit has not yet lost a step. Note that if a 0-step loss marker is placed and the unit loses and regains a step, then the 0-step loss marker is not replaced. 
<h3>Combat</h3>
The menu options for placing Combat Markers and sending the unit to the dead pile or holding box are now in a separate 'Combat' sub-menu. Using the key-combo Ctrl-P will send the unit to the correct location.

<h4>Combat Markers</h4>
Combat units have the following menu options in the Combat Markers sub-menu:
<ul>
<li>Place Combat ID (Alt-C) - place a Combat ID marker on the stack
<li>Place Combat Arrow (Alt-W) - place a Combat Arrow on the stack
<li>AR unit (Alt-R) - places a black/yellow circle around the Action Rating to indicate this is the AR Unit in the combat (If multiple units are marked, then the topmost unit is used.)
<li>Unsupplied/Not attacking (Alt-N) - places a white/red 'X' on the unit's combat factor to indicate the unit is not supplied for this combat (for the defender) or is not participating in the combat (for the attacker); Not attacking markers are not required for defense-only units in an attacking stack (e.g. HQs)
</ul>
<h3>Miscellaneous</h3>
This menu now contains all other options related to the unit.

<h2>2. Non-Combat Units</h2>
Non-combat Units now have a sub-menu at the top of the right-click menu with specific options for that type.
<h3>Hedgehog</h3>
The Hedgehog menu has options to change the hedgehog level, size of the marker (Alt-X) and the style (Alt-Shift-X).
<h3>Supply Point</h3>
The Supply sub-menu has additional menu options. For Spend/Add it reduces/increases the current marker or places additional markers as required. (e.g. if a 10SP marker spends 1T, it will be replaced by a 5SP, a 4SP, and a 3T marker.) If the verbose option for supply is currently On, then the add/spend will be reported to the log.
<h4>Add supply</h4>
<ul>
<li>Add 1T - Alt-Shift-1 
<li>Add 2T - Alt-Shift-2 
<li>Add 3T - Alt-Shift-3
<li>Add 1SP - Alt-Shift-4
</ul>
<h4>Spend supply</h4>
<ul>
<li>Spend 1T - Ctrl-Shift-1 
<li>Spend 2T - Ctrl-Shift-2 
<li>Spend 3T - Ctrl-Shift-3
<li>Spend 1SP - Ctrl-Shift-4
</ul>
<h4>Combine supply markers - Ctrl-B</h4>
This combines all the supply markers in the current location into the fewest markers.
<h3>Transport</h3>
A Tranport unit has additional options and sub-menus on the Transport sub-menu.  If the verbose option for transport is currently On, then the Load/Use/Unload will be reported to the log.
<h4>Empty</h4>
Empty (Alt-F) removes any fill level from the transport.
<h4>Load supply</h4>
This option loads the transport from any exisitng Supply in the hex, reducing the supply markers. If there is no or inadequate supply in the hex, then a message will be output to the log window. Note that a multi-SP transport can either load 1-3T or Full capacity and it can't 'top up' to Full capacity when already loaded with 1-3T, it would have to Unload first.
<ul>
<li>Load 1T - Alt-Shift-1 
<li>Load 2T - Alt-Shift-2 
<li>Load 3T - Alt-Shift-3
<li>Load 'F' - Alt-Shift-4
</ul>
<h4>Use supply</h4>
This option reduces the supply on the transport.
<ul>
<li>Use 1T - Ctrl-Shift-1 
<li>Use 2T - Ctrl-Shift-2 
<li>Use 3T - Ctrl-Shift-3
<li>Use 'F' - Ctrl-Shift-4
</ul>
<h4>Unload supply</h4>
This option unloads the supply from the transport and creates a supply point counter in the hex. It does not validate that the unloading requirements of 13.2f are met.
<ul>
<li>Unload 1T - Alt-Ctrl-Shift-1 
<li>Unload 2T - Alt-Ctrl-Shift-2 
<li>Unload 3T - Alt-Ctrl-Shift-3
<li>Unload 'F' - Alt-Ctrl-Shift-4
</ul>

<h2>3. Air Units</h2>
A reduced air unit has a white/black box shown around the unit's barrage strength.

<h2>4. Markers</h2>
Markers now have a sub-menu at the top of the right-click menu with specific options for the marker.

<h3>DG</h3>
The menu has options to change the size of the marker (Alt-X).
<h3>Exploit</h3>
The menu has options to change the Exploit AR  level and size of the marker (Alt-X).

<h3>Reserve</h3>
Reserve markers should be placed in the color of the owning unit, but may be changed.
<h3>Strategic Movement</h3>
The menu has options to change the size of the marker (Alt-X).
 
<h3>Combat</h3>

Combat markers may be used to indicate the units involved in a combat. The Combat Markers palette is opened by clicking on the yellow '3:1' button on the log window toolbar. The types of marker are:
<ul>
<li>Combat Arrow - place on an attacking stack; use the Ctrl-[ and Ctrl-] key combinations to rotate the arrow to point towards the defending hex
<li>Combat ID - place on the defending/target hex; use the Ctrl-Z or Ctrl-X key combinations to increase or decrease the ID letter
<li>Odds - place a marker to indicate the calculated odds for the combat; use the Ctrl-Z or Ctrl-X key combinations to increase or decrease the value
<li>Surprise - place a marker to indicate the surprise modifier for the combat; use the Ctrl-Z or Ctrl-X key combinations to increase or decrease the value (note that it has a red outline)
<li>Modifier - place a marker to indicate the combat modifier for the combat; use the Ctrl-Z or Ctrl-X key combinations to increase or decrease the value
<li>Result - place a marker to indicate the result for the combat
</ul>
Combat markers and unit flags are removed by using the yellow button with the red 'X' on the log window toolbar. Alternatively, use the Ctrl-Shift-D key combination to removed selected combat markers.

<h2>5. Combat Calculation</h2>
Once the Combat ID and Combat Arrow(s) are placed on the defending and attacking stack(s), then the  'Perform Combat' (Ctrl-C) or 'Perform Overrun' (Ctrl-O) menu options on the Combat ID marker can be used to evaluate the combat. This reports the attacking and defending strengths, the combat ratio, and the CRT Line. (Note that the Combat Arrow(s) must point towards the appropriate Combat ID to be included in the combat.)
<p>
If AR units are marked for both attacker and defender, then the full combat result will be calculated and appropriate combat markers placed. 
<p>
The calculation takes account of modes, step losses, hex and hex-side terrain, hedgehogs, AT level, and supply status, based on the current stack position of the unit(s) and (marker(s). If the verbose option for combat is currently On, then the combat detail will be reported to the log.

<p>
For an Overrun, the combat calculation determines which units are permitted to overrun given the terrain in the target hex, attacking hex, and hexsides, and any Interdiction/Train Busting markers. If the verbose options for combat is currently On, then it will report any units that are not permitted to overrun. (e.g. Track units are not permitted to overrun into/from a Swamp hex.)
<p>
This may take several seconds to calculate, depending on the module size, number of units involved in the combat, and the performance level of the host system.
<p>
Note that Combat Calculation cannot include Masked units from the opposing side. (This is normal Vassal Masking behavior which cannot be overridden.) All participating units must be Unmasked prior to executing the combat. (If the defender is executing the Combat Calculation, then attacking units may be left Masked rather than being marked as 'Not Attacking', the effect will be the same.)

<h2>6. Barrage Calculation</h2>
To calculate an artillery, air, or naval barrage, place a Combat ID on the target hex then select the 'Perform Barrage' (Ctrl-B) menu option on the Combat ID marker. This will present 3 prompts:
<ul>
<li>Select initial barrage strength - use the drop-down list to select the total strength of the barraging unit(s); do not apply any barrage table modifiers to this strength
<li>Correct spotter? - If there is a correct spotter per 10.0b, then select 'Yes', otherwise select 'No'
<li>Air barrage and aircraft at/within 10 hexes of base? - if this is an air barrage and the aircraft are at/within 10 hexes of base per 14.7c, then select 'Yes'; for an artillery barrage, naval barrage, or an air barrage greater than 10 hexes from base select 'No'
</ul>
At any time use the 'Cancel' button to abort the barrage calculation process.
<p>
Once all prompts are answered the barrage calculation will be completed, and the result reported showing the initial column, modifiers applied, final column, dice roll, and result.
<p>
If the verbose option for combat is currently On, then the barrage detail will be reported to the log.
<p>
Note that if the Barrage Calculation is executed by the barraging player, then any Masked units in the target hex will not be included in the density calculation.

<h2>7. Verbose Output</h2>
A more detailed output is available for the following items:
<ul>
<li>Combat/Barrrage - details the game pieces, markers, terrain, and modifiers that impact the combat or barrage calculation
<li>Supply - reports the Add/Spend actions
<li>Transport - reports the Load/Use/Unload actions
</ul>
The latter two may be useful to newer players or those less concerned about fog of war. Experienced players will probably want Verbose output turned off.
<p>
These may be toggled on/off using the appropriate selection on the "Verbose" toolbar dropdown, which also shows the current status.

<h2>8. Sequence of Play</h2>
A Sequence of Play reminder is available in the toolbar. This can either be displayed as a separate window, using the 'SoP' button, or docked in the toolbar. (This is changed in the module Preferences, 'Turn Counter' tab, using the 'Dock into toolbar' checkbox.) 1st player actions are in red, 2nd player actions are in blue, and common actions are in black.
<h2>9. Dice Buttons</h2>
The '2d6' and '2d6+1d6' dice buttons now report the total 2d6 roll.
<h2>10. Guderian & Hoth</h2>
Per Smolensk 3.4b, Axis supply can be assigned to Guderian or Hoth by using the 'Switch Ownership' (Ctrl-G) option on the 'Supply' menu of the supply marker. This shows a 'G' or 'H'.