// // System.Drawing.Drawing2D.PathGradientBrush.cs // // Authors: // Dennis Hayes (dennish@Raytek.com) // Andreas Nahr (ClassDevelopment@A-SoftTech.com) // Ravindra (rkumar@novell.com) // // Copyright (C) 2002/3 Ximian, Inc. http://www.ximian.com // Copyright (C) 2004,2006 Novell, Inc (http://www.novell.com) // // Permission is hereby granted, free of charge, to any person obtaining // a copy of this software and associated documentation files (the // "Software"), to deal in the Software without restriction, including // without limitation the rights to use, copy, modify, merge, publish, // distribute, sublicense, and/or sell copies of the Software, and to // permit persons to whom the Software is furnished to do so, subject to // the following conditions: // // The above copyright notice and this permission notice shall be // included in all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. // using System.ComponentModel; namespace System.Drawing.Drawing2D { [MonoTODO ("libgdiplus/cairo doesn't support path gradients - unless it can be mapped to a radial gradient")] public sealed class PathGradientBrush : Brush { internal PathGradientBrush (IntPtr native) : base (native) { } public PathGradientBrush (GraphicsPath path) { if (path == null) throw new ArgumentNullException ("path"); Status status = GDIPlus.GdipCreatePathGradientFromPath (path.NativeObject, out nativeObject); GDIPlus.CheckStatus (status); } public PathGradientBrush (Point [] points) : this (points, WrapMode.Clamp) { } public PathGradientBrush (PointF [] points) : this (points, WrapMode.Clamp) { } public PathGradientBrush (Point [] points, WrapMode wrapMode) { if (points == null) throw new ArgumentNullException ("points"); if ((wrapMode < WrapMode.Tile) || (wrapMode > WrapMode.Clamp)) throw new InvalidEnumArgumentException ("WrapMode"); Status status = GDIPlus.GdipCreatePathGradientI (points, points.Length, wrapMode, out nativeObject); GDIPlus.CheckStatus (status); } public PathGradientBrush (PointF [] points, WrapMode wrapMode) { if (points == null) throw new ArgumentNullException ("points"); if ((wrapMode < WrapMode.Tile) || (wrapMode > WrapMode.Clamp)) throw new InvalidEnumArgumentException ("WrapMode"); Status status = GDIPlus.GdipCreatePathGradient (points, points.Length, wrapMode, out nativeObject); GDIPlus.CheckStatus (status); } // Properties public Blend Blend { get { int count; Status status = GDIPlus.GdipGetPathGradientBlendCount (nativeObject, out count); GDIPlus.CheckStatus (status); float [] factors = new float [count]; float [] positions = new float [count]; status = GDIPlus.GdipGetPathGradientBlend (nativeObject, factors, positions, count); GDIPlus.CheckStatus (status); Blend blend = new Blend (); blend.Factors = factors; blend.Positions = positions; return blend; } set { int count; float [] factors = value.Factors; float [] positions = value.Positions; count = factors.Length; if (count == 0 || positions.Length == 0) throw new ArgumentException ("Invalid Blend object. It should have at least 2 elements in each of the factors and positions arrays."); if (count != positions.Length) throw new ArgumentException ("Invalid Blend object. It should contain the same number of factors and positions values."); if (positions [0] != 0.0F) throw new ArgumentException ("Invalid Blend object. The positions array must have 0.0 as its first element."); if (positions [count - 1] != 1.0F) throw new ArgumentException ("Invalid Blend object. The positions array must have 1.0 as its last element."); Status status = GDIPlus.GdipSetPathGradientBlend (nativeObject, factors, positions, count); GDIPlus.CheckStatus (status); } } public Color CenterColor { get { int centerColor; Status status = GDIPlus.GdipGetPathGradientCenterColor (nativeObject, out centerColor); GDIPlus.CheckStatus (status); return Color.FromArgb (centerColor); } set { Status status = GDIPlus.GdipSetPathGradientCenterColor (nativeObject, value.ToArgb ()); GDIPlus.CheckStatus (status); } } public PointF CenterPoint { get { PointF center; Status status = GDIPlus.GdipGetPathGradientCenterPoint (nativeObject, out center); GDIPlus.CheckStatus (status); return center; } set { PointF center = value; Status status = GDIPlus.GdipSetPathGradientCenterPoint (nativeObject, ref center); GDIPlus.CheckStatus (status); } } public PointF FocusScales { get { float xScale; float yScale; Status status = GDIPlus.GdipGetPathGradientFocusScales (nativeObject, out xScale, out yScale); GDIPlus.CheckStatus (status); return new PointF (xScale, yScale); } set { Status status = GDIPlus.GdipSetPathGradientFocusScales (nativeObject, value.X, value.Y); GDIPlus.CheckStatus (status); } } public ColorBlend InterpolationColors { get { int count; Status status = GDIPlus.GdipGetPathGradientPresetBlendCount (nativeObject, out count); GDIPlus.CheckStatus (status); // if no failure, then the "managed" minimum is 1 if (count < 1) count = 1; int [] intcolors = new int [count]; float [] positions = new float [count]; // status would fail if we ask points or types with a < 2 count if (count > 1) { status = GDIPlus.GdipGetPathGradientPresetBlend (nativeObject, intcolors, positions, count); GDIPlus.CheckStatus (status); } ColorBlend interpolationColors = new ColorBlend (); Color [] colors = new Color [count]; for (int i = 0; i < count; i++) colors [i] = Color.FromArgb (intcolors [i]); interpolationColors.Colors = colors; interpolationColors.Positions = positions; return interpolationColors; } set { int count; Color [] colors = value.Colors; float [] positions = value.Positions; count = colors.Length; if (count == 0 || positions.Length == 0) throw new ArgumentException ("Invalid ColorBlend object. It should have at least 2 elements in each of the colors and positions arrays."); if (count != positions.Length) throw new ArgumentException ("Invalid ColorBlend object. It should contain the same number of positions and color values."); if (positions [0] != 0.0F) throw new ArgumentException ("Invalid ColorBlend object. The positions array must have 0.0 as its first element."); if (positions [count - 1] != 1.0F) throw new ArgumentException ("Invalid ColorBlend object. The positions array must have 1.0 as its last element."); int [] blend = new int [colors.Length]; for (int i = 0; i < colors.Length; i++) blend [i] = colors [i].ToArgb (); Status status = GDIPlus.GdipSetPathGradientPresetBlend (nativeObject, blend, positions, count); GDIPlus.CheckStatus (status); } } public RectangleF Rectangle { get { RectangleF rect; Status status = GDIPlus.GdipGetPathGradientRect (nativeObject, out rect); GDIPlus.CheckStatus (status); return rect; } } public Color [] SurroundColors { get { int count; Status status = GDIPlus.GdipGetPathGradientSurroundColorCount (nativeObject, out count); GDIPlus.CheckStatus (status); int [] intcolors = new int [count]; status = GDIPlus.GdipGetPathGradientSurroundColorsWithCount (nativeObject, intcolors, ref count); GDIPlus.CheckStatus (status); Color [] colors = new Color [count]; for (int i = 0; i < count; i++) colors [i] = Color.FromArgb (intcolors [i]); return colors; } set { int count = value.Length; int [] colors = new int [count]; for (int i = 0; i < count; i++) colors [i] = value [i].ToArgb (); Status status = GDIPlus.GdipSetPathGradientSurroundColorsWithCount (nativeObject, colors, ref count); GDIPlus.CheckStatus (status); } } public Matrix Transform { get { Matrix matrix = new Matrix (); Status status = GDIPlus.GdipGetPathGradientTransform (nativeObject, matrix.nativeMatrix); GDIPlus.CheckStatus (status); return matrix; } set { if (value == null) throw new ArgumentNullException ("Transform"); Status status = GDIPlus.GdipSetPathGradientTransform (nativeObject, value.nativeMatrix); GDIPlus.CheckStatus (status); } } public WrapMode WrapMode { get { WrapMode wrapMode; Status status = GDIPlus.GdipGetPathGradientWrapMode (nativeObject, out wrapMode); GDIPlus.CheckStatus (status); return wrapMode; } set { if ((value < WrapMode.Tile) || (value > WrapMode.Clamp)) throw new InvalidEnumArgumentException ("WrapMode"); Status status = GDIPlus.GdipSetPathGradientWrapMode (nativeObject, value); GDIPlus.CheckStatus (status); } } // Methods public void MultiplyTransform (Matrix matrix) { MultiplyTransform (matrix, MatrixOrder.Prepend); } public void MultiplyTransform (Matrix matrix, MatrixOrder order) { if (matrix == null) throw new ArgumentNullException ("matrix"); Status status = GDIPlus.GdipMultiplyPathGradientTransform (nativeObject, matrix.nativeMatrix, order); GDIPlus.CheckStatus (status); } public void ResetTransform () { Status status = GDIPlus.GdipResetPathGradientTransform (nativeObject); GDIPlus.CheckStatus (status); } public void RotateTransform (float angle) { RotateTransform (angle, MatrixOrder.Prepend); } public void RotateTransform (float angle, MatrixOrder order) { Status status = GDIPlus.GdipRotatePathGradientTransform (nativeObject, angle, order); GDIPlus.CheckStatus (status); } public void ScaleTransform (float sx, float sy) { ScaleTransform (sx, sy, MatrixOrder.Prepend); } public void ScaleTransform (float sx, float sy, MatrixOrder order) { Status status = GDIPlus.GdipScalePathGradientTransform (nativeObject, sx, sy, order); GDIPlus.CheckStatus (status); } public void SetBlendTriangularShape (float focus) { SetBlendTriangularShape (focus, 1.0F); } public void SetBlendTriangularShape (float focus, float scale) { if (focus < 0 || focus > 1 || scale < 0 || scale > 1) throw new ArgumentException ("Invalid parameter passed."); Status status = GDIPlus.GdipSetPathGradientLinearBlend (nativeObject, focus, scale); GDIPlus.CheckStatus (status); } public void SetSigmaBellShape (float focus) { SetSigmaBellShape (focus, 1.0F); } public void SetSigmaBellShape (float focus, float scale) { if (focus < 0 || focus > 1 || scale < 0 || scale > 1) throw new ArgumentException ("Invalid parameter passed."); Status status = GDIPlus.GdipSetPathGradientSigmaBlend (nativeObject, focus, scale); GDIPlus.CheckStatus (status); } public void TranslateTransform (float dx, float dy) { TranslateTransform (dx, dy, MatrixOrder.Prepend); } public void TranslateTransform (float dx, float dy, MatrixOrder order) { Status status = GDIPlus.GdipTranslatePathGradientTransform (nativeObject, dx, dy, order); GDIPlus.CheckStatus (status); } public override object Clone () { IntPtr clonePtr; Status status = GDIPlus.GdipCloneBrush (nativeObject, out clonePtr); GDIPlus.CheckStatus (status); PathGradientBrush clone = new PathGradientBrush (clonePtr); return clone; } } }