home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / muzpak1.zip / MUZIKA.TXT < prev    next >
Text File  |  1990-07-22  |  16KB  |  478 lines

  1.  
  2.  
  3. MUZIKA
  4.  
  5. User's Guide
  6.  
  7. Software Version 1.0
  8.  
  9. Lavy Libman & Yakov Aglamaz
  10.  
  11. July 1992
  12.  
  13.  1Introduction 
  14.  
  15. 1.1    Musical software packages
  16.  
  17. Musical software packages at the market today allow the user to perform a 
  18. variety of functions that can be split into several categories:
  19.  
  20. o Musical analyzers: Sample analog signals and show information about them 
  21. including frequency spectrum, loudness, etc.
  22.  
  23. o Sequencers: Allow MIDI communication with musical instruments, convert-
  24. ing whatever is played into musical notes or some other notation.
  25.  
  26. o Note recognizers: Recognize bitmap files into digital representation. Bitmap 
  27. files could be generated by optical scanners, thus allowing the user to convert 
  28. regular note books into files that can be played by the computer.
  29.  
  30. o Score editors: Input musical notes, display them on the screen, edit, print and 
  31. play them.
  32.  
  33. 1.2    The Muzika package
  34.  
  35. Muzika is a software package from the fourth category. It was created for fill-
  36. ing a hole in this category for PC users: not many packages were written for the 
  37. PC, none for Microsoft Windows.
  38.  
  39. Muzika is a Musical notes editor - a tool used for writing musical note books, 
  40. printing them and creating MIDI files for playing the music by other tools.
  41.  
  42. Muzika's environment provides tools for composing, playing, and printing 
  43. melodies. A melody can consist of several parts; any of them can have upto 5 
  44. staves, in any key.
  45.  
  46. Some of he features provided by Muzika include:
  47.  
  48. o Easy inserting notes and other signs into the melody.
  49.  
  50. o Cutting, copying and pasting parts of the melody.
  51.  
  52. o Displaying and printing the melody in two modes: as one part or as a score.
  53.  
  54. o Creating MIDI files for playing the melody by other tools.
  55.  
  56. All these functions are achieved easily by clicking the mouse button. The mel-
  57. ody is visible all the time allowing the user to see and play the melody easily 
  58. while he composes it. The functions are easy to find and use through the pop-
  59. down menus.
  60.  
  61.  2Main window structure
  62.  
  63. The main window is divided to four visual sections:
  64.  
  65. o Edit mode symbols.
  66.  
  67. o Active symbol set region.
  68.  
  69. o Status line.
  70.  
  71. o Editing area.
  72.  
  73. 2.1    Edit mode symbols
  74.  
  75. The edit mode symbols consist of three symbols: pencil, eraser and hand. They 
  76. are used at the editing:
  77.  
  78. o Pencil - for drawing new staves.
  79.  
  80. o Eraser - for deletion.
  81.  
  82. o Hand - for dragging objects.
  83.  
  84. For the usage of these see the "Using the symbols" chapter (page 11).
  85.  
  86. 2.2    Active symbol set region
  87.  
  88. The symbol set region is divided to several slots. The slot corresponding to the 
  89. active symbol is shown in reverse video. Currently, several symbol sets are avail-
  90. able. These are listed below:
  91.  
  92. o Notes and pauses.
  93.  
  94. o Keys.
  95.  
  96. o Beats.
  97.  
  98. o Bars.
  99.  
  100. o Loudness symbols.
  101.  
  102. o Text.
  103.  
  104. For the usage of these see the "Using the symbols" chapter (page 11).
  105.  
  106. 2.3    Status line
  107.  
  108. The status line displays information about the current status of the display. 
  109. Such parameters as the currently displayed part and the visible staves are shown.
  110.  
  111. 2.4    The editing area
  112.  
  113. The editing area displays the contents of the melody workspace. In other 
  114. words, the staves and the musical signs on them are shown. The editing area can 
  115. display either a single part or an entire score, with several parts shown simulta-
  116. neously. The control over the display settings is available via the Layout menu. 
  117. For further details see the "Using the menu" chapter (page 5).
  118.  
  119.  3Using the menu
  120.  
  121. The main menu contains five sub-menus:
  122.  
  123. o File.
  124.  
  125. o Print.
  126.  
  127. o Layout.
  128.  
  129. o Symbols.
  130.  
  131. o Help.
  132.  
  133. These sub-menus are explained in detail in the following sections.
  134.  
  135. 3.1    The File sub-menu
  136.  
  137. The File sub-menu contains file oriented commands:
  138.  
  139. 3.1.1    New
  140.  
  141. The New command item opens a dialog box that asks for the staff width that 
  142. the user wishes to work with. A list of three widths is supplied (all in pixel 
  143. units) from which the user should select one. These widths were chosen for 
  144. comforting the editing on screens of different resolutions: 640x480, 800x600, 
  145. or 1024x768 pixels.
  146.  
  147. After the width is chosen, the user is presented with a clean workspace. By 
  148. default the empty melody contains one part, named UNNAMED. The new mel-
  149. ody itself is untitled until it is saved for the first time.
  150.  
  151. If the New operation is selected when there is a melody in the workspace 
  152. that has been modified since the last save, the changes to the previous melody 
  153. are not automatically saved. Therefore New asks the user for confirmation 
  154. before destroying the previous melody.
  155.  
  156. 3.1.2    Open
  157.  
  158. The Open command item opens a file selection box. It allows the user the 
  159. choose the drive and directory from which the file is to be selected. Then the 
  160. directory contents is displayed, and double-clicking the file name from the file 
  161. list loads it into the memory. The default extension for Muzika melody files is 
  162. *.MUZ. However, it can be changed, or even the entire filename typed manu-
  163. ally via the keyboard.
  164.  
  165. If the Open operation is selected when there is a melody in the workspace 
  166. that has been modified since the last save, the changes to the previous melody 
  167. are not automatically saved. Therefore Open asks the user for confirmation 
  168. before destroying the previous melody.
  169.  
  170. 3.1.3    Save
  171.  
  172. The Save command item used for saving the current melody. The saving is 
  173. done to the same file from which it was loaded from.
  174.  
  175. In the case that the melody was untitled, the Save as dialog box is opened. 
  176. (See below).
  177.  
  178. 3.1.4    Save as
  179.  
  180. The Save as command item opens a file selection box. The directory and 
  181. drive can be chosen with mouse clicks. The new filename is to be written at the 
  182. top.
  183.  
  184. Clicking the OK button saves the melody in the new filename (containing 
  185. the new path). This also changes change the title of the window to the new 
  186. name.
  187.  
  188. As warning message is displayed if the given file already exists. The user is 
  189. requested to confirm overwriting the file, or he can cancel the operation.
  190.  
  191. 3.1.5    Create MIDI
  192.  
  193. This last command item is used for playing melodies by other tools. Create 
  194. MIDI saves the melody in standard MIDI format that can be read and played as 
  195. voice by various special-purpose tools that are available on the market. The 
  196. file is saved with the same name with `.MID' extension.
  197.  
  198. NOTE: This file cannot be re-read into Muzika and thus regular saving is a 
  199. must for re-editing the file later with Muzika.
  200.  
  201. 3.2    The Print command
  202.  
  203. The Print command is printing the edited melody in the same mode as the cur-
  204. rent display: as a score or a single part.
  205.  
  206. NOTE: no further notice is given. Selecting this item will print the melody 
  207. immediately
  208.  
  209. 3.3    The Layout sub-menu
  210.  
  211. Layout is the home sub-menu for driving operations that concern the layout of 
  212. the display. It is here that the user switches between single-part or score display. 
  213. The specific choices are listed below.
  214.  
  215. 3.3.1    Parts
  216.  
  217. Selecting the Parts command opens a parts list dialog box. In this box, the 
  218. user can see and/or change the parts layout of the melody. The buttons in the 
  219. dialog box allow adding or removing parts, or changing attributes of existing 
  220. parts. A precise list of the dialog box buttons follows:
  221.  
  222. Attributes changes the selected part's attributes. For example, you may want 
  223. to select the musical instrument that is to play the part.
  224.  
  225. New adds a new part. Another dialog box appears, prompting the user to 
  226. enter the new part's name and staff multiplicity. Staff multiplicity means, how 
  227. many single staves are grouped together in each multiple staff. This parameter 
  228. cannot be changed after the part is created.
  229.  
  230. Remove removes the selected part. If the selected part is not empty, a warn-
  231. ing message appears with a request of confirmation. Also, a part cannot be 
  232. removed if it is the currently visible one, or if it is the only one in the entire 
  233. melody.
  234.  
  235. OK should be selected after the requested changes have been made.
  236.  
  237. 3.3.2    Page
  238.  
  239. Selecting the Page command opens a Page dialog box. The dialog box 
  240. allows to make some settings that are directly concerned with the display. 
  241. Among the settings that are made through this dialog box are:
  242.  
  243. o The kind of the display: either a score (all parts) or a single part.
  244.  
  245. o If it is a single-part display, what part should be shown.
  246.  
  247. o The default staff height, in pixels. Actually, this is the default distance 
  248. between adjacent staves, including signs that are outside a staff (such as a 
  249. loudness symbol or a text instruction of any kind). The number entered 
  250. here is only a default; after staves are created, they can be manually moved 
  251. by the hand symbol (see the "Using the symbols" chapter (page 11)).
  252.  
  253. o The default object width, in pixels. This number can be thought of as a 
  254. granularity of an invisible grid of places on which objects can be placed. In 
  255. other words, for example, if the object width is 20 pixels (the default), then 
  256. objects cannot be put closer than 20 pixels away from one another.
  257.  
  258. As in any Windows dialog box, after concluding the page layout settings, 
  259. click on the OK button for the changes to take effect.
  260.  
  261. 3.3.3    Reformat
  262.  
  263. The Reformat command item reformats the entire part. Blanks between 
  264. objects are deleted and the notes are equally spaced, according to their dura-
  265. tions.
  266.  
  267. 3.4    The Symbols sub-menu
  268.  
  269.  This menu chooses the set of symbols to appear in the Active symbol set 
  270. region. The first 6 menu items contain actual musical symbols, with which 
  271. objects are created in the melody. The last one is a set of block operations, includ-
  272. ing marking, clipping and pasting. For instructions about inserting objects using 
  273. these sets see the "The musical symbols" chapter (page 11).
  274.  
  275. 3.4.1    Notes
  276.  
  277. Notes and breaks appear in the Active symbol set region. The currently sup-
  278. ported objects are: full, half, quarter, eighth and sixteenth - both for notes and 
  279. for breaks.
  280.  
  281. 3.4.2    Keys
  282.  
  283. F or G standard keys.
  284.  
  285. 3.4.3    Beats
  286.  
  287. The beat object can appear anywhere on the staff, not only at staff start. 
  288. Currently supported: 2/4, 3/4, 4/4, 2/8, 3/8, 4/8 and 6/8.
  289.  
  290. 3.4.4    Bars
  291.  
  292. These are some commonly-used bar signs. The signs included are: the sin-
  293. gle bar separator, the double bar separator, and the thick staff-beginning or 
  294. staff-ending bar separators.
  295.  
  296. 3.4.5    Loudness
  297.  
  298. The currently supported loudness symbols are: Forte, Fortissimo, Piano, 
  299. Pianissimo, Crescendo, and Diminuendo. All loudness signs are common to a 
  300. multiple staff, appearing below it no matter where you insert a loudness object.
  301.  
  302. 3.4.6    Text
  303.  
  304. Text instructions (e.g. Allegro) can be inserted anywhere in a melody, either 
  305. above or below a staff. The Text symbol is used for this purpose.
  306.  
  307. 3.4.7    Block operations
  308.  
  309. Selecting the Block operations menu item will select four special symbols at 
  310. the Active symbol set region. These are used for performing block operations 
  311. on the part being display. The symbols are: Mark, Copy, Cut and Paste. For 
  312. more details on these see "The block operation symbols" on page 13.
  313.  
  314. 3.5    The help sub-menu
  315.  
  316. Unfortunately, the current implementation of Muzika does not contain any on-
  317. line help. Therefore the only item in this menu is:
  318.  
  319. 3.5.1    About
  320.  
  321. The About menu item shows the corresponding dialog box. The dialog box 
  322. displays such information as: the version of Muzika (currently 1.0), the soft-
  323. ware developers, and an icon.
  324.  
  325.  4Using the symbols
  326.  
  327.  
  328.  
  329. This chapter concludes, finally, everything about editing except what concerns 
  330. the menu. What the user should especially note is the extreme ease of the editing 
  331. process using the mouse.
  332.  
  333. 4.1    The musical symbols
  334.  
  335. Object are divided into two groups:
  336.  
  337. o Point objects: notes, breaks, keys, beats.
  338.  
  339. o Continuous objects:...
  340.  
  341. To insert a point object:
  342.  
  343. o Select the right set of objects from The Symbols sub-menu.
  344.  
  345. o Move the cursor to Active symbol set region and click over the wanted object.
  346.  
  347. o Move the cursor to The editing area in the wanted place and click the mouse.
  348.  
  349. o The new object will be added at the clicking spot. If the object was a note and 
  350. the clicking was over other notes they will be merged into one accord.
  351.  
  352. To insert a continuous object:
  353.  
  354. o Select the right set of objects from The Symbols sub-menu.
  355.  
  356. o Move the cursor to Active symbol set region and click over the wanted object.
  357.  
  358. o Move the cursor to The editing area in the wanted place for object start and 
  359. click the mouse but do not release it.
  360.  
  361. o Move the cursor to the wanted place for object end and release the mouse.
  362.  
  363. o The new object will be inserted between the where you click the mouse and 
  364. where you released it.
  365.  
  366. 4.2    The pencil symbol
  367.  
  368. Used for adding new staves:
  369.  
  370. o Select this item from the Edit mode symbols region.
  371.  
  372. o Move the cursor to the location of the new staff.
  373.  
  374. o When you click it, a new multiple staff appears.
  375.  
  376. Adding multiple staves can be anywhere on the working area. A click between 
  377. two staves will push the staves after the cursor one staff below and a new empty 
  378. staff will appear in the hole.
  379.  
  380. 4.3    The eraser symbol
  381.  
  382. Used for deleting objects:
  383.  
  384. o Select this item from the Edit mode symbols region.
  385.  
  386. o Move the cursor to the location of the object to be deleted. When deleting a 
  387. whole staff, just move the cursor anywhere on the staff.
  388.  
  389. o When clicking the mouse, the objects at the cursor position are erased. 
  390.  
  391. Clicking the mouse over a point with many objects will erase them all: click-
  392. ing over an accord will remove all the notes. Double-clicking it will delete the 
  393. entire multiple staff.
  394.  
  395. 4.4    The hand symbol
  396.  
  397.  With the hand you drag an object to a new place:
  398.  
  399. o Select this item from the Edit mode symbols region.
  400.  
  401. o Move the cursor to the object.
  402.  
  403. o Click the mouse button without releasing it.
  404.  
  405. o Move the cursor to the target location.
  406.  
  407. o Release the mouse button.
  408.  
  409. In the case that the object dragged was a note the note will be merged to an 
  410. accord if there were notes previously. If you double-click it, leaving the left but-
  411. ton pressed after the second click, the entire multiple staff is dragged. Again, if 
  412. the click was over a point with many objects, they will all be dragged.
  413.  
  414. 4.5    The block operation symbols
  415.  
  416. Each block operation symbol activates a different operation on a block. The 
  417. block can be of any length - single note, one bar and even an entire staff. There 
  418. are four block operations: Mark, Copy, Cut, and Paste. The general principle is 
  419. that there is always a single block in the clipboard (empty at start). Copy and Cut 
  420. will insert the Marked block into the clipboard and Paste will insert it to the mel-
  421. ody.
  422.  
  423. 4.5.1    Mark
  424.  
  425. Used for marking the block on which Copy and Cut will be used.
  426.  
  427. To activate this operation:
  428.  
  429. o Select Mark from Active symbol set region.
  430.  
  431. o Move the cursor to the start of the block.
  432.  
  433. o Click the mouse - without leaving it.
  434.  
  435. o Move the mouse to the end of the block.
  436.  
  437. o Release the mouse.
  438.  
  439. This marks the block: from the mouse click till the mouse release. The 
  440. marked block will be displayed in reverse-video.
  441.  
  442. 4.5.2    Copy
  443.  
  444. Used for duplicating blocks.
  445.  
  446. To activate just select Copy and click the mouse button anywhere in the 
  447. editing area.
  448.  
  449. The last Marked block will be copied into the clipboard. This block will be 
  450. kept in the clipboard until the next Cut or Copy. It can be added anywhere else 
  451. in the same melody, or even in a different melody, using Paste.
  452.  
  453. 4.5.3    Cut
  454.  
  455. Used for moving blocks and for deleting them.
  456.  
  457. To activate just select Cut and click the mouse button anywhere in the edit-
  458. ing area.
  459.  
  460. The last Marked block will be removed from the melody, but kept in mem-
  461. ory until the next Cut or Copy. It can be restored at a different place (either in 
  462. the same melody or a different one) using Paste.
  463.  
  464. 4.5.4    Paste
  465.  
  466. Used for inserting the block in clipboard into the melody.
  467.  
  468. To activate this operation:
  469.  
  470. o Select Paste from Active symbol set region.
  471.  
  472. o Move the cursor to the place you want to insert the block.
  473.  
  474. o Click the mouse.
  475.  
  476. The block in clipboard will be inserted to the melody starting at the mouse 
  477. click location.
  478.