Version 3.36 WINSVS readme file This file describes the 32-bit Windows version of the Stand Visualization System (SVS). This release of WINSVS is very stable but may have a few as yet undetected bugs. Please report problems to Bob McGaughey via email to bmcgaughey@fs.fed.us Computer system requirements ************************************************************************************ NOTE: This version of WINSVS will run under Windows 95, 98, 2000, XP and NT version 3.51 and later. This version will not run under Windows 3.XX. ************************************************************************************ WINSVS requires at least a 486 based computer system running Microsoft Windows 95, or Windows NT. For best results, your computer system should be capable of displaying at least 256 colors. On computer systems that display only 256 colors, there may be some color shifts as you change from WINSVS to other applications. However, the colors should return to normal when you return to WINSVS. Installation WINSVS is distributed in two forms: a single self-extracting archive, diskettes. The installation method is different for the two forms. Installing from diskettes: Insert the first diskette into you floppy drive and run setup.exe from within Windows. You will be prompted for the additional diskette(s) as needed. Installing from the single self-extracting archive: First you must expand the archive to create the necessary installation files. This is done by running the archive file from within Windows. When prompted for a directory, you should specify a unique directory so you can simply delete the installation files after the installation is complete. After expanding the archive, run setup.exe from within Windows. You will be prompted for the additional diskette(s) as needed. After the installation is complete, you can delete the installation files created after expanding the self- extracting archive. WINSVS can be installed into same directory as the DOS version. However, some existing tree form definitions will be overwritten. If you have made changes to the tree form definitions supplied with the DOS version, you might want to install the Windows version into a new directory. If you want the ability to convert tree list files produced by the Forest Vegetation Simulator (FVS) for display in WINSVS, you must select one of the installation options that includes this capability. Removing SVS from your computer (un-installation) The installation procedure for WINSVS produces an uninstall script for use with the Windows control panel applet "Add/Remove Programs". To remove SVS from your system, use the Windows Start button to activate the control panel and select the Add/Remove Programs applet. Then find and select "Stand Visualization System (SVS)" in the list of installed components. Finally click the "Add/Remove" button to uninstall WINSVS. Version History 3.36 initiated 9/16/2002...released Modified file path parsing to better deal with paths containing forward slashes. There were some problems when trying to locate files used in a tree list header (GRD and TRF files) and the tree list file was in a directory with a long name (>30 characters). Modified website used to check for updates to SVS. Now checks "http://forsys.cfr.washington.edu". Affected files: fvs2svs.dll, svslib.dll, tbl2svs.lib, org2svs.lib, winsvs.exe 3.35 initiated 5/8/2001...released: This version was released in may 2001 to a very small group of individuals...only dlls were updated so there is no version 3.35 of winsvs.exe (Help...about will never report version 3.35). Modified header scanning logic for FVS tree lists to better recognize the 26-character stand IDs. Added creation of SUMMARY.TXT file in SVS install directory that contains text from the most recent stand summary displyed on screen. File is only created when a summary is displayed in the layout. Added as special request from users in Anchorage, AK. Affected files: fvs2svs.dll, svslib.dll 3.34 initiated 3/20/2001...released 3/22/2001 Modified the logic used to draw trees using random variation. Random number stream now depends the tree location rather than its order in the tree list. This means you can have trees in the same location in different tree list files that will be drawn the same. Especially useful for FVS-FFE output files. Fixed stump height when using metric units. Stumps are now 1.5 feet or 0.5 meters tall depending on the units for the tree list. Added new tree forms for BWINPro growth model from Germany in file bwinpro.trf. Included external object for flames from FVS-FFE output in distribution (flame.eob) and added tree form definition to all FVS variant tree form files. Affected files: winsvs.exe, svslib.dll, all .trf files 3.33 initiated 1/3/2001...released 1/4/2001 Fixed minor problem with the initial viewpoint calculated when using a tree list with georeferenced tree locations. Initial viewpoint elevation was way too high so the persepctive view showed a tiny speck in the centre of the screen. Added new species codes for UTAH variant of FVS. Affected files: winsvs.exe, fvs2svs.dll, svslib.dll 3.32 initiated 2/14/00...released 9/12/2000 Fixed problem with cover dialog use while marking trees. Initial version (3.30) allowed you to mark individual trees and groups while the cover dialog was up but did not hide the cover dialog when doing redraws. In addition, the cover estimates after marking were unreliable. This version diables the marking dialog while the cover dialog is up and diables individual and group marking. Added support for #LINE, #CIRCLE, #RECTANGLE, and #ARC drawing commands in tree list files. The presence of any one of these commands overrides the normal ground grid. Lines are only drawn when the ground grid is turned on in the perspective or overhead views. Added support for new FVS variants CA (Inland California) and SN (Southern) and updated tree form definitions for most other FVS variants. Also added form definitions that will be used for the FVS fuel and fire effects extensions. Affected files: winsvs.exe, svslib.dll, fvs2svs.dll, winsvs.hlp, fvs2svs.hlp, all FVS TRF files 3.31 initiated 12/15/99...released 12/15/99 Fixed problem with "launch editor" button not correctly formatting long file names. Result was the editor came up with no file. Affected files: winsvs.exe 3.30 initiated 12/1/99...released 12/15/99 Changed email address contact for Bob McGaughey. Corrected problem that occurred when loading a tree list index file that did not contain any stands. Added percent cover dialog. Added logic to marking/treatment to prompt for a save when there are changes to the stand or to marks for trees (added to help with percent cover using only marked trees). Fixed problems with marking/teratment when a minimum diameter limit is in effect. Added logic to use new FVS 26-char stand ID. Fixed a problem with TBL2SVS, ORG2SVS, ands FVS2SVS canopy closure estimates...estimate was incorrect when rectangular plots were created (plot aspect ratio other than 1.0). Closure estimates for square and round plots were correct. Corrected some minor problems with the tree form definitions for the Alaska, West Cascades, and Pacific Coast variants of FVS. Added DLL version reporting function to all libraries and version information to about dialog. Modified to the tree list index dialog to resize the stand list to better show long stand names. Made some minor changes to the viewpic utility to resize its index dialog to show longer filenames. Also corrected some behavior problems when viewpic was minimized. Affected files: winsvs.exe, tbl2svs.exe, tbl2svs.dll, fvs2svs.exe, fvs2svs.dll, org2svs.dll, svslib.dll, winsvs.hlp, fvs2svs.hlp, svslib.hlp, viewpic.exe major update so I will only provide a new install download (no update download) 3.29 never released...skipped to version 3.30 3.28 initiated 9/14/99...released 9/15/99 Corrected a problem with the use of forward slashes in path names within a tree list index file (SUPPOSE uses forward slashes). After opening such an index, SVS would not allow you to open any additional stand files. Fix involved searching the file name for forward slashes and replacing them with backslashes. Corrected problem when marking...stand information was not being updated when selecting or deselecting a group of trees. Affected files: winsvs.exe, svslib.dll 3.27 initiated 8/23/99...released 8/23/99 Corrected additional problems with the -Z command line option to run an FVS2SVS conversion from the WINSVS command line. The options for using a snag parameter file and a log file did not work correctly. Also changed the logic used when WINSVS encounters an SVS tree list with no trees. Previous versions would display an error message and not load the stand. Now WINSVS accepts and loads the SVS tree list with no trees without displaying an error message. Also fixed a typo in the fvs2svs.hlp file. Modified the logic used to differentiate live and dead trees when compiling stand graphs and statistics. Trees with a tree class value of 99 are considered live (they should be coded with a tree class value of 0 as 99 is reserved for the "default" tree form for a species). Affected files: winsvs.exe, fvs2svs.dll, svslib.dll, fvs2svs.hlp 3.26 initiated 8/6/99...released 8/6/99 Corrected a problem with the -Z command line option to run an FVS2SVS conversion from the WINSVS command line. The option did not work. Affected files: winsvs.exe 3.25 initiated 7/15/99...released 7/15/99 Identified a change to FVS tree list format such that dates and times in header do not contain leading 0 in single digit files (e.g. 7-14-99 instead of 07-14-99). This was causing an extra linefeed to be included in the time string which was being printed to an intermediate SVS file...breaking the transfer of data to the final SVS file. Result was a protection fault and empty SVS tree list. Affected files: winsvs.exe, fvs2svs.dll 3.24 initiated 7/9/99...released 7/12/99 Corrected a serious problem when opening more than one old format SVS tree list file from the same instance of SVS. The first file opens and is updated to the newer format but subsequent files are not converted properly and are corrupted beyond repair. Affected files: winsvs.exe, svslib.dll 3.23 initiated 7/2/99...released 7/2/99 Corrected problems in FVS2SVS conversion engine...snags and down logs were not being added to the individual SVS files produced when the -e (track mortality over time) option was specified. Affected files: winsvs.exe, fvs2svs.dll 3.22 initiated 6/28/99...released 6/29/99 fixed two small problems: +tbl2svs conversion engine was ignoring the -n0 option to set the seed for the random number generator based on the system clock +selecting groups of trees using shift-leftmouse or ctrl-leftmouse was selecting trees but not redrawing the markers correctly Affected files: winsvs.exe, svslib.dll, tbl2svs.dll 3.21 initiated 5/17/99...released 6/23/99 fixed a problem related to using a palette file from within an SVS file...there is no option to load a palette from within winsvs but it will load palettes that are specified in a tree list. however, the logic relied on a binary file stored in from the DOS version where int type was 2 bytes...32-bit code expects int type to be 4 bytes. fixed the problem and tested with palette files produced by DOS version. fixed/added support for file names on command lines enclosed in quotation marks...allows file names and directories with embedded spaces. fix was made to SVS, TBL2SVS, and FVS2SVS command line parsers added ability to convert a TBL2SVS or FVS2SVS file to the SVS command line...in use the -X option is followed by the name of a file containing the command line for TBL2SVS without the program name (TBL2SVS). When SVS starts up, it will run TBL2SVS (within DLL) using the command line then process the rest of the SVS command line. Similarly -Z is used for FVS2SVS. changed the default viewpoints for the perspective views so they view is looking down at the stand at about a 20 degree angle and the plot fits nicely on the screen. Seems to work for a wide range of plot sizes (tested 0.1 to 25 acres) 3.20 initiated 6/24/98...released internally for testing Major update to 32-bit version...no longer support 16-bit environment (win 3.xx) fixed several problems identified during a training session for BLM-Medford Tree designer was not always saving tree form changes when it should...after hitting New form... button Had some problems with the layout editor during the training...computer would hang with continuous beeps while moving mouse. Not sure if the problem was related to BLM or DOI logos but it first occurred when adding the BLM logo to a layout. Fixed a potential problem with panel width or height set to 0...changed the minimum width and some code associated with drawing the preview in the layout editor Fixed a problem in the layout editor...when you changed the aspect of the current panel, your screen did not resize after exiting the layout editor Disabled tree designer controls when they are not applicable...branch base is not used for conifer types Added a text message panel content to allow "labeling" You can use \n for new line, \t for tab (10 spaces), or \r for carriage return don't think carriage returns will be needed for anything Still having troubles with 256-color palette systems...SVS colors seem to get messed up on a redraw. Subsequent uses of the captured screen image then use the wrong palette (expect the standard SVS palette but something different was used when the image was drawn) fixed some problems in TBL2SVS and ORG2SVS engine code that allowed coordinates slightly out of the plot area. this caused a GPF in some cases removed limitation on the number of plants/objects in an SVS stand. the limit was originally due to 16-bit environment and the standard qsort library function. in the 32-bit world, the limitation no longer applies. added/enabled the preview button on the perspective view options dialog... button was always there but grayed fixed minor problem with font preferences dialog...you were forced to select a size even though SVS does not use the size (SVS sizes labels to fit the available space). size is now set to 12 points when you first enter the dialog fixed minor problem in the perspective options dialog that prevented you from dropping the head position below the focus position when using the scroll bar arrow (linedown). problem did not show up when using the pagedown portion of the scroll bar. drawing code for the perspective view checks for equal XY for head and focus and was also checking for equal Z...I don't think the equal Z check is needed... changed the size of some controls on the tree designer dialog. seem to have a problem with the size of scroll bar controls...when they are too small, there is no "thumb" so I made them bigger. there are still problems with controls and text labels being too large with some "properties|appearance" settings. when using large fonts, some labels become too long and wrap or get truncated added tree legend display to panel types and tree legend preferences to preferences dialog **parts of code are ready for a specified TRF file and other parts are not... initial implementation (3.20) only allows drawing trees from the current TRF file added FVS2SVS conversion code so you can convert FVS tree lists from within SVS changed progress dialog to use new windows progress control...eliminates some code and allows a simple step option so functions can show that they are doing somthing without having to figure out how far along they are (can be difficult with some functions) fixed a problem in the TBL2SVS and FVS2SVS libraries. When you used the option to estimate crown widths when they were 0.0 in the input data, all crown widths were estimated using a height multiplier...no crown widths from the input data were used. fixed redraw problems when dragging window contents. problem resulted in the SVS window getting stuck when partially off-screen with no way to move it back onto the screen. This problem only occurs when dragging window contents is enabled. To disable contents dragging, edit the registry using REGEDIT and add or change the string item HKEY_USERS-.Default-Control Panel-desktop-DragFullWindows = 0 You also need to do this for each user by replacing the .Default with user names. changed SVS tree list opening logic to open in read only mode...allows use of files on mapped drives that are mapped as read-only. fixed problem in TBL2SVS conversion engine that could result in an svs file with no path info...result was if the current directory changed, SVS could no longer open the file...same trouble in FVS2SVS. Only happened when you did not specify SVS file name on CL or in dialog fixed problem with layout editor...aspect ratio changes were not always being saved when the aspect slider lost focus. depended on which control "took" the focus so the behavior seemed intermittent changed menus to allow selection of layout directly from the menu added buttons to set the default CL options to the cl options display and button to set defaults CL options to current options on Preferences dialog fixed a problem with ground definition files and profile views...SVS was crashing when you tried to display a profile view with a ground def file loaded tweaked tree legend scaling so you can't end up inside a short, wide plant added marking and treatment logic...much more flexible than the DOS version