gmStudio Samples Overview
-------------------------
In addition to evaluating gmStudio using your own code, we provide a set of 
working examples which are already migrated to functional .NET solutions. 

The samples illustrate a wide range of techniques for implementing custom upgrade 
solutions. We encourage you to review, reproduce, verify, and otherwise experiment 
with the samples on your own and contact us if you would like any additional 
information or assistance.

Summarized below, these samples are expressed in both C# and VB.NET notations:

*  ScanTool: This multi-project file/directory analysis code
   -- Illustrates how to upgrade VB6/COM/Win32 Forms to .NET WinForms
   -- Implements an EXE and a DLL into an integrated .NET solution 
   -- Demonstrates how to upgrade VB6 forms to WPF (Windows Presentation Foundation) 
   -- Illustrates multi-project translations and translations of COM events 
   -- Illustrates COM and Win32 API replacements, GoTo-style error handling, etc.
   -- Shows how to generate stub assemblies and automatically integrate hand-written code 
      with the generated code.

*  WPFScanTool: This is the ScanTool sample targeting WPF
     
*  Waves: This stand-alone graphics/mathematics code
     -- Illustrates upgrading advanced forms, graphics, and complex math logic
   
*  vb3DDefine: This stand-alone graphics/mathematics code
   -- Illustrates upgrading advanced forms graphics and complex math logic
   
*  VBScan: This stand-alone VB6 Code Scanner\Reporter using Outline Control
   -- Illustrates mixed migration with some platform services upgraded 
      to .NET framework and others to local runtime support code

*  Calculator: This stand-alone calculator code 
   -- Illustrates upgrading control arrays and copy/paste through the
      clipboard
   
*  WPFCalculator: This Calculator sample targeting WPF

*  StringEvaluator: This stand-alone arithmetic and function evaluator code 
   -- Illustrates Win32 API replacements, complex logic, and resource management
   
*  FMStocks: This multi-project simplified stock trading code 
   -- Illustrates upgrading ASP to ASP.NET, shared file consolidation, and COM replacements 

*  FileExplorer: This stand-alone code
   -- Implements a simple directory/file explorer application
   -- Illustrates COM replacement and upgrading ActiveX controls to WinForms controls
   

Sample Folders
--------------
The samples are organized into folders:

    Calculator\       the Calculator sample (C# and VB.NET)
    FMStocks\         the FMStocks ASP/VB6 samples (C# and VB.NET)
    FileExplorer\     the FileExplorer sample (C# and VB.NET)
    ScanTool\         the ScanTool sample (C# and VB.NET)
    StringEvaluator\  the StringEvaluator sample (C# and VB.NET)
    vb3DDefine\       the vb3DDefine sample (C# and VB.NET)
    VBScan\           the VBScan sample (C# and VB.NET)
    Waves\            the Waves sample (C# and VB.NET)
    WPFScanTool\      the ScanTool sample in WPF (C# and VB.NET)
    WPFCaclulator\    the Calculator sample in WPF (C# and VB.NET)

For each sample, the files are organized into the following sub-folders:

    src\          the original VB6/ASP codes and supporting files
    results_???\  the generated output .NET codes and supporting files
    proj_???\     the gmStudio solution where you can experiment on your own 

                  ??? is csh or vbn for C# or VB.NET respectively.
   
Notes
-----
[1] To reproduce the sample translations on your own, you must have gmStudio 
    installed in your environment. You can try to build the VB6 codes in your 
    environment to ensure that you have the required COM components 
    registered correctly.
    
[2] The FMStocks sample needs an SQL database to run. Contact us to request
    a copy of the database for functional testing.

Learning More
-------------
gmStudio is a configurable and programmable VB6/ASP/COM code analysis and 
transformation platform; the sample translations given here are only one of 
many possible outcomes.  Please contact Great Migrations if you would like to 
see how to configure a solution that upgrades your VB6/ASP/COM codes to 
your .NET design standards. 

Please look over the gmStudio and gmBasic documentation for additional information and 
contact us with your questions and suggestions:
https://portal.greatmigrations.com/display/GMG/

Additional information on the samples is in the gmStudio User Guide:
https://portal.greatmigrations.com/display/GMG/Samples