CPShimmerShader
Color shimmer shader.
This shader provides color shimmer effect for the entire camera frame or the individual scene object it is attached to. Shimmering consists of randomly changing a color of the pixel for a small period of time. If used for entire camera frame effect it can be attached to an off-screen sprite. Note that unlike CPSparkleShader that provides similar effect but with gradual dimming and brightening of color, the shimmer effect employs random color selection from the given set of colors.
Value parameters
- autoStart
-
Whether to start shader right away. Default value is
false
. - colors
-
Sequence of colors to use for shimmering effect. Colors will be selected randomly from this set.
- durMs
-
Duration of the effect in milliseconds. By default, the effect will go forever. Can be changed later.
- entireFrame
-
Whether apply to the entire camera frame or just the object this shader is attached to.
- keyFrame
-
nth-frame to render the effect. For example, if key frame is
5
than the colors will change on each 5th frame and remain the same on all subsequent frames until next key frame is reached. - onDuration
-
Optional callback to call when this shader finishes by exceeding the duration specified by
durMs
parameter. Default is a no-op. - skip
-
Predicate allowing to skip certain pixel from the shader. Predicate takes a pixel (with its Z-order), and X and Y-coordinate of that pixel. Note that XY-coordinates are always in relation to the entire canvas. Typically used to skip background or certain Z-index. Default predicate returns
false
for all pixels.
Attributes
- See also
- Example
-
See CPShaderExample class for the example of using shaders.
- Source
- CPShimmerShader.scala
- Graph
-
- Supertypes