Win32API [RGSS] 1

[ProGM]

Win32API

1) Cosa sono?
Sono un metodo usato per richiamare in ruby delle funzioni di una DLL (Dynamic-link library) e integrarle nel proprio programma/gioco.

2)Perché si usano?
essenzialmente perché richiamando le funzioni delle DLL di windows si può fare quasi tutto: gestione grafica, audio, gestione di finestre, avvisi, accesso a internet, controllo tasti, ecc...

3)Ma se sono così potenti, perché vengono usate così poco?
perché sono allo stesso tempo utili, numerose e incasinate alla follia: hanno una sintassi difficile, scomoda e con poca documentazione (per ruby è totalmente assente, se non qualche articolo qui e là). Questo obbliga ad sfruttarle solo come ultima risorsa.

4)Come funzionano?
la sintassi è questa:

# impostazione della dll
api = Win32API.new("DLL", "funzione", quanti e che tipo di valori vanno passati, tipo di output)
#richiamo del comando
api.call(valori da passare)

-DLL è il nome della dll (ma va)
-"funzione" è il comando da richiamare
-"quanti e che tipo di valori vanno passati": il tipo di valori si identifica grazie a delle sigle ( P = stringa, I = numero intero, L = espressione, V = valore vuoto, usato per l'output )
per esempio se dovessimo passare una stringa e un numero scriveremo "PI"
- tipo di output è il valore che la dll restituirà: funziona allo stesso modo, solo che ne può essere restituito solo uno (ovviamente)
un esempio:

@@mltmd = Win32API.new('winmm', "mciSendString","PPII","I")
@@mltmd.call("open filename alias test", "null", 0, 0)

ecco un elenco rapido delle dll più usate:
KERNEL32.DLL -> funzioni base, di basso livello, come la gestione dei task, memoria, controllo tasti
USER32.DLL -> gestione delle finestre, dei messaggi d'errore ecc...
GDI32.DLL -> tutto ciò che ha a che fare con l'output dei dispositivi
COMDLG.DLL, LZ32.DLL, VERSION.DLL -> Supporto per le finestre di dialogo comuni, la compressione dei file e il controllo della versione. In alcuni casi sono accessibili direttamente in altri è necessario ricorrere alla APIGID32.DLL
ODBC32.DLL -> fornisce un API standard per diversi tipi di DataBase.
COMCTL32.DLL -> Implementa il nuovo gruppo di controlli delle finestre (elenco ad albero, ecc.)
MAPI32.DLL -> permette di operare sulla posta elettronica.
NETAPI.DLL ->Funzioni di accesso e controllo delle reti.
WINMM.DLL -> Funzionalità multimediali di un sistema. (riproduzione filmati, musiche ecc...) (NON SUPPORTA DVX)

per documentazione (incompleta e incomprensibile ^^):
http://www.microsoft...dn/default.mspx
4)Come capirci qualcosa e semplificare l'utilizzo
di solito per semplificare l'utilizzo delle dll ai comuni mortali (ma anche a se stessi, per evitare di riscrivere tutto il casino ogni volta) di solito si creano delle classi o dei moduli che fanno corrispondere i loro metodi a funzioni richiamate con le api.
un esempio:

Spoiler

module Multimedia
  @@mltmd = Win32API.new('winmm', "mciSendString",["P","P","I","I"],"I")
  @@waveOutSetVolume  = Win32API.new('winmm', 'waveOutSetVolume', 'PL', 'I')
  def self.play(music, loop = false, from=0)
  @loop = loop
  if from > 0
  @from = " from "+from.to_s
  end
  @@mltmd.call("open "+music+" alias SOUND", "null", 0, 0)
  @@mltmd.call("play SOUND", "null", 0, 0)
  @music = music
  end
  def self.length(name)
  tmp=" " * 256
  @@mltmd.call("open "+name+" alias test", "null", 0, 0)
  @@mltmd.call("status test length", tmp, tmp.length, 0)
  @@mltmd.call("close test", "null", 0, 0)
  return tmp.delete!("0").to_i
  end
  def self.stop()
  @@mltmd.call("stop SOUND", "null", 0, 0)
  @@mltmd.call("close SOUND", "null", 0, 0)
  end
  def self.update
  if @loop
  tmp=" " * 256
  @@mltmd.call("status SOUND mode", tmp, tmp.length, 0)
  tmp = tmp.delete!("0")
  if tmp == "stopped"
  @@mltmd.call("play SOUND"+@from, "null", 0, 0)
  end
  end
  end
  def self.pause()
  @@mltmd.call("pause SOUND", "null", 0, 0)
  end
  def self.set_volume(left_channel, right_channel = nil)
	right_channel ||= left_channel
	lvolume = left_channel > MAX_VOLUME ? MAX_VOLUME : left_channel
	rvolume = right_channel > MAX_VOLUME ? MAX_VOLUME : right_channel
	volume = lvolume | rvolume << 16
	if @@waveOutSetVolume.call(-1, volume) != 0
	end
  end
  def setpitch=(value)
	api=Win32API.new('winmm', 'waveOutSetPitch', 'PI', 'I')
	api.call(@music, 0x8000)
  end
end

P.S. scusate imprecisioni, ho imparato un po' a tentativi xD

[marigno]

Si però se non si sa creare le DLL non è molto utile :(.
Comunque, che dire, bravo ^^.

[ProGM]

ma l'hai letto xD? le dll usi quelle di windows, mica le crei ^^
in effetti però non è chiaro, perchè non ho finito ^^

[Erunamo]

E se uso Linux?

[ProGM]

eh, ci avevo pensato anche io... se usi linux non sono sicuro che emuli tutto per bene... prova, no?
comunque se l'emulatore è tale dovrebbe poterlo fare ^^

[Lestat]

si dovrebbe!
Comunque la programmazione tramite DLL è una vera seccatura.
Cmq buon tutorial PRO

[Broly88]

Sarà pure una seccatura, ma quando riesce rulla di brutto!!

[Lestat]

E' che windows si capisce solo lui! >_>

[Broly88]

Mai frase fu più veritiera...

[ProGM]

per me non si capisce neanche da solo, visto come funzionano bene i programmi microsoft Oo

comunque domani lo finisco il tut...

[Dexter92]

Ciao!

Mi stavo chiedendo se è possibile scoprire il nome delle funzioni contenute nella dll, per poterle importare in un progetto...

 

Sempre ammesso che non esista un modo per "caricare" direttamente l'intera dll. Dubito però che questo sia possibile...

Un esempio di facile comprensione riguarda RPG maker. Potrebbe aver definito:

class Bitmap
  def fill_rect(*params)
    rgss = Win32API.new("RGSS301", altri parametri)
    rgss.call(*params)
  end
end

Continuando a considerare questo caso, è possibile trovare i parametri da passare a Win32API.new per chiamare la funzione della dll che corrisponde al metodo fill_rect della classe Bitmap?

[ProGM]

Fammi capire. Questa cosa come vorresti usarla?

Vuoi usare funzioni di RGSS3 su una versione di RPG Maker precedente?

 

Temo che questo cmq non sia possibile :\

[Dexter92]

Sì, più o meno...

In realtà avevo visto questa pagina che mi ha incuriosito! Stavo pensando, se fosse stato possibile richiamare le singole funzioni dalle dll, di poter usare librerie "incrociate", andando a selezionare il meglio da ognuna.

 

Peccato però che non sia possibile =(

[ProGM]

Figata quell'articolo! Ci provai anni fa tra rpgmaker VX e rpgmaker XP con scarsi risultati (non riuscivo a far combaciare la lettura di tileset, visto che il VX ha i tileset quadrettosi :\ ) .

 

Ibridare la DLL la vedo sinceramente dura, non so neanche se siano compatibili. Magari è anche fattibile richiamare funzioni di una tramite Win32Api, ma chi ti dice che effettivamente le bitmap dell'rgss3 siano compatibili con quelle delle versioni precedenti? Potrebbero aver cambiato formato e struttura interna. Non conoscendone la struttura interna dovresti andare a tentoni, e secondo me non ne vale la pena. Piuttosto quello che mi hai linkato mi sembra la soluzione più percorribile...

[Dexter92]

Ah ok... Per tentoni non è mai una buona via...

 

Ma volendo si potrebbe provare almeno un tentativo? Così se non riesce lascio perdere definitivamente xD

[ProGM]

Per analizzare la DLL e cercare di scovare i punti di accesso puoi provare a usare tool tipo Resource Hacker (un po' vecchiotto) o meglio PE Explorer (che è a pagamento ma ha una versione di prova)

[Dexter92]

Ok, ho provato ad aprire la RGSS301.dll con PE explorer... Questo è il risultato che ho ottenuto:

Spoiler

Ho preso uno screenshot della funzione RGSSInitialize3... Però come si può tentare di capire cosa fa? Immagino che l'informazione sia contenuta negli indirizzi da 100035E0 a 100035FF...

[ProGM]

Tentare di capire cosa fa dubito, piuttosto cerca se esistono i nomi espliciti delle funzioni che ti servono. Ad esempio le funzionalità di bitmap.

Potrebbe trovarsi ad esempio sotto una voce tipo RGSSBitmap.

A quel punto puoi tentare di chiamare il punto d'accesso trovato dal ruby ed accedervi.

I parametri... Devi praticamente tirare ad indovinare, o tentare di intuirli dal codice decompilato. Il punto è che non ho la benché minima idea di che formato dovresti usare per passarli :\

Dovresti leggerti qualcosa sulla comunicazione con le DLL su windows.

In ogni caso continuo ad essere fortemente dubbioso sul fatto che possano mai essere compatibili :\

 

Non voglio abbatterti, ma penso sia un lavoro che richiede una non indifferente competenza tecnica o un notevole consumo di tempo per acquisire tale competenza XD

[KenzaMe92]

Già che siamo in tema, avrei una domanda, sto cercando di fare una dll per interagire con la scheda video, come la faccio riconoscere a VXAce? sarebbe il mio tentativo di anti-lag usando la gpu per la grafica, l'spu per la musica e la cpu per gli eventi e gli script.

Modificato da KenzoMe92, 29 January 2014 - 21:57 PM.

[Guardian of Irael]

 

sarebbe il mio tentativo di anti-lag usando la gpu per la grafica, l'spu per la musica e la cpu per gli eventi e gli script.

Credo sia una cosa abbastanza complessa da fare con la semplice dll, considera che uno dei problemi più grossi quello di rpgmaker che non si basa sulla scheda grafica, se ci riesci hai vinto tutto XD

^ ^