NAME

       canvas::gradient - Canvas with a gradient background

SYNOPSIS

       package require Tcl  8.5

       package require Tk  8.5

       package require canvas::gradient  ?0.2?

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

________________________________________________________________________________________________________________

DESCRIPTION

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

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

API

       ::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.

   OPTIONS
       -direction direction
              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:

              x      for a horizontal gradient (default).  Color changes along the x-axis, with the start  color
                     at the left.

              y      for a vertical gradient.  Color changes along the y-axis, with the start color at the top.

              d1     for  a  diagonal gradient from left+top to bottom+right.  Color changes along the diagonal.
                     with the start color at left+top.

              d2     for a diagonal gradient from left+bottom to top+right.  Color changes along  the  diagonal.
                     with the start color at left+bottom.

              r      for  a  radial  gradient  around  the  center of the viewport Color changes from the center
                     outward, with the start color at the center.

       -color1 color
              The value for this option specifies the starting color of  the  gradient.   If  not  specified  it
              defaults to red.

       -color2 color
              The  value  for  this  option  specifies  the  ending  color of the gradient.  If not specified it
              defaults to green.

       -type type
              The value for this option specifies  how  the  gradient  is  calculated.   The  package  currently
              supports on ly one method, which is the default, naturally:

              linear for linear interpolation between the start and end colors (default).

EXAMPLE

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

BUGS, IDEAS, FEEDBACK

       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.

KEYWORDS

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

COPYRIGHT

       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

tklib                                                  0.2                                 canvas::gradient(3tk)