Changelog for ARRIS++ Version  8.1;   (Spin #103, Rel. 01):

The following lists describe the changes that have been made to the ARRIS++ Enhanced Menus since the previous release (version 8.0, spin #286, rel 01), on October 8, 2003. Note that there are links in the following material pointing to more detailed information contained in the main documentation.

This changelog is divided into the following sections:



• General Improvements
  
  
• Documentation Enhancements
  
  
• Menu Modifications
  
  
• Existing Sigmac Bug Fixes
  
  
• Existing Sigmac Enhancements
  
  
• New ARRIS++ Sigmacs

General Improvements:

The following table lists general improvements that have been made to the ARRIS++ menu system.

All ARRIS 8.1 enhancements have been fully integrated into ARRIS++. This includes: Enhanced Color Management Improved Support for Raster Images Output to PDF Files RI Library Manager

Implemented a workaround for a bug that is causing the status menus to flash as two different menus each attempted to displace the other one. (Note: This fix solves a reproducible condition that caused flashing status menus. This may or may not be a total solution for that problem. Time will tell. Also, this does not appear to solve the flashing layer entity menu problem which is still under investigation.)

ARRIS++ will no longer attempt to load any ARRIS modules which may be installed on a system but which are not fully authorized.

If the ARRISplus plug-in module is installed on the system, but it cannot be authorized, then the module will be automatically unloaded and tagged as unavailable. If later, the proper authorization codes are installed, it will be necessary to exit and restart ARRIS before the ARRISplus module can be loaded. Note that it is necessary to first load ARRISplus in order to then verify whether or not it is authorized. If it turns out not to be authorized on the system, an unavoidable error message (issued by ARRISplus itself) will be displayed, prior to the module being automatically unloaded.

There was a conflict in using the QUICKSTART training module with ARRIS++. Modifications were made to insure that these two modules are not loaded at the same time. If QUICKSTART is selected, the user will be prompted to unload ARRIS++. When training is completed and the QUICKSTART module is unloaded, ARRIS++ will be automatically reloaded. In addition, QUICKSTART was not properly cleaning up after itself when unloaded. These problems have been addressed so that all training libraries are now removed, the user's default colormap is reloaded, the user's toolbar is reset and the training database is replaced by noname.db.

The following ARRIS++ commands were added to the TOOLBAR command database: COMMAND DESCRIPTION COL MAP user12 A 256-slot colormap which includes the original 48 colors defined in the user2.cm COL MAP user12R Same as user12 except that black and white are swapped to produce a white screen RASTER BKGRND Select a raster image and place it on the drawing background RASTER PLC LN Place a raster image on the drawing by specifying a 2-point baseline RASTER PLC BOX Place a raster image on the drawing by specifying a 2-point boxed area SCREEN SAVE Save the current ARRIS screen image as a raster file RASTER INVERT Change the inversion mode of the selected raster entity RASTER PRE-ROT Change amount of pre-rotation applied to selected raster entity RI REMAKE Remake specified RI using all current parameter settings

The following ARRIS++ commands were removed from the TOOLBAR command database for the reasons noted: COMMAND DESCRIPTION ATT RI MAKE Attributes are now integral to RIs and set using the RI editor RASTER CHG MDE Command is no longer applicable RASTER CHG PEN Command is no longer applicable RASTER CHG COL Command is no longer applicable

The following ARRIS++ command names were changed in the TOOLBAR command database to correspond more closely with the rest of the ARRIS system: NEW NAME OLD NAME COL MAP user1 LOAD user1.cm COL MAP user1R LOAD user1R.cm COL MAP user2 LOAD user2.cm COL MAP user2R LOAD user2R.cm RASTER SWAP RASTER CHG FIL RI PLC OFFSET RI ORIG OFFSET RI REL 2 EXIST JOIN RI

Documentation Enhancements:

The following table lists general modifications and enhancements that have been made to the ARRIS++ menu system documentation.

The User's Manual has been brought up-to-date to reflect all changes noted in this release.

New on-line help was written for all of the revised RASTER menu functions.

The remainder of the on-line help has been revised to reflect all other changes.

Menu Modifications:

The following table lists changes and additions made to the ARRIS++ enhanced menus.

COLOR:	Colormaps  Colormap: user11.cm  Colormap: user12.cm With the advent of colormaps with 256 addressable colors, two new custom colormaps named user11.cm and user12.cm have been added. Both maps support the standard ARRIS++ menu colors (seen in the images in this document). Other than the menu colors, user11.cm is identical to the new SYSTEM colormap. The user12.cm map retains the original 32 solid colors (0-31) and the 16 pastels (33, 35, 37, ..., 63) found in the previously released user2.cm colormap. New pastel colors have been added to the even numbered slots from 32 through 62 while colors 64 through 255 are identical to the new SYSTEM colormap. Two additional colormaps named user11rev.cm and user12rev.cm has been added which are identical to their counterparts with the exception that colors 0 (black) and 1 (white) have been swapped, resulting in a white screen with dark lines. To make one of the new colormaps your default, copy it from the ARRIS++ library ($ARRIS/ap/cjsa.vn/cjmenus.ap/lib/) to your $GRUSR directory and rename it user.cm.
DETAILS:	Details Main Menu  DETAILS Main Menu The button for the ARRISplus keynote specifications utility was removed. This function may now be accessed from the standard ARRIS NOTES button depending upon which user-specified selections are made from the ARRIS++ OPTIONS menu.
EDIT:	Special Entity Filters A small box was added under the EDIT button to keep the user informed as to the current status of any Special Entity Filters in use on the EDIT or COPY menus. The special filters include the PEN and COL settings as well as the special properties which vary depending upon the current entity setting. The indicator is neutral (as seen on the left) when none of the special entity filters is in effect. It becomes highlighted (as seen on the right) when any special filter is active for the current entity type.  Special Entity Filter Indicator: Off  Special Entity Filter Indicator: On Left-clicking on this indicator box will display the EDIT pull-down menu. Right-clicking will clear all special entity filters which is identical to selecting the [C] icon on the EDIT menu. Programmer Tip: A new sigmac, :cj_ed_light, has been created which sets this indicator light based upon the current editing criteria. This command may be used if necessary to update the indicator. Note that this is unnecessary if a call is instead made to either :mn_edslct or :mn_edstrt.
LINES:	Lines Main Flyout Menu:  LINES Main Flyout Menu The icon for the running line command was updated to match the icon on the LINES overwrite menu.
OPTIONS:	ARRIS++ Options:  ARRIS++ OPTIONS Menu The ARRIS++ OPTIONS menu has been substantially changed as follows: The option to select the default toolbar type has been eliminated. Toolbars have been substantially revised (see below) and the type is now stored with the toolbar style when it is saved to disk. The default toolbar type is whatever type is save with the user's STD and ALT toolbar styles. The individual options are now toggled by clicking on the raised buttons on the left to display the various choices in the field to the right. You may still right-click on these buttons to cycle backwards through the choices. A new CUSTOM option has been added to the four items controlling the NOTES and RECENT DOCUMENTS functions. As can be seen in the third item in the image above, while cycling through the options, when CUSTOM is selected the following message is displayed: CLICK ON BOX AT RIGHT TO SET/CHANGE THE CUSTOM MENU TO BE LOADED FOR THIS OPTION Clicking on CUSTOM in the data field results in a prompt for the name of a custom menu to load when the associated button is selected. Enter the name of the desired menu, hit <CR> and the name is then displayed. For example, let's say that you have a custom keynoting application that you wish to use in place of the standard ARRIS NOTES tool and it has an overwrite menu named CD_KEYNOTE. As can be seen in the second line in the image above, this has been entered as a custom menu and will now be automatically displayed when left-clicking on the NOTES button. (If you want to make this permanent, don't forget to SAVE your changes.) A new option has been added to DISPLAY TOOLBAR WITH ALTERNATING COLORS. Selecting this button toggles the option between YES and NO. The default value of YES displays the ARRIS++ toolbars as they have always appeared. Selecting NO will immediately cause all of the toolbar buttons to be displayed in a uniform background color. See TOOLBAR below for additional information.
RASTER:	Raster Menu Update:  RASTER Overwrite Menu  RASTER Main Flyout Menu  RASTER Status Menu The new ARRIS 8.1 RASTER menus have been changed in the following ways: The RASTER overwrite menu was completely redesigned for improved readability and use. The raster SELECT button was eliminated in favor of the permanent button located at the bottom of the overwrite menus. A new PDF button was added to launch the RenderPlus PDF application module which is used to export ARRIS drawings in the PDF format. Snap flyout menus were added as right-click options for the two raster entity placement commands. The RASTER main flyout menu has been revised to reflect all changes on the overwrite menu. The raster status menu was modified to display "<no file set>" on a bright red background as a reminder that no raster image file has yet been selected for placement. Notes: In standard ARRIS 8.1 a new RASTER BACKGROUND button was added to the MAIN menu. This has not been provided in ARRIS++ since it is fully redundant with the button on the RASTER menu.
RIs:	Move Attributes  RI Overwrite Menu A new right-click command was added to the EDIT button in the ATTRIBUTES section of the REPEATED ITEMS menu which will allow individual attributes to be relocated on the drawing. The command repeats.
	Repeated Item Library Manager  RI Library Manager Menu Previously, left-clicking on the SETUP button would launch the DRAW/EDIT REPEATED ITEM menu, which is also available by selecting the EDIT RI button. The SETUP button has now been reassigned to display the new ARRIS REPEATED ITEM LIBRARY MANAGER menu. If the optional ARRISplus module is installed, then right-clicking on the SETUP button continues to provide access to the alternate RI LIBRARY EDITOR menu which provides similar functionality.
	Repeated item Tools  REPEATED ITEM TOOLS Menu A new RI LIB MANAGER button was added to this menu to provide another method to access the ARRIS REPEATED ITEM LIBRARY MANAGER pop-up menu.
TOOLBAR:	Toolbar Update: Three existing toolbar types:  20-box TOOLBAR menu      (Click on image for larger view in pop-up window)  40-box TOOLBAR menu      (Click on image for larger view in pop-up window)  80-box TOOLBAR menu      (Click on image for larger view in pop-up window) Four new toolbar types:  26-box TOOLBAR menu      (Click on image for larger view in pop-up window)  29-box TOOLBAR menu      (Click on image for larger view in pop-up window)  44-box TOOLBAR menu      (Click on image for larger view in pop-up window)  46-box TOOLBAR menu      (Click on image for larger view in pop-up window) Four new toolbar types have been added to ARRIS++: A 26 box layout with 08 1x1 boxes and 18 2x2 boxes A 29 box layout with 12 1x1 boxes and 17 2x2 boxes A 44 box layout with 08 1x1 boxes and 36 2x1 boxes A 46 box layout with 12 1x1 boxes and 34 2x1 boxes These new toolbars provide either 8 or 12 small 1x1 sized boxes to the left with the remainder being the larger 2x1 or 2x2 size. These small boxes can be assigned a label and command just like any other toolbar box, but might be used for a set of special tasks. For example: Setting pen and/or color Toggling to alternate toolbar styles Setting line arrowhead type Displaying a set of custom pop-up menus Setting office-standard layer and drawing parameters The toolbar style file format was modified to record the native size of the toolbar (i.e., 20, 26, 29. 40, 44, 46 or 80) when the style is saved to disk. Now, when a toolbar style is loaded, it will automatically set the toolbar to the proper type. This is useful for individuals that like to use toolbars of differing types depending upon the task. For example, someone may like to use a 26-box STD and ALT as their normal toolbar style, but have another 44-box model toolbar that is occasionally loaded for 3D work. Previously, it was necessary to first load the model toolbar style and then change the toolbar size. With toolbars saved using this version of ARRIS++, that will no longer be necessary as the toolbar will automatically update to the proper size. Because of this change, the default toolbar size option has been eliminated from the ARRIS++ OPTIONS menu, as discussed above. When this version of ARRIS++ is first run it will automatically rewrite the STD and ALT toolbar style files to record the default toolbar size. However, other existing toolbar style files will not be automatically updated. It is suggested that you take a moment to load and then resave each of your existing toolbar styles to insure that they get tagged with the desired type.
	Typically, ARRIS++ toolbars are displayed in an alternating color scheme as seen here:  TOOLBAR menu with alternating background colors The colors are meant as an aid in visually grouping command, making them easier to locate as the number of toolbar buttons increases. However, some people find the alternating color scheme distracting. For them, a new option has been added to the ARRIS++ OPTIONS menu which allows the alternating color scheme to be turned off, allowing all toolbar buttons to be displayed in the uniform menu background color, as seen in the following image:  TOOLBAR menu with single background color
	All prompts that accept label text for toolbar buttons now honor the CAPS mode setting. Thus, if CAPS mode is set to uppercase without having to hold the shift key.
	The cj_mktb perl script is used to convert existing ARRIS toolbar styles to the file format required by ARRIS++. This script was updated to reflect changes made to the toolbar style file format. Because the standard ARRIS toolbar supports 22 commands, this script creates 40 box ARRIS++ toolbar style files to insure that no commands are lost. To convert these to some other type (say 20 or 26 boxes), simply load the styles, select the desired toolbar type, make any required adjustments to the command layout and then resave the style in the new format.
	The toolbar style files are saved to the USR:config.dir directory. These files were revised to add additional comments making direct viewing or editing of the files much easier.
VIEWPORT:	Viewport Outline  Bad Example of Viewport Outline! On the ARRIS++ OPTIONS menu, If the option for viewport border lines display was set to ALL COMMANDS & CONTROLS, then the border lines would also display in a number of undesirable location as seen in the accompanying partial image from the TEXT CREATE pop-up menu. This problem has been corrected so that viewport border lines appear only in a normal drawing window.
ZONES:	Zone Status Menu  Partial Zone Status Menu  Partial Attribute Status Menu As a reminder, the zone and attribute status menus were enhanced to display "<not set>" in bright red in the NAME, VALUE and TYPE boxes when no value has yet been entered.

Existing Sigmac Bug Fixes:

The following table lists fixes that have been applied to existing sigmacs to correct problems and bugs.

:_cj_db_user	USER DOCUMENTS menu, when SELECT BY FILE mode was in use, any drawing loaded into user document position #12 could not be loaded. This problem has been fixed.
:_cj_vp_rview	This command was modified so that it no longer displayed viewport border outlines in undesirable locations.
:mn_apdump	Fixed a long-standing problem where the PLUG-IN menu would be redisplayed after a module was unloaded. There were display problems causing dynamic text on the main menu to be lost. The PLUG-IN menu is no longer automatically redisplayed.
	Stop the PLUG-IN pull-down menu from redisplaying after a module was unloaded as it could interact incorrectly with the dynamic text being updated on the main menu.
:mn_dmtxed	There was a long-standing bug that made it impossible to replace an existing dimension text string if the default string was selected and CAPS mode was on. In this case, the default existing string would be converted to the opposite case and then it would fail to match the dimension string when the actual edit was attempted. This serious problem has been corrected.
:mn_gencol	Fixed a bug in option argument handling that caused a problem under certain conditions. In particular, this caused a failure when the POC COL box was selected from the details module status menu. NOTE: This was a bug created by ARRIS++ and not a fault in the original ARRIS code.
:mn_mnhelp	Fixed a serious bug which kept menu box text labels for various legacy ARRIS menus from displaying in the sample boxes on the FULL HELP pop-up menu and from being able to be placed on the toolbar.
:mn_pol2	Fixed a bug where polygon construction using the 'circumscribed' mode was incorrect when DSR was set to off. NOTE: This was a bug created by ARRIS++ and not a fault in the original ARRIS code.
:mn_qry	Fixed a bug in the initialization of the text status menus that would cause a brief flashing between the ST_TEXT and ST_NOTE menus and often leave the incorrect menu displayed.
:mn_raster	When entering a raster filename from the keyboard, it was possible to store an invalid name in the global variable smn_bitfile. This resulted in incorrect prompts and caused very confusing display of the filename on the raster status menu. This has been fixed.
:mn_riplace	When placing an attributal RI, the reference point was being left at the location of the attribute text instead of at the RI placement origin. This made it impossible to properly align RIs with XYF=on. This annoying bug has been fixed.
:mn_viewsv	Fixed a bug introduced in spin #239 that was forcing all view file pathnames to lowercase. This meant that on a UNIX system, no view files could be located or saved in any databases that had an upper case letter in the pathname.

Existing Sigmac Enhancements:

The following table lists revisions that have been made to existing sigmacs in order to provide some expanded or new capability beyond that offered by the original command.

:_cj_vp_rview	Support for the global variable cj_vp_rvskip was added. In any sigmac, if this is set to #true prior to calling the window display update command (e.g., :dpe), then the viewport border outlines will be suppressed in that window for that call only. The variable is automatically reset to #false after each call.
:cj_ik_cust	Input for toolbar label text now honors CAPS mode.
:cj_ik_labl	Input for toolbar label text now honors CAPS mode.
:cj_ik_styl	Modified command to support an improved toolbar style file format that stores toolbar size and allows the appropriate toolbar type to be automatically set when the style is loaded.
:cj_mn_disp	Created a work-around for the status menu flashing problem.
:cj_op_opts	Added support for the new options.
:menld	Created a work-around for the status menu flashing problem.
:mn__main	Created a work-around for the status menu flashing problem.
:mn_apdump	Added support to perform clean-up work when the Quickstart module was unloaded including the reloading of the user's default colormap, loading of noname.db and automatically reload ARRIS++ if it was previously loaded.
:mn_appask	Added support to coordinate the mutual unloading of ARRIS++ and QUICKSTART when the other module is being loaded.
:mn_appl3	Added support to coordinate the unloading of ARRISplus and ARRIS++ when the Quickstart module was loaded.
	Created a work-around for the status menu flashing problem.
:mn_attst	The command was enhanced to display "<not set>" in bright red in the NAME and VALUE boxes when no value has yet been entered.
:mn_edslct	Added support for updating the special entity filter indicator light located under the EDIT button on the DESKTOP menu.
:mn_mnhelp	Added code to allow commands on the toolbar to be relocated to other toolbar positions.
	While placing a command on the toolbar, if a menu box text label cannot be located, the user will now be prompted for a label rather than simply printing an error message and exiting.
	Input for toolbar label text now honors the CAPS mode setting.
:mn_rasstat	Now, when no raster file has yet been specified, as an alert, the RASTER FILE field on the raster status menu will display in red with the message "<no file set>".
:mn_riplace	Each time a RI placement session was terminated, the RI placement offset value was being automatically cleared. This was generally inconvenient for users of this feature and has been changed to leave the current value active. The original behavior can be restored by setting the environment variable CJ_RIPLCOFF=RESET in your .profile or .cshrc file (UNIX), or in your arris.ini file (Windows).
:mn_zonst	The command was enhanced to display "<not set>" in bright red in the TYPE and NAME boxes when no value has yet been entered.

New ARRIS++ Sigmacs:

• The following new sigmacs routines have been added to the current release of ARRIS++.

  NEW COMMAND	CLASS	DESCRIPTION
  :cj_ed_light	edit	Turn the special entity filter light on or off depending upon the status of various editing criteria. The light is located below the EDIT button on the DESKTOP menu and indicates whether any special filters are active for the current edit entity type.
  :cj_ei_amesg	arrisplus	Display an appropriate ARRISplus access failure message.
  :cj_ei_uload	arrisplus	Unload the ARRISplus plug-in application module.
  :cj_qs_load	quickstart	Load the QUICKSTART application. If ARRIS++ is loaded, then the user is prompted to unload that module prior to loading QUICKSTART. ARRIS++ is flagged to be automatically reloaded when the QUICKSTART module is later unloaded.
  :cj_qs_uload	quickstart	Unload the QUICKSTART module. Perform additional clean-up work not previously done, reload the user's default colormap, reload the user's default toolbar, reload noname.db and automatically reload ARRIS++ if it was previously loaded.
  :cj_ra_btn	raster	Execute the appropriate command when the RASTER button is selected on the main menus. This command is used to distinguish between the different raster sub-systems in ARRIS 8.0 and 8.1.
  :cj_ra_init	raster	Initialize the ARRIS 8.0 raster overwrite menu. This was the :mn_rasstart sigmac, but had to be renamed for ARRIS 8.0 so that the 8.0 and 8.1 code could coexist during the overlap imposed by the SDI development schedule.
  :cj_ra_parm	raster	ARRIS 8.0 raster parameter setup function. This was the :mn_rasparm sigmac, but had to be renamed for ARRIS 8.0 so that the 8.0 and 8.1 code could coexist during the overlap imposed by the SDI development schedule.
  :cj_ra_pdf	raster	Custom routine to load the RenderPlus PDF application module with suitable checks.
  :cj_ra_place	raster	Place an ARRIS 8.0 raster entity on the drawing. This was the :rasplc sigmac, but had to be renamed for ARRIS 8.0 so that the 8.0 and 8.1 code could coexist during the overlap imposed by the SDI development schedule.
  :cj_ra_raster	raster	Manage ARRIS 8.0 raster entity functions. This was the :mn_raster sigmac, but had to be renamed for ARRIS 8.0 so that the 8.0 and 8.1 code could coexist during the overlap imposed by the SDI development schedule.
  :cj_ra_stinit	raster	Initialize the ARRIS 8.0 raster status menu. This was the :mn_rasstat sigmac, but had to be renamed for ARRIS 8.0 so that the 8.0 and 8.1 code could coexist during the overlap imposed by the SDI development schedule.