NewTheater

Rewrites the second letter of a type's artwork filename to match the theater.

Theater artwork naming

Specification — Theater artwork naming

Applies to

ObjectType and derived types

AircraftTypeBuildingTypeBulletTypeInfantryTypeOverlayTypeParticleSystemTypeParticleTypeSmudgeTypeTerrainTypeUnitTypeVoxelAnimType

File

art.ini

Section

[<Image ID>]Image ID: Image= value; ObjectType ID when omitted

Value

boolean

When omitted

no

The file keeps its .SHP extension and the second letter of its name is rewritten instead: T in temperate and A in snow. The rewrite is applied only when the Image ID starts with one of six two-letter prefixes — GA, GT, NA, NT, CA, or CT — and the comparison ignores case. Any other name is left exactly as written, so the flag does nothing for it.

art.ini

[GACNST] ; the Image ID of a BuildingType
NewTheater=yes ; draws GTCNST.SHP in temperate and GACNST.SHP in snow

Theater=yes is tested first and wins, so a type marked with both only ever swaps its extension. A Voxel=yes AircraftType, InfantryType or UnitType has no shape to rename; a BuildingType resolves and loads a theater-named shape either way.

Only some of these types keep the rewrite

An AircraftType, InfantryType, or UnitType looks its unrewritten <Image ID>.SHP up again immediately after the rename and keeps whatever that returns. Those three, a BulletType, a ParticleType, a ParticleSystemType and a VoxelAnimType also leave their artwork as it stands when the scenario theater changes — as do a SmudgeType and a TerrainType, whose theater pass handles Theater alone.

A building is renamed whether or not the flag is set

A BuildingType runs its shape, its buildup, and its door, deploy, bib, and Z-overlay animations through the same rewrite every time its rules section is read. The flag is what makes a building resolve those names again against a new theater.

Theater animation naming

Specification — Theater animation naming

Applies to

AnimType

File

art.ini

Section

[<ObjectType ID>]

Value

boolean

When omitted

no

Read order

This setting is accepted under more than one entry heading; the last one the engine reads wins.

Order	File	Section
1	art.ini	[<Image ID>]Image ID: Image= value; ObjectType ID when omitted
2	art.ini	[<ObjectType ID>]

The file keeps its .SHP extension and the second letter of its name is rewritten to match the theater — T in temperate, A in snow — provided the name starts with GA, GT, NA, NT, CA, or CT, compared without regard to case. Any other name is left as written.

Unlike Theater=yes, this path does honor the animation’s Image= and rewrites that name rather than the AnimType ID. The AnimType ID is used only when no Image ID is set.

Artwork already in hand is not replaced

The rename is reached only while the animation still has no shape. One that already found a file under its unrewritten name keeps it, so providing that name alongside the theater variants leaves the variants unused. The animation is loaded under its plain name as soon as its type is created, so a type whose unrewritten file exists never reaches the rename at all — and one that did load a theater variant keeps that variant when the scenario theater later changes.

See also — Theater, Image, Voxel

Page feedback

Report an error or missing detail. The issue includes this page and revision.

Open issueSource revision 59fae722af8c