Markers Property

Summary

The collection of marker data used when reading and writing certain file formats (including JPEG).

Syntax

Objective-C

C++

Java

public ObservableCollection<RasterMarkerMetadata> Markers { get; }

Public ReadOnly Property Markers As ObservableCollection(Of RasterMarkerMetadata)

@property (nonatomic, assign, readonly, nullable) NSMutableArray<LTRasterMarkerMetadata *> *markers

public List<RasterMarkerMetadata> getMarkers()

public: 
property ObservableCollection<RasterMarkerMetadata^>^ Markers { 
   ObservableCollection<RasterMarkerMetadata^>^ get(); 
}

Property Value

A collection of RasterMarkerMetadata used when reading and writing certain file formats (including JPEG).

Remarks

Several formats allow you to store non-image data such as comments, tags, and markers.

You can manipulate the markers of an image by adding/removing RasterMarkerMetadata objects to this collection.

By setting the CodecsSaveOptions.Markers property to true before calling RasterCodecs.Save, you can save the markers in this collection when the image is saved into a file.

By setting the CodecsLoadOptions.Markers property to true before calling RasterCodecs.Load, you can load all the markers (if any) into this collection when an image is loaded from a file.

You can use the RasterCodecs.ReadMarkers method to load the markers directly from an existing file and the RasterCodecs.WriteMarkers method to save the markers to an existing file.

For more information, refer to Non Image Data.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void MarkersExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
	RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")); 
 
	byte[] byteData = new byte[1]; 
	byteData[0] = 40; 
	// write APP5 (since nobody writes that) 
	RasterMarkerMetadata markerData = new RasterMarkerMetadata(RasterMarkerMetadata.App0 + 5, byteData); 
	image.Markers.Add(markerData); 
 
	codecs.Options.Save.Markers = true; 
	codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_MARKERS.JPG"), RasterImageFormat.Jpeg, 0); 
 
	// load the marker together with the image 
	IList<RasterMarkerMetadata> marker = codecs.ReadMarkers(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_MARKERS.JPG")); 
	// look for the APP5 marker, because there might be other markers (like APP0, APP1) 
	foreach (RasterMarkerMetadata markerItem in marker) 
		if (markerItem.Id == RasterMarkerMetadata.App0 + 5) 
			MessageBox.Show("marker Id :" + markerItem.Id.ToString() + " = " + markerItem.GetData().ToString()); 
 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Core 
Imports Leadtools.ImageProcessing.Color 
Imports Leadtools.Controls 
Imports Leadtools.Dicom 
Imports Leadtools.Drawing 
Imports Leadtools.Svg 
 
Public Sub MarkersExample() 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   Dim image As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")) 
 
   Dim byteData As Byte() = New Byte(0) {} 
   byteData(0) = 40 
   ' write APP5 (since nobody writes that) 
   Dim markerData As RasterMarkerMetadata = New RasterMarkerMetadata(RasterMarkerMetadata.App0 + 5, byteData) 
   image.Markers.Add(markerData) 
 
   codecs.Options.Save.Markers = True 
   codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_MARKERS.JPG"), RasterImageFormat.Jpeg, 0) 
 
   ' load the marker together with the image 
   Dim marker As IList(Of RasterMarkerMetadata) = codecs.ReadMarkers(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_MARKERS.JPG")) 
   ' look for the APP5 marker, because there might be other markers (like APP0, APP1) 
   For Each markerItem As RasterMarkerMetadata In marker 
      If markerItem.Id = RasterMarkerMetadata.App0 + 5 Then 
         MessageBox.Show("marker Id :" & markerItem.Id.ToString() & " = " & markerItem.GetData().ToString()) 
      End If 
   Next markerItem 
 
   codecs.Dispose() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class

Requirements

Target Platforms

Reference

RasterImage Class

RasterImage Members

Download our FREE evaluation

Help Version 21.0.2021.7.2

Leadtools Assembly

Introduction

Getting Started

Namespaces

Leadtools Namespace

Leadtools.ImageProcessing Namespace

Assemblies