hxplayer.cpp

linux下的一款播放器

           actually that length. */
        nPos = 0;
    }
    
    return (guint) nPos;
}

/**
 * hx_player_is_live:
 * @player: a #HXPlayer
 *
 * @returns: whether the clip being played is live
 *
 **/
gboolean
hx_player_is_live(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);
    g_return_val_if_fail(player->player != NULL, FALSE);

    return ClientPlayerIsLive(player->player);
}

/**
 * hx_player_is_infinite_duration:
 * @player: a #HXPlayer
 *
 * @returns: whether the clip being played is of infinite duration
 *
 **/
gboolean
hx_player_is_indefinite_duration(HXPlayer* player)
{
    UInt32 nPos;
    
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);
    g_return_val_if_fail(player->player != NULL, FALSE);

    nPos = ClientPlayerGetLength(player->player);

    return (nPos == INFINITE_DURATION)? TRUE: FALSE;
}

/**
 * hx_player_has_visual_content:
 * @player: a #HXPlayer
 *
 * @returns: %TRUE if the content being played has visual content
 *
 **/
gboolean
hx_player_has_visual_content(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);

    if(!player->player)
    {
        /* No visual content yet -- player engine isn't initialized */
        return FALSE;
    }
    return ClientPlayerHasVisualContent(player->player);
}

/**
 * hx_player_get_ideal_size:
 * @player: a #HXPlayer
 * @width: ideal width
 * @height: ideal height
 *
 * Returns the ideal size of the visual content being displayed
 * (eg: the resolution at which it was encoded)
 *
 **/
void
hx_player_get_ideal_size(HXPlayer* player,
                         gint*     width,
                         gint*     height)
{
    SInt32 w = 0;
    SInt32 h = 0;

    *width = 0;
    *height = 0;
    
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(width != NULL && height != NULL);
    
    ClientPlayerGetIdealSize(player->player, &w, &h);
    
    *width = w;
    *height = h;
}

void
hx_player_get_logo_size(HXPlayer* player,
                        gint*     width,
                        gint*     height)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(width != NULL && height != NULL);
    
    *width = player->logo_width;
    *height = player->logo_height;
}

/**
 * hx_player_get_clip_bandwidth:
 * @player: a #HXPlayer
 *
 * The bandwidth required by the clip being streamed,
 * measured in bytes per second.
 *
 * @returns: the bandwidth
 *
 **/
guint
hx_player_get_clip_bandwidth(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetClipBandwidth(player->player);
}

/**
 * hx_player_get_source_count:
 * @player: a #HXPlayer
 *
 * The number of sources.
 *
 * @returns: the number of sources
 *
 **/
guint
hx_player_get_source_count(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetSourceCount(player->player);
}

/**
 * hx_player_get_group_count:
 * @player: a #HXPlayer
 *
 * The number of groups in the playlist.
 *
 * @returns: the number of groups
 *
 **/
guint
hx_player_get_group_count(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetGroupCount(player->player);
}

/**
 * hx_player_get_current_group:
 * @player: a #HXPlayer
 *
 * @returns: the group that is currently playing
 *
 **/
guint
hx_player_get_current_group(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetCurrentGroup(player->player);
}

/**
 * hx_player_set_audio_channels:
 * @player: a #HXPlayer
 * @index: the group
 *
 * Skips to the group at position "index" in the playlist.
 *
 **/
void
hx_player_set_current_group(HXPlayer* player,
                            guint     index)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerSetCurrentGroup(player->player, index);
}

/**
 * hx_player_set_volume
 * @player: a #HXPlayer
 * @volume: the desired volume, from 0 to 100
 *
 * Sets the mixer volume.
 *
 **/
void
hx_player_set_volume(HXPlayer* player,
                     guint     volume)
                         
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerSetVolume(player->player, volume);
}

/**
 * hx_player_get_volume:
 * @player: a #HXPlayer
 *
 * Gets the mixer volume.
 *
 * @returns: the current volume, from 0 to 100
 *
 **/
guint
hx_player_get_volume(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetVolume(player->player);
}

/**
 * hx_player_set_mute:
 * @player: a #HXPlayer
 * @mute: %TRUE to enable mute, %FALSE to disable it
 *
 **/
void
hx_player_set_mute(HXPlayer* player,
                   gboolean  mute)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerMute(player->player, mute);
}

/**
 * hx_player_is_muted:
 * @player: a #HXPlayer
 *
 * @returns: %TRUE if muted, %FALSE if not
 *
 **/
gboolean
hx_player_is_muted(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);
    g_return_val_if_fail(player->player != NULL, FALSE);
    
    return ClientPlayerIsMuted(player->player);
}

/**
 * hx_player_enable_eq:
 * @player: a #HXPlayer
 * @enable: %TRUE to enable equalizer, %FALSE to disable it
 *
 * By default, the equalizer is disabled. (?)
 *
 **/
void
hx_player_enable_eq(HXPlayer* player,
                    gboolean  enable)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerEnableEQ(player->player, enable);
}

/**
 * hx_player_is_eq_enabled:
 * @player: a #HXPlayer
 *
 * By default, the equalizer is disabled. (?)
 *
 * @returns: whether the equalizer is enabled
 *
 **/
gboolean
hx_player_is_eq_enabled(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);
    g_return_val_if_fail(player->player != NULL, FALSE);

    return ClientPlayerIsEQEnabled(player->player);
}

/**
 * hx_player_set_eq_gain_at:
 * @player: a #HXPlayer
 * @band: frequency band to change in Hz (?)
 * @gain: gain to set at the freqency band in dB (?)
 *
 **/
void
hx_player_set_eq_gain_at(HXPlayer* player,
                         guint     band,
                         gint      gain)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerSetEQGain(player->player, band, gain);
}

/**
 * hx_player_get_eq_gain_at:
 * @player: a #HXPlayer
 * @band: frequency band to change in Hz (?)
 *
 * @returns: the gain at the frequency band
 *
 **/
gint
hx_player_get_eq_gain_at(HXPlayer* player,
                         guint     band)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetEQGain(player->player, band);
}

/**
 * hx_player_set_eq_pregain:
 * @player: a #HXPlayer
 * @pregain: the pregain in dB (?)
 *
 **/
void
hx_player_set_eq_pregain(HXPlayer* player,
                         gint      pregain)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerSetEQPreGain(player->player, pregain);
}

/**
 * hx_player_get_eq_pregain:
 * @player: a #HXPlayer
 *
 * @returns: the pregain in dB (?)
 *
 **/
gint
hx_player_get_eq_pregain(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), 0);
    g_return_val_if_fail(player->player != NULL, 0);

    return ClientPlayerGetEQPreGain(player->player);
}

/**
 * hx_player_enable_eq_auto_pregain:
 * @player: a #HXPlayer
 * @enable: %TRUE to have the pregain automatically adjusted
 *
 * By default, automatic pregain adjustment is enabled. (?)
 *
 **/
void
hx_player_enable_eq_auto_pregain(HXPlayer* player,
                                 gboolean  enable)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerEnableEQAutoPreGain(player->player, enable);
}

/**
 * hx_player_is_eq_auto_pregain_enabled:
 * @player: a #HXPlayer
 *
 * @returns: %TRUE if the pregain is automatically adjusted
 *
 **/
gboolean
hx_player_is_eq_auto_pregain_enabled(HXPlayer* player)
{
    g_return_val_if_fail(HX_IS_PLAYER(player), FALSE);
    g_return_val_if_fail(player->player != NULL, FALSE);

    return ClientPlayerIsEQAutoPreGainEnabled(player->player);
}


/**
 * hx_player_set_eq_reverb:
 * @player: a #HXPlayer
 * @room_size: size of the room, in square feet (??)
 * @reverb: degree of sound reflection from the walls in (??)
 *
 * This function applys a reverb effect to the audio.
 * The default reverb settings are ???
 *
 **/
void
hx_player_set_eq_reverb(HXPlayer* player,
                        gint      room_size,
                        gint      reverb)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(player->player != NULL);

    ClientPlayerSetEQReverb(player->player, room_size, reverb);
}

/**
 * hx_player_get_eq_reverb:
 * @player: a #HXPlayer
 * @room_size: size of the room, in square feet (??)
 * @reverb: degree of sound reflection from the walls in (??)
 *
 * Get the current reverb settings.
 *
 **/
void
hx_player_get_eq_reverb(HXPlayer* player,
                        gint*     room_size,
                        gint*     reverb)
{
    g_return_if_fail(HX_IS_PLAYER(player));
    g_return_if_fail(room_size != NULL && reverb != NULL);
    g_return_if_fail(player->player != NULL);

    SInt32 s = 0;
    SInt32 r = 0;
    ClientPlayerGetEQReverb(player->player, &s, &r);
    *room_size = s;
    *reverb = r;
}

static void
hx_player_unrealize(GtkWidget* widget)
{
    HXPlayer* player;

    player = HX_PLAYER(widget);    
    g_assert(player != NULL);

    hx_player_stop(player);

    /* Decrease engine count, and stop engine callback if appropriate */
    g_return_if_fail(g_engine_ref_count > 0);
    
    g_engine_ref_count--;   

#ifdef G_OS_UNIX
    if(g_engine_ref_count == 0)
    {
        gtk_timeout_remove(g_pump_timer_id);

        if(g_dpy)
        {