Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: Hämtar data från servern ...
Hämtar data från servern ...
flash.geom 

Transform  - AS3

Paketflash.geom
Klasspublic class Transform
ArvTransform Inheritance Object
Underklasser Transform

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Klassen Transform ger tillgång till färgjusteringsegenskaper och två- eller tredimensionella omformningsobjekt som kan användas i ett visningsobjekt. Under omformningen justeras (förskjuts) visningsobjektets färg eller orientering samt dess position från aktuella värden eller koordinater till nya värden eller koordinater. Med klassen Transform samlas även data in om färg och tvådimentionella matrisomformningar som används i visningsobjekt och alla dess överordnade objekt. Du når de här kombinerade omformningarna via egenskaperna concatenatedColorTransform och concatenatedMatrix.

Så här använder du färgomformningar: skapa ett ColorTransform-objekt, ange färgjusteringen med hjälp av objektets metoder och egenskaper, och tilldela sedan colorTransformation-egenskapen för visningsobjektets transform-egenskap till det nya ColorTransformation-objektet.

Så här använder du tvådimensionella omformningar: skapa ett Matrix-objekt, ange matrisens tvådimensionella omformning, och tilldela sedan visningsobjektets transform.matrix-egenskap till det nya Matrix-objektet.

Så här använder du tredimensionella omformningar: börja med ett tredimensionellt visningsobjekt: Ett tredimensionellt visningsobjekt har ett z-egenskapsvärde som inte är noll. Du behöver inte skapa något Matrix3D-objekt. För alla tredimensionella objekt skapas ett Matrix3D-objekt automatiskt när du tilldelar ett z-värde till ett visningsobjekt. Du får åtkomst till visningsobjektets Matrix3D-objekt via visningsobjektets transform-egenskap. Med hjälp av Matrix3D-klassens metoder kan du lägga till eller göra ändringar i existerande omformningsinställningar. Du kan även skapa ett anpassat Matrix3D-objekt, sedan ange det anpassade Matrix3D-objektets omformningselement och sedan tilldela det nya Matrix3D-objektet till visningsobjektet med hjälp av transform.matrix-egenskapen.

Så här ändrar du en perspektivprojektion i scenen eller rotobjektet: använd rotvisningsobjektets transform.matrix-egenskap för att få åtkomst till PerspectiveProjection-objektet. Eller använd olika perspektivprojektionsegenskaper till ett visningsobjekt genom att ange det överordnade visningsobjektets perspektivprojektionsegenskaper. Det underordnade visningsobjektet ärver de nya egenskaperna. Du skapar alltså ett PerspectiveProjection-objekt och anger dess egenskaper. Sedan tilldelar du PerspectiveProjection-objektet till perspectiveProjection-egenskapen för transform-egenskapen för det överordnade visningsobjektet. Den angivna projektionsomformningen kommer sedan att gälla alla visningsobjektets tredimensionella underordnade objekt.

Eftersom både PerspectiveProjection-objekt och Matrix3D-objekt utför perspektivomformningar bör inte båda tilldelas ett visningsobjekt samtidigt. Du använder PerspectiveProjection-objekt för att göra ändringar i brännvidd och projektionscentrum. För att få bättre kontroll över perspektivomformningen skapar du ett Matrix3D projektionsobjekt.

Visa exemplen

Relaterade API-element



Publika egenskaper
 EgenskapDefinieras med
  colorTransform : flash.geom:ColorTransform
Ett ColorTransform-objekt som innehåller värden som justerar färgerna universellt i visningsobjektet.
Transform
  concatenatedColorTransform : flash.geom:ColorTransform
[skrivskyddad] Ett ColorTransform-objekt som representerar de kombinerade färgomformningarna som tillämpas på visningsobjektet och alla dess överordnade objekt ned till rotnivå.
Transform
  concatenatedMatrix : Matrix
[skrivskyddad] Ett Matrix-objekt som representerar de kombinerade omformningsmatriserna för visningsobjektet och alla dess överordnade objekt ned till rotnivå.
Transform
 Inheritedconstructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.
Object
  matrix : Matrix
Ett Matrix-objekt som innehåller värden som ändrar visningsobjektets skalning, rotation och översättning.
Transform
  matrix3D : Matrix3D
Ger åtkomst till Matrix3D-objektet i ett tredimensionellt visningsobjekt.
Transform
  perspectiveProjection : PerspectiveProjection
Ger åtkomst till perspektivprojektionsobjektet i ett tredimensionellt visningsobjekt.
Transform
  pixelBounds : Rectangle
[skrivskyddad] Ett Rectangle-objekt som definierar markeringsramen för det visningsobjekt som är på scenen.
Transform
Publika metoder
 MetodDefinieras med
  
Returnerar ett Matrix3D-objekt som kan omforma rummet för ett specifikt visningsobjekt i förhållande till det nuvarande visningsobjektets rum.
Transform
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
 Inherited
Returnerar det angivna objektets strängbeteckning.
Object
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
Egenskapsdetaljer

colorTransform

egenskap
colorTransform:flash.geom:ColorTransform

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett ColorTransform-objekt som innehåller värden som justerar färgerna universellt i visningsobjektet.



Implementering
    public function get colorTransform():flash.geom:ColorTransform
    public function set colorTransform(value:flash.geom:ColorTransform):void

Utlöser
TypeError — ColorTransform-objektet är null när det anges

Relaterade API-element

concatenatedColorTransform

egenskap 
concatenatedColorTransform:flash.geom:ColorTransform  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett ColorTransform-objekt som representerar de kombinerade färgomformningarna som tillämpas på visningsobjektet och alla dess överordnade objekt ned till rotnivå. Om olika färgomvandlingar har använts på olika nivåer sammanfogas de till ett ColorTransform-objekt för den här egenskapen.



Implementering
    public function get concatenatedColorTransform():flash.geom:ColorTransform

Relaterade API-element

concatenatedMatrix

egenskap 
concatenatedMatrix:Matrix  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett Matrix-objekt som representerar de kombinerade omformningsmatriserna för visningsobjektet och alla dess överordnade objekt ned till rotnivå. Om olika omformningsmatriser har tillämpats på olika nivåer sammanfogas alla till en matris för den här egenskapen. När det gäller SWF-innehåll som kan ändra storlek och som körs i webbläsaren, delas den här egenskapen upp i skillnaden mellan scenkoordinater och fönsterkoordinater på grund av att fönstret ändrar storlek. Egenskapen konverterar därför lokala koordinater till fönsterkoordinater, som kanske inte använder samma koordinatsystem som scenen.



Implementering
    public function get concatenatedMatrix():Matrix

matrix

egenskap 
matrix:Matrix

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett Matrix-objekt som innehåller värden som ändrar visningsobjektets skalning, rotation och översättning.

Om egenskapen matrix ställs in på ett värde (inte null) är matrix3D-egenskapen null. Och om egenskapen matrix3D ställs in på ett värde (inte null) är matrix-egenskapen null.



Implementering
    public function get matrix():Matrix
    public function set matrix(value:Matrix):void

Utlöser
TypeError — Matrisen är null när den anges

Relaterade API-element

matrix3D

egenskap 
matrix3D:Matrix3D

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5

Ger åtkomst till Matrix3D-objektet i ett tredimensionellt visningsobjekt. Matrix3D-objektet utgör en omvandlingsmatris som avgör visningsobjektets position och orientering. Ett Matrix3D-objekt kan även utföra perspektivprojektion.

Om egenskapen matrix ställs in på ett värde (inte null) är matrix3D-egenskapen null. Och om egenskapen matrix3D ställs in på ett värde (inte null) är matrix-egenskapen null.



Implementering
    public function get matrix3D():Matrix3D
    public function set matrix3D(value:Matrix3D):void

Relaterade API-element

perspectiveProjection

egenskap 
perspectiveProjection:PerspectiveProjection

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5

Ger åtkomst till perspektivprojektionsobjektet i ett tredimensionellt visningsobjekt. PerspectiveProjection-objektet kan användas för att ändra perspektivomformningen för scenen eller för att tilldela en perspektivomformning till visningsobjektets alla tredimensionella underordnade objekt.

Baserat på scenens synfält och proportioner (dimensioner) har rotobjektet tilldelats ett PerspectiveProjection-standardobjekt.



Implementering
    public function get perspectiveProjection():PerspectiveProjection
    public function set perspectiveProjection(value:PerspectiveProjection):void

Relaterade API-element

pixelBounds

egenskap 
pixelBounds:Rectangle  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett Rectangle-objekt som definierar markeringsramen för det visningsobjekt som är på scenen.



Implementering
    public function get pixelBounds():Rectangle
Metoddetaljer

getRelativeMatrix3D

()metod
public function getRelativeMatrix3D(relativeTo:DisplayObject):Matrix3D

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5

Returnerar ett Matrix3D-objekt som kan omforma rummet för ett specifikt visningsobjekt i förhållande till det nuvarande visningsobjektets rum. Du kan använda getRelativeMatrix3D()-metoden för att förflytta ett tredimensionellt visningsobjekt i förhållande till ett annat tredimensionellt visningsobjekt.

Parametrar

relativeTo:DisplayObject — Det visningsobjekt som omformningen görs i förhållande till. För att skapa ett Matrix3D-objekt i förhållande till scenen tilldelar du parametern till root- eller stage-objektet. För att hämta visningsobjektets omgivningsrelaterade matris anger du parametern till ett visningsobjekt som har tilldelats en perspektivomformning.

Returnerar
Matrix3D — Ett Matrix3D-objekt som kan användas för att omforma rummet från relativeTo-visningsobjektet till det aktuella visningsobjektets rum.

Relaterade API-element

TransformExample.as

I följande exempel används TransformExample-klassen för att skapa en skevning på undersidan på en fyrkantig sprite fylld med ett övertoningsmönster. Varje gång användaren klickar på fyrkanten omvandlar programmet spriten genom att skeva den i följande steg:
  1. Konstruktorn TransformExample() skapar ett nytt Sprite-objekt target.
  2. Konstruktorn TransformExample() anropar metoden draw() som ritar en övertoningsfyrkant i spriten.
  3. Konstruktorn TransformExample() lägger till en klickhändelseavlyssnare för spriten som hanteras av metoden clickHandler().
  4. Metoden clickHandler() skapar ett nytt matrisobjekt, skewMatrix, som anges för att skapa en skevningseffekt. En annan matris, tempMatrix, kopplas till spritens aktuella omformningsmatris och kombineras sedan med skewMatrix med hjälp av concat()-metoden. Den här matrisen är kopplad till den fyrkantiga spritens transform.matrix-egenskap. Varje gång användaren klickar på fyrkanten ändras fyrkantens form genom anropet till clickHandler(), som skapar en skevning.
  5. Dessutom skapar metoden clickHandler() ett nytt ColorTransform-objekt. Det nya ColorTransform-objektets redOffset-egenskap anges till det aktuella redOffset-värdet och ökas med 25 enheter. På liknande sätt minskas blueOffset-egenskapen med 25 enheter. Spritens färger ändras ytterligare med varje klick.
package {
    import flash.display.Sprite;
    import flash.display.GradientType;
    import flash.geom.Matrix;
    import flash.geom.ColorTransform;
    import flash.events.MouseEvent;

    public class TransformExample extends Sprite {
        public function TransformExample() { 
            var target:Sprite = new Sprite();
            draw(target);
            addChild(target);
            target.useHandCursor = true;
            target.buttonMode = true;
            target.addEventListener(MouseEvent.CLICK, clickHandler)
        }
        public function draw(sprite:Sprite):void {
            var red:uint = 0xFF0000;
            var green:uint = 0x00FF00;
            var blue:uint = 0x0000FF;
            var size:Number = 100;
            sprite.graphics.beginGradientFill(GradientType.LINEAR, [red, blue, green], [1, 0.5, 1], [0, 200, 255]);
            sprite.graphics.drawRect(0, 0, 100, 100);
        }
        public function clickHandler(event:MouseEvent):void {
            var skewMatrix:Matrix = new Matrix();
            skewMatrix.c = 0.25;
            var tempMatrix:Matrix = this.transform.matrix;
            tempMatrix.concat(skewMatrix);
            this.transform.matrix = tempMatrix;
            
            var rOffset:Number = this.transform.colorTransform.redOffset + 25;
            var bOffset:Number = this.transform.colorTransform.blueOffset - 25;
            this.transform.colorTransform = new ColorTransform(1, 1, 1, 1, rOffset, 0, bOffset, 0);            
        }
    }
}




[ X ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.