Scroll to navigation

canvas::gradient(3tk) Variations on a canvas canvas::gradient(3tk) 





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



  

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












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








  

    0.2
    tklib