Copyright (c) 2002-2005
  NMM work group,
  Computer Graphics Lab,
  Saarland University, Germany,
  http://www.networkmultimedia.org

Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be
found in the file COPYING.FDL.

1. Motivation

Developing (distributed) multimedia application with NMM is easy. This tutorial includes following examples.

• helloworld1: simple mp3 player using GraphDescription (no error handling, with access to 'serverregistry')

• helloworld11: simple mp3 player using GraphDescription with error handling and access to 'serverregistry'

• helloworld2: simple mp3 player creating flow graph manually with error handling and access to 'serverregistry'

• helloworld3: simple mp3 player using GraphDescription with error handling and access to 'serverregistry'; same code as helloworld11, but added listener for endTrack event

• helloworld4: simple mp3 player using GraphDescription with error handling and access to 'serverregistry'; same code as helloworld11, but implemented simple seeking functionality

• helloworld5: simple Ogg/Vorbis player using GraphDescription with error handling and access to 'serverregistry' same code as helloworld11, but using advanced node descriptions for audio decoder and audio sink

• hellonmm1 (modified version of helloworld11): distributed mp3 player using GraphDescription with error handling and access to 'serverregistry' : playback on remote host

• hellonmm2 (modified version of helloworld11) : distributed mp3 player using GraphDescription with error handling and access to 'serverregistry' : playback on local and remote host

• hellographbuilder1 : shows how to use the graph builder of NMM that automatically creates a flow graph from a given URL.

• hellographbuilder2 : shows how to use the graph builder of NMM that automatically creates a distributed flow graph from a given URL.

For all examples that can access a 'serverregistry', you can optionally start the program apps/registry/serverregistry. However, examples helloworld1, helloworld11, helloworld2, helloworld3, helloworld4, helloworld5, and hellographbuilder1 will work without a running 'serverregistry' as well. Notice: for examples hellonmm1 and hellonmm2 you do need a running serverregistry on a second remote host. For example hellographbuilder2 you do need running serverregistries on all remote hosts given.

'clic' (command line interaction and configuration) is an NMM application that allows to set up a distributed flow graph from a textual description. For helloworld1, hellonmm1, and hellonmm2, we also provide the corresponding graph description files to be used with 'clic'.

• helloworld1.gd: simple mp3 player

• hellonmm1.gd: distributed mp3 player

• hellonmm2.gd: distributed mp3 player : playback on local and remote host