LICENSE

- GPL: See SmileyFace.py header.

CREDITS

- SVG all around help, http://www.carto.net

- SVG emitting, http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/325823

- SVG and javascript tooltips, http://svg-whiz.com/svg/Tooltip.svg

- ReportLab toolkit and examples

AUTHORSHIP

- initial coding: Jeff Pittman, http://www.geojeff.org

DESCRIPTION

SmileyFace uses the ReportLab toolkit to generate a smiley face.

SmileyFace is a folderish Archetypes-based Plone/Zope product.  The 
idea is to use various renderers to create images, PDF files, and/or SVG 
versions of the time scale and store them.  This allows flexibility for 
a user of SmileyFace to offer several format versions, if needed.  
SmileyFace takes input of the following items:
    
- image size (width and height, in pixels)

- position (x and y of upper left corner, in pixels)

- optional freckles, entered as comma-separated values on separate lines 
  for the freckles .  Freckles are specified by:

  - x 

  - y 

  - radius

  - red, green, blue (each 0-255)


REQUIREMENTS

- Archetypes (tested with Archetypes-1.3.2-final bundle).  If you use the 
  1.2.5 version that came with Plone 2.0.5, you'll need to type in the end_time 
  value because the 0.0 default doesn't get set.  (You'll find out when you try 
  to create a time scale).

- Plone (tested with Plone-2.0.5)

- PIL (Python Imaging Library), http://www.pythonware.com/products/pil/

- ReportLab Toolkit, from http://www.reportlab.org (tested with v.  1.20)

- renderPM, from the ReportLab Toolkit, as an addon module, from: 
  http://www.reportlab.org (renderPM provides the full functionality for formats 
  other than ps and pdf)

- Adobe Acrobat Reader, for fonts, from 
  http://www.adobe.com/products/acrobat/readstep2.html.  On Linux, v.  5 
  works; not sure about the new v.  7.

PLATFORM NOTES

- So far, testing has only been done on Linux (RedHat 7.3, rhel 3.0, and Gentoo).

INSTALLATION

  1.  Install Adobe Acrobat Reader, taking note of its installation directory.

  2.  Install the ReportLab toolkit, first editing rl_config.py in the reportlab 
      directory to set the Acrobat directory, if needed, so the fonts will be 
      found by the renderer.

  3.  Install the renderPM addon from ReportLab.org.

  4.  Put SmileyFace in your Zope Products directory.

  5.  Restart Zope.

  6.  Install SmileyFace into your Plone site using CMFQuickInstaller.  
      (In Plone, select "plone setup", click on "Add/Remove Products" and install 
      SmileyFace.) You can also use the portal_quickinstaller tool from 
      the ZMI to install the Product.

BUGS AND FEATURE REQUESTS

Please report bugs and feature requests to Jeff Pittman, who can be reached at 
jeff@geojeff.org.  Jeff is often on the #plone irc channel as geojeff.

