VisualGearTypes.wiki
author Wuzzy
Wed, 21 Jun 2023 13:04:30 +0000
changeset 2243 e58371e25834
parent 2217 50275983a97a
permissions -rw-r--r--
LuaLibraryAnimate: Add AnimGearWait
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
431
ccd3a6afa564 Add summary
almikes@aol.com
parents: 351
diff changeset
     1
#summary List of all visual gear types
2077
514babfbad9e Remove outdated legacy hints as clutter
Wuzzy <almikes@aol.com>
parents: 2069
diff changeset
     2
This is a list of available visual gear types.
697
855ce0af8245 Add slightly more description
Wuzzy
parents: 696
diff changeset
     3
855ce0af8245 Add slightly more description
Wuzzy
parents: 696
diff changeset
     4
For a current list of the visual gear types look at `hedgewars/uTypes.pas` at
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
     5
the `TVisualGearType` enumeration: https://hg.hedgewars.org/hedgewars/file/default/hedgewars/uTypes.pas#l115
695
ab2e242986c3 Put everything into a nice table
Wuzzy
parents: 651
diff changeset
     6
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
     7
= List of visual gear types =
1175
09d5758cc4e5 VisualGearTypes: another typo
Wuzzy
parents: 1174
diff changeset
     8
== Environment ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
     9
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    10
|| `vgtFlake` || Theme flake ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    11
|| `vgtChunk` || Theme chunk (spawns when blowing up land) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    12
|| `vgtCloud` || Cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    13
|| `vgtDust` || Dust cloud (e.g. of mudball) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    14
|| `vgtSplash` || Water splash ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    15
|| `vgtDroplet` || Water droplet ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    16
|| `vgtBubble` || Underwater bubble ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    17
|| `vgtSteam` || Steam cloud (when fire hits water) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    18
|| `vgtFire` || Small decorative/harmless flame ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    19
|| `vgtSmoke` || Gray smoke cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    20
|| `vgtSmokeWhite` || White smoke cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    21
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    22
== Explosion  ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    23
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    24
|| `vgtExplosion` || Small explosion (complete animation) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    25
|| `vgtBigExplosion` || Big explosion (complete animation which also makes screen shake) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    26
|| `vgtExplPart` || Small explosion particle, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    27
|| `vgtExplPart2` || Another small explosion particle, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    28
|| `vgtSmokeRing` || Smoke ring, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    29
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    30
== Weapons and projectiles ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    31
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    32
|| `vgtNote` || Piano note ||
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
    33
|| `vgtBeeTrace` || Random colored flower (bee particle) ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    34
|| `vgtEgg` || Broken egg shell particle ||
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
    35
|| `vgtFeather` || Birdy's feather ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    36
|| `vgtSmokeTrace` || Strange smoke-like cloud from mortar ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    37
|| `vgtEvilTrace` || Strange red cloud from hellish hand-grenade ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    38
|| `vgtShell` || Bullet shell ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    39
|| `vgtBulletHit` || Bullet impact animation ||
1178
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    40
|| `vgtLineTrail` || Straight shot line from e.g. desert eagle and the likes ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    41
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    42
== HUD ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    43
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    44
|| `vgtCircle` || Simple circle. Highly configurable! ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    45
|| `vgtNoPlaceWarn` || Overlay when the placement of something failed ||
1166
23e6891cd2c0 VisualGearTypes: more typo fixes
Wuzzy
parents: 1164
diff changeset
    46
|| `vgtAmmo` || Briefly displays an ammo icon. Appears when collecting a crate ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    47
|| `vgtSmoothWindBar` || Changes the wind bar smoothly ||
1255
64a6028803d4 VisualGearTypes: Fix vgtTeamHealthSorter
Wuzzy
parents: 1187
diff changeset
    48
|| `vgtTeamHealthSorter` || When added, updates the sorting of the team health bars ||
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    49
|| `vgtHealthTag` || Hedgehog health tag ||
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    50
|| `vgtSmallDamageTag` || Small damage tag after hog damage. ||
2065
5d8cecc058bf VisualGearTypes: Update SpeechBubble
Wuzzy
parents: 2064
diff changeset
    51
|| `vgtSpeechBubble` || Speech bubble with text. ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    52
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    53
== Misc. ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    54
|| *Variable name* || *Short description* ||
1181
1a54b7c00b23 VisualGearTypes: moving sprite
Wuzzy
parents: 1180
diff changeset
    55
|| `vgtStraightShot` || Moving sprite || 
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    56
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    57
= Detailed visual gear reference =
1168
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    58
Here you will find a (more or less) detailed references of the various possible values for the visual gears (for `SetVisualGearValues`). This is useful to customize your visual gears.
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    59
2061
893f86b6138b VisualGearTypes: Clarify default gear values
Wuzzy
parents: 2060
diff changeset
    60
If not specified otherwise, the visual gear values have the meaning as defined in `SetVisualGearValues` (See [LuaGears]).
893f86b6138b VisualGearTypes: Clarify default gear values
Wuzzy
parents: 2060
diff changeset
    61
1168
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    62
This section is still under construction!
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    63
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    64
== `vgtCircle` ==
1187
70628fea6065 VisualGearTypes: detail vgtCircle
Wuzzy
parents: 1186
diff changeset
    65
A simple circle which doesn't move. It is one of the few visual gears which is not removed automatically. It can be drawn in 2 different styles. With `dX`, `dY` and `FrameTicks`, you can set the circle to pulsate in opacity.
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    66
1186
883d411ac1bd VisualGearTypes: resort
Wuzzy
parents: 1185
diff changeset
    67
1168
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    68
 * `dX`: Minimum opacity (0-255)
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    69
 * `dY`: Maximum opacity (0-255)
2066
c82278e86aa5 VisualGearTypes: Use 0 for circular line
Wuzzy
parents: 2065
diff changeset
    70
 * `Angle`: Circle style. 1 = Radial gradient (`sprVampiric` sprite). 0 = Simple circular line
1187
70628fea6065 VisualGearTypes: detail vgtCircle
Wuzzy
parents: 1186
diff changeset
    71
 * `FrameTicks`: Period length of opacity change. Set to `0` to disable.
1186
883d411ac1bd VisualGearTypes: resort
Wuzzy
parents: 1185
diff changeset
    72
 * `State`: Radius
883d411ac1bd VisualGearTypes: resort
Wuzzy
parents: 1185
diff changeset
    73
 * `Timer`: Line thickness (only if `Angle` does not equal `1`)
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    74
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    75
== `vgtAmmo` ==
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    76
Displays an ammo icon.
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    77
1182
4c72f5881fa4 VisualGearTypes: link ammotype
Wuzzy
parents: 1181
diff changeset
    78
 * `Frame`: !AmmoType ID of ammo to display (see [AmmoTypes])
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    79
1172
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    80
== `vgtHealthTag` ==
2206
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    81
A health/damage tag for hedgehogs. It shows a whole number surrounded by a simple border. `dX` and `dY` can be used for moving it around.
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    82
2208
086c9a18d2ff VisualGearTypes: Add drowning tag info
Wuzzy
parents: 2207
diff changeset
    83
This is shown at the end of a turn to show the total damage received by each hedgehog in that turn, or when a hedgehog drowned.
2206
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    84
But this visual gear is also very useful to show an arbitrary whole number on the screen.
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    85
2214
46d72748f62a VisualGearTypes: Ignore timer healthtag
Wuzzy
parents: 2213
diff changeset
    86
By default, it is white and moves upwards a few pixels before it disappears. Set `dX` and `dY` to 0 to disable movement. If this visual gear was spawned below the water line (`Y>WaterLine`), it will disappear as soon  `Y-10<WaterLine` is `true` and `Timer` is ignored.
1172
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    87
2213
bed46cba92ef VisualGearTypes: `Angle` only effectful if `Frame` is non-zero (HealthTag)
Wuzzy
parents: 2212
diff changeset
    88
 * `Angle`: Scale ratio (only has an effect if `Frame` is non-zero). `0` or `1` = 100%
1913
db5fab5b31da VisualGearTypes: Clarify vgtHealthTag's Frame
Wuzzy
parents: 1530
diff changeset
    89
 * `Frame`: If `0`, its position is relative to the landscape. If non-zero, it will align to the screen instead
2216
ce537974a52c VisualGearTypes: HealthTag number limitation
Wuzzy
parents: 2215
diff changeset
    90
 * `State`: Number to display (must be a whole number). NOTE: Can only be set in the same tick in which it was spawned, not later
2214
46d72748f62a VisualGearTypes: Ignore timer healthtag
Wuzzy
parents: 2213
diff changeset
    91
 * `Timer`: Expiration timer (not used if spawned below water line (`Y>WaterLine`))
2206
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    92
 * `Tint`: Color of number and border
2213
bed46cba92ef VisualGearTypes: `Angle` only effectful if `Frame` is non-zero (HealthTag)
Wuzzy
parents: 2212
diff changeset
    93
 * `Scale`: Unused. Use `Angle` for scaling instead
1172
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    94
1417
969b75121c88 VisualGearTypes: vgtSmallDamageTag stub
Wuzzy
parents: 1255
diff changeset
    95
== `vgtSmallDamageTag` ==
2205
15b8c1953be3 VisualGearTypes: Can't use vgtSmallDamageTag
Wuzzy
parents: 2204
diff changeset
    96
NOTE: Due to a bug, this cannot currently be used in Lua scripts.
15b8c1953be3 VisualGearTypes: Can't use vgtSmallDamageTag
Wuzzy
parents: 2204
diff changeset
    97
2206
4bf9ae7d9739 VisualGearTypes: Improve Health/damage tag documentation
Wuzzy
parents: 2205
diff changeset
    98
Damage indicator, displays a damage value. Hedgewars uses this as the "small" damage tag used to instantly show damage of a single hit.
1417
969b75121c88 VisualGearTypes: vgtSmallDamageTag stub
Wuzzy
parents: 1255
diff changeset
    99
2212
cfa171e6d226 VisualGearTypes: add FrameTicks to SmallDamageTag
Wuzzy
parents: 2211
diff changeset
   100
Looks and behaves similar to `vgtHealthTag`, but is slightly smaller.
cfa171e6d226 VisualGearTypes: add FrameTicks to SmallDamageTag
Wuzzy
parents: 2211
diff changeset
   101
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
   102
== `vgtSpeechBubble` ==
2065
5d8cecc058bf VisualGearTypes: Update SpeechBubble
Wuzzy
parents: 2064
diff changeset
   103
Displays a speech bubble with text. In Lua, you cannot change the text after this has been created. Use `HogSay` in Lua to spawn a speech bobble properly.
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
   104
1530
288bee4b94d5 VisualGearTypes: Add Frame to vgtSpeechBubble
Wuzzy
parents: 1418
diff changeset
   105
 * `Frame`: ID of the gear to which the speech bubble belongs
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
   106
 * `FrameTicks`: Speech bubble type (`SAY_SAY`, `SAY_THINK` or `SAY_SHOUT`)
2065
5d8cecc058bf VisualGearTypes: Update SpeechBubble
Wuzzy
parents: 2064
diff changeset
   107
 * (Text is stored internally that cannot be accessed by Lua)
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
   108
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
   109
== `vgtStraightShot` ==
2064
61552dc89169 VisualGearTypes: remove blabla
Wuzzy
parents: 2061
diff changeset
   110
Displays an arbitrary sprite which moves in a random direction (can be overwritten in `dX` and `dY`) and fades out after a short time.
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
   111
2060
55ea190450ec VisualGearTypes: Update vgtStraightShot
Wuzzy
parents: 1913
diff changeset
   112
 * `State`: ID of the custom sprite (use an ID from [Sprites]) (default: `sprSnowDust`)
55ea190450ec VisualGearTypes: Update vgtStraightShot
Wuzzy
parents: 1913
diff changeset
   113
 * `Frame`: Frame of custom sprite (default: 0)
2068
b519bdd96f11 VisualGearTypes: fix default vgtStraightShot timer
Wuzzy
parents: 2067
diff changeset
   114
 * `FrameTicks`: Life time in milliseconds (default: random between 750 and 2000)
1178
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   115
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   116
== `vgtLineTrail` ==
2217
50275983a97a VisualGearTypes: linetrail is thin
Wuzzy
parents: 2216
diff changeset
   117
A straight thin yellowish line between two points which fades out after some time. As if a bullet has been fired. A `vgtLineTrail` has a start and an end point. The default `Timer` is too low so you must set it manually
1178
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   118
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   119
 * `X`, `Y`: Start point of line
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   120
 * `dX`, `dY`: End point of line
2067
ab22c7756ad0 VisualGearTypes: Add Tint for vgtLineTrail
Wuzzy
parents: 2066
diff changeset
   121
 * `Timer`: Life time (default: 0)
2077
514babfbad9e Remove outdated legacy hints as clutter
Wuzzy <almikes@aol.com>
parents: 2069
diff changeset
   122
 * `Tint`: Opacity (0-255). The color itself can't be changed