packages icon



 XACTE(l)                           NCAR                            XACTE(l)
 NCAR/ATD/RDP Local Command                       NCAR/ATD/RDP Local Command

                                November 1993



 NAME
      xacte - the X Answer to Color Table Editors

 SYNOPSIS
      xacte [ number_of_colors ]


 DESCRIPTION
      Xacte is a general purpose color table editor with numerous editing
      functions and an X11 graphical user interface.  The xacte window
      consists of a primary color slider area on the left, a color cell area
      on the right, and a function button area on the top.


 ADJUSTING COLORS
      The currently selected color cell's color can be set by adjusting the
      values of the three additive primary colors (red, green, and blue)
      using a mouse and X sliders.  Clicking the left mouse button on one of
      the primary color sliders causes the amount of the primary in the
      selected color cell to increment.  Clicking the right mouse button
      causes the primary to decrement.  Clicking and dragging the middle
      mouse button causes the primary to move with the mouse.  There is a
      hexadecimal numeric display over each primary color slider that
      indicates the current value.


 SELECTING COLOR CELLS
      To select a particular color cell simply click on the empty black
      "selector" box above the desired cell with the left mouse button.  A *
      character will appear in the selector box.  The primary sliders now
      control the color in that cell.  To select another cell, either click
      on another selector or use the green arrow buttons "<<", "<", ">", and
      ">>" which will select the far left cell, the next cell to the left,
      the next cell to the right, or the far right cell.  Many of the
      functions cover a sequential group of cells and require a second cell
      selection.  These functions have yellow buttons.  To mark the
      secondary selection, place the mouse over the desired cell and press
      the right mouse button.  A ^ character will appear in the selector
      box.

      [<>] The <> button causes the two marks, * and ^ to exchange places.
      This function is useful for setting new endpoint colors while using
      the two-marker functions.


 FUNCTIONS
      Most of the buttons on the top two rows control the various functions
      that xacte can perform.  All functions are selected by moving the
      mouse pointer over the button and pressing the left mouse button.



                                    - 1 -      Formatted:  November 14, 2024






 XACTE(l)                           NCAR                            XACTE(l)
 NCAR/ATD/RDP Local Command                       NCAR/ATD/RDP Local Command

                                November 1993



      [Quit] The Quit button causes xacte to exit to the operating system,
      no questions asked.

      [Clear] The Clear button causes xacte to clear all of the color cells
      to the initial state and reset the pointers.

      [Insert] The Insert button causes all of the color cells from the *
      selected cell to the right to move right one space.  A gray cell is
      inserted at the *.  This function is useful for adding new colors to a
      table.  Note that the right most color will fall off the end.

      [Remove] The Remove button causes the color at the * selected cell to
      disappear and all of the cells to the right of the * move to the left
      one space.  A gray cell is inserted at the right side of the table.
      This function is used for removing colors from a table.

      [Preset] The Preset button causes the color at the * selected cell to
      change to one of several preset colors.  This function is useful for
      starting work on a new table.

      [Span] The Span button causes the color at the * mark to be spread
      between the cells marked with the * and ^ characters.  This function
      is useful for creating tables with large blocks of the same color.

      [Swap] The Swap button causes the colors at the * and ^ marked cells
      to exchange places.  This function is useful for changing the order of
      the colors in a table.

      [Flip] The Flip button causes all of the colors between the * and ^
      marks to reverse positions.  The Flip function is useful for inverting
      the order of a section of a color table.

      [Move<] The Move< button causes all of the colors between the * and ^
      marks to move to the left one position.  The two marks move with the
      colors.  The color cell on the left of the moved section moves to the
      right of the section.

      [Move>] The Move> button causes all of the colors between the * and ^
      marks to move to the right one position.  The two marks move with the
      colors.  The color cell on the left right of the moved section moves
      to the left of the section.  The move functions are useful for
      changing the placement of a group of colors within the color table.

      [Roll<] The Roll< button causes all of the colors between the * and ^
      marks to shift to the left one position with the left most color
      moving to the right most position.

      [Roll>] The Roll> button causes all of the colors between the * and ^
      marks to shift to the right one position with the right most color



                                    - 2 -      Formatted:  November 14, 2024






 XACTE(l)                           NCAR                            XACTE(l)
 NCAR/ATD/RDP Local Command                       NCAR/ATD/RDP Local Command

                                November 1993



      moving to the left most position.  The Roll functions are useful for
      reordering color tables.

      [Flip] The Flip button causes all of the colors between the * and ^
      marks to reverse positions.  The Flip function is useful for inverting
      the order of a section of a color table.

      [Smooth] The Smooth button creates a smooth color transition between
      the cells marked with the * and ^ characters.  The colors at the end
      points do not change and all colors in between will be replaced.  This
      function is useful for creating smoothly changing color tables.

      [Smear] The Smear button performs a low-pass filter operation on the
      cells between the * and ^ characters.  The colors at the end points do
      not change and the colors in between will be modified to be closer to
      the colors of their neighboring colors.  This function is used to even
      out the transitions in a table with many different color values.  The
      Smear button may be pressed multiple times for more effect.


 UNDO
      [Undo] The Undo button reverses the effect of the previous color
      change.  Undo does not change either of the color selector positions.


 FILE I/O
      [Read] The Read button causes xacte to pop up the file selector
      widget.  To read in a file, move the mouse into the white text area on
      the filename widget, type in the name of the file that you would like
      to read, and press the OK button or a carriage return.  If you change
      your mind and don't want to read a file, press the Cancel button.  If
      the file is not in the current directory, specify the full path of the
      file.  Note that the current file type must match the file you are
      reading.  See the next function for details.

      [Type] The Type button causes xacte to cycle through all of the color
      table file types that it supports.  All file read and write functions
      will use the current type.  The default type is ASCII.  Currently, the
      following types are supported: ASCII (Human readable), PS
      (PostScript), CFM (RDSS Radar Editor and Perusal) and Zeb.  Note that
      the CFM type has a fixed length of 128 colors.

      [Write] The Write button causes xacte to pop up the file selector
      widget.  See the Read function above for details.  The file will be
      written in the format of the currently selected Type.


 FILES
      Note: this refers to an NCAR directory that is not in the



                                    - 3 -      Formatted:  November 14, 2024






 XACTE(l)                           NCAR                            XACTE(l)
 NCAR/ATD/RDP Local Command                       NCAR/ATD/RDP Local Command

                                November 1993



      distribution.  There are some useful color tables stored in the
      /rdss/xact/colortable directory and its subdirectories.  A good table
      to read in for experimentation with the editor is
      /rdss/xact/colortable/ascii/rainbow16.asc.


 BUGS
      The * and ^ marks are partially obscured when editing large
      colortables.


 AUTHOR
      G. Forrest Cook, NCAR/ATD/RDP







































                                    - 4 -      Formatted:  November 14, 2024