Using cecilia on ECMC LInux and SGI systems: Cecilia is a front-end "environment" for running Csound jobs. To open cecilia, type cecilia( or else the abbreviation cec) in a shell window. If you don't want the applica- tion to tie up this shell window while it is running you can follow this command with an ampersand: cec & cecilia enables each user to customize his/her working environment within the application. Individual user prefer- ences can be set by selecting Preferences under the File menu, then editing values in the window that opens. Your personal preferences are stored in a file called .ceciliarc in your home directory. We have added some resources developed here at Eastman to the standard cecilia distribution. In order to access these Eastman resources, and also your home soundfile directory while working within the application, however, your .ceciliarc file must include certain definitions and pointers to these Eastman additions. To create a .ceciliarc file that includes these items, type mkcecprefs in a shell window. After creating this file, you can edit it at any time while you are working within cecilia by select- ing Preferences under the File menu. In the window advanced users can add the names of directories that include their own Csound orchestra and score files. Clicking on the _S_e_t _U_t_i_l_i_t_i_e_s button allows us to add our own choice of utility programs to one's working environment. Clicking on the _S_e_t _S_e_r_v_i_c_e _A_p_p_l_i_c_a_t_i_o_n_s button allows one to set sound- file play, info or editor preferences, but it is unlikely that you will ever want to change the default _S_e_r_v_i_c_e _A_p_p_l_i_- _c_a_t_i_o_n choices we have established. 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 will pop open a listing of all of the "modules" available within this directory, as well as any subdirectories with additional modules, and helpful _R_E_A_D_M_E files o+ Click on a module to select it and load the appropri- ate files into Cecilia for editing or compilation. _R_E_A_D_M_E files are opened in the same manner. Click on the _I_n_f_o button to display the contents of a _R_E_A_D_M_E file, or information about using a module file. You can make all of these selections in quick succes- sion 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_f_1 _d_i_r_e_c_t_o_r_y, _t_h_e _o_r_c_h_e_s_t_r_a _c_o_d_e _f_o_r _t_h_e _a_l_g_o_r_i_t_h_m _w_i_l_l _b_e _l_o_a_d_e_d _i_n_t_o _t_h_e _o_r_c_h_e_s_t_r_a _f_i_l_e _s_e_c_t_i_o_n _o_f _t_h_e _c_e_c_i_l_i_a _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 _P_r_e_v_i_e_w button to send Csound's output samples directly to the SGI DACs for listening, or o+ the _W_r_i_t_e button to write the samples into a sound- file. If you choose to write a new soundfile, name of this sound- file is determined in the _n_a_m_e box in the main cecilia win- dow. 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 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 _P_r_e_v_i_e_w button). DO NOT try to write the Csound output into a soundfile by clicking on the _W_r_i_t_e button. This will create a very large soundfile consisting 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. __________________________________________________ Eastman Utilities The Eastman utility programs we have added to those built-in to Cecilia are accessed under the _U_t_i_l_i_t_i_e_s menu in the main window. Currently, these utilities include the following: mktutsffuncs : many of the modules in section 5 of the _E_S_M_t_u_t_o_r_i_a_l group (such as _e_x_5-_1 and _e_x_5-_3) require link pointers to particular soundfiles that are read in from the _s_f_l_i_b directories. You can create all of these necessary links, without which some of these jobs will not run, by clicking on the _m_k_t_u_t_s_f_l_i_n_k_s button. 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. rmtutsffuncs to remove all of the link files in your sound- file directory that were created by the _m_k_t_u_t_s_f_l_i_n_k_s com- mand, when you no longer will be using modules such as _e_x_5-_1 and _e_x_5-_3, click on this button.