Developer Guide

using CodeX;
using Tinman.AddOns.DirectX11;
using Tinman.Core;
using Tinman.Core.Config;
using Tinman.Core.IO;
using Tinman.Core.Licensing;
using Tinman.Core.Math.Vectors;
using Tinman.Core.Util;
using Tinman.Engine;
using Tinman.Engine.Application;
using Tinman.Engine.Drawing;
using Tinman.Engine.Rendering;

namespace Tinman.Demo.Examples
{
  public sealed class Example_HelloWorld : ApplicationBase
  {
    public override ConfigValue ToConfig()
    {
      // This means our application is not exposed to the Config API.
      return ConfigValue.Invalid;
    }

    [ThrowAny]
    public static void Main()
    {
      // Before initializing the Tinman 3D library, at least one valid licence
      // key must be given.
      LicenceDomain.Tinman.LicenceKey("Add licence key(s) here, if necessary.");

      // To initialize the Tinman 3D library, this method must be called on the
      // root module(s) that are being used by the application.
      TinmanEngineModule.Instance.PleaseIncludeInBinaryThanks();

      // The Tinman 3D library can now be initialized. Licence checking will be
      // performed here.
      TinmanModule.Initialize();
      try
      {
        IGraphicsContextFactory factory;
        IApplicationWindow window; // [!]
        IApplication application; // [!]
        TinmanError error;

        // Setup the graphics context factory, which will be used to create a
        // rendering context for the client area of the application window.
        factory = new DirectX11ContextFactory();

        // Create a new top-level application window.
        window = ApplicationWindow.Create("Hello World!", new Vec2I(1280, 768));

        // Create the application.
        application = new Example_HelloWorld();

        // Create the application loop and run it.
        error = application.Run("Example_HelloWorld.Main", factory, window);

        if (error != null)
          throw TinmanException.Error("Example_HelloWorld.Main",
            "Hello World has crashed.", error);
      }
      finally
      {
        // Shut down the Tinman 3D library.
        TinmanModule.Shutdown();
      }
    }

    public override void Render()
    {
      Graphics g; // [!]

      // Acquire reference to graphics object and release it when done.
      g = context.Graphics;
      try
      {
        g.Begin();
        try
        {
          // Draw "Hello World!" at the center of the screen.
          g.Fullscreen();
          g.DrawString((PixelFont) g.Cache.GetNull(PixelFont.HandleDefault),
            "Hello World!",
            g.ScreenWidth / 2, g.ScreenHeight / 2,
            Colors.White, Anchor.Center);
        }
        finally
        {
          g.End();
        }
      }
      finally
      {
        g.Dispose();
      }
    }

    #endregion
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk"
  DefaultTargets="Build"
  xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- ... -->
  <ItemGroup>
    <PackageReference
      Include="Tinman.AddOns.DirectX11" Version="1.0.0-rc4.27"/>
  </ItemGroup>
  <!-- ... -->
</Project>