YACDP 1.2
"Yet Another CD Player"
("¡¡Otro Reproductor Más de CC. DD. musicales!!")

© 1994 Frank Würkner
Todos los derechos reservaos - All Rights Reserved

Traducción al español de Dámaso D. Estévez

01. Aspectos legales

x 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.

x ¿Por qué "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.

x ¿Cómo registrarse?

Basta con volcar por la impresora la 'Hoja de registro' ('Registration form') suministrada y rellenarla. Enviela 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

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

03. Requerimientos para poder ejecutar YACDP

• 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 de 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

• 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

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 estos son mostrados entre corchetes).

06. El interfaz gráfico (GUI)

a. Menú

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:

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

c. Textos

d. Botones

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

e. Lo que falta por explicar...

f. Manejo desde el teclado

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

07. Guardar audio como IFF o CDR

x. 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.

x 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 el formato de 8 bits y con una frecuencia máximo de muestreo de 28.867 Hz (más para los modelos Amiga ECS).

x Conversión del sonido

Bueno, ahora que 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

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

(*) la mayor parte de los reproductores rechazaran esta frecuencia
--lea el porqué en "Cómo esta 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 esta en formato IFF). Este formato puede ser usado para convertir el sonido a otros formatos empleando SOX (PLll, 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!):

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

Ambos canales son escritos por separado.

Nota: ¡Algunos reproductores no pueden manejar 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)')

solo 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 dividiendolo 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 reducidos a 127). En este caso el sonido suele habitualmente sonar mal.

- Los controles deslizantes del lado izquierdo representan la pista de inicio, el tiempo relativo 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

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

08. Puerto Arexx

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 'PLAYBACK 20', pero el CD solo dispones de 15 pistas, se tomará la decimoquinta 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:

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

• PLAYBACK BLOCK/N [primer bloque valido 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á.

• SHOW
  Mostrar interfaz gráfica (GUI).

• HIDE
  Ocultar interfaz gráfica (GUI).

• QUIT
  Salir del 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 una 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,BONTSHOW/S [ , ,0,-214783648,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/AMVARNAME,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 esta reproduciendo sea mayor que BLOCK o que se cumplan algunas de las condiciones defindas 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.