canvas::gradient(3tk)

📦
version 0.9 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 canvas::gradient — bestie edition 💖

okay so this is the manual page for canvas::gradient, living in the canvas corner of tklib (it's a section 3tk page, iykyk). It's literally "Variations on a canvas" and it's about giving your canvas a gradient background. slay. 🦋

✨ 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?...

like, Tcl 8.5 minimum, Tk 8.5 minimum, and the package itself is version 0.2 (but you don't have to ask for a version, the ?0.2? part is optional 💅).

🌸 DESCRIPTION 🌸

This package hands you a command that sets background gradients on canvases. that's the whole job. it does it gorgeously. ✨

NOTE! This package reserves the canvas tag canvas::gradient for its own use. bestie. do not touch it. it's hers. 🙈

💅 API 💅

  • ::canvas::gradient pathName ?options?... — Creates a background gradient on the canvas pathName. and listen: if a gradient already exists there, the new definition replaces it. out with the old, in with the new, no cap. 👑

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

⭐ OPTIONS ⭐

  • -direction direction — this one says which way the gradient goes. If you don't specify it, the system defaults to x, a horizontal gradient. The package supports five directions, and they are:
    • x — a horizontal gradient (default). Color changes along the x-axis, with the start color at the left. ⬅️➡️
    • y — a vertical gradient. Color changes along the y-axis, with the start color at the top. ⬆️⬇️
    • d1 — a diagonal gradient from left+top to bottom+right. Color changes along the diagonal, with the start color at left+top. ↘️
    • d2 — a diagonal gradient from left+bottom to top+right. Color changes along the diagonal, with the start color at left+bottom. ↗️
    • r — 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 starting color of the gradient. If you don't say anything, it defaults to red. ❤️
  • -color2 color — the ending color of the gradient. If you don't say anything, it defaults to green. 💚
  • -type type — how the gradient gets calculated. The package currently supports only one method, which is the default, naturally:
    • linear — linear interpolation between the start and end colors (default). 📏

🧚 EXAMPLE 🧚

like, here's the whole vibe:

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

yellow to blue, horizontal, packed and filling. iconic. ate. 🔥

💀 BUGS, IDEAS, FEEDBACK 💀

This document, and the package it describes, will undoubtedly contain bugs and other problems. 😭 (not me being honest in the manual but ok, growth.)

Please report such in the category canvas of the Tklib Trackers at http://core.tcl.tk/tklib/reportlist.

Please also report any ideas for enhancements you may have for either the package and/or the documentation. bestie, they want your thoughts. 🫶

🔑 KEYWORDS 🔑

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

okay that's the whole page, no skips, no crumbs left behind. this came to you from tklib, version 0.2, and it's the canvas::gradient(3tk) manual page. go forth and make pretty backgrounds. 💖✨🎀🦋🌸💅🫶

📦 where this page comes from