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

$illumposition: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
(Common misconception (since that's how GoldSrc and IdTech work), so marking as risk of confusion)
Line 9: Line 9:


{{note|$illumposition can be overridden per-entity on most entities (including [[prop_static]]) by using the {{code|lightingorigin}} [[KV]].}}
{{note|$illumposition can be overridden per-entity on most entities (including [[prop_static]]) by using the {{code|lightingorigin}} [[KV]].}}
{{important|The default illumposition is ''not'' the origin of the model, but rather the center of the actual model, based upon the first [[$sequence|sequence]].}}
{{confusion|The default illumposition is ''not'' the origin of the model, but rather the center of the actual model, based upon the first [[$sequence|sequence]].}}
{{note|While illumposition is not used for actual lighting on [[VHV|per-vertex lit]] and [[PPL|lightmaped]] static props, it is still used for dictating which {{ent|env_cubemap}} to use.}}
{{note|While illumposition is not used for actual lighting on [[VHV|per-vertex lit]] and [[PPL|lightmaped]] static props, it is still used for dictating which {{ent|env_cubemap}} to use.}}



Revision as of 11:14, 21 November 2025

English (en)中文 (zh)Translate (Translate)

$illumposition is a QC command available in all Source Source games. It sets the lighting (and cubemap) origin for the model, relative to its origin.

When illuminating an animated or moving model in the engine, the lighting calculations are only done for the two brightest light sources, via the worldlights lump. All the other lights, as well as bounced light from the environment, are taken from a single ambient cube.

You can optionally specify a bone name for the illum position. If you do, the position specified will be interpreted as being relative to the specified bone.

Confirm:If a bone is specified, is the illumposition still a static point on the model, or does it move with the bone in-game?
Note.pngNote:$illumposition can be overridden per-entity on most entities (including prop_static) by using the lightingorigin KV.
Warning.pngRisk of Confusion:The default illumposition is not the origin of the model, but rather the center of the actual model, based upon the first sequence.
Note.pngNote:While illumposition is not used for actual lighting on per-vertex lit and lightmaped static props, it is still used for dictating which env_cubemap to use.

Syntax

$illumposition (x) (y) (z) [optional bone name]

Examples

$illumposition 0.000 0.048 -0.115
$illumposition 0.000 9.21 4.00 ValveBiped.Bip01_Pelvis

See also