Developer corner

• Windows

Download GIT from http://git-scm.com/download/win

Git-2.14.2.3-64-bit.exe (or current version)
Just follow the installer with all its defaults.

Access to Sources have to be granted in advance by Rocrail (request in the forum).

start the Git CMD application

• git clone <granted link> for the first time

Download TDM-GCC from http://tdm-gcc.tdragon.net/download

32bit: tdm-gcc-5.1.0-3.exe

64bit: tdm64-gcc-5.1.0-2.exe (Make sure the 32 bit compiler is deinstalled.)

Just follow the installer with all its defaults.

Download:
https://github.com/wxWidgets/wxWidgets/releases/download/v3.0.3/wxWidgets-3.0.3.zip

Extract wxWidgets-3.0.3.zip into Downloads\wxWidgets-3.0.3

wxGraphicsContext is disabled by default for other compilers than Visual C++.
To enable it you just have to edit the "setup.h" file (in the include\wx\msw subfolder of the wxWidgets sources).
If the file is not present, make a copy of the one named "setup0.h" and name it "setup.h"
In this file, search for wxGraphicsContext.
You should find a section like the following (this is the wx-3.0.x version of the setup.h file):

// notice that we can't use wxCHECK_VISUALC_VERSION() here as this file is
// included from wx/platform.h before wxCHECK_VISUALC_VERSION() is defined
#ifdef _MSC_VER
#   if _MSC_VER >= 1310
        // MSVC7.1+ comes with new enough Platform SDK, enable
        // wxGraphicsContext support for it
#       define wxUSE_GRAPHICS_CONTEXT 1
#   else
        // MSVC 6 didn't include GDI+ headers so disable by default, enable it
        // here if you use MSVC 6 with a newer SDK
#       define wxUSE_GRAPHICS_CONTEXT 0
#   endif
#else
    // Disable support for other Windows compilers, enable it if your compiler
    // comes with new enough SDK or you installed the headers manually.
    //
    // Notice that this will be set by configure under non-Windows platforms
    // anyhow so the value there is not important.
#   define wxUSE_GRAPHICS_CONTEXT 0
#endif

Replace the last # define wxUSE_GRAPHICS_CONTEXT 0 by # define wxUSE_GRAPHICS_CONTEXT 1
Save and launch the build process and wxGraphicsContext should be enabled.

Open a terminal. (cmd.exe)

cd Downloads\wxWidgets-3.0.3\build\msw
mingw32-make -f makefile.gcc BUILD=release UNICODE=1 MONOLITHIC=1 SHARED=0 USE_GUI=1 CXXFLAGS="-std=gnu++11"

After the build is ready, the libraries are found here:

Downloads\wxWidgets-3.0.3\lib\gcc_lib

In the build setup.h file the wxUSE_GRAPHICS_CONTEXT must also be set to 1.
Path to the setup.h is:

lib\gcc_lib\mswu\wx\setup.h

See also Enable Graphics Context in the sources

As a prerequisite move the full wxWidgets-3.0.3 directory from

Downloads\wxWidgets-3.0.3

to

\Users\<name>\wxWidgets-3.0.3

(or any path you may use)

Open a terminal and:

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN32 NATIVE=WIN32 DEBUG= MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN64 NATIVE=WIN64 DEBUG= MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

If another path for wxwidgets was chosen, then MINGWINSTALL= have to point the selected path.

After successful compilation the new build is located in

C:\Users\<name>\Rocrail\winbin

Move rocrail.exe, rocview.exe, all .dll and optional the svg directory in your operational Rocrail directory

Updates are only possible after the procedure from the scratch. The whole environment and a local git clone & build have to be in place.

Start the Git CMD application

cd C:\Users\<name>\Rocrail
git pull 

Open a terminal and:

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN32 NATIVE=WIN32 DEBUG= MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN64 NATIVE=WIN64 DEBUG= MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

If another path for wxwidgets was chosen, then MINGWINSTALL= have to point the selected path.

After successful compilation the new build is located in

C:\Users\<name>\(Projects)\Rocrail\winbin

Move rocrail.exe, rocview.exe, all .dll and optional the svg directory in your operational Rocrail directory

Sometimes debugging will create useful information for the developers, especially when there is a Rocrail server crash.
Building Rocrail from sources for debugging needs the same environment as described above.

Open a terminal and:

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN32 NATIVE=WIN32 MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

cd C:\Users\<name>\Rocrail
mingw32-make PLATFORM=WIN64 NATIVE=WIN64 MINGWINSTALL=C:\Users\<name>\wxWidgets-3.0.3

If another path for wxwidgets was chosen, then MINGWINSTALL= have to point the selected path.

After successful compilation the new debug build is located in

C:\Users\<name>\Rocrail\winbin

Open a console

cd C:\Users\<name>\Rocrail\winbin
gdb --args rocrail.exe -l <your-dll-directory> -w <your-workspace-directory>

[example: gdb --args rocrail.exe -l c:\users\xxx\rocrail\winbin -w c:\users\xxx\documents\ROCRAIL\Taktplan_8_FPA5]

run

• After starting the server with this options start Rocview and the plan to test&debug should be presented.
  
• When the server crash occurs, switch immediately to the console windows and enter the cmd bt (which means backtrace)
  
• Copy the full information of the bt output into a editor, save the file and post it in the Rocrail Forum for analysis.