home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac11disk / m_player / mplyr_sp.doc < prev    next >
Text File  |  1989-06-07  |  16KB  |  426 lines
  1. ****************************************************************************
  2.             DOCUMENTACION M_PLAYER.PRG
  3. ****************************************************************************
  4.  
  5.         Es un reproductor Quick Time y AVI con sonido,
  6.         y un reproductor FLI/FLC/FLH, SEQ, PI1+DLT, FLM, DL, GIF, MPEG.
  7.          También puede crear ficheros  Quick Time (imágenes y sonido),
  8.              o ficheros AVI (imágenes y sonido),
  9.              o ficheros FLM (imágenes y sonido),
  10.                 o GIF animadas (sin sonido).
  11.  
  12.  
  13. *********************************************************************
  14. ATENCION: Cambio de resolución en el Falcon, ver al final de este DOC
  15. *********************************************************************
  16. ATENCION: TT sin tarjeta gráfica, ver al final de esto DOC
  17. *********************************************************************
  18.  
  19. Autor:
  20.  
  21. TELLO Guillaume
  22. 240 rue Estienvrin
  23. 49260 Montreuil Bellay
  24.       FRANCIA
  25.  
  26. Email: gtello@planete.net
  27.  
  28. Descargar M_PLAYER de:
  29.     http://www.planete.net/~gtello (mi página)
  30.     http://www.tripnet.se/~mille
  31.     http://www.magmacom.com/~nima
  32.         ftp://193.190.205.13/Archive/atari
  33.     http://www.allatsea.demon.co.uk
  34.  
  35.         (Igualmente encontrarás también la versión STE).
  36.  
  37. ********** Shareware ****************
  38.  
  39.     Si quieres registrarte, por favor envía 15DM, CAN$15, US$10, 60F
  40. o 7UKP a mi cuenta bancaria o a mí.
  41.     Crédit Agricole Anjou Mayenne/49000 Angers (Francia)
  42.     Cuenta n°10434852000
  43.  
  44.     Usuarios Norteamericanos, podeis registraros (US$10) en:
  45.  
  46.     Nima Montaser          Hardware and Software Specialists
  47.     Homa Systems House       ATARI Graphics and Multimedia
  48.        P.O. Box 52127          nima@magmacom.com
  49.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  50.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  51.                URL: http://www.magmacom.com/~nima
  52.  
  53.         Usuarios de Reino Unido, os podeis registrar (7UKP o mas) en:
  54.  
  55.         Antony Lacey   (algy@allatsea.demon.co.uk)
  56.     59 Owenford Road
  57.     Radford
  58.     Coventry CV6 3FQ
  59.     England
  60.  
  61.  
  62.              C O N S I D E R A C I O N E S   G E N E R A L E S
  63.              *************************************************
  64.  
  65. Capacidades:
  66. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  67.     1) Puedes crear animaciones Quick Time de una serie de imágenes
  68. (opcionalmente con sonido), los formatos de las imágenes son:
  69.         - TGA2 16 o 24 bits (a compresión RLE16)
  70.         - IMG ('ximg', 256 colors) (a compresión RLE8)
  71.         Los formatos de sonido son:
  72.         - AVR, 8/16 bits, mono/estereo
  73.         - WAV, 8/16 bits, mono/estereo
  74.     (ver mas abajo los ficheros BATCH y SLIDSHOW.DOC)
  75.  
  76.         2) Puedes crear animaciones Video for Windows (AVI) de una serie
  77. de imágenes (opcionalemente con sonido), los formatos de las imágenes son:
  78.         - IMG ('ximg', 256 colores) (a compresión  RLE8)
  79.     Los formatos de sonido son:
  80.         - AVR, 8/16 bits, mono/estereo
  81.         - WAV, 8/16 bits, mono/estereo
  82.         - QuickTime VR/1 extension para Interactive Movie
  83.     (ver mas abajo los ficheros BATCH y SLIDSHOW.DOC)
  84.  
  85.     3) Puedes crear GIF animados de una serie de imágenes GIF
  86. (87a u 89a):
  87.         - M_PLAYER extensión con el número de frames
  88.         - DELAY extensión con las infos de tiempo
  89.         - NETSCAPE extensión con los infos de los bucles
  90.     (ver mas abajo los ficheros BATCH y SLIDSHOW.DOC)
  91.  
  92.     4) Puedes crear ficheros extendidos FLM de una serie de dibujos
  93. ST en baja, con sonido opcional:
  94.         - Imágenes DEGAS (320x200x16)
  95.         - Imágenes NEO (320x200x16)
  96.         - Sonidos AVR/WAV (frec. DMA +/-2%, 8bits, mono/estereo)
  97.  
  98.     5) Puedes reproducir 12 tipos de animaciones:
  99.     - *.MOV (Quick Time)
  100.         - gráficos con:
  101.             CVID (yuv comprimido)
  102.             RLE1, RLE2 (gris o color), RLE4 (gris o color),
  103.             RLE8 (gris o color), RLE16, RLE24, RLE32
  104.             SMC8 (gris o color)
  105.             RAW1, RAW2 (gris o color), RAW4 (gris o color),
  106.             RAW8 (gris o color), RAW16, RAW24, RAW32
  107.             RPZA (15 bits)
  108.             WRLE (256 coloros)
  109.             MSVC8 (gris o color) MSVC16
  110.             YUV2, YUV9, YVU9 (yuv no comprimido)
  111.         - sonidos mono/stereo, 8/16 bits con formatos TWOS o RAW
  112.         - cambio para sincronización imagen-sonido
  113.         - cambio para sonido
  114.     - *.AVI (Video for Windows)
  115.         - gráficos con:
  116.             CVID
  117.             CRAM16, CRAM8
  118.             MSVC16, MSVC8
  119.             RLE8
  120.             RGB8
  121.             YUV9, YVU9
  122.             (no IV32, lo siento, está con copyright de Intel
  123.             y cuesta $5000 conseguir la licencia, contra menos
  124.             que lo uses mejor).
  125.         - sonido mono/stereo, 8/16 bits con formatos TWOS o RAW
  126.         - cambio para sincronización imagen-sonido
  127.         - cambio para sonido
  128.  
  129.     - *.MPG (MPEG)
  130.         - Video MPEG 1 und MPEG 2
  131.         - no sonido
  132.  
  133.     - *.FLI/FLC/FLH (Autodesk Animator)
  134.     - *.SEQ        (Cyber Paint)
  135.     - *.PI1 + *.DLT    (Cyber)
  136.     - *.FLM        (Kinetic Microsystems)
  137.     - *.FLM        (Lexicor)
  138.     - *.DL        (tipos 1 y 2)
  139.         - solo gráficos
  140.         - velocidad normal o velocidad maxi
  141.         (para PI1 + DLT, debes seleccionar el fichero PI1, luego
  142.         el fichero DLT de compartir el mismo nombre y estar en el
  143.         mismo directorio: c:\EJEMPLO.PI1 y c:\EJEMPLO.DLT)
  144.  
  145.     - *.FLM     (Lexicor FLM extendido)
  146.         - imágenes 320x200x16, 640x480x16 o 640x400x2
  147.         - sonido DMA 8 bits mono/estereo a 12017, 25033 o 50066 KHz
  148.         - duración independiente para cada frame
  149.  
  150.     - *.FLM        (Video Master V1.0)
  151.         - imágenes 160x100x16 (VMAS)
  152.         - imágenes 160x100x256 (VFAL)
  153.         - sonido 8 bits, mono, cualquier frecuencia
  154.  
  155.     - *.GIF        (Compuserve, 87a y 89a)
  156.         - sincronismo o no con pausas (versión 89a)
  157.         - número de frames mostrado solo en el diálogo stats.
  158.  
  159.     - modo paso a paso
  160.         - todos los frames mostrados (auto o no)
  161.         - se puede grabar este frame en un fichero TGA (auto o no)
  162.         - no funciona con NOVA o 256 colores en TT
  163.  
  164.     - *.BAT (fichero Batch para slideshow):
  165.         - lenguaje simple para cargar y mostrar una serie de
  166.           imágenes
  167.         - formato imagent:
  168.             TGA 2 sin comprimir (por ejemplo tus
  169.                 creaciones POV)
  170.             IMG ('XIMG' y 256 colores)
  171.             GIF (87a o 89a, 256 colores máximo)
  172.             PI1 (DEGAS 320x200x16)
  173.             NEO (Neochrome 320x200x16)
  174.                 se añadirán mas formatos en el futuro
  175.                 (ver SLIDSHOW.DOC)
  176.  
  177.  
  178. Requisitos hardware:
  179. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  180.     - Atari TT030:
  181.         - soporta tarjetas gráficas:
  182.             - NOVA (256 o 32768 colores)
  183.             - Crazy Dots1/2 (256 o 32768 colores)
  184.             - Matrix (256 colores)
  185.             - Cyrel (256 colores)
  186.         - sin tarjeta gráfica (256 colores)
  187.  
  188.     - Falcon, True Color (32768 colores) cualquier cantidad de
  189.       memoria RAM (soporta: Outside, Afterburner 040, ScreenBlaster,
  190.       Blow up, Centurbo I)
  191.     - PowerBook con MagicMac (256 colores, sin sonido...)
  192.     - HADES 040/060 con SONIDO, pero el del viejo Yamaha...
  193.  
  194.  
  195. !Maldita sea¡ Tengo 16Mb de RAM TT y el sonido DMA no puede ser reproducido
  196. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  197.  
  198.     Bien, deberías activar las banderas del programa 'TT Load' y
  199. 'TT Malloc' para mantener la mayor cantidad de ST RAM libre. Entonces
  200. la RAM TT es usada para cargar los datos de sonido que queden si no
  201. caben todos en la RAM ST. Mientras se reproduce, estos datos son copiados
  202. en la RAM ST por bloques hasta el final de la animación. Una copia de
  203. 1.5Mb tarda unos 0.5seg. Puede que obtengas algunos pequeños agujeros de
  204. sonido mientras son copiados.
  205.  
  206.          E J E C U T A N D O   E L    P R O G R A M A
  207.          ********************************************
  208.  
  209. Los ficheros:
  210. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  211.     M_PLAYER.PRG    ; e programa
  212.     M_PLAYER.RSC    ; los diálogos (poner en la misma carpeta)
  213.     MPLYR_FR.DOC    ; documentación en francés
  214.     MPLYR_EN.DOC    ; documentación en inglés (Gracias Dave!)
  215.     MPLYR_GE.DOC    ; documentación en alemán (Gracias Martin)
  216.     MPLYR_SV.DOC    ; documentación en sueco (Gracias Mille)
  217.     MP_ICONS.RSC    ; 4 iconos para el desktop por Julien Chauveau
  218.     SLIDSHOW.DOC    ; ficheros batch y MOV-Maker
  219.     HISTORIC.TXT    ; la historia
  220.     COMMANDS.DOC    ; las opciones de la línea de comandos (modo TTP)
  221.  
  222. Funcionando:
  223. ¨¨¨¨¨¨¨¨¨¨¨¨
  224.     Puedes hacer doble-click en él (entrando en el selector de
  225. ficheros), aquí puedes especificar el nombre del fichero o una máscara
  226. (*.MOV).
  227.     También puedes arrastrar y dejar una animación en él (con esto
  228. el selector de ficheros será evitado).
  229.  
  230.     Primer diálogo:
  231.  
  232.     1) La primera parte indica el nombre y el tipo de fichero
  233. detectado.
  234.  
  235.     2) La caja verde da información sobre los datos de video (tamaño,
  236. número de frames, compresión) y si la compresión es soportada o no. Si
  237. solo has elegido un fichero de sonido obtendrás un mensaje diciendo
  238. 'No graphics found' (no se encotraron gráficos). Este diálogo también
  239. indica si el formato de video es soportado o no. Si no es soportado,
  240. M_PLAYER reproducirá cualquier dato de sonido que pueda estar presente,
  241. pero no así el video.
  242.  
  243.     3) La caja naranja da información sobre el sonido (frecuencia,
  244. resolución, canales). Algunas frecuencias y resoluciones (4bits) no
  245. están soportadas. Algunas veces tendrás el mensaje 'Supported' (soportado)
  246. pero no obtendrás ningún sonido, esto significa que el sistema se ha
  247. quedado sin memoria. Si no hay ningún dato de sonido obtendrás el mensaje
  248. 'No Sound' (sin sonido). El fichero será reproducido pero solo el video.
  249.  
  250.         4) La caja 'Play Sound' (reproducir sonido) selecciona/deselec-
  251. ciona la reproducción de sonido (sujeto a que los datos de sonido estén
  252. presentes, por supuesto.
  253.  
  254.         5) La caja 'Synchronize' selecciona/deselecciona la sincroniza-
  255. ción entre sonido y video (por supuesto, sujeto a que los datos de sonido
  256. y video estén presentes).
  257.  
  258.     4b) 'Max speed' (velocidad máxima) es un interruptor para mostrar
  259. los frames FLx/SEQ sin ninguna pausa entre ellos.
  260.  
  261.     5b) FLx: sino (cuando 'Max speed' no ha sido establecidad), puedes
  262. elegir aquí la velocidad correcta en frames por segundo.
  263.  
  264.     6) 'Informations...' (informaciones) da informaciones.
  265.  
  266.     7) 'Go!' empieza la animación. Si los datos de sonido necesitan
  267. ser cargados, la reproducción se pospondrá y verás una caja de diálogo
  268. con el mensaje 'Loading sound...' (cargando sonido).
  269.         Si "(Alt) Go!" está disponible y lo usas, entrarás en el modo
  270. paso a paso (ver mas abajo).
  271.     Con un fichero BATCH, la tecla 'Alt' cambia entre slide-show
  272. y crear una animación.
  273.  
  274.     8) 'Cancel' justamente hace eso.
  275.  
  276. QuickTime VR/1
  277. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  278.     Those anims are a set of views (and even animated views) that the
  279. user can visit by driving the display with the arrow keys and eventually
  280. the SHIFT key to go faster.
  281.     One more dialog is opened to indicate what movements are available
  282. on this movie (horizontally, vertically or both). This format allows, for
  283. example, to view an object from every angle around it.
  284.  
  285. Estadísticas:
  286. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  287.     Al final de la animación, aparecerá una caja con las estadsiticas.
  288. Si la animación solo es un fichero de sonido, se evitará esta caja:
  289.     * Frames totales: el número de frames en el fichero.
  290.     * Frames mostradas: el número de frames actualmente mostradas
  291. (100% sin sincronización de sonido, algunas veces menos con sincronización
  292. debido a que algunas son saltadas para 'seguir' el sonido).
  293.     * Tiempo total: la duración de la animación en segundos.
  294.     * Media: número de frames actualmente mostrados cada segundo.
  295.  
  296. Saliendo del programa:
  297. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  298.     Si has empezado con el selector de ficheros, volverás a él
  299. después de cada animación. Debes de elegir 'cancel' del selector para
  300. salir. Con arrastrar y tirar, volverás de forma automática al desktop.
  301.  
  302. ¿Cómo detener una animación?
  303. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  304.     Con la tecla 'Control' (no habrá caja de estadísticas).
  305.     Con SHIFT y con una animación con blucle (GIF por ejemplo), el
  306. visionado es detenido al final del bucle actual y obtienes la caja de
  307. estadísticas.
  308.  
  309.  
  310. Modo paso a paso
  311. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  312.     ** Selector de ficheros **
  313.  
  314.     Debes especificar la ruta donde los ficheros TGA deben de ser
  315. almacenados, su nombre por defecto es:
  316.     FRM00001.TGA (hasta 99999 ficheros diferentes).
  317.     Puedes cambiar los primeros 7 caracteres introduciéndolos por
  318. el campo 'File name' del selector de ficheros. Sustituirán 'FRM'.
  319.  
  320.     ** Mini menú **
  321.  
  322.     (S) save: almacena el frame actual
  323.     (A) all : almacena todos los frames (empezando por el actual),
  324.     puedes detenerlo con la tecla Control.
  325.             (una campana durante la grabación indica un error de
  326.             escritura, puede que el disco esté lleno o cualquier
  327.             otra cosa)
  328.     (Q) quit: salir
  329.     Esc    : igual que arriba
  330.     (R) run    : muestra de forma automática los frames hasta el uso
  331.     de la tecla Control.
  332.     Other   : cualquier otra tecla avanza un paso en el fichero.
  333.  
  334.     ** Ficheros TGA **
  335.  
  336.     formato: TGA 2 sin comprimir, cabecera de 18 bytes de largo:
  337.  
  338.     Long $00000200
  339.     Long $00000000
  340.     Long $00000000
  341.     Word width    (Intel)
  342.     Word height    (ídem)
  343.     Word $1820
  344.     Entonces la línea pixel con 3 bytes por pixel:
  345.     Azul/Verde/Rojo.
  346.  
  347.  
  348.         A L G U N A S   P R E G U N T A S
  349.         *********************************
  350.  
  351. ¿Cómo fué realizado?
  352. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  353.     Usé ASSEMBLE  (Brainstorm), el mejor y mas rápido ensamblador
  354. que he conocido.
  355.  
  356. Frecuencias
  357. ¨¨¨¨¨¨¨¨¨¨¨
  358.     Los fichero de MAC o PC usan principal una de estas tres
  359. frecuencias: 11kHz, 22kHz o 44kHz. Cuando M_PLAYER carga el sonido,
  360. realiza una conversión de frecuencia para obtener 12,5kHz o 25kHz o 50kHz
  361. que son las frecuencias DMA (cada una 8 bytes por bloque, se repite el
  362. último byte con lo que se consiguen 9 bytes y eso es todo).
  363.  
  364. ¿Errores?
  365. ¨¨¨¨¨¨¨¨¨
  366.     - Metado ya funciona (versión 2.70)
  367.     - La animación es mas larga que en la pantalla (puedes probarlo,
  368. puede que bloquee la máquina), usa una pantalla virtual.
  369.     - Corregido el error Turbo Veille (V1.36).
  370.     - Corregido el error Extendos (V1.36, gracias a Yu-Ou Wang)
  371.     - Corregido el error Freedom (V2.05)
  372.     - FPATCH2.PRG puede corregir algunos problemas de sonido.
  373.  
  374.     Gracias a:
  375.  
  376.     - Pascal Ricard (Pierrevert, Francia, Falcon 4Mo)
  377.     - Julien Chauveau (Méron, Francia, Falcon 4Mo)
  378.     - Hervé Piedvache (Paris, Falcon 4Mo)
  379.     - Dave Brook (Stony Sratford, Reino Unido, TT 20Mo + Crazy Dots 2)
  380.     - Magnus Kollberg (Suecia, Falcon 4Mo)
  381.     - Martin Rothaemel (Alemania, TT 8Mo + NOVA)
  382.     - Yu-Ou Wang (Paris, Falcon 40MHz)
  383.     - Oliver Skelton (South Croydon, GB, Falcon + BlowUp Hard 1)
  384.     - Jacobo Morro (España, Falcon)
  385.     - Rémi Vanel (Francia, Falcon)
  386.  
  387.  
  388. *********************************
  389. Cambio de resolución en el Falcon
  390. *********************************
  391.  
  392.     El program, si no es ejecutado en True Color, cambia a TC para
  393. mostrar la animación. No doy ninguna garantía sobre la seguiridad de mi
  394. rutina, no pagaré por ningún daño causado a tu monitor (la rutina ha sido
  395. probada con éxito en los modos 16 y 256 colores, no funciona en modos
  396. monocromo o 4 colores).
  397.  
  398.     La única forma para evitar este cambio es ejecutar M_PLAYER en
  399. modo TC desde el desktop.
  400.  
  401.     Si tu monitor hace un 'clunk' en cada cambi de resolución,
  402. deberías de tener cuidado, si no lo hace y parece que lo soporta, bien,
  403. haz lo que quieras.
  404.  
  405. **********************
  406. TT sin tarjeta gráfica
  407. **********************
  408.  
  409.     El programa cambia a 320x480x256 para ver las animaciones. Si la
  410. altura lo permite, la animación es doblada para corregir el aspecto, si
  411. el ancho es mayor que 320 pixels, la imagen es reducida a la mitad:
  412. finalmente toda animación hasta 640x480 es aceptada.
  413.     Los límites son esos del NOVA en modo 256 colores:
  414.     - 16bits o animaciones TC son reproducidas en gris
  415.     - otras animaciones son reproducidas en colores (<=256)
  416.     - no admite modo paso a paso
  417.  
  418.     El visionado es un poco mas lento que con una tarjeta gráfica,
  419. debido a que en vez de ello escribe directamente en el video RAM, el
  420. programa usa un buffer el cual es recodificado bit a bit en la video
  421. RAM. Pero gracias a una rutina escrita por Douglas Little, la velocidad
  422. no es mala.
  423.     Para algunas animaciones específicas (SEQ, DLT, FLM, DL) una
  424. rutina adaptada al TT ha sido incluida, con lo que consigues una muy
  425. buena velocidad con estas animaciones.
  426.