Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / Libraries / Coyote / CGERASE

CGERASE

CGERASE
  Provides a device-independent and color-model-independent way to erase a graphics
  window with a particular color.

Categories


    Graphics
   

Params


    background_color: in, optional, type=string/integer/long, default='white'
        The color to use in erasing the graphics window. Default is "white."
        Color names are those used with cgColor.
     

Keywords


    color: in, optional, type=string/integer/long, default='white'
        An alternative way to specify the color to use in erasing the graphics window.
        Color names are those used with cgColor. This parameter is used in
        preference to the background_color parameter.
    layout: in, optional, type=intarr(3)
        This keyword specifies a grid with a graphics window and determines where the
        graphic should appear. The syntax of LAYOUT is three numbers: [ncolumns, nrows, location].
        The grid is determined by the number of columns (ncolumns) by the number of
        rows (nrows). The location of the graphic is determined by the third number. The
        grid numbering starts in the upper left (1) and goes sequentually by column and then
        by row. If this keyword is used, only this portion of the window is erased.
    window: in, optional, type=boolean, default=0
        Set this keyword to erase the current cgWindow application. "Erasing" in
        this case means removing all the current commands.
         

Examples


    Used to "erase" various things::
      IDL> cgErase
      IDL> cgErase, 'gray'
      IDL> cgErase, COLOR='charcoal'
     
      IDL> cgPlot, cgDemoData(1), /Window
      IDL> cgErase, /Window
     
      IDL> cgPlot, cgDemoData(17), Layout=[2,2,1]
      IDL> cgPlot, cgDemoData(17), Layout=[2,2,4]
      IDL> cgErase, Layout=[2,2,1]
     

Author


      FANNING SOFTWARE CONSULTING::
          David W. Fanning
          1645 Sheely Drive
          Fort Collins, CO 80526 USA
          Phone: 970-221-0438
          E-mail: david@idlcoyote.com
          Coyote's Guide to IDL Programming: http://www.idlcoyote.com

History


    Change History::
        Written, 12 November 2010. DWF.
        Modified so that input variables are not changed. 18 Nov 2010. DWF.
        Got my color selection algorithm right. COLOR keyword takes precedence
          over the parameter. 18 Nov 2010. DWF.
        Modified to erase in decomposed color, if possible.
        In some cases, I was turning BYTE values to strings without converting to
            INTEGERS first. 30 Dec 2010. DWF.
        Added WINDOW keyword. 26 Jan 2011. DWF.
        Added LAYOUT keyword. 1 Feb 2011. DWF.
        Modified error handler to restore the entry decomposition state if there is an error. 17 March 2011. DWF

Copyright


    Copyright (c) 2010, Fanning Software Consulting, Inc.



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us