HLFX.Ru Forum
профиль •  правила •  регистрация •  календарь •  народ •  FAQ •  поиск •  новое •  сутки •  главная •  выход  
HLFX.Ru Forum HLFX.Ru Forum > Разработка игр > Наши проекты > Jackhammer > J.A.C.K.: документация
VDKManual.pdf
Что вы думаете о документации?
(публичный опрос)
Вам не разрешено голосовать в этом опросе.
Хорошая документация
***FantoM*** chakki.skrip ComradeAndrew DEAD MAN FiEctro PunkPaToB thambs totopizza XF-Alien
9 81.82%
Плохая документация (поясню, почему)
0 0%
Не могу оценить, т.к. слабо понимаю английский
(_-=ZhekA=-_)
1 9.09%
Не могу оценить, т.к. лениво/некогда/неинтересно смотреть
XaeroX
1 9.09%
Всего: 11 голосов 100%
  [Редактировать опрос (только для модераторов)]

Страницы (3): [1] 2 3 »   Предыдущая тема   Следующая тема
Автор
Тема Новая тема    Ответить
 XaeroX
Crystice Softworks

Дата регистрации: Oct 2005
Проживает: Торонто
Сообщений: 34498
Нанёс повреждений: 514 ед.
Возраст: 37

Рейтинг



Награды
 
[1 награда]


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

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

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

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

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

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

__________________
Правдой дорожить, лжи не потакать,
Дальних не судить, ближним помогать,
С тишиной сойтись на исходе дня
Научи меня, Родина моя!

Сообщить модератору | | IP: Записан
Сообщение: 160078

Старое сообщение 19-10-2016 06:10
-
PunkPaToB
Теперь я с провами!!!

Дата регистрации: Dec 2010
Проживает: (void)
Сообщений: 792
Возраст: 29

Рейтинг



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

__________________
А что нет?

Сообщить модератору | | IP: Записан
Сообщение: 160080

Старое сообщение 19-10-2016 07:46
- За что?
tolerance
Житель форума
Девойс

Дата регистрации: Feb 2013
Проживает: (void)
Сообщений: 739
Возраст: 32

Рейтинг



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

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

Сообщить модератору | | IP: Записан
Сообщение: 160081

Старое сообщение 19-10-2016 08:05
- За что?
nemyax
Нёмыч

Дата регистрации: Jul 2011
Проживает: (void)
Сообщений: 4133

Рейтинг



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

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

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

Цитата:

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

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

Сообщить модератору | | IP: Записан
Сообщение: 160083

Старое сообщение 19-10-2016 09:15
- За что?
thambs
мразь конченная

Дата регистрации: Mar 2006
Проживает: -
Сообщений: 6417

Рейтинг



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

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

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

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

Сообщить модератору | | IP: Записан
Сообщение: 160084

Старое сообщение 19-10-2016 09:22
- За что?
 XaeroX
Crystice Softworks

Дата регистрации: Oct 2005
Проживает: Торонто
Сообщений: 34498
Нанёс повреждений: 514 ед.
Возраст: 37

Рейтинг



Награды
 
[1 награда]


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

Ты ещё спроси - можно ли в стиме выкладывать скриншоты из HL. И вообще упоминать, что джек с халфой работает.
По копирайтам требование оч.простое - не выкладывать ассеты из халфы. То есть сами текстуры в чистом виде. А тут всего-навсего картинки, к тому же местами отмасштабированные по самое пикачу.
Цитата:
nemyax писал:
не хватает раздела про best practices

А как это могло бы выглядеть, применительно к редактору? Мини-туториалы?
Цитата:
thambs писал:
Узнал 2 новые вещи.

Какие?

__________________
Правдой дорожить, лжи не потакать,
Дальних не судить, ближним помогать,
С тишиной сойтись на исходе дня
Научи меня, Родина моя!

Сообщить модератору | | IP: Записан
Сообщение: 160085

Старое сообщение 19-10-2016 09:22
-
thambs
мразь конченная

Дата регистрации: Mar 2006
Проживает: -
Сообщений: 6417

Рейтинг



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

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

Сообщить модератору | | IP: Записан
Сообщение: 160086

Старое сообщение 19-10-2016 09:24
- За что?
 XaeroX
Crystice Softworks

Дата регистрации: Oct 2005
Проживает: Торонто
Сообщений: 34498
Нанёс повреждений: 514 ед.
Возраст: 37

Рейтинг



Награды
 
[1 награда]


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

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

__________________
Правдой дорожить, лжи не потакать,
Дальних не судить, ближним помогать,
С тишиной сойтись на исходе дня
Научи меня, Родина моя!

Сообщить модератору | | IP: Записан
Сообщение: 160087

Старое сообщение 19-10-2016 09:26
-
nemyax
Нёмыч

Дата регистрации: Jul 2011
Проживает: (void)
Сообщений: 4133

Рейтинг



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

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

Сообщить модератору | | IP: Записан
Сообщение: 160088

Старое сообщение 19-10-2016 11:03
- За что?
ComradeAndrew
Житель форума

Дата регистрации: Aug 2014
Проживает: Дубай
Сообщений: 510
Возраст: 27

Рейтинг



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

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

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

Сообщить модератору | | IP: Записан
Сообщение: 160091

Старое сообщение 19-10-2016 12:52
- За что?
 XaeroX
Crystice Softworks

Дата регистрации: Oct 2005
Проживает: Торонто
Сообщений: 34498
Нанёс повреждений: 514 ед.
Возраст: 37

Рейтинг



Награды
 
[1 награда]


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

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

А это - уже, вероятно, про мой английский.
Да, до уровня свободного владения мне ещё далеко.
Цитата:
ComradeAndrew писал:
Ну и спасибо за документацию

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

__________________
Правдой дорожить, лжи не потакать,
Дальних не судить, ближним помогать,
С тишиной сойтись на исходе дня
Научи меня, Родина моя!

Сообщить модератору | | IP: Записан
Сообщение: 160092

Старое сообщение 19-10-2016 12:56
-
ComradeAndrew
Житель форума

Дата регистрации: Aug 2014
Проживает: Дубай
Сообщений: 510
Возраст: 27

Рейтинг



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

Сообщить модератору | | IP: Записан
Сообщение: 160095

Старое сообщение 19-10-2016 13:36
- За что?
 Дядя Миша
racing for fish

Дата регистрации: Oct 2005
Проживает: Кубань
Сообщений: 32188
Нанёс повреждений: 392 ед.

Рейтинг



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

__________________
My Projects: download page

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

Цитата:

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

Сообщить модератору | | IP: Записан
Сообщение: 160097

Старое сообщение 19-10-2016 14:10
-
nemyax
Нёмыч

Дата регистрации: Jul 2011
Проживает: (void)
Сообщений: 4133

Рейтинг



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

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

Сообщить модератору | | IP: Записан
Сообщение: 160098

Старое сообщение 19-10-2016 14:41
- За что?
FreeSlave
Житель форума

Дата регистрации: Nov 2007
Проживает: Тула
Сообщений: 1077

Рейтинг



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

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

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

Сообщить модератору | | IP: Записан
Сообщение: 160099

Старое сообщение 19-10-2016 15:50
- За что?
Тема: (Опционально)
Ваш ответ:



Переводчик транслита


[проверить длину сообщения]
Опции: Автоматическое формирование ссылок: автоматически добавлять [url] и [/url] вокруг интернет адресов.
Уведомление по E-Mail: отправить вам уведомление, если кто-то ответил в тему (только для зарегистрированных пользователей).
Отключить смайлики в сообщении: не преобразовывать текстовые смайлики в картинки.
Показать подпись: добавить вашу подпись в конец сообщения (только зарегистрированные пользователи могут иметь подписи).

Временная зона GMT. Текущее время 17:51. Новая тема    Ответить
Страницы (3): [1] 2 3 »   Предыдущая тема   Следующая тема
HLFX.Ru Forum HLFX.Ru Forum > Разработка игр > Наши проекты > Jackhammer > J.A.C.K.: документация
VDKManual.pdf
Версия для печати | Отправить тему по E-Mail | Подписаться на эту тему

Быстрый переход:
Оцените эту тему:

Правила Форума:
Вы not можете создавать новые темы
Вы not можете отвечать в темы
Вы not можете прикреплять вложения
Вы not можете редактировать ваши сообщения
HTML Код ВЫКЛ
vB Код ВКЛ
Смайлики ВКЛ
[IMG] Код ВКЛ
 

< Обратная связь - HLFX.ru >

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