›1m Backprefs›0m ›1mBackground preferences editor›0m Backprefs v2.0 Backprefs and this text are Copyright ©1996 Roland Haas Contents: ›3mDisclaimer›0m ›3mKnown bugs›0m ›3mHistory›0m ›3mFuture›0m ›3mAuthor›0m ›3mWhich pictures›0m ›3mThe gadgets›0m ›3mThe menus›0m ›1mCopyright, copying ...›0m Copying Backprefs may be distributed freely, as long as the contents of the archive remains unchanged. No charge may be raised other then a small fee for copying. Backprefs may be sold with other free redistributable software, as long as the conditions above are satisfied. This program may only be included in a commercial package if you have the written permission of the `author. disclaimer This product is sold "AS IS" without representation or warranty of any kind, either expressed or implied. YOU USE THIS PROGRAM ON YOUR OWN RISK INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. Installer and Installer project icon (c) Copyright 1995-96 Escom AG. All Rights Reserved. Reproduced and distributed under license from escom AG. ›1m Fehler›0m Currently no bugs are known to me. ›1mVersionen until today›0m NOTE: The version numbering starts at version 2.0. This program always gets the same version number as th main program background. Using programs with different version numbers will probably crash the machine. 03.08.1996: V2.0 initial version ›1mPlanned features›0m · Supporting parameters · slider in preview window · maybe adaption to workbench palette Suggestions, bug reports to the ›3mAuthor›0m ›1mThis is me›0m Backprefs was coded during long nights by: Roland Haas Mühlweg 16 77948 Friesenheim phone: ++49 07821/68084 the GUI was created with GadToolsBox v2.0. Suggestion, gifts and post cards are always welcome! A new and better version of this text would be especially welcome. Perhaps even a translation??? ›1mWhich pictures can be used?›0m Only pictures in the IFF-ILBM format can be loaded. The pictures _must_ use the same palette as the workbench. The pictures should have the same aspect ratio. E.g. if your workbench is HIRES/INTERLACED the picture should use the same viewmode or LORES/NONLACE. Always keep in mind that the pictures remain in memory; a 640x320 sized picture using eight colors will occupy 640*320*3/8 = 76800 byte CHIP-RAM. Also pictures must be loaded at program startup; if you are using many big pictures, this can take several seconds. So better use few little pictures setting the ›3mTILE flag›0m than many bigger ones. ›1mBackground preferences›0m Loaded Pictures: +---------------------------------+ +-+ +----------------+-+ Name | Work:Pictures/Disc | |?| | Back1 |#| +---------------------------------+ +-+ | Romantique |#| +--------------------+ +-+----------+ | Disc |#| Pattern | "(#? voll, #? frei | |@| Normal | | Dessert |#| +--------------------+ +-+----------+ | |#| +------------ Information ------------+ | |#| | Picture Workbench | | |#| | Size: 96 x 96 640 x 256 | | |^| | Planes: 3 3 | | |v| | Aspect: 10 : 22 22 : 44 | +----------------+-+ +-------------------------------------+ | Disc | +-------------+ +-+ +--------+---------+ | View | Tile Picture |V| | Add | Del | +-------------+ +-+ +--------+---------+ +------------+ +------------+ +------------+ | Save | | Use | | Cancel | +------------+ +------------+ +------------+ ›1mThe 'Name' gadget›0m You enter the path to the picture here. The button beside opens a filerequester for doing the same job. The last part of the path appears in the ›3mlist of pictures›0m. ›1mThe 'Pattern' gadget›0m Here you can enter the pattern, which is to use for this window. Windows, whose titles match the pattern will use this picture as their background pattern. Examples: "#? full, #? free, #? in use" - matches all discs (3D|DPAINT|XiPaint) - matches the drawers 3D, DPaint and XiPaint Possible tokens: ? Matches a single character. # Matches the following expression 0 or more times. (ab|cd) Matches any one of the items separated by '|'. ~ Negates the following expression. It matches all strings that do not match the expression (aka ~(foo) matches all strings that are not exactly "foo"). [abc] Character class: matches any of the characters in the class. [~bc] Character class: matches any of the characters not in the class. a-z Character range (only within character classes). % Matches 0 characters always (useful in "(foo|bar|%)"). ›1mThe floppy symbol›0m This gadget will open a filerequester allowing you to select a picture. The path appears then in the ›3mstring gadget›0m beside and in the ›3mlist of pictures›0m. ›1mThe list of pictures›0m In the right part of the window all currently loaded pictures are shown in a listview. The active picture is shown below the list. ›3mPath›0m, ›3mpattern›0m and other ›3mproperties›0m can be change using the remaining gadgets. ›1mThe 'Add' gadget›0m The Add gadget will create a new ›3mentry›0m for a picture. ›3mPath›0m and ›3mpattern›0m are taken from the corresponding stringgadgets. The ›3mtype›0m of the new picture is set to 'Normal', the ›3mTILE flag›0m is also set. The new picture is either added just after the ›3mactive picture›0m or at the end of the l›3mList of pictures›0m. ›1mThe 'Delete' gadget›0m The Delete gadget removes the ›3mactive picture›0m from the ›3mlist of pictures›0m; however string gadgets remain untouched. So if you have by mistake deleted the wrong picture, regain it using the ›3mAdd›0m gadget beside. (Expect the ›3mtype›0m and the ›3mTILE Flag›0m) ›1mThe 'View' gadget›0m Selecting View will open a window in which you can see the ›3mactive picture ›0m like you would see it in an workbench window. To make changes (e.g. the ›3mTILE flag›0m) take effect you will have to select the gadget again. ›1mThe TILE flag›0m The gadget 'Tile Picture' sets or clears the Tile flag of the ›3mactive›0m picture. By setting this flag the picture will be tiled to cover the whole area. Otherwise the remaining areas would be cleared with color 0 (grey). For this flag to work well, the ›3medges of the picture must fit together›0m. ›1mThe different types›0m Currently Backprefs manages four kinds of pictures, that are used for different purposes. Firstly there's a type called 'Nameless' that is used for windows that do not have a title. Such a window is for example the main workbench window if 'Backdrop' is selected. No pattern is used for this type. If you are running workbench in a window, the second type, 'Screen', will be more interesting for you. It is covers the screen background where there is no window. This type also uses no pattern. The third type called 'Standard' is similar to the first one, it is used whenever none of the other pictures can be used. Obviously this type uses no pattern. If there's not picture of types 'Standard' or 'Nameless' then the patterns defined in WBPATTERN are used instead. 'Normal' the forth type is the real thing. It uses the ›3mpattern›0m to decide which window will use the picture. If more than one ›3mpattern›0m match then the picture appearing later in the ›3mlist›0m is used. If on the other hand no pattern matches then the picture of type 'Standard' is used. The whole thing again: Typ | Nameless | Standard | Normal | Screen ------------+-----------+----------+------------+----------- Uses | | | | pattern | - | - | x | - | | | | Used for | Workbench | all | depends on | screen | | | pattern | background ›1mThe 'Save' gadget›0m Save quits the editor, loads the pictures and saves the list so it is be used after a reboot. ›1mThe 'Use' gadget›0m Use quits the editor, loads the new pictures and saves the list until the next reboot. ›1mThe 'Cancel' gadget›0m Cancel quits the editor without saving the list. ›1mGiven informations›0m In this field information about size, aspect ratio and depth of the picture and your workbench are given. Size shows you (surprise, surprise) the Size of the picture or the workbench in pixels. Pictures that are bigger than your workbench will never be shown entirely. The number of colors is computed as follows: 2^number of bitplanes So if you are using 3 bitplanes you can choose from eight colors. A picture using more colors than the workbench will probably look weird. Because of this you should always choose pictures having as many as or less colors than your workbench. The last value Aspect shows the ratio of height to width. Workbench and picture should have the same ratio; otherwise distortion will occur. ›3mWhich pictures can be used?›0m ›1mThe menus›0m The menus are the same as the ones of the system preferences editors, so you can also look their functions up in your system manual, if you don't understand something. Project Edit Settings ›3mOpen ...›0m ›3mReset To Defaults›0m ›3mSave Icons?›0m ›3mSave As ...›0m ›3mLast Saved›0m ›3mAbout ...›0m ›3mRestore›0m ›3mQuit›0m ›1mProject/Open›0m Loads a list of pictures from a file. ›1mProject/Save As›0m Lets you save the current list of pictures into a file. A file requester opens up showing Sys:Prefs/Presets as the default destination. If ›3mSave ›0m ›3mIcons?›0m is selected then an icon will be created to. Other than the system editors you can't load the list by double clicking on the icon. Instead you will have to use ›3mProject/Open›0m to load the list. ›1mProject/About›0m This menu item shows information about the program. (›3mVersion, address of›0m ›3mauthors, utilities...›0m) ›1mProject/Quit›0m Quits the editor without saving the list of pictures. This option has the same effect as ›3mCancel›0m. ›1mEdit/Reset To Defaults›0m Clears the list of pictures. That means the patterns defined in WBPATTERN will be used. ›1mEdit/LastSaved›0m Loads the last settings that were saved using ›3mSave›0m. ›1m Restore›0m Resets the settings to the ones preset at program startup. ›1mSettings/SaveIcons?›0m Using this option you can save icons along with settings saved by ›3mSave As›0m. However these settings cannot be activated by double clicking on the icon. Instead you must use ›3mProject/Open›0m. Backprefs.guide.English converted by Guide2Doc 1.0 (02-Nov-1993) FreeWare - © Koessi