DG Kernel (ActiveX) Documentation


Skip Navigation Links.
Start page
Quick Start
Search Page
Installation
What is new
Upgrading Native Apps
Licensing
Collapse ModelsModels
Expand DG Kernel ControlsDG Kernel Controls
Expand API ReferenceAPI Reference
Expand ViewsViews
Expand Samples and TutorialsSamples and Tutorials
Expand GraphicsGraphics
Expand Math ObjectsMath Objects
Expand DeprecatedDeprecated
Redistribution
Model Viewer
Open Source
Support
Skip Navigation LinksHome Page > Models > Entities > Movement > Movements Go to DGKC docs Search Documentation


Movements

A Movement in DG Kernel software is a rule which for every moment of time gives a frame of axes. Movement can be applied to entities (Objects). Position and orientation of a section at a moment of time is defined by making local frame of the section identical to the frame defined by the movement. In more scientific terms a movement is a parameterized frame or curve in space of frames: F: [0,1] -> (space of frames);  t -> F(t).

Movement of entities described above is called absolute because it does not depend on the initial position of the section. A movement can be considered as relative to the current position of the mobile object. It is defined as next: Calculate coordinates of the object relative to the initial frame F(0). Position of the object at moment t is the object with the same coordinates in frame F(t). This type of movement changes initial position of the mobile object continuously.

Relative movements can be applied to various types of objects like points, vectors,  frames and entities. See more details about movements of entities in Kinematic Entities.

Time related to movements is always normalized, i.e. moment 0 is the start and 1 is the end. If an application has a different range it can be mapped linearly to [0, 1] range to make it normalized.

If one considers components of the movement frame a Movement is defined by three curves in space: x(t), u(t) and v(t) where parameter t has range [0, 1]. x(t) is the origin of the frame at moment t, u(t) is vector of x axis of the frame and v(t) is vector of y axis of the frame. x(t) is called path of the movement.

Movements are controlled by IMove_DG interface.

Any curves in DG Kernel software are currently sampled by an array of 3D points x[0], x[1], ...,x[n]. which correspond to array of parameters t[0], t[1], ..., t[n]. Behaviour of a curve between the points is defined by its type and some additional parameters like interpolation degree. When size of the array x is the same and parameter arrays are identical for x, u and v curves the above defines array of frames f[0], f[1], ..., f[n]. This is the default case, which is always true when the move has been initialized with IMove_DG.CreateAttributes and possibly modified with IFrameArray_DG..

This above frame array can be accessed and modified via IFrameArray_DG queried from IMove_DG

To create a new Movement:

1. Call IMove_DG iMove = IObjectGenerator_DG.Create<IMove_DG>().

2. Call IMove_DG.CreateAttributes to create a default movement or attach the three curves described above, which where created independently using IMove_DG.SetOriginPath and IMove_DG.SetAxisPath methods.

3. Modify if required the curves independently as described in Geometric Curves topic or use IFrameArray_DG queried from IMove_DG to access complete frames at each sampling data point. For the later method to work all curves must have the same size of the data array. This is true if the curves where created with a IMove_DG.CreateAttributes call and possibly modified with IFrameArray_DG.

Before using a movement all three curves must be created either with call to IMove_DG.CreateAttributes or attached with calls to IMove_DG.SetOriginPath and IMove_DG.SetAxisPath.

Generally, curves x, u, v can have different types, different number of sampling points and different parameterization. If the curves where created with a call to IMove_DG.CreateAttributes(0) all three curves are Free-form curves linearly interpolated between sampling points. If different parameter was supplied in IMove_DG.CreateAttributes call the lines will have more complex type normally derived from Free-form curves. See also IMove_DG.CreateAttributes.

A simpler way to define a movement is to create it as a canonical movement associated with a 3D curve (path):

Canonical movement of a path

A movement can be constructed from a 3D curve as described below. Movements constructed this way are called canonical because proerties of the moving frame are derived form the path of the movement.

For every moment t x axis of the moving frame F(t) is defined as tangential to the path x(t). If the path x(t) is brocken at the point there are two smooth adjacent pieces of the curve at the point so the tangential of the piece after the point is taken.

z  axis of the moving frame F(t) is defined as follows:

For Arc Spline curves z axis coinsides with the normal of the plane of the spline at the point x(t)

For a general path if the curve has non zero curvature at the point z axis is perpendicular to the tangential circle. If the curvature is zero, direction z is take from the previous or next (in this order) non zero curvature point. If whole curve is a straight line z direction is defined by making x global axis perpendicular to the tangential vector. if this is not possible y and z global axes are attempted

y axis of the moving frame is defined as orthogonal to x and z.

To construct a canonical movement define the path of the movement and call IMove_DG.DefineTangentail()

See also:  Collision Path sample, eMotion sample