In questo articolo vedremo come preparare un progetto .NET con Visual Studio in modo da poter cominciare a sperimentare con Intel® RealSense™ SDK.
L’articolo si riferisce alla versione 6.0.x dell’SDK di Intel® RealSense™ attualmente scaricabile all’indirizzo https://software.intel.com/en-us/intel-realsense-sdk/download
Il primo progetto .NET con RealSense™ SDK
Cominciamo a vedere come preparare in maniera adeguata il progetto .NET (in particolare vedremo un progetto VB.NET ma il discorso che faremo vale in maniera identica per il linguaggio C#).
Un progetto .NET, per poter funzionare ha bisogno di:
- Referenziare la libreria libpxcclr.cs.dll che si trova in una sottocartella della cartella di installazione dell’SDK. Ne esistono due versioni, una per piattaforme x86 e una per piattaforme x64 e, generalmente, si trovano nelle seguenti cartelle:
C:\Program Files (x86)\Intel\RSSDK\bin\win32 --> piattaforma x86 C:\Program Files (x86)\Intel\RSSDK\bin\x64 --> piattaforma x64
- Nel momento in cui viene eseguita l’applicazione, nella cartella dove si trova la libpxcclr.cs.dll (e, quindi, anche il nostro eseguibile), deve trovarsi la libreria libpxccpp2c.dll che si trova nelle stese cartelle appena viste per la libpxcclr.cs.dll
Quando stiamo sviluppando all’interno di Visual Studio, dunque, dovremmo fare in modo di ricreare queste condizioni in modo che il progetto possa essere compilato (la prima delle condizioni) e eseguito (la seconda delle condizioni).
Per fare questo, una volta creato il nostro progetto (nella demo allegata si tratta di un semplice progetto WPF), dovremo procedere secondo la seguente checklist:
- Eliminare la configurazione di compilazione AnyCPU e definire le configurazioni x86 e x64;
- Aggiungere le opportune reference della libreria libpxcclr.cs.dll in base alla configurazione scelta;
- Fare in modo che la libreria libpxccpp2c.dll venga, in fase di compilazione, copiata nella cartella di bin del nostro progetto.
Procediamo con ordine.
Per modificare opportunamente le configurazioni ci compilazione è necessario utilizzare il Configuration Manager accessibile dal menù contestuale della Solution:
Una volta aperto il configuration manager si debbono creare le due configurazioni x86 e x64 utilizzando il menù “<New…>” della combo riportata in figura:
Il menù “<New…>” apre la finestra di creazione della configurazione come mostrato nella seguente figura:
Una volta create le due nuove configurazioni è sufficiente utilizzare il menu “<Edit…>” della stessa combo e rimuovere la configurazione “AnyCPU”.
Definite le due configurazioni, è il momento di referenziare opportunamente le due versioni della libreria libpxcclr.cs.dll e, per fare questo, è necessario aprire il progetto VB.NET (o C#) con un editor di testo ed inserire le due righe:
<Reference Include="libpxcclr.cs" Condition="'$(Platform)'=='x86'"><HintPath>..\..\..\..\..\..\Program Files (x86)\Intel\RSSDK\bin\win32\libpxcclr.cs.dll</HintPath></Reference><Reference Include="libpxcclr.cs" Condition="'$(Platform)'=='x64'"><HintPath>..\..\..\..\..\..\Program Files (x86)\Intel\RSSDK\bin\x64\libpxcclr.cs.dll</HintPath></Reference>
all’interno dell’ItemGroup delle reference di progetto.
A questo punto ci rimane solo l’automazione della copia della libreria libpxccpp2c.dll.
Per fare questo sfruttiamo la capacità che Visual Studio ha nell’eseguire degli script in pre-build (cioè prima della compilazione) e post-build (cioè dopo la compilazione).
Nella fattispecie utilizzeremo uno script di post-build da eseguire se e solo se la compilazione va buon fine.
Per fare questo apriamo le proprietà del progetto nel quale inserire lo script di post-build utilizzando il menù contestuale e, dalla pagina delle proprietà, nella sezione “Compile” premiamo il tasto “Build Events..”,
Nella finestra di gestione degli eventi di build (mostrata nella figura seguente), premiamo il tasto “Edit Post-build …”
e inseriamo lo script:
if "$(Platform)" == "x86" ( copy /y "$(RSSDK_DIR)\bin\win32\libpxccpp2c.dll""$(TargetDir)" ) else ( copy /y "$(RSSDK_DIR)\bin\x64\libpxccpp2c.dll""$(TargetDir)" )
e premiamo OK come mostrato nella seguente figura:
Il progetto è ora pronto, la compilazione avverrà con la dll managed libpxcclr.cs.dll corretta e la dll core libpxccpp2c.dll verrà copiata nella cartella di destinazione degli eseguibili.
Siamo pronti, ora, a sperimentare con Intel® RealSense™ SDK.