VrOne/Python Programming

ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC 386-439-2525 www.cardinalsystems.net

VrCfg Class Reference

VrOne/Python Configuration Class More...

Members

• Load (FileName)
• Rec ()
• GetVrVersion ()
• SetUseDefaultDir (UseDefaultDir)
• UseDefaultDir ()
• SetDefaultDir (ProgNum, DefaultDir)
• GetDefaultDir (ProgNum, Override)
• GetSymFileName ()
• SetSymFileName (FileName)
• GetCharSetDir ()
• GetColorTableScreen ()
• GetColorTablePlot ()
• GetColorTableOverride ()
• GetLayerNameFile ()
• GetPenTable ()
• SetPenTable (FileName)
• GetUsePenTable ()
• GetBackgroundColor ()
• GetSeaRad ()
• GetSeaDim ()
• GetSplineChord ()
• GetBSplineIncr ()
• GetStrokeDist ()
• GetStrokeMode ()
• GetFillDist ()
• GetMinTextSize ()
• GetMinSymSize ()
• GetMbrOffset ()
• SetDspLines (DspLines)
• GetDspLines ()
• SetDspSplines (DspSplines)
• GetDspSplines ()
• SetDspLfonts (DspLfonts)
• GetDspLfonts ()
• SetDspConstr (DspConstr)
• GetDspConstr ()
• SetDspLinePoints (DspLinePoints)
• GetDspLinePoints ()
• SetDspLineElevs (DspLineElevs)
• GetDspLineElevs ()
• SetDspSymbols (DspSymbols)
• GetDspSymbols ()
• SetDspText (DspText)
• GetDspText ()
• SetDspILines (DspILines)
• GetDspILines ()
• SetDspISymbols (DspISymbols)
• GetDspISymbols ()
• SetDspIText (DspIText)
• GetDspIText ()
• SetMbrOffset (Offset)
• SetColorTableOverride (ColorTableName)
• SetSplineChord (SplineChord)
• SetBSplineIncr (BSplineIncr)
• SetCursorType (CursorType)
• GetCursorType ()
• SetCursorSize (CursorSize)
• GetCursorSize ()
• SetCursorColor (CursorColor)
• GetCursorColor ()
• SetCursorMaskSize (CursorSize)
• GetCursorMaskSize ()
• SetCursorMaskShape (CursorShape)
• GetCursorMaskShape ()
• SetCursorTrackPlane (TrackPlane)
• GetCursorTrackPlane ()
• GetImgPyraDir ()
• GetImgPyraDrive ()
• TogImgEdges ()
• SetImgEdges (ImgEdges)
• GetImgEdges ()
• TogImgNames ()
• SetImgNames (ImgNames)
• GetImgNames ()
• SetImgDrawMode (DrawMode)
• GetImgDrawMode ()
• GetWinShift ()
• SetWinShift (WinShift)
• SetBufXyXyzInput (BufMode)
• GetBufXyXyzInput ()
• SetWinSync (WinSync)
• GetWinSync ()
• SetGridStus (GridStus)
• GetGridStus ()
• SetGridRes (GridRes)
• GetGridRes ()
• SetGridType (GridType)
• GetGridType ()
• SuspendGrid ()
• ResumeGrid ()
• SetCursConstStus (CursConstStus)
• GetCursConstStus ()
• TogCursConstStus ()
• GetXyDigId ()
• SetXyDigId (XyDigId)
• GetXyDigDelay ()
• GetXyDigMode ()
• GetXyzDigId ()
• SetXyzDigId (XyzDigId)
• GetXyzDigDelay ()
• SetVrTwoWake (WakeMode)
• GetVrTwoWake ()
• SetVrTwoEdgeDist (EdgeDist)
• GetVrTwoEdgeDist ()
• SetHwId (HwId)
• GetHwId ()
• SetHwSfX (HwSfX)
• GetHwSfX ()
• SetHwSfY (HwSfY)
• GetHwSfY ()
• SetHwSfZ (HwSfZ)
• GetHwSfZ ()
• SetHwLocZ (HwLocZ)
• GetHwLocZ ()
• SetMouseTwSf (Sf)
• GetMouseTwSf ()
• SetMouseKeyX (RawKey, KeyX)
• GetMouseKeyX (RawKey)
• SetZSource (ZSource)
• GetZSource ()
• SetActiveZ (ActiveZ)
• GetActiveZ ()
• IncActiveZ (DeltaZ)
• GetForceZ ()
• SetForceZ (ForceZ)
• GetContInt ()
• SetContInt (ContInt)
• GetSnapZToActiveZ ()
• SetSnapZToActiveZ (SnapZToActiveZ)
• SetPlotFormat (PlotFormat)
• GetPlotFormat ()
• GetPlotIface ()
• GetPlotBrightContrast ()
• SetPlotBrightContrast (Bright, Contrast)
• GetVrPathDir (DirNum)
• SetVrPathDir (DirNum, DirName)
• GetActiveDig ()
• GetOpenLastVr ()
• GetOpenLastImg ()
• GetPromptUnits ()
• GetMaxApps ()
• SetMwDecAccur (DecAccur)
• GetMwDecAccur ()
• GetMmPerInch ()
• GetMetersToFeet ()
• GetBrowser ()
• GetFkeyFileName ()
• GetMbCmdFileName ()
• GetKpCmdFileName ()
• GetMacroFileName ()
• SetBeepStus (BeepStus)
• GetBeepStus ()
• GetBeep (ButtonNum)
• SetBeep (ButtonNum, BeepStatus)
• SetBeep2 (BeepStatus)
• GetBeepSound (ButtonNum)
• SetBeepSound (ButtonNum, BeepSound)
• SetBeepNormal (BeepSound)
• GetBeepNormal ()
• SetBeepAlert (BeepSound)
• GetBeepAlert ()
• SetBeepPlotStart (BeepSound)
• GetBeepPlotStart ()
• SetBeepPlotDone (BeepSound)
• GetBeepPlotDone ()
• SetNumLockControl (State)
• GetNumLockControl ()

---

Detailed Description

The Configuration class allows various VrOne configuration parameters to be viewed and changed.

Example:

from pycfg import *

Cfg = VrCfg ()

(VrVersion) = Cfg.GetVrVersion ()

---

Member Function Documentation

Load (FileName)

Loads configuration from disk.

FileName	Configuration file name. (0=Use default)
returns	(ret)
	ret	returns 0 = OK 1 = File did not exist and was created. -1 = Could not open file.

Rec ()

Records the current configuration.

returns	(ret)
	ret	0=Success, 1=Failed

GetVrVersion ()

Returns the VrOne version string.

returns	(VrVersion)
	VrVersion	VrOne version string

SetUseDefaultDir (UseDefaultDir)

Sets whether or not VrOne uses default directories.

UseDefaultDir

0=Don't use default directories, 1=Use default directories

UseDefaultDir ()

Returns status of default directory usage.

returns	(ret)
	ret	0=Not using default directories, 1=Using default directories

SetDefaultDir (ProgNum, DefaultDir)

Sets the default directory for a program

ProgNum	Program number
DefaultDir	Default directory

GetDefaultDir (ProgNum, Override)

Returns the default directory for a program If UseDefaultDir is FALSE then NULL is returned

ProgNum	Program number (see vrcfg.h)
Override	TRUE - Always return default directory FALSE - If UseDefaultDir is FALSE then NULL is returned
returns	(ret)
	ret	Default directory

GetSymFileName ()

Get the current symbol filename.

returns	(ret)
	ret	Current symbol filename.

SetSymFileName (FileName)

Set the current symbol filename. The specified symbol file will be loaded.

FileName

Name of symbol file to load.

GetCharSetDir ()

Returns the directory that the character set files are in.

returns	(ret)
	ret	Directory of character set files.

GetColorTableScreen ()

Returns the color table for screen filename.

returns	(ret)
	ret	Color table for screen filename.

GetColorTablePlot ()

Returns the color table for plotting filename.

returns	(ret)
	ret	Color table for plotting filename.

GetColorTableOverride ()

Returns the color table override filename.

returns	(ret)
	ret	color table override filename.

GetLayerNameFile ()

Returns name of file containing layer names.

returns	(ret)
	ret	Name of file containing layer names.

GetPenTable ()

Returns the pen table filename.

returns	(ret)
	ret	Pen table filename.

SetPenTable (FileName)

Sets the pen table filename.

FileName

Pen table filename.

GetUsePenTable ()

Gets status of pen table usage.

returns	(ret)
	ret	0=Pen table not being used, 1=Pen table being used.

GetBackgroundColor ()

Returns current background color.

returns	(ret)
	ret	Background color (1-255)

GetSeaRad ()

Returns current search radius.

returns	(ret)
	ret	Current search radius.

GetSeaDim ()

Returns current search dimension.

returns	(ret)
	ret	Current search dimension.

GetSplineChord ()

Returns the spline chord length in in or mm.

GetBSplineIncr ()

Returns the B-Spline increment

GetStrokeDist ()

Returns the stroke distance for wide lines.

GetStrokeMode ()

Returns the stroke mode for wide line.

GetFillDist ()

Returns the fill distance for wide lines.

GetMinTextSize ()

Returns the minimum text size for plotting.

GetMinSymSize ()

Returns the minimum symbol size for plotting.

GetMbrOffset ()

Returns the default MBR offset

SetDspLines (DspLines)

Sets the display line status.

DspLines

0=Don't display lines, 1=Display lines

GetDspLines ()

Gets the display line status.

returns	(ret)
	ret	0=Don't display lines, 1=Display lines

SetDspSplines (DspSplines)

Sets the display splined line status

DspSplines

0=Don't display splined lines, 1=Display splined lines

GetDspSplines ()

Gets the display splined line status

returns	(ret)
	ret	0=Don't display splined lines, 1=Display splined lines

SetDspLfonts (DspLfonts)

Sets the display line fonts status

DspLfonts

0=Don't display line fonts, 1=Display line fonts

GetDspLfonts ()

Gets the display line fonts status

returns	(ret)
	ret	0=Don't display line fonts, 1=Display line fonts

SetDspConstr (DspConstr)

Sets the display construction lines status

DspConstr

0=Don't display construction line, 1=Display construction lines

GetDspConstr ()

Gets the display construction lines status

returns	(ret)
	ret	0=Don't display construction line, 1=Display construction lines

SetDspLinePoints (DspLinePoints)

Sets the display line points flag.

DspLinePoints

0=Don't display line points, 1=Display line points

GetDspLinePoints ()

Gets the display line points flag.

returns	(ret)
	ret	0=Don't display line points, 1=Display line points

SetDspLineElevs (DspLineElevs)

Sets the display line elevations flag.

DspLineElevs

0=Don't display line elevations, 1=Display line elevations

GetDspLineElevs ()

Gets the display line points flag.

returns	(ret)
	ret	0=Don't display line elevations, 1=Display line elevations

SetDspSymbols (DspSymbols)

Sets the display symbols flag.

DspSymbols

0=Don't display symbols, 1=Display symbols

GetDspSymbols ()

Gets the display symbols flag.

returns	(ret)
	ret	0=Don't display symbols, 1=Display symbols

SetDspText (DspText)

Sets the display text flag.

DspText

0=Don't display text, 1=Display text

GetDspText ()

Gets the display text flag.

returns	(ret)
	ret	0=Don't display text, 1=Display text

SetDspILines (DspILines)

Sets the display interactive lines flag.

DspILines

0=Don't display interactive lines, 1=Display interactive lines

GetDspILines ()

Gets the display interactive lines flag.

returns	(ret)
	ret	0=Don't display interactive lines, 1=Display interactive lines

SetDspISymbols (DspISymbols)

Sets the display interactive symbols flag.

DspISymbols

0=Don't display interactive symbols, 1=Display interactive symbols

GetDspISymbols ()

Gets the display interactive symbols flag.

returns	(ret)
	ret	0=Don't display interactive symbols, 1=Display interactive symbols

SetDspIText (DspIText)

Sets the display interactive text flag.

DspIText

0=Don't display interactive text, 1=Display interactive text

GetDspIText ()

Gets the display interactive text flag.

returns	(ret)
	ret	0=Don't display interactive text, 1=Display interactive text

SetMbrOffset (Offset)

Sets the entity MBR offset used when searching.

Offset

MBR offset.

SetColorTableOverride (ColorTableName)

Sets the color table override filename.

ColorTableName

Color table override filename

SetSplineChord (SplineChord)

Sets the spline chord length

SplineChord

Spline chord length (in|mm) It is expected that the parameter is in the proper units (inches or millimeter).

SetBSplineIncr (BSplineIncr)

Sets the B spline increment. Sets the number of points that will be added between current points.

BSplineIncr

SetCursorType (CursorType)

Sets the cursor type

CursorType

0=Cross 1=Dot

GetCursorType ()

Returns the cursor type

returns	(ret)
	ret	0=Cross 1=Dot

SetCursorSize (CursorSize)

Sets the cursor size

CursorSize

Cursor size in pixels

GetCursorSize ()

Returns the cursor size in pixels.

returns	(ret)
	ret	Cursor size in pixels

SetCursorColor (CursorColor)

Sets the cursor color.

CursorColor

0=White 1=Black 2=Red 3=Green 4=Blue 5=Yellow

GetCursorColor ()

Gets the cursor color.

returns	(ret)
	ret	0=White 1=Black 2=Red 3=Green 4=Blue 5=Yellow

SetCursorMaskSize (CursorSize)

Sets the cursor mask size.

CursorSize

Cursor mask size in pixels

GetCursorMaskSize ()

Gets the cursor mask size.

returns	(ret)
	ret	Cursor mask size in pixels

SetCursorMaskShape (CursorShape)

Sets the cursor mask shape

CursorShape

0=Square,1=Circle

GetCursorMaskShape ()

Gets the cursor mask shape

returns	(ret)
	ret	0=Square,1=Circle

SetCursorTrackPlane (TrackPlane)

Sets the cursor track plane for VrTwo.

TrackPlane

0=VIEW_PLANE 1=GROUND_PLANE

GetCursorTrackPlane ()

Gets the cursor track plane for VrTwo.

returns	(ret)
	ret	0=VIEW_PLANE 1=GROUND_PLANE

GetImgPyraDir ()

Returns the image pyramid directory

GetImgPyraDrive ()

Returns the image pyramid drive

TogImgEdges ()

Toggles the display of image edges/names (Mono view only)

SetImgEdges (ImgEdges)

Sets the image edge display flag.

ImgEdges

0=Don't display image edges, 1=Display image edges

GetImgEdges ()

Gets the image edge display flag.

returns