Variable Counter
Freeware extension tool for Visual Dialog Script

INSTALLATION
Unzip into the tools folder of your VDS installation path and run it from within your VDS environment.
The GUI of Variable Counter  is more or less self-explanatory.

DESCRIPTION
VariableCounter is a small utility to get all variable names and list names of your source code listed, showing exactly where (in which line) they are being used and how often. Helpful for larger scripts in order to reduce unnecessary variables in case you are approaching the 220 limit.
After searching for script-variables you can save the results to your harddisk for later inspection.
If the main file of the project consists of subfiles, you can choose whether or not they should be added. Otherwise just the main file is loaded.
That way an entire project can be searched for variables. The sub files (if any) are added to the list combo box.
To inspect only 1 subfile from a project consisting of several files  (displayed  in the list combo box), select this file and click the yellow square next to the "Select File" button.


FUNCTIONS

File Menu Load Source Loads a DialogScript source file (.dsc/.dsp) into the editor window
  Add project file Adds a source file to the editor window
  Delete project file Deletes a selected or checked file from the editor window (multi-selection allowed)
  Save FileList Saves a VariableCounter project (.vcp) - all files listed in the project file table 
  Load FileList Loads a VariableCounter project that was prev iously saved.into the editor
  Save List Table Saves all list names found in the sourcefile to your harddisk that can be printed out for later use or closer inspection of your source files
  Save Variable Table Saves all variable names found in the sourcefile to your harddisk that can be printed out for later use or closer inspection of your source files
Options Menu Clear Variable Table Clears the variable table
  Clear all tables Clears all VariableCounter tables and lists - equals a reset of VariableCounter
  CRC32 Check Perform a CRC32-Check on selected file
Info  Help Opens this help file in your default browser.
  Register Opens the registration dialog. Just enter your registration name and the serial number you have received via email after registering this software.
To register simply send an email to: mdoran65@gmx.net
You will receive your personal registration key shortly after registering VariableCounter at no cost - VariableCounter remains to be FREEWARE.
  About Opens the program information dialog.
Misc F3 Jumps to the next line number (occurrence) of the selected variable name
  DoubleClick on variable name Jumps to the first line (first occurrence) in the editor in which the variable was found
  DoubleClick on file name Jumps to the first line of the file in the editor
  Select File Button same as "Load Source" - loads a DialogScript source file
  Yellow Button selects a file from the combo box and display it in the editor window
  Search Button Searches for all occurrences of variable names in the editor window. The results are then displayed in the variable table and a summary of the search is shown in the center screen.
CRC32   Calculates a CRC32-checksum of the loaded source file.

 


HISTORY

December, 26th, 2008
Latest Update (version 1.6.8.19):
-Just a few internal changes - no new features.

Januaryr, 17th, 2008
Fixed some VDS 6 problems (version 1.6.7.101):
-As VDS 6 has been released some features had to be adapted.

October, 5th, 2007
Minor Bug-Fix (version 1.6.5.24):
-Fixed a minor bug when loading files from the MRU-list.

May, 1st, 2007
Minor improvements (version 1.6.5.17):
-Just a few cosmetics in the GUI to improve visibilty.

March, 15th, 2007
List operation Bug resolved (version 1.6.4.90):
-There was a bug in the previous version that caused VC to hang when searching for list operations.

February, 22nd, 2007
Helpfile and Saving list table were added (version 1.6.4.88):
-The included help file is now accessible through the menu.
-The lists which were found can now be saved just like the variables names.
-All list functions are now found and shown in the list table (@next, @item, etc...)

As of this release of  VariableCounter, a registration key is required. The unregistered version is fully functional, however, a nag-screen appears at the start and end of the program stating that this program is "unregistered". Registration of course is free of charge and needs to be done only once. Your registration key will be valid for all future releases/updates of  VariableCounter.
Well, this release basically completes and wraps up VariableCounter to a fully functional analysis tool for VDS programers.


February, 18th, 2007
Lists are now included and also displayed in the variable table (version 1.5.2.51):
-On popular request, all used lists are now included when searching for variable names.
 For better visibilty, list names are displayed in upper case, prefixed with "LIST_", followed by either a list number
or the name of a list dialog element (eg. ListIcon, ListCombo etc.)
At this time, list functions like "@next()", "@index" etc. are disregarded but might be added in the next update.

February, 14th, 2007
Added a MostRecentUsed File-List  (MRU) in version 1.4.5.147:
-for more convenience a most recent used file list was added to the file menu bar.

January,6th, 2007
Minor cosmetics and minor performance enhancements in version 1.4.4.22:
-faster display when loading larger source files into editor.
-file error handling fixed - unloadable files are not displayed in the editor box anymore

November, 11th, 2006
Fixed some minor bugs concerning  project-files handling in version 1.4.3.412:
-you can now add source files  from different folders to the project list and delete them as intended.
-all source codes now have their crc32 checksum displayed

June, 7th, 2006
New features added in version 1.4.2.77:
-you can now add/delete single files to/from the project file list
-you can save the project file list and reload it
-helpfile has been updated / added history
-check function has been included to prevent that the same file is loaded twice

May, 26th, 2006
New features added in version 1.3.1.65:
-tremendous speed enhancement (about 6x faster than previous version!)
-CRC32 checksum for selected file
-F3 shortcut for a quick  scan through all occurrences of the selected variable name in sourcefile
-improved file-format when saving a variable table

April, 29th, 2006
New features added in version 1.2.0.47
-Fixed some more minor bugs
-Added: include project files

April, 26th, 2006
New features added in version 1.0.0.84
-Fixed a few bugs / wrong variable names detected

April, 24th, 2006
First Release version 1.0.0.54:
-the first official release for VariableCounter


Info: The subfiles (if any) are read from the Visual DialogScript project file (.dsp). Hence, only files listed there are considered.
(This function of VariableCounter, in its current version, is compatible with VDS 5.0, 5.02  only - might not function with upcomming  versions of VDS!) 

The extension tool can only detect variables in source codes (.dsc files) not precompiled units or exe-files.
All variable names not included in the variable table must then belong to a precompiled unit used in your source file.
So you can easily figure out the amonut of variables used in third party dsu-files when subtracting the total number of variables used indicated when compiling your source code from the total number of variables found by VariableCounter. If no dsu-file is used, they should match.

For comments or suggestions please contact the author via email: mdoran65@gmx.net

DTM Software Mike Doran