Image::GetMatrixInverse

virtual bool GetMatrixInverse(Matrix2F* mat) const;

GetMatrixInverse retrieves the inverse image matrix used with an image for adjusting its size and/or location. 

SetMatrix/GetMatrix methods access an image matrix that may be associated with an image to adjust its size and/or location. Matrix of scale 2.0, for example, will make the image 2x bigger; while translation of 4.0 will shift it 4 pixels to the right. Among other things, image matrix is used to adjust for scaling done by 'gfxexport'. This matrix is Identity by default and doesn't occupy additional space unless assigned. Matrix is allocated in AUTO heap by default; alternatively, heap can be explicit. The matrix is actually stored as an inverse, so additional inverse accessors are provided for efficiency (an inverse must be applied to UV image matrix).