Memory Module
[Jitter]

Collaboration diagram for Memory Module:

Functions
void *	jit_getbytes (long size)
	Allocates a pointer to memory.
void	jit_freebytes (void *ptr, long size)
	Frees a pointer to memory.
void **	jit_handle_new (long size)
	Allocates a memory handle.
void	jit_handle_free (void **handle)
	Frees a memory handle.
long	jit_handle_size_get (void **handle)
	Retrieves a memory handle's size in bytes.
t_jit_err	jit_handle_size_set (void **handle, long size)
	Sets a memory handle's size in bytes.
long	jit_handle_lock (void **handle, long lock)
	Sets a memory handle's lock state.
void	jit_copy_bytes (void dest, const void src, long bytes)
	Copy bytes from source to destination pointer.
long	jit_freemem (void)
	Reports free memory.
char *	jit_newptr (long size)
	Allocates a pointer to memory.
void	jit_disposeptr (char *ptr)
	Frees a pointer to memory.

Function Documentation

void jit_copy_bytes	(	void *	dest,
		const void *	src,
		long	bytes
	)

Copy bytes from source to destination pointer.

Parameters:

	dest	destination pointer
	src	source pointer
	bytes	byte count to copy

Definition at line 301 of file jit.memory.c.

void jit_disposeptr ( char * ptr )

Frees a pointer to memory.

Warning:: It is important to avoid mixing memory pools, and therefore to match calls to jit_newptr and jit_disposeptr.

Parameters:

ptr

pointer to memory

Definition at line 357 of file jit.memory.c.

References sysmem_freeptr().

Here is the call graph for this function:

void jit_freebytes	(	void *	ptr,
		long	size
	)

Frees a pointer to memory.

Depending on the size of the pointer, jit_freebytes will free from either the faster memory pool or the system memory pool.

Warning:: It is important to avoid mixing memory pools, and therefore to match calls to jit_getbytes and jit_freebytes.

Parameters:

	ptr	pointer to memory
	size	size in bytes allocated

Definition at line 146 of file jit.memory.c.

References sysmem_freeptr().

Referenced by jit_glchunk_delete(), jit_matrix_freedata(), jit_ob3d_free(), and max_jit_obex_free().

Here is the call graph for this function:

long jit_freemem ( void )

Reports free memory.

Warning:: Obsolete. OS 9 only.

Returns:: free bytes

Definition at line 316 of file jit.memory.c.

void* jit_getbytes ( long size )

Allocates a pointer to memory.

Depending on the size requested, jit_getbytes will allocate from either the faster memory pool or the system memory pool.

Warning:: It is important to avoid mixing memory pools, and therefore to match calls to jit_getbytes and jit_freebytes.

Parameters:

size

size in bytes to allocate

Returns:: pointer to memory

Definition at line 119 of file jit.memory.c.

References sysmem_newptr().

Referenced by jit_glchunk_copy(), jit_glchunk_grid_new(), jit_glchunk_new(), jit_matrix_getcell(), jit_ob3d_new(), jit_ob3d_setup(), jit_qt_codec_getcodeclist_audio(), jit_qt_codec_getcodeclist_gfx(), jit_qt_codec_getcodeclist_video(), max_jit_classex_setup(), and max_jit_obex_new().

Here is the call graph for this function:

void jit_handle_free ( void ** handle )

Frees a memory handle.

Warning:: It is important to avoid mixing memory pools, and therefore to match calls to jit_handle_new and jit_handle_free.

Parameters:

handle

memory handle

Definition at line 209 of file jit.memory.c.

References sysmem_freehandle().

Referenced by jit_matrix_free().

Here is the call graph for this function:

long jit_handle_lock	(	void **	handle,
		long	lock
	)

Sets a memory handle's lock state.

Parameters:

	handle	memory handle
	lock	state (1=locked, 0=unlocked)

Returns:: lock state.

Definition at line 282 of file jit.memory.c.

References sysmem_lockhandle().

Here is the call graph for this function:

void** jit_handle_new ( long size )

Allocates a memory handle.

Handles are relocatable sections of memory which should be locked before dereferencing, and unlocked when not in use so that they may be relocated as necessary.