================================================================================
PAGE 1
================================================================================

GeViSoft SDK
Dokumentation |Documentation |Documentation |Documentatión
Version 2012_1.7|Date19.07.2012

================================================================================
PAGE 2
================================================================================

GeViSoft SDK
Introduction
TheGeViSoftSDKallowsintegrating yourcustomsolutionsandproductswithGeutebrück’s
GeViSoftsuite.Itincludesanapplication programming interface(API)withallnecessary
DLLs,headers,exampleprojects,anddocumentation tohelpyougettingstartedwithyour
integration easily.
TheSDKsupportsC++andDelphi.Furthermore a.Netwrapperisincludedwhichallowsyou
tousetheSDKfromC#.Itprovidesvariousexampleprojectsandsolutionsintheselan-
guages.

================================================================================
PAGE 3
================================================================================

GeViSoft
GeViSoftisGeutebrück’s centralmanagement systemforvideocontrol.Itsmainfunctionis
theswitchingofvideosignalsbetweendifferentcameras,monitorsandDVRsbycontrolling
avideomatrixsystem.Alarmhandlingaswellastheremotecontrolofpan/tiltanddomecam-
erasisafurtherfunctionality ofGeViSoft.
GeViSoftcanalsobeusedtohandlegeneralpurposedigitalinputsandoutputsandthus
allowsintegrating customsensortechnology andactuatingelementstotheGeutebrück sys-
tem.
Furthermore, differentperipherals commontovideocontrolsystems,likevideomotionanal-
ysisoroperatorconsoles, canbemanaged.
GeViSoft Architecture
Thearchitecture ofGeViSoftfollowstheclient-serverparadigm. Theserversoftware(GeV-
iServer)usualrunsonadedicated PC.ThishardwareplatformiscalledGeViStation. The
combined systemofsoftwareandhardwareiscalledGeViControl.
AtleastoneIOclientmusthandleconnections totheperipherals. Thisclientiscom-
municating withtheGeViSoftserverandrunsonthesamemachine.ItiscalledGeViIO.
TheGeViIOclientprovidestheinterfaces forthecommunication totheattachedperipherals
likeaVX3matrixoraPTZ.Theseperipherals canalsobevirtualized.
GeViServer andGeViIOcanbeconfigured fromtheGeViSetapplication. Theconfiguration is
described indetailinchapterConfiguration ofGeViSoft.
ThefollowingfigureshowsasetupofGeViSoftwithanattachedVX3,digitalIOandtwoPTZ
devices.

================================================================================
PAGE 4
================================================================================



================================================================================
PAGE 5
================================================================================

Figure1-GeViSoft Example Configuration
Historically, therehasbeenademandtocontrolalargenumberofvideofeedswithalimited
numberofmonitorsinsurveillance systems.Thishasleadtotheinventionofvideomatrixes
liketheVX3,whichalloweddifferentcamerasignalstobedynamically routedtotheattached
monitors.Theroutingcouldbeuserinitiatedortriggeredbyexternaleventslikealarmsordig-
italinputs.
Besidesthevideoroutingitwasnecessary toallowtheoperatortoremotecontrolPTZand
domecamerasfromacentralconsoletoreactonalarmsorotherevents.
Aconfiguration liketheonedescribed aboveisreflectedinthesetupaccording tofigure1.
Nowadays analoguevideocamerasandmonitorsaregettingreplacedbyIPcamerasand
PCsrunningsoftwareviewerslikeGSCView. GeViSoftallowsthehandlingofthesemodern
setupsaswellsothattheycanbeintegrated seamlessly intoexistinginstallations.
Figure2givesanexampleforacomplexsetupintegrating analogueaswellasdigitalcom-
ponents.

================================================================================
PAGE 6
================================================================================

Figure2-Complex GeViSoft Setup

================================================================================
PAGE 7
================================================================================

Additional tocontrolling thecrossswitchinginsidethematrix,GeViSoftcanbeusedtocom-
municatewithGeViScopes. ItispossibletoconfigureGeViSoftinsuchawaythataGeV-
iScopeandtheconnected GscViews canbecontrolled justlikeananaloguevideomatrix,
e.g.aVX3.
Thenextchaptergivesanoverviewofthedifferentcomponents thatadduptoGeViSoft.
GeViServer
GeViServer isthebackendserverinaGeViSoftsystem.Italsomanagestheinternaldata-
base.GeViServer usuallyrunsasaWindowsserviceonproduction machines, butcanalso
bestartedasaconsoleapplication fortestingpurposesordebugging. IfinstalledbytheSDK
setup,theGeViServer mustbestartedfromtheconsole.
ItispossibletorunGeViServer inaclustertoincreasereliability.
GeViAdmin
Theapplication GeViAdmin isusedtosetuptheGeViServer database. Itcanalsobeusedto
configureredundancy settingsbyclustering severalGeViServers. Furthermore, GeViScope
canbeusedfordiagnostics andloadanalysis.GeViAdmin ispartoftheshippingproduct,but
notoftheSDK.TheSDKinstallerautomatically setsupaGeViSoftdatabaseduringthe
installation process.
GeViIO
TheGeViIOclientisresponsible forthecommunication withtheexternalinterfaces and
peripherals. ItrunsonthesamemachineastheGeViServer. Otherinstances ofGeViIO
mightrunonseparatemachines.

================================================================================
PAGE 8
================================================================================

GeViSet
GeViSetistheconfiguration toolforGeViServer. ItcanbeusedtoconfigureGeViIOclients,
users,events,alarmsandallotherfunctionalities ofGeViServer, aswellasconnections to
GeViScope servers.Someconfiguration stepsandoptionsinsideGeViSetareshowninthe
followingchapters.
GeViAPI TestClient
TheGeViAPITestClientallowstestinganddebugging GeViSoftapplications. Withthistool
youcansendandreceiveactionsandalarms,querythedatabase, andretrievesysteminfor-
mation.

================================================================================
PAGE 9
================================================================================

SDKIntroduction
TheGeViSoftSDKprovidesyouwithanopenapplication programming interfacetotheGeV-
iSoftsuiteandallowsyoutointegrateyourcustomproductswithGeutebrück’s.
TheSDKincludestheDLLsandcorresponding headerfilesrequiredbyyourC++orDelphi
projects.Furthermore .NetwrapperDllsareincludedwhichallowyoutousetheSDKfrom
yourC#application.
Severalexampleapplications helpyougettingstartedwiththeGeViSoftSDKdevelopment
andmayactasafoundation foryourownsolutions.
FilesandDirectory Structure
Duringinstallation, theenvironment variable%GEVISOFTSDKPATH% isset.Itpointstothe
rootdirectoryoftheSDKinstallation. Thevariable’svalueisdetermined bythepathchosen
astheinstalldirectoryduringsetup.Usually,thisis“C:\GEVISOFT”. AllSDKdirectories are
locatedinsidethisrootdirectory.
Thisisa(partial)treeviewofthestandardinstallation:

================================================================================
PAGE 10
================================================================================