29.11.2012 Views

Quantum GIS - Osgeo Download Server

Quantum GIS - Osgeo Download Server

Quantum GIS - Osgeo Download Server

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

11.7.2 Rendere riconoscibile il plugin<br />

11.7 Usare il plugin Python<br />

L’inizializzazione del plugin si trova nello script __init__.py. Per il nostro NewLayer lo script contiene:<br />

1 # load NewLayer class from file newlayer.py<br />

2 from newlayer import NewLayer<br />

3 def name():<br />

4 return "New Post<strong>GIS</strong> layer"<br />

5 def description():<br />

6 return "Creates a new empty Postgis layer"<br />

7 def version():<br />

8 return "Version 0.1"<br />

9 def classFactory(iface):<br />

10 return NewLayer(iface)<br />

Le cose obbligatorio che uno script deve ritornare sono un nome, una descrizione e una versione,<br />

tutte implementate nello script qui sopra. Ogni metodo riporta semplicemente una stringa con<br />

l’informazione appropriata. L’altra richiesta è il metodo classFactory che deve ritornare una fonte<br />

dal plugin stesso (linea 10) dopo ricevere l’oggetto iface come argomento. Con questo semplice<br />

codice Q<strong>GIS</strong> riconoscerà il nostro script come plugin.<br />

11.7.3 Risorse<br />

Per avere una icona per il nostro plugin necessitiamo di un file di risorsa che chiameremo resources.qrc.<br />

Questo un semplice file XML the definisce la risorsa icona:<br />

<br />

<br />

icon.png<br />

<br />

<br />

Il file risorsa usa un prefisso per prevenire problemi con altri plugin usare il nome del plugin è solitamente<br />

sufficiente. Il file icon.png è semplicemente un’immagine PNG che sarà usato nella barra<br />

degli strumenti quando il plugin è attivato. E’ possibile usare un immagine di dimensione 22 x 22<br />

pixel (in modo che fitti all’interno della barra degli strumenti).<br />

Per trasformare il file risorsa in qualcosa che il plugin possa usare, essa deve essere compilata dal<br />

compilatore PyQt:<br />

Q<strong>GIS</strong> 0.9.1 User and Installation Guide 106

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!