DOKK / manpages / debian 11 / tklib / canvas::gradient.3tk.en
canvas::gradient(3tk) Variations on a canvas canvas::gradient(3tk)


canvas::gradient - Canvas with a gradient background

package require Tcl 8.5

package require Tk 8.5

package require canvas::gradient ?0.2?

::canvas::gradient pathName ?options?...


This package provides a command to set background gradients on canvases.

NOTE! This package reserves the canvas tag canvas::gradient for its use.

::canvas::gradient pathName ?options?...
Creates a background gradient on the canvas pathName. An existing gradient is replaced by the new definition.

The set of available options is decribed below, in section Options.

The value for this option specifies the direction of the gradient. If not specified the system defaults to x, a horizontal gradient. The package supports five directions:
for a horizontal gradient (default). Color changes along the x-axis, with the start color at the left.
for a vertical gradient. Color changes along the y-axis, with the start color at the top.
for a diagonal gradient from left+top to bottom+right. Color changes along the diagonal. with the start color at left+top.
for a diagonal gradient from left+bottom to top+right. Color changes along the diagonal. with the start color at left+bottom.
for a radial gradient around the center of the viewport Color changes from the center outward, with the start color at the center.
The value for this option specifies the starting color of the gradient. If not specified it defaults to red.
The value for this option specifies the ending color of the gradient. If not specified it defaults to green.
The value for this option specifies how the gradient is calculated. The package currently supports on ly one method, which is the default, naturally:
for linear interpolation between the start and end colors (default).

	package require canvas::gradient
	canvas .c
	canvas::gradient .c -direction x -color1 yellow -color2 blue
	pack .c -fill both -expand 1

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category canvas of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist]. Please also report any ideas for enhancements you may have for either package and/or documentation.

background, canvas, color gradient, gradients, image, widget background

Copyright (c) 2013 Jarek Lewandowski, MaxJarek
Copyright (c) Origin http://wiki.tcl.tk/6100
Copyright (c) Origin http://wiki.tcl.tk/37242
Copyright (c) Origin http://wiki.tcl.tk/9079
0.2 tklib