ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.geom 

Utils3D  - AS3

Paketflash.geom
Klassepublic class Utils3D
VererbungUtils3D Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Utils3D-Klasse enthält statische Methoden, die die Implementierung bestimmter dreidimensionaler Matrixvorgänge vereinfachen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D
[statisch] Interpoliert die Ausrichtung eines Objekts gegenüber einer Position.
Utils3D
  
[statisch] Mithilfe eines Matrix3D-Projektionsobjekts wird ein Vector3D-Objekt von einer Raumkoordinate auf eine andere projiziert.
Utils3D
  
projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void
[statisch] Mithilfe eines Matrix3D-Objekts wird ein Vektor dreidimensionaler Raumkoordinaten („verts“) auf einen Vektor zweidimensionaler Raumkoordinaten („projectedVerts“) projiziert.
Utils3D
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Methodendetails

pointTowards

()Methode
public static function pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Interpoliert die Ausrichtung eines Objekts gegenüber einer Position. Die pointTowards()-Methode kombiniert die Funktionen der Matrix3D.pointAt()- und der Matrix3D.interpolateTo()-Methode.

Die pointTowards()-Methode ermöglicht die direkte Änderung der Ausrichtung. Sie zerlegt die Matrix3D des Anzeigeobjekts und ersetzt die Drehungselemente durch Elemente, die eine prozentweise Drehung in Richtung der Zielposition bewirken. Das Objekt kann sich inkrementell in Richtung Ziel drehen, während es sich weiterhin in seine eigene Richtung bewegt. Aufeinanderfolgende Aufrufe der pointTowards()-Methode gefolgt von einer Versetzungsmethode ermöglichen eine Animation, bei der ein Objekt einem sich bewegenden Ziel folgt. Versetzen Sie das Objekt zuerst einen Prozentpunkt in Richtung Ziel und bewegen Sie es dann inkrementell entlang der Achse.

Parameter

percent:Number — Eine Zahl zwischen 0 und 1, die das Objekt inkrementell in Richtung Ziel dreht.
 
mat:Matrix3D — Die Matrix3D-Eigenschaft des Objekts, das transformiert wird.
 
pos:Vector3D — Die auf die Welt bezogene Position des Zielobjekts. „Auf die Welt bezogen“ bezeichnet die Transformation des Objekts relativ zum Raum der Welt und den Koordinaten, die angeben wo die Objekte dort platziert sind.
 
at:Vector3D (default = null) — Der objektbezogene Vektor, der festlegt, in welche Richtung das Anzeigeobjekt weist. „Objektbezogen“ bezeichnet die Transformation des Objekts relativ zum Objektraum, dem eigenen Bezugsrahmen des Objekts mit seinem eigenen Koordinatensystem. Der Standardwert ist (0,0,-1).
 
up:Vector3D (default = null) — Der objektbezogene Vektor, der die Aufwärtsrichtung des Anzeigeobjekts definiert. Wenn das Objekt so gezeichnet ist, dass es von oben nach unten zeigt, dann ist die +z-Achse der nach oben zeigende Vektor. „Objektbezogen“ bezeichnet die Transformation des Objekts relativ zum Objektraum, dem eigenen Bezugsrahmen des Objekts mit seinem eigenen Koordinatensystem. Der Standardwert ist (0,-1,0).

Rückgabewerte
Matrix3D — Eine geänderte Version des Matrix3D-Objekts, wie im zweiten Parameter angegeben. Um ein Anzeigeobjekt mithilfe der pointTowards()-Methode zu transformieren, setzen Sie die Matrix3D-Eigenschaft des Anzeigeobjekts auf das zurückgegebene Matrix3D-Objekt.

Verwandte API-Elemente

projectVector

()Methode 
public static function projectVector(m:Matrix3D, v:Vector3D):Vector3D

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Mithilfe eines Matrix3D-Projektionsobjekts wird ein Vector3D-Objekt von einer Raumkoordinate an eine andere projiziert. Die projectVector()-Methode funktioniert wie die Matrix3D.transformVector()-Methode, mit dem Unterschied, dass die projectVector()-Methode das x-, y- und z-Element des ursprünglichen Vector3D-Objekts durch den Projektionstiefenwert dividiert. Der Tiefenwert ist die Entfernung zwischen Auge und Vector3D-Objekt im Anzeige- oder Sichtraum. Der Standardwert dieser Entfernung ist der Wert des z-Elements.

Parameter

m:Matrix3D — Ein Matrix3D-Projektionsobjekt, das die Projektionstransformation implementiert. Wenn ein Anzeigeobjekt über ein PerspectiveProjection-Objekt verfügt, können Sie die perspectiveProjection.toMatrix()-Methode verwenden, um ein Matrix3D-Projektionsobjekt zu erstellen, das auf die untergeordneten Objekte des Anzeigeobjekts angewendet wird. Für komplexere Projektionen verwenden Sie die matrix3D.rawData-Eigenschaft zur Erstellung einer benutzerdefinierten Projektionsmatrix. Es gibt keine integrierte Matrix3D-Methode zur Erstellung eines Matrix3D-Projektionsobjekts.
 
v:Vector3D — Das Vector3D-Objekt, das auf eine neue Raumkoordinate projiziert wird.

Rückgabewerte
Vector3D — Ein neues Vector3D-Objekt mit einer transformierten Raumkoordinate.

Verwandte API-Elemente

projectVectors

()Methode 
public static function projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Mithilfe eines Matrix3D-Objekts wird ein Vektor dreidimensionaler Raumkoordinaten (verts) auf einen Vektor zweidimensionaler Raumkoordinaten (projectedVerts) projiziert. Das projizierte Vector-Objekt sollte zugewiesen werden, bevor es als Parameter verwendet wird.

Die projectVectors()-Methode setzt auch den t-Wert der uvt-Daten. Sie sollten vorab einen Vektor zuweisen, der die uvts-Daten für jeden Koordinatensatz des projizierten Vektors enthält. Legen Sie auch den u- und v-Wert der uvt-Daten fest. Die uvt-Daten sind ein Vektor normalisierter Koordinaten, die für Texturmapping verwendet werden. Die UV-Koordinaten (0,0) entsprechen dem linken oberen Bereich der Bitmap, während (1,1) dem rechten unteren Bereich entspricht.

Diese Methode kann gemeinsam mit der Graphics.drawTriangles()-Methode und der GraphicsTrianglePath-Klasse verwendet werden.

Parameter

m:Matrix3D — Ein Matrix3D-Projektionsobjekt, das die Projektionstransformation implementiert. Sie können ein Matrix3D-Projektionsobjekt mithilfe der Matrix3D.rawData-Eigenschaft erstellen.
 
verts:Vector.<Number> — Ein Zahlenvektor, bei dem jeweils 3 Zahlen die x-, y- und z-Koordinaten eines dreidimensionalen Raums darstellen, beispielsweise Vector3D(x,y,z).
 
projectedVerts:Vector.<Number> — Ein Zahlenvektor, bei dem jeweils zwei Zahlen eine projizierte zweidimensionale Koordinate darstellen, beispielsweise Point(x,y). Sie sollten den Vektor vorab zuweisen. Die projectVectors()-Methode füllt die Werte für jeden projizierten Punkt aus.
 
uvts:Vector.<Number> — Ein Zahlenvektor, bei dem jeweils drei Zahlen die u-, v- und t-Elemente der uvt-Daten darstellen. Die Elemente u- und v stellen die Texturkoordinate für jeden projizierten Punkt dar. Der t-Wert ist der Projektionstiefenwert, die Entfernung zwischen Auge und Vector3D-Objekt im Anzeige- oder Sichtraum. Sie sollten den Vektor vorab zuweisen und den u- und v-Wert festlegen. Die projectVectors()-Methode füllt den t-Wert für jeden projizierten Punkt aus.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.