Class GradientFillSettings

GradientFillSettings class

إعدادات تأثير التعبئة المتدرجة .

public class GradientFillSettings : BaseFillSettings, IGradientFillSettings

المنشئون

اسموصف
GradientFillSettings()يقوم بتهيئة مثيل جديد لملفGradientFillSettings فئة .

الخصائص

اسموصف
AlignWithLayer { get; set; }الحصول على أو تعيين قيمة تشير إلى [محاذاة مع الطبقة] .
Angle { get; set; }الحصول على الزاوية أو تحديدها .
Color { get; set; }الحصول على اللون أو تحديده .
ColorPoints { get; set; }الحصول على نقاط اللون أو تعيينها .
Dither { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان هذاGradientFillSettings هو ثبات .
override FillType { get; }نوع التعبئة
GradientName { get; set; }الحصول على أو تحديد اسم التدرج اللوني .
GradientType { get; set; }الحصول على نوع التدرج اللوني أو تحديده.
HorizontalOffset { get; set; }الحصول على أو تعيين الإزاحة الأفقية بالنسبة المئوية.
Reverse { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان هذاGradientFillSettings عكس .
Scale { get; set; }الحصول على المقياس أو تعيينه.
TransparencyPoints { get; set; }الحصول على نقاط الشفافية أو تعيينها .
VerticalOffset { get; set; }الحصول على أو تعيين الإزاحة الرأسية بالنسبة المئوية.

طُرق

اسموصف
AddColorPoint()يضيف نقطة اللون .
AddTransparencyPoint()يضيف نقطة اللون .
RemoveColorPoint(IGradientColorPoint)يزيل نقطة اللون .
RemoveTransparencyPoint(IGradientTransparencyPoint)يزيل نقطة الشفافية .
static GenerateLfx2ResourceNodes()يولد عقد مورد LFX2 .

أمثلة

يوضح الكود التالي دعم طبقة تأثير الحد بنوع التعبئة - التدرج.

[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);

    // نقاط اللون
    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);

    // نقاط الشفافية
    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);

    // اختبار التحرير
    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;

    // أضف نقطة لون جديدة
    var colorPoint = fillSettings.AddColorPoint();
    colorPoint.Color = Color.Green;
    colorPoint.Location = 4096;
    colorPoint.MedianPointLocation = 75;

    // تغيير موقع النقطة السابقة
    fillSettings.ColorPoints[1].Location = 1899;

    // أضف نقطة شفافية جديدة
    var transparencyPoint = fillSettings.AddTransparencyPoint();
    transparencyPoint.Opacity = 25;
    transparencyPoint.MedianPointLocation = 25;
    transparencyPoint.Location = 4096;

    // تغيير موقع نقطة الشفافية السابقة
    fillSettings.TransparencyPoints[1].Location = 2411;

    im.Save(exportPath);
}

// اختبار الملف بعد التحرير
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);

    // تحقق من نقاط اللون
    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);

    // تحقق من النقاط الشفافة
    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);
}

أنظر أيضا

Class GradientColorPoint Class GradientTransparencyPoint