Этот документ описывает пример установки raytools .Так как процедура установки может быть немного сложна, для пользователей с небольшим опытом использования "command shelf", то я нахожу наиболее практичной идею описания практического примера установки, вместо общих указаний.
Кроме этого, даны общие указания о самом процессе.
(Прочитайте описание и следуйте инструкции ВНИМАТЕЛЬНО! НЕВНИМАТЕЛЬНАЯ пробежка по этому документу принесет Вам одни неприятности и головную боль).

ТРЕБОВАНИЯ:

Прежде чем устанавливать raytools, Вы должны иметь:

- Установленную MAYA 4.0 ( поддержка версии 4.0 и выше)
- MR 2.1 установленный в любой форме.

РЕКОМЕНДОВАННОЕ ЧТЕНИЕ:

- Maya Manuals: Essentials/Setting Environment Variables
- mental ray manual: Functionality
- mental ray manual: Usage and Command Line Options/Startup File
Чем больше опыта вы имеете с MAYA ,тем лучше (то же относится к MR)

ЧАСТИ УСТАНОВОЧНОГО ПРОЦЕССА:

Эта часть описывает процесс самой установки. Для того,чтобы приступить непосредственно к установке,- пропустите эту часть.

Процедура установки состоит из последующих частей:

1. Установка и конфигурация модуля plug-in MAYA

- Разархивировать и поместить raytools в выбранную папку;
- В папке конфигурации MAYA должны быть проделаны следующие дополнения/модификации;
- Необходимо создать новое определение plug-in модуля для raytools
- raytools preferences должны быть помещены в папку prefs/
-raytools shelf должны быть помещены в папку prefs/shelves/
- файл "MAYA Env." должен быть создан/отредактирован для добавления необходимых переменных environment
-"UserSetup.mel" file должен быть создан/отредактирован, чтобы он содержал вызов raytools
- путь к папке "raytools /bin" должен быть включен в системную переменную "Path"

2.Конфигурация MR

- файл "rayrc" должен указывать путь к raytools шейдерам
- файл "rayrc_maya" должен быть отредактирован, чтобы он содержал правильные установочные пути.
- путь к папке, содержащей ray 2.exe ( ray.exe) и__Imf_disp.exe_должен быть включен в системную переменную"Path"

3. КОНФИГУРАЦИЯ ПЕРЕМЕННЫХ ENVIRONMENT.

Пример установки не описывает это, так как включенный файл "MAYA env" уже содержит все переменные ENVIRONMENT.

Cледующие ENVIRONMENT переменные должны быть созданы:

-_MAMI_HOME должен указывать на директорию в которой установлен raytools
- ray 2.exe( ray.exe) и Imf_disp.exe должны быть включены в "Path"
- % MAMI_HOME должен быть включен в "Path"
- MI-ROOT должен указывать на папку, содержащую "rayrc" файл.

ВАЖНАЯ ЗАМЕТКА о ENVIRONMENT переменных.

На некоторых машинах файл "MAYA Env." не будет работать корректно.
Если вы закончили установку, но raytools не работает, то Вам необходимо создать все ENVIRONMENT переменные вручную.
откройте "MAYA.env " файл и создайте ENVIRONMENT переменные, которые в нем есть, вручную.

Ниже Вы найдете пример установки.

ПРИМЕР УСТАНОВКИ:

Для начала MR и Maya должны быть установлены на Вашем компьютере.
В данном примере сделаны следующие предположения:
- MR установлен как часть SoftImage |XSI_1.5 в папку " C:/SoftImage/ XSI_1.5 "
- Вы устанавливаете raytools в "C:/ raytools ".
(Примечание по редактированию конфигурационных файлов MAYA: Если имеются уже существующие файлы"MAYA.env " и" userSetup.mel" в конфигурационной папке MAYA, не заменяйте их файлами из дистрибутива raytools.
Вместо этого,добавьте содержание соответствующих файлов из дистрибутива raytools в конец уже существующих файлов)

СЛЕДУЙТЕ ИНСТРУКЦИЯМ ВНИМАТЕЛЬНО.

1.Установка и конфигурация модуля plug-in raytools.

После разархивирования,скопируйте файлы в " C:/ " ( таким образом у Вас получится папка " C: / raytools " )

Теперь Вам необходимо найти конфигурационную папку MAYA .
Обычно эта папка находится в :
"C:/WINNT/Profiles/<username>/maya/4.0" для Win NT
"C:/Documents and Settings/<username>/My Documents/maya/4.0" для Win2K
В дальнейшем это будет называться " config folder"
Уже существующие в папке raytools " misc / config / MAYA / 4.0 " файлы сделают установку проще.
В данном случае это папка " С: / raytools / misc / config / MAYA / 4.0".
Это будет называться " preset folder ".
Далее необходимо осуществить следующие модицикации в Вашем
" config folder "
скопируйте " modules" из " preset folder " в "config folder ".
(Примечание переводчика: если " modules" уже существует (к примеру, если Вы имеете установленный DNT модуль), то тогда скопируйте содержимое папки " modules " дистрибутива raytools в уже существующую папку " modules " ).
Скопируйте содержимое папки " prefs" в папку "prefs " вашего"config folder ".
Если такой папки нет в "config folder " скопируйте ее целиком, вместе с содержимым.

Скопируйте" user Setup.mel " из "preset folder "scripts " в "config folder " "scripts ".
Если такой файл уже существует-добавьте содержимое нового файла в конец старого.
Скопируйте "MAYA.env " в "config folder ".
Eсли "MAYA.env " уже существует- добавьте содержимое нового файла в конец старого.
Это все для установки модуля plug-in .

См.ниже какие файлы необходимо изменить, если Вы хотите изменить конфигурацию.

2. КОНФИГУРАЦИЯ MR .

Вам необходимо найти файл " rayrc ".
В данном примере,файл находится в "C:/Softimage/XSI_1.5/Application/rsrc"
Откройте файл в текстовом редакторе и добавьте в конец $include C:/raytools/mi/rayrc_maya"
Это все.

Теперь вы сможете запустить MAYA, чтобы посмотреть все ли работает правильно.
После запуска у Вас должен появиться ярлык " raytools " (shelf) и 4 дополнительных меню ("Toolkit", "Access", "Graph", "Render") в " Rendering ".

После того ,как установка завершенна и MAYA запущена, откройте Translator Globals и проверьте все пути,в особенности установки Executables и Temporary .
Создайте полигональный примитив и источник света и выберите
"RENDER" > Frame Preview"
На экране должнo появиться консольное окно, показывающее MR messages и rendering progress и окно imf_disp, показывающее рендерящуюся картинку.
У Вас могут появиться проблемы с imf_disp (см.примечание), но отрендеренная картинка всегда помещается в Maya Render View, так,что вы можете посмотреть ее там.
Если у вас проблемы - скорее всего они появились из-за Environment установок.
См."Конфигурация переменных Environment" (особенно примечания)

Если все работает ,как положено,то приступайте к чтению " manuals".

ИЗМЕНЕНИЕ УСТАНОВКИ

Список файлов имеющий отношение к конфигурации raytools.
- < raytools > - установочная папка
- <Maya_app_dir> Maya "config Folder ".
- <mi_root> -папка, где находится " rayrs"файл .
- <Maya_app_dir>/Maya env. - переменные ENVIRONMENT
- <Maya_app_dir >/ modules / raytools путь к plug-in .
- <Maya_app_dir>/prefs/.mr prefs.09_raytools preferences
- <raytools >/ mi / rayrc_maya raytools shaders
- <raytools >/mi /rayrs_ presets/ presets rayrs_Maya
- <mi_root>/rayrs MR startup файл
Папка "<raytools >/mi /rayrs_ presets>" содержит установочные файлы для " SoftImage/XSI и SI / 3D 3.9"
Чтобы использовать любой из них переименуйте этот файл в " rayrs_maya " и замените "rayrs_maya " из дистрибутива.
Возможно Вам придется измениить установки Translator Globals в Maya .

ЗАМЕТКИ :

Ограничения тестовой версии:
-ограниченный размер геометрии (число CV/вершин)
-нет экспорта сабдивов
-нет поддержки UV координат для геометрии(текстуры могут быть наложены используя проекцию)

Приложенная документация далека от завершенности. Несмотря на это,она все таки является очень ценным источнитком информации и рекомендуется к прочтению, в любом случае.

НЕСКОЛЬКО ПОЛЕЗНЫХ СОВЕТОВ - ПОДСКАЗОК:

Использование raytools само по себе (в отличие от создания и присвоения shaders )очень просто.

Properties (свойства):
Вы можете редактировать свойства обьектов,источников света и камер,чтобы использовать явное " explicit " управление MR.
Чтобы сделать это-используйте " Prepare" меню(самое простое "Auto-Prepare Selected " ).
К примеру,чтобы скорректировать тесселяцию NURBS сферы,выберите обьект и "Prepare Selected " -->Objects (shapes)",
"Prepare Transform --> As Geometry"или "Auto-Prepare --> Selected Object(s)"
Это добавит свойства MR.
После этого выберите обьект и " Access -->Geometry
-->Tesselation:Surhace ",чтобы отредактировать параметры тесселяции.

ПРИСВОЕНИЕ MR shader.

Чтобы присвоить обьекту MR shader необходимо:
1.Присвоить обьекту новую shading group.
2.Выбрать обьект и " Toolkit -->Shaders --->Greate nev Shader "
3.Выбрать Shader , к примеру X Base/rt Material.
Если обьект выделен во время создания shader-а , raytools
попытается присвоить этот shader данному обьекту.
Raytools спрашивает,как присвоить shader.
Выберите " Material shader "
После чего raytools присвоит rt Material shader shading group обьекта.

СОЗДАНИЕ Shader Networks_

Для этого Вы можете использовать Hypergraph .
Однако, MR налагает определенные ограничения:
- каждый Shader может иметь только один " output " параметр (атрибут " mr_out<Data type>" Shader Networks могут быть построены присоединением этого "output" к любому другому параметру другого shader (тип данных должен совпадать)
-Вы можете соединить любые параметры shader вместе, это приведет к тому, что эти параметры будут иметь одинаковое значение. Вы можете анимировать любой параметр.
Единственное исключение - нельзя анимировать выходные параметры shader-ов
Т.е. Вы не можете создать'expression shaders' или использовать driven keying с данными, которые передаются shader-ами в момент рендеринга.
- Соединять можно только параметры одинакового типа(color to color, scalar to scalar).
Для соединения color к scalar, например, необходимо использовать"convertion nodes".

SHADER-ы

"Create Shader " содержит 3 части:"XBase", "Mental_Images".
базовые библиотеки shader-ов.
"sibase" библиотека shader-ов доступна только, если MR установлен как часть SoftImage|XSI_1.5

ИСПОЛЬЗОВАНИЕ imf_disp

В XSI имеется более новая версия imf_disp.
Этот image viewer используется для отображения процесса рендеринга. Эта более новая версия ведет себя немного по- другому, чем старая и не работает (хорошо) с raytools.
Поэтому предпочтительно использовать imf_disp, который идет с SI3D.
Это влияет только на отображение процесса рендеринга,готовое избражение всегда помещается в Maya Render View.

ЦВЕТОВАЯ СХЕМА:

Прилагается с raytools.
Чтобы установить - "<raytools>/misc/desktop_colors/raytools_desktop_colors.reg".
Это добавит"raytools" Desktop Appearance Scheme.
Переименуйте три файла в "<raytools>/misc/config/maya/4.0/prefs/", начинающихся с raytools_.
Удалите "raytools_" часть и оставьте paletteColors.mel, userColors.mel userRGBColors.mel.
Скопируйте их в "config folder". Не забудьте, что это надо делать с незапущенной Maya. Рестарт Maya и у Вас будет raytools color scheme.

перевод D'n'D