source: tmcsimulator/trunk/webapps/einotebook/scripts/Events.js @ 415

/**
 * Stores the each Event. Maintains each Event sorted ascending by time. 
 * 
 * You must set
 *   1) events.doc to the document that events will be displayed
 *   2) events.win to the window on which the document resides that will display the events
 * before the 'html' method of Event, Evaluations, Evaluation, Properties, or Property 
 * has been called.
 */
var events = new Array();

//========== public members ==========//
events.doc = null;
events.win = null;

//========== public methods ==========//
events.get = events_get;
events.getProperties = events_getProperties;
events.getEvaluations = events_getEvaluations;
events.getEvaluation = events_getEvaluation;
events.collapseAllEvents = events_collapseAllEvents;
events.collapseAllProperties = events_collapseAllProperties;
events.collapseAllEvaluations = events_collapseAllEvaluations;
events.expandAllEvents = events_expandAllEvents;
events.expandAllProperties = events_expandAllProperties;
events.expandAllEvaluations = events_expandAllEvaluations;
events.expandAll = events_expandAll;
events.collapseAll = events_collapseAll;
events.add = events_add;
events.getAllProperties = events_getAllProperties;
events.getAllEvaluations = events_getAllEvaluations;
events.getLastExecutedEvent = events_getLastExecutedEvent;

//========== method definitions ==========//

/**
 * Searches through each Event to find an Event with the given id.
 * @param id {Integer} The id of an Event.
 * @return The Event with the given id.
 */
function events_get(id)
{
    var event;

    // FOR each Event 
    for (var i = 0; i < this.length; i++)
    {
        // IF the Event's id matches THEN
        if (this[i].id == id)
        {
                // remember the Event
            event = this[i];
        }
    }
    
    return event;
}

/**
 * Searches through the Properties of each event to find the Property with the given id.
 * @param id {Integer} The id of a Property.
 * @return The Property with the given id.
 */
function events_getProperties(id)
{
    var property;
    
    // FOR each Event
    for (var i = 0; i < this.length; i++)
    {
        // IF the Event's id matches THEN
        if (this[i].properties.id == id)
        {
                // remember the Property
            property = this[i].properties;
        }
    }
    
    return property;
}

/**
 * Searches through each Evaluations of each event to find the Evaluations with the given id.
 * @param id {Integer} The id of an Evaluations.
 * @return The Evaluations with the given id.
 */
function events_getEvaluations(id)
{
    var evaluations;

    // FOR each Event
    for (var i = 0; i < this.length; i++)
    {
        // IF this Evalutions's id matches THEN
        if (this[i].evaluations.id == id)
        {
                // remember the Evaluations
            evaluations = this[i].evaluations;  
        }
    }
    
    return evaluations;
}

/**
 * Searches through each Evaluation of each Evaluations of each Event to find the
 * Evaluation of with the given id.
 * @param id {Integer} The id of an Evaluation.
 * @return The Evaluation of with the given id.
 */
function events_getEvaluation(id)
{
    var evaluation;

    // FOR each Event
    for (var i = 0; i < this.length; i++)
    {
        // FOR each Evaluation
        for (var j = 0; j < this[i].evaluations.evaluations.length; j++)
        {
                // IF the Evaluation's id matches THEN
            if (this[i].evaluations.evaluations[j].id == id)
            {
                // remember the Evaluation
                evaluation = this[i].evaluations.evaluations[j];
            }
        }
    }
    
    return evaluation;  
}

/**
 * Collapses each Event.
 */
function events_collapseAllEvents()
{
        // FOR each Event
        for (var i = 0; i < this.length; i++)
        {
                // IF the Event is expanded THEN
                if (this[i].expanded)
                {
                        // collapse Event
                        this[i].expandAction();
                }
        }
}

/**
 * Expands each event.
 */
function events_expandAllEvents()
{
        // FOR each Event
        for (var i = 0; i < this.length; i++)
        {
                // IF the Event is collapsed
                if (!this[i].expanded)
                {
                        // expand Event
                        this[i].expandAction();
                }
        }
}

function events_collapseAllProperties()
{
        var list = this.getAllProperties();
        
        // FOR each Properties
        for (var i = 0; i < list.length; i++)
        {
                // IF the Properties is expanded THEN
                if (list[i].expanded)
                {
                        // collapse the Properties
                        list[i].expandAction();
                }
        }
}

function events_collapseAllEvaluations()
{
        var list = this.getAllEvaluations();
        
        // FOR each Evaluations
        for (var i = 0; i < list.length; i++)
        {
                // IF the Evaluations is expanded THEN
                if (list[i].expanded)
                {
                        // collapse the Evaluations
                        list[i].expandAction();
                }
        }       
}

function events_expandAllProperties()
{
        var list = this.getAllProperties();
        
        // FOR each Properties
        for (var i = 0; i < list.length; i++)
        {
                // IF the Properties is collapsed THEN
                if (!list[i].expanded)
                {
                        // expand the Properties
                        list[i].expandAction();
                }
        }
}

function events_expandAllEvaluations()
{
        var list = this.getAllEvaluations();
        
        // FOR each Evaluations
        for (var i = 0; i < list.length; i++)
        {
                // IF the Evaluations is collapsed THEN
                if (!list[i].expanded)
                {
                        // expand the Evaluations
                        list[i].expandAction();
                }
        }       
}

/**
 * Adds an Event.
 * @param event {Event} The Event to add.
 */
function events_add(event)
{
        // add event
        events.push(event);
        
        // sort events in ascending order by time
        events.sort(function (e1, e2) {
                return e1.time.getSeconds() - e2.time.getSeconds();
        });
}

/**
 * Finds all of the Properties in each Event.
 * @return The list of the Properties in each Event.
 */
function events_getAllProperties()
{
        var list = new Array();
        
        // FOR each event
        for (var i = 0; i < this.length; i++)
        {
                // add properties to list
                list.push(this[i].properties);
        }
        
        return list;
}

/**
 * Finds all of the Evaluations in each Event.
 * @return The list of the Evaluations in each Event.
 */
function events_getAllEvaluations()
{
        var list = new Array();
        
        // FOR each event
        for (var i = 0; i < this.length; i++)
        {
                // add evaluations to list
                list.push(this[i].evaluations);
        }
        
        return list;
}

/**
 * Collapses each Event, Properties, and Evaluations.
 */
function events_collapseAll()
{
        events.collapseAllProperties(); 
        events.collapseAllEvaluations(); 
        events.collapseAllEvents();     
}

/**
 * Expands each Event, Properties, and Evaluations.
 * @return
 */
function events_expandAll()
{
        events.expandAllProperties(); 
        events.expandAllEvaluations(); 
        events.expandAllEvents();       
}

/**
 * Finds the Event that was last executed by based on given time.
 * @param time The time in seconds.
 * @return The array of last execute event if at least one event has executed; otherwise, null.
 */
function events_getLastExecutedEvent(time)
{
        // var event = null;
        var event_arr = [];
        if (this.length == 0)
    {
        console.log("Error: event list is empty in getLastExecutedEvent");
        return;
    }
        // IF there is only one event and it has been executed THEN
        if (this.length == 1 && this[0].time.getSeconds() <= time)
        {
                event.push(this[0]);
        }
        else
        {
                //NOTE: remember that the events are maintained in ascending order by time
                
                // FOR each Event 
                for (var i = 0; i < this.length - 1; i++)
                {
                        // IF the Event has executed and no subsequent event has executed THEN
                        if (this[i].time.getSeconds() <= time &&
                            this[i + 1].time.getSeconds() > time)
                        {
                                event_arr.push(this[i]);
                                /* traverse backward to check if there is an event happen at the same time 
                                with the current event */
                                var k = i - 1;
                                while ( k>=0 && (this[k].time.getSeconds() == this[i].time.getSeconds())) {
                                        event_arr.push(this[k]);
                                        k--;
                                }
                        }
                }
                
                // IF the last event has executed THEN
                if (this[this.length - 1].time.getSeconds() <= time)
                {
                        event_arr.push(this[this.length - 1]);
                }       
        }
        
        // return an array of event 
        return event_arr;
}