Изтегляне и компилиране на рейтрейсъра (Windows/TortoiseGIT)
- Forums:
Тук ще опиша примерен подход за да подкарате и компилирате при вас учебния рейтрейсър, под OS Windows.
Трябват ви инсталирани:
- Среда за разработване (IDE) - едно от двете (по избор):
- Microsoft Visual Studio 2017 (visualstudio.com/downloads » Visual Studio 2017 Community » Free Download)
- Code::Blocks with mingw32 (codeblocks.org » downloads » download binary release » codeblocks-17.12mingw-setup.exe)
- msysgit (стандартна инсталация)
- TortoiseGIT (Опционално) (също стандартна инсталация)
След като инсталирате тези три неща, следващата стъпка е да свалите сорс-кода на проекта. За този курс ще ползваме сорс-контрол системата git. Ако никога не сте чували за нея, разгледайте едно кратко въведение.
След като сте инсталирали всичко свързано с git, посетете
http://code.raytracing-bg.net/
(или кликнете на линка в навигационното меню на този сайт, "Код").
Този линк ще ви препрати в github. Там ще видите (вдясно на страницата) един линк - HTTPS clone URL. Копирайте си URL-то.
С Windows explorer, идете в директория, където искате да свалите сорскода на проекта (например, на моята машина бих отишъл в F:\develop). Десен бутон там и от popup менюто изберете Git clone... . Ще ви се появи диалог, в който трябва да въведете URL към Git repository-то, което искате да изтеглите. Копирайте там URL-то, което сте взели от github страницата и натиснете ОК. Кодът ще ви се изтегли (нашият проект ще се казва fray и ще се образува във вид на директорийка вътре в избраното място (според примера горе, това би било F:\develop\fray). Предходните версии на учебния рейтрейсър се казваха fmiray, retrace, trinity и quaddamage - няма да работим на тях).
Следващата стъпка е да си подкарате необходимите SDK-та за нашия проект. Fray изисква библиотеките SDL, OpenEXR и Zlib, като с цел удобство има написани и скриптове за сваляне - "scripts/openexr_win.sh", "scripts/sdl_win.sh" и други - които свалят и разархивират библиотеките. Има и един общ скрипт, който извиква всичко необходимо. За да стартирате него е нужно да отворите Git bash в директорията на скриптовете (с десен бутон и контекстното меню "Git Bash here") и да ги извикате от командната линия:
> ./SETUP_dev_win.sh
Следвайте инструкциите от там. След него би трябвало да си отворите копирания проектен файл (fray.cbp или fray.vcxproj, в основната директория) и проектът да се компилира без засечки, а ако има проблеми - пишете тук.
(В случай, че скриптът не работи при вас или искате да си настроите средата "ръчно", запазили сме подробните инструкции за това).
Опционално, ако предпочитате да работите с CMake (или искате да научите нова build система), може да погледнете допълнителната информация, как може да се конфигурира проекта с CMake.
С това сте готови - оттук нататък можете да почнете да хаквате по кода на рейтрейсъра!