JET_Creator_User_Manual.html - Android社区 - https://www.androidos.net.cn/

<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 11">
<meta name=Originator content="Microsoft Word 11">
<link rel=File-List href="JET_Creator_User_Manual_files/filelist.xml">
<link rel=Edit-Time-Data href="JET_Creator_User_Manual_files/editdata.mso">
<link rel=OLE-Object-Data href="JET_Creator_User_Manual_files/oledata.mso">

<title>SONiVOX JET Creator User Manual</title>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
 name="place"/>

<style>

</style>

</head>

<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
	
<pre>
 Copyright (C) 2009 The Android Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
</pre>

<a name="_Toc203292246"></a><a
name="_Toc203298075">JETCreator� User Manual<o:p></o:p></a>

Vrs 1.0<o:p></o:p>

Content
Authoring Application for the

JET
Interactive Music Engine

<a
href="http://www.sonivoxrocks.com/">www.sonivoxrocks.com</a><o:p></o:p>

<o:p> </o:p>

<h1><a name="_Toc482161515"></a><a name="_Toc203298082"><![if !supportLists]>1        
<![endif]>Introduction</a></h1>

<h2><a name="_Toc203298083"><![if !supportLists]>1.1       
<![endif]>Overview</a></h2>

This document contains the user guidelines
for the SONiVOX JET Creator, an authoring application for creating and
auditioning JET files. JET is an interactive music player for small embedded
devices, including the Google Android platform. It allows applications to
include interactive music soundtracks, in <st1:place w:st="on">MIDI</st1:place>
format, that respond in real-time to game play events and user interaction.

<o:p> </o:p>

JET works in conjunction with SONiVOX�s
Embedded Audio Synthesizer (EAS) which is the <st1:place w:st="on">MIDI</st1:place>
playback device for Android.� Both the
JET and EAS engines are integrated into the Android embedded platform as well
as inherent in the JET Creator application. As such, the JET content author can
be sure that the playback will sound exactly the same in both the JET Creator
and the final Android application playing back on Android mobile devices.

<o:p> </o:p>

In addition to the graphical user
interface, there are two main functionalities taking place in JET Creator. The
first involves gathering all the source data (<st1:place w:st="on">MIDI</st1:place>
files and DLS file), adding JET�s real-time attributes and building a JET
(.jet) file that the Android application will use. The second functionality
involves auditioning the interactive playback elements as they will take place
in the Android application.

<o:p> </o:p>

The JET Creator application is written in
the Python programming language, therefore you need to have the current version
of Python and WXWidgets installed. There is both a Mac and Windows version.

<o:p> </o:p>

<h2><a name="_Toc203298084"><![if !supportLists]>1.2       
<![endif]>Abbreviations and Common Terms</a></h2>

<o:p> </o:p>

It is important to use a common set of
terms to minimize confusion. Since JET uses <st1:place w:st="on">MIDI</st1:place>
in a unique way, normal industry terms may not always suffice. Here is the
definition of terms as they are used in this document and in the JET Creator
application:

<o:p> </o:p>

Channel: MIDI data associated with a specific <st1:place w:st="on">MIDI</st1:place>
channel. Standard MIDI allows for 16 channels of <st1:place w:st="on">MIDI</st1:place>
data each of which are typically associated with a specific instrument.

<o:p> </o:p>

Controller: A <st1:place w:st="on">MIDI</st1:place> event consisting of a
channel number, controller number, and a controller value. The <st1:place
w:st="on">MIDI</st1:place> spec associates many controller numbers with
specific functions, such as volume, expression, sustain pedal, etc. JET also
uses controller events as a means of embedding special control information in a
<st1:place w:st="on">MIDI</st1:place> sequence to provide for audio synchronization.

<o:p> </o:p>

DAW: Digital Audio Workstation. A common term for <st1:place w:st="on">MIDI</st1:place>
and audio sequencing applications such as Logic, SONAR, Cubase and others.

<o:p> </o:p>

EAS: Embedded <st1:place w:st="on">MIDI</st1:place> Synthesizer. The
name of the SONiVOX MIDI synthesizer engine.

<o:p> </o:p>

JET: Jet Interactive Engine. The name of the SONiVOX JET interactive
music engine.

<o:p> </o:p>

M/B/T: Measures, Beats and Ticks

<o:p> </o:p>

Segment: A musical section such as a chorus or verse that is a component of
the overall composition. In JET, a segment can be an entire MIDI file or a
derived from a portion of a <st1:place w:st="on">MIDI</st1:place> file.

<o:p> </o:p>

SMF-0: Standard MIDI File Type 0, a MIDI file that contains a single
track, but may be made up of multiple channels of <st1:place w:st="on">MIDI</st1:place>
data.

<o:p> </o:p>

SMF-1: Standard MIDI File Type 1, a MIDI file that contains a one more
tracks, and each track may in turn be made up of one or more channels of <st1:place
w:st="on">MIDI</st1:place> data. By convention, each channel is stored on a
separate track in an SMF-1 file. However, it is possible to have multiple MIDI
channels on a single track, or multiple tracks that contain data for the same <st1:place
w:st="on">MIDI</st1:place> channel.

<o:p> </o:p>

Track: A single track in a DAW containing a timed sequence of <st1:place
w:st="on">MIDI</st1:place> events. Be careful not to confuse Tracks with
Channels. A MIDI file may contain many tracks with several tracks utilizing the
same <st1:place w:st="on">MIDI</st1:place> channel.

<o:p> </o:p>

<h1><a name="_Toc203298085"></a><a name="_Toc135723076"></a><a
name="_Toc135723793"></a><a name="_Toc135724016"></a><a name="_Toc135724241"></a><a
name="_Toc135724464"></a><a name="_Toc135724687"></a><a name="_Toc135724909"></a><a
name="_Toc135725132"></a><a name="_Toc135726607"></a><a name="_Toc135727776"></a><a
name="_Toc137004452"></a><a name="_Toc135724689"></a><a name="_Toc135724467"></a><![if !supportLists]>1        
<![endif]>The JET Interactive Music Concept</h1>

Interactive music can be defined as music
that changes in real-time according to non-predictable events such as user
interaction or game play events. In this way, interactive music is much more
engaging as it has the ability to match the energy and mood of a game much
closer than a pre-composed composition that never changes. In some applications
and games, interactive music is central to the game play. Guitar Hero is one
such popular game. When the end user successfully �captures� the musical notes
coming down the fret board, the music adapts itself and simultaneously keeps
score of successes and failures. JET allows for these types of music driven
games as well.

<o:p> </o:p>

There are several methods for making and
controlling interactive music and JET is one such method. This section
describes the features of JET and how they might be used in a game or software
application. It also describes how JET can be used to save memory in small
footprint devices such as Android enabled mobile handsets.

<h3><a name="_Toc203298086"><![if !supportLists]>1.1.1       <![endif]>Data Compression</a><o:p></o:p></h3>

JET supports a flexible music format that
can be used to create extended musical sequences with a minimal amount of data.
A musical composition is broken up into segments that can be sequenced to
create a longer piece. The sequencing can be fixed at the time the music file
is authored, or it can be created dynamically under program control.

<h3><a name="_Toc203298087"><![if !supportLists]>1.1.2       <![endif]>Linear Music Example</a><o:p></o:p></h3>

<![if !vml]><img border=0 width=575 height=393
src="JET_Creator_User_Manual_files/image002.gif" v:shapes="_x0000_i1025"><![endif]>

Figure 1: Linear Music Piece

<o:p> </o:p>

This diagram shows how musical segments are
stored. Each segment is authored as a separate <st1:place w:st="on">MIDI</st1:place>
file. A post-processing tool combines the files into a single container file.
Each segment can contain alternate music tracks that can be muted or un-muted
to create additional interest. An example might be a brass accent in the chorus
that is played only the last time through. Also, segments can be transposed up
or down.

<o:p> </o:p>

The bottom part of the diagram shows how
the musical segments can be recombined to create a linear music piece. In this
example, the bridge might end with a half-step key modulation and the remaining
segments could be transposed up a half-step to match.

<h3><a name="_Toc203298088"><![if !supportLists]>1.1.3         
<![endif]>Non-linear Music Example</a></h3>

<![if !vml]><img border=0 width=576 height=389
src="JET_Creator_User_Manual_files/image004.gif" v:shapes="_x0000_i1026"><![endif]>

Figure 2: Non-linear music piece

<o:p> </o:p>

In this diagram, we see a non-linear music
piece. The scenario is a first-person-shooter (FPS) and JET is providing the
background music. The intro plays as the level is loading and then transitions
under program control to the Searching segment. This segment is repeated indefinitely,
perhaps with small variations (using the mute/un-mute feature) until activity
in the game dictates a change.

<o:p> </o:p>

As the player nears a monster lair, the
program starts a synchronized transition to the Danger segment, increasing the
tension level in the audio. As the player draws closer to the lair, additional
tracks are un-muted to increase the tension.

<o:p> </o:p>

As the player enters into combat with the
monster, the program starts a synchronized transition to the Combat segment.
The segment repeats indefinitely as the combat continues. A Bonus Hit
temporarily un-mutes a decorative track that notifies the player of a
successful attack, and similarly, another track is temporarily un-muted to
signify when the player receives Special Damage.

<o:p> </o:p>

At the end of combat, the music transitions
to a victory or defeat segment based on the outcome of battle.

<h3><a name="_Toc203298089"><![if !supportLists]>1.1.4         
<![endif]>Mute/Un-mute Synchronization</a></h3>

JET can also synchronize the muting and
un-muting of tracks to events in the music. For example, in the FPS game, it would
probably be desirable to place the musical events relating to bonuses and
damage as close to the actual game event as possible. However, simply un-muting
a track at the moment the game event occurs might result in a music clip
starting in the middle. Alternatively, a clip could be started from the
beginning, but then it wouldn�t be synchronized with the other music tracks.

<o:p> </o:p>

However, with the JET sync engine, a clip
can be started at the next opportune moment and maintain synchronization. This
can be accomplished by placing a number of short music clips on a decorative
track. A <st1:place w:st="on">MIDI</st1:place> event in the stream signifies
the start of a clip and a second event signifies the end of a clip. When the
application calls the JET clip function, the next clip in the track is allowed
to play fully synchronized to the music. Optionally, the track can be
automatically muted by a second <st1:place w:st="on">MIDI</st1:place> event.

<o:p> </o:p>

<![if !vml]><img border=0 width=576 height=155
src="JET_Creator_User_Manual_files/image006.gif" v:shapes="_x0000_i1027"><![endif]>

Figure 3: Synchronized Mute/Unmute

<h2><a name="_Toc203298090"><![if !supportLists]>1.2       
<![endif]>Audio Synchronization</a></h2>

JET provides an audio synchronization API
that allows game play to be synchronized to events in the audio. The mechanism
relies on data embedded in the <st1:place w:st="on">MIDI</st1:place> file at
the time the content is authored. When the JET engine senses an event during
playback it generates a callback into the application program. The timing of
the callback can be adjusted to compensate for any latency in the audio
playback system so that audio and video can be synchronized. The diagram below
shows an example of a simple music game that involves pressing the left and
right arrows in time with the music.

<o:p> </o:p>

<![if !vml]><img border=0 width=576 height=134
src="JET_Creator_User_Manual_files/image008.gif" v:shapes="_x0000_i1028"><![endif]>

Figure 4: Music Game with Synchronization<o:p></o:p>

<o:p> </o:p>

The arrows represent events in the music sequence
where game events need to be synchronized. In this case, the blue arrow
represents a time where the player is supposed to press the left button, and
the red arrow is for the right button. The yellow arrow tells the game engine
that the sequence is complete. The player is allowed a certain time window
before and after the event to press the appropriate key.

<o:p> </o:p>

If an event is received and the player has
not pressed a button, a timer is set to half the length of the window. If the
player presses the button before the timer expires, the game registers a
success, and if not, the game registers a failure.

<o:p> </o:p>

If the player presses the button before the
event is received, a timer is set to half the length of the window. If an event
is received before the timer expires, the game registers a success, and if not,
the game registers a failure. Game play might also include bonuses for getting
close to the timing of the actual event.

<o:p> </o:p>

<h1><a name="_Toc203298091"><![if !supportLists]>2        
<![endif]>JET Content Authoring Overview</a></h1>

To author JET files and hear them playback
interactively, the content author will work in two applications which are
designed to work together smoothly. The first is application is any
off-the-shelf <st1:place w:st="on">MIDI</st1:place> sequencing application that
supports VST (for PC) or AU (for Mac) plugins. Here the author will compose
their <st1:place w:st="on">MIDI</st1:place> music files using the plugin as the
synthesizer device. The second application is the JET Creator application. Here
the author will import their <st1:place w:st="on">MIDI</st1:place> music files
(and optionally a DLS2 soundset) and setup the conditions for interactive
playback within the JET enabled game. Optionally the content author may create
a custom set of DLS instruments using an instrument editor that supports the
DLS Level 2 format. One such application is Awave from MJSoft.

<o:p> </o:p>

Please see the JET Content Authoring Guidelines documentation for additional
details on content authoring.

<o:p> </o:p>

<h1><![if !supportLists]>3        
<![endif]>Installing and Launching JET
Creator</h1>

JET Creator is a python language
application, therefore, you must have Python and wxPython installed on your
machine.

<o:p> </o:p>

JetCreator was created and tested with:

<o:p> </o:p>

Python Version 2.5.4

wxPython Version 2.8.7.1

<o:p> </o:p>

These can be downloaded here:

<o:p> </o:p>

PC:

http://www.python.org/download/releases/2.5.4/

http://www.wxpython.org/download.php

<o:p> </o:p>

MAC:

http://wiki.python.org/moin/MacPython/Leopard

http://www.wxpython.org/download.php

<o:p> </o:p>

After installing Python and wxPython,
simply unzip or copy all the files in the JET Creator application directory to
a folder on your hard drive.

����������������������������������������������������

To launch JET Creator go to a command
prompt and set the directory to where you�ve installed Python. Next run python
with the command:

<o:p> </o:p>

python
jetcreator.py<o:p></o:p>

<o:p> </o:p>

<h1><a name="_Toc203298093"><![if !supportLists]>4        
<![endif]>Using JET Creator</a></h1>

<o:p> </o:p>

<h2><![if !supportLists]>4.1       
<![endif]>File Types</h2>

There are a few different file types
associated with JET Creator.

<o:p> </o:p>

.jtc������� JET
Creator project file. This file contains all the information associated with a
JET Creator project. When you Save or Save-as out of JET Creator, this file
type is saved.

<o:p> </o:p>

.jet������� JET
File. This output file is automatically generated from JET Creator whenever you
save your JET Creator project. This is the file that bundles all JET assets
together into a single file that the Android application will use. Give this
file to the Android application developer.

<o:p> </o:p>

.mid����� <st1:place
w:st="on">MIDI</st1:place> File. This is the standard <st1:place w:st="on">MIDI</st1:place>
type 1 file that JET Creator will use to make segments.

<o:p> </o:p>

.seg����� Segment
File. This is a JET Segment file. It has the same name as the <st1:place w:st="on">MIDI</st1:place>
file which it references but contains additional Segment information.

<o:p> </o:p>

.zip������ Zip
Archive file. When you Export a JET Archive, a zip file is created that
contains all the assets (files) necessary for JET Creator. Use this to transfer
JET Creator projects to other people.

<o:p> </o:p>

<h2><a name="_Toc203298094"><![if !supportLists]>4.2       
<![endif]>Open Dialog</a></h2>

When
you first launch JET Creator you are presented with an open dialog like the
following.

<o:p> </o:p>

<![if !vml]><img border=0 width=450 height=285
src="JET_Creator_User_Manual_files/image010.jpg" v:shapes="_x0000_i1029"><![endif]>

<o:p> </o:p>

Open will open an existing .jtc (JET Creator file) file. Use the browser
button to browse to the directory where you have saved your .jtc file.

<o:p> </o:p>

New will create a new .jtc file.

<o:p> </o:p>

Import will import a JET Archive (.zip) file.

<o:p> </o:p>

Cancel will cancel the dialog and exit the application.

<o:p> </o:p>

<h1><a name="_Toc203298100"><![if !supportLists]>5        
<![endif]>Main Window</a> </h1>

The main window of the JET Creator
application looks like the picture below. There are three main sections from
top to bottom: segment view, event view, and timeline.

<o:p> </o:p>

The segment view section displays a list of
the current segments, which <st1:place w:st="on">MIDI</st1:place> file and
(optionally) DLS2 file each segment is derived from. It also shows each
segments start and stop time and each segments quantize, transpose, repeat and
mute flag settings.

<o:p> </o:p>

Just below the Segment view is the event
view. The event view section displays all events associated with a given
segment. Events only display when the segment they are assigned to is
highlighted. Each event displays its type, start and end points, track and midi
channel assignment, and its event ID.

<o:p> </o:p>

Just below the Event view is the timeline
display. The timeline shows how many measures a given segment is as well as any
events associated with that segment. The timeline changes to display the
currently selected or playing segment. You can trigger an event in this window
while the segment is play by simply clicking on the event in the timeline
display.

<o:p> </o:p>

<![if !vml]><img border=0 width=554 height=378
src="JET_Creator_User_Manual_files/image012.jpg" v:shapes="_x0000_i1030"><![endif]>

<o:p> </o:p>

JET
Creator Main Window<o:p></o:p>

<o:p> </o:p>

The buttons along the left side of main
window do the following:

<o:p> </o:p>

Add:������������������� -
Displays the segment or event window for adding a new segment or event

Revise:��������������� -
Displays the segment or event window for updating an existing segment or event

Delete:���������������� -
Deletes the selected segment or event (will ask for confirmation)

Move:����������������� -
Displays the move window which allows you to move selected segments or events
in time

Queue All:����������� - Queue�s
(selects) all segments for playback

Dequeue All:������� - Dequeue�s
(deselects) all segments

Play:������������������� -
Starts playback of all queue�d segments. This button changes to Stop if any
segments are playing

Audition:������������� -
Displays the Audition window (see below)

<o:p> </o:p>

<h2><a name="_Toc203298101"><![if !supportLists]>5.1       
<![endif]>Segment Window</a></h2>

The segment window is where a given
segment�s attributes are assigned and auditioned, as shown in the picture
below. The left side of the window displays the segments attributes that are
stored in the JET file. The right side of the window allows the author to set
mute flags, repeat and transpose settings and audition the segment as it will
play in the JET game.

<o:p> </o:p>

Note: the audition attributes (mute flags, repeat and transpose) are not stored in the JET content file
(.jet) but rather are defined by the game or application itself. In programming
language, these settings correspond directly with the API calls to the JET
engine. By including them here, the JET content author can simulate how the
segment will respond to the applications API commands during game play.

<o:p> </o:p>

<![if !vml]><img border=0 width=553 height=295
src="JET_Creator_User_Manual_files/image014.jpg" v:shapes="_x0000_i1031"><![endif]>

<o:p> </o:p>

The segment parameters do the following:

<o:p> </o:p>

Segment Name������������ - Sets
the name of the segment

MIDI File���������������������� -
The name and location of the <st1:place w:st="on">MIDI</st1:place> file from which
the segment is derived. The button to the immediate right will bring up a
browser for locating a midi file on the hard drive.

DLS File���������������������� -
The name and location of the DLS2 file, if any, that the <st1:place w:st="on">MIDI</st1:place>
file uses for that segment.

Starting M/B/T�������������� -
Starting measure, beat and tick of the segment

Ending M/B/T��������������� -
Ending measure, beat and tick of the segment

Quantize���������������������� -
Quantize value for quantizing the current segment during playback

<o:p> </o:p>

The audition fields are as follows:

<o:p> </o:p>

Track Mutes����������������� -
Shows the MIDI tracks (not channels)
in the <st1:place w:st="on">MIDI</st1:place> file. Clicking on a track�s
checkbox will mute that track.

Channel����������������������� -
Displays the <st1:place w:st="on">MIDI</st1:place> channel assigned to each
track

Name��������������������������� -
Displays the track name meta event (if present) for each track

Repeat������������������������� -
Indicates the number of times a segment should repeat during playback

Transpose�������������������� -
Indicates the transposition in semi-tones or half-steps a segment should
transpose during playback

<o:p> </o:p>

To the right of the Audition window are a few additional buttons.
These do as follows:

<o:p> </o:p>

OK������������������������������ -
Selecting OK confirms all segment settings and closes the segment window

Cancel������������������������� -
Selecting Cancel cancels any changes and closes the segment window

Replicate��������������������� -
Displays the Replicate Segment window for entering multiple segments at once.
See below.

Play/Stop Segment������ - Starts
or Stops playback of the segment using the segment attributes assigned.

Play/Stop MIDI File������ -
Starts or Stops playback of the <st1:place w:st="on">MIDI</st1:place> file
which the segment is assigned to.

Pause/Resume������������� -
Pauses or Resumes playback.

<o:p> </o:p>

<h2><a name="_Toc203298102"><![if !supportLists]>5.2       
<![endif]>Event Window</a></h2>

The event window is where a given segment�s
event attributes are assigned and auditioned, as shown in the picture below. To
add an event to a segment, the author must first select the segment which will
contain the event, then select the Add button. This will bring up the Event
window.

<o:p> </o:p>

<![if !vml]><img border=0 width=554 height=294
src="JET_Creator_User_Manual_files/image016.jpg" v:shapes="_x0000_i1032"><![endif]>

<o:p> </o:p>

There are two main sections to the event
window. The segment section on the left side of the event window is for display
only. It shows what the segment attributes are for the given segment. The Event
section, on the right side, is where events can be assigned. The following
parameters are available:

<o:p> </o:p>

Event Name������������������� -
Assigns a name to an event

Event Type�������������������� -
Selects which type of event to assign.

Starting M/B/T��������������� -
Sets the starting measure, beat, and tick for the event

Ending M/B/T���������������� -
Sets the ending measure, beat, and tick for the event, if applicable

Track����������������������������� -
Sets which track in the given segment the event will apply to

Channel������������������������� -
Sets which <st1:place w:st="on">MIDI</st1:place> channel the event will apply
to. The MIDI channel should match the <st1:place w:st="on">MIDI</st1:place>
channel of the track

Event ID������������������������ -
Sets the event ID for the event. Multiple events can be assigned to the same
segment and therefore the Event ID is used to identify them

<o:p> </o:p>

To the right of the Audition window are a few additional buttons.
These do as follows:

<o:p> </o:p>

OK������������������������������ -
Selecting OK confirms all event settings and closes the event window

Replicate��������������������� -
Displays the Replicate Event window for entering multiple events at once. See
below.

Play/Stop�������������������� -
Starts or Stops playback of the segment using the segment attributes assigned.
While the segment is playing, events can be triggered and auditioned.

Trigger������������������������� -
Triggers the event assigned. This replicates the API command that the JET game
will use to trigger the event, therefore giving the content author a method for
auditioning the behaviour of the event.

Mute/UnMute���������������� -
Mute/UnMute will mute or unmute the track that the event is assigned to

<o:p> </o:p>

To audition the behaviour of an event, you
can select the Play button. This will initiate playback. The trigger button
will send the trigger event when pressed. This is equivalent to selecting the
green trigger event in the timeline.

<o:p> </o:p>

Note: Trigger events are meant to unmute a
single track of a segment when triggered, then mute that track at the end of
the trigger segment. Therefore you should make sure the mute flag is set to
mute the track that a trigger event will be unmuting when receiving a trigger event.

<o:p> </o:p>

Please read Section 7 �Under The Hood�
below for details on how trigger events work and behave.

<o:p> </o:p>

<h2><![if !supportLists]>5.3       
<![endif]>Replicate Windows</h2>

Often in creating JET files, you�ll need to
create tens or even hundreds of events. You may also need to move events. The
Replicate and Move windows allow for this. There are two Replicate windows for
creating multiple segments or events. They look like the following:

<o:p> </o:p>

<![if !vml]><img border=0 width=395 height=419
src="JET_Creator_User_Manual_files/image018.jpg" v:shapes="_x0000_i1033"><![endif]>

<o:p> </o:p>

Replicate Segment Window

<o:p> </o:p>

<![if !vml]><img border=0 width=398 height=425
src="JET_Creator_User_Manual_files/image020.jpg" v:shapes="_x0000_i1034"><![endif]>

<o:p> </o:p>

Replicate Event Window

<o:p> </o:p>

Both Replicate windows function the same.
After creating an initial segment or event, you can select the Replicate
button. The parameters are as follows:

<o:p> </o:p>

Name Prefix����������������� -
Sets the prefix for the name of each segment or event created

Starting M/B/T�������������� -
Sets the starting time for the first segment or event

Increment M/B/T����������� -
Sets the time between segments or events created.

Number������������������������ -
Sets the number of segments or events you wish to create. If the number
overflows the length of the <st1:place w:st="on">MIDI</st1:place> file (for
segments) or segment (for events), those objects will not be created.

Preview������������������������ -
Preview allows you to examine the objects created before saying OK to insert
them.

<o:p> </o:p>

<h2><![if !supportLists]>5.4       
<![endif]>Move Windows</h2>

The Move function acts similarly to the
Replicate function in that it allows you to edit multiple segments or events at
one time, in this case move them in time. Like Replicate, there are two Move
windows, one for Segments and one for Events. The windows look like the
following:

<o:p> </o:p>

<![if !vml]><img border=0 width=400 height=424
src="JET_Creator_User_Manual_files/image022.jpg" v:shapes="_x0000_i1035"><![endif]>

<o:p> </o:p>

Move Event Window

<o:p> </o:p>

To use Move, first select the segments or
events you wish to move in time, then click the Move button. The parameters are
as follows:

<o:p> </o:p>

<h2><a name="_Toc203298103"><![if !supportLists]>5.5       
<![endif]>Audition Window</a></h2>

Clicking the Audition button in the main
window of the JET Creator application will open the Audition window. This is
where the content author or application programmer can simulate the interactive
playback as it may occur in the mobile application or game itself.

<o:p> </o:p>

<![if !vml]><img border=0 width=554 height=370
src="JET_Creator_User_Manual_files/image024.jpg" v:shapes="_x0000_i1036"><![endif]>

<o:p> </o:p>

JET Audition Window

<o:p> </o:p>

There are four main sections to the
audition window. The left most section displays the available segments and
their length in seconds. The middle section displays a running list of what
segments are queued for playback and what their playback status is. The far
right section displays the mute flags for the currently playing segment. The
timeline section at the bottom is the same as in the main window. It displays
the currently playing segment as well as a visual display of any event triggers
associated with that segment.

<o:p> </o:p>

The Audition window allows you to queue up
any segment in any order for playback. To do this simply select the segment you
wish to cue and hit Queue. That segment will appear in the queue window and
start playing (if it is the first segment). Subsequently you can select any
other segment or segments and cue them up for playback. As the segments
complete playback, the next segment in the queue will begin playing. As is the
other windows of JET Creator, you can mute, unmute, trigger event clips, etc.
in realtime as each segment is playing back.

<o:p> </o:p>

Specifically the buttons behave as follows:

<o:p> </o:p>

Queue�������������������������� -
loads the selected segment into the queue and starts playback

Cancel and Queue�������� -
cancels the currently playing segment before queueing the selected segment for
playback

Cancel Current�������������� -
cancels the currently playing segment in the queue and begins playback of the
next segment

Stop���������������������������� -
stops playback of all queued segments

Mute All����������������������� -
mutes all tracks in the current segment

Mute None������������������� -
unmutes all tracks in the current segment

Original Mutes�������������� -
sets the original mute flags for the current segment

<o:p> </o:p>

The combination of these playback options
allows an author or application programmer to audition any behaviour an
interactive music application may encounter.

<o:p> </o:p>

<h2><![if !supportLists]>5.6       
<![endif]>JET Creator Menus </h2>

The JET Creator menus provide access to
many of the parameters in the main window plus a few additional parameters.

The File Menu contains the following
elements:

<o:p> </o:p>

New����������������������������� -
Creates a new JET Creator file (.jtc)

Open��������������������������� -
Opens an existing JET Creator file

Save���������������������������� -
Saves the currently opened JET Creator file

Save As����������������������� -
Saves the currently opened JET Creator file to a new file

Import Project�������������� - Imports a JET Creator archive (.zip)

Export Project�������������� - Exports a JET Creator archive (.zip)

Exit����������������������������� -
Exits the application

<o:p> </o:p>

The Edit Menu contains the following
elements:

<o:p> </o:p>

Undo��������������������������� -
Undo will undo the last edit made

Redo��������������������������� -
Redo will redo the last undo

Cut������������������������������ -
Copy selected parameter into clipboard and Delete selection

Copy��������������������������� -
Copy selected parameter into clipboard and keep selection

Paste��������������������������� -
Paste selected parameter

<o:p> </o:p>

The Edit Menu contains the following
elements:

<o:p> </o:p>

Properties�������������������� -
Brings up the JET Creator priorities window. This window allows you to set the
following conditions for a given JET file:

Copyright Info�������������� - Contains copyright info to be inserted into JET file

Chase Controllers��������� - Option to chase controllers (on/off). This should usually
be ON.

Delete Empty Tracks���� - Deletes any empty <st1:place w:st="on">MIDI</st1:place> tracks

<o:p> </o:p>

<h3><a name="_Toc203298098"><![if !supportLists]>5.6.4         
<![endif]>Segments</a></h3>

The Segments Menu contains the following
elements:

<o:p> </o:p>

Add Segment��������������� -
Brings up the Segment window

Update Segment���������� - Updates segment attributes

Delete Segment����������������������� - Deletes the current segment from the
Segment List

<o:p> </o:p>

The Help Menu will contain at least the
following elements:

<o:p> </o:p>

JET Creator Help���������� - will launch PDF help document or go to on-line help

About�������������������������� -
JET Creator version number, SONiVOX info

<o:p> </o:p>

<h1><a name="_Toc203298104"><![if !supportLists]>6        
<![endif]>Trigger Events Explained</a></h1>

Breaking a <st1:place w:st="on">MIDI</st1:place>
file into individual (non-linear) segments and queueing up those segments for
playback in a game based on events within the game is one way JET music files are
interactive. Trigger events are an additional method for interactive playback.
Both would be used together in an interactive game or application.

<o:p> </o:p>

Trigger events allow for the following:

<o:p> </o:p>

<ol style='margin-top:0in' start=1 type=1>
 <li class=MsoNormal style='mso-list:l11 level1 lfo12;tab-stops:list .5in'>Tracks within a <st1:place
 w:st="on">MIDI</st1:place> segment can be turned on or off based on game
 events. For example the composer could author two drum tracks, one fast
 and one slow. If the action in a game is fast, the fast drum track could
 play. If the action in the game is slow, the slow drum track can play.</li>
 <li class=MsoNormal style='mso-list:l11 level1 lfo12;tab-stops:list .5in'>User actions can be compared to trigger events which are
 pre-inserted into a music file at musically �correct� places. Based on the
 results, scoring or other game actions can take place. </li>
 <li class=MsoNormal style='mso-list:l11 level1 lfo12;tab-stops:list .5in'>Musical transitions between levels or action sequences can be
 synchronized to be musically seemless.</li>
</ol>

<o:p> </o:p>

Under the hood, JET uses standard MIDI CC
events to accomplish these actions and to synchronize audio. The controllers
used by JET are among those not defined for specific use by the <st1:place
w:st="on">MIDI</st1:place> specification. The specific controller definitions
are as follows:

<o:p> </o:p>

����������� Controllers
80-83���������� Reserved for use by
application

����������� Controller
102��������������� JET event marker

����������� Controller
103��������������� JET clip marker

����������� Controllers
104-119������� Reserved for future use

<o:p> </o:p>

<h2><a name="_Toc203298105"><![if !supportLists]>6.1       
<![endif]>JET Clip Marker (CC103)</a></h2>

Controller 103 is reserved for marking
clips in a <st1:place w:st="on">MIDI</st1:place> track that can be triggered by
the JET_TriggerClip API call. The clip ID is encoded in the low 6 bits of the
controller value. Bit 6 is set to one to indicate the start of a clip, and set
to zero to indicate the end of a clip.

<o:p> </o:p>

For example, to identify a clip with a clip
ID of 1, the author inserts a <st1:place w:st="on">MIDI</st1:place> controller
event with controller=103 and value=65 at the start of the clip and another
event with controller=103 and value=1 at the end of the clip. When the
JET_TriggerClip() function is called with a clip ID of 1, the track will be
un-muted when the controller value 65 is encountered and muted again when the
controller value 1 is encountered.

<o:p> </o:p>

<![if !vml]><img border=0 width=492 height=367
src="JET_Creator_User_Manual_files/image026.gif" v:shapes="_x0000_i1037"><![endif]>

Figure 5: Synchronized Clip

<o:p> </o:p>

In the figure above, if the
JET_TriggerClip() function is called prior to the first controller event, Track
3 will be un-muted when the first controller event occurs, the first clip will
play, and the track will be muted when the second controller event occurs. If
the JET_TriggerClip() function is called after the first controller event has
occurred, Track 3 will be un-muted when the third controller event occurs, the
second clip will play, and the track will be muted again when the fourth
controller event occurs.

<o:p> </o:p>

Note: Normally, the track containing the clip is muted by the application
when the segment is initially queued by the call to JET_QueueSegment(). If it
is not muted, the clip will always play until Jet_TriggerClip() has been called
with the clip ID.

<o:p> </o:p>

<h2><a name="_Toc203298106"><![if !supportLists]>6.2       
<![endif]>JET Event Marker (CC102)</a></h2>

Controller 102 is reserved for marking
events in the <st1:place w:st="on">MIDI</st1:place> streams that are specific
to JET functionality. Currently, the only defined value is 0, which marks the
end of a segment for timing purposes.

<o:p> </o:p>

Normally, JET starts playback of the next
segment (or repeats the current segment) when the <st1:place w:st="on">MIDI</st1:place>
end-of-track meta-event is encountered. Some <st1:place w:st="on">MIDI</st1:place>
authoring tools make it difficult to place the end-of-track marker accurately,
resulting in synchronization problems when segments are joined together.

<o:p> </o:p>

To avoid this problem, the author can place
a JET end-of-segment marker (controller=102, value=0) at the point where the
segment is to be looped. When the end-of-segment marker is encountered, the
next segment will be triggered, or if the current segment is looped, playback
will resume at the start of the segment.

<o:p> </o:p>

The end-of-segment marker can also be used
to allow for completion of a musical figure beyond the end of measure that
marks the start of the next segment. For example, the content author might
create a 4-bar segment with a drum fill that ends on beat 1 of the 5th
bar � a bar beyond the natural end of the segment. By placing an end-of-segment
marker at the end of the 4th bar, the next segment will be
triggered, but the drum fill will continue in parallel with the next segment
providing musical continuity.

<o:p> </o:p>

<![if !vml]><img border=0 width=467 height=185
src="JET_Creator_User_Manual_files/image028.gif" v:shapes="_x0000_i1038"><![endif]>

Figure 6: End-of-segment Marker

<h2><a name="_Toc203298107"><![if !supportLists]>6.3       
<![endif]>Application Controllers
(CC80-83)</a></h2>

The application may use controllers in this
range for its own purposes. When a controller in this range is encountered, the
event is entered into an event queue that can be queried by the application.
Some possible uses include synchronizing video events with audio and marking a
point in a <st1:place w:st="on">MIDI</st1:place> segment to queue up the next
segment. The range of controllers monitored by the application can be modified
by the application during initialization.

<o:p> </o:p>

</div>

</body>

</html>

Html程序 | 3033行 | 123.2 KB

登录后可以享受更多权益