rsc3/doc-schelp/HelpSource/Classes/HiliteGradient.scrbl

93 lines
1.9 KiB
Racket

#lang scribble/manual
@(require (for-label racket))
@title{HiliteGradient}
A linear color fade between an outside and an inside color@section{categories}
GUI>Accessories
@section{related}
Classes/Color, Classes/Gradient
@section{description}
A linear color fade between an outside and an inside color.
@section{note}
The use of HiliteGradient is strong::not supported yet in Qt GUI::. When HiliteGradient is used in place of Color, the average gradient color will be used instead. ::
@section{classmethods}
@section{method}
new
@section{argument}
color1
An instance of Color.
@section{argument}
color2
An instance of Color.
@section{argument}
direction
@racketblock[\h:: or ]
@racketblock[\v:: for horizontal and vertical respectively. Default value is ]
@racketblock[\v::.
]
@section{argument}
steps
The resolution of the gradient. Default value is 64.
@section{argument}
frac
The center of the gradient. Default value is 0.33, i.e. off center toward the top on a vertical gradient.
@section{examples}
@racketblock[
// basic usage
(
w = Window.new.front;
v = CompositeView(w, Rect(50, 50, 200, 50));
v.background = HiliteGradient(Color.gray, Color.white);
)
// change direction and resolution
(
w = Window.new.front;
w.view.background = HiliteGradient(Color.red, Color.white, \h, 12, 0.5);
)
// almost unnoticeable variations can be pleasant
(
w = Window.new.front;
v = CompositeView(w, Rect(50,50,300,300));
c = Color.rand;
d = c.vary(0.15);
v.background = HiliteGradient(c, d, \v);
[c, d].postln
)
(
var w, k, c, d, e, c1, c2, f, g;
w = Window.new.front;
k = Slider2D(w, Rect(50, 50, 300, 300));
f = {
c = Color.rand;
d = c.vary(0.5);
e = d.vary(0.5);
};
g = {
c1 = d.hueBlend(e, k.y).round(0.01);
c2 = c.hueBlend(e, k.x).round(0.01);
k.background = HiliteGradient(c1, c2, \v)
};
f.value; g.value;
k.action = g;
k.mouseUpAction = { [c1, c2].postln };
k.keyDownAction = f; // hit any key for new color
)
::
]