←Select platform

MultiscaleEnhancementCommand Constructor(int,int,int,int,int,MultiscaleEnhancementCommandType,MultiscaleEnhancementCommandFlags)

Summary

Initializes a new MultiscaleEnhancementCommand class object with explicit parameters.

Syntax
C#
VB
Objective-C
C++
Java
Public Function New( _ 
   ByVal contrast As Integer, _ 
   ByVal edgeLevels As Integer, _ 
   ByVal edgeCoefficient As Integer, _ 
   ByVal latitudeLevels As Integer, _ 
   ByVal latitudeCoefficient As Integer, _ 
   ByVal type As MultiscaleEnhancementCommandType, _ 
   ByVal flags As MultiscaleEnhancementCommandFlags _ 
) 
- (instancetype)initWithContrast:(NSUInteger)contrast 
                      edgeLevels:(NSUInteger)edgeLevels 
                 edgeCoefficient:(NSUInteger)edgeCoefficient 
                  latitudeLevels:(NSUInteger)latitudeLevels 
             latitudeCoefficient:(NSUInteger)latitudeCoefficient 
                            type:(LTMultiscaleEnhancementCommandType)type 
                           flags:(LTMultiscaleEnhancementCommandFlags)flags 
public MultiscaleEnhancementCommand( 
   int contrast,  
   int edgeLevels,  
   int edgeCoefficient,  
   int latitudeLevels,  
   int latitudeCoefficient,  
   MultiscaleEnhancementCommandType type,  
   int flags 
) 

Parameters

contrast
Fraction of contrast enhancement applied to the image. Valid values range from 0 - 10000, which are interpreted as 0 percent - 100 percent. This value is internally divided by 10000. Greater values will produce stronger contrast.

edgeLevels
The number of levels that will be used for edge enhancement. Valid values are from 1 to the maximum number of levels of the image. -1 will use the default number of levels (which is 3). This option will take effect only if MultiscaleEnhancementCommandFlags.EdgeEnhancement is set in the flags parameter. Passing zero will return an error code.

edgeCoefficient
The edge enhancement coefficient. This value will be internally divided by 100. Pass -1 to use the default values (which is 170 interpreted as 1.7). This option will be used only if EdgeEnhancment is set in the flags parameter. Any value (>= 0) is valid. A value of 100 will be interpreted as 1.0 and will keep the image's edges un-enhanced. Larger values will produce more visible edges. Smaller values will produce less visible edges. Practically, the enhancement levels out at 200000 (interpreted as 2000.0) - values bigger than that will not enhance the image's edges any more.

latitudeLevels
The number of levels that will be used for Latitude reduction. Valid values are from 1 to maximum number of levels of the image. You can also pass -1 to use the default level value (which is 5). This option will be used only if the MultiscaleEnhancementCommandFlags.LatitudeReduction is set in Flags. Passing zero will return an error code.

latitudeCoefficient
The latitude reduction coefficient. This value will be internally divided by 100. Pass -1 to use the default values (which is 140 interpreted as 1.4). This option will be used only if MultiscaleEnhancementCommandFlags.LatitudeReduction is set in the flags parameter. Any value (>= 0) is valid. A value of 100 will be interpreted as 1.0 and will keep the image's latitude un-enhanced. Decreasing latitude makes the image brighter, increasing latitude makes the image dimmer. Practically, the enhancement levels out at 200000 (interpreted as 2000,0) - values bigger than that will not decrease the image's latitude any more.

type
Value that indicates the type of filter used.

flags
Flag that determines the command behavior.

Example

Run the MultiscaleEnhancementCommand on an image.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void MultiScaleEnhancementConstructorExample_S3() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg")); 
 
   // Prepare the command 
   MultiscaleEnhancementCommand command = new MultiscaleEnhancementCommand(2000, 4, -1, 0, 0, MultiscaleEnhancementCommandType.Gaussian, MultiscaleEnhancementCommandFlags.EdgeEnhancement); 
   // Apply multiscale enhancement 
   command.Run(image); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub MultiScaleEnhancementConstructorExample_S3() 
   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 command As MultiscaleEnhancementCommand = New MultiscaleEnhancementCommand(2000, 4, -1, 0, 0, MultiscaleEnhancementCommandType.Gaussian, MultiscaleEnhancementCommandFlags.EdgeEnhancement) 
   ' Apply multiscale enhancement 
   command.Run(leadImage) 
 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 
c#[Silverlight C# Example] 
using Leadtools; 
using Leadtools.Examples; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void MultiScaleEnhancementConstructorExample_S3(RasterImage image, Stream outStream) 
{ 
   // Prepare the command 
   MultiscaleEnhancementCommand command = new MultiscaleEnhancementCommand(2000, 4, -1, 0, 0, MultiscaleEnhancementCommandType.Gaussian, MultiscaleEnhancementCommandFlags.EdgeEnhancement); 
   // Apply multiscale enhancement 
   command.Run(image); 
 
   // Save result image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24); 
   image.Dispose(); 
} 
vb[Silverlight VB Example] 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub MultiScaleEnhancementConstructorExample_S3(ByVal image As RasterImage, ByVal outStream As Stream) 
   ' Prepare the command 
   Dim command As MultiscaleEnhancementCommand = New MultiscaleEnhancementCommand(2000, 4, -1, 0, 0, MultiscaleEnhancementCommandType.Gaussian, 
                                                                                  MultiscaleEnhancementCommandFlags.EdgeEnhancement) 
   ' Apply multiscale enhancement 
   command.Run(image) 
 
   ' Save result image 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24) 
   image.Dispose() 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Core Assembly