←Select platform

AntiAliasing Property

Summary
Indicates whether anti-aliasing should be used when rendering text.
Syntax
C#
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
C#
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

Help Version 22.0.2023.5.5
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Codecs Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.