njb_get_eax(3)

NAME

NJB_Get_EAX - Get EAX settings from the NJB

LIBRARY

libnjb

SYNOPSIS

#include <libnjb.h>
extern int njb_error
eax_t *NJB_Get_EAX(njb_t *njb)
playlist_t *NJB_Refresh_EAX (njb_t *njb,eax_t *eax)

DESCRIPTION

This function returns a struct that represent the EAX set

tings on the NJB. By using the NJB_Refresh_EAX the contents of

this struct may be refreshed, so that new values are added to the

structure.

The eax_t type pointer that is returned by the function

may be destroyed by using the eax_destroy(3) function.

The NJB_Refresh_EAX() function may not always be available

on all devices and should not be trusted. It is better to use

NJB_Get_EAX() instead.

EAX STRUCTURE

The EAX struct has the following form:

typedef struct {

u_int8_t volume;
int16_t muted;
int16_t eq_status;
int8_t bass;
int8_t bassmin;
int8_t bassmax;
int8_t midrange;
int8_t midrangemin;
int8_t midrangemax;
int8_t treble;
int8_t treblemin;
int8_t treblemax;
u_int8_t nfreq;
u_int8_t freqset;
int16_t *frequencies;
u_int8_t neffects;
u_int8_t acteffect;
char **effects;
u_int8_t *effamts;
u_int8_t nphone;
u_int8_t actphone;
char **phonemodes;
u_int8_t nrear;
u_int8_t actrear;
char **rears; } eax_t;

The u_int8_t are unsigned byte values. These parameters

can be altered using the NJB_Adjust_Sound funtion. muted and

eq_status are boolean values and have the values 0x0000 or 0x0001

respective.

The bass, treble and mid settings have associated max- and

minvalues that should be taken in regard when sending update com

mands to these.

bass The value for the bass setting of the equalizer.

bassmin The minimum value for the bass setting.

bassmax The maximum value for the bass setting.

midrange The value for the midrange setting of the equal

izer.

midrangemin

The minimum value for the midrange setting.

midrangemax

The maximum value for the midrange setting.

treble The value for the treble setting of the equaliz

er.

treblemin The minimum value for the treble setting.

treblemax The maximum value for the treble setting.

The frequencies for the equalizer are selected with an in

dex.

nfreq The number of frequences available for the

midrange frequency setting.

freqset The currently selected midrange frequency. Index

into the array of available frequencies. 0 <= freqset < nfreq

frequencies

A 16bit array of the available frequencies. The

size of this array is equal to nfreq.

The number of effects and the currently used effect set

ting is also selected as an index into an array of preset ef

fects.

neffects The number of available effects.

acteffect The currently active effect. Index into the ar

ray. 0 <= acteffect < neffects

effects This is a string array with the names of the

available effects. The strings are zero terminated. These are

meant to be used as strings in the user interfaces using the ef

fect selector. The strings come from the Jukebox firmware, they

do not reside inside libnjb.

effamts This is an array representing the current amount

used of the effect. This implies that the constructors of the

jukebox once implied that you could set individual amounts for

each effect and perhaps even have several of the active at the

same time. However the way it works in practise is that this ar

ray will contain the same value for all effects, and calling the

corresponding setting fucntion in NJB_Adjust_Sound will set the

same value for all effects.

nphone The number of headphone modes.

actphone The currently active phone mode. Index into ar

ray. 0 <= actphone < nphone

phonemodes

This is an array of strings describing the dif

ferent headphone modes. These come from the Jukebox firmware and

should be used in user interfaces.

nrear The number of available rear speaker settings.

actrear The currently active rear speaker setting. 0 <=

actrear < nrear

rears This is an array of strings describing the dif

ferent rear speaker modes. These come from the Jukebox firmware

and should be used in user interfaces.

SEE ALSO

NJB_Adjust_Sound(3)

November 2002

NJB_GET_EAX(3)