Leadtools.Codecs Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.17
WriteTransformMarker(Int32,IntPtr,Int32) Method
See Also 
Leadtools.Codecs Namespace > RasterCodecs Class > WriteTransformMarker Method : WriteTransformMarker(Int32,IntPtr,Int32) Method




id
The id of the metadata marker.
data
A pointer to unmanaged memory buffer containing the data for the metadata marker.
dataLength
Number of bytes to read from data.
Controls how the transform markers are used when performing a lossless transformation for certain formats.

Syntax

Visual Basic (Declaration) 
Overloads Public Sub WriteTransformMarker( _
   ByVal id As Integer, _
   ByVal data As IntPtr, _
   ByVal dataLength As Integer _
) 
Visual Basic (Usage)Copy Code
Dim instance As RasterCodecs
Dim id As Integer
Dim data As IntPtr
Dim dataLength As Integer
 
instance.WriteTransformMarker(id, data, dataLength)
C# 
public void WriteTransformMarker( 
   int id,
   IntPtr data,
   int dataLength
)
Managed Extensions for C++ 
public: void WriteTransformMarker( 
   int id,
   IntPtr data,
   int dataLength
) 
C++/CLI 
public:
void WriteTransformMarker( 
   int id,
   IntPtr data,
   int dataLength
) 

Parameters

id
The id of the metadata marker.
data
A pointer to unmanaged memory buffer containing the data for the metadata marker.
dataLength
Number of bytes to read from data.

Example

For an example, refer to Transform.

Remarks

You should use this method to write a certain marker data into the file.

This method can be called only from within the CodecsTransformMarkerCallback passed to the Transform method.

The transform mechanism is as follows:

  • You call Transform.
  • Transform will call the CodecsTransformMarkerCallback callback passed to it for every marker contained in the source file. In the callback, you can replace markers, insert markers or allow Leadtools to do the default processing (recommended).
  • You can override the default action for a marker by returning one of the following values from the transform callback:

Note: You can also use WriteTransformMarker to insert your own markers. The marker will be inserted before the current marker. You can call WriteTransformMarker as many times as you wish. Every call to WriteTransformMarker will insert a new marker.

Warning: Incorrect handling of the markers will generate corrupt files! Since some markers contain important information about the image (image width, height, compression method, colorspace, etc), you should use caution when working with markers.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also