User Tools

Site Tools


TGIS_Viewer3DBase class

DK11 for Python | tatukgis.pdk.TGIS_Viewer3DBase | Classes | Constructors | Methods | Properties | Events

Encapsulation of the 3D viewer.

Available also on: Delphi | .NET WinForms | ActiveX.


# Python
class TGIS_Viewer3DBase( Object, IGIS_Viewer3D ):


→ Object



Inherited Overrides Protected
Name Visibility Description
__init__ public Construct an instance of 3D Viewer


Inherited Overrides Protected
Name Visibility Description
ControlRepaint public Issue control repainting action (shallow refresh).
(Implements IGIS_Viewer3D.ControlRepaint)
DoGesture public Do gesture.
(Implements IGIS_Viewer3D.DoGesture)
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)
GestureBegin public Start gesture.
(Implements IGIS_Viewer3D.GestureBegin)
GestureEnd public Finish gesture.
(Implements IGIS_Viewer3D.GestureEnd)
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)
RayIntersectDem public Get intersection point between a ray and a DEM
(Implements IGIS_Viewer3D.RayIntersectDem)
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)


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)
HideLabelsUponNavigation public Labels not drawn during scene navigation etc.
(Implements IGIS_Viewer3D.HideLabelsUponNavigation)
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)
KeepSunCamera public Check for keeping sun and camera positions relative.
(Implements IGIS_Viewer3D.KeepSunCamera)
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 vector 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)
VisibleExtent public Get/set 2D extent visible in 3D window.
(Implements IGIS_Viewer3D.VisibleExtent)
VisibleExtent3D public Get 3D 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)


Inherited Protected
Name Visibility Description
UpdateEvent public

2024/03/07 01:58

Page Tools