SkyrimSE:ENBSeries INI Reference/Timeofday: Difference between revisions

Latest revision as of 15:00, March 26, 2022

ENBSeriesINI - Timeofday

The TIMEOFDAY (ToD) parameters allow for precise control of when ENB effects are applied to the screen based upon Skyrim's weather system. The effect parameters themselves are delineated using dawn, sunrise, day, sunset, dusk, and night settings variants. The ToD parameters are derived directly from the DefaultClimate [0000015E] and DefaultSkyrim [00000812] TNAM records for Sunrise and Sunset Begin/End times in Skyrim.esm. Calculations for setting ToD parameters for any weather mod --given the plugin record values of the weather system-- follow the parameter descriptions below.

Defaults shipping with ENBSeries:

[TIMEOFDAY]
DawnDuration = 2.00
SunriseTime = 7.00
DayTime = 13.00
SunsetTime = 19.00
DuskDuration = 2.00
NightTime = 1.00

The following ToD definitions apply to the position of the Sun from the perspective at sea level and with East/West horizons visible without land interference (near cow tamriel 0 37). Instead of using datetime format, numeric format is expressed in floating point (0.0000... and/or 23.9999...) based on the twenty-four hour day and expressed in military time. For brevity, only one decimal place is shown in the examples.

DawnDuration

DawnDuration=(0.0...23.9)

Duration from the time at which light first appears in the sky in the East until the approx. time the sun appears in the eastern horizon (i.e., Sunrise 'Begin' as defined in the weather).

SunriseTime

SunriseTime=(0.0...23.9)

The time at which the bottom arc of the sun appears on the eastern horizon.

DayTime

DayTime=(0.0...23.9)

The time at the midpoint of day (end of DuskDuration minus begin of DawnDuration).

SunsetTime

SunsetTime=(0.0...23.9)

The time at which the bottom arc of the sun reaches the western horizon.

DuskDuration

DuskDuration=(0.0...23.9)

Duration from the approx. time the sun disappears below the western horizon (i.e., Sunset 'End' as defined in the weather) until no sunlight is detectable in the West.

NightTime

NightTime=(0.0...23.9)

The time at the midpoint of night (begin of DuskDuration minus end of DawnDuration).

Derive Baseline ToD Settings for Any Weather Mod

We have been told by the experts that this method is not really applicable to all ENB presets and weathers, but evidence indicates that it does apply a 'good' standard from which a preset developer can deviate when applying specific effects (like coloring the sun at sunrise/sunset), so we know it is valid if not restrictive of certain creative trickery employed by some preset authors:

This formula returns the default ToD values shipping with ENBSeries (for weather mods defining sunrise/sunset from 5-9).
This formula returns phinix's values (for vanilla weather sunrise/sunset times) as evidenced by this post.
Note that Dawn/DuskDuration was doubled in some presets, but this does not appear to be the case with Boris' defaults shipping with ENBSeries.

Let the following represent the decimal values of the TNAM records for Sunrise and Sunset for the weather mod.

if ...

r₀ = Sunrise (DawnDuration) begin time

r₁ = Sunrise (DawnDuration) end time

s₀ = Sunset (DuskDuration) begin time

s₁ = Sunset (DuskDuration) end time

then ...

DawnDuration = (r₁ - r₀) / 2

SunriseTime = r₀ + DawnDuration

DayTime = r₁ + (s₀ - r₁) / 2

DuskDuration = (s₁ - s₀) / 2

SunsetTime = s₀ + DuskDuration

NightTime = r₀ - (24 - s₁ + r₀) / 2

Vanilla SSE

Skyrim.esm

Sunrise Begin = r₀ = 5:30:00 AM
Sunrise End = r₁ = 10:00:00 AM
Sunset Begin = s₀ = 4:00:00 PM
Sunset End = s₁ = 8:30:00 PM

[TIMEOFDAY]
DawnDuration = 2.25
SunriseTime = 7.75
DayTime = 13.00
SunsetTime = 18.25
DuskDuration = 2.25
NightTime = 1.00

Cathedral Weathers

Cathedral Weathers.esp

Sunrise Begin = r₀ = 5:0:00 AM
Sunrise End = r₁ = 9:00:00 AM
Sunset Begin = s₀ = 5:00:00 PM
Sunset End = s₁ = 9:00:00 PM

[TIMEOFDAY]
DawnDuration = 2.00
SunriseTime = 7.00
DayTime = 13.00
SunsetTime = 19.00
DuskDuration = 2.00
NightTime = 1.00

Note that the above ToD parameter results are identical to the defaults shipping with ENBSeries.

Default ENB Effect Times

This is the behavior in-game when the default ToD example is used (same as the results for Cathedral Weathers).

[TIMEOFDAY]
DawnDuration = 2.00
SunriseTime = 7.00
DayTime = 13.00
SunsetTime = 19.00
DuskDuration = 2.00
NightTime = 1.00

Note that Dawn/DuskDuration span one hour and end before the start of day/night, respectively. In the Dawn/DuskDuration=4.00 situation mentioned previously, Dawn/DuskDuration will span two hours to extend for one hour into the start of day/night, repectively. This may be beneficial to the extent that it could make for smoother dawn/day and dusk/night transitions (i.e., if ToD parameters are very different).

Following are results of tweaking AmbientLightingIntensity* for each ToD setting in game using the ENB GUI (Shift + Enter) at all hours (and at most quarter hours) over 24-hours game time ... repeatedly:

Game Time	ToD Setting	Effect (observed delta)
1	night
2	night
3	night
4	night
5	night/dawn	begin night fade out, begin dawn fade in
6	dawn/sunrise	end night, begin dawn fade out, begin sunrise fade in
7	sunrise/day	end dawn, begin day fade in
8	sunrise/day
9	sunrise/day	begin sunrise fade out
10	sunrise/day
11	sunrise/day
12	day	sunrise end
13	day/sunset	begin day fade out, begin sunset fade in
14	day/sunset
15	day/sunset
16	day/sunset	begin day/sunset fade out
17	day/sunset
18	day/sunset
19	sunset/dusk	end day, begin sunset fade out, begin dusk fade in
20	dusk/night	end sunset, begin dusk fade out, begin night fade in
21	night	end dusk
22	night
23	night
24	night

@@ Line 1: / Line 1: @@
-{{PageTitle|logo=delta|title=ENBSeriesINI - Timeofday}}__NOTOC__[[Category:Configuration Settings]][[Category:ENB Guides]]
+{{PageTitle|logo=delta|title=ENBSeriesINI - Timeofday}}__NOTOC__[[Category:ENB Settings]]
-The time of day (TOD) parameters allow for precise control of when dawn, sunrise, day, sunset, dusk, and night start using the game's time data. These parameters control when specific TOD related settings are applied, thus, they should match the in-game settings (which could be vanilla or altered by a mod). All values use a floating point number based on a twenty-four hour day (0.0...23.9).
+The TIMEOFDAY (ToD) parameters allow for precise control of when ENB effects are applied to the screen based upon Skyrim's weather system. The effect parameters themselves are delineated using dawn, sunrise, day, sunset, dusk, and night settings variants. The ToD parameters are derived directly from the DefaultClimate [0000015E] and DefaultSkyrim [00000812] TNAM records for Sunrise and Sunset Begin/End times in Skyrim.esm. [[SkyrimSE:ENBSeries_INI_Reference/Timeofday#Derive Correct ToD Settings for Any Weather Mod|Calculations for setting ToD parameters for any weather mod]] --given the plugin record values of the weather system-- follow the parameter descriptions below.
+Defaults shipping with ENBSeries:
+<pre>[TIMEOFDAY]
+DawnDuration = 2.00
+SunriseTime = 7.00
+DayTime = 13.00
+SunsetTime = 19.00
+DuskDuration = 2.00
+NightTime = 1.00</pre>
+The following ToD definitions apply to the position of the Sun from the perspective at sea level and with East/West horizons visible without land interference (near cow tamriel 0 37). Instead of using datetime format, numeric format is expressed in floating point (0.0000... and/or 23.9999...) based on the twenty-four hour day and expressed in military time. For brevity, only one decimal place is shown in the examples.
 === DawnDuration ===
 <syntaxhighlight lang="ini">DawnDuration=(0.0...23.9)</syntaxhighlight>
-This parameter controls the length of time the fade from from NightTime to Sunrise values takes in game hours (when the sky starts to light but before the sun can be seen).
+Duration from the time at which light first appears in the sky in the East until the approx. time the sun appears in the eastern horizon (i.e., Sunrise 'Begin' as defined in the weather).
 === SunriseTime ===
 <syntaxhighlight lang="ini">SunriseTime=(0.0...23.9)</syntaxhighlight>
-This setting is the time that the sunrise occurs in game.
+The time at which the bottom arc of the sun appears on the eastern horizon.
 === DayTime ===
 <syntaxhighlight lang="ini">DayTime=(0.0...23.9)</syntaxhighlight>
-This setting is the time that the middle of the day occurs in game.
+The time at the midpoint of day (end of DuskDuration minus begin of DawnDuration).
 === SunsetTime ===
 <syntaxhighlight lang="ini">SunsetTime=(0.0...23.9)</syntaxhighlight>
-This setting is the time that the sunset occurs in game.
+The time at which the bottom arc of the sun reaches the western horizon.
 === DuskDuration ===
 <syntaxhighlight lang="ini">DuskDuration=(0.0...23.9)</syntaxhighlight>
-This parameter is the duration that the transition from sunset settings fades to night settings in game hours. Basically this is the time from when the sun sets and can't be seen (SunsetTime) to the time set for NightTime.
+Duration from the approx. time the sun disappears below the western horizon (i.e., Sunset 'End' as defined in the weather) until no sunlight is detectable in the West.
 === NightTime ===
 <syntaxhighlight lang="ini">NightTime=(0.0...23.9)</syntaxhighlight>
-This setting is the time that the middle of the night occurs in game.
+The time at the midpoint of night (begin of DuskDuration minus end of DawnDuration).
+===Derive Baseline ToD Settings for Any Weather Mod===
+We have been told by the experts that this method is not really applicable to '''all''' ENB presets and weathers, but evidence indicates that it '''does''' apply a 'good' standard from which a preset developer can deviate when applying specific effects (like coloring the sun at sunrise/sunset), so we know it is valid if not restrictive of certain creative  trickery employed by some preset authors:
+# This formula returns the default ToD values shipping with ENBSeries (for weather mods defining sunrise/sunset from 5-9).
+# This formula returns phinix's values (for vanilla weather sunrise/sunset times) as evidenced by [http://enbseries.enbdev.com/forum/viewtopic.php?p=42046#p42046 this post].
+# Note that Dawn/DuskDuration was doubled in some presets, but this does not appear to be the case with Boris' defaults shipping with ENBSeries.
+Let the following represent the decimal values of the TNAM records for Sunrise and Sunset for the weather mod.
+:  if ...
+:: r<sub>0</sub> = Sunrise (DawnDuration) begin time
+:: r<sub>1</sub> = Sunrise (DawnDuration) end time
+:: s<sub>0</sub> = Sunset (DuskDuration) begin time
+:: s<sub>1</sub> = Sunset (DuskDuration) end time
+:  then ...
+:: DawnDuration = (r<sub>1</sub> - r<sub>0</sub>) / 2
+:: SunriseTime = r<sub>0</sub> + DawnDuration
+:: DayTime = r<sub>1</sub> + (s<sub>0</sub> - r<sub>1</sub>) / 2
+:: DuskDuration = (s<sub>1</sub> - s<sub>0</sub>) / 2
+:: SunsetTime = s<sub>0</sub> + DuskDuration
+:: NightTime = r<sub>0</sub> - (24 - s<sub>1</sub> + r<sub>0</sub>) / 2
+==== Vanilla SSE ====
+: '''Skyrim.esm'''
+:* Sunrise Begin = r<sub>0</sub> = 5:30:00 AM
+:* Sunrise End = r<sub>1</sub> = 10:00:00 AM
+:* Sunset Begin = s<sub>0</sub> = 4:00:00 PM
+:* Sunset End = s<sub>1</sub> = 8:30:00 PM
+<pre>[TIMEOFDAY]
+DawnDuration = 2.25
+SunriseTime = 7.75
+DayTime = 13.00
+SunsetTime = 18.25
+DuskDuration = 2.25
+NightTime = 1.00</pre>
+==== Cathedral Weathers ====
+: '''Cathedral Weathers.esp'''
+:* Sunrise Begin = r<sub>0</sub> = 5:0:00 AM
+:* Sunrise End = r<sub>1</sub> = 9:00:00 AM
+:* Sunset Begin = s<sub>0</sub> = 5:00:00 PM
+:* Sunset End = s<sub>1</sub> = 9:00:00 PM
+<pre>[TIMEOFDAY]
+DawnDuration = 2.00
+SunriseTime = 7.00
+DayTime = 13.00
+SunsetTime = 19.00
+DuskDuration = 2.00
+NightTime = 1.00</pre>
+{{Fc|salmon|Note that the above ToD parameter results are identical to the defaults shipping with ENBSeries.}}
+=== Default ENB Effect Times ===
+This is the behavior in-game when the default ToD example is used (same as the results for Cathedral Weathers).
+<pre>[TIMEOFDAY]
+DawnDuration = 2.00
+SunriseTime = 7.00
+DayTime = 13.00
+SunsetTime = 19.00
+DuskDuration = 2.00
+NightTime = 1.00</pre>
+Note that Dawn/DuskDuration span one hour and end before the start of day/night, respectively. In the <code>Dawn/DuskDuration=4.00</code> situation mentioned previously, Dawn/DuskDuration will span two hours to extend for one hour into the start of day/night, repectively. This may be beneficial to the extent that it could make for smoother dawn/day and dusk/night transitions (i.e., if ToD parameters are very different).
+Following are results of tweaking <code>AmbientLightingIntensity*</code> for each ToD setting in game using the ENB GUI (Shift + Enter) at all hours (and at most quarter hours) over 24-hours game time ... repeatedly:
+{| class="wikitable" style="width:65%; float:left;"
+! Game<br>Time
+! ToD<br>Setting
+! style="text-align:left;" |  &nbsp; Effect<br>&nbsp; (observed delta)
+|-
+! style="color:#aa88e8;" | 1
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#aa88e8;" | 2
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#aa88e8;" | 3
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#aa88e8; " | 4
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#4bb073;" | 5
+| style="color:#4bb073; text-align:center;" | night/dawn
+| style="color:#4bb073;" | begin night fade out, begin dawn fade in
+|-
+! style="color:#4bb073;" | 6
+| style="color:#4bb073; text-align:center;" | dawn/sunrise
+| style="color:#4bb073;" | end night, begin dawn fade out, begin sunrise fade in
+|-
+! style="color:#9ead48;" | 7
+| style="color:#9ead48; text-align:center;" | sunrise/day
+| style="color:#9ead48;" | end dawn, begin day fade in
+|-
+! style="color:#9ead48;" | 8
+| style="color:#9ead48; text-align:center;" | sunrise/day
+|
+|-
+! style="color:#9ead48;" | 9
+| style="color:#9ead48; text-align:center;" | sunrise/day
+| style="color:#9ead48;" | begin sunrise fade out
+|-
+! style="color:#e0b438;" | 10
+| style="color:#e0b438; text-align:center;" | sunrise/day
+|
+|-
+! style="color:#e0b438;" | 11
+| style="color:#e0b438; text-align:center;" | sunrise/day
+|
+|-
+! style="color:#e0b438;" | 12
+| style="color:#e0b438; text-align:center;" | day
+| style="color:#e0b438;" | sunrise end
+|-
+! style="color:#f09047;" | 13
+| style="color:#f09047; text-align:center;" | day/sunset
+| style="color:#f09047;" | begin day fade out, begin sunset fade in
+|-
+! style="color:#f09047;" | 14
+| style="color:#f09047; text-align:center;" | day/sunset
+|
+|-
+! style="color:#f09047;" | 15
+| style="color:#f09047; text-align:center;" | day/sunset
+|
+|-
+! style="color:#ff7077;" | 16
+| style="color:#ff7077; text-align:center;" | day/sunset
+| style="color:#ff7077;" | begin day/sunset fade out
+|-
+! style="color:#ff7077;" | 17
+| style="color:#ff7077; text-align:center;" | day/sunset
+|
+|-
+! style="color:#ff7077;" | 18
+| style="color:#ff7077; text-align:center;" | day/sunset
+|
+|-
+! style="color:#d96dc9;" | 19
+| style="color:#d96dc9; text-align:center;" | sunset/dusk
+| style="color:#d96dc9;" | end day, begin sunset fade out, begin dusk fade in
+|-
+! style="color:#d96dc9;" | 20
+| style="color:#d96dc9; text-align:center;" | dusk/night
+| style="color:#d96dc9;" | end sunset, begin dusk fade out, begin night fade in
+|-
+! style="color:#aa88e8;" | 21
+| style="color:#aa88e8; text-align:center;" | night
+| style="color:#aa88e8;" | end dusk
+|-
+! style="color:#aa88e8;" | 22
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#aa88e8;" | 23
+| style="color:#aa88e8; text-align:center;" | night
+|
+|-
+! style="color:#aa88e8;" | 24
+| style="color:#aa88e8; text-align:center;" | night
+|
+|}
+{{clear|left}}
+<!--
 == Understanding the Durations ==
 The two ''Duration'' settings can be confusing to understand. They are essentially timers for the fade effect between two sets of parameters ([https://enbseries.enbdev.com/forum/viewtopic.php?f=2&t=1939#p27189 Reference]).
@@ Line 74: / Line 264: @@
 #: <code>({{fc|orange|SunsetTime}} - ''DuskDuration'') = {{fc|salmon|DuskStart}}</code> <i class="fas fa-grip-lines-vertical px-2"></i> <code>({{fc|orange|19}} - ''DuskDuration'') = {{fc|salmon|17}}</code> <i class="fas fa-grip-lines-vertical px-2"></i> <code>''DuskDuration'' = 2</code>
 #: <p class="mpcode">DawnDuration=2.0<br>SunriseTime=7.0<br>DayTime=9.0<br>SunsetTime=15.0<br>DuskDuration=2.0<br>NightTime=21.0</p>
+-->