titolo originale: “The Absolute Newbie Guide to SDL.NET”

sdldotnet_128x128

Dunque, in questo primo articolo dedicato ad SDL.NET introdurremo qualche informazione relativa al suo funzionamento e qualche dato generico. SDL.NET offre l’accesso ad una libreria multimediale e multipiattaforma, che permette di gestire ad un livello abbastanza alto sia l’Audio, l’Input (mouse, tastiera, joystick), grafica 3D (tramite OpenGL) e grafica 2D.

Attualmente, l’home page del progetto è http://cs-sdl.sourceforge.net/, ed il maintainer al momento in cui scrivo è David “jendave” Hudson.

L’approccio delle API SDL.NET è molto simile al modello sul quale si basa un altro Wrapper, PyGame per il linguaggio di programmazione Python.

Dati Assembly:

  • Nome: SdlDotNet.dll
  • Namespace: SdlDotNet

Note Aggiuntive:

  • Tao.Sdl contiene i binding di basso livello con le sei librerie C originarie (SDL, SDL_image, SDL_ttf, SDL_mixer, SDL_gfx, SMPEG)

Contenuti del file Zip:

  • /bin – Assembly;
  • /examples – Applicazioni demo basate su SDL.NET;
  • /lib – Dipendenze e librerie originali, il cui uso verrà spiegato successivamente;
  • /doc – files della documentazione in formato CHM e HTML;
  • /source – files di informazioni, file delle soluzioni/build;
  • /source/examples – codici sorgenti delle demo sopra trattate e fornite con il pacchetto;
  • /source/lib – dipendenze della libreria;
  • /source/src – codice sorgente di SDL.NET;
  • /source/setup – script di compilazione;
  • /soruce/tools – utility e loghi;
  • /source/tests – unit tests;

Dipendenze:

Questi file sotto elencati devono essere necessariamente nella cartella dove si trova l’eseguibile (il file .exe) del vostro gioco. A volte non sono necessari tutti, ma solo quelli relativi alle funzioni da voi usate. Esempio pratico: nel vostro gioco non utilizzate filmati? Allora la libreria SMPEG non sarà un granchè utile nel pacchetto finale.

Comunque sia, ecco la lista dei files che dovrebbero essere inclusi nel percorso del vostro programma:

  • SDL;
  • SDL_image;
  • SDL_mixer;
  • SDL_ttf;
  • SMPEG;
  • SDL_gfx;

Inoltre saranno necessarie le librerie .NET “Tao.Sdl”.

Installazione del Pacchetto
Per quanto riguarda l’installazione di SDL.NET in questa guida tratterò solamente la parte relativa a Windows, in quanto attualmente uso solo questo sistema operativo ed ho modo di fare qui le prove. Per quanto riguarda Linux e Mac troverete le vostre risposte (in inglese) su: http://cs-sdl.sourceforge.net/index.php/The_absolute_newbies_guide_to_SDL.NET.

Sotto Windows potremo installare le nostre librerie tramite 3 soluzioni diverse:

  1. Runtime Installer, per gli utenti che non intendono modificare il codice sorgente;
  2. SDK Installer, per coloro che vogliono installare tutto il pacchetto completo di codice sorgente;
  3. Archivio Zip, un’ alternativa all’installer classico, utile per gestirsi i files come si vuole.

Con il Runtime Installer:

Dalla pagina di download del progetto, selezionare la voce SdlDotNet-x.x.x-runtime-setup.exe, dove x.x.x è l’ultima versione del progetto disponibile. Una volta scaricato il pacchetto, basterà eseguire il doppio click sul file e seguire le istruzioni a schermo.

Con l’ SDK Installer:

Dalla pagina di download del progetto, selezionare la voce SdlDotNet-x.x.x-sdk-setup.exe, dove x.x.x è l’ultima versione del progetto disponibile. Come per il caso precedente, cliccare due volte sul file appena scaricato e seguire le istruzioni. Per compilare i codici sorgenti basterà usare i files “build.bat”.

Con l’Archivio Zip:

Dalla pagina di download del progetto, scaricare il file SdlDotNet-x.x.x.zip. Copiare i file in /bin (SdlDotNet.dll e Tao.Sdl.dll) nella cartella della Global Assembly Cache (di solito è c:\winnt\assembly). Copiare i file in /bin/win32deps in una directory a tua scelta (di solito è consigliato C:\winnt\system32). Se si vuole compilare l’SDL.NET, eseguire il file build.bat.

Nei percorsi poco sopra, winnt potrebbe anche essere la cartella Windows per cui non fatevi disorientare dal nome.

Se non sono stati riscontrati problemi, è tutto regolare e il nostro SDK e bello ed installato! Ora dobbiamo solamente programmarci (solamente eh -.-”). Procediamo all’Hello World, forza e coraggio!

  • Share/Bookmark