"use strict";

/*
------------------------------------------------------------
BEGIN FUNCTIONS FOR ENABLING THE SITE TO BE RUN IN TEST MODE
------------------------------------------------------------
*/
//2023-09-22:
//setting up a global variable to designate when an
//overall test mode needs to be used. 
//https://chromosphere.com/chromosphere/documentation?76543234567876
function set_test_mode_on() {
    //202-09-22:
    //Set a global variable that stores a boolean value
    //indicating that "global test mode" is on, or off.
    //Test mode is a blanket feature that allows the web app
    //to be tested, debugged, & analyzed, and also allow it to be
    //in "published" mode where the end-user doesn't see what
    //is going on under the hood. 
    global_test_mode = true;
}



//2023-09-22:
//setting up a global variable to designate when an
//overall test mode needs to be used. 
function set_test_mode_off() {
    //202-09-22:
    //Set a global variable that stores a boolean value
    //indicating that "global test mode" is on, or off.
    //Test mode is a blanket feature that allows the web app
    //to be tested, debugged, & analyzed, and also allow it to be
    //in "published" mode where the end-user doesn't see what
    //is going on under the hood. 
    global_test_mode = false;
}


//2023-09-22:
//This is a test mode that includes all testing features
//to be running, not just some.
function full_test_mode_on() {
    //turn on the global test mode, first.  
    set_test_mode_on();

    //I set up a testing mode to work with the UI content blocking layer.
    //when mode is set to true, the normally transparent blocking layer
    //images are opaque white. Otherwise, they're invisible.
    global_ui_interaction_window_content_block_test_mode = true;

    //when resizing, or moving web-windows, a UI blocking layer
    //fills the window and blocks unintended interaction. This allows
    //for smooth movement and resizing of web windows. Otherwise, the mouse
    //interacts with the web-window content, and the otherwise smooth movements
    //jerk all over. To test it, I have to be able to see it in action.
    //When test mode is set to true, the behavior of the blocking
    //layer can be observed. Otherwise, it's entirely transparent
    global_ui_interaction_screen_content_block_test_mode = true;

    //2023-11-15:
    //when this global variable is set to true, display the progress bar's
    //background container (parent node) to visible.
    global_progress_bar_background_test_mode = true;
}




//2023-09-22:
//This is a test mode that includes all testing features
//to be running, not just some.
//This function turns it off so the end user isn't inundated
//with all of the testing tools. 
function full_test_mode_off() {
    //turn off the global test mode, first.  
    set_test_mode_off();

    //I set up a testing mode to work with the UI content blocking layer.
    //when mode is set to true, the normally transparent blocking layer
    //images are opaque white. Otherwise, they're invisible.
    global_ui_interaction_window_content_block_test_mode = false;

    //when resizing, or moving web-windows, a UI blocking layer
    //fills the window and blocks unintended interaction. This allows
    //for smooth movement and resizing of web windows. Otherwise, the mouse
    //interacts with the web-window content, and the otherwise smooth movements
    //jerk all over. To test it, I have to be able to see it in action.
    //When test mode is set to true, the behavior of the blocking
    //layer can be observed. Otherwise, it's entirely transparent
    global_ui_interaction_screen_content_block_test_mode = false;

    //2023-11-15:
    //when this global variable is set to true, display the progress bar's
    //background container (parent node) to visible.
    global_progress_bar_background_test_mode = false;
}
/*
------------------------------------------------------------
END FUNCTIONS FOR ENABLING THE SITE TO BE RUN IN TEST MODE.
------------------------------------------------------------
*/

//2024-03-21:
//this function places a small blue box onto the page
//for testing purposes. It's used to test the functions
//that measure the page's Y offset determined by components
//that are placed at the top of the page. Items such as the top
//menu bar, and the tabbed windows bar span the top of the page
//and their top + height measurements must be taken into account.

function offset_Y_test_marker_image(total_offset) {
    var marker_img = null;

    marker_img = document.getElementById("test_marker_image");
    if (marker_img !== null) {
        marker_img.parentNode.removeChild(marker_img);
    }

    marker_img = new Image();
    marker_img.setAttribute("id", "test_marker_image");
    marker_img.setAttribute("title", "This blue image indicates the Y offset at the top of the page");

    //the code below enables the blue box to show a helper caption
    //when the mouse cursor hovers over it. See file 'helper_captions.js'.
    //marker_img.setAttribute("data-title", "Blue Box Showing Y Offset");
    //marker_img.setAttribute("data-desc", "this box is used in testing mode, and its placement indicates the page's top offset.");
    //marker_img.addEventListener("mouseenter", set_caption(marker_img));


    document.body.appendChild(marker_img);
    marker_img.style.position = "absolute";
    marker_img.style.left = "330px";
    marker_img.style.top = total_offset + "px";
    marker_img.style.width = "25px";
    marker_img.style.height = "25px";
    marker_img.style.zIndex = get_top_DOM_z_index() + 1.0;
    marker_img.style.backgroundColor = "rgba(0,0,255,0.5)";
    marker_img.style.border = "1px solid rgba(255,255,255,1.0)";
    marker_img.src = "/chromosphere/images/blank.gif";
}