################################################################### ## SLIK 0.4.1 (January 6, 2001) ## ## This software is Copyright (C) 2001 by John Ellis. ## ## Use this software at your own risk. I am not responsible for ## ## anything this software may do to your computer. ## ## This software falls under the GNU Public License. Please read ## ## the COPYING file for more information. ## ################################################################### (Note this is a template source package to start an app based on SLIK. As distributed, this _will_ compile, creating an executable named slik_test, which is sort of a 'hello world' and test app.) ========== Author: John Ellis e-mail: gqview@email.com homepage: http://netpedia.net/hosting/gqview or http://www.geocities.com/gqview (alternate site) ======== Major sections of this document - Requirements - Notes and changes for this release - Installation - Description / Features - Command Line options - Skins - Documentation (brief) [lists keyboard controls] - Skin editing notes - Credits ======== Requirements GTK+-1.2.x: ftp://ftp.gtk.org/pub/gtk (1.0.x will not work!) gdk-pixbuf >= 0.7.0 -------------------------- ======== Notes and changes for this release Changes: - Initial public release. 0.4.1: Bug fixes (0.4.0 never made it to the public) Notes: Bugs: - scaling (background stretch options) images does not work well. ======== Installation Compilation: ./configure ; make - I18N note: Set the shell variable LINGUAS with a list of required translations before configure (supported: ). - To build an RPM binary use 'rpm -tb slik-x.x.x.tar.gz'. Installation: make install Removal: make uninstall ======== Description / Features FIXME Features: ======== Command Line options: ======== Skins Uses SLIK (SimpLIstic sKin interface), to edit skins use the tilde '~' key. Also see (Skin editing notes), below. To specify a skin use the -skin:skinfile command line parameter (see above). When specifying a default skin in the config dialog, the skin must reside in HOME/.gqmpeg/skins If valid, a new default skin is loaded when 'ok' or 'apply' is pressed. ======== Documentation (brief) ======== Skin editing notes Mouse control: - The mouse in the skin editor uses these buttons in the skin display area: - Button 1 : Same as in the normal main window (press buttons, etc.) - Button 2 : Click to select widget, drag to move selected a widget. (when click to focus is disabled, widgets are always draggable) - Button 3 : same as button 2 Extracting widget from other skins: - To generate a list, and use widgets from any installed skin, press the 'extract' button from the 'add' dialog of the skin editor. Editing / extracting widgets from the built-in (default) skin: - To re-use widgets from the default skin, first load them into the skin editor and save them as a new skin. To make the new widgets show up in the widget lists, close the skin editor, then reopen it and press the extract button in the add dialog. Skin toggle buttons: - The "skin_toggle" button is a special case, the data field must contain the filename of the skin the button is to switch to. If the data field is left blank the default skin (skindata) will be loaded. If the filename does not exist or is an invalid skin file, the button will do nothing. (NOTE on naming of the skindata type files: the widget extraction feature only extracts widgets from skins defined by files matching the pattern "skindata*" but _not_ including '.bak'. All others are ignored.) Writing a skin to disk: - When saving a skin, existing files are never overwritten: the skindata file is backed up with an extension of .bak or .bakXXX; graphics files will first be compared by file length and checksum, if they match it will keep the existing file, otherwise the new graphics file will be written to a new filename with an appended number increment (name_1.png). Dial and Slider 'item link key': - Dials and sliders have a 'Item link key' field, this is for use when you want an item with that key to update with the dial or slider in such a way that the dial/slider handle is drawn over top of the item. This is useful for example when it is desired that a slider that controls the volume also shows the volume level. If you want the item to be the only thing displayed with slider-like interaction, the slider handle size can be set to zero by specifying a trough length equal to the image dimensions. Limits: - You can add as many widgets of the same function as you want and they will all work. (For example 100 play buttons :). Invalid UI keys: - If an invalid key is assigned to a widget, the widget will still load but be ignored when activated/operated. Detailed skin specs: - See SKIN-SPECS. ======== Thanks go to the following for fixes, additions, and patches: Translations: Fixes, additions, and patches: ===========
