windows.md

# Microsoft Windows {#windows}

##Tested versions

See the \link installation \endlink page for supported versions.

##Installation
On Windows, gclib is distributed in the following formats.
* An executable installer which will install the library in the proper location to work with the included examples and documentation. PCI users can optionally install the PCI driver from within this installer. 
* A zip file containing the same set of files as the executable but in a zip archive. PCI users can use the stand-alone PCI driver installer.
 * A stand-alone PCI driver installer for PCI users (DMC-1806, 1800, 1802, 1417).
 
\note The PCI driver is compatible with GalilTools but is enhanced for gclib communications. 

### Download Installer 
Recommended, all instructions and examples depend on installation paths.

\htmlonly
<ul>
<li><a target="_blank" href="http://www.galil.com/sw/pub/win/gclib/galil_gclib_exe.html">http://www.galil.com/sw/pub/win/gclib/galil_gclib_exe.html</a></li>
</ul>
\endhtmlonly

### Download Zip 
For custom deployment or non-default file locations.

\htmlonly
<ul>
<li><a target="_blank" href="http://www.galil.com/sw/pub/win/gclib/galil_gclib_zip.html">http://www.galil.com/sw/pub/win/gclib/galil_gclib_zip.html</a></li>
<li>Optional PCI Driver: <a href="http://www.galil.com/sw/pub/win/gclib/galil_pci_14.exe">http://www.galil.com/sw/pub/win/gclib/galil_pci_14.exe</a></li>
</ul>
\endhtmlonly
 
 If an earlier version is required, see http://www.galil.com/sw/pub/win/gclib/ for a list of all builds.

###Required third-party DLLs
gclib is built using MSVC2013 and requires run-time components available in the Visual C++ Redistributable Packages for Visual Studio 2013. 
On machines that don't already have Visual Studio 2013 installed, the required files can be installed from Microsoft. 
Be sure to install the appropriate architecture (x86 or x64).
  * http://www.microsoft.com/en-us/download/details.aspx?id=40784
  
### Uninstall gclib
* Run `uninstall.exe` in "C:\Program Files (x86)\Galil\gclib"

##Installed Files
Installation from the executable installer looks like the following. 

    C:\Program Files (x86)\Galil\gclib>tree /a
    Folder PATH listing for volume OS
    Volume serial number is AE3F-6836
    C:.
    +---dll
    |   +---x64
    |   \---x86
    +---doc
    |   \---html
    |       \---search
    +---examples
    |   +---cpp
    |   +---cs
    |   |   \---2013_12.0
    |   |       \---gclib_example
    |   |           \---gclib_example
    |   |               \---Properties
    |   +---gcc
    |   +---mingw
    |   +---msvc
    |   |   \---2013_12.0
    |   |       \---gclib_example
    |   |           \---gclib_example
    |   \---vb
    |       \---2013_12.0
    |           \---gclib_example
    |               \---gclib_example
    |                   \---My Project
    +---include
    +---lib
    |   \---dynamic
    |       +---x64
    |       \---x86
    \---source
        +---gclibo
        \---wrappers
            +---cs
            +---gcl
            \---vb


### dll
The *dll* directory contains the binary *dynamic link libraries* (DLLs) for both x86 and x64 architectures. **Dynamically linked executables must have the correct dlls in their path at runtime**.

###doc
The *doc* directory contains this documentation and a printable, pdf version.

###examples
The *examples* directory contains example projects for various compilers. The *cpp* directory contains *x_examples.h* and the implementation of the example files documented in this manual.

\warning
Before using the examples, copy the files to a user location such as *C:\\Users\\user\\Documents*. Failing to do so may cause source files to be deleted upon gclib uninstallation.

###include
The *include* directory contains header files needed for compiling code. The compiler will need to know where these files are at compile time.  
See the compiler-specific directions for more information, e.g. <a href="md_mingw.html">gclib using MinGW</a>.

###lib
The *lib* directory contains linker files (*gclib.lib* and *gclibo.lib*) for both x86 and x64 architectures.
The linker should include *gclib.lib* and *gclibo.lib*.

###source
The *source* directory contains source files such as gclibo.c.

---