The XBM_EDIT procedure allows users to create and edit icons for use with IDL widgets as bitmap labels for widget buttons.
The icons created with XBM_EDIT can be saved in two different file formats. IDL "array definition files" are text files that can be inserted into IDL programs. "Bitmap array files" are data files that can be read into IDL programs. Bitmap array files should be used temporarily until the final icon design is determined and then they can be saved as IDL array definitions for inclusion in the final widget code. This routine does not check the file types of the files being read and assumes that they are of the correct size and type for reading. XBM_EDIT maintains its state in a common block so it is restricted to one working copy at a time.
This routine is written in the IDL language. Its source code can be found in the file
xbm_edit.pro
in the
lib
subdirectory of the IDL distribution.
Set this keyword to have XMANAGER block when this application is registered. By default, BLOCK is set equal to zero, providing access to the command line if active command line processing is available. Note that setting BLOCK=1 will cause all widget applications to block, not just this application. For more information, see the documentation for the NO_BLOCK keyword to XMANAGER .
Set this keyword to a scalar string that contains the filename to be used for the new icon. If this argument is not specified, the name "idl.bm" is used. The filename can be changed in XBM_EDIT by editing the "Filename" field before selecting a file option.
The widget ID of the widget that calls XBM_EDIT. When this ID is specified, the death of the caller results in the death of XBM_EDIT.