Skip to content
OpenTS Manual

NewTheater

Changed in 0.2.0

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

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

NewTheater=yes looks for the type’s shape under a theater-specific name. The name is <Image ID>.SHP with its second letter replaced by the scenario theater’s ImageLetter: T in temperate and A in snow. A name is rewritten only when its second letter is already the image letter of some declared theater, ignoring case. Any other name, such as CITY01 with the stock theaters, is looked up as written in every theater.

art.ini
[GAFENC] ; example Image ID of an OverlayType
NewTheater=yes ; draws GTFENC.SHP in temperate and GAFENC.SHP in snow

Whether the renamed shape is drawn depends on the kind of type:

  • Overlays, projectiles and particles draw the renamed shape.
  • Structures are renamed whether or not the flag is set. The rename covers the structure’s shape and the art named by Buildup, DeployingAnim, DoorAnim, UnderDoorAnim, SpecialZOverlay and BibShape.
  • Aircraft, infantry, vehicles, smudges and terrain objects ignore the flag in a new game. They draw <Image ID>.SHP, and have no shape if only the renamed file exists.

Where the renamed shape is drawn, it is the only name tried. A type whose file for the current theater is missing has no shape, so provide one file for each 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.

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

NewTheater=yes makes the animation draw a theater-specific shape when one exists. The file keeps its .SHP extension, and the second letter of its name is replaced by the scenario theater’s ImageLetter: T in temperate and A in snow. A name is rewritten only when its second letter is already the image letter of some declared theater, ignoring case. GACNST and XTCNST follow this convention. With the stock theaters CITY01 does not, so it loads the same file in every theater.

The name rewritten is the one Image= gives, or the AnimType ID when no Image ID is set. Theater=yes uses the AnimType ID instead, except in a scenario whose theater repeats the previous scenario’s.

The renamed file is used when it exists. Otherwise the animation draws an unrenamed file: <AnimType ID>.SHP when that exists, and <Image ID>.SHP after that.

art.ini
[GAFLAG] ; example AnimType ID, with no Image= set
NewTheater=yes ; draws GTFLAG.SHP in temperate, or GAFLAG.SHP when that file is missing

Put NewTheater=yes in the art section of the Image ID, which is the AnimType’s own section when Image= is not set. When the Image ID names another section, the AnimType’s own section is read for this key only if neither <AnimType ID>.SHP nor <Image ID>.SHP exists.

See also — Theater, Image, Voxel

History

  1. Changed0.2.0In development

    Declare extra theaters in the rules