How to create a raster stretch renderer

Creating a raster stretch renderer

1. Define the color ramp's from and to colors.
2. Create the color ramp.
3. Create a stretch renderer.
4. Set the renderer properties.
5. Set the stretch type.
   
   See the following code example:
   

[C#]

public IRasterRenderer StretchRenderer(ESRI.ArcGIS.Geodatabase.IRasterDataset
    rasterDataset)
{
    try
    {
        //Define the from and to colors for the color ramp.
        IRgbColor fromColor=new RgbColorClass();
        fromColor.Red=255;
        fromColor.Green=0;
        fromColor.Blue=0;
        IColor toColor=new RgbColorClass();
        fromColor.Red=0;
        fromColor.Green=255;
        fromColor.Blue=0;
        //Create the color ramp.
        IAlgorithmicColorRamp colorRamp=new AlgorithmicColorRampClass();
        colorRamp.Size=255;
        colorRamp.FromColor=fromColor;
        colorRamp.ToColor=toColor;
        bool createColorRamp;
        colorRamp.CreateRamp(out createColorRamp);
        //Create a stretch renderer.
        IRasterStretchColorRampRenderer stretchRenderer=new
            RasterStretchColorRampRendererClass();
        IRasterRenderer rasterRenderer=(IRasterRenderer)stretchRenderer;
        //Set the renderer properties.
        IRaster raster=rasterDataset.CreateDefaultRaster();
        rasterRenderer.Raster=raster;
        rasterRenderer.Update();
        stretchRenderer.BandIndex=0;
        stretchRenderer.ColorRamp=colorRamp;
        //Set the stretch type.
        IRasterStretch stretchType=(IRasterStretch)rasterRenderer;
        stretchType.StretchType =
            esriRasterStretchTypesEnum.esriRasterStretch_StandardDeviations;
        stretchType.StandardDeviationsParam=2;
        return rasterRenderer;
    }
    catch (Exception ex)
    {
        System.Diagnostics.Debug.WriteLine(ex.Message);
        return null;
    }
}

[VB.NET]

Public Function StretchRenderer(ByVal rasterDataset As ESRI.ArcGIS.GeodataMyBase.IRasterDataset) As IRasterRenderer
    Try
    'Define the from and to colors for the color ramp.
    Dim fromColor As IRgbColor=New RgbColorClass()
    fromColor.Red=255
    fromColor.Green=0
    fromColor.Blue=0
    Dim toColor As IColor=New RgbColorClass()
    fromColor.Red=0
    fromColor.Green=255
    fromColor.Blue=0
    
    'Create the color ramp.
    Dim colorRamp As IAlgorithmicColorRamp=New AlgorithmicColorRampClass()
    colorRamp.Size=255
    colorRamp.FromColor=fromColor
    colorRamp.ToColor=toColor
    Dim createColorRamp As Boolean
    colorRamp.CreateRamp( createColorRamp)
    
    'Create a stretch renderer.
    Dim stretchRenderer As IRasterStretchColorRampRenderer=New RasterStretchColorRampRendererClass()
    Dim rasterRenderer As IRasterRenderer=CType(stretchRenderer, IRasterRenderer)
    
    'Set the renderer properties.
    Dim raster As IRaster=rasterDataset.CreateDefaultRaster()
    rasterRenderer.Raster=raster
    rasterRenderer.Update()
    stretchRenderer.BandIndex=0
    stretchRenderer.ColorRamp=colorRamp
    
    'Set the stretch type.
    Dim stretchType As IRasterStretch=CType(rasterRenderer, IRasterStretch)
    stretchType.StretchType=esriRasterStretchTypesEnum.esriRasterStretch_StandardDeviations
    stretchType.StandardDeviationsParam=2
    
    Return rasterRenderer
    Catch ex As Exception
    System.Diagnostics.Debug.WriteLine(ex.Message)
    Return Nothing
    End Try
End Function

See Also:

How to create a raster layer

---

To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):

• ESRI.ArcGIS.System (ESRI.ArcGIS.esriSystem)
• ESRI.ArcGIS.Display
• ESRI.ArcGIS.Geometry
• ESRI.ArcGIS.DataSourcesGDB
• ESRI.ArcGIS.Geodatabase
• ESRI.ArcGIS.DataSourcesRaster
• ESRI.ArcGIS.Carto

Development licensing	Deployment licensing
ArcGIS Desktop Advanced	ArcGIS Desktop Advanced
ArcGIS Desktop Standard	ArcGIS Desktop Standard
ArcGIS Desktop Basic	ArcGIS Desktop Basic
Engine Developer Kit	Engine