Class GradientFillSettings

GradientFillSettings class

Einstellungen für Verlaufsfülleffekte.

public class GradientFillSettings : BaseFillSettings, IGradientFillSettings

Konstrukteure

NameBeschreibung
GradientFillSettings()Initialisiert eine neue Instanz vonGradientFillSettings Klasse.

Eigenschaften

NameBeschreibung
AlignWithLayer { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob [an Ebene ausrichten].
Angle { get; set; }Ruft den Winkel ab oder legt ihn fest.
Color { get; set; }Ruft die Farbe ab oder legt sie fest.
ColorPoints { get; set; }Ruft die Farbpunkte ab oder setzt sie.
Dither { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob dies der Fall istGradientFillSettings ist Zittern.
override FillType { get; }Der Füllungstyp
GradientName { get; set; }Ruft den Namen des Farbverlaufs ab oder legt ihn fest.
GradientType { get; set; }Ruft den Verlaufstyp ab oder legt ihn fest.
HorizontalOffset { get; set; }Holt oder setzt den horizontalen Versatz in Prozent.
Reverse { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob dies der Fall istGradientFillSettings ist umgekehrt.
Scale { get; set; }Ruft die Skalierung ab oder legt sie fest.
TransparencyPoints { get; set; }Holt oder setzt die Transparenzpunkte.
VerticalOffset { get; set; }Holt oder setzt den vertikalen Offset in Prozent.

Methoden

NameBeschreibung
AddColorPoint()Fügt den Farbpunkt hinzu.
AddTransparencyPoint()Fügt den Farbpunkt hinzu.
RemoveColorPoint(IGradientColorPoint)Entfernt den Farbpunkt.
RemoveTransparencyPoint(IGradientTransparencyPoint)Entfernt den Transparenzpunkt.
static GenerateLfx2ResourceNodes()Erzeugt die LFX2-Ressourcenknoten.

Beispiele

Der folgende Code demonstriert die Unterstützung der Stricheffektebene mit dem Fülltyp „Verlauf“.

[C#]

void AssertIsTrue(bool condition, string message)
{
    if (!condition)
    {
        throw new FormatException(message);
    }
}
void AssertAreEqual(object expected, object actual, string message = null)
{
    if (!object.Equals(expected, actual))
    {
        throw new FormatException(message ?? "Objects are not equal.");
    }
}

string sourceFileName = "Stroke.psd";
string exportPath = "StrokeGradientChanged.psd";

var loadOptions = new PsdLoadOptions()
{
    LoadEffectsResource = true
};

using (var im = (PsdImage)Image.Load(sourceFileName, loadOptions))
{
    var gradientStroke = (StrokeEffect)im.Layers[2].BlendingOptions.Effects[0];

    AssertAreEqual(BlendMode.Normal, gradientStroke.BlendMode);
    AssertAreEqual((byte)255, gradientStroke.Opacity);
    AssertAreEqual(true, gradientStroke.IsVisible);

    var fillSettings = (GradientFillSettings)gradientStroke.FillSettings;
    AssertAreEqual(Color.Black, fillSettings.Color);
    AssertAreEqual(FillType.Gradient, fillSettings.FillType);
    AssertAreEqual(true, fillSettings.AlignWithLayer);
    AssertAreEqual(GradientType.Linear, fillSettings.GradientType);
    AssertIsTrue(Math.Abs(90 - fillSettings.Angle) < 0.001, "Angle is incorrect");
    AssertAreEqual(false, fillSettings.Dither);
    AssertIsTrue(Math.Abs(0 - fillSettings.HorizontalOffset) < 0.001, "Horizontal offset is incorrect");
    AssertIsTrue(Math.Abs(0 - fillSettings.VerticalOffset) < 0.001, "Vertical offset is incorrect");
    AssertAreEqual(false, fillSettings.Reverse);

    // Farbpunkte
    var colorPoints = fillSettings.ColorPoints;
    AssertAreEqual(2, colorPoints.Length);

    AssertAreEqual(Color.Black, colorPoints[0].Color);
    AssertAreEqual(0, colorPoints[0].Location);
    AssertAreEqual(50, colorPoints[0].MedianPointLocation);

    AssertAreEqual(Color.White, colorPoints[1].Color);
    AssertAreEqual(4096, colorPoints[1].Location);
    AssertAreEqual(50, colorPoints[1].MedianPointLocation);

    // Transparenzpunkte
    var transparencyPoints = fillSettings.TransparencyPoints;
    AssertAreEqual(2, transparencyPoints.Length);

    AssertAreEqual(0, transparencyPoints[0].Location);
    AssertAreEqual(50, transparencyPoints[0].MedianPointLocation);
    AssertAreEqual(100.00, transparencyPoints[0].Opacity);

    AssertAreEqual(4096, transparencyPoints[1].Location);
    AssertAreEqual(50, transparencyPoints[1].MedianPointLocation);
    AssertAreEqual(100.00, transparencyPoints[1].Opacity);

    // Bearbeitung testen
    fillSettings.Color = Color.Green;

    gradientStroke.Opacity = 127;
    gradientStroke.BlendMode = BlendMode.Color;

    fillSettings.AlignWithLayer = false;
    fillSettings.GradientType = GradientType.Radial;
    fillSettings.Angle = 45;
    fillSettings.Dither = true;
    fillSettings.HorizontalOffset = 15;
    fillSettings.VerticalOffset = 11;
    fillSettings.Reverse = true;

    // Neuen Farbpunkt hinzufügen
    var colorPoint = fillSettings.AddColorPoint();
    colorPoint.Color = Color.Green;
    colorPoint.Location = 4096;
    colorPoint.MedianPointLocation = 75;

    // Position des vorherigen Punktes ändern
    fillSettings.ColorPoints[1].Location = 1899;

    // Neuen Transparenzpunkt hinzufügen
    var transparencyPoint = fillSettings.AddTransparencyPoint();
    transparencyPoint.Opacity = 25;
    transparencyPoint.MedianPointLocation = 25;
    transparencyPoint.Location = 4096;

    // Position des vorherigen Transparenzpunkts ändern
    fillSettings.TransparencyPoints[1].Location = 2411;

    im.Save(exportPath);
}

// Datei nach Bearbeitung testen
using (var im = (PsdImage)Image.Load(exportPath, loadOptions))
{
    var gradientStroke = (StrokeEffect)im.Layers[2].BlendingOptions.Effects[0];

    AssertAreEqual(BlendMode.Color, gradientStroke.BlendMode);
    AssertAreEqual((byte)127, gradientStroke.Opacity);
    AssertAreEqual(true, gradientStroke.IsVisible);

    var fillSettings = (GradientFillSettings)gradientStroke.FillSettings;
    AssertAreEqual(Color.Green, fillSettings.Color);
    AssertAreEqual(FillType.Gradient, fillSettings.FillType);

    // Farbpunkte prüfen
    AssertAreEqual(3, fillSettings.ColorPoints.Length);

    var point = fillSettings.ColorPoints[0];
    AssertAreEqual(50, point.MedianPointLocation);
    AssertAreEqual(Color.Black, point.Color);
    AssertAreEqual(0, point.Location);

    point = fillSettings.ColorPoints[1];
    AssertAreEqual(50, point.MedianPointLocation);
    AssertAreEqual(Color.White, point.Color);
    AssertAreEqual(1899, point.Location);

    point = fillSettings.ColorPoints[2];
    AssertAreEqual(75, point.MedianPointLocation);
    AssertAreEqual(Color.Green, point.Color);
    AssertAreEqual(4096, point.Location);

    // Transparente Punkte prüfen
    AssertAreEqual(3, fillSettings.TransparencyPoints.Length);

    var transparencyPoint = fillSettings.TransparencyPoints[0];
    AssertAreEqual(50, transparencyPoint.MedianPointLocation);
    AssertAreEqual(100.00, transparencyPoint.Opacity);
    AssertAreEqual(0, transparencyPoint.Location);

    transparencyPoint = fillSettings.TransparencyPoints[1];
    AssertAreEqual(50, transparencyPoint.MedianPointLocation);
    AssertAreEqual(100.00, transparencyPoint.Opacity);
    AssertAreEqual(2411, transparencyPoint.Location);

    transparencyPoint = fillSettings.TransparencyPoints[2];
    AssertAreEqual(25, transparencyPoint.MedianPointLocation);
    AssertAreEqual(25.00, transparencyPoint.Opacity);
    AssertAreEqual(4096, transparencyPoint.Location);
}

Siehe auch

Class GradientColorPoint Class GradientTransparencyPoint