"Photuki" Photo Origami cube creator
(c) 2005 Michael Raley
email: Thinkways@yahoo.com

changes; (version major# . release year. month . day) 
Version 1.05.12.26 - initial design
ver 1.05.12.28 - fixed geomotry bugs in template design.
ver 1.06.01.06 - TL/TR/BL/BR squares are now divided diagonally
                 when folded the sides layers reconstitute the
                 source image.
ver 1.06.01.12 - window adjusts itself to screen height
                 top image now mapped to 4 sections
                 size of each face and version data printed in cutout area
                 TL/BL/TR/BL labels provide orientation

Ver 2.06.01.23 - template is now drawn on pixmap. Main window uses 
                 tab controls to set global options, and image 
                 control tabs for each face.  

ver 2.06.07.23 - added white mask and crop sides options
                 added 2 new sizes to quality group
                 added missing change events for some global effects
                 moved preview/save and edit/print onto primary tab 

ver 2.09.10.14c -
                New simple print routine and button. Print relies on Preview code.
		changed behaviour of preview function to stretch the scrndib to fit the window.
		fixed misc. tabitem things 
		compiled using Euphoria 3.1.1  & Win32lib 7.0.4
		Distributed binary file is translated and compiled by Open Watcom C
		hence the 'c' version. We then UPX compress the executable.

ver 2.10.04.13c - fix to print routine corrects missing right and bottom guidelines

                  

    
What is Photuki ?

Photuki is a utility to select an 
image file, and automatically transform 
it into a template to create "waterbomb" cubes
and other Origami forms. The Photuki cube varies
from traditional waterbomb cubes by using an inside 
fold on the side tabs to create 2 'wings' along the spine.
These wings are then flipped over to create interlocking flaps. 

requirements;
1. Microsoft Windows 95,98,2000, XP, Vista
2. Screen resolution should be 800x600 or better. 1024x768 recommended
3. Bitmap, icon, jpeg, or other type of image files.
   Photuki will automatically scale the image, but
   you'll get better results if you crop and scale it down  
   manually before using photuki.  
4. a printer capable of near photo quality output. 
5. Freeimage.dll (included) must be in same folder as Photuki.exe (depreceated) and Photuki2.exe


License information:
Photuki is an end user product provided free of charge 
with the understanding it is for personal or educational use.
 We require that you do not use the name "Photuki" in conjuction with retail activities,
 use this software for retail or marketing related purposes of any kind,  
 or bundle this software for resale purposes without written permission of
 the author(s). No warranty on fitness for use of this utility is expressed or implied. 

Copying, use or Modification of source code routines for use in other programs is allowable only for
 the primary source file; i.e. "photuki.exw". Such activities may credit Photuki,
 but not infringe upon our control of the product name "Photuki". 

 These privelleges does not extend to the related software and support libraries credited below.

"Euphoria" interpreter distribution from RDS
Win32lib.ew 
Win32dib.e and Freedib.e 

The FreeImage public license (FIPL) for FreeImage has been included in this distribution
and must remain with any comercial software distribution using FreeImage.
See http://freeimage.sourceforge.net/ for more details

Procedure:
1. double click on Photuki2.exe 
   an Open file dialog will appear.
2. Select an image file (bitmap, Jpeg, Gif, icon ) to use in your Photuki session.
3. press "Open"
	The photuki control window will open showing the 
  global options tab. Press "Preview/Save" to see the
  completed template . At the preview window you are 
  prompted to save this template. The default
  file name is "photuki.bmp" in the photuki program folder.
  You may change this before preview/save,
  by overtyping the filename in the export file field at
  the bottom of the global options tab. 

  Once saved the "send to Edit" button becomes active.
  Photuki calls whichever application is associated with the "Edit" 
  action for bitmap file types in Windows. If you have not installed
  any photo editing programs then this application would be Microsoft Paint.
  Refer to the documentation for those applications on printing images.



 4. See http://modulareality.org/photuki
   for various folding instructions

  ************* NEW IN VERSION 2 ****************
 version two adds several new features to control image output 

1. Image load logic- Photuki now allows more than one image on a template. 
    By default all sides are locked to the front image settings. Clicking
    on any other image tab and selecting a new file by clicking on the 
    filename button, or selecting "Photuki colorize scheme" turns this off. 
2. colors used to draw the template background, octogon and guidelines
    may be modified.
3.  You now have nine choices for the quality ( # of pixels horizontal and vertical)
    that are generated per cube face. The higher the number of pixels 
    the larger the size of the output file. Selecting a higher number may
    reduce artifact effects created when Photuki scales a larger image down. 
    To prevent artifacts you should manually crop and resize images before 
    loading into Photuki. 
4. Global and image effects;
   . Printed info;i.e. locators and version information may be turned off
   . guidelines may be turned off. 
   . the octogon pattern may be turned off
   . Image(s) may be flipped horizontally and vertically. 
   . colorize to background - alters the color presentation of an image
   . Photuki Colorize scheme- sets each face to a fixed colorize scheme.
      Left is blue ,red is right, etc...
      Photuki colorize overides "colorize to background" in which case
      "colorize to background" affects image tone instead. 
      Selecting this scheme implicitly turns off "lock all sides to front"

   these options were added to 2.06.07.23 
   . White mask - blanks out areas that are normally hidden when folded into a cube. 
   . crop sides - discards the template's side information. The resultant image allows using 
       more of the length of standard letters size paper for printing, which means a larger
       but less sturdy cube.       


  -- PRINT --
  In Ver 2.09.10.14c we added a simple print routine. Click the print button
  and choose your printer to send the image to. If you selected "crop sides" 
  then photuki uses the entire length of the page (assuming 8.5x11 paper).
  If you find the proportions incorrect we suggest sending the file to an 
  image editor instead.  


  ------------------------------------NOTES------------------------------------

   Artifacts can occur in images when they are stretched or scaled. You may notice artifacts in two cases
   1. induvidual cube face photos. Change the Quality setting on the global tab until the images on the face tabs look reasonable.
   2. During Preview/Save or Preview Print. The entire template is scaled to the screen. This is a superficial effect.
      use the indivial face tab photos to determine best quality fit. 
   3. It'S best to edit your photo's before Photuki, crop and size them to be nearly uniform.

   Memory usage: Photuki can use up a lot of memory, espicially if you combine options that 
   require unchecking "all sides locked to front" with high quality and printing . Over time this can degrade your operating environment. 
   Exiting Photuki when done will release those resources. 


Development Credits;
Photuki was programmed in the Euphoria language provided by Robert Craig/RDS 
http://www.rapideuphoria.com

Windows support library:
Win32Lib version 6+ by the win32lib team

Bitmap manipulation and multiple image format support;
Win32dib and Freedib 0.4.2 by Tommy Carlier
http://users.telenet.be/tommycarlier/eu/

Freeimage.dll from the FreeImage project
http://freeimage.sourceforge.net/