using System.Drawing;
First we define a background color (Black) to see our cube. Then we created a simple class named "BrumeCubeColored" which generates a cube inside Brume engine.
Notice the parameters of the cube. First we pass "this" reference to tell the object which class is Brume main class (in our case it is "TutorialTheCube" class). Then we pass the name of the object. This name will be helpfull to find your object in the engine.
Finally we setup the colors that will be used by our cube mesh. Notice that you can pass a list of colors thanks to the C# params that will setup all faces colors.
(Try to experiment by adding new colors behind the last parameter or by adding new objects to the scene).
All objects can be simply positionned by modifing the "Pos" field of the object. "Pos" is of "BrumeVector" type, the same that was used to set up camera position.
Launch the new project. You will see the following window :
Tutorial : The Cube
override protected void GameInit()
{
// camera setup
BrumeVector cameraPos = new BrumeVector(3.0f, 0.0f, -3.0f);
BrumeVector cameraDir = new BrumeVector(-0.7f, 0.0f, 0.7f);
BrumeVector cameraUp = new BrumeVector(0.0f, 1.0f, 0.0f);
BrumeFPSCamera camera = new BrumeFPSCamera(this, "camera", cameraPos, cameraDir, cameraUp);
this.SetActiveCamera(camera);
....
Now we can fill the "GameInit" method that stayed empty in the first tutorial. First we need to add a camera in order to see the 3D world :
Brume provides a debug console to help you understand the behaviour of your 3D objects.
To open the console, press the ² Key (just above TAB).
This tutorial will show you how to draw a simple colored cube in Brume.
For this tutorial, create a new project named "TutorialTheCube" and follow the steps described in the first tutorial to create and launch the project.
Brume is designed to manage Meshes. Meshes are most of time loaded from files like DirectX .X files or .3ds.
But for simple objects like cubes, spheres, triangles, lines, torus or vectors, Brume provides simple classes that can generate the meshes without the use of external files.
In the following tutorial, we will use the cube colored mesh, but you can adapt this sample to any of the simple shapes provided in Brume.
Add this line to the imports (it is required for our sample) :
// buffer clear color setup
this.BufferClearColor = Color.Black;
// a simple cube
BrumeCubeColored theCube = new BrumeCubeColored(this, "The Cube", Color.Blue, Color.Red, Color.Green);
If you press it once, you will only see FPS information :
Brume provides many camera types. For this sample we will use the FPSCamera. This camera can move like in many FPS games with mouse and keyboard but for the moment it will stay in place and won't move. Notice that camera direction and up vectors have to be normalized.
We also have to tell Brume that our new camera will be the active one (Brume can have one camera active at a time but you can create as many cameras as you wants and switch between them or even animate them)
Now that we added a camera to see the world, we can add our object :
If you press it another time, it wil open full console. You can then navigate from cameras to objects and easily change object's states. Click on images below to see a slideshow of the console !