Light Switch - История изменений

Admin: /* RegisterForSingleUpdateGameTimeAt */

2013-03-16T16:27:05Z

‎RegisterForSingleUpdateGameTimeAt

Admin: /* Скрипт */

2013-03-16T14:46:54Z

‎Скрипт

Admin: /* GetCurrentHourOfDay */

2012-07-02T11:11:00Z

‎GetCurrentHourOfDay

Admin: /* Extending This Script */

2012-07-02T11:09:37Z

‎Extending This Script

Admin: /* Объяснение работы скрипта */

2012-07-02T11:07:12Z

‎Объяснение работы скрипта

Admin: /* Script Explanation */

2012-07-02T11:02:15Z

‎Script Explanation

Admin: /* Установка */

2012-07-02T11:00:32Z

‎Установка

Admin: /* Manual Light Switch */

2012-07-02T10:53:30Z

‎Manual Light Switch

Admin: /* Script */

2012-07-02T10:52:19Z

‎Script

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

2012-07-02T10:52:02Z

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

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

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

[[Category:Решения]]

== Установка ==
Скрипт на этой станице может использоваться для автоматического включения/выключения набора источников света в зависимости от времени суток. Он содержит 2 свойства, имеющих значения по-умолчанию, но их можно настроить в Creation Kit
# LightsOffTime
#* Время, в которое все источники света должны быть выключены. По-умолчанию установлено как 7:00 утра.
# LightsOnTime
#* Время, в которое все источники света должны быть включены. По-умолчанию установлено как 18:00 вечера.

In order to set this script up to be used, you'll need to either create a marker or select one of the lights to be the "master", and set it to be the [[Reference#Enable_Parent|enable parent]] of all the other lights. Then, just attach the script below to that marker or master light. If you don't want to use the default values, then either alter them in the script or override them in the Creation Kit.

==Script==
<source lang="papyrus">ScriptName TimedLightSwitch extends ObjectReference
{Controls a set of lights with a master enable parent marker with this
script attached to turn on and off at the times of the day specified
by the properties LightsOffTime and LightsOnTime}

float Property LightsOffTime = 7.0 auto
{The time at which lights should be turned off}
float Property LightsOnTime = 18.0 auto
{The time at which lights should be turned on}

float Function GetCurrentHourOfDay() global
{Returns the current time of day in hours since midnight}

float Time = Utility.GetCurrentGameTime()
Time -= Math.Floor(Time) ; Remove "previous in-game days passed" bit
Time *= 24 ; Convert from fraction of a day to number of hours
Return Time

EndFunction

Function RegisterForSingleUpdateGameTimeAt(float GameTime)
{Registers for a single UpdateGameTime event at the next occurrence
of the specified GameTime (in hours since midnight)}

float CurrentTime = GetCurrentHourOfDay()
If (GameTime < CurrentTime)
GameTime += 24
EndIf

RegisterForSingleUpdateGameTime(GameTime - CurrentTime)

EndFunction

Event OnInit()

If (GetCurrentHourOfDay() > LightsOffTime)
GoToState("LightsOff")
Else
GoToState("LightsOn")
EndIf

EndEvent

State LightsOff

Event OnBeginState()
Disable()
RegisterForSingleUpdateGameTimeAt(LightsOnTime)
EndEvent

Event OnUpdateGameTime()
GoToState("LightsOn")
EndEvent

EndState

State LightsOn

Event OnBeginState()
Enable()
RegisterForSingleUpdateGameTimeAt(LightsOffTime)
EndEvent

Event OnUpdateGameTime()
GoToState("LightsOff")
EndEvent

EndState</source>

==Script Explanation==
This script consists of 2 custom functions, one [[OnInit]] event, and two [[States_(Papyrus)|states]], each with their own [[OnBeginState]] and [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] events.

The functions are documented within the script, but just in case they're not clear:
===GetCurrentHourOfDay===
This function uses the [[Utility_Script|Utility script's]] global function, [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], and some mathematical manipulation, to get the current time of the current day as a number between 0.0 and 24.0

===RegisterForSingleUpdateGameTimeAt===
This function works as a variation of [[RegisterForSingleUpdateGameTime_-_Form|RegisterForSingleUpdateGameTime]]. The twist is that, while RegisterForSingleUpdateGameTime takes a duration as its parameter, this custom function takes the time at which the update should take place as its parameter.

So, for example, if I were to pass 7.0 as its parameter, then the next time it's 7:00 am in Skyrim, this object will have the native event [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] called on it.

===OnInit===
This event should pretty much always be used to set up your script in whatever ways are required that cannot be done when initialising properties or variables. All that's required here is that the correct state is selected depending on the current time in-game when this event runs.

If the lights should be off, then the script enters the "LightsOff" state, whereas if they should be on, then the script enters the "LightsOn" state.

===States===
The two states are nearly identical, and work sort of like mirror images of one another. Each state, when it begins, changes the enable state of the marker or master light (and therefore all other lights), and registers for a single update in game time at the time at which the state needs to change, as set by the two properties of this script.

When that time is reached, the OnUpdateGameTime event is called, which switches the script to the other state, and its OnBeginState event will run.

==Extending This Script==
The key functionality in this script is in the states. Specifically, that they both use the OnBeginState native event to set everything that needs to be set, so that the lights can be turned on or off simply by changing the state of the script. By taking advantage of this, it wouldn't be particularly difficult to, say, change the script so that the lights' state is toggled when the scripted object is activated:

===Manual Light Switch===
<source lang="papyrus">ScriptName ManualLightSwitch extends ObjectReference
{Controls a set of lights with a master enable parent
marker (EnableMarker) and a switch with this script
attached to turn on and off when the switch is activated}

ObjectReference Property EnableMarker auto
{The marker set as the enable parent of all the lights}

Event OnInit()

If (EnableMarker.IsDisabled())
GoToState("LightsOff")
Else
GoToState("LightsOn")
EndIf

EndEvent

State LightsOff

Event OnBeginState()
EnableMarker.Disable()
EndEvent

Event OnActivate(ObjectReference akActionRef)
GoToState("LightsOn")
EndEvent

EndState

State LightsOn

Event OnBeginState()
EnableMarker.Enable()
EndEvent

Event OnActivate(ObjectReference akActionRef)
GoToState("LightsOff")
EndEvent

EndState</source>

@@ Строка 91: / Строка 91: @@
 === RegisterForSingleUpdateGameTimeAt ===
-This function works as a variation of [[RegisterForSingleUpdateGameTime_-_Form|RegisterForSingleUpdateGameTime]]. The twist is that, while RegisterForSingleUpdateGameTime takes a duration as its parameter, this custom function takes the time at which the update should take place as its parameter.
+Эта функция работает как вариант функции [[RegisterForSingleUpdateGameTime_-_Form|RegisterForSingleUpdateGameTime]]. Отличие в том, что в том время, как RegisterForSingleUpdateGameTime принимает длительность в качестве параметра, эта пользовательская функция принимает в качестве параметра время в которое нужно произвести update.
-So, for example, if I were to pass 7.0 as its parameter, then the next time it's 7:00 am in Skyrim, this object will have the native event [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] called on it.
+Так, например, если бы я передал 7.0 в качестве её параметра, то в следующий раз это будет уже 7:00 утра в Skyrim, this object will have the native event [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] called on it.
 === OnInit ===

@@ Строка 88: / Строка 88: @@
 Функции описаны в самом скрипте, но если вдруг что-то не ясно:
 === GetCurrentHourOfDay ===
-Эта функция использует глобальную функцию [[Utility_Script|Utility script's]], [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], и некоторые математические манипуляции, для получения текущего времени текущего дня, как число между 0.0 и 24.0
+Эта функция использует глобальную функцию скрипта [[Utility Script|Utility Script]], [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], и некоторые математические манипуляции, для получения текущего времени текущего дня, как число между 0.0 и 24.0
 === RegisterForSingleUpdateGameTimeAt ===

@@ Строка 105: / Строка 105: @@
 When that time is reached, the OnUpdateGameTime event is called, which switches the script to the other state, and its OnBeginState event will run.
-==Extending This Script==
+== Расширяем работу скрипта ==
-The key functionality in this script is in the states. Specifically, that they both use the OnBeginState native event to set everything that needs to be set, so that the lights can be turned on or off simply by changing the state of the script. By taking advantage of this, it wouldn't be particularly difficult to, say, change the script so that the lights' state is toggled when the scripted object is activated:
+Ключевой функцией в этом скрипте являются состояния(states). Specifically, that they both use the OnBeginState native event to set everything that needs to be set, so that the lights can be turned on or off simply by changing the state of the script. By taking advantage of this, it wouldn't be particularly difficult to, say, change the script so that the lights' state is toggled when the scripted object is activated:
 === Переключение света вручную ===

@@ Строка 84: / Строка 84: @@
 == Объяснение работы скрипта ==
-This script consists of 2 custom functions, one [[OnInit]] event, and two [[States_(Papyrus)|states]], each with their own [[OnBeginState]] and [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] events.
+Этот скрипт состоит из 2 пользовательских функций, первая - событие [[OnInit]], и вторая - [[States_(Papyrus)|состояния]], каждая со своими персональными событиями [[OnBeginState]] и [[OnUpdateGameTime_-_Form|OnUpdateGameTime]].
-The functions are documented within the script, but just in case they're not clear:
+Функции описаны в самом скрипте, но если вдруг что-то не ясно:
 === GetCurrentHourOfDay ===
-This function uses the [[Utility_Script|Utility script's]] global function, [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], and some mathematical manipulation, to get the current time of the current day as a number between 0.0 and 24.0
+Эта функция использует глобальную функцию [[Utility_Script|Utility script's]], [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], и некоторые математические манипуляции, для получения текущего времени текущего дня, как число между 0.0 и 24.0
 === RegisterForSingleUpdateGameTimeAt ===

@@ Строка 11: / Строка 11: @@
 #* Время, в которое все источники света должны быть включены. По-умолчанию установлено как 18:00 вечера.
-In order to set this script up to be used, you'll need to either create a marker or select one of the lights to be the "master", and set it to be the [[Reference#Enable_Parent|enable parent]] of all the other lights. Then, just attach the script below to that marker or master light. If you don't want to use the default values, then either alter them in the script or override them in the Creation Kit.
+Для работы этого скрипта, вам нужно либо создать маркер, или выбрать один из источников света как "главный"(master), и установить его у всех других источников света в [[Reference#Enable_Parent|enable parent]]. Теперь, прицепите скрипт, что ниже, к маркеру или главному источнику света. Если вы не хотите использовать значения по-умолчанию, то либо измените их в скрипте, или переназначьте в Creation Kit.
 == Скрипт ==

@@ Строка 15: / Строка 15: @@
 == Скрипт ==
 <source lang="papyrus">ScriptName TimedLightSwitch extends ObjectReference
-{Controls a set of lights with a master enable parent marker with this
+{Управляет набором источников света главным маркером-родителем,
-script attached to turn on and off at the times of the day specified
+к которому прицеплен этот скрипт для включения и выключения света в указанное время дня
-by the properties LightsOffTime and LightsOnTime}
+в свойствах LightsOffTime и LightsOnTime}
 float Property LightsOffTime = 7.0 auto
-{The time at which lights should be turned off}
+{Время суток, в которое свет должен выключаться}
 float Property LightsOnTime = 18.0 auto
-{The time at which lights should be turned on}
+{Время суток, в которое свет должен включаться}
 float Function GetCurrentHourOfDay() global
-{Returns the current time of day in hours since midnight}
+{Возвращает текущее время суток в часах с полуночи}
 	float Time = Utility.GetCurrentGameTime()
-	Time -= Math.Floor(Time) ; Remove "previous in-game days passed" bit
+	Time -= Math.Floor(Time) ; Удаляет кусочек "предыдущего, переданного игрой значения прошедших дней"
-	Time *= 24 ; Convert from fraction of a day to number of hours
+	Time *= 24 ; Конвертирует часть дня в число часов
 	Return Time
@@ Строка 35: / Строка 35: @@
 Function RegisterForSingleUpdateGameTimeAt(float GameTime)
-{Registers for a single UpdateGameTime event at the next occurrence
+{Регистрирует для одиночного события UpdateGameTime при следующем вхождении
-of the specified GameTime (in hours since midnight)}
+указанного игрового времени GameTime (в часах с полуночи)}
 	float CurrentTime = GetCurrentHourOfDay()

@@ Строка 83: / Строка 83: @@
 EndState</source>
-==Script Explanation==
+== Объяснение работы скрипта ==
 This script consists of 2 custom functions, one [[OnInit]] event, and two [[States_(Papyrus)|states]], each with their own [[OnBeginState]] and [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] events.
 The functions are documented within the script, but just in case they're not clear:
-===GetCurrentHourOfDay===
+=== GetCurrentHourOfDay ===
 This function uses the [[Utility_Script|Utility script's]] global function, [[GetCurrentGameTime_-_Utility|GetCurrentGameTime]], and some mathematical manipulation, to get the current time of the current day as a number between 0.0 and 24.0
-===RegisterForSingleUpdateGameTimeAt===
+=== RegisterForSingleUpdateGameTimeAt ===
 This function works as a variation of [[RegisterForSingleUpdateGameTime_-_Form|RegisterForSingleUpdateGameTime]]. The twist is that, while RegisterForSingleUpdateGameTime takes a duration as its parameter, this custom function takes the time at which the update should take place as its parameter.
 So, for example, if I were to pass 7.0 as its parameter, then the next time it's 7:00 am in Skyrim, this object will have the native event [[OnUpdateGameTime_-_Form|OnUpdateGameTime]] called on it.
-===OnInit===
+=== OnInit ===
 This event should pretty much always be used to set up your script in whatever ways are required that cannot be done when initialising properties or variables. All that's required here is that the correct state is selected depending on the current time in-game when this event runs.
 If the lights should be off, then the script enters the "LightsOff" state, whereas if they should be on, then the script enters the "LightsOn" state.
-===States===
+=== States ===
 The two states are nearly identical, and work sort of like mirror images of one another. Each state, when it begins, changes the enable state of the marker or master light (and therefore all other lights), and registers for a single update in game time at the time at which the state needs to change, as set by the two properties of this script.