CHAPTER 3 -- Setups & Programs Setup Objects We begin the discussion of editing objects with the setup object. We do so because the setup object window is relatively simple and serves to illustrate most of the user interface methods KLIB uses to edit all objects. So even though you may not be interested in editing setups, do not skip reading this and the next sections. To open a window for a setup object: >From the command center, select the setup type from the Object type button. Select the object you wish to edit in the Object name list. Push the Edit button & The window illustrated below appears. Tips : Whenever you pop up a new object window, the command center will immediately be covered by the new window. To bring the command center back to the top, press the F2 function key. This operation is valid in all windows for all types of objects. A setup object splits the K2000 keyboard into 3 zones. Each zone has its own program, channel, MIDI controller assignments, etc. KLIB represents this by a table with each row displaying a parameter field; and each column represents a zone. The methods to modify the different types of data are illustrated next. Try them out as you read along. Refer to the picture above to find visual examples of the fields we'll be using. Click on a cell on the row labeled key high . The arrows illustrated on the left appears. Click on these arrows to change the value of the cell. Think of these arrows as the alpha wheel on your K2000. The left pair of arrows increments or decrements the data by 10 clicks on the alpha wheel, The right pair 1 click. Common User Interface Elements ROM Indicator When an object is first uploaded from the K2000, and if the object is a ROM object, it is marked with that fact. The ROM checkbox serves as a reminder. The check is removed once you've modified the object and saved the changes. You cannot change the value of the indicator. The Download Button Push it to download an object wherever you see this button. Unlike the Download button in the command center (where you specify a set of objects to download), pushing this button downloads only the object being edited. The download dialog box appears momentarily and closes automatically after the operation is done. Member Object Fields Some K2000 objects refer to other objects. See Object Reference in the previous chapter. The referred object is typically displayed in a table cell, or in a list box, called a member object field. In the example above, the setup object refers to the effect object Arena displayed in the top list box. To select another effect object, use one of the three methods as you would do to select an object in the command center, namely, click the down-arrow button of the list box to drop down the list of effect objects, and pick one from the list, or type the desired effect object ID followed by enter , or type the first part or the entire object name followed by enter A setup object also refers to three program objects for the three zones. They are displayed in the top row of the table. To change a program selection, click on the cell you want to change. A floating list box of program objects pops up on that cell. Select the program you want in the same manner described above. If you change your mind and wish to cancel the operation, type the escape key. The floating list box will disappear without making any changes. You'll notice that the program object for Zone 2 in the example is labeled Ò(0)Ó instead of an object name. This is because that setup object makes a reference to program object 0.There is no program object 0 in the file. (It is, in fact,an invalid ID. In this case, it simply means that Zone 2 is not defined.) This is true in all member object fields. Whenever KLIB can't find an object with the given ID, it displays the ID enclosed in parentheses.You can still click on that cell and change it. Toggle Fields The rows labeled pitch bend and prog change are examples of togglefields. Click on these cells and the values displayed will switch between 2 or 3 values. In this example, they toggle between on and off The Soft Alpha Wheel After you're done with a field, click on the cell again and the soft alpha wheel will disappear. You can also click on another cell immediately if you wish to edit a different cell.The soft alpha wheel will move to that cell. KLIB uses the soft alpha wheel not only in table cells, but in many other types of visual elements of an object window. E.g., click on the effect mix window in the example, the soft alpha wheel will pop up there. A User Interface Glitch KLIB frequently uses tables to represent object data. An example of a table is the one in the setup object we've been discussing. Sometimes you can inadvertently scroll the table by clicking on a cell closed to the right or bottom edge of the table and slide across the edge while holding down the mouse button. The table will shift by a row to the left and a column to the top. When this happens, simply reverse it by clicking close to the left or top edge of the table and slide across the edge while holding the mouse button. The MIDI Controller List The last six rows in the setup object window represent MIDI controllers. To select a MIDI controller, click inside a cell. The MIDI controller dialog box pops up. There are 3 ways to select a MIDI controller: Pick one from the list. Not all controllers have names that appear on this list. Type the controller number in the Controller number field followed by enter. If you're selecting a controller for a function input, type the input value in the Function input field followed by enter. The value must be a number between -0.99 and 0.99. KLIB will round it to the nearest value that corresponds to a valid controllernumber. The Controller number field will change to reflect the selection. Push OK when you're done. The field where you clicked to pop up the MIDI list will display the new controller. It is typically displayed in an abbreviated form. Closing an Object Window You close a window in the usual Windows' way. Pull down the system menu on the upper left corner of the window and choose Close KLIB will prompt you to save the changes you may have made to the object. If you say no, all changes made to that object since you opened the window will be discarded. Note that saving the changes in this context simply means that the changes are now saved in RAM. You still have to push the Save or Save as button in the command center to save the object to the disk file. Program Objects To open a window for a program object: >From the command center, select the program type from the Object type button. Select the object you wish to edit in the Object name list.Push the Edit button.Now that you are familiar with the user interface methods we discussed in the previous or section, even a big window like this should pose no problem for you. We won't be explaining every field in this window. Again, you should refer to the K2000 Musicians' Guide for the meaning of the data. We'll outline the significant features controlling this window. Refer to the illustration on the next page.Programs have one or more layers. To move between layers, click the Layer selection arrows. The window redraws to display the selected layer's data. The window'stitle also reminds you of which layer you're editing. To change the algorithm of a layer, click the Algorithm selection arrows. DSP parameters To change a DSP function, click inside a DSP function box . A menu will pop up and you can click on the item you want. The menu choices vary with the algorithm.The realtime controls of the program's effect are displayed in the first column of the table inside the effect panel. Click on one of these cells and a menu containing the available controls will pop up. The choices vary with the effect. If the effect object does not exist in the file (indicated by the effect list box showing only a number), you will not be able to edit these fields. nstead of displaying the realtime control names, only numbers will appear in these cells. The five tables in the lower part of the window are the equivalents of the pitch , f1 , f2 , f3 , and f4 pages in the K2000. The cells in these tables are modified using the soft alpha wheel and the MIDI controller dialog box. The Layer button pops up the layer page. The Control sources button pops up the page to edit the lfo's, asr's, fun's and vtrig's. To select an LFO wave shape, click on a LFO wave shape cell and the following dialog box appears. Select a wave shape and push OK . Layer Management The layer management buttons are located on the top right corner of the window. They serve the following functions: Add a layer to the program. The layer is initialized with default values. To Duplicate a new layer using the current layer's data Delete To Delete the current layer. You cannot delete a layer if it's the only layer of the program. Import Create a new layer using the data in the clipboard, if there is any. Export Copy the current layer's data to the clipboard. The clipboard holds only one layer. When you push this button, the current layer in the clipboard, if there is any, will be overwritten. Editing Envelopes Push the Envelopes button on the main program window to pop up the envelope page. This page contains the equivalents of the env2 , env3 , ampenv , and the envctl pages in the K2000. The envctl portion of this window operates in the usual manner. Each of the 3 envelopes is represented by a line graph and the Data table below the graph. You can modify an envelope in either representation. To modify an envelope using the Data table , simply click in the cells to pop up the soft alpha wheel. An envelope's graph is divided into the left and right envelope panels . The left panel displays the graph of the attack and decay segments, the right displays the release segments. The x-axis denotes time and the y-axis denotes envelope levels. KLIB automatically adjust the relative widths of the two panels to represent the relative amount of time spent in the attack and release segments.To modify the envelope graphically, click anywhere inside the panels. The segment buttons appear. Each button represents a segment in the envelope and is labeled as such. [ E.g., the Ô1' button in the left panel represents the attack 1 segment, the ÔD' button represents the decay segment, etc. Drag a button around to change that segment's value. You cannot move a segment past the previous segment in the x-direction. You can push the Scale button any time prompting KLIB to recompute the relative widths of the attack and release panels. When the segment values are very close, the buttons can overlap or cover up each other. To bring the desired button to the top, click the corresponding cell in the Data table E.g., clicking the cell labeled decay brings the D button to the top. To exit graphical editing, click anywhere inside the panels again without pushing any button. The segment buttons disappear. If you wish to edit ampenv sure to check the User env checkbox to enable editing this envelope. Other Nested Pages Push the other three nested page buttons to pop up more nested pages. The Output button pops up the output page. The form of the output window depends on the algorithm and whether the keymap is a stereo sample or not. The example on the left above shows a double-output algorithm and a mono sample. The example on the right has a single-output algorithm and a stereo sample.