ModEnc is currently in Maintenance Mode: Changes could occur at any given moment, without advance warning.

PipScale: Difference between revisions

From ModEnc
Jump to navigation Jump to search
← Older edit
Aurum (talk | contribs)
11 edits
mNo edit summary
Testid123 (talk | contribs)
1,216 edits
mNo edit summary
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Flag
{{Flag
|name=PipScale
|values={{Values|strings|hardcoded values[[#Accepted values|{{sup|{{arr|d}}}}]]}}
|files={{ini|rules}}
|default=none
|values=Passengers, Ammo, Power, Tiberium, MindControl
|types={{Categ|Technoes}}
|default=null
|ts=yes
|ts=yes
|fs=yes
|fs=yes
Line 9: Line 8:
|ra2=yes
|ra2=yes
|yr=yes
|yr=yes
|rp=yes
}}
}}
{| style="float: right;" cellpadding="4" class="table_descrowdesccol "
 
This flag is used to display a special type of graphical representation on certain [[TechnoTypes|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 and the default used instead.
{| cellpadding="4" class="table_descrow"
!Value
!Value
!TS/FS
!colspan=4|Game Availability
!RA2
!Remarks
!YR
|-
|-
!Passengers
|<code>charge</code>
|Yes
|
|Yes
|[[Image:Game_fs_yes.png]]
|Yes
|
|
|For use with {{f|IsMobileEMP|link}}
|-
|-
!Ammo
|<code>none</code>
|Yes
|[[Image:Game_ts_yes.png]]
|Yes
|[[Image:Game_fs_yes.png]]
|Yes
|[[Image:Game_ra2_yes.png]]
|[[Image:Game_yr_yes.png]]
|Default behavior&mdash;no pips are displayed
|-
|-
!Power
|<code>passengers</code>
|Yes
|[[Image:Game_ts_yes.png]]
|No
|[[Image:Game_fs_yes.png]]
|No
|[[Image:Game_ra2_yes.png]]
|[[Image:Game_yr_yes.png]]
|For use with {{f|Passengers|link}}
|-
|-
!Tiberium
|<code>ammo</code>
|Yes
|[[Image:Game_ts_yes.png]]
|Only on harvesters
|[[Image:Game_fs_yes.png]]
|Only on harvesters
|[[Image:Game_ra2_yes.png]]
|[[Image:Game_yr_yes.png]]
|For use with {{f|Ammo|link}}
|-
|-
!MindControl
|<code>tiberium</code>
|No
|[[Image:Game_ts_yes.png]]
|No
|[[Image:Game_fs_yes.png]]
|Yes
|[[Image:Game_ra2_yes.png]]
|[[Image:Game_yr_yes.png]]
|For use with {{f|Storage|link}}
|-
|<code>power</code>
|[[Image:Game_ts_yes.png]]
|[[Image:Game_fs_yes.png]]
|[[Image:Game_ra2_yes.png]]
|[[Image:Game_yr_yes.png]]
|No effect&mdash;no pips are displayed
|-
|<code>mindcontrol</code>
|
|
|
|[[Image:Game_yr_yes.png]]
|For use with units having [[weapons]] whose [[warheads]] have {{f|MindControl|yes|link}}
|}
|}
Specifies the type of "pips" used on this object. It can be set to Passengers, Ammo, MindControl or Power. A value of Tiberium is only applicable on BuildingTypes which have Refinery=yes or Weeder=yes set or VehicleTypes which have Harvester=yes or Weeder=yes set, though it can only be set on BuildingTypes in TS/FS, as the silo logic was removed from RA2/YR. In Yuri's Revenge, this can also be set to MindControl (for multiple mind control units such as the Mastermind).
 
{{Clr}}
===Passengers===
{{f|PipScale|Passengers|link}} is typically used for any [[VehicleTypes|vehicle]] with {{f|Passengers|link}} and {{f|SizeLimit|link}} each set to positive [[Help:Values#Integers|integers]] greater than or equal to the combined {{f|Size|link}} of its passengers, to show that there are units inside of it. The [[engine]] will always render a number of pips equal to {{f|Passengers}}. [[InfantryTypes|Infantry]] loaded inside of the unit are represented by the icon determined by {{f|Pip|link}}. Loaded vehicles are always represented by the sixth frame of ''pips2.shp''. If a loaded unit's {{f|Size}} is greater than 1, 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 {{Yr}} this can also be used to indicate units loaded into a [[BuildingType|building]] with {{f|UnitAbsorb|yes|link}}, {{f|InfantryAbsorb|yes|link}}, or both. An absorbed vehicle is represented by the fifth frame of ''pips.shp'', while the fourth frame is used for infantry. In this case, the first frame of ''pips.shp'' is used to represent empty pips. It should be noted that this is not the flag used to display occupancy pips; see {{f|MaxNumberOccupants|link}} for that.
 
Passenger pips will override any declaration of ammo pips.
 
===Ammo===
This can be used to display the current number of rounds loaded on a unit with {{f|Ammo|link}} set to a positive [[Help:Values#Integers|integer]] greater than 0. This is typically used for [[AircraftTypes|aircraft]], but it will display properly for any [[TechnoType]].
 
In {{Ts}}, 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 {{f|Ammo}} is over five, each pip represents 20 percent. Nothing will be drawn to represent empty pips.
 
In {{Ra2}}, if {{f|PipWrap|0|link}} (the default value), the 14th frame (15th frame in {{Yr}}) of ''pips2.shp'' is used, and an individual pip will be drawn for each ammo point. Nothing will be drawn to represent empty pips.
 
If {{f|PipWrap}} is set to an integer greater than 0, a more [[PipWrap|specialized method of displaying ammo pips]] is used.
 
===Tiberium===
{{f|PipScale|Tiberium}} is used to show the amount for harvested ore on [[VehicleTypes|vehicles]] with {{f|Harvester|yes|link}} or {{f|Weeder|yes|link}}, and {{f|Storage|link}} set to a positive [[Help:Values#Integers|integer]] greater than 0. Exactly five pips are rendered; each indicating 20 percent of {{f|Storage}}. The third frame of ''pips2.shp'' is used to represent stored ore in {{Ra2}}. In {{Ts}}, the second frame of ''pips2.shp'' is used for green [[Tiberium_(fictional_substance)|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 {{Yr}}, this is also used to display the current {{f|Storage}} for infantry that can gather ore in an enslaved state. The pips are rendered in the same way as they are for vehicles, but only three are used instead; each indicating one third {{f|Storage}}.
 
In {{Ts}}, this is also used to display Tiberium storage for [[BuildingTypes|buildings]] 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 be used in {{Fs}} for [[VehicleTypes|vehicles]] with {{f|IsMobileEMP|yes|link}}. Exactly eight pips will be drawn; each representing 12.5 percent of {{f|MaxCharge|link}}. 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 {{Yr}} to display the number of mind-controlled units for an [[InfantryTypes|infantry]], [[VehicleTypes|vehicle]], or [[BuildingTypes|building]] with a [[weapon]] whose [[warhead]] has {{f|MindControl|yes|link}}. {{f|PipScale|MindControl|link}} will display a number of pips equal to {{f|Damage|link}} set on the mind control weapon. The second frame of ''pips2.shp'' (or ''pips.shp'' for buildings) is used to represent each mind-controlled unit, while the first frame (of the respective .shp file) is used for empty pips.
 
If the mind control weapon also has {{f|InfiniteMindControl|yes|link}} 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 buildings), but will briefly switch to the fourth frame (of the respective .shp file) each time the controlling unit takes damage specified by {{f|OverloadDamage|link}}.
 
===Power===
Although this is value is parsed, it has no effect in either {{ts}} or {{ra2}}. No pips will be displayed.
{{Bugs}}
If [[TechnoTypes]] has <b>PipScale=MindControl</b> and the weapon used by [[TechnoTypes]] has too much [[Damage]], for example {{f|Damage|999999999|Link}} will cause The game slows down a lot.<br>
If [[TechnoTypes]] has <b>PipScale=MindControl</b> and Too much [[GuardRange]] such as {{f|GuardRange|999999999|Link}} will slow down the game significantly.<br>
If [[TechnoTypes]] has <b>PipScale=MindControl</b> and Too much [[Range]] such as {{f|Range|999999999|Link}} will slow down the game significantly.<br>
If [[TechnoTypes]] has <b>PipScale=MindControl</b> and Too much [[SpawnsNumber]] such as {{f|SpawnsNumber|999999999|Link}} will slow down the game significantly
When [[TechnoTypes]] does not exist in the game area.<br>
 
==See also==
* {{f|PipsDrawForAll|link}}
* {{f|Passengers|link}}
* {{f|Ammo|link}}
* {{f|Storage|link}}
* {{f|GuardRange|Link}}
* {{f|Range|Link}}
* {{f|SpawnsNumber|Link}}

Latest revision as of 13:29, 13 August 2024

Tiberian Dawn The Covert Operations Red Alert Counterstrike Aftermath Tiberian Sun Firestorm HyperPatch Red Alert 2 Yuri's Revenge Ares Generals Zero Hour Tiberium Wars Kane's Wrath
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 and the default used instead.

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—no pips are displayed
mindcontrol For use with units having weapons whose warheads have MindControl=yes

Passengers

PipScale=Passengers is typically used for any vehicle with Passengers and SizeLimit each set to positive integers greater than or equal to the combined Size of its passengers, to show that there are units inside of it. The engine will always render a number of pips equal to Passengers. Infantry loaded inside of the unit are represented by the icon determined by Pip. Loaded vehicles are always represented by the sixth frame of pips2.shp. If a loaded unit's Size is greater than 1, 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 building with UnitAbsorb=yes, InfantryAbsorb=yes, or both. An absorbed vehicle is represented by the fifth frame of pips.shp, while the fourth frame is used for infantry. In this case, the first frame of pips.shp is used to represent empty pips. It should be noted that this is not the flag used to display occupancy pips; see MaxNumberOccupants for that.

Passenger pips will override any declaration of ammo pips.

Ammo

This can be used to display the current number of rounds loaded on a unit with Ammo set to a positive integer greater than 0. This is typically used for aircraft, 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 default value), the 14th frame (15th frame in Yuri's Revenge) of pips2.shp is used, and an individual pip will be drawn for each ammo point. Nothing will be drawn to represent empty pips.

If PipWrap is set to an integer greater than 0, a more specialized method of displaying ammo pips is used.

Tiberium

PipScale=Tiberium is used to show the amount for harvested ore on vehicles with Harvester=yes or Weeder=yes, and Storage set to a positive integer greater than 0. Exactly five pips are rendered; each indicating 20 percent of Storage. 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 infantry that can gather ore in an enslaved state. The pips are rendered in the same way as they are for vehicles, but only three are used instead; each indicating one third Storage.

In Tiberian Sun, this is also used to display Tiberium storage for buildings 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 be used in Firestorm for vehicles with IsMobileEMP=yes. 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 infantry, vehicle, or building with a weapon whose warhead has MindControl=yes. 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 buildings) is used to represent each mind-controlled unit, while the first frame (of the respective .shp file) is used for empty pips.

If the mind control weapon also has InfiniteMindControl=yes 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 buildings), but will briefly switch to the fourth frame (of the respective .shp file) 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. No pips will be displayed.

Bugs/Side-Effects/Unexpected Limitations

If TechnoTypes has PipScale=MindControl and the weapon used by TechnoTypes has too much Damage, for example Damage=999999999 will cause The game slows down a lot.
If TechnoTypes has PipScale=MindControl and Too much GuardRange such as GuardRange=999999999 will slow down the game significantly.
If TechnoTypes has PipScale=MindControl and Too much Range such as Range=999999999 will slow down the game significantly.
If TechnoTypes has PipScale=MindControl and Too much SpawnsNumber such as SpawnsNumber=999999999 will slow down the game significantly When TechnoTypes does not exist in the game area.

See also

Retrieved from "https://modenc.renegadeprojects.com/index.php?title=PipScale&oldid=23056"