root/src/terminal/object_manager.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. gf_odm_new
  2. gf_odm_reset_media_control
  3. gf_odm_del
  4. gf_odm_lock
  5. gf_odm_lock_mo
  6. gf_odm_disconnect
  7. gf_odm_setup_entry_point
  8. od_get_esd
  9. ODM_SelectAlternateStream
  10. ODM_ValidateOD
  11. gf_odm_should_auto_select
  12. gf_odm_setup_object
  13. ODM_CheckChannelService
  14. gf_odm_setup_es
  15. gf_odm_post_es_setup
  16. ODM_DeleteChannel
  17. gf_odm_remove_es
  18. gf_odm_start
  19. gf_odm_play
  20. gf_odm_owns_clock
  21. gf_odm_stop
  22. gf_odm_on_eos
  23. gf_odm_set_duration
  24. gf_odm_set_timeshift_depth
  25. gf_odm_get_media_clock
  26. gf_odm_shares_clock
  27. gf_odm_pause
  28. gf_odm_resume
  29. gf_odm_set_speed
  30. gf_odm_find_segment
  31. gf_odm_insert_segment
  32. gf_odm_init_segments
  33. gf_odm_signal_eos

/*
 *                      GPAC - Multimedia Framework C SDK
 *
 *                      Authors: Jean Le Feuvre
 *                      Copyright (c) Telecom ParisTech 2000-2012
 *                                      All rights reserved
 *
 *  This file is part of GPAC / Media terminal sub-project
 *
 *  GPAC is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *
 *  GPAC is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; see the file COPYING.  If not, write to
 *  the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 */


#include <gpac/internal/terminal_dev.h>
#include <gpac/internal/compositor_dev.h>
#include <gpac/constants.h>
#include "media_memory.h"
#include "media_control.h"

#include "input_sensor.h"

/*removes the channel ressources and destroy it*/
void ODM_DeleteChannel(GF_ObjectManager *odm, struct _es_channel *ch);

GF_EXPORT
GF_ObjectManager *gf_odm_new()
{
        GF_ObjectManager *tmp;
        GF_SAFEALLOC(tmp, GF_ObjectManager);
        if (!tmp) return NULL;
        tmp->channels = gf_list_new();

        tmp->Audio_PL = (u8) -1;
        tmp->Graphics_PL = (u8) -1;
        tmp->OD_PL = (u8) -1;
        tmp->Scene_PL = (u8) -1;
        tmp->Visual_PL = (u8) -1;
        tmp->mx = gf_mx_new("ODM");
#ifndef GPAC_DISABLE_VRML
        tmp->ms_stack = gf_list_new();
        tmp->mc_stack = gf_list_new();
#endif
        return tmp;
}

void gf_odm_reset_media_control(GF_ObjectManager *odm, Bool signal_reset)
{
#ifndef GPAC_DISABLE_VRML
        MediaSensorStack *media_sens;
        MediaControlStack *media_ctrl;

        while ((media_sens = (MediaSensorStack *)gf_list_last(odm->ms_stack))) {
                MS_Stop(media_sens);
                /*and detach from stream object*/
                media_sens->stream = NULL;
                gf_list_rem_last(odm->ms_stack);
        }

        while ((media_ctrl = (MediaControlStack *)gf_list_last(odm->mc_stack))) {
                if (signal_reset)
                        gf_odm_remove_mediacontrol(odm, media_ctrl);
                media_ctrl->stream = NULL;
                media_ctrl->ck = NULL;
                gf_list_rem_last(odm->mc_stack);
        }
#endif
}


void gf_odm_del(GF_ObjectManager *odm)
{
        if (odm->addon && (odm->addon->root_od==odm)) {
                odm->addon->root_od = NULL;
                odm->addon->started = 0;
        }
        if (odm->upper_layer_odm) {
                odm->upper_layer_odm->lower_layer_odm = NULL;
        }
        if (odm->lower_layer_odm) {
                odm->lower_layer_odm->upper_layer_odm = NULL;
        }
        /*make sure we are not in the media queue*/
        gf_term_lock_media_queue(odm->term, GF_TRUE);
        gf_list_del_item(odm->term->media_queue, odm);
        gf_term_check_connections_for_delete(odm->term, odm);
        gf_term_lock_media_queue(odm->term, GF_FALSE);

        /*detach media object as referenced by the scene - this should ensures that any attempt to lock the ODM from the
        compositor will fail as the media object is no longer linked to object manager*/
        gf_mx_p(odm->mx);
        if (odm->mo) odm->mo->odm = NULL;
        gf_mx_v(odm->mx);

        /*relock the mutex for final object destruction*/
        gf_mx_p(odm->mx);

#ifndef GPAC_DISABLE_VRML
        gf_odm_reset_media_control(odm, 0);
        gf_list_del(odm->ms_stack);
        gf_list_del(odm->mc_stack);
#endif

        if (odm->raw_frame_sema) gf_sema_del(odm->raw_frame_sema);

        gf_list_del(odm->channels);
        odm->channels = NULL;
        assert (!odm->net_service);
        gf_odf_desc_del((GF_Descriptor *)odm->OD);
        odm->OD = NULL;
        gf_mx_v(odm->mx);
        gf_mx_del(odm->mx);
        gf_free(odm);
}


void gf_odm_lock(GF_ObjectManager *odm, u32 LockIt)
{
        assert(odm);
        if (LockIt)
                gf_mx_p(odm->mx);
        else
                gf_mx_v(odm->mx);
}

Bool gf_odm_lock_mo(GF_MediaObject *mo)
{
        if (!mo || !mo->odm) return GF_FALSE;
        gf_odm_lock(mo->odm, 1);
        /*the ODM may have been destroyed here !!*/
        if (!mo->odm) return GF_FALSE;
        return GF_TRUE;
}

GF_EXPORT
void gf_odm_disconnect(GF_ObjectManager *odm, u32 do_remove)
{
        GF_Terminal *term;
        GF_Channel *ch;

        if (do_remove) {
                gf_mx_p(odm->term->net_mx);
                odm->flags |= GF_ODM_DESTROYED;
                gf_mx_v(odm->term->net_mx);
        }
        gf_odm_stop(odm, GF_TRUE);

        /*disconnect sub-scene*/
        if (odm->subscene) gf_scene_disconnect(odm->subscene, do_remove);

        /*no destroy*/
        if (!do_remove) return;

        gf_odm_lock(odm, 1);

        /*unload the decoders before deleting the channels to prevent any access fault*/
        if (odm->codec) {
                if (odm->codec->type==GF_STREAM_INTERACT) {
                        u32 i, count;
                        // Remove all Registered InputSensor nodes -> shut down the InputSensor threads -> prevent illegal access on deleted pointers
                        GF_MediaObject *obj = odm->mo;
                        count = gf_mo_event_target_count(obj);
                        for (i=0; i<count; i++) {
                                GF_Node *n = (GF_Node *)gf_event_target_get_node(gf_mo_event_target_get(obj, i));
                                switch (gf_node_get_tag(n)) {
#ifndef GPAC_DISABLE_VRML
                                case TAG_MPEG4_InputSensor:
                                        ((M_InputSensor*)n)->enabled = 0;
                                        InputSensorModified(n);
                                        break;
#endif
                                default:
                                        break;
                                }
                        }
                }
                gf_term_remove_codec(odm->term, odm->codec);
        }
        if (odm->ocr_codec) gf_term_remove_codec(odm->term, odm->ocr_codec);
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) gf_term_remove_codec(odm->term, odm->oci_codec);
#endif

        /*then delete all the channels in this OD */
        while (gf_list_count(odm->channels)) {
                ch = (GF_Channel*)gf_list_get(odm->channels, 0);
#if 0
                if (ch->clock->mc && ch->clock->mc->stream && ch->clock->mc->stream->odm==odm) {
                        ch->clock->mc->stream = NULL;
                        ch->clock->mc = NULL;
                }
#endif
                ODM_DeleteChannel(odm, ch);
        }

        /*delete the decoders*/
        if (odm->codec) {
                gf_codec_del(odm->codec);
                odm->codec = NULL;
        }
        if (odm->ocr_codec) {
                gf_codec_del(odm->ocr_codec);
                odm->ocr_codec = NULL;
        }
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) {
                gf_codec_del(odm->oci_codec);
                odm->oci_codec = NULL;
        }
#endif

        /*detach from network service */
        if (odm->net_service) {
                GF_ClientService *ns = odm->net_service;
                if (ns->nb_odm_users) ns->nb_odm_users--;
                if (ns->owner == odm) {
                        /*detach it!!*/
                        ns->owner = NULL;
                        /*try to assign a new root in case this is not scene shutdown*/
                        if (ns->nb_odm_users && odm->parentscene) {
                                GF_ObjectManager *new_root;
                                u32 i = 0;
                                while ((new_root = (GF_ObjectManager *)gf_list_enum(odm->parentscene->resources, &i)) ) {
                                        if (new_root == odm) continue;
                                        if (new_root->net_service != ns) continue;

                                        /*if the new root is not playing or assoicated with the scene, force a destroy on it - this
                                        is needed for services declaring their objects dynamically*/
                                        if (!new_root->mo || (!new_root->mo->num_open)) {
                                                gf_term_lock_media_queue(odm->term, GF_TRUE);
                                                new_root->action_type = GF_ODM_ACTION_DELETE;
                                                if (gf_list_find(odm->term->media_queue, new_root)<0) {
                                                        assert(! (new_root->flags & GF_ODM_DESTROYED));
                                                        gf_list_add(odm->term->media_queue, new_root);
                                                }
                                                gf_term_lock_media_queue(odm->term, GF_FALSE);
                                        }
                                        ns->owner = new_root;
                                        break;
                                }
                        }
                } else {
                        assert(ns->nb_odm_users);
                }
                odm->net_service = NULL;
                if (!ns->nb_odm_users) gf_term_close_service(odm->term, ns);
        }

        gf_odm_lock(odm, 0);

        term = odm->term;

        /*delete from the parent scene.*/
        if (odm->parentscene) {
                GF_Event evt;
                evt.type = GF_EVENT_CONNECT;
                evt.connect.is_connected = GF_FALSE;
                gf_term_forward_event(odm->term, &evt, GF_FALSE, GF_TRUE);

                gf_term_lock_net(term, GF_TRUE);
                gf_scene_remove_object(odm->parentscene, odm, do_remove);
                if (odm->subscene) gf_scene_del(odm->subscene);
                gf_odm_del(odm);
                gf_term_lock_net(term, GF_FALSE);
                return;
        }

        /*this is the scene root OD (may be a remote OD ..) */
        if (odm->term->root_scene) {
                GF_Event evt;
                assert(odm->term->root_scene == odm->subscene);
                gf_scene_del(odm->subscene);
                /*reset main pointer*/
                odm->term->root_scene = NULL;

                evt.type = GF_EVENT_CONNECT;
                evt.connect.is_connected = GF_FALSE;
                gf_term_send_event(odm->term, &evt);
        }
        //this is an extra scene not part of the main tree (eg declared from modules), don't post events
        else if (odm->subscene) {
                gf_scene_del(odm->subscene);
        }

        gf_term_lock_net(term, GF_TRUE);
        /*delete the ODMan*/
        gf_odm_del(odm);

        gf_term_lock_net(term, GF_FALSE);
}

/*setup service for OD (extract IOD and go)*/
void gf_odm_setup_entry_point(GF_ObjectManager *odm, const char *service_sub_url)
{
        u32 od_type;
        char *ext, *redirect_url;
        char *sub_url = (char *) service_sub_url;
        GF_Descriptor *desc;

        if (odm->flags & GF_ODM_DESTROYED) {
                GF_LOG(GF_LOG_WARNING, GF_LOG_MEDIA, ("[ODM] Root object of service %s has been scheduled for destruction - ignoring object setup\n", service_sub_url));
                return;
        }
//      assert(odm->OD==NULL);

        GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[ODM] Setting up root object for %s\n", odm->net_service->url));

        if (odm->subscene) {
                char *sep = strchr(sub_url, '#');
                if (sep && !strnicmp(sep, "#LIVE360", 8)) {
                        sep[0] = 0;
                        odm->subscene->vr_type = 1;
                }
                od_type = GF_MEDIA_OBJECT_SCENE;
        } else if (odm->mo) {
                od_type = odm->mo->type;
                if (!sub_url && odm->mo->URLs.count && odm->mo->URLs.vals[0].url) {
                        sub_url = odm->mo->URLs.vals[0].url;
                }
        }
        else od_type = GF_MEDIA_OBJECT_UNDEF;

        /*for remote ODs, get expected OD type in case the service needs to generate the IOD on the fly*/
        if (odm->parentscene && odm->OD && odm->OD->URLString) {
                GF_MediaObject *mo;
                mo = gf_scene_find_object(odm->parentscene, odm->OD->objectDescriptorID, odm->OD->URLString);
                if (mo) od_type = mo->type;
                ext = strchr(odm->OD->URLString, '#');
                if (ext) sub_url = ext;
        }

        desc = odm->net_service->ifce->GetServiceDescriptor(odm->net_service->ifce, od_type, sub_url);

        /*entry point is already setup (bad design in GPAC, happens with BIFS TS and DASH*/
        if (odm->OD) {
                if (!desc) return;
                if (gf_list_count(odm->OD->ESDescriptors)) {
                        gf_odf_desc_del(desc);
                        return;
                }
                gf_odf_desc_del((GF_Descriptor *) odm->OD);
                odm->OD=NULL;
                if (odm->subscene)
                        odm->subscene->is_dynamic_scene = GF_FALSE;
        }

        if (!desc) {
                if (odm->OD && !gf_list_count(odm->OD->ESDescriptors))
                        return;

                /*if desc is NULL for a media, the media will be declared later by the service (gf_term_media_add)*/
                if (od_type != GF_MEDIA_OBJECT_SCENE) {
                        return;
                }
                /*create empty service descriptor, this will automatically create a dynamic scene*/
                desc = gf_odf_desc_new(GF_ODF_OD_TAG);
        }
        odm->flags |= GF_ODM_SERVICE_ENTRY;

        if (!gf_list_count( ((GF_ObjectDescriptor*)desc)->ESDescriptors)) {
                /*new subscene*/
                if (!odm->subscene) {
                        assert(odm->parentscene);
                        odm->subscene = gf_scene_new(odm->parentscene);
                        odm->subscene->root_od = odm;
                }
        }

        redirect_url = NULL;
        switch (desc->tag) {
        case GF_ODF_IOD_TAG:
        {
                GF_InitialObjectDescriptor *the_iod = (GF_InitialObjectDescriptor *)desc;
                odm->OD = (GF_ObjectDescriptor*)gf_malloc(sizeof(GF_ObjectDescriptor));
                memcpy(odm->OD, the_iod, sizeof(GF_ObjectDescriptor));
                odm->OD->tag = GF_ODF_OD_TAG;
                /*Check P&Ls of this IOD*/
                odm->Audio_PL = the_iod->audio_profileAndLevel;
                odm->Graphics_PL = the_iod->graphics_profileAndLevel;
                odm->OD_PL = the_iod->OD_profileAndLevel;
                odm->Scene_PL = the_iod->scene_profileAndLevel;
                odm->Visual_PL = the_iod->visual_profileAndLevel;
                odm->flags |= GF_ODM_HAS_PROFILES;
                if (the_iod->inlineProfileFlag) odm->flags |= GF_ODM_INLINE_PROFILES;
                redirect_url = the_iod->URLString;
                odm->OD->URLString = NULL;
                gf_odf_desc_del((GF_Descriptor *) the_iod->IPMPToolList);
                gf_free(the_iod);
        }
        break;
        case GF_ODF_OD_TAG:
                odm->Audio_PL = odm->Graphics_PL = odm->OD_PL = odm->Scene_PL = odm->Visual_PL = (u8) -1;
                odm->OD = (GF_ObjectDescriptor *)desc;
                redirect_url = odm->OD->URLString;
                odm->OD->URLString = NULL;
                break;
        default:
                gf_term_message(odm->term, odm->net_service->url, "MPEG4 Service Setup Failure", GF_ODF_INVALID_DESCRIPTOR);
                goto err_exit;
        }

        gf_odm_setup_object(odm, odm->net_service);

        if (redirect_url && !strnicmp(redirect_url, "views://", 8)) {
                gf_scene_generate_views(odm->subscene ? odm->subscene : odm->parentscene , (char *) redirect_url + 8, (char*)odm->parentscene ? odm->parentscene->root_od->net_service->url : NULL);
        }
        /*it may happen that this object was inserted in a dynamic scene from a service through a URL redirect. In which case,
        the scene regeneration might not have been completed since the redirection was not done yet - force a scene regenerate*/
        else if (odm->parentscene && odm->parentscene->is_dynamic_scene) {
                gf_scene_regenerate(odm->parentscene);
        }

        gf_free(redirect_url);

        return;

err_exit:
        if (!odm->parentscene) {
                GF_Event evt;
                evt.type = GF_EVENT_CONNECT;
                evt.connect.is_connected = GF_FALSE;
                gf_term_send_event(odm->term, &evt);
        }
        if (redirect_url)
                gf_free(redirect_url);
}


/*locate ESD by ID*/
static GF_ESD *od_get_esd(GF_ObjectDescriptor *OD, u16 ESID)
{
        GF_ESD *esd;
        u32 i = 0;
        while ((esd = (GF_ESD *)gf_list_enum(OD->ESDescriptors, &i)) ) {
                if (esd->ESID==ESID) return esd;
        }
        return NULL;
}

static void ODM_SelectAlternateStream(GF_ObjectManager *odm, const char *lang_3cc, const char *lang_2cc, u8 stream_type)
{
        u32 i;
        GF_ESD *esd;
        u16 def_id, es_id;
        char esCode[4];

        def_id = 0;
        i=0;
        while ( (esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i)) ) {
                if (esd->decoderConfig->streamType != stream_type) continue;

                if (!esd->langDesc) {
                        if (!def_id) def_id = esd->ESID;
                        continue;
                }
                esCode[0] = esd->langDesc->langCode>>16;
                esCode[1] = esd->langDesc->langCode>>8;
                esCode[2] = esd->langDesc->langCode;
                esCode[3] = 0;
                
                if (!stricmp(esCode, lang_3cc) || !strnicmp(esCode, lang_2cc, 2)) {
                        def_id = esd->ESID;
                        break;
                } else if (!def_id) {
                        def_id = esd->ESID;
                }
        }

        /*remove all other media streams*/
        i=0;
        while ((esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i)) ) {
                if (esd->decoderConfig->streamType != stream_type) continue;

                /*get base stream ID for this stream*/
                es_id = esd->ESID;
                if (esd->dependsOnESID && (esd->dependsOnESID != es_id)) {
                        es_id = esd->dependsOnESID;
                        while (es_id) {
                                GF_ESD *base = od_get_esd(odm->OD, es_id);
                                if (!base) break;
                                /*forbidden except for BIFS->OD*/
                                if (base->decoderConfig->streamType != stream_type) break;
                                if (!base->dependsOnESID) break;
                                es_id = base->dependsOnESID;
                        }
                }
                /*not part of same object as base, remove*/
                if (es_id != def_id) {
                        gf_list_del_item(odm->OD->ESDescriptors, esd);
                        gf_odf_desc_del((GF_Descriptor*) esd);
                        i--;
                }
        }
}

/*Validate the streams in this OD, and check if we have to setup an inline scene*/
GF_Err ODM_ValidateOD(GF_ObjectManager *odm, Bool *hasInline)
{
        u32 i;
        u16 es_id, ck_id;
        GF_ESD *esd, *base_scene;
        const char *lang_3cc, *lang_2cc;
        u32 nb_od, nb_ocr, nb_scene, nb_mp7, nb_ipmp, nb_oci, nb_mpj, nb_other, prev_st;

        nb_od = nb_ocr = nb_scene = nb_mp7 = nb_ipmp = nb_oci = nb_mpj = nb_other = 0;
        prev_st = 0;

        *hasInline = 0;

        /*step 1: validate OD*/
        ck_id = 0;
        i=0;
        while ((esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i))) {
                assert(esd->decoderConfig);
                //force single clock ID in one object
                if (!ck_id) ck_id = esd->OCRESID;
                else esd->OCRESID = ck_id;

                switch (esd->decoderConfig->streamType) {
                case GF_STREAM_OD:
                        nb_od++;
                        break;
                case GF_STREAM_OCR:
                        nb_ocr++;
                        break;
                case GF_STREAM_SCENE:
                        switch (esd->decoderConfig->objectTypeIndication) {
                        case GPAC_OTI_SCENE_AFX:
                        case GPAC_OTI_SCENE_SYNTHESIZED_TEXTURE:
                                break;
                        default:
                                nb_scene++;
                                break;
                        }
                        break;
                case GF_STREAM_MPEG7:
                        nb_mp7++;
                        break;
                case GF_STREAM_IPMP:
                        nb_ipmp++;
                        break;
                case GF_STREAM_OCI:
                        nb_oci++;
                        break;
                case GF_STREAM_MPEGJ:
                        nb_mpj++;
                        break;
                case GF_STREAM_PRIVATE_SCENE:
                        nb_scene++;
                        break;
                /*all other streams shall not be mixed: text, video, audio, interaction, font*/
                default:
                        if (esd->decoderConfig->streamType!=prev_st) nb_other++;
                        prev_st = esd->decoderConfig->streamType;
                        break;
                }
        }
        /*cf spec on stream aggregation*/
        if (nb_other>1) return GF_ODF_INVALID_DESCRIPTOR;       /*no more than one base media type*/
        if (nb_od && !nb_scene) return GF_ODF_INVALID_DESCRIPTOR; /*if OD we must have scene description*/
        if (nb_other && nb_scene) return GF_ODF_INVALID_DESCRIPTOR; /*scene OR media*/
        if (nb_ocr>1) return GF_ODF_INVALID_DESCRIPTOR; /*only ONE OCR*/
        if (nb_oci>1) return GF_ODF_INVALID_DESCRIPTOR; /*only ONE OCI*/
        if (nb_mp7>1) return GF_ODF_INVALID_DESCRIPTOR; /*only ONE MPEG-7 - this is not in the spec, but since MPEG-7 = OCI++ this seems reasonable*/
        if (nb_mpj>1) return GF_ODF_INVALID_DESCRIPTOR; /*only ONE MPEG-J - this is not in the spec but well...*/

        /*the rest should be OK*/

        /*select independant streams - check language and (TODO) bitrate & term caps*/
        lang_3cc = gf_cfg_get_key(odm->term->user->config, "Systems", "Language3CC");
        if (!lang_3cc) {
                lang_3cc = "eng";
                gf_cfg_set_key(odm->term->user->config, "Systems", "Language3CC", "eng");
                gf_cfg_set_key(odm->term->user->config, "Systems", "Language2CC", "en");
                gf_cfg_set_key(odm->term->user->config, "Systems", "LanguageName", "English");
        }
        lang_2cc = gf_cfg_get_key(odm->term->user->config, "Systems", "Language2CC");
        if (!lang_2cc) {
                lang_2cc = "en";
                gf_cfg_set_key(odm->term->user->config, "Systems", "Language3CC", "eng");
                gf_cfg_set_key(odm->term->user->config, "Systems", "Language2CC", "en");
                gf_cfg_set_key(odm->term->user->config, "Systems", "LanguageName", "English");
        }

        if (gf_list_count(odm->OD->ESDescriptors)>1) {
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_SCENE);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_OD);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_VISUAL);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_AUDIO);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_IPMP);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_INTERACT);
                ODM_SelectAlternateStream(odm, lang_3cc, lang_2cc, GF_STREAM_TEXT);
        }

        /*no scene, OK*/
        if (!nb_scene) return GF_OK;

        /*check if inline or animation stream*/
        *hasInline = 1;
        base_scene = NULL;
        i=0;
        while ( (esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i)) ) {
                switch (esd->decoderConfig->streamType) {
                case GF_STREAM_PRIVATE_SCENE:
                case GF_STREAM_SCENE:
                        base_scene = esd;
                        break;
                default:
                        break;
                }
                if (base_scene) break;
        }

        /*we have a scene stream without dependancies, this is an inline*/
        if (!base_scene || !base_scene->dependsOnESID) return GF_OK;

        /*if the stream the base scene depends on is in this OD, this is in inline*/
        es_id = base_scene->dependsOnESID;
        while (es_id) {
                esd = od_get_esd(odm->OD, es_id);
                /*the stream this stream depends on is not in this OD, this is some anim stream*/
                if (!esd) {
                        *hasInline = 0;
                        return GF_OK;
                }
                es_id = esd->dependsOnESID;
                /*should be forbidden (circular reference), we assume this describes inline (usually wrong BIFS->OD setup)*/
                if (es_id==base_scene->ESID) break;
        }
        /*no dependency to external stream, this is an inline*/
        return GF_OK;
}

static Bool gf_odm_should_auto_select(GF_ObjectManager *odm)
{
        u32 i, count;
        if (gf_codec_is_scene_or_image(odm->codec)) return GF_TRUE;

        if (odm->parentscene && !odm->parentscene->is_dynamic_scene) {
                return GF_TRUE;
        }

        if (odm->parentscene && odm->parentscene->root_od->addon) {
                if (odm->parentscene->root_od->addon->addon_type == GF_ADDON_TYPE_MAIN)
                        return GF_FALSE;
        }

        count = gf_list_count(odm->parentscene->resources);
        for (i=0; i<count; i++) {
                GF_ObjectManager *an_odm = gf_list_get(odm->parentscene->resources, i);
                if (an_odm==odm) continue;
                if (!an_odm->codec) continue;
                if (an_odm->codec->type != odm->codec->type) continue;
                //same type - if the first one has been autumatically activated, do not activate this one
                if (an_odm->state == GF_ODM_STATE_PLAY) return GF_FALSE;
        }
        return GF_TRUE;
}


/*connection of OD and setup of streams. The streams are not requested if the OD
is in an unexecuted state
the ODM is created either because of IOD / remoteOD, or by the OD codec. In the later
case, the GF_Scene pointer will be set by the OD codec.*/
GF_EXPORT
void gf_odm_setup_object(GF_ObjectManager *odm, GF_ClientService *serv)
{
        Bool hasInline;
        u32 i, numOK;
        GF_Err e;
        GF_ESD *esd;
        GF_MediaObject *syncRef;

        gf_term_lock_net(odm->term, GF_TRUE);

        if (!odm->net_service) {
                if (odm->flags & GF_ODM_DESTROYED) {
                        GF_LOG(GF_LOG_WARNING, GF_LOG_MEDIA, ("[ODM%d] Object has been scheduled for destruction - ignoring object setup\n", odm->OD->objectDescriptorID));
                        gf_term_lock_net(odm->term, GF_FALSE);
                        return;
                }
                odm->net_service = serv;
                assert(odm->OD);
                if (!odm->OD->URLString)
                        odm->net_service->nb_odm_users++;
        }
        /*if this is a remote OD, we need a new manager and a new service...*/
        assert(odm->OD);
        if (odm->OD->URLString) {
                GF_ClientService *parent = odm->net_service;
                char *url = odm->OD->URLString;
                char *parent_url = NULL;
                odm->OD->URLString = NULL;
                /*store original OD ID */
                if (!odm->media_current_time) odm->media_current_time = odm->OD->objectDescriptorID;

                gf_odf_desc_del((GF_Descriptor *)odm->OD);
                odm->OD = NULL;
                odm->net_service = NULL;
                GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[Terminal] Object redirection to %s (MO %08x)\n", url, odm->mo));

                /*if object is a scene, create the inline before connecting the object.
                        This is needed in irder to register the nodes using the resource for event
                        propagation (stored at the inline level)
                */
                if (odm->mo && (odm->mo->type==GF_MEDIA_OBJECT_SCENE)) {
                        odm->subscene = gf_scene_new(odm->parentscene);
                        odm->subscene->root_od = odm;
                }
                parent_url = parent ? parent->url : NULL;
                if (parent_url && !strnicmp(parent_url, "views://", 8))
                        parent_url = NULL;

                gf_term_post_connect_object(odm->term, odm, url, parent_url);
                gf_free(url);
                gf_term_lock_net(odm->term, GF_FALSE);
                return;
        }
        /*restore OD ID */
        if (odm->media_current_time) {
                odm->OD->objectDescriptorID = odm->media_current_time;
                odm->media_current_time = 0;
                odm->flags |= GF_ODM_REMOTE_OD;
        }

        /*HACK - temp storage of sync ref*/
        syncRef = (GF_MediaObject*)odm->ocr_codec;
        odm->ocr_codec = NULL;

        e = ODM_ValidateOD(odm, &hasInline);
        if (e) {
                GF_Terminal *term = odm->term;
                gf_term_message(term, odm->net_service->url, "MPEG-4 Service Error", e);
                gf_odm_disconnect(odm, GF_TRUE);
                gf_term_lock_net(term, GF_FALSE);
                return;
        }

        if (odm->mo && (odm->mo->type == GF_MEDIA_OBJECT_UPDATES)) {
                hasInline = GF_TRUE;
        }

        if (odm->net_service->owner &&  (odm->net_service->owner->flags & GF_ODM_INHERIT_TIMELINE)) {
                odm->flags |= GF_ODM_INHERIT_TIMELINE;
        }

        /*if there is a BIFS stream in the OD, we need an GF_Scene (except if we already
        have one, which means this is the first IOD)*/
        if (hasInline && !odm->subscene) {
                odm->subscene = gf_scene_new(odm->parentscene);
                odm->subscene->root_od = odm;
        }
        /*patch for DASH and OD streams: we need to keep track of the original service demuxing the channel, which is not the DASH service*/
        if (!odm->OD->service_ifce && odm->parentscene) {
                odm->OD->service_ifce  = odm->parentscene->root_od->OD->service_ifce;
        }

        numOK = odm->pending_channels = 0;
        /*empty IOD, use a dynamic scene*/
        if (!gf_list_count(odm->OD->ESDescriptors) && odm->subscene) {
                GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[ODM%d] No streams in object - taking over scene graph generation\n",odm->OD->objectDescriptorID));
                assert(odm->subscene->root_od==odm);
                odm->subscene->is_dynamic_scene = GF_TRUE;
        } else {
                GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[Terminal] Setting up object streams\n"));
                /*avoid channels PLAY request when confirming connection (sync network service)*/
                odm->state = GF_ODM_STATE_IN_SETUP;

                gf_odm_lock(odm, 1);
                gf_term_lock_net(odm->term, GF_FALSE);
                i=0;
                while ((esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i)) ) {
                        e = gf_odm_setup_es(odm, esd, serv, syncRef);
                        /*notify error but still go on, all streams are not so useful*/
                        if (e==GF_OK) {
                                numOK++;
                        } else {
                                gf_term_message(odm->term, odm->net_service->url, "Stream Setup Failure", e);
                        }
                }
                if (odm->codec) {
                        GF_CodecCapability cap;
                        cap.CapCode = GF_CODEC_CAN_INIT;
                        cap.cap.valueInt = odm->term->compositor->video_out->max_screen_bpp;
                        gf_codec_set_capability(odm->codec, cap);
                }
                gf_term_lock_net(odm->term, GF_TRUE);
                odm->state = GF_ODM_STATE_STOP;
                gf_odm_lock(odm, 0);
        }
        /*setup mediaobject info except for top-level OD*/
        if (odm->parentscene) {
                GF_Event evt;

                //this may result in an attempt to lock the compositor, so release the net MX before
                if (!odm->scalable_addon) {
                        gf_term_lock_net(odm->term, GF_FALSE);
                        gf_scene_setup_object(odm->parentscene, odm);
                        gf_term_lock_net(odm->term, GF_TRUE);
                }

                /*setup node decoder*/
                if (odm->mo && odm->codec && odm->codec->decio && (odm->codec->decio->InterfaceType==GF_NODE_DECODER_INTERFACE) ) {
                        GF_NodeDecoder *ndec = (GF_NodeDecoder *) odm->codec->decio;
                        GF_Node *n = gf_event_target_get_node(gf_mo_event_target_get(odm->mo, 0));
                        if (n) ndec->AttachNode(ndec, n);

                        /*not clear in the spec how the streams attached to AFX are started - default to "right now"*/
                        gf_odm_start(odm, 0);
                }

                gf_term_lock_net(odm->term, GF_FALSE);

                evt.type = GF_EVENT_CONNECT;
                evt.connect.is_connected = GF_TRUE;
                gf_term_forward_event(odm->term, &evt, GF_FALSE, GF_TRUE);

                gf_term_lock_net(odm->term, GF_TRUE);
        } else {
                /*othewise send a connect ack for top level*/
                GF_Event evt;

                GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[ODM] Root object connected !\n", odm->net_service->url));

                gf_term_lock_net(odm->term, GF_FALSE);

                evt.type = GF_EVENT_CONNECT;
                evt.connect.is_connected = GF_TRUE;
                gf_term_send_event(odm->term, &evt);

                gf_term_lock_net(odm->term, GF_TRUE);
        }

        /* start object*/
        /*case 1: object is the root, always start*/
        if (!odm->parentscene) {
                assert(odm->subscene == odm->term->root_scene);
                assert(odm->subscene && (odm->subscene->root_od==odm));
                odm->flags &= ~GF_ODM_NOT_SETUP;
                gf_odm_start(odm, 0);
        }
        /*case 2: object is a pure OCR object - connect*/
        else if (odm->ocr_codec) {
                odm->flags &= ~GF_ODM_NOT_SETUP;
                gf_odm_start(odm, 0);
        }
        /*case 3: if the object is inserted from a broadcast, start it if not already done. This covers cases where the scene (BIFS, LASeR) and
        the media (images) are both carrouseled and the carrousels are interleaved. If we wait for the scene to trigger a PLAY, we will likely
        have to wait for an entire image carousel period to start filling the buffers, which is sub-optimal
        we also force a prefetch for object declared outside the OD stream to make sure we don't loose any data before object declaration and play
        as can be the case with MPEG2 TS (first video packet right after the PMT) - this should be refined*/
        else if ( ((odm->flags & GF_ODM_NO_TIME_CTRL) || (odm->flags & GF_ODM_NOT_IN_OD_STREAM)) && gf_odm_should_auto_select(odm) && (odm->parentscene->selected_service_id == odm->OD->ServiceID)) {
                Bool force_play = GF_FALSE;
                //since we're about to evaluate the play state, lock the queue
                gf_term_lock_media_queue(odm->term, GF_TRUE);
                if (odm->state==GF_ODM_STATE_STOP) {
                        odm->flags |= GF_ODM_PREFETCH;
                        force_play = GF_TRUE;
                }
                /*the object could have been queued for play when setting up the scene object. If so, remove from queue and start right away*/
                else if ((odm->state==GF_ODM_STATE_PLAY) && (gf_list_del_item(odm->term->media_queue, odm)>=0) ) {
                        force_play = GF_TRUE;
                }
                gf_term_lock_media_queue(odm->term, GF_FALSE);

                if (force_play) {
                        odm->flags |= GF_ODM_INITIAL_BROADCAST_PLAY;
                        odm->parentscene->selected_service_id = odm->OD->ServiceID;

                        GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d] Inserted from input service %s - forcing play\n", odm->OD->objectDescriptorID, odm->net_service->url));
                        odm->flags &= ~GF_ODM_NOT_SETUP;
                        gf_odm_start(odm, 2);
                }
        }

        odm->flags &= ~GF_ODM_NOT_SETUP;

        /*for objects inserted by user (subs & co), auto select*/
        if (odm->parentscene && odm->parentscene->is_dynamic_scene
                && (odm->OD->objectDescriptorID==GF_MEDIA_EXTERNAL_ID)
                && (odm->flags & GF_ODM_REMOTE_OD)
           ) {
                GF_Event evt;

                if (odm->addon) {
                        Bool role_set = 0;
                        gf_term_lock_net(odm->term, GF_FALSE);

                        if (odm->addon->addon_type >= GF_ADDON_TYPE_MAIN) return;

                        //check role - for now look into URL, we need to inspect DASH roles
                        if (odm->mo && odm->mo->URLs.count && odm->mo->URLs.vals[0].url) {
                                char *sep = strchr(odm->mo->URLs.vals[0].url, '?');
                                if (sep && strstr(sep, "role=main")) {
                                        odm->addon->addon_type = GF_ADDON_TYPE_MAIN;
                                        role_set = 1;
                                }
                        }

                        if (!role_set) {
                                GF_NetworkCommand com;
                                memset(&com, 0, sizeof(GF_NetworkCommand));
                                com.base.command_type = GF_NET_SERVICE_INFO;
                                com.info.on_channel = gf_list_get(odm->channels, 0);
                                gf_term_service_command(odm->net_service, &com);

                                if (com.info.role && !strcmp(com.info.role, "main")) {
                                        odm->addon->addon_type = GF_ADDON_TYPE_MAIN;
                                }
                        }


                        if (odm->addon->addon_type == GF_ADDON_TYPE_ADDITIONAL) {
                                gf_scene_select_object(odm->parentscene, odm);
                        }
                        return;
                }

                if (odm->OD_PL) {
                        gf_scene_select_object(odm->parentscene, odm);
                        odm->OD_PL = 0;
                        gf_term_lock_net(odm->term, GF_FALSE);
                        return;
                }

                if (odm->parentscene==odm->term->root_scene) {
                        gf_term_lock_net(odm->term, GF_FALSE);

                        evt.type = GF_EVENT_STREAMLIST;
                        gf_term_send_event(odm->term,&evt);
                        return;
                }
        }

        /*if object codec is prefered one, auto select*/
        if (odm->parentscene && odm->parentscene->is_dynamic_scene
                && odm->codec && (odm->codec->oti==odm->term->prefered_audio_codec_oti)
                && (odm->parentscene->selected_service_id == odm->OD->ServiceID)
           ) {
                gf_scene_select_object(odm->parentscene, odm);
        }

        gf_term_lock_net(odm->term, GF_FALSE);
}



void ODM_CheckChannelService(GF_Channel *ch)
{
        if (ch->service == ch->odm->net_service) return;
        /*if the stream has created a service check if close is needed or not*/
        if (ch->esd->URLString && !ch->service->nb_ch_users)
                gf_term_close_service(ch->odm->term, ch->service);
}

/*setup channel, clock and query caps*/
GF_EXPORT
GF_Err gf_odm_setup_es(GF_ObjectManager *odm, GF_ESD *esd, GF_ClientService *serv, GF_MediaObject *sync_ref)
{
        GF_Channel *ch;
        GF_Clock *ck;
        GF_List *ck_namespace;
        GF_Codec *dec;
        s8 flag;
        u16 clockID;
        Bool emulated_od = 0;
        GF_Err e;
        GF_Scene *scene;
        Bool clock_inherited = GF_TRUE;

        /*find the clock for this new channel*/
        ck = NULL;
        flag = (s8) -1;

        /*sync reference*/
        if (sync_ref && sync_ref->odm && sync_ref->odm->codec) {
                ck = sync_ref->odm->codec->ck;
                goto clock_setup;
        }
        /*timeline override*/
        if (odm->flags & GF_ODM_INHERIT_TIMELINE) {
                if (odm->parentscene->root_od->subscene->scene_codec) {
                        ck = odm->parentscene->root_od->subscene->scene_codec->ck;
                } else {
                        ck = odm->parentscene->root_od->subscene->dyn_ck;
                }
                /**/
                if (!ck) {
                        GF_ObjectManager *odm_par = odm->parentscene->root_od->parentscene->root_od;
                        while (odm_par) {
                                if (odm_par->subscene->scene_codec)
                                        ck = odm_par->subscene->scene_codec->ck;
                                else
                                        ck = odm_par->subscene->dyn_ck;

                                if (ck) break;

                                odm_par = (odm_par->parentscene && odm_par->parentscene->root_od->parentscene ) ? odm_par->parentscene->root_od->parentscene->root_od : NULL;
                        }
                }
                if (ck)
                        goto clock_setup;
                GF_LOG(GF_LOG_WARNING, GF_LOG_MEDIA, ("[ODM] Cannot inherit timeline from parent scene for scene %s - new clock will be created\n", odm->net_service->url));
        }

        /*get clocks namespace (eg, parent scene)*/
        scene = odm->subscene ? odm->subscene : odm->parentscene;
        if (!scene) return GF_BAD_PARAM;

        ck_namespace = odm->net_service->Clocks;
        odm->set_speed = odm->net_service->set_speed;

        /*little trick for non-OD addressing: if object is a remote one, and service owner already has clocks,
        override OCR. This will solve addressing like file.avi#audio and file.avi#video*/
        if (!esd->OCRESID && (odm->flags & GF_ODM_REMOTE_OD) && (gf_list_count(ck_namespace)==1) ) {
                ck = (GF_Clock*)gf_list_get(ck_namespace, 0);
                esd->OCRESID = ck->clockID;
        }
        /*for dynamic scene, force all streams to be sync on main OD stream (one timeline, no need to reload ressources)*/
        else if (odm->parentscene && odm->parentscene->is_dynamic_scene && !odm->subscene) {
                GF_ObjectManager *parent_od = odm->parentscene->root_od;
                if (parent_od->net_service && (gf_list_count(parent_od->net_service->Clocks)==1)) {
                        ck = (GF_Clock*)gf_list_get(parent_od->net_service->Clocks, 0);
                        if (!odm->OD->ServiceID || (odm->OD->ServiceID==ck->service_id)) {
                                esd->OCRESID = ck->clockID;
                                goto clock_setup;
                        }
                }
        }

        /*do we have an OCR specified*/
        clockID = esd->OCRESID;
        /*if OCR stream force self-synchro !!*/
        if (esd->decoderConfig->streamType==GF_STREAM_OCR) clockID = esd->ESID;
        if (!clockID) {
                /*if no clock ID but depandancy, force the clock to be the base layer for AV but not systems (animation streams, ..)*/
                if ((esd->decoderConfig->streamType==GF_STREAM_VISUAL) || (esd->decoderConfig->streamType==GF_STREAM_AUDIO)) clockID = esd->dependsOnESID;
                if (!clockID) clockID = esd->ESID;
        }

        /*override clock dependencies if specified*/
        if (odm->term->flags & GF_TERM_SINGLE_CLOCK) {
                if (scene->scene_codec) {
                        clockID = scene->scene_codec->ck->clockID;
                } else if (scene->od_codec) {
                        clockID = scene->od_codec->ck->clockID;
                }
                ck_namespace = odm->term->root_scene->root_od->net_service->Clocks;
        }
        /*if the GF_Clock is the stream, check if we have embedded OCR in the stream...*/
        if (clockID == esd->ESID) {
                flag = (esd->slConfig && esd->slConfig->OCRLength);
        }

        if (!esd->slConfig) {
                esd->slConfig = (GF_SLConfig *)gf_odf_desc_new(GF_ODF_SLC_TAG);
                esd->slConfig->timestampResolution = 1000;
        }

        ck = gf_clock_attach(ck_namespace, scene, clockID, esd->ESID, flag);
        if (!ck) return GF_OUT_OF_MEM;
        esd->OCRESID = ck->clockID;
        ck->service_id = odm->OD->ServiceID;
        clock_inherited = GF_FALSE;
        /*special case for non-dynamic scenes forcing clock share of all subscene, we assign the
        parent scene clock to the first clock created in the sunscenes*/
        if (scene->root_od->parentscene && scene->root_od->parentscene->force_single_timeline && !scene->root_od->parentscene->dyn_ck)
                scene->root_od->parentscene->dyn_ck = ck;

clock_setup:
        /*create a channel for this stream*/
        ch = gf_es_new(esd);
        if (!ch) return GF_OUT_OF_MEM;
        ch->clock = ck;
        ch->service = serv;
        ch->clock_inherited = clock_inherited;

        GF_LOG(GF_LOG_DEBUG, GF_LOG_MEDIA, ("[ODM] Creating codec for stream %d\n", ch->esd->ESID));

        /*setup the decoder for this stream or find the existing one.*/
        e = GF_OK;
        dec = NULL;
        switch (esd->decoderConfig->streamType) {
        case GF_STREAM_OD:
                //OD - MUST be in inline
                if (!odm->subscene) {
                        e = GF_NON_COMPLIANT_BITSTREAM;
                        break;
                }
                /*OD codec acts as main scene codec when used to generate scene graph*/
                if (! odm->subscene->od_codec) {
                        odm->subscene->od_codec = gf_codec_new(odm, esd, odm->OD_PL, &e);
                        if (!e) gf_term_add_codec(odm->term, odm->subscene->od_codec);
                }
                dec = odm->subscene->od_codec;
                break;
        case GF_STREAM_OCR:
                /*OD codec acts as main scene codec when used to generate scene graph*/
                dec = odm->ocr_codec = gf_codec_new(odm, esd, odm->OD_PL, &e);
                if (!e) gf_term_add_codec(odm->term, odm->ocr_codec);
                break;
        case GF_STREAM_SCENE:
                /*animationStream */
                if (!odm->subscene) {
                        if (!odm->codec) {
                                odm->codec = gf_codec_new(odm, esd, odm->Scene_PL, &e);
                                if (!e) gf_term_add_codec(odm->term, odm->codec);
                        }
                        dec = odm->codec;
                }
                /*inline scene*/
                else {
                        if (! odm->subscene->scene_codec) {
                                odm->subscene->scene_codec = gf_codec_new(odm, esd, odm->Scene_PL, &e);
                                if (!e) gf_term_add_codec(odm->term, odm->subscene->scene_codec);
                        }
                        dec = odm->subscene->scene_codec;
                }
                break;
#ifndef GPAC_MINIMAL_ODF
        case GF_STREAM_OCI:
                /*OCI - only one per OD */
                if (odm->oci_codec) {
                        e = GF_NON_COMPLIANT_BITSTREAM;
                } else {
                        odm->oci_codec = gf_codec_new(odm, esd, odm->OD_PL, &e);
                        odm->oci_codec->odm = odm;
                        if (!e) gf_term_add_codec(odm->term, odm->oci_codec);
                }
                break;
#endif

        case GF_STREAM_AUDIO:
        case GF_STREAM_VISUAL:
                /*we have a media or user-specific codec...*/
                if (!odm->codec) {
                        odm->codec = gf_codec_new(odm, esd, (esd->decoderConfig->streamType==GF_STREAM_VISUAL) ? odm->Visual_PL : odm->Audio_PL, &e);
                        if (!e && odm->codec) gf_term_add_codec(odm->term, odm->codec);
                }
                dec = odm->codec;
                break;

                /*interaction stream*/
#ifndef GPAC_DISABLE_VRML
        case GF_STREAM_INTERACT:
                if (!odm->codec) {
                        odm->codec = gf_codec_new(odm, esd, odm->OD_PL, &e);
                        if (!e) {
                                gf_isdec_configure(odm->codec->decio, odm->parentscene, esd->URLString ? 1 : 0);
                                gf_term_add_codec(odm->term, odm->codec);
                                /*register it*/
                                gf_list_add(odm->term->input_streams, odm->codec);
                        }
                }
                dec = odm->codec;
                if ((esd->ESID==esd->OCRESID) &&(esd->ESID>=65530)) {
                        emulated_od = 1;
                }
                break;
#endif

        case GF_STREAM_PRIVATE_SCENE:
                if (odm->subscene) {
                        assert(!odm->subscene->scene_codec);
                        odm->subscene->scene_codec = gf_codec_new(odm, esd, odm->Scene_PL, &e);
                        if (odm->subscene->scene_codec) {
                                gf_term_add_codec(odm->term, odm->subscene->scene_codec);
                        }
                        dec = odm->subscene->scene_codec;
                } else {
                        /*this is a bit tricky: the scene decoder needs to be called with the dummy streams of this
                        object, so we associate the main decoder to this object*/
                        odm->codec = dec = gf_codec_use_codec(odm->parentscene->scene_codec, odm);
                        gf_term_add_codec(odm->term, odm->codec);
                }
                break;
        /*all other cases*/
        default:
                if (!odm->codec) {
                        odm->codec = gf_codec_new(odm, esd, odm->OD_PL, &e);
                        if (!e && odm->codec) gf_term_add_codec(odm->term, odm->codec);

                }
                dec = odm->codec;
                break;
        }

        if (!dec && e) {
                gf_es_del(ch);
                return e;
        }

        /*setup scene decoder*/
        if (dec && dec->decio && (dec->decio->InterfaceType==GF_SCENE_DECODER_INTERFACE) ) {
                GF_SceneDecoder *sdec = (GF_SceneDecoder *) dec->decio;
                scene = odm->subscene ? odm->subscene : odm->parentscene;
                if (sdec->AttachScene) {
                        /*if a node asked for this media object, use the scene graph of the node (AnimationStream in PROTO)*/
                        if (odm->mo && odm->mo->node_ptr) {
                                GF_SceneGraph *sg = scene->graph;
                                /*FIXME - this MUST be cleaned up*/
                                scene->graph = gf_node_get_graph((GF_Node*)odm->mo->node_ptr);
                                sdec->AttachScene(sdec, scene, (scene->scene_codec==dec) ? 1: 0);
                                scene->graph = sg;
                                odm->mo->node_ptr = NULL;
                        } else {
                                sdec->AttachScene(sdec, scene, (scene->scene_codec==dec) ? 1: 0);
                        }
                }
        }

        ch->es_state = GF_ESM_ES_SETUP;
        ch->odm = odm;

        if (dec) {
                GF_CodecCapability cap;
                cap.CapCode = GF_CODEC_RAW_MEDIA;
                gf_codec_get_capability(dec, &cap);
                if (cap.cap.valueInt) {
                        dec->flags |= GF_ESM_CODEC_IS_RAW_MEDIA;
                        dec->process = gf_codec_process_private_media;
                }

                /*get media padding BEFORE channel setup, since we use it on channel connect ack*/
                cap.CapCode = GF_CODEC_PADDING_BYTES;
                gf_codec_get_capability(dec, &cap);
                ch->media_padding_bytes = cap.cap.valueInt;

                cap.CapCode = GF_CODEC_RESILIENT;
                gf_codec_get_capability(dec, &cap);
                ch->codec_resilient = cap.cap.valueInt;
        }

        if (emulated_od) {
                ch->service = NULL;
        }

        /*one more channel to wait for*/
        odm->pending_channels++;

        /*service redirection*/
        if (esd->URLString) {
                GF_ChannelSetup *cs;
                /*here we have a pb with the MPEG4 model: streams are supposed to be attachable as soon as the OD
                update is received, but this is not true with ESD URLs, where service setup may take some time (file
                downloading, authentification, etc...). We therefore need to wait for the service connect response before
                setting up the channel...*/
                cs = (GF_ChannelSetup*)gf_malloc(sizeof(GF_ChannelSetup));
                cs->ch = ch;
                cs->dec = dec;

                /*HACK: special case when OD resources are statically described in the ESD itself (ISMA streaming)*/
                if (dec && (ch->esd->decoderConfig->streamType==GF_STREAM_OD) && strstr(ch->esd->URLString, "data:application/mpeg4-od-au;") )
                        dec->flags |= GF_ESM_CODEC_IS_STATIC_OD;

                gf_term_lock_net(odm->term, 1);
                gf_list_add(odm->term->channels_pending, cs);
                e = gf_term_connect_remote_channel(odm->term, ch, esd->URLString);
                if (e) {
                        s32 i = gf_list_find(odm->term->channels_pending, cs);
                        if (i>=0) {
                                gf_list_rem(odm->term->channels_pending, (u32) i);
                                gf_free(cs);
                                odm->pending_channels--;
                                ODM_CheckChannelService(ch);
                                gf_es_del(ch);
                        }
                }
                gf_term_lock_net(odm->term, 0);
                if (ch->service->owner) {
                        gf_list_del_item(odm->term->channels_pending, cs);
                        gf_free(cs);
                        return gf_odm_post_es_setup(ch, dec, GF_OK);
                }
                return e;
        }

        /*regular setup*/
        return gf_odm_post_es_setup(ch, dec, GF_OK);
}

GF_Err gf_odm_post_es_setup(GF_Channel *ch, GF_Codec *dec, GF_Err had_err)
{
        char szURL[2048];
        GF_Err e;
        GF_NetworkCommand com;

        e = had_err;
        if (e) {
                ch->odm->pending_channels--;
                goto err_exit;
        }

        /*insert channel*/
        gf_list_insert(ch->odm->channels, ch, 0);

        if (ch->service) {
                ch->es_state = GF_ESM_ES_WAIT_FOR_ACK;
                if (ch->esd->URLString) {
                        strcpy(szURL, ch->esd->URLString);
                } else {
                        sprintf(szURL, "ES_ID=%u", ch->esd->ESID);
                }

                /*connect before setup: this is needed in case the decoder cfg is wrong, we may need to get it from
                network config...*/
                e = ch->service->ifce->ConnectChannel(ch->service->ifce, ch, szURL, ch->esd->decoderConfig->upstream);

                /*special case (not really specified in specs ...): if the stream is not found and is an Interaction
                one (ie, used by an InputSensor), consider this means the stream shall be generated by the IS device*/
                if ((e==GF_STREAM_NOT_FOUND) && (ch->esd->decoderConfig->streamType==GF_STREAM_INTERACT)) e = GF_OK;
        } else {
                ch->es_state = GF_ESM_ES_CONNECTED;
                ch->odm->pending_channels--;
        }

        if (e) {
                if (dec) gf_list_rem(ch->odm->channels, 0);
                goto err_exit;
        }
        /*add to decoder*/
        if (dec) {
                e = gf_codec_add_channel(dec, ch);
                if (e) {
                        switch (ch->esd->decoderConfig->streamType) {
                        case GF_STREAM_VISUAL:
                                gf_term_message(ch->odm->term, ch->service->url, "Video Setup failed", e);
                                break;
                        case GF_STREAM_AUDIO:
                                gf_term_message(ch->odm->term, ch->service->url, "Audio Setup failed", e);
                                break;
                        }
                        gf_list_del_item(ch->odm->channels, ch);
                        /*disconnect*/
                        ch->service->ifce->DisconnectChannel(ch->service->ifce, ch);
                        if (ch->esd->URLString) {
                                assert(ch->service->nb_ch_users);
                                ch->service->nb_ch_users--;
                        }
                        goto err_exit;
                }
        }

        /*in case a channel is inserted in a running OD, open and play if not in queue*/
        if (ch->odm->state==GF_ODM_STATE_PLAY) {

                gf_term_lock_media_queue(ch->odm->term, 1);
                gf_list_del_item(ch->odm->term->media_queue, ch->odm);
                gf_term_lock_media_queue(ch->odm->term, 1);


                gf_term_lock_net(ch->odm->term, 1);
                gf_es_start(ch);
                memset(&com, 0, sizeof(GF_NetworkCommand));
                com.command_type = GF_NET_CHAN_PLAY;
                com.base.on_channel = ch;
                com.play.speed = FIX2FLT(ch->clock->speed);
                com.play.start_range = gf_clock_time(ch->clock);
                com.play.start_range /= 1000;
                com.play.end_range = 0;
                gf_term_service_command(ch->service, &com);
                if (dec && (dec->Status!=GF_ESM_CODEC_PLAY)) gf_term_start_codec(dec, 0);
                gf_term_lock_net(ch->odm->term, 0);
        }
        return GF_OK;

err_exit:
        ODM_CheckChannelService(ch);
        gf_es_del(ch);
        return e;
}

/*confirmation of channel delete from net*/
void ODM_DeleteChannel(GF_ObjectManager *odm, GF_Channel *ch)
{
        u32 i, count, ch_pos;
        GF_Channel *ch2;
        GF_Clock *ck;

        if (!ch) return;
        assert( odm );
        assert( odm->channels );

        //find a clock with this stream ES_ID
        ck = gf_clock_find(odm->net_service->Clocks, ch->esd->ESID, 0);

        count = gf_list_count(odm->channels);
        ch_pos = count+1;

        for (i=0; i<count; i++) {
                ch2 = (GF_Channel*)gf_list_get(odm->channels, i);
                if (ch2 == ch) {
                        ch_pos = i;
                        if (ck) continue;
                        break;
                }
                //note that when a stream is added, we need to update clocks info ...
                if (ck && ch->clock && (ch2->clock->clockID == ck->clockID)) gf_es_stop(ch2);
        }
        /*remove channel*/
        if (ch_pos != count+1) gf_list_rem(odm->channels, ch_pos);

        /*remove from the codec*/
        count = 0;
        if (!count && odm->codec)
                count = gf_codec_remove_channel(odm->codec, ch);
        if (!count && odm->ocr_codec)
                count = gf_codec_remove_channel(odm->ocr_codec, ch);
#ifndef GPAC_MINIMAL_ODF
        if (!count && odm->oci_codec)
                count = gf_codec_remove_channel(odm->oci_codec, ch);
#endif
        if (!count && odm->subscene) {
                if (odm->subscene->scene_codec) count = gf_codec_remove_channel(odm->subscene->scene_codec, ch);
                if (!count) /*count = */gf_codec_remove_channel(odm->subscene->od_codec, ch);
        }
        if (ch->service) {
                ch->service->ifce->DisconnectChannel(ch->service->ifce, ch);
                if (ch->esd->URLString) {
                        assert(ch->service->nb_ch_users);
                        ch->service->nb_ch_users--;
                }
                ODM_CheckChannelService(ch);
        }

        //and delete
        gf_es_del(ch);
}

GF_EXPORT
void gf_odm_remove_es(GF_ObjectManager *odm, u16 ES_ID)
{
        GF_ESD *esd;
        GF_Channel *ch;
        u32 i = 0;
        while ((esd = (GF_ESD *)gf_list_enum(odm->OD->ESDescriptors, &i)) ) {
                if (esd->ESID==ES_ID) goto esd_found;
        }
        return;

esd_found:
        /*remove esd*/
        gf_list_rem(odm->OD->ESDescriptors, i-1);
        /*locate channel*/
        ch = NULL;
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                if (ch->esd->ESID == ES_ID) break;
                ch = NULL;
        }
        /*remove channel*/
        if (ch) ODM_DeleteChannel(odm, ch);
        /*destroy ESD*/
        gf_odf_desc_del((GF_Descriptor *) esd);
}

/*this is the tricky part: make sure the net is locked before doing anything since an async service
reply could destroy the object we're queuing for play*/
void gf_odm_start(GF_ObjectManager *odm, u32 media_queue_state)
{
        Bool skip_register = 1;
        gf_term_lock_media_queue(odm->term, 1);

        if (odm->flags & GF_ODM_NOT_SETUP) {
                gf_term_lock_media_queue(odm->term, 0);
                return;
        }


        /*only if not open & ready (not waiting for ACK on channel setup)*/
        if (!odm->pending_channels && odm->OD) {
                /*object is not started - issue channel setup requests*/
                if (!odm->state) {
                        GF_Channel *ch;
                        u32 i = 0;
                        odm->state = GF_ODM_STATE_PLAY;

                        /*look for a given segment name to play*/
                        if (odm->subscene) {
                                char *url, *frag;
                                assert(odm->subscene->root_od==odm);

                                url = (odm->mo && odm->mo->URLs.count) ? odm->mo->URLs.vals[0].url : odm->net_service->url;
                                frag = strrchr(url, '#');
                                if (frag) {
                                        GF_Segment *seg = gf_odm_find_segment(odm, frag+1);
                                        if (seg) {
                                                odm->media_start_time = (u64) ((s64) seg->startTime*1000);
                                                odm->media_stop_time =  (u64) ((s64) (seg->startTime + seg->Duration)*1000);
                                        }
                                }
                        }

                        /*start all channels and postpone play - this assures that all channels of a multiplexed are setup
                        before one starts playing*/
                        while ( (ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                                gf_es_start(ch);
                                GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d] CH%d: At OTB %u starting channel\n", odm->OD->objectDescriptorID, ch->esd->ESID, gf_clock_time(ch->clock)));
                        }
                        skip_register = 0;

                }
                //do not issue a play request, wait for end of setup
                else if (odm->state==GF_ODM_STATE_IN_SETUP) {
                        media_queue_state=0;
                        skip_register = 1;
                }
                /*object is already started - only reinsert in media queue if this function was called on an object already in the queue*/
                else {
                        skip_register = media_queue_state ? 0 : 1;
                }

                if (media_queue_state==2) {
                        odm->action_type = GF_ODM_ACTION_PLAY;
                        gf_term_lock_media_queue(odm->term, 0);
                        gf_odm_play(odm);
                        gf_term_lock_media_queue(odm->term, 1);
                } else if (!skip_register && (gf_list_find(odm->term->media_queue, odm)<0)) {
                        odm->action_type = GF_ODM_ACTION_PLAY;
                        assert(! (odm->flags & GF_ODM_DESTROYED));
                        gf_list_add(odm->term->media_queue, odm);
                }
        }

#if 0
        /*reset CB to stop state, otherwise updating a texture between gf_odm_start and gf_odm_play might trigger an end of stream*/
        if (odm->codec && odm->codec->CB) {
                gf_cm_set_status(odm->codec->CB, CB_STOP);
                odm->codec->CB->HasSeenEOS = 0;
        }
#endif

        gf_term_lock_media_queue(odm->term, 0);
}

void gf_odm_play(GF_ObjectManager *odm)
{
        GF_Channel *ch;
        u32 i;
        u32 nb_failure;
        u64 range_end;
        Bool skip_od_st;
        Bool media_control_paused = 0;
        Bool start_range_is_clock = 0;
        GF_NetworkCommand com;
#ifndef GPAC_DISABLE_VRML
        MediaControlStack *ctrl;
#endif
        GF_Clock *parent_ck = NULL;

        if (odm->codec && odm->codec->CB && !(odm->flags & GF_ODM_PREFETCH)) {
                /*reset*/
                gf_cm_set_status(odm->codec->CB, CB_STOP);
                odm->codec->CB->HasSeenEOS = 0;
        }
        odm->flags &= ~GF_ODM_PREFETCH;


        if (odm->parentscene) {
                parent_ck = gf_odm_get_media_clock(odm->parentscene->root_od);
                if (!gf_odm_shares_clock(odm, parent_ck)) parent_ck = NULL;
        }

        skip_od_st = (odm->subscene && odm->subscene->static_media_ressources) ? 1 : 0;
        range_end = odm->media_stop_time;
//      odm->media_stop_time = 0;

        nb_failure = gf_list_count(odm->channels);

        /*send play command*/
        memset(&com, 0, sizeof(GF_NetworkCommand));
        com.command_type = GF_NET_CHAN_PLAY;

        if (odm->flags & GF_ODM_INITIAL_BROADCAST_PLAY) {
                odm->flags &= ~GF_ODM_INITIAL_BROADCAST_PLAY;
                com.play.initial_broadcast_play = 1;
        }


        i=0;
        while ( (ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                Double ck_time;

                if (ch->ipmp_tool) {
                        GF_IPMPEvent evt;
                        GF_Err e;
                        memset(&evt, 0, sizeof(evt));
                        evt.event_type=GF_IPMP_TOOL_GRANT_ACCESS;
                        evt.channel = ch;
                        e = ch->ipmp_tool->process(ch->ipmp_tool, &evt);
                        if (e) {
                                gf_term_message(odm->term, NULL, "PLAY access is not granted on channel - please check your license", e);
                                gf_es_stop(ch);
                                continue;
                        }
                }
                nb_failure --;

                com.base.on_channel = ch;
                com.play.speed = 1.0;

                /*play from requested time (seeking or non-mpeg4 media control)*/
                if (odm->media_start_time && !ch->clock->clock_init) {
                        ck_time = (Double) (s64) odm->media_start_time;
                        ck_time /= 1000;
                }
                else if (odm->parentscene && odm->parentscene->root_od->media_start_time && !ch->clock->clock_init) {
                        ck_time = (Double) (s64) odm->parentscene->root_od->media_start_time;
                        ck_time /= 1000;
                }
                /*play from current time*/
                else {
                        ck_time = gf_clock_media_time(ch->clock);
                        ck_time /= 1000;
                        start_range_is_clock = 1;
                }

                /*handle initial start - MPEG-4 is a bit annoying here, streams are not started through OD but through
                scene nodes. If the stream runs on the BIFS/OD clock, the clock is already started at this point and we're
                sure to get at least a one-frame delay in PLAY, so just remove it - note we're generous but this shouldn't hurt*/
                if (ck_time<=0.5) ck_time = 0;


                /*adjust time for addons*/
                if (odm->parentscene && odm->parentscene->root_od->addon) {
                        com.play.initial_broadcast_play = 0;
                        //addon timing is resolved against timestamps, not media time
                        if (start_range_is_clock) {
                                if (!gf_clock_is_started(ch->clock)) {
                                        ck_time = (Double) odm->parentscene->root_od->addon->media_pts;
                                        ck_time /= 90000;
                                } else {
                                        ck_time = gf_clock_time(ch->clock);
                                        ck_time /= 1000;
                                }
                        }
                        ck_time = gf_scene_adjust_time_for_addon(odm->parentscene->root_od->addon, ck_time, &com.play.timestamp_based);
                        //we are having a play request for an addon without the main content being active - we no longer have timestamp info from the main content
                        if (!ch->clock->clock_init && com.play.timestamp_based)
                                com.play.timestamp_based = 2;

                        if (ck_time<0)
                                ck_time=0;

                        if (odm->scalable_addon) {
                                //this is a scalable extension to an object in the parent scene
                                gf_scene_select_scalable_addon(odm->parentscene->root_od->parentscene, odm);
                        }
                }

                com.play.start_range = ck_time;

                if (range_end) {
                        com.play.end_range = (s64) range_end / 1000.0;
                } else {
                        if (!odm->subscene && odm->parentscene && gf_odm_shares_clock(odm->parentscene->root_od, ch->clock)
                                && (odm->parentscene->root_od->media_stop_time != odm->parentscene->root_od->duration)
                           ) {
                                com.play.end_range = (s64) odm->parentscene->root_od->media_stop_time / 1000.0;
                        } else {
                                com.play.end_range = 0;
                        }
                }

                com.play.speed = ch->clock->speed;

#ifndef GPAC_DISABLE_VRML
                ctrl = parent_ck ? parent_ck->mc : gf_odm_get_mediacontrol(odm);
                /*override range and speed with MC*/
                if (ctrl) {
                        //for addon, use current clock settings (media control is ignored)
                        if (!odm->parentscene || !odm->parentscene->root_od->addon) {
                                //this is fake timeshift, eg we are playing a VoD as a timeshift service: stop and start times have already been adjusted
                                if (ctrl->control->mediaStopTime<0 && !odm->timeshift_depth) {
                                } else {
                                        MC_GetRange(ctrl, &com.play.start_range, &com.play.end_range);
                                }
                        }

                        com.play.speed = FIX2FLT(ctrl->control->mediaSpeed);
                        /*if the channel doesn't control the clock, jump to current time in the controled range, not just the beginning*/
                        if ((ch->esd->ESID!=ch->clock->clockID) && (ck_time>com.play.start_range) && (com.play.end_range>com.play.start_range) && (ck_time<com.play.end_range)) {
                                com.play.start_range = ck_time;
                        }
                        if (ctrl->paused) media_control_paused = 1;

                        gf_clock_set_speed(ch->clock, ctrl->control->mediaSpeed);
                        if (odm->mo) odm->mo->speed = ctrl->control->mediaSpeed;

#if 0
                        /*if requested seek time AND media control, adjust start range to current play time*/
                        if ((com.play.speed>=0) && odm->media_start_time) {
                                if ((com.play.start_range>=0) && (com.play.end_range>com.play.start_range)) {
                                        if (ctrl->control->loop) {
                                                Double active_dur = com.play.end_range - com.play.start_range;
                                                while (ck_time>active_dur) ck_time -= active_dur;
                                        } else {
                                                ck_time = 0;
                                                //com.play.start_range = com.play.end_range;
                                        }
                                }
                                com.play.start_range += ck_time;
                        }
#endif

                }
#endif

                /*full object playback*/
                if (com.play.end_range<=0) {
                        if (com.play.speed<0) {
                                odm->media_stop_time = 0;
                        } else {
                                odm->media_stop_time = odm->subscene ? 0 : odm->duration;
                        }
                } else {
                        /*segment playback - since our timing is in ms whereas segment ranges are double precision,
                        make sure we have a LARGER range in ms, otherwise media sensors won't deactivate properly*/
                        odm->media_stop_time = (u64) ceil(1000 * com.play.end_range);
                }

                /*don't replay OD channel, only init clock if needed*/
                if (!ch->service || (skip_od_st && (ch->esd->decoderConfig->streamType==GF_STREAM_OD))) {
                        Bool gf_es_owns_clock(GF_Channel *ch);

                        if (gf_es_owns_clock(ch) )
                                gf_clock_set_time(ch->clock, (u32) (com.play.start_range*1000));

                        ch->IsClockInit = 1;
                        if (ch->BufferOn) {
                                ch->BufferOn = 0;
                                gf_clock_buffer_off(ch->clock);
                        }
                } else {
                        GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d %s] CH%d: At OTB %u requesting PLAY from %g to %g (clock init %d) - speed %g\n", odm->OD->objectDescriptorID, odm->net_service->url, ch->esd->ESID, gf_clock_time(ch->clock), com.play.start_range, com.play.end_range, ch->clock->clock_init, com.play.speed));
                        gf_term_service_command(ch->service, &com);
                }
        }
//      odm->media_start_time = 0;

        if (odm->parentscene && odm->parentscene->root_od->addon) {
                odm->parentscene->root_od->addon->started = 1;
        }
        if (nb_failure) {
                odm->state = GF_ODM_STATE_BLOCKED;
                return;
        }

        gf_term_service_media_event(odm, GF_EVENT_MEDIA_LOAD_START);
        gf_term_service_media_event(odm, GF_EVENT_MEDIA_TIME_UPDATE);


        /*start codecs last (otherwise we end up pulling data from channels not yet connected->pbs when seeking)*/
        if (odm->codec) {
                gf_term_start_codec(odm->codec, 0);
        } else if (odm->subscene) {
                if (odm->subscene->scene_codec) gf_term_start_codec(odm->subscene->scene_codec, 0);
                if (!skip_od_st && odm->subscene->od_codec) gf_term_start_codec(odm->subscene->od_codec, 0);

                if (odm->flags & GF_ODM_REGENERATE_SCENE) {
                        odm->flags &= ~GF_ODM_REGENERATE_SCENE;
                        if (!odm->subscene->graph_attached)
                                gf_scene_regenerate(odm->subscene);
                        else
                                gf_scene_restart_dynamic(odm->subscene, 0, 1, 0);
                }
        }
        if (odm->ocr_codec) gf_term_start_codec(odm->ocr_codec, 0);
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) gf_term_start_codec(odm->oci_codec, 0);
#endif

        if (odm->flags & GF_ODM_PAUSE_QUEUED) {
                odm->flags &= ~GF_ODM_PAUSE_QUEUED;
                media_control_paused = 1;
        }

        if (odm->term->root_scene) {
                if (odm->term->root_scene->first_frame_pause_type) {
                        media_control_paused = GF_TRUE;
                }
        }

        if ((odm->codec || odm->subscene) && media_control_paused) {
                gf_odm_pause(odm);
        }
}

Bool gf_odm_owns_clock(GF_ObjectManager *odm, GF_Clock *ck)
{
        u32 i, j;
        GF_ObjectManager *od;
        GF_Channel *ch;
        i=0;
        while ((ch = gf_list_enum(odm->channels, &i))) {
                if (ch->esd->ESID==ck->clockID) return 1;
        }
        j=0;
        while ((od = gf_list_enum(odm->subscene->resources, &j))) {
                i=0;
                while ((ch = gf_list_enum(od->channels, &i))) {
                        if (ch->esd->ESID==ck->clockID) return 1;
                }
        }
        return 0;
}

void gf_odm_stop(GF_ObjectManager *odm, Bool force_close)
{
        GF_Channel *ch;
        u32 i;
#ifndef GPAC_DISABLE_VRML
        MediaControlStack *ctrl;
        MediaSensorStack *media_sens;
#endif

        GF_NetworkCommand com;
        //root ODs of dynamic scene may not have seen play/pause request
        if (!odm->state && !odm->scalable_addon && (!odm->subscene || !odm->subscene->is_dynamic_scene) ) return;

#if 0
        /*Handle broadcast environment, do not stop the object if no time control and instruction
        comes from the scene*/
        if (odm->no_time_ctrl && !force_close) {
                GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d] - broadcast detected, ignoring Stop from scene\n", odm->OD->objectDescriptorID);
                       return;
        }
#endif


        gf_term_lock_media_queue(odm->term, 1);
        gf_list_del_item(odm->term->media_queue, odm);
        gf_term_lock_media_queue(odm->term, 0);

        /*little opt for image codecs: don't actually stop the OD*/
        if (!force_close && odm->codec && odm->codec->CB && !odm->codec->CB->no_allocation) {
                if (odm->codec->CB->Capacity==1) {
                        gf_cm_abort_buffering(odm->codec->CB);
                        return;
                }
        }

        /*if raw media, stop all channels before sending stop command to network, to avoid new media frames to be set
        as pending and thereby locking the channel associated service*/
        if (odm->codec && odm->codec->flags & GF_ESM_CODEC_IS_RAW_MEDIA) {
                i=0;
                while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                        gf_es_stop(ch);
                }
                gf_term_stop_codec(odm->codec, 0);
                /*and wait until frame has been consumed by the renderer
                we don't use semaphore wait as the raw channel may already be pending on the semaphore*/
                while (odm->codec->CB->UnitCount) {
                        gf_sleep(1);
                }
        }


        /*object was not unlocked, decoders were not started*/
        if (odm->state==GF_ODM_STATE_BLOCKED) {
                odm->media_current_time = 0;
                gf_sema_notify(odm->raw_frame_sema, 1);
                return;
        }

        if (force_close && odm->mo) odm->mo->flags |= GF_MO_DISPLAY_REMOVE;
        /*stop codecs*/
        if (odm->codec) {
                gf_term_stop_codec(odm->codec, 0);
        } else if (odm->subscene) {
                u32 i=0;
                GF_ObjectManager *sub_odm;
                if (odm->subscene->scene_codec) gf_term_stop_codec(odm->subscene->scene_codec, 0);
                if (odm->subscene->od_codec) gf_term_stop_codec(odm->subscene->od_codec, 0);

                /*stops all resources of the subscene as well*/
                while ((sub_odm=(GF_ObjectManager *)gf_list_enum(odm->subscene->resources, &i))) {
                        gf_odm_stop(sub_odm, force_close);
                }
        }
        if (odm->ocr_codec) gf_term_stop_codec(odm->ocr_codec, 0);
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) gf_term_stop_codec(odm->oci_codec, 0);
#endif

//      gf_term_lock_net(odm->term, 1);

        /*send stop command*/
        com.command_type = GF_NET_CHAN_STOP;
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {

                if (ch->ipmp_tool) {
                        GF_IPMPEvent evt;
                        memset(&evt, 0, sizeof(evt));
                        evt.event_type=GF_IPMP_TOOL_RELEASE_ACCESS;
                        evt.channel = ch;
                        ch->ipmp_tool->process(ch->ipmp_tool, &evt);
                }

                if (ch->service) {
                        com.base.on_channel = ch;
                        gf_term_service_command(ch->service, &com);
                        GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d %s] CH %d At OTB %u requesting STOP\n", odm->OD->objectDescriptorID, odm->net_service->url, ch->esd->ESID, gf_clock_time(ch->clock)));
                }
        }

        if (odm->parentscene && odm->parentscene->root_od->addon) {
                odm->parentscene->root_od->addon->started = 0;
        }

        gf_term_service_media_event(odm, GF_EVENT_ABORT);

        /*stop channels*/
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                /*stops clock if this is a scene stop*/
                if (!(odm->flags & GF_ODM_INHERIT_TIMELINE) && odm->subscene && gf_odm_owns_clock(odm, ch->clock) ) {
                        gf_clock_stop(ch->clock);
                }
                gf_es_stop(ch);
        }

//      gf_term_lock_net(odm->term, 0);

        odm->state = GF_ODM_STATE_STOP;
        odm->media_current_time = 0;

#ifndef GPAC_DISABLE_VRML
        /*reset media sensor(s)*/
        i = 0;
        while ((media_sens = (MediaSensorStack *)gf_list_enum(odm->ms_stack, &i))) {
                MS_Stop(media_sens);
        }
        /*reset media control state*/
        ctrl = gf_odm_get_mediacontrol(odm);
        if (ctrl) ctrl->current_seg = 0;
#endif

}

void gf_odm_on_eos(GF_ObjectManager *odm, GF_Channel *on_channel)
{
        u32 i, count, nb_eos, nb_share_clock, nb_ck_running;
#ifndef GPAC_DISABLE_VRML
        if (gf_odm_check_segment_switch(odm)) return;
#endif

        nb_share_clock=0;
        nb_eos = 0;
        nb_ck_running = 0;
        count = gf_list_count(odm->channels);
        for (i=0; i<count; i++) {
                GF_Channel *ch = gf_list_get(odm->channels, i);
                if (on_channel) {
                        if (ch->clock != on_channel->clock) {
                                if (! ch->clock->has_seen_eos)
                                        nb_ck_running++;
                                continue;
                        }
                        nb_share_clock++;
                }
                if (ch->IsEndOfStream) nb_eos++;
        }
        if (on_channel) {
                if (nb_eos==nb_share_clock) {
                        on_channel->clock->has_seen_eos = 1;
#ifndef GPAC_DISABLE_VRML
                        //check for scene restart upon end of stream
                        if (odm->subscene) {
                                gf_scene_mpeg4_inline_check_restart(odm->subscene);
                        }
#endif
                } else {
                        nb_ck_running++;
                }
                if (nb_ck_running) return;
        } else {
                if (nb_eos != count) return;
        }


        gf_term_service_media_event(odm, GF_EVENT_MEDIA_LOAD_DONE);

        if (on_channel && on_channel->esd && on_channel->esd->decoderConfig) {
                if (odm->codec && (on_channel->esd->decoderConfig->streamType==odm->codec->type)) {
                        gf_codec_set_status(odm->codec, GF_ESM_CODEC_EOS);
                        return;
                }
                if (on_channel->esd->decoderConfig->streamType==GF_STREAM_OCR) {
                        gf_codec_set_status(odm->ocr_codec, GF_ESM_CODEC_EOS);
                        return;
                }
                if (on_channel->esd->decoderConfig->streamType==GF_STREAM_OCI) {
#ifndef GPAC_MINIMAL_ODF
                        gf_codec_set_status(odm->oci_codec, GF_ESM_CODEC_EOS);
#endif
                        return;
                }
        }
        if (!odm->subscene) return;

        if (odm->subscene->scene_codec) {
                gf_codec_set_status(odm->subscene->scene_codec, GF_ESM_CODEC_EOS);
        }

        if (odm->subscene->od_codec) {
                gf_codec_set_status(odm->subscene->od_codec, GF_ESM_CODEC_EOS);
        }
}

void gf_odm_set_duration(GF_ObjectManager *odm, GF_Channel *ch, u64 stream_duration)
{
        if (odm->codec) {
                if (ch->esd->decoderConfig->streamType == odm->codec->type)
                        if (odm->duration/1000 != stream_duration/1000)
                                odm->duration = stream_duration;
        } else if (odm->ocr_codec) {
                if (ch->esd->decoderConfig->streamType == odm->ocr_codec->type)
                        if (odm->duration/1000 != stream_duration/1000)
                                odm->duration = stream_duration;
        } else if (odm->subscene && odm->subscene->scene_codec) {
                //if (gf_list_find(odm->subscene->scene_codec->inChannels, ch) >= 0) {
                if (odm->duration/1000 != stream_duration/1000)
                        odm->duration = stream_duration;
                //}
        }

        /*update scene duration*/
        gf_scene_set_duration(odm->subscene ? odm->subscene : (odm->parentscene ? odm->parentscene : odm->term->root_scene));
}


void gf_odm_set_timeshift_depth(GF_ObjectManager *odm, GF_Channel *ch, u32 stream_timeshift)
{
        if (odm->codec) {
                if (ch->esd->decoderConfig->streamType == odm->codec->type)
                        if (odm->timeshift_depth != stream_timeshift)
                                odm->timeshift_depth = stream_timeshift;
        } else if (odm->ocr_codec) {
                if (ch->esd->decoderConfig->streamType == odm->ocr_codec->type)
                        if (odm->timeshift_depth != stream_timeshift)
                                odm->timeshift_depth = stream_timeshift;
        } else if (odm->subscene && odm->subscene->scene_codec) {
                //if (gf_list_find(odm->subscene->scene_codec->inChannels, ch) >= 0) {
                if (odm->timeshift_depth != stream_timeshift)
                        odm->timeshift_depth = stream_timeshift;
                //}
        }

        /*update scene duration*/
        gf_scene_set_timeshift_depth(odm->subscene ? odm->subscene : (odm->parentscene ? odm->parentscene : odm->term->root_scene));
}


GF_Clock *gf_odm_get_media_clock(GF_ObjectManager *odm)
{
        while (odm->lower_layer_odm) {
                odm = odm->lower_layer_odm;
        }
        if (odm->codec) return odm->codec->ck;
        if (odm->ocr_codec) return odm->ocr_codec->ck;
        if (odm->subscene && odm->subscene->scene_codec) return odm->subscene->scene_codec->ck;
        if (odm->subscene && odm->subscene->dyn_ck) return odm->subscene->dyn_ck;
        if (odm->parentscene && odm->parentscene->dyn_ck) return odm->parentscene->dyn_ck;
        return NULL;
}



Bool gf_odm_shares_clock(GF_ObjectManager *odm, GF_Clock *ck)
{
        u32 i = 0;
        GF_Channel *ch;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i))) {
                if (ch->clock == ck) return 1;
        }
        if (odm->subscene) {
                if (odm->subscene->is_dynamic_scene && odm->subscene->dyn_ck == ck) return 1;
                if (odm->subscene->scene_codec && odm->subscene->scene_codec->ck == ck) return 1;
        }
        return 0;
}



void gf_odm_pause(GF_ObjectManager *odm)
{
        u32 i;
        GF_NetworkCommand com;
#ifndef GPAC_DISABLE_VRML
        MediaSensorStack *media_sens;
#endif
        GF_Channel *ch;

        //postpone until the PLAY request
        if (odm->state != GF_ODM_STATE_PLAY) {
                odm->flags |= GF_ODM_PAUSE_QUEUED;
                return;
        }

        if (odm->flags & GF_ODM_PAUSED) return;
        odm->flags |= GF_ODM_PAUSED;

        //cleanup - we need to enter in stop state for broadcast modes
        if (odm->flags & GF_ODM_NO_TIME_CTRL) return;

        /*stop codecs, and update status for media codecs*/
        if (odm->codec) {
                //we don't pause codec but only change its status to PAUSE - this will allow decoding until CB is full, which will turn the codec in pause mode
                gf_codec_set_status(odm->codec, GF_ESM_CODEC_PAUSE);
        }
        //when pause_at_first_frame is set we still want to decode and process the first AUs in OD and scene channels, otherwise no scene and no frame to display ...
        else if (odm->subscene && (odm->subscene->first_frame_pause_type==0) ) {
                if (odm->subscene->scene_codec) {
                        gf_codec_set_status(odm->subscene->scene_codec, GF_ESM_CODEC_PAUSE);
                        gf_term_stop_codec(odm->subscene->scene_codec, 1);
                }
                if (odm->subscene->od_codec) {
                        gf_codec_set_status(odm->subscene->scene_codec, GF_ESM_CODEC_PAUSE);
                        gf_term_stop_codec(odm->subscene->od_codec, 1);
                }
        }
        if (odm->ocr_codec) gf_term_stop_codec(odm->ocr_codec, 1);
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) gf_term_stop_codec(odm->oci_codec, 1);
#endif

        com.command_type = GF_NET_CHAN_PAUSE;
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i))) {
                gf_clock_pause(ch->clock);
                GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d %s] CH%d: At OTB %u requesting PAUSE (clock init %d)\n", odm->OD->objectDescriptorID, odm->net_service->url, ch->esd->ESID, gf_clock_time(ch->clock), ch->clock->clock_init ));

                if (odm->state != GF_ODM_STATE_PLAY) continue;

                //if we are in dump mode, the clocks are paused (step-by-step render), but we don't send the pause commands to
                //the network !
                if (odm->term->root_scene->first_frame_pause_type!=2) {
                        com.base.on_channel = ch;
                        gf_term_service_command(ch->service, &com);
                }
        }

        //if we are in dump mode, only the clocks are paused (step-by-step render), the media object is still in play state
        if (odm->term->root_scene->first_frame_pause_type==2) {
                return;
        }

#ifndef GPAC_DISABLE_VRML
        /*mediaSensor  shall generate isActive false when paused*/
        i=0;
        while ((media_sens = (MediaSensorStack *)gf_list_enum(odm->ms_stack, &i)) ) {
                if (media_sens && media_sens->sensor->isActive) {
                        media_sens->sensor->isActive = 0;
                        gf_node_event_out((GF_Node *) media_sens->sensor, 4/*"isActive"*/);
                }
        }
#endif

}

void gf_odm_resume(GF_ObjectManager *odm)
{
        u32 i;
        GF_NetworkCommand com;
        GF_Channel *ch;
#ifndef GPAC_DISABLE_VRML
        MediaSensorStack *media_sens;
        MediaControlStack *ctrl;
#endif

        if (odm->flags & GF_ODM_PAUSE_QUEUED) {
                odm->flags &= ~GF_ODM_PAUSE_QUEUED;
                return;
        }

        if (!(odm->flags & GF_ODM_PAUSED)) return;
        odm->flags &= ~GF_ODM_PAUSED;

        if (odm->flags & GF_ODM_NO_TIME_CTRL) return;

        /*start codecs, and update status for media codecs*/
        if (odm->codec) {
                gf_term_start_codec(odm->codec, 1);
                gf_codec_set_status(odm->codec, GF_ESM_CODEC_PLAY);
        } else if (odm->subscene) {
                if (odm->subscene->scene_codec) {
                        gf_codec_set_status(odm->subscene->scene_codec, GF_ESM_CODEC_PLAY);
                        gf_term_start_codec(odm->subscene->scene_codec, 1);
                }
                if (odm->subscene->od_codec) gf_term_start_codec(odm->subscene->od_codec, 1);
        }
        if (odm->ocr_codec) gf_term_start_codec(odm->ocr_codec, 1);
#ifndef GPAC_MINIMAL_ODF
        if (odm->oci_codec) gf_term_start_codec(odm->oci_codec, 1);
#endif

#ifndef GPAC_DISABLE_VRML
        ctrl = gf_odm_get_mediacontrol(odm);
#endif
        com.command_type = GF_NET_CHAN_RESUME;
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                gf_clock_resume(ch->clock);

                GF_LOG(GF_LOG_INFO, GF_LOG_MEDIA, ("[ODM%d %s] CH%d: At OTB %u requesting RESUME (clock init %d)\n", odm->OD->objectDescriptorID, odm->net_service->url, ch->esd->ESID, gf_clock_time(ch->clock), ch->clock->clock_init ));
                if (odm->state!= GF_ODM_STATE_PLAY) continue;

                com.base.on_channel = ch;
                gf_term_service_command(ch->service, &com);

#ifndef GPAC_DISABLE_VRML
                /*override speed with MC*/
                if (ctrl) {
                        gf_clock_set_speed(ch->clock, ctrl->control->mediaSpeed);
                }
#endif
        }

#ifndef GPAC_DISABLE_VRML
        /*mediaSensor shall generate isActive TRUE when resumed*/
        i=0;
        while ((media_sens = (MediaSensorStack *)gf_list_enum(odm->ms_stack, &i)) ) {
                if (media_sens && !media_sens->sensor->isActive) {
                        media_sens->sensor->isActive = 1;
                        gf_node_event_out((GF_Node *) media_sens->sensor, 4/*"isActive"*/);
                }
        }
#endif
}

void gf_odm_set_speed(GF_ObjectManager *odm, Fixed speed, Bool adjust_clock_speed)
{
        u32 i;
        GF_NetworkCommand com;
        GF_Channel *ch;

        if (odm->flags & GF_ODM_NO_TIME_CTRL) return;

        com.command_type = GF_NET_CHAN_SET_SPEED;
        com.play.speed = FIX2FLT(speed);
        i=0;
        while ((ch = (GF_Channel*)gf_list_enum(odm->channels, &i)) ) {
                if (adjust_clock_speed)
                        gf_clock_set_speed(ch->clock, speed);

                com.play.on_channel = ch;
                gf_term_service_command(ch->service, &com);
        }
}

GF_Segment *gf_odm_find_segment(GF_ObjectManager *odm, char *descName)
{
        GF_Segment *desc;
        u32 i = 0;
        if (!odm->OD) return NULL;
        while ( (desc = (GF_Segment *)gf_list_enum(odm->OD->OCIDescriptors, &i)) ) {
                if (desc->tag != GF_ODF_SEGMENT_TAG) continue;
                if (!stricmp(desc->SegmentName, descName)) return desc;
        }
        return NULL;
}

static void gf_odm_insert_segment(GF_ObjectManager *odm, GF_Segment *seg, GF_List *list)
{
        /*this reorders segments when inserting into list - I believe this is not compliant*/
#if 0
        GF_Segment *desc;
        u32 i = 0;
        while ((desc = gf_list_enum(list, &i))) {
                if (desc == seg) return;
                if (seg->startTime + seg->Duration <= desc->startTime) {
                        gf_list_insert(list, seg, i);
                        return;
                }
        }
#endif
        gf_list_add(list, seg);
}

/*add segment descriptor and sort them*/
void gf_odm_init_segments(GF_ObjectManager *odm, GF_List *list, MFURL *url)
{
        char *str, *sep;
        char seg1[1024], seg2[1024], seg_url[4096];
        GF_Segment *first_seg, *last_seg, *seg;
        u32 i, j;

        /*browse all URLs*/
        for (i=0; i<url->count; i++) {
                if (!url->vals[i].url) continue;
                str = strstr(url->vals[i].url, "#");
                if (!str) continue;
                str++;
                strcpy(seg_url, str);
                /*segment closed range*/
                if ((sep = strstr(seg_url, "-")) ) {
                        strcpy(seg2, sep+1);
                        sep[0] = 0;
                        strcpy(seg1, seg_url);
                        first_seg = gf_odm_find_segment(odm, seg1);
                        if (!first_seg) continue;
                        last_seg = gf_odm_find_segment(odm, seg2);
                }
                /*segment open range*/
                else if ((sep = strstr(seg_url, "+")) ) {
                        sep[0] = 0;
                        strcpy(seg1, seg_url);
                        first_seg = gf_odm_find_segment(odm, seg_url);
                        if (!first_seg) continue;
                        last_seg = NULL;
                }
                /*single segment*/
                else {
                        first_seg = gf_odm_find_segment(odm, seg_url);
                        if (!first_seg) continue;
                        gf_odm_insert_segment(odm, first_seg, list);
                        continue;
                }
                /*segment range process*/
                gf_odm_insert_segment(odm, first_seg, list);
                j=0;
                while ( (seg = (GF_Segment *)gf_list_enum(odm->OD->OCIDescriptors, &j)) ) {
                        if (seg->tag != GF_ODF_SEGMENT_TAG) continue;
                        if (seg==first_seg) continue;
                        if (seg->startTime + seg->Duration <= first_seg->startTime) continue;
                        /*this also includes last_seg insertion !!*/
                        if (last_seg && (seg->startTime + seg->Duration > last_seg->startTime + last_seg->Duration) ) continue;
                        gf_odm_insert_segment(odm, seg, list);
                }
        }
}

void gf_odm_signal_eos(GF_ObjectManager *odm)
{
        if (odm->parentscene && (odm->parentscene != odm->term->root_scene) ) {
                GF_ObjectManager *root = odm->parentscene->root_od;
                Bool is_over = 0;

                if (!gf_scene_check_clocks(root->net_service, root->subscene, 0)) return;
                if (root->subscene->is_dynamic_scene)
                        is_over = 1;
                else
                        is_over = gf_sc_is_over(odm->term->compositor, root->subscene->graph);

                if (is_over) {
                        gf_term_service_media_event(root, GF_EVENT_MEDIA_ENDED);
                }
        } else {
                if (gf_term_check_end_of_scene(odm->term, 0)) {
                        GF_Event evt;
                        evt.type = GF_EVENT_EOS;
                        gf_term_send_event(odm->term, &evt);
                }
        }
}


/* [<][>][^][v][top][bottom][index][help] */