GifImage

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

All Implemented Interfaces: com.aspose.imaging.IMultipageImageExt, com.aspose.fileformats.core.interfaces.IInterlaced

public final class GifImage extends RasterCachedMultipageImage implements IMultipageImageExt, IInterlaced

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

المنشئات

المنشئ	الوصف
GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette)	ابدأ كائنًا جديدًا من نوع GifImage مع معلمات محددة للإطار الأول ولوحة الألوان العامة.
GifImage(GifFrameBlock firstFrame)	تصميم صور GIF يصبح سهلًا مع مُنشئ GifImage.
GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette, boolean isPaletteSorted, byte paletteColorResolution, byte paletteBackgroundColorIndex, byte aspectRatio, boolean hasTrailer)	ابدأ بسهولة مع مُنشئ GifImage.

الطرق

طريقة	الوصف
getFileFormat()	استرجع تنسيق الملف بسهولة باستخدام هذه الخاصية.
hasTrailer()	تحكم في وجود مقطورة في ملفات GIF الخاصة بك باستخدام هذه الخاصية.
setTrailer(boolean value)	تحكم في وجود مقطورة في ملفات GIF الخاصة بك باستخدام هذه الخاصية.
isPaletteSorted()	تحكم في ترتيب لوحة الألوان في صور GIF الخاصة بك باستخدام هذه الخاصية.
setPaletteSorted(boolean value)	تحكم في ترتيب لوحة الألوان في صور GIF الخاصة بك باستخدام هذه الخاصية.
getLoopsCount()	استرجع عدد التكرارات بسهولة باستخدام هذه الخاصية.
setLoopsCount(int value)	استرجع عدد التكرارات بسهولة باستخدام هذه الخاصية.
getPaletteColorResolutionBits()	تحكم في دقة ألوان لوحة الألوان لصور GIF الخاصة بك باستخدام هذه الخاصية.
setPaletteColorResolutionBits(byte value)	تحكم في دقة ألوان لوحة الألوان لصور GIF الخاصة بك باستخدام هذه الخاصية.
getPageCount()	استرجع العدد الإجمالي للصفحات الموجودة داخل الصورة باستخدام هذه الخاصية البسيطة.
getPages()	احصل على الوصول إلى الصفحات داخل الصورة عبر هذه الخاصية المريحة، مما يتيح التنقل السلس وتعديل الصفحات الفردية حسب الحاجة.
getBlocks()	احصل على الوصول إلى كتل GIF بسلاسة باستخدام هذه الخاصية، مما يسهل استرجاع وتعديل هياكل البيانات الأساسية للصورة.
isInterlaced()	يحدد ما إذا كانت الصورة متشابكة، مما يؤثر على عرضها أثناء التحميل.
getOriginalOptions()	استرجع الخيارات المستندة إلى إعدادات الملف الأصلية، وهي ضرورية للحفاظ على الدقة والاتساق في معالجة الصور وتعديلها.
addPage(RasterImage page)	أدمج صفحة جديدة بسلاسة في الصورة الحالية، مما يعزز محتواها ويوسع نطاقها.
getActiveFrame()	تحكم وتعديل الإطارات باستخدام هذه الخاصية، مما يتيح التنقل السلس وتعديل الإطار النشط داخل صورة GIF.
setActiveFrame(GifFrameBlock value)	تحكم وتعديل الإطارات باستخدام هذه الخاصية، مما يتيح التنقل السلس وتعديل الإطار النشط داخل صورة GIF.
getBackgroundColor()	تحكم في لون خلفية صورة GIF باستخدام هذه الخاصية.
setBackgroundColor(Color value)	تحكم في لون خلفية صورة GIF باستخدام هذه الخاصية.
getBackgroundColorIndex()	تحكم في فهرس لون الخلفية لصورة GIF باستخدام هذه الخاصية.
setBackgroundColorIndex(byte value)	تحكم في فهرس لون الخلفية لصورة GIF باستخدام هذه الخاصية.
getPixelAspectRatio()	تحكم في نسبة أبعاد البكسل لصورة GIF باستخدام هذه الخاصية.
setPixelAspectRatio(byte value)	تحكم في نسبة أبعاد البكسل لصورة GIF باستخدام هذه الخاصية.
hasTransparentColor()	حدد ما إذا كان الإطار النشط لصورة GIF يتضمن لونًا شفافًا.
getTransparentColor()	استرجع اللون الشفاف للإطار النشط في صورة GIF.
setTransparentColor(boolean value)	حدد ما إذا كان الإطار النشط لصورة GIF يتضمن لونًا شفافًا.
hasBackgroundColor()	تحدد هذه الخاصية ما إذا كانت صورة GIF تحتوي على لون خلفية.
getImageOpacity()	استرجاع شفافية الإطار النشط داخل الصورة، مما يوفر نظرة على مستوى شفافتها.
resize(int newWidth, int newHeight, int resizeType)	يعيد تحجيم هذه الحالة من Image.
resize(int newWidth, int newHeight, ImageResizeSettings settings)	يعيد تحجيم هذه الحالة من Image.
resizeFullFrame(int newWidth, int newHeight, int resizeType)	إعادة تحجيم الصورة مع مراعاة الإطارات الكاملة لكل صفحة في ملف GIF، وبالتالي منع ظهور أي تشوهات محتملة.
rotateFlip(int rotateFlipType)	تنفيذ الدوران أو القلب أو كليهما على الإطار النشط فقط.
dither(int ditheringMethod, int bitsCount, IColorPalette customPalette)	تطبيق التمويه على الصورة الحالية.
crop(Rectangle rectangle)	قص الصورة باستخدام منطقة مستطيلة محددة.
adjustGamma(float gamma)	تحسين جودة الصورة عن طريق تطبيق تصحيح جاما.
filter(Rectangle rectangle, FilterOptionsBase options)	تطبيق مرشح محدد على المنطقة المخصصة من الصورة، مما يعزز جودتها البصرية أو يغير مظهرها حسب الرغبة.
setFrameTime(int time)	يضبط مدة كل إطار بالمللي ثانية، مما يضمن توقيتًا ثابتًا عبر تسلسل الصور.
adjustBrightness(int brightness)	يضبط سطوع الصورة وفقًا للمعامل `brightness` المحدد.
adjustContrast(float contrast)	يضبط تباين الصورة، معززًا أو مخفضًا الفرق في السطوع بين البكسلات.
adjustGamma(float gammaRed, float gammaGreen, float gammaBlue)	تصحيح الجاما للصورة يطبق تعديلًا غير خطي على قيم البكسل، معززًا أو مخفضًا السطوع بناءً على المعاملات المحددة لقنوات الأحمر والأخضر والأزرق.
grayscale()	تحويل الصورة إلى تمثيلها بالدرجات الرمادية يحول الصورة الملونة إلى نسخة رمادية عن طريق إزالة معلومات اللون مع الحفاظ على الإضاءة.
binarizeFixed(byte threshold)	تحويل الصورة إلى ثنائية باستخدام عتبة محددة مسبقًا يحول الصورة الرمادية أو الملونة إلى صورة ثنائية، حيث يتم تصنيف كل بكسل إما كأبيض أو أسود بناءً على ما إذا كانت قيمة شدتها تتجاوز العتبة المحددة.
binarizeOtsu()	تحويل الصورة إلى ثنائية باستخدام طريقة أوسو لتحديد العتبة هو أسلوب يُستخدم لتحديد القيمة المثلى للعتبة تلقائيًا لتحويل الصورة الرمادية إلى صورة ثنائية.
binarizeBradley(double brightnessDifference)	تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي مع عتبة الصورة المتكاملة هو أسلوب لتحويل الصورة الرمادية إلى صورة ثنائية.
orderBlocks()	ترتيب كتل GIF وفقًا لمواصفات GIF يضمن تخطيطًا صحيحًا للـ GIF والامتثال للمعيار.
clearBlocks()	مسح جميع كتل GIF يزيل أي بيانات موجودة مخزنة داخل الصورة.
insertBlock(int index, IGifBlock block)	إدراج كتلة GIF جديدة يتيح لك إضافة بيانات مخصصة في موقع محدد داخل الصورة.
addBlock(IGifBlock block)	إضافة كتلة GIF جديدة يتيح لك تضمين بيانات إضافية داخل الصورة.
removeBlock(IGifBlock block)	إزالة كتلة GIF تزيل بيانات محددة من الصورة، مما يوفر القدرة على تنظيف أو تعديل بنية الصورة.
resizeProportional(int newWidth, int newHeight, int resizeType)	إعادة التحجيم المتناسبة تحافظ على نسبة أبعاد الصورة أثناء تعديل حجمها، مما يضمن عدم ظهور الصورة مشوهة أو ممدودة.
rotate(float angle, boolean resizeProportionally, Color backgroundColor)	هذه الطريقة تدور الصورة حول نقطة مركزها.

Example: This example shows how to create a GIF image and save it to a file.

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

// إنشاء كتلة إطار GIF بحجم 100×100 بكسل.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
try {
    // ملء الكتلة بأكملها باللون الأحمر.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(firstBlock);
    com.aspose.imaging.brushes.SolidBrush brush = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());
    gr.fillRectangle(brush, firstBlock.getBounds());

    com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
    try {
        gifImage.save(dir + "output.gif");
    } finally {
        gifImage.dispose();
    }
} finally {
    firstBlock.dispose();
}

Example: Create multipage GIF image using single page raster images.

static void main(String[] args)
{
    // تحميل الإطارات
    RasterImage[] frames = loadFrames("Animation frames");

    // إنشاء صورة GIF باستخدام الإطار الأول
    try (GifImage image = new GifImage(new GifFrameBlock(frames[0])))
    {
        // إضافة إطارات إلى صورة GIF باستخدام طريقة AddPage
        for (int index = 1; index < frames.length; index++)
        {
            image.addPage(frames[index]);
        }

        // حفظ صورة GIF
        image.save("Multipage.gif");
    }

    // تحرير الموارد
    for (RasterImage frame : frames)
    {
        frame.close();
    }
}

private static RasterImage[] loadFrames(String directory)
{
    LinkedList<RasterImage> list = new LinkedList<RasterImage>();
    String[] fileList = new File(directory).list();
    if (fileList != null)
    {
        for (String filePath : fileList)
        {
            list.add((RasterImage) Image.load(filePath));
        }
    }
                
    return list.toArray(new RasterImage[0]);
}

Example: Export of part of animation from GIF image based on time interval.

try (Image image = Image.load("Animation.gif"))
{
    GifOptions options = new GifOptions();
    options.setFullFrame(true);
    final MultiPageOptions multiPageOptions = new MultiPageOptions();
    multiPageOptions.setMode(MultiPageMode.TimeInterval);
    multiPageOptions.setTimeInterval(new TimeInterval(0, 400));
    options.setMultiPageOptions(multiPageOptions);

    image.save("PartOfAnimation.gif", options);
}

GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette)

public GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette)

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

Parameters:

معامل	نوع	الوصف
firstFrame	GifFrameBlock	الإطار الأول لتهيئة صورة GIF به.
globalPalette	IColorPalette	اللوحة العامة للاستخدام. لاحظ أنه إذا كان كل من `firstFrame` و `globalPalette` قيمتهما null فسيتم استخدام اللوحة العامة الافتراضية.

GifImage(GifFrameBlock firstFrame)

public GifImage(GifFrameBlock firstFrame)

تصميم صور GIF يصبح سهلًا مع مُنشئ GifImage. باستخدام معلمة firstFrame فقط، ينتقل إلى عالم من التواصل البصري الديناميكي.

Parameters:

معامل	نوع	الوصف
firstFrame	GifFrameBlock	الإطار الأول لتهيئة صورة GIF به.

GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette, boolean isPaletteSorted, byte paletteColorResolution, byte paletteBackgroundColorIndex, byte aspectRatio, boolean hasTrailer)

public GifImage(GifFrameBlock firstFrame, IColorPalette globalPalette, boolean isPaletteSorted, byte paletteColorResolution, byte paletteBackgroundColorIndex, byte aspectRatio, boolean hasTrailer)

ابدأ بسهولة مع مُنشئ GifImage. باستخدام هذه الطريقة البسيطة، يمكنك الغوص في إنشاء صور GIF المتحركة بسهولة. فقط قدم firstFrame و globalPalette و paletteColorResolution و aspectRatio وغيرها من المعلمات، وستكون جاهزًا لإحياء مرئياتك.

Parameters:

معامل	نوع	الوصف
firstFrame	GifFrameBlock	الإطار الأول لتهيئة صورة GIF به.
globalPalette	IColorPalette	اللوحة العامة للاستخدام. لاحظ أنه إذا كان كل من `firstFrame` و `globalPalette` قيمتهما null فسيتم استخدام اللوحة العامة الافتراضية.
isPaletteSorted	boolean	إذا تم تعيينه إلى `true` تُرتّب اللوحة. لاحظ أن المعامل يُستخدم عندما لا تكون `globalPalette` null.
paletteColorResolution	byte	دقة ألوان اللوحة. لاحظ أن المعامل يُستخدم عندما لا تكون `globalPalette` null.
paletteBackgroundColorIndex	byte	فهرس لون خلفية اللوحة.
aspectRatio	byte	نسبة العرض إلى الارتفاع.
hasTrailer	boolean	إذا تم تعيينه إلى `true` تحتوي صورة GIF على مقطع نهائي، وإلا لن يُكتب أي مقطع نهائي في نهاية التدفق.

getFileFormat()

public long getFileFormat()

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

Returns: long

hasTrailer()

public boolean hasTrailer()

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

Returns: boolean - true إذا كان GIF يحتوي على مقبض النهاية؛ وإلا false.

setTrailer(boolean value)

public void setTrailer(boolean value)

Parameters:

معامل	نوع	الوصف
value	boolean	`true` إذا كان GIF يحتوي على مقبض النهاية؛ وإلا `false`.

isPaletteSorted()

public boolean isPaletteSorted()

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

Returns: منطقي - true إذا كانت اللوحة مرتبة؛ وإلا false.

setPaletteSorted(boolean value)

public void setPaletteSorted(boolean value)

Parameters:

معامل	نوع	الوصف
value	boolean	`true` إذا كانت اللوحة مرتبة؛ وإلا `false`.

getLoopsCount()

public int getLoopsCount()

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

Returns: int - عدد الحلقات أو 1 (القيمة الافتراضية)

setLoopsCount(int value)

public void setLoopsCount(int value)

Parameters:

معامل	نوع	الوصف
value	int	عدد الحلقات أو 1 (القيمة الافتراضية)

getPaletteColorResolutionBits()

public byte getPaletteColorResolutionBits()

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

Returns: byte - بتات دقة ألوان اللوحة.

setPaletteColorResolutionBits(byte value)

public void setPaletteColorResolutionBits(byte value)

Parameters:

معامل	نوع	الوصف
value	byte	بتات دقة ألوان اللوحة.

getPageCount()

public int getPageCount()

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

Returns: int - عدد الصفحات.

getPages()

public Image[] getPages()

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

Returns: com.aspose.imaging.Image[] - الصفحات.

getBlocks()

public IGifBlock[] getBlocks()

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

Returns: com.aspose.imaging.fileformats.gif.IGifBlock[] - كتل GIF.

isInterlaced()

public boolean isInterlaced()

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

Returns: boolean - true إذا كانت نسخة الصورة هذه متشابكة؛ وإلا false.

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.

addPage(RasterImage page)

public void addPage(RasterImage page)

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

Parameters:

معامل	نوع	الوصف
page	RasterImage	الصفحة المراد إضافتها.

Example: Create multipage GIF image using single page raster images.

static void main(String[] args)
{
    // تحميل الإطارات
    RasterImage[] frames = loadFrames("Animation frames");

    // إنشاء صورة GIF باستخدام الإطار الأول
    try (GifImage image = new GifImage(new GifFrameBlock(frames[0])))
    {
        // إضافة إطارات إلى صورة GIF باستخدام طريقة AddPage
        for (int index = 1; index < frames.length; index++)
        {
            image.addPage(frames[index]);
        }

        // حفظ صورة GIF
        image.save("Multipage.gif");
    }

    // تحرير الموارد
    for (RasterImage frame : frames)
    {
        frame.close();
    }
}

private static RasterImage[] loadFrames(String directory)
{
    LinkedList<RasterImage> list = new LinkedList<RasterImage>();
    String[] fileList = new File(directory).list();
    if (fileList != null)
    {
        for (String filePath : fileList)
        {
            list.add((RasterImage) Image.load(filePath));
        }
    }
                
    return list.toArray(new RasterImage[0]);
}

getActiveFrame()

public GifFrameBlock getActiveFrame()

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

Returns: GifFrameBlock - the active frame.

Example: The following example shows how to remove all blocks from a GIF image.

com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }

    System.out.println("Clear all the blocks");
    gifImage.clearBlocks();

    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

// المخرجات تبدو هكذا:
// حجم الإطار النشط: { Width = 100, Height = 100}
// امسح جميع الكتل
// الإطار النشط غير مُحدد

setActiveFrame(GifFrameBlock value)

public void setActiveFrame(GifFrameBlock value)

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

Parameters:

معامل	نوع	الوصف
value	GifFrameBlock	الإطار النشط.

getBackgroundColor()

public Color getBackgroundColor()

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

Returns: Color - the background color.

setBackgroundColor(Color value)

public void setBackgroundColor(Color value)

Parameters:

معامل	نوع	الوصف
value	Color	لون الخلفية.

getBackgroundColorIndex()

public byte getBackgroundColorIndex()

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

Returns: byte - فهرس لون الخلفية.

setBackgroundColorIndex(byte value)

public void setBackgroundColorIndex(byte value)

Parameters:

معامل	نوع	الوصف
value	byte	فهرس لون الخلفية.

getPixelAspectRatio()

public byte getPixelAspectRatio()

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

Returns: byte - نسبة أبعاد البكسل.

setPixelAspectRatio(byte value)

public void setPixelAspectRatio(byte value)

Parameters:

معامل	نوع	الوصف
value	byte	نسبة أبعاد البكسل.

hasTransparentColor()

public boolean hasTransparentColor()

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

Returns: boolean - قيمة تشير إلى ما إذا كان الإطار النشط يحتوي على لون شفاف.

getTransparentColor()

public Color getTransparentColor()

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

Returns: Color - active frame transparent color.

setTransparentColor(boolean value)

public void setTransparentColor(boolean value)

Parameters:

معامل	نوع	الوصف
value	boolean	قيمة تشير إلى ما إذا كان الإطار النشط له لون شفاف.

hasBackgroundColor()

public boolean hasBackgroundColor()

تحدد هذه الخاصية ما إذا كانت صورة GIF تحتوي على لون خلفية. إذا كان صحيحًا، فإنها تشير إلى أن الصورة تشمل لون خلفية.

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

getImageOpacity()

public float getImageOpacity()

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

قيمة الشفافية بين 0.0 (شفاف بالكامل) و 1.0 (معتم بالكامل).

Returns: عائم - شفافية هذه الصورة (الإطار النشط).

resize(int newWidth, int newHeight, int resizeType)

public void resize(int newWidth, int newHeight, int resizeType)

يعيد تحجيم هذه الحالة من Image.

Parameters:

معامل	نوع	الوصف
newWidth	int	العرض الجديد.
newHeight	int	الارتفاع الجديد.
resizeType	int	نوع تغيير الحجم.

Example: This example loads a GIF image and resizes it using various resizing methods.

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

com.aspose.imaging.fileformats.gif.GifImage image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // تكبير بمقدار مرتين باستخدام إعادة أخذ عينات أقرب جار.
    image.resize(image.getWidth() * 2, image.getHeight() * 2, com.aspose.imaging.ResizeType.NearestNeighbourResample);
    image.save(dir + "upsample.nearestneighbour.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // تصغير بمقدار مرتين باستخدام إعادة أخذ عينات أقرب جار.
    image.resize(image.getWidth() / 2, image.getHeight() / 2, com.aspose.imaging.ResizeType.NearestNeighbourResample);
    image.save(dir + "downsample.nearestneighbour.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // تكبير بمقدار مرتين باستخدام إعادة أخذ عينات ثنائية الخطية.
    image.resize(image.getWidth() * 2, image.getHeight() * 2, com.aspose.imaging.ResizeType.BilinearResample);
    image.save(dir + "upsample.bilinear.gif");
} finally {
    image.dispose();
}

image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    // تصغير بمقدار مرتين باستخدام إعادة أخذ عينات ثنائية الخطية.
    image.resize(image.getWidth() / 2, image.getHeight() / 2, com.aspose.imaging.ResizeType.BilinearResample);
    image.save(dir + "downsample.bilinear.gif");
} finally {
    image.dispose();
}

resize(int newWidth, int newHeight, ImageResizeSettings settings)

public void resize(int newWidth, int newHeight, ImageResizeSettings settings)

يعيد تحجيم هذه الحالة من Image.

Parameters:

معامل	نوع	الوصف
newWidth	int	العرض الجديد.
newHeight	int	الارتفاع الجديد.
settings	ImageResizeSettings	الإعدادات.

Example: This example loads a GIF image and resizes it using various resizing settings.

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

com.aspose.imaging.ImageResizeSettings resizeSettings = new com.aspose.imaging.ImageResizeSettings();

// الخوارزمية التكيفية المستندة إلى الدالة الكسرية الموزونة والمختلطة واستيفاء lanczos3.
resizeSettings.setMode(com.aspose.imaging.ResizeType.AdaptiveResample);

// المرشح المستطيل الصغير
resizeSettings.setFilterType(com.aspose.imaging.ImageFilterType.SmallRectangular);

// عدد الألوان في لوحة الألوان.
resizeSettings.setEntriesCount(256);

// لم يتم استخدام تقليل ألوان الصورة
resizeSettings.setColorQuantizationMethod(com.aspose.imaging.ColorQuantizationMethod.None);

// طريقة إقليدية
resizeSettings.setColorCompareMethod(com.aspose.imaging.ColorCompareMethod.Euclidian);

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // قُم بتقليل الحجم بمقدار مرتين باستخدام إعادة أخذ عينات تكيفية.
    gifImage.resize(image.getWidth() / 2, image.getHeight() / 2, resizeSettings);

    // احفظ إلى PNG
    gifImage.save(dir + "downsample.adaptive.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

resizeFullFrame(int newWidth, int newHeight, int resizeType)

public void resizeFullFrame(int newWidth, int newHeight, int resizeType)

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

Parameters:

معامل	نوع	الوصف
newWidth	int	العرض الجديد.
newHeight	int	الارتفاع الجديد.
resizeType	int	نوع تغيير الحجم.

rotateFlip(int rotateFlipType)

public void rotateFlip(int rotateFlipType)

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

Parameters:

معامل	نوع	الوصف
rotateFlipType	int	نوع تدوير القليب.

Example: This example loads a GIF image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.


// فئة المساعد المستخدمة في المثال الرئيسي أدناه.
class Utils {
    // طريقة المساعد للحصول على تمثيل نصي لصيغة الملف.
    public String getRotateFlipTypeString(int rotateFlipType) {
        if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipNone) {
            return "RotateNoneFlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipNone) {
            return "Rotate90FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipNone) {
            return "Rotate180FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipNone) {
            return "Rotate270FlipNone";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipX) {
            return "RotateNoneFlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipX) {
            return "Rotate90FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipX) {
            return "Rotate180FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipX) {
            return "Rotate270FlipX";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipY) {
            return "RotateNoneFlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipY) {
            return "Rotate90FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipY) {
            return "Rotate180FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipY) {
            return "Rotate270FlipY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.RotateNoneFlipXY) {
            return "RotateNoneFlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate90FlipXY) {
            return "Rotate90FlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate180FlipXY) {
            return "Rotate180FlipXY";
        } else if (rotateFlipType == com.aspose.imaging.RotateFlipType.Rotate270FlipXY) {
            return "Rotate270FlipXY";
        } else {
            return "UNDEFINED";
        }
    }
}

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

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

int[] rotateFlipTypes = new int[]
        {
                com.aspose.imaging.RotateFlipType.Rotate90FlipNone,
                com.aspose.imaging.RotateFlipType.Rotate90FlipX,
                com.aspose.imaging.RotateFlipType.Rotate90FlipXY,
                com.aspose.imaging.RotateFlipType.Rotate90FlipY,
        };

for (int rotateFlipType : rotateFlipTypes) {
    // قم بالدوران، والقلّب، واحفظ إلى ملف الإخراج.
    com.aspose.imaging.fileformats.gif.GifImage image = (com.aspose.imaging.fileformats.gif.GifImage) com.aspose.imaging.Image.load(dir + "sample.gif");
    try {
        image.rotateFlip(rotateFlipType);
        image.save(dir + "sample." + utils.getRotateFlipTypeString(rotateFlipType) + ".png", new com.aspose.imaging.imageoptions.PngOptions());
    } finally {
        image.dispose();
    }
}

dither(int ditheringMethod, int bitsCount, IColorPalette customPalette)

public void dither(int ditheringMethod, int bitsCount, IColorPalette customPalette)

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

Parameters:

معامل	نوع	الوصف
ditheringMethod	int	طريقة التمويه.
bitsCount	int	عدد البتات النهائي للتمويه.
customPalette	IColorPalette	لوحة الألوان المخصصة للتمويه.

Example: The following example loads a GIF image and performs threshold and floyd dithering using different palette depth.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // نفّذ تلوين بالعتبة باستخدام لوحة ألوان 4-بت تحتوي على 16 لونًا.
    // كلما زادت عدد البتات المحددة، ارتفعت الجودة وزاد حجم الصورة الناتجة.
    // لاحظ أن لوحات الألوان 1-بت، 4-بت و8-بت فقط هي المدعومة حاليًا.
    gifImage.dither(com.aspose.imaging.DitheringMethod.ThresholdDithering, 4, null);

    gifImage.save(dir + "sample.ThresholdDithering4.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // نفّذ تلوين فلويد باستخدام لوحة ألوان 1-بت تحتوي فقط على لونين - أسود وأبيض.
    // كلما زادت عدد البتات المحددة، ارتفعت الجودة وزاد حجم الصورة الناتجة.
    // لاحظ أن لوحات الألوان 1-بت، 4-بت و8-بت فقط هي المدعومة حاليًا.
    gifImage.dither(com.aspose.imaging.DitheringMethod.FloydSteinbergDithering, 1, null);

    gifImage.save(dir + "sample.FloydSteinbergDithering1.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

crop(Rectangle rectangle)

public void crop(Rectangle rectangle)

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

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل.

Example: The following example crops a GIF image. المثال التالي يقتطع صورة GIF. يتم تحديد منطقة القص عبر Aspose.Imaging.Rectangle.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // قص الصورة. منطقة القص هي المنطقة المركزية المستطيلة للصورة.
    com.aspose.imaging.Rectangle area = new com.aspose.imaging.Rectangle(
            gifImage.getWidth() / 4,
            gifImage.getHeight() / 4,
            gifImage.getWidth() / 2,
            gifImage.getHeight() / 2);
    gifImage.crop(area);

    // احفظ الصورة المقتطعة بصيغة PNG
    gifImage.save(dir + "sample.Crop.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustGamma(float gamma)

public void adjustGamma(float gamma)

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

Parameters:

معامل	نوع	الوصف
غاما	float	معامل غاما للقنوات الحمراء والخضراء والزرقاء

Example: The following example performs gamma-correction of a GIF image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تعيين معامل غاما للقنوات الحمراء والخضراء والزرقاء.
    gifImage.adjustGamma(2.5f);
    gifImage.save(dir + "sample.AdjustGamma.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

public void filter(Rectangle rectangle, FilterOptionsBase options)

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

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل.
options	FilterOptionsBase	الخيارات.

Example: The following example applies various types of filters to a GIF image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح متوسط بحجم مستطيل 5 على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.MedianFilterOptions(5));
    gifImage.save(dir + "sample.MedianFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح تنعيم ثنائي الجانب بحجم نواة 5 على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.BilateralSmoothingFilterOptions(5));
    gifImage.save(dir + "sample.BilateralSmoothingFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح تمويه غاوسي بنصف قطر 5 وقيمة سيغما 4.0 على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.GaussianBlurFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.GaussianBlurFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح غاوس-واينر بنصف قطر 5 وقيمة تمهيد 4.0 على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.GaussWienerFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.GaussWienerFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح حركة واينر بطول 5، قيمة تمهيد 4.0 وزاوية 90.0 درجة على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.MotionWienerFilterOptions(10, 1.0, 90.0));
    gifImage.save(dir + "sample.MotionWienerFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تطبيق مرشح تعزيز الحدة بحجم نواة 5 وقيمة سيغما 4.0 على الصورة بالكامل.
    gifImage.filter(gifImage.getBounds(), new com.aspose.imaging.imagefilters.filteroptions.SharpenFilterOptions(5, 4.0));
    gifImage.save(dir + "sample.SharpenFilter.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

setFrameTime(int time)

public void setFrameTime(int time)

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

Parameters:

معامل	نوع	الوصف
الوقت	int	وقت مدة الإطار بالمللي ثانية.

adjustBrightness(int brightness)

public void adjustBrightness(int brightness)

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

Parameters:

معامل	نوع	الوصف
brightness	int	قيمة السطوع.

Example: The following example performs brightness correction of a GIF image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // حدد قيمة السطوع. القيم المقبولة للسطوع تقع في النطاق [-255، 255].
    gifImage.adjustBrightness(50);
    gifImage.save(dir + "sample.AdjustBrightness.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustContrast(float contrast)

public void adjustContrast(float contrast)

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

Parameters:

معامل	نوع	الوصف
contrast	float	قيمة التباين (في النطاق [-100؛ 100])

Example: The following example performs contrast correction of a GIF image.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // حدد قيمة التباين. القيم المقبولة للتباين تقع في النطاق [-100f، 100f].
    gifImage.adjustContrast(50f);
    gifImage.save(dir + "sample.AdjustContrast.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

adjustGamma(float gammaRed, float gammaGreen, float gammaBlue)

public void adjustGamma(float gammaRed, float gammaGreen, float gammaBlue)

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

Parameters:

معامل	نوع	الوصف
gammaRed	float	معامل غاما للقناة الحمراء
gammaGreen	float	معامل غاما للقناة الخضراء
gammaBlue	float	معامل غاما للقناة الزرقاء

Example: The following example performs gamma-correction of a GIF image applying different coefficients for color components.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // تعيين معاملات غاما الفردية للقنوات الحمراء والخضراء والزرقاء.
    gifImage.adjustGamma(1.5f, 2.5f, 3.5f);
    gifImage.save(dir + "sample.AdjustGamma.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

grayscale()

public void grayscale()

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

Example: The following example transforms a colored GIF image to its grayscale representation. المثال التالي يحول صورة GIF ملونة إلى تمثيل التدرج الرمادي الخاص بها. الصور ذات التدرج الرمادي تتكون حصريًا من درجات الرمادي وتحمل فقط معلومات الشدة.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    gifImage.grayscale();
    gifImage.save(dir + "sample.Grayscale.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeFixed(byte threshold)

public void binarizeFixed(byte threshold)

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

Parameters:

معامل	نوع	الوصف
threshold	byte	قيمة العتبة. إذا كانت قيمة الرمادي المقابلة للبكسل أكبر من العتبة، سيتم تعيين القيمة 255 لها، وإلا 0.

Example: The following example binarizes a GIF image with the predefined threshold. المثال التالي يثنِّي صورة GIF باستخدام العتبة المحددة مسبقًا. الصور الثنائية تحتوي فقط على لونين - أسود وأبيض.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage djvuImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // حوّل الصورة إلى ثنائية باستخدام قيمة العتبة 127.
    // إذا كانت قيمة الرمادي المقابلة للبكسل أكبر من 127، سيتم تعيين قيمة 255 له، وإلا ستكون 0.
    djvuImage.binarizeFixed((byte) 127);
    djvuImage.save(dir + "sample.BinarizeFixed.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeOtsu()

public void binarizeOtsu()

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

Example: The following example binarizes a GIF image with Otsu thresholding. المثال التالي يثنِّي صورة GIF باستخدام عتبة أوتسو. الصور الثنائية تحتوي فقط على لونين - أسود وأبيض.

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

com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    com.aspose.imaging.fileformats.gif.GifImage gifImage = (com.aspose.imaging.fileformats.gif.GifImage) image;

    // حوّل الصورة إلى ثنائية باستخدام عتبة أوتسو.
    gifImage.binarizeOtsu();
    gifImage.save(dir + "sample.BinarizeOtsu.png", new com.aspose.imaging.imageoptions.PngOptions());
} finally {
    image.dispose();
}

binarizeBradley(double brightnessDifference)

public void binarizeBradley(double brightnessDifference)

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

Parameters:

معامل	نوع	الوصف
brightnessDifference	double	فرق السطوع بين البكسل ومتوسط نافذة بحجم s × s من البكسلات المتمركزة حول هذا البكسل.

orderBlocks()

public void orderBlocks()

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

clearBlocks()

public void clearBlocks()

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

Example: The following example shows how to remove all blocks from a GIF image.

com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }

    System.out.println("Clear all the blocks");
    gifImage.clearBlocks();

    if (gifImage.getActiveFrame() != null) {
        System.out.println("Active frame size: " + gifImage.getActiveFrame().getSize());
    } else {
        System.out.println("Active frame is not set");
    }
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

// المخرجات تبدو هكذا:
// حجم الإطار النشط: { Width = 100, Height = 100}
// امسح جميع الكتل
// الإطار النشط غير مُحدد

insertBlock(int index, IGifBlock block)

public void insertBlock(int index, IGifBlock block)

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

Parameters:

معامل	نوع	الوصف
index	int	العنصر ذو الفهرس الصفري، الذي سيتم إدراج الكتلة فيه.
block	IGifBlock	كتلة GIF لإضافتها.

addBlock(IGifBlock block)

public void addBlock(IGifBlock block)

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

Parameters:

معامل	نوع	الوصف
block	IGifBlock	كتلة GIF لإضافتها.

Example: The following example shows how to compose an animated GIF image from individual GIF blocks.

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

// إنشاء صورة GIF بحجم 100 × 100 بكسل.
// الكتلة الأولى تكون سوداء بالكامل افتراضيًا.
com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock firstBlock = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);
com.aspose.imaging.fileformats.gif.GifImage gifImage = new com.aspose.imaging.fileformats.gif.GifImage(firstBlock);
try {
    // الدائرة الأولى حمراء
    com.aspose.imaging.brushes.SolidBrush brush1 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getRed());

    // الدائرة الثانية سوداء
    com.aspose.imaging.brushes.SolidBrush brush2 = new com.aspose.imaging.brushes.SolidBrush(com.aspose.imaging.Color.getBlack());

    // زيادة زاوية الشكل القوسي الأحمر تدريجيًا.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush1, block.getBounds(), 0, angle);

        gifImage.addBlock(block);
    }

    // زيادة زاوية القوس الأسود تدريجيًا وإزالة القوس الأحمر.
    for (int angle = 10; angle <= 360; angle += 10) {
        com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock block = new com.aspose.imaging.fileformats.gif.blocks.GifFrameBlock(100, 100);

        com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(block);
        gr.fillPie(brush2, block.getBounds(), 0, angle);
        gr.fillPie(brush1, block.getBounds(), angle, 360 - angle);

        gifImage.addBlock(block);
    }

    gifImage.save(dir + "animated_radar.gif");
} finally {
    firstBlock.dispose();
    gifImage.dispose();
}

removeBlock(IGifBlock block)

public void removeBlock(IGifBlock block)

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

Parameters:

معامل	نوع	الوصف
	block	IGifBlock

ملاحظة: لا تنسَ التخلص من الكتلة إذا لم تقم بإضافتها إلى أي GifImage آخر. |

resizeProportional(int newWidth, int newHeight, int resizeType)

public void resizeProportional(int newWidth, int newHeight, int resizeType)

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

Parameters:

معامل	نوع	الوصف
newWidth	int	العرض الجديد.
newHeight	int	الارتفاع الجديد.
resizeType	int	نوع تغيير الحجم.

rotate(float angle, boolean resizeProportionally, Color backgroundColor)

public void rotate(float angle, boolean resizeProportionally, Color backgroundColor)

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

Parameters:

معامل	نوع	الوصف
angle	float	زاوية الدوران بالدرجات. القيم الموجبة ستدور باتجاه عقارب الساعة.
resizeProportionally	boolean	إذا تم تعيينه إلى `true` سيتغير حجم الصورة وفقًا لإسقاطات المستطيل المدور (نقاط الزوايا)، وفي الحالة الأخرى تُترك الأبعاد دون تغيير وتُدور فقط `` image contents are rotated.
backgroundColor	Color	لون الخلفية.

GifBlocksRegistry IGifBlock