>  Docs Center  >  Libraries  >  Coyote  >  CGIMAGEINFO

CGIMAGEINFO

CGIMAGEINFO
  The purpose of this program is allow interactive inquiry of image
  position and values for images displayed with cgImage.
  After a call to cgImage, cgImageInfo can be called and the user
  can use the cursor to click in the image display window. If the user clicks
  inside the image, the image location and value will be printed out in the
  user's IDL console window. The cgImageInfo program blocks the IDL command
  line until the RIGHT mouse button is clicked in the image display window.
 
  This cgImageInfo program is designed to work for the last image displayed with cgImage
  on a Windows or X device. Precautions are taken to help you avoid shooting
  yourself in the foot, but I can't anticipate every action a user might take at the
  IDL command line. Pay particular attention to exiting the program with the RIGHT mouse
  button before you close or kill the current graphics window. Failure to do so will
  put you into a very strange and precarious state from which no rescue is possible.
  You might want to consider using the Catalyst Program `IMGWIN <http://www.idlcoyote.com/catalyst/imgwin.html>`
  as an alternative to cgImageInfo.

Categories


    Graphics
   

Params


    image: in, required,
        A 2D or 3D image array. Values will be returned from this image.
        In versions of IDL < 8.0, it is possible to use a HASH object of
        keys/images where this program will describe the value for each of
        the images in the HASH object.
    position: in, optional, type=float
        A four-element floating array giving the position of the image in
        the display window. If not provided, the image position will be
        retrieved from the last image position used with cgImage.
       

Examples


    To display an image with axes and then inquire about it::
        filename = FILEPATH(SUBDIR=['examples','data'], 'worldelv.dat')
        image = BYTARR(360,360)
        OPENR, lun, filename, /GET_LUN
        READU, lun, image
        FREE_LUN, lun
        thisPosition = [0.1, 0.1, 0.9, 0.9]
        cgImage, image, /KEEP_ASPECT, POSITION=thisPosition, /AXES
        cgImageInfo, image
     

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 by: David W Fanning, 16 March 2008.
      Added ability to specify position directly in call. 20 March 2008. DWF
      Changed cursor operation to conform with expected differences
        between Windows and UNIX. 20 March 2008, DWF.
      Slightly modified screen directions. 16 November 2010. DWF.
      Modified so that multiple images/grids can be described 18 May 2011. MHS

Copyright


    Copyright (c) 2008-2011, Fanning Software Consulting, Inc.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us