Al crear un CD (grabar programas y/o archivos en un CD) a menudo se hace necesario disponer de un modo simple de copiar, instalar o descomprimir datos a HD (o cualquier otro medio).

¡Eso es exactamente lo que le ofrece este programa!

El programa interpreta un archivo de texto llamado usualmente ‘cd.pet’ (aunque no necesariamente), que deberá estar colocado en el mismo directorio del programa, o en el subdirectorio 'menu' (se incluye un ejemplo)

Dos observaciones antes de comenzar:

- El programa no distingue mayúsculas de minúsculas (lo cual facilita las cosas al usuario).

- Los nombres de camino son relativos a la raíz del medio. (por ej. Cuando una aplicación está localizada en el directorio d:\games\game1\Install.exe debe usar: games\game1\Install.exe). Cuando indique un camino absoluto, se usará éste (por ej. Cuando desee que se copie algo desde la unidad a:).

En la mayoría de casos necesitará usar el camino relativo, ya que no sabrá de antemano cuál es la letra de la unidad de CD ROM del usuario.

Para hacer las cosas aún más interesantes, se pueden usar varios parámetros (especificados más adelante).

CDTitle= Cualquier texto que desee
Este texto será colocado en la barra de título de la ventana (la barra azul encima de la aplicación).
¡Sólo será usada la primera ocurrencia de esta opción que se halle en cd.pet!

defaultpicture= camino relativo
Camino relativo es la localización de la imagen que quiere usar (ej.: pictures\ccdm.bmp)
¡Sólo será usada la primera ocurrencia de esta opción en cd.pet!
Se pueden usar los siguientes formatos de imagen: bmp, ico, wmf, emf, jpg, jif, gif, dib, rle, tga, pcx.
Si no se especificara ninguna imagen por defecto (o si la especificada estuviera corrompida o no existiera), la imagem por defecto del programa será mostrada (en el caso de que ninguna imagen estuviera disponible para la selección (vea más abajo))

defaultmedia= camino relativo
Camino relativo es la localización del archivo de multimedia que será abierto/ejecutado (por.ej. pictures\ecdm.bmp)
¡Sólo será usada la primera ocurrencia de esta opción en cd.pet!
Si no hubiera una media especificada para una determinada selección, la media por defecto será abierta/ejecutada.
Lea la explicación sobre "media=" (abajo) sobre cómo utilizar la opción.

display= biub
Esta línea es opcional.

Esta línea altera la forma en que se muestra el texto en la ventana de items a la izquierda del menú.
En caso de no encontrarse esta línea, por defecto se muestra en color negro en negrita.
Si se incluye, el comando DEBE tener 4 caracteres (o la línea será ignorada).

El primer caracter activa la NEGRITA. Coloque "b" o "1". (si no desea negrita, use cualquier otro caracter, por ej. "0"). El segundo caracter activa la IT-LICA (CURSIVA). Coloque "i" o "1". (si no desea itálica, use cualquier otro caracter, por ej. "0"). El tercer caracter activa el SUBRAYADO. Coloque "u" o "1". (si no desea subrayado, use cualquier otro caracter, por ej. "0"). El cuarto caracter ajusta el color de la letra:

b = Negro (Black)

g = Verde (Green)

n = Azul Obscuro (Navy)

p = Púrpura (Purple)

t = Verde Intenso (Teal)

r = Rojo (Red)

s = Azul (Blue)

f = Fúcsia (Fuchsia)

w = Blanco (White)

a = Agua (Aqua)

¡¡ El archivo cd.pet puede contener hasta 1500 entradas 'file=' !!

Uselas con cuidado, ya que la decodificación puede tardar MUCHO tiempo en caso de excesivas entradas. En caso de largos tiempos de decodificación, lea el archivo SpeedFile.txt (se acompaña al final del documento).

El bloque siguiente debe ser especificado para cada aplicación / juego / directorio.

"Title=" es el único comando obligatorio por selección (aunque no tenga mucha utilidad).

Title= título que aparecerá en la lista (ej.: Game1) (No muy largo, para que quepa en la ventana (pruebe))

File= localización relativa del archivo a ser ejecutado (excepciones explicadas más adelante) El archivo puede ser un ejecutable (ex. install.exe) pero también cualquier tipo de archivo para el que el usuario tenga software para abrirlo. Por ejemplo, si el archivo es help.html, el naveagdor por defecto del usuário abrirá automáticamente el archivo html. Otro exemplo : cuando el archivo fuese del tipo .zip, el Winzip arrancará si (y solamente SI) el winzip estuviera instalado en el sistema. Se permiten parámetros de línea de comandos bajo ciertas condiciones (vea más adelante la sintaxis). Se permiten comodines en el camino (vea más adelante).

Parámetros adicionales:

File=<*DOS*> camino relativo al archivo a descomprimir (ej.: <*DOS*>apps\app1.zip)

NOTA: El uso del parámetro <*zip*> es más recomendable cuando el archivo es del tipo .zip, ya que el <*zip*> ofrece soporte para 32 bits.
En caso de no tener la certeza de si el sistema es capaz de descompactar archivos del tipo .zip, .arj o .rar, se puede especificar la opción <*DOS*> antes del nombre del camino.
Para que esta opción funcione es necesario disponer de los programas correspondientes: pkunzip.exe y/o arj.exe y/o rar.exe y deben ser colocados en el mismo directorio que la aplicación a ser descompactada. Si estos ejecutables están presentes, el menu descomprimirá los archivos especificados cuando se le pida.
Un efecto colateral desagradable: si los archivos tuvieran nombres largos serán truncados, porque se está usando descompresores del DOS. Por ej.:, en caso de que se descompacten archivos con nombres largos, y existan archivos con los primeros caracteres iguales, cada archivo será sobrescrito por el subsiguiente. A partir de la versión 1.02 del CCDM, la descompresión de 32 bits está disponible, use entonces la opción <*zip*>.
NOTA: Use el winzip (6.3 en adelante) para crear archivos autodescomprimibles (convirtiéndolos en .exe). En ese caso, NO use la opción <*dos*>.

File=<*directory*> camino relativo de un directorio (ej.: <*directory*> apps\app1)
Este directorio puede contener archivos y/o otros directorios.
Al pulsar el botón install, la interface de usuario ofrece la opción de copiar todo el directorio a una localización en el HD (u otra localización cualquiera).
Esta opción puede ser útil por ej., si quiere copiar un directorio con imágenes a otra localización.
És posible usar las funciones <*suggest*> o <*to*>

File=<*copy*> camino relativo para un archivo
Esta opción hace exactamente lo mismo que <*directory*>, pero se aplica solamente a un archivo por vez, en vez de un directorio.
También está permitido usar las funciones <*suggest*> o <*to*>

File=<*zip*> camino relativo de un archivo .zip a ser descomprimido (ej.: game1.zip)
IMPORTANTE: el archivo unzdll.dll debe encontrarse en el mismo directorio que cd_menu.exe o en el subdirectorio menu (por defecto el programa busca las .dll en el subdirectorio ‘menu’, en los directorios de sistema de windows y después en el directorio en que cd_menu se localiza. Este archivo sólo es necesario para la descompresión de 32 bits, por tanto, si no se utiliza el comando <*zip*> no será necesario incluir la dll en el CD.
Este comando permite la descompresión automática de un archivo .zip especificado.
Como ya se dijo antes, esta es una dll de 32 bits, por lo que características de win95 como nombres largos de archivo y otras están disponibles.
En caso de descompresión de archivos, es mejor usar esta opción que la opción <*dos*>, la cual continúa disponible solamente a efectos de compatibilidad con menús hechos anteriormente, en las versiones 1.0 y 1.01.
Agradecimientos a Eric W. Engler & Chris Vleghert por el código de 32 bits para descompresión.
Con esta opción, se puede usar <*suggest*> o <*to*>

<*suggest*> o <*to*> : funciones permitidas en los casos reseñados (<*copy*>, <*directory*> or <*zip*>)

Sintaxis:
<*suggest*> camino relativo (comodines permitidos, se aplican las reglas de nombre de camino)
Sugiere un directorio para copiar o descomprimirr lo(s) archivo(s).
<*to*> camino relativo
Sugiere un directorio para copiar o descomprimir, pero sin posibilidad de escoger (a no ser que el usuario pulse en ‘NO’.
Ej.:
file= <*zip*> test.zip <*suggest*>camino de la aplicación
file= <*copy*> text.doc <*to*> documentos

File=<*run*> camino relativo de un archivo a ser ejecutado (por ej.: patch.exe)

o

File=<*open*> camino relativo de un archivo a ser abierto (por ej.: readme.txt)

o

File=<*install*> camino relativo de un archivo a ser ejecutado (por ej.: install.exe)
Estos tres parámetros hacen exactamente lo mismo y, en realidad, ninguno de ellos es necesario, ya que si no hubiera ningún parámetro, el archivo será abierto/ejecutado por defecto.
Estas opciones fueron implementadas solamente para dar al usuario una idea mejor de qué deberá hacerse con el archivo: dependiendo del parámetro usado, el texto de ayuda en la barra de status cambia cuando el usuario coloca el cursor sobre el botón "RUN"

file=<*run*> camino para el ejecutable <*cmd*> parámetro(s).

file=<*open*> camino para el ejecutable <*cmd*> parámetro(s).

file=<*install*> camino para el ejecutable <*cmd*> parámetro(s).

file= camino para el ejecutable <*cmd*> parámetro(s).
En las cuatro opciones de arriba, está permitido usar parámetros. Use <*cmd*> entre el nombre del ejecutable y sus parámetros.
<*cmd*> no se ha probado, y si fuese un nombre de camino, use uno absoluto.
<*cmn*> DEBE ser un nombre de camino y se ha probado en ese sentido. Los nombres de camino relativos y comodines son aceptados.

seq= localización relativa del archivo a ser ejecutado (excepciones iguales a las de "file=") A razón principal de esta opción es permitir dos comandos (o más) en una secuencia por entrada (ej. descomprimir y después ejecutar un archivo contenido en el .zip) Tiene las mismas opciones y posibilidades que "file="

Excepto :

La secuencia máx. de comandos es 9, así que: file + seq de 10 acciones posibles!) Esta entrada sólo es considerada:
Si es mencionada DESPUES de un comando "file=" (o "seq=") Y
Si el comando 'file=' (o 'seq=') anterior contiene <*copy*>, <*directory*> o <*zip*>. Esta limitación fue implementada porque hay opciones que pueden ser lanzadas sin el control de CCDM, o que pueden causar la imposibilidad de usar secuencias. TIENE LAS MISMAS OPCIONES Y LIMITACIONES QUE "file="

Cdsize= Tamaño de la aplicación en el CD

ej. cuando se use: cdsize=40 MB, el programa mostrará: Size on CD : 40 MB

cdsize=<*info*>text

con esta opción, solamente el texto que se especifica será mostrado, si no quisiera que el programa escriba 'Size on CD : ...' Obs.: NO use un texto muy largo! ideal cuando quiera colocar dicas o algo similar no obstante, este campo no puede ser copiado (ej. <ctrl>C no funciona)

cdsize=<*html*>URL (ej.: cdsize=<*html*> http://www.yoursite.com)

Use esta sintaxis para mostrar el texto como un Hyperlink, o sea, al hacer click en el texto el navegador por defecto del sistema será iniciado. Aunque esta sintaxis haya sido diseñada para URLs, puede ser usada para lanzar cualquier archivo deseado, si bien el nombre de camino debe ser absoluto, p.ej., debe incluir la letra de unidad, en caso contrario, el camino de ejecución puede variar indeseadamente (no lo use)

HDSize= Tamaño de la aplicación en el HD (ej.: después de descomprimir)

ej. cuando use: hdsize=60 MB, el programa mostrará: Size on HD : 60 MB

hdsize=<*info*>text

hdsize=<*html*>URL

Vea Cdsize=

Extra= escriba aquí cualquier texto

Ej: explicaciones, códigos secretos de juegos, observaciones para la instalación del programa, etc. No se permiten en el texto retornos de carro duros (tecla ENTER). Si hubiera alguno, solamente la parte anterior al mismo será mostrada.

Extra=<*BEGIN*> Observaciones ( opcional )

Texto para linea 1 ...

Texto para linea 2 ...

Texto para linea 3 ...

...

La opción <*BEGIN*> <*END*> hace posible teclear más de una línea de texto, pudiendo entonces usar retornos de carro duros (con Enter). Todo el texto será mostrado, hasta que el comando <*End*> sea detectado. IMPORTANTE : <*END*> debe ser colocado en el inicio de una nueva línea (precedido, pues, de un retorno de carro duro) Todo el texto en la misma línea que se encuentre detrás de <*begin*> o <*end*> será ignorado. Puede colocar anotaciones ahí si quiere.

Picture= camino relativo de la imagem a ser presentada en esta selección (ej.: pictures\default.bmp) Si no se especifica nada, la imagen por defecto será mostrada. Desde la versión 1.5, se permiten múltiples archivos por selección (hasta 9 imágenes diferentes). Simplemente incluya "picture=" cuantas veces sea necesario. Si especificara <*none*> (ej.: picture= <*none*>), ni siquiera la imagen por defecto será mostrada. Use esta opción sólo en caso de tener una animación siendo ejecutada como media por defecto ('defaultmedia'). Se permiten comodines en el camino.

Media= camino relativo para el archivo de media a ejecutar para esta selección (ej.: sounds\jingle.wav)

-> Si no se especifica o no existe, la media por defecto será abierta.

-> Cuando un archivo de media sea especificado, será abierto (el botón Play aparece)

Text= camino relativo a un archivo de texto a ser mostrado adicionalmente al usuario. Si no se especifica ningún archivo, el botón de texto no aparece. Si el archivo no pudiera ser abierto, el usuario será informado. Si intenta cargar un archivo binario, aparecerán caracteres extraños. El texto abierto puede ser alterado (sólo visualmente, no en contenido) Ese texto puede ser impreso (como se determine visualmente, ajustando la FUENTE) o grabado en cualquier localización escogida por el usuario. El texto puede ser lanzado en el editor de texto ASCII por defecto (a través del archivo temporal gravado en el directorio temp) Se permiten comodines en el camino. Vea más adelante.

Opción:

Text= <*extra*>

Esta opción copia el contenido del campo Extra en el campo de texto, por tanto, ningún nombre de archivo es necesario aquí).

Nombres de camino absolutos y relativos :

Un camino absoluto contiene una letra de unidad (c:\, d:\, etc.)

Un camino relativo NO contiene la letra de unidad.

CCDM automáticamente añade la letra de de la unidad en que está siendo ejecutado.

<<w>> directorio de windows (donde el usuario instaló windows) (ej: c:\windows)

<<s>> directorio System (usado para grabar dll’s) (ej.: c:\windows\system)

<<d>> directorio de Escritorio del usuario (ej.: c:\windows\desktop)

<<i>> directorio de Favoritos del usuario (ej.: c:\windows\favorites)

<<m>> menu inicial (Start Menu)

<<f>> directorio de fuentes.

<<r>> la raíz de la unidad en que windows está instalado (ex.: c:\)

<<c>> a raiz de la unidad en que el menu está siendo ejecutado (ex.: d:\)

<<a>> directorio desde donde el menu es ejecutado.

<<l>> el camino anterior de la secuencia (por ej.: donde algo fue copiado o descomprimido)
Note que a veces es necesario saber la estructura de directorio del archivo descomprimido o del directorio para hacer esto correctamente. Lo mismo ocurre cuando se copia un directorio: sólo el directorio donde fue copiado el directorio será recordado.

<<t>> directorio temporal del sistema (ajustado por tmp= o temp= en autoexec.bat) o el directorio temporal de windows (ej.: c:\windows\temp)

Estos comodines SOLO son tomados en consideración cuando:
Hay un solo comodín por camino.
El comodín es el primer caracter del camino.
No se usa ningún camino absoluto.

Por tanto, no intente:
c:\<<w>> : el comodín no és el primer caracter
<<w>>c:\ : este camino será c:\windows\c:\ y no es válido
<<w>><<w>> : este camino será C:\windows\<<w>> y no es válido

OBSERVACIÓN IMPORTANTE :

POR TANTO:

Siempre mantenga el especificador y el signo "=" juntos y asegúrese de que el especificador sea la primera palabra de la nueva línea!

Parámetros para línea de comando:

cd_menu.exe -create -pet:camino relativo a otro archivo de contenido

Cuando el programa sea ejecutado con esta opción, tres botones extras estarán disponibles:
El botón refresh (aunque esta opción siempre está disponible a través de la tecla F5). Refresh permite ver los cambios en el archivo cd.pet inmediatamente.
El botón Open (abrir), que permite cargar otro archivo de comandos.
El botón SpeedFile, que crea un Speedfile (petfilename.bin). Cuidado con esto, lea el SpeedFile.txt con atención.

Estos botones son útiles durante la creación del archivo cd.pet.

-pet:camino relativo para otro archivo de comandos
Ej.: -pet:menu\content.dat

Ventajas: Se puede especificar esta opción en el archivo autorun.inf, así este archivo de comandos será leído cuando el CD sea insertado en la unidad.

Desventajas: Si el usuario hace click en cd_menu.exe, el archivo cd.pet será cargado (si está presente).

Otra ventaja: Puede ser usado para engañar al usuario: unas veces verá lo que está en el archivo especificado, y otras lo que está en el archivo cd.pet.

Una sugerencia es crear un atajo para la aplicación con los parámetros que se quiera.

Ej: cd_menu.exe -create -pet:menu\content.dat
El archivo de comandos será ‘content.dat’, el cual se encuentra en el directorio menu. El programa mostrará los botones ‘Open’, ‘Refresh’ y ‘SpeedFile’.

Sugerencias para crear el archivo de comandos

Use un editor de textos ASCII (Notepad, por ejemplo) para crear el archivo.

Si no quiere que los archivos *.pet sean asociados al editor (aunque no haya problema alguno en ello), salve el archivo como .txt y renómbrelo cuando termine. Se puede cargar el archivo .txt con la opción –create y usando el botón ‘Load’.

Cree los directorios como serán grabados en el CD en la raíz de su HD.
Ej.: si el CD va a contener los directorios Apps y Games, cree estos directorios en la raíz de su unidad C: (o cualquier HD que vaya a contener los archivos). Copie o mueva los programas/archivos que serán grabados a CD en estos directorios.

Otros modos de proceder son: Cree una partición separada en su HD o Use un dispositivo diferente (unidad Jaz o Zip) o Cree una unidad virtual (es el modo más simple de atacar el problema)
Cree un directorio (CDProj, por ejemplo) en el cual serán grabados los datos del CD
Abra una ventana de DOS y use el comando SUBST para crear un disco virtual con este directorio
(subst p: c:\cdproj). De este modo, será creada una unidad p:, que tendrá exactamente el mismo contenido del directorio c:\cdproj

Las sugerencias de arriba no son obligatorias, si bien crean la posibilidad de probar su archivo de comandos mientras está siendo creado.

Se puede colocar el Cdmenu.exe (junto con el cd.pet y opcionalmente también Unzdll.dll, NViewLib.dll, pkunzip, arj y rar) en cualquier directorio, dado que todos los caminos de archivo (especificados en cd.pet) son relativos a la raíz. Sin embargo es mejor colocarlo en la raíz, de modo que el usuario pueda fácilmente ejecutarlo.

Pruebe el archivo de comandos creado. Si los programas fueron colocados en los mismos directorios relativos en que serán grabados a CD, esta prueba le dirá mucho sobre su archivo de comandos.

Si no todo funciona según lo previsto, busque en el .pet errores de tecleado (camino incorreto, nombre de archivo incorrecto, etc.) Use F5 (Refresh) para cargar el archivo grabado y pruebe de nuevo.

Cuando todo esté listo (y correcto), grabe el CD. Mantenga los caminos relativos igual!

Si quiere que el menu arranque automáticamente cuando el CD sea insertado, grabe un archivo llamado autorun.inf en la raíz de su CD. Este archivo no es más que un archivo de texto que contiene la localización relativa de una aplicación a ser ejecutada y (opcionalmente) un icone a ser mostrado.

Ejemplo:

[autorun]

open=CD_menu.exe

icon=icon.ico

OBS.: Autorun sólo funcionará si el usuario tiene la ‘Notificación automática de inserción’ activada. De todos modos, como esta es la opción por defecto de Windows 95/98/NT, la mayoría de los usuários la utiliza.

Se puede aumentar la funcionalidad de autorun.inf con:

shell=Install

shell\Install=&Ejecutar CD Menu

shell\Install\command=CD_menu.exe

Con esto, la opción ‘Ejecutar CD Menu’ aparecerá en negrita cuando el usuario haga click con el botón derecho en la unidad de CD (& sirve para subrayar el carácter y hacerlo un atajo).

Problemas conocidos: ninguno.

SpeedFile.txt (traducción del texto de SpeedFile.txt, archivo independiente distribuido con el pack).

La opción SpeedFile debería usarse con CUIDADO, a causa de la relación entre speedfile y cd.pet !

Si el archivo cd.pet cambia y el speedfile ya ha sido creado, las cosas pueden descontrolarse totalmente !!

Así que, para resumir:

------------------------------

- La opción SpeedFile Option Creation sólo está disponible al iniciar el programa en ‘modo create’. Este modo puede activarse con el parámetro en línea de comandos -create (ejemplo en el archivo create.bat).

- La creación del Speedfile se activa pulsando el botón Crono (Chrono).

- Una vez que el Speedfile existe, es tenido en cuenta (en modo create O No, no importa).

- El nombre del Speedfilees el del archivo de contenidos con la extensión .bin (Casi siempre será: cd.bin)

- Este archivo se crea en el mismo directorio en que reside el archivo de contenidos.

- Para que sea tenido en cuenta, debe residir en el mismo directorio que el archivo de contenidos.

- Cree el speedfile SOLO cuando el contenido ESTE TERMINADO Y PROBADO!

- Pulse Refresh y verá la mejora de velocidad.

- Si altera el archivo cd.pet tras crear el speedfile (cd.bin), las cosas PODRIAN ir completamente mal, o el speedfile no ser tomado en cuenta.

Por tanto,

---

- Cree el Speedfile como una acción muy tardía antes de empezar a usar el menú.

- NUNCA cambie el speedfile (cd.bin), ni el archivo de contenido (cd.pet), tras haber creado el speedfile.

¡Que se divierta !

Saludos,

Smart Projects

--------------------------------------------------------------------------------------------