add get9 and set9 to matrix, to aid in making keys

include/core/SkMatrix.h

 
 /*
  * Copyright 2006 The Android Open Source Project
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 
 #ifndef SkMatrix_DEFINED
@@ skipping 156 matching lines @@
         fMat[kMTransX] = transX;
         fMat[kMSkewY]  = skewY;
         fMat[kMScaleY] = scaleY;
         fMat[kMTransY] = transY;
         fMat[kMPersp0] = persp0;
         fMat[kMPersp1] = persp1;
         fMat[kMPersp2] = persp2;
         this->setTypeMask(kUnknown_Mask);
     }
 
+    /**
+     *  Copy the 9 scalars for this matrix into buffer, in the same order as the kMScaleX
+     *  enum... scalex, skewx, transx, skewy, scaley, transy, persp0, persp1, persp2
+     */
+    void get9(SkScalar buffer[9]) const {
+        memcpy(buffer, fMat, 9 * sizeof(SkScalar));
+    }
+
+    /**
+     *  Set this matrix to the 9 scalars from the buffer, in the same order as the kMScaleX
+     *  enum... scalex, skewx, transx, skewy, scaley, transy, persp0, persp1, persp2
+     *
+     *  Note: calling set9 followed by get9 may not return the exact same values. Since the matrix
+     *  is used to map non-homogeneous coordinates, it is free to rescale the 9 values as needed.
+     */
+    void set9(const SkScalar buffer[9]);
+
     /** Set the matrix to identity
     */
     void reset();
     // alias for reset()
     void setIdentity() { this->reset(); }
 
     /** Set the matrix to translate by (dx, dy).
     */
     void setTranslate(SkScalar dx, SkScalar dy);
     void setTranslate(const SkVector& v) { this->setTranslate(v.fX, v.fY); }
@@ skipping 178 matching lines @@
         @param affine  The array to fill with affine identity values.
         Must not be NULL.
     */
     static void SetAffineIdentity(SkScalar affine[6]);
 
     /** Fills the passed array with the affine values in column major order.
         If the matrix is a perspective transform, returns false
         and does not change the passed array.
         @param affine  The array to fill with affine values. Ignored if NULL.
     */
-    bool asAffine(SkScalar affine[6]) const;
+    bool SK_WARN_UNUSED_RESULT asAffine(SkScalar affine[6]) const;
+
+    /** Set the matrix to the specified affine values.
+     *  Note: these are passed in column major order.
+     */
+    void setAffine(const SkScalar affine[6]);
 
     /** Apply this matrix to the array of points specified by src, and write
         the transformed points into the array of points specified by dst.
         dst[] = M * src[]
         @param dst  Where the transformed coordinates are written. It must
                     contain at least count entries
         @param src  The original coordinates that are to be transformed. It
                     must contain at least count entries
         @param count The number of points in src to read, and then transform
                      into dst.
@@ skipping 351 matching lines @@
     static void RotTrans_pts(const SkMatrix&, SkPoint dst[], const SkPoint[],
                              int count);
     static void Persp_pts(const SkMatrix&, SkPoint dst[], const SkPoint[], int);
 
     static const MapPtsProc gMapPtsProcs[];
 
     friend class SkPerspIter;
 };
 
 #endif