CmxImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.VectorImage, com.aspose.imaging.VectorMultipageImage

All Implemented Interfaces: com.aspose.imaging.fileformats.cmx.ICmxImage

public class CmxImage extends VectorMultipageImage implements ICmxImage

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

المنشئات

المنشئ	الوصف
CmxImage(StreamContainer streamContainer, LoadOptions loadOptions)	ابدأ العمل مع الفئة CmxImage بسلاسة عن طريق إنشاء نسخة جديدة باستخدام معلمات streamContainer و loadOptions.

الطرق

طريقة	الوصف
getFileFormat()	استرجع تنسيق الملف للصورة بسهولة باستخدام هذه الخاصية سهلة الاستخدام.
getBitsPerPixel()	استرجع عمق البت للصورة بسهولة باستخدام هذه الخاصية سهلة الاستخدام.
getDefaultPage()	استرجع الصفحة الافتراضية للصورة بسهولة باستخدام هذه الخاصية البديهية.
isCached()	حدد ما إذا كانت بيانات الكائن مخزنة مؤقتًا حاليًا، مما يلغي الحاجة إلى قراءة البيانات.
getWidthF()	استرجع عرض الكائن بالبوصة باستخدام هذه الخاصية البديهية.
getHeightF()	احصل على ارتفاع الكائن، مقاسًا بالبوصة، بسهولة باستخدام هذه الخاصية سهلة الاستخدام.
getDocument()	استرجع مستند CMX بسهولة باستخدام هذه الخاصية البديهية.
getCmxPage()	استرجع صفحة CMX للصورة بسهولة باستخدام هذه الخاصية البديهية.
getPageCount()	استرجع العدد الإجمالي للصفحات في الصورة باستخدام هذه الخاصية البديهية.
getPages()	استرجع صفحات الصورة بسلاسة باستخدام هذه الخاصية البديهية.
cacheData()	قم بتخزين البيانات مؤقتًا لمنع التحميل الإضافي من المصدر الأساسي DataStreamSupporter باستخدام هذه الطريقة المريحة.
setPalette(IColorPalette palette, boolean updateColors)	خصّص لوحة ألوان الصورة باستخدام هذه الطريقة البديهية.

Example: The following example shows how to cache all pages of a CMX image.

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

// حمّل صورة من ملف CMX.
com.aspose.imaging.fileformats.cmx.CmxImage image = (com.aspose.imaging.fileformats.cmx.CmxImage) com.aspose.imaging.Image.load(dir + "sample.cmx");
try {
    // هذه العملية تُخزن في الذاكرة المؤقتة الصفحة الافتراضية فقط.
    image.cacheData();

    // خزن جميع الصفحات في الذاكرة المؤقتة بحيث لا يتم تحميل بيانات إضافية من تدفق البيانات الأساسي.
    for (com.aspose.imaging.fileformats.cmx.CmxImagePage page : image.getPages()) {
        page.cacheData();
    }
} finally {
    image.dispose();
}

CmxImage(StreamContainer streamContainer, LoadOptions loadOptions)

public CmxImage(StreamContainer streamContainer, LoadOptions loadOptions)

ابدأ العمل مع الفئة CmxImage بسلاسة عن طريق إنشاء نسخة جديدة باستخدام معلمات streamContainer و loadOptions. مثالي للمطورين الذين يبحثون عن طريقة مريحة لتحميل صور CMX من مصادر بيانات مختلفة مع تخصيص عملية التحميل حسب الحاجة.

Parameters:

معامل	نوع	الوصف
streamContainer	StreamContainer	حاوية الدفق.
loadOptions	LoadOptions	خيارات التحميل.

getFileFormat()

public long getFileFormat()

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

Returns: long - تنسيق الملف FileFormat.Cmx

getBitsPerPixel()

public int getBitsPerPixel()

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

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

getDefaultPage()

public Image getDefaultPage()

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

Returns: Image - the default page.

isCached()

public boolean isCached()

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

Returns: منطقي - true إذا كانت بيانات الكائن مخزنة مؤقتًا؛ وإلا false.

getWidthF()

public float getWidthF()

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

Returns: float - عرض الكائن، بالبوصة.

getHeightF()

public float getHeightF()

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

Returns: float - ارتفاع الكائن، بالبوصة.

getDocument()

public final CmxDocument getDocument()

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

Returns: CmxDocument - The CMX document.

getCmxPage()

public final CmxPage getCmxPage()

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

Returns: CmxPage - The CMX page.

getPageCount()

public int getPageCount()

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

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

getPages()

public Image[] getPages()

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

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

Example: The following example shows how to cache all pages of a CMX image.

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

// حمّل صورة من ملف CMX.
com.aspose.imaging.fileformats.cmx.CmxImage image = (com.aspose.imaging.fileformats.cmx.CmxImage) com.aspose.imaging.Image.load(dir + "sample.cmx");
try {
    // هذه العملية تُخزن في الذاكرة المؤقتة الصفحة الافتراضية فقط.
    image.cacheData();

    // خزن جميع الصفحات في الذاكرة المؤقتة بحيث لا يتم تحميل بيانات إضافية من تدفق البيانات الأساسي.
    for (com.aspose.imaging.fileformats.cmx.CmxImagePage page : image.getPages()) {
        page.cacheData();
    }
} finally {
    image.dispose();
}

cacheData()

public void cacheData()

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

Example: The following example shows how to cache all pages of a CMX image.

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

// حمّل صورة من ملف CMX.
com.aspose.imaging.fileformats.cmx.CmxImage image = (com.aspose.imaging.fileformats.cmx.CmxImage) com.aspose.imaging.Image.load(dir + "sample.cmx");
try {
    // هذه العملية تُخزن في الذاكرة المؤقتة الصفحة الافتراضية فقط.
    image.cacheData();

    // خزن جميع الصفحات في الذاكرة المؤقتة بحيث لا يتم تحميل بيانات إضافية من تدفق البيانات الأساسي.
    for (com.aspose.imaging.fileformats.cmx.CmxImagePage page : image.getPages()) {
        page.cacheData();
    }
} finally {
    image.dispose();
}

setPalette(IColorPalette palette, boolean updateColors)

public void setPalette(IColorPalette palette, boolean updateColors)

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

Parameters:

معامل	نوع	الوصف
palette	IColorPalette	لوحة الألوان لتعيينها.
updateColors	boolean	إذا تم تعيينه إلى `true` سيتم تحديث الألوان وفقًا للوحة الألوان الجديدة؛ وإلا ستبقى فهارس الألوان دون تغيير. لاحظ أن الفهارس غير المتغيرة قد تتسبب في تعطل الصورة عند التحميل إذا لم يكن لبعض الفهارس إدخالات مطابقة في لوحة الألوان.

CmxImagePage