QuickTime Utilties Module
[Jitter]

Collaboration diagram for QuickTime Utilties Module:

Functions
void	jit_gworld_clear (GWorldPtr gp, long c)
	Set all pixels in a QuickDraw GWorld to a specified 32-bit value.
long	jit_gworld_can_coerce_matrix (t_gworld_conv_info gc, void m)
	Determine whether a Jitter matrix can be wrapped in a QuickDraw GWorld (without a copy).
long	jit_gworld_matrix_equal_dim (GWorldPtr gp, void *m)
	Test for equality of dimensions between a QuickDraw GWorld and a Jitter matrix Note: supports UYVY matrices.
t_jit_err	jit_coerce_matrix_pixmap (void m, PixMap pm)
	Generate a QuickDraw PixMap for a given Jitter matrix.
t_jit_err	jit_qt_utils_moviedataref_create (t_symbol *sname, short path, Handle dataRef, OSType dataRefType)
	Creates a new Data Reference from a file path, returning it and the filename/path pair.
Movie	jit_qt_utils_moviefile_create (t_symbol *sname, short path, long flags, DataHandler *dhandler)
	Creates a new QuickTime Movie from a file path, optionally returning the Data Handler and/or filename/path pair.
Boolean	jit_qt_utils_tempfile (char name, Handle dataRef, OSType *dataRefType)
	Returns a QuickTime-compatible Data Reference for a named file in the system's temporary files directory.
Movie	jit_qt_utils_tempmoviefile_create (t_symbol *sname, short path, long flags, DataHandler *dhandler)
	Creates a new QuickTime Movie in the system's temporary file directory, optionally returning the movie's data handler.
long	jit_qt_utils_moviefile_close (Movie movie, DataHandler dhandler)
	Closes a QuickTime Movie previously created with jit_qt_utils_moviefile_create or jit_qt_utils_tempmoviefile_create, adding the necessary movie resources.
Track	jit_qt_utils_trackmedia_add (Movie movie, long type, Rect *trackframe, long vol, long timescale)
	Adds a new Track, with associated Media, to a QuickTime Movie.
Media	jit_qt_utils_trackmedia_get (Track track)
	Returns the Media for a specified Track.
long	jit_qt_utils_trackmedia_dispose (Track track)
	Removes a Track, with associated Media, from a QuickTime Movie.
void	jit_qt_utils_type2str (OSType type, char *typestr)
	Given a four-char type code, return a 0-terminated C string.
OSType	jit_qt_utils_str2type (char *typestr)
	Given a C string, return a four-char code.
void	jit_qt_utils_trackname_set (Track track, t_symbol *s)
	Set the name of a QuickTime Track.
t_symbol *	jit_qt_utils_trackname_get (Track track)
	Get the name of a QuickTime Track.
t_symbol *	jit_qt_utils_tracktype_get (Track track)
	Get the Media Type name from a QuickTime Track.
t_symbol *	jit_qt_utils_tracktypecode_get (Track track)
	Get the four-char code for a Track's Media Type, formatted as a symbol.

Function Documentation

t_jit_err jit_coerce_matrix_pixmap	(	void *	m,
		PixMap *	pm
	)

Generate a QuickDraw PixMap for a given Jitter matrix.

Parameters:

	m	input t_jit_matrix pointer
	pm	on output, a pointer to the generated PixMap

Returns:: t_jit_err error code

Warning:: The matrix should be locked previous to this call, and unlocked afterward.

Definition at line 165 of file jit.gworld.c.

References t_jit_matrix_info::dim, t_jit_matrix_info::dimstride, and jit_object_method().

Here is the call graph for this function:

long jit_gworld_can_coerce_matrix	(	t_gworld_conv_info *	gc,
		void *	m
	)

Determine whether a Jitter matrix can be wrapped in a QuickDraw GWorld (without a copy).

Parameters:

	gc	optional pointer to a t_gworld_conv_info struct
	m	input t_jit_matrix pointer

Returns:: long success code (1 = can coerce, 0 = cannot coerce)

Definition at line 85 of file jit.gworld.c.

References t_jit_matrix_info::dimstride, JIT_MATRIX_CONVERT_DSTDIM, JIT_MATRIX_CONVERT_INTERP, JIT_MATRIX_CONVERT_SRCDIM, jit_object_method(), t_jit_matrix_info::planecount, and t_jit_matrix_info::type.

Referenced by jit_qt_record_matrix_calc().

Here is the call graph for this function:

void jit_gworld_clear	(	GWorldPtr	gp,
		long	c
	)

Set all pixels in a QuickDraw GWorld to a specified 32-bit value.

Parameters:

	gp	QuickDraw GWorldPtr
	c	clear color

Definition at line 21 of file jit.gworld.c.

long jit_gworld_matrix_equal_dim	(	GWorldPtr	gp,
		void *	m
	)

Test for equality of dimensions between a QuickDraw GWorld and a Jitter matrix Note: supports UYVY matrices.

Parameters:

	gp	input GWorldPtr
	m	input t_jit_matrix pointer

Returns:: long success code (1 = dims are equal, 0 = dims are not equal)

Definition at line 123 of file jit.gworld.c.

References t_jit_matrix_info::dim, and jit_object_method().

Referenced by jit_qt_record_matrix_calc().

Here is the call graph for this function:

t_jit_err jit_qt_utils_moviedataref_create	(	t_symbol **	sname,
		short *	path,
		Handle *	dataRef,
		OSType *	dataRefType
	)

Creates a new Data Reference from a file path, returning it and the filename/path pair.

Parameters:

	sname	(in/out) in: file name or fully qualified path in; out: file name of opened movie file
	path	(in/out) in: only necessary if sname is unqualified; out: path of opened movie file
	dataRef	(on output) QuickTime-compatible Data Reference for the specified file name, must be disposed by the caller
	dataRefType	(on output) Data Reference type

Returns:: t_jit_err error

Definition at line 108 of file jit.qt.utils.c.

References gensym(), MAX_PATH_CHARS, path_getdefault(), and saveasdialog_extended().

Referenced by jit_qt_utils_moviefile_create().

Here is the call graph for this function:

long jit_qt_utils_moviefile_close	(	Movie	movie,
		DataHandler	dhandler
	)

Closes a QuickTime Movie previously created with jit_qt_utils_moviefile_create or jit_qt_utils_tempmoviefile_create, adding the necessary movie resources.

Parameters:

	movie	QuickTime Movie, as returned from one of the above-named functions
	dhandler	data handler for the Movie, as returned from one of the above-named functions

Returns:: long QuickTime error code

Definition at line 346 of file jit.qt.utils.c.

Movie jit_qt_utils_moviefile_create	(	t_symbol **	sname,
		short *	path,
		long	flags,
		DataHandler *	dhandler
	)

Creates a new QuickTime Movie from a file path, optionally returning the Data Handler and/or filename/path pair.

Parameters:

	sname	(in/out) in: file name or fully qualified path in; out: file name of opened movie file
	path	(in/out, optional) in: only necessary if sname is unqualified; out: path of opened movie file
	flags	movie file creation flags (see QuickTime Documentation for more information) if no flags are specified, the following flags are used: createMovieFileDeleteCurFile \| createMovieFileDontCreateResFile
	dhandler	(on output, optional) data handler for the opened movie file

Returns:: Movie QuickTime Movie

Definition at line 162 of file jit.qt.utils.c.

References jit_qt_utils_moviedataref_create().

Here is the call graph for this function:

OSType jit_qt_utils_str2type ( char * typestr )

Given a C string, return a four-char code.

Parameters:

typestr

C string

Returns:: OSType four-char code

Definition at line 574 of file jit.qt.utils.c.

References MIN.

Boolean jit_qt_utils_tempfile	(	char *	name,
		Handle *	dataRef,
		OSType *	dataRefType
	)

Returns a QuickTime-compatible Data Reference for a named file in the system's temporary files directory.

Parameters:

	name	file name
	dataRef	(on output) QuickTime-compatible Data Reference for the specified file name, must be disposed by the caller
	dataRefType	(on output) Data Reference type

Returns:: Boolean success (true) or failure (false)

Definition at line 198 of file jit.qt.utils.c.

References error(), jit_object_free(), jit_object_method(), jit_object_new(), MAX_PATH_CHARS, path_nameconform(), PATH_STYLE_MAX, PATH_STYLE_NATIVE, PATH_TYPE_ABSOLUTE, PATH_TYPE_PATH, and sysmem_freeptr().

Referenced by jit_qt_utils_tempmoviefile_create().

Here is the call graph for this function:

Movie jit_qt_utils_tempmoviefile_create	(	t_symbol **	sname,
		short *	path,
		long	flags,
		DataHandler *	dhandler
	)

Creates a new QuickTime Movie in the system's temporary file directory, optionally returning the movie's data handler.

Parameters:

	sname	(in/out) in: file name or fully qualified path in; out: file name of opened movie file
	path	(in/out, optional) in: only necessary if sname is unqualified; out: path of opened movie file
	flags	movie file creation flags (see QuickTime Documentation for more information) if no flags are specified, the following flags are used: createMovieFileDeleteCurFile \| createMovieFileDontCreateResFile
	dhandler	(on output, optional) data handler for the opened movie file

Returns:: Movie QuickTime Movie

Definition at line 298 of file jit.qt.utils.c.

References gensym(), jit_qt_utils_tempfile(), and path_getdefault().

Here is the call graph for this function:

Track jit_qt_utils_trackmedia_add	(	Movie	movie,
		long	type,
		Rect *	trackframe,
		long	vol,
		long	timescale
	)

Adds a new Track, with associated Media, to a QuickTime Movie.

Parameters:

	movie	QuickTime Movie
	type	four-char code specifying the track/media type to be added (see QuickTime Documentation)
	trackframe	the new Track's Rect, relative to the Movie's Rect
	vol	initial value for the sound volume in the new Track
	timescale	the new Track's timescale

Returns:: Track QuickTime Track

Definition at line 451 of file jit.qt.utils.c.

long jit_qt_utils_trackmedia_dispose ( Track track )

Removes a Track, with associated Media, from a QuickTime Movie.

Parameters:

track

QuickTime Track

Returns:: long QuickTime error code

Definition at line 531 of file jit.qt.utils.c.

Media jit_qt_utils_trackmedia_get ( Track track )

Returns the Media for a specified Track.

Parameters:

track

QuickTime Track

Returns:: Media QuickTime Media

Definition at line 499 of file jit.qt.utils.c.

t_symbol* jit_qt_utils_trackname_get ( Track track )

Get the name of a QuickTime Track.

Parameters:

track

QuickTime Track

Returns:: t_symbol pointer containing Track's name

Definition at line 627 of file jit.qt.utils.c.

References gensym().

Here is the call graph for this function:

void jit_qt_utils_trackname_set	(	Track	track,
		t_symbol *	s
	)

Set the name of a QuickTime Track.

Parameters:

	track	QuickTime Track
	s	track name

Definition at line 604 of file jit.qt.utils.c.

References t_symbol::s_name.

t_symbol* jit_qt_utils_tracktype_get ( Track track )

Get the Media Type name from a QuickTime Track.

Parameters:

track

QuickTime Track

Returns:: t_symbol pointer containing the name of the Track's Media Type

Definition at line 659 of file jit.qt.utils.c.

References gensym().

Here is the call graph for this function:

t_symbol* jit_qt_utils_tracktypecode_get ( Track track )

Get the four-char code for a Track's Media Type, formatted as a symbol.

Parameters:

track

QuickTime Track

Returns:: t_symbol pointer containing C string representation of the Media Type

Definition at line 687 of file jit.qt.utils.c.

References gensym(), and jit_qt_utils_type2str().

Here is the call graph for this function:

void jit_qt_utils_type2str	(	OSType	type,
		char *	typestr
	)

Given a four-char type code, return a 0-terminated C string.

Parameters:

	type	four-char code
	typestr	(on output) 0-terminated C string

Definition at line 559 of file jit.qt.utils.c.

Referenced by jit_qt_movie_matrix_to_image(), and jit_qt_utils_tracktypecode_get().

QuickTime Utilties Module [Jitter]

Functions

Function Documentation

QuickTime Utilties Module
[Jitter]