Func reflective glass: Difference between revisions

Latest revision as of 13:34, 29 August 2025

Class hierarchy
CFuncReflectiveGlass ↳CFuncBrush ↳CBaseEntity
`func_reflective_glass.cpp`

func_reflective_glass (Note how NPC's and env effects are reflected)

func_reflective_glass is a brush entity available in all Source games since Source 2007.

Entity description

It is used to produce perfectly reflective glass that renders world + entities. You must use a LightmappedReflective texture (glass/reflectiveglass001.vmt is a good start) on one side of the brush, and the rest of the sides either nodraw or some other opaque texture for this to work properly. It is functionally identical to expensive water shaders, but typically used with opaque, flat materials.

Note:This entity will not show a player their own reflection in first person (except in

Garry's Mod). It will only show if the client is rendering their own player model (e.g. In third person)

Note:This entity may be constructed from more than one brush, but all LightmappedReflective faces must be on the same

plane to work as intended.

Bug:CSM shadows do not render on the brush. [todo tested in ?]

Bug:This entity will always be drawn in front of translucent textures, including particles and sprites. [todo tested in ?]

Bug:This entity will cease to render or cause visual artifacts if expensive water and/or func_areaportals are in a visible visleaf (meaning they can see each other). [todo tested in ?]

Bug:If more than one face of this brush entity contain a reflective or translucent texture, then the mirror's behavior will suddenly switch depending on one's perspective. To prevent this, make sure exactly one surface has the reflective texture. All others must be opaque. [todo tested in ?]

Bug:In

Portal, unless r_portal_stencil_depth is set to 0 (which disables portal rendering):

Having linked portals present near the mirror, or if they are present anywhere within the players' view range (even if they are not being reflected) will cause heavy visual artifacts. The effects are more intense if more portals are reflected and/or more portals are within the players' view range.
The view through portals renders incorrectly or not at all when viewed through a mirror.
If a mirror is viewed through a portal, the mirror will still reflect based on the players' absolute position rather than the relative position from the other portal, which causes the mirror to display inaccurately.
If r_portal_stencil_depth is greater than 2, the game may crash when attempting to look through portals that can see each other and the mirror.

Bug:In

Black Mesa, LightmappedReflective doesn't work (shows wireframe instead of surface with reflection). Despite this, the entity still creates the reflection camera. This means that it still can heavily reduce performance. The old (pre-2007) method can be used as a workaround, but only for floors.

Tip:To keep the framerate high, use triggers to disable the entity while not needed.

Note:All Keyvalues / Inputs / Outputs are same as func_brush.

@@ Line 1: / Line 1: @@
+{{CD|CFuncReflectiveGlass|file1=func_reflective_glass.cpp}}
 [[File:Reflectiveglass0000.jpg|thumb|250px|func_reflective_glass (Note how NPC's and env effects are reflected)]]
+{{this is a|brush entity|name=func_reflective_glass|since=Source 2007}}
-{{base brush|func_reflective_glass}}
+==Entity description==
+It is used to produce perfectly reflective glass that renders world + entities. You must use a '''[[LightmappedReflective]]''' texture ({{file|glass/reflectiveglass001|vmt}} is a good start) on one side of the brush, and the rest of the sides either [[Tool textures|nodraw]] or some other opaque texture for this to work properly.
+It is functionally identical to [[Water (shader)|expensive water shaders]], but typically used with opaque, flat materials.
-==Entity description==
-It is used to produce perfectly reflective glass that renders world + entities. You must use a [[LightmappedReflective]] texture (glass/reflectiveglass001.vmt is a good start) on one side of the brush, and the rest of the sides either [[Tool textures|nodraw]] or some other opaque texture for this to work properly.
-It is functionally identical to [[Water|expensive water shaders]], but typically used with opaque, flat materials.
-{{note|This entity will not show a player their own reflection in first person, but it will render all player models that are actually being drawn.}}
+{{note|This entity will not show a player their own reflection in first person (except in {{gmod|4}}). It will only show if the client is rendering their own player model (e.g. In third person)}}
-{{note|This entity may be constructed from more than one brush, but all [[LightmappedReflective]] faces must be on the same [[Wikipedia:Plane (geometry)|plane]] to work as intended.}}
+{{note|This entity may be constructed from more than one brush, but all [[LightmappedReflective]] faces must be on the same {{w|Plane (geometry)|plane}} to work as intended.}}
+{{Bug|1=[[CSM]] shadows do not render on the brush.|since=csgo}}
 {{Bug|This entity will always be drawn in front of translucent textures, including particles and sprites.}}
-{{Bug|This entity will cease to render or cause visual artifacts if water and or portals are in a visible visleaf.}}
+{{Bug|This entity will cease to render or cause visual artifacts if expensive water and/or [[func_areaportal]]s are in a visible visleaf (meaning they can see each other).}}
 {{Bug|If more than one face of this brush entity contain a reflective or translucent texture, then the mirror's behavior will suddenly switch depending on one's perspective. To prevent this, make sure ''exactly one'' surface has the reflective texture. All others must be opaque.}}
+{{Bug|hidetested=1|In {{portal|4}}, unless <code>r_portal_stencil_depth</code> is set to 0 (which disables portal rendering):
-==Keyvalues==
+* Having linked portals present near the mirror, or if they are present anywhere within the players' view range (even if they are not being reflected) will cause heavy visual artifacts. The effects are more intense if more portals are reflected and/or more portals are within the players' view range.
-{{KV|Solidity (Solidity)|choices|Used to control the solidity/collision of these brushes.
+* The view through portals renders incorrectly or not at all when viewed through a mirror.
-:*0: Toggle - The solidity can be toggled together with its visibility.
+* If a mirror is viewed through a portal, the mirror will still reflect based on the players' absolute position rather than the relative position from the other portal, which causes the mirror to display inaccurately.
-:*1: Never Solid
+* If <code>r_portal_stencil_depth</code> is greater than 2, the game may crash when attempting to look through portals that can see each other and the mirror.
-:*2: Always Solid}}
+}}
-{{KV|Solid BSP (solidbsp)|bool|Set this to BSP if the player seems to rotate oddly relative to the surface.
+{{Bug|hidetested=1|In {{bms|2}}, [[LightmappedReflective]] doesn't work (shows [[wireframe]] instead of surface with reflection). Despite this, the entity still creates the reflection camera. This means that it still can heavily reduce performance. The [[True reflections under CSS|old (pre-2007) method]] can be used as a workaround, but only for floors.}}
-:*0: [[VPhysics]]
+{{Tip|To keep the framerate high, use [[trigger]]s to disable the entity while not needed.}}
-:*1: BSP ([[QPhysics]])}}
+{{OtherKIO|func_brush|All}}
-{{KV|NPC class excluded from collisions (excludednpc)|classname|If an NPC classname (i.e. {{ent|npc_zombie}}) is specified here, NPCs of that type won't collide with these brushes.}}
-{{KV|Invert NPC class exclusion (invert_exclusion)|bool|If set, then the excluded NPC class will consider this brush solid, and all ''other'' NPC classes will consider it non-solid.}}
-{{KV EnableDisable}}
-:{{tip|If '''Solidity''' is ''Toggle'', disabling will also make the entity non-solid.}}
-{{KV visiblebrush|l4d=1}}
-{{KV BaseEntity|brush=1}}
-==Flags==
-*2: Ignore player +USE - Entity will ignore all {{ent|Use}} inputs, including ones from the player.
-==Inputs==
-{{IO|SetExcluded|Change the NPC class that does not collide with the brush.}}
-{{IO|SetInvert|Whether to reverse the NPC class exclusion rule.}}
-{{I EnableDisable}}
-{{I visiblebrush|portal2=1}}
-{{I BaseEntity}}
-==Outputs==
-{{O BaseEntity|l4d=1}}
 == See also ==
 *[[LightmappedReflective]], the material shader used for this entity.
-* [http://www.youtube.com/watch?v=5NJMh5O-lIQ YouTube tutorial: How to make a mirror]
+* {{youtube|5NJMh5O-lIQ|page=watch|YouTube tutorial: How to make a mirror}}
+* {{ent|prop_mirror}} {{portal2|only|addtext={{p2ce}}}}: an alternate method of creating an albeit simple real-time reflection

Func reflective glass: Difference between revisions

Latest revision as of 13:34, 29 August 2025

Entity description

See also

Navigation menu

Search