Share via

2.31.3.1 CT_AmbientLight

  • Article

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

Referenced by: CT_Model3D

Represents an omni-directional, fixed-intensity, and fixed-color light source in the 3D Model.

Child Elements:

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

illuminance: A CT_PositiveRatio (section 2.31.3.16) element that specifies the total luminous flux on a surface per unit area. The units used are lux (lumen per meter squared).

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.

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

 <xsd:complexType name="CT_AmbientLight">
   <xsd:sequence>
     <xsd:element name="clr" type="a:CT_Color" minOccurs="1" maxOccurs="1"/>
     <xsd:element name="illuminance" type="CT_PositiveRatio" 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:complexType>

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