MP4Client(1)

NAME

MP4Client - GPAC MPEG-4 command-line Player

SYNOPSIS

MP4Client [options] [file]

DESCRIPTION

MP4Client is GPAC command-line player. It supports local playback, RTP streaming, HTTP faststart, many audio and video codecs, and most 2D features of MPEG-4. It also has JavaScript support.

STARTUP OPTIONS

-c file
    specifies config file to use. Default config file is located in user home directory and created if not found.

PLAYBACK OPTIONS
A file can be controled during playback by typing one of the following key at prompt.

o   connects to a new URL entered at prompt by user.

r   restarts the current presentation

p   plays/pauses the current presentation

s   step one frame ahead in the current presentation

z   seek into presentation. Seek percentage is entered at prompt

t   prints current timing of the main timeline of the presentation

w   prints world info of the current presentation

v   prints list of all ObjectDescriptor used in current presentation.

i   prints information of a given OD. Object ID is entered at prompt.

b   prints all objects timing and buffering info.

m   prints all objects buffering and memory info.

d   dumps current presentation scene graph to file or stdout.

k   Turns stress mode on/off.

n   Changes current navigation mode if possible/allowed. When a Layer3D is selected, sets layer3D navigation if allowed.

x   Reset to last active viewpoint. When a layer3D is selected, resets layer3D viewpoint.

2   Reload MPEG-4 Client with GPAC 2D Renderer.

3   Reload MPEG-4 Client with GPAC 3D Renderer.

4   forces 4/3 Aspect Ratio.

5   forces 16/9 Aspect Ratio.

6   forces no aspect ratio (always fill screen).

7   forces original Aspect Ratio (default mode).

l   prints the list of available plugins.

c   prints some GPAC configuration info.

q   quits the application.

C   enables streaming cache.

S   stops streaming cache and record it.

A   stops streaming cache and discard it.

h   prints list of available commands.

WINDOW SHORTCUTS
When MP4Client window has the focus, the following shortcuts are available

Alt + right
    Seeks 5% ahead from current time.

Alt + left
    Seeks 5% before the current time

Alt + up
    Increases volume by 5%

Alt + down
    Decreases volume by 5%

HOME
    Resets navigation to last bound viewpoint/viewport

4, 5, 6, 7
    Same as non-window values

ESCAPE , alt+return, doubleclick
    Toggles fullscreen on/off.

ctrl + 'f'
    Prints current rendering framerate.

ctrl + 'R'
    Sends a redraw message (complete scene state recompute).

ctrl + 'P'
    Play/Pause.

ctrl + 'S'
    Step one frame ahead.

CONFIGURATION FILE
When launched for the first time, MP4Client will ask for a font directory and a cache directory.

Font Directory
    Indicates the absolute path to a directory containing a TrueType font repository. In case this directory is not specified or does not contain valid TrueType fonts, text will be disabled.

Cache Directory
    Indicates the absolute path to a directory with write access to store files retrieved through HTTP downloads. In case this directory is not specified or has no write access HTTP downloads won't work.

NAVIGATION
Navigation with MP4Client depends on the renderer type (2D or 3D) and also on content - some content may disable user selectable navigation.

Walk & Fly modes
    Mouse: Horizontal move: Horizontal pan - Vertical move: Z-translate - Vertical move+CTRL or Wheel: Vertical pan - Right Click (Walk mode only): Jump Keys: left/right: Horizontal pan - left/right+CTRL: Horizontal translate - up/down: Z-translate - up/down+CTRL: Vertical pan

Pan mode
    Mouse: Horizontal move: Horizontal pan - Vertical move: Vertical pan - Vertical move+CTRL or Wheel: Z-translate Keys: left/right: Horizontal pan - left/right+CTRL: Horizontal translate - up/down: Vertical pan - up/down+CTRL: Z-translate

Slide mode
    Mouse: Horizontal move: Horizontal translate - Vertical move: Vertical translate - Vertical move+CTRL or Wheel: Z-translate Keys: left/right: Horizontal translate - left/right+CTRL: Horizontal pan - up/down: Vertical translate - up/down+CTRL: Z-translate

Examine & Orbit mode
    Mouse: Horizontal move: Y-Axis rotate - Horizontal move+CTRL: No move - Vertical move: X-Axis rotate - Vertical move+CTRL or Wheel: Z-translate Keys: left/right: Y-Axis rotate - left/right+CTRL: Horizontal translate - up/down: X-Axis rotate - up/down+CTRL: Y-translate

Game mode (press END to escape)
    Mouse: Horizontal move: H pan - Vertical move: Vertical pan Keys: left/right: Horizontal translate - up/down: Z-translate

All 3D modes
    CTRL+PGUP/PGDOWN will zoom in/out camera (field of view)

Slide Mode in 2D
    Mouse: Horizontal move: Horizontal translate - Vertical move: Vertical translate - V move+CTRL: zoom Keys: left/right: Horizontal translate - up/down: Vertical translate - up/down+CTRL: zoom

Examine Mode in 2D (3D renderer only)
    Mouse: Horizontal move: Y-Axis rotate - Vertical move: X-Axis rotate Keys: left/right: Y-Axis rotate - up/down: X-Axis rotate

SHIFT

FILES

GPAC Configuration File: ~/.gpacrc

AUTHORS

Jean Le Feuvre <jeanlf@users.sourceforge.net> - GPAC (c) 2000-2005

SEE ALSO

GPAC(1), MP42AVI(1), MP4Box(1)