There are FAQs available in following languages :
English FAQ
Danish FAQ
Norwegian FAQ
Portuguese FAQ
Dutch FAQ
French FAQ
Spanish FAQ

Custom CD Menu 1.07 (per W95/W98/NT)

Creato da Smart Projects
Questo programma, piccolo e curato, è "FREE" e può essere distribuito liberamente.
Assicuratevi che nessuno modifichi alcunchè in questo programma.

Quando create un CD e vi mettete una gran varietà di programmi e file, avete
spesso bisogno di un facile mezzo per installare o disimpaccare i dati dal CD all'HD
(o su altri supporti come dischetti, drive Jaz etc..).
Custom CD menu permette di fare esattamente questo!

Il programma interpreta un file di testo chiamato CD.PET (ma può essere chiamato anche
diversamente) che deve essere posto nella stessa directory dove si trova "Custom CD Menu"
oppure in un sottomenu "menu" (come è stato fatto nell'esempio incluso).

Prima di iniziare sappiate che:
-Il file .PET contiene degli specificatorii che faranno da driver al vostro menu.
-Questi specificatori sono costituiti da verbi fissi che sono insensibili a maiuscole/minuscole
e che devono essere sempre seguiti dal segno "=" senza spazi bianchi (file= Media=...)
-Al segno "=" può seguire opzionalmente un parametro che è sempre compreso tra
"<*" e "*>". Questo parametro determina ulteriori azioni da compiere sull'argomento
del verbo specificato.
-Possono seguire opzionalmente delle Wildcard (vedi più avanti) che hanno la caratteristica
di essere comprese tra "<<" e ">>"
-Segue quindi l'argomento che indica la posizione relativa o specifica del file da elaborare.
-I path sono relativi alla root del supporto (p.es. quando un applicazione è in
d:\games\game1\Install.exe, si può usare games\game1\Install.exe)
-Quando si decide di usare un path assoluto (per esempio per copiare qualcosa su A:)
lo si può fare
-Certo che il path relativo sarà quello più usato in quanto non è possibile sapere quale
lettere ha assegnata il CD-Rom del vostro utilizzatore.

COSA CONTIENE IL FILE CD.PET

Specificatorii del primo blocco (uno solo)
---------------------------------------

CDTitle=    Testo
        mettere qui un testo che darà il titolo al menu

Defaultpicture=    path e nomefile relativo della picture da usare per default.
        Formati accettati:    bmp, ico, wmf, emf, jpg, jif, gif, dib, rle, tga, pcx.
        NOTA: Leggere la parte relativa al display delle immagini; è possibile
        includere le .dll per qualche formato immagine.
        Se il file non esiste, o è corrotto o non viene dichiarato
        il parametro, il sistema prende l'immagine di default.

DefaultMedia=    path e nomefile relativo del file multimediale da usare per default.
        E' la locazione del file che si vuole aprire o eseguire (p.Es. picture\ecdm.bmp)
        Se il file non esiste, o è corrotto o non viene dichiarato
        il parametro, il sistema prende quello di default.
        Leggere le spiegazioni per Media= (qui sotto) per sapere come usarlo.

Display=    biub
        La riga è opzionale.
        Questa riga altera i settaggi delle descrizioni contenute nella finestra
        di sinistra del Menu che di default sono Bold&Black.
        Se mettete la riga, deve avere 4 caratteri per argomentii.
        I 4 caratteri devono essere tutti presenti, altrimenti la riga
        verrà ignorata. Il significato dei 4 caratteri è il seguente:
        il primo indica il settaggio del Bold (0/1 o b),
        il secondo indica l'italico (0/1,i),
        il terzo indica il sottolineato (0/1,u),
        il quarto indica il colore con i seguenti codici:
            b = Nero
            g = Verde
            n = Azzurro
            p = Porpora
            t = Teal
            r = Rosso
            s = Blue
            f = Fucsia
            w = Bianco
            a = Aqua

Specificatori dei blocchi successivi
------------------------------------
Questi blocchi possono essere al massimo 1500 (1500 parametri "File=").
Devono essere specificati per ogni applicazione/gioco/directory.
Se usate molti blocchi il tempo di interpretazione del file CD.PET potrebbe
essere molto lungo. Potrete allora usare lo SpeedFile. Leggere in proposito
SpeedFile.txt

Title=        Testo
        Titolo che si vuole compaia nella listbox. Non esagerare con la
        lunghezza in quanto deve entrare nella finestra della lista.

File=        path e nomefile.
        Posizione del file che si vuole eseguire. Se non è un exe, viene
        lanciato il programma associato dall'utente per la sua apertura,
        semprechè tale programma sia presente sul PC dell'utente.
        Un .zip lancerà winzip, un .html lancerà internet explorer, ecc.
        Dopo il segno "=", si possono inserire:
        <*dos*> che in genere si usa con un file .zip quando non si è certi
            che l'utente abbia winzip. In questo caso sarebbe bene inserire
            nella dir del file, pkunzip.exe oppure arj.exe o rar.exe.
            Attenzione che in questo caso non sono considerati i nomi lunghi
        <*zip*> si usa con unzdll.dll. Vi consigliamo di usare Winzip 6.3 per avere
            degli zip autoestraenti (.exe); in questo caso non va usato il <*dos*>
            Se usate <*zip*> vuol dire che non siete certi che l'utente abbia
            winzip 32 bit. Dovete allora porre unzdll.dll nella dir del menu.
            Se non usate <*zip*> non serve inserire questa dll.
            Con questa opzione si può usare <*suggest*> e <*to*>.
        <*directory*> permette all'utente di copiare il contenuto della directory
            in una da lui scelta quando preme il tasto di Install
            P.es. file=<*directory*>pictures\sport
            Può essere comodo quando si vuol copiare un'intera directory di immagini
            dal CD all'HD.
            Con questa opzione si può usare <*suggest*> e <*to*>: sono opzioni
            utilizzabili solo con <*copy*>, <*directory*> o <*zip*> che sono
            processati sotto il controllo del menu.
            <*suggest*> è seguito dal pathname relativo (si possono usare
                wildcard). Vi suggeriamo di usare il nome del path
                su cui copiare o decomprimere.
            <*to*>      è seguito dal pathname relativo (si possono usare
                wildcard). Vi suggeriamo di usare il nome del path
                su cui copiare o decomprimere quando l'utente non
                deve avere possibilità di scelta del path.
                P.Es. file=<*zip*> test.zip <*suggest*> applicationpath
                    file=<*copy*> test.doc <*to*> documents
        <*copy*>lavora come <*directory*> ma per copiare un singolo file.
            Questi due parametri possono essere usati allo stesso modo ma
            ricordate di usare il path del file quando volete copiare un
            singolo file e il path della directory (non il nome del file)
            quando volete copiare una directory.
        <*run*>    posizione del file da eseguire. P.es file=<*run*>apps\mod\patch.exe
        <*open*>posizione del file da aprire. P.es file=<*open*>apps\mod\readme.txt
        <*install*>posizione del file da eseguire. P.es file=<*install*>apps\prog.exe
        Queste ultime 3 opzioni sono esattamente identiche tra loro e hanno il solo
        scopo di capire meglio cosa si sta facendo con quel file e facilitare la
        lettura del file .PET. Non usando alcuna opzione il file verrà sempre eseguito.
        <*cmd*>    Non è mai controllato. Se deve essere un path, usarne uno assoluto.
        <*cmn*>    Considera che debba seguirgli un pathname assoluto o relativo.
        Sono permesse le wildcard.

Picture=    path e nomefile
        Posizione dell'immagine. Si possono usare anche più righe Picture=
        Se l'immagine non esiste viene caricata quella di default.
        Si può usare Picture=<*none*> per evitare il caricamento di questa.
        I migliori risultati si ottengono com immagini bmp 234x173, comunque
        qualunque altra dimensione viene accettata.
        Fin dalla versione 1.5 è possibile includere più parametri picture=
        (fino a 9). Se includete il file NViewLib.dll nella stessa directory
        da cui viene eseguito CDmenu, vengono supportati anche i seguenti formati:
        bmp, ico, emf, jpg, jif, gif, dib, rle, tga, pcx.
        Le immagini possono avere qualunque estensione in quanto i relativi file
        vengono automaticamente riconosciuti. Fanno eccezione i wmf, ico, emf, pcx e
        tga per i quali è obbligatoria la relativa estensione. Se l'immagine
        non è un file immagine o ha un formato errato, verrà segnalato un messaggio
        di errore che CDmenu non può controllare in quanto usa librerie di terze parti.
        Sono permesse le wildcard

Seq=        path e nomefile
        Posizione del secondo file che si vuole eseguire appena terminata
        l'esecuzione di quello dichiarato in file=.
        Il vantaggio è quello per esempio di unzippare su una directory
        e poi eseguire l'installazione dal file unzippato.
        Ci possono essere almassimo 9 seq= e devono contenere
        <*copy*>, <*directory*> o <*zip*>. Stesse possibilità di file=

Cdsize=        Testo
        Qui si possono scrivere le dimensioni dell'applicazione.
        Vi si può scrivere anche un URL mettendo dopo il segno "=" il parametro <*html*>.
        Questo visualizzerà il testo come un iperlink e cliccandoci sopra verrà eseguito
        il browser dell'utente che si collegherà all'URL richiesto.
        Nello stesso modo può essere eseguita anche una pagina HTML locale.

HDsize=        Testo
        Qui è possibile scrivere quanto occupa l'applicazione su HD una volta installata.
        Ha le stesse possibilità di HDsize. P.Es. Hdsize=<*info*> Spazio occupato: 53Mb
                HDsize=<*html*> http://www.myurl.com

Extra=        Testo oppure <*begin*>
        Inserire un testo breve che in genere riporta numero di serie o altra
        piccola nota. Può contenere le opzioni <*begin*> ed <*end*> tra cui
        mettere più righe. Non scrivere sulla riga dell'opzione.
        Questo testo verrà visualizzato nella finestra in basso a destra del menu.
        P.Es. Extra=<*begin*>
        Questa è la riga 1 del testo
        segue la riga 2.....
        termino con riga 3.......
        <*end*>
        Tutti i testi subiranno il parsing fino al parametro <*end*>
        I testi sulla stessa riga di <*begin*> ed <*end*> sono ignorati quindi
        potete sciverci vostri commenti.

Media=        path e nomefile
        Posizione del media da eseguire. I riconosciuti sono .wav, .mid e .avi
        e se il sistema usa Windows media player, anche i .mpg, .mpeg, .mov.
        Possono essere inserite dopo il segno "=", altre informazioni:
        <*play*> suona al momento che viene aperto
        <*loop*> deve essere attivato e fermato manualmente
        <*pllo*> viene suonato e continua finchè non viene fermato
        Il media file viene sospeso ogni volta che si esegue un unzip o una
        copia di file, e viene ripreso al termine dell'operazione.
        P.Es.: Media=<*play*> Video\demo.avi
        L'utilizzo eccessivo di Media= in ogni sezione potrebbe appesantire CDmenu.
        Sono permesse le wildcard.

Text=        path e nomefile
        Posizione del file che contiene il testo di spiegazioni da visualizzare.
        Se manca questo parametro non compare il bottone per visualizzare il testo.
        Se il file è corrotto o mancate viene avvertito l'utente.
        Se il file è un file binario, si vedranno caratteri strani alla sua apertura.
        Il testo aperto e visualizzato può essere alterato solo in visualizzazione
        ma non nel contenuto.
        Il testo può essere stampato, salvato ed editato con un editor dell'utente
        tramite un file temporaneo salvato nella dir temp.
        <*extra*>copia il contenuto di un extra field nel full-text field così
            non è necessario includere qui un file-pass

Wildcards
-------------
<<w>> Windows directory dove l'utente ha installato window (p.es. c:\windows)
<<s>> System directory dell'utente (p.es. c:\windows\system)
<<d>> Desktop dell'utente (p.es. c:\windows\desktop)
<<i>> Favorites directory dell'utente (p.es. c:\windows\favorites) (per copiarci URLs)
<<m>> Start menu dell'utente
<<f>> Directory utente che contiene i font (per copiarci i font)
<<r>> Root dir dell'HD dell'utente (dove Windows è installato)
<<c>> Root dir del drive da cui CDmenu sta girando (p.es. d:\)
<<a>> Directory da cui CDmenu sta girando
<<l>> Il ptrcrdente path dalla sequenza (p.es. dove avete appena copiato o unzippato)
<<t>> Temporary directory dell'utente (generata da set tmp= o set temp= nell'autoexec.bat)
oppure la temp di Windows (p.es. c:\windows\temp)

Queste wilcard sono considerate:
    - Una sola per pathname.
    - Devono essere il primo carattere del pathname
    - Solo quando à usato un path non assoluto

NON USARE :
    c:\<<w>> : errato perchè non è il primo carattere.
    <<w>>c:\ : corrisponde a: C:\windows\C:\ e non funziona
    <<w>><<w>> : corrisponde a: C:\windows\<<w>> e non funziona

NOTA IMPORTANTE
---------------
TUTTI GLI SPECIFICATORI CHE IL PROGRAMMA DEVE INTERPRETARE DEVONO ESSERE SCRITTI IN UN'UNICA
PAROLA ESSERE SEGUITI SEMPRE DAL SEGNO "=" E MESSI COME PRIMO CARATTERE IN UNA NUOVA RIGA.
GLI SPAZI BIANCHI SARANNO TOLTI AUTOMATICAMENTE.

QUESTE RIGHE VANNO BENE:
------------------------
file=path
file= <*directory*> path
cdsize= 50 MB
picture=path


QUESTE RIGHE NON VANNO BENE:
----------------------------
file =path
_file= <*directory*> path
// cdsize= 50 MB
    picture = path


ESEMPIO DI UN FILE CD.PET
-------------------------

CDTitle=Temporary<---------------------------------------Titolo riportato nella finestra di CDM
DefaultPicture=cdmenu\cdmenu.jpg<------------------------Picture di default
========================================<----------------Separatore: non viene processato
Title=FIX-it Utility 99<---------------------------------Titolo riportato nella lista programmi
File=FIXit99\fixit99.exe<--------------------------------Locazione dell'eseguibile
Text=FIXit99\README.TXT<---------------------------------File testo per more informations
Hdsize=<*html*>http://www.mijenix.com<-------------------URL di collegamento
Cdsize=Spazio occupato:12.73M<---------------------------Dimensione dell'eseguibile sul CD
Extra=<*begin*><-----------------------------------------Inizio descrizione breve
Utlilities per mantenere, operare, controllare        |
ed ottimizzare il personal computer.              |
Gira sotto Windows 95/98 or Windows NT.             |
Pulisce ed ottimizza l'HD, i system file,         |descrizione
trova ed elimina virus, crea fd di emergenza,         |libera che verrà visualizzata
Controlla e corregge per l'anno 2000,             |nel menu alla selezione del
monitorizza il sistema e le sue risorse             |titolo nella lista
ripristina file cancellati, avverte per anomalie    |
<*end*><-------------------------------------------------Fine descrizione breve


Parametri riga di comando per il lancio di CDmenu
-------------------------------------------------
Quando dovrete eseguire Custom CD menu il programma da lanciare è CD_MENU.exe;
questo può contenere i seguenti argomenti:

CD_MENU.EXE -create -pet:pathrelativo contenente petfile alternativo

-create    Vengono aggiunti 3 bottoni extra:
    REFRESH        attivata anche da F5, permette di usare il .pet appena modificato
    OPEN        permette di aprire un .PET alternativo (anche.txt)
    SPEEDFILE    crea uno speedfile (Petfilename.bin)

-pet:    P.Es. -pet:menu\content.dat Questa opzione può essere specificata anche
    nell'autorun.inf e serve per leggere un file pet alternativo.


Il file AUTOEXEC.INF contiene le seguenti righe:

[autorun]
open=CD_menu.exe
icon=icon.ico

Autorun lavora solo con 'Auto Insert Notification' attivato

Si possono estendere le funzionalità dell'autorun.inf con:
    shell=Install
    shell\Install=&Run CD Menu
    shell\Install\command=CD_menu.exe
Questo visualizzerà:
Run CD Menu in bold premendo il bottone destro del mouse sulla lettera del drive

Consigli per creare il PET file
-------------------------------
-Usare un normale editor di testo.
Se non volete che i file *.pet non vengano automaticamente associati al vostro editor, anche
se questo non creerebbe alcun problema, salvare il file come .TXT e rinominarlo poi .PET
Ricordatevi di rinominarlo ancora .TXT se volete rieditarlo.
Potete comunque leggere un .TXT al lancio di CDmenu usando l'opzione "-create" ed usare
poi il bottone di load.
-Create le directory che saranno poi registrate sul CD, nella root del vostro HD dove
trasferirete i programmi da gestire.
Un buon metodo è quello di creare una partizione separata per il vostro CD test, oppure
utilizzare un drive Jaz o Zip, oppure creare un disco virtuale
P.Es. creare una directory "CDPROJECT" dove riporterete la copia del vostro CD:
    aprire una finestra DOS e creare il disco virtuale in questo modo
        Subst P: c:\CDPROJ~1
    Questo comando sostituisce la directory con P:\ drive.
-Potete mettere Custom CD Menu insieme al CD.PET ed eventualmente anche UnzDll.DLL,
NViewLib.dll, Pkunzip, arj, unrar, in una directory
-Testate il file .PET eseguendo Custom CD menu che vi farà capire come il vostro menu funziona.
Se qualcosa non va, rieditate il pet file e premete quindi F5 per fare in modo che CD menu
ne rilegga la nuova versione salvata del pet file.
-Quando tutto sarà OK potete creare il vostro CD. Si consiglia di mettere il CD menu, il
file .PET e le .dll che vi servono, nella root del CD.

==============================================================

Correzioni apportate dalla 0.99 (versione di test) alla 1.0 (versione finale)
----------------------------------------------------------------------------
-Immagini, .arj, .zip e .rar (quando viene usato <*dos*>)adesso possono essere scritti
indifferentemente in maiuscolo/minuscolo ed entrambi (P.Es, test.zIP)
-Alcuni messaggi di errore Windows sono stati eliminati
-<*dos*> file.arj ora viene estratto correttamente

Correzioni dalla 1.0 alla 1.01
----------------------------------------------------------------------------
-Lo spazio libero segnalato (quando una directory viene copiata o un file compresso deve
essere decompresso)non era esatto sotto Win95 OSR2 con fat32 o disco più grande di 2Gb.
Adesso lo spazio libero è segnalato correttamente

Correzioni dalla 1.01 alla 1.02
-----------------------------------------------------------------------------
-In qualche raro caso ci sono dei problemi quando una directory appena creata viene
cancellata mentre il programma stà girando. Il programma non risponde bene a questa
situazione per un problema insito nel Borland C++. Aggirando tale problema l'errore
è stato corretto.

Correzioni dalla 1.02 alla 1.03
-----------------------------------------------------------------------------
-Risolto il problema sulla versione 1.02 che non copiava/installava/disimpaccava usando
Win95 OSR2 e lo spazio su HD era oltre 2Gb.

Correzioni dalla 1.03 alla 1.04
------------------------------------------------------------------------------
-Il programma non aveva un buon aspetto quando venuva usato un "Large Font". Adesso il
suo aspetto è piacevole usando qualunque settaggio (96 dpi, 120 dpi..)

Correzioni dalla 1.04 alla 1.05
------------------------------------------------------------------------------
-Nessun problema segnalato

Correzioni dalla 1.05 alla 1.06
------------------------------------------------------------------------------
-Se non vengono pecificati campi "Extra=", la finestra Extra non viene pulita
-In rari casi, se non viene usato <*end*> alla fine del file CD.PET, il programma si blocca
-Se vengono eseguite altre selezioni durante un unzip a 32 bit. il display di status
non viene aggiornato correttamente

Correzioni dalla 1.06 alla 1.07
------------------------------------------------------------------------------
-Corretto un piccolo errore con i parametri della linea di comando se eseguita 2 volte
nella stessa riga.

==============================================================

Problemi conosciuti
-------------------

Nessuno

==============================================================

Aggiunte dalla 1.0 alla 1.01
----------------------------
-Quando non esiste un'immagine utente e nemmeno una defaultpicture, il programma visualizza
comunque la sua defaultpicture
-La rouine di visualizzazione immagini è stata riscritta per gestire anche i jpg

Aggiunte dalla 1.02 alla 1.03
-----------------------------
-Complazione eseguita con nuovo compilatore a 32 bit
-Correti gli errori sullo spazio libero dell'HD

Aggiunte dalla 1.03 alla 1.04
-----------------------------
-Il menu non può essere massimizzato (non è molto bello!)
-Il menu si adatta correttamente su video a diverse risoluzioni
-Ora il menu può visualizzare jpg, jif, gif, dib, rle, tga, pcx
-Alcuni di questi formati non richiedono sia dichiarata la loro estensione, è
così possibile mascherare il file d'origine

Aggiunte dalla 1.04 alla 1.05
-----------------------------
-Aggiunti i parametri sulla linea di comando che usano <*cmd*>
-Aggiunta la possibilità di selezionare fino a 9 immagini

Aggiunte dalla 1.05 alla 1.06
-----------------------------
-Ora è possibile eseguire file wav, avi, mid, mpg
-Questi file partono automaticamente, vanno in loop, ogni selezione può contenere il suo link
-Possibilità di specificare <*none*> per un'immagine
-Corrette altre piccole cose

Aggiunte dalla 1.06 alla 1.07
-----------------------------
BETA1
-L'unzipping, usando la funzionalità del 32 bit unzip, può essere interrotto
-Attivata una facile interfacia per lanciare i propri documenti html (in linea)
-Col doppio click o con l'enter si lancia la sequenza desiderata (esecuzione programma)
BETA2
-Aggiunto a file= il parametro <*open*> che essenzialmente ha la stessa funzionalità di
<*run*> ma è segnalato differentemente nella status bar
-Custom CD menu (CCDM) è sato leggermente modificato
-Il bottone dell'help text del RUN-STATUS sulla StatusBar è diverso a seconda dei parametri
usati in file=
-L'utente può settare le opzioni di abilitazione e disabilitazione sui Media e sulle Pictures.
Questo è comodo su vecchi sistemi o su CD-Rom molto lenti
-Per ogni entrata text= può essere specificato un file di testo con dati extra
'text=pathrelativo'
Questi dati possono essere salvati su HD (o altro)
Questi dati possono essere stampati direttamente (print support CCDM)
BETA3
-Attivata la sequenza di comandi tramite il parametro seq=
-Definizione delle wildcard e loro utilizzo nei pathname
-Uso di <*suggest*> e <*to*> per poter scegliere la destinazione
-Migliorata la funzionalità dell'UnZip in modo evidente
    Basato sul nuovo Unzdll.dll !!!
    Asicuratevi di usare quest'ultima versione (1.5.2)
-I file cd.pet, Unzdll.dll e NViewLib.dll posono essere messi nella subdir "menu"
    Prima viene cercata la dir "menu", poi la exe dir (nel caso del CD.PET).
    Nel caso del .dll, il path windows viene cercato dopo "menu"
-Il file CD.PET è permesso molto grande, anche di megabite
-Il limite dei file= è sato fissato a 1500
-Velocizzata la decodifica del file .PET
-Resa disponibile l'opzione di SpeedFile per aumentare tale decodifica da 10 a 100 volte!!
    usare con attenzione e leggere prima SpeedFile.txt!!
-Migliorata la Text= con il nuovo bottone per il suo lancio in un editor
-Migliorata la sequenza dei comandi, fino a 9 azioni extra per ogni selezione

Finale 1.07 (tutti i miglioramenti detti sopra)

==============================================================

Questo programma è testato e lavora correttamente.
Se qualcuno avesse dei problemi mi scriva pure e cercherò di risolverli.

Le versioni future prevedono nuove funzioni come:
- Memorozzazione immediata del testo in ClipBoard
- Utilizzo di linguette diverse (tabs)
- Ridimemsionamento delle finestre
- Utilizzo di un .INI file per ridimensionamenti e personalizzazioni
- Funzionalità Unrar e UnAce 32 bit ma con bassa priorità finchè la funzionalità
di UnZip sarà presente
-Creazione di un Custom CD Menu CREATOR (Insieme con CCDM v 2.0)

Buon divertimento!
Saluti da
Smart Projects

==============================================================

Custom CD Menu,
Programma formalmente conosciuto come "Easy CD Menu":
-----------------------------------------------------------------------------------------------
Siamo sorpresi che voi non conosciate la nostra linea di prodotti "Easy CD" e che voi
continuiate ad usare questo nome. A riguardo vi avvertiamo che questo è un marchio
della Adaptec e protetto legalmente e vigorosamente da noi. Vi preghiamo di smettere
immediatamente di usare il nome "Easy CD" e di cancellare qualunque scritto o messaggio
che a questo si riferisca.
Grazie per la vostra pronta attenzione su questa importante materia.

Dave Ulmer
Adaptec Software Products
------------------------------------------------------------------------------------------------