Contents Sound configuration GEM messages
Documentation of Aniplayer

6 Command line

If the command line contains at least one of the following options, the program is started as a TTP program:

  +annnnnnnnnn    : control program address (10 numbers max)
  +bnnnnn         : force number of planes for screen (5 numbers max)
  +d              : with DSP (-d: without DSP)
  +e              : display errors (-e: without, default +e)
  +hnnnnn         : force height of screen (5 numbers max)
  +i              : loop (-i: without)
  +jnnnnnnnnnn    : control program extension address (10 numbers max)
  +m              : with images (-m: sound only)
  +o name_target  : convert file (save in AVR/WAV/AIF/MP?/AC3/OGG/AVI/MOV)
  +p              : with sound (-p: turn off sound)
  +q              : with good quality (-q: without)
  +r              : resample sound (-r: don't resample)
  +s              : skip images (-s: all images)
  +wnnnnn         : force width of screen (5 numbers max)
  +xnnnnn, +ynnnnn: movie position (5 numbers max, default centre)
  +znnnnnnnnnn    : information address (10 numbers max)

 However, if the player detects the GEMJing options -dnnnnn or -rnnnnn,
the Aniplayer options listed above are ignored, and the following
options are recognised:

  -dnnnnn: Delay.  Sets a delay of nnnnn seconds (5 numbers max) between
           each repeat.  -d0 means there is no delay.  If the -d option
           is not supplied the default is -d0.
  -q:      Quit.  Plays a file and quits afterwards.  The menu bar
           disappears.
  -rnnnnn: Repeat.  The file is played nnnnn times (5 numbers max).
           -r1 means the file will be played once, -r0 means endless
           repeat.  If the -r option is not supplied, the default is -r1.
The path and name of file follow the options, e.g.:

+d +r C:\MOVIES\X.MOV read X.MOV with DSP and resample.

-p C:\MOVIES\*.MOV read all MOV files of directory without sound.

+p C:\MOVIES\*.* read all files of directory with sound.

Options not specified are taken from the ANIPLAY.INF file. If this file does not exist, the default options are +d +i +m +p +q +r +s.

The options direct display (see 'General options'), without GEM (see 'Display options'), and quit at the end (see 'Miscellaneous options') are selected.

The option speed control (see 'Movie options') and without D2D (see 'Miscellaneous options') are not selected.

This mode does not work in 4-colour video mode (GEM is not used). On the Falcon, if the image size is less than or equal to 320 * 240, the screen display will be in True Color.

If the movie position is selected (+x +y), the video mode will not change to True Color on the Falcon. In this mode, the screen background is not cleared. In video modes with bitplanes, x is set to a 16-pixel boundary.

The address (+a) is used to control the program. An example for programmers is better than an explanation:

 In C (simplified, see 'Keyboard shortcuts'):
 {
   Pexec(0,"ANIPLAY.PRG","+x100 +y100 +afunction C:\MOVIES\X.MOV","");
 }

 int function()
 {
   switch(code())
   {
   case END:
     return(0x1b);   /* ESC */
   case PAUSE:
     return(' ');
   case REW:
     return(0x4B34); /* SHIFT +   (-10S) */
   case FF:
     return(0x4D36); /* SHIFT +   (+10S) */
   }
   return(0);
 }
The extension address (+j) allows the program to be controlled by a method similar to the GEM message 'AP'; this address (here called ctrl) uses 3 words of 16 bits:

 - Message requesting a new position in seconds:

   ctrl[0] = 1
   ctrl[1] = seconds (high)
   ctrl[2] = seconds (low)

 - Message requesting a new position in images:

   ctrl[0] = 2
   ctrl[1] = image number (high)
   ctrl[2] = image number (low)

 - Message requesting information:

   ctrl[0] = 0
   ctrl[1] = pointer to following structure (high)
   ctrl[2] = pointer to following structure (low)

   typedef struct
   {
     short width;
     short height;
     short planes;
     short frames_second;
     long total_frames;
     long id_image_compression; /* cvid for example */
     short quality; /* B0: mono(0)/stereo(1)  B1: 8 bits(0)/16 bits(1) */
     unsigned short file_frequency;
     unsigned short machine_frequency;
     long total_samples;
     long id_sound_compression;   /* ima4 for example */
     short player_version;        /* version of Aniplayer */
     long count_seconds;
     long num_frame;
     short play;
     short reserve[11];
   } INFO_ANIM;
The 3 words are cleared by Aniplayer when the requested function is complete (information copied to the structure or a new position set).

The information address (+z) doesn't play the movie but returns information about it instead. This is designed for programmers; the address is that of a 32-byte buffer, as follows:

 struct infos
 {
   short width;
   short height;
   short planes;
   short frames_second;
   long total_frames;
   long id_image_compression; /* cvid for example */
   short quality; /* bit0: mono(0)/stereo(1)  bit1: 8 bits(0)/16 bits(1) */
   unsigned short file_frequency;
   unsigned short machine_frequency;
   long total_samples;
   long id_sound_compression;   /* ima4 for example */
   short version_player;        /* version of Aniplayer */
 }