ImageSaveOptions

ImageSaveOptions class

Belge sayfalarını veya şekilleri görüntülere dönüştürürken ek seçeneklerin belirtilmesine olanak tanır.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Kaydetme Seçeneklerini Belirtin dokümantasyon makalesi.

public class ImageSaveOptions : FixedPageSaveOptions

yapıcılar

İsimTanım
ImageSaveOptions(SaveFormat)Oluşturulan görüntüleri the ‘ye kaydetmek için kullanılabilecek bu sınıfın yeni bir örneğini başlatır.Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps veyaSvg format.

Özellikleri

İsimTanım
AllowEmbeddingPostScriptFonts { get; set; }Kaydedildikten sonra TrueType yazı tiplerini bir belgeye gömerken PostScript ana hatlarıyla yazı tiplerinin gömülmesine izin verilip verilmeyeceğini belirten bir boole değeri alır veya ayarlar. Varsayılan değer:YANLIŞ .
ColorMode { get; set; }Renklerin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
CustomTimeZoneInfo { get; set; }Tarih/saat alanları için kullanılan özel yerel saat dilimini alır veya ayarlar.
DefaultTemplate { get; set; }Varsayılan şablonun yolunu alır veya ayarlar (dosya adı dahil). Bu özellik için varsayılan değer:boş dize (Empty).
Dml3DEffectsRenderingMode { get; set; }3B efektlerin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
virtual DmlEffectsRenderingMode { get; set; }DrawingML efektlerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
DmlRenderingMode { get; set; }DrawingML şekillerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
ExportGeneratorName { get; set; }Ne zamandoğru , Aspose.Words’ün adının ve sürümünün üretilen dosyalara yerleştirilmesine neden olur. Varsayılan değer:doğru .
GraphicsQualityOptions { get; set; }Görüntü oluşturma modunu ve kalitesini belirlemeye olanak tanır.Graphics nesne.
HorizontalResolution { get; set; }Oluşturulan görüntülerin yatay çözünürlüğünü inç başına nokta cinsinden alır veya ayarlar.
ImageBrightness { get; set; }Oluşturulan görüntülerin parlaklığını alır veya ayarlar.
ImageColorMode { get; set; }Oluşturulan görüntüler için renk modunu alır veya ayarlar.
ImageContrast { get; set; }Oluşturulan görüntülerin kontrastını alır veya ayarlar.
ImageSize { get; set; }Oluşturulan görüntünün boyutunu piksel cinsinden alır veya ayarlar.
ImlRenderingMode { get; set; }Mürekkep (InkML) nesnelerinin nasıl oluşturulacağını belirleyen bir değer alır veya ayarlar.
JpegQuality { get; set; }Oluşturulan JPEG görüntülerinin kalitesini belirleyen bir değer alır veya ayarlar.
MemoryOptimization { get; set; }Belgeyi kaydetmeden önce bellek optimizasyonunun gerçekleştirilip gerçekleştirilmeyeceğini belirleyen değeri alır veya ayarlar. Bu özellik için varsayılan değer:YANLIŞ .
MetafileRenderingOptions { get; }Oluşturulan çıktıda meta dosyalarının nasıl ele alınacağını belirlemeye izin verir.
NumeralFormat { get; set; }Alır veya ayarlarNumeralFormat rakamların oluşturulması için kullanılır. Avrupa rakamları varsayılan olarak kullanılır.
virtual OptimizeOutput { get; set; }Bayrak, çıktıyı optimize etmenin gerekli olup olmadığını belirtir. Bu bayrak ayarlanırsa, yedekli iç içe tuvaller ve boş tuvaller kaldırılır, ayrıca aynı biçimlendirmeye sahip komşu glifler birleştirilir. Not: Aşağıdaki durumlarda içerik görüntüsünün doğruluğu etkilenebilir: bu özellik şu şekilde ayarlandı:doğru . Varsayılan:YANLIŞ .
PageSavingCallback { get; set; }Bir belge sabit sayfa formatına aktarıldığında ayrı sayfaların nasıl kaydedileceğini kontrol etmenizi sağlar.
PageSet { get; set; }Oluşturulacak sayfaları alır veya ayarlar. Varsayılan, belgedeki tüm sayfalardır.
PaperColor { get; set; }Oluşturulan görüntüler için arka plan (kağıt) rengini alır veya ayarlar.
PixelFormat { get; set; }Oluşturulan görüntülerin piksel biçimini alır veya ayarlar.
PrettyFormat { get; set; }Ne zamandoğru uygulanabilir olduğu yerde güzel formatlarda çıktı. Varsayılan değer:YANLIŞ .
ProgressCallback { get; set; }Bir belge kaydedilirken çağrılır ve kaydetme işlemiyle ilgili verileri kabul eder.
Resolution { set; }Oluşturulan görüntüler için inç başına nokta sayısı cinsinden hem yatay hem de dikey çözünürlüğü ayarlar.
override SaveFormat { get; set; }Bu kaydetme seçenekleri nesnesi kullanılırsa, oluşturulan belge sayfalarının veya şekillerinin kaydedileceği biçimi belirtir. Raster olabilirTiff ,Png ,Bmp , Jpeg veya vektörEmf ,Eps , Svg .
Scale { get; set; }Oluşturulan görüntüler için yakınlaştırma faktörünü alır veya ayarlar.
TempFolder { get; set; }Bir DOC veya DOCX dosyasına kaydederken kullanılan geçici dosyalar için klasörü belirtir. Varsayılan olarak bu özellikhükümsüz ve hiçbir geçici dosya kullanılmaz.
ThresholdForFloydSteinbergDithering { get; set; }Floyd-Steinberg yöntemindeki ikilileştirme hatasının değerini belirleyen eşiği alır veya ayarlar. ne zamanImageBinarizationMethod dır-dirFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Görüntüleri 1 bpp format ‘ye dönüştürürken kullanılan yöntemi alır veya ayarlar.SaveFormat dır-dirTiff ve TiffCompression eşittirCcitt3 veyaCcitt4 .
TiffCompression { get; set; }Oluşturulan görüntüleri TIFF formatında kaydederken uygulanacak sıkıştırma türünü alır veya ayarlar.
UpdateCreatedTimeProperty { get; set; }Bir değer alır veya ayarlar.CreatedTime özellik kaydedilmeden önce güncellenir. Varsayılan değer:YANLIŞ ;
UpdateFields { get; set; }Belgeyi sabit bir sayfa formatında kaydetmeden önce belirli türlerdeki alanların güncellenmesi gerekip gerekmediğini belirleyen bir değer alır veya ayarlar. Bu özellik için varsayılan değer:doğru .
UpdateLastPrintedProperty { get; set; }Bir değer alır veya ayarlar.LastPrinted özellik kaydedilmeden önce güncellenir.
UpdateLastSavedTimeProperty { get; set; }Bir değer alır veya ayarlar.LastSavedTime özellik kaydedilmeden önce güncellenir.
UseAntiAliasing { get; set; }Oluşturma için kenar yumuşatma kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.
UseGdiEmfRenderer { get; set; }EMF. ‘ye kaydederken GDI+ veya Aspose.Words meta dosyası oluşturucusunun kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.
UseHighQualityRendering { get; set; }Yüksek kaliteli (yani yavaş) oluşturma algoritmalarının kullanılıp kullanılmayacağını belirleyen bir değer alır veya ayarlar.
VerticalResolution { get; set; }Oluşturulan görüntülerin dikey çözünürlüğünü inç başına nokta cinsinden alır veya ayarlar.

yöntemler

İsimTanım
Clone()Bu nesnenin derin bir kopyasını oluşturur.
override Equals(object)Belirtilen nesnenin değer olarak geçerli nesneye eşit olup olmadığını belirler.

Örnekler

Word belgesinin bir sayfasını şeffaf veya renkli arka plana sahip bir görüntüye dönüştürür.

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");

// Belgenin "Save" yöntemine aktarabileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
// bu yöntemin belgeyi bir görüntüye dönüştürme biçimini değiştirmek için.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);

// Şeffaf renk uygulamak için "PaperColor" özelliğini şeffaf renge ayarlayın
// belgeyi bir görüntüye dönüştürürken arka planı.
imgOptions.PaperColor = Color.Transparent;

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

// Bu rengi uygulamak için "PaperColor" özelliğini opak bir renge ayarlayın
// belgeyi bir görüntüye dönüştürdüğümüzde arka plan olarak.
imgOptions.PaperColor = Color.LightCoral;

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

Bir belgeyi JPEG olarak kaydederken sıkıştırmanın nasıl yapılandırılacağını gösterir.

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

// Belgenin "Save" yöntemine aktarabileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
// bu yöntemin belgeyi bir görüntüye dönüştürme biçimini değiştirmek için.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);

// Belgeyi oluştururken daha güçlü sıkıştırma kullanmak için "JpegQuality" özelliğini "10" olarak ayarlayın.
// Bu, belgenin dosya boyutunu azaltacaktır ancak görüntü, sıkıştırma kusurlarını daha belirgin bir şekilde görüntüleyecektir.
imageOptions.JpegQuality = 10;

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

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

// Belgeyi işlerken daha zayıf sıkıştırma kullanmak için "JpegQuality" özelliğini "100" olarak ayarlayın.
// Bu, dosya boyutunun artması pahasına görüntünün kalitesini artıracaktır.
imageOptions.JpegQuality = 100;

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

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

Bir belgeyi PNG’ye dönüştürürken çözünürlüğün nasıl belirleneceğini gösterir.

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");

            // Belgenin "Save" yöntemine aktarabileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
            // bu yöntemin belgeyi bir görüntüye dönüştürme biçimini değiştirmek için.
            ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

            // Belgeyi 72dpi çözünürlükte oluşturmak için "Çözünürlük" özelliğini "72" olarak ayarlayın.
            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
            // Belgeyi 300dpi çözünürlükte oluşturmak için "Çözünürlük" özelliğini "300" olarak ayarlayın.
            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

Ayrıca bakınız

ImagePixelFormat Enum ImageSavingArgs Class