home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / shpwn200.zip / shapewin.200 / README_en.txt < prev    next >
Text File  |  2001-12-06  |  5KB  |  138 lines
  1.  
  2.  
  3.         ShapeWindow - Shape (non-rectangular) Window for OS/2        
  4.         
  5.                     Version 2.00, Dec, 2001
  6.  
  7.         Copyright (C) 1998-2001 Software Research Associates, Inc.
  8.  
  9. License
  10.  
  11.     This library is free software; you can redistribute it and/or
  12.     modify it under the terms of the GNU Lesser General Public
  13.     License as published by the Free Software Foundation; either
  14.     version 2.1 of the License, or (at your option) any later version.
  15.  
  16.     This library is distributed in the hope that it will be useful,
  17.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  18.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19.     Lesser General Public License for more details.
  20.  
  21.     You should have received a copy of the GNU Lesser General Public
  22.     License along with this library; if not, write to the Free Software
  23.     Foundation, Inc., 
  24.     59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  25.     
  26.     GNU Lesser General Public License   LGPL_en.txt english
  27.                                         LGPL_ja.txt japanese
  28.  
  29.     Bitmaps in 'bitmaps' directory are converted (to OS/2 bitmap) from
  30.     Mr. Watanabe's (mailto:go@denpa.org) products under his permission.
  31.     You can find original pictures in
  32.         
  33.     XMulti  (http://www.denpa.org/~go/xmulti)
  34.     XMascot (http://cclub-flying.dsl.gr.jp/products/xmascot/)
  35.                 (http://cclub-flying.dsl.gr.jp/products/xmascot/dokyu2.html)
  36.  
  37.     Those characters are derived from 
  38.         ToHeart                 by Leaf (http://leaf.aquaplus.co.jp/)
  39.     Dokyusei2 (AKA nanpa2)  by Elf  (http://www.elf-game.co.jp/)
  40.     and they hold rights on them. They, both, permit derived work (such
  41.     as these bitmaps) distributed as hobby materials (no for commercial).
  42.  
  43. Description
  44.  
  45.     ShapeWindow is a custom control (widget) to implement shape (non
  46.     rectangular) window for OS/2 PM.  This package also contains 3
  47.     sample programs which uses shape window.
  48.  
  49.     See 'shapewin_en.txt' and sample sources how to use shape window 
  50.     control.
  51.  
  52.     3 sample programs are:
  53.     
  54.         trbitmap.exe    display bitmap with transparent background
  55.     tranime.exe     animeation with several bitmaps
  56.     treys.exe       'xeyes' look-a-like
  57.  
  58.     You can try these programs as below.
  59.     
  60.     trbitmap bitmaps\misa.bmp
  61.     
  62.         Shows 'MISA' bitmap on your desktop. You can move picture with
  63.         dragging right mouse button.  To stop it, click right mouse 
  64.         button and select'exit'.  Move it over another window and see
  65.         effect of shape window.
  66.  
  67.     tranime bitmaps\multi*.bmp
  68.     
  69.         It shows control dialog.  'start' starts animation, 'stop' stops
  70.         animation, and 'exit' to exit program.  On start, 'MULTI'
  71.         sweeps your desktop.
  72.  
  73.     treyes
  74.     
  75.         It shows eyes on your desktop.  Eye ball tracks your mouse 
  76.         movement.  You can move eyes with draggin right mouse button.  
  77.         You can bring up popup menu by clicking right mouse button, and 
  78.     you can move, resize, stop from it.  When selected 'size', you
  79.         see thin border around eyes, and move mouse to edge make resize
  80.         on that edge.
  81.     
  82.     Detailed usages of these programs are desribed in manual pages in 
  83.     'samples' directory.
  84.     
  85.         trbitmap_en.txt
  86.     tranime_en.txt
  87.     treyes_en.txt
  88.  
  89.     Notes that these sample program eat lot of CPU.  It bit heavy on 
  90.     home PC (486/66), but not so heavy on company's (older) Pentium 100 
  91.     PC, and almost no problems on current Pentium 800 PC.  Anyway, large
  92.     bitmap, complicated bitmap result slow down your machine.  So before
  93.     you use large, complicated bitmaps, try little bitmaps first.
  94.     
  95. Update Histry
  96.  
  97.     2.00        changed license, bug fix
  98.     
  99.         Make library into DLL, and changed license from GPL to LGPL.  
  100.     I hope more 'nanjaku' prorgrams for OS/2.
  101.  
  102.     Included bug fix from Masami Kitamura <masamik@attglobal.net>.
  103.         It fixes hpsMask (other than hpsDraw) works well.
  104.  
  105.     1.02        speedup
  106.     
  107.         Included speedup patch from Mr.Moeller (ulrich.moeller@rz.hu-berlin.de)
  108.         (He is author of XFolder).  With this patch CPU usage was down to
  109.     half.
  110.  
  111.     1.01        bugfix & speedup
  112.  
  113.         Appended some mouse events notify.  Included speedup patch from
  114.     Mr.Suwa (jjsuwa@ibm.net).  This patch make animation lighter,
  115.     CPU usage was down to 80% to 60% on some animation.
  116.  
  117.     1.01        first release
  118.  
  119. Known Problems
  120.  
  121.     If shape window is overlapped with Java 1.3's window, it causes
  122.     system hang.  No problem with Java 1.1.8.
  123.     
  124.     With some display drivers, image on shape window becomes broken. GPI
  125.     operation seems depend on display drivers.
  126.  
  127.     'Object Desktop' causes problems, a part of bitmap is not redrawn.
  128.  
  129. Contant
  130.  
  131.     Send bug report, questions, requests to
  132.  
  133.         akira@sra.co.jp
  134.  
  135.     Newest version will placed on
  136.     
  137.         http://www.sra.co.jp/people/akira/os2/shapewin-e.html
  138.