win32 · Step 3. Phase 1 — building the libraries (6 of them)

In this step all 6 libraries (.lib) are built for 32 bits. They must be built before any programs: the viewers and kernels link against the finished libraries.

The order among the libraries themselves does not matter — each .lib compiles independently. The main thing is to build all 6 before Phase 2 begins.

Before building, make sure (see 02-setup-paths.md, section 2.4): configuration Release, platform Win32.

KEY — _real precision (double). Before building, verify that in the shared header src\Include\Typerth.h double precision is active:

//#define _PREC_FLOAT
#define _PREC_DOUBLE

The _real type is part of the shared structures (ABI) and of the field file format, so the precision must be the same across all libraries and programs. Building in float leads to a false "rippling"/instability of the X-mode computation (tmc_rtx) — see 07-troubleshooting.md, § 7.8 (Bug #11). This is not a performance option but a correctness condition.

3.0 Common changes already made to the library projects

These changes were made during the first build under the modern compiler (toolset v145) and are needed for both win32 and win64. They are already applied — restated here so you understand that the projects are not "default".

Build-settings changes (.vcxproj), not code:

• The toolset was switched from v100 (VS2010, not installed) to v145.
• build\LibOutput.props is attached (shared Include/Lib paths + output to dist\<platform>\lib).
• Hard-coded paths E:\WORK, D:\work, Z:\work, d:\tmc\lib were removed.
• Obsolete overrides ObjectFileName / ProgramDataBaseFileName=.\Release/ were removed; they caused error C1041 (several cl.exe writing into one .pdb).
• For complex, a new complex.vcxproj was created (the old .vcproj format from VS2008 was converted, the /MT settings carried over).

Code changes (shared, needed for win32 too) — for compatibility with the modern compiler:

• C-1 — a name conflict for ETIME in the shared header src\Include\MAINWNDW.H (a member of enum ST_ITEMS). The modern <errno.h> (UCRT) defines the macro ETIME, which caused C2143/C2059 errors. Before the enum, #ifdef ETIME / #undef ETIME / #endif was added. The name ETIME is used only in this enum. The math is not affected.
• C-2 — in src\libs\SFILE95\Sadd.cpp (line 25) the header <error.h> was not found (C1083). Replaced with #include <Error1.h> — it holds the same #define error codes. The math is not affected.

These changes concern compiler compatibility, not bitness. They do not affect the computation results.

3.1 The common sequence for each library

For each of the 6 libraries the steps are the same:

1. In Visual Studio: File -> Open -> Project/Solution… and select the project file <Name>.vcxproj from the library folder (the exact name is in sections 3.2–3.7 below).

Open exactly the .vcxproj, NOT the .sln/.vcproj. In the library folders there are old files *.vcproj and *.sln (VS2008 format). Many .sln files reference the obsolete .vcproj — with hard paths (d:\work\lib) and without the Build checkbox. If you open the .sln, you build the old project and run into "Project not selected to build" (section 2.5) and a .lib in d:\work\lib (section 2.3.1). The new, already configured project is <Name>.vcxproj. 2. Check: configuration Release, platform Win32. 3. Build -> Build Solution. If you want a clean build — Build -> Rebuild Solution. 4. Wait for the message Build: 1 succeeded, 0 failed in the Output window. 5. Make sure the .lib file appeared in dist\win32\lib.

If the Output shows Skipped Build … Project not selected to build (Build: … 1 skipped) — the project is not marked to build. Enable the Build checkbox in Configuration Manager: see 02-setup-paths.md, section 2.5.

3.2 sfile95.lib

• Folder: src\libs\SFILE95
• Project (open this file): SFILE95.vcxproj
• Headers are taken from src\Include (via Common.props)
• Result: dist\win32\lib\sfile95.lib

Build following the sequence in 3.1.

3.3 complex.lib

• Folder: src\libs\complex
• Project (open this file): complex.vcxproj
• Result: dist\win32\lib\complex.lib

3.4 exprint.lib

• Folder: src\libs\exprint
• Project (open this file): exprint.vcxproj
• Result: dist\win32\lib\exprint.lib

This library uses sources from the neighboring folders src\libs\Expr and src\libs\Inter (referenced by exprint.vcxproj). They are already in place.

3.5 TMCLibError.lib

• Folder: src\libs\TMCLibError
• Project (open this file): TMCLibError.vcxproj
• Result: dist\win32\lib\TMCLibError.lib

3.6 prepr.lib

• Folder: src\libs\PREPR
• Project (open this file): Prepr.vcxproj
• Result: dist\win32\lib\prepr.lib

3.7 TMCIndan.lib

• Folder: src\libs\TMCIndan
• Project (open this file): TMCIndan.vcxproj
• Result: dist\win32\lib\TMCIndan.lib

3.8 Verifying Phase 1

Open the folder <ROOT>\dist\win32\lib. It must contain all 6 files:

sfile95.lib
complex.lib
exprint.lib
TMCLibError.lib
prepr.lib
TMCIndan.lib

If all 6 are in place, Phase 1 is complete. Proceed to 04-build-viewers.md.

Compiler warnings while building the libraries (C4996 unsafe CRT, C4267 size_t->short, C4700 uninitialized variable) are legacy noise; they do not affect the build or the computations.