--- name: "fkiss" section: "1" platform: "linux" package: "fkiss" version: "0.35-1" release: "Debian 5.0 (Lenny)" platforms: ["linux"] url: "https://new.carta.tech/fkiss" --- # fkiss(1) Freely enjoy childlike KISS, French-KISS! ## NAME fkiss - Freely enjoy childlike KISS, French-KISS! ## SYNOPSIS **fkiss** \[*option*...\] \[*file.lzh*...\] \[*file.cnf*\] ## DESCRIPTION **French-KISS!** (**fkiss**) is a sample implementation of KISekae Set system (KISS) for X Window System. KISS is a paper doll playing system for computers.\ **fkiss** reads *file.cnf* (KISS configuration file), and reads the color and cell files described in it. If *file.lzh* (LHa archive) is specified, **fkiss** calls **lha** to extract the archive and searches for \*.cnf in the archive. One of *file.cnf* or *file.lha* must be specified. ## OPTIONS - **-display** *name* Display connection. - **-geometry** *geom* Window geometry. - **-debug** Print debug informations to stderr. - **-silent** Silent mode. Warning messages are not displayed. Sounds are not played. - **-verbose** Verbose mode. - **-font** *font* Use a font named *font* to print menu strings etc. - **-font8** *font* Use a font named *font* to print comment strings. By default "rk16" or "8x16" is used. - **-font16** *font* Use a font named *font* to print Japanese comment strings. By default "kanji16" or "k14" is used. - **-fg** *color* Foreground color. - **-bg** *color* Background color. - **-bw** *width* Border width. - **-cursor** *n* Cursor font control.\ **0**\ (no control)\ **1**\ hand (null)\ **2**\ undef grip\ **3**\ hand grip (\*default) - **-s** Same as **-cursor 1**. - **-fixed** *n* Do not move a object its fix value is more than or equal to *n*. If not specified, use maximum value described in configuration file. - **-scroll** Unlimited scroll. - **-gray** Convert RGB value to Gray scale brightness level. (On GrayScale visual class server, This option is turned on automatically) - **-test** Automatically display all set, and print cell informations to stderr. - **-t** Execute time command with arguments "fkiss -test ..." to report running time. "fkiss -t kissmars.lzh" is same as "time fkiss -test kissmars.lzh". - **-nosound** Disable sound function. (same as **-sound 0**) - **-sound** *n* Select sound handling mode.\ **0**\ Disable sound function.\ **1**\ Use internal sound routine (cf. sound.c).\ **2**\ Execute "play" command to play sound. - **-soundcache** *n\[k\|m\]* Change sound data cache buffer size limit *n* (kilo\|mega) bytes. By default, 256 kilobytes limit. - **-p** Use private color cells. - **-nocolormap** Disable to make new colormap. - **-k** *keyword* Decode encrypted lzh archives (suffix .hes) with *keyword*. - **-randseed** *n* Use *n* for randomize seed. If this option is not specified, use current time. - **-noevent** Disable fkiss event extension. - **-eventshell** Enable to execute shell command described in KISS configuration file. Take care, this funciton makes a SECURITY HOLE! - **-wkiss** Emulate WKISS bug. - **-transparency** *n* Set pseudo transparency mode.\ **0**\ Disable pseudo transparency functions.\ **1**\ Static dithered pseudo transparency mode.\ **2**\ Under construnction. Buggy. - **-comment** *n* Set cell comment display mode.\ **0**\ Not display cell comment.\ **1**\ Display pointed cell comment.\ **2**\ Display all cell comment pointed object. - **-commentline** Display cell comment with cnf line number. - **-button1** *n* Assign function *n* to mouse button1 (left).\ **0**\ No operation.\ **1**\ Object catch, move and drop.\ **2**\ Iconify window.\ **3**\ Display cell comment. - **-button2** *n* Assign function *n* to mouse button2 (center). - **-button3** *n* Assign function *n* to mouse button3 (right). - **-document** *document\_browse\_command* Execute *document\_browse\_command* to browse document. By default, execute DOC\_COMMAND defined in fkiss.c. (Initial DOC\_COMMAND defined "xemacs") If the character % is not found in DOC\_COMMAND, Append " %P" string. If the character at end of DOC\_COMMAND is not &, Append & character. Following parameters in *document\_browse\_command* substitute.\ **%A**\ directory\ **%P**\ pathnames\ **%F**\ filenames\ Exmple:\ \-document "(cd %A; more %F) &"\ "(cd /tmp/fkiss123; more litks09.doc readme.txt) &"\ \-document "(emacs %P) &"\ "(emacs /tmp/fkiss123/litks09.doc /tmp/fkiss123/readme.txt) &" - **-suffix** *.foo* Add suffix *.foo* into document suffix list. - **-nosuffix** *.foo* Delete suffix *.foo* from document suffix list. - **-autoadjust** *n* Automatic object position adjustment range *n* pixels. 4 pixels by default. "-autoadjust 0" to disable automatic object position adjustment. - **-nowarncase** Suppress CEL and Sound file case-ignore warnings. - **-maxaction** *n* Change maximum number of actions per event. Default 256. - **-maxtimer** *n* Change maximum number of timers. Default 256. - **-maxevent** *n* Change maximum number of events. Default 256. - **-maxsoundfile** *n* Change maximum number of sound files. Default 256. - **-alpha** *n* Change alpha channel tranparency level. Add *n* to each pixel alpha level (0..255).\ **-255**\ All pixels transparent.\ **+255**\ Not transparent.\ - **-esd** *host* Change EsounD server *host*. Default Localhost. - **-noesd** Not use EsounD, use /dev/dsp. - **-midiplayer** *program* Set external MIDI player *program*. Default "/usr/bin/midiplay" or\ "/usr/bin/playmidi" or\ "/usr/local/bin/timidity -idq". ## KEY BINDINGS - **Button1** Catch the object which is pointed. If no objects or fixed object is pointed, scroll the image with moving mouse. - **Button2** Iconify window. - **Button3** Display cell comment. - **-** Previous set. - **=** Next set. - **\[** Previous color group. - **\]** Next color group. - **Space** Toggle upper/lower menu bar. - **Escape** Iconify window. - **Control-S** Save cnf file. Original cnf file is renamed \*.cnf~. - **q** Quit. - **Control-Button1** Unmap the cell which is pointed. And register it for 'v' toggle mapping.\ For KISS data creaters ONLY. Others must NOT use this function. - **v** Toggle mapping/unmapping the cell which is unmapped by Contol-Button1. Don't forget mapping it again before next Control-Button1. - **d** Browse document files (\*.doc \*.txt \*.hed). Initial settings, use **xemacs** program. - **r** Revert position of all objects in current set to initial. If fkiss event extension is detected, this function is disabled. ## FILES - \*.cnf KISS configuration file - \*.kcf KISS color file - \*.cel KISS cell file - \*.lzh LHa archive file - lha LHa archiver - **TMPDIR**/fkiss\* temporary directory to extract files - **HOME**/.fkissrc rc file for fkiss. - **HOME**/fkiss.au startup sound file - play command for playing sound file ## STANDARDS **fkiss** conforms to KISS/GS2, KISS/GS4 (draft). See kissgs.doc - KISS/GS (KISS General Specification) Manual. ## BUGS Cannot enjoy colorful dresses on GrayScale and StaticGray visual class server.\ TrueColor or DirectColor visual class server is required to display True-colored CEL data.\ Transrucent image operation is emulated with dither stipple pattern.\ Does not work with Network Audio System.\ **Xdefaults** settings are ignored. ## SEE ALSO [gnomekiss(1)](/gnomekiss/1.md) ## COPYING **French-KISS! and this manual page** are free software, licensed under the GNU GPL.\ The original version by yav is at "http://www2s.biglobe.ne.jp/~yav/". The version in Debian has been substantially modified to keep it functioning half-decently, since yav seems to have stopped development; please file bug reports with Debian. ## AUTHOR yav \\ Large portions of the manpage rewritten by Nathanael Nerode.