JpegImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.RasterImage, com.aspose.imaging.RasterCachedImage

All Implemented Interfaces: com.aspose.imaging.exif.IHasJpegExifData

public final class JpegImage extends RasterCachedImage implements IHasJpegExifData

تعديل صور JPEG النقطية بكفاءة باستخدام واجهة برمجة التطبيقات الخاصة بنا، التي تدعم ملفات تعريف ألوان متعددة مثل RGB و CMYK، وتتيح تخصيص عدد البتات لكل بكسل، ومعالجة حاويات البيانات الوصفية EXIF و JFIF و XMP. استمتع بالدوران التلقائي بناءً على بيانات الاتجاه واختر من مستويات ضغط مختلفة، بما في ذلك JPEG بدون فقد، لتحقيق توازن مثالي بين جودة الصورة وحجم الملف لمشاريعك.

المنشئات

المنشئ	الوصف
JpegImage(String path)	تبدأ فئة JpegImage بسهولة عن طريق استدعاء المُنشئ الخاص بها مع معامل المسار المحدد.
JpegImage(InputStream stream)	قم بتهيئة كائن صورة JPEG باستخدام فئة JpegImage باستخدام معامل تدفق.
JpegImage(RasterImage rasterImage)	قم بتهيئة نسخة جديدة من فئة JpegImage باستخدام معامل صورة نقطية.
JpegImage(int width, int height)	أنشئ نسخة جديدة من فئة JpegImage باستخدام معلمات العرض والارتفاع المحددة.
JpegImage(JpegOptions jpegOptions, int width, int height)	قم بتهيئة كائن JpegImage جديد باستخدام خيارات JPEG المقدمة.

الطرق

طريقة	الوصف
getFileFormat()	استرجع تنسيق الصورة بسهولة باستخدام هذه الخاصية.
getJpegOptions()	احصل على إمكانية الوصول إلى خيارات JPEG المستخدمة أثناء إنشاء أو تحميل هذا الكائن JpegImage بسهولة.
getBitsPerPixel()	استرجع عمق البكسل للصورة بسهولة باستخدام هذه الخاصية، مما يوفر رؤى حول غنى تمثيل اللون أو التدرج الرمادي.
getComment()	إدارة تعليقات ملفات JPEG باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع التعليقات الوصفية المرتبطة بالصورة.
setComment(String value)	إدارة تعليقات ملفات JPEG باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع التعليقات الوصفية المرتبطة بالصورة.
getJpegExifData()	يحصل على كائن Exif.
setJpegExifData(JpegExifData value)	إدارة بيانات EXIF باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع البيانات الوصفية المرتبطة بالصورة.
getExifData()	يحصل على بيانات Exif؛
setExifData(ExifData value)	يضبط بيانات Exif؛
getHeight()	استرجع ارتفاع الصورة بسهولة باستخدام هذه الخاصية.
getHorizontalResolution()	تمنحك هذه الخاصية إمكانية الوصول إلى الدقة الأفقية لـ RasterImage، المقاسة بالبكسل لكل بوصة.
setHorizontalResolution(double value)	تمنحك هذه الخاصية إمكانية الوصول إلى الدقة الأفقية لـ RasterImage، المقاسة بالبكسل لكل بوصة.
getJfif()	تتيح لك هذه الخاصية الوصول إلى بيانات JFIF (تنسيق تبادل ملفات JPEG) أو تعديلها المرتبطة بصورة JPEG.
setJfif(JFIFData value)	تتيح لك هذه الخاصية الوصول إلى بيانات JFIF (تنسيق تبادل ملفات JPEG) أو تعديلها المرتبطة بصورة JPEG.
getRawDataFormat()	تسترجع هذه الخاصية تنسيق البيانات الخام للصورة، والذي يوضح كيفية تنظيم وترميز بيانات الصورة.
getVerticalResolution()	تدير هذه الخاصية الدقة العمودية، المعبر عنها بالبكسل لكل بوصة، للكائن RasterImage المرتبط.
setVerticalResolution(double value)	تدير هذه الخاصية الدقة العمودية، المعبر عنها بالبكسل لكل بوصة، للكائن RasterImage المرتبط.
getWidth()	تسترجع هذه الخاصية عرض الصورة، معبرًا عنه بالبكسل.
getRgbColorProfile()	ملف تعريف اللون RGB لصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للألوان وتمثيلًا صحيحًا.
setRgbColorProfile(StreamSource value)	ملف تعريف اللون RGB لصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للألوان وتمثيلًا صحيحًا.
getCmykColorProfile()	ملف تعريف اللون CMYK المرتبط بصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للألوان وموثوقية عالية.
setCmykColorProfile(StreamSource value)	ملف تعريف اللون CMYK المرتبط بصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للألوان وموثوقية عالية.
getDestinationRgbColorProfile()	يعد RGBColorProfile ضروريًا للتحويل الدقيق للألوان في صور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ.
setDestinationRgbColorProfile(StreamSource value)	يعد RGBColorProfile ضروريًا للتحويل الدقيق للألوان في صور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ.
getDestinationCmykColorProfile()	ملف تعريف اللون CMYK ضروري للتحويل الديق للألوان في صور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ.
setDestinationCmykColorProfile(StreamSource value)	ملف تعريف اللون CMYK ضروري للتحويل الديق للألوان في صور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ.
getIgnoreEmbeddedColorProfile()	تسترجع أو تعدل العلامة التي تشير إلى ما إذا كان ملف تعريف اللون المضمّن يتم تجاهله.
setIgnoreEmbeddedColorProfile(boolean value)	تسترجع أو تعدل العلامة التي تشير إلى ما إذا كان ملف تعريف اللون المضمّن يتم تجاهله.
getOriginalOptions()	يحصل على خيارات الصورة الأصلية لهذا الكائن Image instance.
removeMetadata()	يزيل بيانات التعريف لهذا الكائن الصورة عن طريق تعيين قيم `IHasXmpData.XmpData`(IHasXmpData.getXmpData/IHasXmpData.setXmpData(XmpPacketWrapper)) و `IHasExifData.ExifData`(IHasExifData.getExifData()/IHasExifData.setExifData(ExifData)) إلى `null`.
setResolution(double dpiX, double dpiY)	يحدد الدقة لـ RasterImage المحدد، مما يضمن دقة التحجيم وقدرات الطباعة.

Example: The example shows how to load a JpegImage from a file.

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

// حمّل صورة JPEG من ملف.
com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = new com.aspose.imaging.fileformats.jpeg.JpegImage(dir + "sample.jpg");
try {
    // قم ببعض معالجة الصورة.
    // احفظ إلى ملف JPEG آخر.
    jpegImage.save(dir + "sample.output.jpg");
} finally {
    jpegImage.dispose();
}

Example: Access camera manufacturer maker notes in Jpeg image.

try (JpegImage image = (JpegImage)Image.load("Sample.jpg"))
{
    for (MakerNote makerNote : image.getExifData().getMakerNotes())
    {
        System.out.format("Name = %s, Value = %s", makerNote.getName(), makerNote.getValue());
    }
}

JpegImage(String path)

public JpegImage(String path)

تبدأ فئة JpegImage بسهولة عن طريق استدعاء المُنشئ الخاص بها مع معامل المسار المحدد. يتيح هذا المُنشئ إنشاء صور JPEG بسلاسة، مما يضمن دمجًا سريعًا في مشاريعك بسهولة.

Parameters:

معامل	نوع	الوصف
المسار	java.lang.String	المسار لتحميل الصورة منه وتهيئة بيانات البكسل واللوحة اللونية.

JpegImage(InputStream stream)

public JpegImage(InputStream stream)

ابدأ كائن صورة JPEG باستخدام فئة JpegImage مع معامل تدفق. يبسط هذا المُنشئ عملية التعامل مع صور JPEG، مقدماً نهجًا بسيطًا لدمجها في مشاريعك بسهولة.

Parameters:

معامل	نوع	الوصف
التدفق	java.io.InputStream	التدفق لتحميل الصورة منه وتهيئة بيانات البكسل واللوحة اللونية.

JpegImage(RasterImage rasterImage)

public JpegImage(RasterImage rasterImage)

قم بتهيئة نسخة جديدة من الفئة JpegImage باستخدام معامل صورة نقطية. يوفر هذا المُنشئ طريقة مريحة لإنشاء صور JPEG مباشرةً من الصور النقطية، مما يُبسّط سير العمل عند التعامل مع صور JPEG في تطبيقاتك.

Parameters:

معامل	نوع	الوصف
rasterImage	RasterImage	الصورة التي سيتم تهيئة بيانات البكسل ولوحة الألوان بها.

JpegImage(int width, int height)

public JpegImage(int width, int height)

أنشئ نسخة جديدة من الفئة JpegImage باستخدام معلمات العرض والارتفاع المحددة. يتيح لك هذا المُنشئ إنشاء صور JPEG بأبعاد مخصصة، مما يمنحك مرونة في إدارة أحجام الصور في تطبيقك.

Parameters:

معامل	نوع	الوصف
العرض	int	عرض الصورة.
الارتفاع	int	ارتفاع الصورة.

JpegImage(JpegOptions jpegOptions, int width, int height)

public JpegImage(JpegOptions jpegOptions, int width, int height)

قم بتهيئة كائن JpegImage جديد باستخدام خيارات JPEG المقدمة. يتيح لك هذا المُنشئ تخصيص إعدادات متعددة لصورة JPEG، مثل مستوى الضغط، الجودة، والمعلمات الإضافية، مما يمنحك تحكمًا دقيقًا في تنسيق الصورة الناتج.

Parameters:

معامل	نوع	الوصف
jpegOptions	JpegOptions	خيارات JPEG.
العرض	int	عرض الصورة.
الارتفاع	int	ارتفاع الصورة.

getFileFormat()

public long getFileFormat()

استرجع تنسيق الصورة بسهولة باستخدام هذه الخاصية. فهي توفر نظرة قيمة على تنسيق الملف، مما يساعد في التكامل السلس وفحوصات التوافق عبر مختلف المنصات والتطبيقات.

Returns: long

getJpegOptions()

public JpegOptions getJpegOptions()

احصل بسهولة على خيارات JPEG المستخدمة أثناء إنشاء أو تحميل هذه النسخة من JpegImage. تقدم هذه الخاصية تفاصيل قيمة حول الإعدادات المحددة المستخدمة، مما يمكّن المستخدمين من فهم وتكرار سير عمل معالجة الصور بفعالية. سواء كانت مستويات الضغط، إعدادات الجودة، أو معلمات أخرى، توفر هذه الخاصية رؤى أساسية لتعديل الصور بسلاسة.

Returns: JpegOptions - The JPEG options.

Example: The following example shows how to extract the header information from a JPEG image.

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

com.aspose.imaging.fileformats.jpeg.JpegImage image = (com.aspose.imaging.fileformats.jpeg.JpegImage) com.aspose.imaging.Image.load(dir + "original.jpg");
try {
    com.aspose.imaging.imageoptions.JpegOptions jpegOptions = image.getJpegOptions();

    System.out.println("The number of bits per channel: " + jpegOptions.getBitsPerChannel());
    System.out.println("The max allowed size for all internal buffers: " + jpegOptions.getBufferSizeHint());
    System.out.println("The color type: " + jpegOptions.getColorType());
    System.out.println("The compression type: " + jpegOptions.getCompressionType());
    System.out.println("The image quality: " + jpegOptions.getQuality());

    if (jpegOptions.getResolutionSettings() != null) {
        System.out.println("The horizontal resolution: " + jpegOptions.getResolutionSettings().getHorizontalResolution());
        System.out.println("The vertical resolution: " + jpegOptions.getResolutionSettings().getVerticalResolution());
    }

    for (int i = 0; i < jpegOptions.getHorizontalSampling().length; i++) {
        System.out.printf("The sampling for component %s: %sx%s\r\n", i, jpegOptions.getHorizontalSampling()[i], jpegOptions.getVerticalSampling()[i]);
    }
} finally {
    image.dispose();
}

//المخرجات تبدو هكذا:
//عدد البتات لكل قناة: 8
//الحد الأقصى المسموح لحجم جميع المخازن الداخلية: 0
//نوع اللون: YCbCr
//نوع الضغط: Baseline
//جودة الصورة: 75
//العينة للمكوّن 0: 1x1
//العينة للمكوّن 1: 1x1
//العينة للمكوّن 2: 1x1

getBitsPerPixel()

public int getBitsPerPixel()

استرجع عمق البكسل للصورة بسهولة باستخدام هذه الخاصية، مما يقدم رؤى حول غنى تمثيل اللون أو التدرج الرمادي. سواء كانت صورة فوتوغرافية حية أو رسمًا أحادي اللون، توفر هذه الخاصية معلومات حيوية حول تعقيد الصورة البصري.

Returns: int - عدد بتات الصورة لكل بكسل.

getComment()

public String getComment()

إدارة تعليقات ملفات JPEG باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع التعليقات الوصفية المرتبطة بالصورة. سواء كان ذلك بوضع وسوم للصور مع البيانات الوصفية أو إلحاق سياق إضافي، توفر هذه الخاصية مرونة في تنظيم وتصنيف ملفات JPEG الخاصة بك.

Returns: java.lang.String

setComment(String value)

public void setComment(String value)

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String

getJpegExifData()

public JpegExifData getJpegExifData()

يحصل على كائن Exif.

Returns: JpegExifData - Exif instance.

setJpegExifData(JpegExifData value)

public void setJpegExifData(JpegExifData value)

إدارة بيانات EXIF باستخدام هذه الخاصية، مما يتيح لك إضافة أو استرجاع البيانات الوصفية المرتبطة بالصورة. سواء كان ذلك باستخراج معلومات حول إعدادات الكاميرا أو تعديل البيانات الوصفية الموجودة، توفر هذه الخاصية مرونة في إدارة حاوية بيانات EXIF.

Parameters:

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

getExifData()

public JpegExifData getExifData()

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

Returns: JpegExifData - Exif data;

Example: The following example shows how to extract EXIF tags from a JPEG image.

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

com.aspose.imaging.fileformats.jpeg.JpegImage image = (com.aspose.imaging.fileformats.jpeg.JpegImage) com.aspose.imaging.Image.load(dir + "original.jpg");
try {
    com.aspose.imaging.exif.ExifData exifData = image.getExifData();

    System.out.println("The general EXIF data");
    System.out.println("------------------------------------------");
    if (exifData != null) {
        System.out.println("The EXIF version: " + exifData.getExifVersion());
        System.out.println("The camera serial number: " + exifData.getBodySerialNumber());
        System.out.println("The color space: " + exifData.getColorSpace());
        System.out.println("The brightness: " + exifData.getBrightnessValue());
        System.out.println("The contrast: " + exifData.getContrast());
        System.out.println("The gamma: " + exifData.getGamma());
        System.out.println("The sharpness: " + exifData.getSharpness());
        System.out.println("The aperture: " + exifData.getApertureValue());
        System.out.println("The exposure mode: " + exifData.getExposureMode());
        System.out.println("The exposure bias: " + exifData.getExposureBiasValue());
        System.out.println("The exposure time: " + exifData.getExposureTime());
        System.out.println("The focal length: " + exifData.getFocalLength());
        System.out.println("The focal plane resolution unit: " + exifData.getFocalPlaneResolutionUnit());
        System.out.println("The lens model: " + exifData.getLensModel());
        System.out.println("The shutter speed: " + exifData.getShutterSpeedValue());
    }

    System.out.println("The JPEG EXIF data");
    System.out.println("------------------------------------------");
    if (exifData instanceof com.aspose.imaging.exif.JpegExifData) {
        com.aspose.imaging.exif.JpegExifData jpegExifData = (com.aspose.imaging.exif.JpegExifData) exifData;

        System.out.println("The camera manufacturer: " + jpegExifData.getMake());
        System.out.println("The camera model: " + jpegExifData.getModel());
        System.out.println("The photometric interpretation: " + jpegExifData.getPhotometricInterpretation());
        System.out.println("The artist: " + jpegExifData.getArtist());
        System.out.println("The copyright: " + jpegExifData.getCopyright());
        System.out.println("The image description: " + jpegExifData.getImageDescription());
        System.out.println("The orientation: " + jpegExifData.getOrientation());
        System.out.println("The software: " + jpegExifData.getSoftware());
    }
} finally {
    image.dispose();
}

//المخرجات تبدو هكذا:
//بيانات EXIF العامة
//------------------------------------------
//إصدار EXIF: [B@163e4e87
//الرقم التسلسلي للكاميرا: 7100536
//مساحة اللون: SRgb
//السطوع:
//التباين: عادي
//جاما:
//الحدة: 0
//فتحة العدسة: 4.64(4643856 / 1000000)
//وضع التعرض: يدوي
//تحيز التعرض: 0.67(4 / 6)
//وقت التعرض: 0.01(1 / 160)
//البعد البؤري: 145.00(1450 / 10)
//وحدة دقة المستوى البؤري: سم
//طراز العدسة: 70.0 - 200.0 مم f/ 4.0
//سرعة الغالق: 7.32(7321928 / 1000000)
//بيانات JPEG EXIF
//------------------------------------------
//شركة صانع الكاميرا: NIKON CORPORATION
//طراز الكاميرا: NIKON D5
//التفسير الضوئي: 0
//الفنان:
//حقوق النشر:
//وصف الصورة:
//الاتجاه: TopLeft
//البرنامج: Adobe Photoshop Camera Raw 9.9(Macintosh)

setExifData(ExifData value)

public void setExifData(ExifData value)

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

Parameters:

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

getHeight()

public int getHeight()

استرجع ارتفاع الصورة بسهولة باستخدام هذه الخاصية. فهي توفر وصولًا سريعًا إلى البعد العمودي للصورة، مما يتيح لك تحديد حجمها ونسبة أبعادها بكفاءة دون الحاجة إلى حسابات معقدة أو طرق إضافية.

Returns: int - ارتفاع الصورة بالبكسل.

getHorizontalResolution()

public double getHorizontalResolution()

تمنحك هذه الخاصية الوصول إلى الدقة الأفقية لـ RasterImage، المقاسة بالبكسل لكل بوصة. من خلال ضبط أو استرجاع هذه القيمة، يمكنك التحكم بدقة في دقة الصورة، وضمان تلبية متطلباتك الخاصة للجودة والوضوح.

Returns: double - الدقة الأفقية.

ملاحظة: بشكل افتراضي تكون هذه القيمة دائمًا 96 لأن الأنظمة المختلفة لا يمكنها إرجاع دقة الشاشة. قد ترغب في استخدام طريقة SetResolution لتحديث قيمتي الدقة في استدعاء واحد.

Example: The following example shows how to set horizontal/vertical resolution of a JPEG image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.jpg");
try {
    com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = (com.aspose.imaging.fileformats.jpeg.JpegImage) image;

    // احصل على الدقة الأفقية والعمودية لصورة BmpImage
    double horizontalResolution = jpegImage.getHorizontalResolution();
    double verticalResolution = jpegImage.getVerticalResolution();
    System.out.println("The horizontal resolution, in pixels per inch: " + horizontalResolution);
    System.out.println("The vertical resolution, in pixels per inch: " + verticalResolution);

    if (horizontalResolution != 96.0 || verticalResolution != 96.0) {
        // استخدم طريقة SetResolution لتحديث قيمتي الدقة في استدعاء واحد.
        System.out.println("Set resolution values to 96 dpi");
        jpegImage.setResolution(96.0, 96.0);

        System.out.println("The horizontal resolution, in pixels per inch: " + jpegImage.getHorizontalResolution());
        System.out.println("The vertical resolution, in pixels per inch: " + jpegImage.getVerticalResolution());
    }
} finally {
    image.dispose();
}

// قد يبدو الإخراج هكذا:
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 300.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 300.0
// تعيين قيم الدقة إلى 96 نقطة في البوصة
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 96.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 96.0

setHorizontalResolution(double value)

public void setHorizontalResolution(double value)

Parameters:

معامل	نوع	الوصف
	القيمة	double

ملاحظة: بشكل افتراضي تكون هذه القيمة دائمًا 96 لأن المنصات المختلفة لا يمكنها إرجاع دقة الشاشة. قد ترغب في استخدام طريقة setResolution لتحديث قيمتي الدقة في استدعاء واحد. |

getJfif()

public JFIFData getJfif()

تسمح لك هذه الخاصية بالوصول إلى بيانات JFIF (تنسيق تبادل ملفات JPEG) أو تعديلها المرتبطة بصورة JPEG. JFIF هو تنسيق قياسي لتبادل الصور المضغوطة بصيغة JPEG بين الحواسيب والأجهزة الأخرى. من خلال الحصول على هذه الخاصية أو ضبطها، يمكنك التفاعل مع بيانات JFIF، والتي قد تشمل معلومات مثل دقة الصورة، نسبة أبعادها، والصورة المصغرة.

Returns: JFIFData

setJfif(JFIFData value)

public void setJfif(JFIFData value)

Parameters:

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

getRawDataFormat()

public PixelDataFormat getRawDataFormat()

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

Returns: PixelDataFormat

getVerticalResolution()

public double getVerticalResolution()

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

Returns: double - الدقة العمودية.

ملاحظة: بشكل افتراضي تكون هذه القيمة دائمًا 72 لأن الأنظمة المختلفة لا يمكنها إرجاع دقة الشاشة. قد ترغب في استخدام طريقة SetResolution لتحديث قيم الدقة الاثنين في استدعاء واحد.

Example: The following example shows how to set horizontal/vertical resolution of a JPEG image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.jpg");
try {
    com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = (com.aspose.imaging.fileformats.jpeg.JpegImage) image;

    // احصل على الدقة الأفقية والعمودية لصورة BmpImage
    double horizontalResolution = jpegImage.getHorizontalResolution();
    double verticalResolution = jpegImage.getVerticalResolution();
    System.out.println("The horizontal resolution, in pixels per inch: " + horizontalResolution);
    System.out.println("The vertical resolution, in pixels per inch: " + verticalResolution);

    if (horizontalResolution != 96.0 || verticalResolution != 96.0) {
        // استخدم طريقة SetResolution لتحديث قيمتي الدقة في استدعاء واحد.
        System.out.println("Set resolution values to 96 dpi");
        jpegImage.setResolution(96.0, 96.0);

        System.out.println("The horizontal resolution, in pixels per inch: " + jpegImage.getHorizontalResolution());
        System.out.println("The vertical resolution, in pixels per inch: " + jpegImage.getVerticalResolution());
    }
} finally {
    image.dispose();
}

// قد يبدو الإخراج هكذا:
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 300.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 300.0
// تعيين قيم الدقة إلى 96 نقطة في البوصة
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 96.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 96.0

setVerticalResolution(double value)

public void setVerticalResolution(double value)

Parameters:

معامل	نوع	الوصف
	القيمة	double

ملاحظة: بشكل افتراضي تكون هذه القيمة دائمًا 72 لأن الأنظمة المختلفة لا يمكنها إرجاع دقة الشاشة. قد ترغب في استخدام طريقة SetResolution لتحديث قيم الدقة الاثنين في استدعاء واحد. |

getWidth()

public int getWidth()

تسترجع هذه الخاصية عرض الصورة، معبرًا عنه بالبكسل. إنها توفر معلومات أساسية حول أبعاد الصورة، مما يتيح عرضًا دقيقًا، ومعالجة، أو عرضًا لبيانات الصورة.

Returns: int - عرض الصورة بالبكسل.

getRgbColorProfile()

public StreamSource getRgbColorProfile()

ملف تعريف اللون RGB لصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للون وتمثيله. يجب إقرانه بملف تعريف اللون CMYKColorProfile للحفاظ على التناسق والوفاء في عرض اللون. هذا الاقتران أساسي للتطبيقات التي تتطلب إدارة لون دقيقة وإعادة إنتاج الصور، مما يضمن تفسير وعرض بيانات RGB بشكل صحيح.

Returns: StreamSource

setRgbColorProfile(StreamSource value)

public void setRgbColorProfile(StreamSource value)

Parameters:

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

Example: The following example loads PNG and saves it to CMYK JPEG using custom ICC profile. المثال التالي يحمل PNG ويحفظه كـ CMYK JPEG باستخدام ملف تعريف ICC مخصص. ثم يحمل CMYK JPEG ويحفظه مرة أخرى كـ PNG. يتم إجراء تحويل اللون من RGB إلى CMYK ومن CMYK إلى RGB باستخدام ملفات تعريف ICC مخصصة.

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

// تحميل PNG وحفظه كـ CMYK JPEG
com.aspose.imaging.fileformats.png.PngImage image = (com.aspose.imaging.fileformats.png.PngImage) com.aspose.imaging.Image.load(dir + "sample.png");
try {
    java.io.InputStream rgbProfileStream = new java.io.FileInputStream(dir + "eciRGB_v2.icc");
    java.io.InputStream cmykProfileStream = new java.io.FileInputStream(dir + "ISOcoated_v2_FullGamut4.icc");
    try {
        com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();
        saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Cmyk);

        // استخدام ملفات تعريف ICC مخصصة
        saveOptions.setRgbColorProfile(new com.aspose.imaging.sources.StreamSource(rgbProfileStream));
        saveOptions.setCmykColorProfile(new com.aspose.imaging.sources.StreamSource(cmykProfileStream));

        image.save(dir + "output.cmyk.jpg", saveOptions);
    } finally {
        rgbProfileStream.close();
        cmykProfileStream.close();
    }
} finally {
    image.dispose();
}

// تحميل CMYK JPEG وحفظه كـ PNG
com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = (com.aspose.imaging.fileformats.jpeg.JpegImage) com.aspose.imaging.Image.load(dir + "output.cmyk.jpg");
try {
    java.io.InputStream rgbProfileStream = new java.io.FileInputStream(dir + "eciRGB_v2.icc");
    java.io.InputStream cmykProfileStream = new java.io.FileInputStream(dir + "ISOcoated_v2_FullGamut4.icc");
    try {
        // استخدام ملفات تعريف ICC مخصصة
        jpegImage.setRgbColorProfile(new com.aspose.imaging.sources.StreamSource(rgbProfileStream));
        jpegImage.setCmykColorProfile(new com.aspose.imaging.sources.StreamSource(cmykProfileStream));

        com.aspose.imaging.imageoptions.PngOptions saveOptions = new com.aspose.imaging.imageoptions.PngOptions();
        jpegImage.save(dir + "output.rgb.png", saveOptions);
    } finally {
        rgbProfileStream.close();
        cmykProfileStream.close();
    }
} finally {
    jpegImage.dispose();
}

getCmykColorProfile()

public StreamSource getCmykColorProfile()

ملف تعريف اللون CMYK المرتبط بصور JPEG بنظام CMYK وYCCK يضمن تحويلًا دقيقًا للون والوفاء. يعمل بالتعاون مع RGBColorProfile لضمان تمثيل لون دقيق عبر مختلف الأجهزة والتطبيقات. هذا الاقتران ضروري للحفاظ على التناسق في عرض اللون وتحقيق جودة صورة مثالية.

Returns: StreamSource

setCmykColorProfile(StreamSource value)

public void setCmykColorProfile(StreamSource value)

Parameters:

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

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

// تحميل PNG وحفظه كـ CMYK JPEG
com.aspose.imaging.fileformats.png.PngImage image = (com.aspose.imaging.fileformats.png.PngImage) com.aspose.imaging.Image.load(dir + "sample.png");
try {
    java.io.InputStream rgbProfileStream = new java.io.FileInputStream(dir + "eciRGB_v2.icc");
    java.io.InputStream cmykProfileStream = new java.io.FileInputStream(dir + "ISOcoated_v2_FullGamut4.icc");
    try {
        com.aspose.imaging.imageoptions.JpegOptions saveOptions = new com.aspose.imaging.imageoptions.JpegOptions();
        saveOptions.setColorType(com.aspose.imaging.fileformats.jpeg.JpegCompressionColorMode.Cmyk);

        // استخدام ملفات تعريف ICC مخصصة
        saveOptions.setRgbColorProfile(new com.aspose.imaging.sources.StreamSource(rgbProfileStream));
        saveOptions.setCmykColorProfile(new com.aspose.imaging.sources.StreamSource(cmykProfileStream));

        image.save(dir + "output.cmyk.jpg", saveOptions);
    } finally {
        rgbProfileStream.close();
        cmykProfileStream.close();
    }
} finally {
    image.dispose();
}

// تحميل CMYK JPEG وحفظه كـ PNG
com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = (com.aspose.imaging.fileformats.jpeg.JpegImage) com.aspose.imaging.Image.load(dir + "output.cmyk.jpg");
try {
    java.io.InputStream rgbProfileStream = new java.io.FileInputStream(dir + "eciRGB_v2.icc");
    java.io.InputStream cmykProfileStream = new java.io.FileInputStream(dir + "ISOcoated_v2_FullGamut4.icc");
    try {
        // استخدام ملفات تعريف ICC مخصصة
        jpegImage.setRgbColorProfile(new com.aspose.imaging.sources.StreamSource(rgbProfileStream));
        jpegImage.setCmykColorProfile(new com.aspose.imaging.sources.StreamSource(cmykProfileStream));

        com.aspose.imaging.imageoptions.PngOptions saveOptions = new com.aspose.imaging.imageoptions.PngOptions();
        jpegImage.save(dir + "output.rgb.png", saveOptions);
    } finally {
        rgbProfileStream.close();
        cmykProfileStream.close();
    }
} finally {
    jpegImage.dispose();
}

getDestinationRgbColorProfile()

public StreamSource getDestinationRgbColorProfile()

RGBColorProfile أساسي للتحويل الدقيق للون لصور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ. عند إقرانه بـ CMYKColorProfile، يضمن أن الألوان تُعرض بشكل صحيح ويحافظ على التناسق عبر الأجهزة والتطبيقات المختلفة. هذا الجمع ضروري للحفاظ على تمثيل اللون المقصود وتحقيق مخرجات صورة عالية الجودة.

Returns: StreamSource

setDestinationRgbColorProfile(StreamSource value)

public void setDestinationRgbColorProfile(StreamSource value)

Parameters:

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

getDestinationCmykColorProfile()

public StreamSource getDestinationCmykColorProfile()

ملف تعريف اللون CMYK ضروري للتحويل الدقيق للون لصور JPEG بنظام CMYK وYCCK أثناء عملية الحفظ. يعمل بالتوازي مع RGBColorProfile لضمان تمثيل لون صحيح، مع الحفاظ على التناسق والجودة عبر الأجهزة والبرمجيات المختلفة. هذا التزامن أساسي لتحقيق عرض لون دقيق وموثوق في الصور المحفوظة نهائيًا.

Returns: StreamSource

setDestinationCmykColorProfile(StreamSource value)

public void setDestinationCmykColorProfile(StreamSource value)

Parameters:

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

getIgnoreEmbeddedColorProfile()

public boolean getIgnoreEmbeddedColorProfile()

يسترجع أو يعدل العلامة التي تشير إلى ما إذا كان يتم تجاهل ملف تعريف اللون المدمج. من خلال ضبط هذه العلامة، يمكن للمستخدمين تحديد ما إذا كان يجب استخدام ملف تعريف اللون الافتراضي بدلاً من المدمج. يضمن هذا الخيار تحكمًا أكبر في إدارة اللون، مما يسهل التعديلات للتناسق والتوافق عبر مختلف الأنظمة والتطبيقات.

Returns: boolean

setIgnoreEmbeddedColorProfile(boolean value)

public void setIgnoreEmbeddedColorProfile(boolean value)

Parameters:

معامل	نوع	الوصف
القيمة	boolean

getOriginalOptions()

public ImageOptionsBase getOriginalOptions()

يحصل على خيارات الصورة الأصلية لهذا الكائن Image instance.

Returns: ImageOptionsBase - A clone of original image options.

removeMetadata()

public void removeMetadata()

يزيل بيانات التعريف لهذا الكائن الصورة عن طريق تعيين قيم IHasXmpData.XmpData(IHasXmpData.getXmpData/IHasXmpData.setXmpData(XmpPacketWrapper)) و IHasExifData.ExifData(IHasExifData.getExifData()/IHasExifData.setExifData(ExifData)) إلى null.

setResolution(double dpiX, double dpiY)

public void setResolution(double dpiX, double dpiY)

يحدد الدقة للصورة المحددة RasterImage، مما يضمن تحجيمًا وطباعة دقيقة. تمكّن هذه الطريقة المستخدمين من تعديل دقة الصورة لتناسب متطلباتهم الخاصة، سواء للعرض الرقمي أو النسخ المادي. من خلال ضبط الدقة، يمكن للمستخدمين تحسين جودة الصورة وضمان التوافق مع مختلف أجهزة الإخراج والوسائط، مما يعزز التجربة البصرية العامة وقابلية استخدام الصورة.

Parameters:

معامل	نوع	الوصف
dpiX	double	الدقة الأفقية، بوحدات النقاط في البوصة، لـ `RasterImage`.
dpiY	double	الدقة العمودية، بوحدات النقاط في البوصة، لـ `RasterImage`.

Example: The following example shows how to set horizontal/vertical resolution of a JPEG image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.jpg");
try {
    com.aspose.imaging.fileformats.jpeg.JpegImage jpegImage = (com.aspose.imaging.fileformats.jpeg.JpegImage) image;

    // احصل على الدقة الأفقية والعمودية لصورة BmpImage
    double horizontalResolution = jpegImage.getHorizontalResolution();
    double verticalResolution = jpegImage.getVerticalResolution();
    System.out.println("The horizontal resolution, in pixels per inch: " + horizontalResolution);
    System.out.println("The vertical resolution, in pixels per inch: " + verticalResolution);

    if (horizontalResolution != 96.0 || verticalResolution != 96.0) {
        // استخدم طريقة SetResolution لتحديث قيمتي الدقة في استدعاء واحد.
        System.out.println("Set resolution values to 96 dpi");
        jpegImage.setResolution(96.0, 96.0);

        System.out.println("The horizontal resolution, in pixels per inch: " + jpegImage.getHorizontalResolution());
        System.out.println("The vertical resolution, in pixels per inch: " + jpegImage.getVerticalResolution());
    }
} finally {
    image.dispose();
}

// قد يبدو الإخراج هكذا:
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 300.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 300.0
// تعيين قيم الدقة إلى 96 نقطة في البوصة
// الدقة الأفقية، بوحدات البكسل لكل بوصة: 96.0
// الدقة العمودية، بوحدات البكسل لكل بوصة: 96.0

JpegCompressionMode JpegLsInterleaveMode