eolesen, on 13 March 2017 - 03:32 AM, said:
I'm assuming there will be sub-options, i.e. ability to disconnect the last Y number of cars, or break the consist after consist ID# X?
The list below shows the options available for the detach command. Some of these are also available for the transfer command, but others make no sense for transfer, i.e. if 'give' is set for transfer (units are transfered from this train to the other train), there is no use to define anything which relates to the rear of the train - it's clearly not possible to transfer units from the rear of the approaching train to the waiting train, those units would have to jump over the rest of the train to get there.
Consist ID numbers are not available for detach nor transfer commands - that is because these numbers are generated automatically using the train's sequence number, but this number is not readily available to the user. It cannot be set by the user, it is simply the sequence in which trains are read from the timetable files.
Here is the list :
- unit : no. of units; if positive, units are detached at the front of the train, negative number defines units detached at the rear
- leadingpower : front engine of the train
- allleadingpower : all power units at the front of the train
- trailingpower : rear engine of the train
- alltrailingpower : all power units at the rear of the train
The following options should only be used if there are power units at one end of the train only, otherwise things may not go as intended :
- power : all power units are detached - the program will detect at which end the power units are located
- nonpower : as above, except the power units will continue as defined, the rest is detached
Finally, there is another interesting option but it should be used with care.
As known, consists in timetables can be defined as a combination of multiple parts, e.g. "loco + wagons".
These consist parts can be references in detach and transfer commands as definition of what is to be detached or transfered.
But - the train may not be formed of the consist (or consist parts) as defined for that train.
When a train is created (using $create or $static), the name of the consist(s) will be set for all units in that train, and these units will keep that name troughout their entire 'live' - regardless of any actions on that train. Any consist definition for a train which is $formed out of another train, or which is formed through a $detach command, will be ignored as the new train will inherit the consist definition from the train out of which is was created.
If 'pools' are used, then of course there is no knowing of what train will be made available, and unless all trains in that pool will always have the same consist, the use of the consist option for detach and transfer should not be used in combination with pools.
Regards,
Rob Roeterdink