S2ENGINE HD  1.4.6
Official manual about S2Engine HD editor and programming
Interface

Layout

interface01.jpg

From version 1.03.00 editor layout is composed by 3 vertical resizable panels. These panels also can be horizontally splitted into 2 resizable subpanels, as showed into the picture above (central panel). Each panel (and subpanel) can contains multiple tabs, one or more tabs form a tool. As showed into the picture above tabs can be dragged from a panel (or subpanel) to another. Tabs can be closed clicking on the round blue button (close button) on the top-right corner of a panel. In case of right/left panels you also can hide/show them by clicking on the blue arrows near the close buttons, in order to maximize the center view. The main components of the S2ENGINE HD IDE interface are:


Tools

Tools are the core of S2ENGINE HD editing system. Generally when opened tools are showed as tabs on panels. A tool can be composed by one or more tabs. For example when calling Models tool 3 tabs are created: model tab, animation tab and ModelView tab.


Viewports

A special kind of tab are Viewports. Each viewport has its own options. In this current version of editor viewports are 3:

SceneView

The main view. It lets you to move and edit the whole game scene.

Overview02.jpg

In Sceneview you can select following options:

  • Helpers: Shows the AI helpers.
  • Colliders: Shows the Physics collision shapes.
  • Markers: Shows the markers. Markers are 2d images put on the entities (just like cameras,lights,characters,...) to easily identify them.
  • Occluders: Shows the occluders as wireframe meshes. Occluders are meshes used by occlusion culling system for speeding up hidden surface removal.
  • F: Camera Far plane. Can be set when, editing huge terrains, camera far plane must be made really far. Values are in centimeters (10.000 = 100 meters)
  • Free (only in SceneView): You can point the camera by leaving pressed right mouse button and moving the mouse. W,A,S,D keys for moving camera horizontally, E,Q keys for moving camera up and down
  • Target: This is default mode in MaterialView and ModelView. When you select an object in the SceneView (in ModelView you can select a model node) and click on the Target button the camera automatically is placed at a distance form the object and points it. In this case camera can only orbit around the object (by leaving pressed right mouse button and moving mouse) and move near or far from the pointed object (by pressing W,S keys).
  • Fly: You can point camera by leaving pressed right mouse button and moving the mouse, but differently from Free mode pressing W,A,S,D camera moves in the direction in which it is pointing.

ModelView

It displays the current selected model. It is useful to edit some model features.

Overview01.jpg

In ModelView you can select following options:

  • Nodes: shows nodes of the model as green cubes connected by green lines.
  • Joints: shows the physics joints as capsule. Used in case of character ragdolls.
  • Verts: shows vertices with colour. Used for vertex painting when creating vegetation wind movements.
  • Norms: shows normals of the model in red.
  • Colors: shows model faces coloured just as vertices (also used for vertex panting).
  • Info: shows model box dimensions (expressed in meters) and number of triangles.
  • MakeShot: Used to make preview for model browser.
  • FreeMode: You can move by using w,a,s,d,q,e keys and mouse. (see below).
  • ResetMode: Reset the camera position and orientation to the default (target mode to 0,0,0)
  • TargetMode: By default camera target is the center (0,0,0) of the model scene. When using target mode camera can target the selected node. In this case it only move around the target (moving mouse and holding right mouse button) and zoom (in & out) toward it by using mouse roll or W,S keys.

MaterialView

It displays the current selected material. It is useful to edit and also paint materials.

Overview03.jpg
  • MakeShot: Used to make preview for material browser.
  • Cube: Default material reference model.
  • Sphere: change the material reference model from cube to sphere.
  • Background: shows background. Useful for alpha blended or refractive materials.


Basic commands

Editor Camera movements

To navigate inside 3d viewports use W,A,S,D keys to move camera forward,left,right,backward, and use Q,E to move camera Down and Up. To rotate camera hold right mouse button and move it.

Attention
NOTE that in MaterialView camera is set as targeted so you can move camera only around the material sphere/cube. This mode is also default mode of ModelView, but in this case you can change it.
NOTE: Holding L-SHIFT key you can double the speed of Camera

Shortkeys

Following are shortkeys used in the editor:

  • F5: start game
  • F4: refresh project browser folders
  • SPACEBAR: rotate object/terrain tool tabs
  • Ctrl+C: clone selected object / copy selected text into clipboard
  • Ctrl+Z: Undo
  • Ctrl+V: paste copied text
  • Ctrl+S: Save Current Scene
  • Canc: delete current selected object if SceneView focused, delete current selected node if GameMachine View focused.
  • F: Focus camera on the selected object
  • H: Show/Hide selected object
  • LSHIFT+MOUSE_Y: move grid up/down
  • ESC: exit from game mode

Editor Mode and Game Mode

In-Editor simulation

Grid

Editor Camera Speed