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

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

2015-08-27T05:16:47Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (Stalker_net и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
Последние изменения (автор): 26.08.2015. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

Ключи запуска X-Ray

2015-08-26T17:36:25Z

KIRAY:

[[Категория:Команды_консоли]]
{|class=standart
|-
!Ключ||Комментарий
|-
|'''-batch_benchmark''' || запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$''
|-
|'''-nojit''' || отключен
|-
|'''-bug''' || устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в значение истина. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию
|-
|'''-build''' || устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-ebuild''' || устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|style="background-color:red"|'''-gebug_ge''' || ??
|-
|'''-i''' || отключает захват устройства ввода
|-
|'''-keep_lua''' || запрещает перезапуск LVM
|-
|'''-mem_debug''' || включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'')
|-
|'''-mt_cdb''' || что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction''
|-
|'''-nes_texture_storing''' || что-то делает с текстурами при ??отгрузки уровня??
|-
|'''-netsim''' || включает симуляцию сети ?
|-
|'''-no_call_stack_assert''' || отключает вывод в лог call stack'a
|-
|style="background-color:red"|'''-no_direct_connect''' || ??
|-
|'''-nodf24''' || отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4)
|-
|'''-nonvs''' || отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil)
|-
|'''-pure_alloc''' || что-то связаное с пулом
|-
|'''-sjitter''' || как-то влияет на компиляцию шейдеров
|-
|'''-forceskinw''' || как-то влияет на компиляцию шейдеров
|-
|'''-sunfilter''' || как-то влияет на компиляцию шейдеров
|-
|'''-svcfg''' || Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'')
|-
|'''-tsh''' || как-то влияет на компиляцию шейдеров (какие-то T тени)
|-
|'''-tdemo''' || Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования)
|-
|'''-tdemof''' || тоже самое, только что-то там с кадрами мутится
|-
|'''-techdemo''' || режим записи демо?
|-
|'''-x86''' || отключает использование инструкций ''SSE, SSE2, 3DNow''??
|-
|'''-xclsx''' || отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-tune''' || запуск профиливщика ''Intel vTune''
|-
|'''-center_screen''' || Центирует окно в оконном режиме
|-
|'''-launcher''' || Выполняет функцию ''RunXRLauncher'' из ''xrLauncher.dll''. Отключен
|}

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T17:28:24Z

KIRAY:

[[Категория:Команды_консоли]]
{|class=standart
|-
!Ключ||Комментарий
|-
|'''-batch_benchmark''' || запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$''
|-
|'''-nojit''' || отключен
|-
|'''-bug''' || устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в значение истина. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию
|-
|'''-build''' || устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-ebuild''' || устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|style="background-color:red"|'''-gebug_ge''' || ??
|-
|'''-i''' || отключает захват устройства ввода
|-
|'''-keep_lua''' || запрещает перезапуск LVM
|-
|'''-mem_debug''' || включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'')
|-
|'''-mt_cdb''' || что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction''
|-
|'''-nes_texture_storing''' || что-то делает с текстурами при ??отгрузки уровня??
|-
|'''-netsim''' || включает симуляцию сети ?
|-
|'''-no_call_stack_assert''' || отключает вывод в лог call stack'a
|-
|style="background-color:red"|'''-no_direct_connect''' || ??
|-
|'''-nodf24''' || отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4)
|-
|'''-nonvs''' || отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil)
|-
|'''-pure_alloc''' || что-то связаное с пулом
|-
|'''-sjitter''' || как-то влияет на компиляцию шейдеров
|-
|'''-forceskinw''' || как-то влияет на компиляцию шейдеров
|-
|'''-sunfilter''' || как-то влияет на компиляцию шейдеров
|-
|'''-svcfg''' || Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'')
|-
|'''-tsh''' || как-то влияет на компиляцию шейдеров (какие-то T тени)
|-
|'''-tdemo''' || Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования)
|-
|'''-tdemof''' || тоже самое, только что-то там с кадрами мутится
|-
|'''-techdemo''' || режим записи демо?
|-
|'''-x86''' || отключает использование инструкций ''SSE, SSE2, 3DNow''??
|-
|'''-xclsx''' || отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-tune''' || запуск профиливщика ''Intel vTune''
|-
|}

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T17:26:40Z

KIRAY:

[[Категория:Команды_консоли]]
{|class=standart
|-
!Ключ||Комментарий
|-
|'''-batch_benchmark''' || запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$''
|-
|'''-nojit''' || отключен
|-
|'''-bug''' || устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию
|-
|'''-build''' || устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-ebuild''' || устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|style="background-color:red"|'''-gebug_ge''' || ??
|-
|'''-i''' || отключает захват устройства ввода
|-
|'''-keep_lua''' || запрещает перезапуск LVM
|-
|'''-mem_debug''' || включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'')
|-
|'''-mt_cdb''' || что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction''
|-
|'''-nes_texture_storing''' || что-то делает с текстурами при ??отгрузки уровня??
|-
|'''-netsim''' || включает симуляцию сети ?
|-
|'''-no_call_stack_assert''' || отключает вывод в лог call stack'a
|-
|style="background-color:red"|'''-no_direct_connect''' || ??
|-
|'''-nodf24''' || отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4)
|-
|'''-nonvs''' || отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil)
|-
|'''-pure_alloc''' || что-то связаное с пулом
|-
|'''-sjitter''' || как-то влияет на компиляцию шейдеров
|-
|'''-forceskinw''' || как-то влияет на компиляцию шейдеров
|-
|'''-sunfilter''' || как-то влияет на компиляцию шейдеров
|-
|'''-svcfg''' || Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'')
|-
|'''-tsh''' || как-то влияет на компиляцию шейдеров (какие-то T тени)
|-
|'''-tdemo''' || Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования)
|-
|'''-tdemof''' || тоже самое, только что-то там с кадрами мутится
|-
|'''-techdemo''' || режим записи демо?
|-
|'''-x86''' || отключает использование инструкций ''SSE, SSE2, 3DNow''??
|-
|'''-xclsx''' || отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-tune''' || запуск профиливщика ''Intel vTune''
|-
|}

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T17:24:02Z

KIRAY:

[[Категория:Команды_консоли]]
{|class=standart
|-
!Ключ||Комментарий
|-
|'''-batch_benchmark''' || запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$''
|-
|'''-nojit''' || отключен
|-
|'''-bug''' || устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию
|-
|'''-build''' || устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-ebuild''' || устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|style="background-color:red"|'''-gebug_ge''' || ??
|-
|'''-i''' || отключает захват устройства ввода
|-
|'''-keep_lua''' || запрещает перезапуск LVM
|-
|'''-mem_debug''' || включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'')
|-
|'''-mt_cdb''' || что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction''
|-
|'''-nes_texture_storing''' || что-то делает с текстурами при ??отгрузки уровня??
|-
|'''-netsim''' || включает симуляцию сети ?
|-
|'''-no_call_stack_assert''' || отключает вывод в лог call stack'a
|-
|style="background-color:red"|'''-no_direct_connect''' || ??
|-
|'''-nodf24''' || отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4)
|-
|'''-nonvs''' || отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil)
|-
|'''-pure_alloc''' || что-то связано с пулом
|-
|'''-sjitter''' || как-то влияет на компиляцию шейдеров
|-
|'''-forceskinw''' || как-то влияет на компиляцию шейдеров
|-
|'''-sunfilter''' || как-то влияет на компиляцию шейдеров
|-
|'''-svcfg''' || Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'')
|-
|'''-tsh''' || как-то влияет на компиляцию шейдеров (какие-то T тени)
|-
|'''-tdemo''' || Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования)
|-
|'''-tdemof''' || тоже самое, только что-то там с кадрами мутится
|-
|'''-techdemo''' || режим записи демо?
|-
|'''-x86''' || отключает использование инструкций ''SSE, SSE2, 3DNow''??
|-
|'''-xclsx''' || отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-tune''' || запуск профиливщика ''Intel vTune''
|-
|}

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T17:21:54Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>

{|class=standart
|-
!Ключ||Комментарий
|-
|'''-batch_benchmark''' || запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$''
|-
|'''-nojit''' || отключен
|-
|'''-bug''' || устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию
|-
|'''-build''' || устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-ebuild''' || устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|style="background-color:red"|'''-gebug_ge''' || ??
|-
|'''-i''' || отключает захват устройства ввода
|-
|'''-keep_lua''' || запрещает перезапуск LVM
|-
|'''-mem_debug''' || включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'')
|-
|'''-mt_cdb''' || что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction''
|-
|'''-nes_texture_storing''' || что-то делает с текстурами при ??отгрузки уровня??
|-
|'''-netsim''' || включает симуляцию сети ?
|-
|'''-no_call_stack_assert''' || отключает вывод в лог call stack'a
|-
|style="background-color:red"|'''-no_direct_connect''' || ??
|-
|'''-nodf24''' || отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4)
|-
|'''-nonvs''' || отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil)
|-
|'''-pure_alloc''' || что-то связано с пулом
|-
|'''-sjitter''' || как-то влияет на компиляцию шейдеров
|-
|'''-forceskinw''' || как-то влияет на компиляцию шейдеров
|-
|'''-sunfilter''' || как-то влияет на компиляцию шейдеров
|-
|'''-svcfg''' || Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'')
|-
|'''-tsh''' || как-то влияет на компиляцию шейдеров (какие-то T тени)
|-
|'''-tdemo''' || Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования)
|-
|'''-tdemof''' || тоже самое, только что-то там с кадрами мутится
|-
|'''-techdemo''' || режим записи демо?
|-
|'''-x86''' || отключает использование инструкций ''SSE, SSE2, 3DNow''??
|-
|'''-xclsx''' || отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях)
|-
|'''-tune''' || запуск профиливщика ''Intel vTune''
|-
|}
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:11:58Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _G}
setfenv(1, this)</lua>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$'' 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'') 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction'' 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'') 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций ''SSE, SSE2, 3DNow''?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-tune''' - запуск профиливщика ''Intel vTune'' 
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:11:25Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<lua>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</lua>

Без него:
<lua>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _g}
setfenv(1, this)</lua>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$'' 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'') 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction'' 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'') 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций ''SSE, SSE2, 3DNow''?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-tune''' - запуск профиливщика ''Intel vTune'' 
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:10:16Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<code>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</code>

Без него:
<code>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _g}
setfenv(1, this)</code>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$'' 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'') 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction'' 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки ''level.game'' Параметр: имя выполняемого файла (''*.ltx'') 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций ''SSE, SSE2, 3DNow''?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-tune''' - запуск профиливщика ''Intel vTune'' 
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:09:39Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<code>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</code>

Без него:
<code>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _g}
setfenv(1, this)</code>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$'' 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'') 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction'' 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки 'level.game' Параметр: имя выполняемого файла (''*.ltx'') 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций ''SSE, SSE2, 3DNow''?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-tune''' - запуск профиливщика ''Intel vTune'' 
_____
 Статья будет дополняться... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:09:01Z

KIRAY:

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<code>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</code>

Без него:
<code>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _g}
setfenv(1, this)</code>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (''*.ini'', ''*.ltx''). Файл ищется в ''$app_data_root$'' 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) ''bug'' структуры ''_options'' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы ''flBuildCopy''. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из ''$server_root$'' (''$server_data_root$'') в ''$build_copy$'' (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы ''flBuildCopy'' и ''flEBuildCopy''. (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой ''dbg_mem_check'' (доступна, как и ''dbg_mem_dump'', если определен макрос ''DEBUG_MEMORY_MANAGER'') 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток ''CDB-construction'' 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки 'level.game' Параметр: имя выполняемого файла (''*.ltx'') 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций ''SSE, SSE2, 3DNow''?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на ''Debug'', ''Mixed'' конфигурациях) 
'''-tune''' - запуск профиливщика ''Intel vTune'' 
_____
 Статья будет дополнятся... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

Ключи запуска X-Ray

2015-08-26T15:05:34Z

KIRAY: Новая страница: «Категория:Команды_консоли '''-_g''' - влияет на некий заголовок, что-то со скриптами С ним:…»

[[Категория:Команды_консоли]]

'''-_g''' - влияет на некий заголовок, что-то со скриптами

С ним:
<code>local function script_name()
return "%s"
end
local this = {}
this._G = _G
%s this %s
setfenv(1, this)</code>

Без него:
<code>local function script_name()
return "%s"
end
local this = {}
%s this %s
setmetatable(this, {__index = _g}
setfenv(1, this)</code>

'''-batch_benchmark''' - запускает бенчмаркинг. Параметр: имя файла с опциями бенчмаркинга (*.ini, *.ltx). Файл ищется в $app_data_root$ 
'''-nojit''' - отключен 
'''-bug''' - устанавливает поле (флаг) 'bug' структуры '_options' второго рендера в истину. Не имеет смысла. Включаемый им участок кода сейчас исполняется по умолчанию 
'''-build''' - устанавливает флаг файловой системы 'flBuildCopy'. Если флаг установлен,
все файлы, прочитанные файловой системой, будут скопированы из $server_root$ ($server_data_root$) в $build_copy$ (Доступен только на Debug, Mixed конфигурациях) 
'''-ebuild''' - устанавливает флаги файловой системы 'flBuildCopy' и 'flEBuildCopy'. (Доступен только на Debug, Mixed конфигурациях) 
'''-gebug_ge''' - ?? 
'''-i''' - отключает захват устройства ввода 
'''-keep_lua''' - запрещает перезапуск LVM 
'''-mem_debug''' - включение отладки менеджера памяти. Необходим для работы с консольной командой 'dbg_mem_check' (доступна, как и 'dbg_mem_dump', если определен макрос DEBUG_MEMORY_MANAGER) 
'''-mt_cdb''' - что-то с обработкой коллизий (обработка колизий в отдельном потоке??), порождает поток "CDB-construction" 
'''-nes_texture_storing''' - что-то делает с текстурами при ??отгрузки уровня?? 
'''-netsim''' - включает симуляцию сети ? 
'''-no_call_stack_assert''' - отключает вывод в лог call stack'a 
'''-no_direct_connect''' - ?? 
'''-nodf24''' - отключает какие-то примбамбасы от видеокарт ATi на втором рендере (DF24/F4) 
'''-nonvs''' - отключает какие-то плюшки для видеокарт NVIDIA 40* и выше на втором рендере (NVStencil) 
'''-pure_alloc''' - что-то связано с пулом 
'''-sjitter''' - как-то влияет на компиляцию шейдеров 
'''-forceskinw''' - как-то влияет на компиляцию шейдеров 
'''-sunfilter''' - как-то влияет на компиляцию шейдеров 
'''-svcfg''' - Выполняет указанный конфигурационный файл на этапе загрузки 'level.game' Параметр: имя выполняемого файла (*.ltx) 
'''-tsh''' - как-то влияет на компиляцию шейдеров (какие-то T тени) 
'''-tdemo''' - Исполняет указанное демо Параметр: имя файла демо (в билдах есть пример использования) 
'''-tdemof''' - тоже самое, только что-то там с кадрами мутится 
'''-techdemo''' - режим записи демо? 
'''-x86''' - отключает использование инструкций SSE, SSE2, 3DNow?? 
'''-xclsx''' - отключает вывод различной отладочной информации на экран в виде красных строк (Доступен только на Debug, Mixed конфигурациях) 
'''-tune''' - запуск профиливщика Intel vTune 
_____
 Статья будет дополнятся... 
'''Author: KIRAY''' [http://vk.com/slava_kiraev] 
Дата публикации: 26.08.2015.

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

2015-08-26T12:37:26Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
Последние изменения (автор): 26.08.2015. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:36:06Z

KIRAY: /* Автор */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
Последние изменения (автор): 26.08.2015. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:35:49Z

KIRAY: /* Автор */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
Последнее изменение (автор): 26.08.2015. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:34:25Z

KIRAY: /* Послесловие */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:32:05Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:29:26Z

KIRAY: /* Сборка */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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''. Возникает на старых версиях DXSDK, используйте версию за июнь 2010: [https://www.microsoft.com/en-us/download/details.aspx?id=6812]
 
'''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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:26:13Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в этой статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:25:37Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' Express Edition)
{{Message_box|
id=kir_msg|
align=left|
backgroundcolor=#f9f9f9|
image=Lamp.gif|
heading=INFO|
message=''Можно попробовать и Express Edition, только придётся решить проблему сборки приложений, которые используют MFC (компиляторы и т.п.). А лучше использовать Community Edition современных версий Visual Studio,''
''они по функционалу схожи с Professional Edition прошлых версий и абсолютно бесплатны. Правда один минус, могут возникнуть новые проблемы, которые не будут затронуты в это статье.''
 Скачать Visual Studio 2015 Community Edition с сайта Microsoft: [https://go.microsoft.com/fwlink/?LinkId=532606&clcid=0x419]
}}
 
{{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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:12:14Z

KIRAY: /* На кого рассчитана данная статья? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на начинающих программистов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio.

== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:11:10Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на нубов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio. Программистам с опытом этот туториал покажется очень смешным и глупым, и я бы советовал им пройти мимо, дабы они здесь ничего нового не найдут.
== Что необходимо для сборки? ==
* Visual Studio 2005 и выше ('''НЕ''' 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:10:56Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке X-Ray проблем. Ну что ж, хватит лирики, приступим-с...

== На кого рассчитана данная статья? ==
Прежде всего она рассчитана на нубов, подобных мне, которые не могут собрать движок, но хотят вносить в него какие-то правки, ну или хотя бы хотят пытаться вносить правки. Ну это вовсе не означает что Вы являетесь "полным нулём", предполагается что читатель хотя бы минимальски знаком с ЯП C++ и имеет хоть какой-то опыт работы в Visual Studio. Программистам с опытом этот туториал покажется очень смешным и глупым, и я бы советовал им пройти мимо, дабы они здесь ничего нового не найдут.
== Что необходимо для сборки? ==
* 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:10:17Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:09:13Z

KIRAY: /* Что необходимо для сборки? */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:07:50Z

KIRAY: /* Предисловие */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, мною могут быть допущены какие-то неточности, ошибки. Всё что будет изложено ниже не может считаться верным решением встречающихся при сборке 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:07:09Z

KIRAY: /* Предисловие */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист, всё что будет изложено ниже не может считаться верным решением встречающихся при сборке 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:04:26Z

KIRAY: /* Предисловие */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется упомянуть о том, что я не программист и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-08-26T12:03:15Z

KIRAY: /* Предисловие */

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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/slava_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2015-04-10T04:06:02Z

KIRAY:

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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)

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

2014-07-31T09:08:25Z

KIRAY: Отмена правки 13583, сделанной участником 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 и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Article is prepared ОМКНМ''' [http://vk.com/omknm] 
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2014-07-24T18:00:35Z

KIRAY:

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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 и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Article is prepared ОМКНМ''' [http://vk.com/omknm] 
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2014-07-11T13:58:16Z

KIRAY:

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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]
 
Скачиваем архив с необходимыми для сборки 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 и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Article is prepared ОМКНМ''' [http://vk.com/omknm] 
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2014-07-11T07:10:48Z

KIRAY:

[[Категория:Руководства]]
== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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]
 
Скачиваем архив с необходимыми для сборки 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''.
[[Файл:Ss_1.jpg|S:\xr_3da\xr_3da.sln|frame|left|xr_3da.sln]]
 
Появится окно мастера преобразования Visual Studio, жмём кнопку 'Готово' и ждём пока все проекты конвертируются в формат VS10 и пройдёт синтаксический анализ проектов.
[[Файл:Ss_2.jpg|Мастер преобразований Visual Studio|frame|left|Мастер преобразований Visual Studio]]
 
После того как всё сконвертировалось, перым делом открываем Диспетчер конфигураций (''ПКМ по решению -> Свойства -> Свойства конфигурации'') и выставляем решению активную конфигурацию ''Mixed'' (на чистом ''Debug'' ужасно падает производительность), а для сторонних библиотек (''BugTrap'', ''OpenAL'', ''minizip'', ''zlib'') ставим ''Release''.
[[Файл:Ss_3.jpg|Конфигурации проектов|frame|left|Конфигурации проектов]]
 
Ну а теперь самое муторное, это настройка собственно проектов. Каждый проект придется настраивать отдельно, собирать так же советую отдельно (''ПКМ по проекту -> Только проект -> Построить только [имя проекта]''). Порядок построения можно узнать так: ''ПКМ по любому проекту -> Зависимости проектов... -> Порядок построения''. Настраиваем выходные каталоги, промежуточные каталоги и выходные каталог для библиотек импорта по своему вкусу, у меня так (на примере ''BugTrap'', используется структура каталогов, упомянутая в начале статьи):
[[Файл:Ss_4.jpg|Свойства BugTrap|frame|left|Свойства BugTrap]][[Файл:Ss_5.jpg|Свойства BugTrap|frame|left|Свойства BugTrap]]
 
Далее необходимо настроить пути к заголовочным файлам и библиотекам импорта внешних библиотек. Ниже пойдёт таблица проектов (в порядке построения) с необходимыми для них библиотеками из директории ''xr_src\SDK'', пути настраиваются здесь:
[[Файл:Ss_6.jpg|Свойства проекта|frame|left|Свойства проекта]][[Файл:Ss_7.jpg|Свойства проекта|frame|left|Свойства проекта]]
 
{|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 и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Article is prepared ОМКНМ''' [http://vk.com/omknm] 
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

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

2014-07-11T07:07:28Z

KIRAY: Новая страница: «== Предисловие == Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до прог…»

== Предисловие ==
Сразу хочется сказать то, что я не программист (обучающийся СОУ) и до программиста мне еще очень-очень далеко, всё что будет изложено ниже не является правильным решением проблемы сборки движка 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]
 
Скачиваем архив с необходимыми для сборки 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''.
[[Файл:Ss_1.jpg|S:\xr_3da\xr_3da.sln|frame|left|xr_3da.sln]]
 
Появится окно мастера преобразования Visual Studio, жмём кнопку 'Готово' и ждём пока все проекты конвертируются в формат VS10 и пройдёт синтаксический анализ проектов.
[[Файл:Ss_2.jpg|Мастер преобразований Visual Studio|frame|left|Мастер преобразований Visual Studio]]
 
После того как всё сконвертировалось, перым делом открываем Диспетчер конфигураций (''ПКМ по решению -> Свойства -> Свойства конфигурации'') и выставляем решению активную конфигурацию ''Mixed'' (на чистом ''Debug'' ужасно падает производительность), а для сторонних библиотек (''BugTrap'', ''OpenAL'', ''minizip'', ''zlib'') ставим ''Release''.
[[Файл:Ss_3.jpg|Конфигурации проектов|frame|left|Конфигурации проектов]]
 
Ну а теперь самое муторное, это настройка собственно проектов. Каждый проект придется настраивать отдельно, собирать так же советую отдельно (''ПКМ по проекту -> Только проект -> Построить только [имя проекта]''). Порядок построения можно узнать так: ''ПКМ по любому проекту -> Зависимости проектов... -> Порядок построения''. Настраиваем выходные каталоги, промежуточные каталоги и выходные каталог для библиотек импорта по своему вкусу, у меня так (на примере ''BugTrap'', используется структура каталогов, упомянутая в начале статьи):
[[Файл:Ss_4.jpg|Свойства BugTrap|frame|left|Свойства BugTrap]][[Файл:Ss_5.jpg|Свойства BugTrap|frame|left|Свойства BugTrap]]
 
Далее необходимо настроить пути к заголовочным файлам и библиотекам импорта внешних библиотек. Ниже пойдёт таблица проектов (в порядке построения) с необходимыми для них библиотеками из директории ''xr_src\SDK'', пути настраиваются здесь:
[[Файл:Ss_6.jpg|Свойства проекта|frame|left|Свойства проекта]][[Файл:Ss_7.jpg|Свойства проекта|frame|left|Свойства проекта]]
 
{|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 и за отсутствие гонений из-за использования исходных кодов движка :-).
== Автор ==
'''Article is prepared ОМКНМ''' [http://vk.com/omknm] 
'''Author: KIRAY''' [http://vk.com/yar_kiraev] 
Дата публикации: 11.07.2014. 
[[Участник:KIRAY|KIRAY]] ([[Обсуждение участника:KIRAY|обсуждение]]) 11:07, 11 июля 2014 (MSK)

Файл:Ss 12.jpg

2014-07-11T06:15:29Z

KIRAY: Правка xrGame.

Правка xrGame.

Файл:Ss 11.jpg

2014-07-11T06:11:04Z

KIRAY: Правка LuaBind.

Правка LuaBind.

Файл:Ss 10.jpg

2014-07-11T06:04:17Z

KIRAY: Структура Bool2Type.

Структура Bool2Type.

Файл:Ss 9.jpg

2014-07-11T06:02:47Z

KIRAY: Кусок кода xrGame.

Кусок кода xrGame.

Файл:Ss 8.jpg

2014-07-11T06:01:14Z

KIRAY: Кусок кода xrGame.

Кусок кода xrGame.

Файл:Ss 7.jpg

2014-07-11T05:13:16Z

KIRAY: Свойства проекта.

Свойства проекта.

Файл:Ss 6.jpg

2014-07-11T05:11:45Z

KIRAY: Свойства проекта.

Свойства проекта.

Файл:Ss 5.jpg

2014-07-11T05:04:56Z

KIRAY: Свойства BugTrap.

Свойства BugTrap.

Файл:Ss 4.jpg

2014-07-11T05:03:15Z

KIRAY: Свойства BugTrap.

Свойства BugTrap.

Файл:Ss 3.jpg

2014-07-11T04:59:27Z

KIRAY: Конфигурации проектов.

Конфигурации проектов.

Файл:Ss 2.jpg

2014-07-11T04:54:18Z

KIRAY: Мастер преобразований Visual Studio.

Мастер преобразований Visual Studio.

Файл:Ss 1.jpg

2014-07-11T04:51:03Z

KIRAY: S:\xr_3da\xr_3da.sln

S:\xr_3da\xr_3da.sln

Файл:Ss 0.jpg

2014-07-11T04:38:02Z

KIRAY: Виртуальные диски.

Виртуальные диски.