Update Code Docs
This commit is contained in:
parent
bd65c6c24d
commit
25805d40e5
41 changed files with 10977 additions and 2287 deletions
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
|
|
@ -26,5 +26,35 @@
|
||||||
},
|
},
|
||||||
"sites/codesnippets/getstarted.qmd": {
|
"sites/codesnippets/getstarted.qmd": {
|
||||||
"getstarted.html": "fdab1932"
|
"getstarted.html": "fdab1932"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/AlyxGrab.qmd": {
|
||||||
|
"AlyxGrab.html": "f5024cda"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/CaptchaDoor.qmd": {
|
||||||
|
"CaptchaDoor.html": "7bf020b7"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/CharacterFollowSpline.qmd": {
|
||||||
|
"CharacterFollowSpline.html": "83b9916c"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/GripRobot.qmd": {
|
||||||
|
"GripRobot.html": "75e18a43"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/Inventory.qmd": {
|
||||||
|
"Inventory.html": "7bacc42a"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/Slicegame.qmd": {
|
||||||
|
"Slicegame.html": "9f2f9ed7"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/MovablesSoundComponent.qmd": {
|
||||||
|
"MovablesSoundComponent.html": "941478f8"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/MainMenu.qmd": {
|
||||||
|
"MainMenu.html": "aaa47bc1"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/CustomAIController.qmd": {
|
||||||
|
"CustomAIController.html": "1cfcdc41"
|
||||||
|
},
|
||||||
|
"sites/codesnippets/SaveGame_SPUD.qmd": {
|
||||||
|
"SaveGame_SPUD.html": "e7f9f0cc"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
12
_quarto.yml
12
_quarto.yml
|
|
@ -19,7 +19,15 @@ website:
|
||||||
- sites/getstarted.qmd
|
- sites/getstarted.qmd
|
||||||
- section: "Code Snippets"
|
- section: "Code Snippets"
|
||||||
contents:
|
contents:
|
||||||
- sites/codesnippets/getstarted.qmd
|
- sites/codesnippets/AlyxGrab.qmd
|
||||||
|
- sites/codesnippets/CaptchaDoor.qmd
|
||||||
|
- sites/codesnippets/CustomAIController.qmd
|
||||||
|
- sites/codesnippets/GripRobot.qmd
|
||||||
|
- sites/codesnippets/Inventory.qmd
|
||||||
|
- sites/codesnippets/MainMenu.qmd
|
||||||
|
- sites/codesnippets/MovablesSoundComponent.qmd
|
||||||
|
- sites/codesnippets/Slicegame.qmd
|
||||||
|
- sites/codesnippets/SaveGame_SPUD.qmd
|
||||||
- text: "Webservices"
|
- text: "Webservices"
|
||||||
href: sites/webservices.qmd
|
href: sites/webservices.qmd
|
||||||
- text: "Styleguide"
|
- text: "Styleguide"
|
||||||
|
|
@ -28,7 +36,7 @@ website:
|
||||||
|
|
||||||
|
|
||||||
page-footer:
|
page-footer:
|
||||||
left: "Copyright 2025, Simeon Wallrath"
|
left: "Copyright 2026, Simeon Wallrath"
|
||||||
right:
|
right:
|
||||||
- icon: mastodon
|
- icon: mastodon
|
||||||
href: https://mastodon.gamedev.place/@sciencedev
|
href: https://mastodon.gamedev.place/@sciencedev
|
||||||
|
|
|
||||||
BIN
_site/img/Midi.png
Normal file
BIN
_site/img/Midi.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 566 KiB |
396
_site/index.html
396
_site/index.html
|
|
@ -2,7 +2,7 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<meta name="generator" content="quarto-1.7.33">
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
@ -30,18 +30,17 @@ ul.task-list li input[type="checkbox"] {
|
||||||
<script src="site_libs/quarto-search/fuse.min.js"></script>
|
<script src="site_libs/quarto-search/fuse.min.js"></script>
|
||||||
<script src="site_libs/quarto-search/quarto-search.js"></script>
|
<script src="site_libs/quarto-search/quarto-search.js"></script>
|
||||||
<meta name="quarto:offset" content="./">
|
<meta name="quarto:offset" content="./">
|
||||||
<script src="site_libs/quarto-html/quarto.js" type="module"></script>
|
<script src="site_libs/quarto-html/quarto.js"></script>
|
||||||
<script src="site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
|
||||||
<script src="site_libs/quarto-html/popper.min.js"></script>
|
<script src="site_libs/quarto-html/popper.min.js"></script>
|
||||||
<script src="site_libs/quarto-html/tippy.umd.min.js"></script>
|
<script src="site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
<script src="site_libs/quarto-html/anchor.min.js"></script>
|
<script src="site_libs/quarto-html/anchor.min.js"></script>
|
||||||
<link href="site_libs/quarto-html/tippy.css" rel="stylesheet">
|
<link href="site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
<link href="site_libs/quarto-html/quarto-syntax-highlighting-ea385d0e468b0dd5ea5bf0780b1290d9.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
<link href="site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
<link href="site_libs/quarto-html/quarto-syntax-highlighting-dark-bc185b5c5bdbcb35c2eb49d8a876ef70.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
<link href="site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
<script src="site_libs/bootstrap/bootstrap.min.js"></script>
|
<script src="site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
<link href="site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
<link href="site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
<link href="site_libs/bootstrap/bootstrap-cc0e6b7e963372abfd8d1a3e5f94ef8b.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
<link href="site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
<link href="site_libs/bootstrap/bootstrap-dark-984ce6cd9b28ffdc8ec90b4c90a017de.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
<link href="site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
<script id="quarto-search-options" type="application/json">{
|
<script id="quarto-search-options" type="application/json">{
|
||||||
"location": "navbar",
|
"location": "navbar",
|
||||||
"copy-button": false,
|
"copy-button": false,
|
||||||
|
|
@ -73,167 +72,7 @@ ul.task-list li input[type="checkbox"] {
|
||||||
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body class="nav-sidebar docked nav-fixed quarto-dark"><script id="quarto-html-before-body" type="application/javascript">
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
const toggleBodyColorMode = (bsSheetEl) => {
|
|
||||||
const mode = bsSheetEl.getAttribute("data-mode");
|
|
||||||
const bodyEl = window.document.querySelector("body");
|
|
||||||
if (mode === "dark") {
|
|
||||||
bodyEl.classList.add("quarto-dark");
|
|
||||||
bodyEl.classList.remove("quarto-light");
|
|
||||||
} else {
|
|
||||||
bodyEl.classList.add("quarto-light");
|
|
||||||
bodyEl.classList.remove("quarto-dark");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleBodyColorPrimary = () => {
|
|
||||||
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])");
|
|
||||||
if (bsSheetEl) {
|
|
||||||
toggleBodyColorMode(bsSheetEl);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setColorSchemeToggle = (alternate) => {
|
|
||||||
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
|
||||||
for (let i=0; i < toggles.length; i++) {
|
|
||||||
const toggle = toggles[i];
|
|
||||||
if (toggle) {
|
|
||||||
if (alternate) {
|
|
||||||
toggle.classList.add("alternate");
|
|
||||||
} else {
|
|
||||||
toggle.classList.remove("alternate");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const toggleColorMode = (alternate) => {
|
|
||||||
// Switch the stylesheets
|
|
||||||
const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
|
|
||||||
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
|
||||||
if (alternate) {
|
|
||||||
// note: dark is layered on light, we don't disable primary!
|
|
||||||
enableStylesheet(alternateStylesheets);
|
|
||||||
for (const sheetNode of alternateStylesheets) {
|
|
||||||
if (sheetNode.id === "quarto-bootstrap") {
|
|
||||||
toggleBodyColorMode(sheetNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
disableStylesheet(alternateStylesheets);
|
|
||||||
enableStylesheet(primaryStylesheets)
|
|
||||||
toggleBodyColorPrimary();
|
|
||||||
}
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
|
||||||
// Switch the toggles
|
|
||||||
setColorSchemeToggle(alternate)
|
|
||||||
// Hack to workaround the fact that safari doesn't
|
|
||||||
// properly recolor the scrollbar when toggling (#1455)
|
|
||||||
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
|
||||||
manageTransitions("body", false);
|
|
||||||
window.scrollTo(0, 1);
|
|
||||||
setTimeout(() => {
|
|
||||||
window.scrollTo(0, 0);
|
|
||||||
manageTransitions("body", true);
|
|
||||||
}, 40);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const disableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
stylesheet.rel = 'disabled-stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const enableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check
|
|
||||||
stylesheet.rel = 'stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const manageTransitions = (selector, allowTransitions) => {
|
|
||||||
const els = window.document.querySelectorAll(selector);
|
|
||||||
for (let i=0; i < els.length; i++) {
|
|
||||||
const el = els[i];
|
|
||||||
if (allowTransitions) {
|
|
||||||
el.classList.remove('notransition');
|
|
||||||
} else {
|
|
||||||
el.classList.add('notransition');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const isFileUrl = () => {
|
|
||||||
return window.location.protocol === 'file:';
|
|
||||||
}
|
|
||||||
const hasAlternateSentinel = () => {
|
|
||||||
let styleSentinel = getColorSchemeSentinel();
|
|
||||||
if (styleSentinel !== null) {
|
|
||||||
return styleSentinel === "alternate";
|
|
||||||
} else {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setStyleSentinel = (alternate) => {
|
|
||||||
const value = alternate ? "alternate" : "default";
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
window.localStorage.setItem("quarto-color-scheme", value);
|
|
||||||
} else {
|
|
||||||
localAlternateSentinel = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const getColorSchemeSentinel = () => {
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
|
||||||
return storageValue != null ? storageValue : localAlternateSentinel;
|
|
||||||
} else {
|
|
||||||
return localAlternateSentinel;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
|
||||||
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
|
||||||
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
|
||||||
let newTheme = '';
|
|
||||||
if(authorPrefersDark) {
|
|
||||||
newTheme = isAlternate ? baseTheme : alternateTheme;
|
|
||||||
} else {
|
|
||||||
newTheme = isAlternate ? alternateTheme : baseTheme;
|
|
||||||
}
|
|
||||||
const changeGiscusTheme = () => {
|
|
||||||
// From: https://github.com/giscus/giscus/issues/336
|
|
||||||
const sendMessage = (message) => {
|
|
||||||
const iframe = document.querySelector('iframe.giscus-frame');
|
|
||||||
if (!iframe) return;
|
|
||||||
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
|
||||||
}
|
|
||||||
sendMessage({
|
|
||||||
setConfig: {
|
|
||||||
theme: newTheme
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
|
||||||
if (isGiscussLoaded) {
|
|
||||||
changeGiscusTheme();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const authorPrefersDark = true;
|
|
||||||
const darkModeDefault = authorPrefersDark;
|
|
||||||
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
|
||||||
// Dark / light mode switch
|
|
||||||
window.quartoToggleColorScheme = () => {
|
|
||||||
// Read the current dark / light value
|
|
||||||
let toAlternate = !hasAlternateSentinel();
|
|
||||||
toggleColorMode(toAlternate);
|
|
||||||
setStyleSentinel(toAlternate);
|
|
||||||
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
|
||||||
window.dispatchEvent(new Event('resize'));
|
|
||||||
};
|
|
||||||
// Switch to dark mode if need be
|
|
||||||
if (hasAlternateSentinel()) {
|
|
||||||
toggleColorMode(true);
|
|
||||||
} else {
|
|
||||||
toggleColorMode(false);
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<div id="quarto-search-results"></div>
|
<div id="quarto-search-results"></div>
|
||||||
<header id="quarto-header" class="headroom fixed-top">
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
|
@ -323,8 +162,56 @@ ul.task-list li input[type="checkbox"] {
|
||||||
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
<li class="sidebar-item">
|
<li class="sidebar-item">
|
||||||
<div class="sidebar-item-container">
|
<div class="sidebar-item-container">
|
||||||
<a href="./sites/codesnippets/getstarted.html" class="sidebar-item-text sidebar-link">
|
<a href="./sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
<span class="menu-text">Code</span></a>
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / Custom AI Controller</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slice Game</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="./sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Save Game / SPUD</span></a>
|
||||||
</div>
|
</div>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
@ -352,7 +239,6 @@ ul.task-list li input[type="checkbox"] {
|
||||||
<!-- main -->
|
<!-- main -->
|
||||||
<main class="content" id="quarto-document-content">
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
|
||||||
<header id="title-block-header" class="quarto-title-block default">
|
<header id="title-block-header" class="quarto-title-block default">
|
||||||
<div class="quarto-title">
|
<div class="quarto-title">
|
||||||
<h1 class="title">Overview</h1>
|
<h1 class="title">Overview</h1>
|
||||||
|
|
@ -372,13 +258,164 @@ ul.task-list li input[type="checkbox"] {
|
||||||
</header>
|
</header>
|
||||||
|
|
||||||
|
|
||||||
<p>This is the documentation for VIRTUOS WORLD.</p>
|
<p>This is the documentation for VIRTUOS WORLD, the Open Source VR Game I develop during my PhD in chemistry didactics. The main purpose of this page is to share the insights I gained during development.</p>
|
||||||
|
<p>If you want to take a look inside a project, there are currently <a href="code.virtuos.world">four important repositories</a>:</p>
|
||||||
|
<ul>
|
||||||
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground">VIRTUOS_Playground</a>: The repository contains the Unreal Engine Project</li>
|
||||||
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Assets">VIRTUOS_Assets</a>: Contains all Project related assets like 3D-Models, Graphics etc.</li>
|
||||||
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Documents">VIRTUOS_Documents</a>: Contains all written Documents</li>
|
||||||
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs">VIRTUOS_Docs</a>: The Documentation of this Project (which you’re reading right now)</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</main> <!-- /main -->
|
</main> <!-- /main -->
|
||||||
<script id="quarto-html-after-body" type="application/javascript">
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
window.document.addEventListener("DOMContentLoaded", function (event) {
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
// Ensure there is a toggle, if there isn't float one in the top right
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
const a = window.document.createElement('a');
|
const a = window.document.createElement('a');
|
||||||
|
|
@ -391,7 +428,12 @@ ul.task-list li input[type="checkbox"] {
|
||||||
a.appendChild(i);
|
a.appendChild(i);
|
||||||
window.document.body.appendChild(a);
|
window.document.body.appendChild(a);
|
||||||
}
|
}
|
||||||
setColorSchemeToggle(hasAlternateSentinel())
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
const icon = "";
|
const icon = "";
|
||||||
const anchorJS = new window.AnchorJS();
|
const anchorJS = new window.AnchorJS();
|
||||||
anchorJS.options = {
|
anchorJS.options = {
|
||||||
|
|
@ -787,13 +829,13 @@ ul.task-list li input[type="checkbox"] {
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</div> <!-- /content -->
|
</div> <!-- /content -->
|
||||||
<footer class="footer">
|
<footer class="footer">
|
||||||
<div class="nav-footer">
|
<div class="nav-footer">
|
||||||
<div class="nav-footer-left">
|
<div class="nav-footer-left">
|
||||||
<p>Copyright 2025, Simeon Wallrath</p>
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="nav-footer-center">
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
|
|
||||||
File diff suppressed because one or more lines are too long
12
_site/site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css
vendored
Normal file
12
_site/site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
12
_site/site_libs/bootstrap/bootstrap-c87ca82b5d65e0319ecb3cb12c33e724.min.css
vendored
Normal file
12
_site/site_libs/bootstrap/bootstrap-c87ca82b5d65e0319ecb3cb12c33e724.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
12
_site/site_libs/bootstrap/bootstrap-dark-32d4b27f351c12980646a206c7d81ffa.min.css
vendored
Normal file
12
_site/site_libs/bootstrap/bootstrap-dark-32d4b27f351c12980646a206c7d81ffa.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
12
_site/site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css
vendored
Normal file
12
_site/site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
1
_site/site_libs/quarto-contrib/glightbox/glightbox.min.css
vendored
Normal file
1
_site/site_libs/quarto-contrib/glightbox/glightbox.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
1
_site/site_libs/quarto-contrib/glightbox/glightbox.min.js
vendored
Normal file
1
_site/site_libs/quarto-contrib/glightbox/glightbox.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
26
_site/site_libs/quarto-contrib/glightbox/lightbox.css
Normal file
26
_site/site_libs/quarto-contrib/glightbox/lightbox.css
Normal file
|
|
@ -0,0 +1,26 @@
|
||||||
|
body:not(.glightbox-mobile) div.gslide div.gslide-description,
|
||||||
|
body:not(.glightbox-mobile) div.gslide-description .gslide-title,
|
||||||
|
body:not(.glightbox-mobile) div.gslide-description .gslide-desc {
|
||||||
|
color: var(--quarto-body-color);
|
||||||
|
background-color: var(--quarto-body-bg);
|
||||||
|
}
|
||||||
|
|
||||||
|
body:not(.glightbox-mobile) div.gslide-media {
|
||||||
|
background-color: var(--quarto-body-bg);
|
||||||
|
}
|
||||||
|
|
||||||
|
.goverlay {
|
||||||
|
background: rgba(0, 0, 0, 0.7);
|
||||||
|
}
|
||||||
|
|
||||||
|
div.gslide-description .gslide-title {
|
||||||
|
margin-top: 0.25em;
|
||||||
|
margin-bottom: 0.25em;
|
||||||
|
font-weight: 500;
|
||||||
|
font-family: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
div.gslide-description .gslide-desc {
|
||||||
|
padding-bottom: 0.5em;
|
||||||
|
font-family: inherit;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,205 @@
|
||||||
|
/* quarto syntax highlight colors */
|
||||||
|
:root {
|
||||||
|
--quarto-hl-ot-color: #003B4F;
|
||||||
|
--quarto-hl-at-color: #657422;
|
||||||
|
--quarto-hl-ss-color: #20794D;
|
||||||
|
--quarto-hl-an-color: #5E5E5E;
|
||||||
|
--quarto-hl-fu-color: #4758AB;
|
||||||
|
--quarto-hl-st-color: #20794D;
|
||||||
|
--quarto-hl-cf-color: #003B4F;
|
||||||
|
--quarto-hl-op-color: #5E5E5E;
|
||||||
|
--quarto-hl-er-color: #AD0000;
|
||||||
|
--quarto-hl-bn-color: #AD0000;
|
||||||
|
--quarto-hl-al-color: #AD0000;
|
||||||
|
--quarto-hl-va-color: #111111;
|
||||||
|
--quarto-hl-bu-color: inherit;
|
||||||
|
--quarto-hl-ex-color: inherit;
|
||||||
|
--quarto-hl-pp-color: #AD0000;
|
||||||
|
--quarto-hl-in-color: #5E5E5E;
|
||||||
|
--quarto-hl-vs-color: #20794D;
|
||||||
|
--quarto-hl-wa-color: #5E5E5E;
|
||||||
|
--quarto-hl-do-color: #5E5E5E;
|
||||||
|
--quarto-hl-im-color: #00769E;
|
||||||
|
--quarto-hl-ch-color: #20794D;
|
||||||
|
--quarto-hl-dt-color: #AD0000;
|
||||||
|
--quarto-hl-fl-color: #AD0000;
|
||||||
|
--quarto-hl-co-color: #5E5E5E;
|
||||||
|
--quarto-hl-cv-color: #5E5E5E;
|
||||||
|
--quarto-hl-cn-color: #8f5902;
|
||||||
|
--quarto-hl-sc-color: #5E5E5E;
|
||||||
|
--quarto-hl-dv-color: #AD0000;
|
||||||
|
--quarto-hl-kw-color: #003B4F;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* other quarto variables */
|
||||||
|
:root {
|
||||||
|
--quarto-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
|
||||||
|
}
|
||||||
|
|
||||||
|
pre > code.sourceCode > span {
|
||||||
|
color: #003B4F;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span {
|
||||||
|
color: #003B4F;
|
||||||
|
}
|
||||||
|
|
||||||
|
code.sourceCode > span {
|
||||||
|
color: #003B4F;
|
||||||
|
}
|
||||||
|
|
||||||
|
div.sourceCode,
|
||||||
|
div.sourceCode pre.sourceCode {
|
||||||
|
color: #003B4F;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ot {
|
||||||
|
color: #003B4F;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.at {
|
||||||
|
color: #657422;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ss {
|
||||||
|
color: #20794D;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.an {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.fu {
|
||||||
|
color: #4758AB;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.st {
|
||||||
|
color: #20794D;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cf {
|
||||||
|
color: #003B4F;
|
||||||
|
font-weight: bold;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.op {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.er {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.bn {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.al {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.va {
|
||||||
|
color: #111111;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.bu {
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ex {
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.pp {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.in {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.vs {
|
||||||
|
color: #20794D;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.wa {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: italic;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.do {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: italic;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.im {
|
||||||
|
color: #00769E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ch {
|
||||||
|
color: #20794D;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.dt {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.fl {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.co {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cv {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: italic;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cn {
|
||||||
|
color: #8f5902;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.sc {
|
||||||
|
color: #5E5E5E;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.dv {
|
||||||
|
color: #AD0000;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.kw {
|
||||||
|
color: #003B4F;
|
||||||
|
font-weight: bold;
|
||||||
|
font-style: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
.prevent-inlining {
|
||||||
|
content: "</";
|
||||||
|
}
|
||||||
|
|
||||||
|
/*# sourceMappingURL=c9c5d451c23b744f9cb2c98992a0aef2.css.map */
|
||||||
|
|
@ -0,0 +1,189 @@
|
||||||
|
/* quarto syntax highlight colors */
|
||||||
|
:root {
|
||||||
|
--quarto-hl-al-color: #f07178;
|
||||||
|
--quarto-hl-an-color: #d4d0ab;
|
||||||
|
--quarto-hl-at-color: #00e0e0;
|
||||||
|
--quarto-hl-bn-color: #d4d0ab;
|
||||||
|
--quarto-hl-bu-color: #abe338;
|
||||||
|
--quarto-hl-ch-color: #abe338;
|
||||||
|
--quarto-hl-co-color: #f8f8f2;
|
||||||
|
--quarto-hl-cv-color: #ffd700;
|
||||||
|
--quarto-hl-cn-color: #ffd700;
|
||||||
|
--quarto-hl-cf-color: #ffa07a;
|
||||||
|
--quarto-hl-dt-color: #ffa07a;
|
||||||
|
--quarto-hl-dv-color: #d4d0ab;
|
||||||
|
--quarto-hl-do-color: #f8f8f2;
|
||||||
|
--quarto-hl-er-color: #f07178;
|
||||||
|
--quarto-hl-ex-color: #00e0e0;
|
||||||
|
--quarto-hl-fl-color: #d4d0ab;
|
||||||
|
--quarto-hl-fu-color: #ffa07a;
|
||||||
|
--quarto-hl-im-color: #abe338;
|
||||||
|
--quarto-hl-in-color: #d4d0ab;
|
||||||
|
--quarto-hl-kw-color: #ffa07a;
|
||||||
|
--quarto-hl-op-color: #ffa07a;
|
||||||
|
--quarto-hl-ot-color: #00e0e0;
|
||||||
|
--quarto-hl-pp-color: #dcc6e0;
|
||||||
|
--quarto-hl-re-color: #00e0e0;
|
||||||
|
--quarto-hl-sc-color: #abe338;
|
||||||
|
--quarto-hl-ss-color: #abe338;
|
||||||
|
--quarto-hl-st-color: #abe338;
|
||||||
|
--quarto-hl-va-color: #00e0e0;
|
||||||
|
--quarto-hl-vs-color: #abe338;
|
||||||
|
--quarto-hl-wa-color: #dcc6e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* other quarto variables */
|
||||||
|
:root {
|
||||||
|
--quarto-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.al {
|
||||||
|
background-color: #2a0f15;
|
||||||
|
font-weight: bold;
|
||||||
|
color: #f07178;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.an {
|
||||||
|
color: #d4d0ab;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.at {
|
||||||
|
color: #00e0e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.bn {
|
||||||
|
color: #d4d0ab;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.bu {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ch {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.co {
|
||||||
|
font-style: italic;
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cv {
|
||||||
|
color: #ffd700;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cn {
|
||||||
|
color: #ffd700;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.cf {
|
||||||
|
font-weight: bold;
|
||||||
|
color: #ffa07a;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.dt {
|
||||||
|
color: #ffa07a;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.dv {
|
||||||
|
color: #d4d0ab;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.do {
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.er {
|
||||||
|
color: #f07178;
|
||||||
|
text-decoration: underline;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ex {
|
||||||
|
font-weight: bold;
|
||||||
|
color: #00e0e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.fl {
|
||||||
|
color: #d4d0ab;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.fu {
|
||||||
|
color: #ffa07a;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.im {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.in {
|
||||||
|
color: #d4d0ab;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.kw {
|
||||||
|
font-weight: bold;
|
||||||
|
color: #ffa07a;
|
||||||
|
}
|
||||||
|
|
||||||
|
pre > code.sourceCode > span {
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span {
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
code.sourceCode > span {
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
div.sourceCode,
|
||||||
|
div.sourceCode pre.sourceCode {
|
||||||
|
color: #f8f8f2;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.op {
|
||||||
|
color: #ffa07a;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ot {
|
||||||
|
color: #00e0e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.pp {
|
||||||
|
color: #dcc6e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.re {
|
||||||
|
background-color: #f8f8f2;
|
||||||
|
color: #00e0e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.sc {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.ss {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.st {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.va {
|
||||||
|
color: #00e0e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.vs {
|
||||||
|
color: #abe338;
|
||||||
|
}
|
||||||
|
|
||||||
|
code span.wa {
|
||||||
|
color: #dcc6e0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.prevent-inlining {
|
||||||
|
content: "</";
|
||||||
|
}
|
||||||
|
|
||||||
|
/*# sourceMappingURL=358cf41e74b1efa21c8e6dcd38cd2fd6.css.map */
|
||||||
862
_site/sites/codesnippets/AlyxGrab.html
Normal file
862
_site/sites/codesnippets/AlyxGrab.html
Normal file
|
|
@ -0,0 +1,862 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Alyx Grab – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Alyx Grab</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Alyx Grab</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Alyx Grab</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>In Class: <code>BP_TraceController</code> | Based on VREs BP_TeleportTrace</p>
|
||||||
|
<p>To make grabbing more comfortable and accessible, I implemented a pull-grab mechanic inspired by Half Life Alyx. While the VR Expansion Plugin already implements logic for tossing objects towards the player, the template and many other resources rely on a line trace to get the object to toss. This results in multiple problems, above all the player having to aim very precisely and objects blocking each other.</p>
|
||||||
|
<p>To target these issues, I use a multi sphere trace to get all actors in range, saving them to an array. For each, we can check their angle to the hand via the dot product between the hand->forward and hand->object vectors and save them to an array as well. By getting the min of the of the dot product array, we can retrieve the correct object via the index (could’ve also used a map).</p>
|
||||||
|
<p>Function: <code>Trace For Tossable Objects</code></p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/3xy3o_ve/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
<p>Function: <code>Get Angle To Hand</code></p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/o_fr6mlk/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
<p>The trace relies on its own collision channel named TossableTrace, allowing for objects like cabinet doors to block this specific trace. As this blocks access to compartments smaller than the trace, there is a second smaller trace doing the same job (only if larger trace is blocked, might be further optimizable).</p>
|
||||||
|
<p>As it might not favorable for all components on the actor to be tossable, the Item Data Component (originally introduced for the <a href="">Inventory</a>) holds an array of primitive components which are quickly added via a library macro on the respective actor (you can’t choose primitive components via the dropdown on the component).</p>
|
||||||
|
<p>The ribbon between the object and the hand is drawn via a Niagara System getting passed an array of locations. While I was aware of this technique from how the default UE5 VR Template renders its teleport-preview, there is also a <a href="https://www.stevestreeting.com/2025/01/09/niagara-particles-setting-positions-manually/">writeup by Steve Streeting</a> if you need further information.</p>
|
||||||
|
<p>Note: The toss from VRE needs “Simulation Generates Hit Events” enabled to work correctly.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
853
_site/sites/codesnippets/CaptchaDoor.html
Normal file
853
_site/sites/codesnippets/CaptchaDoor.html
Normal file
|
|
@ -0,0 +1,853 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Captcha Door – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/CaptchaDoor.html">Captcha Door</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / Custom AI Controller</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Save Game / SPUD</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/CaptchaDoor.html">Captcha Door</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Captcha Door</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>Example for BlueprintUE</p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
854
_site/sites/codesnippets/CustomAIController.html
Normal file
854
_site/sites/codesnippets/CustomAIController.html
Normal file
|
|
@ -0,0 +1,854 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Follow Spline / AIController – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/CustomAIController.html">Follow Spline / AIController</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/CustomAIController.html">Follow Spline / AIController</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Follow Spline / AIController</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>In Class: <code>CustomAIController</code></p>
|
||||||
|
<p>While Navigation builds on the UE AI Controller / Character Movement with NavMeshes, I wanted to implement a more precise way to control the path a NPC takes. Turns out, Unreal doesn’t seem to have a “Follow Spline” logic inbuilt, which I found to be a bit trickier than expected. It’s currently based of <a href="https://www.youtube.com/watch?v=UIF1PcmZkGA">this Tutorial</a>, which calculates a speed factor from Max Walk Speed and Spline Length and then continuously moves the Actor to the new Point along the Spline at that Value. Adding Jump functionality with this approach added extra complexity as the timeline needs to stop at the correct distance from the Character for the AI not to get confused.</p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
867
_site/sites/codesnippets/GripRobot.html
Normal file
867
_site/sites/codesnippets/GripRobot.html
Normal file
|
|
@ -0,0 +1,867 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Clarice / Grippable Robot – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/GripRobot.html">Clarice / Grippable Robot</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/GripRobot.html">Clarice / Grippable Robot</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Clarice / Grippable Robot</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>What. A. Pain. In Class: <code>BP_Clarice</code></p>
|
||||||
|
<p>For the main NPC that guides the player - Clarice - I wanted a high degree of interactability. This involves grabbing the robot, e.g. to throw them somewhere to solve riddles, use them as a key or other shenanigans. I also wanted them to be rather flexible when it comes to locomotion (Walk / Fly / Jump / Roll) for it to able to follow the player anywhere.</p>
|
||||||
|
<p>Here are some learning from implementing: - Your characters physics asset NEEDS a root Body. I personally still struggle with Physics Assets. -</p>
|
||||||
|
<div class="callout callout-style-default callout-note callout-titled">
|
||||||
|
<div class="callout-header d-flex align-content-center">
|
||||||
|
<div class="callout-icon-container">
|
||||||
|
<i class="callout-icon"></i>
|
||||||
|
</div>
|
||||||
|
<div class="callout-title-container flex-fill">
|
||||||
|
Thank you
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="callout-body-container callout-body">
|
||||||
|
<p>A big thank you to Joshua “MordenTral” Statzer (Developer of the VREP) who took personal time to look into my issues with grabbing Skeletal Meshes. The first and only time someone helped me out personally in this project, and also doing so in their free time.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
854
_site/sites/codesnippets/Inventory.html
Normal file
854
_site/sites/codesnippets/Inventory.html
Normal file
|
|
@ -0,0 +1,854 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Inventory – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/Inventory.html">Inventory</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / Custom AI Controller</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slice Game</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Save Game / SPUD</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/Inventory.html">Inventory</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Inventory</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>The Inventory uses a scalable, circular array of widget components the user can put objects in and draw objects out. When the inventory is opened, the player moves their hand towards a widget, which then gets activated. Depending of the content of the widget and content of the hand, an action (put in, pull out, replace) is triggered on inventory close. Compared to <a href="https://www.youtube.com/watch?v=YE0sfJyraws">approaches based on a line trace/widget interactor</a>, I use the distance to the hand for a quicker and “sloppier” interaction.</p>
|
||||||
|
<p>Item Data is handled via an Item Data Component, following the guidance of <a href="https://www.youtube.com/watch?v=vHT4MhmwacE&list=PL4G2bSPE_8umjCYXbq0v5IoV-Wi_WAxC3&index=1">Ryan Laleys Inventory System Tutorial Series</a>. The Item Data is drawn from a Data Table.</p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2025, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
855
_site/sites/codesnippets/MainMenu.html
Normal file
855
_site/sites/codesnippets/MainMenu.html
Normal file
|
|
@ -0,0 +1,855 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Main Menu – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/MainMenu.html">Main Menu</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / Custom AI Controller</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slice Game</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Save Game / SPUD</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/MainMenu.html">Main Menu</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Main Menu</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>In Class: <code>BP_MainMenu</code></p>
|
||||||
|
<p>The main menu is composed of several widget components in 3D-Space. The Widget Index defines the depth of the menu, e.g. the widget showing the Audio Settings Widget is accessed from Settings (from Main at Index 0) -> Audio (from Settings at Index -1) -> Audio Widget (at Index -2). Opening a new Menu causes all Widget Indices to increment. Widget with an Index lower than 0 gets collapsed, Widgets with an Index greater 0 get disabled and only at Index 0, the Widget is enabled. On disabled widgets, the last pressed button is altered visually which also gets reset at Index 0.</p>
|
||||||
|
<p>All Widget Buttons inherit from the same widget class implementing an enum to save the button function. The button actions are centralized by binding to a custom event dispatcher on the click event, passing the enum to the BP_MainMenu. From there, we can switch on enum and handle the respective functionality. The main thing we need to do manually is running the UpdateIndices Function to increment and making the correct Widget visible (we can’t do this automatically as there are multiple Widgets with the same Index).</p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2025, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
869
_site/sites/codesnippets/MovablesSoundComponent.html
Normal file
869
_site/sites/codesnippets/MovablesSoundComponent.html
Normal file
|
|
@ -0,0 +1,869 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Movables Sound Component – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/MovablesSoundComponent.html">Movables Sound Component</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/MovablesSoundComponent.html">Movables Sound Component</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Movables Sound Component</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>In Class: <code>MovablesSoundComponent</code></p>
|
||||||
|
<p>This Component is an Actor Component to designed to be attached to Actors that generate Sounds based on their physical movement. This includes standalone objects like a ball or components like drawers in cabinet.</p>
|
||||||
|
<p><strong>Detecting Hit and Slide Movements</strong></p>
|
||||||
|
<p>When one object hit another, we expect it to make some kind of hit sound, depending on their qualities (size, material, surface texture etc.) and the hit velocity. A special case is dragging an object across a surface. Although this causes repetitive hits, we don’t expect the Hit Sound to be played repetitively but a dedicated “slide sound”. To check wether a Hit Event from the simulation should trigger a Hit Sound or a Slide Sound, we can use the velocity vector of the hit component and compare it to to the Hit Normal Vector. When we slide across a surface, the velocity is perpendicular to the impact normal. Using acosd, you can convert the dot product to an angle, which can be easier to work with. Based on an Angle Threshold, you can decide whether a slide should be considered a slide.</p>
|
||||||
|
<div class="callout callout-style-default callout-note callout-titled">
|
||||||
|
<div class="callout-header d-flex align-content-center">
|
||||||
|
<div class="callout-icon-container">
|
||||||
|
<i class="callout-icon"></i>
|
||||||
|
</div>
|
||||||
|
<div class="callout-title-container flex-fill">
|
||||||
|
A thought
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="callout-body-container callout-body">
|
||||||
|
<p>Now that I’m writing it down, you could also make the Threshold depending on the velocity, resulting in slow movements to be more susceptible to “clonks”</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/a6syaqcp/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
868
_site/sites/codesnippets/SaveGame_SPUD.html
Normal file
868
_site/sites/codesnippets/SaveGame_SPUD.html
Normal file
|
|
@ -0,0 +1,868 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>SPUD / Save Games – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/SaveGame_SPUD.html">SPUD / Save Games</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/SaveGame_SPUD.html">SPUD / Save Games</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">SPUD / Save Games</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<p>To handle SaveGames and Persistence in Level Streaming, <a href="https://github.com/sinbad/SPUD/issues">SPUD</a> is used. The WB_CustomSaveLoadScreen used in the <a href="">Main Menu</a> is largely based of the <a href="https://github.com/sinbad/SPUDExamples">SPUD Examples</a> SaveLoadScreen Widget.</p>
|
||||||
|
<p>Most Variables are passed to the GameInstance, which is especially important for variables that need to exist before the game is loaded, e.g. on the initial Main Menu Map.</p>
|
||||||
|
<div class="callout callout-style-default callout-note callout-titled">
|
||||||
|
<div class="callout-header d-flex align-content-center">
|
||||||
|
<div class="callout-icon-container">
|
||||||
|
<i class="callout-icon"></i>
|
||||||
|
</div>
|
||||||
|
<div class="callout-title-container flex-fill">
|
||||||
|
Note
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="callout-body-container callout-body">
|
||||||
|
<p>Saving the GameInstance with SPUD via BP should’ve been be very straight forward, but I was stuck there for multiple days. Eventually I opened up a <a href="https://github.com/sinbad/SPUD/issues/139">Github-Issue</a> and it was confirmed that the SPUD Subsystem is not ready on Event Init of the BP GameInstance. I went on implementing going the C++ way, <a href="https://github.com/sinbad/SPUD/commit/416122438c33f1f7d77d0c319876bf763e58db33">but a delay until the Subsystem is ready should fix that</a>.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<p>Pulling Actors into the persistent Levels</p>
|
||||||
|
<p>As a lot objects in VR are interactible and can therefore easily be moved by the player, it’s possible that movable objects leave their streaming level boundary and get despawned when their owning level is unloaded. We have to possibilities to fix that: Having all those objects on the persistent level by default, which isn’t ideal from an optimization perspective, or move them to the persistent level when the player actually interacts with them. From my knowledge, there is no <em>proper</em> way of changing the owning level at runtime but destroying and respawning the actor, which isn’t always ideal.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
901
_site/sites/codesnippets/Slicegame.html
Normal file
901
_site/sites/codesnippets/Slicegame.html
Normal file
|
|
@ -0,0 +1,901 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
|
<title>Slicegame – Docs</title>
|
||||||
|
<style>
|
||||||
|
code{white-space: pre-wrap;}
|
||||||
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||||||
|
div.column{flex: auto; overflow-x: auto;}
|
||||||
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||||||
|
ul.task-list{list-style: none;}
|
||||||
|
ul.task-list li input[type="checkbox"] {
|
||||||
|
width: 0.8em;
|
||||||
|
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
|
||||||
|
vertical-align: middle;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
|
||||||
|
<script src="../../site_libs/quarto-nav/quarto-nav.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-nav/headroom.min.js"></script>
|
||||||
|
<script src="../../site_libs/clipboard/clipboard.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/autocomplete.umd.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
|
<meta name="quarto:offset" content="../../">
|
||||||
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
|
<script src="../../site_libs/quarto-contrib/glightbox/glightbox.min.js"></script>
|
||||||
|
<link href="../../site_libs/quarto-contrib/glightbox/glightbox.min.css" rel="stylesheet">
|
||||||
|
<link href="../../site_libs/quarto-contrib/glightbox/lightbox.css" rel="stylesheet">
|
||||||
|
<script id="quarto-search-options" type="application/json">{
|
||||||
|
"location": "navbar",
|
||||||
|
"copy-button": false,
|
||||||
|
"collapse-after": 3,
|
||||||
|
"panel-placement": "end",
|
||||||
|
"type": "overlay",
|
||||||
|
"limit": 50,
|
||||||
|
"keyboard-shortcut": [
|
||||||
|
"f",
|
||||||
|
"/",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"show-item-context": false,
|
||||||
|
"language": {
|
||||||
|
"search-no-results-text": "No results",
|
||||||
|
"search-matching-documents-text": "matching documents",
|
||||||
|
"search-copy-link-title": "Copy link to search",
|
||||||
|
"search-hide-matches-text": "Hide additional matches",
|
||||||
|
"search-more-match-text": "more match in this document",
|
||||||
|
"search-more-matches-text": "more matches in this document",
|
||||||
|
"search-clear-button-title": "Clear",
|
||||||
|
"search-text-placeholder": "",
|
||||||
|
"search-detached-cancel-button-title": "Cancel",
|
||||||
|
"search-submit-button-title": "Submit",
|
||||||
|
"search-label": "Search"
|
||||||
|
}
|
||||||
|
}</script>
|
||||||
|
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
|
|
||||||
|
<div id="quarto-search-results"></div>
|
||||||
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
<nav class="navbar navbar-expand-lg " data-bs-theme="dark">
|
||||||
|
<div class="navbar-container container-fluid">
|
||||||
|
<div class="navbar-brand-container mx-auto">
|
||||||
|
<a href="../../index.html" class="navbar-brand navbar-brand-logo">
|
||||||
|
<img src="../../img/Logo.png" alt="" class="navbar-logo">
|
||||||
|
</a>
|
||||||
|
<a class="navbar-brand" href="../../index.html">
|
||||||
|
<span class="navbar-title">Docs</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
<div class="collapse navbar-collapse" id="navbarCollapse">
|
||||||
|
<ul class="navbar-nav navbar-nav-scroll me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="https://virtuos.world">
|
||||||
|
<span class="menu-text">Homepage</span></a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div> <!-- /navcollapse -->
|
||||||
|
<div class="quarto-navbar-tools">
|
||||||
|
<a href="" class="quarto-color-scheme-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleColorScheme(); return false;" title="Toggle dark mode"><i class="bi"></i></a>
|
||||||
|
</div>
|
||||||
|
</div> <!-- /container-fluid -->
|
||||||
|
</nav>
|
||||||
|
<nav class="quarto-secondary-nav">
|
||||||
|
<div class="container-fluid d-flex">
|
||||||
|
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||||
|
</button>
|
||||||
|
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/Slicegame.html">Slicegame</a></li></ol></nav>
|
||||||
|
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
|
||||||
|
<i class="bi bi-search"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
</header>
|
||||||
|
<!-- content -->
|
||||||
|
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar">
|
||||||
|
<!-- sidebar -->
|
||||||
|
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||||
|
<div class="mt-2 flex-shrink-0 align-items-center">
|
||||||
|
<div class="sidebar-search">
|
||||||
|
<div id="quarto-search" class="" title="Search"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="sidebar-menu-container">
|
||||||
|
<ul class="list-unstyled mt-1">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../index.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Overview</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Get Started</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/getstarted.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Project Setup</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item sidebar-item-section">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true">
|
||||||
|
<span class="menu-text">Code Snippets</span></a>
|
||||||
|
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section">
|
||||||
|
<i class="bi bi-chevron-right ms-2"></i>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link active">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/webservices.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Webservices</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../../sites/styleguide.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Styleguide</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div>
|
||||||
|
<!-- margin-sidebar -->
|
||||||
|
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<!-- main -->
|
||||||
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/AlyxGrab.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/Slicegame.html">Slicegame</a></li></ol></nav>
|
||||||
|
<div class="quarto-title">
|
||||||
|
<h1 class="title">Slicegame</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="quarto-title-meta">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</header>
|
||||||
|
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
<p>The Slicegame is my attempt at implementing a <a href="https://beatsaber.com/">Beatsaber</a>-Style Rhythm-Game. It explores Unreals Harmonix Plugin for parsing Midi in Metasounds and Geometry Script for real time boolean operations.</p>
|
||||||
|
<p>Given a Midi File, the system in <code>BP_DynamicObjectSpawner</code> spawns instances from the class <code>BP_DynamicHitObject</code> (the thing you want to hit) on a 3x3 Grid, moves them towards a location over time so it’s always at to correct location (PlayerPosition + ArmLength) on the beat. The Midi also encodes from which direction the HitObject should be hit and saved in an Enum in the class during spawn.</p>
|
||||||
|
<div class="quarto-figure quarto-figure-center">
|
||||||
|
<figure class="figure">
|
||||||
|
<p><a href="../../img/Midi.png" class="lightbox" data-gallery="quarto-lightbox-gallery-1" title="Midi Setup in Reaper"><img src="../../img/Midi.png" class="img-fluid figure-img" alt="Midi Setup in Reaper"></a></p>
|
||||||
|
<figcaption>Midi Setup in Reaper</figcaption>
|
||||||
|
</figure>
|
||||||
|
</div>
|
||||||
|
<p>Correct Hit detection to me several approaches, its a bit tricky because while our objects (or rather their hit indictors) don’t move relative to the character, their angle to the player does change when the objects move from front to back while the player forwards or sideways. The hit detection therefore needs to take the characters view vector into account. From there, you can create up and right vectors and compare them direction of the sword via the dot product.</p>
|
||||||
|
<p>In Class : <code>BP_DynamicHitObject</code> | Function: <code>GetHitType</code></p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/kxu6x76k/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
<p>As both velocity (sword is wiggly) and impact normal (surface doesn’t always point in hit direction) vectors you can get from the hit event turned out to be rather unreliable for detection sword direction, I went with sampling the impact point on hit, attaching that point to the sword by converting the location into the relative space of the sword. After a short delay, that point, virtually attached to sword, has moved. By converting that point back to world transform, we can calculate the direction by subtracting hit location and delay sampled location. This works quite reliably.</p>
|
||||||
|
<p>In Class : <code>BP_DynamicHitObject</code></p>
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/1g36zapg/" scrolling="no" allowfullscreen=""></iframe>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</main> <!-- /main -->
|
||||||
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
|
const a = window.document.createElement('a');
|
||||||
|
a.classList.add('top-right');
|
||||||
|
a.classList.add('quarto-color-scheme-toggle');
|
||||||
|
a.href = "";
|
||||||
|
a.onclick = function() { try { window.quartoToggleColorScheme(); } catch {} return false; };
|
||||||
|
const i = window.document.createElement("i");
|
||||||
|
i.classList.add('bi');
|
||||||
|
a.appendChild(i);
|
||||||
|
window.document.body.appendChild(a);
|
||||||
|
}
|
||||||
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
|
const icon = "";
|
||||||
|
const anchorJS = new window.AnchorJS();
|
||||||
|
anchorJS.options = {
|
||||||
|
placement: 'right',
|
||||||
|
icon: icon
|
||||||
|
};
|
||||||
|
anchorJS.add('.anchored');
|
||||||
|
const isCodeAnnotation = (el) => {
|
||||||
|
for (const clz of el.classList) {
|
||||||
|
if (clz.startsWith('code-annotation-')) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const onCopySuccess = function(e) {
|
||||||
|
// button target
|
||||||
|
const button = e.trigger;
|
||||||
|
// don't keep focus
|
||||||
|
button.blur();
|
||||||
|
// flash "checked"
|
||||||
|
button.classList.add('code-copy-button-checked');
|
||||||
|
var currentTitle = button.getAttribute("title");
|
||||||
|
button.setAttribute("title", "Copied!");
|
||||||
|
let tooltip;
|
||||||
|
if (window.bootstrap) {
|
||||||
|
button.setAttribute("data-bs-toggle", "tooltip");
|
||||||
|
button.setAttribute("data-bs-placement", "left");
|
||||||
|
button.setAttribute("data-bs-title", "Copied!");
|
||||||
|
tooltip = new bootstrap.Tooltip(button,
|
||||||
|
{ trigger: "manual",
|
||||||
|
customClass: "code-copy-button-tooltip",
|
||||||
|
offset: [0, -8]});
|
||||||
|
tooltip.show();
|
||||||
|
}
|
||||||
|
setTimeout(function() {
|
||||||
|
if (tooltip) {
|
||||||
|
tooltip.hide();
|
||||||
|
button.removeAttribute("data-bs-title");
|
||||||
|
button.removeAttribute("data-bs-toggle");
|
||||||
|
button.removeAttribute("data-bs-placement");
|
||||||
|
}
|
||||||
|
button.setAttribute("title", currentTitle);
|
||||||
|
button.classList.remove('code-copy-button-checked');
|
||||||
|
}, 1000);
|
||||||
|
// clear code selection
|
||||||
|
e.clearSelection();
|
||||||
|
}
|
||||||
|
const getTextToCopy = function(trigger) {
|
||||||
|
const codeEl = trigger.previousElementSibling.cloneNode(true);
|
||||||
|
for (const childEl of codeEl.children) {
|
||||||
|
if (isCodeAnnotation(childEl)) {
|
||||||
|
childEl.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return codeEl.innerText;
|
||||||
|
}
|
||||||
|
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
|
||||||
|
text: getTextToCopy
|
||||||
|
});
|
||||||
|
clipboard.on('success', onCopySuccess);
|
||||||
|
if (window.document.getElementById('quarto-embedded-source-code-modal')) {
|
||||||
|
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
|
||||||
|
text: getTextToCopy,
|
||||||
|
container: window.document.getElementById('quarto-embedded-source-code-modal')
|
||||||
|
});
|
||||||
|
clipboardModal.on('success', onCopySuccess);
|
||||||
|
}
|
||||||
|
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
|
||||||
|
var mailtoRegex = new RegExp(/^mailto:/);
|
||||||
|
var filterRegex = new RegExp('/' + window.location.host + '/');
|
||||||
|
var isInternal = (href) => {
|
||||||
|
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
|
||||||
|
}
|
||||||
|
// Inspect non-navigation links and adorn them if external
|
||||||
|
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
|
||||||
|
for (var i=0; i<links.length; i++) {
|
||||||
|
const link = links[i];
|
||||||
|
if (!isInternal(link.href)) {
|
||||||
|
// undo the damage that might have been done by quarto-nav.js in the case of
|
||||||
|
// links that we want to consider external
|
||||||
|
if (link.dataset.originalHref !== undefined) {
|
||||||
|
link.href = link.dataset.originalHref;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
|
||||||
|
const config = {
|
||||||
|
allowHTML: true,
|
||||||
|
maxWidth: 500,
|
||||||
|
delay: 100,
|
||||||
|
arrow: false,
|
||||||
|
appendTo: function(el) {
|
||||||
|
return el.parentElement;
|
||||||
|
},
|
||||||
|
interactive: true,
|
||||||
|
interactiveBorder: 10,
|
||||||
|
theme: 'quarto',
|
||||||
|
placement: 'bottom-start',
|
||||||
|
};
|
||||||
|
if (contentFn) {
|
||||||
|
config.content = contentFn;
|
||||||
|
}
|
||||||
|
if (onTriggerFn) {
|
||||||
|
config.onTrigger = onTriggerFn;
|
||||||
|
}
|
||||||
|
if (onUntriggerFn) {
|
||||||
|
config.onUntrigger = onUntriggerFn;
|
||||||
|
}
|
||||||
|
window.tippy(el, config);
|
||||||
|
}
|
||||||
|
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
|
||||||
|
for (var i=0; i<noterefs.length; i++) {
|
||||||
|
const ref = noterefs[i];
|
||||||
|
tippyHover(ref, function() {
|
||||||
|
// use id or data attribute instead here
|
||||||
|
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
|
||||||
|
try { href = new URL(href).hash; } catch {}
|
||||||
|
const id = href.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note) {
|
||||||
|
return note.innerHTML;
|
||||||
|
} else {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const xrefs = window.document.querySelectorAll('a.quarto-xref');
|
||||||
|
const processXRef = (id, note) => {
|
||||||
|
// Strip column container classes
|
||||||
|
const stripColumnClz = (el) => {
|
||||||
|
el.classList.remove("page-full", "page-columns");
|
||||||
|
if (el.children) {
|
||||||
|
for (const child of el.children) {
|
||||||
|
stripColumnClz(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stripColumnClz(note)
|
||||||
|
if (id === null || id.startsWith('sec-')) {
|
||||||
|
// Special case sections, only their first couple elements
|
||||||
|
const container = document.createElement("div");
|
||||||
|
if (note.children && note.children.length > 2) {
|
||||||
|
container.appendChild(note.children[0].cloneNode(true));
|
||||||
|
for (let i = 1; i < note.children.length; i++) {
|
||||||
|
const child = note.children[i];
|
||||||
|
if (child.tagName === "P" && child.innerText === "") {
|
||||||
|
continue;
|
||||||
|
} else {
|
||||||
|
container.appendChild(child.cloneNode(true));
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(container);
|
||||||
|
}
|
||||||
|
return container.innerHTML
|
||||||
|
} else {
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Remove any anchor links if they are present
|
||||||
|
const anchorLink = note.querySelector('a.anchorjs-link');
|
||||||
|
if (anchorLink) {
|
||||||
|
anchorLink.remove();
|
||||||
|
}
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(note);
|
||||||
|
}
|
||||||
|
if (note.classList.contains("callout")) {
|
||||||
|
return note.outerHTML;
|
||||||
|
} else {
|
||||||
|
return note.innerHTML;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (var i=0; i<xrefs.length; i++) {
|
||||||
|
const xref = xrefs[i];
|
||||||
|
tippyHover(xref, undefined, function(instance) {
|
||||||
|
instance.disable();
|
||||||
|
let url = xref.getAttribute('href');
|
||||||
|
let hash = undefined;
|
||||||
|
if (url.startsWith('#')) {
|
||||||
|
hash = url;
|
||||||
|
} else {
|
||||||
|
try { hash = new URL(url).hash; } catch {}
|
||||||
|
}
|
||||||
|
if (hash) {
|
||||||
|
const id = hash.replace(/^#\/?/, "");
|
||||||
|
const note = window.document.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
try {
|
||||||
|
const html = processXRef(id, note.cloneNode(true));
|
||||||
|
instance.setContent(html);
|
||||||
|
} finally {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch this
|
||||||
|
fetch(url.split('#')[0])
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.getElementById(id);
|
||||||
|
if (note !== null) {
|
||||||
|
const html = processXRef(id, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// See if we can fetch a full url (with no hash to target)
|
||||||
|
// This is a special case and we should probably do some content thinning / targeting
|
||||||
|
fetch(url)
|
||||||
|
.then(res => res.text())
|
||||||
|
.then(html => {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
const htmlDoc = parser.parseFromString(html, "text/html");
|
||||||
|
const note = htmlDoc.querySelector('main.content');
|
||||||
|
if (note !== null) {
|
||||||
|
// This should only happen for chapter cross references
|
||||||
|
// (since there is no id in the URL)
|
||||||
|
// remove the first header
|
||||||
|
if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
|
||||||
|
note.children[0].remove();
|
||||||
|
}
|
||||||
|
const html = processXRef(null, note);
|
||||||
|
instance.setContent(html);
|
||||||
|
}
|
||||||
|
}).finally(() => {
|
||||||
|
instance.enable();
|
||||||
|
instance.show();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}, function(instance) {
|
||||||
|
});
|
||||||
|
}
|
||||||
|
let selectedAnnoteEl;
|
||||||
|
const selectorForAnnotation = ( cell, annotation) => {
|
||||||
|
let cellAttr = 'data-code-cell="' + cell + '"';
|
||||||
|
let lineAttr = 'data-code-annotation="' + annotation + '"';
|
||||||
|
const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
|
||||||
|
return selector;
|
||||||
|
}
|
||||||
|
const selectCodeLines = (annoteEl) => {
|
||||||
|
const doc = window.document;
|
||||||
|
const targetCell = annoteEl.getAttribute("data-target-cell");
|
||||||
|
const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
|
||||||
|
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
|
||||||
|
const lines = annoteSpan.getAttribute("data-code-lines").split(",");
|
||||||
|
const lineIds = lines.map((line) => {
|
||||||
|
return targetCell + "-" + line;
|
||||||
|
})
|
||||||
|
let top = null;
|
||||||
|
let height = null;
|
||||||
|
let parent = null;
|
||||||
|
if (lineIds.length > 0) {
|
||||||
|
//compute the position of the single el (top and bottom and make a div)
|
||||||
|
const el = window.document.getElementById(lineIds[0]);
|
||||||
|
top = el.offsetTop;
|
||||||
|
height = el.offsetHeight;
|
||||||
|
parent = el.parentElement.parentElement;
|
||||||
|
if (lineIds.length > 1) {
|
||||||
|
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
|
||||||
|
const bottom = lastEl.offsetTop + lastEl.offsetHeight;
|
||||||
|
height = bottom - top;
|
||||||
|
}
|
||||||
|
if (top !== null && height !== null && parent !== null) {
|
||||||
|
// cook up a div (if necessary) and position it
|
||||||
|
let div = window.document.getElementById("code-annotation-line-highlight");
|
||||||
|
if (div === null) {
|
||||||
|
div = window.document.createElement("div");
|
||||||
|
div.setAttribute("id", "code-annotation-line-highlight");
|
||||||
|
div.style.position = 'absolute';
|
||||||
|
parent.appendChild(div);
|
||||||
|
}
|
||||||
|
div.style.top = top - 2 + "px";
|
||||||
|
div.style.height = height + 4 + "px";
|
||||||
|
div.style.left = 0;
|
||||||
|
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
|
||||||
|
if (gutterDiv === null) {
|
||||||
|
gutterDiv = window.document.createElement("div");
|
||||||
|
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
|
||||||
|
gutterDiv.style.position = 'absolute';
|
||||||
|
const codeCell = window.document.getElementById(targetCell);
|
||||||
|
const gutter = codeCell.querySelector('.code-annotation-gutter');
|
||||||
|
gutter.appendChild(gutterDiv);
|
||||||
|
}
|
||||||
|
gutterDiv.style.top = top - 2 + "px";
|
||||||
|
gutterDiv.style.height = height + 4 + "px";
|
||||||
|
}
|
||||||
|
selectedAnnoteEl = annoteEl;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
const unselectCodeLines = () => {
|
||||||
|
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
|
||||||
|
elementsIds.forEach((elId) => {
|
||||||
|
const div = window.document.getElementById(elId);
|
||||||
|
if (div) {
|
||||||
|
div.remove();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
selectedAnnoteEl = undefined;
|
||||||
|
};
|
||||||
|
// Handle positioning of the toggle
|
||||||
|
window.addEventListener(
|
||||||
|
"resize",
|
||||||
|
throttle(() => {
|
||||||
|
elRect = undefined;
|
||||||
|
if (selectedAnnoteEl) {
|
||||||
|
selectCodeLines(selectedAnnoteEl);
|
||||||
|
}
|
||||||
|
}, 10)
|
||||||
|
);
|
||||||
|
function throttle(fn, ms) {
|
||||||
|
let throttle = false;
|
||||||
|
let timer;
|
||||||
|
return (...args) => {
|
||||||
|
if(!throttle) { // first call gets through
|
||||||
|
fn.apply(this, args);
|
||||||
|
throttle = true;
|
||||||
|
} else { // all the others get throttled
|
||||||
|
if(timer) clearTimeout(timer); // cancel #2
|
||||||
|
timer = setTimeout(() => {
|
||||||
|
fn.apply(this, args);
|
||||||
|
timer = throttle = false;
|
||||||
|
}, ms);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
// Attach click handler to the DT
|
||||||
|
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
|
||||||
|
for (const annoteDlNode of annoteDls) {
|
||||||
|
annoteDlNode.addEventListener('click', (event) => {
|
||||||
|
const clickedEl = event.target;
|
||||||
|
if (clickedEl !== selectedAnnoteEl) {
|
||||||
|
unselectCodeLines();
|
||||||
|
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
|
||||||
|
if (activeEl) {
|
||||||
|
activeEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
selectCodeLines(clickedEl);
|
||||||
|
clickedEl.classList.add('code-annotation-active');
|
||||||
|
} else {
|
||||||
|
// Unselect the line
|
||||||
|
unselectCodeLines();
|
||||||
|
clickedEl.classList.remove('code-annotation-active');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const findCites = (el) => {
|
||||||
|
const parentEl = el.parentElement;
|
||||||
|
if (parentEl) {
|
||||||
|
const cites = parentEl.dataset.cites;
|
||||||
|
if (cites) {
|
||||||
|
return {
|
||||||
|
el,
|
||||||
|
cites: cites.split(' ')
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return findCites(el.parentElement)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
|
||||||
|
for (var i=0; i<bibliorefs.length; i++) {
|
||||||
|
const ref = bibliorefs[i];
|
||||||
|
const citeInfo = findCites(ref);
|
||||||
|
if (citeInfo) {
|
||||||
|
tippyHover(citeInfo.el, function() {
|
||||||
|
var popup = window.document.createElement('div');
|
||||||
|
citeInfo.cites.forEach(function(cite) {
|
||||||
|
var citeDiv = window.document.createElement('div');
|
||||||
|
citeDiv.classList.add('hanging-indent');
|
||||||
|
citeDiv.classList.add('csl-entry');
|
||||||
|
var biblioDiv = window.document.getElementById('ref-' + cite);
|
||||||
|
if (biblioDiv) {
|
||||||
|
citeDiv.innerHTML = biblioDiv.innerHTML;
|
||||||
|
}
|
||||||
|
popup.appendChild(citeDiv);
|
||||||
|
});
|
||||||
|
return popup.innerHTML;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</div> <!-- /content -->
|
||||||
|
<footer class="footer">
|
||||||
|
<div class="nav-footer">
|
||||||
|
<div class="nav-footer-left">
|
||||||
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<div class="nav-footer-right">
|
||||||
|
<ul class="footer-items list-unstyled">
|
||||||
|
<li class="nav-item compact">
|
||||||
|
<a class="nav-link" href="https://mastodon.gamedev.place/@sciencedev">
|
||||||
|
<i class="bi bi-mastodon" role="img">
|
||||||
|
</i>
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</footer>
|
||||||
|
<script>var lightboxQuarto = GLightbox({"closeEffect":"zoom","descPosition":"bottom","loop":false,"openEffect":"zoom","selector":".lightbox"});
|
||||||
|
(function() {
|
||||||
|
let previousOnload = window.onload;
|
||||||
|
window.onload = () => {
|
||||||
|
if (previousOnload) {
|
||||||
|
previousOnload();
|
||||||
|
}
|
||||||
|
lightboxQuarto.on('slide_before_load', (data) => {
|
||||||
|
const { slideIndex, slideNode, slideConfig, player, trigger } = data;
|
||||||
|
const href = trigger.getAttribute('href');
|
||||||
|
if (href !== null) {
|
||||||
|
const imgEl = window.document.querySelector(`a[href="${href}"] img`);
|
||||||
|
if (imgEl !== null) {
|
||||||
|
const srcAttr = imgEl.getAttribute("src");
|
||||||
|
if (srcAttr && srcAttr.startsWith("data:")) {
|
||||||
|
slideConfig.href = srcAttr;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
lightboxQuarto.on('slide_after_load', (data) => {
|
||||||
|
const { slideIndex, slideNode, slideConfig, player, trigger } = data;
|
||||||
|
if (window.Quarto?.typesetMath) {
|
||||||
|
window.Quarto.typesetMath(slideNode);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
};
|
||||||
|
|
||||||
|
})();
|
||||||
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body></html>
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<meta name="generator" content="quarto-1.7.33">
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
@ -30,18 +30,17 @@ ul.task-list li input[type="checkbox"] {
|
||||||
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
<script src="../../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
<script src="../../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
<meta name="quarto:offset" content="../../">
|
<meta name="quarto:offset" content="../../">
|
||||||
<script src="../../site_libs/quarto-html/quarto.js" type="module"></script>
|
<script src="../../site_libs/quarto-html/quarto.js"></script>
|
||||||
<script src="../../site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
|
||||||
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
<script src="../../site_libs/quarto-html/popper.min.js"></script>
|
||||||
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
<script src="../../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
<script src="../../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
<link href="../../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-ea385d0e468b0dd5ea5bf0780b1290d9.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-bc185b5c5bdbcb35c2eb49d8a876ef70.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
<link href="../../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
<script src="../../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
<link href="../../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
<link href="../../site_libs/bootstrap/bootstrap-32fa625705450195742079e70094aa8d.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
<link href="../../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
<link href="../../site_libs/bootstrap/bootstrap-dark-b23b6ab41e2233570f882a9525eb7ac9.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
<link href="../../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
<script id="quarto-search-options" type="application/json">{
|
<script id="quarto-search-options" type="application/json">{
|
||||||
"location": "navbar",
|
"location": "navbar",
|
||||||
"copy-button": false,
|
"copy-button": false,
|
||||||
|
|
@ -73,167 +72,7 @@ ul.task-list li input[type="checkbox"] {
|
||||||
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body class="nav-sidebar docked nav-fixed quarto-dark"><script id="quarto-html-before-body" type="application/javascript">
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
const toggleBodyColorMode = (bsSheetEl) => {
|
|
||||||
const mode = bsSheetEl.getAttribute("data-mode");
|
|
||||||
const bodyEl = window.document.querySelector("body");
|
|
||||||
if (mode === "dark") {
|
|
||||||
bodyEl.classList.add("quarto-dark");
|
|
||||||
bodyEl.classList.remove("quarto-light");
|
|
||||||
} else {
|
|
||||||
bodyEl.classList.add("quarto-light");
|
|
||||||
bodyEl.classList.remove("quarto-dark");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleBodyColorPrimary = () => {
|
|
||||||
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])");
|
|
||||||
if (bsSheetEl) {
|
|
||||||
toggleBodyColorMode(bsSheetEl);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setColorSchemeToggle = (alternate) => {
|
|
||||||
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
|
||||||
for (let i=0; i < toggles.length; i++) {
|
|
||||||
const toggle = toggles[i];
|
|
||||||
if (toggle) {
|
|
||||||
if (alternate) {
|
|
||||||
toggle.classList.add("alternate");
|
|
||||||
} else {
|
|
||||||
toggle.classList.remove("alternate");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const toggleColorMode = (alternate) => {
|
|
||||||
// Switch the stylesheets
|
|
||||||
const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
|
|
||||||
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
|
||||||
if (alternate) {
|
|
||||||
// note: dark is layered on light, we don't disable primary!
|
|
||||||
enableStylesheet(alternateStylesheets);
|
|
||||||
for (const sheetNode of alternateStylesheets) {
|
|
||||||
if (sheetNode.id === "quarto-bootstrap") {
|
|
||||||
toggleBodyColorMode(sheetNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
disableStylesheet(alternateStylesheets);
|
|
||||||
enableStylesheet(primaryStylesheets)
|
|
||||||
toggleBodyColorPrimary();
|
|
||||||
}
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
|
||||||
// Switch the toggles
|
|
||||||
setColorSchemeToggle(alternate)
|
|
||||||
// Hack to workaround the fact that safari doesn't
|
|
||||||
// properly recolor the scrollbar when toggling (#1455)
|
|
||||||
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
|
||||||
manageTransitions("body", false);
|
|
||||||
window.scrollTo(0, 1);
|
|
||||||
setTimeout(() => {
|
|
||||||
window.scrollTo(0, 0);
|
|
||||||
manageTransitions("body", true);
|
|
||||||
}, 40);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const disableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
stylesheet.rel = 'disabled-stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const enableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check
|
|
||||||
stylesheet.rel = 'stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const manageTransitions = (selector, allowTransitions) => {
|
|
||||||
const els = window.document.querySelectorAll(selector);
|
|
||||||
for (let i=0; i < els.length; i++) {
|
|
||||||
const el = els[i];
|
|
||||||
if (allowTransitions) {
|
|
||||||
el.classList.remove('notransition');
|
|
||||||
} else {
|
|
||||||
el.classList.add('notransition');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const isFileUrl = () => {
|
|
||||||
return window.location.protocol === 'file:';
|
|
||||||
}
|
|
||||||
const hasAlternateSentinel = () => {
|
|
||||||
let styleSentinel = getColorSchemeSentinel();
|
|
||||||
if (styleSentinel !== null) {
|
|
||||||
return styleSentinel === "alternate";
|
|
||||||
} else {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setStyleSentinel = (alternate) => {
|
|
||||||
const value = alternate ? "alternate" : "default";
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
window.localStorage.setItem("quarto-color-scheme", value);
|
|
||||||
} else {
|
|
||||||
localAlternateSentinel = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const getColorSchemeSentinel = () => {
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
|
||||||
return storageValue != null ? storageValue : localAlternateSentinel;
|
|
||||||
} else {
|
|
||||||
return localAlternateSentinel;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
|
||||||
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
|
||||||
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
|
||||||
let newTheme = '';
|
|
||||||
if(authorPrefersDark) {
|
|
||||||
newTheme = isAlternate ? baseTheme : alternateTheme;
|
|
||||||
} else {
|
|
||||||
newTheme = isAlternate ? alternateTheme : baseTheme;
|
|
||||||
}
|
|
||||||
const changeGiscusTheme = () => {
|
|
||||||
// From: https://github.com/giscus/giscus/issues/336
|
|
||||||
const sendMessage = (message) => {
|
|
||||||
const iframe = document.querySelector('iframe.giscus-frame');
|
|
||||||
if (!iframe) return;
|
|
||||||
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
|
||||||
}
|
|
||||||
sendMessage({
|
|
||||||
setConfig: {
|
|
||||||
theme: newTheme
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
|
||||||
if (isGiscussLoaded) {
|
|
||||||
changeGiscusTheme();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const authorPrefersDark = true;
|
|
||||||
const darkModeDefault = authorPrefersDark;
|
|
||||||
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
|
||||||
// Dark / light mode switch
|
|
||||||
window.quartoToggleColorScheme = () => {
|
|
||||||
// Read the current dark / light value
|
|
||||||
let toAlternate = !hasAlternateSentinel();
|
|
||||||
toggleColorMode(toAlternate);
|
|
||||||
setStyleSentinel(toAlternate);
|
|
||||||
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
|
||||||
window.dispatchEvent(new Event('resize'));
|
|
||||||
};
|
|
||||||
// Switch to dark mode if need be
|
|
||||||
if (hasAlternateSentinel()) {
|
|
||||||
toggleColorMode(true);
|
|
||||||
} else {
|
|
||||||
toggleColorMode(false);
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<div id="quarto-search-results"></div>
|
<div id="quarto-search-results"></div>
|
||||||
<header id="quarto-header" class="headroom fixed-top">
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
|
@ -352,7 +191,6 @@ ul.task-list li input[type="checkbox"] {
|
||||||
<!-- main -->
|
<!-- main -->
|
||||||
<main class="content" id="quarto-document-content">
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
|
||||||
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/getstarted.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/getstarted.html">Code</a></li></ol></nav>
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../../sites/codesnippets/getstarted.html">Code Snippets</a></li><li class="breadcrumb-item"><a href="../../sites/codesnippets/getstarted.html">Code</a></li></ol></nav>
|
||||||
<div class="quarto-title">
|
<div class="quarto-title">
|
||||||
<h1 class="title">Code</h1>
|
<h1 class="title">Code</h1>
|
||||||
|
|
@ -379,7 +217,151 @@ ul.task-list li input[type="checkbox"] {
|
||||||
|
|
||||||
</main> <!-- /main -->
|
</main> <!-- /main -->
|
||||||
<script id="quarto-html-after-body" type="application/javascript">
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
window.document.addEventListener("DOMContentLoaded", function (event) {
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
// Ensure there is a toggle, if there isn't float one in the top right
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
const a = window.document.createElement('a');
|
const a = window.document.createElement('a');
|
||||||
|
|
@ -392,7 +374,12 @@ ul.task-list li input[type="checkbox"] {
|
||||||
a.appendChild(i);
|
a.appendChild(i);
|
||||||
window.document.body.appendChild(a);
|
window.document.body.appendChild(a);
|
||||||
}
|
}
|
||||||
setColorSchemeToggle(hasAlternateSentinel())
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
const icon = "";
|
const icon = "";
|
||||||
const anchorJS = new window.AnchorJS();
|
const anchorJS = new window.AnchorJS();
|
||||||
anchorJS.options = {
|
anchorJS.options = {
|
||||||
|
|
@ -788,8 +775,8 @@ ul.task-list li input[type="checkbox"] {
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</div> <!-- /content -->
|
</div> <!-- /content -->
|
||||||
<footer class="footer">
|
<footer class="footer">
|
||||||
<div class="nav-footer">
|
<div class="nav-footer">
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<meta name="generator" content="quarto-1.7.33">
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
@ -21,9 +21,8 @@ ul.task-list li input[type="checkbox"] {
|
||||||
vertical-align: middle;
|
vertical-align: middle;
|
||||||
}
|
}
|
||||||
/* CSS for syntax highlighting */
|
/* CSS for syntax highlighting */
|
||||||
html { -webkit-text-size-adjust: 100%; }
|
|
||||||
pre > code.sourceCode { white-space: pre; position: relative; }
|
pre > code.sourceCode { white-space: pre; position: relative; }
|
||||||
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
|
pre > code.sourceCode > span { line-height: 1.25; }
|
||||||
pre > code.sourceCode > span:empty { height: 1.2em; }
|
pre > code.sourceCode > span:empty { height: 1.2em; }
|
||||||
.sourceCode { overflow: visible; }
|
.sourceCode { overflow: visible; }
|
||||||
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
||||||
|
|
@ -34,7 +33,7 @@ div.sourceCode { overflow: auto; }
|
||||||
}
|
}
|
||||||
@media print {
|
@media print {
|
||||||
pre > code.sourceCode { white-space: pre-wrap; }
|
pre > code.sourceCode { white-space: pre-wrap; }
|
||||||
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
|
pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; }
|
||||||
}
|
}
|
||||||
pre.numberSource code
|
pre.numberSource code
|
||||||
{ counter-reset: source-line 0; }
|
{ counter-reset: source-line 0; }
|
||||||
|
|
@ -65,18 +64,17 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<script src="../site_libs/quarto-search/fuse.min.js"></script>
|
<script src="../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
<script src="../site_libs/quarto-search/quarto-search.js"></script>
|
<script src="../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
<meta name="quarto:offset" content="../">
|
<meta name="quarto:offset" content="../">
|
||||||
<script src="../site_libs/quarto-html/quarto.js" type="module"></script>
|
<script src="../site_libs/quarto-html/quarto.js"></script>
|
||||||
<script src="../site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
|
||||||
<script src="../site_libs/quarto-html/popper.min.js"></script>
|
<script src="../site_libs/quarto-html/popper.min.js"></script>
|
||||||
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script>
|
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
<script src="../site_libs/quarto-html/anchor.min.js"></script>
|
<script src="../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-ea385d0e468b0dd5ea5bf0780b1290d9.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-dark-bc185b5c5bdbcb35c2eb49d8a876ef70.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
<script src="../site_libs/bootstrap/bootstrap.min.js"></script>
|
<script src="../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
<link href="../site_libs/bootstrap/bootstrap-cc0e6b7e963372abfd8d1a3e5f94ef8b.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
<link href="../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
<link href="../site_libs/bootstrap/bootstrap-dark-984ce6cd9b28ffdc8ec90b4c90a017de.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
<link href="../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
<script id="quarto-search-options" type="application/json">{
|
<script id="quarto-search-options" type="application/json">{
|
||||||
"location": "navbar",
|
"location": "navbar",
|
||||||
"copy-button": false,
|
"copy-button": false,
|
||||||
|
|
@ -108,167 +106,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body class="nav-sidebar docked nav-fixed quarto-dark"><script id="quarto-html-before-body" type="application/javascript">
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
const toggleBodyColorMode = (bsSheetEl) => {
|
|
||||||
const mode = bsSheetEl.getAttribute("data-mode");
|
|
||||||
const bodyEl = window.document.querySelector("body");
|
|
||||||
if (mode === "dark") {
|
|
||||||
bodyEl.classList.add("quarto-dark");
|
|
||||||
bodyEl.classList.remove("quarto-light");
|
|
||||||
} else {
|
|
||||||
bodyEl.classList.add("quarto-light");
|
|
||||||
bodyEl.classList.remove("quarto-dark");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleBodyColorPrimary = () => {
|
|
||||||
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])");
|
|
||||||
if (bsSheetEl) {
|
|
||||||
toggleBodyColorMode(bsSheetEl);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setColorSchemeToggle = (alternate) => {
|
|
||||||
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
|
||||||
for (let i=0; i < toggles.length; i++) {
|
|
||||||
const toggle = toggles[i];
|
|
||||||
if (toggle) {
|
|
||||||
if (alternate) {
|
|
||||||
toggle.classList.add("alternate");
|
|
||||||
} else {
|
|
||||||
toggle.classList.remove("alternate");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const toggleColorMode = (alternate) => {
|
|
||||||
// Switch the stylesheets
|
|
||||||
const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
|
|
||||||
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
|
||||||
if (alternate) {
|
|
||||||
// note: dark is layered on light, we don't disable primary!
|
|
||||||
enableStylesheet(alternateStylesheets);
|
|
||||||
for (const sheetNode of alternateStylesheets) {
|
|
||||||
if (sheetNode.id === "quarto-bootstrap") {
|
|
||||||
toggleBodyColorMode(sheetNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
disableStylesheet(alternateStylesheets);
|
|
||||||
enableStylesheet(primaryStylesheets)
|
|
||||||
toggleBodyColorPrimary();
|
|
||||||
}
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
|
||||||
// Switch the toggles
|
|
||||||
setColorSchemeToggle(alternate)
|
|
||||||
// Hack to workaround the fact that safari doesn't
|
|
||||||
// properly recolor the scrollbar when toggling (#1455)
|
|
||||||
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
|
||||||
manageTransitions("body", false);
|
|
||||||
window.scrollTo(0, 1);
|
|
||||||
setTimeout(() => {
|
|
||||||
window.scrollTo(0, 0);
|
|
||||||
manageTransitions("body", true);
|
|
||||||
}, 40);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const disableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
stylesheet.rel = 'disabled-stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const enableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check
|
|
||||||
stylesheet.rel = 'stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const manageTransitions = (selector, allowTransitions) => {
|
|
||||||
const els = window.document.querySelectorAll(selector);
|
|
||||||
for (let i=0; i < els.length; i++) {
|
|
||||||
const el = els[i];
|
|
||||||
if (allowTransitions) {
|
|
||||||
el.classList.remove('notransition');
|
|
||||||
} else {
|
|
||||||
el.classList.add('notransition');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const isFileUrl = () => {
|
|
||||||
return window.location.protocol === 'file:';
|
|
||||||
}
|
|
||||||
const hasAlternateSentinel = () => {
|
|
||||||
let styleSentinel = getColorSchemeSentinel();
|
|
||||||
if (styleSentinel !== null) {
|
|
||||||
return styleSentinel === "alternate";
|
|
||||||
} else {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setStyleSentinel = (alternate) => {
|
|
||||||
const value = alternate ? "alternate" : "default";
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
window.localStorage.setItem("quarto-color-scheme", value);
|
|
||||||
} else {
|
|
||||||
localAlternateSentinel = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const getColorSchemeSentinel = () => {
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
|
||||||
return storageValue != null ? storageValue : localAlternateSentinel;
|
|
||||||
} else {
|
|
||||||
return localAlternateSentinel;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
|
||||||
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
|
||||||
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
|
||||||
let newTheme = '';
|
|
||||||
if(authorPrefersDark) {
|
|
||||||
newTheme = isAlternate ? baseTheme : alternateTheme;
|
|
||||||
} else {
|
|
||||||
newTheme = isAlternate ? alternateTheme : baseTheme;
|
|
||||||
}
|
|
||||||
const changeGiscusTheme = () => {
|
|
||||||
// From: https://github.com/giscus/giscus/issues/336
|
|
||||||
const sendMessage = (message) => {
|
|
||||||
const iframe = document.querySelector('iframe.giscus-frame');
|
|
||||||
if (!iframe) return;
|
|
||||||
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
|
||||||
}
|
|
||||||
sendMessage({
|
|
||||||
setConfig: {
|
|
||||||
theme: newTheme
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
|
||||||
if (isGiscussLoaded) {
|
|
||||||
changeGiscusTheme();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const authorPrefersDark = true;
|
|
||||||
const darkModeDefault = authorPrefersDark;
|
|
||||||
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
|
||||||
// Dark / light mode switch
|
|
||||||
window.quartoToggleColorScheme = () => {
|
|
||||||
// Read the current dark / light value
|
|
||||||
let toAlternate = !hasAlternateSentinel();
|
|
||||||
toggleColorMode(toAlternate);
|
|
||||||
setStyleSentinel(toAlternate);
|
|
||||||
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
|
||||||
window.dispatchEvent(new Event('resize'));
|
|
||||||
};
|
|
||||||
// Switch to dark mode if need be
|
|
||||||
if (hasAlternateSentinel()) {
|
|
||||||
toggleColorMode(true);
|
|
||||||
} else {
|
|
||||||
toggleColorMode(false);
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<div id="quarto-search-results"></div>
|
<div id="quarto-search-results"></div>
|
||||||
<header id="quarto-header" class="headroom fixed-top">
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
|
@ -358,8 +196,56 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
<li class="sidebar-item">
|
<li class="sidebar-item">
|
||||||
<div class="sidebar-item-container">
|
<div class="sidebar-item-container">
|
||||||
<a href="../sites/codesnippets/getstarted.html" class="sidebar-item-text sidebar-link">
|
<a href="../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
<span class="menu-text">Code</span></a>
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
</div>
|
</div>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
@ -395,7 +281,6 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<!-- main -->
|
<!-- main -->
|
||||||
<main class="content" id="quarto-document-content">
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
|
||||||
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../sites/getstarted.html">Get Started</a></li><li class="breadcrumb-item"><a href="../sites/getstarted.html">Project Setup</a></li></ol></nav>
|
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../sites/getstarted.html">Get Started</a></li><li class="breadcrumb-item"><a href="../sites/getstarted.html">Project Setup</a></li></ol></nav>
|
||||||
<div class="quarto-title">
|
<div class="quarto-title">
|
||||||
<h1 class="title">Project Setup</h1>
|
<h1 class="title">Project Setup</h1>
|
||||||
|
|
@ -417,33 +302,35 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
|
|
||||||
<p>If you want to take a look inside a project, there are currently three important repositories:</p>
|
<p>If you want to take a look inside a project, there are currently three important repositories:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li>VIRTUOS_Playground: The repository contains the Unreal Engine Project</li>
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground">VIRTUOS_Playground</a>: The repository contains the Unreal Engine Project</li>
|
||||||
<li>VIRTUOS_Assets: Contains all Project related assets like 3D-Models, Graphics etc.</li>
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Assets">VIRTUOS_Assets</a>: Contains all Project related assets like 3D-Models, Graphics etc.</li>
|
||||||
<li>VIRTUOS_Documents: Contains all written Documents</li>
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Documents">VIRTUOS_Documents</a>: Contains all written Documents</li>
|
||||||
<li>VIRTUOS_Docs: The Documentation in QUarto (which you’re reading right now)</li>
|
<li><a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs">VIRTUOS_Docs</a>: The Documentation of this Project (which you’re reading right now)</li>
|
||||||
</ul>
|
</ul>
|
||||||
<section id="setting-up-the-project-with-ue5" class="level1">
|
<section id="setting-up-the-project-with-ue5" class="level1">
|
||||||
<h1>Setting up the project with UE5</h1>
|
<h1>Setting up the project with UE5</h1>
|
||||||
<p>If you’re familiar with Git, you’ll likely already know how to get the files.</p>
|
<p>If you’re familiar with Git, you’ll likely already know how to get the files from the repository:</p>
|
||||||
<div class="sourceCode" id="cb1"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">git</span> pull https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs.git</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
|
<div class="sourceCode" id="cb1"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">git</span> pull https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs.git</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
|
||||||
<p>If you’re not comforatable with the command line, you can install a Git GUI like Github Desktop:</p>
|
<p>If you’re not comforatable with the command line, you can install a Git GUI like Github Desktop:</p>
|
||||||
<p>Hit <code>File -> Clone repository</code></p>
|
<p>Hit <code>File -> Clone repository</code></p>
|
||||||
<p><img src="../img/Clone1.png" class="img-fluid"></p>
|
<p><img src="../img/Clone1.png" class="img-fluid"></p>
|
||||||
<p>Enter the repository from <code>code.virtuos.world</code> you want to clone, e.g. https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground.git</p>
|
<p>Enter the repository from <code>code.virtuos.world</code> you want to clone, e.g. <a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground.git" class="uri">https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground.git</a></p>
|
||||||
<p><img src="../img/Clone2.png" class="img-fluid"></p>
|
<p><img src="../img/Clone2.png" class="img-fluid"></p>
|
||||||
</section>
|
</section>
|
||||||
<section id="dependencies" class="level1">
|
<section id="dependencies" class="level1">
|
||||||
<h1>Dependencies</h1>
|
<h1>Dependencies</h1>
|
||||||
<p>The project uses the following external Plugins:</p>
|
<p>The project uses the following external Plugins:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li>VR Expansion Plugin, see https://github.com/mordentral/VRExpansionPlugin</li>
|
<li><a href="https://github.com/mordentral/VRExpansionPlugin">VR Expansion Plugin</a></li>
|
||||||
<li>SPUD: Steve’s Persistent Unreal Data library, see https://github.com/sinbad/SPUD</li>
|
<li><a href="https://github.com/sinbad/SPUD">SPUD: Steve’s Persistent Unreal Data library</a></li>
|
||||||
|
<li><a href="https://github.com/sinbad/SUDS">SUDS: Steve’s Unreal Dialogue System</a></li>
|
||||||
|
<li><a href="https://github.com/sinbad/StevesUEHelpers">StevesUEHelpers: Steve’s UE Helper Plugin Library</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
<p>The Plugins are already in the /Plugins folder</p>
|
<p>The Plugins are already in the /Plugins folder and should build with the project without errors. For manual installation, see the respective Documentation.</p>
|
||||||
</section>
|
</section>
|
||||||
<section id="building-the-project" class="level1">
|
<section id="building-the-project" class="level1">
|
||||||
<h1>Building the project</h1>
|
<h1>Building the project</h1>
|
||||||
<p>Note: To build the project, you’ll need Visual Studio installed on your system.</p>
|
<p>To build the project, you’ll need Visual Studio installed on your system.</p>
|
||||||
<ol>
|
<ol>
|
||||||
<li>
|
<li>
|
||||||
Right click the .uproject file and hit <code>Generate Visual Studio project files</code>.
|
Right click the .uproject file and hit <code>Generate Visual Studio project files</code>.
|
||||||
|
|
@ -452,13 +339,158 @@ Right click the .uproject file and hit <code>Generate Visual Studio project file
|
||||||
Open the newly generated .sln file in Visual Studio. From there, hit <code>Build -> Build solution</code>.
|
Open the newly generated .sln file in Visual Studio. From there, hit <code>Build -> Build solution</code>.
|
||||||
</li>
|
</li>
|
||||||
</ol>
|
</ol>
|
||||||
|
<p>Note: This may take a while.</p>
|
||||||
|
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
</main> <!-- /main -->
|
</main> <!-- /main -->
|
||||||
<script id="quarto-html-after-body" type="application/javascript">
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
window.document.addEventListener("DOMContentLoaded", function (event) {
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
// Ensure there is a toggle, if there isn't float one in the top right
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
const a = window.document.createElement('a');
|
const a = window.document.createElement('a');
|
||||||
|
|
@ -471,7 +503,12 @@ Open the newly generated .sln file in Visual Studio. From there, hit <code>Build
|
||||||
a.appendChild(i);
|
a.appendChild(i);
|
||||||
window.document.body.appendChild(a);
|
window.document.body.appendChild(a);
|
||||||
}
|
}
|
||||||
setColorSchemeToggle(hasAlternateSentinel())
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
const icon = "";
|
const icon = "";
|
||||||
const anchorJS = new window.AnchorJS();
|
const anchorJS = new window.AnchorJS();
|
||||||
anchorJS.options = {
|
anchorJS.options = {
|
||||||
|
|
@ -867,13 +904,13 @@ Open the newly generated .sln file in Visual Studio. From there, hit <code>Build
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</div> <!-- /content -->
|
</div> <!-- /content -->
|
||||||
<footer class="footer">
|
<footer class="footer">
|
||||||
<div class="nav-footer">
|
<div class="nav-footer">
|
||||||
<div class="nav-footer-left">
|
<div class="nav-footer-left">
|
||||||
<p>Copyright 2025, Simeon Wallrath</p>
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="nav-footer-center">
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2,12 +2,12 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
|
||||||
|
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<meta name="generator" content="quarto-1.7.33">
|
<meta name="generator" content="quarto-1.6.43">
|
||||||
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
|
||||||
|
|
||||||
<title>Websevices – Docs</title>
|
<title>Webservices – Docs</title>
|
||||||
<style>
|
<style>
|
||||||
code{white-space: pre-wrap;}
|
code{white-space: pre-wrap;}
|
||||||
span.smallcaps{font-variant: small-caps;}
|
span.smallcaps{font-variant: small-caps;}
|
||||||
|
|
@ -21,9 +21,8 @@ ul.task-list li input[type="checkbox"] {
|
||||||
vertical-align: middle;
|
vertical-align: middle;
|
||||||
}
|
}
|
||||||
/* CSS for syntax highlighting */
|
/* CSS for syntax highlighting */
|
||||||
html { -webkit-text-size-adjust: 100%; }
|
|
||||||
pre > code.sourceCode { white-space: pre; position: relative; }
|
pre > code.sourceCode { white-space: pre; position: relative; }
|
||||||
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
|
pre > code.sourceCode > span { line-height: 1.25; }
|
||||||
pre > code.sourceCode > span:empty { height: 1.2em; }
|
pre > code.sourceCode > span:empty { height: 1.2em; }
|
||||||
.sourceCode { overflow: visible; }
|
.sourceCode { overflow: visible; }
|
||||||
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
||||||
|
|
@ -34,7 +33,7 @@ div.sourceCode { overflow: auto; }
|
||||||
}
|
}
|
||||||
@media print {
|
@media print {
|
||||||
pre > code.sourceCode { white-space: pre-wrap; }
|
pre > code.sourceCode { white-space: pre-wrap; }
|
||||||
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
|
pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; }
|
||||||
}
|
}
|
||||||
pre.numberSource code
|
pre.numberSource code
|
||||||
{ counter-reset: source-line 0; }
|
{ counter-reset: source-line 0; }
|
||||||
|
|
@ -65,18 +64,17 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<script src="../site_libs/quarto-search/fuse.min.js"></script>
|
<script src="../site_libs/quarto-search/fuse.min.js"></script>
|
||||||
<script src="../site_libs/quarto-search/quarto-search.js"></script>
|
<script src="../site_libs/quarto-search/quarto-search.js"></script>
|
||||||
<meta name="quarto:offset" content="../">
|
<meta name="quarto:offset" content="../">
|
||||||
<script src="../site_libs/quarto-html/quarto.js" type="module"></script>
|
<script src="../site_libs/quarto-html/quarto.js"></script>
|
||||||
<script src="../site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
|
||||||
<script src="../site_libs/quarto-html/popper.min.js"></script>
|
<script src="../site_libs/quarto-html/popper.min.js"></script>
|
||||||
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script>
|
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script>
|
||||||
<script src="../site_libs/quarto-html/anchor.min.js"></script>
|
<script src="../site_libs/quarto-html/anchor.min.js"></script>
|
||||||
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet">
|
||||||
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-ea385d0e468b0dd5ea5bf0780b1290d9.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-d4d76bf8491c20bad77d141916dc28e1.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-text-highlighting-styles">
|
||||||
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-dark-bc185b5c5bdbcb35c2eb49d8a876ef70.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-dark-4379b0ccadffce622b03caf4c46266b3.css" rel="stylesheet" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
|
||||||
<script src="../site_libs/bootstrap/bootstrap.min.js"></script>
|
<script src="../site_libs/bootstrap/bootstrap.min.js"></script>
|
||||||
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
|
||||||
<link href="../site_libs/bootstrap/bootstrap-cc0e6b7e963372abfd8d1a3e5f94ef8b.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
<link href="../site_libs/bootstrap/bootstrap-00e379fb31ce7833585dec8dfd5989ef.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||||
<link href="../site_libs/bootstrap/bootstrap-dark-984ce6cd9b28ffdc8ec90b4c90a017de.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
<link href="../site_libs/bootstrap/bootstrap-dark-9cba0d3daf1ff70ca6711adbf1c35402.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||||
<script id="quarto-search-options" type="application/json">{
|
<script id="quarto-search-options" type="application/json">{
|
||||||
"location": "navbar",
|
"location": "navbar",
|
||||||
"copy-button": false,
|
"copy-button": false,
|
||||||
|
|
@ -108,167 +106,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body class="nav-sidebar docked nav-fixed quarto-dark"><script id="quarto-html-before-body" type="application/javascript">
|
<body class="nav-sidebar docked nav-fixed">
|
||||||
const toggleBodyColorMode = (bsSheetEl) => {
|
|
||||||
const mode = bsSheetEl.getAttribute("data-mode");
|
|
||||||
const bodyEl = window.document.querySelector("body");
|
|
||||||
if (mode === "dark") {
|
|
||||||
bodyEl.classList.add("quarto-dark");
|
|
||||||
bodyEl.classList.remove("quarto-light");
|
|
||||||
} else {
|
|
||||||
bodyEl.classList.add("quarto-light");
|
|
||||||
bodyEl.classList.remove("quarto-dark");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleBodyColorPrimary = () => {
|
|
||||||
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap:not([rel=disabled-stylesheet])");
|
|
||||||
if (bsSheetEl) {
|
|
||||||
toggleBodyColorMode(bsSheetEl);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setColorSchemeToggle = (alternate) => {
|
|
||||||
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
|
||||||
for (let i=0; i < toggles.length; i++) {
|
|
||||||
const toggle = toggles[i];
|
|
||||||
if (toggle) {
|
|
||||||
if (alternate) {
|
|
||||||
toggle.classList.add("alternate");
|
|
||||||
} else {
|
|
||||||
toggle.classList.remove("alternate");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const toggleColorMode = (alternate) => {
|
|
||||||
// Switch the stylesheets
|
|
||||||
const primaryStylesheets = window.document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
|
|
||||||
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
|
||||||
if (alternate) {
|
|
||||||
// note: dark is layered on light, we don't disable primary!
|
|
||||||
enableStylesheet(alternateStylesheets);
|
|
||||||
for (const sheetNode of alternateStylesheets) {
|
|
||||||
if (sheetNode.id === "quarto-bootstrap") {
|
|
||||||
toggleBodyColorMode(sheetNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
disableStylesheet(alternateStylesheets);
|
|
||||||
enableStylesheet(primaryStylesheets)
|
|
||||||
toggleBodyColorPrimary();
|
|
||||||
}
|
|
||||||
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
|
||||||
// Switch the toggles
|
|
||||||
setColorSchemeToggle(alternate)
|
|
||||||
// Hack to workaround the fact that safari doesn't
|
|
||||||
// properly recolor the scrollbar when toggling (#1455)
|
|
||||||
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
|
||||||
manageTransitions("body", false);
|
|
||||||
window.scrollTo(0, 1);
|
|
||||||
setTimeout(() => {
|
|
||||||
window.scrollTo(0, 0);
|
|
||||||
manageTransitions("body", true);
|
|
||||||
}, 40);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const disableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
stylesheet.rel = 'disabled-stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const enableStylesheet = (stylesheets) => {
|
|
||||||
for (let i=0; i < stylesheets.length; i++) {
|
|
||||||
const stylesheet = stylesheets[i];
|
|
||||||
if(stylesheet.rel !== 'stylesheet') { // for Chrome, which will still FOUC without this check
|
|
||||||
stylesheet.rel = 'stylesheet';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const manageTransitions = (selector, allowTransitions) => {
|
|
||||||
const els = window.document.querySelectorAll(selector);
|
|
||||||
for (let i=0; i < els.length; i++) {
|
|
||||||
const el = els[i];
|
|
||||||
if (allowTransitions) {
|
|
||||||
el.classList.remove('notransition');
|
|
||||||
} else {
|
|
||||||
el.classList.add('notransition');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const isFileUrl = () => {
|
|
||||||
return window.location.protocol === 'file:';
|
|
||||||
}
|
|
||||||
const hasAlternateSentinel = () => {
|
|
||||||
let styleSentinel = getColorSchemeSentinel();
|
|
||||||
if (styleSentinel !== null) {
|
|
||||||
return styleSentinel === "alternate";
|
|
||||||
} else {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const setStyleSentinel = (alternate) => {
|
|
||||||
const value = alternate ? "alternate" : "default";
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
window.localStorage.setItem("quarto-color-scheme", value);
|
|
||||||
} else {
|
|
||||||
localAlternateSentinel = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const getColorSchemeSentinel = () => {
|
|
||||||
if (!isFileUrl()) {
|
|
||||||
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
|
||||||
return storageValue != null ? storageValue : localAlternateSentinel;
|
|
||||||
} else {
|
|
||||||
return localAlternateSentinel;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
|
||||||
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
|
||||||
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
|
||||||
let newTheme = '';
|
|
||||||
if(authorPrefersDark) {
|
|
||||||
newTheme = isAlternate ? baseTheme : alternateTheme;
|
|
||||||
} else {
|
|
||||||
newTheme = isAlternate ? alternateTheme : baseTheme;
|
|
||||||
}
|
|
||||||
const changeGiscusTheme = () => {
|
|
||||||
// From: https://github.com/giscus/giscus/issues/336
|
|
||||||
const sendMessage = (message) => {
|
|
||||||
const iframe = document.querySelector('iframe.giscus-frame');
|
|
||||||
if (!iframe) return;
|
|
||||||
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
|
||||||
}
|
|
||||||
sendMessage({
|
|
||||||
setConfig: {
|
|
||||||
theme: newTheme
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
|
||||||
if (isGiscussLoaded) {
|
|
||||||
changeGiscusTheme();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const authorPrefersDark = true;
|
|
||||||
const darkModeDefault = authorPrefersDark;
|
|
||||||
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
|
||||||
// Dark / light mode switch
|
|
||||||
window.quartoToggleColorScheme = () => {
|
|
||||||
// Read the current dark / light value
|
|
||||||
let toAlternate = !hasAlternateSentinel();
|
|
||||||
toggleColorMode(toAlternate);
|
|
||||||
setStyleSentinel(toAlternate);
|
|
||||||
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
|
||||||
window.dispatchEvent(new Event('resize'));
|
|
||||||
};
|
|
||||||
// Switch to dark mode if need be
|
|
||||||
if (hasAlternateSentinel()) {
|
|
||||||
toggleColorMode(true);
|
|
||||||
} else {
|
|
||||||
toggleColorMode(false);
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<div id="quarto-search-results"></div>
|
<div id="quarto-search-results"></div>
|
||||||
<header id="quarto-header" class="headroom fixed-top">
|
<header id="quarto-header" class="headroom fixed-top">
|
||||||
|
|
@ -358,8 +196,56 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show">
|
||||||
<li class="sidebar-item">
|
<li class="sidebar-item">
|
||||||
<div class="sidebar-item-container">
|
<div class="sidebar-item-container">
|
||||||
<a href="../sites/codesnippets/getstarted.html" class="sidebar-item-text sidebar-link">
|
<a href="../sites/codesnippets/AlyxGrab.html" class="sidebar-item-text sidebar-link">
|
||||||
<span class="menu-text">Code</span></a>
|
<span class="menu-text">Alyx Grab</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/CaptchaDoor.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Captcha Door</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/CustomAIController.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Follow Spline / AIController</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/GripRobot.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Clarice / Grippable Robot</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/Inventory.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Inventory</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/MainMenu.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Main Menu</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/MovablesSoundComponent.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Movables Sound Component</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/Slicegame.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">Slicegame</span></a>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li class="sidebar-item">
|
||||||
|
<div class="sidebar-item-container">
|
||||||
|
<a href="../sites/codesnippets/SaveGame_SPUD.html" class="sidebar-item-text sidebar-link">
|
||||||
|
<span class="menu-text">SPUD / Save Games</span></a>
|
||||||
</div>
|
</div>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
@ -401,11 +287,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<li><a href="#installation-on-uberspace-1" id="toc-installation-on-uberspace-1" class="nav-link" data-scroll-target="#installation-on-uberspace-1">Installation on Uberspace</a></li>
|
<li><a href="#installation-on-uberspace-1" id="toc-installation-on-uberspace-1" class="nav-link" data-scroll-target="#installation-on-uberspace-1">Installation on Uberspace</a></li>
|
||||||
<li><a href="#updating-wordpress" id="toc-updating-wordpress" class="nav-link" data-scroll-target="#updating-wordpress">Updating Wordpress</a></li>
|
<li><a href="#updating-wordpress" id="toc-updating-wordpress" class="nav-link" data-scroll-target="#updating-wordpress">Updating Wordpress</a></li>
|
||||||
</ul></li>
|
</ul></li>
|
||||||
<li><a href="#wiki.js" id="toc-wiki.js" class="nav-link" data-scroll-target="#wiki.js">Wiki.js</a>
|
<li><a href="#quarto" id="toc-quarto" class="nav-link" data-scroll-target="#quarto">Quarto</a></li>
|
||||||
<ul class="collapse">
|
|
||||||
<li><a href="#installation-on-uberspace-2" id="toc-installation-on-uberspace-2" class="nav-link" data-scroll-target="#installation-on-uberspace-2">Installation on Uberspace</a></li>
|
|
||||||
<li><a href="#updating-wiki.js" id="toc-updating-wiki.js" class="nav-link" data-scroll-target="#updating-wiki.js">Updating Wiki.js</a></li>
|
|
||||||
</ul></li>
|
|
||||||
<li><a href="#pretix" id="toc-pretix" class="nav-link" data-scroll-target="#pretix">Pretix</a></li>
|
<li><a href="#pretix" id="toc-pretix" class="nav-link" data-scroll-target="#pretix">Pretix</a></li>
|
||||||
<li><a href="#blueprintue" id="toc-blueprintue" class="nav-link" data-scroll-target="#blueprintue">BlueprintUE</a></li>
|
<li><a href="#blueprintue" id="toc-blueprintue" class="nav-link" data-scroll-target="#blueprintue">BlueprintUE</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
@ -414,10 +296,9 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||||
<!-- main -->
|
<!-- main -->
|
||||||
<main class="content" id="quarto-document-content">
|
<main class="content" id="quarto-document-content">
|
||||||
|
|
||||||
|
|
||||||
<header id="title-block-header" class="quarto-title-block default">
|
<header id="title-block-header" class="quarto-title-block default">
|
||||||
<div class="quarto-title">
|
<div class="quarto-title">
|
||||||
<h1 class="title">Websevices</h1>
|
<h1 class="title">Webservices</h1>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -576,40 +457,40 @@ password=yourpassword</code></pre>
|
||||||
<ul>
|
<ul>
|
||||||
<li>To redirect the homepage to the repository view:</li>
|
<li>To redirect the homepage to the repository view:</li>
|
||||||
</ul>
|
</ul>
|
||||||
<pre class="nginx"><code>server {
|
<div class="sourceCode" id="cb22"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb22-1"><a href="#cb22-1" aria-hidden="true" tabindex="-1"></a><span class="ex">server</span> {</span>
|
||||||
server_name code.virtuos.world;
|
<span id="cb22-2"><a href="#cb22-2" aria-hidden="true" tabindex="-1"></a> <span class="ex">server_name</span> code.virtuos.world<span class="kw">;</span></span>
|
||||||
|
<span id="cb22-3"><a href="#cb22-3" aria-hidden="true" tabindex="-1"></a></span>
|
||||||
location / {
|
<span id="cb22-4"><a href="#cb22-4" aria-hidden="true" tabindex="-1"></a> <span class="ex">location</span> / {</span>
|
||||||
client_max_body_size 4G;
|
<span id="cb22-5"><a href="#cb22-5" aria-hidden="true" tabindex="-1"></a> <span class="ex">client_max_body_size</span> 4G<span class="kw">;</span></span>
|
||||||
proxy_pass http://localhost:3000;
|
<span id="cb22-6"><a href="#cb22-6" aria-hidden="true" tabindex="-1"></a> <span class="ex">proxy_pass</span> http://localhost:3000<span class="kw">;</span></span>
|
||||||
proxy_set_header Host $host;
|
<span id="cb22-7"><a href="#cb22-7" aria-hidden="true" tabindex="-1"></a> <span class="ex">proxy_set_header</span> Host <span class="va">$host</span><span class="kw">;</span></span>
|
||||||
proxy_set_header X-Real_IP $remote_addr;
|
<span id="cb22-8"><a href="#cb22-8" aria-hidden="true" tabindex="-1"></a> <span class="ex">proxy_set_header</span> X-Real_IP <span class="va">$remote_addr</span><span class="kw">;</span></span>
|
||||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
<span id="cb22-9"><a href="#cb22-9" aria-hidden="true" tabindex="-1"></a> <span class="ex">proxy_set_header</span> X-Forwarded-For <span class="va">$proxy_add_x_forwarded_for</span><span class="kw">;</span></span>
|
||||||
proxy_set_header X-Forwarded-Proto $scheme;
|
<span id="cb22-10"><a href="#cb22-10" aria-hidden="true" tabindex="-1"></a> <span class="ex">proxy_set_header</span> X-Forwarded-Proto <span class="va">$scheme</span><span class="kw">;</span></span>
|
||||||
}
|
<span id="cb22-11"><a href="#cb22-11" aria-hidden="true" tabindex="-1"></a> <span class="er">}</span></span>
|
||||||
|
<span id="cb22-12"><a href="#cb22-12" aria-hidden="true" tabindex="-1"></a></span>
|
||||||
location = / {
|
<span id="cb22-13"><a href="#cb22-13" aria-hidden="true" tabindex="-1"></a> <span class="ex">location</span> = / {</span>
|
||||||
return 301 https://$host/explore/repos;
|
<span id="cb22-14"><a href="#cb22-14" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">301</span> <span class="ex">https://</span><span class="va">$host</span><span class="ex">/explore/repos</span><span class="kw">;</span></span>
|
||||||
}
|
<span id="cb22-15"><a href="#cb22-15" aria-hidden="true" tabindex="-1"></a> <span class="er">}</span></span>
|
||||||
|
<span id="cb22-16"><a href="#cb22-16" aria-hidden="true" tabindex="-1"></a></span>
|
||||||
listen [::]:443 ssl ipv6only=on; # managed by Certbot
|
<span id="cb22-17"><a href="#cb22-17" aria-hidden="true" tabindex="-1"></a> <span class="ex">listen</span> <span class="pp">[</span><span class="ss">::</span><span class="pp">]</span>:443 ssl ipv6only=on<span class="kw">;</span> <span class="co"># managed by Certbot</span></span>
|
||||||
listen 443 ssl; # managed by Certbot
|
<span id="cb22-18"><a href="#cb22-18" aria-hidden="true" tabindex="-1"></a> <span class="ex">listen</span> 443 ssl<span class="kw">;</span> <span class="co"># managed by Certbot</span></span>
|
||||||
ssl_certificate /etc/letsencrypt/live/code.virtuos.world/fullchain.pem;
|
<span id="cb22-19"><a href="#cb22-19" aria-hidden="true" tabindex="-1"></a> <span class="ex">ssl_certificate</span> /etc/letsencrypt/live/code.virtuos.world/fullchain.pem<span class="kw">;</span></span>
|
||||||
ssl_certificate_key /etc/letsencrypt/live/code.virtuos.world/privkey.pem;
|
<span id="cb22-20"><a href="#cb22-20" aria-hidden="true" tabindex="-1"></a> <span class="ex">ssl_certificate_key</span> /etc/letsencrypt/live/code.virtuos.world/privkey.pem<span class="kw">;</span></span>
|
||||||
include /etc/letsencrypt/options-ssl-nginx.conf;
|
<span id="cb22-21"><a href="#cb22-21" aria-hidden="true" tabindex="-1"></a> <span class="ex">include</span> /etc/letsencrypt/options-ssl-nginx.conf<span class="kw">;</span></span>
|
||||||
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
|
<span id="cb22-22"><a href="#cb22-22" aria-hidden="true" tabindex="-1"></a> <span class="ex">ssl_dhparam</span> /etc/letsencrypt/ssl-dhparams.pem<span class="kw">;</span></span>
|
||||||
}
|
<span id="cb22-23"><a href="#cb22-23" aria-hidden="true" tabindex="-1"></a><span class="er">}</span></span>
|
||||||
|
<span id="cb22-24"><a href="#cb22-24" aria-hidden="true" tabindex="-1"></a></span>
|
||||||
server {
|
<span id="cb22-25"><a href="#cb22-25" aria-hidden="true" tabindex="-1"></a><span class="ex">server</span> {</span>
|
||||||
if ($host = code.virtuos.world) {
|
<span id="cb22-26"><a href="#cb22-26" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="kw">(</span><span class="va">$host</span> = code.virtuos.world<span class="kw">)</span> <span class="kw">{</span></span>
|
||||||
return 301 https://$host$request_uri;
|
<span id="cb22-27"><a href="#cb22-27" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">301</span> <span class="ex">https://</span><span class="va">$host$request_uri</span><span class="kw">;</span></span>
|
||||||
}
|
<span id="cb22-28"><a href="#cb22-28" aria-hidden="true" tabindex="-1"></a> <span class="kw">}</span></span>
|
||||||
|
<span id="cb22-29"><a href="#cb22-29" aria-hidden="true" tabindex="-1"></a></span>
|
||||||
listen 80;
|
<span id="cb22-30"><a href="#cb22-30" aria-hidden="true" tabindex="-1"></a> <span class="ex">listen</span> 80<span class="kw">;</span></span>
|
||||||
listen [::]:80;
|
<span id="cb22-31"><a href="#cb22-31" aria-hidden="true" tabindex="-1"></a> <span class="ex">listen</span> <span class="pp">[</span><span class="ss">::</span><span class="pp">]</span>:80<span class="kw">;</span></span>
|
||||||
server_name code.virtuos.world;
|
<span id="cb22-32"><a href="#cb22-32" aria-hidden="true" tabindex="-1"></a> <span class="ex">server_name</span> code.virtuos.world<span class="kw">;</span></span>
|
||||||
return 404;
|
<span id="cb22-33"><a href="#cb22-33" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="dv">404</span><span class="kw">;</span></span>
|
||||||
}</code></pre>
|
<span id="cb22-34"><a href="#cb22-34" aria-hidden="true" tabindex="-1"></a><span class="er">}</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
|
||||||
<p>Thanks to KeepItTechie for this tutorial: <a href="https://www.youtube.com/watch?v=I4OQMc1rIO4">https://www.youtube.com/watch?v=I4OQMc1rIO4</a></p>
|
<p>Thanks to KeepItTechie for this tutorial: <a href="https://www.youtube.com/watch?v=I4OQMc1rIO4">https://www.youtube.com/watch?v=I4OQMc1rIO4</a></p>
|
||||||
</section>
|
</section>
|
||||||
<section id="customizing-forgejogitea" class="level2">
|
<section id="customizing-forgejogitea" class="level2">
|
||||||
|
|
@ -690,37 +571,178 @@ Edit <code>/leantime/public/.htaccess</code>:</li>
|
||||||
<hr>
|
<hr>
|
||||||
</section>
|
</section>
|
||||||
</section>
|
</section>
|
||||||
<section id="wiki.js" class="level1">
|
<section id="quarto" class="level1">
|
||||||
<h1>Wiki.js</h1>
|
<h1>Quarto</h1>
|
||||||
<p>Wiki.js was dumped in favour of Quarto.</p>
|
<p>I switched from Wiki.js to Quarto, a static site generator. All files are in <a href="https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs">this repository</a>.</p>
|
||||||
<p>Wiki.js is an open source Wiki software. The Wiki.js instance is hosted on Uberspace.de and you are currently accessing it on <a href="https://docs.virtuos.world">https://docs.virtuos.world</a>.</p>
|
|
||||||
<section id="installation-on-uberspace-2" class="level2">
|
|
||||||
<h2 class="anchored" data-anchor-id="installation-on-uberspace-2">Installation on Uberspace</h2>
|
|
||||||
<p>The Wiki.js installation is well documented on<br>
|
|
||||||
<a href="https://lab.uberspace.de/guide_wiki-js/">https://lab.uberspace.de/guide_wiki-js/</a></p>
|
|
||||||
</section>
|
|
||||||
<section id="updating-wiki.js" class="level2">
|
|
||||||
<h2 class="anchored" data-anchor-id="updating-wiki.js">Updating Wiki.js</h2>
|
|
||||||
<p>An update script is available at the same location:<br>
|
|
||||||
<a href="https://lab.uberspace.de/guide_wiki-js/">https://lab.uberspace.de/guide_wiki-js/</a></p>
|
|
||||||
<hr>
|
<hr>
|
||||||
</section>
|
</section>
|
||||||
</section>
|
|
||||||
<section id="pretix" class="level1">
|
<section id="pretix" class="level1">
|
||||||
<h1>Pretix</h1>
|
<h1>Pretix</h1>
|
||||||
<p>Pretix is an open source ticketing system. It’s currently not in use. This installation is not as easy, but well documented here:<br>
|
<p>Pretix is an open source ticketing system. It’s currently not in use. This installation is not as easy, but well documented here:<br>
|
||||||
<a href="https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html">https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html</a></p>
|
<a href="https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html">https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html</a></p>
|
||||||
|
<hr>
|
||||||
</section>
|
</section>
|
||||||
<section id="blueprintue" class="level1">
|
<section id="blueprintue" class="level1">
|
||||||
<h1>BlueprintUE</h1>
|
<h1>BlueprintUE</h1>
|
||||||
<p>I failed to host BlueprintUE multiple times (I don’t know.=). I gave up and use the official page at https://blueprintue.com/profile/waldo/.</p>
|
<p>I failed to host BlueprintUE multiple times (I don’t know uwu). I gave up and use the official page at https://blueprintue.com/profile/waldo/.</p>
|
||||||
|
<hr>
|
||||||
|
<p><del># Wiki.js</del></p>
|
||||||
|
<p><del>Wiki.js is an open source Wiki software. The Wiki.js instance is hosted on Uberspace.de and you are currently accessing it on <a href="https://docs.virtuos.world">https://docs.virtuos.world</a>.</del></p>
|
||||||
|
<p><del>## Installation on Uberspace</del></p>
|
||||||
|
<p><del>The Wiki.js installation is well documented on <a href="https://lab.uberspace.de/guide_wiki-js/">https://lab.uberspace.de/guide_wiki-js/</a></del></p>
|
||||||
|
<p><del>## Updating Wiki.js</del></p>
|
||||||
|
<p><del>An update script is available at the same location: <a href="https://lab.uberspace.de/guide_wiki-js/">https://lab.uberspace.de/guide_wiki-js/</a></del></p>
|
||||||
|
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
</main> <!-- /main -->
|
</main> <!-- /main -->
|
||||||
<script id="quarto-html-after-body" type="application/javascript">
|
<script id="quarto-html-after-body" type="application/javascript">
|
||||||
window.document.addEventListener("DOMContentLoaded", function (event) {
|
window.document.addEventListener("DOMContentLoaded", function (event) {
|
||||||
|
const toggleBodyColorMode = (bsSheetEl) => {
|
||||||
|
const mode = bsSheetEl.getAttribute("data-mode");
|
||||||
|
const bodyEl = window.document.querySelector("body");
|
||||||
|
if (mode === "dark") {
|
||||||
|
bodyEl.classList.add("quarto-dark");
|
||||||
|
bodyEl.classList.remove("quarto-light");
|
||||||
|
} else {
|
||||||
|
bodyEl.classList.add("quarto-light");
|
||||||
|
bodyEl.classList.remove("quarto-dark");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleBodyColorPrimary = () => {
|
||||||
|
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
|
||||||
|
if (bsSheetEl) {
|
||||||
|
toggleBodyColorMode(bsSheetEl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
const disableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'prefetch';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const enableStylesheet = (stylesheets) => {
|
||||||
|
for (let i=0; i < stylesheets.length; i++) {
|
||||||
|
const stylesheet = stylesheets[i];
|
||||||
|
stylesheet.rel = 'stylesheet';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const manageTransitions = (selector, allowTransitions) => {
|
||||||
|
const els = window.document.querySelectorAll(selector);
|
||||||
|
for (let i=0; i < els.length; i++) {
|
||||||
|
const el = els[i];
|
||||||
|
if (allowTransitions) {
|
||||||
|
el.classList.remove('notransition');
|
||||||
|
} else {
|
||||||
|
el.classList.add('notransition');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleGiscusIfUsed = (isAlternate, darkModeDefault) => {
|
||||||
|
const baseTheme = document.querySelector('#giscus-base-theme')?.value ?? 'light';
|
||||||
|
const alternateTheme = document.querySelector('#giscus-alt-theme')?.value ?? 'dark';
|
||||||
|
let newTheme = '';
|
||||||
|
if(darkModeDefault) {
|
||||||
|
newTheme = isAlternate ? baseTheme : alternateTheme;
|
||||||
|
} else {
|
||||||
|
newTheme = isAlternate ? alternateTheme : baseTheme;
|
||||||
|
}
|
||||||
|
const changeGiscusTheme = () => {
|
||||||
|
// From: https://github.com/giscus/giscus/issues/336
|
||||||
|
const sendMessage = (message) => {
|
||||||
|
const iframe = document.querySelector('iframe.giscus-frame');
|
||||||
|
if (!iframe) return;
|
||||||
|
iframe.contentWindow.postMessage({ giscus: message }, 'https://giscus.app');
|
||||||
|
}
|
||||||
|
sendMessage({
|
||||||
|
setConfig: {
|
||||||
|
theme: newTheme
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
const isGiscussLoaded = window.document.querySelector('iframe.giscus-frame') !== null;
|
||||||
|
if (isGiscussLoaded) {
|
||||||
|
changeGiscusTheme();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const toggleColorMode = (alternate) => {
|
||||||
|
// Switch the stylesheets
|
||||||
|
const alternateStylesheets = window.document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', false);
|
||||||
|
if (alternate) {
|
||||||
|
enableStylesheet(alternateStylesheets);
|
||||||
|
for (const sheetNode of alternateStylesheets) {
|
||||||
|
if (sheetNode.id === "quarto-bootstrap") {
|
||||||
|
toggleBodyColorMode(sheetNode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
disableStylesheet(alternateStylesheets);
|
||||||
|
toggleBodyColorPrimary();
|
||||||
|
}
|
||||||
|
manageTransitions('#quarto-margin-sidebar .nav-link', true);
|
||||||
|
// Switch the toggles
|
||||||
|
const toggles = window.document.querySelectorAll('.quarto-color-scheme-toggle');
|
||||||
|
for (let i=0; i < toggles.length; i++) {
|
||||||
|
const toggle = toggles[i];
|
||||||
|
if (toggle) {
|
||||||
|
if (alternate) {
|
||||||
|
toggle.classList.add("alternate");
|
||||||
|
} else {
|
||||||
|
toggle.classList.remove("alternate");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// Hack to workaround the fact that safari doesn't
|
||||||
|
// properly recolor the scrollbar when toggling (#1455)
|
||||||
|
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
|
||||||
|
manageTransitions("body", false);
|
||||||
|
window.scrollTo(0, 1);
|
||||||
|
setTimeout(() => {
|
||||||
|
window.scrollTo(0, 0);
|
||||||
|
manageTransitions("body", true);
|
||||||
|
}, 40);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const isFileUrl = () => {
|
||||||
|
return window.location.protocol === 'file:';
|
||||||
|
}
|
||||||
|
const hasAlternateSentinel = () => {
|
||||||
|
let styleSentinel = getColorSchemeSentinel();
|
||||||
|
if (styleSentinel !== null) {
|
||||||
|
return styleSentinel === "alternate";
|
||||||
|
} else {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const setStyleSentinel = (alternate) => {
|
||||||
|
const value = alternate ? "alternate" : "default";
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
window.localStorage.setItem("quarto-color-scheme", value);
|
||||||
|
} else {
|
||||||
|
localAlternateSentinel = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const getColorSchemeSentinel = () => {
|
||||||
|
if (!isFileUrl()) {
|
||||||
|
const storageValue = window.localStorage.getItem("quarto-color-scheme");
|
||||||
|
return storageValue != null ? storageValue : localAlternateSentinel;
|
||||||
|
} else {
|
||||||
|
return localAlternateSentinel;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const darkModeDefault = true;
|
||||||
|
let localAlternateSentinel = darkModeDefault ? 'alternate' : 'default';
|
||||||
|
// Dark / light mode switch
|
||||||
|
window.quartoToggleColorScheme = () => {
|
||||||
|
// Read the current dark / light value
|
||||||
|
let toAlternate = !hasAlternateSentinel();
|
||||||
|
toggleColorMode(toAlternate);
|
||||||
|
setStyleSentinel(toAlternate);
|
||||||
|
toggleGiscusIfUsed(toAlternate, darkModeDefault);
|
||||||
|
};
|
||||||
// Ensure there is a toggle, if there isn't float one in the top right
|
// Ensure there is a toggle, if there isn't float one in the top right
|
||||||
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
if (window.document.querySelector('.quarto-color-scheme-toggle') === null) {
|
||||||
const a = window.document.createElement('a');
|
const a = window.document.createElement('a');
|
||||||
|
|
@ -733,7 +755,12 @@ Edit <code>/leantime/public/.htaccess</code>:</li>
|
||||||
a.appendChild(i);
|
a.appendChild(i);
|
||||||
window.document.body.appendChild(a);
|
window.document.body.appendChild(a);
|
||||||
}
|
}
|
||||||
setColorSchemeToggle(hasAlternateSentinel())
|
// Switch to dark mode if need be
|
||||||
|
if (hasAlternateSentinel()) {
|
||||||
|
toggleColorMode(true);
|
||||||
|
} else {
|
||||||
|
toggleColorMode(false);
|
||||||
|
}
|
||||||
const icon = "";
|
const icon = "";
|
||||||
const anchorJS = new window.AnchorJS();
|
const anchorJS = new window.AnchorJS();
|
||||||
anchorJS.options = {
|
anchorJS.options = {
|
||||||
|
|
@ -1129,13 +1156,13 @@ Edit <code>/leantime/public/.htaccess</code>:</li>
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</div> <!-- /content -->
|
</div> <!-- /content -->
|
||||||
<footer class="footer">
|
<footer class="footer">
|
||||||
<div class="nav-footer">
|
<div class="nav-footer">
|
||||||
<div class="nav-footer-left">
|
<div class="nav-footer-left">
|
||||||
<p>Copyright 2025, Simeon Wallrath</p>
|
<p>Copyright 2026, Simeon Wallrath</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="nav-footer-center">
|
<div class="nav-footer-center">
|
||||||
|
|
||||||
|
|
|
||||||
BIN
img/Midi.png
Normal file
BIN
img/Midi.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 566 KiB |
10
index.qmd
10
index.qmd
|
|
@ -3,4 +3,12 @@ title: "Overview"
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
This is the documentation for VIRTUOS WORLD.
|
This is the documentation for VIRTUOS WORLD, the Open Source VR Game I develop during my PhD in chemistry didactics. The main purpose of this page is to share the insights I gained during development.
|
||||||
|
|
||||||
|
If you want to take a look inside a project, there are currently [four important repositories](code.virtuos.world):
|
||||||
|
|
||||||
|
- [VIRTUOS_Playground](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground): The repository contains the Unreal Engine Project
|
||||||
|
- [VIRTUOS_Assets](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Assets): Contains all Project related assets like 3D-Models, Graphics etc.
|
||||||
|
- [VIRTUOS_Documents](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Documents): Contains all written Documents
|
||||||
|
- [VIRTUOS_Docs](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs): The Documentation of this Project (which you're reading right now)
|
||||||
|
|
||||||
|
|
|
||||||
31
sites/codesnippets/AlyxGrab.qmd
Normal file
31
sites/codesnippets/AlyxGrab.qmd
Normal file
|
|
@ -0,0 +1,31 @@
|
||||||
|
---
|
||||||
|
title: "Alyx Grab"
|
||||||
|
---
|
||||||
|
In Class: `BP_TraceController` | Based on VREs BP_TeleportTrace
|
||||||
|
|
||||||
|
To make grabbing more comfortable and accessible, I implemented a pull-grab mechanic inspired by Half Life Alyx. While the VR Expansion Plugin already implements logic for tossing objects towards the player, the template and many other resources rely on a line trace to get the object to toss. This results in multiple problems, above all the player having to aim very precisely and objects blocking each other.
|
||||||
|
|
||||||
|
To target these issues, I use a multi sphere trace to get all actors in range, saving them to an array. For each, we can check their angle to the hand via the dot product between the hand->forward and hand->object vectors and save them to an array as well. By getting the min of the of the dot product array, we can retrieve the correct object via the index (could've also used a map).
|
||||||
|
|
||||||
|
|
||||||
|
Function: `Trace For Tossable Objects`
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/3xy3o_ve/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
|
|
||||||
|
Function: `Get Angle To Hand`
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/o_fr6mlk/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
|
|
||||||
|
The trace relies on its own collision channel named TossableTrace, allowing for objects like cabinet doors to block this specific trace. As this blocks access to compartments smaller than the trace, there is a second smaller trace doing the same job (only if larger trace is blocked, might be further optimizable).
|
||||||
|
|
||||||
|
As it might not favorable for all components on the actor to be tossable, the Item Data Component (originally introduced for the [Inventory]()) holds an array of primitive components which are quickly added via a library macro on the respective actor (you can't choose primitive components via the dropdown on the component).
|
||||||
|
|
||||||
|
The ribbon between the object and the hand is drawn via a Niagara System getting passed an array of locations.
|
||||||
|
While I was aware of this technique from how the default UE5 VR Template renders its teleport-preview, there is also a [writeup by Steve Streeting](https://www.stevestreeting.com/2025/01/09/niagara-particles-setting-positions-manually/) if you need further information.
|
||||||
|
|
||||||
|
Note: The toss from VRE needs "Simulation Generates Hit Events" enabled to work correctly.
|
||||||
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
title: "Code"
|
title: "Captcha Door"
|
||||||
---
|
---
|
||||||
Example for BlueprintUE
|
Example for BlueprintUE
|
||||||
|
|
||||||
13
sites/codesnippets/CustomAIController.qmd
Normal file
13
sites/codesnippets/CustomAIController.qmd
Normal file
|
|
@ -0,0 +1,13 @@
|
||||||
|
---
|
||||||
|
title: "Follow Spline / AIController"
|
||||||
|
---
|
||||||
|
In Class: `CustomAIController`
|
||||||
|
|
||||||
|
While Navigation builds on the UE AI Controller / Character Movement with NavMeshes, I wanted to implement a more precise way to control the path a NPC takes. Turns out, Unreal doesn't seem to have a "Follow Spline" logic inbuilt, which I found to be a bit trickier than expected. It's currently based of [this Tutorial](https://www.youtube.com/watch?v=UIF1PcmZkGA), which calculates a speed factor from Max Walk Speed and Spline Length and then continuously moves the Actor to the new Point along the Spline at that Value. Adding Jump functionality with this approach added extra complexity as the timeline needs to stop at the correct distance from the Character for the AI not to get confused.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
18
sites/codesnippets/GripRobot.qmd
Normal file
18
sites/codesnippets/GripRobot.qmd
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
---
|
||||||
|
title: "Clarice / Grippable Robot"
|
||||||
|
---
|
||||||
|
What. A. Pain.
|
||||||
|
|
||||||
|
In Class: `BP_Clarice`
|
||||||
|
|
||||||
|
For the main NPC that guides the player - Clarice - I wanted a high degree of interactability. This involves grabbing the robot, e.g. to throw them somewhere to solve riddles, use them as a key or other shenanigans. I also wanted them to be rather flexible when it comes to locomotion (Walk / Fly / Jump / Roll) for it to able to follow the player anywhere.
|
||||||
|
|
||||||
|
Here are some learning from implementing:
|
||||||
|
- Your characters Physics Asset NEEDS a root body when scaled. I personally still struggle with Physics Assets.
|
||||||
|
-
|
||||||
|
|
||||||
|
|
||||||
|
::: {.callout-note}
|
||||||
|
## Thank you
|
||||||
|
A big thank you to Joshua "MordenTral" Statzer (Developer of the VREP) who took personal time to look into my issues with grabbing Skeletal Meshes. The first and only time someone helped me out personally in this project, and also doing so in their free time.
|
||||||
|
:::
|
||||||
13
sites/codesnippets/Inventory.qmd
Normal file
13
sites/codesnippets/Inventory.qmd
Normal file
|
|
@ -0,0 +1,13 @@
|
||||||
|
---
|
||||||
|
title: "Inventory"
|
||||||
|
---
|
||||||
|
|
||||||
|
The Inventory uses a scalable, circular array of widget components the user can put objects in and draw objects out. When the inventory is opened, the player moves their hand towards a widget, which then gets activated. Depending of the content of the widget and content of the hand, an action (put in, pull out, replace) is triggered on inventory close. Compared to [approaches based on a line trace/widget interactor](https://www.youtube.com/watch?v=YE0sfJyraws), I use the distance to the hand for a quicker and "sloppier" interaction.
|
||||||
|
|
||||||
|
Item Data is handled via an Item Data Component, following the guidance of [Ryan Laleys Inventory System Tutorial Series](https://www.youtube.com/watch?v=vHT4MhmwacE&list=PL4G2bSPE_8umjCYXbq0v5IoV-Wi_WAxC3&index=1). The Item Data is drawn from a Data Table.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
18
sites/codesnippets/MainMenu.qmd
Normal file
18
sites/codesnippets/MainMenu.qmd
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
---
|
||||||
|
title: "Main Menu"
|
||||||
|
---
|
||||||
|
In Class: `BP_MainMenu`
|
||||||
|
|
||||||
|
The main menu is composed of several widget components in 3D-Space. The Widget Index defines the depth of the menu, e.g. the widget showing the Audio Settings Widget is accessed from Settings (from Main at Index 0) -> Audio (from Settings at Index -1) -> Audio Widget (at Index -2). Opening a new Menu causes all Widget Indices to increment. Widget with an Index lower than 0 gets collapsed, Widgets with an Index greater 0 get disabled and only at Index 0, the Widget is enabled. On disabled widgets, the last pressed button is altered visually which also gets reset at Index 0.
|
||||||
|
|
||||||
|
All Widget Buttons inherit from the same widget class implementing an enum to save the button function. The button actions are centralized by binding to a custom event dispatcher on the click event, passing the enum to the BP_MainMenu. From there, we can switch on enum and handle the respective functionality. The main thing we need to do manually is running the UpdateIndices Function to increment and making the correct Widget visible (we can't do this automatically as there are multiple Widgets with the same Index).
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/-azlwrm2/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
30
sites/codesnippets/MovablesSoundComponent.qmd
Normal file
30
sites/codesnippets/MovablesSoundComponent.qmd
Normal file
|
|
@ -0,0 +1,30 @@
|
||||||
|
---
|
||||||
|
title: "Movables Sound Component"
|
||||||
|
---
|
||||||
|
In Class: `MovablesSoundComponent`
|
||||||
|
|
||||||
|
This Component is an Actor Component to designed to be attached to Actors that generate Sounds based on their physical movement. This includes standalone objects like a ball or components like drawers in cabinet.
|
||||||
|
|
||||||
|
|
||||||
|
**Detecting Hit and Slide Movements**
|
||||||
|
|
||||||
|
When one object hit another, we expect it to make some kind of hit sound, depending on their qualities (size, material, surface texture etc.) and the hit velocity. A special case is dragging an object across a surface. Although this causes repetitive hits, we don't expect the Hit Sound to be played repetitively but a dedicated "slide sound".
|
||||||
|
To check wether a Hit Event from the simulation should trigger a Hit Sound or a Slide Sound, we can use the velocity vector of the hit component and compare it to to the Hit Normal Vector. When we slide across a surface, the velocity is perpendicular to the impact normal. Using acosd, you can convert the dot product to an angle, which can be easier to work with. Based on an Angle Threshold, you can decide whether a slide should be considered a slide.
|
||||||
|
|
||||||
|
|
||||||
|
::: {.callout-note}
|
||||||
|
## A thought
|
||||||
|
Now that I'm writing it down, you could also make the Threshold depending on the velocity, resulting in slow movements to be more susceptible to "clonks".
|
||||||
|
:::
|
||||||
|
|
||||||
|
|
||||||
|
**Infinite Loops**
|
||||||
|
|
||||||
|
Creating slide sounds involves looping sounds without noticeable repeats. There are several ways to create looping sounds from non-looping sounds. For the DAW [Reaper](https://www.reaper.fm/) that I use for everything audio-related features, there is a helpful [script by X-Raym](https://www.youtube.com/watch?v=yjGDW4wVkEQ) available that automates this process from a time selection.
|
||||||
|
|
||||||
|
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/a6syaqcp/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
18
sites/codesnippets/SaveGame_SPUD.qmd
Normal file
18
sites/codesnippets/SaveGame_SPUD.qmd
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
---
|
||||||
|
title: "SPUD / Save Games"
|
||||||
|
---
|
||||||
|
|
||||||
|
To handle SaveGames and Persistence in Level Streaming, [SPUD](https://github.com/sinbad/SPUD/issues) is used.
|
||||||
|
The WB_CustomSaveLoadScreen used in the [Main Menu]() is largely based of the [SPUD Examples](https://github.com/sinbad/SPUDExamples) SaveLoadScreen Widget.
|
||||||
|
|
||||||
|
Most Variables are passed to the GameInstance, which is especially important for variables that need to exist before the game is loaded, e.g. on the initial Main Menu Map.
|
||||||
|
|
||||||
|
::: {.callout-note}
|
||||||
|
## Note
|
||||||
|
Saving the GameInstance with SPUD via BP should've been be very straight forward, but I was stuck there for multiple days. Eventually I opened up a [Github-Issue](https://github.com/sinbad/SPUD/issues/139) and it was confirmed that the SPUD Subsystem is not ready on Event Init of the BP GameInstance. I went on implementing going the C++ way, [but a delay until the Subsystem is ready should fix that](https://github.com/sinbad/SPUD/commit/416122438c33f1f7d77d0c319876bf763e58db33).
|
||||||
|
:::
|
||||||
|
|
||||||
|
|
||||||
|
Pulling Actors into the persistent Levels
|
||||||
|
|
||||||
|
As a lot objects in VR are interactible and can therefore easily be moved by the player, it's possible that movable objects leave their streaming level boundary and get despawned when their owning level is unloaded. We have to possibilities to fix that: Having all those objects on the persistent level by default, which isn't ideal from an optimization perspective, or move them to the persistent level when the player actually interacts with them. From my knowledge, there is no *proper* way of changing the owning level at runtime but destroying and respawning the actor, which isn't always ideal.
|
||||||
29
sites/codesnippets/Slicegame.qmd
Normal file
29
sites/codesnippets/Slicegame.qmd
Normal file
|
|
@ -0,0 +1,29 @@
|
||||||
|
---
|
||||||
|
title: "Slicegame"
|
||||||
|
lightbox: true
|
||||||
|
---
|
||||||
|
---
|
||||||
|
|
||||||
|
The Slicegame is my attempt at implementing a [Beatsaber](https://beatsaber.com/)-Style Rhythm-Game. It explores Unreals Harmonix Plugin for parsing Midi in Metasounds and Geometry Script for real time boolean operations.
|
||||||
|
|
||||||
|
Given a Midi File, the system in `BP_DynamicObjectSpawner` spawns instances from the class `BP_DynamicHitObject` (the thing you want to hit) on a 3x3 Grid, moves them towards a location over time so it's always at to correct location (PlayerPosition + ArmLength) on the beat. The Midi also encodes from which direction the HitObject should be hit which saved in an Enum in the class during spawn.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Correct Hit detection to me several approaches, its a bit tricky because while our objects (or rather their hit indictors) don't move relative to the character, their angle to the player does change when the objects move from front to back while the player forwards or sideways. The hit detection therefore needs to take the characters view vector into account. From there, you can create up and right vectors and compare them direction of the sword via the dot product.
|
||||||
|
|
||||||
|
In Class : `BP_DynamicHitObject` | Function: `GetHitType`
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/kxu6x76k/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
|
|
||||||
|
As both velocity (sword is wiggly) and impact normal (surface doesn't always point in hit direction) vectors you can get from the hit event turned out to be rather unreliable for detection sword direction, I went with sampling the impact point on hit, attaching that point to the sword by converting the location into the relative space of the sword. After a short delay, that point, virtually attached to sword, has moved. By converting that point back to world transform, we can calculate the direction by subtracting hit location and delay sampled location. This works quite reliably.
|
||||||
|
|
||||||
|
|
||||||
|
In Class : `BP_DynamicHitObject`
|
||||||
|
```{=html}
|
||||||
|
<iframe width="100%" height="500" src="https://blueprintue.com/render/1g36zapg/" scrolling="no" allowfullscreen></iframe>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -3,14 +3,14 @@ title: "Project Setup"
|
||||||
---
|
---
|
||||||
If you want to take a look inside a project, there are currently three important repositories:
|
If you want to take a look inside a project, there are currently three important repositories:
|
||||||
|
|
||||||
- VIRTUOS_Playground: The repository contains the Unreal Engine Project
|
- [VIRTUOS_Playground](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground): The repository contains the Unreal Engine Project
|
||||||
- VIRTUOS_Assets: Contains all Project related assets like 3D-Models, Graphics etc.
|
- [VIRTUOS_Assets](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Assets): Contains all Project related assets like 3D-Models, Graphics etc.
|
||||||
- VIRTUOS_Documents: Contains all written Documents
|
- [VIRTUOS_Documents](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Documents): Contains all written Documents
|
||||||
- VIRTUOS_Docs: The Documentation in QUarto (which you're reading right now)
|
- [VIRTUOS_Docs](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs): The Documentation of this Project (which you're reading right now)
|
||||||
|
|
||||||
# Setting up the project with UE5
|
# Setting up the project with UE5
|
||||||
|
|
||||||
If you're familiar with Git, you'll likely already know how to get the files.
|
If you're familiar with Git, you'll likely already know how to get the files from the repository:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git pull https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs.git
|
git pull https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs.git
|
||||||
|
|
@ -22,7 +22,7 @@ Hit `File -> Clone repository`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Enter the repository from `code.virtuos.world` you want to clone, e.g. https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground.git
|
Enter the repository from `code.virtuos.world` you want to clone, e.g. <https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Playground.git>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -31,20 +31,22 @@ Enter the repository from `code.virtuos.world` you want to clone, e.g. https://c
|
||||||
|
|
||||||
The project uses the following external Plugins:
|
The project uses the following external Plugins:
|
||||||
|
|
||||||
- VR Expansion Plugin, see https://github.com/mordentral/VRExpansionPlugin
|
- [VR Expansion Plugin](https://github.com/mordentral/VRExpansionPlugin)
|
||||||
- SPUD: Steve's Persistent Unreal Data library, see https://github.com/sinbad/SPUD
|
- [SPUD: Steve's Persistent Unreal Data library](https://github.com/sinbad/SPUD)
|
||||||
|
- [SUDS: Steve's Unreal Dialogue System](https://github.com/sinbad/SUDS)
|
||||||
|
- [StevesUEHelpers: Steve's UE Helper Plugin Library](https://github.com/sinbad/StevesUEHelpers)
|
||||||
|
|
||||||
The Plugins are already in the /Plugins folder
|
|
||||||
|
The Plugins are already in the /Plugins folder and should build with the project without errors. For manual installation, see the respective Documentation.
|
||||||
|
|
||||||
# Building the project
|
# Building the project
|
||||||
|
|
||||||
Note: To build the project, you'll need Visual Studio installed on your system.
|
To build the project, you'll need Visual Studio installed on your system.
|
||||||
|
|
||||||
|
|
||||||
<ol>
|
<ol>
|
||||||
<li>Right click the .uproject file and hit `Generate Visual Studio project files`. </li>
|
<li>Right click the .uproject file and hit `Generate Visual Studio project files`. </li>
|
||||||
<li>Open the newly generated .sln file in Visual Studio. From there, hit `Build -> Build solution`.</li>
|
<li>Open the newly generated .sln file in Visual Studio. From there, hit `Build -> Build solution`.</li>
|
||||||
</ol>
|
</ol>
|
||||||
|
|
||||||
|
Note: This may take a while.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
title: "Websevices"
|
title: "Webservices"
|
||||||
---
|
---
|
||||||
# Forgejo
|
# Forgejo
|
||||||
|
|
||||||
|
|
@ -191,7 +191,7 @@ sudo docker-compose up -d
|
||||||
|
|
||||||
- To redirect the homepage to the repository view:
|
- To redirect the homepage to the repository view:
|
||||||
|
|
||||||
```nginx
|
```bash
|
||||||
server {
|
server {
|
||||||
server_name code.virtuos.world;
|
server_name code.virtuos.world;
|
||||||
|
|
||||||
|
|
@ -311,21 +311,10 @@ Wordpress updates itself. Plugins may need manual updating via the Wordpress Int
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Wiki.js
|
|
||||||
|
|
||||||
Wiki.js was dumped in favour of Quarto.
|
# Quarto
|
||||||
|
|
||||||
Wiki.js is an open source Wiki software. The Wiki.js instance is hosted on Uberspace.de and you are currently accessing it on [https://docs.virtuos.world](https://docs.virtuos.world).
|
I switched from Wiki.js to Quarto, a static site generator. All files are in [this repository](https://code.virtuos.world/VIRTUOS_WORLD/VIRTUOS_Docs).
|
||||||
|
|
||||||
## Installation on Uberspace
|
|
||||||
|
|
||||||
The Wiki.js installation is well documented on
|
|
||||||
[https://lab.uberspace.de/guide_wiki-js/](https://lab.uberspace.de/guide_wiki-js/)
|
|
||||||
|
|
||||||
## Updating Wiki.js
|
|
||||||
|
|
||||||
An update script is available at the same location:
|
|
||||||
[https://lab.uberspace.de/guide_wiki-js/](https://lab.uberspace.de/guide_wiki-js/)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -334,7 +323,22 @@ An update script is available at the same location:
|
||||||
Pretix is an open source ticketing system. It's currently not in use. This installation is not as easy, but well documented here:
|
Pretix is an open source ticketing system. It's currently not in use. This installation is not as easy, but well documented here:
|
||||||
[https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html](https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html)
|
[https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html](https://docs.pretix.eu/en/latest/admin/installation/docker_smallscale.html)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
# BlueprintUE
|
# BlueprintUE
|
||||||
|
|
||||||
I failed to host BlueprintUE multiple times (I don't know.=). I gave up and use the official page at https://blueprintue.com/profile/waldo/.
|
I failed to host BlueprintUE multiple times (I don't know uwu). I gave up and use the official page at https://blueprintue.com/profile/waldo/.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
~~# Wiki.js~~
|
||||||
|
|
||||||
|
~~Wiki.js is an open source Wiki software. The Wiki.js instance is hosted on Uberspace.de and you are currently accessing it on [https://docs.virtuos.world](https://docs.virtuos.world).~~
|
||||||
|
|
||||||
|
~~## Installation on Uberspace~~
|
||||||
|
|
||||||
|
~~The Wiki.js installation is well documented on [https://lab.uberspace.de/guide_wiki-js/](https://lab.uberspace.de/guide_wiki-js/)~~
|
||||||
|
|
||||||
|
~~## Updating Wiki.js~~
|
||||||
|
|
||||||
|
~~An update script is available at the same location: [https://lab.uberspace.de/guide_wiki-js/](https://lab.uberspace.de/guide_wiki-js/)~~
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue