Max 5 API Reference

Miscellaneous Utility Module
[Jitter]

Collaboration diagram for Miscellaneous Utility Module:

Functions

float swapf32 (float f)
 Byte swaps 32 bit floating point number.
double swapf64 (double f)
 Byte swaps 64 bit floating point number.
void jit_global_critical_enter (void)
 Enters the global Jitter critical region.
void jit_global_critical_exit (void)
 Exits the global Jitter critical region.
void jit_error_sym (void *x, t_symbol *s)
 Sends symbol based error message to Max console (safe from all threads).
void jit_error_code (void *x, t_jit_err v)
 Sends error code based error message to Max console (safe from all threads).
void jit_post_sym (void *x, t_symbol *s)
 Sends symbol based message to Max console (safe from all threads).
t_jit_err jit_err_from_max_err (t_max_err err)
 Converts Max style error codes to Jitter style error codes.
void jit_rand_setseed (long n)
 Sets global random number generator seed.
long jit_rand (void)
 Generates a random value as a signed long integer.

Function Documentation

t_jit_err jit_err_from_max_err ( t_max_err  err  ) 

Converts Max style error codes to Jitter style error codes.

Parameters:
err Max error code
Returns:
t_jit_err error code
void jit_error_code ( void *  x,
t_jit_err  v 
)

Sends error code based error message to Max console (safe from all threads).

Parameters:
x object pointer
v error code
void jit_error_sym ( void *  x,
t_symbol s 
)

Sends symbol based error message to Max console (safe from all threads).

Parameters:
x object pointer
s error message symbol
void jit_global_critical_enter ( void   ) 

Enters the global Jitter critical region.

This function is useful for simple protection of thread sensitive operations. However, it may be too broad a lock, as it prevents any other operations that use the global critical region from working. For more localized control, I would suggest using either MaxMSP's systhread API or the platform specific locking mechanisms however, be sensitive to the possibility deadlock when locking code which calls code which may require the locking off unknown resources.

void jit_global_critical_exit ( void   ) 

Exits the global Jitter critical region.

This function is useful for simple protection of thread sensitive operations. However, it may be too broad a lock, as it prevents any other operations that use the global critical region from working. For more localized control, I would suggest using either MaxMSP's systhread API or the platform specific locking mechanisms however, be sensitive to the possibility deadlock when locking code which calls code which may require the locking off unknown resources.

void jit_post_sym ( void *  x,
t_symbol s 
)

Sends symbol based message to Max console (safe from all threads).

Parameters:
x object pointer
s message symbol
long jit_rand ( void   ) 

Generates a random value as a signed long integer.

Returns:
random value
void jit_rand_setseed ( long  n  ) 

Sets global random number generator seed.

Parameters:
n seed
float swapf32 ( float  f  ) 

Byte swaps 32 bit floating point number.

Parameters:
f input float
Returns:
byte swapped float
double swapf64 ( double  f  ) 

Byte swaps 64 bit floating point number.

Parameters:
f input double
Returns:
byte swapped double

Copyright © 2008, Cycling '74