|
|
| Line 1: |
Line 1: |
| − | These are examples of solutions for common and simple obsolete Trainzscript functions. This is not an exhaustive list. Solutions for more complex obsolete functions can be found (TBD).
| + | test space only |
| − | | + | |
| − | =class Train=
| + | |
| − | | + | |
| − | ==GetVelocity()==
| + | |
| − | | + | |
| − | GetVelocity obsolete error or warning: <kuid:0000:0000> : VE267: somescript.gs(299) : function GetVelocity is obsolete in object Train.
| + | |
| − | | + | |
| − | | + | |
| − | '''Repair'''
| + | |
| − | | + | |
| − | You have two replacement options in the Train class (train.gs):
| + | |
| − | | + | |
| − | | + | |
| − | ''float GetSmoothedVelocity(void);''
| + | |
| − | | + | |
| − | This function return the train's velocity in metres per second and is suitable for human viewing such as a cab display.
| + | |
| − | | + | |
| − |
| + | |
| − | ''float GetTrainVelocity(void);''
| + | |
| − |
| + | |
| − | This function provides the instantaneous velocity for vehicles in this train, which is good for physics calculations but not good for human-readable display.<br><br>
| + | |
| − |
| + | |
| − | '''Usage example:'''
| + | |
| − | | + | |
| − | float mySpeed;
| + | |
| − | mySpeed = GetSmoothedVelocity(); // this is the more likely option but depends on what the overall script is trying to do.
| + | |
| − |
| + | |
| − | // or the more accurate version
| + | |
| − | mySpeed = GetTrainVelocity();
| + | |
| − |
| + | |
| − | =class Vehicle=
| + | |
| − | | + | |
| − | ==GetFacingRelativeToTrain()==
| + | |
| − | | + | |
| − | ???GetFacingRelativeToTrain obsolete error or warning: <kuid:0000:0000> : VE267: somescript.gs(450) : function GetFacingRelativeToTrain is obsolete in object Vehicle.
| + | |
| − | | + | |
| − | | + | |
| − | '''Repair'''
| + | |
| − | | + | |
| − | You have one replacement option in the Vehicle class (vehicle.gs):
| + | |
| − | | + | |
| − | | + | |
| − | ''bool GetDirectionRelativeToTrain(void);''
| + | |
| − | | + | |
| − | This function returns true if the vehicle faces the same way as the Train, false otherwise. This function is a bit tricky to understand and especially when a vehicle, such as a coach/carriage, is involved.
| + | |
| − |
| + | |
| − | '''Usage example1:'''
| + | |
| − | | + | |
| − | Vehicle myVehicle;
| + | |
| − | bool sameDirectionAsTrain;
| + | |
| − |
| + | |
| − | sameDirectionAsTrain = GetDirectionRelativeToTrain();
| + | |
| − |
| + | |
| − | '''Usage example2:'''
| + | |
| − | | + | |
| − | Vehicle[] trainVehicles;
| + | |
| − | Vehicle myVehicle;
| + | |
| − | bool sameDirectionAsTrain;
| + | |
| − | int i;
| + | |
| − |
| + | |
| − | trainVehicles = GetMyTrain().GetVehicles();
| + | |
| − |
| + | |
| − | if (trainVehicles) { //unlikely to be null but ...
| + | |
| − |
| + | |
| − | for (i = 0; i < trainVehicles.size(); ++i) {
| + | |
| − | //get direction of this vehicle in the train
| + | |
| − | sameDirectionAsTrain = trainVehicles[i].GetDirectionRelativeToTrain();
| + | |
| − | if (sameDirectionAsTrain) {
| + | |
| − | // do what is necessary here
| + | |
| − | Interface.Print("Vehicle "+ (i+1) + " is facing forward"); // add 1 so that the first vehicle is number 1 and not 0 (zero)
| + | |
| − | } else {
| + | |
| − | Interface.Print("Vehicle "+ (i+1) + " is facing backwards");
| + | |
| − | }
| + | |
| − | }
| + | |
| − |
| + | |
| − | }
| + | |
