You can now download, free of charge, KangaSound XML files from this listing page, for unrestricted use in your own
projects. Here are some guidance notes:
In order to use a downloaded KangaSound XML file, you will need version 3 or later of
the Kangas Sound Editor or Kangas Sound Editor QI installed on your computer.
Download the KangaSound XML .zip file of interest, extract the XML file from the .zip file, and note the location of the extracted XML file.
Next, import the extracted KangaSound XML file into the Kangas Sound Editor/QI from the menu item 'XML->Import...'.
After selecting the extracted XML file, a dialog entitled 'XML Import Run-time Parameters' will be shown.
The statistics at the bottom of the dialog tell you what is in the KangaSound XML file, in
terms of number of Sequences, Tracks, Compositions etc.
Before actually importing, press the 'Preview' button. This will predict what will happen when you
actually import without making any changes to the data. If there are errors shown in Preview,
you can often resolve the errors - e.g. by adding a prefix or suffix if there is a name
clash, and then press Preview again to see if the errors have been resolved.
When you are happy enough with the KangaSound XML file to import, press the Import button. This will
commence validation and import of the file into the Kangas Sound Editor/QI. If there are errors encountered,
you will be presented with a dialog that lets you examine them.
When the import has completed successfully, you will need to compute the imported elements in order to
generate .WAV sound files which you can listen to. The best way to do this depends on what you are importing (remember,
you can tell what you are importing from the statistics at the bottom of the 'XML Import Run-time Parameters' dialog):
Single Sequence. Select the imported Sequence box in the Edit Panel, and press the Compute button.
Multiple Sequences. If there are only a few Sequence boxes, then you could select and compute each Sequence
individually, and then select the Track they have been imported into, and then press the 'Compute kwik' button for the Track. If
there are many Sequences, then an alternative strategy is to select the Track they are in, and press either 'Compute' (to recompute
all Sequences in the Track) or 'Compute kwik' (to compute just the imported Sequences, and combine with pre-computed Sequences
elsewhere in the Track).
Single Track. Select the imported Track in the Edit Panel (a vertical line should appear), and press the
'Compute' button. Next, press the 'Compute stereo' button. You then have a choice of 'Play' or 'Play stereo' buttons depending on whether
you want to listen to the Track before or after any stereo factors have been applied.
Multiple Tracks. Firstly, apply the procedure for 'Single Track' for each Track you have imported. Next,
from the menu select 'Track 0'->Compute. This will combine all computed tracks in the Composition into Track 0, including the imported
Tracks (provided that each of the imported Tracks has the 'Include in track 0' checkbox checked). Finally, from the menu,
select 'Track 0'->Play to listen to the re-computed Composition.
Single Composition. Firstly, ensure the imported composition is the current one - if not, open it from
the 'Composition->Open...' menu item. Next, determine what Tracks are in the imported compostion. You can do this from the
'Composition->Open track' menu item. Finally, follow the procedure for 'Multiple Tracks' outlined above.
Multiple Compositions. For each Composition that you have imported, follow the procedure for 'Single Composition'
outlined above.
If you encounter any problems whilst downloading or importing KangaSound XML files, we recommend using the
KangaSound XML forum to get help.
If you use the KangaSound XML file in your own project and subsequently publish work based upon it, we request
that you give credit to the user who uploaded the file in question, by including a link to this web-page,
mentioning the username of the user who uploaded the file.
Can you also consider, at some stage, uploading KangaSound XML files based on your own work to this web-page?
This would help the KangaSound project to grow - without a sufficient number of uploaders, the project will always
remain small and of limited value.
We are now taking submissions of KangaSound XML files (ie ones generated by an XML export from Kangas Sound Editor/QI Version 3), that are to be listed in various categories on this web-page. Here are some guidelines:
The KangaSound XML file you supply a link to is expected to be contained and compressed inside a .zip file,
and will be uploaded to the KangaSound website when we process your submission. The current maximum size of zip file that we will accept is 10MB of size, due to space limitations on the KangaSound website.
If you are unable to supply a link (e.g. because you have no web-space of your own), then you can
email the zip file to Joey. In this case, we ask you to limit the zip file size to a
maximum of 1MB. If you can also supply in your email the details asked for on the form:
Submit your XML file
(except for "XML .zip file URL"), as this will help us to get the listing right.
The KangaSound XML file you supply will be available for others to download, import, customize and use free of charge in their own Kangas Sound Editor/QI tracks and compositions. It effectively becomes a very useful building block. In return for downloading your work, we request downloaders to give credit for any work they subsequently publish that at some stage involved an import of your KangaSound XML file, by mentioning your username and including a link to this web-page from their own web-page.
The KangaSound XML file should be a playable one, which means that it should contain at least one Sequence, possibly embedded within a Track or Composition (not all KangaSound XML files are playable - e.g. they may contain just Graphs or Harmonics).
There is no need to supply an audio file. We will generate one from the KangaSound XML file you supply, and embed a player control for it in your listing entry.
The KangaSound XML file should be a self-contained one. This can be achieved by ensuring that the checkbox 'Export dependent entities' is checked when exporting to XML.
To help avoid name clashes in the data, we request that you use a prefix when exporting to XML. We suggest that you use a prefix of 3 to 7 letters or digits, followed by an underscore. This could be an abbreviation of your username, for example.
The Kangas Sound Editor QI allows two entities of the same type whose names are differentiated only by their case, e.g. two Harmonic records may be defined in the same database, one called 'violin' and the other 'Violin'. The Kangas Sound Editor, on the other hand, does not allow this. To avoid this becoming a problem when collaborating through the XML facility, it is recommended that Kangas Sound Editor QI users do not differentiate the names of two entities of the same type only by case.
If you encounter any problems whilst exporting or submitting KangaSound XML files, we recommend using the
KangaSound XML forum to get help.
For taking the decision to upload your KangaSound XML file, Roo and Joey would like to thank you profusely for helping the
KangaSound project to grow, and become more useful to roos, joeys and humans alike!
