←Select platform

AntiAliasing Property

Summary
Indicates whether anti-aliasing should be used when rendering text.
Syntax
C#
VB
Objective-C
C++
Java
public CodecsTxtAntiAliasing AntiAliasing { get; set; } 
Public Property AntiAliasing As CodecsTxtAntiAliasing 
@property (nonatomic, assign) LTCodecsTxtAntiAliasing AntiAliasing; 
public CodecsTxtAntiAliasing isAntiAliasing() 
public void setAntiAliasing(CodecsTxtAntiAliasing AntiAliasing) 
public:  
   property CodecsTxtAntiAliasing^ AntiAliasing 
   { 
      CodecsTxtAntiAliasing^ get() 
      void set(CodecsTxtAntiAliasing^ value) 
   } 

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:

  1. 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.
  2. CodecsTxtAntiAliasing.On = Always on
  3. CodecsTxtAntiAliasing.Off = Always off
Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
 
 
 
// 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, "Image1.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"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
 
 
' 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 Sub CodecsTxtOptionsAntiAliasingExample() 
   Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.txt") 
 
   Using codecs As RasterCodecs = New RasterCodecs() 
      ' Load the text file using the defaults (AntiAliasing + Wrap)  
      Using image As RasterImage = codecs.Load(srcFileName) 
         codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "txt-Default.png"), RasterImageFormat.Png, 0) 
      End Using 
 
      ' Load the text file with no AntiAliasing + no Wrap  
      codecs.Options.Txt.Load.AntiAliasing = CodecsTxtAntiAliasing.Off 
      codecs.Options.Txt.Load.Wrap = False 
      Using image As RasterImage = codecs.Load(srcFileName) 
         codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "txt-NoAntiAlias-NoWrap.png"), RasterImageFormat.Png, 0) 
      End Using 
   End Using 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS22\Resources\Images" 
End Class 
Requirements

Target Platforms

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

Leadtools.Codecs Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.