Skip to content

Commit 2516cce

Browse files
committed
specifies precedence of DDS over ACE
Describes the tolerant behaviour if filenames don't match references.
1 parent a2a9bbc commit 2516cce

File tree

2 files changed

+14
-4
lines changed

2 files changed

+14
-4
lines changed

Source/Documentation/Manual/features-route.rst

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -715,11 +715,10 @@ In the ``.trk`` file of the route the parameter ``loadingscreen`` can be used as
715715

716716
LoadingScreen ( Load.ace )
717717

718-
If in the main directory of the route there is a file with the same name but with extension ``.dds``
719-
and the :ref:`DDS texture support<options-dds-textures>` is enabled
718+
A DDS extension takes precedence over ACE so, if
719+
in the main directory of the route there is a file with the same name but with extension ``.dds``,
720720
the latter is displayed instead of that with ``.ace`` extension.
721-
If the parameter is omitted then the file ``load.ace`` is loaded (as in MSTS) or ``load.dds``
722-
(if present and, again, the dds support is enabled).
721+
If the filename parameter is omitted then the file ``load.ace`` is loaded (as in MSTS) or ``load.dds`` if present.
723722

724723
The loading screen image can have any resolution and aspect ratio; it will be displayed letter-boxed
725724
on the screen keeping the aspect ratio.

Source/Documentation/Manual/software-platform.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,5 +227,16 @@ Note: To avoid overloading the simulator, please keep API calls to once or twice
227227
- | ``Orts.Viewer3D.WebServices .WebServer.ORTSApiController .ApiSampleData``
228228

229229

230+
.. _dds-and-ace:
230231

232+
DDS and ACE Texture Files
233+
=========================
234+
235+
Open Rails prefers DDS over ACE texture files, but is tolerant where these don't match references in other files.
236+
237+
If a texture file is referenced with no extension, then ``.dds`` is added, searched for and loaded.
238+
If not found, then ``.ace`` is added, searched for and loaded.
239+
240+
If a texture file is referenced with either a ``dds`` or ``ace`` extension, then that is searched for and loaded
241+
but, if not found, then the other extension is substituted, searched for and loaded.
231242

0 commit comments

Comments
 (0)