annotate DOCS/tech/swscaler_filters.txt @ 13568:1cb0e1833515

Currently vbeGetProtModeInfo call the 0x4f0a function of int 10h the get a simple 32 bits protected mode interface to some VESA functions. This protected mode interface is interesting because it's quicker than the raw int 10h interface. Unfortunatly, begining with VBE 3.0, the 0x4f0a function is optional, and some video cards don't implement it (3dfx, intel 845/855/865...). This protected mode interface is then only used in vbeSetWindow and vbeSetDisplayStart : ?- vbeSetWindow already implement an alternative methode if protected mode interface is not available. ?- vbeSetDisplayStart also contain an alternative implementation, but this one is disabled with a #if 0. I don't exactly know why because it works well ! So currently, cards which don't have the 0x4f0a function are not supported. This patch correct this. ?- vbeGetProtModeInfo failure is not fatal. ?- vbeSetDisplayStart has it's alternative implementation reenabled. ? ?it's used only with cards which don't have the 0x4f0a function ? ?so this won't make any difference for cards which were already ? ?working. This patch also make the failure of vbeGetModeInfo not fatal. The VBE 3.0 standard state that GetModeInfo can fail with some mode which are listed as supported if the mode can't be used in the current situation (not enough video memory for example). So a failure of vbeGetModeInfo don't mean that other modes won't work and should really not be fatal. patch by Aurelien Jacobs <[e-mail]>

software scaler filter docs

-ssf cgb=<float> chrominance gaussian blur
	usefull for videos with some chroma (color) noise (TV captures, VHS, ...)

-ssf lgb=<float> -> luminance gaussian blur
	hmm, mostly special effect, could be used as lame noise reducer though

-ssf chs=<int> -> shift chrominance horizontally
-ssf cvs=<int> -> shift chrominance vertically
	usefull if the luma & chroma are not aligned exactly

-ssf cs=<float> -> chrominance sharpen
-ssf ls=<float> -> luminance sharpen
	simple sharpening filter

note: these will only work if the swscaler is used at all (use -vf scale)

example: mplayer foobar.avi -vf scale -ssf lgb=3.0