User Tools

Site Tools


api:dk11:net:tatukgis.ndk.winforms.tgis_viewer3dbase

TGIS_Viewer3DBase class

DK11 for .NET | TatukGIS.NDK.WinForms.TGIS_Viewer3DBase | Classes | Constructors | Fields | Methods | Properties | Events

Encapsulation of the 3D viewer.

Available also on: Delphi | ActiveX.

Syntax

// C#
public class TGIS_Viewer3DBase : TGIS_ObjectDisposable, IGIS_Viewer3D 
{
}
' VisualBasic
Public Class TGIS_Viewer3DBase
  Inherits TGIS_ObjectDisposable
  Implements IGIS_Viewer3D
End Class
// Oxygene
type
  TGIS_Viewer3DBase = public class( TGIS_ObjectDisposable, IGIS_Viewer3D )
  end;

Inheritance

→ TGIS_ObjectDisposable

Implements

Constructors

Inherited Overrides Protected
Name Visibility Description
TGIS_Viewer3DBase() public Construct an instance of 3D Viewer

Fields

Inherited Protected
Name Visibility Description
oRenderer protected 3D renderer object.

Methods

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

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
(Implements IGIS_Viewer3D.AdvNavigation)
AllowDemTransparency public Get AllowDemTransparency status.
(Implements IGIS_Viewer3D.AllowDemTransparency)
BasePlane public BasePlane parameters, active, level & colors
(Implements IGIS_Viewer3D.BasePlane)
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.
(Implements IGIS_Viewer3D.CameraPosition)
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.
(Implements IGIS_Viewer3D.CameraPositionEx)
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).
(Implements IGIS_Viewer3D.CameraRotation)
CutAbove public Set CutAbove value for DEM cells with z > CutAbove
(Implements IGIS_Viewer3D.CutAbove)
CutBelow public Set CutBelow value for DEM cells with z < CutBelow
(Implements IGIS_Viewer3D.CutBelow)
DemCachedSize public Grid size used to display regular DEMs & IMAGEs
(Implements IGIS_Viewer3D.DemCachedSize)
DemDetailExtentFactor public Extent in which DEM is displayed in max LevelOfDetail (must be >= 0.5, 1 means screen width).
(Implements IGIS_Viewer3D.DemDetailExtentFactor)
DemDraftExtentFactor public Extent in which DEM is displayed in lower LevelOfDetail (must be >= 1.0, 4 means 4 times screen width).
(Implements IGIS_Viewer3D.DemDraftExtentFactor)
DemGridSize public Current grid size setting.
(Implements IGIS_Viewer3D.DemGridSize)
DemIsolineColor public Isoline color
(Implements IGIS_Viewer3D.DemIsolineColor)
DemIsolineGap public Isoline gap
(Implements IGIS_Viewer3D.DemIsolineGap)
DemWalls public DEM wall types
(Implements IGIS_Viewer3D.DemWalls)
EdgesColor public Vector edges color
(Implements IGIS_Viewer3D.EdgesColor)
ErrorMessage public Get error message String.
(Implements IGIS_Viewer3D.ErrorMessage)
FastMode public Block scene redrawing when set to True, immediately redraws scene when set to False
(Implements IGIS_Viewer3D.FastMode)
Flood public Flood parameters, active, level & color, transparency
(Implements IGIS_Viewer3D.Flood)
IgnoreAbove public Set noDataValue for DEM cells with z > IgnoreAbove value
(Implements IGIS_Viewer3D.IgnoreAbove)
IgnoreBelow public Set noDataValue for DEM cells with z < IgnoreBelow value
(Implements IGIS_Viewer3D.IgnoreBelow)
IgnoreEllipsoidHeight public If set to True, differences in Z value caused by different ellipsoids will be ignored
(Implements IGIS_Viewer3D.IgnoreEllipsoidHeight)
IsBusy public Flag. If True, Viewer is busy in painting.
(Implements IGIS_Viewer3D.IsBusy)
LightVector public Revers Light normal Vector
(Implements IGIS_Viewer3D.LightVector)
Mode public Viewer3D mode working mode (camera mode, sun, zoom, select ...).
(Implements IGIS_Viewer3D.Mode)
OrthoView public Orthogonal View switch, if, True camera looks orthogonally, camera can be moved only in XY plane, zoom is allowed
(Implements IGIS_Viewer3D.OrthoView)
PixelSize public Get the pixel size (xsize & ysize) at reference point in map units
(Implements IGIS_Viewer3D.PixelSize)
ReferencePoint public ReferencePoint in map units, usually screen center.
(Implements IGIS_Viewer3D.ReferencePoint)
ReferencePointMode public Set reference (rotation) point to one of GIS_3DReferencePoint type: Base, Zero, OnDem, Lowest, Highest, FlyOnDem
(Implements IGIS_Viewer3D.ReferencePointMode)
ReferencePointOffsetZ public Set reference (rotation) point Z value offset.
(Implements IGIS_Viewer3D.ReferencePointOffsetZ)
Scale public Setting up and reading the 3D scale factor.
(Implements IGIS_Viewer3D.Scale)
ScaleAsText public Setting up and reading the 3D scale factor as text in format '1:10000'.
(Implements IGIS_Viewer3D.ScaleAsText)
ScaleM public M scaling; default is 1.
(Implements IGIS_Viewer3D.ScaleM)
ScaleZ public Z scaling; default is 1.
(Implements IGIS_Viewer3D.ScaleZ)
ShadowsLevel public Shadows level; 0..100; 0-deep shadows, 100-light shadows
(Implements IGIS_Viewer3D.ShadowsLevel)
ShowDemTexture public Turn Texture on/off.
(Implements IGIS_Viewer3D.ShowDemTexture)
ShowLabels public Labels mode on/off.
(Implements IGIS_Viewer3D.ShowLabels)
ShowLights public Turn Lights on/off.
(Implements IGIS_Viewer3D.ShowLights)
ShowReferencePoint public Turn ReferencePoint drawing on/off.
(Implements IGIS_Viewer3D.ShowReferencePoint)
ShowVectorEdges public Turn VectorEdges drawing on/off.
(Implements IGIS_Viewer3D.ShowVectorEdges)
ShowWireframe public Wire frame mode on/off.
(Implements IGIS_Viewer3D.ShowWireframe)
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)
(Implements IGIS_Viewer3D.SunPosition)
TransparencyPriority public Transparency priority.
(Implements IGIS_Viewer3D.TransparencyPriority)
UniverseColor public 3D viewer color of area which exceeds map extent
(Implements IGIS_Viewer3D.UniverseColor)
VectorExtentFactor public Extent from which vector is displayed (must be >= 1.0, 2 means 2 times screen width).
(Implements IGIS_Viewer3D.VectorExtentFactor)
VectorSimplification public Enable/disable polygon simplification process.
(Implements IGIS_Viewer3D.VectorSimplification)
VectorSmartSize public Shape size in pixels, less or equal will not be displayed ( must be >= 0 )
(Implements IGIS_Viewer3D.VectorSmartSize)
ViewRestriction public Current 3D view restrictions.
(Implements IGIS_Viewer3D.ViewRestriction)
VisibleExtent3D public Get extent visible in 3D window.
(Implements IGIS_Viewer3D.VisibleExtent3D)
WallsColor public DEM wall color
(Implements IGIS_Viewer3D.WallsColor)
Zoom public Get 3D zoom, same as TGIS_Viewer.Zoom
(Implements IGIS_Viewer3D.Zoom)

Events

Inherited Protected
Name Visibility Description
UpdateEvent public

2019/01/25 17:13