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