Daniil
offline
Опыт:
164Активность: |
Документация по нативным функциям
Уже очень давно ищу какую-нибудь документацию по нативным функциям. Пусть не по всем, но хотя бы по хорошо известным.
Хотя чем дольше ищу, тем больше убеждаюсь, что куда больше шансов найти Грааль. На всех форумах, что я излазил, есть только туториалы по какой-нибудь конкретной проблеме (как сделать спелл, как сделать TD и прочее). На http://jass.sourceforge.net есть API Browser. Но коментариев там очень мало, а какая функция что takes, а что returns можно и самому посмотреть. А у меня в мечтах такая картинка: ввожу название функции, а мне помимо её прототипа выводиться: 1. Делает конкретно то-то и то-то. 2. Побочные действия - такие-то (если есть). 3. Создаёт левые объекты такие-то (если есть угроза утечки). 4. Может привести к крешу при таких-то условиях (если была замечена такая проблема). Я, конечно, понимаю, что Jass - это не Java. Но привычка всегда иметь под рукой API Reference осталась :) Ведь очень много людей прекрасно разбираются во многих нативных функциях. Огромные толпы первопроходцем, второпроходцев и прочих уже многое попробывали и обнаружили множество граблей. Хочется идти проторенной дорожкой, а не наступать на те же самые грабли. P.S. Фразы типа "а попробуй Google" сопровождайте строкой поиска, которая сразу приведёт меня к вожделенной цели. Отредактировано Daniil, 18.09.2006 в 18:13. |
18.09.2006, 17:58 | #1
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
J
expert
offline
Опыт:
48,447Активность: |
хех.. а я тоже начинал это делать.. но описав 1/2 функций - забрасил.. так как небыло времени и вообще лень.. их же так много... |
18.09.2006, 18:08 | #2
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Daniil
offline
Опыт:
164Активность: |
Ну а хотя бы то, что уже есть описанное можно как-нить получить? |
18.09.2006, 18:14 | #3
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
J
expert
offline
Опыт:
48,447Активность: |
Daniil на меня чето опять взошло вдохновение.. пойду дальше описывать.. поже выложу
|
18.09.2006, 18:50 | #4
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
exploder
iOS zealot
offline
Опыт:
19,394Активность: |
Daniil, такой документации просто нет. Существуют статьи для описание конкретных проблем, в которых описаны используемые функции. Поведение функции скорее проверяется опытным путем, либа судя из имени функции. Имхо близзы дали функциям имена, которые говорят сами за себя...
|
18.09.2006, 18:56 | #5
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Daniil
offline
Опыт:
164Активность: |
Ну вот пример.
SetUnitPositionLocFacingLocBJ Где в названии сказано, что будет отменён текущий приказ? (это про побочные действия) Или PolarProjectionBJ. Опять же из названия и не поймёшь, что возможна утечка. Хотя тут уже можно понять по прототипу. Но вот с GetUnitLoc уже не понятно. Толи новую точку создаёт, толи уже есть привязанные к каждому юниту координаты и он даёт ссылку на них. И вот такие вопросы возникают постоянно, и чтобы не теребить народ каждый раз, проще глянуть в доку. Тем более, что с пободнымм вопросами каждый хотя бы раз сталкивался. Отредактировано Daniil, 18.09.2006 в 19:52. |
18.09.2006, 19:47 | #6
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
exploder
iOS zealot
offline
Опыт:
19,394Активность: |
Daniil, ну по моему это очевидно. Ты видел когда-нибудь юнита, который атакует, стоя спиной к врагу?
exploder добавил: Цитата:
Тогда что произайдет при попытке удалить объект по этой ссылке? Юнит потеряет координаты? Конечно она дублирует позицию... |
|
18.09.2006, 19:55 | #7
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Daniil
offline
Опыт:
164Активность: |
Цитата:
Ну, например, функции RemoveLocation потерпит неудачу. Либо молча, либо с критической ошибкой. Вывод: без тестирования реального поведения не обойтись. Но ведь кто-то уже это тестирование сделал до нас? |
|
18.09.2006, 20:05 | #8
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
J
expert
offline
Опыт:
48,447Активность: |
Цитата:
ненаблюдал не то ни другое... обычно в этих случаях наблюдаются только тормоза... |
|
19.09.2006, 13:13 | #9
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Daniil
offline
Опыт:
164Активность: |
Я понимаю, что создание подобной документации в одиночку - достаточно долгое занятие.
Поэтому можно сделать что-нибудь вроде JASS Wiki. Внести туда список функций, и пусть уже люди сами деляться информацией, дополняют информацию по разным функциям: что конкретно делает, какие есть альтернативы и чем они лучше, какие есть связанные функции и т.д. Удивительно, что этого ещё никто не сделал - уверен, что за 4 года база знаний была бы почти на 100% заполнена. |
20.09.2006, 15:00 | #10
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Daniil
offline
Опыт:
164Активность: |
Всё-таки одни ребята начинали как раз то, о чём я говорил.
Посмотреть можно вот тут: http://82.170.159.98/?p=jass Но прокоментировать успели только дюжину функций (или энтузиазма на столько хватило). |
21.09.2006, 19:10 | #11
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
zibada
offline
Опыт: отключен
|
тут немного есть:
http://wc3jass.com/ конкретнее, здесь: http://wc3jass.com/finder.php? поиск описания по названию функции. (список функций common.j тут) хотя не без ошибок... например, тут написано, что траккаблы не работают в мультиплеере, что неправда =) |
21.09.2006, 20:29 | #12
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|
Toadcop
offline
Опыт:
54,313Активность: |
Цитата:
|
|
28.09.2006, 14:16 | #13
+0/−0
Профиль |
Приват |
Поиск |
Цитата |
IP: Записан
|