01. Aspectos legales   Volver al Índice

Copyright

El programa YACDP es propiedad de © 1994 Frank Würkner.
Todos los derechos reservados (All rights reserved).

YACDP es SHAREWARE: el programa puede ser distribuido libremente si...

1. el ejecutable y la documentación permanecen intactas y son incluidas en la versión de distribución.

2. en el caso de cobrar una cantidad, ésta será sólo para cubrir los costes por el tiempo y el copiado del paquete.

¿Porqué "Shareware"?

Bueno, lo que comenzó como algo divertido se ha convertido ahora en un trabajo que me ocupa su tiempo (como por ejemplo las horas que he perdido ajustando YACDP para que funcionase con varias controladoras y modelos de unidades de CD-ROM). Sin embargo, esta versión es TOTALMENTE funcional: y es que no me gustan las malditas peticiones informativas que aparecen cada dos por tres, ni los ficheros llave,... Espero que el propio programa, por sus cualidades intrínsecas, le convenza de que debe registrarse.

¿Cómo registrarse?

Basta con volcar por la impresora la 'Hoja de registro' (`Registration form') suministrada y rellenarla. Envíela al autor con 20 marcos alemanes o 15 dólares EE.UU. (sólo dinero en metálico o EuroCheque, por favor): estará contribuyendo a que siga desarrollando nuevas versiones del programa. Recibirá la siguiente actualización por correo: si está interesado en futuras actualizaciones por el mismo método debe añadir 5 marcos alemanes o 5 dólares EE.UU. por cada actualización que desee recibir; sin embargo le recomiendo que consiga éstas a través de AmiNet, AmiNet CD, FredFish(TM) CD o una BBS local. Si tiene dirección Internet de correo electrónico (EMail) puedo avisarle de la disponibilidad de nuevas versiones o enviárselas comprimidas con Lha y "uuencodeadas".

02. Garantías   Volver al Índice

No garantizo de ninguna manera el funcionamiento o prestaciones de este programa: si se arriesga a emplearlo, será usted el único responsable de lo que pueda suceder.

03. Requerimientos para poder ejecutar YACDP   Volver al Índice

• SO versión 2.0 (SO 2.1 para usar la prestación local) o superior.

• reqtools.library © 1991-1994 de Nico François (¡gracias Nico!).

• un adaptador de bus SCSI capaz de enviar comandos SCSI directos.

• una unidad de CD-ROM SCSI-2 capaz de leer discos CD-DA (especificaciones del "Libro Rojo"): suelen llevar un conector para auriculares, tipo jack, en su parte frontal.

• opcionalmente, la unidad debe ser capaz leer pistas digitales de audio a través del bus, o sea, ser capaz de enviar datos de 16 bits por el bus SCSI.

04. Características que ofrece YACDP en esta versión   Volver al Índice

• entorno gráfico (GUI) desde el que se puede acceder a todas las funciones normales de un reproductor de CD-ROM.

• es una "Comodidad".

• potente puerto AREXX.

• soporte local a partir de SO versión 2.1 y superior (por ahora sólo alemán como opción).

• puede visualizar los nombres de las canciones y el título del CD, siempre que los haya introducido manualmente una primera vez: se han incluido los textos de alrededor de 150 CC.DD.

• no desperdicia memoria.

• los errores SCSI son mostrados como texto (95 conocidos).

• reproducción estéreo en tiempo real a través de su Amiga, incluso con equipos que dispongan como CPU de un 68000 (gracias a las rutinas altamente optimizadas en ensamblador).

• capacidad de guardar (partes de) canciones en estéreo o en IFF (8SVX) o sin formato (RAW/CDR).

Para las dos últimas características la unidad de CD-ROM debe ser capaz de enviar los datos por el bus SCSI (consulte «Requerimientos»).

05. Primeros pasos   Volver al Índice

Si usa frecuentemente CC.DD. musicales quizás debería colocar el programa en el cajón WBStartup (no olvide modificar los tipos de herramienta `SONGDIR' y `AREXXDIR'): pero cualquier otro lugar es posible. Además de TOOLPRI existen otros tipos de herramienta que pueden emplearse si se invoca el programa desde el CLI como por ejemplo `YACDP CX_POPUP=NO UNIT=6'. Los siguientes tipos de herramientas son los soportados (los valores por defecto de éstos son mostrados entre corchetes):

06. El interfaz gráfico (GUI)   Volver al Índice

a. Menú

`Sobre el programa' (`About Program')

Muestra una petición informativa sobre el programa (¡oh, qué sopresa! ;).

`Sobre el CD-ROM' (`About CD-ROM')

Muestra una petición informativa sobre la unidad de CD-ROM, incluyendo el distribuidor/fabricante, el nombre del producto y la revisión.

`Sobre el CD' (`About CD')

Muestra una petición informativa con los nombres de las canciones (si el CD está presente) y el tiempo de reproducción de cada canción.

`Editar Canciones' (`Edit Songs')

Ejecuta el editor de textos para que pueda introducir el nombre de las canciones. Reemplace las líneas con `<>' por los nombres reales. Si está interesado en cómo el fichero es creado, consulte «Ficheros de canciones y referencia».

`Actualizar' (`Update')

Necesita esta opción si ha cambiado algo en el fichero de canciones del CD y la notificación de ficheros no es soportada o los datos mostrados sobre el CD no fuesen correctos.

`Ocultar' (`Hide')

Oculta el entorno/interfaz gráfica (GUI).

`Salir' (`Quit')

Salir del programa.

`SCSI'

Todos los ítems del menú cambian los valores de los correspondientes tipos de herramienta.

`Filtro' (`Filter')

Estado del filtro de paso bajo (por defecto, apagado).

`Liberar Dispositivo' (`Release Device')

Si comienza reproduciendo la música `vía SCSI', alguna memoria (buffers) y canales de música de su Amiga estarán reservados para YACDP. Emplee esta opción para liberarlos sin salir del programa.

`Guardar Audio' (`Save Audio')

Muestra una ventana en la que debe introducir los parámetros de la parte del CD que desea guardar (consulte «Guardar audio IFF-CDR»).

`Seguimiento' (`Trace')

Si está activado, muestra cada comando Arexx que se envíe a YACDP en la línea de estado/mensajes.

`Vaciar cola de espera' (`Flush waitqueue')

YACDP proporciona un comando Arexx `WAIT' (consulte «Puerto AREXX») para esperar por situaciones o estados especiales. Cuando pruebe un guión/script Arexx, puede usar esta opción para abortar todos los guiones en espera.

El usuario puede configurar otros ítems en el menú gracias al fichero `AREXX/YACDP.menu'. Se trata de un fichero de texto ASCII con un nº impar de líneas: los ítems son representados por dos líneas, donde la primera es el nombre que aparecerá en el menú (si la línea contiene sólo un signo menos '-', éste es tratado como una línea separadora a añadir en el menú) y la segunda es el comando a ejecutar cuando se elige dicha entrada en el menú. Puede incluso ejecutar otros programas desde aquí.

Descripción de lo que hacen las macros existentes por defecto:

`Test CD' (`Muestrario' o `Probar CD')

Reproduce los 10 primeros segundos de cada canción existente en el CD.

`Upside down' (`Invertir orden de reproducción')

Reproduce las canciones del CD desde la última a la primera.

`Fade out' (`Fundido')

Reduce el volumen de forma contínua hasta cero.

`Fade in' (`Invertir fundido')

Aumenta el volumen de forma contínua hasta el valor máximo.

`Show current position' (`Mostrar posición actual')

Muestra la posición actual. El primer nº llamado `Abs. block' es el bloque (absoluto) empleado en la opción `Save Audio' (`Guardar Audio'), mientras que el nº entre paréntesis es el nº de bloque real.

`DumpVars' (`Ver variables')

Muestra todas las variables Arexx actualmente válidas.

b. Icono (imagen superior izquierda en la ventana del programa)

un cable SCSI con una interrogación parpadeante...

el programa no puede enlazarse con su unidad de CD-ROM: juegue con los parámetros en el menú SCSI. Se le mostrarán peticiones informativas con información más detallada.

un CD con una interrogación parpadeante...

el programa ha detectado unaa unidad de CD-ROM, pero no se ha insertado ningún CD en ella aún.

un CD con ceros y unos...

ha insertado un CD, pero es de datos.

un CD con notas musicales sobre él...

ha insertado un CD musical.

c. Textos

Pista: (`Track:')

La pista (suele corresponder con la canción) actual.

Indice: (`Index:')

El índice actual. Muy pocos CC.DD. tienen índice (algunos CC.DD. clásicos por ejemplo lo tienen)

Tiempo: (`Time:')

El primer tiempo indica la cantidad de tiempo ya reproducido del total del CD. El segundo muestra la cantidad de tiempo que aún falta.

Canción (`Song:')

El primer tiempo muestra la cantidad de tiempo reproducida de esta pista y el segundo la cantidad de tiempo que aún queda para terminarla. Si sólo viese usted un tiempo, sería debido a que la reproducción están en el área de pausa entre dos pistas.

Nombre de la canción

Esta línea muestra el nombre de la canción actual. Si no ve ninguno es posiblemente a que primero tendrá que usar la opción `Editar Canciones'.

Línea de estado/mensajes

Esta línea, cuando corresponde, muestra mensajes generados por ejemplo por el Arexx o el estado de la reproducción si se encuentra en...

Modo Contínuo ('Continue')

La línea está vacía

Modo Aleatorio ('Shuffle')

Los números en color azul (normalmente el cuarto color de la paleta del WB) indican las pistas que se han excluído o que ya han sido reproducidas. El número en color blanco (normalmente el tercer color de la paleta del WB) señala la pista que se está reproduciendo, mientras que los números en color negro (normalmente el segundo color de la paleta del WB) representan las pistas pendientes de reproducción.

Modo Programa ('Program')

Los números en color azul indican las pistas ya reproducidas. El número en blanco muestra la pista que actualmente se está reproduciendo. Los números en color negro muestran las pistas pendientes de reproducción.

d. Botones

Para la mayor parte de las funciones es obvio que debe introducir un CD musical en la unidad o los botones aparecerán en modo fantasma, con lo que no será posible seleccionarlos.

Los botones del `1' al `39' y el botón `+'

Si su CD tiene más de 39 pistas deberá emplear el botón `+' que aparece en la parte inferior de la ventana, con lo se le presentará una petición en la que podrá indicar el nº de pista a reproducir. Pinchando en cualquiera de los otros botones se ordena la reproducción de la pista (canción) correspondiente si se encuentra en el modo Contínuo; si estuviese en el modo Aleatorio su efecto sería excluir dicha pista de la lista, salvo que ya lo estuviese en cuyo caso se reincorporaría a ésta; si estuviese, sin embargo, en el modo Programa la pista sería añadida a la lista de pistas a reproducir. Pulsando cualquiera conjuntamente con la tecla SHIFT, se mostrará el nombre de la canción en la línea de mensajes.

Botón `»'

Si no está reproduciéndose ninguna canción, se inicia ésta. Si la reproducción está en pausa, se continúa con ésta. Si hay un CD actualmente reproduciéndose, se reinicia la reproducción desde el principio de la pista actual.

Botón `||'

(Des)activar la pausa en la reproducción.

Botón ` '

Detener la reproducción.

Botón `|«'

Se inicia la reproducción de la pista anterior: no es posible si la actual es la primera ;-). Si nos encontramos en el modo `Programa' es la pista situada inmediatamente anterior en la lista. Este botón no tiene efecto en el modo `Aleatorio'.

Botón `»|'

Se inicia la reproducción de la siguiente pista, no siendo posible si se trata de la última pista. Si nos encuentramos en el modo `Programa' será la siguiente en la lista mientras que si se trata del modo `Aleatorio' la siguiente que corresponda en la lista aleatoria generada será la que se reproducirá.

`««'

Se salta en la reproducción n segundos hacia atrás.

`»»'

Se salta en la reproducción n segundos hacia adelante. Sin embargo el valor de n dependerá de qué tecla (de estado) se presione simultáneamente:

tecla de estado	n
SHIFT ninguna ALT CTRL	10 segs 20 segs 40 segs 60 segs

`««'

Salta al índice anterior.

`»»'

Salta al siguiente índice (`««' y `»»' sólo funcionan si no está activado el modo `vía SCSI').

`^'

Expulsar el CD.

e. Lo que falta por explicar...

Selector de modo de reproducción

Usted puede elegir entre los siguientes modos:

`Contínuo' (`Continue')

Las pistas son reproducidas una detrás de otra.

`Aleatorio' (`Shuffle')

Las pistas se reproducen en un orden aleatorio. Puede excluir pistas de la reproducción si lo desea.

`Programa' (`Program')

Ha de crear una lista previamente en la que indicará qué pistas quiere que sean reproducidas para a continuación inciarse la reproducción.

Opción `Repetir todo' (`Repeat all')

Si está activada la reproducción se reiniciará en cuanto se llegue al final.

Opción `Repetir pista' (`Repeat track')

Si está activada, la pista actual se reproducirá de forma indefinida.

Opción `vía SCSI'

Si está activada, los datos de audio serán enviados a través del bus SCSI, convertidos y reproducidos a través del dispositivo `audio.device'. Debido a este proceso, la CPU se verá sobrecargada de trabajo (al menos en equipos con una CPU 68000) por lo que puede que la multitarea no sea todo lo fluída que debiera o incluso que la reproducción no fuese contínua: sólo la interfaz gráfica se refrescará puntualmente cada segundo. Si no está activada, la reproducción la hará la unidad de CD-ROM a través de su hardware.

Opción `Estéreo' (`Stereo')

Esta opción sólo está disponible si la opción `vía SCSI' está activada, ya que si es a través del propio hardware de la unidad de CD-ROM la reproducción siempre es estéreo: si está activada la reproducción será estéreo, en caso contrario será mono(fónica) por lo que se oirá exactamente lo mismo tanto por el lado derecho como por el izquierdo. Puede ser útil con algunos CC.DD. que tienen unos efectos estéreo penosos.

Control deslizante `Vol'

El control deslizante le permite controlar el volumen de la unidad de CD-ROM y del Amiga, dependiendo del estado de la opción `vía SCSI'. Desplazando el control hacia arriba, subirá el volumen.

Control deslizante `Bal'

Este control deslizante le permite controlar el balance de la unidad de CD-ROM y del Amiga, dependiendo del estado de la opción `vía SCSI'. Si se encuentra en la posición central, el balance estará equilibrado (mismo volumen en el lado izquierdo y en el derecho). Desplazando el control hacia abajo se baja el volumen del lado derecho, mientras que si se sube se baja el volumen del lado izquierdo.

f. Manejo desde el teclado

`0'...`9'

Inicia la reproducción del nº de pista pedido. Si dicho nº es de dos dígitos deben ser introducidos rápidamente, con una diferencia entre ambos de como máximo un segundo. Si introduce más de dos dígitos los dos últimos son los válidos: así por ejemplo si teclea 5 - 1 - 6 será la pista 16 la reproducida.

`G'

vea el botón `»'.

`P'

vea el botón `||'.

`S' o `RETURN'

vea el botón ` '.

`Cursor abajo'

vea el botón `|«'.

`Cursor arriba'

vea el botón `»|'.

`Cursor izquierda'

vea el botón `««' (igual con teclas de estado).

`Cursor derecha'

vea el botón `»»' (igual con teclas de estado).

`«'

vea el botón `««'.

`»'

vea el botón `»»'.

`^'

vea el botón `^'.

`+'

Incrementa el volumen.

`-'

Reduce el volumen.

Tecla `HELP'

vea el ítem de menú «Sobre el CD».

`Barra espaciadora'

Restaura la línea de estado (si un mensaje es mostrado en su lugar).

`BACKSPACE' o `«-'

No tiene efecto en el modo `Contínuo'. En el modo `Aleatorio' todas las canciones son incluídas en la lista de reproducción. En el modo `Programa' la última pista incluída en la lista de reproducción será borrada de ella (si no está reproduciéndose actualmente).

07. Guardar audio como IFF o CDR   Volver al Índice

Sobre el Copyright

Piense que aunque haya adquirido un CD, hay ciertos derechos que posiblemente no tenga sobre él (especialmente en el modo CDR, en el que se copia el CD sin pérdida ninguna de información). Compruebe la línea `Status legal (de la copia)' (`Copystatus') por si el autor del CD permite la copia digital o no y tenga en cuenta que USTED es el único responsable de que no se viole ningún derecho.

Cómo está almacenada la información

Los discos CD-DA guardan los datos en bloques de 2352 octetos en los que se almacena 588 valores de 16 bits con signo para el canal izquierdo y otros 588 valores de 16 bits con signo para el derecho. La frecuencia de muestreo de un CD musical es de 44.100 Hz, lo que significa 44.100 valores de 16 bits con signo para cada canal, necesarios para reconstruir una onda sonora de una duración de un segundo. Así 75 (=44100/588) bloques de un CD musical son un segundo de reproducción. Teniendo en cuenta esto, por ejemplo, un minuto de calidad CD ocupa 75*2352*60 = 10584000 (sobre 10 Mb). El chip de sonido del Amiga (Paula) debe reproducir este sonido, previa conversión, en un formato de 8 bits y con una frecuencia máxima de mustreo de 28.867 Hz (más para los modelos Amiga ECS).

Bueno, ahora hay que reducir los datos que la unidad de CD-ROM nos envía, ¿pero cómo? El programa le permite controlar ciertos aspectos de la conversión como son:

La frecuencia de muestreo

44100	(*)	==»	1/1	frecuencia de muestreo original
22050		==»	1/2	"     "     "
14700		==»	1/3	"     "     "
11025		==»	1/4	"     "     "
8820		==»	1/5	"     "     "
...

Reduciendo la frecuencia de muestreo a 11.025 obtendrá una calidad muy pura.

(*) la mayor parte de los reproductores rechazarán esta frecuencia
--lea el porqué en «Cómo está almacenada la información»--.

Los canales

`Estéreo (CDR)' (`Stereo (CDR)')

Datos tomados de forma absoluta sin conversión (el fichero creado es simplemente un volcado de los datos presentes en el CD, y así por ejemplo el fichero no está en formato IFF). Este formato puede ser usado para convertir el sonido a otros formatos empleando SOX (PL11, portado a Amiga por David Champion, aminet/mus/edit/AmiSOX33.lha). Así por ejemplo puede crear ficheros Windows .WAV de 16 bits simplemente ejecutando `sox test.cdr test.wav'. El formato del fichero .cdr es (¡cuidado con la ordenación Intel de los octetos!):

Byte	Muestra	Peso o significación
1 2 3 4 5 ...	1 1 1 1 2 ...	Octeto menos significativo canal izquierdo Octeto más significativo canal izquierdo Octeto menos significativo canal derecho Octeto máss significativo canal derecho Octeto menos significativo canal izquierdo

`Estéreo (IFF)' (`Stereo (IFF)')

Ambos canales son escritos por separado.

Nota: ¡Algunos reproductores no pueden manejan los IFF estéreo!

Reproductores recomendados son:

• DSound 1.50 © 1991-1994 de Dave Schreiber (aminet/mus/play/DSound150.lha)

• DeliTracker 2.07 © 1991-1994 de Peter Kunath and Frank Riffel (aminet/mus/play/DeliTracker_207.lha)

`Mono (IFF)'

Los datos para el canal izquierdo y el derecho son combinados, así por ejemplo el tamaño es sólo la mitad de un IFF estéreo.

`Izqdo. sólo (IFF)' (`Left only (IFF)')

sólo los datos de audio del canal izquierdo son utilizados.

`Dcho. sólo (IFF)' (`Right only (IFF)')

sólo los datos de audio del canal derecho son utilizados.

Escalado del sonido

Algunas veces el sonido puede sonar ralentizado, por lo que puede escalarlo dividiéndolo por un factor, normalmente 2. Pruebe 2, 4, 8, 16.
Ejemplo:
Veamos cómo se reduciría la entrada si eligiésemos como frecuencia de muestreo 14700, modo `Derecho e Izquierdo' y como escalado del sonido 2:

Primero todas las muestras digitalizadas son sumadas: -66069

La salida final debe ser -66069 / 768 = -86

Nota:
Si ha elegido como factor de escalado 4, el resultado será -172, lo cual rebasa los 8 bits y por lo tanto tendrá que ser reducido a -128 (los valores mayores de 127 serán reduciedos a 127).

En este caso el sonido suele habitualmente sonar mal.

Los controles deslizantes del lado izquierdo representan la pista de inicio, el tiempo relatativo en esta pista y finalmente los bloques absolutos (¿recuerda que un segundo son 75 bloques?). Los controles deslizantes de la derecha representan lo mismo pero para la posición final.

Botones

`|» INIC' (`PLAY START')

reproduce durante 10 segundos desde la posición INICial actual.

`|» FIN' (`PLAY END')

reproduce los 10 segundos anteriores de la actual posición definida como FINal.

`|» TODO' (`PLAY ALL')

reproduce todo el sonido seleccionado.

`DETENER' (`STOP')

detiene la reproducción.

`CONV' (`OK')

para proceder con la CONVersión y que una petición de ficheros le permita elegir el nombre del fichero a generar.

`CANCELAR' (`CANCEL')

le hace volver a la ventana principal.

Si todo marcha bien deberá ver una pequeña ventana en la que se mostrará la evolución de la conversión. Presione ESC o CTRL-C con la ventana activa si desea detener dicho proceso.

08. Puerto Arexx   Volver al Índice

El programa crea un puerto Arexx llamado 'YACDP'. Algunos de los comandos necesitan argumentos que son tratados de la misma forma que en los comandos CLI. Si los comandos no son reconocidos o los argumentos son inválidos (falta algún argumento imprescindible, un valor numérico es incorrecto, ...) el comando devolverá un error 10. Si un valor numérico está fuera del rango esperado puede ser tomado como el valor válido más próximo no considerándose como un error: por ejemplo si usted envía el comando `PLAYTRACK 20', pero el CD sólo dispone de 15 pistas, se tomará la décimoquinta pista como la solicitada; en caso de fallo (RC>5) la variable Arexx ERR contendrá una descripción de lo que ha fallado.

Los siguientes comandos son los admitidos:

PLAYTRACK TRACK/N,INDEX/N [1,1]
Reproduce el CD completo empezando por la pista (TRACK) e índice (INDEX) especificado.

PLAYBLOCK BLOCK/N [primer bloque válido del CD]
Reproduce el CD completo comenzando por el bloque (BLOCK) especificado. No se asume que el CD debe comenzar en el bloque 0.
Emplee el comando `GETVAR TRACKSTART NUM=n' para localizar el comienzo de éste.

PLAY
Lo mismo que si pincha con el puntero en el botón `»'.

PAUSE
Lo mismo que si pincha con el puntero en el botón `||'.

STOP
Lo mismo que si pincha con el puntero en el botón ` '.

LASTSONG
Lo mismo que si pincha con el puntero en el botón `|«'.

NEXTSONG
Lo mismo que si pincha con el puntero en el botón `»|'.

BACKWARD BLOCKS/N [20*75=1500]
Salta BLOCKS bloques hacia atrás (75 bloques=un segundo). Equivale a pinchar con el puntero en el botón `««'.

FORWARD BLOCKS/N [20*75=1500]
Salta BLOCKS bloques hacia adelante (75 bloques=un segundo). Equivale a pinchar con el puntero en el botón `»»'.

LASTINDEX
Lo mismo que si pincha con el puntero en el botón `««'.

NEXTINDEX
Lo mismo que si pincha con el puntero en el botón `»»'.

EJECT
Lo mismo que si pincha con el puntero en el botón `^'.

SAVEAUDIO FILENAME/A,STARTBLOCK/N/A,ENDBLOCK/N/A,SCALE/N,COMP/N, TYPE/N,NOWIN/S [ , , ,1,2,2, ]
Este comando corresponde al ítem del menú (Guardar sonido). Debe suministrarse nombre de fichero (FILENAME), bloque inicial (STARTBLOCK) y bloque final (ENDBLOCK). Opcionalmente las muestras digitalizadas pueden ser escaladas (SCALE), definida la frecuencia de muestreo (vea a continuación la tabla) y el formato de fichero (vea a continuación la tabla correspondiente). Si utiliza `NOWIN' entonces la ventana informativa de cómo evoluciona el proceso no se mostrará.

COMP frec. muestreo 1 2 3 4 5 6 7 8 9 10 44100 22050 14700 11025 8820 7350 5512 4900 4410

TYPE canales y formato de fichero 1 2 3 4 5 Estéreo (CDR) Estéreo (IFF) Mono (IFF) Izquierdo sólo (IFF) Derecho sólo (IFF)

SHOW
Mostrar interfaz gráfica (GUI).

HIDE
Ocultar interfaz gráfica (GUI).

QUIT
Salir de YACDP.

REQUESTER VARNAME/A,TITLE/A,TEXT/A,BUTTONS/A,DEFAULT/N [ , , , ,0]
Muestra una petición con el título (TITLE) y el texto (TEXT) que usted especifique. Los botones BUTTONS pueden ser separados con el carácter `|': éstos son numerados de izquierda a derecha comenzando por el 1, pero el botón más a la derecha tiene asignado el número 0. El botón por defecto está marcado en negrita. El número resultante es almacenado en VARNAME.

GETSTRING VARNAME/A,TITLE/A,DEFAULT [ , ,""]
Muestra un petición de texto con el título (TITLE) y empleando como texto por defecto (DEFAULT) el que usted desee. La cadena resultante es almacenada en VARNAME. Si el usuario aborta la petición, RC tendrá un valor de 5.

GETNUMBER VARNAME/A,TITLE/A,DEFAULT/N,MIN/N/K,MAX/N/K,DONTSHOW/S [ , ,0,-2147483648,2147483647, ]
Muestra una petición numérica con el título (TITLE) y el valor (DEFAULT) que usted le especifique. Puede restringir los valores admisibles por la petición (en realidad su rango) con MIN y MAX. La opción DONTSHOW hace que el valor por defecto no se muestre. El valor es almacenado en VARNAME. Si el usuario aborta la petición RC tendrá un valor de 5.

PUTMSG MSG/A,SECS/N [ ,10]
El mensaje MSG se mostrará SECS segundos en la línea de estado/mensajes.

TRON
Mostrar cada comando Arexx enviado a YACDP en la línea de estado/mensajes.

TROFF
No mostrar comando Arexx en la línea de estado/mensajes.

LOCKVARS
Cuando lea variables que no son independientes de las demás, debe bloquearlas siempre antes de hacerlo. De otra forma sus contenidos pueden no ser fiables: por ejemplo si lee las variables RELBLOCK y TRACK sin bloquearlas previamente puede ocurrir que RELBLOCK tenga un valor demasiado alto, y entre la siguiente llamada de `GETVAR' la pista cambie, con lo que obtendría un valor de TRACK falseado. No bloquee las variables más que el tiempo estrictamente necesario. Esto asegurará que no se produzcan errores entre `LOCKVARS' y `UNLOCKVARS'.

UNLOCKVARS
La contrapartida de `LOCKVARS'. A cada llamada a`LOCKVARS' debe existir la correspondiente llamada a `UNLOCKVARS'.

GETVAR VAR/A,VARNAME,NUM/N/K,MODE/N/K [-,igual nombre que VAR,1,0]
Este comando le permite obtener los valores de algunas variables internas de YACDP. NUM sólo es empleado por algunas variables. Existen los siguientes tipos:

PUTVAR VAR/A,VALUE/A [-,-]
Este comando permite definir el valor (VALUE) de algunas variables (VAR) internas de YACDP. Vea más adelante.

WAIT BLOCK/N/A,FLAGS/N [-,0]
Este comando obliga a esperar que el bloque actual que se está reproduciendo sea mayor que BLOCK o que se cumplan algunas de las condiciones definidas por las banderas (FLAGS): vea a continuación la tabla. Puede comprobar ERR para saber qué bandera (condición) ha hecho terminar al comando WAIT.

Por ejemplo:

espera hasta que la ventana haya sido abierta: `WAIT 0 5'. de esta forma aguarda hasta que la ventana se abra o el bloque actual sea menor de cero (¡lo cual es imposible!).

espera hasta que se alcance el bloque 100000 en la reproducción o el CD se saque de la unidad o que se active la pausa en la reproducción o que se detenga ésta: `WAIT 100000 24704' (ya que 128+8192+16384=24704). Puede ser devuelto ERR 8192, con lo cual usted sabrá que el usuario ha solicitado una pausa en la reproducción.

espera a que se inserte un CD o un CD musical: `WAIT 0 321' (64+256+1=321). Nada que reseñar, salvo que ERR puede tomar el valor 320, si ambas condiciones son ciertas (por ejemplo si el usuario introduce un CD musical).

09. Compatibilidad con unidades de CD-ROM   Volver al Índice

10.- Aún pendiente: posibles planes futuros   Volver al Índice

reproducción de un rango A-B, 'cuing'.

posibilidad de guardar las preferencias del usuario para un CD específico, como las canciones favoritas, 'vía SCSI',...

añadir opción para reemplazar botones por una lista de opciones.

encontrar el valor óptimo de `Escalado del sonido'.

control "jog-shuttle".

interfaz gráfica (GUI) sensible al tipo de letra.

11.- ¿Cómo apoyar YACDP?   Volver al Índice

Aunque ya se haya registrado (¿aún no?) puede continuar ayudando en el desarrollo/mejora de YACDP de varias formas ...

Me gustaría que me escribiese indicándome lo contento que está con el programa o sus problemas con él, especialmente si su unidad de CD-ROM aún no está aún incluida en la lista de unidades compatibles o si tiene problemas no mencionados aquí. Por favor, incluya información sobre su modelo de Amiga y el fichero que se crea cuando activa el tipo de herramienta `TESTCDROM=RAM:CDROM.log'.

Si sabe que su unidad de CD-ROM es capaz de enviar datos de sonido por el bus SCSI, pero YACDP aún no la soporta puede solicitarle al distribuidor/fabricante información de cómo lo hace y enviármela. Intentaré soportar su unidad en la siguiente versión a distribuir.

Si ha creado ficheros de canciones para algunos CC.DD. podría enviármelos (mejor compactados con LHA y uuencodeados a mi dirección de correo electrónico) para que los incluya en futuras versiones.

Si ha escrito una macro Arexx y piensa que puede serle útil a otros usuarios, envíemela y también la incluiré.

Dígame qué más prestaciones querría que el programa tuviese además de las ya incluídas en mi lista de prestaciones «Aún pendientes».

12. Agradecimientos   Volver al Índice

Gracias a las siguientes personas por ayudarme a mejorar YACDP:

Muchas gracias también a:

Nico François por ReqTools 2.2

Jochen Wiedmann por FlexCat 1.3

Reinhard Spisser y Sebastiano Vigna por MakeInfo 1.49

13. Evolución histórica del programa   Volver al Índice

1.0

- Primera versión distribuída

1.1

- eliminado un error que provocaba que con algunos CD-ROM se informase de "INVALID FILED IN CDB" (fichero inválido en CDB) cuando se iniciaba la reproducción de la música.

- `vía SCSI' ahora funciona con unidades Toshiba (naturalmente sólo con las que soportan el envío de datos digitales a través del bus SCSI).

- la mayor parte de los botones ahora tienen atajos de teclado.

- volumen ahora ajustable.

- nuevo tipo de herramienta AMIGAVOL y CDROMVOL para definir el volumen inicial.

- el formato IFF ahora está mejor soportado.

- eliminado texto de error SCSI no referido a los CD-ROM.

- actualización de la lista de identificación de fabricantes.

- dispositivo ('device'), tarjeta ('board'), unidad ('unit'), LUN ahora son modificables desde el propio programa en ejecución,

- y por lo tanto, un parámetro de arranque incorrecto ya no hace que el programa termine.

- el tipo de herramienta EDITOR acepta ahora %S para aquellos editores que esperan patrones/comodines AmigaDOS.

- nuevo tipo de herramienta VIASCSI para chequear en el arranque del programa dicha prestación.

- nuevo tipo de herramienta AUDIOCHANNELS para especificar cual(es) de los cuatro canales de audio del Amiga serán empleados.

- nuevo tipo de herramienta AUTOSTART para iniciar la reproducción en cuanto un CD es insertado en la unidad.

- nuevo tipo de herramienta AUTOEJECT para expulsar el CD al terminar la reproducción.

- nuevo tipo de herramienta ALTERNATETIME (tiempo en formato 00:00:00)

- nuevo tipo de herramienta NOVIASCSI oculta el menú y desconecta el botón correspondiente, para usar sólo con unidades que soportan el envío de datos musicales por el bus SCSI.

- las ventanas ahora al abrirse están activadas.

- incluido el comando TestCDROM para simplificar los informes sobre errores (bugs).

1.2

- YACDP es ahora (¡sin recorte de prestaciones!) Shareware.

- reproducción `vía SCSI' ahora en estéreo.

- guardar sonidos IFF estéreo es ahora posible.

- añadido puerto AREXX y menú para macros AREXX.

- añadidos algunas detalles típicos de reproductores de CD musicales (modo "aleatorio" y modo "programa", repetir canción, repetir todo).

- añadido control deslizante de balance.

- el control deslizante de volumen ahora alcanza su valor máximo en el tope superior.

- soporte local para SO 2.1 y superiores (actualmente alemán)

- menús «new look» y puntero ocupado estándar para SO 3.0 y superior.

- botones embellecidos.

- documentación ahora en AmigaGuide®.

- mejor soporte de las unidades NEC de CD-ROM.

- antes cuando se empleaba `vía SCSI el campo scsi_Lenght era definido demasiado grande (se "perdía" memoria con algunos dispositivos scsi): ahora corregido.

- corregido un problema que existía con algunas versiones antiguas del dispositivo gvpscsi.device que devolvía IOERR_BADLENGTH cuando la longitud del buffer era impar.

- corregido el no soporte de multiselección en los menús.

- la prestación AUTOSTART no funciona en conjunción con CX_POPUP=NO.

- la ventana se ve mal por los tipos de letra de altura mayor de 8 puntos empleadas para el título.

- la forma de nombrar las canciones ha cambiado (el estilo antiguo aún es aceptado) y los ficheros de canciones han sido trasladados a un gran fichero de referencia ('hash'): consulte «Ficheros de canciones y referencia».

- los cambios en el fichero de canciones son mostrados inmediatamente (notificación de ficheros).

- el programa TestCDROM se ha integrado en el propio YACDP (tipo de herramienta TESTCDROM).

- el tipo de herramienta NOVIASCSI ha desaparecido, emplee en su lugar VIASCSIMODE=0.

- añadidos algunos nuevos tipos de herramienta y atajos de teclado (¡pruébelos!).

14. Ficheros de canciones y referencia   Volver al Índice

Un único nombre para cada CD

El programa genera un núnero único para cada CD, que es el utilizado para que el programa encuentre el fichero de canciones cada vez que el CD es reinsertado: dicho nº es creado a partir del nº de canciones que contiene éste y la longitud de las cuatro primeras, teniendo un aspecto similar a: `15000500000329000429000550'. Las versiones previas a la 1.2 empleaban el código de barras (UPC) del CD o un identificador construído a partir del nº de pistas, el tiempo total de reproducción y el tiempo de reproducción de la primera pista: sin embargo era un método que no me satisfacía por varias razones:

- algunos CC.DD. dan problemas para leer el código de barras (UPC o Universal-Product-Code: Código Universal del Producto)

- la lectura de dicho código detiene la reproducción si está en marcha y se necesita más tiempo que para la lectura del índice del CD (el cual está contenido en el buffer del CD-ROM).

- sólo algunos CC.DD. tienen código de barras.

- los CC.DD. que han sido vendidos juntos como un paquete tienen el mismo código de barras.

- el identificador es demasiado corto como para garantizar de que sea único para todos los CC.DD.

- el identificador creado contiene el carácter `|' que es usado para búsqueda por patrones por el AmigaDOS y puede confundir tanto a los editores como dificultar el procesado de dichos ficheros.

YACDP renombra automáticamente los nombres de ficheros que se empleaban antes (dicho nombre antiguo es colocado como comentario del fichero). Si aún tiene ficheros de canciones para enviarme, le pediría que me los volviese a enviar tan pronto como hayan sido renombrados (por favor preserve el comentario del fichero) y disculpe las molestias.

El fichero de referencia

El fichero de referencia o «hash» ha sido creado para ahorrar espacio y tiempo (¿¿¿incluso cuando se muestre un directorio con 100 ficheros???): le recomiendo que no incluya sus ficheros en el fichero de referencia hasta que tenga varios de canciones. Basta con que eche una mirada en el fichero `Songs/Index' si quiere saber lo que hay dentro del fichero de referencia.

Manipulando el fichero de referencia

El programa `MakeHash' incluido en el cajón `c/' es para manipular el fichero de referencia o «hash» y tiene la siguiente sintaxis:

FROMDIR,NUM/N/K,EX=EXTRACT/K,V=VERBOSE/S

FROMDIR

El directorio en el que colocará usted sus ficheros de canciones (por defecto será el directorio actual.)

NUM/N/K

La longitud de la tabla de referencia. Debe ser al menos tan grande como el número de ficheros que quiere almacenar.

EX=EXTRACT/K

Permite extraer ficheros de canciones del fichero de referencia. Extrae sólo los ficheros de canciones escritos por el autor que responden al patrón (`EXTRACT=#?' para todos).

V=VERBOSE/S

Muestra (¡mucha más!) información adicional.

Si desea actualizar el fichero de referencia, emplee el guión/script `c/Update'. El programa comprueba los comentarios para saber quien creó el fichero de la canción. También antes de la actualización puede ejecutar:

15. Autor   Volver al Índice

Dirección postal:

Frank Würkner
Georgenschwaigstr. 22
D-80807 München
Germany          «- Alemania

o

Vía Internet utilizando el correo electrónico (E-Mail):

[email protected]

16. Traducción al castellano versión 1.2 (20-MAY-96)   Volver al Índice

Este documento, basado en la versión AmigaGuide ya existente, es de copiado y distribución gratuita. No me hago responsable ni de la veracidad ni de una correcta traducción: la utilización de este documento es siempre bajo la responsabilidad del propio usuario asumiendo éste todos los riesgos (consulte la documentación original, por favor).

¡¡Sólo Amiga y nosotros lo hacemos posible!!