ImageRegion Property

Summary

RasterImage object that is updated with a shallow copy of image that also has a region that contains the removed borders.

Syntax

Objective-C

C++/CLI

Java

Python

public RasterImage ImageRegion { get; }

@property (nonatomic, strong, readonly, nullable) LTRasterImage *imageRegion;

public RasterImage getImageRegion();

public: 
property RasterImage^ ImageRegion { 
   RasterImage^ get(); 
}

ImageRegion # get  (BorderRemoveCommand)

Property Value

If BorderRemoveCommandFlags.SingleRegion| BorderRemoveCommandFlags.LeadRegion have been set in Flags, then when BorderRemoveCommand returns, this is updated with a shallow copy of image that also has a region that contains the removed borders. So set Flags to (BorderRemoveCommandFlags.SingleRegion| BorderRemoveCommandFlags.LeadRegion). It is the programmer's responsibility to dispose the region when it is no longer needed.

Example

Run the BorderRemoveCommand on an image.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
 
public void ImageRegionPropertyExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Clean.tif")); 
 
   // Prepare the command 
   BorderRemoveCommand command = new BorderRemoveCommand(); 
   command.Border = BorderRemoveBorderFlags.All; 
   command.Flags = BorderRemoveCommandFlags.UseVariance | BorderRemoveCommandFlags.SingleRegion | BorderRemoveCommandFlags.LeadRegion; 
   command.Percent = 20; 
   command.Variance = 3; 
   command.WhiteNoiseLength = 9; 
 
   command.Run(image); 
 
   using (RasterRegion tempRegion = command.ImageRegion.GetRegion(null)) 
   { 
      image.SetRegion(null, tempRegion, RasterRegionCombineMode.Set); 
   } 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.beans.EventHandler; 
import java.io.File; 
import java.io.IOException; 
 
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.imageprocessing.core.*; 
import leadtools.imageprocessing.color.*; 
 
 
public void imageRegionPropertyExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, 
         "clean.tif"), 1, CodecsLoadByteOrder.BGR, 1, 1); 
 
   // Prepare the command 
   BorderRemoveCommand command = new BorderRemoveCommand(); 
   command.setBorder(BorderRemoveBorderFlags.ALL.getValue()); 
   command.setFlags(BorderRemoveCommandFlags.USE_VARIANCE.getValue() 
         | BorderRemoveCommandFlags.SINGLE_REGION.getValue() | BorderRemoveCommandFlags.LEAD_REGION.getValue()); 
   command.setPercent(20); 
   command.setVariance(3); 
   command.setWhiteNoiseLength(9); 
 
   command.run(image); 
 
   RasterRegion tempRegion = command.getImageRegion().getRegion(null); 
   image.setRegion(null, tempRegion, RasterRegionCombineMode.SET); 
   tempRegion.dispose(); 
 
   assertTrue(image.hasRegion()); 
   System.out.println("Command run and image saved to " + combine(LEAD_VARS_IMAGES_DIR, "clean.tif")); 
}

Requirements

Target Platforms

Reference

BorderRemoveCommand Class

BorderRemoveCommand Members

Download our FREE evaluation

Help Version 23.0.2024.3.3

Leadtools.ImageProcessing.Core Assembly

Introduction

Getting Started

Namespaces

Leadtools.ImageProcessing.Core Namespace

Assemblies