From a9e74082dee0009d5789e391bc683f5760eeae73 Mon Sep 17 00:00:00 2001 From: Rue <135553058+Ruemena@users.noreply.github.com> Date: Wed, 27 Dec 2023 20:22:30 -0800 Subject: [PATCH 1/4] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a9c964f..33a45d5 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # RueI [![build and unit tests](https://github.com/Ruemena/RueI/actions/workflows/main.yml/badge.svg)](https://github.com/Ruemena/RueI/actions/workflows/main.yml) -RueI is a hint framework for scp:sl +RueI is a hint framework, designed to be the definitive way to display multiple hints at once docs are available [here](https://ruemena.github.io/RueI/). From 2b6c535ff013b227c8137fdd5bd19446dd0394bc Mon Sep 17 00:00:00 2001 From: Rue <135553058+Ruemena@users.noreply.github.com> Date: Wed, 27 Dec 2023 20:59:49 -0800 Subject: [PATCH 2/4] Create basic-concepts.md --- markdown/basic-concepts.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 markdown/basic-concepts.md diff --git a/markdown/basic-concepts.md b/markdown/basic-concepts.md new file mode 100644 index 0000000..e7fa170 --- /dev/null +++ b/markdown/basic-concepts.md @@ -0,0 +1,13 @@ +# Basic Concepts +this serves as a basic introduction to RueI concepts and functionality. + +the most basic components of RueI are [Elements](../api/RueI.Elements.Element.html), which act like individual hints with their own content. elements are contained within [DisplayBases](../api/RueI.Displays.DisplayBases.html). elements are not tied to a player (so you can have an instance of an element in multiple displays at once), but displays are. + +finally, every ReferenceHub (player) in RueI has an associated [DisplayCore](../api/RueI.Displays.DisplayCore.html), which manages all of the displays for a player and combines the elements in them to one hint. every DisplayCore also has a [Scheduler](../api/RueI.Displays.Scheduling.Scheduler), enabling synchronized delayed updates. + +there are two element types that RueI provides out of the box: + +- [SetElement](../api/RueI.Elements.SetElement.html): a very simple element with settable content +- [DynamicElement](../api/RueI.Elements.DynamicElement.html): an element that, when the display is updated/refreshed, gets its content by calling a function. + +every time you update something in RueI, such as the content of an element, you must update the DisplayCore by calling [DisplayCore.Update()](../api/RueI.Displays.DisplayCore.html#RueI_Displays_DisplayCore_Update_System_Int32_). you can get the DisplayCore for a player by calling [DisplayCore.Get(ReferenceHub)](../api/RueI.Displays.DisplayCore.html#RueI_Displays_DisplayCore_Get_ReferenceHub_). while it's easy to forget to do this, this is unfortunately necessary. From 3cf82f6e1950aac936f19ccc8d6ceedf7036b073 Mon Sep 17 00:00:00 2001 From: Rue <135553058+Ruemena@users.noreply.github.com> Date: Wed, 27 Dec 2023 21:00:17 -0800 Subject: [PATCH 3/4] Update toc.yml --- markdown/toc.yml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/markdown/toc.yml b/markdown/toc.yml index 18a5508..7a1c2d8 100644 --- a/markdown/toc.yml +++ b/markdown/toc.yml @@ -2,9 +2,11 @@ href: introduction.md - name: Getting Started href: getting-started.md +- name: Basic Concepts + href: basic-concepts.md - name: Using the Scheduler href: scheduling.md - name: HintBuilding Extensions href: hintbuilding.md - name: eMEC Guide - href: eMec.md \ No newline at end of file + href: eMec.md From 8d6b8b2054339a37eb6a3713ee13fb15fa2532ad Mon Sep 17 00:00:00 2001 From: Rue <135553058+Ruemena@users.noreply.github.com> Date: Wed, 27 Dec 2023 23:20:27 -0600 Subject: [PATCH 4/4] Update basic-concepts.md --- markdown/basic-concepts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/markdown/basic-concepts.md b/markdown/basic-concepts.md index e7fa170..78ca8d1 100644 --- a/markdown/basic-concepts.md +++ b/markdown/basic-concepts.md @@ -1,7 +1,7 @@ # Basic Concepts this serves as a basic introduction to RueI concepts and functionality. -the most basic components of RueI are [Elements](../api/RueI.Elements.Element.html), which act like individual hints with their own content. elements are contained within [DisplayBases](../api/RueI.Displays.DisplayBases.html). elements are not tied to a player (so you can have an instance of an element in multiple displays at once), but displays are. +the most basic components of RueI are [Elements](../api/RueI.Elements.Element.html), which act like individual hints with their own content. elements are contained within [DisplayBases](../api/RueI.Displays.DisplayBase.html). elements are not tied to a player (so you can have an instance of an element in multiple displays at once), but displays are. finally, every ReferenceHub (player) in RueI has an associated [DisplayCore](../api/RueI.Displays.DisplayCore.html), which manages all of the displays for a player and combines the elements in them to one hint. every DisplayCore also has a [Scheduler](../api/RueI.Displays.Scheduling.Scheduler), enabling synchronized delayed updates.