IfcLightSourceSpot

Natural language names
Lichtquelle - Spot
Light Source Spot
Source de lumière ponctuelle
Semantic definitions at the entity
Entity definition
NOTE  Definition according to ISO 10303-46:
The light source spot entity is a subtype of light source. Spot light source entities have a light source colour, position, direction, attenuation coefficients, concentration exponent, and spread angle. If a point lies outside the cone of influence of a light source of this type as determined by the light source position, direction and spread angle its colour is not affected by that light source.
NOTE  The IfcLightSourceSpot adds the BeamWidthAngle which defines the inner cone in which the light source emits light at uniform full intensity. The light source's emission intensity drops off from the inner solid angle (BeamWidthAngle) to the outer solid angle (SpreadAngle).
NOTE  Definition according to ISO/IEC 14772-1:1997:
The Spot light node defines a light source that emits light from a specific point along a specific direction vector and constrained within a solid angle. Spot lights may illuminate geometry nodes that respond to light sources and intersect the solid angle defined by the Spot light. Spot light nodes are specified in the local coordinate system and are affected by ancestors' transformations. Figure 406 shows the definition of spot light.
spot light

Figure 406 — Light source spot

NOTE  Corresponding ISO 10303 entity: light_source_spot. Please refer to ISO/IS 10303-46:1994, p. 33 for the final definition of the formal standard.
NOTE  In addition to the attributes as defined in ISO10303-46 the additional property from ISO/IEC 14772-1:1997 (VRML) Radius, BeamWidth, and QuadricAttenuation are added to this subtype and the AmbientIntensity and Intensity are inherited from the supertype.
HISTORY  New entity in IFC2x, renamed and enhanced in IFC2x2.
Attribute definitions
#AttributeTypeCardinalityDescription G
10OrientationIfcDirection Definition from ISO/CD 10303-46:1992: This is the direction of the axis of the cone of the light source specified in the coordinate space of the representation being projected.. Definition from VRML97 - ISO/IEC 14772-1:1997: The direction field specifies the direction vector of the light's central axis defined in the local coordinate system. X
11ConcentrationExponentIfcReal? Definition from ISO/CD 10303-46:1992: This real is the exponent on the cosine of the angle between the line that starts at the position of the spot light source and is in the direction of the orientation of the spot light source and a line that starts at the position of the spot light source and goes through a point on the surface being shaded. NOTE  This attribute does not exists in ISO/IEC 14772-1:1997.X
12SpreadAngleIfcPositivePlaneAngleMeasure Definition from ISO/CD 10303-46:1992: This planar angle measure is the angle between the line that starts at the position of the spot light source and is in the direction of the spot light source and any line on the boundary of the cone of influence. Definition from VRML97 - ISO/IEC 14772-1:1997: The cutOffAngle (name of spread angle in VRML) field specifies the outer bound of the solid angle. The light source does not emit light outside of this solid angle. X
13BeamWidthAngleIfcPositivePlaneAngleMeasure Definition from VRML97 - ISO/IEC 14772-1:1997: The beamWidth field specifies an inner solid angle in which the light source emits light at uniform full intensity. The light source's emission intensity drops off from the inner solid angle (beamWidthAngle) to the outer solid angle (spreadAngle). X
Inherited definitions from supertypes
Entity inheritance IfcLightSourcePositional IfcLightSource IfcGeometricRepresentationItem IfcRepresentationItem
Attribute inheritance
#AttributeTypeCardinalityDescriptionG
IfcRepresentationItem
LayerAssignmentIfcPresentationLayerAssignment
@AssignedItems
S[0:1]Assignment of the representation item to a single or multiple layer(s). The LayerAssignments can override a LayerAssignments of the IfcRepresentation it is used within the list of Items.
IFC2x3 CHANGE  The inverse attribute LayerAssignments has been added.
IFC4 CHANGE  The inverse attribute LayerAssignment has been restricted to max 1. Upward compatibility for file based exchange is guaranteed.
X
StyledByItemIfcStyledItem
@Item
S[0:1]Reference to the IfcStyledItem that provides presentation information to the representation, e.g. a curve style, including colour and thickness to a geometric curve.
IFC2x3 CHANGE  The inverse attribute StyledByItem has been added.
X
IfcGeometricRepresentationItem
IfcLightSource
1NameIfcLabel? The name given to the light source in presentation. X
2LightColourIfcColourRgb Definition from ISO/CD 10303-46:1992: Based on the current lighting model, the colour of the light to be used for shading. Definition from VRML97 - ISO/IEC 14772-1:1997: The color field specifies the spectral color properties of both the direct and ambient light emission as an RGB value. X
3AmbientIntensityIfcNormalisedRatioMeasure? Definition from VRML97 - ISO/IEC 14772-1:1997: The ambientIntensity specifies the intensity of the ambient emission from the light. Light intensity may range from 0.0 (no light emission) to 1.0 (full intensity). X
4IntensityIfcNormalisedRatioMeasure? Definition from VRML97 - ISO/IEC 14772-1:1997: The intensity field specifies the brightness of the direct emission from the ligth. Light intensity may range from 0.0 (no light emission) to 1.0 (full intensity). X
IfcLightSourcePositional
5PositionIfcCartesianPoint Definition from ISO/CD 10303-46:1992: The Cartesian point indicates the position of the light source. Definition from VRML97 - ISO/IEC 14772-1:1997: A Point light node illuminates geometry within radius of its location. X
6RadiusIfcPositiveLengthMeasure The maximum distance from the light source for a surface still to be illuminated. Definition from VRML97 - ISO/IEC 14772-1:1997: A Point light node illuminates geometry within radius of its location. X
7ConstantAttenuationIfcReal Definition from ISO/CD 10303-46:1992: This real indicates the value of the attenuation in the lighting equation that is constant. X
8DistanceAttenuationIfcReal Definition from ISO/CD 10303-46:1992: This real indicates the value of the attenuation in the lighting equation that proportional to the distance from the light source. X
9QuadricAttenuationIfcReal This real indicates the value of the attenuation in the lighting equation that proportional to the square value of the distance from the light source. X
IfcLightSourceSpot
10OrientationIfcDirection Definition from ISO/CD 10303-46:1992: This is the direction of the axis of the cone of the light source specified in the coordinate space of the representation being projected.. Definition from VRML97 - ISO/IEC 14772-1:1997: The direction field specifies the direction vector of the light's central axis defined in the local coordinate system. X
11ConcentrationExponentIfcReal? Definition from ISO/CD 10303-46:1992: This real is the exponent on the cosine of the angle between the line that starts at the position of the spot light source and is in the direction of the orientation of the spot light source and a line that starts at the position of the spot light source and goes through a point on the surface being shaded. NOTE  This attribute does not exists in ISO/IEC 14772-1:1997.X
12SpreadAngleIfcPositivePlaneAngleMeasure Definition from ISO/CD 10303-46:1992: This planar angle measure is the angle between the line that starts at the position of the spot light source and is in the direction of the spot light source and any line on the boundary of the cone of influence. Definition from VRML97 - ISO/IEC 14772-1:1997: The cutOffAngle (name of spread angle in VRML) field specifies the outer bound of the solid angle. The light source does not emit light outside of this solid angle. X
13BeamWidthAngleIfcPositivePlaneAngleMeasure Definition from VRML97 - ISO/IEC 14772-1:1997: The beamWidth field specifies an inner solid angle in which the light source emits light at uniform full intensity. The light source's emission intensity drops off from the inner solid angle (beamWidthAngle) to the outer solid angle (spreadAngle). X
Formal representations
XML Specification
 <xs:element name="IfcLightSourceSpot" type="ifc:IfcLightSourceSpot" substitutionGroup="ifc:IfcLightSourcePositional" nillable="true"/>
 <xs:complexType name="IfcLightSourceSpot">
  <xs:complexContent>
   <xs:extension base="ifc:IfcLightSourcePositional">
    <xs:sequence>
     <xs:element name="Orientation" type="ifc:IfcDirection" nillable="true"/>
    </xs:sequence>
    <xs:attribute name="ConcentrationExponent" type="ifc:IfcReal" use="optional"/>
    <xs:attribute name="SpreadAngle" type="ifc:IfcPositivePlaneAngleMeasure" use="optional"/>
    <xs:attribute name="BeamWidthAngle" type="ifc:IfcPositivePlaneAngleMeasure" use="optional"/>
   </xs:extension>
  </xs:complexContent>
 </xs:complexType>
EXPRESS Specification
ENTITY IfcLightSourceSpot
 SUBTYPE OF (IfcLightSourcePositional);
  Orientation : IfcDirection;
  ConcentrationExponent : OPTIONAL IfcReal;
  SpreadAngle : IfcPositivePlaneAngleMeasure;
  BeamWidthAngle : IfcPositivePlaneAngleMeasure;
END_ENTITY;

Link to EXPRESS-G diagram EXPRESS-G diagram

Link to this page  Link to this page