GtkSharp/doc/en/Art/Affine.xml
Mike Kestner 0e47e78f96 update docs to 2.8 API and document all new members
svn path=/trunk/gtk-sharp/; revision=54175
2005-12-09 23:12:49 +00:00

264 lines
12 KiB
XML

<Type Name="Affine" FullName="Art.Affine">
<TypeSignature Language="C#" Value="public class Affine" Maintainer="auto" />
<AssemblyInfo>
<AssemblyName>art-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.8.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Docs>
<summary>Defines an affine transformation</summary>
<remarks>To be added</remarks>
</Docs>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Members>
<Member MemberName="Rotate">
<MemberSignature Language="C#" Value="public static void Rotate (double[] dst, double theta);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
<Parameter Name="theta" Type="System.Double" />
</Parameters>
<Docs>
<summary>Sets up a rotation matrix.</summary>
<param name="dst">Where to store the resulting affine transformation.</param>
<param name="theta">Rotation angle in degrees.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Expansion">
<MemberSignature Language="C#" Value="public static double Expansion (double[] src);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Double</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="src" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Finds the expansion factor, i.e. the square root of the factor by which the affine transform affects area.</summary>
<param name="src">The affine transformation.</param>
<returns>The expansion factor.</returns>
<remarks>In an affine transform composed of scaling, rotation, shearing, and translation, returns the amount of scaling.</remarks>
</Docs>
</Member>
<Member MemberName="Identity">
<MemberSignature Language="C#" Value="public static void Identity (double[] dst);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Set up the identity matrix.</summary>
<param name="dst">Where to store the resulting affine transform.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Flip">
<MemberSignature Language="C#" Value="public static void Flip (double[] dst_affine, double[] src_affine, bool horz, bool vert);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst_affine" Type="System.Double[]" />
<Parameter Name="src_affine" Type="System.Double[]" />
<Parameter Name="horz" Type="System.Boolean" />
<Parameter Name="vert" Type="System.Boolean" />
</Parameters>
<Docs>
<summary>Flips the affine transform.</summary>
<param name="dst_affine">Where to store the resulting affine transform.</param>
<param name="src_affine">The original affine transformation.</param>
<param name="horz">Whether or not to flip horizontally.</param>
<param name="vert">Whether or not to flip vertically.</param>
<remarks>Both horz and vert false results in a simple copy operation. True for both results in an 180 degree rotation.</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="ToStringArray">
<MemberSignature Language="C#" Value="public static void ToStringArray (string[] str, double[] src);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="str" Type="System.String[]" />
<Parameter Name="src" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Converts an affine transform into a bit of PostScript code that implements the transform.</summary>
<param name="str">The resulting string.</param>
<param name="src">The affine transform.</param>
<remarks>Special cases of scaling, rotation, and translation are detected, and the corresponding PostScript operators used (this greatly aids understanding the output generated). The identity transform is mapped to the null string.</remarks>
</Docs>
</Member>
<Member MemberName="Invert">
<MemberSignature Language="C#" Value="public static void Invert (double[] dst_affine, double[] src_affine);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst_affine" Type="System.Double[]" />
<Parameter Name="src_affine" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Sets up the inverse of the given transformation.</summary>
<param name="dst_affine">Where the resulting affine is stored.</param>
<param name="src_affine">The original affine transformation.</param>
<remarks>The inverse is in the classical sense; src_affine multiplied with dst_affine, or dst_affine multiplied with src_affine will be (to within roundoff error) the identify affine. See <see cref="M:Art.Affine.Identity(double[])" /></remarks>
</Docs>
</Member>
<Member MemberName="Multiply">
<MemberSignature Language="C#" Value="public static void Multiply (double[] dst, double[] src1, double[] src2);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
<Parameter Name="src1" Type="System.Double[]" />
<Parameter Name="src2" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Multiplies two affine transforms together, i.e. the resulting dst is equivalent to doing first src1 then src2.</summary>
<param name="dst">Where to store the resulting affine transform.</param>
<param name="src1">The first affine transform to multiply.</param>
<param name="src2">The second affine transform to multiply.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Shear">
<MemberSignature Language="C#" Value="public static void Shear (double[] dst, double theta);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
<Parameter Name="theta" Type="System.Double" />
</Parameters>
<Docs>
<summary>Setup a shearing matrix</summary>
<param name="dst">Where to store the resulting affine transformation.</param>
<param name="theta">Shear angle in degrees.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Rectilinear">
<MemberSignature Language="C#" Value="public static bool Rectilinear (double[] src);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="src" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Determines wether a matrix is rectilinear, i.e. grid-aligned rectangles are transformed to other grid-aligned rectangles.</summary>
<param name="src">The affine transformation to test.</param>
<returns>
<see langword="true" /> if the matrix is rectilinear.</returns>
<remarks>The implementation has epsilon-tolerance for roundoff errors.</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="Equal">
<MemberSignature Language="C#" Value="public static bool Equal (double[] matrix1, double[] matrix2);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="matrix1" Type="System.Double[]" />
<Parameter Name="matrix2" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Determine if two matrices are equal.</summary>
<param name="matrix1">An affine transformation.</param>
<param name="matrix2">Another affine transformation.</param>
<returns>
<see langword="true" /> if the matrices are equal.</returns>
<remarks>Equality is verified with epsilon-tolerance for roundoff errors.</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="Translate">
<MemberSignature Language="C#" Value="public static void Translate (double[] dst, double tx, double ty);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
<Parameter Name="tx" Type="System.Double" />
<Parameter Name="ty" Type="System.Double" />
</Parameters>
<Docs>
<summary>Sets up a translation matrix.</summary>
<param name="dst">Where to store the resulting affine transform.</param>
<param name="tx">X translation amount.</param>
<param name="ty">Y translation amount.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Scale">
<MemberSignature Language="C#" Value="public static void Scale (double[] dst, double sx, double sy);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dst" Type="System.Double[]" />
<Parameter Name="sx" Type="System.Double" />
<Parameter Name="sy" Type="System.Double" />
</Parameters>
<Docs>
<summary>Sets up a scaling matrix.</summary>
<param name="dst">Where to store the resulting affine transform.</param>
<param name="sx">X scale factor.</param>
<param name="sy">Y scale factor.</param>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Affine ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>To be added</summary>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Point">
<MemberSignature Language="C#" Value="public static Art.Point Point (Art.Point src, double[] affine);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Art.Point</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="src" Type="Art.Point" />
<Parameter Name="affine" Type="System.Double[]" />
</Parameters>
<Docs>
<summary>Apply an affine transform to an <see cref="T:Art.Point" />.</summary>
<param name="src">The original point.</param>
<param name="affine">The affine transform.</param>
<returns>The resulting point after performing the transform.</returns>
<remarks>To be added</remarks>
</Docs>
</Member>
</Members>
</Type>