##
##			Picasso Release 4.1a3
##
##			Frank Mangin - Frank.Mangin@ceram.fr
##
##

Picasso is an interactive drawing tool in the style of UNIX idraw or 
  MacDraw. Its capabilities directly derive from those of the Tk canvas 
  widget (users of picasso3.x read below).

This release is an alpha release, whose main purpose is to demonstrate 
  the cross-platform capabilities of tcl/tk. It's been tested on a HP 712 
  UNIX platform, and on a PowerMac 6100.

PLATFORMS: 
  Macintosh, UNIX, untested on PCs

REQUIRES: 
  Tcl7.5 & Tk 4.1, final release (called mactk4.1 on the Mac)

INSTALL: 
  Macintosh: - launch mactk4.1
	     - "cd" to the distribution directory, 
             - source "INSTALL.mac"
       UNIX: - modify the first line of picasso.tcl
             - cd to the distribution directory 
             - execute ./INSTALL.unix

   Warning! The main script picasso.tcl is left in place in the distribution
     directory; source or execute it to run Picasso
   The library and bitmaps subdirectories in the distribution are no longer 
     needed after installation, you can delete them
       
=========================================================================
DESCRIPTION:
-----------

  The documentation is still to be written... the following is an updated 
    version of on line help entries of picasso3.8:
    
    
  Besides basic object types like lines or rectangles, Picasso is able to 
  load and manipulate 
  image objects. Supported image formats are those of the Tk photo image type,
  currently GIF and PPM/PGM

  Picasso drawings may be saved and restored, and may also be written in 
  Encapsulated Postscript format, suitable for inclusion by latex.

  ****  Global bindings  ****

  Control q     Quit Picasso
  Control s     Save current drawing
  Control w     Save current drawing in specified file
  Control f     Load a new drawing

  Control d 	Delete selected objects
  Control 2 	Duplicate selected objects
  Control p 	Set selected object parameters
  Control a		Select all
  Control g 	Group selected objects together
  Control u 	Ungroup selected groups
  Control r		Raise selected objects
  Control l 	Lower selected objects

  Key UpArrow     Move selected objects 1 pixel upwards
  Key DownArrow   Move selected objects 1 pixel downwards
  Key RightArrow  Move selected objects 1 pixel to the right
  Key LeftArrow   Move selected objects 1 pixel to the left

  **** Group tags resetting ****

  If selection doesn't work normally (e.g. there is an item you can't 
				      select), picasso probably got lost with group tags management. You can 
  reset group tags using the "Group Reset" action in the Edit menu.
  Resetting group tags will also be necessary when loading a drawing saved 
  with picasso version 3.5 or earlier, due to a bug in group tag management.

########  Image mode button  ########

  Image objects are created from image files in PPM/PGM or GIF format.
  Once created, an image object is 
  independent of the source image file used to create it.

  ****  Image object control  ****

  zoom & subsampling"

  See the Tk photo image type documentation.

  gamma:
  
  See the Tk photo image type documentation.
}}

########  Control Frame  ########

set HelpEntries(top_optionFr) {{Control Panel} {

  Options set via the control panel are immediately applied to 
  the set of selected objects, and remain in effect for future object 
  creations.
}}

########  Control Button  ########

set HelpEntries(top_optionFr_btf) {{Option set display control} {

  As many option sets as possible are simultaneously displayed in the 
  control panel. Selecting an option set from the "Control" menu causes this 
  set to be displayed first in the panel.
}}

########  Modes  ########

set ModeHelp(SelectMode) {{Select Mode} {

  Select mode bindings:

  ButtonPress-1       	On an object, select this object alone,
  						otherwise deselect all and start region selection

  Shift-ButtonPress-1 	Adds object under the pointer to the
						set of selected objects

  Button-2            	Move the set of selected objects. If over an object,
						moves it along with selected objects.  

  ButtonPress-3			Help

  **** Note ****

  If selection doesn't work normally (e.g. there is an item you can't
	select), picasso probably got lost with group tags management.
  You can reset group tags using the "Group Reset" action in the Edit
  menu.
  Resetting group tags will also be necessary when loading a drawing
    saved with picasso version 3.5 or earlier, due to a bug in group
    tag management.
  
=========================================================================

See the CHANGES file for changes since release 4.1a1

  CHANGES since Picasso3.8
  ------------------------

Picasso4.1 is very different from the previous release. The good news is 
it runs on Macs as well as under UNIX; the bad news is this implied 
getting rid of the numerous C extensions upon which picasso3.8 relied.

  This means that Picasso4.1 is unable to read drawings generated with 
Picasso3.8. If you want to continue using pciasso3.8, you will have to stay 
with tk3.6; there may be a port of picasso3.8 with its C extensions to 
tk4.1, but this is not sure.

  The reasons for this choice is that canvas capabilities didn't progress 
much between Tk3.6 and Tk4.1: there's still no rotation, no decent image 
canvas item, no canvas coordinate rescaling... so there's no way to 
design a serious drawing tool with Tcl/Tk for now: better experiment 
with cross-platform portability, since this is were Tcl/Tk developpers 
decided to put their strengths.