Matyasf.Perlin 1.2.1

.NET Core 3.1
dotnet add package Matyasf.Perlin --version 1.2.1
NuGet\Install-Package Matyasf.Perlin -Version 1.2.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Matyasf.Perlin" Version="1.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Matyasf.Perlin --version 1.2.1
#r "nuget: Matyasf.Perlin, 1.2.1"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Matyasf.Perlin as a Cake Addin
#addin nuget:?package=Matyasf.Perlin&version=1.2.1

// Install Matyasf.Perlin as a Cake Tool
#tool nuget:?package=Matyasf.Perlin&version=1.2.1

Perlin

Perlin (named from a bird) is a lightweight 2D graphics engine for .NET Core using Veldrid. It's well documented, has a simple architecture and is meant to be more as a base code for your engine than something that does everything out-of-the-box.

Currently its working on Windows, OSX, Linux, in the near future I plan to get it work on Android and iOS.

Features

  • Uses the display tree concept (see below) to render your scene.
  • Simple text rendering included.
  • Mouse and keyboard handling code included.
  • Can display parts of image regions as a simple texture atlas support.
  • Desktop window management via SDL2.
  • Thanks to Veldrid it automatically chooses the ideal rendering backend for your PC (Vulkan/Metal/OpenGL/DirectX..)
  • Loads images via ImageSharp, so common formats (jpg, png, bmp, gif) are supported.

The display tree

painter's algorithm in steps. Image from Wikipedia

Perlin puts the objects to render in a display tree similar to other rendering engines (HTML DOM, Android's GUI, Microsoft's WPF,..). The root of the display tree (called Stage) has children, these can also have children and so on creating a tree data structure. Every object in the display tree is a subclass of DisplayObject, here lie the common properties, like Width, Height, Rotation,... Transformations in the display tree are cumulative, e.g. if you set the transparency/rotation/position/scale of an object its every descendant (child, grandchild,..) will be affected as well.

The Z-order (what is rendered in front of what) is determined based on the position of the display tree. An object will be always behind its children; the order between the children is that the first child will be in the back and the last one in the front.

Getting started

A simple Hello world code that will show a rotating rectangle and a textfield:

using Perlin;
using Perlin.Display;
using SixLabors.Fonts;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

namespace Hello
{
    public class HelloWorld
    {
        public static void Main()
        {
            new HelloWorld();
        }
        
        public HelloWorld()
        {
            PerlinApp.Start(400, 300, "Hello Perlin!", OnInit);
        }

        private void OnInit()
        {
            PerlinApp.Stage.BackgroundColor = new Rgb24(200, 200, 200);
            
            var textField = new TextField(PerlinApp.FontRobotoMono.CreateFont(18));
            textField.Text = "Hello world!";
            textField.BackgroundColor = Color.Coral;
            textField.FontColor = Color.White;
            textField.X = 150;
            textField.Y = 100;
            PerlinApp.Stage.AddChild(textField);
            
            var sp = new Sprite(40, 40, Color.Gold);
            sp.X = 50;
            sp.Y = 50;
            // the EnterFrameEvent fires in each frame
            sp.EnterFrameEvent += (target, secs) => sp.Rotation++;
            PerlinApp.Stage.AddChild(sp);
        }
    }
}

License

Copyright 2020- Matyas Forian Szabo and code contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use files in this project except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp3.1
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.1 420 9/22/2020
1.2.0 402 9/17/2020
1.1.1 415 9/16/2020
1.1.0 401 9/15/2020
1.0.0 507 1/29/2020

Linux support;
Fix text sometimes getting cropped when autosizing