canvas::gradient(n)         Variations on a canvas         canvas::gradient(n)



______________________________________________________________________________

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(n)
