DG Kernel (ActiveX) Documentation


Skip Navigation Links.
Start page
Quick Start
Search Page
Installation
What is new
Upgrading Native Apps
Licensing
Collapse ModelsModels
Collapse DG Kernel ControlsDG Kernel Controls
Collapse API ReferenceAPI Reference
Interface List
Vector Space
Collapse General GeometryGeneral Geometry
Collapse ModelModel
Collapse ViewView
Collapse General ComputingGeneral Computing
Collapse ViewsViews
Collapse Samples and TutorialsSamples and Tutorials
Collapse GraphicsGraphics
Collapse Math ObjectsMath Objects
Collapse DeprecatedDeprecated
Redistribution
Model Viewer
Open Source
Support
Skip Navigation Links Go to DGKC docs Search Documentation


IDrawUtil Interface

Cylinder
Disk
Sphere
SetResolution
GetResolution
Box
Rectangle

IDrawUtil interface allows slightly higher-level control than IDraw for direct rendering (See ClientDraw event). IDrawUtil can be queried from IDraw interface.

Note that IDrawUtil can be expanded (without changing the currently published methods) in future releases.

See also Morph sample, Interface List


HRESULT Cylinder(double baseRadius, double topRadius, double height)

Parameters

baseRadius- [in] Bottom radius of the cylinder.. 

topRadius - [in] - Top radius of the cylinder

height - [in] height of the cylinder

Remarks:
 Call to this method renders a cylinder along z-axis of the current drawing frame. (See Translate method of IDraw). Use Translate and Rotate to manipulate location and orientation of the cylinder. Use SetResolution method to change level of approximation for the surface.

HRESULT Disk(double innerRadius, double outerRadius)

Parameters

innerRadius - [in] Inner  radius of the disc.. 

outerRadius - [in] - outer radius of the disc.. 

Remarks:  Call to this method renders a disc. Axis of the disc coincides with z axis of the current drawing frame. (See Translate method of IDraw). Use Translate and Rotate to manipulate location and orientation of the Disc. Use SetResolution method to change level of approximation for the surface.

HRESULT Sphere(double radius)

Parameters

radius - [in] Radius of the sphere

Remarks:

Call to this method renders a sphere. Axis of the disc coincides with z-axis of the current drawing frame. (See Translate method of IDraw). Use Translate and Rotate to manipulate location and orientation of the sphere. Use SetResolution method to change level of approximation for the surface.


HRESULT SetResolution(int resol)

Parameters

resol - [in] Resolution (See remarks).

Remarks:  

Resolution is an integer number, which defines how fine the surfaces drawn with IDrawUtil will be approximated. Very roughly resolution equals to number of slices used to render axially symmetric objects from the above methods. As resolution affect the performance the best way is to establish the resolution experimentally. It should be the smallest integer, which gives satisfactory approximation.


HRESULT GetResolution(int* resol)

Parameters

esol - [out] Resolution (See remarks).

Remarks:  

Returns the current resolution. See remarks to SetResolution method.


HRESULT Box(double width, double height, double length, int wireframe)

Parameters:

width, height, length- [in] dimensions of the box

wireframe - [in] Should be considered as a Boolean variable. If not zero the box will be rendered in wire frame and as surface otherwise.

Remarks:  

Draws a box aligned with axes of the current drawing frame.


HRESULT Rectangle(double width, double height, int wireframe)

Parameters:

width, height- [in] dimensions of the rectangle

wireframe - [in] Should be considered as a Boolean variable. If not zero the box will be rendered in wire frame and as surface otherwise.

Remarks:  

Draws a rectangle in x and y axes of the current drawing frame.