File: sky.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (115 lines) | stat: -rw-r--r-- 2,765 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.. _bpy.types.ShaderNodeTexSky:

****************
Sky Texture Node
****************

.. figure:: /images/node-types_ShaderNodeTexSky.webp
   :align: right
   :alt: Sky Texture Node.

The *Sky Texture* node generates a procedural sky. It's typically used in combination
with the :doc:`/render/shader_nodes/output/world`.


Inputs
======

Vector
   Texture coordinate to sample texture at;
   defaults to Generated texture coordinates if the socket is left unconnected.


Properties
==========

Sky Type
   Sky model to use.

   Preetham
      Based on the 1999 `paper <https://doi.org/10.1145/311535.311545>`__ by Preetham et al.
   Hosek/Wilkie
      Based on the 2012 `paper <https://cgg.mff.cuni.cz/projects/SkylightModelling/>`__ by Hosek and Wilkie.
   Nishita
      Improved version of the 1993
      `model <https://www.scratchapixel.com/lessons/procedural-generation-virtual-worlds/simulating-sky/simulating-
      colors-of-the-sky.html>`__
      by Nishita et al.

      Note that this sky type is quite bright and makes the image look overexposed with the default scene settings.
      You can reduce the Exposure setting in :menuselection:`Properties --> Render --> Film` to fix this.

Sun Direction
   Sun direction vector.

Turbidity
   Atmospheric turbidity.

   - 2: Arctic like
   - 3: clear sky
   - 6: warm/moist day
   - 10: hazy day

Ground Albedo
   Amount of light reflected from the planet surface back into the atmosphere.

Sun Disc :guilabel:`Cycles Only`
   Enable/Disable sun disc lighting.

Sun Size
   Angular diameter of the sun disc (in degrees).

Sun Intensity
   Multiplier for sun disc lighting.

Sun Elevation
   Rotation of the sun from the horizon (in degrees).

Sun Rotation
   Rotation of the sun around the zenith (in degrees).

Altitude
   The distance from sea level to the location of the camera.
   For example, if the camera is placed on a beach then a value of 0 should be used.
   However, if the camera is in the cockpit of a flying airplane then a value of 10 km will be more suitable.
   Note, this is limited to 60 km because the mathematical model only accounts
   for the first two layers of the earth's atmosphere (which ends around 60 km).

Air
   Density of air molecules.

   - 0 no air
   - 1 clear day atmosphere
   - 2 highly polluted day

Dust
   Density of dust and water droplets.

   - 0 no dust
   - 1 clear day atmosphere
   - 5 city like atmosphere
   - 10 hazy day

Ozone
   Density of ozone molecules;
   useful to make the sky appear bluer.

   - 0 no ozone
   - 1 clear day atmosphere
   - 2 city like atmosphere


Outputs
=======

Color
   Texture color output.


Examples
========

.. figure:: /images/render_shader-nodes_textures_sky_example.jpg
   :width: 200px

   Example of Sky Texture.