Mercurial > hg > Applications > mh

comparison miscellany/multi-media/READ-ME @ 0:bce86c4163a3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children 441a2190cfae
comparison
equal deleted inserted replaced
-1:000000000000 0:bce86c4163a3
1 $Id$
2
3 [ READ-ME - Wed Sep 1 19:07:25 1993 - multi-media MH - /mtr ]
4
5
6 NOTICE
7
8 This package is openly available but is NOT in the public domain.
9 You are allowed and encouraged to take this software and use it for
10 any lawful purpose. However, as a condition of use, you are required
11 to "hold harmless" all contributors.
12
13 Permission to use, copy, modify, and distribute this software and
14 its documentation for any purpose and without fee is hereby
15 granted, provided that this notice be retained unaltered, and that
16 the name of any contributors shall not be used in advertising or
17 publicity pertaining to distribution of the software without
18 specific written prior permission. No contributor makes any
19 representations about the suitability of this software for any
20 purpose. It is provided "as is" without express or implied
21 warranty.
22
23 ALL CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
24 SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
25 AND FITNESS FOR THE PARTICULAR PURPOSE, TITLE, AND
26 NON-INFRINGEMENT.
27
28 IN NO EVENT SHALL ANY CONTRIBUTOR BE LIABLE FOR ANY SPECIAL,
29 INDIRECT OR CONSEQUENTIAL DAMAGES, WHETHER IN CONTRACT, TORT, OR
30 OTHER TORTUOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH, THE
31 USE OR PERFORMANCE OF THIS SOFTWARE.
32
33
34 Following are sources of software for manipulating various MIME content
35 types. The script support/general/bootmhn.sh (which is run when
36 you do "make inst-all") will look for these programs and create the
37 global mhn_defaults file accordingly. Since this script will
38 look for the programs detailed below, you should do all of the
39 installation here prior to running "make inst-all". Also, the
40 programs should be installed in either the MH library area
41 (e.g., /usr/local/lib/mh/) or in your $PATH.
42
43
44 text/richtext
45
46 There are two programs for rendering text/richtext, rt2raw and
47 richtext.
48
49 1. r2raw - a really dumb richtext interpreter
50
51 This is found in the MH distribution:
52
53 % cd miscellany/multi-media/misc/
54 % cc -o rt2raw rt2raw.c
55
56 and then copy rt2raw to your MH library area.
57
58
59 2. richtext - a termcap-based interpreter
60
61 This is found in the MetaMail distribution:
62
63 host thumper.bellcore.com
64 dir pub/nsb/
65 file mm.tar.Z
66 mode binary
67
68 Now run these commands
69
70 % mkdir mm
71 % cd mm
72 % uncompress < ../mm.tar.Z | tar xvpf -
73 % cd richmail
74 % make richtext
75
76 and then copy richtext to your MH library area.
77
78
79 image
80
81 There are several programs available for rending images: xv, pbmplus,
82 and jpeg. To use any of these, you need to be running under the
83 X window system. When bootmhn.sh runs, it will generate commands
84 for a monochrome monitor. If you're running on a greyscale or
85 color monitor, you should change the commands accordingly.
86
87 1. xv version 2.11
88
89 There may be a more recent version by the time you read this file:
90
91 host ftp.cis.upenn.edu
92 dir pub/
93 file xv-2.11.tar.Z
94 mode binary
95
96 Read the installation instructions and install the xv binary
97 somewhere in your $PATH.
98
99 2. pbmplus
100
101 There may be a more recent version by the time you read this file:
102
103 host ftp.uu.net
104 dir pub/window-sys/X/contrib
105 file pbmplus10dec91.tar.Z
106 mode binary
107
108 3. JPEG
109
110 There may be a more recent version by the time you read this file:
111
112 host ftp.uu.net
113 dir graphics/jpeg/
114 file jpegsrc.v3.tar.Z
115 mode binary
116
117 Read the installation instructions and install the djpeg binary
118 somewhere in your $PATH.
119
120
121 audio
122
123 This is platform dependent. At present, only detailed information
124 for the SPARC and the HP 9000/710 is presented.
125
126 1. SPARC
127
128 The SPARC has a telephone-quality audio-chip and an internal
129 speaker. If you want to record audio, you'll need to buy a
130 microphone. For reasons not worth going into, most mic's don't
131 have enough gain, and you have to put the thing right next to your
132 lips. However, Isaac Salzman of SMI suggests, and I concur, that
133 the best mic to get is SONY's ECM-K7. This costs about US$50, but
134 is well worth it: you can put the mic on your desk and it will
135 still pick up your voice.
136
137 The "native" encoding for the audio-chip is 8-bit u-law sampled at
138 8000/second . Prior to SunOS 4.1, audio files contained simply the
139 encoded audio. However, in SunOS 4.1 or later, SMI introduced a
140 file format containing a header followed by the encoded audio. For
141 now, we'll use the content type audio/basic to refer to the raw
142 audio, and the content type audio/x-next to refer to the file
143 format (NeXT developed the file format and SMI supports a subset of
144 it). When dealing audio/basic, you simply cat to/from /dev/audio.
145 When dealing with audio/x-next, you can use the play and record
146 programs found in the /usr/demo/SOUND/ directory.
147
148 In addition, in OpenWindows 3.0 or later, SMI added support for a
149 compressed u-law encoding based on the CCITT G.721 ADPCM algorithm.
150 Before audio encoded in this fashion can be heard, it must be
151 converted back to 8-bit u-law. Conversions to and from the two
152 encodings can be done with the adpcm_enc and adpcm_dec programs
153 found in the $OPENWINHOME/bin/xview/ directory.
154
155 If you are running something earlier than SunOS 4.1, I suggest that
156 you immediately get a copy of the raw2audio, play, and record
157 programs, so you can generate audio files. The source is avilable
158 in the SunOS 4.1 Demos installation. If you can't find these
159 programs, then when bootmhn.sh runs, it will just cat directly
160 to/from /dev/audio.
161
162 If you do have the raw2audio, play, and record programs (regardless
163 of the version of SunOS you're running), then apply some patches:
164
165 % (cd /usr/demo/SOUND; patch) < miscellany/multi-media/SPARC/SOUND.diff
166 % cd /usr/demo/SOUND
167 % make raw2audio
168
169 Be sure to put /usr/demo/SOUND in your $PATH so that bootmhn.sh can
170 find the programs there. (Alternately, you could copy these
171 programs to another directory which is in your $PATH.)
172
173 You might also consider running /usr/demo/SOUND/x_gaintool, so you
174 can fiddle with the volume controls whenever you like.
175
176 2. HP 9000/710
177
178 The HP-Apollo 9000/710 workstation has a telephone-quality audio
179 chip and an internal speaker. If you want to record audio, you'll
180 need to buy a microphone. As with the SPARC, just about any
181 microphone with a standard mini jack will do. Comments in the
182 preceding section that apply to selections of a microphone for the
183 SPARC probably also apply here.
184
185 The audio programs that may be used with mhn -- player, splayer,
186 recorder, and srecorder -- are provided by HP in source form in the
187 directory /usr/audio/examples/. The README file in that directory
188 documents the various audio utility programs for recording and
189 playing sounds. Be sure to put /usr/audio/examples in your $PATH
190 so that bootmhn.sh can find the programs there. (Alternately, you
191 could copy these programs to another directory which is in your
192 $PATH.)
193
194 Before any of the aforementioned programs can be used, the audio
195 device files must be created by running
196 /usr/audio/bin/make_audio_dev, and two daemons must be started:
197 /usr/etc/ncs/llbd and /usr/audio/bin/Aserver. Refer to Audio(5)
198 for detailed, step by step instructions on how to do these things.
199 Alternatively, refer to the HP publication "Audio Users Guide"
200 (HP order number A1991-90609, November 1991 version).
201
202 The audio devices support several "native" encodings that vary as
203 to which of the audio device files is used: one of
204 /dev/audio[BEI][ALU], where E=external jack, I=internal speaker,
205 B=both; A=8-bit ALaw, L=16-bit linear, U=8-bit MuLaw. It is
206 possible to "cat" a raw audio data file of the appropriate type to
207 or from one of these devices. For example, a SPARC .au file may be
208 played by running this command:
209
210 cat bark.au >/dev/audioIU
211
212 (You must create the audio device files before you can cat anything
213 to them; again, refer to Audio(5) for information on how to do this.)
214
215 There is, as of HP-UX 8.07, no supplied tool a la the SPARC's raw2audio
216 to add headers to audio data files that describe the audio data
217 encodings. Rather than looking for headers in the sound data, the
218 audio tools rely on user-supplied information, such as file
219 extensions or command line options, to inform the tools about the
220 types and sampling rates of the audio data.
221
222 Audio file names have the form
223
224 <file name>[["."<sample rate>]"."<type>]
225
226 where
227
228 <sample rate> ::= 1#DIGIT"000"/ 1#DIGIT"k"
229 <type> ::= "u" / "al" / "au" / "wav" / "snd" / "l8" /
230 "lo8" / "l16"
231
232 Mulaw u
233 Alaw al
234 Sun au
235 Microsoft RIFF Waveform wav
236 Macintosh snd
237 Linear8 l8
238 Linear8Offset lo8
239 Linear16 l16
240
241 Examples:
242
243 bark.au
244 bark.8000.au
245 bark.8k.au
246
247 As with the SPARC, the default sample rate is 8000 Hz.
248
249 The /usr/audio/bin/audio_demo program may be used to convert
250 manually among different sound types, as well as to play, to
251 record, and to edit the sounds. Unfortunately, the audio_demo
252 program does not accept command line arguments, so it is not quite
253 as suitable for invocation from mhn as are the player and recorder
254 programs.
255
256 You might also consider running /usr/audio/examples/acontrol, so you
257 can fiddle with the volume controls whenever you like.