Builder's Mate

Home

About Us

Advantage Plex

Websydian

Sentences

Success Stories

Downloads

Contact Us

Builder's Mate for Plex

Version: 1.5
Date Posted: 01/01/2004
Platform: Advantage Plex
Type: Utility
Download latest version

Description

A utility which presents local C++ build errors in a more meaningful way. All .LST files in the build folder are listed. Selecting a file in the list displays all of the messages in the file. Also, the implementation names of WinC functions are identified and formatted ready for copying to the Object Browser. These can be either internal functions that cannot be found or external functions whose build failed.

Screen Layout

Builder's Mate Screen Image

The Local Model drop-down list contains recently used local models. When Builder's Mate is launched, the most recently used model is selected. The version number to the right of the drop-down list indicates the version of Plex used to open the local model.

The Build Folder is the folder into which Dlls, Pnls and any Lst error files are created. However, if no build details have been specified for the selected model the text "Not specified" is displayed instead.

The Action button displays a pop-up menu with the following options:-

Delete obwafx.pch
Delete the obwafx.pch file located in the obj sub-folder of the build folder. This is useful when switching to or from action diagram debugger mode.

Add obpt32.lib
If the pre-built library for the pattern models, obpt32.lib, can be located it is added to the list of pre-built libraries used by the C++ compiler.

Add obcl32.lib
If the pre-built library for the class library models, obcl32.lib, can be located it is added to the list of pre-built libraries used by the C++ compiler.

The above options are disabled if no build details have been specified for the local model.

The grid below the build folder shows details of each function in the folder that has generated build errors not being filtered. The list is displayed in descending order of date and time, so the most recent build error is shown at the top. The full details of the output from the compiler can be viewed by either double clicking on the grid row or by selecting and right-clicking on the required function and selecting the View pop-up menu. The .LST file is then displayed using the Plex Source Code Editor. The grid entry can be removed by selecting and right-clicking on the required function and selecting the Delete pop-up menu. The .LST file is deleted and the grid reloaded.

The tabbed frame below the grid displays implementation names of functions listed in the grid, or names of bitmap files.
The Internal functions tab contains details of internal WinC functions that have yet to be built. The External functions tab contains details of external WinC functions whose build has failed. The Resources tab contains details of bitmap files required to build panels.
Whichever tab is selected, Builder's Mate can search for details either for the function highlighted in the grid, or in all .Lst files in the build folder.

The Impl Name(s) field contains a list of implementation names for the functions in the format *ImplName1;*ImplName2;. The contents of this field can be copied to the filter combo box on the Object Browser to search for the corresponding functions. For the Resources tab, the File Name(s) field contains a list of bitmap files in the format *bitmap1.bmp;*bitmap2.bmp;. If the full path has been specified in the Panel Editor, this is displayed in the field, otherwise just the file name is shown.

The Messages for selected file grid lists the messages generated by the C++ compiler during the build process. The messages shown are those relating to the function highlighted in the top grid. The full details of a message can be viewed by either double clicking on the grid row or by selecting and right-clicking on the required message and selecting the Display Message pop-up menu. The Message Details window is then displayed. The Id for a message can be used to search for further information in the MSDN web site by selecting and right-clicking on the required message and selecting the Search MSDN Help pop-up menu.

The Selected Function field displays a value according to the error highlighted in the message grid. If the message is for an unresolved external call which is called directly by the function being built, then the name of the called function is displayed, otherwise 'Unknown' is shown. For other messages, 'n/a' is displayed.

When Builder's Mate receives focus, the grids are refreshed, so that the list of functions with errors is kept up to date. If required, this feature can be switched on and off by selecting the Options -> Auto Refresh menu.

If multiple versions of Advantage Plex are installed, different versions of Plex can be selected using the Options -> Plex Version menu.

Message Details

Builder's Mate Message Details screen

The details of the selected message are displayed.

The Message Id can be used to search for further information in the MSDN web site by clicking the Search MSDN Help button.

The Souce field contains the full path and filename of the source code which generated the error, if appropriate for the message. If a source code file is specified, it may be viewed by clicking on the View Source button.

The Line No. field gives the line number within the source code file at which the error ocurred.

The messages for a Message Id can be omitted by using the The Filter Out Message checkbox.

Filtering Message Ids

Any message id that is not required to be listed in the messages grid can be filtered out.

This is achieved by selecting individual message ids to be filtered, and then enabling the filtering of the selected ids.

A message id is selected by clicking the Filter Out Message checkbox on the Message Details panel. Clearing the checkbox deselects the message id.

Filtering is enabled by selecting the Options -> Filter Messages menu. Selecting the menu again disables filtering. A tick next to the menu item indicates that filtering is enabled.

When filtering is enabled, the grid of .LST files contains a row for each file found that has at least one message to be displayed in the messages grid. Any .LST file for which all of the messages are being filtered will not be displayed. When a row is selected in the .LST file grid, the messages grid will only display those messages not being filtered.

Menus

File -> Exit exit Builder's Mate
view -> Refresh refresh the grids. This has the same effect as reselecting the current local model in the drop-down list
Options -> Plex Version select which version of Plex you wish to work with, or edit the Plex installation details
  -> Auto Refresh switch on or off whether to automatically refresh the grids when Builder's Mate receives focus
  -> Prefix Impl Names with * switch on or off whether to add '*' to the front of each Impl Name in the list
  -> Filter Messages switch on or off whether to omit selected message ids from the messages grid
Help -> Flying Start Computing go to web site
  -> Builder's Mate Online displays this page
  -> Search MSDN Help search the MSDN web site for a specific string
  -> About application information

Multiple versions of Plex

Builder's Mate will try to identify which versions of Plex are installed. If more than one version of Plex is installed on the PC, the required version can be selected from the Options -> Plex Version menu.

If, for some reason, an installed version of Plex has not correctly been identified, the details can be changed using the Options -> Plex Version -> Edit menu. This displays a list of versions with details for the version selected in the grid.

To enable a version, select it in the grid, check the Installed? checkbox, select the 'An Entered Path' radio button and type the full path for the folder where that version of Plex is installed. Then click the Apply button.

New for version 1.5

  • Filter out messages with selected ids.
  • Ready for Plex v5.5.
  • The installation folder for Plex v5.1 is correctly identified from the registry.

System Requirements

Advantage Plex version 3.5 or later.

The required run time files are supplied with the utility.

Compatibility

Builder's Mate has been developed using Advantage Plex version 4.5 (build 39), and has been tested with versions 3.5, 4.0, 4.0a, 4.5, 5.0 and 5.1.

Implementation

  1. Unzip the files to an appropriate local or network folder.
  2. Run BuildMate.exe
  3. Create a shortcut to the unzipped BuildMate.exe file on your desktop or Start menu, if required.
  4. Please refer to the ReadMe.txt file for any last-minute information.

The following files are included in the package:-

  Name Size Date
  BuildMate.exe 45k 19/10/2001
  BuildMate.dll 428k 31/12/2003
  BuildMate.ini 1k 26/05/2003
  BuildMate.pnl 36k 22/12/2003
  About.pnl 9k 22/12/2003
  DspMsg.pnl 16k 22/12/2003
  SrchMSDN.pnl 8k 22/12/2003
  Versions.pnl 23k 22/12/2003
  ReadMe.txt 7k 14/12/2003
  BuildMate.ico 1k 19/10/2001

Uninstalling

  1. Delete the installed files from the installation folder.
  2. Delete the folder, if it is no longer required.
  3. Delete any shortcuts created pointing to the BuildMate.exe file.

Download latest version

  Related Links

Description

Screen Layout

Message Filtering

Menus

Multiple versions

New for 1.5

System Requirements

Compatibility

Implementation

Uninstalling

Download latest version