ImageOptionsBase

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

All Implemented Interfaces: com.aspose.imaging.IMetadataContainer

public abstract class ImageOptionsBase extends DisposableObject implements IMetadataContainer

خيارات الأساس للصورة.

الطرق

طريقة	الوصف
isKeepMetadata()	يحصل على قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.
setKeepMetadata(boolean value)	قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.
getXmpData()	يحصل على حاوية بيانات تعريف XMP.
setXmpData(XmpPacketWrapper value)	يضبط حاوية بيانات تعريف XMP.
getExifData()	يحصل على بيانات Exif.
setExifData(ExifData value)	يضبط بيانات Exif.
getSource()	يحصل على المصدر لإنشاء الصورة فيه.
setSource(Source value)	يحصل أو يضبط المصدر لإنشاء الصورة فيه.
getPalette()	يحصل على لوحة الألوان.
setPalette(IColorPalette value)	يضبط لوحة الألوان.
getResolutionSettings()	يحصل على إعدادات الدقة.
setResolutionSettings(ResolutionSetting value)	يضبط إعدادات الدقة.
getVectorRasterizationOptions()	يحصل على خيارات تحويل المتجه إلى نقطية.
setVectorRasterizationOptions(VectorRasterizationOptions value)	يضبط خيارات تحويل المتجه إلى نقطية.
getBufferSizeHint()	يحصل على تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن المؤقتة الداخلية.
setBufferSizeHint(int value)	يضبط تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن المؤقتة الداخلية.
getMultiPageOptions()	خيارات الصفحات المتعددة
setMultiPageOptions(MultiPageOptions value)	خيارات الصفحات المتعددة
getFullFrame()	يحصل على قيمة تشير إلى ما إذا كان [full frame].
setFullFrame(boolean value)	يضبط قيمة تشير إلى ما إذا كان [full frame].
getProgressEventHandler()	يحصل على معالج حدث التقدم.
setProgressEventHandler(ProgressEventHandler value)	يضبط معالج حدث التقدم.
deepClone()	ينسخ هذه النسخة.
trySetMetadata(IImageMetadataFormat metadata)	يحاول تعيين كائن `metadata`، إذا كان كائن Image هذا يدعم ويطبق كائن IImageMetadataFormat.

isKeepMetadata()

public final boolean isKeepMetadata()

يحصل على قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.

Returns: منطقي - قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.

setKeepMetadata(boolean value)

public final void setKeepMetadata(boolean value)

قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.

Parameters:

معامل	نوع	الوصف
value	boolean	قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.

getXmpData()

public XmpPacketWrapper getXmpData()

يحصل على حاوية بيانات تعريف XMP.

القيمة: حاوية بيانات XMP.

Returns: XmpPacketWrapper - the XMP metadata container.

setXmpData(XmpPacketWrapper value)

public void setXmpData(XmpPacketWrapper value)

يضبط حاوية بيانات تعريف XMP.

القيمة: حاوية بيانات XMP.

Parameters:

معامل	نوع	الوصف
value	XmpPacketWrapper	حاوية بيانات تعريف XMP.

getExifData()

public ExifData getExifData()

يحصل على بيانات Exif.

Returns: ExifData - the Exif data.

setExifData(ExifData value)

public void setExifData(ExifData value)

يضبط بيانات Exif.

Parameters:

معامل	نوع	الوصف
value	ExifData	بيانات Exif.

getSource()

public Source getSource()

يحصل على المصدر لإنشاء الصورة فيه.

Returns: Source - The source to create image in.

setSource(Source value)

public void setSource(Source value)

يحصل أو يضبط المصدر لإنشاء الصورة فيه.

Parameters:

معامل	نوع	الوصف
value	Source	المصدر لإنشاء الصورة فيه.

getPalette()

public IColorPalette getPalette()

يحصل على لوحة الألوان.

Returns: IColorPalette - The color palette.

setPalette(IColorPalette value)

public void setPalette(IColorPalette value)

يضبط لوحة الألوان.

Parameters:

معامل	نوع	الوصف
value	IColorPalette	لوحة الألوان.

Example: The following example shows how to palletize a BMP image to reduce its output size.


// إنشاء صورة BMP بحجم 100 × 100 بكسل.
com.aspose.imaging.fileformats.bmp.BmpImage bmpImage = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // التدرج الخطي من الزاوية اليسرى العليا إلى الزاوية اليمنى السفلى للصورة.
    com.aspose.imaging.brushes.LinearGradientBrush brush =
            new com.aspose.imaging.brushes.LinearGradientBrush(
                    new com.aspose.imaging.Point(0, 0),
                    new com.aspose.imaging.Point(bmpImage.getWidth(), bmpImage.getHeight()),
                    com.aspose.imaging.Color.getRed(),
                    com.aspose.imaging.Color.getGreen());

    // ملء الصورة بالكامل بفرشاة التدرج الخطي.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(bmpImage);
    gr.fillRectangle(brush, bmpImage.getBounds());

    // احصل على أقرب لوحة ألوان 8‑بت تغطي أكبر عدد ممكن من البكسلات، بحيث تكون الصورة مُلوَّنة بلوحة ألوان.
    // يكاد يكون غير قابل للتمييز بصريًا عن نسخة غير ملوّنة.
    com.aspose.imaging.IColorPalette palette = com.aspose.imaging.ColorPaletteHelper.getCloseImagePalette(bmpImage, 256);

    // تحتوي لوحة الألوان 8-bit على ما لا يزيد عن 256 لونًا.
    com.aspose.imaging.imageoptions.BmpOptions saveOptions = new com.aspose.imaging.imageoptions.BmpOptions();
    saveOptions.setPalette(palette);
    saveOptions.setBitsPerPixel(8);

    java.io.ByteArrayOutputStream stream = new java.io.ByteArrayOutputStream();
    try {
        bmpImage.save(stream, saveOptions);
        System.out.println("The palettized image size is " + stream.size() + " bytes.");
    } finally {
        stream.close();
    }

    stream = new java.io.ByteArrayOutputStream();
    try {
        bmpImage.save(stream);
        System.out.println("The non-palettized image size is " + stream.size() + " bytes.");
    } finally {
        stream.close();
    }
} finally {
    bmpImage.dispose();
}

// المخرجات تبدو هكذا:
// حجم الصورة الملونة باللوحة هو 11078 بايت.
// حجم الصورة غير الملونة باللوحة هو 40054 بايت.

getResolutionSettings()

public ResolutionSetting getResolutionSettings()

يحصل على إعدادات الدقة.

Returns: ResolutionSetting

setResolutionSettings(ResolutionSetting value)

public void setResolutionSettings(ResolutionSetting value)

يضبط إعدادات الدقة.

Parameters:

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

Example: The following example loads a BMP image and saves it to JPEG using various save options.

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

// حمّل صورة BMP من ملف.
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.bmp");
try {
    // قم ببعض معالجة الصورة.

    // استخدم خيارات إضافية لتحديد معلمات الصورة المطلوبة.
    com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();

    // عدد البتات لكل قناة هو 8.
    // عند استخدام لوحة ألوان، يتم تخزين فهرس اللون في بيانات الصورة بدلاً من اللون نفسه.
    saveOptions.setBitsPerChannel((byte) 8);

    // حدد نوع الضغط المتدرج.
    saveOptions.setCompressionType(com.aspose.imaging.fileformats.jpeg.JpegCompressionMode.Progressive);

    // حدد جودة الصورة. إنها قيمة بين 1 و 100.
    saveOptions.setQuality(100);

    // حدد الدقة الأفقية/العمودية إلى 96 نقطة في البوصة.
    saveOptions.setResolutionSettings(new com.aspose.imaging.ResolutionSetting(96.0, 96.0));
    saveOptions.setResolutionUnit(com.aspose.imaging.ResolutionUnit.Inch);

    // إذا كانت الصورة المصدر ملونة، فسيتم تحويلها إلى تدرجات الرمادي.
    saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Grayscale);

    // استخدم لوحة ألوان لتقليل حجم الإخراج.
    saveOptions.setPalette(com.aspose.imaging.ColorPaletteHelper.create8BitGrayscale(false));

    image.save(dir + "sample.palettized.jpg", saveOptions);
} finally {
    image.dispose();
}

getVectorRasterizationOptions()

public VectorRasterizationOptions getVectorRasterizationOptions()

يحصل على خيارات تحويل المتجه إلى نقطية.

Returns: VectorRasterizationOptions - The vector rasterization options.

setVectorRasterizationOptions(VectorRasterizationOptions value)

public void setVectorRasterizationOptions(VectorRasterizationOptions value)

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

Parameters:

معامل	نوع	الوصف
value	VectorRasterizationOptions	خيارات تحويل المتجه إلى نقطية.

getBufferSizeHint()

public final int getBufferSizeHint()

يحصل على تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن المؤقتة الداخلية.

القيمة: تلميح حجم المخزن المؤقت، بالميغابايت. القيمة غير الموجبة تعني عدم وجود حد للذاكرة للمخازن المؤقتة الداخلية

Returns: int - تلميح حجم المخزن المؤقت الذي يُعرف كحد أقصى مسموح به لجميع المخازن المؤقتة الداخلية.

setBufferSizeHint(int value)

public final void setBufferSizeHint(int value)

يضبط تلميح حجم المخزن المؤقت الذي يُعرف كأقصى حجم مسموح به لجميع المخازن المؤقتة الداخلية.

Parameters:

معامل	نوع	الوصف
value	int	تلميح حجم المخزن المؤقت الذي يُعرف كحد أقصى مسموح به لجميع المخازن المؤقتة الداخلية.

getMultiPageOptions()

public MultiPageOptions getMultiPageOptions()

خيارات الصفحات المتعددة

Returns: MultiPageOptions

setMultiPageOptions(MultiPageOptions value)

public void setMultiPageOptions(MultiPageOptions value)

خيارات الصفحات المتعددة

Parameters:

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

getFullFrame()

public final boolean getFullFrame()

يحصل على قيمة تشير إلى ما إذا كان [full frame].

القيمة: true إذا كان [full frame]؛ وإلا false.

Returns: منطقي - قيمة تشير إلى ما إذا كان [full frame].

setFullFrame(boolean value)

public final void setFullFrame(boolean value)

يضبط قيمة تشير إلى ما إذا كان [full frame].

القيمة: true إذا كان [full frame]؛ وإلا false.

Parameters:

معامل	نوع	الوصف
value	boolean	قيمة تشير إلى ما إذا كان [full frame].

getProgressEventHandler()

public ProgressEventHandler getProgressEventHandler()

يحصل على معالج حدث التقدم.

القيمة: معالج حدث التقدم.

Returns: ProgressEventHandler - the progress event handler.

setProgressEventHandler(ProgressEventHandler value)

public void setProgressEventHandler(ProgressEventHandler value)

يضبط معالج حدث التقدم.

القيمة: معالج حدث التقدم.

Parameters:

معامل	نوع	الوصف
value	ProgressEventHandler	معالج حدث التقدم.

Example: The following example shows how to print information about progress events for load/export operations.

String dir = "c:\\aspose.imaging\\java\\issues\\1440\\";
String fileName = dir + "big.png";

// مثال على استخدام معالجات أحداث تقدم العملية المنفصلة لعمليات التحميل/التصدير
final com.aspose.imaging.ProgressEventHandler loadHandler = new com.aspose.imaging.ProgressEventHandler() {
    @Override
    public void invoke(com.aspose.imaging.progressmanagement.ProgressEventHandlerInfo info) {
        System.out.format("Load event %s : %d/%d\n", com.aspose.imaging.progressmanagement.EventType.toString(com.aspose.imaging.progressmanagement.EventType.class, info.getEventType()), info.getValue(), info.getMaxValue());
    }
};

final com.aspose.imaging.ProgressEventHandler exportHandler = new com.aspose.imaging.ProgressEventHandler() {
    @Override
    public void invoke(com.aspose.imaging.progressmanagement.ProgressEventHandlerInfo info) {
        System.out.format("Export event %s : %d/%d\n", com.aspose.imaging.progressmanagement.EventType.toString(com.aspose.imaging.progressmanagement.EventType.class, info.getEventType()), info.getValue(), info.getMaxValue());
    }
};

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(fileName, new com.aspose.imaging.LoadOptions() {{ setProgressEventHandler(loadHandler); }} );
try {
    image.save(fileName + ".psd",
            new com.aspose.imaging.imageoptions.PsdOptions() {{ setProgressEventHandler( exportHandler); }});
}
finally {
    image.close();
}

// قد يبدو سجل STDOUT هكذا:
//        حدث التحميل التهيئة : 1/4
//        حدث التحميل ما قبل المعالجة : 2/4
//        حدث التحميل المعالجة : 3/4
//        حدث التحميل الإنهاء : 4/4
//        حدث التصدير التهيئة : 1/4
//        حدث التصدير ما قبل المعالجة : 2/4
//        حدث التصدير المعالجة : 3/4
//        حدث التصدير RelativeProgress : 1/1
//        حدث التحميل RelativeProgress : 1/1
//        حدث التصدير الإنهاء : 4/4

deepClone()

public ImageOptionsBase deepClone()

ينسخ هذه النسخة.

Returns: ImageOptionsBase - Returns shallow copy of this instance

trySetMetadata(IImageMetadataFormat metadata)

public final boolean trySetMetadata(IImageMetadataFormat metadata)

يحاول تعيين كائن metadata، إذا كان كائن Image هذا يدعم ويطبق كائن IImageMetadataFormat.

Parameters:

معامل	نوع	الوصف
metadata	IImageMetadataFormat	البيانات الوصفية.

Returns: منطقي - True، إذا كان كائن IMetadataContainer يدعم و/أو ينفّذ كائن IImageMetadataFormat؛ وإلا false.

ImageLoadersRegistry ImageResizeSettings