1166 lines
48 KiB
JavaScript
1166 lines
48 KiB
JavaScript
function newTutorialSpace() {
|
|
const MODULE_NAME = 'Tutorial Space'
|
|
let thisObject = {
|
|
stop: stop,
|
|
skip: skip,
|
|
previous: previous,
|
|
next: next,
|
|
playTutorial: playTutorial,
|
|
resumeTutorial: resumeTutorial,
|
|
playTutorialTopic: playTutorialTopic,
|
|
resumeTutorialTopic: resumeTutorialTopic,
|
|
playTutorialStep: playTutorialStep,
|
|
resumeTutorialStep: resumeTutorialStep,
|
|
resetTutorialProgress: resetTutorialProgress,
|
|
container: undefined,
|
|
physics: physics,
|
|
draw: draw,
|
|
getContainer: getContainer,
|
|
initialize: initialize,
|
|
finalize: finalize
|
|
}
|
|
|
|
let isInitialized = false
|
|
|
|
thisObject.container = newContainer()
|
|
thisObject.container.name = MODULE_NAME
|
|
thisObject.container.initialize()
|
|
thisObject.container.isClickeable = true
|
|
thisObject.container.isDraggeable = false
|
|
thisObject.container.detectMouseOver = true
|
|
thisObject.container.status = 'hidden'
|
|
|
|
resize()
|
|
|
|
let browserResizedEventSubscriptionId
|
|
|
|
let tutorialRootNode
|
|
let currentNode
|
|
let currentStatus = 'Stopped'
|
|
let navigationStack
|
|
|
|
let tutorialDiv = document.getElementById('tutorialDiv')
|
|
let tutorialFormDiv = document.getElementById('tutorialFormDiv')
|
|
let htmlGif = document.createElement("IMG")
|
|
let currentGifName = 'Never Set'
|
|
let newGifName = 'Never Set'
|
|
let htmlImage = document.createElement("IMG")
|
|
let currentImageName = 'Never Set'
|
|
let newImageName = 'Never Set'
|
|
let currentConfig
|
|
let newConfig
|
|
let currentDocumentationURL
|
|
let resumeModeActivated // In this mode, we skip all the node which status is 'Done'
|
|
let lastExecutedAction = ''
|
|
let actionCounter = 0
|
|
let forcingFocus = false
|
|
let currentZoomStep = 0
|
|
let viewportCentered = false
|
|
let repositionAtTimeMachineCounter = 0
|
|
let positionAtNodeCounter = 0
|
|
let timeMachineKeyPressedCounter = 0
|
|
let keyPressedCounter = 0
|
|
let sliderPositioned = 0
|
|
let changeNodeConfigCounter = 0
|
|
let documentationCounter = 0
|
|
let batchConfigChangesCounter = 0
|
|
|
|
return thisObject
|
|
|
|
function initialize() {
|
|
browserResizedEventSubscriptionId = canvas.eventHandler.listenToEvent('Browser Resized', resize)
|
|
isInitialized = true
|
|
}
|
|
|
|
function finalize() {
|
|
canvas.eventHandler.stopListening(browserResizedEventSubscriptionId)
|
|
|
|
tutorialRootNode = undefined
|
|
currentNode = undefined
|
|
navigationStack = undefined
|
|
|
|
tutorialDiv = undefined
|
|
tutorialFormDiv = undefined
|
|
image = undefined
|
|
gif = undefined
|
|
}
|
|
|
|
function resize() {
|
|
thisObject.container.frame.width = 0
|
|
thisObject.container.frame.height = 0
|
|
}
|
|
|
|
function getContainer(point, purpose) {
|
|
let container
|
|
|
|
if (thisObject.container.frame.isThisPointHere(point, true) === true) {
|
|
return thisObject.container
|
|
} else {
|
|
return undefined
|
|
}
|
|
}
|
|
|
|
function physics() {
|
|
if (currentNode === undefined) { return }
|
|
|
|
switch (currentStatus) {
|
|
case 'Stopped': {
|
|
makeInvisible()
|
|
currentNode = undefined
|
|
break
|
|
}
|
|
case 'Playing Tutorial': {
|
|
makeVsible()
|
|
break
|
|
}
|
|
case 'Playing Topic': {
|
|
makeVsible()
|
|
break
|
|
}
|
|
case 'Playing Step': {
|
|
makeVsible()
|
|
break
|
|
}
|
|
}
|
|
|
|
keyPressed()
|
|
checkPressButton()
|
|
checkGif()
|
|
checkImage()
|
|
checkDocumentation()
|
|
checkWorkspaces()
|
|
checkSlider()
|
|
checkReference()
|
|
checkViewportZoom()
|
|
checkViewportZoomAtCenter()
|
|
return
|
|
|
|
function keyPressed() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (
|
|
config.keyPressed !== undefined
|
|
) {
|
|
keyPressedCounter++
|
|
if (keyPressedCounter === 10) {
|
|
let event = {
|
|
metaKey: config.keyPressed.metaKey,
|
|
shiftKey: config.keyPressed.shiftKey,
|
|
ctrlKey: config.keyPressed.ctrlKey,
|
|
code: config.keyPressed.code,
|
|
key: config.keyPressed.key
|
|
}
|
|
canvas.onKeyDown(event, true)
|
|
}
|
|
}
|
|
}
|
|
|
|
function checkViewportZoom() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.viewportZoom !== undefined) {
|
|
let totalZoomSteps = config.viewportZoom
|
|
let delta
|
|
if (totalZoomSteps > 0) {
|
|
delta = 1
|
|
} else {
|
|
delta = -1
|
|
}
|
|
currentZoomStep = currentZoomStep + delta
|
|
let event = {
|
|
delta: delta
|
|
}
|
|
if (totalZoomSteps > 0) {
|
|
if (currentZoomStep < totalZoomSteps) {
|
|
canvas.chartingSpace.viewport.onMouseWheel(event)
|
|
}
|
|
} else {
|
|
if (currentZoomStep > totalZoomSteps) {
|
|
canvas.chartingSpace.viewport.onMouseWheel(event)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function checkViewportZoomAtCenter() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.viewportZoomAtCenter !== undefined) {
|
|
canvas.chartingSpace.viewport.zoomAtCenter(config.viewportZoomAtCenter)
|
|
}
|
|
}
|
|
|
|
function checkViewportZoomAtCenter() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.viewportZoomAtCenter !== undefined) {
|
|
canvas.chartingSpace.viewport.zoomAtCenter(config.viewportZoomAtCenter)
|
|
}
|
|
}
|
|
|
|
function checkPressButton() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.pressButton === undefined || config.pressButton === "") {
|
|
return
|
|
}
|
|
/* Remove this item from the navigation stack. */
|
|
navigationStack.splice(navigationStack.length - 1)
|
|
switch (config.pressButton) {
|
|
case "Stop": {
|
|
stop()
|
|
return
|
|
}
|
|
case "Skip": {
|
|
skip()
|
|
return
|
|
}
|
|
case "Previous": {
|
|
previous()
|
|
return
|
|
}
|
|
case "Next": {
|
|
next()
|
|
return
|
|
}
|
|
}
|
|
}
|
|
|
|
function checkGif() {
|
|
let tutorialGifDiv = document.getElementById('tutorialGifDiv')
|
|
if (tutorialGifDiv !== null && tutorialGifDiv !== undefined) {
|
|
tutorialGifDiv.appendChild(htmlGif)
|
|
}
|
|
|
|
if (currentGifName === newGifName) { return }
|
|
currentGifName = newGifName
|
|
htmlGif.src = 'Images/Tutorial/Gifs/' + currentGifName + '.gif'
|
|
htmlGif.width = "400"
|
|
htmlGif.height = "580"
|
|
}
|
|
|
|
function checkImage() {
|
|
let tutorialImageDiv = document.getElementById('tutorialImageDiv')
|
|
if (tutorialImageDiv !== null && tutorialImageDiv !== undefined) {
|
|
tutorialImageDiv.appendChild(htmlImage)
|
|
}
|
|
|
|
if (currentImageName === newImageName) { return }
|
|
currentImageName = newImageName
|
|
htmlImage.src = 'Images/Icons/style-01/' + currentImageName + '.png'
|
|
htmlImage.width = "100"
|
|
htmlImage.height = "100"
|
|
}
|
|
|
|
function checkDocumentation() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
let newDocumentationURL = config.documentationURL
|
|
documentationCounter++
|
|
if (documentationCounter === 10) {
|
|
if (newDocumentationURL === undefined) {
|
|
/*
|
|
The doc panel will remain as it is, and the user will be free to open or close it at will.
|
|
*/
|
|
return
|
|
}
|
|
if (newDocumentationURL === "") {
|
|
/*
|
|
This forces the tutorial to close the documentation panel and to keep it closed.
|
|
*/
|
|
canvas.docSpace.sidePanelTab.close()
|
|
return
|
|
}
|
|
canvas.docSpace.sidePanelTab.open()
|
|
if (newDocumentationURL === currentDocumentationURL) { return }
|
|
|
|
currentDocumentationURL = newDocumentationURL
|
|
canvas.docSpace.navigateTo(currentDocumentationURL)
|
|
}
|
|
}
|
|
|
|
function checkWorkspaces() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.workspaces === undefined) {
|
|
/*
|
|
The worspaces panel will remain as it is, and the user will be free to open or close it at will.
|
|
*/
|
|
return
|
|
}
|
|
if (config.workspaces === "" || config.workspaces === "Close") {
|
|
/*
|
|
This forces the tutorial to close the workspaces panel and to keep it closed.
|
|
*/
|
|
canvas.sideSpace.sidePanelTab.close()
|
|
return
|
|
}
|
|
if (config.workspaces === "Open") {
|
|
/*
|
|
This forces the tutorial to close the workspaces panel and to keep it closed.
|
|
*/
|
|
canvas.sideSpace.sidePanelTab.open()
|
|
return
|
|
}
|
|
}
|
|
|
|
function checkSlider() {
|
|
if (currentNode === undefined) { return }
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.slider === undefined) {
|
|
/*
|
|
The cockpit space will remain where it is. The user is free to move it.
|
|
*/
|
|
return
|
|
}
|
|
if (sliderPositioned === false) {
|
|
sliderPositioned = true
|
|
switch (config.slider) {
|
|
case "toTop": {
|
|
/*
|
|
This forces the tutorial to close the charting space and to keep it closed.
|
|
*/
|
|
canvas.cockpitSpace.toTop()
|
|
return
|
|
}
|
|
case "toMiddle": {
|
|
/*
|
|
This forces the tutorial to share the screen half with the designer and half
|
|
with the charting space and force it in that way.
|
|
*/
|
|
canvas.cockpitSpace.toMiddle()
|
|
return
|
|
}
|
|
case "toBottom": {
|
|
/*
|
|
This forces the tutorial to fully open the charting space and to keep it open.
|
|
*/
|
|
canvas.cockpitSpace.toBottom()
|
|
return
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function checkReference() {
|
|
/*
|
|
If there is a reference parent defined, we will highlight it
|
|
and move the designer so that that node be at the center of the screen.
|
|
*/
|
|
if (currentNode !== undefined) {
|
|
if (currentNode.payload !== undefined) {
|
|
if (currentNode.payload.referenceParent !== undefined) {
|
|
if (currentNode.payload.referenceParent.payload !== undefined) {
|
|
if (currentNode.payload.referenceParent.payload.uiObject !== undefined) {
|
|
let config = JSON.parse(currentNode.config)
|
|
if (
|
|
config.positionAtReferenceParent === true
|
|
) {
|
|
/*
|
|
This moves the Designs Space so that the referenced node is at the center of the screen.
|
|
*/
|
|
positionAtNodeCounter++
|
|
if (positionAtNodeCounter === 1) {
|
|
currentNode.payload.referenceParent.payload.floatingObject.unCollapseParent()
|
|
}
|
|
if (positionAtNodeCounter < 100) {
|
|
canvas.floatingSpace.positionAtNode(currentNode.payload.referenceParent)
|
|
}
|
|
}
|
|
if (
|
|
config.highlightReferenceParent === true
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.highlight()
|
|
}
|
|
if (
|
|
config.highlightReferenceParent === true
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.highlight()
|
|
}
|
|
if (
|
|
config.setErrorMessageReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setErrorMessage(config.setErrorMessageReferenceParent)
|
|
}
|
|
if (
|
|
config.setWarningMessageReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setWarningMessage(config.setWarningMessageReferenceParent)
|
|
}
|
|
if (
|
|
config.setInfoMessageReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setInfoMessage(config.setInfoMessageReferenceParent)
|
|
}
|
|
if (
|
|
config.setValueReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setValue(config.setValueReferenceParent)
|
|
}
|
|
if (
|
|
config.setPercentageReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setPercentage(config.setPercentageReferenceParent)
|
|
}
|
|
if (
|
|
config.setStatusReferenceParent !== undefined
|
|
) {
|
|
currentNode.payload.referenceParent.payload.uiObject.setStatus(config.setStatusReferenceParent)
|
|
}
|
|
if (
|
|
config.setFocusReferenceParent === true
|
|
) {
|
|
currentNode.payload.referenceParent.payload.floatingObject.forceFocus()
|
|
forcingFocus = true
|
|
}
|
|
if (
|
|
config.batchConfigChangesReferenceParent !== undefined
|
|
) {
|
|
batchConfigChangesCounter++
|
|
if (batchConfigChangesCounter === 5) {
|
|
/*
|
|
Here we are going to process an array of different changes to descendents
|
|
of the reference parent. The end user needs to specify a nodePath to the
|
|
descendent and an object with the properties and new values that want to
|
|
change at each descendent. The nodePath route starts at the object
|
|
referenceParent.
|
|
*/
|
|
let referenceParent = currentNode.payload.referenceParent
|
|
for (let i = 0; i < config.batchConfigChangesReferenceParent.length; i++) {
|
|
let arrayItem = config.batchConfigChangesReferenceParent[i]
|
|
let nodePath = arrayItem.nodePath
|
|
let properties = arrayItem.properties
|
|
|
|
let childNode
|
|
try {
|
|
childNode = eval(nodePath)
|
|
} catch (err) {
|
|
console.log(MODULE_NAME + ' -> The nodePath provided is not good. -> nodePath = ' + nodePath)
|
|
let splittedPath = nodePath.split('.')
|
|
let partialPath = ''
|
|
let separator = ''
|
|
for (let j = 0; j < splittedPath.length; j++) {
|
|
let part = splittedPath[j]
|
|
partialPath = partialPath + separator + part
|
|
separator = '.'
|
|
let partialNode = eval(partialPath)
|
|
if (partialNode === undefined) {
|
|
console.log(MODULE_NAME + ' -> This part can not be undefined -> part = ' + part)
|
|
currentNode.payload.uiObject.setErrorMessage('Node Path is incorrect. See console log for details.')
|
|
break
|
|
}
|
|
}
|
|
continue
|
|
}
|
|
let nodeConfig = JSON.parse(childNode.config)
|
|
for (const property in properties) {
|
|
nodeConfig[property] = properties[property]
|
|
}
|
|
childNode.config = JSON.stringify(nodeConfig, undefined, 5)
|
|
}
|
|
}
|
|
}
|
|
if (
|
|
config.changeNodeConfigReferenceParent !== undefined
|
|
) {
|
|
changeNodeConfigCounter++
|
|
if (changeNodeConfigCounter === 5) {
|
|
let nodeConfig = JSON.parse(currentNode.payload.referenceParent.config)
|
|
for (const property in config.changeNodeConfigReferenceParent) {
|
|
nodeConfig[property] = config.changeNodeConfigReferenceParent[property]
|
|
}
|
|
currentNode.payload.referenceParent.config = JSON.stringify(nodeConfig)
|
|
}
|
|
}
|
|
if (
|
|
config.menuActionReferenceParent !== undefined
|
|
) {
|
|
/*
|
|
Some actions needs a little delay because they depend on animations to happen.
|
|
For that reason, we will count until 10 before executing actions from tutorial.
|
|
*/
|
|
actionCounter++
|
|
if (actionCounter > 10) {
|
|
if (config.menuActionReferenceParent + currentNode.id !== lastExecutedAction) {
|
|
currentNode.payload.referenceParent.payload.uiObject.menu.internalClick(config.menuActionReferenceParent)
|
|
lastExecutedAction = config.menuActionReferenceParent + currentNode.id
|
|
}
|
|
}
|
|
} else {
|
|
lastExecutedAction = ""
|
|
}
|
|
if (
|
|
config.keyPressedTimeMachineReferenceParent !== undefined
|
|
) {
|
|
if (currentNode.payload.referenceParent.type === 'Time Machine') {
|
|
let timeMachine = canvas.chartingSpace.findTimeMachine(currentNode.payload.referenceParent)
|
|
if (timeMachine !== undefined) {
|
|
timeMachineKeyPressedCounter++
|
|
if (timeMachineKeyPressedCounter === 10) {
|
|
let event = {
|
|
metaKey: config.keyPressedTimeMachineReferenceParent.metaKey,
|
|
shiftKey: config.keyPressedTimeMachineReferenceParent.shiftKey,
|
|
ctrlKey: config.keyPressedTimeMachineReferenceParent.ctrlKey,
|
|
code: config.keyPressedTimeMachineReferenceParent.code,
|
|
key: config.keyPressedTimeMachineReferenceParent.key
|
|
}
|
|
timeMachine.edgeEditor.onKeyPressed(event, true)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (
|
|
config.viewportCenterReferenceParent === true
|
|
) {
|
|
if (currentNode.payload.referenceParent.type === 'Time Machine') {
|
|
let timeMachine = canvas.chartingSpace.findTimeMachine(currentNode.payload.referenceParent)
|
|
if (timeMachine !== undefined && viewportCentered === false) {
|
|
canvas.chartingSpace.viewport.displaceToContainer(timeMachine.container)
|
|
viewportCentered = true
|
|
}
|
|
}
|
|
}
|
|
if (
|
|
config.repositionAtTimeMachineReferenceParent === true
|
|
) {
|
|
if (currentNode.payload.referenceParent.type === 'Time Machine') {
|
|
let timeMachine = canvas.chartingSpace.findTimeMachine(currentNode.payload.referenceParent)
|
|
if (timeMachine !== undefined) {
|
|
repositionAtTimeMachineCounter++
|
|
switch (true) {
|
|
case (repositionAtTimeMachineCounter > 10 && repositionAtTimeMachineCounter < 20): {
|
|
let event = {
|
|
delta: -1
|
|
}
|
|
canvas.chartingSpace.viewport.onMouseWheel(event)
|
|
break
|
|
}
|
|
case (repositionAtTimeMachineCounter === 30): {
|
|
canvas.chartingSpace.viewport.displaceToContainer(timeMachine.container)
|
|
break
|
|
}
|
|
case (repositionAtTimeMachineCounter === 40): {
|
|
canvas.chartingSpace.viewport.zoomAtCenter(8)
|
|
break
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (
|
|
config.repositionAtTimeMachineNoZoomReferenceParent === true
|
|
) {
|
|
if (currentNode.payload.referenceParent.type === 'Time Machine') {
|
|
let timeMachine = canvas.chartingSpace.findTimeMachine(currentNode.payload.referenceParent)
|
|
if (timeMachine !== undefined) {
|
|
repositionAtTimeMachineCounter++
|
|
switch (true) {
|
|
case (repositionAtTimeMachineCounter > 10 && repositionAtTimeMachineCounter < 20): {
|
|
let event = {
|
|
delta: -1
|
|
}
|
|
canvas.chartingSpace.viewport.onMouseWheel(event)
|
|
break
|
|
}
|
|
case (repositionAtTimeMachineCounter === 30): {
|
|
canvas.chartingSpace.viewport.displaceToContainer(timeMachine.container)
|
|
break
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function makeInvisible() {
|
|
const HEIGHT = 0
|
|
const WIDTH = 0
|
|
const FORM_HEIGHT = 0
|
|
|
|
tutorialPosition = {
|
|
x: 100000,
|
|
y: 100000
|
|
}
|
|
|
|
tutorialDiv.style = ' ' +
|
|
'position:fixed; top:' + tutorialPosition.y + 'px; ' +
|
|
'left:' + tutorialPosition.x + 'px; ' +
|
|
'width: ' + WIDTH + 'px;' +
|
|
'height: ' + HEIGHT + 'px;' +
|
|
'z-index:1;'
|
|
|
|
tutorialFormDiv.style = ' ' +
|
|
'position:fixed; top:' + (tutorialPosition.y) + 'px; ' +
|
|
'left:' + tutorialPosition.x + 'px; ' +
|
|
'width: ' + WIDTH + 'px;' +
|
|
'height: ' + FORM_HEIGHT + 'px;' +
|
|
'z-index:1;'
|
|
}
|
|
|
|
function makeVsible() {
|
|
const HEIGHT = 650
|
|
const WIDTH = 400
|
|
const MARGIN = 100
|
|
const FORM_HEIGHT = 40
|
|
|
|
let nodeConfig
|
|
try {
|
|
nodeConfig = JSON.parse(currentNode.config)
|
|
} catch (err) {
|
|
return
|
|
}
|
|
|
|
switch (nodeConfig.position) {
|
|
case 'Left': {
|
|
tutorialPosition = {
|
|
x: MARGIN,
|
|
y: (browserCanvas.height - HEIGHT) / 2
|
|
}
|
|
break
|
|
}
|
|
case 'Center': {
|
|
tutorialPosition = {
|
|
x: browserCanvas.width / 2 - WIDTH / 2,
|
|
y: (browserCanvas.height - HEIGHT) / 2
|
|
}
|
|
break
|
|
}
|
|
case 'Right': {
|
|
tutorialPosition = {
|
|
x: browserCanvas.width - WIDTH - MARGIN,
|
|
y: (browserCanvas.height - HEIGHT) / 2
|
|
}
|
|
break
|
|
}
|
|
default: {
|
|
tutorialPosition = {
|
|
x: browserCanvas.width / 2 - WIDTH / 2,
|
|
y: (browserCanvas.height - HEIGHT) / 2
|
|
}
|
|
break
|
|
}
|
|
}
|
|
tutorialDiv.style = ' ' +
|
|
'position:fixed; top:' + tutorialPosition.y + 'px; ' +
|
|
'left:' + tutorialPosition.x + 'px; ' +
|
|
'width: ' + WIDTH + 'px;' +
|
|
'height: ' + HEIGHT + 'px;' +
|
|
'z-index:1;'
|
|
|
|
buildHTML()
|
|
|
|
tutorialFormDiv.style = ' ' +
|
|
'position:fixed; top:' + (tutorialPosition.y + HEIGHT - 30) + 'px; ' +
|
|
'left:' + tutorialPosition.x + 'px; ' +
|
|
'width: ' + (WIDTH + 20) + 'px;' +
|
|
'height: ' + FORM_HEIGHT + 'px;' +
|
|
'z-index:1;'
|
|
}
|
|
}
|
|
|
|
function stop() {
|
|
resetAfterButtonPressed()
|
|
checkForceFocus()
|
|
tutorialRootNode.payload.uiObject.isPlaying = false
|
|
tutorialRootNode = undefined
|
|
currentStatus = 'Stopped'
|
|
}
|
|
|
|
function skip() {
|
|
resetAfterButtonPressed()
|
|
checkForceFocus()
|
|
let tutorial = {
|
|
status: 'Skipped'
|
|
}
|
|
saveTutorial(currentNode.payload, tutorial)
|
|
advance(true)
|
|
}
|
|
|
|
function previous() {
|
|
resetAfterButtonPressed()
|
|
checkForceFocus()
|
|
if (navigationStack.length > 1) {
|
|
let previousNode = navigationStack[navigationStack.length - 2]
|
|
switch (previousNode.type) {
|
|
case 'Tutorial': {
|
|
currentNode = previousNode
|
|
findTutorialNode(currentNode)
|
|
currentStatus = 'Playing Tutorial'
|
|
navigationStack.splice(navigationStack.length - 1)
|
|
break
|
|
}
|
|
case 'Tutorial Topic': {
|
|
currentNode = previousNode
|
|
findTutorialNode(currentNode)
|
|
currentStatus = 'Playing Topic'
|
|
navigationStack.splice(navigationStack.length - 1)
|
|
break
|
|
}
|
|
case 'Tutorial Step': {
|
|
currentNode = previousNode
|
|
findTutorialNode(currentNode)
|
|
currentStatus = 'Playing Step'
|
|
navigationStack.splice(navigationStack.length - 1)
|
|
break
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function next() {
|
|
resetAfterButtonPressed()
|
|
checkForceFocus()
|
|
if (ckeckGoingToAnotherTutorial() === true) { return }
|
|
let tutorial = {
|
|
status: 'Done'
|
|
}
|
|
saveTutorial(currentNode.payload, tutorial)
|
|
advance()
|
|
}
|
|
|
|
function resetAfterButtonPressed() {
|
|
resetViewport()
|
|
resetActions()
|
|
resetDocumentation()
|
|
resetRepositionAtTimeMachine()
|
|
resetPositionAtNode()
|
|
resetTimeMachineKeyPressed()
|
|
resetKeyPressed()
|
|
resetSlider()
|
|
changeNodeConfig()
|
|
batchConfigChanges()
|
|
|
|
function resetActions() {
|
|
lastExecutedAction = ""
|
|
actionCounter = 0
|
|
}
|
|
|
|
function resetViewport() {
|
|
currentZoomStep = 0
|
|
viewportCentered = false
|
|
}
|
|
|
|
function resetDocumentation() {
|
|
currentDocumentationURL = ''
|
|
documentationCounter = 0
|
|
}
|
|
|
|
function resetRepositionAtTimeMachine() {
|
|
repositionAtTimeMachineCounter = 0
|
|
}
|
|
|
|
function resetPositionAtNode() {
|
|
positionAtNodeCounter = 0
|
|
}
|
|
|
|
function resetTimeMachineKeyPressed() {
|
|
timeMachineKeyPressedCounter = 0
|
|
}
|
|
|
|
function resetKeyPressed() {
|
|
keyPressedCounter = 0
|
|
}
|
|
|
|
function resetSlider() {
|
|
sliderPositioned = false
|
|
}
|
|
|
|
function changeNodeConfig() {
|
|
changeNodeConfigCounter = 0
|
|
}
|
|
|
|
function batchConfigChanges() {
|
|
batchConfigChangesCounter = 0
|
|
}
|
|
}
|
|
|
|
function checkForceFocus() {
|
|
if (forcingFocus === true) {
|
|
currentNode.payload.referenceParent.payload.floatingObject.removeForceFocus()
|
|
forcingFocus = false
|
|
}
|
|
}
|
|
|
|
function ckeckGoingToAnotherTutorial() {
|
|
if (currentNode.payload !== undefined) {
|
|
if (currentNode.payload.referenceParent !== undefined) {
|
|
let config = JSON.parse(currentNode.config)
|
|
if (config.startTutorialReferenceParent === true) {
|
|
if (currentNode.payload.referenceParent.type === 'Tutorial') {
|
|
tutorialRootNode = currentNode.payload.referenceParent
|
|
currentNode = currentNode.payload.referenceParent
|
|
currentStatus = 'Playing Tutorial'
|
|
resumeModeActivated = false
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function playTutorial(node) {
|
|
navigationStack = []
|
|
node.payload.uiObject.isPlaying = true
|
|
tutorialRootNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Tutorial'
|
|
resumeModeActivated = false
|
|
navigationStack.push(currentNode)
|
|
}
|
|
|
|
function resumeTutorial(node) {
|
|
navigationStack = []
|
|
node.payload.uiObject.isPlaying = true
|
|
tutorialRootNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Tutorial'
|
|
resumeModeActivated = true
|
|
navigationStack.push(currentNode)
|
|
advance()
|
|
}
|
|
|
|
function playTutorialTopic(node) {
|
|
navigationStack = []
|
|
currentTopicNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Topic'
|
|
resumeModeActivated = false
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(node)
|
|
}
|
|
|
|
function resumeTutorialTopic(node) {
|
|
navigationStack = []
|
|
currentTopicNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Topic'
|
|
resumeModeActivated = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(node)
|
|
}
|
|
|
|
function playTutorialStep(node) {
|
|
navigationStack = []
|
|
currentStepNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Step'
|
|
resumeModeActivated = false
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(node)
|
|
}
|
|
|
|
function resumeTutorialStep(node) {
|
|
navigationStack = []
|
|
currentStepNode = node
|
|
currentNode = node
|
|
currentStatus = 'Playing Step'
|
|
resumeModeActivated = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(node)
|
|
}
|
|
|
|
function resetTutorialProgress(node) {
|
|
resetNextNode(node)
|
|
|
|
function resetNextNode(node) {
|
|
|
|
for (let i = 0; i < node.tutorialSteps.length; i++) {
|
|
let tutorialStep = node.tutorialSteps[i]
|
|
let tutorial = {
|
|
status: 'Reset'
|
|
}
|
|
saveTutorial(tutorialStep.payload, tutorial)
|
|
}
|
|
|
|
for (let i = 0; i < node.tutorialTopics.length; i++) {
|
|
let tutorialTopic = node.tutorialTopics[i]
|
|
let tutorial = {
|
|
status: 'Reset'
|
|
}
|
|
saveTutorial(tutorialTopic.payload, tutorial)
|
|
resetNextNode(tutorialTopic)
|
|
}
|
|
}
|
|
}
|
|
|
|
function findTutorialNode(node) {
|
|
/*
|
|
We will consider the tutorialRootNode the head of the hirierchy
|
|
*/
|
|
tutorialRootNode = node
|
|
|
|
if (node.payload !== undefined) {
|
|
if (node.payload.parentNode !== undefined) {
|
|
findTutorialNode(node.payload.parentNode)
|
|
}
|
|
}
|
|
}
|
|
|
|
function advance(isSkipping) {
|
|
let found
|
|
let advanced
|
|
|
|
switch (currentStatus) {
|
|
case 'Playing Tutorial': {
|
|
found = true
|
|
findNextNode(tutorialRootNode)
|
|
break
|
|
}
|
|
case 'Playing Topic': {
|
|
found = false
|
|
if (isSkipping === true) {
|
|
findNextTopic(tutorialRootNode)
|
|
} else {
|
|
findNextNode(tutorialRootNode)
|
|
}
|
|
break
|
|
}
|
|
case 'Playing Step': {
|
|
found = false
|
|
findNextNode(tutorialRootNode)
|
|
break
|
|
}
|
|
}
|
|
|
|
/*
|
|
If we can not find a next node, then we stop the tutorial.
|
|
*/
|
|
if (advanced === undefined) {
|
|
stop()
|
|
return
|
|
}
|
|
|
|
|
|
function findNextNode(node) {
|
|
for (let i = 0; i < node.tutorialSteps.length; i++) {
|
|
|
|
let tutorialStep = node.tutorialSteps[i]
|
|
if (found === true) {
|
|
if (resumeModeActivated !== true) {
|
|
currentNode = tutorialStep
|
|
currentStatus = 'Playing Step'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
} else {
|
|
let tutorial = {
|
|
status: undefined
|
|
}
|
|
loadTutorial(tutorialStep.payload, tutorial)
|
|
if (tutorial.status !== 'Done') {
|
|
currentNode = tutorialStep
|
|
currentStatus = 'Playing Step'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
}
|
|
}
|
|
}
|
|
if (tutorialStep.id === currentNode.id) {
|
|
found = true
|
|
}
|
|
}
|
|
|
|
for (let i = 0; i < node.tutorialTopics.length; i++) {
|
|
|
|
if (advanced === true) {
|
|
return
|
|
}
|
|
|
|
let tutorialTopic = node.tutorialTopics[i]
|
|
if (found === true) {
|
|
if (resumeModeActivated !== true) {
|
|
currentNode = tutorialTopic
|
|
currentStatus = 'Playing Topic'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
} else {
|
|
let tutorial = {
|
|
status: undefined
|
|
}
|
|
loadTutorial(tutorialTopic.payload, tutorial)
|
|
if (tutorial.status !== 'Done') {
|
|
currentNode = tutorialTopic
|
|
currentStatus = 'Playing Topic'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
}
|
|
}
|
|
}
|
|
if (tutorialTopic.id === currentNode.id) {
|
|
found = true
|
|
}
|
|
|
|
findNextNode(tutorialTopic, found)
|
|
}
|
|
}
|
|
|
|
function findNextTopic(node) {
|
|
for (let i = 0; i < node.tutorialTopics.length; i++) {
|
|
|
|
if (advanced === true) {
|
|
return
|
|
}
|
|
|
|
let tutorialTopic = node.tutorialTopics[i]
|
|
if (found === true) {
|
|
if (resumeModeActivated !== true) {
|
|
currentNode = tutorialTopic
|
|
currentStatus = 'Playing Topic'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
} else {
|
|
let tutorial = {
|
|
status: undefined
|
|
}
|
|
loadTutorial(tutorialTopic.payload, tutorial)
|
|
if (tutorial.status !== 'Done') {
|
|
currentNode = tutorialTopic
|
|
currentStatus = 'Playing Topic'
|
|
advanced = true
|
|
navigationStack.push(currentNode)
|
|
findTutorialNode(currentNode)
|
|
return
|
|
}
|
|
}
|
|
}
|
|
if (tutorialTopic.id === currentNode.id) {
|
|
found = true
|
|
} else {
|
|
findNextTopic(tutorialTopic, found)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function buildHTML() {
|
|
|
|
newConfig = currentNode.config
|
|
if (newConfig === currentConfig) { return }
|
|
currentConfig = newConfig
|
|
|
|
let nodeConfig = JSON.parse(currentNode.config)
|
|
let html = ''
|
|
if (nodeConfig.title !== undefined && nodeConfig.title !== '') {
|
|
html = html + '<div><h1 class="tutorial-font-large">' + nodeConfig.title + '</h1></div>'
|
|
}
|
|
html = html + '<div>'
|
|
if (nodeConfig.summary !== undefined && nodeConfig.summary !== '') {
|
|
html = html + '<div class="tutorial-font-small tutorial-summary">' + addToolTips(nodeConfig.summary) + '</div>'
|
|
}
|
|
if (nodeConfig.subTitle !== undefined && nodeConfig.subTitle !== '') {
|
|
html = html + '<h2 class="tutorial-font-medium">' + nodeConfig.subTitle + '</h2>'
|
|
}
|
|
if (nodeConfig.gif !== undefined && nodeConfig.gif !== '') {
|
|
html = html + '<div id="tutorialGifDiv" width="200" width="290"/>'
|
|
newGifName = nodeConfig.gif
|
|
}
|
|
|
|
if (nodeConfig.definition !== undefined && nodeConfig.definition !== '') {
|
|
html = html + '<table class="tutorial-definitionTable">'
|
|
html = html + '<tr>'
|
|
html = html + '<td>'
|
|
if (nodeConfig.image !== undefined && nodeConfig.image !== '') {
|
|
html = html + '<div id="tutorialImageDiv" class="tutorial-image-container"/>'
|
|
newImageName = nodeConfig.image
|
|
}
|
|
html = html + '</td>'
|
|
html = html + '<td>'
|
|
html = html + '<strong class="tutorial-font-bold-small">' + addToolTips(nodeConfig.definition) + '</strong>'
|
|
html = html + '</td>'
|
|
html = html + '</tr>'
|
|
html = html + '</table>'
|
|
}
|
|
if (nodeConfig.bulletListIntro !== undefined && nodeConfig.bulletListIntro !== '') {
|
|
html = html + '<div class="tutorial-font-small">' + addToolTips(nodeConfig.bulletListIntro) + '</div>'
|
|
}
|
|
if (nodeConfig.bulletArray !== undefined) {
|
|
html = html + '<ul>'
|
|
for (let i = 0; i < nodeConfig.bulletArray.length; i++) {
|
|
let bullet = nodeConfig.bulletArray[i]
|
|
html = html + '<li>'
|
|
html = html + '<div class="tutorial-font-small"><strong class="tutorial-font-bold-small">' + addToolTips(bullet[0]) + '</strong> ' + addToolTips(bullet[1]) + '</div>'
|
|
html = html + '</li>'
|
|
}
|
|
html = html + '</ul>'
|
|
}
|
|
if (nodeConfig.paragraph1 !== undefined && nodeConfig.paragraph1 !== '') {
|
|
html = html + '<div class="tutorial-font-small">' + addToolTips(nodeConfig.paragraph1) + '</div>'
|
|
}
|
|
if (nodeConfig.callOut !== undefined && nodeConfig.callOut !== '') {
|
|
html = html + '<div class="tutorial-font-bold-small tutorial-callout" > ' + addToolTips(nodeConfig.callOut) + ''
|
|
if (nodeConfig.externalLink !== undefined) {
|
|
html = html + '<a href="' + nodeConfig.externalLink[1] + '" target="_blank">' + nodeConfig.externalLink[0] + '</a>'
|
|
}
|
|
html = html + '</div>'
|
|
}
|
|
if (nodeConfig.paragraph2 !== undefined && nodeConfig.paragraph2 !== '') {
|
|
html = html + '<div class="tutorial-font-small">' + addToolTips(nodeConfig.paragraph2) + '</div>'
|
|
}
|
|
if (nodeConfig.note !== undefined && nodeConfig.note !== '') {
|
|
html = html + '<div class="tutorial-font-small tutorial-alert-info" role="alert"><i class="tutorial-fa tutorial-info-circle"></i> <b>Note:</b> ' + addToolTips(nodeConfig.note) + '</div>'
|
|
}
|
|
if (nodeConfig.tip !== undefined && nodeConfig.tip !== '') {
|
|
html = html + '<div class="tutorial-font-small tutorial-alert-success" role="alert"><i class="tutorial-fa tutorial-check-square-o"></i> <b>Tip:</b> ' + addToolTips(nodeConfig.tip) + '</div>'
|
|
}
|
|
if (nodeConfig.important !== undefined && nodeConfig.important !== '') {
|
|
html = html + '<div class="tutorial-font-small tutorial-alert-important" role="alert"><i class="tutorial-fa tutorial-warning"></i> <b>Important:</b> ' + addToolTips(nodeConfig.important) + '</div>'
|
|
}
|
|
if (nodeConfig.warning !== undefined && nodeConfig.warning !== '') {
|
|
html = html + '<div class="tutorial-font-small tutorial-alert-warning" role="alert"><i class="tutorial-fa tutorial-warning"></i> <b>Warning:</b> ' + addToolTips(nodeConfig.warning) + '</div>'
|
|
}
|
|
html = html + '</div>'
|
|
|
|
tutorialDiv.innerHTML = html
|
|
|
|
function addToolTips(text) {
|
|
const TOOL_TIP_HTML = '<div class="tooltip">NODE_TYPE<span class="tooltiptext">NODE_DEFINITION</span></div>'
|
|
let resultingText = ''
|
|
let splittedText = text.split('->')
|
|
|
|
for (let i = 0; i < splittedText.length; i = i + 2) {
|
|
let firstPart = splittedText[i]
|
|
let nodeType = splittedText[i + 1]
|
|
if (nodeType === undefined) {
|
|
return resultingText + firstPart
|
|
}
|
|
let definitionNode = DOC_SCHEMA_MAP.get(nodeType)
|
|
if (definitionNode === undefined) {
|
|
definitionNode = CONCEPT_SCHEMA_MAP.get(nodeType)
|
|
if (definitionNode === undefined) {
|
|
currentNode.payload.uiObject.setErrorMessage(nodeType + ' not found at Doc Schema or Concept Schema.')
|
|
return
|
|
}
|
|
}
|
|
let definition = definitionNode.definition
|
|
if (definition === undefined || definition === "") {
|
|
resultingText = resultingText + firstPart + nodeType
|
|
} else {
|
|
let tooltip = TOOL_TIP_HTML.replace('NODE_TYPE', nodeType).replace('NODE_DEFINITION', definition)
|
|
resultingText = resultingText + firstPart + tooltip
|
|
}
|
|
}
|
|
return resultingText
|
|
}
|
|
}
|
|
|
|
function draw() {
|
|
if (isInitialized === false) { return }
|
|
}
|
|
}
|