AOTLogoSharp.Drawing 1.2.0

AOTLogoSharp

Logo programming language for managed world.

中文文档

What's Logo?

Logo is a programming language that controls a turtle on the screen to draw amazing pictures, like below:

More beautiful pictures drawn by AOTLogoSharp:

• Box Picture

  

• Beautiful Flower

  

• Square Flower

  

• Web

  

Logo is widely used in computer education for kids, as it is simple and interesting. AOTLogoSharp is a .NET implementation of the Logo programming language which is based on a hand-written recursive descent parser.

Why AOTLogoSharp?

AOTLogoSharp is fully compatible with Native AOT and trimming. You can publish your application as a single native executable with minimal size and fast startup, without any JIT overhead. This makes it ideal for scenarios where deployment size and startup speed matter, such as command-line tools, educational apps, or embedded drawing pipelines.

The assembly names remain LogoSharp.dll and LogoSharp.Drawing.dll, and the namespace stays as LogoSharp / LogoSharp.Drawing, so existing code that references the original LogoSharp can migrate by simply swapping the NuGet package.

How to use AOTLogoSharp?

It is very simple and straightforward to use AOTLogoSharp in your .NET projects that is either based on .NET Framework 4.8, .NET Standard 2.0, or .NET 10. This means that you can make your AOTLogoSharp app working with .NET Core and thereby provides the cross-platform capability.

1. Install AOTLogoSharp NuGet Package, for example:

Install-Package AOTLogoSharp -Version 1.0.0

2. Write your first app:

using LogoSharp;

static void Main(string[] args)
{
    var logo = new Logo();
    logo.Forward += (s, e)
        => Console.WriteLine($"Forwarded {e.Steps} steps.");
    logo.Execute("FD 102");
}

3. Run your app, you should get the message Forwarded 102 steps. on your console

Basically, a Logo program code is provided to the Execute method of the logo instance, AOTLogoSharp will execute the code and emit the events. Therefore, event handlers that subscribe to a particular event will be hit once the execution of the code emits the subscribed event.

For more information about how to use AOTLogoSharp, please refer to the LogoSharp.Drawing project.

Using AOTLogoSharp.Drawing

AOTLogoSharp.Drawing provides a Turtle class that renders Logo programs to images. It is also available as the AOTLogoSharp.Drawing NuGet package.

1. Install AOTLogoSharp.Drawing NuGet Package, for example:

Install-Package AOTLogoSharp.Drawing -Version 1.0.0

2. Write your first app:

using LogoSharp;
using LogoSharp.Drawing;
using SkiaSharp;

static void Main(string[] args)
{
    var turtle = new Turtle();
    var logo = new Logo();

    // Wire Logo events to the Turtle
    logo.Forward += (s, e) => turtle.MoveForward(e.Steps);
    logo.TurnRight += (s, e) => turtle.Right(e.Angle);
    logo.PenDown += (s, e) => turtle.PenStatus = PenStatus.Down;
    logo.SetPenColor += (s, e) => turtle.SetPenColor(e.R, e.G, e.B);

    logo.Execute(@"
        REPEAT 4 [
            FD 100
            RT 90
        ]
    ");

    turtle.Save("output.png");
}

The Turtle class exposes the following APIs:

• SetCanvasSize(int width, int height) - set the canvas size
• ShowTurtle() / HideTurtle() - toggle turtle visibility
• Save(string fileName) - save the rendered image to a file
• GetLineSegments() - get the list of drawn line segments for custom rendering
• GetTurtleState() - get the current turtle position, angle, and visibility
• DelayMilliseconds - control the delay between drawing steps. The delay only applies to drawing operations (PENDOWN / PENERASE). Non-drawing moves (e.g. SetX/SetY/SetXY/MoveForward while PENUP) are instantaneous, so repositioning the turtle with the pen up does not stall the program.

Key Features

AOTLogoSharp provides the following commands and features:

• Basic Pen Commands
  • PENDOWN/PD
  • PENUP/PU
  • SETPENCOLOR/SETPC/PC
  • SETPENSIZE
  • PENERASE/PE
  • PENNORMAL/PN
• Basic Drawing Commands
  • LEFT/LT
  • RIGHT/RT
  • FORWARD/FD
  • BACKWARD/BK/BACK
  • DELAY
  • DRAW/CLS/CLEARSCR/CLEARSCREEN/CS
  • SETH/SETHEADING
• Turtle Control Commands
  • HOME
  • SHOWTURTLE/ST
  • HIDETURTLE/HT
  • SETX/SETY/SETXY
• Flow Control Commands
  • REPEAT and RepCount
  • IF / IFELSE
  • WHILE
• Language Features
  • Variables (The MAKE command)
  • Expressions
    • Arithmetic: +, -, *, /, ^
    • Comparison: ==, <>, <, >, <=, >=
    • Logic: AND, OR, NOT
  • Procedures
  • Function Calls
    • SQRT
    • RANDOM
    • SIN / COS / TAN (degrees)
    • ASIN / ACOS / ATAN (degrees)
    • ABS
    • POWER
    • EXP
    • LOG (natural) / LOG10
  • Inline Comments
  • Built-in Constants
    • PI
    • E

Limitations

• Code editing doesn't support multi-line format
• Logo commands other than the ones listed above are not supported. More will be added in future
• Function calls need to be surrounded by the braces, for example, {SQRT 2} or {RANDOM 100}

License

MIT