Tint

.GameObjects.Components. Tint

Since:
  • 3.0.0
提供用于设置游戏对象色调的方法. 应作为混合物使用,而不是直接使用.

Members

(readonly) isTinted :boolean

Since:
  • 3.11.0
此游戏对象是否应用了色调? 它检查4种色调属性是否设置为值0xffffff 并且 `tintFill` 属性是 `false` .这表示游戏对象没有着色.
Type:
  • boolean

tint :number

Since:
  • 3.0.0
应用于整个游戏对象的色调值. 此属性是仅设置者.使用属性 `tintTopLeft` 等读取当前色调值.
Type:
  • number

tintBottomLeft :number

Since:
  • 3.0.0
Default Value:
  • 0xffffff
应用于游戏对象左下角顶点的色调值. 该值从游戏对象的角到中心进行插值. 该值应设置为十六进制数,即.红色为0xff0000,紫色为0xff00ff.
Type:
  • number

tintBottomRight :number

Since:
  • 3.0.0
Default Value:
  • 0xffffff
应用于游戏对象右下角顶点的色调值. 该值从游戏对象的角到中心进行插值. 该值应设置为十六进制数,即.红色为0xff0000,紫色为0xff00ff.
Type:
  • number

tintFill :boolean

Since:
  • 3.11.0
Default Value:
  • false
色调填充模式. `false` =附加色调(默认),其中顶点颜色与纹理混合. `true` =填充色调,其中顶点颜色取代纹理,但尊重纹理alpha.
Type:
  • boolean

tintTopLeft :number

Since:
  • 3.0.0
Default Value:
  • 0xffffff
应用于游戏对象左上角顶点的色调值. 该值从游戏对象的角到中心进行插值. 该值应设置为十六进制数,即.红色为0xff0000,紫色为0xff00ff.
Type:
  • number

tintTopRight :number

Since:
  • 3.0.0
Default Value:
  • 0xffffff
应用于游戏对象右上角的色调值. 该值从游戏对象的角到中心进行插值. 该值应设置为十六进制数,即.红色为0xff0000,紫色为0xff00ff.
Type:
  • number

Methods

clearTint() → {this}

Since:
  • 3.0.0
清除与此游戏对象相关的所有色调值. 立即将颜色值设置回0xffffff,并将色调类型设置为 `additive` , 这导致纹理没有可见的变化.
Returns:
此游戏对象实例.
Type
this

setTint(topLeftopt, topRightopt, bottomLeftopt, bottomRightopt) → {this}

Since:
  • 3.0.0
在此游戏对象上设置附加色调. 色调的工作原理是从游戏对象纹理中获取像素颜色值,然后 乘以色调的颜色值.您可以提供一个颜色值, 在这种情况下,整个游戏物体将被染成那个颜色.或者你可以提供一种颜色 每个角落.这些颜色在游戏对象的范围内混合在一起. 若要在设置后修改色调,请使用新值再次调用此方法,或者使用 `tint` 属性一次设置所有颜色.或者,使用属性 `tintTopLeft` ,`tintTopRight`, `tintBottomLeft` 和 `tintBottomLeft` 独立设置角颜色值. 若要移除色调,请调用 `clearTint` . 要将其从添加色调转换为基于填充的色调,请将属性 `tintFill` 设置为 `true` .
Parameters:
Name Type Attributes Default Description
topLeft number <optional>
0xffffff 应用于游戏对象左上角的色调. If no other values are given this value is applied evenly, tinting the whole 游戏对象.
topRight number <optional>
应用于游戏对象右上角的色调.
bottomLeft number <optional>
应用于游戏对象左下角的色调.
bottomRight number <optional>
应用于游戏对象右下角的色调.
Returns:
此游戏对象实例.
Type
this

setTintFill(topLeftopt, topRightopt, bottomLeftopt, bottomRightopt) → {this}

Since:
  • 3.11.0
在此游戏对象上设置基于填充的色调. 与附加色调不同,填充色调实际上取代了纹理中的像素颜色 染了色的.你可以用它来制作一些效果,比如让一个播放器闪烁 `white` 如果被什么东西撞了.您可以提供一个颜色值,在这种情况下是整个 游戏对象将以该颜色渲染.或者您可以为每个角提供一种颜色.颜色 在游戏对象的范围内混合在一起. 若要在设置后修改色调,请使用新值再次调用此方法,或者使用 `tint` 属性一次设置所有颜色.或者,使用属性 `tintTopLeft` ,`tintTopRight`, `tintBottomLeft` 和 `tintBottomLeft` 独立设置角颜色值. 若要移除色调,请调用 `clearTint` . 要将其从填充色调转换为附加色调,请将属性 `tintFill` 设置为 `false` .
Parameters:
Name Type Attributes Default Description
topLeft number <optional>
0xffffff 应用于游戏对象左上角的色调. If not other values are given this value is applied evenly, tinting the whole 游戏对象.
topRight number <optional>
应用于游戏对象右上角的色调.
bottomLeft number <optional>
应用于游戏对象左下角的色调.
bottomRight number <optional>
应用于游戏对象右下角的色调.
Returns:
此游戏对象实例.
Type
this