This article's documentation is for anything that uses the Source engine. Click here for more information.

Func water analog: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (1416006136 moved page Func water analog to Func water analog/en)
No edit summary
 
(36 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{lang|Func water analog}}
{{LanguageBar}}
{{entity|func_water_analog|type=e2}} It's a version of {{ent|func_movelinear}} slightly specialized for use as water.


Only two [[material]]s are known to render correctly across all systems, these are <code>nature/water_movingplane</code> and <code>nature/water_dx70</code>. [[Expensive]] water shaders are required to be unmoving, because they have to always be certain of what can/should be drawn in surface reflections. [[Cheap]] water does not reflect the world, therefore it will never encounter the visibility problem.
{{CD|CFuncMoveLinear|file1=func_movelinear.cpp}}
{{this is a|brush entity|name=func_water_analog}} It's a version of {{ent|func_movelinear}} slightly specialized for use as water.


{{bug|Doesn't behave properly in {{l4d2}}! Physics don't behave properly if affected by this brush and graphical glitches can occur. Use sparingly and cautiously!}}
{{important|Does not work with the {{ent|water (shader)|alt=Water}} shader.<br>{{ent|Refract}} can be used as a workaround for dynamic refraction with cubemapped reflections, although Valve does not provide any materials which do this.<br>Existing materials which are compatible include:
* {{file|nature/water_movingplane|vmt}} ([[LightmappedGeneric]])
* {{file|nature/water_dx70|vmt}} ([[LightmappedGeneric]])
* {{file|nature/hazard_liquid|vmt}} ([[LightmappedGeneric]]) {{only|{{portal}}}}
* {{file|liquids/!greenslime|vmt}} ([[UnlitTwoTexture]]) {{only|{{hls}} {{hldms}} {{jbep3}} }}
{{Confirm|Does the Water shader work if using cubemap reflections and refractions, instead of the real-time versions? This would still be beneficial for the ability to have two normal maps scrolling in different directions.}} }}
 
{{bug|Water must be part of the world in {{l4ds|4}} otherwise it doesn't work properly and acts as non-solid brush.|hidetested=1}}


{{FuncMoveLinear notes}}
{{FuncMoveLinear notes}}


{{code class|CFuncMoveLinear|func_movelinear.cpp}}
{{bug|hidetested=1|In {{bms|4}}, if this entity uses multiple brushes, [[VPhysics]] objects work incorrectly with this entity (the same for {{ent|func_water|engine=source}}). It looks like they are using [[Bounding box|BBox]] of this entity to calculate physics, instead of using brushes. This issue can be found in '''Interloper''' chapter. Separate water into several separate entities to avoid this bug.
{{expand|title=Examples.|
[[File:wateran1.jpg| thumb | left | 710px |Note how the hat is "flying in air".]]
[[File:wateran2.jpg| thumb | right | 710px |Note how the hat is "flying in air".]]
}}
}}


==Flags==
{{codenote|Both <code>func_water_analog</code> and {{ent|func_movelinear}} are linked to [[CFuncMoveLinear]] C++ class. The game code checks the {{mono|classname}} KV to distinguish between them.}}
{{not in FGD}}
{{Fl FuncMoveLinear}}


==Keyvalues==
==Keyvalues==
{{KV FuncMoveLinear}}
{{KV|Water Material|intn=WaterMaterial|material|The material to derive water information from. Determines $underwateroverlay that use {{ent|func_water_analog}}.|only=BMS}}
{{KV visiblebrush}}
:{{Bug|Don't work after reload. You still can repeat this effect with trigger and {{ent|env_screenoverlay}}.|hidetested=1}}
{{KV BaseEntity}}
{{KV|Wave Height|intn=WaveHeight|string|only=BMS}}


==Inputs==
{{I FuncMoveLinear}}
{{I visiblebrush|portal2=1}}
{{I BaseEntity|prel4d=1}}


==Outputs==
{{OtherKIO|func_movelinear}}
{{O FuncMoveLinear}}
{{O BaseEntity|l4d=1}}


==See also==
==See also==
*[[Moving Water]]
*[[Moving water (Source)|Moving water]]


[[category:SFX_Brush_Entities]]
[[Category:SFX_Brush_Entities]]
[[Category:Water]]
[[Category:Water]]

Latest revision as of 15:23, 24 May 2025

English (en)Translate (Translate)
C++ Class hierarchy
CFuncMoveLinear
↳CBaseToggle
↳CBaseEntity
C++ func_movelinear.cpp

func_water_analog is a brush entity available in all Source Source games. It's a version of func_movelinear slightly specialized for use as water.

Icon-Important.pngImportant:Does not work with the Water shader.
Refract can be used as a workaround for dynamic refraction with cubemapped reflections, although Valve does not provide any materials which do this.
Existing materials which are compatible include:
Confirm:Does the Water shader work if using cubemap reflections and refractions, instead of the real-time versions? This would still be beneficial for the ability to have two normal maps scrolling in different directions.
Icon-Bug.pngBug:Water must be part of the world in Left 4 Dead seriesLeft 4 Dead series Left 4 Dead series otherwise it doesn't work properly and acts as non-solid brush.
Note.pngNote:The SetPosition input and Start Position keyvalue do not perform any bounds checking, so values less than 0 and greater than 1 can be used. Negative values will move in the opposite direction to the movement direction, and values greater than 1 will move it in multiples of the set Move Distance. Moving past the opened/closed position does not trigger the OnFullyOpen and OnFullyClosed outputs.
Icon-Bug.pngBug:There are bugs that may arise when parenting this entity to any of these: func_movelinear, func_lookdoor, func_water_analog. A func_door (or for func_water_analog, func_water) can be used as a workaround. (see here for a code fix)[ Code Fix]
Confirm:Might be fixed in Portal 2? Parented movelinears are used extensively for this game's piston platforms.
Icon-Bug.pngBug:In Black Mesa Black Mesa, if this entity uses multiple brushes, VPhysics objects work incorrectly with this entity (the same for func_water). It looks like they are using BBox of this entity to calculate physics, instead of using brushes. This issue can be found in Interloper chapter. Separate water into several separate entities to avoid this bug.
Examples.
Note how the hat is "flying in air".
Note how the hat is "flying in air".
Cpp.pngCode:Both func_water_analog and func_movelinear are linked to CFuncMoveLinear C++ class. The game code checks the classname KV to distinguish between them.

Keyvalues

Water Material (WaterMaterial) <material> (only in Black Mesa)
The material to derive water information from. Determines $underwateroverlay that use func_water_analog.
Icon-Bug.pngBug:Don't work after reload. You still can repeat this effect with trigger and env_screenoverlay.
Wave Height (WaveHeight) <string> (only in Black Mesa)


Note.pngNote:Other Keyvalues / Inputs / Outputs are same as func_movelinear.

See also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Func_water_analog&oldid=479846"