                       *********************
                       *** FAQ XDTV ***
                       *********************

************************************************************************

Notes entre les versions 1.7.5beta et 1.8.0
**************************************

Q: comment fait on pour utiliser le support xosd (en cours de dveloppement)?
R: Donc par defaut pas de xosd du tout.
Pour activer XOSD il faut compiler en faisant ./configure --enable-xosd

Puis ensuite lancer l'application en tapant xawdecode -xosd
(on peut aussi faire xawdecode -e "xosd")

Attention il existe encore pas mal de problmes  savoir:
1) l'OSD n'est pas centr
2) l'OSD n'est pas sur deux lignes
3) l'OSD n'est pas de retour a la ligne
4) un pt VT apparait lors de l'incrustation tltexte

Q: concernant -avi: ca lit bien les videos: par contre il n'y a pas le son?
R: ou cela n'a pas encore t implment

Q: si j'utilise -force_depth ou -force_visual j'ai sur quasiment sur toutes les propositions sauf celles courantes ca comme reponse: no good visual found
c'est normal ca?

R: Oui c'est normal.

En fait les display avec plusieurs depth d'affichage possibles sont tres tres rares....
mais j'ai rajoute cette option parce que le choix du depth et le choix du visual se font de la meme facon..

Par contre les display avec plusieurs visuals sont monnaies courante, pour avoir la liste des visual faire xdpyinfo....
Les display recent font du truecolor et du directcolor mais directcolor n'est pas un visual support par xawdecode donc tu n'as pas le choix... tu es oblig de choisir truecolor

L'interet de cette option est pour les display a 256 couleurs car en general ils ont un visual pseudocolor et un visual staticgray qui sont tous les deux supportes par xawdecode, donc pour choisir il faut utiliser cette option.

Donc si i vous voulez tester l'option -force_visual, lancer votre serveur X en 256 couleurs en tapant startx -- :2 -depth 8

dernier chose, il ne faut pas confondre l'option -force_depth qui permet de choisir le depth d'affichage, et l'option -b qui
est a utiliser si le programme de configuration de l'overlay (xawdecode_v4l-conf) n'arrive pas a trouver le bon depth de l'ecran, ce qui ne doit plus arriver avec les drivers recents donc NORMALEMENT ON N'A JAMAIS A UTILISER LES OPTIONS -b et -force_depth

************************************************************************

Notes entre les versions 1.7.0 et 1.7.5beta
**************************************

*Sous-titres:
************
Xawdecode est maintenant capable d'afficher les sous-titres diffuss sur
certains programmes, et mme de les enregistrer.
C'est un petit script, nomm 'xawdecode_subtitles.sh' qui s'en charge.
Il fonctionne paralllement  Xawdecode.
Pour pouvoir acqurir les sous-titres, il faut que le flux VBI soit utilis
par le script, et non par Xawdecode. La solution la plus simple est donc
de lancer celui-ci en premier.

$ xawdecode_subtitles.sh 888
$ xawdecode -rec_sub

(Si 888 est la page sur laquelle sont diffuss les sous-titres.
Cette page varie suivant le pays)

Il est aussi possible de lancer Xawdecode en premier grce  l'option '-novbi'.
L'option '-rec_sub' permet d'enregistrer les sous titres en parallle
de la vido au format MPlayer.

Pour plus d'infos lire le fichier README.subtitles

Une autre solution, plus simple est d'utiliser le 'xawdecode_wizard',
qui permet de choisir le mode de lancement de Xawdecode, et de lui envoyer
automatiquement les commutateurs ncessaires suivant les options choisies.

$ xawdecode_wizard


*Xawdecode_wizard:
****************
Cette nouvelle option, encore amliore depuis la version 1.7.0, simplifie
le lancement de Xawdecode.
Par l'intermdiaire d'une boite de dialogue, le wizard lance Xawdecode dans
le mode souhait en se passant des commutateurs (-noxv, -novbi, -rec_sub, etc).
Il peut aussi lancer le script xawdecode_scan.sh, puis diter le script ainsi
obtenu. Ceci est utile pour crer proprement le fichier de
configuration ~/.xawdecode/xawdecoderc.


*xawdecode_scan.sh:
*****************
Avant d'tre fonctionnel, Xawdecode doit tre configur. Ce script permet
de faire une recherche de canaux, de grer les canaux ainsi trouvs, et
enfin de placer les paramtres par dfaut pour la majorit des options.

*xawdecode_cmd:
*************
Cette commande, apparue avec la version 1.7.0, donne la possibilit
d'envoyer des commandes lors de l'utilisation de Xawdecode. Ces commandes
suivent la syntaxe dj utilise par Lirc pour piloter le soft.
Grce  cel, il est dsormais possible, par exemple, de programmer
un enregistrement grce  la commande 'at'

Exemple:

Lancer un enregistrement sur la 4eme chane:
$ xawdecode_cmd "setstation 3; record"

Les commandes disponibles sont les suivantes:
"setstation" "volume" "fullscreen" "setres" "showtime" "quit" "keypad" "record" "teletext"

Chaque argument doit tre spar par un ';'.
Il est aussi possible de passer des commandes  Xawdecode en argument,
lors de sont lancement, grace au commutateur '-e'

Exemple:

Pour dmarrer Xawdecode en mode plein cran sur la chane n3
$ xawdecode -e "setstation 2; fullscreen"


*Nouveaux commutateurs:
*********************
Pour l'enregistrement:
	-rec_fps fps : set recording framerate (default=25.0)
	-rec_display 0|1 : set display mode during recording (default=1)
	-rec_width width : set width of the recording video (default=384)
	-rec_videobr br : set recording video bitrate to br kbit/s (default=800)
	-rec_mp3cbr br : activate MP3 CBR and set bitrate to br kbit/s (default=activated, 128kbit/s)
	-rec_mp3vbr quality : activate MP3 VBR and set compressing quality (0=best, 9=worst)
	(default=deactivated, 	quality=8)
	-rec_vcodec xvid|ffmpeg_mpeg4|ffmpeg_mpeg1|divx4linux : set recording video codec
	-rec_maxgap :
Divers:
	-e : Envoie une srie de commandes  Xawdecode lors de son lancement
	-xvtv: Permet d'utiliser le support XV pour l'overlay

************************************************************************

Q: Les raccourcis clavier ne fonctionne pas!

A: Pour que les raccourcis clavier fonctionnent, il faut:
   1 ) que xawdecode ait t install par make install (ou  partir d'un 
       RPM). En effet, le processus d'installation recopie le fichier de 
       ressources X11 Xawdecode.ad dans le rpertoire systme des 
       fichiers de ressources X11,  savoir, /usr/X11R6/lib/X11/app-defaults
       (ceci peut changer en fonction des distributions), en le 
       renommant Xawdecode.

   2)  que la fentre TV aie le focus (fentre selectionne avec le 
       curseur souris  l'intrieur).
   
Q: Oui, mais moi j'ai le fichier de ressources install l o il faut et
   je n'arrive pas obtenir le focus sur xawdecode!

A: C'est un problme qui se manifeste sur les version 1.3 et 1.3.1 suite
    la rcriture des scripts autoconf/automake et qui est corrig  partir
   de la version 1.3.2. 
   On peut corriger soi-mme le problme sur les versions 1.3 et 1.3.1
   en modifiant l'ordre des librairies lors du link. Il faut linker avec
   -lXaw3d (ou -lXaw) en 1er, puis -lXt en 2me, les autres switch -lxxxx
   ne changeant pas de place.

************************************************************************

Q: Xawdecode plante au dmarrage avec une erreur du type:

	No Xv port available.
	Successfully find YUY2 XvImage port : -1
	X Error of failed request: XvBadPort

A: Lancer xawdecode avec l'option -no-xv, ou mieux, utiliser une version 
   plus rcente (> 1.3.1) ou encore une version 1.3.1 compile avec le 
   patch Xv.

************************************************************************

Q: Xawdecode plante au dmarrage avec une erreur du type:
	The app-defaults file is not correctly installed.
	Your fault (core dumped)

A: La plante se produit parce que xawdecode ne trouve pas son fichier de 
   ressources X11 qui est normalement install par make install dans le 
   rpertoire systme des ressources X11. Ce rpertoire est usuellement 
   /usr/X11R6/lib/X11/app-defaults et il faut y copier le fichier 
   Xawdecode.ad en le renommant Xawdecode

************************************************************************

Q: quand je passe en mode plein cran, j'ai la tl en tout petit au milieu du
   reste de l'cran qui est noir

A: Ce problme de plein cran est un simple problme de configuration.

1)
Dans ~/.xawdecode/xawdecoderc, il faut mettre une ligne:
fullscreen=640x480
ou mieux encore
fullscreen=768x576

2)
Il est prfrable d'utiliser XFree86 4.0.x (voire mme 4.1) et non pas XFree86 3.3.6.
Pourquoi?
Pour 3 raisons.

* La 1re c'est que XFree86 4 sait lire les donnes EDID du moniteur et sait
 donc comment le commander pour utiliser les modes videos prdfinis en usine
 (640x480, 800x600, 1024x768, 1280x1024, etc..).

* La 2me raison, c'est que XFree86 4 apporte un meilleur support des devices
  v4l (video for linux)  condition toutefois de bien penser  mettre la ligne:
  Load "v4l"
  dans la section "Module" du fichier de config de XFree, en gnral
  /etc/X11/XF86Config-4

* La 3me, c'est que XFree86 4 apporte l'extension XVideo qui ,  condition
  d'avoir les drivers de carte video adquats, permet de faire de
  l'acclration matrielle pour l'affichage d'image au format YVU.

Les cartes concernes:
g200/g400 : xfree 4.x supports these out-of-the-box
nvidia cards : www.nvidia.com (the've got binary drivers)
ATI cards : GATOS www.linuxvideo.org/gatos/
i815 : the latest xfree 4.x code supports these
3dfx (voodoo): the latest xfree 4.x code supports these
savage : http://www.probo.com/timr/savage40.html

De plus, avec Xvideo, c'est la carte video qui effectue le redimensionnement
de l'image si ncessaire.

Il y a un problme avec Mandrake: c'est que leur version de XFree86 4 et TRES
lente quand on utilise Xvideo avec du YVU.... Dans ce cas, ne pas hsiter 
lancer xawdecode avec l'option -noxv !!!

Donc, si on utilise XFree86 4 et fullscreen=640x480, c'est bon, il n'y a plus
rien  faire car XFree saura tout seul comment mettre le moniteur en 640x480.

Si on met fullscreen=768x578, alors il faut rajouter un modeline dans le fichier
de config de XFree pour lui dire comment piloter le moniteur. Et l, il n'y a
pas de recette miracle, car a dpend des caractristiques techniques du
moniteur.
Mais, il existe le site Colas XFree Modeline Generator
(http://www-sop.inria.fr/cgi-bin/koala/nph-colas-modelines) qui aide  calculer
le modeline adquat.
Pour ceux qui utilisent encore XFree86 3.3.6, il faudra alors mettre un modeline
pour TOUS les modes videos que l'on souhaite utiliser avec le moniteur.

3)
Il faut aussi dire dans le fichier de config de XFree quels sont les modes
videos que l'on peux utiliser (et oui, dfinir les modelines n'est pas
suffisant!).

Cela se fait dans la section "Screen", avec des lignes du type :

Subsection "Display"
  Depth 16
  Modes "1280x1024" "1024x768" "800x600" "768x576" "640x480"
  ViewPort 0 0
EndSubsection

Et puis pour de meilleures performances, il vaut mieux lancer XFree en 16bpp
plutt qu'en 24 ou 32bpp, surtout en -noxv.
De plus, un fullscreen configur en 640x480 permettra un petit gain sur les
performances sans pour autant nuire  la qualit.
Avec a, on DOIT avoir un fullscreen impeccable avec xawdecode, que l'on utilise
le mode Xv (Xvideo) ou le mode "traditionnel" avec -noxv.


************************************************************************


Q: Comment savoir si on utilise bien Xfree86 4 et non pas 3?

A:
1) /etc/X11/X est un lien symbolique vers ../../usr/X11R6/bin/XFree86
2) il existe un fichier de log /var/log/XFree86.0.log


************************************************************************

Q: comment gnrer un RPM binaire  partir du .tar.gz des sources ?
1) Se mettre root,
2) Faire: rpm -tb xawdecode-1.3.8.tar.gz
et hop, a detare, a configure, a compile, a cre le RPM binaire et a te le
met dans /usr/src/RPM/RPMS/i686
3) y a plus qu' installer:
rpm -ivh /usr/src/RPM/RPMS/i686/xawdecode-1.3.8-1.i868.rpm
Voila!
C'est 1000 fois mieux de recompiler le package sur son systme, comme a il n'y
a aucun problme d'incompatibilit vis  vis des librairies qui ont servi a
gnrer le RPM binaire...


************************************************************************

Q: Faut il utiliser xawdecode en tant que root?

A: Absolument pas, ceci est totalement dconseiller!!!
Bien videment, il FAUT utiliser xawdecode en tant qu'utilisateur normal, et pas
en tant que root. C'est un principe gnral sur un systme unix: le compte root
ne doit servir qu' administrer le systme, un point c'est tout. Idalement, il
ne faudrait d'ailleurs mme jamais ouvrir de session X11 en tant que root.


************************************************************************

Q: Quand je lance xawdecode j'ai un message du type "can't acces mixer" ou "can't
access vbi"....

A: C'est un problme gnral d'autorisation d'accs au priphrique en question.

Le probleme d'accs  un priphrique (/dev/dsp, /dev/vbi, /dev/video,
/dev/mixer, etc...)
Tout d'abord vrifier que /dev/video existe et est un lien symbolique vers
/dev/video0.
Si besoin, le crer: ln -s /dev/video0 /dev/video (en tant que root).
Idem pour /dev/vbi qui doit tre un lien symbolique vers /dev/vbi0.

Ensuite, les problmes de groupes...
Dans les distribs rcentes, l'accs aux diffrents priphriques est gr par
l'appartenance  des groupes spcifiques: un groupe ddi par type de
priphrique.
Par exemple, les priphriques audio comme /dev/dsp appartient  root, groupe
audio. Donc pour que tartanpion puisse se servir de la carte son, il faut que
tartanpion fasse partie du groupe audio.
Il peut en tre de mme pour l'accs  la carteTV (/dev/video0, owner=root,
group=video ou sys), du lecteur de cdrom (/dev/cdrom -> /dev/hdc et /dev/hdc,
group=cdrom) , de l'imprimante (group=lp ou printer), du modem (group=modem ou
uucp ou dialup ...).
Donc pour se servir de tout ces devices, l'utilisateur tartanpion devra faire
partie des groupes cdrom, audio, video, lp, uucp....
Cela permet  l'administrateur du systme de contrler finement qui peut avoir
accs  quoi!
Il faut quand mme s'assurer que le groupe a le droit d'utiliser les devices:
(en tant que root, faire)
$ chmod g+rw /dev/video0
$ chmod g+rw /dev/vbi0
$ chmod g+rw /dev/audio0
$ chmod g+rw /dev/mixer
$ chmod g+rw /dev/dsp
En mme temps, en profiter pour vrifier  quel groupe appartient les devices:
(Exemple pris sur une Mandrake 8.0)
$ ls -l /dev/video0
nous donne:
crw-rw---- 1 root sys 81, 0 Apr 14 13:06 /dev/video0
et
$ ls -l /dev/audio0
nous donne:
crw-rw---- 1 root audio 14, 4 Apr 14 13:06 /dev/audio0
Donc, il faut que tartanpion fasse au moins partie des groupes sys et audio!
Au passage, c'est une mauvaise ide que de faire appertenir la carte video au
groupe sys, le groupe banalis video serait plus sr.... Mais, bon, c'est le
choix qu'a fait Mandrake...
Bon, c'est bien beau tout a, mais comment on ajoute un utilisateur comme membre
d'un groupe? Tout d'abord, il faut lister les groupes auxquels appartient dj
l'utilisateur (que l'on va appeler gagai pour l'example):
$ id -a gagai
donne la rponse:
uid=993(gagai) gid=21(gagai) groups=21(gagai),22(cdrom),43(usb),80(cdwriter),504(xgrp)
Cela nous indique que l'utilisateur "gagai" a comme groupe par dfaut "gagai" et
appartient aux groupes: gagai (c'est normal, vu que c'est son groupe par
dfaut!!), cdrom, usb, cdwriter, xgrp.
Pour lui ajouter l'accs aux groupes sys et audio, il faut alors faire (en tant
que root, bien sr):
$ usermod -g gagai -G gagai,cdrom,usb,cdwriter,xgrp,sys,audio gagai
le "-g gagai" c'est pour spcifier le groupe principal
le "-G gagai,cdrom, .... ,audio" c'est pour spcifier TOUS les groupes auxquels
l'utilisateur appartient. Attention: il faut remettre TOUS les groupes!!!
le gagai final, c'est pour spcifier l'utilisateur auquel s'applique ces modifs.
Pour que les modifications prennent effet, l'utilisateur gagai devra se dlogger
et se relogger sr le systme (surtout si les modifs ont t faites  partir
d'une fentre root lance depuis une session X11 ouverte par l'utilisateur
gagai, ce qui est le cas dans 95% des cas).


************************************************************************


Q: J'ai des espces de points parasites blancs qui apparaissent quand je
   passe d'une chaine en grabdisplay  une chaine en overlay (ou vice-versa)

A: mettre colorkey = 123456 dans le .xawdecoderc

