Share via

2.31.3.13 CT_SpotLight

  • Article

Target namespace: http://schemas.microsoft.com/office/drawing/2017/model3d

Referenced by: CT_Model3D

Represents a spot light in the CT_Model3D element.

Child Elements:

clr: A CT_Color ([MS-DOCX] section 2.6.3.3) element that specifies the color values of the spot light.

intensity: A CT_PositiveRatio (section 2.31.3.16) element that specifies the intensity of the spot light, represented in Candela.

pos: A CT_Point3D ([ISO/IEC29500-1:2016] section A.4.1) element that specifies the position of the spot light in world space.

lookAt: A CT_Point3D ([ISO/IEC29500-1:2016] section A.4.1) element that specifies the position the spot light points to in the world space.

extLst: A CT_OfficeArtExtensionList ([ISO/IEC29500-1:2016] section A.4.1) element that specifies the extension list in which all future extensions of element type ext are defined. The extension list, along with corresponding future extensions, is used to extend the storage capabilities of the DrawingML framework. This enables various new types of data to be stored natively in the framework.

Attributes:

enabled: A boolean ([XMLSCHEMA2/2] section 3.2.2) attribute that specifies whether the light is on or off.

rad: An ST_PositiveCoordinate ([ISO/IEC29500-1:2016] section A.4.1) attribute that specifies the radius, or distance, of the light, represented in EMUs.

spotAng: An ST_FOVAngle ([ISO/IEC29500-1:2016] section A.4.1) attribute that specifies the angle of the spot light.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

 <xsd:complexType name="CT_SpotLight">
   <xsd:sequence>
     <xsd:element name="clr" type="a:CT_Color" minOccurs="1" maxOccurs="1"/>
     <xsd:element name="intensity" type="CT_PositiveRatio" minOccurs="1" maxOccurs="1"/>
     <xsd:element name="pos" type="a:CT_Point3D" minOccurs="1" maxOccurs="1"/>
     <xsd:element name="lookAt" type="a:CT_Point3D" minOccurs="1" maxOccurs="1"/>
     <xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
   </xsd:sequence>
   <xsd:attribute name="enabled" type="xsd:boolean" use="optional" default="true"/>
   <xsd:attribute name="rad" type="a:ST_PositiveCoordinate" use="required"/>
   <xsd:attribute name="spotAng" type="a:ST_FOVAngle" use="required"/>
 </xsd:complexType>

See section 5.29 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).