piePeripheralLabeler(n)

💖 NAME — piePeripheralLabeler(n) 💖

okay so bestie, meet piePeripheralLabeler: the tkpiechart pie peripheral style labeler class. This whole manual page is piePeripheralLabeler(n), and it’s here to make the peripheral labeler make sense. periodt 💅

✨ SYNOPSIS ✨

stooop::new piePeripheralLabeler canvas ?options?

switched::configure piePeripheralLabelerObject ?options?

switched::cget piePeripheralLabelerObject option

🦋 DESCRIPTION 🦋

okay so the pie peripheral style labeler object is the slice label placer for a pie object, and you pass it into the pie constructor through its -labeler option (peep the pie class manual for that one).

The slice description text labels get arranged in 2 columns below the pie graphics. The slice values? They’re placed next to the slice and actually follow the slice as the pie is updated. Each description label text sits to the right of a rectangle, and that rectangle’s background color matches its corresponding slice. Each description label is actually a canvasLabel object.

And no need to delete a piePeripheralLabeler object — it is automatically handled by the pie class. slay 💅

• stooop::new piePeripheralLabeler canvas ?options? — creates a piePeripheralLabeler object in the specified Tk canvas. The piePeripheralLabeler object identifier is returned, and this doc calls it piePeripheralLabelerObject.
• switched::configure piePeripheralLabelerObject ?options? — configures a piePeripheralLabeler object, or returns all the options with their current values if no options are passed as parameters.
• switched::cget piePeripheralLabelerObject option — returns an option value for the specified piePeripheralLabeler object.

🌸 OPTIONS 🌸

• -font value — specifies a font for the slice labels. If not specified, the default font is system dependent.
• -justify value — specifies how to justify labels within their own column. Must be one of left, center or right. Defaults to left. For example, if justification is right, all column labels’ right edges are aligned.
• -offset value — specifies the distance between the pie graphics and the closest slice label. This value may be specified in any of the forms described in the canvas COORDINATES manual section.
• -smallfont — specifies a font for the slice values. It is usually a small font in order to avoid values overlapping when 2 slices are very close to each other. If not specified, the description label font (-font option) is used.
• -widestvaluetext — specifies a string of maximum width for slice values (placed around the pie next to the slices), so that enough room is allocated for these value labels when the pie width and height are set. It defaults to 00.0. For example, it could be set to "00.00 %".

🏷️ TAGS 🏷️

The labeler has this specific tag (see the canvas manual page ITEM IDS AND TAGS section for more information):

• piePeripheralLabeler(piePeripheralLabelerObject)

😭 BUGS, IDEAS, FEEDBACK 😭

ngl, this document and the package it describes will 100% contain bugs and other problems. Please report those in the tkpiechart category 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. 💌

👀 SEE ALSO 👀

go say hi to canvasLabel, pie, and pieBoxLabeler 💖

🔑 KEYWORDS 🔑

canvas, labeler, pie, slice

💜 COPYRIGHT 💜

Copyright (c) 1995-2004 Jean-Luc Fontaine <jfontain@free.fr>

---

okay that’s the whole thing, bestie 🫶 — this page is from tklib 6.6, the footer does not list a date, and the manual name is piePeripheralLabeler(n). periodt ✨💅