From 178d62164940643e38b63bb5bb33be59e2fbcc57 Mon Sep 17 00:00:00 2001 From: MachiaWorks Date: Thu, 10 Apr 2025 19:17:12 +0900 Subject: [PATCH 1/3] Update BUILDING.md --- BUILDING.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/BUILDING.md b/BUILDING.md index 0e69481..5f2f8a0 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -7,7 +7,7 @@ Soda is a command-line program written in C++ and using SDL. On most systems th 1. Make sure you have a C++ toolchain installed. Currently, the Linux/Mac makefile assumes this is accessed via a `gcc` command. You can use `gcc -v` to verify that such a compiler is installed, and check the version number. On Windows, install the [Visual Studio Command-Line Tools](https://docs.microsoft.com/en-us/cpp/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line?view=vs-2019). 2. Install the **SDL2** , **SDL2_image** and **SDL2_mixer** development libraries. For details, see: -- https://wiki.libsdl.org/Installation +- https://wiki.libsdl.org/SDL2/Installation - https://github.com/libsdl-org/SDL_image - https://github.com/libsdl-org/SDL_mixer @@ -22,9 +22,15 @@ Soda is a command-line program written in C++ and using SDL. On most systems th ## Build Steps (Windows) -0. Run the **Developer Command Prompt for VS**. -1. `cd soda` to change to the _soda_ subdirectory (next to this document). -2. `build_win.bat` to do the build. +1. Install build tools . +2. Please store the SDL include file and library file in a location that is compatible with the DeveloperCommandPrompt. +This procedure depends on the environment of the person building it, so I can't go into detail. +However, here are some hints: +If you store the SDL files in the storage location for include files and library files associated with the environment variable "VCToolsInstallDir", they will be recognized. +3. Launch **DeveloperCommandPrompt for VC 20xx** +4. command `cd soda` to change to the _soda_ subdirectory (next to this document). +5. command `build_win.bat` +6. The executable file will be written into the soda folder. When you run this program, it will display the execution location of the tool and the bitness of the exe file it will generate. From cea2fd8fcf7a5c4631f421ef106cc0a5cc06c936 Mon Sep 17 00:00:00 2001 From: MachiaWorks Date: Tue, 15 Apr 2025 20:37:06 +0900 Subject: [PATCH 2/3] update BUILDING.txt to launch. --- BUILDING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index 5f2f8a0..991bad9 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -38,5 +38,9 @@ If an include or library cannot be loaded during the build, look at the message that is displayed and check whether the library or include file exists in the folder associated with the executable file. +### usage +Place SDL2.dll, SDL2_image.dll, and SDL2_mixer.dll in the same folder as the executable file and launch either soda_x86.exe or soda_x64.exe. + +### warning. That should do it _if_ the SDL paths are all sorted out. Which they probably aren't. This is a work in progress. From 2784aba4a495d083b0186ce749794f63a451784b Mon Sep 17 00:00:00 2001 From: MachiaWorks Date: Tue, 15 Apr 2025 20:50:50 +0900 Subject: [PATCH 3/3] Review of various expressions. --- BUILDING.md | 6 ++++-- soda/build_win.bat | 2 ++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/BUILDING.md b/BUILDING.md index 991bad9..793472c 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -27,6 +27,8 @@ Soda is a command-line program written in C++ and using SDL. On most systems th This procedure depends on the environment of the person building it, so I can't go into detail. However, here are some hints: If you store the SDL files in the storage location for include files and library files associated with the environment variable "VCToolsInstallDir", they will be recognized. +Alternatively, you may want to store your include and library files in "soda/src". +In either case, the include files should be placed in the SDL2 folder. 3. Launch **DeveloperCommandPrompt for VC 20xx** 4. command `cd soda` to change to the _soda_ subdirectory (next to this document). 5. command `build_win.bat` @@ -38,9 +40,9 @@ If an include or library cannot be loaded during the build, look at the message that is displayed and check whether the library or include file exists in the folder associated with the executable file. -### usage +### Launch Soda Place SDL2.dll, SDL2_image.dll, and SDL2_mixer.dll in the same folder as the executable file and launch either soda_x86.exe or soda_x64.exe. -### warning. +### Warning. That should do it _if_ the SDL paths are all sorted out. Which they probably aren't. This is a work in progress. diff --git a/soda/build_win.bat b/soda/build_win.bat index 9eca955..457d49b 100644 --- a/soda/build_win.bat +++ b/soda/build_win.bat @@ -27,6 +27,8 @@ if defined VSCMD_ARG_TGT_ARCH ( echo this prompt calls %VSCMD_ARG_TGT_ARCH% build applications. echo If you are told that a library or include file does not exist, echo please check the "include" and "lib" folders in the above path. + echo Alternatively, you may want to store your include and library files in "soda/src". + echo In either case, the include files should be placed in the SDL2 folder. echo -------- move folder. -------- rem move to src folder.