Доступ к внешним функциям и свойствам в Papyrus - История изменений

Admin в 04:30, 17 марта 2016

2016-03-17T04:30:05Z

Admin в 04:02, 17 марта 2016

2016-03-17T04:02:02Z

Admin в 06:23, 11 марта 2016

2016-03-11T06:23:10Z

Admin в 06:23, 11 марта 2016

2016-03-11T06:23:02Z

Admin: /* Вызов функций на внешних объектах */

2015-08-26T09:31:23Z

‎Вызов функций на внешних объектах

Admin: /* Вызов функций на внешних объектах */

2015-08-25T07:34:36Z

‎Вызов функций на внешних объектах

Admin: /* Наследование */

2015-08-25T05:51:10Z

‎Наследование

Admin: /* Наследование */

2015-08-25T05:26:32Z

‎Наследование

Admin: /* Наследование */

2015-08-24T12:59:33Z

‎Наследование

Admin в 07:50, 24 августа 2015

2015-08-24T07:50:08Z

Внесённые изменения

@@ Строка 8: / Строка 8: @@
 |chapter=3
 |espInitial=EmptyPlugin.esp
-|espCompleted=TesCkRu_Papyrus_For_Beginners_Tutorial.zip
+|espCompleted=-
 |scripts=true
 }}

@@ Строка 2: / Строка 2: @@
 [[Category:Papyrus]]
 [[Category:Учебники Papyrus]]
 '''Оригинал:''' [http://www.cipscis.com/skyrim/tutorials/externalaccess.aspx cipscis.com]

@@ Строка 2: / Строка 2: @@
 [[Category:Papyrus]]
 [[Category:Учебники Papyrus]]
 '''Оригинал:''' [http://www.cipscis.com/skyrim/tutorials/externalaccess.aspx cipscis.com]

@@ Строка 1: / Строка 1: @@
-[[Файл:Symbol_error.png]] '''Статья не закончена!'''
+[[Category:Подробное объяснение]]
-[[Category:Незаконченная статья]]
+[[Category:Papyrus]]
 == Глобальные функции ==
@@ Строка 182: / Строка 188: @@
 </syntaxhighlight>
-У каждого метода есть свои за и против. Первый метод - приводит тип только для вызова функции - удобно если нужно где-либо привести LinkedRef к другому производному типу, поскольку нельзя напрямую делать приведение между родственными типами. The following is possible, but it's also a bit inelegant:
+У каждого метода есть свои за и против. Первый метод - приводит тип только для вызова функции - удобно если нужно где-либо привести LinkedRef к другому производному типу, поскольку нельзя напрямую делать приведение между родственными типами.
 <syntaxhighlight lang="papyrus">
@@ Строка 199: / Строка 207: @@
 </syntaxhighlight>
-The second method - casting the return value of [[GetLinkedRef - ObjectReference|GetLinkedRef]] and storing the value as the derivative type - is useful if you need to treat the value as the derivative type most of the time, and never (or almost never) need to use it as a sibling type.
+Второй метод - преобразование возвращаемого функцией [[GetLinkedRef - ObjectReference|GetLinkedRef]] значения и хранение значения в производном типе - полезно, если важно, чтобы значение имело производный тип большую часть времени, и никогда (ну или почти никогда) не использовалось с типом потомка.
-In these examples, I have used a variable to store the value returned by [[GetLinkedRef - ObjectReference|GetLinkedRef]]. However, if the value is something that you don't need to reuse, you could use the return value directly in your function call, like this:
+В этих примерах, я использовал переменную для хранения значения, возвращаемого функцией [[GetLinkedRef - ObjectReference|GetLinkedRef]]. Однако, если вы не планируете где-либо повторно использовать значение, то можно использовать возвращаемое функцией значение напрямую для вызова необходимой функции, вроде этого:
 <syntaxhighlight lang="papyrus">
@@ Строка 213: / Строка 221: @@
 </syntaxhighlight>
-When deciding whether or not to store something in a variable, it's also important to realise that having a variable point to a certain object will force that object to remain [[Persistence (Papyrus)|persistent]]. If you want to use a variable, but you don't want to keep this object persistent, you can "free" it (assuming that nothing else is keeping it persistent) by assigning the value of your variable to be None.
+При решении вопроса хранить ли что-либо в переменной, так же важно понимать, что имея переменную, указывающую на конкретный объект, вы тем самым склоняете объект к [[Persistence (Papyrus)|постоянству]] (англ. ''persistence''). Если вы хотите использовать переменную, но не хотите сохранять постоянство у данного объекта, вы можете "освобождать" его (если предположить, что больше ничто не заставляет его быть постоянным) присваивая своей переменной значение ''None''.
-−
-−
-----
-−
-'''Оригинал:''' [http://www.cipscis.com/skyrim/tutorials/externalaccess.aspx cipscis.com]
-−
-'''Перевод:''' Кирилл SKV1991 Салтыков (08:35, 24 августа 2015 (MSK))

@@ Строка 153: / Строка 153: @@
 Например, если я создам скрипт, расширяющий TeleportOnBleedout с названием TeleportOnBleedoutChild, но не присоединю его к моему актеру, используемому в этом примере, то я не смогу успешно привести его к типу TeleportOnBleedoutChild. Однако компилятор этого не знает, и мой скрипт будет компилироваться. Если приведение типа не удастся по такой причине, то результатом приведения будет служить None.
-Для приведения одного типа объекта к другому, вам нужно использовать ключевое слово '''as'''. There are a couple of ways in which I could solve my current problem with casting.
+Для приведения одного типа объекта к другому, вам нужно использовать ключевое слово '''as'''. Есть несколько способов, как я могу решить мою текущую проблему с приведением типов.
 <syntaxhighlight lang="papyrus">
@@ Строка 182: / Строка 182: @@
 </syntaxhighlight>
-Each of these methods has its own pros and cons. The first method - casting just for the function call - is useful if you need to cast LinkedRef to another derivative type elsewhere, as you can't cast directly between sibling types. The following is possible, but it's also a bit inelegant:
+У каждого метода есть свои за и против. Первый метод - приводит тип только для вызова функции - удобно если нужно где-либо привести LinkedRef к другому производному типу, поскольку нельзя напрямую делать приведение между родственными типами. The following is possible, but it's also a bit inelegant:
 <syntaxhighlight lang="papyrus">

@@ Строка 100: / Строка 100: @@
 == Вызов функций на внешних объектах ==
-When calling a function on an object other than the one to which your script is attached, the syntax can get more difficult. The most important thing to remember here is that the compiler can travel up the trail of inheritance, but it cannot travel down. Functions declared in a certain script are only accessible from that script or its descendants (i.e. scripts that extend it).
+При вызове функции на объекте, отличающемся от того, к которому присоединен ваш скрипт, синтаксис может получиться более сложным. Самое важно, что стоит запомнить здесь - компилятор может путешествовать ''вверх'' по тропе наследования, но не может ''вниз''. Функции, объявленные в определенном скрипте (назовем его скрипт MyScript) могут быть доступны только из этого скрипта или из скриптов-потомков (т.е. скрипты с указанием extends MyScript в строке определения).
-Usually, this isn't a problem. However, when you're trying to call a function from a script which you've written after getting the object's handle from some other function, there is an extra step that you will probably need to take. I'll tell you about that now.
+Обычно, это не является проблемой. Однако, когда вы пытаетесь вызывать функцию из скрипта, который был написан после получения указателя на объект из какой-нибудь другой функции, есть специальный шаг, который нужно взять на вооружение. Я расскажу о нем прямо сейчас.
-For example, let's make a small modification to TeleportOnBleedout:
+Например, сделаем небольшое изменение в TeleportOnBleedout:
 <syntaxhighlight lang="papyrus">
@@ Строка 120: / Строка 120: @@
 </syntaxhighlight>
-Now, imagine I have another script that I will attach to an activator. When the player activates this activator, it will find my actor and force them to teleport away. The teleporting actor will be set up as the linked reference of my activator, so I will get a handle on them by using GetLinkedRef:
+Теперь представьте, у меня есть другой скрипт, который я привязал к активатору. Когда игрок активирует его, он найдет актера и отправит его на телепортацию (функция TeleportAway). Перемещаемый актер будет установлен как связанный с моим активатором (через linked reference), так что я получу указатель на него, используя [[GetLinkedRef - ObjectReference|GetLinkedRef]]:
 <syntaxhighlight lang="papyrus">
@@ Строка 136: / Строка 136: @@
 </syntaxhighlight>
-GetLinkedRef returns an object of type ObjectReference, so I assign its return value to a variable of that type. Then, when the player activates the scripted activator (hopefully you recognise that GetPlayer is a global function from the Game script) this script will call the TeleportAway function that I've defined.
+Функция [[GetLinkedRef - ObjectReference|GetLinkedRef]] возвращает объект типа ObjectReference, поэтому я присвою возвращаемое ею значение переменной такого же типа. Затем, когда игрок активирует заскриптованный активатор (надеюсь, вы понимаете, что это [[GetPlayer - Game|GetPlayer]] - это глобальная функция из скрипта [[Game Script|Game]]), данный скрипт вызовет функцию TeleportAway, которую я определил.
-There's a problem, though. This all might look correct at first glance, but the compiler complains that it can't find the TeleportAway function. The problem is that, because the variable LinkedRef is of type ObjectReference, the compiler is looking in the ObjectReference script for functions (including inherited functions, remember) called TeleportAway. There aren't any, though, so it won't compile.
+Хотя, есть проблемка. На первый взгляд все это может выглядеть корректно, но компилятор сообщит, что не может найти функцию TeleportAway. Проблема в том, что переменная LinkedRef имеет тип ObjectReference, компилятор смотрит в скрипт ObjectReference и ищет функцию (включая унаследованные функции, помните) с названием TeleportAway. Хотя такой функции нет, поэтому скрипт не скомпилируется.
-The solution involves something called casting, which is something that lets you turn an object of one type into an object of another type.
+Решение включает в себя то, что называется [[Справка по приведению типов|приведением типов]] (cast), оно позволяет привести объект одного типа к объекту другого типа.
-With the exception of the basic types, like "int" and "bool", an object of type A can be cast to an object of type B if either...
+Исключая базовые типы, вроде "int" и "bool", объект типа A может быть приведен к объекту типа B если...
-* type A is an ancestor of type B
+* Тип A является предком типа B
-* type B is an ancestor of type A
+* Тип B является предком типа A
-Remember that a function is available in a script if it is defined in that script or one of its ancestors. This means that, if I want the compiler to be able to find my TeleportAway function, I'll need to cast LinkedRef to type TeleportOnBleedout or one of its descendants.
+Запомните, что функция доступна в скрипте, если она объявлена в этом скрипте, или в одном из его предков. Это значит, что если я хочу, чтобы компилятор мог найти мою функцию TeleportAway, мне нужно привести LinkedRef к типу TeleportOnBleedout или к одному из его потомков.
-Now, TeleportOnBleedout doesn't have any descendants, so my only choice is to cast as type TeleportOnBleedout. However, if it did have descendants, I could not cast LinkedRef to a type more derived than the script attached to it.
+Сейчас TeleportOnBleedout не имеет ни одного потомка, так что единственным для меня вариантом будет привести к типу TeleportOnBleedout. Однако, если ''есть'' потомки, я не должен приводить LinkedRef к более производному типу, чем сам скрипт, присоединенный к объекту.
-For example, if I created a script extending TeleportOnBleedout called TeleportOnBleedoutChild, but didn't attach it to my actor that I'm using in this example, then I wouldn't be able to cast it successfully to the type TeleportOnBleedoutChild. However, the compiler doesn't know this, so my script would still compile. If a cast fails for a reason like this, then the result of the cast will be None.
+Например, если я создам скрипт, расширяющий TeleportOnBleedout с названием TeleportOnBleedoutChild, но не присоединю его к моему актеру, используемому в этом примере, то я не смогу успешно привести его к типу TeleportOnBleedoutChild. Однако компилятор этого не знает, и мой скрипт будет компилироваться. Если приведение типа не удастся по такой причине, то результатом приведения будет служить None.
-In order to cast an object of one type to another, you need to use the as keyword. There are a couple of ways in which I could solve my current problem with casting.
+Для приведения одного типа объекта к другому, вам нужно использовать ключевое слово '''as'''. There are a couple of ways in which I could solve my current problem with casting.
 <syntaxhighlight lang="papyrus">
@@ Строка 199: / Строка 199: @@
 </syntaxhighlight>
-The second method - casting the return value of GetLinkedRef and storing the value as the derivative type - is useful if you need to treat the value as the derivative type most of the time, and never (or almost never) need to use it as a sibling type.
+The second method - casting the return value of [[GetLinkedRef - ObjectReference|GetLinkedRef]] and storing the value as the derivative type - is useful if you need to treat the value as the derivative type most of the time, and never (or almost never) need to use it as a sibling type.
-In these examples, I have used a variable to store the value returned by GetLinkedRef. However, if the value is something that you don't need to reuse, you could use the return value directly in your function call, like this:
+In these examples, I have used a variable to store the value returned by [[GetLinkedRef - ObjectReference|GetLinkedRef]]. However, if the value is something that you don't need to reuse, you could use the return value directly in your function call, like this:
 <syntaxhighlight lang="papyrus">
@@ Строка 213: / Строка 213: @@
 </syntaxhighlight>
-When deciding whether or not to store something in a variable, it's also important to realise that having a variable point to a certain object will force that object to remain persistent. If you want to use a variable, but you don't want to keep this object persistent, you can "free" it (assuming that nothing else is keeping it persistent) by assigning the value of your variable to be None.
+When deciding whether or not to store something in a variable, it's also important to realise that having a variable point to a certain object will force that object to remain [[Persistence (Papyrus)|persistent]]. If you want to use a variable, but you don't want to keep this object persistent, you can "free" it (assuming that nothing else is keeping it persistent) by assigning the value of your variable to be None.

@@ Строка 82: / Строка 82: @@
 Теперь, если говорить об этом коде - это пример того, насколько просто вызывать функцию на объекте, к которому присоединен этот скрипт.
-Хотя функция [[MoveTo - ObjectReference|MoveTo]] не определена в этом скрипте, она все равно остается доступной, потому что объявлена в предке данного скрипта. TeleportOnBleedout наследует скрипт Actor, а скрипт Actor наследует ObjectReference, и функция MoveTo объявлена внутри скрипта [[ObjectReference script|ObjectReference]].
+Хотя функция [[MoveTo - ObjectReference|MoveTo]] не определена в этом скрипте, она все равно остается доступной, потому что объявлена в предке данного скрипта. TeleportOnBleedout наследует скрипт Actor, а скрипт Actor наследует ObjectReference, и функция MoveTo объявлена внутри скрипта [[ObjectReference Script|ObjectReference]].
-Functions can be inherited through any number of levels in this way, and the lowest overridden version will always take precedence. You won't want to override native functions like MoveTo, even though it's possible, as they are defined by the game engine and overriding them may produce odd results.
+Если использовать данный способ, функции могут быть унаследованы через любое число уровней наследования, и версия с переопределением, находящаяся на самом нижнем уровне всегда будет иметь приоритет над вышестоящей. Однако не стоит переопределять нативные функции, вроде MoveTo, хоть это и возможно, эти функции определены в игровом движке и их переопределение может привести к непредсказуемым результатам.
-Remember how I mentioned earlier that non-global functions are run on an object in the game? MoveTo is no exception, yet we haven't specified an object on which it should run. When a non-global script is called in this way, it is called on the object on which the current function is running (functions can only be called from within other functions. Remember that your entry point is always the game calling a native event, like OnEnterBleedout).
+Помните, ранее я упоминал, что не-глобальные функций выполняются на внутриигровых объектах? Функция MoveTo не является исключением, но мы не указали объект, на котором она должна выполняться. Когда не-глобальная функция вызывается таким способом, она вызывается на объекте, на котором в данный момент выполняется (функции можно вызывать только внутри других функций. Помните, что вашей входной точкой всегда является вызов игрой нативного события, вроде OnEnterBleedout).
-It is possible to directly use this object within a non-global function by using the special variable "Self". This is usually only useful when you need to pass this information as the parameter of a function.
+Можно напрямую использовать данный объект внутри не-глобальной функции, используя специальную переменную "Self". Обычно такой способ полезен лишь в тех случаях, когда нужно передать данную информацию в качестве параметра функции.
-Another special variable that is available within non-global functions is "Parent". With this variable, it is possible to call the parent's version of a function, including events, if it has been overridden in the current script.
+Есть и другая специальная переменная, доступная в не-глобальных функциях - "Parent". Используя эту переменную, можно вызывать родительскую версию функции, включая события, если она была переопределена в данном скрипте.
 === Свойства и переменные ===
-When you extend a script, you also inherit its properties. As with functions, you can use these properties as though they were declared in your own script. However, unlike functions, you cannot override properties. You will have to use them in whichever way they were declared in your script's ancestor.
+При использовании extend в скрипте, вы так же наследуете свойства. Как и функции, вы можете использовать эти свойства, как-будто они были объявлены в вашем собственном скрипте. Однако, в отличии от функций, свойства нельзя переопределить. Вы должны будете использовать их в зависимости от того, как они были объявлены в предке вашего скрипта.
-When extending a script, you do not inherit its variables. Variables are entirely private, and cannot be accessed from outside the block in which they are declared (this is known as having "block scope"). Examples of blocks are functions, if blocks, and while blocks.
+Так же, при расширении скрипта (extends), вы не наследуете его переменные. Переменные являются полностью частными, и к ним нельзя получить доступ вне блока, в котором они были объявлены (это называется "блочная зона видимости" (block scope)). Примерами блоков служат функции, блоки if, и блоки while.
 == Вызов функций на внешних объектах ==

@@ Строка 67: / Строка 67: @@
 Первая подсказка здесь указана в строке объявления ScriptName. На простом английском, термин "extends Actor" означает "наследовать все свойства и функции скрипта Actor (включая события)". Если же мой скрипт состоит из одной строки, то получается я просто напросто дублирую скрипт Actor.
-This means that, without declaring them myself, I have access to all of Actor's properties and functions, without having to add any extra identifiers to tell the compiler where to look.
+Это значит, что у нас есть доступ ко всем свойствам и функциям скрипта Actor без их объявления, и без добавления каких-либо дополнительных идентификаторов, сообщающих компилятору, куда смотреть.
-As well as being able to call any of Actor's functions directly, I can override them by defining them again in my script. For example, the OnEnterBleedout event (remember that events are functions) is defined in the Actor script like this:
+Помимо прямого доступа к любой функции скрипта Actor, мы можем переопределить их, снова написав в нашем скрипте. Например, событие OnEnterBleedout (помните, что события являются функциями) определено в скрипте Actor так:
 <syntaxhighlight lang="papyrus">
@@ Строка 76: / Строка 76: @@
 </syntaxhighlight>
-([[OnEnterBleedout - Actor|OnEnterBleedout]] is a native event - the game calls it on Actor objects when they enter "bleedout" mode)
+([[OnEnterBleedout - Actor|OnEnterBleedout]] это нативное событие - игра вызывает его на объекта типа Actor, когда они входят в режим "bleedout"(кровотечение))
-As you can see, had I not overridden it, nothing would happen when this event was called. However, I have overridden it, so when the game calls the OnEnterBleedout event on this actor, the code defined in TeleportOnBleedout's version will run.
+Как вы могли заметить, если бы я не переопределил его, ничего бы не происходило при вызове этого события. Однако я его переопределил, поэтому при вызове игрой события OnEnterBleedout на данном актере, будет запущен код, определенный в версии TeleportOnBleedout.
-Now, speaking of that code, this is an example of how easy it is to call a function on the object to which its script is attached.
+Теперь, если говорить об этом коде - это пример того, насколько просто вызывать функцию на объекте, к которому присоединен этот скрипт.
-Although MoveTo is not declared in this script, it is still available because it is declared in an ancestor of this script. TeleportOnBleedout extends Actor, and Actor extends ObjectReference, and MoveTo is declared within the ObjectReference script.
+Хотя функция [[MoveTo - ObjectReference|MoveTo]] не определена в этом скрипте, она все равно остается доступной, потому что объявлена в предке данного скрипта. TeleportOnBleedout наследует скрипт Actor, а скрипт Actor наследует ObjectReference, и функция MoveTo объявлена внутри скрипта [[ObjectReference script|ObjectReference]].
 Functions can be inherited through any number of levels in this way, and the lowest overridden version will always take precedence. You won't want to override native functions like MoveTo, even though it's possible, as they are defined by the game engine and overriding them may produce odd results.

@@ Строка 65: / Строка 65: @@
 Возможно скрипт выглядит небольшим, однако здесь происходит достаточно много действий в плане наследования.
-Первой подсказка здесь - в строке объявления ScriptName. На просто английском, термин "extends Actor" означает "наследовать все свойства и функции скрипта Actor (включая события)". Если же все, что у меня есть в скрипте - одна строка, то получается я просто напросто дублирую скрипт Actor.
+Первая подсказка здесь указана в строке объявления ScriptName. На простом английском, термин "extends Actor" означает "наследовать все свойства и функции скрипта Actor (включая события)". Если же мой скрипт состоит из одной строки, то получается я просто напросто дублирую скрипт Actor.
 This means that, without declaring them myself, I have access to all of Actor's properties and functions, without having to add any extra identifiers to tell the compiler where to look.