<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kmid "<application>kmid</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="es">
<bookinfo>
<title>El Manual de KMid</title>
<authorgroup>
<author>
<firstname>Antonio</firstname>
<surname>Larrosa Jiménez</surname>
<affiliation>
<address><email><ulink url="mailto:larrosa@kde.org">larrosa@kde.org</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date>8/4/1999</date>
<releaseinfo>Version 1.7</releaseinfo>
<abstract>
<para>Este manual describe a KMid Version 1.7</para>
<para>KMid es un midi/karaoke multimedia player</para>
</abstract>
<keywordset>
<keyword>KMid</keyword>
<keyword>midi</keyword>
<keyword>karaoke</keyword>
<keyword>multimedia</keyword>
<keyword>mid</keyword>
<keyword>kar</keyword>
<keyword>player</keyword>
<keyword>music</keyword>
<keyword>sound</keyword>
<keyword>fm</keyword>
<keyword>awe</keyword>
<keyword>gus</keyword>
</keywordset>
</bookinfo>

<chapter id="introduccion">
<title>Introducción</title>

<para>KMid es el reproductor multimedia de ficheros midi y karaoke de KDE. Tiene algunas características, como gráficos en tiempo real e iluminación del texto de karaoke entre otras, imposibles de encontrar en cualquier otro reproductor midi del mundo unix.
KMid funciona en sistemas Linux y FreeBSD. Usa el driver de sonido OSS, con lo que debería funcionar en todos los sistemas donde se puede compilar KDE y OSS. KMid también soporta el driver del Linux Ultrasound Project, que se requiere para obtener algún sonido con tarjetas GUS. Tengo planeado el soporte del driver ALSA tan pronto como éste tenga soporte para dispositivos midi.</para>

<para>KMid muestra la letra de las canciones en pantalla, cambiando el color a la vez que suena la música, así, es muy fácil seguir la melodía de las canciones.</para>

<para>He incluido algunos ejemplos que por defecto se instalan en <literal remap="tt">$dollar;KDEDIR/share/apps/kmid</literal></para>

<para>Espero que te diviertas tanto usando KMid como yo me divertí desarrollándolo. </para>

<para><literal remap="tt">Antonio Larrosa Jim&eacute;nez</literal>
<ulink url="mailto:larrosa@kde.org">larrosa@kde.org</ulink></para>

<sect1 id="caractersticas-de-kmid">
<title>Características de KMid</title>

<para>Estas son algunas de las características mas importantes de KMid :</para>

<para><itemizedlist>
<listitem>
<para>Tiene un <emphasis remap="bf">interfaz de usuario</emphasis> muy <emphasis remap="bf">amigable</emphasis> para mostrar el karaoke con <emphasis remap="bf">iluminación en tiempo real</emphasis> de la letra.</para>
</listitem>
<listitem>
<para>Tiene una vista gráfica de lo que está tocando cada instrumento, iluminando las teclas presionadas en los teclados (virtuales).</para>
</listitem>
<listitem>
<para>El <emphasis remap="bf">Mapeador Midi</emphasis> mas potente que existe en cualquier sistema operativo.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Drag&amp;drop</emphasis> (arrastrar y soltar) para soltar en KMid los ficheros del KFM.</para>
</listitem>
<listitem>
<para>Puedes <emphasis remap="bf">cambiar el tempo</emphasis> de la canción para tocarla más lenta o más rápida a tu agrado.</para>
</listitem>
<listitem>
<para>Muestra luces para llevar el ritmo de la canción.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Fuentes personalizables</emphasis> para el karaoke.</para>
</listitem>
<listitem>
<para>Soporta los dos estandares para introducir letra en ficheros midi, eventos de lirica y eventos de texto (y adivina automaticamente cual es el que debe mostrar) .</para>
</listitem>
<listitem>
<para>Session Management. Si una cancion esta tocandose mientras sales del KDE, la proxima vez que entres, la cancion seguira tocandose.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Ajuste de volumen</emphasis> en tiempo real.</para>
</listitem>
<listitem>
<para>Puede tocar ficheros midi corruptos que hace que otros programas se bloqueen !</para>
</listitem>
<listitem>
<para>Puede abrir ficheros midi/karaoke comprimidos con <emphasis remap="bf">gzip</emphasis> exactamente igual que cualquier otro fichero.</para>
</listitem>
<listitem>
<para>Consume aproximadamente un <emphasis remap="bf">0.1&percnt;</emphasis> de mi <emphasis remap="bf">CPU</emphasis> (depende de la complejidad de la canci&oacute;n).</para>
</listitem>
<listitem>
<para>Soporta sintetizadores externos, AWE , FM y GUS (paara la ultima necesita el driver del Linux Ultrasound Project con el gusd instalado).</para>
</listitem>
<listitem>
<para>Se ejecuta en Linux y FreeBSD (quizas tambien en otros sistemas unix ...).</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="uso-general">
<title>Uso general</title>

<sect1 id="abriendo-canciones">
<title>Abriendo canciones</title>

<para>Hay muchas formas de abrir una canción. Puedes seleccionar <literal remap="tt">Abrir...</literal> del menu <literal remap="tt">Archivo</literal>, entonces aparecerá un dialogo estandard de abrir ficheros,
con el que podras seleccionar la cancion que desees abrir.</para>

<para>Puedes arrastrar un fichero desde una ventana de KFM y soltarlo en la ventana
de KMid (usando el llamado Drag&amp;Drop ) . También puedes arrastarar varios ficheros a la vez.</para>

<para>Si cuando ejecutes KMid, especificas un fichero en la linea de comandos, éste será abierto.</para>

<para>Y la última forma es seleccionando una canción de la lista de canciones de la colección activa.</para>
</sect1>

<sect1 id="reproduciendo-canciones">
<title>Reproduciendo canciones</title>

<para>Para tocar una canci&oacute;n, primero debes abrirla, y entonces pulsar en el
boton de <literal remap="tt">Reproducir</literal> de la Barra de Herramientas, o la entrada <literal remap="tt">Tocar</literal> del menu <literal remap="tt">Canción</literal>, o simplemente pulsar la barra espaciadora . Notese que cuando se abre un fichero usando Drag&amp;:Drop, KMid empezará a tocarlo inmediatamente (si se abre mas de un fichero, serán añadidos a una colección y tocados secuencialmente) .</para>

<para>Una vez que KMid está tocando una canción, puedes mover la barra del tiempo, pulsando con el segundo botón del ratón (el de en medio) para tocar desde una posición determinada.</para>

<para>Si una canción suena muy rápida o muy lenta, puedes usar las flechas de ambos lados del led del tempo y hacerla tocas más rápida o más lenta. Para volver al tempo normal, simplemente haz un doble click sobre el led del tempo.</para>

<para>La <literal remap="tt">barra espaciadora</literal> se usa para dos cosas, cuando la musica está
sonando y pulsas el <literal remap="tt">espacio</literal>, funcionara como si hubieras pulsado en el botón pausará la música . Si pulsas la <literal remap="tt">barra espaciadora</literal> cuando no
suena nada, se empezará a tocar la canción que esté abierta.</para>
</sect1>

<sect1 id="viendo-la-letra">
<title>Viendo la letra</title>

<para>Hay dos métodos para guardar la letra en un fichero midi, usando <literal remap="tt">eventos de Texto</literal> o <literal remap="tt">eventos de Lírica</literal>, algunas canciones usan el primero, otras, el segundo, algunas usan ambos métodos , y otras no incluyen letra :-) . KMid te permite elegir que eventos mostrar. O incluso mejor, tiene una opción que automagicamente selecciona el tipo de eventos que la canción usa, de forma que no tienes que elegirlo manualmente . De esta forma, si activas
la entrada <literal remap="tt">Elegir automaticamente evento</literal> del menú <literal remap="tt">Opciones</literal>, el
texto del karaoke sera seleccionado automaticamente, pero todavía podras cambiarlo por si prefieres ver el otro tipo.</para>

<para>Para seleccionar que tipo de eventos ver, puedes usar las correspondientes
entradas del menú <literal remap="tt">Opciones</literal>, o sólo pulsar las teclas <literal remap="tt">1</literal> y
<literal remap="tt">2</literal> de tu teclado para ver los <literal remap="tt">Eventos de Texto</literal> o de <literal remap="tt">Eventos de Lírica</literal> respectivamente.</para>
</sect1>
</chapter>

<chapter id="colecciones">
<title>Colecciones</title>

<para>Una colección es una lista de ficheros midi que se tocan secuencialmente
uno después de otro . Esta sección te ayudará a crearla, usarlas
y borrarlas . En la última sección de la ayuda, se dan algunos
consejos y trucos sobre las colecciones, para que se usen de forma óptima.</para>

<sect1 id="creando-una-coleccin">
<title>Creando una colección</title>

<para>Para crear una colección, primero abre el <literal remap="tt">Administrador de Colecciones</literal>,
seleccionando <literal remap="tt">Organizar ...</literal> del menú <literal remap="tt">Colecciones</literal> . Entonces pulsa en el botón <literal remap="tt">Nueva</literal>, y escribe el nombre que quieres que tenga la nueva colección.</para>

<para>También puedes copiar una colección completa seleccionándola y pulsando en el botón <literal remap="tt">Copiar</literal>, que te preguntará entonces por el nombre de la nueva colección que tendrá inicialmente las mismas canciones que la colección seleccionada.</para>

<para>Una vez que tengas mas de una colección, puedes cambiar la colección activa desde el <literal remap="tt">Administrador de Colecciones</literal>, seleccionandola .</para>
</sect1>

<sect1 id="la-coleccin-temporal">
<title>La Colección Temporal</title>

<para>La Colección Temporal es una colección que se usa para guardar temporalmente canciones que quieres escuchar, pero no quieres añadir a ninguna colección.</para>

<para>Esta colección <emphasis remap="bf">no se graba</emphasis> al salir de KMid, así que tenlo en cuenta cuando le añadas muchas canciones.</para>

<para>Continua leyendo esta sección para comprender mejor la Colección Temporal.</para>
</sect1>

<sect1 id="aadiendo-canciones-a-una-coleccin-cmo-usar-a">
<title>Añadiendo canciones a una colección (cómo usar 'AutoAñadir')</title>

<para>Hay algunas formas diferentes de añadir una canción a una colección .</para>

<para>Lo primero en todos los métodos es que debes haber seleccionado la colección
a la que quieras añadir las canciones, esto se hace en el <literal remap="tt">Administrador de Colecciones</literal>.</para>

<para>Entonces puedes pulsar en el botón <literal remap="tt">Añadir</literal> para añadir una canción. Aparecerá un diálogo de abrir fichero en el que podrás elegir la canción deseada.</para>

<para>El otro método de añadir una canción depende del estado de la opción <literal remap="tt">AutoAñadir</literal>.</para>

<para>Si <literal remap="tt">AutoAñadir</literal> está activada, cuando abras una canción (usando <literal remap="tt">Archivo &verbar; Abrir ...</literal> o Drag&amp;Drop), ésta será añadida a la colección activa, sin intervención del usuario . Si <literal remap="tt">AutoAñadir</literal> no está activa, cuando abras una canción, la Colección Temporal se activará y se vaciará, y los ficheros abiertos serán añadidos a ella.</para>
</sect1>

<sect1 id="borrando-canciones-de-una-coleccin">
<title>Borrando canciones de una colección</title>

<para>Para quitar una canción de una colección, simplemente abre el <literal remap="tt">Administrador de Colecciones</literal>, selecciona la colección apropiada y la canción que deseas borrar, y entonces pulsa en el botón <literal remap="tt">Quitar</literal>.</para>
</sect1>

<sect1 id="tocando-en-orden-o-aleatoriamente">
<title>Tocando en orden o aleatoriamente</title>

<para>Puedes seleccionar el orden en el que se van a tocar las canciones .
Cuando actives el <literal remap="tt">Modo ordenado</literal> del menú <literal remap="tt">Colecciones</literal>, las canciones
se tocarán en el mismo orden en el que fueron añadidas a la
colección . Cuando selecciones el <literal remap="tt">Modo aleatorio</literal> , KMid generará
una variable aleatoria discreta con una función de distribución
uniforme, para tocar de verdad aleatoriamente las canciones de la colección .
Dandole valores a la variable aleatoria, generará una lista en la que
se tocarán las canciones (aunque quieras tocar las canciones aleatoriamente,
seguro que no quieres que se toque una canción dos veces seguidas, y
que cuando pulses el boton de <literal remap="tt">Canción anterior</literal> toque la anterior, ¿ no ? :-) ).</para>

<para>La lista aleatoria en la que la colección se recorre, será regenerada cada vez que añadas o quites un fichero en la colección activa, y cuando se pulse en la entrada <literal remap="tt">Modo aleatorio</literal> del menú.</para>
</sect1>

<sect1 id="seleccionando-una-cancin-de-una-coleccin">
<title>Seleccionando una canción de una colección</title>

<para>Puedes seleccionar una canción en el <literal remap="tt">Administrador de Colecciones</literal>,
o usando la <literal remap="tt">combo box</literal> que hay sobre el texto del karaoke.</para>

<para>También puedes cambiar a la siguiente canción usando la entrada <literal remap="tt">Siguiente Canción</literal> del menú <literal remap="tt">Canción</literal>, el botón <literal remap="tt">Siguiente Canción</literal> de la barra de herramientas, o pulsando la tecla de <literal remap="tt">flecha a la derecha</literal>.</para>

<para>Para cambiar a la canción anterior, usa la entrada <literal remap="tt">Canción Anterior</literal>
del menú <literal remap="tt">Canción</literal>, el botón <literal remap="tt">Canción anterior</literal> de la barra de herramientas, o pulsa la tecla de <literal remap="tt">flecha a la izquierda</literal> de tu teclado.</para>
</sect1>

<sect1 id="borrando-una-coleccin">
<title>Borrando una colección</title>

<para>Para borrar una colección, simplemente abre el <literal remap="tt">Administrador de Colecciones</literal>, selecciona la colección que quieres borrar, y pulsa en <literal remap="tt">Borrar</literal>. Facil,
¿ no ?</para>

<para>Ten en cuenta que no puedes borrar la <literal remap="tt">Colección Temporal</literal>, ya que
de todas formas, no se graba cuando salgas de KMid .</para>
</sect1>
</chapter>

<chapter id="el-mapeador-midi">
<title>El Mapeador Midi</title>

<sect1 id="qu-es-un-mapa-midi-">
<title>¿ Qué es un mapa midi ?</title>

<para>Un Mapeador Midi es una herramienta que transforma unos eventos midi en otros.</para>

<para>Esto es muy totalmente necesario para los órganos que no comprendan los eventos estándares (o sea, si un teclado no es compatible General Midi), en este caso, el mapeador midi traducirá los eventos General Midi en eventos que ese órgano comprenda.</para>

<para>Por ejemplo, puedes hacer un mapeador midi que convierta todos los eventos del tipo <literal remap="tt">Usar el instrumento piano</literal>, por <literal remap="tt">Usar el instrumento trompeta</literal>, y asi cuando una canción intente tocar un piano, tocará una trompeta en su lugar.</para>

<para>Esto puede resultar extraño, ( ¿ Por qué tocar una trompeta cuando la canción intenta tocar un piano ? ), pero es muy útil . El estandar GM especifica que cuando un teclado midi recibe un evento para cambiar al instrumento <literal remap="tt">0</literal>, cambiará el instrumento actual a un <literal remap="tt">Gran Piano</literal>, pero un sintetizador antiguo cambiará a una <literal remap="tt">Guitarra Eléctrica</literal> cuando reciba un <literal remap="tt">0</literal>. Este teclado antiguo, necesita recibir un <literal remap="tt">3</literal> (por ejemplo) para cambiar a un <literal remap="tt">Piano</literal>. Y aquí se pone el mapeador midi en acción, cambiando todos los eventos de <literal remap="tt">Cambiar instrumento al 0</literal> por <literal remap="tt">Cambiar instrumento al 3</literal> y asi realmente tocar el instrumento correcto.</para>
</sect1>

<sect1 id="necesito-un-mapa-midi-">
<title>¿ Necesito un mapa midi ?</title>

<para>Brevemente, si no tienes un &oacute;rgano externo, NO.</para>

<para>Si sólo tienes una tarjeta de sonido, no necesitas mapeador midi puesto que todas las tarjetas de sonido son compatibles GM (incluyendo a las AWE, GUS, dispositivos FM, etc.).</para>

<para>Si estás tocando música a través de un órgano externo que no sea compatible GM, entonces necesitas hacer un mapeador midi para tu teclado midi .  Aunque estés toda una tarde haciendo un fichero de configuración y probando diferentes valores para todas las opciones, serás recompensado cuando lo termines, porque sólo entonces encontrarás todas las características que tu teclado tenía escondidas . Por ejemplo, yo tengo un Yamaha PSS-790, que no es compatible GM, y no tiene tantos instrumentos como un sintetizador GM, pero con el mapeador midi del KMid, suena incluso mejor que muchas tarjetas de sonido (incluyendo las AWE :-)), debido a la calidad de los sonidos que tiene un sintetizador externo (incluso en los antiguos que no son GM).</para>
</sect1>

<sect1 id="creando-un-mapa-midi">
<title>Creando un mapa midi</title>

<para>No hay ningún programa para generar mapas midi con lo que tendrás que editar el fichero a mano (usando tu editor de textos favoritos) . Un hecho que quisiera hacer notar es que mapa es una traducción mala de <literal remap="tt">map</literal>, pero en el fondo, tiene sentido y además se parece a la expresión inglesa <literal remap="tt">midi map</literal> con lo que usaré <literal remap="tt">mapa midi</literal> para referirme al fichero de configuración del mapeador midi.</para>

<para>Un mapa midi es un archivo de texto en el que se guardan todas las conversiones necesarias que se harán cuando se toque la música.</para>

<para>Consiste en varias secciones: <literal remap="tt">PATCHMAP</literal>, <literal remap="tt">KEYMAP</literal>, <literal remap="tt">CHANNELMAP</literal>, <literal remap="tt">OPTIONS</literal>.</para>

<para>Cada sección debe aparecer sólo una vez, excepto la sección <literal remap="tt">KEYMAP</literal> que puede aparecer tantas veces como sea necesario, siempre que en cada aparición use un identificador distinto (continua leyendo para mas detalles)</para>

<para>La estructura general de un fichero map es :</para>

<para><screen>DEFINE PATCHMAP
...
END

DEFINE KEYMAP "Nombre de un Keymap"
...
END

DEFINE KEYMAP "Otro Keymap"
...
END

DEFINE CHANNELMAP
...
END

OPTIONS
...
END
</screen>
</para>

<para>Puedes ver que la palabra <literal remap="tt">DEFINE</literal> se usa para especificar que sección
se va a empezar (excepto en <literal remap="tt">OPTIONS</literal>), y que <literal remap="tt">END</literal> se pone al final de cada sección.</para>

<para>Puedes poner comentarios comenzando la linea con un caracter <literal remap="tt">&num;</literal> .</para>

<para>Por favor, no olvides mandarme tu fichero de configuración del mapeador midi
para que así las versiones futuras de KMid incluyan soporte para más teclados
que no sean General Midi.</para>

<sect2 id="la-seccin-patchmap">
<title>La sección <literal remap="tt">PATCHMAP</literal></title>

<para>Esta sección se usa para especificar como se van a traducir los instrumentos, de GM a los requerimientos de tu teclado . El uso general es :</para>

<para><screen>(Nombre del instrumento GM)=(N) [AllKeysTo M]
</screen>
</para>

<para>Donde <literal remap="tt">N</literal> es el número que tu teclado necesita recibir para cambiar al
mismo instrumento al que cambia el estandar GM.</para>

<para>Por favor observa que la parte izquierda del signo igual es ignorada, asi que los instrumentos GM se suponen que van en orden (de 0 a 127), y no está permitido el cambiar el orden de las lineas, ni omitir ninguno de los 128 instrumentos.</para>

<para>La opción <literal remap="tt">AllKeysTo M</literal> se usa para mapear todas las notas que usen ese instrumento a la tecla <literal remap="tt">M</literal>. Por ejemplo, supongamos que tu teclado midi no tiene un sonido de 'Gun Shot' (sonido de disparo de pistola), que es el instrumento 127 según el estandar GM, asi que quieres mapearlo a un tambor de percusión (por ejemplo, la tecla 60), que suena similar a un disparo, entonces puedes poner esto en la linea 127 de la sección <literal remap="tt">PATCHMAP</literal> :</para>

<para><screen>Gunshot       =100 AllKeysTo 60
</screen>
</para>

<para>Asi cuando un fichero midi intente tocar una nota con el instrumento 127, será mapeado al instrumento 100 (suponiendo que ese sea el numero usado en tu teclado para el <literal remap="tt">instrumento de percusión</literal>) y tocará la nota 60 (independientemente de la tecla que fuera a ser tocada).</para>

<para>Nótese que cuando uso la expresión 'instrumento de percusión', me refiero al instrumento en el que cada tecla toca un tambor, platillo o caja de percusión distinto, y no a un posible sonido que algunos teclados tienen y que tocan un tono distinto del mismo instrumento de percusión con cada tecla.</para>
</sect2>

<sect2 id="la-seccin-keymap">
<title>La sección <literal remap="tt">KEYMAP</literal></title>

<para>La sección <literal remap="tt">KEYMAP</literal> se usa para especificar como se van a mapear las teclas, dentro de un canal o instrumento dado . El uso es :</para>

<para><screen>DEFINE KEYMAP "Nombre del Keymap"
C 0 =0
C#0 =1
D 0 =2
...
END
</screen>
</para>

<para>Igual que con la sección <literal remap="tt">PATCHMAP</literal>, es muy importante el orden de las lineas
y que estén todas las 128 teclas.</para>

<para>Como puedes definir varios 'keymaps' para diferentes canales e instrumentos,
debes darle un nombre distinto a cada uno en la primera linea.</para>

<para>Los mapas de teclas (Keymaps) se usan principalmente para mapear las teclas
en el canal de percusión . Hecha un vistazo a los mapas midi distribuidos
para ver algunos ejemplos.</para>
</sect2>

<sect2 id="la-seccin-channelmap">
<title>La sección <literal remap="tt">CHANNELMAP</literal></title>

<para>Esta sección se usa para intercambiar unos canales por otros . Por ejemplo,
si tu quieres cambiar el primer y el segundo canal, lo puedes hacer muy facilmente en esta sección.</para>

<para>De todas formas, es todavía mas útil, para los teclados que necesitan
que el canal de percusión esté en un determinado canal (el estandar GM usa
el canal 10, otros usan el 16 y otros el 9).</para>

<para>Nótese que los dispositivos midi usan 16 canales, así que la sección <literal remap="tt">CHANNELMAP</literal> tiene 16 lineas (de 0 a 15), como esta :</para>

<para><screen>(N) = (M) [Keymap "Nombre"] [ForcePatch x]
</screen>
</para>

<para>Donde <literal remap="tt">N</literal> es el canal que va a ser mapeado al canal <literal remap="tt">M</literal> .
Si se usa la opción <literal remap="tt">Keymap</literal>, el mapa de teclas con nombre <literal remap="tt">Nombre</literal> será usado en este canal (la sección Keymap debe haber sido definida <emphasis remap="bf">antes</emphasis> en ese fichero !) .
Si se usa la opción <literal remap="tt">ForcePatch</literal>, todos los eventos que intenten cambiar el instrumento que se usa en ese canal serán ignorados, y el instrumento <literal remap="tt">x</literal> será usado en su lugar.</para>

<para>La opción <literal remap="tt">ForcePatch</literal> es muy útil por ejemplo, para usar
siempre el instrumento de percusión en el canal de percusión.</para>
</sect2>

<sect2 id="la-seccin-options">
<title>La sección <literal remap="tt">OPTIONS</literal></title>

<para>La sección <literal remap="tt">OPTIONS</literal> tiene algunas opciones generales que pueden ser muy utiles :</para>

<para><screen>OPTIONS
PitchBenderRatio = r
MapExpressionToVolumeEvents
END
</screen>
</para>

<para>Puedes especificar ambas opciones, sólo una, o ninguna.</para>

<para>El valor de <literal remap="tt">r</literal> en <literal remap="tt">PitchBenderRatio</literal> , especifica la proporción por la que serán multiplicados los eventos de inflexión del tono (Pitch bender) .
O sea, cuando un fichero midi intenta mandar un evento de inflexión del
tono con un valor de <literal remap="tt">n</literal>, el valor que realmente será mandado será <literal remap="tt">n*(r/4096)</literal> (el <literal remap="tt">4096</literal> es para no tener que usar puntos decimales en el fichero map) .</para>

<para>Esta opción se usa porque el estandar GM dice que cuando un dispositivo midi recibe un evento de inflexión del tono con un valor de 4096, debe subir el tono a uno mas agudo, pero algunos teclados intentan subir el tono a dos o mas notas mas agudas ( incluso una octava mas aguda ! ) cuando reciben un 4096 .
Esto se arregla facilmente intentando distintos valores para que en vez de mandar un 4096, KMid mande el valor apropiado.</para>

<para>Cuando se especifica la opción <literal remap="tt">MapExpressionToVolumeEvents</literal> en el fichero map, y un fichero midi intenta mandar un evento de expresión, KMid mandará un evento de volumen que comprenden todos los teclados que no son GM, y que tiene un efecto muy parecido.
Hay muchos ficheros midi que usan eventos de expresión para ir bajando el volumen al final de la canción, asi que si tu crees que la música debería ir escuchandose cada vez mas baja, puedes activar esta opción y ver si es lo que necesitas,
porque posiblemente tu sintetizador midi, esté ignorando los eventos de expresión porque no los comprenda .</para>
</sect2>
</sect1>

<sect1 id="usando-mapas-midi">
<title>Usando mapas midi</title>

<para>Para usar un mapa midi, simplemente abre el diálogo <literal remap="tt">Configurar dispositivos Midi</literal> seleccionando la entrada <literal remap="tt">Configuración Midi ...</literal> del menú <literal remap="tt">Opciones</literal>.</para>

<para>Entonces pulsa en <literal remap="tt">Buscar ...</literal>, selecciona el fichero en el dialogo de abir
fichero y disfruta de la música ! :-)</para>
</sect1>
</chapter>

<chapter id="funciones-avanzadas">
<title>Funciones avanzadas</title>

<sect1 id="la-vista-de-canal">
<title>La Vista de Canal</title>

<para>La Vista de Canal es una ventana que muestra una lista de teclados (una para cada canal midi). En estos teclados se resaltan las notas que están siendo tocadas, para que puedas ver lo que está tocando cada instrumento.</para>

<sect2 id="cambiando-los-instrumentos">
<title>Cambiando los instrumentos</title>

<para>Puedes usar la Vista de Canal para cambiar el instrumento que cada canal está tocando. En cada canal hay un combo box donde puedes seleccionarlo . Una vez que lo has cambiado, el boton verde de al lado cambiará a rojo para indicar que no es el instrumento por defecto.</para>

<para>Si quieres volver a poner el instrumento por defecto, haz click en el botón rojo y se seleccionará el instrumento adecuado automaticamente</para>
</sect2>

<sect2 id="cambiando-el-modo-de-visualizacin">
<title>Cambiando el modo de visualización</title>

<para>La Vista de Canal tiene dos formas diferentes (por ahora) de dibujar las teclas que se tocan, puedes seleccionarla desde la entrada de <literal remap="tt">Opciones de Vista de Canal...</literal> en el menú <literal remap="tt">Opciones</literal>.</para>

<para>Puedes seleccionar entre un modo en el que las teclas tocadas se presionan, como si fuera un piano normal (<literal remap="tt">3D look</literal>), o un modo en el que las teclas se rellenan de rojo para ser reconocidas mas facilmente (<literal remap="tt">3D - relleno</literal>) . Si tocas el piano, o cualquier otro instrumento, puedes usar esta ventana para aprender a tocar una canción por tí mismo. Yo he usado esta técnica y (junto con una reducción del tempo) es fantástica para aprender una nueva composición.</para>
</sect2>
</sect1>

<sect1 id="el-led-del-tempo">
<title>El Led del Tempo</title>

<para>Este led muestra el tempo en el que se tocan las canciones, o sea, la velocidad de la canción. Cuanto más alto es éste número, más rápido se tocará la canción.</para>

<para>También puedes cambiar el tempo, así que si una canción va muy rápido para que puedas seguir la letra, puedes hacer que vaya mas lenta . Para cambiar el tempo, puedes usar las flechas que aparecen a ambos lados del led</para>

<para>Una vez que has cambiado el tempo, puedes volver a poner el tempo por defecto haciendo un doble click en el led.</para>
</sect1>
</chapter>

<chapter id="teclas">
<title>Teclas</title>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Barra Espaciadora</literal> - Toca la canción si no está ya tocandose, y la pausa si está tocandose</para>
</listitem>
<listitem>
<para><literal remap="tt">Retroceso (Backspace)</literal> - Parar de tocar</para>
</listitem>
<listitem>
<para><literal remap="tt">Flecha a la Derecha</literal> - Siguiente canción en la colección actual</para>
</listitem>
<listitem>
<para><literal remap="tt">Flecha a la Izquierda</literal> - Canción anterior en la colección actual
</para>
</listitem>
<listitem>
<para><literal remap="tt">Flecha Arriba</literal> - Desplaza la letra una linea arriba</para>
</listitem>
<listitem>
<para><literal remap="tt">Flecha Abajo</literal> - Desplaza la letra una linea abajo</para>
</listitem>
<listitem>
<para><literal remap="tt">Página Arriba</literal> - Desplaza la letra una página arriba</para>
</listitem>
<listitem>
<para><literal remap="tt">Página Abajo</literal> - Desplaza la letra una página abajo</para>
</listitem>
<listitem>
<para><literal remap="tt">1</literal> - Muestra los eventos de texto</para>
</listitem>
<listitem>
<para><literal remap="tt">2</literal> - Muestra los eventos de lírica
</para>
</listitem>
<listitem>
<para><literal remap="tt">Ctrl-O</literal> - Abre una canción</para>
</listitem>
<listitem>
<para><literal remap="tt">Ctrl-Q</literal> - Sale de KMid</para>
</listitem>
<listitem>
<para><literal remap="tt">F1</literal> - Abre esta ayuda</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="instalacin">
<title>Instalación</title>

<sect1 id="como-obtener-kmid">
<title>Como obtener KMid</title>

<para>KMid es una aplicación del núcleo del proyecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
KMid se encuentra en el paquete KDEmultimedia, que está en <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, el nodo ftp del proyecto KDE. También puedes cargarlo de cualquiera de los muchos mirrors, cuya lista está en <ulink url="http://www.kde.org/mirrors.html">http://www.kde.org/mirrors.html</ulink>.</para>

<para>Además, KMid tiene una homepage, que está en <ulink url="http://www.arrakis.es/~rlarrosa/kmid.html">http://www.arrakis.es/~rlarrosa/kmid.html</ulink>. Desde allí puedes cargar la última versión, seguir el desarrollo, ver información, fotos, una lista de páginas de donde cargar más canciones, etc.</para>
</sect1>

<sect1 id="requerimientos">
<title>Requerimientos</title>

<para>KMid requiere para funcionar:</para>

<para><itemizedlist>
<listitem>
<para>KDE 
Bueno, supongo que ya tienes esto :-)
</para>
</listitem>
<listitem>
<para>Una tarjeta de sonido 
Se recomienda una buena tarjeta de sonido y/o un sintetizador externo, ya que la calidad del sonido depende enormemente de la tarjeta de sonido, no es lo mismo tocar música usando un dispositivo FM, que usando una AWE.</para>

<para>Si no tienes tarjeta de sonido, todavía puedes compilar KMid con <literal remap="tt">MODE&lowbar;DEMO&lowbar;ONLYVISUAL</literal> definido y se ejecutará como si tuvieras una (pero sin sonido, por supuesto :-( ). </para>

</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="compilacin-e-instalacin">
<title>Compilación e instalación</title>

<para>Si cargaste el paquete KDEmultimedia, o sólo el KMid, para compilarlo, debes ejecutar <literal remap="tt">configure</literal>, entonces <literal remap="tt">make</literal> y entonces, para instalarlo, <literal remap="tt">make install</literal> (probablemente, como root).</para>

<para>Si encuentras algún problema, no dudes en contactar con cualquiera de las listas de correo de KDE (sólo en inglés), o en mandarme un mensaje directamente a mí.</para>
</sect1>
</chapter>

<chapter id="preguntas-frecuentes-faq">
<title>Preguntas Frecuentes (FAQ)</title>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">P:</literal> ¿ Qué es exactamente un fichero midi ?
<literal remap="tt">R:</literal>Un fichero midi es un fichero que contiene la información necesaria para tocar una canción, o sea, contiene las notas, el ritmo, la velocidad, etc. Basicamente, se puede decir que contiene la partitura de la canción.
Esto implica que un mismo fichero midi puede sonar muy distinto cuando se toca en dos dispositivos distintos, de igual manera que una misma partitura puede sonar muy distinta cuando la tocan dos músicos distintos
</para>
</listitem>
<listitem>
<para><literal remap="tt">P:</literal>Consigo más calidad con mi reproductor de mp3/wav, ¿por qué debería usar KMid?
<literal remap="tt">R:</literal>Bueno, no puedo forzar a nadie a usar KMid, pero un fichero midi normal ocupa 50 Kb. mientras que un fichero mp3 típico ocupa los 4 Mb. (y eso es un radio de compresión de 1:80 :-) . Y con un buen sintetizador puedes conseguir una calidad de sonido comparable. Además, en un fichero midi, puedes cambiar los instrumentos individuales, cambiar la velocidad de la canción, etc. con lo que tienes mas control sobre todo. 
</para>
</listitem>
<listitem>
<para><literal remap="tt">P:</literal>No puedo hacer funcionar mi tarjeta AWE con KMid, ¿qué puedo hacer ?
<literal remap="tt">R:</literal>Esto puede suceder por obtener una distribución binaria de KMid (en rpm o deb por ejemplo) que fue compilada sin soporte para AWE. Si no funciona, debes cargar una distribución en código fuente y compilarlo tu mismo (por ejemplo, de <ulink url="http://www.arrakis.es/~rlarrosa/kmid.html">La p&aacute;gina de KMid</ulink>)
</para>
</listitem>
<listitem>
<para><literal remap="tt">P:</literal>Quiero añadir un directorio completo a una colección, pero tener que añadir los ficheros midi uno a uno no es divertido.
<literal remap="tt">R:</literal>Estoy de acuerdo, por eso KMid soporta Drag&amp;Drop. Simplemente abre, en KFM, el directorio que quieras añadir, selecciona todos los ficheros, cógelos, y suéltalos en KMid.
Asegúrate de haber seleccionado la opción <literal remap="tt">AutoAñadir</literal> antes, para que los ficheros se añadan a la colección actual. Si no lo hacer, los ficheros serán añadidos a la Colección Temporal.
</para>
</listitem>
<listitem>
<para><literal remap="tt">P:</literal>No puedo seguir la letra, va muy rápido !
<literal remap="tt">R:</literal>Puedes pulsar en la flecha izquierda del led del tempo para hacer que vaya más lenta. Recuerda que puedes hacer un doble click sobre el led para volver al tempo por defecto.</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="para-terminar">
<title>Para terminar</title>

<sect1 id="algunos-trucos">
<title>Algunos trucos</title>

<para>Incluiré aquí algunos trucos para que le puedas sacar todo el provecho a las características de KMid :</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Abriendo ficheros</emphasis></para>

<para>Yo siempre tengo un escritorio virtual con una ventana de KFM en el
directorio de mi colección de midis, y KMid en ese escritorio (si está
tocando un fichero midi) o pegado/sticky (si esta tocando un karaoke :-)),
de esta forma cuando la colección activa termina, o quiero escuchar
algún fichero en particular, simplemente voy a la ventana del KFM,
selecciono los ficheros que sean, y hago Drag&amp;Drop a la ventana de KMid.</para>

<para>Supongamos que quieres tocar unos ficheros midi, pero no quieres
añadirlos a ninguna colección, sólo desactiva el <literal remap="tt">AutoAñadir a Colección</literal> del menú <literal remap="tt">Colecciones</literal> y abre los ficheros, estos serán añadidos a la Colección Temporal .</para>

</listitem>
<listitem>
<para><emphasis remap="bf">Otro método para crear una nueva Colección</emphasis>
Supongamos que tienes tres ficheros midis A.mid , B.mid y C.mid .
Al principio solo quieres tocar el primer fichero, asi que desactivas el
<literal remap="tt">AutoAñadir</literal> y abres A.mid . Tienes la Colección Temporal con sólo un fichero.</para>

<para>Entonces decides escuchar también B y C, y hacer una colección con todos ellos, ¿ que haces ?</para>

<para>Fácil, selecciona <literal remap="tt">AutoAñadir</literal> y abre B.mid y C.mid (por cualquiera
de los muchos métodos), entonces, serán añadidos a la
Colección Temporal, que tendrá entonces A.mid, B.mid y C.mid .
En este punto, puedes abrir el <literal remap="tt">Administrador de Colecciones</literal>, seleccionar
la Colección Temporal, pulsar en el botón <literal remap="tt">Copiar</literal> , poner
el nombre de la nueva colección, y ya has acabado . Ya tienes una nueva
colección que tiene los ficheros A, B y C y que no se borra
cuando cierres KMid .</para>

</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="saln-de-los-amigos-de-kmid">
<title>Salón de los amigos de KMid</title>

<para>Estos son algunos amigos que me han enviado ficheros midi o postales, gracias a todos !
Escuchar estas canciones y ver las postales me animará a continuar desarrollando KMid.</para>

<para><itemizedlist>
<listitem>
<para>Ola Sigurdson  - <literal remap="tt">Taking Care of Business</literal> (Bachman Turner Overdrive)</para>
</listitem>
<listitem>
<para>EG Lim - Una postal preciosa de Penang</para>
</listitem>
<listitem>
<para>Guenther Starnberger - <literal remap="tt">Amadeus</literal> (Falco) y <literal remap="tt">Schrei Nach Liebe</literal> (Die Aerzte).</para>
</listitem>
<listitem>
<para>Leandro Terr&eacute;s - <literal remap="tt">All That She Wants</literal> y <literal remap="tt">The Sign</literal> (Ace of
Base)</para>
</listitem>
<listitem>
<para>Nick Stoic - Dos ficheros midi </para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="sobre-el-autor">
<title>Sobre el autor</title>

<para>KMid ha sido desarrollado por Antonio Larrosa Jiménez, en Málaga (España) .
Soy estudiante de Matemáticas en la Universidad de Málaga, actualmente estoy haciendo el tercer curso, con lo que no tengo mucho tiempo libre para mis hobbies, pero siempre intento conseguir alguno :-) . Mis hobbies incluyen : Programar, coleccionar ficheros midi, tocar música y probar teoremas inútiles ;-) .</para>

<para>Si quieres saber de donde conseguir ficheros midi/karaoke, tienes alguna
pregunta, un fallo que comunicar, una idea o caracter&iacute;stica que quisieras ver en KMid, o solo quieres alegrarme el dia, no te cortes y m&aacute;ndame
un email a : <ulink url="mailto:larrosa@kde.org">larrosa@kde.org</ulink> o a <ulink url="mailto:antlarr@arrakis.es">antlarr@arrakis.es</ulink></para>

<para>or escríbeme por correo ordinario a :
<screen> Antonio Larrosa Jimenez
 Rio Arnoya 10 5B
 29006 Malaga
</screen>
</para>

<para>Me haras feliz si me mandas una postal de donde vivas (por favor,
abstenerse si sois de Málaga :-)) , o un fichero midi/karaoke de un
grupo de música local de tu región . Todo el que me mande una
postal o un fichero midi entrar&aacute; en el 'Salon de los amigos del KMid'
de &eacute;ste fichero (siempre que no se opongan) . Por favor contactad
conmigo antes de mandarme un fichero midi porque puede que ya lo tenga .</para>

<para>Quisiera resaltar que he hecho KMid totalmente en tiempo libre, sin ninguna ganancia monetaria de ninguna compañía ni particular. Así que ten en cuenta cuando lo uses que lo único que me mantiene programando KMid son los mensajes de sus usuarios  (una postal o simplemente un email).</para>

<para>Me gustaría agradecer a las siguientes personas su ayuda en el desarrollo de KMid :
<itemizedlist>
<listitem>
<para><ulink url="mailto:P.J.Leonard@bath.ac.uk">Paul J. Leonard</ulink> - Soporte para tarjetas AWE</para>
</listitem>
<listitem>
<para><ulink url="mailto:szoli@digo.inf.elte.hu">Sebestyen Zoltan</ulink> - Porte al FreeBSD y testeo de AWE</para>
</listitem>
<listitem>
<para><ulink url="mailto:esken@kde.org">Christian Esken</ulink> - Por organizar los esfuerzos multimedia de KDE</para>
</listitem>
<listitem>
<para><ulink url="mailto:coolo@kde.org">Stephan Kulow</ulink> - Por los scripts de configure e invaluable ayuda con el automake y CVS</para>
</listitem>
<listitem>
<para>Jaroslav Kysela  - Ayuda para soportar el driver del Linux Ultrasound Projec</para>
</listitem>
<listitem>
<para>Takashi Iwai y Joseph H. Buehler    - Arreglo para las tarjetas AWE sonando demasiado agudas </para>
</listitem>
<listitem>
<para>Adrian Knoth     - Por darme muchas sugerencias y mandarme una revista de Alemania donde aparecía el KMid</para>
</listitem>
<listitem>
<para>Kevin Street     - Parche para soportar el FreeBSD 3.0</para>
</listitem>
<listitem>
<para>También quisiera dar las gracias a Jose Luis Sanchez por testear el soporte para GUS, Ignacio Garcia por testear el soporte para AWE, Hans Petter Bieker, Ola Sigurdson, Marc Diefenbruch, Peter Gritsch, Magnus Pfeffer, Urko Lusa, Peter-Paul Witta, Thorsten Westheider, Ulrich Cordes y a todo el que me mandó un parche, me comunicó un error o simplemente, me mandó un email para dar ánimos.</para>
</listitem>
<listitem>
<para>Y por supuesto, a todos los fantásticos músicos por internet que siguen dándonos esos maravillosos ficheros midi y karaoke.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
