DefaultEncoding Property

Summary

Indicates which encoding should be used when loading text files that do not contain a byte-order mark (BOM).

Syntax

Objective-C

C++/CLI

Java

Python

public CodecsTxtEncoding DefaultEncoding { get; set; }

@property (nonatomic, assign) LTCodecsTxtEncoding defaultEncoding;

public CodecsTxtEncoding isDefaultEncoding() 
public void setDefaultEncoding(CodecsTxtEncoding DefaultEncoding)

public:  
   property CodecsTxtEncoding^ DefaultEncoding 
   { 
      CodecsTxtEncoding^ get() 
      void set(CodecsTxtEncoding^ value) 
   }

DefaultEncoding # get and set (CodecsTxtLoadOptions)

Property Value

The default value is Auto

This property is used only when loading a text file whose encoding is not specified by a byte-order mark (BOM). If the file contains a BOM, this property is ignored.

The value determines how the data contained in the file should be interpreted (Auto, ANSI, Unicode).

Note that files containing ANSI text will load properly ONLY on computers that use the same code page as the computer which saved the file. For example, an ANSI file contains non-ASCII characters (eg: £) and is saved using ANSI encoding on a computer with US/Western Europe code page (1252). If you load the file on a computer with another code page (say 1250), the £ will be loaded as Ł.

See https://en.wikipedia.org/wiki/Windows-1250 for other characters that might be different in these code pages. The differences might be even larger if you try to load it on computers with non-latin code pages (eg: Arabic, Asian, Russian, etc).

In conclusion, it is far better to save text files as Unicode with a BOM and avoid having to use this property.

Example

using Leadtools; 
using Leadtools.Codecs; 
 
using Leadtools.ImageProcessing.Core; 
 
// This C# example shows you how to load a file called "Ansi.txt" that contains ANSI text.  
public void CodecsTxtLoadOptionsDefaultEncoding_Example() 
{ 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      string srcFile = @"Ansi.txt"; 
      using (CodecsImageInfo info = codecs.GetInformation(srcFile, false)) 
      { 
         if (!info.HasBom) 
            codecs.Options.Txt.Load.DefaultEncoding = CodecsTxtEncoding.Ansi; /* Load as Ansi. Here you can bring up a message box asking the user to select the encoding */ 
         codecs.Options.Load.AllPages = true; 
         using (RasterImage image = codecs.Load(srcFile)) 
         { 
            codecs.Save(image, srcFile + ".tif", RasterImageFormat.TifLzw, 0); 
         } 
      } 
   } 
}

Requirements

Target Platforms

Reference

CodecsTxtLoadOptions Class

CodecsTxtLoadOptions Members

CodecsTxtEncoding

CodecsImageInfo.HasBom

Download our FREE evaluation

Help Version 22.0.2023.5.5

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies