lsm/PdfPig
1
0
Fork 0
mirror of https://github.com/UglyToad/PdfPig.git synced 2025-10-20 19:03:20 +08:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity

#26 make almost all operators public

Browse Source
This commit is contained in:
Eliot Jones
2019-01-03 22:20:53 +00:00
parent 29daeb5806
commit 5c8a77bf33
75 changed files with 1196 additions and 304 deletions
Download Patch File Download Diff File Expand all files Collapse all files

115
src/UglyToad.PdfPig/Core/TransformationMatrix.cs
View File

@@ -8,8 +8,11 @@
/// <summary>
/// Specifies the conversion from the transformed coordinate space to the original untransformed coordinate space.
/// </summary>
internal struct TransformationMatrix
public struct TransformationMatrix
{
/// <summary>
/// The default <see cref="TransformationMatrix"/>.
/// </summary>
public static TransformationMatrix Identity = new TransformationMatrix(new decimal[]
{
1,0,0,
@@ -23,37 +26,52 @@
/// The scale for the X dimension.
/// </summary>
public decimal A => value[0];
/// <summary>
/// The value at (0, 1).
/// </summary>
public decimal B => value[1];
/// <summary>
/// The value at (1, 0).
/// </summary>
public decimal C => value[3];
/// <summary>
/// The scale for the Y dimension.
/// </summary>
public decimal D => value[4];
/// <summary>
/// The value at (2, 0) - translation in X.
/// </summary>
public decimal E => value[6];
/// <summary>
/// The value at (2, 1) - translation in Y.
/// </summary>
public decimal F => value[7];
/// <summary>
/// Get the value at the specific row and column.
/// </summary>
public decimal this[int row, int col]
{
get
{
if (row >= Rows)
{
throw new ArgumentOutOfRangeException($"The transformation matrix only contains {Rows} rows and is zero indexed, you tried to access row {row}.");
throw new ArgumentOutOfRangeException(nameof(row), $"The transformation matrix only contains {Rows} rows and is zero indexed, you tried to access row {row}.");
}
if (row < 0)
{
throw new ArgumentOutOfRangeException("Cannot access negative rows in a matrix.");
throw new ArgumentOutOfRangeException(nameof(row), "Cannot access negative rows in a matrix.");
}
if (col >= Columns)
{
throw new ArgumentOutOfRangeException($"The transformation matrix only contains {Columns} columns and is zero indexed, you tried to access column {col}.");
throw new ArgumentOutOfRangeException(nameof(col), $"The transformation matrix only contains {Columns} columns and is zero indexed, you tried to access column {col}.");
}
if (col < 0)
{
throw new ArgumentOutOfRangeException("Cannot access negative columns in a matrix.");
throw new ArgumentOutOfRangeException(nameof(col), "Cannot access negative columns in a matrix.");
}
var resultIndex = row * Rows + col;
@@ -67,9 +85,19 @@
}
}
/// <summary>
/// The number of rows in the matrix.
/// </summary>
public const int Rows = 3;
/// <summary>
/// The number of columns in the matrix.
/// </summary>
public const int Columns = 3;
/// <summary>
/// Create a new <see cref="TransformationMatrix"/>.
/// </summary>
/// <param name="value">The 9 values of the matrix.</param>
public TransformationMatrix(decimal[] value)
{
if (value == null)
@@ -85,6 +113,12 @@
this.value = value;
}
/// <summary>
/// Transform a point using this transformation matrix.
/// </summary>
/// <param name="original">The original point.</param>
/// <returns>A new point which is the result of applying this transformation matrix.</returns>
[Pure]
public PdfPoint Transform(PdfPoint original)
{
var x = A * original.X + C * original.Y + E;
@@ -93,16 +127,26 @@
return new PdfPoint(x, y);
}
/// <summary>
/// Transform an X coordinate using this transformation matrix.
/// </summary>
/// <param name="x">The X coordinate.</param>
/// <returns>The transformed X coordinate.</returns>
[Pure]
public decimal TransformX(decimal x)
internal decimal TransformX(decimal x)
{
var xt = A * x + C * 0 + E;
return xt;
}
/// <summary>
/// Transform a vector using this transformation matrix.
/// </summary>
/// <param name="original">The original vector.</param>
/// <returns>A new vector which is the result of applying this transformation matrix.</returns>
[Pure]
public PdfVector Transform(PdfVector original)
internal PdfVector Transform(PdfVector original)
{
var x = A * original.X + C * original.Y + E;
var y = B * original.X + D * original.Y + F;
@@ -110,6 +154,11 @@
return new PdfVector(x, y);
}
/// <summary>
/// Transform a rectangle using this transformation matrix.
/// </summary>
/// <param name="original">The original rectangle.</param>
/// <returns>A new rectangle which is the result of applying this transformation matrix.</returns>
[Pure]
public PdfRectangle Transform(PdfRectangle original)
{
@@ -121,8 +170,17 @@
);
}
/// <summary>
/// Create a new <see cref="TransformationMatrix"/> from the 6 values provided in the default PDF order.
/// </summary>
public static TransformationMatrix FromValues(decimal a, decimal b, decimal c, decimal d, decimal e, decimal f)
=> FromArray(new[] {a, b, c, d, e, f});
/// <summary>
/// Create a new <see cref="TransformationMatrix"/> from the values.
/// </summary>
/// <param name="values">Either all 9 values of the matrix, 6 values in the default PDF order or the 4 values of the top left square.</param>
/// <returns></returns>
public static TransformationMatrix FromArray(decimal[] values)
{
if (values.Length == 9)
@@ -153,19 +211,25 @@
throw new ArgumentException("The array must either define all 9 elements of the matrix or all 6 key elements. Instead array was: " + values);
}
/// <summary>
/// Multiplies one transformation matrix by another without modifying either matrix. Order is: (this * matrix).
/// </summary>
/// <param name="matrix">The matrix to multiply</param>
/// <returns>The resulting matrix.</returns>
[Pure]
public TransformationMatrix Multiply(TransformationMatrix matrix)
{
var result = new decimal[9];
for (int i = 0; i < Rows; i++)
for (var i = 0; i < Rows; i++)
{
var rowIndexPart = i * Rows;
for (int j = 0; j < Columns; j++)
for (var j = 0; j < Columns; j++)
{
var index = rowIndexPart + j;
for (int x = 0; x < Rows; x++)
for (var x = 0; x < Rows; x++)
{
result[index] += this[i, x] * matrix[x, j];
}
@@ -175,17 +239,23 @@
return new TransformationMatrix(result);
}
/// <summary>
/// Multiplies the matrix by a scalar value without modifying this matrix.
/// </summary>
/// <param name="scalar">The value to multiply.</param>
/// <returns>A new matrix which is multiplied by the scalar value.</returns>
[Pure]
public TransformationMatrix Multiply(decimal scalar)
{
var result = new decimal[9];
for (int i = 0; i < Rows; i++)
for (var i = 0; i < Rows; i++)
{
for (int j = 0; j < Columns; j++)
for (var j = 0; j < Columns; j++)
{
var index = (i * Rows) + j;
for (int x = 0; x < Rows; x++)
for (var x = 0; x < Rows; x++)
{
result[index] += this[i, x] * scalar;
}
@@ -195,7 +265,11 @@
return new TransformationMatrix(result);
}
public decimal GetScalingFactorX()
/// <summary>
/// Get the X scaling component of the current matrix.
/// </summary>
/// <returns></returns>
internal decimal GetScalingFactorX()
{
var xScale = A;
@@ -224,6 +298,7 @@
return xScale;
}
/// <inheritdoc />
public override bool Equals(object obj)
{
if (!(obj is TransformationMatrix m))
@@ -234,11 +309,14 @@
return Equals(this, m);
}
/// <summary>
/// Determines whether 2 transformation matrices are equal.
/// </summary>
public static bool Equals(TransformationMatrix a, TransformationMatrix b)
{
for (int i = 0; i < Rows; i++)
for (var i = 0; i < Rows; i++)
{
for (int j = 0; j < Columns; j++)
for (var j = 0; j < Columns; j++)
{
if (a[i, j] != b[i, j])
{
@@ -250,6 +328,7 @@
return true;
}
/// <inheritdoc />
public override int GetHashCode()
{
var hashCode = 1113510858;
@@ -258,11 +337,15 @@
return hashCode;
}
/// <inheritdoc />
public override string ToString()
{
return $"{A}, {B}, 0\r\n{C}, {D}, 0\r\n{E}, {F}, 1";
}
/// <summary>
/// Create a new <see cref="TransformationMatrix"/> with the X and Y translation values set.
/// </summary>
public static TransformationMatrix GetTranslationMatrix(decimal x, decimal y)
{
return new TransformationMatrix(new []