MoveTo - ObjectReference - История изменений

Admin: /* {{Notes}} */

2018-02-07T04:21:50Z

‎{{Notes}}

Admin в 17:41, 24 мая 2016

2016-05-24T17:41:18Z

Admin в 10:32, 25 августа 2015

2015-08-25T10:32:29Z

Admin: /* See Also */

2015-08-25T10:32:14Z

‎See Also

Admin: /* Bugs */

2015-08-25T10:31:42Z

‎Bugs

Admin: /* Примечания */

2015-08-25T10:10:16Z

‎Примечания

Admin в 08:31, 25 августа 2015

2015-08-25T08:31:41Z

Admin в 07:29, 25 августа 2015

2015-08-25T07:29:04Z

Admin: Новая страница: «Файл:Symbol_error.png '''Статья не закончена!''' Category:Незаконченная статья Category:Scripting Category:…»

2015-08-25T05:51:59Z

Новая страница: «Файл:Symbol_error.png '''Статья не закончена!''' Category:Незаконченная статья Category:Scripting Category:…»

Новая страница

[[Файл:Symbol_error.png]] '''Статья не закончена!'''
[[Category:Незаконченная статья]]

[[Category:Scripting]]
[[Category:Papyrus]]
[[Category:Latent Functions]]
'''Member of:''' [[ObjectReference Script]]

Moves this reference to the location of the target reference, with the specified offset.

== Syntax ==
<source lang="papyrus">
Function MoveTo(ObjectReference akTarget, float afXOffset = 0.0,
float afYOffset = 0.0, float afZOffset = 0.0, bool abMatchRotation = true) native
</source>

== Parameters ==
*akTarget: The target reference to move this one to.
*afXOffset: How much to offset the move in the X direction.
**'''Default:''' 0.0
*afYOffset: How much to offset the move in the Y direction.
**'''Default:''' 0.0
*afZOffset: How much to offset the move in the Z direction.
**'''Default:''' 0.0
*abMatchRotation: Whether the moved object should match the rotation of the target object or not
**'''Default:''' True

== Return Value ==
None.

== Examples ==
<source lang="papyrus">
; Move Bob to his house, designated by a marker
Bob.MoveTo(BobsHouseMarker)
</source>
<br/>
<source lang="papyrus">
; Move Bob to his house, but don't match the rotation of the marker
Bob.MoveTo(BobsHouseMarker, abMatchRotation = false)
</source>
<br/>
<source lang="papyrus">
; Moves a portal 120 units in front of the player, 35 units under their height
Actor PlayerRef = Game.GetPlayer()
Portal.MoveTo(PlayerRef, 120.0 * Math.Sin(PlayerRef.GetAngleZ()), 120.0 * Math.Cos(PlayerRef.GetAngleZ()), PlayerRef.GetHeight() - 35.0)
</source>

== Notes ==
* MoveTo() should be avoided for placing other actors in sight of the player, as they will suddenly appear in an unrealistic way. Instead, consider placing them nearby but out of sight, and making them approach the player themselves, using [[PathToReference - Actor|PathToReference]] or [[ForceGreet (Procedure)|ForceGreet]].

* Flora objects cannot be moved using MoveTo.

* Making an actor MoveTo() a furniture reference will make the actor immediately assume the position of "using" that furniture, without playing the furniture entrance animation. Example: PlayerRef.MoveTo(BedReference) will make the player lie down on the bed reference (without playing the bed entrance animation).

* MoveTo can cause undesirable results when moving an object to another actor, whose X and Y rotation angles are relative to that actor's looking angle, not their rotation relative to the world. Furthermore, as with [[SetPosition - ObjectReference|SetPosition]], MoveTo doesn't take uneven terrain into account.
**In order to "straighten" or flatten an object's rotation, set the abMatchRotation parameter to False, or call [[SetAngle - ObjectReference|SetAngle]] similar to the following:
<source lang="papyrus">
myObject.MoveTo(Game.GetPlayer()) ;Or, whatever the target of the MoveTo() is
myObject.SetAngle(0.0, 0.0, 0.0)
</source>
* Actors moved with this function are always rotated correctly relative to the world.

== Bugs ==
* If an actor is already in the cell, and the player is also in the cell, leaving the cell, or arriving in the cell, MoveTo() does not function. As cells can be quite large in cities and multi-level buildings, ensuing dialogue can occur with the actor out-of-sight and/or out-of-hearing. Try [[DisableNoWait - ObjectReference|DisableNoWait]](), MoveTo(), [[EnableNoWait - ObjectReference|EnableNoWait]](), [[EvaluatePackage - Actor|EvaluatePackage]]() sequence. Take care that the sequence happens out-of-sight of the player, such as during passage through a loading [[Door|door]].

* As of 1.9, calling Game.GetPlayer().MoveTo(AnyBedReference) will cause the Player's eyes to become stuck shut. They can only be opened again by using the showracemenu console command, or by reloading the game.

== See Also ==

*[[ForceGreet (Procedure)]]
*[[MoveToInteractionLocation - ObjectReference]]
*[[MoveToMyEditorLocation - ObjectReference]]
*[[ObjectReference Script]]
*[[PathToReference - Actor]]
*[[SetPosition - ObjectReference]]
*[[Unit]]

@@ Строка 45: / Строка 45: @@
 * Используя на актере MoveTo() и используя ссылку на фурнитуру, заставит актера мгновенно принять положение "использования" этого объекта фурнитуры, без проигрывания анимации начала её использования. Пример: PlayerRef.MoveTo(BedReference) заставит игрока лечь на кровать (без проигрывания анимации того, что он ложится).
-* MoveTo может вызвать нежелательные результаты перемещая объект к другому актеру, чей угол поворота по X и Y относителен углу взгляда этого актера, а него его углу поворота, относительно игрового мира. Кроме того, как и с [[SetPosition - ObjectReference|SetPosition]], MoveTo не учитывает поверхность земли.
+* MoveTo может вызвать нежелательные результаты перемещая объект к другому актеру, чей угол поворота по X и Y относителен углу взгляда этого актера, а не его углу поворота, относительно игрового мира. Кроме того, как и с [[SetPosition - ObjectReference|SetPosition]], MoveTo не учитывает поверхность земли.
 ** Для "выпрямления" или сброса угла поворота объекта, установите параметр abMatchRotation на False, или вызовите функцию [[SetAngle - ObjectReference|SetAngle]] со схожими параметрами:
 <source lang="papyrus">

@@ Строка 2: / Строка 2: @@
 [[Category:Papyrus]]
 [[Category:Латентные функции]]
-'''Является частью:''' [[ObjectReference Script]]
+{{MemberOfScript|parent=ObjectReference Script}}
-−
 Перемещает данный объект (ссылку) в координаты целевого объекта (ссылки), с указанным смещением.
-== Синтаксис ==
+== {{Syntax}} ==
 <source lang="papyrus">
 Function MoveTo(ObjectReference akTarget, float afXOffset = 0.0,
@@ Строка 12: / Строка 11: @@
 </source>
-== Параметры ==
+== {{Parameters}} ==
-*akTarget: Целевой объект, к которому будет перемещение.
+*'''akTarget''': Целевой объект, к которому будет перемещение.
-*afXOffset: Смещение от цели по оси X.
+*'''afXOffset''': Смещение от цели по оси X.
-**'''Default:''' 0.0
+**'''{{Default}}''': 0.0
-*afYOffset: Смещение от цели по оси Y.
+*'''afYOffset''': Смещение от цели по оси Y.
-**'''Default:''' 0.0
+**'''{{Default}}''': 0.0
-*afZOffset: Смещение от цели по оси Z.
+*'''afZOffset''': Смещение от цели по оси Z.
-**'''Default:''' 0.0
+**'''{{Default}}''': 0.0
-*abMatchRotation: Должен ли перемещаемый объект совпасть с целевым по углу поворота или нет
+*'''abMatchRotation''': Должен ли перемещаемый объект совпасть с целевым по углу поворота или нет
-**'''Default:''' True
+**'''{{Default}}''': True
-== Возвращает значение ==
+== {{Return Value}} ==
 None.
-== Примеры ==
+== {{Example}} ==
 <source lang="papyrus">
 ; Переместим Боба в его дом, обозначив маркер
 Bob.MoveTo(BobsHouseMarker)
-</source>
-<br/>
-<source lang="papyrus">
 ; Переместим Боба в его дом, но не совпадая с поворотом маркера
 Bob.MoveTo(BobsHouseMarker, abMatchRotation = false)
-</source>
-<br/>
-<source lang="papyrus">
 ; Перемещаем портал на 120 единиц перед лицом игрока, и 35 единиц под высотой игрока
 Actor PlayerRef = Game.GetPlayer()
@@ Строка 43: / Строка 38: @@
 </source>
-== Примечания ==
+== {{Notes}} ==
 * Нужно избегать использования MoveTo() при размещении других актеров в поле зрения игрока, поскольку они внезапно свалятся из ниоткуда и будет выглядеть не реалистично. Вместо этого, постарайтесь разместить их рядом, но вне зоны видимости игрока, и заставить их самих подойти к игроку, используя [[PathToReference - Actor|PathToReference]] или [[ForceGreet (Procedure)|ForceGreet]].
@@ Строка 51: / Строка 46: @@
 * MoveTo может вызвать нежелательные результаты перемещая объект к другому актеру, чей угол поворота по X и Y относителен углу взгляда этого актера, а него его углу поворота, относительно игрового мира. Кроме того, как и с [[SetPosition - ObjectReference|SetPosition]], MoveTo не учитывает поверхность земли.
-**Для "выпрямления" или сброса угла поворота объекта, установите параметр abMatchRotation на False, или вызовите функцию [[SetAngle - ObjectReference|SetAngle]] со схожими параметрами:
+** Для "выпрямления" или сброса угла поворота объекта, установите параметр abMatchRotation на False, или вызовите функцию [[SetAngle - ObjectReference|SetAngle]] со схожими параметрами:
 <source lang="papyrus">
 myObject.MoveTo(Game.GetPlayer()) ; Или туда, где находится цель MoveTo()
@@ Строка 58: / Строка 53: @@
 * Актеры, перемещаемые, с помощью этой функции всегда имеют корректный угол поворота относительно игрового мира.
-== Баги ==
+== {{Bugs}} ==
 * Если актер уже находится в ячейке, и игрок тоже в данной ячейке но, покидает её, или возвращается в ячейку, функция MoveTo() не срабатывает. Поскольку ячейки могут быть достаточно большими в городах и многоуровневых зданиях, то могут появиться вытекающие из этого диалоги с актером вне поля зрения и/или вне зоны слышимости. Попробуйте использовать последовательность [[DisableNoWait - ObjectReference|DisableNoWait]](), MoveTo(), [[EnableNoWait - ObjectReference|EnableNoWait]](), [[EvaluatePackage - Actor|EvaluatePackage]](). Позаботьтесь, чтобы эта последовательность выполнялась вне поля зрения игрока, например при прохождении через загрузочную [[Door|дверь]].
 * По состоянию на версию 1.9, вызов Game.GetPlayer().MoveTo(AnyBedReference) приведет к тому, что глаза игрока будут закрытыми. И их снова можно будет открыть, используя консольную команду <code>showracemenu</code>, или перезапустив игру.
-== Смотрите так же ==
+== {{See Also}} ==
-−
 *[[ForceGreet (Procedure)]]
 *[[MoveToInteractionLocation - ObjectReference]]

← Предыдущая		Версия 10:32, 25 августа 2015
Строка 1:		Строка 1:
−	~~[[Файл:Symbol_error.png]] '''Статья не закончена!'''~~
−	~~[[Category:Незаконченная статья]]~~
−
	[[Category:Скриптинг]]		[[Category:Скриптинг]]
	[[Category:Papyrus]]		[[Category:Papyrus]]

@@ Строка 66: / Строка 66: @@
 * По состоянию на версию 1.9, вызов Game.GetPlayer().MoveTo(AnyBedReference) приведет к тому, что глаза игрока будут закрытыми. И их снова можно будет открыть, используя консольную команду <code>showracemenu</code>, или перезапустив игру.
-== See Also ==
+== Смотрите так же ==
 *[[ForceGreet (Procedure)]]

@@ Строка 61: / Строка 61: @@
 * Актеры, перемещаемые, с помощью этой функции всегда имеют корректный угол поворота относительно игрового мира.
-== Bugs ==
+== Баги ==
-* If an actor is already in the cell, and the player is also in the cell, leaving the cell, or arriving in the cell, MoveTo() does not function. As cells can be quite large in cities and multi-level buildings, ensuing dialogue can occur with the actor out-of-sight and/or out-of-hearing. Try [[DisableNoWait - ObjectReference|DisableNoWait]](), MoveTo(), [[EnableNoWait - ObjectReference|EnableNoWait]](), [[EvaluatePackage - Actor|EvaluatePackage]]() sequence. Take care that the sequence happens out-of-sight of the player, such as during passage through a loading [[Door|door]].
+* Если актер уже находится в ячейке, и игрок тоже в данной ячейке но, покидает её, или возвращается в ячейку, функция MoveTo() не срабатывает. Поскольку ячейки могут быть достаточно большими в городах и многоуровневых зданиях, то могут появиться вытекающие из этого диалоги с актером вне поля зрения и/или вне зоны слышимости. Попробуйте использовать последовательность [[DisableNoWait - ObjectReference|DisableNoWait]](), MoveTo(), [[EnableNoWait - ObjectReference|EnableNoWait]](), [[EvaluatePackage - Actor|EvaluatePackage]](). Позаботьтесь, чтобы эта последовательность выполнялась вне поля зрения игрока, например при прохождении через загрузочную [[Door|дверь]].
-* As of 1.9, calling Game.GetPlayer().MoveTo(AnyBedReference) will cause the Player's eyes to become stuck shut. They can only be opened again by using the showracemenu console command, or by reloading the game.
+* По состоянию на версию 1.9, вызов Game.GetPlayer().MoveTo(AnyBedReference) приведет к тому, что глаза игрока будут закрытыми. И их снова можно будет открыть, используя консольную команду <code>showracemenu</code>, или перезапустив игру.
 == See Also ==

@@ Строка 2: / Строка 2: @@
 [[Category:Незаконченная статья]]
-[[Category:Scripting]]
+[[Category:Скриптинг]]
 [[Category:Papyrus]]
-[[Category:Latent Functions]]
+[[Category:Латентные функции]]
 '''Member of:''' [[ObjectReference Script]]