Files
Vocaluxe/HowToBuildWin.md
T
McSchneidar cf2fa796e2 .NET10 Migration (#946)
Runtime and build
- Move all projects to .NET 10 with SDK-style project files and a shared
  Directory.Build.props (WIN/LINUX, x86/x64 defines)
- Load managed and unmanaged dependencies from libs/managed and
  libs/unmanaged through assembly and native library resolvers
- Compile party modes with Roslyn instead of CodeDom
- Update AppVeyor to the .NET 10 SDK and dotnet test
- Download the FFmpeg and gstreamer runtimes from the dependencies
  repository during the build
- Remove the VC++ 2015-2022 runtime check, no dependency needs it anymore

Graphics and windowing
- Replace the Direct3D 9 renderer with Direct3D 11 (Vortice)
- Pace Direct3D 11 frames with a frame latency waitable swap chain
- Move window, input and message boxes to SDL3
- Replace System.Drawing with SkiaSharp and WinForms with SDL3 and a
  software renderer

Video and audio
- Replace Acinerella with FFmpeg 8.1.3 (FFmpeg.AutoGen)
- Add hardware accelerated video decoding (D3D11VA, DXVA2, VideoToolbox,
  VAAPI, VDPAU) with software fallback
- Convert YUV video frames to RGB on the GPU in Direct3D 11 and OpenGL
- Add the video options HardwareDecoding, GpuColorConversion,
  DecoderThreads and VideoDownscaleResolution
- Update OpenAL to OpenTK 4 and NAudio recording to WasapiRecorder

Fixes
- Fix the song preview start and shorten the reporter buttons
- Fix a crash when opening the highscore without a selected song
- Use the options slide highlight in the party mode screens to avoid
  brightness flicker on VRR displays
- Disable GameInput in the x86 build, SDL3 crashes in GameInputCreate
  on 32-bit systems with the GameInput runtime installed
- Fix a truncation warning in PitchTracker
2026-11-02 08:11:20 +01:00

61 lines
2.9 KiB
Markdown

# Build Vocaluxe - HowTo (Windows)
* Navigate to the right repository: usually [Vocaluxe Main](https://github.com/Vocaluxe/Vocaluxe)
* Navigate to the right branch: usually [develop](https://github.com/Vocaluxe/Vocaluxe/tree/develop) (The main branch of Vocaluxe)
![branch](https://cloud.githubusercontent.com/assets/5115160/4995706/bc5aa536-69c2-11e4-8534-b64573624a33.PNG)
* Copy the `URL` of the corresponding git file
![url](https://cloud.githubusercontent.com/assets/5115160/4995708/bc5af234-69c2-11e4-91d1-112972f35f01.PNG)
* Make sure [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) with the workloads `.NET desktop development` and `Desktop development with C++` and the [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) are installed
* Make sure [Node.js (LTS)](https://nodejs.org) is installed. It is needed to build the WebApp (folder `WebApp`), which is built automatically together with the project `VocaluxeWeb`. Restart Visual Studio after installing it.
* Clone the repository and open it
**Method A: Use Visual Studio (2013+)'s git client:**
* Start Visual Studio
* `VIEW`->`Team Explorer`
* Click on the `Connect to a Team Project` button inside the `Team Explorer`
* Click on `Clone` under `Local Git Repositories`
* Enter `[theCopiedGitUrl]` in the first field
* Enter a target folder in the second field
* Click clone
![vsclone](https://cloud.githubusercontent.com/assets/5115160/4998350/de81ca76-69d7-11e4-983d-d2886aa9faa0.png)
**Method B: Use commandline git client:**
* Make sure git is installed [git-scm](http://git-scm.com/)
* Open a `git bash` (there should be a link in the start menu)
or a normal commandline if you have added git to the `PATH` variable
* Navigate to the folder where git should create the Vocaluxe project folder
```
cd [PathToYourFolder]
```
* Clone the repository (could take some time...)
```
git clone [theCopiedGitUrl]
```
![clone](https://cloud.githubusercontent.com/assets/5115160/4995707/bc5aa6da-69c2-11e4-95cb-71ac7b0c3fc8.png)
* Now you should find a Folder `Vocaluxe` in the given directory -> navigate into it
* Open the file `Vocaluxe.sln` with Visual Studio
* Configure the build target to `ReleaseWin` and `x86` or `x64` (if unsure -> select `x86`)
* Build the projects by clicking `"Build"->"Build solution"` or just press `Control`+`Shift`+`B`
![build](https://cloud.githubusercontent.com/assets/5115160/4995709/bc5b3474-69c2-11e4-9d9b-b49f8a3b315d.png)
* Check if your build was successful
![buildsuccess](https://cloud.githubusercontent.com/assets/5115160/4995710/bc5b4fe0-69c2-11e4-8b0f-4acaeffbc568.png)
* YOUR build should have appeared here:
```
[PathToYourFolder]\Vocaluxe\Output
```
* Run `Vocaluxe.exe` or copy the whole folder to a location of your choice
* Have fun!