ftp.nice.ch/pub/next/graphics/viewer/ToyViewer.2.6a.b.NI.tar.gz#/doc/INSTALL.rtf

This is INSTALL.rtf in view mode; [Download] [Up]

ToyViewer  Ver.2.6 (Feb. 1997)
		Copyright (C) 1995,1996,1997  Takeshi Ogihara

How to Install Binaries of ToyViewer
This document explains how to install the binary package of ToyViewer.  If you want to compile the source of ToyViewer, see the document included in the source package of ToyViewer.
You can use ToyViewer if you store ToyViewer.app into appropriate directory.  In addition, this document would be helpful to use ToyViewer more conveniently.

Files Included in the Package
After decompression,  you would get files as below:

	ToyViewer2.6/
		ToyViewer.app
		doc/
			README
			INSTALL.rtf
			lipo.csh

Installation
Basically, following steps should be done on Terminal.  Assume that the directory named "ToyViewer2.6" in previous section is referred to as $TOY.  Replace $TOY with the actual pathname.

(1) Remove binaries for unused architectures
Executable files included in NIHS package have binaries for m68k, i386, hppa, and sparc architectures.  And executable files included in NI package have binaries for m68k and i386 architectures.
If you do not want binaries for architectures that you do not use, remove them.  Otherwise, skip this step and go to (2).
There is a file named "$TOY/doc/lipo.csh", which is described to leave only binaries for m68k and i386 architectures.  Modify this file to leave binaries you want.  The part to be modified is "-extract m68k -extract i386" of the following line.

alias	LIPO	'echo \!\!:1; /bin/lipo -extract m68k -extract i386 \!\!:1 -output X; mv X \!\!:1'

For example, If you want binaries for only sparc, modify as "-extract sparc".
Then, type commands as below:

	% cd $TOY
	% csh doc/lipo.csh


(2) Move files into the directory where ToyViewer is installed
Decide where ToyViewer should be installed.  If only you use it alone, ~/Apps would be a good choice.  If some persons use ToyViewer, it should be installed in /LocalApps.  In this case, installation must be done as root.  You can install ToyViewer into other directory, however, in order to use Image Conversion Filter Services described in next section, install ToyViewer into ~/Apps or /LocalApps.
In case of ~/Apps:
	% mv $TOY/Toyviewer.app ~/Apps
Incase of /LocalApps:
	% su
	% mv $TOY/Toyviewer.app /LocalApps
	% chown -R root.wheel /LocalApps/Toyviewer.app

Customization
You can add new image formats to be displayed to ToyViewer.
The method of customization for individual users can be seen in the Help Panel of ToyViewer, which is written in "ToyViewer.app/Japanese.lproj/HelpCustom.rtf".
Here, customization that should be done during installation is described.  First, you should read the help, then work as below.

(1) Information for customization
In case that individual users customize ToyViewer, the following 2 files are modified.
(a) Addition of filters		~/.toyviewerrc, or ~/Library/ToyViewer/rc.arch
(b) Addition of Filter Services	~/Library/Services/ToyViewer.service
Just as them, ToyViewer has 2 files for global setting.
(a') Addition of filters		ToyViewer.app/filters
(b') Addition of Filter Services	ToyViewer.app/services
Therefore, if you want to change in advance the setting of Toyviewer, modify the contents of these files.
Note that specification written in files (a) and (b) is prior to the setting in (a') and (b').  So, only in case that the customization is shared by some persons, modification to (a') and (b') would be effective.  Otherwise, change (a) and (b) individually.  Be cautious of modifying files (a') and (b').

(2) Remove useless filters (NEVER!)
In ToyViewer2.3 or older versions, users can remove filter programs presented by ToyViewer in the directory ToyViewer.app.  However, in ToyViewer2.4 and later versions, DO NOT remove filter programs in the directory.  For example, cjpeg and djpeg are programs to read and write jpg images.  The versions of cjpeg and djpeg presented by ToyViewer2.4 are extended to read and write comments into image data.  If they are replaced with other programs, ToyViewer can not read / write jpg images.

(3) Remove useless Filter Services
There are other programs that provide image conversion filter services, such as ImageViewer or OmniImageFilter.  If you want to use their filter services instead of ToyViewer, you could remove the corresponding lines in ToyViewer.app/services.
To specify individually filter service programs to be activated, you should describe obviously the definition of services in ~/Library/Services.

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.