TgaImage

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

public class TgaImage extends RasterCachedImage

تعديل ملفات صور TGA النقطية باستخدام واجهة برمجة التطبيقات الخاصة بنا، المصممة لتنسيق TARGA (Truevision Advanced Raster Adapter)، مما يتيح تحميلًا سلسًا وتخصيصًا. يمكنك بسهولة تحديث الخصائص العامة مثل المؤلف، والطابع الزمني، ومعرّف الصورة، وإصدار البرنامج، مع استخدام إعدادات مختلفة للبتات لكل بكسل، وقناة ألفا، وشفافية اللون. بالإضافة إلى ذلك، يمكنك تصدير صور TGA إلى تنسيقات نقطية شائعة أخرى، مما يضمن التوافق لمشاريعك.

المنشئات

المنشئ	الوصف
TgaImage(String path)	يُهيئ كائنًا جديدًا من TgaImage باستخدام مسار الملف المقدم لتحميل محتوى الصورة.
TgaImage(RasterImage rasterImage)	أنشئ نسخة جديدة من فئة TgaImage عن طريق توفير كائن صورة نقطية.
TgaImage(InputStream stream)	قم بتهيئة نسخة جديدة من فئة TgaImage باستخدام تدفق لتحميل الصورة.

الطرق

طريقة	الوصف
getBitsPerPixel()	استرجع قيمة البتات لكل بكسل، مما يوفر معلومات أساسية عن عمق ألوان الصورة.
getBytesPerPixel()	احصل على قيمة البايتات لكل بكسل، التي تشير إلى مقدار الذاكرة التي يشغلها كل بكسل في الصورة.
hasAlpha()	استرجع قيمة منطقية تشير إلى ما إذا كان TgaImage يحتوي على قناة ألفا، مما يسهل تأثيرات الشفافية.
isGrayScale()	احصل على قيمة منطقية تشير إلى ما إذا كان TgaImage يمثل صورة رمادية.
getWidth()	استرجع عرض الصورة التي تمثلها هذه النسخة من TgaImage.
getHeight()	احصل على ارتفاع الصورة التي تحتويها هذه النسخة من TgaImage.
getFileFormat()	احصل على معلومات حيوية حول تنسيق ملف الصورة التي تمثلها هذه النسخة من TgaImage.
hasColorMap()	استرجع ما إذا كانت هذه النسخة من TgaImage تحتوي على خريطة ألوان.
getGammaValueNumerator()	يحصل على الجزء البسط من قيمة غاما، وهو ضروري لتمثيل الألوان بدقة في الصور.
getGammaValueDenominator()	يسترجع الجزء المقام من قيمة غاما، وهو عامل أساسي في تحديد تمثيل الألوان داخل الصور.
getPixelAspectRatioNumerator()	يسترجع المكوّن البسط لنسبة أبعاد البكسل، التي تؤثر على المظهر البصري للبكسلات داخل الصورة.
getPixelAspectRatioDenominator()	يسترجع الجزء المقام لنسبة أبعاد البكسل، وهو عامل حاسم في تحديد المظهر البصري للبكسلات داخل الصورة.
getXOrigin()	يحصل على الإحداثي الأفقي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).
setXOrigin(int value)	يضبط الإحداثي الأفقي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).
getYOrigin()	يحصل على الإحداثي الرأسي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).
setYOrigin(int value)	يضبط الإحداثي الرأسي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).
getImageId()	يحصل على المعرف الفريد المرتبط بالصورة.
setImageId(String value)	يضبط المعرف الفريد المرتبط بالصورة.
getAuthorComments()	يسترجع أو يضبط التعليقات التي قدمها مؤلف الصورة.
setAuthorComments(String value)	يسترجع أو يضبط التعليقات التي قدمها مؤلف الصورة.
getAuthorName()	يسترجع أو يضبط اسم المؤلف المرتبط بالصورة.
setAuthorName(String value)	يسترجع أو يضبط اسم المؤلف المرتبط بالصورة.
getDateTimeStamp()	يحصل على طابع التاريخ/الوقت.
setDateTimeStamp(Date value)	يضبط طابع التاريخ/الوقت.
getJobNameOrId()	يسترجع أو يضبط اسم الوظيفة أو المعرف المرتبط بالصورة.
setJobNameOrId(String value)	يسترجع أو يضبط اسم الوظيفة أو المعرف المرتبط بالصورة.
getJobTime()	يسترجع أو يضبط الطابع الزمني الذي يشير إلى وقت الوظيفة المرتبط بالصورة.
setJobTime(Date value)	يسترجع أو يضبط الطابع الزمني الذي يشير إلى وقت الوظيفة المرتبط بالصورة.
getTransparentColor()	يسترجع أو يضبط اللون الأساسي المرتبط بالصورة.
setTransparentColor(Color value)	يسترجع أو يضبط اللون الأساسي المرتبط بالصورة.
hasTransparentColor()	يسترجع أو يضبط قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على لون شفاف.
setTransparentColor(boolean value)	يسترجع أو يضبط قيمة منطقية تشير إلى ما إذا كانت الصورة تحتوي على لون شفاف.
getBackgroundColor()	يسترجع أو يضبط لون الخلفية للصورة.
setBackgroundColor(Color value)	يسترجع أو يضبط لون الخلفية للصورة.
hasBackgroundColor()	يسترجع أو يضبط قيمة تشير إلى ما إذا كانت الصورة تحتوي على لون خلفية.
setBackgroundColor(boolean value)	يسترجع أو يضبط قيمة تشير إلى ما إذا كانت الصورة تحتوي على لون خلفية.
getSoftwareVersion()	يسترجع أو يضبط إصدار البرنامج المرتبط بالصورة.
setSoftwareVersion(String value)	يسترجع أو يضبط إصدار البرنامج المرتبط بالصورة.
getSoftwareVersionLetter()	يسترجع أو يضبط المكوّن الحرفي لإصدار البرنامج المرتبط بالصورة.
setSoftwareVersionLetter(char value)	يسترجع أو يضبط المكوّن الحرفي لإصدار البرنامج المرتبط بالصورة.
getSoftwareVersionNumber()	يسترجع أو يضبط المكوّن الرقمي لإصدار البرنامج المرتبط بالصورة.
setSoftwareVersionNumber(int value)	يسترجع أو يضبط المكوّن الرقمي لإصدار البرنامج المرتبط بالصورة.
getSoftwareId()	يدير تعريف البرنامج (المعرف) المرتبط بالصورة، مع السماح بما يصل إلى 40 حرف ASCII.
setSoftwareId(String value)	يدير تعريف البرنامج (المعرف) المرتبط بالصورة، مع السماح بما يصل إلى 40 حرف ASCII.
op_Equality(TgaImage first, TgaImage second)	يُجري مقارنة مساواة بين صورتين TGA، مع مراعاة كل من الصورة الأولى والثانية المشاركة في عملية المقارنة.
op_Inequality(TgaImage first, TgaImage second)	يُجري مقارنة عدم مساواة بين صورتين TGA، مع تقييم كل من الصورة الأولى والثانية المشاركة في المقارنة.
deepClone()	ينتج نسخة مكررة من الكائن الحالي، مُنشئًا كائنًا جديدًا ينسخ جميع السمات والخصائص من الأصل.
deepClone(TgaImage tgaImage)	استنساخ خصائص كائن TgaImage آخر، وإنشاء نسخة جديدة بسمات مطابقة.
equals(TgaImage other)	في مقارنة مساواة، تُقَيِّم الطريقة ما إذا كانت نسخة TgaImage الحالية مساوية للصورة الثانية المقدمة كمعامل.
equals(Object other)	تُجري الطريقة مقارنة مساواة بين نسخة TgaImage الحالية وكائن آخر مُقدَّم كمعامل.
rotateFlip(int rotateFlipType)	تُمكِّن الطريقة “rotateFlip” من عمليات الدوران والقلب على الصورة.
hashCode()	استرجع رمز التجزئة للنسخة الحالية.
crop(Rectangle rectangle)	قم بقص الصورة إلى منطقة محددة.
crop(int leftShift, int rightShift, int topShift, int bottomShift)	قم بقص الصورة عن طريق تحديد إزاحات للحدود اليسرى، اليمنى، العليا والسفلى.
resize(int newWidth, int newHeight, ImageResizeSettings settings)	غيّر حجم الصورة مع تطبيق إعدادات محددة للحفاظ على الأبعاد المطلوبة ونسبة العرض إلى الارتفاع.
resize(int newWidth, int newHeight, int resizeType)	يضبط حجم الصورة باستخدام نوع تغيير حجم محدد، والذي يحدد كيفية تنفيذ عملية تغيير الحجم.
rotate(float angle, boolean resizeProportionally, Color backgroundColor)	يدور الصورة حول مركزها بزاوية محددة مع الحفاظ على تناسب الحجم وإبقاء لون الخلفية.

Example: Saving of the JPG image as a TGA image.

try (Image image = Image.load("test.jpg"))
{
    image.save("test.tga", new TgaOptions());
}

Example: Loading of the PNG image, conversion of it to the TgaImage and saving as a TGA image.

try (RasterImage image = (RasterImage)Image.load("test.png"))
{
    try (TgaImage tgaImage = new TgaImage(image))
    {
        tgaImage.save("test.tga");
    }
}

Example: Getting values of the public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    Date dateTimeStamp = image.getDateTimeStamp();
    String authorName = image.getAuthorName();
    String authorComments = image.getAuthorComments();
    String imageId = image.getImageId();
    String jobNameOrId = image.getJobNameOrId();
    Date jobTime = image.getJobTime();
    Color keyColor = image.getTransparentColor();
    String softwareId = image.getSoftwareId();
    String softwareVersion = image.getSoftwareVersion();
    char softwareVersionLetter = image.getSoftwareVersionLetter();
    int softwareVersionNumber = image.getSoftwareVersionNumber();
    int xOrigin = image.getXOrigin();
    int yOrigin = image.getYOrigin();
    int gammaValueDenominator = image.getGammaValueDenominator();
    int gammaValueNumerator = image.getGammaValueNumerator();
    boolean hasAlphaChannel = image.hasAlpha();
    boolean hasColorMap = image.hasColorMap();
    int height = image.getHeight();
    boolean isGrayScale = image.isGrayScale();
    int pixelAspectRatioDenominator = image.getPixelAspectRatioDenominator();
    int pixelAspectRatioNumerator = image.getPixelAspectRatioNumerator();
    Size size = image.getSize();
    int width = image.getWidth();
}

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

TgaImage(String path)

public TgaImage(String path)

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

Parameters:

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

TgaImage(RasterImage rasterImage)

public TgaImage(RasterImage rasterImage)

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

Parameters:

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

Example: Loading of the PNG image, conversion of it to the TgaImage and saving as a TGA image.

try (RasterImage image = (RasterImage)Image.load("test.png"))
{
    try (TgaImage tgaImage = new TgaImage(image))
    {
        tgaImage.save("test.tga");
    }
}

TgaImage(InputStream stream)

public TgaImage(InputStream stream)

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

Parameters:

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

getBitsPerPixel()

public int getBitsPerPixel()

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

Returns: int - بتات لكل بكسل.

getBytesPerPixel()

public final int getBytesPerPixel()

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

Returns: int - بايتات لكل بكسل.

hasAlpha()

public boolean hasAlpha()

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

Returns: boolean - قيمة تُظهر ما إذا كان هذا TgaImage يحتوي على قناة ألفا.

isGrayScale()

public final boolean isGrayScale()

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

Returns: boolean - قيمة تُظهر ما إذا كان هذا TgaImage بتدرج الرمادي.

getWidth()

public int getWidth()

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

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

getHeight()

public int getHeight()

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

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

getFileFormat()

public long getFileFormat()

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

Returns: long - معلومات حاسمة حول تنسيق ملف الصورة الممثلة بهذه الحالة من TgaImage.

hasColorMap()

public final boolean hasColorMap()

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

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

getGammaValueNumerator()

public final int getGammaValueNumerator()

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

Returns: int - الجزء البسط من قيمة الجاما، وهو أمر أساسي لتمثيل الألوان بدقة في الصور.

getGammaValueDenominator()

public final int getGammaValueDenominator()

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

Returns: int

getPixelAspectRatioNumerator()

public final int getPixelAspectRatioNumerator()

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

Returns: int

getPixelAspectRatioDenominator()

public final int getPixelAspectRatioDenominator()

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

Returns: int

getXOrigin()

public final int getXOrigin()

يحصل على الإحداثي الأفقي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).

Returns: int - إحداثي أفقي مطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يملك أصلًا في الزاوية السفلية اليسرى للشاشة.

setXOrigin(int value)

public final void setXOrigin(int value)

يضبط الإحداثي الأفقي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).

Parameters:

معامل	نوع	الوصف
value	int	إحداثي أفقي مطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يملك أصلًا في الزاوية السفلية اليسرى للشاشة.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getYOrigin()

public final int getYOrigin()

يحصل على الإحداثي الرأسي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).

Returns: int - إحداثي عمودي مطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يملك أصلًا في الزاوية السفلية اليسرى للشاشة.

setYOrigin(int value)

public final void setYOrigin(int value)

يضبط الإحداثي الرأسي المطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يكون أصله في الزاوية السفلية اليسرى للشاشة (مثال: سلسلة TARGA).

Parameters:

معامل	نوع	الوصف
value	int	إحداثي عمودي مطلق للزاوية السفلية اليسرى للصورة كما هو موضع على جهاز عرض يملك أصلًا في الزاوية السفلية اليسرى للشاشة.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getImageId()

public final String getImageId()

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

هذا الحقل الاختياري يحتوي على معلومات تعريفية حول الصورة. الحد الأقصى لطول هذا الحقل هو 255 بايت.

Returns: java.lang.String - المعرف الفريد المرتبط بالصورة.

setImageId(String value)

public final void setImageId(String value)

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

هذا الحقل الاختياري يحتوي على معلومات تعريفية حول الصورة. الحد الأقصى لطول هذا الحقل هو 255 بايت.

Parameters:

معامل	نوع	الوصف
value	java.lang.String	المعرف الفريد المرتبط بالصورة.

getAuthorComments()

public final String getAuthorComments()

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

Returns: java.lang.String

setAuthorComments(String value)

public final void setAuthorComments(String value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String

getAuthorName()

public final String getAuthorName()

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

Returns: java.lang.String

setAuthorName(String value)

public final void setAuthorName(String value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String	اسم المؤلف.

getDateTimeStamp()

public final Date getDateTimeStamp()

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

Returns: java.util.Date - طابع التاريخ/الوقت.

setDateTimeStamp(Date value)

public final void setDateTimeStamp(Date value)

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

Parameters:

معامل	نوع	الوصف
value	java.util.Date	طابع التاريخ/الوقت.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getJobNameOrId()

public final String getJobNameOrId()

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

Returns: java.lang.String - Job Name/ID.

setJobNameOrId(String value)

public final void setJobNameOrId(String value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String	Job Name/ID.

getJobTime()

public final Date getJobTime()

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

Returns: java.util.Date - Job Time.

setJobTime(Date value)

public final void setJobTime(Date value)

Parameters:

معامل	نوع	الوصف
value	java.util.Date	Job Time.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getTransparentColor()

public Color getTransparentColor()

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

يمكن اعتبار اللون المفتاح كـ \u2018background color\u2019 أو \u2018transparent color\u2019. هذا هو لون المنطقة \u2018non image\u2019 من الشاشة، وهو نفس اللون الذي ستُمسح إليه الشاشة إذا تم مسحها في التطبيق.

Returns: Color - Key Color.

setTransparentColor(Color value)

public void setTransparentColor(Color value)

Parameters:

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

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

hasTransparentColor()

public boolean hasTransparentColor()

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

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

setTransparentColor(boolean value)

public void setTransparentColor(boolean value)

Parameters:

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

getBackgroundColor()

public Color getBackgroundColor()

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

Returns: Color - the background color.

setBackgroundColor(Color value)

public void setBackgroundColor(Color value)

Parameters:

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

hasBackgroundColor()

public boolean hasBackgroundColor()

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

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

setBackgroundColor(boolean value)

public void setBackgroundColor(boolean value)

Parameters:

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

getSoftwareVersion()

public final String getSoftwareVersion()

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

Returns: java.lang.String - Software Version.

setSoftwareVersion(String value)

public final void setSoftwareVersion(String value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String	Software Version.

getSoftwareVersionLetter()

public final char getSoftwareVersionLetter()

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

Returns: char - جزء الحرف من نسخة البرنامج.

setSoftwareVersionLetter(char value)

public final void setSoftwareVersionLetter(char value)

Parameters:

معامل	نوع	الوصف
value	char	جزء الحرف من نسخة البرنامج.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getSoftwareVersionNumber()

public final int getSoftwareVersionNumber()

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

Returns: int - جزء الرقم من نسخة البرنامج.

setSoftwareVersionNumber(int value)

public final void setSoftwareVersionNumber(int value)

Parameters:

معامل	نوع	الوصف
value	int	جزء الرقم من نسخة البرنامج.

Example: Updating public properties of the loaded TGA image.

try (TgaImage image = (TgaImage)Image.load("test.tga"))
{
    image.setDateTimeStamp(new Date());
    image.setAuthorName("John Smith");
    image.setAuthorComments("Comment");
    image.setImageId("ImageId");
    image.setJobNameOrId("Important Job");
    image.setJobTime(new Date(0,0, 10));
    image.setTransparentColor(Color.fromArgb(123));
    image.setSoftwareId("SoftwareId");
    image.setSoftwareVersion("abc1");
    image.setSoftwareVersionLetter('a');
    image.setSoftwareVersionNumber(2);
    image.setXOrigin(1000);
    image.setYOrigin(1000);

    image.save("test.tga");
}

getSoftwareId()

public final String getSoftwareId()

يدير تعريف البرنامج (ID) المرتبط بالصورة، مع السماح بما يصل إلى 40 حرف ASCII. تُستخدم هذه الخاصية كوسيلة لتحديد البرنامج المستخدم في إنشاء الصورة أو معالجتها بشكل فريد، وتوفر بيانات وصفية قيمة لأغراض التنظيم والمعلومات.

Returns: java.lang.String - معرف البرنامج.

setSoftwareId(String value)

public final void setSoftwareId(String value)

Parameters:

معامل	نوع	الوصف
value	java.lang.String	معرف البرنامج.

op_Equality(TgaImage first, TgaImage second)

public static boolean op_Equality(TgaImage first, TgaImage second)

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

Parameters:

معامل	نوع	الوصف
first	TgaImage	الأولى TgaImage التي تشارك في المقارنة.
second	TgaImage	الثانية TgaImage التي تشارك في المقارنة.

Returns: boolean - نتائج المقارنة.

op_Inequality(TgaImage first, TgaImage second)

public static boolean op_Inequality(TgaImage first, TgaImage second)

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

Parameters:

معامل	نوع	الوصف
first	TgaImage	الأولى TgaImage التي تشارك في المقارنة.
second	TgaImage	الثانية TgaImage التي تشارك في المقارنة.

Returns: boolean - نتائج المقارنة.

deepClone()

public final TgaImage deepClone()

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

Returns: TgaImage - Returns a new object that is a copy of the current instance.

deepClone(TgaImage tgaImage)

public final void deepClone(TgaImage tgaImage)

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

Parameters:

معامل	نوع	الوصف
tgaImage	TgaImage	آخر TgaImage

equals(TgaImage other)

public final boolean equals(TgaImage other)

في مقارنة مساواة، تقيم الطريقة ما إذا كان كائن TgaImage الحالي يساوي الصورة الثانية المقدمة كمعامل. يُسهل هذا الإجراء تحديد ما إذا كانت صورتان بتنسيق TGA متطابقتين، مما يساعد في مهام معالجة ومقارنة الصور.

Parameters:

معامل	نوع	الوصف
other	TgaImage	الثانية TgaImage التي تشارك في المقارنة.

Returns: boolean - نتائج المقارنة.

equals(Object other)

public boolean equals(Object other)

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

Parameters:

معامل	نوع	الوصف
other	java.lang.Object	الثانية TgaImage التي تشارك في المقارنة.

Returns: boolean - نتائج المقارنة.

rotateFlip(int rotateFlipType)

public void rotateFlip(int rotateFlipType)

تتيح طريقة “rotateFlip” عمليات تدوير وقلب الصورة. توفر هذه الطريقة وظائف متعددة لتعديل اتجاه الصورة، مما يسمح للمستخدمين بإجراء التدويرات والقلب وفقًا لمتطلباتهم، وتسهّل مهام معالجة الصور بكفاءة داخل تطبيقات البرمجيات.

Parameters:

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

hashCode()

public int hashCode()

استرجع قيمة التجزئة (hash code) للكائن الحالي. ومع ذلك، من المهم ملاحظة أن هذه القيمة قد لا تكون مناسبة للاستخدام كمفتاح، خاصةً لأن كائنات فئة TgaImage ليست ثابتة.

Returns: int - قيمة التجزئة لهذا الكائن.

crop(Rectangle rectangle)

public void crop(Rectangle rectangle)

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

Parameters:

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

crop(int leftShift, int rightShift, int topShift, int bottomShift)

public void crop(int leftShift, int rightShift, int topShift, int bottomShift)

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

Parameters:

معامل	نوع	الوصف
leftShift	int	الإزاحة اليسرى.
rightShift	int	الإزاحة اليمنى.
topShift	int	الإزاحة العلوية.
bottomShift	int	الإزاحة السفلية.

resize(int newWidth, int newHeight, ImageResizeSettings settings)

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

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

Parameters:

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

resize(int newWidth, int newHeight, int resizeType)

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

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

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	لون الخلفية.