func.js

// Yi-Chia Chen

function GET_PARAMETERS(var_name, default_value) {
    const REGEX_STRING = "[\?&]" + var_name + "=([^&#]*)";
    const REGEX = new RegExp(REGEX_STRING);
    const URL = location.href;
    const RESULTS = REGEX.exec(URL);
    if (RESULTS == null) {
        return default_value;
    } else {
        return RESULTS[1];
    }
}

function LIST_TO_FORMATTED_STRING(data_list, divider) {
    divider = (divider === undefined) ? '\t' : divider;
    var string = '';
    for (var i = 0; i < data_list.length - 1; i++) {
        string += data_list[i] + divider;
    }
    string += data_list[data_list.length - 1] + '\n';
    return string;
}

function FACTORIAL_COND(factor_list) {

    function RECURSIVE_COMBINE(now_factor, remain_factor_list) {
        all_conditions = REPEAT_ELEMENTS_IN_ARRAY(all_conditions, now_factor.length);
        for (var i = 0; i < all_conditions.length; i += now_factor.length) {
            for (var j = 0; j < now_factor.length; j++) {
                var index = i + j;
                all_conditions[index].push(now_factor[j]);
            }
        }

        if (remain_factor_list.length !== 0) {
            now_factor = remain_factor_list.shift();
            RECURSIVE_COMBINE(now_factor, remain_factor_list);
        }
    }

    var now_factor = factor_list.shift();
    var all_conditions = [];
    for (var i = 0; i < now_factor.length; i++) {
        all_conditions.push([now_factor[i]])
    }

    now_factor = factor_list.shift();
    RECURSIVE_COMBINE(now_factor, factor_list);

    return all_conditions;
}

function POST_DATA(page, data, success_func, error_callback) {
    data = (data === undefined) ? null : data;
    success_func = (success_func === undefined) ? function() { return; } : success_func;
    error_callback = (error_callback === undefined) ? function() { return; } : error_callback;
    $.ajax({
        type: "POST",
        url: page,
        data: data,
        success: success_func,
        error: error_callback
    });
}

function SHUFFLE_ARRAY(array) {
    var j, temp;
    for (var i = array.length - 1; i > 0; i--) {
        j = Math.floor(Math.random() * (i + 1));
        temp = array[i];
        array[i] = array[j];
        array[j] = temp;
    }
    return array;
}

function SAMPLE_WO_REPLACEMENT(list, sample_n) {
    sample_n = (sample_n === undefined) ? 1 : sample_n;
    var sample = [];
    var local_list = list.slice(0);
    for (var i = 0; i < sample_n; i++) {
        var random_index = Math.floor(Math.random() * local_list.length);
        sample.push(local_list.splice(random_index, 1)[0]);
    }
    return {
        sample: sample,
        remainder: local_list
    };
}

function SAMPLE_W_REPLACEMENT(list, sample_n) {
    sample_n = (sample_n === undefined) ? 1 : sample_n;
    var sample = [];
    var local_list = list.slice(0);
    for (var i = 0; i < sample_n; i++) {
        var random_index = Math.floor(Math.random() * local_list.length);
        sample.push(local_list[random_index]);
    }
    return sample;
}

function RAND_CHOICE(list) {
    return list[Math.floor(Math.random() * list.length)];
}

function RANGE(start_num, end_num, interval) {
    start_num = (start_num === undefined) ? 0 : start_num;
    interval = (interval === undefined) ? 1 : interval;
    var list = [];
    for (var i = start_num; i < end_num; i += interval) {
        list.push(i);
    }
    return list;
}

function FORMAT_DATE(date_obj, time_zone, divider, padded) {
    date_obj = (date_obj === undefined) ? new Date() : date_obj;
    time_zone = (time_zone === undefined) ? 'UTC' : time_zone;
    divider = (divider === undefined) ? '.' : divider;
    padded = (padded === undefined) ? true : padded;
    const NOW_YEAR = (time_zone == 'UTC') ? date_obj.getUTCFullYear() : date_obj.getFullYear();
    var now_month = (time_zone == 'UTC') ? date_obj.getUTCMonth()+1 : date_obj.getMonth()+1;
    var now_date = (time_zone == 'UTC') ? date_obj.getUTCDate() : date_obj.getDate();
    if (padded) {
        now_month = ('0' + now_month).slice(-2);
        now_date = ('0' + now_date).slice(-2);
    }
    var now_full_date = NOW_YEAR + divider + now_month + divider + now_date;
    return now_full_date;
}

function FORMAT_TIME(date_obj, time_zone, divider, padded) {
    date_obj = (date_obj === undefined) ? new Date() : date_obj;
    time_zone = (time_zone === undefined) ? 'UTC' : time_zone;
    divider = (divider === undefined) ? ':' : divider;
    padded = (padded === undefined) ? true : padded;
    var now_hours = (time_zone == 'UTC') ? date_obj.getUTCHours() : date_obj.getHours();
    var now_minutes = (time_zone == 'UTC') ? date_obj.getUTCMinutes() : date_obj.getMinutes();
    var now_seconds = (time_zone == 'UTC') ? date_obj.getUTCSeconds() : date_obj.getSeconds();
    if (padded) {
        now_hours = ('0' + now_hours).slice(-2);
        now_minutes = ('0' + now_minutes).slice(-2);
        now_seconds = ('0' + now_seconds).slice(-2);
    }
    var now_full_time = now_hours + divider + now_minutes + divider + now_seconds;
    return now_full_time;
}

function LOAD_IMG(index, stim_path, img_list, after_func) {
    after_func = (after_func === undefined) ? function() { return; } : after_func;
    if (index >= img_list.length) {
        return;
    }
    var image = new Image();
    if (index < img_list.length - 1) {
        image.onload = function() {
            LOAD_IMG(index + 1, stim_path, img_list, after_func);
        };
    } else {
        image.onload = after_func;
    }
    image.src = stim_path + img_list[index];
}

function LOAD_SOUNDS(index, stim_path, sound_list, after_func) {
    if (index >= sound_list.length) {
        return;
    }
    var sound = new Audio();

    sound.src = stim_path + sound_list[index];

    function CHECK_STATE() {
        if (sound.readyState == 4) {
            clearInterval(check_loading);
            if (index < sound_list.length - 1) {
                LOAD_SOUNDS(index + 1, stim_path, sound_list, after_func);
            } else {
                after_func();
            }
        } else {
            var current_time = Date.now();
            var current_duration = (current_time - start_time) / 1000; // in second
            if (current_duration > 2) {
                clearInterval(check_loading);
                if (reload_num > 3) { // giving up
                    if (index < sound_list.length - 1) {
                        LOAD_SOUNDS(index + 1, stim_path, sound_list, after_func);
                    } else {
                        after_func();
                    }
                } else { // try reloading again
                    reload_num++;
                    sound.load();
                    check_loading = window.setInterval(CHECK_STATE, 20); // update progress every intervalD ms
                }
            }
        }
    }

    var start_time = Date.now();
    var reload_num = 0;
    var check_loading = window.setInterval(CHECK_STATE, 20); // update progress every intervalD ms
}

function BUFFER_VIDEO(buffer_element, filename, error_func, after_func) {
    error_func = (error_func === undefined) ? function() { return; } : error_func;
    after_func = (after_func === undefined) ? function() { return; } : after_func;
    var req = new XMLHttpRequest();
    req.open('GET', filename, true);
    req.responseType = 'blob';
    req.onload = function() {
        if (this.status === 200) {
            var video_blob = this.response;
            var video = URL.createObjectURL(video_blob);
            buffer_element.src = video;
        }
    };
    req.onerror = error_func;
    req.send();
}

function TO_RADIANS(degrees) {
    return degrees * Math.PI / 180;
}

function POLAR_TO_CARTESIAN(r, theta) {
    return [r * Math.cos(TO_RADIANS(theta)), r * Math.sin(TO_RADIANS(theta))];
}

function REPEAT_ELEMENTS_IN_ARRAY(arr, repeat_n) {
    var new_arr = [];
    for (var i = 0; i < arr.length; i++) {
        for (var j = 0; j < repeat_n; j++) {
            new_arr.push(Array.from(arr[i]));
        }
    }
    return new_arr;
}

function LIST_FROM_ATTRIBUTE_NAMES(obj, string_list) {
    var list = []
    for (var i = 0; i < string_list.length; i++) {
        list.push(obj[string_list[i]]);
    }
    return list;
}

function CHECK_IF_RESPONDED(open_ended_list, choice_list) {
    var all_responded = true;
    for (var i in open_ended_list) {
        all_responded = all_responded && (open_ended_list[i].replace(/(?:\r\n|\r|\n|\s)/g, '') != '');
    }
    for (var j in choice_list) {
        all_responded = all_responded && (typeof choice_list[j] !== 'undefined');
    }
    return all_responded;
}

function DISTANCE_BETWEEN_POINTS(point_a, point_b){
    var x_a = point_a[0];
    var y_a = point_a[1];
    var x_b = point_b[0];
    var y_b = point_b[1];
    return Math.sqrt(Math.pow(x_a-x_b,2)+Math.pow(y_a-y_b,2));
}

function CHECK_FULLY_IN_VIEW(el) {
    el = el.get(0);
    var rect = el.getBoundingClientRect();
    var top = rect.top;
    var bottom = rect.bottom;
    var left = rect.left;
    var right = rect.right;

    var w = $(window).width();
    var h = $(window).height();
    var is_visible = (top >= 0) && (bottom <= h) && (left >= 0) && (right <= w);
    return is_visible;
}

function CAPITALIZE(s) {
    if (typeof s !== 'string'){
        return '';
    } else {
        return s.charAt(0).toUpperCase() + s.slice(1);
    }
}

function CREATE_RANDOM_REPEAT_BEGINNING_LIST(stim_list, repeat_trial_n) {
    const REPEAT_LIST = SHUFFLE_ARRAY(stim_list.slice()).splice(0, repeat_trial_n);
    return REPEAT_LIST.concat(stim_list);
}