This page walks you through setting up Ultimate++ (UPP) development environment and compiling the hcm4afs.dll library with TheIDE.
1 Set up the UPP framework
1.1 Download UPP
Download the latest UPP release.
1.2 Unpack the archive
- Extract the archive - e.g. to
C:\upp. - Open the extracted folder; you should see
theide.exe.
1.3 Launch TheIDE
Navigate to the UPP folder and start the theide.exe file. If Windows Defender prompts you with a security warning, allow the execution of the file. Note: This is a standard warning for files from unknown sources.
1.4 Accept Copyright Notice
When prompted with the copyright dialog:
Press Yes to proceed. Wait for the UPP framework to initialize fully. Once initialization is complete, a dialog window will appear.
1.5 Close UPP After Initialization
In the dialog window, press Cancel. This will close the UPP framework and complete the setup process. You are now ready to compile the software.
2 Compiling hcm4afs.dll
2.1 Prepare the Project Directory
Inside the UPP folder, create the following directory structure:
MyApps/
└── _HCM4A/
└── hcm4afs/
Note: The underscore (_) in _HCM4A is required for proper compilation.
Place the DLL library source code into the hcm4afs folder.
Example path: C:\upp\MyApps\_HCM4A\hcm4afs\
2.2 Open the Project in UPP
Launch theide.exe again. Select the assembly for hcm4afs.dll from the MyApps folder and press OK to open the project.
2.3 Build the DLL File
In the UPP interface, open the Build menu. Select the Build command.
2.4 Monitor the Compilation Process
The UPP IDE console at the bottom of the window will display the build progress. Once the build completes, the compiled hcm4afs.dll file will be saved in the output folder.
2.5 Finalize
Close the UPP framework. The hcm4afs.dll file is now ready for use with the CalcFS4A program. Note: Only the compiled DLL file is needed for further work.
3 Compiling CalcFS4A.exe
3.1 Prepare the GUI Project Directory
Similar to step 2.1 above, inside the "MyApps" folder, create a folder for the GUI program source code (e.g. C:\upp\MyApps\_HCM4A\CalcFS4A\). Place the GUI source code in this folder.
3.2 Open the CalcFS4A Project in UPP
Start theide.exe and select the assembly from the MyApps folder for CalcFS4A, then press OK to open the project.
3.3 Install Additional UPP Components
Before opening the project, the UPP framework GUI may prompt you to install additional components. Press "Yes" to proceed.
3.4 Complete Component Installation
After installation is complete, in the new dialog window, press "Close".
3.5 Build the EXE File
In the UPP framework interface, open the "Build" menu and press the "Build" command.
3.6 Monitor the Compilation Process
After a few minutes, "CalcFS4A.exe" will be compiled. The IDE console at the bottom of the window will indicate progress and show the output folder. Ignore any warnings at the end of the compilation process (they do not affect proper compilation) and check the console for the output file.
3.7 Finalize
Close the UPP framework program. The "CalcFS4A.exe" file is now compiled and can be used with the DLL library (only the EXE file output is needed for further work).
4 Combining into the Final Software
4.1 Place DLL and EXE Files Together
Place the DLL file and EXE file in a new folder (e.g. C:\CalcFS4A\).
4.2 Generate Additional Files
After the first start of the software, some additional files will be generated automatically.
4.3 Provide Mapping Data
Before performing any calculations, download the required mapping data and provide it in the Tools > Options menu.
