Quaternion Struct

Definition

Estructura que representa un giro tridimensional.Structure that represents a rotation in three dimensions.

public value class Quaternion : IFormattable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.Media3D.QuaternionConverter))]
public struct Quaternion : IFormattable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.Media3D.QuaternionConverter))]
[System.Serializable]
public struct Quaternion : IFormattable
type Quaternion = struct
    interface IFormattable
Public Structure Quaternion
Implements IFormattable
Inheritance
Quaternion
Attributes
Implements

Examples

<!-- Trigger the rotation animation when the 3D object loads. -->
<Viewport3D.Triggers>
  <EventTrigger RoutedEvent="Viewport3D.Loaded">
    <BeginStoryboard>
      <Storyboard>

        <!-- This animation animates the Rotation property of the RotateTransform3D
             causing the 3D shape to rotate. -->
        <QuaternionAnimation
         Storyboard.TargetName="myQuaternionRotation3D"
         Storyboard.TargetProperty="Quaternion" From="0,0,1,0" To="0.3, 0.3, 1, 0" 
         Duration="0:0:2" />

      </Storyboard>
    </BeginStoryboard>
  </EventTrigger>
</Viewport3D.Triggers>
//Read new settings
try
{
    Double WValue = System.Convert.ToDouble(QuaternionWText.Text);
    Double XValue = System.Convert.ToDouble(QuaternionXText.Text);
    Double YValue = System.Convert.ToDouble(QuaternionYText.Text);
    Double ZValue = System.Convert.ToDouble(QuaternionZText.Text);

    endQuaternion = new Quaternion(XValue, YValue, ZValue, WValue);
}
catch
{
    MessageBox.Show("Set non-null values for the quaternion.");
}

myQuaternionRotation3D = new QuaternionRotation3D(endQuaternion);
myRotateTransform3D.Rotation = myQuaternionRotation3D;

//update matrix display
qrotationMatrix3D = myRotateTransform3D.Value;
'Read new settings
Try
    Dim WValue As Double = Convert.ToDouble(QuaternionWText.Text)
    Dim XValue As Double = Convert.ToDouble(QuaternionXText.Text)
    Dim YValue As Double = Convert.ToDouble(QuaternionYText.Text)
    Dim ZValue As Double = Convert.ToDouble(QuaternionZText.Text)

    endQuaternion = New Quaternion(XValue, YValue, ZValue, WValue)
Catch
    MessageBox.Show("Set non-null values for the quaternion.")
End Try

myQuaternionRotation3D = New QuaternionRotation3D(endQuaternion)
myRotateTransform3D.Rotation = myQuaternionRotation3D

'update matrix display
qrotationMatrix3D = myRotateTransform3D.Value

Remarks

Los cuaterniones permiten interpolar entre las transformaciones de giro aplicadas a un objeto, por lo que resulta más fácil calcular animaciones suaves de rotación.Quaternions allow you to interpolate between rotation transformations applied to an object, thereby making it easier to compute smooth animations of rotations. Un cuaternión representa un eje de giro y un giro alrededor de ese eje.A quaternion represents an axis of rotation and a rotation around that axis. Es posible definir de forma individual el eje y el ángulo de giro de las posiciones inicial y final de un objeto girado, pero las posiciones intermedias de ese objeto durante una animación son desseguras computacionalmente.It's possible to individually define the axis and angle of rotation of the starting and ending positions of a rotated object ,but the intermediate positions of that object during an animation are computationally uncertain. Al determinar un cuaternión que representa la orientación original de un objeto 3D y otro que representa su orientación de destino, se puede interpolar sin problemas entre esas orientaciones.By determining a quaternion that represents the original orientation of a 3-D object and one that represents its destination orientation, you can smoothly interpolate between those orientations.

En XAML, el delimitador entre los valores de un Quaternion puede ser una coma o un espacio.In XAML, the delimiter between the values of a Quaternion can be either a comma or a space.

Algunas referencias culturales pueden utilizar el carácter de coma como delimitador decimal en lugar del carácter de punto.Some cultures might use the comma character as the decimal delimiter instead of the period character. El procesamiento XAML de la referencia cultural invariable tiene como valor predeterminado en-US en la mayoría de las implementaciones de procesador XAML y espera que el punto sea el delimitador decimal.XAML processing for invariant culture defaults to en-US in most XAML processor implementations, and expects the period to be the decimal delimiter. Debe evitar usar el carácter de coma como delimitador decimal si especifica un Quaternion en XAML, ya que se producirá un conflicto con la conversión de tipo de cadena de un valor de atributo de Quaternion en sus componentes.You should avoid using the comma character as the decimal delimiter if specifying a Quaternion in XAML, because that will clash with the string type conversion of a Quaternion attribute value into its components.

Uso de atributos XAMLXAML Attribute Usage

<object property="x,y,z,w"/>  
-or-  
<object property="x y z w"/>  

Valores XAMLXAML Values

xx
Componente X de esta estructura Quaternion.The X component of this Quaternion structure.

yy
Componente Y de esta estructura Quaternion.The Y component of this Quaternion structure.

zz
Componente Z de esta estructura Quaternion.The Z component of this Quaternion structure.

ww
Componente W de esta estructura Quaternion.The W component of this Quaternion structure.

Constructors

Quaternion(Double, Double, Double, Double)

Inicializa una nueva instancia de la estructura Quaternion.Initializes a new instance of the Quaternion structure.

Quaternion(Vector3D, Double)

Inicializa una nueva instancia de la estructura Quaternion.Initializes a new instance of the Quaternion structure.

Properties

Angle

Obtiene el ángulo del cuaternión, en grados.Gets the quaternion's angle, in degrees.

Axis

Obtiene el eje del cuaternión.Gets the quaternion's axis.

Identity

Obtiene el cuaternión de identidad.Gets the Identity quaternion.

IsIdentity

Obtiene un valor que indica si el cuaternión especificado es un cuaternión con la propiedad Identity.Gets a value that indicates whether the specified quaternion is an Identity quaternion.

IsNormalized

Obtiene un valor que indica si el cuaternión está normalizado.Gets a value that indicates whether the quaternion is normalized.

W

Obtiene el componente W del cuaternión.Gets the W component of the quaternion.

X

Obtiene el componente X del cuaternión.Gets the X component of the quaternion.

Y

Obtiene el componente Y del cuaternión.Gets the Y component of the quaternion.

Z

Obtiene el componente Z del cuaternión.Gets the Z component of the quaternion.

Methods

Add(Quaternion, Quaternion)

Suma los cuaterniones especificados.Adds the specified quaternions.

Conjugate()

Reemplaza un cuaternión por su conjugado.Replaces a quaternion with its conjugate.

Equals(Object)

Compara dos instancias de Quaternion para determinar si sus valores son iguales.Compares two Quaternion instances for equality.

Equals(Quaternion)

Compara dos instancias de Quaternion para determinar si sus valores son iguales.Compares two Quaternion instances for equality.

Equals(Quaternion, Quaternion)

Compara dos instancias de Quaternion para determinar si sus valores son iguales.Compares two Quaternion instances for equality.

GetHashCode()

Devuelve el código hash de Quaternion.Returns the hash code for the Quaternion.

Invert()

Reemplaza el cuaternión especificado por su inverso.Replaces the specified quaternion with its inverse.

Multiply(Quaternion, Quaternion)

Multiplica los valores especificados de Quaternion.Multiplies the specified Quaternion values.

Normalize()

Devuelve un cuaternión normalizado.Returns a normalized quaternion.

Parse(String)

Convierte una representación de cadena de una estructura Quaternion en la estructura Quaternion equivalente.Converts a string representation of a Quaternion into the equivalent Quaternion structure.

Slerp(Quaternion, Quaternion, Double)

Interpola entre dos orientaciones mediante la interpolación lineal esférica.Interpolates between two orientations using spherical linear interpolation.

Slerp(Quaternion, Quaternion, Double, Boolean)

Interpola entre las orientaciones, representadas como estructuras Quaternion, usando la interpolación lineal esférica.Interpolates between orientations, represented as Quaternion structures, using spherical linear interpolation.

Subtract(Quaternion, Quaternion)

Resta un cuaternión de otro.Subtracts a Quaternion from another.

ToString()

Crea una representación de cadena del objeto.Creates a string representation of the object.

ToString(IFormatProvider)

Crea una representación de cadena del objeto.Creates a string representation of the object.

Operators

Addition(Quaternion, Quaternion)

Suma los valores especificados de Quaternion.Adds the specified Quaternion values.

Equality(Quaternion, Quaternion)

Compara dos instancias de Quaternion para determinar si son exactamente iguales.Compares two Quaternion instances for exact equality.

Inequality(Quaternion, Quaternion)

Compara dos instancias de Quaternion para determinar si son exactamente desiguales.Compares two Quaternion instances for exact inequality.

Multiply(Quaternion, Quaternion)

Multiplica el cuaternión especificado por otro.Multiplies the specified quaternion by another.

Subtraction(Quaternion, Quaternion)

Resta un cuaternión especificado de otro.Subtracts a specified quaternion from another.

Explicit Interface Implementations

IFormattable.ToString(String, IFormatProvider)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code. Para una descripción de este miembro, vea ToString(String, IFormatProvider).For a description of this member, see ToString(String, IFormatProvider).

Applies to