home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / bitmap.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  28.0 KB  |  859 lines

  1.  
  2.  
  3.  
  4. BITMAP(1)                        BITMAP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        bitmap,    bmtoa, atobm - bitmap editor and converter utili-
  9.        ties for the X Window System
  10.  
  11. SSYYNNOOPPSSIISS
  12.        bbiittmmaapp [ _-_o_p_t_i_o_n_s ... ] [ _f_i_l_e_n_a_m_e ] [ _b_a_s_e_n_a_m_e ]
  13.  
  14.        bbmmttooaa [ --cchhaarrss ... ] [ _f_i_l_e_n_a_m_e ]
  15.  
  16.        aattoobbmm [ --cchhaarrss _c_c ] [ --nnaammee _v_a_r_i_a_b_l_e ] [ --xxhhoott _n_u_m_b_e_r ]    [
  17.        --yyhhoott _n_u_m_b_e_r ] [ _f_i_l_e_n_a_m_e ]
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.        The  _b_i_t_m_a_p  program is a rudimentary tool for creating or
  21.        editing    rectangular  images  made  up  of  1's    and  0's.
  22.        Bitmaps    are used in X for defining clipping regions, cur-
  23.        sor shapes, icon shapes, and tile and stipple patterns.
  24.  
  25.        The _b_m_t_o_a and _a_t_o_b_m filters  convert  _b_i_t_m_a_p  files  (FILE
  26.        FORMAT) to and from ASCII strings.  They are most commonly
  27.        used to quickly print out bitmaps and to generate versions
  28.        for including in text.
  29.  
  30. CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
  31.        _B_i_t_m_a_p  supports the standard X Toolkit command line argu-
  32.        ments (see _X(1)).  The following additional arguments  are
  33.        supported as well.
  34.  
  35.        --ssiizzee _W_I_D_T_H_x_H_E_I_G_H_T
  36.        Specifies size of the grid in squares.
  37.  
  38.        --ssww _d_i_m_e_n_s_i_o_n
  39.        Specifies the width of squares in pixels.
  40.  
  41.        --sshh _d_i_m_e_n_s_i_o_n
  42.        Specifies the height of squares in pixels.
  43.  
  44.        --ggtt _d_i_m_e_n_s_i_o_n
  45.        Grid     tolerance.   If the square dimensions fall below
  46.        the specified value, grid will be automatically turned
  47.        off.
  48.  
  49.        --ggrriidd,, ++ggrriidd
  50.        Turns on or off the grid lines.
  51.  
  52.        --aaxxeess,, ++aaxxeess
  53.        Turns on or off the major axes.
  54.  
  55.        --ddaasshheedd,, ++ddaasshheedd
  56.        Turns  on or off dashing for the frame and grid lines.
  57.  
  58.        --ssttiipppplleedd,, ++ssttiipppplleedd
  59.        Turns on or off stippling of highlighted squares.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BITMAP(1)                        BITMAP(1)
  71.  
  72.  
  73.        --pprrooppoorrttiioonnaall,, ++pprrooppoorrttiioonnaall
  74.        Turns proportional mode on or  off.     If  proportional
  75.        mode     is  on,  square width is equal to square height.
  76.        If proportional mode     is  off,  _b_i_t_m_a_p  will     use  the
  77.        smaller  square dimension, if they were initially dif-
  78.        ferent.
  79.  
  80.        --ddaasshheess _f_i_l_e_n_a_m_e
  81.        Specifies the bitmap to be used as a stipple for dash-
  82.        ing.
  83.  
  84.        --ssttiippppllee _f_i_l_e_n_a_m_e
  85.        Specifies the bitmap to be used as a stipple for high-
  86.        lighting.
  87.  
  88.        --hhll _c_o_l_o_r
  89.        Specifies the color used for highlighting.
  90.  
  91.        --ffrr _c_o_l_o_r
  92.        Specifies the color used for the frame and grid lines.
  93.  
  94.        ffiilleennaammee
  95.        Specifies  the  bitmap to be initially loaded into the
  96.        program.  If the file  does    not  exist,  _b_i_t_m_a_p  will
  97.        assume it is a new file.
  98.  
  99.        bbaasseennaammee
  100.        Specifies the basename to be used in the C code output
  101.        file.  If it is different than  the    basename  in  the
  102.        working  file,  _b_i_t_m_a_p  will change it when saving the
  103.        file.
  104.  
  105.        _B_m_t_o_a accepts the following option:
  106.  
  107.        --cchhaarrss _c_c
  108.        This option specifies the pair of characters to use in
  109.        the string version of the bitmap.  The first character
  110.        is used for 0 bits and the second  character     is  used
  111.        for    1 bits.     The default is to use dashes (-) for 0's
  112.        and sharp signs (#) for 1's.
  113.  
  114.        _A_t_o_b_m accepts the following options:
  115.  
  116.        --cchhaarrss _c_c
  117.        This option specifies the pair of  characters  to  use
  118.        when converting string bitmaps into arrays of numbers.
  119.        The first character represents a 0 bit and the  second
  120.        character  represents  a 1 bit.  The default is to use
  121.        dashes (-) for 0's and sharp signs (#) for 1's.
  122.  
  123.        --nnaammee _v_a_r_i_a_b_l_e
  124.        This option specifies the variable  name  to     be  used
  125.        when     writing  out the bitmap file.    The default is to
  126.        use the basename of the _f_i_l_e_n_a_m_e command line argument
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BITMAP(1)                        BITMAP(1)
  137.  
  138.  
  139.        or leave it blank if the standard input is read.
  140.  
  141.        --xxhhoott _n_u_m_b_e_r
  142.        This option specifies the X coordinate of the hotspot.
  143.        Only positive values     are  allowed.     By  default,  no
  144.        hotspot information is included.
  145.  
  146.        --yyhhoott _n_u_m_b_e_r
  147.        This option specifies the Y coordinate of the hotspot.
  148.        Only positive values     are  allowed.     By  default,  no
  149.        hotspot information is included.
  150.  
  151. UUSSAAGGEE
  152.        _B_i_t_m_a_p  displays     grid  in  which each square represents a
  153.        single bit in the picture being edited.     Actual     size  of
  154.        the bitmap image, as it would appear normaly and inverted,
  155.        can be obtained by pressing MMeettaa--II key.    You are     free  to
  156.        move  the  image popup out of the way to continue editing.
  157.        Pressing the left mouse button  in  the    popup  window  or
  158.        MMeettaa--II again will remove the real size bitmap image.
  159.  
  160.        If  the bitmap is to be used for defining a cursor, one of
  161.        the squares in the images may be     designated  as     the  hot
  162.        spot.  This determines where the cursor is actually point-
  163.        ing.  For cursors with sharp tips (such as arrows or  fin-
  164.        gers),  this is usually at the end of the tip; for symmet-
  165.        ric cursors (such as crosses or bullseyes), this     is  usu-
  166.        ally at the center.
  167.  
  168.        Bitmaps    are stored as small C code fragments suitable for
  169.        including in applications.  They provide an array of  bits
  170.        as  well     as  symbolic constants giving the width, height,
  171.        and hot spot (if specified) that may be used  in     creating
  172.        cursors, icons, and tiles.
  173.  
  174. EEDDIITTIINNGG
  175.        To  edit a bitmap image simply click on one of the buttons
  176.        with drawing  commands  (PPooiinntt,,    CCuurrvvee,,    LLiinnee,,  RReeccttaannggllee,,
  177.        etc.)  and  move the pointer into the bitmap grid  window.
  178.        Press one of the buttons on your mouse and the appropriate
  179.        action  will  take  place.   You     can either set, clear or
  180.        invert the gird squares.     Setting  a  grid  square  corre-
  181.        sponds  to setting a bit in the bitmap image to 1.  Clear-
  182.        ing a grid square corresponds to     setting  a  bit  in  the
  183.        bitmap image to 0.  Inverting a grid square corresponds to
  184.        changing a bit in the bitmap image from 0 to 1 or 1 to  0,
  185.        depending  what its previous state was. The default behav-
  186.        ior of mouse buttons is as specified below.
  187.  
  188.          MouseButton1         Set
  189.          MouseButton2         Invert
  190.          MouseButton3         Clear
  191.          MouseButton4         Clear
  192.          MouseButton5         Clear
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. BITMAP(1)                        BITMAP(1)
  203.  
  204.  
  205.        This default behavior can be changed by setting the button
  206.        function resources.  An example is provided below.
  207.  
  208.          bitmap*button1Function: Set
  209.          bitmap*button2Function: Clear
  210.          bitmap*button3Function: Invert
  211.          etc.
  212.  
  213.        The  button  function  applies  to  all    drawing commands,
  214.        including copying, moving and pasting, flood  filling  and
  215.        setting the hot spot.
  216.  
  217. DDRRAAWWIINNGG CCOOMMMMAANNDDSS
  218.        Here  is     the  list of drawing commands accessible through
  219.        the buttons at the left side of the application's  window.
  220.        Some  commands  can  be    aborted     by pressing A inside the
  221.        bitmap window, allowing the user to select different guid-
  222.        ing points where applicable.
  223.  
  224.        CClleeaarr
  225.        This command clears all bits in the bitmap image.  The
  226.        grid squares will be     set  to  the  background  color.
  227.        Pressing  C    inside    the  bitmap  window  has the same
  228.        effect.
  229.  
  230.        SSeett This command sets all bits in the bitmap  image.   The
  231.        grid     squares  will    be  set     to the foreground color.
  232.        Pressing S inside  the  bitmap  window  has    the  same
  233.        effect.
  234.  
  235.        IInnvveerrtt
  236.        This     command  inverts  all    bits in the bitmap image.
  237.        The    grid  squares  will  be     inverted  appropriately.
  238.        Pressing  I    inside    the  bitmap  window  has the same
  239.        effect.
  240.  
  241.        MMaarrkk
  242.        This command is used to mark an area of  the     grid  by
  243.        dragging  out  a rectangular shape in the highlighting
  244.        color.  Once the area is marked, it can be operated on
  245.        by  a  number  of commands (see UUpp,, DDoowwnn,, LLeefftt,, RRiigghhtt,,
  246.        RRoottaattee,, FFlliipp,, CCuutt,, etc.)  Only one marked area can  be
  247.        present  at    any time.  If you attempt to mark another
  248.        area, the old mark will vanish.  The same  effect  can
  249.        be  achieved     by pressing SShhiifftt--MMoouusseeBBuuttttoonn11 and drag-
  250.        ging out a rectangle in  the     grid  window.     Pressing
  251.        SShhiifftt--MMoouusseeBBuuttttoonn22 will mark the entire grid area.
  252.  
  253.        UUnnmmaarrkk
  254.        This     command  will    cause  the marked area to vanish.
  255.        The same effect can be  achieved  by     pressing  SShhiifftt--
  256.        MMoouusseeBBuuttttoonn33.
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. BITMAP(1)                        BITMAP(1)
  269.  
  270.  
  271.        CCooppyy
  272.        This     command is used to copy an area of the grid from
  273.        one location to another.  If there is no  marked  grid
  274.        area     displayed, CCooppyy behaves just like MMaarrkk described
  275.        above.  Once there is a marked grid area displayed  in
  276.        the    highlighting color, this command has two alterna-
  277.        tive behaviors.  If you click a  mouse  button  inside
  278.        the    marked area, you will be able to drag the rectan-
  279.        gle that represents the marked  area     to  the  desired
  280.        location.   After  you  release  the mouse button, the
  281.        area will be copied.     If you click outside the  marked
  282.        area, CCooppyy will assume that you wish to mark a differ-
  283.        ent region of the bitmap image, thus     it  will  behave
  284.        like MMaarrkk again.
  285.  
  286.        MMoovvee
  287.        This     command is used to move an area of the grid from
  288.        one location to another.  Its behavior  resembles  the
  289.        behavior  of CCooppyy command, except that the marked area
  290.        will be moved instead of copied.
  291.  
  292.        FFlliipp HHoorriizzoonnttaallllyy
  293.        This command will flip the bitmap image  with  respect
  294.        to  the horizontal axes.  If a marked area of the grid
  295.        is highlighted, it will operate only inside the marked
  296.        area.   Pressing  H    inside    the bitmap window has the
  297.        same effect.
  298.  
  299.        UUpp  This command moves the bitmap image one pixel up.   If
  300.        a  marked  area  of    the  grid is highlighted, it will
  301.        operate only inside the marked area.     Pressing UpArrow
  302.        inside the bitmap window has the same effect.
  303.  
  304.        FFlliipp VVeerrttiiccaallllyy
  305.        This     command  will flip the bitmap image with respect
  306.        to the vertical axes.  If a marked area of the grid is
  307.        highlighted,     it  will  operate only inside the marked
  308.        area.  Pressing V inside the     bitmap     window     has  the
  309.        same effect.
  310.  
  311.        LLeefftt
  312.        This     command  moves the bitmap image one pixel to the
  313.        left.  If a marked area of the grid is highlighted, it
  314.        will     operate  only    inside the marked area.     Pressing
  315.        LeftArrow  inside  the  bitmap  window  has    the  same
  316.        effect.
  317.  
  318.        FFoolldd
  319.        This     command  will    fold the bitmap image so that the
  320.        opposite corners become adjacent.  This is useful when
  321.        creating  bitmap images for tiling.    Pressing F inside
  322.        the bitmap window has the same effect.
  323.  
  324.  
  325.  
  326.  
  327.  
  328. X Version 11           Release 6.1                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. BITMAP(1)                        BITMAP(1)
  335.  
  336.  
  337.        RRiigghhtt
  338.        This command moves the bitmap image one pixel  to  the
  339.        right.   If    a marked area of the grid is highlighted,
  340.        it will operate only inside the marked area.     Pressing
  341.        RightArrow  inside  the  bitmap  window  has     the same
  342.        effect.
  343.  
  344.        RRoottaattee LLeefftt
  345.        This command rotates the bitmap image  90  degrees  to
  346.        the left (counter clockwise.)  If a marked area of the
  347.        grid is highlighted, it will operate only  inside  the
  348.        marked  area.  Pressing L inside the bitmap window has
  349.        the same effect.
  350.  
  351.        DDoowwnn
  352.        This command moves the bitmap image    one  pixel  down.
  353.        If  a  marked area of the grid is highlighted, it will
  354.        operate only inside the marked area.     Pressing DownAr-
  355.        row inside the bitmap window has the same effect.
  356.  
  357.        RRoottaattee RRiigghhtt
  358.        This     command  rotates  the bitmap image 90 degrees to
  359.        the right (clockwise.)  If a marked area of    the  grid
  360.        is highlighted, it will operate only inside the marked
  361.        area.  Pressing R inside the     bitmap     window     has  the
  362.        same effect.
  363.  
  364.        PPooiinntt
  365.        This     command  will change the grid squares underneath
  366.        the mouse pointer if a mouse button is  being  pressed
  367.        down.   If you drag the mouse button continuously, the
  368.        line may not be continuous, depending on the speed  of
  369.        your system and frequency of mouse motion events.
  370.  
  371.        CCuurrvvee
  372.        This     command  will change the grid squares underneath
  373.        the mouse pointer if a mouse button is  being  pressed
  374.        down.   If  you drag the mouse button continuously, it
  375.        will make sure that the line is continuous.     If  your
  376.        system  is  slow  or     _b_i_t_m_a_p     receives  very few mouse
  377.        motion events, it might behave quite strangely.
  378.  
  379.        LLiinnee
  380.        This command will change the gird squares  in  a  line
  381.        between two squares.     Once you press a mouse button in
  382.        the grid window, _b_i_t_m_a_p will highlight the  line  from
  383.        the    square    where  the  mouse  button  was    initially
  384.        pressed to the  square  where  the  mouse  pointer  is
  385.        located.  By releasing the mouse button you will cause
  386.        the change to take effect, and  the    highlighted  line
  387.        will disappear.
  388.  
  389.        RReeccttaannggllee
  390.        This     command  will    change    the  gird  squares  in    a
  391.  
  392.  
  393.  
  394. X Version 11           Release 6.1                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. BITMAP(1)                        BITMAP(1)
  401.  
  402.  
  403.        rectangle between two squares.  Once you press a mouse
  404.        button  in  the grid window, _b_i_t_m_a_p will highlight the
  405.        rectangle from the square where the mouse  button  was
  406.        initially  pressed  to  the    square    where  the  mouse
  407.        pointer is located.    By releasing the mouse button you
  408.        will     cause    the  change to take effect, and the high-
  409.        lighted rectangle will disappear.
  410.  
  411.        FFiilllleedd RReeccttaannggllee
  412.        This command is identical to RReeccttaannggllee, except at  the
  413.        end the rectangle will be filled rather than outlined.
  414.  
  415.        CCiirrccllee
  416.        This command will change the gird squares in a  circle
  417.        between two squares.     Once you press a mouse button in
  418.        the grid window, _b_i_t_m_a_p will highlight the circle from
  419.        the    square    where  the  mouse  button  was    initially
  420.        pressed to the  square  where  the  mouse  pointer  is
  421.        located.  By releasing the mouse button you will cause
  422.        the change to take effect, and the highlighted  circle
  423.        will disappear.
  424.  
  425.        FFiilllleedd CCiirrccllee
  426.        This command is identical to CCiirrccllee, except at the end
  427.        the circle will be filled rather than outlined.
  428.  
  429.        FFlloooodd FFiillll
  430.        This command will flood fill the connected area under-
  431.        neath  the mouse pointer when you click on the desired
  432.        square.  Diagonally adjacent squares are  not  consid-
  433.        ered to be connected.
  434.  
  435.        SSeett HHoott SSppoott
  436.        This     command designates one square in the grid as the
  437.        hot spot if this bitmap image is to be used for defin-
  438.        ing    a cursor.  Pressing a mouse button in the desired
  439.        square will cause a diamond shape to be displayed.
  440.  
  441.        CClleeaarr HHoott SSppoott
  442.        This command removes any designated hot spot from  the
  443.        bitmap image.
  444.  
  445.        UUnnddoo
  446.        This     command will undo the last executed command.  It
  447.        has depth one, that is, pressing UUnnddoo after UUnnddoo  will
  448.        undo itself.
  449.  
  450. FFIILLEE MMEENNUU
  451.        The  File  menu    commands  can be accessed by pressing the
  452.        File button and selecting the appropriate menu  entry,  or
  453.        by  pressing  Ctrl  key    with another key.  These commands
  454.        deal with files and  global  bitmap  parameters,     such  as
  455.        size, basename, filename etc.
  456.  
  457.  
  458.  
  459.  
  460. X Version 11           Release 6.1                7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. BITMAP(1)                        BITMAP(1)
  467.  
  468.  
  469.        NNeeww This     command  will    clear the editing area and prompt
  470.        for the name of the new file to be  edited.     It  will
  471.        not load in the new file.
  472.  
  473.        LLooaadd
  474.        This     command  is  used to load a new bitmap file into
  475.        the bitmap editor.  If the current image has not  been
  476.        saved,  user     will  be asked whether to save or ignore
  477.        the changes.     The editor can edit only one file  at    a
  478.        time.   If  you need interactive editing, run a number
  479.        of  editors    and  use  cut  and  paste  mechanism   as
  480.        described below.
  481.  
  482.        IInnsseerrtt
  483.        This     command is used to insert a bitmap file into the
  484.        image being currently edited.   After  being     prompted
  485.        for    the  filename,    click  inside the grid window and
  486.        drag the outlined rectangle to the location where  you
  487.        want to insert the new file.
  488.  
  489.        SSaavvee
  490.        This     command will save the bitmap image.  It will not
  491.        prompt for the  filename  unless  it     is  said  to  be
  492.        <none>.   If you leave the filename undesignated or -,
  493.        the output will be piped to stdout.
  494.  
  495.        SSaavvee AAss
  496.        This command will save the bitmap image after  prompt-
  497.        ing for a new filename.  It should be used if you want
  498.        to change the filename.
  499.  
  500.        RReessiizzee
  501.        This command is used to resize the editing area to the
  502.        new    number    of pixels.  The size should be entered in
  503.        the WIDTHxHEIGHT format.  The information in the image
  504.        being  edited  will not be lost unless the new size is
  505.        smaller that the current image size.     The  editor  was
  506.        not designed to edit huge files.
  507.  
  508.        RReessccaallee
  509.        This     command  is  used to rescale the editing area to
  510.        the new width and height.  The size should be  entered
  511.        in the WIDTHxHEIGHT format.    It will not do antialias-
  512.        ing and information will be lost if you rescale to the
  513.        smaller  sizes.   Feel  free to add you own algorithms
  514.        for better rescaling.
  515.  
  516.        FFiilleennaammee
  517.        This command is used to change  the    filename  without
  518.        changing  the  basename  nor     saving the file.  If you
  519.        specify - for a filename, the output will be piped  to
  520.        stdout.
  521.  
  522.  
  523.  
  524.  
  525.  
  526. X Version 11           Release 6.1                8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. BITMAP(1)                        BITMAP(1)
  533.  
  534.  
  535.        BBaasseennaammee
  536.        This command is used to change the basename, if a dif-
  537.        ferent one from the specified filename is desired.
  538.  
  539.        QQuuiitt
  540.        This command will terminate    the  bitmap  application.
  541.        If  the  file was not saved, user will be prompted and
  542.        asked whether to save the image or not.  This  command
  543.        is preferred over killing the process.
  544.  
  545. EEDDIITT MMEENNUU
  546.        The  Edit  menu    commands  can be accessed by pressing the
  547.        Edit button and selecting the appropriate menu  entry,  or
  548.        by  pressing  Meta  key    with another key.  These commands
  549.        deal with editing facilities such as grid, axes,     zooming,
  550.        cut and paste, etc.
  551.  
  552.        IImmaaggee
  553.        This     command  will display the image being edited and
  554.        its inverse in its actual size in a    separate  window.
  555.        The window can be moved away to continue with editing.
  556.        Pressing the left mouse button  in  the  image  window
  557.        will cause it to disappear from the screen.
  558.  
  559.        GGrriidd
  560.        This     command  controls  the grid in the editing area.
  561.        If the grid spacing is below the  value  specified  by
  562.        gridTolerance  resource  (8 by default), the grid will
  563.        be automatically turned off.     It can     be  enforced  by
  564.        explicitly activating this command.
  565.  
  566.        DDaasshheedd
  567.        This command controls the stipple for drawing the grid
  568.        lines.  The stipple specified by dashes  resource  can
  569.        be turned on or off by activating this command.
  570.  
  571.        AAxxeess
  572.        This     command  controls  the     highlighting of the main
  573.        axes of the image being edited.  The actual lines  are
  574.        not    part of the image.  They are provided to aid user
  575.        when constructing symmetrical images, or whenever hav-
  576.        ing the main axes highlighted helps your editing.
  577.  
  578.        SSttiipppplleedd
  579.        This command controls the stippling of the highlighted
  580.        areas of the bitmap image.  The stipple  specified  by
  581.        stipple resource can be turned on or off by activating
  582.        this command.
  583.  
  584.        PPrrooppoorrttiioonnaall
  585.        This command controls the proportional mode.      If  the
  586.        proportional mode is on, width and height of all image
  587.        squares are forced to be equal, regardless of the pro-
  588.        portions of the bitmap window.
  589.  
  590.  
  591.  
  592. X Version 11           Release 6.1                9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. BITMAP(1)                        BITMAP(1)
  599.  
  600.  
  601.        ZZoooomm
  602.        This     command  controls  the zoom mode.  If there is a
  603.        marked area of the  image  already  displayed,  bitmap
  604.        will automatically zoom into it.  Otherwise, user will
  605.        have to highlight an area to be  edited  in    the  zoom
  606.        mode     and  bitmap  will  automatically switch into it.
  607.        One can use all the editing commands and other  utili-
  608.        ties     in  the zoom mode.  When you zoom out, undo com-
  609.        mand will undo the whole zoom session.
  610.  
  611.        CCuutt This commands cuts the  contents  of     the  highlighted
  612.        image area into the internal cut and paste buffer.
  613.  
  614.        CCooppyy
  615.        This     command  copies  the contents of the highlighted
  616.        image area into the internal cut and paste buffer.
  617.  
  618.        PPaassttee
  619.        This command will check if there are any other  bitmap
  620.        applications     with  a  highlighted  image  area, or if
  621.        there is something  in  the    internal  cut  and  paste
  622.        buffer  and copy it to the image.  To place the copied
  623.        image, click in the editing window and drag    the  out-
  624.        lined image to the position where you want to place i,
  625.        and then release the button.
  626.  
  627. CCUUTT AANNDD PPAASSTTEE
  628.        Bitmap supports two cut and paste mechanisms; the internal
  629.        cut  and     paste    and the global X selection cut and paste.
  630.        The internal cut and paste is used when executing copy and
  631.        move  drawing commands and also cut and copy commands from
  632.        the edit menu.  The global X selection cut  and    paste  is
  633.        used  whenever  there  is  a  highlighted area of a bitmap
  634.        image displayed anywhere on the screen.    To copy a part of
  635.        image  from  another  bitmap  editor  simply highlight the
  636.        desired area by using the Mark  command    or  pressing  the
  637.        shift  key  and dragging the area with the left mouse but-
  638.        ton.  When the  selected     area  becomes    highlighted,  any
  639.        other  applications (such as xterm, etc.) that use primary
  640.        selection will discard their selection values and  unhigh-
  641.        light  the  appropriate    information.   Now, use the Paste
  642.        command for the Edit menu or control mouse button to  copy
  643.        the  selected  part  of    image  into another (or the same)
  644.        bitmap application.  If you attempt to do this  without    a
  645.        visible    highlighted image area, the bitmap will fall back
  646.        to the internal cut and paste buffer  and  paste     whatever
  647.        was there stored at the moment.
  648.  
  649. WWIIDDGGEETTSS
  650.        Below  is  the widget structure of the _b_i_t_m_a_p application.
  651.        Indentation indicates hierarchical structure.  The  widget
  652.        class name is given first, followed by the widget instance
  653.        name.  All widgets except the bitmap widget are    from  the
  654.        standard Athena widget set.
  655.  
  656.  
  657.  
  658. X Version 11           Release 6.1                   10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. BITMAP(1)                        BITMAP(1)
  665.  
  666.  
  667.         Bitmap bitmap
  668.          TransientShell image
  669.               Box box
  670.                Label normalImage
  671.                Label invertedImage
  672.          TransientShell input
  673.               Dialog dialog
  674.                Command okay
  675.                Command cancel
  676.          TransientShell error
  677.               Dialog dialog
  678.                Command abort
  679.                Command retry
  680.          TransientShell qsave
  681.               Dialog dialog
  682.                Command yes
  683.                Command no
  684.                Command cancel
  685.          Paned parent
  686.               Form formy
  687.                MenuButton fileButton
  688.                SimpleMenu fileMenu
  689.                 SmeBSB    new
  690.                 SmeBSB    load
  691.                 SmeBSB    insert
  692.                 SmeBSB    save
  693.                 SmeBSB    saveAs
  694.                 SmeBSB    resize
  695.                 SmeBSB    rescale
  696.                 SmeBSB    filename
  697.                 SmeBSB    basename
  698.                 SmeLine line
  699.                 SmeBSB    quit
  700.                MenuButton editButton
  701.                SimpleMenu editMenu
  702.                 SmeBSB    image
  703.                 SmeBSB    grid
  704.                 SmeBSB    dashed
  705.                 SmeBSB    axes
  706.                 SmeBSB    stippled
  707.                 SmeBSB    proportional
  708.                 SmeBSB    zoom
  709.                 SmeLine line
  710.                 SmeBSB    cut
  711.                 SmeBSB    copy
  712.                 SmeBSB    paste
  713.                Label status
  714.               Pane pane
  715.                Bitmap bitmap
  716.                Form form
  717.                 Command clear
  718.                 Command set
  719.                 Command invert
  720.                 Toggle    mark
  721.  
  722.  
  723.  
  724. X Version 11           Release 6.1                   11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. BITMAP(1)                        BITMAP(1)
  731.  
  732.  
  733.                 Command unmark
  734.                 Toggle    copy
  735.                 Toggle    move
  736.                 Command flipHoriz
  737.                 Command up
  738.                 Command flipVert
  739.                 Command left
  740.                 Command fold
  741.                 Command right
  742.                 Command rotateLeft
  743.                 Command down
  744.                 Command rotateRight
  745.                 Toggle    point
  746.                 Toggle    curve
  747.                 Toggle    line
  748.                 Toggle    rectangle
  749.                 Toggle    filledRectangle
  750.                 Toggle    circle
  751.                 Toggle    filledCircle
  752.                 Toggle    floodFill
  753.                 Toggle    setHotSpot
  754.                 Command clearHotSpot
  755.                 Command undo
  756.  
  757. CCOOLLOORRSS
  758.        If  you would like bitmap to be viewable in color, include
  759.        the following in the #ifdef COLOR section of the file  you
  760.        read with xrdb:
  761.  
  762.        *customization:               -color
  763.  
  764.        This  will  cause bitmap to pick up the colors in the app-
  765.        defaults color customization file:
  766.  
  767.        <XRoot>/lib/X11/app-defaults/Bitmap-color
  768.  
  769.        where <XRoot> refers to the root of the X11 install  tree.
  770.  
  771. BBIITTMMAAPP WWIIDDGGEETT
  772.        Bitmap  widget  is a stand-alone widget for editing raster
  773.        images.    It is not designed to edit large images, although
  774.        it  may be used in that purpose as well.     It can be freely
  775.        incorporated with other applications and used as     a  stan-
  776.        dard  editing  tool.  The following are the resources pro-
  777.        vided by the bitmap widget.
  778.  
  779.        Bitmap Widget
  780.  
  781.        Header file       Bitmap.h
  782.        Class           bitmapWidgetClass
  783.        Class Name       Bitmap
  784.        Superclass       Bitmap
  785.  
  786.  
  787.  
  788.  
  789.  
  790. X Version 11           Release 6.1                   12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. BITMAP(1)                        BITMAP(1)
  797.  
  798.  
  799.        All the Simple Widget resources plus ...
  800.  
  801.        Name           Class           Type           Default Value
  802.  
  803.        foreground      Foreground      Pixel           XtDefaultForeground
  804.        highlight       Highlight       Pixel           XtDefaultForeground
  805.        framing           Framing           Pixel           XtDefaultForeground
  806.        gridTolerance   GridTolerance   Dimension       8
  807.        size           Size           String           32x32
  808.        dashed           Dashed           Boolean           True
  809.        grid           Grid           Boolean           True
  810.        stippled           Stippled           Boolean           True
  811.        proportional    Proportional    Boolean           True
  812.        axes           Axes           Boolean           False
  813.        squareWidth     SquareWidth     Dimension       16
  814.        squareHeight    SquareHeight    Dimension       16
  815.        margin           Margin           Dimension       16
  816.        xHot           XHot           Position           NotSet (-1)
  817.        yHot           YHot           Position           NotSet (-1)
  818.        button1Function Button1Function DrawingFunction Set
  819.        button2Function Button2Function DrawingFunction Invert
  820.        button3Function Button3Function DrawingFunction Clear
  821.        button4Function Button4Function DrawingFunction Invert
  822.        button5Function Button5Function DrawingFunction Invert
  823.        filename           Filename           String           None ("")
  824.        basename           Basename           String           None ("")
  825.  
  826.  
  827. AAUUTTHHOORR
  828.        Davor Matic, MIT X Consortium
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. X Version 11           Release 6.1                   13
  857.  
  858.  
  859.