ChibiPaint Copyright (c) 2006-2008 Marc Schefer This file is part of ChibiPaint. ChibiPaint is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. ChibiPaint is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with ChibiPaint. If not, see . CHIBIPAINT ChibiPaint is an oekaki applet. A software that allows people to draw and paint online and share the result with other art enthusiasts. It's designed to be integrated with an oekaki board, a web server running dedicated software. Several are available but we don't currently provide an integrated solution for ChibiPaint. INTEGRATION ChibiPaint is still in the alpha stage of its development and the following integration specs are likely to evolve in the future. APPLET PARAMETERS Here's an example on how to integrate the applet in a html webpage JAVA NOT SUPPORTED! The parameters are: canvasWidth - width of the area on which users can draw (currently capped to 1024) canvasHeight - height of the area on which users can draw (currently capped to 1024) postUrl - url that will be used to post the resulting files (see below for more details) exitUrl - after sending the oekaki the user will be redirected to that url exitUrlTarget - optional target to allow different frames configuration loadImage - an image (png format) that will be loaded in the applet to be edited loadChibiFile - a chibifile format (.chi) multi-layer image that will be loaded in the applet to be edited NOTE: The last two parameters can be omited when they don't apply. If both loadImage and loadChibiFile are specified, loadChibiFile takes precedence POST FORMAT The applet will send the resulting png file and optionally a multi-layer chibifile format file. The files are sent as a regular multipart HTTP POST file upload, similar to the one used by form based file uploads for ease of processing by the server side script. The form data name for the png file is 'picture' and 'chibifile' for the multilayer file. The recommended extension for chibifiles is '.chi' The applet expects the server to answer with the single line reply "CHIBIOK" followed by a newline character. "CHIBIERROR" followed by an error message on the same list is the planned way to report an error but currently the applet will just ignore the error message and report a failure on any reply except CHIBIOK. PHP EXAMPLE Here's an example of how a php script might handle the applet's POST CONTACT INFORMATION Author: Marc Schefer (codexus@codexus.com)