env_sprite Last edited 3 years ago2021-06-16 11:34:30 UTC

[cat:Point Entities]

env_sprite - Point Entity

The env_sprite entity places a sprite within the map.

Attributes

• Render FX (renderfx) - Gives the sprite certain visual effects depending on Render Mode. This essentially 'animates' the FX Amount.
  • Normal (0) - No visual effects.
  • Slow Pulse (1) - Sprite slowly pulses with transparency. Faint.
  • Fast Pulse (2) - Sprite quickly pulses with transparency. Faint.
  • Slow Wide Pulse (3) - Sprite slowly pulses with transparency. Strong.
  • Fast Wide Pulse (4) - Sprite quickly pulses with transparency. Strong.
  • Slow Fade Away (5) - Seemingly unused.
  • Fast Fade Away (6) - Seemingly unused.
  • Slow Become Solid (7) - Seemingly unused.
  • Fast Become Solid (8) - Seemingly unused.
  • Slow Strobe (9) - A very slow strobe effect between visible and invisible.
  • Fast Strobe (10) - A medium strobe effect between visible and invisible.
  • Faster Strobe (11) - A very fast strobe effect between visible and invisible.
  • Slow Flicker (13) - Sprite flickers in and out of visibility.
  • Fast Flicker (13) - Sprite quickly flickers in and out of visibility.
  • Constant Glow (14) - If Render Mode is Glow, the sprite will remain the same size and visible at any distance.
  • Distort (15) - Sprite has a slight fast pulsing of transparency.
  • Hologram (Distort + fade) (16) - Sprite has a slight fast pulsing of transparency. Fades out with distance.
• Render Mode (rendermode) - Allows special rendering modes to be applied to the given entity.
  • Normal (0) - FX Color affects the overall color of the sprite. FX Amount (and thus Render FX) is ignored.
  • Color (1) - FX Color is ignored. FX Amount is used as a visibility flag (0 is invisible, any other value is visible), which also affects the chosen Render FX.
  • Texture (2) - FX Color affects the overall color, and FX Amount the overall transparency of the sprite.
  • Glow (3) - Same as Additive, but the sprite will also scale up and fade out over distance (unless Render FX is set to 'Constant Glow').
  • Solid (4) - Same as Texture.
  • Additive (5) - FX Color affects the overall color, and FX Amount the overall transparency of the sprite, and dark pixels will be more transparent than bright pixels.
• FX Amount (0 - 255) (renderamt) - Sets the overall transparency of the sprite. Scales from 0 (invisible) to 255 (solid, normal). Has no effect when Render Mode is "Normal", and only toggles visibility when Render Mode is "Color".
• FX Color (R G B) (rendercolor) - Alters the color of the sprite. Note that setting a darker color will darken the sprite, which also affects transparency when Render Mode is "Glow" or "Additive". Setting this to 0 0 0 has no effect.
• Name (targetname) - Name is a general attribute used to identify entities.
• Pitch Yaw Roll (Y Z X) (angles) - Sets the visual rotation of the sprite. Yaw will set the degrees in rotation of the sprite, with 0 being the default. Roll can do the same, and will override Yaw if set to anything other than 0. Pitch is unused.
• Framerate (framerate) - Sets how many frames per second the sprite will animate at.
• Sprite Name (model) - This defines which sprite file will be displayed by the entity. This accepts an input of the form "path/filename.spr" (starting from the root folder). (Example: "sprites/tele1.spr").
• Scale (scale) - Sets the scale of the sprite, in the form of a size multiplier.

Flags

• Start on (1) - If enabled, the sprite will be turned on at the start of the map.
• Play Once (2) - If not enabled, the sprite will be treated as toggled, and triggering the env_sprite will toggle the sprite between visible and invisible. The sprite will repeat its animation indefinitely. If enabled, the sprite will play through its animation once when triggered and then stay invisible until it is triggered again. (If the env_sprite is triggered while this single animation is playing, it will become invisible immediately.)

Notes

• If a sprite with only one frame is used with the Play Once flag enabled, it will operate as normal; the sprite will only appear for as long as one frame takes as defined by Framerate.

Render modes and sprite texture formats

Besides Render Mode, the appearance of a sprite also depends on the texture format of the sprite file itself. There are 4 different formats:

• Normal - 8-bit indexed format, using a 256-color palette.
• Additive - Same as "Normal" (for additive rendering, use the "Additive" Render Mode).
• Index-alpha - 8-bit alpha channel. The palette is ignored, except for the last color, which determines the overall sprite color. This format is also used for decal textures.
• Alpha-test - 8-bit indexed format, using a 256-color palette. The last color in the palette is used for transparent areas. This format is also used for transparent textures.

The following screenshots show a normal, an additive, an index-alpha and an alpha-test sprite, using different render modes and FX settings:

FX Amount: 255 FX Amount: 63 FX Color: 255 0 0

To summarize:

• The "Normal" and "Additive" texture formats can be used interchangeably.
• The "Normal", "Color", "Texture" and "Solid" Render Modes are also interchangeable, except that:
  • "Normal" ignores FX Amount.
  • "Color" ignores FX Color, and uses FX Amount as a visibility flag.
• The "Glow" and "Additive" Render Modes are also similar, besides the distance-based scaling and fading of "Glow":
  • They use additive rendering.
  • They do not render "Index-Alpha" sprites very well.
  • Transparency can be affected by FX Color.

Related pages

• cycler_sprite
• env_glow
• Tutorial: Beam and Sprite Effects
• Tutorial: Using Sprites
• VERC: Glowing Sprites
• Vlatitude: Env_sprite Tutorial