MeshGeometry3D.Normals Property (System.Windows.Media.Media3D)

Normals Property

.NET Framework Class Library

MeshGeometry3D..::.Normals Property

Gets or sets a collection of normal vectors for the MeshGeometry3D. This is a dependency property.

Namespace: System.Windows.Media.Media3D
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Property Normals As Vector3DCollection

Visual Basic (Usage)

Dim instance As MeshGeometry3D
Dim value As Vector3DCollection

value = instance.Normals

instance.Normals = value

public Vector3DCollection Normals { get; set; }

Visual C++

public:
property Vector3DCollection^ Normals {
    Vector3DCollection^ get ();
    void set (Vector3DCollection^ value);
}

JScript

public function get Normals () : Vector3DCollection
public function set Normals (value : Vector3DCollection)

XAML Property Element Usage

<object>
  <object.Normals>
    <Vector3DCollection .../>
  </object.Normals>
</object>

XAML Attribute Usage

<object Normals="Vector3DCollection" .../>

Property Value

Type: System.Windows.Media.Media3D..::.Vector3DCollection
Vector3DCollection that contains the normal vectors for the MeshGeometry3D.

Dependency Property Information

Identifier field	NormalsProperty
Metadata properties set to true	None

Remarks

Normal vectors are vectors perpendicular to the face of each triangle that defines a mesh. Normals determine whether a given triangle face is lit.

MeshGeometry3D allows the developer to specify position, normal, and texture coordinate information.

Normals are assumed to be associated with the front faces of a mesh primitive. The winding order (the order in which the Positions that make up each triangle of the mesh are specified) determines whether a given face is front-facing or back-facing.

If normals are not specified, their generation depends on whether the developer has specified triangle indices for the mesh. If triangle indices are specified, normals will be generated that take into account adjacent faces. If triangle indices are not specified, only one normal will be generated for the specified triangle. This might cause a faceted appearance in the mesh.

Examples

XAML

<GeometryModel3D>
  <GeometryModel3D.Geometry>
          <MeshGeometry3D 
              Positions="-1 -1 0  1 -1 0  -1 1 0  1 1 0"
              Normals="0 0 1  0 0 1  0 0 1  0 0 1"
              TextureCoordinates="0 1  1 1  0 0  1 0   "
              TriangleIndices="0 1 2  1 3 2" />
      </GeometryModel3D.Geometry>
      <GeometryModel3D.Material>
          <DiffuseMaterial>
              <DiffuseMaterial.Brush>
                  <SolidColorBrush Color="Cyan" Opacity="0.3"/>
              </DiffuseMaterial.Brush>
          </DiffuseMaterial>
      </GeometryModel3D.Material>
  <!-- Translate the plane. -->
      <GeometryModel3D.Transform>
          <TranslateTransform3D
            OffsetX="2" OffsetY="0" OffsetZ="-1"   >
          </TranslateTransform3D>
      </GeometryModel3D.Transform>
  </GeometryModel3D>

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

MeshGeometry3D Class

MeshGeometry3D Members

System.Windows.Media.Media3D Namespace

Other Resources

3-D Graphics Overview

3-D Solids Sample