ImageSaveOptions

ImageSaveOptions class

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

لمعرفة المزيد، قم بزيارةحدد خيارات الحفظ مقالة توثيقية.

public class ImageSaveOptions : FixedPageSaveOptions

المنشئون

اسموصف
ImageSaveOptions(SaveFormat)تهيئة مثيل جديد لهذه الفئة والذي يمكن استخدامه لحفظ الصور المعروضة في Tiff ,Png ,BmpJpeg ,Emf ,Eps أوSvg التنسيق.

الخصائص

اسموصف
AllowEmbeddingPostScriptFonts { get; set; }الحصول على قيمة منطقية أو تعيينها تشير إلى ما إذا كان سيتم السماح بدمج الخطوط باستخدام مخططات PostScript عند حفظ تضمين خطوط TrueType في مستند. القيمة الافتراضية هيخطأ شنيع .
ColorMode { get; set; }الحصول على أو تعيين قيمة تحدد كيفية عرض الألوان.
CustomTimeZoneInfo { get; set; }الحصول على أو تعيين المنطقة الزمنية المحلية المخصصة المستخدمة لحقول التاريخ/الوقت.
DefaultTemplate { get; set; }الحصول على أو تعيين المسار إلى القالب الافتراضي (بما في ذلك اسم الملف). القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty).
Dml3DEffectsRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض التأثيرات ثلاثية الأبعاد.
virtual DmlEffectsRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض تأثيرات DrawML.
DmlRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض أشكال DrawML.
ExportGeneratorName { get; set; }متىحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي .
GraphicsQualityOptions { get; set; }يسمح بتحديد وضع العرض والجودة لـGraphics الكائن.
HorizontalResolution { get; set; }الحصول على أو تعيين الدقة الأفقية للصور التي تم إنشاؤها، بالنقاط في البوصة.
ImageBrightness { get; set; }الحصول على أو ضبط السطوع للصور التي تم إنشاؤها.
ImageColorMode { get; set; }الحصول على أو تعيين وضع الألوان للصور التي تم إنشاؤها.
ImageContrast { get; set; }الحصول على أو ضبط تباين الصور التي تم إنشاؤها.
ImageSize { get; set; }الحصول على أو تعيين حجم الصورة التي تم إنشاؤها بالبكسل.
ImlRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض كائنات الحبر (InkML).
JpegQuality { get; set; }الحصول على أو تعيين قيمة تحدد جودة صور JPEG التي تم إنشاؤها.
MemoryOptimization { get; set; }الحصول على أو تحديد القيمة التي تحدد ما إذا كان يجب إجراء تحسين الذاكرة قبل حفظ المستند. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
MetafileRenderingOptions { get; }يسمح بتحديد كيفية التعامل مع ملفات التعريف في المخرجات المقدمة.
NumeralFormat { get; set; }يحصل على أو مجموعاتNumeralFormat تستخدم لعرض الأرقام. يتم استخدام الأرقام الأوروبية بشكل افتراضي.
virtual OptimizeOutput { get; set; }تشير العلامة إلى ما إذا كان مطلوبًا تحسين الإخراج. إذا تم تعيين هذه العلامة للوحات القماشية المتداخلة الزائدة وتمت إزالة اللوحات الفارغة، يتم أيضًا ربط الحروف الرسومية المجاورة بنفس التنسيق. ملاحظة: قد تتأثر دقة عرض المحتوى إذا تم تعيين هذه الخاصية علىحقيقي . الافتراضي هوخطأ شنيع .
PageSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الصفحات المنفصلة عند تصدير مستند إلى تنسيق صفحة ثابت.
PageSet { get; set; }الحصول على الصفحات المراد عرضها أو تعيينها. الافتراضي هو كافة الصفحات الموجودة في المستند.
PaperColor { get; set; }الحصول على أو تعيين لون الخلفية (الورق) للصور التي تم إنشاؤها.
PixelFormat { get; set; }الحصول على أو تعيين تنسيق البكسل للصور التي تم إنشاؤها.
PrettyFormat { get; set; }متىحقيقي، إخراج تنسيقات جميلة حيثما ينطبق ذلك. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم الاتصال به أثناء حفظ مستند ويقبل البيانات المتعلقة بتقدم الحفظ.
Resolution { set; }يضبط الدقة الأفقية والرأسية للصور التي تم إنشاؤها، بالنقاط في البوصة.
override SaveFormat { get; set; }يحدد التنسيق الذي سيتم به حفظ صفحات أو أشكال المستند المقدمة إذا تم استخدام كائن خيارات الحفظ هذا. يمكن أن يكون raster Tiff ,Png ,BmpJpeg أو ناقلاتEmf ,EpsSvg .
Scale { get; set; }الحصول على أو تعيين عامل التكبير للصور التي تم إنشاؤها.
TempFolder { get; set; }يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
ThresholdForFloydSteinbergDithering { get; set; }الحصول على أو تعيين الحد الأدنى الذي يحدد قيمة لخطأ الترميز الثنائي في طريقة Floyd-Steinberg. عندماImageBinarizationMethod يكونFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }الحصول على أو تعيين الطريقة المستخدمة أثناء تحويل الصور إلى تنسيق 1 bpp عندماSaveFormat يكونTiff و TiffCompression مساوي لCcitt3 أوCcitt4 .
TiffCompression { get; set; }الحصول على أو تعيين نوع الضغط الذي سيتم تطبيقه عند حفظ الصور التي تم إنشاؤها بتنسيق TIFF.
UpdateCreatedTimeProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانCreatedTime يتم تحديث الخاصية قبل الحفظ. القيمة الافتراضية هيخطأ شنيع ;
UpdateFields { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان يجب تحديث الحقول من أنواع معينة قبل حفظ المستند بتنسيق صفحة ثابت. القيمة الافتراضية لهذه الخاصية هيحقيقي .
UpdateLastPrintedProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانLastPrinted يتم تحديث الخاصية قبل الحفظ.
UpdateLastSavedTimeProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانLastSavedTime يتم تحديث الخاصية قبل الحفظ.
UseAntiAliasing { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان سيتم استخدام الصقل للعرض أم لا.
UseGdiEmfRenderer { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان سيتم استخدام عارض ملف التعريف GDI+ أو Aspose.Words عند الحفظ في EMF.
UseHighQualityRendering { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان سيتم استخدام خوارزميات عرض عالية الجودة (أي بطيئة) أم لا.
VerticalResolution { get; set; }الحصول على أو تعيين الدقة الرأسية للصور التي تم إنشاؤها، بالنقاط في البوصة.

طُرق

اسموصف
Clone()إنشاء نسخة عميقة لهذا الكائن.
override Equals(object)تحديد ما إذا كان الكائن المحدد يساوي قيمة الكائن الحالي.

أمثلة

يعرض صفحة من مستند Word في صورة ذات خلفية شفافة أو ملونة.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Font.Name = "Times New Roman";
builder.Font.Size = 24;
builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

builder.InsertImage(ImageDir + "Logo.jpg");

// أنشئ كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" المستند
// لتعديل الطريقة التي تعرض بها هذه الطريقة المستند إلى صورة.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// اضبط خاصية "PaperColor" على لون شفاف لتطبيق لون شفاف
// خلفية للمستند أثناء تحويله إلى صورة.
imgOptions.PaperColor = Color.Transparent;

doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.Transparent.png", imgOptions);

// اضبط خاصية "PaperColor" على لون معتم لتطبيق هذا اللون
// كخلفية للمستند عندما نعرضه على صورة.
imgOptions.PaperColor = Color.LightCoral;

doc.Save(ArtifactsDir + "ImageSaveOptions.PaperColor.LightCoral.png", imgOptions);

يوضح كيفية تكوين الضغط أثناء حفظ مستند بتنسيق JPEG.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");

// أنشئ كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" المستند
// لتعديل الطريقة التي تعرض بها هذه الطريقة المستند إلى صورة.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// اضبط خاصية "JpegQuality" على "10" لاستخدام ضغط أقوى عند عرض المستند.
// سيؤدي هذا إلى تقليل حجم ملف المستند، لكن الصورة ستعرض عناصر ضغط أكثر وضوحًا.
imageOptions.JpegQuality = 10;

doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

Assert.That(20000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg").Length));

// اضبط خاصية "JpegQuality" على "100" لاستخدام ضغط أضعف عند تقطيع المستند.
// سيؤدي هذا إلى تحسين جودة الصورة على حساب زيادة حجم الملف.
imageOptions.JpegQuality = 100;

doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);

Assert.That(60000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg").Length));

يوضح كيفية تحديد الدقة أثناء عرض مستند إلى PNG.

Document doc = new Document();
            DocumentBuilder builder = new DocumentBuilder(doc);

            builder.Font.Name = "Times New Roman";
            builder.Font.Size = 24;
            builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

            builder.InsertImage(ImageDir + "Logo.jpg");

            // أنشئ كائن "ImageSaveOptions" الذي يمكننا تمريره إلى طريقة "حفظ" المستند
            // لتعديل الطريقة التي تعرض بها هذه الطريقة المستند إلى صورة.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // اضبط خاصية "الدقة" على "72" لعرض المستند بدقة 72 نقطة في البوصة.
            options.Resolution = 72;

            doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

            Assert.That(120000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png").Length));

#if NET48 || JAVA
            Image image = Image.FromFile(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png");

            Assert.AreEqual(612, image.Width);
            Assert.AreEqual(792, image.Height);
#elif NET5_0_OR_GREATER || __MOBILE__
            using (SKBitmap image = SKBitmap.Decode(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png")) 
            {
                Assert.AreEqual(612, image.Width);
                Assert.AreEqual(792, image.Height);
            }
#endif
            // اضبط خاصية "الدقة" على "300" لعرض المستند بدقة 300 نقطة في البوصة.
            options.Resolution = 300;

            doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

            Assert.That(700000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png").Length));

#if NET48 || JAVA
            image = Image.FromFile(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png");

            Assert.AreEqual(2550, image.Width);
            Assert.AreEqual(3300, image.Height);
#elif NET5_0_OR_GREATER || __MOBILE__
            using (SKBitmap image = SKBitmap.Decode(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png")) 
            {
                Assert.AreEqual(2550, image.Width);
                Assert.AreEqual(3300, image.Height);
            }
#endif

أنظر أيضا

ImagePixelFormat Enum ImageSavingArgs Class