Fonctions utiles et constantes pour les développeurs de mods sur CLEO






















-
-
depositfiles.comTélécharger
Outils de développement sur CLEO
Ce pack simplifie un peu le développement de mods sur CLEO - avec des fonctions et des constantes.
Fonctions :
Il y a 6 fonctions dans le pack :
* Spawn d'acteur
* Spawn d'acteur abrégé
* Spawn de voiture
* Spawn de voiture abrégé
* Spawn de camion
* Spawn de train
Vous connectez la fonction via la directive {$I} au début du fichier, et indiquez directement le chemin de la fonction, par exemple : {$I actor_spawn.func}. La directive doit être au tout début du fichier (là où l'on écrit habituellement {$CLEO}).
Ensuite, il ne vous reste plus qu'à écrire une seule ligne (appel de fonction).
Opcode d'appel de fonction :
0AB1:
{$CLEO}
{$I car_spawn.func}
0AB1: call_scm_func @car_spawn num_params 17 model #FIRETRUK -2144.25 922.4758 79.8516 angle 269.7736 color_1 26 color_2 1 door_status 1 very_heavy 0 BP 0 FP 0 EP 0 MP 0 CP 0 radio 11 siren 1 engine 0 return_a_handle 0@
Marker.CreateAboveCar(1@, 0@)
0A93: end_custom_thread
Constantes :
Dans mon pack, vous trouverez également un fichier const, qui contient une grande liste de diverses constantes pouvant aider au développement. J'ai regroupé toutes les constantes par catégories :
* Constantes pour désigner les boutons (opcode 0AB0:). Notez que Sanny Builder ne prend pas en charge les noms de constantes en russe, seuls les noms en anglais sont utilisés. Les noms de touches composés de plusieurs mots sont écrits avec des underscores (sinon le compilateur commence à se mélanger), par exemple : PAGE_DOWN. Dans le fichier des constantes, les noms synonymes des touches sont listés les uns à la suite des autres. Exemple : dans le fichier, il y a des constantes pour la touche échapper - ESC et ESCAPE. Utilisez celui que vous préférez. En raison des limitations du compilateur, les touches avec des chiffres sont écrites comme suit : 0_KEY, 5_KEY. Pour le num-pad, c'est comme ça : 0_NUM, 7_NUM. Les fenêtres droite et gauche, respectivement, comme ça : WINDOWS_L, WINDOWS_R. Si vous avez quelques connaissances en anglais, il n'est pas difficile de deviner que pour la virgule et le point, on utilise les constantes COMMA et DOT (le synonyme POINT est également accepté).
* Variables globales autorisées dans CLEO.
* Stations de radio.
* Composants de voiture (portes, capot, coffre).
* Couleurs de base des voitures.
* Styles de marche des acteurs.
* Types d'explosions. Beaucoup se chevauchent, les constantes les plus essentielles sont notées sans répétitions.
* Icônes de radar.
* Codes météo.
* Gang.
* Numéros d'armes.
* Types de trains.
* Types de camions.
Il y a aussi trois constantes supplémentaires - trois zéros (ZEROES), transition douce et brutale pour la caméra de jeu (JUMP_INSTANT, JUMP_SMOOTH).
Le fichier de constantes est connecté via la directive {$I}.
La plupart de ces constantes sont très utiles et vous évitent de fouiller dans l'aide de Sanny Builder, cependant, si vous souhaitez les utiliser dans vos mods, je vous conseille de parcourir leur liste en ouvrant le fichier.
Vous pouvez utiliser ces fonctions et constantes dans vos mods, il n'est pas nécessaire de mentionner l'auteur du fichier et le site.
REMARQUE: après la compilation du script, il n'est pas nécessaire de les joindre avec le script - la directive {$I} fonctionne sur le principe de l'inclusion du code de fonction à l'intérieur du fichier, c'est-à-dire que la fonction sera à l'intérieur de votre script. Cela s'applique également aux constantes. (remplacé par la ligne {$I}).
REMARQUE: vous pouvez également utiliser la forme complète de la directive - {$INCLUDE}.
Инструменты разработчика на CLEO
Данный пак немного упрощает разработку модов на CLEO - функциями и константами.
Функции:
В паке 6 функций:
* Спавн актера
* Спавн актера сокращенный
* Спавн машины
* Спавн машины сокращенный
* Спавн пикапа
* Спавн поезда
Вы подключаете функцию через директиву {$I} в начале файла, и прямо там указываете путь до функции, например, так: {$I actor_spawn.func}. Директива должна быть в самом начале файла (там, где обычно пишется {$CLEO}).
Затем вам остается прописать лишь одну строку (вызов функции).
Опкод вызова функции:
0AB1:
{$CLEO}
{$I car_spawn.func}
0AB1: call_scm_func @car_spawn num_params 17 model #FIRETRUK -2144.25 922.4758 79.8516 angle 269.7736 color_1 26 color_2 1 door_status 1 very_heavy 0 BP 0 FP 0 EP 0 MP 0 CP 0 radio 11 siren 1 engine 0 return_a_handle 0@
Marker.CreateAboveCar(1@, 0@)
0A93: end_custom_thread
Константы:
В моем паке вы также найдете файл const, который содержит в себе большой список разнообразных констант, которые могут помочь в разработке. Я поделил все константы на группы:
* Константы для обозначения кнопок (опкод 0AB0:). Имейте ввиду, что Sanny Builder не поддерживает русские имена констант, используются английские названия. Названия клавиш, которые состоят из более одного слова, записываются через знак нижнего подчеркивания (иначе компилятор начинает путаться), например: PAGE_DOWN. В файле констант синонимичные названия клавиш прописаны одна за другой. Пример: в файле есть константы для кнопки escape - ESC и ESCAPE. Пользуйтесь тем, что нравится больше. Из-за ограничений компилятора клавиши с цифрами пишутся так: 0_KEY, 5_KEY. Для num-pad\'а вот так: 0_NUM, 7_NUM. Правый и левый windows, соответственно, вот так: WINDOWS_L, WINDOWS_R. Если есть кое-какие знания английского языка, нетрудно догадаться, что для запятой и точки используются константы COMMA и DOT (синонимичное POINT также допускается).
* Распространенные разрешенные в CLEO глобальные переменные.
* Радиостанции.
* Компоненты автомобиля (двери, капот, багажник).
* Базовые цвета автомобилей.
* Стили походки актеров.
* Типы взрывов. Многие дублируются, в константы записаны самые основные, без повторов.
* Иконки радара.
* Коды погоды.
* Банды.
* Номера оружия.
* Типы поездов.
* Типы пикапов.
Также есть три дополнительные константы - три нуля (ZEROES), плавный и резкий переход для игровой камеры (JUMP_INSTANT, JUMP_SMOOTH).
Файл с константами подключается через директиву {$I}.
Большинство из этих констант очень применимы, и избавляют вас от лазания по справке Sanny Builder\'а, однако, если вы хотите их использовать в своих модах, советую пробежаться по их списку, открыв файл.
Вы можете использовать данные функции и константы в своих модах, автора файла и сайт указывать необязательно.
ПРИМЕЧАНИЕ: после компиляции скрипта, их необязательно прилагать вместе со скриптом - директива {$I} работает по принципу подключения кода функции внутрь файла, то есть, функция будет внутри вашего скрипта. То же относится и к константам. (заменена на строку {$I}).
ПРИМЕЧАНИЕ: вы можете использовать и полную форму записи директивы - {$INCLUDE}.