Скрипты Lua в Se3: Начало Часть1

Объект Entity 

• объект, который появляется в игре. Любой звук, геометрия, эффект, фон, невидимое и т.д.  Entity делятся на классы.Каждый объект в мире присваивается уникальный идентификатор при создании. Все Entity имеют две общие характеристики: "Имя" и "Родитель".
• все объекты Entity (различного класса) доступны в дереве вкладки EntityList

КЛАССЫEntity

КЛАСС  CScriptProperties 

КАК ПРИСВАИВАТЬ ПЕРЕМЕННЫМ редактора Lua класс Entity из SE3 

• в  редакторе Lua  пишем любое символьное имя например: m - это и будет новая переменная, к которой мы присваиваем любой Entity
• далее перетаскиваем мышью  (при этом нажав Ctrl+Alt+Shift - на самом деле это копирование Entity) выбранный Entity из Карты (например ящик СStaticModelProperties) в 
  редактор Lua  к m (при перетаскивании мы видим +)
• если все сделано правильно, то  в  редакторе Lua  переменная m окрашивается в зеленый цвет. В результате чего мы видим ниже описание: Variable m присвоено значение Handle. 
• Когда мы поставим точку перед переменной m, то увидим красную черту, а при наведении на саму m появляться  пояснение, что это СStaticModelProperties. Красная черта означает, что необходимо дописать код. На самом деле точка открывает доступ к свойствам объекта (как и в другом любом языке)
• Закоментированный код в редакторе выглядит (без русских символов):--Comment 
  
  

СОХРАНЕНИЕ СКРИПТА

• Сохранить скрипт в файл формата Lua можно, открыв вкладку Entity этого  CScriptProperties и наведя курсор на Значение (Value) свойства Script нажимаем правой кнопкой мыши выбираем Save или Save As... (аналогично загрузка через Browse...)

ПАНЕЛЬ RCon:Local

• RCon:Local- информационная панель, откуда можно узнать наличие ошибок  скрипта Lua или вывести какие-нибудь данные . Командную Панель RCon:Local можно активировать в View-RCon:Local 

         например напишем в редакторе:

print(Text...Text)

• print("мой первый скрипт")
• при запуске игры Ctrl+T в панели RCon:Local выведет мой первый скрипт

КАК ПОЛУЧИТЬ ВСЕ Entity Карты с ОДИНАКОВЫМ КЛАССОМ

КАК ПОЛУЧИТЬ Entity Карты по id

Простейшие Операции и выражения

Простейшие операторы: 

and 
or

• b=type(a)--String  

узнаем тип переменной a (возвращает строку)

1. Выражение

• a==b --Boolean- равно
• a<=b --Boolean - меньше равно 
• a>=b --Boolean - больше равно 
• a<b --Boolean - меньше 
• a>b --Boolean - больше 
• a~=b --Boolean - не равно

• if  Выражение  then ... end 

Если выполняется Выражение  тогда ...

3. Функции в SE3

• H=mthDegToRad(DegH)--Float
• P=mthDegToRad(DegP)--Float
• B=mthDegToRad(DegB)--Float
  
  
• q=mthHPBToQuaternion(H,P,B)--Quaternion4f (угол)
  
• H=q.h --Float
• P=q.p --Float
• B=q.b --Float

• V=mthVector3f(x, y, z)--Vector3f (вектор)
  
• x=V.x--Float
• y=V.y--Float
• z=V.z--Float
   

• QV=mthQuatVect(q, V)--QuatVec 
  
  
• q=QV:GetQuat()--Float
  
  
• H=QV.qh --Float
• P=QV.qp --Float
• B=QV.qb --Float
  
  
• V=QV:GetVect()--Float
  
  
• x=QV.vx --Float
• y=QV.vy --Float
• z=QV.vz --Float
   
  
  
• QV=entity:GetPlacement()--QuatVec
• entity:SetPlacement(QV)

ОБЪЯВЛЕНИЕ ФУНКЦИИ  

• local function Name(param1,param2...)...Return Result...end
• function worldGlobals.Name(param1,param2...)...Return Result... end
• function thisScript Name() ...Return Result... end
  вызов в другом скрипте scriptName:Name()

пример:

function worldGlobals.SetEntityPosition(entity, vNewPosition)

entity:SetPlacement(

mthQuatVect(entity:GetPlacement():GetQuat(),vNewPosition))

end

вызываем:

• worldGlobals.SetEntityPosition(model,  V)

установить модель Entity на карте в положение с координатами V