Skip to content

Commit ed80ad6

Browse files
CsantucciCsantucci
committed
1 parent 962630f commit ed80ad6

File tree

6 files changed

+129
-25
lines changed

6 files changed

+129
-25
lines changed

‎Source/Documentation/Manual/cabs.rst

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -347,6 +347,60 @@ ORTS_SIGNED_TRACTION_BRAKING, with the only difference that the braking
347347
force does include also the train brake force in addition to the dynamic
348348
brake force.
349349

350+
Odometer controls
351+
-----------------
352+
353+
Following cabview controls are available:
354+
355+
356+
- ORTS_ODOMETER: used to digitally display the odometer value
357+
- ORTS_ODOMETER_RESET: used to reset the odometer
358+
- ORTS_ODOMETER_DIRECTION_CHANGE: used to change direction (up/down) of the odometer.
359+
360+
Following units of measure are available for ORTS_ODOMETER:
361+
362+
- KILOMETRES
363+
- METRES
364+
- MILES
365+
- FEET
366+
- YARDS
367+
368+
The operation of the odometer is explained :ref:`here <driving-odometer>`.
369+
370+
Here is an example of use of the odometer control blocks within a .cvf file::
371+
372+
TwoState (
373+
Type ( ORTS_ODOMETER_RESET TWO_STATE )
374+
Position ( 320 70 24 22 )
375+
Graphic ( OdoResetButton.ace )
376+
NumFrames ( 2 2 1 )
377+
Style ( WHILE_PRESSED )
378+
MouseControl ( 1 )
379+
)
380+
TwoState (
381+
Type ( ORTS_ODOMETER_DIRECTION )
382+
Position ( 320 100 13 15 )
383+
Graphic ( OdoDirectionSwitch.ace )
384+
NumFrames ( 2 2 1 )
385+
Style ( ONOFF )
386+
MouseControl ( 1 )
387+
)
388+
Digital (
389+
Type ( ORTS_ODOMETER )
390+
Position ( 377 100 26 17 )
391+
ScaleRange ( 0 100000 )
392+
Accuracy ( 0 )
393+
AccuracySwitch ( 0 )
394+
LeadingZeros ( 0 )
395+
Justification ( 1 )
396+
PositiveColour ( 1
397+
ControlColour ( 255 255 255 )
398+
)
399+
NegativeColour ( 0 )
400+
DecreaseColour ( 0 )
401+
Units ( FEET )
402+
)
403+
350404
Animated 2D Wipers
351405
------------------
352406

‎Source/Documentation/Manual/driving.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -564,6 +564,7 @@ camera's direction together with its latitude and longitude.
564564
To activate the compass window press the ``<0>`` key. To deactivate the
565565
compass window, press the ``<0>`` key a second time.
566566

567+
.. _driving-odometer:
567568

568569
Odometer
569570
--------
@@ -583,6 +584,9 @@ as the front of the train passes a location, then when it reaches zero you
583584
will know, without switching views, that the other end of the train has
584585
just reached the same point, e.g. the entrance to a siding, etc.
585586

587+
The odometer can be accessed also through cabview controls, if they are defined
588+
within the cabview.
589+
586590

587591
.. |uarr| unicode:: U+02191 .. UPWARDS ARROW
588592
.. |darr| unicode:: U+02193 .. DOWNWARDS ARROW

‎Source/Orts.Formats.Msts/CabViewFile.cs

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -253,6 +253,9 @@ public enum CABViewControlTypes
253253
ORTS_TCS47,
254254
ORTS_TCS48,
255255
ORTS_ETCS,
256+
ORTS_ODOMETER,
257+
ORTS_ODOMETER_RESET,
258+
ORTS_ODOMETER_DIRECTION,
256259

257260
// Further CabViewControlTypes must be added above this line, to avoid their malfunction in 3DCabs
258261
EXTERNALWIPERS,
@@ -310,7 +313,13 @@ public enum CABViewControlUnits
310313
INCHES_OF_MERCURY,
311314
MILI_AMPS,
312315
RPM,
313-
LBS
316+
LBS,
317+
318+
KILOMETRES,
319+
METRES,
320+
MILES,
321+
FEET,
322+
YARDS
314323
}
315324

316325
public enum DiscreteStates

‎Source/Orts.Simulation/Common/Commands.cs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1608,19 +1608,19 @@ public override string ToString()
16081608
}
16091609

16101610
[Serializable()]
1611-
public sealed class ResetOdometerCommand : Command
1611+
public sealed class ResetOdometerCommand : BooleanCommand
16121612
{
16131613
public static MSTSLocomotive Receiver { get; set; }
16141614

1615-
public ResetOdometerCommand(CommandLog log)
1616-
: base(log)
1615+
public ResetOdometerCommand(CommandLog log, bool toState)
1616+
: base(log, toState)
16171617
{
16181618
Redo();
16191619
}
16201620

16211621
public override void Redo()
16221622
{
1623-
Receiver.OdometerReset();
1623+
Receiver.OdometerReset(ToState);
16241624
// Report();
16251625
}
16261626

‎Source/Orts.Simulation/Simulation/RollingStocks/MSTSLocomotive.cs

Lines changed: 51 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -313,6 +313,7 @@ public bool LargeEjectorSoundOn
313313
protected float OdometerResetPositionM = 0;
314314
protected bool OdometerCountingUp = true;
315315
protected bool OdometerCountingForwards = true;
316+
public bool OdometerResetButtonPressed = false;
316317

317318
public bool OdometerVisible { get; private set; }
318319
public float OdometerM
@@ -4059,32 +4060,35 @@ public void OdometerToggle()
40594060
/// Set odometer reference distance to actual travelled distance,
40604061
/// and set measuring direction to the actual direction
40614062
/// </summary>
4062-
public void OdometerReset()
4063+
public void OdometerReset(bool toState)
40634064
{
40644065
if (Train == null)
40654066
return;
4066-
4067-
if (OdometerCountingForwards != OdometerCountingUp ^ (Direction == Direction.Reverse))
4067+
if (toState)
40684068
{
4069-
OdometerCountingForwards = !OdometerCountingForwards;
4070-
}
4069+
if (OdometerCountingForwards != OdometerCountingUp ^ (Direction == Direction.Reverse))
4070+
{
4071+
OdometerCountingForwards = !OdometerCountingForwards;
4072+
}
40714073

4072-
if (Direction == Direction.Reverse)
4073-
{
4074-
if (OdometerCountingForwards)
4075-
OdometerResetPositionM = Train.DistanceTravelledM - Train.Length;
4076-
else
4077-
OdometerResetPositionM = Train.DistanceTravelledM;
4078-
}
4079-
else
4080-
{
4081-
if (OdometerCountingForwards)
4082-
OdometerResetPositionM = Train.DistanceTravelledM;
4074+
if (Direction == Direction.Reverse)
4075+
{
4076+
if (OdometerCountingForwards)
4077+
OdometerResetPositionM = Train.DistanceTravelledM - Train.Length;
4078+
else
4079+
OdometerResetPositionM = Train.DistanceTravelledM;
4080+
}
40834081
else
4084-
OdometerResetPositionM = Train.DistanceTravelledM + Train.Length;
4085-
}
4082+
{
4083+
if (OdometerCountingForwards)
4084+
OdometerResetPositionM = Train.DistanceTravelledM;
4085+
else
4086+
OdometerResetPositionM = Train.DistanceTravelledM + Train.Length;
4087+
}
40864088

4087-
Simulator.Confirmer.Confirm(CabControl.Odometer, CabSetting.On);
4089+
Simulator.Confirmer.Confirm(CabControl.Odometer, CabSetting.On);
4090+
}
4091+
OdometerResetButtonPressed = toState;
40884092
}
40894093

40904094
public void OdometerToggleDirection()
@@ -5023,6 +5027,34 @@ public virtual float GetDataOf(CabViewControl cvc)
50235027
data = LocomotivePowerSupply.ElectricTrainSupplyOn ? 1 : 0;
50245028
break;
50255029

5030+
case CABViewControlTypes.ORTS_ODOMETER:
5031+
switch (cvc.Units)
5032+
{
5033+
case CABViewControlUnits.KILOMETRES:
5034+
data = float.Parse(Math.Round(OdometerM / 1000, 0).ToString());
5035+
break;
5036+
case CABViewControlUnits.MILES:
5037+
data = (float)Math.Round(Me.ToMi(OdometerM), 0);
5038+
break;
5039+
case CABViewControlUnits.FEET:
5040+
data = (float)Math.Round(Me.ToFt(OdometerM), 0);
5041+
break;
5042+
case CABViewControlUnits.YARDS:
5043+
data = (float)Math.Round(Me.ToYd(OdometerM), 0);
5044+
break;
5045+
case CABViewControlUnits.METRES:
5046+
default:
5047+
data = OdometerM;
5048+
break;
5049+
}
5050+
break;
5051+
case CABViewControlTypes.ORTS_ODOMETER_DIRECTION:
5052+
data = OdometerCountingUp ? 1 : 0;
5053+
break;
5054+
case CABViewControlTypes.ORTS_ODOMETER_RESET:
5055+
data = OdometerResetButtonPressed ? 1 : 0;
5056+
break;
5057+
50265058
default:
50275059
{
50285060
data = 0;

‎Source/RunActivity/Viewer3D/RollingStock/MSTSLocomotiveViewer.cs

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ public override void InitializeUserInputCommands()
176176
UserInputCommands.Add(UserCommand.ControlImmediateRefill, new Action[] { () => StopImmediateRefilling(Viewer.Log), () => ImmediateRefill() });
177177
UserInputCommands.Add(UserCommand.ControlWaterScoop, new Action[] { Noop, () => new ToggleWaterScoopCommand(Viewer.Log) });
178178
UserInputCommands.Add(UserCommand.ControlOdoMeterShowHide, new Action[] { Noop, () => new ToggleOdometerCommand(Viewer.Log) });
179-
UserInputCommands.Add(UserCommand.ControlOdoMeterReset, new Action[] { Noop, () => new ResetOdometerCommand(Viewer.Log) });
179+
UserInputCommands.Add(UserCommand.ControlOdoMeterReset, new Action[] { () => new ResetOdometerCommand(Viewer.Log, false), () => new ResetOdometerCommand(Viewer.Log, true) });
180180
UserInputCommands.Add(UserCommand.ControlOdoMeterDirection, new Action[] { Noop, () => new ToggleOdometerDirectionCommand(Viewer.Log) });
181181
UserInputCommands.Add(UserCommand.ControlCabRadio, new Action[] { Noop, () => new CabRadioCommand(Viewer.Log, !Locomotive.CabRadioOn) });
182182
UserInputCommands.Add(UserCommand.ControlDieselHelper, new Action[] { Noop, () => new ToggleHelpersEngineCommand(Viewer.Log) });
@@ -2041,6 +2041,8 @@ public int GetDrawIndex()
20412041
case CABViewControlTypes.ORTS_SERVICE_RETENTION_CANCELLATION_BUTTON:
20422042
case CABViewControlTypes.ORTS_ELECTRIC_TRAIN_SUPPLY_COMMAND_SWITCH:
20432043
case CABViewControlTypes.ORTS_ELECTRIC_TRAIN_SUPPLY_ON:
2044+
case CABViewControlTypes.ORTS_ODOMETER_DIRECTION:
2045+
case CABViewControlTypes.ORTS_ODOMETER_RESET:
20442046
index = (int)data;
20452047
break;
20462048

@@ -2284,6 +2286,9 @@ public void HandleUserInput()
22842286
case CABViewControlTypes.ORTS_ELECTRIC_TRAIN_SUPPLY_COMMAND_SWITCH:
22852287
new ElectricTrainSupplyCommand(Viewer.Log, ChangedValue(Locomotive.LocomotivePowerSupply.ElectricTrainSupplySwitch.CommandSwitch ? 1 : 0) > 0);
22862288
break;
2289+
case CABViewControlTypes.ORTS_ODOMETER_DIRECTION: if (ChangedValue(1) == 0) new ToggleOdometerDirectionCommand(Viewer.Log); break;
2290+
case CABViewControlTypes.ORTS_ODOMETER_RESET:
2291+
new ResetOdometerCommand(Viewer.Log, ChangedValue(Locomotive.OdometerResetButtonPressed ? 1 : 0) > 0); break;
22872292

22882293
// Train Control System controls
22892294
case CABViewControlTypes.ORTS_TCS1:

0 commit comments

Comments
 (0)