VisualGearTypes.wiki
author Wuzzy
Fri, 09 Feb 2018 21:59:27 +0000
changeset 1179 0d4a6bda7614
parent 1178 58ef0e44ea88
child 1180 4ca8fc9f1fdb
permissions -rw-r--r--
VisualGearTypes: Add description for vgtTeamHealthSorter
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
ccd3a6afa564 Add summary
almikes@aol.com
parents: 351
diff changeset
     2
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
     3
This is a list of available visual gear types, as of 0.9.23.
697
855ce0af8245 Add slightly more description
Wuzzy
parents: 696
diff changeset
     4
855ce0af8245 Add slightly more description
Wuzzy
parents: 696
diff changeset
     5
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
     6
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
     7
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
     8
= List of visual gear types =
1175
09d5758cc4e5 VisualGearTypes: another typo
Wuzzy
parents: 1174
diff changeset
     9
== Environment ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    10
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    11
|| `vgtFlake` || Theme flake ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    12
|| `vgtChunk` || Theme chunk (spawns when blowing up land) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    13
|| `vgtCloud` || Cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    14
|| `vgtDust` || Dust cloud (e.g. of mudball) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    15
|| `vgtSplash` || Water splash ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    16
|| `vgtDroplet` || Water droplet ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    17
|| `vgtBubble` || Underwater bubble ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    18
|| `vgtSteam` || Steam cloud (when fire hits water) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    19
|| `vgtFire` || Small decorative/harmless flame ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    20
|| `vgtSmoke` || Gray smoke cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    21
|| `vgtSmokeWhite` || White smoke cloud ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    22
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    23
== Explosion  ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    24
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    25
|| `vgtExplosion` || Small explosion (complete animation) ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    26
|| `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
    27
|| `vgtExplPart` || Small explosion particle, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    28
|| `vgtExplPart2` || Another small explosion particle, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    29
|| `vgtSmokeRing` || Smoke ring, part of explosion animation ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    30
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    31
== Weapons and projectiles ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    32
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    33
|| `vgtNote` || Piano note ||
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
    34
|| `vgtBeeTrace` || Random colored flower (bee particle) ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    35
|| `vgtEgg` || Broken egg shell particle ||
1163
1893051766fe VisualGearTypes: More text
Wuzzy
parents: 1162
diff changeset
    36
|| `vgtFeather` || Birdy's feather ||
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    37
|| `vgtSmokeTrace` || Strange smoke-like cloud from mortar ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    38
|| `vgtEvilTrace` || Strange red cloud from hellish hand-grenade ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    39
|| `vgtShell` || Bullet shell ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    40
|| `vgtBulletHit` || Bullet impact animation ||
1178
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    41
|| `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
    42
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    43
== HUD ==
1162
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    44
|| *Variable name* || *Short description* ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    45
|| `vgtCircle` || Simple circle. Highly configurable! ||
f42906890b68 VisualGearTypes: Add short description for most visual gear types
Wuzzy
parents: 798
diff changeset
    46
|| `vgtNoPlaceWarn` || Overlay when the placement of something failed ||
1166
23e6891cd2c0 VisualGearTypes: more typo fixes
Wuzzy
parents: 1164
diff changeset
    47
|| `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
    48
|| `vgtSmoothWindBar` || Changes the wind bar smoothly ||
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. ||
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    51
|| `vgtSpeechBubble` || Speech bubble with text. Does not work in Lua. ||
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* ||
1177
e156273d1b38 VisualGearTypes: Move vgtStraightShot
Wuzzy
parents: 1176
diff changeset
    55
|| `vgtStraightShot` || Moving sprite, such as shots from desert eagle || 
1179
0d4a6bda7614 VisualGearTypes: Add description for vgtTeamHealthSorter
Wuzzy
parents: 1178
diff changeset
    56
|| `vgtTeamHealthSorter` || Currently unused ||
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    57
1169
f36679317ec0 VisualGearTypes: Fix captions
Wuzzy
parents: 1168
diff changeset
    58
= Detailed visual gear reference =
1168
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    59
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
    60
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    61
This section is still under construction!
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    62
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    63
== `vgtCircle` ==
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    64
A simple circle which doesn't move. It is one of the few visual gears which is not removed automatically. If you set `dX`, `dY` and `FrameTicks`, the circle pulsates in opacity.
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    65
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    66
 * `State`: Radius
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    67
 * `Timer`: Thickness
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)
032b2771c757 VisualGearTypes: Add vgtCircle and vgtAmmo
Wuzzy
parents: 1167
diff changeset
    70
 * `FrameTicks`: ???
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    71
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    72
== `vgtAmmo` ==
1167
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    73
Displays an ammo icon.
0fef28e4ee0d VisualGearTypes: add vgtCircle and vgtAmmo
Wuzzy
parents: 1166
diff changeset
    74
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    75
 * `Frame`: [AmmoType] ID of ammo to display
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    76
1172
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    77
== `vgtHealthTag` ==
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    78
A health tag for hedgehogs. But with a few changes, this is also useful to display arbitray numbers on the screen.
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    79
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    80
 * `State`: Number to display
1172
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    81
 * `Angle`: Scale ratio. `1` = 100%
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    82
 * `Frame`: If `0`, it is part of the landscape. If non-zero, it will align to the screen instead
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    83
 * `Timer`: Expiration timer
929d65ba07e6 VisualGearTypes: fix syntax
Wuzzy
parents: 1171
diff changeset
    84
1171
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    85
== `vgtSpeechBubble` ==
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    86
Displays a speech bubble. Use `HogSay` to spawn speech bubbles.
211e1f8ec3cb VisualGearTypes: Add vgtHealthTag
Wuzzy
parents: 1170
diff changeset
    87
1173
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    88
 * `FrameTicks`: Speech bubble type (`SAY_SAY`, `SAY_THINK` or `SAY_SHOUT`)
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    89
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    90
== `vgtStraightShot` ==
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    91
Displays an arbitrary sprite which moves. A straight shot from a firearm like the Desert Eagle. The sprite it uses can be changed, so this can be used to display nearly every sprite.
bb717cb60483 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1172
diff changeset
    92
1174
31b2bed82ee3 VisualGearTypes: fix typo
Wuzzy
parents: 1173
diff changeset
    93
 * `State`: ID of the custom sprite (use an ID from `Sprites`)
1178
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    94
 * `FrameTicks`: ???
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    95
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    96
== `vgtLineTrail` ==
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    97
A straight line between two points which briefly fades out. 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
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    98
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
    99
 * `X`, `Y`: Start point of line
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   100
 * `dX`, `dY`: End point of line
58ef0e44ea88 VisualGearTypes: vgtStraightShot
Wuzzy
parents: 1177
diff changeset
   101
 * `Timer`: Life time