Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
GitHub is where the world builds software
Millions of developers and companies build, ship, and maintain their software on GitHub — the largest and most advanced development platform in the world.
DESCRIPTION: This software is intended for use by painters who wish to experiment with mixing paint (virtually) and to plan palettes. See section USAGE below for more details. STATUS: This software is still under development and is only Beta standard at this time. REQUIREMENTS: There are two versions of this software: a Python3 script and a Rust compilable program. The Python3 version of the software requires: - Python 3.4.3 or later - PyGObject 3.22 or later The Rust version requires rustc 1.26.2 or later. INSTALLATION: It is NOT necessary to install this software in order to use it. All that is necessary for the Python3 version to be usable is for the base directory to be in the user's PATH environment variable. For the Rust version all that is required is for the .target/release and/or .target/debug (as appropriate) to be in the user's PATH environment variable. USAGE: The software's GUI (pcatk.py or pcatk_rs) has 2 selectable components: 1. The Palette Planner is a GUI the component that (once the user has slected some paint colours for use) enables the painter to mix new colours by specifying the number of "parts" of paint (or earlier mixed) colours to be used in a mixed colour. This mixed colour can then be saved to a list of mixed colours (along with notes about its intended use) and used in the mixing of further colours. When the painter has finished planning their palette they may print out a report to be used as a reference while completing the painting for which the palette was planned. An analysed image viewer is included as part of the palette planner and displays a number of transformations of a (user selected) digital image from which the user can copy samples for pasting into the mixed colour area for matching. 2. The Paint Series Editor is the component that enables the painter create sets of paint colours for use in the palette planner. The recommended method is to produce a "sampler" of the actual paints to be used on a suitable medium, take a digital photograph and then cut and paste from that photograph into the paint series editor where its buttons can be used to match the colour. A Colour Sample Viewer is included as part of the editor. An example colour sampler file has been added and should be loaded by the viewer the first time it is launched (and after that it should remember the last file used). TUBE SERIES: At this time, the only paint series data included in the distribution is for an imaginary set of paints known as the "Ideal Paint Colours Series" which features six colours equally spaced around the colour circle (at maximim chroma) together with black and white. This series can be found in the file "ideal.tsd" in the "data" subdirectory of the source distribution and in the directory "$ROOT/share/PaintersColourAssistant/data" in installed distributions. On Linux $ROOT should be "/usr" and to facilitate finding the file on Windows the file selector should open in that directory when the "Paint Colour Series/Open" menu option in the Palette Planner is invoked. INTERNATIONALIZATION: The Python3 code is extensively hooked for i18n but (at the moment) there is no localization available for languages other than English. BUGS: It would be greatly appreciated if any bugs encountered by users are reported by creating an issue at: <https://github.com/pwil3058/pcatk/issues> FEATURE REQUESTS: Feature requests can be made by creating an issue at: <https://github.com/pwil3058/pcatk/issues>.