PsdOptions

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.ImageOptionsBase

public class PsdOptions extends ImageOptionsBase

إنشاء صور Photoshop Document (PSD) باستخدام واجهة برمجة التطبيقات الخاصة بنا، مع خيارات متعددة تشمل إصدارات تنسيق مختلفة، وأساليب ضغط، وأنماط ألوان، وعدد البتات لكل قناة لون. التعامل بسلاسة مع حاويات بيانات XMP، مما يضمن معالجة شاملة للصور باستخدام ميزات تنسيق PSD مثل طبقات الصورة، أقنعة الطبقة، ومعلومات الملف لتخصيص وإبداع تصاميمك.

المنشئات

المنشئ	الوصف
PsdOptions()	ينشئ مثيلاً جديداً من الفئة PsdOptions.
PsdOptions(PsdOptions options)	ينشئ مثيلاً جديداً من الفئة PsdOptions.

الطرق

طريقة	الوصف
setXmpData(XmpPacketWrapper value)	احصل أو اضبط حاوية بيانات XMP
getVersion()	يحصل أو يضبط إصدار ملف PSD.
setVersion(int value)	يحصل أو يضبط إصدار ملف PSD.
getCompressionMethod()	يحصل أو يضبط طريقة ضغط PSD.
setCompressionMethod(short value)	يحصل أو يضبط طريقة ضغط PSD.
getPsdVersion()	يحصل على إصدار تنسيق الملف.
setPsdVersion(byte value)	يضبط إصدار تنسيق الملف.
getColorMode()	يحصل أو يضبط وضع لون PSD.
setColorMode(short value)	يحصل أو يضبط وضع لون PSD.
getChannelBitsCount()	يحصل أو يضبط عدد البتات لكل قناة لون.
setChannelBitsCount(short value)	يحصل أو يضبط عدد البتات لكل قناة لون.
getChannelsCount()	يحصل على عدد قنوات اللون.
setChannelsCount(short value)	يضبط عدد قنوات اللون.
isRemoveGlobalTextEngineResource()	يحصل على قيمة تشير إلى ما إذا كان - إزالة مورد محرك النص العالمي - يُستخدم لبعض ملفات PSD ذات الطبقات النصية، في الحالة الوحيدة التي لا يمكن فتحها في Adobe Photoshop بعد المعالجة (غالبًا ما يتعلق بطبقات النص التي تفتقر إلى الخطوط).
setRemoveGlobalTextEngineResource(boolean value)	يضبط قيمة تشير إلى ما إذا كان - إزالة مورد محرك النص العالمي - يُستخدم لبعض ملفات PSD ذات الطبقات النصية، في الحالة الوحيدة التي لا يمكن فتحها في Adobe Photoshop بعد المعالجة (غالبًا ما يتعلق بطبقات النص التي تفتقر إلى الخطوط).
isRefreshImagePreviewData()	يحصل على قيمة تشير إلى ما إذا كان [refresh image preview data] - خيار يُستخدم لتعزيز التوافق مع عارضات صور PSD أخرى.
setRefreshImagePreviewData(boolean value)	يضبط قيمة تشير إلى ما إذا كان [refresh image preview data] - خيار يُستخدم لتعزيز التوافق مع عارضات صور PSD أخرى.
getVectorizationOptions()	يحصل على خيارات تحويل PSD إلى متجهات.
setVectorizationOptions(PsdVectorizationOptions value)	يضبط خيارات تحويل PSD إلى متجهات.

Example: This example demonstrates the use of Aspose.

يوضح هذا المثال استخدام Aspose.Imaging for Java API لتحويل الصور إلى صيغة PSD. لتحقيق هذا الهدف، يقوم هذا المثال بتحميل صورة موجودة ثم حفظها مرة أخرى بصيغة PSD.

// أنشئ مثيلاً من فئة الصورة وقم بتهيئته بملف موجود عبر مسار الملف.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load("C:\\temp\\sample.bmp");
try {
    // أنشئ مثيلاً من فئة PsdOptions.
    com.aspose.imaging.imageoptions.PsdOptions psdOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عيّن CompressionMethod كـ RLE.
    // ملاحظة: طريقة الضغط المدعومة الأخرى هي CompressionMethod.RAW [بدون ضغط].
    psdOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

    // عيّن ColorMode إلى GrayScale.
    // ملاحظة: أوضاع اللون المدعومة الأخرى هي ColorModes.Bitmap و ColorModes.RGB.
    psdOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Grayscale);

    // احفظ الصورة إلى القرص باستخدام إعدادات PsdOptions المقدمة.
    image.save("C:\\temp\\output.psd", psdOptions);
} finally {
    image.dispose();
}

Example: The following example shows how to convert a multipage vector image to PSD format in general way without referencing to a particular image type.

String dir = "C:\\aspose.imaging\\net\\misc\\ImagingReleaseQATester\\Tests\\testdata\\2548\\";
String inputFilePath = dir + "Multipage.cdr";
String outputFilePath = dir + "Multipage.cdr.psd";

com.aspose.imaging.ImageOptionsBase exportOptions = new com.aspose.imaging.imageoptions.PsdOptions();

try (com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFilePath))
{
    exportOptions.setMultiPageOptions(null);

    // صدّر الصفحتين الأوليتين فقط. سيتم تقديم هاتين الصفحتين كطبقات في ملف PSD الناتج.
    com.aspose.imaging.IMultipageImage multipageImage = (image instanceof com.aspose.imaging.IMultipageImage) ? (com.aspose.imaging.IMultipageImage)image : null;
    if (multipageImage != null && (multipageImage.getPages() != null && multipageImage.getPageCount() > 2))
    {
        exportOptions.setMultiPageOptions(new com.aspose.imaging.imageoptions.MultiPageOptions(new com.aspose.imaging.IntRange(0, 2)));
    }

    if (image instanceof com.aspose.imaging.VectorImage)
    {
        com.aspose.imaging.imageoptions.VectorRasterizationOptions defaultOptions = (com.aspose.imaging.imageoptions.VectorRasterizationOptions) image.getDefaultOptions(new Object[]{Color.getWhite(), image.getWidth(), image.getHeight()});
        exportOptions.setVectorRasterizationOptions(defaultOptions);
        defaultOptions.setTextRenderingHint(com.aspose.imaging.TextRenderingHint.SingleBitPerPixel);
        defaultOptions.setSmoothingMode(com.aspose.imaging.SmoothingMode.None);
    }

    image.save(outputFilePath, exportOptions);
}

PsdOptions()

public PsdOptions()

ينشئ مثيلاً جديداً من الفئة PsdOptions.

PsdOptions(PsdOptions options)

public PsdOptions(PsdOptions options)

ينشئ مثيلاً جديداً من الفئة PsdOptions.

Parameters:

معامل	نوع	الوصف
options	PsdOptions	الخيارات.

setXmpData(XmpPacketWrapper value)

public void setXmpData(XmpPacketWrapper value)

احصل أو اضبط حاوية بيانات XMP

Parameters:

معامل	نوع	الوصف
value	XmpPacketWrapper

getVersion()

public int getVersion()

يحصل أو يضبط إصدار ملف PSD.

القيمة: إصدار ملف PSD.

Returns: int

setVersion(int value)

public void setVersion(int value)

يحصل أو يضبط إصدار ملف PSD.

القيمة: إصدار ملف PSD.

Parameters:

معامل	نوع	الوصف
value	int

Example: This example shows how to save a PNG image to PSD format using various PSD-specific options.

String dir = "c:\\temp\\";

// أنشئ صورة PNG بحجم 100×100 بكسل.
com.aspose.imaging.fileformats.png.PngImage pngImage = new com.aspose.imaging.fileformats.png.PngImage(100, 100, com.aspose.imaging.fileformats.png.PngColorType.TruecolorWithAlpha);
try {
    // عرّف تدرجًا خطيًا أزرقًا شفافًا.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(pngImage.getWidth(), pngImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getTransparent());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(pngImage);

    // املأ صورة PNG بالتدرج الخطّي الأزرق الشفاف.
    graphics.fillRectangle(gradientBrush, pngImage.getBounds());

    // سيتم استخدام الخيارات التالية لحفظ صورة PNG بصيغة PSD.
    com.aspose.imaging.imageoptions.PsdOptions saveOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عدد البتات لكل قناة.
    saveOptions.setChannelBitsCount((byte) 8);

    // عدد القنوات. قناة واحدة لكل مكوّن لوني R,G,B,A
    saveOptions.setChannelsCount((short) 4);

    // وضع اللون
    saveOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Rgb);

    // بدون ضغط
    saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.Raw);

    // الإصدار الافتراضي هو 6
    saveOptions.setVersion(6);

    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "saveoptions.psd");
    try {
        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RAW compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    stream = new java.io.FileOutputStream(dir + "saveoptions.RLE.psd");
    try {
        // ضغط RLE يسمح بتقليل حجم الصورة الناتجة
        saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RLE compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    // قد يبدو الإخراج هكذا:
    // حجم صورة PSD مع ضغط RAW: 40090
    // حجم صورة PSD مع ضغط RLE: 16185
} finally {
    pngImage.dispose();
}

getCompressionMethod()

public short getCompressionMethod()

يحصل أو يضبط طريقة ضغط PSD.

القيمة: طريقة الضغط.

Returns: قصير

setCompressionMethod(short value)

public void setCompressionMethod(short value)

يحصل أو يضبط طريقة ضغط PSD.

القيمة: طريقة الضغط.

Parameters:

معامل	نوع	الوصف
value	قصير

Example: This example demonstrates the use of Aspose. يوضح هذا المثال استخدام Aspose.Imaging for Java API لتحويل الصور إلى صيغة PSD. لتحقيق هذا الهدف، يقوم هذا المثال بتحميل صورة موجودة ثم حفظها مرة أخرى بصيغة PSD.

// أنشئ مثيلاً من فئة الصورة وقم بتهيئته بملف موجود عبر مسار الملف.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load("C:\\temp\\sample.bmp");
try {
    // أنشئ مثيلاً من فئة PsdOptions.
    com.aspose.imaging.imageoptions.PsdOptions psdOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عيّن CompressionMethod كـ RLE.
    // ملاحظة: طريقة الضغط المدعومة الأخرى هي CompressionMethod.RAW [بدون ضغط].
    psdOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

    // عيّن ColorMode إلى GrayScale.
    // ملاحظة: أوضاع اللون المدعومة الأخرى هي ColorModes.Bitmap و ColorModes.RGB.
    psdOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Grayscale);

    // احفظ الصورة إلى القرص باستخدام إعدادات PsdOptions المقدمة.
    image.save("C:\\temp\\output.psd", psdOptions);
} finally {
    image.dispose();
}

getPsdVersion()

public final byte getPsdVersion()

يحصل على إصدار تنسيق الملف. يمكن أن يكون PSD أو PSB.

القيمة: إصدار تنسيق الملف.

Returns: byte - إصدار تنسيق الملف.

setPsdVersion(byte value)

public final void setPsdVersion(byte value)

يضبط إصدار تنسيق الملف. يمكن أن يكون PSD أو PSB.

القيمة: إصدار تنسيق الملف.

Parameters:

معامل	نوع	الوصف
value	byte	إصدار تنسيق الملف.

getColorMode()

public short getColorMode()

يحصل أو يضبط وضع لون PSD.

القيمة: وضع اللون.

Returns: قصير

setColorMode(short value)

public void setColorMode(short value)

يحصل أو يضبط وضع لون PSD.

القيمة: وضع اللون.

Parameters:

معامل	نوع	الوصف
value	قصير

Example: This example demonstrates the use of Aspose. يوضح هذا المثال استخدام Aspose.Imaging for Java API لتحويل الصور إلى صيغة PSD. لتحقيق هذا الهدف، يقوم هذا المثال بتحميل صورة موجودة ثم حفظها مرة أخرى بصيغة PSD.

// أنشئ مثيلاً من فئة الصورة وقم بتهيئته بملف موجود عبر مسار الملف.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load("C:\\temp\\sample.bmp");
try {
    // أنشئ مثيلاً من فئة PsdOptions.
    com.aspose.imaging.imageoptions.PsdOptions psdOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عيّن CompressionMethod كـ RLE.
    // ملاحظة: طريقة الضغط المدعومة الأخرى هي CompressionMethod.RAW [بدون ضغط].
    psdOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

    // عيّن ColorMode إلى GrayScale.
    // ملاحظة: أوضاع اللون المدعومة الأخرى هي ColorModes.Bitmap و ColorModes.RGB.
    psdOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Grayscale);

    // احفظ الصورة إلى القرص باستخدام إعدادات PsdOptions المقدمة.
    image.save("C:\\temp\\output.psd", psdOptions);
} finally {
    image.dispose();
}

getChannelBitsCount()

public short getChannelBitsCount()

يحصل أو يضبط عدد البتات لكل قناة لون.

القيمة: عدد البتات لكل قناة لون.

Returns: قصير

setChannelBitsCount(short value)

public void setChannelBitsCount(short value)

يحصل أو يضبط عدد البتات لكل قناة لون.

القيمة: عدد البتات لكل قناة لون.

Parameters:

معامل	نوع	الوصف
value	قصير

Example: This example shows how to save a PNG image to PSD format using various PSD-specific options.

String dir = "c:\\temp\\";

// أنشئ صورة PNG بحجم 100×100 بكسل.
com.aspose.imaging.fileformats.png.PngImage pngImage = new com.aspose.imaging.fileformats.png.PngImage(100, 100, com.aspose.imaging.fileformats.png.PngColorType.TruecolorWithAlpha);
try {
    // عرّف تدرجًا خطيًا أزرقًا شفافًا.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(pngImage.getWidth(), pngImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getTransparent());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(pngImage);

    // املأ صورة PNG بالتدرج الخطّي الأزرق الشفاف.
    graphics.fillRectangle(gradientBrush, pngImage.getBounds());

    // سيتم استخدام الخيارات التالية لحفظ صورة PNG بصيغة PSD.
    com.aspose.imaging.imageoptions.PsdOptions saveOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عدد البتات لكل قناة.
    saveOptions.setChannelBitsCount((byte) 8);

    // عدد القنوات. قناة واحدة لكل مكوّن لوني R,G,B,A
    saveOptions.setChannelsCount((short) 4);

    // وضع اللون
    saveOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Rgb);

    // بدون ضغط
    saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.Raw);

    // الإصدار الافتراضي هو 6
    saveOptions.setVersion(6);

    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "saveoptions.psd");
    try {
        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RAW compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    stream = new java.io.FileOutputStream(dir + "saveoptions.RLE.psd");
    try {
        // ضغط RLE يسمح بتقليل حجم الصورة الناتجة
        saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RLE compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    // قد يبدو الإخراج هكذا:
    // حجم صورة PSD مع ضغط RAW: 40090
    // حجم صورة PSD مع ضغط RLE: 16185
} finally {
    pngImage.dispose();
}

getChannelsCount()

public short getChannelsCount()

يحصل على عدد قنوات اللون.

Returns: short - عدد قنوات اللون.

setChannelsCount(short value)

public void setChannelsCount(short value)

يضبط عدد قنوات اللون.

Parameters:

معامل	نوع	الوصف
value	قصير	عدد قنوات اللون.

Example: This example shows how to save a PNG image to PSD format using various PSD-specific options.

String dir = "c:\\temp\\";

// أنشئ صورة PNG بحجم 100×100 بكسل.
com.aspose.imaging.fileformats.png.PngImage pngImage = new com.aspose.imaging.fileformats.png.PngImage(100, 100, com.aspose.imaging.fileformats.png.PngColorType.TruecolorWithAlpha);
try {
    // عرّف تدرجًا خطيًا أزرقًا شفافًا.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(pngImage.getWidth(), pngImage.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getTransparent());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(pngImage);

    // املأ صورة PNG بالتدرج الخطّي الأزرق الشفاف.
    graphics.fillRectangle(gradientBrush, pngImage.getBounds());

    // سيتم استخدام الخيارات التالية لحفظ صورة PNG بصيغة PSD.
    com.aspose.imaging.imageoptions.PsdOptions saveOptions = new com.aspose.imaging.imageoptions.PsdOptions();

    // عدد البتات لكل قناة.
    saveOptions.setChannelBitsCount((byte) 8);

    // عدد القنوات. قناة واحدة لكل مكوّن لوني R,G,B,A
    saveOptions.setChannelsCount((short) 4);

    // وضع اللون
    saveOptions.setColorMode(com.aspose.imaging.fileformats.psd.ColorModes.Rgb);

    // بدون ضغط
    saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.Raw);

    // الإصدار الافتراضي هو 6
    saveOptions.setVersion(6);

    java.io.FileOutputStream stream = new java.io.FileOutputStream(dir + "saveoptions.psd");
    try {
        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RAW compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    stream = new java.io.FileOutputStream(dir + "saveoptions.RLE.psd");
    try {
        // ضغط RLE يسمح بتقليل حجم الصورة الناتجة
        saveOptions.setCompressionMethod(com.aspose.imaging.fileformats.psd.CompressionMethod.RLE);

        pngImage.save(stream, saveOptions);
        System.out.println("The size of the PSD image with RLE compression: " + stream.getChannel().size());
    } finally {
        stream.close();
    }

    // قد يبدو الإخراج هكذا:
    // حجم صورة PSD مع ضغط RAW: 40090
    // حجم صورة PSD مع ضغط RLE: 16185
} finally {
    pngImage.dispose();
}

isRemoveGlobalTextEngineResource()

public boolean isRemoveGlobalTextEngineResource()

يحصل على قيمة تشير إلى ما إذا كان - إزالة مورد محرك النص العالمي - يُستخدم لبعض ملفات PSD ذات الطبقات النصية، في الحالة الوحيدة التي لا يمكن فتحها في Adobe Photoshop بعد المعالجة (غالبًا ما يتعلق بطبقات النص التي تفتقد الخطوط). بعد استخدام هذا الخيار، يحتاج المستخدم إلى القيام بما يلي في الملف المفتوح في Photoshop: القائمة “Text” -> “Process absent fonts”. بعد هذه العملية سيظهر جميع النص مرة أخرى. يرجى ملاحظة أن هذه العملية قد تسبب بعض تغييرات التخطيط النهائية.

Returns: boolean - true إذا [remove global text engine resource]؛ وإلا false.

setRemoveGlobalTextEngineResource(boolean value)

public void setRemoveGlobalTextEngineResource(boolean value)

يضبط قيمة تشير إلى ما إذا كان - إزالة مورد محرك النص العالمي - يُستخدم لبعض ملفات PSD ذات الطبقات النصية، في الحالة الوحيدة التي لا يمكن فتحها في Adobe Photoshop بعد المعالجة (غالبًا ما يتعلق بطبقات النص التي تفتقد الخطوط). بعد استخدام هذا الخيار، يحتاج المستخدم إلى القيام بما يلي في الملف المفتوح في Photoshop: القائمة “Text” -> “Process absent fonts”. بعد هذه العملية سيظهر جميع النص مرة أخرى. يرجى ملاحظة أن هذه العملية قد تسبب بعض تغييرات التخطيط النهائية.

Parameters:

معامل	نوع	الوصف
value	boolean	true إذا [remove global text engine resource]؛ وإلا false.

isRefreshImagePreviewData()

public boolean isRefreshImagePreviewData()

يحصل على قيمة تشير إلى ما إذا كان [refresh image preview data] - خيار يُستخدم لتعزيز التوافق مع عارضات صور PSD أخرى.

Returns: boolean - true إذا [refresh image preview data]؛ وإلا false.

setRefreshImagePreviewData(boolean value)

public void setRefreshImagePreviewData(boolean value)

يضبط قيمة تشير إلى ما إذا كان [refresh image preview data] - خيار يُستخدم لتعزيز التوافق مع عارضات صور PSD أخرى.

Parameters:

معامل	نوع	الوصف
value	boolean	true إذا [refresh image preview data]؛ وإلا false.

getVectorizationOptions()

public final PsdVectorizationOptions getVectorizationOptions()

يحصل على خيارات تحويل PSD إلى متجهات.

Returns: PsdVectorizationOptions - the PSD vectorization options.

setVectorizationOptions(PsdVectorizationOptions value)

public final void setVectorizationOptions(PsdVectorizationOptions value)

يضبط خيارات تحويل PSD إلى متجهات.

Parameters:

معامل	نوع	الوصف
value	PsdVectorizationOptions	خيارات تحويل PSD إلى متجهات.