View source for Scripting Documentation/ru

{{Quicklinks|Scripting Documentation}}

== О скриптинг автоматизации в OpenSimulator ==
Важный элемент миров аналогичных Second Life ™ - скриптинг автоматизация. Это сердце  которое управляет всем. В SL [http://wiki.secondlife.com/wiki/LSL_Portal LSL (Linden Scripting Language - язык сценариев Линденов)] это язык, который вы должны использовать в своей работе. Этот язык имеет свои ограничения и работает не так быстро как хотелось. Но тем не менее, он работает и довольно неплохо справляется со своими делами. <br />

OpenSimulator сегодня поддерживает сценарии автоматизации на LSL, OSL и C#. Но имеют место ограничения:
* Не все команды или события одинаково хорошо реализованы, могут и не работать как положено. См. '''Статус скриптинг автоматизации''' ниже, для получения деталей на то, какие команды работают и какие нет.
* Система скриптинг автоматизаци в OpenSimulator компилирует код из LSL в код платформы .Net, который является байт кодом (JIT) процессора, промежуточным видом кода перед трансляцией в  машинный код (перед непосредственным исполнением он транслируется в машинный код специфического процессора, что дает независимость от системной архитектуры). Фактически это означает, что скрипты LSL в OpenSimulator должна работать быстрее, чем в Second Life.  
* Стабильность и безопасность: см [[Script Sandbox|Script Execution Песочник]].

== Настройка скриптинг автоматизации ==
Существует ряд параметров, которые могут быть настраиваемы для работающих скриптов, например те, которые включают расширенный набор команд OSSL или снимают ограничения на некоторые объекты автоматизации(например, количество активных триггеров).

Для автономных симуляторов и малых грид-сетей, настройки по умолчанию должны быть изменены.  См [[Configuring Scripting]] для получения информации о настройке этих параметров.

== Как использовать скрипты в OpenSimulator ==
If you have never written a script in LSL before, then please have a look at the [http://wiki.secondlife.com/wiki/LSL_Tutorial LSL wiki] to learn the scripting basics.
If you do have (some) experience with writing or editing LSL scripts, then the procedure is identical to the procedure on SL.
<!-- We've shown the reader where and how to learn how to create/edit scripts. We therefore do not need to give them our own tutorial. -->
<!--The current procedure to get a script working in OpenSimulator is:
* Create a new script in inventory. (Inventory -> Create -> New Script)
* Write whatever script you want there, or copy the script contents of another script in the pre-existing OpenSimulator library. Check [[LSL Status]] for what commands that are supported.
* Drag the script over to the contents of an object.
* If there is an error in the script when saving or when dropped into an object, an error alert is displayed for a short time. Click on the alert to display the Debug Window and the script error. 
* To deactivate a script, edit the script and uncheck 'Running'. This also stops error alerts when saving scripts.
* Deleting a script from the object will not always stop its effects. Examples of this are hovertexts, or particles. The reason why they stay even after the script is deleted, is because hovertext and particles are prim properties, which can only be edited through a script. To get rid of the effects, you must first deactivate them in your script, before deleting the script. If you deleted your script before you've cleared the effects, you will have to make a script that will deactivate or clear them, and use them in that prim.
-->

Известные проблемы:
* Error messages about scripting errors are often cryptic, and tend to be long.
* List memory optimization hacks like this ... myList = llListReplaceList((myList = []) + myList, ["myString"], 2, 2); ... will fail.
* Linux/Mac users will need to upgrade the default mono to "mono-complete" in order to have a fully functional scripting engine in OpenSimulator. See [http://opensimulator.org/mantis/view.php?id=5007 the bug tracker] for details.

== Статус скриптинг автоматизации ==
Status Tables / Charts related to LSL and OSSL functions, constants and related material.<br />

[[LSL Status|LSL/OSSL Status Overview]]<br />
'''LSL'''
* [[LSL Status/Functions|LSL-Functions Status]]
* [[LSL Status/Constants|LSL-Constants Status]]
* [[LSL Status/Events|LSL-Events Status]]
* [[LSL Status/Types|LSL-Types Status]]
'''OSSL'''
* [[OSSL Implemented|OSSL Functions with examples]] 
* [[OSSL Constants]]

== Дополнительные ресурсы по скриптинг автоматизации (LSL) ==
There have been many questions regarding scripts and tools for scripting lately. Presented here are a variety of Links to Resources which will help most people with Scripting LSL.

=== Специфичные для OpenSimulator материалы: ===

* [[:Category:OSSL Functions | OSSL функции и примеры]] - хорошее место с которого начинают изучение OSSL скриптинга.
* [[OSSL Script Library |Библиотека скриптов]] которые используют OSSL функции.

=== Предлагаемые ссылки для LSL вики: ===

* [http://wiki.secondlife.com/wiki/LSL_Portal wiki.secondlife.com]

* [http://www.lslwiki.net/lslwiki/wakka.php?wakka=HomePage lslwiki.net] ''(Historical reference wiki)''

Note the Tutorials, Examples & Script Libraries

== Внешние LSL редакторы с синтаксической подсветкой кода ==
Примечание: большинство не поддерживают osFunctions

'''LSL EDITOR''' ''(no osFunctions)'' [[Image:Windows_logo.png|24px|frameless|Windows version available]]
:* [http://sourceforge.net/projects/lsleditor/ LSLeditor SourceForge]
:* [http://www.lsleditor.org/ Original Author's website with his latest LSLeditor version]
:Now an Open Source project. New release is February 2012 (Ver.2.44.2). A valuable tool and easy install.
----
'''LSL Plus''' ''(no osFunctions)'' [[Image:Windows_logo.png|24px|frameless|Windows version available]][[Image:Macosx_logo.png|24px|MacOSX version available]][[Image:Tux.png|24px|frameless|Linux version available]]
:* [http://lslplus.sourceforge.net/ LSLplus]
:Open source [http://www.eclipse.org/ Eclipse] plugin. Regular updates. Not quite as quick to get installed as LSLEditor, but very good tool.
----
'''Notepad++''' ''(osFunctions supported with add-on UDF)'' [[Image:Windows_logo.png|24px|frameless|Windows version available]]
:* [http://notepad-plus-plus.org/ Notepad Plus Plus]
:* [https://github.com/WhiteStar-Magic/NotePad---userdef/archives/master LSL and OS functions UDF]
:Windows only Editor with enhanced capabilities & supports most languages. Very powerful & feature rich.
----
'''KATE''' ''(no osFunctions)'' [[Image:Windows_logo.png|24px|frameless|Windows version available]][[Image:Macosx_logo.png|24px|MacOSX version available]][[Image:Tux.png|24px|frameless|Linux version available]]
:* [http://kate-editor.org/ Kate Homepage]
:Free and open source text editor, supporting lots of scriptinmg and programming languages out of the box. This includes LSL.
----
More editors are listed at http://wiki.secondlife.com/wiki/LSL_Alternate_Editors


=== Подсветка синтаксиса ===

* [http://qbnz.com/highlighter/ GeSHi project home page]
* [https://sourceforge.net/projects/geshi/files/geshi/GeSHi%201.0.8.10/ Most current version of GeSHI for download]
* [https://github.com/WhiteStar-Magic/Scripting-Syntax-Highlights GeSHi LSL support file] includes osFunctions & updated
* Extra Reference at MediaWiki: [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi Syntax Highlighter for WIKI and Forums]

=== Разное: ===

* [http://www.hilarymason.com/blog/secondlife/autoscript-creates-lsl-scripts-without-code/ AutoScript, Simple & Quick Code generator for simple things (ONLINE)]

* [http://code.google.com/p/lslsnippets/ lslsnippets ]

* [http://www.vtoreality.com/2006/free-offsite-storage-for-lsl-scripts-up-to-250k/186/ Free offsite storage for LSL scripts up to 250k ]

* [http://www.freeslscripts.gendersquare.org/index.php Free SL Scripts (library)]

* [http://s4sl.blogspot.com/ Scratch for SecondLife (Script Code generator with Nice Interface - UPDATED JUL.09.2009)]

* [http://redwood.colorado.edu/jkb/fs2lsl/ FS2LSL Flash Scratch to LSL (a feature-rich Scratch-like script code generator)]

* [http://www.peregrinesalon.com/2009/01/05/major-upgrade-to-animated-gif-to-animated-sl-texture-conversion-tool-v04/ Second Life Animated Texture Creator v0.4 - brought to you by Peregrine Salon]

* [[Presentation Board]] - Simple Presentation Board that slides through inventory textures...

* [http://www.free-lsl-scripts.com/cgi/freescripts.plx More then 1000 open source/public domain scripts (library)]

* [http://greenbushlabs.com/scriptastic Block Based Script Building Tool (like Scratch) making LSL Scripting Simple Enough Even for Kids]

* [https://github.com/wp2opensim/FS2SL GitHub FS2LSL] - FS2LSL Online-Offline LSL/OSSL script editor for WEB or Windows (Programming for beginners)

== Дополнительные ресурсы для скриптинг автоматизации (OSSL) ==
There have been many questions regarding scripts and tools for scripting lately. Presented here are a a few links to Resources which will help most people with OSSL scripting.

* [[OSSL Implemented|OSSL Functions with examples]] - A good place to start reading about OSSL scripting.
* [[OSSL Script Library]] A library of scripts which utilize OSSL functions.
* [[OSSL Proposals]] - Suggestions for custom OSSL functions. Got a suggestion too? Add it!
* [[Drawing commands]] - How to use the texture draw functions supported in OSSL.
* [[OSSL TextureDrawing]] - Details of the OSSL texture drawing functions.
* [[OsParseJSON example1|Language Translation]] - A script which uses the JSON parsing function to call Google's Translation API
* [http://www.osgrid.org/forums/ OSGrid Forums] - LSL/OSSL discussions, examples, tips, etc.


== Как внести свой вклад ==
The ScriptEngine is being developed by many developers. New developers are always welcome. If you want to contribute, even just a tiny little bit, have a look at the [[OpenSim.Region.ScriptEngine]] page. There is a lot of developer activity on IRC ([[Support]]), feel free to drop in.

* [[OSSL Standards]] - A whitepaper concerning naming-standards for the OpenSimulator scripting language
* [[OpenSim.Region.ScriptEngine.Common]] - How to create your own script engine
* [[OpenSim.Region.ScriptEngine.DotNetEngine|DotNet-Engine]] - Describes some of the esoteric parts of the DotNet-Engine 


== Смотрите так же ==
* [[ScriptEngines|Scripting Engine]] - [[Xengine]] Script Engine Transition (By Melanie_T) 
* [[Scripting Languages]] - Supported Scripting Languages 
* [[LSL Status|LSL/OSSL Status]] - Status and news about LSL and OSSL
* [[OSSL Enabling Functions]] - How to enable OSSL functions.
* [[Threat level]] - Information about OSSL threat levels.
* [[Non-LSL scripting]] - Information on C# and scripting in OpenSimulator with other languages

[[Category:Development]]
[[Category:Users]]
[[Category:Scripting]]