User Tools

Site Tools


api:dk11:net:tatukgis.ndk.igis_viewer3d

Table of Contents

IGIS_Viewer3D interface

DK11 for .NET | TatukGIS.NDK.IGIS_Viewer3D | Interfaces | Methods | Properties

Common API for 3D viewing operations.

Available also on: Delphi | ActiveX.

Syntax

// C#
public interface IGIS_Viewer3D
{
}
' VisualBasic
Public Interface IGIS_Viewer3D
End Class
// Oxygene
type
  IGIS_Viewer3D = public interface
  end;

Methods

Inherited Overrides Protected
Name Visibility Description
ControlRepaint public Issue control repainting action (shallow refresh).
DoMouseDown public Perform interactive action on mouse message defined by current Mode.
DoMouseMove public Perform interactive action on mouse message defined by current Mode.
DoMouseUp public Perform interactive action on mouse message defined by current Mode.
Drag public Drag scene left, right, forward or backward by delta in map units
DragEx public Drag scene left, right, forward+up or backward+down by delta in map units
Draw public Draw scene
FullExtent public Set view to initial state.
GetDemLevelAtReferencePointer public Get height where reference pointer crosses DEM
GetFps public Get rendering speed in frames-per-second
InitialRedraw public Construct an instance of 3D Viewer
Locate public Select object in 3D (as in 2D mode)
Locate3D public Select object in 3D
Lock public Stop rendering and wait for GeneralUnlock Must be paired with Unlock.
LockUpdates public Prepare navigate operation - for example set draft mode.
MarkShape public Mark shape with color
Move public Move scene along XY axis by delta values expressed in map units
PrintBegin public Get size of tile used while tiling.
PrintBmp public Dump required screen rectangle to a bitmap
PrintEnd public Close printing using tiles.
PrintTile public Dump visible screen rectangle to a bitmap
ResetView public Set view to initial state (like FullExtent in 2D).
Rotate public Rotate view by delta values expressed in radians
ScreenToMap public Get the mouse position on ReferenceLevel in map units
ScreenToMap3D public Get map coordinates of screen pixel
StoreMousePos public Mouse position (necessary in ZoomMode only)
Unlock public Cancels GeneralLock, continue rendering Must be paired with Lock.
UnlockUpdates public Finalize navigate operation.
UnMarkShape public Cancel previously marked shape with color
UpdateAllSelectedObjects public Redraw all selected objects.
UpdateTopmost public Issue control update action (topmost refresh).
UpdateWholeMap public Issue control update action (deep refresh).
ZoomBy public Zoom view by factor (screen center if AdvNavigation = False, mouse position if AdvNavigation = True.

Properties

Inherited Protected
Name Visibility Description
AdvNavigation public Standard / AdvanceNavigation switch if True mouse location become a rotation point if False screen center is a rotation point
AllowDemTransparency public Get AllowDemTransparency status.
BasePlane public BasePlane parameters, active, level & colors
CameraPosition public Camera position in radians; Changes of CameraPosition settings change CameraRotation settings; Camera always points to the central point of the visible area; * X height of the camera above horizon, range 0 - Pi/2 rad; * Y azimuth to the camera from natural north, range 0 - 2Pi rad; * Z distance to the camera in map units; * M optional parameter, for future use.
CameraPositionEx public Camera position in XYZ in map units Changes of CameraPositionEx settings do not change CameraRotation settings; * X x coordinate; * Y y coordinate; * Z z coordinate; * M optional parameter, for future use.
CameraRotation public Camera rotation in radians; * X x rotation, vertical , range +- Pi/2 rad; * Y y rotation, inclination, range +- Pi/2 rad; * Z z rotation, horizontal , range 0 - 2Pi rad; * M camera focal length in millimeters, range 20 - 500 mm (default 50).
CutAbove public Set CutAbove value for DEM cells with z > CutAbove
CutBelow public Set CutBelow value for DEM cells with z < CutBelow
DemCachedSize public Grid size used to display regular DEMs & IMAGEs
DemDetailExtentFactor public Extent in which DEM is displayed in max LevelOfDetail (must be >= 0.5, 1 means screen width).
DemDraftExtentFactor public Extent in which DEM is displayed in lower LevelOfDetail (must be >= 1.0, 4 means 4 times screen width).
DemGridSize public Current grid size setting.
DemIsolineColor public Isoline color
DemIsolineGap public Isoline gap
DemWalls public DEM wall types
EdgesColor public Vector edges color
ErrorMessage public Get error message String.
FastMode public Block scene redrawing when set to True, immediately redraws scene when set to False
Flood public Flood parameters, active, level & color, transparency
IgnoreAbove public Set noDataValue for DEM cells with z > IgnoreAbove value
IgnoreBelow public Set noDataValue for DEM cells with z < IgnoreBelow value
IgnoreEllipsoidHeight public If set to True, differences in Z value caused by different ellipsoids will be ignored
IsBusy public Flag. If True, Viewer is busy in painting.
LightVector public Revers Light normal Vector
Mode public Viewer3D mode working mode (camera mode, sun, zoom, select ...).
OrthoView public Orthogonal View switch, if, True camera looks orthogonally, camera can be moved only in XY plane, zoom is allowed
PixelSize public Get the pixel size (xsize & ysize) at reference point in map units
ReferencePoint public ReferencePoint in map units, usually screen center.
ReferencePointMode public Set reference (rotation) point to one of GIS_3DReferencePoint type: Base, Zero, OnDem, Lowest, Highest, FlyOnDem
ReferencePointOffsetZ public Set reference (rotation) point Z value offset.
Scale public Setting up and reading the 3D scale factor.
ScaleAsText public Setting up and reading the 3D scale factor as text in format '1:10000'.
ScaleM public M scaling; default is 1.
ScaleZ public Z scaling; default is 1.
ShadowsLevel public Shadows level; 0..100; 0-deep shadows, 100-light shadows
ShowDemTexture public Turn Texture on/off.
ShowLabels public Labels mode on/off.
ShowLights public Turn Lights on/off.
ShowReferencePoint public Turn ReferencePoint drawing on/off.
ShowVectorEdges public Turn VectorEdges drawing on/off.
ShowWireframe public Wire frame mode on/off.
SunPosition public Sun position in radian; natural north * X height of the sun above horizon, range +- Pi/2 rad; initial Pi/4 (45 deg) * Y azimuth to the sun from natural north, range 0 - 2Pi rad; initial 3Pi/4 (225 deg)
TransparencyPriority public Transparency priority.
UniverseColor public 3D viewer color of area which exceeds map extent
VectorExtentFactor public Extent from which vector is displayed (must be >= 1.0, 2 means 2 times screen width).
VectorSimplification public Enable/disable polygon simplification process.
VectorSmartSize public Shape size in pixels, less or equal will not be displayed ( must be >= 0 )
ViewRestriction public Current 3D view restrictions.
VisibleExtent3D public Get extent visible in 3D window.
WallsColor public DEM wall color
Zoom public Get 3D zoom, same as TGIS_Viewer.Zoom

2019/01/25 17:12