Provides methods used for setting the tint of a Game Object. Should be applied as a mixin and not used directly.
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 17)
Members
-
<readonly> isTinted :boolean
-
Does this Game Object have a tint applied to it or not?
Type:
- boolean
- Since: 3.11.0
- Source: src/gameobjects/components/Tint.js (Line 314)
-
tint :integer
-
The tint value being applied to the whole of the Game Object. This property is a setter-only. Use the properties
tintTopLeft
etc to read the current tint value.Type:
- integer
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 297)
-
tintBottomLeft :integer
-
The tint value being applied to the bottom-left of the Game Object. This value is interpolated from the corner to the center of the Game Object.
Type:
- integer
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 249)
-
tintBottomRight :integer
-
The tint value being applied to the bottom-right of the Game Object. This value is interpolated from the corner to the center of the Game Object.
Type:
- integer
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 273)
-
tintFill :boolean
-
Fill or additive?
Type:
- boolean
- Since: 3.11.0
- Default Value:
-
- false
- Source: src/gameobjects/components/Tint.js (Line 83)
-
tintTopLeft :integer
-
The tint value being applied to the top-left of the Game Object. This value is interpolated from the corner to the center of the Game Object.
Type:
- integer
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 201)
-
tintTopRight :integer
-
The tint value being applied to the top-right of the Game Object. This value is interpolated from the corner to the center of the Game Object.
Type:
- integer
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 225)
Methods
-
clearTint()
-
Clears all tint values associated with this Game Object.
Immediately sets the color values back to 0xffffff and the tint type to 'additive', which results in no visible change to the texture.
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 93)
Returns:
This Game Object instance.
-
setTint( [topLeft] [, topRight] [, bottomLeft] [, bottomRight])
-
Sets an additive tint on this Game Object.
The tint works by taking the pixel color values from the Game Objects texture, and then multiplying it by the color value of the tint. You can provide either one color value, in which case the whole Game Object will be tinted in that color. Or you can provide a color per corner. The colors are blended together across the extent of the Game Object.
To modify the tint color once set, either call this method again with new values or use the
tint
property to set all colors at once. Or, use the propertiestintTopLeft
,tintTopRight,
tintBottomLeftand
tintBottomRight` to set the corner color values independently.To remove a tint call
clearTint
.To swap this from being an additive tint to a fill based tint set the property
tintFill
totrue
.Parameters:
Name Type Argument Default Description topLeft
integer <optional>
0xffffff The tint being applied to the top-left of the Game Object. If no other values are given this value is applied evenly, tinting the whole Game Object.
topRight
integer <optional>
The tint being applied to the top-right of the Game Object.
bottomLeft
integer <optional>
The tint being applied to the bottom-left of the Game Object.
bottomRight
integer <optional>
The tint being applied to the bottom-right of the Game Object.
- Since: 3.0.0
- Source: src/gameobjects/components/Tint.js (Line 114)
Returns:
This Game Object instance.
-
setTintFill( [topLeft] [, topRight] [, bottomLeft] [, bottomRight])
-
Sets a fill-based tint on this Game Object.
Unlike an additive tint, a fill-tint literally replaces the pixel colors from the texture with those in the tint. You can use this for effects such as making a player flash 'white' if hit by something. You can provide either one color value, in which case the whole Game Object will be rendered in that color. Or you can provide a color per corner. The colors are blended together across the extent of the Game Object.
To modify the tint color once set, either call this method again with new values or use the
tint
property to set all colors at once. Or, use the propertiestintTopLeft
,tintTopRight,
tintBottomLeftand
tintBottomRight` to set the corner color values independently.To remove a tint call
clearTint
.To swap this from being a fill-tint to an additive tint set the property
tintFill
tofalse
.Parameters:
Name Type Argument Default Description topLeft
integer <optional>
0xffffff The tint being applied to the top-left of the Game Object. If not other values are given this value is applied evenly, tinting the whole Game Object.
topRight
integer <optional>
The tint being applied to the top-right of the Game Object.
bottomLeft
integer <optional>
The tint being applied to the bottom-left of the Game Object.
bottomRight
integer <optional>
The tint being applied to the bottom-right of the Game Object.
- Since: 3.11.0
- Source: src/gameobjects/components/Tint.js (Line 164)
Returns:
This Game Object instance.