Сборка движка X-Ray

2014-07-26T09:33:03Z

74.120.13.132: /* Автор */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка X-Ray и некоторые решения могут быть идиотскими, использование которых не рекомендуется. И я бы попросил любителей критики сильно не пинать, это моя первая статья и опыта написания таковых у меня нет. Ну что ж, хватит лирики, приступим-с...
== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на нубов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предпологается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio. Программистам с опытом этот туториал покажется очень смешным и глупым, и я бы советовал им пройти мимо, дабы они здесь ничего нового не найдут.
== Что необходимо для сборки? ==
* Первое, и самое главное. Наличие хоть капли мозга и более-менее прямых рук.
* Microsoft Visual Studio 2005 или 2008 или 2010 ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg_0|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=ACHTUNG|
message='''Данный туториал расчитан на VS 2010! При сборке на других, указанных выше студиях могут отсутствовать некоторые проблемы, разобраные в данной статье, и могут появиться другие, которые, возможно, не будут рассмотрены в данной статье!'''
}}
 
* S.T.A.L.K.E.R. Shadow of Cherbobyl 1.0006
== Сборка ==
=== Заранее хочется оговориться о структуре каталогов ===
* ''XRay'' -- корневой каталог движка
** ''xr_build'' -- Выходной каталог, здесь находятся распакованные ресурсы игры
** ''xr_src'' -- Каталог с исходными кодами движка
** ''dev-scripts'' -- Различные вспомогательные скрипты
=== Загрузка исходного кода движка и подготовительные работы ===
Скачиваем основной архив с исходниками: [https://bitbucket.org/stalker/x-ray/downloads/XRay.rar] 
'''Пароль:''' ljlLHhklknlked
 
Скачиваем архив с необходимыми для сборки SDKs и компонентами: [https://bitbucket.org/stalker/x-ray/downloads/src_components_for_xray.rar]
 
Распаковываем содержимое архивов ''XRay.rar'' и ''src_components_for_xray.rar'' в директорию ''XRay\xr_src'' 
В папке ''dev-scripts'' создаем два (*.cmd) файла - ''mountDisks.cmd'' и ''unmountDisks.cmd'' такого содержания:
 
''mountDisks.cmd'':
<code>
@ECHO OFF
@subst X: [Ваш путь до папки XRay]:\XRay\xr_build
@subst S: [Ваш путь до папки XRay]:\XRay\xr_src
exit
</code>
''unmountDisks.cmd'':
<code>
@ECHO OFF
@subst X: /D
@subst S: /D
exit
</code>
Запускаем ''mountDisks.cmd'', должны появиться два виртуальных диска: ''X'' и ''S''. ''X'' -выходной каталог, ''S'' - каталог исходников.
[[Файл:Ss_0.jpg|Виртуальные диски|frame|left|Виртуальные диски]]
 
Подготовительный этап закончен. Приступаем к настройке проектов.
=== Настройка проектов ===
Запускаем Visual Studio, на стартовой странице выбираем ''Открыть проект...'' или ''Файл -> Открыть -> Решение или проект...'' В появившемся окне выбираем ''S:\xr_3da\xr_3da.sln''. 
[[Image:Ss_1.jpg|512px]]
 
Появится окно мастера преобразования Visual Studio, жмём кнопку 'Готово' и ждём пока все проекты конвертируются в формат VS10 и пройдёт синтаксический анализ проектов. 
[[Image:Ss_2.jpg|512px]]
 
После того как всё сконвертировалось, перым делом открываем Диспетчер конфигураций (''ПКМ по решению -> Свойства -> Свойства конфигурации'') и выставляем решению активную конфигурацию ''Mixed'' (на чистом ''Debug'' ужасно падает производительность), а для сторонних библиотек (''BugTrap'', ''OpenAL'', ''minizip'', ''zlib'') ставим ''Release''. 
[[Image:Ss_3.jpg|512px]]
 
Ну а теперь самое муторное, это настройка собственно проектов. Каждый проект придется настраивать отдельно, собирать так же советую отдельно (''ПКМ по проекту -> Только проект -> Построить только [имя проекта]''). Порядок построения можно узнать так: ''ПКМ по любому проекту -> Зависимости проектов... -> Порядок построения''. Настраиваем выходные каталоги, промежуточные каталоги и выходные каталог для библиотек импорта по своему вкусу, у меня так (на примере ''BugTrap'', используется структура каталогов, упомянутая в начале статьи): 
[[Image:Ss_4.jpg|512px]] [[Image:Ss_5.jpg|512px]]
 
Далее необходимо настроить пути к заголовочным файлам и библиотекам импорта внешних библиотек. Ниже пойдёт таблица проектов (в порядке построения) с необходимыми для них библиотеками из директории ''xr_src\SDK'', пути настраиваются здесь: 
[[Image:Ss_6.jpg|512px]] [[Файл:Ss_7.jpg|512px]]
 
{|class="standard"
|-
!Проект||Необходимые библиотеки
|-
|'''xrCore'''||''DX''
|-
|'''xrCDB'''||''xrCore''
|-
|'''xrLua'''||''xrCore, LuaBind, Boost''
|-
|'''xrSound'''||''xrCore, Xiph libs, EAX, DX, OpenAL''
|-
|'''xrParticles'''||''n/a''
|-
|'''xrNetServer'''||''xrCore, DX, Boost''
|-
|'''xrXMLParser'''||''n/a''
|-
|'''XR_3DA'''||''xrCore, DX, xrLua\src, LuaBind, Boost, Xiph libs, OpenAL (*.lib only)''
|-
|'''ODE'''||''n/a''
|-
|'''xrCPU_Pipe'''||''xrCore, DX''
|-
|'''xrGameSpy'''||''n/a''
|-
|'''xrRender_R2'''||''xrCore, DX''
|-
|'''xrRender_R1'''||''xrCore, DX''
|-
|'''xrGame'''||''xrCore, DX, xrLua\src, LuaBind, Boost, Loki''
|}
 
{{Message_box|
id=kir_msg_1|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=На заметку|
message=xrGame самая "массивная" библиотека X-Ray, на некоторых машинах её сборка может занять прилично времени.
}}
 
=== Сборка ===
Собираем каждый проект, как я ранее написал, отдельно, по списку порядка построения. Ниже разбираются наиболее встречающиеся проблемы. 
'''xrCore'''
<code>error C2061: синтаксическая ошибка: идентификатор "__RPC__out_xcount_part</code>
Необходимо удалить файл ''rpcsal.h'' из директории ''S:\SDK\dx9sdk\dx9sdk\include''
 
'''xrLua'''
<code>error C2883: std::terminate: объявление функции вступает в конфликт с "terminate", присутствующем в "using"-объявлении</code>
Идём в ''S:\SDK\luabind\luabind\config.hpp'', строка 31 и добавляем в имя функции ''terminate'' прочерк ,было '''terminate''', стало '''_terminate'''.
{{Message_box|
id=kir_msg_2|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=ACHTUNG|
message=Функция '''_terminate''' существует в '''xrDebugNew!''' Не известно как это себя поведёт, лучше всё же закомментировать конструкцию '''namespace std { void terminate() }'''
}}
 
<code>error C2244: throw_exception: не удается сопоставить определение функции существующему объявлению</code>
В ''xrCore.h'', в строке ''14'' объявляем макрос ''BOOST_NO_EXCEPTIONS'' ('''#define BOOST_NO_EXCEPTIONS''')
<code>error C2668: boost::addressof: неоднозначный вызов перегруженной функции</code>
Лезем в ''S:\SDK\boost_1_30_0\function\function_template.hpp'', в строке ''472'' перед '''addressof''' дописываем '''boost::'''
 
'''xrGame'''
<code>error C2770: недопустимые явные аргументы шаблон для "_operator::_edge_value_type CProblemSolver<_operator_condition,_condition_state,_operator,_condition_evaluator,_operator_id_type,_reverse_search,_operator_ptr,_condition_evaluator_ptr>::estimate_edge_weight_impl(const _condition_state &) const"</code>
В ''S:\xr_3da\xrGame\problem_solver.h'', строка ''90''. Заменить этот кусок кода:
[[Файл:Ss_8.jpg|Кусок кода xrGame|frame|left|Кусок кода xrGame]]
 
На этот:
[[Файл:Ss_9.jpg|Кусок кода xrGame|frame|left|Кусок кода xrGame]]
 
И где-нибудь вне класса объявите структуру ''Bool2Type'':
[[Файл:Ss_10.jpg|Структура Bool2Type|frame|left|Структура Bool2Type]]
 
<code>error C2275: Pars: недопустимое использование этого типа в качестве выражения</code>
Здесь придётся вносить правки в несколько файлов, для начала лезем в ''S:\xr_3da\xrGame\PHMovementDynamicActivate.cpp'' и везде после '''Pars''' вместо точки ставим двойное двоеточие '''::''', также делаем и в ''xrGame\physics_game.cpp''
<code>error C2770: недопустимые явные аргументы шаблон для "luabind::detail::class_rep *luabind::detail::get_class_rep(lua_State *,void (__cdecl *)(T))"</code>
В ''S:\SDK\luabind\luabind\detail\class_cache.hpp'', строка ''78'', добавляем символ '''*''' после буквы '''T''':
 
[[Файл:Ss_11.jpg|Правка LuaBind|frame|left|Правка LuaBind]]
 
<code>error C2780: luabind::class_<T> &luabind::class_<T>::def(luabind::detail::operator_<Derived>): требует аргументов: 1, имеется: 2</code>
В ''S:\xr_3da\xrGame\game_cl_base_script.cpp'', строка ''17'', дописываем перед '''SZoneMapEntityData''' ключевое слово '''const''':
 
[[Файл:Ss_12.jpg|Правка xrGame|frame|left|Правка xrGame]]
 
== Congratulations! ==
Ну вот и всё, осталось только скопировать, если его там нет, ''fsgame.ltx'' в директорию с вашими бинам и создать (*.cmd) файл для запуска, ну или для продвинутых написать свой лаунчер (например написать свою ''xrLauncher.dll''). Приятных экспериментов!
== Послесловие ==
В скором времени появятся другие статьи по движку ST или по программированию, так или иначе связанным с ST, возможно появится статья по сборке X-Ray SDK, если Вам конечна понравилась эта статья.
 
Если Вами в статье была найдена какая-то ошибка или неточность, прошу сообщить мне.
 
Публикация на сторонних ресурсах разрешается '''ТОЛЬКО С УКАЗАНИЕМ НИКА АВТОРА'''. При публикации на стороннем ресурсе '''ЗАПРЕЩЕНО УДАЛЯТЬ РАЗДЕЛ БЛАГОДАРНОСТИ'''!
 
'''Просьба при внесении правок оставлять свою подпись.'''
== Благодарности ==
Я выражаю искрении благодарности следующим людям: '''K.D.''', '''HikeR''', '''Tron''' и всем остальным кто помогал в сборке движка. 
Ну и огромное спасибо '''GSC Game World''' за замечательный проект ST и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

S.T.A.L.K.E.R. Inside Wiki - Вклад участника [ru]

Сборка движка X-Ray