ImageSaveOptions

ImageSaveOptions class

Belge sayfalarını veya şekillerini resimlere dönüştürürken ek seçeneklerin belirtilmesine olanak tanır.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Kaydetme Seçeneklerini Belirleyin belgeleme makalesi.

public class ImageSaveOptions : FixedPageSaveOptions

yapıcılar

İsimTanım
ImageSaveOptions(SaveFormat)Bu sınıfın, işlenmiş görüntüleri içinde kaydetmek için kullanılabilecek yeni bir örneğini başlatır.Tiff ,Png ,Bmp , Jpeg ,Emf ,Eps , WebP veyaSvg biçim.

Özellikleri

İsimTanım
AllowEmbeddingPostScriptFonts { get; set; }PostScript anahatlarıyla yazı tiplerinin gömülmesine izin verilip verilmeyeceğini belirten bir Boole değeri alır veya ayarlar. Bir belge kaydedildiğinde TrueType yazı tiplerini gömerken. Varsayılan değerYANLIŞ .
ColorMode { get; set; }Renklerin nasıl işleneceğini 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 şablona giden yolu alır veya ayarlar (dosya adı dahil). Bu özellik için varsayılan değerboş dize (Empty ).
Dml3DEffectsRenderingMode { get; set; }3B efektlerin nasıl işleneceğini belirleyen bir değer alır veya ayarlar.
virtual DmlEffectsRenderingMode { get; set; }DrawingML efektlerinin nasıl işleneceğini belirleyen bir değer alır veya ayarlar.
DmlRenderingMode { get; set; }DrawingML şekillerinin nasıl işleneceğini belirleyen bir değer alır veya ayarlar.
ExportGeneratorName { get; set; }Ne zamandoğru , Aspose.Words adının ve sürümünün üretilen dosyalara gömülmesine neden olur. Varsayılan değerdoğru .
GraphicsQualityOptions { get; set; }İşleme modunu ve kalitesini belirtmenize olanak tanırGraphics 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 bir görüntünün boyutunu piksel cinsinden alır veya ayarlar.
ImlRenderingMode { get; set; }Mürekkep (InkML) nesnelerinin nasıl işleneceğini belirleyen bir değer alır veya ayarlar.
JpegQuality { get; set; }Oluşturulan JPEG görüntülerinin kalitesini belirleyen bir değeri alır veya ayarlar.
MemoryOptimization { get; set; }Belgeyi kaydetmeden önce bellek optimizasyonunun yapılıp yapılmayacağını belirleyen değeri alır veya ayarlar. Bu özelliğin varsayılan değeriYANLIŞ .
MetafileRenderingOptions { get; }Meta dosyalarının işlenen çıktıda nasıl işleneceğini belirtmeye izin verir.
NumeralFormat { get; set; }Alır veya ayarlarNumeralFormat rakamların işlenmesi için kullanılır. Varsayılan olarak Avrupa rakamları kullanılır.
virtual OptimizeOutput { get; set; }Bayrağı, çıktının optimize edilmesinin gerekip gerekmediğini belirtir. Bu bayrak ayarlanırsa, gereksiz iç içe geçmiş tuvaller ve boş tuvaller kaldırılır, aynı biçimlendirmeye sahip komşu glifler de birleştirilir. Not: Bu özellik olarak ayarlanırsa içerik görüntüsünün doğruluğu etkilenebilir.doğru . VarsayılanYANLIŞ .
PageSavingCallback { get; set; }Bir belge sabit sayfa biçimine aktarıldığında ayrı sayfaların nasıl kaydedileceğini kontrol etmenizi sağlar.
PageSet { get; set; }İşlenecek sayfaları alır veya ayarlar. Varsayılan, belgedeki tüm sayfalardır.
PaperColor { get; set; }Oluşturulan resimler 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 , uygun olduğu durumlarda çıktıyı güzel biçimlerde biçimlendirir. Varsayılan değerYANLIŞ .
ProgressCallback { get; set; }Bir belgeyi kaydederken çağrılır ve kaydetme ilerlemesiyle ilgili verileri kabul eder.
Resolution { set; }Oluşturulan görüntüler için hem yatay hem de dikey çözünürlüğü inç başına nokta cinsinden ayarlar.
override SaveFormat { get; set; }Bu kaydetme seçenekleri nesnesi kullanılırsa, işlenen belge sayfalarının veya şekillerinin kaydedileceği biçimi belirtir. Bir raster olabilir Tiff ,Png ,Bmp , Jpeg veya vektörEmf ,Eps , WebP ,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; }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 geçici dosyalar 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ırFloydSteinbergDithering .
TiffBinarizationMethod { get; set; }Görüntüleri 1 bpp formatına dönüştürürken kullanılan yöntemi alır veya ayarlar SaveFormat dırTiff ve TiffCompression eşittirCcitt3 veyaCcitt4 .
TiffCompression { get; set; }Oluşturulan görüntüleri TIFF biçimine kaydederken uygulanacak sıkıştırma türünü alır veya ayarlar.
UpdateAmbiguousTextFont { get; set; }Kullanılan karakter koduna göre yazı tipi özniteliklerinin değiştirilip değiştirilmeyeceğini belirler.
UpdateCreatedTimeProperty { get; set; }Bir değeri alır veya ayarlar.CreatedTime özellik kaydedilmeden önce güncellenir. Varsayılan değerYANLIŞ ;
UpdateFields { get; set; }Belgeyi sabit bir sayfa biçimine kaydetmeden önce belirli türdeki alanların güncellenip güncellenmeyeceğini belirleyen bir değeri alır veya ayarlar. Bu özelliğin varsayılan değeridoğru .
UpdateLastPrintedProperty { get; set; }Bir değeri alır veya ayarlar.LastPrinted özellik kaydedilmeden önce güncellenir.
UpdateLastSavedTimeProperty { get; set; }Bir değeri alır veya ayarlar.LastSavedTime özellik kaydedilmeden önce güncellenir.
UseAntiAliasing { get; set; }İşleme 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ş) işleme algoritmalarının kullanılıp kullanılmayacağını belirleyen bir değeri 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 klonunu oluşturur.
override Equals(object)Belirtilen nesnenin geçerli nesneye eşit değerde olup olmadığını belirler.

Örnekler

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 "Kaydet" metoduna geçirebileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
// bu yöntemin belgeyi görüntüye dönüştürme şeklini değiştirmek için.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Png);

// Belgeyi 72 dpi olarak görüntülemek için "Çözünürlük" özelliğini "72" olarak ayarlayın.
options.Resolution = 72;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.72dpi.png", options);

// Belgeyi 300 dpi olarak işlemek için "Çözünürlük" özelliğini "300" olarak ayarlayın.
options.Resolution = 300;
doc.Save(ArtifactsDir + "ImageSaveOptions.Resolution.300dpi.png", options);

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 "Kaydet" metoduna geçirebileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
// bu yöntemin belgeyi görüntüye dönüştürme şeklini değiştirmek için.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Belgeyi işlerken daha güçlü sıkıştırma kullanmak için "JpegQuality" özelliğini "10" olarak ayarlayın.
// Bu, belgenin dosya boyutunu küçültecektir, ancak görüntü daha belirgin sıkıştırma eserleri gösterecektir.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);

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

Word belgesinin bir sayfasını şeffaf veya renkli arka planlı 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 "Kaydet" metoduna geçirebileceğimiz bir "ImageSaveOptions" nesnesi oluşturun
// bu yöntemin belgeyi görüntüye dönüştürme şeklini değiştirmek için.
ImageSaveOptions imgOptions = new ImageSaveOptions(SaveFormat.Png);
// Şeffaf bir renk uygulamak için "PaperColor" özelliğini şeffaf bir renge ayarlayın
// belgenin görüntüye dönüştürülmesi sırasında arka plan olarak kullanılır.
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 kullanırız.
imgOptions.PaperColor = Color.LightCoral;

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

Ayrıca bakınız

ImagePixelFormat Enum ImageSavingArgs Class