Release Notes Aspose.PSD برای .NET 21.10

این صفحه حاوی یادداشت‌های انتشار برای Aspose.PSD برای .NET 21.10 می‌باشد.

کلید	خلاصه	دسته‌بندی
PSDNET-128	پشتیبانی از مکانیزم فیلترهای هوشمند	امکانات
PSDNET-414	پشتیبانی از Fxid/FEidResource	امکانات
PSDNET-556	خطا در بارگذاری ساختار Alias	اشکال
PSDNET-948	تغییر یونیکد و رنگ برای TextLayer PSD	اشکال
PSDNET-971	افزودن قابلیت ساخت سفارشی یک لایه با یک ماسک برداری	بهبود

تغییرات عمومی API

API های اضافه شده:

P:Aspose.PSD.FileFormats.Psd.Layers.SmartObjects.SmartObjectLayer.SmartFilters
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.#ctor
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.Name
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.FilterId
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.Distribution
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.AmountNoise
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.IsMonochromatic
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.AddNoiseSmartFilter.FilterType
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter.#ctor
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter.Name
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter.FilterId
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter.Radius
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.GaussianBlurSmartFilter.FilterType
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.NoiseDistribution
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.NoiseDistribution.Uniform
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.NoiseDistribution.Gaussian
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.Name
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.FilterId
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.IsEnabled
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.Opacity
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.BlendMode
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.Apply(Aspose.PSD.RasterImage)
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.ApplyToMask(Aspose.PSD.FileFormats.Psd.Layers.Layer)
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.OnLoad
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.Clone
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.SmartFilter.sourceDescriptor
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.UnknownSmartFilter
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.UnknownSmartFilter.Name
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.Filters.UnknownSmartFilter.FilterId
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.IsEnabled
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.IsValidAtPosition
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.IsMaskEnabled
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.IsMaskLinked
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.IsMaskExtendWithWhite
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.Filters
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.SmartObjectResources.SmartFilters.SmartFilters.UpdateResourceValues
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.#ctor(System.Int32,System.Int32,Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData[])
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.Signature
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.Key
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.PsdVersion
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.Version
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.FilterEffectMasks
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.Length
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.Save(Aspose.PSD.StreamContainer,System.Int32)
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.FEidTypeToolKey
F:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FXidResource.FXidTypeToolKey
T:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.#ctor(System.String,Aspose.PSD.Rectangle,System.Int32,System.Int32,Aspose.PSD.FileFormats.Psd.Layers.ChannelInformation[],Aspose.PSD.FileFormats.Psd.Layers.ChannelInformation,Aspose.PSD.Rectangle,Aspose.PSD.FileFormats.Psd.Layers.ChannelInformation)
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.Length
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.GUID
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.Rectangle
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.PixelsDepth
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.MaxChannels
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.Channels
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.UserMask
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.MaskRectangle
P:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.SheetMask
M:Aspose.PSD.FileFormats.Psd.Layers.LayerResources.FilterEffectMaskData.SaveData(Aspose.PSD.StreamContainer)

API های حذف شده:

هیچکدام

مثال‌های استفاده:

PSDNET-128. پشتیبانی از مکانیزم فیلترهای هوشمند

        string sourceFilte = "r2_SmartFilters.psd";
        string outputPsd = "out_r2_SmartFilters.psd";

        void AssertAreEqual(object expected, object actual)
        {
            if (!object.Equals(expected, actual))
            {
                throw new Exception("اشیا برابر نیستند.");
            }
        }

        using (var image = (PsdImage)Image.Load(sourceFilte))
        {
            SmartObjectLayer smartObj = (SmartObjectLayer)image.Layers[1];

            // edit smart filters
            GaussianBlurSmartFilter gaussianBlur = (GaussianBlurSmartFilter)smartObj.SmartFilters.Filters[0];

            // check filter values
            AssertAreEqual(3.1, gaussianBlur.Radius);
            AssertAreEqual(BlendMode.Dissolve, gaussianBlur.BlendMode);
            AssertAreEqual(90d, gaussianBlur.Opacity);
            AssertAreEqual(true, gaussianBlur.IsEnabled);

            // update filter values
            gaussianBlur.Radius = 1;
            gaussianBlur.BlendMode = BlendMode.Divide;
            gaussianBlur.Opacity = 75;
            gaussianBlur.IsEnabled = false;
            AddNoiseSmartFilter addNoise = (AddNoiseSmartFilter)smartObj.SmartFilters.Filters[1];
            addNoise.Distribution = NoiseDistribution.Uniform;

            // add new filter items
            var filters = new List<SmartFilter>(smartObj.SmartFilters.Filters);
            filters.Add(new GaussianBlurSmartFilter());
            filters.Add(new AddNoiseSmartFilter());
            smartObj.SmartFilters.Filters = filters.ToArray();

            // apply changes
            smartObj.SmartFilters.UpdateResourceValues();

            // Apply filters
            smartObj.SmartFilters.Filters[0].Apply(image.Layers[2]);
            smartObj.SmartFilters.Filters[4].ApplyToMask(image.Layers[2]);

            image.Save(outputPsd);
        }

        using (var image = (PsdImage)Image.Load(outputPsd))
        {
            SmartObjectLayer smartObj = (SmartObjectLayer)image.Layers[1];

            GaussianBlurSmartFilter gaussianBlur = (GaussianBlurSmartFilter)smartObj.SmartFilters.Filters[0];

            // check filter values
            AssertAreEqual(1d, gaussianBlur.Radius);
            AssertAreEqual(BlendMode.Divide, gaussianBlur.BlendMode);
            AssertAreEqual(75d, gaussianBlur.Opacity);
            AssertAreEqual(false, gaussianBlur.IsEnabled);

            AssertAreEqual(true, smartObj.SmartFilters.Filters[5] is GaussianBlurSmartFilter);
            AssertAreEqual(true, smartObj.SmartFilters.Filters[6] is AddNoiseSmartFilter);
        }

PSDNET-414. پشتیبانی از Fxid/FEidResource

        string inputFilePath = "psdnet414_3.psd";
        string output = "out_psdnet414_3.psd";

        int resLength = 1144;
        int maskLength = 369;

        void AssertAreEqual(object expected, object actual, string message = null)
        {
            if (!object.Equals(expected, actual))
            {
                throw new FormatException(message ?? "اشیا برابر نیستند.");
            }
        }

        using (var psdImage = (PsdImage)Image.Load(inputFilePath))
        {
            FXidResource fXidResource = (FXidResource)psdImage.GlobalLayerResources[3];

            AssertAreEqual(resLength, fXidResource.Length);
            foreach (var maskData in fXidResource.FilterEffectMasks)
            {
                AssertAreEqual(maskLength, maskData.Length);
            }

            psdImage.Save(output);
        }

        // check after saving
        using (var psdImage = (PsdImage)Image.Load(output))
        {
            FXidResource fXidResource = (FXidResource)psdImage.GlobalLayerResources[3];

            AssertAreEqual(resLength, fXidResource.Length);
            foreach (var maskData in fXidResource.FilterEffectMasks)
            {
                AssertAreEqual(maskLength, maskData.Length);
            }
        }

PSDNET-556. خطا در بارگذاری ساختار Alias

        string srcFile = "Aspose.psd";
        string outputPsd = "out_Aspose.psd";
        string outputPng = "out_Aspose.png";

        void AssertAreEqual(object expected, object actual, string message = null)
        {
            if (!object.Equals(expected, actual))
            {
                throw new FormatException(message ?? "اشیا برابر نیستند.");
            }
        }

        using (var image = (PsdImage)Image.Load(srcFile))
        {
            LnkeResource lnkeResource = (LnkeResource)image.GlobalLayerResources[3];
            LiFeDataSource dataSource = (LiFeDataSource)lnkeResource[0];
            AssertAreEqual(2484L, dataSource.Length);

            foreach (var layer in image.Layers)
            {
                if (layer is TextLayer)
                {
                    TextLayer textLayer = layer as TextLayer;
                    textLayer.UpdateText("Test", Aspose.PSD.Color.Black);
                }
            }

            image.Save(outputPsd);
            image.Save(outputPng, new PngOptions() { ColorType = PngColorType.GrayscaleWithAlpha });
        }

PSDNET-948. تغییر یونیکد و رنگ برای TextLayer PSD

        string sourceFileName = "fontExamples948.psd";
        string testFontsFoler = "Fonts";
        string outputPng = "output.png";

        FontSettings.SetFontsFolder(testFontsFoler);

        using (PsdImage image = (PsdImage)Aspose.PSD.Image.Load(sourceFileName))
        {
            foreach (var layer in image.Layers)
            {
                var textLayer = layer as TextLayer;
                if (textLayer != null)
                {
                    ITextPortion textPortion = textLayer.TextData.Items[0];
                    textPortion.Style.FillColor = Color.BlueViolet;

                    textLayer.TextData.UpdateLayerData();
                }
            }

            image.Save(outputPng, new PngOptions());
        }

PSDNET-971. افزودن قابلیت ساخت سفارشی یک لایه با یک ماسک برداری

        public void CreatingVectorPathExample()
        {
            string fileName = "PathExample2.psd";

            string outputPsd = "out_CreatingVectorPathExampleTest.psd";
            string outputPng = "out_CreatingVectorPathExampleTest.png";

            using (var psdImage = (PsdImage)Image.Load(fileName))
            {
                VectorDataProvider.RemoveVectorPathDataFromLayer(psdImage.Layers[2]);

                // creating VectorPath object for existing layer without vector path data.
                VectorPath vectorPath = VectorDataProvider.CreateVectorPathForLayer(psdImage.Layers[1]);

                // Set the fill color of vector path
                vectorPath.FillColor = Color.MediumPurple;

                // add new shape
                PathShape newShape = new PathShape();
                newShape.Points.Add(new BezierKnot(new PointF(65, 175), true));
                newShape.Points.Add(new BezierKnot(new PointF(65, 210), true));
                newShape.Points.Add(new BezierKnot(new PointF(190, 210), true));
                newShape.Points.Add(new BezierKnot(new PointF(190, 175), true));
                vectorPath.Shapes.Add(newShape);

                // update path data in layer
                VectorDataProvider.UpdateLayerFromVectorPath(psdImage.Layers[1], vectorPath, true);


                // creating VectorPath object for new layer.
                FillLayer layer2 = FillLayer.CreateInstance(Aspose.PSD.FileFormats.Psd.Layers.FillSettings.FillType.Color);
                layer2.DisplayName = "Layer 2";
                psdImage.AddLayer(layer2);
                VectorPath vectorPath2 = VectorDataProvider.CreateVectorPathForLayer(layer2);

                // Set the fill color of vector path
                vectorPath2.FillColor = Color.IndianRed;

                // add new shape
                PathShape newShape2 = new PathShape();
                newShape2.Points.Add(new BezierKnot(new PointF(50, 150), true));
                newShape2.Points.Add(new BezierKezierKnot(new PointF(100, 200), true));
                newShape2.Points.Add(new BezierKnot(new PointF(0, 200), true));
                vectorPath2.Shapes.Add(newShape2);

                // update path data in layer
                VectorDataProvider.UpdateLayerFromVectorPath(layer2, vectorPath2, true);

                psdImage.Save(outputPsd);
                psdImage.Save(outputPng, new PngOptions() { ColorType = Aspose.PSD.FileFormats.Png.PngColorType.TruecolorWithAlpha });
            }
        }
    }
    
# چگونگی ویرایش کانال‌های برداری (اینجا کلاس‌هایی برای ویرایش مسیر‌های برداری قرار دارند).

## **داده‌های کانال بردار**

|نام کلاس|توضیحات|
| :- | :- |
|BezierKnot|گره خم‌های بزرگاسر به صورت یک نقطه مبنا و دو نقطه کنترل شامل می‌شود.|

## **Action که انگلیسی به فارسی ترجمه شده‌اند**

|عنوان فارسی|عنوان انگلیسی|
| :- | :- |
|افزودنقابلیت افزودن|Add Ability to Add|

## **مثال‌های استفاده:**

**PSDNET-1000. افزودن قابلیت افزودن**

<pre><code class="language-fa" data-lang="fa">    PropertyValue propertyValue = PropertyValue.CreateInstance(PropertyType.FxidResourceParticle);
    propertyValue.Data = new byte[]{0x23, 0x45, 0x56, 0x90};</code></pre>

**PSDNET-1100. قابلیت ویرایش خصوصیات**

<pre><code class="language-fa" data-lang="fa">    PropertyValue propertyValue = PropertyValue.CreateInstance(PropertyType.FxidResourceParticle);
    propertyValue.Data = new byte[]{0x11, 0x22, 0x33, 0x44};</code></pre>

Aspose.PSD for .NET 21.11 - یادداشت‌های انتشار اسپوز.PSD برای .NET 21.9 - یادداشت‌های نسخه