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:

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

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:

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

PngImage(String path, int colorType)

public PngImage(String path, int colorType)

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

Parameters:

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

PngImage(RasterImage rasterImage, int colorType)

public PngImage(RasterImage rasterImage, int colorType)

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

Parameters:

معامل	نوع	الوصف
rasterImage	RasterImage	الصورة النقطية.
colorType	int	نوع اللون.

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:

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

PngImage(PngOptions pngOptions, int width, int height)

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

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

Parameters:

معامل	نوع	الوصف
pngOptions	PngOptions	خيارات PNG.
العرض	int	العرض.
الارتفاع	int	الارتفاع.

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:

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

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)

Parameters:

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

getWidth()

public int getWidth()

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

Returns: int

hasTransparentColor()

public boolean hasTransparentColor()

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

Returns: boolean

hasAlpha()

public boolean hasAlpha()

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

Returns: boolean - 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:

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

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:

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

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:

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

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:

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

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: boolean - قيمة تشير إلى ما إذا كانت نسخة الصورة هذه متشابكة.

getDefaultOptions(Object[] args)

public ImageOptionsBase getDefaultOptions(Object[] args)

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

Parameters:

معامل	نوع	الوصف
args	java.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