WriteGeoKey(string,int,RasterTagMetadata) Method

Summary

Writes or changes a GeoKey to an existing file.

Syntax

Objective-C

C++

public void WriteGeoKey( 
   string fileName, 
   int pageNumber, 
   RasterTagMetadata geoKey 
)

Public Overloads Sub WriteGeoKey( _ 
   ByVal fileName As String, _ 
   ByVal pageNumber As Integer, _ 
   ByVal geoKey As RasterTagMetadata _ 
)

- (BOOL)writeGeoKey:(nullable LTRasterTagMetadata *)geoKey  
             toFile:(NSString *)file  
         pageNumber:(NSInteger)pageNumber  
              error:(NSError **)error

public: 
void WriteGeoKey(  
   String^ fileName, 
   int pageNumber, 
   RasterTagMetadata^ geoKey 
)

Parameters

fileName
A String that contains the filename.

pageNumber
1-based index of the page at which to write the GeoKey.

geoKey
GeoKey to identify the data in the Geo TIFF file.

Remarks

This method writes to or changes the GeoKeys in an existing file.

This method works only with TIFF files. If you also want to write the other TIFF tags and comments, use WriteMarkers instead.

Note: Use this method carefully. LEADTOOLS will not restrict the GeoKeys that you write. If you write bad GeoKeys, the file might become corrupted. Consult the GeoTIFF specification documentation for a list of GeoKeys.

Some restrictions apply to this function if you use an IFD to indicate to which page to write the GeoKey. See the Loading and Saving Large TIFF / BigTIFF Files topic for more information.

Example

This example will show all the GeoKeys in the given file and then load them and add them to a destination file

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
 
string geoKeySrcFileName; 
string geoKeyDestFileName; 
 
void WriteGeoKeyExample(string srcFileName, string destFileName) 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
 
	geoKeySrcFileName = srcFileName; 
	geoKeyDestFileName = destFileName; 
 
	codecs.GeoKeyFound += new EventHandler<CodecsEnumGeoKeysEventArgs>(codecs_MyGeyKeyFound); 
	codecs.EnumGeoKeys(srcFileName, 1); 
	codecs.GeoKeyFound -= new EventHandler<CodecsEnumGeoKeysEventArgs>(codecs_MyGeyKeyFound); 
 
	// Clean up 
	codecs.Dispose(); 
} 
 
void codecs_MyGeyKeyFound(object sender, CodecsEnumGeoKeysEventArgs e) 
{ 
	Console.WriteLine("GeoKey: Id={0}, Count={1}, Type={2}, Data Length={3}, Data=", e.Id, e.Count, e.MetadataType, e.Buffer.Length); 
 
	// Load this GeoKey 
	RasterCodecs codecs = sender as RasterCodecs; 
	RasterTagMetadata geoKey = codecs.ReadGeoKey(geoKeySrcFileName, 1, e.Id); 
 
	// Write it to the destination file 
	Console.WriteLine("Writing this GeoKey to the destination file"); 
	codecs.WriteGeoKey(geoKeyDestFileName, 1, geoKey); 
}