Matrix  - AS3

Görüntüyü ölçeklerken veya döndürürken piksellerin x ekseni boyunca konumlandırmasını etkileyen değer.

import flash.geom.Matrix;

var myMatrix:Matrix = new Matrix();
trace(myMatrix.a);  // 1

myMatrix.a = 2;
trace(myMatrix.a);  // 2

Görüntüyü döndürürken veya eğerken piksellerin y ekseni boyunca konumlandırmasını etkileyen değer.

import flash.geom.Matrix;
 
var myMatrix:Matrix = new Matrix();
trace(myMatrix.b);  // 0

var degrees:Number = 30;
var radians:Number = (degrees/180) * Math.PI;
myMatrix.b = Math.tan(radians);
trace(myMatrix.b);  // 0.5773502691896257

Görüntüyü döndürürken veya eğerken piksellerin x ekseni boyunca konumlandırmasını etkileyen değer.

import flash.geom.Matrix;

var myMatrix:Matrix = new Matrix();
trace(myMatrix.c);  // 0

var degrees:Number = 30;
var radians:Number = (degrees/180) * Math.PI;
myMatrix.c = Math.tan(radians);
trace(myMatrix.c);  // 0.5773502691896257

Görüntüyü ölçeklerken veya döndürürken piksellerin y ekseni boyunca konumlandırmasını etkileyen değer.

import flash.geom.Matrix;

var myMatrix:Matrix = new Matrix();
trace(myMatrix.d);  // 1

myMatrix.d = 2;
trace(myMatrix.d);  // 2

Her noktanın x ekseni boyunca çevrileceği mesafe.

import flash.geom.Matrix;

var myMatrix:Matrix = new Matrix();
trace(myMatrix.tx);  // 0

myMatrix.tx = 50;  // 50
trace(myMatrix.tx);

Her noktanın y ekseni boyunca çevrileceği mesafe.

import flash.geom.Matrix;

var myMatrix:Matrix = new Matrix();
trace(myMatrix.ty);  // 0

myMatrix.ty = 50;
trace(myMatrix.ty);  // 50

Belirtilen parametrelerle yeni bir Matrix nesnesi oluşturur. Matris notasyonunda özellikler şu şekilde organize edilir:

new Matrix() yapıcısına hiçbir parametre sağlamazsanız, yapıcı şu değerlerle bir kimlik matrisi oluşturur:

a = 1

b = 0

c = 0

d = 1

tx = 0

ty = 0

Matris notasyonunda kimlik matrisi şu şekilde görünür:

import flash.geom.Matrix;

var matrix_1:Matrix = new Matrix();
trace(matrix_1);  // (a=1, b=0, c=0, d=1, tx=0, ty=0)

var matrix_2:Matrix = new Matrix(1, 2, 3, 4, 5, 6);
trace(matrix_2);  // (a=1, b=2, c=3, d=4, tx=5, ty=6)

İçerilen nesnenin tam kopyasıyla bu matrisin bir klonu olan yeni bir Matrix nesnesi döndürür.

Geometrik efektlerini etkili bir şekilde bir araya getirerek bir matrisi ve geçerli matrisi birleştirir. Matematiksel olarak, iki matrisin birleştirilmesi matris çarpımı kullanılarak birleştirilmesiyle aynıdır.

Örneğin, matris m1 bir nesneyi dördün katlarıyla ölçeklerse ve matris m2 bir nesneyi 1,5707963267949 radyanıyla döndürürse (Math.PI/2); bu durumda m1.concat(m2), m1 öğesini bir nesneyi dördün katlarıyla ölçekleyen bir matrise dönüştürür ve nesneyi Math.PI/2 radyanıyla döndürür.

Bu yöntem kaynak matrisi birleştirilmiş matrisle değiştirir. İki kaynak matristen herhangi birini değiştirmeden iki matrisi birleştirmek istiyorsanız, Sınıf Örnekleri bölümünde gösterildiği şekilde ilk olarak clone() yöntemini kullanarak kaynak matrisi kopyalayın.

Parametreler

Çağrı yapan Matrix3D nesnesinin belirli sütununa bir Vector3D nesnesi kopyalar.

Parametreler

Çağrı yapan Matrix nesnesinin belirli sütununu Vector3D nesnesine kopyalar. Vector3D nesnesini w öğesi değiştirilmez.

Parametreler

Kaynak Point nesnesindeki tüm matris verisini çağrı yapan Matrix nesnesine kopyalar.

Parametreler

Çağrı yapan Matrix nesnesinin belirli satırına bir Vector3D nesnesi kopyalar.

Parametreler

Çağrı yapan Matrix nesnesinin belirli satırını Vector3D nesnesine kopyalar. Vector3D nesnesini w öğesi değiştirilmez.

Parametreler

Ölçekleme, döndürme ve çevirme için parametreler içerir. Bir matrise uygulandığında, matrisin değerlerini söz konusu parametreleri temel alarak ayarlar.

createBox() yönteminin kullanılması, identity(), rotate(), scale() ve translate() yöntemlerinin art arda uygulanmasıyla aynı matrisin elde edilmesine olanak tanır. Örneğin, mat1.createBox(2,2, Math.PI/4, 100, 100) ile şunun sonucu aynıdır:

     import flash.geom.Matrix;
     
     var mat1:Matrix = new Matrix();
     mat1.identity();
     mat1.rotate(Math.PI/4);
     mat1.scale(2,2);
     mat1.translate(10,20);
     

Parametreler

İlgili API Öğeleri

package
{
    import flash.display.Shape;
    import flash.display.Sprite;
    import flash.geom.Matrix;
    import flash.geom.Transform;
    
    public class Matrix_createBox extends Sprite
    {
        public function Matrix_createBox()
        {
             var myMatrix:Matrix = new Matrix();
             trace(myMatrix.toString());  // (a=1, b=0, c=0, d=1, tx=0, ty=0)
             
             myMatrix.createBox(1, 2, Math.PI/4, 50, 100);
             trace(myMatrix.toString());  
             // (a=0.7071067811865476, b=1.414213562373095, c=-0.7071067811865475, 
             //  d=1.4142135623730951, tx=50, ty=100)
             
             var rectangleShape:Shape = createRectangle(20, 80, 0xFF0000);   
             addChild(rectangleShape);
              
             var rectangleTrans:Transform = new Transform(rectangleShape);
             rectangleTrans.matrix = myMatrix;
        }
        
        public function createRectangle(w:Number, h:Number, color:Number):Shape 
        {
            var rect:Shape = new Shape();
            rect.graphics.beginFill(color);
            rect.graphics.drawRect(0, 0, w, h);
            addChild(rect);
            return rect;
        }
    }
}

Graphics sınıfının beginGradientFill() ve lineGradientStyle() yöntemlerinin beklediği özel stilde bir matris oluşturur. Genişlik ve yükseklik bir scaleX/scaleY çiftine ölçeklenir ve tx/ty değerleri, genişlik ve yüksekliğin yarısı kadar kaydırılır.

Örneğin, aşağıdaki özelliklere sahip bir degrade olduğunu düşünelim:

• GradientType.LINEAR
• İki renk, yeşil ve mavi, oranlar dizisi [0, 255] olarak ayarlanmış durumda
• SpreadMethod.PAD
• InterpolationMethod.LINEAR_RGB

Aşağıdaki şekiller matrisin, createGradientBox() yöntemi farklı parametre ayarlarıyla kullanılarak tanımlandığı degradeleri gösterir:

createGradientBox() ayarları	Elde edilen degrade
width = 25; height = 25; rotation = 0; tx = 0; ty = 0;
width = 25; height = 25; rotation = 0; tx = 25; ty = 0;
width = 50; height = 50; rotation = 0; tx = 0; ty = 0;
width = 50; height = 50; rotation = Math.PI / 4; // 45 degrees tx = 0; ty = 0;

Parametreler

İlgili API Öğeleri

package
{
    import flash.display.GradientType;
    import flash.display.Sprite;
    import flash.geom.Matrix;
    
    public class Matrix_createGradientBox extends Sprite
    {
        public function Matrix_createGradientBox()
        {
             var myMatrix:Matrix = new Matrix();
             trace(myMatrix.toString());          // (a=1, b=0, c=0, d=1, tx=0, ty=0)
             
             myMatrix.createGradientBox(200, 200, 0, 50, 50);
             trace(myMatrix.toString());          // (a=0.1220703125, b=0, c=0, d=0.1220703125, tx=150, ty=150)
             
             var colors:Array = [0xFF0000, 0x0000FF];
             var alphas:Array = [100, 100];
             var ratios:Array = [0, 0xFF];
             
             this.graphics.beginGradientFill(GradientType.LINEAR, colors, alphas, ratios, myMatrix);
             this.graphics.drawRect(0, 0, 300, 200);
        }
    }
}

Dönüştürme öncesi koordinat alanındaki belirli bir noktanın dönüştürme sonrasındaki koordinatlarını döndürür. transformPoint() yöntemi kullanılarak uygulanan standart dönüşümün aksine deltaTransformPoint() yönteminin dönüşümü, tx ve ty çeviri parametrelerini göz önüne almaz.

Parametreler

Her matris özelliğini boş bir dönüşüme neden olan bir değere ayarlar. Kimlik matrisi uygulanarak dönüştürülen bir nesne, orijinal ile aynı olur.

identity() yöntemi çağrıldıktan sonra, elde edilen matris şu özelliklere sahip olur: a=1, b=0, c=0, d=1, tx=0, ty=0.

Matris notasyonunda kimlik matrisi şu şekilde görünür:

Orijinal matrisin zıt dönüşümünü gerçekleştirir. Orijinal matrisi uygularken gerçekleştirilen dönüşümü geri almak için bir nesneye ters çevrilmiş bir matris uygulayabilirsiniz.

package
{
    import flash.display.Shape;
    import flash.display.Sprite;
    import flash.geom.Matrix;
    import flash.geom.Transform;
    
    public class Matrix_invert extends Sprite
    {
        public function Matrix_invert()
        {
            var rect0:Shape = createRectangle(20, 80, 0xFF0000);   
            var rect1:Shape = createRectangle(20, 80, 0x00FF00);   
            var rect2:Shape = createRectangle(20, 80, 0x0000FF);
            var rect3:Shape = createRectangle(20, 80, 0x000000);
            
            var trans0:Transform = new Transform(rect0);
            var trans1:Transform = new Transform(rect1);
            var trans2:Transform = new Transform(rect2);
            var trans3:Transform = new Transform(rect3);
             
            var doubleScaleMatrix:Matrix = new Matrix(2, 0, 0, 2, 0, 0);
            trans0.matrix = doubleScaleMatrix;
            trace(doubleScaleMatrix.toString());  // (a=2, b=0, c=0, d=2, tx=0, ty=0)
             
            var noScaleMatrix:Matrix = new Matrix(1, 0, 0, 1, 0, 0);
            trans1.matrix = noScaleMatrix;
            rect1.x = 50;
            trace(noScaleMatrix.toString());  // (a=1, b=0, c=0, d=1, tx=0, ty=0)
             
            var halfScaleMatrix:Matrix = doubleScaleMatrix.clone();
            halfScaleMatrix.invert();
            trans2.matrix = halfScaleMatrix;
            rect2.x = 100;
            trace(halfScaleMatrix.toString());  // (a=0.5, b=0, c=0, d=0.5, tx=0, ty=0)
             
            var originalAndInverseMatrix:Matrix = doubleScaleMatrix.clone();
            originalAndInverseMatrix.concat(halfScaleMatrix);
            trans3.matrix = originalAndInverseMatrix;
            rect3.x = 150;
            trace(originalAndInverseMatrix.toString());  // (a=1, b=0, c=0, d=1, tx=0, ty=0)            
        }
        
        public function createRectangle(w:Number, h:Number, color:Number):Shape 
        {
            var rect:Shape = new Shape();
            rect.graphics.beginFill(color);
            rect.graphics.drawRect(0, 0, w, h);
            addChild(rect);
            return rect;
        }
    }
}

Matrix nesnesine bir döndürme dönüşümü uygular.

rotate() yöntemi, Matrix nesnesinin a, b, c ve d özelliklerini değiştirir. Matris notasyonunda bu, geçerli matrisi şununla birleştirmekle aynıdır:

Parametreler

Matrise bir ölçekleme dönüşümü uygular. x ekseni sx ile çarpılır ve y ekseni sy ile çarpılır.

scale() yöntemi, Matrix nesnesinin a ve d özelliklerini değiştirir. Matris notasyonunda bu, geçerli matrisi şu matrisle birleştirmekle aynıdır:

Parametreler

Matrix öğesinin üyelerini belirtilen değerlere ayarlar

Parametreler

Matrix nesnesinin özelliklerini listeleyen metin değerini döndürür.

Matrix nesnesinin temsil ettiği geometrik dönüşümün belirtilen noktaya uygulanmasıyla elde edilen sonucu döndürür.

Parametreler

Matrisi,dx ve dy parametreleri tarafından belirtildiği gibi x ve y eksenleri boyunca çevirir.

Parametreler

1. Uygulama yeni bir Matrix nesnesi myMatrix öğesi oluşturur ve myMatrix nesnesinin varsayılan özellik değerlerini vermek için trace() yöntemini kullanır.
2. Uygulama, width ve height parametreleri 200 piksele ayarlanmış durumdayken, döndürme yokken ve x ile y eksenleri boyunca çevrilecek mesafe 50 piksele ayarlanmış durumdayken createGradientBox() öğesini çağırır.
3. Uygulama, createGradientBox() öğesi çağrıldıktan sonraki değişikliği göstermek için myMatrix nesnesini yeniden yazdırır.
4. Uygulama, degrade kutunun nasıl doldurulacağını kontrol etmek için üç değişken oluşturur:
   • renkler: Degrade renkleri düz kırmızı ve düz mavi arasında değişecek şekilde ayarlar.
   • alfalar: Opaklığı düze ayarlar.
   • oranlar: Renklerin dağılımını hem kırmızı hem mavi için eşit olacak şekilde ayarlar.
5. Uygulama, myMatrixnesnesinde çalışan beginGradientFill() grafik yöntemini çağırır ve lineTo() yöntemini çağırır; bunun sonucu olarak degrade ile doldurulmuş kutu oluşturulur.

package {
    import flash.geom.Matrix;
    import flash.display.Sprite;
    import flash.display.GradientType;

    public class MatrixExample extends Sprite {

        public function MatrixExample() {
            var myMatrix:Matrix = new Matrix();
            trace(myMatrix.toString());    // (a=1, b=0, c=0, d=1, tx=0, ty=0)

            myMatrix.createGradientBox(200, 200, 0, 50, 50);
            trace(myMatrix.toString());    // (a=0.1220703125, b=0, c=0, d=0.1220703125, tx=150, ty=150)

            var colors:Array = [0xFF0000, 0x0000FF];
            var alphas:Array = [1, 1];
            var ratios:Array = [0, 0xFF];
            graphics.beginGradientFill(GradientType.LINEAR, colors, alphas, ratios, myMatrix);
            graphics.lineTo(0, 300);
            graphics.lineTo(300, 300);
            graphics.lineTo(300, 0);
            graphics.lineTo(0, 0);
        }
    }
}