Env sprite oriented: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
{{wrongtitle|title=env_sprite_oriented}}
{{wrongtitle|title=env_sprite_oriented}}
{{base_point|env_sprite_oriented}}
{{base_point|env_sprite_oriented}}
{{stub}}
==Entity Description==


==Keyvalues==
== Entity description ==
A [[env_sprite]] that allows orientation.
* {{todo|This appears to be exactly the same as [[env_sprite]] except for the addition of the [[angles]] keyvalue which probably modifies or overrides the env_sprite behaviour vis: "Sprites always face the player, unless they are restricted to rotating on certain axes as specified in the [[VTF]] compile parameters." }}


==Flags==
* This entity should be treated as an "override" for certain sprite effects, as more specific controls already exist for [[env_fire]], [[env_steam]], and [[env_lightglow]].


==Inputs==
== Keyvalues ==
* {{kv angles}}


==Outputs==
*; framerate <string>
: Rate at which the sprite should animate, if at all.
: Default value is 10.0 fps.
 
*; model <sprite_name>
: <sprite_name> is the Material of the sprite to be drawn.
: Default is "<code>sprites/glow01.spr</code>".
{{warning|When choosing a sprite from the sprite browser, the name it provides does not contain the required <code>.spr</code>/<code>.vmt</code> file extension. While the sprite preview can find the sprite, the extension needs to be typed in by hand for the engine to be able to find the sprite in-game.}}
 
*; scale <string>
: Scale multiplier of the sprite.
{{warning|The sprite preview doesn't display sprites at the right scale. The sprite preview scale is preset to <code>0.25</code>, while sprite scale in-game is preset to <code>1.0</code>. To correct the preview scale, set this keyvalue (to any value).}}
 
*; GlowProxySize <float>
: Size of the glow to be rendered for visibility testing. Must be larger than the distance from the sprite center to empty space.  So if this glow is inside geometry (like a light bulb), set this value to be bigger than the bulb's radius. Any time a sphere of this radius would be visible (poking through any nearby geometry), the glow will be rendered.
: Default value is 2.0.
 
*; HDRColorScale <float> 
: Float value to multiply sprite color by when running in HDR mode. Default is 1.0.
 
* {{kv dxlevelchoice}}
* {{kv renderfields}}
{{warning|The only [[Render Modes|render modes]] that render sprite transparency are ''Glow'', ''Additive'', ''Additive Fractional Frame'' and ''World Space Glow''.}}
* {{kv parentname}}
* {{kv targetname}}
 
== Flags ==
* 1 : Start on
* 2 : Play Once
 
== Inputs ==
*; SetScale <float>
: Set the scale (0 - 8.0).
*; HideSprite
: Hide the sprite. Won't be drawn until the ''ShowSprite'' input is received.
*; ShowSprite
: Show the sprite.
*; ToggleSprite
: Toggle the sprite between hidden and shown.
*; ColorRedValue <float>
: Change red color channel's value (0-255)
*; ColorGreenValue <float>
: Change green color channel's value (0-255)
*; ColorBlueValue <float>
: Change blue color channel's value (0-255)
* {{i parentname}}
* {{i renderfields}}
* {{i targetname}}
 
== Outputs ==
* {{o targetname}}

Revision as of 13:56, 13 April 2008

Template:Wrongtitle Template:Base point

Entity description

A env_sprite that allows orientation.

  • Todo: This appears to be exactly the same as env_sprite except for the addition of the angles keyvalue which probably modifies or overrides the env_sprite behaviour vis: "Sprites always face the player, unless they are restricted to rotating on certain axes as specified in the VTF compile parameters."
  • This entity should be treated as an "override" for certain sprite effects, as more specific controls already exist for env_fire, env_steam, and env_lightglow.

Keyvalues

  • framerate <string>
Rate at which the sprite should animate, if at all.
Default value is 10.0 fps.
  • model <sprite_name>
<sprite_name> is the Material of the sprite to be drawn.
Default is "sprites/glow01.spr".
Warning.pngWarning:When choosing a sprite from the sprite browser, the name it provides does not contain the required .spr/.vmt file extension. While the sprite preview can find the sprite, the extension needs to be typed in by hand for the engine to be able to find the sprite in-game.
  • scale <string>
Scale multiplier of the sprite.
Warning.pngWarning:The sprite preview doesn't display sprites at the right scale. The sprite preview scale is preset to 0.25, while sprite scale in-game is preset to 1.0. To correct the preview scale, set this keyvalue (to any value).
  • GlowProxySize <float>
Size of the glow to be rendered for visibility testing. Must be larger than the distance from the sprite center to empty space. So if this glow is inside geometry (like a light bulb), set this value to be bigger than the bulb's radius. Any time a sphere of this radius would be visible (poking through any nearby geometry), the glow will be rendered.
Default value is 2.0.
  • HDRColorScale <float>
Float value to multiply sprite color by when running in HDR mode. Default is 1.0.
Warning.pngWarning:The only render modes that render sprite transparency are Glow, Additive, Additive Fractional Frame and World Space Glow.

Flags

  • 1 : Start on
  • 2 : Play Once

Inputs

  • SetScale <float>
Set the scale (0 - 8.0).
  • HideSprite
Hide the sprite. Won't be drawn until the ShowSprite input is received.
  • ShowSprite
Show the sprite.
  • ToggleSprite
Toggle the sprite between hidden and shown.
  • ColorRedValue <float>
Change red color channel's value (0-255)
  • ColorGreenValue <float>
Change green color channel's value (0-255)
  • ColorBlueValue <float>
Change blue color channel's value (0-255)

Outputs