================================================================================
PAGE 11
================================================================================

PleasenotethatthedirectoryC:/GEVISOFT/DATABASE willbecreatedwithoutregarding
thechoseninstallpath.ThisdirectoryhoststheGeViSoftdatabaseGeViDB.mdb whichis
hiddenbydefault.
Insidethe%GEVISOFTSDKPATH% directory,astructurelikethisiscreated:
lADocumentation foldercontaining allGeViSoftrelateddocumentation andmanuals.
lAnExamples folderincludingsubfolders thatarenamedaccording tothecor-
responding IDEandprogramming language.
-Insideeachofthese,thereisaGeViScopeSDK andGeViSoftSDK folderwiththe
respective IncludeandLibfoldersfortheprogramming languageaswellasthefolders
withthedifferentexamples.
-TheC++headersarelocatedinsidetheIncludefolderandthelibrariesinsidetheLib
folder.
-ForDelphi,the.pasandthe.incfilescanallbefoundinsidetheIncludefolder.
The%GEVISOFTSDKPATH% directoryitselfhostsalltheexecutables, dynamiclinklibraries,and
runtimefilesthatareneededbyGeViSoft. Bydefault,alltheexampleprojectswilloutputtheir
generated binariesintothisfolderaswell.Thisguarantees thatallruntimedependencies are
metandyourcompiledexecutables findtheneededDLLs.
Additionally, the.Netwrapperassemblies Geutebrueck.GeViSoftSDKNetWrapper.dll and
GscActionsNET.dll resideinthisfolder.

================================================================================
PAGE 12
================================================================================

SDKSetup
SetupofTest/Build Environment
Thischapterdescribes howtosetupandconfiguretheGeViSofttestenvironment.
 NOTICE
Pleasenotethatyouneedadministrative privileges onthedevelopment machine.
Installation ofGeViSoft
TheSDKisshippedasanexecutable installer.Youjustneedtorunitonyourdevelopment
machinein
ordertoinstalltheSDK.
 NOTICE
Itishighlyrecommended toinstallGeViSoft tothedefaultpathC:/Gevisoft.
 WARNING
PleasemakesurethatyoudonotinstalltheSDKonaproduction GeViSoft machine asthesetup
willoverwrite theinstalled GeViSoft fileswithout notice.
Starting GeViServer
YoucanstartGeViServer fromthecommand promptbyissuingthecommand
%GEVISOFTSDKPATH%/geviserver.exe console
orbyexecuting thestartserver.bat scriptinyourGeViSoftinstallation’s rootfolder.The
consoleargumentforcesthesoftwaretorunasaconsoleapplication andallowsyouto

================================================================================
PAGE 13
================================================================================

easilymonitortheserver’soutput.Onaproduction machine,GeViServer usuallyrunsasa
windowsservice.
 NOTICE
Pleasenotethatwithout alicensedongle, theserverwillterminate aftertwohours.Youcan
directly restartitwithout anyfurther restrictions.
Configuration ofGeViSoft
Inthischapteryouwilllearnhowtoestablishaconnection totheGeViServer withthesetup
clientGeViSet(Settinguptheserverconnection ).
Afterthatthereisadescription forsettingupaGeViIOclientthatprovidesavirtualvideo
matrixanddigitalIO(Configuration oftheGeViIOClient).Youdonotneedtocarryoutthe
stepsdescribed inthatparagraph. Theyareforreferenceonlybecausethisconfiguration is
alreadydoneforyouinthedatabasethatisdeliveredwiththeSDK.
Settinguptheserverconnection
1StartGeViServer byexecuting startserver.bat ifnotalready doneso
2StartGeViSet.exe
3Setuptheserverconnection
aOpenFile->GeViSoft serverconnections
bIfaconnection localhost exists,pressConnect andmovetostep4
cIfnoconnection existschooseConnections ->NewConnection
dEnterlocalhost asthenameofthenewconnection andpresstheForward button
eIntheCreateNewServerConnection window setthecomputer nametolocalhost ,
theusernametosysadmin .CheckSavepassword andsetthepassword tomas-
terkey.SelectLocalconnection asconnection type.PresstheForward button.
Choose thelocalhost connection andpressConnect

================================================================================
PAGE 14
================================================================================

Configuration oftheGeViIOClient(reference)
TheGeViIOclient’sconfiguration isalreadydoneforyouinsidethedatabasethatisshipped
withtheSDK.Thestepsdescribed hereareonlyareferenceforyouifyouneedtoadaptset-
tingsforyourtestenvironment.
1.IntheClientsfieldpushtheAddbuttonandaddanewGeViIOclientwiththename
GeViIO_ 01.
2.SelectthenewGeViIOclientandpressConfigure.
3.MarktheclientasActiveandVirtual.
4.AddanewVX3matrixbypressing AddintheInterfaces fieldandselectingtheappro-
priatetype(VX3/CX3).Nametheinterface VirtualVX3.
5.SelectthenewlycreatedVX3interfaceandpressEdit.
6.Add16newvideoinputstotheVX3interfacebypressingtheAddbuttonintheVideo
inputstab.IntheNewvideoInputwindowsetCountto16andpressok.Thenew
videoinputchannelsshouldshowupintheVideoinputtab.
7.Add4newvideooutputsinthesamemannerastheinputs.
8.Add8newinputcontactsand8newoutputcontactsinthesamewayyoudidforthe
videoinput.
9.Sendyournewlycreatedsetuptotheserverbychoosing File->Setuptoserverorby
clicking
 .
Nowyourclientwindowshouldlooklikethis:

================================================================================
PAGE 15
================================================================================

Connection toGeViScope (optional)
IfyouhaveaGeViScope serverupandrunning,youcanconnectGeViSofttoitviaaTCP/IP
connection. Ifconnected, actionscanbeexchanged betweenthetwosystems.Asan

================================================================================
PAGE 16
================================================================================

examplethiscanbeusedtoremotecontrolGSCView.
PleasenotethatyoucaninstalltheGeViScope ServerasapartofGeutebrück’s GeViScope
SDKifyouhavenotdoneityet.YoucandownloadthisSDKonwww.geutebrueck.com or
requestitfromtheSDKdivision.
InstallingtheGeViScope SDKisaprerequisite forthescenarioandexampleinthechapter
Switching Video.
Youcanconfiguretheconnection toGeViScope insideGeViSet.ChoosethemenuServer->
GeViScope Connections andpressAddinthepop-upmenu.Youcanthenconfigurethecon-
nectionparameters insidetheGeViScope connection window.
 NOTICE
PleasenotethattheAliasisusedtoaddressdifferentGeViScope serversfrominsidethe
SDKwithGSCActions. SeeActionmessages –>creatingactionmessages >4.Exampleofcre-
atingaGeViScope ActionMessage

================================================================================
PAGE 17
================================================================================

FirstStepswithGeViSoft
Thischapterwillleadyouthroughout yourfirststepswithGeViSoft. Youwilllearnhowtocon-
necttoaGeViServer, sendsomebasicactions,andcustomize messagelogginganddisplay
toyourneeds.IfyouarealreadyfamiliarwithGeViSoft, youcanskipthischapterorskim
throughit.
GeViAPI TestClient
TheeasiestwaytotestyourGeViSoftsetupisbyusingtheGeViAPITestClient.Youcan
startitfromyour%GEVISOFTSDKPATH% directory.
PleasemakesurethatyourGeViServer isalreadystarted.Ifnotstartitbyexecuting the
“startserver.bat” insidetheGeViSoftrootdirectory.
AfterstartupconnecttotheGeViServer byaddingyourcredentials andpressingthe“Conn”
button.Ifeverything worksout,the“Connected” indicatorwillbeilluminated ingreenandsev-
eralmessages willpopupinthe“Communication log”.Atthispointyourcommunication is
setupcorrectly.
Ifyouhavefollowedtheconfiguration stepsinchapterSettingupGeViIOyouwillalreadybe
abletouseGeViSoftforswitchingyourvirtualvideoI/O.
CrossSwitching Video
SelectthetabVideo/DigIO .Youcanswitchyourvideosignalinthefollowingway:
1.Selectanactiveinputandanactiveoutput.Thesignalwillbeswitchedbetweenthese
two.YoucanseetheactiveI/OonthewindowsrighthandsidebeneaththetextVideo.
a)Toselectanactiveoutput,left-clickononeofyourconfigured videooutputsinthe
upperwindowarea.YoushouldseeActOutchangingwithregardtoyourselection.

================================================================================
PAGE 18
================================================================================

b)Nowmovethemouseoverthedesiredinput(e.g.7)andright-clickontheinput.
Thenumberofyourselectedinputshouldnowappearintheblacksquareaboveyour
selectedoutput.
2.Clearavideooutput.Movethemouseovertheoutputtoclearandright-clickonit.The
numberintheblacksquareabovetheoutputshouldvanish.

================================================================================
PAGE 19
================================================================================



================================================================================
PAGE 20
================================================================================

 NOTICE
Whenswitching theoutput, aCrossSwitch actionwiththechosen channels isdisplayed inthe
Communication LogshowninthelowerpartoftheGeViAPI TestClient’s window.
IfarealVX3wouldbeconnected toyourGeViSoftandtheinputswereconnected tovideosig-
nals,youwouldswitchtherealsignaltotheaccording output(normallyamonitor).Youwill
learnhowtousetheseswitchactionstoremotecontrolaGscViewinthesamewayyou
woulduseananaloguematrixinthechapterSwitching Video.
Manipulating DigitalI/O
Similartothevideosignalsyoucanswitchdigitaloutputsandgeneratedigitalinputsignalsin
yourvirtualtestclient.
Generateasimulated digitalinput:
Togenerateaninputmoveyourmousepointeroverthedesiredinputchannel.Aleftclick
willsimulateaclosingofthecontact,arightclickanopening.Thecontacts’statesare
colorcodedaccording tothistable:
Color State
White Unknown
Red Closed
Green Open
Gray Unavailable
Generateasimulated digitaloutput:
Togenerateanoutputmovethepointeroverthedesiredoutputsignal.Left-clickingwill
settheoutput’sstatetoopen,right-clickingtoclose. Theoutputs’statesarecolorcoded
according tothistable:
Color State
White Unknown
Red Closed