env_cubemap

From Source Entities
Jump to navigation Jump to search
weapon_cubemap, an entity for viewing cubemaps.
Env cubemap.png

env_cubemap is an internal point entity present in all Source games. When the buildcubemaps console command is executed, the position of this entity will be used to sample the environment for static reflections. Objects using $envmap will use the nearest cubemap as a reflection.

When built, cubemaps will ignore any objects capable of moving, due to the fact that cubemaps are not able to "update" themselves with the new position of the object. Due to being an internal entity, cubemaps cannot be erased, added or altered after the compile (in any easy and worthwhile way).

Cubemaps should logically be placed around the player's eye level (which varies by game). They should not be placed too close to any object. Place at least one cubemap in each room and anywhere else that the environment changes largely. There aren't any direct consequences, but maps should not be littered with cubemap entities due to bloated file size.

Normally, cubemap textures will automatically be packed into your map. Some games require additional steps for making cubemaps. See Cubemaps on VDC.

Keyvalues[edit | edit source]

Cubemap Size (cubemapsize) <choices>
Resolution of a single side of the cube. Must be less than 1/4th of your screen's smallest dimension.
Warning: Larger sizes can extremely bloat your map's file size, and the amount of resources required to open the map! Only use large sizes where it's really necessary.
Brush faces (sides) <sidelist>
An optional override for individual brush faces, forcing them to use this cubemap instead of the one closest to them. To select faces, press the Pick button then click on them in the 3D view. Hold Ctrl to select multiple faces.