AntiAliasing Property

Summary

Indicates whether anti-aliasing should be used when rendering text.

Syntax

Objective-C

C++/CLI

Java

Python

public CodecsTxtAntiAliasing AntiAliasing { get; set; }

@property (nonatomic, assign) LTCodecsTxtAntiAliasing AntiAliasing;

public CodecsTxtAntiAliasing isAntiAliasing() 
public void setAntiAliasing(CodecsTxtAntiAliasing AntiAliasing)

public:  
   property CodecsTxtAntiAliasing^ AntiAliasing 
   { 
      CodecsTxtAntiAliasing^ get() 
      void set(CodecsTxtAntiAliasing^ value) 
   }

AntiAliasing # get and set (CodecsTxtLoadOptions)

Property Value

This property affects the output only if the rendering engine supports it. GDI+ supports anti-aliasing, whereas SKIA does not.

Anti-aliasing smooths the text edges so the output looks better in 24/32-bit or 8-bit grayscale. But it can cause undesirable effects when the output is dithered down to fewer than 8-bits per pixel.

In particular, the output looks bad if the text files are loaded as 1-bit. In addition to looking bad, these 1-bit images will not compress efficiently using lossless compression techniques, such as fax CCITT G4. This is why it is sometimes desirable to turn anti-aliasing off.

Here are the possible values for this property:

Value	Description
CodecsTxtAntiAliasing.Auto	Let LEADTOOLS turn anti-aliasing on/off automatically (Default). In this case, anti-aliasing is enabled when loading at >= 8 bpp and disabled for < 8 bpp.
CodecsTxtAntiAliasing.On	Always on
CodecsTxtAntiAliasing.Off	Always off

Example

using Leadtools; 
using Leadtools.Codecs; 
 
using Leadtools.ImageProcessing.Core; 
 
 
// Make sure the source file has at least one long line of text to see the effect of the Wrap property. 
// Look at the result with 100% scale factor to see the effect of the AntiAliasing property. 
public void CodecsTxtOptionsAntiAliasingExample() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "test.txt"); 
 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      /* Load the text file using the defaults (AntiAliasing + Wrap) */ 
      using (RasterImage image = codecs.Load(srcFileName)) 
         codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "txt-Default.png"), RasterImageFormat.Png, 0); 
 
      /* Load the text file with no AntiAliasing + no Wrap */ 
      codecs.Options.Txt.Load.AntiAliasing = CodecsTxtAntiAliasing.Off; 
      codecs.Options.Txt.Load.Wrap = false; 
      using (RasterImage image = codecs.Load(srcFileName)) 
         codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "txt-NoAntiAlias-NoWrap.png"), RasterImageFormat.Png, 0); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

CodecsTxtLoadOptions Class

CodecsTxtLoadOptions Members

CodecsTxtAntiAliasing

Download our FREE evaluation

Help Version 22.0.2023.5.5

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies