<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&aktion;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % Spanish "INCLUDE" 
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title
>El manual de &aktion;</title>

<authorgroup>
<author
> <firstname
>Chris</firstname
> <othername
>D.</othername
> <surname
>Corbettis</surname
> <affiliation
> <address
><email
>chris@corbettis.fsnet.co.uk</email
></address
> </affiliation
> </author>

<othercredit role="developer">
<firstname
>Guillermo</firstname>
<othername
>P.</othername>
<surname
>Marotte</surname>
<affiliation
><address
><email
>g-marotte@usa.net</email
></address>
</affiliation>
<contrib
>Desarrollador</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation>
<address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Revisor</contrib>
</othercredit>

<othercredit role="translator"
> <firstname
>Miguel</firstname
> <surname
>Revilla Rodríguez</surname
> <affiliation
><address
><email
>yo@miguelrevilla.com</email
></address
></affiliation
> <contrib
>Traductor</contrib
></othercredit>
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Chris D. Corbettis</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-02-04</date>
<releaseinfo
>1.99.00</releaseinfo>

<abstract>
<para
>&aktion; es un reproductor de vídeo</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>aKtion</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>mpeg</keyword>
<keyword
>avi</keyword>
<keyword
>QuickTime</keyword>
<keyword
>gif</keyword>
<keyword
>xanim</keyword>
</keywordset>

</bookinfo>

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

<para
>&aktion; es un entorno gráfico para el reproductor de vídeo <application
>Xanim</application
>. Soporta numerosos formatos de vídeo de los encontrados en Internet, incluyendo mpeg1, QuickTime y gif animado. Por favor informe de cualquier problema o sugerencia en las listas de correo de &kde;.</para>

</chapter>

<chapter id="using-aktion">
<title
>Uso de &aktion;</title>

<screenshot
> <screeninfo
>Esta es una instantánea de &aktion;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="aktion.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Instantánea</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>El uso básico de &aktion; es muy sencillo. Pinche con el botón <mousebutton
>derecho</mousebutton
> del ratón en la ventana principal, o sobre el icono <guiicon
>abrir</guiicon
> en la barra de herramientas, seleccione qué secuencia desea ver, y pulse el botón <guibutton
>Aceptar</guibutton
>.</para>

<sect1 id="context-menu">
<title
>El menú contextual</title>

<para
>Al menú contextual se accede pinchando con el botón <mousebutton
>derecho</mousebutton
> del ratón sobre la ventana de reproducción. Se utiliza para cambiar rápidamente el tamaño de la reproducción, los archivos de vídeo abiertos y para acceder al diálogo de información del archivo de vídeo.</para
> 

<para
>El menú contextual está descrito más detalladamente en <xref linkend="video-context-menu"/>.</para>

</sect1>

<sect1 id="aktion-fullscreen">
<title
>&aktion; a pantalla completa</title>

<para
>Es posible reproducir vídeos a pantalla completa. Pinche con el botón <mousebutton
>derecho</mousebutton
> del ratón en cualquier lugar de &aktion; y elija <guimenuitem
>Pantalla completa</guimenuitem
>. Para salir, pinche con los botones <mousebutton
>izquierdo</mousebutton
> o <mousebutton
>derecho</mousebutton
> en la pantalla. Puede que necesite activar esta opción si actualmente no funciona.</para>

<para
>Si es posible, utilice las extensiones de XFree86 VidMode y DGA. Estas extensiones permiten que la aplicación cambie automáticamente la resolución de la pantalla para adaptarse mejor al tamaño del vídeo. Tradicionalmente un vídeo de, digamos, 320x200 tendría que ser aumentado hasta la resolución de 800x600. Este cambio de escala supone trabajo extra y el resultado no es mejor en absoluto. En el diálogo de configuración hay dos casillas de comprobación de interés:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Utilizar XFree86-VidModeExtensions (si están disponibles)</guilabel
></term
> <listitem
><para
><action
>activación del modo de pantalla completa</action
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Capturar el ratón</guilabel
></term
> <listitem
><para
>&aktion; <action
>toma el control del ratón en el modo de pantalla completa</action
></para
></listitem
> </varlistentry
> </variablelist>

</sect1>
</chapter>

<chapter id="commands">
<title
>Referencia de comandos</title>

<sect1 id="video-context-menu">
<title
>El menú contextual de vídeo</title>

<para
>Se puede acceder al menú contextual de vídeo pinchando con el botón <mousebutton
>derecho</mousebutton
> del ratón dentro de la ventana de vídeo mientras está cargada una película. </para>

<variablelist
> <varlistentry
> <term
><guimenuitem
>Información del vídeo</guimenuitem
></term
> <listitem
><para
>Muestra una ventana con información sobre la película cargada en ese momento, incluyendo el número de fotogramas, el tipo de codificación y el tamaño original en pixels.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Abrir archivo</guimenuitem
></term
> <listitem
><para
>Abre un cuadro de diálogo de <quote
>apertura de archivos</quote
> estándar de &kde;, con filtros predefinidos para los formatos de archivo soportados por &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Configuración</guimenuitem
></term
> <listitem
><para
>Abre el diálogo de <guilabel
>Configuración</guilabel
>, donde se puede configurar el comportamiento de &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Tamaño original</guimenuitem
></term
> <listitem
><para
>Redimensiona la ventana de &aktion; al tamaño original de la secuencia. Obviamente no tiene ningún efecto salvo que ya haya cambiado el tamaño de la ventana.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Mitad de tamaño</guimenuitem
></term
> <listitem
><para
>Redimensiona la ventana de &aktion; a la mitad del tamaño original de la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Doble tamaño</guimenuitem
></term
> <listitem
><para
>Redimensiona la ventana de &aktion; al doble del tamaño original de la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Maximizado</guimenuitem
></term
> <listitem
><para
>Redimensiona la ventana de &aktion; al máximo tamaño posible que quepa en la pantalla. La secuencia mantendrá su relación de aspecto (es decir, la relación entre su anchura y su altura) en vez de ser distorsionada para ocupar toda la pantalla. Una secuencia alta y estrecha seguirá siendo alta y estrena, pero ahora maximizada de forma que la dimesión más grande coincida con la dimensión más grande de la pantalla, con la excepción de elementos permanentes de la pantalla como el panel &kicker;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Pantalla completa</guimenuitem
></term
> <listitem
><para
>Hace que &aktion; ocupe toda la pantalla.</para
> <para
>Hay mucha más información disponible en <xref linkend="aktion-fullscreen"/></para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="toolbar">
<title
>La barra de herramientas</title>

<screenshot
> <screeninfo
>La barra de herramientas de &aktion;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="aktiontoolbar.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Barras de herramientas</phrase
> </textobject
> </mediaobject
> </screenshot>
			       
<para
>La barra de herramientas está en el borde inferior de la ventana de &aktion;. Contiene los siguientes iconos:</para>

<variablelist
> <varlistentry
> <term
><guiicon
>Abrir</guiicon
></term
> <listitem
><para
>Abre un cuadro de diálogo de <quote
>apertura de archivos</quote
> estándar de &kde;, con filtros predefinidos para los formatos de archivo soportados por &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Reproducir</guiicon
></term
> <listitem
><para
>Inicia la reproducción de la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Detener</guiicon
></term
> <listitem
><para
>Detiene la reproducción de la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Rebobinar</guiicon
></term
> <listitem
><para
>Rebobina la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Avanzar</guiicon
></term
> <listitem
><para
>Avanza rápidamente la secuencia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Configuración</guiicon
></term
> <listitem
><para
>Abre el diálogo de <link linkend="aktion-setup"
>Configuración</link
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Ayuda</guiicon
></term
> <listitem
><para
>Abre la página de ayuda de &aktion; (este documento).</para
></listitem
> </varlistentry
> </variablelist>

<para
>Inmediatamente encima de la barra de herramientas, a la derecha de la ventana de &aktion;, hay un control de volumen. Se utiliza para ajustar el volumen del sonido de la secuencia, para bajarlo (a la izquierda) o subirlo (a la derecha).</para>

</sect1>

<sect1 id="aktion-setup">
<title
>El diálogo de configuración de &aktion;</title>

<para
>El diálogo de configuración consta de cinco apartados principales:</para>

<itemizedlist
> <listitem
><para
><link linkend="setup-audio"
><guilabel
>Audio</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-color"
><guilabel
>Color</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-scaling"
><guilabel
>Escalado</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-capture"
><guilabel
>Captura</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-others"
><guilabel
>Otros</guilabel
></link
></para
></listitem
> </itemizedlist>

<para
>El diálogo también contiene los botones estándar <guibutton
>Aceptar</guibutton
> y <guibutton
>Cancelar</guibutton
>. Pulse <guibutton
>Aceptar</guibutton
> para cerrar el diálogo guardando todos los cambios, y pulse <guibutton
>Cancelar</guibutton
> para cerrar el diálogo descartando todos los cambios.</para>

<sect2 id="setup-audio">
<title
>Configuración de <guilabel
>Audio</guilabel
></title>

<para
>Este apartado contiene opciones relativas al sonido durante la reproducción de las secuencias.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Habilitar audio</guilabel
></term
> <listitem
><para
>Activa el sonido. Si no está marcado, no habrá sonido durante la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Saltar fotogramas para sincronizar con audio</guilabel
></term
> <listitem
><para
>Si esta opción está activada, &aktion; saltará en ocasiones fotogramas de vídeo para mantener la sincronización con el sonido. Active esto si dispone de una máquina lenta y nota que el vídeo y el audio se están reproduciendo a distintas velocidades; en ocasiones la pista de audio terminará mientras que la de vídeo no lo habrá hecho aún. Se perderá calidad en el vídeo si esto está seleccionado, pero está pérdida podrá ser desde imperceptible hasta provocar que sea imposible la visualización del vídeo, dependiento esto mayormente de la velocidad del ordenador y de la memoria RAM que tenga instalada.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Mostrar barra de volumen</guilabel
></term
> <listitem
><para
>Activa o desactiva el control de volumen que está encima y a la derecha de la barra de herramientas. Está activado por defecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Volumen inicial (0-100)</guilabel
></term
> <listitem
><para
>Establece el volumen al comienzo de una secuencia. Los cambios que se hagan en el control de volumen serán relativos a este nivel. Puede utilizar las flechas para cambiar el valor, o teclear directamente en la casilla.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-color">
<title
>Configuración de <guilabel
>Color</guilabel
></title>

<para
>Este apartado proporciona opciones para configurar el uso del color en &aktion; durante la reproducción.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Mapeo del color (pantallas sin TrueColor)</guilabel
></term
> <listitem
><para
>Este sección se aplica únicamente a las pantallas que tengan configuraciones inferiores a TrueColor (16 bits). Si tiene problemas con colores que no se muestra adecuadamente, pruebe estas opciones.</para
> <variablelist
> <varlistentry
> <term
><guilabel
>TrueColor hasta 322 (color estático)</guilabel
></term
> <listitem
><para
>Si está seleccionado, &aktion; convertirá las secuencias al mapa de color Static322 antes de mostrarlas.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tabla localizadora de colores</guilabel
></term
> <listitem
><para
>Si esta opción está seleccionada, &aktion; creará una palete para usarla como tabla de localización. Puede seleccionar con cuantos fotogramas de adelanto buscar para crear la tabla, pero cuanto más alto sea el número, más memoria consumirá. El valor predeterminado es 5.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Convertir TrueColor en escala de grises</guilabel
></term
> <listitem
><para
>&aktion; convertirá la secuencia a escala de grises si se activa esta opción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Ninguno</guilabel
></term
> <listitem
><para
>Por defecto <guilabel
>Ninguno</guilabel
> es la opción activa. &aktion; no realizará ningún mapeo de color. Sólo debe utilizar las otras opciones si tiene problemas con los colores durante la reproducción.</para
></listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Gama de pantallas</guilabel
>:</term
> <listitem
><para
>Establece el valor de la gama de pantalla. Los valores mayores de 1.0 normalmente hacen la imagen más brillante.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-scaling">
<title
>Configuración de <guilabel
>Escalado</guilabel
></title>

<para
>Este aparto cotiene elementos relacionados con el tamaño de reproducción de la secuencia.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Escala de visualización</guilabel
></term
> <listitem
><para
>Establece el tamaño de la secuencia, en relación su tamaño original</para
> <para
>Puede elegir uno de los siguientes valores</para
> <simplelist
> <member
>Tamaño original</member
> <member
>Mitad de tamaño</member
> <member
>Doble tamaño</member
> <member
>Maximizado</member
> <member
>Pantalla completa</member
> </simplelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Pantalla completa</guilabel
></term
> <listitem
><para
>Más opciones relacionadas con el uso de &aktion; en modo de pantalla completa.</para
> <variablelist
> <varlistentry
> <term
><guilabel
>Utilizar XFree86-VidModeExtensions (si están disponibles)</guilabel
></term
> <listitem
><para
>Activa el modo de pantalla completa. Se amplía la explicación en la sección <link linkend="aktion-fullscreen"
>Uso de &aktion; en pantalla completa</link
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Capturar el ratón</guilabel
></term
> <listitem
><para
>Toma el control del ratón mientras está en modo de pantalla completa.</para
></listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-capture">
<title
>Configuración de <guilabel
>Captura</guilabel
></title>

<para
>&aktion; permite <quote
>capturar</quote
> o tomar una <quote
>instantánea</quote
> de fotogramas de la secuencia que esté viendo, símplemente pulsando la tecla <keycap
>C</keycap
>. Este apartado contiene opciones relacionadas con ello.</para
> 

<variablelist
> <varlistentry
> <term
><guilabel
>Formato del archivo de salida</guilabel
></term
> <listitem
><para
>Elija en qué formato se guardarán las capturas. Puede elegir entre los siguientes:</para
> <simplelist
> <member
>bmp</member
> <member
>jpeg</member
> <member
>pbm</member
> <member
>pgm</member
> <member
>png</member
> <member
>ppm</member
> <member
>xbm</member
> <member
>xpm</member
> </simplelist
> <para
>El predeterminado es png</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Directorio del archivo de salida</guilabel
>:</term
> <listitem
><para
>Elija dónde se almacenará las capturas. El directorio predeterminado es <filename
>~</filename
> (su directorio casa). Puede teclear una ruta a otro directorio directamente en la casilla de texto, o puede pulsar el botón <guibutton
>...</guibutton
> para abrir un diálogo de selección de archivos y colocarse en el destino deseado.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-others">
<title
>Configuración de <guilabel
>Otros</guilabel
></title>

<para
>Este apartado contiene otras opciones variadas.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Cargando el vídeo</guilabel
></term
> <listitem
><para
>Esta sección contiene opciones relacionadas con la precarga de secuencias. Puede elegir unas de las siguientes:</para
> <variablelist
> <varlistentry
> <term
><guilabel
>Precargar animación en memoria</guilabel
></term
> <listitem
><para
>Carga toda la animación en la memoria del ordenador antes de comenzar la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Precargar y descomprimir animación</guilabel
></term
> <listitem
><para
>Carga toda la animación en la memoria del ordenador, y la descomprime, antes de comenzar la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Leer cada sector sólo cuando sea necesario</guilabel
></term
> <listitem
><para
>No realiza ninguna precarga, lee cada sección de la animación desde el disco duro según va siendo necesario.</para
></listitem
> </varlistentry
> </variablelist
> <para
>La opción predeterminada es <guilabel
>Leer cada sector sólo cuando sea necesario</guilabel
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Utilizar memoria compartida de X11</guilabel
></term
> <listitem
><para
>Esto no estará disponible si selecciona "<guilabel
>Precargar y descomprimir animación</guilabel
>" en la sección anterior. Está deseleccionado por defecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Utilizar multi buffering de X11</guilabel
></term
> <listitem
><para
>Si está seleccionado, &aktion; utilizará el Buffering de X11 (si está disponible) para suavizar las animaciones por medio de un doble buffer. Está activado por defecto.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Utilizar mapa de píxeles en lugar de imagen en X11</guilabel
></term
> <listitem
><para
>Si está seleccionado, &aktion; no utilizará mapas de píxeles en lugar de imagen en X11shared. Esta opción no tiene efecto si la animación pasa por un buffer.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Directorio inicial</guilabel
></term
> <listitem
><para
>Establece el directorio que se mostrará cuando vaya a abrir una nueva secuencia. Puede introducir un valor directamente en la casilla de texto, o pulsar en el botón <guibutton
>...</guibutton
> para seleccionar su directorio preferido. Desde luego lo único que se establece es el directorio predeterminado, pudiendo en cualquier caso desplazarse a otros al abrir una secuencia. Está vacío por defecto, lo que hace en la mayoría de los casos que &aktion; comience a buscar secuencias en su directorio casa.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Animación cíclica</guilabel
></term
> <listitem
><para
>Si está seleccionado, cuando la película llegue al final, volverá a empezar de nuevo, hasta que se pulse el botón <guiicon
>Detener</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Iniciar automáticamente la reproducción de vídeo</guilabel
></term
> <listitem
><para
>Si se elige esto, &aktion; comenzará a reproducir la película selecciona tan pronto como lo haya sido. Si no está activo, tendrá que pulsar en <guiicon
>Reproducir</guiicon
> para que comience la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Parámetros extra de XAnim</guilabel
></term
> <listitem
><para
>Si desea comunicarle parámetros extra a la aplicación subyacente<application
>XAnim</application
>, puede introducirlos aquí.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="developers">
<title
>Guía de desarrollo de &aktion;</title>

<para
>&aktion; incluye el widget <classname
>KXAnim</classname
>, con el que puede incluir reproducción de vídeo en sus propios programas.</para>

<!-- Use refentries to describe APIs.  Refentries are fairly complicated and you
should consult the docbook reference for further details. The example below was
taken from that reference and shortened a bit for readability. -->

<refentry id="re-1007-kanim">

<refmeta>
<refentrytitle
>KXAnim</refentrytitle>
<refmiscinfo
>KXAnim Class Reference</refmiscinfo>
</refmeta>

<refnamediv>
<refname
>KXAnimChildren</refname>
<refpurpose
>A xanim wrapper to allow video playing in your apps.</refpurpose>
</refnamediv>

<refsynopsisdiv>
<refsynopsisdivinfo>
<date
>18/08/2000</date>
</refsynopsisdivinfo>

<synopsis>
Miembros públicos

      KXAnim (QWidget *parent, const char *name=0)
      ~KXAnim ()
      void setFile (QString file)
      void setAutoResize (bool val)
      bool getAutoResize ()
      void updateSize ()
      void setLoop (bool val)
      bool getLoop ()
      QString getVideoFileName ()
      int getVideoHeight ()
      int getVideoWidth ()
      float getVideoSpeed ()
      int getVideoFrames ()
      QString getVideoCodec ()
      QString getErrorCode ()
      QString getErrorString ()
      bool isPlaying ()
      bool isActive ()
      void resetXAnimDefaults ()
      void setAudio (bool val)
      void setAudioSync (bool val)
      void setInitialVolume (int val)
      enum colorMap { static332, lookupTable, grayScale, none }
      void setColorMapping (colorMap val)
      void setColorAhead (int val)
      void setGammaDisplay (float val)
      void setResizing (bool val)
      void setScaleFactor (float val)
      void setScaleHFactor (float val)
      void setScaleVFactor (float val)
      void setScaleWidth (int val)
      void setScaleHeight (int val)
      void setScaleDisplayToBuffer (bool val)
      void setScaleFactorB (float val)
      void setScaleHFactorB (float val)
      void setScaleVFactorB (float val)
      void setScaleWidthB (int val)
      void setScaleHeightB (int val)
      void setScaleBufferToDisplay (bool val)
      void setLoading (int val)
      void setX11Shared (bool val)
      void setMultiBuffer (bool val)
      void setUsePixmap (bool val)
      void setX11VisualClass ( const char *val)
      void setPauseAt (int val)
      void setExtraParameters (const char *val)
      void setExecutable (const char *val)

Slots públicos

      void play ()
      void pause ()
      void stop ()
      void stepForward ()
      void stepBack ()
      void stepForwardWA ()
      void stepBackWA ()
      void toggleSound ()
      void volumeIncrement ()
      void volumeDecrement ()
      void setVolume (int v)
      void faster ()
      void slower ()
      void resetSpeed ()

Miembros protegidos

      void changeProperty ( const char * c)
      virtual void closeEvent ( QCloseEvent *)
      virtual void mousePressEvent ( QMouseEvent *)

Señales

      void stopped ()
      void mouseClick ( QMouseEvent *)
</synopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descripción detallada de <classname
>KXAnim</classname
></title>

<para
>#include &lt;kxanim.h&gt;</para>

<para
>Inherente: <classname
>QWidget</classname
></para>

<para
>Clase widget para la reproducción de vídeo</para>

<para
>Este widget es un acceso a <application
>xanim</application
> para facilitar la reproducción de vídeo en sus aplicaciones.</para>

<variablelist
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
><function
>KXAnim</function
></funcdef
> <paramdef
>QWidget <parameter
>*parent</parameter
></paramdef
> <paramdef
>const char <parameter
>*name=0</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Constructor. El argumento padre <emphasis
>NO</emphasis
> es opcional.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setFile</function
></funcdef
> <paramdef
>QString <parameter
>file</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Utilice este método para indicarle al reproductor el nombre del archivo a reproducir. La reproducción no comenzará hasta que se llame al slot <function
>play()</function
>. Es necesario llamar a <function
>stop()</function
> antes de poder establecer un nuevo nombre de archivo. </para
> <para
>Después de llamar a este método, debería esperar a una señal de parado. Entonces estará disponible la información sobre el archivo.</para
> <para
>Compruebe también <returnvalue
>KXAnim::getErrorNumber</returnvalue
> y <function
>getErrorString</function
> para saber si ha ocurrido algún error.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAutoResize</function
></funcdef
> <paramdef
>bool <parameter
><replaceable
>val</replaceable
></parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, el widget se redimensionará tras <function
>setFile()</function
> para ajustarse al tamaño del vídeo. Si <parameter
>val</parameter
>==<returnvalue
>false</returnvalue
>, se ajustará el tamaño del vídeo para ajustarse al del widget.</para
> <para
>El tamaño del widget es actualizado automáticamente por <function
>setFile</function
> y play. Pero si necesita saber el tamaño efectivo del widget *antes* de llamar a <function
>play</function
>, tendrá que llamar a <function
>updateSize</function
> manualmente.</para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>getAutoResize</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el estado de autoredimiensionado (ver <function
>setAutoResize</function
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>updateSize</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
> <para
>Actualiza el tamaño del widget para ajustarse al tamaño del vídeo (teniendo cuidado de los factores de escala que aplica). Ver <function
>setAutoResize</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setLoop</function
></funcdef
> <paramdef
>bool <parameter
><replaceable
>val</replaceable
></parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
> <para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, el vídeo se reproducirá cíclicamente.</para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>getLoop</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el estado de la reproducción cíclica (ver <function
>setLoop</function
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getVideoFileName</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el nombre de archivo del vídeo actual (o una cadena vacía si aún no hay vídeo).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoHeight</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el alto del vídeo (en píxeles).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoWidth</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el alto del vídeo (en píxeles).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>float <function
>getVideoSpeed</function
></funcdef
> <paramdef
></paramdef
> </funcprototype
></funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve la velocidad de reproducción (en fotogramas por segundo).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoFrames</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el número de fotogramas en el vídeo.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getVideoCodec</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve la cadena que describe al codec de vídeo.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getErrorCode</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve el número del código de error. Debería comprobar este número tras un <function
>setFile</function
>. Si el código es <returnvalue
>zero</returnvalue
>, significa que no hubo errores. Para obtener una cadena que contenga una descripción, vea <function
>getErrorCode</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getErrorString</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve la cadena que describe el error durante <function
>setFile</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>isPlaying</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve <returnvalue
>true</returnvalue
> si el vídeo está en modo de reproducción. En otro caso devuelve <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>isActive</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Devuelve <returnvalue
>true</returnvalue
> si el vídeo está activo. En otro caso devuelve <returnvalue
>false</returnvalue
>. El widget <emphasis
>NO</emphasis
> está activo sólo cuando está detenido. Por lo tanto, puede utilizar este método para comprobar si el vídeo está REALMENTE detenido. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>resetXAnimDefaults</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Este método reinicia todos los parámetros de configuración a sus valores predeterminados.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAudio</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, se activa la salida de sonido.</para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAudioSync</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, se permite a <application
>xanim</application
> saltar fotogramas para mejorar el sincronismo.</para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setInitialVolume</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Establece el valor del volumen inical del audio.</para
> <para
>El predeterminado es <returnvalue
>40</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> enum colorMap ( static332, lookupTable, grayScale, none ) [public] </term
><listitem
> <para
>Ver setColorMapping.</para
> </listitem
></varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setColorMapping</function
></funcdef
> <paramdef
>colorMap <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Le dice a <classname
>KXAnim</classname
> qué tipo de mapeo de color hay que utilizar en las pantallas sin truecolor.</para
> <para
>Si <parameter
>val</parameter
>==<returnvalue
>KXAnim::static322</returnvalue
>, <application
>xanim</application
> convertirá el truecolor en static322.</para
> <para
>Si <parameter
>val</parameter
>==<returnvalue
>KXAnim::lookupTable</returnvalue
>, <application
>xanim</application
> explorará los colores por adelantado y formará tablas de localización de colores.</para
> <para
>Si <parameter
>val</parameter
>==<returnvalue
>KXAnim::grayScale</returnvalue
>, <application
>xanim</application
> convertirá el TrueColor en escalas de grises.</para
> <para
>Estas tres opciones se ignoran en las pantallas TrueColor y DirectColor.</para
> <para
>Si <parameter
>val</parameter
>==<returnvalue
>KXAnim::none</returnvalue
>, <application
>xanim</application
> utilizará el mapeo de color predeterminado.</para
> <para
>El valor predeterminado es <returnvalue
>KXAnim::none</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setColorAhead</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Establece el número de fotogramas a explorar por adelantado en la tabla de localización de colores al utilizar <returnvalue
>KXAnim::lookupTable</returnvalue
> en <function
>setColorMapping</function
>.</para
> <para
>El valor predeterminado es <returnvalue
>5</returnvalue
></para
> </listitem
></varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setGammaDisplay</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Establece la gama de pantalla. Las gamas mayores de 1.0 normalmente hacen que la animación sea más brillante.</para
> <para
>El valor predeterminado es <returnvalue
>1.0</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void setResizing</funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, el tamaño del vídeo puede cambiarse "al vuelo".</para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
></para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escalar el tamaño de anim por "<parameter
>val</parameter
>" antes de mostrarlo.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Escala el tamaño horizontal de anim por "<parameter
>val</parameter
>" antes de mostrarlo.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleVFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala el tamaño vertical de anim por "<parameter
>val</parameter
>" antes de mostrarlo.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleWidth</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala la animación para que tenga anchura "<parameter
>val</parameter
>" antes de mostrarlo.</para
> <para
>El valor predeterminado es <returnvalue
>0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHeight</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala la animación para que tenga altura "<parameter
>val</parameter
>" antes de mostrarlo.</para
> <para
>El valor predeterminado es <returnvalue
>0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleDisplayToBuffer</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Copia los factores de escala de pantalla a los factores de escala del buffer.</para
> <para
>El valor predeterminado es <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala el tamaño de anim por "<parameter
>val</parameter
>" antes de introducirlo en el buffer.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala el tamaño horizontal de anim por "<parameter
>val</parameter
>" antes de introducirlo en el buffer.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleVFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala el tamaño vertical de anim por "<parameter
>val</parameter
>" antes de introducirlo en el buffer.</para
> <para
>El valor por defecto es <returnvalue
>1.0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleWidthB</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala la animación para que tenga anchura "<parameter
>val</parameter
>" antes de introducirlo en el buffer.</para
> <para
>El valor predeterminado es <returnvalue
>0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHeightB</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Escala la animación para que tenga altura "<parameter
>val</parameter
>" antes de introducirlo en el buffer.</para
> <para
>El valor predeterminado es <returnvalue
>0</returnvalue
> (ningún escalado)</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleBufferToDisplay</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Copia los factores de escala del buffer a los factores de escala de pantalla.</para
> <para
>El valor predeterminado es <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setLoading</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
><returnvalue
>0</returnvalue
>: <classname
>KXAnim</classname
> cargará todo el vídeo en memoria.</para
> <para
><returnvalue
>1</returnvalue
>: <classname
>KXAnim</classname
> cargará y descomprimirá toda la animación en memoria antes de mostrarla.</para
> <para
><returnvalue
>2</returnvalue
>: <classname
>KXAnim</classname
> leerá cada sector cuando sea necesario</para
> <para
>El valor predeterminado es <returnvalue
>2</returnvalue
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setX11Shared</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> utilizará memoria compartida de X11 (esto es mútuamente exclusivo con <function
>setPreload</function
>).</para
> <para
>El valor predeterminado es <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setMultiBuffer</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> utilizará buffering de X11 (si está disponible) para suavizar las animaciones mediante doble buffer. </para
> <para
>El valor predeterminado es <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setUsePixmap</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Si <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> utilizará mapas de píxeles en lugar de imagen en X11shared. Esta opción no tiene efecto si la animación para por un buffer.</para
> <para
>El valor predeterminado es <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setX11VisualClass</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Selecciona el mejor <quote
>X11 Visual of Class...</quote
> al mostrar la animación. <parameter
>val</parameter
> puede ser cualquier de las siguientes cadenas y es insensible a las mayúsculas y minúsculas:</para
> <simplelist
> <member
><returnvalue
>default</returnvalue
></member
> <member
><returnvalue
>staticgray</returnvalue
></member
> <member
><returnvalue
>grayscale</returnvalue
></member
> <member
><returnvalue
>staticcolor</returnvalue
></member
> <member
><returnvalue
>pseudocolor</returnvalue
></member
> <member
><returnvalue
>truecolor</returnvalue
></member
> <member
><returnvalue
>directcolor</returnvalue
></member
> </simplelist
> <para
>El valor predeterminado es <returnvalue
>default</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setPauseAt</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Esto pausará <application
>XAnim</application
> en el fotograma <parameter
>val</parameter
>. <parameter
>val</parameter
>=<returnvalue
>-1</returnvalue
> desactiva esta opción.</para
> <para
>El valor predeterminado es <returnvalue
>-1</returnvalue
> (ninguna pausa).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setExtraParameters</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Utilice este método para pasar cualquier parámetro extra a <application
>xanim</application
> (separados por espacios).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setExecutable</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Utilice este método para establecer el nombre del ejecutable de <application
>xanim</application
>. El valor predeterminado es "<returnvalue
>xanim</returnvalue
>", pero puede cambiar si, por ejemplo, no tiene a <application
>xanim</application
> en un directorio de la variable PATH.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>play</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Inicia la reproducción del vídeo.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>pause</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Pausa la reproducción del vídeo (<application
>xanim</application
> sigue ejecutándose).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stop</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Detiene el vídeo y salir de <application
>xanim</application
> (no se preocupe, es transparante para la clase user).</para
> <note
><para
>Llamar a este slot no significa que el vídeo se detenga inmediatamente. Utilice la señal <returnvalue
>stopped</returnvalue
> para saber extamente cuando está el reproductor en modo inactivo (ver <function
>isActive</function
>). </para
></note
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepForward</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Un fotograma hacia adelante. Pausa la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepBack</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Un fotograma hacia atrás. Pausa la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepForwardWA</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Un fotograma hacia adelante manteniendo anim. Pausa la reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepBackWA</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Un fotograma hacia atrás manteniendo anim. Pausa el vídeo.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>toggleSound</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Activa o desactiva el sonido.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>volumeIncrement</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Incrementar el volumen en 1.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>volumeDecrement</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Decrementar el volumen en 1.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setVolume</function
></funcdef
> <paramdef
>int <parameter
>v</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Establecer el volumen donde <parameter
>v</parameter
> es un número de <returnvalue
>0</returnvalue
> a <returnvalue
>100</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>faster</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Incrementar la velocidad de reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>slower</function
></funcdef
> <paramdef
></paramdef
> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Decrementar la velocidad de reproducción.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>resetSpeed</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Reiniciar la velocidad de reproducción a los valores originales.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>changeProperty</function
></funcdef
> <paramdef
>const char <parameter
>*</parameter
> c</paramdef
> </funcprototype
> </funcsynopsis
> [protected] </term
> <listitem
><para
><emphasis
>¡No lo use!</emphasis
>. Se utiliza internamente para la comunicación con <application
>xanim</application
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stopped</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [signal] </term
> <listitem
><para
>Esta señal se emite tras una llama al slot <function
>stop()</function
>, y significa que el reproductor está <emphasis
>realmente</emphasis
> detenido (que <application
>xanim</application
> estáinactivo). (Ver <function
>stop</function
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>mouseClick</function
></funcdef
> <paramdef
>QMouseEvent <parameter
>*</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [signal] </term
> <listitem
><para
>Esta señal se emite cuando el usuario pincha en el widget.</para
></listitem
> </varlistentry
> </variablelist>
</refsect1>

</refentry>

</chapter>

<chapter id="faq">
<title
>Preguntas y respuestas</title>

<qandaset>
<qandaentry>
<question
><para
>¿Qué significa el mensaje Codec de vídeo no soportado?</para
></question>
<answer
><para
>Significa que no se puede reproducir el formato de vídeo. Puede ser porque no tenga un <application
>xanim</application
> con todas las características instaladas. Para más detalles vea la siguiente respuesta.</para>
<para
>Hay algunos codecs que no serán reproducibles en un futuro próximo. El que más le puede afectar es Sorenson, utilizado en QuickTime 4. </para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>¿Cómo obtengo un <application
>xanim</application
> con todas las características instaladas?</para
></question>
<answer
><para
>Vaya a la página web principal de <application
>xanim</application
> y siga las instrucciones para instalar los codecs de vídeo cinepak, indeo y creative. Es posible que necesite recompilar <application
>xanim</application
>, pero a pesar de todo compruebe la documentación de su distribución, ya que algunas son más fáciles de instalar que otras.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>¿Cómo puedo saber si mi sistema dispone de extensiones VidMode y DGA?</para>
</question>
<answer
><para
>Hay dos formas de comprobarlo.Cuál utilizar depende de cómo haya instalado &aktion;. </para>
<variablelist
> <varlistentry
> <term
>Si ha instalado &aktion; desde el código fuente</term
> <listitem
><para
>Compruebe la salida de <command
>./configure</command
>, debería ver <computeroutput
>"checking for VidMode extensions..."</computeroutput
>. Si aparece la palabra <computeroutput
>"no"</computeroutput
> después de esta línea, siginifica que no tiene las extensiones.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Si ha instalado &aktion; desde un paquete binario (rpm o deb)</term
> <listitem
><para
>Busque en el sistema dos archivos llamados: <filename
>libXxf86vm.a</filename
> y <filename
>libXxf86dga.a</filename
>, si los tiene es buena señal.</para
></listitem
> </varlistentry
> </variablelist>
<para
>En ambos casos, si no tiene las extensiones, compruebe que ha instalado el paquete XFree86-devel en su sistema. Las extensiones están incluidas en este paquete.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>¿Cómo puedo saber si las extensiones VidMode están funcionando en mi sistema?</para
></question>
<answer
><para
>Intente cambiar los modos de víde con <keycombo
><keycap
>CTRL</keycap
><keycap
>ALT</keycap
><keycap
>+ numérico</keycap
></keycombo
>. Si no ocurre nada, puede que necesite habilitar más resoluciones. Para más detalles lea la siguiente respuesta.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>¿Cómo puedo habilitar modos de vídeo adicionales?</para
></question>
<answer
><para
>Su distribución debería de proporcionar una utilidad de configuración de vídeo. En caso contrario, siempre está disponible <application
>XF86Config</application
>.</para>
<para
>Habilite tantos modos de resolución como pueda. Como mínimo, active 640x480 junto con su resolución usada habitualmente.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Créditos y licencia</title>

<para
>&aktion;</para>

<para
>Copyright del programa 2000 Guillermo P. Marotte <email
>g-marotte@usa.net</email
></para>

<para
>Contribuciones:</para>
<itemizedlist
> <listitem
><para
>Benjamin Sher <email
>sher07@bellsouth.net</email
></para
></listitem
> </itemizedlist>

<para
>Autor de Xanim:</para>
<itemizedlist
><listitem
><para
>Mark Podlipec</para
></listitem
> </itemizedlist>

<para
>Copyright de la documentación 2000 Chris D. Corbettis <email
>chris@corbettis.fsnet.co.uk</email
></para>
<para
>Traducido por Miguel Revilla Rodríguez <email
>yo@miguelrevilla.com</email
></para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title
>Instalación</title>

<sect1 id="getting-aktion">
<title
>Cómo obtener &aktion;</title>

&install.intro.documentation;

</sect1>

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

<para
>Para poder utilizar &aktion;, necesita &kde; 2 y <application
>xanim</application
> 2.70.7.0 o superior. El modo de pantalla completa requiere que las extensiones <application
>VidMode</application
> y <abbrev
>DGA</abbrev
> estén instaladas y funcionando.</para>

<para
>Todas las bibliotecas requeridas, así como el propio &aktion; se pueden encontrar en <ulink url="ftp://ftp.kde.org"
>la página principal de &aktion;</ulink
> y <ulink url="http://xanim.va.pubnix.com/home.html"
>la página principal de Xanim</ulink
></para>

</sect1>

<sect1 id="compilation">
<title
>Compilación e instalación</title>

&install.compile.documentation;

</sect1>

<sect1 id="configuration">
<title
>Configuración</title>

<para
>No olvide instalar <application
>xanim</application
> antes que &aktion;.</para>

</sect1>

</appendix>


&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
