Utils3D - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.geom
Klass	public class Utils3D
Arv	Utils3D Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5

Utils3D-klassen innehåller statiska metoder som förenklar implementering av vissa tredimensionella matrisåtgärder.

Relaterade API-element

flash.geom.Matrix3D
flash.geom.Vector3D
flash.geom.Transform
flash.geom.PerspectiveProjection
flash.display.Graphics
flash.display.GraphicsTrianglePath
Vector

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D [statisk] Interpolerar ett objekts orientering mot en viss position.	Utils3D
		projectVector(m:Matrix3D, v:Vector3D):Vector3D [statisk] Med hjälp av ett Matrix3D projektionsobjekt kan ett Vector3D-objekt projiceras från en rumskoordinat till en annan.	Utils3D
		projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void [statisk] Med hjälp av ett Matrix3D projektionsobjekt projiceras en Vector av tredimensionella rumskoordinater (verts) på en Vector av tvådimensionella rumskoordinater (projectedVerts).	Utils3D
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Metoddetaljer

pointTowards

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5

Interpolerar ett objekts orientering mot en viss position. Metoden pointTowards() kombinerar funktionerna i metoderna Matrix3D.pointAt() och Matrix3D.interpolateTo().

Metoden pointTowards() tillåter att orienteringen ändras på plats. Den delar upp visningsobjektets Matrix3D och byter ut rotationselementen mot element som gör en procentuell vridning mot målets position. Objektet kan vridas stegvis mot målet samtidigt som det förflyttar sig i sin egen riktning. Flera pointTowards()-anrop efter varandra, följt av en översättningmetod, kan skapa en animering av ett objekt som jagar eller följer ett rörligt mål. Rikta först objektet ett procentsteg mot målet och förflytta det sedan stegvis längs en axel.

Parametrar

	`percent:Number` — Ett nummer mellan 0 och 1 som stegvis vrider objektet mot målet.

	`mat:Matrix3D` — Matrix3D-egenskapen för objektet som ska omformas.

	`pos:Vector3D` — Målobjektets position i förhållande till omgivningen. ”Omgivningsrelaterat” definierar omformningen av objektet i förhållande till omgivningen och rumskoordinaterna, där alla objekt har positionerats.

	`at:Vector3D` (default = `null`) — Den objektrelativa vektorn som definierar åt vilket håll visningsobjektet är riktat. ”Objektrelaterat” definierar omformningen av objektet i förhållande till objektets rum, objektets egen referensram och koordinatsystem. Standardvärde är (0,0,-1).

	`up:Vector3D` (default = `null`) — Den objektrelativa vektorn som definierar visningsobjektets ”upp”. Om objektet dras medan det betraktas ur ett fågelperspektiv är +z-axeln ”upp”-vektor. ”Objektrelaterat” definierar omformningen av objektet i förhållande till objektets rum, objektets egen referensram och koordinatsystem. Standardvärde är (0,-1,0).

Returnerar

Matrix3D — En modifierad version av Matrix3D-objektet som har angetts i den andra parametern. För att omforma visningsobjektet med hjälp av metoden pointTowards() anger du visningsobjektets Matrix3D-egenskap till det returnerade Matrix3D-objektet.

Relaterade API-element

flash.geom.Matrix3D.pointAt()
flash.geom.Matrix3D.interpolateTo()
flash.geom.Matrix3D.interpolate()

projectVector

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5

Med hjälp av ett Matrix3D projektionsobjekt kan ett Vector3D-objekt projiceras från en rumskoordinat till en annan. Metoden projectVector() liknar metoden Matrix3D.transformVector() förutom att metoden projectVector() delar det ursprungliga Vector3D-objektets x-, y- och z-element med projektionens djupvärde. Djupvärdet är avståndet från ögat till Vector3D-objektet i synfältet. Standardvärdet för den här sträckan är z-elementets värde.

Parametrar

	`m:Matrix3D` — Ett Matrix3D projektionsobjekt som omformar projektionen. Om ett visningsobjekt har ett PerspectiveProjection-objekt kan du använda metoden `perspectiveProjection.toMatrix()` för att skapa ett Matrix3D projektionsobjekt som gäller visningsobjektets underordnade objekt. För mer avancerade projektioner använder du egenskapen `matrix3D.rawData` för att skapa en anpassad projektionsmatris. Det finns ingen inbyggd Matrix3D-metod för att skapa ett Matrix3D projektionsobjekt.

	`v:Vector3D` — Vector3D-objektet som projiceras till en ny rumskoordinat.

Returnerar

Vector3D — En ny Vector3D med en omformad rumskoordinat.

Relaterade API-element

flash.geom.Matrix3D.transformVector()
projectVectors()

projectVectors

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5

Med hjälp av ett Matrix3D projektionsobjekt projiceras en Vector av tredimensionella rumskoordinater (verts) på en Vector med tvådimensionella rumskoordinater (projectedVerts). Den Vector som har projicerats bör förallokeras innan den används som parameter.

Med metoden projectVectors() anger du även t-värdet till uvt-informationen. Du bör förallokera en Vector som ska innehålla uvts-informationen för varje projicerat set med Vector-koordinater. Ange även u- och v-värden till uvt-informationen. uvt-informationen är en Vector av normaliserade koordinater som används för texturmappning. I UV-koordinater är (0,0) bitmappens övre vänstra hörn och (1,1) dess nedre högra hörn.

Den här metoden kan användas tillsammans med metoden Graphics.drawTriangles() och klassen GraphicsTrianglePath.

Parametrar

	`m:Matrix3D` — Ett Matrix3D projektionsobjekt som omformar projektionen. Du kan skapa ett Matrix3D projektionsobjekt med hjälp av egenskapen `Matrix3D.rawData`.

	`verts:Vector.<Number>` — En Vector med siffror där en grupp med tre siffror representerar x-, y- och z-koordinater i ett tredimensionellt rum, till exempel `Vector3D(x,y,z)`.

	`projectedVerts:Vector.<Number>` — En Vector med siffror där en grupp med två siffror representerar en projicerad tvådimensionell koordinat, till exempel `Point(x,y)`. Vector bör förallokeras. Metoden `projectVectors()` fyller i värdena för varje projicerad punkt.

	`uvts:Vector.<Number>` — En Vector med siffror, där en grupp med tre siffror representerar u-, v- ocht-elementen i `uvt`-informationen. u och v är texturkoordinater för varje projicerad punkt. t-värdet utgör projektionens djupvärde, d.v.s. avståndet från ögat till Vector3D-objektet i synfältet. Du bör förallokera Vector och ange u- och v-värdena. Metoden `projectVectors()` fyller i t-värdet för varje projicerad punkt.

Relaterade API-element

flash.display.Graphics.drawTriangles()
flash.display.GraphicsTrianglePath
flash.geom.Matrix3D
projectVector()
Vector

Juridiska meddelanden | Onlinesekretesspolicy

Utils3D - AS3

Paketx

Språkelement

Bilagor

Paket flash.geom

pointTowards

projectVector

projectVectors