PipScale
Flag: | PipScale |
File(s): | rules(md).ini |
Values: | Strings: Normal text. (Limited to: hardcoded values↓) |
Default: | none |
Applicable to: | TechnoTypes:
AircraftTypes, BuildingTypes, InfantryTypes and VehicleTypes |
This flag is used to display a special type of graphical representation on certain units. This usually indicates a unit's current load of passengers, ammunition, or harvested ore. Each icon representing a portion of the load is referred to as a "pip".
Accepted values
All values are case-insensitive. Any other values will simply be ignored.
Value | Game Availability | Remarks | |||
---|---|---|---|---|---|
charge
|
For use with IsMobileEMP | ||||
none
|
Default behavior—no pips are displayed | ||||
passengers
|
For use with Passengers | ||||
ammo
|
For use with Ammo | ||||
tiberium
|
For use with Storage | ||||
power
|
No effect | ||||
mindcontrol
|
For use with units having weapons whose warheads have MindControl=yes |
Passengers
PipScale=Passengers is typically used for any VehicleType with Passengers to show that there are units inside it. The engine will always render a number of pips equal to Passengers. InfantryTypes loaded inside of the unit are represented by the icon determined by Pip. VehicleTypes are always represented by the sixth frame of pips2.shp. If a loaded unit's Size is larger than one, it will take up that many pips, with each pip beyond the first drawn using the fourth frame of pips2.shp. The first frame is used to represent empty pips.
In Yuri's Revenge this can also be used to indicate units loaded into a BuildingType with UnitAbsorb=yes, InfantryAbsorb=yes, or both set. An absorbed VehicleType is represented by the fifth frame of pips.shp, while the fourth frame is used for InfantryTypes. In this case, the first frame of pips.shp is used to represent empty pips.
Ammo
This can be used to display the current number of rounds loaded on a unit with Ammo. This is typically used for AircraftTypes, but it will display properly for any TechnoType.
In Tiberian Sun, the seventh frame of pips2.shp is used to display the unit's current ammo supply. The engine will only draw up to five ammo pips individually. If the unit's total Ammo is over five, each pip represents 20 percent. Nothing will be drawn to represent empty pips.
In Red Alert 2, if PipWrap=0, the 14th frame of pips2.shp is used instead, and an individual pip will be drawn for each ammo point. Nothing will be drawn to represent empty pips.
If PipWrap is not 0
, a more specialized method of displaying ammo pips is used. See PipWrap for more information.
Tiberium
PipScale=Tiberium is used to display the current Storage for VehicleTypes with Harvester=yes or Weeder=yes set. Exactly five pips are rendered. The third frame of pips2.shp is used to represent stored ore in Red Alert 2. In Tiberian Sun, the second frame of pips2.shp is used for green Tiberium and veins. For gems (or blue Tiberium in TS), the sixth frame of pips2.shp is used. The first frame of pips2.shp is always used to represent an empty pip.
In Yuri's Revenge, this is also used to display the current Storage for InfantryTypes that can gather ore in an enslaved state. The pips are rendered in the same way as they are for VehicleTypes, but only three are used instead.
In Tiberian Sun, this is also used to display Tiberium storage for BuildingTypes such as refineries and silos. In this case, the second frame of pips.shp is used, while the first frame is used for empty pips. The engine will draw as many pips as it takes to span the selection box.
Charge
This should only used in Firestorm for VehicleTypes with IsMobileEMP=yes set. Exactly eight pips will be drawn; each representing 12.5 percent of MaxCharge. The second frame of pips2.shp is used for complete portions of the full charge, while the first frame is used for the incomplete portions.
MindControl
This is only used in Yuri's Revenge to display the number of mind-controlled units for an InfantryType, VehicleType, or BuildingType with a weapon whose warhead has MindControl=yes set. PipScale=MindControl will display a number of pips equal to Damage set on the mind control weapon. The second frame of pips2.shp (or pips.shp for BuildingTypes) is used to represent each mind-controlled unit, while the first frame is used for empty pips.
If the mind control weapon also has InfiniteMindControl=yes set and the controlling unit controls more units than it has pips, an additional pip will be drawn to represent "mind-control overload". This pip will use the fifth frame of pips2.shp (or pips.shp for BuildingTypes), but will briefly switch to the fourth frame each time the controlling unit takes damage specified by OverloadDamage.
Power
Although this is value is parsed, it has no effect in either Tiberian Sun or Red Alert 2.