Instrucciones para el Pubs, versin 0.966:
Traduccin por Hacky

(Nota de Hacky: La traduccin de este documento se ha realizado antes de
haber algn pubs 0.966 en castellano, por lo que las descripciones de las
opciones del programa que aqu se comentan probablemente no coincidan con
las que se encuentren en el pubs en castellano -al no tener los fuentes
disponibles la nica opcin es traducir el ejecutable a golpe de editor
hexadecimal, con la consiguiente imprecisin de tamaos de frases, etc-)



Funcin principal:

Pubs descodifica seales de video de canal+ y otros, segn el
procedimiento (nagravision) para televisiones de pago como por ejemplo
TeleClub. Otros canales de pago que funcionan con Videocrypt no pueden
ser descodificados con este programa.
Para la descodificacin, la seal de video se obtiene con un Chip-BT848/78
de una tarjeta de TV tipo Avermedia, Miro, etc...
El proceso de descodificacin se basa en el anlisis del contenido de la
imagen, que no requiere ningn tipo de llave, sin embargo pueden aparecer
dificultades con ciertas imgenes.
Puesto que se trata de procesos de datos de video en tiempo real, se
requiere gran potencia por parte del procesador.


Requerimientos de sistema:

- CPU al menos un Pentium-MMX (desde 166Mhz, o compatible)
- Placa base con un Chipset nuevo, los anteriores al Triton son demasiado
   lentos para aguantar la carga del bus PCI.
- Memoria 32Mb, mejor 64, y rpida (recomendado SDRAM en placa TX/LX/BX)
- Win95/98
- Tarjeta TV con Chip BT848/878, p.e. Miro PCTV, Avermedia Capture...
- Tarjeta de video rpida con soporte Direct Draw (DirectX 3 o superior
   requerido por WinTV)
- 30 Mb de disco duro
- Para la salida de video especial Permedia 2: ELSA Winner 2000/Office 


Instalacin:

- Ficheros requeridos:  DEK.EXE, DEK.INI, KEY.TXT, WINTV7.VXD, PERM2.VXD
- Copiar todos los ficheros a un directorio
- Guardar los datos importantes de los programas que estn corriendo
- Iniciar el pubs con DEK.EXE. La primera vez crear unos ficheros necesarios
   llamados CRCA.BIN y TABLES.BIN (dura unos 2 minutos)
- Una vez arrancado, aparecer una lista en la que escogeremos la tarjeta y
   el sintonizador correcto, si no es as, no sonar ni cambiar de canal,
   respectivamente.
- Despus escogeremos el modo de pantalla deseado, o en caso de duda simplemente
   pulsamos OK, el programa tratar de escoger el mejor modo posible.



Funcionamiento general del programa:

- La ventana de propiedades siempre se puede abrir haciendo click con el botn
   derecho sobre la ventana de video
- En cada pestaa existe un botn Grabar, que almacena en el .ini la
   configuracin establecida


Canales:

- Para moverse por los canales, pulsar '+' y '-' en el teclado numrico
- Si no hay programas en la pestaa "Canales", se obedece a la siguiente
   lista por orden:
        Entrada de video 1 y 2
        VHF Canales K2...12
        Canales Especiales S2...41
        UHF Canales K21...70

- Para establecer los canales:
   1. Pulsar botn "Nuevo"
   2. Escribir cualquier nombre en el dilogo que aparece
   3. Poner el canal correspondiente en el combo-box "Canal"
   4. Si es necesario, ajuste fino
   5. No olvidar guardar despus de poner todas las emisoras!

- Se pueden guardar hasta 100 emisoras
- La configuracin se puede cambiar ms tarde (despus de guardar)
- Los cambios y supresin de canales se puede realizar mediante un editor
   alterando la entrada [Programs] del fichero .ini
- Una vez establecidos, la nica forma de moverse por los canales es
   mediante las teclas '+' y '-'



Modo grfico:

- Establece el mdo grfico y el modo de edicin
- En ese momento, el modo se puede cambiar pulsando el botn "Cambiar Modo".
   El descodificador se reinicializa de nuevo.
- Distintos modos de edicin, porqu?:
   Segn las capacidades de la tarjeta de video, los drivers y la velocidad
   del procesador, un modo u otro puede ser el ptimo (en referencia a la
   velocidad y la calidad de representacin). Sin embargo, no todos los modos
   de edicin funcionan para cada modo de pantalla:
     - El modo 256 colores slo funcionar en Overlay y si lo soporta la tarjeta
     - El modo 24-bit/Color verdadero generalmente no funcionar en absoluto
       (Nota de Hacky: y si os tira, seguramente no "estire" la pantalla)
     - Todos los modos RGB directo se necesita un espacio adicional en el rea
       no visible (la memoria de video se llena completamente con RGB directo,
       por ejemplo, con 1152*864 a color verdadero se usan 4 Mb)
     - Al correr el descodificador, si es posible se usan unos buffers en
       background para suprimir distorsiones producidas por los movimientos en
       pantalla. Esto por supuesto requiere ms memoria de video.


- Modos de edicin:

  YUY-Blit:  La imagen se transforma por buffers en background en el formato YUY,
             que es el formato siguiente, en el cual se encuentra la seal de 
             video. Entoces se transporta con un comando Blit del chip de video a
             la memoria de video visible y se convierte con eso a RGB.
             Como el chip de video realiza la conversin despus del RGB, el
             procesador no necesita hacer nada con ello y se puede dedicar a
             realizar otras tareas ms importantes...
             Este modo es el mejor que hay si la tarjeta de video lo admite (salvo
             las Matrox, cuya representacin se hace un poco ms lentamente)
  Overlay:   La imagen se transforma por buffers en background en el formato YUY.
             El chip de video representa la imagen como Overlay con ayuda del
             hardware en la correspondiente rea de imgen. El rea visible se
             sita con ayuda de un color-llave (que es el color rosa que se ve en
             la ventana de video si la edicin de video no te funcion alguna vez)
             El uso de cpu es bastante bajo, como en YUY-Blit.
             Desafortunadamente, el overlay (por hardware) normalmente no est
             implementado con las tarjetas de video modernas, o slo como emulacin
             sobre el YUY-Blit.
  RGB-Blit:  La imgen se transforma, por bufferes en background en el formato RGB.
             El procesador realiza la conversin YUY->RGB con los buffers. Entonces
             se transporta con un comando Blit del chip de video a la memoria de
             video visible. El uso de la cpu es claramente alto, a velocidad completa
             y resolucin grande slo funciona en Pentium II/Celeron o K6-2.
             Este modo debera funcionar con casi todas las tarjetas de video si
             tienen suficiente memoria.
  RGB-Directo: La imgen se mueve a la pantalla visible en el formato RGB. No se
             necesita memoria de video adicional. Como se escribe directamente en la
             pantalla visible, ninguna ventana puede estar en el formato normal sobre
             la imagen; y tampoco es posible escalarla. Para sacar la ventana de
             propiedades el modo se convierte temporalmente a Blit con las funciones
             de GDI. La representacin se vuelve muy lenta entonces.
             El uso de la cpu es, por supuesto, muy alto, como con RGB-Blit.

- Todos los modos de edicin que estn marcados son comprobados por el
   descodificador, de arriba hacia abajo. El primero que funciona es el que se usa.
- El punto de la derecha de los modos muestra los que, segn la informacin de
   DirectDraw, deberan funcionar. Esto puede fallar por distintas razones de
   los modos que realmente van; es muy tedioso dar con ello.
- Para revisar el modo que se ha elegido como ptimo, activar "Mostrar linea
   de estado" en la pestaa "Especial"
- "Activar salida de video (Permedia2)":
   La salida de video directa se activa usando la "ELSA Winner 2000/Office" sin
   pasar por el software de ELSA (la imagen se desincroniza para obtener una
   ptima calidad de video)
- "Doblar pixels horizontalmente":
   Slo funciona con la representacin horizontal a la mitad. Cada pixel se
   representa dos veces horizontalmente y la cantidad de datos de video es
   inferior. Se procesa ms rpidamente, quizs recomendado para ordenadores
   de bajo rendimiento.
- "No mostrar al arrancar":
   Al arrancar el programa, no se muestra el dilogo de configuracin y se
   empieza inmediatamente con el modo previamente guardado.


Tarjeta:

- Selecciona tu tarjeta para que te funcione el audio. Para cada tarjeta hay
   valores distintos.
- Para las entradas de AV a veces se direccionan diferentemente
- El tipo de sintonizador es importante para cambiar de emisora, o para ajustar
  las sintonas.


Especial:

- Propiedades para la sintonizacin as como correcin de errores
- "Mostrar linea de estado":
    Muestra informacin importante en una linea bajo la imagen
    (Nota de Hacky: Suele funcionar slo en modo escritorio)
- "Usar PageFlipping":
    Con PageFlipping se mantiene un doble bffer de la imagen visible con
    el propsito de evitar distorsiones y parpadeos en la representacin.
    Funciona slo bajo ciertas circunstancias, slo en pantalla completa y si
    hay suficiente memoria (y...)
    Con algunas tarjetas, el PageFlipping puede ralentizar el proceso, como se
    ha visto con las Matrox Mystique.
- "Usar Escalar Verticalmente":
    Bajo ciertas circunstancias el descodificador slo muestra parte de la imagen
    (por ejemplo si est activa la barra de inicio) y usa la funcin Escalar de la
    tarjeta de video. Esto a veces est mal implantado en las tarjetas (Matrox
    Mystique).
    Si la imgen slo tiene la mitad de tamao vertical, al desactivar esta opcin
    el descodificador mostrar las lineas doble (ms lento).
- "Mostrar slo media imgen":
    Muestra la mitad de la imgen (mejor rendimiento, pero resolucin y sin efecto
    entrelazado)    
- "Usar Des-entrelazador":
    Para reducir las lneas de entrelazado en el monitor con las pelculas, el
    descodificador intenta suprimirlas con ayuda de unos filtros-verticales (la
    imgen se vuelve ms lenta y algo menos ntida, funciona por ahora slo en
    los formatos de YUY-Blit y Overlay si se est en modo PAL-M)
    Debera ir con pelculas, dibujadas con 25 imgenes completas, en vez de 50
    medias imgenes.
- "Mostrar imgen entera":
    El descodificador no suele mostrar todas las lneas (superior e inferior) con
    las pelculas panormicas, y en el resto rebaja en 4 lneas por arriba y por
    abajo, con el fin de acelerar todo el proceso.
    Con esto se puede ver la imgen entera (includa la linea PAL-Plus)
- "Cargar en memoria el fichero ndice":
    Si se dispone de memoria suficiente, se carga el fichero de 28Mb que usa el
    programa en memoria.
       Ventajas:  - Mayor velocidad en la descodificacin, apenas problemas
                  - La actividad del disco duro acaba a los pocos minutos
       Desventajas: Usar esta opcin slo si se tienen 64 Mb, de otro modo
                    el acceso a disco duro ser permanente
- "Activar el LOG"
    Activa o detiene la informacin sobre descodificacin y errores en
    la ventana MS-DOS


Parmetros de la lnea de comandos del programa:

  /inombre: Nombre del fichero .ini (por defecto dek.ini)

  /fnombre: Nombre del fichero de imgenes de prueba (por defecto TESTBI.BIN)

  /t:       Test, se carga el fichero de imgenes y lo visualiza constantemente.
            La tarjeta de TV no se inicializa y no chupa sus recursos.
            Se muestran los fps entre parntesis.

  /v:       Modo informativo, se muestran varios tests

  /hxxx:    Nmero de pixels horizontales, valores entre 350 y 800
            Por defecto: - 768 con los modos normales
                         - 704 con ELSA-Winner 2000-Office
            El nmero de pixels que llegan de la tarjeta de TV es crucial para la
            velocidad final, a menos pixels, mayor velocidad.
            Entrada en el .ini: h_pixels

  /2:       Nmero de pixels que se doblan horizontalmente. Si no se especifca,
            entonces se ponen tantos pixels como hayan.
            Por defecto: off


Algunos parmetros se pueden declarar tambin en el fichero .ini, aunque tienen
prioridad los indicados mediante la lnea de comando.

Para usar el programa existen las siguiente teclas:
'X' - Edicin en color usando rutinas MMX (por defecto con MMX)
'C' - Edicin en color sin MMX (por defecto sin MMX)
'M' - Edicin en monocromo sin cdigo MMX (sin MMX, es ms rpido)
'T' - Modo de testeo, no se escribe nada en la memoria de video

Para manejar el descodificador:
'A' - Autodetectar seal codificada basndose en la imgen (Nota de Hacky: no
      suele funcionar)
'E' - Cambia el modo entre codificado y descodificado, por si no te funciona
      el automtico (adems desactiva ese modo)
'B' - Muestra el final de la imagen recibida (Nota de Hacky: zona usada para
      transmitir datos tipo teletxto...)

Imgenes de prueba:
'R' - Lee el fichero de prueba y lo representa constantemente, midiendo los fps
'W' - Escribe los datos de video actuales en el fichero "TESTBI.BIN"
      El fichero consta de 10 imgenes completas (0,4 s) en el formato en el
      que le lleg de la tarjeta de TV y ocupa unos 9 Mb


Cambio de Canales:
'+' y '-' del teclado numrico


Otras funciones:
'I' - Zoom de la imgen (en el modo escritorio), otra pulsacin y restaurar
      el modo anterior
'S' - Pausa de la imgen, pulsar de nuevo para continuar
'N' - Nueva imgen en el modo pausa
'V' - Modo informativo, muestra diversa informacin del programa
'K' - Informacin del tiempo consumido por cada imgen
'1' - Descodifica slo media imagen
'F' - Imagen entera/con bandas
'ESC' Finaliza el programa y cierra sus ventanas



Problemas de rendimiento:

El programa requiere muchos recursos del ordenador, por lo tanto conviene
quitar otros programas que estn ejecutndose:
 - Pulsar el botn "Pausa" en las ventanas-DOS
 - Finalizar programas windows que consuman muchos recursos (Acrobar Reader es
   un ejemplo)
El programa establece su prioridad ms alta, para abarcar los mximos
recursos disponibles y aumentar as su rendimiento.
La prdida de rendimiento se puede observar mediante los fps alcanzados
Los fps se muestran en la lnea de estado. Se expone tambin el tiempo medio
usado por cada frame, lo que explica que se puedan superar los 25 frames/s. El
valor "Frames perdidos" indica cuntos frames a partir de los 50 no se pudieron
procesar, lo ideal: 0.

Nota: con resoluciones y profundidades de color grandes en el escritorio, la
      representacin suele ser ms lenta que a pantalla completa. Esto es bsicamente
      porque se requiere una mayor transferencia de datos, entre la memoria de
      video, el procesador y la tarjeta, por lo tanto se requiere ms tiempo.

Ningn procesador no MMX funcionar!

Como la representacin en modo informativo necesita tambin mucho tiempo,
debera estar apagado por defecto.


Otros problemas:

Sintonizadores:

Si no funciona la sintonizacin de emisoras, se debe probablemente a la incorrecta
eleccin del sintonizador, Philips o Temic, aunque existen otros sintonizadores
de marca desconocida.

Drivers:

El programa usa su propio driver para acceder a la direccin del chip BT848. Los
drivers originales no necesitan estar instalados.
Sin embargo, bajo windows 98 se puede necesitarlos para obtener su propia
interrupcin. Si los problemas persisten se puede acceder a la BIOS y cambiar
la entrada "Plug & Play OS" a "no".


Pruebas de rendimiento:

En el modo test, se descodifican y se muestran 20 frames de la forma habitual
a como se realiza normalmente con el fin de poder medir el rendimiento.

La tarjeta de TV no se inicializa en el modo test (/t en la lnea de comando).
Si se pulsa 'R' la tarjeta se inicializa y muestra el frame rate segn va
leyendo los datos de video a la memoria principal.

Si el modo de test no funciona, puede deberse a problemas con el DirectDraw.
Mira un canal sin codificar, y si no tira mira problemas relacionados con la
tarjeta de TV, como las IRQs, memoria, etc, dentro del panel de control, sistema.
Quizs no se deba a un problema con las IRQ, ya que se ha detectado
incompatibilidades con algunos chips Riva-TNT.
(Nota de Hacky: Que no quiere decir que no funcione con ningn TNT; yo poseo
una de estas tarjeta y funciona perfectamente)

Activa el modo informativo y el log para intentar averiguar algo ms.

Si te sale el mensaje de "Kein Speicher/Sin memoria", es que el driver no ha
sido capaz de suministrar memoria no paginada del kernel (3*900ks). En este
caso, y por culpa de la mala administracin del Kernel de windows, la nica
solucin posible es reiniciar. No tengo otra solucin mejor.

Si no te funciona autodetectar seal, ya sea debido a una mala recepcin o a
otro problema (N.Hacky: o que sencillamente no funciona :), la tecla 'E'
permite entrar en modo descodificador.

La seal grabada por un video de programas codificados, se descodifican mal
o nada en absoluto.


Fichero KEY.TXT:

El fichero llave. Dichos ficheros se pueden conseguir de Internet. El resultado
es idntico, slo los ficheros ndice se generan de nuevo.
