1. Install cygwyn:

   http://www.cygwin.com/

   and probably also make sure you have the emacs editor in your arsenal.

2. Make sure you have Microsoft VS2008 - VS2019.  The
   exact directories listed below are not mandatory but reflect on our
   development environment and following these directories will prevent
   you updating makefiles and/or solution files every time you update the
   build, so it is strongly recommended. windowsVC20?? below stands for the
   version you had like to use, i.e. windowsVC2017.

3. Download the following from www.cs.technion.ac.il/~gershon/BuildGuirit:

   a. irit-sm?????202?.zip - Current version of Irit.  E.g.
      irit-sm16May2021.zip
   b. clibs.zip (clibs1.zip and clibs2.zip are just clibs.zip divided, to
      ease the download) - extra already compiled auxiliary libraries that
      are used by GuIrit.  These are libraries for images and fonts
      processing, etc.     
   c. wxMSW*-setup.exe - the current version of wxWidgets we use (See also
      http://www.wxwidgets.org/). I.e. wxMSW-x.x.x-Setup.exe.
   d. GuIrit*zip - current version of GuIrit.  E.g. Guirit_16May2021.zip.

4. Unpack clibs.zip (or clib1/2.zip which are the same but split
   into two) in "c:\c".  This zip holds (mostly image processing) external
   libraries we link to.

5. Unpack irit-sm.zip in "c:\irit\irit" and build irit using either the 
   makefile.wnt/makeflag.wnt or via the IRIT_SM/IRIT_SM.sln solutions,
   in the respective "c:\irit\irit\windowsVC20??" directory.  If you
   use the solution, you will have to update the GuIrit solution below
   to the proper directories where the IRIT libraries are placed.  The
   GuIrit solution assumes the libraries are in "c:\irit\irit\lib" and
   the executables (and irit{D}.dll that is used by GuIrit) are in
   "c:\irit\irit\ntbin" which are the destinations in the case of the
   makefiles.  The IRIT_SM solution places the libraries and
   executables under "c:\irit\irit\windowsVS20??\{lib|lib64} and
   {ntbin|ntbin64}.

     You are also invited to read INSTALL_readme.1st in "c:\irit\irit".

6. Run the wxMSW-*-setup.exe and unpack wxWidgets into
   "C:\c\wxWindows\wxWidgets-*".  For instance, for wxMSW-3.1.0-Setup.exe,
   the sources should be placed in C:\c\wxWindows\wxWidgets-3.1.0 for VS2008
   and in C:\c\wxWindows\wxWidgets-3.1.0-VC12 for VS2012.

   Update the setup.h in include\wx\msw (if setup.h does not exist in this
   directory do "copy setup0.h setup.h" there):

   #define wxUSE_STD_IOSTREAM  1
   #define wxUSE_GLCANVAS      1
   #define wxUSE_MEMORY_TRACING 1

   and make sure no unicode:

   #define wxUSE_UNICODE 1

   open the wx.{dsw|sln} in build/msw and compile both 32 bit and 64
   bit version, if you like to use the 64 bits versions as well.  Note
   for VS2012 you can also open and use the VS2010 version in wxWidgets.
   

The above steps 3, 4, 5, 6 are completely independent and hence if you
are having a problem in one, try to progress on the other fronts...
Step 7 below, however, requires all the above to be complete so
continue to step 7 only if all the above is successful.

7. Unpack the GuIrit*zip file in "c:\irit\extra\GuIrit".  Cd to 
   "c:\irit\extra\GuIrit\Src\WindowsVC20??" and open and compile using the
   GuIrit.sln solution there.

-----------------------------------------------------------------------------


GuIrit Manual Installation - For VS2005/2008 32 bits
--------------------------------------------------------------------

Copy  C:\irit\extra\guirit\Src\WindowsVS2008\GuIrit\{Debug|Release}\GuIrit.exe
      to c:\irit\irit\ntbin

in C:\irit\extra\guirit\Src\GuIrit, execute GenGuiritCfg.cmd (you will need
      Cygwin on your machine to execute this script), for example:
      "GenGuiritCfg Win GuiritCfg.txt Guirit.cfg"
      to generate Guirit.cfg

Copy  c:\irit\extra\guirit\Src\GuIrit\Guirit.cfg  to
      c:\irit\irit\ntbin\Guirit.cfg

Copy  C:\irit\extra\guirit\Src\WindowsVS2008\GuIrit\{Debug|Release}\GuiritDllExtensions.dll
      to c:\irit\irit\ntbin
      (This copies the special extensions' dll next to the executable.)

Copy  C:\irit\extra\guirit\Src\RunTime\GuIritData  (the entire directory) to
      c:\irit\irit\ntbin

Copy  C:\irit\extra\guirit\Src\WindowsVS2008\GuIrit\{Debug|Release}\*dll  to
      c:\irit\irit\ntbin\GuIritData\Extensions
      (This copies all the dlls.)


GuIrit Manual Installation - For VS2017 32 bits or 64 bits
--------------------------------------------------------------------

Copy  C:\irit\extra\guirit\Src\WindowsVS2017\{ntbin|ntbin64}\{GuIrit{D}.exe|GuIrit{D}64.exe}
      to c:\irit\irit\{ntbin|ntbin64}

Copy  c:\irit\extra\guirit\Src\GuIrit\{Guirit.cfg|GuIrit64.cfg}  to
      c:\irit\irit\{ntbin|ntbin64}\{Guirit.cfg|GuIrit64.cfg}

Copy  C:\irit\extra\guirit\Src\WindowsVS2017\{ntbin|ntbin64}\{GuIritDllExtensions{D}.dll|GuIritDllExtensions_{D}64.dll}
      to c:\irit\irit\{ntbin|ntbin64}
      (This copies the special extensions' dll next to the executable.)

Copy  C:\irit\extra\guirit\Src\RunTime\GuIritData to c:\irit\irit\{ntbin\GuIritData|ntbin64\GuIritData64}

Copy  C:\irit\extra\guirit\Src\WindowsVS2017\{ntbin|ntbin64}\*.dll  to
      c:\irit\irit\{ntbin|ntbin64}\{GuIritData|GuIritData64}\Extensions
      (This copies all the dlls.)



Under XP:
---------
Copy  c:\irit\extra\guirit\Src\GuIrit\GuiritGui.cfg  to
      %USERPROFILE%\Application Data\GuIrit\GuiritGui.cfg

Edit "c:\irit\irit\ntbin\Guirit.cfg", find variable "GuIritWINGuiCfg"
     and select the location of GuiritGui.cfg under XP



Under Win 7/10:
---------------
Copy  c:\irit\extra\guirit\Src\GuIrit\GuiritGui.cfg  to
      %USERPROFILE%\AppData\GuIrit\GuiritGui.cfg

Edit "c:\irit\irit\ntbin\Guirit.cfg", find variable "GuIritWINGuiCfg"
     and select the location of GuiritGui.cfg under Win 7/10

--------------------------------------------------------------------

Environment variables:
----------------------

IRIT_BIN_IPC=1
IRIT_DISPLAY=wntgdrvs -s-
IRIT_PATH=c:\irit\irit\ntbin
PYTHONPATH=c:\util\python27\lib

and add "c:\irit\irit\ntbin" (and "C:\c\ffmpeg\ffmpeg\bin" or similar
if you use ffmpeg) to your PATH environment variable.