Tutorial: Destination Display

This page is a tutorial about customization of destination displays / destination blinds / location indicator /EDS in game.

*For the introduction of default Destination Displays ingame, please visit Destination Display.*

*For the list of default Destination Displays data, please visit List: Destination Display.*

## Behaviour

Destination displays in PBS are divided in a few categories. They are used on different vehicles based on the settings of the model. The behaviours of displays are identical across platforms.

### Operating

When the vehicle battery is on, the destination displays will start displaying / switching. Electronic types displays only switches on when vehicle battery is on, while non-electric (static) types stays even when battery is off.

Destination displays will, by default, display the input from the map routes. This is normally set by map makers, including the game produced ones. When changing the route ingame, regardless the selection of moving the vehicle or in use of custom displays, all destination displays will automatically be transformed to default displays of new selected route. Despite ***this action overrides custom displays***, the order of custom display still remains as original.

> *For example, if you selected custom display 7, and then you selected a new built-in route, the displays shown will be switched to new default data, but the order of custom display still remains the same at 7. By then if you press "+" button once, it will display the custom display data 8 instead of 0. If you want to return to default display without selecting new route, you need to change the order back to "-1".*
>
>

Some routes on certain maps do not have displays set for some / all kinds of displays, especially on test maps. The displays will show white when selected the given routes. Custom displays will still be operational under these circumstances.

### Use on Vehicles

There is no limitation to uses of destination displays on vehicles. A vehicle can use any type of destional display in any amount, or none at all. Mod makers can set faces in any ratio to be the texture for destination displays, and may sometimes distort the default display ratio.

### Visual

Main EDS circulates at a rate of 2 seconds per image, in an order of `1.png > 2.png > 3.png`. Scroll EDS scrolls the image from right to left. The active display area is 1024x32.

Multiple displays of the same kind are loaded and scrolled in the same rate.

Destination displays (especially electric ones) are frozen in driver's 1st person viewpoint once switched to it. When selected another custom display, the destional displays in the sight (or not) for the driver will be switched off. It will return normal when switched to external / compartment / free view. The reason for this setting is unknown, but it may reduce the load for driving.

## Importing Custom Destination Display

Destination displays in PBS are name-sensitive (but not case-sensitive), meaning that you can use any image with the specific name, format and at the given location. In later versions, users are able to create custom directory for mods, including destination displays.

The default directory for Android is `/storage (/emulated) (/0) /Android /data /com.viamep.pbsu /files /dest /` ( *`pbsu`* can be replaced by the varient of the games, like `/com.viamep.*protonbussimulator*` ). You can check the directory location, as well as the imported images, in Main Screen > Menu > Mods > Destination display, at the bottom of the screen. Note that despite the menu only shows files 0-50, the orders can be stacked beyond 50 to infinity.

> *Destination Displays **must be in .png** format. Does not accept ~~.gif, .jpg, .bin~~, etc.*
>
>

Default sizes of destination displays indicate the sizes of built-in data, and approximately the ratio displayed on buses. However, bus mod makers are able to set any model face to be the destination display texture, and may distort the default ratio, or partially blocks the display by texture. Users are advised to import test images onto buses to see the visual outcome, and adjust the custom displays accordingly. One tip is to import checkboard / square textures onto a default size image, then screenshot and measure the displayed ratio.

Displays of every kind, in the same time, uses the same order. If user wants to partially set different displays for one kind while uses the same for another kind, the user still needs to occupy 2 or more folders.

## Using Custom Destination Display

Custom destination displays are ordered by file numbers in the directory, from 0, 1, to infinity. It does not skip unused files, so it will still display empty white data in between. (Though sometimes the system may automatically generate "missing texture" to fulfill the unused slots).

> *For instance, if the user hasn't filled in all 3 images for the main electronic display, the display will likely to circulate the input image **and the empty white image**. Users should generate 3 same images named 1.png, 2.png and 3.png and store in the same folder, if the one wants to display static data on main electronic display.*
>
>

To select custom displays, select the spanner (2nd button on the top role) on the gameplay screen, then press "+" or "-" button in the window. By default, the data order is -1 (and does not go any lower), so pressing + once will add the order to 0, displaying the data placed in folder 0. Pressing "+" or "-" once will increase or decrease the order by one on each press respectively.

To return to default data, press "-" until the order returns to -1.

Selecting new route in the menu will override the display with its default data. To return to custom display, simply press "+" and "-" once each. Note that the order does not change when you select a new route.

## Tips

If the settings do not work for you, or you face problems while operating check the followings:

* Are the displays in the correct directory location? Have you applied to correct location if you enabled custom directory?
* Are all the displays in .png format?
* Are the image names spelt correctly? (The files are name sensitive but not case sensitive)
* Try opening the images externally with another application. Do they look normal?
* Are the images too large? If they are larger than 2048 pixel on sides, you may occur difficulty loading them.
* Have you switched on the battery for your vehicle?

Loading custom destination displays adds sufficient load to game, especially when using large image sizes. It is suggested to use relatively smaller images if your phone has smaller RAM. If you experience sharp FPS lag when switching displays, it is advised to slower the motion until the FPS returns stable.

## Known Problems

If a user loads a custom data with empty images, some displays (especially static displays) may no longer be operational and shows white, even if the user changes back to default data. Users are suggested to equipt one custom data folder with every kind of the displays filled to debug the problem.

## External Links

Proton Bus Simulator Blog: Official Tutorial (Portuguese / English)

## References

1. ↑ Facebook Video (By Proton Bus Simulator)