Тук ще опиша примерен подход за да подкарате и компилирате при вас учебния рейтрейсър, под OS Windows.

Тези инструкции са копие от README.md на проекта - вижте го и него, там нещата са описани по-накратко и са със сигурност up-to-date.

Трябват ви инсталирани:

1. Среда за разработване (IDE) - едно от двете (по избор):
   • Microsoft Visual Community - поддържат се версии 2017, 2019 и 2022.
   • Visual Studio Code с MinGW-w64
2. git или TortoiseGit (според вашите предпочитания)
3. cmake (стандартна инсталация)

След като инсталирате тези три неща, следващата стъпка е да свалите сорс-кода на проекта. За този курс ще ползваме сорс-контрол системата git. Ако никога не сте чували за нея, разгледайте я първо - ето примерно въведение.

След като сте инсталирали всичко свързано с git, посетете

code.raytracing-bg.net

(или кликнете на линка в навигационното меню на този сайт, "Код").

Този линк ще ви препрати в github. Там ще видите (вдясно на страницата) един линк - HTTPS clone URL. Копирайте си URL-то.

С Windows explorer, идете в директория, където искате да свалите сорскода на проекта (N.B.: избягвайте разполагането на проекта в директория, която съдържа кирилица или други non-latin символи в пътя (напр., "C:\Users\me\задачи и проекти\hexray")). Например, на моята машина бих отишъл в "C:\Users\vesko\develop". Десен бутон там и от popup менюто изберете Git clone... . Ще ви се появи диалог, в който трябва да въведете URL към Git repository-то, което искате да изтеглите. Копирайте там URL-то, което сте взели от github страницата и натиснете ОК. Кодът ще ви се изтегли (нашият проект ще се казва hexray и ще се образува във вид на директорийка вътре в избраното място (според примера горе, това би било C:\Users\vesko\develop\hexray). Предходните версии на учебния рейтрейсър се казваха fmiray, retrace, trinity, quaddamage и fray - няма да работим на тях).

Следващата стъпка е да си подкарате необходимите SDK-та за нашия проект. Hexray изисква библиотекaта SDL2, като в зависимост дали ползвате MSVC или MinGW-w64 като компилатор, трябва да си свалите различни файлове:

• За Visual Studio Community - ползвайте SDL-devel-2.30.1-VC.zip
• За Visual Studio Code + MinGW-w64 - ползвайте SDL-devel-2.30.1-mingw.zip
• За Linux - използвайте пакетния си мениджър, за да инсталирате SDL2-development библиотеката (apt install libsdl2-dev или yum install SDL2-devel)

За Windows, трябва да разположите разархивираната библиотека в някое от двете предефинирани места - C:\Users\«USERNAME»\develop\SDK\ или C:\SDK\. Ако изберете първото, например, трябва да съществува файла C:\Users\«USERNAME»\develop\SDK\SDL2-2.30.1\cmake, за да може CMake да види SDL.

Следващата стъпка е извикване на CMake, за да генерира проект или Makefiles. Тази страница описва процеса в детайли, а иначе просто следвайте каквото пише в README.md на hexray.

С това сте готови - оттук нататък можете да почнете да хаквате по кода на рейтрейсъра!