GetRegionPerimeterLength Method

Summary

Updates the curve array based on a curve or lines that pass through the specified points.

Syntax

C++/CLI

Python

public static int GetRegionPerimeterLength( 
   RasterImage image, 
   RasterRegionXForm xForm 
)

public: 
static int GetRegionPerimeterLength(  
   RasterImage^ image, 
   RasterRegionXForm^ xForm 
)

def GetRegionPerimeterLength(self,image,xForm):

Parameters

image
References the image that contains the region.

xForm
RasterRegionXForm object that contains information used to translate between display coordinates and image coordinates. If you specify null in this parameter, the scalar fields default to 1, the offsets default to 0, and the view perspective defaults to the image's view perspective.

Return Value

The perimeter length of the region.

Remarks

This command works only on images having a region. If an image does not have a region the command returns the error: Not Initialized.
This command supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.

Example

Run the GetRegionPerimeterLength method on an image.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Effects; 
using Leadtools.ImageProcessing.Color; 
 
 
public void GetRegionPerimeterLengthExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg")); 
 
   // Prepare the command 
   LeadRect rcRect = new LeadRect(image.Width / 3, image.Height / 3, image.Width * 2 / 3, image.Height * 2 / 3); 
   image.AddEllipseToRegion(null, rcRect, RasterRegionCombineMode.Set); 
   MessageBox.Show("Length = " + EffectsUtilities.GetRegionPerimeterLength(image, null)); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
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.color.*; 
import leadtools.imageprocessing.effects.*; 
 
 
// GET REGION PERIMETER LENGTH EXAMPLE DOES NOT EXIST IN JAVA 
// // public void getRegionPerimeterLengthExample() { 
 
// 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, "Master.jpg")); 
 
// // Prepare the command 
// LeadRect rcRect = new LeadRect(image.getWidth() / 3, image.getHeight() / 3, 
// image.getWidth() * 2 / 3, 
// image.getHeight() * 2 / 3); 
// image.addEllipseToRegion(null, rcRect, RasterRegionCombineMode.SET); 
// }