Kinematic Tool

The Kinematic Tool is part of the current release but still in Beta. Please use it carefully.

The KinematicTool provides a graphical user interface (GUI) for creating, configuring, and managing kinematic axes and their components within realvirtual. This tool allows users to easily create and manipulate axes, set axis references, manage limits, and handle connections between axes and other components.

Open the Kinematic Tool

To open the Kinematic Tool window please select realvirtual>Kinematic Tool in the realvirtual.io menu or click the button "Axis" within the realvirtual scene overlay menu.

How to use

To create an axis, define a name and press the "Create Axis" button. A new GameObject which represents the axis will be created under the currently selected GameObject. If no GameObject is selected, it will be created at the root of the hierarchy. After creating the axis, set the axis reference by clicking on a mesh within the scene. To assist the selection, the currently hovered mesh is highlighted in the scene window. The chosen axis reference determines the position and rotation of the axis. You can further specify the axis position by choosing "Pivot," "BoundingBoxCenter," or "Radius Center." You can define a upper axis (for axes with a drive) or a connected axis (for physical axes) using the "Upper Axis/Connected Axis" parameter. For a parent axis, the axis GameObject is copied under the parent axis GameObject at scene start, moving together with it. For a connected axis, a joint is created at scene start, linking the axes.

Than you set up the properties of your axis:

  • Axis Direction: Choose the direction from the drop-down menu or browse options with "Ctrl + D".

  • Axis Rotation: Define an offset for the current axis rotation. Browse standard values using "Ctrl + R".

  • Gizmo distance: Sets the distance of the axis gizmo from the axis position in the current direction.

  • Use Limits: Defines the movement limits of the axis.

  • Select Parts: Click to select meshes belonging to the axis in the scene view. Hovered objects will be displayed.

  • Select Groups: Select a group to add to the axis.

  • Add selected parts: Click to add pre-selected elements in the scene to the axis. (Standard Unity-Selection in the scene)

  • Select Neighbours: Selects all neighboring parts of the current axis parts. Add them to the axis parts by clicking "Add selected parts".

  • Fill: Select two parts of the axis and press fill to select all parts in between. Add them to the axis parts by clicking "Add selected parts".

  • Select Connected: Selects all parts connected to the current axis parts. If the selection is correct, add the selected parts to the axis with "Add selected parts".

  • Remove All Parts: Removes all parts' connections to the axis, so no parts belong to the axis.

  • Remove Selected Parts: Removes the connection to the axis for selected parts and removes them from the axis parts list.

  • Add Drive: Adds a drive to the axis, using the axis direction. Note: A drive cannot be added to a "Balljoint" axis, which is only for physical axes.

  • Remove Drive: Removes the added drive.

The options under View are designed to facilitate working on the axis:

  • Isolate: Isolates all parts of the axis and displays them in the scene view.

  • Hide: Hides all parts of the axis, allowing verification that all necessary parts have been added to the axis.

  • Show All: Displays all components of the scene again.

The picture below shows a simple example of setting up an axis.

© 2024 in2Sight GmbH https://realvirtual.io - All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means, including printing, saving, photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the publisher.

Last updated