roadtypes/tramtypes (formerly referred to as NRT)

[wallyweb]

Roadtypes and Tramtypes have been available in OpenTTD-master for a while now, but NewGRF NFO and NML documentation are rather sparse.
There are at least two GRFs available: ratt-roads and unspooled.
They are coded in NML.
I am trying to cobble together something in NFO, so I will have an occasional question.

Considering that the NRT topic is largely out of date with the exception of the most recent posts, If others have Roadtypes or Tramtypes NewGRF coding questions (NML and/or NFO), perhaps they could post them below.

I will try to add relevant links here as they become available.

[wallyweb]

My first question is about NFO Action 1.

The NewGRF specifications show:
// BASIC <sprite-number> * <length> 01 <feature> <num-sets> <num-ent>
// EXTENDED <sprite-number> * <length> 01 <feature> 00 <first-set> <num-sets> <num-ent>

but roadtypes seem to be a bit different.
<sprite-number> * <length> 01 <feature> <num-sets> FF <num-ent> <first-set>

A bit self explanatory with the exception of FF.
In the EXTENDED format 00 is an indicator that the Action 1 is indeed extended.
Does the FF in the roadtype Action 1 also act as an indicator, this one for roadtypes/tramtypes, or does it refer to something else?

[jfs]

No, the roadtype syntax for action 1 is not any different.

The FF syntax is "extended byte". The FF indicates that instead of a single-byte value, read two more bytes that form the actual value as a word-sized value. Described here.

Extended bytes only work for values that are defined to accept them, and the num-ent value is one of those.

[wallyweb]

So, in

Code: Select all

6 * 6	 01 12 01 FF 13 00

13 00 (19d) would be <num-ent> and there is no <first-set>?
and in

Code: Select all

6 * 6	 01 12 02 FF 13 00

we have two <num-ent> of 19 real sprites each?

[PikkaBird]

That looks about right to me. Neither are the extended format action 1, but both use an extended byte for num-ent.

13 00 (19d)

Wherever possible, code "19d in a word" as "\w19", not "13 00". Makes life easier for everyone.

[wallyweb]

Thanks.

[andythenorth]

There's now an nml nightly (2019-10-07) including NRT http://bundles.openttdcoop.org/nml/nightlies/LATEST/

Sorry, no Windows build of that yet.

[wallyweb]

...

Treasure trove.
Treasure map to the Windows trove would be handy when its available. Thanks.

[andythenorth]

There are roadtypes examples included with NML also btw.

[wallyweb]

There are roadtypes examples included with NML also btw.

So I noticed. Colourful stuff no less.

[andythenorth]

FYI I'm working on the nml docs and improved examples for roadtypes/tramtypes:

https://github.com/OpenTTD/nml/issues/47
https://github.com/OpenTTD/nml/issues/46

Assistance would be valuable

[wallyweb]

Assistance would be valuable

Indeed.