Implement Nik's Multithreading

.github/ISSUE_TEMPLATE/build-error-and-visual-studio-problems.md

@@ -2,7 +2,7 @@
 name: Build Error and Visual Studio Problems
 about: For errors when trying to build a Cosmos Kernel or use VS
 title: ''
-labels: ''
+labels: 'Area: Build, Area: Visual Studio Integration'
 assignees: ''
 
 ---
@@ -24,6 +24,8 @@ If applicable, add screenshots to help explain your problem.
 **Context**
 Before posting please confirm that the following are in order
 [ ] Both Cosmos VS Extensions are installed
-[ ] The Cosmos nuget packages are installed
+[ ] In the NuGet Package Manager "Include prerelease" is selected
+[ ] The Cosmos NuGet package store is selected (NOT nuget.org) in 'Manage NuGet Packages'
+[ ] The Cosmos NuGet packages are installed
 
 Add any other context about the problem which might be helpful.

.github/ISSUE_TEMPLATE/docs_or_website.md

@@ -0,0 +1,16 @@
+---
+name: Documentation/Website Bug Report
+about: For bugs involving the Cosmos documentation & website
+title: ''
+labels: 'Area: Documentation'
+assignees: ''
+
+---
+
+#### URL of Documentation - What page of documentation are we dealing with?
+
+
+#### Expected Behaviour - What do you think should happen?
+
+
+#### Actual Behaviour - What is the issue?

.github/workflows/stale.yml

@@ -0,0 +1,23 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: "30 1 * * *"
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'As this issue has received no new activity, it has been marked as stale'
+        stale-pr-message: 'As this pull request has received no new activity, it has been marked as stale'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'
+        exempt-issue-labels: 'Up for Grabs,Blocked,PR submitted'
+        exempt-pr-labels: 'Work in progress'
+        exempt-all-milestones: true
+        exempt-all-assignees: true

Docs/articles/GettingStarted.md

@@ -27,8 +27,8 @@ so overwhelming like the dev kit. This article focuses on the user kit.
 
 ##  Writing your first Operating System
 
-Create a new project as you would any C# project, but select Cosmos as the
-project type.
+Create a new project as you would any C# project, but select Cosmos Kernel  
+(Previously CosmosBoot; same functionality) as the project type.
 
 ![](images/SNAG-0000.png)
 
@@ -126,7 +126,7 @@ and it will appear in the Visual Studio output window.
 
 ##  What's the catch?
 
-There really is no catch. Everything We've shown here is functioning as seen.
+There really is no catch. Everything we've shown here is functioning as seen.
 No mockups were used. However we still have a lot of work to go. Items of
 interest that are on our current task list include interfaces (necessary for
 foreach loops), file systems (partial support exists), threads, networking, and
@@ -137,7 +137,7 @@ rolled into the mainline Cosmos development as of yet.
 
 Cosmos does not run on Linux. A boot loader called Syslinux is used to boot
 Cosmos. After booting, Syslinux is not used. Syslinux is a bootloader and is
-not a Linux distro. Syslinux simplifies the booting process by doing tasks such as enabline the A20 gate, initializing hardware, and switching to real mode (all of which are required by modern operating systems).
+not a Linux distro. Syslinux simplifies the booting process by doing tasks such as enabling the A20 gate, initializing hardware, and switching to real mode (all of which are required by modern operating systems).
 
 ##  Obtaining Cosmos
 

Docs/articles/Kernel/CGS.md

@@ -1,8 +1,8 @@
 # Introduction
 
-The Cosmos Graphic Subsystem (CGS from now on) is based on the abstraction of Canvas that is an empty space in which the user of CGS can draw its content. CGS is not a widget toolkit as Winforms or Gnome / GTK but is tough to be more lower level and it will be the basic in which widget toolkits will be implemented. CGS hides the graphics driver (so far VGA and VBE) used and it is tough to be the universal way to draw on the screen in Cosmos.
+The Cosmos Graphic Subsystem (CGS from now on) is based on the abstraction of Canvas that is an empty space in which the user of CGS can draw its content. CGS is not a widget toolkit as Winforms or Gnome / GTK but is thought to be more lower level and it will be the basic in which widget toolkits will be implemented. CGS hides the graphics driver (so far VGA, VBE and SVGA II) used and it is thought to be the universal way to draw on the screen in Cosmos.
 
-While Canvas could be overwritten (for example to create sub windows) the user of CGS does not have to deal with it directly but it must use the static class FullScreenCanvas.
+While Canvas could be overwritten (for example to create sub windows) the user of CGS does not have to deal with it directly but they must use the static class FullScreenCanvas.
 
 Let's give a look to its API methods.
 # FullScreenCanvas
@@ -24,6 +24,10 @@ To really draw into the screen we need to use the Canvas class. Let's give a loo
     void DrawPoint(Pen pen, int x, int y) draws a point at the coordinates specified by x and y with the specified pen
     void DrawLine(Pen pen, int x_start, int y_start, int x_end, int y_end) draws a line at the coordinates specified by x_start, y_start and x_end, y_end with the specified pen
     void DrawRectangle(Pen pen, int x_start, int y_start,int width, int height) draws a rectangle specified by a coordinate pair, a width, and a height with the specified pen
+    void DrawImage(Image image, int x, int y) draws an image at the x and y specified
+    void DrawString(String string, Font font, Brush brush, int x, int y) draws a string with the specified font and brush at the specified x and y coordinates
+    void Display() only for double buffering, swaps the 2 buffers then display everything to the screen
+
 
 Really simple right?
 # A working example
@@ -38,72 +42,84 @@ namespace GraphicTest
     {
         Canvas canvas;
 
+        private readonly Bitmap bitmap = new Bitmap(10, 10,
+                new byte[] { 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0,
+                    255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255,
+                    0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255,
+                    0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 23, 59, 88, 255,
+                    23, 59, 88, 255, 0, 255, 243, 255, 0, 255, 243, 255, 23, 59, 88, 255, 23, 59, 88, 255, 0, 255, 243, 255, 0,
+                    255, 243, 255, 0, 255, 243, 255, 23, 59, 88, 255, 153, 57, 12, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255,
+                    243, 255, 0, 255, 243, 255, 153, 57, 12, 255, 23, 59, 88, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243,
+                    255, 0, 255, 243, 255, 0, 255, 243, 255, 72, 72, 72, 255, 72, 72, 72, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0,
+                    255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 72, 72,
+                    72, 255, 72, 72, 72, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255,
+                    10, 66, 148, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255,
+                    243, 255, 10, 66, 148, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 10, 66, 148, 255, 10, 66, 148, 255,
+                    10, 66, 148, 255, 10, 66, 148, 255, 10, 66, 148, 255, 10, 66, 148, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255,
+                    243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 10, 66, 148, 255, 10, 66, 148, 255, 10, 66, 148, 255, 10, 66, 148,
+                    255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255,
+                    0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, 0, 255, 243, 255, }, ColorDepth.ColorDepth32);
+
         protected override void BeforeRun()
         {
-            /* If all works correctly you should not really see this :-) */
-            Console.WriteLine("Cosmos booted successfully. Let's go in Graphic Mode");
-
-            canvas = FullScreenCanvas.GetFullScreenCanvas();
+            // If all works correctly you should not really see this :-)
+            Console.WriteLine("Cosmos booted successfully. Let's go in Graphical Mode");
 
+            // You don't have to specify the Mode, but here we do to show that you can.
+            canvas = FullScreenCanvas.GetFullScreenCanvas(new Mode(640, 480, ColorDepth.ColorDepth32));
             canvas.Clear(Color.Blue);
         }
 
         protected override void Run()
         {
             try
             {
-                /* A red Point */
                 Pen pen = new Pen(Color.Red);
+
+                // A red Point
                 canvas.DrawPoint(pen, 69, 69);
 
-                /* A GreenYellow horizontal line */
+                // A GreenYellow horizontal line
                 pen.Color = Color.GreenYellow;
                 canvas.DrawLine(pen, 250, 100, 400, 100);
 
-                /* An IndianRed vertical line */
+                // An IndianRed vertical line
                 pen.Color = Color.IndianRed;
                 canvas.DrawLine(pen, 350, 150, 350, 250);
 
-                /* A MintCream diagonal line */
+                // A MintCream diagonal line
                 pen.Color = Color.MintCream;
                 canvas.DrawLine(pen, 250, 150, 400, 250);
 
-                /* A PaleVioletRed rectangle */
+                // A PaleVioletRed rectangle
                 pen.Color = Color.PaleVioletRed;
                 canvas.DrawRectangle(pen, 350, 350, 80, 60);
 
-                Console.ReadKey();
-
-                /* Let's try to change mode...*/
-                canvas.Mode = new Mode(800, 600, ColorDepth.ColorDepth32);
-
-                /* A LimeGreen rectangle */
+                // A LimeGreen rectangle
                 pen.Color = Color.LimeGreen;
                 canvas.DrawRectangle(pen, 450, 450, 80, 60);
 
-                Console.ReadKey();
+                // A bitmap
+                canvas.DrawImage(bitmap, new Point(100, 150));
 
-                Stop();
+                Console.ReadKey();
+                Sys.Power.Shutdown();
             }
             catch (Exception e)
             {
                 mDebugger.Send("Exception occurred: " + e.Message);
-                mDebugger.Send(e.Message);
-                Stop();
+                Sys.Power.Shutdown();
             }
         }
     }
 }
 ```
-# Limitation of the current implementation
-
-1. Only the Bochs Graphic Adapter is actually supported; this means that CGS will work only on Bochs, QEMU and VirtualBox. CGS does not make any assumption on the underlying hardware, simple a VGA driver should be adapted to use it. No change to user code should be required to use another driver
-2. Only 32 bit color depth is actually supported, the API provides methods to set a resolution with 24, 16, 8 and 4 bit but the low level Bochs driver has not yet implemented them
-3. CGS does not permits yet to do basic operations that would permit to fulfill its promise to be the basic block from which a "Widget Toolkit" could be derived for example these methods should be added:
-    DrawFilledRectangle((Pen pen, int x_start, int y_start,int width, int height)
-    void DrawImage(Image image, int x, int y) Canvas has already defined this method but it is not yet implemented
-    void DrawString(String string, Font font, Brush brush, int x, int y) Canvas has already defined this method but it is not yet implemented
-    .Net System.Drawing has overload of these methods taking a float to evaluate if they are really needed for CGS, they are defined but for now no implementation is provided
-    A double buffering strategy could be implemented to make it faster
-    This is more a limitation of the Bochs driver when the Graphic Mode is set there is no more a way to return to text mode
-    CGS / Graphic Mode interacts badly with the Kernel.Stop method: Bochs does not exit cleanly. You must use Sys.Power.Shutdown to shut down correctly your computer.
+# Limitations of the current implementation
+
+1. Only 32 bit color depth is actually supported, the API provides methods to set a resolution with 24, 16, 8 and 4 bit but the low level Bochs driver has not yet implemented them.
+
+2. In addition, some other nice things could be implemented:
+    - Plugging System.Drawing functions for easier manipulation of colors
+    - A double buffering strategy, to make drawing faster (one is already implemented in the VBE driver, but not VGA or SVGA II)
+
+3. CGS interacts badly with the Kernel.Stop method: the screen will freeze without displaying any error message whatsoever. You must use the Sys.Power.Shutdown() function to properly shut down your computer.