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

Func monitor: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
m (→‎Inputs: Substituted IO templates)
 
(20 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{base brush|func_monitor}} It displays a real-time scene captured from a [[point_camera]] somewhere else in the world.
{{Ent not in fgd}}
{{CD|CFuncMonitor|base=CFuncBrush|file1=Func_Monitor.cpp}}
{{this is a|brush entity|name=func_monitor|except=Left 4 Dead series|engine=Source|engine1=Source 2}} It displays a real-time scene captured from a [[point_camera]] somewhere else in the world.


For the entity to work, the surface(s) on which the camera view will be displayed must have a material with <code>[[$basetexture]] _rt_Camera</code>. Stock materials that work are <code>dev\dev_combinemonitor*</code> and <code>dev\dev_tvmonitor*</code>.
In {{src|4}} for the entity to work, the surface(s) on which the camera view will be displayed must have a material with <code>[[$basetexture]] _rt_Camera</code>. Stock materials that work are <code>dev\dev_combinemonitor*</code> and <code>dev\dev_tvmonitor*</code>.


[[File:City17 trainstation.jpg|250px|thumbnail|right|A broadcast from Dr. Breen.]]
[[File:City17 trainstation.jpg|250px|thumbnail|right|A broadcast from Dr. Breen.]]


{{note|Unless you set up multiple render textures in your mod's binaries, ''only one'' point_camera can be rendered at any one time. The first camera in the map will appear on all monitors.}}
{{bug|Cameras may fail to network properly in multiplayer. See below for a code fix. Fixed in {{tf2|2.bold}}.}}
 
{{note|Unless you set up multiple render textures in your mod's binaries, ''only one'' point_camera can be rendered at any one time. The first camera in the map will appear on all monitors. Multiple cameras at once are technically possible, as long as you ensure that only one func_monitor is in the [[PVS]] at any given time, although this will not work in splitscreen (but will work in online multiplayer).}}
{{codenote|To enable monitors in your non-HL2 mod, you must:
{{codenote|To enable monitors in your non-HL2 mod, you must:
* Include the entity's client .cpp file (found in <code>\client\hl2\</code>).
* Include the entity's client .cpp file (found in <code>\client\hl2\</code>).
Line 12: Line 14:
* <code>#define USE_MONITORS</code> at the top of <code>\client\viewrender.cpp</code> and <code>\client\view.cpp</code>.
* <code>#define USE_MONITORS</code> at the top of <code>\client\viewrender.cpp</code> and <code>\client\view.cpp</code>.
* Fix a multiplayer bug in <code>CPointCamera::CPointCamera()</code> by setting <code>m_bActive</code> to true.}}
* Fix a multiplayer bug in <code>CPointCamera::CPointCamera()</code> by setting <code>m_bActive</code> to true.}}
{{bug|{{tf2}} Doesn't render at all.}}
{{bug|{{l4d2}} It is possible to create this entity with custom gcf but is still unknown by the game}}


==Keyvalues==
==Keyvalues==
{{KV func_brush}}
{{KV Targetname}}
{{KV|Camera name|targetname|The camera to render.}}
{{KV|Camera name|intn=target|targetname|The camera to render.}}


==Inputs==
==Inputs==
{{I func_brush}}
{{I|SetCamera|Sets the camera to use for this monitor. Takes the name of a {{ent|point_camera}} entity in the map.|param=targetname}}
{{IO|SetCamera|targetname|The [[point_camera]] to render.}}
{{I|Toggle|Enables the entity if it is disabled, and disables if it is enabled.}}
 
{{I|Enable|Make the entity visible and solid.}}
{{IO|Toggle|Enables the entity if it is disabled, and disables if it is enabled.}}
{{I|Disable|Make the entity invisible and non-solid.}}
 
{{IO|Enable|Make the entity visible and solid.}}


{{IO|Disable|Make the entity invisible and non-solid.}}
== FGD Code ==
{{CodeBlock|<nowiki>@SolidClass base(func_brush) = func_monitor :
"A monitor that renders the view from a given point_camera entity."
[
target(target_destination) : "Camera name"
// Inputs
input Toggle(void) : "Toggle - If on, turn off, if off, turn on."
input Enable(void) : "Enable."
input Disable(void) : "Disable."
input SetCamera(string) : "Sets the camera to use for this monitor. Takes the name of a point_camera entity in the map."
]
</nowiki>}}


==Outputs==
{{O Targetname}}
==See also==
==See also==
* [[info_camera_link]] - For rendering point_cameras on [[model]]s.
* {{ent|info_camera_link}} - For rendering point_cameras on [[model]]s.
* [[point_camera]]
* {{ent|point_camera}}
* {{ent|env_speaker}}
[[Category:Camera]]
[[Category:Camera]]

Latest revision as of 10:56, 21 April 2025

Icon-NotInFGD.png
This entity is not in the Counter-Strike: Source FGD by default.
See below for instructions on making it available.
C++ Class hierarchy
CFuncMonitor
↳CFuncBrush
↳CBaseEntity
C++ Func_Monitor.cpp

func_monitor is a brush entity available in all Source Source and Source 2 Source 2 games except Left 4 Dead seriesLeft 4 Dead series Left 4 Dead series. It displays a real-time scene captured from a point_camera somewhere else in the world.

In Source Source for the entity to work, the surface(s) on which the camera view will be displayed must have a material with $basetexture _rt_Camera. Stock materials that work are dev\dev_combinemonitor* and dev\dev_tvmonitor*.

A broadcast from Dr. Breen.
Icon-Bug.pngBug:Cameras may fail to network properly in multiplayer. See below for a code fix. Fixed in Team Fortress 2 Team Fortress 2.  [todo tested in ?]
Note.pngNote:Unless you set up multiple render textures in your mod's binaries, only one point_camera can be rendered at any one time. The first camera in the map will appear on all monitors. Multiple cameras at once are technically possible, as long as you ensure that only one func_monitor is in the PVS at any given time, although this will not work in splitscreen (but will work in online multiplayer).
Cpp.pngCode:To enable monitors in your non-HL2 mod, you must:
  • Include the entity's client .cpp file (found in \client\hl2\).
  • Include the entity's server .cpp and .h files (found in \server\hl2\).
  • #define USE_MONITORS at the top of \client\viewrender.cpp and \client\view.cpp.
  • Fix a multiplayer bug in CPointCamera::CPointCamera() by setting m_bActive to true.

Keyvalues

Name (targetname) <string>[ Edit ]
The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.
See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Camera name (target) <targetname>
The camera to render.

Inputs

SetCamera <targetnameRedirectInput/string>
Sets the camera to use for this monitor. Takes the name of a point_camera entity in the map.
Toggle
Enables the entity if it is disabled, and disables if it is enabled.
Enable
Make the entity visible and solid.
Disable
Make the entity invisible and non-solid.

FGD Code

@SolidClass base(func_brush) = func_monitor : "A monitor that renders the view from a given point_camera entity." [ target(target_destination) : "Camera name" // Inputs input Toggle(void) : "Toggle - If on, turn off, if off, turn on." input Enable(void) : "Enable." input Disable(void) : "Disable." input SetCamera(string) : "Sets the camera to use for this monitor. Takes the name of a point_camera entity in the map." ]

See also

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