View source for Sky camera

{{lang|title=sky_camera}}

{{infotable
|sky_camera
|img=[[File:sky_camera.png]] [[File:Missing entity icon.png]] [[File:Missing entity icon (blue).png]]
|type=e0
|engine={{source|4}} {{source2|4}}
|in=0
}}

{{entity|sky_camera|type=e0}} It is used to mark the position of the map's origin inside the [[3D Skybox]]. As your position changes relative to the maps origin it will be scaled and applied relative to the <code>sky_camera</code>.

When the map is compiled, the areas containing <code>sky_camera</code>(s) are skipped during vis calculations. This can be overridden by <code>-forceskyvis</code> on [[VBSP]].

By default, only one <code>sky_camera</code> may be active at a time and it cannot move.
{{ModernTip|<br>
* There is a trick to emulate multiple or moving 3D Skyboxes in any game. More info [https://tf2maps.net/threads/multiple-3d-skyboxes.35829 here].
* Duplicate your main [[env_fog_controller]] and then turn that into a <code>sky_camera</code> so that the fog settings will be carried over.}}
{{ModernNote|fog values on <code>sky_camera</code> cannot be changed through inputs (unlike {{ent|env_fog_controller}}) and the max density keyvalue is missing from the FGD by default.}}
{{ModernCodenote|There is some leftover code for multiple <code>sky_camera</code> entities which can be restored in mods. Half-Life 2: Downfall has restored this feature and the work involved is open-source. Downfall's repository can be found [https://github.com/DownFall-Team/DownFall here]. {{Game link|Mapbase}} uses the aforementioned Downfall code and also adds native support for moving (and rotating) skyboxes. Mapbase's repository can be found [https://github.com/mapbase-source/source-sdk-2013 here].}}

== Keyvalues ==
{{KV|Name|string|intn=targetname|The [[targetname]] that other entities refer to this entity by.|nofgd=1}}
{{KV|3D Skybox scale|integer|This number determines how large objects in your skybox will seem relative to the map. Take a skybox scale of 16, an object 1 unit high in the skybox will seem to be 16 units high to player.}}
{{KV|Fog Enable|boolean|Enable Fog in the Skybox by Default}}
{{KV|Fog Blend|boolean|This will enable blending between two fog colors, based on the direction the player is looking. If the player's viewpoint is equal to the ''fogdir'' vector, the fog will be drawn with the secondary color; if facing in the complete opposite direction, the fog will be drawn with the primary color. <br/> This can be used to approximate the aesthetic effect of diffuse light filtering through the fog, but since the fog effect color is changed for the entire rendered scene, it is best to keep the two colors relatively close to make the blending less obvious. <br/> For example, sunlight with a yaw of 45 degrees and a pitch of -45 degrees could be enhanced using a '''fogdir''' of '-1 -1 1', a '''fogcolor''' of '120 110 100' and a '''fogcolor2''' of '80 70 60'.}}
{{KV|Use Angles for Fog Dir|boolean}}
{{KV|Primary Fog Color|color255|The Primary Color of the Fog in the Skybox}}
{{KV|Secondary Fog Color|color255|The Secondary Color of the Fog in the Skybox that will be blended to}}
{{KV|Primary Fog Dir|string|A vector (given by three space-separated numbers X Y Z) which points from the secondary fog color '''fogcolor2''' towards the primary fog color '''fogcolor'''.}}
{{KV|Fog Start|string|How far from the point-of-view the fog should start. Generally, this should be the same setting as your env_fog_controller.}}
{{KV|Fog End|string|How far from the point-of-view the view should be completely fogged. Generally, this should be the same setting as your env_fog_controller.}}
{{KV|Fog Max Density|float| Fog Max Density [0..1].|nofgd=1}}
{{KV Angles}}

== Inputs ==
{{IO|ActivateSkybox|Activates targeted sky_camera and disables rest.|since=L4D2|nofgd=1}} {{ModernWarning|Should your skyboxes have models or brushwork capable of throwing shadows, '''all shadows of all props from all skyboxes''' will compile shadows onto your map. Even when the skybox is switched, the shadows on your map will remain.}}

== See also ==
* [[3D Skybox]]
* [[Skybox Basics]] - an overview article on skybox creation.

[[Category:Skybox]]