Hello World – Guida SDL.NET
Ok, dopo aver installato il nostro SDK è proprio ora di fare qualcosa di concreto. Perlomeno, ci proviamo. Per prima cosa apriamo il nostro Visual C# Express (al momento della scrittura uso la versione 2008, liberamente scaricabile dall’indirizzo http://www.microsoft.com/express/vcsharp/).
Dal menù File, in alto a sinistra, creiamo un nuovo progetto: ci si aprirà una nuova finestra dove dovremo decidere cosa fare. Selezioniamo “Applicazione Windows Form”, scegliamo il nome per il progetto e clicchiamo su ok, come indicato nella finestra qui di seguito.
Una volta creato il nostro progetto si aprirà in automatico tutto l’ambiente di sviluppo, dove dovremo inserire il nostro codice. Prima di iniziare a scrivere selvaggiamente, però, ci sono altre piccole operazioni da effettuare.
- Aggiunta Referenze:
Nel Solution Explorer dovremo cliccare con il pulsante destro del mouse su Riferimenti, dopodichè scegliere “Aggiungi Riferimento” (immagine poco più giù). Dalla lista che ci comparirà selezionare “SdlDotNet” e cliccare su Ok.

- Cancellare il Form1:
Il file Form1.cs viene creato automaticamente, alla creazione del progetto. A noi non serve, per cui provvediamo immediatamente a cancellarlo selezionando il file con il pulsante destro del mouse e cliccando su Elimina.
- Cancellare il codice dal file Program.cs
Niente di più semplice, dovete cancellare il codice del file in questione e sostituirlo con il codice riportato qui di seguito.
– Inizio Codice –
[code]]czo3Mjk6XCINCnVzaW5nIFN5c3RlbTsNCg0KdXNpbmcgU2RsRG90TmV0LkNvcmU7DQp1c2luZyBTZGxEb3ROZXQuR3JhcGhpY3M7DQp7WyYqJl19DQpuYW1lc3BhY2UgU2RsRG90TmV0RXhhbXBsZXMuU21hbGxEZW1vcw0Kew0KDQogICAgcHVibGljIGNsYXNzIEhlbGxvV29ybGQNCntbJiomXX0gICAgew0KICAgICAgICBbU1RBVGhyZWFkXQ0KICAgICAgICBwdWJsaWMgc3RhdGljIHZvaWQgTWFpbigpDQogICAgICAgIHsNCiAge1smKiZdfSAgICAgICAgICBIZWxsb1dvcmxkIGFwcCA9IG5ldyBIZWxsb1dvcmxkKCk7DQogICAgICAgICAgICBhcHAuR28oKTsNCiAgICAgICB7WyYqJl19IH0NCg0KICAgICAgICBwdWJsaWMgSGVsbG9Xb3JsZCgpDQogICAgICAgIHsNCiAgICAgICAgICAgIFZpZGVvLlNldFZpZGVvTW9kZXtbJiomXX0oNDAwLCAzMDApOw0KICAgICAgICAgICAgVmlkZW8uV2luZG93Q2FwdGlvbiA9IFwiSGVsbG8gV29ybGQhXCI7DQogICAgICAgIH0NCg17WyYqJl19CiAgICAgICAgcHVibGljIHZvaWQgR28oKQ0KICAgICAgICB7DQogICAgICAgICAgICBFdmVudHMuUXVpdCArPSBuZXcgRXZlbnRIYXtbJiomXX1uZGxlcjxRdWl0RXZlbnRBcmdzPih0aGlzLlF1aXQpOw0KICAgICAgICAgICAgRXZlbnRzLlJ1bigpOw0KICAgICAgICB9DQoNCiAge1smKiZdfSAgICAgIHByaXZhdGUgdm9pZCBRdWl0KG9iamVjdCBzZW5kZXIsIFF1aXRFdmVudEFyZ3MgZSkNCiAgICAgICAgew0KICAgICAgICB7WyYqJl19ICAgIEV2ZW50cy5RdWl0QXBwbGljYXRpb24oKTsNCiAgICAgICAgfQ0KICAgIH0NCn0NClwiO3tbJiomXX0=[[/code]
Fatto questo, non vi rimane che salvare il progetto e premere F5 per avviare la nostra prima applicazione con SDL.NET! Lo so, non è niente di eccitante.
Se invece il programma vi da degli errori, beh... vi ricordate cosa ho detto nell'articolo precedente, riguardo le dipendenze? Dovete avere il file SDL.dll nella stessa cartella del vostro file eseguibile, oltre alle librerie fornite con il package di installazione. Guardate l'immagine di seguito, in modo da capire quali sono i file da includere nella cartella:

Un consiglio: come potete vedere in questa cartella vi sono un infinità di files: se volete, provate a togliere quelli che secondo voi non servono e fate tanti test. In questo modo potrete capire quali sono le dipendenze necessarie per ogni caso. Se invece volete andare sul sicuro, lasciate tutti i files nella cartella e non vi preoccupate
Prima di proseguire, spieghiamo un po quello che abbiamo fatto:
Tramite le direttive using abbiamo incluso i namespace delle “sezioni” della libreria che ci servivano: nel nostro caso abbiamo incluso “Core”, ovvero la base essenziale, e “Graphics”, che come suggerisce il nome serve per la gestione degli aspetti grafici.
Abbiamo creato quindi una piccola classe HelloWorld con i metodi essenziali alla creazione della nostra base: il costruttore HelloWorld, che si occupa di inizializzare il video ad una risoluzione di 400 x 300 e cambiare il titolo della finestra (WindowCaption) il metodo Go(), che assegna i vari EventHandler agli eventi previsti dalla libreria ed infine il metodo Quit, che regola l'uscita dal programma.
Spero mi perdonerete per questa mia sintetica spiegazione del codice: per ora è tutto quello che dovete sapere per darvi un'idea di base. Nelle prossime lezioni, tuttavia, spiegherò come capire il sistema degli eventi e sarete quindi in grado di comprendere e spiegare riga per riga tutto il codice di questo file.
Per ora, invece, è tutto!



