Difference between revisions of "GetSleepState - Actor"

From the CreationKit Wiki
Jump to navigation Jump to search
imported>Henning
 
imported>Chesko
(Test information with using GetSleepState on the player.)
 
(5 intermediate revisions by 2 users not shown)
Line 17: Line 17:


The following values are returned:
The following values are returned:
*4: Sleeping, wants to wake
*0 - Not sleeping
*3: Sleeping
*2 - Not sleeping, wants to sleep
*2: Not sleeping, wants to sleep
*3 - Sleeping
*0: Not sleeping
*4 - Sleeping, wants to wake


== Examples ==
== Examples ==
Line 29: Line 29:
endIf
endIf
</source>
</source>
== Notes ==
*[[GetSleeping]] also has a return value of 1 when the actor is loading the sleep idle. This return value is not documented for this function.
*It is undocumented whether this function will work on the player. Exercise caution and update this page with the results of any tests. You may need to use [[IsPCSleeping]] instead.
**This function will return 3 when the player is using a furniture marker that causes the player to play any of the IdleBed* Anim Events. If this is a furniture marker with a Sit marker, GetSitState() will return 2 (Not sitting, wants to sit) until the player completely lays down, at which point GetSitState() will return 0 and GetSleepState() will return 3.


== See Also ==
== See Also ==
*[[Actor Script]]
*[[Actor Script]]
*[[GetSleeping]]
*[[IsPCSleeping]]

Latest revision as of 14:09, 14 October 2012

Member of: Actor Script

Gets this actor's sleep state.

Syntax[edit | edit source]

int Function GetSleepState() native

Parameters[edit | edit source]

None.

Return Value[edit | edit source]

The actor's current sleep state.

The following values are returned:

  • 0 - Not sleeping
  • 2 - Not sleeping, wants to sleep
  • 3 - Sleeping
  • 4 - Sleeping, wants to wake

Examples[edit | edit source]

; Is the actor sleeping?
if (Sleepy.GetSleepState() == 3)
  Debug.Trace("Sleepy is sleeping!")
endIf

Notes[edit | edit source]

  • GetSleeping also has a return value of 1 when the actor is loading the sleep idle. This return value is not documented for this function.
  • It is undocumented whether this function will work on the player. Exercise caution and update this page with the results of any tests. You may need to use IsPCSleeping instead.
    • This function will return 3 when the player is using a furniture marker that causes the player to play any of the IdleBed* Anim Events. If this is a furniture marker with a Sit marker, GetSitState() will return 2 (Not sitting, wants to sit) until the player completely lays down, at which point GetSitState() will return 0 and GetSleepState() will return 3.

See Also[edit | edit source]