
Mesa Toolbar Customizer v1.0 fo Mesa 2.1.6

Hi there!
Welcome to the README file for the Mesa Toolbar Customizer.  What is
this?  Well, it's a program to allow you to customize the toolbar in
Mesa for OS/2 to inlcude Icons and Commands that you feel suit your
needs.  You can draw your own bitmaps so that they look like you want
them to.  You also can change the command that is invoked for each
button.

By now, you are thinking: this sounds really cool, how to I use it?
Unfortunately, at this point, we haven't had the time to put a pretty user
interface on it.  This means you're stuck with a command line utility.
Anyway, you just have to run the MESATOOL.EXE program with an input
file as an arguement.  You can also specify the location of the 
Mesa2.INI that Mesa 2.1.6 uses for its settings if it doesn't reside
in the current directory.

What does the input file look like?
Glad you asked.  The file format is as follows:
On the first line, there is 1 number, the size of the gap between 
adjacent tools.  The second line contains 1 number, the height of
the toolbar.  The third line also contains 1 numebr,  the number 
of tools being defined.  Separators are considered tools.

Each subsequesnt line defines one tool as follows:
Tool type:
S  - spacer.  Following the S will be a number defining the number
     of pixels wide the space should be
C  - grayable button
c  - non-grayable button
     Both of these are followed by the command ID, the name of the 
     bitmap, and the Tip Text (contained in quotes) to display in the
     status bar.

For example, the following file would define a toolbar with 4 buttons
and a separator.  It would have a gap size of 5 pixels between buttons
and a height of 32 pixels.  The buttons would all gray themselves when 
they become disabled.

5
32
5
C 3586 CBITMAPS\OPENFILE.BMP "Open a file"
C 4867 CBITMAPS\SAVEFILE.BMP "Save the current file"
S 16
C 4932 CBITMAPS\COPY.BMP "Copy selection to the clipboard"
C 4933 CBITMAPS\PASTE.BMP "Paste selection from the clipboard"


As you can see, this file is not very hard to set up.  The only hard
part is obtaining the command ID for the correct action.  To obtain
these, see the end of this file.  There is a file called default.mtb
that can be used to restore the default toolbar which you can also
look at as an example.

The size of the bitmaps is relatively unimportant.  The size of the
first bitmap is what is used to position the tools along the toolbar.

Also, you may ask, how is all of this possible?  Well, Mesa's toolbar
was designed to be customizable.  The UI for doing so is still under
development, but we decided to allow you, the users, to make use of
this ability until we can officially add this feature to Mesa.
The toolbar saves it's settings like all other aspects of the
program so what this utility does is modify those settings.  Thus,
when Mesa loads, it uses the modified toolbar settings.


At this point, this utility is officially unsupported though Sundial 
Systems.  Basically, this means you use this at your own risk.
If you do have problems (or suggestions), however, you can send them 
to me personally at the below e-mail address.

Enjoy!
J. Daniel Kulp
Software Development Engineer
Sundial Systems Corporation
dan@sundialsystems.com


LEGAL STUFF:
Sundial Systems doesn't have the resources to test this completey.  
Basically this means that you use this at your own risk.  We also 
cannot offer support at this time.  Remember that Mesa is a fast 
evolving product and as it changes, so may the Toolbar code.  
This program might not work for future version.

Trademarks and other stuff:
Mesa is a trademark of Athena Design, Inc. use under license by
      Sundial Systems
OS/2 is a registered trademark of IBM



Command ID's:
Basically, anything that is on one of the Menus can be used for a
button.  To use the menu item as a button, you need to find the
command in the list below.  For the most part, they are aranged by
submenu.  The left column is the name of the command and the right
column gives the command ID.  We will say that we haven't tested 
all of these yet so we can't guarantee that they all work or even 
still exist.  We also can't guarantee that these ID's won't change 
in future versions of Mesa.

                 MID_FILE_MENU  3584
                  MID_FILE_NEW  3585
                 MID_FILE_OPEN  3586
               MID_FILE_IMPORT  4873
                 MID_FILE_SAVE  4867
               MID_FILE_SAVEAS  4868
              MID_FILE_PREVIEW  4869
          MID_FILE_PRINT_SETUP  4870
                MID_FILE_PRINT  4871
                 MID_FILE_EXIT  3592
                MID_FILE_CLOSE  4875
             MID_FILE_ADDLAYER  4876
            MID_FILE_ADDSCRIPT  4877
            MID_FILE_RUNSCRIPT  4878
               MID_FILE_REVERT  3599


                 MID_EDIT_MENU  3648
                 MID_EDIT_UNDO  4929
                 MID_EDIT_REDO  4930
                  MID_EDIT_CUT  4931
                 MID_EDIT_COPY  4932
                MID_EDIT_PASTE  4933
                MID_EDIT_CLEAR  4934
           MID_EDIT_SELECT_ALL  4935
                MID_EDIT_DLEFT  4936
                  MID_EDIT_DUP  4937
               MID_EDIT_IRIGHT  4938
                MID_EDIT_IDOWN  4939
                 MID_EDIT_FIND  4940
                 MID_EDIT_EDIT  4941
             MID_EDIT_DDELINKS  4942
             MID_DDE_PASTELINK  4943


               MID_PASPEC_MENU  3680
             MID_PASPEC_VALUES  4961
             MID_PASPEC_FORMAT  4962
          MID_PASPEC_TRANSPOSE  4963
               MID_PASPEC_MOVE  4964
             MID_PASPEC_SHADOW  4965
               MID_PASPEC_DOWN  4966
              MID_PASPEC_RIGHT  4967

                 MID_CONV_MENU  3712
                 MID_CONV_FTOV  4993
                 MID_CONV_STON  4994
                 MID_CONV_NTOS  4995
               MID_CONV_FREEZE  4996
                MID_CONV_UPPER  4997
                MID_CONV_LOWER  4998
               MID_CONV_PROPER  4999


                 MID_FILL_MENU  3744
                 MID_FILL_FILL  5025
              MID_FILL_SMRIGHT  5026
               MID_FILL_SMDOWN  5027
                MID_FILL_RIGHT  5028
                 MID_FILL_DOWN  5029
                 MID_FILL_BASE  5030
               MID_FILL_SMBASE  5031

                MID_CSPEC_MENU  3808
              MID_CSPEC_SINGLE  5089
              MID_CSPEC_FORMAT  5090
              MID_CSPEC_VALUES  5091
            MID_CSPEC_FORMULAS  5092
             MID_CSPEC_STRINGS  5093
             MID_CSPEC_NUMBERS  5094

                 MID_HELP_MENU  3840
                MID_HELP_INDEX  3841
              MID_HELP_GENERAL  3842
                MID_HELP_USING  3843
                 MID_HELP_KEYS  3844
                MID_HELP_ABOUT  3845
                MID_HELP_LEGAL  3846
             MID_HELP_FEEDBACK  3847
                MID_HELP_PREFS  3848
             MID_HELP_TUTORIAL  3849
              MID_HELP_FORMULA  3850
     MID_HELP_CONTEXTSENSITIVE  3851
              CSH_OPENING_WKBK  3852
           CSH_EDITING_FORMULA  3853
              CSH_EDITING_CELL  3854
                     CSH_CHART  3855
                     CSH_SHAPE  3856
                    CSH_BITMAP  3857
                     CSH_RANGE  3858

                MID_RANGE_MENU  3872
                MID_RANGE_GOTO  5153
               MID_RANGE_LABEL  5154
              MID_RANGE_RECALC  5155

           MID_RANGE_CALCRANGE  5156
                 MID_RANGE_MGR  3877
          MID_RANGE_CELLFORMAT  5158
            MID_RANGE_SETTINGS  5159

                 MID_FONT_MENU  3904
                 MID_FONT_BOLD  5185
               MID_FONT_ITALIC  5186
               MID_FONT_LARGER  5187
              MID_FONT_SMALLER  5188
               MID_FONT_PICKER  3909
                MID_FONT_PLAIN  5190
              MID_FONT_COURIER  5191
                 MID_FONT_HELV  5192
                MID_FONT_TIMES  5193
                MID_FONTS_MENU  3916
                 MID_FONTS_8PT  5197
                 MID_FONTS_9PT  5198
                MID_FONTS_10PT  5199
                MID_FONTS_11PT  5200
                MID_FONTS_12PT  5201
                MID_FONTS_14PT  5202
                MID_FONTS_16PT  5203
                MID_FONTS_18PT  5204
                MID_FONTS_20PT  5205
                MID_FONTS_22PT  5206
                MID_FONTS_24PT  5207
                MID_FONTS_26PT  5208
                MID_FONTS_28PT  5209
                MID_FONTS_36PT  5210
                MID_FONTS_48PT  5211
                MID_FONTS_72PT  5212

                MID_ALIGN_MENU  3936
                 MID_ALIGN_MGR  5217
                MID_ALIGN_LEFT  5218
               MID_ALIGN_RIGHT  5219
               MID_ALIGN_SMART  5220
                MID_ALIGN_WRAP  5221
              MID_ALIGN_CENTER  5222
              MID_ALIGN_UNWRAP  5223
             MID_ALIGN_VCENTER  5224
                 MID_ALIGN_TOP  5225
              MID_ALIGN_BOTTOM  5226

               MID_FORMAT_MENU  3968
                MID_FORMAT_MGR  5249
           MID_FORMAT_CURRENCY  5250
            MID_FORMAT_PERCENT  5251
            MID_FORMAT_GENERAL  5252
                MID_FORMAT_SCI  5253
              MID_FORMAT_FIXED  5254
               MID_FORMAT_TIME  5255
          MID_FORMAT_THOUSANDS  5257
               MID_FORMAT_TEXT  5258
          MID_FORMAT_CURRENCY1  5259
          MID_FORMAT_CURRENCY2  5260
          MID_FORMAT_CURRENCY3  5261
              MID_FORMAT_HMS12  5262
               MID_FORMAT_HM12  5263
              MID_FORMAT_HMS24  5264
               MID_FORMAT_HM24  5265
              MID_FORMAT_PAREN  5266
             MID_FORMAT_HIDDEN  5267
              MID_FORMAT_DDMYY  5268
              MID_FORMAT_MDDYY  5269
                MID_FORMAT_DDM  5270
                MID_FORMAT_MDD  5271
             MID_FORMAT_MMDDYY  5272
               MID_FORMAT_MMDD  5273
            MID_FORMAT__MMDDYY  5275
              MID_FORMAT__MMDD  5276
          MID_FORMAT_DOTDDMMYY  5274

                MID_COLOR_MENU  4000
               MID_COLOR_BLACK  5281
               MID_COLOR_WHITE  5282
                 MID_COLOR_RED  5283
               MID_COLOR_GREEN  5284
                MID_COLOR_BLUE  5285
                MID_COLOR_GRAY  5286
              MID_COLOR_YELLOW  5287
                MID_COLOR_CYAN  5288
              MID_COLOR_PICKER  4009
               MID_COLOR_LGRAY  5290
             MID_COLOR_MAGENTA  5291

                  MID_BKG_MENU  4032
                 MID_BKG_BLACK  5313
                 MID_BKG_WHITE  5314
                   MID_BKG_RED  5315
                 MID_BKG_GREEN  5316
                  MID_BKG_BLUE  5317
                  MID_BKG_GRAY  5318
                MID_BKG_YELLOW  5319
                  MID_BKG_CYAN  5320
                 MID_BKG_CLEAR  5321
                 MID_BKG_LGRAY  5322
               MID_BKG_MAGENTA  5323

                 MID_SIZE_MENU  4064
              MID_SIZE_HIDEROW  5345
              MID_SIZE_HIDECOL  5346
              MID_SIZE_SHOWROW  5347
              MID_SIZE_SHOWCOL  5348
             MID_SIZE_SMARTROW  5349
             MID_SIZE_SMARTCOL  5350
             MID_SIZE_RESETROW  5351
             MID_SIZE_RESETCOL  5352
                  MID_SIZE_MGR  5353

               MID_BORDER_MENU  4096
                MID_BORDER_MGR  5377
               MID_BORDER_NONE  5378
               MID_BORDER_THIN  5379
              MID_BORDER_THICK  5380
             MID_BORDER_DOUBLE  5381
              MID_BORDER_UNDER  5382
               MID_BORDER_LEFT  5386
              MID_BORDER_RIGHT  5387
               MID_BORDER_OVER  5385
            MID_BORDER_OUTLINE  5383
               MID_BORDER_GRID  5384

                 MID_PAGE_MENU  4128
              MID_PAGE_SETVERT  5409
               MID_PAGE_SETHOR  5410
            MID_PAGE_CLEARVERT  5411
             MID_PAGE_CLEARHOR  5412

                 MID_SORT_MENU  4160
                 MID_SORT_SORT  5441
               MID_SORT_COLASC  5442
               MID_SORT_COLDEC  5443
               MID_SORT_ROWASC  5444
               MID_SORT_ROWDEC  5445
              MID_SORT_FLIPHOR  5446
             MID_SORT_FLIPVERT  5447

                 MID_AUTO_MENU  4192
                  MID_AUTO_SUM  5473
                  MID_AUTO_AVE  5474
               MID_AUTO_STDDEV  5475
                  MID_AUTO_VAR  5476
                  MID_AUTO_MIN  5477
                  MID_AUTO_MAX  5478
                 MID_AUTO_PROD  5479
                 MID_AUTO_SMSQ  5480

                MID_GRAPH_MENU  4224
                 MID_GRAPH_MGR  5505
              MID_GRAPH_SHAPES  5506
               MID_GRAPH_GROUP  5507
             MID_GRAPH_UNGROUP  5508
              MID_GRAPH_IMPORT  5509
            MID_GRAPH_GRAPHICS  5510
            MID_GRAPH_ELEMENTS  5511
            MID_GRAPH_GRAPHICS  5512
              MID_GRAPH_LAYOUT  5513
            MID_GRAPH_POSITION  5514
            MID_GRAPH_SETTINGS  5515

               MID_CREATE_MENU  4256
                MID_CREATE_BAR  5537
               MID_CREATE_SBAR  5538
             MID_CREATE_COLUMN  5539
            MID_CREATE_SCOLUMN  5540
               MID_CREATE_LBAR  5541
               MID_CREATE_LINE  5542
            MID_CREATE_SCATTER  5543
               MID_CREATE_AREA  5544
                MID_CREATE_PIE  5545
                 MID_CREATE_HL  5546
                MID_CREATE_HLC  5547
               MID_CREATE_3BAR  5548
              MID_CREATE_3AREA  5549
            MID_CREATE_PYRAMID  5550
             MID_CREATE_RIBBON  5551
                MID_CREATE_MGR  5552
              MID_CREATE_3DMGR  5553
               MID_CREATE_XMGR  5554
               MID_CREATE_YMGR  5555

              MID_ARRANGE_MENU  4288
               MID_ARRANGE_TOP  5569
            MID_ARRANGE_BOTTOM  5570
              MID_ARRANGE_LEFT  5571
             MID_ARRANGE_RIGHT  5572
           MID_ARRANGE_CENTHOR  5573
          MID_ARRANGE_CENTVERT  5574
             MID_ARRANGE_FRONT  5575
              MID_ARRANGE_BACK  5576

                 MID_TOOL_MENU  4320
                  MID_TOOL_MGR  4321
                 MID_TOOL_FORM  5602

               MID_WINDOW_MENU  4352
             MID_WINDOW_TILE_H  4353
            MID_WINDOW_CASCADE  4354
            MID_WINDOW_NEWVIEW  5635
              MID_WINDOW_CLOSE  5636
             MID_WINDOW_TILE_V  4357
               MID_WINDOW_LIST  4358
             MID_WINDOW_CLOSEA  4359
             MID_WINDOW_OTHERS  4402

              MID_OPTIONS_MENU  4384
              MID_OPTIONS_SBAR  4385
           MID_OPTIONS_HISTORY  4386
            MID_OPTIONS_CLRLIC  4387
          MID_OPTIONS_PAGETABS  5668
          MID_OPTIONS_FLIPBARS  4389
             MID_OPTIONS_TBAR1  4390
             MID_OPTIONS_TBAR2  4391
             MID_OPTIONS_TBAR3  4392
             MID_OPTIONS_TBAR4  4393
             MID_OPTIONS_TBAR5  4394
             MID_OPTIONS_TBAR6  4395
             MID_OPTIONS_TBAR7  4396
             MID_OPTIONS_TBAR8  4397
             MID_OPTIONS_TBAR9  4398
            MID_OPTIONS_TBAR10  4399
            MID_OPTIONS_TBAR11  4400
            MID_OPTIONS_TBAR12  4401
            MID_OPTIONS_TBAR13  4402
            MID_OPTIONS_TBAR14  4403
            MID_OPTIONS_TBAR15  4404
            MID_OPTIONS_TBAR16  4405
            MID_OPTIONS_TBAR17  4406
            MID_OPTIONS_TBAR18  4407
            MID_OPTIONS_TBAR19  4408
            MID_OPTIONS_TBAR20  4409

              MID_DECIMAL_MENU  4416
                 MID_DECIMAL_0  5697
                 MID_DECIMAL_1  5698
                 MID_DECIMAL_2  5699
                 MID_DECIMAL_3  5700
                 MID_DECIMAL_4  5701
                 MID_DECIMAL_5  5702
                 MID_DECIMAL_6  5703
                 MID_DECIMAL_7  5704
                 MID_DECIMAL_8  5705
                 MID_DECIMAL_9  5706
                MID_DECIMAL_10  5707
              MID_DECIMAL_MORE  5708
              MID_DECIMAL_LESS  5709

                 MID_WKBK_MENU  4448
                MID_WKBK_PRINT  5729
              MID_WKBK_DELPAGE  5730
                  MID_WKBK_MGR  5731
                 MID_WKBK_MGR2  5732
              MID_WKBK_PAGEMGR  5733
            MID_WKBK_DELSCRIPT  5734
              MID_WKBK_INSPAGE  5735

                MID_LAYER_MENU  4480
             MID_LAYER_PROTECT  5761
                MID_LAYER_HELP  4482

               MID_SCRIPT_MENU  4512
                MID_SCRIPT_MGR  5793
             MID_SCRIPT_MSHELP  4514
               MID_SCRIPT_HELP  4515

           MID_ROWHEADING_MENU  4544
           MID_ROWHEADING_HELP  4545

           MID_COLHEADING_MENU  4576

              MID_GRAPHIC_MENU  4608
              MID_GRAPHIC_HELP  4609
         MID_GRAPHIC_GRAPHHELP  4610

             MID_PAGETABS_MENU  4640
             MID_PAGETABS_HELP  5921

             MID_TTOOLBAR_MENU  4672
             MID_TTOOLBAR_HELP  4673

            MID_STATUSBAR_MENU  4704
            MID_STATUSBAR_HELP  4705

               MID_RECALC_MENU  4736
               MID_RECALC_AUTO  6017
                MID_RECALC_ROW  6018
                MID_RECALC_COL  6019
            MID_RECALC_NATURAL  6020
               MID_RECALC_CIRC  6021
               MID_RECALC_HELP  4742

                 MID_FBAR_MENU  4768
                 MID_FBAR_HELP  4769

                 MID_ZOOM_MENU  4800
                   MID_ZOOM_25  6081
                   MID_ZOOM_50  6082
                   MID_ZOOM_75  6083
                  MID_ZOOM_100  6084
                  MID_ZOOM_125  6085
                  MID_ZOOM_150  6086
                  MID_ZOOM_200  6087
                  MID_ZOOM_300  6088
                  MID_ZOOM_500  6089
                 MID_ZOOM_1000  6090

             MID_EXTRA_COMMAND  4912
               MID_TOGGLE_GRID  6193
            MID_TOGGLE_HEADERS  6194
            MID_UNDERLINE_NONE  6195
            MID_UNDERLINE_THIN  6196
           MID_UNDERLINE_THICK  6197
          MID_UNDERLINE_VTHICK  6198

            MID_FORMULABUILDER  4832



