Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: Gegevens ophalen van server...
Gegevens ophalen van server...
flash.geom 

Transform  - AS3

Pakketflash.geom
Klassepublic class Transform
OverervingTransform Inheritance Object
Subklassen Transform

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De klasse Transform biedt toegang tot kleuraanpassingseigenschappen en twee- of driedimensionale transformatieobjecten die op een weergaveobject kunnen worden toegepast. Tijdens de transformatie wordt de kleur of de oriëntatie en de positie van een weergaveobject aangepast (verschuiving); de huidige waarden of coördinaten worden gewijzigd in nieuwe waarden of coördinaten. De klasse Transform verzamelt ook gegevens over kleurtransformaties en tweedimensionale matrixtransformaties die worden toegepast op een weergaveobject en alle bovenliggende objecten. U kunt deze gecombineerde transformaties benaderen via de eigenschappen concatenatedColorTransform en concatenatedMatrix.

Ga als volgt te werk om kleurtransformaties toe te passen: maak een ColorTransform-object, stel de kleuraanpassingen in met de methoden en eigenschappen van het object en ken de eigenschap colorTransformation van de eigenschap transform van het weergaveobject toe aan het nieuwe ColorTransformation-object.

Ga als volgt te werk om tweedimensionale transformaties toe te passen: maak een Matrix-object, stel de tweedimensionale transformatie van de matrix in en wijs de eigenschap transform.matrix van het weergaveobject toe aan het nieuwe Matrix-object.

Ga als volgt te werk om driedimensionale transformaties toe te passen: begin met een driedimensionaal weergaveobject. De waarde van de eigenschap z van een driedimensionaal weergaveobject is niet nul. U hoeft geen Matrix3D-object te maken. Voor alle driedimensionale objecten wordt automatisch een Matrix3D-object gemaakt wanneer u een z-waarde aan een weergaveobject toekent. U kunt het Matrix3D-object van het weergaveobject benaderen via de eigenschap transform van het weergaveobject. Met de methoden van de klasse Matrix3D kunt u de bestaande transformatie-instellingen uitbreiden of wijzigen. U kunt ook een aangepast Matrix3D-object maken, de transformatie-elementen van het aangepaste Matrix3D-object instellen en vervolgens het nieuwe Matrix3D-object toewijzen aan de eigenschap transform.matrix van het weergaveobject.

Ga als volgt te werk om een perspectiefprojectie van het werkgebied of basisobject te wijzigen: gebruik de eigenschap transform.matrixvan het basisweergaveobject om toegang te krijgen tot het PerspectiveProjection-object. Of pas andere perspectiefprojectie-eigenschappen op een weergaveobject toe door de perspectiefprojectie-eigenschappen van het bovenliggende weergaveobject in te stellen. De onderliggende weergaveobjecten nemen de nieuwe eigenschappen over. Maak in het bijzonder een PerspectiveProjection-object en stel de eigenschappen daarvan in. Ken het PerspectiveProjection-object vervolgens toe aan de eigenschap perspectiveProjection van de eigenschap transform van het bovenliggende weergaveobject. Daarna wordt de opgegeven transformatie toegepast op de onderliggende driedimensionale elementen van het weergaveobject.

Omdat zowel PerspectiveProjection- als Matrix3D-objecten perspectieftransformaties uitvoeren, mag u beide niet tegelijkertijd aan een weergaveobject toekennen. Gebruik het PerspectiveProjection-object voor wijzigingen in brandpuntlengte en het projectiemiddelpunt. Voor meer controle over de perspectieftransformatie maakt u een perspectiefprojectie Matrix3D-object.

Bekijk de voorbeelden

Verwante API-elementen



Openbare eigenschappen
 EigenschapGedefinieerd door
  colorTransform : flash.geom:ColorTransform
Een object ColorTransform dat waarden bevat die overal de kleuren in het weergaveobject veranderen.
Transform
  concatenatedColorTransform : flash.geom:ColorTransform
[alleen-lezen] Een object ColorTransform dat de gecombineerde kleurtransformaties vertegenwoordigt die op het weergaveobject en alle bovenliggende objecten tot het hoofdniveau worden toegepast.
Transform
  concatenatedMatrix : Matrix
[alleen-lezen] Een object Matrix dat de gecombineerde transformatiematrices vertegenwoordigt van het weergaveobject en alle bovenliggende objecten tot het hoofdniveau.
Transform
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
  matrix : Matrix
Een object Matrix met waarden die het schalen, roteren en vertalen van het weergaveobject veranderen.
Transform
  matrix3D : Matrix3D
Biedt toegang tot het Matrix3D-object van een driedimensionaal weergaveobject.
Transform
  perspectiveProjection : PerspectiveProjection
Biedt toegang tot het PerspectiveProjection-object van een driedimensionaal weergaveobject.
Transform
  pixelBounds : Rectangle
[alleen-lezen] Een object Rectangle dat de selectierechthoek van het weergaveobject in het werkgebied definieert.
Transform
Openbare methoden
 MethodeGedefinieerd door
  
Retourneert een Matrix3D-object, dat de ruimte van een opgegeven weergaveobject kan transformeren ten opzichte van de ruimte van het huidige weergaveobject.
Transform
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
 Inherited
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.
Object
 Inherited
Retourneert een tekenreeksrepresentatie van het opgegeven object.
Object
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
Eigenschapdetails

colorTransform

eigenschap
colorTransform:flash.geom:ColorTransform

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een object ColorTransform dat waarden bevat die overal de kleuren in het weergaveobject veranderen.



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

Gegenereerde uitzondering
TypeError — De colorTransform is null wanneer deze wordt ingesteld.

Verwante API-elementen

concatenatedColorTransform

eigenschap 
concatenatedColorTransform:flash.geom:ColorTransform  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een object ColorTransform dat de gecombineerde kleurtransformaties vertegenwoordigt die op het weergaveobject en alle bovenliggende objecten tot het hoofdniveau worden toegepast. Wanneer verschillende kleurtransformaties op verschillende niveaus zijn toegepast, wordt voor deze eigenschap elk van deze transformaties in één object ColorTransform samengevoegd.



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

Verwante API-elementen

concatenatedMatrix

eigenschap 
concatenatedMatrix:Matrix  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een object Matrix dat de gecombineerde transformatiematrices vertegenwoordigt van het weergaveobject en alle bovenliggende objecten tot het hoofdniveau. Wanneer verschillende transformatiematrices op verschillende niveaus zijn toegepast, wordt voor deze eigenschap elk van deze matrices samengevoegd tot één matrix. Voor SWF-inhoud die in de browser wordt uitgevoerd en waarvan de grootte kan worden aangepast, is deze eigenschap ook van inlvoed op het verschil tussen werkgebiedcoördinaten en venstercoördinaten als de venstergrootte wordt gewijzigd. De eigenschap converteert lokale coördinaten naar venstercoördinaten en dit is mogelijk niet dezelfde coördinaatruimte als die van het werkgebied.



Implementatie
    public function get concatenatedMatrix():Matrix

matrix

eigenschap 
matrix:Matrix

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een object Matrix met waarden die het schalen, roteren en vertalen van het weergaveobject veranderen.

Als de eigenschap matrix is ingesteld op een waarde (niet null), is de eigenschap matrix3D null. En als de eigenschap matrix3D is ingesteld op een waarde (niet null), is de eigenschap matrix null.



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

Gegenereerde uitzondering
TypeError — De matrix is null wanneer deze wordt ingesteld.

Verwante API-elementen

matrix3D

eigenschap 
matrix3D:Matrix3D

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5

Biedt toegang tot het Matrix3D-object van een driedimensionaal weergaveobject. Het Matrix3D-object stelt een transformatiematrix voor die de positie en oriëntatie van het weergaveobject bepaalt. Een Matrix3D-object kan ook perspectiefprojectie uitvoeren.

Als de eigenschap matrix is ingesteld op een waarde (niet null), is de eigenschap matrix3D null. En als de eigenschap matrix3D is ingesteld op een waarde (niet null), is de eigenschap matrix null.



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

Verwante API-elementen

perspectiveProjection

eigenschap 
perspectiveProjection:PerspectiveProjection

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5

Biedt toegang tot het PerspectiveProjection-object van een driedimensionaal weergaveobject. Het PerspectiveProjection-object kan worden gebruikt om de perspectieftransformatie van het werkgebied te wijzigen of om een perspectieftransformatie toe te wijzen aan alle driedimensionale onderliggende elementen van een weergaveobject.

Op basis van het gezichtsveld en de verhoudingen (afmetingen) van het werkgebied, wordt een standaard PerspectiveProjection-object aan het basisobject toegewezen.



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

Verwante API-elementen

pixelBounds

eigenschap 
pixelBounds:Rectangle  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een object Rectangle dat de selectierechthoek van het weergaveobject in het werkgebied definieert.



Implementatie
    public function get pixelBounds():Rectangle
Methodedetails

getRelativeMatrix3D

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5

Retourneert een Matrix3D-object, dat de ruimte van een opgegeven weergaveobject kan transformeren ten opzichte van de ruimte van het huidige weergaveobject. Met de methode getRelativeMatrix3D() kunt u een driedimensionaal weergaveobject verplaatsen ten opzichte van een ander driedimensionaal weergaveobject.

Parameters

relativeTo:DisplayObject — Het weergaveobject ten opzichte waarvan de transformatie plaatsvindt. Als u een Matrix3D-object ten opzichte van het werkgebied wilt verkrijgen, stelt u de parameter in op het root- of stage-object. Als u een wereld-relatieve matrix van het weergaveobject wilt verkrijgen, stelt u de parameter in op een weergaveobject waarop een perspectieftransformatie is toegepast.

Geretourneerde waarde
Matrix3D — Een Matrix3D-object dat gebruikt kan worden om de ruimte van het weergaveobject relativeTo te transformeren naar de ruimte van het huidige weergaveobject.

Verwante API-elementen

TransformExample.as

In het volgende voorbeeld wordt de klasse TransformExample gebruikt om de onderkant van een spritevierkant dat met een verlopend patroon is gevuld, scheef te trekken. Telkens wanneer de gebruiker op het vierkant klikt, transformeert de toepassing de sprite door deze scheef te trekken met de volgende stappen:
  1. De constructor TransformExample() maakt een nieuw object Sprite met de naam target.
  2. De constructor TransformExample() roept de methode draw() aan, die een verlopend vierkant in de sprite tekent.
  3. De constructor TransformExample() voegt een click-gebeurtenislistener voor de sprite toe, die wordt afgehandeld door de methode clickHandler().
  4. De methode clickHandler() maakt een nieuw Matrix-object, skewMatrix, dat is ingesteld om een scheeftrekkend effect toe te passen. Een andere matrix, tempMatrix, wordt toegewezen aan de huidige transformatiematrix van de sprite en wordt vervolgens gecombineerd met skewMatrix met de methode concat(). Deze matrix wordt toegewezen aan de eigenschap transform.matrix van het spritevierkant. Telkens wanneer de gebruiker op het vierkant klikt, transformeert de aanroep van clickHandler() de vorm van het vierkant door het scheef te trekken.
  5. Bovendien maakt de methode clickHandler() een nieuw object ColorTransform. De eigenschap redOffset van de nieuwe ColorTransform wordt ingesteld op de huidige waarde van redOffset en met 25 verhoogd. Op dezelfde manier wordt de eigenschap blueOffset verminderd met 25. Bij elke klik verandert de kleur van de sprite.
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 ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.