ملاحظات الإصدار Aspose.PSD لـ .NET 20.11
Contents
[
Hide
]
تحتوي هذه الصفحة على ملاحظات الإصدار لـ Aspose.PSD لـ .NET 20.11
| المفتاح | الملخص | الفئة |
|---|---|---|
| PSDNET-713 | Aspose.PSD لا يمكن تحويل PSD إلى أوضاع ألوان / عمق بت أخرى دون حفظها كملفات | ميزة |
| PSDNET-754 | إضافة القدرة على نسخ طبقة الكائن الذكي في صورة PSD | ميزة |
| PSDNET-267 | استثناء عند تحميل وحفظ ملف PSD مع تأثيرات الطبقة | خلل |
| PSDNET-579 | الطريقة “Image.LoadRawData” تثير استثناء NullPointer | خلل |
| PSDNET-741 | يتم طرح استثناء ImageLoadException عند محاولة فتح الملف | خلل |
| PSDNET-744 | Aspose.PSD 20.10: لا يمكن تحميل Psd | خلل |
تغييرات الواجهة العامة للتطبيقات
أضيفت APIs:
- M:Aspose.PSD.FileFormats.Psd.PsdImage.Convert(Aspose.PSD.ImageOptions.PsdOptions)
- F:Aspose.PSD.FileFormats.Psd.ResourceBlock.ResouceBlockMeSaSignature
- M:Aspose.PSD.FileFormats.Psd.Layers.SmartObjects.SmartObjectLayer.NewSmartObjectViaCopy
- M:Aspose.PSD.FileFormats.Psd.Layers.SmartObjects.SmartObjectLayer.DuplicateLayer
- M:Aspose.PSD.FileFormats.Psd.SmartObjectProvider.NewSmartObjectViaCopy(Aspose.PSD.FileFormats.Psd.Layers.SmartObjects.SmartObjectLayer)
- M:Aspose.PSD.FileFormats.Psd.SmartObjectProvider.ConvertToSmartObject(System.Int32[])
- M:Aspose.PSD.FileFormats.Psd.SmartObjectProvider.ConvertToSmartObject(Aspose.PSD.FileFormats.Psd.Layers.Layer[])
تمت إزالة APIs:
- لا شيء
أمثلة الاستخدام:
PSDNET-267. استثناء عند تحميل وحفظ ملف PSD مع تأثيرات الطبقة
string dataDir = "PSDNET267_1\\";
string inputFilePath = dataDir + "LayerEffectsTest.psd";
string outputFilePath = dataDir + "LayerEffectsTestOutput.psd";
using (var image = (PsdImage)Image.Load(inputFilePath, new PsdLoadOptions() { LoadEffectsResource = true }))
{
image.Save(outputFilePath, new PsdOptions(image));
}
string dataDir = "PSDNET579_1\\";
string srcFile = dataDir + "CmykWithAlpha_raw.psd";
using (RasterImage image = (RasterImage)Image.Load(srcFile))
{
Rectangle rect = image.Bounds;
RawDataRetriever rawDataRetriever = new RawDataRetriever(rect, image.RawDataSettings);
image.LoadRawData(rect, image.RawDataSettings, rawDataRetriever);
rawDataRetriever.GetData();
}
class RawDataRetriever : Aspose.PSD.IPartialRawDataLoader
{
private readonly byte[] rawData;
private int rawDataIndex;
public RawDataRetriever(Rectangle rectangle, RawDataSettings rawDataSettings)
{
int totalSize = rawDataSettings.LineSize * rectangle.Height;
if (totalSize == 0)
{
totalSize = rectangle.Width * rectangle.Height * 5;
}
this.rawData = new byte[totalSize];
}
public byte[] GetData()
{
return this.rawData;
}
public void Process(Rectangle rectangle, byte[] data, Point start, Point end)
{
Array.Copy(data, 0, this.rawData, this.rawDataIndex, data.Length);
this.rawDataIndex += data.Length;
}
public void Process(Rectangle rectangle, byte[] data, Point start, Point end, LoadOptions loadOptions)
{
throw new NotImplementedException();
}
}
string dataDir = "PSDNET713_1\\";
string outputDir = dataDir + "output\\";
// توضح هذه الأمثلة تحويل تنسيق الصورة PSD إلى أوضاع ألوان/عمق بت أخرى.
ImageConversion(ColorModes.Grayscale, 16, 2);
ImageConversion(ColorModes.Grayscale, 8, 2);
ImageConversion(ColorModes.Grayscale, 8, 1);
ImageConversion(ColorModes.Rgb, 8, 4);
ImageConversion(ColorModes.Rgb, 16, 4);
ImageConversion(ColorModes.Cmyk, 8, 5);
ImageConversion(ColorModes.Cmyk, 16, 5);
void ImageConversion(ColorModes colorMode, short channelBitsCount, short channelsCount)
{
var compression = channelBitsCount > 8 ? CompressionMethod.Raw : CompressionMethod.RLE;
SaveToPsdThenLoadAndSaveToPng(
"SheetColorHighlightExample",
colorMode,
channelBitsCount,
channelsCount,
compression,
1);
SaveToPsdThenLoadAndSaveToPng(
"FillOpacitySample",
colorMode,
channelBitsCount,
channelsCount,
compression,
2);
SaveToPsdThenLoadAndSaveToPng(
"ClippingMaskRegular",
colorMode,
channelBitsCount,
channelsCount,
compression,
3);
}
// يحفظ إلى PSD ثم يحمل الصورة المحفوظة ويحفظها إلى PNG.
void SaveToPsdThenLoadAndSaveToPng(
string file,
ColorModes colorMode,
short channelBitsCount,
short channelsCount,
CompressionMethod compression,
int layerNumber)
{
string srcFile = dataDir + file + ".psd";
string postfix = colorMode.ToString() + channelBitsCount + "bits" + channelsCount + "channels" +
compression;
string fileName = file + "_" + postfix + ".psd";
string exportPath = outputDir + fileName;
PsdOptions psdOptions = new PsdOptions()
{
ColorMode = colorMode,
ChannelBitsCount = channelBitsCount,
ChannelsCount = channelsCount,
CompressionMethod = compression
};
using (var image = (PsdImage)Image.Load(srcFile))
{
image.Convert(psdOptions);
RasterCachedImage raster = image.Layers.Length > 0 && layerNumber >= 0
? (RasterCachedImage)image.Layers[layerNumber]
: image;
Aspose.PSD.Graphics graphics = new Graphics(raster);
int width = raster.Width;
int height = raster.Height;
Rectangle rect = new Rectangle(
width / 3,
height / 3,
width - (2 * (width / 3)) - 1,
height - (2 * (height / 3)) - 1);
graphics.DrawRectangle(new Aspose.PSD.Pen(Color.DarkGray, 1), rect);
image.Save(exportPath);
}
string pngExportPath = Path.ChangeExtension(exportPath, "png");
using (PsdImage image = (PsdImage)Image.Load(exportPath))
{
image.Save(pngExportPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
}
}
string dataDir = "PSDNET741_1\\";
string inputFile = dataDir + "input.psd";
string outputFile = dataDir + "output.psd";
using (var psdImage = (PsdImage)Image.Load(inputFile))
{
psdImage.Save(outputFile, new PsdOptions(psdImage));
}
using (var psdImage2 = (PsdImage)Image.Load(outputFile))
{
// لا يوجد استثناء هنا...
}
void AreEqual(object expected, object actual)
{
if (!object.Equals(expected, actual))
{
throw new Exception("القيم غير متساوية.");
}
}
string srcFile = "GST-CHALLAN(2)1..psd";
string output = "output.psd";
using (PsdImage psdImage = (PsdImage)Image.Load(srcFile))
{
AreEqual(ResourceBlock.ResouceBlockMeSaSignature, psdImage.ImageResources[23].Signature);
AreEqual(ResourceBlock.ResouceBlockMeSaSignature, psdImage.ImageResources[24].Signature);
psdImage.Save(output);
}
string dataDir = "PSDNET754_1\\";
string outputDir = dataDir + "output\\";
// توضح هذه الأمثلة كيفية نسخ طبقات الكائن الذكي في صورة PSD.
ExampleOfCopingSmartObjectLayer("r-embedded-psd");
ExampleOfCopingSmartObjectLayer("r-embedded-png");
ExampleOfCopingSmartObjectLayer("r-embedded-transform");
ExampleOfCopingSmartObjectLayer("new_panama-papers-8-trans4");
void ExampleOfCopingSmartObjectLayer(string fileName)
{
int layerNumber = 0; // رقم الطبقة المراد نسخها
string filePath = dataDir + fileName + ".psd";
string outputFilePath = outputDir + fileName + "_copy_" + layerNumber;
string pngOutputPath = outputFilePath + ".png";
string psdOutputPath = outputFilePath + ".psd";
using (PsdImage image = (PsdImage)Image.Load(filePath))
{
var smartObjectLayer = (SmartObjectLayer)image.Layers[layerNumber];
var newLayer = smartObjectLayer.NewSmartObjectViaCopy();
newLayer.IsVisible = false;
AssertIsTrue(object.ReferenceEquals(newLayer, image.Layers[layerNumber + 1]));
AssertIsTrue(object.ReferenceEquals(smartObjectLayer, image.Layers[layerNumber]));
var duplicatedLayer = smartObjectLayer.DuplicateLayer();
duplicatedLayer.DisplayName = smartObjectLayer.DisplayName + " shared image";
AssertIsTrue(object.ReferenceEquals(newLayer, image.Layers[layerNumber + 2]));
AssertIsTrue(object.ReferenceEquals(duplicatedLayer, image.Layers[layerNumber + 1]));
AssertIsTrue(object.ReferenceEquals(smartObjectLayer, image.Layers[layerNumber]));
using (var innerImage = (RasterImage)smartObjectLayer.LoadContents(null))
{
// دعنا نقلب صورة الكائن الذكي المضمنة (بالنسبة لصورة PSD داخلية نقلب فقط طبقتها الأولى)
InvertImage(innerImage);
// دعنا نستبدل الصورة في الطبقة PSD المضمنة
smartObjectLayer.ReplaceContents(innerImage);
}
// تشترك الطبقة المكررة في صورتها المضمنة مع الكائن الذكي الأصلي
// ويجب تحديثها صراحة أو تظل ذاكرة التخزين المؤقت غير متغيرة.
// نقوم بتحديث كل كائن ذكي للتأكد من أن الطبقة الجديدة التي تم إنشاؤها بواسطة NewSmartObjectViaCopy
// لا تشترك في الصورة المضمنة مع الآخرين
image.SmartObjectProvider.UpdateAllModifiedContent();
image.Save(pngOutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
image.Save(psdOutputPath, new PsdOptions(image));
}
}
// يقوم بعكس صورة القطعة بما في ذلك صورة PSD.
void InvertImage(RasterImage innerImage)
{
var innerPsdImage = innerImage as PsdImage;
if (innerPsdImage != null)
{
InvertRasterImage(innerPsdImage.Layers[0]);
}
else
{
InvertRasterImage(innerImage);
}
}
// يعكس صورة القطعة.
void InvertRasterImage(RasterImage innerImage)
{
var pixels = innerImage.LoadArgb32Pixels(innerImage.Bounds);
for (int i = 0; i < pixels.Length; i++)
{
var pixel = pixels[i];
var alpha = (int)(pixel & 0xff000000);
pixels[i] = (~(pixel & 0x00ffffff)) | alpha;
}
innerImage.SaveArgb32Pixels(innerImage.Bounds, pixels);
}
void AssertIsTrue(bool condition)
{
if (!condition)
{
throw new FormatException(string.Format("متوقع صحيح"));
}
}