2) Funzioni di PTViewer 2.8

Queste pagine contengono una lista delle nuove funzioni di PTViewer 2.7L2: sono riportate solo le differenze tra la Ver 2.5 e la ver. 2.72LE. La documentazione completa si trova sul sito di Helmut Dersch http://webuser.fh-furtwangen.de/~dersch/
e su questo mirror http://www.path.unimelb.edu.au/~dersch/.

Un altro sito che contiene mote informazioni utili su PTViewer si trova qui: http://users2.ev1.net/~wufdog/PT/.

Nuove funzioni generali:

• Il calcolo di ogni frame è ora più veloce, così lo scorrimento è piu dolce (solo con l'interpolatore bilineare).
• Con le precedenti versioni, quando si scorreva molto lentamente, i bordi dell'immagine si muovevano a scatti. Questo si notava in particolar modo con una finestra grande su un calcolatora veloce. Cona questa versione il movimento è più regolare.
• Con la Java VM version 1.4 or successive, ptviewer ora puo' lavorare usando l'accelerazione hardware. Il risultato, sui PC con Microsoft Windows, è ora veloce come con la VM Microsoft.
• E' stata modificato il parser interno per evitare l'errore di eccezione con l'uso del ";", spesso usato come separatore tra comandi multipli.
• Rik Littlefield (rj.littlefield su computer.org) ha riscritto il codice di caricamento delle immagini che adesso è molto più veloce, specialmente con jpg grandi. Come conseguenza il parametro "maxarray" non viene più usato da questa applet, se ancora specificato verrà ignorato.
• E' stato aggiunto il supporto per il formato speciale .PTV. Con questo formato è possibile caricare immagini molto grandi. L'applet carica sempre le parti dell'immagine nella direzione di rotazione corrente e carica più tardi le porzioni di immagine che sono "alle spalle". Il file .ptv può anche essere criptato in modo che non possa essere usato da un altro sito. Clicca qui per maggiori informazioni. E' disponibile un programma per la creazione dei file speciali scaricabile da qui. Eric Gerds ha creato uno script per Photoshop CS per la creazione dei file speciali .ptv che lavora anche con il Mac.
• Ora è possibile usa re il tasto "Y" oltre alla "Z" per effettuare lo zoom. Questa funzione è utile per certe tastiere internazionali.

Nuove funzioni (parametri aggiunti o corretti):

• Il parametro "quality" puo ora essere assegnato a 4 per attivare l'interpolatore Lanczos2. Vengono generate così immagini più nitide ma più lentamente, per cui questa fuonzione viene attivata solo quando l'immagine non è in movimento. Quando l'immagine è in movimento viene usata l'interpolazione bilineare. Questo valore adesso è di default. Il vantaggio di qualità dell'interpolatore Lanczos2 è più grande quando si ingrandisce l'immagine.

Parametri della toolbar :

• Nuovo parametro: "showToolbar" (default = false). Se impostato "true" ptviewer mostra una toolbar integrata con tre bottoni: zoom in, zoom out e commuta hotspots. La toolbar funge anche da indicatore del progresso di caricamento dell'immagine. Nel caso si carichi una immagine speciale .ptv viene mostrato anche il caricamento delle sezioni. Il bottone di commutazione hotspots cambia stato quando gli hotspot vengono attivati, cosi l'utente puo vedere se in quel momento gli hotspot sono attivi. Quando si muove il mouse sopra un hotspot la descrizione di quest'ultimo viene scritta nella toolbar. La toolbar viene mostrata prima degli hotspot statici per cui è possibile aggiungere hotspot statici che si sovrappongano alla toolbar permettendo di fatto di aumentarne le funzioni.
• Nuovo parametro: "toolbarDescr_x". Il valore puo esseere un numero intero da usarsi per cambiare la coordinata x dove la descrizione dell'hotspot viene visualizzata nella toolbar. E' utile se avete aggiunto nuovi bottoni a destra di quelli standard.
• Nuovo parametro: "toolbarDescr_color" per impostare il colore della descrizione dell'hotspot description nella toolbar. Il parametro deve essere impostato con un valore esadecimale come tutti gli altri parametri dei colori di PTViewer. Il colore predefinito è il nero. Questo valore viene sovrascritto dal parametro "c" nella definizione dell'hotspot, se presente.
• Nuovo parametro: "toolbarImage". Funziona solo se "showToolbar" viene impostato a "true" e viene usato per personalizzare la toolbar.. clicca qui per altre informazioni.
• Nuovo parametro: "imgLoadFeedback" (default = true). Se impostato "false" ptviewer non mostrerà la barra di caricamente dell'immagine. Il parametro è utile se si usa una propria barra di caricamento.
• Nuovo parametro: "toolbarBoldText" (default=false). Se settato "true" la descrizione degli hotpsot viene scritta in grassetto.

Parametri degli Hotspot:

• Nuovo parametro: "hsEnableVisibleOnly" (default = false). Se settato "true" gli hotspots saranno disabilitati se non visibili.
• Nuovo parametro: "hsShowDescrInStatusBar" (default = true). se impostato "false" l'applet non mostrerà le descrizioni degli ' hotspots' nella barra di stato del browser quando il moiuse ci si muove sopra.
• Nuovo parametro: "popup_panning" (default = false). Se impostato "true" l'hotspots comparirà sotto il cursore quando l'utente ruota il panorama con il mouse.

Parametri degli Hotspot statici:

• Nuovo parametro: "shsEnableVisibleOnly" (default = false). Se impostato "true" gli hotspot statici saranno disabilitati se non visibili.
• Robert Bisland (R.Bilsland presso Dial.pipex.com) ha aggiunto un nuovo comando Javascript chiamato "DrawSHSPopup()" e una nuova funzione che rende possibile che gli hotspot statici multipli vengano trascinati, nascosti e mostrati. DrawSHSImage(), DrawSHSPopup() and HideSHSImage() adesso permettono che piu di un hotspot statico venga cambiato in una singola chiamata. I comandi accettano dei gruppi (es. 1-4) o una sequenza (1,3,5,6) oppure una combinazione delle due (1-4,7,8).
• Robert ha anche aggiunto un nuovo parametro chiamato "shsStopAutoPanOnClick",(Default = true). Se impostato "false", cliccando su un hotspot statico non verrà fermata la rotazione automatica.
• Queste nuove funzioni permettono di creare menu dinamici per PTViewer senza bisogno di strumanti esterni.
• Gli hotspot statici adesso hanno nuove possibilità di impostazione: "y" e "b" possono ora assumere valori negativi. Se negativi vengono calcolati partendo dal basso della finestra del visore invece che dall'alto.
  Anche "x" e "a" possono essere negativi: in fal caso verranno calcolati a partire dalla destra della finestra anczichè dalla sinistra. "x" deve essere un numero positivo pui basso di "a".
  "y"deve essere un numero positivo pui basso di "b".

Mouse parameters

• Nuovo parametro:"mouseSensitivity", è un numero decimale (usare la virgola come separatore, default = 1). Se mouseSensitivity è minore di 1 la rotazione è più lenta se maggiore di uno la rotazione è più veloce.
• Nuovo parametro:"mouseQ6Threshold" usato solo se la qualità è 6. E' un numero decimale, default = 1. Se mouseQ6Threshold è maggiore di 1 occorre un più largo movimento del mouse per disattivare l'interpolazione bilinear, se mouseQ6Threshold è minore di 1 occorrer un più piccolo movimento per disattivare l'interpolazione bilineare.
• Nuovo parametro:"mousePanTime" usato per limitare la velocità massima di rotazione quando si trascina con li mouse. Funziona come "autoTime": è il tempo minimo (in secondi) per fare una rotazione a 360 gradi. Gli utenti inesperti tendono a trascinare troppo il mouse facendo ruotare l'immagine troppo veloce causando confusione: si possono usare valori decimali separati dal punto (".").

Altri parametri:

• Added new parameter "autoTime". It is used only if the parameter "auto" has been used to cause autorotation. The value of the "autoTime" parameter is the number of seconds needed to perform a full 360° rotation, so <param name="autoTime" value=120> will cause PTViewer to make a full rotation in two minutes. Of course if the computer is not fast enough PTViewer will not be able to rotate fast enough. This parameter can be used to make the viewer rotate at the same speed on every computer: on faster computers the CPU usage will be lower than 100%. The value must be an integer number, without decimals.
• Added a new function "startAutoPan( pan_inc, tilt_inc, zoom, autoTime )" that can be used to start autopanning with a given value for autoTime.
• Ercan Gigi (ercan.gigi at philips.com) added the "autoNumTurns" parameter which is used to limit the number of full 360 degree turns when auto-panning is on. You can use decimal numbers. The parameter is useful if you want to give only a short autopan preview.
• Tore Meyer (Tore.Meyer at gmx.de) added an optional parameter "autoTime" to moveTo() and moveFromTo().
  public void moveTo(double pan, double tilt, double fov, int nframes, double autoTime), 
  public void moveFromTo(double d, double d1, double d2, double d3, double d4, double d5, int i, double autoTime)
  The behaviour is identical to the original moveTo() & moveFromTo() Functions with the autoTime behaving just like the autoTime parameter introduced in version 2.7L2.
• Added new parameter "outOfMemoryURL": it is the address of a page to be opened in case of out of memory error while loading the panoramic image.
• Added new parameter "horizonPosition" (integer, no decimals) to specify the position of the horizon if it is not in the middle of the pano image. Without this parameter PTViewer would show a curved horizon. The parameter is a % value of the image height, measured from the top. The default value is 50 and the horizon is considered to be in the middle of the image. If the value is less than 50 the horizon is nearer to the top of the image, if it is greater than 50 the horizon is nearer to the bottom of the image. For example, if you have a pano 1150 pixels high and the horizon is 430 pixels from the top then the parameter value is 430/1150*100 = 37.
• Pressing "o" will interactively decrease the value of the horizonPosition parameter with feedback in the status bar, pressing "O" will increase it. This is useful to quickly find the correct value for the parameter. Hotspots position will not be updated since it would require more work and this feature is not intended for production use.
• Added parameter "authoringMode" (default = false). If set to true it will enable authoring features that could have unexpected results for end users. At the moment it will only enable the "o" key (see above).
• Added parameter "statusMessage": it can be used to specify a fixed text to be written in the status bar. The text is written every time the user drags the mouse or presses an arrow key. This parameter does not work with Firefox (for security reasons).
• Changed: now the "tiltmax" parameter accepts negative values and the "tiltmin" parameter
  accepts positive ones.
• Added two public methods: getPanoIsLoaded() and getFilename(). You can call them from Javascript like you do with newPanoFromList(), for example. getPanoIsLoaded() returns a boolean value: true if the pano has already been loaded, false otherwise. getFilename() return a string: the file name of the current pano.

• Aggiunto un nuovo parametro "imgLoadFeedback" (predefinito=true). Se impostato "false" ptviewer non mostra la barra di progresso del caricamento dell'immagine.
• Aggiunto un nuovo parametro "autoTime". Si usa solo se "auto" viene usato per avviare la rotazione automatica. Il valore di "autoTime" è il numero di secondi necessari a effettuare la rotazione di 360° . <param name="autoTime" value=120> produrra' una rotazione completa in 2 minuti. naturalmente se il PC non sarà veloce a sufficienza il tempo di rotazione aumenterà. Questo parametro puo' essere usato per far ruotare l'immagine alla stessa velocità su tutti i computer. Il valore deve essere un intero, senza decimali.
• Aggiunta una nuova funzione "startAutoPan( pan_inc, tilt_inc, zoom, autoTime )" che puo' essere usata per avviare la rotazione automatica con un valore prefissato di "autotime"

Correzioni:

• Il mouse non si trasforma in "hand" quando si è sopra un hotspot usando la VM di Sun.
• premendo la barra spaziatrice non si attivano gli hotspot se si sta trascinando l'immagine.
• Se l'immagine panoramica non è pienamente sferica, ovvero se l'angolo d'inclinazione non va da -90° to + 90°, gli hotspots sono ancora mostrati con un valore y sbagliato.
• Modificati comandi gotoView() e moveTo(): ora se il campo di vista verticale è troppo largo per il panorama corrente, viene automaticamente ridotto. nelle versioni precedenti non si poteva cambiare la direzione di vista.
• Se il parametro tilt richiede una direzione di vista impossibile ora viene impostato al massimo o al minimo.

• Aggiunto un nuovo parametro: "dynLoadROIs" (default = false). Se settato a "true" ptviewer carica la foto panoramica dinamicamente, sezionandola in regioni di interesse (ROI) e caricandole a seconda del senso di rotazione. Il parametro "roi" è stato modificato. Clicca qui per maggiori informazioni. Clicca qui per scaricare un programma che genera immagini ROI automaticamente.
• Aggiunto un nuovo parametro "showToolbar" (default = false). Se settato "true" ptviewer mostra una toolbar integrata con tre bottoni. zoom +, zoom - e hotspot. La barra funziona anche come indicatore di caricamento: Vedi questo esempio di dynLoadROIs. Il bottone Hotspot cambia aspetto se premuto, cosi l'tente può vedere se gli hotspot sono attivi. Quando ci si muove sull'hotspot si vede il testo anche nella barra. La toolbar viene visualizzata prima degi hotspot statici così è possibile settare altri hotspot statici sopra la barra stessa per aggiungere altre funzioni.