Skip to content

Commit 02abad0

Browse files
authored
Merge pull request #62 from SteveSuv/main
- Readme & nuget readme minimal project setup code fixes and nuget install shell line added - Change ShapeEngine.Lib to ShapeEngine.StaticLib
2 parents 7ef2eb4 + 6d912b4 commit 02abad0

File tree

3 files changed

+20
-16
lines changed

3 files changed

+20
-16
lines changed

Examples/Scenes/ExampleScenes/ProjectedShapesExample.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
using ShapeEngine.Core.Shapes;
66
using ShapeEngine.Core.Structs;
77
using ShapeEngine.Input;
8-
using ShapeEngine.Lib;
8+
using ShapeEngine.StaticLib;
99
using ShapeEngine.Random;
1010
namespace Examples.Scenes.ExampleScenes;
1111
public class ProjectedShapesExample : ExampleScene

README.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,20 @@ When using Shape Engine everything from Raylib is available as well. ([Raylib Ex
2525
![Gapped Drawing 2](media/gapped-drawing2.gif)
2626
![Screem Texture 2.0](media/screen-texture-2.0.gif)
2727

28+
## Installation / How to Use
29+
30+
There are multiple ways to use Shape Engine:
31+
32+
1. **Create a new solution & project and download Shape Engine from the Nuget manager.** (Recommended)
33+
```sh
34+
dotnet add package DaveGreen.ShapeEngine
35+
```
36+
2. Clone or fork the repository and add new projects to the solution. You then can reference the Shape Engine project and start working on your game. The advantages are that you can easily change things in Shape Engine and everything updates automatically in your own project.
37+
3. Create a new solution & project in a .net IDE. (Visual Studio / JetBrains Rider for example). Download or fork ShapeEngine and either create a local nuget package or build the solution to create all necessary dll files.
38+
1. [Using a local Nuget Package] Create a folder on your machine called something like “Local Nuget Packages” and copy the ShapeEngine Nuget package that you created to this folder. (You can also add the Shape Engine Nuget package directly to your Project). Now you need to create a new Package source in the Nuget Manager that points to your “Local Nuget Packages” Folder. This source can be used in your Nuget Manager to find and install the Shape Engine Nuget Package.
39+
2. You manually copy all needed DLL files to your project. You need the following DLLs: Clipper2Lib, Raylib-Cs, Microsoft.Toolkit.HighPerformance, Shape Engine Core, Raylib. All DLL files except Raylib can be anywhere in your projects folder hierarchy. The Raylib DLL must be on the root level of your project. You need to select the right Raylib DLL for your operating system. Now just add a reference for all DLLs except the Raylib DLL and you are done. On MacOS you need to do the same step except using the .dylib file instead of the raylib DLL. You need to set the property “Copy if Newer” to true on the .dylib file. Then everything should work.
40+
4. Create a new solution & project and just add the Shape Engine Core DLL to your project and reference it. Now you need to download the right version of the Raylib_CsLo & Clipper2 Nuget packages. The releases on GitHub will state which versions were used.
41+
2842
## Minimal Project Setup
2943

3044
```c#
@@ -33,7 +47,7 @@ using System.Drawing;
3347
using ShapeEngine.Color;
3448
using ShapeEngine.Core;
3549
using ShapeEngine.Core.Structs;
36-
using ShapeEngine.Lib;
50+
using ShapeEngine.StaticLib.Drawing;
3751

3852
namespace ShapeEngineProject;
3953

@@ -74,19 +88,6 @@ The Main Branch contains the current development stage. You can follow the devel
7488
- [Roadmap](https://github.com/DaveGreen-Games/ShapeEngine/discussions/4)
7589

7690

77-
78-
## Installation / How to Use
79-
80-
There are multiple ways to use Shape Engine:
81-
82-
1. **Create a new solution & project and download Shape Engine from the Nuget manager.** (Recommended)
83-
2. Clone or fork the repository and add new projects to the solution. You then can reference the Shape Engine project and start working on your game. The advantages are that you can easily change things in Shape Engine and everything updates automatically in your own project.
84-
3. Create a new solution & project in a .net IDE. (Visual Studio / JetBrains Rider for example). Download or fork ShapeEngine and either create a local nuget package or build the solution to create all necessary dll files.
85-
1. [Using a local Nuget Package] Create a folder on your machine called something like “Local Nuget Packages” and copy the ShapeEngine Nuget package that you created to this folder. (You can also add the Shape Engine Nuget package directly to your Project). Now you need to create a new Package source in the Nuget Manager that points to your “Local Nuget Packages” Folder. This source can be used in your Nuget Manager to find and install the Shape Engine Nuget Package.
86-
2. You manually copy all needed DLL files to your project. You need the following DLLs: Clipper2Lib, Raylib-Cs, Microsoft.Toolkit.HighPerformance, Shape Engine Core, Raylib. All DLL files except Raylib can be anywhere in your projects folder hierarchy. The Raylib DLL must be on the root level of your project. You need to select the right Raylib DLL for your operating system. Now just add a reference for all DLLs except the Raylib DLL and you are done. On MacOS you need to do the same step except using the .dylib file instead of the raylib DLL. You need to set the property “Copy if Newer” to true on the .dylib file. Then everything should work.
87-
4. Create a new solution & project and just add the Shape Engine Core DLL to your project and reference it. Now you need to download the right version of the Raylib_CsLo & Clipper2 Nuget packages. The releases on GitHub will state which versions were used.
88-
89-
9091
## Examples
9192

9293
> You can download the newest builds of the Example Project on [Itch io](https://davegreengames.itch.io/shape-engine). You can clone the repo and inspect the example projects there as well.

ShapeEngine/readme-nuget.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,9 @@ The Main Branch contains the current development stage. You can follow the devel
2626
There are multiple ways to use Shape Engine:
2727

2828
1. **Create a new solution & project and download Shape Engine from the Nuget manager.** (Recommended)
29+
```sh
30+
dotnet add package DaveGreen.ShapeEngine
31+
```
2932
2. Clone or fork the repository and add new projects to the solution. You then can reference the Shape Engine project and start working on your game. The advantages are that you can easily change things in Shape Engine and everything updates automatically in your own project.
3033
3. Create a new solution & project in a .net IDE. (Visual Studio / JetBrains Rider for example). Download or fork ShapeEngine and either create a local nuget package or build the solution to create all necessary dll files.
3134
1. \[Using a local Nuget Package\] Create a folder on your machine called something like “Local Nuget Packages” and copy the ShapeEngine Nuget package that you created to this folder. (You can also add the Shape Engine Nuget package directly to your Project). Now you need to create a new Package source in the Nuget Manager that points to your “Local Nuget Packages” Folder. This source can be used in your Nuget Manager to find and install the Shape Engine Nuget Package.
@@ -40,7 +43,7 @@ using System.Drawing;
4043
using ShapeEngine.Color;
4144
using ShapeEngine.Core;
4245
using ShapeEngine.Core.Structs;
43-
using ShapeEngine.Lib;
46+
using ShapeEngine.StaticLib.Drawing;
4447
4548
namespace ShapeEngineProject;
4649

0 commit comments

Comments
 (0)