1---------------------------------------------------------------- 2 * French-KISS! * 3---------------------------------------------------------------- 4* About 5 6This software fkiss - French-KISS! is a sample implementation of 7KISekae Set system (KISS) for X Window System. 8KISS is a software for playing Paper-doll on any computers. 9"Kisekae" means "changing clothes". 10 11---------------------------------------------------------------- 12* Install 13 14To make Makefile 15 % ./configure 16 17To make executable binary 18 % make 19 20And executable binary "fkiss" is created. 21 22Move this executable binary to install directory you like. 23Example 24 # mv fkiss /usr/local/bin 25 or 26 # make install 27 28"fkiss.man" is a manual source file. 29Copy this file to manual directory you like. 30Example 31 # cp fkiss.man /usr/local/man/man1/fkiss.1 32 or 33 # make install.man 34 35Copy rc file to your home directory. 36 % cp fkissrc.smp ~/.fkissrc 37 38 39That's all. Let's try! 40 41---------------------------------------------------------------- 42* Trouble in make 43 44If you cannot to make fkiss or modified something to make, 45Please tell me that: 46 French-KISS! version 47 Hardware and Operating system 48 Error messages 49 (Your changes) 50 51---------------- 52Troube! Error in configure! 53 54"configure" is a shell script file generated by GNU autoconf. 55If error reported at "/bin/sh configure", 56Check /bin/sh is really Bourne shell. 57If you cannot to use Bourne shell (What's unix system!!), 58Use bash - GNU Bourne-Again SHell. 59For example, edit "configure" line 1 60>#! /bin/sh 61change to 62>#! /usr/local/bin/bash 63 64---------------- 65Trouble! Nothing opendir library! 66>dir.o: Undefined symbol _opendir referenced from text segment 67>dir.o: Undefined symbol _readdir referenced from text segment 68>dir.o: Undefined symbol _closedir referenced from text segment 69 70Change following lines in "headers.h" 71>/* directory access routine */ 72to 73>/* directory access routine */ 74>#define USE_BSD_DIRLIB 0 75 76---------------- 77Trouble! Compile error in message.c 78 79Add "-DUSE_VARARGS" or "-DUSE_STDARG" to CFLAGS in Makefile, 80Try to re-compile. 81 82---------------- 83Other troubles! 84 85Try to use GNU product software tools 86instead of vender producted make, cc, sed, awk etc. 87Some problems will be cleared. 88For compatibility and performance, I recommend to use GNU product softwares. 89 90---------------------------------------------------------------- 91* Startup 92 93At first, get KISS data files from WWW and/or FTP-site. 94 95The Big KiSS page - http://otakuworld.com/kiss/ 96 97You can find some KISS datas 98and many favorite links on my web site "Kissin Institute of Softwear". 99Let's visit! 100 101Kissin Institute of Softwear - http://www2s.biglobe.ne.jp/~yav/ 102 103For "First KISS" users, Look sample KISS data archive "frkismi4.lzh" 104contained in this package. 105I experiment some KISS sound/animation extensions in this. 106But, these extensions are NOT KISS standards. 107And sound files are not contained. 108 109A lot of KISS data files (*.lzh) are packed with LHa archiver. 110Install LHa archiver and extract a archive file. 111And you find these files: 112 many "*.cel" (pixel) 113 some "*.kcf" (color) 114 some "*.cnf" (configuration) 115These files are extracted, Let's 116 % fkiss 117to enjoy kisekae!! 118 119None argument is specified, fkiss read "*.cnf" in a current directory. 120 121Another way to enjoy is more simple. 122 % fkiss frkismi4.lzh 123fkiss make a directory /tmp/fkiss(PID) 124and execute lha to extract files to there. 125And search "*.cnf" in it. 126 127There are some explanations about command line options in a manual. 128 % man fkiss 129to read manual. 130 131---------------------------------------------------------------- 132* Core dump! 133 134If fkiss is stopeed core dump or X error, 135Please tell me that: 136 Hardware and Operating system 137 Error messages 138and fkiss debug information output. 139To save debug information file "fkisslog" do: 140 $ fkiss -debug bugkiss.lzh 2> fkisslog 141 or 142 % fkiss -debug bugkiss.lzh >& fkisslog 143 144---------------------------------------------------------------- 145* Sound 146 147fkiss check /dev/audio device for playing sound. 148If /dev/audio is exist, fkiss open it and write startup sound data. 149This action makes critical damege to netaudio and some systems. 150If you happen this trouble, execute fkiss with "-nosound" option. 151 152On Linux or FreeBSD, fkiss use /dev/dsp instead of /dev/audio, 153and use ioctl to setup DSP sampling rate etc. Look sound.c! 154 155If you have more better sound player, Try "-sound 2" option. 156"-sound 2" option is specified, fkiss execute "play soundfile" 157command to play sound. 158 159Version 0.32 or later, fkiss use EsounD to play sound. 160 161---------------------------------------------------------------- 162* Conform 163 164fkiss is conforming to KISS/GS2 (KISS General Specification 2), 165and conforming to KISS/GS3, 4 draft. 166 167Maximum size of screen 168 Maximum value of int. 169 170Maximum number of objects 171 MAXOBJ is defined in "fkiss.h". (<= Maximum value of short) 172 173Maximum number of cells 174 MAXCEL is defined in "fkiss.h". (<= Maximum value of short) 175 176---------------------------------------------------------------- 177* Reference 178 179kissgs.doc - KISS/GS (KISS General Specification) Manual 180Document of KISS standard written in Japanese and English. 181 182---------------------------------------------------------------- 183* fkiss Extensions 184 185I use some extensions (sound, animation) in a sample "frkismi4.lzh". 186These extensions are ONLY for checking technical problems yet. 187Now we are reseaching: 188 Which functions users need? 189 What is smart, eazy, simple description style? 190These problems are resolved, we'll define advanced KISS officially. 191BUT, THAT'S FUNCTIONS AND DESCRIPTION STYLE WILL BE DIFFERENT FROM THIS! 192 193---------------------------------------------------------------- 194* Magic 195 196Add following lines at /etc/magic to identify KISS files. 197 198--------8<--------8<--------8<-------- 1990 string KiSS KISS/GS 200>4 byte 16 color 201>>5 byte x %d bit 202>>8 leshort x %d colors 203>>10 leshort x %d groups 204>4 byte 32 cell 205>>5 byte x %d bit 206>>8 leshort x %d x 207>>10 leshort x %d 208>>12 leshort x +%d 209>>14 leshort x +%d 210--------8<--------8<--------8<-------- 211 212---------------------------------------------------------------- 213* Changes 214 215v0.32 -> v0.33 (Haruka) 216GPL 217-midiplayer <MIDI player> 218 219v0.31 -> v0.32 (Onpu) 220automake is used to make Makefile.in. 221EsounD is used to play sound. 222Control-Button1 change cell mapping bug fix. 223 224v0.30 -> v0.31 225Effective area of true-colored cel calcuration bug fix. 226cnf and doc menu select ButtonRelease trig. 227unlimited timer channels. 228unlimited number of colors specified in kcf file. 229 230v0.29 -> v0.30 231FKiSS2.1 is implemented. 232MAXPATH is not used. 233dir_ls recursive. 234lha xfiqw -> lha xfqw (Extract with directory) 235if colcnt equal to zero, spx[SPX_BG] pixel for background imggc 236Object position adjust at all set position. 237%x (x is any alphabet) started token is not treated as comment in comment line. 238selcnf.c: 239 sys/stat.h -> stat.h 240sub.c: 241 stlen -> strlen 242 dos_filename2 243sound.c: 244 sound file binary mode fopen 245 246v0.28 -> v0.29 247Dirk Schenkewitz tell me fix value over-flow bug 248and MAXTIMER expansion advices. 249Someone teach me to open sound_device O_NONBLOCK on Linux. 250Supprt True color cell. 251gen_arcommand security hole fix 252 253v0.27 -> v0.28 254Clean temporary files and exit on signal detection. 255Request WM_DELETE_WINDOW message for window manager. 256Use uname library function. 257Support automatic object position adjustment. 258 259v0.26 -> v0.27 260-noimage mode core dump bug fix. 261Add document file suffix add or del option -suffix, -nosuffix. 262kisseve.c: TOKEN_LEN_MAX deleted, 263Now no limit for fkiss event extension token length. 264Support environment variable substitution in comment string. 265Add backslash escape character '\$' - dollar. 266Trigger first set event. 267Read options in "$HOME/.fkissrc". 268RIFF-WAVE (*.wav) analyze bug fix. 269 270v0.25 -> v0.26 271Document file browse function prototype. 272Press [Doc] menu or type 'd' key to browse document files. 273 274v0.24 -> v0.25 (Ruri) 275After change set, first drug ignore bug fix. 276Type mismatch on SUN fix. 277Set 0 not exist (litks04c.cnf) X error fix. 278sound_play error report. 279 280v0.23 -> v0.24 281Sound routine sync bug fix. 282Cel comment display function is supported. 283windowsize viewport function is supported. 284Support mouse button function assign changing. 285Fix the BUG that sets no information in cnf is not displayed. 286 287v0.22 -> v0.23 (Ellis) 288Sound cache bug fix. 289Support pseudo transparency mode. 290 291v0.21 -> v0.22 (Rei) 292Optimize map change set. 293WKISS bug emulation -wkiss option. 294Optimize redraw area at change mapping. 295Support RIFF-WAVE (*.wav) pcm file. 296 297v0.20 -> v0.21 (Ayanami) 298C-Button1 unmap bugfix 299Support varargs.h style variable argument function. 300Report visual class 301 302v0.19 -> v0.20 303Support randomtimer quit event extensions. 304Use sound cache buffer. 305Sample data frkismi1.lzh updated. 306 307v0.18 -> v0.19 308Change message.c to support for FreeBSD. 309 310v0.16 -> v0.18 311C-Button1 unmap function add. 312Use autoconf to make configure script. 313 314v0.16 315First public release. 316Sample data frkismi.lzh contained with. 317 318---------------------------------------------------------------- 319* BUGS (or homeworks for you and me) 320 321If you execute following, will be core dumped. 322% fkiss / 323 324TrueColor or DirectColor visual class server is required to display 325True-colored CEL data. 326 327Transrucent image operation is emulated with dither stipple pattern. 328 329Not correspond with Network Audio System. 330 331".Xdefaults" settings are ignored. 332 333Supported only $USER or ${USER} environment variable in comment string. 334${USER:-you}, ${USER:=}, ${USER:?} nor ${USER:+} not complete. 335For example, ${USER-$YOU} do not work. 336 337---------------------------------------------------------------- 338* Special thanks 339 340MIO.H <mio.h@bigfoot.com> - KISS original author 341DE-TE- <ueno@sds.abk.nec.co.jp> - xkiss author 342Clis Hayasaka <yuki@is.s.u-tokyo.ac.jp> - Kiss FAQ author 343Cocoa <cocoa@is.s.u-tokyo.ac.jp> - xkiss++ author 344Jonathan Couper <couper@metdp2.met.co.nz> - XCheckTypedEvent technical advice 345Ken "Mian" Stone <sasami@blaze.net.au> - kissgs.doc English advice 346Hannu Savolainen <hsavolai@cs.helsinki.fi> - Linux Sound Driver ulaw.h 347YASU. <LDS02540@niftyserve.or.jp> - yasukis1.lzh Lovery Yohko-san :-) 348WACHIGAI - fkiss sample data frkismi.lzh Deform. Kismi-chan 349Yohko Teppozuka - Lovely cute voice ;-) 350Masaki Saeki <HZN83424@biglobe.ne.jp> - NEC EWS4800 bug report 351yosinari yabuki/ATO <yabuki@sendai.advantest.co.jp> - SunOS 5.4 bug report 352Minoru Iwamoto <iwamo@nims.nec.co.jp> - NEC EWS4800 bug report 353Naoyuki Shinbo <j2292106@ed.kagu.sut.ac.jp> - SunOS 4.1.3 bug report 354RERE <PXK07402@niftyserve.or.jp> - Solaris 2.4 bug report 355Takahiro Suzuki <takahiro@plasma.q.t.u-tokyo.ac.jp> - Browse document function 356EMK <VYV03354@niftyserve.or.jp> - no image mode paint_gc bug fix 357Takashi Oe <toe@unlinfo.unl.edu> - no image mode paint_gc bug fix 358Shuichi OONO <jr5pdx@debian.or.jp> - Temporary file cleaning 359yochi@debian.or.jp - use uname library 360Dirk Schenkewitz - MAXTIMER, MAXEVENT patch (TELL ME E-MAIL ADDRESS!) 361? - Sound device O_NONBLOCK open (TELL ME NAME AND E-MAIL ADDRESS!) 362Eric Armstrong <eric_peter_armstrong@yahoo.com> - Illegal cnf bug fix 363Amaya <amaya@debian.org> - License advices 364Junichi Uekawa <dancer@debian.org> - License advices 365Ben <collver@linuxfreemail.com> - midiplay patches 366 367---------------------------------------------------------------- 368* Copying 369 370This program is free software; you can redistribute it and/or modify 371it under the terms of the GNU General Public License as published by 372the Free Software Foundation; either version 2 of the License, or 373(at your option) any later version. 374 375This program is distributed in the hope that it will be useful, 376but WITHOUT ANY WARRANTY; without even the implied warranty of 377MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 378GNU General Public License for more details. 379 380You should have received a copy of the GNU General Public License 381along with this program; if not, write to the Free Software 382Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 383 384If you have any advices, questions and BUG reports, 385Please send E-mail to me. 386 387 388yav E-mail yav@bigfoot.com 389 WWW http://www2s.biglobe.ne.jp/~yav/ 390 391