Light Class (System.Windows.Media.Media3D)

MSDN Library
.NET Development
.NET Framework 3.5
.NET Framework Class Library
System.Windows.Media.Media3D Namespace

Light Class

Light Members
Light Fields
Light Methods
Light Properties
Light Events

Related Links

AffineTransform3D Class
AmbientLight Class
AxisAngleRotation3D Class
Camera Class
ContainerUIElement3D Class
DiffuseMaterial Class
DirectionalLight Class
EmissiveMaterial Class
GeneralTransform2DTo3D Class
GeneralTransform3D Class
GeneralTransform3DCollection Class
GeneralTransform3DCollection.Enumerator Structure
GeneralTransform3DGroup Class
GeneralTransform3DTo2D Class
Geometry3D Class
GeometryModel3D Class
HitTestParameters3D Class
Material Class
MaterialCollection Class
MaterialCollection.Enumerator Structure
MaterialGroup Class
Matrix3D Structure
Matrix3DConverter Class
MatrixCamera Class
MatrixTransform3D Class
MeshGeometry3D Class
Model3D Class
Model3DCollection Class
Model3DCollection.Enumerator Structure
Model3DGroup Class
ModelUIElement3D Class
ModelVisual3D Class
OrthographicCamera Class
PerspectiveCamera Class
Point3D Structure
Point3DCollection Class
Point3DCollection.Enumerator Structure
Point3DCollectionConverter Class
Point3DConverter Class
Point4D Structure
Point4DConverter Class
PointLight Class
PointLightBase Class
ProjectionCamera Class
Quaternion Structure
QuaternionConverter Class
QuaternionRotation3D Class
RayHitTestParameters Class
RayHitTestResult Class
RayMeshGeometry3DHitTestResult Class
Rect3D Structure
Rect3DConverter Class
RotateTransform3D Class
Rotation3D Class
ScaleTransform3D Class
Size3D Structure
Size3DConverter Class
SpecularMaterial Class
SpotLight Class
Transform3D Class
Transform3DCollection Class
Transform3DCollection.Enumerator Structure
Transform3DGroup Class
TranslateTransform3D Class
Vector3D Structure
Vector3DCollection Class
Vector3DCollection.Enumerator Structure
Vector3DCollectionConverter Class
Vector3DConverter Class
Viewport2DVisual3D Class
Viewport3DVisual Class
Visual3D Class
Visual3DCollection Class
Visual3DCollection.Enumerator Structure

Light Class
This page is specific to:.NET Framework Version:3.03.54.0

.NET Framework Class Library

Light Class

Model3D object that represents lighting applied to a 3-D scene.

Namespace: System.Windows.Media.Media3D
Assembly: PresentationCore (in PresentationCore.dll)

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim instance As Light

'Declaration

Public MustInherit Class Light _
    Inherits Model3D

XAML

This class is abstract; see Inheritance Hierarchy for derived non-abstract classes usable in XAML.

Remarks

Because lights are models themselves, you can apply transformations and animations to them, just as with other models.

Examples

The following excerpts show examples of two Light types, DirectionalLight and AmbientLight.

XAML

<DockPanel>
  <Viewport3D Name="myViewport">

    <Viewport3D.Camera>
      <PerspectiveCamera FarPlaneDistance="20" LookDirection="5,-2,-3" UpDirection="0,1,0" NearPlaneDistance="0" Position="-5,2,3" FieldOfView="45" />
    </Viewport3D.Camera>

    <ModelVisual3D x:Name="topModelVisual3D">
      <ModelVisual3D.Children>
        <ModelVisual3D>
          <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="-3,-4,-5" />
          </ModelVisual3D.Content>
        </ModelVisual3D>

        <ModelVisual3D>
          <ModelVisual3D.Content>
            <GeometryModel3D Geometry="{StaticResource myTeapot}">
              <GeometryModel3D.Material>
                <DiffuseMaterial>
                  <DiffuseMaterial.Brush>
                    <SolidColorBrush Color="Blue" Opacity="1.0" />
                  </DiffuseMaterial.Brush>
                </DiffuseMaterial>
              </GeometryModel3D.Material>
              <GeometryModel3D.Transform>
                <RotateTransform3D>
                  <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D x:Name="myAngleRotation" Axis="0,3,0" Angle="1" />
                  </RotateTransform3D.Rotation>
                </RotateTransform3D>
              </GeometryModel3D.Transform>
            </GeometryModel3D>
          </ModelVisual3D.Content>
        </ModelVisual3D>


      </ModelVisual3D.Children>
    </ModelVisual3D>


    <Viewport3D.Triggers>

      <EventTrigger RoutedEvent="Viewport3D.Loaded">
        <BeginStoryboard>
          <Storyboard>
            <DoubleAnimation 
              Storyboard.TargetName="myAngleRotation"
              Storyboard.TargetProperty="Angle"
              From="0" To="360" Duration="0:0:10"
              RepeatBehavior="Forever" />
          </Storyboard>
        </BeginStoryboard>
      </EventTrigger>
    </Viewport3D.Triggers>


  </Viewport3D>
</DockPanel>

XAML

<ModelVisual3D.Content>
    <AmbientLight Color="#333333" />
</ModelVisual3D.Content>

Inheritance Hierarchy

System..::.Object
  System.Windows.Threading..::.DispatcherObject
    System.Windows..::.DependencyObject
      System.Windows..::.Freezable
        System.Windows.Media.Animation..::.Animatable
          System.Windows.Media.Media3D..::.Model3D
            System.Windows.Media.Media3D..::.Light
              System.Windows.Media.Media3D..::.AmbientLight
              System.Windows.Media.Media3D..::.DirectionalLight
              System.Windows.Media.Media3D..::.PointLightBase

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Light Members

System.Windows.Media.Media3D Namespace