File: SCREENCloseMovie.c

package info (click to toggle)
psychtoolbox-3 3.0.19.14.dfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 86,796 kB
  • sloc: ansic: 176,245; cpp: 20,103; objc: 5,393; sh: 2,753; python: 1,397; php: 384; makefile: 193; java: 113
file content (49 lines) | stat: -rw-r--r-- 1,378 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/*

    Psychtoolbox3/Source/Common/SCREENCloseMovie.c

    AUTHORS:

    mario.kleiner.de@gmail.com      mk

    PLATFORMS:

    All.

    HISTORY:

    10/23/05  mk        Created.

    DESCRIPTION:

    Close a previously opened movie file and release all associated ressources.

*/

#include "Screen.h"

static char useString[] = "Screen('CloseMovie' [, moviePtr=all]);";
static char synopsisString[] = "Close movie object specified by 'moviePtr' and release all associated ressources.\n"
                               "If 'moviePtr' is omitted then all open movies are closed.\n";
static char seeAlsoString[] = "PlayMovie GetMovieImage GetMovieTimeIndex SetMovieTimeIndex";

PsychError SCREENCloseMovie(void)
{
    int moviehandle;

    // All sub functions should have these two lines
    PsychPushHelp(useString, synopsisString, seeAlsoString);
    if (PsychIsGiveHelp()) { PsychGiveHelp(); return(PsychError_none); };

    PsychErrorExit(PsychCapNumInputArgs(1));            // Max. 1 input args.
    PsychErrorExit(PsychRequireNumInputArgs(0));        // Min. 0 input args required.
    PsychErrorExit(PsychCapNumOutputArgs(0));           // No output args.

    // Get the movie handle:
    if (!PsychCopyInIntegerArg(1, kPsychArgOptional, &moviehandle))
        PsychDeleteAllMovies();
    else
        PsychDeleteMovie(moviehandle);

    return(PsychError_none);
}