Jpeg2000Image

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

public final class Jpeg2000Image extends RasterCachedImage

تعديل ملفات صور JPEG2000 (JP2) بكفاءة باستخدام واجهة برمجة التطبيقات الخاصة بنا، التي تدعم مجموعة من أعماق البت لكل بكسل ومعالجة سلسة لبيانات XMP الوصفية التي تحتوي على معلومات الصورة الأساسية. مع إمكانيات الضغط بدون فقدان، يضمن جودة صورة مثالية مع الحفاظ على سلامة الملف، مما يمكّنك من تخصيص صور JP2 وفقًا لمواصفاتك الدقيقة بسهولة.

المنشئات

المنشئ	الوصف
Jpeg2000Image(String path)	ابدأ العمل مع الفئة Jpeg2000Image عن طريق إنشاء مثيل جديد باستخدام المسار إلى الصورة التي تريد تحميلها.
Jpeg2000Image(String path, int bitsPerPixel)	ابدأ بسهولة مع الفئة Jpeg2000Image بإنشاء مثيل جديد يتضمن كلًا من مسار الملف ومعامل البت لكل بكسل المطلوب.
Jpeg2000Image(InputStream stream)	قم بتهيئة مثيل جديد بسهولة من الفئة Jpeg2000Image عن طريق توفير كائن تدفق.
Jpeg2000Image(InputStream stream, int bitsPerPixel)	تهيئة مثيل جديد من الفئة Jpeg2000Image باستخدام تدفق لتحميل الصورة، بالإضافة إلى معلمات البت لكل بكسل.
Jpeg2000Image(int width, int height)	إنشاء نسخة جديدة من الفئة Jpeg2000Image، مع تحديد معلمات العرض والارتفاع.
Jpeg2000Image(int width, int height, Jpeg2000Options options)	إنشاء كائن جديد من Jpeg2000Image، مع توفير معلمات العرض والارتفاع وخيارات الصورة.
Jpeg2000Image(int width, int height, int bitsCount)	إنشاء نسخة جديدة من الفئة Jpeg2000Image مع معلمات للعرض والارتفاع وعدد البتات.
Jpeg2000Image(RasterImage image)	إنشاء نسخة جديدة من الفئة Jpeg2000Image باستخدام صورة نقطية.
Jpeg2000Image(RasterImage rasterImage, int bitsPerPixel)	تهيئة نسخة جديدة من الفئة Jpeg2000Image باستخدام صورة نقطية ومعلمات البتات لكل بكسل.

الطرق

طريقة	الوصف
getFileFormat()	استرجاع تنسيق ملف الصورة.
getRawDataFormat()	هذه الخاصية تسترجع تنسيق البيانات الخام للصورة.
getRawLineSize()	هذه الخاصية تسترجع حجم سطر واحد من البيانات الخام للصورة بوحدة البايت.
getWidth()	هذه الخاصية تُعيد عرض الصورة بالبكسل.
getHeight()	هذه الخاصية تسترجع ارتفاع الصورة بالبكسل.
getBitsPerPixel()	هذه الخاصية تُعيد عمق الصورة، مقاسًا بالبتات لكل بكسل (bpp).
getHorizontalResolution()	هذه الخاصية تتيح لك استرجاع أو تعديل الدقة الأفقية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI).
setHorizontalResolution(double value)	هذه الخاصية تتيح لك استرجاع أو تعديل الدقة الأفقية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI).
getVerticalResolution()	هذه الخاصية توفر الوصول إلى الدقة العمودية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI).
setVerticalResolution(double value)	هذه الخاصية توفر الوصول إلى الدقة العمودية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI).
getComments()	هذه الخاصية تسمح باسترجاع أو تحديث التعليقات المرتبطة بالصورة.
setComments(String[] value)	هذه الخاصية تسمح باسترجاع أو تحديث التعليقات المرتبطة بالصورة.
getCodec()	هذه الخاصية تسترجع برنامج الترميز JPEG2000 المرتبط بالصورة.
getOriginalOptions()	استرجاع خيارات الصورة بناءً على إعدادات الملف الأصلي.

Example: This example shows how to load a JPEG2000 image from a file and save it to PNG.

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

// تحميل صورة JPEG2000.
com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image jpeg2000Image = new com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image(dir + "sample.jp2");
try {
    // احفظ إلى PNG
    jpeg2000Image.save(dir + "sample.output.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    jpeg2000Image.dispose();
}

Jpeg2000Image(String path)

public Jpeg2000Image(String path)

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

Parameters:

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

Jpeg2000Image(String path, int bitsPerPixel)

public Jpeg2000Image(String path, int bitsPerPixel)

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

Parameters:

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

Jpeg2000Image(InputStream stream)

public Jpeg2000Image(InputStream stream)

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

Parameters:

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

Jpeg2000Image(InputStream stream, int bitsPerPixel)

public Jpeg2000Image(InputStream stream, int bitsPerPixel)

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

Parameters:

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

Jpeg2000Image(int width, int height)

public Jpeg2000Image(int width, int height)

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

Parameters:

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

Jpeg2000Image(int width, int height, Jpeg2000Options options)

public Jpeg2000Image(int width, int height, Jpeg2000Options options)

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

Parameters:

معامل	نوع	الوصف
width	int	عرض الصورة
height	int	ارتفاع الصورة
options	Jpeg2000Options	الخيارات.

Jpeg2000Image(int width, int height, int bitsCount)

public Jpeg2000Image(int width, int height, int bitsCount)

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

Parameters:

معامل	نوع	الوصف
width	int	عرض الصورة
height	int	ارتفاع الصورة
bitsCount	int	عدد البتات.

Jpeg2000Image(RasterImage image)

public Jpeg2000Image(RasterImage image)

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

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة.

Jpeg2000Image(RasterImage rasterImage, int bitsPerPixel)

public Jpeg2000Image(RasterImage rasterImage, int bitsPerPixel)

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

Parameters:

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

getFileFormat()

public long getFileFormat()

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

Returns: long

getRawDataFormat()

public PixelDataFormat getRawDataFormat()

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

Returns: PixelDataFormat - The raw data format.

getRawLineSize()

public int getRawLineSize()

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

Returns: عدد صحيح - حجم السطر الخام بالبايت.

getWidth()

public int getWidth()

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

Returns: int

getHeight()

public int getHeight()

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

Returns: int

getBitsPerPixel()

public int getBitsPerPixel()

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

Returns: int

getHorizontalResolution()

public double getHorizontalResolution()

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

Returns: مزدوج - الدقة الأفقية.

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

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

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.jp2");
try {
    com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image jpeg2000Image = (com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image) image;

    // احصل على الدقة الأفقية والرأسية لـ Jpeg2000Image.
    double horizontalResolution = jpeg2000Image.getHorizontalResolution();
    double verticalResolution = jpeg2000Image.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");
        jpeg2000Image.setResolution(96.0, 96.0);

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

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

setHorizontalResolution(double value)

public void setHorizontalResolution(double value)

Parameters:

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

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

getVerticalResolution()

public double getVerticalResolution()

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

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

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

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.jp2");
try {
    com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image jpeg2000Image = (com.aspose.imaging.fileformats.jpeg2000.Jpeg2000Image) image;

    // احصل على الدقة الأفقية والرأسية لـ Jpeg2000Image.
    double horizontalResolution = jpeg2000Image.getHorizontalResolution();
    double verticalResolution = jpeg2000Image.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");
        jpeg2000Image.setResolution(96.0, 96.0);

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

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

setVerticalResolution(double value)

public void setVerticalResolution(double value)

Parameters:

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

getComments()

public String[] getComments()

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

Returns: java.lang.String[] - التعليقات.

setComments(String[] value)

public void setComments(String[] value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String[]	التعليقات.

getCodec()

public int getCodec()

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

Returns: int - الترميز.

getOriginalOptions()

public ImageOptionsBase getOriginalOptions()

استرجع خيارات الصورة بناءً على إعدادات الملف الأصلي. هذه الطريقة مفيدة للحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية، مما يضمن الاتساق ويحافظ على سلامة بيانات الصورة. الوصول إلى هذه الخيارات يسهل التعامل السلس ومعالجة الصورة مع الاحتفاظ بخصائصها الأصلية. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة DataStreamSupporter.save(String)، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Image.save(String, ImageOptionsBase) كمعامل ثانٍ.

Returns: ImageOptionsBase - The options based on the original file settings.

Jpeg2000CustomException