.TH VISF 1csound CARL 
.SH NAME
visf 
- edit sound file parameters
.SH SYNOPSIS
.B visf 
[-h] [-w] soundfile
.RS .5i
.nf
flags:
-h print help message first
-r readonly mode
-w wizard mode access
.RE
.SH DESCRIPTION
.B visf
allows you to alter selected parameters of a sound file.  The
action of the program is to place you in the vi editor with 
parameters from the sound file you specify.  
.PP
The parameters are presented one to a line.  The first thing on the line is
a code for what the parameter means, which is followed by the actual
parameter.  You can alter any of these parameters to any value you know
is ok, or add or delete comments or include files.  Numeric values must be
constants \(em they may not be expressions.  
.PP
When you are done,
quit vi with :x[RETURN] as usual.  
If you have specified the -r flag, 
.B visf 
will
immediately exit without recording any modifications you have made.
Otherwise you will be asked whether you wish to write out the
changes, abort,
or get help.  'x' aborts, '?' prints a help message, and then
puts you back in vi for another chance to edit the file.  Just [RETURN]
finishes by writing out your changes and exiting.  If you run 
.B visf 
with
the -h flag, you get the help message first thing, then everything is
as above.
.PP
The meaning of the parameter codes is as follows:
.sp
.nf
p file protection code (default = 0644)
R sample rate (range = 64 to 49152) (default = 16384)
P packing mode (s or f) (default = s)
c number of channels (1,2 or 4) (default = 1)
# number of samples in file (you can only make this number smaller!)
r comment string, there may be any number of comments, but
r each must begin with "r " in the first column position.
I include file
I and there may be any number of include files, here is a real example:
I ~dgl/ready.seg
.PP
.fi
You can modify, add
or delete comments, change include files, alter the sampling rate,
etc.  
Care must be exercised to be sure that you do not delete lines 
critical to the operation of the sound file system, such as sampling
rate, etc.  The correct code letter must appear
in the first column and be immediately followed by one space.
Note: this is a slightly dangerous program!
It is up to you to do it right!  Havoc can result from misuse.
.PP
In addition, if you are root or a member of the disk group and specify
the -w flag, 
.B visf
will display and allow you to modify these parameters as well:
.sp
.nf
t realtime flag (r or n)
f file name (don't change, use mvsf!)
v cylinder allocation blocks (careful!)
w creation date
x last referenced date
y last altered
z date dumped
k tape key
.PP
Use of the -w flag allows you to grow the file size to any value.
This value should not exceed the maximum number of samples available
for the number of cylinders claimed by the file.
.SH DIAGNOSTICS
The program exits if the file is not there or is unreadable,
or if you specify the -w flag and are not a superuser.
.PP
If you are not the owner of the file, it tells you it is using
read only mode, but allows you to look at the file.  When you then exit,
it tells you the file is unchanged, and exits immediately.
.PP
Unknown parameter codes or garbage parameters
cause all modifications to be aborted entirely.
.SH BUGS
This is a very gullible program, and far too trusting of your good
intentions.  Bulletproofing it would take a lifetime, however.
.PP
In general, it is up to you to know what to do with the parameters.  Check
with a wizard before getting too experimental, but there is little you
can do that should cause you to come to grief (unless you use
the -w flag and are careless).  Caveat emptor.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
sndin(1csound), sndout(1csound), lsf(1csound).  
