←Select platform

CheckedByInformation Property

Summary

Identifies whether a particular file codec is used when processing a call to RasterCodecs.GetInformation or RasterCodecs.GetInformationAsync.

Syntax
C#
C++/CLI
Java
Python
public bool CheckedByInformation {get; set;} 
public boolean getCheckedByInformation() 
public void setCheckedByInformation(boolean value) 
public: 
property bool CheckedByInformation { 
   bool get(); 
   void set (    bool ); 
} 
CheckedByInformation # get and set (CodecsCodecInformation) 

Property Value

true if the filter codec is used; otherwise, false. The default value is false.

Remarks

A call has three phases used in identifying a file format. The first phase checks the first few bytes. The second phase checks the file extension. The third phase tries all available codec filters. When this value is false, the corresponding file codec is excluded from the third phase.

In other words, if CheckedByInformation is set to false for a certain codec (for example RTF), the codec would be used to identify RTF files if:

  1. The file starts with the RTF file signature
  2. The file has the ".rtf" extension

It would not be used in the third phase.

In earlier versions of the toolkit (v20 and earlier), setting CheckedByInformation to false would have excluded the filter from all three phases instead of just the first two.

Starting with v21, to exclude the codec from all three phases set CodecsCodecInformation.IsIgnored to false.

Example
C#
Java
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void GetCodecInformationExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   CodecsCodecInformation codecInfo = codecs.GetCodecInformation("Tif"); 
   Debug.WriteLine("CheckedByInformation : {0}", codecInfo.CheckedByInformation); 
   Debug.WriteLine("ExtensionList : {0}", codecInfo.ExtensionList); 
   Debug.WriteLine("IsIgnored : {0}", codecInfo.IsIgnored.ToString()); 
   Debug.WriteLine("IsPresent : {0}", codecInfo.IsPresent.ToString()); 
   Debug.WriteLine("IsSlowInformation : {0}", codecInfo.IsSlowInformation.ToString()); 
   Debug.WriteLine("LoadMode : {0}", codecInfo.LoadMode.ToString()); 
   Debug.WriteLine("Name : {0}", codecInfo.Name); 
 
   // Parse the load modes 
   CodecsCodecLoadMode[] loadModes = (CodecsCodecLoadMode[])Enum.GetValues(typeof(CodecsCodecLoadMode)); 
   foreach (var loadMode in loadModes) 
   { 
      codecs.SetCodecsInformation(codecs.GetCodecsInformation()); 
      Debug.WriteLine($"Load mode: {loadMode}"); 
   } 
 
   // change the extensions that the ptk filter tries to handle 
   codecInfo.ExtensionList = "ptk;ptoka;ptoca;ptca;ptka"; 
   codecs.SetCodecInformation(codecInfo); 
 
   // re-display the new settings 
   codecInfo = codecs.GetCodecInformation("tif"); 
   Debug.WriteLine("ExtensionList : {0}", codecInfo.ExtensionList); 
 
   // Clean up 
   codecs.Dispose(); 
} 
 
import java.io.*; 
import java.net.*; 
import java.nio.file.Paths; 
import java.util.*; 
import java.time.Instant; 
import java.time.Duration; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.codecs.RasterCodecs.FeedCallbackThunk; 
import leadtools.drawing.internal.*; 
import leadtools.imageprocessing.*; 
import leadtools.imageprocessing.color.ChangeIntensityCommand; 
import leadtools.svg.*; 
 
 
public void getCodecInformationExample() { 
   RasterCodecs codecs = new RasterCodecs(); 
 
   CodecsCodecInformation codecInfo = codecs.getCodecInformation("Tif"); 
   System.out.println("CheckedByInformation : " + codecInfo.getCheckedByInformation()); 
   System.out.println("ExtensionList : %s" + codecInfo.getExtensionList()); 
   System.out.println("IsIgnored : %s" + codecInfo.isIgnored()); 
   System.out.println("IsPresent : %s" + codecInfo.isPresent()); 
   System.out.println("IsSlowInformation : %s" + codecInfo.isSlowInformation()); 
   System.out.println("LoadMode : %s" + codecInfo.getLoadMode().toString()); 
   System.out.println("Name : %s" + codecInfo.getName()); 
 
   // Parse the load modes 
   CodecsCodecLoadMode[] loadModes = CodecsCodecLoadMode.values(); 
   for (CodecsCodecLoadMode loadMode : loadModes) { 
      codecs.setCodecsInformation(codecs.getCodecsInformation()); 
      assertTrue("Codecs information unsuccessfully set (is null)", codecs.getCodecsInformation() != null); 
      System.out.println("Load mode: " + loadMode); 
   } 
 
   // change the extensions that the ptk filter tries to handle 
   codecInfo.setExtensionList("ptk;ptoka;ptoca;ptca;ptka"); 
   codecs.setCodecInformation(codecInfo); 
 
   // re-display the new settings 
   codecInfo = codecs.getCodecInformation("tif"); 
   System.out.println("ExtensionList : " + codecInfo.getExtensionList()); 
 
   // Clean up 
   codecs.dispose(); 
} 
Requirements

Target Platforms

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

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