LEADTOOLS Image Processing (Leadtools.ImageProcessing.Effects assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
GetRegionPerimeterLength Method
See Also 
Leadtools.ImageProcessing.Effects Namespace > EffectsUtilities Class : GetRegionPerimeterLength Method



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.
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.
Updates the curve array based on a curve or lines that pass through the specified points.

Syntax

Visual Basic (Declaration) 
Public Shared Function GetRegionPerimeterLength( _
   ByVal image As RasterImage, _
   ByVal xForm As RasterRegionXForm _
) As Integer
Visual Basic (Usage)Copy Code
Dim image As RasterImage
Dim xForm As RasterRegionXForm
Dim value As Integer
 
value = EffectsUtilities.GetRegionPerimeterLength(image, xForm)
C# 
public static int GetRegionPerimeterLength( 
   RasterImage image,
   RasterRegionXForm xForm
)
C++/CLI 
public:
static int GetRegionPerimeterLength( 
   RasterImage^ image,
   RasterRegionXForm^ 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.

Example

Run the Leadtools.ImageProcessing.Effects.EffectsUtilities.GetRegionPerimeterLength method on an image.

Visual BasicCopy Code
Public Sub GetRegionPerimeterLengthExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   ' Prepare the command
   Dim rcRect As LeadRect = New LeadRect(leadImage.Width \ 3, leadImage.Height \ 3, leadImage.Width * 2 \ 3, leadImage.Height * 2 \ 3)
   leadImage.AddEllipseToRegion(Nothing, rcRect, RasterRegionCombineMode.Set)
   MessageBox.Show("Length = " + Convert.ToString(EffectsUtilities.GetRegionPerimeterLength(leadImage, Nothing)))

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
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:\Users\Public\Documents\LEADTOOLS Images";
}
SilverlightCSharpCopy Code
SilverlightVBCopy Code

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.

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also