Specifiche plugin

EasyWebEditor, PaperKiller e HyperPublish dalla versione 3.0.7.156 in avanti supportano plugin “di testo" e plugin "immagine".

Lo scopo di un plugin "immagine" è ricevere in ingresso un file grafico (gif or jpg), elaborarlo, e scrivere le modifiche nello stesso file.

Lo scopo di un plugin “di testo" è ricevere i parametri di un testo (scritta, font, colore, colore di sfondo, stile, dimesione), elaboralo, e salvare l’elaborazione come file grafico (il nome del file è fornito da EWE / PK / HP come parametro).

Nel testo seguente ci sono le specifiche complete per i programmatori che vogliano costruire un plugin (o che vogliano adattare una loro applicazione a lavorare anche come plugin). Un plugin è molto facile da implementare: i parametri sono passati tramite linea di comando, e non ci sono complicazioni OLE-COM.

Se scrivete un vostro plugin... naturalmente segnalatecelo!

Plugin di testo

Per installare un plugin di testo occorre inserire queste chiavi nel registry (i nomi sono autoesplicativi):

[HKEY_CURRENT_USER\Software\VV\Iper\PluginText]

[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\MyPluginText1]

"EffectName"="My plugin text 1"

"EffectPath"="c:\tmp\myplugin.exe"

"EffectPars"="/text"

[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\PlugText2]

"EffectName"="Text eff 2"

"EffectPath"="c:\windows\myapp.exe"

"EffectPars"="/runiniperpluginmode /e2"

EWE/HP/PK chiamano l’exe del plugin con i parametri forniti (EffectPars) sulla linea di comando, più i seguenti parametri:

/Icaption="Hello word!" /Ifont="Times new roman" /Isize=12

/Icolor=#aa0000 /Ibg=#ffffff /Ib=0 /Ii=0 c:\...\heretheresult.gif

(Nota che i “valori” dei parametri sono rimpiazzati dai valori del blocco di testo selezionato. Nel parametro “caption” i doppi apici sono memorizzati con “” (raddoppiati). b=0 significa no bold, i=0 no italico)

Plugins immagine

Per installare un plugin immagine occorre inserire queste chiavi nel registry (i nomi sono autoesplicativi):

[HKEY_CURRENT_USER\Software\VV\Iper\PluginImage]

[HKEY_CURRENT_USER\Software\VV\Iper\PluginImage\MyPluginImg1]

"EffectName"="My plugin image 1"

"EffectPath"="c:\tmp\myplugin.exe"

"EffectPars"="/img"

EWE/PK/HP chiamano l’exe del plugin con i parametri forniti (EffectPars) sulla linea di comando, più i seguenti parametri:

c:\thepath...\theNameOfTheImage.gif

Suggerimenti

Un plugin di testo è ancora più utile se è concepito in modo che sia possibile scegliere un testo su una pagina Web, applicare un effetto, scegliere un altro testo, applicare lo stesso effetto, e ripetere tutto questo per esempio per tutti i titoli che sono su una pagina.

Se il vostro software è (ad esempio) tePRO.exe, è possibile implementare questo comportamento in questo modo:

[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\TextEffectPRO]

"EffectName"="Text Effect PRO effects"

"EffectPath"="c:\windows\tePRO.exe"

"EffectPars"="/effects”

[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\TextEffectPROredo]

"EffectName"="Text Effect PRO repeat last effect"

"EffectPath"="c:\windows\tePRO.exe"

"EffectPars"="/redolasteffect"

Il software tePRO.exe dovrebbe memorizzare l’ultimo effetto fatto per iPer (per esempio nella stessa chiave di registry, potrebbe usare qualcosa come "EffectLast"), e dovrebbe leggere i parametri quando richiamato con “/redolasteffect”.

Nota che questo trucchetto è utile anche per i plugin “immagine”.

Test e debugging

Qualsiasi versione successiva alla 155 va bene per provare i plugin (scarica qui): quando EWE/PK/HP trova le chiavi di registry, un bottone “bacchetta magica” appare: è possibile allora scegliere un blocco di testo o un’immagine e applicare l’effetto desiderato usando il bottone.

Un’applicazione di esempio (demo exe, e sorgenti Delphi) è disponibile qui: http://visualvision.com/download/plugapp.zip

Eventuali commenti Contattaci