PngImage

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.fileformats.core.interfaces.IInterlaced

public class PngImage extends RasterCachedImage implements IInterlaced

تعديل صور Portable Network Graphics (PNG) النقطية باستخدام واجهة برمجة التطبيقات المتعددة الاستخدامات، التي تدعم مستويات الضغط ومختلف أعماق الألوان بما في ذلك الرمادي، اللون المفهرس، TrueColor، وقنوات ألفا. معالجة بيانات XMP الوصفية بسلاسة، مما يتيح إدارة شاملة لبيانات الصورة الوصفية، مع تحميل صور PNG بسهولة، إجراء تعديلات متنوعة، تطبيق الفلاتر، وتحويل الصور إلى صيغ ملفات أخرى لتحقيق أقصى قدر من المرونة والتخصيص.

المنشئات

المنشئالوصف
PngImage(int width, int height)إنشاء كائن جديد من الفئة PngImage عن طريق توفير معلمات العرض والارتفاع.
PngImage(String path)إنشاء نسخة جديدة من الفئة PngImage باستخدام معلمة المسار لتحديد موقع ملف الصورة الذي سيتم تحميله.
PngImage(RasterImage rasterImage)إنشاء نسخة جديدة من الفئة PngImage عن طريق توفير صورة نقطية كمعلمة.
PngImage(String path, int colorType)تهيئة نسخة جديدة من الفئة PngImage بتحديد مسار ملف الصورة ونوع اللون.
PngImage(RasterImage rasterImage, int colorType)إنشاء نسخة جديدة من الفئة PngImage بتحديد صورة نقطية ونوع اللون.
PngImage(InputStream stream)إنشاء نسخة جديدة من الفئة PngImage بتهيئتها باستخدام تدفق.
PngImage(int width, int height, int colorType)إنشاء نسخة جديدة من الفئة PngImage، مع تحديد معلمات العرض والارتفاع ونوع اللون المطلوبة.
PngImage(PngOptions pngOptions, int width, int height)تهيئة نسخة جديدة من الفئة PngImage، مع دمج خيارات PNG إلى جانب معلمات العرض والارتفاع.

الطرق

طريقةالوصف
getBitsPerPixel()استرجاع قيمة البتات لكل بكسل للصورة.
getHeight()الحصول على ارتفاع الصورة بالبكسل.
getHorizontalResolution()استرجاع أو تعديل الدقة الأفقية للصورة.
setHorizontalResolution(double value)استرجاع أو تعديل الدقة الأفقية للصورة.
getFileFormat()استرجاع تنسيق الملف المرتبط بنسخة الصورة.
getRawDataFormat()الوصول إلى تنسيق البيانات الخام للصورة.
getVerticalResolution()يوفر الوصول إلى الدقة العمودية للصورة.
setVerticalResolution(double value)يوفر الوصول إلى الدقة العمودية للصورة.
getWidth()يسمح باسترجاع عرض الصورة بالبكسل، مما يوفر معلومات أساسية حول أبعادها.
hasTransparentColor()يوفر قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على لون شفاف.
hasAlpha()يرجع قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على قناة ألفا، التي تحدد شفافيتها.
getTransparentColor()يسترجع اللون الشفاف للصورة، إذا كان موجودًا.
setTransparentColor(boolean value)يوفر قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على لون شفاف.
setTransparentColor(Color value)يُعدّل اللون الشفاف للصورة، إذا كان موجودًا.
hasBackgroundColor()يسترجع قيمة منطقية تُشير إلى ما إذا كانت الصورة لديها لون خلفية.
getBackgroundColor()يسترجع لون الخلفية للصورة، إذا تم تحديده.
setBackgroundColor(boolean value)يسترجع قيمة منطقية تُشير إلى ما إذا كانت الصورة لديها لون خلفية.
setBackgroundColor(Color value)يسترجع لون الخلفية للصورة، إذا تم تحديده.
getInterlaced()يسترجع قيمة منطقية تُشير إلى ما إذا كان الـ PngImage متشابكًا، مما يحدد ما إذا كانت بيانات الصورة مخزنة بطريقة تدريجية لتحميل أو نقل أسرع.
isInterlaced()يحصل على قيمة تشير إلى ما إذا كانت نسخة الصورة هذه متشابكة.
getDefaultOptions(Object[] args)يحصل على الخيارات الافتراضية.
getOriginalOptions()يحصل على الخيارات بناءً على إعدادات الملف الأصلي.

Example: This example shows how to load a PNG image from a file.

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

// تحميل صورة PNG من ملف.
com.aspose.imaging.fileformats.png.PngImage pngImage = new com.aspose.imaging.fileformats.png.PngImage(dir + "sample.png");
try {
    // تحويل الصورة إلى تمثيل تدرج الرمادي
    pngImage.grayscale();

    // حفظ إلى ملف.
    pngImage.save(dir + "sample.grayscale.png");
} finally {
    pngImage.dispose();
}

PngImage(int width, int height)

public PngImage(int width, int height)

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

Parameters:

معاملنوعالوصف
widthintالعرض.
heightintالارتفاع.

PngImage(String path)

public PngImage(String path)

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

Parameters:

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

PngImage(RasterImage rasterImage)

public PngImage(RasterImage rasterImage)

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

Parameters:

معاملنوعالوصف
rasterImageRasterImageالصورة النقطية.

PngImage(String path, int colorType)

public PngImage(String path, int colorType)

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

Parameters:

معاملنوعالوصف
مسارjava.lang.Stringالمسار لتحميل صورة.
colorTypeintنوع اللون.

PngImage(RasterImage rasterImage, int colorType)

public PngImage(RasterImage rasterImage, int colorType)

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

Parameters:

معاملنوعالوصف
rasterImageRasterImageالصورة النقطية.
colorTypeintنوع اللون.

PngImage(InputStream stream)

public PngImage(InputStream stream)

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

Parameters:

معاملنوعالوصف
تدفقjava.io.InputStreamالتدفق لتحميل صورة.

PngImage(int width, int height, int colorType)

public PngImage(int width, int height, int colorType)

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

Parameters:

معاملنوعالوصف
widthintالعرض.
heightintالارتفاع.
colorTypeintنوع اللون.

PngImage(PngOptions pngOptions, int width, int height)

public PngImage(PngOptions pngOptions, int width, int height)

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

Parameters:

معاملنوعالوصف
pngOptionsPngOptionsخيارات PNG.
widthintالعرض.
heightintالارتفاع.

getBitsPerPixel()

public int getBitsPerPixel()

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

Returns: int

getHeight()

public int getHeight()

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

Returns: int

getHorizontalResolution()

public double getHorizontalResolution()

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

Returns: double

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

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.png");
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;

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

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

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

setHorizontalResolution(double value)

public void setHorizontalResolution(double value)

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

Parameters:

معاملنوعالوصف
valuedouble

getFileFormat()

public long getFileFormat()

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

Returns: long

getRawDataFormat()

public PixelDataFormat getRawDataFormat()

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

Returns: PixelDataFormat

Example: The following example loads PNG images and prints information about raw data format and alpha channel.


// صور PNG التي سيتم تحميلها.
String[] fileNames = new String[]
        {
                "c:\\temp\\sample.png",
                "c:\\temp\\alpha.png",
        };

for (String fileName : fileNames) {
    com.aspose.imaging.Image image = com.aspose.imaging.Image.load(fileName);
    try {
        com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;
        System.out.printf("ImageFile=%s, FileFormat=%s, HasAlpha=%s", fileName, pngImage.getRawDataFormat(), pngImage.hasAlpha());
    } finally {
        image.dispose();
    }
}

// قد يبدو الإخراج هكذا:
// ImageFile=c:\temp\sample.png, FileFormat=Rgb24Bpp, used channels: 8,8,8, HasAlpha=False
// ImageFile=c:\temp\alpha.png, FileFormat=RGBA32Bpp, used channels: 8,8,8,8, HasAlpha=True

getVerticalResolution()

public double getVerticalResolution()

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

Returns: double

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

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.png");
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;

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

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

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

setVerticalResolution(double value)

public void setVerticalResolution(double value)

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

Parameters:

معاملنوعالوصف
valuedouble

getWidth()

public int getWidth()

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

Returns: int

hasTransparentColor()

public boolean hasTransparentColor()

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

Returns: boolean

hasAlpha()

public boolean hasAlpha()

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

Returns: منطقي - true إذا كان لهذه الحالة ألفا؛ وإلا false.

Example: The following example shows how to check if a PNG image supports alpha-channel.


// فئة المساعدة
class Utils {
    public String getPngColorTypeString(int colorType) {
        switch (colorType) {
            case com.aspose.imaging.fileformats.png.PngColorType.Grayscale:
                return "Grayscale";

            case com.aspose.imaging.fileformats.png.PngColorType.Truecolor:
                return "Truecolor";

            case com.aspose.imaging.fileformats.png.PngColorType.IndexedColor:
                return "IndexedColor";

            case com.aspose.imaging.fileformats.png.PngColorType.GrayscaleWithAlpha:
                return "GrayscaleWithAlpha";

            case com.aspose.imaging.fileformats.png.PngColorType.TruecolorWithAlpha:
                return "TruecolorWithAlpha";

            default:
                throw new IllegalArgumentException("colorType");
        }
    }
}

// إليك المثال الرئيسي
Utils utils = new Utils();

// احصل على جميع أنواع ألوان PNG المدعومة.
java.lang.Long[] colorTypes = com.aspose.imaging.fileformats.png.PngColorType.getValues(com.aspose.imaging.fileformats.png.PngColorType.class);

for (java.lang.Long colorType : colorTypes) {
    com.aspose.imaging.imageoptions.PngOptions createOptions = new com.aspose.imaging.imageoptions.PngOptions();
    createOptions.setSource(new com.aspose.imaging.sources.StreamSource(new java.io.ByteArrayInputStream(new byte[0])));
    createOptions.setColorType(colorType.intValue());

    com.aspose.imaging.Image image = com.aspose.imaging.Image.create(createOptions, 100, 100);
    try {
        com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;

        if (pngImage.hasAlpha()) {
            System.out.printf("A %s PNG image supports alpha channel\r\n", utils.getPngColorTypeString(createOptions.getColorType()));
        } else {
            System.out.printf("A %s PNG image doesn't support alpha channel\r\n", utils.getPngColorTypeString(createOptions.getColorType()));
        }
    } finally {
        image.dispose();
    }
}

// المخرجات تبدو هكذا:
// صورة PNG بتدرج الرمادي لا تدعم قناة ألفا
// صورة PNG بالألوان الحقيقية لا تدعم قناة ألفا
// صورة PNG بألوان مفهرسة لا تدعم قناة ألفا
// صورة PNG بتدرج الرمادي مع ألفا تدعم قناة ألفا
// صورة PNG بالألوان الحقيقية مع ألفا تدعم قناة ألفا

getTransparentColor()

public Color getTransparentColor()

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

Returns: Color

setTransparentColor(boolean value)

public void setTransparentColor(boolean value)

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

Parameters:

معاملنوعالوصف
valueboolean

Example: The following example shows how to set fully transparent colors for a part of a TrueColor PNG image which doesn’t support alpha channel.


com.aspose.imaging.imageoptions.PngOptions createOptions = new com.aspose.imaging.imageoptions.PngOptions();
createOptions.setSource(new com.aspose.imaging.sources.FileCreateSource("c:\\temp\\transparent.png", false));
createOptions.setColorType(com.aspose.imaging.fileformats.png.PngColorType.Truecolor);

// إنشاء صورة PNG بالألوان الحقيقية بحجم 100×100 بكسل.
com.aspose.imaging.Image image = com.aspose.imaging.Image.create(createOptions, 100, 100);
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(pngImage);

    // سيتم اعتبار جميع البكسلات الحمراء شفافة بالكامل.
    pngImage.setTransparentColor(com.aspose.imaging.Color.getRed());
    pngImage.setTransparentColor(true);

    // ستمتلك جميع البكسلات الشفافة لون خلفية.
    pngImage.setBackgroundColor(com.aspose.imaging.Color.getGreen());
    pngImage.setBackgroundColor(true);

    // املأ الصورة بالكامل باللون الأبيض.
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getWhite()), pngImage.getBounds());

    // املأ الربع العلوي الأيسر من الصورة باللون الشفاف.
    // هذا يجعل الربع العلوي الأيسر ملونًا بلون الخلفية.
    com.aspose.imaging.Rectangle rect = new com.aspose.imaging.Rectangle(0, 0, pngImage.getWidth() / 2, pngImage.getHeight() / 2);
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed()), rect);

    pngImage.save();
} finally {
    image.dispose();
}

setTransparentColor(Color value)

public void setTransparentColor(Color value)

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

Parameters:

معاملنوعالوصف
valueColor

Example: The following example shows how to set fully transparent colors for a part of a TrueColor PNG image which doesn’t support alpha channel.


com.aspose.imaging.imageoptions.PngOptions createOptions = new com.aspose.imaging.imageoptions.PngOptions();
createOptions.setSource(new com.aspose.imaging.sources.FileCreateSource("c:\\temp\\transparent.png", false));
createOptions.setColorType(com.aspose.imaging.fileformats.png.PngColorType.Truecolor);

// إنشاء صورة PNG بالألوان الحقيقية بحجم 100×100 بكسل.
com.aspose.imaging.Image image = com.aspose.imaging.Image.create(createOptions, 100, 100);
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(pngImage);

    // سيتم اعتبار جميع البكسلات الحمراء شفافة بالكامل.
    pngImage.setTransparentColor(com.aspose.imaging.Color.getRed());
    pngImage.setTransparentColor(true);

    // ستمتلك جميع البكسلات الشفافة لون خلفية.
    pngImage.setBackgroundColor(com.aspose.imaging.Color.getGreen());
    pngImage.setBackgroundColor(true);

    // املأ الصورة بالكامل باللون الأبيض.
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getWhite()), pngImage.getBounds());

    // املأ الربع العلوي الأيسر من الصورة باللون الشفاف.
    // هذا يجعل الربع العلوي الأيسر ملونًا بلون الخلفية.
    com.aspose.imaging.Rectangle rect = new com.aspose.imaging.Rectangle(0, 0, pngImage.getWidth() / 2, pngImage.getHeight() / 2);
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed()), rect);

    pngImage.save();
} finally {
    image.dispose();
}

hasBackgroundColor()

public boolean hasBackgroundColor()

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

Returns: boolean

getBackgroundColor()

public Color getBackgroundColor()

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

Returns: Color

setBackgroundColor(boolean value)

public void setBackgroundColor(boolean value)

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

Parameters:

معاملنوعالوصف
valueboolean

Example: The following example shows how to set fully transparent colors for a part of a TrueColor PNG image which doesn’t support alpha channel.


com.aspose.imaging.imageoptions.PngOptions createOptions = new com.aspose.imaging.imageoptions.PngOptions();
createOptions.setSource(new com.aspose.imaging.sources.FileCreateSource("c:\\temp\\transparent.png", false));
createOptions.setColorType(com.aspose.imaging.fileformats.png.PngColorType.Truecolor);

// إنشاء صورة PNG بالألوان الحقيقية بحجم 100×100 بكسل.
com.aspose.imaging.Image image = com.aspose.imaging.Image.create(createOptions, 100, 100);
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(pngImage);

    // سيتم اعتبار جميع البكسلات الحمراء شفافة بالكامل.
    pngImage.setTransparentColor(com.aspose.imaging.Color.getRed());
    pngImage.setTransparentColor(true);

    // ستمتلك جميع البكسلات الشفافة لون خلفية.
    pngImage.setBackgroundColor(com.aspose.imaging.Color.getGreen());
    pngImage.setBackgroundColor(true);

    // املأ الصورة بالكامل باللون الأبيض.
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getWhite()), pngImage.getBounds());

    // املأ الربع العلوي الأيسر من الصورة باللون الشفاف.
    // هذا يجعل الربع العلوي الأيسر ملونًا بلون الخلفية.
    com.aspose.imaging.Rectangle rect = new com.aspose.imaging.Rectangle(0, 0, pngImage.getWidth() / 2, pngImage.getHeight() / 2);
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed()), rect);

    pngImage.save();
} finally {
    image.dispose();
}

setBackgroundColor(Color value)

public void setBackgroundColor(Color value)

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

Parameters:

معاملنوعالوصف
valueColor

Example: The following example shows how to set fully transparent colors for a part of a TrueColor PNG image which doesn’t support alpha channel.


com.aspose.imaging.imageoptions.PngOptions createOptions = new com.aspose.imaging.imageoptions.PngOptions();
createOptions.setSource(new com.aspose.imaging.sources.FileCreateSource("c:\\temp\\transparent.png", false));
createOptions.setColorType(com.aspose.imaging.fileformats.png.PngColorType.Truecolor);

// إنشاء صورة PNG بالألوان الحقيقية بحجم 100×100 بكسل.
com.aspose.imaging.Image image = com.aspose.imaging.Image.create(createOptions, 100, 100);
try {
    com.aspose.imaging.fileformats.png.PngImage pngImage = (com.aspose.imaging.fileformats.png.PngImage) image;
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(pngImage);

    // سيتم اعتبار جميع البكسلات الحمراء شفافة بالكامل.
    pngImage.setTransparentColor(com.aspose.imaging.Color.getRed());
    pngImage.setTransparentColor(true);

    // ستمتلك جميع البكسلات الشفافة لون خلفية.
    pngImage.setBackgroundColor(com.aspose.imaging.Color.getGreen());
    pngImage.setBackgroundColor(true);

    // املأ الصورة بالكامل باللون الأبيض.
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getWhite()), pngImage.getBounds());

    // املأ الربع العلوي الأيسر من الصورة باللون الشفاف.
    // هذا يجعل الربع العلوي الأيسر ملونًا بلون الخلفية.
    com.aspose.imaging.Rectangle rect = new com.aspose.imaging.Rectangle(0, 0, pngImage.getWidth() / 2, pngImage.getHeight() / 2);
    gr.fillRectangle(new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed()), rect);

    pngImage.save();
} finally {
    image.dispose();
}

getInterlaced()

public boolean getInterlaced()

يسترجع قيمة منطقية تُشير إلى ما إذا كان الـ PngImage متشابكًا، مما يحدد ما إذا كانت بيانات الصورة مخزنة بطريقة تدريجية لتحميل أو نقل أسرع.

Returns: boolean - true إذا كان متشابكًا؛ وإلا false.

isInterlaced()

public final boolean isInterlaced()

يحصل على قيمة تشير إلى ما إذا كانت نسخة الصورة هذه متشابكة.

القيمة: true إذا كانت مثيلة الصورة هذه متشابكة؛ وإلا false.

Returns: منطقي - قيمة تشير إلى ما إذا كانت نسخة الصورة هذه متشابكة.

getDefaultOptions(Object[] args)

public ImageOptionsBase getDefaultOptions(Object[] args)

يحصل على الخيارات الافتراضية.

Parameters:

معاملنوعالوصف
argsjava.lang.Object[]المعاملات.

Returns: ImageOptionsBase - Default options

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.

PngFilterType