Main frame for map display window. More...

Inheritance diagram for frame.MapFrame:

Collaboration diagram for frame.MapFrame:

Public Member Functions
def	__init__
	Main map display window with toolbars, statusbar and BufferedWindow (map canvas)
def	GetMapWindow
def	AddNviz
	Add 3D view mode window.
def	RemoveNviz
	Restore 2D view.
def	AddToolbar
	Add defined toolbar to the window.
def	RemoveToolbar
	Removes defined toolbar from the window.
def	IsPaneShown
	Check if pane (toolbar, mapWindow ...) of given name is currently shown.
def	OnUpdateProgress
	Update progress bar info.
def	OnFocus
	Change choicebook page to match display.
def	OnRender
	Re-render map composition (each map layer)
def	OnPointer
	Pointer button clicked.
def	OnRotate
	Rotate 3D view.
def	OnFlyThrough
	Fly-through mode.
def	OnZoomRegion
def	OnAlignRegion
def	SaveToFile
	Save map to image.
def	PrintMenu
def	OnCloseWindow
	Window closed.
def	QueryMap
	Query raster or vector map layers by r/v.what.
def	QueryVector
	Query vector map layer features.
def	OnQuery
	Query tools menu.
def	AddTmpVectorMapLayer
	Add temporal vector map layer to map composition.
def	OnMeasure
	Init measurement routine that calculates map distance along transect drawn on map display.
def	MeasureDist
	Calculate map distance from screen distance and print to output window.
def	OnProfile
	Launch profile tool.
def	FormatDist
	Format length numbers and units in a nice way, as a function of length.
def	OnHistogram
	Init histogram display canvas and tools.
def	OnAddBarscale
	Handler for scale/arrow map decoration menu selection.
def	OnAddLegend
	Handler for legend map decoration menu selection.
def	OnAddText
	Handler for text decoration menu selection.
def	OnAddArrow
	Handler for north arrow menu selection.
def	GetOptData
	Callback method for decoration overlay command generated by dialog created in menuform.py.
def	OnZoomToMap
	Set display extents to match selected raster (including NULLs) or vector map.
def	OnZoomToRaster
	Set display extents to match selected raster map (ignore NULLs)
def	OnZoomToSaved
	Set display geometry to match extents in saved region file.
def	OnDisplayToWind
	Set computational region (WIND file) to match display extents.
def	SaveDisplayRegion
	Save display extents to named region file.
def	OnZoomMenu
	Popup Zoom menu.
def	SetProperties
	Set properies of map display window.
def	IsStandalone
	Check if Map display is standalone.
def	GetLayerManager
	Get reference to Layer Manager.
def	GetMapToolbar
	Returns toolbar with zooming tools.
Data Fields
	tree
	page
	layerbook
	statusbarItems
	statusbarItemsHiddenInNviz
	statusbarManager
	MapWindow2D
	MapWindow
	MapWindowVDigit
	MapWindow3D
	printopt
	dialogs
	decorationDialog
	tmpreg
	totaldist

Detailed Description

Main frame for map display window.

Drawing takes place in child double buffered drawing window.

Definition at line 58 of file mapdisp/frame.py.

Constructor & Destructor Documentation

def frame.MapFrame.__init__	(	self,
		parent = `None`,
		title = `_("GRASS GIS - Map display")`,
		toolbars = `["map"]`,
		tree = `None`,
		notebook = `None`,
		lmgr = `None`,
		page = `None`,
		Map = `None`,
		auimgr = `None`,
		name = `'MapWindow'`,
		kwargs
	)

Main map display window with toolbars, statusbar and BufferedWindow (map canvas)

Parameters:

toolbars	array of activated toolbars, e.g. ['map', 'digit']
tree	reference to layer tree
notebook	control book ID in Layer Manager
lmgr	Layer Manager
page	notebook page with layer tree
Map	instance of render.Map
auimgs	AUI manager
name	frame name
kwargs	wx.Frame attributes

Definition at line 64 of file mapdisp/frame.py.

References mapdisplay.MapFrame._layerManager, and frame.MapFrame._layerManager.

Member Function Documentation

def frame.MapFrame.AddNviz ( self )

Add 3D view mode window.

Definition at line 253 of file mapdisp/frame.py.

References mapdisplay.MapFrame._layerManager, frame.MapFrame._layerManager, mapdisp.MapFrameBase.cursors, frame.ModelFrame.cursors, frame.PsMapFrame.cursors, mapwindow.GLWindow.cursors, frame.PsMapBufferedWindow.cursors, main.GLWindow, mapwindow.MapWindow.Map, mapdisp.MapFrameBase.Map, histogram.BufferedWindow.Map, main.MapApp.Map, base.BasePlotFrame.Map, layertree.LayerTree.Map, mapdisplay.MapFrame.Map, manager.GCPWizard.Map, histogram.HistogramFrame.Map, colorrules.ColorTable.Map, manager.GCP.Map, colorrules.BufferedWindow.Map, mapdisplay.MapFrame.MapWindow, frame.MapFrame.MapWindow, manager.GCP.MapWindow, frame.MapFrame.MapWindow3D, frame.MapFrame.OnFlyThrough(), frame.MapFrame.OnRotate(), tools.range, frame.MapFrame.statusbarItemsHiddenInNviz, mapdisp.MapFrameBase.toolbars, frame.GMFrame.toolbars, workspace.ProcessWorkspaceFile.tree, mapwindow.MapWindow.tree, menudata.MenuData.tree, mapdisplay.MapFrame.tree, frame.MapFrame.tree, ghelp.MenuTreeWindow.tree, and model.ProcessModelFile.tree.

def frame.MapFrame.AddTmpVectorMapLayer	(	self,
		name,
		cats,
		useId = `False`,
		addLayer = `True`
	)

Add temporal vector map layer to map composition.

Parameters:

name	name of map layer
useId	use feature id instead of category

Definition at line 844 of file mapdisp/frame.py.

References utils.ListOfCatsToRange().

Referenced by frame.MapFrame.QueryVector().

def frame.MapFrame.AddToolbar	(	self,
		name
	)

Add defined toolbar to the window.

Currently known toolbars are:

'map' - basic map toolbar
'vdigit' - vector digitizer
'gcpdisp' - GCP Manager Display

Definition at line 363 of file mapdisp/frame.py.

References frame.MapFrame._addToolbarVDigit(), mapwindow.MapWindow.Map, mapdisp.MapFrameBase.Map, histogram.BufferedWindow.Map, main.MapApp.Map, base.BasePlotFrame.Map, layertree.LayerTree.Map, mapdisplay.MapFrame.Map, manager.GCPWizard.Map, histogram.HistogramFrame.Map, colorrules.ColorTable.Map, manager.GCP.Map, colorrules.BufferedWindow.Map, mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

def frame.MapFrame.FormatDist	(	self,
		dist
	)

Format length numbers and units in a nice way, as a function of length.

From code by Hamish Bowman Grass Development Team 2006

Definition at line 996 of file mapdisp/frame.py.

References round.

Referenced by frame.MapFrame.MeasureDist().

def frame.MapFrame.GetLayerManager ( self )

Get reference to Layer Manager.

Returns:: window reference; None (if standalone)

Definition at line 1266 of file mapdisp/frame.py.

References mapdisplay.MapFrame._layerManager, and frame.MapFrame._layerManager.

def frame.MapFrame.GetMapToolbar ( self )

Returns toolbar with zooming tools.

Definition at line 1274 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

Referenced by manager.GCP.OnDispResize(), frame.MapFrame.OnPointer(), frame.MapFrame.OnQuery(), frame.MapFrame.OnRotate(), and manager.GCP.UpdateActive().

def frame.MapFrame.GetMapWindow ( self )

def frame.MapFrame.GetOptData	(	self,
		dcmd,
		type,
		params,
		propwin
	)

Callback method for decoration overlay command generated by dialog created in menuform.py.

Definition at line 1177 of file mapdisp/frame.py.

References python.task.grassTask.params, histogram.HistogramFrame.params, model.ModelParamDialog.params, and histogram.HistogramFrame.propwin.

Referenced by histogram.HistogramFrame.OnOptions().

def frame.MapFrame.IsPaneShown	(	self,
		name
	)

Check if pane (toolbar, mapWindow ...) of given name is currently shown.

Definition at line 413 of file mapdisp/frame.py.

Referenced by frame.MapFrame.OnAddText(), frame.MapFrame.OnCloseWindow(), frame.MapFrame.QueryMap(), frame.MapFrame.QueryVector(), and frame.MapFrame.SaveToFile().

def frame.MapFrame.IsStandalone ( self )

Check if Map display is standalone.

Definition at line 1259 of file mapdisp/frame.py.

References mapdisplay.MapFrame._layerManager, and frame.MapFrame._layerManager.

Referenced by frame.MapFrame.OnQuery(), and frame.MapFrame.QueryMap().

def frame.MapFrame.MeasureDist	(	self,
		beginpt,
		endpt
	)

Calculate map distance from screen distance and print to output window.

Definition at line 942 of file mapdisp/frame.py.

References mapdisplay.MapFrame.FormatDist(), frame.MapFrame.FormatDist(), round, and frame.MapFrame.totaldist.

def frame.MapFrame.OnAddArrow	(	self,
		event
	)

Handler for north arrow menu selection.

Opens Appearance page of nviz notebook.

Definition at line 1169 of file mapdisp/frame.py.

def frame.MapFrame.OnAddBarscale	(	self,
		event
	)

Handler for scale/arrow map decoration menu selection.

Definition at line 1056 of file mapdisp/frame.py.

References frame.GMFrame.dialogs, frame.MapFrame.dialogs, and mapdisplay.MapFrame.dialogs.

def frame.MapFrame.OnAddLegend	(	self,
		event
	)

Handler for legend map decoration menu selection.

Definition at line 1088 of file mapdisp/frame.py.

References frame.GMFrame.dialogs, frame.MapFrame.dialogs, and mapdisplay.MapFrame.dialogs.

def frame.MapFrame.OnAddText	(	self,
		event
	)

Handler for text decoration menu selection.

Definition at line 1118 of file mapdisp/frame.py.

References frame.GMFrame.dialogs, frame.MapFrame.dialogs, mapdisplay.MapFrame.dialogs, frame.GMFrame.IsPaneShown(), frame.MapFrame.IsPaneShown(), and max.

def frame.MapFrame.OnAlignRegion	(	self,
		event
	)

Align region

Definition at line 529 of file mapdisp/frame.py.

def frame.MapFrame.OnCloseWindow	(	self,
		event
	)

Window closed.

Also close associated layer tree page

Definition at line 611 of file mapdisp/frame.py.

References mapdisplay.MapFrame._layerManager, frame.MapFrame._layerManager, mapdisp.MapFrameBase.GetToolbar(), frame.GMFrame.IsPaneShown(), frame.MapFrame.IsPaneShown(), wizard.TitledPage.page, mapdisplay.MapFrame.page, frame.MapFrame.page, frame.MapFrame.RemoveNviz(), mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

def frame.MapFrame.OnDisplayToWind	(	self,
		event
	)

Set computational region (WIND file) to match display extents.

Definition at line 1205 of file mapdisp/frame.py.

Referenced by frame.MapFrame.OnZoomMenu().

def frame.MapFrame.OnFlyThrough	(	self,
		event
	)

Fly-through mode.

Definition at line 507 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.cursors, frame.ModelFrame.cursors, frame.PsMapFrame.cursors, mapwindow.GLWindow.cursors, frame.PsMapBufferedWindow.cursors, mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

Referenced by frame.MapFrame.AddNviz().

def frame.MapFrame.OnFocus	(	self,
		event
	)

Change choicebook page to match display.

Definition at line 426 of file mapdisp/frame.py.

References wizard.TitledPage.page, mapdisplay.MapFrame.page, and frame.MapFrame.page.

def frame.MapFrame.OnHistogram	(	self,
		event
	)

Init histogram display canvas and tools.

Definition at line 1046 of file mapdisp/frame.py.

def frame.MapFrame.OnMeasure	(	self,
		event
	)

Init measurement routine that calculates map distance along transect drawn on map display.

Definition at line 898 of file mapdisp/frame.py.

def frame.MapFrame.OnPointer	(	self,
		event
	)

Pointer button clicked.

Definition at line 463 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.cursors, frame.ModelFrame.cursors, frame.PsMapFrame.cursors, mapwindow.GLWindow.cursors, frame.PsMapBufferedWindow.cursors, mapdisp.MapFrameBase.GetMapToolbar(), mapdisplay.MapFrame.GetMapToolbar(), frame.MapFrame.GetMapToolbar(), mapdisp.MapFrameBase.GetToolbar(), mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

def frame.MapFrame.OnProfile	(	self,
		event
	)

Launch profile tool.

Definition at line 980 of file mapdisp/frame.py.

def frame.MapFrame.OnQuery	(	self,
		event
	)

Query tools menu.

Definition at line 825 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.cursors, frame.ModelFrame.cursors, frame.PsMapFrame.cursors, mapwindow.GLWindow.cursors, frame.PsMapBufferedWindow.cursors, mapdisp.MapFrameBase.GetMapToolbar(), mapdisplay.MapFrame.GetMapToolbar(), frame.MapFrame.GetMapToolbar(), mapdisp.MapFrameBase.IsStandalone(), mapdisplay.MapFrame.IsStandalone(), frame.MapFrame.IsStandalone(), mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

Referenced by toolbars.VDigitToolbar.OnAdditionalToolMenu().

def frame.MapFrame.OnRender	(	self,
		event
	)

Re-render map composition (each map layer)

Definition at line 438 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.GetToolbar(), and mapdisp.MapFrameBase.StatusbarUpdate().

def frame.MapFrame.OnRotate	(	self,
		event
	)

Rotate 3D view.

Definition at line 495 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.cursors, frame.ModelFrame.cursors, frame.PsMapFrame.cursors, mapwindow.GLWindow.cursors, frame.PsMapBufferedWindow.cursors, mapdisp.MapFrameBase.GetMapToolbar(), mapdisplay.MapFrame.GetMapToolbar(), frame.MapFrame.GetMapToolbar(), mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

Referenced by frame.MapFrame.AddNviz().

def frame.MapFrame.OnUpdateProgress	(	self,
		event
	)

Update progress bar info.

Definition at line 419 of file mapdisp/frame.py.

References mapdisp.MapFrameBase.GetProgressBar(), statusbar.SbManager.GetProgressBar(), goutput.GMConsole.GetProgressBar(), and widgets.SetValue().

def frame.MapFrame.OnZoomMenu	(	self,
		event
	)

Popup Zoom menu.

Definition at line 1216 of file mapdisp/frame.py.

References mapdisplay.MapFrame.OnDisplayToWind(), frame.MapFrame.OnDisplayToWind(), mapdisp.MapFrameBase.OnZoomToDefault(), mapdisplay.MapFrame.OnZoomToSaved(), frame.MapFrame.OnZoomToSaved(), mapdisp.MapFrameBase.OnZoomToWind(), mapdisplay.MapFrame.SaveDisplayRegion(), frame.MapFrame.SaveDisplayRegion(), and frame.MapFrame.SetProperties().

def frame.MapFrame.OnZoomRegion	(	self,
		event
	)

Zoom to region

Definition at line 520 of file mapdisp/frame.py.

References mapwindow.BufferedWindow.UpdateMap(), and mapwindow.GLWindow.UpdateMap().

def frame.MapFrame.OnZoomToMap	(	self,
		event
	)

Set display extents to match selected raster (including NULLs) or vector map.

Definition at line 1188 of file mapdisp/frame.py.

def frame.MapFrame.OnZoomToRaster	(	self,
		event
	)

Set display extents to match selected raster map (ignore NULLs)

Definition at line 1194 of file mapdisp/frame.py.

def frame.MapFrame.OnZoomToSaved	(	self,
		event
	)

Set display geometry to match extents in saved region file.

Definition at line 1199 of file mapdisp/frame.py.

Referenced by frame.MapFrame.OnZoomMenu().

def frame.MapFrame.PrintMenu	(	self,
		event
	)

Print options and output menu for map display

Definition at line 587 of file mapdisp/frame.py.

def frame.MapFrame.QueryMap	(	self,
		x,
		y
	)

Query raster or vector map layers by r/v.what.

Parameters:

x,y	coordinates

Definition at line 633 of file mapdisp/frame.py.

References utils.GetLayerNameFromCmd(), frame.GMFrame.IsPaneShown(), frame.MapFrame.IsPaneShown(), mapdisp.MapFrameBase.IsStandalone(), mapdisplay.MapFrame.IsStandalone(), and frame.MapFrame.IsStandalone().

def frame.MapFrame.QueryVector	(	self,
		x,
		y
	)

Query vector map layer features.

Attribute data of selected vector object are displayed in GUI dialog. Data can be modified (On Submit)

Definition at line 744 of file mapdisp/frame.py.

References frame.MapFrame.AddTmpVectorMapLayer(), frame.GMFrame.dialogs, frame.MapFrame.dialogs, mapdisplay.MapFrame.dialogs, frame.GMFrame.IsPaneShown(), frame.MapFrame.IsPaneShown(), mapdisplay.MapFrame.MapWindow, frame.MapFrame.MapWindow, manager.GCP.MapWindow, and forms.UpdateDialog().

def frame.MapFrame.RemoveNviz ( self )

Restore 2D view.

Definition at line 337 of file mapdisp/frame.py.

References mapdisplay.MapFrame.MapWindow, frame.MapFrame.MapWindow, manager.GCP.MapWindow, frame.MapFrame.MapWindow2D, frame.MapFrame.statusbarItemsHiddenInNviz, mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

Referenced by frame.MapFrame.OnCloseWindow().

def frame.MapFrame.RemoveToolbar	(	self,
		name
	)

Removes defined toolbar from the window.

Todo:: Only hide, activate by calling AddToolbar()

Definition at line 390 of file mapdisp/frame.py.

References mapdisplay.MapFrame.MapWindow, frame.MapFrame.MapWindow, manager.GCP.MapWindow, frame.MapFrame.MapWindow2D, mapdisp.MapFrameBase.toolbars, and frame.GMFrame.toolbars.

def frame.MapFrame.SaveDisplayRegion	(	self,
		event
	)

Save display extents to named region file.

Definition at line 1211 of file mapdisp/frame.py.

Referenced by frame.MapFrame.OnZoomMenu().

def frame.MapFrame.SaveToFile	(	self,
		event
	)

Save map to image.

Definition at line 539 of file mapdisp/frame.py.

References dialogs.GetImageHandlers(), frame.GMFrame.IsPaneShown(), and frame.MapFrame.IsPaneShown().

def frame.MapFrame.SetProperties	(	self,
		render = `False`,
		mode = `0`,
		showCompExtent = `False`,
		constrainRes = `False`,
		projection = `False`,
		alignExtent = `True`
	)