HLFX.Ru Forum - J.A.C.K.: документация

Страницы (3): [1] 2 3 »
Показать все 31 сообщений этой темы на одной странице

HLFX.Ru Forum (https://hlfx.ru/forum/index.php)
- Jackhammer (https://hlfx.ru/forum/forumdisplay.php?forumid=35)
-- J.A.C.K.: документация (https://hlfx.ru/forum/showthread.php?threadid=4874)

Отправлено XaeroX 19-10-2016 в 06:10:

J.A.C.K.: документация

Я подготовил документацию для Джека и хочу услышать ваше мнение о ней.
Какие важные темы, на ваш взгляд, следовало бы осветить? Какие важные моменты пропущены? Может ли новичок, только что скачавший джек, по этой документации хотя бы немного освоиться в нём, прежде чем начнёт гуглить туториалы по маппингу под конкретные игры?

Посмотреть можно здесь:
http://jack.hlfx.ru/pub/VDKManual.pdf

Написана частично по материалам хаммеровского хелп-файла, частично из головы. Все иллюстрации сделаны на основе последней версии Джека.

Серьёзный минус - документация только на английском языке. К сожалению, пока не нахожу в себе силы сделать перевод на русский язык. Если какой-то альтруист захочет с этим помочь - буду рад, но вероятность этого, как я понимаю, 0.00001%.

Если вам эта документация покажется удобной - можете выкачивать pdf-ку и положить её в папку с джеком, тогда она будет открываться при нажатии F1, как изначально было задумано.

__________________

Отправлено PunkPaToB 19-10-2016 в 07:46:

XaeroX
Если это документация пойдет в стим, разве можно будет в примерах документации светить текстуры из HL ? Может перестраховаться и квейковские взять?

__________________
А что нет?

Отправлено tolerance 19-10-2016 в 08:05:

Цитата:

PunkPaToB писал:
разве можно будет в примерах документации светить текстуры из HL ?

Здравый смысл подсказывает мне, что конечно можно, на то это и *примеры*.

Отправлено nemyax 19-10-2016 в 09:15:

Re: J.A.C.K.: документация

Цитата:

XaeroX писал:
Может ли новичок, только что скачавший джек, по этой документации хотя бы немного освоиться в нём, прежде чем начнёт гуглить туториалы по маппингу под конкретные игры?

Вроде да. Хотя, конечно, не хватает раздела про best practices (а то в туториалах насоветуют, да). Но если ты преподносишь документ именно как reference guide, то оно и понятно.

Цитата:

разве можно будет в примерах документации светить текстуры из HL

Что-то вы вообще не о том =) Какая разница-то.

Отправлено thambs 19-10-2016 в 09:22:

Узнал 2 новые вещи.

Добавлено 19-10-2016 в 12:22:

>Хотя, конечно, не хватает раздела про best practices
Для этого уже нужны карты примеры. Брашворк -- такая штука, что её проще показать чем рассказать.

__________________
http://www.moddb.com/mods/monorail-quest

Отправлено XaeroX 19-10-2016 в 09:22:

Цитата:

PunkPaToB писал:
разве можно будет в примерах документации светить текстуры из HL

Ты ещё спроси - можно ли в стиме выкладывать скриншоты из HL.

И вообще упоминать, что джек с халфой работает.

По копирайтам требование оч.простое - не выкладывать ассеты из халфы. То есть сами текстуры в чистом виде. А тут всего-навсего картинки, к тому же местами отмасштабированные по самое пикачу.

Цитата:

nemyax писал:
не хватает раздела про best practices

А как это могло бы выглядеть, применительно к редактору? Мини-туториалы?

Цитата:

thambs писал:
Узнал 2 новые вещи.

Какие?

__________________

Отправлено thambs 19-10-2016 в 09:24:

XaeroX
То что камеру можно в точные координаты ставить и то что можно сет вертексов скукоживать в точку или скейлить (вообще как то не замечал наличия контекстного меню в вертексмоде).

__________________
http://www.moddb.com/mods/monorail-quest

Отправлено XaeroX 19-10-2016 в 09:26:

Цитата:

thambs писал:
то что можно сет вертексов скукоживать в точку

Гм, ну я это даже на видео показывал:
http://hlfx.ru/forum/showthread.php...9449#post149449

__________________

Отправлено nemyax 19-10-2016 в 11:03:

Цитата:

XaeroX писал:
А как это могло бы выглядеть, применительно к редактору? Мини-туториалы?

Что-то вроде. Не пошаговые процедуры, а общая рекомендация-заголовок и текст, где приводится её обоснование и описывается, какими инструментами редактора она достигается.
Адекватного примера для гжэка привести не могу, сорри =(

Отправлено ComradeAndrew 19-10-2016 в 12:52:

Круто!
Отличное описание. Довольно живо описано, с некой аккуратностью и трепетностью автора. Не знаю как передать точно эту манеру, но такого описания не хватает многим документациям. Про него можно сказать user-friendly, наверное. Описание фич в основном на простом техническом английском.
Осилил пока далеко не всё прочитать. Не знаю когда получиться осилить полностью.

Узнал для себя про фичу cordon state.
Большую часть из того что прочитал я уже знаю либо от самого Ксерокса, либо по опыту тестирования.

Пока вроде всё, что могу сказать. Ну и спасибо за документацию

Отправлено XaeroX 19-10-2016 в 12:56:

Цитата:

ComradeAndrew писал:
Довольно живо описано

Это, вероятно, фрагменты, взятые из хаммеровского хелпа. Его действительно приятно читать, сразу видно - писал носитель языка, при этом хорошо знающий описываемый софт.

Цитата:

ComradeAndrew писал:
Описание фич в основном на простом техническом английском.

А это - уже, вероятно, про мой английский.

Да, до уровня свободного владения мне ещё далеко.

Цитата:

ComradeAndrew писал:
Ну и спасибо за документацию

Пожалуйста. Рад, что кому-то она оказалась полезной.

__________________

Отправлено ComradeAndrew 19-10-2016 в 13:36:

Говоря про живость, я имею ввиду такую манеру описания, когда как бы происходит общение с юзером, а не просто голое описание.
То есть читающий чувствует, что это для него написано и внимательность сразу повышается и понимание соответственно тоже.
Может так понятнее

Отправлено Дядя Миша 19-10-2016 в 14:10:

ComradeAndrew давным давно какой-то мудак решил, что любая документация должна максимально абстрагироваться от живого общения с пользователем, в результате чего подобные документации стало невозможно читать. Соответственно их никто и не читал. Ну разве что инструкцию к атомной электростанции.

__________________
My Projects: download page

F.A.Q по XashNT
Блог разработчика в телеграме

Цитата:

C:\DOCUME~1\C4C5~1\LOCALS~1\Temp\a33328if(72) : see declaration of 'size_t'

Отправлено nemyax 19-10-2016 в 14:41:

Цитата:

Дядя Миша писал:
давным давно какой-то мудак решил

Это не волевое решение могущественного мудака, а обычный человеческий порок. По умолчанию человек, во всяком случае нашенский, срывается в упоротый канцеляризм при малейшей возможности. Созданию документации ведь тоже надобно учиться, как и любой осмысленной деятельности.

Отправлено FreeSlave 19-10-2016 в 15:50:

Вроде неплохо. Хотя я пока просто пролистал по большей части. Хотел заценить доки по ку3 шейдерам, а они ещё не написаны

Ты переименовал chain studios в crystice softworks?

__________________
I'm on github
I'm on opendesktop.org

Временная зона GMT. Текущее время 18:12.

Страницы (3): [1] 2 3 »
Показать все 31 сообщений этой темы на одной странице

На основе vBulletin версии 2.3.0
Авторское право © Jelsoft Enterprises Limited 2000 - 2002.
Дизайн и программирование: Crystice Softworks © 2005 - 2024