softvolume.h File Reference

Go to the source code of this file.

Enumerations
enum	Mix_SoftVolume_Shape { MIX_SV_SHAPE_LINEAR, MIX_SV_SHAPE_EXP, MIX_SV_SHAPE_EASED, MIX_SV_SHAPE_EASED_EXP }

Functions
void	Mix_SoftVolume_Change (int chan, double newvolume, double time, Mix_SoftVolume_Shape shape)
void	Mix_SoftVolume_Force (int chan, double newvolume)
double	Mix_SoftVolume_GetCurrentVolume (int chan)
void	Mix_SoftVolume_AutoStopMusic (int chan, int enable=1)

Enumeration Type Documentation

enum Mix_SoftVolume_Shape

Enumerator
MIX_SV_SHAPE_LINEAR
MIX_SV_SHAPE_EXP
MIX_SV_SHAPE_EASED
MIX_SV_SHAPE_EASED_EXP

Definition at line 4 of file softvolume.h.

{
    MIX_SV_SHAPE_LINEAR,
    MIX_SV_SHAPE_EXP,
    MIX_SV_SHAPE_EASED,
    MIX_SV_SHAPE_EASED_EXP
} Mix_SoftVolume_Shape;

Function Documentation

void Mix_SoftVolume_AutoStopMusic	(	int	chan,
		int	enable = 1
	)

Definition at line 560 of file softvolume.cpp.

References Mix_SoftVolume_Init().

Referenced by PlayMusic().

{
    Mix_SoftVolume_Init();

    SDL_LockAudio();
    if (channel_state.count( chan ) > 0)
        channel_state[chan].autoStopMusic = enable;
    SDL_UnlockAudio();
}

void Mix_SoftVolume_Change	(	int	chan,
		double	newvolume,
		double	time,
		Mix_SoftVolume_Shape	shape
	)

Definition at line 474 of file softvolume.cpp.

References t_SoftVolume_State::autoStopMusic, C_PI, UniverseUtil::cos(), t_SoftVolume_State::current_volume, dtof16(), f16tod(), fprintf, i, t_SoftVolume_State::in_transition, shape_sampler::init(), linear2log(), log2linear(), Mix_SoftVolume_Init(), MIX_SV_SHAPE_EASED, MIX_SV_SHAPE_EASED_EXP, MIX_SV_SHAPE_EXP, MIX_SV_SHAPE_LINEAR, shape_sampler::shape, SHAPE_SAMPLES, STD_ERR, and t_SoftVolume_State::t_shape.

Referenced by main(), and PlayMusic().

{
    Mix_SoftVolume_Init();

    //Setup transition record
    {
        SDL_LockAudio();

        SoftVolume_State &cstat = channel_state[chan];

        double cur_volume = f16tod( cstat.current_volume );
        double new_volume = newvolume;

        int    i;
        cstat.in_transition = true;
        switch (shape)
        {
        case MIX_SV_SHAPE_LINEAR:
mix_sv_shape_linear:
            for (i = 0; i <= SHAPE_SAMPLES; i++)
                cstat.t_shape.shape[i] = dtof16( cur_volume+(new_volume-cur_volume)*( i*(1.0/SHAPE_SAMPLES) ) );
            break;
        case MIX_SV_SHAPE_EXP:
            cur_volume = linear2log( cur_volume );
            new_volume = linear2log( new_volume );
            for (i = 0; i <= SHAPE_SAMPLES; i++)
                cstat.t_shape.shape[i] = dtof16( log2linear( cur_volume+(new_volume-cur_volume)*( i*(1.0/SHAPE_SAMPLES) ) ) );
            break;
        case MIX_SV_SHAPE_EASED:
            for (i = 0; i <= SHAPE_SAMPLES; i++)
                cstat.t_shape.shape[i] =
                    dtof16( cur_volume+(new_volume-cur_volume)*( 0.5-0.5*cos( i*(1.0/SHAPE_SAMPLES)*C_PI ) ) );
            break;
        case MIX_SV_SHAPE_EASED_EXP:
            cur_volume = linear2log( cur_volume );
            new_volume = linear2log( new_volume );
            for (i = 0; i <= SHAPE_SAMPLES; i++)
                cstat.t_shape.shape[i] =
                    dtof16( log2linear( cur_volume+(new_volume-cur_volume)*( 0.5-0.5*cos( i*(1.0/SHAPE_SAMPLES)*C_PI ) ) ) );
            break;
        default:
            fprintf( STD_ERR, "WARNING(softvolume.cpp): unrecognized transition shape, using default (linear)\n" );
            goto mix_sv_shape_linear;
            break;
        }
        cstat.t_shape.init( (unsigned long) (time*g_sdl_frequency) );
        cstat.autoStopMusic = 0;

        SDL_UnlockAudio();
    }

    //Register effect
    Mix_UnregisterEffect( chan, g_sdl_effect_func );     //Is it necessary?
    Mix_RegisterEffect( chan, g_sdl_effect_func, 0, 0 );
}

void Mix_SoftVolume_Force	(	int	chan,
		double	newvolume
	)

Definition at line 530 of file softvolume.cpp.

References t_SoftVolume_State::current_volume, dtof16(), t_SoftVolume_State::in_transition, and Mix_SoftVolume_Init().

Referenced by PlayMusic().

{
    Mix_SoftVolume_Init();

    SDL_LockAudio();

    SoftVolume_State &cstat = channel_state[chan];
    cstat.current_volume = dtof16( newvolume );
    cstat.in_transition  = false;

    SDL_UnlockAudio();
}

double Mix_SoftVolume_GetCurrentVolume

(

int

chan)

Definition at line 543 of file softvolume.cpp.

References f16tod(), and Mix_SoftVolume_Init().

{
    double res;

    Mix_SoftVolume_Init();

    SDL_LockAudio();
    if (channel_state.count( chan ) > 0)
        res = f16tod( channel_state[chan].current_volume );

    else
        res = 1;
    SDL_UnlockAudio();

    return res;
}