Creating C# Application

• Examples located in the <UnigineSDK>/source/csharp/samples/Api and <UnigineSDK>/source/csharp/samples/App folders.
• The article on Setting Up Development Environment to learn more on how to prepare the development environment.

Let's make the material ball rotate using C# Component System.

1. In UNIGINE SDK Browser, choose your C# project created with the C# (.NET Core) option selected as API+IDE, and click the Open Editor button.

   

   UnigineEditor will open.
2. In UnigineEditor, create a new C# component via Asset Browser.

   

   Let's name it rotator.
3. By double-clicking a created asset rotator.cs, it will open in the default IDE. Add the following code to this file.
   Source code (C#)

   public class rotator : Component
   {
   	public float angle = 30.0f;
   	
   	void Update()
   	{
   		// write here code to be called before updating each render frame
   		node.Rotate(0, 0, angle * Game.IFps);
   	}
   }

   All saved changes of the component source code make the component update with no compilation required when the Editor window gets focus.
4. Add this component to the material ball.
5. Run an instance of the application by clicking the Play button on the toolbar.

   

The component can be assigned to any node or nodes without changing anything in it.

With the approach using only the AppWorldLogic and AppSystemLogic global classes, making the material ball rotate is done as follows.

1. In the UNIGINE SDK Browser, choose your C# project and click the Open Code IDE button.

   

   Visual Studio will open.
2. In Visual Studio, add the following code in your project's AppWorldLogic.cs file.
   Source code (C#)

   using System;
   using System.Collections.Generic;
   using System.Linq;
   using System.Text;
   
   using Unigine;
   
   namespace UnigineApp
   {
   
   	class AppWorldLogic : WorldLogic
   	{
   		// define pointer to node
   		Node node;
   
   		public override bool Init()
   		{
   			// find the material ball node by its name
   			node = World.GetNodeByName("material_ball");
   			return true;
   		}
   
   		public override bool Update()
   		{
   			// set the transformation to the node
   			float angle = 30.0f;
   			node.Rotate(0, 0, angle * Game.IFps);
   			return true;
   		}
   	}
   }

3. Build your project by clicking Build -> Build Solution in Visual Studio.

   

4. Start your project by clicking Debug -> Start in a proper mode in Visual Studio.

   

This approach has some usability limitations:

• If a node name has been changed, code wouldn't work.
• If you run a world that does not contain a node AppWorldLogic refers to, the application will crash.
  Notice

  For each world of the project, one and the same AppWorldLogic is called. It is impossible to link an individual AppWorldLogic to each world.

Using Components in C# (.NET Framework) projects#

class AppSystemLogic : SystemLogic
	{
		public override bool Init()
		{
			// initialize C# Component System
			ComponentSystem.Enabled = true;
			
			// generate all property files inside /data folder for all components
			ComponentSystem.SaveProperties();
		
			return true;
		}
	}

ComponentSystem.AddComponent<MyComponent>(node);