From 4638c5b7f351da1156a5f365646935510b67d97a Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Fri, 2 Oct 1998 16:20:14 +0000 Subject: Docstring --- Tools/pynche/StripViewer.py | 26 ++++++++++++++++++++++++++ Tools/pynche/Switchboard.py | 14 ++++++++++++++ Tools/pynche/TextViewer.py | 19 ++++++++++++++++++- 3 files changed, 58 insertions(+), 1 deletion(-) diff --git a/Tools/pynche/StripViewer.py b/Tools/pynche/StripViewer.py index db825e3..c6e2fbe 100644 --- a/Tools/pynche/StripViewer.py +++ b/Tools/pynche/StripViewer.py @@ -1,3 +1,29 @@ +"""Strip viewer and related widgets. + +The classes in this file implement the StripViewer shown in the top two thirds +of the main Pynche window. It consists of three StripWidgets which display +the variations in red, green, and blue respectively of the currently selected +r/g/b color value. + +Each StripWidget shows the color variations that are reachable by varying an +axis of the currently selected color. So for example, if the color is + + (R,G,B)=(127,163,196) + +then the Red variations show colors from (0,163,196) to (255,163,196), the +Green variations show colors from (127,0,196) to (127,255,196), and the Blue +variations show colors from (127,163,0) to (127,163,255). + +The selected color is always visible in all three StripWidgets, and in fact +each StripWidget highlights the selected color, and has an arrow pointing to +the selected chip, which includes the value along that particular axis. + +Clicking on any chip in any StripWidget selects that color, and updates all +arrows and other windows. By toggling on Update while dragging, Pynche will +select the color under the cursor while you drag it, but be forewarned that +this can be slow. +""" + import string from Tkinter import * import ColorDB diff --git a/Tools/pynche/Switchboard.py b/Tools/pynche/Switchboard.py index aaf67ab..503752e 100644 --- a/Tools/pynche/Switchboard.py +++ b/Tools/pynche/Switchboard.py @@ -1,3 +1,17 @@ +"""Switchboard class. + +This class is used to coordinate updates among all Viewers. Every Viewer must +conform to the following interface: + + - it must include a method called update_yourself() which takes three + arguments; the red, green, and blue values of the selected color. + + - When a Viewer selects a color and wishes to update all other Views, it + should call update_views() on the Switchboard object. Not that the + Viewer typically does *not* update itself before calling update_views(), + since this would cause it to get updated twice. +""" + class Switchboard: def __init__(self, colordb): self.__views = [] diff --git a/Tools/pynche/TextViewer.py b/Tools/pynche/TextViewer.py index 9fdab07..9e77a02 100644 --- a/Tools/pynche/TextViewer.py +++ b/Tools/pynche/TextViewer.py @@ -1,3 +1,20 @@ +"""TextViewer class. + +The TextViewer allows you to see how the selected color would affect various +characteristics of a Tk text widget. This is an output viewer only. + +In the top part of the window is a standard text widget with some sample text +in it. You are free to edit this text in any way you want (TBD: allow you to +change font characteristics). If you want changes in other viewers to update +text characteristics, turn on Track color changes. + +To select which characteristic tracks the change, select one of the radio +buttons in the window below. Text foreground and background affect the text +in the window above. The Selection is what you see when you click the middle +button and drag it through some text. The Insertion is the insertion cursor +in the text window (which only has a background). +""" + import sys from Tkinter import * from pynche import __version__ @@ -30,7 +47,7 @@ textual displays.''') self.__trackp = BooleanVar() self.__trackp.set(0) self.__which = IntVar() - self.__which.set(4) + self.__which.set(0) # # track toggle self.__t = Checkbutton(root, text='Track color changes', -- cgit v0.12