                 _U_s_i_n_g _C_e_c_i_l_i_a _a_t _E_a_s_t_m_a_n

_C_e_c_i_l_i_a is a front-end "environment" for running  Csound  on
Unix  and Macintosh systems.  To open _C_e_c_i_l_i_a, on one of our
SGI or Linux systems, type _c_e_c_i_l_i_a (or else the abbreviation
_c_e_c) in a shell window. If you don't want the application to
tie up this shell window while it is running you can  follow
this command with an ampersand:
                           _c_e_c &

_C_e_c_i_l_i_a enables  each  user  to  customize  his/her  working
environment  within the application. Individual user prefer-
ences can be set by selecting  _P_r_e_f_e_r_e_n_c_e_s  under  the  _F_i_l_e
menu,  then  editing  values in the window that opens.  Your
personal preferences are stored in a file called  ._c_e_c_i_l_i_a_r_c
in your home Unix directory.

We have added some ECMC resources to  the  standard  _C_e_c_i_l_i_a
distribution.  In  order to access these ECMC resources, and
also to set up various environmental options  as  we  recom-
mend, you must set and save these options within the _p_r_e_f_e_r_-
_e_n_c_e_s page of _c_e_c_i_l_i_a, so that they will be written to  your
._c_e_c_i_l_i_a_r_c  file that is read by _c_e_c_i_l_i_a whenever you launch
the application.

There are two ways in which you can set these options as  we
recommend:
     o+ Use the ECMC script _m_k_c_e_c_p_r_e_f_s
     In a shell window, type
                           _m_k_c_e_c_p_r_e_f_s
     This will create (or overwrite) the file ._c_e_c_i_l_i_a_r_c  in
     your  home  Unix  directory with the settings and addi-
     tions we recommend.

     o+ Alternatively, you can edit and the _P_r_e_f_e_r_e_n_c_e_s page,
     filling  in appropriate arguments and then saving these
     settings, by selecting _F_i_l_e > _P_r_e_f_e_r_e_n_c_e_s  while  work-
     ing within the application.
The settings we recommend are:

     Csound binary:  /usr/local/bin/csound
     Soundfile Player: /usr/sbin/soundplayer
     Soundfile Editor: /usr/sbin/soundeditor
     Soundfile Converter: /usr/sbin/soundeditor
     Text editor: /usr/sbin/jot
     HTML Viewer: /usr/local/bin/netscape
     MIDI Editor: /usr/local/bin/rosegarden

     SoundIN :  $SFDIR
     SoundOUT :  $SFDIR
     Analysis :  $SFDIR
     Module : /usr/local/lib/cecmodules
     Temporary :   $SFDIR
where   $SFDIR   is   your    home    soundfile    directory
(/snd/youruserid)

Eastman modules added to Cecilia

A _c_e_c_i_l_i_a "module"  consists  of  an  orc/score  pair  -  an
orchestra  file  and  a  companion  score file to "play this
orchestra." Note that the score file must be a _C_s_o_u_n_d  score
file, such as the _s_o_u_t output files created by _s_c_o_r_e_1_1), and
not an input file to _S_c_o_r_e_1_1.  The  directories  (groups  of
modules) that we have added to Cecilia include
     (1) modules  for  the  _E_a_s_t_m_a_n  _C_s_o_u_n_d  _L_i_b_r_a_r_y,  which
     includes score p-field based instrument algorithms such
     as _m_a_r_i_m_b_a and _s_a_m_p,  as  well  as  MIDI-based  _m_i_d_i_i_n_s
     algorithms such as _m_i_d_i_s_a_m_p;
     (2) modules for all of the orchestra/score  file  exam-
     ples in the _E_a_s_t_m_a_n _C_s_o_u_n_d _T_u_t_o_r_i_a_l document.

To access one of these groups of modules:
     o+ Click on _F_i_l_e in the main  _c_e_c_i_l_i_a  window,  then  on
     _N_e_w.
     o+ In the list of available modules  that  appears,  you
     should  see  _E_S_M_t_u_t_o_r_i_a_l and _E_S_M_l_i_b_r_a_r_y near the bottom
     of the list.
     o+ Clicking on _E_S_M_t_u_t_o_r_i_a_l  or  _E_S_M_l_i_b_r_a_r_y  and  holding
     down  the  mouse  will pop open a listing of all of the
     "modules" available within this directory, as  well  as
     any subdirectories with additional modules.
o+ Click on a module to select it and  load  the  appropriate
files into Cecilia for editing or compilation.  Click on the
_I_n_f_o button within the  Cecilia  Editor  window  to  display
information about the module.
You can make all of these selections in quick succession  by
holding  the  mouse  button down continuously until you have
found the module you want.
A _C_E_C _e_d_i_t_o_r window will open, which  will  include  (1)  an
orchestra file (either mono or stereo, or both, if the algo-
rithm is set up to create either mono or stereo output)  and
(2) a score file.

     __________________________________________________

The _E_S_M_l_i_b_r_a_r_y modules
The modules within the  main  _E_S_M_l_i_b_r_a_r_y  directory  include
score  p-field  based instrument algorithms from the _E_a_s_t_m_a_n
_C_s_o_u_n_d _L_i_b_r_a_r_y, such as _s_a_m_p and _m_a_r_i_m_b_a. If you select  one
of  these  algorithms  in the main _E_S_M_l_i_b_r_a_r_y directory, the
orchestra code for the algorithm will  be  loaded  into  the
orchestra  file  section  of  the cecilia _e_d_i_t_o_r window, but
there will be no score file.  You must create your own score
file  in a shell window.  Then, in the _e_d_i_t_o_r window, select
_M_o_d_u_l_e, then _O_p_e_n _S_c_o_r_e _F_i_l_e, and then, in the  window  that
opens,  the  name  of the score file (usually _s_o_u_t, assuming
that this file was created by means of _S_c_o_r_e_1_1).

You now are ready to compile this orc/score pair in the main
_c_e_c_i_l_i_a window, using either
     o+ the  _D_A_C  button  to  send  Csound's  output  samples
     directly to the SGI DACs for listening, or
     o+ the  _D_i_s_k button to write the samples into  a  sound-
     file.
If you choose to write a new soundfile,  the  name  of  this
soundfile  is determined in the _n_a_m_e box in the main cecilia
window. Since the default names are ugly (the  name  of  the
"module"  followed  by  ._A_I_F_F),  you  probably  will want to
change this name to something simpler.

The _E_X_A_M_P_L_E subdirectory:

The _E_S_M_l_i_b_r_a_r_y menu includes a subdirectory called _E_X_A_M_P_L_E_S.
If  you select this directory, you will see a list of avail-
able orc/score pairs, used to create  some  of  the  example
soundfiles in the _s_f_l_i_b/_x directory, that illustrate typical
usage of the instrument  algorithm.   These  examples,  with
names  such  as _m_a_r_i_m_b_a_1, _s_a_m_p_2 and _t_s_a_m_p_3, are identical do
those that can be accessed with such commands  as  _l_s_e_x  and
_g_e_t_e_x,  except  that  the  input file to _S_c_o_r_e_1_1 has already
been converted into a _s_o_u_t file.  Clicking on one  of  these
modules  loads  it  into  the  cecilia's editor, where it is
ready for immediate compilation.

The _M_I_D_I subdirectory:
Modules within  the  _M_I_D_I  subdirectory  include  MIDI-based
(_m_i_d_i_i_n_s)  algorithms  from the Eastman Csound LIbrary, such
as _m_i_d_i_s_a_m_p and _m_i_d_i_w_a_v_e. Default score files have been pro-
vided  for each of these algorithms, so they are immediately
playable (unlike the  score-based  algorithms  in  the  main
_E_S_M_l_i_b_r_a_r_y directory). A _M_O_R_E__E_X ("more examples") subdirec-
tory includes additional examples for some  of  the  _m_i_d_i_i_n_s
algorithms.  Be sure to read the _R_E_A_D_M_E file within the _M_I_D_I
subdirectory before trying to use these modules, and,  after
loading  one  of  the _m_i_d_i_i_n_s modules into Cecilia, click on
the _I_n_f_o box for a quick usage summary.

Currently, the _M_I_D_I modules  are  useful  only  for  playing
through  the  SGI DACs (using the _D_A_C button). DO NOT try to
write the Csound output into a soundfile by clicking on  the
_D_i_s_k  button.  This  will create a very large soundfile con-
sisting entirely of zeros.

     __________________________________________________

The _E_S_M_t_u_t_o_r_i_a_l modules
This group of modules includes all of the orchestra and com-
panion  score  files  presented in e _E_a_s_t_m_a_n _C_s_o_u_n_d _T_u_t_o_r_i_a_l
document (Schindler). These modules are loaded into  Cecilia
in the same manner described above.  Select
_F_i_l_e, then _N_e_w, then _E_S_M_t_u_t_o_r_i_a_l, then the module you want.
If you wish, you can edit the orchestra  and/or  score  data
within  Cecilia's  window  window.   Alternatively,  you can
create new scores in a shell window and read them into Ceci-
lia with the _O_p_e_n _S_c_o_r_e _F_i_l_e option under the _M_o_d_u_l_e menu in
the Cecilia editor window.


Important note on some of the tutorial examples using sound-
fiole inputs:

Examples ex2-5, ex3-2, ex5-1, ex5-2, ex5-3, ex5-3-2,  ex5-6,
ex5-7,  ex5-8  and  ex5-8  make use of Csound unit generator
_s_o_u_n_d_i_n or _d_i_s_k_i_n_g and require link pointers  to  particular
soundfiles that are read in from the _s_f_l_i_b directories.  You
can create all of thenecessary links for all of these  exam-
ples  (without  which  these  jobs  will  not run) by typing
_m_k_t_u_t_s_f_l_i_n_k_s in a shell window.  This will create  a  series
of  files in your current working soundfile directory called
_s_o_u_n_d_i_n._1, _s_o_u_n_d_i_n._2 and so on.
To remove all of the link files in your soundfile  directory
that  were  created by the _m_k_t_u_t_s_f_l_i_n_k_s command, when you no
longer will be using modules, type rmtutsflinks in  a  shell
window.

                      January 15, 1999


