init(colorTemperatureGradientFrom:toColorTemperature:name:textureDimensions:)
Initializes a texture that creates a vertical gradient between two color temperatures.
Declaration
init(colorTemperatureGradientFrom colorTemperature1: Float, toColorTemperature colorTemperature2: Float, name: String?, textureDimensions: vector_int2)Parameters
- colorTemperature1:
The black-body color temperature, in Kelvins, at the top of the gradient.
- colorTemperature2:
The black-body color temperature, in Kelvins, at the bottom of the gradient.
- name:
The Name property for the new texture object.
- textureDimensions:
The texel dimensions (width and height) of the texture image.
Return Value
A new color swatch texture object.
Discussion
Real-world light sources often measure color of illumination based on a black-body temperature scale. For example, the colors and characterizations of typical home and office light fixtures correspond to the following temperatures:
Label | Color | Temperature |
|---|---|---|
“Soft white” | Warm, yellowish white | 2700 K |
“Bright white” | Pale yellowish white | 3000 K |
“Daylight” | Bright, slightly greenish white | 5000 K |
“Cool daylight” | Bright, slightly bluish white | 6500 K |
This initializer does not generate texel data; the MDLColorSwatchTexture class automatically generates data and caches it for reuse when you use one of the MDLTexture methods listed in Accessing Texture Data.