Fanton's tutorial - RGSS

[fanton95]

Tutorial RGSS
Tutorial n°1

1. Introduzione

Per: RPG Maker XP
Autore: Fanton95
Descrizione: Introduzione all'RGSS e creazione di una finestra
Ultima modifica: 25/10/2009

2. Tutorial

Introduzione

Questo è il primo di circa sette tutorial per imparare le basi dell'RGSS. Alla fine di questo "percorso" non sarete degli scripter professionisti, infatti questa collezione di tutorial ha unicamente lo scopo di avviare l'utente allo scripting in RGSS.

L'RGSS (Ruby Game Scripting System) è un sottolinguaggio del Ruby ed è stato creato appositamente per RpgMaker XP allo scopo di modificarlo e personalizzarlo il più possibile. Il penultimo tool della Enterbrain, RpgMaker VX, utilizza per la gestione degli script l'RGSS2.

Cosa cambia tra RGSS e RGSS2?
Usano la stessa versione del ruby (1.8.1), ma l'RGSS2 ha le classi ed i moduli riscritti meglio, facendo anche più cose in alcuni casi, che sono più facilmante personalizzabili, anche da fonti diverse, limitando le possibili incompatibilità. Si appoggiano a strutture dati differenti, cioè gli stessi elementi del gioco sono trattati in modo diverso dai due frameworks (es. l'RGSS usa un solo oggetto Game_Screen per tutto il gioco, mentre l'RGSS2 ne prevede uno per ciascuna mappa). Il player RGSS2 non genera errori di hanging script, quindi è molto più affidabile per cose come le connessioni ad internet, e gira a 60 fotogrammi al secondo, contro i 40 dell'RGSS.
Credito Giver per la definizione.

Torniamo a noi, nel database degli script del programma (F11) troviamo degli script predefiniti e sono divisi nelle
seguenti categorie:

http://img248.imageshack.us/img248/6871/ripartizionedegliscript.png

-Game: è la vera e propria struttura del gioco e detrmina le posizione, le caratteristiche dell'eroe, gli eventi comuni etc...

-Sprite: è il settaggio delle immagini del gioco: personaggi, charas, icone etc...

-Finestre: le windows sono semplicemente tutte le finestre che compongono il gioco come lo stesso menù, la finestra
dei soldi, dei passi e tutte le altre.

-Interpreter: Sono appunto gli interpreti dei comandi negli eventi come ad esempio lo "Show Message".

-Scene: Questo è tutto ciò che il giocatore vede, dalla mappa attuale, al menù, al Game Over.

-Main: Il main è il comando principale per far paritre il gioco, infatti esegue tutto ciò (tutti gli script) che vi è prima di esso.

Creazione di una finestra di base

Nozioni necessarie: Nessuna, solo un pò di matematica e di buona volontà. =D

1)Creazione di una classe
La prima cosa da fare è dare il nome ad una classe e farla ereditare dal Window_Base. Ereditare una classe
significa farle prendere tutte le proprietà di quella "madre", in questo caso quelle definite nel Window_Base (in particolare le dimensioni della finestra). Noi doremmo avere due metodi principali in questa classe: "initialize" lo useremo per inizializzare le variabili e "refresh" per scrivere il testo voluto. La struttura principale sarà questa:

class Window_My < Window_Base
    def initialize
    end
    def refresh
    end
end

2)"Initialize"
Nel nostro "Initialize" inseriremo: la dimensione e la posizione della finestra, un bitmap dove inserire tutto quello che vorremo e la dimensione e il tipo di font che utilizzeremo successivamente. La prima cosa da fare è inserire il metodo "super" che determinarà le porprietà della finestra:

super(Posizione X, Posizione Y, Larghezza, Altezza)

Infine creare il Bitmap, i valori consigliati e quelli stndard sono questi:

self.contents = Bitmap.new(width - 32, height - 32)

"widht" è la larghezza della finestra
"height" è l'altezza della finestra

Attenzione! Assegnando ad uno di questi metodi valori negativi riscontrerete questo errore: Error - failed to create bitmap

Ma in base a quali concetti succede questo?
Ecco una rappresentazione grafica per facilizzarne la comprensione:
Il Bitmap è come se fosse un contenitore immaginario dove posizionare tutte quello che vogliamo da scritte ad immagini etc.. Le sue dimensioni vengono definite nel metodo "super" e come possiamo facilmente notare i "- 32" sono la distanza tra la finestra e il margine del Bitmap.

http://img194.imageshack.us/img194/3008/bitmap32.png

E se il valore del "super" fosse maggiore delle dimensioni della finestra, cioè se avessimo una cosa del genere:

self.contents = Bitmap.new(width + 70, height + 70)

Cosa succederebbe? Ecco il risultato:

http://img18.imageshack.us/img18/3117/bitmap70.png

Rpg Maker XP quando ha un Bitmap maggiore delle dimensione della finestra, come nel nostro caso, prende le freccie
dell'attuale Window Skin permettendo lo scorrimento del Bitmap.
Ricordate: Tutti gli elementi vanno inseriti nel Bitmap! Una finestra senza Bitmap non serve a nulla.

Continuando con la creazione della finestra è arrivato il momento di definire la dimensione e il tipo di font da utilizzare per scrivere il testo voluto e lo faremo atraverso questi comandi:

self.contents.font.name = "Arial"
self.contents.font.size = 22

Naturalmente al posto di Arial dovrete inserire il vostro font a patto che: sia SEMPRE scritto tra virgolette e si trovi nella cartella C:\Windows\Font. Per il secondo comando credo sia intuitivo.. o no? Bisogna sostituire 22 con la dimensione che si vuole. Per scrivere, finalmente, il testo bisognerà inserire un "refresh", che verrà definito nel metodo successivo. Attenzione! Il nome "refresh" è stato utilizzato per comodità ma può essere chiamato come si
vuole: Francesco, Pasquale, Nicola, Giovanni etc...

Ricapitolando nel nostro "Initialize" adesso avremo:

def initialize
    # Dimensione della finestra.
    super(0, 0, 160, 64)
     # Creazione del Bitmap.
    self.contents = Bitmap.new(width - 32, height - 32)
    # Settaggio della dimensione e del tipo di testo da utilizzare.
    self.contents.font.name = "Arial"
    self.contents.font.size = 22
    # Richiamare il metodo refresh per scrivere il testo.
    refresh
end

3)Il contenuto della finestra
E' arrivato il momento di inserire nella finestra un testo e quindi di definire il metodo refresh scritto in precedenza. La prima cosa da fare è "pulire" la finestra e lo faremo in questo modo:

def refresh
    self.contents.clear
end

Cosa intendiamo per "pulire" la finestra e perchè farlo? Se successivamente volessimo inserire un testo per aggiornare la scritta, senza questo metodo, queste ultimo non verrebbe sostituito all'altro ma sovrapposto; è quindi buona norma utilizzare questa stringa.

Infine ecco il comando per inserire il famoso testo:

self.contents.draw_text(Posizione X, Posizione Y, Larghezza, Altezza, "RPG2S")

Attenzione! Le posizioni x o y verranno calcolate da margine del Bitmap non da quello della finestra.

Attenzione! La larghezza e l'altezza definite si adatteranno a quelle del testo ad esempio: se quella definita è minore di quella del testo, quest'ultimo verrà ridotto.

Abbiamo terminato la nostra finestra! Ecco il codice completo di come dovrebbe essere:

class Window_My < Window_Base
    def initialize
        # Dimensione della finestra.
        super(0, 0, 160, 64)
        # Creazione del Bitmap.
        self.contents = Bitmap.new(width - 32, height - 32)
        # Settaggio della dimensione e del tipo di testo da utilizzare.
        self.contents.font.name = "Arial"
        self.contents.font.size = 22
        # Richiamare il metodo refresh per scrivere il testo.
        refresh
    end
    def refresh
        # Pulire il contenuto della finestra
        self.contents.clear
        # Scrivere il testo
        self.contents.draw_text(0, 0, 120, 32, "RPG2S")
    end
end

Per richiamare tramite evento la vostra finestra inserite in un call script:

Window_My.new

Credo di essere stato abbastanza chiaro. Al prossimo tutorial! Dove impareremo a creare una scena O_O.

Edited January 15, 2013 by Flame

[Kingartur2]

Non c'era il tutorial di Sleping per le finestre??

[Amos_MHF]

Non c'era il tutorial di Sleping per le finestre??

Beh, se vuole fare una collezione di tutorial, dovrà farla completa.

E' sempre meglio un tutorial in più, che uno in meno.

[Tio]

Ottimo tutorial Fanton ;)

Approccio molto pratico, il modo migliore per iniziare ^^

[Kingartur2]

Questo lo devo dire bellino come tutorial utile per iniziare e dire che una volta(2 mesi fa) se leggevo sta roba non ci cxapivo comunque niente Edited October 25, 2009 by kingartur2

[fanton95]

Non c'era il tutorial di Sleping per le finestre??

 

Sì ed era anche ottimo ma come ha precisato Amos vorrei postare una piccola collezione di tutorial, non volevo iniziare dai più difficili e mi sembrava giusto cominciare dalle basi. :rovatfl:

[Guardian of Irael]

Letto! Bel tutorial fanton, complimenti ^ ^

Attendo gli altri sei! ^ ^

[ReZLee]

Ottima guida!! Utilissima :smile:

[Squall_Leonheart]

class Window_My < Window_Base  def initizialize	super (0, 0, 164, 64)  self.contents = Bitmap.new(width - 32, height - 32)  self.contents.font.name = "Arial"  self.contents.font.size = 22	 refresh   end   def refresh   self.contents.clear   self.contents.draw_text (0, 0, 120, 32, "CIAO")  end end

 

Mi dà un errore quando parlo con l'evento che dovrebbe richiamare la window perchè?

Arguments 4...

[Amos_MHF]

Come imposti l'evento?

[giver]

Riga 2.

E' def initialize, non def initizialize . . .

[Amos_MHF]

Che stupido, non ho notato l'errore...

[Squall_Leonheart]

O.O Scusate un errore di distrazione!

Infatti ora và grazie^^

[Hunter]

per mettere se premo un tasto esce la finestra, sennò no...come si fa?

il tasto sarebbe la Z, se non si può con la Z faccio con H

[fanton95]

In un processo parallelo:

 

If tasto A è premuto

 

Call script con

Window_My.new

 

else

end

 

Se else non ti serve puoi anche toglierlo quando inserisci l'if.

Edited December 30, 2009 by fanton95

[Hunter]

e per fare in modo che:

premo z esce la finestra...

ripremi z la finestra sparisce...

Edited December 30, 2009 by Hunter

[Squall_Leonheart]

Dovrebbe essere:

 

	if Input.trigger?(Input::A) 	  @window.visible =! @window.visible	 end

 

Almeno negli script è cosi..

[Kingartur2]

Varamente fovrebbe essere

@window.visible = !@window.visible