OpenSpace/modules/autonavigation/autonavigationmodule.cpp

/*****************************************************************************************
 *                                                                                       *
 * OpenSpace                                                                             *
 *                                                                                       *
 * Copyright (c) 2014-2019                                                               *
 *                                                                                       *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of this  *
 * software and associated documentation files (the "Software"), to deal in the Software *
 * without restriction, including without limitation the rights to use, copy, modify,    *
 * merge, publish, distribute, sublicense, and/or sell copies of the Software, and to    *
 * permit persons to whom the Software is furnished to do so, subject to the following   *
 * conditions:                                                                           *
 *                                                                                       *
 * The above copyright notice and this permission notice shall be included in all copies *
 * or substantial portions of the Software.                                              *
 *                                                                                       *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,   *
 * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A         *
 * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT    *
 * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF  *
 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE  *
 * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.                                         *
 ****************************************************************************************/

#include <modules/autonavigation/autonavigationmodule.h>

#include <modules/autonavigation/autonavigationmodule_lua.inl>
#include <openspace/engine/globals.h>
#include <openspace/engine/globalscallbacks.h>
#include <openspace/engine/windowdelegate.h>
#include <ghoul/logging/logmanager.h>

namespace {
    constexpr const char* _loggerCat = "AutoNavigationModule";

    constexpr const openspace::properties::Property::PropertyInfo MinBoundingSphereInfo = {
        "MinimalValidBoundingSphere",
        "Minimal Valid Bounding Sphere",
        "The minimal allowed value for a bounding sphere. Used for computation of target "
        "positions and path generation, to avoid issues when there is no bounding sphere."
    };
} // namespace

namespace openspace {

AutoNavigationModule::AutoNavigationModule()
    : OpenSpaceModule(Name),
    _minValidBoundingSphere(MinBoundingSphereInfo, 10.0, 1.0, 3e10)
{
    addPropertySubOwner(_autoNavigationHandler);

    addProperty(_minValidBoundingSphere);
}

autonavigation::AutoNavigationHandler& AutoNavigationModule::AutoNavigationHandler() {
    return _autoNavigationHandler;
}

double AutoNavigationModule::minValidBoundingSphere() const {
    return _minValidBoundingSphere;
}

std::vector<documentation::Documentation> AutoNavigationModule::documentations() const {
    return {
        // TODO: call documentation methods for the other classes in this module
    };
}

scripting::LuaLibrary AutoNavigationModule::luaLibrary() const {
    scripting::LuaLibrary res;
    res.name = "autonavigation";
    res.scripts = {
        absPath("${MODULE_AUTONAVIGATION}/scripts/rendering.lua")
    };
    res.functions = {
        {
            "continuePath",
            &autonavigation::luascriptfunctions::continuePath,
            {},
            "",
            "Continue playing a paused camera path."
        },
        {
            "stopPath",
            &autonavigation::luascriptfunctions::stopPath,
            {},
            "",
            "Stops a path, if one is being played."
        },
        {
            "goTo",
            &autonavigation::luascriptfunctions::goTo,
            {},
            "string, [double]",
            "TODO: Description. Go to the node with the given name with optional duration."
        },
        {
            "generatePath",
            &autonavigation::luascriptfunctions::generatePath,
            {},
            "table",
            "Generate the path as described by the lua table input argument. TODO: Describe how a path instruction is defined?. "
        },
        {
            "generatePathFromFile",
            &autonavigation::luascriptfunctions::generatePathFromFile,
            {},
            "string",
            "Read an input file with lua instructions and use those to generate a camera path. TODO: Describe how a path instruction is defined?. "
        },
        {
            "getPathPositions",
            &autonavigation::luascriptfunctions::getPathPositions,
            {},
            "number",
            "FOR DEBUG. Sample positions along the path. The input argument is the number of samples per path segment. "
        },
        {
            "getPathOrientations",
            &autonavigation::luascriptfunctions::getPathOrientations,
            {},
            "number",
            "FOR DEBUG. Sample orientations along the path. The input argument is the number of samples per path segment. "
        },
         {
            "getPathViewDirections",
            &autonavigation::luascriptfunctions::getPathViewDirections,
            {},
            "number",
            "FOR DEBUG. Sample view directions along the path. The input argument is the number of samples per path segment. "
        },
        {
            "getControlPoints",
            &autonavigation::luascriptfunctions::getControlPoints,
            {},
            "",
            "FOR DEBUG. Get control point positions from all pathsegments"
        }
    };
    return res;
}

void AutoNavigationModule::internalInitialize(const ghoul::Dictionary&) {
    global::callback::preSync.emplace_back([this]() {
        _autoNavigationHandler.updateCamera(global::windowDelegate.deltaTime());
    });
}

} // namespace openspace