From 3b77fb74cf249011213816403980f3bb909c6f78 Mon Sep 17 00:00:00 2001 From: EntranceJew Date: Fri, 31 Jul 2015 15:37:25 -0400 Subject: [PATCH] Added libtheora. --- CMakeLists.txt | 10 + libs/libtheora-1.1/AUTHORS | 49 + libs/libtheora-1.1/CHANGES | 243 + libs/libtheora-1.1/CMakeLists.txt | 48 + libs/libtheora-1.1/COPYING | 28 + libs/libtheora-1.1/LICENSE | 18 + libs/libtheora-1.1/Makefile.am | 35 + libs/libtheora-1.1/README | 152 + libs/libtheora-1.1/SConstruct | 225 + libs/libtheora-1.1/autogen.sh | 130 + libs/libtheora-1.1/configure.ac | 531 ++ libs/libtheora-1.1/debian/changelog | 15 + libs/libtheora-1.1/debian/control | 24 + libs/libtheora-1.1/debian/copyright | 38 + .../debian/libtheora-dev.install | 5 + libs/libtheora-1.1/debian/libtheora0.install | 2 + libs/libtheora-1.1/debian/rules | 3 + libs/libtheora-1.1/debian/watch | 3 + libs/libtheora-1.1/doc/Doxyfile.in | 1142 +++ libs/libtheora-1.1/doc/Makefile.am | 72 + libs/libtheora-1.1/doc/color.html | 602 ++ .../doc/draft-ietf-avt-rtp-theora-00.txt | 1400 +++ .../doc/draft-ietf-avt-rtp-theora-00.xml | 1146 +++ .../doc/draft-kerr-avt-theora-rtp-00.txt | 1512 +++ .../doc/draft-kerr-avt-theora-rtp-00.xml | 1277 +++ libs/libtheora-1.1/doc/spec/Makefile.am | 81 + libs/libtheora-1.1/doc/spec/fdct.fig | 371 + libs/libtheora-1.1/doc/spec/hilbert-block.fig | 104 + libs/libtheora-1.1/doc/spec/hilbert-mb.fig | 32 + libs/libtheora-1.1/doc/spec/idct.fig | 369 + libs/libtheora-1.1/doc/spec/lflim.fig | 23 + libs/libtheora-1.1/doc/spec/ltablex.sty | 237 + libs/libtheora-1.1/doc/spec/macroblock.fig | 37 + libs/libtheora-1.1/doc/spec/pic-frame.fig | 75 + libs/libtheora-1.1/doc/spec/pic_even.fig | 102 + libs/libtheora-1.1/doc/spec/pic_even_odd.fig | 88 + libs/libtheora-1.1/doc/spec/pic_odd.fig | 90 + libs/libtheora-1.1/doc/spec/pic_odd_even.fig | 84 + libs/libtheora-1.1/doc/spec/pixel420.fig | 56 + libs/libtheora-1.1/doc/spec/pixel422.fig | 70 + libs/libtheora-1.1/doc/spec/pixel444.fig | 44 + libs/libtheora-1.1/doc/spec/raster-block.fig | 91 + .../doc/spec/reference-frames.fig | 46 + libs/libtheora-1.1/doc/spec/spec.bib | 120 + libs/libtheora-1.1/doc/spec/spec.tex | 8194 +++++++++++++++++ libs/libtheora-1.1/doc/spec/superblock.fig | 72 + libs/libtheora-1.1/doc/spec/vp3huff.c | 918 ++ libs/libtheora-1.1/doc/spec/xifish.fig | 85 + libs/libtheora-1.1/doc/vp3-format.txt | 1305 +++ libs/libtheora-1.1/examples/Makefile.am | 41 + libs/libtheora-1.1/examples/README_SPLAYER | 21 + libs/libtheora-1.1/examples/dump_psnr.c | 1210 +++ libs/libtheora-1.1/examples/dump_video.c | 496 + libs/libtheora-1.1/examples/encoder_example.c | 1830 ++++ libs/libtheora-1.1/examples/getopt.c | 1055 +++ libs/libtheora-1.1/examples/getopt.h | 180 + libs/libtheora-1.1/examples/getopt1.c | 188 + libs/libtheora-1.1/examples/player_example.c | 887 ++ libs/libtheora-1.1/examples/png2theora.c | 942 ++ libs/libtheora-1.1/examples/splayer.c | 1107 +++ libs/libtheora-1.1/include/Makefile.am | 3 + libs/libtheora-1.1/include/theora/Makefile.am | 7 + libs/libtheora-1.1/include/theora/codec.h | 591 ++ libs/libtheora-1.1/include/theora/theora.h | 784 ++ libs/libtheora-1.1/include/theora/theoradec.h | 325 + libs/libtheora-1.1/include/theora/theoraenc.h | 500 + libs/libtheora-1.1/lib/Makefile.am | 177 + libs/libtheora-1.1/lib/Version_script | 53 + libs/libtheora-1.1/lib/Version_script-dec | 82 + libs/libtheora-1.1/lib/Version_script-enc | 43 + libs/libtheora-1.1/lib/analyze.c | 2701 ++++++ libs/libtheora-1.1/lib/apiwrapper.c | 166 + libs/libtheora-1.1/lib/apiwrapper.h | 54 + libs/libtheora-1.1/lib/bitpack.c | 111 + libs/libtheora-1.1/lib/bitpack.h | 60 + libs/libtheora-1.1/lib/cpu.c | 226 + libs/libtheora-1.1/lib/cpu.h | 34 + libs/libtheora-1.1/lib/dct.h | 31 + libs/libtheora-1.1/lib/decapiwrapper.c | 193 + libs/libtheora-1.1/lib/decinfo.c | 246 + libs/libtheora-1.1/lib/decint.h | 107 + libs/libtheora-1.1/lib/decode.c | 2943 ++++++ libs/libtheora-1.1/lib/defexp.awk | 27 + libs/libtheora-1.1/lib/dequant.c | 182 + libs/libtheora-1.1/lib/dequant.h | 27 + libs/libtheora-1.1/lib/encapiwrapper.c | 168 + libs/libtheora-1.1/lib/encfrag.c | 388 + libs/libtheora-1.1/lib/encinfo.c | 121 + libs/libtheora-1.1/lib/encint.h | 490 + libs/libtheora-1.1/lib/encode.c | 1627 ++++ libs/libtheora-1.1/lib/encoder_disabled.c | 67 + libs/libtheora-1.1/lib/enquant.c | 274 + libs/libtheora-1.1/lib/enquant.h | 27 + libs/libtheora-1.1/lib/fdct.c | 422 + libs/libtheora-1.1/lib/fragment.c | 87 + libs/libtheora-1.1/lib/huffdec.c | 489 + libs/libtheora-1.1/lib/huffdec.h | 92 + libs/libtheora-1.1/lib/huffenc.c | 910 ++ libs/libtheora-1.1/lib/huffenc.h | 19 + libs/libtheora-1.1/lib/huffman.h | 70 + libs/libtheora-1.1/lib/idct.c | 335 + libs/libtheora-1.1/lib/info.c | 131 + libs/libtheora-1.1/lib/internal.c | 262 + libs/libtheora-1.1/lib/internal.h | 509 + libs/libtheora-1.1/lib/mathops.c | 296 + libs/libtheora-1.1/lib/mathops.h | 141 + libs/libtheora-1.1/lib/mcenc.c | 767 ++ libs/libtheora-1.1/lib/modedec.h | 4027 ++++++++ libs/libtheora-1.1/lib/ocintrin.h | 128 + libs/libtheora-1.1/lib/quant.c | 119 + libs/libtheora-1.1/lib/quant.h | 33 + libs/libtheora-1.1/lib/rate.c | 1137 +++ libs/libtheora-1.1/lib/state.c | 1227 +++ libs/libtheora-1.1/lib/theora.def | 56 + libs/libtheora-1.1/lib/theora.exp | 55 + libs/libtheora-1.1/lib/theoradec.exp | 43 + libs/libtheora-1.1/lib/theoraenc.exp | 15 + libs/libtheora-1.1/lib/tokenize.c | 1072 +++ libs/libtheora-1.1/lib/x86/mmxencfrag.c | 900 ++ libs/libtheora-1.1/lib/x86/mmxfdct.c | 665 ++ libs/libtheora-1.1/lib/x86/mmxfrag.c | 293 + libs/libtheora-1.1/lib/x86/mmxfrag.h | 64 + libs/libtheora-1.1/lib/x86/mmxidct.c | 564 ++ libs/libtheora-1.1/lib/x86/mmxloop.h | 215 + libs/libtheora-1.1/lib/x86/mmxstate.c | 188 + libs/libtheora-1.1/lib/x86/sse2fdct.c | 523 ++ libs/libtheora-1.1/lib/x86/x86enc.c | 49 + libs/libtheora-1.1/lib/x86/x86enc.h | 47 + libs/libtheora-1.1/lib/x86/x86int.h | 42 + libs/libtheora-1.1/lib/x86/x86state.c | 62 + libs/libtheora-1.1/lib/x86_vc/mmxencfrag.c | 969 ++ libs/libtheora-1.1/lib/x86_vc/mmxfdct.c | 670 ++ libs/libtheora-1.1/lib/x86_vc/mmxfrag.c | 337 + libs/libtheora-1.1/lib/x86_vc/mmxfrag.h | 61 + libs/libtheora-1.1/lib/x86_vc/mmxidct.c | 562 ++ libs/libtheora-1.1/lib/x86_vc/mmxloop.h | 219 + libs/libtheora-1.1/lib/x86_vc/mmxstate.c | 211 + libs/libtheora-1.1/lib/x86_vc/x86enc.c | 49 + libs/libtheora-1.1/lib/x86_vc/x86enc.h | 47 + libs/libtheora-1.1/lib/x86_vc/x86int.h | 42 + libs/libtheora-1.1/lib/x86_vc/x86state.c | 62 + libs/libtheora-1.1/libtheora.spec.in | 82 + libs/libtheora-1.1/m4/Makefile.am | 6 + libs/libtheora-1.1/m4/as-ac-expand.m4 | 43 + libs/libtheora-1.1/m4/ogg.m4 | 116 + libs/libtheora-1.1/m4/pkg.m4 | 157 + libs/libtheora-1.1/m4/sdl.m4 | 180 + libs/libtheora-1.1/m4/vorbis.m4 | 122 + .../macosx/English.lproj/InfoPlist.strings | Bin 0 -> 142 bytes libs/libtheora-1.1/macosx/Info.plist | 30 + .../macosx/Theora.xcodeproj/project.pbxproj | 864 ++ libs/libtheora-1.1/macosx/Theora_Prefix.pch | 5 + libs/libtheora-1.1/symbian/bld.inf | 35 + libs/libtheora-1.1/symbian/config.h | 57 + libs/libtheora-1.1/symbian/theora.mmp | 41 + libs/libtheora-1.1/tests/Makefile.am | 69 + libs/libtheora-1.1/tests/comment.c | 91 + libs/libtheora-1.1/tests/comment_theora.c | 91 + libs/libtheora-1.1/tests/granulepos.c | 149 + libs/libtheora-1.1/tests/granulepos_theora.c | 154 + libs/libtheora-1.1/tests/noop.c | 119 + libs/libtheora-1.1/tests/noop_theora.c | 88 + libs/libtheora-1.1/tests/tests.h | 33 + libs/libtheora-1.1/theora-uninstalled.pc.in | 14 + libs/libtheora-1.1/theora.pc.in | 14 + .../libtheora-1.1/theoradec-uninstalled.pc.in | 14 + libs/libtheora-1.1/theoradec.pc.in | 14 + .../libtheora-1.1/theoraenc-uninstalled.pc.in | 14 + libs/libtheora-1.1/theoraenc.pc.in | 14 + libs/libtheora-1.1/win32/VS2005/README | 22 + .../dump_video/dump_video_dynamic.vcproj | 108 + .../dump_video/dump_video_static.vcproj | 108 + .../encoder_example_dynamic.vcproj | 104 + .../encoder_example_static.vcproj | 104 + .../libtheora-1.1/win32/VS2005/libogg.vsprops | 19 + .../VS2005/libtheora/libtheora_dynamic.vcproj | 688 ++ .../VS2005/libtheora/libtheora_static.vcproj | 690 ++ .../win32/VS2005/libtheora_dynamic.sln | 82 + .../win32/VS2005/libtheora_static.sln | 82 + .../win32/VS2005/libvorbis.vsprops | 19 + libs/libtheora-1.1/win32/VS2008/README | 22 + .../dump_video/dump_video_dynamic.vcproj | 104 + .../dump_video/dump_video_static.vcproj | 104 + .../encoder_example_dynamic.vcproj | 100 + .../encoder_example_static.vcproj | 100 + .../libtheora-1.1/win32/VS2008/libogg.vsprops | 19 + .../VS2008/libtheora/libtheora_dynamic.vcproj | 576 ++ .../VS2008/libtheora/libtheora_static.vcproj | 566 ++ .../win32/VS2008/libtheora_dynamic.sln | 146 + .../win32/VS2008/libtheora_static.sln | 146 + .../win32/VS2008/libvorbis.vsprops | 19 + libs/libtheora-1.1/win32/VS2010/README | 22 + .../dump_video/dump_video_dynamic.vcxproj | 198 + .../dump_video/dump_video_static.vcxproj | 198 + .../encoder_example_dynamic.vcxproj | 204 + .../encoder_example_static.vcxproj | 204 + libs/libtheora-1.1/win32/VS2010/libogg.props | 22 + .../libtheora/libtheora_dynamic.vcxproj | 285 + .../VS2010/libtheora/libtheora_static.vcxproj | 251 + .../win32/VS2010/libtheora_dynamic.sln | 46 + .../win32/VS2010/libtheora_static.sln | 46 + .../win32/VS2010/libvorbis.props | 22 + .../win32/build_theora_static.bat | 18 + .../win32/build_theora_static_debug.bat | 18 + .../win32/experimental/dumpvid/dumpvid.dsp | 121 + .../win32/experimental/encoderwin/ReadMe.txt | 13 + .../experimental/encoderwin/encoderwin.dsp | 121 + .../experimental/transcoder/avi2vp3/avi2vp3.c | 82 + .../experimental/transcoder/avi2vp3/avilib.c | 1839 ++++ .../experimental/transcoder/avi2vp3/avilib.h | 309 + .../transcoder/avi2vp3/outfile.vp3 | Bin 0 -> 233132 bytes .../experimental/transcoder/avi2vp3/vp31.avi | Bin 0 -> 299724 bytes .../win32/experimental/transcoder/readme.txt | 17 + .../experimental/transcoder/transcoder.dsp | 121 + .../transcoder/transcoder_example.c | 926 ++ .../win32/experimental/wincompat/README.txt | 1 + .../win32/experimental/wincompat/getopt.c | 122 + .../win32/experimental/wincompat/getopt.h | 110 + .../experimental/wincompat/getopt_long.c | 547 ++ .../win32/experimental/wincompat/unistd.h | 0 libs/libtheora-1.1/win32/getopt.c | 1047 +++ libs/libtheora-1.1/win32/getopt1.c | 188 + libs/libtheora-1.1/win32/getopt_win.h | 169 + libs/libtheora-1.1/win32/theora_static.dsp | 336 + libs/libtheora-1.1/win32/xmingw32/Makefile | 393 + .../win32/xmingw32/libtheoradec-all.def | 58 + .../win32/xmingw32/libtheoradec-all.rc | 39 + .../win32/xmingw32/libtheoradec.rc | 3 + .../win32/xmingw32/libtheoradec70.rc | 3 + .../win32/xmingw32/libtheoradec70d.rc | 3 + .../win32/xmingw32/libtheoradec71.rc | 3 + .../win32/xmingw32/libtheoradec71d.rc | 3 + .../win32/xmingw32/libtheoradec80.rc | 3 + .../win32/xmingw32/libtheoradec80d.rc | 3 + .../win32/xmingw32/libtheoradecd.rc | 3 + .../win32/xmingw32/libtheoraenc-all.def | 17 + .../win32/xmingw32/libtheoraenc-all.rc | 39 + .../win32/xmingw32/libtheoraenc.rc | 3 + .../win32/xmingw32/libtheoraenc70.rc | 3 + .../win32/xmingw32/libtheoraenc70d.rc | 3 + .../win32/xmingw32/libtheoraenc71.rc | 3 + .../win32/xmingw32/libtheoraenc71d.rc | 3 + .../win32/xmingw32/libtheoraenc80.rc | 3 + .../win32/xmingw32/libtheoraenc80d.rc | 3 + .../win32/xmingw32/libtheoraencd.rc | 3 + 245 files changed, 76220 insertions(+) create mode 100644 libs/libtheora-1.1/AUTHORS create mode 100644 libs/libtheora-1.1/CHANGES create mode 100644 libs/libtheora-1.1/CMakeLists.txt create mode 100644 libs/libtheora-1.1/COPYING create mode 100644 libs/libtheora-1.1/LICENSE create mode 100644 libs/libtheora-1.1/Makefile.am create mode 100644 libs/libtheora-1.1/README create mode 100644 libs/libtheora-1.1/SConstruct create mode 100644 libs/libtheora-1.1/autogen.sh create mode 100644 libs/libtheora-1.1/configure.ac create mode 100644 libs/libtheora-1.1/debian/changelog create mode 100644 libs/libtheora-1.1/debian/control create mode 100644 libs/libtheora-1.1/debian/copyright create mode 100644 libs/libtheora-1.1/debian/libtheora-dev.install create mode 100644 libs/libtheora-1.1/debian/libtheora0.install create mode 100644 libs/libtheora-1.1/debian/rules create mode 100644 libs/libtheora-1.1/debian/watch create mode 100644 libs/libtheora-1.1/doc/Doxyfile.in create mode 100644 libs/libtheora-1.1/doc/Makefile.am create mode 100644 libs/libtheora-1.1/doc/color.html create mode 100644 libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.txt create mode 100644 libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.xml create mode 100644 libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.txt create mode 100644 libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.xml create mode 100644 libs/libtheora-1.1/doc/spec/Makefile.am create mode 100644 libs/libtheora-1.1/doc/spec/fdct.fig create mode 100644 libs/libtheora-1.1/doc/spec/hilbert-block.fig create mode 100644 libs/libtheora-1.1/doc/spec/hilbert-mb.fig create mode 100644 libs/libtheora-1.1/doc/spec/idct.fig create mode 100644 libs/libtheora-1.1/doc/spec/lflim.fig create mode 100644 libs/libtheora-1.1/doc/spec/ltablex.sty create mode 100644 libs/libtheora-1.1/doc/spec/macroblock.fig create mode 100644 libs/libtheora-1.1/doc/spec/pic-frame.fig create mode 100644 libs/libtheora-1.1/doc/spec/pic_even.fig create mode 100644 libs/libtheora-1.1/doc/spec/pic_even_odd.fig create mode 100644 libs/libtheora-1.1/doc/spec/pic_odd.fig create mode 100644 libs/libtheora-1.1/doc/spec/pic_odd_even.fig create mode 100644 libs/libtheora-1.1/doc/spec/pixel420.fig create mode 100644 libs/libtheora-1.1/doc/spec/pixel422.fig create mode 100644 libs/libtheora-1.1/doc/spec/pixel444.fig create mode 100644 libs/libtheora-1.1/doc/spec/raster-block.fig create mode 100644 libs/libtheora-1.1/doc/spec/reference-frames.fig create mode 100644 libs/libtheora-1.1/doc/spec/spec.bib create mode 100644 libs/libtheora-1.1/doc/spec/spec.tex create mode 100644 libs/libtheora-1.1/doc/spec/superblock.fig create mode 100644 libs/libtheora-1.1/doc/spec/vp3huff.c create mode 100644 libs/libtheora-1.1/doc/spec/xifish.fig create mode 100644 libs/libtheora-1.1/doc/vp3-format.txt create mode 100644 libs/libtheora-1.1/examples/Makefile.am create mode 100644 libs/libtheora-1.1/examples/README_SPLAYER create mode 100644 libs/libtheora-1.1/examples/dump_psnr.c create mode 100644 libs/libtheora-1.1/examples/dump_video.c create mode 100644 libs/libtheora-1.1/examples/encoder_example.c create mode 100644 libs/libtheora-1.1/examples/getopt.c create mode 100644 libs/libtheora-1.1/examples/getopt.h create mode 100644 libs/libtheora-1.1/examples/getopt1.c create mode 100644 libs/libtheora-1.1/examples/player_example.c create mode 100644 libs/libtheora-1.1/examples/png2theora.c create mode 100644 libs/libtheora-1.1/examples/splayer.c create mode 100644 libs/libtheora-1.1/include/Makefile.am create mode 100644 libs/libtheora-1.1/include/theora/Makefile.am create mode 100644 libs/libtheora-1.1/include/theora/codec.h create mode 100644 libs/libtheora-1.1/include/theora/theora.h create mode 100644 libs/libtheora-1.1/include/theora/theoradec.h create mode 100644 libs/libtheora-1.1/include/theora/theoraenc.h create mode 100644 libs/libtheora-1.1/lib/Makefile.am create mode 100644 libs/libtheora-1.1/lib/Version_script create mode 100644 libs/libtheora-1.1/lib/Version_script-dec create mode 100644 libs/libtheora-1.1/lib/Version_script-enc create mode 100644 libs/libtheora-1.1/lib/analyze.c create mode 100644 libs/libtheora-1.1/lib/apiwrapper.c create mode 100644 libs/libtheora-1.1/lib/apiwrapper.h create mode 100644 libs/libtheora-1.1/lib/bitpack.c create mode 100644 libs/libtheora-1.1/lib/bitpack.h create mode 100644 libs/libtheora-1.1/lib/cpu.c create mode 100644 libs/libtheora-1.1/lib/cpu.h create mode 100644 libs/libtheora-1.1/lib/dct.h create mode 100644 libs/libtheora-1.1/lib/decapiwrapper.c create mode 100644 libs/libtheora-1.1/lib/decinfo.c create mode 100644 libs/libtheora-1.1/lib/decint.h create mode 100644 libs/libtheora-1.1/lib/decode.c create mode 100644 libs/libtheora-1.1/lib/defexp.awk create mode 100644 libs/libtheora-1.1/lib/dequant.c create mode 100644 libs/libtheora-1.1/lib/dequant.h create mode 100644 libs/libtheora-1.1/lib/encapiwrapper.c create mode 100644 libs/libtheora-1.1/lib/encfrag.c create mode 100644 libs/libtheora-1.1/lib/encinfo.c create mode 100644 libs/libtheora-1.1/lib/encint.h create mode 100644 libs/libtheora-1.1/lib/encode.c create mode 100644 libs/libtheora-1.1/lib/encoder_disabled.c create mode 100644 libs/libtheora-1.1/lib/enquant.c create mode 100644 libs/libtheora-1.1/lib/enquant.h create mode 100644 libs/libtheora-1.1/lib/fdct.c create mode 100644 libs/libtheora-1.1/lib/fragment.c create mode 100644 libs/libtheora-1.1/lib/huffdec.c create mode 100644 libs/libtheora-1.1/lib/huffdec.h create mode 100644 libs/libtheora-1.1/lib/huffenc.c create mode 100644 libs/libtheora-1.1/lib/huffenc.h create mode 100644 libs/libtheora-1.1/lib/huffman.h create mode 100644 libs/libtheora-1.1/lib/idct.c create mode 100644 libs/libtheora-1.1/lib/info.c create mode 100644 libs/libtheora-1.1/lib/internal.c create mode 100644 libs/libtheora-1.1/lib/internal.h create mode 100644 libs/libtheora-1.1/lib/mathops.c create mode 100644 libs/libtheora-1.1/lib/mathops.h create mode 100644 libs/libtheora-1.1/lib/mcenc.c create mode 100644 libs/libtheora-1.1/lib/modedec.h create mode 100644 libs/libtheora-1.1/lib/ocintrin.h create mode 100644 libs/libtheora-1.1/lib/quant.c create mode 100644 libs/libtheora-1.1/lib/quant.h create mode 100644 libs/libtheora-1.1/lib/rate.c create mode 100644 libs/libtheora-1.1/lib/state.c create mode 100644 libs/libtheora-1.1/lib/theora.def create mode 100644 libs/libtheora-1.1/lib/theora.exp create mode 100644 libs/libtheora-1.1/lib/theoradec.exp create mode 100644 libs/libtheora-1.1/lib/theoraenc.exp create mode 100644 libs/libtheora-1.1/lib/tokenize.c create mode 100644 libs/libtheora-1.1/lib/x86/mmxencfrag.c create mode 100644 libs/libtheora-1.1/lib/x86/mmxfdct.c create mode 100644 libs/libtheora-1.1/lib/x86/mmxfrag.c create mode 100644 libs/libtheora-1.1/lib/x86/mmxfrag.h create mode 100644 libs/libtheora-1.1/lib/x86/mmxidct.c create mode 100644 libs/libtheora-1.1/lib/x86/mmxloop.h create mode 100644 libs/libtheora-1.1/lib/x86/mmxstate.c create mode 100644 libs/libtheora-1.1/lib/x86/sse2fdct.c create mode 100644 libs/libtheora-1.1/lib/x86/x86enc.c create mode 100644 libs/libtheora-1.1/lib/x86/x86enc.h create mode 100644 libs/libtheora-1.1/lib/x86/x86int.h create mode 100644 libs/libtheora-1.1/lib/x86/x86state.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxencfrag.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxfdct.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxfrag.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxfrag.h create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxidct.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxloop.h create mode 100644 libs/libtheora-1.1/lib/x86_vc/mmxstate.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/x86enc.c create mode 100644 libs/libtheora-1.1/lib/x86_vc/x86enc.h create mode 100644 libs/libtheora-1.1/lib/x86_vc/x86int.h create mode 100644 libs/libtheora-1.1/lib/x86_vc/x86state.c create mode 100644 libs/libtheora-1.1/libtheora.spec.in create mode 100644 libs/libtheora-1.1/m4/Makefile.am create mode 100644 libs/libtheora-1.1/m4/as-ac-expand.m4 create mode 100644 libs/libtheora-1.1/m4/ogg.m4 create mode 100644 libs/libtheora-1.1/m4/pkg.m4 create mode 100644 libs/libtheora-1.1/m4/sdl.m4 create mode 100644 libs/libtheora-1.1/m4/vorbis.m4 create mode 100644 libs/libtheora-1.1/macosx/English.lproj/InfoPlist.strings create mode 100644 libs/libtheora-1.1/macosx/Info.plist create mode 100644 libs/libtheora-1.1/macosx/Theora.xcodeproj/project.pbxproj create mode 100644 libs/libtheora-1.1/macosx/Theora_Prefix.pch create mode 100644 libs/libtheora-1.1/symbian/bld.inf create mode 100644 libs/libtheora-1.1/symbian/config.h create mode 100644 libs/libtheora-1.1/symbian/theora.mmp create mode 100644 libs/libtheora-1.1/tests/Makefile.am create mode 100644 libs/libtheora-1.1/tests/comment.c create mode 100644 libs/libtheora-1.1/tests/comment_theora.c create mode 100644 libs/libtheora-1.1/tests/granulepos.c create mode 100644 libs/libtheora-1.1/tests/granulepos_theora.c create mode 100644 libs/libtheora-1.1/tests/noop.c create mode 100644 libs/libtheora-1.1/tests/noop_theora.c create mode 100644 libs/libtheora-1.1/tests/tests.h create mode 100644 libs/libtheora-1.1/theora-uninstalled.pc.in create mode 100644 libs/libtheora-1.1/theora.pc.in create mode 100644 libs/libtheora-1.1/theoradec-uninstalled.pc.in create mode 100644 libs/libtheora-1.1/theoradec.pc.in create mode 100644 libs/libtheora-1.1/theoraenc-uninstalled.pc.in create mode 100644 libs/libtheora-1.1/theoraenc.pc.in create mode 100644 libs/libtheora-1.1/win32/VS2005/README create mode 100644 libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/libogg.vsprops create mode 100644 libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2005/libtheora_dynamic.sln create mode 100644 libs/libtheora-1.1/win32/VS2005/libtheora_static.sln create mode 100644 libs/libtheora-1.1/win32/VS2005/libvorbis.vsprops create mode 100644 libs/libtheora-1.1/win32/VS2008/README create mode 100644 libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/libogg.vsprops create mode 100644 libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_dynamic.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_static.vcproj create mode 100644 libs/libtheora-1.1/win32/VS2008/libtheora_dynamic.sln create mode 100644 libs/libtheora-1.1/win32/VS2008/libtheora_static.sln create mode 100644 libs/libtheora-1.1/win32/VS2008/libvorbis.vsprops create mode 100644 libs/libtheora-1.1/win32/VS2010/README create mode 100644 libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_dynamic.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_static.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_dynamic.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_static.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/libogg.props create mode 100644 libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_dynamic.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_static.vcxproj create mode 100644 libs/libtheora-1.1/win32/VS2010/libtheora_dynamic.sln create mode 100644 libs/libtheora-1.1/win32/VS2010/libtheora_static.sln create mode 100644 libs/libtheora-1.1/win32/VS2010/libvorbis.props create mode 100644 libs/libtheora-1.1/win32/build_theora_static.bat create mode 100644 libs/libtheora-1.1/win32/build_theora_static_debug.bat create mode 100644 libs/libtheora-1.1/win32/experimental/dumpvid/dumpvid.dsp create mode 100644 libs/libtheora-1.1/win32/experimental/encoderwin/ReadMe.txt create mode 100644 libs/libtheora-1.1/win32/experimental/encoderwin/encoderwin.dsp create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avi2vp3.c create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avilib.c create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avilib.h create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/outfile.vp3 create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/vp31.avi create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/readme.txt create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/transcoder.dsp create mode 100644 libs/libtheora-1.1/win32/experimental/transcoder/transcoder_example.c create mode 100644 libs/libtheora-1.1/win32/experimental/wincompat/README.txt create mode 100644 libs/libtheora-1.1/win32/experimental/wincompat/getopt.c create mode 100644 libs/libtheora-1.1/win32/experimental/wincompat/getopt.h create mode 100644 libs/libtheora-1.1/win32/experimental/wincompat/getopt_long.c create mode 100644 libs/libtheora-1.1/win32/experimental/wincompat/unistd.h create mode 100644 libs/libtheora-1.1/win32/getopt.c create mode 100644 libs/libtheora-1.1/win32/getopt1.c create mode 100644 libs/libtheora-1.1/win32/getopt_win.h create mode 100644 libs/libtheora-1.1/win32/theora_static.dsp create mode 100644 libs/libtheora-1.1/win32/xmingw32/Makefile create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.def create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec70.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec70d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec71.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec71d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec80.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradec80d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoradecd.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.def create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc70.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc70d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc71.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc71d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc80.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraenc80d.rc create mode 100644 libs/libtheora-1.1/win32/xmingw32/libtheoraencd.rc diff --git a/CMakeLists.txt b/CMakeLists.txt index c3d4ab95..556a99db 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -126,6 +126,8 @@ elseif(MSVC12) endif() endif() + + set(MEGA_ZLIB_VER "1.2.8") set(MEGA_PHYSFS_VER "2.0.3") set(MEGA_LUA51_VER "5.1.5") @@ -134,6 +136,7 @@ set(MEGA_LIBPNG_VER "166") set(MEGA_JPEG_TURBO_VER "1.3.1") set(MEGA_LIBOGG_VER "1.3.1") set(MEGA_LIBVORBIS_VER "1.3.3") +set(MEGA_LIBTHEORA_VER "1.1") set(MEGA_MPG123_VER "1.15.3") set(MEGA_FREETYPE_VER "2.5.0.1") set(MEGA_SDL2_VER "2.0.3-1c0f6952e65e") @@ -195,6 +198,12 @@ add_subdirectory("libs/libvorbis-${MEGA_LIBVORBIS_VER}" ${CMAKE_BINARY_DIR}/libv set(MEGA_LIBVORBIS vorbis-static) set(MEGA_LIBVORBISFILE vorbisfile-static) +message(STATUS "-----------------------------------------------------") +message(STATUS "Configuring: libtheora ${MEGA_LIBTHEORA_VER}") +message(STATUS "-----------------------------------------------------") +add_subdirectory("libs/libtheora-${MEGA_LIBTHEORA_VER}" ${CMAKE_BINARY_DIR}/libtheora) +set(MEGA_LIBTHEORA theora-static) + message(STATUS "-----------------------------------------------------") message(STATUS "Configuring: mpg123 ${MEGA_MPG123_VER}") message(STATUS "-----------------------------------------------------") @@ -293,6 +302,7 @@ set(MEGA_3P ${MEGA_LIBOGG} ${MEGA_LIBVORBIS} ${MEGA_LIBVORBISFILE} + ${MEGA_LIBTHEORA} ${MEGA_MPEG123} ${MEGA_FREETYPE} ${MEGA_SDL2} diff --git a/libs/libtheora-1.1/AUTHORS b/libs/libtheora-1.1/AUTHORS new file mode 100644 index 00000000..c8d0992e --- /dev/null +++ b/libs/libtheora-1.1/AUTHORS @@ -0,0 +1,49 @@ +Monty + - Original VP3 port + +Ralph Giles +Timothy B. Terriberry +Monty + - Ongoing development + +Dan B. Miller + - Pre alpha3 development + +Rudolf Marek +Wim Tayman +Dan Lenski +Nils Pipenbrinck +Monty + - MMX optimized functions + +Aaron Colwell +Thomas Vander Stichele +Jan Gerber +Conrad Parker +Cristian Adam +Sebastian Pippin +Simon Hosie + - Bug fixes, enhancements, build systems. + +Mauricio Piacentini + - Original win32 projects and example ports + - VP3->Theora transcoder + +Silvia Pfeiffer + - Figures for the spec + +Michael Smith +Andre Pang +calc +Chris Cheney +Brendan Cully +Edward Hervey +Adam Moss +Colin Ward +Jeremy C. Reed +Arc Riley +Rodolphe Ortalo + - Bug fixes + + +and other Xiph.org contributors diff --git a/libs/libtheora-1.1/CHANGES b/libs/libtheora-1.1/CHANGES new file mode 100644 index 00000000..7bd04a1f --- /dev/null +++ b/libs/libtheora-1.1/CHANGES @@ -0,0 +1,243 @@ +libtheora 1.1.2 (unreleased snapshot) + + - Fix Huffman table decoding with OC_HUFF_SLUSH is set to 0 + - Fix a frame size bug in player_example + - Add support for passing a buffer the size of the picture + region, rather than a full padded frame to th_encode_ycbcr_in() + as was possible with the legacy pre-1.0 API. + - 4:4:4 support in player_example using software yuv->rgb + - Better rgb->yuv conversion in png2theora + - Clean up warnings and local variables + - Build and documentation fixes + +libtheora 1.1.1 (2009 October 1) + + - Fix problems with MSVC inline assembly + - Add the missing encoder_disabled.c to the distribution + - build updates: autogen.sh should work better after switching systems + and the MSVC project now defaults to the dynamic runtime library + - Namespace some variables to avoid conflicts on wince. + +libtheora 1.1.0 (2009 September 24) + + - Fix various small issues with the example and telemetry code + - Fix handing a zero-byte packet as the first frame + - Documentation cleanup + - Two minor build fixes + +libtheora 1.1beta3 (2009 August 22) + + - Rate control fixes to smooth quality + - MSVC build now exports all of the 1.0 api + - Assorted small bug fixes + +libtheora 1.1beta2 (2009 August 12) + + - Fix a rate control problem with difficult input + - Build fixes for OpenBSD and Apple Xcode + - Examples now all use the 1.0 api + - TH_ENCCTL_SET_SPLEVEL works again + - Various bug fixes and source tree rearrangement + +libtheora 1.1beta1 (2009 August 5) + + - Support for two-pass encoding + - Performance optimization of both encoder and decoder + - Encoder supports dynamic adjustment of quality and + bitrate targets + - Encoder is generally more configurable, and all + rate control modes perform better + - Encoder now accepts 4:2:2 and 4:4:4 chroma sampling + - Decoder telemetry output shows quantization choice + and a breakdown of bitrate usage in the frame + - MSVC assembly optimizations up to date and functional + +libtheora 1.1alpha2 (2009 May 26) + + - Reduce lambda for small quantizers. + - New encoder fDCT does better on smooth gradients + - Use SATD for mode decisions (1-2% bitrate reduction) + - Assembly rewrite for new features and general speed up + - Share code between the encoder and decoder for performance + - Fix 4:2:2 decoding and telemetry + - MSVC project files updated, but assembly is disabled. + - New configure option --disable-spec to work around toolchain + detection failures. + - Limit symbol exports on MacOS X. + - Port remaining unit tests from the 1.0 release. + +libtheora 1.1alpha1 (2009 March 27) + + - Encoder rewrite with much improved vbr quality/bitrate and + better tracking of the target rate in cbr mode. + - MSVC project files do not work in this release. + +libtheora 1.0 (2008 November 3) + + - Merge x86 assembly for forward DCT from Thusnelda branch. + - Update 32 bit MMX with loop filter fix. + - Check for an uninitialized state before dereferencing in propagating + decode calls. + - Remove all TH_DEBUG statements. + - Rename the bitpacker source files copied from libogg to avoid + confusing simple build systems using both libraries. + - Declare bitfield entries to be explicitly signed for Solaris cc. + - Set quantization parameters to default values when an empty buffer is + passed with TH_ENCCTL_SET_QUANT_PARAMS. + - Split encoder and decoder tests depending on configure settings. + - Return lstylex.sty to the distribution. + - Disable inline assembly on gcc versions prior to 3.1. + - Remove extern references for OC_*_QUANT_MIN. + - Make various data tables static const so they can be read-only. + - Remove ENCCTL codes from the old encoder API. + - Implement TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE ctl. + - Fix segfault when exactly one of the width or height is not a multiple + of 16, but the other is. + - Compute the correct vertical offset for chroma. + - cpuid assembly fix for MSVC. + - Add VS2008 project files. + - Build updates for 64-bit platforms, Mingw32, VS and XCode. + - Do not clobber the cropping rectangle. + - Declare ourselves 1.0final to pkg-config to sort after beta releases. + - Fix the scons build to include asm in libtheoradec/enc. + +libtheora 1.0beta3 (2008 April 16) + + - Build new libtheoradec and libtheoraenc libraries + supporting the new API from theora-exp. This API should + not be considered stable yet. + - Change granule_frame() to return an index as documented. + This is a change of behaviour from 1.0beta1. + - Document that granule_time() returns the end of the + presentation interval. + - Use a custom copy of the libogg bitpacker in the decoder + to avoid function call overhead. + - MMX code improved and ported to MSVC. + - Fix a problem with the MMX code on SELinux. + - Fix a problem with decoder quantizer initialization. + - Fix a page queue problem with png2theora. + - Improved robustness. + - Updated VS2005 project files. + - Dropped build support for Microsoft VS2003. + - Dropped build support for the unreleased libogg2. + - Added the specification to the autotools build. + - Specification corrections. + +libtheora 1.0beta2 (2007 October 12) + + - Fix a crash bug on char-is-unsigned architectures (PowerPC) + - Fix a buffer sizing issue that caused rare encoder crashes + - Fix a buffer alignment issue + - Build fixes for MingW32, MSVC + - Improved format documentation. + +libtheora 1.0beta1 (2007 September 22) + + - Granulepos scheme modified to match other codecs. This bumps + the bitstream revision to 3.2.1. Bitstreams marked 3.2.0 are + handled correctly by this decoder. Older decoders will show + a one frame sync error in the less noticeable direction. + +libtheora 1.0alpha8 (2007 September 18) + + - Switch to new spec compliant decoder from theora-exp branch. + Written by Dr. Timothy Terriberry. + - Add support to the encoder for using quantization settings + provided by the application. + - more assembly optimizations + +libtheora 1.0alpha7 (2006 June 20) + + - Enable mmx assembly by default + - Avoid some relocations that caused problems on SELinux + - Other build fixes + - time testing mode (-f) for the dump_video example + +libtheora 1.0alpha6 (2006 May 30) + + * Merge theora-mmx simd acceleration (x86_32 and x86_64) + * Major RTP payload specification update + * Minor format specification updates + * Fix some spurious calls to free() instead of _ogg_free() + * Fix invalid array indexing in PixelLineSearch() + * Improve robustness against invalid input + * General warning cleanup + * The offset_y member now means what every application thought it meant + (offset from the top). This will mean some old files (those with a + non-centered image created with a buggy encoder) will display differently. + +libtheora 1.0alpha5 (2005 August 20) + + * Fixed bitrate management bugs that caused popping and encode + errors + * Fixed a crash problem with the theora_state internals not + being intialized properly. + * new utility function: + - theora_granule_shift() + * dump_video example now makes YUV4MPEG files by default, so + the results can be fed back to encoder_example and similar + tools. The old behavior is restored through the '-r' switch. + * ./configure now prints a summary + * simple unit test of the comment api under 'make check' + * misc code cleanup, warning and leak fixes + +libtheora 1.0alpha4 (2004 December 15) + + * first draft of the Theora I Format Specification + * API documentation generated from theora.h with Doxygen + * fix a double-update bug in the motion analysis + * apply the loop filter before filling motion vector border + in the reference frame + * new utility functions: + - theora_packet_isheader(), + - theora_packet_iskeyframe() + - theora_granule_frame() + * optional support for building without floating point + * optional support for building without encode support + * various build and packaging fixes + * pkg-config support + * SymbianOS build support + +libtheora 1.0alpha3 (2004 March 20) + + UPDATE: on 2004 July 1 the Theora I bitstream format was frozen. Files + produced by the libtheora 1.0alpha3 reference encoder will always be + decodable by the Theora I spec. + + * Bitstream info header FORMAT CHANGES: + - move the granulepos shift field to maintain byte alignment longer. + - reserve 5 additional bits for subsampling and interlace flags. + * Bitstream setup header FORMAT CHANGES: + - support for a range of interpolated quant matricies. + - include the in-loop block filter coeff. + * Bitsteam data packet FORMAT CHANGES: + - Reserve a bit for per-block Q index selection. + - Flip the coded image orientation for compatibility with VP3. + This allows lossless transcoding of VP3 content, but files + encoded with earlier theora releases would play upside down. + * example VP3 lossless transcoder + * optional support for libogg2 + * timing improvements in the example player + * packaging and build system updates and fixes + +libtheora 1.0alpha2 (2003 June 9) + + * bitstream FORMAT CHANGES: + - store the quant tables in a third setup header for + future encoder flexibility + - store the huffman tables in the third setup header + - add a field for marking the colorspace to the info header + - add crop parameters for non-multiple-of-16 frame sizes + - add a second vorbiscomment-style metadata header + * API changes to handle multiple headers with a single + theora_decode_header() call, like libvorbis + * code cleanup and minor fixes + * new dump_video code example/utility + * experimental win32 code examples + +libtheora 1.0alpha1 (2002 September 25) + + * First release of the theora reference implementation + * Port of the newly opened VP3 code to the Ogg container + * Rewrite of the code for portability and to use the libogg bitpacker + diff --git a/libs/libtheora-1.1/CMakeLists.txt b/libs/libtheora-1.1/CMakeLists.txt new file mode 100644 index 00000000..21907f26 --- /dev/null +++ b/libs/libtheora-1.1/CMakeLists.txt @@ -0,0 +1,48 @@ +cmake_minimum_required(VERSION 2.8) + +project(theora) + +option(THEORA_BUILD_SHARED "Build shared libtheora" OFF) +option(THEORA_BUILD_STATIC "Build static libtheora" ON) + +set(THEORA_SRC + lib/analyze.c + lib/apiwrapper.c + lib/bitpack.c + lib/cpu.c + lib/decapiwrapper.c + lib/decinfo.c + lib/decode.c + lib/dequant.c + lib/encapiwrapper.c + lib/encfrag.c + lib/encinfo.c + lib/encode.c + lib/encoder_disabled.c + lib/enquant.c + lib/fdct.c + lib/fragment.c + lib/huffdec.c + lib/huffenc.c + lib/idct.c + lib/info.c + lib/internal.c + lib/mathops.c + lib/mcenc.c + lib/quant.c + lib/rate.c + lib/state.c + lib/tokenize.c +) + +if(THEORA_BUILD_STATIC) + add_library(theora-static STATIC ${THEORA_SRC}) + target_include_directories(theora-static PUBLIC include lib) + target_link_libraries(theora-static ${OGG_LIBRARY}) +endif() + +if(THEORA_BUILD_SHARED) + add_library(theora SHARED ${THEORA_SRC} lib/theora.def) + target_include_directories(theora PUBLIC include lib) + target_link_libraries(theora ${OGG_LIBRARY}) +endif() diff --git a/libs/libtheora-1.1/COPYING b/libs/libtheora-1.1/COPYING new file mode 100644 index 00000000..8e334356 --- /dev/null +++ b/libs/libtheora-1.1/COPYING @@ -0,0 +1,28 @@ +Copyright (C) 2002-2009 Xiph.org Foundation + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +- Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + +- Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +- Neither the name of the Xiph.org Foundation nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION +OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/libs/libtheora-1.1/LICENSE b/libs/libtheora-1.1/LICENSE new file mode 100644 index 00000000..530a8e28 --- /dev/null +++ b/libs/libtheora-1.1/LICENSE @@ -0,0 +1,18 @@ +Please see the file COPYING for the copyright license for this software. + +In addition to and irrespective of the copyright license associated +with this software, On2 Technologies, Inc. makes the following statement +regarding technology used in this software: + + On2 represents and warrants that it shall not assert any rights + relating to infringement of On2's registered patents, nor initiate + any litigation asserting such rights, against any person who, or + entity which utilizes the On2 VP3 Codec Software, including any + use, distribution, and sale of said Software; which make changes, + modifications, and improvements in said Software; and to use, + distribute, and sell said changes as well as applications for other + fields of use. + +This reference implementation is originally derived from the On2 VP3 +Codec Software, and the Theora video format is essentially compatible +with the VP3 video format, consisting of a backward-compatible superset. diff --git a/libs/libtheora-1.1/Makefile.am b/libs/libtheora-1.1/Makefile.am new file mode 100644 index 00000000..6c7c2ae6 --- /dev/null +++ b/libs/libtheora-1.1/Makefile.am @@ -0,0 +1,35 @@ +## Process this file with automake to produce Makefile.in + +AUTOMAKE_OPTIONS = foreign 1.11 dist-zip dist-xz + +if THEORA_ENABLE_EXAMPLES +EXAMPLES_DIR = examples +else +EXAMPLES_DIR = +endif + +SUBDIRS = lib include doc tests m4 $(EXAMPLES_DIR) + + +# we include the whole debian/ dir in EXTRA_DIST because there's a problem +# with autotools and HFS+ MacOSX file systems that caused debian/Makefile.am +# to pick up on the lowercase changelog file and add ChangeLog to DIST_COMMON +# because of it, breaking make dist. This works just as well. +EXTRA_DIST = \ + README CHANGES COPYING LICENSE \ + autogen.sh win32 macosx symbian SConstruct \ + libtheora.spec libtheora.spec.in \ + theora-uninstalled.pc.in + +pkgconfigdir = $(libdir)/pkgconfig +pkgconfig_DATA = theora.pc theoradec.pc theoraenc.pc + +# Remove the .svn folders included in the tarball +dist-hook: + find $(distdir) -type d -name '.svn' | xargs rm -rf + +debug: + $(MAKE) all CFLAGS="@DEBUG@" + +profile: + $(MAKE) all CFLAGS="@PROFILE@" diff --git a/libs/libtheora-1.1/README b/libs/libtheora-1.1/README new file mode 100644 index 00000000..8f82b8ab --- /dev/null +++ b/libs/libtheora-1.1/README @@ -0,0 +1,152 @@ +------------------------------------------------------------------------- + The Xiph.org Foundation's libtheora 1.1 +------------------------------------------------------------------------- + +*** What is Theora? + +Theora is Xiph.Org's first publicly released video codec, intended +for use within the Foundation's Ogg multimedia streaming system. +Theora is derived directly from On2's VP3 codec, adds new features +while allow it a longer useful lifetime as an competitive codec. + +The 1.0 release decoder supported all the new features, but the +encoder is nearly identical to the VP3 code. + +The 1.1 release features a completely rewritten encoder, offering +better performance and compression, and making more complete use +of the format's feature set. Files produced by both encoders can +be decoded by either release. + +*** Where is Theora? + +Theora's main site is www.theora.org. Theora and related libraries +can be gotten from www.theora.org or the main Xiph.Org site at +www.xiph.org. Development source is kept in an open subversion +repository, see http://theora.org/svn/ for instructions. + +------------------------------------------------------------------------- +Getting started with the code +------------------------------------------------------------------------- + +*** What do I need to build the source? + +Requirements summary: + + For libtheora: + + libogg 1.1 or newer. + + For example encoder: + + as above, + + libvorbis and libvorbisenc 1.0.1 or newer. + + For creating a source distribution package: + + as above, + + Doxygen to build the API documentation, + pdflatex and fig2dev to build the format specification + (transfig package in Ubuntu). + + For the player only: + + as above, + + SDL (Simple Direct media Layer) libraries and headers, + OSS audio driver and development headers. + +The provided build system is the GNU automake/autoconf system, and +the main library, libtheora, should already build smoothly on any +system. Failure of libtheora to build on a GNU-enabled system is +considered a bug; please report problems to theora-dev@xiph.org. + +Windows build support is included in the win32 directory. + +Project files for Apple XCode are included in the macosx directory. + +There is also an experimental scons build. + +*** How do I use the sample encoder? + +The sample encoder takes raw video in YUV4MPEG2 format, as used by +lavtools, mjpeg-tools and other packages. The encoder expects audio, +if any, in a separate wave WAV file. Try 'encoder_example -h' for a +complete list of options. + +An easy way to get raw video and audio files is to use MPlayer as an +export utility. The options " -ao pcm -vo yuv4mpeg " will export a +wav file named audiodump.wav and a YUV video file in the correct +format for encoder_example as stream.yuv. Be careful when exporting +video alone; MPlayer may drop frames to 'keep up' with the audio +timer. The example encoder can't properly synchronize input audio and +video file that aren't in sync to begin with. + +The encoder will also take video or audio on stdin if '-' is specified +as the input file name. + +There is also a 'png2theora' example which accepts a set of image +files in that format. + +*** How do I use the sample player? + +The sample player takes an Ogg file on standard in; the file may be +audio alone, video alone or video with audio. + +*** What other tools are available? + +The programs in the examples directory are intended as tutorial source +for developers using the library. As such they sacrifice features and +robustness in the interests of comprehension and should not be +considered serious applications. + +If you're wanting to just use theora, consider the programs linked +from http://www.theora.org/. There is playback support in a number +of common free players, and plugins for major media frameworks. +Jan Gerber's ffmpeg2theora is an excellent encoding front end. + +------------------------------------------------------------------------- +Troubleshooting the build process +------------------------------------------------------------------------- + +*** Compile error, such as: + +encoder_internal.h:664: parse error before `ogg_uint16_t' + +This means you have version of libogg prior to 1.1. A *complete* new Ogg +install, libs and headers is needed. + +Also be sure that there aren't multiple copies of Ogg installed in +/usr and /usr/local; an older one might be first on the search path +for libs and headers. + +*** Link error, such as: + +undefined reference to `oggpackB_stream' + +See above; you need libogg 1.1 or later. + +*** Link error, such as: + +undefined reference to `vorbis_granule_time' + +You need libvorbis and libvorbisenc from the 1.0.1 release or later. + +*** Link error, such as: + +/usr/lib/libSDL.a(SDL_esdaudio.lo): In function `ESD_OpenAudio': +SDL_esdaudio.lo(.text+0x25d): undefined reference to `esd_play_stream' + +Be sure to use an SDL that's built to work with OSS. If you use an +SDL that is also built with ESD and/or ALSA support, it will try to +suck in all those extra libraries at link time too. That will only +work if the extra libraries are also installed. + +*** Link warning, such as: + +libtool: link: warning: library `/usr/lib/libogg.la' was moved. +libtool: link: warning: library `/usr/lib/libogg.la' was moved. + +Re-run theora/autogen.sh after an Ogg or Vorbis rebuild/reinstall + diff --git a/libs/libtheora-1.1/SConstruct b/libs/libtheora-1.1/SConstruct new file mode 100644 index 00000000..01bcfb46 --- /dev/null +++ b/libs/libtheora-1.1/SConstruct @@ -0,0 +1,225 @@ +# see http://www.scons.org if you do not have this tool +from os.path import join +import SCons + +# TODO: should use lamda and map to work on python 1.5 +def path(prefix, list): return [join(prefix, x) for x in list] + +encoder_sources = """ + apiwrapper.c + fragment.c + idct.c + internal.c + state.c + quant.c + analyze.c + encfrag.c + encapiwrapper.c + encinfo.c + encode.c + enquant.c + fdct.c + huffenc.c + mathops.c + mcenc.c + rate.c + tokenize.c +""" + +decoder_sources = """ + apiwrapper.c + bitpack.c + decapiwrapper.c + decinfo.c + decode.c + dequant.c + fragment.c + huffdec.c + idct.c + info.c + internal.c + quant.c + state.c +""" + +env = Environment() +if env['CC'] == 'gcc': + env.Append(CCFLAGS=["-g", "-O2", "-Wall", "-Wno-parentheses"]) + +def CheckPKGConfig(context, version): + context.Message( 'Checking for pkg-config... ' ) + ret = context.TryAction('pkg-config --atleast-pkgconfig-version=%s' % version)[0] + context.Result( ret ) + return ret + +def CheckPKG(context, name): + context.Message( 'Checking for %s... ' % name ) + ret = context.TryAction('pkg-config --exists %s' % name)[0] + context.Result( ret ) + return ret + +def CheckSDL(context): + name = "sdl-config" + context.Message( 'Checking for %s... ' % name ) + ret = SCons.Util.WhereIs('sdl-config') + context.Result( ret ) + return ret + +# check for appropriate inline asm support +host_x86_32_test = """ + int main(int argc, char **argv) { +#if !defined(__i386__) + #error not an x86 host: preprocessor macro __i386__ not defined +#endif + return 0; + } + """ +def CheckHost_x86_32(context): + context.Message('Checking for an x86 host...') + result = context.TryCompile(host_x86_32_test, '.c') + context.Result(result) + return result + +host_x86_64_test = """ + int main(int argc, char **argv) { +#if !defined(__x86_64__) + #error not an x86_64 host: preprocessor macro __x86_64__ not defined +#endif + return 0; + } + """ +def CheckHost_x86_64(context): + context.Message('Checking for an x86_64 host...') + result = context.TryCompile(host_x86_64_test, '.c') + context.Result(result) + return result + +conf = Configure(env, custom_tests = { + 'CheckPKGConfig' : CheckPKGConfig, + 'CheckPKG' : CheckPKG, + 'CheckSDL' : CheckSDL, + 'CheckHost_x86_32' : CheckHost_x86_32, + 'CheckHost_x86_64' : CheckHost_x86_64, + }) + +if not conf.CheckPKGConfig('0.15.0'): + print 'pkg-config >= 0.15.0 not found.' + Exit(1) + +if not conf.CheckPKG('ogg'): + print 'libogg not found.' + Exit(1) + +if conf.CheckPKG('vorbis vorbisenc'): + have_vorbis=True +else: + have_vorbis=False + +if conf.CheckPKG('libpng'): + have_libpng=True +else: + have_libpng=False + +build_player_example=True +if not conf.CheckHeader('sys/soundcard.h'): + build_player_example=False +if build_player_example and not conf.CheckSDL(): + build_player_example=False + +if conf.CheckHost_x86_32(): + env.Append(CPPDEFINES='OC_X86_ASM') + decoder_sources += """ + x86/mmxidct.c + x86/mmxfrag.c + x86/mmxstate.c + x86/x86state.c + """ + encoder_sources += """ + x86/mmxencfrag.c + x86/mmxfdct.c + x86/x86enc.c + x86/mmxfrag.c + x86/mmxidct.c + x86/mmxstate.c + x86/x86state.c + """ +elif conf.CheckHost_x86_64(): + env.Append(CPPDEFINES=['OC_X86_ASM', 'OC_X86_64_ASM']) + decoder_sources += """ + x86/mmxidct.c + x86/mmxfrag.c + x86/mmxstate.c + x86/x86state.c + """ + encoder_sources += """ + x86/mmxencfrag.c + x86/mmxfdct.c + x86/x86enc.c + x86/sse2fdct.c + x86/mmxfrag.c + x86/mmxidct.c + x86/mmxstate.c + x86/x86state.c + """ + +env = conf.Finish() + +env.Append(CPPPATH=['include']) +env.ParseConfig('pkg-config --cflags --libs ogg') + +libtheoradec_Sources = Split(decoder_sources) +libtheoraenc_Sources = Split(encoder_sources) + +libtheoradec_a = env.Library('lib/theoradec', + path('lib', libtheoradec_Sources)) +libtheoradec_so = env.SharedLibrary('lib/theoradec', + path('lib', libtheoradec_Sources)) + +libtheoraenc_a = env.Library('lib/theoraenc', + path('lib', libtheoraenc_Sources)) +libtheoraenc_so = env.SharedLibrary('lib/theoraenc', + path('lib', libtheoraenc_Sources) + [libtheoradec_so]) + +#installing +prefix='/usr' +lib_dir = prefix + '/lib' +env.Alias('install', prefix) +env.Install(lib_dir, [libtheoradec_a, libtheoradec_so]) +env.Install(lib_dir, [libtheoraenc_a, libtheoraenc_so]) + +# example programs +dump_video = env.Clone() +dump_video_Sources = Split("""dump_video.c ../lib/libtheoradec.a""") +dump_video.Program('examples/dump_video', path('examples', dump_video_Sources)) + +dump_psnr = env.Clone() +dump_psnr.Append(LIBS='m') +dump_psnr_Sources = Split("""dump_psnr.c ../lib/libtheoradec.a""") +dump_psnr.Program('examples/dump_psnr', path('examples', dump_psnr_Sources)) + +if have_vorbis: + encex = dump_video.Clone() + encex.ParseConfig('pkg-config --cflags --libs vorbisenc vorbis') + encex_Sources = Split(""" + encoder_example.c + ../lib/libtheoraenc.a + ../lib/libtheoradec.a + """) + encex.Program('examples/encoder_example', path('examples', encex_Sources)) + + if build_player_example: + plyex = encex.Clone() + plyex_Sources = Split(""" + player_example.c + ../lib/libtheoradec.a + """) + plyex.ParseConfig('sdl-config --cflags --libs') + plyex.Program('examples/player_example', path('examples', plyex_Sources)) + +png2theora = env.Clone() +png2theora_Sources = Split("""png2theora.c + ../lib/libtheoraenc.a + ../lib/libtheoradec.a +""") +png2theora.ParseConfig('pkg-config --cflags --libs libpng') +png2theora.Program('examples/png2theora', path('examples', png2theora_Sources)) diff --git a/libs/libtheora-1.1/autogen.sh b/libs/libtheora-1.1/autogen.sh new file mode 100644 index 00000000..2700868c --- /dev/null +++ b/libs/libtheora-1.1/autogen.sh @@ -0,0 +1,130 @@ +#!/bin/sh +# Run this to set up the build system: configure, makefiles, etc. +# (based on the version in enlightenment's cvs) + +package="theora" + +ACLOCAL_FLAGS="-I m4" + +olddir=`pwd` +srcdir=`dirname $0` +test -z "$srcdir" && srcdir=. + +cd "$srcdir" +DIE=0 + +/bin/echo "checking for autoconf... " +(autoconf --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have autoconf installed to compile $package." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at ftp://ftp.gnu.org/pub/gnu/" + DIE=1 +} + +VERSIONGREP="sed -e s/.*[^0-9\.]\([0-9][0-9]*\.[0-9][0-9]*\).*/\1/" +VERSIONMKMAJ="sed -e s/\([0-9][0-9]*\)[^0-9].*/\\1/" +VERSIONMKMIN="sed -e s/.*[0-9][0-9]*\.//" + +# do we need automake? +if test -r Makefile.am; then + AM_OPTIONS=`fgrep AUTOMAKE_OPTIONS Makefile.am` + AM_NEEDED=`echo $AM_OPTIONS | $VERSIONGREP` + if test x"$AM_NEEDED" = "x$AM_OPTIONS"; then + AM_NEEDED="" + fi + if test -z $AM_NEEDED; then + /bin/echo -n "checking for automake... " + AUTOMAKE=automake + ACLOCAL=aclocal + if ($AUTOMAKE --version < /dev/null > /dev/null 2>&1); then + /bin/echo "yes" + else + /bin/echo "no" + AUTOMAKE= + fi + else + /bin/echo -n "checking for automake $AM_NEEDED or later... " + majneeded=`echo $AM_NEEDED | $VERSIONMKMAJ` + minneeded=`echo $AM_NEEDED | $VERSIONMKMIN` + for am in automake-$AM_NEEDED automake$AM_NEEDED \ + automake automake-1.7 automake-1.8 automake-1.9 \ + automake-1.10 automake-1.11; do + ($am --version < /dev/null > /dev/null 2>&1) || continue + ver=`$am --version < /dev/null | head -n 1 | $VERSIONGREP` + maj=`echo $ver | $VERSIONMKMAJ` + min=`echo $ver | $VERSIONMKMIN` + if test $maj -eq $majneeded -a $min -ge $minneeded; then + AUTOMAKE=$am + /bin/echo $AUTOMAKE + break + fi + done + test -z $AUTOMAKE && /bin/echo "no" + /bin/echo -n "checking for aclocal $AM_NEEDED or later... " + for ac in aclocal-$AM_NEEDED aclocal$AM_NEEDED \ + aclocal aclocal-1.7 aclocal-1.8 aclocal-1.9 aclocal-1.10 aclocal-1.11; do + ($ac --version < /dev/null > /dev/null 2>&1) || continue + ver=`$ac --version < /dev/null | head -n 1 | $VERSIONGREP` + maj=`echo $ver | $VERSIONMKMAJ` + min=`echo $ver | $VERSIONMKMIN` + if test $maj -eq $majneeded -a $min -ge $minneeded; then + ACLOCAL=$ac + /bin/echo $ACLOCAL + break + fi + done + test -z $ACLOCAL && /bin/echo "no" + fi + test -z $AUTOMAKE || test -z $ACLOCAL && { + echo + echo "You must have automake installed to compile $package." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at ftp://ftp.gnu.org/pub/gnu/" + exit 1 + } +fi + +/bin/echo -n "checking for libtool... " +for LIBTOOLIZE in libtoolize glibtoolize nope; do + ($LIBTOOLIZE --version) < /dev/null > /dev/null 2>&1 && break +done +if test x$LIBTOOLIZE = xnope; then + /bin/echo "nope." + LIBTOOLIZE=libtoolize +else + /bin/echo $LIBTOOLIZE +fi +($LIBTOOLIZE --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have libtool installed to compile $package." + echo "Download the appropriate package for your system," + echo "or get the source from one of the GNU ftp sites" + echo "listed in http://www.gnu.org/order/ftp.html" + DIE=1 +} + +if test "$DIE" -eq 1; then + exit 1 +fi + +if test -z "$*"; then + echo "I am going to run ./configure with no arguments - if you wish " + echo "to pass any to it, please specify them on the $0 command line." +fi + +/bin/echo "Generating configuration files for $package, please wait...." + +/bin/echo " $ACLOCAL $ACLOCAL_FLAGS" +$ACLOCAL $ACLOCAL_FLAGS || exit 1 +/bin/echo " $LIBTOOLIZE --automake --force" +$LIBTOOLIZE --automake --force || exit 1 +/bin/echo " autoheader" +autoheader || exit 1 +/bin/echo " $AUTOMAKE --add-missing $AUTOMAKE_FLAGS" +$AUTOMAKE --add-missing $AUTOMAKE_FLAGS || exit 1 +/bin/echo " autoconf" +autoconf || exit 1 + +cd $olddir +$srcdir/configure --enable-maintainer-mode "$@" && /bin/echo diff --git a/libs/libtheora-1.1/configure.ac b/libs/libtheora-1.1/configure.ac new file mode 100644 index 00000000..b2118944 --- /dev/null +++ b/libs/libtheora-1.1/configure.ac @@ -0,0 +1,531 @@ +dnl Process this file with autoconf to produce a configure script + +dnl ------------------------------------------------ +dnl Initialization and Versioning +dnl ------------------------------------------------ + +AC_INIT(libtheora,[1.1.1+svn]) + +AC_CANONICAL_HOST +AC_CANONICAL_TARGET + +AM_CONFIG_HEADER([config.h]) +AC_CONFIG_SRCDIR([lib/fdct.c]) +AM_INIT_AUTOMAKE +AM_MAINTAINER_MODE + +m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])]) + +dnl Library versioning +dnl CURRENT, REVISION, AGE +dnl - library source changed -> increment REVISION +dnl - interfaces added/removed/changed -> increment CURRENT, REVISION = 0 +dnl - interfaces added -> increment AGE +dnl - interfaces removed -> AGE = 0 + +TH_LIB_CURRENT=3 +TH_LIB_REVISION=10 +TH_LIB_AGE=3 +AC_SUBST(TH_LIB_CURRENT) +AC_SUBST(TH_LIB_REVISION) +AC_SUBST(TH_LIB_AGE) + +THDEC_LIB_CURRENT=2 +THDEC_LIB_REVISION=4 +THDEC_LIB_AGE=1 +AC_SUBST(THDEC_LIB_CURRENT) +AC_SUBST(THDEC_LIB_REVISION) +AC_SUBST(THDEC_LIB_AGE) + +THENC_LIB_CURRENT=2 +THENC_LIB_REVISION=2 +THENC_LIB_AGE=1 +AC_SUBST(THENC_LIB_CURRENT) +AC_SUBST(THENC_LIB_REVISION) +AC_SUBST(THENC_LIB_AGE) + +dnl Extra linker options (for version script) +THEORA_LDFLAGS="" + +dnl -------------------------------------------------- +dnl Check for programs +dnl -------------------------------------------------- + +dnl save $CFLAGS since AC_PROG_CC likes to insert "-g -O2" +dnl if $CFLAGS is blank +cflags_save="$CFLAGS" +AC_PROG_CC +AC_PROG_CPP +CFLAGS="$cflags_save" + +AM_PROG_CC_C_O +AC_LIBTOOL_WIN32_DLL +AM_PROG_LIBTOOL + +dnl Add parameters for aclocal +AC_SUBST(ACLOCAL_AMFLAGS, "-I m4") + +dnl Check for doxygen +AC_ARG_ENABLE([doc], + AS_HELP_STRING([--enable-doc], [Build API documentation]), + [ac_enable_doc=$enableval], [ac_enable_doc=auto]) + +if test "x$ac_enable_doc" != "xno"; then + AC_CHECK_PROG(HAVE_DOXYGEN, doxygen, true, false) + + if test "x$HAVE_DOXYGEN" = "xfalse" -a "x$ac_enable_doc" = "xyes"; then + AC_MSG_ERROR([*** API documentation explicitly requested but Doxygen not found]) + fi +else + HAVE_DOXYGEN=false +fi +AM_CONDITIONAL(HAVE_DOXYGEN,$HAVE_DOXYGEN) +if test $HAVE_DOXYGEN = "false"; then + AC_MSG_WARN([*** doxygen not found, API documentation will not be built]) +fi + +dnl Check for tools used to build the format specification +BUILD_SPEC="false" +ac_build_spec=no +AC_ARG_ENABLE(spec, + AS_HELP_STRING([--enable-spec], [(re)build the specification document]), + [ + if test "x$enableval" = "xyes"; then + ac_build_spec=$enableval + fi + ], [ + ac_build_spec=no + ] ) +if test "x$ac_build_spec" = "xyes"; then + AC_CHECK_PROG(HAVE_PDFLATEX, pdflatex, yes) + AC_CHECK_PROG(HAVE_BIBTEX, bibtex, yes) + AC_CHECK_PROG(HAVE_TRANSFIG, fig2dev, yes) + if test -r doc/spec/spec.tex; then + if test "x$HAVE_PDFLATEX" = "xyes"; then + if test "x$HAVE_BIBTEX" = "xyes"; then + if test "x$HAVE_TRANSFIG" = "xyes"; then + tex_pkg_list=`fgrep usepackage doc/spec/spec.tex | grep \{ | grep -v ltablex` + tex_pkg_ok="yes" + for pkg_line in $tex_pkg_list; do + pkg_name=`echo $pkg_line | sed -e 's/.*{\(.*\)}.*/\1/'` + AC_MSG_CHECKING([for Tex package $pkg_name]) + cat >conftest.tex <<_ACEOF +\\documentclass{book} +$pkg_line +\\begin{document} +Hello World. +\\end{document} +_ACEOF + if pdflatex -interaction batchmode -halt-on-error conftest < /dev/null > /dev/null 2>&1; then + AC_MSG_RESULT([ok]) + else + tex_pkg_ok="no" + AC_MSG_RESULT([no]) + fi + done + if test -w conftest.tex; then rm conftest.tex; fi + if test -w conftest.tex; then rm conftest.aux; fi + if test -w conftest.pdf; then rm conftest.pdf; fi + if test "x$tex_pkg_ok" = "xyes"; then + BUILD_SPEC="true" + fi + fi + fi + fi + fi +fi +AM_CONDITIONAL(BUILD_SPEC, $BUILD_SPEC) +if test $BUILD_SPEC = "false"; then + AC_MSG_WARN([*** Format Specification will not built.]) +fi + +dnl Check for valgrind +VALGRIND_ENVIRONMENT="" +ac_enable_valgrind=no +AC_ARG_ENABLE(valgrind-testing, + AS_HELP_STRING([--enable-valgrind-testing], [Enable running of tests inside Valgrind]), + [ ac_enable_valgrind=$enableval ], [ ac_enable_valgrind=no] ) + +if test "x${ac_enable_valgrind}" = xyes ; then + if test "x${enable_shared}" = xyes ; then + VALGRIND_ENVIRONMENT="libtool --mode=execute " + fi + + AC_CHECK_PROG(HAVE_VALGRIND, valgrind, yes, no) + if test "x$HAVE_VALGRIND" = xyes ; then + VALGRIND_ENVIRONMENT="$VALGRIND_ENVIRONMENT valgrind -q --leak-check=yes --show-reachable=yes --num-callers=100" + AC_SUBST(VALGRIND_ENVIRONMENT) + TESTS_INFO="Type 'make check' to run test suite. Tests will be run under: + ${VALGRIND_ENVIRONMENT}" + else + TESTS_INFO="Type 'make check' to run test suite (Valgrind not found)" + fi +else + TESTS_INFO="Type 'make check' to run test suite (Valgrind testing not enabled)" +fi + +dnl -------------------------------------------------- +dnl Set build flags based on environment +dnl -------------------------------------------------- + +dnl Set some target options + +cflags_save="$CFLAGS" +if test -z "$GCC"; then + case $host in + *) + DEBUG="-g -DDEBUG" + CFLAGS="-O" + PROFILE="-g -p -DDEBUG" ;; + esac +else + + case $host in + *) + DEBUG="-g -Wall -Wno-parentheses -DDEBUG -D__NO_MATH_INLINES" + CFLAGS="-Wall -Wno-parentheses -O3 -fforce-addr -fomit-frame-pointer -finline-functions -funroll-loops" + PROFILE="-Wall -Wno-parentheses -pg -g -O3 -fno-inline-functions -DDEBUG";; + esac +fi +CFLAGS="$CFLAGS $cflags_save" + +cpu_x86_64=no +cpu_x86_32=no +AC_ARG_ENABLE(asm, + AS_HELP_STRING([--disable-asm], [Disable assembly optimizations]), + [ ac_enable_asm=$enableval ], [ ac_enable_asm=yes] ) + +if test "x${ac_enable_asm}" = xyes; then + cpu_optimization="no optimization for your platform, please send a patch" + case $target_cpu in + i[[3456]]86) + cpu_x86_32=yes + cpu_optimization="32 bit x86" + AC_DEFINE([OC_X86_ASM], [], [make use of x86 asm optimization]) + if test "x$target_vendor" = "xapple"; then + THEORA_LDFLAGS="$THEORA_LDFLAGS -Wl,-read_only_relocs,suppress" + fi + ;; + x86_64) + cpu_x86_64=yes + cpu_optimization="64 bit x86" + AC_DEFINE([OC_X86_ASM], [], [make use of x86 asm optimization]) + AC_DEFINE([OC_X86_64_ASM], [], [make use of x86_64 asm optimization]) + ;; + esac +else + cpu_optimization="disabled" +fi +AM_CONDITIONAL([CPU_x86_64], [test x$cpu_x86_64 = xyes]) +AM_CONDITIONAL([CPU_x86_32], [test x$cpu_x86_32 = xyes]) + +# Test whenever ld supports -version-script +AC_PROG_LD +AC_PROG_LD_GNU +AC_MSG_CHECKING([how to control symbol export]) + +THDEC_VERSION_ARG="" +THENC_VERSION_ARG="" +TH_VERSION_ARG="" +if test "x$lt_cv_prog_gnu_ld" = "xyes"; then + case "$target_os" in + *mingw*) + THEORA_LDFLAGS="$THEORA_LDFLAGS -no-undefined" + THDEC_VERSION_ARG="-export-symbols \$(top_srcdir)/win32/xmingw32/libtheoradec-all.def" + THENC_VERSION_ARG="-export-symbols \$(top_srcdir)/win32/xmingw32/libtheoraenc-all.def" + THENC_VERSION_ARG="$THENC_VERSION_ARG -ltheoradec" + THC_VERSION_ARG="-export-symbols \$(top_srcdir)/win32/libtheora.def" + AC_MSG_RESULT([-export-symbols]) + ;; + linux* | solaris* | gnu* | k*bsd*-gnu) + THDEC_VERSION_ARG='-Wl,--version-script=$(srcdir)/Version_script-dec' + THENC_VERSION_ARG='-Wl,--version-script=$(srcdir)/Version_script-enc' + TH_VERSION_ARG='-Wl,--version-script=$(srcdir)/Version_script' + AC_MSG_RESULT([--version-script]) + ;; + *) + # build without versioning + AC_MSG_RESULT([no]) + ;; + esac +else + case "$target_os" in + darwin*) + THDEC_VERSION_ARG='-Wl,-exported_symbols_list,$(srcdir)/theoradec.exp' + THENC_VERSION_ARG='-Wl,-exported_symbols_list,$(srcdir)/theoraenc.exp' + TH_VERSION_ARG='-Wl,-exported_symbols_list,$(srcdir)/theora.exp' + AC_MSG_RESULT([-exported_symbols_list]) + ;; + *) + # build without versioning + AC_MSG_RESULT([no]) + ;; + esac +fi + +THEORADEC_LDFLAGS="$THEORA_LDFLAGS $THDEC_VERSION_ARG" +THEORAENC_LDFLAGS="$THEORA_LDFLAGS $THENC_VERSION_ARG" +THEORA_LDFLAGS="$THEORA_LDFLAGS $TH_VERSION_ARG" +AC_SUBST(THEORADEC_LDFLAGS) +AC_SUBST(THEORAENC_LDFLAGS) +AC_SUBST(THEORA_LDFLAGS) + +dnl -------------------------------------------------- +dnl Checks for support libraries and headers +dnl -------------------------------------------------- + +dnl check for Ogg +HAVE_OGG=no + +dnl first check through pkg-config since it's more flexible + +dnl check for pkg-config itself so we don't try the m4 macro without pkg-config +AC_CHECK_PROG(HAVE_PKG_CONFIG, pkg-config, yes) +if test "x$HAVE_PKG_CONFIG" = "xyes" +then + PKG_CHECK_MODULES(OGG, ogg >= 1.1, HAVE_OGG=yes, HAVE_OGG=no) +fi +if test "x$HAVE_OGG" = "xno" +then + dnl fall back to the old school test + XIPH_PATH_OGG(, AC_MSG_ERROR([ + libogg is required to build this package! + please see http://www.xiph.org/ for how to + obtain a copy. + ])) + cflags_save=$CFLAGS + libs_save=$LIBS + CFLAGS="$CFLAGS $OGG_CFLAGS" + LIBS="$LIBS $OGG_LIBS" + AC_CHECK_FUNC(oggpackB_read, , [ + AC_MSG_ERROR([newer libogg version (1.1 or later) required]) + ]) + CFLAGS=$cflags_save + LIBS=$libs_save +fi + + +dnl check for Vorbis +HAVE_VORBIS=no + +dnl first check through pkg-config since it's more flexible + +if test "x$HAVE_PKG_CONFIG" = "xyes" +then + PKG_CHECK_MODULES(VORBIS, vorbis >= 1.0.1, HAVE_VORBIS=yes, HAVE_VORBIS=no) + dnl also set VORBISENC_LIBS since an examples needs it + dnl the old .m4 sets this to a value to use on top of VORBIS_LIBS, + dnl so we do the same here. + VORBISENC_LIBS="-lvorbisenc" + AC_SUBST(VORBISENC_LIBS) +fi +if test "x$HAVE_VORBIS" = "xno" +then + dnl fall back to the old school test + XIPH_PATH_VORBIS(HAVE_VORBIS=yes, HAVE_VORBIS=no) +fi + +dnl check for SDL +HAVE_SDL=no + +AM_PATH_SDL(,[ + HAVE_SDL=yes + SDL_LIBS=`$SDL_CONFIG --libs` +],AC_MSG_WARN([*** Unable to find SDL -- Not compiling example players ***])) + +dnl check for OSS +HAVE_OSS=no +AC_CHECK_HEADERS([sys/soundcard.h soundcard.h machine/soundcard.h],[ + HAVE_OSS=yes + break +]) +if test x$HAVE_OSS != xyes; then + AC_MSG_WARN([OSS audio support not found -- not compiling player_example]) +fi + +dnl OpenBSD needs -lossaudio to use the oss interface +OSS_LIBS= +case "$target_os" in + openbsd*) + OSS_LIBS='-lossaudio' + ;; +esac +AC_SUBST(OSS_LIBS) + +dnl check for libpng +HAVE_PNG=no +if test "x$HAVE_PKG_CONFIG" = "xyes" +then + PKG_CHECK_MODULES(PNG, libpng, HAVE_PNG=yes, HAVE_PNG=no) +fi +AC_SUBST(PNG_CFLAGS) +AC_SUBST(PNG_LIBS) + +dnl check for libcairo +HAVE_CAIRO=no +AC_ARG_ENABLE(telemetry, + AS_HELP_STRING([--enable-telemetry], [Enable debugging output controls]), + [ ac_enable_telemetry=$enableval ], [ ac_enable_telemetry=no] ) + +if test "x${ac_enable_telemetry}" = xyes; then + if test "x$HAVE_PKG_CONFIG" = "xyes" + then + PKG_CHECK_MODULES(CAIRO, cairo, HAVE_CAIRO=yes, HAVE_CAIRO=no) + AC_DEFINE([HAVE_CAIRO], [], [libcairo is available for visual debugging output]) + fi + if test x$HAVE_CAIRO != xyes; then + AC_MSG_WARN([libcairo not found -- not compiling telemetry output support ]) + fi + AC_SUBST(CAIRO_CFLAGS) + AC_SUBST(CAIRO_LIBS) +fi + +dnl -------------------------------------------------- +dnl Overall build configuration options +dnl -------------------------------------------------- + +dnl Configuration option for building of floating point code. + +ac_enable_float=yes +AC_ARG_ENABLE(float, + AS_HELP_STRING([--disable-float], [Disable use of floating point code]), + [ ac_enable_float=$enableval ], [ ac_enable_float=yes] ) + +if test "x${ac_enable_float}" != xyes ; then + AC_DEFINE([THEORA_DISABLE_FLOAT], [], + [Define to exclude floating point code from the build]) +fi +AM_CONDITIONAL(THEORA_DISABLE_FLOAT, [test "x${ac_enable_float}" != xyes]) + +dnl Configuration option for building of encoding support. + +ac_enable_encode=yes +AC_ARG_ENABLE(encode, + AS_HELP_STRING([--disable-encode], [Disable encoding support]), + [ ac_enable_encode=$enableval ], [ ac_enable_encode=yes] ) + +if test "x${ac_enable_encode}" != xyes ; then + AC_DEFINE([THEORA_DISABLE_ENCODE], [], + [Define to exclude encode support from the build]) +else + if test x$HAVE_VORBIS = xyes; then + BUILDABLE_EXAMPLES="$BUILDABLE_EXAMPLES encoder_example\$(EXEEXT)" + else + AC_MSG_NOTICE([Vorbis missing, cannot build example encoder]) + fi +fi +AM_CONDITIONAL(THEORA_DISABLE_ENCODE, [test "x${ac_enable_encode}" != xyes]) + +dnl Configuration option for examples + +ac_enable_examples=yes +AC_ARG_ENABLE(examples, + AS_HELP_STRING([--disable-examples], [Disable examples]), + [ ac_enable_examples=$enableval ], [ ac_enable_examples=yes] ) +AM_CONDITIONAL(THEORA_ENABLE_EXAMPLES, [test "x${ac_enable_examples}" != xno]) + +dnl -------------------------------------------------- +dnl Check for headers +dnl -------------------------------------------------- + +dnl none here + +dnl -------------------------------------------------- +dnl Check for typedefs, structures, etc +dnl -------------------------------------------------- + +dnl none + +dnl -------------------------------------------------- +dnl Check for library functions +dnl -------------------------------------------------- + +dnl OpenBSD needs -lcompat for ftime() used by dump_video.c +AC_SEARCH_LIBS([ftime], [compat]) + +dnl substitute the included getopt if the system doesn't support long options +AC_CHECK_FUNC(getopt_long, + [GETOPT_OBJS=''], + [GETOPT_OBJS='getopt.$(OBJEXT) getopt1.$(OBJEXT)']) +AC_SUBST(GETOPT_OBJS) + +if test x$HAVE_SDL = xyes -a x$HAVE_OSS = xyes -a x$HAVE_VORBIS = xyes; then + BUILDABLE_EXAMPLES="$BUILDABLE_EXAMPLES player_example\$(EXEEXT)" +fi +if test x$HAVE_PNG = xyes; then + BUILDABLE_EXAMPLES="$BUILDABLE_EXAMPLES png2theora\$(EXEEXT)" +fi +AC_SUBST(BUILDABLE_EXAMPLES) + +dnl -------------------------------------------------- +dnl Do substitutions +dnl -------------------------------------------------- + +AC_SUBST(DEBUG) +AC_SUBST(PROFILE) + +AC_OUTPUT([ + Makefile + lib/Makefile + include/Makefile include/theora/Makefile + examples/Makefile + doc/Makefile doc/Doxyfile doc/spec/Makefile + tests/Makefile + m4/Makefile + libtheora.spec + theora.pc + theora-uninstalled.pc + theoradec.pc + theoradec-uninstalled.pc + theoraenc.pc + theoraenc-uninstalled.pc +]) + +AS_AC_EXPAND(LIBDIR, ${libdir}) +AS_AC_EXPAND(INCLUDEDIR, ${includedir}) +AS_AC_EXPAND(BINDIR, ${bindir}) +AS_AC_EXPAND(DOCDIR, ${docdir}) + +if test $HAVE_DOXYGEN = "false"; then + doc_build="no" +else + doc_build="yes" +fi +if test $BUILD_SPEC = "false"; then + spec_build="no" +else + spec_build="yes" +fi + +AC_MSG_RESULT([ +------------------------------------------------------------------------ + $PACKAGE $VERSION: Automatic configuration OK. + + General configuration: + + Encoding support: ........... ${ac_enable_encode} + Floating point support: ..... ${ac_enable_float} + Assembly optimization: ...... ${cpu_optimization} + Debugging telemetry: ........ ${ac_enable_telemetry} + Build example code: ......... ${ac_enable_examples} + API Documentation: .......... ${doc_build} + Format Documentation: ....... ${spec_build} + + Installation paths: + + libtheora: ................... ${LIBDIR} + C header files: .............. ${INCLUDEDIR}/theora + Documentation: ............... ${DOCDIR} + + Building: + + Type 'make' to compile $PACKAGE. + + Type 'make install' to install $PACKAGE. + + ${TESTS_INFO} + + Example programs will be built but not installed. +------------------------------------------------------------------------ +]) + diff --git a/libs/libtheora-1.1/debian/changelog b/libs/libtheora-1.1/debian/changelog new file mode 100644 index 00000000..bfcd6440 --- /dev/null +++ b/libs/libtheora-1.1/debian/changelog @@ -0,0 +1,15 @@ +libtheora (0.0.0.alpha3-1) unstable; urgency=low + + * Initial upload to Debian. + + -- Christopher L Cheney Tue, 29 Jun 2004 22:00:00 -0500 + +libtheora (0.0.0-0) unstable; urgency=low + + * Initial Release. + + -- Christopher L Cheney Wed, 25 Sep 2002 21:00:00 -0500 + +Local variables: +mode: debian-changelog +End: diff --git a/libs/libtheora-1.1/debian/control b/libs/libtheora-1.1/debian/control new file mode 100644 index 00000000..28921c31 --- /dev/null +++ b/libs/libtheora-1.1/debian/control @@ -0,0 +1,24 @@ +Source: libtheora +Section: libs +Priority: optional +Maintainer: Christopher L Cheney +Build-Depends: cdbs, autotools-dev, debhelper (>> 4.0.0), devscripts, libogg-dev (>= 1.1.0), libvorbis-dev, python +Standards-Version: 3.6.1.0 + +Package: libtheora0 +Architecture: any +Section: libs +Depends: ${shlibs:Depends} +Description: The Theora Video Compression Codec + Ogg Theora + +Package: libtheora-dev +Architecture: any +Section: libdevel +Depends: libtheora0 (= ${Source-Version}), libogg-dev +Description: The Theora Compression Codec (development files) + Theora is a fully open, non-proprietary, patent-and-royalty-free, + general-purpose compressed video format. + . + This package contains the header files and documentation needed to develop + applications with libtheora. diff --git a/libs/libtheora-1.1/debian/copyright b/libs/libtheora-1.1/debian/copyright new file mode 100644 index 00000000..5eb0d7b0 --- /dev/null +++ b/libs/libtheora-1.1/debian/copyright @@ -0,0 +1,38 @@ +This package was debianized by Christopher L Cheney on +Wed, 25 Sep 2002 21:00:00 -0500. + +It was downloaded from http://svn.xiph.org/trunk/theora/ + +Upstream Authors: Xiph.Org Foundation + +Copyright: + +Copyright (c) 2002-2009 Xiph.org Foundation + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +- Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + +- Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +- Neither the name of the Xiph.org Foundation nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + diff --git a/libs/libtheora-1.1/debian/libtheora-dev.install b/libs/libtheora-1.1/debian/libtheora-dev.install new file mode 100644 index 00000000..adab6bc8 --- /dev/null +++ b/libs/libtheora-1.1/debian/libtheora-dev.install @@ -0,0 +1,5 @@ +debian/tmp/usr/include/theora/theora.h +debian/tmp/usr/lib/libtheora.a +debian/tmp/usr/lib/libtheora.la +debian/tmp/usr/lib/libtheora.so +debian/tmp/usr/lib/pkgconfig/theora.pc diff --git a/libs/libtheora-1.1/debian/libtheora0.install b/libs/libtheora-1.1/debian/libtheora0.install new file mode 100644 index 00000000..cac5198b --- /dev/null +++ b/libs/libtheora-1.1/debian/libtheora0.install @@ -0,0 +1,2 @@ +debian/tmp/usr/lib/libtheora.so.0 +debian/tmp/usr/lib/libtheora.so.0.0.0 diff --git a/libs/libtheora-1.1/debian/rules b/libs/libtheora-1.1/debian/rules new file mode 100644 index 00000000..4b0564ec --- /dev/null +++ b/libs/libtheora-1.1/debian/rules @@ -0,0 +1,3 @@ +#!/usr/bin/make -f +include /usr/share/cdbs/1/rules/debhelper.mk +include /usr/share/cdbs/1/class/autotools.mk diff --git a/libs/libtheora-1.1/debian/watch b/libs/libtheora-1.1/debian/watch new file mode 100644 index 00000000..033083d2 --- /dev/null +++ b/libs/libtheora-1.1/debian/watch @@ -0,0 +1,3 @@ +version=2 + +http://downloads.xiph.org/releases/theora/libtheora-(.*)\.tar\.gz debian uupdate diff --git a/libs/libtheora-1.1/doc/Doxyfile.in b/libs/libtheora-1.1/doc/Doxyfile.in new file mode 100644 index 00000000..ea155730 --- /dev/null +++ b/libs/libtheora-1.1/doc/Doxyfile.in @@ -0,0 +1,1142 @@ +# Doxyfile 1.3.7 + +# This file describes the settings to be used by the documentation system +# doxygen (www.doxygen.org) for a project +# +# All text after a hash (#) is considered a comment and will be ignored +# The format is: +# TAG = value [value, ...] +# For lists items can also be appended using: +# TAG += value [value, ...] +# Values that contain spaces should be placed between quotes (" ") + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- + +# The PROJECT_NAME tag is a single word (or a sequence of words surrounded +# by quotes) that should identify the project. + +PROJECT_NAME = @PACKAGE@ + +# The PROJECT_NUMBER tag can be used to enter a project or revision number. +# This could be handy for archiving the generated documentation or +# if some version control system is used. + +PROJECT_NUMBER = @VERSION@ + +# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) +# base path where the generated documentation will be put. +# If a relative path is entered, it will be relative to the location +# where doxygen was started. If left blank the current directory will be used. + +OUTPUT_DIRECTORY = libtheora + +# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create +# 2 levels of 10 sub-directories under the output directory of each output +# format and will distribute the generated files over these directories. +# Enabling this option can be useful when feeding doxygen a huge amount of source +# files, where putting all generated files in the same directory would otherwise +# cause performance problems for the file system. + +CREATE_SUBDIRS = NO + +# The OUTPUT_LANGUAGE tag is used to specify the language in which all +# documentation generated by doxygen is written. Doxygen will use this +# information to generate all constant output in the proper language. +# The default language is English, other supported languages are: +# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, Dutch, +# Finnish, French, German, Greek, Hungarian, Italian, Japanese, Japanese-en +# (Japanese with English messages), Korean, Korean-en, Norwegian, Polish, Portuguese, +# Romanian, Russian, Serbian, Slovak, Slovene, Spanish, Swedish, and Ukrainian. + +OUTPUT_LANGUAGE = English + +# This tag can be used to specify the encoding used in the generated output. +# The encoding is not always determined by the language that is chosen, +# but also whether or not the output is meant for Windows or non-Windows users. +# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES +# forces the Windows encoding (this is the default for the Windows binary), +# whereas setting the tag to NO uses a Unix-style encoding (the default for +# all platforms other than Windows). +#This tag is now obsolete, according to doxygen 1.5.2 +#USE_WINDOWS_ENCODING = NO + +# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will +# include brief member descriptions after the members that are listed in +# the file and class documentation (similar to JavaDoc). +# Set to NO to disable this. + +BRIEF_MEMBER_DESC = YES + +# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend +# the brief description of a member or function before the detailed description. +# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the +# brief descriptions will be completely suppressed. + +REPEAT_BRIEF = YES + +# This tag implements a quasi-intelligent brief description abbreviator +# that is used to form the text in various listings. Each string +# in this list, if found as the leading text of the brief description, will be +# stripped from the text and the result after processing the whole list, is used +# as the annotated text. Otherwise, the brief description is used as-is. If left +# blank, the following values are used ("$name" is automatically replaced with the +# name of the entity): "The $name class" "The $name widget" "The $name file" +# "is" "provides" "specifies" "contains" "represents" "a" "an" "the" + +ABBREVIATE_BRIEF = + +# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then +# Doxygen will generate a detailed section even if there is only a brief +# description. + +ALWAYS_DETAILED_SEC = NO + +# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all inherited +# members of a class in the documentation of that class as if those members were +# ordinary class members. Constructors, destructors and assignment operators of +# the base classes will not be shown. + +INLINE_INHERITED_MEMB = NO + +# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full +# path before files name in the file list and in the header files. If set +# to NO the shortest path that makes the file name unique will be used. + +FULL_PATH_NAMES = NO + +# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag +# can be used to strip a user-defined part of the path. Stripping is +# only done if one of the specified strings matches the left-hand part of +# the path. The tag can be used to show relative paths in the file list. +# If left blank the directory from which doxygen is run is used as the +# path to strip. + +STRIP_FROM_PATH = + +# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of +# the path mentioned in the documentation of a class, which tells +# the reader which header file to include in order to use a class. +# If left blank only the name of the header file containing the class +# definition is used. Otherwise one should specify the include paths that +# are normally passed to the compiler using the -I flag. + +STRIP_FROM_INC_PATH = + +# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter +# (but less readable) file names. This can be useful is your file systems +# doesn't support long names like on DOS, Mac, or CD-ROM. + +SHORT_NAMES = NO + +# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen +# will interpret the first line (until the first dot) of a JavaDoc-style +# comment as the brief description. If set to NO, the JavaDoc +# comments will behave just like the Qt-style comments (thus requiring an +# explicit @brief command for a brief description. + +JAVADOC_AUTOBRIEF = YES + +# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen +# treat a multi-line C++ special comment block (i.e. a block of //! or /// +# comments) as a brief description. This used to be the default behaviour. +# The new default is to treat a multi-line C++ comment block as a detailed +# description. Set this tag to YES if you prefer the old behaviour instead. + +MULTILINE_CPP_IS_BRIEF = NO + +# If the DETAILS_AT_TOP tag is set to YES then Doxygen +# will output the detailed description near the top, like JavaDoc. +# If set to NO, the detailed description appears after the member +# documentation. + +DETAILS_AT_TOP = NO + +# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented +# member inherits the documentation from any documented member that it +# re-implements. + +INHERIT_DOCS = YES + +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC +# tag is set to YES, then doxygen will reuse the documentation of the first +# member in the group (if any) for the other members of the group. By default +# all members of a group must be documented explicitly. + +DISTRIBUTE_GROUP_DOC = NO + +# The TAB_SIZE tag can be used to set the number of spaces in a tab. +# Doxygen uses this value to replace tabs by spaces in code fragments. + +TAB_SIZE = 8 + +# This tag can be used to specify a number of aliases that acts +# as commands in the documentation. An alias has the form "name=value". +# For example adding "sideeffect=\par Side Effects:\n" will allow you to +# put the command \sideeffect (or @sideeffect) in the documentation, which +# will result in a user-defined paragraph with heading "Side Effects:". +# You can put \n's in the value part of an alias to insert newlines. + +ALIASES = + +# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources +# only. Doxygen will then generate output that is more tailored for C. +# For instance, some of the names that are used will be different. The list +# of all members will be omitted, etc. + +OPTIMIZE_OUTPUT_FOR_C = YES + +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources +# only. Doxygen will then generate output that is more tailored for Java. +# For instance, namespaces will be presented as packages, qualified scopes +# will look different, etc. + +OPTIMIZE_OUTPUT_JAVA = NO + +# Set the SUBGROUPING tag to YES (the default) to allow class member groups of +# the same type (for instance a group of public functions) to be put as a +# subgroup of that type (e.g. under the Public Functions section). Set it to +# NO to prevent subgrouping. Alternatively, this can be done per class using +# the \nosubgrouping command. + +SUBGROUPING = YES + +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- + +# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in +# documentation are documented, even if no documentation was available. +# Private class members and static file members will be hidden unless +# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES + +EXTRACT_ALL = YES + +# If the EXTRACT_PRIVATE tag is set to YES all private members of a class +# will be included in the documentation. + +EXTRACT_PRIVATE = NO + +# If the EXTRACT_STATIC tag is set to YES all static members of a file +# will be included in the documentation. + +EXTRACT_STATIC = NO + +# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) +# defined locally in source files will be included in the documentation. +# If set to NO only classes defined in header files are included. + +EXTRACT_LOCAL_CLASSES = YES + +# This flag is only useful for Objective-C code. When set to YES local +# methods, which are defined in the implementation section but not in +# the interface are included in the documentation. +# If set to NO (the default) only methods in the interface are included. + +EXTRACT_LOCAL_METHODS = NO + +# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all +# undocumented members of documented classes, files or namespaces. +# If set to NO (the default) these members will be included in the +# various overviews, but no documentation section is generated. +# This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_MEMBERS = NO + +# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all +# undocumented classes that are normally visible in the class hierarchy. +# If set to NO (the default) these classes will be included in the various +# overviews. This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_CLASSES = NO + +# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all +# friend (class|struct|union) declarations. +# If set to NO (the default) these declarations will be included in the +# documentation. + +HIDE_FRIEND_COMPOUNDS = NO + +# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any +# documentation blocks found inside the body of a function. +# If set to NO (the default) these blocks will be appended to the +# function's detailed documentation block. + +HIDE_IN_BODY_DOCS = NO + +# The INTERNAL_DOCS tag determines if documentation +# that is typed after a \internal command is included. If the tag is set +# to NO (the default) then the documentation will be excluded. +# Set it to YES to include the internal documentation. + +INTERNAL_DOCS = NO + +# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate +# file names in lower-case letters. If set to YES upper-case letters are also +# allowed. This is useful if you have classes or files whose names only differ +# in case and if your file system supports case sensitive file names. Windows +# users are advised to set this option to NO. + +CASE_SENSE_NAMES = YES + +# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen +# will show members with their full class and namespace scopes in the +# documentation. If set to YES the scope will be hidden. + +HIDE_SCOPE_NAMES = NO + +# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen +# will put a list of the files that are included by a file in the documentation +# of that file. + +SHOW_INCLUDE_FILES = YES + +# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] +# is inserted in the documentation for inline members. + +INLINE_INFO = YES + +# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen +# will sort the (detailed) documentation of file and class members +# alphabetically by member name. If set to NO the members will appear in +# declaration order. + +SORT_MEMBER_DOCS = YES + +# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the +# brief documentation of file, namespace and class members alphabetically +# by member name. If set to NO (the default) the members will appear in +# declaration order. + +SORT_BRIEF_DOCS = NO + +# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be +# sorted by fully-qualified names, including namespaces. If set to +# NO (the default), the class list will be sorted only by class name, +# not including the namespace part. +# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. +# Note: This option applies only to the class list, not to the +# alphabetical list. + +SORT_BY_SCOPE_NAME = NO + +# The GENERATE_TODOLIST tag can be used to enable (YES) or +# disable (NO) the todo list. This list is created by putting \todo +# commands in the documentation. + +GENERATE_TODOLIST = YES + +# The GENERATE_TESTLIST tag can be used to enable (YES) or +# disable (NO) the test list. This list is created by putting \test +# commands in the documentation. + +GENERATE_TESTLIST = YES + +# The GENERATE_BUGLIST tag can be used to enable (YES) or +# disable (NO) the bug list. This list is created by putting \bug +# commands in the documentation. + +GENERATE_BUGLIST = YES + +# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or +# disable (NO) the deprecated list. This list is created by putting +# \deprecated commands in the documentation. + +GENERATE_DEPRECATEDLIST= YES + +# The ENABLED_SECTIONS tag can be used to enable conditional +# documentation sections, marked by \if sectionname ... \endif. + +ENABLED_SECTIONS = + +# The MAX_INITIALIZER_LINES tag determines the maximum number of lines +# the initial value of a variable or define consists of for it to appear in +# the documentation. If the initializer consists of more lines than specified +# here it will be hidden. Use a value of 0 to hide initializers completely. +# The appearance of the initializer of individual variables and defines in the +# documentation can be controlled using \showinitializer or \hideinitializer +# command in the documentation regardless of this setting. + +MAX_INITIALIZER_LINES = 30 + +# Set the SHOW_USED_FILES tag to NO to disable the list of files generated +# at the bottom of the documentation of classes and structs. If set to YES the +# list will mention the files that were used to generate the documentation. + +SHOW_USED_FILES = YES + +#--------------------------------------------------------------------------- +# configuration options related to warning and progress messages +#--------------------------------------------------------------------------- + +# The QUIET tag can be used to turn on/off the messages that are generated +# by doxygen. Possible values are YES and NO. If left blank NO is used. + +QUIET = NO + +# The WARNINGS tag can be used to turn on/off the warning messages that are +# generated by doxygen. Possible values are YES and NO. If left blank +# NO is used. + +WARNINGS = YES + +# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings +# for undocumented members. If EXTRACT_ALL is set to YES then this flag will +# automatically be disabled. + +WARN_IF_UNDOCUMENTED = YES + +# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for +# potential errors in the documentation, such as not documenting some +# parameters in a documented function, or documenting parameters that +# don't exist or using markup commands wrongly. + +WARN_IF_DOC_ERROR = YES + +# The WARN_FORMAT tag determines the format of the warning messages that +# doxygen can produce. The string should contain the $file, $line, and $text +# tags, which will be replaced by the file and line number from which the +# warning originated and the warning text. + +WARN_FORMAT = "$file:$line: $text" + +# The WARN_LOGFILE tag can be used to specify a file to which warning +# and error messages should be written. If left blank the output is written +# to stderr. + +WARN_LOGFILE = + +#--------------------------------------------------------------------------- +# configuration options related to the input files +#--------------------------------------------------------------------------- + +# The INPUT tag can be used to specify the files and/or directories that contain +# documented source files. You may enter file names like "myfile.cpp" or +# directories like "/usr/src/myproject". Separate the files or directories +# with spaces. + +INPUT = @top_srcdir@/include/theora + +# If the value of the INPUT tag contains directories, you can use the +# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank the following patterns are tested: +# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp +# *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm + +FILE_PATTERNS = + +# The RECURSIVE tag can be used to turn specify whether or not subdirectories +# should be searched for input files as well. Possible values are YES and NO. +# If left blank NO is used. + +RECURSIVE = NO + +# The EXCLUDE tag can be used to specify files and/or directories that should +# excluded from the INPUT source files. This way you can easily exclude a +# subdirectory from a directory tree whose root is specified with the INPUT tag. + +EXCLUDE = + +# The EXCLUDE_SYMLINKS tag can be used select whether or not files or directories +# that are symbolic links (a Unix filesystem feature) are excluded from the input. + +EXCLUDE_SYMLINKS = NO + +# If the value of the INPUT tag contains directories, you can use the +# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude +# certain files from those directories. + +EXCLUDE_PATTERNS = + +# The EXAMPLE_PATH tag can be used to specify one or more files or +# directories that contain example code fragments that are included (see +# the \include command). + +EXAMPLE_PATH = + +# If the value of the EXAMPLE_PATH tag contains directories, you can use the +# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank all files are included. + +EXAMPLE_PATTERNS = + +# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be +# searched for input files to be used with the \include or \dontinclude +# commands irrespective of the value of the RECURSIVE tag. +# Possible values are YES and NO. If left blank NO is used. + +EXAMPLE_RECURSIVE = NO + +# The IMAGE_PATH tag can be used to specify one or more files or +# directories that contain image that are included in the documentation (see +# the \image command). + +IMAGE_PATH = + +# The INPUT_FILTER tag can be used to specify a program that doxygen should +# invoke to filter for each input file. Doxygen will invoke the filter program +# by executing (via popen()) the command , where +# is the value of the INPUT_FILTER tag, and is the name of an +# input file. Doxygen will then use the output that the filter program writes +# to standard output. + +INPUT_FILTER = + +# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using +# INPUT_FILTER) will be used to filter the input files when producing source +# files to browse (i.e. when SOURCE_BROWSER is set to YES). + +FILTER_SOURCE_FILES = NO + +#--------------------------------------------------------------------------- +# configuration options related to source browsing +#--------------------------------------------------------------------------- + +# If the SOURCE_BROWSER tag is set to YES then a list of source files will +# be generated. Documented entities will be cross-referenced with these sources. +# Note: To get rid of all source code in the generated output, make sure also +# VERBATIM_HEADERS is set to NO. + +SOURCE_BROWSER = NO + +# Setting the INLINE_SOURCES tag to YES will include the body +# of functions and classes directly in the documentation. + +INLINE_SOURCES = NO + +# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct +# doxygen to hide any special comment blocks from generated source code +# fragments. Normal C and C++ comments will always remain visible. + +STRIP_CODE_COMMENTS = YES + +# If the REFERENCED_BY_RELATION tag is set to YES (the default) +# then for each documented function all documented +# functions referencing it will be listed. + +REFERENCED_BY_RELATION = YES + +# If the REFERENCES_RELATION tag is set to YES (the default) +# then for each documented function all documented entities +# called/used by that function will be listed. + +REFERENCES_RELATION = YES + +# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen +# will generate a verbatim copy of the header file for each class for +# which an include is specified. Set to NO to disable this. + +VERBATIM_HEADERS = YES + +#--------------------------------------------------------------------------- +# configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- + +# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index +# of all compounds will be generated. Enable this if the project +# contains a lot of classes, structs, unions or interfaces. + +ALPHABETICAL_INDEX = NO + +# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then +# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns +# in which this list will be split (can be a number in the range [1..20]) + +COLS_IN_ALPHA_INDEX = 5 + +# In case all classes in a project start with a common prefix, all +# classes will be put under the same header in the alphabetical index. +# The IGNORE_PREFIX tag can be used to specify one or more prefixes that +# should be ignored while generating the index headers. + +IGNORE_PREFIX = + +#--------------------------------------------------------------------------- +# configuration options related to the HTML output +#--------------------------------------------------------------------------- + +# If the GENERATE_HTML tag is set to YES (the default) Doxygen will +# generate HTML output. + +GENERATE_HTML = YES + +# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `html' will be used as the default path. + +HTML_OUTPUT = html + +# The HTML_FILE_EXTENSION tag can be used to specify the file extension for +# each generated HTML page (for example: .htm,.php,.asp). If it is left blank +# doxygen will generate files with .html extension. + +HTML_FILE_EXTENSION = .html + +# The HTML_HEADER tag can be used to specify a personal HTML header for +# each generated HTML page. If it is left blank doxygen will generate a +# standard header. + +HTML_HEADER = + +# The HTML_FOOTER tag can be used to specify a personal HTML footer for +# each generated HTML page. If it is left blank doxygen will generate a +# standard footer. + +HTML_FOOTER = + +# The HTML_STYLESHEET tag can be used to specify a user-defined cascading +# style sheet that is used by each HTML page. It can be used to +# fine-tune the look of the HTML output. If the tag is left blank doxygen +# will generate a default style sheet. Note that doxygen will try to copy +# the style sheet file to the HTML output directory, so don't put your own +# stylesheet in the HTML output directory as well, or it will be erased! + +HTML_STYLESHEET = + +# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, +# files or namespaces will be aligned in HTML using tables. If set to +# NO a bullet list will be used. + +HTML_ALIGN_MEMBERS = YES + +# If the GENERATE_HTMLHELP tag is set to YES, additional index files +# will be generated that can be used as input for tools like the +# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) +# of the generated HTML documentation. + +GENERATE_HTMLHELP = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can +# be used to specify the file name of the resulting .chm file. You +# can add a path in front of the file if the result should not be +# written to the html output directory. + +CHM_FILE = + +# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can +# be used to specify the location (absolute path including file name) of +# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run +# the HTML help compiler on the generated index.hhp. + +HHC_LOCATION = + +# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag +# controls if a separate .chi index file is generated (YES) or that +# it should be included in the master .chm file (NO). + +GENERATE_CHI = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag +# controls whether a binary table of contents is generated (YES) or a +# normal table of contents (NO) in the .chm file. + +BINARY_TOC = NO + +# The TOC_EXPAND flag can be set to YES to add extra items for group members +# to the contents of the HTML help documentation and to the tree view. + +TOC_EXPAND = NO + +# The DISABLE_INDEX tag can be used to turn on/off the condensed index at +# top of each HTML page. The value NO (the default) enables the index and +# the value YES disables it. + +DISABLE_INDEX = NO + +# This tag can be used to set the number of enum values (range [1..20]) +# that doxygen will group on one line in the generated HTML documentation. + +ENUM_VALUES_PER_LINE = 4 + +# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be +# generated containing a tree-like index structure (just like the one that +# is generated for HTML Help). For this to work a browser that supports +# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, +# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are +# probably better off using the HTML help feature. + +GENERATE_TREEVIEW = NO + +# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be +# used to set the initial width (in pixels) of the frame in which the tree +# is shown. + +TREEVIEW_WIDTH = 250 + +#--------------------------------------------------------------------------- +# configuration options related to the LaTeX output +#--------------------------------------------------------------------------- + +# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will +# generate Latex output. + +GENERATE_LATEX = YES + +# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `latex' will be used as the default path. + +LATEX_OUTPUT = latex + +# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be +# invoked. If left blank `latex' will be used as the default command name. + +LATEX_CMD_NAME = latex + +# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to +# generate index for LaTeX. If left blank `makeindex' will be used as the +# default command name. + +MAKEINDEX_CMD_NAME = makeindex + +# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact +# LaTeX documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_LATEX = NO + +# The PAPER_TYPE tag can be used to set the paper type that is used +# by the printer. Possible values are: a4, a4wide, letter, legal and +# executive. If left blank a4wide will be used. + +PAPER_TYPE = a4wide + +# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX +# packages that should be included in the LaTeX output. + +EXTRA_PACKAGES = + +# The LATEX_HEADER tag can be used to specify a personal LaTeX header for +# the generated latex document. The header should contain everything until +# the first chapter. If it is left blank doxygen will generate a +# standard header. Notice: only use this tag if you know what you are doing! + +LATEX_HEADER = + +# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated +# is prepared for conversion to pdf (using ps2pdf). The pdf file will +# contain links (just like the HTML output) instead of page references +# This makes the output suitable for online browsing using a pdf viewer. + +PDF_HYPERLINKS = NO + +# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of +# plain latex in the generated Makefile. Set this option to YES to get a +# higher quality PDF documentation. + +USE_PDFLATEX = NO + +# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. +# command to the generated LaTeX files. This will instruct LaTeX to keep +# running if errors occur, instead of asking the user for help. +# This option is also used when generating formulas in HTML. + +LATEX_BATCHMODE = NO + +# If LATEX_HIDE_INDICES is set to YES then doxygen will not +# include the index chapters (such as File Index, Compound Index, etc.) +# in the output. + +LATEX_HIDE_INDICES = NO + +#--------------------------------------------------------------------------- +# configuration options related to the RTF output +#--------------------------------------------------------------------------- + +# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output +# The RTF output is optimized for Word 97 and may not look very pretty with +# other RTF readers or editors. + +GENERATE_RTF = NO + +# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `rtf' will be used as the default path. + +RTF_OUTPUT = rtf + +# If the COMPACT_RTF tag is set to YES Doxygen generates more compact +# RTF documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_RTF = NO + +# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated +# will contain hyperlink fields. The RTF file will +# contain links (just like the HTML output) instead of page references. +# This makes the output suitable for online browsing using WORD or other +# programs which support those fields. +# Note: wordpad (write) and others do not support links. + +RTF_HYPERLINKS = NO + +# Load stylesheet definitions from file. Syntax is similar to doxygen's +# config file, i.e. a series of assignments. You only have to provide +# replacements, missing definitions are set to their default value. + +RTF_STYLESHEET_FILE = + +# Set optional variables used in the generation of an rtf document. +# Syntax is similar to doxygen's config file. + +RTF_EXTENSIONS_FILE = + +#--------------------------------------------------------------------------- +# configuration options related to the man page output +#--------------------------------------------------------------------------- + +# If the GENERATE_MAN tag is set to YES (the default) Doxygen will +# generate man pages + +GENERATE_MAN = NO + +# The MAN_OUTPUT tag is used to specify where the man pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `man' will be used as the default path. + +MAN_OUTPUT = man + +# The MAN_EXTENSION tag determines the extension that is added to +# the generated man pages (default is the subroutine's section .3) + +MAN_EXTENSION = .3 + +# If the MAN_LINKS tag is set to YES and Doxygen generates man output, +# then it will generate one additional man file for each entity +# documented in the real man page(s). These additional files +# only source the real man page, but without them the man command +# would be unable to find the correct page. The default is NO. + +MAN_LINKS = NO + +#--------------------------------------------------------------------------- +# configuration options related to the XML output +#--------------------------------------------------------------------------- + +# If the GENERATE_XML tag is set to YES Doxygen will +# generate an XML file that captures the structure of +# the code including all documentation. + +GENERATE_XML = NO + +# The XML_OUTPUT tag is used to specify where the XML pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `xml' will be used as the default path. + +XML_OUTPUT = xml + +# The XML_SCHEMA tag can be used to specify an XML schema, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_SCHEMA = + +# The XML_DTD tag can be used to specify an XML DTD, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_DTD = + +# If the XML_PROGRAMLISTING tag is set to YES Doxygen will +# dump the program listings (including syntax highlighting +# and cross-referencing information) to the XML output. Note that +# enabling this will significantly increase the size of the XML output. + +XML_PROGRAMLISTING = YES + +#--------------------------------------------------------------------------- +# configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- + +# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will +# generate an AutoGen Definitions (see autogen.sf.net) file +# that captures the structure of the code including all +# documentation. Note that this feature is still experimental +# and incomplete at the moment. + +GENERATE_AUTOGEN_DEF = NO + +#--------------------------------------------------------------------------- +# configuration options related to the Perl module output +#--------------------------------------------------------------------------- + +# If the GENERATE_PERLMOD tag is set to YES Doxygen will +# generate a Perl module file that captures the structure of +# the code including all documentation. Note that this +# feature is still experimental and incomplete at the +# moment. + +GENERATE_PERLMOD = NO + +# If the PERLMOD_LATEX tag is set to YES Doxygen will generate +# the necessary Makefile rules, Perl scripts and LaTeX code to be able +# to generate PDF and DVI output from the Perl module output. + +PERLMOD_LATEX = NO + +# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be +# nicely formatted so it can be parsed by a human reader. This is useful +# if you want to understand what is going on. On the other hand, if this +# tag is set to NO the size of the Perl module output will be much smaller +# and Perl will parse it just the same. + +PERLMOD_PRETTY = YES + +# The names of the make variables in the generated doxyrules.make file +# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. +# This is useful so different doxyrules.make files included by the same +# Makefile don't overwrite each other's variables. + +PERLMOD_MAKEVAR_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- + +# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will +# evaluate all C-preprocessor directives found in the sources and include +# files. + +ENABLE_PREPROCESSING = YES + +# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro +# names in the source code. If set to NO (the default) only conditional +# compilation will be performed. Macro expansion can be done in a controlled +# way by setting EXPAND_ONLY_PREDEF to YES. + +MACRO_EXPANSION = NO + +# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES +# then the macro expansion is limited to the macros specified with the +# PREDEFINED and EXPAND_AS_PREDEFINED tags. + +EXPAND_ONLY_PREDEF = NO + +# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files +# in the INCLUDE_PATH (see below) will be search if a #include is found. + +SEARCH_INCLUDES = YES + +# The INCLUDE_PATH tag can be used to specify one or more directories that +# contain include files that are not input files but should be processed by +# the preprocessor. + +INCLUDE_PATH = + +# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard +# patterns (like *.h and *.hpp) to filter out the header-files in the +# directories. If left blank, the patterns specified with FILE_PATTERNS will +# be used. + +INCLUDE_FILE_PATTERNS = + +# The PREDEFINED tag can be used to specify one or more macro names that +# are defined before the preprocessor is started (similar to the -D option of +# gcc). The argument of the tag is a list of macros of the form: name +# or name=definition (no spaces). If the definition and the = are +# omitted =1 is assumed. + +PREDEFINED = + +# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then +# this tag can be used to specify a list of macro names that should be expanded. +# The macro definition that is found in the sources will be used. +# Use the PREDEFINED tag if you want to use a different macro definition. + +EXPAND_AS_DEFINED = + +# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then +# doxygen's preprocessor will remove all function-like macros that are alone +# on a line, have an all uppercase name, and do not end with a semicolon. Such +# function macros are typically used for boiler-plate code, and will confuse the +# parser if not removed. + +SKIP_FUNCTION_MACROS = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to external references +#--------------------------------------------------------------------------- + +# The TAGFILES option can be used to specify one or more tagfiles. +# Optionally an initial location of the external documentation +# can be added for each tagfile. The format of a tag file without +# this location is as follows: +# TAGFILES = file1 file2 ... +# Adding location for the tag files is done as follows: +# TAGFILES = file1=loc1 "file2 = loc2" ... +# where "loc1" and "loc2" can be relative or absolute paths or +# URLs. If a location is present for each tag, the installdox tool +# does not have to be run to correct the links. +# Note that each tag file must have a unique name +# (where the name does NOT include the path) +# If a tag file is not located in the directory in which doxygen +# is run, you must also specify the path to the tagfile here. + +TAGFILES = + +# When a file name is specified after GENERATE_TAGFILE, doxygen will create +# a tag file that is based on the input files it reads. + +GENERATE_TAGFILE = + +# If the ALLEXTERNALS tag is set to YES all external classes will be listed +# in the class index. If set to NO only the inherited external classes +# will be listed. + +ALLEXTERNALS = NO + +# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed +# in the modules index. If set to NO, only the current project's groups will +# be listed. + +EXTERNAL_GROUPS = YES + +# The PERL_PATH should be the absolute path and name of the perl script +# interpreter (i.e. the result of `which perl'). + +PERL_PATH = /usr/bin/perl + +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- + +# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will +# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base or +# super classes. Setting the tag to NO turns the diagrams off. Note that this +# option is superseded by the HAVE_DOT option below. This is only a fallback. It is +# recommended to install and use dot, since it yields more powerful graphs. + +CLASS_DIAGRAMS = YES + +# If set to YES, the inheritance and collaboration graphs will hide +# inheritance and usage relations if the target is undocumented +# or is not a class. + +HIDE_UNDOC_RELATIONS = YES + +# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is +# available from the path. This tool is part of Graphviz, a graph visualization +# toolkit from AT&T and Lucent Bell Labs. The other options in this section +# have no effect if this option is set to NO (the default) + +HAVE_DOT = NO + +# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect inheritance relations. Setting this tag to YES will force the +# the CLASS_DIAGRAMS tag to NO. + +CLASS_GRAPH = YES + +# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect implementation dependencies (inheritance, containment, and +# class references variables) of the class with other documented classes. + +COLLABORATION_GRAPH = YES + +# If the UML_LOOK tag is set to YES doxygen will generate inheritance and +# collaboration diagrams in a style similar to the OMG's Unified Modeling +# Language. + +UML_LOOK = NO + +# If set to YES, the inheritance and collaboration graphs will show the +# relations between templates and their instances. + +TEMPLATE_RELATIONS = NO + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT +# tags are set to YES then doxygen will generate a graph for each documented +# file showing the direct and indirect include dependencies of the file with +# other documented files. + +INCLUDE_GRAPH = YES + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and +# HAVE_DOT tags are set to YES then doxygen will generate a graph for each +# documented header file showing the documented files that directly or +# indirectly include this file. + +INCLUDED_BY_GRAPH = YES + +# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a call dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable call graphs for selected +# functions only using the \callgraph command. + +CALL_GRAPH = NO + +# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen +# will graphical hierarchy of all classes instead of a textual one. + +GRAPHICAL_HIERARCHY = YES + +# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images +# generated by dot. Possible values are png, jpg, or gif +# If left blank png will be used. + +DOT_IMAGE_FORMAT = png + +# The tag DOT_PATH can be used to specify the path where the dot tool can be +# found. If left blank, it is assumed the dot tool can be found on the path. + +DOT_PATH = + +# The DOTFILE_DIRS tag can be used to specify one or more directories that +# contain dot files that are included in the documentation (see the +# \dotfile command). + +DOTFILE_DIRS = + +# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. +#This tag is now obsolete, according to doxygen 1.5.2 +#MAX_DOT_GRAPH_WIDTH = 1024 + +# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. +#This tag is now obsolete, according to doxygen 1.5.2 +#MAX_DOT_GRAPH_HEIGHT = 1024 + +# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the +# graphs generated by dot. A depth value of 3 means that only nodes reachable +# from the root by following a path via at most 3 edges will be shown. Nodes that +# lay further from the root node will be omitted. Note that setting this option to +# 1 or 2 may greatly reduce the computation time needed for large code bases. Also +# note that a graph may be further truncated if the graph's image dimensions are +# not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH and MAX_DOT_GRAPH_HEIGHT). +# If 0 is used for the depth value (the default), the graph is not depth-constrained. +#This tag is now obsolete, according to doxygen 1.5.2 +#MAX_DOT_GRAPH_DEPTH = 0 + +# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will +# generate a legend page explaining the meaning of the various boxes and +# arrows in the dot generated graphs. + +GENERATE_LEGEND = YES + +# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will +# remove the intermediate dot files that are used to generate +# the various graphs. + +DOT_CLEANUP = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to the search engine +#--------------------------------------------------------------------------- + +# The SEARCHENGINE tag specifies whether or not a search engine should be +# used. If set to NO the values of all tags below this one will be ignored. + +SEARCHENGINE = NO diff --git a/libs/libtheora-1.1/doc/Makefile.am b/libs/libtheora-1.1/doc/Makefile.am new file mode 100644 index 00000000..783bd015 --- /dev/null +++ b/libs/libtheora-1.1/doc/Makefile.am @@ -0,0 +1,72 @@ +## Process this file with automake to produce Makefile.in + +SUBDIRS = spec + +static_docs = vp3-format.txt color.html \ + draft-ietf-avt-rtp-theora-00.xml \ + draft-ietf-avt-rtp-theora-00.txt + +doc_DATA = $(static_docs) doxygen-build.stamp + +EXTRA_DIST = $(static_docs) Doxyfile.in + +if HAVE_DOXYGEN +doxygen-build.stamp: Doxyfile $(top_srcdir)/include/theora/*.h + doxygen + touch doxygen-build.stamp +else +doxygen-build.stamp: + echo "*** Warning: Doxygen not found; documentation will not be built." + touch doxygen-build.stamp +endif + +dist_docdir = $(distdir)/libtheora + +dist-hook: + if test -d libtheora; then \ + mkdir $(dist_docdir); \ + echo -n "copying built documenation..."; \ + for dir in libtheora/*; do \ + b=`basename $$dir`; \ + if test $$b != ".svn"; then \ + if test -d $$dir; then \ + mkdir $(dist_docdir)/$$b; \ + for f in $$dir/*; do \ + cp -p $$f $(dist_docdir)/$$b; \ + done; \ + fi; \ + fi; \ + done; \ + echo "OK"; \ + fi + for item in $(EXTRA_DIST); do \ + if test -d $$item; then \ + echo -n "cleaning $$item dir for distribution..."; \ + rm -rf `find $(distdir)/$$item -name .svn`; \ + echo "OK"; \ + fi; \ + done + + + +install-data-local: doxygen-build.stamp + $(mkinstalldirs) $(DESTDIR)$(docdir) + if test -d libtheora; then \ + for dir in libtheora/*; do \ + if test -d $$dir; then \ + b=`basename $$dir`; \ + $(mkinstalldirs) $(DESTDIR)$(docdir)/$$b; \ + for f in $$dir/*; do \ + $(INSTALL_DATA) $$f $(DESTDIR)$(docdir)/$$b; \ + done \ + fi \ + done \ + fi + +uninstall-local: + rm -rf $(DESTDIR)$(docdir) + +clean-local: + if test -d libtheora; then rm -rf libtheora; fi + if test -f doxygen-build.stamp; then rm -f doxygen-build.stamp; fi + diff --git a/libs/libtheora-1.1/doc/color.html b/libs/libtheora-1.1/doc/color.html new file mode 100644 index 00000000..ad7d90cd --- /dev/null +++ b/libs/libtheora-1.1/doc/color.html @@ -0,0 +1,602 @@ + +xiph.org: Ogg Theora documentation + +

+Ogg Theora I specification: color space conventions +

+

Overview

+

+There are a large number of different color standards used in digital video. +Since Theora is a lossy codec, it restricts itself to only a few of them to + simplify playback. +Unlike the alternate method of describing all the parameters of the color + model, this allows a few dedicated routines for color conversion to be written + and heavily optimized in a decoder. +More flexible conversion functions should instead be specified in an encoder, + where additional computational complexity is more easily tolerated. +The color spaces were selected to give a fair representation of color standards + in use around the world today. +Most of the standards that do not exactly match one of these can be converted + to one fairly easily. +

+

+The Theora codec identification header contains an 8-bit value that describes + the color space. +This merely selects one of the color spaces available from an enumerated list. +Currently, only two color spaces are defined, with a third possibility that + indicates the color space is "unknown". +All of them are Y'CbCr color spaces with one luma channel + and two chroma channels. +Each channel contains 8-bit discrete values in the range 0-255, which represent + non-linear gamma pre-corrected signals. +

+

color space parameters

+

+The parameters which describe each color space are listed below. +These are the parameters needed to map colors from the encoded + Y'CbCr representation to the device-independent color + space CIE XYZ (1931). +

+
+
Y'CbCr to Y'PbPr
+
+

+This conversion takes 8-bit discrete values in the range 0-255 and maps them to + real values in the range [0,1] for Y and [-1/2,1/2] for Pb + and Pr. +Because some values may fall outside the offset and excursion defined for each + channel in the Y'CbCr space, the results may fall + outside these ranges in Y'PbPr space. +No clamping should be done at this stage. +

+

+Parameters: OffsetY,Cb,Cr, + ExcursionY,Cb,Cr, +

+ + + + + + + + + + + + + + + + +
Y'out= +(Y'in-OffsetY)/ + ExcursionY +
Pb= +(Cb-OffsetCb)/ + ExcursionCb +
Pr= +(Cr-OffsetCr)/ + ExcursionCr +
+
+
Y'PbPr to R'G'B'
+
+

+This conversion takes the one luma and two chroma channel representation and + maps it to the non-linear R'G'B' space used to drive actual output devices. +Values should be clamped into the range [0,1] after this stage. +

+Parameters: Kb, Kr +

+ + + + + + + + + + + + + + + + +
R'=Y' + 2(1-Kr)Pr
G'= +Y' + + 2((Kb-1)Kb/ + (1-Kb-Kr))Pb + + 2((Kr-1)Kr/ + (1-Kb-Kr))Pr +
B'=Y' + 2(1-Kb)Pb
+
+
R'G'B' to RGB (Output device gamma correction)
+
+

+This conversion takes the non-linear R'G'B' voltage levels and maps it to the + linear light levels produced by the actual output device. +Note that this conversion is only that of the output device, and its inverse is + not that used by the input device. +Because a dim viewing environment is assumed in most television standards, the + overall gamma between the input and output devices is usually around 1.1 to + 1.2, and not a strict 1.0. +

+

+For calibration with actual output devices, the model + + + + + + +
L=(E'+Δ)γ
+should be used, with Δ the free parameter and γ held + fixed to the value specified in this document. +The conversion function presented here is an idealized version with Δ=0. +

+

+Parameters: γ +

+ + + + + + + + + + + + + + + + +
R=R'γ
G=G'γ
B=B'γ
+
+
RGB to R'G'B' (Input device gamma correction)
+
+

+This conversion takes linear light levels and maps them to the non-linear + voltage levels used to drive the actual output device. +This information is merely informative. +It is not required for building a decoder or for converting between the various + formats and the actual output capabilities of a particular device. +

+

+A linear segment is introduced on the low end to reduce noise in dark areas of + the image. +The rest of the scale is adjusted so that the power segment of the curve + intersects the linear segment with the proper slope, and so that it still maps + 0 to 0 and 1 to 1. +

+

+Parameters: β, α, δ, + ε +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
R'= +(1+ε)Rβ-ε +for δ ≤ R ≤ 1
R'=αRfor 0 ≤ R < δ
G'= +(1+ε)Gβ-ε +for δ ≤ G ≤ 1
G'=αGfor 0 ≤ G < δ
B'= +(1+ε)Bβ-ε +for δ ≤ B ≤ 1
B'=αBfor 0 ≤ B < δ
+
+
RGB to CIE XYZ (1931)
+
+

+This conversion maps a device-dependent linear RGB space to the + device-independent linear CIE XYZ space. +The parameters are the CIE chromaticity coordinates of the three primaries, + red, green, and blue, as well as the chromaticity coordinates of the white + point of the device. +This is how hardware manufacturers and standards typically describe a + particular RGB space. +The math required to convert these parameters into a useful transformation + matrix is reproduced below. +

+

+Parameters: xr,g,b,w, yr,g,b,w +

+ + + + + + + + + + + + + + + + +
F= + + +) +
( + + + + + + + + + + + + + + + +
xr/yrxg/ygxb/yb
111
+(1-xr-yr)/yr + +(1-xg-yg)/yg + +(1-xb-yb)/yb +
+ + + +
( + + + +
sr
sg
sb
)
= + + + +
F-1( + + + +
xw/yw
1
+(1-xw-yw)/yw +
)
+ + + +
( + + + +
X
Y
Z
)
= + + + +
F( + + + +
srR
sgG
sbB
)
+
+
+

available color spaces

+

+These are the color spaces currently defined for use by Ogg Theora video. +Each one has a short name, with which it is referred to in this document, and + a more detailed specification of the standards from which its parameters are + derived. +Some standards do not specify all the parameters necessary. +For these unspecified parameters, this document serves as the definition of + what should be used when encoding or decoding Ogg Theora video. +

Rec 470M (Rec. ITU-R BT.470-6 System M/NTSC with Rec. ITU-R BT.601-5)

+

+This color space is used by broadcast television and DVDs in much of the + Americas, Japan, Korea, and the Union of Myanmar + [Rec470]. +This color space may also be used for System M/PAL (Brazil), with an + appropriate conversion supplied by the encoder to compensate for the + different gamma value. +See the Rec 470BG section for an appropriate gamma value to assume for M/PAL + input. +

+

+In the US, studio monitors are adjusted to a D65 white point + (xw,yw=0.313,0.329). +In Japan, studio monitors are adjusted to a D white of 9300K + (xw,yw=0.285,0.293). +

+

+Rec 470 does not specify a digital encoding of the color signals. +For Ogg Theora, Rec. ITU-R BT.601-5 is used, starting from the R'G'B' signals + specified by Rec 470 [Rec601]. +

+

+

+Rec 470 does not specify an input gamma function. +For Ogg Theora, the Rec 709 input function is used. +This is the same as that specified by SMPTE 170M, which claims to reflect + modern practice in the creation of NTSC signals (c. 1994) + [SMPTE170M]. +

+

parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OffsetY,Cb,Cr=(16,128,128)
+ExcursionY,Cb,Cr +=(219,224,224)
Kb=0.114
Kr=0.299
γ=2.2
β=0.45
α=4.5
δ=0.018
ε=0.099
xr,yr=0.67,0.33
xg,yg=0.21,0.71
xb,yb=0.14,0.08
+(Illuminant C) xw,yw +=0.310,0.316
+

+Rec 470BG (Rec. ITU-R BT.470-6 Systems B and G with Rec. ITU-R BT.601-5) +

+

+This color space is used by the PAL and SECAM systems in much of the rest of + the world [Rec470]. +This can be used directly by systems (B, B1, D, D1, G, H, I, K, N)/PAL and (B, + D, G, H, K, K1, L)/SECAM. +

+

+Note that the Rec 470BG chromaticity values are different from those specified + in Rec 470M. +When PAL and SECAM systems were first designed, they were based upon the same + primaries as NTSC. +However, as methods of making color picture tubes have changed, the primaries + used have changed as well. +The US recommends using correction circuitry to approximate the existing, + standard NTSC primaries. +Current PAL and SECAM systems have standardized on primaries in accord with + more recent technology. +

+

+Rec 470 provisionally permits the use of the NTSC chromaticity values (given + above) with legacy PAL and SECAM equipment. +In Ogg Theora, material must be decoded assuming the new PAL and SECAM + primaries. +Material intended for display on old legacy devices should be converted by the + decoder. +

+

+The official Rec 470BG specifies a gamma value of γ=2.8. +However, in practice this value is unrealistically high + [Poy97]. +Rec 470BG states that the overall system gamma should be approximately + γ/β=1.2. +However, most cameras pre-correct with a gamma value of β=0.45, + which suggests an output device gamma of approximately γ=2.67. +This is the value recommended for use with PAL systems in Ogg Theora. +

+

+Rec 470 does not specify a digital encoding of the color signals. +For Ogg Theora, Rec. ITU-R BT.601-5 is used, starting from the R'G'B' signals + specified by Rec 470 [Rec601]. +

+

+Rec 470 does not specify an input gamma function. +For Ogg Theora, the Rec 709 input function is used. +

+

parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OffsetY,Cb,Cr=(16,128,128)
+ExcursionY,Cb,Cr +=(219,224,224)
Kb=0.114
Kr=0.299
γ=2.67
β=0.45
α=4.5
δ=0.018
ε=0.099
xr,yr=0.64,0.33
xg,yg=0.29,0.60
xb,yb=0.15,0.06
+(D65) xw,yw +=0.313,0.329
+

references

+
+
[Poy97]
+
+Poynton, Charles, Frequently-Asked Questions about Gamma. + http://www.poynton.com/GammaFAQ/html, + Feb. 1997. +
+
[Rec470]
+
+Recommendation ITU-R BT.470-6, Conventional Television Systems + (1970, revised 1998). International Telecommunications Union, 1211 Geneva 20, + Switzerland. +
+
[Rec601]
+
+Recommendation ITU-R BT.601-5, Studio Encoding Parameters of + Digital Television for Standard 4:3 and Wide-Screen 16:9 Aspect Ratios + (1982, revised 1995). International Telecommunications Union, 1211 Geneva 20, + Switzerland. +
+
[Rec709]
+
+Recommendation ITU-R BT.709-5, Parameter values for the + HDTV standards for production and international programme exchange + (1990, revised 2002). International Telecommunications Union, 1211 Geneva 20, + Switzerland. +
+
[SMPTE170M]
+
+Society of Motion Picture and Television Engineers, Television — + Composite Analog Video Signal — NTSC for Studio Applications. + SMPTE-170M, 1994 +
+
[SMPTE240M]
+
+Society of Motion Picture and Television Engineers, Television — + Signal Parameters — 1125-Line High-Definition Production. + SMPTE-240M, 1999. +
+
+ + diff --git a/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.txt b/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.txt new file mode 100644 index 00000000..f759aef6 --- /dev/null +++ b/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.txt @@ -0,0 +1,1400 @@ + + + +AVT Working Group L. Barbato +Internet-Draft Xiph.Org +Expires: January 22, 2007 July 21, 2006 + + + draft-ietf-avt-rtp-theora-00 + RTP Payload Format for Theora Encoded Video + +Status of this Memo + + By submitting this Internet-Draft, each author represents that any + applicable patent or other IPR claims of which he or she is aware + have been or will be disclosed, and any of which he or she becomes + aware will be disclosed, in accordance with Section 6 of BCP 79. + + Internet-Drafts are working documents of the Internet Engineering + Task Force (IETF), its areas, and its working groups. Note that + other groups may also distribute working documents as Internet- + Drafts. + + Internet-Drafts are draft documents valid for a maximum of six months + and may be updated, replaced, or obsoleted by other documents at any + time. It is inappropriate to use Internet-Drafts as reference + material or to cite them other than as "work in progress." + + The list of current Internet-Drafts can be accessed at + http://www.ietf.org/ietf/1id-abstracts.txt. + + The list of Internet-Draft Shadow Directories can be accessed at + http://www.ietf.org/shadow.html. + + This Internet-Draft will expire on January 22, 2007. + +Copyright Notice + + Copyright (C) The Internet Society (2006). + +Abstract + + This document describes a RTP payload format for transporting Theora + encoded video. It details the RTP encapsulation mechanism for raw + Theora data and configuration headers necessary to configure the + decoder. + + Also included within the document are the necessary details for the + use of Theora with MIME and Session Description Protocol (SDP). + +Editors Note + + + +Barbato Expires January 22, 2007 [Page 1] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + All references to RFC XXXX are to be replaced by references to the + RFC number of this memo, when published. + + +Table of Contents + + 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 + 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4 + 2. Payload Format . . . . . . . . . . . . . . . . . . . . . . . . 4 + 2.1. RTP Header . . . . . . . . . . . . . . . . . . . . . . . . 4 + 2.2. Payload Header . . . . . . . . . . . . . . . . . . . . . . 5 + 2.3. Payload Data . . . . . . . . . . . . . . . . . . . . . . . 6 + 2.4. Example RTP Packet . . . . . . . . . . . . . . . . . . . . 7 + 3. Configuration Headers . . . . . . . . . . . . . . . . . . . . 8 + 3.1. In-band Header Transmission . . . . . . . . . . . . . . . 9 + 3.1.1. Packed Configuration . . . . . . . . . . . . . . . . . 9 + 3.2. Out of Band Transmission . . . . . . . . . . . . . . . . . 10 + 3.2.1. Packed Headers . . . . . . . . . . . . . . . . . . . . 11 + 3.3. Loss of Configuration Headers . . . . . . . . . . . . . . 13 + 4. Comment Headers . . . . . . . . . . . . . . . . . . . . . . . 13 + 5. Frame Packetizing . . . . . . . . . . . . . . . . . . . . . . 14 + 5.1. Example Fragmented Theora Packet . . . . . . . . . . . . . 15 + 5.2. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . 17 + 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 + 6.1. Mapping MIME Parameters into SDP . . . . . . . . . . . . . 19 + 6.1.1. SDP Example . . . . . . . . . . . . . . . . . . . . . 20 + 6.2. Usage with the SDP Offer/Answer Model . . . . . . . . . . 20 + 7. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 + 7.1. Stream Video . . . . . . . . . . . . . . . . . . . . . . . 21 + 8. Security Considerations . . . . . . . . . . . . . . . . . . . 21 + 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 22 + 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 22 + 10.1. Normative References . . . . . . . . . . . . . . . . . . . 22 + 10.2. Informative References . . . . . . . . . . . . . . . . . . 23 + Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 24 + Intellectual Property and Copyright Statements . . . . . . . . . . 25 + + + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 2] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +1. Introduction + + Theora is a general purpose, lossy video codec. It is based on the + VP3 video codec produced by On2 Technologies and has been donated to + the Xiph.org Foundation. + + Theora I is a block-based lossy transform codec that utilizes an 8 x + 8 Type-II Discrete Cosine Transform and block-based motion + compensation. This places it in the same class of codecs as MPEG-1, + MPEG-2, MPEG-4, and H.263. The details of how individual blocks are + organized and how DCT coefficients are stored in the bitstream differ + substantially from these codecs, however. Theora supports only intra + frames (I frames in MPEG) and inter frames (P frames in MPEG). + + Theora provides none of its own framing, synchronization, or + protection against transmission errors. Instead, the codec expects + to receive a discrete sequence of data packets. Theora is a free- + form variable bit rate (VBR) codec, and these packets have no minimum + size, maximum size, or fixed/expected size. Theora packets are thus + intended to be used with a transport mechanism that provides free- + form framing, synchronization, positioning, and error correction in + accordance with these design assumptions, such as Ogg [1] or RTP/AVP + [3]. + + Theora I currently supports progressive video data of arbitrary + dimensions at a constant frame rate in one of several Y'CbCr color + spaces. Three different chroma subsampling formats are supported: + 4:2:0, 4:2:2, and 4:4:4. The Theora I format does not support + interlaced material, variable frame rates, bit-depths larger than 8 + bits per component, nor alternate color spaces such as RGB or + arbitrary multi-channel spaces. Black and white content can be + efficiently encoded, however, because the uniform chroma planes + compress well. For performance reason, arbitrary frame sizes will be + encoded rounding both dimensions to the upper multiple of 16. The + original width and height will be encoded in the header and the + decoder will use this information to clip the decoded frame to the + right dimensions. + + Theora is similar to the Vorbis audio [10] in that the decoder reads + the probability model for the entropy coder and all quantization + parameters from special "header" packets at the start of the + compressed data. It is therefore impossible to decode any video data + without having previously fetched the codec info and codec setup + headers, although Theora can begin to decode at an arbitrary intra- + frame packet so long as the codec has been initialized with the + associated headers. + + + + + +Barbato Expires January 22, 2007 [Page 3] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +1.1. Terminology + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [2]. + + +2. Payload Format + + For RTP based transportation of Theora encoded video the standard RTP + header is followed by a 4 octets payload header, then the payload + data. The payload headers are used to associate the Theora data with + its associated decoding codebooks as well as indicating if the + following packet contains fragmented Theora data and/or the number of + whole Theora data frames. The payload data contains the raw Theora + bitstream information. + + For RTP based transport of Theora encoded video the standard RTP + header is followed by a 4 octets payload header, then the payload + data. + +2.1. RTP Header + + The format of the RTP header is specified in [3] and shown in Figure + 1. This payload format uses the fields of the header in a manner + consistent with that specification. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | sequence number | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | timestamp | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 1: RTP Header + + The RTP header begins with an octet of fields (V, P, X, and CC) to + support specialized RTP uses (see [3] and [4] for details). For + Theora RTP, the following values are used. + + Version (V): 2 bits + + + + +Barbato Expires January 22, 2007 [Page 4] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + This field identifies the version of RTP. The version used by this + specification is two (2). + + Padding (P): 1 bit + + Padding MAY be used with this payload format according to section 5.1 + of [3]. + + Extension (X): 1 bit + + The Extension bit is used in accordance with [3]. + + CSRC count (CC): 4 bits + + The CSRC count is used in accordance with [3]. + + Marker (M): 1 bit + + The Marker bit is used in accordance with [3]. + + Payload Type (PT): 7 bits + + An RTP profile for a class of applications is expected to assign a + payload type for this format, or a dynamically allocated payload type + SHOULD be chosen which designates the payload as Theora. + + Sequence number: 16 bits + + The sequence number increments by one for each RTP data packet sent, + and may be used by the receiver to detect packet loss and to restore + packet sequence. This field is detailed further in [3]. + + Timestamp: 32 bits + + A timestamp representing the presentation time of the first sample of + the first Theora packet in the RTP packet. The clock frequency MUST + be set to 90kHz. + + SSRC/CSRC identifiers: + + These two fields, 32 bits each with one SSRC field and a maximum of + 16 CSRC fields, are as defined in [3]. + +2.2. Payload Header + + The 4 octets following the RTP Header section represent the Payload + Header. This header is split into a number of bitfields detailing + the format of the following Payload Datagrams. + + + +Barbato Expires January 22, 2007 [Page 5] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | F |TDT|# pkts.| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + +-+-+-+-+-+-+-+-+ + + Figure 2: Payload Header + + Configuration Ident: 24 bits + + This 24 bit field is used to associate the Theora data to a decoding + Packed Configuration. + + Fragment type (F): 2 bit + + This field is set according to the following list + + 0 = Not Fragmented + 1 = Start Fragment + 2 = Continuation Fragment + 3 = End Fragment + + This field must be zero if the number of packets field is non-zero. + + Theora Data Type (TDT): 2 bits + + This field sets the packet payload type for the Theora data. There + are currently three Theora payload types currently used and one + reserved for future use. + + 0 = Raw Theora payload + 1 = Theora Packed Configuration payload + 2 = Legacy Theora Comment payload + 3 = Reserved + + The packets with a TDT of value 3 MUST be ignored + + The last 4 bits represent the number of complete packets in this + payload. This provides a maximum number of 15 Theora packets in the + payload. If the packet contains fragmented data the number of + packets MUST be set to 0. + +2.3. Payload Data + + Each Theora payload section starts with a two octets length header + that is used to represent the size of the following data payload, + + + +Barbato Expires January 22, 2007 [Page 6] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + followed by the raw Theora packet data. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Payload Length | Theora Data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 3: Payload Data + + The Theora codec uses relatively unstructured raw packets containing + binary integer fields of arbitrary width that often do not fall on an + octet boundary. When a Theora encoder produces packets, unused space + in the last byte of a packet is always zeroed during the encoding + process. Thus, should this unused space be read, it will return + binary zeros. + + For payloads which consist of multiple Theora packets the payload + data consists of the payload length field followed by the first + Theora packet's data, then the payload length followed by the second + Theora packet, and so on for each of the Theora packets in the + payload. + +2.4. Example RTP Packet + + Here is an example RTP packet containing two Theora packets. + + RTP Packet Header: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | 2 |0|0| 0 |0| PT | sequence number | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | timestamp | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronisation source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 4: Example RTP Packet + + Payload Data: + + + + + + +Barbato Expires January 22, 2007 [Page 7] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 0 | 0 | 2 pks | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Payload Length | .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. data | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 5: Example Theora Payload Packet + + The payload portion of the packet begins with the 24 bit + Configuration ident field followed by 8 bits describing the payload. + The Fragment type field is set to 0, indicating that this packet + contains whole Theora frame data. The Data type field is set to 0 + (theora raw data). The number of whole Theora data packets is set to + 2. + + Each of the payload blocks starts with the two octets length field + followed by the variable length Theora packet data. + + +3. Configuration Headers + + To decode a Theora stream three configuration header packets are + needed. The first (Identification Header) indicates frame + dimensions, quality, blocks used and Theora encoder version. The + second (Comment Header) contains stream metadata and the third (Setup + Header) contains details of the dequantization and Huffman tables. + + Since this information must be transmitted reliably, and as the RTP + stream may change certain configuration data mid-session, there are + different methods for delivering this configuration data to a client, + both in-band and out-of-band, which are detailed below. SDP delivery + is used to set up an initial state for the client application. The + changes may be due to different dequantization and Huffman tables as + well as different bitrates of the stream. + + The delivery vectors in use are specified by an SDP attribute that + indicates the method and the optional URI where the Theora Packed + Configuration (Section 3.1.1) Packets could be fetched. Different + delivery methods MAY be advertised for the same session. The in-band + codebook delivery SHOULD be considered as baseline, out-of-band + + + +Barbato Expires January 22, 2007 [Page 8] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + delivery methods that don't use RTP will not be described in this + document. For non chained streams, the RECOMMENDED Configuration + delivery method is inline the Packed Configuration (Section 3.1.1) in + the SDP as explained in the IANA considerations (Section 6.1) + + The 24 bit Ident field is used to map which Configuration will be + used to decode a packet. When the Ident field changes, it indicates + that a change in the stream has taken place. The client application + MUST have in advance the correct configuration and if the client + detects a change in the Ident value and does not have this + information it MUST NOT decode the raw data associated until it has + fetched the correct Configuration. + +3.1. In-band Header Transmission + + The Packed Configuration (Section 3.1.1) Payload is sent in-band with + the packet type bits set to match the payload type. Clients MUST be + capable of dealing with periodic re-transmission of the configuration + headers. + +3.1.1. Packed Configuration + + A Theora Packed Configuration is identified by a payload type field + of 1. Of the three headers, defined in the Theora I specification + [16], the identification and the setup will be packed together, while + the comment header will be completely suppressed. It is up to the + client to provide a minimal size comment header to the decoder if + required by the implementation. + + + + + + + + + + + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 9] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | xxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 0 | 1 | 1| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | length | Identification .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Identification .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Identification .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Identification | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. | Setup .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 6: Packed Configuration Figure + + The Ident field is set with the value that will be used by the Raw + Payload Packets to address this Configuration. The Fragment type is + set to 0 since the packet bears full Packed configuration, the number + of packet is set to 1. In practice, Packed Headers usually need to + be fragmented to fit the path MTU. + +3.2. Out of Band Transmission + + This section, as stated above, does not cover all the possible out- + of-band delivery methods since they rely on different protocols and + are linked to specific applications. The following packet definition + SHOULD be used in out-of-band delivery and MUST be used when + Configuration is inlined in the SDP. + + + + + + +Barbato Expires January 22, 2007 [Page 10] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +3.2.1. Packed Headers + + As mentioned above, the recommended delivery vector for Theora + configuration data is via a retrieval method that can be performed + using a reliable transport protocol. As the RTP headers are not + required for this method of delivery the structure of the + configuration data is slightly different. The packed header starts + with a 32 bit count field which details the number of packed headers + that are contained in the bundle. Next is the Packed header payload + for each setup id. + + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Number of packed headers | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Packed header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Packed header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 7: Packed Headers Overview + + Since the Configuration Ident and the Identification Header are fixed + length there is only a 16bit Length tag to define the length of the + packed headers. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Length | Identification Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Identification Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 8: Packed Headers Detail + + The key difference from the in-band format is that there is no need + for the payload header octet. + + + + + + +Barbato Expires January 22, 2007 [Page 11] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +3.2.1.1. Packed Headers IANA Considerations + + The following IANA considerations MUST only be applied to the packed + headers. + + MIME media type name: audio + + MIME subtype: theora-config + + Required Parameters: + + None + + Optional Parameters: + + None + + Encoding considerations: + + This media type contains binary data. + + Security Considerations: + + See Section 6 of RFC XXXX. + + Interoperability considerations: + + None + + Published specification: + + RFC XXXX [RFC Editor: please replace by the RFC number of this + memo, when published] + + Applications which use this media type: + + Theora encoded video, configuration data. + + Additional information: + + None + + Person & email address to contact for further information: + + Luca Barbato: + IETF Audio/Video Transport Working Group + + + + + +Barbato Expires January 22, 2007 [Page 12] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Intended usage: COMMON + + Restriction on usage: + + This media type does not depend on the transport. + + Author: + + Luca Barbato + + Change controller: + + IETF AVT Working Group + +3.3. Loss of Configuration Headers + + Unlike the loss of raw Theora payload data, the loss of a + configuration header can lead to a situation where it will not be + possible to successfully decode the stream. + + A loss of a Configuration Packet causes the stream decoder to halt + and SHOULD be reported to the client as well as a loss report sent + via RTCP. + + +4. Comment Headers + + When the payload type is set to 2, the packet contains comment + metadata such as artist name, track title and so on. These metadata + messages are not intended to be fully descriptive but to offer basic + title information. Clients MAY choose to completely ignore them. + The details on the comments format can be found in the Theora + documentation [16]. + + + + + + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 13] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | xxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 0 | 2 | 1| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | length | Comment .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Comment .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Comment | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 9: Comment Packet + + The 2 byte length field is necessary since this Theora packet could + be fragmented. + + +5. Frame Packetizing + + Each RTP packet contains either one complete Theora packet, one + Theora packet fragment, or an integer number of complete Theora + packets (up to a maximum of 15 packets, since the number of packets + is defined by a 4 bit value). + + Any Theora data packet that is less than path MTU SHOULD be bundled + in the RTP packet with as many Theora packets as will fit, up to a + maximum of 15. Path MTU is detailed in [7] and [8]. + + A fragmented packet has a zero in the last four bits of the payload + header. The RTP packet containing the first fragment will set the + Fragment type to 1. Each RTP packet after the first will set the + Fragment type to 2 in the payload header. The RTP packet containing + the last fragment of the Theora packet will have the Fragment type + set to 3. If the fragmented Theora packet spans only two RTP + packets, the first will set the Fragment type field to 1 and the + second will set it to 2. To maintain the correct sequence for + fragmented packet reception the timestamp field of fragmented packets + + + +Barbato Expires January 22, 2007 [Page 14] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + MUST be the same as the first packet sent, with the sequence number + incremented as normal for the subsequent RTP packets. + +5.1. Example Fragmented Theora Packet + + Here is an example fragmented Theora packet split over three RTP + packets. Each packet contains the standard RTP headers as well as + the 4 octets Theora headers. + + Packet 1: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1000 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 1 | 0 | 0| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Payload Length | Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 10: Example Fragmented Packet (Packet 1) + + In this packet the initial sequence number is 1000 and the timestamp + is xxxxx. The Fragment type field is set to one, indicating it is + the start packet of a serie of fragments. The number of packets + field is set to 0, and as the payload is raw Theora data the Theora + payload type field is set to 0. + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 15] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Packet 2: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1001 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 2 | 0 | 0| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Payload Length | .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 11: Example Fragmented Packet (Packet 2) + + The Fragment type field is set to 2 and the number of packets field + is set to 0. For large Theora fragments there can be several of + these type of payload packets. The maximum RTP packet size SHOULD be + no greater than the path MTU, including all RTP and payload headers. + The sequence number has been incremented by one but the timestamp + field remains the same as the initial packet. + + + + + + + + + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 16] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Packet 3: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1002 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Configuration Ident | 3 | 0 | 0| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Payload Length | .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 12: Example Fragmented Packet (Packet 3) + + This is the last Theora fragment packet. The Fragment type filed is + set to 3 and the packet count remains set to 0. As in the previous + packets the timestamp remains set to the first packet in the sequence + and the sequence number has been incremented. + +5.2. Packet Loss + + As there is no error correction within the Theora stream, packet loss + will result in a loss of signal. Packet loss is more of an issue for + fragmented Theora packets as the client will have to cope with the + handling of the Fragment type field. If we use the fragmented Theora + packet example above and the first packet is lost the client MUST + detect that the next packet has the packet count field set to 0 and + the Fragment type is set to 2 and MUST drop it. The next packet, + which is the final fragmented packet, MUST be dropped in the same + manner. Feedback reports on lost and dropped packets MUST be sent + back via RTCP.[note: reordering] + + If a particular multicast session has a large number of participants + care must be taken to prevent an RTCP feedback implosion, [9], in the + event of packet loss from a large number of participants. + + Loss of any of the Configuration fragment will result in the loss of + the full Configuration packet as detailed in the Loss of + + + +Barbato Expires January 22, 2007 [Page 17] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Configuration Headers (Section 3.3) section. + + +6. IANA Considerations + + MIME media type name: video + + MIME subtype: theora + + Required Parameters: + + sampling: Determines the chroma subsampling format. + + width: Determines the number of pixels per line. This is an + integer between 1 and 1048561 and MUST be in multiples of 16. + + height: Determines the number of lines per frame encoded. This is + an integer between 1 and 1048561 and MUST be in multiples of + 16. + + delivery-method: indicates the delivery methods in use, the + possible values are: inline, in_band, out_band/specific_name + Where "specific_name" is the name of the out of band delivery + method. + + configuration: the base16 [11] (hexadecimal) representation of the + Packed Headers (Section 3.2.1). + + Optional Parameters: + + configuration-uri: the URI of the configuration headers in case of + out of band transmission. In the form of + "protocol://path/to/resource/". Depending on the specific + method the single ident packets could be retrived by their + number or aggregated in a single stream, aggregates MAY be + compressed using gzip [12] or bzip2 [14] and an sha1 [13] + checksum MAY be provided in the form of + "protocol://path/to/resource/aggregated.bz2!sha1hash" + + Encoding considerations: + + This media type is framed and contains binary data. + + Security Considerations: + + See Section 6 of RFC XXXX. + + + + + +Barbato Expires January 22, 2007 [Page 18] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Interoperability considerations: + + None + + Published specification: + + RFC XXXX [RFC Editor: please replace by the RFC number of this + memo, when published] + + Ogg Theora I specification: Codec setup and packet decode. + Available from the Xiph website, http://www.xiph.org + + Applications which use this media type: + + Audio streaming and conferencing tools + + Additional information: + + None + + Person & email address to contact for further information: + + Luca Barbato: + IETF Audio/Video Transport Working Group + + Intended usage: + + COMMON + + Restriction on usage: + + This media type depends on RTP framing, and hence is only defined + for transfer via RTP [3] + + Author: + + Luca Barbato + + Change controller: + + IETF AVT Working Group + + +6.1. Mapping MIME Parameters into SDP + + The information carried in the MIME media type specification has a + specific mapping to fields in the Session Description Protocol (SDP) + [6], which is commonly used to describe RTP sessions. When SDP is + + + +Barbato Expires January 22, 2007 [Page 19] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + used to specify sessions the mapping are as follows: + + o The MIME type ("video") goes in SDP "m=" as the media name. + + o The MIME subtype ("theora") goes in SDP "a=rtpmap" as the encoding + name. + + o The clock rate in the "a=rtpmap" line MUST be 90000 + + o The mandated parameters "delivery-method" and "configuration" MUST + be included in the SDP "a=fmpt" attribute. + + o The optional parameter "configuration-uri", when present, MUST be + included in the SDP "a=fmpt" attribute and MUST follow the + delivery-method that applies. + + If the stream uses multiple decoder setup configurations and all of + them are known in advance, the Configuration Packet for each file + SHOULD be packaged together and passed to the client using the + configuration attribute. + + The URI specified in the configuration-uri attribute MUST point to a + location where all of the Configuration Packets needed for the life + of the session reside. + +6.1.1. SDP Example + + The following example shows a basic SDP for a single stream. The + first configuration packet is inlined in the sdp, other + configurations could be fetched at any time from the first provided + uri using or all the known configuration could be downloaded using + the second uri. The inline base16 [11] configuration string is + omitted because of the lenght. + c=IN IP4 192.0.0.1 + m=video RTP/AVP 98 + a=rtpmap:98 theora/90000 + a=fmtp:98 sampling=YCbCr-4:2:2; width=1280; height=720; delivery- + method=inline; configuration=base16string1; delivery- + method=out_band/rtsp; delivery-method=out_band/rtsp; + configuration-uri=rtsp://path/to/resource/; delivery- + method=out_band/http; configuration-uri=http://another/path/to/ + resource/aggregate.bz2!sha1hash; + +6.2. Usage with the SDP Offer/Answer Model + + The offer, as described in An Offer/Answer Model Session Description + Protocol [5], may contain a large number of delivery methods per + single fmtp attribute, the answerer MUST remove every delivery-method + + + +Barbato Expires January 22, 2007 [Page 20] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + and configuration-uri not supported. All the parameters MUST not be + altered on answer otherwise. + + +7. Examples + + The following examples are common usage patterns that MAY be applied + in such situations, the main scope of this section is to explain + better usage of the transmission vectors. + +7.1. Stream Video + + This is one of the most common situation: one single server streaming + content in multicast, the clients may start a session at random time. + The content itself could be a mix of live stream, as the wj's voice + or studio scenes, and stored streams, as the music she plays. + + In this situation we don't know in advance how many codebooks we will + use. The clients can join anytime and users expect to start the + fruition of the content in a short time. + + On join the client will receive the current Configuration necessary + to decode the current streams inlined in the SDP so that the decoding + will start immediately after. + + When the streamed content changes the new Configuration is sent in- + band before the actual stream, and the Configuration that has to be + sent inline in the SDP updated. Since the inline method is + unreliable, an out of band fallback is provided. + + The client could choose to fetch the Configuration from the alternate + source as soon it discovers a Configuration packet got lost inline or + use selective retransmission [17], if the server supports the + feature. + + A serverside optimization would be to keep an hash list of the + Configurations per session to avoid packing all of them and send the + same Configuration with different Ident tags + + A clientside optimization would be to keep a tag list of the + Configurations per session and don't process configuration packets + already known. + + +8. Security Considerations + + RTP packets using this payload format are subject to the security + considerations discussed in the RTP specification [3]. This implies + + + +Barbato Expires January 22, 2007 [Page 21] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + that the confidentiality of the media stream is achieved by using + encryption. Because the data compression used with this payload + format is applied end-to-end, encryption may be performed on the + compressed data. Where the size of a data block is set care MUST be + taken to prevent buffer overflows in the client applications. + + +9. Acknowledgments + + This document is a continuation of draft-kerr-avt-theora-rtp-00.txt + + Thanks to the AVT, Ogg Theora Communities / Xiph.org, Fluendo, Ralph + Giles, Mike Smith, Phil Kerr, Timothy Terriberry, Stefan Ehmann, + Alessandro Salvatori, Politecnico di Torino (LS)^3/IMG Group in + particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, + Juan Carlos De Martin. + + +10. References + +10.1. Normative References + + [1] Pfeiffer, S., "The Ogg Encapsulation Format Version 0", + RFC 3533. + + [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", RFC 2119. + + [3] Schulzrinne, H., Casner, S., Frederick, R., and V. Jacobson, + "RTP: A Transport Protocol for real-time applications", + RFC 3550. + + [4] Schulzrinne, H. and S. Casner, "RTP Profile for video and Video + Conferences with Minimal Control.", RFC 3551. + + [5] Rosenberg, J. and H. Schulzrinne, "An Offer/Answer Model with + Session Description Protocol (SDP)", RFC 3264. + + [6] Handley, M. and V. Jacobson, "SDP: Session Description + Protocol", RFC 2327. + + [7] Mogul et al., J., "Path MTU Discovery", RFC 1063. + + [8] McCann et al., J., "Path MTU Discovery for IP version 6", + RFC 1981. + + [9] Ott, J., Wenger, S., Sato, N., Burmeister, C., and J. Rey, + "Extended RTP Profile for RTCP-based Feedback (RTP/AVPF)", + + + +Barbato Expires January 22, 2007 [Page 22] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + + Internet Draft (draft-ietf-avt-rtcp-feedback-11: Work in + progress). + + [10] Barbato, L., "RTP Payload Format for Vorbis Encoded Audio - + draft-ietf-avt-vorbis-rtp-00", Internet Draft (Work in + progress). + + [11] Josefsson, S., "The Base16, Base32, and Base64 Data Encodings", + RFC 3548. + + [12] Deutsch, P., "GZIP file format specification version 4.3", + RFC 1952. + + [13] National Institute of Standards and Technology, "Secure Hash + Standard", May 1993. + + [14] Seward, J., "libbz2 and bzip2". + +10.2. Informative References + + [15] "libTheora: Available from the Xiph website, + http://www.xiph.org". + + [16] "Theora I specification: Codec setup and packet decode. + http://www.xiph.org/theora/doc/Theora_I_spec.pdf". + + [17] Friedman, T., Caceres, R., and A. Clark, "RTP Control Protocol + Extended Reports (RTCP XR)", RFC 3611, November 2003. + + [18] "ITU-T Recommendation V.42, 1994, Rev. 1. Error-correcting + Procedures for DCEs Using Asynchronous-to-Synchronous + Conversion. International Telecommunications Union. Available + from the ITU website, http://www.itu.int". + + [19] "ISO 3309, October 1984, 3rd Edition. Information Processing + Systems--Data Communication High-Level Data Link Control + Procedure--Frame Structure. International Organization for + Standardization.". + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 23] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +Author's Address + + Luca Barbato + Xiph.Org + + Email: lu_zero@gentoo.org + URI: http://www.xiph.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Barbato Expires January 22, 2007 [Page 24] + +Internet-Draft draft-ietf-avt-rtp-theora-00 July 2006 + + +Intellectual Property Statement + + The IETF takes no position regarding the validity or scope of any + Intellectual Property Rights or other rights that might be claimed to + pertain to the implementation or use of the technology described in + this document or the extent to which any license under such rights + might or might not be available; nor does it represent that it has + made any independent effort to identify any such rights. Information + on the procedures with respect to rights in RFC documents can be + found in BCP 78 and BCP 79. + + Copies of IPR disclosures made to the IETF Secretariat and any + assurances of licenses to be made available, or the result of an + attempt made to obtain a general license or permission for the use of + such proprietary rights by implementers or users of this + specification can be obtained from the IETF on-line IPR repository at + http://www.ietf.org/ipr. + + The IETF invites any interested party to bring to its attention any + copyrights, patents or patent applications, or other proprietary + rights that may cover technology that may be required to implement + this standard. Please address the information to the IETF at + ietf-ipr@ietf.org. + + +Disclaimer of Validity + + This document and the information contained herein are provided on an + "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS + OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET + ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, + INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE + INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED + WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + + +Copyright Statement + + Copyright (C) The Internet Society (2006). This document is subject + to the rights, licenses and restrictions contained in BCP 78, and + except as set forth therein, the authors retain all their rights. + + +Acknowledgment + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + + + +Barbato Expires January 22, 2007 [Page 25] + diff --git a/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.xml b/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.xml new file mode 100644 index 00000000..2f8af399 --- /dev/null +++ b/libs/libtheora-1.1/doc/draft-ietf-avt-rtp-theora-00.xml @@ -0,0 +1,1146 @@ + + + + + + + + +draft-ietf-avt-rtp-theora-00 + + +Xiph.Org +
+lu_zero@gentoo.org +http://www.xiph.org/ +
+ + + +General +AVT Working Group +I-D + +Internet-Draft +Theora +RTP + + + +This document describes a RTP payload format for transporting Theora encoded video. It details the RTP encapsulation mechanism for raw Theora data and configuration headers necessary to configure the decoder. + + + +Also included within the document are the necessary details for the use of Theora with MIME and Session Description Protocol (SDP). + + + + + + +All references to RFC XXXX are to be replaced by references to the RFC number of this memo, when published. + + + + + + + +
+ +Theora is a general purpose, lossy video codec. It is based on the VP3 video codec produced by On2 Technologies and has been donated to the Xiph.org Foundation. + + +Theora I is a block-based lossy transform codec that utilizes an 8 x 8 Type-II Discrete Cosine Transform and block-based motion compensation. This places it in the same class of codecs as MPEG-1, MPEG-2, MPEG-4, and H.263. The details of how individual blocks are organized and how DCT coefficients are stored in the bitstream differ substantially from these codecs, however. Theora supports only intra frames (I frames in MPEG) and inter frames (P frames in MPEG). + + + +Theora provides none of its own framing, synchronization, or protection against transmission errors. Instead, the codec expects to receive a discrete sequence of data packets. Theora is a free-form variable bit rate (VBR) codec, and these packets have no minimum size, maximum size, or fixed/expected size. Theora packets are thus intended to be used with a transport mechanism that provides free-form framing, synchronization, positioning, and error correction in accordance with these design assumptions, such as Ogg or RTP/AVP . + + + +Theora I currently supports progressive video data of arbitrary dimensions at a constant frame rate in one of several Y'CbCr color spaces. +Three different chroma subsampling formats are supported: 4:2:0, 4:2:2, and 4:4:4. The Theora I format does not support interlaced material, variable frame rates, bit-depths larger than 8 bits per component, nor alternate color spaces such as RGB or arbitrary multi-channel spaces. Black and white content can be efficiently encoded, however, because the uniform chroma planes compress well. For performance reason, arbitrary frame sizes will be encoded rounding both dimensions to the upper multiple of 16. The original width and height will be encoded in the header and the decoder will use this information to clip the decoded frame to the right dimensions. + + + +Theora is similar to the Vorbis audio in that the decoder reads the probability model for the entropy coder and all quantization parameters from special "header" packets at the start of the compressed data. It is therefore impossible to decode any video data without having previously fetched the codec info and codec setup headers, although Theora can begin to decode at an arbitrary intra-frame packet so long as the codec has been initialized with the associated headers. + + +
+ + +The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", +and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 . + + +
+
+ +
+ + +For RTP based transportation of Theora encoded video the standard RTP header is followed by a 4 octets payload header, then the payload data. The payload headers are used to associate the Theora data with its associated decoding codebooks as well as indicating if the following packet contains fragmented Theora data and/or the number of whole Theora data frames. The payload data contains the raw Theora bitstream information. + + + +For RTP based transport of Theora encoded video the standard RTP header is followed by a 4 octets payload header, then the payload data. + + +
+ + +The format of the RTP header is specified in and shown in Figure 1. This payload format uses the fields of the header in a manner consistent with that specification. + + +
+ +
+ + +The RTP header begins with an octet of fields (V, P, X, and CC) to support specialized RTP uses (see and for details). For Theora RTP, the following values are used. + + + +Version (V): 2 bits +This field identifies the version of RTP. The version used by this specification is two (2). + + + +Padding (P): 1 bit +Padding MAY be used with this payload format according to section 5.1 of . + + + +Extension (X): 1 bit +The Extension bit is used in accordance with . + + + +CSRC count (CC): 4 bits +The CSRC count is used in accordance with . + + + +Marker (M): 1 bit +The Marker bit is used in accordance with . + + + +Payload Type (PT): 7 bits +An RTP profile for a class of applications is expected to assign a payload type for this format, or a dynamically allocated payload type SHOULD be chosen which designates the payload as Theora. + + + +Sequence number: 16 bits +The sequence number increments by one for each RTP data packet sent, and may be used by the receiver to detect packet loss and to restore packet sequence. This field is detailed further in . + + + +Timestamp: 32 bits +A timestamp representing the presentation time of the first sample of the first Theora packet in the RTP packet. The clock frequency MUST be set to 90kHz. + + + +SSRC/CSRC identifiers: +These two fields, 32 bits each with one SSRC field and a maximum of 16 CSRC fields, are as defined in . + + +
+ +
+ + +The 4 octets following the RTP Header section represent the Payload Header. This header is split into a number of bitfields detailing the format of the following Payload Datagrams. + + +
+ +
+ + +Configuration Ident: 24 bits + +This 24 bit field is used to associate the Theora data to a decoding Packed Configuration. + + + +Fragment type (F): 2 bit + +This field is set according to the following list + + + + 0 = Not Fragmented + 1 = Start Fragment + 2 = Continuation Fragment + 3 = End Fragment + + +This field must be zero if the number of packets field is non-zero. + + +Theora Data Type (TDT): 2 bits + +This field sets the packet payload type for the Theora data. There are currently three Theora payload types currently used and one reserved for future use. + + + + + 0 = Raw Theora payload + 1 = Theora Packed Configuration payload + 2 = Legacy Theora Comment payload + 3 = Reserved + + + The packets with a TDT of value 3 MUST be ignored + + +The last 4 bits represent the number of complete packets in this payload. This provides a maximum number of 15 Theora packets in the payload. If the packet contains fragmented data the number of packets MUST be set to 0. + + +
+ +
+ + +Each Theora payload section starts with a two octets length header that is used to represent the size of the following data payload, followed by the raw Theora packet data. + + +
+ +
+ + +The Theora codec uses relatively unstructured raw packets containing binary integer fields of arbitrary width that often do not fall on an octet boundary. When a Theora encoder produces packets, unused space in the last byte of a packet is always zeroed during the encoding process. Thus, should this unused space be read, it will return binary zeros. + + + +For payloads which consist of multiple Theora packets the payload data consists of the payload length field followed by the first Theora packet's data, then the payload length followed by the second Theora packet, and so on for each of the Theora packets in the payload. + + +
+ +
+ + +Here is an example RTP packet containing two Theora packets. + + +RTP Packet Header: + + +
+ +
+ + + +Payload Data: + + +
+ +
+ + +The payload portion of the packet begins with the 24 bit Configuration ident field followed by 8 bits describing the payload. The Fragment type field is set to 0, indicating that this packet contains whole Theora frame data. The Data type field is set to 0 (theora raw data). The number of whole Theora data packets is set to 2. + + + +Each of the payload blocks starts with the two octets length field followed +by the variable length Theora packet data. + + +
+
+ +
+ + +To decode a Theora stream three configuration header packets are needed. The first (Identification Header) indicates frame dimensions, quality, blocks used and Theora encoder version. The second (Comment Header) contains stream metadata and the third (Setup Header) contains details of the dequantization and Huffman tables. + + + +Since this information must be transmitted reliably, and as the RTP stream may change certain configuration data mid-session, there are different methods for delivering this configuration data to a client, both in-band and out-of-band, which are detailed below. SDP delivery is used to set up an initial state for the client application. The changes may be due to different dequantization and Huffman tables as well as different bitrates of the stream. + + + +The delivery vectors in use are specified by an SDP attribute that indicates the method and the optional URI where the Theora Packed Configuration Packets could be fetched. Different delivery methods MAY be advertised for the same session. The in-band codebook delivery SHOULD be considered as baseline, out-of-band delivery methods that don't use RTP will not be described in this document. For non chained streams, the RECOMMENDED Configuration delivery method is inline the Packed Configuration in the SDP as explained in the IANA considerations + + + +The 24 bit Ident field is used to map which Configuration will be used to decode a packet. When the Ident field changes, it indicates that a change in the stream has taken place. The client application MUST have in advance the correct configuration and if the client detects a change in the Ident value and does not have this information it MUST NOT decode the raw data associated until it has fetched the correct Configuration. + + + +
+ + +The Packed Configuration Payload is sent in-band with the packet type bits set to match the payload type. Clients MUST be capable of dealing with periodic re-transmission of the configuration headers. + + +
+ + +A Theora Packed Configuration is identified by a payload type field of 1. Of the three headers, defined in the Theora I specification, the identification and the setup will be packed together, while the comment header will be completely suppressed. It is up to the client to provide a minimal size comment header to the decoder if required by the implementation. + + +
+ +
+The Ident field is set with the value that will be used by the Raw Payload Packets to address this Configuration. The Fragment type is set to 0 since the packet bears full Packed configuration, the number of packet is set to 1. In practice, Packed Headers usually need to be fragmented to fit the path MTU. + + +
+ +
+ +
+ + +This section, as stated above, does not cover all the possible out-of-band delivery methods since they rely on different protocols and are linked to specific applications. The following packet definition SHOULD be used in out-of-band delivery and MUST be used when Configuration is inlined in the SDP. + + +
+ + +As mentioned above, the recommended delivery vector for Theora configuration data is via a retrieval method that can be performed using a reliable transport protocol. As the RTP headers are not required for this method of delivery the structure of the configuration data is slightly different. The packed header starts with a 32 bit count field which details the number of packed headers that are contained in the bundle. Next is the Packed header payload for each setup id. + + +
+ +
+ + +Since the Configuration Ident and the Identification Header are fixed length there is only a 16bit Length tag to define the length of the packed headers. + + +
+
+ +The key difference from the in-band format is that there is no need for the payload header octet. + + +
+ + +The following IANA considerations MUST only be applied to the packed headers. + + + + + + video + + + + theora-config + + + + + +None + + + + + + +None + + + + + + +This media type contains binary data. + + + + + + +See Section 6 of RFC XXXX. + + + + + + +None + + + + + + +RFC XXXX [RFC Editor: please replace by the RFC number of this memo, + when published] + + + + + + +Theora encoded video, configuration data. + + + + + + +None + + + + + + +Luca Barbato: <lu_zero@gentoo.org> + +IETF Audio/Video Transport Working Group + + + + + +COMMON + + + + + + +This media type does not depend on the transport. + + + + + + +Luca Barbato + + + + + +IETF AVT Working Group + + +
+
+ +
+ +
+ + +Unlike the loss of raw Theora payload data, the loss of a configuration header can lead to a situation where it will not be possible to successfully decode the stream. + + + +A loss of a Configuration Packet causes the stream decoder to halt and SHOULD be reported to the client as well as a loss report sent via RTCP. + + +
+ +
+ +
+ + +When the payload type is set to 2, the packet contains comment metadata such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic title information. Clients MAY choose to completely ignore them. The details on the comments format can be found in the Theora documentation. + + +
+ +
+ +The 2 byte length field is necessary since this Theora packet could be fragmented. + +
+ +
+ + +Each RTP packet contains either one complete Theora packet, one Theora packet fragment, or an integer number of complete Theora packets (up to a maximum of 15 packets, since the number of packets is defined by a 4 bit value). + + + +Any Theora data packet that is less than path MTU SHOULD be bundled in the RTP packet with as many Theora packets as will fit, up to a maximum of 15. Path MTU is detailed in and . + + + +A fragmented packet has a zero in the last four bits of the payload header. The RTP packet containing the first fragment will set the Fragment type to 1. Each RTP packet after the first will set the Fragment type to 2 in the payload header. The RTP packet containing the last fragment of the Theora packet will have the Fragment type set to 3. If the fragmented Theora packet spans only two RTP packets, the first will set the Fragment type field to 1 and the second will set it to 2. To maintain the correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first packet sent, with the sequence number incremented as normal for the subsequent RTP packets. + +
+ + +Here is an example fragmented Theora packet split over three RTP packets. Each packet contains the standard RTP headers as well as the 4 octets Theora headers. + + +
+ +
+ + +In this packet the initial sequence number is 1000 and the timestamp is xxxxx. The Fragment type field is set to one, indicating it is the start packet of a serie of fragments. The number of packets field is set to 0, and as the payload is raw Theora data the Theora payload type field is set to 0. + + +
+ +
+ + +The Fragment type field is set to 2 and the number of packets field is set to 0. For large Theora fragments there can be several of these type of payload packets. The maximum RTP packet size SHOULD be no greater than the path MTU, including all RTP and payload headers. The sequence number has been incremented by one but the timestamp field remains the same as the initial packet. + + +
+ +
+ + +This is the last Theora fragment packet. The Fragment type filed is set to 3 and the packet count remains set to 0. As in the previous packets the timestamp remains set to the first packet in the sequence and the sequence number has been incremented. + + +
+ +
+ + +As there is no error correction within the Theora stream, packet loss will result in a loss of signal. Packet loss is more of an issue for fragmented Theora packets as the client will have to cope with the handling of the Fragment type field. If we use the fragmented Theora packet example above and the first packet is lost the client MUST detect that the next packet has the packet count field set to 0 and the Fragment type is set to 2 and MUST drop it. The next packet, which is the final fragmented packet, MUST be dropped in the same manner. Feedback reports on lost and dropped packets MUST be sent back via RTCP.[note: reordering] + + + +If a particular multicast session has a large number of participants care must be taken to prevent an RTCP feedback implosion, , in the event of packet loss from a large number of participants. + + + +Loss of any of the Configuration fragment will result in the loss of the full Configuration packet as detailed in the Loss of Configuration Headers section. + + +
+
+ +
+ + + + + video + + + + theora + + + + + + + + + + Determines the chroma subsampling format. + + + + + Determines the number of pixels per line. This is an integer between 1 and 1048561 and MUST be in multiples of 16. + + + + +Determines the number of lines per frame encoded. This is an integer between 1 and 1048561 and MUST be in multiples of 16. + + + + + indicates the delivery methods in use, the possible values are: inline, in_band, out_band/specific_name +Where "specific_name" is the name of the out of band delivery method. + + + + + the base16 (hexadecimal) representation of the Packed Headers. + + + + + + + + + + + + the URI of the configuration headers in case of out of band transmission. In the form of "protocol://path/to/resource/". Depending on the specific method the single ident packets could be retrived by their number or aggregated in a single stream, aggregates MAY be compressed using gzip or bzip2 and an sha1 checksum MAY be provided in the form of "protocol://path/to/resource/aggregated.bz2!sha1hash" + + + + + + + +This media type is framed and contains binary data. + + + + + + +See Section 6 of RFC XXXX. + + + + + +None + + + + + + + + RFC XXXX [RFC Editor: please replace by the RFC number of this memo, when published] + +Ogg Theora I specification: Codec setup and packet decode. Available from the Xiph website, http://www.xiph.org + + + + + + + +Video streaming and conferencing tools + + + + + +None + + + + + + + +Luca Barbato: <lu_zero@gentoo.org> +IETF Audio/Video Transport Working Group + + + + + + + +COMMON + + + + + +This media type depends on RTP framing, and hence is only defined for transfer via RTP + + + + +Luca Barbato + + + + IETF AVT Working Group + + + + + +
+ + +The information carried in the MIME media type specification has a specific mapping to fields in the Session Description Protocol (SDP) , which is commonly used to describe RTP sessions. When SDP is used to specify sessions the mapping are as follows: + + + + + +The MIME type ("video") goes in SDP "m=" as the media name. + + +The MIME subtype ("theora") goes in SDP "a=rtpmap" as the encoding name. + + +The clock rate in the "a=rtpmap" line MUST be 90000 + + +The mandated parameters "delivery-method" and "configuration" MUST be included in the SDP "a=fmpt" attribute. + + +The optional parameter "configuration-uri", when present, MUST be included in the SDP "a=fmpt" attribute and MUST follow the delivery-method that applies. + + + + +If the stream uses multiple decoder setup configurations and all of them are known in advance, the Configuration Packet for each file SHOULD be packaged together and passed to the client using the configuration attribute. + + + +The URI specified in the configuration-uri attribute MUST point to a location where all of the Configuration Packets needed for the life of the session reside. + + +
+The following example shows a basic SDP for a single stream. The first configuration packet is inlined in the sdp, other configurations could be fetched at any time from the first provided uri using or all the known configuration could be downloaded using the second uri. The inline base16 configuration string is omitted because of the lenght. + + +c=IN IP4 192.0.0.1 +m=video RTP/AVP 98 +a=rtpmap:98 theora/90000 +a=fmtp:98 sampling=YCbCr-4:2:2; width=1280; height=720; delivery-method=inline; configuration=base16string1; delivery-method=out_band/rtsp; delivery-method=out_band/rtsp; configuration-uri=rtsp://path/to/resource/; delivery-method=out_band/http; configuration-uri=http://another/path/to/resource/aggregate.bz2!sha1hash; + +
+ +
+ +
+ + +The offer, as described in An Offer/Answer Model Session Description Protocol, may contain a large number of delivery methods per single fmtp attribute, the answerer MUST remove every delivery-method and configuration-uri not supported. All the parameters MUST not be altered on answer otherwise. + + +
+ +
+ +
+ + +The following examples are common usage patterns that MAY be applied in such situations, the main scope of this section is to explain better usage of the transmission vectors. + + +
+ +This is one of the most common situation: one single server streaming content in multicast, the clients may start a session at random time. The content itself could be a mix of live stream, as the wj's voice or studio scenes, and stored streams, as the music she plays. + +In this situation we don't know in advance how many codebooks we will use. The clients can join anytime and users expect to start the fruition of the content in a short time. + +On join the client will receive the current Configuration necessary to decode the current streams inlined in the SDP so that the decoding will start immediately after. + +When the streamed content changes the new Configuration is sent in-band before the actual stream, and the Configuration that has to be sent inline in the SDP updated. Since the inline method is unreliable, an out of band fallback is provided. + +The client could choose to fetch the Configuration from the alternate source as soon it discovers a Configuration packet got lost inline or use selective retransmission, if the server supports the feature. + +A serverside optimization would be to keep an hash list of the Configurations per session to avoid packing all of them and send the same Configuration with different Ident tags + +A clientside optimization would be to keep a tag list of the Configurations per session and don't process configuration packets already known. + +
+ +
+ +
+ +RTP packets using this payload format are subject to the security considerations discussed in the RTP specification . This implies that the confidentiality of the media stream is achieved by using encryption. Because the data compression used with this payload format is applied end-to-end, encryption may be performed on the compressed data. Where the size of a data block is set care MUST be taken to prevent buffer overflows in the client applications. + + +
+ +
+ +This document is a continuation of draft-kerr-avt-theora-rtp-00.txt + + +Thanks to the AVT, Ogg Theora Communities / Xiph.org, Fluendo, Ralph Giles, Mike Smith, Phil Kerr, Timothy Terriberry, Stefan Ehmann, Alessandro Salvatori, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin. + + +
+ + + + + + + + + +The Ogg Encapsulation Format Version 0 + + + + + + + +Key words for use in RFCs to Indicate Requirement Levels + + + + + + + +RTP: A Transport Protocol for real-time applications + + + + + + + + + + +RTP Profile for video and Video Conferences with Minimal Control. + + + + + + + + + +An Offer/Answer Model with Session Description Protocol (SDP) + + + + + + + + +SDP: Session Description Protocol + + + + + + + + +Path MTU Discovery + + + + + + + +Path MTU Discovery for IP version 6 + + + + + + + +Extended RTP Profile for RTCP-based Feedback (RTP/AVPF) + + + + + + + + + + + +RTP Payload Format for Vorbis Encoded Audio - draft-ietf-avt-vorbis-rtp-00 + + + + + + + +The Base16, Base32, and Base64 Data Encodings + + + + + + + +GZIP file format specification version 4.3 + + + + + + + +Secure Hash Standard + +National Institute of Standards and Technology + + + + + + + +libbz2 and bzip2 + + + + + + + + + +libTheora: Available from the Xiph website, http://www.xiph.org + + + + + +Theora I specification: Codec setup and packet decode. http://www.xiph.org/theora/doc/Theora_I_spec.pdf + + + + + + +RTP Control Protocol Extended Reports (RTCP XR) + + + + + + + + + + + + + + +ITU-T Recommendation V.42, 1994, Rev. 1. Error-correcting Procedures for DCEs Using Asynchronous-to-Synchronous Conversion. International Telecommunications Union. Available from the ITU website, http://www.itu.int + + + + + + +ISO 3309, October 1984, 3rd Edition. Information Processing Systems--Data Communication High-Level Data Link Control Procedure--Frame Structure. International Organization for Standardization. + + + + + + diff --git a/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.txt b/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.txt new file mode 100644 index 00000000..51261521 --- /dev/null +++ b/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.txt @@ -0,0 +1,1512 @@ + + +AVT Working Group P. Kerr +Internet-Draft Xiph.Org +Expires: August 1, 2005 January 31, 2005 + + + draft-kerr-avt-theora-rtp-00 + RTP Payload Format for Theora Encoded Video + +Status of this Memo + + This document is an Internet-Draft and is subject to all provisions + of section 3 of RFC 3667. By submitting this Internet-Draft, each + author represents that any applicable patent or other IPR claims of + which he or she is aware have been or will be disclosed, and any of + which he or she become aware will be disclosed, in accordance with + RFC 3668. + + Internet-Drafts are working documents of the Internet Engineering + Task Force (IETF), its areas, and its working groups. Note that + other groups may also distribute working documents as + Internet-Drafts. + + Internet-Drafts are draft documents valid for a maximum of six months + and may be updated, replaced, or obsoleted by other documents at any + time. It is inappropriate to use Internet-Drafts as reference + material or to cite them other than as "work in progress." + + The list of current Internet-Drafts can be accessed at + http://www.ietf.org/ietf/1id-abstracts.txt. + + The list of Internet-Draft Shadow Directories can be accessed at + http://www.ietf.org/shadow.html. + + This Internet-Draft will expire on August 1, 2005. + +Copyright Notice + + Copyright (C) The Internet Society (2005). + +Abstract + + This document describes a RTP payload format for transporting Theora + encoded video. It details the RTP encapsulation mechanism for raw + Theora data and configuration headers consisting of the quantization + matrices and the Huffman codebooks for the DCT coefficients, and a + table of limit values for the deblocking filter. + + Also included within the document are the necessary details for the + use of Theora with MIME and Session Description Protocol (SDP). + + + +Kerr Expires August 1, 2005 [Page 1] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +Editors Note + + All references to RFC XXXX are to be replaced by references to the + RFC number of this memo, when published. + +Table of Contents + + 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 + 1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . 3 + 2. Payload Format . . . . . . . . . . . . . . . . . . . . . . . . 4 + 2.1 RTP Header . . . . . . . . . . . . . . . . . . . . . . . . 4 + 2.2 Payload Header . . . . . . . . . . . . . . . . . . . . . . 5 + 2.3 Payload Data . . . . . . . . . . . . . . . . . . . . . . . 6 + 2.4 Example RTP Packet . . . . . . . . . . . . . . . . . . . . 7 + 3. Frame Packetizing . . . . . . . . . . . . . . . . . . . . . . 8 + 3.1 Example Fragmented Theora Packet . . . . . . . . . . . . . 9 + 4. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . . . 12 + 5. Configuration Headers . . . . . . . . . . . . . . . . . . . . 13 + 5.1 In-band Header Transmission . . . . . . . . . . . . . . . 13 + 5.1.1 Identification Header . . . . . . . . . . . . . . . . 13 + 5.1.2 Comment Header . . . . . . . . . . . . . . . . . . . . 15 + 5.1.3 Setup Header . . . . . . . . . . . . . . . . . . . . . 16 + 5.2 Packed Headers Delivery . . . . . . . . . . . . . . . . . 18 + 5.2.1 Packed Headers IANA Considerations . . . . . . . . . . 21 + 5.3 Setup Header Caching . . . . . . . . . . . . . . . . . . . 22 + 5.4 Loss of Configuration Headers . . . . . . . . . . . . . . 22 + 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 23 + 6.1 Mapping MIME Parameters into SDP . . . . . . . . . . . . . 24 + 7. Security Considerations . . . . . . . . . . . . . . . . . . . 25 + 8. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 25 + 9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 25 + 9.1 Normative References . . . . . . . . . . . . . . . . . . . . 25 + 9.2 Informative References . . . . . . . . . . . . . . . . . . . 26 + Author's Address . . . . . . . . . . . . . . . . . . . . . . . 26 + Intellectual Property and Copyright Statements . . . . . . . . 27 + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 2] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +1. Introduction + + Theora is a general purpose, lossy video codec. It is based on the + VP3.1 video codec produced by On2 Technologies and has been donated + to the Xiph.org Foundation. + + Theora I is a block-based lossy transform codec that utilizes an 8 x + 8 Type-II Discrete Cosine Transform and block-based motion + compensation. This places it in the same class of codecs as MPEG-1, + MPEG-2, MPEG-4, and H.263. The details of how individual blocks are + organized and how DCT coefficients are stored in the bitstream differ + substantially from these codecs, however. Theora supports only intra + frames (I frames in MPEG) and inter frames (P frames in MPEG). + + Theora provides none of its own framing, synchronization, or + protection against transmission errors. Theora is a free-form + variable bit rate (VBR) codec, and packets have no minimum size, + maximum size, or fixed/expected size. Theora packets are thus + intended to be used with a transport mechanism that provides + free-form framing, synchronization, positioning, and error correction + in accordance with these design assumptions, such as Ogg [1]. or + RTP/AVP [3]. + + Theora I currently supports progressive video data of arbitrary + dimensions at a constant frame rate in one of several YCbCr color + spaces. Three different chroma subsampling formats are supported: + 4:2:0, 4:2:2, and 4:4:4. The Theora I format does not support + interlaced material, variable frame rates, bit-depths larger than 8 + bits per component, nor alternate color spaces such as RGB or + arbitrary multi-channel spaces. Black and white content can be + efficiently encoded, however, because the uniform chroma planes + compress well. + + Theora is similar to Vorbis audio [9] in that it requires the + inclusion of the entire probability model for the DCT coefficients + and all the quantization parameters in the bitstream headers to be + sent ahead of the video data. It is therefore impossible to decode + any frame in the stream without having previously fetched the codec + info and codec setup headers, although Theora can initiate decode at + an arbitrary intra-frame packet within a bitstream so long as the + codec has been initialized with the setup headers. + +1.1 Terminology + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [2]. + + + + +Kerr Expires August 1, 2005 [Page 3] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +2. Payload Format + + Each frame of digital video is packetized into one or more RTP + packets. If the data for a complete frame exceeds the network MTU, + it SHOULD be fragmented into multiple RTP packets, each smaller than + the MTU. A single RTP packet MAY contain data for more than one + Theora frame. + + For RTP based transportation of Theora encoded video the standard RTP + header is followed by a 5 octet payload header, then the payload + data. + +2.1 RTP Header + + The format of the RTP header is specified in [3] and shown in Figure + 1. This payload format uses the fields of the header in a manner + consistent with that specification. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | sequence number | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | timestamp | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 1: RTP Header + + The RTP header begins with an octet of fields (V, P, X, and CC) to + support specialized RTP uses (see [3] and [4] for details). For + Theora RTP, the following values are used. + + Version (V): 2 bits + + This field identifies the version of RTP. The version used by this + specification is two (2). + + Padding (P): 1 bit + + Padding MAY be used with this payload format according to section 5.1 + of [3]. + + Extension (X): 1 bit + + + +Kerr Expires August 1, 2005 [Page 4] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + The Extension bit is used in accordance with [3]. + + CSRC count (CC): 4 bits + + The CSRC count is used in accordance with [3]. + + Marker (M): 1 bit + + The Marker bit is used in accordance with [3]. + + Payload Type (PT): 7 bits + + An RTP profile for a class of applications is expected to assign a + payload type for this format, or a dynamically allocated payload type + SHOULD be chosen which designates the payload as Theora. + + Sequence number: 16 bits + + The sequence number increments by one for each RTP data packet sent, + and may be used by the receiver to detect packet loss and to restore + packet sequence. This field is detailed further in [3]. + + Timestamp: 32 bits + + A timestamp representing the sampling time of the first sample of the + first Theora packet in the RTP packet. The clock frequency MUST be + set to the sample rate of the encoded video data and is conveyed + out-of-band as an SDP attribute. + + SSRC/CSRC identifiers: + + These two fields, 32 bits each with one SSRC field and a maximum of + 16 CSRC fields, are as defined in [3]. + +2.2 Payload Header + + After the RTP Header section the following five octets are the + Payload Header. This header is split into a number of bitfields + detailing the format of the following Payload Data packets. + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 5] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |C|F|0|0|# pkts.| + +-+-+-+-+-+-+-+-+ + + Figure 2: Payload Header + + Setup Header Ident: 32 bits + + This 32 bit field is used to associate the Theora data to a decoding + Setup Header. It is created by making a CRC32 checksum of the Setup + Header required to decode the particular Theora video stream. + + Continuation (C): 1 bit + + Set to one if this is a continuation of a fragmented packet. + + Fragmented (F): 1 bit + + Set to one if the payload contains complete packets or if it contains + the last fragment of a fragmented packet. + + The next two bits are currently reserved and MUST be set to 0. + + The last 4 bits are the number of complete packets in this payload. + This provides for a maximum number of 15 Theora packets in the + payload. If the packet contains fragmented data the number of + packets MUST be set to 0. + +2.3 Payload Data + + Each Theora payload section starts with a three octet header. The + first octet is used to denote what kind of Theora data follows. Then + a two octet length header is used to represent the size of the + following data payload, followed by the raw Theora data. + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 6] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Data type | Payload Length | Theora Data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 3: Payload Data + + The data type octet is used to signify the payload data type. If the + first bit is set to 0, this indicates the payload is Theora video + data. + + The following values for the Theora payload type are valid: + + 0 = Raw Theora data + 0x80 = Theora Identification header + 0x81 = Theora Comment header + 0x82 = Theora Setup header + + + The Theora packet length header is the length of the Theora data + block only and does not count the length octets and payload data type + octet. + + The Theora codec uses relatively unstructured raw packets containing + binary integer fields of arbitrary width that often do not fall on an + octet boundary. When this happens the bitstream is packed to an + octet boundary. When a Theora encoder produces packets unused space + in the last byte of a packet is always zeroed during the encoding + process. Thus, should this unused space be read, it will return + binary zeros. + + For payloads which consist of multiple Theora packets the payload + data consists of the data type field, the payload length field + followed by the payload data for each of the Theora packets in the + payload. + +2.4 Example RTP Packet + + Here is an example RTP packet containing two Theora packets. + + RTP Packet Header: + + + + + + + + + +Kerr Expires August 1, 2005 [Page 7] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | 2 |0|0| 0 |0| PT | sequence number | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | timestamp (in sample rate units) | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronisation source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 4: Example RTP Packet + + Payload Data: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |0|1|0|0| 2 pks | 0x80 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. data | 0 | Payload Length .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Theora data | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 5: Example Theora Payload Packet + + The payload portion of the packet starts with the 32 bit Setup Header + ident field followed by the 8 bit fragment/count fields. The F bit + is set to 1, indicating that this packet contains whole Theora frame + data. The number of whole Theora data packets is set to 2. + + Each of the payload blocks starts with a Data type field, for the + first payload this is set to 0x80 indicating it is an Identification + header and the second payload is set to 0 indicating it is raw Theora + data. Then the two octet length field is followed by the variable + length Theora data. + +3. Frame Packetizing + + Each RTP packet contains either one complete Theora packet, one + Theora packet fragment, or an integer number of complete Theora + + + +Kerr Expires August 1, 2005 [Page 8] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + packets (up to a max of 15 packets, since the number of packets is + defined by a 4 bit value). + + Any Theora data packet that is less than path MTU SHOULD be bundled + in the RTP packet with as many Theora packets as will fit, up to a + maximum of 15. Path MTU is detailed in [6] and [7]. + + If a Theora packet is larger than 65535 octets it MUST be fragmented. + A fragmented packet has a zero in the last four bits of the payload + header. Each fragment after the first will also set the Continued + (C) bit to one in the payload header. The RTP packet containing the + last fragment of the Theora packet will have the Fragmented (F) bit + set to one. To maintain the correct sequence for fragmented packet + reception the timestamp field of fragmented packets MUST be the same + as the first packet sent, with the sequence number incremented as + normal for the subsequent RTP packets. + +3.1 Example Fragmented Theora Packet + + Here is an example fragmented Theora packet split over three RTP + packets. Each packet contains the standard RTP headers as well as + the 5 octet Theora headers. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 9] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + Packet 1: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1000 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |0|0|0|0| 0| 0 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 6: Example Fragmented Packet (Packet 1) + + In this packet the initial sequence number is 1000 and the timestamp + is xxxxx. The Continuation (C) bit is set to one, indicating it is + not the continuation of a fragmented bit, and the Fragmentation (F) + is set to 0 indicating it is a fragmented packet. The number of + packets field is set to 0, and as the payload is raw Theora data the + Theora payload type field is set to 0. + + + + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 10] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + Packet 2: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1001 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |1|0|0|0| 0| 0 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 7: Example Fragmented Packet (Packet 2) + + The C bit is set to 1 and the number of packets field is set to 0. + For large Theora fragments there can be several of these type of + payload packets. The maximum packet size SHOULD be no greater than + the path MTU, including all RTP and payload headers. The sequence + number has been incremented by one but the timestamp field remains + the same as the initial packet. + + + + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 11] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + Packet 3: + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | 1002 | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |1|1|0|0| 0| 0 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Theora data .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 8: Example Fragmented Packet (Packet 3) + + This is the last Theora fragment packet. The C and F bits are set + and the packet count remains set to 0. As in the previous packets + the timestamp remains set to the first packet in the sequence and the + sequence number has been incremented. + +4. Packet Loss + + As there is no error correction within the Theora stream, packet loss + will result in a loss of signal. Packet loss is more of an issue for + fragmented Theora packets as the client will have to cope with the + handling of the C and F flags. If we use the fragmented Theora + packet example above and the first packet is lost the client SHOULD + detect that the next packet has the packet count field set to 0 and + the C bit is set and MUST drop it. The next packet, which is the + final fragmented packet, SHOULD be dropped in the same manner, or + buffered. Feedback reports on lost and dropped packets MUST be sent + back via RTCP. + + If a particular multicast session has a large number of participants + care must be taken to prevent an RTCP feedback implosion, [8], in the + event of packet loss from a large number of participants. + + + + + + +Kerr Expires August 1, 2005 [Page 12] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +5. Configuration Headers + + To decode a Theora stream three configuration header blocks are + needed. The first header, the Identification Header, indicates the + frame dimensions, quality, blocks used and the version of the Theora + encoder used. The second header, the Comment Header, contains stream + metadata and the third header, the Setup Header, details which + contains dequantization and Huffman tables. + + As the RTP stream may change certain configuration data mid-session + there are two different methods for delivering this configuration + data to a client, in-band and SDP which is detailed below. SDP + delivery is used to set-up an initial state for the client + application and in-band is used to change state during the session. + The changes may be due to different metadata or Setup Header as well + as different bitrates of the stream. + + Out of the two delivery vectors the use of an SDP attribute to + indicate an URI where the configuration and Setup Header data can be + obtained is preferred as they can be fetched reliably using TCP. The + in-band Setup Header delivery SHOULD only be used in situations where + the link between the client is unidirectional or if the SDP-based + information is not available. + + Synchronizing the configuration and Setup Header to the RTP stream is + critical. The 32 bit Setup Header Ident field is used to indicate + when a change in the stream has taken place. The client application + MUST have in advance the correct configuration and Setup Headers and + if the client detects a change in the Ident value and does not have + this information it MUST NOT decode the raw Theora data. + +5.1 In-band Header Transmission + + The three header data blocks are sent in-band with the packet type + bits set to match the payload type. Normally the Setup Header and + Identification Header are sent once per session if the stream is an + encoding of live video, as typically the encoder state will not + change, but the encoder state can change at the boundary of chained + Theora video files. Metadata can be sent at the start as well as any + time during the life of the session. Clients MUST be capable of + dealing with periodic re-transmission of the configuration headers. + +5.1.1 Identification Header + + The Identification Header is a short header with only a few fields + used to declare the stream definitively as Theora and provide + detailed information about the format of the fully decoded video + data. + + + +Kerr Expires August 1, 2005 [Page 13] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | xxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |0|1|0|0| 1| 0x80 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | VMAJ | VMIN | VREV | FMBW | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FMBW | FMBH | NSBS | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NSBS | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NBS | NMBS | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NMBS | PICW | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PICW | PICH | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PICH | PICX | PICY | FRN | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FRN | FRD | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FRD | PARN | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PARN | PARD | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PARD | CS |PF | NOMBR | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NOMBR | QUAL | KFGSHIFT| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 9: Identification Header + + The fields listed above have the following meanings: + + + + + + +Kerr Expires August 1, 2005 [Page 14] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + VMAJ = The major version number. 8 bits. + VMIN = The minor version number. 8 bits. + VREV = The version revision number. 8 bits. + FMBW = The width of the frame in macro blocks. 16 bits. + FMBH = The height of the frame in macro blocks. 16 bits. + NSBS = The total number of super blocks in a frame. 32 bits. + NBS = The total number of blocks in a frame. 36 bits. + NMBS = The total number of macro blocks in a frame. 32 bits. + PICW = The width of the picture region in pixels. 20 bits. + PICH = The height of the picture region in pixels. 20 bits. + PICX = The X offset of the picture region in pixels. 8 bits. + PICY = The Y offset of the picture region in pixels. 8 bits. + FRN = The frame-rate numerator. 32 bits. + FRD = The frame-rate denominator. 32 bits. + PARN = The pixel aspect-ratio numerator. 24 bits. + PARD = The pixel aspect-ratio denominator. 24 bits. + CS = The color space. 8 bits. + PF = The pixel format. 2 bits. + NOMBR = The nominal bitrate of the stream, in bits per second. + 24 bits. + QUAL = The quality hint. 6 bits. + KFGSHIFT = The amount to shift the key frame number by in the + granule position. 5 bits. + + +5.1.2 Comment Header + + The Theora Comment Header is the second of three header packets that + begin a Theora stream. It is meant for short text comments, not + arbitrary metadata; arbitrary metadata belongs in a separate logical + stream that provides greater structure and machine parseability. The + comment field is meant to be used much like someone jotting a quick + note on the label of a video. It should be a little information to + remember the disc or tape by and explain it to others; a short, + to-the-point text note that can be more than a couple words, but + isn't going to be more than a short paragraph. + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 15] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | xxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |0|1|0|0| 1| 0x81 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comments list length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comment length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comment .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. User comment | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + + Figure 10: Comment Header + + The format for the data takes the form of a 32 bit field denoting the + number of user comments. Each of the user comments is prefixed by a + 32 bit length field followed by the comment text encoded in UTF-8. + +5.1.3 Setup Header + + The Theora setup header contains the limit values used to drive the + loop filter, the base matrices and scale values used to build the + dequantization tables, and the Huffman tables used to unpack the DCT + tokens. Because the contents of this header are specific to Theora, + no concessions have been made to keep the fields octet-aligned for + easy parsing. + + + + + + + + + +Kerr Expires August 1, 2005 [Page 16] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |V=2|P|X| CC |M| PT | xxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | xxxxx | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | synchronization source (SSRC) identifier | + +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+ + | contributing source (CSRC) identifiers | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + |0|1|0|0| 1| 0x82 | Payload Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 11: Setup Header + + +5.1.3.1 Setup Header CRC32 Generation + + In order for different implementations of Theora RTP clients and + servers to interoperate with each other a common format for the + production of the CRC32 hash is required. The polynomial is + X^32+X^26+X^23+X^22+X^16+X^12+X^11+X^10+X^8+X^7+X^5+X^4+X^2+X^1+X^0. + + The following C code function SHOULD be used by implementations, if + not then the code responsible for generating the CRC32 value MUST use + the polynomial function above. + + unsigned int crc32 (int length, unsigned char *crcdata) + { + int index, loop; + unsigned int byte, crc, mask; + + index = 0; + crc = 0xFFFFFFFF; + + while (index < length) { + byte = crcdata [index]; + + + +Kerr Expires August 1, 2005 [Page 17] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + crc = crc ^ byte; + + for (loop = 7; loop >= 0; loop--) { + mask = -(crc & 1); + crc = (crc >> 1) ^ (0xEDB88320 & mask); + } + index++; + } + return ~crc; + } + + +5.2 Packed Headers Delivery + + As mentioned above the RECOMMENDED delivery vector for Theora + configuration data is via an SDP attribute as this retrieval method + can be performed using a reliable transport protocol. + + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Number of packed headers | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Packed header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Packed header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 12: Packed Headers Overview + + As the RTP headers are not required for this method of delivery the + structure of the configuration data is slightly different. The + packed header starts with a 32 bit count field which details the + number of packed headers that are contained in the bundle. Next is + the packed header payload for each chained Theora file. + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 18] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Header Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Ident | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Identification Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Identification Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Comment Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Comment Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 13: Packed Headers Detail + + The key difference between the in-band format is there is no need for + the payload header octet and Setup Header Ident field. Below are + examples of the packed headers format. + + + + + + + + + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 19] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | VMAJ | VMIN | VREV | FMBW | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FMBW | FMBH | NSBS | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NSBS | | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NBS | NMBS | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NMBS | PICW | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PICW | PICH | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PICH | PICX | PICY | FRN | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FRN | FRD | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FRD | PARN | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PARN | PARD | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PARD | CS |PF | NOMBR | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | NOMBR | QUAL | KFGSHIFT| + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 14: Packed Identification Header + + The alignment of the packed Identification Header is slightly + different from the RTP payload type as the payload header is not + used. + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 20] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comments list length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comment length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | User comment .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. User comment | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 15: Packed Comment Header + + The packed Comment Header also as a slightly different structure to + that of the RTP payload type with the payload header not being used. + + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Setup Header .. + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + .. Setup Header | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + + Figure 16: Packed Setup Header + + The packed Setup Header also has a slightly different structure to + that of the RTP payload type. The Setup Header Ident field that is + normally part of this structure is moved to the second field of the + overall packed structure. + +5.2.1 Packed Headers IANA Considerations + + The following IANA considerations MUST only be applied to the packed + headers. + + MIME media type name: video + + MIME subtype: theora-config + + Required Parameters: + + None. + + + + +Kerr Expires August 1, 2005 [Page 21] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + Optional Parameters: + + None. + + Encoding considerations: + + This type is only defined for transfer via HTTP as specified in RFC + XXXX. + + Security Considerations: + + See Section 6 of RFC 3047. + + Interoperability considerations: none + + Published specification: + + See RFC XXXX for details. + + Applications which use this media type: + + Theora encoded video, configuration data. + + Additional information: none + + Person & email address to contact for further information: + + Phil Kerr: + + Intended usage: COMMON + + Author/Change controller: + + Author: Phil Kerr + + Change controller: IETF AVT Working Group + +5.3 Setup Header Caching + + Setup Header caching allows clients that have previously connected to + a stream to re-use the associated Setup Header and configuration + data. When a client receives a Setup Header it may store it locally + and can compare the CRC32 key with that of the new stream and begin + decoding before it has received any of the headers. + +5.4 Loss of Configuration Headers + + Unlike the loss of raw Theora payload data, loss of a configuration + + + +Kerr Expires August 1, 2005 [Page 22] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + header can lead to a situation where it will not be possible to + successfully decode the stream. + + Out of the three headers, loss of either the Setup Header or + Identification Headers MUST result in the halting of stream decoding. + Loss of the Comment header SHOULD NOT be regarded as fatal for + decoding. Loss of any of the headers SHOULD be reported to the + client as well as a loss report sent via RTCP. + +6. IANA Considerations + + MIME media type name: video + + MIME subtype: theora + + Required Parameters: + + sampling: Determines the chroma subsampling format. + + width: Determines the number of pixels per line. This is an integer + between 1 and 1048561 and MUST be in multiples of 16. + + height: Determines the number of lines per frame. This is an integer + between 1 and 1048561 and MUST be in multiples of 16. + + header: Indicates the URI of the decoding configuration headers. + + Optional Parameters: + + None. + + Encoding considerations: + + This type is only defined for transfer via RTP as specified in RFC + XXXX. + + Security Considerations: + + See Section 6 of RFC 3047. + + Interoperability considerations: none + + Published specification: + + See the Theora documentation [11] for details. + + Applications which use this media type: + + + + +Kerr Expires August 1, 2005 [Page 23] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + + Video streaming and conferencing tools + + Additional information: none + + Person & email address to contact for further information: + + Phil Kerr: + + Intended usage: COMMON + + Author/Change controller: + + Author: Phil Kerr + + Change controller: IETF AVT Working Group + +6.1 Mapping MIME Parameters into SDP + + The information carried in the MIME media type specification has a + specific mapping to fields in the Session Description Protocol (SDP) + [5], which is commonly used to describe RTP sessions. When SDP is + used to specify sessions the mapping are as follows: + + o The MIME type ("video") goes in SDP "m=" as the media name. + + o The MIME subtype ("THEORA") goes in SDP "a=rtpmap" as the encoding + name. + + o The parameter "rate" also goes in "a=rtpmap" as clock rate. + + o The parameter "channels" also goes in "a=rtpmap" as channel count. + + o The parameter "header" goes in the SDP "a=fmpt" attribute. + + If the stream comprises chained Theora files the configuration and + Setup Headers for each file SHOULD be packaged together and passed to + the client using the headers attribute if all the files to be played + are known in advance. + + Example: + + c=IN IP4/6 + m=video RTP/AVP 98 + a=rtpmap:98 theora/90000 + a=fmtp:98 sampling=YCbCr-4:2:2; width=1280; height=720; + header= + + + + + +Kerr Expires August 1, 2005 [Page 24] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +7. Security Considerations + + RTP packets using this payload format are subject to the security + considerations discussed in the RTP specification [3]. This implies + that the confidentiality of the media stream is achieved by using + encryption. Because the data compression used with this payload + format is applied end-to-end, encryption may be performed on the + compressed data. Where the size of a data block is set care MUST be + taken to prevent buffer overflows in the client applications. + +8. Acknowledgments + + Thanks to the AVT, Ogg Theora Communities / Xiph.org, Fluendo, Ralph + Giles. + +9. References + +9.1 Normative References + + [1] Pfeiffer, S., "The Ogg Encapsulation Format Version 0", RFC + 3533. + + [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", RFC 2119. + + [3] Schulzrinne, H., Casner, S., Frederick, R. and V. Jacobson, + "RTP: A Transport Protocol for real-time applications", RFC + 3550. + + [4] Schulzrinne, H. and S. Casner, "RTP Profile for video and Video + Conferences with Minimal Control.", RFC 3551. + + [5] Handley, M. and V. Jacobson, "SDP: Session Description + Protocol", RFC 2327. + + [6] Mogul et al., J., "Path MTU Discovery", RFC 1063. + + [7] McCann et al., J., "Path MTU Discovery for IP version 6", RFC + 1981. + + [8] Ott, J., Wenger, S., Sato, N., Burmeister, C. and J. Rey, + "Extended RTP Profile for RTCP-based Feedback (RTP/AVPF)", + Internet Draft (draft-ietf-avt-rtcp-feedback-11: Work in + progress). + + [9] Kerr, P., "RTP Payload Format for Vorbis Encoded Audio - + draft-ietf-avt-vorbis-rtp-00", Internet Draft (Work in + progress). + + + +Kerr Expires August 1, 2005 [Page 25] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +9.2 Informative References + + [10] "libTheora: Available from the Xiph website, + http://www.xiph.org". + + [11] "Ogg Theora I spec: Codec setup and packet decode. + http://www.xiph.org/ogg/Theora/doc/Theora-spec-ref.html". + + +Author's Address + + Phil Kerr + Xiph.Org + + EMail: phil@plus24.com + URI: http://www.xiph.org/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Kerr Expires August 1, 2005 [Page 26] + +Internet-Draft draft-kerr-avt-theora-rtp-00 January 2005 + + +Intellectual Property Statement + + The IETF takes no position regarding the validity or scope of any + Intellectual Property Rights or other rights that might be claimed to + pertain to the implementation or use of the technology described in + this document or the extent to which any license under such rights + might or might not be available; nor does it represent that it has + made any independent effort to identify any such rights. Information + on the procedures with respect to rights in RFC documents can be + found in BCP 78 and BCP 79. + + Copies of IPR disclosures made to the IETF Secretariat and any + assurances of licenses to be made available, or the result of an + attempt made to obtain a general license or permission for the use of + such proprietary rights by implementers or users of this + specification can be obtained from the IETF on-line IPR repository at + http://www.ietf.org/ipr. + + The IETF invites any interested party to bring to its attention any + copyrights, patents or patent applications, or other proprietary + rights that may cover technology that may be required to implement + this standard. Please address the information to the IETF at + ietf-ipr@ietf.org. + + +Disclaimer of Validity + + This document and the information contained herein are provided on an + "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS + OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET + ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, + INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE + INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED + WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + + +Copyright Statement + + Copyright (C) The Internet Society (2005). This document is subject + to the rights, licenses and restrictions contained in BCP 78, and + except as set forth therein, the authors retain all their rights. + + +Acknowledgment + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + + + +Kerr Expires August 1, 2005 [Page 27] + diff --git a/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.xml b/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.xml new file mode 100644 index 00000000..dff7a265 --- /dev/null +++ b/libs/libtheora-1.1/doc/draft-kerr-avt-theora-rtp-00.xml @@ -0,0 +1,1277 @@ + + + + + + + + +draft-kerr-avt-theora-rtp-00 + + +Xiph.Org +
+phil@plus24.com +http://www.xiph.org/ +
+ + + + +General +AVT Working Group +I-D + +Internet-Draft +Theora +RTP + + + +This document describes a RTP payload format for transporting Theora encoded video. It details the RTP encapsulation mechanism +for raw Theora data and configuration headers consisting of the quantization matrices and the Huffman codebooks for the DCT +coefficients, and a table of limit values for the deblocking filter. + + + +Also included within the document are the necessary details for the use of Theora with MIME and Session Description Protocol +(SDP). + + + + + + +All references to RFC XXXX are to be replaced by references to the RFC number of this memo, when published. + + + + + + + +
+ +Theora is a general purpose, lossy video codec. It is based on the VP3.1 video codec produced by On2 Technologies and has been donated to the Xiph.org Foundation. + + + +Theora I is a block-based lossy transform codec that utilizes an 8 x 8 Type-II Discrete Cosine Transform and block-based motion +compensation. This places it in the same class of codecs as MPEG-1, MPEG-2, MPEG-4, and H.263. The details of how individual +blocks are organized and how DCT coefficients are stored in the bitstream differ substantially from these codecs, however. Theora +supports only intra frames (I frames in MPEG) and inter frames (P frames in MPEG). + + + +Theora provides none of its own framing, synchronization, or protection against transmission errors. Theora is a free-form +variable bit rate (VBR) codec, and packets have no minimum size, maximum size, or fixed/expected size. Theora packets are thus +intended to be used with a transport mechanism that provides free-form framing, synchronization, positioning, and error correction +in accordance with these design assumptions, such as Ogg . or RTP/AVP . + + + +Theora I currently supports progressive video data of arbitrary dimensions at a constant frame rate in one of several YCbCr color +spaces. +Three different chroma subsampling formats are supported: 4:2:0, 4:2:2, and 4:4:4. The Theora I format does not support interlaced +material, variable frame rates, bit-depths larger than 8 bits per component, nor alternate color spaces such as RGB or arbitrary +multi-channel spaces. Black and white content can be efficiently encoded, however, because the uniform chroma planes compress well. + + + +Theora is similar to Vorbis audio in that it requires the inclusion of the entire probability +model for the DCT coefficients and all the quantization parameters in the bitstream headers to be sent ahead of the video data. It +is therefore impossible to decode any frame in the stream without having previously fetched the codec info and codec setup headers, +although Theora can initiate decode at an arbitrary intra-frame packet within a bitstream so long as the codec has been initialized +with the setup headers. + + +
+ + +The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", +and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 . + + +
+
+ +
+ + +Each frame of digital video is packetized into one or more RTP packets. If the data for a complete frame exceeds the network +MTU, it SHOULD be fragmented into multiple RTP packets, each smaller than the MTU. A single RTP packet MAY contain +data for more than one Theora frame. + + + +For RTP based transportation of Theora encoded video the standard RTP header is followed by a 5 octet payload header, then the +payload data. + + +
+ + +The format of the RTP header is specified in and shown in Figure 1. This payload format uses +the fields of the header in a manner consistent with that specification. + + +
+ +
+ + +The RTP header begins with an octet of fields (V, P, X, and CC) to support specialized RTP uses (see + and for details). For Theora RTP, the following values are used. + + + +Version (V): 2 bits +This field identifies the version of RTP. The version used by this specification is two (2). + + + +Padding (P): 1 bit +Padding MAY be used with this payload format according to section 5.1 of . + + + +Extension (X): 1 bit +The Extension bit is used in accordance with . + + + +CSRC count (CC): 4 bits +The CSRC count is used in accordance with . + + + +Marker (M): 1 bit +The Marker bit is used in accordance with . + + + +Payload Type (PT): 7 bits +An RTP profile for a class of applications is expected to assign a payload type for this format, or a dynamically allocated +payload type SHOULD be chosen which designates the payload as Theora. + + + +Sequence number: 16 bits +The sequence number increments by one for each RTP data packet sent, and may be used by the receiver to detect packet loss and +to restore packet sequence. This field is detailed further in . + + + +Timestamp: 32 bits +A timestamp representing the sampling time of the first sample of the first Theora packet in the RTP packet. The clock frequency +MUST be set to the sample rate of the encoded video data and is conveyed out-of-band as an SDP attribute. + + + +SSRC/CSRC identifiers: +These two fields, 32 bits each with one SSRC field and a maximum of 16 CSRC fields, are as defined in +. + + +
+ +
+ + +After the RTP Header section the following five octets are the Payload Header. +This header is split into a number of bitfields detailing the format of the following Payload Data packets. + + +
+ +
+ + +Setup Header Ident: 32 bits + +This 32 bit field is used to associate the Theora data to a decoding Setup Header. It is created by making a CRC32 checksum +of the Setup Header required to decode the particular Theora video stream. + + + +Continuation (C): 1 bit + +Set to one if this is a continuation of a fragmented packet. + + + +Fragmented (F): 1 bit + +Set to one if the payload contains complete packets or if it contains the last fragment of a fragmented packet. + + + +The next two bits are currently reserved and MUST be set to 0. + + + +The last 4 bits are the number of complete packets in this payload. This provides for a maximum number of 15 Theora +packets in the payload. If the packet contains fragmented data the number of packets MUST be set to 0. + + +
+ +
+ + +Each Theora payload section starts with a three octet header. The first octet is used to denote what kind of Theora data follows. +Then a two octet length header is used to represent the size of the following data payload, followed by the raw Theora data. + + +
+ +
+ + +The data type octet is used to signify the payload data type. If the first bit is set to 0, this indicates the payload is +Theora video data. + + + +The following values for the Theora payload type are valid: + + + + 0 = Raw Theora data + 0x80 = Theora Identification header + 0x81 = Theora Comment header + 0x82 = Theora Setup header + + + + +The Theora packet length header is the length of the Theora data block only and does not count the length octets and payload +data type octet. + + + +The Theora codec uses relatively unstructured raw packets containing binary integer fields of arbitrary width that often do not fall on an octet boundary. When this happens the bitstream is packed to an octet boundary. When a Theora encoder produces packets unused space in the last byte of a packet is always zeroed during the encoding process. Thus, should this unused space be read, it will return binary zeros. + + + +For payloads which consist of multiple Theora packets the payload data consists of the data type field, the payload length field +followed by the payload data for each of the Theora packets in the payload. + + +
+ +
+ + +Here is an example RTP packet containing two Theora packets. + + +RTP Packet Header: + + +
+ +
+ + + +Payload Data: + + +
+ +
+ + +The payload portion of the packet starts with the 32 bit Setup Header ident field followed by the 8 bit fragment/count fields. The F +bit is set to 1, indicating that this packet contains whole Theora frame data. The number of whole Theora data packets is set to +2. + + + +Each of the payload blocks starts with a Data type field, for the first payload this is set to 0x80 indicating it is an +Identification header and the second payload is set to 0 indicating it is raw Theora data. Then the two octet length field is +followed by the variable length Theora data. + + +
+
+ + +
+ + +Each RTP packet contains either one complete Theora packet, one Theora packet fragment, or an integer number of complete Theora +packets (up to a max of 15 packets, since the number of packets is defined by a 4 bit value). + + + +Any Theora data packet that is less than path MTU SHOULD be bundled in the RTP packet with as many Theora packets as will +fit, up to a maximum of 15. Path MTU is detailed in and . + + + +If a Theora packet is larger than 65535 octets it MUST be fragmented. A fragmented packet has a zero in the last four bits +of the payload header. Each fragment after the first will also set the Continued (C) bit to one in the payload header. The +RTP packet containing the last fragment of the Theora packet will have the Fragmented (F) bit set to one. To maintain the +correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first +packet sent, with the sequence number incremented as normal for the subsequent RTP packets. + + +
+ + +Here is an example fragmented Theora packet split over three RTP packets. Each packet contains the standard RTP headers as +well as the 5 octet Theora headers. + + +
+ +
+ + +In this packet the initial sequence number is 1000 and the timestamp is xxxxx. The Continuation (C) bit is set to one, +indicating it is not the continuation of a fragmented bit, and the Fragmentation (F) is set to 0 indicating it is a fragmented +packet. The number of packets field is set to 0, and as the payload is raw Theora data the Theora payload type field is set to 0. + + +
+ +
+ + +The C bit is set to 1 and the number of packets field is set to 0. For large Theora fragments there can be several of these type +of payload packets. The maximum packet size SHOULD be no greater than the path MTU, including all RTP and payload headers. The +sequence number has been incremented by one but the timestamp field remains the same as the initial packet. + + +
+ +
+ + +This is the last Theora fragment packet. The C and F bits are set and the packet count remains set to 0. As in the previous +packets the timestamp remains set to the first packet in the sequence and the sequence number has been incremented. + + +
+
+ + +
+ + +As there is no error correction within the Theora stream, packet loss will result in a loss of signal. Packet loss is more of an +issue for fragmented Theora packets as the client will have to cope with the handling of the C and F flags. If we use the +fragmented Theora packet example above and the first packet is lost the client SHOULD detect that the next packet has the packet +count field set to 0 and the C bit is set and MUST drop it. The next packet, which is the final fragmented packet, SHOULD +be dropped in the same manner, or buffered. Feedback reports on lost and dropped packets MUST be sent back via RTCP. + + + +If a particular multicast session has a large number of participants care must be taken to prevent an RTCP feedback implosion, +, in the event of packet loss from a large number of participants. + + +
+ +
+ + +To decode a Theora stream three configuration header blocks are needed. The first header, the Identification Header, indicates +the frame dimensions, quality, blocks used and the version of the Theora encoder used. The second header, the Comment Header, contains stream metadata and the third header, the Setup Header, details which contains dequantization and Huffman tables. + + + +As the RTP stream may change certain configuration data mid-session there are two different methods for delivering this +configuration data to a client, in-band and SDP which is detailed below. SDP delivery is used to set-up an initial +state for the client application and in-band is used to change state during the session. The changes may be due to +different metadata or Setup Header as well as different bitrates of the stream. + + + +Out of the two delivery vectors the use of an SDP attribute to indicate an URI where the configuration and Setup Header data +can be obtained is preferred as they can be fetched reliably using TCP. The in-band Setup Header delivery SHOULD +only be used in situations where the link between the client is unidirectional or if the SDP-based information is not available. + + + +Synchronizing the configuration and Setup Header to the RTP stream is critical. The 32 bit Setup Header Ident field is used +to indicate when a change in the stream has taken place. The client application MUST have in advance the correct configuration +and Setup Headers and if the client detects a change in the Ident value and does not have this information it MUST NOT +decode the raw Theora data. + + +
+ + +The three header data blocks are sent in-band with the packet type bits set to match the payload type. Normally the Setup Header +and Identification Header are sent once per session if the stream is an encoding of live video, as typically +the encoder state will not change, but the encoder state can change at the boundary of chained Theora video files. Metadata +can be sent at the start as well as any time during the life of the session. Clients MUST be capable of dealing with periodic +re-transmission of the configuration headers. + + +
+ + +The Identification Header is a short header with only a few fields used to declare the stream definitively as Theora and provide detailed information about the format of the fully decoded video data. + +
+ +
+ + +The fields listed above have the following meanings: + + + + + + VMAJ = The major version number. 8 bits. + VMIN = The minor version number. 8 bits. + VREV = The version revision number. 8 bits. + FMBW = The width of the frame in macro blocks. 16 bits. + FMBH = The height of the frame in macro blocks. 16 bits. + NSBS = The total number of super blocks in a frame. 32 bits. + NBS = The total number of blocks in a frame. 36 bits. + NMBS = The total number of macro blocks in a frame. 32 bits. + PICW = The width of the picture region in pixels. 20 bits. + PICH = The height of the picture region in pixels. 20 bits. + PICX = The X offset of the picture region in pixels. 8 bits. + PICY = The Y offset of the picture region in pixels. 8 bits. + FRN = The frame-rate numerator. 32 bits. + FRD = The frame-rate denominator. 32 bits. + PARN = The pixel aspect-ratio numerator. 24 bits. + PARD = The pixel aspect-ratio denominator. 24 bits. + CS = The color space. 8 bits. + PF = The pixel format. 2 bits. + NOMBR = The nominal bitrate of the stream, in bits per second. 24 bits. + QUAL = The quality hint. 6 bits. + KFGSHIFT = The amount to shift the key frame number by in the granule position. 5 bits. + + + +
+ +
+ + +The Theora Comment Header is the second of three header packets that begin a Theora stream. It is meant for short text comments, +not arbitrary metadata; arbitrary metadata belongs in a separate logical stream that provides greater structure and machine +parseability. The comment field is meant to be used much like someone jotting a quick note on the label of a video. It should be a +little information to remember the disc or tape by and explain it to others; a short, to-the-point text note that can be more than +a couple words, but isn't going to be more than a short paragraph. + + +
+ +
+ + +The format for the data takes the form of a 32 bit field denoting the number of user comments. Each of the user comments is prefixed by a 32 bit length field followed by the comment text encoded in UTF-8. + + +
+ +
+ + +The Theora setup header contains the limit values used to drive the loop filter, the base matrices and scale values used to build the dequantization tables, and the Huffman tables used to unpack the DCT tokens. Because the contents of this header are specific to Theora, no concessions have been made to keep the fields octet-aligned for easy parsing. + + +
+ +
+ + +
+ + +In order for different implementations of Theora RTP clients and servers to interoperate with each other a common format +for the production of the CRC32 hash is required. The polynomial is X^32+X^26+X^23+X^22+X^16+X^12+X^11+X^10+X^8+X^7+X^5+X^4+X^2+X^1+X^0. + + + +The following C code function SHOULD be used by implementations, if not then the code responsible for generating the CRC32 +value MUST use the polynomial function above. + + += 0; loop--) { + mask = -(crc & 1); + crc = (crc >> 1) ^ (0xEDB88320 & mask); + } + index++; + } + return ~crc; +} +]]> + + +
+ +
+
+ +
+ + +As mentioned above the RECOMMENDED delivery vector for Theora configuration data is via an SDP attribute as this retrieval method +can be performed using a reliable transport protocol. + + +
+ +
+ + +As the RTP headers are not required for this method of delivery the +structure of the configuration data is slightly different. The packed header starts with a 32 bit count field which details the number of packed headers that are contained in the bundle. Next is the packed header payload for each chained Theora file. + + +
+ +
+ +The key difference between the in-band format is there is no need for the payload header octet and Setup Header Ident field. +Below are examples of the packed headers format. + + +
+ +
+ + +The alignment of the packed Identification Header is slightly different from the RTP payload type as the payload header is not +used. + + +
+ +
+ + +The packed Comment Header also as a slightly different structure to that of the RTP payload type with the payload header not being +used. + + + +
+ +
+ + +The packed Setup Header also has a slightly different structure to that of the RTP payload type. The Setup Header Ident field +that is normally part of this structure is moved to the second field of the overall packed structure. + + +
+ + +The following IANA considerations MUST only be applied to the packed headers. + + + +MIME media type name: video + + +MIME subtype: theora-config + + + +Required Parameters: +None. + + + +Optional Parameters: +None. + + + +Encoding considerations: +This type is only defined for transfer via HTTP as specified in RFC XXXX. + + + +Security Considerations: +See Section 6 of RFC 3047. + + + +Interoperability considerations: none + + + +Published specification: +See RFC XXXX for details. + + +Applications which use this media type: +Theora encoded video, configuration data. + + + +Additional information: none + + + +Person & email address to contact for further information: +Phil Kerr: <phil@plus24.com> + + + +Intended usage: COMMON + + +Author/Change controller: +Author: Phil Kerr +Change controller: IETF AVT Working Group + + +
+
+ +
+ + +Setup Header caching allows clients that have previously connected to a stream to re-use the associated Setup Header and +configuration data. When a client receives a Setup Header it may store it locally and can compare the CRC32 key with that of the +new stream and begin decoding before it has received any of the headers. + + +
+ +
+ + +Unlike the loss of raw Theora payload data, loss of a configuration header can lead to a situation where it will not be possible +to successfully decode the stream. + + + +Out of the three headers, loss of either the Setup Header or Identification Headers MUST result in the halting of stream +decoding. Loss of the Comment header SHOULD NOT be regarded as fatal for decoding. Loss of any of the headers SHOULD be reported +to the client as well as a loss report sent via RTCP. + + +
+
+ + +
+ +MIME media type name: video + +MIME subtype: theora + +Required Parameters: + + +sampling: Determines the chroma subsampling format. + + +width: Determines the number of pixels per line. This is an integer between 1 and 1048561 and MUST be in multiples of 16. + + +height: Determines the number of lines per frame. This is an integer between 1 and 1048561 and MUST be in multiples of 16. + + +header: Indicates the URI of the decoding configuration headers. + + + +Optional Parameters: +None. + + + +Encoding considerations: +This type is only defined for transfer via RTP as specified in RFC XXXX. + + + +Security Considerations: +See Section 6 of RFC 3047. + + + +Interoperability considerations: none + + + +Published specification: +See the Theora documentation for details. + + +Applications which use this media type: +Video streaming and conferencing tools + + + +Additional information: none + + + +Person & email address to contact for further information: +Phil Kerr: <phil@plus24.com> + + + +Intended usage: COMMON + + +Author/Change controller: +Author: Phil Kerr +Change controller: IETF AVT Working Group + +
+ + +The information carried in the MIME media type specification has a specific mapping to fields in the Session Description +Protocol (SDP) , which is commonly used to describe RTP sessions. When SDP is used to specify +sessions the mapping are as follows: + + + + + +The MIME type ("video") goes in SDP "m=" as the media name. + + +The MIME subtype ("THEORA") goes in SDP "a=rtpmap" as the encoding name. + + +The parameter "rate" also goes in "a=rtpmap" as clock rate. + + +The parameter "channels" also goes in "a=rtpmap" as channel count. + + +The parameter "header" goes in the SDP "a=fmpt" attribute. + + + + +If the stream comprises chained Theora files the configuration and Setup Headers for each file SHOULD be packaged together +and passed to the client using the headers attribute if all the files to be played are known in advance. + + + +Example: + + + + +c=IN IP4/6 +m=video RTP/AVP 98 +a=rtpmap:98 theora/90000 +a=fmtp:98 sampling=YCbCr-4:2:2; width=1280; height=720; header=<URI of configuration header> + + +
+
+ + + + +
+ +RTP packets using this payload format are subject to the security considerations discussed in the RTP specification +. This implies that the confidentiality of the media stream is achieved by using +encryption. Because the data compression used with this payload format is applied end-to-end, encryption may be performed on the +compressed data. Where the size of a data block is set care MUST be taken to prevent buffer overflows in the client applications. + + +
+ +
+ + +Thanks to the AVT, Ogg Theora Communities / Xiph.org, Fluendo, Ralph Giles. + + +
+ + + + + + + + + +The Ogg Encapsulation Format Version 0 + + + + + + + +Key words for use in RFCs to Indicate Requirement Levels + + + + + + + +RTP: A Transport Protocol for real-time applications + + + + + + + + + + +RTP Profile for video and Video Conferences with Minimal Control. + + + + + + + + + +SDP: Session Description Protocol + + + + + + + + +Path MTU Discovery + + + + + + + +Path MTU Discovery for IP version 6 + + + + + + + +Extended RTP Profile for RTCP-based Feedback (RTP/AVPF) + + + + + + + + + + + +RTP Payload Format for Vorbis Encoded Audio - draft-ietf-avt-vorbis-rtp-00 + + + + + + + + + + + +libTheora: Available from the Xiph website, http://www.xiph.org + + + + + +Ogg Theora I spec: Codec setup and packet decode. http://www.xiph.org/ogg/Theora/doc/Theora-spec-ref.html + + + + + + + diff --git a/libs/libtheora-1.1/doc/spec/Makefile.am b/libs/libtheora-1.1/doc/spec/Makefile.am new file mode 100644 index 00000000..ee1fb902 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/Makefile.am @@ -0,0 +1,81 @@ +## Process this file with automake to produce Makefile.in + +# makefile to generate the spec document from sources +# requires transfig and pdflatex + +built_docs = Theora.pdf + +if BUILD_SPEC +doc_DATA = $(built_docs) +endif + +SPEC_SRCS = spec.tex spec.bib + +FIG_SRCS = pic-frame.fig hilbert-mb.fig hilbert-block.fig xifish.fig \ + superblock.fig macroblock.fig raster-block.fig reference-frames.fig \ + pixel444.fig pixel422.fig pixel420.fig idct.fig fdct.fig \ + pic_even.fig pic_even_odd.fig pic_odd.fig pic_odd_even.fig \ + lflim.fig + +FIG_TEXS = $(FIG_SRCS:.fig=.tex) +FIG_AUXS = $(FIG_SRCS:.fig=.aux) +FIG_PDFS = $(FIG_SRCS:.fig=.pdf) + +# add any native-pdf figures here +FIG_OBJS = $(FIG_PDFS) + +EXTRA_DIST = $(built_docs) $(SPEC_SRCS) $(FIG_SRCS) ltablex.sty + +if BUILD_SPEC +# latex three times is the charm with references +# long tables require the .aux file to start from scratch +Theora.pdf : $(SPEC_SRCS) $(FIG_OBJS) vp3huff.tex + -$(RM) spec.aux + pdflatex -interaction nonstopmode spec.tex + bibtex spec.aux + pdflatex -interaction nonstopmode spec.tex + pdflatex -interaction nonstopmode spec.tex + mv spec.pdf $@ +else +Theora.pdf : + echo "*** Warning: Missing tools; $@ will not be built." +endif + +vp3huff.tex : vp3huff + ./vp3huff > $@ + +noinst_PROGRAMS = vp3huff +vp3huff_SOURCES = vp3huff.c + +figures : $(FIG_OBJS) + +# rules to generate latex and pdf versions of the xfig figures +.fig.tex: + fig2dev -L latex $< $@ + +.fig.pdf: + fig2dev -L pdf -p 0 $< $@ + +SUFFIXES = .fig .tex .pdf + +# clean targets +clean-local: + -$(RM) $(FIG_TEXS) + -$(RM) $(FIG_AUXS) + -$(RM) $(FIG_PDFS) + -$(RM) vp3huff + -$(RM) vp3huff.tex + -$(RM) vp3huff.aux + -$(RM) spec.aux + -$(RM) spec.log + -$(RM) spec.lof + -$(RM) spec.lot + -$(RM) spec.out + -$(RM) spec.bbl + -$(RM) spec.blg + -$(RM) spec.toc + +maintainer-clean-local: + -$(RM) $(built_docs) + +maintainerclean: maintainer-clean diff --git a/libs/libtheora-1.1/doc/spec/fdct.fig b/libs/libtheora-1.1/doc/spec/fdct.fig new file mode 100644 index 00000000..e35c758c --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/fdct.fig @@ -0,0 +1,371 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +6 1350 4650 1650 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1500 4800 75 75 1500 4800 1500 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1450 4800 1550 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1500 4850 1500 4750 +-6 +6 1350 450 1650 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1500 600 75 75 1500 600 1500 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1450 600 1550 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1500 650 1500 550 +-6 +6 1950 1050 2250 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 1200 75 75 2100 1200 2100 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 1200 2150 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 1250 2100 1150 +-6 +6 3150 2850 3450 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 3000 75 75 3300 3000 3300 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 3000 3350 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 3050 3300 2950 +-6 +6 3150 2250 3450 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 2400 75 75 3300 2400 3300 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 2400 3350 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 2450 3300 2350 +-6 +6 2550 3450 2850 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2700 3600 75 75 2700 3600 2700 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2650 3600 2750 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2700 3650 2700 3550 +-6 +6 2550 1650 2850 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2700 1800 75 75 2700 1800 2700 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2650 1800 2750 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2700 1850 2700 1750 +-6 +6 1950 4050 2250 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 4200 75 75 2100 4200 2100 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 4200 2150 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 4250 2100 4150 +-6 +6 2250 3600 2550 3900 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2400 3750 75 75 2400 3750 2400 3675 +4 1 0 40 -1 0 12 0.0000 4 15 60 2400 3800 -\001 +-6 +6 1650 4200 1950 4500 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1800 4350 75 75 1800 4350 1800 4275 +4 1 0 40 -1 0 12 0.0000 4 15 60 1800 4400 -\001 +-6 +6 1050 4800 1350 5100 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1200 4950 75 75 1200 4950 1200 4875 +4 1 0 40 -1 0 12 0.0000 4 15 60 1200 5000 -\001 +-6 +6 2850 3000 3150 3300 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3000 3150 75 75 3000 3150 3000 3075 +4 1 0 40 -1 0 12 0.0000 4 15 60 3000 3200 -\001 +-6 +6 4350 4050 4650 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 4200 75 75 4500 4200 4500 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 4200 4550 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 4250 4500 4150 +-6 +6 4350 3450 4650 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 3600 75 75 4500 3600 4500 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 3600 4550 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 3650 4500 3550 +-6 +6 4050 3300 4350 3600 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4200 3450 75 75 4200 3450 4200 3375 +4 1 0 40 -1 0 12 0.0000 4 15 60 4200 3500 -\001 +-6 +6 4350 2250 4650 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 2400 75 75 4500 2400 4500 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 2400 4550 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 2450 4500 2350 +-6 +6 4350 450 4650 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 600 75 75 4500 600 4500 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 600 4550 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 650 4500 550 +-6 +6 4050 2400 4350 2700 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4200 2550 75 75 4200 2550 4200 2475 +4 1 0 40 -1 0 12 0.0000 4 15 60 4200 2600 -\001 +-6 +6 4950 1050 5250 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 1200 75 75 5100 1200 5100 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 1200 5150 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 1250 5100 1150 +-6 +6 4950 1650 5250 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 1800 75 75 5100 1800 5100 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 1800 5150 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 1850 5100 1750 +-6 +6 4650 1800 4950 2100 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4800 1950 75 75 4800 1950 4800 1875 +4 1 0 40 -1 0 12 0.0000 4 15 60 4800 2000 -\001 +-6 +6 4725 3525 4875 4275 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4800 4200 25 25 4800 4200 4800 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4800 3600 25 25 4800 3600 4800 3575 +-6 +6 6150 4650 6450 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 4800 75 75 6300 4800 6300 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 4800 6350 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 4850 6300 4750 +-6 +6 6150 4050 6450 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 4200 75 75 6300 4200 6300 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 4200 6350 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 4250 6300 4150 +-6 +6 5850 3900 6150 4200 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6000 4050 75 75 6000 4050 6000 3975 +4 1 0 40 -1 0 12 0.0000 4 15 60 6000 4100 -\001 +-6 +6 6150 2850 6450 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 3000 75 75 6300 3000 6300 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 3000 6350 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 3050 6300 2950 +-6 +6 6150 3450 6450 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 3600 75 75 6300 3600 6300 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 3600 6350 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 3650 6300 3550 +-6 +6 5850 3600 6150 3900 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6000 3750 75 75 6000 3750 6000 3675 +4 1 0 40 -1 0 12 0.0000 4 15 60 6000 3800 -\001 +-6 +6 6150 1050 6450 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 1200 75 75 6300 1200 6300 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 1200 6350 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 1250 6300 1150 +-6 +6 6150 450 6450 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 600 75 75 6300 600 6300 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 600 6350 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 650 6300 550 +-6 +6 6150 2250 6450 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 2400 75 75 6300 2400 6300 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 2400 6350 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 2450 6300 2350 +-6 +6 6150 1650 6450 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 1800 75 75 6300 1800 6300 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 1800 6350 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 1850 6300 1750 +-6 +6 5850 1200 6150 1500 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6000 1350 75 75 6000 1350 6000 1275 +4 1 0 40 -1 0 12 0.0000 4 15 60 6000 1400 -\001 +-6 +6 7350 4650 7650 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7500 4800 75 75 7500 4800 7500 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7450 4800 7550 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7500 4850 7500 4750 +-6 +6 7350 2850 7650 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7500 3000 75 75 7500 3000 7500 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7450 3000 7550 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7500 3050 7500 2950 +-6 +6 7950 4050 8250 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 8100 4200 75 75 8100 4200 8100 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8050 4200 8150 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8100 4250 8100 4150 +-6 +6 7950 3450 8250 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 8100 3600 75 75 8100 3600 8100 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8050 3600 8150 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8100 3650 8100 3550 +-6 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 900 4800 25 25 900 4800 900 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 900 600 25 25 900 600 900 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 1200 25 25 1500 1200 1500 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 3000 25 25 2700 3000 2700 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 2400 25 25 2700 2400 2700 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2100 3600 25 25 2100 3600 2100 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 4200 25 25 1500 4200 1500 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 4200 25 25 3900 4200 3900 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 3600 25 25 3900 3600 3900 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 2400 25 25 3900 2400 3900 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 600 25 25 3900 600 3900 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 1200 25 25 4500 1200 4500 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 1800 25 25 4500 1800 4500 1775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 4800 25 25 5700 4800 5700 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 4200 25 25 5700 4200 5700 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 3600 25 25 5700 3600 5700 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 3000 25 25 5700 3000 5700 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 1200 25 25 5700 1200 5700 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 600 25 25 5700 600 5700 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 2400 25 25 5700 2400 5700 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5725 1800 25 25 5725 1800 5725 1775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6900 4800 25 25 6900 4800 6900 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6900 3000 25 25 6900 3000 6900 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 4200 25 25 7500 4200 7500 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 3600 25 25 7500 3600 7500 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 1200 25 25 7500 1200 7500 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 600 25 25 7500 600 7500 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2100 1800 25 25 2100 1800 2100 1775 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 600 8400 600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 2400 8400 2400 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 3000 8400 3000 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 4800 8400 4800 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 1200 8400 1200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 3600 8400 3600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 1800 8400 1800 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 4200 8400 4200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 900 4800 1500 600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 900 600 1500 4800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 1500 1200 2100 4275 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 1500 4200 2100 1200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2100 3600 2700 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 2400 3300 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2100 1800 2700 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 3000 3300 2400 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 3600 4500 4200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 4200 4500 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 600 4500 2400 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 2400 4500 600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 1800 5100 1200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 1200 5100 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 4200 6300 4800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 3600 6300 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 3000 6300 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 4800 6300 4200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5700 1200 6300 600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5700 600 6300 1200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5700 1800 6300 2400 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 5700 2400 6300 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6900 3000 7500 4800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6900 4800 7500 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 7500 4200 8100 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 7500 3600 8100 4200 +4 1 0 40 -1 0 12 0.0000 4 135 210 4800 4125 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 4800 3525 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 6000 2350 C6\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 6300 2275 -S6\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 6000 1750 C6\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 6300 2050 S6\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7200 2950 C7\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 7500 3375 S7\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7200 4750 C7\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 7500 4575 -S7\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7800 4150 C3\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 8100 4075 -S3\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7800 3550 C3\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 8100 3850 S3\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7500 1125 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 7500 525 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 675 0\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 1275 4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 1875 2\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 2475 6\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 3675 5\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 4275 3\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 4875 7\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 3075 1\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 675 0\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 1275 1\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 1875 2\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 2475 3\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 3075 4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 3675 5\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 4275 6\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 4875 7\001 diff --git a/libs/libtheora-1.1/doc/spec/hilbert-block.fig b/libs/libtheora-1.1/doc/spec/hilbert-block.fig new file mode 100644 index 00000000..8316c5d1 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/hilbert-block.fig @@ -0,0 +1,104 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 675 645 3825 3795 +4 1 0 50 0 1 12 0.0000 0 150 105 900 3660 0\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 3660 1\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 2760 2\001 +4 1 0 50 0 1 12 0.0000 0 150 105 900 2760 3\001 +4 1 0 50 0 1 12 0.0000 0 150 105 900 1860 4\001 +4 1 0 50 0 1 12 0.0000 0 150 105 900 960 5\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 960 6\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 1860 7\001 +4 1 0 50 0 1 12 0.0000 0 150 105 2700 1860 8\001 +4 1 0 50 0 1 12 0.0000 0 150 105 2700 960 9\001 +4 1 0 50 0 1 12 0.0000 0 150 210 3600 960 10\001 +4 1 0 50 0 1 12 0.0000 0 150 210 3600 1860 11\001 +4 1 0 50 0 1 12 0.0000 0 150 210 3600 2760 12\001 +4 1 0 50 0 1 12 0.0000 0 150 210 2700 2760 13\001 +4 1 0 50 0 1 12 0.0000 0 150 210 2700 3660 14\001 +4 1 0 50 0 1 12 0.0000 0 150 210 3600 3660 15\001 +-6 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 3600 1575 3600 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1800 3375 1800 2925 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1575 2700 1125 2700 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 900 2475 900 2025 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 900 1575 900 1125 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 900 1575 900 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1800 1125 1800 1575 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2025 1800 2475 1800 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2700 1575 2700 1125 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2925 900 3375 900 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 3600 1125 3600 1575 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 3600 2025 3600 2475 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 3375 2700 2925 2700 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2700 2925 2700 3375 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2925 3600 3375 3600 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 450 1350 450 1350 1350 450 1350 450 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 450 2250 450 2250 1350 1350 1350 1350 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 450 3150 450 3150 1350 2250 1350 2250 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 450 4050 450 4050 1350 3150 1350 3150 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 1350 1350 1350 1350 2250 450 2250 450 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 1350 2250 1350 2250 2250 1350 2250 1350 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 1350 3150 1350 3150 2250 2250 2250 2250 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 1350 4050 1350 4050 2250 3150 2250 3150 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 2250 1350 2250 1350 3150 450 3150 450 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 2250 2250 2250 2250 3150 1350 3150 1350 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 2250 3150 2250 3150 3150 2250 3150 2250 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 2250 4050 2250 4050 3150 3150 3150 3150 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 3150 1350 3150 1350 4050 450 4050 450 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 3150 2250 3150 2250 4050 1350 4050 1350 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 3150 3150 3150 3150 4050 2250 4050 2250 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 3150 4050 3150 4050 4050 3150 4050 3150 3150 diff --git a/libs/libtheora-1.1/doc/spec/hilbert-mb.fig b/libs/libtheora-1.1/doc/spec/hilbert-mb.fig new file mode 100644 index 00000000..0ed12a76 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/hilbert-mb.fig @@ -0,0 +1,32 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 810 810 1890 1890 +4 1 0 50 0 1 12 0.0000 0 150 105 900 1860 0\001 +4 1 0 50 0 1 12 0.0000 0 150 105 900 960 1\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 960 2\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 1860 3\001 +-6 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 900 1575 900 1125 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 900 1575 900 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1800 1125 1800 1575 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 450 1350 450 1350 1350 450 1350 450 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 450 2250 450 2250 1350 1350 1350 1350 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 1350 1350 1350 1350 2250 450 2250 450 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 1350 2250 1350 2250 2250 1350 2250 1350 1350 diff --git a/libs/libtheora-1.1/doc/spec/idct.fig b/libs/libtheora-1.1/doc/spec/idct.fig new file mode 100644 index 00000000..2d4388c4 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/idct.fig @@ -0,0 +1,369 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +6 3150 4650 3450 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 4800 75 75 3300 4800 3300 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 4800 3350 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 4850 3300 4750 +-6 +6 3150 4050 3450 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 4200 75 75 3300 4200 3300 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 4200 3350 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 4250 3300 4150 +-6 +6 2850 3900 3150 4200 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3000 4050 75 75 3000 4050 3000 3975 +4 1 0 40 -1 0 12 0.0000 4 15 60 3000 4100 -\001 +-6 +6 3150 2850 3450 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 3000 75 75 3300 3000 3300 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 3000 3350 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 3050 3300 2950 +-6 +6 3150 3450 3450 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3300 3600 75 75 3300 3600 3300 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3250 3600 3350 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 3300 3650 3300 3550 +-6 +6 2850 3600 3150 3900 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 3000 3750 75 75 3000 3750 3000 3675 +4 1 0 40 -1 0 12 0.0000 4 15 60 3000 3800 -\001 +-6 +6 1950 1050 2250 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 1200 75 75 2100 1200 2100 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 1200 2150 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 1250 2100 1150 +-6 +6 1950 450 2250 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 600 75 75 2100 600 2100 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 600 2150 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 650 2100 550 +-6 +6 1950 2250 2250 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 2400 75 75 2100 2400 2100 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 2400 2150 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 2450 2100 2350 +-6 +6 1950 1650 2250 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 1800 75 75 2100 1800 2100 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 1800 2150 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 1850 2100 1750 +-6 +6 1650 1200 1950 1500 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1800 1350 75 75 1800 1350 1800 1275 +4 1 0 40 -1 0 12 0.0000 4 15 60 1800 1400 -\001 +-6 +6 6150 4650 6450 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 4800 75 75 6300 4800 6300 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 4800 6350 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 4850 6300 4750 +-6 +6 6150 450 6450 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6300 600 75 75 6300 600 6300 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6250 600 6350 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6300 650 6300 550 +-6 +6 6750 1050 7050 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6900 1200 75 75 6900 1200 6900 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6850 1200 6950 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6900 1250 6900 1150 +-6 +6 7950 2850 8250 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 8100 3000 75 75 8100 3000 8100 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8050 3000 8150 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8100 3050 8100 2950 +-6 +6 7950 2250 8250 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 8100 2400 75 75 8100 2400 8100 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8050 2400 8150 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 8100 2450 8100 2350 +-6 +6 7350 3450 7650 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7500 3600 75 75 7500 3600 7500 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7450 3600 7550 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7500 3650 7500 3550 +-6 +6 7350 1650 7650 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7500 1800 75 75 7500 1800 7500 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7450 1800 7550 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 7500 1850 7500 1750 +-6 +6 6750 4050 7050 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6900 4200 75 75 6900 4200 6900 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6850 4200 6950 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 6900 4250 6900 4150 +-6 +6 7050 3600 7350 3900 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7200 3750 75 75 7200 3750 7200 3675 +4 1 0 40 -1 0 12 0.0000 4 15 60 7200 3800 -\001 +-6 +6 6450 4200 6750 4500 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6600 4350 75 75 6600 4350 6600 4275 +4 1 0 40 -1 0 12 0.0000 4 15 60 6600 4400 -\001 +-6 +6 5850 4800 6150 5100 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 6000 4950 75 75 6000 4950 6000 4875 +4 1 0 40 -1 0 12 0.0000 4 15 60 6000 5000 -\001 +-6 +6 7650 3000 7950 3300 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 7800 3150 75 75 7800 3150 7800 3075 +4 1 0 40 -1 0 12 0.0000 4 15 60 7800 3200 -\001 +-6 +6 4950 4050 5250 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 4200 75 75 5100 4200 5100 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 4200 5150 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 4250 5100 4150 +-6 +6 4950 3450 5250 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 3600 75 75 5100 3600 5100 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 3600 5150 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 3650 5100 3550 +-6 +6 4650 3300 4950 3600 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4800 3450 75 75 4800 3450 4800 3375 +4 1 0 40 -1 0 12 0.0000 4 15 60 4800 3500 -\001 +-6 +6 4350 2250 4650 2550 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 2400 75 75 4500 2400 4500 2325 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 2400 4550 2400 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 2450 4500 2350 +-6 +6 4350 450 4650 750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4500 600 75 75 4500 600 4500 525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4450 600 4550 600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 4500 650 4500 550 +-6 +6 4050 2400 4350 2700 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4200 2550 75 75 4200 2550 4200 2475 +4 1 0 40 -1 0 12 0.0000 4 15 60 4200 2600 -\001 +-6 +6 4950 1050 5250 1350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 1200 75 75 5100 1200 5100 1125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 1200 5150 1200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 1250 5100 1150 +-6 +6 4950 1650 5250 1950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 5100 1800 75 75 5100 1800 5100 1725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5050 1800 5150 1800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 5100 1850 5100 1750 +-6 +6 1950 4050 2250 4350 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 4200 75 75 2100 4200 2100 4125 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 4200 2150 4200 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 4250 2100 4150 +-6 +6 1950 3450 2250 3750 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 2100 3600 75 75 2100 3600 2100 3525 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2050 3600 2150 3600 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 2100 3650 2100 3550 +-6 +6 1350 4650 1650 4950 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1500 4800 75 75 1500 4800 1500 4725 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1450 4800 1550 4800 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1500 4850 1500 4750 +-6 +6 1350 2850 1650 3150 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 1500 3000 75 75 1500 3000 1500 2925 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1450 3000 1550 3000 +2 1 0 1 0 7 40 -1 20 4.000 0 0 7 0 0 2 + 1500 3050 1500 2950 +-6 +6 4650 1800 4950 2100 +1 3 0 1 0 7 40 -1 20 4.000 1 0.0000 4800 1950 75 75 4800 1950 4800 1875 +4 1 0 40 -1 0 12 0.0000 4 15 60 4800 2000 -\001 +-6 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 4800 25 25 2700 4800 2700 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 4200 25 25 2700 4200 2700 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 3600 25 25 2700 3600 2700 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 2700 3000 25 25 2700 3000 2700 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 1200 25 25 1500 1200 1500 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 600 25 25 1500 600 1500 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 2400 25 25 1500 2400 1500 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1525 1800 25 25 1525 1800 1525 1775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3000 1200 25 25 3000 1200 3000 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3000 600 25 25 3000 600 3000 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 4800 25 25 5700 4800 5700 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 5700 600 25 25 5700 600 5700 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6300 1200 25 25 6300 1200 6300 1175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 3000 25 25 7500 3000 7500 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 7500 2400 25 25 7500 2400 7500 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6900 3600 25 25 6900 3600 6900 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6300 4200 25 25 6300 4200 6300 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 4200 25 25 4500 4200 4500 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 3600 25 25 4500 3600 4500 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4200 4200 25 25 4200 4200 4200 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4200 3600 25 25 4200 3600 4200 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 6900 1800 25 25 6900 1800 6900 1775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 2400 25 25 3900 2400 3900 2375 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 3900 600 25 25 3900 600 3900 575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 4200 25 25 1500 4200 1500 4175 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 1500 3600 25 25 1500 3600 1500 3575 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 900 4800 25 25 900 4800 900 4775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 900 3000 25 25 900 3000 900 2975 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 1800 25 25 4500 1800 4500 1775 +1 3 0 1 0 0 40 -1 20 4.000 1 0.0000 4500 1200 25 25 4500 1200 4500 1175 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 600 8400 600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 2400 8400 2400 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 3000 8400 3000 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 4800 8400 4800 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 1200 8400 1200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 4200 3300 4800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 3600 3300 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 3000 3300 3600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 3600 8400 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 2700 4800 3300 4200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 1800 8400 1800 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 4200 8400 4200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 1500 1200 2100 600 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 1500 600 2100 1200 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 1500 1800 2100 2400 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2 + 1500 2400 2100 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 4800 6300 600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 5700 600 6300 4800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6300 1200 6900 4275 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6300 4200 6900 1200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6900 3600 7500 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 7500 2400 8100 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 6900 1800 7500 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 7500 3000 8100 2400 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 3600 5100 4200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 4200 5100 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 2400 4500 600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 3900 600 4500 2400 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 1800 5100 1200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 4500 1200 5100 1800 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 1500 4200 2100 3600 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 1500 3600 2100 4200 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 900 4800 1500 3000 +2 1 0 1 0 7 50 -1 -1 4.000 0 0 -1 0 0 2 + 900 3000 1500 4800 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 675 0\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 1275 4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 1875 2\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 2475 6\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 3675 5\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 4275 3\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 4875 7\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 300 3075 1\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1800 2350 C6\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 2100 2275 S6\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1800 1750 C6\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 2100 2050 -S6\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 3000 1125 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 3000 525 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 675 0\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 1275 1\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 1875 2\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 2475 3\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 3075 4\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 3675 5\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 4275 6\001 +4 1 0 40 -1 0 12 0.0000 4 135 90 8700 4875 7\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 4200 4125 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 4200 3525 C4\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1800 4150 C3\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 2100 4075 S3\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1800 3550 C3\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 2100 3850 -S3\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1200 2950 C7\001 +4 1 0 40 -1 0 12 0.0000 4 135 255 1500 3375 -S7\001 +4 1 0 40 -1 0 12 0.0000 4 135 210 1200 4750 C7\001 +4 1 0 40 -1 0 12 0.0000 4 135 195 1500 4575 S7\001 diff --git a/libs/libtheora-1.1/doc/spec/lflim.fig b/libs/libtheora-1.1/doc/spec/lflim.fig new file mode 100644 index 00000000..c71dc7fe --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/lflim.fig @@ -0,0 +1,23 @@ +#FIG 3.2 Produced by xfig version 3.2.5 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 600 2400 5400 2400 +2 1 2 1 0 7 50 -1 -1 3.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 3000 4200 3000 600 +2 1 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 6 + 600 2400 1200 2400 2100 3300 3900 1500 4800 2400 5400 2400 +4 1 0 50 -1 1 12 0.0000 0 195 615 1200 2325 (-2L,0)\001 +4 1 0 50 -1 1 12 0.0000 0 195 600 2100 3525 (-L,-L)\001 +4 0 0 50 -1 1 12 0.0000 0 150 360 3075 825 lflim\001 +4 1 0 50 -1 1 12 0.0000 0 195 480 3900 1425 (L,L)\001 +4 1 0 50 -1 1 12 0.0000 0 195 555 4800 2625 (2L,0)\001 +4 0 0 50 -1 1 12 0.0000 0 150 135 5250 2625 R\001 diff --git a/libs/libtheora-1.1/doc/spec/ltablex.sty b/libs/libtheora-1.1/doc/spec/ltablex.sty new file mode 100644 index 00000000..31a08479 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/ltablex.sty @@ -0,0 +1,237 @@ +%% +%% This is file ltablex.sty (v1.0, November 1995) +%% +%% +%% Author: Anil K. Goel (akgoel@uwaterloo.ca) +%% +%% +%% Copyright (C) QNX Software Systems Ltd. 1995 +%% All rights reserved. +%% Please send any comments/suggetions to: latex@qnx.com +%% +%% This system is distributed in the hope that it will be useful +%% to others, but WITHOUT ANY WARRANTY; without even the implied +%% warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +%% +%% +%% The file modifies the tabularx environment to +%% combine the features of the tabularx package +%% (auto-sized columns in a fixed width table) +%% with those of the longtable package +%% (multi-page tables). +%% +%% The tables are typeset using the tabularx environment +%% and the longtable environment is used internally to +%% handle multi-page tables. The \setlongtables feature +%% is used, and, therefore, the document should be +%% run through latex twice. +%% +%% Another feature that has been added is to treat the X +%% columns like 'l' columns if the table contents would allow +%% that to happen without exceeding the specified width of +%% the table. In other words, the specified width is +%% treated as the maximum allowed and not the exact width +%% of the table. This feature is the default but can be +%% disabled (or enabled) with \keepXColumns (or \convertXColumns). +%% +%% Caveats: +%% . The document needs to be latexed a couple times in general. +%% . In general, it is necessary to remove the .aux file before +%% the first latex run on the document. +%% . The table should not be larger than TeX's memory capacity +%% +%% +%% Here is a a simple usage example: +%% +%% +%% \documentclass{article} +%% +%% \usepackage{ltablex} +%% +%% \textheight=4in +%% +%% \begin{document} +%% +%% % we want a table that is \textwidth long, has 4 columns, columns 1 +%% % and 3 are auto sized with the 3rd columns being 3 times wider than +%% % the first column. +%% % +%% +%% +%% \begin{tabularx}{\linewidth}% +%% {|>{\setlength{\hsize}{.5\hsize}\raggedright\arraybackslash}X| % col 1; auto-sized ragged right +%% c| % col 2; default centered +%% >{\setlength{\hsize}{1.5\hsize}\raggedleft\arraybackslash}X|% col 3; auto-sized ragged left +%% l|} % col 4; default left-justified +%% +%% \caption*{The Table Caption}\\ +%% \hline +%% F-Head1 & F-Head2 & F-Head3 & F-Head4\\ +%% \hline +%% \hline +%% \endfirsthead +%% \hline +%% Head1 & Head2 & Head3 & Head4\\ +%% \hline +%% \hline +%% \endhead +%% +%% \hline +%% \hline +%% Foot1 & Foot2 & Foot3 & Foot4\\ +%% \hline +%% \endfoot +%% +%% +%% \hline +%% \hline +%% L-Foot1 & L-Foot2 & L-Foot3 & L-Foot4\\ +%% \hline +%% \endlastfoot +%% +%% This is a very long sentence not likely to fit& +%% not too long& +%% This is another very long sentence not likely to fit& +%% not long\\ +%% +%% \hline +%% filler & filler & filler & filler\\ +%% +%% \hline +%% This is a very long sentence not likely to fit& +%% not too long& +%% This is another very long sentence not likely to fit& +%% not long\\ +%% +%% \hline +%% This is a very long sentence not likely to fit& +%% not too long& +%% This is another very long sentence not likely to fit& +%% not long\\ +%% +%% \hline +%% This is a very long sentence not likely to fit& +%% not too long& +%% This is another very long sentence not likely to fit& +%% not long\\ +%% +%% \end{tabularx} +%% +%% \begin{tabularx}{\linewidth}{|c|X|c|} +%% \hline +%% a &convert X to l & b\\ +%% \hline +%% \end{tabularx} +%% +%% \keepXColumns +%% \begin{tabularx}{\linewidth}{|c|X|c|} +%% \hline +%% a &retain X & b\\ +%% \hline +%% \end{tabularx} +%% +%% \convertXColumns +%% \begin{tabularx}{\linewidth}{|c|X|c|} +%% \hline +%% a &convert X to l & b\\ +%% \hline +%% \end{tabularx} +%% +%% +%% \end{document} + +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{ltablex}[1995/11/06 v1.0 Modified tabularx] + +\RequirePackage{longtable}[1994/12/08] +\RequirePackage{tabularx}[1994/02/03] + +\newif\ifTX@convertX@ +\TX@convertX@true + +\newcommand\keepXColumns{ + \TX@convertX@false +} + +\newcommand\convertXColumns{ + \TX@convertX@true +} + +\renewcommand\TX@endtabularx{% + \expandafter\TX@newcol\expandafter{\tabularxcolumn{\TX@col@width}}% + \let\verb\TX@verb + \def\@elt##1{\global\value{##1}\the\value{##1}\relax}% + \edef\TX@ckpt{\cl@@ckpt}% + \let\@elt\relax + \TX@old@table=\maxdimen + \TX@col@width=\TX@target + \global\TX@cols=\@ne + \TX@typeout@ + {\@spaces Table Width\@spaces Column Width\@spaces X Columns}% + + % + % define \endhead, etc. to be \\ so that in this part + % of the process they are just rows + % + \let\savecaption\caption + \def\caption{\\} + \let\saveendhead\endhead + \def\endhead{\\} + \let\saveendfirsthead\endfirsthead + \def\endfirsthead{\\} + \let\saveendfoot\endfoot + \def\endfoot{\\} + \let\saveendlastfoot\endlastfoot + \def\endlastfoot{\\} + % + % + \ifTX@convertX@ + \TX@trial{\def\NC@rewrite@X{\NC@find l}} + \ifdim\wd\@tempboxa<\TX@target + \TX@newcol{l} + \else + \TX@convertX@false + \fi + \fi + + \ifTX@convertX@ + \relax + \else + \TX@trial{\def\NC@rewrite@X{% + \global\advance\TX@cols\@ne\NC@find p{\TX@col@width}}}% + \loop + \TX@arith + \ifTX@ + \TX@trial{}% + \repeat + \fi + {\let\@footnotetext\TX@ftntext\let\@xfootnotenext\TX@xftntext + % we may as well set \LTchunksize to be \maxdimen as the whole + % thing is already in memory anyway so we may as well do it in one + % chunk. if it is too big for one chunk we are already dead.. + \LTchunksize\maxdimen + % + % restore \endhead, etc. + % + \let\caption\savecaption + \let\endhead\saveendhead + \let\endfirsthead\saveendfirsthead + \let\endfoot\saveendfoot + \let\endlastfoot\saveendlastfoot + % + \expandafter\longtable + \the\toks@ + \endlongtable + }% + \global\TX@ftn\expandafter{\expandafter}\the\TX@ftn + \ifnum0=`{\fi}% + \end{tabularx} +} + + +% +% activate column width reading from the .aux file +% + + +\setlongtables diff --git a/libs/libtheora-1.1/doc/spec/macroblock.fig b/libs/libtheora-1.1/doc/spec/macroblock.fig new file mode 100644 index 00000000..3e20d932 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/macroblock.fig @@ -0,0 +1,37 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 702 1540 4867 1540 4867 4828 702 4828 702 1540 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4828 928 4828 928 4610 710 4610 710 4828 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 914 4610 1133 4610 1133 4391 914 4391 914 4610 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 723 4385 1133 4385 1133 4828 723 4828 723 4385 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4610 928 4610 928 4391 710 4391 710 4610 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 914 4828 1133 4828 1133 4610 914 4610 914 4828 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2068 857 6233 857 6233 4145 2068 4145 2068 857 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 1385 1198 5550 1198 5550 4487 1385 4487 1385 1198 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2089 3702 2499 3702 2499 4145 2089 4145 2089 3702 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1406 4043 1816 4043 1816 4487 1406 4487 1406 4043 +4 0 0 50 -1 0 5 0.0000 4 79 182 613 4943 (0,0)\001 +4 0 0 50 -1 0 5 0.0000 4 80 785 2055 833 Frame: chroma plane\001 +4 0 0 50 -1 0 5 0.0000 4 57 467 894 4009 Macroblock\001 +4 0 0 50 -1 0 5 0.0000 4 57 228 450 4521 Block\001 +4 0 0 50 -1 0 5 0.0000 4 57 228 450 4760 Block\001 +4 0 0 50 -1 0 5 0.0000 4 57 148 450 4863 8x8\001 +4 0 0 50 -1 0 5 0.0000 4 80 785 1235 1175 Frame: chroma plane\001 +4 0 0 50 -1 0 5 0.0000 4 80 694 621 1516 Frame: luma plane\001 diff --git a/libs/libtheora-1.1/doc/spec/pic-frame.fig b/libs/libtheora-1.1/doc/spec/pic-frame.fig new file mode 100644 index 00000000..d99ec7e1 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pic-frame.fig @@ -0,0 +1,75 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +0 32 #7f7f7f +6 250 236 5737 4724 +6 659 4520 1068 4724 +4 1 0 50 0 0 7 0.0000 0 75 450 864 4724 X Offset\001 +4 1 0 50 0 0 7 0.0000 0 90 375 864 4596 Picture\001 +-6 +6 250 3880 454 4290 +4 1 0 50 0 0 7 1.5708 0 90 375 327 4086 Picture\001 +4 1 0 50 0 0 7 1.5708 0 75 450 454 4086 Y Offset\001 +-6 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 608 301 608 454 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 5466 301 5466 454 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 608 378 5466 378 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 608 4392 608 4546 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 1119 4392 1119 4546 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 608 4468 1119 4468 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 1119 4468 5211 4468 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 5211 4392 5211 4546 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 404 4340 557 4340 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 404 3830 557 3830 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 404 761 557 761 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 480 3830 480 761 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 5517 4340 5671 4340 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2 + 5517 506 5671 506 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 5594 4340 5594 506 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 1 2 + 1 1 1.00 34.09 68.18 + 1 1 1.00 34.09 68.18 + 480 4340 480 3830 +2 2 0 1 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 608 506 5466 506 5466 4340 608 4340 608 506 +2 2 0 1 0 7 50 0 -1 0.000 0 0 7 0 0 5 + 1119 761 5211 761 5211 3830 1119 3830 1119 761 +4 1 0 50 0 0 7 0.0000 0 90 720 3165 4596 Picture Width\001 +4 1 0 50 0 0 7 1.5708 0 105 690 5722 1912 Frame Height\001 +4 1 0 50 0 0 7 0.0000 0 90 660 2782 326 Frame Width\001 +4 1 0 50 0 0 7 1.5708 0 105 750 454 2295 Picture Height\001 +4 1 0 50 0 0 7 0.0000 0 75 315 2782 685 Frame\001 +4 1 0 50 0 0 7 0.0000 0 90 375 3165 2295 Picture\001 +4 0 0 50 0 0 7 0.0000 0 105 240 659 4290 (0,0)\001 +-6 diff --git a/libs/libtheora-1.1/doc/spec/pic_even.fig b/libs/libtheora-1.1/doc/spec/pic_even.fig new file mode 100644 index 00000000..041a43a1 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pic_even.fig @@ -0,0 +1,102 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 724 2025 945 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2244 945 2244 945 2025 732 2025 732 2244 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2475 945 2475 945 2256 732 2256 732 2475 +-6 +6 1665 2070 1888 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2267 1888 2267 1888 2070 1673 2070 1673 2267 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2475 1888 2475 1888 2278 1673 2278 1673 2475 +-6 +6 724 900 945 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1119 945 1119 945 900 732 900 732 1119 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1350 945 1350 945 1131 732 1131 732 1350 +-6 +6 6300 2070 6795 2520 +6 6300 2070 6570 2295 +6 6300 2070 6570 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6335 2295 6553 2295 6553 2076 6335 2076 6335 2295 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6335 2520 6553 2520 6553 2301 6335 2301 6335 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2295 6778 2295 6778 2076 6560 2076 6560 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2520 6778 2520 6778 2301 6560 2301 6560 2520 +-6 +6 4455 2070 4950 2520 +6 4455 2070 4725 2295 +6 4455 2070 4725 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2295 4708 2295 4708 2076 4490 2076 4490 2295 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2520 4708 2520 4708 2301 4490 2301 4490 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 2295 4933 2295 4933 2076 4715 2076 4715 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 2520 4933 2520 4933 2301 4715 2301 4715 2520 +-6 +6 4455 945 4950 1395 +6 4455 945 4725 1170 +6 4455 945 4725 1170 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1170 4708 1170 4708 951 4490 951 4490 1170 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1395 4708 1395 4708 1176 4490 1176 4490 1395 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 1170 4933 1170 4933 951 4715 951 4715 1170 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 1395 4933 1395 4933 1176 4715 1176 4715 1395 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2249 1800 3736 1800 3736 2947 2249 2947 2249 1800 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2385 1935 3600 1935 3600 2745 2385 2745 2385 1935 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2745 2610 2745 2610 2526 2397 2526 2397 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3375 2745 3590 2745 3590 2548 3375 2548 3375 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 724 900 1888 900 1888 2475 724 2475 724 900 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 473 675 2003 675 2003 2925 473 2925 473 675 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2154 2610 2154 2610 1935 2397 1935 2397 2154 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 4005 720 7020 720 7020 2970 4005 2970 4005 720 +4 0 0 50 -1 0 24 0.0000 4 30 270 2835 2655 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 1080 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 765 1665 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 2430 2385 ...\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 450 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 2205 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 3943 3098 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 4545 2655 Pixels\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 5220 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 4680 1755 ...\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 2205 1665 Frame: chroma (4:2:0 case)\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 450 585 Frame: chroma (4:2:2 case)\001 +4 0 0 50 -1 0 9 0.0000 4 75 615 4005 630 Frame: luma\001 diff --git a/libs/libtheora-1.1/doc/spec/pic_even_odd.fig b/libs/libtheora-1.1/doc/spec/pic_even_odd.fig new file mode 100644 index 00000000..4b513b7f --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pic_even_odd.fig @@ -0,0 +1,88 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 724 2025 945 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2244 945 2244 945 2025 732 2025 732 2244 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2475 945 2475 945 2256 732 2256 732 2475 +-6 +6 1665 2070 1888 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2267 1888 2267 1888 2070 1673 2070 1673 2267 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2475 1888 2475 1888 2278 1673 2278 1673 2475 +-6 +6 4455 2070 4950 2520 +6 4455 2070 4725 2295 +6 4455 2070 4725 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2295 4708 2295 4708 2076 4490 2076 4490 2295 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2520 4708 2520 4708 2301 4490 2301 4490 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 2295 4933 2295 4933 2076 4715 2076 4715 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 2520 4933 2520 4933 2301 4715 2301 4715 2520 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2249 1800 3736 1800 3736 2947 2249 2947 2249 1800 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2385 1935 3600 1935 3600 2745 2385 2745 2385 1935 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2745 2610 2745 2610 2526 2397 2526 2397 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3375 2745 3590 2745 3590 2548 3375 2548 3375 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 724 900 1888 900 1888 2475 724 2475 724 900 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 473 675 2003 675 2003 2925 473 2925 473 675 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2154 2610 2154 2610 1935 2397 1935 2397 2154 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 4005 720 7020 720 7020 2970 4005 2970 4005 720 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1170 4708 1170 4708 951 4490 951 4490 1170 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4715 1170 4933 1170 4933 951 4715 951 4715 1170 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2520 6778 2520 6778 2301 6560 2301 6560 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2295 6778 2295 6778 2076 6560 2076 6560 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4715 945 4933 945 4933 726 4715 726 4715 945 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4490 945 4708 945 4708 726 4490 726 4490 945 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 6785 2295 7003 2295 7003 2076 6785 2076 6785 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 6785 2520 7003 2520 7003 2301 6785 2301 6785 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1125 945 1125 945 906 732 906 732 1125 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 732 894 945 894 945 675 732 675 732 894 +4 0 0 50 -1 0 24 0.0000 4 30 270 2835 2655 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 1080 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 765 1665 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 2430 2385 ...\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 450 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 2205 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 3943 3098 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 4545 2655 Pixels\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 5220 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 4680 1755 ...\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 2205 1665 Frame: chroma (4:2:0 case)\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 450 585 Frame: chroma (4:2:2 case)\001 +4 0 0 50 -1 0 9 0.0000 4 75 615 4005 630 Frame: luma\001 diff --git a/libs/libtheora-1.1/doc/spec/pic_odd.fig b/libs/libtheora-1.1/doc/spec/pic_odd.fig new file mode 100644 index 00000000..da126010 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pic_odd.fig @@ -0,0 +1,90 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 724 2025 945 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2244 945 2244 945 2025 732 2025 732 2244 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2475 945 2475 945 2256 732 2256 732 2475 +-6 +6 1665 2070 1888 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2267 1888 2267 1888 2070 1673 2070 1673 2267 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2475 1888 2475 1888 2278 1673 2278 1673 2475 +-6 +6 724 900 945 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1119 945 1119 945 900 732 900 732 1119 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1350 945 1350 945 1131 732 1131 732 1350 +-6 +6 6300 2070 6795 2520 +6 6300 2070 6570 2295 +6 6300 2070 6570 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6335 2295 6553 2295 6553 2076 6335 2076 6335 2295 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6335 2520 6553 2520 6553 2301 6335 2301 6335 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2295 6778 2295 6778 2076 6560 2076 6560 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2520 6778 2520 6778 2301 6560 2301 6560 2520 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2249 1800 3736 1800 3736 2947 2249 2947 2249 1800 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2385 1935 3600 1935 3600 2745 2385 2745 2385 1935 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2745 2610 2745 2610 2526 2397 2526 2397 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3375 2745 3590 2745 3590 2548 3375 2548 3375 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 724 900 1888 900 1888 2475 724 2475 724 900 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 473 675 2003 675 2003 2925 473 2925 473 675 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2154 2610 2154 2610 1935 2397 1935 2397 2154 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 4005 720 7020 720 7020 2970 4005 2970 4005 720 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2295 4708 2295 4708 2076 4490 2076 4490 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2520 4708 2520 4708 2301 4490 2301 4490 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1170 4708 1170 4708 951 4490 951 4490 1170 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1395 4708 1395 4708 1176 4490 1176 4490 1395 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 1170 4483 1170 4483 951 4265 951 4265 1170 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 1395 4483 1395 4483 1176 4265 1176 4265 1395 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 2295 4483 2295 4483 2076 4265 2076 4265 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 2520 4483 2520 4483 2301 4265 2301 4265 2520 +4 0 0 50 -1 0 24 0.0000 4 30 270 2835 2655 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 1080 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 765 1665 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 2430 2385 ...\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 450 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 2205 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 3943 3098 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 4545 2655 Pixels\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 5220 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 4680 1755 ...\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 2205 1665 Frame: chroma (4:2:0 case)\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 450 585 Frame: chroma (4:2:2 case)\001 +4 0 0 50 -1 0 9 0.0000 4 75 615 4005 630 Frame: luma\001 diff --git a/libs/libtheora-1.1/doc/spec/pic_odd_even.fig b/libs/libtheora-1.1/doc/spec/pic_odd_even.fig new file mode 100644 index 00000000..f1312952 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pic_odd_even.fig @@ -0,0 +1,84 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 724 2025 945 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2244 945 2244 945 2025 732 2025 732 2244 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 2475 945 2475 945 2256 732 2256 732 2475 +-6 +6 1665 2070 1888 2475 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2267 1888 2267 1888 2070 1673 2070 1673 2267 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1673 2475 1888 2475 1888 2278 1673 2278 1673 2475 +-6 +6 724 900 945 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1119 945 1119 945 900 732 900 732 1119 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 732 1350 945 1350 945 1131 732 1131 732 1350 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2249 1800 3736 1800 3736 2947 2249 2947 2249 1800 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2385 1935 3600 1935 3600 2745 2385 2745 2385 1935 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2745 2610 2745 2610 2526 2397 2526 2397 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3375 2745 3590 2745 3590 2548 3375 2548 3375 2745 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 724 900 1888 900 1888 2475 724 2475 724 900 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 473 675 2003 675 2003 2925 473 2925 473 675 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2397 2154 2610 2154 2610 1935 2397 1935 2397 2154 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 4005 720 7020 720 7020 2970 4005 2970 4005 720 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2295 4708 2295 4708 2076 4490 2076 4490 2295 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 2520 4708 2520 4708 2301 4490 2301 4490 2520 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 2295 4483 2295 4483 2076 4265 2076 4265 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 2520 4483 2520 4483 2301 4265 2301 4265 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4500 945 6795 945 6795 2520 4500 2520 4500 945 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2520 6778 2520 6778 2301 6560 2301 6560 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 6560 2295 6778 2295 6778 2076 6560 2076 6560 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 6785 2295 7003 2295 7003 2076 6785 2076 6785 2295 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 6785 2520 7003 2520 7003 2301 6785 2301 6785 2520 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4490 1170 4708 1170 4708 951 4490 951 4490 1170 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 945 4483 945 4483 726 4265 726 4265 945 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4265 1170 4483 1170 4483 951 4265 951 4265 1170 +2 2 0 1 0 11 50 -1 43 0.000 0 0 -1 0 0 5 + 4490 945 4708 945 4708 726 4490 726 4490 945 +4 0 0 50 -1 0 24 0.0000 4 30 270 2835 2655 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 1080 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 765 1665 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 2430 2385 ...\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 450 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 2205 3060 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 3943 3098 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 4545 2655 Pixels\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 5220 2295 ...\001 +4 0 0 50 -1 0 24 0.0000 4 30 270 4680 1755 ...\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 2205 1665 Frame: chroma (4:2:0 case)\001 +4 0 0 50 -1 0 9 0.0000 4 105 1335 450 585 Frame: chroma (4:2:2 case)\001 +4 0 0 50 -1 0 9 0.0000 4 75 615 4005 630 Frame: luma\001 diff --git a/libs/libtheora-1.1/doc/spec/pixel420.fig b/libs/libtheora-1.1/doc/spec/pixel420.fig new file mode 100644 index 00000000..56e91912 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pixel420.fig @@ -0,0 +1,56 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 675 4365 1170 4815 +6 675 4365 945 4590 +6 675 4365 945 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4590 928 4590 928 4371 710 4371 710 4590 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4815 928 4815 928 4596 710 4596 710 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4590 1153 4590 1153 4371 935 4371 935 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4815 1153 4815 1153 4596 935 4596 935 4815 +-6 +6 1125 4365 1646 4815 +6 1125 4365 1420 4590 +6 1125 4365 1420 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1163 4590 1401 4590 1401 4371 1163 4371 1163 4590 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1163 4815 1401 4815 1401 4596 1163 4596 1163 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1409 4590 1646 4590 1646 4371 1409 4371 1409 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1409 4815 1646 4815 1646 4596 1409 4596 1409 4815 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 1665 1350 4788 1350 4788 4153 1665 4153 1665 1350 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2700 900 5823 900 5823 3703 2700 3703 2700 900 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 702 2025 3825 2025 3825 4828 702 4828 702 2025 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1800 4005 2018 4005 2018 3786 1800 3786 1800 4005 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2160 4005 2378 4005 2378 3786 2160 3786 2160 4005 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2835 3555 3053 3555 3053 3336 2835 3336 2835 3555 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3195 3555 3413 3555 3413 3336 3195 3336 3195 3555 +4 0 0 50 -1 0 8 0.0000 4 105 1215 1485 1305 Frame: chroma plane Cb\001 +4 0 0 50 -1 0 8 0.0000 4 105 1200 2565 855 Frame: chroma plane Cr\001 +4 0 0 50 -1 0 8 0.0000 4 105 1035 540 1980 Frame: luma planeY'\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 765 4320 Pixels\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 613 4943 (0,0)\001 diff --git a/libs/libtheora-1.1/doc/spec/pixel422.fig b/libs/libtheora-1.1/doc/spec/pixel422.fig new file mode 100644 index 00000000..dbe008a3 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pixel422.fig @@ -0,0 +1,70 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 675 4365 1170 4815 +6 675 4365 945 4590 +6 675 4365 945 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4590 928 4590 928 4371 710 4371 710 4590 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4815 928 4815 928 4596 710 4596 710 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4590 1153 4590 1153 4371 935 4371 935 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4815 1153 4815 1153 4596 935 4596 935 4815 +-6 +6 1125 4365 1646 4815 +6 1125 4365 1420 4590 +6 1125 4365 1420 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1163 4590 1401 4590 1401 4371 1163 4371 1163 4590 +-6 +-6 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1163 4815 1401 4815 1401 4596 1163 4596 1163 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1409 4590 1646 4590 1646 4371 1409 4371 1409 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1409 4815 1646 4815 1646 4596 1409 4596 1409 4815 +-6 +6 1800 3690 2025 4140 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1807 3909 2025 3909 2025 3690 1807 3690 1807 3909 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1807 4140 2025 4140 2025 3921 1807 3921 1807 4140 +-6 +6 2160 3690 2385 4140 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2167 3909 2385 3909 2385 3690 2167 3690 2167 3909 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2167 4140 2385 4140 2385 3921 2167 3921 2167 4140 +-6 +6 3195 3240 3420 3690 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3202 3459 3420 3459 3420 3240 3202 3240 3202 3459 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3202 3690 3420 3690 3420 3471 3202 3471 3202 3690 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 1665 1350 4788 1350 4788 4153 1665 4153 1665 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2842 3459 3060 3459 3060 3240 2842 3240 2842 3459 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2700 900 5823 900 5823 3703 2700 3703 2700 900 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2842 3690 3060 3690 3060 3471 2842 3471 2842 3690 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 702 2025 3825 2025 3825 4828 702 4828 702 2025 +4 0 0 50 -1 0 8 0.0000 4 105 1215 1485 1305 Frame: chroma plane Cb\001 +4 0 0 50 -1 0 8 0.0000 4 105 1200 2565 855 Frame: chroma plane Cr\001 +4 0 0 50 -1 0 8 0.0000 4 105 1035 540 1980 Frame: luma planeY'\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 765 4320 Pixels\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 613 4943 (0,0)\001 diff --git a/libs/libtheora-1.1/doc/spec/pixel444.fig b/libs/libtheora-1.1/doc/spec/pixel444.fig new file mode 100644 index 00000000..75655e8a --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/pixel444.fig @@ -0,0 +1,44 @@ +#FIG 3.2 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 702 2025 3825 2025 3825 4828 702 4828 702 2025 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 1665 1350 4788 1350 4788 4153 1665 4153 1665 1350 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 2700 900 5823 900 5823 3703 2700 3703 2700 900 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4590 928 4590 928 4371 710 4371 710 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4590 1153 4590 1153 4371 935 4371 935 4590 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 935 4815 1153 4815 1153 4596 935 4596 935 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 710 4815 928 4815 928 4596 710 4596 710 4815 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1700 3915 1918 3915 1918 3696 1700 3696 1700 3915 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1925 3915 2143 3915 2143 3696 1925 3696 1925 3915 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1925 4140 2143 4140 2143 3921 1925 3921 1925 4140 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1700 4140 1918 4140 1918 3921 1700 3921 1700 4140 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2735 3465 2953 3465 2953 3246 2735 3246 2735 3465 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2960 3465 3178 3465 3178 3246 2960 3246 2960 3465 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2960 3690 3178 3690 3178 3471 2960 3471 2960 3690 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2735 3690 2953 3690 2953 3471 2735 3471 2735 3690 +4 0 0 50 -1 0 8 0.0000 4 105 1215 1485 1305 Frame: chroma plane Cb\001 +4 0 0 50 -1 0 8 0.0000 4 105 1200 2565 855 Frame: chroma plane Cr\001 +4 0 0 50 -1 0 8 0.0000 4 105 1035 540 1980 Frame: luma planeY'\001 +4 0 0 50 -1 0 7 0.0000 4 75 285 765 4320 Pixels\001 +4 0 0 50 -1 0 7 0.0000 4 90 210 613 4943 (0,0)\001 diff --git a/libs/libtheora-1.1/doc/spec/raster-block.fig b/libs/libtheora-1.1/doc/spec/raster-block.fig new file mode 100644 index 00000000..cebaf02b --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/raster-block.fig @@ -0,0 +1,91 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 900 1575 900 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 450 1350 450 1350 1350 450 1350 450 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 450 2250 450 2250 1350 1350 1350 1350 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 450 3150 450 3150 1350 2250 1350 2250 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 450 4050 450 4050 1350 3150 1350 3150 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 1350 1350 1350 1350 2250 450 2250 450 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 1350 2250 1350 2250 2250 1350 2250 1350 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 1350 3150 1350 3150 2250 2250 2250 2250 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 1350 4050 1350 4050 2250 3150 2250 3150 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 2250 1350 2250 1350 3150 450 3150 450 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 2250 2250 2250 2250 3150 1350 3150 1350 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 2250 3150 2250 3150 3150 2250 3150 2250 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 2250 4050 2250 4050 3150 3150 3150 3150 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 450 3150 1350 3150 1350 4050 450 4050 450 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1350 3150 2250 3150 2250 4050 1350 4050 1350 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2250 3150 3150 3150 3150 4050 2250 4050 2250 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 3150 3150 4050 3150 4050 4050 3150 4050 3150 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4050 450 4950 450 4950 1350 4050 1350 4050 450 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4050 1350 4950 1350 4950 2250 4050 2250 4050 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4050 2250 4950 2250 4950 3150 4050 3150 4050 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4050 3150 4950 3150 4950 4050 4050 4050 4050 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4950 3150 5850 3150 5850 4050 4950 4050 4950 3150 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4950 2250 5850 2250 5850 3150 4950 3150 4950 2250 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4950 1350 5850 1350 5850 2250 4950 2250 4950 1350 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 4950 450 5850 450 5850 1350 4950 1350 4950 450 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 3600 1575 3600 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2925 3600 3375 3600 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 2025 3600 2475 3600 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 1125 2655 1575 2655 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 4770 3600 5220 3600 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 5445 3510 900 2880 +2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 + 1 1 1.00 60.00 120.00 + 5400 1800 855 1170 +4 1 0 50 0 1 12 0.0000 0 150 105 900 3660 0\001 +4 1 0 50 0 1 12 0.0000 0 150 105 1800 3660 1\001 +4 1 0 50 0 1 12 0.0000 0 150 105 2700 3660 2\001 +4 0 0 50 -1 0 20 0.0000 4 30 225 3555 3645 ...\001 +4 0 0 50 -1 0 20 0.0000 4 30 225 945 1845 ...\001 +4 0 0 50 -1 0 12 0.0000 4 150 330 5310 3645 m-1\001 +4 0 0 50 -1 0 12 0.0000 4 150 435 5175 2655 2m-1\001 +4 1 0 50 0 1 12 0.0000 0 105 165 900 2760 m\001 +4 1 0 50 0 1 12 0.0000 0 195 690 855 1035 (n-1)*m\001 +4 0 0 50 -1 0 12 0.0000 4 150 540 5085 900 n*m-1\001 diff --git a/libs/libtheora-1.1/doc/spec/reference-frames.fig b/libs/libtheora-1.1/doc/spec/reference-frames.fig new file mode 100644 index 00000000..8026e56e --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/reference-frames.fig @@ -0,0 +1,46 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +2 2 1 2 0 7 50 -1 -1 4.000 0 0 -1 0 0 5 + 1980 450 2430 450 2430 900 1980 900 1980 450 +2 2 1 2 0 7 50 -1 -1 4.000 0 0 -1 0 0 5 + 2520 450 2970 450 2970 900 2520 900 2520 450 +2 2 1 2 0 7 50 -1 -1 4.000 0 0 -1 0 0 5 + 4140 450 4590 450 4590 900 4140 900 4140 450 +2 2 1 2 0 7 50 -1 -1 4.000 0 0 -1 0 0 5 + 1440 450 1890 450 1890 900 1440 900 1440 450 +2 2 1 2 0 7 50 -1 15 4.000 0 0 -1 0 0 5 + 3600 450 4050 450 4050 900 3600 900 3600 450 +2 2 1 2 0 7 50 -1 41 4.000 0 0 -1 0 0 5 + 3060 450 3510 450 3510 900 3060 900 3060 450 +2 2 0 2 0 7 50 -1 41 0.000 0 0 -1 0 0 5 + 900 450 1350 450 1350 900 900 900 900 450 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 3780 990 3780 1395 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 3240 990 3240 1395 +2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 1 2 + 0 0 1.00 60.00 120.00 + 1125 990 1125 1395 +4 0 0 50 -1 0 20 0.0000 4 30 225 4770 675 ...\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 900 405 Intra\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 1440 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 1980 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 2520 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 3060 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 3600 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 150 420 4140 405 Inter\001 +4 0 0 50 -1 0 12 0.0000 4 120 630 3690 1575 current\001 +4 0 0 50 -1 0 12 0.0000 4 150 840 2745 1575 reference\001 +4 0 0 50 -1 0 12 0.0000 4 150 510 2925 1755 frame\001 +4 0 0 50 -1 0 12 0.0000 4 150 510 3690 1755 frame\001 +4 0 0 50 -1 0 12 0.0000 4 195 570 855 1575 golden\001 +4 0 0 50 -1 0 12 0.0000 4 150 510 900 1800 frame\001 diff --git a/libs/libtheora-1.1/doc/spec/spec.bib b/libs/libtheora-1.1/doc/spec/spec.bib new file mode 100644 index 00000000..cf62cebf --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/spec.bib @@ -0,0 +1,120 @@ +@MANUAL{rfc2044, + author="Francois Yergeau", + title="{RFC} 2044: {UTF}-8, a transformation format of Unicode and {ISO} + 10646", + month=oct, + year=1996, + note="\url{http://www.ietf.org/rfc/rfc2044.txt}" +} + +@ARTICLE{CSF77, + author="Wen-Hsiung Chen and C. Harrison Smith and S. C. Fralick", + title="A Fast Computational Algorithm for the Discrete Cosine Transform", + journal="{IEEE} Transactions on Communications", + volume="COM-25", + number=9, + pages="1004--1011", + month=sep, + year=1977 +} + +@MISC{Mel04, + author="Mike Melanson", + title="{VP3} Bitstream Format and Decoding Process", + howpublished="\url{http://www.multimedia.cx/vp3-format.txt}", + month=mar, + year=2004 +} + +@MISC{Poyn97, + author="Charles Poynton", + title="Frequently-Asked Questions about Gamma", + howpublished="\url{http://www.poynton.com/GammaFAQ.html}", + month=feb, + year=1997 +} + +@MANUAL{rec470, + key="ITU470", + title="Reccomendation {ITU-R} {BT}.470-6: Conventional Television Systems", + edition="1970, revised", + organization="International Telecommunications Union", + address="1211 Geneva 20, Switzerland", + year=1998 +} + +@MANUAL{rec601, + key="ITU601", + title="Reccomendation {ITU-R} {BT}.601-5: Studio Encoding Parameters of + Digital Television for Standard 4:3 and Wide-Screen 16:9 Aspect Ratios", + edition="1982, revised", + organization="International Telecommunications Union", + address="1211 Geneva 20, Switzerland", + year=1995 +} + +@MANUAL{rec709, + key="ITU709", + title="Recommendation {ITU-R} {BT}.709-5: Parameter values for the {HDTV} + standards for production and international programme exchange", + edition="1990, revised", + organization="International Telecommunications Union", + address="1211 Geneva 20, Switzerland", + year=2002 +} + +@MANUAL{smpte170m, + key="SMPTE170M", + title="{SMPTE-170M}: Television --- Composite Analog Video Signal --- {NTSC} + for Studio Applications", + organization="Society of Motion Pciture and Television Engineers", + year=1994 +} + +@MANUAL{smpte240m, + key="SMPTE240M", + title="{SMPTE-240M}: Television --- Signal Parameters --- 1125-Line + High-Definition Production", + organization="Society of Motion Pciture and Television Engineers", + year=1999 +} + +@MANUAL{vorbis, + title="{Vorbis~I} specification", + organization="{Xiph.Org Foundation}", + year=2002, + note="\url{http://www.xiph.org/ogg/vorbis/doc/}" +} + +@MANUAL{rfc2119, + author="Scott Bradner", + title="{RFC} 2119: Key words for use in {RFC}s to Indicate Requirement + Levels", + month=mar, + year=1997, + note="\url{http://www.ietf.org/rfc/rfc2119.txt}" +} + +@MANUAL{rfc3533, + author="Silvia Pfeiffer", + title="{RFC} 3533: The {Ogg} Encapsulation Format Version 0", + month=may, + year=2003, + note="\url{http://www.ietf.org/rfc/rfc3533.txt}" +} + +@MANUAL{rfc3534, + author="Linus Walleij", + title="{RFC} 3534: The {application/ogg} Media Type", + month=may, + year=2003, + note="\url{http://www.ietf.org/rfc/rfc3534.txt}" +} + +@MANUAL{rfc3550, + author="H. Schulzrinne, S. Casner, R. Frederick, V. Jacobson", + title="RTP: A Transport Protocol for Real-Time Applications", + month=jul, + year=2003, + note="\url{http://www.ietf.org/rfc/rfc3550.txt}" +} diff --git a/libs/libtheora-1.1/doc/spec/spec.tex b/libs/libtheora-1.1/doc/spec/spec.tex new file mode 100644 index 00000000..da29ed58 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/spec.tex @@ -0,0 +1,8194 @@ +\documentclass[9pt,letterpaper]{book} + +\usepackage{latexsym} +\usepackage{amssymb} +\usepackage{amsmath} +\usepackage{bm} +\usepackage{textcomp} +\usepackage{graphicx} +\usepackage{booktabs} +\usepackage{tabularx} +\usepackage{longtable} +\usepackage{ltablex} +\usepackage{wrapfig} +\usepackage[pdfpagemode=None,pdfstartview=FitH,pdfview=FitH,colorlinks=true]% + {hyperref} + +\newtheorem{theorem}{Theorem}[section] +\newcommand{\idx}[1]{{\ensuremath{\mathit{#1}}}} +\newcommand{\qti}{\idx{qti}} +\newcommand{\qtj}{\idx{qtj}} +\newcommand{\pli}{\idx{pli}} +\newcommand{\plj}{\idx{plj}} +\newcommand{\qi}{\idx{qi}} +\newcommand{\ci}{\idx{ci}} +\newcommand{\bmi}{\idx{bmi}} +\newcommand{\bmj}{\idx{bmj}} +\newcommand{\qri}{\idx{qri}} +\newcommand{\qrj}{\idx{qrj}} +\newcommand{\hti}{\idx{hti}} +\newcommand{\sbi}{\idx{sbi}} +\newcommand{\bi}{\idx{bi}} +\newcommand{\bj}{\idx{bj}} +\newcommand{\mbi}{\idx{mbi}} +\newcommand{\mbj}{\idx{mbj}} +\newcommand{\mi}{\idx{mi}} +\newcommand{\cbi}{\idx{cbi}} +\newcommand{\qii}{\idx{qii}} +\newcommand{\ti}{\idx{ti}} +\newcommand{\tj}{\idx{tj}} +\newcommand{\rfi}{\idx{rfi}} +\newcommand{\zzi}{\idx{zzi}} +\newcommand{\ri}{\idx{ri}} +%This somewhat odd construct ensures that \bitvar{\qi}, etc., will set the +% qi in bold face, even though it is in a \mathit font, yet \bitvar{VAR} will +% set VAR in a bold, roman font. +\newcommand{\bitvar}[1]{\ensuremath{\mathbf{\bm{#1}}}} +\newcommand{\locvar}[1]{\ensuremath{\mathrm{#1}}} +\newcommand{\term}[1]{{\em #1}} +\newcommand{\bin}[1]{\ensuremath{\mathtt{b#1}}} +\newcommand{\hex}[1]{\ensuremath{\mathtt{0x#1}}} +\newcommand{\ilog}{\ensuremath{\mathop{\mathrm{ilog}}\nolimits}} +\newcommand{\round}{\ensuremath{\mathop{\mathrm{round}}\nolimits}} +\newcommand{\sign}{\ensuremath{\mathop{\mathrm{sign}}\nolimits}} +\newcommand{\lflim}{\ensuremath{\mathop{\mathrm{lflim}}\nolimits}} + +%Section-based table, figure, and equation numbering. +\numberwithin{equation}{chapter} +\numberwithin{figure}{chapter} +\numberwithin{table}{chapter} + +%Provide section numbering for \paragraph. +\makeatletter +\renewcommand{\paragraph}{\@startsection{paragraph}{4}{0ex}% + {-3.25ex plus -1ex minus -0.2ex}% + {1.5ex plus 0.2ex}% + {\normalfont\normalsize\bfseries}} +\makeatother +\stepcounter{secnumdepth} +\stepcounter{tocdepth} + +\keepXColumns + +\pagestyle{headings} +\bibliographystyle{alpha} + +\title{Theora Specification} +\author{Xiph.Org Foundation} +\date{\today} + + +\begin{document} + +\frontmatter + +\begin{titlepage} +\maketitle +\end{titlepage} +\thispagestyle{empty} +\cleardoublepage + +\pagenumbering{roman} + +\thispagestyle{plain} +\tableofcontents +\cleardoublepage + +\thispagestyle{plain} +\listoffigures +\cleardoublepage + +\thispagestyle{plain} +\listoftables +\cleardoublepage + +\thispagestyle{plain} +\markboth{{\sc Notation and Conventions}}{{\sc Notation and Conventions}} +\chapter*{Notation and Conventions} + +All parameters either passed in or out of a decoding procedure are given in + \bitvar{bold\ face}. + +The prefix \bin{} indicates that the following value is to be interpreted as a + binary number (base 2). +\begin{verse} +{\bf Example:} The value \bin{1110100} is equal to the decimal value 116. +\end{verse} + +The prefix \hex{} indicates the following value is to be interpreted as a + hexadecimal number (base 16). +\begin{verse} +{\bf Example:} The value \hex{74} is equal to the decimal value 116. +\end{verse} + +All arithmetic defined by this specification is exact. +However, any real numbers that do arise will always be converted back to + integers again in short order. +The entire specification can be implemented using only normal integer + operations. +All operations are to be implemented with sufficiently large integers so that + overflow cannot occur. +Where the result of a computation is to be truncated to a fixed-sized binary + representation, this will be explicitly noted. +The size given for all variables is the maximum number of bits needed to store + any value in that variable. +Intermediate computations involving that variable may require more bits. + +The following operators are defined: + +\begin{description} +\item[$|a|$] +The absolute value of a number $a$. +\begin{align*} +|a| & = \left\{\begin{array}{ll} +-a, & a < 0 \\ +a, & a \ge 0 +\end{array}\right. +\end{align*} + +\item[$a*b$] +Multiplication of a number $a$ by a number $b$. +\item[$\frac{a}{b}$] +Exact division of a number $a$ by a number $b$, producing a potentially + non-integer result. + +\item[$\left\lfloor a\right\rfloor$] +The largest integer less than or equal to a real number $a$. + +\item[$\left\lceil a\right\rceil$] +The smallest integer greater than or equal to a real number $a$. + +\item[$a//b$] +Integer division of $a$ by $b$. +\begin{align*} +a//b & = \left\{\begin{array}{ll} +\left\lceil\frac{a}{b}\right\rceil, & a < 0 \\ +\left\lfloor\frac{a}{b}\right\rfloor, & a \ge 0 +\end{array}\right. +\end{align*} + +\item[$a\%b$] +The remainder from the integer division of $a$ by $b$. +\begin{align*} +a\%b & = a-|b|*\left\lfloor\frac{a}{|b|}\right\rfloor +\end{align*} +Note that with this definition, the result is always non-negative and less than + $|b|$. + +\item[$a<>b$] +The value obtained by right-shifting the two's complement integer $a$ by $b$ + bits, filling in the leftmost bits of the new value with $0$ if $a$ is + non-negative and $1$ if $a$ is negative. +This is {\em not} equivalent to integer division of $a$ by $2^b$. +Instead, +\begin{align*} +a>>b & = \left\lfloor\frac{a}{2^b}\right\rfloor. +\end{align*} + +\item[$\round(a)$] +Rounds a number $a$ to the nearest integer, with ties rounded away from $0$. +\begin{align*} +\round(a) = \left\{\begin{array}{ll} +\lceil a-\frac{1}{2}\rceil & a \le 0 \\ +\lfloor a+\frac{1}{2}\rfloor & a > 0 +\end{array}\right. +\end{align*} + +\item[$\sign(a)$] +Returns the sign of a given number. +\begin{align*} +\sign(a) = \left\{\begin{array}{ll} +-1 & a < 0 \\ +0 & a = 0 \\ +1 & a > 0 +\end{array}\right. +\end{align*} + +\item[$\ilog(a)$] +The minimum number of bits required to store a positive integer $a$ in + two's complement notation, or $0$ for a non-positive integer $a$. +\begin{align*} +\ilog(a) = \left\{\begin{array}{ll} +0, & a \le 0 \\ +\left\lfloor\log_2{a}\right\rfloor+1, & a > 0 +\end{array}\right. +\end{align*} + +\begin{verse} +{\bf Examples:} +\begin{itemize} +\item $\ilog(-1)=0$ +\item $\ilog(0)=0$ +\item $\ilog(1)=1$ +\item $\ilog(2)=2$ +\item $\ilog(3)=2$ +\item $\ilog(4)=3$ +\item $\ilog(7)=3$ +\end{itemize} +\end{verse} + +\item[$\min(a,b)$] +The minimum of two numbers $a$ and $b$. + +\item[$\max(a,b)$] +The maximum of two numbers $a$ and $b$. + +\end{description} +\cleardoublepage + + +\thispagestyle{plain} +\markboth{{\sc Key words}}{{\sc Key words}} +\chapter*{Key words} + +%We can't rewrite this, because this is text required by RFC 2119, so we use +% some emergency stretching to get it typeset properly. +\setlength{\emergencystretch}{2em} +The key words ``MUST'', ``MUST NOT'', ``REQUIRED'', ``SHALL'', ``SHALL NOT'', + ``SHOULD'', ``SHOULD NOT'', ``RECOMMENDED'', ``MAY'', and ``OPTIONAL'' in this + document are to be intrepreted as described in RFC 2119 \cite{rfc2119}.\par +\setlength{\emergencystretch}{0em} + +Where such assertions are placed on the contents of a Theora bitstream itself, + implementations should be prepared to encounter bitstreams that do not follow + these requirements. +An application's behavior in the presecence of such non-conforming bitstreams + is not defined by this specification, but any reasonable method of handling + them MAY be used. +By way of example, applications MAY discard the current frame, retain the + current output thus far, or attempt to continue on by assuming some default + values for the erroneous bits. +When such an error occurs in the bitstream headers, an application MAY refuse + to decode the entire stream. +An application SHOULD NOT allow such non-conformant bitstreams to overflow + buffers and potentially execute arbitrary code, as this represents a serious + security risk. + +An application MUST, however, ensure any bits marked as reserved have the value + zero, and refuse to decode the stream if they do not. +These are used as place holders for future bitstream features with which the + current bitstream is forward-compatible. +Such features may not increment the bitstream version number, and can only be + recognized by checking the value of these reserved bits. + +\cleardoublepage + + + +\mainmatter + +\pagenumbering{arabic} +\setcounter{page}{1} + +\chapter{Introduction} + +Theora is a general purpose, lossy video codec. +It is based on the VP3 video codec produced by On2 Technologies + (\url{http://www.on2.com/}). +On2 donated the VP3.1 source code to the Xiph.Org Foundation and released it + under a BSD-like license. +On2 also made an irrevocable, royalty-free license grant for any patent claims + it might have over the software and any derivatives. +No formal specification exists for the VP3 format beyond this source code, + however Mike Melanson maintains a detailed description \cite{Mel04}. +Portions of this specification were adopted from that text with permission. + +\section{VP3 and Theora} + +Theora contains a superset of the features that were available in the original + VP3 codec. +Content encoded with VP3.1 can be losslessly transcoded into the Theora format. +Theora content cannot, in general, be losslessly transcoded into the VP3 + format. +If a feature is not available in the original VP3 format, this is mentioned + when that feature is defined. +A complete list of these features appears in Appendix~\ref{app:vp3-compat}. +%TODO: VP3 - theora comparison in appendix + +\section{Video Formats} + +Theora currently supports progressive video data of arbitrary dimensions at a + constant frame rate in one of several $Y'C_bC_r$ color spaces. +The precise definition the supported color spaces appears in + Section~\ref{sec:colorspaces}. +Three different chroma subsampling formats are supported: 4:2:0, 4:2:2, + and 4:4:4. +The precise details of each of these formats and their sampling locations are + described in Section~\ref{sec:pixfmts}. + +The Theora format does not support interlaced material, variable frame rates, + bit-depths larger than 8 bits per component, nor alternate color spaces such + as RGB or arbitrary multi-channel spaces. +Black and white content can be efficiently encoded, however, because the + uniform chroma planes compress well. +Support for interlaced material is planned for a future version. +\begin{verse} +{\bf Note:} Infrequently changing frame rates---as when film and video + sequences are cut together---can be supported in the Ogg container format by + chaining several Theora streams together. +\end{verse} +Support for increased bit depths or additional color spaces is not planned. + +\section{Classification} + +Theora is a block-based lossy transform codec that utilizes an + $8\times 8$ Type-II Discrete Cosine Transform and block-based motion + compensation. +This places it in the same class of codecs as MPEG-1, -2, -4, and H.263. +The details of how individual blocks are organized and how DCT coefficients are + stored in the bitstream differ substantially from these codecs, however. +Theora supports only intra frames (I frames in MPEG) and inter frames (P frames + in MPEG). +There is no equivalent to the bi-predictive frames (B frames) found in MPEG + codecs. + +\section{Assumptions} + +The Theora codec design assumes a complex, psychovisually-aware encoder and a + simple, low-complexity decoder. +%TODO: Talk more about implementation complexity. + +Theora provides none of its own framing, synchronization, or protection against + transmission errors. +An encoder is solely a method of accepting input video frames and + compressing these frames into raw, unformatted `packets'. +The decoder then accepts these raw packets in sequence, decodes them, and + synthesizes a fascimile of the original video frames. +Theora is a free-form variable bit rate (VBR) codec, and packets have no + minimum size, maximum size, or fixed/expected size. + +Theora packets are thus intended to be used with a transport mechanism that + provides free-form framing, synchronization, positioning, and error correction + in accordance with these design assumptions, such as Ogg (for file transport) + or RTP (for network multicast). +For the purposes of a few examples in this document, we will assume that Theora + is embedded in an Ogg stream specifically, although this is by no means a + requirement or fundamental assumption in the Theora design. + +The specification for embedding Theora into an Ogg transport stream is given in + Appendix~\ref{app:oggencapsulation}. + +\section{Codec Setup and Probability Model} + +Theora's heritage is the proprietary commerical codec VP3, and it retains a + fair amount of inflexibility when compared to Vorbis \cite{vorbis}, the first + Xiph.Org codec, which began as a research codec. +However, to provide additional scope for encoder improvement, Theora adopts + some of the configurable aspects of decoder setup that are present in Vorbis. +This configuration data is not available in VP3, which uses hardcoded values + instead. + +Theora makes the same controversial design decision that Vorbis made to include + the entire probability model for the DCT coefficients and all the quantization + parameters in the bitstream headers. +This is often several hundred fields. +It is therefore impossible to decode any frame in the stream without + having previously fetched the codec info and codec setup headers. + +\begin{verse} +{\bf Note:} Theora {\em can} initiate decode at an arbitrary intra-frame packet + within a bitstream so long as the codec has been initialized with the setup + headers. +\end{verse} + +Thus, Theora headers are both required for decode to begin and relatively large + as bitstream headers go. +The header size is unbounded, although as a rule-of-thumb less than 16kB is + recommended, and Xiph.Org's reference encoder follows this suggestion. +%TODO: Is 8kB enough? My setup header is 7.4kB, that doesn't leave much room +% for comments. +%RG: the lesson from vorbis is that as small as possible is really +% important in some applications. Practically, what's acceptable +% depends a great deal on the target bitrate. I'd leave 16 kB in the +% spec for now. fwiw more than 1k of comments is quite unusual. + +Our own design work indicates that the primary liability of the required header + is in mindshare; it is an unusual design and thus causes some amount of + complaint among engineers as this runs against current design trends and + points out limitations in some existing software/interface designs. +However, we find that it does not fundamentally limit Theora's suitable + application space. + +%silvia: renamed +%\subsection{Format Specification} +\section{Format Conformance} + +The Theora format is well-defined by its decode specification; any encoder that + produces packets that are correctly decoded by an implementation following + this specification may be considered a proper Theora encoder. +A decoder must faithfully and completely implement the specification defined + herein %, except where noted, + to be considered a conformant Theora decoder. +A decoder need not be implemented strictly as described, but the + actual decoder process MUST be {\em entirely mathematically equivalent} + to the described process. +Where appropriate, a non-normative description of encoder processes is + included. +These sections will be marked as such, and a proper Theora encoder is not + bound to follow them. + +%TODO: \subsection{Hardware Profile} + + +\chapter{Coded Video Structure} + +Theora's encoding and decoding process is based on $8\times 8$ blocks of + pixels. +This sections describes how a video frame is laid out, divided into + blocks, and how those blocks are organized. + +\section{Frame Layout} + +A video frame in Theora is a two-dimensional array of pixels. +Theora, like VP3, uses a right-handed coordinate system, with the origin in the + lower-left corner of the frame. +This is contrary to many video formats which use a left-handed coordinate + system with the origin in the upper-left corner of the frame. +%INT: This means that for interlaced material, the definition of `even fields' +%INT: and `odd fields' may be reversed between Theora and other video codecs. +%INT: This document will always refer to them as `top fields' and `bottom +%INT: fields'. + +Theora divides the pixel array up into three separate \term{color planes}, one + for each of the $Y'$, $C_b$, and $C_r$ components of the pixel. +The $Y'$ plane is also called the \term{luma plane}, and the $C_b$ and $C_r$ + planes are also called the \term{chroma planes}. +Each plane is assigned a numerical value, as shown in + Table~\ref{tab:color-planes}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{cl}\toprule +Index & Color Plane \\\midrule +$0$ & $Y'$ \\ +$1$ & $C_b$ \\ +$2$ & $C_r$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Color Plane Indices} +\label{tab:color-planes} +\end{table} + +In some pixel formats, the chroma planes are subsampled by a factor of two + in one or both directions. +This means that the width or height of the chroma planes may be half that of + the total frame width and height. +The luma plane is never subsampled. + +\section{Picture Region} + +An encoded video frame in Theora is required to have a width and height that + are multiples of sixteen, making an integral number of blocks even when the + chroma planes are subsampled. +However, inside a frame a smaller \term{picture region} may be defined + to present material whose dimensions are not a multiple of sixteen pixels, as + shown in Figure~\ref{fig:pic-frame}. +The picture region can be offset from the lower-left corner of the frame by up + to 255 pixels in each direction, and may have an arbitrary width and height, + provided that it is contained entirely within the coded frame. +It is this picture region that contains the actual video data. +The portions of the frame which lie outside the picture region may contain + arbitrary image data, so the frame must be cropped to the picture region + before display. +The picture region plays no other role in the decode process, which operates on + the entire video frame. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{pic-frame} +\end{center} +\caption{Location of frame and picture regions} +\label{fig:pic-frame} +\end{figure} + +\section{Blocks and Super Blocks} +\label{sec:blocks-and-sbs} + +Each color plane is subdivided into \term{blocks} of $8\times 8$ pixels. +Blocks are grouped into $4\times 4$ arrays called \term{super blocks} as + shown in Figure~\ref{fig:superblock}. +Each color plane has its own set of blocks and super blocks. +If the chroma planes are subsampled, they are still divided into $8\times 8$ + blocks of pixels; there are just fewer blocks than in the luma plane. +The boundaries of blocks and super blocks in the luma plane do not necessarily + coincide with those of the chroma planes, if the chroma planes have been + subsampled. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{superblock} +\end{center} +\caption{Subdivision of a frame into blocks and super blocks} +\label{fig:superblock} +\end{figure} + +Blocks are accessed in two different orders in the various decoder processes. +The first is \term{raster order}, illustrated in Figure~\ref{fig:raster-block}. +This accesses each block in row-major order, starting in the lower left of the + frame and continuing along the bottom row of the entire frame, followed by the + next row up, starting on the left edge of the frame, etc. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{raster-block} +\end{center} +\caption{Raster ordering of $n\times m$ blocks} +\label{fig:raster-block} +\end{figure} + +The second is \term{coded order}. +In coded order, blocks are accessed by super block. +Within each frame, super blocks are traversed in raster order, + similar to raster order for blocks. +Within each super block, however, blocks are accessed in a Hilbert curve + pattern, illustrated in Figure~\ref{fig:hilbert-block}. +If a color plane does not contain a complete super block on the top or right + sides, the same ordering is still used, simply with any blocks outside the + frame boundary ommitted. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{hilbert-block} +\end{center} +\caption{Hilbert curve ordering of blocks within a super block} +\label{fig:hilbert-block} +\end{figure} + +To illustrate this ordering, consider a frame that is 240 pixels wide and + 48 pixels high. +Each row of the luma plane has 30 blocks and 8 super blocks, and there are 6 + rows of blocks and two rows of super blocks. + +%When accessed in raster order, each block in the luma plane is assigned the +% following indices: + +%\vspace{\baselineskip} +%\begin{center} +%\begin{tabular}{|ccccccc|}\hline +%150 & 151 & 152 & 153 & $\ldots$ & 178 & 179 \\ +%120 & 121 & 122 & 123 & $\ldots$ & 148 & 149 \\\hline +% 90 & 91 & 92 & 93 & $\ldots$ & 118 & 119 \\ +% 60 & 61 & 62 & 63 & $\ldots$ & 88 & 89 \\ +% 30 & 31 & 32 & 33 & $\ldots$ & 58 & 59 \\ +% 0 & 1 & 2 & 3 & $\ldots$ & 28 & 29 \\\hline +%\end{tabular} +%\end{center} +%\vspace{\baselineskip} + +When accessed in coded order, each block in the luma plane is assigned the + following indices: + +\vspace{\baselineskip} +\begin{center} +\begin{tabular}{|cccc|c|cc|}\hline +123 & 122 & 125 & 124 & $\ldots$ & 179 & 178 \\ +120 & 121 & 126 & 127 & $\ldots$ & 176 & 177 \\\hline + 5 & 6 & 9 & 10 & $\ldots$ & 117 & 118 \\ + 4 & 7 & 8 & 11 & $\ldots$ & 116 & 119 \\ + 3 & 2 & 13 & 12 & $\ldots$ & 115 & 114 \\ + 0 & 1 & 14 & 15 & $\ldots$ & 112 & 113 \\\hline +\end{tabular} +\end{center} +\vspace{\baselineskip} + +Here the index values specify the order in which the blocks would be accessed. +The indices of the blocks are numbered continuously from one color plane to the + next. +They do not reset to zero at the start of each plane. +Instead, the numbering increases continuously from the $Y'$ plane to the $C_b$ + plane to the $C_r$ plane. +The implication is that the blocks from all planes are treated as a unit during + the various processing steps. + +Although blocks are sometimes accessed in raster order, in this document the + index associated with a block is {\em always} its index in coded order. + +\section{Macro Blocks} +\label{sec:mbs} + +A macro block contains a $2\times 2$ array of blocks in the luma plane + {\em and} the co-located blocks in the chroma planes, as shown in + Figure~\ref{fig:macroblock}. +Thus macro blocks can represent anywhere from six to twelve blocks, depending + on how the chroma planes are subsampled. +This is in contrast to super blocks, which only contain blocks from a single + color plane. +% the whole super vs. macro blocks thing is a little confusing, and it can be +% hard to remember which is what initially. A figure would/will help here, +% but I tried to add some text emphasizing the difference in terms of +% functionality. +%TBT: At this point we haven't described any functionality yet. +%TBT: As far as the reader knows, the only purpose of the blocks, macro blocks +%TBT: and super blocks is for data organization---and for blocks and super +%TBT: blocks, this is essentially true. +%TBT: So lets restrict the differences we emphasize to those of data +%TBT: organization, which the sentence I just added above does. +Macro blocks contain information about coding mode and motion vectors for the + corresponding blocks in all color planes. + +\begin{figure}[htbp] + \begin{center} + \includegraphics{macroblock} + \end{center} + \caption{Subdivision of a frame into macro blocks} + \label{fig:macroblock} +\end{figure} + +Macro blocks are also accessed in a \term{coded order}. +This coded order proceeds by examining each super block in the luma plane in + raster order, and traversing the four macro blocks inside using a smaller + Hilbert curve, as shown in Figure~\ref{fig:hilbert-mb}. +%r: I rearranged the wording to make a more formal idiom here +If the luma plane does not contain a complete super block on the top or right + sides, the same ordering is still used, with any macro blocks outside + the frame boundary simply omitted. +Because the frame size is constrained to be a multiple of 16, there are never + any partial macro blocks. +Unlike blocks, macro blocks need never be accessed in a pure raster order. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{hilbert-mb} +\end{center} +\caption{Hilbert curve ordering of macro blocks within a super block} +\label{fig:hilbert-mb} +\end{figure} + +Using the same frame size as the example above, there are 15 macro blocks in + each row and 3 rows of macro blocks. +The macro blocks are assigned the following indices: + +\vspace{\baselineskip} +\begin{center} +\begin{tabular}{|cc|cc|c|cc|c|}\hline +30 & 31 & 32 & 33 & $\cdots$ & 42 & 43 & 44 \\\hline + 1 & 2 & 5 & 6 & $\cdots$ & 25 & 26 & 29 \\ + 0 & 3 & 4 & 7 & $\cdots$ & 24 & 27 & 28 \\\hline +\end{tabular} +\end{center} +\vspace{\baselineskip} + +\section{Coding Modes and Prediction} + +Each block is coded using one of a small, fixed set of \term{coding modes} that + define how the block is predicted from previous frames. +A block is predicted using one of two \term{reference frames}, selected + according to the coding mode. +A reference frame is the fully decoded version of a previous frame in the + stream. +The first available reference frame is the previous intra frame, called the + \term{golden frame}. +The second available reference frame is the previous frame, whether it was an + intra frame or an inter frame. +If the previous frame was an intra frame, then both reference frames are the + same. +See Figure~\ref{fig:reference-frames} for an illustration of the reference + frames used for an intra frame that does not follow an intra frame. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{reference-frames} +\end{center} +\caption{Example of reference frames for an inter frame} +\label{fig:reference-frames} +\end{figure} + +Two coding modes in particular are worth mentioning here. +The INTRA mode is used for blocks that are not predicted from either reference + frame. +This is the only coding mode allowed in intra frames. +The INTER\_NOMV coding mode uses the co-located contents of the block in the + previous frame as the predictor. +This is the default coding mode. + +\section{DCT Coefficients} +\label{sec:dct-coeffs} + +A \term{residual} is added to the predicted contents of a block to form the + final reconstruction. +The residual is stored as a set of quantized coefficients from an integer + approximation of a two-dimensional Type II Discrete Cosine Transform. +The DCT takes an $8\times 8$ array of pixel values as input and returns an + $8\times 8$ array of coefficient values. +The \term{natural ordering} of these coefficients is defined to be row-major + order, from lowest to highest frequency. +They are also often indexed in \term{zig-zag order}, as shown in + Figure~\ref{tab:zig-zag}. + +\begin{figure}[htbp] +\begin{center} +\begin{tabular}[c]{rr|c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c@{}c} + &\multicolumn{1}{r}{} & && &&&&&$c$&&& && && \\ + &\multicolumn{1}{r}{} &0&&1&&2&&3&&4&&5&&6&&7 \\\cline{3-17} + &0 & 0 &$\rightarrow$& 1 && 5 &$\rightarrow$& 6 && 14 &$\rightarrow$& 15 && 27 &$\rightarrow$& 28 \\[-0.5\defaultaddspace] + & & &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$& \\ + &1 & 2 & & 4 && 7 & & 13 && 16 & & 26 && 29 & & 42 \\[-0.5\defaultaddspace] + & &$\downarrow$&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&$\downarrow$ \\ + &2 & 3 & & 8 && 12 & & 17 && 25 & & 30 && 41 & & 43 \\[-0.5\defaultaddspace] + & & &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$& \\ + &3 & 9 & & 11 && 18 & & 24 && 31 & & 40 && 44 & & 53 \\[-0.5\defaultaddspace] +$r$&&$\downarrow$&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&$\downarrow$ \\ + &4 & 10 & & 19 && 23 & & 32 && 39 & & 45 && 52 & & 54 \\[-0.5\defaultaddspace] + & & &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$& \\ + &5 & 20 & & 22 && 33 & & 38 && 46 & & 51 && 55 & & 60 \\[-0.5\defaultaddspace] + & &$\downarrow$&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&&$\swarrow$&&$\nearrow$&$\downarrow$ \\ + &6 & 21 & & 34 && 37 & & 47 && 50 & & 56 && 59 & & 61 \\[-0.5\defaultaddspace] + & & &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$&&$\nearrow$& &$\swarrow$& \\ + &7 & 35 &$\rightarrow$& 36 && 48 &$\rightarrow$& 49 && 57 &$\rightarrow$& 58 && 62 &$\rightarrow$& 63 +\end{tabular} +\end{center} +\caption{Zig-zag order} +\label{tab:zig-zag} +\end{figure} + +\begin{verse} +{\bf Note:} the row and column indices refer to {\em frequency number} and not + pixel locations. +The frequency numbers are defined independently of the memory organization of + the pixels. +They have been written from top to bottom here to follow conventional notation, + despite the right-handed coordinate system Theora uses for pixel locations. +%RG: I'd rather we were internally consistent and put dc at the lower left. +Many implementations of the DCT operate `in-place'. +That is, they return DCT coefficients in the same memory buffer that the + initial pixel values were stored in. +Due to the right-handed coordinate system used for pixel locations in Theora, + one must note carefully how both pixel values and DCT coefficients are + organized in memory in such a system. +\end{verse} + +DCT coefficient $(0,0)$ is called the \term{DC coefficient}. +All the other coefficients are called \term{AC coefficients}. + + +\chapter{Decoding Overview} + +This section provides a high level description of the Theora codec's + construction. +A bit-by-bit specification appears beginning in Section~\ref{sec:bitpacking}. +The later sections assume a high-level understanding of the Theora decode + process, which is provided below. + +\section{Decoder Configuration} + +Decoder setup consists of configuration of the quantization matrices and the + Huffman codebooks for the DCT coefficients, and a table of limit values for + the deblocking filter. +The remainder of the decoding pipeline is not configurable. + +\subsection{Global Configuration} + +The global codec configuration consists of a few video related fields, such as + frame rate, frame size, picture size and offset, aspect ratio, color space, + pixel format, and a version number. +The version number is divided into a major version, a minor version, amd a + minor revision number. +%r: afaik the released vp3 codec called itself 3.1 and is compatible w/ theora +%r: even though we received the in-progress 3.2 codebase +For the format defined in this specification, these are `3', `2', and + `1', respectively, in reference to Theora's origin as a successor to + the VP3.1 format. + +\subsection{Quantization Matrices} + +Theora allows up to 384 different quantization matrices to be defined, one for + each \term{quantization type}, \term{color plane} ($Y'$, $C_b$, or $C_r$), and + \term{quantization index}, \qi, which ranges from zero to 63, inclusive. +There are currently two quantization types defined, which depend on the coding + mode of the block being dequantized, as shown in Table~\ref{tab:quant-types}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{cl}\toprule +Quantization Type & Usage \\\midrule +$0$ & INTRA-mode blocks \\ +$1$ & Blocks in any other mode. \\ +\bottomrule\end{tabular} +\end{center} +\caption{Quantization Type Indices} +\label{tab:quant-types} +\end{table} + +%r: I think 'nominally' is more specific than 'generally' here +The quantization index, on the other hand, nominally represents a progressive + range of quality levels, from low quality near zero to high quality near 63. +However, the interpretation is arbitrary, and it is possible, for example, to + partition the scale into two completely separate ranges with 32 levels each + that are meant to represent different classes of source material, or any + other arrangement that suits the encoder's requirements. + +Each quantization matrix is an $8\times 8$ matrix of 16-bit values, which is + used to quantize the output of the $8\times 8$ DCT\@. +Quantization matrices are specified using three components: a + \term{base matrix} and two \term{scale values}. +The first scale value is the \term{DC scale}, which is applied to the DC + component of the base matrix. +The second scale value is the \term{AC scale}, which is applied to all the + other components of the base matrix. +There are 64 DC scale values and 64 AC scale values, one for each \qi\ value. + +There are 64 elements in each base matrix, one for each DCT coefficient. +They are stored in natural order (cf. Section~\ref{sec:dct-coeffs}). +There is a separate set of base matrices for each quantization type and each + color plane, with up to 64 possible base matrices in each set, one for each + \qi\ value. +%r: we will mention that the given matricies must bound the \qi range +%r: in the detailed section. it's not important at this level. +Typically the bitstream contains matrices for only a sparse subset of the + possible \qi\ values. +The base matrices for the remainder of the \qi\ values are computed using + linear interpolation. +This configuration allows the encoder to adjust the quantization matrices to + approximate the complex, non-linear response of the human visual system to + different quantization errors. + +Finally, because the in-loop deblocking filter strength depends on the strength + of the quantization matrices defined in this header, a table of 64 \term{loop + filter limit values} is defined, one for each \qi\ value. + +The precise specification of how all of this information is decoded appears in + Section~\ref{sub:loop-filter-limits} and Section~\ref{sub:quant-params}. + +\subsection{Huffman Codebooks} + +Theora uses 80 configurable binary Huffman codes to represent the 32 tokens + used to encode DCT coefficients. +Each of the 32 token values has a different semantic meaning and is used to + represent single coefficient values, zero runs, combinations of the two, and + \term{End-Of-Block markers}. + +The 80 codes are divided up into five groups of 16, with each group + corresponding to a set of DCT coefficient indices. +The first group corresponds to the DC coefficient, while the remaining four + groups correspond to different subsets of the AC coefficients. +Within each frame, two pairs of 4-bit codebook indices are stored. +The first pair selects which codebooks to use from the DC coefficient group for + the $Y'$ coefficients and the $C_b$ and $C_r$ coefficients. +The second pair selects which codebooks to use from {\em all four} of the AC + coefficient groups for the $Y'$ coefficients and the $C_b$ and $C_r$ + coefficients. + +The precise specification of how the codebooks are decoded appears in + Section~\ref{sub:huffman-tables}. + +\section{High-Level Decode Process} + +\subsection{Decoder Setup} + +Before decoding can begin, a decoder MUST be initialized using the bitstream + headers corresponding to the stream to be decoded. +Theora uses three header packets; all are required, in order, by this + specification. +Once set up, decode may begin at any intra-frame packet---or even inter-frame + packets, provided the appropriate decoded reference frames have already been + decoded and cached---belonging to the Theora stream. +In Theora I, all packets after the three initial headers are intra-frame or + inter-frame packets. + +The header packets are, in order, the identification header, the comment + header, and the setup header. + +\paragraph{Identification Header} + +The identification header identifies the stream as Theora, provides a version + number, and defines the characteristics of the video stream such as frame + size. +A complete description of the identification header appears in + Section~\ref{sec:idheader}. + +\paragraph{Comment Header} + +The comment header includes user text comments (`tags') and a vendor string + for the application/library that produced the stream. +The format of the comment header is the same as that used in the Vorbis I and + Speex codecs, with slight modifications due to the use of a different bit + packing mechanism. +A complete description of how the comment header is coded appears in + Section~\ref{sec:commentheader}, along with a suggested set of tags. + +\paragraph{Setup Header} + +The setup header includes extensive codec setup information, including the + complete set of quantization matrices and Huffman codebooks needed to decode + the DCT coefficients. +A complete description of the setup header appears in + Section~\ref{sec:setupheader}. + +\subsection{Decode Procedure} + +The decoding and synthesis procedure for all video packets is fundamentally the + same, with some steps omitted for intra frames. +\begin{itemize} +\item +Decode packet type flag. +\item +Decode frame header. +\item +Decode coded block information (inter frames only). +\item +Decode macro block mode information (inter frames only). +\item +Decode motion vectors (inter frames only). +\item +Decode block-level \qi\ information. +\item +Decode DC coefficient for each coded block. +\item +Decode 1st AC coefficient for each coded block. +\item +Decode 2nd AC coefficient for each coded block. +\item +$\ldots$ +\item +Decode 63rd AC coefficient for each coded block. +\item Perform DC coefficient prediction. +\item Reconstruct coded blocks. +\item Copy uncoded bocks. +\item Perform loop filtering. +\end{itemize} + +\begin{verse} +{\bf Note:} clever rearrangement of the steps in this process is possible. +As an example, in a memory-constrained environment, one can make multiple + passes through the DCT coefficients to avoid buffering them all in memory. +On the first pass, the starting location of each coefficient is identified, and + then 64 separate get pointers are used to read in the 64 DCT coefficients + required to reconstruct each coded block in sequence. +This operation produces entirely equivalent output and is naturally perfectly + legal. +It may even be a benefit in non-memory-constrained environments due to a + reduced cache footprint. +\end{verse} + +Theora makes equivalence easy to check by defining all decoding operations in + terms of exact integer operations. +No floating-point math is required, and in particular, the implementation of + the iDCT transform MUST be followed precisely. +This prevents the decoder mismatch problem commonly associated with codecs that + provide a less rigorous transform specification. +Such a mismatch problem would be devastating to Theora, since a single rounding + error in one frame could propagate throughout the entire succeeding frame due + to DC prediction. + +\paragraph{Packet Type Decode} + +Theora uses four packet types. +The first three packet types mark each of the three Theora headers described + above. +The fourth packet type marks a video packet. +All other packet types are reserved; packets marked with a reserved type should + be ignored. + +Additionally, zero-length packets are treated as if they were an inter +frame with no blocks coded. That is, as a duplicate frame. + +\paragraph{Frame Header Decode} + +The frame header contains some global information about the current frame. +The first is the frame type field, which specifies if this is an intra frame or + an inter frame. +Inter frames predict their contents from previously decoded reference frames. +Intra frames can be independently decoded with no established reference frames. + +The next piece of information in the frame header is the list of \qi\ values + allowed in the frame. +Theora allows from one to three different \qi\ values to be used in a single + frame, each of which selects a set of six quantization matrices, one for each + quantization type (inter or intra), and one for each color plane. +The first \qi\ value is {\em always} used when dequantizing DC coefficients. +The \qi\ value used when dequantizing AC coefficients, however, can vary from + block to block. +VP3, in contrast, only allows a single \qi\ value per frame for both the DC and + AC coefficients. + +\paragraph{Coded Block Information} + +This stage determines which blocks in the frame are coded and which are + uncoded. +A \term{coded block list} is constructed which lists all the coded blocks in + coded order. +For intra frames, every block is coded, and so no data needs to be read from + the packet. + +\paragraph{Macro Block Mode Information} + +For intra frames, every block is coded in INTRA mode, and this stage is + skipped. +In inter frames a \term{coded macro block list} is constructed from the coded + block list. +Any macro block which has at least one of its luma blocks coded is considered + coded; all other macro blocks are uncoded, even if they contain coded chroma + blocks. +A coding mode is decoded for each coded macro block, and assigned to all its + constituent coded blocks. +All coded chroma blocks in uncoded macro blocks are assigned the INTER\_NOMV + coding mode. + +\paragraph{Motion Vectors} + +Intra frames are coded entirely in INTRA mode, and so this stage is skipped. +Some inter coding modes, however, require one or more motion vectors to be + specified for each macro block. +These are decoded in this stage, and an appropriate motion vector is assigned + to each coded block in the macro block. + +\paragraph{Block-Level \qi\ Information} + +If a frame allows multiple \qi\ values, the \qi\ value assigned to each block + is decoded here. +Frames that use only a single \qi\ value have nothing to decode. + +\paragraph{DCT Coefficients} + +Finally, the quantized DCT coefficients are decoded. +A list of DCT coefficients in zig-zag order for a single block is represented + by a list of tokens. +A token can take on one of 32 different values, each with a different semantic + meaning. +A single token can represent a single DCT coefficient, a run of zero + coefficients within a single block, a combination of a run of zero + coefficients followed by a single non-zero coefficient, an + \term{End-Of-Block marker}, or a run of EOB markers. +EOB markers signify that the remainder of the block is one long zero run. +Unlike JPEG and MPEG, there is no requirement for each block to end with + a special marker. +If non-EOB tokens yield values for all 64 of the coefficients in a block, then + no EOB marker occurs. + +Each token is associated with a specific \term{token index} in a block. +For single-coefficient tokens, this index is the zig-zag index of the token in + the block. +For zero-run tokens, this index is the zig-zag index of the {\em first} + coefficient in the run. +For combination tokens, the index is again the zig-zag index of the first + coefficient in the zero run. +For EOB markers, which signify that the remainder of the block is one long zero + run, the index is the zig-zag index of the first zero coefficient in that run. +For EOB runs, the token index is that of the first EOB marker in the run. +Due to zero runs and EOB markers, a block does not have to have a token for + every zig-zag index. + +Tokens are grouped in the stream by token index, not by the block they + originate from. +This means that for each zig-zag index in turn, the tokens with that index from + {\em all} the coded blocks are coded in coded block order. +When decoding, a current token index is maintained for each coded block. +This index is advanced by the number of coefficients that are added to the + block as each token is decoded. +After fully decoding all the tokens with token index \ti, the current token + index of every coded block will be \ti\ or greater. + +If an EOB run of $n$ blocks is decoded at token index \ti, then it ends the + next $n$ blocks in coded block order whose current token index is equal to + \ti, but not greater. +If there are fewer than $n$ blocks with a current token index of \ti, then the + decoder goes through the coded block list again from the start, ending blocks + with a current token index of $\ti+1$, and so on, until $n$ blocks have been + ended. + +Tokens are read by parsing a Huffman code that depends on \ti\ and the color + plane of the next coded block whose current token index is equal to \ti, but + not greater. +The Huffman codebooks are selected on a per-frame basis from the 80 codebooks + defined in the setup header. +Many tokens have a fixed number of \term{extra bits} associated with them. +These bits are read from the packet immediately after the token is decoded. +These are used to define things such as coefficient magnitude, sign, and the + length of runs. + +\paragraph{DC Prediction} + +After the coefficients for each block are decoded, the quantized DC value of + each block is adjusted based on the DC values of its neighbors. +This adjustment is performed by scanning the blocks in raster order, not coded + block order. + +\paragraph{Reconstruction} + +Finally, using the coding mode, motion vector (if applicable), quantized + coefficient list, and \qi\ value defined for each block, all the coded blocks + are reconstructed. +The DCT coefficients are dequantized, an inverse DCT transform is applied, and + the predictor is formed from the coding mode and motion vector and added to + the result. + +\paragraph{Loop Filtering} + +To complete the reconstructed frame, an ``in-loop'' deblocking filter is + applied to the edges of all coded blocks. + + +\chapter{Video Formats} + +This section gives a precise description of the video formats that Theora is + capable of storing. +The Theora bitstream is capable of handling video at any arbitrary resolution + up to $1048560\times 1048560$. +Such video would require almost three terabytes of storage per frame for + uncompressed data, so compliant decoders MAY refuse to decode images with + sizes beyond their capabilities. +%TODO: What MUST a "compliant" decoder accept? +%TODO: What SHOULD a decoder use for an upper bound? (derive from total amount +%TODO: of memory and memory bandwidth) +%TODO: Any lower limits? +%TODO: We really need hardware device profiles, but such things should be +%TODO: developed with input from the hardware community. +%TODO: And even then sometimes they're useless + +The remainder of this section talks about two specific aspects of the video + format: the color space and the pixel format. +The first describes how color is represented and how to transform that color + representation into a device independent color space such as CIE $XYZ$ (1931). +The second describes the various schemes for sampling the color values in time + and space. + +\section{Color Space Conventions} + +There are a large number of different color standards used in digital video. +Since Theora is a lossy codec, it restricts itself to only a few of them to + simplify playback. +Unlike the alternate method of describing all the parameters of the color + model, this allows a few dedicated routines for color conversion to be written + and heavily optimized in a decoder. +More flexible conversion functions should instead be specified in an encoder, + where additional computational complexity is more easily tolerated. +The color spaces were selected to give a fair representation of color standards + in use around the world today. +Most of the standards that do not exactly match one of these can be converted + to one fairly easily. + +All Theora color spaces are $Y'C_bC_r$ color spaces with one luma channel and + two chroma channels. +Each channel contains 8-bit discrete values in the range $0\ldots255$, which + represent non-linear gamma pre-corrected signals. +The Theora identification header contains an 8-bit value that describes the + color space. +This merely selects one of the color spaces available from an enumerated list. +Currently, only two color spaces are defined, with a third possibility that + indicates the color space is ``unknown". + +\section{Color Space Conversions and Parameters} +\label{sec:color-xforms} + +The parameters which describe the conversions between each color space are + listed below. +These are the parameters needed to map colors from the encoded $Y'C_bC_r$ + representation to the device-independent color space CIE $XYZ$ (1931). +These parameters define abstract mathematical conversion functions which are + infinitely precise. +The accuracy and precision with which the conversions are performed in a real + system is determined by the quality of output desired and the available + processing power. +Exact decoder output is defined by this specification only in the original + $Y'C_bC_r$ space. + +\begin{description} +\item[$Y'C_bC_r$ to $Y'P_bP_r$:] +\vspace{\baselineskip}\hfill + +This conversion takes 8-bit discrete values in the range $[0\ldots255]$ and + maps them to real values in the range $[0\ldots1]$ for Y and + $[-\frac{1}{2}\ldots\frac{1}{2}]$ for $P_b$ and $P_r$. +Because some values may fall outside the offset and excursion defined for each + channel in the $Y'C_bC_r$ space, the results may fall outside these ranges in + $Y'P_bP_r$ space. +No clamping should be done at this stage. + +\begin{align} +Y'_\mathrm{out} & = + \frac{Y'_\mathrm{in}-\mathrm{Offset}_Y}{\mathrm{Excursion}_Y} \\ +P_b & = + \frac{C_b-\mathrm{Offset}_{C_b}}{\mathrm{Excursion}_{C_b}} \\ +P_r & = + \frac{C_r-\mathrm{Offset}_{C_r}}{\mathrm{Excursion}_{C_r}} +\end{align} + +Parameters: $\mathrm{Offset}_{Y,C_b,C_r}$, $\mathrm{Excursion}_{Y,C_b,C_r}$. + +\item[$Y'P_bP_r$ to $R'G'B'$:] +\vspace{\baselineskip}\hfill + +This conversion takes the one luma and two chroma channel representation and + maps it to the non-linear $R'G'B'$ space used to drive actual output devices. +Values should be clamped into the range $[0\ldots1]$ after this stage. + +\begin{align} +R' & = Y'+2(1-K_r)P_r \\ +G' & = Y'-2\frac{(1-K_b)K_b}{1-K_b-K_r}P_b-2\frac{(1-K_r)K_r}{1-K_b-K_r}P_r\\ +B' & = Y'+2(1-K_b)P_b +\end{align} + +Parameters: $K_b,K_r$. + +\item[$R'G'B'$ to $RGB$ (Output device gamma correction):] +\vspace{\baselineskip}\hfill + +This conversion takes the non-linear $R'G'B'$ voltage levels and maps them to + linear light levels produced by the actual output device. +Note that this conversion is only that of the output device, and its inverse is + {\em not} that used by the input device. +Because a dim viewing environment is assumed in most television standards, the + overall gamma between the input and output devices is usually around $1.1$ to + $1.2$, and not a strict $1.0$. + +For calibration with actual output devices, the model +\begin{align} +L & =(E'+\Delta)^\gamma +\end{align} + should be used, with $\Delta$ the free parameter and $\gamma$ held fixed to + the value specified in this document. +The conversion function presented here is an idealized version with $\Delta=0$. + +\begin{align} +R & = R'^\gamma \\ +G & = G'^\gamma \\ +B & = B'^\gamma +\end{align} + +Parameters: $\gamma$. + +\item[$RGB$ to $R'G'B'$ (Input device gamma correction):] +\vspace{\baselineskip}\hfill + +%TODO: Tag section as non-normative + +This conversion takes linear light levels and maps them to the non-linear + voltage levels produced in the actual input device. +This information is merely informative. +It is not required for building a decoder or for converting between the various + formats and the actual output capabilities of a particular device. + +A linear segment is introduced on the low end to reduce noise in dark areas of + the image. +The rest of the scale is adjusted so that the power segment of the curve + intersects the linear segment with the proper slope, and so that it still maps + 0 to 0 and 1 to 1. + +\begin{align} +R' & = \left\{ +\begin{array}{ll} +\alpha R, & 0\le R<\delta \\ +(1+\epsilon)R^\beta-\epsilon, & \delta\le R\le1 +\end{array}\right. \\ +G' & = \left\{ +\begin{array}{ll} +\alpha G, & 0\le G<\delta \\ +(1+\epsilon)G^\beta-\epsilon, & \delta\le G\le1 +\end{array}\right. \\ +B' & = \left\{ +\begin{array}{ll} +\alpha B, & 0\le B<\delta \\ +(1+\epsilon)B^\beta-\epsilon, & \delta\le B\le1 +\end{array}\right. +\end{align} + +Parameters: $\beta$, $\alpha$, $\delta$, $\epsilon$. + +\item[$RGB$ to CIE $XYZ$ (1931):] +\vspace{\baselineskip}\hfill + +This conversion maps a device-dependent linear RGB space to the + device-independent linear CIE $XYZ$ space. +The parameters are the CIE chromaticity coordinates of the three + primaries---red, green, and blue---as well as the chromaticity coordinates + of the white point of the device. +This is how hardware manufacturers and standards typically describe a + particular $RGB$ space. +The math required to convert these parameters into a useful transformation + matrix is reproduced below. + +\begin{align} +F & = +\left[\begin{array}{ccc} +\frac{x_r}{y_r} & \frac{x_g}{y_g} & \frac{x_b}{y_b} \\ +1 & 1 & 1 \\ +\frac{1-x_r-y_r}{y_r} & \frac{1-x_g-y_g}{y_g} & \frac{1-x_b-y_b}{y_b} +\end{array}\right] \\ +\left[\begin{array}{c} +s_r \\ +s_g \\ +s_b +\end{array}\right] & = +F^{-1}\left[\begin{array}{c} +\frac{x_w}{y_w} \\ +1 \\ +\frac{1-x_w-y_w}{y_w} +\end{array}\right] \\ +\left[\begin{array}{c} +X \\ +Y \\ +Z +\end{array}\right] & = +F\left[\begin{array}{c} +s_rR \\ +s_gG \\ +s_bB +\end{array}\right] +\end{align} +Parameters: $x_r,x_g,x_b,x_w, y_r,y_g,y_b,y_w$. + +\end{description} + +\section{Available Color Spaces} +\label{sec:colorspaces} + +These are the color spaces currently defined for use by Theora video. +Each one has a short name, with which it is referred to in this document, and + a more detailed specification of the standards from which its parameters are + derived. +Some standards do not specify all the parameters necessary. +For these unspecified parameters, this document serves as the definition of + what should be used when encoding or decoding Theora video. + +\subsection{Rec.~470M (Rec.~ITU-R~BT.470-6 System M/NTSC with + Rec.~ITU-R~BT.601-5)} +\label{sec:470m} + +This color space is used by broadcast television and DVDs in much of the + Americas, Japan, Korea, and the Union of Myanmar \cite{rec470}. +This color space may also be used for System M/PAL (Brazil), with an + appropriate conversion supplied by the encoder to compensate for the + different gamma value. +See Section~\ref{sec:470bg} for an appropriate gamma value to assume for M/PAL + input. + +In the US, studio monitors are adjusted to a D65 white point + ($x_w,y_w=0.313,0.329$). +In Japan, studio monitors are adjusted to a D white of 9300K + ($x_w,y_w=0.285,0.293$). + +Rec.~470 does not specify a digital encoding of the color signals. +For Theora, Rec.~ITU-R~BT.601-5 \cite{rec601} is used, starting from the + $R'G'B'$ signals specified by Rec.~470. + +Rec.~470 does not specify an input gamma function. +For Theora, the Rec.~709 \cite{rec709} input function is assumed. +This is the same as that specified by SMPTE 170M \cite{smpte170m}, which claims + to reflect modern practice in the creation of NTSC signals circa 1994. + +The parameters for all the color transformations defined in + Section~\ref{sec:color-xforms} are given in Table~\ref{tab:470m}. + +\begin{table}[htb] +\begin{align*} +\mathrm{Offset}_{Y,C_b,C_r} & = (16, 128, 128) \\ +\mathrm{Excursion}_{Y,C_b,C_r} & = (219, 224, 224) \\ +K_r & = 0.299 \\ +K_b & = 0.114 \\ +\gamma & = 2.2 \\ +\beta & = 0.45 \\ +\alpha & = 4.5 \\ +\delta & = 0.018 \\ +\epsilon & = 0.099 \\ +x_r,y_r & = 0.67, 0.33 \\ +x_g,y_g & = 0.21, 0.71 \\ +x_b,y_b & = 0.14, 0.08 \\ +\text{(Illuminant C) } x_w,y_w & = 0.310, 0.316 \\ +\end{align*} +\caption{Rec.~470M Parameters} +\label{tab:470m} +\end{table} + +\subsection{Rec.~470BG (Rec.~ITU-R~BT.470-6 Systems B and G with + Rec.~ITU-R~BT.601-5)} +\label{sec:470bg} + +This color space is used by the PAL and SECAM systems in much of the rest of + the world \cite{rec470} +This can be used directly by systems (B, B1, D, D1, G, H, I, K, N)/PAL and (B, + D, G, H, K, K1, L)/SECAM\@. + +\begin{verse} +{\bf Note:} the Rec.~470BG chromaticity values are different from those + specified in Rec.~470M\@. +When PAL and SECAM systems were first designed, they were based upon the same + primaries as NTSC\@. +However, as methods of making color picture tubes have changed, the primaries + used have changed as well. +The U.S. recommends using correction circuitry to approximate the existing, + standard NTSC primaries. +Current PAL and SECAM systems have standardized on primaries in accord with + more recent technology. +\end{verse} + +Rec.~470 provisionally permits the use of the NTSC chromaticity values (given + in Section~\ref{sec:470m}) with legacy PAL and SECAM equipment. +In Theora, material must be decoded assuming the new PAL and SECAM primaries. +Material intended for display on old legacy devices should be converted by the + decoder. + +The official Rec.~470BG specifies a gamma value of $\gamma=2.8$. +However, in practice this value is unrealistically high \cite{Poyn97}. +Rec.~470BG states that the overall system gamma should be approximately + $\gamma\beta=1.2$. +Since most cameras pre-correct with a gamma value of $\beta=0.45$, + this suggests an output device gamma of approximately $\gamma=2.67$. +This is the value recommended for use with PAL systems in Theora. + +Rec.~470 does not specify a digital encoding of the color signals. +For Theora, Rec.~ITU-R~BT.601-5 \cite{rec601} is used, starting from the + $R'G'B'$ signals specified by Rec.~470. + +Rec.~470 does not specify an input gamma function. +For Theora, the Rec 709 \cite{rec709} input function is assumed. + +The parameters for all the color transformations defined in + Section~\ref{sec:color-xforms} are given in Table~\ref{tab:470bg}. + +\begin{table}[htb] +\begin{align*} +\mathrm{Offset}_{Y,C_b,C_r} & = (16, 128, 128) \\ +\mathrm{Excursion}_{Y,C_b,C_r} & = (219, 224, 224) \\ +K_r & = 0.299 \\ +K_b & = 0.114 \\ +\gamma & = 2.67 \\ +\beta & = 0.45 \\ +\alpha & = 4.5 \\ +\delta & = 0.018 \\ +\epsilon & = 0.099 \\ +x_r,y_r & = 0.64, 0.33 \\ +x_g,y_g & = 0.29, 0.60 \\ +x_b,y_b & = 0.15, 0.06 \\ +\text{(D65) } x_w,y_w & = 0.313, 0.329 \\ +\end{align*} +\caption{Rec.~470BG Parameters} +\label{tab:470bg} +\end{table} + +\section{Pixel Formats} +\label{sec:pixfmts} + +Theora supports several different pixel formats, each of which uses different + subsampling for the chroma planes relative to the luma plane. +A decoder may need to recover a full resolution chroma plane with samples + co-sited with the luma plane in order to convert to RGB for display or perform + other processing. +Decoders can assume that the chroma signal satisfies the Nyquist-Shannon + sampling theorem. +The ideal low-pass reconstruction filter this implies is not practical, but any + suitable approximation can be used, depending on the available computing + power. +Decoders MAY simply use a box filter, assigning to each luma sample the chroma + sample closest to it. +Encoders would not go wrong in assuming that this will be the most common + approach. + +\subsection{4:4:4 Subsampling} +\label{sec:444} + +All three color planes are stored at full resolution---each pixel has a $Y'$, + a $C_b$ and a $C_r$ value (see Figure~\ref{fig:pixel444}). +The samples in the different planes are all at co-located sites. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{pixel444} +\end{center} +\caption{Pixels encoded 4:4:4} +\label{fig:pixel444} +\end{figure} + +% Figure. +%YRB YRB +% +% +% +%YRB YRB +% +% +% + + +\subsection{4:2:2 Subsampling} +\label{sec:422} + +The $C_b$ and $C_r$ planes are stored with half the horizontal resolution of + the $Y'$ plane. +Thus, each of these planes has half the number of horizontal blocks as the luma + plane (see Figure~\ref{fig:pixel422}). +Similarly, they have half the number of horizontal super blocks, rounded up. +Macro blocks are defined across color planes, and so their number does not + change, but each macro block contains half as many chroma blocks. + +The chroma samples are vertically aligned with the luma samples, but + horizontally centered between two luma samples. +Thus, each luma sample has a unique closest chroma sample. +A horizontal phase shift may be required to produce signals which use different + horizontal chroma sampling locations for compatibility with different systems. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{pixel422} +\end{center} +\caption{Pixels encoded 4:2:2} +\label{fig:pixel422} +\end{figure} + +% Figure. +%Y RB Y Y RB Y +% +% +% +%Y RB Y Y RB Y +% +% +% + +\subsection{4:2:0 Subsampling} +\label{sec:420} + +The $C_b$ and $C_r$ planes are stored with half the horizontal and half the + vertical resolution of the $Y'$ plane. +Thus, each of these planes has half the number of horizontal blocks and half + the number of vertical blocks as the luma plane, for a total of one quarter + the number of blocks (see Figure~\ref{fig:pixel420}). +Similarly, they have half the number of horizontal super blocks and half the + number of vertical super blocks, rounded up. +Macro blocks are defined across color planes, and so their number does not + change, but each macro block contains within it one quarter as many + chroma blocks. + +The chroma samples are vertically and horizontally centered between four luma + samples. +Thus, each luma sample has a unique closest chroma sample. +This is the same sub-sampling pattern used with JPEG, MJPEG, and MPEG-1, and + was inherited from VP3. +A horizontal or vertical phase shift may be required to produce signals which + use different chroma sampling locations for compatibility with different + systems. + +\begin{figure}[htbp] +\begin{center} +\includegraphics{pixel420} +\end{center} +\caption{Pixels encoded 4:2:0} +\label{fig:pixel420} +\end{figure} + +% Figure. +%Y Y Y Y +% +% RB RB +% +%Y Y Y Y +% +% +% +%Y Y Y Y +% +% RB RB +% +%Y Y Y Y +% +% +% + +\subsection{Subsampling and the Picture Region} + +Although the frame size must be an integral number of macro blocks, and thus + both the number of pixels and the number of blocks in each direction must be + even, no such requirement is made of the picture region. +Thus, when using subsampled pixel formats, careful attention must be paid to + which chroma samples correspond to which luma samples. + +As mentioned above, for each pixel format, there is a unique chroma sample that + is the closest to each luma sample. +When cropping the chroma planes to the picture region, all the chroma samples + corresponding to a luma sample in the cropped picture region must be included. +Thus, when dividing the width or height of the picture region by two to obtain + the size of the subsampled chroma planes, they must be rounded up. + +Furthermore, the sampling locations are defined relative to the frame, + {\em not} the picture region. +When using the 4:2:2 and 4:2:0 formats, the locations of chroma samples + relative to the luma samples depends on whether or not the X offset of the + picture region is odd. +If the offset is even, each column of chroma samples corresponds to two columns + of luma samples (see Figure~\ref{fig:pic_even} for an example). +The only exception is if the width is odd, in which case the last column + corresponds to only one column of luma samples (see Figure~\ref{fig:pic_even_odd}). +If the offset is odd, then the first column of chroma samples corresponds to + only one column of luma samples, while the remaining columns each correspond + to two (see Figure~\ref{fig:pic_odd}). +In this case, if the width is even, the last column again corresponds to only + one column of luma samples (see Figure~\ref{fig:pic_odd_even}). + +A similar process is followed with the rows of a picture region of odd height + encoded in the 4:2:0 format. +If the Y offset is even, each row of chroma samples corresponds to two rows of + luma samples (see Figure~\ref{fig:pic_even}), except with an odd height, where + the last row corresponds to one row of chroma luna samples only (see + Figure~\ref{fig:pic_even_odd}). +If the offset is odd, then it is the first row of chroma samples which + corresponds to only one row of luma samples, while the remaining rows each + correspond to two (Figure~\ref{fig:pic_odd}), except with an even height, + where the last row also corresponds to one (Figure~\ref{fig:pic_odd_even}). + +Encoders should be aware of these differences in the subsampling when using an + even or odd offset. +In the typical case, with an even width and height, where one expects two rows + or columns of luma samples for every row or column of chroma samples, the + encoder must take care to ensure that the offsets used are both even. + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{pic_even} +\end{center} +\caption{Pixel correspondence between color planes with even picture + offset and even picture size} +\label{fig:pic_even} +\end{figure} + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{pic_even_odd} +\end{center} +\caption{Pixel correspondence with even picture offset and + odd picture size} +\label{fig:pic_even_odd} +\end{figure} + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{pic_odd} +\end{center} +\caption{Pixel correspondence with odd picture offset and + odd picture size} +\label{fig:pic_odd} +\end{figure} + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{pic_odd_even} +\end{center} +\caption{Pixel correspondence with odd picture offset and + even picture size} +\label{fig:pic_odd_even} +\end{figure} + + +\chapter{Bitpacking Convention} +\label{sec:bitpacking} + +\section{Overview} + +The Theora codec uses relatively unstructured raw packets containing + binary integer fields of arbitrary width. +Logically, each packet is a bitstream in which bits are written one-by-one by + the encoder and then read one-by-one in the same order by the decoder. +Most current binary storage arrangements group bits into a native storage unit + of eight bits (octets), sixteen bits, thirty-two bits, or less commonly other + fixed sizes. +The Theora bitpacking convention specifies the correct mapping of the logical + packet bitstream into an actual representation in fixed-width units. + +\subsection{Octets and Bytes} + +In most contemporary architectures, a `byte' is synonymous with an `octect', + that is, eight bits. +For purposes of the bitpacking convention, a byte implies the smallest native + integer storage representation offered by a platform. +Modern file systems invariably offer bytes as the fundamental atom of storage. + +The most ubiquitous architectures today consider a `byte' to be an octet. +Note, however, that the Theora bitpacking convention is still well defined for + any native byte size; an implementation can use the native bit-width of a + given storage system. +This document assumes that a byte is one octet for purposes of example only. + +\subsection{Words and Byte Order} + +A `word' is an integer size that is a grouped multiple of the byte size. +Most architectures consider a word to be a group of two, four, or eight bytes. +Each byte in the word can be ranked by order of `significance', e.g.\ the + significance of the bits in each byte when storing a binary integer in the + word. +Several byte orderings are possible in a word. +The common ones are +\begin{itemize} +\item{Big-endian:} +in which the most significant byte comes first, e.g.\ 3-2-1-0, +\item{Little-endian:} +in which the least significant byte comes first, e.g.\ 0-1-2-3, and +\item{Mixed-endian:} +one of the less-common orderings that cannot be put into the above two + categories, e.g.\ 3-1-2-0 or 0-2-1-3. +\end{itemize} + +The Theora bitpacking convention specifies storage and bitstream manipulation + at the byte, not word, level. +Thus host word ordering is of a concern only during optimization, when writing + code that operates on a word of storage at a time rather than a byte. +Logically, bytes are always encoded and decoded in order from byte zero through + byte $n$. + +\subsection{Bit Order} + +A byte has a well-defined `least significant' bit (LSb), which is the only bit + set when the byte is storing the two's complement integer value $+1$. +A byte's `most significant' bit (MSb) is at the opposite end. +Bits in a byte are numbered from zero at the LSb to $n$ for the MSb, where + $n=7$ in an octet. + +\section{Coding Bits into Bytes} + +The Theora codec needs to encode arbitrary bit-width integers from zero to 32 + bits wide into packets. +These integer fields are not aligned to the boundaries of the byte + representation; the next field is read at the bit position immediately + after the end of the previous field. + +The decoder logically unpacks integers by first reading the MSb of a binary + integer from the logical bitstream, followed by the next most significant + bit, etc., until the required number of bits have been read. +When unpacking the bytes into bits, the decoder begins by reading the MSb of + the integer to be read from the most significant unread bit position of the + source byte, followed by the next-most significant bit position of the + destination integer, and so on up to the requested number of bits. +Note that this differs from the Vorbis I codec, which + begins decoding with the LSb of the source integer, reading it from the + LSb of the source byte. +When all the bits of the current source byte are read, decoding continues with + the MSb of the next byte. +Any unfilled bits in the last byte of the packet MUST be cleared to zero by the + encoder. + +\subsection{Signedness} + +The binary integers decoded by the above process may be either signed or + unsigned. +This varies from integer to integer, and this specification + indicates how each value should be interpreted as it is read. +That is, depending on context, the three bit binary pattern \bin{111} can be + taken to represent either `$7$' as an unsigned integer or `$-1$' as a signed, + two's complement integer. + +\subsection{Encoding Example} + +The following example shows the state of an (8-bit) byte stream after several + binary integers are encoded, including the location of the put pointer for the + next bit to write to and the total length of the stream in bytes. + +Encode the 4 bit unsigned integer value `12' (\bin{1100}) into an empty byte + stream. + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{}& &&&&$\downarrow$&&&& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & \textbf{0} & \textbf{0} & + 0 & 0 & 0 & 0 & $\leftarrow$ \\ +byte 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +byte 2 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +byte 3 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +\multicolumn{1}{c|}{$\vdots$}&\multicolumn{8}{c}{$\vdots$}& \\ +byte $n$ & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 1 byte +\end{tabular} +\vspace{\baselineskip} + +Continue by encoding the 3 bit signed integer value `-1' (\bin{111}). + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{} &&&&&&&&$\downarrow$& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & \textbf{0} & \textbf{0} & + \textbf{1} & \textbf{1} & \textbf{1} & 0 & $\leftarrow$ \\ +byte 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +byte 2 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +byte 3 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +\multicolumn{1}{c|}{$\vdots$}&\multicolumn{8}{c}{$\vdots$}& \\ +byte $n$ & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 1 byte +\end{tabular} +\vspace{\baselineskip} + +Continue by encoding the 7 bit integer value `17' (\bin{0010001}). + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{} &&&&&&&$\downarrow$&& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & \textbf{0} & \textbf{0} & + \textbf{1} & \textbf{1} & \textbf{1} & \textbf{0} & \\ +byte 1 & \textbf{0} & \textbf{1} & \textbf{0} & \textbf{0} & + \textbf{0} & \textbf{1} & 0 & 0 & $\leftarrow$ \\ +byte 2 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +byte 3 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & \\ +\multicolumn{1}{c|}{$\vdots$}&\multicolumn{8}{c}{$\vdots$}& \\ +byte $n$ & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 2 bytes +\end{tabular} +\vspace{\baselineskip} + +Continue by encoding the 13 bit integer value `6969' (\bin{11011\ 00111001}). + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{} &&&&$\downarrow$&&&&& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & \textbf{0} & \textbf{0} & + \textbf{1} & \textbf{1} & \textbf{1} & \textbf{0} & \\ +byte 1 & \textbf{0} & \textbf{1} & \textbf{0} & \textbf{0} & + \textbf{0} & \textbf{1} & \textbf{1} & \textbf{1} & \\ +byte 2 & \textbf{0} & \textbf{1} & \textbf{1} & \textbf{0} & + \textbf{0} & \textbf{1} & \textbf{1} & \textbf{1} & \\ +byte 3 & \textbf{0} & \textbf{0} & \textbf{1} & + 0 & 0 & 0 & 0 & 0 & $\leftarrow$ \\ +\multicolumn{1}{c|}{$\vdots$}&\multicolumn{8}{c}{$\vdots$}& \\ +byte $n$ & 0 & 0 & 0 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 4 bytes +\end{tabular} +\vspace{\baselineskip} + +\subsection{Decoding Example} + +The following example shows the state of the (8-bit) byte stream encoded in the + previous example after several binary integers are decoded, including the + location of the get pointer for the next bit to read. + +Read a two bit unsigned integer from the example encoded above. + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{} &&&$\downarrow$&&&&&& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & 0 & 0 & 1 & 1 & 1 & 0 & $\leftarrow$ \\ +byte 1 & 0 & 1 & 0 & 0 & 0 & 1 & 1 & 1 & \\ +byte 2 & 0 & 1 & 1 & 0 & 0 & 1 & 1 & 1 & \\ +byte 3 & 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 4 bytes +\end{tabular} +\vspace{\baselineskip} + +Value read: 3 (\bin{11}). + +Read another two bit unsigned integer from the example encoded above. + +\begin{tabular}{r|ccccccccl} +\multicolumn{1}{r}{} &&&&&$\downarrow$&&&& \\ + & 7 & 6 & 5 & 4 & 3 & 2 & 1 & 0 & \\\cline{1-9} +byte 0 & \textbf{1} & \textbf{1} & \textbf{0} & \textbf{0} & + 1 & 1 & 1 & 0 & $\leftarrow$ \\ +byte 1 & 0 & 1 & 0 & 0 & 0 & 1 & 1 & 1 & \\ +byte 2 & 0 & 1 & 1 & 0 & 0 & 1 & 1 & 1 & \\ +byte 3 & 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 & +byte stream length: 4 bytes +\end{tabular} +\vspace{\baselineskip} + +Value read: 0 (\bin{00}). + +Two things are worth noting here. +\begin{itemize} +\item +Although these four bits were originally written as a single four-bit integer, + reading some other combination of bit-widths from the bitstream is well + defined. +No artificial alignment boundaries are maintained in the bitstream. +\item +The first value is the integer `$3$' only because the context stated we were + reading an unsigned integer. +Had the context stated we were reading a signed integer, the returned value + would have been the integer `$-1$'. +\end{itemize} + +\subsection{End-of-Packet Alignment} + +The typical use of bitpacking is to produce many independent byte-aligned + packets which are embedded into a larger byte-aligned container structure, + such as an Ogg transport bitstream. +Externally, each bitstream encoded as a byte stream MUST begin and end on a + byte boundary. +Often, the encoded packet bitstream is not an integer number of bytes, and so + there is unused space in the last byte of a packet. + +%r: I think the generality here is necessary to be consistent with our assertions +%r: elsewhere about being independent of transport and byte width +When a Theora encoder produces packets for embedding in a byte-aligned + container, unused space in the last byte of a packet is always zeroed during + the encoding process. +Thus, should this unused space be read, it will return binary zeroes. +There is no marker pattern or stuffing bits that will allow the decoder to + obtain the exact size, in bits, of the original bitstream. +This knowledge is not required for decoding. + +Attempting to read past the end of an encoded packet results in an + `end-of-packet' condition. +Any further read operations after an `end-of-packet' condition shall also + return `end-of-packet'. +Unlike Vorbis, Theora does not use truncated packets as a normal mode of + operation. +Therefore if a decoder encounters the `end-of-packet' condition during normal + decoding, it may attempt to use the bits that were read to recover as much of + encoded data as possible, signal a warning or error, or both. + +\subsection{Reading Zero Bit Integers} + +Reading a zero bit integer returns the value `$0$' and does not increment + the stream pointer. +Reading to the end of the packet, but not past the end, so that an + `end-of-packet' condition is not triggered, and then reading a zero bit + integer shall succeed, returning `$0$', and not trigger an `end-of-packet' + condition. +Reading a zero bit integer after a previous read sets the `end-of-packet' + condition shall fail, also returning `end-of-packet'. + +\chapter{Bitstream Headers} +\label{sec:headers} + +A Theora bitstream begins with three header packets. +The header packets are, in order, the identification header, the comment + header, and the setup header. +All are required for decode compliance. +An end-of-packet condition encountered while decoding the identification or + setup header packets renders the stream undecodable. +An end-of-packet condition encountered while decode the comment header is a + non-fatal error condition, and MAY be ignored by a decoder. + +\paragraph{VP3 Compatibility} + +VP3 relies on the headers provided by its container, usually either AVI or + Quicktime. +As such, several parameters available in these headers are not available to VP3 + streams. +These are indicated as they appear in the sections below. + +\section{Common Header Decode} +\label{sub:common-header} + +\begin{figure}[Htbp] +\begin{center} +\begin{verbatim} + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | header type | `t' | `h' | `e' | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | `o' | `r' | `a' | data... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | ... header-specific data ... | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +\end{verbatim} +\end{center} +\caption{Common Header Packet Layout} +\label{fig:commonheader} +\end{figure} + + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{HEADERTYPE} & Integer & 8 & No & The type of the header being + decoded. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:} None. +\medskip + +Each header packet begins with the same header fields, which are decoded as + follows: + +\begin{enumerate} +\item +Read an 8-bit unsigned integer as \bitvar{HEADERTYPE}. +If the most significant bit of this integer is not set, then stop. +This is not a header packet. +\item +Read 6 8-bit unsigned integers. +If these do not have the values \hex{74}, \hex{68}, \hex{65}, \hex{6F}, + \hex{72}, and \hex{61}, respectively, then stop. +This stream is not decodable by this specification. +These values correspond to the ASCII values of the characters `t', `h', `e', + `o', `r', and `a'. +\end{enumerate} + +Decode continues according to \bitvar{HEADERTYPE}. +The identification header is type \hex{80}, the comment header is type + \hex{81}, and the setup header is type \hex{82}. +These packets must occur in the order: identification, comment, setup. +%r: I clarified the initial-bit scheme here +%TBT: Dashes let the reader know they'll have to pick up the rest of the +%TBT: sentence after the explanatory phrase. +%TBT: Otherwise it just sounds like the bit must exist. +All header packets have the most significant bit of the type + field---which is the initial bit in the packet---set. +This distinguishes them from video data packets in which the first bit + is unset. +% extra header packets are a feature Dan argued for way back when for +% backward-compatible extensions (and icc colourspace for example) +% I think it's reasonable +%TBT: You can always just stick more stuff in the setup header. +Packets with other header types (\hex{83}--\hex{FF}) are reserved and MUST be + ignored. + +\section{Identification Header Decode} +\label{sec:idheader} + +\begin{figure}[Htbp] +\begin{center} +\begin{verbatim} + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | 0x80 | `t' | `h' | `e' | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | `o' | `r' | `a' | VMAJ | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | VMIN | VREV | FMBW | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | FMBH | PICW... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | ...PICW | PICH | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | PICX | PICY | FRN... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | ...FRN | FRD... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | ...FRD | PARN... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | ...PARN | PARD | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | CS | NOMBR | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | QUAL | KFGSHIFT| PF| Res | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +\end{verbatim} +\end{center} +\caption{Identification Header Packet} +\label{fig:idheader} +\end{figure} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{VMAJ} & Integer & 8 & No & The major version number. \\ +\bitvar{VMIN} & Integer & 8 & No & The minor version number. \\ +\bitvar{VREV} & Integer & 8 & No & The version revision number. \\ +\bitvar{FMBW} & Integer & 16 & No & The width of the frame in macro + blocks. \\ +\bitvar{FMBH} & Integer & 16 & No & The height of the frame in macro + blocks. \\ +\bitvar{NSBS} & Integer & 32 & No & The total number of super blocks in a + frame. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{NMBS} & Integer & 32 & No & The total number of macro blocks in a + frame. \\ +\bitvar{PICW} & Integer & 20 & No & The width of the picture region in + pixels. \\ +\bitvar{PICH} & Integer & 20 & No & The height of the picture region in + pixels. \\ +\bitvar{PICX} & Integer & 8 & No & The X offset of the picture region in + pixels. \\ +\bitvar{PICY} & Integer & 8 & No & The Y offset of the picture region in + pixels. \\ +\bitvar{FRN} & Integer & 32 & No & The frame-rate numerator. \\ +\bitvar{FRD} & Integer & 32 & No & The frame-rate denominator. \\ +\bitvar{PARN} & Integer & 24 & No & The pixel aspect-ratio numerator. \\ +\bitvar{PARD} & Integer & 24 & No & The pixel aspect-ratio denominator. \\ +\bitvar{CS} & Integer & 8 & No & The color space. \\ +\bitvar{PF} & Integer & 2 & No & The pixel format. \\ +\bitvar{NOMBR} & Integer & 24 & No & The nominal bitrate of the stream, in + bits per second. \\ +\bitvar{QUAL} & Integer & 6 & No & The quality hint. \\ +\bitvar{KFGSHIFT} & Integer & 5 & No & The amount to shift the key frame + number by in the granule position. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:} None. +\medskip + +The identification header is a short header with only a few fields used to + declare the stream definitively as Theora and provide detailed information + about the format of the fully decoded video data. +The identification header is decoded as follows: + +\begin{enumerate} +\item +Decode the common header fields according to the procedure described in + Section~\ref{sub:common-header}. +If \bitvar{HEADERTYPE} returned by this procedure is not \hex{80}, then stop. +This packet is not the identification header. +\item +Read an 8-bit unsigned integer as \bitvar{VMAJ}. +If \bitvar{VMAJ} is not $3$, then stop. +This stream is not decodable according to this specification. +\item +Read an 8-bit unsigned integer as \bitvar{VMIN}. +If \bitvar{VMIN} is not $2$, then stop. +This stream is not decodable according to this specification. +\item +Read an 8-bit unsigned integer as \bitvar{VREV}. +If \bitvar{VREV} is greater than $1$, then this stream +may contain optional features or interpretational changes +documented in a future version of this specification. +Regardless of the value of \bitvar{VREV}, the stream is decodable +according to this specification. +\item +Read a 16-bit unsigned integer as \bitvar{FMBW}. +This MUST be greater than zero. +This specifies the width of the coded frame in macro blocks. +The actual width of the frame in pixels is $\bitvar{FMBW}*16$. +\item +Read a 16-bit unsigned integer as \bitvar{FMBH}. +This MUST be greater than zero. +This specifies the height of the coded frame in macro blocks. +The actual height of the frame in pixels is $\bitvar{FMBH}*16$. +\item +Read a 24-bit unsigned integer as \bitvar{PICW}. +This MUST be no greater than $(\bitvar{FMBW}*16)$. +Note that 24 bits are read, even though only 20 bits are sufficient to specify + any value of the picture width. +This is done to preserve octet alignment in this header, to allow for a + simplified parser implementation. +\item +Read a 24-bit unsigned integer as \bitvar{PICH}. +This MUST be no greater than $(\bitvar{FMBH}*16)$. +Together with \bitvar{PICW}, this specifies the size of the displayable picture + region within the coded frame. +See Figure~\ref{fig:pic-frame}. +Again, 24 bits are read instead of 20. +\item +Read an 8-bit unsigned integer as \bitvar{PICX}. +This MUST be no greater than $(\bitvar{FMBW}*16-\bitvar{PICX})$. +\item +Read an 8-bit unsigned integer as \bitvar{PICY}. +This MUST be no greater than $(\bitvar{FMBH}*16-\bitvar{PICY})$. +Together with \bitvar{PICX}, this specifies the location of the lower-left + corner of the displayable picture region. +See Figure~\ref{fig:pic-frame}. +\item +Read a 32-bit unsigned integer as \bitvar{FRN}. +This MUST be greater than zero. +\item +Read a 32-bit unsigned integer as \bitvar{FRD}. +This MUST be greater than zero. +Theora is a fixed-frame rate video codec. +Frames are sampled at the constant rate of $\frac{\bitvar{FRN}}{\bitvar{FRD}}$ + frames per second. +The presentation time of the first frame is at zero seconds. +No mechanism is provided to specify a non-zero offset for the initial + frame. +\item +Read a 24-bit unsigned integer as \bitvar{PARN}. +\item +Read a 24-bit unsigned integer as \bitvar{PARD}. +Together with \bitvar{PARN}, these specify the aspect ratio of the pixels + within a frame, defined as the ratio of the physical width of a pixel to its + physical height. +This is given by the ratio $\bitvar{PARN}:\bitvar{PARD}$. +If either of these fields are zero, this indicates that pixel aspect ratio + information was not available to the encoder. +In this case it MAY be specified by the application via an external means, or + a default value of $1:1$ MAY be used. +\item +Read an 8-bit unsigned integer as \bitvar{CS}. +This is a value from an enumerated list of the available color spaces, given in + Table~\ref{tab:colorspaces}. +The `Undefined' value indicates that color space information was not available + to the encoder. +It MAY be specified by the application via an external means. +If a reserved value is given, a decoder MAY refuse to decode the stream. +\begin{table}[htbp] +\begin{center} +\begin{tabular*}{215pt}{cl@{\extracolsep{\fill}}c}\toprule +Value & Color Space \\\midrule +$0$ & Undefined. \\ +$1$ & Rec.~470M (see Section~\ref{sec:470m}). \\ +$2$ & Rec.~470BG (see Section~\ref{sec:470bg}). \\ +$3$ & Reserved. \\ +$\vdots$ & \\ +$255$ & \\ +\bottomrule\end{tabular*} +\end{center} +\caption{Enumerated List of Color Spaces} +\label{tab:colorspaces} +\end{table} +\item +Read a 24-bit unsigned integer as \bitvar{NOMBR} signifying a rate in bits +per second. Rates equal to or greater than $2^{24}-1$ bits per second are +represented as $2^{24}-1$. +The \bitvar{NOMBR} field is used only as a hint. +For pure VBR streams, this value may be considerably off. +The field MAY be set to zero to indicate that the encoder did not care to +speculate. +\item +Read a 6-bit unsigned integer as \bitvar{QUAL}. +This value is used to provide a hint as to the relative quality of the stream + when compared to others produced by the same encoder. +Larger values indicate higher quality. +This can be used, for example, to select among several streams containing the + same material encoded with different settings. +\item +Read a 5-bit unsigned integer as \bitvar{KFGSHIFT}. +The \bitvar{KFGSHIFT} is used to partition the granule position associated with + each packet into two different parts. +The frame number of the last key frame, starting from zero, is stored in the + upper $64-\bitvar{KFGSHIFT}$ bits, while the lower \bitvar{KFGSHIFT} bits + contain the number of frames since the last keyframe. +Complete details on the granule position mapping are specified in Section~REF. +\item +Read a 2-bit unsigned integer as \bitvar{PF}. +The \bitvar{PF} field contains a value from an enumerated list of the available + pixel formats, given in Table~\ref{tab:pixel-formats}. +If the reserved value $1$ is given, stop. +This stream is not decodable according to this specification. + +\begin{table}[htbp] +\begin{center} +\begin{tabular*}{215pt}{cl@{\extracolsep{\fill}}c}\toprule +Value & Pixel Format \\\midrule +$0$ & 4:2:0 (see Section~\ref{sec:420}). \\ +$1$ & Reserved. \\ +$2$ & 4:2:2 (see Section~\ref{sec:422}). \\ +$3$ & 4:4:4 (see Section~\ref{sec:444}). \\ +\bottomrule\end{tabular*} +\end{center} +\caption{Enumerated List of Pixel Formats} +\label{tab:pixel-formats} +\end{table} + +\item +Read a 3-bit unsigned integer. +These bits are reserved. +If this value is not zero, then stop. +This stream is not decodable according to this specification. +\item +Assign \bitvar{NSBS} a value according to \bitvar{PF}, as given by + Table~\ref{tab:nsbs-for-pf}. + +\begin{table}[bt] +\begin{center} +\begin{tabular}{cc}\toprule +\bitvar{PF} & \bitvar{NSBS} \\\midrule +$0$ & $\begin{aligned} +&((\bitvar{FMBW}+1)//2)*((\bitvar{FMBH}+1)//2)\\ +& +2*((\bitvar{FMBW}+3)//4)*((\bitvar{FMBH}+3)//4) +\end{aligned}$ \\\midrule +$2$ & $\begin{aligned} +&((\bitvar{FMBW}+1)//2)*((\bitvar{FMBH}+1)//2)\\ +& +2*((\bitvar{FMBW}+3)//4)*((\bitvar{FMBH}+1)//2) +\end{aligned}$ \\\midrule +$3$ & $3*((\bitvar{FMBW}+1)//2)*((\bitvar{FMBH}+1)//2)$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Number of Super Blocks for each Pixel Format} +\label{tab:nsbs-for-pf} +\end{table} + +\item +Assign \bitvar{NBS} a value according to \bitvar{PF}, as given by + Table~\ref{tab:nbs-for-pf}. + +\begin{table}[tb] +\begin{center} +\begin{tabular}{cc}\toprule +\bitvar{PF} & \bitvar{NBS} \\\midrule +$0$ & $6*\bitvar{FMBW}*\bitvar{FMBH}$ \\\midrule +$2$ & $8*\bitvar{FMBW}*\bitvar{FMBH}$ \\\midrule +$3$ & $12*\bitvar{FMBW}*\bitvar{FMBH}$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Number of Blocks for each Pixel Format} +\label{tab:nbs-for-pf} +\end{table} + +\item +Assign \bitvar{NMBS} the value $(\bitvar{FMBW}*\bitvar{FMBH})$. + +\end{enumerate} + +\paragraph{VP3 Compatibility} + +VP3 does not correctly handle frame sizes that are not a multiple of 16. +Thus, \bitvar{PICW} and \bitvar{PICH} should be set to the frame width and + height in pixels, respectively, and \bitvar{PICX} and \bitvar{PICY} should be + set to zero. +VP3 headers do not specify a color space. +VP3 only supports the 4:2:0 pixel format. + +\section{Comment Header} +\label{sec:commentheader} + +The Theora comment header is the second of three header packets that begin a + Theora stream. +It is meant for short text comments, not aribtrary metadata; arbitrary metadata + belongs in a separate logical stream that provides greater structure and + machine parseability. + +%r: I tried to morph this a little more in the direction of our +% application space +The comment field is meant to be used much like someone jotting a quick note on + the label of a video. +It should be a little information to remember the disc or tape by and explain it to + others; a short, to-the-point text note that can be more than a couple words, + but isn't going to be more than a short paragraph. +The essentials, in other words, whatever they turn out to be, e.g.: + +%TODO: Example + +The comment header is stored as a logical list of eight-bit clean vectors; the + number of vectors is bounded at $2^{32}-1$ and the length of each vector is + limited to $2^{32}-1$ bytes. +The vector length is encoded; the vector contents themselves are not null + terminated. +In addition to the vector list, there is a single vector for a vendor name, + also eight-bit clean with a length encoded in 32 bits. +%TODO: The 1.0 release of libtheora sets the vendor string to ... + +\subsection{Comment Length Decode} +\label{sub:comment-len} + +\begin{figure} +\begin{center} +\begin{tabular}{ | c | c | } + \hline + 4 byte length & + UTF-8 encoded string ...\\ + \hline +\end{tabular} +\end{center} +\caption{Length encoded string layout} +\label{fig:comment-len} +\end{figure} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{LEN} & Integer & 32 & No & A single 32-bit length value. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{LEN0} & Integer & 8 & No & The first octet of the string length. \\ +\locvar{LEN1} & Integer & 8 & No & The second octet of the string length. \\ +\locvar{LEN2} & Integer & 8 & No & The third octet of the string length. \\ +\locvar{LEN3} & Integer & 8 & No & The fourth octet of the string + length. \\ +\bottomrule\end{tabularx} +\medskip + +A single comment vector is decoded as follows: + +\begin{enumerate} +\item +Read an 8-bit unsigned integer as \locvar{LEN0}. +\item +Read an 8-bit unsigned integer as \locvar{LEN1}. +\item +Read an 8-bit unsigned integer as \locvar{LEN2}. +\item +Read an 8-bit unsigned integer as \locvar{LEN3}. +\item +Assign \bitvar{LEN} the value $(\locvar{LEN0}+(\locvar{LEN1}<<8)+ + (\locvar{LEN2}<<16)+(\locvar{LEN3}<<24))$. +This construction is used so that on platforms with 8-bit bytes, the memory + organization of the comment header is identical with that of Vorbis I, + allowing for common parsing code despite the different bit packing + conventions. +\end{enumerate} + +\subsection{Comment Header Decode} + +\begin{figure} +\begin{center} +\begin{tabular}{ | c | } + \hline + vendor string \\ \hline + number of comments \\ \hline + comment string \\ \hline + comment string \\ \hline + ... \\ + \hline +\end{tabular} +\end{center} +\caption{Comment Header Layout} +\label{fig:commentheader} +\end{figure} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{VENDOR} & \multicolumn{3}{l}{String} & The vendor string. \\ +\bitvar{NCOMMENTS} & Integer & 32 & No & The number of user + comments. \\ +\bitvar{COMMENTS} & \multicolumn{3}{l}{String Array} & A list of + \bitvar{NCOMMENTS} user comment values. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\ci} & Integer & 32 & No & The index of the current user + comment. \\ +\bottomrule\end{tabularx} +\medskip + +The complete comment header is decoded as follows: + +\begin{enumerate} +\item +Decode the common header fields according to the procedure described in + Section~\ref{sub:common-header}. +If \bitvar{HEADERTYPE} returned by this procedure is not \hex{81}, then stop. +This packet is not the comment header. +\item +Decode the length of the vendor string using the procedure given in + Section~\ref{sub:comment-len} into \bitvar{LEN}. +\item +Read \bitvar{LEN} 8-bit unsigned integers. +\item +Set the string \bitvar{VENDOR} to the contents of these octets. +\item +Decode the number of user comments using the procedure given in + Section~\ref{sub:comment-len} into \bitvar{LEN}. +\item +Assign \bitvar{NCOMMENTS} the value stored in \bitvar{LEN}. +\item +For each consecutive value of \locvar{\ci} from $0$ to + $(\bitvar{NCOMMENTS}-1)$, inclusive: +\begin{enumerate} +\item +Decode the length of the current user comment using the procedure given in + Section~\ref{sub:comment-len} into \bitvar{LEN}. +\item +Read \bitvar{LEN} 8-bit unsigned integers. +\item +Set the string $\bitvar{COMMENTS}[\locvar{\ci}]$ to the contents of these + octets. +\end{enumerate} +\end{enumerate} + +The comment header comprises the entirety of the second header packet. +Unlike the first header packet, it is not generally the only packet on the + second page and may span multiple pages. +The length of the comment header packet is (practically) unbounded. +The comment header packet is not optional; it must be present in the stream + even if it is logically empty. + +%TODO: \paragraph{VP3 Compatibility} + +\subsection{User Comment Format} + +The user comment vectors are structured similarly to a UNIX environment + variable. +That is, comment fields consist of a field name and a corresponding value and + look like: +\begin{center} +\begin{tabular}{rcl} +$\bitvar{COMMENTS}[0]$ & = & ``TITLE=the look of Theora" \\ +$\bitvar{COMMENTS}[1]$ & = & ``DIRECTOR=me" +\end{tabular} +\end{center} + +The field name is case-insensitive and MUST consist of ASCII characters + \hex{20} through \hex{7D}, \hex{3D} (`=') excluded. +ASCII \hex{41} through \hex{5A} inclusive (characters `A'--`Z') are to be + considered equivalent to ASCII \hex{61} through \hex{7A} inclusive + (characters `a'--`z'). +An entirely empty field name---one that is zero characters long---is not + disallowed. + +The field name is immediately followed by ASCII \hex{3D} (`='); this equals + sign is used to terminate the field name. + +The data immediately after \hex{3D} until the end of the vector is the eight-bit + clean value of the field contents encoded as a UTF-8 string~\cite{rfc2044}. + +Field names MUST NOT be `internationalized'; this is a concession to + simplicity, not an attempt to exclude the majority of the world that doesn't + speak English. +Applications MAY wish to present internationalized versions of the standard + field names listed below to the user, but they are not to be stored in the + bitstream. +Field {\em contents}, however, use the UTF-8 character encoding to allow easy + representation of any language. + +Individual `vendors' MAY use non-standard field names within reason. +The proper use of comment fields as human-readable notes has already been + explained. +Abuse will be discouraged. + +There is no vendor-specific prefix to `non-standard' field names. +Vendors SHOULD make some effort to avoid arbitrarily polluting the common + namespace. +%"and other bodies"? +%If you're going to be that vague, you might as well not say anything at all. +Xiph.Org and other bodies will generally collect and rationalize the more + useful tags to help with standardization. + +Field names are not restricted to occur only once within a comment header. +%TODO: Example + +\paragraph{Field Names} + +%r should this be an appendix? + +Below is a proposed, minimal list of standard field names with a description of + their intended use. +No field names are mandatory; a comment header may contain one or more, all, or + none of the names in this list. + +\begin{description} +\item{TITLE:} Video name. +\item{ARTIST:} Filmmaker or other creator name. +\item{VERSION:} Subtitle, remix info, or other text distinguishing + versions of a video. +\item{DATE:} Date associated with the video. Implementations SHOULD attempt + to parse this field as an ISO 8601 date for machine interpretation and + conversion. +\item{LOCATION:} Location associated with the video. This is usually the + filming location for non-fiction works. +\item{COPYRIGHT:} Copyright statement. +\item{LICENSE:} Copyright and other licensing information. + Implementations wishing to do automatic parsing of e.g + of distribution terms SHOULD look here for a URL uniquely defining + the license. If no instance of this field is present, or if no + instance contains a parseable URL, and implementation MAY look + in the COPYRIGHT field for such a URL. +\item{ORGANIZATION:} Studio name, Publisher, or other organization + involved in the creation of the video. + +\item{DIRECTOR:} Director or Filmmaker credit, similar to ARTIST. +\item{PRODUCER:} Producer credit for the video. +\item{COMPOSER:} Music credit for the video. +\item{ACTOR:} Acting credit for the video. + +\item{TAG:} subject or category tag, keyword, or other content + classification labels. The value of each instance of this + field SHOULD be treated as a single label, with multiple + instances of the field for multiple tags. The value of + a single field SHOULD NOT be parsed into multiple tags + based on some internal delimeter. +\item{DESCRIPTION:} General description, summary, or blurb. +\end{description} + +\section{Setup Header} +\label{sec:setupheader} + +The Theora setup header contains the limit values used to drive the loop + filter, the base matrices and scale values used to build the dequantization + tables, and the Huffman tables used to unpack the DCT tokens. +Because the contents of this header are specific to Theora, no concessions have + been made to keep the fields octet-aligned for easy parsing. + +\begin{figure} +\begin{center} +\begin{tabular}{ | c | } + \hline + common header block \\ \hline + loop filter table resolution \\ \hline + loop filter table \\ \hline + scale table resolution \\ \hline + AC scale table \\ \hline + DC scale table \\ \hline + number of base matricies \\ \hline + base quatization matricies \\ \hline + ... \\ \hline + quant range interpolation table \\ \hline + DCT token Huffman tables \\ + \hline +\end{tabular} +\end{center} +\caption{Setup Header structure} +\label{fig:setupheader} +\end{figure} + +\subsection{Loop Filter Limit Table Decode} +\label{sub:loop-filter-limits} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{LFLIMS} & \multicolumn{1}{p{40pt}}{Integer array} & + 7 & No & A 64-element array of loop filter limit + values. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\qi} & Integer & 6 & No & The quantization index. \\ +\locvar{NBITS} & Integer & 3 & No & The size of values being read in the + current table. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure decodes the table of loop filter limit values used to drive the + loop filter, which is described in Section~\ref{sub:loop-filter-limits}. +It is decoded as follows: + +\begin{enumerate} +\item +Read a 3-bit unsigned integer as \locvar{NBITS}. +\item +For each consecutive value of \locvar{\qi} from $0$ to $63$, inclusive: +\begin{enumerate} +\item +Read an \locvar{NBITS}-bit unsigned integer as $\bitvar{LFLIMS}[\locvar{\qi}]$. +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The loop filter limit values are hardcoded in VP3. +The values used are given in Appendix~\ref{app:vp3-loop-filter-limits}. + +\subsection{Quantization Parameters Decode} +\label{sub:quant-params} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + the DC coefficient for each \qi\ value. \\ +\bitvar{NBMS} & Integer & 10 & No & The number of base matrices. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values are used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values are used. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\qti} & Integer & 1 & No & A quantization type index. +See Table~\ref{tab:quant-types}.\\ +\locvar{\qtj} & Integer & 1 & No & A quantization type index. \\ +\locvar{\pli} & Integer & 2 & No & A color plane index. +See Table~\ref{tab:color-planes}.\\ +\locvar{\plj} & Integer & 2 & No & A color plane index. \\ +\locvar{\qi} & Integer & 6 & No & The quantization index. \\ +\locvar{\ci} & Integer & 6 & No & The DCT coefficient index. \\ +\locvar{\bmi} & Integer & 9 & No & The base matrix index. \\ +\locvar{\qri} & Integer & 6 & No & The quant range index. \\ +\locvar{NBITS} & Integer & 5 & No & The size of fields to read. \\ +\locvar{NEWQR} & Integer & 1 & No & Flag that indicates a new set of quant + ranges will be defined. \\ +\locvar{RPQR} & Integer & 1 & No & Flag that indicates the quant ranges to + copy will come from the same color plane. \\ +\bottomrule\end{tabularx} +\medskip + +The AC scale and DC scale values are defined in two simple tables with 64 + values each, one for each \qi\ value. +The same scale values are used for every quantization type and color plane. + +The base matrices for all quantization types and color planes are stored in a + single table. +These are then referenced by index in several sets of \term{quant ranges}. +The purpose of the quant ranges is to specify which base matrices are used for + which \qi\ values. + +A set of quant ranges is defined for each quantization type and color plane. +To save space in the header, bit flags allow a set of quant ranges to be copied + from a previously defined set instead of being specified explicitly. +Every set except the first one can be copied from the immediately preceding + set. +Similarly, if the quantization type is not $0$, the set can be copied from the + set defined for the same color plane for the preceding quantization type. +This formulation allows compact representation of, for example, the same + set of quant ranges in both chroma channels, as is done in the original VP3, + or the same set of quant ranges in INTRA and INTER modes. + +Each quant range is defined by a size and two base matrix indices, one for each + end of the range. +The base matrix for the end of one range is used as the start of the next + range, so that for $n$ ranges, $n+1$ base matrices are specified. +The base matrices for the \qi\ values between the two endpoints of the range + are generated by linear interpolation. + +%TODO: figure + +The location of the endpoints of each range is encoded by their size. +The \qi\ value for the left end-point is the sum of the sizes of all preceding + ranges, and the \qi\ value for the right end-point adds the size of the + current range. +Thus the sum of the sizes of all the ranges MUST be 63, so that the last range + falls on the last possible \qi\ value. + +The complete set of quantization parameters are decoded as follows: + +\begin{enumerate} +\item +Read a 4-bit unsigned integer. +Assign \locvar{NBITS} the value read, plus one. +\item +For each consecutive value of \locvar{\qi} from $0$ to $63$, inclusive: +\begin{enumerate} +\item +Read an \locvar{NBITS}-bit unsigned integer as + $\bitvar{ACSCALE}[\locvar{\qi}]$. +\end{enumerate} +\item +Read a 4-bit unsigned integer. +Assign \locvar{NBITS} the value read, plus one. +\item +For each consecutive value of \locvar{\qi} from $0$ to $63$, inclusive: +\begin{enumerate} +\item +Read an \locvar{NBITS}-bit unsigned integer as + $\bitvar{DCSCALE}[\locvar{\qi}]$. +\end{enumerate} +\item +Read a 9-bit unsigned integer. +Assign \bitvar{NBMS} the value decoded, plus one. +\bitvar{NBMS} MUST be no greater than 384. +\item +For each consecutive value of \locvar{\bmi} from $0$ to $(\bitvar{NBMS}-1)$, + inclusive: +\begin{enumerate} +\item +For each consecutive value of \locvar{\ci} from $0$ to $63$, inclusive: +\begin{enumerate} +\item +Read an 8-bit unsigned integer as $\bitvar{BMS}[\locvar{\bmi}][\locvar{\ci}]$. +\end{enumerate} +\end{enumerate} +\item +For each consecutive value of \locvar{\qti} from $0$ to $1$, inclusive: +\begin{enumerate} +\item +For each consecutive value of \locvar{\pli} from $0$ to $2$, inclusive: +\begin{enumerate} +\item +If $\locvar{\qti}>0$ or $\locvar{\pli}>0$, read a 1-bit unsigned integer as + \locvar{NEWQR}. +\item +Else, assign \locvar{NEWQR} the value one. +\item +If \locvar{NEWQR} is zero, then we are copying a previously defined set of + quant ranges. +In that case: +\begin{enumerate} +\item +If $\locvar{\qti}>0$, read a 1-bit unsigned integer as \locvar{RPQR}. +\item +Else, assign \locvar{RPQR} the value zero. +\item +If \locvar{RPQR} is one, assign \locvar{\qtj} the value $(\locvar{\qti}-1)$ + and assign \locvar{\plj} the value \locvar{\pli}. +This selects the set of quant ranges defined for the same color plane as this + one, but for the previous quantization type. +\item +Else assign \locvar{\qtj} the value $(3*\locvar{\qti}+\locvar{\pli}-1)//3$ and + assign \locvar{\plj} the value $(\locvar{\pli}+2)\%3$. +This selects the most recent set of quant ranges defined. +\item +Assign $\bitvar{NQRS}[\locvar{\qti}][\locvar{\pli}]$ the value + $\bitvar{NQRS}[\locvar{\qtj}][\locvar{\plj}]$. +\item +Assign $\bitvar{QRSIZES}[\locvar{\qti}][\locvar{\pli}]$ the values in + $\bitvar{QRSIZES}[\locvar{\qtj}][\locvar{\plj}]$. +\item +Assign $\bitvar{QRBMIS}[\locvar{\qti}][\locvar{\pli}]$ the values in + $\bitvar{QRBMIS}[\locvar{\qtj}][\locvar{\plj}]$. +\end{enumerate} +\item +Else, \locvar{NEWQR} is one, which indicates that we are defining a new set of + quant ranges. +In that case: +\begin{enumerate} +\item +Assign $\locvar{\qri}$ the value zero. +\item +Assign $\locvar{\qi}$ the value zero. +\item +Read an $\ilog(\bitvar{NBMS}-1)$-bit unsigned integer as\\ + $\bitvar{QRBMIS}[\locvar{\qti}][\locvar{\pli}][\locvar{\qri}]$. +If this is greater than or equal to \bitvar{NBMS}, stop. +The stream is undecodable. +\item +\label{step:qr-loop} +Read an $\ilog(62-\locvar{\qi})$-bit unsigned integer. +Assign\\ $\bitvar{QRSIZES}[\locvar{\qti}][\locvar{\pli}][\locvar{\qri}]$ the value + read, plus one. +\item +Assign \locvar{\qi} the value $\locvar{\qi}+ + \bitvar{QRSIZES}[\locvar{\qti}][\locvar{\pli}][\locvar{\qri}]$. +\item +Assign \locvar{\qri} the value $\locvar{\qri}+1$. +\item +Read an $\ilog(\bitvar{NBMS}-1)$-bit unsigned integer as\\ + $\bitvar{QRBMIS}[\locvar{\qti}][\locvar{\pli}][\locvar{\qri}]$. +\item +If \locvar{\qi} is less than 63, go back to step~\ref{step:qr-loop}. +\item +If \locvar{\qi} is greater than 63, stop. +The stream is undecodable. +\item +Assign $\bitvar{NQRS}[\locvar{\qti}][\locvar{\pli}]$ the value \locvar{\qri}. +\end{enumerate} +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The quantization parameters are hardcoded in VP3. +The values used are given in Appendix~\ref{app:vp3-quant-params}. + +\subsection{Computing a Quantization Matrix} +\label{sub:quant-mat} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + the DC coefficient for each \qi\ value. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values are used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values are used. \\ +\bitvar{\qti} & Integer & 1 & No & A quantization type index. +See Table~\ref{tab:quant-types}.\\ +\bitvar{\pli} & Integer & 2 & No & A color plane index. +See Table~\ref{tab:color-planes}.\\ +\bitvar{\qi} & Integer & 6 & No & The quantization index. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{QMAT} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of quantization + values for each DCT coefficient in natural order. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\ci} & Integer & 6 & No & The DCT coefficient index. \\ +\locvar{\bmi} & Integer & 9 & No & The base matrix index. \\ +\locvar{\bmj} & Integer & 9 & No & The base matrix index. \\ +\locvar{\qri} & Integer & 6 & No & The quant range index. \\ +\locvar{QISTART} & Integer & 6 & No & The left end-point of the \qi\ range. \\ +\locvar{QIEND } & Integer & 6 & No & The right end-point of the \qi\ range. \\ +\locvar{BM} & \multicolumn{1}{p{40pt}}{Integer array} & + 8 & No & A 64-element array containing the + interpolated base matrix. \\ +\locvar{QMIN} & Integer & 16 & No & The minimum quantization value allowed + for the current coefficient. \\ +\locvar{QSCALE} & Integer & 16 & No & The current scale value. \\ +\bottomrule\end{tabularx} +\medskip + +The following procedure can be used to generate a single quantization matrix + for a given quantization type, color plane, and \qi\ value, given the + quantization parameters decoded in Section~\ref{sub:quant-params}. + +Note that the product of the scale value and the base matrix value is in units + of $100$ths of a pixel value, and thus is divided by $100$ to return it to + units of a single pixel value. +This value is then scaled by four, to match the scaling of the DCT output, + which is also a factor of four larger than the orthonormal version of the + transform. + +\begin{enumerate} +\item +Assign \locvar{\qri} the index of a quant range such that +\begin{displaymath} +\bitvar{\qi} \ge \sum_{\qrj=0}^{\locvar{\qri}-1} + \bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\qrj], +\end{displaymath} + and +\begin{displaymath} +\bitvar{\qi} \le \sum_{\qrj=0}^{\locvar{\qri}} + \bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\qrj], +\end{displaymath} + where summation from $0$ to $-1$ is defined to be zero. +If there is more than one such value of $\locvar{\qri}$, i.e., if \bitvar{\qi} + lies on the boundary between two quant ranges, then the output will be the + same regardless of which one is chosen. +\item +Assign \locvar{QISTART} the value +\begin{displaymath} +\sum_{\qrj=0}^{\qri-1} \bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\qrj]. +\end{displaymath} +\item +Assign \locvar{QIEND} the value +\begin{displaymath} +\sum_{\qrj=0}^{\qri} \bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\qrj]. +\end{displaymath} +\item +Assign \locvar{\bmi} the value + $\bitvar{QRBMIS}[\bitvar{\qti}][\bitvar{\pli}][\qri]$. +\item +Assign \locvar{\bmj} the value + $\bitvar{QRBMIS}[\bitvar{\qti}][\bitvar{\pli}][\qri+1]$. +\item +For each consecutive value of \locvar{\ci} from $0$ to $63$, inclusive: +\begin{enumerate} +\item +Assign $\locvar{BM}[\locvar{\ci}]$ the value +\begin{displaymath} +\begin{split} +(&2*(\locvar{QIEND}-\bitvar{\qi})*\bitvar{BMS}[\locvar{\bmi}][\locvar{\ci}]\\ + &+2*(\bitvar{\qi}- + \locvar{QISTART})*\bitvar{BMS}[\locvar{\bmj}][\locvar{\ci}]\\ + &+\bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\locvar{\qri}])// + (2*\bitvar{QRSIZES}[\bitvar{\qti}][\bitvar{\pli}][\locvar{\qri}]) +\end{split} +\end{displaymath} +\item +Assign \locvar{QMIN} the value given by Table~\ref{tab:qmin} according to + \bitvar{\qti} and \locvar{\ci}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{clr}\toprule +Coefficient & \multicolumn{1}{c}{\bitvar{\qti}} + & \locvar{QMIN} \\\midrule +$\locvar{\ci}=0$ & $0$ (Intra) & $16$ \\ +$\locvar{\ci}>0$ & $0$ (Intra) & $8$ \\ +$\locvar{\ci}=0$ & $1$ (Inter) & $32$ \\ +$\locvar{\ci}>0$ & $1$ (Inter) & $16$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Minimum Quantization Values} +\label{tab:qmin} +\end{table} + +\item +If \locvar{\ci} equals zero, assign $\locvar{QSCALE}$ the value + $\bitvar{DCSCALE}[\bitvar{\qi}]$. +\item +Else, assign $\locvar{QSCALE}$ the value + $\bitvar{ACSCALE}[\bitvar{\qi}]$. +\item +Assign $\bitvar{QMAT}[\locvar{\ci}]$ the value +\begin{displaymath} +\max(\locvar{QMIN}, + \min((\locvar{QSCALE}*\locvar{BM}[\locvar{\ci}]//100)*4,4096)). +\end{displaymath} +\end{enumerate} +\end{enumerate} + +\subsection{DCT Token Huffman Tables} +\label{sub:huffman-tables} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{HTS} & \multicolumn{3}{l}{Huffman table array} + & An 80-element array of Huffman tables + with up to 32 entries each. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{HBITS} & Bit string & 32 & No & A string of up to 32 bits. \\ +\locvar{TOKEN} & Integer & 5 & No & A single DCT token value. \\ +\locvar{ISLEAF} & Integer & 1 & No & Flag that indicates if the current + node of the tree being decoded is a leaf node. \\ +\bottomrule\end{tabularx} +\medskip + +The Huffman tables used to decode DCT tokens are stored in the setup header in + the form of a binary tree. +This enforces the requirements that the code be full---so that any sequence of + bits will produce a valid sequence of tokens---and that the code be + prefix-free so that there is no ambiguity when decoding. + +One more restriction is placed on the tables that is not explicitly enforced by + the bitstream syntax, but nevertheless must be obeyed by compliant encoders. +There must be no more than 32 entries in a single table. +Note that this restriction along with the fullness requirement limit the + maximum size of a single Huffman code to 32 bits. +It is probably a good idea to enforce this latter consequence explicitly when + implementing the decoding procedure as a recursive algorithm, so as to prevent + a possible stack overflow given an invalid bitstream. + +Although there are 32 different DCT tokens, and thus a normal table will have + exactly 32 entries, this is not explicitly required. +It is allowable to use a Huffman code that omits some---but not all---of the + possible token values. +It is also allowable, if not particularly useful, to specify multiple codes for + the same token value in a single table. +Note also that token values may appear in the tree in any order. +In particular, it is not safe to assume that token value zero (which ends a + single block), has a Huffman code of all zeros. + +The tree is decoded as follows: + +\begin{enumerate} +\item +For each consecutive value of \locvar{\hti} from $0$ to $79$, inclusive: +\begin{enumerate} +\item +Set \locvar{HBITS} to the empty string. +\item +\label{step:huff-tree-loop} +If \locvar{HBITS} is longer than 32 bits in length, stop. +The stream is undecodable. +\item +Read a 1-bit unsigned integer as \locvar{ISLEAF}. +\item +If \locvar{ISLEAF} is one: +\begin{enumerate} +\item +If the number of entries in table $\bitvar{HTS}[\locvar{\hti}]$ is already 32, + stop. +The stream is undecodable. +\item +Read a 5-bit unsigned integer as \locvar{TOKEN}. +\item +Add the pair $(\locvar{HBITS},\locvar{TOKEN})$ to Huffman table + $\bitvar{HTS}[\locvar{\hti}]$. +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Add a `0' to the end of \locvar{HBITS}. +\item +Decode the `0' sub-tree using this procedure, starting from + step~\ref{step:huff-tree-loop}. +\item +Remove the `0' from the end of \locvar{HBITS} and add a `1' to the end of + \locvar{HBITS}. +\item +Decode the `1' sub-tree using this procedure, starting from + step~\ref{step:huff-tree-loop}. +\item +Remove the `1' from the end of \locvar{HBITS}. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The DCT token Huffman tables are hardcoded in VP3. +The values used are given in Appendix~\ref{app:vp3-huffman-tables}. + +\subsection{Setup Header Decode} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{LFLIMS} & \multicolumn{1}{p{40pt}}{Integer array} & + 7 & No & A 64-element array of loop filter limit + values. \\ +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + the DC coefficient for each \qi\ value. \\ +\bitvar{NBMS} & Integer & 10 & No & The number of base matrices. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values will be used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values will be used. \\ +\bitvar{HTS} & \multicolumn{3}{l}{Huffman table array} + & An 80-element array of Huffman tables + with up to 32 entries each. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:} None. +\medskip + +The complete setup header is decoded as follows: + +\begin{enumerate} +\item +Decode the common header fields according to the procedure described in + Section~\ref{sub:common-header}. +If \bitvar{HEADERTYPE} returned by this procedure is not \hex{82}, then stop. +This packet is not the setup header. +\item +Decode the loop filter limit value table using the procedure given in + Section~\ref{sub:loop-filter-limits} into \bitvar{LFLIMS}. +\item +Decode the quantization parameters using the procedure given in + Section~\ref{sub:quant-params}. +The results are stored in \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{NBMS}, + \bitvar{BMS}, \bitvar{NQRS}, \bitvar{QRSIZES}, and \bitvar{QRBMIS}. +\item +Decode the DCT token Huffman tables using the procedure given in + Section~\ref{sub:huffman-tables} into \bitvar{HTS}. +\end{enumerate} + +\chapter{Frame Decode} + +This section describes the complete procedure necessary to decode a single + frame. +This begins with the frame header, followed by coded block flags, macro block + modes, motion vectors, block-level \qi\ values, and finally the DCT residual + tokens, which are used to reconstruct the frame. + +\section{Frame Header Decode} +\label{sub:frame-header} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{FTYPE} & Integer & 1 & No & The frame type. \\ +\bitvar{NQIS} & Integer & 2 & No & The number of \qi\ values. \\ +\bitvar{QIS} & \multicolumn{1}{p{40pt}}{Integer array} & + 6 & No & An \bitvar{NQIS}-element array of + \qi\ values. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{MOREQIS} & Integer & 1 & No & A flag indicating there are more + \qi\ values to be decoded. \\ +\bottomrule\end{tabularx} +\medskip + +The frame header selects which type of frame is being decoded, intra or inter, + and contains the list of \qi\ values that will be used in this frame. +The first \qi\ value will be used for {\em all} DC coefficients in all blocks. +This is done to ensure that DC prediction, which is done in the quantized + domain, works as expected. +The AC coefficients, however, can be dequantized using any \qi\ value on the + list, selected on a block-by-block basis. + +\begin{enumerate} +\item +Read a 1-bit unsigned integer. +If the value read is not zero, stop. +This is not a data packet. +\item +Read a 1-bit unsigned integer as \bitvar{FTYPE}. +This is the type of frame being decoded, as given in + Table~\ref{tab:frame-type}. +If this is the first frame being decoded, this MUST be zero. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{cl}\toprule +\bitvar{FTYPE} & Frame Type \\\midrule +$0$ & Intra frame \\ +$1$ & Inter frame \\ +\bottomrule\end{tabular} +\end{center} +\caption{Frame Type Values} +\label{tab:frame-type} +\end{table} + +\item +Read in a 6-bit unsigned integer as $\bitvar{QIS}[0]$. +\item +Read a 1-bit unsigned integer as \locvar{MOREQIS}. +\item +If \locvar{MOREQIS} is zero, set \bitvar{NQIS} to 1. +\item +Otherwise: +\begin{enumerate} +\item +Read in a 6-bit unsigned integer as $\bitvar{QIS}[1]$. +\item +Read a 1-bit unsigned integer as \locvar{MOREQIS}. +\item +If \locvar{MOREQIS} is zero, set \bitvar{NQIS} to 2. +\item +Otherwise: +\begin{enumerate} +\item +Read in a 6-bit unsigned integer as $\bitvar{QIS}[2]$. +\item +Set \bitvar{NQIS} to 3. +\end{enumerate} +\end{enumerate} +\item +If \bitvar{FTYPE} is 0, read a 3-bit unsigned integer. +These bits are reserved. +If this value is not zero, stop. +This frame is not decodable according to this specification. +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The precise format of the frame header is substantially different in Theora + than in VP3. +The original VP3 format includes a larger number of unused, reserved bits that + are required to be zero. +The original VP3 frame header also can contain only a single \qi\ value, + because VP3 does not support block-level \qi\ values and uses the same + \qi\ value for all the coefficients in a frame. + +\section{Run-Length Encoded Bit Strings} + +Two variations of run-length encoding are used to store sequences of bits for + the block coded flags and the block-level \qi\ values. +The procedures to decode these bit sequences are specified in the following two + sections. + +\subsection{Long-Run Bit String Decode} +\label{sub:long-run} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{NBITS} & Integer & 36 & No & The number of bits to decode. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{BITS} & Bit string & & & The decoded bits. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{LEN} & Integer & 36 & No & The number of bits decoded so far. \\ +\locvar{BIT} & Integer & 1 & No & The value associated with the current + run. \\ +\locvar{RLEN} & Integer & 13 & No & The length of the current run. \\ +\locvar{RBITS} & Integer & 4 & No & The number of extra bits needed to + decode the run length. \\ +\locvar{RSTART} & Integer & 6 & No & The start of the possible run-length + values for a given Huffman code. \\ +\locvar{ROFFS} & Integer & 12 & No & The offset from \locvar{RSTART} of the + run-length. \\ +\bottomrule\end{tabularx} +\medskip + +There is no practical limit to the number of consecutive 0's and 1's that can + be decoded with this procedure. +In reality, the run length is limited by the number of blocks in a single + frame, because more will never be requested. +A separate procedure described in Section~\ref{sub:short-run} is used when + there is a known limit on the maximum size of the runs. + +For the first run, a single bit value is read, and then a Huffman-coded + representation of a run length is decoded, and that many copies of the bit + value are appended to the bit string. +For each consecutive run, the value of the bit is toggled instead of being read + from the bitstream. + +The only exception is if the length of the previous run was 4129, the maximum + possible length encodable by the Huffman-coded representation. +In this case another bit value is read from the stream, to allow for + consecutive runs of 0's or 1's longer than this maximum. + +Note that in both cases---for the first run and after a run of length 4129---if + no more bits are needed, then no bit value is read. + +The complete decoding procedure is as follows: + +\begin{enumerate} +\item +Assign \locvar{LEN} the value 0. +\item +Assign \bitvar{BITS} the empty string. +\item +If \locvar{LEN} equals \bitvar{NBITS}, return the completely decoded string + \bitvar{BITS}. +\item +Read a 1-bit unsigned integer as \locvar{BIT}. +\item +\label{step:long-run-loop} +Read a bit at a time until one of the Huffman codes given in + Table~\ref{tab:long-run} is recognized. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{lrrl}\toprule +Huffman Code & \locvar{RSTART} & \locvar{RBITS} & Run Lengths \\\midrule +\bin{0} & $1$ & $0$ & $1$ \\ +\bin{10} & $2$ & $1$ & $2\ldots 3$ \\ +\bin{110} & $4$ & $1$ & $4\ldots 5$ \\ +\bin{1110} & $6$ & $2$ & $6\ldots 9$ \\ +\bin{11110} & $10$ & $3$ & $10\ldots 17$ \\ +\bin{111110} & $18$ & $4$ & $18\ldots 33$ \\ +\bin{111111} & $34$ & $12$ & $34\ldots 4129$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Huffman Codes for Long Run Lengths} +\label{tab:long-run} +\end{table} + +\item +Assign \locvar{RSTART} and \locvar{RBITS} the values given in + Table~\ref{tab:long-run} according to the Huffman code read. +\item +Read an \locvar{RBITS}-bit unsigned integer as \locvar{ROFFS}. +\item +Assign \locvar{RLEN} the value $(\locvar{RSTART}+\locvar{ROFFS})$. +\item +Append \locvar{RLEN} copies of \locvar{BIT} to \bitvar{BITS}. +\item +Add \locvar{RLEN} to the value \locvar{LEN}. +\locvar{LEN} MUST be less than or equal to \bitvar{NBITS}. +\item +If \locvar{LEN} equals \bitvar{NBITS}, return the completely decoded string + \bitvar{BITS}. +\item +If \locvar{RLEN} equals 4129, read a 1-bit unsigned integer as \locvar{BIT}. +\item +Otherwise, assign \locvar{BIT} the value $(1-\locvar{BIT})$. +\item +Continue decoding runs from step~\ref{step:long-run-loop}. +\end{enumerate} + +\paragraph{VP3 Compatibility} + +VP3 does not read a new bit value after decoding a run length of 4129. +This limits the maximum number of consecutive 0's or 1's to 4129 in + VP3-compatible streams. +For reasonable video sizes of $1920\times 1080$ or less in 4:2:0 format---the + only pixel format VP3 supports---this does not pose any problems because runs + longer than 4129 are not needed. + +\subsection{Short-Run Bit String Decode} +\label{sub:short-run} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{NBITS} & Integer & 36 & No & The number of bits to decode. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{BITS} & Bit string & & & The decoded bits. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{LEN} & Integer & 36 & No & The number of bits decoded so far. \\ +\locvar{BIT} & Integer & 1 & No & The value associated with the current + run. \\ +\locvar{RLEN} & Integer & 13 & No & The length of the current run. \\ +\locvar{RBITS} & Integer & 4 & No & The number of extra bits needed to + decode the run length. \\ +\locvar{RSTART} & Integer & 6 & No & The start of the possible run-length + values for a given Huffman code. \\ +\locvar{ROFFS} & Integer & 12 & No & The offset from \locvar{RSTART} of the + run-length. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure is similar to the procedure outlined in + Section~\ref{sub:long-run}, except that the maximum number of consecutive 0's + or 1's is limited to 30. +This is the maximum run length needed when encoding a bit for each of the 16 + blocks in a super block when it is known that not all the bits in a super + block are the same. + +The complete decoding procedure is as follows: + +\begin{enumerate} +\item +Assign \locvar{LEN} the value 0. +\item +Assign \bitvar{BITS} the empty string. +\item +If \locvar{LEN} equals \bitvar{NBITS}, return the completely decoded string + \bitvar{BITS}. +\item +Read a 1-bit unsigned integer as \locvar{BIT}. +\item +\label{step:short-run-loop} +Read a bit at a time until one of the Huffman codes given in + Table~\ref{tab:short-run} is recognized. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{lrrl}\toprule +Huffman Code & \locvar{RSTART} & \locvar{RBITS} & Run Lengths \\\midrule +\bin{0} & $1$ & $1$ & $1\ldots 2$ \\ +\bin{10} & $3$ & $1$ & $3\ldots 4$ \\ +\bin{110} & $5$ & $1$ & $5\ldots 6$ \\ +\bin{1110} & $7$ & $2$ & $7\ldots 10$ \\ +\bin{11110} & $11$ & $2$ & $11\ldots 14$ \\ +\bin{11111} & $15$ & $4$ & $15\ldots 30$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Huffman Codes for Short Run Lengths} +\label{tab:short-run} +\end{table} + +\item +Assign \locvar{RSTART} and \locvar{RBITS} the values given in + Table~\ref{tab:short-run} according to the Huffman code read. +\item +Read an \locvar{RBITS}-bit unsigned integer as \locvar{ROFFS}. +\item +Assign \locvar{RLEN} the value $(\locvar{RSTART}+\locvar{ROFFS})$. +\item +Append \locvar{RLEN} copies of \locvar{BIT} to \bitvar{BITS}. +\item +Add \locvar{RLEN} to the value \locvar{LEN}. +\locvar{LEN} MUST be less than or equal to \bitvar{NBITS}. +\item +If \locvar{LEN} equals \bitvar{NBITS}, return the completely decoded string + \bitvar{BITS}. +\item +Assign \locvar{BIT} the value $(1-\locvar{BIT})$. +\item +Continue decoding runs from step~\ref{step:short-run-loop}. +\end{enumerate} + +\section{Coded Block Flags Decode} +\label{sub:coded-blocks} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{FTYPE} & Integer & 1 & No & The frame type. \\ +\bitvar{NSBS} & Integer & 32 & No & The total number of super blocks in a + frame. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{NBITS} & Integer & 36 & No & The length of a bit string to decode. \\ +\locvar{BITS} & Bit string & & & A decoded set of flags. \\ +\locvar{SBPCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NSBS}-element array of flags + indicating whether or not each super block is partially coded. \\ +\locvar{SBFCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NSBS}-element array of flags + indicating whether or not each non-partially coded super block is fully + coded. \\ +\locvar{\sbi} & Integer & 32 & No & The index of the current super + block. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in coded + order. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure determines which blocks are coded in a given frame. +In an intra frame, it marks all blocks coded. +In an inter frame, however, any or all of the blocks may remain uncoded. +The output is a list of bit flags, one for each block, marking it coded or not + coded. + +It is important to note that flags are still decoded for any blocks which lie + entirely outside the picture region, even though they are not displayed. +Encoders MAY choose to code such blocks. +Decoders MUST faithfully reconstruct such blocks, because their contents can be + used for predictors in future frames. +Flags are \textit{not} decoded for portions of a super block which lie outside + the full frame, as there are no blocks in those regions. + +The complete procedure is as follows: + +\begin{enumerate} +\item +If \bitvar{FTYPE} is zero (intra frame): +\begin{enumerate} +\item +For each consecutive value of \locvar{\bi} from 0 to $(\locvar{NBS}-1)$, assign + $\bitvar{BCODED}[\locvar{\bi}]$ the value one. +\end{enumerate} +\item +Otherwise (inter frame): +\begin{enumerate} +\item +Assign \locvar{NBITS} the value \bitvar{NSBS}. +\item +Read an \locvar{NBITS}-bit bit string into \locvar{BITS}, using the procedure + described in Section~\ref{sub:long-run}. +This represents the list of partially coded super blocks. +\item +For each consecutive value of \locvar{\sbi} from 0 to $(\locvar{NSBS}-1)$, + remove the bit at the head of the string \locvar{BITS} and assign it to + $\locvar{SBPCODED}[\locvar{\sbi}]$. +\item +Assign \locvar{NBITS} the total number of super blocks such that \\ + $\locvar{SBPCODED}[\locvar{\sbi}]$ equals zero. +\item +Read an \locvar{NBITS}-bit bit string into \locvar{BITS}, using the procedure + described in Section~\ref{sub:long-run}. +This represents the list of fully coded super blocks. +\item +For each consecutive value of \locvar{\sbi} from 0 to $(\locvar{NSBS}-1)$ such + that $\locvar{SBPCODED}[\locvar{\sbi}]$ equals zero, remove the bit at the + head of the string \locvar{BITS} and assign it to + $\locvar{SBFCODED}[\locvar{\sbi}]$. +\item +Assign \locvar{NBITS} the number of blocks contained in super blocks where + $\locvar{SBPCODED}[\locvar{\sbi}]$ equals one. +Note that this might {\em not} be equal to 16 times the number of partially + coded super blocks, since super blocks which overlap the edge of the frame + will have fewer than 16 blocks in them. +\item +Read an \locvar{NBITS}-bit bit string into \locvar{BITS}, using the procedure + described in Section~\ref{sub:short-run}. +\item +For each block in coded order---indexed by \locvar{\bi}: +\begin{enumerate} +\item +Assign \locvar{\sbi} the index of the super block containing block + \locvar{\bi}. +\item +If $\locvar{SBPCODED}[\locvar{\sbi}]$ is zero, assign + $\bitvar{BCODED}[\locvar{\bi}]$ the value $\locvar{SBFCODED}[\locvar{\sbi}]$. +\item +Otherwise, remove the bit at the head of the string \locvar{BITS} and assign it + to $\bitvar{BCODED}[\locvar{\bi}]$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\section{Macro Block Coding Modes} +\label{sub:mb-modes} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{FTYPE} & Integer & 1 & No & The frame type. \\ +\bitvar{NMBS} & Integer & 32 & No & The total number of macro blocks in a + frame. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of coding + modes for each macro block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{MSCHEME} & Integer & 3 & No & The mode coding scheme. \\ +\locvar{MALPHABET} & \multicolumn{1}{p{40pt}}{Integer array} + & 3 & No & The list of modes corresponding to each + Huffman code. \\ +\locvar{\mbi} & Integer & 32 & No & The index of the current macro + block. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\mi} & Integer & 3 & No & The index of a Huffman code from + Table~\ref{tab:mode-codes}, starting from $0$. \\ +\bottomrule\end{tabularx} +\medskip + +In an intra frame, every macro block marked as coded in INTRA mode. +In an inter frame, however, a macro block can be coded in one of eight coding + modes, given in Table~\ref{tab:coding-modes}. +All of the blocks in all color planes contained in a macro block will be + assigned the coding mode of that macro block. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{cl}\toprule +Index & Coding Mode \\\midrule +$0$ & INTER\_NOMV \\ +$1$ & INTRA \\ +$2$ & INTER\_MV \\ +$3$ & INTER\_MV\_LAST \\ +$4$ & INTER\_MV\_LAST2 \\ +$5$ & INTER\_GOLDEN\_NOMV \\ +$6$ & INTER\_GOLDEN\_MV \\ +$7$ & INTER\_MV\_FOUR \\ +\bottomrule\end{tabular} +\end{center} +\caption{Macro Block Coding Modes} +\label{tab:coding-modes} +\end{table} + +An important thing to note is that a coding mode is only stored in the + bitstream for a macro block if it has at least one {\em luma} block coded. +A macro block that contains coded blocks in the chroma planes, but not in the + luma plane, MUST be coded in INTER\_NOMV mode. +Thus, no coding mode needs to be decoded for such a macro block. + +Coding modes are encoded using one of eight different schemes. +Schemes 0 through 6 use the same simple Huffman code to represent the mode + numbers, as given in Table~\ref{tab:mode-codes}. +The difference in the schemes is the mode number assigned to each code. +Scheme 0 uses an assignment specified in the bitstream, while schemes 1--6 use + a fixed assignment, also given in Table~\ref{tab:mode-codes}. +Scheme 7 simply codes each mode directly in the bitstream using three bits. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{lccccccc}\toprule +Scheme & $1$ & $2$ & $3$ & $4$ & $5$ & $6$ & $7$ \\\cmidrule{2-7} +Huffman Code & \multicolumn{6}{c}{Coding Mode} & \locvar{\mi} \\\midrule +\bin{0} & $3$ & $3$ & $3$ & $3$ & $0$ & $0$ & $0$ \\ +\bin{10} & $4$ & $4$ & $2$ & $2$ & $3$ & $5$ & $1$ \\ +\bin{110} & $2$ & $0$ & $4$ & $0$ & $4$ & $3$ & $2$ \\ +\bin{1110} & $0$ & $2$ & $0$ & $4$ & $2$ & $4$ & $3$ \\ +\bin{11110} & $1$ & $1$ & $1$ & $1$ & $1$ & $2$ & $4$ \\ +\bin{111110} & $5$ & $5$ & $5$ & $5$ & $5$ & $1$ & $5$ \\ +\bin{1111110} & $6$ & $6$ & $6$ & $6$ & $6$ & $6$ & $6$ \\ +\bin{1111111} & $7$ & $7$ & $7$ & $7$ & $7$ & $7$ & $7$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Macro Block Mode Schemes} +\label{tab:mode-codes} +\end{table} + +\begin{enumerate} +\item +If \bitvar{FTYPE} is 0 (intra frame): +\begin{enumerate} +\item +For each consecutive value of \locvar{\mbi} from 0 to $(\bitvar{NMBS}-1)$, + inclusive, assign $\bitvar{MBMODES}[\mbi]$ the value 1 (INTRA). +\end{enumerate} +\item +Otherwise (inter frame): +\begin{enumerate} +\item +Read a 3-bit unsigned integer as \locvar{MSCHEME}. +\item +If \locvar{MSCHEME} is 0: +\begin{enumerate} +\item +For each consecutive value of \locvar{MODE} from 0 to 7, inclusive: +\begin{enumerate} +\item +Read a 3-bit unsigned integer as \locvar{\mi}. +\item +Assign $\locvar{MALPHABET}[\mi]$ the value \locvar{MODE}. +\end{enumerate} +\end{enumerate} +\item +Otherwise, if \locvar{MSCHEME} is not 7, assign the entries of + \locvar{MALPHABET} the values in the corresponding column of + Table~\ref{tab:mode-codes}. +\item +For each consecutive macro block in coded order (cf. + Section~\ref{sec:mbs})---indexed by \locvar{\mbi}: +\begin{enumerate} +\item +If a block \locvar{\bi} in the luma plane of macro block \locvar{\mbi} exists + such that $\bitvar{BCODED}[\locvar{\bi}]$ is 1: +\begin{enumerate} +\item +If \locvar{MSCHEME} is not 7, read one bit at a time until one of the Huffman + codes in Table~\ref{tab:mode-codes} is recognized, and assign + $\bitvar{MBMODES}[\locvar{\mbi}]$ the value + $\locvar{MALPHABET}[\locvar{\mi}]$, where \locvar{\mi} is the index of the + Huffman code decoded. +\item +Otherwise, read a 3-bit unsigned integer as $\bitvar{MBMODES}[\locvar{\mbi}]$. +\end{enumerate} +\item +Otherwise, if no luma-plane blocks in the macro block are coded, assign + $\bitvar{MBMODES}[\locvar{\mbi}]$ the value 0 (INTER\_NOMV). +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\section{Motion Vectors} + +In an intra frame, no motion vectors are used, and so motion vector decoding is + skipped. +In an inter frame, however, many of the inter coding modes require a motion + vector in order to specify an offset into the reference frame from which to + predict a block. +These procedures assigns such a motion vector to every block. + +\subsection{Motion Vector Decode} +\label{sub:mv-decode} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{MVMODE} & Integer & 1 & No & The motion vector decoding method. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{MVX} & Integer & 6 & Yes & The X component of the motion + vector. \\ +\bitvar{MVY} & Integer & 6 & Yes & The Y component of the motion + vector. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{MVSIGN} & Integer & 1 & No & The sign of the motion vector component + just decoded. \\ +\bottomrule\end{tabularx} +\medskip + +The individual components of a motion vector can be coded using one of two + methods. +The first uses a variable length Huffman code, given in + Table~\ref{tab:mv-huff-codes}. +The second encodes the magnitude of the component directly in 5 bits, and the + sign in one bit. +Note that in this case there are two representations for the value zero. +For compatibility with VP3, a sign bit is read even if the magnitude read is + zero. +One scheme is chosen and used for the entire frame. + +Each component can take on integer values from $-31\ldots 31$, inclusive, at + half-pixel resolution, i.e. $-15.5\ldots 15.5$ pixels in the luma plane. +For each subsampled axis in the chroma planes, the corresponding motion vector + component is interpreted as being at quarter-pixel resolution, i.e. + $-7.75\ldots 7.75$ pixels. +The precise details of how these vectors are used to compute predictors for + each block are described in Section~\ref{sec:predictors}. + +\begin{table}[ht] +\begin{center} +\begin{tabular}{lrlr}\toprule +Huffman Code & Value & Huffman Code & Value \\\midrule +\bin{000} & $0$ \\ +\bin{001} & $1$ & \bin{010} & $-1$ \\ +\bin{0110} & $2$ & \bin{0111} & $-2$ \\ +\bin{1000} & $3$ & \bin{1001} & $-3$ \\ +\bin{101000} & $4$ & \bin{101001} & $-4$ \\ +\bin{101010} & $5$ & \bin{101011} & $-5$ \\ +\bin{101100} & $6$ & \bin{101101} & $-6$ \\ +\bin{101110} & $7$ & \bin{101111} & $-7$ \\ +\bin{1100000} & $8$ & \bin{1100001} & $-8$ \\ +\bin{1100010} & $9$ & \bin{1100011} & $-9$ \\ +\bin{1100100} & $10$ & \bin{1100101} & $-10$ \\ +\bin{1100110} & $11$ & \bin{1100111} & $-11$ \\ +\bin{1101000} & $12$ & \bin{1101001} & $-12$ \\ +\bin{1101010} & $13$ & \bin{1101011} & $-13$ \\ +\bin{1101100} & $14$ & \bin{1101101} & $-14$ \\ +\bin{1101110} & $15$ & \bin{1101111} & $-15$ \\ +\bin{11100000} & $16$ & \bin{11100001} & $-16$ \\ +\bin{11100010} & $17$ & \bin{11100011} & $-17$ \\ +\bin{11100100} & $18$ & \bin{11100101} & $-18$ \\ +\bin{11100110} & $19$ & \bin{11100111} & $-19$ \\ +\bin{11101000} & $20$ & \bin{11101001} & $-20$ \\ +\bin{11101010} & $21$ & \bin{11101011} & $-21$ \\ +\bin{11101100} & $22$ & \bin{11101101} & $-22$ \\ +\bin{11101110} & $23$ & \bin{11101111} & $-23$ \\ +\bin{11110000} & $24$ & \bin{11110001} & $-24$ \\ +\bin{11110010} & $25$ & \bin{11110011} & $-25$ \\ +\bin{11110100} & $26$ & \bin{11110101} & $-26$ \\ +\bin{11110110} & $27$ & \bin{11110111} & $-27$ \\ +\bin{11111000} & $28$ & \bin{11111001} & $-28$ \\ +\bin{11111010} & $29$ & \bin{11111011} & $-29$ \\ +\bin{11111100} & $30$ & \bin{11111101} & $-30$ \\ +\bin{11111110} & $31$ & \bin{11111111} & $-31$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Huffman Codes for Motion Vector Components} +\label{tab:mv-huff-codes} +\end{table} + +A single motion vector is decoded is follows: + +\begin{enumerate} +\item +If \bitvar{MVMODE} is 0: +\begin{enumerate} +\item +Read 1 bit at a time until one of the Huffman codes in + Table~\ref{tab:mv-huff-codes} is recognized, and assign the value to + \locvar{MVX}. +\item +Read 1 bit at a time until one of the Huffman codes in + Table~\ref{tab:mv-huff-codes} is recognized, and assign the value to + \locvar{MVY}. +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Read a 5-bit unsigned integer as \bitvar{MVX}. +\item +Read a 1-bit unsigned integer as \locvar{MVSIGN}. +\item +If \locvar{MVSIGN} is 1, assign \bitvar{MVX} the value $-\bitvar{MVX}$. +\item +Read a 5-bit unsigned integer as \bitvar{MVY}. +\item +Read a 1-bit unsigned integer as \locvar{MVSIGN}. +\item +If \locvar{MVSIGN} is 1, assign \bitvar{MVY} the value $-\bitvar{MVY}$. +\end{enumerate} +\end{enumerate} + +\subsection{Macro Block Motion Vector Decode} +\label{sub:mb-mv-decode} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{PF} & Integer & 2 & No & The pixel format. \\ +\bitvar{NMBS} & Integer & 32 & No & The total number of macro blocks in a + frame. \\ +\bitvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of coding + modes for each macro block. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{MVECTS} & \multicolumn{1}{p{50pt}}{Array of 2D Integer Vectors} & + 6 & Yes & An \bitvar{NBS}-element array of + motion vectors for each block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{LAST1} & \multicolumn{1}{p{50pt}}{2D Integer Vector} & + 6 & Yes & The last motion vector. \\ +\locvar{LAST2} & \multicolumn{1}{p{50pt}}{2D Integer Vector} & + 6 & Yes & The second to last motion vector. \\ +\locvar{MVX} & Integer & 6 & Yes & The X component of a motion vector. \\ +\locvar{MVY} & Integer & 6 & Yes & The Y component of a motion vector. \\ +\locvar{\mbi} & Integer & 32 & No & The index of the current macro + block. \\ +\locvar{A} & Integer & 36 & No & The index of the lower-left luma block + in the macro block. \\ +\locvar{B} & Integer & 36 & No & The index of the lower-right luma + block in the macro block. \\ +\locvar{C} & Integer & 36 & No & The index of the upper-left luma block + in the macro block. \\ +\locvar{D} & Integer & 36 & No & The index of the upper-right luma + block in the macro block. \\ +\locvar{E} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{F} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{G} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{H} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{I} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{J} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{K} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\locvar{L} & Integer & 36 & No & The index of a chroma block in the + macro block, depending on the pixel format. \\ +\bottomrule\end{tabularx} +\medskip + +Motion vectors are stored for each macro block. +In every mode except for INTER\_MV\_FOUR, every block in all the color planes + are assigned the same motion vector. +In INTER\_MV\_FOUR mode, all four blocks in the luma plane are assigned their + own motion vector, and motion vectors for blocks in the chroma planes are + computed from these, using averaging appropriate to the pixel format. + +For INTER\_MV and INTER\_GOLDEN\_MV modes, a single motion vector is decoded + and applied to each block. +For INTER\_MV\_FOUR macro blocks, a motion vector is decoded for each coded + luma block, in raster order, not coded order. +Uncoded luma blocks receive the default $(0,0)$ vector for the purposes of + computing the chroma motion vectors. + +None of the remaining macro block coding modes require decoding motion vectors + from the stream. +INTRA mode does not use a motion-compensated predictor, and thus does not + require a motion vector. +Both the INTER\_NOMV and the INTER\_GOLDEN\_NOMV modes use the default + vector $(0,0)$ for each block. +This also includes all macro blocks with no coded luma blocks, as they are + coded in INTER\_NOMV mode by definition. + +The modes INTER\_MV\_LAST and INTER\_MV\_LAST2 use the motion vector from the + last macro block (in coded order) and the second to last macro block, + respectively, that contained a motion vector pointing to the previous frame. +Thus no explicit motion vector needs to be decoded for these modes. +Macro blocks coded in INTRA mode or one of the GOLDEN modes are not considered + in this process. +For macro blocks coded in INTER\_MV\_FOUR mode, this process uses the vector + from the last coded luma block in the macro block, again in raster order, not + coded order. +This is usually the upper-right block. +If an insufficient number of macro blocks have been coded in one of the INTER + modes, then the $(0,0)$ vector is used instead. + +The motion vectors are decoded from the stream as follows: + +\begin{enumerate} +\item +Assign \locvar{LAST1} and \locvar{LAST2} both the value $(0,0)$. +\item +Read a 1-bit unsigned integer as \locvar{MVMODE}. +Note that this value is read even if no macro blocks require a motion vector to + be decoded. +\item +For each consecutive value of \locvar{\mbi} from 0 to $(\bitvar{NMBS}-1)$: +\begin{enumerate} +\item +If $\bitvar{MBMODES}[\locvar{\mbi}]$ is 7 (INTER\_MV\_FOUR): +\begin{enumerate} +\item +Let \locvar{A}, \locvar{B}, \locvar{C}, and \locvar{D} be the indices in coded + order \locvar{\bi} of the luma blocks in macro block \locvar{\mbi}, arranged + into raster order. +Thus, \locvar{A} is the index in coded order of the block in the lower left, + \locvar{B} the lower right, \locvar{C} the upper left, and \locvar{D} the + upper right. % TODO: as shown in Figure~REF. +\item If $\bitvar{BCODED}[\locvar{A}]$ is non-zero: +\begin{enumerate} +\item Decode a single motion vector into \locvar{MVX} and \locvar{MVY} using + the procedure described in Section~\ref{sub:mv-decode}. +\item Assign $\bitvar{MVECTS}[\locvar{A}]$ the value + $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item Otherwise, assign $\bitvar{MVECTS}[\locvar{A}]$ the value $(0,0)$. +\item If $\bitvar{BCODED}[\locvar{B}]$ is non-zero: +\begin{enumerate} +\item Decode a single motion vector into \locvar{MVX} and \locvar{MVY} using + the procedure described in Section~\ref{sub:mv-decode}. +\item Assign $\bitvar{MVECTS}[\locvar{B}]$ the value + $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item +Otherwise assign $\bitvar{MVECTS}[\locvar{B}]$ the value $(0,0)$. +\item If $\bitvar{BCODED}[\locvar{C}]$ is non-zero: +\begin{enumerate} +\item Decode a single motion vector into \locvar{MVX} and \locvar{MVY} using + the procedure described in Section~\ref{sub:mv-decode}. +\item Assign $\bitvar{MVECTS}[\locvar{C}]$ the value + $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item Otherwise assign $\bitvar{MVECTS}[\locvar{C}]$ the value $(0,0)$. +\item If $\bitvar{BCODED}[\locvar{D}]$ is non-zero: +\begin{enumerate} +\item Decode a single motion vector into \locvar{MVX} and \locvar{MVY} using + the procedure described in Section~\ref{sub:mv-decode}. +\item Assign $\bitvar{MVECTS}[\locvar{D}]$ the value + $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item +Otherwise, assign $\bitvar{MVECTS}[\locvar{D}]$ the value $(0,0)$. +\item +If \bitvar{PF} is 0 (4:2:0): +\begin{enumerate} +\item +Let \locvar{E} and \locvar{F} be the index in coded order of the one block in + the macro block from the $C_b$ and $C_r$ planes, respectively. +\item +Assign $\bitvar{MVECTS}[\locvar{E}]$ and $\bitvar{MVECTS}[\locvar{F}]$ the + value +\begin{multline*} +(\round\biggl(\frac{\begin{aligned} + \bitvar{MVECTS}[\locvar{A}]_x+\bitvar{MVECTS}[\locvar{B}]_x+\\ + \bitvar{MVECTS}[\locvar{C}]_x+\bitvar{MVECTS}[\locvar{D}]_x + \end{aligned}}{4}\biggr), \\ + \round\biggl(\frac{\begin{aligned} + \bitvar{MVECTS}[\locvar{A}]_y+\bitvar{MVECTS}[\locvar{B}]_y+\\ + \bitvar{MVECTS}[\locvar{C}]_y+\bitvar{MVECTS}[\locvar{D}]_y + \end{aligned}}{4}\biggr)) +\end{multline*} +\end{enumerate} +\item +If \bitvar{PF} is 2 (4:2:2): +\begin{enumerate} +\item +Let \locvar{E} and \locvar{F} be the indices in coded order of the bottom and + top blocks in the macro block from the $C_b$ plane, respectively, and + \locvar{G} and \locvar{H} be the indices in coded order of the bottom and top + blocks in the $C_r$ plane, respectively. %TODO: as shown in Figure~REF. +\item +Assign $\bitvar{MVECTS}[\locvar{E}]$ and $\bitvar{MVECTS}[\locvar{G}]$ the + value +\begin{multline*} +(\round\left(\frac{ + \bitvar{MVECTS}[\locvar{A}]_x+\bitvar{MVECTS}[\locvar{B}]_x}{2}\right), \\ + \round\left(\frac{ + \bitvar{MVECTS}[\locvar{A}]_y+\bitvar{MVECTS}[\locvar{B}]_y}{2}\right)) +\end{multline*} +\item +Assign $\bitvar{MVECTS}[\locvar{F}]$ and $\bitvar{MVECTS}[\locvar{H}]$ the + value +\begin{multline*} +(\round\left(\frac{ + \bitvar{MVECTS}[\locvar{C}]_x+\bitvar{MVECTS}[\locvar{D}]_x}{2}\right), \\ + \round\left(\frac{ + \bitvar{MVECTS}[\locvar{C}]_y+\bitvar{MVECTS}[\locvar{D}]_y}{2}\right)) +\end{multline*} +\end{enumerate} +\item +If \bitvar{PF} is 3 (4:4:4): +\begin{enumerate} +\item +Let \locvar{E}, \locvar{F}, \locvar{G}, and \locvar{H} be the indices + \locvar{\bi} in coded order of the $C_b$ plane blocks in macro block + \locvar{\mbi}, arranged into raster order, and \locvar{I}, \locvar{J}, + \locvar{K}, and \locvar{L} be the indices \locvar{\bi} in coded order of the + $C_r$ plane blocks in macro block \locvar{\mbi}, arranged into raster order. + %TODO: as shown in Figure~REF. +\item +Assign $\bitvar{MVECTS}[\locvar{E}]$ and $\bitvar{MVECTS}[\locvar{I}]$ the + value \\ $\bitvar{MVECTS}[\locvar{A}]$. +\item +Assign $\bitvar{MVECTS}[\locvar{F}]$ and $\bitvar{MVECTS}[\locvar{J}]$ the + value \\ $\bitvar{MVECTS}[\locvar{B}]$. +\item +Assign $\bitvar{MVECTS}[\locvar{G}]$ and $\bitvar{MVECTS}[\locvar{K}]$ the + value \\ $\bitvar{MVECTS}[\locvar{C}]$. +\item +Assign $\bitvar{MVECTS}[\locvar{H}]$ and $\bitvar{MVECTS}[\locvar{L}]$ the + value \\ $\bitvar{MVECTS}[\locvar{D}]$. +\end{enumerate} +\item +Assign \locvar{LAST2} the value \locvar{LAST1}. +\item +Assign \locvar{LAST1} the value $(\locvar{MVX},\locvar{MVY})$. +This is the value of the motion vector decoded from the last coded luma block + in raster order. +There must always be at least one, since macro blocks with no coded luma blocks + must use mode 0:~INTER\_NOMV. +\end{enumerate} +\item +Otherwise, if $\bitvar{MBMODES}[\locvar{\mbi}]$ is 6 (INTER\_GOLDEN\_MV), + decode a single motion vector into \locvar{MVX} and \locvar{MVY} using the + procedure described in Section~\ref{sub:mv-decode}. +\item +Otherwise, if $\bitvar{MBMODES}[\locvar{\mbi}]$ is 4 (INTER\_MV\_LAST2): +\begin{enumerate} +\item +Assign $(\locvar{MVX},\locvar{MVY})$ the value \locvar{LAST2}. +\item +Assign \locvar{LAST2} the value \locvar{LAST1}. +\item +Assign \locvar{LAST1} the value $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item +Otherwise, if $\bitvar{MBMODES}[\locvar{\mbi}]$ is 3 (INTER\_MV\_LAST), assign + $(\locvar{MVX},\locvar{MVY})$ the value \locvar{LAST1}. +\item +Otherwise, if $\bitvar{MBMODES}[\locvar{\mbi}]$ is 2 (INTER\_MV): +\begin{enumerate} +\item +Decode a single motion vector into \locvar{MVX} and \locvar{MVY} using the + procedure described in Section~\ref{sub:mv-decode}. +\item +Assign \locvar{LAST2} the value \locvar{LAST1}. +\item +Assign \locvar{LAST1} the value $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\item +Otherwise ($\bitvar{MBMODES}[\locvar{\mbi}]$ is 5:~INTER\_GOLDEN\_NOMV, + 1:~INTRA, or 0:~INTER\_NOMV), assign \locvar{MVX} and \locvar{MVY} the value + zero. +\item +If $\bitvar{MBMODES}[\locvar{\mbi}]$ is not 7 (not INTER\_MV\_FOUR), then for + each coded block \locvar{\bi} in macro block \locvar{\mbi}: +\begin{enumerate} +\item +Assign $\bitvar{MVECTS}[\locvar{\bi}]$ the value $(\locvar{MVX},\locvar{MVY})$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +Unless all four luma blocks in the macro block are coded, the VP3 encoder does + not select mode INTER\_MV\_FOUR. +Theora removes this restriction by treating the motion vector for an uncoded + luma block as the default $(0,0)$ vector. +This is consistent with the premise that the block has not changed since the + previous frame and that chroma information can be largely ignored when + estimating motion. + +No modification is required for INTER\_MV\_FOUR macro blocks in VP3 streams to + be decoded correctly by a Theora decoder. +However, regardless of how many of the luma blocks are actually coded, the VP3 + decoder always reads four motion vectors from the stream for INTER\_MV\_FOUR + mode. +The motion vectors read are used to calculate the motion vectors for the chroma + blocks, but are otherwise ignored. +Thus, care should be taken when creating Theora streams meant to be backwards + compatible with VP3 to only use INTER\_MV\_FOUR mode when all four luma + blocks are coded. + +\section{Block-Level \qi\ Decode} +\label{sub:block-qis} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bitvar{NQIS} & Integer & 2 & No & The number of \qi\ values. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{QIIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 2 & No & An \bitvar{NBS}-element array of + \locvar{\qii} values for each block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{NBITS} & Integer & 36 & No & The length of a bit string to decode. \\ +\locvar{BITS} & Bit string & & & A decoded set of flags. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\qii} & Integer & 2 & No & The index of \qi\ value in the list of + \qi\ values defined for this frame. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure selects the \qi\ value to be used for dequantizing the AC + coefficients of each block. +DC coefficients all use the same \qi\ value, so as to avoid interference with + the DC prediction mechanism, which occurs in the quantized domain. + +The value is actually represented by an index \locvar{\qii} into the list of + \qi\ values defined for the frame. +The decoder makes multiple passes through the list of coded blocks, one for + each \qi\ value except the last one. +In each pass, an RLE-coded bitmask is decoded to divide the blocks into two + groups: those that use the current \qi\ value in the list, and those that use + a value from later in the list. +Each subsequent pass is restricted to the blocks in the second group. + +\begin{enumerate} +\item +For each value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$, assign + $\bitvar{QIIS}[\locvar{\bi}]$ the value zero. +\item +For each consecutive value of \locvar{\qii} from 0 to $(\bitvar{NQIS}-2)$: +\begin{enumerate} +\item +Assign \locvar{NBITS} be the number of blocks \locvar{\bi} such that + $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero and $\bitvar{QIIS}[\locvar{\bi}]$ + equals $\locvar{\qii}$. +\item +Read an \locvar{NBITS}-bit bit string into \locvar{BITS}, using the procedure + described in Section~\ref{sub:long-run}. +This represents the list of blocks that use \qi\ value \locvar{\qii} or higher. +\item +For each consecutive value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$ such + that $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero and + $\bitvar{QIIS}[\locvar{\bi}]$ equals $\locvar{\qii}$: +\begin{enumerate} +\item +Remove the bit at the head of the string \locvar{BITS} and add its value to + $\bitvar{QIIS}[\locvar{\bi}]$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +For VP3 compatible streams, only one \qi\ value can be specified in the frame + header, so the main loop of the above procedure, which would iterate from $0$ + to $-1$, is never executed. +Thus, no bits are read, and each block uses the one \qi\ value defined for the + frame. + +\cleardoublepage + +\section{DCT Coefficients} +\label{sec:dct-decode} + +The quantized DCT coefficients are decoded by making 64 passes through the list + of coded blocks, one for each token index in zig-zag order. +For the DC tokens, two Huffman tables are chosen from among the first 16, one + for the luma plane and one for the chroma planes. +The AC tokens, however, are divided into four different groups. +Again, two 4-bit indices are decoded, one for the luma plane, and one for the + chroma planes, but these select the codebooks for {\em all four} groups. +AC coefficients in group one use codebooks $16\ldots 31$, while group two uses + $32\ldots 47$, etc. +Note that this second set of indices is decoded even if there are no non-zero + AC coefficients in the frame. + +Tokens are divided into two major types: EOB tokens, which fill the remainder + of one or more blocks with zeros, and coefficient tokens, which fill in one or + more coefficients within a single block. +A decoding procedure for the first is given in Section~\ref{sub:eob-token}, and + for the second in Section~\ref{sub:coeff-token}. +The decoding procedure for the complete set of quantized coefficients is given + in Section~\ref{sub:dct-coeffs}. + +\subsection{EOB Token Decode} +\label{sub:eob-token} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{TOKEN} & Integer & 5 & No & The token being decoded. +This must be in the range $0\ldots 6$. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{TIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + current token index for each block. \\ +\bitvar{NCOEFFS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + coefficient count for each block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\bitvar{\ti} & Integer & 6 & No & The current token index. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{TIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + current token index for each block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{EOBS} & Integer & 36 & No & The remaining length of the current + EOB run. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\bj} & Integer & 36 & No & Another index of a block in coded + order. \\ +\locvar{\tj} & Integer & 6 & No & Another token index. \\ +\bottomrule\end{tabularx} +\medskip + +A summary of the EOB tokens is given in Table~\ref{tab:eob-tokens}. +An important thing to note is that token 6 does not add an offset to the + decoded run value, even though in general it should only be used for runs of + size 32 or longer. +If a value of zero is decoded for this run, it is treated as an EOB run the + size of the remaining coded blocks. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{ccl}\toprule +Token Value & Extra Bits & EOB Run Lengths \\\midrule +$0$ & $0$ & $1$ \\ +$1$ & $0$ & $2$ \\ +$2$ & $0$ & $3$ \\ +$3$ & $2$ & $4\ldots 7$ \\ +$4$ & $3$ & $8\ldots 15$ \\ +$5$ & $4$ & $16\ldots 31$ \\ +$6$ & $12$ & $1\ldots 4095$, or all remaining blocks \\ +\bottomrule\end{tabular} +\end{center} +\caption{EOB Token Summary} +\label{tab:eob-tokens} +\end{table} + +There is no restriction that one EOB token cannot be immediately followed by + another, so no special cases are necessary to extend the range of the maximum + run length as were required in Section~\ref{sub:long-run}. +Indeed, depending on the lengths of the Huffman codes, it may even cheaper to + encode, by way of example, an EOB run of length 31 followed by an EOB run of + length 1 than to encode an EOB run of length 32 directly. +There is also no restriction that an EOB run stop at the end of a color plane + or a token index. +The run MUST, however, end at or before the end of the frame. + +\begin{enumerate} +\item +If \bitvar{TOKEN} is 0, assign \bitvar{EOBS} the value 1. +\item +Otherwise, if \bitvar{TOKEN} is 1, assign \bitvar{EOBS} the value 2. +\item +Otherwise, if \bitvar{TOKEN} is 2, assign \bitvar{EOBS} the value 3. +\item +Otherwise, if \bitvar{TOKEN} is 3: +\begin{enumerate} +\item +Read a 2-bit unsigned integer as \bitvar{EOBS}. +\item +Assign \bitvar{EOBS} the value $(\bitvar{EOBS}+4)$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 4: +\begin{enumerate} +\item +Read a 3-bit unsigned integer as \bitvar{EOBS}. +\item +Assign \bitvar{EOBS} the value $(\bitvar{EOBS}+8)$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 5: +\begin{enumerate} +\item +Read a 4-bit unsigned integer as \bitvar{EOBS}. +\item +Assign \bitvar{EOBS} the value $(\bitvar{EOBS}+16)$. +\end{enumerate} +\item +Otherwise, \bitvar{TOKEN} is 6: +\begin{enumerate} +\item +Read a 12-bit unsigned integer as \bitvar{EOBS}. +\item +If \bitvar{EOBS} is zero, assign \bitvar{EOBS} to be the number of coded blocks + \locvar{\bj} such that $\bitvar{TIS}[\locvar{\bj}]$ is less than 64. +\end{enumerate} +\item +For each value of \locvar{\tj} from $\bitvar{\ti}$ to 63, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value 64. +\item +Assign \bitvar{EOBS} the value $(\bitvar{EOBS}-1)$. +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The VP3 encoder does not use the special interpretation of a zero-length EOB + run, though its decoder {\em does} support it. +That may be due more to a happy accident in the way the decoder was written + than intentional design, however, and other VP3 implementations might not + reproduce it faithfully. +For backwards compatibility, it may be wise to avoid it, especially as for most + frame sizes there are fewer than 4095 blocks, making it unnecessary. + +\subsection{Coefficient Token Decode} +\label{sub:coeff-token} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{TOKEN} & Integer & 5 & No & The token being decoded. +This must be in the range $7\ldots 31$. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{TIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + current token index for each block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\bitvar{\ti} & Integer & 6 & No & The current token index. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{TIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + current token index for each block. \\ +\bitvar{NCOEFFS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + coefficient count for each block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{SIGN} & Integer & 1 & No & A flag indicating the sign of the + current coefficient. \\ +\locvar{MAG} & Integer & 10 & No & The magnitude of the current + coefficient. \\ +\locvar{RLEN} & Integer & 6 & No & The length of the current zero run. \\ +\locvar{\tj} & Integer & 6 & No & Another token index. \\ +\bottomrule\end{tabularx} +\medskip + +Each of these tokens decodes one or more coefficients in the current block. +A summary of the meanings of the token values is presented in + Table~\ref{tab:coeff-tokens}. +There are often several different ways to tokenize a given coefficient list. +Which one is optimal depends on the exact lengths of the Huffman codes used to + represent each token. +Note that we do not update the coefficient count for the block if we decode a + pure zero run. + +\begin{table}[htbp] +\begin{center} +\begin{tabularx}{\textwidth}{cclX}\toprule +Token Value & Extra Bits & \multicolumn{1}{p{55pt}}{Number of Coefficients} + & Description \\\midrule +$7$ & $3$ & $1\ldots 8$ & Short zero run. \\ +$8$ & $6$ & $1\ldots 64$ & Zero run. \\ +$9$ & $0$ & $1$ & $1$. \\ +$10$ & $0$ & $1$ & $-1$. \\ +$11$ & $0$ & $1$ & $2$. \\ +$12$ & $0$ & $1$ & $-2$. \\ +$13$ & $1$ & $1$ & $\pm 3$. \\ +$14$ & $1$ & $1$ & $\pm 4$. \\ +$15$ & $1$ & $1$ & $\pm 5$. \\ +$16$ & $1$ & $1$ & $\pm 6$. \\ +$17$ & $2$ & $1$ & $\pm 7\ldots 8$. \\ +$18$ & $3$ & $1$ & $\pm 9\ldots 12$. \\ +$19$ & $4$ & $1$ & $\pm 13\ldots 20$. \\ +$20$ & $5$ & $1$ & $\pm 21\ldots 36$. \\ +$21$ & $6$ & $1$ & $\pm 37\ldots 68$. \\ +$22$ & $10$ & $1$ & $\pm 69\ldots 580$. \\ +$23$ & $1$ & $2$ & One zero followed by $\pm 1$. \\ +$24$ & $1$ & $3$ & Two zeros followed by $\pm 1$. \\ +$25$ & $1$ & $4$ & Three zeros followed by + $\pm 1$. \\ +$26$ & $1$ & $5$ & Four zeros followed by + $\pm 1$. \\ +$27$ & $1$ & $6$ & Five zeros followed by + $\pm 1$. \\ +$28$ & $3$ & $7\ldots 10$ & $6\ldots 9$ zeros followed by + $\pm 1$. \\ +$29$ & $4$ & $11\ldots 18$ & $10\ldots 17$ zeros followed by + $\pm 1$.\\ +$30$ & $2$ & $2$ & One zero followed by + $\pm 2\ldots 3$. \\ +$31$ & $3$ & $3\ldots 4$ & $2\ldots 3$ zeros followed by + $\pm 2\ldots 3$. \\ +\bottomrule\end{tabularx} +\end{center} +\caption{Coefficient Token Summary} +\label{tab:coeff-tokens} +\end{table} + +For tokens which represent more than one coefficient, they MUST NOT bring the + total number of coefficients in the block to more than 64. +Care should be taken in a decoder to check for this, as otherwise it may permit + buffer overflows from invalidly formed packets. +\begin{verse} +{\bf Note:} One way to achieve this efficiently is to combine the inverse + zig-zag mapping (described later in Section~\ref{sub:dequant}) with + coefficient decode, and use a table look-up to map zig-zag indices greater + than 63 to a safe location. +\end{verse} + +\begin{enumerate} +\item +If \bitvar{TOKEN} is 7: +\begin{enumerate} +\item +Read in a 3-bit unsigned integer as \locvar{RLEN}. +\item +Assign \locvar{RLEN} the value $(\locvar{RLEN}+1)$. +\item +For each value of \locvar{\tj} from \bitvar{\ti} to + $(\bitvar{\ti}+\locvar{RLEN}-1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value + $\bitvar{TIS}[\bitvar{\bi}]+\locvar{RLEN}$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 8: +\begin{enumerate} +\item +Read in a 6-bit unsigned integer as \locvar{RLEN}. +\item +Assign \locvar{RLEN} the value $(\locvar{RLEN}+1)$. +\item +For each value of \locvar{\tj} from \bitvar{\ti} to + $(\bitvar{\ti}+\locvar{RLEN}-1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value + $\bitvar{TIS}[\bitvar{\bi}]+\locvar{RLEN}$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 9: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 10: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 11: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $2$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 12: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-2$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 13: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $3$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-3$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 14: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $4$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-4$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 15: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $5$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-5$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 16: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $6$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value $-6$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 17: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 1-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+7)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 18: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 2-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+9)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 19: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 3-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+13)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 20: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 4-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+21)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 21: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 5-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+37)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 22: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 9-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+69)$. +\item +If \locvar{SIGN} is zero, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ + the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 23: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}]$ the value zero. +\item +Read a 1-bit unsigned integer as SIGN. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+1]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+1]$ the value + $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+2$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 24: +\begin{enumerate} +\item +For each value of \locvar{\tj} from \bitvar{\ti} to $(\bitvar{\ti}+1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Read a 1-bit unsigned integer as SIGN. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+2]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+2]$ the value + $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+3$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 25: +\begin{enumerate} +\item +For each value of \locvar{\tj} from \bitvar{\ti} to $(\bitvar{\ti}+2)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Read a 1-bit unsigned integer as SIGN. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+3]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+3]$ the value + $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+4$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 26: +\begin{enumerate} +\item +For each value of \locvar{\tj} from \bitvar{\ti} to $(\bitvar{\ti}+3)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Read a 1-bit unsigned integer as SIGN. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+4]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+4]$ the value + $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+5$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 27: +\begin{enumerate} +\item +For each value of \locvar{\tj} from \bitvar{\ti} to $(\bitvar{\ti}+4)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Read a 1-bit unsigned integer as SIGN. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+5]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+5]$ the value + $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+6$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 28: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 2-bit unsigned integer as \locvar{RLEN}. +\item +Assign \locvar{RLEN} the value $(\locvar{RLEN}+6)$. +\item +For each value of \locvar{\tj} from \bitvar{\ti} to + $(\bitvar{\ti}+\locvar{RLEN}-1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ + the value $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value + $\bitvar{TIS}[\bitvar{\bi}]+\locvar{RLEN}+1$. +\item +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 29: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 3-bit unsigned integer as \locvar{RLEN}. +\item +Assign \locvar{RLEN} the value $(\locvar{RLEN}+10)$. +\item +For each value of \locvar{\tj} from \bitvar{\ti} to + $(\bitvar{\ti}+\locvar{RLEN}-1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ the value $1$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ + the value $-1$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value + $\bitvar{TIS}[\bitvar{\bi}]+\locvar{RLEN}+1$. +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 30: +\begin{enumerate} +\item +Assign $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\ti}]$ the value zero. +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 1-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+2)$. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+1]$ the value $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+1]$ the value + $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]+2$. +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\item +Otherwise, if \bitvar{TOKEN} is 31: +\begin{enumerate} +\item +Read a 1-bit unsigned integer as \locvar{SIGN}. +\item +Read a 1-bit unsigned integer as \locvar{MAG}. +\item +Assign \locvar{MAG} the value $(\locvar{MAG}+2)$. +\item +Read a 1-bit unsigned integer as \locvar{RLEN}. +\item +Assign \locvar{RLEN} the value $(\locvar{RLEN}+2)$. +\item +For each value of \locvar{\tj} from \bitvar{\ti} to + $(\bitvar{\ti}+\locvar{RLEN}-1)$, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\tj}]$ the value zero. +\item +If \locvar{SIGN} is zero, assign + $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ the value + $\locvar{MAG}$. +\item +Otherwise, assign $\bitvar{COEFFS}[\bitvar{\bi}][\bitvar{\ti}+\locvar{RLEN}]$ + the value $-\locvar{MAG}$. +\item +Assign $\bitvar{TIS}[\bitvar{\bi}]$ the value + $\bitvar{TIS}[\bitvar{\bi}]+\locvar{RLEN}+1$. +Assign $\bitvar{NCOEFFS}[\bitvar{\bi}]$ the value $\bitvar{TIS}[\bitvar{\bi}]$. +\end{enumerate} +\end{enumerate} + +\subsection{DCT Coefficient Decode} +\label{sub:dct-coeffs} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bitvar{NMBS} & Integer & 32 & No & The total number of macro blocks in a + frame. \\ +\bitvar{HTS} & \multicolumn{3}{l}{Huffman table array} + & An 80-element array of Huffman tables + with up to 32 entries each. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{NCOEFFS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + coefficient count for each block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{NLBS} & Integer & 34 & No & The number of blocks in the luma + plane. \\ +\locvar{TIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + current token index for each block. \\ +\locvar{EOBS} & Integer & 36 & No & The remaining length of the current + EOB run. \\ +\locvar{TOKEN} & Integer & 5 & No & The current token being decoded. \\ +\locvar{HG} & Integer & 3 & No & The current Huffman table group. \\ +\locvar{\cbi} & Integer & 36 & No & The index of the current block in the + coded block list. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\bj} & Integer & 36 & No & Another index of a block in coded + order. \\ +\locvar{\ti} & Integer & 6 & No & The current token index. \\ +\locvar{\tj} & Integer & 6 & No & Another token index. \\ +\locvar{\hti_L} & Integer & 4 & No & The index of the current Huffman table + to use for the luma plane within a group. \\ +\locvar{\hti_C} & Integer & 4 & No & The index of the current Huffman table + to use for the chroma planes within a group. \\ +\locvar{\hti} & Integer & 7 & No & The index of the current Huffman table + to use. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure puts the above two procedures to work to decode the entire set + of DCT coefficients for the frame. +At the end of this procedure, \locvar{EOBS} MUST be zero, and + $\locvar{TIS}[\locvar{\bi}]$ MUST be 64 for every coded \locvar{\bi}. + +Note that we update the coefficient count of every block before continuing an + EOB run or decoding a token, despite the fact that it is already up to date + unless the previous token was a pure zero run. +This is done intentionally to mimic the VP3 accounting rules. +Thus the only time the coefficient count does not include the coefficients in a + pure zero run is when when that run reaches all the way to coefficient 63. +Note, however, that regardless of the coefficient count, any additional + coefficients are still set to zero. +The only use of the count is in determining if a special case of the inverse + DCT can be used in Section~\ref{sub:2d-idct}. + +\begin{enumerate} +\item +Assign \locvar{NLBS} the value $(\bitvar{NMBS}*4)$. +\item +For each consecutive value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$, + assign $\locvar{TIS}[\locvar{\bi}]$ the value zero. +\item +Assign \locvar{EOBS} the value 0. +\item +For each consecutive value of \locvar{\ti} from 0 to 63: +\begin{enumerate} +\item +If \locvar{\ti} is $0$ or $1$: +\begin{enumerate} +\item +Read a 4-bit unsigned integer as \locvar{\hti_L}. +\item +Read a 4-bit unsigned integer as \locvar{\hti_C}. +\end{enumerate} +\item +For each consecutive value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$ for + which $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero and + $\locvar{TIS}[\locvar{\bi}]$ equals \locvar{\ti}: +\begin{enumerate} +\item +Assign $\bitvar{NCOEFFS}[\locvar{\bi}]$ the value \locvar{\ti}. +\item +If \locvar{EOBS} is greater than zero: +\begin{enumerate} +\item +For each value of \locvar{\tj} from $\locvar{\ti}$ to 63, assign + $\bitvar{COEFFS}[\locvar{\bi}][\locvar{\tj}]$ the value zero. +\item +Assign $\locvar{TIS}[\locvar{\bi}]$ the value 64. +\item +Assign \locvar{EOBS} the value $(\locvar{EOBS}-1)$. +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Assign \locvar{HG} a value based on \locvar{\ti} from + Table~\ref{tab:huff-groups}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{lc}\toprule +\locvar{\ti} & \locvar{HG} \\\midrule +$0$ & $0$ \\ +$1\ldots 5$ & $1$ \\ +$6\ldots 14$ & $2$ \\ +$15\ldots 27$ & $3$ \\ +$28\ldots 63$ & $4$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Huffman Table Groups} +\label{tab:huff-groups} +\end{table} + +\item +If \locvar{\bi} is less than \locvar{NLBS}, assign \locvar{\hti} the value + $(16*\locvar{HG}+\locvar{\hti_L})$. +\item +Otherwise, assign \locvar{\hti} the value + $(16*\locvar{HG}+\locvar{\hti_C})$. +\item +Read one bit at a time until one of the codes in $\bitvar{HTS}[\locvar{\hti}]$ + is recognized, and assign the value to \locvar{TOKEN}. +\item +If \locvar{TOKEN} is less than 7, expand an EOB token using the procedure given + in Section~\ref{sub:eob-token} to update $\locvar{TIS}[\locvar{\bi}]$, + $\bitvar{COEFFS}[\locvar{\bi}]$, and \locvar{EOBS}. +\item +Otherwise, expand a coefficient token using the procedure given in + Section~\ref{sub:coeff-token} to update $\locvar{TIS}[\locvar{\bi}]$, + $\bitvar{COEFFS}[\locvar{\bi}]$, and $\bitvar{NCOEFFS}[\locvar{\bi}]$. +\end{enumerate} +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\section{Undoing DC Prediction} + +The actual value of a DC coefficient decoded by Section~\ref{sec:dct-decode} is + the residual from a predicted value computed by the encoder. +This prediction is only applied to DC coefficients. +Quantized AC coefficients are encoded directly. + +This section describes how to undo this prediction to recover the original + DC coefficients. +The predicted DC value for a block is computed from the DC values of its + immediate neighbors which precede the block in raster order. +Thus, reversing this prediction must procede in raster order, instead of coded + order. + +Note that this step comes before dequantizing the coefficients. +For this reason, DC coefficients are all quantized with the same \qi\ value, + regardless of the block-level \qi\ values decoded in + Section~\ref{sub:block-qis}. +Those \qi\ values are applied only to the AC coefficients. + +\subsection{Computing the DC Predictor} +\label{sub:dc-pred} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bitvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of + coding modes for each macro block. \\ +\bitvar{LASTDC} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & A 3-element array containing the + most recently decoded DC value, one for inter mode and for each reference + frame. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{DCPRED} & Integer & 16 & Yes & The predicted DC value for the current + block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{P} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & A 4-element array indicating which + neighbors can be used for DC prediction. \\ +\locvar{PBI} & \multicolumn{1}{p{40pt}}{Integer Array} & + 36 & No & A 4-element array containing the + coded-order block index of the current block's neighbors. \\ +\locvar{W} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & Yes & A 4-element array of the weights to + apply to each neighboring DC value. \\ +\locvar{PDIV} & Integer & 8 & No & The value to divide the weighted sum + by. \\ +\locvar{\bj} & Integer & 36 & No & The index of a neighboring block in + coded order. \\ +\locvar{\mbi} & Integer & 32 & No & The index of the macro block + containing block \bitvar{\bi}. \\ +\locvar{\mbj} & Integer & 32 & No & The index of the macro block + containing block \locvar{\bj}. \\ +\locvar{\rfi} & Integer & 2 & No & The index of the reference frame + indicated by the coding mode for macro block \locvar{\mbi}. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure outlines how a predictor is formed for a single block. + +The predictor is computed as a weighted sum of the neighboring DC values from + coded blocks which use the same reference frame. +This latter condition is determined only by checking the coding mode for the + block. +Even if the golden frame and the previous frame are in fact the same, e.g. for + the first inter frame after an intra frame, they are still treated as being + different for the purposes of DC prediction. +The weighted sum is divided by a power of two, with truncation towards zero, + and the result is checked for outranging if necessary. + +If there are no neighboring coded blocks which use the same reference frame as + the current block, then the most recent DC value of any block that used that + reference frame is used instead. +If no such block exists, then the predictor is set to zero. + +\begin{enumerate} +\item +Assign \locvar{\mbi} the index of the macro block containing block + \bitvar{\bi}. +\item +Assign \locvar{\rfi} the value of the Reference Frame Index column of + Table~\ref{tab:cm-refs} corresponding to $\bitvar{MBMODES}[\locvar{\mbi}]$. + +\begin{table}[htpb] +\begin{center} +\begin{tabular}{ll}\toprule +Coding Mode & Reference Frame Index \\\midrule +$0$ (INTER\_NOMV) & $1$ (Previous) \\ +$1$ (INTRA) & $0$ (None) \\ +$2$ (INTER\_MV) & $1$ (Previous) \\ +$3$ (INTER\_MV\_LAST) & $1$ (Previous) \\ +$4$ (INTER\_MV\_LAST2) & $1$ (Previous) \\ +$5$ (INTER\_GOLDEN\_NOMV) & $2$ (Golden) \\ +$6$ (INTER\_GOLDEN\_MV) & $2$ (Golden) \\ +$7$ (INTER\_MV\_FOUR) & $1$ (Previous) \\ +\bottomrule\end{tabular} +\end{center} +\caption{Reference Frames for Each Coding Mode} +\label{tab:cm-refs} +\end{table} + +\item +If block \bitvar{\bi} is not along the left edge of the coded frame: +\begin{enumerate} +\item +Assign \locvar{\bj} the coded-order index of block \bitvar{\bi}'s left + neighbor, i.e., in the same row but one column to the left. +\item +If $\bitvar{BCODED}[\bj]$ is not zero: +\begin{enumerate} +\item +Assign \locvar{\mbj} the index of the macro block containing block + \locvar{\bj}. +\item +If the value of the Reference Frame Index column of Table~\ref{tab:cm-refs} + corresonding to $\bitvar{MBMODES}[\locvar{\mbj}]$ equals \locvar{\rfi}: +\begin{enumerate} +\item +Assign $\locvar{P}[0]$ the value $1$. +\item +Assign $\locvar{PBI}[0]$ the value \locvar{\bj}. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[0]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[0]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[0]$ the value zero. + +\item +If block \bitvar{\bi} is not along the left edge nor the bottom edge of the + coded frame: +\begin{enumerate} +\item +Assign \locvar{\bj} the coded-order index of block \bitvar{\bi}'s lower-left + neighbor, i.e., one row down and one column to the left. +\item +If $\bitvar{BCODED}[\bj]$ is not zero: +\begin{enumerate} +\item +Assign \locvar{\mbj} the index of the macro block containing block + \locvar{\bj}. +\item +If the value of the Reference Frame Index column of Table~\ref{tab:cm-refs} + corresonding to $\bitvar{MBMODES}[\locvar{\mbj}]$ equals \locvar{\rfi}: +\begin{enumerate} +\item +Assign $\locvar{P}[1]$ the value $1$. +\item +Assign $\locvar{PBI}[1]$ the value \locvar{\bj}. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[1]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[1]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[1]$ the value zero. + +\item +If block \bitvar{\bi} is not along the bottom edge of the coded frame: +\begin{enumerate} +\item +Assign \locvar{\bj} the coded-order index of block \bitvar{\bi}'s lower + neighbor, i.e., in the same column but one row down. +\item +If $\bitvar{BCODED}[\bj]$ is not zero: +\begin{enumerate} +\item +Assign \locvar{\mbj} the index of the macro block containing block + \locvar{\bj}. +\item +If the value of the Reference Frame Index column of Table~\ref{tab:cm-refs} + corresonding to $\bitvar{MBMODES}[\locvar{\mbj}]$ equals \locvar{\rfi}: +\begin{enumerate} +\item +Assign $\locvar{P}[2]$ the value $1$. +\item +Assign $\locvar{PBI}[2]$ the value \locvar{\bj}. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[2]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[2]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[2]$ the value zero. + +\item +If block \bitvar{\bi} is not along the right edge nor the bottom edge of the + coded frame: +\begin{enumerate} +\item +Assign \locvar{\bj} the coded-order index of block \bitvar{\bi}'s lower-right + neighbor, i.e., one row down and one column to the right. +\item +If $\bitvar{BCODED}[\bj]$ is not zero: +\begin{enumerate} +\item +Assign \locvar{\mbj} the index of the macro block containing block + \locvar{\bj}. +\item +If the value of the Reference Frame Index column of Table~\ref{tab:cm-refs} + corresonding to $\bitvar{MBMODES}[\locvar{\mbj}]$ equals \locvar{\rfi}: +\begin{enumerate} +\item +Assign $\locvar{P}[3]$ the value $1$. +\item +Assign $\locvar{PBI}[3]$ the value \locvar{\bj}. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[3]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[3]$ the value zero. +\end{enumerate} +\item +Otherwise, assign $\locvar{P}[3]$ the value zero. + +\item +If none of the values $\locvar{P}[0]$, $\locvar{P}[1]$, $\locvar{P}[2]$, nor + $\locvar{P}[3]$ are non-zero, then assign \bitvar{DCPRED} the value + $\bitvar{LASTDC}[\locvar{\rfi}]$. +\item +Otherwise: +\begin{enumerate} +\item +Assign the array \locvar{W} and the variable \locvar{PDIV} the values from the + row of Table~\ref{tab:dc-weights} corresonding to the values of each + $\locvar{P}[\idx{i}]$. + +\begin{table}[htb] +\begin{center} +\begin{tabular}{ccccrrrrr}\toprule +\multicolumn{1}{p{25pt}}{\centering$\locvar{P}[0]$ (L)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{P}[1]$ (DL)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{P}[2]$ (D)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{P}[3]$ (DR)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{W}[0]$ (L)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{W}[1]$ (DL)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{W}[2]$ (D)} & +\multicolumn{1}{p{25pt}}{\centering$\locvar{W}[3]$ (DR)} & +\locvar{PDIV} \\\midrule +$1$ & $0$ & $0$ & $0$ & $1$ & $0$ & $0$ & $0$ & $1$ \\ +$0$ & $1$ & $0$ & $0$ & $0$ & $1$ & $0$ & $0$ & $1$ \\ +$1$ & $1$ & $0$ & $0$ & $1$ & $0$ & $0$ & $0$ & $1$ \\ +$0$ & $0$ & $1$ & $0$ & $0$ & $0$ & $1$ & $0$ & $1$ \\ +$1$ & $0$ & $1$ & $0$ & $1$ & $0$ & $1$ & $0$ & $2$ \\ +$0$ & $1$ & $1$ & $0$ & $0$ & $0$ & $1$ & $0$ & $1$ \\ +$1$ & $1$ & $1$ & $0$ & $29$ & $-26$ & $29$ & $0$ & $32$ \\ +$0$ & $0$ & $0$ & $1$ & $0$ & $0$ & $0$ & $1$ & $1$ \\ +$1$ & $0$ & $0$ & $1$ & $75$ & $0$ & $0$ & $53$ & $128$ \\ +$0$ & $1$ & $0$ & $1$ & $0$ & $1$ & $0$ & $1$ & $2$ \\ +$1$ & $1$ & $0$ & $1$ & $75$ & $0$ & $0$ & $53$ & $128$ \\ +$0$ & $0$ & $1$ & $1$ & $0$ & $0$ & $1$ & $0$ & $1$ \\ +$1$ & $0$ & $1$ & $1$ & $75$ & $0$ & $0$ & $53$ & $128$ \\ +$0$ & $1$ & $1$ & $1$ & $0$ & $3$ & $10$ & $3$ & $16$ \\ +$1$ & $1$ & $1$ & $1$ & $29$ & $-26$ & $29$ & $0$ & $32$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Weights and Divisors for Each Set of Available DC Predictors} +\label{tab:dc-weights} +\end{table} + +\item +Assign \bitvar{DCPRED} the value zero. +\item +If $\locvar{P}[0]$ is non-zero, assign \bitvar{DCPRED} the value + $(\bitvar{DCPRED}+\locvar{W}[0]*\bitvar{COEFFS}[\locvar{PBI}[0]][0])$. +\item +If $\locvar{P}[1]$ is non-zero, assign \bitvar{DCPRED} the value + $(\bitvar{DCPRED}+\locvar{W}[1]*\bitvar{COEFFS}[\locvar{PBI}[1]][0])$. +\item +If $\locvar{P}[2]$ is non-zero, assign \bitvar{DCPRED} the value + $(\bitvar{DCPRED}+\locvar{W}[2]*\bitvar{COEFFS}[\locvar{PBI}[2]][0])$. +\item +If $\locvar{P}[3]$ is non-zero, assign \bitvar{DCPRED} the value + $(\bitvar{DCPRED}+\locvar{W}[3]*\bitvar{COEFFS}[\locvar{PBI}[3]][0])$. +\item +Assign \bitvar{DCPRED} the value $(\bitvar{DCPRED}//\locvar{PDIV})$. +\item +If $\locvar{P}[0]$, $\locvar{P}[1]$, and $\locvar{P}[2]$ are all non-zero: +\begin{enumerate} +\item +If $|\bitvar{DCPRED}-\bitvar{COEFFS}[\locvar{PBI}[2]][0]|$ is greater than + $128$, assign \bitvar{DCPRED} the value $\bitvar{COEFFS}[\locvar{PBI}[2]][0]$. +\item +Otherwise, if $|\bitvar{DCPRED}-\bitvar{COEFFS}[\locvar{PBI}[0]][0]|$ is + greater than $128$, assign \bitvar{DCPRED} the value + $\bitvar{COEFFS}[\locvar{PBI}[0]][0]$. +\item +Otherwise, if $|\bitvar{DCPRED}-\bitvar{COEFFS}[\locvar{PBI}[1]][0]|$ is + greater than $128$, assign \bitvar{DCPRED} the value + $\bitvar{COEFFS}[\locvar{PBI}[1]][0]$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\subsection{Inverting the DC Prediction Process} +\label{sub:dc-pred-undo} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\bitvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of + coding modes for each macro block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. The DC + value of each block will be updated. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{LASTDC} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & A 3-element array containing the + most recently decoded DC value, one for inter mode and for each reference + frame. \\ +\locvar{DCPRED} & Integer & 11 & Yes & The predicted DC value for the current + block. \\ +\locvar{DC} & Integer & 17 & Yes & The actual DC value for the current + block. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\mbi} & Integer & 32 & No & The index of the macro block + containing block \locvar{\bi}. \\ +\locvar{\rfi} & Integer & 2 & No & The index of the reference frame + indicated by the coding mode for macro block \locvar{\mbi}. \\ +\locvar{\pli} & Integer & 2 & No & A color plane index. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure describes the complete process of undoing the DC prediction to + recover the original DC values. +Because it is possible to add a value as large as $580$ to the predicted DC + coefficient value at every block, which will then be used to increase the + predictor for the next block, the reconstructed DC value could overflow a + 16-bit integer. +This is handled by truncating the result to a 16-bit signed representation, + simply throwing away any higher bits in the two's complement representation of + the number. + +\begin{enumerate} +\item +For each consecutive value of \locvar{\pli} from $0$ to $2$: +\begin{enumerate} +\item +Assign $\locvar{LASTDC}[0]$ the value zero. +\item +Assign $\locvar{LASTDC}[1]$ the value zero. +\item +Assign $\locvar{LASTDC}[2]$ the value zero. +\item +For each block of color plane \locvar{\pli} in {\em raster} order, with + coded-order index \locvar{\bi}: +\begin{enumerate} +\item +If $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero: +\begin{enumerate} +\item +Compute the value \locvar{DCPRED} using the procedure outlined in + Section~\ref{sub:dc-pred}. +\item +Assign \locvar{DC} the value + $(\bitvar{COEFFS}[\locvar{\bi}][0]+\locvar{DCPRED})$. +\item +Truncate \locvar{DC} to a 16-bit representation by dropping any higher-order + bits. +\item +Assign $\bitvar{COEFFS}[\locvar{\bi}][0]$ the value \locvar{DC}. +\item +Assign \locvar{\mbi} the index of the macro block containing block + \locvar{\bi}. +\item +Assign \locvar{\rfi} the value of the Reference Frame Index column of + Table~\ref{tab:cm-refs} corresponding to $\bitvar{MBMODES}[\locvar{\mbi}]$. +\item +Assign $\locvar{LASTDC}[\rfi]$ the value $\locvar{DC}$. +\end{enumerate} +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\section{Reconstruction} + +At this stage, the complete contents of the data packet have been decoded. +All that remains is to reconstruct the contents of the new frame. +This is applied on a block by block basis, and as each block is independent, + the order they are processed in does not matter. + +\subsection{Predictors} +\label{sec:predictors} + +For each block, a predictor is formed based on its coding mode and motion + vector. +There are three basic types of predictors: the intra predictor, the whole-pixel + predictor, and the half-pixel predictor. +The former is used for all blocks coded in INTRA mode, while all other blocks + use one of the latter two. +The whole-pixel predictor is used if the fractional part of both motion vector + components is zero, otherwise the half-pixel predictor is used. + +\subsubsection{The Intra Predictor} +\label{sub:predintra} + +\paragraph{Input parameters:} None. + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{PRED} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & An $8\times 8$ array of predictor + values to use for INTRA coded blocks. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\idx{bx}} & Integer & 3 & No & The horizontal pixel index in the + block. \\ +\locvar{\idx{by}} & Integer & 3 & No & The vertical pixel index in the + block. \\ +\bottomrule\end{tabularx} +\medskip + +The intra predictor is nothing more than the constant value $128$. +This is applied for the sole purpose of centering the range of possible DC + values for INTRA blocks around zero. + +\begin{enumerate} +\item +For each value of \locvar{\idx{by}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +For each value of \locvar{\idx{bx}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +Assign $\bitvar{PRED}[\locvar{\idx{by}}][\locvar{\idx{bx}}]$ the value $128$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\subsubsection{The Whole-Pixel Predictor} +\label{sub:predfullpel} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RPW} & Integer & 20 & No & The width of the current plane of the + reference frame in pixels. \\ +\bitvar{RPH} & Integer & 20 & No & The height of the current plane of the + reference frame in pixels. \\ +\bitvar{REFP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of the current plane of the reference frame. \\ +\bitvar{BX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the current block. \\ +\bitvar{BY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the current block. \\ +\bitvar{MVX} & Integer & 5 & No & The horizontal component of the block + motion vector. +This is always a whole-pixel value. \\ +\bitvar{MVY} & Integer & 5 & No & The vertical component of the block + motion vector. +This is always a whole-pixel value. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{PRED} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & An $8\times 8$ array of predictor + values to use for INTER coded blocks. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\idx{bx}} & Integer & 3 & Yes & The horizontal pixel index in the + block. \\ +\locvar{\idx{by}} & Integer & 3 & Yes & The vertical pixel index in the + block. \\ +\locvar{\idx{rx}} & Integer & 20 & No & The horizontal pixel index in the + reference frame. \\ +\locvar{\idx{ry}} & Integer & 20 & No & The vertical pixel index in the + reference frame. \\ +\bottomrule\end{tabularx} +\medskip + +The whole pixel predictor simply copies verbatim the contents of the reference + frame pointed to by the block's motion vector. +If the vector points outside the reference frame, then the closest value on the + edge of the reference frame is used instead. +In practice, this is usually implemented by expanding the size of the reference + frame by $8$ or $16$ pixels on each side---depending on whether or not the + corresponding axis is subsampled in the current plane---and copying the border + pixels into this region. + +\begin{enumerate} +\item +For each value of \locvar{\idx{by}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +Assign \locvar{\idx{ry}} the value + $(\bitvar{BY}+\bitvar{MVY}+\locvar{\idx{by}})$. +\item +If \locvar{\idx{ry}} is greater than $(\bitvar{RPH}-1)$, assign + \locvar{\idx{ry}} the value $(\bitvar{RPH}-1)$. +\item +If \locvar{\idx{ry}} is less than zero, assign \locvar{\idx{ry}} the value + zero. +\item +For each value of \locvar{\idx{bx}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +Assign \locvar{\idx{rx}} the value + $(\bitvar{BX}+\bitvar{MVX}+\locvar{\idx{bx}})$. +\item +If \locvar{\idx{rx}} is greater than $(\bitvar{RPW}-1)$, assign + \locvar{\idx{rx}} the value $(\bitvar{RPW}-1)$. +\item +If \locvar{\idx{rx}} is less than zero, assign \locvar{\idx{rx}} the value + zero. +\item +Assign $\bitvar{PRED}[\locvar{\idx{by}}][\locvar{\idx{bx}}]$ the value + $\bitvar{REFP}[\locvar{\idx{ry}}][\locvar{\idx{rx}}]$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\subsubsection{The Half-Pixel Predictor} +\label{sub:predhalfpel} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RPW} & Integer & 20 & No & The width of the current plane of the + reference frame in pixels. \\ +\bitvar{RPH} & Integer & 20 & No & The height of the current plane of the + reference frame in pixels. \\ +\bitvar{REFP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of the current plane of the reference frame. \\ +\bitvar{BX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the current block. \\ +\bitvar{BY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the current block. \\ +\bitvar{MVX} & Integer & 5 & No & The horizontal component of the first + whole-pixel motion vector. \\ +\bitvar{MVY} & Integer & 5 & No & The vertical component of the first + whole-pixel motion vector. \\ +\bitvar{MVX2} & Integer & 5 & No & The horizontal component of the second + whole-pixel motion vector. \\ +\bitvar{MVY2} & Integer & 5 & No & The vertical component of the second + whole-pixel motion vector. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{PRED} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & An $8\times 8$ array of predictor + values to use for INTER coded blocks. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\idx{bx}} & Integer & 3 & Yes & The horizontal pixel index in the + block. \\ +\locvar{\idx{by}} & Integer & 3 & Yes & The vertical pixel index in the + block. \\ +\locvar{\idx{rx1}} & Integer & 20 & No & The first horizontal pixel index in + the reference frame. \\ +\locvar{\idx{ry1}} & Integer & 20 & No & The first vertical pixel index in the + reference frame. \\ +\locvar{\idx{rx2}} & Integer & 20 & No & The second horizontal pixel index in + the reference frame. \\ +\locvar{\idx{ry2}} & Integer & 20 & No & The second vertical pixel index in + the reference frame. \\ +\bottomrule\end{tabularx} +\medskip + +If one or both of the components of the block motion vector is not a + whole-pixel value, then the half-pixel predictor is used. +The half-pixel predictor converts the fractional motion vector into two + whole-pixel motion vectors. +The first is formed by truncating the values of each component towards zero, + and the second is formed by truncating them away from zero. +The contributions from the reference frame at the locations pointed to by each + vector are averaged, truncating towards negative infinity. + +Only two samples from the reference frame contribute to each predictor value, + even if both components of the motion vector have non-zero fractional + components. +Motion vector components with quarter-pixel accuracy in the chroma planes are + treated exactly the same as those with half-pixel accuracy. +Any non-zero fractional part gets rounded one way in the first vector, and the + other way in the second. + +\begin{enumerate} +\item +For each value of \locvar{\idx{by}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +Assign \locvar{\idx{ry1}} the value + $(\bitvar{BY}+\bitvar{MVY1}+\locvar{\idx{by}})$. +\item +If \locvar{\idx{ry1}} is greater than $(\bitvar{RPH}-1)$, assign + \locvar{\idx{ry1}} the value $(\bitvar{RPH}-1)$. +\item +If \locvar{\idx{ry1}} is less than zero, assign \locvar{\idx{ry1}} the value + zero. +\item +Assign \locvar{\idx{ry2}} the value + $(\bitvar{BY}+\bitvar{MVY2}+\locvar{\idx{by}})$. +\item +If \locvar{\idx{ry2}} is greater than $(\bitvar{RPH}-1)$, assign + \locvar{\idx{ry2}} the value $(\bitvar{RPH}-1)$. +\item +If \locvar{\idx{ry2}} is less than zero, assign \locvar{\idx{ry2}} the value + zero. +\item +For each value of \locvar{\idx{bx}} from $0$ to $7$, inclusive: +\begin{enumerate} +\item +Assign \locvar{\idx{rx1}} the value + $(\bitvar{BX}+\bitvar{MVX1}+\locvar{\idx{bx}})$. +\item +If \locvar{\idx{rx1}} is greater than $(\bitvar{RPW}-1)$, assign + \locvar{\idx{rx1}} the value $(\bitvar{RPW}-1)$. +\item +If \locvar{\idx{rx1}} is less than zero, assign \locvar{\idx{rx1}} the value + zero. +\item +Assign \locvar{\idx{rx2}} the value + $(\bitvar{BX}+\bitvar{MVX2}+\locvar{\idx{bx}})$. +\item +If \locvar{\idx{rx2}} is greater than $(\bitvar{RPW}-1)$, assign + \locvar{\idx{rx2}} the value $(\bitvar{RPW}-1)$. +\item +If \locvar{\idx{rx2}} is less than zero, assign \locvar{\idx{rx2}} the value + zero. +\item +Assign $\bitvar{PRED}[\locvar{\idx{by}}][\locvar{\idx{bx}}]$ the value +\begin{equation*} + (\bitvar{REFP}[\locvar{\idx{ry1}}][\locvar{\idx{rx1}}]+ + \bitvar{REFP}[\locvar{\idx{ry2}}][\locvar{\idx{rx2}}])>>1. +\end{equation*} +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\subsection{Dequantization} +\label{sub:dequant} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values for + the DC coefficient for each \qi\ value. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values are used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values are used. \\ +\bitvar{\qti} & Integer & 1 & No & A quantization type index. +See Table~\ref{tab:quant-types}.\\ +\bitvar{\pli} & Integer & 2 & No & A color plane index. +See Table~\ref{tab:color-planes}.\\ +\bitvar{\idx{qi0}} & Integer & 6 & No & The quantization index of the DC + coefficient. \\ +\bitvar{\qi} & Integer & 6 & No & The quantization index of the AC + coefficients. \\ +\bitvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{DQC} & \multicolumn{1}{p{40pt}}{Integer Array} & + 14 & Yes & A $64$-element array of dequantized + DCT coefficients in natural order (cf. Section~\ref{sec:dct-coeffs}). \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{QMAT} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of quantization + values for each DCT coefficient in natural order. \\ +\locvar{\ci} & Integer & 6 & No & The DCT coefficient index in natural + order. \\ +\locvar{\zzi} & Integer & 6 & No & The DCT coefficient index in zig-zag + order. \\ +\locvar{C} & Integer & 29 & Yes & A single dequantized coefficient. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure takes the quantized DCT coefficient values in zig-zag order for + a single block---after DC prediction has been undone---and returns the + dequantized values in natural order. +If large coefficient values are decoded for coarsely quantized coefficients, + the resulting dequantized value can be significantly larger than 16 bits. +Such a coefficient is truncated to a signed 16-bit representation by discarding + the higher-order bits of its twos-complement representation. + +Although this procedure recomputes the quantization matrices from the + parameters in the setup header for each block, there are at most six different + ones used for each color plane. +An efficient implementation could compute them once in advance. + +\begin{enumerate} +\item +Using \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{BMS}, \bitvar{NQRS}, + \bitvar{QRSIZES}, \bitvar{QRBMIS}, \bitvar{\qti}, \bitvar{\pli}, and + \bitvar{\idx{qi0}}, use the procedure given in Section~\ref{sub:quant-mat} to + compute the DC quantization matrix \locvar{QMAT}. +\item +Assign \locvar{C} the value + $\bitvar{COEFFS}[\bitvar{\bi}][0]*\locvar{QMAT}[0]$. +\item +Truncate \locvar{C} to a 16-bit representation by dropping any higher-order + bits. +\item +Assign $\bitvar{DQC}[0]$ the value \locvar{C}. +\item +Using \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{BMS}, \bitvar{NQRS}, + \bitvar{QRSIZES}, \bitvar{QRBMIS}, \bitvar{\qti}, \bitvar{\pli}, and + \bitvar{\qi}, use the procedure given in Section~\ref{sub:quant-mat} to + compute the AC quantization matrix \locvar{QMAT}. +\item +For each value of \locvar{\ci} from 1 to 63, inclusive: +\begin{enumerate} +\item +Assign \locvar{\zzi} the index in zig-zag order corresponding to \locvar{\ci}. +E.g., the value at row $(\locvar{\ci}//8)$ and column $(\locvar{\ci}\%8)$ in + Figure~\ref{tab:zig-zag} +\item +Assign \locvar{C} the value + $\bitvar{COEFFS}[\bitvar{\bi}][\locvar{\zzi}]*\locvar{QMAT}[\locvar{\ci}]$. +\item +Truncate \locvar{C} to a 16-bit representation by dropping any higher-order + bits. +\item +Assign $\bitvar{DQC}[\locvar{\ci}]$ the value \locvar{C}. +\end{enumerate} +\end{enumerate} + +\subsection{The Inverse DCT} + +The 2D inverse DCT is separated into two applications of the 1D inverse DCT. +The transform is first applied to each row, and then applied to each column of + the result. + +Each application of the 1D inverse DCT scales the values by a factor of two + relative to the orthonormal version of the transform, for a total scale factor + of four for the 2D transform. +It is assumed that a similar scale factor is applied during the forward DCT + used in the encoder, so that a division by 16 is required after the transform + has been applied in both directions. +The inclusion of this scale factor allows the integerized transform to operate + with increased precision. +All divisions throughout the transform are implemented with right shifts. +Only the final division by $16$ is rounded, with ties rounded towards positive + infinity. + +All intermediate values are truncated to a 32-bit signed representation by + discarding any higher-order bits in their two's complement representation. +The final output of each 1D transform is truncated to a 16-bit signed value in + the same manner. +In practice, if the high word of a $16\times 16$ bit multiplication can be + obtained directly, 16 bits is sufficient for every calculation except scaling + by $C4$. +Thus we truncate to 16 bits before that multiplication to allow an + implementation entirely in 16-bit registers. +Implementations using larger registers must sign-extend the 16-bit value to + maintain compatibility. + +Note that if 16-bit register are used, overflow in the additions and + subtractions should be handled using \textit{unsaturated} arithmetic. +That is, the high-order bits should be discarded and the low-order bits + retained, instead of clamping the result to the maximum or minimum value. +This allows the maximum flexibility in re-ordering these instructions without + deviating from this specification. + +The 1D transform can only overflow if input coefficients larger than $\pm 6201$ + are present. +However, the result of applying the 2D forward transform on pixel values in the + range $-255\ldots 255$ can be as large as $\pm 8157$ due to the scale factor + of four that is applied, and quantization errors could make this even larger. +Therefore, the coefficients cannot simply be clamped into a valid range before + the transform. + +\subsubsection{The 1D Inverse DCT} +\label{sub:1d-idct} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{Y} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array of DCT + coefficients. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{X} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array of output values. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{T} & \multicolumn{1}{p{40pt}}{Integer Array} & + 32 & Yes & An 8-element array containing the + current value of each signal line. \\ +\locvar{R} & Integer & 32 & Yes & A temporary value. \\ +\bottomrule\end{tabularx} +\medskip + +A compliant decoder MUST use the exact implementation of the inverse DCT + defined in this specification. +Some operations may be re-ordered, but the result must be precisely equivalent. +This is a design decision that limits some avenues of decoder optimization, but + prevents any drift in the prediction loop. +The full inverse DCT described in this section is only used when there is at + least one non-zero AC coefficient. +Otherwise, a special DC-only case is used, which is described below in + step~\ref{step:dc-only-idct} of Section~\ref{sub:recon}. +The DC-only special case is not exactly equivalent to applying the full inverse + transform, because it avoids the intermediate multiplications and truncation, + and it MUST be used in place of the full transform to ensure bit-exact decode. + +Theora uses a 16-bit integerized approximation of of the 8-point 1D inverse DCT + based on the Chen factorization \cite{CSF77}. +It requires 16 multiplications and 26 additions and subtractions. + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{idct} +\end{center} +\caption{Signal Flow Graph for the 1D Inverse DCT} +\label{fig:idct} +\end{figure} + +A signal flow graph of the transformation is presented in + Figure~\ref{fig:idct}. +This graph provides a good visualization of which parts of the transform are + parallelizable. +Time increases from left to right. + +Each signal line is involved in an operation where the line is marked with a + dot $\cdot$ or a circled plus sign $\oplus$. +The constants $\locvar{C}i$ and $\locvar{S}j$ are the 16-bit integer + approximations of $\cos(\frac{i\pi}{16})$ and $\sin(\frac{j\pi}{16})$ listed + in Table~\ref{tab:dct-consts}. +When they appear next to a signal line, the value on that line is scaled by the + given constant. +A circled minus sign $\ominus$ next to a signal line indicates that the value + on that line is negated. + +Operations on a single signal path through the graph cannot be reordered, but + operations on different paths may be, or may be executed in parallel. +Different graphs may be obtainable using the associative, commutative, and + distributive properties of unsaturated arithmetic. +The column of numbers on the left represents an initial permutation of the + input DCT coefficients. +The column on the right represents the unpermuted output. +One can be obtained by bit-reversing the 3-bit binary representation of the + other. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{llr}\toprule +$\locvar{C}i$ & $\locvar{S}j$ & Value \\\midrule +$\locvar{C1}$ & $\locvar{S7}$ & $64277$ \\ +$\locvar{C2}$ & $\locvar{S6}$ & $60547$ \\ +$\locvar{C3}$ & $\locvar{S5}$ & $54491$ \\ +$\locvar{C4}$ & $\locvar{S4}$ & $46341$ \\ +$\locvar{C5}$ & $\locvar{S3}$ & $36410$ \\ +$\locvar{C6}$ & $\locvar{S2}$ & $25080$ \\ +$\locvar{C7}$ & $\locvar{S1}$ & $12785$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{16-bit Approximations of Sines and Cosines} +\label{tab:dct-consts} +\end{table} + +\begin{enumerate} +\item +Assign $\locvar{T}[0]$ the value $\bitvar{Y}[0]+\bitvar{Y}[4]$. +\item +Truncate $\locvar{T}[0]$ to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\locvar{T}[0]$ the value + $\locvar{C4}*\locvar{T}[0]>>16$. +\item +Assign $\locvar{T}[1]$ the value $\bitvar{Y}[0]-\bitvar{Y}[4]$. +\item +Truncate $\locvar{T}[1]$ to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\locvar{T}[1]$ the value $\locvar{C4}*\locvar{T}[1]>>16$. +\item +Assign $\locvar{T}[2]$ the value $(\locvar{C6}*\bitvar{Y}[2]>>16)- + (\locvar{S6}*\bitvar{Y}[6]>>16)$. +\item +Assign $\locvar{T}[3]$ the value $(\locvar{S6}*\bitvar{Y}[2]>>16)+ + (\locvar{C6}*\bitvar{Y}[6]>>16)$. +\item +Assign $\locvar{T}[4]$ the value $(\locvar{C7}*\bitvar{Y}[1]>>16)- + (\locvar{S7}*\bitvar{Y}[7]>>16)$. +\item +Assign $\locvar{T}[5]$ the value $(\locvar{C3}*\bitvar{Y}[5]>>16)- + (\locvar{S3}*\bitvar{Y}[3]>>16)$. +\item +Assign $\locvar{T}[6]$ the value $(\locvar{S3}*\bitvar{Y}[5]>>16)+ + (\locvar{C3}*\bitvar{Y}[3]>>16)$. +\item +Assign $\locvar{T}[7]$ the value $(\locvar{S7}*\bitvar{Y}[1]>>16)+ + (\locvar{C7}*\bitvar{Y}[7]>>16)$. +\item +Assign \locvar{R} the value $\locvar{T}[4]+\locvar{T}[5]$. +\item +Assign $\locvar{T}[5]$ the value $\locvar{T}[4]-\locvar{T}[5]$. +\item +Truncate $\locvar{T}[5]$ to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\locvar{T}[5]$ the value $\locvar{C4}*\locvar{T}[5]>>16$. +\item +Assign $\locvar{T}[4]$ the value $\locvar{R}$. +\item +Assign \locvar{R} the value $\locvar{T}[7]+\locvar{T}[6]$. +\item +Assign $\locvar{T}[6]$ the value $\locvar{T}[7]-\locvar{T}[6]$. +\item +Truncate $\locvar{T}[6]$ to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\locvar{T}[6]$ the value $\locvar{C4}*\locvar{T}[6]>>16$. +\item +Assign $\locvar{T}[7]$ the value $\locvar{R}$. +\item +Assign \locvar{R} the value $\locvar{T}[0]+\locvar{T}[3]$. +\item +Assign $\locvar{T}[3]$ the value $\locvar{T}[0]-\locvar{T}[3]$. +\item +Assign $\locvar{T}[0]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[1]+\locvar{T}[2]$ +\item +Assign $\locvar{T}[2]$ the value $\locvar{T}[1]-\locvar{T}[2]$ +\item +Assign $\locvar{T}[1]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[6]+\locvar{T}[5]$. +\item +Assign $\locvar{T}[5]$ the value $\locvar{T}[6]-\locvar{T}[5]$. +\item +Assign $\locvar{T}[6]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[0]+\locvar{T}[7]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[0]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[1]+\locvar{T}[6]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[1]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[2]+\locvar{T}[5]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[2]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[3]+\locvar{T}[4]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[3]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[3]-\locvar{T}[4]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[4]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[2]-\locvar{T}[5]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[5]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[1]-\locvar{T}[6]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[6]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[0]-\locvar{T}[7]$. +\item +Truncate \locvar{R} to a 16-bit signed representation by dropping any + higher-order bits. +\item +Assign $\bitvar{X}[7]$ the value \locvar{R}. +\end{enumerate} + +\subsubsection{The 2D Inverse DCT} +\label{sub:2d-idct} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{DQC} & \multicolumn{1}{p{40pt}}{Integer Array} & + 14 & Yes & A $64$-element array of dequantized + DCT coefficients in natural order (cf. Section~\ref{sec:dct-coeffs}). \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RES} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $8\times 8$ array containing the + decoded residual for the current block. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{\ci} & Integer & 3 & No & The column index. \\ +\locvar{\ri} & Integer & 3 & No & The row index. \\ +\locvar{Y} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array of 1D iDCT input + values. \\ +\locvar{X} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array of 1D iDCT output + values. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure applies the 1D inverse DCT transform 16 times to a block of + dequantized coefficients: once for each of the 8 rows, and once for each of + the 8 columns of the result. +Note that the coordinate system used for the columns is the same right-handed + coordinate system used by the rest of Theora. +Thus, the column is indexed from bottom to top, not top to bottom. +The final values are divided by sixteen, rounding with ties rounded towards + postive infinity. + +\begin{enumerate} +\item +For each value of \locvar{\ri} from 0 to 7: +\begin{enumerate} +\item +For each value of \locvar{\ci} from 0 to 7: +\begin{enumerate} +\item +Assign $\locvar{Y}[\locvar{\ci}]$ the value + $\bitvar{DQC}[\locvar{\ri}*8+\locvar{\ci}]$. +\end{enumerate} +\item +Compute \locvar{X}, the 1D inverse DCT of \locvar{Y} using the procedure + described in Section~\ref{sub:1d-idct}. +\item +For each value of $\locvar{\ci}$ from 0 to 7: +\begin{enumerate} +\item +Assign $\bitvar{RES}[\locvar{\ri}][\locvar{\ci}]$ the value + $\locvar{X}[\locvar{\ci}]$. +\end{enumerate} +\end{enumerate} +\item +For each value of \locvar{\ci} from 0 to 7: +\begin{enumerate} +\item +For each value of \locvar{\ri} from 0 to 7: +\begin{enumerate} +\item +Assign $\locvar{Y}[\locvar{\ri}]$ the value + $\bitvar{RES}[\locvar{\ri}][\locvar{\ci}]$. +\end{enumerate} +\item +Compute \locvar{X}, the 1D inverse DCT of \locvar{Y} using the procedure + described in Section~\ref{sub:1d-idct}. +\item +For each value of \locvar{\ri} from 0 to 7: +\begin{enumerate} +\item +Assign $\bitvar{RES}[\locvar{\ri}][\locvar{\ci}]$ the value + $(\locvar{X}[\locvar{\ri}]+8)>>4$. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\subsubsection{The 1D Forward DCT (Non-Normative)} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{X} & \multicolumn{1}{p{40pt}}{Integer Array} & + 14 & Yes & An 8-element array of input values. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{Y} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array of DCT + coefficients. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{T} & \multicolumn{1}{p{40pt}}{Integer Array} & + 16 & Yes & An 8-element array containing the + current value of each signal line. \\ +\locvar{R} & Integer & 16 & Yes & A temporary value. \\ +\bottomrule\end{tabularx} +\medskip + +The forward transform used in the encoder is not mandated by this standard as + the inverse one is. +Precise equivalence in the inverse transform alone is all that is required to + guarantee that there is no mismatch in the prediction loop between encoder and + any compliant decoder implementation. +However, a forward transform is provided here as a convenience for implementing + an encoder. +This is the version of the transform used by Xiph.Org's Theora encoder, which + is the same as that used by VP3. +Like the inverse DCT, it is first applied to each row, and then applied to each + column of the result. + +\begin{figure}[htbp] +\begin{center} +\includegraphics[width=\textwidth]{fdct} +\end{center} +\caption{Signal Flow Graph for the 1D Forward DCT} +\label{fig:fdct} +\end{figure} + +The signal flow graph for the forward transform is given in + Figure~\ref{fig:fdct}. +It is largely the reverse of the flow graph given for the inverse DCT. +It is important to note that the signs on the constants in the rotations have + changed, and the \locvar{C4} scale factors on one of the lower butterflies now + appear on the opposite side. +The column of numbers on the left represents the unpermuted input, and the + column on the right the permuted output DCT coefficients. + +A proper division by $2^{16}$ is done after the multiplications instead of a + shift in the forward transform. +This can be implemented quickly by adding an offset of $\hex{FFFF}$ if the + number is negative, and then shifting as before. +This slightly increases the computational complexity of the transform. +Unlike the inverse DCT, 16-bit registers and a $16\times16\rightarrow32$ bit + multiply are sufficient to avoid any overflow, so long as the input is in the + range $-6270\ldots 6270$, which is larger than required. + +\begin{enumerate} +\item +Assign $\locvar{T}[0]$ the value $\bitvar{X}[0]+\bitvar{X}[7]$. +\item +Assign $\locvar{T}[1]$ the value $\bitvar{X}[1]+\bitvar{X}[6]$. +\item +Assign $\locvar{T}[2]$ the value $\bitvar{X}[2]+\bitvar{X}[5]$. +\item +Assign $\locvar{T}[3]$ the value $\bitvar{X}[3]+\bitvar{X}[4]$. +\item +Assign $\locvar{T}[4]$ the value $\bitvar{X}[3]-\bitvar{X}[4]$. +\item +Assign $\locvar{T}[5]$ the value $\bitvar{X}[2]-\bitvar{X}[5]$. +\item +Assign $\locvar{T}[6]$ the value $\bitvar{X}[1]-\bitvar{X}[6]$. +\item +Assign $\locvar{T}[7]$ the value $\bitvar{X}[0]-\bitvar{X}[7]$. +\item +Assign \locvar{R} the value $\locvar{T}[0]+\locvar{T}[3]$. +\item +Assign $\locvar{T}[3]$ the value $\locvar{T}[0]-\locvar{T}[3]$. +\item +Assign $\locvar{T}[0]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[1]+\locvar{T}[2]$. +\item +Assign $\locvar{T}[2]$ the value $\locvar{T}[1]-\locvar{T}[2]$. +\item +Assign $\locvar{T}[1]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[6]-\locvar{T}[5]$. +\item +Assign $\locvar{T}[6]$ the value + $(\locvar{C4}*(\locvar{T}[6]+\locvar{T}[5]))//16$. +\item +Assign $\locvar{T}[5]$ the value $(\locvar{C4}*\locvar{R})//16$. +\item +Assign \locvar{R} the value $\locvar{T}[4]+\locvar{T}[5]$. +\item +Assign $\locvar{T}[5]$ the value $\locvar{T}[4]-\locvar{T}[5]$. +\item +Assign $\locvar{T}[4]$ the value \locvar{R}. +\item +Assign \locvar{R} the value $\locvar{T}[7]+\locvar{T}[6]$. +\item +Assign $\locvar{T}[6]$ the value $\locvar{T}[7]-\locvar{T}[6]$. +\item +Assign $\locvar{T}[7]$ the value \locvar{R}. +\item +Assign $\bitvar{Y}[0]$ the value + $(\locvar{C4}*(\locvar{T}[0]+\locvar{T}[1]))//16$. +\item +Assign $\bitvar{Y}[4]$ the value + $(\locvar{C4}*(\locvar{T}[0]-\locvar{T}[1]))//16$. +\item +Assign $\bitvar{Y}[2]$ the value + $((\locvar{S6}*\locvar{T}[3])//16)+ + ((\locvar{C6}*\locvar{T}[2])//16)$. +\item +Assign $\bitvar{Y}[6]$ the value + $((\locvar{C6}*\locvar{T}[3])//16)- + ((\locvar{S6}*\locvar{T}[2])//16)$. +\item +Assign $\bitvar{Y}[1]$ the value + $((\locvar{S7}*\locvar{T}[7])//16)+ + ((\locvar{C7}*\locvar{T}[4])//16)$. +\item +Assign $\bitvar{Y}[5]$ the value + $((\locvar{S3}*\locvar{T}[6])//16)+ + ((\locvar{C3}*\locvar{T}[5])//16)$. +\item +Assign $\bitvar{Y}[3]$ the value + $((\locvar{C3}*\locvar{T}[6])//16)- + ((\locvar{S3}*\locvar{T}[5])//16)$. +\item +Assign $\bitvar{Y}[7]$ the value + $((\locvar{C7}*\locvar{T}[7])//16)- + ((\locvar{S7}*\locvar{T}[4])//16)$. +\end{enumerate} + +\subsection{The Complete Reconstruction Algorithm} +\label{sub:recon} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values + for AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values + for the DC coefficient for each \qi\ value. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values are used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values are used. \\ +\bitvar{RPYW} & Integer & 20 & No & The width of the $Y'$ plane of the + reference frames in pixels. \\ +\bitvar{RPYH} & Integer & 20 & No & The height of the $Y'$ plane of the + reference frames in pixels. \\ +\bitvar{RPCW} & Integer & 20 & No & The width of the $C_b$ and $C_r$ + planes of the reference frames in pixels. \\ +\bitvar{RPCH} & Integer & 20 & No & The height of the $C_b$ and $C_r$ + planes of the reference frames in pixels. \\ +\bitvar{GOLDREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the golden reference + frame. \\ +\bitvar{PREVREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the previous reference + frame. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of + flags indicating which blocks are coded. \\ +\bitvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of + coding modes for each macro block. \\ +\bitvar{MVECTS} & \multicolumn{1}{p{50pt}}{Array of 2D Integer Vectors} & + 6 & Yes & An \bitvar{NBS}-element array of + motion vectors for each block. \\ +\bitvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\bitvar{NCOEFFS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + coefficient count for each block. \\ +\bitvar{QIS} & \multicolumn{1}{p{40pt}}{Integer array} & + 6 & No & An \bitvar{NQIS}-element array of + \qi\ values. \\ +\bitvar{QIIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 2 & No & An \bitvar{NBS}-element array of + \locvar{\qii} values for each block. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the reconstructed frame. \\ +\bitvar{RECCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the reconstructed frame. \\ +\bitvar{RECCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the reconstructed frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{RPW} & Integer & 20 & No & The width of the current plane of the + current reference frame in pixels. \\ +\locvar{RPH} & Integer & 20 & No & The height of the current plane of + the current reference frame in pixels. \\ +\locvar{REFP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of the current plane of the current reference + frame. \\ +\locvar{BX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the current block. \\ +\locvar{BY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the current block. \\ +\locvar{MVX} & Integer & 5 & No & The horizontal component of the first + whole-pixel motion vector. \\ +\locvar{MVY} & Integer & 5 & No & The vertical component of the first + whole-pixel motion vector. \\ +\locvar{MVX2} & Integer & 5 & No & The horizontal component of the second + whole-pixel motion vector. \\ +\locvar{MVY2} & Integer & 5 & No & The vertical component of the second + whole-pixel motion vector. \\ +\locvar{PRED} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & An $8\times 8$ array of predictor + values to use for the current block. \\ +\locvar{RES} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $8\times 8$ array containing the + decoded residual for the current block. \\ +\locvar{QMAT} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of quantization + values for each DCT coefficient in natural order. \\ +\locvar{DC} & Integer & 29 & Yes & The dequantized DC coefficient of a + block. \\ +\locvar{P} & Integer & 17 & Yes & A reconstructed pixel value. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\mbi} & Integer & 32 & No & The index of the macro block + containing block \locvar{\bi}. \\ +\locvar{\pli} & Integer & 2 & No & The color plane index of the current + block. \\ +\locvar{\rfi} & Integer & 2 & No & The index of the reference frame + indicated by the coding mode for macro block \locvar{\mbi}. \\ +\locvar{\idx{bx}} & Integer & 3 & No & The horizontal pixel index in the + block. \\ +\locvar{\idx{by}} & Integer & 3 & No & The vertical pixel index in the + block. \\ +\locvar{\qti} & Integer & 1 & No & A quantization type index. +See Table~\ref{tab:quant-types}.\\ +\locvar{\idx{qi0}} & Integer & 6 & No & The quantization index of the DC + coefficient. \\ +\locvar{\qi} & Integer & 6 & No & The quantization index of the AC + coefficients. \\ +\bottomrule\end{tabularx} +\medskip + +This section takes the decoded packet data and uses the previously defined + procedures to reconstruct each block of the current frame. +For coded blocks, a predictor is formed using the coding mode and, if + applicable, the motion vector, and then the residual is computed from the + quantized DCT coefficients. +For uncoded blocks, the contents of the co-located block are copied from the + previous frame and the residual is cleared to zero. +Then the predictor and residual are added, and the result clamped to the range + $0\ldots 255$ and stored in the current frame. + +In the special case that a block contains only a DC coefficient, the + dequantization and inverse DCT transform is skipped. +Instead the constant pixel value for the entire block is computed in one step. +Note that the truncation of intermediate operations is omitted and the final + rounding is slightly different in this case. +The check for whether or not the block contains only a DC coefficient is based + on the coefficient count returned from the token decode procedure of + Section~\ref{sec:dct-decode}, and not by checking to see if the remaining + coefficient values are zero. +Also note that even when the coefficient count indicates the block contains + zero coefficients, the DC coefficient is still processed, as undoing DC + prediction might have made it non-zero. + +After this procedure, the frame is completely reconstructed, but before it can + be used as a reference frame, a loop filter must be run over it to help reduce + blocking artifacts. +This is detailed in Section~\ref{sec:loopfilter}. + +\begin{enumerate} +\item +Assign \locvar{\idx{qi0}} the value $\bitvar{QIS}[0]$. +\item +For each value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$: +\begin{enumerate} +\item +Assign \locvar{\pli} the index of the color plane block \locvar{\bi} belongs + to. +\item +Assign \locvar{BX} the horizontal pixel index of the lower-left corner of block + \locvar{\bi}. +\item +Assign \locvar{BY} the vertical pixel index of the lower-left corner of block + \locvar{\bi}. +\item +If $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero: +\begin{enumerate} +\item +Assign \locvar{\mbi} the index of the macro block containing block + \locvar{\bi}. +\item +If $\bitvar{MBMODES}[\locvar{\mbi}]$ is 1 (INTRA), assign \locvar{\qti} the + value $0$. +\item +Otherwise, assign \locvar{\qti} the value $1$. +\item +Assign \locvar{\rfi} the value of the Reference Frame Index column of + Table~\ref{tab:cm-refs} corresponding to $\bitvar{MBMODES}[\locvar{\mbi}]$. +\item +If \locvar{\rfi} is zero, compute \locvar{PRED} using the procedure given in + Section~\ref{sub:predintra}. +\item +Otherwise: +\begin{enumerate} +\item +Assign \locvar{REFP}, \locvar{RPW}, and \locvar{RPH} the values given in + Table~\ref{tab:refp} corresponding to current value of \locvar{\rfi} and + \locvar{\pli}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{cclll}\toprule +\locvar{\rfi} & \locvar{\pli} & +\locvar{REFP} & \locvar{RPW} & \locvar{RPH} \\\midrule +$1$ & $0$ & \bitvar{PREVREFY} & \bitvar{RPYW} & \bitvar{RPYH} \\ +$1$ & $1$ & \bitvar{PREVREFCB} & \bitvar{RPCW} & \bitvar{RPCH} \\ +$1$ & $2$ & \bitvar{PREVREFCR} & \bitvar{RPCW} & \bitvar{RPCH} \\ +$2$ & $0$ & \bitvar{GOLDREFY} & \bitvar{RPYW} & \bitvar{RPYH} \\ +$2$ & $1$ & \bitvar{GOLDREFCB} & \bitvar{RPCW} & \bitvar{RPCH} \\ +$2$ & $2$ & \bitvar{GOLDREFCR} & \bitvar{RPCW} & \bitvar{RPCH} \\ +\bottomrule\end{tabular} +\end{center} +\caption{Reference Planes and Sizes for Each \locvar{\rfi} and \locvar{\pli}} +\label{tab:refp} +\end{table} + +\item +Assign \locvar{MVX} the value +\begin{equation*} + \left\lfloor\lvert\bitvar{MVECTS}[\locvar{\bi}]_x\rvert\right\rfloor* + \sign(\bitvar{MVECTS}[\locvar{\bi}]_x). +\end{equation*} +\item +Assign \locvar{MVY} the value +\begin{equation*} + \left\lfloor\lvert\bitvar{MVECTS}[\locvar{\bi}]_y\rvert\right\rfloor* + \sign(\bitvar{MVECTS}[\locvar{\bi}]_y). +\end{equation*} +\item +Assign \locvar{MVX2} the value +\begin{equation*} + \left\lceil\lvert\bitvar{MVECTS}[\locvar{\bi}]_x\rvert\right\rceil* + \sign(\bitvar{MVECTS}[\locvar{\bi}]_x). +\end{equation*} +\item +Assign \locvar{MVY2} the value +\begin{equation*} + \left\lceil\lvert\bitvar{MVECTS}[\locvar{\bi}]_y\rvert\right\rceil* + \sign(\bitvar{MVECTS}[\locvar{\bi}]_y). +\end{equation*} +\item +If \locvar{MVX} equals \locvar{MVX2} and \locvar{MVY} equals \locvar{MVY2}, + use the values \locvar{REFP}, \locvar{RPW}, \locvar{RPH}, \locvar{BX}, + \locvar{BY}, \locvar{MVX}, and \locvar{MVY}, compute \locvar{PRED} using the + procedure given in Section~\ref{sub:predfullpel}. +\item +Otherwise, use the values \locvar{REFP}, \locvar{RPW}, \locvar{RPH}, + \locvar{BX}, \locvar{BY}, \locvar{MVX}, \locvar{MVY}, \locvar{MVX2}, and + \locvar{MVY2} to compute \locvar{PRED} using the procedure given in + Section~\ref{sub:predhalfpel}. +\end{enumerate} +\item +\label{step:dc-only-idct} +If $\bitvar{NCOEFFS}[\locvar{\bi}]$ is less than 2: +\begin{enumerate} +\item +Using \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{BMS}, \bitvar{NQRS}, \\ + \bitvar{QRSIZES}, \bitvar{QRBMIS}, \locvar{\qti}, \locvar{\pli}, and + \locvar{\idx{qi0}}, use the procedure given in Section~\ref{sub:quant-mat} to + compute the DC quantization matrix \locvar{QMAT}. +\item +Assign \locvar{DC} the value +\begin{equation*} + (\bitvar{COEFFS}[\bitvar{\bi}][0]*\locvar{QMAT}[0]+15)>>5. +\end{equation*} +\item +Truncate \locvar{DC} to a 16-bit signed representation by dropping any + higher-order bits. +\item +For each value of \locvar{\idx{by}} from 0 to 7, and each value of + \locvar{\idx{bx}} from 0 to 7, assign + $\locvar{RES}[\locvar{\idx{by}}][\locvar{\idx{bx}}]$ the value \locvar{DC}. +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Assign \locvar{\qi} the value $\bitvar{QIS}[\bitvar{QIIS}[\locvar{\bi}]]$. +\item +Using \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{BMS}, \bitvar{NQRS}, \\ + \bitvar{QRSIZES}, \bitvar{QRBMIS}, \locvar{\qti}, \locvar{\pli}, + \locvar{\idx{qi0}}, and \locvar{\qi}, compute \locvar{DQC} using the procedure + given in Section~\ref{sub:dequant}. +\item +Using \locvar{DQC}, compute \locvar{RES} using the procedure given in + Section~\ref{sub:2d-idct}. +\end{enumerate} +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Assign \locvar{\rfi} the value 1. +\item +Assign \locvar{REFP}, \locvar{RPW}, and \locvar{RPH} the values given in + Table~\ref{tab:refp} corresponding to current value of \locvar{\rfi} and + \locvar{\pli}. +\item +Assign \locvar{MVX} the value 0. +\item +Assign \locvar{MVY} the value 0. +\item +Using the values \locvar{REFP}, \locvar{RPW}, \locvar{RPH}, \locvar{BX}, + \locvar{BY}, \locvar{MVX}, and \locvar{MVY}, compute \locvar{PRED} using the + procedure given in Section~\ref{sub:predfullpel}. +This is simply a copy of the co-located block in the previous reference frame. +\item +For each value of \locvar{\idx{by}} from 0 to 7, and each value of + \locvar{\idx{bx}} from 0 to 7, assign + $\locvar{RES}[\locvar{\idx{by}}][\locvar{\idx{bx}}]$ the value 0. +\end{enumerate} +\item +For each value of \locvar{\idx{by}} from 0 to 7, and each value of + \locvar{\idx{bx}} from 0 to 7: +\begin{enumerate} +\item +Assign \locvar{P} the value + $(\locvar{PRED}[\locvar{\idx{by}}][\locvar{\idx{bx}}]+ + \locvar{RES}[\locvar{\idx{by}}][\locvar{\idx{bx}}])$. +\item +If \locvar{P} is greater than $255$, assign \locvar{P} the value $255$. +\item +If \locvar{P} is less than $0$, assign \locvar{P} the value $0$. +\item +If \locvar{\pli} equals 0, assign + $\bitvar{RECY}[\locvar{BY}+\locvar{\idx{by}}][\locvar{BX}+\locvar{\idx{bx}}]$ + the value \locvar{P}. +\item +Otherwise, if \locvar{\pli} equals 1, assign + $\bitvar{RECB}[\locvar{BY}+\locvar{\idx{by}}][\locvar{BX}+\locvar{\idx{bx}}]$ + the value \locvar{P}. +\item +Otherwise, \locvar{\pli} equals 2, so assign + $\bitvar{RECR}[\locvar{BY}+\locvar{\idx{by}}][\locvar{BX}+\locvar{\idx{bx}}]$ + the value \locvar{P}. +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\section{Loop Filtering} +\label{sec:loopfilter} + +\begin{figure}[htbp] +\begin{center} +\includegraphics{lflim} +\end{center} +\caption{The loop filter response function.} +\label{fig:lflim} +\end{figure} + +The loop filter is a simple deblocking filter that is based on running a small + edge detecting filter over the coded block edges and adjusting the pixel + values by a tapered response. +The filter response is modulated by the following non-linear function: +\begin{align*} +\lflim(\locvar{R},\bitvar{L})&=\left\{\begin{array}{ll} +0, & \locvar{R}\le-2*\bitvar{L} \\ +-\locvar{R}-2*\bitvar{L}, & -2*\bitvar{L}<\locvar{R}\le-\bitvar{L} \\ +\locvar{R}, & -\bitvar{L}<\locvar{R}<\bitvar{L} \\ +-\locvar{R}+2*\bitvar{L}, & \bitvar{L}\le\locvar{R}<2*\bitvar{L} \\ +0, & 2*\bitvar{L}\le\locvar{R} +\end{array}\right. +\end{align*} +Here \bitvar{L} is a limiting value equal to $\bitvar{LFLIMS}[\idx{qi0}]$. +It defines the peaks of the function, illustrated in Figure~\ref{fig:lflim}. +\bitvar{LFLIMS} is an array of values specified in the setup header and is + indexed by \idx{qi0}, the first quantization index for the frame, the one used + for all the DC coefficients. +Larger values of \bitvar{L} indicate a stronger filter. + +\subsection{Horizontal Filter} +\label{sub:filth} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of a plane of the reconstructed frame. \\ +\bitvar{FX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the area to be filtered. \\ +\bitvar{FY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the area to be filtered. \\ +\bitvar{L} & Integer & 7 & No & The loop filter limit value. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of a plane of the reconstructed frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{R} & Integer & 9 & Yes & The edge detector response. \\ +\locvar{P} & Integer & 9 & Yes & A filtered pixel value. \\ +\locvar{\idx{by}} & Integer & 20 & No & The vertical pixel index in the + block. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure applies a $4$-tap horizontal filter to each row of a vertical + block edge. + +\begin{enumerate} +\item +For each value of \locvar{\idx{by}} from $0$ to $7$: +\begin{enumerate} +\item +Assign \locvar{R} the value +\begin{multline*} +(\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}]- + 3*\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+1]+\\ + 3*\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+2]- + \bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+3]+4)>>3 +\end{multline*} +\item +Assign \locvar{P} the value + $(\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+1]+ + \lflim(\locvar{R},\bitvar{L}))$. +\item +If \locvar{P} is less than zero, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+1]$ the value zero. +\item +Otherwise, if \locvar{P} is greater than $255$, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+1]$ the value $255$. +\item +Otherwise, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+1]$ the value + \locvar{P}. +\item +Assign \locvar{P} the value + $(\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+2]- + \lflim(\locvar{R},\bitvar{L}))$. +\item +If \locvar{P} is less than zero, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+2]$ the value zero. +\item +Otherwise, if \locvar{P} is greater than $255$, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+2]$ the value $255$. +\item +Otherwise, assign + $\bitvar{RECP}[\bitvar{FY}+\locvar{\idx{by}}][\bitvar{FX}+2]$ the value + \locvar{P}. +\end{enumerate} +\end{enumerate} + +\subsection{Vertical Filter} +\label{sub:filtv} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of a plane of the reconstructed frame. \\ +\bitvar{FX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the area to be filtered. \\ +\bitvar{FY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the area to be filtered. \\ +\bitvar{L} & Integer & 7 & No & The loop filter limit value. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of a plane of the reconstructed frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{R} & Integer & 9 & Yes & The edge detector response. \\ +\locvar{P} & Integer & 9 & Yes & A filtered pixel value. \\ +\locvar{\idx{bx}} & Integer & 20 & No & The horizontal pixel index in the + block. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure applies a $4$-tap vertical filter to each column of a horizontal + block edge. + +\begin{enumerate} +\item +For each value of \locvar{\idx{bx}} from $0$ to $7$: +\begin{enumerate} +\item +Assign \locvar{R} the value +\begin{multline*} +(\bitvar{RECP}[\bitvar{FY}][\bitvar{FX}+\locvar{\idx{bx}}]- + 3*\bitvar{RECP}[\bitvar{FY}+1][\bitvar{FX}+\locvar{\idx{bx}}]+\\ + 3*\bitvar{RECP}[\bitvar{FY}+2][\bitvar{FX}+\locvar{\idx{bx}}]- + \bitvar{RECP}[\bitvar{FY}+3][\bitvar{FX}+\locvar{\idx{bx}}]+4)>>3 +\end{multline*} +\item +Assign \locvar{P} the value + $(\bitvar{RECP}[\bitvar{FY}+1][\bitvar{FX}+\locvar{\idx{bx}}]+ + \lflim(\locvar{R},\bitvar{L}))$. +\item +If \locvar{P} is less than zero, assign + $\bitvar{RECP}[\bitvar{FY}+1][\bitvar{FX}+\locvar{\idx{bx}}]$ the value zero. +\item +Otherwise, if \locvar{P} is greater than $255$, assign + $\bitvar{RECP}[\bitvar{FY}+1][\bitvar{FX}+\locvar{\idx{bx}}]$ the value $255$. +\item +Otherwise, assign + $\bitvar{RECP}[\bitvar{FY}+1][\bitvar{FX}+\locvar{\idx{bx}}]$ the value + \locvar{P}. +\item +Assign \locvar{P} the value + $(\bitvar{RECP}[\bitvar{FY}+2][\bitvar{FX}+\locvar{\idx{bx}}]- + \lflim(\locvar{R},\bitvar{L}))$. +\item +If \locvar{P} is less than zero, assign + $\bitvar{RECP}[\bitvar{FY}+2][\bitvar{FX}+\locvar{\idx{bx}}]$ the value zero. +\item +Otherwise, if \locvar{P} is greater than $255$, assign + $\bitvar{RECP}[\bitvar{FY}+2][\bitvar{FX}+\locvar{\idx{bx}}]$ the value $255$. +\item +Otherwise, assign + $\bitvar{RECP}[\bitvar{FY}+2][\bitvar{FX}+\locvar{\idx{bx}}]$ the value + \locvar{P}. +\end{enumerate} +\end{enumerate} + +\subsection{Complete Loop Filter} +\label{sub:loop-filt} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{LFLIMS} & \multicolumn{1}{p{40pt}}{Integer array} & + 7 & No & A 64-element array of loop filter limit + values. \\ +\bitvar{RPYW} & Integer & 20 & No & The width of the $Y'$ plane of the + reconstruced frame in pixels. \\ +\bitvar{RPYH} & Integer & 20 & No & The height of the $Y'$ plane of the + reconstruced frame in pixels. \\ +\bitvar{RPCW} & Integer & 20 & No & The width of the $C_b$ and $C_r$ + planes of the reconstruced frame in pixels. \\ +\bitvar{RPCH} & Integer & 20 & No & The height of the $C_b$ and $C_r$ + planes of the reconstruced frame in pixels. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of + flags indicating which blocks are coded. \\ +\bitvar{QIS} & \multicolumn{1}{p{40pt}}{Integer array} & + 6 & No & An \bitvar{NQIS}-element array of + \qi\ values. \\ +\bitvar{RECY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the reconstructed frame. \\ +\bitvar{RECCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the reconstructed frame. \\ +\bitvar{RECCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the reconstructed frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the reconstructed frame. \\ +\bitvar{RECCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the reconstructed frame. \\ +\bitvar{RECCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the reconstructed frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{RPW} & Integer & 20 & No & The width of the current plane of the + reconstructed frame in pixels. \\ +\locvar{RPH} & Integer & 20 & No & The height of the current plane of + the reconstructed frame in pixels. \\ +\locvar{RECP} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPH}\times\bitvar{RPW}$ + array containing the contents of the current plane of the reconstruced + frame. \\ +\locvar{BX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the current block. \\ +\locvar{BY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the current block. \\ +\locvar{FX} & Integer & 20 & No & The horizontal pixel index of the + lower-left corner of the area to be filtered. \\ +\locvar{FY} & Integer & 20 & No & The vertical pixel index of the + lower-left corner of the area to be filtered. \\ +\locvar{L} & Integer & 7 & No & The loop filter limit value. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in + coded order. \\ +\locvar{\bj} & Integer & 36 & No & The index of a neighboring block in + coded order. \\ +\locvar{\pli} & Integer & 2 & No & The color plane index of the current + block. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure defines the order that the various block edges are filtered. +Because each application of one of the two filters above destructively modifies + the contents of the reconstructed image, the precise output obtained differs + depending on the order that horizontal and vertical filters are applied to the + edges of a single block. +The order defined here conforms to that used by VP3. + +\begin{enumerate} +\item +Assign \locvar{L} the value $\bitvar{LFLIMS}[\bitvar{QIS}[0]]$. +\item +For each block in {\em raster} order, with coded-order index \locvar{\bi}: +\begin{enumerate} +\item +If $\bitvar{BCODED}[\locvar{\bi}]$ is non-zero: +\begin{enumerate} +\item +Assign \locvar{\pli} the index of the color plane block \locvar{\bi} belongs + to. +\item +Assign \locvar{RECP}, \locvar{RPW}, and \locvar{RPH} the values given in + Table~\ref{tab:recp} corresponding to the value of \locvar{\pli}. + +\begin{table}[htbp] +\begin{center} +\begin{tabular}{clll}\toprule +\locvar{\pli} & \locvar{RECP} & \locvar{RPW} & \locvar{RPH} \\\midrule +$0$ & \bitvar{RECY} & \bitvar{RPYW} & \bitvar{RPYH} \\ +$1$ & \bitvar{RECCB} & \bitvar{RPCW} & \bitvar{RPCH} \\ +$2$ & \bitvar{RECCR} & \bitvar{RPCW} & \bitvar{RPCH} \\ +\bottomrule\end{tabular} +\end{center} +\caption{Reconstructed Planes and Sizes for Each \locvar{\pli}} +\label{tab:recp} +\end{table} + +\item +Assign \locvar{BX} the horizontal pixel index of the lower-left corner of the + block \locvar{\bi}. +\item +Assign \locvar{BY} the vertical pixel index of the lower-left corner of the + block \locvar{\bi}. +\item +If \locvar{BX} is greater than zero: +\begin{enumerate} +\item +Assign \locvar{FX} the value $(\locvar{BX}-2)$. +\item +Assign \locvar{FY} the value \locvar{BY}. +\item +Using \locvar{RECP}, \locvar{FX}, \locvar{FY}, and \locvar{L}, apply the + horizontal block filter to the left edge of block \locvar{\bi} with the + procedure described in Section~\ref{sub:filth}. +\end{enumerate} +\item +If \locvar{BY} is greater than zero: +\begin{enumerate} +\item +Assign \locvar{FX} the value \locvar{BX}. +\item +Assign \locvar{FY} the value $(\locvar{BY}-2)$ +\item +Using \locvar{RECP}, \locvar{FX}, \locvar{FY}, and \locvar{L}, apply the + vertical block filter to the bottom edge of block \locvar{\bi} with the + procedure described in Section~\ref{sub:filtv}. +\end{enumerate} +\item +If $(\locvar{BX}+8)$ is less than \locvar{RPW} and + $\bitvar{BCODED}[\locvar{\bj}]$ is zero, where \locvar{\bj} is the coded-order + index of the block adjacent to \locvar{\bi} on the right: +\begin{enumerate} +\item +Assign \locvar{FX} the value $(\locvar{BX}+6)$. +\item +Assign \locvar{FY} the value \locvar{BY}. +\item +Using \locvar{RECP}, \locvar{FX}, \locvar{FY}, and \locvar{L}, apply the + horizontal block filter to the right edge of block \locvar{\bi} with the + procedure described in Section~\ref{sub:filth}. +\end{enumerate} +\item +If $(\locvar{BY}+8)$ is less than \locvar{RPH} and + $\bitvar{BCODED}[\locvar{\bj}]$ is zero, where \locvar{\bj} is the coded-order + index of the block adjacent to \locvar{\bi} above: +\begin{enumerate} +\item +Assign \locvar{FX} the value \locvar{BX}. +\item +Assign \locvar{FY} the value $(\locvar{BY}+6)$ +\item +Using \locvar{RECP}, \locvar{FX}, \locvar{FY}, and \locvar{L}, apply the + vertical block filter to the top edge of block \locvar{\bi} with the + procedure described in Section~\ref{sub:filtv}. +\end{enumerate} +\end{enumerate} +\end{enumerate} +\end{enumerate} + +\paragraph{VP3 Compatibility} + +The original VP3 decoder implemented unrestricted motion vectors by enlarging + the reconstructed frame buffers and repeating the pixels on its edges into the + padding region. +However, for the previous reference frame this padding ocurred before the loop + filter was applied, but for the golden reference frame it occurred afterwards. + +This means that for the previous reference frame, the padding values were + required to be stored separately from the main image values. +Furthermore, even if the previous and golden reference frames were in fact the + same frame, they could have different padding values. +Finally, the encoder did not apply the loop filter at all, which resulted in + artifacts, particularly in near-static scenes, due to prediction-loop + mismatch. +This last can only be considered a bug in the VP3 encoder. + +Given all these things, Theora now uniformly applies the loop filter before + the reference frames are padded. +This means it is possible to use the same buffer for the previous and golden + reference frames when they do indeed refer to the same frame. +It also means that on architectures where memory bandwidth is limited, it is + possible to avoid storing padding values, and simply clamp the motion vectors + applied to each pixel as described in Sections~\ref{sub:predfullpel} + and~\ref{sub:predhalfpel}. +This means that the predicted pixel values along the edges of the frame might + differ slightly between VP3 and Theora, but since the VP3 encoder did not + apply the loop filter in the first place, this is not likely to impose any + serious compatibility issues. + +\section{Complete Frame Decode} + +\paragraph{Input parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{FMBW} & Integer & 16 & No & The width of the frame in macro + blocks. \\ +\bitvar{FMBH} & Integer & 16 & No & The height of the frame in macro + blocks. \\ +\bitvar{NSBS} & Integer & 32 & No & The total number of super blocks in a + frame. \\ +\bitvar{NBS} & Integer & 36 & No & The total number of blocks in a + frame. \\ +\bitvar{NMBS} & Integer & 32 & No & The total number of macro blocks in a + frame. \\ +\bitvar{FRN} & Integer & 32 & No & The frame-rate numerator. \\ +\bitvar{FRD} & Integer & 32 & No & The frame-rate denominator. \\ +\bitvar{PARN} & Integer & 24 & No & The pixel aspect-ratio numerator. \\ +\bitvar{PARD} & Integer & 24 & No & The pixel aspect-ratio + denominator. \\ +\bitvar{CS} & Integer & 8 & No & The color space. \\ +\bitvar{PF} & Integer & 2 & No & The pixel format. \\ +\bitvar{NOMBR} & Integer & 24 & No & The nominal bitrate of the stream, in + bits per second. \\ +\bitvar{QUAL} & Integer & 6 & No & The quality hint. \\ +\bitvar{KFGSHIFT} & Integer & 5 & No & The amount to shift the key frame + number by in the granule position. \\ +\bitvar{LFLIMS} & \multicolumn{1}{p{40pt}}{Integer array} & + 7 & No & A 64-element array of loop filter + limit values. \\ +\bitvar{ACSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values + for AC coefficients for each \qi\ value. \\ +\bitvar{DCSCALE} & \multicolumn{1}{p{40pt}}{Integer array} & + 16 & No & A 64-element array of scale values + for the DC coefficient for each \qi\ value. \\ +\bitvar{NBMS} & Integer & 10 & No & The number of base matrices. \\ +\bitvar{BMS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 8 & No & A $\bitvar{NBMS}\times 64$ array + containing the base matrices. \\ +\bitvar{NQRS} & \multicolumn{1}{p{50pt}}{2D Integer array} & + 6 & No & A $2\times 3$ array containing the + number of quant ranges for a given \qti\ and \pli, respectively. +This is at most $63$. \\ +\bitvar{QRSIZES} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 6 & No & A $2\times 3\times 63$ array of the + sizes of each quant range for a given \qti\ and \pli, respectively. +Only the first $\bitvar{NQRS}[\qti][\pli]$ values will be used. \\ +\bitvar{QRBMIS} & \multicolumn{1}{p{50pt}}{3D Integer array} & + 9 & No & A $2\times 3\times 64$ array of the + \bmi's used for each quant range for a given \qti\ and \pli, respectively. +Only the first $(\bitvar{NQRS}[\qti][\pli]+1)$ values will be used. \\ +\bitvar{HTS} & \multicolumn{3}{l}{Huffman table array} + & An 80-element array of Huffman tables + with up to 32 entries each. \\ +\bitvar{GOLDREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the golden reference + frame. \\ +\bitvar{PREVREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the previous reference + frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Output parameters:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\bitvar{RECY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the reconstructed frame. \\ +\bitvar{RECCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the reconstructed + frame. \\ +\bitvar{RECCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the reconstructed + frame. \\ +\bitvar{GOLDREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the golden reference + frame. \\ +\bitvar{GOLDREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the golden reference + frame. \\ +\bitvar{PREVREFY} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPYH}\times\bitvar{RPYW}$ + array containing the contents of the $Y'$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCB} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_b$ plane of the previous reference + frame. \\ +\bitvar{PREVREFCR} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 8 & No & A $\bitvar{RPCH}\times\bitvar{RPCW}$ + array containing the contents of the $C_r$ plane of the previous reference + frame. \\ +\bottomrule\end{tabularx} + +\paragraph{Variables used:}\hfill\\* +\begin{tabularx}{\textwidth}{@{}llrcX@{}}\toprule +\multicolumn{1}{c}{Name} & +\multicolumn{1}{c}{Type} & +\multicolumn{1}{p{30pt}}{\centering Size (bits)} & +\multicolumn{1}{c}{Signed?} & +\multicolumn{1}{c}{Description and restrictions} \\\midrule\endhead +\locvar{FTYPE} & Integer & 1 & No & The frame type. \\ +\locvar{NQIS} & Integer & 2 & No & The number of \qi\ values. \\ +\locvar{QIS} & \multicolumn{1}{p{40pt}}{Integer array} & + 6 & No & An \locvar{NQIS}-element array of + \qi\ values. \\ +\locvar{BCODED} & \multicolumn{1}{p{40pt}}{Integer Array} & + 1 & No & An \bitvar{NBS}-element array of flags + indicating which blocks are coded. \\ +\locvar{MBMODES} & \multicolumn{1}{p{40pt}}{Integer Array} & + 3 & No & An \bitvar{NMBS}-element array of + coding modes for each macro block. \\ +\locvar{MVECTS} & \multicolumn{1}{p{50pt}}{Array of 2D Integer Vectors} & + 6 & Yes & An \bitvar{NBS}-element array of motion + vectors for each block. \\ +\locvar{QIIS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 2 & No & An \bitvar{NBS}-element array of + \locvar{\qii} values for each block. \\ +\locvar{COEFFS} & \multicolumn{1}{p{50pt}}{2D Integer Array} & + 16 & Yes & An $\bitvar{NBS}\times 64$ array of + quantized DCT coefficient values for each block in zig-zag order. \\ +\locvar{NCOEFFS} & \multicolumn{1}{p{40pt}}{Integer Array} & + 7 & No & An \bitvar{NBS}-element array of the + coefficient count for each block. \\ +\bitvar{RPYW} & Integer & 20 & No & The width of the $Y'$ plane of the + reference frames in pixels. \\ +\bitvar{RPYH} & Integer & 20 & No & The height of the $Y'$ plane of the + reference frames in pixels. \\ +\bitvar{RPCW} & Integer & 20 & No & The width of the $C_b$ and $C_r$ + planes of the reference frames in pixels. \\ +\bitvar{RPCH} & Integer & 20 & No & The height of the $C_b$ and $C_r$ + planes of the reference frames in pixels. \\ +\locvar{\bi} & Integer & 36 & No & The index of the current block in coded + order. \\ +\bottomrule\end{tabularx} +\medskip + +This procedure uses all the procedures defined in the previous section of this + chapter to decode and reconstruct a complete frame. +It takes as input values decoded from the headers, as well as the current + reference frames. +As output, it gives the uncropped, reconstructed frame. +This should be cropped to picture region before display. +As a special case, a 0-byte packet is treated exactly like an inter frame with + no coded blocks. + +\begin{enumerate} +\item +If the size of the data packet is non-zero: +\begin{enumerate} +\item +Decode the frame header values \locvar{FTYPE}, \locvar{NQIS}, and \locvar{QIS} + using the procedure given in Section~\ref{sub:frame-header}. +\item +Using \locvar{FTYPE}, \bitvar{NSBS}, and \bitvar{NBS}, decode the list of coded + block flags into \locvar{BCODED} using the procedure given in + Section~\ref{sub:coded-blocks}. +\item +Using \locvar{FTYPE}, \bitvar{NMBS}, \bitvar{NBS}, and \bitvar{BCODED}, decode + the macro block coding modes into \locvar{MBMODES} using the procedure given + in Section~\ref{sub:mb-modes}. +\item +If \locvar{FTYPE} is non-zero (inter frame), using \bitvar{PF}, \bitvar{NMBS}, + \locvar{MBMODES}, \bitvar{NBS}, and \locvar{BCODED}, decode the motion vectors + into \locvar{MVECTS} using the procedure given in + Section~\ref{sub:mb-mv-decode}. +\item +Using \bitvar{NBS}, \locvar{BCODED}, and \locvar{NQIS}, decode the block-level + \qi\ values into \locvar{QIIS} using the procedure given in + Section~\ref{sub:block-qis}. +\item +Using \bitvar{NBS}, \bitvar{NMBS}, \locvar{BCODED}, and \bitvar{HTS}, decode + the DCT coefficients into \locvar{NCOEFFS} and \locvar{NCOEFFS} using the + procedure given in Section~\ref{sub:dct-coeffs}. +\item +Using \locvar{BCODED} and \locvar{MBMODES}, undo the DC prediction on the DC + coefficients stored in \locvar{COEFFS} using the procedure given in + Section~\ref{sub:dc-pred-undo}. +\end{enumerate} +\item +Otherwise: +\begin{enumerate} +\item +Assign \locvar{FTYPE} the value 1 (inter frame). +\item +Assign \locvar{NQIS} the value 1. +\item +Assign $\locvar{QIS}[0]$ the value 63. +\item +For each value of \locvar{\bi} from 0 to $(\bitvar{NBS}-1)$, assign + $\locvar{BCODED}[\locvar{\bi}]$ the value zero. +\end{enumerate} +\item +Assign \locvar{RPYW} and \locvar{RPYH} the values $(16*\bitvar{FMBW})$ and + $(16*\bitvar{FMBH})$, respectively. +\item +Assign \locvar{RPCW} and \locvar{RPCH} the values from the row of + Table~\ref{tab:rpcwh-for-pf} corresponding to \bitvar{PF}. + +\begin{table}[tb] +\begin{center} +\begin{tabular}{crr}\toprule +\bitvar{PF} & \multicolumn{1}{c}{\locvar{RPCW}} + & \multicolumn{1}{c}{\locvar{RPCH}} \\\midrule +$0$ & $8*\bitvar{FMBW}$ & $8*\bitvar{FMBH}$ \\ +$2$ & $8*\bitvar{FMBW}$ & $16*\bitvar{FMBH}$ \\ +$3$ & $16*\bitvar{FMBW}$ & $16*\bitvar{FMBH}$ \\ +\bottomrule\end{tabular} +\end{center} +\caption{Width and Height of Chroma Planes for each Pixel Format} +\label{tab:rpcwh-for-pf} +\end{table} + +\item +Using \bitvar{ACSCALE}, \bitvar{DCSCALE}, \bitvar{BMS}, \bitvar{NQRS}, + \bitvar{QRSIZES}, \bitvar{QRBMIS}, \bitvar{NBS}, \locvar{BCODED}, + \locvar{MBMODES}, \locvar{MVECTS}, \locvar{COEFFS}, \locvar{NCOEFFS}, + \locvar{QIS}, \locvar{QIIS}, \locvar{RPYW}, \locvar{RPYH}, \locvar{RPCW}, + \locvar{RPCH}, \bitvar{GOLDREFY}, \bitvar{GOLDREFCB}, \bitvar{GOLDREFCR}, + \bitvar{PREVREFY}, \bitvar{PREVREFCB}, and \bitvar{PREVREFCR}, reconstruct the + complete frame into \bitvar{RECY}, \bitvar{RECCB}, and \bitvar{RECCR} using + the procedure given in Section~\ref{sub:recon}. +\item +Using \bitvar{LFLIMS}, \locvar{RPYW}, \locvar{RPYH}, \locvar{RPCW}, + \locvar{RPCH}, \bitvar{NBS}, \locvar{BCODED}, and \locvar{QIS}, apply the loop + filter to the reconstructed frame in \bitvar{RECY}, \bitvar{RECCB}, and + \bitvar{RECCR} using the procedure given in Section~\ref{sub:loop-filt}. +\item +If \locvar{FTYPE} is zero (intra frame), assign \bitvar{GOLDREFY}, + \bitvar{GOLDREFCB}, and \bitvar{GOLDREFCR} the values \bitvar{RECY}, + \bitvar{RECCB}, and \bitvar{RECCR}, respectively. +\item +Assign \bitvar{PREVREFY}, \bitvar{PREVREFCB}, and \bitvar{PREVREFCR} the values + \bitvar{RECY}, \bitvar{RECCB}, and \bitvar{RECCR}, respectively. +\end{enumerate} + +%\backmatter +\appendix + +\chapter{Ogg Bitstream Encapsulation} +\label{app:oggencapsulation} + +\section{Overview} + +This document specifies the embedding or encapsulation of Theora packets + in an Ogg transport stream. + +Ogg is a stream oriented wrapper for coded, linear time-based data. +It provides syncronization, multiplexing, framing, error detection and + seeking landmarks for the decoder and complements the raw packet format + used by the Theora codec. + +This document assumes familiarity with the details of the Ogg standard. +The Xiph.Org documentation provides an overview of the Ogg transport stream + format at \url{http://www.xiph.org/ogg/doc/oggstream.html} and a detailed + description at \url{http://www.xiph.org/ogg/doc/framing.html}. +The format is also defined in RFC~3533 \cite{rfc3533}. +While Theora packets can be embedded in a wide variety of media + containers and streaming mechanisms, the Xiph.Org Foundation + recommends Ogg as the native format for Theora video in file-oriented + storage and transmission contexts. + +\subsection{MIME type} + +The generic MIME type of any Ogg file is {\tt application/ogg}. +The specific MIME type for the Ogg Theora profile documented here +is {\tt video/ogg}. This is the MIME type recommended for files +conforming to this appendix. The recommended filename extension +is {\tt .ogv}. + +Outside of an encapsulation, the mime type {\tt video/theora} may + be used to refer specifically to the Theora compressed video stream. + +\section{Embedding in a logical bitstream} + +Ogg separates the concept of a {\em logical bitstream} consisting of the + framing of a particular sequence of packets and complete within itself + from the {\em physical bitstream} which may consist either of a single + logical bitstream or a number of logical bitstreams multiplexed + together. +This section specifies the embedding of Theora packets in a logical Ogg + bitstream. +The mapping of Ogg Theora logical bitstreams into a multiplexed physical Ogg + stream is described in the next section. + +\subsection{Headers} + +The initial identification header packet appears by itself in a + single Ogg page. +This page defines the start of the logical stream and MUST have + the `beginning of stream' flag set. + +The second and third header packets (comment metadata and decoder + setup data) can together span one or more Ogg pages. +If there are additional non-normative header packets, they MUST be + included in this sequence of pages as well. +The comment header packet MUST begin the second Ogg page in the logical + bitstream, and there MUST be a page break between the last header + packet and the first frame data packet. + +These two page break requirements facilitate stream identification and + simplify header acquisition for seeking and live streaming applications. + +All header pages MUST have their granule position field set to zero. + +\subsection{Frame data} + +The first frame data packet in a logical bitstream MUST begin a new Ogg + page. +All other data packets are placed one at a time into Ogg pages + until the end of the stream. +Packets can span pages and multiple packets can be placed within any + one page. +The last page in the logical bitstream SHOULD have its + 'end of stream' flag set to indicate complete transmission + of the available video. + +Frame data pages MUST be marked with a granule position corresponding to + the end of the display interval of the last frame/packet that finishes + in that page. See the next section for details. + +\subsection{Granule position} + +Data packets are marked by a granulepos derived from the count of decodable +frames after that packet is processed. The field itself is divided into two +sections, the width of the less significant section being given by the KFGSHIFT +parameter decoded from the identification header +(Section~\ref{sec:idheader}). +The more significant portion of the field gives the count of coded +frames after the coding of the last keyframe in stream, and the less +significant portion gives the count of frames since the last keyframe. +Thus a stream would begin with a split granulepos of $1|0$ (a keyframe), +followed by $1|1$, $1|2$, $1|3$, etc. Around a keyframe in the +middle of the stream the granulepos sequence might be $1234|35$, +$1234|36$, $1234|37$, $1271|0$ (for the keyframe), $1271|1$, and so +on. In this way the granulepos field increased monotonically as required +by the Ogg format, but contains information necessary to efficiently +find the previous keyframe to continue decoding after a seek. + +Prior to bitstream version 3.2.1, data packets were marked by a +granulepos derived from the index of the frame being decoded, +rather than the count. That is they marked the beginning of the +display interval of a frame rather than the end. Such streams +have the VREV field of the identification header set to `0' +instead of `1'. They can be interpreted according to the description +above by adding 1 to the more signification field of the split +granulepos when VREV is less than 1. + +\section{Multiplexed stream mapping} + +Applications supporting Ogg Theora must support Theora bitstreams + multiplexed with compressed audio data in the Vorbis I and Speex + formats, and should support Ogg-encapsulated MNG graphics for overlays. + +Multiple audio and video bitstreams may be multiplexed together. +How playback of multiple/alternate streams is handled is up to the + application. +Some conventions based on included metadata aide interoperability + in this respect. +%TODO: describe multiple vs. alternate streams, language mapping +% and reference metadata descriptions. + +\subsection{Chained streams} + +Ogg Theora decoders and playback applications MUST support both grouped + streams (multiplexed concurrent logical streams) and chained streams + (sequential concatenation of independent physical bitstreams). + +The number and codec data types of multiplexed streams and the decoder + parameters for those stream types that re-occur can all change at a + chaining boundary. +A playback application MUST be prepared to handle such changes and + SHOULD do so smoothly with the minimum possible visible disruption. +The specification of grouped streams below applies independently to each + segment of a chained bitstream. + +\subsection{Grouped streams} + +At the beginning of a multiplexed stream, the `beginning of stream' + pages for each logical bitstream will be grouped together. +Within these, the first page to occur MUST be the Theora page. +This facilitates identification of Ogg Theora files among other + Ogg-encapsulated content. +A playback application must nevertheless handle streams where this + arrangement is not correct. +%TBT: Then what's the point of requiring it in the spec? + +If there is more than one Theora logical stream, the first page should + be from the primary stream. +That is, the best choice for the stream a generic player should begin + displaying without special user direction. +If there is more than one audio stream, or of any other stream + type, the identification page of the primary stream of that type + should be placed before the others. +%TBT: That's all pretty vague. + +After the `beginning of stream' pages, the header pages of each of + the logical streams MUST be grouped together before any data pages + occur. + +After all the header pages have been placed, + the data pages are multiplexed together. +They should be placed in the stream in increasing order by the + time equivalents of their granule position fields. +This facilitates seeking while limiting the buffering requirements of the + playback demultiplexer. +%TODO: A lot of this language is encoder-oriented. +%TODO: We define a decoder-oriented specification. +%TODO: The language should be changed to match. + +\cleardoublepage +\chapter{VP3} + +\section{VP3 Compatibility} +\label{app:vp3-compat} +This section lists all of the encoder and decoder issues that may affect VP3 + compatibly. +Each is described in more detail in the text itself. +This list is provided merely for reference. + +\begin{itemize} +\item +Bitstream headers (Section~\ref{sec:headers}). +\begin{itemize} +\item +Identification header (Section~\ref{sec:idheader}). +\begin{itemize} +\item +Non-multiple of 16 picture sizes. +\item +Standardized color spaces. +\item +Support for $4:4:4$ and $4:2:2$ pixel formats. +\end{itemize} +\item +Setup header +\begin{itemize} +\item +Loop filter limit values (Section~\ref{sub:loop-filter-limits}). +\item +Quantization parameters (Section~\ref{sub:quant-params}). +\item +Huffman tables (Section~\ref{sub:huffman-tables}). +\end{itemize} +\end{itemize} +\item +Frame header format (Section~\ref{sub:frame-header}). +\item +Extended long-run bit strings (Section~\ref{sub:long-run}). +\item +INTER\_MV\_FOUR handling of uncoded blocks (Section~\ref{sub:mb-mv-decode}). +\item +Block-level \qi\ values (Section~\ref{sub:block-qis}). +\item +Zero-length EOB runs (Section~\ref{sub:eob-token}). +\item +Unrestricted motion vector padding and the loop filter + (Section~\ref{sub:loop-filt}). +\end{itemize} + +\section{Loop Filter Limit Values} +\label{app:vp3-loop-filter-limits} + +The hard-coded loop filter limit values used in VP3 are defined as follows: +\begin{align*} +\bitvar{LFLIMS} = & \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 30, & 25, & 20, & 20, & 15, & 15, & 14, & 14, & \\ + & 13, & 13, & 12, & 12, & 11, & 11, & 10, & 10, & \\ + & 9, & 9, & 8, & 8, & 7, & 7, & 7, & 7, & \\ + & 6, & 6, & 6, & 6, & 5, & 5, & 5, & 5, & \\ + & 4, & 4, & 4, & 4, & 3, & 3, & 3, & 3, & \\ + & 2, & 2, & 2, & 2, & 2, & 2, & 2, & 2, & \\ + & 0, & 0, & 0, & 0, & 0, & 0, & 0, & 0, & \\ + & 0, & 0, & 0, & 0, & 0, & 0, & 0, & 0\;\ & \!\} \\ +\end{array} +\end{align*} + +\section{Quantization Parameters} +\label{app:vp3-quant-params} + +The hard-coded quantization parameters used by VP3 are defined as follows: + +\begin{align*} +\bitvar{ACSCALE} = & \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 500, & 450, & 400, & 370, & 340, & 310, & 285, & 265, & \\ + & 245, & 225, & 210, & 195, & 185, & 180, & 170, & 160, & \\ + & 150, & 145, & 135, & 130, & 125, & 115, & 110, & 107, & \\ + & 100, & 96, & 93, & 89, & 85, & 82, & 75, & 74, & \\ + & 70, & 68, & 64, & 60, & 57, & 56, & 52, & 50, & \\ + & 49, & 45, & 44, & 43, & 40, & 38, & 37, & 35, & \\ + & 33, & 32, & 30, & 29, & 28, & 25, & 24, & 22, & \\ + & 21, & 19, & 18, & 17, & 15, & 13, & 12, & 10\;\ & \!\} \\ +\end{array} \\ +\bitvar{DCSCALE} = & \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 220, & 200, & 190, & 180, & 170, & 170, & 160, & 160, & \\ + & 150, & 150, & 140, & 140, & 130, & 130, & 120, & 120, & \\ + & 110, & 110, & 100, & 100, & 90, & 90, & 90, & 80, & \\ + & 80, & 80, & 70, & 70, & 70, & 60, & 60, & 60, & \\ + & 60, & 50, & 50, & 50, & 50, & 40, & 40, & 40, & \\ + & 40, & 40, & 30, & 30, & 30, & 30, & 30, & 30, & \\ + & 30, & 20, & 20, & 20, & 20, & 20, & 20, & 20, & \\ + & 20, & 10, & 10, & 10, & 10, & 10, & 10, & 10\;\ & \!\} \\ +\end{array} +\end{align*} + +VP3 defines only a single quantization range for each quantization type and + color plane, and the base matrix used is constant throughout the range. +There are three base matrices defined. +The first is used for the $Y'$ channel of INTRA mode blocks, and the second for + both the $C_b$ and $C_r$ channels of INTRA mode blocks. +The last is used for INTER mode blocks of all channels. + +\begin{align*} +\bitvar{BMS} = \{ & \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 16, & 11, & 10, & 16, & 24, & 40, & 51, & 61, & \\ + & 12, & 12, & 14, & 19, & 26, & 58, & 60, & 55, & \\ + & 14, & 13, & 16, & 24, & 40, & 57, & 69, & 56, & \\ + & 14, & 17, & 22, & 29, & 51, & 87, & 80, & 62, & \\ + & 18, & 22, & 37, & 58, & 68, & 109, & 103, & 77, & \\ + & 24, & 35, & 55, & 64, & 81, & 104, & 113, & 92, & \\ + & 49, & 64, & 78, & 87, & 103, & 121, & 120, & 101, & \\ + & 72, & 92, & 95, & 98, & 112, & 100, & 103, & 99\;\ & \!\}, \\ +%\end{array} \\ +%& \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 17, & 18, & 24, & 47, & 99, & 99, & 99, & 99, & \\ + & 18, & 21, & 26, & 66, & 99, & 99, & 99, & 99, & \\ + & 24, & 26, & 56, & 99, & 99, & 99, & 99, & 99, & \\ + & 47, & 66, & 99, & 99, & 99, & 99, & 99, & 99, & \\ + & 99, & 99, & 99, & 99, & 99, & 99, & 99, & 99, & \\ + & 99, & 99, & 99, & 99, & 99, & 99, & 99, & 99, & \\ + & 99, & 99, & 99, & 99, & 99, & 99, & 99, & 99, & \\ + & 99, & 99, & 99, & 99, & 99, & 99, & 99, & 99\;\ & \!\}, \\ +%\end{array} \\ +%& \begin{array}[t]{r@{}rrrrrrrr@{}l} +\{ & 16, & 16, & 16, & 20, & 24, & 28, & 32, & 40, & \\ + & 16, & 16, & 20, & 24, & 28, & 32, & 40, & 48, & \\ + & 16, & 20, & 24, & 28, & 32, & 40, & 48, & 64, & \\ + & 20, & 24, & 28, & 32, & 40, & 48, & 64, & 64, & \\ + & 24, & 28, & 32, & 40, & 48, & 64, & 64, & 64, & \\ + & 28, & 32, & 40, & 48, & 64, & 64, & 64, & 96, & \\ + & 32, & 40, & 48, & 64, & 64, & 64, & 96, & 128, & \\ + & 40, & 48, & 64, & 64, & 64, & 96, & 128, & 128\;\ & \!\}\;\;\} \\ +\end{array} +\end{align*} + +The remaining parameters simply assign these matrices to the proper quant + ranges. + +\begin{align*} +\bitvar{NQRS} = & \{ \{1, 1, 1\}, \{1, 1, 1\} \} \\ +\bitvar{QRSIZES} = & + \{ \{ \{63\}, \{63\}, \{63\} \}, \{ \{63\}, \{63\}, \{63\} \} \} \\ +\bitvar{QRBMIS} = & + \{ \{ \{0, 0\}, \{1, 1\}, \{1, 1\} \}, \{ \{2, 2\}, \{2, 2\}, \{2, 2\} \} \} \\ +\end{align*} + +\section{Huffman Tables} +\label{app:vp3-huffman-tables} + +The following tables contain the hard-coded Huffman codes used by VP3. +There are 80 tables in all, each with a Huffman code for all 32 token values. +The tokens are sorted by the most significant bits of their Huffman code. +This is the same order in which they will be decoded from the setup header. + +\include{vp3huff} + +\cleardoublepage +\chapter{Colophon} + +Ogg is a \href{http://www.xiph.org}{Xiph.Org Foundation} effort to protect + essential tenets of Internet multimedia from corporate hostage-taking; Open + Source is the net's greatest tool to keep everyone honest. +See \href{http://www.xiph.org/about.html}{About the Xiph.Org Foundation} for + details. + +Ogg Theora is the first Ogg video codec. +Anyone may freely use and distribute the Ogg and Theora specifications, whether + in private, public, or corporate capacity. +However, the Xiph.Org Foundation and the Ogg project reserve the right to set + the Ogg Theora specification and certify specification compliance. + +Xiph.Org's Theora software codec implementation is distributed under a BSD-like + license. +This does not restrict third parties from distributing independent + implementations of Theora software under other licenses. + +\begin{wrapfigure}{l}{0pt} +\includegraphics[width=2.5cm]{xifish} +\end{wrapfigure} + +These pages are Copyright \textcopyright{} 2004-2007 Xiph.Org Foundation. +All rights reserved. +Ogg, Theora, Vorbis, Xiph.Org Foundation and their logos are trademarks + (\texttrademark) of the \href{http://www.xiph.org}{Xiph.Org Foundation}. + +This document is set in \LaTeX. + + + +\cleardoublepage +\bibliography{spec} + +\end{document} diff --git a/libs/libtheora-1.1/doc/spec/superblock.fig b/libs/libtheora-1.1/doc/spec/superblock.fig new file mode 100644 index 00000000..082c31f1 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/superblock.fig @@ -0,0 +1,72 @@ +#FIG 3.2 Produced by xfig version 3.2.5-alpha4 +Landscape +Center +Metric +A4 +100.00 +Single +-2 +1200 2 +6 270 180 5905 4860 +6 387 3531 1542 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 4687 675 4687 675 4397 387 4397 387 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 675 4687 963 4687 963 4397 675 4397 675 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 963 4687 1252 4687 1252 4397 963 4397 963 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1252 4397 1542 4397 1542 4109 1252 4109 1252 4397 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 4397 675 4397 675 4109 387 4109 387 4397 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 4109 675 4109 675 3820 387 3820 387 4109 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 963 4109 1252 4109 1252 3820 963 3820 963 4109 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1252 4109 1542 4109 1542 3820 1252 3820 1252 4109 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1252 3820 1542 3820 1542 3531 1252 3531 1252 3820 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 675 3820 963 3820 963 3531 675 3531 675 3820 +-6 +6 387 3531 1542 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1252 4687 1542 4687 1542 4397 1252 4397 1252 4687 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 963 4397 1252 4397 1252 4109 963 4109 963 4397 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 963 3820 1252 3820 1252 3531 963 3531 963 3820 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 3820 675 3820 675 3531 387 3531 387 3820 +-6 +6 357 3502 1570 4715 +6 675 3820 963 4397 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 675 4397 963 4397 963 4109 675 4109 675 4397 +2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 675 4109 963 4109 963 3820 675 3820 675 4109 +-6 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 3531 1542 3531 1542 4687 387 4687 387 3531 +-6 +2 2 1 2 0 7 50 -1 -1 6.000 0 0 -1 0 0 5 + 387 353 5876 353 5876 4687 387 4687 387 353 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1542 3531 2697 3531 2697 4687 1542 4687 1542 3531 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 2697 3531 3854 3531 3854 4687 2697 4687 2697 3531 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 2375 1542 2375 1542 3531 387 3531 387 2375 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 1542 2375 2697 2375 2697 3531 1542 3531 1542 2375 +2 2 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 5 + 387 1220 1542 1220 1542 2375 387 2375 387 1220 +4 0 0 50 -1 0 7 0.0000 4 125 270 270 4831 (0,0)\001 +4 0 0 50 -1 0 7 0.0000 4 96 367 473 297 Frame\001 +4 0 0 50 -1 0 7 0.0000 4 125 1002 501 3474 Super Block (4x4)\001 +4 0 0 50 -1 0 7 0.0000 4 96 203 415 4657 8x8\001 +4 0 0 50 -1 0 7 0.0000 4 96 318 357 4513 Block\001 +4 0 0 50 -1 0 13 0.0000 4 20 145 4085 4081 ...\001 +4 0 0 50 -1 0 13 4.7124 4 20 145 848 815 ...\001 +-6 diff --git a/libs/libtheora-1.1/doc/spec/vp3huff.c b/libs/libtheora-1.1/doc/spec/vp3huff.c new file mode 100644 index 00000000..87c93b40 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/vp3huff.c @@ -0,0 +1,918 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2007 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + function: dump the VP3.1 huffman tables in a form suitable for + inclusion in the spec. + last mod: $Id: vp3huff.c 14078 2007-10-31 21:24:44Z giles $ + + ********************************************************************/ + +#include +#include +#include + + + +typedef struct{ + unsigned long pattern; + int nbits; +}theora_huff_code; + + + +/*The default Huffman codes used for VP3.1. + These tables were generated by /experimental/derf/theora-exp/tools/huffgen.c + using the same algorithm and sampled frequency counts used by VP3.*/ +const theora_huff_code TH_VP31_HUFF_CODES[80][32]={ + { + {0x002D, 6},{0x0026, 7},{0x0166, 9},{0x004E, 8}, + {0x02CE,10},{0x059E,11},{0x027D,11},{0x0008, 5}, + {0x04F9,12},{0x000F, 4},{0x000E, 4},{0x001B, 5}, + {0x0006, 4},{0x0008, 4},{0x0005, 4},{0x001A, 5}, + {0x0015, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x0009, 4},{0x0017, 5},{0x0029, 6}, + {0x0028, 6},{0x00B2, 8},{0x04F8,12},{0x059F,11}, + {0x009E, 9},{0x013F,10},{0x0012, 6},{0x0058, 7} + }, + { + {0x0010, 5},{0x0047, 7},{0x01FF, 9},{0x008C, 8}, + {0x03FC,10},{0x046A,11},{0x0469,11},{0x0022, 6}, + {0x11A1,13},{0x000E, 4},{0x000D, 4},{0x0004, 4}, + {0x0005, 4},{0x0009, 4},{0x0006, 4},{0x001E, 5}, + {0x0016, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x000A, 4},{0x0017, 5},{0x007D, 7}, + {0x007E, 7},{0x011B, 9},{0x08D1,12},{0x03FD,10}, + {0x046B,11},{0x11A0,13},{0x007C, 7},{0x00FE, 8} + }, + { + {0x0016, 5},{0x0020, 6},{0x0086, 8},{0x0087, 8}, + {0x0367,10},{0x06CC,11},{0x06CB,11},{0x006E, 7}, + {0x366D,14},{0x000F, 4},{0x000E, 4},{0x0004, 4}, + {0x0005, 4},{0x000A, 4},{0x0006, 4},{0x001A, 5}, + {0x0011, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x0009, 4},{0x0017, 5},{0x006F, 7}, + {0x006D, 7},{0x0364,10},{0x0D9A,12},{0x06CA,11}, + {0x1B37,13},{0x366C,14},{0x0042, 7},{0x00D8, 8} + }, + { + {0x0000, 4},{0x002D, 6},{0x00F7, 8},{0x0058, 7}, + {0x0167, 9},{0x02CB,10},{0x02CA,10},{0x000E, 6}, + {0x1661,13},{0x0003, 3},{0x0002, 3},{0x0008, 4}, + {0x0009, 4},{0x000D, 4},{0x0002, 4},{0x001F, 5}, + {0x0017, 5},{0x0001, 4},{0x000C, 4},{0x000E, 4}, + {0x000A, 4},{0x0006, 5},{0x0078, 7},{0x000F, 6}, + {0x007A, 7},{0x0164, 9},{0x0599,11},{0x02CD,10}, + {0x0B31,12},{0x1660,13},{0x0079, 7},{0x00F6, 8} + }, + { + {0x0003, 4},{0x003C, 6},{0x000F, 7},{0x007A, 7}, + {0x001D, 8},{0x0020, 9},{0x0072,10},{0x0006, 6}, + {0x0399,13},{0x0004, 3},{0x0005, 3},{0x0005, 4}, + {0x0006, 4},{0x000E, 4},{0x0004, 4},{0x0000, 4}, + {0x0019, 5},{0x0002, 4},{0x000D, 4},{0x0007, 4}, + {0x001F, 5},{0x0030, 6},{0x0011, 8},{0x0031, 6}, + {0x0005, 6},{0x0021, 9},{0x00E7,11},{0x0038, 9}, + {0x01CD,12},{0x0398,13},{0x007B, 7},{0x0009, 7} + }, + { + {0x0009, 4},{0x0002, 5},{0x0074, 7},{0x0007, 6}, + {0x00EC, 8},{0x00D1, 9},{0x01A6,10},{0x0006, 6}, + {0x0D21,13},{0x0005, 3},{0x0006, 3},{0x0008, 4}, + {0x0007, 4},{0x000F, 4},{0x0004, 4},{0x0000, 4}, + {0x001C, 5},{0x0002, 4},{0x0005, 4},{0x0003, 4}, + {0x000C, 5},{0x0035, 7},{0x01A7,10},{0x001B, 6}, + {0x0077, 7},{0x01A5,10},{0x0349,11},{0x00D0, 9}, + {0x0691,12},{0x0D20,13},{0x0075, 7},{0x00ED, 8} + }, + { + {0x000A, 4},{0x000C, 5},{0x0012, 6},{0x001B, 6}, + {0x00B7, 8},{0x016C, 9},{0x0099, 9},{0x005A, 7}, + {0x16D8,13},{0x0007, 3},{0x0006, 3},{0x0009, 4}, + {0x0008, 4},{0x0000, 3},{0x0005, 4},{0x0017, 5}, + {0x000E, 5},{0x0002, 4},{0x0003, 4},{0x000F, 5}, + {0x001A, 6},{0x004D, 8},{0x2DB3,14},{0x002C, 6}, + {0x0011, 6},{0x02DA,10},{0x05B7,11},{0x0098, 9}, + {0x0B6D,12},{0x2DB2,14},{0x0010, 6},{0x0027, 7} + }, + { + {0x000D, 4},{0x000F, 5},{0x001D, 6},{0x0008, 5}, + {0x0051, 7},{0x0056, 8},{0x00AF, 9},{0x002A, 7}, + {0x148A,13},{0x0007, 3},{0x0000, 2},{0x0008, 4}, + {0x0009, 4},{0x000C, 4},{0x0006, 4},{0x0017, 5}, + {0x000B, 5},{0x0016, 5},{0x0015, 5},{0x0009, 5}, + {0x0050, 7},{0x00AE, 9},{0x2917,14},{0x001C, 6}, + {0x0014, 6},{0x0290,10},{0x0523,11},{0x0149, 9}, + {0x0A44,12},{0x2916,14},{0x0053, 7},{0x00A5, 8} + }, + { + {0x0001, 4},{0x001D, 6},{0x00F5, 8},{0x00F4, 8}, + {0x024D,10},{0x0499,11},{0x0498,11},{0x0001, 5}, + {0x0021, 6},{0x0006, 3},{0x0005, 3},{0x0006, 4}, + {0x0005, 4},{0x0002, 4},{0x0007, 5},{0x0025, 6}, + {0x007B, 7},{0x001C, 6},{0x0020, 6},{0x000D, 6}, + {0x0048, 7},{0x0092, 8},{0x0127, 9},{0x000E, 4}, + {0x0004, 4},{0x0011, 5},{0x000C, 6},{0x003C, 6}, + {0x000F, 5},{0x0000, 5},{0x001F, 5},{0x0013, 5} + }, + { + {0x0005, 4},{0x003C, 6},{0x0040, 7},{0x000D, 7}, + {0x0031, 9},{0x0061,10},{0x0060,10},{0x0002, 5}, + {0x00F5, 8},{0x0006, 3},{0x0005, 3},{0x0007, 4}, + {0x0006, 4},{0x0002, 4},{0x0009, 5},{0x0025, 6}, + {0x0007, 6},{0x0021, 6},{0x0024, 6},{0x0010, 6}, + {0x0041, 7},{0x00F4, 8},{0x0019, 8},{0x000E, 4}, + {0x0003, 4},{0x0011, 5},{0x0011, 6},{0x003F, 6}, + {0x003E, 6},{0x007B, 7},{0x0000, 4},{0x0013, 5} + }, + { + {0x000A, 4},{0x0007, 5},{0x0001, 6},{0x0009, 6}, + {0x0131, 9},{0x0261,10},{0x0260,10},{0x0015, 6}, + {0x0001, 7},{0x0007, 3},{0x0006, 3},{0x0008, 4}, + {0x0007, 4},{0x0006, 4},{0x0012, 5},{0x002F, 6}, + {0x0014, 6},{0x0027, 6},{0x002D, 6},{0x0016, 6}, + {0x004D, 7},{0x0099, 8},{0x0000, 7},{0x0004, 4}, + {0x0001, 4},{0x0005, 5},{0x0017, 6},{0x002E, 6}, + {0x002C, 6},{0x0008, 6},{0x0006, 5},{0x0001, 5} + }, + { + {0x0000, 3},{0x000E, 5},{0x0017, 6},{0x002A, 6}, + {0x0010, 7},{0x00F9,10},{0x00F8,10},{0x001E, 7}, + {0x003F, 8},{0x0007, 3},{0x0006, 3},{0x0009, 4}, + {0x0008, 4},{0x0006, 4},{0x000F, 5},{0x0005, 5}, + {0x0016, 6},{0x0029, 6},{0x002B, 6},{0x0015, 6}, + {0x0050, 7},{0x0011, 7},{0x007D, 9},{0x0004, 4}, + {0x0017, 5},{0x0006, 5},{0x0014, 6},{0x002C, 6}, + {0x002D, 6},{0x000E, 6},{0x0009, 6},{0x0051, 7} + }, + { + {0x0002, 3},{0x0018, 5},{0x002F, 6},{0x000D, 5}, + {0x0053, 7},{0x0295,10},{0x0294,10},{0x00A4, 8}, + {0x007C, 8},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x001B, 5},{0x000C, 5},{0x0028, 6}, + {0x006A, 7},{0x001E, 6},{0x001D, 6},{0x0069, 7}, + {0x00D7, 8},{0x007D, 8},{0x014B, 9},{0x0019, 5}, + {0x0016, 5},{0x002E, 6},{0x001C, 6},{0x002B, 6}, + {0x002A, 6},{0x0068, 7},{0x003F, 7},{0x00D6, 8} + }, + { + {0x0002, 3},{0x001B, 5},{0x000C, 5},{0x0018, 5}, + {0x0029, 6},{0x007F, 8},{0x02F0,10},{0x0198, 9}, + {0x0179, 9},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x001A, 5},{0x000D, 5},{0x002A, 6}, + {0x0064, 7},{0x001E, 6},{0x0067, 7},{0x005F, 7}, + {0x00CD, 8},{0x007E, 8},{0x02F1,10},{0x0016, 5}, + {0x000E, 5},{0x002E, 6},{0x0065, 7},{0x002B, 6}, + {0x0028, 6},{0x003E, 7},{0x00BD, 8},{0x0199, 9} + }, + { + {0x0002, 3},{0x0007, 4},{0x0016, 5},{0x0006, 4}, + {0x0036, 6},{0x005C, 7},{0x015D, 9},{0x015C, 9}, + {0x02BF,10},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x0018, 5},{0x0034, 6},{0x002A, 6}, + {0x005E, 7},{0x006A, 7},{0x0064, 7},{0x005D, 7}, + {0x00CB, 8},{0x00AD, 8},{0x02BE,10},{0x0014, 5}, + {0x0033, 6},{0x006E, 7},{0x005F, 7},{0x006F, 7}, + {0x006B, 7},{0x00CA, 8},{0x00AC, 8},{0x015E, 9} + }, + { + {0x000F, 4},{0x001D, 5},{0x0018, 5},{0x000B, 4}, + {0x0019, 5},{0x0029, 6},{0x00D6, 8},{0x0551,11}, + {0x0AA1,12},{0x0001, 2},{0x0000, 2},{0x0009, 4}, + {0x0008, 4},{0x001B, 5},{0x0038, 6},{0x0028, 6}, + {0x0057, 7},{0x006A, 7},{0x0068, 7},{0x0056, 7}, + {0x00E5, 8},{0x0155, 9},{0x0AA0,12},{0x0073, 7}, + {0x0069, 7},{0x00D7, 8},{0x00AB, 8},{0x00E4, 8}, + {0x00A9, 8},{0x0151, 9},{0x0150, 9},{0x02A9,10} + }, + { + {0x0008, 5},{0x0025, 7},{0x017A, 9},{0x02F7,10}, + {0x0BDB,12},{0x17B4,13},{0x2F6B,14},{0x001D, 5}, + {0x2F6A,14},{0x0008, 4},{0x0007, 4},{0x0001, 4}, + {0x0002, 4},{0x000A, 4},{0x0006, 4},{0x0000, 4}, + {0x001C, 5},{0x0009, 4},{0x000D, 4},{0x000F, 4}, + {0x000C, 4},{0x0003, 4},{0x000A, 5},{0x0016, 5}, + {0x0013, 6},{0x005D, 7},{0x0024, 7},{0x00BC, 8}, + {0x005C, 7},{0x05EC,11},{0x000B, 5},{0x005F, 7} + }, + { + {0x000F, 5},{0x0010, 6},{0x004B, 8},{0x00C6, 8}, + {0x031D,10},{0x0C71,12},{0x0C70,12},{0x0001, 4}, + {0x0C73,12},{0x0008, 4},{0x0009, 4},{0x0002, 4}, + {0x0003, 4},{0x000B, 4},{0x0006, 4},{0x0000, 4}, + {0x001C, 5},{0x0005, 4},{0x000D, 4},{0x000F, 4}, + {0x000A, 4},{0x0019, 5},{0x0013, 6},{0x001D, 5}, + {0x0030, 6},{0x0062, 7},{0x0024, 7},{0x004A, 8}, + {0x018F, 9},{0x0C72,12},{0x000E, 5},{0x0011, 6} + }, + { + {0x001B, 5},{0x0003, 6},{0x008D, 8},{0x0040, 7}, + {0x0239,10},{0x0471,11},{0x08E0,12},{0x0003, 4}, + {0x11C3,13},{0x000A, 4},{0x0009, 4},{0x0004, 4}, + {0x0005, 4},{0x000E, 4},{0x0007, 4},{0x0001, 4}, + {0x001E, 5},{0x0006, 4},{0x000C, 4},{0x000B, 4}, + {0x0002, 4},{0x0000, 5},{0x0041, 7},{0x001F, 5}, + {0x0022, 6},{0x0002, 6},{0x008F, 8},{0x008C, 8}, + {0x011D, 9},{0x11C2,13},{0x001A, 5},{0x0021, 6} + }, + { + {0x001F, 5},{0x0003, 6},{0x0003, 7},{0x0043, 7}, + {0x000B, 9},{0x0015,10},{0x0051,12},{0x0003, 4}, + {0x0050,12},{0x000D, 4},{0x000C, 4},{0x0004, 4}, + {0x0006, 4},{0x000E, 4},{0x000A, 4},{0x0001, 4}, + {0x001E, 5},{0x0005, 4},{0x0009, 4},{0x0007, 4}, + {0x0011, 5},{0x0002, 6},{0x0004, 8},{0x0002, 4}, + {0x002D, 6},{0x0020, 6},{0x0042, 7},{0x0001, 7}, + {0x0000, 7},{0x0029,11},{0x0017, 5},{0x002C, 6} + }, + { + {0x0003, 4},{0x001F, 6},{0x003A, 7},{0x005D, 7}, + {0x0173, 9},{0x02E4,10},{0x172D,13},{0x0004, 4}, + {0x172C,13},{0x000F, 4},{0x000E, 4},{0x0009, 4}, + {0x0008, 4},{0x000C, 4},{0x000A, 4},{0x0001, 4}, + {0x0016, 5},{0x0002, 4},{0x0005, 4},{0x001A, 5}, + {0x002F, 6},{0x0038, 7},{0x05CA,11},{0x0006, 4}, + {0x0037, 6},{0x001E, 6},{0x003B, 7},{0x0039, 7}, + {0x00B8, 8},{0x0B97,12},{0x0000, 4},{0x0036, 6} + }, + { + {0x0006, 4},{0x0037, 6},{0x005D, 7},{0x000C, 6}, + {0x00B9, 8},{0x02E3,10},{0x05C4,11},{0x0004, 4}, + {0x1715,13},{0x0000, 3},{0x000F, 4},{0x0008, 4}, + {0x0007, 4},{0x000C, 4},{0x0009, 4},{0x001D, 5}, + {0x0016, 5},{0x001C, 5},{0x001A, 5},{0x000B, 5}, + {0x005E, 7},{0x0170, 9},{0x1714,13},{0x000A, 4}, + {0x000A, 5},{0x0036, 6},{0x005F, 7},{0x001B, 7}, + {0x001A, 7},{0x0B8B,12},{0x0002, 4},{0x0007, 5} + }, + { + {0x000C, 4},{0x000B, 5},{0x0079, 7},{0x0022, 6}, + {0x00F0, 8},{0x0119, 9},{0x0230,10},{0x001D, 5}, + {0x08C4,12},{0x0001, 3},{0x0000, 3},{0x000A, 4}, + {0x0009, 4},{0x000B, 4},{0x0007, 4},{0x001C, 5}, + {0x003D, 6},{0x000D, 5},{0x0008, 5},{0x0015, 6}, + {0x008D, 8},{0x118B,13},{0x118A,13},{0x000D, 4}, + {0x0010, 5},{0x0009, 5},{0x0014, 6},{0x0047, 7}, + {0x00F1, 8},{0x0463,11},{0x001F, 5},{0x000C, 5} + }, + { + {0x0000, 3},{0x001A, 5},{0x0033, 6},{0x000C, 5}, + {0x0046, 7},{0x01E3, 9},{0x03C5,10},{0x0017, 5}, + {0x1E21,13},{0x0002, 3},{0x0001, 3},{0x0009, 4}, + {0x000A, 4},{0x0007, 4},{0x001B, 5},{0x003D, 6}, + {0x001B, 6},{0x0022, 6},{0x0079, 7},{0x00F0, 8}, + {0x1E20,13},{0x1E23,13},{0x1E22,13},{0x000E, 4}, + {0x0016, 5},{0x0018, 5},{0x0032, 6},{0x001A, 6}, + {0x0047, 7},{0x0789,11},{0x001F, 5},{0x0010, 5} + }, + { + {0x001D, 5},{0x0061, 7},{0x004E, 8},{0x009E, 9}, + {0x027C,11},{0x09F5,13},{0x09F4,13},{0x0003, 4}, + {0x0060, 7},{0x0000, 3},{0x000F, 4},{0x000B, 4}, + {0x000A, 4},{0x0009, 4},{0x0005, 4},{0x000D, 5}, + {0x0031, 6},{0x0008, 5},{0x0038, 6},{0x0012, 6}, + {0x0026, 7},{0x013F,10},{0x04FB,12},{0x000D, 4}, + {0x0002, 4},{0x000C, 5},{0x0039, 6},{0x001C, 6}, + {0x000F, 5},{0x001D, 6},{0x0008, 4},{0x0019, 5} + }, + { + {0x0007, 4},{0x0019, 6},{0x00AB, 8},{0x00AA, 8}, + {0x0119,10},{0x0461,12},{0x0460,12},{0x001B, 5}, + {0x0047, 8},{0x0001, 3},{0x0000, 3},{0x000C, 4}, + {0x000B, 4},{0x0009, 4},{0x0005, 4},{0x000D, 5}, + {0x0035, 6},{0x003D, 6},{0x003C, 6},{0x0018, 6}, + {0x0022, 7},{0x008D, 9},{0x0231,11},{0x000E, 4}, + {0x001F, 5},{0x0009, 5},{0x002B, 6},{0x0010, 6}, + {0x0034, 6},{0x0054, 7},{0x0008, 4},{0x0014, 5} + }, + { + {0x000C, 4},{0x0005, 5},{0x0008, 6},{0x005B, 7}, + {0x004D, 9},{0x0131,11},{0x0261,12},{0x001A, 5}, + {0x0012, 7},{0x0000, 3},{0x000F, 4},{0x000A, 4}, + {0x0009, 4},{0x0006, 4},{0x001B, 5},{0x0006, 5}, + {0x001C, 6},{0x002C, 6},{0x0015, 6},{0x005A, 7}, + {0x0027, 8},{0x0099,10},{0x0260,12},{0x000E, 4}, + {0x0004, 4},{0x000F, 5},{0x0007, 5},{0x001D, 6}, + {0x000B, 5},{0x0014, 6},{0x0008, 4},{0x0017, 5} + }, + { + {0x000F, 4},{0x0013, 5},{0x0075, 7},{0x0024, 6}, + {0x0095, 8},{0x0251,10},{0x04A0,11},{0x0010, 5}, + {0x00C8, 8},{0x0002, 3},{0x0001, 3},{0x0001, 4}, + {0x0000, 4},{0x001A, 5},{0x0011, 5},{0x002C, 6}, + {0x0065, 7},{0x0074, 7},{0x004B, 7},{0x00C9, 8}, + {0x0129, 9},{0x0943,12},{0x0942,12},{0x0003, 3}, + {0x000A, 4},{0x001C, 5},{0x0018, 5},{0x0033, 6}, + {0x0017, 5},{0x002D, 6},{0x001B, 5},{0x003B, 6} + }, + { + {0x0003, 3},{0x001A, 5},{0x002D, 6},{0x0038, 6}, + {0x0028, 7},{0x0395,10},{0x0E51,12},{0x0037, 6}, + {0x00E4, 8},{0x0001, 3},{0x0000, 3},{0x001F, 5}, + {0x001E, 5},{0x0017, 5},{0x003A, 6},{0x0073, 7}, + {0x002A, 7},{0x002B, 7},{0x0029, 7},{0x01CB, 9}, + {0x0729,11},{0x1CA1,13},{0x1CA0,13},{0x0004, 3}, + {0x000A, 4},{0x0004, 4},{0x0018, 5},{0x0036, 6}, + {0x000B, 5},{0x002C, 6},{0x0019, 5},{0x003B, 6} + }, + { + {0x0004, 3},{0x0004, 4},{0x003F, 6},{0x0017, 5}, + {0x0075, 7},{0x01F5, 9},{0x07D1,11},{0x0017, 6}, + {0x01F6, 9},{0x0001, 3},{0x0000, 3},{0x001B, 5}, + {0x001A, 5},{0x000A, 5},{0x0032, 6},{0x0074, 7}, + {0x00F8, 8},{0x00F9, 8},{0x01F7, 9},{0x03E9,10}, + {0x0FA0,12},{0x1F43,13},{0x1F42,13},{0x0003, 3}, + {0x000A, 4},{0x001E, 5},{0x001C, 5},{0x003B, 6}, + {0x0018, 5},{0x0016, 6},{0x0016, 5},{0x0033, 6} + }, + { + {0x0004, 3},{0x0007, 4},{0x0018, 5},{0x001E, 5}, + {0x0036, 6},{0x0031, 7},{0x0177, 9},{0x0077, 7}, + {0x0176, 9},{0x0001, 3},{0x0000, 3},{0x001A, 5}, + {0x0019, 5},{0x003A, 6},{0x0019, 6},{0x005C, 7}, + {0x00BA, 8},{0x0061, 8},{0x00C1, 9},{0x0180,10}, + {0x0302,11},{0x0607,12},{0x0606,12},{0x0002, 3}, + {0x000A, 4},{0x001F, 5},{0x001C, 5},{0x0037, 6}, + {0x0016, 5},{0x0076, 7},{0x000D, 5},{0x002F, 6} + }, + { + {0x0000, 3},{0x000A, 4},{0x001A, 5},{0x000C, 4}, + {0x001D, 5},{0x0039, 6},{0x0078, 7},{0x005E, 7}, + {0x0393,11},{0x0002, 3},{0x0001, 3},{0x0016, 5}, + {0x000F, 5},{0x002E, 6},{0x005F, 7},{0x0073, 8}, + {0x00E5, 9},{0x01C8,10},{0x0E4A,13},{0x1C97,14}, + {0x1C96,14},{0x0E49,13},{0x0E48,13},{0x0004, 3}, + {0x0006, 4},{0x001F, 5},{0x001B, 5},{0x001D, 6}, + {0x0038, 6},{0x0038, 7},{0x003D, 6},{0x0079, 7} + }, + { + {0x000B, 5},{0x002B, 7},{0x0054, 8},{0x01B7, 9}, + {0x06D9,11},{0x0DB1,12},{0x0DB0,12},{0x0002, 4}, + {0x00AB, 9},{0x0009, 4},{0x000A, 4},{0x0007, 4}, + {0x0008, 4},{0x000F, 4},{0x000C, 4},{0x0003, 4}, + {0x001D, 5},{0x0004, 4},{0x000B, 4},{0x0006, 4}, + {0x001A, 5},{0x0003, 6},{0x00AA, 9},{0x0001, 4}, + {0x0000, 5},{0x0014, 6},{0x006C, 7},{0x00DA, 8}, + {0x0002, 6},{0x036D,10},{0x001C, 5},{0x0037, 6} + }, + { + {0x001D, 5},{0x0004, 6},{0x00B6, 8},{0x006A, 8}, + {0x05B9,11},{0x16E1,13},{0x16E0,13},{0x0007, 4}, + {0x016F, 9},{0x000C, 4},{0x000D, 4},{0x0009, 4}, + {0x0008, 4},{0x000F, 4},{0x000A, 4},{0x0003, 4}, + {0x0017, 5},{0x0002, 4},{0x0004, 4},{0x001C, 5}, + {0x002C, 6},{0x006B, 8},{0x0B71,12},{0x0005, 4}, + {0x0003, 5},{0x001B, 6},{0x005A, 7},{0x0034, 7}, + {0x0005, 6},{0x02DD,10},{0x0000, 4},{0x000C, 5} + }, + { + {0x0003, 4},{0x007F, 7},{0x00A1, 8},{0x00A0, 8}, + {0x020C,10},{0x0834,12},{0x106B,13},{0x0007, 4}, + {0x0082, 8},{0x000E, 4},{0x000D, 4},{0x000B, 4}, + {0x000C, 4},{0x0000, 3},{0x0009, 4},{0x0002, 4}, + {0x0011, 5},{0x001E, 5},{0x0015, 5},{0x003E, 6}, + {0x0040, 7},{0x041B,11},{0x106A,13},{0x0006, 4}, + {0x000A, 5},{0x0029, 6},{0x007E, 7},{0x0051, 7}, + {0x0021, 6},{0x0107, 9},{0x0004, 4},{0x000B, 5} + }, + { + {0x0007, 4},{0x001B, 6},{0x00F6, 8},{0x00E9, 8}, + {0x03A1,10},{0x0740,11},{0x0E82,12},{0x001F, 5}, + {0x01EF, 9},{0x0001, 3},{0x0002, 3},{0x000B, 4}, + {0x000C, 4},{0x000D, 4},{0x0008, 4},{0x001C, 5}, + {0x0003, 5},{0x0012, 5},{0x0002, 5},{0x0075, 7}, + {0x01D1, 9},{0x1D07,13},{0x1D06,13},{0x000A, 4}, + {0x0013, 5},{0x003B, 6},{0x001A, 6},{0x007A, 7}, + {0x003C, 6},{0x01EE, 9},{0x0000, 4},{0x000C, 5} + }, + { + {0x000D, 4},{0x003D, 6},{0x0042, 7},{0x0037, 7}, + {0x00D9, 9},{0x0362,11},{0x06C6,12},{0x001F, 5}, + {0x0086, 8},{0x0001, 3},{0x0002, 3},{0x000C, 4}, + {0x000B, 4},{0x000A, 4},{0x0001, 4},{0x000F, 5}, + {0x0025, 6},{0x003C, 6},{0x001A, 6},{0x0087, 8}, + {0x01B0,10},{0x0D8F,13},{0x0D8E,13},{0x000E, 4}, + {0x0013, 5},{0x000C, 5},{0x0024, 6},{0x0020, 6}, + {0x0011, 5},{0x006D, 8},{0x0000, 4},{0x000E, 5} + }, + { + {0x0000, 3},{0x0012, 5},{0x0076, 7},{0x0077, 7}, + {0x014D, 9},{0x0533,11},{0x14C9,13},{0x0013, 5}, + {0x00A5, 8},{0x0002, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x0008, 4},{0x001A, 5},{0x002B, 6}, + {0x0075, 7},{0x0074, 7},{0x00A7, 8},{0x0298,10}, + {0x14C8,13},{0x14CB,13},{0x14CA,13},{0x000F, 4}, + {0x001C, 5},{0x0007, 5},{0x002A, 6},{0x0028, 6}, + {0x001B, 5},{0x00A4, 8},{0x0002, 4},{0x0006, 5} + }, + { + {0x0002, 3},{0x001A, 5},{0x002B, 6},{0x003A, 6}, + {0x00ED, 8},{0x0283,10},{0x0A0A,12},{0x0004, 5}, + {0x00A1, 8},{0x0004, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x001F, 5},{0x0006, 5},{0x0077, 7}, + {0x00A3, 8},{0x00A2, 8},{0x0140, 9},{0x1417,13}, + {0x1416,13},{0x0A09,12},{0x0A08,12},{0x0000, 3}, + {0x001E, 5},{0x0007, 5},{0x002A, 6},{0x0029, 6}, + {0x001C, 5},{0x00EC, 8},{0x001B, 5},{0x0005, 5} + }, + { + {0x0002, 3},{0x0002, 4},{0x0018, 5},{0x001D, 5}, + {0x0035, 6},{0x00E4, 8},{0x01CF,11},{0x001D, 7}, + {0x0072, 9},{0x0004, 3},{0x0005, 3},{0x0006, 4}, + {0x0007, 4},{0x0006, 5},{0x0073, 7},{0x0038, 8}, + {0x01CE,11},{0x039B,12},{0x0398,12},{0x0733,13}, + {0x0732,13},{0x0735,13},{0x0734,13},{0x0000, 3}, + {0x001F, 5},{0x001B, 5},{0x0034, 6},{0x000F, 6}, + {0x001E, 5},{0x00E5, 8},{0x0019, 5},{0x0038, 6} + }, + { + {0x0016, 5},{0x0050, 7},{0x0172, 9},{0x02E7,10}, + {0x1732,13},{0x2E67,14},{0x2E66,14},{0x0006, 4}, + {0x0051, 7},{0x0001, 3},{0x0000, 3},{0x000D, 4}, + {0x000C, 4},{0x0009, 4},{0x001C, 5},{0x0009, 5}, + {0x001C, 6},{0x001D, 6},{0x005D, 7},{0x00B8, 8}, + {0x05CD,11},{0x1731,13},{0x1730,13},{0x000F, 4}, + {0x0005, 4},{0x000F, 5},{0x0008, 5},{0x0029, 6}, + {0x001D, 5},{0x002F, 6},{0x0008, 4},{0x0015, 5} + }, + { + {0x0009, 4},{0x0021, 6},{0x0040, 7},{0x00AD, 8}, + {0x02B0,10},{0x1589,13},{0x1588,13},{0x001C, 5}, + {0x005F, 7},{0x0000, 3},{0x000F, 4},{0x000D, 4}, + {0x000C, 4},{0x0006, 4},{0x0011, 5},{0x002A, 6}, + {0x0057, 7},{0x005E, 7},{0x0041, 7},{0x0159, 9}, + {0x0563,11},{0x158B,13},{0x158A,13},{0x0001, 3}, + {0x0005, 4},{0x0014, 5},{0x003B, 6},{0x002E, 6}, + {0x0004, 4},{0x003A, 6},{0x0007, 4},{0x0016, 5} + }, + { + {0x000E, 4},{0x0007, 5},{0x0046, 7},{0x0045, 7}, + {0x0064, 9},{0x032A,12},{0x0657,13},{0x0018, 5}, + {0x000D, 6},{0x0000, 3},{0x000F, 4},{0x000A, 4}, + {0x000B, 4},{0x001A, 5},{0x0036, 6},{0x0047, 7}, + {0x0044, 7},{0x0018, 7},{0x0033, 8},{0x00CB,10}, + {0x0656,13},{0x0329,12},{0x0328,12},{0x0002, 3}, + {0x0006, 4},{0x0019, 5},{0x000E, 5},{0x0037, 6}, + {0x0009, 4},{0x000F, 5},{0x0002, 4},{0x0010, 5} + }, + { + {0x0003, 3},{0x0018, 5},{0x0023, 6},{0x0077, 7}, + {0x0194, 9},{0x1956,13},{0x32AF,14},{0x003A, 6}, + {0x0076, 7},{0x0002, 3},{0x0001, 3},{0x001F, 5}, + {0x001E, 5},{0x0014, 5},{0x0022, 6},{0x0064, 7}, + {0x0197, 9},{0x0196, 9},{0x032B,10},{0x0654,11}, + {0x32AE,14},{0x1955,13},{0x1954,13},{0x0000, 3}, + {0x0009, 4},{0x001C, 5},{0x0015, 5},{0x0010, 5}, + {0x000D, 4},{0x0017, 5},{0x0016, 5},{0x0033, 6} + }, + { + {0x0005, 3},{0x0006, 4},{0x003E, 6},{0x0010, 5}, + {0x0048, 7},{0x093F,12},{0x24FA,14},{0x0032, 6}, + {0x0067, 7},{0x0002, 3},{0x0001, 3},{0x001B, 5}, + {0x001E, 5},{0x0034, 6},{0x0066, 7},{0x0092, 8}, + {0x0126, 9},{0x024E,10},{0x049E,11},{0x49F7,15}, + {0x49F6,15},{0x24F9,14},{0x24F8,14},{0x0000, 3}, + {0x0007, 4},{0x0018, 5},{0x0011, 5},{0x003F, 6}, + {0x000E, 4},{0x0013, 5},{0x0035, 6},{0x0025, 6} + }, + { + {0x0005, 3},{0x0008, 4},{0x0012, 5},{0x001C, 5}, + {0x001C, 6},{0x00EA, 9},{0x1D75,14},{0x001E, 6}, + {0x0066, 7},{0x0001, 3},{0x0002, 3},{0x001B, 5}, + {0x001A, 5},{0x001F, 6},{0x003B, 7},{0x0074, 8}, + {0x01D6,10},{0x03AF,11},{0x1D74,14},{0x1D77,14}, + {0x1D76,14},{0x0EB9,13},{0x0EB8,13},{0x000F, 4}, + {0x0006, 4},{0x0013, 5},{0x003B, 6},{0x003A, 6}, + {0x0000, 3},{0x0018, 5},{0x0032, 6},{0x0067, 7} + }, + { + {0x0004, 3},{0x000A, 4},{0x001B, 5},{0x000C, 4}, + {0x000D, 5},{0x00E6, 8},{0x0684,11},{0x0072, 7}, + {0x00E7, 8},{0x0002, 3},{0x0001, 3},{0x0017, 5}, + {0x0016, 5},{0x0018, 6},{0x00D1, 8},{0x01A0, 9}, + {0x0686,11},{0x0D0F,12},{0x0D0A,12},{0x1A17,13}, + {0x1A16,13},{0x1A1D,13},{0x1A1C,13},{0x000F, 4}, + {0x001D, 5},{0x000E, 5},{0x0035, 6},{0x0038, 6}, + {0x0000, 3},{0x000F, 5},{0x0019, 6},{0x0069, 7} + }, + { + {0x0003, 3},{0x000C, 4},{0x001B, 5},{0x0000, 3}, + {0x0003, 4},{0x002E, 6},{0x0051, 9},{0x00BC, 8}, + {0x0053, 9},{0x0004, 3},{0x0002, 3},{0x0016, 5}, + {0x0015, 5},{0x0015, 7},{0x0050, 9},{0x00A4,10}, + {0x0294,12},{0x052B,13},{0x052A,13},{0x052D,13}, + {0x052C,13},{0x052F,13},{0x052E,13},{0x000E, 4}, + {0x001A, 5},{0x0004, 5},{0x0028, 6},{0x0029, 6}, + {0x000F, 4},{0x000B, 6},{0x005F, 7},{0x00BD, 8} + }, + { + {0x0003, 4},{0x0009, 6},{0x00D0, 8},{0x01A3, 9}, + {0x0344,10},{0x0D14,12},{0x1A2B,13},{0x0004, 4}, + {0x0015, 7},{0x0000, 3},{0x000F, 4},{0x000B, 4}, + {0x000C, 4},{0x000E, 4},{0x0009, 4},{0x001B, 5}, + {0x000A, 5},{0x0014, 5},{0x000D, 5},{0x002A, 6}, + {0x0014, 7},{0x068B,11},{0x1A2A,13},{0x0008, 4}, + {0x000B, 5},{0x002B, 6},{0x000B, 6},{0x0069, 7}, + {0x0035, 6},{0x0008, 6},{0x0007, 4},{0x000C, 5} + }, + { + {0x000A, 4},{0x003C, 6},{0x0032, 7},{0x0030, 7}, + {0x00C5, 9},{0x0621,12},{0x0620,12},{0x001F, 5}, + {0x0033, 7},{0x0001, 3},{0x0000, 3},{0x000E, 4}, + {0x000D, 4},{0x000C, 4},{0x0004, 4},{0x000D, 5}, + {0x0026, 6},{0x0027, 6},{0x0014, 6},{0x0063, 8}, + {0x0189,10},{0x0623,12},{0x0622,12},{0x000B, 4}, + {0x0012, 5},{0x003D, 6},{0x0022, 6},{0x0015, 6}, + {0x000B, 5},{0x0023, 6},{0x0007, 4},{0x0010, 5} + }, + { + {0x000F, 4},{0x000C, 5},{0x0043, 7},{0x0010, 6}, + {0x0044, 8},{0x0114,10},{0x0455,12},{0x0018, 5}, + {0x0023, 7},{0x0001, 3},{0x0000, 3},{0x000E, 4}, + {0x000D, 4},{0x0009, 4},{0x0019, 5},{0x0009, 5}, + {0x0017, 6},{0x0016, 6},{0x0042, 7},{0x008B, 9}, + {0x0454,12},{0x0457,12},{0x0456,12},{0x000B, 4}, + {0x0015, 5},{0x000A, 5},{0x0029, 6},{0x0020, 6}, + {0x000D, 5},{0x0028, 6},{0x0007, 4},{0x0011, 5} + }, + { + {0x0001, 3},{0x001A, 5},{0x0029, 6},{0x002A, 6}, + {0x00A0, 8},{0x0285,10},{0x1425,13},{0x0002, 5}, + {0x0000, 7},{0x0002, 3},{0x0003, 3},{0x000C, 4}, + {0x000B, 4},{0x0008, 4},{0x0012, 5},{0x0001, 6}, + {0x0051, 7},{0x0001, 7},{0x0143, 9},{0x0508,11}, + {0x1424,13},{0x1427,13},{0x1426,13},{0x000F, 4}, + {0x001C, 5},{0x0003, 5},{0x0037, 6},{0x002B, 6}, + {0x0013, 5},{0x0036, 6},{0x001D, 5},{0x0001, 5} + }, + { + {0x0004, 3},{0x001F, 5},{0x003D, 6},{0x0006, 5}, + {0x0016, 7},{0x0053, 9},{0x014A,11},{0x0034, 6}, + {0x002A, 8},{0x0002, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x001C, 5},{0x0037, 6},{0x0017, 7}, + {0x002B, 8},{0x0028, 8},{0x00A4,10},{0x052D,13}, + {0x052C,13},{0x052F,13},{0x052E,13},{0x0000, 3}, + {0x001D, 5},{0x0007, 5},{0x0004, 5},{0x0035, 6}, + {0x0014, 5},{0x0036, 6},{0x0015, 5},{0x003C, 6} + }, + { + {0x0004, 3},{0x000A, 4},{0x0007, 5},{0x001D, 5}, + {0x0009, 6},{0x01F3, 9},{0x07C7,11},{0x0008, 6}, + {0x01F0, 9},{0x0003, 3},{0x0002, 3},{0x000D, 4}, + {0x000C, 4},{0x0017, 5},{0x007D, 7},{0x01F2, 9}, + {0x07C6,11},{0x07C5,11},{0x1F12,13},{0x3E27,14}, + {0x3E26,14},{0x1F11,13},{0x1F10,13},{0x0000, 3}, + {0x001E, 5},{0x0006, 5},{0x0039, 6},{0x0038, 6}, + {0x003F, 6},{0x002C, 6},{0x0005, 5},{0x002D, 6} + }, + { + {0x0002, 3},{0x0007, 4},{0x0018, 5},{0x0003, 4}, + {0x0005, 5},{0x0035, 7},{0x004F, 9},{0x0012, 7}, + {0x04E5,13},{0x0005, 3},{0x0004, 3},{0x000D, 4}, + {0x000E, 4},{0x0033, 6},{0x0026, 8},{0x009D,10}, + {0x04E4,13},{0x04E7,13},{0x04E6,13},{0x04E1,13}, + {0x04E0,13},{0x04E3,13},{0x04E2,13},{0x0000, 3}, + {0x001F, 5},{0x000C, 5},{0x003D, 6},{0x003C, 6}, + {0x0032, 6},{0x0034, 7},{0x001B, 6},{0x0008, 6} + }, + { + {0x0000, 3},{0x0004, 4},{0x001C, 5},{0x000F, 4}, + {0x0002, 4},{0x0007, 5},{0x0075, 7},{0x00E8, 8}, + {0x1D2A,13},{0x0005, 3},{0x0004, 3},{0x000D, 4}, + {0x000C, 4},{0x0077, 7},{0x0E96,12},{0x3A57,14}, + {0x3A56,14},{0x3A5D,14},{0x3A5C,14},{0x3A5F,14}, + {0x3A5E,14},{0x1D29,13},{0x1D28,13},{0x0003, 3}, + {0x0006, 5},{0x000A, 5},{0x002C, 7},{0x0017, 6}, + {0x0076, 7},{0x01D3, 9},{0x03A4,10},{0x002D, 7} + }, + { + {0x000A, 4},{0x0024, 6},{0x00BF, 8},{0x0085, 8}, + {0x0211,10},{0x0842,12},{0x1087,13},{0x0018, 5}, + {0x0020, 6},{0x0001, 3},{0x0002, 3},{0x000E, 4}, + {0x000D, 4},{0x0007, 4},{0x0013, 5},{0x0025, 6}, + {0x005E, 7},{0x0043, 7},{0x00BE, 8},{0x0109, 9}, + {0x1086,13},{0x0841,12},{0x0840,12},{0x000F, 4}, + {0x0001, 4},{0x0011, 5},{0x0000, 5},{0x002E, 6}, + {0x0019, 5},{0x0001, 5},{0x0006, 4},{0x0016, 5} + }, + { + {0x0002, 3},{0x000F, 5},{0x006F, 7},{0x0061, 7}, + {0x0374,10},{0x1BA8,13},{0x3753,14},{0x0012, 5}, + {0x0036, 6},{0x0000, 3},{0x0001, 3},{0x000A, 4}, + {0x000B, 4},{0x001A, 5},{0x0031, 6},{0x0060, 7}, + {0x00DC, 8},{0x01BB, 9},{0x06EB,11},{0x1BAB,13}, + {0x3752,14},{0x3755,14},{0x3754,14},{0x000E, 4}, + {0x0006, 4},{0x0013, 5},{0x000E, 5},{0x003E, 6}, + {0x0008, 4},{0x001E, 5},{0x0019, 5},{0x003F, 6} + }, + { + {0x0003, 3},{0x001C, 5},{0x0025, 6},{0x0024, 6}, + {0x01DA, 9},{0x1DBD,13},{0x3B7C,14},{0x003C, 6}, + {0x003D, 6},{0x0000, 3},{0x0001, 3},{0x000B, 4}, + {0x000A, 4},{0x000B, 5},{0x0077, 7},{0x00EC, 8}, + {0x03B6,10},{0x076E,11},{0x1DBF,13},{0x76FB,15}, + {0x76FA,15},{0x3B79,14},{0x3B78,14},{0x000D, 4}, + {0x001F, 5},{0x0013, 5},{0x000A, 5},{0x0008, 5}, + {0x000C, 4},{0x0008, 4},{0x0009, 5},{0x003A, 6} + }, + { + {0x0005, 3},{0x0003, 4},{0x0004, 5},{0x0010, 5}, + {0x008F, 8},{0x0475,11},{0x11D1,13},{0x0079, 7}, + {0x0027, 6},{0x0002, 3},{0x0003, 3},{0x0001, 4}, + {0x0000, 4},{0x0026, 6},{0x0046, 7},{0x011C, 9}, + {0x0477,11},{0x08ED,12},{0x11D0,13},{0x11D3,13}, + {0x11D2,13},{0x11D9,13},{0x11D8,13},{0x000D, 4}, + {0x001F, 5},{0x0012, 5},{0x0005, 5},{0x003D, 6}, + {0x000C, 4},{0x000E, 4},{0x0022, 6},{0x0078, 7} + }, + { + {0x0005, 3},{0x000C, 4},{0x001B, 5},{0x0000, 4}, + {0x0006, 6},{0x03E2,10},{0x3E3D,14},{0x000F, 7}, + {0x0034, 6},{0x0003, 3},{0x0002, 3},{0x001E, 5}, + {0x001D, 5},{0x007D, 7},{0x01F0, 9},{0x07C6,11}, + {0x3E3C,14},{0x3E3F,14},{0x3E3E,14},{0x3E39,14}, + {0x3E38,14},{0x3E3B,14},{0x3E3A,14},{0x0008, 4}, + {0x001C, 5},{0x0002, 5},{0x003F, 6},{0x0035, 6}, + {0x0009, 4},{0x0001, 3},{0x000E, 7},{0x00F9, 8} + }, + { + {0x0004, 3},{0x000B, 4},{0x0001, 4},{0x000A, 4}, + {0x001E, 6},{0x00E0, 9},{0x0E1E,13},{0x0071, 8}, + {0x0039, 7},{0x0007, 3},{0x0006, 3},{0x000D, 5}, + {0x000C, 5},{0x0020, 7},{0x01C2,10},{0x1C3F,14}, + {0x1C3E,14},{0x0E19,13},{0x0E18,13},{0x0E1B,13}, + {0x0E1A,13},{0x0E1D,13},{0x0E1C,13},{0x0000, 4}, + {0x0009, 5},{0x001D, 6},{0x001F, 6},{0x0011, 6}, + {0x0005, 4},{0x0001, 3},{0x0043, 8},{0x0042, 8} + }, + { + {0x0004, 3},{0x000D, 4},{0x0007, 4},{0x0002, 3}, + {0x0014, 5},{0x016C, 9},{0x16D1,13},{0x02DF,10}, + {0x016E, 9},{0x0000, 2},{0x0007, 3},{0x002C, 6}, + {0x002B, 6},{0x02DE,10},{0x16D0,13},{0x16D3,13}, + {0x16D2,13},{0x2DB5,14},{0x2DB4,14},{0x2DB7,14}, + {0x2DB6,14},{0x16D9,13},{0x16D8,13},{0x000C, 5}, + {0x002A, 6},{0x005A, 7},{0x001B, 6},{0x001A, 6}, + {0x0017, 5},{0x000C, 4},{0x05B7,11},{0x05B5,11} + }, + { + {0x0002, 2},{0x000F, 4},{0x001C, 5},{0x000C, 4}, + {0x003B, 6},{0x01AC, 9},{0x1AD8,13},{0x35B3,14}, + {0x35B2,14},{0x0001, 2},{0x0000, 2},{0x0069, 7}, + {0x0068, 7},{0x35BD,14},{0x35BC,14},{0x35BF,14}, + {0x35BE,14},{0x35B9,14},{0x35B8,14},{0x35BB,14}, + {0x35BA,14},{0x35B5,14},{0x35B4,14},{0x01A9, 9}, + {0x01A8, 9},{0x035A,10},{0x00D7, 8},{0x00D5, 8}, + {0x003A, 6},{0x001B, 5},{0x35B7,14},{0x35B6,14} + }, + { + {0x0000, 3},{0x0010, 5},{0x0072, 7},{0x0071, 7}, + {0x0154, 9},{0x0AAB,12},{0x0AA8,12},{0x0014, 5}, + {0x0070, 7},{0x0002, 3},{0x0003, 3},{0x000C, 4}, + {0x000B, 4},{0x0003, 4},{0x0011, 5},{0x0073, 7}, + {0x0054, 7},{0x00AB, 8},{0x02AB,10},{0x1553,13}, + {0x1552,13},{0x1555,13},{0x1554,13},{0x000D, 4}, + {0x001E, 5},{0x0012, 5},{0x003E, 6},{0x002B, 6}, + {0x0002, 4},{0x003F, 6},{0x001D, 5},{0x0013, 5} + }, + { + {0x0003, 3},{0x001F, 5},{0x0029, 6},{0x003D, 6}, + {0x000C, 7},{0x0069,10},{0x0345,13},{0x0002, 5}, + {0x0028, 6},{0x0002, 3},{0x0001, 3},{0x000E, 4}, + {0x000C, 4},{0x0015, 5},{0x0007, 6},{0x001B, 8}, + {0x006B,10},{0x006A,10},{0x0344,13},{0x0347,13}, + {0x0346,13},{0x01A1,12},{0x01A0,12},{0x000B, 4}, + {0x001A, 5},{0x0012, 5},{0x0000, 5},{0x003C, 6}, + {0x0008, 4},{0x001B, 5},{0x0013, 5},{0x0001, 5} + }, + { + {0x0004, 3},{0x0004, 4},{0x003F, 6},{0x0014, 5}, + {0x0056, 7},{0x015C, 9},{0x15D5,13},{0x003C, 6}, + {0x002A, 6},{0x0000, 3},{0x0001, 3},{0x000E, 4}, + {0x000D, 4},{0x000C, 5},{0x00AF, 8},{0x02BB,10}, + {0x15D4,13},{0x15D7,13},{0x15D6,13},{0x15D1,13}, + {0x15D0,13},{0x15D3,13},{0x15D2,13},{0x000B, 4}, + {0x0019, 5},{0x000D, 5},{0x003E, 6},{0x0031, 6}, + {0x0007, 4},{0x0005, 4},{0x003D, 6},{0x0030, 6} + }, + { + {0x0005, 3},{0x0008, 4},{0x001A, 5},{0x0000, 4}, + {0x0036, 6},{0x0011, 8},{0x0106,12},{0x000A, 7}, + {0x006E, 7},{0x0002, 3},{0x0003, 3},{0x0003, 4}, + {0x0002, 4},{0x006F, 7},{0x0021, 9},{0x020F,13}, + {0x020E,13},{0x0101,12},{0x0100,12},{0x0103,12}, + {0x0102,12},{0x0105,12},{0x0104,12},{0x000C, 4}, + {0x001E, 5},{0x0003, 5},{0x003E, 6},{0x003F, 6}, + {0x0009, 4},{0x000E, 4},{0x000B, 7},{0x0009, 7} + }, + { + {0x0002, 3},{0x000E, 4},{0x001E, 5},{0x000C, 4}, + {0x001F, 5},{0x006E, 7},{0x00AD,10},{0x00AF,10}, + {0x0014, 7},{0x0004, 3},{0x0003, 3},{0x001A, 5}, + {0x0017, 5},{0x002A, 8},{0x0576,13},{0x0AEF,14}, + {0x0AEE,14},{0x0571,13},{0x0570,13},{0x0573,13}, + {0x0572,13},{0x0575,13},{0x0574,13},{0x0003, 4}, + {0x0016, 5},{0x0004, 5},{0x0036, 6},{0x000B, 6}, + {0x000A, 4},{0x0000, 3},{0x006F, 7},{0x00AC,10} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0003, 3},{0x0011, 5},{0x0020, 6},{0x0074, 7}, + {0x010D, 9},{0x0863,12},{0x0860,12},{0x000A, 5}, + {0x0075, 7},{0x0001, 3},{0x0000, 3},{0x000B, 4}, + {0x000A, 4},{0x0018, 5},{0x0038, 6},{0x0042, 7}, + {0x010F, 9},{0x010E, 9},{0x0219,10},{0x10C3,13}, + {0x10C2,13},{0x10C5,13},{0x10C4,13},{0x000F, 4}, + {0x0004, 4},{0x0019, 5},{0x000B, 5},{0x0039, 6}, + {0x0009, 4},{0x001B, 5},{0x001A, 5},{0x003B, 6} + }, + { + {0x0005, 3},{0x0001, 4},{0x003E, 6},{0x0001, 5}, + {0x00E2, 8},{0x1C6F,13},{0x38D9,14},{0x0039, 6}, + {0x001F, 6},{0x0002, 3},{0x0001, 3},{0x0009, 4}, + {0x0008, 4},{0x0000, 5},{0x0070, 7},{0x01C7, 9}, + {0x038C,10},{0x071A,11},{0x38D8,14},{0x38DB,14}, + {0x38DA,14},{0x38DD,14},{0x38DC,14},{0x000D, 4}, + {0x001D, 5},{0x000E, 5},{0x003F, 6},{0x003C, 6}, + {0x000C, 4},{0x0006, 4},{0x003D, 6},{0x001E, 6} + }, + { + {0x0006, 3},{0x000B, 4},{0x0011, 5},{0x001E, 5}, + {0x0074, 7},{0x03AA,10},{0x1D5C,13},{0x0001, 6}, + {0x0021, 6},{0x0001, 3},{0x0002, 3},{0x0007, 4}, + {0x0006, 4},{0x003E, 6},{0x00EB, 8},{0x01D4, 9}, + {0x0EAF,12},{0x3ABB,14},{0x3ABA,14},{0x1D59,13}, + {0x1D58,13},{0x1D5B,13},{0x1D5A,13},{0x000A, 4}, + {0x001C, 5},{0x0001, 5},{0x003F, 6},{0x003B, 6}, + {0x0001, 4},{0x0009, 4},{0x0020, 6},{0x0000, 6} + }, + { + {0x0004, 3},{0x000A, 4},{0x0017, 5},{0x0004, 4}, + {0x0016, 6},{0x016A, 9},{0x16B1,13},{0x0017, 7}, + {0x005B, 7},{0x0006, 3},{0x0007, 3},{0x0001, 4}, + {0x0000, 4},{0x000A, 6},{0x02D7,10},{0x0B5A,12}, + {0x16B0,13},{0x16B3,13},{0x16B2,13},{0x2D6D,14}, + {0x2D6C,14},{0x2D6F,14},{0x2D6E,14},{0x0006, 4}, + {0x000A, 5},{0x0004, 5},{0x002C, 6},{0x0017, 6}, + {0x0003, 4},{0x0007, 4},{0x0016, 7},{0x00B4, 8} + }, + { + {0x0005, 3},{0x000D, 4},{0x0005, 4},{0x0009, 4}, + {0x0033, 6},{0x0193, 9},{0x192C,13},{0x0061, 8}, + {0x0031, 7},{0x0000, 2},{0x0007, 3},{0x0010, 5}, + {0x0011, 5},{0x00C8, 8},{0x192F,13},{0x325B,14}, + {0x325A,14},{0x1929,13},{0x1928,13},{0x192B,13}, + {0x192A,13},{0x325D,14},{0x325C,14},{0x0018, 5}, + {0x001A, 6},{0x001B, 6},{0x0065, 7},{0x0019, 6}, + {0x0004, 4},{0x0007, 4},{0x0060, 8},{0x0324,10} + }, + { + {0x0006, 3},{0x0000, 3},{0x0002, 4},{0x000F, 4}, + {0x0039, 6},{0x01D9, 9},{0x1D82,13},{0x0761,11}, + {0x03BE,10},{0x0001, 2},{0x0002, 2},{0x000F, 6}, + {0x000E, 6},{0x0762,11},{0x3B07,14},{0x3B06,14}, + {0x3B1D,14},{0x3B1C,14},{0x3B1F,14},{0x3B1E,14}, + {0x3B19,14},{0x3B18,14},{0x3B1B,14},{0x0038, 6}, + {0x01DE, 9},{0x00ED, 8},{0x03BF,10},{0x00EE, 8}, + {0x003A, 6},{0x0006, 5},{0x0EC0,12},{0x3B1A,14} + }, + { + {0x0000, 2},{0x0002, 3},{0x000F, 5},{0x0006, 4}, + {0x001C, 6},{0x01D0,10},{0x0E8C,13},{0x1D1B,14}, + {0x1D1A,14},{0x0003, 2},{0x0002, 2},{0x00EA, 9}, + {0x00E9, 9},{0x0E89,13},{0x0E88,13},{0x0E8B,13}, + {0x0E8A,13},{0x1D65,14},{0x1D64,14},{0x1D67,14}, + {0x1D66,14},{0x1D61,14},{0x1D60,14},{0x03AD,11}, + {0x1D63,14},{0x1D62,14},{0x1D1D,14},{0x1D1C,14}, + {0x003B, 7},{0x01D7,10},{0x1D1F,14},{0x1D1E,14} + }, + { + {0x0002, 2},{0x000F, 4},{0x001C, 5},{0x000C, 4}, + {0x003B, 6},{0x01AC, 9},{0x1AD8,13},{0x35B3,14}, + {0x35B2,14},{0x0001, 2},{0x0000, 2},{0x0069, 7}, + {0x0068, 7},{0x35BD,14},{0x35BC,14},{0x35BF,14}, + {0x35BE,14},{0x35B9,14},{0x35B8,14},{0x35BB,14}, + {0x35BA,14},{0x35B5,14},{0x35B4,14},{0x01A9, 9}, + {0x01A8, 9},{0x035A,10},{0x00D7, 8},{0x00D5, 8}, + {0x003A, 6},{0x001B, 5},{0x35B7,14},{0x35B6,14} + } +}; + + + +/*A description of a Huffman code value used when encoding the tree.*/ +typedef struct{ + /*The bit pattern, left-shifted so that the MSB of all patterns is + aligned.*/ + unsigned long pattern; + /*The amount the bit pattern was shifted.*/ + int shift; + /*The token this bit pattern represents.*/ + int token; +}th_huff_entry; + + + +/*Compares two th_huff_entry structures by their bit patterns. + _c1: The first entry to compare. + _c2: The second entry to compare. + Return: <0 if _c1<_c2, >0 if _c1>_c2.*/ +static int huff_entry_cmp(const void *_c1,const void *_c2){ + unsigned long b1; + unsigned long b2; + b1=((const th_huff_entry *)_c1)->pattern; + b2=((const th_huff_entry *)_c2)->pattern; + return b1b2?1:0; +} + +int th_huff_codes2latex(const theora_huff_code _codes[80][32]){ + int i; + printf("\\twocolumn\n"); + for(i=0;i<80;i++){ + th_huff_entry entries[32]; + int maxlen; + int mask; + int j; + /*First, find the maximum code length so we can align all the bit + patterns.*/ + maxlen=_codes[i][0].nbits; + for(j=1;j<32;j++)if(maxlen<_codes[i][j].nbits)maxlen=_codes[i][j].nbits; + mask=(1<entries[j].shift;){ + printf("%c",(int)(entries[j].pattern>>k&1)+'0'); + } + printf("}"); + for(;k>=0;k--)printf(" "); + printf(" & "); + if(entries[j].token<10)printf(" "); + printf("$%i$ \\\\\n",entries[j].token); + } + printf("\\bottomrule\n"); + printf("\\\\\n"); + printf("\\multicolumn{2}{c}{VP3.1 Huffman Table Number $%i$}\n",i); + printf("\\end{tabular}\n"); + printf("\\end{center}\n"); + printf("\\vfill\n"); + printf("\n"); + } + printf("\\onecolumn\n"); + return 0; +} + +int main(int _argc,char **_argv){ + th_huff_codes2latex(TH_VP31_HUFF_CODES); + return 0; +} diff --git a/libs/libtheora-1.1/doc/spec/xifish.fig b/libs/libtheora-1.1/doc/spec/xifish.fig new file mode 100644 index 00000000..f044a2b5 --- /dev/null +++ b/libs/libtheora-1.1/doc/spec/xifish.fig @@ -0,0 +1,85 @@ +#FIG 3.2 +Landscape +Center +Inches +Letter +100.00 +Single +-2 +1200 2 +0 32 #496d9e +0 33 #304d71 +0 34 #8eb2cf +1 4 0 6 0 7 1 0 20 0.000 1 0.0000 1470 3255 270 270 1200 3255 1740 3255 +1 3 0 0 0 0 0 0 20 0.000 1 0.0000 1485 3255 75 75 1485 3255 1560 3255 +2 1 0 7 0 3 8 0 20 0.000 0 0 -1 0 0 6 + 2445 4140 2505 4350 2385 4425 2145 4425 2025 4380 1890 4320 +2 1 0 7 0 3 8 0 20 0.000 0 0 -1 0 0 20 + 2445 3480 2775 3450 2955 3390 3090 3315 3285 3285 3555 3285 + 3615 3390 3540 3675 3465 3720 3315 3765 3105 3810 3330 3765 + 3420 3825 3540 3900 3480 4260 3330 4320 3165 4305 2910 4260 + 2715 4185 2520 4185 +2 1 0 7 0 3 11 0 20 0.000 0 0 -1 0 0 9 + 1575 3150 1755 2985 2040 2820 2355 2760 2670 2850 2850 2985 + 3165 3270 3435 3420 2835 3780 +2 1 0 7 0 6 6 0 20 0.000 0 0 -1 0 0 15 + 900 3570 1020 3450 1095 3360 1395 3150 1545 3090 1725 3075 + 2025 3090 2205 3150 2295 3225 2385 3300 2445 3375 2550 3465 + 2655 3540 2775 3600 2865 3600 +2 1 0 7 0 3 4 0 20 0.000 0 0 -1 0 0 7 + 1515 4080 1770 4080 1875 3945 1965 3870 2025 3780 1995 3780 + 1665 3780 +2 1 0 0 -1 6 7 0 20 0.000 0 0 -1 0 0 11 + 2865 3615 2850 3735 2775 3945 2685 4080 2595 4155 2010 4185 + 1185 4170 1035 3990 1035 3870 975 3540 1155 3435 +2 1 0 0 0 3 5 0 20 0.000 0 0 -1 0 0 7 + 1035 3885 1005 4020 1095 4065 1245 4065 1245 3870 1050 3870 + 1065 3870 +2 1 0 7 0 3 0 0 20 0.000 0 0 -1 0 0 11 + 1245 3915 1245 3840 1170 3750 1005 3585 930 3510 750 3510 + 630 3600 645 3690 765 3780 885 3825 1035 3975 +2 1 0 7 0 3 0 0 20 0.000 0 0 -1 0 0 8 + 1095 3990 945 3990 855 4050 795 4140 885 4200 1095 4200 + 1155 4140 1245 4050 +2 1 0 7 0 6 6 0 20 0.000 0 0 -1 0 0 8 + 2685 4185 2400 4185 2220 4215 1920 4305 1695 4335 1485 4320 + 1245 4215 1155 4125 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2250 3900 2250 3825 2175 3825 2175 3900 2250 3900 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2250 3750 2250 3675 2175 3675 2175 3750 2250 3750 +2 1 0 0 -1 3 5 0 20 0.000 0 0 -1 0 0 9 + 1650 3780 1590 3975 1485 4035 1530 4080 1770 4065 1845 3960 + 1920 3900 1965 3795 1695 3780 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 1950 3450 1950 3375 1875 3375 1875 3450 1950 3450 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2400 3900 2400 3825 2325 3825 2325 3900 2400 3900 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2550 3975 2550 3900 2475 3900 2475 3975 2550 3975 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2700 3900 2700 3825 2625 3825 2625 3900 2700 3900 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2700 3750 2700 3675 2625 3675 2625 3750 2700 3750 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2550 3675 2550 3600 2475 3600 2475 3675 2550 3675 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2400 3750 2400 3675 2325 3675 2325 3750 2400 3750 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2400 3600 2400 3525 2325 3525 2325 3600 2400 3600 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2250 3600 2250 3525 2175 3525 2175 3600 2250 3600 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2250 3450 2250 3375 2175 3375 2175 3450 2250 3450 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2100 3525 2100 3450 2025 3450 2025 3525 2100 3525 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2100 3375 2100 3300 2025 3300 2025 3375 2100 3375 +2 2 0 0 0 0 3 0 20 0.000 0 0 0 0 0 5 + 2550 3825 2550 3750 2475 3750 2475 3825 2550 3825 +2 3 0 0 -1 32 13 0 20 0.000 0 0 7 0 0 5 + 2160 2055 3810 3705 2160 5355 510 3705 2160 2055 +2 1 0 0 32 34 12 0 20 0.000 0 0 -1 0 0 3 + 2160 2055 2160 3705 510 3705 +2 1 0 0 32 33 12 0 20 0.000 0 0 -1 0 0 3 + 3810 3705 2160 3705 2160 5355 diff --git a/libs/libtheora-1.1/doc/vp3-format.txt b/libs/libtheora-1.1/doc/vp3-format.txt new file mode 100644 index 00000000..408febe4 --- /dev/null +++ b/libs/libtheora-1.1/doc/vp3-format.txt @@ -0,0 +1,1305 @@ +VP3 Bitstream Format and Decoding Process +by Mike Melanson (mike at multimedia.cx) +v0.5: December 8, 2004 + + +[December 8, 2004: Note that this document is not complete and likely +will never be completed. However, it helped form the basis of Theora I +specification available at + http://www.theora.org/doc/Theora_I_spec.pdf ] + + +Contents +-------- + * Introduction + * Underlying Coding Concepts + * VP3 Coding Overview + * VP3 Chunk Format + * Decoding The Frame Header + * Initializing The Quantization Matrices + * Hilbert Coding Pattern + * Unpacking The Block Coding Information + * Unpacking The Macroblock Coding Mode Information + * Unpacking The Macroblock Motion Vectors + * Unpacking The DCT Coefficients + * Reversing The DC Prediction + * Reconstructing The Frame + * Theora Specification + * Appendix A: Quantization Matrices And Scale Factors + * Appendix B: Macroblock Coding Mode Alphabets + * Appendix C: DCT Coefficient VLC Tables + * Appendix D: The VP3 IDCT + * Acknowledgements + * References + * Changelog + + +Introduction +------------ +A company named On2 (http://www.on2.com) created a video codec named +VP3. Eventually, they decided to open source it. Like any body of code +that was produced on a deadline, the source code was not particularly +clean or well-documented. This makes it difficult to understand the +fundamental operation of the codec. + +This document describes the VP3 bitstream format and decoding process at +a higher level than source code. + + +Underlying Coding Concepts +-------------------------- +In order to understand the VP3 coding method it is necessary to +understand the individual steps in the process. Like many multimedia +compression algorithms VP3 does not consist of a single coding method. +Rather, it uses a chain of methods to achieve compression. + +If you are acquainted with the MPEG video clique then many of VP3's +coding concepts should look familiar as well. What follows is a list of +the coding methods used in VP3 and a brief description of each. + +* Discrete Cosine Transform (DCT): This is a magical mathematical +function that takes a group of numbers and turns it into another group +of numbers. The transformed group of numbers exhibits some curious +properties. Notably, larger numbers are concentrated in certain areas of +the transformed group. + +A video codec like VP3 often operates on 8x8 blocks of numbers. When +these 8x8 blocks are transformed using a DCT the larger numbers occur +mostly in the up and left areas of the block with the largest number +occurring as the first in the block (up-left corner). This number is +called the DC coefficient. The other 63 numbers are called the AC +coefficients. + +The DCT and its opposite operation, the inverse DCT, require a lot of +multiplications. Much research and experimentation is focused of +optimizing this phase of the coding/decoding process. + +* Quantization: This coding step tosses out information by essentially +dividing a number to be coded by a factor and throwing away the +remainder. The inverse process (dequantization) involves multiplying by +the same factor to obtain a number that is close enough to the original. + +* Run Length Encoding (RLE): The concept behind RLE is to shorten runs +of numbers that are the same. For example, the string "88888" is encoded +as (5, 8), indicating a run of 5 '8' numbers. In VP3 (and MPEG/JPEG), +RLE is used to record the number of zero-value coefficients that occur +before a non-zero coefficient. For example: + + 0 0 0 0 5 0 2 0 0 0 9 + +is encoded as: + + (4, 5), (1, 2), (3, 9) + +This indicates that a run of 4 zeroes is followed by a coefficient of 5; +then a run of 1 zero is followed by 2; then a run of 3 zeroes is +followed by 9. + +* Zigzag Ordering: After transforming and quantizing a block of samples, +the samples are not in an optimal order for run length encoding. Zigzag +ordering rearranges the samples to put more zeros between non-zero +samples. + +* Differential (or Delta) Pulse Code Modulation (DPCM): 1 + 1 = 2. Got +that? Seriously, that is what DPCM means. Rather than encoding absolute +values, encode the differences between successive values. For example: + + 82 84 81 80 86 88 85 + +Can be delta-encoded as: + + 82 +2 -3 -1 +6 +2 -3 + +Most of the numbers turn into smaller numbers which require less +information to encode. + +* Motion Compensation: Simply, this coding method specifies that a block +from a certain position in the previous frame is to be copied into a new +position in the current frame. This technique is often combined with DCT +and DPCM coding, as well as fractional pixel motion. + +* Entropy Coding (a.k.a. Huffman Coding): This is the process of coding +frequently occurring symbols with fewer bits than symbols that are not +likely to occur as frequently. + +* Variable Length Run Length Booleans: An initial Boolean bit is +extracted from the bitstream. A variable length code (VLC) is extracted +from the bitstream and converted to a count. This count indicates that +the next (count) elements are to be set to the Boolean value. +Afterwards, the Boolean value is toggled, the next VLC is extracted and +converted to a count, and the process continues until all elements are +set to either 0 or 1. + +* YUV Colorspace: Like many modern video codecs, VP3 operates on a YUV +colorspace rather than a RGB colorspace. Specifically, VP3 uses YUV +4:2:0, alias YUV420P, YV12. Note: Throughout the course of this +document, the U and V planes (a.k.a., Cb and Cr planes) will be +collectively referred to as C planes (color or chrominance planes). + +* Frame Types: VP3 has intra-coded frames, a.k.a. intraframes, I-frames, +or keyframes. VP3 happens to call these golden frames. VP3 has +interframes, a.k.a. predicted frames or P-frames. These frames can use +information from either the previous interframe or from the previous +golden frame. + + +VP3 Overview +------------ +The first thing to understand about the VP3 coding method is that it +encodes all 3 planes upside down. That is, the data is encoded from +bottom-to-top rather than top-to-bottom as is done with many video +codecs. + +VP3 codes a video frame by first breaking each of the 3 planes (Y, U, +and V) into a series of 8x8 blocks called fragments. VP3 also has a +notion of superblocks. Superblocks encapsulate 16 fragments arranged in +a 4x4 matrix. Each plane has its own set of superblocks. Further, VP3 +also uses the notion of macroblocks which is the same as that found in +JPEG/MPEG. One macroblock encompasses 4 blocks from the Y plane arranged +in a 2x2 matrix, 1 block from the U plane, and 1 block from the V plane. +While a fragment or a superblock applies to 1 and only 1 plane, a +macroblock extends over all 3 planes. + +VP3 compresses golden frames by transforming each fragment with a +discrete cosine transform. Each transformed sample is then quantized and +the DC coefficient is reduced via DPCM using a combination of DC +coefficients from surrounding fragments as predictors. Then, each +fragment's DC coefficient is entropy-coded in the output bitstream, +followed by each fragment's first AC coefficient, then each second AC +coefficient, and so on. + +An interframe, naturally, is more complicated. While there is only one +coding mode available for a golden frame (intra coding), there are 8 +coding modes that the VP3 coder can choose from for interframe +macroblocks. Intra coding as seen in the keyframe is still available. +The rest of the modes involve encoding a fragment diff, either from the +previous frame or the golden frame, from the same coordinate or from the +same coordinate plus a motion vector. All of the macroblock coding modes +and motion vectors are encoded in an interframe bitstream. + + +VP3 Chunk Format +---------------- +The high-level format of a compressed VP3 frame is laid out as: + + * chunk header + * block coding information + * macroblock coding mode information + * motion vectors + * DC coefficients + * 1st AC coefficients + * 2nd AC coefficients + * ... + * 63rd AC coefficients + + +Decoding The Frame Header +------------------------- +The chunk header always contains at least 1 byte which has the following +format: + + bit 7: 0 = golden frame, 1 = interframe + bit 6: unused + bits 5-0: Quality index (0..63) + +Further, if the frame is a golden frame, there are 2 more bytes in the +header: + + byte 0: version byte 0 + byte 1: + bits 7-3: VP3 version number (stored) + bit 2: key frame coding method (0 = DCT key frame, only type + supported) + bits 1-0: unused, spare bits + +All frame headers are encoded with a quality index. This 6-bit value is +used to index into 2 dequantizer scaling tables, 1 for DC values and 1 +for AC values. Each of the 3 dequantization tables is modified per these +scaling values. + + +Initializing The Quantization Matrices +-------------------------------------- +VP3 has three static matrices for quantizing and dequantizing fragments. +One matrix is for quantizing golden frame Y fragments, one matrix is for +quantizing golden frame C fragments, and one matrix is for quantizing both +golden frame and interframe Y or C fragments. While these matrices are +static, they are adjusted according to quality index coded in the header. + +The quality index is an index into 2 64-element tables: +dc_scale_factor[] and ac_scale_factor[]. Each quantization factor from +each of the three quantization matrices is adjusted by the appropriate +scale factor according to this formula: + + base quantizer * scale factor + quantizer = ----------------------------- + 100 + + where scale factor = + dc_scale_factor[quality_index] for DC dequantizer + ac_scale_factor[quality_index] for AC dequantizer + +The quantization matrices need to be recalculated at the beginning of a +frame decode if the current frame's quality index is different from the +previous frame's quality index. + +See Appendix A for the complete VP3 quantization matrices and scale factor +tables. + +As an example, this is the base quantization matrix for golden frame Y +fragments: + + 16 11 10 16 24 40 51 61 + 12 12 14 19 26 58 60 55 + 14 13 16 24 40 57 69 56 + 14 17 22 29 51 87 80 62 + 18 22 37 58 68 109 103 77 + 24 35 55 64 81 104 113 92 + 49 64 78 87 103 121 120 101 + 72 92 95 98 112 100 103 99 + +If a particular coded frame specifies a quality index of 54. Element 54 +of the dc_scale_factor table is 20, thus: + + 16 * 20 + DC coefficient quantizer = ------- = 3 + 100 + +Element 54 of the ac_scale_factor table is 24. The AC coefficient +quantizers are each scaled using this factor, e.g.: + + 11 * 24 + ------- = 2 + 100 + + 100 * 24 + -------- = 24 + 100 + +[not complete; still need to explain how these quantizers are saturated +and scaled with respect to the DCT process] + + +Hilbert Coding Pattern +---------------------- +VP3 uses a Hilbert pattern to code fragments within a superblock. A +Hilbert pattern is a recursive pattern that can grow quite complicated. +The coding pattern that VP3 uses is restricted to this pattern subset, +where each fragment in a superblock is represented by a 'X': + + X -> X X -> X + | ^ + v | + X <- X X <- X + | ^ + v | + X X -> X X + | ^ | ^ + v | v | + X -> X X -> X + +As an example of this pattern, consider a plane that is 256 samples wide +and 64 samples high. Each fragment row will be 32 fragments wide. The +first superblock in the plane will be comprised of these 16 fragments: + + 0 1 2 3 ... 31 + 32 33 34 35 ... 63 + 64 65 66 67 ... 95 + 96 97 98 99 ... 127 + +The order in which these 16 fragments are coded is: + + 0 | 0 1 14 15 + 32 | 3 2 13 12 + 64 | 4 7 8 11 + 96 | 5 6 9 10 + +All of the image coding information, including the block coding status +and modes, the motion vectors, and the DCT coefficients, are all coded +and decoded using this pattern. Thus, it is rather critical to have the +pattern and all of its corner cases handled correctly. In the above +example, if the bottom row and left column were not present due to the +superblock being in a corner, the pattern proceeds as if the missing +fragments were present, but the missing fragments are omitted in the +final coding list. The coding order would be: + + 0, 1, 2, 3, 4, 7, 8, 13, 14 + + +Unpacking The Block Coding Information +-------------------------------------- +After unpacking the frame header, the decoder unpacks the block coding +information. The only information determined in this phase is whether a +particular superblock and its fragments are coded in the current frame +or unchanged from the previous frame. The actual coding method is +determined in the next phase. + +If the frame is a golden frame then every superblock, macroblock, and +fragment is marked as coded. + +If the frame is an interframe, then the block coding information must be +decoded. This is the phase where a decoder will build a list of coded +fragments for which coding mode, motion vector, and DCT coefficient data +must be decoded. + +First, a list of partially-coded superblocks is unpacked from the +stream. This list is coded as a series of variable-length run length +codes (VLRLC). First, the code is initialized by reading the next bit in +the stream. Then, while there are still superblocks remaining in the +list, fetch a VLC from the stream according to this table: + + Codeword Run Length + 0 1 + 10x 2-3 + 110x 4-5 + 1110xx 6-9 + 11110xxx 10-17 + 111110xxxx 18-33 + 111111xxxxxxxxxxxx 34-4129 + +For example, a VLC of 1101 represents a run length of 5. If the VLRLC +was initialized to 1, then the next 5 superblocks would be set to 1, +indicating that they are partially coded in the current frame. Then the +bit value is toggled to 0, another VLC is fetched from the stream and +the process continues until each superblock has been marked either +partially coded (1) or not (0). + +If any of the superblocks were marked as not partially coded in the +previous step, then a list of fully-coded superblocks is unpacked next +using the same VLRLC as the list of partially-coded superblocks. +Initialize the VLRLC with the next bit in the stream. For each +superblock that was not marked as partially coded, mark it with either a +0 or 1 according to the current VLRLC. By the end of this step, each +superblock will be marked as either not coded, partially coded, or fully +coded. + +Let's work through an example with an image frame that is 256x64 pixels. +This means that the Y plane contains 4x2 superblocks and each of the C +planes contains 2 superblocks each. The superblocks are numbered as +follows: + + Y: 0 1 2 3 U: 8 9 + 4 5 6 7 V: 10 11 + +This is the state of the bitstream: + + 1100011001101 + +Which is interpreted as: + + initial 2 1's 1 0 4 1's 5 0's + 1 100 0 1100 1101 + +Superblocks 0-1 and 3-6 are marked as partially coded. Since there were +blocks that were not marked, proceed to unpack the list of fully-coded +superblocks. This is the state of the bitstream: + + 1101101 + +Which is interpreted as: + + initial 3 1's 3 0's + 1 101 100 + +Superblocks 2, 7, and 8 are marked as fully coded while superblocks 9, +10, and 11 are marked as not coded. + +If any of the superblocks were marked as partially coded, the next data +in the bitstream will define which fragments inside each partially-coded +superblock are coded. This is the first place where the Hilbert pattern +comes into play. + +For each partially-coded superblock, iterate through each fragment +according to the Hilbert pattern. Use the VLRLC method, only with a +different table, to determine which fragments are coded. The VLRLC table +for fragment coding runs is: + + Codeword Run Length + 0x 1-2 + 10x 3-4 + 110x 5-6 + 1110xx 7-10 + 11110xx 11-14 + 11111xxxx 15-30 + +Continuing with the contrived example, superblocks 0 and 1 are both +partially coded. This is the state of the bitstream: + + 0011001111010001111010...(not complete) + +Which is interpreted as: + initial 2 0's 3 1's 13 0's 1 1 13 0's + 0 01 100 1111010 00 1111010 ... + +This indicates that fragments 2-4 in superblock 0 are coded, while +fragments 0, 1, and 5-15 are not. Note that the run of 12 0's cascades +over into the next fragment, indicating that fragment 0 of superblock 1 +is not coded. Fragment 1 of superblock 1 is coded, while the rest of the +superblock's fragments are not coded. The example ends there (a real +bitstream should have enough data to describe all of the partially-coded +superblocks). Superblock 2 is fully coded which means all 16 fragments +are coded. Thus, superblocks 0-2 have the following coded fragments: + + 0 | x x x x x x x x 0 1 14 15 + 32 | 3 2 x x x 2 x x 3 2 13 12 + 64 | 4 x x x x x x x 4 7 8 11 + 96 | x x x x x x x x 5 6 9 10 + +This is a good place to generate the list of coded fragment numbers for +this frame. In this case, the list will begin as: + + 33 32 64 37 8 9 41 40 72 104 105 73 ... + +and so on through the remaining 8 fragments of superblock 2 and onto the +fragments for the remaining superblocks that are either fully or +partially coded. + + +Unpacking The Macroblock Coding Mode Information +------------------------------------------------ +After unpacking the block coding information, the decoder unpacks the +macroblock coding mode information. This process is simple when +decoding a golden frame-- since the only possible decoding mode is INTRA, +no macroblock coding mode information is transmitted. However, in an +interframe, each coded macroblock is encoded with one of 8 methods: + +0, INTER_NO_MV: + current fragment = + (fragment from previous frame @ same coordinates) + + (DCT-encoded residual) + +1, INTRA: + current fragment = DCT-encoded block, just like in a golden frame + +2, INTER_PLUS_MV: + current fragment = + (fragment from previous frame @ (same coords + motion vector)) + + (DCT-encoded residual) + +3, INTER_LAST_MV: + same as INTER_PLUS_MV but using the last motion vector decoded from + the bitstream + +4, INTER_PRIOR_LAST; + same as INTER_PLUS_MV but using the second-to-last motion vector + decoded from the bitstream + +5, USING_GOLDEN: + same as INTER_NO_MV but referencing the golden frame instead of + previous interframe + +6, GOLDEN_MV: + same as INTER_PLUS_MV but referencing the golden frame instead of + previous interframe + +7, INTER_FOURMV: + same as INTER_PLUS_MV except that each of the 4 Y fragments gets its + own motion vector, and the U and V fragments share the same motion + vector which is the average of the 4 Y fragment vectors + +The MB coding mode information is encoded using one of 8 alphabets. The +first 3 bits of the MB coding mode stream indicate which of the 8 +alphabets, 0..7, to use to decode the MB coding information in this frame. +The reason for the different alphabets is to minimize the number of bits +needed to encode this section of information. Each alphabet arranges the +coding modes in a different order, indexing the 8 modes into 8 index +slots. Index 0 is encoded with 1 bit (0), index 1 is encoded with 2 bits +(10), index 2 is encoded with 3 bits (110), and so on up to indices 6 and +7 which are encoded with 6 bits each (1111110 and 1111111, respectively): + + index encoding + ----- -------- + 0 0 + 1 10 + 2 110 + 3 1110 + 4 11110 + 5 111110 + 6 1111110 + 7 1111111 + +For example, the coding modes are arranged in alphabet 1 as follows: + + index coding mode + ----- ----------- + 0 MODE_INTER_LAST_MV + 1 MODE_INTER_PRIOR_LAST + 2 MODE_INTER_PLUS_MV + 3 MODE_INTER_NO_MV + 4 MODE_INTRA + 5 MODE_USING_GOLDEN, + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +This alphabet arrangement is designed for frames in which motion vectors +based off of the previous interframe dominate. + +When unpacking MB coding mode information for a frame, the decoder first +reads 3 bits from the stream to determine the alphabet. In this example, +the 3 bits would be 001 to indicate alphabet 1. Consider this contrived +bitstream following the alphabet number: + + 1010000011000011111110... + +The bits are read as follows: + + 10 10 0 0 0 0 110 0 0 0 1111111 0 + index: 1 1 0 0 0 0 2 0 0 0 7 0 + +This arrangement of indices translates to this series of coding modes: + + index coding mode + ----- ----------- + 1 MODE_INTER_PRIOR_LAST + 1 MODE_INTER_PRIOR_LAST + 0 MODE_INTER_LAST_MV + 0 MODE_INTER_LAST_MV + 0 MODE_INTER_LAST_MV + 0 MODE_INTER_LAST_MV + 2 MODE_INTER_PLUS_MV + 0 MODE_INTER_LAST_MV + 0 MODE_INTER_LAST_MV + 0 MODE_INTER_LAST_MV + 7 MODE_INTER_FOURMV + 0 MODE_INTER_LAST_MV + +There are 6 pre-defined alphabets. Consult Appendix B for the complete +alphabets. What happens if none of the 6 pre-defined alphabets fit? The +VP3 encoder can choose to use alphabet 0 which indicates a custom +alphabet. The 3-bit coding mode numbers for each index, 0..7, are stored +after the alphabet number in the bitstream. For example, the sequence: + + 000 111 110 101 100 011 010 001 000 + +would indicate coding alphabet 0 (custom alphabet), index 0 corresponds to +coding mode 7 (INTER_FOURMV), index 1 corresponds to coding mode 6 +(GOLDEN_MV), and so on down to index 7 which would correspond to coding +mode 0 (INTER_NO_MV). + +There is one more possible alphabet: Alphabet 7. This alphabet is +reserved for when there is such a mixture of coding modes used in a frame +that using any variable-length coding mode would result in more bits than +a fixed-length representation. When alphabet 7 is specified, the decoder +reads 3 bits at a time from the bitstream, and uses those directly as the +macroblock coding modes. + +To recap, this is the general algorithm for decoding macroblock coding +mode information: + + if (golden frame) + all frames are intracoded, there is no MB coding mode information + else + read 3 bits from bitstream to determine alphabet + if alphabet = 0 + this is a custom alphabet, populate index table with 8 3-bit coding + modes read from bitstream + foreach coded macroblock, unpack a coding mode: + if alphabet = 7 + read 3 bits from the bitstream as the coding mode for the + macroblock + else + read a VLC from the bitstream + use the decoded VLC value to index into the coding mode alphabet + selected for this frame and assign the indexed coding mode to + this macroblock + + +Unpacking The Macroblock Motion Vectors +--------------------------------------- +After unpacking the macroblock coding mode information, the decoder +unpacks the macroblock motion vectors. This phase essentially assigns a +motion vector to each of the 6 constituent fragments of any coded +macroblock that requires motion vectors. + +If the frame is a golden frame then there is no motion compensation and +no motion vectors are encoded in the bitstream. + +If the frame is an interframe, the next bit is read from the bitstream +to determine the vector entropy coding method used. If the coding method +is zero then all of the vectors will be unpacked using a VLC method. If +the coding method is 1 then all of the vectors will be unpacked using a +fixed length method. + +The VLC unpacking method reads 3 bits from the bitstream. These 3 bits +comprise a number ranging from 0..7 which indicate the next action: + +0, MV component = 0 +1, MV component = 1 +2, MV component = -1 +3, MV component = 2, read next bit for sign +4, MV component = 3, read next bit for sign +5, MV component = 4 + (read next 2 bits), read next bit for sign + range: (4..7, -4..-7) +6, MV component = 8 + (read next 3 bits), read next bit for sign + range: (8..15, -8..-15) +7, MV component = 16 + (read next 4 bits), read next bit for sign + range: (16..31, -16..-31) + +The fixed length vector unpacking method simply reads the next 5 bits +from the bitstream, reads the next bit for sign, and calls the whole +thing a motion vector component. This gives a range of (-31..31), which +is the same range as the VLC method. + +For example, consider the following contrived motion vector bitstream: + + 000001011011111000... + +The stream is read as: + + 0 (000 010) (110 111 1 100 0) + +The first bit indicates the entropy method which, in this example, is +variable length as opposed to fixed length. The next 3 bits are 0 which +indicate a X MV component of 0. The next 3 bits are 2 which indicate a Y +MV component of -1. The first motion vector encoded in this stream is +(0, -1). The next 3 bits are 6 which indicate 8 + next 3 bits (7) with +another bit indicating sign (1 in this case, which is negative). Thus, +the X MV component is -15. The next 3 bits are 4 which indicate a Y MV +component of 3 with one more bit for the sign (0 is positive). So the +second motion vector encoded in this stream is (-15, 3). + +As an example of the fixed-length entropy method, consider the following +contrived bitstream: + + 1010101101010... + +The stream is read as: + + 1 01010 1 10101 0 + +The first bit indicates the fixed length entropy method. The first 5 bits +are 10 followed by a negative sign bit. The next 5 bits are 21 followed by +a positive sign bit. The first motion vector in this stream is (-10, 21). + +During this phase of the decoding process, it is traditional to assign all +motion vectors for all coded macroblocks that require them, whether they +are unpacked from the motion vector bitstream or copied from previous +coded macroblocks. It is necessary to track the motion vectors for both +the previous macroblock as well as the next-to-last (prior) macroblock. +The general algorithm for this phase is as follows: + + foreach coded macroblock + last MV = 0 + prior last MV = 0 + if coding mode = MODE_INTER_PLUS_MV or MODE_GOLDEN_MV + read current MV pair from the bitstream and set all fragment motion + vectors to that pair + prior last MV = last MV + last MV = current MV + + if coding mode = MODE_INTER_FOURMV + read MV for first Y fragment in macroblock + read MV for second Y fragment in macroblock + read MV for third Y fragment in macroblock + read MV for fourth Y fragment in macroblock + set U & V fragment motion vectors to average of 4 Y vectors, + calculated as follows: + if sum of all 4 X motion components is positive, the X + motion component for the U & V fragments is (sum + 2) / 4, + otherwise, it is (sum - 2) / 4; repeat the same process for the + Y components + prior last MV = last MV + last MV = MV for fourth Y fragment from this macroblock + + if coding mode = MODE_INTER_LAST_MV + motion vectors for this macroblock are the same as last MV; note + that in this case, the last MV remains the last MV and the prior + last MV remains the prior last MV + + if coding mode = MODE_INTER_PRIOR_LAST + motion vectors for this macroblock are the same as prior last MV + prior last MV = last MV + last MV = current MV (effectively, swap last and prior last vectors) + + +Unpacking The DCT Coefficients +------------------------------ +After unpacking the macroblock motion vectors, the decoder unpacks the +fragment DCT coefficient data. Each coded fragment has 64 DCT +coefficients. Some of the coefficients will be non-zero. Many of the +coefficients will, or should be 0 as this is where the coding method +derives much of its compression. + +During this phase, the decoder will be unpacking DCT coefficients, zero +runs, and end-of-block (EOB) codes. The decoder unpacks the the DC +coefficients for all fragments, then all of the first AC coefficients, +and so on until all of the 64 DCT coefficients are unpacked from the +bitstream. + +To obtain the DCT coefficients, the decoder unpacks a series of VLCs +from the bitstream which turn into a series of tokens ranging from +0..31. Each of these tokens specifies which action to take next. VP3 +defines 80 different 32-element histograms for VLC decoding: + + 16 histograms for DC token decoding + 16 histograms for group 1 AC token decoding + 16 histograms for group 2 AC token decoding + 16 histograms for group 3 AC token decoding + 16 histograms for group 4 AC token decoding + +The decoder fetches 4 bits from the bitstream that will be used to +select a DC histogram and 4 bits that will be used to select 4 AC +histograms, one for each AC group. + +The meaning of each of the 32 possible tokens follows. 'EB' stands for +extra bits read from bitstream directly after the VLC token: + +0, DCT_EOB_TOKEN +set the current block to EOB, meaning that the block is marked as being +fully unpacked + +1, DCT_EOB_PAIR_TOKEN +set the next 2 blocks to EOB + +2. DCT_EOB_TRIPLE_TOKEN +set the next 3 blocks to EOB + +3, DCT_REPEAT_RUN_TOKEN +set the next (2 EBs + 4) blocks to EOB + +4, DCT_REPEAT_RUN2_TOKEN +set the next (3 EBs + 8) blocks to EOB + +5, DCT_REPEAT_RUN3_TOKEN +set the next (4 EBs + 16) blocks to EOB + +6, DCT_REPEAT_RUN4_TOKEN +set the next (12 EBs) blocks to EOB + +7, DCT_SHORT_ZRL_TOKEN +skip (3 EBs + 1) positions in the output matrix + +8, DCT_ZRL_TOKEN +skip (6 EBs + 1) positions in the output matrix + +9, ONE_TOKEN +output 1 as coefficient + +10, MINUS_ONE_TOKEN +output -1 as coefficient + +11, TWO_TOKEN +output 2 as coefficient + +12, MINUS_TWO_TOKEN +output -2 as coefficient + +13, 14, 15, 16, LOW_VAL_TOKENS +next EB determines coefficient sign; coeff = DCT_VAL_CAT2_MIN (3) + +(token - 13) (this gives a range of +/- 3..6) + +17, DCT_VAL_CATEGORY3 +next EB determines coefficient sign; coeff = DCT_VAL_CAT3_MIN (7) + next +EB (this gives a range of +/- 7..8) + +18, DCT_VAL_CATEGORY4 +next EB determines coefficient sign; coeff = DCT_VAL_CAT4_MIN (9) + next +2 EBs (this gives a range of +/- 9..12) + +19, DCT_VAL_CATEGORY5 +next EB determines coefficient sign; coeff = DCT_VAL_CAT5_MIN (13) + +next 3 EBs (this gives a range of +/- 13..20) + +20, DCT_VAL_CATEGORY6 +next EB determines coefficient sign; coeff = DCT_VAL_CAT6_MIN (21) + +next 4 EBs (this gives a range of +/- 21..36) + +21, DCT_VAL_CATEGORY7 +next EB determines coefficient sign; coeff = DCT_VAL_CAT7_MIN (37) + +next 5 EBs (this gives a range of +/- 37..68) + +22, DCT_VAL_CATEGORY8 +next EB determines coefficient sign; coeff = DCT_VAL_CAT8_MIN (69) + +next 9 EBs (this gives a range of +/- 69..580) + +23, 24, 25, 26, 27, DCT_RUN_CATEGORY1 +coefficient of +/- 1 preceded by a number of 0s; next EB determines sign +of coefficient; skip (token - 22) 0s in the output matrix before +placing the final coefficient (this gives a range of 1..5 0s) + +28, DCT_RUN_CATEGORY1B +coefficient of +/- 1 preceded by a number of 0s; next EB determines sign +of coefficient; skip (next 2 EBs + 6) 0s in the output matrix before +placing the final coefficient (this gives a range of 6..9 0s) + +29, DCT_RUN_CATEGORY1C +coefficient of +/- 1 preceded by a number of 0s; next EB determines sign +of coefficient; skip (next 3 EBs + 10) 0s in the output matrix before +placing the final coefficient (this gives a range of 10..17 0s) + +30, DCT_RUN_CATEGORY2 +coefficient of +/- 2..3 preceded by a single zero; next EB determines +sign of coefficient; coefficient = (next EB + 2) + +31, DCT_RUN_CATEGORY2B (not specifically named in VP3 source) +coefficient of +/- 2..3 preceded by 2 or 3 0s; next EB determines +sign of coefficient; coefficient = (next EB + 2); skip (next EB + 2) 0s +before placing coefficient in output matrix + +Note: EOB runs can, and often do, cross threshold stages and plane +boundaries. For example, a decoder may have decoded all of the AC #2 +coefficients for all fragments and still have an EOB run of 2. That +means that during the AC #3 decode process, the first 2 coded fragments +that are not already EOB will be set to EOB. + +Let's work through a highly contrived example to illustrate the +coefficient decoding process. + + + +[not finished] + + + + +When the decoder is finished unpacking the DCT coefficients, the entire +encoded VP3 frame bitstream should be consumed. + + +Reversing The DC Prediction +--------------------------- +Now that all of the DCT coefficient data has been unpacked, the DC +coefficients need to be fully reconstructed before the IDCT can be +performed. + +VP3 uses a somewhat involved process for DC prediction which uses up to +four DC coefficients from surrounding fragments. For each fragment to be +transformed with the IDCT, the DC coefficient is predicted from weighted +sum of the DC coefficients in the left (l), up-left (ul), up (u), and +up-right (ur) fragments, if they are coded (not unchanged from the +previous frame) in a compatible frame (current, previous, or golden). + +In a golden frame, the prediction is quite straightforward since all +fragments will be coded. A fragment's DC prediction will fall into 1 of +5 groups: + + abbbbbbbbb + cdddddddde + cdddddddde + cdddddddde + cdddddddde + +* Group a is the top left corner fragment. There is nothing to predict +from. This DC coefficient has a lot of energy and requires many bits to +code. + +* Group b is the remainder of the top row of fragments. These fragments +can only predict from the left fragment. + +* Group c is the left column of fragments, not including the top left +fragment. These fragments have the top and top-right fragments from +which to predict. + +* Group d is the main body of fragments. These fragments have access to +all 4 predictors. + +* Group e is the right column of fragments, not including the top right +fragment. These fragments can predict from the left, up-left and up +fragments. + +The process of reversing prediction for interframes grows more complex. +First, the decoder must evaluate which candidate fragments (l, ul, u, or +ur) are available for as predictors. Then, it can only use fragments +that are coded within the same frame (current, previous, or golden). +Further, there are auxiliary predictors for each frame type that are +initialized to 0 at the start of each video frame decode operation. The +decoder falls back on these auxiliary predictors when it can not find +any valid candidate predictors for the current fragment. + +To work through some examples, consider the following notation, e.g.: + + ul-C = up-left fragment, coded in the current frame + u-P = up fragment, coded as a motion residual from the previous frame + ur-C = up-right fragment, coded in the current frame + l-G = left fragment, coded as a motion residual from the golden frame + x-P = current fragment where DC prediction is being performed, coded + as a motion residual from the previous frame + +This is a simple case: + + ul-C u-C ur-C + l-C x-C + +The current fragment predicts from all four of the candidate fragments +since they are coded in the same frame. + + ul-P u-C ur-C + l-P x-P + +The current fragment predicts from the left and up-left fragments. + + ul-C u-P ur-G + l-P x-G + +The current fragment predicts from the up-right fragment. + + ul-C u-C ur-C + l-C x-G + +The current fragment does not predict from any of the candidate +fragments since the current fragment is a motion residual from the +golden frame. Rather, add the auxiliary golden frame predictor to the +current fragment's DC coefficient. Save the new DC coefficient as the +new golden frame auxiliary DC predictor. + +If the decoder only finds one valid candidate predictor, then it is used +by itself. When the decoder finds multiple valid candidate fragments +from which to predict DC, it applies a weighting function to the +surrounding fragments' DC coefficients. The following table presents all +16 possible combinations of available/not available predictors and what +to do in each case: + + ul u ur l + -- -- -- -- + 0 0 0 0 no predictors available: + use the last predictor saved for the frame type + (either intra, inter, or golden) + + 0 0 0 1 left predictor available: + pred = l.dc + + 0 0 1 0 up-right predictor available: + pred = ur.dc + + 0 0 1 1 up-right, left predictors available: + pred = (53 * ur.dc) + (75 * l.dc) + -------------------------- + 128 + + 0 1 0 0 up predictor available: + pred = u.dc + + 0 1 0 1 up, left predictors available: + pred = (u.dc + l.dc) + ------------- + 2 + + 0 1 1 0 up, up-right predictors available: + discard up-right predictor + pred = u.dc + + 0 1 1 1 up, up-right, left predictors available: + discard up predictor + pred = (53 * ur.dc) + (75 * l.dc) + -------------------------- + 128 + + 1 0 0 0 up-left predictor available: + pred = ul.dc + + 1 0 0 1 up-left, left predictors available: + discard up-left predictor + pred = l.dc + + 1 0 1 0 up-left, up-right predictors available: + pred = (ul.dc + ur.dc) + --------------- + 2 + + 1 0 1 1 up-left, up-right, left predictors available: + discard up-left predictor + pred = (53 * ur.dc) + (75 * l.dc) + -------------------------- + 128 + + 1 1 0 0 up-left, up predictors available: + discard up-left + pred = u.dc + + 1 1 0 1 up-left, up, left predictors available: + pred = (-26 * ul.dc + 29 * u.dc + 29 * l.dc) + ------------------------------------- + 32 + + 1 1 1 0 up-left, up, up-right predictors available: + pred = (3 * ul.dc + 10 * u.dc + 3 * ur.dc) + ----------------------------------- + 16 + + 1 1 1 1 all 4 predictors available: + discard up-right predictor + pred = (-26 * ul.dc + 29 * u.dc + 29 * l.dc) + ------------------------------------- + 32 + +Note that this final prediction case ([ul u l]) risks outranging. The +difference of the predicted DC is checked against u.dc, l.dc, and ul.dc, +in that order, and if the difference is greater than 128 in any case, +the predictor is assigned as that DC coefficient. In pseudocode: + + if (ABSOLUTE_VALUE(pred - u.dc) > 128) + pref = u.dc + else if (ABSOLUTE_VALUE(pred - l.dc) > 128) + pref = l.dc + else if (ABSOLUTE_VALUE(pred - ul.dc) > 128) + pref = ul.dc + +The predicted value is, at long last, added to the fragment's decoded DC +coefficient. Finally, the new DC coefficient is saved as the frame +type's auxiliary predictor. For example, if this fragment is coded as a +motion residual from the previous frame, save the fragment's DC +coefficient as the previous frame auxiliary predictor. + + +[still need to mention precise rounding considerations, a.k.a, the +HIGHTBITDUPPED() macro] + + + +Reconstructing The Frame +------------------------ +rough outline: + - foreach fragment: + - if motion vector + - copy motion fragment from appropriate frame into current frame + (don't forget to account for unrestricted motion vectors) + - dequantize fragment coefficients + - run coefficients through inverse DCT + - if INTRA coded fragment + - output transformed coefficients + - else + - apply transformed residual to motion fragment + +[not finished] + + +Theora Specification +-------------------- +The Theora project leverages the VP3 codec into a new video coding +system. The algorithm and bitstream format are the same as VP3 with a +few minor differences: + +1) The frame orientation is reversed-- VP3 is coded from bottom to top +while Theora video is coded from top to bottom. +[nope-- only true in the first few alpha releases; final Theora spec will +be upside-down, the same as VP3] + +2) Variable histograms-- VP3 uses a hardcoded set of histograms for DCT +coefficient coding (described in section "Unpacking The DCT +Coefficients"). Theora packs the histogram information in the header of +the transport format (which is meant to be Ogg, but can probably be +coerced into a variety of other multimedia container formats). + +3) Variable quantization-- As with the histograms, Theora codes the +quantization tables and quality thresholds (described in section +"Initializing The Quantization Matrices") into the header. + +4) [special VLRLC case for encoding unusually large runs of blocks; +necessary for HD resolutions] + +[still need coding format of histogram and quantizer information] + + +Appendix A: VP31 Quantization Matrices And Scale Factors +-------------------------------------------------------- +The following quantization matrices and scale factor tables are hardcoded +into the VP31 coding standard. These tables can vary according to the +setup information transported along with a Theora file. + +Base quantization matrix for golden frame Y fragments (note that this +is the same as JPEG): + + 16 11 10 16 24 40 51 61 + 12 12 14 19 26 58 60 55 + 14 13 16 24 40 57 69 56 + 14 17 22 29 51 87 80 62 + 18 22 37 58 68 109 103 77 + 24 35 55 64 81 104 113 92 + 49 64 78 87 103 121 120 101 + 72 92 95 98 112 100 103 99 + + +Base quantization matrix for golden frame C fragments (note that this +is the same as JPEG): + + 17 18 24 47 99 99 99 99 + 18 21 26 66 99 99 99 99 + 24 26 56 99 99 99 99 99 + 47 66 99 99 99 99 99 99 + 99 99 99 99 99 99 99 99 + 99 99 99 99 99 99 99 99 + 99 99 99 99 99 99 99 99 + 99 99 99 99 99 99 99 99 + + +Base quantization matrix for interframe Y and C fragments: + + 16 16 16 20 24 28 32 40 + 16 16 20 24 28 32 40 48 + 16 20 24 28 32 40 48 64 + 20 24 28 32 40 48 64 64 + 24 28 32 40 48 64 64 64 + 28 32 40 48 64 64 64 96 + 32 40 48 64 64 64 96 128 + 40 48 64 64 64 96 128 128 + + +DC coefficient scale factor table: + + 220 200 190 180 170 170 160 160 + 150 150 140 140 130 130 120 120 + 110 110 100 100 90 90 90 80 + 80 80 70 70 70 60 60 60 + 60 50 50 50 50 40 40 40 + 40 40 30 30 30 30 30 30 + 30 20 20 20 20 20 20 20 + 20 10 10 10 10 10 10 10 + + +AC coefficient scale factor table: + + 500 450 400 370 340 310 285 265 + 245 225 210 195 185 180 170 160 + 150 145 135 130 125 115 110 107 + 100 96 93 89 85 82 75 74 + 70 68 64 60 57 56 52 50 + 49 45 44 43 40 38 37 35 + 33 32 30 29 28 25 24 22 + 21 19 18 17 15 13 12 10 + + +Appendix B: Macroblock Coding Mode Alphabets +-------------------------------------------- +These are the 6 pre-defined alphabets used to decode macroblock coding +mode information: + +Alphabet 1: + index coding mode + ----- ----------- + 0 MODE_INTER_LAST_MV + 1 MODE_INTER_PRIOR_LAST + 2 MODE_INTER_PLUS_MV + 3 MODE_INTER_NO_MV + 4 MODE_INTRA + 5 MODE_USING_GOLDEN, + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +Alphabet 2: + index coding mode + ----- ----------- + 0 MODE_INTER_LAST_MV + 1 MODE_INTER_PRIOR_LAST + 2 MODE_INTER_NO_MV + 3 MODE_INTER_PLUS_MV + 4 MODE_INTRA + 5 MODE_USING_GOLDEN + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +Alphabet 3: + index coding mode + ----- ----------- + 0 MODE_INTER_LAST_MV + 1 MODE_INTER_PLUS_MV + 2 MODE_INTER_PRIOR_LAST + 3 MODE_INTER_NO_MV + 4 MODE_INTRA + 5 MODE_USING_GOLDEN + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +Alphabet 4: + index coding mode + ----- ----------- + 0 MODE_INTER_LAST_MV + 1 MODE_INTER_PLUS_MV + 2 MODE_INTER_NO_MV + 3 MODE_INTER_PRIOR_LAST + 4 MODE_INTRA + 5 MODE_USING_GOLDEN + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +Alphabet 5: + index coding mode + ----- ----------- + 0 MODE_INTER_NO_MV + 1 MODE_INTER_LAST_MV + 2 MODE_INTER_PRIOR_LAST + 3 MODE_INTER_PLUS_MV + 4 MODE_INTRA + 5 MODE_USING_GOLDEN + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + +Alphabet 6: + index coding mode + ----- ----------- + 0 MODE_INTER_NO_MV + 1 MODE_USING_GOLDEN + 2 MODE_INTER_LAST_MV + 3 MODE_INTER_PRIOR_LAST + 4 MODE_INTER_PLUS_MV + 5 MODE_INTRA + 6 MODE_GOLDEN_MV + 7 MODE_INTER_FOURMV + + +Appendix C: DCT Coefficient VLC Tables +-------------------------------------- +- VP31 tables are hardcoded +- Theora tables are transported with video stream + +[not finished] + + +Appendix D: The VP3 IDCT +------------------------ + +[not finished] + + +Acknowledgements +---------------- +Thanks to Michael Niedermayer (michaelni at gmx dot at) for peer review, +corrections, and recommendations for improvement. + +Dan Miller (dan at on2 dot com) for clarifications on pieces of the +format. + +Timothy B. Terriberry (tterribe at vt dot edu) for clarification about the +differences between VP3 and Theora, detailed explanation of motion +vector mechanics. + + +References +---------- +Tables necessary for decoding VP3: +http://mplayerhq.hu/cgi-bin/cvsweb.cgi/~checkout~/ffmpeg/libavcodec/vp3data.h?content-type=text/x-cvsweb-markup&cvsroot=FFMpeg + +Official VP3 site: +http://www.vp3.com/ + +Theora, based on VP3: +http://www.theora.org/ + +On2, creators of the VP3 format: +http://www.on2.com/ + + +ChangeLog +--------- +v0.5: December 8, 2004 +- reworked section "Reversing The DC Prediction" to include a tabular +representation of all 16 prediction modes + +v0.4: March 2, 2004 +- renamed and expanded section "Initializing The Quantization Matrices" +- outlined section "Reconstructing The Frame" +- moved Theora Differences Appendix to its own section entitled "Theora +Specification" +- added Appendix: Quantization Matrices And Scale Factors +- added Appendix: DCT Coefficient VLC Tables + +v0.3: February 29, 2004 +- expanded section "Unpacking The Macroblock Coding Mode Information" +- expanded section "Unpacking The Macroblock Motion Vectors" +- added Appendix: Macroblock Coding Mode Alphabets + +v0.2: October 9, 2003 +- expanded section "Reversing the DC Prediction" +- added Appendix: Theora Differences + +v0.1: June 17, 2003 +- initial release, nowhere near complete diff --git a/libs/libtheora-1.1/examples/Makefile.am b/libs/libtheora-1.1/examples/Makefile.am new file mode 100644 index 00000000..93ff45d3 --- /dev/null +++ b/libs/libtheora-1.1/examples/Makefile.am @@ -0,0 +1,41 @@ +## Process this file with automake to produce Makefile.in + +INCLUDES = -I$(top_srcdir)/include + +noinst_PROGRAMS = dump_video dump_psnr $(BUILDABLE_EXAMPLES) + +# possible contents of BUILDABLE_EXAMPLES: +EXTRA_PROGRAMS = player_example encoder_example png2theora + +AM_CFLAGS = $(OGG_CFLAGS) +LDADD = ../lib/libtheora.la $(OGG_LIBS) +LDADDDEC = ../lib/libtheoradec.la $(OGG_LIBS) +LDADDENC = ../lib/libtheoraenc.la ../lib/libtheoradec.la $(OGG_LIBS) + +dump_video_SOURCES = dump_video.c +EXTRA_dump_video_SOURCES = getopt.c getopt1.c getopt.h +dump_video_LDADD = $(GETOPT_OBJS) $(LDADDDEC) + +dump_psnr_SOURCES = dump_psnr.c +EXTRA_dump_psnr_SOURCES = getopt.c getopt1.c getopt.h +dump_psnr_LDADD = $(GETOPT_OBJS) $(LDADDDEC) -lm + +player_example_SOURCES = player_example.c +player_example_CFLAGS = $(SDL_CFLAGS) $(OGG_CFLAGS) $(VORBIS_CFLAGS) +player_example_LDADD = $(LDADDDEC) $(SDL_LIBS) $(VORBIS_LIBS) $(OSS_LIBS) + +encoder_example_SOURCES = encoder_example.c +EXTRA_encoder_example_SOURCES = getopt.c getopt1.c getopt.h +encoder_example_CFLAGS = $(OGG_CFLAGS) $(VORBIS_CFLAGS) +encoder_example_LDADD = $(GETOPT_OBJS) $(LDADDENC) $(VORBIS_LIBS) $(VORBISENC_LIBS) -lm + +png2theora_SOURCES = png2theora.c +png2theora_CFLAGS = $(OGG_CFLAGS) $(PNG_CFLAGS) +png2theora_LDADD = $(GETOPT_OBJS) $(LDADDENC) $(PNG_LIBS) -lm + +debug: + $(MAKE) all CFLAGS="@DEBUG@" + +profile: + $(MAKE) all CFLAGS="@PROFILE@" + diff --git a/libs/libtheora-1.1/examples/README_SPLAYER b/libs/libtheora-1.1/examples/README_SPLAYER new file mode 100644 index 00000000..1a32fb46 --- /dev/null +++ b/libs/libtheora-1.1/examples/README_SPLAYER @@ -0,0 +1,21 @@ +06/09/03 - by mau (mauricio at xiph.org) + +The splayer example is a experimental simple Theora player using SDL and +Portaudio for cross platform compatibility. To build the windows version +please use the Visual C++ project available at the +win32/experimental/splayer directory. + +By default this sample will not be built on Linux, unless Portaudio is +properly installed. Follow these steps to install Portaudio: + +1) Get portaudio tar package from www.portaudio.com +2) Uncompress it to a local directory +3) Run './configure' in the portaudio directory +4) Run 'make install' + +This will install Portaudio libraries in /usr/local/lib, and the Portaudio +include file at /usr/local/include. On linux you may need to manually +execute 'ldconfig' to rebuild the library cache. + +Switch to theora's directory, re-run theora's autogen.sh script to +re-generate the appropriate makefiles, and 'make install' to build. diff --git a/libs/libtheora-1.1/examples/dump_psnr.c b/libs/libtheora-1.1/examples/dump_psnr.c new file mode 100644 index 00000000..06f71721 --- /dev/null +++ b/libs/libtheora-1.1/examples/dump_psnr.c @@ -0,0 +1,1210 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: example dumpvid application; dumps Theora streams + last mod: $Id: dump_psnr.c 17974 2011-05-07 22:31:49Z giles $ + + ********************************************************************/ + +#if !defined(_GNU_SOURCE) +#define _GNU_SOURCE +#endif +#if !defined(_LARGEFILE_SOURCE) +#define _LARGEFILE_SOURCE +#endif +#if !defined(_LARGEFILE64_SOURCE) +#define _LARGEFILE64_SOURCE +#endif +#if !defined(_FILE_OFFSET_BITS) +#define _FILE_OFFSET_BITS 64 +#endif + +#include +#if !defined(_WIN32) +#include +#include +#else +#include "getopt.h" +#endif +#include +#include +#include +#include +#include +/*Yes, yes, we're going to hell.*/ +#if defined(_WIN32) +#include +#endif +#include +#include +#include +#include "theora/theoradec.h" + +const char *optstring = "fsy"; +struct option options [] = { + {"frame-type",no_argument,NULL,'f'}, + {"summary",no_argument,NULL,'s'}, + {"luma-only",no_argument,NULL,'y'}, + {NULL,0,NULL,0} +}; + +static int show_frame_type; +static int summary_only; +static int luma_only; + +typedef struct y4m_input y4m_input; + +/*The function used to perform chroma conversion.*/ +typedef void (*y4m_convert_func)(y4m_input *_y4m, + unsigned char *_dst,unsigned char *_aux); + +struct y4m_input{ + int frame_w; + int frame_h; + int pic_w; + int pic_h; + int pic_x; + int pic_y; + int fps_n; + int fps_d; + int par_n; + int par_d; + char interlace; + int src_c_dec_h; + int src_c_dec_v; + int dst_c_dec_h; + int dst_c_dec_v; + char chroma_type[16]; + /*The size of each converted frame buffer.*/ + size_t dst_buf_sz; + /*The amount to read directly into the converted frame buffer.*/ + size_t dst_buf_read_sz; + /*The size of the auxilliary buffer.*/ + size_t aux_buf_sz; + /*The amount to read into the auxilliary buffer.*/ + size_t aux_buf_read_sz; + y4m_convert_func convert; + unsigned char *dst_buf; + unsigned char *aux_buf; +}; + + +static int y4m_parse_tags(y4m_input *_y4m,char *_tags){ + int got_w; + int got_h; + int got_fps; + int got_interlace; + int got_par; + int got_chroma; + char *p; + char *q; + got_w=got_h=got_fps=got_interlace=got_par=got_chroma=0; + for(p=_tags;;p=q){ + /*Skip any leading spaces.*/ + while(*p==' ')p++; + /*If that's all we have, stop.*/ + if(p[0]=='\0')break; + /*Find the end of this tag.*/ + for(q=p+1;*q!='\0'&&*q!=' ';q++); + /*Process the tag.*/ + switch(p[0]){ + case 'W':{ + if(sscanf(p+1,"%d",&_y4m->pic_w)!=1)return -1; + got_w=1; + }break; + case 'H':{ + if(sscanf(p+1,"%d",&_y4m->pic_h)!=1)return -1; + got_h=1; + }break; + case 'F':{ + if(sscanf(p+1,"%d:%d",&_y4m->fps_n,&_y4m->fps_d)!=2){ + return -1; + } + got_fps=1; + }break; + case 'I':{ + _y4m->interlace=p[1]; + got_interlace=1; + }break; + case 'A':{ + if(sscanf(p+1,"%d:%d",&_y4m->par_n,&_y4m->par_d)!=2){ + return -1; + } + got_par=1; + }break; + case 'C':{ + if(q-p>16)return -1; + memcpy(_y4m->chroma_type,p+1,q-p-1); + _y4m->chroma_type[q-p-1]='\0'; + got_chroma=1; + }break; + /*Ignore unknown tags.*/ + } + } + if(!got_w||!got_h||!got_fps||!got_interlace||!got_par)return -1; + /*Chroma-type is not specified in older files, e.g., those generated by + mplayer.*/ + if(!got_chroma)strcpy(_y4m->chroma_type,"420"); + return 0; +} + +/*All anti-aliasing filters in the following conversion functions are based on + one of two window functions: + The 6-tap Lanczos window (for down-sampling and shifts): + sinc(\pi*t)*sinc(\pi*t/3), |t|<3 (sinc(t)==sin(t)/t) + 0, |t|>=3 + The 4-tap Mitchell window (for up-sampling): + 7|t|^3-12|t|^2+16/3, |t|<1 + -(7/3)|x|^3+12|x|^2-20|x|+32/3, |t|<2 + 0, |t|>=2 + The number of taps is intentionally kept small to reduce computational + overhead and limit ringing. + + The taps from these filters are scaled so that their sum is 1, and the result + is scaled by 128 and rounded to integers to create a filter whose + intermediate values fit inside 16 bits. + Coefficients are rounded in such a way as to ensure their sum is still 128, + which is usually equivalent to normal rounding.*/ + +#define OC_MINI(_a,_b) ((_a)>(_b)?(_b):(_a)) +#define OC_MAXI(_a,_b) ((_a)<(_b)?(_b):(_a)) +#define OC_CLAMPI(_a,_b,_c) (OC_MAXI(_a,OC_MINI(_b,_c))) + +/*420jpeg chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + 420mpeg2 chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + BR | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + BR | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + We use a resampling filter to shift the site locations one quarter pixel (at + the chroma plane's resolution) to the right. + The 4:2:2 modes look exactly the same, except there are twice as many chroma + lines, and they are vertically co-sited with the luma samples in both the + mpeg2 and jpeg cases (thus requiring no vertical resampling).*/ +static void y4m_convert_42xmpeg2_42xjpeg(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ + int c_w; + int c_h; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=_y4m->pic_w*_y4m->pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h; + c_h=(_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + } + for(;x>7,255); + } + for(;x>7,255); + } + _dst+=c_w; + _aux+=c_w; + } + } +} + +/*This format is only used for interlaced content, but is included for + completeness. + + 420jpeg chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + 420paldv chroma samples are sited like: + YR------Y-------YR------Y------- + | | | | + | | | | + | | | | + YB------Y-------YB------Y------- + | | | | + | | | | + | | | | + YR------Y-------YR------Y------- + | | | | + | | | | + | | | | + YB------Y-------YB------Y------- + | | | | + | | | | + | | | | + + We use a resampling filter to shift the site locations one quarter pixel (at + the chroma plane's resolution) to the right. + Then we use another filter to move the C_r location down one quarter pixel, + and the C_b location up one quarter pixel.*/ +static void y4m_convert_42xpaldv_42xjpeg(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ + unsigned char *tmp; + int c_w; + int c_h; + int c_sz; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=_y4m->pic_w*_y4m->pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(_y4m->pic_w+1)/2; + c_h=(_y4m->pic_h+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h; + c_sz=c_w*c_h; + /*First do the horizontal re-sampling. + This is the same as the mpeg2 case, except that after the horizontal case, + we need to apply a second vertical filter.*/ + tmp=_aux+2*c_sz; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + } + for(;x>7,255); + } + for(;x>7,255); + } + tmp+=c_w; + _aux+=c_w; + } + switch(pli){ + case 1:{ + tmp-=c_sz; + /*Slide C_b up a quarter-pel. + This is the same filter used above, but in the other order.*/ + for(x=0;x>7,255); + } + for(;y>7,255); + } + for(;y>7,255); + } + _dst++; + tmp++; + } + _dst+=c_sz-c_w; + tmp-=c_w; + }break; + case 2:{ + tmp-=c_sz; + /*Slide C_r down a quarter-pel. + This is the same as the horizontal filter.*/ + for(x=0;x>7,255); + } + for(;y>7,255); + } + for(;y>7,255); + } + _dst++; + tmp++; + } + }break; + } + /*For actual interlaced material, this would have to be done separately on + each field, and the shift amounts would be different. + C_r moves down 1/8, C_b up 3/8 in the top field, and C_r moves down 3/8, + C_b up 1/8 in the bottom field. + The corresponding filters would be: + Down 1/8 (reverse order for up): [3 -11 125 15 -4 0]/128 + Down 3/8 (reverse order for up): [4 -19 98 56 -13 2]/128*/ + } +} + +/*422jpeg chroma samples are sited like: + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + + 411 chroma samples are sited like: + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + + We use a filter to resample at site locations one eighth pixel (at the source + chroma plane's horizontal resolution) and five eighths of a pixel to the + right.*/ +static void y4m_convert_411_422jpeg(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ + int c_w; + int dst_c_w; + int c_h; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=_y4m->pic_w*_y4m->pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(_y4m->pic_w+_y4m->src_c_dec_h-1)/_y4m->src_c_dec_h; + dst_c_w=(_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h; + c_h=(_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + _dst[x<<1|1]=(unsigned char)OC_CLAMPI(0,47*_aux[0]+ + 86*_aux[OC_MINI(1,c_w-1)]-5*_aux[OC_MINI(2,c_w-1)]+64>>7,255); + } + for(;x>7,255); + _dst[x<<1|1]=(unsigned char)OC_CLAMPI(0,-3*_aux[x-1]+50*_aux[x]+ + 86*_aux[x+1]-5*_aux[x+2]+64>>7,255); + } + for(;x>7,255); + if((x<<1|1)>7,255); + } + } + _dst+=dst_c_w; + _aux+=c_w; + } + } +} + +/*The image is padded with empty chroma components at 4:2:0. + This costs about 17 bits a frame to code.*/ +static void y4m_convert_mono_420jpeg(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ + int c_sz; + _dst+=_y4m->pic_w*_y4m->pic_h; + c_sz=((_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h)* + ((_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v); + memset(_dst,128,c_sz*2); +} + +#if 0 +/*Right now just 444 to 420. + Not too hard to generalize.*/ +static void y4m_convert_4xxjpeg_42xjpeg(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ + unsigned char *tmp; + int c_w; + int c_h; + int pic_sz; + int tmp_sz; + int c_sz; + int pli; + int y; + int x; + /*Compute the size of each chroma plane.*/ + c_w=(_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h; + c_h=(_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v; + pic_sz=_y4m->pic_w*_y4m->pic_h; + tmp_sz=c_w*_y4m->pic_h; + c_sz=c_w*c_h; + _dst+=pic_sz; + for(pli=1;pli<3;pli++){ + tmp=_aux+pic_sz; + /*In reality, the horizontal and vertical steps could be pipelined, for + less memory consumption and better cache performance, but we do them + separately for simplicity.*/ + /*First do horizontal filtering (convert to 4:2:2)*/ + /*Filter: [3 -17 78 78 -17 3]/128, derived from a 6-tap Lanczos window.*/ + for(y=0;y<_y4m->pic_h;y++){ + for(x=0;xpic_w,2);x+=2){ + tmp[x>>1]=OC_CLAMPI(0,64*_aux[0]+78*_aux[OC_MINI(1,_y4m->pic_w-1)] + -17*_aux[OC_MINI(2,_y4m->pic_w-1)] + +3*_aux[OC_MINI(3,_y4m->pic_w-1)]+64>>7,255); + } + for(;x<_y4m->pic_w-3;x+=2){ + tmp[x>>1]=OC_CLAMPI(0,3*(_aux[x-2]+_aux[x+3])-17*(_aux[x-1]+_aux[x+2])+ + 78*(_aux[x]+_aux[x+1])+64>>7,255); + } + for(;x<_y4m->pic_w;x+=2){ + tmp[x>>1]=OC_CLAMPI(0,3*(_aux[x-2]+_aux[_y4m->pic_w-1])- + 17*(_aux[x-1]+_aux[OC_MINI(x+2,_y4m->pic_w-1)])+ + 78*(_aux[x]+_aux[OC_MINI(x+1,_y4m->pic_w-1)])+64>>7,255); + } + tmp+=c_w; + _aux+=_y4m->pic_w; + } + _aux-=pic_sz; + tmp-=tmp_sz; + /*Now do the vertical filtering.*/ + for(x=0;xpic_h,2);y+=2){ + _dst[(y>>1)*c_w]=OC_CLAMPI(0,64*tmp[0] + +78*tmp[OC_MINI(1,_y4m->pic_h-1)*c_w] + -17*tmp[OC_MINI(2,_y4m->pic_h-1)*c_w] + +3*tmp[OC_MINI(3,_y4m->pic_h-1)*c_w]+64>>7,255); + } + for(;y<_y4m->pic_h-3;y+=2){ + _dst[(y>>1)*c_w]=OC_CLAMPI(0,3*(tmp[(y-2)*c_w]+tmp[(y+3)*c_w])- + 17*(tmp[(y-1)*c_w]+tmp[(y+2)*c_w])+78*(tmp[y*c_w]+tmp[(y+1)*c_w])+ + 64>>7,255); + } + for(;y<_y4m->pic_h;y+=2){ + _dst[(y>>1)*c_w]=OC_CLAMPI(0,3*(tmp[(y-2)*c_w] + +tmp[(_y4m->pic_h-1)*c_w])-17*(tmp[(y-1)*c_w] + +tmp[OC_MINI(y+2,_y4m->pic_h-1)*c_w]) + +78*(tmp[y*c_w]+tmp[OC_MINI(y+1,_y4m->pic_h-1)*c_w])+64>>7,255); + } + tmp++; + _dst++; + } + _dst-=c_w; + } +} +#endif + +/*No conversion function needed.*/ +static void y4m_convert_null(y4m_input *_y4m,unsigned char *_dst, + unsigned char *_aux){ +} + +static int y4m_input_open(y4m_input *_y4m,FILE *_fin,char *_skip,int _nskip){ + char buffer[80]; + int ret; + int i; + /*Read until newline, or 80 cols, whichever happens first.*/ + for(i=0;i<79;i++){ + if(_nskip>0){ + buffer[i]=*_skip++; + _nskip--; + } + else{ + ret=fread(buffer+i,1,1,_fin); + if(ret<1)return -1; + } + if(buffer[i]=='\n')break; + } + /*We skipped too much header data.*/ + if(_nskip>0)return -1; + if(i==79){ + fprintf(stderr,"Error parsing header; not a YUV2MPEG2 file?\n"); + return -1; + } + buffer[i]='\0'; + if(memcmp(buffer,"YUV4MPEG",8)){ + fprintf(stderr,"Incomplete magic for YUV4MPEG file.\n"); + return -1; + } + if(buffer[8]!='2'){ + fprintf(stderr,"Incorrect YUV input file version; YUV4MPEG2 required.\n"); + } + ret=y4m_parse_tags(_y4m,buffer+5); + if(ret<0){ + fprintf(stderr,"Error parsing YUV4MPEG2 header.\n"); + return ret; + } + if(_y4m->interlace!='p'){ + fprintf(stderr,"Input video is interlaced; " + "Theora only handles progressive scan.\n"); + return -1; + } + if(strcmp(_y4m->chroma_type,"420")==0|| + strcmp(_y4m->chroma_type,"420jpeg")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=_y4m->src_c_dec_v=_y4m->dst_c_dec_v=2; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h + +2*((_y4m->pic_w+1)/2)*((_y4m->pic_h+1)/2); + /*Natively supported: no conversion required.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=0; + _y4m->convert=y4m_convert_null; + } + else if(strcmp(_y4m->chroma_type,"420mpeg2")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=_y4m->src_c_dec_v=_y4m->dst_c_dec_v=2; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + /*Chroma filter required: read into the aux buf first.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz= + 2*((_y4m->pic_w+1)/2)*((_y4m->pic_h+1)/2); + _y4m->convert=y4m_convert_42xmpeg2_42xjpeg; + } + else if(strcmp(_y4m->chroma_type,"420paldv")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=_y4m->src_c_dec_v=_y4m->dst_c_dec_v=2; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + /*Chroma filter required: read into the aux buf first. + We need to make two filter passes, so we need some extra space in the + aux buffer.*/ + _y4m->aux_buf_sz=3*((_y4m->pic_w+1)/2)*((_y4m->pic_h+1)/2); + _y4m->aux_buf_read_sz=2*((_y4m->pic_w+1)/2)*((_y4m->pic_h+1)/2); + _y4m->convert=y4m_convert_42xpaldv_42xjpeg; + } + else if(strcmp(_y4m->chroma_type,"422")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=2; + _y4m->src_c_dec_v=_y4m->dst_c_dec_v=1; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + /*Chroma filter required: read into the aux buf first.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=2*((_y4m->pic_w+1)/2)*_y4m->pic_h; + _y4m->convert=y4m_convert_42xmpeg2_42xjpeg; + } + else if(strcmp(_y4m->chroma_type,"422jpeg")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=2; + _y4m->src_c_dec_v=_y4m->dst_c_dec_v=1; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h + +2*((_y4m->pic_w+1)/2)*_y4m->pic_h; + /*Natively supported: no conversion required.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=0; + _y4m->convert=y4m_convert_null; + } + else if(strcmp(_y4m->chroma_type,"411")==0){ + _y4m->src_c_dec_h=4; + /*We don't want to introduce any additional sub-sampling, so we + promote 4:1:1 material to 4:2:2, as the closest format Theora can + handle.*/ + _y4m->dst_c_dec_h=2; + _y4m->src_c_dec_v=_y4m->dst_c_dec_v=1; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + /*Chroma filter required: read into the aux buf first.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=2*((_y4m->pic_w+3)/4)*_y4m->pic_h; + _y4m->convert=y4m_convert_411_422jpeg; + } + else if(strcmp(_y4m->chroma_type,"444")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=_y4m->src_c_dec_v=_y4m->dst_c_dec_v=1; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h*3; + /*Natively supported: no conversion required.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=0; + _y4m->convert=y4m_convert_null; + } + else if(strcmp(_y4m->chroma_type,"444alpha")==0){ + _y4m->src_c_dec_h=_y4m->dst_c_dec_h=_y4m->src_c_dec_v=_y4m->dst_c_dec_v=1; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h*3; + /*Read the extra alpha plane into the aux buf. + It will be discarded.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + _y4m->convert=y4m_convert_null; + } + else if(strcmp(_y4m->chroma_type,"mono")==0){ + _y4m->src_c_dec_h=_y4m->src_c_dec_v=0; + _y4m->dst_c_dec_h=_y4m->dst_c_dec_v=2; + _y4m->dst_buf_read_sz=_y4m->pic_w*_y4m->pic_h; + /*No extra space required, but we need to clear the chroma planes.*/ + _y4m->aux_buf_sz=_y4m->aux_buf_read_sz=0; + _y4m->convert=y4m_convert_mono_420jpeg; + } + else{ + fprintf(stderr,"Unknown chroma sampling type: %s\n",_y4m->chroma_type); + return -1; + } + /*The size of the final frame buffers is always computed from the + destination chroma decimation type.*/ + _y4m->dst_buf_sz=_y4m->pic_w*_y4m->pic_h + +2*((_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h)* + ((_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v); + /*Scale the picture size up to a multiple of 16.*/ + _y4m->frame_w=_y4m->pic_w+15&~0xF; + _y4m->frame_h=_y4m->pic_h+15&~0xF; + /*Force the offsets to be even so that chroma samples line up like we + expect.*/ + _y4m->pic_x=_y4m->frame_w-_y4m->pic_w>>1&~1; + _y4m->pic_y=_y4m->frame_h-_y4m->pic_h>>1&~1; + _y4m->dst_buf=(unsigned char *)malloc(_y4m->dst_buf_sz); + _y4m->aux_buf=(unsigned char *)malloc(_y4m->aux_buf_sz); + return 0; +} + +static void y4m_input_get_info(y4m_input *_y4m,th_info *_ti){ + _ti->frame_width=_y4m->frame_w; + _ti->frame_height=_y4m->frame_h; + _ti->pic_width=_y4m->pic_w; + _ti->pic_height=_y4m->pic_h; + _ti->pic_x=_y4m->pic_x; + _ti->pic_y=_y4m->pic_y; + _ti->fps_numerator=_y4m->fps_n; + _ti->fps_denominator=_y4m->fps_d; + _ti->aspect_numerator=_y4m->par_n; + _ti->aspect_denominator=_y4m->par_d; + _ti->pixel_fmt=_y4m->dst_c_dec_h==2? + (_y4m->dst_c_dec_v==2?TH_PF_420:TH_PF_422):TH_PF_444; +} + +static int y4m_input_fetch_frame(y4m_input *_y4m,FILE *_fin, + th_ycbcr_buffer _ycbcr){ + char frame[6]; + int pic_sz; + int frame_c_w; + int frame_c_h; + int c_w; + int c_h; + int c_sz; + int ret; + pic_sz=_y4m->pic_w*_y4m->pic_h; + frame_c_w=_y4m->frame_w/_y4m->dst_c_dec_h; + frame_c_h=_y4m->frame_h/_y4m->dst_c_dec_v; + c_w=(_y4m->pic_w+_y4m->dst_c_dec_h-1)/_y4m->dst_c_dec_h; + c_h=(_y4m->pic_h+_y4m->dst_c_dec_v-1)/_y4m->dst_c_dec_v; + c_sz=c_w*c_h; + /*Read and skip the frame header.*/ + ret=fread(frame,1,6,_fin); + if(ret<6)return 0; + if(memcmp(frame,"FRAME",5)){ + fprintf(stderr,"Loss of framing in YUV input data\n"); + exit(1); + } + if(frame[5]!='\n'){ + char c; + int j; + for(j=0;j<79&&fread(&c,1,1,_fin)&&c!='\n';j++); + if(j==79){ + fprintf(stderr,"Error parsing YUV frame header\n"); + return -1; + } + } + /*Read the frame data that needs no conversion.*/ + if(fread(_y4m->dst_buf,1,_y4m->dst_buf_read_sz,_fin)!=_y4m->dst_buf_read_sz){ + fprintf(stderr,"Error reading YUV frame data.\n"); + return -1; + } + /*Read the frame data that does need conversion.*/ + if(fread(_y4m->aux_buf,1,_y4m->aux_buf_read_sz,_fin)!=_y4m->aux_buf_read_sz){ + fprintf(stderr,"Error reading YUV frame data.\n"); + return -1; + } + /*Now convert the just read frame.*/ + (*_y4m->convert)(_y4m,_y4m->dst_buf,_y4m->aux_buf); + /*Fill in the frame buffer pointers.*/ + _ycbcr[0].width=_y4m->frame_w; + _ycbcr[0].height=_y4m->frame_h; + _ycbcr[0].stride=_y4m->pic_w; + _ycbcr[0].data=_y4m->dst_buf-_y4m->pic_x-_y4m->pic_y*_y4m->pic_w; + _ycbcr[1].width=frame_c_w; + _ycbcr[1].height=frame_c_h; + _ycbcr[1].stride=c_w; + _ycbcr[1].data=_y4m->dst_buf+pic_sz-(_y4m->pic_x/_y4m->dst_c_dec_h)- + (_y4m->pic_y/_y4m->dst_c_dec_v)*c_w; + _ycbcr[2].width=frame_c_w; + _ycbcr[2].height=frame_c_h; + _ycbcr[2].stride=c_w; + _ycbcr[2].data=_ycbcr[1].data+c_sz; + return 1; +} + +static void y4m_input_close(y4m_input *_y4m){ + free(_y4m->dst_buf); + free(_y4m->aux_buf); +} + + + +typedef struct th_input th_input; + +struct th_input{ + ogg_sync_state oy; + int theora_p; + ogg_stream_state to; + th_info ti; + th_comment tc; + th_dec_ctx *td; +}; + + + +/*Grab some more compressed bitstream and sync it for page extraction.*/ +static int th_input_buffer_data(th_input *_th,FILE *_fin){ + char *buffer; + int bytes; + buffer=ogg_sync_buffer(&_th->oy,4096); + bytes=fread(buffer,1,4096,_fin); + ogg_sync_wrote(&_th->oy,bytes); + return bytes; +} + +/*Push a page into the appropriate steam. + This can be done blindly; a stream won't accept a page that doesn't belong to + it.*/ +static void th_input_queue_page(th_input *_th,ogg_page *_og){ + if(_th->theora_p)ogg_stream_pagein(&_th->to,_og); +} + +static int th_input_open_impl(th_input *_th,th_setup_info **_ts,FILE *_fin, + char *_sig,int _nsig){ + ogg_packet op; + ogg_page og; + int nheaders_left; + int done_headers; + ogg_sync_init(&_th->oy); + th_info_init(&_th->ti); + th_comment_init(&_th->tc); + *_ts=NULL; + /*Buffer any initial data read for file ID.*/ + if(_nsig>0){ + char *buffer; + buffer=ogg_sync_buffer(&_th->oy,_nsig); + memcpy(buffer,_sig,_nsig); + ogg_sync_wrote(&_th->oy,_nsig); + } + _th->theora_p=0; + nheaders_left=0; + for(done_headers=0;!done_headers;){ + if(th_input_buffer_data(_th,_fin)==0)break; + while(ogg_sync_pageout(&_th->oy,&og)>0){ + ogg_stream_state test; + /*Is this a mandated initial header? + If not, stop parsing.*/ + if(!ogg_page_bos(&og)){ + /*Don't leak the page; get it into the appropriate stream.*/ + th_input_queue_page(_th,&og); + done_headers=1; + break; + } + ogg_stream_init(&test,ogg_page_serialno(&og)); + ogg_stream_pagein(&test,&og); + ogg_stream_packetpeek(&test,&op); + /*Identify the codec: try Theora.*/ + if(!_th->theora_p){ + nheaders_left=th_decode_headerin(&_th->ti,&_th->tc,_ts,&op); + if(nheaders_left>=0){ + /*It is Theora.*/ + memcpy(&_th->to,&test,sizeof(test)); + _th->theora_p=1; + /*Advance past the successfully processed header.*/ + if(nheaders_left>0)ogg_stream_packetout(&_th->to,NULL); + continue; + } + } + /*Whatever it is, we don't care about it.*/ + ogg_stream_clear(&test); + } + } + /*We're expecting more header packets.*/ + while(_th->theora_p&&nheaders_left>0){ + int ret; + while(nheaders_left>0){ + ret=ogg_stream_packetpeek(&_th->to,&op); + if(ret==0)break; + if(ret<0)continue; + nheaders_left=th_decode_headerin(&_th->ti,&_th->tc,_ts,&op); + if(nheaders_left<0){ + fprintf(stderr,"Error parsing Theora stream headers; " + "corrupt stream?\n"); + return -1; + } + /*Advance past the successfully processed header.*/ + else if(nheaders_left>0)ogg_stream_packetout(&_th->to,NULL); + _th->theora_p++; + } + /*Stop now so we don't fail if there aren't enough pages in a short + stream.*/ + if(!(_th->theora_p&&nheaders_left>0))break; + /*The header pages/packets will arrive before anything else we care + about, or the stream is not obeying spec.*/ + if(ogg_sync_pageout(&_th->oy,&og)>0)th_input_queue_page(_th,&og); + /*We need more data.*/ + else if(th_input_buffer_data(_th,_fin)==0){ + fprintf(stderr,"End of file while searching for codec headers.\n"); + return -1; + } + } + /*And now we have it all. + Initialize the decoder.*/ + if(_th->theora_p){ + _th->td=th_decode_alloc(&_th->ti,*_ts); + if(_th->td!=NULL){ + fprintf(stderr,"Ogg logical stream %lx is Theora %ix%i %.02f fps video.\n" + "Encoded frame content is %ix%i with %ix%i offset.\n", + _th->to.serialno,_th->ti.frame_width,_th->ti.frame_height, + (double)_th->ti.fps_numerator/_th->ti.fps_denominator, + _th->ti.pic_width,_th->ti.pic_height,_th->ti.pic_x,_th->ti.pic_y); + return 1; + } + } + return -1; +} + +static void th_input_close(th_input *_th){ + if(_th->theora_p){ + ogg_stream_clear(&_th->to); + th_decode_free(_th->td); + } + th_comment_clear(&_th->tc); + th_info_clear(&_th->ti); + ogg_sync_clear(&_th->oy); +} + +static int th_input_open(th_input *_th,FILE *_fin,char *_sig,int _nsig){ + th_input th; + th_setup_info *ts; + int ret; + ret=th_input_open_impl(&th,&ts,_fin,_sig,_nsig); + th_setup_free(ts); + /*Clean up on failure.*/ + if(ret<0)th_input_close(&th); + else memcpy(_th,&th,sizeof(th)); + return ret; +} + +static void th_input_get_info(th_input *_th,th_info *_ti){ + memcpy(_ti,&_th->ti,sizeof(*_ti)); +} + +static int th_input_fetch_frame(th_input *_th,FILE *_fin, + th_ycbcr_buffer _ycbcr){ + for(;;){ + ogg_page og; + ogg_packet op; + if(ogg_stream_packetout(&_th->to,&op)>0){ + if(th_decode_packetin(_th->td,&op,NULL)>=0){ + th_decode_ycbcr_out(_th->td,_ycbcr); + if(!summary_only&&show_frame_type){ + printf("%c",th_packet_iskeyframe(&op)?'K':'D'); + if(op.bytes>0)printf("%02i ",op.packet[0]&0x3F); + else printf("-- "); + } + return 1; + } + else return -1; + } + while(ogg_sync_pageout(&_th->oy,&og)<=0){ + if(th_input_buffer_data(_th,_fin)==0)return feof(_fin)?0:-1; + } + th_input_queue_page(_th,&og); + } +} + + + +typedef struct video_input video_input; +typedef void (*video_input_get_info_func)(void *_ctx,th_info *_ti); +typedef int (*video_input_fetch_frame_func)(void *_ctx,FILE *_fin, + th_ycbcr_buffer _ycbcr); +typedef void (*video_input_close_func)(void *_ctx); + +struct video_input{ + FILE *fin; + video_input_get_info_func get_info; + video_input_fetch_frame_func fetch_frame; + video_input_close_func close; + union{ + y4m_input y4m; + th_input th; + }ctx; +}; + +static int video_input_open(video_input *_vid,FILE *_fin){ + char buffer[4]; + int ret; + /* look for magic */ + ret=fread(buffer,1,4,_fin); + if(ret<4)fprintf(stderr,"EOF determining file type of file.\n"); + else{ + if(!memcmp(buffer,"YUV4",4)){ + if(y4m_input_open(&_vid->ctx.y4m,_fin,buffer,4)>=0){ + /*fprintf(stderr,"Original %s is %dx%d %.02f fps %s video.\n", + f,_y4m->pic_w,_y4m->pic_h,(double)_y4m->fps_n/_y4m->fps_d,_y4m->chroma_type);*/ + _vid->fin=_fin; + _vid->get_info=(video_input_get_info_func)y4m_input_get_info; + _vid->fetch_frame=(video_input_fetch_frame_func)y4m_input_fetch_frame; + _vid->close=(video_input_close_func)y4m_input_close; + return 0; + } + } + else if(!memcmp(buffer,"OggS",4)){ + if(th_input_open(&_vid->ctx.th,_fin,buffer,4)>=0){ + _vid->fin=_fin; + _vid->get_info=(video_input_get_info_func)th_input_get_info; + _vid->fetch_frame=(video_input_fetch_frame_func)th_input_fetch_frame; + _vid->close=(video_input_close_func)th_input_close; + return 0; + } + } + else fprintf(stderr,"Unknown file type.\n"); + } + return -1; +} + +static void video_input_get_info(video_input *_vid,th_info *_ti){ + (*_vid->get_info)(&_vid->ctx,_ti); +} + +static int video_input_fetch_frame(video_input *_vid,th_ycbcr_buffer _ycbcr){ + return (*_vid->fetch_frame)(&_vid->ctx,_vid->fin,_ycbcr); +} + +static void video_input_close(video_input *_vid){ + (*_vid->close)(&_vid->ctx); + fclose(_vid->fin); +} + + + +static void usage(char *_argv[]){ + fprintf(stderr,"Usage: %s [options] \n" + " and may be either YUV4MPEG or Ogg Theora files.\n\n" + " Options:\n\n" + " -f --frame-type Show frame type and QI value for each Theora frame.\n" + " -s --summary Only output the summary line.\n" + " -y --luma-only Only output values for the luma channel.\n",_argv[0]); +} + +int main(int _argc,char *_argv[]){ + video_input vid1; + th_info ti1; + video_input vid2; + th_info ti2; + ogg_int64_t gsqerr; + ogg_int64_t gnpixels; + ogg_int64_t gplsqerr[3]; + ogg_int64_t gplnpixels[3]; + int frameno; + FILE *fin; + int long_option_index; + int c; +#ifdef _WIN32 + /*We need to set stdin/stdout to binary mode on windows. + Beware the evil ifdef. + We avoid these where we can, but this one we cannot. + Don't add any more, you'll probably go to hell if you do.*/ + _setmode(_fileno(stdin),_O_BINARY); +#endif + /*Process option arguments.*/ + while((c=getopt_long(_argc,_argv,optstring,options,&long_option_index))!=EOF){ + switch(c){ + case 'f':show_frame_type=1;break; + case 's':summary_only=1;break; + case 'y':luma_only=1;break; + default:usage(_argv);break; + } + } + if(optind+2!=_argc){ + usage(_argv); + exit(1); + } + fin=strcmp(_argv[optind],"-")==0?stdin:fopen(_argv[optind],"rb"); + if(fin==NULL){ + fprintf(stderr,"Unable to open '%s' for extraction.\n",_argv[optind]); + exit(1); + } + fprintf(stderr,"Opening %s...\n",_argv[optind]); + if(video_input_open(&vid1,fin)<0)exit(1); + video_input_get_info(&vid1,&ti1); + fin=strcmp(_argv[optind+1],"-")==0?stdin:fopen(_argv[optind+1],"rb"); + if(fin==NULL){ + fprintf(stderr,"Unable to open '%s' for extraction.\n",_argv[optind+1]); + exit(1); + } + fprintf(stderr,"Opening %s...\n",_argv[optind+1]); + if(video_input_open(&vid2,fin)<0)exit(1); + video_input_get_info(&vid2,&ti2); + /*Check to make sure these videos are compatible.*/ + if(ti1.pic_width!=ti2.pic_width||ti1.pic_height!=ti2.pic_height){ + fprintf(stderr,"Video resolution does not match.\n"); + exit(1); + } + if(ti1.pixel_fmt!=ti2.pixel_fmt){ + fprintf(stderr,"Pixel formats do not match.\n"); + exit(1); + } + if((ti1.pic_x&!(ti1.pixel_fmt&1))!=(ti2.pic_x&!(ti2.pixel_fmt&1))|| + (ti1.pic_y&!(ti1.pixel_fmt&2))!=(ti2.pic_y&!(ti2.pixel_fmt&2))){ + fprintf(stderr,"Chroma subsampling offsets do not match.\n"); + exit(1); + } + if(ti1.fps_numerator*(ogg_int64_t)ti2.fps_denominator!= + ti2.fps_numerator*(ogg_int64_t)ti1.fps_denominator){ + fprintf(stderr,"Warning: framerates do not match.\n"); + } + if(ti1.aspect_numerator*(ogg_int64_t)ti2.aspect_denominator!= + ti2.aspect_numerator*(ogg_int64_t)ti1.aspect_denominator){ + fprintf(stderr,"Warning: aspect ratios do not match.\n"); + } + gsqerr=gplsqerr[0]=gplsqerr[1]=gplsqerr[2]=0; + gnpixels=gplnpixels[0]=gplnpixels[1]=gplnpixels[2]=0; + for(frameno=0;;frameno++){ + th_ycbcr_buffer f1; + th_ycbcr_buffer f2; + ogg_int64_t plsqerr[3]; + long plnpixels[3]; + ogg_int64_t sqerr; + long npixels; + int ret1; + int ret2; + int pli; + ret1=video_input_fetch_frame(&vid1,f1); + ret2=video_input_fetch_frame(&vid2,f2); + if(ret1==0&&ret2==0)break; + else if(ret1<0||ret2<0)break; + else if(ret1==0){ + fprintf(stderr,"%s ended before %s.\n", + _argv[optind],_argv[optind+1]); + break; + } + else if(ret2==0){ + fprintf(stderr,"%s ended before %s.\n", + _argv[optind+1],_argv[optind]); + break; + } + /*Okay, we got one frame from each.*/ + sqerr=0; + npixels=0; + for(pli=0;pli<3;pli++){ + int xdec; + int ydec; + int y1; + int y2; + xdec=pli&&!(ti1.pixel_fmt&1); + ydec=pli&&!(ti1.pixel_fmt&2); + plsqerr[pli]=0; + plnpixels[pli]=0; + for(y1=ti1.pic_y>>ydec,y2=ti2.pic_y>>ydec; + y1>ydec;y1++,y2++){ + int x1; + int x2; + for(x1=ti1.pic_x>>xdec,x2=ti2.pic_x>>xdec; + x1>xdec;x1++,x2++){ + int d; + d=*(f1[pli].data+y1*f1[pli].stride+x1)- + *(f2[pli].data+y2*f2[pli].stride+x2); + plsqerr[pli]+=d*d; + plnpixels[pli]++; + } + } + sqerr+=plsqerr[pli]; + gplsqerr[pli]+=plsqerr[pli]; + npixels+=plnpixels[pli]; + gplnpixels[pli]+=plnpixels[pli]; + } + if(!summary_only){ + if(!luma_only){ + printf("%08i: %-7lG (Y': %-7lG Cb: %-7lG Cr: %-7lG)\n",frameno, + 10*(log10(255*255)+log10(npixels)-log10(sqerr)), + 10*(log10(255*255)+log10(plnpixels[0])-log10(plsqerr[0])), + 10*(log10(255*255)+log10(plnpixels[1])-log10(plsqerr[1])), + 10*(log10(255*255)+log10(plnpixels[2])-log10(plsqerr[2]))); + } + else{ + printf("%08i: %-7lG\n",frameno, + 10*(log10(255*255)+log10(plnpixels[0])-log10(plsqerr[0]))); + } + } + gsqerr+=sqerr; + gnpixels+=npixels; + } + if(!luma_only){ + printf("Total: %-7lG (Y': %-7lG Cb: %-7lG Cr: %-7lG)\n", + 10*(log10(255*255)+log10(gnpixels)-log10(gsqerr)), + 10*(log10(255*255)+log10(gplnpixels[0])-log10(gplsqerr[0])), + 10*(log10(255*255)+log10(gplnpixels[1])-log10(gplsqerr[1])), + 10*(log10(255*255)+log10(gplnpixels[2])-log10(gplsqerr[2]))); + } + else{ + printf("Total: %-7lG\n", + 10*(log10(255*255)+log10(gplnpixels[0])-log10(gplsqerr[0]))); + } + video_input_close(&vid1); + video_input_close(&vid2); + return 0; +} diff --git a/libs/libtheora-1.1/examples/dump_video.c b/libs/libtheora-1.1/examples/dump_video.c new file mode 100644 index 00000000..1449ec48 --- /dev/null +++ b/libs/libtheora-1.1/examples/dump_video.c @@ -0,0 +1,496 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: example dumpvid application; dumps Theora streams + last mod: $Id: dump_video.c,v 1.2 2004/03/24 19:12:42 derf Exp $ + + ********************************************************************/ + +/* By Mauricio Piacentini (mauricio at xiph.org) */ +/* simply dump decoded YUV data, for verification of theora bitstream */ + +#if !defined(_REENTRANT) +#define _REENTRANT +#endif +#if !defined(_GNU_SOURCE) +#define _GNU_SOURCE +#endif +#if !defined(_LARGEFILE_SOURCE) +#define _LARGEFILE_SOURCE +#endif +#if !defined(_LARGEFILE64_SOURCE) +#define _LARGEFILE64_SOURCE +#endif +#if !defined(_FILE_OFFSET_BITS) +#define _FILE_OFFSET_BITS 64 +#endif + +#include +#include +#include +#include +#include +#include +/*Yes, yes, we're going to hell.*/ +#if defined(_WIN32) +#include +#endif +#include +#include +#include +#include +#include "getopt.h" +#include "theora/theoradec.h" + +const char *optstring = "o:rf"; +struct option options [] = { + {"output",required_argument,NULL,'o'}, + {"raw",no_argument, NULL,'r'}, /*Disable YUV4MPEG2 headers:*/ + {"fps-only",no_argument, NULL, 'f'}, /* Only interested in fps of decode loop */ + {NULL,0,NULL,0} +}; + +/* Helper; just grab some more compressed bitstream and sync it for + page extraction */ +int buffer_data(FILE *in,ogg_sync_state *oy){ + char *buffer=ogg_sync_buffer(oy,4096); + int bytes=fread(buffer,1,4096,in); + ogg_sync_wrote(oy,bytes); + return(bytes); +} + +/* never forget that globals are a one-way ticket to Hell */ +/* Ogg and codec state for demux/decode */ +ogg_sync_state oy; +ogg_page og; +ogg_stream_state vo; +ogg_stream_state to; +th_info ti; +th_comment tc; +th_setup_info *ts; +th_dec_ctx *td; + +int theora_p=0; +int theora_processing_headers; +int stateflag=0; + +/* single frame video buffering */ +int videobuf_ready=0; +ogg_int64_t videobuf_granulepos=-1; +double videobuf_time=0; +int raw=0; + +FILE* outfile = NULL; + +int got_sigint=0; +static void sigint_handler (int signal) { + got_sigint = 1; +} + +static th_ycbcr_buffer ycbcr; + +static void stripe_decoded(th_ycbcr_buffer _dst,th_ycbcr_buffer _src, + int _fragy0,int _fragy_end){ + int pli; + for(pli=0;pli<3;pli++){ + int yshift; + int y_end; + int y; + yshift=pli!=0&&!(ti.pixel_fmt&2); + y_end=_fragy_end<<3-yshift; + /*An implemention intending to display this data would need to check the + crop rectangle before proceeding.*/ + for(y=_fragy0<<3-yshift;y>xshift)*(ti.frame_height>>yshift)*sizeof(char)); + ycbcr[pli].stride=ti.frame_width>>xshift; + ycbcr[pli].width=ti.frame_width>>xshift; + ycbcr[pli].height=ti.frame_height>>yshift; + } + /*Similarly, since ycbcr is a global, there's no real reason to pass it as + the context. + In a more object-oriented decoder, we could pass the "this" pointer + instead (though in C++, platform-dependent calling convention differences + prevent us from using a real member function pointer).*/ + cb.ctx=ycbcr; + cb.stripe_decoded=(th_stripe_decoded_func)stripe_decoded; + th_decode_ctl(td,TH_DECCTL_SET_STRIPE_CB,&cb,sizeof(cb)); +} + +/*Write out the planar YUV frame, uncropped.*/ +static void video_write(void){ + int pli; + int i; + /*Uncomment the following to do normal, non-striped decoding. + th_ycbcr_buffer ycbcr; + th_decode_ycbcr_out(td,ycbcr);*/ + if(outfile){ + if(!raw)fprintf(outfile, "FRAME\n"); + for(pli=0;pli<3;pli++){ + for(i=0;ivendor); + if(_tc->comments){ + fprintf(out,"theora comment header:\n"); + for(i=0;i<_tc->comments;i++){ + if(_tc->user_comments[i]){ + len=_tc->comment_lengths[i]comment_lengths[i]:INT_MAX; + fprintf(out,"\t%.*s\n",len,_tc->user_comments[i]); + } + } + } + return 0; +} + +/* helper: push a page into the appropriate steam */ +/* this can be done blindly; a stream won't accept a page + that doesn't belong to it */ +static int queue_page(ogg_page *page){ + if(theora_p)ogg_stream_pagein(&to,page); + return 0; +} + +static void usage(void){ + fprintf(stderr, + "Usage: dumpvid > outfile\n" + "input is read from stdin if no file is passed on the command line\n" + "\n" + ); +} + +int main(int argc,char *argv[]){ + + ogg_packet op; + + int long_option_index; + int c; + + struct timeb start; + struct timeb after; + struct timeb last; + int fps_only=0; + int frames = 0; + + FILE *infile = stdin; + outfile = stdout; + +#ifdef _WIN32 /* We need to set stdin/stdout to binary mode on windows. */ + /* Beware the evil ifdef. We avoid these where we can, but this one we + cannot. Don't add any more, you'll probably go to hell if you do. */ + _setmode( _fileno( stdin ), _O_BINARY ); + _setmode( _fileno( stdout ), _O_BINARY ); +#endif + + /* Process option arguments. */ + while((c=getopt_long(argc,argv,optstring,options,&long_option_index))!=EOF){ + switch(c){ + case 'o': + if(strcmp(optarg,"-")!=0){ + outfile=fopen(optarg,"wb"); + if(outfile==NULL){ + fprintf(stderr,"Unable to open output file '%s'\n", optarg); + exit(1); + } + }else{ + outfile=stdout; + } + break; + + case 'r': + raw=1; + break; + + case 'f': + fps_only = 1; + outfile = NULL; + break; + + default: + usage(); + } + } + if(optind0){ + int got_packet; + ogg_stream_state test; + + /* is this a mandated initial header? If not, stop parsing */ + if(!ogg_page_bos(&og)){ + /* don't leak the page; get it into the appropriate stream */ + queue_page(&og); + stateflag=1; + break; + } + + ogg_stream_init(&test,ogg_page_serialno(&og)); + ogg_stream_pagein(&test,&og); + got_packet = ogg_stream_packetpeek(&test,&op); + + /* identify the codec: try theora */ + if((got_packet==1) && !theora_p && (theora_processing_headers= + th_decode_headerin(&ti,&tc,&ts,&op))>=0){ + /* it is theora -- save this stream state */ + memcpy(&to,&test,sizeof(test)); + theora_p=1; + /*Advance past the successfully processed header.*/ + if(theora_processing_headers)ogg_stream_packetout(&to,NULL); + }else{ + /* whatever it is, we don't care about it */ + ogg_stream_clear(&test); + } + } + /* fall through to non-bos page parsing */ + } + + /* we're expecting more header packets. */ + while(theora_p && theora_processing_headers){ + int ret; + + /* look for further theora headers */ + while(theora_processing_headers&&(ret=ogg_stream_packetpeek(&to,&op))){ + if(ret<0)continue; + theora_processing_headers=th_decode_headerin(&ti,&tc,&ts,&op); + if(theora_processing_headers<0){ + fprintf(stderr,"Error parsing Theora stream headers; " + "corrupt stream?\n"); + exit(1); + } + else if(theora_processing_headers>0){ + /*Advance past the successfully processed header.*/ + ogg_stream_packetout(&to,NULL); + } + theora_p++; + } + + /*Stop now so we don't fail if there aren't enough pages in a short + stream.*/ + if(!(theora_p && theora_processing_headers))break; + + /* The header pages/packets will arrive before anything else we + care about, or the stream is not obeying spec */ + + if(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); /* demux into the appropriate stream */ + }else{ + int ret=buffer_data(infile,&oy); /* someone needs more data */ + if(ret==0){ + fprintf(stderr,"End of file while searching for codec headers.\n"); + exit(1); + } + } + } + + /* and now we have it all. initialize decoders */ + if(theora_p){ + dump_comments(&tc); + td=th_decode_alloc(&ti,ts); + fprintf(stderr,"Ogg logical stream %lx is Theora %dx%d %.02f fps video\n" + "Encoded frame content is %dx%d with %dx%d offset\n", + to.serialno,ti.frame_width,ti.frame_height, + (double)ti.fps_numerator/ti.fps_denominator, + ti.pic_width,ti.pic_height,ti.pic_x,ti.pic_y); + }else{ + /* tear down the partial theora setup */ + th_info_clear(&ti); + th_comment_clear(&tc); + } + /*Either way, we're done with the codec setup data.*/ + th_setup_free(ts); + + /* open video */ + if(theora_p)open_video(); + + if(!raw && outfile){ + static const char *CHROMA_TYPES[4]={"420jpeg",NULL,"422jpeg","444"}; + if(ti.pixel_fmt>=4||ti.pixel_fmt==TH_PF_RSVD){ + fprintf(stderr,"Unknown pixel format: %i\n",ti.pixel_fmt); + exit(1); + } + fprintf(outfile,"YUV4MPEG2 C%s W%d H%d F%d:%d I%c A%d:%d\n", + CHROMA_TYPES[ti.pixel_fmt],ti.frame_width,ti.frame_height, + ti.fps_numerator,ti.fps_denominator,'p', + ti.aspect_numerator,ti.aspect_denominator); + } + + /* install signal handler */ + signal (SIGINT, sigint_handler); + + /*Finally the main decode loop. + + It's one Theora packet per frame, so this is pretty straightforward if + we're not trying to maintain sync with other multiplexed streams. + + The videobuf_ready flag is used to maintain the input buffer in the libogg + stream state. + If there's no output frame available at the end of the decode step, we must + need more input data. + We could simplify this by just using the return code on + ogg_page_packetout(), but the flag system extends easily to the case where + you care about more than one multiplexed stream (like with audio + playback). + In that case, just maintain a flag for each decoder you care about, and + pull data when any one of them stalls. + + videobuf_time holds the presentation time of the currently buffered video + frame. + We ignore this value.*/ + + stateflag=0; /* playback has not begun */ + /* queue any remaining pages from data we buffered but that did not + contain headers */ + while(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); + } + + if(fps_only){ + ftime(&start); + ftime(&last); + } + + while(!got_sigint){ + + while(theora_p && !videobuf_ready){ + /* theora is one in, one out... */ + if(ogg_stream_packetout(&to,&op)>0){ + + if(th_decode_packetin(td,&op,&videobuf_granulepos)>=0){ + videobuf_time=th_granule_time(td,videobuf_granulepos); + videobuf_ready=1; + frames++; + if(fps_only) + ftime(&after); + } + + }else + break; + } + + if(fps_only && (videobuf_ready || fps_only==2)){ + long ms = + after.time*1000.+after.millitm- + (last.time*1000.+last.millitm); + + if(ms>500 || fps_only==1 || + (feof(infile) && !videobuf_ready)){ + float file_fps = (float)ti.fps_numerator/ti.fps_denominator; + fps_only=2; + + ms = after.time*1000.+after.millitm- + (start.time*1000.+start.millitm); + + fprintf(stderr,"\rframe:%d rate:%.2fx ", + frames, + frames*1000./(ms*file_fps)); + memcpy(&last,&after,sizeof(last)); + } + } + + if(!videobuf_ready && feof(infile))break; + + if(!videobuf_ready){ + /* no data yet for somebody. Grab another page */ + buffer_data(infile,&oy); + while(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); + } + } + /* dumpvideo frame, and get new one */ + else if(outfile)video_write(); + + videobuf_ready=0; + } + + /* end of decoder loop -- close everything */ + + if(theora_p){ + ogg_stream_clear(&to); + th_decode_free(td); + th_comment_clear(&tc); + th_info_clear(&ti); + } + ogg_sync_clear(&oy); + + if(infile && infile!=stdin)fclose(infile); + if(outfile && outfile!=stdout)fclose(outfile); + + fprintf(stderr, "\n\n%d frames\n", frames); + fprintf(stderr, "\nDone.\n"); + + return(0); + +} diff --git a/libs/libtheora-1.1/examples/encoder_example.c b/libs/libtheora-1.1/examples/encoder_example.c new file mode 100644 index 00000000..1ff39da1 --- /dev/null +++ b/libs/libtheora-1.1/examples/encoder_example.c @@ -0,0 +1,1830 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: example encoder application; makes an Ogg Theora/Vorbis + file from YUV4MPEG2 and WAV input + last mod: $Id: encoder_example.c 16764 2009-12-28 14:27:33Z tterribe $ + + ********************************************************************/ + +#if !defined(_REENTRANT) +#define _REENTRANT +#endif +#if !defined(_GNU_SOURCE) +#define _GNU_SOURCE +#endif +#if !defined(_LARGEFILE_SOURCE) +#define _LARGEFILE_SOURCE +#endif +#if !defined(_LARGEFILE64_SOURCE) +#define _LARGEFILE64_SOURCE +#endif +#if !defined(_FILE_OFFSET_BITS) +#define _FILE_OFFSET_BITS 64 +#endif + +#include +#if !defined(_WIN32) +#include +#include +#else +#include "getopt.h" +#endif +#include +#include +#include +#include +#include "theora/theoraenc.h" +#include "vorbis/codec.h" +#include "vorbis/vorbisenc.h" + +#ifdef _WIN32 +/*supply missing headers and functions to Win32. going to hell, I know*/ +#include +#include + +static double rint(double x) +{ + if (x < 0.0) + return (double)(int)(x - 0.5); + else + return (double)(int)(x + 0.5); +} +#endif + +const char *optstring = "b:e:o:a:A:v:V:s:S:f:F:ck:d:z:\1\2\3\4"; +struct option options [] = { + {"begin-time",required_argument,NULL,'b'}, + {"end-time",required_argument,NULL,'e'}, + {"output",required_argument,NULL,'o'}, + {"audio-rate-target",required_argument,NULL,'A'}, + {"video-rate-target",required_argument,NULL,'V'}, + {"audio-quality",required_argument,NULL,'a'}, + {"video-quality",required_argument,NULL,'v'}, + {"aspect-numerator",required_argument,NULL,'s'}, + {"aspect-denominator",required_argument,NULL,'S'}, + {"framerate-numerator",required_argument,NULL,'f'}, + {"framerate-denominator",required_argument,NULL,'F'}, + {"vp3-compatible",no_argument,NULL,'c'}, + {"speed",required_argument,NULL,'z'}, + {"soft-target",no_argument,NULL,'\1'}, + {"keyframe-freq",required_argument,NULL,'k'}, + {"buf-delay",required_argument,NULL,'d'}, + {"two-pass",no_argument,NULL,'\2'}, + {"first-pass",required_argument,NULL,'\3'}, + {"second-pass",required_argument,NULL,'\4'}, + {NULL,0,NULL,0} +}; + +/* You'll go to Hell for using globals. */ + +FILE *audio=NULL; +FILE *video=NULL; + +int audio_ch=0; +int audio_hz=0; + +float audio_q=.1f; +int audio_r=-1; +int vp3_compatible=0; + +int frame_w=0; +int frame_h=0; +int pic_w=0; +int pic_h=0; +int pic_x=0; +int pic_y=0; +int video_fps_n=-1; +int video_fps_d=-1; +int video_par_n=-1; +int video_par_d=-1; +char interlace; +int src_c_dec_h=2; +int src_c_dec_v=2; +int dst_c_dec_h=2; +int dst_c_dec_v=2; +char chroma_type[16]; + +/*The size of each converted frame buffer.*/ +size_t y4m_dst_buf_sz; +/*The amount to read directly into the converted frame buffer.*/ +size_t y4m_dst_buf_read_sz; +/*The size of the auxilliary buffer.*/ +size_t y4m_aux_buf_sz; +/*The amount to read into the auxilliary buffer.*/ +size_t y4m_aux_buf_read_sz; + +/*The function used to perform chroma conversion.*/ +typedef void (*y4m_convert_func)(unsigned char *_dst,unsigned char *_aux); + +y4m_convert_func y4m_convert=NULL; + +int video_r=-1; +int video_q=-1; +ogg_uint32_t keyframe_frequency=0; +int buf_delay=-1; + +long begin_sec=-1; +long begin_usec=0; +long end_sec=-1; +long end_usec=0; + +static void usage(void){ + fprintf(stderr, + "Usage: encoder_example [options] [audio_file] video_file\n\n" + "Options: \n\n" + " -o --output file name for encoded output;\n" + " If this option is not given, the\n" + " compressed data is sent to stdout.\n\n" + " -A --audio-rate-target bitrate target for Vorbis audio;\n" + " use -a and not -A if at all possible,\n" + " as -a gives higher quality for a given\n" + " bitrate.\n\n" + " -V --video-rate-target bitrate target for Theora video\n\n" + " --soft-target Use a large reservoir and treat the rate\n" + " as a soft target; rate control is less\n" + " strict but resulting quality is usually\n" + " higher/smoother overall. Soft target also\n" + " allows an optional -v setting to specify\n" + " a minimum allowed quality.\n\n" + " --two-pass Compress input using two-pass rate control\n" + " This option requires that the input to the\n" + " to the encoder is seekable and performs\n" + " both passes automatically.\n\n" + " --first-pass Perform first-pass of a two-pass rate\n" + " controlled encoding, saving pass data to\n" + " for a later second pass\n\n" + " --second-pass Perform second-pass of a two-pass rate\n" + " controlled encoding, reading first-pass\n" + " data from . The first pass\n" + " data must come from a first encoding pass\n" + " using identical input video to work\n" + " properly.\n\n" + " -a --audio-quality Vorbis quality selector from -1 to 10\n" + " (-1 yields smallest files but lowest\n" + " fidelity; 10 yields highest fidelity\n" + " but large files. '2' is a reasonable\n" + " default).\n\n" + " -v --video-quality Theora quality selector from 0 to 10\n" + " (0 yields smallest files but lowest\n" + " video quality. 10 yields highest\n" + " fidelity but large files).\n\n" + " -s --aspect-numerator Aspect ratio numerator, default is 0\n" + " or extracted from YUV input file\n" + " -S --aspect-denominator Aspect ratio denominator, default is 0\n" + " or extracted from YUV input file\n" + " -f --framerate-numerator Frame rate numerator, can be extracted\n" + " from YUV input file. ex: 30000000\n" + " -F --framerate-denominator Frame rate denominator, can be extracted\n" + " from YUV input file. ex: 1000000\n" + " The frame rate nominator divided by this\n" + " determinates the frame rate in units per tick\n" + " -k --keyframe-freq Keyframe frequency\n" + " -z --speed Sets the encoder speed level. Higher speed\n" + " levels favor quicker encoding over better\n" + " quality per bit. Depending on the encoding\n" + " mode, and the internal algorithms used,\n" + " quality may actually improve with higher\n" + " speeds, but in this case bitrate will also\n" + " likely increase. The maximum value, and the\n" + " meaning of each value, are implementation-\n" + " specific and may change depending on the\n" + " current encoding mode (rate constrained,\n" + " two-pass, etc.).\n" + " -d --buf-delay Buffer delay (in frames). Longer delays\n" + " allow smoother rate adaptation and provide\n" + " better overall quality, but require more\n" + " client side buffering and add latency. The\n" + " default value is the keyframe interval for\n" + " one-pass encoding (or somewhat larger if\n" + " --soft-target is used) and infinite for\n" + " two-pass encoding.\n" + " -b --begin-time Begin encoding at offset into input\n" + " -e --end-time End encoding at offset into input\n" + "encoder_example accepts only uncompressed RIFF WAV format audio and\n" + "YUV4MPEG2 uncompressed video.\n\n"); + exit(1); +} + +static int y4m_parse_tags(char *_tags){ + int got_w; + int got_h; + int got_fps; + int got_interlace; + int got_par; + int got_chroma; + int tmp_video_fps_n; + int tmp_video_fps_d; + int tmp_video_par_n; + int tmp_video_par_d; + char *p; + char *q; + got_w=got_h=got_fps=got_interlace=got_par=got_chroma=0; + for(p=_tags;;p=q){ + /*Skip any leading spaces.*/ + while(*p==' ')p++; + /*If that's all we have, stop.*/ + if(p[0]=='\0')break; + /*Find the end of this tag.*/ + for(q=p+1;*q!='\0'&&*q!=' ';q++); + /*Process the tag.*/ + switch(p[0]){ + case 'W':{ + if(sscanf(p+1,"%d",&pic_w)!=1)return -1; + got_w=1; + }break; + case 'H':{ + if(sscanf(p+1,"%d",&pic_h)!=1)return -1; + got_h=1; + }break; + case 'F':{ + if(sscanf(p+1,"%d:%d",&tmp_video_fps_n,&tmp_video_fps_d)!=2)return -1; + got_fps=1; + }break; + case 'I':{ + interlace=p[1]; + got_interlace=1; + }break; + case 'A':{ + if(sscanf(p+1,"%d:%d",&tmp_video_par_n,&tmp_video_par_d)!=2)return -1; + got_par=1; + }break; + case 'C':{ + if(q-p>16)return -1; + memcpy(chroma_type,p+1,q-p-1); + chroma_type[q-p-1]='\0'; + got_chroma=1; + }break; + /*Ignore unknown tags.*/ + } + } + if(!got_w||!got_h||!got_fps||!got_interlace||!got_par)return -1; + /*Chroma-type is not specified in older files, e.g., those generated by + mplayer.*/ + if(!got_chroma)strcpy(chroma_type,"420"); + /*Update fps and aspect ratio globals if not specified in the command line.*/ + if(video_fps_n==-1)video_fps_n=tmp_video_fps_n; + if(video_fps_d==-1)video_fps_d=tmp_video_fps_d; + if(video_par_n==-1)video_par_n=tmp_video_par_n; + if(video_par_d==-1)video_par_d=tmp_video_par_d; + return 0; +} + +/*All anti-aliasing filters in the following conversion functions are based on + one of two window functions: + The 6-tap Lanczos window (for down-sampling and shifts): + sinc(\pi*t)*sinc(\pi*t/3), |t|<3 (sinc(t)==sin(t)/t) + 0, |t|>=3 + The 4-tap Mitchell window (for up-sampling): + 7|t|^3-12|t|^2+16/3, |t|<1 + -(7/3)|x|^3+12|x|^2-20|x|+32/3, |t|<2 + 0, |t|>=2 + The number of taps is intentionally kept small to reduce computational + overhead and limit ringing. + + The taps from these filters are scaled so that their sum is 1, and the result + is scaled by 128 and rounded to integers to create a filter whose + intermediate values fit inside 16 bits. + Coefficients are rounded in such a way as to ensure their sum is still 128, + which is usually equivalent to normal rounding.*/ + +#define OC_MINI(_a,_b) ((_a)>(_b)?(_b):(_a)) +#define OC_MAXI(_a,_b) ((_a)<(_b)?(_b):(_a)) +#define OC_CLAMPI(_a,_b,_c) (OC_MAXI(_a,OC_MINI(_b,_c))) + +/*420jpeg chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + 420mpeg2 chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + BR | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + BR | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + We use a resampling filter to shift the site locations one quarter pixel (at + the chroma plane's resolution) to the right. + The 4:2:2 modes look exactly the same, except there are twice as many chroma + lines, and they are vertically co-sited with the luma samples in both the + mpeg2 and jpeg cases (thus requiring no vertical resampling).*/ +static void y4m_convert_42xmpeg2_42xjpeg(unsigned char *_dst, + unsigned char *_aux){ + int c_w; + int c_h; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=pic_w*pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(pic_w+dst_c_dec_h-1)/dst_c_dec_h; + c_h=(pic_h+dst_c_dec_v-1)/dst_c_dec_v; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + } + for(;x>7,255); + } + for(;x>7,255); + } + _dst+=c_w; + _aux+=c_w; + } + } +} + +/*This format is only used for interlaced content, but is included for + completeness. + + 420jpeg chroma samples are sited like: + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | BR | | BR | + | | | | + Y-------Y-------Y-------Y------- + | | | | + | | | | + | | | | + + 420paldv chroma samples are sited like: + YR------Y-------YR------Y------- + | | | | + | | | | + | | | | + YB------Y-------YB------Y------- + | | | | + | | | | + | | | | + YR------Y-------YR------Y------- + | | | | + | | | | + | | | | + YB------Y-------YB------Y------- + | | | | + | | | | + | | | | + + We use a resampling filter to shift the site locations one quarter pixel (at + the chroma plane's resolution) to the right. + Then we use another filter to move the C_r location down one quarter pixel, + and the C_b location up one quarter pixel.*/ +static void y4m_convert_42xpaldv_42xjpeg(unsigned char *_dst, + unsigned char *_aux){ + unsigned char *tmp; + int c_w; + int c_h; + int c_sz; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=pic_w*pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(pic_w+1)/2; + c_h=(pic_h+dst_c_dec_h-1)/dst_c_dec_h; + c_sz=c_w*c_h; + /*First do the horizontal re-sampling. + This is the same as the mpeg2 case, except that after the horizontal case, + we need to apply a second vertical filter.*/ + tmp=_aux+2*c_sz; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + } + for(;x>7,255); + } + for(;x>7,255); + } + tmp+=c_w; + _aux+=c_w; + } + switch(pli){ + case 1:{ + tmp-=c_sz; + /*Slide C_b up a quarter-pel. + This is the same filter used above, but in the other order.*/ + for(x=0;x>7,255); + } + for(;y>7,255); + } + for(;y>7,255); + } + _dst++; + tmp++; + } + _dst+=c_sz-c_w; + tmp-=c_w; + }break; + case 2:{ + tmp-=c_sz; + /*Slide C_r down a quarter-pel. + This is the same as the horizontal filter.*/ + for(x=0;x>7,255); + } + for(;y>7,255); + } + for(;y>7,255); + } + _dst++; + tmp++; + } + }break; + } + /*For actual interlaced material, this would have to be done separately on + each field, and the shift amounts would be different. + C_r moves down 1/8, C_b up 3/8 in the top field, and C_r moves down 3/8, + C_b up 1/8 in the bottom field. + The corresponding filters would be: + Down 1/8 (reverse order for up): [3 -11 125 15 -4 0]/128 + Down 3/8 (reverse order for up): [4 -19 98 56 -13 2]/128*/ + } +} + +/*422jpeg chroma samples are sited like: + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + Y---BR--Y-------Y---BR--Y------- + | | | | + | | | | + | | | | + + 411 chroma samples are sited like: + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + YBR-----Y-------Y-------Y------- + | | | | + | | | | + | | | | + + We use a filter to resample at site locations one eighth pixel (at the source + chroma plane's horizontal resolution) and five eighths of a pixel to the + right.*/ +static void y4m_convert_411_422jpeg(unsigned char *_dst, + unsigned char *_aux){ + int c_w; + int dst_c_w; + int c_h; + int pli; + int y; + int x; + /*Skip past the luma data.*/ + _dst+=pic_w*pic_h; + /*Compute the size of each chroma plane.*/ + c_w=(pic_w+src_c_dec_h-1)/src_c_dec_h; + dst_c_w=(pic_w+dst_c_dec_h-1)/dst_c_dec_h; + c_h=(pic_h+dst_c_dec_v-1)/dst_c_dec_v; + for(pli=1;pli<3;pli++){ + for(y=0;y>7,255); + _dst[x<<1|1]=(unsigned char)OC_CLAMPI(0,47*_aux[0]+ + 86*_aux[OC_MINI(1,c_w-1)]-5*_aux[OC_MINI(2,c_w-1)]+64>>7,255); + } + for(;x>7,255); + _dst[x<<1|1]=(unsigned char)OC_CLAMPI(0,-3*_aux[x-1]+50*_aux[x]+ + 86*_aux[x+1]-5*_aux[x+2]+64>>7,255); + } + for(;x>7,255); + if((x<<1|1)>7,255); + } + } + _dst+=dst_c_w; + _aux+=c_w; + } + } +} + +/*The image is padded with empty chroma components at 4:2:0. + This costs about 17 bits a frame to code.*/ +static void y4m_convert_mono_420jpeg(unsigned char *_dst, + unsigned char *_aux){ + int c_sz; + _dst+=pic_w*pic_h; + c_sz=((pic_w+dst_c_dec_h-1)/dst_c_dec_h)*((pic_h+dst_c_dec_v-1)/dst_c_dec_v); + memset(_dst,128,c_sz*2); +} + +#if 0 +/*Right now just 444 to 420. + Not too hard to generalize.*/ +static void y4m_convert_4xxjpeg_42xjpeg(unsigned char *_dst, + unsigned char *_aux){ + unsigned char *tmp; + int c_w; + int c_h; + int pic_sz; + int tmp_sz; + int c_sz; + int pli; + int y; + int x; + /*Compute the size of each chroma plane.*/ + c_w=(pic_w+dst_c_dec_h-1)/dst_c_dec_h; + c_h=(pic_h+dst_c_dec_v-1)/dst_c_dec_v; + pic_sz=pic_w*pic_h; + tmp_sz=c_w*pic_h; + c_sz=c_w*c_h; + _dst+=pic_sz; + for(pli=1;pli<3;pli++){ + tmp=_aux+pic_sz; + /*In reality, the horizontal and vertical steps could be pipelined, for + less memory consumption and better cache performance, but we do them + separately for simplicity.*/ + /*First do horizontal filtering (convert to 4:2:2)*/ + /*Filter: [3 -17 78 78 -17 3]/128, derived from a 6-tap Lanczos window.*/ + for(y=0;y>1]=OC_CLAMPI(0,64*_aux[0]+78*_aux[OC_MINI(1,pic_w-1)]- + 17*_aux[OC_MINI(2,pic_w-1)]+3*_aux[OC_MINI(3,pic_w-1)]+64>>7,255); + } + for(;x>1]=OC_CLAMPI(0,3*(_aux[x-2]+_aux[x+3])-17*(_aux[x-1]+_aux[x+2])+ + 78*(_aux[x]+_aux[x+1])+64>>7,255); + } + for(;x>1]=OC_CLAMPI(0,3*(_aux[x-2]+_aux[pic_w-1])- + 17*(_aux[x-1]+_aux[OC_MINI(x+2,pic_w-1)])+ + 78*(_aux[x]+_aux[OC_MINI(x+1,pic_w-1)])+64>>7,255); + } + tmp+=c_w; + _aux+=pic_w; + } + _aux-=pic_sz; + tmp-=tmp_sz; + /*Now do the vertical filtering.*/ + for(x=0;x>1)*c_w]=OC_CLAMPI(0,64*tmp[0]+78*tmp[OC_MINI(1,pic_h-1)*c_w]- + 17*tmp[OC_MINI(2,pic_h-1)*c_w]+3*tmp[OC_MINI(3,pic_h-1)*c_w]+ + 64>>7,255); + } + for(;y>1)*c_w]=OC_CLAMPI(0,3*(tmp[(y-2)*c_w]+tmp[(y+3)*c_w])- + 17*(tmp[(y-1)*c_w]+tmp[(y+2)*c_w])+78*(tmp[y*c_w]+tmp[(y+1)*c_w])+ + 64>>7,255); + } + for(;y>1)*c_w]=OC_CLAMPI(0,3*(tmp[(y-2)*c_w]+tmp[(pic_h-1)*c_w])- + 17*(tmp[(y-1)*c_w]+tmp[OC_MINI(y+2,pic_h-1)*c_w])+ + 78*(tmp[y*c_w]+tmp[OC_MINI(y+1,pic_h-1)*c_w])+64>>7,255); + } + tmp++; + _dst++; + } + _dst-=c_w; + } +} +#endif + + +/*No conversion function needed.*/ +static void y4m_convert_null(unsigned char *_dst, + unsigned char *_aux){ +} + +static void id_file(char *f){ + FILE *test; + unsigned char buffer[80]; + int ret; + + /* open it, look for magic */ + + if(!strcmp(f,"-")){ + /* stdin */ + test=stdin; + }else{ + test=fopen(f,"rb"); + if(!test){ + fprintf(stderr,"Unable to open file %s.\n",f); + exit(1); + } + } + + ret=fread(buffer,1,4,test); + if(ret<4){ + fprintf(stderr,"EOF determining file type of file %s.\n",f); + exit(1); + } + + if(!memcmp(buffer,"RIFF",4)){ + /* possible WAV file */ + + if(audio){ + /* umm, we already have one */ + fprintf(stderr,"Multiple RIFF WAVE files specified on command line.\n"); + exit(1); + } + + /* Parse the rest of the header */ + + ret=fread(buffer,1,8,test); + if(ret<8)goto riff_err; + if(!memcmp(buffer+4,"WAVE",4)){ + + while(!feof(test)){ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + if(!memcmp("fmt",buffer,3)){ + + /* OK, this is our audio specs chunk. Slurp it up. */ + + ret=fread(buffer,1,20,test); + if(ret<20)goto riff_err; + + if(memcmp(buffer+4,"\001\000",2)){ + fprintf(stderr,"The WAV file %s is in a compressed format; " + "can't read it.\n",f); + exit(1); + } + + audio=test; + audio_ch=buffer[6]+(buffer[7]<<8); + audio_hz=buffer[8]+(buffer[9]<<8)+ + (buffer[10]<<16)+(buffer[11]<<24); + + if(buffer[18]+(buffer[19]<<8)!=16){ + fprintf(stderr,"Can only read 16 bit WAV files for now.\n"); + exit(1); + } + + /* Now, align things to the beginning of the data */ + /* Look for 'dataxxxx' */ + while(!feof(test)){ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + if(!memcmp("data",buffer,4)){ + /* We're there. Ignore the declared size for now. */ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + + fprintf(stderr,"File %s is 16 bit %d channel %d Hz RIFF WAV audio.\n", + f,audio_ch,audio_hz); + + return; + } + } + } + } + } + + fprintf(stderr,"Couldn't find WAVE data in RIFF file %s.\n",f); + exit(1); + + } + if(!memcmp(buffer,"YUV4",4)){ + /* possible YUV2MPEG2 format file */ + /* read until newline, or 80 cols, whichever happens first */ + int i; + for(i=0;i<79;i++){ + ret=fread(buffer+i,1,1,test); + if(ret<1)goto yuv_err; + if(buffer[i]=='\n')break; + } + if(i==79){ + fprintf(stderr,"Error parsing %s header; not a YUV2MPEG2 file?\n",f); + } + buffer[i]='\0'; + + if(!memcmp(buffer,"MPEG",4)){ + + if(video){ + /* umm, we already have one */ + fprintf(stderr,"Multiple video files specified on command line.\n"); + exit(1); + } + + if(buffer[4]!='2'){ + fprintf(stderr,"Incorrect YUV input file version; YUV4MPEG2 required.\n"); + } + + ret=y4m_parse_tags((char *)buffer+5); + if(ret<0){ + fprintf(stderr,"Error parsing YUV4MPEG2 header in file %s.\n",f); + exit(1); + } + + if(interlace!='p'){ + fprintf(stderr,"Input video is interlaced; Theora handles only progressive scan\n"); + exit(1); + } + + if(strcmp(chroma_type,"420")==0||strcmp(chroma_type,"420jpeg")==0){ + src_c_dec_h=dst_c_dec_h=src_c_dec_v=dst_c_dec_v=2; + y4m_dst_buf_read_sz=pic_w*pic_h+2*((pic_w+1)/2)*((pic_h+1)/2); + /*Natively supported: no conversion required.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=0; + y4m_convert=y4m_convert_null; + } + else if(strcmp(chroma_type,"420mpeg2")==0){ + src_c_dec_h=dst_c_dec_h=src_c_dec_v=dst_c_dec_v=2; + y4m_dst_buf_read_sz=pic_w*pic_h; + /*Chroma filter required: read into the aux buf first.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=2*((pic_w+1)/2)*((pic_h+1)/2); + y4m_convert=y4m_convert_42xmpeg2_42xjpeg; + } + else if(strcmp(chroma_type,"420paldv")==0){ + src_c_dec_h=dst_c_dec_h=src_c_dec_v=dst_c_dec_v=2; + y4m_dst_buf_read_sz=pic_w*pic_h; + /*Chroma filter required: read into the aux buf first. + We need to make two filter passes, so we need some extra space in the + aux buffer.*/ + y4m_aux_buf_sz=3*((pic_w+1)/2)*((pic_h+1)/2); + y4m_aux_buf_read_sz=2*((pic_w+1)/2)*((pic_h+1)/2); + y4m_convert=y4m_convert_42xpaldv_42xjpeg; + } + else if(strcmp(chroma_type,"422")==0){ + src_c_dec_h=dst_c_dec_h=2; + src_c_dec_v=dst_c_dec_v=1; + y4m_dst_buf_read_sz=pic_w*pic_h; + /*Chroma filter required: read into the aux buf first.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=2*((pic_w+1)/2)*pic_h; + y4m_convert=y4m_convert_42xmpeg2_42xjpeg; + } + else if(strcmp(chroma_type,"422jpeg")==0){ + src_c_dec_h=dst_c_dec_h=2; + src_c_dec_v=dst_c_dec_v=1; + y4m_dst_buf_read_sz=pic_w*pic_h+2*((pic_w+1)/2)*pic_h; + /*Natively supported: no conversion required.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=0; + y4m_convert=y4m_convert_null; + } + else if(strcmp(chroma_type,"411")==0){ + src_c_dec_h=4; + /*We don't want to introduce any additional sub-sampling, so we + promote 4:1:1 material to 4:2:2, as the closest format Theora can + handle.*/ + dst_c_dec_h=2; + src_c_dec_v=dst_c_dec_v=1; + y4m_dst_buf_read_sz=pic_w*pic_h; + /*Chroma filter required: read into the aux buf first.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=2*((pic_w+3)/4)*pic_h; + y4m_convert=y4m_convert_411_422jpeg; + } + else if(strcmp(chroma_type,"444")==0){ + src_c_dec_h=dst_c_dec_h=src_c_dec_v=dst_c_dec_v=1; + y4m_dst_buf_read_sz=pic_w*pic_h*3; + y4m_aux_buf_sz=y4m_aux_buf_read_sz=0; + y4m_convert=y4m_convert_null; + } + else if(strcmp(chroma_type,"444alpha")==0){ + src_c_dec_h=dst_c_dec_h=src_c_dec_v=dst_c_dec_v=1; + y4m_dst_buf_read_sz=pic_w*pic_h*3; + /*Read the extra alpha plane into the aux buf. + It will be discarded.*/ + y4m_aux_buf_sz=y4m_aux_buf_read_sz=pic_w*pic_h; + y4m_convert=y4m_convert_null; + } + else if(strcmp(chroma_type,"mono")==0){ + src_c_dec_h=src_c_dec_v=0; + dst_c_dec_h=dst_c_dec_v=2; + y4m_dst_buf_read_sz=pic_w*pic_h; + y4m_aux_buf_sz=y4m_aux_buf_read_sz=0; + y4m_convert=y4m_convert_mono_420jpeg; + } + else{ + fprintf(stderr,"Unknown chroma sampling type: %s\n",chroma_type); + exit(1); + } + /*The size of the final frame buffers is always computed from the + destination chroma decimation type.*/ + y4m_dst_buf_sz=pic_w*pic_h+2*((pic_w+dst_c_dec_h-1)/dst_c_dec_h)* + ((pic_h+dst_c_dec_v-1)/dst_c_dec_v); + + video=test; + + fprintf(stderr,"File %s is %dx%d %.02f fps %s video.\n", + f,pic_w,pic_h,(double)video_fps_n/video_fps_d,chroma_type); + + return; + } + } + fprintf(stderr,"Input file %s is neither a WAV nor YUV4MPEG2 file.\n",f); + exit(1); + + riff_err: + fprintf(stderr,"EOF parsing RIFF file %s.\n",f); + exit(1); + yuv_err: + fprintf(stderr,"EOF parsing YUV4MPEG2 file %s.\n",f); + exit(1); + +} + +int spinner=0; +char *spinascii="|/-\\"; +void spinnit(void){ + spinner++; + if(spinner==4)spinner=0; + fprintf(stderr,"\r%c",spinascii[spinner]); +} + +int fetch_and_process_audio(FILE *audio,ogg_page *audiopage, + ogg_stream_state *vo, + vorbis_dsp_state *vd, + vorbis_block *vb, + int audioflag){ + static ogg_int64_t samples_sofar=0; + ogg_packet op; + int i,j; + ogg_int64_t beginsample = audio_hz*begin_sec + audio_hz*begin_usec*.000001; + ogg_int64_t endsample = audio_hz*end_sec + audio_hz*end_usec*.000001; + + while(audio && !audioflag){ + /* process any audio already buffered */ + spinnit(); + if(ogg_stream_pageout(vo,audiopage)>0) return 1; + if(ogg_stream_eos(vo))return 0; + + { + /* read and process more audio */ + signed char readbuffer[4096]; + signed char *readptr=readbuffer; + int toread=4096/2/audio_ch; + int bytesread=fread(readbuffer,1,toread*2*audio_ch,audio); + int sampread=bytesread/2/audio_ch; + float **vorbis_buffer; + int count=0; + + if(bytesread<=0 || + (samples_sofar>=endsample && endsample>0)){ + /* end of file. this can be done implicitly, but it's + easier to see here in non-clever fashion. Tell the + library we're at end of stream so that it can handle the + last frame and mark end of stream in the output properly */ + vorbis_analysis_wrote(vd,0); + }else{ + if(samples_sofar < beginsample){ + if(samples_sofar+sampread > beginsample){ + readptr += (beginsample-samples_sofar)*2*audio_ch; + sampread += samples_sofar-beginsample; + samples_sofar = sampread+beginsample; + }else{ + samples_sofar += sampread; + sampread = 0; + } + }else{ + samples_sofar += sampread; + } + + if(samples_sofar > endsample && endsample > 0) + sampread-= (samples_sofar - endsample); + + if(sampread>0){ + + vorbis_buffer=vorbis_analysis_buffer(vd,sampread); + /* uninterleave samples */ + for(i=0;i=beginframe) + frame_state++; + } + /* check to see if there are dupes to flush */ + if(th_encode_packetout(td,frame_state<1,op)>0)return 1; + if(frame_state<1){ + /* can't get here unless YUV4MPEG stream has no video */ + fprintf(stderr,"Video input contains no frames.\n"); + exit(1); + } + /* Theora is a one-frame-in,one-frame-out system; submit a frame + for compression and pull out the packet */ + /* in two-pass mode's second pass, we need to submit first-pass data */ + if(passno==2){ + for(;;){ + static unsigned char buffer[80]; + static int buf_pos; + int bytes; + /*Ask the encoder how many bytes it would like.*/ + bytes=th_encode_ctl(td,TH_ENCCTL_2PASS_IN,NULL,0); + if(bytes<0){ + fprintf(stderr,"Error submitting pass data in second pass.\n"); + exit(1); + } + /*If it's got enough, stop.*/ + if(bytes==0)break; + /*Read in some more bytes, if necessary.*/ + if(bytes>80-buf_pos)bytes=80-buf_pos; + if(bytes>0&&fread(buffer+buf_pos,1,bytes,twopass_file)=bytes)buf_pos=0; + /*Otherwise remember how much it used.*/ + else buf_pos+=ret; + } + } + /*We submit the buffer using the size of the picture region. + libtheora will pad the picture region out to the full frame size for us, + whether we pass in a full frame or not.*/ + ycbcr[0].width=pic_w; + ycbcr[0].height=pic_h; + ycbcr[0].stride=pic_w; + ycbcr[0].data=yuvframe[0]; + ycbcr[1].width=c_w; + ycbcr[1].height=c_h; + ycbcr[1].stride=c_w; + ycbcr[1].data=yuvframe[0]+pic_sz; + ycbcr[2].width=c_w; + ycbcr[2].height=c_h; + ycbcr[2].stride=c_w; + ycbcr[2].data=yuvframe[0]+pic_sz+c_sz; + th_encode_ycbcr_in(td,ycbcr); + { + unsigned char *temp=yuvframe[0]; + yuvframe[0]=yuvframe[1]; + yuvframe[1]=temp; + frame_state--; + } + /* in two-pass mode's first pass we need to extract and save the pass data */ + if(passno==1){ + unsigned char *buffer; + int bytes = th_encode_ctl(td, TH_ENCCTL_2PASS_OUT, &buffer, sizeof(buffer)); + if(bytes<0){ + fprintf(stderr,"Could not read two-pass data from encoder.\n"); + exit(1); + } + if(fwrite(buffer,1,bytes,twopass_file)0) return 1; + if(ogg_stream_eos(to)) return 0; + ret=fetch_and_process_video_packet(video,twopass_file,passno,td,&op); + if(ret<=0)return 0; + ogg_stream_packetin(to,&op); + } + return videoflag; +} + +static int ilog(unsigned _v){ + int ret; + for(ret=0;_v;ret++)_v>>=1; + return ret; +} + +int main(int argc,char *argv[]){ + int c,long_option_index,ret; + + ogg_stream_state to; /* take physical pages, weld into a logical + stream of packets */ + ogg_stream_state vo; /* take physical pages, weld into a logical + stream of packets */ + ogg_page og; /* one Ogg bitstream page. Vorbis packets are inside */ + ogg_packet op; /* one raw packet of data for decode */ + + th_enc_ctx *td; + th_info ti; + th_comment tc; + + vorbis_info vi; /* struct that stores all the static vorbis bitstream + settings */ + vorbis_comment vc; /* struct that stores all the user comments */ + + vorbis_dsp_state vd; /* central working state for the packet->PCM decoder */ + vorbis_block vb; /* local working space for packet->PCM decode */ + + int speed=-1; + int audioflag=0; + int videoflag=0; + int akbps=0; + int vkbps=0; + int soft_target=0; + + ogg_int64_t audio_bytesout=0; + ogg_int64_t video_bytesout=0; + double timebase; + + FILE *outfile = stdout; + + FILE *twopass_file = NULL; + fpos_t video_rewind_pos; + int twopass=0; + int passno; + +#ifdef _WIN32 /* We need to set stdin/stdout to binary mode. Damn windows. */ + /* if we were reading/writing a file, it would also need to in + binary mode, eg, fopen("file.wav","wb"); */ + /* Beware the evil ifdef. We avoid these where we can, but this one we + cannot. Don't add any more, you'll probably go to hell if you do. */ + _setmode( _fileno( stdin ), _O_BINARY ); + _setmode( _fileno( stdout ), _O_BINARY ); +#endif + + while((c=getopt_long(argc,argv,optstring,options,&long_option_index))!=EOF){ + switch(c){ + case 'o': + outfile=fopen(optarg,"wb"); + if(outfile==NULL){ + fprintf(stderr,"Unable to open output file '%s'\n", optarg); + exit(1); + } + break;; + + case 'a': + audio_q=(float)(atof(optarg)*.099); + if(audio_q<-.1 || audio_q>1){ + fprintf(stderr,"Illegal audio quality (choose -1 through 10)\n"); + exit(1); + } + audio_r=-1; + break; + + case 'v': + video_q=(int)rint(6.3*atof(optarg)); + if(video_q<0 || video_q>63){ + fprintf(stderr,"Illegal video quality (choose 0 through 10)\n"); + exit(1); + } + break; + + case 'A': + audio_r=(int)(atof(optarg)*1000); + if(audio_q<0){ + fprintf(stderr,"Illegal audio quality (choose > 0 please)\n"); + exit(1); + } + audio_q=-99; + break; + + case 'V': + video_r=(int)rint(atof(optarg)*1000); + if(video_r<1){ + fprintf(stderr,"Illegal video bitrate (choose > 0 please)\n"); + exit(1); + } + break; + + case '\1': + soft_target=1; + break; + + case 's': + video_par_n=(int)rint(atof(optarg)); + break; + + case 'S': + video_par_d=(int)rint(atof(optarg)); + break; + + case 'f': + video_fps_n=(int)rint(atof(optarg)); + break; + + case 'F': + video_fps_d=(int)rint(atof(optarg)); + break; + + case 'c': + vp3_compatible=1; + break; + + case 'k': + keyframe_frequency=rint(atof(optarg)); + if(keyframe_frequency<1 || keyframe_frequency>2147483647){ + fprintf(stderr,"Illegal keyframe frequency\n"); + exit(1); + } + break; + + case 'd': + buf_delay=atoi(optarg); + if(buf_delay<=0){ + fprintf(stderr,"Illegal buffer delay\n"); + exit(1); + } + break; + + case 'z': + speed=atoi(optarg); + if(speed<0){ + fprintf(stderr,"Illegal speed level\n"); + exit(1); + } + break; + + case 'b': + { + char *pos=strchr(optarg,':'); + begin_sec=atol(optarg); + if(pos){ + char *pos2=strchr(++pos,':'); + begin_sec*=60; + begin_sec+=atol(pos); + if(pos2){ + pos2++; + begin_sec*=60; + begin_sec+=atol(pos2); + pos=pos2; + } + }else + pos=optarg; + pos=strchr(pos,'.'); + if(pos){ + int digits = strlen(++pos); + begin_usec=atol(pos); + while(digits++ < 6) + begin_usec*=10; + } + } + break; + case 'e': + { + char *pos=strchr(optarg,':'); + end_sec=atol(optarg); + if(pos){ + char *pos2=strchr(++pos,':'); + end_sec*=60; + end_sec+=atol(pos); + if(pos2){ + pos2++; + end_sec*=60; + end_sec+=atol(pos2); + pos=pos2; + } + }else + pos=optarg; + pos=strchr(pos,'.'); + if(pos){ + int digits = strlen(++pos); + end_usec=atol(pos); + while(digits++ < 6) + end_usec*=10; + } + } + break; + case '\2': + twopass=3; /* perform both passes */ + twopass_file=tmpfile(); + if(!twopass_file){ + fprintf(stderr,"Unable to open temporary file for twopass data\n"); + exit(1); + } + break; + case '\3': + twopass=1; /* perform first pass */ + twopass_file=fopen(optarg,"wb"); + if(!twopass_file){ + fprintf(stderr,"Unable to open \'%s\' for twopass data\n",optarg); + exit(1); + } + break; + case '\4': + twopass=2; /* perform second pass */ + twopass_file=fopen(optarg,"rb"); + if(!twopass_file){ + fprintf(stderr,"Unable to open twopass data file \'%s\'",optarg); + exit(1); + } + break; + + default: + usage(); + } + } + + if(soft_target){ + if(video_r<=0){ + fprintf(stderr,"Soft rate target (--soft-target) requested without a bitrate (-V).\n"); + exit(1); + } + if(video_q==-1) + video_q=0; + }else{ + if(video_q==-1){ + if(video_r>0) + video_q=0; + else + video_q=48; + } + } + + if(keyframe_frequency<=0){ + /*Use a default keyframe frequency of 64 for 1-pass (streaming) mode, and + 256 for two-pass mode.*/ + keyframe_frequency=twopass?256:64; + } + + while(optind-99) + ret = vorbis_encode_init_vbr(&vi,audio_ch,audio_hz,audio_q); + else + ret = vorbis_encode_init(&vi,audio_ch,audio_hz,-1, + (int)(64870*(ogg_int64_t)audio_r>>16),-1); + if(ret){ + fprintf(stderr,"The Vorbis encoder could not set up a mode according to\n" + "the requested quality or bitrate.\n\n"); + exit(1); + } + + vorbis_comment_init(&vc); + vorbis_analysis_init(&vd,&vi); + vorbis_block_init(&vd,&vb); + } + + for(passno=(twopass==3?1:twopass);passno<=(twopass==3?2:twopass);passno++){ + /* Set up Theora encoder */ + if(!video){ + fprintf(stderr,"No video files submitted for compression?\n"); + exit(1); + } + /* Theora has a divisible-by-sixteen restriction for the encoded frame size */ + /* scale the picture size up to the nearest /16 and calculate offsets */ + frame_w=pic_w+15&~0xF; + frame_h=pic_h+15&~0xF; + /*Force the offsets to be even so that chroma samples line up like we + expect.*/ + pic_x=frame_w-pic_w>>1&~1; + pic_y=frame_h-pic_h>>1&~1; + th_info_init(&ti); + ti.frame_width=frame_w; + ti.frame_height=frame_h; + ti.pic_width=pic_w; + ti.pic_height=pic_h; + ti.pic_x=pic_x; + ti.pic_y=pic_y; + ti.fps_numerator=video_fps_n; + ti.fps_denominator=video_fps_d; + ti.aspect_numerator=video_par_n; + ti.aspect_denominator=video_par_d; + ti.colorspace=TH_CS_UNSPECIFIED; + /*Account for the Ogg page overhead. + This is 1 byte per 255 for lacing values, plus 26 bytes per 4096 bytes for + the page header, plus approximately 1/2 byte per packet (not accounted for + here).*/ + ti.target_bitrate=(int)(64870*(ogg_int64_t)video_r>>16); + ti.quality=video_q; + ti.keyframe_granule_shift=ilog(keyframe_frequency-1); + if(dst_c_dec_h==2){ + if(dst_c_dec_v==2)ti.pixel_fmt=TH_PF_420; + else ti.pixel_fmt=TH_PF_422; + } + else ti.pixel_fmt=TH_PF_444; + td=th_encode_alloc(&ti); + th_info_clear(&ti); + /* setting just the granule shift only allows power-of-two keyframe + spacing. Set the actual requested spacing. */ + ret=th_encode_ctl(td,TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE, + &keyframe_frequency,sizeof(keyframe_frequency-1)); + if(ret<0){ + fprintf(stderr,"Could not set keyframe interval to %d.\n",(int)keyframe_frequency); + } + if(vp3_compatible){ + ret=th_encode_ctl(td,TH_ENCCTL_SET_VP3_COMPATIBLE,&vp3_compatible, + sizeof(vp3_compatible)); + if(ret<0||!vp3_compatible){ + fprintf(stderr,"Could not enable strict VP3 compatibility.\n"); + if(ret>=0){ + fprintf(stderr,"Ensure your source format is supported by VP3.\n"); + fprintf(stderr, + "(4:2:0 pixel format, width and height multiples of 16).\n"); + } + } + } + if(soft_target){ + /* reverse the rate control flags to favor a 'long time' strategy */ + int arg = TH_RATECTL_CAP_UNDERFLOW; + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_FLAGS,&arg,sizeof(arg)); + if(ret<0) + fprintf(stderr,"Could not set encoder flags for --soft-target\n"); + /* Default buffer control is overridden on two-pass */ + if(!twopass&&buf_delay<0){ + if((keyframe_frequency*7>>1) > 5*video_fps_n/video_fps_d) + arg=keyframe_frequency*7>>1; + else + arg=5*video_fps_n/video_fps_d; + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_BUFFER,&arg,sizeof(arg)); + if(ret<0) + fprintf(stderr,"Could not set rate control buffer for --soft-target\n"); + } + } + /* set up two-pass if needed */ + if(passno==1){ + unsigned char *buffer; + int bytes; + bytes=th_encode_ctl(td,TH_ENCCTL_2PASS_OUT,&buffer,sizeof(buffer)); + if(bytes<0){ + fprintf(stderr,"Could not set up the first pass of two-pass mode.\n"); + fprintf(stderr,"Did you remember to specify an estimated bitrate?\n"); + exit(1); + } + /*Perform a seek test to ensure we can overwrite this placeholder data at + the end; this is better than letting the user sit through a whole + encode only to find out their pass 1 file is useless at the end.*/ + if(fseek(twopass_file,0,SEEK_SET)<0){ + fprintf(stderr,"Unable to seek in two-pass data file.\n"); + exit(1); + } + if(fwrite(buffer,1,bytes,twopass_file)=0){ + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_BUFFER, + &buf_delay,sizeof(buf_delay)); + if(ret<0){ + fprintf(stderr,"Warning: could not set desired buffer delay.\n"); + } + } + /*Speed should also be set after the current encoder mode is established, + since the available speed levels may change depending.*/ + if(speed>=0){ + int speed_max; + int ret; + ret=th_encode_ctl(td,TH_ENCCTL_GET_SPLEVEL_MAX, + &speed_max,sizeof(speed_max)); + if(ret<0){ + fprintf(stderr,"Warning: could not determine maximum speed level.\n"); + speed_max=0; + } + ret=th_encode_ctl(td,TH_ENCCTL_SET_SPLEVEL,&speed,sizeof(speed)); + if(ret<0){ + fprintf(stderr,"Warning: could not set speed level to %i of %i\n", + speed,speed_max); + if(speed>speed_max){ + fprintf(stderr,"Setting it to %i instead\n",speed_max); + } + ret=th_encode_ctl(td,TH_ENCCTL_SET_SPLEVEL, + &speed_max,sizeof(speed_max)); + if(ret<0){ + fprintf(stderr,"Warning: could not set speed level to %i of %i\n", + speed_max,speed_max); + } + } + } + /* write the bitstream header packets with proper page interleave */ + th_comment_init(&tc); + /* first packet will get its own page automatically */ + if(th_encode_flushheader(td,&tc,&op)<=0){ + fprintf(stderr,"Internal Theora library error.\n"); + exit(1); + } + if(passno!=1){ + ogg_stream_packetin(&to,&op); + if(ogg_stream_pageout(&to,&og)!=1){ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + } + /* create the remaining theora headers */ + for(;;){ + ret=th_encode_flushheader(td,&tc,&op); + if(ret<0){ + fprintf(stderr,"Internal Theora library error.\n"); + exit(1); + } + else if(!ret)break; + if(passno!=1)ogg_stream_packetin(&to,&op); + } + if(audio && passno!=1){ + ogg_packet header; + ogg_packet header_comm; + ogg_packet header_code; + vorbis_analysis_headerout(&vd,&vc,&header,&header_comm,&header_code); + ogg_stream_packetin(&vo,&header); /* automatically placed in its own + page */ + if(ogg_stream_pageout(&vo,&og)!=1){ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + /* remaining vorbis header packets */ + ogg_stream_packetin(&vo,&header_comm); + ogg_stream_packetin(&vo,&header_code); + } + /* Flush the rest of our headers. This ensures + the actual data in each stream will start + on a new page, as per spec. */ + if(passno!=1){ + for(;;){ + int result = ogg_stream_flush(&to,&og); + if(result<0){ + /* can't get here */ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + if(result==0)break; + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + } + } + if(audio && passno!=1){ + for(;;){ + int result=ogg_stream_flush(&vo,&og); + if(result<0){ + /* can't get here */ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + if(result==0)break; + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + } + } + /* setup complete. Raw processing loop */ + switch(passno){ + case 0: case 2: + fprintf(stderr,"\rCompressing.... \n"); + break; + case 1: + fprintf(stderr,"\rScanning first pass.... \n"); + break; + } + for(;;){ + int audio_or_video=-1; + if(passno==1){ + ogg_packet op; + int ret=fetch_and_process_video_packet(video,twopass_file,passno,td,&op); + if(ret<0)break; + if(op.e_o_s)break; /* end of stream */ + timebase=th_granule_time(td,op.granulepos); + audio_or_video=1; + }else{ + double audiotime; + double videotime; + ogg_page audiopage; + ogg_page videopage; + /* is there an audio page flushed? If not, fetch one if possible */ + audioflag=fetch_and_process_audio(audio,&audiopage,&vo,&vd,&vb,audioflag); + /* is there a video page flushed? If not, fetch one if possible */ + videoflag=fetch_and_process_video(video,&videopage,&to,td,twopass_file,passno,videoflag); + /* no pages of either? Must be end of stream. */ + if(!audioflag && !videoflag)break; + /* which is earlier; the end of the audio page or the end of the + video page? Flush the earlier to stream */ + audiotime= + audioflag?vorbis_granule_time(&vd,ogg_page_granulepos(&audiopage)):-1; + videotime= + videoflag?th_granule_time(td,ogg_page_granulepos(&videopage)):-1; + if(!audioflag){ + audio_or_video=1; + } else if(!videoflag) { + audio_or_video=0; + } else { + if(audiotime 0){ + int hundredths=(int)(timebase*100-(long)timebase*100); + int seconds=(long)timebase%60; + int minutes=((long)timebase/60)%60; + int hours=(long)timebase/3600; + if(audio_or_video)vkbps=(int)rint(video_bytesout*8./timebase*.001); + else akbps=(int)rint(audio_bytesout*8./timebase*.001); + fprintf(stderr, + "\r %d:%02d:%02d.%02d audio: %dkbps video: %dkbps ", + hours,minutes,seconds,hundredths,akbps,vkbps); + } + } + if(video)th_encode_free(td); + } + + /* clear out state */ + if(audio && twopass!=1){ + ogg_stream_clear(&vo); + vorbis_block_clear(&vb); + vorbis_dsp_clear(&vd); + vorbis_comment_clear(&vc); + vorbis_info_clear(&vi); + if(audio!=stdin)fclose(audio); + } + if(video){ + ogg_stream_clear(&to); + th_comment_clear(&tc); + if(video!=stdin)fclose(video); + } + + if(outfile && outfile!=stdout)fclose(outfile); + if(twopass_file)fclose(twopass_file); + + fprintf(stderr,"\r \ndone.\n\n"); + + return(0); + +} diff --git a/libs/libtheora-1.1/examples/getopt.c b/libs/libtheora-1.1/examples/getopt.c new file mode 100644 index 00000000..b75e3c62 --- /dev/null +++ b/libs/libtheora-1.1/examples/getopt.c @@ -0,0 +1,1055 @@ +/* Getopt for GNU. + NOTE: getopt is now part of the C library, so if you don't know what + "Keep this file name-space clean" means, talk to drepper@gnu.org + before changing it! + Copyright (C) 1987,88,89,90,91,92,93,94,95,96,98,99,2000,2001 + Free Software Foundation, Inc. + This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with the GNU C Library; if not, write to the Free + Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA + 02111-1307 USA. */ + +/* This tells Alpha OSF/1 not to define a getopt prototype in . + Ditto for AIX 3.2 and . */ +#ifndef _NO_PROTO +# define _NO_PROTO +#endif + +#ifdef HAVE_CONFIG_H +# include +#endif + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems + reject `defined (const)'. */ +# ifndef const +# define const +# endif +#endif + +#include + +/* Comment out all this code if we are using the GNU C Library, and are not + actually compiling the library itself. This code is part of the GNU C + Library, but also included in many other GNU distributions. Compiling + and linking in this code is a waste when using the GNU C library + (especially if it is a shared library). Rather than having every GNU + program understand `configure --with-gnu-libc' and omit the object files, + it is simpler to just do this in the source for each such file. */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +# include +# if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +# define ELIDE_CODE +# endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include + to get __GNU_LIBRARY__ defined. */ +#ifdef __GNU_LIBRARY__ +/* Don't include stdlib.h for non-GNU C libraries because some of them + contain conflicting prototypes for getopt. */ +# include +# include +#endif /* GNU C library. */ + +#ifdef VMS +# include +# if HAVE_STRING_H - 0 +# include +# endif +#endif + +#ifndef _ +/* This is for other GNU distributions with internationalized messages. */ +# if defined HAVE_LIBINTL_H || defined _LIBC +# include +# ifndef _ +# define _(msgid) gettext (msgid) +# endif +# else +# define _(msgid) (msgid) +# endif +#endif + +/* This version of `getopt' appears to the caller like standard Unix `getopt' + but it behaves differently for the user, since it allows the user + to intersperse the options with the other arguments. + + As `getopt' works, it permutes the elements of ARGV so that, + when it is done, all the options precede everything else. Thus + all application programs are extended to handle flexible argument order. + + Setting the environment variable POSIXLY_CORRECT disables permutation. + Then the behavior is completely standard. + + GNU application programs can use a third alternative mode in which + they can distinguish the relative order of options and other arguments. */ + +#include "getopt.h" + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +/* 1003.2 says this must be 1 before any call. */ +int optind = 1; + +/* Formerly, initialization of getopt depended on optind==0, which + causes problems with re-calling getopt as programs generally don't + know that. */ + +int __getopt_initialized; + +/* The next char to be scanned in the option-element + in which the last option character we returned was found. + This allows us to pick up the scan where we left off. + + If this is zero, or a null string, it means resume the scan + by advancing to the next ARGV-element. */ + +static char *nextchar; + +/* Callers store zero here to inhibit the error message + for unrecognized options. */ + +int opterr = 1; + +/* Set to an option character which was unrecognized. + This must be initialized on some systems to avoid linking in the + system's own getopt implementation. */ + +int optopt = '?'; + +/* Describe how to deal with options that follow non-option ARGV-elements. + + If the caller did not specify anything, + the default is REQUIRE_ORDER if the environment variable + POSIXLY_CORRECT is defined, PERMUTE otherwise. + + REQUIRE_ORDER means don't recognize them as options; + stop option processing when the first non-option is seen. + This is what Unix does. + This mode of operation is selected by either setting the environment + variable POSIXLY_CORRECT, or using `+' as the first character + of the list of option characters. + + PERMUTE is the default. We permute the contents of ARGV as we scan, + so that eventually all the non-options are at the end. This allows options + to be given in any order, even with programs that were not written to + expect this. + + RETURN_IN_ORDER is an option available to programs that were written + to expect options and other ARGV-elements in any order and that care about + the ordering of the two. We describe each non-option ARGV-element + as if it were the argument of an option with character code 1. + Using `-' as the first character of the list of option characters + selects this mode of operation. + + The special argument `--' forces an end of option-scanning regardless + of the value of `ordering'. In the case of RETURN_IN_ORDER, only + `--' can cause `getopt' to return -1 with `optind' != ARGC. */ + +static enum +{ + REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER +} ordering; + +/* Value of POSIXLY_CORRECT environment variable. */ +static char *posixly_correct; + +#ifdef __GNU_LIBRARY__ +/* We want to avoid inclusion of string.h with non-GNU libraries + because there are many ways it can cause trouble. + On some systems, it contains special magic macros that don't work + in GCC. */ +# include +# define my_index strchr +#else + +# if HAVE_STRING_H +# include +# else +# include +# endif + +/* Avoid depending on library functions or files + whose names are inconsistent. */ + +#ifndef getenv +extern char *getenv (); +#endif + +static char * +my_index (str, chr) + const char *str; + int chr; +{ + while (*str) + { + if (*str == chr) + return (char *) str; + str++; + } + return 0; +} + +/* If using GCC, we can safely declare strlen this way. + If not using GCC, it is ok not to declare it. */ +#ifdef __GNUC__ +/* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h. + That was relevant to code that was here before. */ +# if (!defined __STDC__ || !__STDC__) && !defined strlen +/* gcc with -traditional declares the built-in strlen to return int, + and has done so at least since version 2.4.5. -- rms. */ +extern int strlen (const char *); +# endif /* not __STDC__ */ +#endif /* __GNUC__ */ + +#endif /* not __GNU_LIBRARY__ */ + +/* Handle permutation of arguments. */ + +/* Describe the part of ARGV that contains non-options that have + been skipped. `first_nonopt' is the index in ARGV of the first of them; + `last_nonopt' is the index after the last of them. */ + +static int first_nonopt; +static int last_nonopt; + +#ifdef _LIBC +/* Stored original parameters. + XXX This is no good solution. We should rather copy the args so + that we can compare them later. But we must not use malloc(3). */ +extern int __libc_argc; +extern char **__libc_argv; + +/* Bash 2.0 gives us an environment variable containing flags + indicating ARGV elements that should not be considered arguments. */ + +# ifdef USE_NONOPTION_FLAGS +/* Defined in getopt_init.c */ +extern char *__getopt_nonoption_flags; + +static int nonoption_flags_max_len; +static int nonoption_flags_len; +# endif + +# ifdef USE_NONOPTION_FLAGS +# define SWAP_FLAGS(ch1, ch2) \ + if (nonoption_flags_len > 0) \ + { \ + char __tmp = __getopt_nonoption_flags[ch1]; \ + __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2]; \ + __getopt_nonoption_flags[ch2] = __tmp; \ + } +# else +# define SWAP_FLAGS(ch1, ch2) +# endif +#else /* !_LIBC */ +# define SWAP_FLAGS(ch1, ch2) +#endif /* _LIBC */ + +/* Exchange two adjacent subsequences of ARGV. + One subsequence is elements [first_nonopt,last_nonopt) + which contains all the non-options that have been skipped so far. + The other is elements [last_nonopt,optind), which contains all + the options processed since those non-options were skipped. + + `first_nonopt' and `last_nonopt' are relocated so that they describe + the new indices of the non-options in ARGV after they are moved. */ + +#if defined __STDC__ && __STDC__ +static void exchange (char **); +#endif + +static void +exchange (argv) + char **argv; +{ + int bottom = first_nonopt; + int middle = last_nonopt; + int top = optind; + char *tem; + + /* Exchange the shorter segment with the far end of the longer segment. + That puts the shorter segment into the right place. + It leaves the longer segment in the right place overall, + but it consists of two parts that need to be swapped next. */ + +#if defined _LIBC && defined USE_NONOPTION_FLAGS + /* First make sure the handling of the `__getopt_nonoption_flags' + string can work normally. Our top argument must be in the range + of the string. */ + if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len) + { + /* We must extend the array. The user plays games with us and + presents new arguments. */ + char *new_str = malloc (top + 1); + if (new_str == NULL) + nonoption_flags_len = nonoption_flags_max_len = 0; + else + { + memset (__mempcpy (new_str, __getopt_nonoption_flags, + nonoption_flags_max_len), + '\0', top + 1 - nonoption_flags_max_len); + nonoption_flags_max_len = top + 1; + __getopt_nonoption_flags = new_str; + } + } +#endif + + while (top > middle && middle > bottom) + { + if (top - middle > middle - bottom) + { + /* Bottom segment is the short one. */ + int len = middle - bottom; + register int i; + + /* Swap it with the top part of the top segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[top - (middle - bottom) + i]; + argv[top - (middle - bottom) + i] = tem; + SWAP_FLAGS (bottom + i, top - (middle - bottom) + i); + } + /* Exclude the moved bottom segment from further swapping. */ + top -= len; + } + else + { + /* Top segment is the short one. */ + int len = top - middle; + register int i; + + /* Swap it with the bottom part of the bottom segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[middle + i]; + argv[middle + i] = tem; + SWAP_FLAGS (bottom + i, middle + i); + } + /* Exclude the moved top segment from further swapping. */ + bottom += len; + } + } + + /* Update records for the slots the non-options now occupy. */ + + first_nonopt += (optind - last_nonopt); + last_nonopt = optind; +} + +/* Initialize the internal data when the first call is made. */ + +#if defined __STDC__ && __STDC__ +static const char *_getopt_initialize (int, char *const *, const char *); +#endif +static const char * +_getopt_initialize (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + /* Start processing options with ARGV-element 1 (since ARGV-element 0 + is the program name); the sequence of previously skipped + non-option ARGV-elements is empty. */ + + first_nonopt = last_nonopt = optind; + + nextchar = NULL; + + posixly_correct = getenv ("POSIXLY_CORRECT"); + + /* Determine how to handle the ordering of options and nonoptions. */ + + if (optstring[0] == '-') + { + ordering = RETURN_IN_ORDER; + ++optstring; + } + else if (optstring[0] == '+') + { + ordering = REQUIRE_ORDER; + ++optstring; + } + else if (posixly_correct != NULL) + ordering = REQUIRE_ORDER; + else + ordering = PERMUTE; + +#if defined _LIBC && defined USE_NONOPTION_FLAGS + if (posixly_correct == NULL + && argc == __libc_argc && argv == __libc_argv) + { + if (nonoption_flags_max_len == 0) + { + if (__getopt_nonoption_flags == NULL + || __getopt_nonoption_flags[0] == '\0') + nonoption_flags_max_len = -1; + else + { + const char *orig_str = __getopt_nonoption_flags; + int len = nonoption_flags_max_len = strlen (orig_str); + if (nonoption_flags_max_len < argc) + nonoption_flags_max_len = argc; + __getopt_nonoption_flags = + (char *) malloc (nonoption_flags_max_len); + if (__getopt_nonoption_flags == NULL) + nonoption_flags_max_len = -1; + else + memset (__mempcpy (__getopt_nonoption_flags, orig_str, len), + '\0', nonoption_flags_max_len - len); + } + } + nonoption_flags_len = nonoption_flags_max_len; + } + else + nonoption_flags_len = 0; +#endif + + return optstring; +} + +/* Scan elements of ARGV (whose length is ARGC) for option characters + given in OPTSTRING. + + If an element of ARGV starts with '-', and is not exactly "-" or "--", + then it is an option element. The characters of this element + (aside from the initial '-') are option characters. If `getopt' + is called repeatedly, it returns successively each of the option characters + from each of the option elements. + + If `getopt' finds another option character, it returns that character, + updating `optind' and `nextchar' so that the next call to `getopt' can + resume the scan with the following option character or ARGV-element. + + If there are no more option characters, `getopt' returns -1. + Then `optind' is the index in ARGV of the first ARGV-element + that is not an option. (The ARGV-elements have been permuted + so that those that are not options now come last.) + + OPTSTRING is a string containing the legitimate option characters. + If an option character is seen that is not listed in OPTSTRING, + return '?' after printing an error message. If you set `opterr' to + zero, the error message is suppressed but we still return '?'. + + If a char in OPTSTRING is followed by a colon, that means it wants an arg, + so the following text in the same ARGV-element, or the text of the following + ARGV-element, is returned in `optarg'. Two colons mean an option that + wants an optional arg; if there is text in the current ARGV-element, + it is returned in `optarg', otherwise `optarg' is set to zero. + + If OPTSTRING starts with `-' or `+', it requests different methods of + handling the non-option ARGV-elements. + See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above. + + Long-named options begin with `--' instead of `-'. + Their names may be abbreviated as long as the abbreviation is unique + or is an exact match for some defined option. If they have an + argument, it follows the option name in the same ARGV-element, separated + from the option name by a `=', or else the in next ARGV-element. + When `getopt' finds a long-named option, it returns 0 if that option's + `flag' field is nonzero, the value of the option's `val' field + if the `flag' field is zero. + + The elements of ARGV aren't really const, because we permute them. + But we pretend they're const in the prototype to be compatible + with other systems. + + LONGOPTS is a vector of `struct option' terminated by an + element containing a name which is zero. + + LONGIND returns the index in LONGOPT of the long-named option found. + It is only valid when a long-named option has been found by the most + recent call. + + If LONG_ONLY is nonzero, '-' as well as '--' can introduce + long-named options. */ + +int +_getopt_internal (argc, argv, optstring, longopts, longind, long_only) + int argc; + char *const *argv; + const char *optstring; + const struct option *longopts; + int *longind; + int long_only; +{ + int print_errors = opterr; + if (optstring[0] == ':') + print_errors = 0; + + if (argc < 1) + return -1; + + optarg = NULL; + + if (optind == 0 || !__getopt_initialized) + { + if (optind == 0) + optind = 1; /* Don't scan ARGV[0], the program name. */ + optstring = _getopt_initialize (argc, argv, optstring); + __getopt_initialized = 1; + } + + /* Test whether ARGV[optind] points to a non-option argument. + Either it does not have option syntax, or there is an environment flag + from the shell indicating it is not an option. The later information + is only used when the used in the GNU libc. */ +#if defined _LIBC && defined USE_NONOPTION_FLAGS +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0' \ + || (optind < nonoption_flags_len \ + && __getopt_nonoption_flags[optind] == '1')) +#else +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0') +#endif + + if (nextchar == NULL || *nextchar == '\0') + { + /* Advance to the next ARGV-element. */ + + /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been + moved back by the user (who may also have changed the arguments). */ + if (last_nonopt > optind) + last_nonopt = optind; + if (first_nonopt > optind) + first_nonopt = optind; + + if (ordering == PERMUTE) + { + /* If we have just processed some options following some non-options, + exchange them so that the options come first. */ + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (last_nonopt != optind) + first_nonopt = optind; + + /* Skip any additional non-options + and extend the range of non-options previously skipped. */ + + while (optind < argc && NONOPTION_P) + optind++; + last_nonopt = optind; + } + + /* The special ARGV-element `--' means premature end of options. + Skip it like a null option, + then exchange with previous non-options as if it were an option, + then skip everything else like a non-option. */ + + if (optind != argc && !strcmp (argv[optind], "--")) + { + optind++; + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (first_nonopt == last_nonopt) + first_nonopt = optind; + last_nonopt = argc; + + optind = argc; + } + + /* If we have done all the ARGV-elements, stop the scan + and back over any non-options that we skipped and permuted. */ + + if (optind == argc) + { + /* Set the next-arg-index to point at the non-options + that we previously skipped, so the caller will digest them. */ + if (first_nonopt != last_nonopt) + optind = first_nonopt; + return -1; + } + + /* If we have come to a non-option and did not permute it, + either stop the scan or describe it to the caller and pass it by. */ + + if (NONOPTION_P) + { + if (ordering == REQUIRE_ORDER) + return -1; + optarg = argv[optind++]; + return 1; + } + + /* We have found another option-ARGV-element. + Skip the initial punctuation. */ + + nextchar = (argv[optind] + 1 + + (longopts != NULL && argv[optind][1] == '-')); + } + + /* Decode the current option-ARGV-element. */ + + /* Check whether the ARGV-element is a long option. + + If long_only and the ARGV-element has the form "-f", where f is + a valid short option, don't consider it an abbreviated form of + a long option that starts with f. Otherwise there would be no + way to give the -f short option. + + On the other hand, if there's a long option "fubar" and + the ARGV-element is "-fu", do consider that an abbreviation of + the long option, just like "--fu", and not "-f" with arg "u". + + This distinction seems to be the most useful approach. */ + + if (longopts != NULL + && (argv[optind][1] == '-' + || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1]))))) + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = -1; + int option_index; + + for (nameend = nextchar; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) + == (unsigned int) strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else if (long_only + || pfound->has_arg != p->has_arg + || pfound->flag != p->flag + || pfound->val != p->val) + /* Second or later nonexact match found. */ + ambig = 1; + } + + if (ambig && !exact) + { + if (print_errors) + fprintf (stderr, _("%s: option `%s' is ambiguous\n"), + argv[0], argv[optind]); + nextchar += strlen (nextchar); + optind++; + optopt = 0; + return '?'; + } + + if (pfound != NULL) + { + option_index = indfound; + optind++; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (print_errors) + { + if (argv[optind - 1][1] == '-') + /* --option */ + fprintf (stderr, + _("%s: option `--%s' doesn't allow an argument\n"), + argv[0], pfound->name); + else + /* +option or -option */ + fprintf (stderr, + _("%s: option `%c%s' doesn't allow an argument\n"), + argv[0], argv[optind - 1][0], pfound->name); + } + + nextchar += strlen (nextchar); + + optopt = pfound->val; + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (print_errors) + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + nextchar += strlen (nextchar); + optopt = pfound->val; + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + + /* Can't find it as a long option. If this is not getopt_long_only, + or the option starts with '--' or is not a valid short + option, then it's an error. + Otherwise interpret it as a short option. */ + if (!long_only || argv[optind][1] == '-' + || my_index (optstring, *nextchar) == NULL) + { + if (print_errors) + { + if (argv[optind][1] == '-') + /* --option */ + fprintf (stderr, _("%s: unrecognized option `--%s'\n"), + argv[0], nextchar); + else + /* +option or -option */ + fprintf (stderr, _("%s: unrecognized option `%c%s'\n"), + argv[0], argv[optind][0], nextchar); + } + nextchar = (char *) ""; + optind++; + optopt = 0; + return '?'; + } + } + + /* Look at and handle the next short option-character. */ + + { + char c = *nextchar++; + char *temp = my_index (optstring, c); + + /* Increment `optind' when we start to process its last character. */ + if (*nextchar == '\0') + ++optind; + + if (temp == NULL || c == ':') + { + if (print_errors) + { + if (posixly_correct) + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, _("%s: illegal option -- %c\n"), + argv[0], c); + else + fprintf (stderr, _("%s: invalid option -- %c\n"), + argv[0], c); + } + optopt = c; + return '?'; + } + /* Convenience. Treat POSIX -W foo same as long option --foo */ + if (temp[0] == 'W' && temp[1] == ';') + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = 0; + int option_index; + + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (print_errors) + { + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, _("%s: option requires an argument -- %c\n"), + argv[0], c); + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + return c; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + + /* optarg is now the argument, see if it's in the + table of longopts. */ + + for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) == strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else + /* Second or later nonexact match found. */ + ambig = 1; + } + if (ambig && !exact) + { + if (print_errors) + fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"), + argv[0], argv[optind]); + nextchar += strlen (nextchar); + optind++; + return '?'; + } + if (pfound != NULL) + { + option_index = indfound; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (print_errors) + fprintf (stderr, _("\ +%s: option `-W %s' doesn't allow an argument\n"), + argv[0], pfound->name); + + nextchar += strlen (nextchar); + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (print_errors) + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + nextchar += strlen (nextchar); + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + nextchar = NULL; + return 'W'; /* Let the application handle it. */ + } + if (temp[1] == ':') + { + if (temp[2] == ':') + { + /* This is an option that accepts an argument optionally. */ + if (*nextchar != '\0') + { + optarg = nextchar; + optind++; + } + else + optarg = NULL; + nextchar = NULL; + } + else + { + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (print_errors) + { + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, + _("%s: option requires an argument -- %c\n"), + argv[0], c); + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + nextchar = NULL; + } + } + return c; + } +} + +int +getopt (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + return _getopt_internal (argc, argv, optstring, + (const struct option *) 0, + (int *) 0, + 0); +} + +#endif /* Not ELIDE_CODE. */ + +#ifdef TEST + +/* Compile with -DTEST to make an executable for use in testing + the above definition of `getopt'. */ + +int +main (argc, argv) + int argc; + char **argv; +{ + int c; + int digit_optind = 0; + + while (1) + { + int this_option_optind = optind ? optind : 1; + + c = getopt (argc, argv, "abc:d:0123456789"); + if (c == -1) + break; + + switch (c) + { + case '0': + case '1': + case '2': + case '3': + case '4': + case '5': + case '6': + case '7': + case '8': + case '9': + if (digit_optind != 0 && digit_optind != this_option_optind) + printf ("digits occur in two different argv-elements.\n"); + digit_optind = this_option_optind; + printf ("option %c\n", c); + break; + + case 'a': + printf ("option a\n"); + break; + + case 'b': + printf ("option b\n"); + break; + + case 'c': + printf ("option c with value `%s'\n", optarg); + break; + + case '?': + break; + + default: + printf ("?? getopt returned character code 0%o ??\n", c); + } + } + + if (optind < argc) + { + printf ("non-option ARGV-elements: "); + while (optind < argc) + printf ("%s ", argv[optind++]); + printf ("\n"); + } + + exit (0); +} + +#endif /* TEST */ diff --git a/libs/libtheora-1.1/examples/getopt.h b/libs/libtheora-1.1/examples/getopt.h new file mode 100644 index 00000000..74d0d2b6 --- /dev/null +++ b/libs/libtheora-1.1/examples/getopt.h @@ -0,0 +1,180 @@ +/* Declarations for getopt. + Copyright (C) 1989-1994, 1996-1999, 2001 Free Software Foundation, Inc. + This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with the GNU C Library; if not, write to the Free + Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA + 02111-1307 USA. */ + +#ifndef _GETOPT_H + +#ifndef __need_getopt +# define _GETOPT_H 1 +#endif + +/* If __GNU_LIBRARY__ is not already defined, either we are being used + standalone, or this is the first header included in the source file. + If we are being used with glibc, we need to include , but + that does not exist if we are standalone. So: if __GNU_LIBRARY__ is + not defined, include , which will pull in for us + if it's from glibc. (Why ctype.h? It's guaranteed to exist and it + doesn't flood the namespace with stuff the way some other headers do.) */ +#if !defined __GNU_LIBRARY__ +# include +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +extern char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +extern int optind; + +/* Callers store zero here to inhibit the error message `getopt' prints + for unrecognized options. */ + +extern int opterr; + +/* Set to an option character which was unrecognized. */ + +extern int optopt; + +#ifndef __need_getopt +/* Describe the long-named options requested by the application. + The LONG_OPTIONS argument to getopt_long or getopt_long_only is a vector + of `struct option' terminated by an element containing a name which is + zero. + + The field `has_arg' is: + no_argument (or 0) if the option does not take an argument, + required_argument (or 1) if the option requires an argument, + optional_argument (or 2) if the option takes an optional argument. + + If the field `flag' is not NULL, it points to a variable that is set + to the value given in the field `val' when the option is found, but + left unchanged if the option is not found. + + To have a long-named option do something other than set an `int' to + a compiled-in constant, such as set a value from `optarg', set the + option's `flag' field to zero and its `val' field to a nonzero + value (the equivalent single-letter option character, if there is + one). For long options that have a zero `flag' field, `getopt' + returns the contents of the `val' field. */ + +struct option +{ +# if (defined __STDC__ && __STDC__) || defined __cplusplus + const char *name; +# else + char *name; +# endif + /* has_arg can't be an enum because some compilers complain about + type mismatches in all the code that assumes it is an int. */ + int has_arg; + int *flag; + int val; +}; + +/* Names for the values of the `has_arg' field of `struct option'. */ + +# define no_argument 0 +# define required_argument 1 +# define optional_argument 2 +#endif /* need getopt */ + + +/* Get definitions and prototypes for functions to process the + arguments in ARGV (ARGC of them, minus the program name) for + options given in OPTS. + + Return the option character from OPTS just read. Return -1 when + there are no more options. For unrecognized options, or options + missing arguments, `optopt' is set to the option letter, and '?' is + returned. + + The OPTS string is a list of characters which are recognized option + letters, optionally followed by colons, specifying that that letter + takes an argument, to be placed in `optarg'. + + If a letter in OPTS is followed by two colons, its argument is + optional. This behavior is specific to the GNU `getopt'. + + The argument `--' causes premature termination of argument + scanning, explicitly telling `getopt' that there are no more + options. + + If OPTS begins with `--', then non-option arguments are treated as + arguments to the option '\0'. This behavior is specific to the GNU + `getopt'. */ + +#if (defined __STDC__ && __STDC__) || defined __cplusplus +# ifdef __GNU_LIBRARY__ +/* Many other libraries have conflicting prototypes for getopt, with + differences in the consts, in stdlib.h. To avoid compilation + errors, only prototype getopt for the GNU C library. */ +extern int getopt (int __argc, char *const *__argv, const char *__shortopts); +# else /* not __GNU_LIBRARY__ */ +extern int getopt (); +# endif /* __GNU_LIBRARY__ */ + +# ifndef __need_getopt +extern int getopt_long (int __argc, char *const *__argv, const char *__shortopts, + const struct option *__longopts, int *__longind); +extern int getopt_long_only (int __argc, char *const *__argv, + const char *__shortopts, + const struct option *__longopts, int *__longind); + +/* Internal only. Users should not call this directly. */ +extern int _getopt_internal (int __argc, char *const *__argv, + const char *__shortopts, + const struct option *__longopts, int *__longind, + int __long_only); +# endif +#else /* not __STDC__ */ +extern int getopt (); +# ifndef __need_getopt +extern int getopt_long (); +extern int getopt_long_only (); + +extern int _getopt_internal (); +# endif +#endif /* __STDC__ */ + +#ifdef __cplusplus +} +#endif + +/* Make sure we later can get all the definitions and declarations. */ +#undef __need_getopt + +#endif /* getopt.h */ diff --git a/libs/libtheora-1.1/examples/getopt1.c b/libs/libtheora-1.1/examples/getopt1.c new file mode 100644 index 00000000..15448919 --- /dev/null +++ b/libs/libtheora-1.1/examples/getopt1.c @@ -0,0 +1,188 @@ +/* getopt_long and getopt_long_only entry points for GNU getopt. + Copyright (C) 1987,88,89,90,91,92,93,94,96,97,98 + Free Software Foundation, Inc. + This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with the GNU C Library; if not, write to the Free + Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA + 02111-1307 USA. */ + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include "getopt.h" + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems + reject `defined (const)'. */ +#ifndef const +#define const +#endif +#endif + +#include + +/* Comment out all this code if we are using the GNU C Library, and are not + actually compiling the library itself. This code is part of the GNU C + Library, but also included in many other GNU distributions. Compiling + and linking in this code is a waste when using the GNU C library + (especially if it is a shared library). Rather than having every GNU + program understand `configure --with-gnu-libc' and omit the object files, + it is simpler to just do this in the source for each such file. */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +#include +#if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +#define ELIDE_CODE +#endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include + to get __GNU_LIBRARY__ defined. */ +#ifdef __GNU_LIBRARY__ +#include +#endif + +#ifndef NULL +#define NULL 0 +#endif + +int +getopt_long (argc, argv, options, long_options, opt_index) + int argc; + char *const *argv; + const char *options; + const struct option *long_options; + int *opt_index; +{ + return _getopt_internal (argc, argv, options, long_options, opt_index, 0); +} + +/* Like getopt_long, but '-' as well as '--' can indicate a long option. + If an option that starts with '-' (not '--') doesn't match a long option, + but does match a short option, it is parsed as a short option + instead. */ + +int +getopt_long_only (argc, argv, options, long_options, opt_index) + int argc; + char *const *argv; + const char *options; + const struct option *long_options; + int *opt_index; +{ + return _getopt_internal (argc, argv, options, long_options, opt_index, 1); +} + + +#endif /* Not ELIDE_CODE. */ + +#ifdef TEST + +#include + +int +main (argc, argv) + int argc; + char **argv; +{ + int c; + int digit_optind = 0; + + while (1) + { + int this_option_optind = optind ? optind : 1; + int option_index = 0; + static struct option long_options[] = + { + {"add", 1, 0, 0}, + {"append", 0, 0, 0}, + {"delete", 1, 0, 0}, + {"verbose", 0, 0, 0}, + {"create", 0, 0, 0}, + {"file", 1, 0, 0}, + {0, 0, 0, 0} + }; + + c = getopt_long (argc, argv, "abc:d:0123456789", + long_options, &option_index); + if (c == -1) + break; + + switch (c) + { + case 0: + printf ("option %s", long_options[option_index].name); + if (optarg) + printf (" with arg %s", optarg); + printf ("\n"); + break; + + case '0': + case '1': + case '2': + case '3': + case '4': + case '5': + case '6': + case '7': + case '8': + case '9': + if (digit_optind != 0 && digit_optind != this_option_optind) + printf ("digits occur in two different argv-elements.\n"); + digit_optind = this_option_optind; + printf ("option %c\n", c); + break; + + case 'a': + printf ("option a\n"); + break; + + case 'b': + printf ("option b\n"); + break; + + case 'c': + printf ("option c with value `%s'\n", optarg); + break; + + case 'd': + printf ("option d with value `%s'\n", optarg); + break; + + case '?': + break; + + default: + printf ("?? getopt returned character code 0%o ??\n", c); + } + } + + if (optind < argc) + { + printf ("non-option ARGV-elements: "); + while (optind < argc) + printf ("%s ", argv[optind++]); + printf ("\n"); + } + + exit (0); +} + +#endif /* TEST */ diff --git a/libs/libtheora-1.1/examples/player_example.c b/libs/libtheora-1.1/examples/player_example.c new file mode 100644 index 00000000..60a81435 --- /dev/null +++ b/libs/libtheora-1.1/examples/player_example.c @@ -0,0 +1,887 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: example SDL player application; plays Ogg Theora files (with + optional Vorbis audio second stream) + last mod: $Id: player_example.c 17974 2011-05-07 22:31:49Z giles $ + + ********************************************************************/ + +/* far more complex than most Ogg 'example' programs. The complexity + of maintaining A/V sync is pretty much unavoidable. It's necessary + to actually have audio/video playback to make the hard audio clock + sync actually work. If there's audio playback, there might as well + be simple video playback as well... + + A simple 'demux and write back streams' would have been easier, + it's true. */ + +#if !defined(_GNU_SOURCE) +#define _GNU_SOURCE +#endif +#if !defined(_LARGEFILE_SOURCE) +#define _LARGEFILE_SOURCE +#endif +#if !defined(_LARGEFILE64_SOURCE) +#define _LARGEFILE64_SOURCE +#endif +#if !defined(_FILE_OFFSET_BITS) +#define _FILE_OFFSET_BITS 64 +#endif + +#ifdef HAVE_CONFIG_H +# include +#endif + +#ifndef _REENTRANT +# define _REENTRANT +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include "theora/theoradec.h" +#include "vorbis/codec.h" +#include + +/* yes, this makes us OSS-specific for now. None of SDL, libao, libao2 + give us any way to determine hardware timing, and since the + hard/kernel buffer is going to be most of or > a second, that's + just a little bit important */ +#if defined(__FreeBSD__) +#include +#define AUDIO_DEVICE "/dev/audio" +#elif defined(__NetBSD__) || defined(__OpenBSD__) +#include +#define AUDIO_DEVICE "/dev/audio" +#else +#include +#define AUDIO_DEVICE "/dev/dsp" +#endif +#include + +/* Helper; just grab some more compressed bitstream and sync it for + page extraction */ +int buffer_data(FILE *in,ogg_sync_state *oy){ + char *buffer=ogg_sync_buffer(oy,4096); + int bytes=fread(buffer,1,4096,in); + ogg_sync_wrote(oy,bytes); + return(bytes); +} + +/* never forget that globals are a one-way ticket to Hell */ +/* Ogg and codec state for demux/decode */ +ogg_sync_state oy; +ogg_page og; +ogg_stream_state vo; +ogg_stream_state to; +th_info ti; +th_comment tc; +th_dec_ctx *td; +th_setup_info *ts; +vorbis_info vi; +vorbis_dsp_state vd; +vorbis_block vb; +vorbis_comment vc; +th_pixel_fmt px_fmt; + +int theora_p=0; +int vorbis_p=0; +int stateflag=0; + +/* SDL Video playback structures */ +SDL_Surface *screen; +SDL_Overlay *yuv_overlay; +SDL_Rect rect; +unsigned char *RGBbuffer; + +#define OC_CLAMP255(_x) ((unsigned char)((((_x)<0)-1)&((_x)|-((_x)>255)))) + +/* single frame video buffering */ +int videobuf_ready=0; +ogg_int64_t videobuf_granulepos=-1; +double videobuf_time=0; + +/* single audio fragment audio buffering */ +int audiobuf_fill=0; +int audiobuf_ready=0; +ogg_int16_t *audiobuf; +ogg_int64_t audiobuf_granulepos=0; /* time position of last sample */ + +/* audio / video synchronization tracking: + +Since this will make it to Google at some point and lots of people +search for how to do this, a quick rundown of a practical A/V sync +strategy under Linux [the UNIX where Everything Is Hard]. Naturally, +this works on other platforms using OSS for sound as well. + +In OSS, we don't have reliable access to any precise information on +the exact current playback position (that, of course would have been +too easy; the kernel folks like to keep us app people working hard +doing simple things that should have been solved once and abstracted +long ago). Hopefully ALSA solves this a little better; we'll probably +use that once ALSA is the standard in the stable kernel. + +We can't use the system clock for a/v sync because audio is hard +synced to its own clock, and both the system and audio clocks suffer +from wobble, drift, and a lack of accuracy that can be guaranteed to +add a reliable percent or so of error. After ten seconds, that's +100ms. We can't drift by half a second every minute. + +Although OSS can't generally tell us where the audio playback pointer +is, we do know that if we work in complete audio fragments and keep +the kernel buffer full, a blocking select on the audio buffer will +give us a writable fragment immediately after playback finishes with +it. We assume at that point that we know the exact number of bytes in +the kernel buffer that have not been played (total fragments minus +one) and calculate clock drift between audio and system then (and only +then). Damp the sync correction fraction, apply, and walla: A +reliable A/V clock that even works if it's interrupted. */ + +long audiofd_totalsize=-1; +int audiofd_fragsize; /* read and write only complete fragments + so that SNDCTL_DSP_GETOSPACE is + accurate immediately after a bank + switch */ +int audiofd=-1; +ogg_int64_t audiofd_timer_calibrate=-1; + + +static void open_audio(){ + audio_buf_info info; + int format=AFMT_S16_NE; /* host endian */ + int channels=vi.channels; + int rate=vi.rate; + int ret; + + audiofd=open(AUDIO_DEVICE,O_RDWR); + if(audiofd<0){ + fprintf(stderr,"Could not open audio device " AUDIO_DEVICE ".\n"); + exit(1); + } + + ret=ioctl(audiofd,SNDCTL_DSP_SETFMT,&format); + if(ret){ + fprintf(stderr,"Could not set 16 bit host-endian playback\n"); + exit(1); + } + + ret=ioctl(audiofd,SNDCTL_DSP_CHANNELS,&channels); + if(ret){ + fprintf(stderr,"Could not set %d channel playback\n",channels); + exit(1); + } + + ret=ioctl(audiofd,SNDCTL_DSP_SPEED,&rate); + if(ret){ + fprintf(stderr,"Could not set %d Hz playback\n",rate); + exit(1); + } + + ioctl(audiofd,SNDCTL_DSP_GETOSPACE,&info); + audiofd_fragsize=info.fragsize; + audiofd_totalsize=info.fragstotal*info.fragsize; + + audiobuf=malloc(audiofd_fragsize); +} + +static void audio_close(void){ + if(audiofd>-1){ + ioctl(audiofd,SNDCTL_DSP_RESET,NULL); + close(audiofd); + free(audiobuf); + } +} + +/* call this only immediately after unblocking from a full kernel + having a newly empty fragment or at the point of DMA restart */ +void audio_calibrate_timer(int restart){ + struct timeval tv; + ogg_int64_t current_sample; + ogg_int64_t new_time; + + gettimeofday(&tv,0); + new_time=tv.tv_sec*1000+tv.tv_usec/1000; + + if(restart){ + current_sample=audiobuf_granulepos-audiobuf_fill/2/vi.channels; + }else + current_sample=audiobuf_granulepos- + (audiobuf_fill+audiofd_totalsize-audiofd_fragsize)/2/vi.channels; + + new_time-=1000*current_sample/vi.rate; + + audiofd_timer_calibrate=new_time; +} + +/* get relative time since beginning playback, compensating for A/V + drift */ +double get_time(){ + static ogg_int64_t last=0; + static ogg_int64_t up=0; + ogg_int64_t now; + struct timeval tv; + + gettimeofday(&tv,0); + now=tv.tv_sec*1000+tv.tv_usec/1000; + + if(audiofd_timer_calibrate==-1)audiofd_timer_calibrate=last=now; + + if(audiofd<0){ + /* no audio timer to worry about, we can just use the system clock */ + /* only one complication: If the process is suspended, we should + reset timing to account for the gap in play time. Do it the + easy/hack way */ + if(now-last>1000)audiofd_timer_calibrate+=(now-last); + last=now; + } + + if(now-up>200){ + double timebase=(now-audiofd_timer_calibrate)*.001; + int hundredths=timebase*100-(long)timebase*100; + int seconds=(long)timebase%60; + int minutes=((long)timebase/60)%60; + int hours=(long)timebase/3600; + + fprintf(stderr," Playing: %d:%02d:%02d.%02d \r", + hours,minutes,seconds,hundredths); + up=now; + } + + return (now-audiofd_timer_calibrate)*.001; + +} + +/* write a fragment to the OSS kernel audio API, but only if we can + stuff in a whole fragment without blocking */ +void audio_write_nonblocking(void){ + + if(audiobuf_ready){ + audio_buf_info info; + long bytes; + + ioctl(audiofd,SNDCTL_DSP_GETOSPACE,&info); + bytes=info.bytes; + if(bytes>=audiofd_fragsize){ + if(bytes==audiofd_totalsize)audio_calibrate_timer(1); + + while(1){ + bytes=write(audiofd,audiobuf+(audiofd_fragsize-audiobuf_fill), + audiofd_fragsize); + + if(bytes>0){ + + if(bytes!=audiobuf_fill){ + /* shouldn't actually be possible... but eh */ + audiobuf_fill-=bytes; + }else + break; + } + } + + audiobuf_fill=0; + audiobuf_ready=0; + + } + } +} + +/* clean quit on Ctrl-C for SDL and thread shutdown as per SDL example + (we don't use any threads, but libSDL does) */ +int got_sigint=0; +static void sigint_handler (int signal) { + got_sigint = 1; +} + +static void open_video(void){ + int w; + int h; + w=(ti.pic_x+ti.pic_width+1&~1)-(ti.pic_x&~1); + h=(ti.pic_y+ti.pic_height+1&~1)-(ti.pic_y&~1); + if ( SDL_Init(SDL_INIT_VIDEO) < 0 ) { + fprintf(stderr, "Unable to init SDL: %s\n", SDL_GetError()); + exit(1); + } + + screen = SDL_SetVideoMode(w, h, 0, SDL_SWSURFACE); + if ( screen == NULL ) { + fprintf(stderr, "Unable to set %dx%d video: %s\n", + w,h,SDL_GetError()); + exit(1); + } + + if (px_fmt==TH_PF_422) + yuv_overlay = SDL_CreateYUVOverlay(w, h, + SDL_YUY2_OVERLAY, + screen); + else if (px_fmt==TH_PF_444) { + RGBbuffer = calloc(sizeof(char),w*h*4); + fprintf(stderr,"warning: SDL does not support YUV 4:4:4, using slow software conversion.\n"); + } else + yuv_overlay = SDL_CreateYUVOverlay(w, h, + SDL_YV12_OVERLAY, + screen); + + if ( (yuv_overlay == NULL && px_fmt!=TH_PF_444) || (screen == NULL && px_fmt==TH_PF_444) ) { + fprintf(stderr, "SDL: xCouldn't create SDL_yuv_overlay: %s\n", + SDL_GetError()); + exit(1); + } + rect.x = 0; + rect.y = 0; + rect.w = w; + rect.h = h; + + if (px_fmt!=TH_PF_444) + SDL_DisplayYUVOverlay(yuv_overlay, &rect); +} + +static void video_write(void){ + int i; + th_ycbcr_buffer yuv; + int y_offset, uv_offset; + th_decode_ycbcr_out(td,yuv); + /* Lock SDL_yuv_overlay */ + if ( SDL_MUSTLOCK(screen) ) { + if ( SDL_LockSurface(screen) < 0 ) return; + } + if (px_fmt!=TH_PF_444 && SDL_LockYUVOverlay(yuv_overlay) < 0) return; + + /* let's draw the data on a SDL screen (*screen) */ + /* deal with border stride */ + /* reverse u and v for SDL */ + /* and crop input properly, respecting the encoded frame rect */ + /* problems may exist for odd frame rect for some encodings */ + + y_offset=(ti.pic_x&~1)+yuv[0].stride*(ti.pic_y&~1); + + if (px_fmt==TH_PF_422) { + uv_offset=(ti.pic_x/2)+(yuv[1].stride)*(ti.pic_y); + /* SDL doesn't have a planar 4:2:2 */ + for(i=0;ih;i++) { + int j; + char *in_y = (char *)yuv[0].data+y_offset+yuv[0].stride*i; + char *out = (char *)(yuv_overlay->pixels[0]+yuv_overlay->pitches[0]*i); + for (j=0;jw;j++) + out[j*2] = in_y[j]; + char *in_u = (char *)yuv[1].data+uv_offset+yuv[1].stride*i; + char *in_v = (char *)yuv[2].data+uv_offset+yuv[2].stride*i; + for (j=0;jw>>1;j++) { + out[j*4+1] = in_u[j]; + out[j*4+3] = in_v[j]; + } + } + } else if (px_fmt==TH_PF_444){ + SDL_Surface *output; + for(i=0;ih;i++) { + int j; + unsigned char *in_y = (unsigned char *)yuv[0].data+y_offset+yuv[0].stride*i; + unsigned char *in_u = (unsigned char *)yuv[1].data+y_offset+yuv[1].stride*i; + unsigned char *in_v = (unsigned char *)yuv[2].data+y_offset+yuv[2].stride*i; + unsigned char *out = RGBbuffer+(screen->w*i*4); + for (j=0;jw;j++) { + int r, g, b; + r=(1904000*in_y[j]+2609823*in_v[j]-363703744)/1635200; + g=(3827562*in_y[j]-1287801*in_u[j] + -2672387*in_v[j]+447306710)/3287200; + b=(952000*in_y[j]+1649289*in_u[j]-225932192)/817600; + out[4*j+0]=OC_CLAMP255(b); + out[4*j+1]=OC_CLAMP255(g); + out[4*j+2]=OC_CLAMP255(r); + } + output=SDL_CreateRGBSurfaceFrom(RGBbuffer,screen->w,screen->h,32,4*screen->w,0,0,0,0); + SDL_BlitSurface(output,NULL,screen,NULL); + } + } else { + uv_offset=(ti.pic_x/2)+(yuv[1].stride)*(ti.pic_y/2); + for(i=0;ih;i++) + memcpy(yuv_overlay->pixels[0]+yuv_overlay->pitches[0]*i, + yuv[0].data+y_offset+yuv[0].stride*i, + yuv_overlay->w); + for(i=0;ih/2;i++){ + memcpy(yuv_overlay->pixels[1]+yuv_overlay->pitches[1]*i, + yuv[2].data+uv_offset+yuv[2].stride*i, + yuv_overlay->w/2); + memcpy(yuv_overlay->pixels[2]+yuv_overlay->pitches[2]*i, + yuv[1].data+uv_offset+yuv[1].stride*i, + yuv_overlay->w/2); + } + } + + /* Unlock SDL_yuv_overlay */ + if ( SDL_MUSTLOCK(screen) ) { + SDL_UnlockSurface(screen); + } + if (px_fmt!=TH_PF_444) { + SDL_UnlockYUVOverlay(yuv_overlay); + /* Show, baby, show! */ + SDL_DisplayYUVOverlay(yuv_overlay, &rect); + } else { + SDL_Flip(screen); + } +} +/* dump the theora (or vorbis) comment header */ +static int dump_comments(th_comment *tc){ + int i, len; + char *value; + FILE *out=stdout; + + fprintf(out,"Encoded by %s\n",tc->vendor); + if(tc->comments){ + fprintf(out, "theora comment header:\n"); + for(i=0;icomments;i++){ + if(tc->user_comments[i]){ + len=tc->comment_lengths[i]; + value=malloc(len+1); + memcpy(value,tc->user_comments[i],len); + value[len]='\0'; + fprintf(out, "\t%s\n", value); + free(value); + } + } + } + return(0); +} + +/* Report the encoder-specified colorspace for the video, if any. + We don't actually make use of the information in this example; + a real player should attempt to perform color correction for + whatever display device it supports. */ +static void report_colorspace(th_info *ti) +{ + switch(ti->colorspace){ + case TH_CS_UNSPECIFIED: + /* nothing to report */ + break;; + case TH_CS_ITU_REC_470M: + fprintf(stderr," encoder specified ITU Rec 470M (NTSC) color.\n"); + break;; + case TH_CS_ITU_REC_470BG: + fprintf(stderr," encoder specified ITU Rec 470BG (PAL) color.\n"); + break;; + default: + fprintf(stderr,"warning: encoder specified unknown colorspace (%d).\n", + ti->colorspace); + break;; + } +} + +/* helper: push a page into the appropriate steam */ +/* this can be done blindly; a stream won't accept a page + that doesn't belong to it */ +static int queue_page(ogg_page *page){ + if(theora_p)ogg_stream_pagein(&to,page); + if(vorbis_p)ogg_stream_pagein(&vo,page); + return 0; +} + +static void usage(void){ + fprintf(stderr, + "Usage: player_example \n" + "input is read from stdin if no file is passed on the command line\n" + "\n" + ); +} + +int main(int argc,char *const *argv){ + + int pp_level_max; + int pp_level; + int pp_inc; + int i,j; + ogg_packet op; + + FILE *infile = stdin; + + int frames = 0; + int dropped = 0; + +#ifdef _WIN32 /* We need to set stdin/stdout to binary mode. Damn windows. */ + /* Beware the evil ifdef. We avoid these where we can, but this one we + cannot. Don't add any more, you'll probably go to hell if you do. */ + _setmode( _fileno( stdin ), _O_BINARY ); +#endif + + /* open the input file if any */ + if(argc==2){ + infile=fopen(argv[1],"rb"); + if(infile==NULL){ + fprintf(stderr,"Unable to open '%s' for playback.\n", argv[1]); + exit(1); + } + } + if(argc>2){ + usage(); + exit(1); + } + + /* start up Ogg stream synchronization layer */ + ogg_sync_init(&oy); + + /* init supporting Vorbis structures needed in header parsing */ + vorbis_info_init(&vi); + vorbis_comment_init(&vc); + + /* init supporting Theora structures needed in header parsing */ + th_comment_init(&tc); + th_info_init(&ti); + + /* Ogg file open; parse the headers */ + /* Only interested in Vorbis/Theora streams */ + while(!stateflag){ + int ret=buffer_data(infile,&oy); + if(ret==0)break; + while(ogg_sync_pageout(&oy,&og)>0){ + ogg_stream_state test; + + /* is this a mandated initial header? If not, stop parsing */ + if(!ogg_page_bos(&og)){ + /* don't leak the page; get it into the appropriate stream */ + queue_page(&og); + stateflag=1; + break; + } + + ogg_stream_init(&test,ogg_page_serialno(&og)); + ogg_stream_pagein(&test,&og); + ogg_stream_packetout(&test,&op); + + + /* identify the codec: try theora */ + if(!theora_p && th_decode_headerin(&ti,&tc,&ts,&op)>=0){ + /* it is theora */ + memcpy(&to,&test,sizeof(test)); + theora_p=1; + }else if(!vorbis_p && vorbis_synthesis_headerin(&vi,&vc,&op)>=0){ + /* it is vorbis */ + memcpy(&vo,&test,sizeof(test)); + vorbis_p=1; + }else{ + /* whatever it is, we don't care about it */ + ogg_stream_clear(&test); + } + } + /* fall through to non-bos page parsing */ + } + + /* we're expecting more header packets. */ + while((theora_p && theora_p<3) || (vorbis_p && vorbis_p<3)){ + int ret; + + /* look for further theora headers */ + while(theora_p && (theora_p<3) && (ret=ogg_stream_packetout(&to,&op))){ + if(ret<0){ + fprintf(stderr,"Error parsing Theora stream headers; " + "corrupt stream?\n"); + exit(1); + } + if(!th_decode_headerin(&ti,&tc,&ts,&op)){ + fprintf(stderr,"Error parsing Theora stream headers; " + "corrupt stream?\n"); + exit(1); + } + theora_p++; + } + + /* look for more vorbis header packets */ + while(vorbis_p && (vorbis_p<3) && (ret=ogg_stream_packetout(&vo,&op))){ + if(ret<0){ + fprintf(stderr,"Error parsing Vorbis stream headers; corrupt stream?\n"); + exit(1); + } + if(vorbis_synthesis_headerin(&vi,&vc,&op)){ + fprintf(stderr,"Error parsing Vorbis stream headers; corrupt stream?\n"); + exit(1); + } + vorbis_p++; + if(vorbis_p==3)break; + } + + /* The header pages/packets will arrive before anything else we + care about, or the stream is not obeying spec */ + + if(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); /* demux into the appropriate stream */ + }else{ + int ret=buffer_data(infile,&oy); /* someone needs more data */ + if(ret==0){ + fprintf(stderr,"End of file while searching for codec headers.\n"); + exit(1); + } + } + } + + /* and now we have it all. initialize decoders */ + if(theora_p){ + td=th_decode_alloc(&ti,ts); + printf("Ogg logical stream %lx is Theora %dx%d %.02f fps", + to.serialno,ti.pic_width,ti.pic_height, + (double)ti.fps_numerator/ti.fps_denominator); + px_fmt=ti.pixel_fmt; + switch(ti.pixel_fmt){ + case TH_PF_420: printf(" 4:2:0 video\n"); break; + case TH_PF_422: printf(" 4:2:2 video\n"); break; + case TH_PF_444: printf(" 4:4:4 video\n"); break; + case TH_PF_RSVD: + default: + printf(" video\n (UNKNOWN Chroma sampling!)\n"); + break; + } + if(ti.pic_width!=ti.frame_width || ti.pic_height!=ti.frame_height) + printf(" Frame content is %dx%d with offset (%d,%d).\n", + ti.frame_width, ti.frame_height, ti.pic_x, ti.pic_y); + report_colorspace(&ti); + dump_comments(&tc); + th_decode_ctl(td,TH_DECCTL_GET_PPLEVEL_MAX,&pp_level_max, + sizeof(pp_level_max)); + pp_level=pp_level_max; + th_decode_ctl(td,TH_DECCTL_SET_PPLEVEL,&pp_level,sizeof(pp_level)); + pp_inc=0; + + /*{ + int arg = 0xffff; + th_decode_ctl(td,TH_DECCTL_SET_TELEMETRY_MBMODE,&arg,sizeof(arg)); + th_decode_ctl(td,TH_DECCTL_SET_TELEMETRY_MV,&arg,sizeof(arg)); + th_decode_ctl(td,TH_DECCTL_SET_TELEMETRY_QI,&arg,sizeof(arg)); + arg=10; + th_decode_ctl(td,TH_DECCTL_SET_TELEMETRY_BITS,&arg,sizeof(arg)); + }*/ + }else{ + /* tear down the partial theora setup */ + th_info_clear(&ti); + th_comment_clear(&tc); + } + + th_setup_free(ts); + + if(vorbis_p){ + vorbis_synthesis_init(&vd,&vi); + vorbis_block_init(&vd,&vb); + fprintf(stderr,"Ogg logical stream %lx is Vorbis %d channel %ld Hz audio.\n", + vo.serialno,vi.channels,vi.rate); + }else{ + /* tear down the partial vorbis setup */ + vorbis_info_clear(&vi); + vorbis_comment_clear(&vc); + } + + /* open audio */ + if(vorbis_p)open_audio(); + + /* open video */ + if(theora_p)open_video(); + + /* install signal handler as SDL clobbered the default */ + signal (SIGINT, sigint_handler); + + /* on to the main decode loop. We assume in this example that audio + and video start roughly together, and don't begin playback until + we have a start frame for both. This is not necessarily a valid + assumption in Ogg A/V streams! It will always be true of the + example_encoder (and most streams) though. */ + + stateflag=0; /* playback has not begun */ + while(!got_sigint){ + + /* we want a video and audio frame ready to go at all times. If + we have to buffer incoming, buffer the compressed data (ie, let + ogg do the buffering) */ + while(vorbis_p && !audiobuf_ready){ + int ret; + float **pcm; + + /* if there's pending, decoded audio, grab it */ + if((ret=vorbis_synthesis_pcmout(&vd,&pcm))>0){ + int count=audiobuf_fill/2; + int maxsamples=(audiofd_fragsize-audiobuf_fill)/2/vi.channels; + for(i=0;i32767)val=32767; + if(val<-32768)val=-32768; + audiobuf[count++]=val; + } + vorbis_synthesis_read(&vd,i); + audiobuf_fill+=i*vi.channels*2; + if(audiobuf_fill==audiofd_fragsize)audiobuf_ready=1; + if(vd.granulepos>=0) + audiobuf_granulepos=vd.granulepos-ret+i; + else + audiobuf_granulepos+=i; + + }else{ + + /* no pending audio; is there a pending packet to decode? */ + if(ogg_stream_packetout(&vo,&op)>0){ + if(vorbis_synthesis(&vb,&op)==0) /* test for success! */ + vorbis_synthesis_blockin(&vd,&vb); + }else /* we need more data; break out to suck in another page */ + break; + } + } + + while(theora_p && !videobuf_ready){ + /* theora is one in, one out... */ + if(ogg_stream_packetout(&to,&op)>0){ + + if(pp_inc){ + pp_level+=pp_inc; + th_decode_ctl(td,TH_DECCTL_SET_PPLEVEL,&pp_level, + sizeof(pp_level)); + pp_inc=0; + } + /*HACK: This should be set after a seek or a gap, but we might not have + a granulepos for the first packet (we only have them for the last + packet on a page), so we just set it as often as we get it. + To do this right, we should back-track from the last packet on the + page and compute the correct granulepos for the first packet after + a seek or a gap.*/ + if(op.granulepos>=0){ + th_decode_ctl(td,TH_DECCTL_SET_GRANPOS,&op.granulepos, + sizeof(op.granulepos)); + } + if(th_decode_packetin(td,&op,&videobuf_granulepos)==0){ + videobuf_time=th_granule_time(td,videobuf_granulepos); + frames++; + + /* is it already too old to be useful? This is only actually + useful cosmetically after a SIGSTOP. Note that we have to + decode the frame even if we don't show it (for now) due to + keyframing. Soon enough libtheora will be able to deal + with non-keyframe seeks. */ + + if(videobuf_time>=get_time()) + videobuf_ready=1; + else{ + /*If we are too slow, reduce the pp level.*/ + pp_inc=pp_level>0?-1:0; + dropped++; + } + } + + }else + break; + } + + if(!videobuf_ready && !audiobuf_ready && feof(infile))break; + + if(!videobuf_ready || !audiobuf_ready){ + /* no data yet for somebody. Grab another page */ + buffer_data(infile,&oy); + while(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); + } + } + + /* If playback has begun, top audio buffer off immediately. */ + if(stateflag) audio_write_nonblocking(); + + /* are we at or past time for this video frame? */ + if(stateflag && videobuf_ready && videobuf_time<=get_time()){ + video_write(); + videobuf_ready=0; + } + + if(stateflag && + (audiobuf_ready || !vorbis_p) && + (videobuf_ready || !theora_p) && + !got_sigint){ + /* we have an audio frame ready (which means the audio buffer is + full), it's not time to play video, so wait until one of the + audio buffer is ready or it's near time to play video */ + + /* set up select wait on the audiobuffer and a timeout for video */ + struct timeval timeout; + fd_set writefs; + fd_set empty; + int n=0; + + FD_ZERO(&writefs); + FD_ZERO(&empty); + if(audiofd>=0){ + FD_SET(audiofd,&writefs); + n=audiofd+1; + } + + if(theora_p){ + double tdiff; + long milliseconds; + tdiff=videobuf_time-get_time(); + /*If we have lots of extra time, increase the post-processing level.*/ + if(tdiff>ti.fps_denominator*0.25/ti.fps_numerator){ + pp_inc=pp_level0?-1:0; + } + milliseconds=tdiff*1000-5; + if(milliseconds>500)milliseconds=500; + if(milliseconds>0){ + timeout.tv_sec=milliseconds/1000; + timeout.tv_usec=(milliseconds%1000)*1000; + + n=select(n,&empty,&writefs,&empty,&timeout); + if(n)audio_calibrate_timer(0); + } + }else{ + select(n,&empty,&writefs,&empty,NULL); + } + } + + /* if our buffers either don't exist or are ready to go, + we can begin playback */ + if((!theora_p || videobuf_ready) && + (!vorbis_p || audiobuf_ready))stateflag=1; + /* same if we've run out of input */ + if(feof(infile))stateflag=1; + + } + + /* tear it all down */ + + audio_close(); + SDL_Quit(); + + if(vorbis_p){ + ogg_stream_clear(&vo); + vorbis_block_clear(&vb); + vorbis_dsp_clear(&vd); + vorbis_comment_clear(&vc); + vorbis_info_clear(&vi); + } + if(theora_p){ + ogg_stream_clear(&to); + th_decode_free(td); + th_comment_clear(&tc); + th_info_clear(&ti); + } + ogg_sync_clear(&oy); + + if(infile && infile!=stdin)fclose(infile); + + fprintf(stderr, + "\r \r"); + fprintf(stderr, "%d frames", frames); + if (dropped) fprintf(stderr, " (%d dropped)", dropped); + fprintf(stderr, "\n"); + fprintf(stderr, "\nDone.\n"); + + return(0); + +} diff --git a/libs/libtheora-1.1/examples/png2theora.c b/libs/libtheora-1.1/examples/png2theora.c new file mode 100644 index 00000000..54728c9d --- /dev/null +++ b/libs/libtheora-1.1/examples/png2theora.c @@ -0,0 +1,942 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009,2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: example encoder application; makes an Ogg Theora + file from a sequence of png images + last mod: $Id: png2theora.c 17975 2011-05-07 22:35:30Z giles $ + based on code from Vegard Nossum + + ********************************************************************/ + +#define _FILE_OFFSET_BITS 64 + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#ifdef HAVE_CONFIG_H +# include +#endif + +#include +#include +#include "theora/theoraenc.h" + +#define PROGRAM_NAME "png2theora" +#define PROGRAM_VERSION "1.1" + +static const char *option_output = NULL; +static int video_fps_numerator = 24; +static int video_fps_denominator = 1; +static int video_aspect_numerator = 0; +static int video_aspect_denominator = 0; +static int video_rate = -1; +static int video_quality = -1; +ogg_uint32_t keyframe_frequency=0; +int buf_delay=-1; +int vp3_compatible=0; +static int chroma_format = TH_PF_420; + +static FILE *twopass_file = NULL; +static int twopass=0; +static int passno; + +static FILE *ogg_fp = NULL; +static ogg_stream_state ogg_os; +static ogg_packet op; +static ogg_page og; + +static th_enc_ctx *td; +static th_info ti; + +static char *input_filter; + +const char *optstring = "o:hv:\4:\2:V:s:S:f:F:ck:d:\1\2\3\4\5\6"; +struct option options [] = { + {"output",required_argument,NULL,'o'}, + {"help",no_argument,NULL,'h'}, + {"chroma-444",no_argument,NULL,'\5'}, + {"chroma-422",no_argument,NULL,'\6'}, + {"video-rate-target",required_argument,NULL,'V'}, + {"video-quality",required_argument,NULL,'v'}, + {"aspect-numerator",required_argument,NULL,'s'}, + {"aspect-denominator",required_argument,NULL,'S'}, + {"framerate-numerator",required_argument,NULL,'f'}, + {"framerate-denominator",required_argument,NULL,'F'}, + {"vp3-compatible",no_argument,NULL,'c'}, + {"soft-target",no_argument,NULL,'\1'}, + {"keyframe-freq",required_argument,NULL,'k'}, + {"buf-delay",required_argument,NULL,'d'}, + {"two-pass",no_argument,NULL,'\2'}, + {"first-pass",required_argument,NULL,'\3'}, + {"second-pass",required_argument,NULL,'\4'}, + {NULL,0,NULL,0} +}; + +static void usage(void){ + fprintf(stderr, + "%s %s\n" + "Usage: %s [options] \n\n" + "The input argument uses C printf format to represent a list of files,\n" + " i.e. file-%%06d.png to look for files file000001.png to file9999999.png \n\n" + "Options: \n\n" + " -o --output file name for encoded output (required);\n" + " -v --video-quality Theora quality selector fro 0 to 10\n" + " (0 yields smallest files but lowest\n" + " video quality. 10 yields highest\n" + " fidelity but large files)\n\n" + " -V --video-rate-target bitrate target for Theora video\n\n" + " --soft-target Use a large reservoir and treat the rate\n" + " as a soft target; rate control is less\n" + " strict but resulting quality is usually\n" + " higher/smoother overall. Soft target also\n" + " allows an optional -v setting to specify\n" + " a minimum allowed quality.\n\n" + " --two-pass Compress input using two-pass rate control\n" + " This option performs both passes automatically.\n\n" + " --first-pass Perform first-pass of a two-pass rate\n" + " controlled encoding, saving pass data to\n" + " for a later second pass\n\n" + " --second-pass Perform second-pass of a two-pass rate\n" + " controlled encoding, reading first-pass\n" + " data from . The first pass\n" + " data must come from a first encoding pass\n" + " using identical input video to work\n" + " properly.\n\n" + " -k --keyframe-freq Keyframe frequency\n" + " -d --buf-delay Buffer delay (in frames). Longer delays\n" + " allow smoother rate adaptation and provide\n" + " better overall quality, but require more\n" + " client side buffering and add latency. The\n" + " default value is the keyframe interval for\n" + " one-pass encoding (or somewhat larger if\n" + " --soft-target is used) and infinite for\n" + " two-pass encoding.\n" + " --chroma-444 Use 4:4:4 chroma subsampling\n" + " --chroma-422 Use 4:2:2 chroma subsampling\n" + " (4:2:0 is default)\n\n" + " -s --aspect-numerator Aspect ratio numerator, default is 0\n" + " -S --aspect-denominator Aspect ratio denominator, default is 0\n" + " -f --framerate-numerator Frame rate numerator\n" + " -F --framerate-denominator Frame rate denominator\n" + " The frame rate nominator divided by this\n" + " determines the frame rate in units per tick\n" + ,PROGRAM_NAME, PROGRAM_VERSION, PROGRAM_NAME + ); + exit(0); +} + +#ifdef WIN32 +int +alphasort (const void *a, const void *b) +{ + return strcoll ((*(const struct dirent **) a)->d_name, + (*(const struct dirent **) b)->d_name); +} + +int +scandir (const char *dir, struct dirent ***namelist, + int (*select)(const struct dirent *), int (*compar)(const void *, const void *)) +{ + DIR *d; + struct dirent *entry; + register int i=0; + size_t entrysize; + + if ((d=opendir(dir)) == NULL) + return(-1); + + *namelist=NULL; + while ((entry=readdir(d)) != NULL) + { + if (select == NULL || (select != NULL && (*select)(entry))) + { + *namelist=(struct dirent **)realloc((void *)(*namelist), + (size_t)((i+1)*sizeof(struct dirent *))); + if (*namelist == NULL) return(-1); + entrysize=sizeof(struct dirent)-sizeof(entry->d_name)+strlen(entry->d_name)+1; + (*namelist)[i]=(struct dirent *)malloc(entrysize); + if ((*namelist)[i] == NULL) return(-1); + memcpy((*namelist)[i], entry, entrysize); + i++; + } + } + if (closedir(d)) return(-1); + if (i == 0) return(-1); + if (compar != NULL) + qsort((void *)(*namelist), (size_t)i, sizeof(struct dirent *), compar); + + return(i); +} +#endif + +static int +theora_write_frame(th_ycbcr_buffer ycbcr, int last) +{ + ogg_packet op; + ogg_page og; + + /* Theora is a one-frame-in,one-frame-out system; submit a frame + for compression and pull out the packet */ + /* in two-pass mode's second pass, we need to submit first-pass data */ + if(passno==2){ + int ret; + for(;;){ + static unsigned char buffer[80]; + static int buf_pos; + int bytes; + /*Ask the encoder how many bytes it would like.*/ + bytes=th_encode_ctl(td,TH_ENCCTL_2PASS_IN,NULL,0); + if(bytes<0){ + fprintf(stderr,"Error submitting pass data in second pass.\n"); + exit(1); + } + /*If it's got enough, stop.*/ + if(bytes==0)break; + /*Read in some more bytes, if necessary.*/ + if(bytes>80-buf_pos)bytes=80-buf_pos; + if(bytes>0&&fread(buffer+buf_pos,1,bytes,twopass_file)=bytes)buf_pos=0; + /*Otherwise remember how much it used.*/ + else buf_pos+=ret; + } + } + + if(th_encode_ycbcr_in(td, ycbcr)) { + fprintf(stderr, "%s: error: could not encode frame\n", + option_output); + return 1; + } + + /* in two-pass mode's first pass we need to extract and save the pass data */ + if(passno==1){ + unsigned char *buffer; + int bytes = th_encode_ctl(td, TH_ENCCTL_2PASS_OUT, &buffer, sizeof(buffer)); + if(bytes<0){ + fprintf(stderr,"Could not read two-pass data from encoder.\n"); + exit(1); + } + if(fwrite(buffer,1,bytes,twopass_file) 255) + return 255; + + return d; +} + +static void +rgb_to_yuv(png_bytep *png, + th_ycbcr_buffer ycbcr, + unsigned int w, unsigned int h) +{ + unsigned int x; + unsigned int y; + + unsigned int x1; + unsigned int y1; + + unsigned long yuv_w; + + unsigned char *yuv_y; + unsigned char *yuv_u; + unsigned char *yuv_v; + + yuv_w = ycbcr[0].width; + + yuv_y = ycbcr[0].data; + yuv_u = ycbcr[1].data; + yuv_v = ycbcr[2].data; + + /*This ignores gamma and RGB primary/whitepoint differences. + It also isn't terribly fast (though a decent compiler will + strength-reduce the division to a multiplication).*/ + + if (chroma_format == TH_PF_420) { + for(y = 0; y < h; y += 2) { + y1=y+(y+1> 1) + (y >> 1) * ycbcr[1].stride] = + clamp( ((-33488*r0-65744*g0+99232*b0+29032005)/4 + + (-33488*r0-65744*g0+99232*b0+29032005)/4 + + (-33488*r2-65744*g2+99232*b2+29032005)/4 + + (-33488*r3-65744*g3+99232*b3+29032005)/4)/225930); + yuv_v[(x >> 1) + (y >> 1) * ycbcr[2].stride] = + clamp( ((157024*r0-131488*g0-25536*b0+45940035)/4 + + (157024*r1-131488*g1-25536*b1+45940035)/4 + + (157024*r2-131488*g2-25536*b2+45940035)/4 + + (157024*r3-131488*g3-25536*b3+45940035)/4)/357510); + } + } + } else if (chroma_format == TH_PF_444) { + for(y = 0; y < h; y++) { + for(x = 0; x < w; x++) { + png_byte r = png[y][3 * x + 0]; + png_byte g = png[y][3 * x + 1]; + png_byte b = png[y][3 * x + 2]; + + yuv_y[x + y * yuv_w] = clamp((65481*r+128553*g+24966*b+4207500)/255000); + yuv_u[x + y * yuv_w] = clamp((-33488*r-65744*g+99232*b+29032005)/225930); + yuv_v[x + y * yuv_w] = clamp((157024*r-131488*g-25536*b+45940035)/357510); + } + } + } else { /* TH_PF_422 */ + for(y = 0; y < h; y += 1) { + for(x = 0; x < w; x += 2) { + x1=x+(x+1> 1) + y * ycbcr[1].stride] = + clamp( ((-33488*r0-65744*g0+99232*b0+29032005)/2 + + (-33488*r1-65744*g1+99232*b1+29032005)/2)/225930); + yuv_v[(x >> 1) + y * ycbcr[2].stride] = + clamp( ((157024*r0-131488*g0-25536*b0+45940035)/2 + + (157024*r1-131488*g1-25536*b1+45940035)/2)/357510); + } + } + } + +} + +static int +png_read(const char *pathname, unsigned int *w, unsigned int *h, th_ycbcr_buffer ycbcr) +{ + FILE *fp; + unsigned char header[8]; + png_structp png_ptr; + png_infop info_ptr; + png_infop end_ptr; + png_bytep row_data; + png_bytep *row_pointers; + png_color_16p bkgd; + png_uint_32 width; + png_uint_32 height; + unsigned long yuv_w; + unsigned long yuv_h; + int bit_depth; + int color_type; + int interlace_type; + int compression_type; + int filter_method; + png_uint_32 y; + + fp = fopen(pathname, "rb"); + if(!fp) { + fprintf(stderr, "%s: error: %s\n", + pathname, strerror(errno)); + return 1; + } + + fread(header, 1, 8, fp); + if(png_sig_cmp(header, 0, 8)) { + fprintf(stderr, "%s: error: %s\n", + pathname, "not a PNG"); + fclose(fp); + return 1; + } + + png_ptr = png_create_read_struct(PNG_LIBPNG_VER_STRING, + NULL, NULL, NULL); + if(!png_ptr) { + fprintf(stderr, "%s: error: %s\n", + pathname, "couldn't create png read structure"); + fclose(fp); + return 1; + } + + info_ptr = png_create_info_struct(png_ptr); + if(!info_ptr) { + fprintf(stderr, "%s: error: %s\n", + pathname, "couldn't create png info structure"); + png_destroy_read_struct(&png_ptr, NULL, NULL); + fclose(fp); + return 1; + } + + end_ptr = png_create_info_struct(png_ptr); + if(!end_ptr) { + fprintf(stderr, "%s: error: %s\n", + pathname, "couldn't create png info structure"); + png_destroy_read_struct(&png_ptr, &info_ptr, NULL); + fclose(fp); + return 1; + } + + png_init_io(png_ptr, fp); + png_set_sig_bytes(png_ptr, 8); + png_read_info(png_ptr, info_ptr); + png_get_IHDR(png_ptr, info_ptr, &width, &height, &bit_depth, &color_type, + &interlace_type, &compression_type, &filter_method); + png_set_expand(png_ptr); + if(bit_depth<8)png_set_packing(png_ptr); + if(bit_depth==16)png_set_strip_16(png_ptr); + if(!(color_type&PNG_COLOR_MASK_COLOR))png_set_gray_to_rgb(png_ptr); + if(png_get_bKGD(png_ptr, info_ptr, &bkgd)){ + png_set_background(png_ptr, bkgd, PNG_BACKGROUND_GAMMA_FILE, 1, 1.0); + } + /*Note that color_type 2 and 3 can also have alpha, despite not setting the + PNG_COLOR_MASK_ALPHA bit. + We always strip it to prevent libpng from overrunning our buffer.*/ + png_set_strip_alpha(png_ptr); + + row_data = (png_bytep)png_malloc(png_ptr, + 3*height*width*png_sizeof(*row_data)); + row_pointers = (png_bytep *)png_malloc(png_ptr, + height*png_sizeof(*row_pointers)); + for(y = 0; y < height; y++) { + row_pointers[y] = row_data + y*(3*width); + } + png_read_image(png_ptr, row_pointers); + png_read_end(png_ptr, end_ptr); + + *w = width; + *h = height; + /* Must hold: yuv_w >= w */ + yuv_w = (*w + 15) & ~15; + /* Must hold: yuv_h >= h */ + yuv_h = (*h + 15) & ~15; + + /* Do we need to allocate a buffer */ + if (!ycbcr[0].data){ + ycbcr[0].width = yuv_w; + ycbcr[0].height = yuv_h; + ycbcr[0].stride = yuv_w; + ycbcr[1].width = (chroma_format == TH_PF_444) ? yuv_w : (yuv_w >> 1); + ycbcr[1].stride = ycbcr[1].width; + ycbcr[1].height = (chroma_format == TH_PF_420) ? (yuv_h >> 1) : yuv_h; + ycbcr[2].width = ycbcr[1].width; + ycbcr[2].stride = ycbcr[1].stride; + ycbcr[2].height = ycbcr[1].height; + + ycbcr[0].data = malloc(ycbcr[0].stride * ycbcr[0].height); + ycbcr[1].data = malloc(ycbcr[1].stride * ycbcr[1].height); + ycbcr[2].data = malloc(ycbcr[2].stride * ycbcr[2].height); + } else { + if ((ycbcr[0].width != yuv_w) || (ycbcr[0].height != yuv_h)){ + fprintf(stderr, "Input size %lux%lu does not match %dx%d\n", yuv_w,yuv_h,ycbcr[0].width,ycbcr[0].height); + exit(1); + } + } + + rgb_to_yuv(row_pointers, ycbcr, *w, *h); + + png_free(png_ptr, row_pointers); + png_free(png_ptr, row_data); + png_destroy_read_struct(&png_ptr, &info_ptr, &end_ptr); + + fclose(fp); + return 0; +} + +static int include_files (const struct dirent *de) +{ + char name[1024]; + int number = -1; + sscanf(de->d_name, input_filter, &number); + sprintf(name, input_filter, number); + return !strcmp(name, de->d_name); +} + +static int ilog(unsigned _v){ + int ret; + for(ret=0;_v;ret++)_v>>=1; + return ret; +} + +int +main(int argc, char *argv[]) +{ + int c,long_option_index; + int i, n; + char *input_mask; + char *input_directory; + char *scratch; + th_comment tc; + struct dirent **png_files; + int soft_target=0; + int ret; + + while(1) { + + c=getopt_long(argc,argv,optstring,options,&long_option_index); + if(c == EOF) + break; + + switch(c) { + case 'h': + usage(); + break; + case 'o': + option_output = optarg; + break;; + case 'v': + video_quality=rint(atof(optarg)*6.3); + if(video_quality<0 || video_quality>63){ + fprintf(stderr,"Illegal video quality (choose 0 through 10)\n"); + exit(1); + } + video_rate=0; + break; + case 'V': + video_rate=rint(atof(optarg)*1000); + if(video_rate<1){ + fprintf(stderr,"Illegal video bitrate (choose > 0 please)\n"); + exit(1); + } + video_quality=0; + break; + case '\1': + soft_target=1; + break; + case 'c': + vp3_compatible=1; + break; + case 'k': + keyframe_frequency=rint(atof(optarg)); + if(keyframe_frequency<1 || keyframe_frequency>2147483647){ + fprintf(stderr,"Illegal keyframe frequency\n"); + exit(1); + } + break; + + case 'd': + buf_delay=atoi(optarg); + if(buf_delay<=0){ + fprintf(stderr,"Illegal buffer delay\n"); + exit(1); + } + break; + case 's': + video_aspect_numerator=rint(atof(optarg)); + break; + case 'S': + video_aspect_denominator=rint(atof(optarg)); + break; + case 'f': + video_fps_numerator=rint(atof(optarg)); + break; + case 'F': + video_fps_denominator=rint(atof(optarg)); + break; + case '\5': + chroma_format=TH_PF_444; + break; + case '\6': + chroma_format=TH_PF_422; + break; + case '\2': + twopass=3; /* perform both passes */ + twopass_file=tmpfile(); + if(!twopass_file){ + fprintf(stderr,"Unable to open temporary file for twopass data\n"); + exit(1); + } + break; + case '\3': + twopass=1; /* perform first pass */ + twopass_file=fopen(optarg,"wb"); + if(!twopass_file){ + fprintf(stderr,"Unable to open \'%s\' for twopass data\n",optarg); + exit(1); + } + break; + case '\4': + twopass=2; /* perform second pass */ + twopass_file=fopen(optarg,"rb"); + if(!twopass_file){ + fprintf(stderr,"Unable to open twopass data file \'%s\'",optarg); + exit(1); + } + break; + default: + usage(); + break; + } + } + + if(argc < 3) { + usage(); + } + + if(soft_target){ + if(video_rate<=0){ + fprintf(stderr,"Soft rate target (--soft-target) requested without a bitrate (-V).\n"); + exit(1); + } + if(video_quality==-1) + video_quality=0; + }else{ + if(video_rate>0) + video_quality=0; + if(video_quality==-1) + video_quality=48; + } + + if(keyframe_frequency<=0){ + /*Use a default keyframe frequency of 64 for 1-pass (streaming) mode, and + 256 for two-pass mode.*/ + keyframe_frequency=twopass?256:64; + } + + input_mask = argv[optind]; + if (!input_mask) { + fprintf(stderr, "no input files specified; run with -h for help.\n"); + exit(1); + } + /* dirname and basename must operate on scratch strings */ + scratch = strdup(input_mask); + input_directory = strdup(dirname(scratch)); + free(scratch); + scratch = strdup(input_mask); + input_filter = strdup(basename(scratch)); + free(scratch); + +#ifdef DEBUG + fprintf(stderr, "scanning %s with filter '%s'\n", + input_directory, input_filter); +#endif + n = scandir (input_directory, &png_files, include_files, alphasort); + + if (!n) { + fprintf(stderr, "no input files found; run with -h for help.\n"); + exit(1); + } + + ogg_fp = fopen(option_output, "wb"); + if(!ogg_fp) { + fprintf(stderr, "%s: error: %s\n", + option_output, "couldn't open output file"); + return 1; + } + + srand(time(NULL)); + if(ogg_stream_init(&ogg_os, rand())) { + fprintf(stderr, "%s: error: %s\n", + option_output, "couldn't create ogg stream state"); + return 1; + } + + for(passno=(twopass==3?1:twopass);passno<=(twopass==3?2:twopass);passno++){ + unsigned int w; + unsigned int h; + char input_png[1024]; + th_ycbcr_buffer ycbcr; + + ycbcr[0].data = 0; + int last = 0; + + snprintf(input_png, 1023,"%s/%s", input_directory, png_files[0]->d_name); + if(png_read(input_png, &w, &h, ycbcr)) { + fprintf(stderr, "could not read %s\n", input_png); + exit(1); + } + + if (passno!=2) fprintf(stderr,"%d frames, %dx%d\n",n,w,h); + + /* setup complete. Raw processing loop */ + switch(passno){ + case 0: case 2: + fprintf(stderr,"\rCompressing.... \n"); + break; + case 1: + fprintf(stderr,"\rScanning first pass.... \n"); + break; + } + + fprintf(stderr, "%s\n", input_png); + + th_info_init(&ti); + ti.frame_width = ((w + 15) >>4)<<4; + ti.frame_height = ((h + 15)>>4)<<4; + ti.pic_width = w; + ti.pic_height = h; + ti.pic_x = 0; + ti.pic_y = 0; + ti.fps_numerator = video_fps_numerator; + ti.fps_denominator = video_fps_denominator; + ti.aspect_numerator = video_aspect_numerator; + ti.aspect_denominator = video_aspect_denominator; + ti.colorspace = TH_CS_UNSPECIFIED; + ti.pixel_fmt = chroma_format; + ti.target_bitrate = video_rate; + ti.quality = video_quality; + ti.keyframe_granule_shift=ilog(keyframe_frequency-1); + + td=th_encode_alloc(&ti); + th_info_clear(&ti); + /* setting just the granule shift only allows power-of-two keyframe + spacing. Set the actual requested spacing. */ + ret=th_encode_ctl(td,TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE, + &keyframe_frequency,sizeof(keyframe_frequency-1)); + if(ret<0){ + fprintf(stderr,"Could not set keyframe interval to %d.\n",(int)keyframe_frequency); + } + if(vp3_compatible){ + ret=th_encode_ctl(td,TH_ENCCTL_SET_VP3_COMPATIBLE,&vp3_compatible, + sizeof(vp3_compatible)); + if(ret<0||!vp3_compatible){ + fprintf(stderr,"Could not enable strict VP3 compatibility.\n"); + if(ret>=0){ + fprintf(stderr,"Ensure your source format is supported by VP3.\n"); + fprintf(stderr, + "(4:2:0 pixel format, width and height multiples of 16).\n"); + } + } + } + if(soft_target){ + /* reverse the rate control flags to favor a 'long time' strategy */ + int arg = TH_RATECTL_CAP_UNDERFLOW; + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_FLAGS,&arg,sizeof(arg)); + if(ret<0) + fprintf(stderr,"Could not set encoder flags for --soft-target\n"); + /* Default buffer control is overridden on two-pass */ + if(!twopass&&buf_delay<0){ + if((keyframe_frequency*7>>1) > 5*video_fps_numerator/video_fps_denominator) + arg=keyframe_frequency*7>>1; + else + arg=5*video_fps_numerator/video_fps_denominator; + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_BUFFER,&arg,sizeof(arg)); + if(ret<0) + fprintf(stderr,"Could not set rate control buffer for --soft-target\n"); + } + } + /* set up two-pass if needed */ + if(passno==1){ + unsigned char *buffer; + int bytes; + bytes=th_encode_ctl(td,TH_ENCCTL_2PASS_OUT,&buffer,sizeof(buffer)); + if(bytes<0){ + fprintf(stderr,"Could not set up the first pass of two-pass mode.\n"); + fprintf(stderr,"Did you remember to specify an estimated bitrate?\n"); + exit(1); + } + /*Perform a seek test to ensure we can overwrite this placeholder data at + the end; this is better than letting the user sit through a whole + encode only to find out their pass 1 file is useless at the end.*/ + if(fseek(twopass_file,0,SEEK_SET)<0){ + fprintf(stderr,"Unable to seek in two-pass data file.\n"); + exit(1); + } + if(fwrite(buffer,1,bytes,twopass_file)=0){ + ret=th_encode_ctl(td,TH_ENCCTL_SET_RATE_BUFFER, + &buf_delay,sizeof(buf_delay)); + if(ret<0){ + fprintf(stderr,"Warning: could not set desired buffer delay.\n"); + } + } + /* write the bitstream header packets with proper page interleave */ + th_comment_init(&tc); + /* first packet will get its own page automatically */ + if(th_encode_flushheader(td,&tc,&op)<=0){ + fprintf(stderr,"Internal Theora library error.\n"); + exit(1); + } + th_comment_clear(&tc); + if(passno!=1){ + ogg_stream_packetin(&ogg_os,&op); + if(ogg_stream_pageout(&ogg_os,&og)!=1){ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + fwrite(og.header,1,og.header_len,ogg_fp); + fwrite(og.body,1,og.body_len,ogg_fp); + } + /* create the remaining theora headers */ + for(;;){ + ret=th_encode_flushheader(td,&tc,&op); + if(ret<0){ + fprintf(stderr,"Internal Theora library error.\n"); + exit(1); + } + else if(!ret)break; + if(passno!=1)ogg_stream_packetin(&ogg_os,&op); + } + /* Flush the rest of our headers. This ensures + the actual data in each stream will start + on a new page, as per spec. */ + if(passno!=1){ + for(;;){ + int result = ogg_stream_flush(&ogg_os,&og); + if(result<0){ + /* can't get here */ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + if(result==0)break; + fwrite(og.header,1,og.header_len,ogg_fp); + fwrite(og.body,1,og.body_len,ogg_fp); + } + } + + i=0; last=0; + do { + if(i >= n-1) last = 1; + if(theora_write_frame(ycbcr, last)) { + fprintf(stderr,"Encoding error.\n"); + exit(1); + } + + i++; + if (!last) { + snprintf(input_png, 1023,"%s/%s", input_directory, png_files[i]->d_name); + if(png_read(input_png, &w, &h, ycbcr)) { + fprintf(stderr, "could not read %s\n", input_png); + exit(1); + } + fprintf(stderr, "%s\n", input_png); + } + } while (!last); + + if(passno==1){ + /* need to read the final (summary) packet */ + unsigned char *buffer; + int bytes = th_encode_ctl(td, TH_ENCCTL_2PASS_OUT, &buffer, sizeof(buffer)); + if(bytes<0){ + fprintf(stderr,"Could not read two-pass summary data from encoder.\n"); + exit(1); + } + if(fseek(twopass_file,0,SEEK_SET)<0){ + fprintf(stderr,"Unable to seek in two-pass data file.\n"); + exit(1); + } + if(fwrite(buffer,1,bytes,twopass_file) +#endif + +#include +#include +#include +#include +#include +#include +#include "theora/theora.h" +#include "vorbis/codec.h" + +#ifdef WIN32 +#include +#include +#endif + +#include +#include + +/* for portaudio */ +#define FRAMES_PER_BUFFER (256) + +/*start of portaudio helper functions, extracted from pablio directory*/ + +/* Pa_streamio routines modified by mauricio at xiph.org + * Modified version of Portable Audio Blocking read/write utility. + * from the original PABLIO files + * Modified to support only playback buffers, direct access + * to the underlying stream time and remove blocking operations*/ + +/* PortAudio copyright notice follows */ + +/* + * Author: Phil Burk, http://www.softsynth.com + * + * This program uses the PortAudio Portable Audio Library. + * For more information see: http://www.audiomulch.com/portaudio/ + * Copyright (c) 1999-2000 Ross Bencina and Phil Burk + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files + * (the "Software"), to deal in the Software without restriction, + * including without limitation the rights to use, copy, modify, merge, + * publish, distribute, sublicense, and/or sell copies of the Software, + * and to permit persons to whom the Software is furnished to do so, + * subject to the following conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + */ + +typedef struct +{ + long bufferSize; /* Number of bytes in FIFO. Power of 2. Set by RingBuffer_Init. */ +/* These are declared volatile because they are written by a different thread than the reader. */ + volatile long writeIndex; /* Index of next writable byte. Set by RingBuffer_AdvanceWriteIndex. */ + volatile long readIndex; /* Index of next readable byte. Set by RingBuffer_AdvanceReadIndex. */ + long bigMask; /* Used for wrapping indices with extra bit to distinguish full/empty. */ + long smallMask; /* Used for fitting indices to buffer. */ + char *buffer; +} +RingBuffer; + +typedef struct +{ + RingBuffer outFIFO; + PortAudioStream *stream; + int bytesPerFrame; + int samplesPerFrame; +} +PASTREAMIO_Stream; + +/* Values for flags for OpenAudioStream(). */ +/* Keep PABLIO ones*/ + +#define PASTREAMIO_READ (1<<0) +#define PASTREAMIO_WRITE (1<<1) +#define PASTREAMIO_READ_WRITE (PABLIO_READ|PABLIO_WRITE) +#define PASTREAMIO_MONO (1<<2) +#define PASTREAMIO_STEREO (1<<3) + +/*************************************************************************** +** Helper function added to report stream time. */ + +PaTimestamp GetAudioStreamTime( PASTREAMIO_Stream *aStream ){ + return Pa_StreamTime( aStream->stream ) ; +} + + /*************************************************************************** +** Clear buffer. Should only be called when buffer is NOT being read. */ +void RingBuffer_Flush( RingBuffer *rbuf ) +{ + rbuf->writeIndex = rbuf->readIndex = 0; +} + +/*************************************************************************** + * Initialize FIFO. + * numBytes must be power of 2, returns -1 if not. + */ +long RingBuffer_Init( RingBuffer *rbuf, long numBytes, void *dataPtr ) +{ + if( ((numBytes-1) & numBytes) != 0) return -1; /* Not Power of two. */ + rbuf->bufferSize = numBytes; + rbuf->buffer = (char *)dataPtr; + RingBuffer_Flush( rbuf ); + rbuf->bigMask = (numBytes*2)-1; + rbuf->smallMask = (numBytes)-1; + return 0; +} +/*************************************************************************** +** Return number of bytes available for reading. */ +long RingBuffer_GetReadAvailable( RingBuffer *rbuf ) +{ + return ( (rbuf->writeIndex - rbuf->readIndex) & rbuf->bigMask ); +} +/*************************************************************************** +** Return number of bytes available for writing. */ +long RingBuffer_GetWriteAvailable( RingBuffer *rbuf ) +{ + return ( rbuf->bufferSize - RingBuffer_GetReadAvailable(rbuf)); +} + + +/*************************************************************************** +** Get address of region(s) to which we can write data. +** If the region is contiguous, size2 will be zero. +** If non-contiguous, size2 will be the size of second region. +** Returns room available to be written or numBytes, whichever is smaller. +*/ +long RingBuffer_GetWriteRegions( RingBuffer *rbuf, long numBytes, + void **dataPtr1, long *sizePtr1, + void **dataPtr2, long *sizePtr2 ) +{ + long index; + long available = RingBuffer_GetWriteAvailable( rbuf ); + if( numBytes > available ) numBytes = available; + /* Check to see if write is not contiguous. */ + index = rbuf->writeIndex & rbuf->smallMask; + if( (index + numBytes) > rbuf->bufferSize ) + { + /* Write data in two blocks that wrap the buffer. */ + long firstHalf = rbuf->bufferSize - index; + *dataPtr1 = &rbuf->buffer[index]; + *sizePtr1 = firstHalf; + *dataPtr2 = &rbuf->buffer[0]; + *sizePtr2 = numBytes - firstHalf; + } + else + { + *dataPtr1 = &rbuf->buffer[index]; + *sizePtr1 = numBytes; + *dataPtr2 = NULL; + *sizePtr2 = 0; + } + return numBytes; +} + + +/*************************************************************************** +*/ +long RingBuffer_AdvanceWriteIndex( RingBuffer *rbuf, long numBytes ) +{ + return rbuf->writeIndex = (rbuf->writeIndex + numBytes) & rbuf->bigMask; +} + +/*************************************************************************** +** Get address of region(s) from which we can read data. +** If the region is contiguous, size2 will be zero. +** If non-contiguous, size2 will be the size of second region. +** Returns room available to be written or numBytes, whichever is smaller. +*/ +long RingBuffer_GetReadRegions( RingBuffer *rbuf, long numBytes, + void **dataPtr1, long *sizePtr1, + void **dataPtr2, long *sizePtr2 ) +{ + long index; + long available = RingBuffer_GetReadAvailable( rbuf ); + if( numBytes > available ) numBytes = available; + /* Check to see if read is not contiguous. */ + index = rbuf->readIndex & rbuf->smallMask; + if( (index + numBytes) > rbuf->bufferSize ) + { + /* Write data in two blocks that wrap the buffer. */ + long firstHalf = rbuf->bufferSize - index; + *dataPtr1 = &rbuf->buffer[index]; + *sizePtr1 = firstHalf; + *dataPtr2 = &rbuf->buffer[0]; + *sizePtr2 = numBytes - firstHalf; + } + else + { + *dataPtr1 = &rbuf->buffer[index]; + *sizePtr1 = numBytes; + *dataPtr2 = NULL; + *sizePtr2 = 0; + } + return numBytes; +} +/*************************************************************************** +*/ +long RingBuffer_AdvanceReadIndex( RingBuffer *rbuf, long numBytes ) +{ + return rbuf->readIndex = (rbuf->readIndex + numBytes) & rbuf->bigMask; +} + +/*************************************************************************** +** Return bytes written. */ +long RingBuffer_Write( RingBuffer *rbuf, void *data, long numBytes ) +{ + long size1, size2, numWritten; + void *data1, *data2; + numWritten = RingBuffer_GetWriteRegions( rbuf, numBytes, &data1, &size1, &data2, &size2 ); + if( size2 > 0 ) + { + + memcpy( data1, data, size1 ); + data = ((char *)data) + size1; + memcpy( data2, data, size2 ); + } + else + { + memcpy( data1, data, size1 ); + } + RingBuffer_AdvanceWriteIndex( rbuf, numWritten ); + return numWritten; +} + +/*************************************************************************** +** Return bytes read. */ +long RingBuffer_Read( RingBuffer *rbuf, void *data, long numBytes ) +{ + long size1, size2, numRead; + void *data1, *data2; + numRead = RingBuffer_GetReadRegions( rbuf, numBytes, &data1, &size1, &data2, &size2 ); + if( size2 > 0 ) + { + memcpy( data, data1, size1 ); + data = ((char *)data) + size1; + memcpy( data, data2, size2 ); + } + else + { + memcpy( data, data1, size1 ); + } + RingBuffer_AdvanceReadIndex( rbuf, numRead ); + return numRead; +} + + +/************************************************************************/ +/******** Functions *****************************************************/ +/************************************************************************/ + +/* Called from PortAudio. + * Read and write data only if there is room in FIFOs. + */ +static int audioIOCallback( void *inputBuffer, void *outputBuffer, + unsigned long framesPerBuffer, + PaTimestamp outTime, void *userData ) +{ + PASTREAMIO_Stream *data = (PASTREAMIO_Stream*)userData; + long numBytes = data->bytesPerFrame * framesPerBuffer; + (void) outTime; + (void) inputBuffer; + + if( outputBuffer != NULL ) + { + int i; + int numRead = RingBuffer_Read( &data->outFIFO, outputBuffer, numBytes ); + /* Zero out remainder of buffer if we run out of data. */ + for( i=numRead; ibuffer ) free( rbuf->buffer ); + rbuf->buffer = NULL; + return paNoError; +} + +/************************************************************ + * Write data to ring buffer. + * Will not return until all the data has been written. + */ +long WriteAudioStream( PASTREAMIO_Stream *aStream, void *data, long numFrames ) +{ + long bytesWritten; + char *p = (char *) data; + long numBytes = aStream->bytesPerFrame * numFrames; + while( numBytes > 0) + { + bytesWritten = RingBuffer_Write( &aStream->outFIFO, p, numBytes ); + numBytes -= bytesWritten; + p += bytesWritten; + if( numBytes > 0) Pa_Sleep(10); + } + return numFrames; +} + + +/************************************************************ + * Return the number of frames that could be written to the stream without + * having to wait. + */ +long GetAudioStreamWriteable( PASTREAMIO_Stream *aStream ) +{ + int bytesEmpty = RingBuffer_GetWriteAvailable( &aStream->outFIFO ); + return bytesEmpty / aStream->bytesPerFrame; +} + + + +/************************************************************/ +unsigned long RoundUpToNextPowerOf2( unsigned long n ) +{ + long numBits = 0; + if( ((n-1) & n) == 0) return n; /* Already Power of two. */ + while( n > 0 ) + { + n= n>>1; + numBits++; + } + return (1<samplesPerFrame = ((flags&PASTREAMIO_MONO) != 0) ? 1 : 2; + aStream->bytesPerFrame = bytesPerSample * aStream->samplesPerFrame; + + /* Initialize PortAudio */ + err = Pa_Initialize(); + if( err != paNoError ) goto error; + + /* Warning: numFrames must be larger than amount of data processed per interrupt + * inside PA to prevent glitches. Just to be safe, adjust size upwards. + */ + minNumBuffers = 2 * Pa_GetMinNumBuffers( FRAMES_PER_BUFFER, sampleRate ); + numFrames = minNumBuffers * FRAMES_PER_BUFFER; + numFrames = RoundUpToNextPowerOf2( numFrames ); + + /* Initialize Ring Buffer */ + doWrite = ((flags & PASTREAMIO_WRITE) != 0); + + if(doWrite) + { + err = PASTREAMIO_InitFIFO( &aStream->outFIFO, numFrames, aStream->bytesPerFrame ); + if( err != paNoError ) goto error; + /* Make Write FIFO appear full initially. + numBytes = RingBuffer_GetWriteAvailable( &aStream->outFIFO ); + RingBuffer_AdvanceWriteIndex( &aStream->outFIFO, numBytes );*/ + } + + /* Open a PortAudio stream that we will use to communicate with the underlying + * audio drivers. */ + err = Pa_OpenStream( + &aStream->stream, + paNoDevice, + 0 , + format, + NULL, + Pa_GetDefaultOutputDeviceID() , + aStream->samplesPerFrame , + format, + NULL, + sampleRate, + FRAMES_PER_BUFFER, + minNumBuffers, + paClipOff, /* we won't output out of range samples so don't bother clipping them */ + audioIOCallback, + aStream ); + if( err != paNoError ) goto error; + + *rwblPtr = aStream; + return paNoError; + +error: + CloseAudioStream( aStream ); + *rwblPtr = NULL; + return err; +} + +PaError StartAudioStream( PASTREAMIO_Stream *aStream) +{ + PaError err; + err = Pa_StartStream( aStream->stream ); + if( err != paNoError ) goto error; + + return paNoError; +error: + CloseAudioStream( aStream ); + return err; +} + + +/************************************************************/ +PaError CloseAudioStream( PASTREAMIO_Stream *aStream ) +{ + PaError err; + int bytesEmpty; + int byteSize = aStream->outFIFO.bufferSize; + + /* If we are writing data, make sure we play everything written. */ + if( byteSize > 0 ) + { + bytesEmpty = RingBuffer_GetWriteAvailable( &aStream->outFIFO ); + while( bytesEmpty < byteSize ) + { + Pa_Sleep( 10 ); + bytesEmpty = RingBuffer_GetWriteAvailable( &aStream->outFIFO ); + } + } + + err = Pa_StopStream( aStream->stream ); + if( err != paNoError ) goto error; + err = Pa_CloseStream( aStream->stream ); + if( err != paNoError ) goto error; + Pa_Terminate(); + +error: + PASTREAMIO_TermFIFO( &aStream->outFIFO ); + free( aStream ); + return err; +} + +/* -- end of portaudio specific routines --*/ + +/* portaudio related global types */ +#define PA_SAMPLE_TYPE paInt16 +typedef short SAMPLE; +#define SAMPLE_SILENCE (0) + +PASTREAMIO_Stream *aOutStream; /* our modified stream buffer*/ +SAMPLE *samples; /*local buffer for samples*/ +double latency_sec = 0; + +/* ticks information to be used if the audio stream is not present */ +int currentTicks = -1; + +/* initial state of the audio stream */ +int isPlaying = 0; +PaError err; + +/* Ogg and codec state for demux/decode */ +ogg_sync_state oy; +ogg_page og; +ogg_stream_state vo; +ogg_stream_state to; +theora_info ti; +theora_comment tc; +theora_state td; +vorbis_info vi; +vorbis_dsp_state vd; +vorbis_block vb; +vorbis_comment vc; + +int theora_p=0; +int vorbis_p=0; +int stateflag=0; + +FILE * infile = NULL; + +/* SDL Video playback structures */ +SDL_Surface *screen; +SDL_Overlay *yuv_overlay; +SDL_Rect rect; + +/* single frame video buffering */ +int videobuf_ready=0; +ogg_int64_t videobuf_granulepos=-1; +double videobuf_time=0; + +int audiobuf_ready=0; +ogg_int64_t audiobuf_granulepos=0; /* time position of last sample */ + +static int open_audio(){ + /* this will open one circular audio stream */ + /* build on top of portaudio routines */ + /* implementation based on file pastreamio.c */ + + int numSamples; + int numBytes; + + int minNumBuffers; + int numFrames; + + minNumBuffers = 2 * Pa_GetMinNumBuffers( FRAMES_PER_BUFFER, vi.rate ); + numFrames = minNumBuffers * FRAMES_PER_BUFFER; + numFrames = RoundUpToNextPowerOf2( numFrames ); + + numSamples = numFrames * vi.channels; + numBytes = numSamples * sizeof(SAMPLE); + + samples = (SAMPLE *) malloc( numBytes ); + + /* store our latency calculation here */ + latency_sec = (double) numFrames / vi.rate / vi.channels; + printf( "Latency: %.04f\n", latency_sec ); + + err = OpenAudioStream( &aOutStream, vi.rate, PA_SAMPLE_TYPE, + (PASTREAMIO_WRITE | PASTREAMIO_STEREO) ); + if( err != paNoError ) goto error; + return err; +error: + CloseAudioStream( aOutStream ); + printf( "An error occured while opening the portaudio stream\n" ); + printf( "Error number: %d\n", err ); + printf( "Error message: %s\n", Pa_GetErrorText( err ) ); + return err; + +} + +static int start_audio(){ + err = StartAudioStream(aOutStream); + if( err != paNoError ) goto error; + + return err; +error: + CloseAudioStream( aOutStream ); + printf( "An error occured while opening the portaudio stream\n" ); + printf( "Error number: %d\n", err ); + printf( "Error message: %s\n", Pa_GetErrorText( err ) ); + return err; +} + +static int audio_close(void){ + err = CloseAudioStream( aOutStream ); + if( err != paNoError ) goto error; + + free(samples); + return err; +error: + Pa_Terminate(); + printf( "An error occured while closing the portaudio stream\n" ); + printf( "Error number: %d\n", err ); + printf( "Error message: %s\n", Pa_GetErrorText( err ) ); + return err; +} + + +double get_time() { + static Uint32 startticks = 0; + double curtime; + if (vorbis_p) { + /* not entirely accurate with the WAVE OUT device, but good enough + at this stage. Needs to be reworked to account for blank audio + data written to the stream... */ + curtime = (double) (GetAudioStreamTime( aOutStream ) / vi.rate) - latency_sec; + if (curtime<0.0) curtime = 0.0; + } else { + /* initialize timer variable if not set yet */ + if (startticks==0) + startticks = SDL_GetTicks(); + curtime = 1.0e-3 * (double)(SDL_GetTicks() - startticks); + } + return curtime; +} + + +static void open_video(void){ + /* taken from player_sample.c test file for theora alpha */ + + if ( SDL_Init(SDL_INIT_VIDEO) < 0 ) { + printf("Unable to initialize SDL: %s\n", SDL_GetError()); + exit(1); + } + + screen = SDL_SetVideoMode(ti.frame_width, ti.frame_height, 0, SDL_SWSURFACE); + if ( screen == NULL ) { + printf("Unable to set %dx%d video mode: %s\n", + ti.frame_width,ti.frame_height,SDL_GetError()); + exit(1); + } + + yuv_overlay = SDL_CreateYUVOverlay(ti.frame_width, ti.frame_height, + SDL_YV12_OVERLAY, + screen); + if ( yuv_overlay == NULL ) { + printf("SDL: Couldn't create SDL_yuv_overlay: %s\n", + SDL_GetError()); + exit(1); + } + rect.x = 0; + rect.y = 0; + rect.w = ti.frame_width; + rect.h = ti.frame_height; + + SDL_DisplayYUVOverlay(yuv_overlay, &rect); +} + +static void video_write(void){ + /* taken from player_sample.c test file for theora alpha */ + int i; + yuv_buffer yuv; + int crop_offset; + theora_decode_YUVout(&td,&yuv); + + /* Lock SDL_yuv_overlay */ + if ( SDL_MUSTLOCK(screen) ) { + if ( SDL_LockSurface(screen) < 0 ) return; + } + if (SDL_LockYUVOverlay(yuv_overlay) < 0) return; + + /* let's draw the data (*yuv[3]) on a SDL screen (*screen) */ + /* deal with border stride */ + /* reverse u and v for SDL */ + /* and crop input properly, respecting the encoded frame rect */ + crop_offset=ti.offset_x+yuv.y_stride*ti.offset_y; + for(i=0;ih;i++) + memcpy(yuv_overlay->pixels[0]+yuv_overlay->pitches[0]*i, + yuv.y+crop_offset+yuv.y_stride*i, + yuv_overlay->w); + crop_offset=(ti.offset_x/2)+(yuv.uv_stride)*(ti.offset_y/2); + for(i=0;ih/2;i++){ + memcpy(yuv_overlay->pixels[1]+yuv_overlay->pitches[1]*i, + yuv.v+crop_offset+yuv.uv_stride*i, + yuv_overlay->w/2); + memcpy(yuv_overlay->pixels[2]+yuv_overlay->pitches[2]*i, + yuv.u+crop_offset+yuv.uv_stride*i, + yuv_overlay->w/2); + } + + /* Unlock SDL_yuv_overlay */ + SDL_UnlockYUVOverlay(yuv_overlay); + if ( SDL_MUSTLOCK(screen) ) { + SDL_UnlockSurface(screen); + } + + /* Show, baby, show! */ + SDL_DisplayYUVOverlay(yuv_overlay, &rect); +} + +static void usage(void){ + printf("Usage: splayer \n" +#ifdef WIN32 + "\n" + "or drag and drop an ogg file over the .exe\n\n" +#endif + ); +} + +/* dump the theora (or vorbis) comment header */ +static int dump_comments(theora_comment *tc){ + int i, len; + char *value; + + printf("Encoded by %s\n",tc->vendor); + if(tc->comments){ + printf("theora comment header:\n"); + for(i=0;icomments;i++){ + if(tc->user_comments[i]){ + len=tc->comment_lengths[i]; + value=malloc(len+1); + memcpy(value,tc->user_comments[i],len); + value[len]='\0'; + printf("\t%s\n", value); + free(value); + } + } + } + return(0); +} + +/* Report the encoder-specified colorspace for the video, if any. + We don't actually make use of the information in this example; + a real player should attempt to perform color correction for + whatever display device it supports. */ +static void report_colorspace(theora_info *ti) +{ + switch(ti->colorspace){ + case OC_CS_UNSPECIFIED: + /* nothing to report */ + break;; + case OC_CS_ITU_REC_470M: + fprintf(stderr," encoder specified ITU Rec 470M color.\n"); + break;; + case OC_CS_ITU_REC_470BG: + fprintf(stderr," encoder specified ITU Rec 470BG color.\n"); + break;; + default: + fprintf(stderr,"warning: encoder specified unknown colorspace (%d).\n", + ti->colorspace); + break;; + } +} + +/* Helper; just grab some more compressed bitstream and sync it for + page extraction */ +int buffer_data(ogg_sync_state *oy){ + char *buffer=ogg_sync_buffer(oy,4096); + int bytes=fread(buffer,1,4096,infile); + ogg_sync_wrote(oy,bytes); + return(bytes); +} + +/* helper: push a page into the appropriate stream */ +/* this can be done blindly; a stream won't accept a page + that doesn't belong to it */ +static int queue_page(ogg_page *page){ + if(theora_p)ogg_stream_pagein(&to,page); + if(vorbis_p)ogg_stream_pagein(&vo,page); + return 0; +} + +void parseHeaders(){ + /* extracted from player_sample.c test file for theora alpha */ + ogg_packet op; + /* Parse the headers */ + /* Only interested in Vorbis/Theora streams */ + while(!stateflag){ + int ret=buffer_data(&oy); + if(ret==0)break; + while(ogg_sync_pageout(&oy,&og)>0){ + ogg_stream_state test; + + /* is this a mandated initial header? If not, stop parsing */ + if(!ogg_page_bos(&og)){ + /* don't leak the page; get it into the appropriate stream */ + queue_page(&og); + stateflag=1; + break; + } + + ogg_stream_init(&test,ogg_page_serialno(&og)); + ogg_stream_pagein(&test,&og); + ogg_stream_packetout(&test,&op); + + /* identify the codec: try theora */ + if(!theora_p && theora_decode_header(&ti,&tc,&op)>=0){ + /* it is theora */ + memcpy(&to,&test,sizeof(test)); + theora_p=1; + }else if(!vorbis_p && vorbis_synthesis_headerin(&vi,&vc,&op)>=0){ + /* it is vorbis */ + memcpy(&vo,&test,sizeof(test)); + vorbis_p=1; + }else{ + /* whatever it is, we don't care about it */ + ogg_stream_clear(&test); + } + } + } + + /* we've now identified all the bitstreams. parse the secondary header packets. */ + while((theora_p && theora_p<3) || (vorbis_p && vorbis_p<3)){ + int ret; + + /* look for further theora headers */ + while(theora_p && (theora_p<3) && (ret=ogg_stream_packetout(&to,&op))){ + if(ret<0){ + printf("Error parsing Theora stream headers; corrupt stream?\n"); + exit(1); + } + if(theora_decode_header(&ti,&tc,&op)){ + printf("Error parsing Theora stream headers; corrupt stream?\n"); + exit(1); + } + theora_p++; + if(theora_p==3)break; + } + + /* look for more vorbis header packets */ + while(vorbis_p && (vorbis_p<3) && (ret=ogg_stream_packetout(&vo,&op))){ + if(ret<0){ + printf("Error parsing Vorbis stream headers; corrupt stream?\n"); + exit(1); + } + if(vorbis_synthesis_headerin(&vi,&vc,&op)){ + printf("Error parsing Vorbis stream headers; corrupt stream?\n"); + exit(1); + } + vorbis_p++; + if(vorbis_p==3)break; + } + + /* The header pages/packets will arrive before anything else we + care about, or the stream is not obeying spec */ + + if(ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); /* demux into the appropriate stream */ + }else{ + int ret=buffer_data(&oy); + if(ret==0){ + fprintf(stderr,"End of file while searching for codec headers.\n"); + exit(1); + } + } + } +} + +int main( int argc, char* argv[] ){ + + int i,j; + ogg_packet op; + SDL_Event event; + int hasdatatobuffer = 1; + int playbackdone = 0; + double now, delay, last_frame_time = 0; + + int frameNum=0; + int skipNum=0; + + /* takes first argument as file to play */ + /* this works better on Windows and is more convenient + for drag and drop ogg files over the .exe */ + + if( argc != 2 ) + { + usage(); + exit(0); + } + + infile = fopen( argv[1], "rb" ); + + /* start up Ogg stream synchronization layer */ + ogg_sync_init(&oy); + + /* init supporting Vorbis structures needed in header parsing */ + vorbis_info_init(&vi); + vorbis_comment_init(&vc); + + /* init supporting Theora structures needed in header parsing */ + theora_comment_init(&tc); + theora_info_init(&ti); + + parseHeaders(); + + /* force audio off */ + /* vorbis_p = 0; */ + + /* initialize decoders */ + if(theora_p){ + theora_decode_init(&td,&ti); + printf("Ogg logical stream %x is Theora %dx%d %.02f fps video\n" + " Frame content is %dx%d with offset (%d,%d).\n", + to.serialno,ti.width,ti.height, (double)ti.fps_numerator/ti.fps_denominator, + ti.frame_width, ti.frame_height, ti.offset_x, ti.offset_y); + report_colorspace(&ti); + dump_comments(&tc); + }else{ + /* tear down the partial theora setup */ + theora_info_clear(&ti); + theora_comment_clear(&tc); + } + if(vorbis_p){ + vorbis_synthesis_init(&vd,&vi); + vorbis_block_init(&vd,&vb); + printf("Ogg logical stream %x is Vorbis %d channel %d Hz audio.\n", + vo.serialno,vi.channels,vi.rate); + }else{ + /* tear down the partial vorbis setup */ + vorbis_info_clear(&vi); + vorbis_comment_clear(&vc); + } + /* open audio */ + if(vorbis_p)open_audio(); + /* open video */ + if(theora_p)open_video(); + + /* our main loop */ + while(!playbackdone){ + + /* break out on SDL quit event */ + if ( SDL_PollEvent ( &event ) ) + { + if ( event.type == SDL_QUIT ) break ; + } + + /* get some audio data */ + while(vorbis_p && !audiobuf_ready){ + int ret; + float **pcm; + int count = 0; + int maxBytesToWrite; + + /* is there pending audio? does it fit our circular buffer without blocking? */ + ret=vorbis_synthesis_pcmout(&vd,&pcm); + maxBytesToWrite = GetAudioStreamWriteable(aOutStream); + + if (maxBytesToWrite<=FRAMES_PER_BUFFER){ + /* break out until there is a significant amount of + data to avoid a series of small write operations. */ + break; + } + /* if there's pending, decoded audio, grab it */ + if((ret>0)&&(maxBytesToWrite>0)){ + + for(i=0;i32767)val=32767; + if(val<-32768)val=-32768; + samples[count]=val; + count++; + } + if(WriteAudioStream( aOutStream, samples, i )) { + if(count==maxBytesToWrite){ + audiobuf_ready=1; + } + } + vorbis_synthesis_read(&vd,i); + + if(vd.granulepos>=0) + audiobuf_granulepos=vd.granulepos-ret+i; + else + audiobuf_granulepos+=i; + + }else{ + + /* no pending audio; is there a pending packet to decode? */ + if(ogg_stream_packetout(&vo,&op)>0){ + if(vorbis_synthesis(&vb,&op)==0) /* test for success! */ + vorbis_synthesis_blockin(&vd,&vb); + }else /* we need more data; break out to suck in another page */ + break; + } + } /* end audio cycle */ + + while(theora_p && !videobuf_ready){ + /* get one video packet... */ + if(ogg_stream_packetout(&to,&op)>0){ + + theora_decode_packetin(&td,&op); + + videobuf_granulepos=td.granulepos; + videobuf_time=theora_granule_time(&td,videobuf_granulepos); + /* update the frame counter */ + frameNum++; + + /* check if this frame time has not passed yet. + If the frame is late we need to decode additonal + ones and keep looping, since theora at this stage + needs to decode all frames */ + now=get_time(); + delay=videobuf_time-now; + if(delay>=0.0){ + /* got a good frame, not late, ready to break out */ + videobuf_ready=1; + }else if(now-last_frame_time>=1.0){ + /* display at least one frame per second, regardless */ + videobuf_ready=1; + }else{ + fprintf(stderr, "dropping frame %d (%.3fs behind)\n", + frameNum, -delay); + } + }else{ + /* need more data */ + break; + } + } + + if(!hasdatatobuffer && !videobuf_ready && !audiobuf_ready){ + isPlaying = 0; + playbackdone = 1; + } + + /* if we're set for the next frame, sleep */ + if((!theora_p || videobuf_ready) && + (!vorbis_p || audiobuf_ready)){ + int ticks = 1.0e3*(videobuf_time-get_time()); + if(ticks>0) + SDL_Delay(ticks); + } + + if(videobuf_ready){ + /* time to write our cached frame */ + video_write(); + videobuf_ready=0; + last_frame_time=get_time(); + + /* if audio has not started (first frame) then start it */ + if ((!isPlaying)&&(vorbis_p)){ + start_audio(); + isPlaying = 1; + } + } + + /* HACK: always look for more audio data */ + audiobuf_ready=0; + + /* buffer compressed data every loop */ + if(hasdatatobuffer){ + hasdatatobuffer=buffer_data(&oy); + if(hasdatatobuffer==0){ + printf("Ogg buffering stopped, end of file reached.\n"); + } + } + + if (ogg_sync_pageout(&oy,&og)>0){ + queue_page(&og); + } + + } /* playbackdone */ + + /* show number of video frames decoded */ + printf( "\n"); + printf( "Frames decoded: %d", frameNum ); + if(skipNum) + printf( " (only %d shown)", frameNum-skipNum); + printf( "\n" ); + + /* tear it all down */ + fclose( infile ); + + if(vorbis_p){ + audio_close(); + + ogg_stream_clear(&vo); + vorbis_block_clear(&vb); + vorbis_dsp_clear(&vd); + vorbis_comment_clear(&vc); + vorbis_info_clear(&vi); + } + if(theora_p){ + ogg_stream_clear(&to); + theora_clear(&td); + theora_comment_clear(&tc); + theora_info_clear(&ti); + } + ogg_sync_clear(&oy); + + printf("\r " + "\nDone.\n"); + + SDL_Quit(); + + return(0); + +} diff --git a/libs/libtheora-1.1/include/Makefile.am b/libs/libtheora-1.1/include/Makefile.am new file mode 100644 index 00000000..4f369ef8 --- /dev/null +++ b/libs/libtheora-1.1/include/Makefile.am @@ -0,0 +1,3 @@ +## Process this file with automake to produce Makefile.in + +SUBDIRS = theora diff --git a/libs/libtheora-1.1/include/theora/Makefile.am b/libs/libtheora-1.1/include/theora/Makefile.am new file mode 100644 index 00000000..a917c6c6 --- /dev/null +++ b/libs/libtheora-1.1/include/theora/Makefile.am @@ -0,0 +1,7 @@ +## Process this file with automake to produce Makefile.in + +theoraincludedir = $(includedir)/theora + +theorainclude_HEADERS = theora.h theoradec.h theoraenc.h codec.h + +noinst_HEADERS = codec.h theoradec.h diff --git a/libs/libtheora-1.1/include/theora/codec.h b/libs/libtheora-1.1/include/theora/codec.h new file mode 100644 index 00000000..7d1f2652 --- /dev/null +++ b/libs/libtheora-1.1/include/theora/codec.h @@ -0,0 +1,591 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: theora.h,v 1.8 2004/03/15 22:17:32 derf Exp $ + + ********************************************************************/ + +/**\mainpage + * + * \section intro Introduction + * + * This is the documentation for libtheora C API. + * The current reference + * implementation for Theora, a free, + * patent-unencumbered video codec. + * Theora is derived from On2's VP3 codec with additional features and + * integration with Ogg multimedia formats by + * the Xiph.Org Foundation. + * Complete documentation of the format itself is available in + * the Theora + * specification. + * + * \subsection Organization + * + * The functions documented here are actually subdivided into three + * separate libraries: + * - libtheoraenc contains the encoder interface, + * described in \ref encfuncs. + * - libtheoradec contains the decoder interface and + * routines shared with the encoder. + * You must also link to this if you link to libtheoraenc. + * The routines in this library are described in \ref decfuncs and + * \ref basefuncs. + * - libtheora contains the \ref oldfuncs. + * + * New code should link to libtheoradec and, if using encoder + * features, libtheoraenc. Together these two export both + * the standard and the legacy API, so this is all that is needed by + * any code. The older libtheora library is provided just for + * compatibility with older build configurations. + * + * In general the recommended 1.x API symbols can be distinguished + * by their th_ or TH_ namespace prefix. + * The older, legacy API uses theora_ or OC_ + * prefixes instead. + */ + +/**\file + * The shared libtheoradec and libtheoraenc C API. + * You don't need to include this directly.*/ + +#if !defined(_O_THEORA_CODEC_H_) +# define _O_THEORA_CODEC_H_ (1) +# include + +#if defined(__cplusplus) +extern "C" { +#endif + + + +/**\name Return codes*/ +/*@{*/ +/**An invalid pointer was provided.*/ +#define TH_EFAULT (-1) +/**An invalid argument was provided.*/ +#define TH_EINVAL (-10) +/**The contents of the header were incomplete, invalid, or unexpected.*/ +#define TH_EBADHEADER (-20) +/**The header does not belong to a Theora stream.*/ +#define TH_ENOTFORMAT (-21) +/**The bitstream version is too high.*/ +#define TH_EVERSION (-22) +/**The specified function is not implemented.*/ +#define TH_EIMPL (-23) +/**There were errors in the video data packet.*/ +#define TH_EBADPACKET (-24) +/**The decoded packet represented a dropped frame. + The player can continue to display the current frame, as the contents of the + decoded frame buffer have not changed.*/ +#define TH_DUPFRAME (1) +/*@}*/ + +/**The currently defined color space tags. + * See the Theora + * specification, Chapter 4, for exact details on the meaning + * of each of these color spaces.*/ +typedef enum{ + /**The color space was not specified at the encoder. + It may be conveyed by an external means.*/ + TH_CS_UNSPECIFIED, + /**A color space designed for NTSC content.*/ + TH_CS_ITU_REC_470M, + /**A color space designed for PAL/SECAM content.*/ + TH_CS_ITU_REC_470BG, + /**The total number of currently defined color spaces.*/ + TH_CS_NSPACES +}th_colorspace; + +/**The currently defined pixel format tags. + * See the Theora + * specification, Section 4.4, for details on the precise sample + * locations.*/ +typedef enum{ + /**Chroma decimation by 2 in both the X and Y directions (4:2:0). + The Cb and Cr chroma planes are half the width and half the + height of the luma plane.*/ + TH_PF_420, + /**Currently reserved.*/ + TH_PF_RSVD, + /**Chroma decimation by 2 in the X direction (4:2:2). + The Cb and Cr chroma planes are half the width of the luma plane, but full + height.*/ + TH_PF_422, + /**No chroma decimation (4:4:4). + The Cb and Cr chroma planes are full width and full height.*/ + TH_PF_444, + /**The total number of currently defined pixel formats.*/ + TH_PF_NFORMATS +}th_pixel_fmt; + + + +/**A buffer for a single color plane in an uncompressed image. + * This contains the image data in a left-to-right, top-down format. + * Each row of pixels is stored contiguously in memory, but successive + * rows need not be. + * Use \a stride to compute the offset of the next row. + * The encoder accepts both positive \a stride values (top-down in memory) + * and negative (bottom-up in memory). + * The decoder currently always generates images with positive strides.*/ +typedef struct{ + /**The width of this plane.*/ + int width; + /**The height of this plane.*/ + int height; + /**The offset in bytes between successive rows.*/ + int stride; + /**A pointer to the beginning of the first row.*/ + unsigned char *data; +}th_img_plane; + +/**A complete image buffer for an uncompressed frame. + * The chroma planes may be decimated by a factor of two in either + * direction, as indicated by th_info#pixel_fmt. + * The width and height of the Y' plane must be multiples of 16. + * They may need to be cropped for display, using the rectangle + * specified by th_info#pic_x, th_info#pic_y, th_info#pic_width, + * and th_info#pic_height. + * All samples are 8 bits. + * \note The term YUV often used to describe a colorspace is ambiguous. + * The exact parameters of the RGB to YUV conversion process aside, in + * many contexts the U and V channels actually have opposite meanings. + * To avoid this confusion, we are explicit: the name of the color + * channels are Y'CbCr, and they appear in that order, always. + * The prime symbol denotes that the Y channel is non-linear. + * Cb and Cr stand for "Chroma blue" and "Chroma red", respectively.*/ +typedef th_img_plane th_ycbcr_buffer[3]; + +/**Theora bitstream information. + * This contains the basic playback parameters for a stream, and corresponds to + * the initial 'info' header packet. + * To initialize an encoder, the application fills in this structure and + * passes it to th_encode_alloc(). + * A default encoding mode is chosen based on the values of the #quality and + * #target_bitrate fields. + * On decode, it is filled in by th_decode_headerin(), and then passed to + * th_decode_alloc(). + * + * Encoded Theora frames must be a multiple of 16 in size; + * this is what the #frame_width and #frame_height members represent. + * To handle arbitrary picture sizes, a crop rectangle is specified in the + * #pic_x, #pic_y, #pic_width and #pic_height members. + * + * All frame buffers contain pointers to the full, padded frame. + * However, the current encoder will not reference pixels outside of + * the cropped picture region, and the application does not need to fill them + * in. + * The decoder will allocate storage for a full frame, but the + * application should not rely on the padding containing sensible + * data. + * + * It is also generally recommended that the offsets and sizes should still be + * multiples of 2 to avoid chroma sampling shifts when chroma is sub-sampled. + * See the Theora + * specification, Section 4.4, for more details. + * + * Frame rate, in frames per second, is stored as a rational fraction, as is + * the pixel aspect ratio. + * Note that this refers to the aspect ratio of the individual pixels, not of + * the overall frame itself. + * The frame aspect ratio can be computed from pixel aspect ratio using the + * image dimensions.*/ +typedef struct{ + /**\name Theora version + * Bitstream version information.*/ + /*@{*/ + unsigned char version_major; + unsigned char version_minor; + unsigned char version_subminor; + /*@}*/ + /**The encoded frame width. + * This must be a multiple of 16, and less than 1048576.*/ + ogg_uint32_t frame_width; + /**The encoded frame height. + * This must be a multiple of 16, and less than 1048576.*/ + ogg_uint32_t frame_height; + /**The displayed picture width. + * This must be no larger than width.*/ + ogg_uint32_t pic_width; + /**The displayed picture height. + * This must be no larger than height.*/ + ogg_uint32_t pic_height; + /**The X offset of the displayed picture. + * This must be no larger than #frame_width-#pic_width or 255, whichever is + * smaller.*/ + ogg_uint32_t pic_x; + /**The Y offset of the displayed picture. + * This must be no larger than #frame_height-#pic_height, and + * #frame_height-#pic_height-#pic_y must be no larger than 255. + * This slightly funny restriction is due to the fact that the offset is + * specified from the top of the image for consistency with the standard + * graphics left-handed coordinate system used throughout this API, while + * it is stored in the encoded stream as an offset from the bottom.*/ + ogg_uint32_t pic_y; + /**\name Frame rate + * The frame rate, as a fraction. + * If either is 0, the frame rate is undefined.*/ + /*@{*/ + ogg_uint32_t fps_numerator; + ogg_uint32_t fps_denominator; + /*@}*/ + /**\name Aspect ratio + * The aspect ratio of the pixels. + * If either value is zero, the aspect ratio is undefined. + * If not specified by any external means, 1:1 should be assumed. + * The aspect ratio of the full picture can be computed as + * \code + * aspect_numerator*pic_width/(aspect_denominator*pic_height). + * \endcode */ + /*@{*/ + ogg_uint32_t aspect_numerator; + ogg_uint32_t aspect_denominator; + /*@}*/ + /**The color space.*/ + th_colorspace colorspace; + /**The pixel format.*/ + th_pixel_fmt pixel_fmt; + /**The target bit-rate in bits per second. + If initializing an encoder with this struct, set this field to a non-zero + value to activate CBR encoding by default.*/ + int target_bitrate; + /**The target quality level. + Valid values range from 0 to 63, inclusive, with higher values giving + higher quality. + If initializing an encoder with this struct, and #target_bitrate is set + to zero, VBR encoding at this quality will be activated by default.*/ + /*Currently this is set so that a qi of 0 corresponds to distortions of 24 + times the JND, and each increase by 16 halves that value. + This gives us fine discrimination at low qualities, yet effective rate + control at high qualities. + The qi value 63 is special, however. + For this, the highest quality, we use one half of a JND for our threshold. + Due to the lower bounds placed on allowable quantizers in Theora, we will + not actually be able to achieve quality this good, but this should + provide as close to visually lossless quality as Theora is capable of. + We could lift the quantizer restrictions without breaking VP3.1 + compatibility, but this would result in quantized coefficients that are + too large for the current bitstream to be able to store. + We'd have to redesign the token syntax to store these large coefficients, + which would make transcoding complex.*/ + int quality; + /**The amount to shift to extract the last keyframe number from the granule + * position. + * This can be at most 31. + * th_info_init() will set this to a default value (currently 6, + * which is good for streaming applications), but you can set it to 0 to + * make every frame a keyframe. + * The maximum distance between key frames is + * 1<<#keyframe_granule_shift. + * The keyframe frequency can be more finely controlled with + * #TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE, which can also be adjusted + * during encoding (for example, to force the next frame to be a keyframe), + * but it cannot be set larger than the amount permitted by this field after + * the headers have been output.*/ + int keyframe_granule_shift; +}th_info; + +/**The comment information. + * + * This structure holds the in-stream metadata corresponding to + * the 'comment' header packet. + * The comment header is meant to be used much like someone jotting a quick + * note on the label of a video. + * It should be a short, to the point text note that can be more than a couple + * words, but not more than a short paragraph. + * + * The metadata is stored as a series of (tag, value) pairs, in + * length-encoded string vectors. + * The first occurrence of the '=' character delimits the tag and value. + * A particular tag may occur more than once, and order is significant. + * The character set encoding for the strings is always UTF-8, but the tag + * names are limited to ASCII, and treated as case-insensitive. + * See the Theora + * specification, Section 6.3.3 for details. + * + * In filling in this structure, th_decode_headerin() will null-terminate + * the user_comment strings for safety. + * However, the bitstream format itself treats them as 8-bit clean vectors, + * possibly containing null characters, and so the length array should be + * treated as their authoritative length. + */ +typedef struct th_comment{ + /**The array of comment string vectors.*/ + char **user_comments; + /**An array of the corresponding length of each vector, in bytes.*/ + int *comment_lengths; + /**The total number of comment strings.*/ + int comments; + /**The null-terminated vendor string. + This identifies the software used to encode the stream.*/ + char *vendor; +}th_comment; + + + +/**A single base matrix.*/ +typedef unsigned char th_quant_base[64]; + +/**A set of \a qi ranges.*/ +typedef struct{ + /**The number of ranges in the set.*/ + int nranges; + /**The size of each of the #nranges ranges. + These must sum to 63.*/ + const int *sizes; + /**#nranges +1 base matrices. + Matrices \a i and i+1 form the endpoints of range \a i.*/ + const th_quant_base *base_matrices; +}th_quant_ranges; + +/**A complete set of quantization parameters. + The quantizer for each coefficient is calculated as: + \code + Q=MAX(MIN(qmin[qti][ci!=0],scale[ci!=0][qi]*base[qti][pli][qi][ci]/100), + 1024). + \endcode + + \a qti is the quantization type index: 0 for intra, 1 for inter. + ci!=0 is 0 for the DC coefficient and 1 for AC coefficients. + \a qi is the quality index, ranging between 0 (low quality) and 63 (high + quality). + \a pli is the color plane index: 0 for Y', 1 for Cb, 2 for Cr. + \a ci is the DCT coefficient index. + Coefficient indices correspond to the normal 2D DCT block + ordering--row-major with low frequencies first--\em not zig-zag order. + + Minimum quantizers are constant, and are given by: + \code + qmin[2][2]={{4,2},{8,4}}. + \endcode + + Parameters that can be stored in the bitstream are as follows: + - The two scale matrices ac_scale and dc_scale. + \code + scale[2][64]={dc_scale,ac_scale}. + \endcode + - The base matrices for each \a qi, \a qti and \a pli (up to 384 in all). + In order to avoid storing a full 384 base matrices, only a sparse set of + matrices are stored, and the rest are linearly interpolated. + This is done as follows. + For each \a qti and \a pli, a series of \a n \a qi ranges is defined. + The size of each \a qi range can vary arbitrarily, but they must sum to + 63. + Then, n+1 matrices are specified, one for each endpoint of the + ranges. + For interpolation purposes, each range's endpoints are the first \a qi + value it contains and one past the last \a qi value it contains. + Fractional values are rounded to the nearest integer, with ties rounded + away from zero. + + Base matrices are stored by reference, so if the same matrices are used + multiple times, they will only appear once in the bitstream. + The bitstream is also capable of omitting an entire set of ranges and + its associated matrices if they are the same as either the previous + set (indexed in row-major order) or if the inter set is the same as the + intra set. + + - Loop filter limit values. + The same limits are used for the loop filter in all color planes, despite + potentially differing levels of quantization in each. + + For the current encoder, scale[ci!=0][qi] must be no greater + than scale[ci!=0][qi-1] and base[qti][pli][qi][ci] must + be no greater than base[qti][pli][qi-1][ci]. + These two conditions ensure that the actual quantizer for a given \a qti, + \a pli, and \a ci does not increase as \a qi increases. + This is not required by the decoder.*/ +typedef struct{ + /**The DC scaling factors.*/ + ogg_uint16_t dc_scale[64]; + /**The AC scaling factors.*/ + ogg_uint16_t ac_scale[64]; + /**The loop filter limit values.*/ + unsigned char loop_filter_limits[64]; + /**The \a qi ranges for each \a ci and \a pli.*/ + th_quant_ranges qi_ranges[2][3]; +}th_quant_info; + + + +/**The number of Huffman tables used by Theora.*/ +#define TH_NHUFFMAN_TABLES (80) +/**The number of DCT token values in each table.*/ +#define TH_NDCT_TOKENS (32) + +/**A Huffman code for a Theora DCT token. + * Each set of Huffman codes in a given table must form a complete, prefix-free + * code. + * There is no requirement that all the tokens in a table have a valid code, + * but the current encoder is not optimized to take advantage of this. + * If each of the five grouops of 16 tables does not contain at least one table + * with a code for every token, then the encoder may fail to encode certain + * frames. + * The complete table in the first group of 16 does not have to be in the same + * place as the complete table in the other groups, but the complete tables in + * the remaining four groups must all be in the same place.*/ +typedef struct{ + /**The bit pattern for the code, with the LSbit of the pattern aligned in + * the LSbit of the word.*/ + ogg_uint32_t pattern; + /**The number of bits in the code. + * This must be between 0 and 32, inclusive.*/ + int nbits; +}th_huff_code; + + + +/**\defgroup basefuncs Functions Shared by Encode and Decode*/ +/*@{*/ +/**\name Basic shared functions*/ +/*@{*/ +/**Retrieves a human-readable string to identify the library vendor and + * version. + * \return the version string.*/ +extern const char *th_version_string(void); +/**Retrieves the library version number. + * This is the highest bitstream version that the encoder library will produce, + * or that the decoder library can decode. + * This number is composed of a 16-bit major version, 8-bit minor version + * and 8 bit sub-version, composed as follows: + * \code + * (VERSION_MAJOR<<16)+(VERSION_MINOR<<8)+(VERSION_SUBMINOR) + * \endcode + * \return the version number.*/ +extern ogg_uint32_t th_version_number(void); +/**Converts a granule position to an absolute frame index, starting at + * 0. + * The granule position is interpreted in the context of a given + * #th_enc_ctx or #th_dec_ctx handle (either will suffice). + * \param _encdec A previously allocated #th_enc_ctx or #th_dec_ctx + * handle. + * \param _granpos The granule position to convert. + * \returns The absolute frame index corresponding to \a _granpos. + * \retval -1 The given granule position was invalid (i.e. negative).*/ +extern ogg_int64_t th_granule_frame(void *_encdec,ogg_int64_t _granpos); +/**Converts a granule position to an absolute time in seconds. + * The granule position is interpreted in the context of a given + * #th_enc_ctx or #th_dec_ctx handle (either will suffice). + * \param _encdec A previously allocated #th_enc_ctx or #th_dec_ctx + * handle. + * \param _granpos The granule position to convert. + * \return The absolute time in seconds corresponding to \a _granpos. + * This is the "end time" for the frame, or the latest time it should + * be displayed. + * It is not the presentation time. + * \retval -1 The given granule position was invalid (i.e. negative).*/ +extern double th_granule_time(void *_encdec,ogg_int64_t _granpos); +/**Determines whether a Theora packet is a header or not. + * This function does no verification beyond checking the packet type bit, so + * it should not be used for bitstream identification; use + * th_decode_headerin() for that. + * As per the Theora specification, an empty (0-byte) packet is treated as a + * data packet (a delta frame with no coded blocks). + * \param _op An ogg_packet containing encoded Theora data. + * \retval 1 The packet is a header packet + * \retval 0 The packet is a video data packet.*/ +extern int th_packet_isheader(ogg_packet *_op); +/**Determines whether a theora packet is a key frame or not. + * This function does no verification beyond checking the packet type and + * key frame bits, so it should not be used for bitstream identification; use + * th_decode_headerin() for that. + * As per the Theora specification, an empty (0-byte) packet is treated as a + * delta frame (with no coded blocks). + * \param _op An ogg_packet containing encoded Theora data. + * \retval 1 The packet contains a key frame. + * \retval 0 The packet contains a delta frame. + * \retval -1 The packet is not a video data packet.*/ +extern int th_packet_iskeyframe(ogg_packet *_op); +/*@}*/ + + +/**\name Functions for manipulating header data*/ +/*@{*/ +/**Initializes a th_info structure. + * This should be called on a freshly allocated #th_info structure before + * attempting to use it. + * \param _info The #th_info struct to initialize.*/ +extern void th_info_init(th_info *_info); +/**Clears a #th_info structure. + * This should be called on a #th_info structure after it is no longer + * needed. + * \param _info The #th_info struct to clear.*/ +extern void th_info_clear(th_info *_info); + +/**Initialize a #th_comment structure. + * This should be called on a freshly allocated #th_comment structure + * before attempting to use it. + * \param _tc The #th_comment struct to initialize.*/ +extern void th_comment_init(th_comment *_tc); +/**Add a comment to an initialized #th_comment structure. + * \note Neither th_comment_add() nor th_comment_add_tag() support + * comments containing null values, although the bitstream format does + * support them. + * To add such comments you will need to manipulate the #th_comment + * structure directly. + * \param _tc The #th_comment struct to add the comment to. + * \param _comment Must be a null-terminated UTF-8 string containing the + * comment in "TAG=the value" form.*/ +extern void th_comment_add(th_comment *_tc, char *_comment); +/**Add a comment to an initialized #th_comment structure. + * \note Neither th_comment_add() nor th_comment_add_tag() support + * comments containing null values, although the bitstream format does + * support them. + * To add such comments you will need to manipulate the #th_comment + * structure directly. + * \param _tc The #th_comment struct to add the comment to. + * \param _tag A null-terminated string containing the tag associated with + * the comment. + * \param _val The corresponding value as a null-terminated string.*/ +extern void th_comment_add_tag(th_comment *_tc,char *_tag,char *_val); +/**Look up a comment value by its tag. + * \param _tc An initialized #th_comment structure. + * \param _tag The tag to look up. + * \param _count The instance of the tag. + * The same tag can appear multiple times, each with a distinct + * value, so an index is required to retrieve them all. + * The order in which these values appear is significant and + * should be preserved. + * Use th_comment_query_count() to get the legal range for + * the \a _count parameter. + * \return A pointer to the queried tag's value. + * This points directly to data in the #th_comment structure. + * It should not be modified or freed by the application, and + * modifications to the structure may invalidate the pointer. + * \retval NULL If no matching tag is found.*/ +extern char *th_comment_query(th_comment *_tc,char *_tag,int _count); +/**Look up the number of instances of a tag. + * Call this first when querying for a specific tag and then iterate over the + * number of instances with separate calls to th_comment_query() to + * retrieve all the values for that tag in order. + * \param _tc An initialized #th_comment structure. + * \param _tag The tag to look up. + * \return The number on instances of this particular tag.*/ +extern int th_comment_query_count(th_comment *_tc,char *_tag); +/**Clears a #th_comment structure. + * This should be called on a #th_comment structure after it is no longer + * needed. + * It will free all memory used by the structure members. + * \param _tc The #th_comment struct to clear.*/ +extern void th_comment_clear(th_comment *_tc); +/*@}*/ +/*@}*/ + + + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/libs/libtheora-1.1/include/theora/theora.h b/libs/libtheora-1.1/include/theora/theora.h new file mode 100644 index 00000000..a9b0b010 --- /dev/null +++ b/libs/libtheora-1.1/include/theora/theora.h @@ -0,0 +1,784 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: theora.h,v 1.17 2003/12/06 18:06:19 arc Exp $ + + ********************************************************************/ + +#ifndef _O_THEORA_H_ +#define _O_THEORA_H_ + +#ifdef __cplusplus +extern "C" +{ +#endif /* __cplusplus */ + +#include /* for size_t */ + +#include + +/** \file + * The libtheora pre-1.0 legacy C API. + * + * \ingroup oldfuncs + * + * \section intro Introduction + * + * This is the documentation for the libtheora legacy C API, declared in + * the theora.h header, which describes the old interface used before + * the 1.0 release. This API was widely deployed for several years and + * remains supported, but for new code we recommend the cleaner API + * declared in theoradec.h and theoraenc.h. + * + * libtheora is the reference implementation for + * Theora, a free video codec. + * Theora is derived from On2's VP3 codec with improved integration with + * Ogg multimedia formats by Xiph.Org. + * + * \section overview Overview + * + * This library will both decode and encode theora packets to/from raw YUV + * frames. In either case, the packets will most likely either come from or + * need to be embedded in an Ogg stream. Use + * libogg or + * liboggz + * to extract/package these packets. + * + * \section decoding Decoding Process + * + * Decoding can be separated into the following steps: + * -# initialise theora_info and theora_comment structures using + * theora_info_init() and theora_comment_init(): + \verbatim + theora_info info; + theora_comment comment; + + theora_info_init(&info); + theora_comment_init(&comment); + \endverbatim + * -# retrieve header packets from Ogg stream (there should be 3) and decode + * into theora_info and theora_comment structures using + * theora_decode_header(). See \ref identification for more information on + * identifying which packets are theora packets. + \verbatim + int i; + for (i = 0; i < 3; i++) + { + (get a theora packet "op" from the Ogg stream) + theora_decode_header(&info, &comment, op); + } + \endverbatim + * -# initialise the decoder based on the information retrieved into the + * theora_info struct by theora_decode_header(). You will need a + * theora_state struct. + \verbatim + theora_state state; + + theora_decode_init(&state, &info); + \endverbatim + * -# pass in packets and retrieve decoded frames! See the yuv_buffer + * documentation for information on how to retrieve raw YUV data. + \verbatim + yuf_buffer buffer; + while (last packet was not e_o_s) { + (get a theora packet "op" from the Ogg stream) + theora_decode_packetin(&state, op); + theora_decode_YUVout(&state, &buffer); + } + \endverbatim + * + * + * \subsection identification Identifying Theora Packets + * + * All streams inside an Ogg file have a unique serial_no attached to the + * stream. Typically, you will want to + * - retrieve the serial_no for each b_o_s (beginning of stream) page + * encountered within the Ogg file; + * - test the first (only) packet on that page to determine if it is a theora + * packet; + * - once you have found a theora b_o_s page then use the retrieved serial_no + * to identify future packets belonging to the same theora stream. + * + * Note that you \e cannot use theora_packet_isheader() to determine if a + * packet is a theora packet or not, as this function does not perform any + * checking beyond whether a header bit is present. Instead, use the + * theora_decode_header() function and check the return value; or examine the + * header bytes at the beginning of the Ogg page. + */ + + +/** \defgroup oldfuncs Legacy pre-1.0 C API */ +/* @{ */ + +/** + * A YUV buffer for passing uncompressed frames to and from the codec. + * This holds a Y'CbCr frame in planar format. The CbCr planes can be + * subsampled and have their own separate dimensions and row stride + * offsets. Note that the strides may be negative in some + * configurations. For theora the width and height of the largest plane + * must be a multiple of 16. The actual meaningful picture size and + * offset are stored in the theora_info structure; frames returned by + * the decoder may need to be cropped for display. + * + * All samples are 8 bits. Within each plane samples are ordered by + * row from the top of the frame to the bottom. Within each row samples + * are ordered from left to right. + * + * During decode, the yuv_buffer struct is allocated by the user, but all + * fields (including luma and chroma pointers) are filled by the library. + * These pointers address library-internal memory and their contents should + * not be modified. + * + * Conversely, during encode the user allocates the struct and fills out all + * fields. The user also manages the data addressed by the luma and chroma + * pointers. See the encoder_example.c and dump_video.c example files in + * theora/examples/ for more information. + */ +typedef struct { + int y_width; /**< Width of the Y' luminance plane */ + int y_height; /**< Height of the luminance plane */ + int y_stride; /**< Offset in bytes between successive rows */ + + int uv_width; /**< Width of the Cb and Cr chroma planes */ + int uv_height; /**< Height of the chroma planes */ + int uv_stride; /**< Offset between successive chroma rows */ + unsigned char *y; /**< Pointer to start of luminance data */ + unsigned char *u; /**< Pointer to start of Cb data */ + unsigned char *v; /**< Pointer to start of Cr data */ + +} yuv_buffer; + +/** + * A Colorspace. + */ +typedef enum { + OC_CS_UNSPECIFIED, /**< The colorspace is unknown or unspecified */ + OC_CS_ITU_REC_470M, /**< This is the best option for 'NTSC' content */ + OC_CS_ITU_REC_470BG, /**< This is the best option for 'PAL' content */ + OC_CS_NSPACES /**< This marks the end of the defined colorspaces */ +} theora_colorspace; + +/** + * A Chroma subsampling + * + * These enumerate the available chroma subsampling options supported + * by the theora format. See Section 4.4 of the specification for + * exact definitions. + */ +typedef enum { + OC_PF_420, /**< Chroma subsampling by 2 in each direction (4:2:0) */ + OC_PF_RSVD, /**< Reserved value */ + OC_PF_422, /**< Horizonatal chroma subsampling by 2 (4:2:2) */ + OC_PF_444 /**< No chroma subsampling at all (4:4:4) */ +} theora_pixelformat; + +/** + * Theora bitstream info. + * Contains the basic playback parameters for a stream, + * corresponding to the initial 'info' header packet. + * + * Encoded theora frames must be a multiple of 16 in width and height. + * To handle other frame sizes, a crop rectangle is specified in + * frame_height and frame_width, offset_x and * offset_y. The offset + * and size should still be a multiple of 2 to avoid chroma sampling + * shifts. Offset values in this structure are measured from the + * upper left of the image. + * + * Frame rate, in frames per second, is stored as a rational + * fraction. Aspect ratio is also stored as a rational fraction, and + * refers to the aspect ratio of the frame pixels, not of the + * overall frame itself. + * + * See + * examples/encoder_example.c for usage examples of the + * other paramters and good default settings for the encoder parameters. + */ +typedef struct { + ogg_uint32_t width; /**< encoded frame width */ + ogg_uint32_t height; /**< encoded frame height */ + ogg_uint32_t frame_width; /**< display frame width */ + ogg_uint32_t frame_height; /**< display frame height */ + ogg_uint32_t offset_x; /**< horizontal offset of the displayed frame */ + ogg_uint32_t offset_y; /**< vertical offset of the displayed frame */ + ogg_uint32_t fps_numerator; /**< frame rate numerator **/ + ogg_uint32_t fps_denominator; /**< frame rate denominator **/ + ogg_uint32_t aspect_numerator; /**< pixel aspect ratio numerator */ + ogg_uint32_t aspect_denominator; /**< pixel aspect ratio denominator */ + theora_colorspace colorspace; /**< colorspace */ + int target_bitrate; /**< nominal bitrate in bits per second */ + int quality; /**< Nominal quality setting, 0-63 */ + int quick_p; /**< Quick encode/decode */ + + /* decode only */ + unsigned char version_major; + unsigned char version_minor; + unsigned char version_subminor; + + void *codec_setup; + + /* encode only */ + int dropframes_p; + int keyframe_auto_p; + ogg_uint32_t keyframe_frequency; + ogg_uint32_t keyframe_frequency_force; /* also used for decode init to + get granpos shift correct */ + ogg_uint32_t keyframe_data_target_bitrate; + ogg_int32_t keyframe_auto_threshold; + ogg_uint32_t keyframe_mindistance; + ogg_int32_t noise_sensitivity; + ogg_int32_t sharpness; + + theora_pixelformat pixelformat; /**< chroma subsampling mode to expect */ + +} theora_info; + +/** Codec internal state and context. + */ +typedef struct{ + theora_info *i; + ogg_int64_t granulepos; + + void *internal_encode; + void *internal_decode; + +} theora_state; + +/** + * Comment header metadata. + * + * This structure holds the in-stream metadata corresponding to + * the 'comment' header packet. + * + * Meta data is stored as a series of (tag, value) pairs, in + * length-encoded string vectors. The first occurence of the + * '=' character delimits the tag and value. A particular tag + * may occur more than once. The character set encoding for + * the strings is always UTF-8, but the tag names are limited + * to case-insensitive ASCII. See the spec for details. + * + * In filling in this structure, theora_decode_header() will + * null-terminate the user_comment strings for safety. However, + * the bitstream format itself treats them as 8-bit clean, + * and so the length array should be treated as authoritative + * for their length. + */ +typedef struct theora_comment{ + char **user_comments; /**< An array of comment string vectors */ + int *comment_lengths; /**< An array of corresponding string vector lengths in bytes */ + int comments; /**< The total number of comment string vectors */ + char *vendor; /**< The vendor string identifying the encoder, null terminated */ + +} theora_comment; + + +/**\name theora_control() codes */ +/* \anchor decctlcodes_old + * These are the available request codes for theora_control() + * when called with a decoder instance. + * By convention decoder control codes are odd, to distinguish + * them from \ref encctlcodes_old "encoder control codes" which + * are even. + * + * Note that since the 1.0 release, both the legacy and the final + * implementation accept all the same control codes, but only the + * final API declares the newer codes. + * + * Keep any experimental or vendor-specific values above \c 0x8000.*/ + +/*@{*/ + +/**Get the maximum post-processing level. + * The decoder supports a post-processing filter that can improve + * the appearance of the decoded images. This returns the highest + * level setting for this post-processor, corresponding to maximum + * improvement and computational expense. + */ +#define TH_DECCTL_GET_PPLEVEL_MAX (1) + +/**Set the post-processing level. + * Sets the level of post-processing to use when decoding the + * compressed stream. This must be a value between zero (off) + * and the maximum returned by TH_DECCTL_GET_PPLEVEL_MAX. + */ +#define TH_DECCTL_SET_PPLEVEL (3) + +/**Sets the maximum distance between key frames. + * This can be changed during an encode, but will be bounded by + * 1<. + * If it is set before encoding begins, th_info#keyframe_granule_shift will + * be enlarged appropriately. + * + * \param[in] buf ogg_uint32_t: The maximum distance between key + * frames. + * \param[out] buf ogg_uint32_t: The actual maximum distance set. + * \retval OC_FAULT \a theora_state or \a buf is NULL. + * \retval OC_EINVAL \a buf_sz is not sizeof(ogg_uint32_t). + * \retval OC_IMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE (4) + +/**Set the granule position. + * Call this after a seek, to update the internal granulepos + * in the decoder, to insure that subsequent frames are marked + * properly. If you track timestamps yourself and do not use + * the granule postion returned by the decoder, then you do + * not need to use this control. + */ +#define TH_DECCTL_SET_GRANPOS (5) + +/**\anchor encctlcodes_old */ + +/**Sets the quantization parameters to use. + * The parameters are copied, not stored by reference, so they can be freed + * after this call. + * NULL may be specified to revert to the default parameters. + * + * \param[in] buf #th_quant_info + * \retval OC_FAULT \a theora_state is NULL. + * \retval OC_EINVAL Encoding has already begun, the quantization parameters + * are not acceptable to this version of the encoder, + * \a buf is NULL and \a buf_sz is not zero, + * or \a buf is non-NULL and \a buf_sz is + * not sizeof(#th_quant_info). + * \retval OC_IMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_QUANT_PARAMS (2) + +/**Disables any encoder features that would prevent lossless transcoding back + * to VP3. + * This primarily means disabling block-level QI values and not using 4MV mode + * when any of the luma blocks in a macro block are not coded. + * It also includes using the VP3 quantization tables and Huffman codes; if you + * set them explicitly after calling this function, the resulting stream will + * not be VP3-compatible. + * If you enable VP3-compatibility when encoding 4:2:2 or 4:4:4 source + * material, or when using a picture region smaller than the full frame (e.g. + * a non-multiple-of-16 width or height), then non-VP3 bitstream features will + * still be disabled, but the stream will still not be VP3-compatible, as VP3 + * was not capable of encoding such formats. + * If you call this after encoding has already begun, then the quantization + * tables and codebooks cannot be changed, but the frame-level features will + * be enabled or disabled as requested. + * + * \param[in] buf int: a non-zero value to enable VP3 compatibility, + * or 0 to disable it (the default). + * \param[out] buf int: 1 if all bitstream features required for + * VP3-compatibility could be set, and 0 otherwise. + * The latter will be returned if the pixel format is not + * 4:2:0, the picture region is smaller than the full frame, + * or if encoding has begun, preventing the quantization + * tables and codebooks from being set. + * \retval OC_FAULT \a theora_state or \a buf is NULL. + * \retval OC_EINVAL \a buf_sz is not sizeof(int). + * \retval OC_IMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_VP3_COMPATIBLE (10) + +/**Gets the maximum speed level. + * Higher speed levels favor quicker encoding over better quality per bit. + * Depending on the encoding mode, and the internal algorithms used, quality + * may actually improve, but in this case bitrate will also likely increase. + * In any case, overall rate/distortion performance will probably decrease. + * The maximum value, and the meaning of each value, may change depending on + * the current encoding mode (VBR vs. CQI, etc.). + * + * \param[out] buf int: The maximum encoding speed level. + * \retval OC_FAULT \a theora_state or \a buf is NULL. + * \retval OC_EINVAL \a buf_sz is not sizeof(int). + * \retval OC_IMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_GET_SPLEVEL_MAX (12) + +/**Sets the speed level. + * By default a speed value of 1 is used. + * + * \param[in] buf int: The new encoding speed level. + * 0 is slowest, larger values use less CPU. + * \retval OC_FAULT \a theora_state or \a buf is NULL. + * \retval OC_EINVAL \a buf_sz is not sizeof(int), or the + * encoding speed level is out of bounds. + * The maximum encoding speed level may be + * implementation- and encoding mode-specific, and can be + * obtained via #TH_ENCCTL_GET_SPLEVEL_MAX. + * \retval OC_IMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_SET_SPLEVEL (14) + +/*@}*/ + +#define OC_FAULT -1 /**< General failure */ +#define OC_EINVAL -10 /**< Library encountered invalid internal data */ +#define OC_DISABLED -11 /**< Requested action is disabled */ +#define OC_BADHEADER -20 /**< Header packet was corrupt/invalid */ +#define OC_NOTFORMAT -21 /**< Packet is not a theora packet */ +#define OC_VERSION -22 /**< Bitstream version is not handled */ +#define OC_IMPL -23 /**< Feature or action not implemented */ +#define OC_BADPACKET -24 /**< Packet is corrupt */ +#define OC_NEWPACKET -25 /**< Packet is an (ignorable) unhandled extension */ +#define OC_DUPFRAME 1 /**< Packet is a dropped frame */ + +/** + * Retrieve a human-readable string to identify the encoder vendor and version. + * \returns A version string. + */ +extern const char *theora_version_string(void); + +/** + * Retrieve a 32-bit version number. + * This number is composed of a 16-bit major version, 8-bit minor version + * and 8 bit sub-version, composed as follows: +
+   (VERSION_MAJOR<<16) + (VERSION_MINOR<<8) + (VERSION_SUB)
+
+* \returns The version number. +*/ +extern ogg_uint32_t theora_version_number(void); + +/** + * Initialize the theora encoder. + * \param th The theora_state handle to initialize for encoding. + * \param ti A theora_info struct filled with the desired encoding parameters. + * \retval 0 Success + */ +extern int theora_encode_init(theora_state *th, theora_info *ti); + +/** + * Submit a YUV buffer to the theora encoder. + * \param t A theora_state handle previously initialized for encoding. + * \param yuv A buffer of YUV data to encode. Note that both the yuv_buffer + * struct and the luma/chroma buffers within should be allocated by + * the user. + * \retval OC_EINVAL Encoder is not ready, or is finished. + * \retval -1 The size of the given frame differs from those previously input + * \retval 0 Success + */ +extern int theora_encode_YUVin(theora_state *t, yuv_buffer *yuv); + +/** + * Request the next packet of encoded video. + * The encoded data is placed in a user-provided ogg_packet structure. + * \param t A theora_state handle previously initialized for encoding. + * \param last_p whether this is the last packet the encoder should produce. + * \param op An ogg_packet structure to fill. libtheora will set all + * elements of this structure, including a pointer to encoded + * data. The memory for the encoded data is owned by libtheora. + * \retval 0 No internal storage exists OR no packet is ready + * \retval -1 The encoding process has completed + * \retval 1 Success + */ +extern int theora_encode_packetout( theora_state *t, int last_p, + ogg_packet *op); + +/** + * Request a packet containing the initial header. + * A pointer to the header data is placed in a user-provided ogg_packet + * structure. + * \param t A theora_state handle previously initialized for encoding. + * \param op An ogg_packet structure to fill. libtheora will set all + * elements of this structure, including a pointer to the header + * data. The memory for the header data is owned by libtheora. + * \retval 0 Success + */ +extern int theora_encode_header(theora_state *t, ogg_packet *op); + +/** + * Request a comment header packet from provided metadata. + * A pointer to the comment data is placed in a user-provided ogg_packet + * structure. + * \param tc A theora_comment structure filled with the desired metadata + * \param op An ogg_packet structure to fill. libtheora will set all + * elements of this structure, including a pointer to the encoded + * comment data. The memory for the comment data is owned by + * libtheora. + * \retval 0 Success + */ +extern int theora_encode_comment(theora_comment *tc, ogg_packet *op); + +/** + * Request a packet containing the codebook tables for the stream. + * A pointer to the codebook data is placed in a user-provided ogg_packet + * structure. + * \param t A theora_state handle previously initialized for encoding. + * \param op An ogg_packet structure to fill. libtheora will set all + * elements of this structure, including a pointer to the codebook + * data. The memory for the header data is owned by libtheora. + * \retval 0 Success + */ +extern int theora_encode_tables(theora_state *t, ogg_packet *op); + +/** + * Decode an Ogg packet, with the expectation that the packet contains + * an initial header, comment data or codebook tables. + * + * \param ci A theora_info structure to fill. This must have been previously + * initialized with theora_info_init(). If \a op contains an initial + * header, theora_decode_header() will fill \a ci with the + * parsed header values. If \a op contains codebook tables, + * theora_decode_header() will parse these and attach an internal + * representation to \a ci->codec_setup. + * \param cc A theora_comment structure to fill. If \a op contains comment + * data, theora_decode_header() will fill \a cc with the parsed + * comments. + * \param op An ogg_packet structure which you expect contains an initial + * header, comment data or codebook tables. + * + * \retval OC_BADHEADER \a op is NULL; OR the first byte of \a op->packet + * has the signature of an initial packet, but op is + * not a b_o_s packet; OR this packet has the signature + * of an initial header packet, but an initial header + * packet has already been seen; OR this packet has the + * signature of a comment packet, but the initial header + * has not yet been seen; OR this packet has the signature + * of a comment packet, but contains invalid data; OR + * this packet has the signature of codebook tables, + * but the initial header or comments have not yet + * been seen; OR this packet has the signature of codebook + * tables, but contains invalid data; + * OR the stream being decoded has a compatible version + * but this packet does not have the signature of a + * theora initial header, comments, or codebook packet + * \retval OC_VERSION The packet data of \a op is an initial header with + * a version which is incompatible with this version of + * libtheora. + * \retval OC_NEWPACKET the stream being decoded has an incompatible (future) + * version and contains an unknown signature. + * \retval 0 Success + * + * \note The normal usage is that theora_decode_header() be called on the + * first three packets of a theora logical bitstream in succession. + */ +extern int theora_decode_header(theora_info *ci, theora_comment *cc, + ogg_packet *op); + +/** + * Initialize a theora_state handle for decoding. + * \param th The theora_state handle to initialize. + * \param c A theora_info struct filled with the desired decoding parameters. + * This is of course usually obtained from a previous call to + * theora_decode_header(). + * \retval 0 Success + */ +extern int theora_decode_init(theora_state *th, theora_info *c); + +/** + * Input a packet containing encoded data into the theora decoder. + * \param th A theora_state handle previously initialized for decoding. + * \param op An ogg_packet containing encoded theora data. + * \retval 0 Success + * \retval OC_BADPACKET \a op does not contain encoded video data + */ +extern int theora_decode_packetin(theora_state *th,ogg_packet *op); + +/** + * Output the next available frame of decoded YUV data. + * \param th A theora_state handle previously initialized for decoding. + * \param yuv A yuv_buffer in which libtheora should place the decoded data. + * Note that the buffer struct itself is allocated by the user, but + * that the luma and chroma pointers will be filled in by the + * library. Also note that these luma and chroma regions should be + * considered read-only by the user. + * \retval 0 Success + */ +extern int theora_decode_YUVout(theora_state *th,yuv_buffer *yuv); + +/** + * Report whether a theora packet is a header or not + * This function does no verification beyond checking the header + * flag bit so it should not be used for bitstream identification; + * use theora_decode_header() for that. + * + * \param op An ogg_packet containing encoded theora data. + * \retval 1 The packet is a header packet + * \retval 0 The packet is not a header packet (and so contains frame data) + * + * Thus function was added in the 1.0alpha4 release. + */ +extern int theora_packet_isheader(ogg_packet *op); + +/** + * Report whether a theora packet is a keyframe or not + * + * \param op An ogg_packet containing encoded theora data. + * \retval 1 The packet contains a keyframe image + * \retval 0 The packet is contains an interframe delta + * \retval -1 The packet is not an image data packet at all + * + * Thus function was added in the 1.0alpha4 release. + */ +extern int theora_packet_iskeyframe(ogg_packet *op); + +/** + * Report the granulepos shift radix + * + * When embedded in Ogg, Theora uses a two-part granulepos, + * splitting the 64-bit field into two pieces. The more-significant + * section represents the frame count at the last keyframe, + * and the less-significant section represents the count of + * frames since the last keyframe. In this way the overall + * field is still non-decreasing with time, but usefully encodes + * a pointer to the last keyframe, which is necessary for + * correctly restarting decode after a seek. + * + * This function reports the number of bits used to represent + * the distance to the last keyframe, and thus how the granulepos + * field must be shifted or masked to obtain the two parts. + * + * Since libtheora returns compressed data in an ogg_packet + * structure, this may be generally useful even if the Theora + * packets are not being used in an Ogg container. + * + * \param ti A previously initialized theora_info struct + * \returns The bit shift dividing the two granulepos fields + * + * This function was added in the 1.0alpha5 release. + */ +int theora_granule_shift(theora_info *ti); + +/** + * Convert a granulepos to an absolute frame index, starting at 0. + * The granulepos is interpreted in the context of a given theora_state handle. + * + * Note that while the granulepos encodes the frame count (i.e. starting + * from 1) this call returns the frame index, starting from zero. Thus + * One can calculate the presentation time by multiplying the index by + * the rate. + * + * \param th A previously initialized theora_state handle (encode or decode) + * \param granulepos The granulepos to convert. + * \returns The frame index corresponding to \a granulepos. + * \retval -1 The given granulepos is undefined (i.e. negative) + * + * Thus function was added in the 1.0alpha4 release. + */ +extern ogg_int64_t theora_granule_frame(theora_state *th,ogg_int64_t granulepos); + +/** + * Convert a granulepos to absolute time in seconds. The granulepos is + * interpreted in the context of a given theora_state handle, and gives + * the end time of a frame's presentation as used in Ogg mux ordering. + * + * \param th A previously initialized theora_state handle (encode or decode) + * \param granulepos The granulepos to convert. + * \returns The absolute time in seconds corresponding to \a granulepos. + * This is the "end time" for the frame, or the latest time it should + * be displayed. + * It is not the presentation time. + * \retval -1. The given granulepos is undefined (i.e. negative), or + * \retval -1. The function has been disabled because floating + * point support is not available. + */ +extern double theora_granule_time(theora_state *th,ogg_int64_t granulepos); + +/** + * Initialize a theora_info structure. All values within the given theora_info + * structure are initialized, and space is allocated within libtheora for + * internal codec setup data. + * \param c A theora_info struct to initialize. + */ +extern void theora_info_init(theora_info *c); + +/** + * Clear a theora_info structure. All values within the given theora_info + * structure are cleared, and associated internal codec setup data is freed. + * \param c A theora_info struct to initialize. + */ +extern void theora_info_clear(theora_info *c); + +/** + * Free all internal data associated with a theora_state handle. + * \param t A theora_state handle. + */ +extern void theora_clear(theora_state *t); + +/** + * Initialize an allocated theora_comment structure + * \param tc An allocated theora_comment structure + **/ +extern void theora_comment_init(theora_comment *tc); + +/** + * Add a comment to an initialized theora_comment structure + * \param tc A previously initialized theora comment structure + * \param comment A null-terminated string encoding the comment in the form + * "TAG=the value" + * + * Neither theora_comment_add() nor theora_comment_add_tag() support + * comments containing null values, although the bitstream format + * supports this. To add such comments you will need to manipulate + * the theora_comment structure directly. + **/ + +extern void theora_comment_add(theora_comment *tc, char *comment); + +/** + * Add a comment to an initialized theora_comment structure. + * \param tc A previously initialized theora comment structure + * \param tag A null-terminated string containing the tag + * associated with the comment. + * \param value The corresponding value as a null-terminated string + * + * Neither theora_comment_add() nor theora_comment_add_tag() support + * comments containing null values, although the bitstream format + * supports this. To add such comments you will need to manipulate + * the theora_comment structure directly. + **/ +extern void theora_comment_add_tag(theora_comment *tc, + char *tag, char *value); + +/** + * Look up a comment value by tag. + * \param tc Tn initialized theora_comment structure + * \param tag The tag to look up + * \param count The instance of the tag. The same tag can appear multiple + * times, each with a distinct and ordered value, so an index + * is required to retrieve them all. + * \returns A pointer to the queried tag's value + * \retval NULL No matching tag is found + * + * \note Use theora_comment_query_count() to get the legal range for the + * count parameter. + **/ + +extern char *theora_comment_query(theora_comment *tc, char *tag, int count); + +/** Look up the number of instances of a tag. + * \param tc An initialized theora_comment structure + * \param tag The tag to look up + * \returns The number on instances of a particular tag. + * + * Call this first when querying for a specific tag and then interate + * over the number of instances with separate calls to + * theora_comment_query() to retrieve all instances in order. + **/ +extern int theora_comment_query_count(theora_comment *tc, char *tag); + +/** + * Clear an allocated theora_comment struct so that it can be freed. + * \param tc An allocated theora_comment structure. + **/ +extern void theora_comment_clear(theora_comment *tc); + +/**Encoder control function. + * This is used to provide advanced control the encoding process. + * \param th A #theora_state handle. + * \param req The control code to process. + * See \ref encctlcodes_old "the list of available + * control codes" for details. + * \param buf The parameters for this control code. + * \param buf_sz The size of the parameter buffer.*/ +extern int theora_control(theora_state *th,int req,void *buf,size_t buf_sz); + +/* @} */ /* end oldfuncs doxygen group */ + +#ifdef __cplusplus +} +#endif /* __cplusplus */ + +#endif /* _O_THEORA_H_ */ diff --git a/libs/libtheora-1.1/include/theora/theoradec.h b/libs/libtheora-1.1/include/theora/theoradec.h new file mode 100644 index 00000000..41bacb1f --- /dev/null +++ b/libs/libtheora-1.1/include/theora/theoradec.h @@ -0,0 +1,325 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: theora.h,v 1.8 2004/03/15 22:17:32 derf Exp $ + + ********************************************************************/ + +/**\file + * The libtheoradec C decoding API.*/ + +#if !defined(_O_THEORA_THEORADEC_H_) +# define _O_THEORA_THEORADEC_H_ (1) +# include +# include +# include "codec.h" + +#if defined(__cplusplus) +extern "C" { +#endif + + + +/**\name th_decode_ctl() codes + * \anchor decctlcodes + * These are the available request codes for th_decode_ctl(). + * By convention, these are odd, to distinguish them from the + * \ref encctlcodes "encoder control codes". + * Keep any experimental or vendor-specific values above \c 0x8000.*/ +/*@{*/ +/**Gets the maximum post-processing level. + * The decoder supports a post-processing filter that can improve + * the appearance of the decoded images. This returns the highest + * level setting for this post-processor, corresponding to maximum + * improvement and computational expense. + * + * \param[out] _buf int: The maximum post-processing level. + * \retval TH_EFAULT \a _dec_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int). + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_DECCTL_GET_PPLEVEL_MAX (1) +/**Sets the post-processing level. + * By default, post-processing is disabled. + * + * Sets the level of post-processing to use when decoding the + * compressed stream. This must be a value between zero (off) + * and the maximum returned by TH_DECCTL_GET_PPLEVEL_MAX. + * + * \param[in] _buf int: The new post-processing level. + * 0 to disable; larger values use more CPU. + * \retval TH_EFAULT \a _dec_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int), or the + * post-processing level is out of bounds. + * The maximum post-processing level may be + * implementation-specific, and can be obtained via + * #TH_DECCTL_GET_PPLEVEL_MAX. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_DECCTL_SET_PPLEVEL (3) +/**Sets the granule position. + * Call this after a seek, before decoding the first frame, to ensure that the + * proper granule position is returned for all subsequent frames. + * If you track timestamps yourself and do not use the granule position + * returned by the decoder, then you need not call this function. + * + * \param[in] _buf ogg_int64_t: The granule position of the next + * frame. + * \retval TH_EFAULT \a _dec_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(ogg_int64_t), or the + * granule position is negative.*/ +#define TH_DECCTL_SET_GRANPOS (5) +/**Sets the striped decode callback function. + * If set, this function will be called as each piece of a frame is fully + * decoded in th_decode_packetin(). + * You can pass in a #th_stripe_callback with + * th_stripe_callback#stripe_decoded set to NULL to disable the + * callbacks at any point. + * Enabling striped decode does not prevent you from calling + * th_decode_ycbcr_out() after the frame is fully decoded. + * + * \param[in] _buf #th_stripe_callback: The callback parameters. + * \retval TH_EFAULT \a _dec_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not + * sizeof(th_stripe_callback).*/ +#define TH_DECCTL_SET_STRIPE_CB (7) + +/**Enables telemetry and sets the macroblock display mode */ +#define TH_DECCTL_SET_TELEMETRY_MBMODE (9) +/**Enables telemetry and sets the motion vector display mode */ +#define TH_DECCTL_SET_TELEMETRY_MV (11) +/**Enables telemetry and sets the adaptive quantization display mode */ +#define TH_DECCTL_SET_TELEMETRY_QI (13) +/**Enables telemetry and sets the bitstream breakdown visualization mode */ +#define TH_DECCTL_SET_TELEMETRY_BITS (15) +/*@}*/ + + + +/**A callback function for striped decode. + * This is a function pointer to an application-provided function that will be + * called each time a section of the image is fully decoded in + * th_decode_packetin(). + * This allows the application to process the section immediately, while it is + * still in cache. + * Note that the frame is decoded bottom to top, so \a _yfrag0 will steadily + * decrease with each call until it reaches 0, at which point the full frame + * is decoded. + * The number of fragment rows made available in each call depends on the pixel + * format and the number of post-processing filters enabled, and may not even + * be constant for the entire frame. + * If a non-NULL \a _granpos pointer is passed to + * th_decode_packetin(), the granule position for the frame will be stored + * in it before the first callback is made. + * If an entire frame is dropped (a 0-byte packet), then no callbacks will be + * made at all for that frame. + * \param _ctx An application-provided context pointer. + * \param _buf The image buffer for the decoded frame. + * \param _yfrag0 The Y coordinate of the first row of 8x8 fragments + * decoded. + * Multiply this by 8 to obtain the pixel row number in the + * luma plane. + * If the chroma planes are subsampled in the Y direction, + * this will always be divisible by two. + * \param _yfrag_end The Y coordinate of the first row of 8x8 fragments past + * the newly decoded section. + * If the chroma planes are subsampled in the Y direction, + * this will always be divisible by two. + * I.e., this section contains fragment rows + * \a _yfrag0 ...\a _yfrag_end -1.*/ +typedef void (*th_stripe_decoded_func)(void *_ctx,th_ycbcr_buffer _buf, + int _yfrag0,int _yfrag_end); + +/**The striped decode callback data to pass to #TH_DECCTL_SET_STRIPE_CB.*/ +typedef struct{ + /**An application-provided context pointer. + * This will be passed back verbatim to the application.*/ + void *ctx; + /**The callback function pointer.*/ + th_stripe_decoded_func stripe_decoded; +}th_stripe_callback; + + + +/**\name Decoder state + The following data structures are opaque, and their contents are not + publicly defined by this API. + Referring to their internals directly is unsupported, and may break without + warning.*/ +/*@{*/ +/**The decoder context.*/ +typedef struct th_dec_ctx th_dec_ctx; +/**Setup information. + This contains auxiliary information (Huffman tables and quantization + parameters) decoded from the setup header by th_decode_headerin() to be + passed to th_decode_alloc(). + It can be re-used to initialize any number of decoders, and can be freed + via th_setup_free() at any time.*/ +typedef struct th_setup_info th_setup_info; +/*@}*/ + + + +/**\defgroup decfuncs Functions for Decoding*/ +/*@{*/ +/**\name Functions for decoding + * You must link to libtheoradec if you use any of the + * functions in this section. + * + * The functions are listed in the order they are used in a typical decode. + * The basic steps are: + * - Parse the header packets by repeatedly calling th_decode_headerin(). + * - Allocate a #th_dec_ctx handle with th_decode_alloc(). + * - Call th_setup_free() to free any memory used for codec setup + * information. + * - Perform any additional decoder configuration with th_decode_ctl(). + * - For each video data packet: + * - Submit the packet to the decoder via th_decode_packetin(). + * - Retrieve the uncompressed video data via th_decode_ycbcr_out(). + * - Call th_decode_free() to release all decoder memory.*/ +/*@{*/ +/**Decodes the header packets of a Theora stream. + * This should be called on the initial packets of the stream, in succession, + * until it returns 0, indicating that all headers have been + * processed, or an error is encountered. + * At least three header packets are required, and additional optional header + * packets may follow. + * This can be used on the first packet of any logical stream to determine if + * that stream is a Theora stream. + * \param _info A #th_info structure to fill in. + * This must have been previously initialized with + * th_info_init(). + * The application may immediately begin using the contents of + * this structure after the first header is decoded, though it + * must continue to be passed in on all subsequent calls. + * \param _tc A #th_comment structure to fill in. + * The application may immediately begin using the contents of + * this structure after the second header is decoded, though it + * must continue to be passed in on all subsequent calls. + * \param _setup Returns a pointer to additional, private setup information + * needed by the decoder. + * The contents of this pointer must be initialized to + * NULL on the first call, and the returned value must + * continue to be passed in on all subsequent calls. + * \param _op An ogg_packet structure which contains one of the + * initial packets of an Ogg logical stream. + * \return A positive value indicates that a Theora header was successfully + * processed. + * \retval 0 The first video data packet was encountered after all + * required header packets were parsed. + * The packet just passed in on this call should be saved + * and fed to th_decode_packetin() to begin decoding + * video data. + * \retval TH_EFAULT One of \a _info, \a _tc, or \a _setup was + * NULL. + * \retval TH_EBADHEADER \a _op was NULL, the packet was not the next + * header packet in the expected sequence, or the format + * of the header data was invalid. + * \retval TH_EVERSION The packet data was a Theora info header, but for a + * bitstream version not decodable with this version of + * libtheoradec. + * \retval TH_ENOTFORMAT The packet was not a Theora header. + */ +extern int th_decode_headerin(th_info *_info,th_comment *_tc, + th_setup_info **_setup,ogg_packet *_op); +/**Allocates a decoder instance. + * + * Security Warning: The Theora format supports very large frame sizes, + * potentially even larger than the address space of a 32-bit machine, and + * creating a decoder context allocates the space for several frames of data. + * If the allocation fails here, your program will crash, possibly at some + * future point because the OS kernel returned a valid memory range and will + * only fail when it tries to map the pages in it the first time they are + * used. + * Even if it succeeds, you may experience a denial of service if the frame + * size is large enough to cause excessive paging. + * If you are integrating libtheora in a larger application where such things + * are undesirable, it is highly recommended that you check the frame size in + * \a _info before calling this function and refuse to decode streams where it + * is larger than some reasonable maximum. + * libtheora will not check this for you, because there may be machines that + * can handle such streams and applications that wish to. + * \param _info A #th_info struct filled via th_decode_headerin(). + * \param _setup A #th_setup_info handle returned via + * th_decode_headerin(). + * \return The initialized #th_dec_ctx handle. + * \retval NULL If the decoding parameters were invalid.*/ +extern th_dec_ctx *th_decode_alloc(const th_info *_info, + const th_setup_info *_setup); +/**Releases all storage used for the decoder setup information. + * This should be called after you no longer want to create any decoders for + * a stream whose headers you have parsed with th_decode_headerin(). + * \param _setup The setup information to free. + * This can safely be NULL.*/ +extern void th_setup_free(th_setup_info *_setup); +/**Decoder control function. + * This is used to provide advanced control of the decoding process. + * \param _dec A #th_dec_ctx handle. + * \param _req The control code to process. + * See \ref decctlcodes "the list of available control codes" + * for details. + * \param _buf The parameters for this control code. + * \param _buf_sz The size of the parameter buffer.*/ +extern int th_decode_ctl(th_dec_ctx *_dec,int _req,void *_buf, + size_t _buf_sz); +/**Submits a packet containing encoded video data to the decoder. + * \param _dec A #th_dec_ctx handle. + * \param _op An ogg_packet containing encoded video data. + * \param _granpos Returns the granule position of the decoded packet. + * If non-NULL, the granule position for this specific + * packet is stored in this location. + * This is computed incrementally from previously decoded + * packets. + * After a seek, the correct granule position must be set via + * #TH_DECCTL_SET_GRANPOS for this to work properly. + * \retval 0 Success. + * A new decoded frame can be retrieved by calling + * th_decode_ycbcr_out(). + * \retval TH_DUPFRAME The packet represented a dropped (0-byte) frame. + * The player can skip the call to th_decode_ycbcr_out(), + * as the contents of the decoded frame buffer have not + * changed. + * \retval TH_EFAULT \a _dec or \a _op was NULL. + * \retval TH_EBADPACKET \a _op does not contain encoded video data. + * \retval TH_EIMPL The video data uses bitstream features which this + * library does not support.*/ +extern int th_decode_packetin(th_dec_ctx *_dec,const ogg_packet *_op, + ogg_int64_t *_granpos); +/**Outputs the next available frame of decoded Y'CbCr data. + * If a striped decode callback has been set with #TH_DECCTL_SET_STRIPE_CB, + * then the application does not need to call this function. + * \param _dec A #th_dec_ctx handle. + * \param _ycbcr A video buffer structure to fill in. + * libtheoradec will fill in all the members of this + * structure, including the pointers to the uncompressed video + * data. + * The memory for this video data is owned by + * libtheoradec. + * It may be freed or overwritten without notification when + * subsequent frames are decoded. + * \retval 0 Success + * \retval TH_EFAULT \a _dec or \a _ycbcr was NULL. + */ +extern int th_decode_ycbcr_out(th_dec_ctx *_dec, + th_ycbcr_buffer _ycbcr); +/**Frees an allocated decoder instance. + * \param _dec A #th_dec_ctx handle.*/ +extern void th_decode_free(th_dec_ctx *_dec); +/*@}*/ +/*@}*/ + + + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/libs/libtheora-1.1/include/theora/theoraenc.h b/libs/libtheora-1.1/include/theora/theoraenc.h new file mode 100644 index 00000000..b0b34434 --- /dev/null +++ b/libs/libtheora-1.1/include/theora/theoraenc.h @@ -0,0 +1,500 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: theora.h,v 1.8 2004/03/15 22:17:32 derf Exp $ + + ********************************************************************/ + +/**\file + * The libtheoraenc C encoding API.*/ + +#if !defined(_O_THEORA_THEORAENC_H_) +# define _O_THEORA_THEORAENC_H_ (1) +# include +# include +# include "codec.h" + +#if defined(__cplusplus) +extern "C" { +#endif + + + +/**\name th_encode_ctl() codes + * \anchor encctlcodes + * These are the available request codes for th_encode_ctl(). + * By convention, these are even, to distinguish them from the + * \ref decctlcodes "decoder control codes". + * Keep any experimental or vendor-specific values above \c 0x8000.*/ +/*@{*/ +/**Sets the Huffman tables to use. + * The tables are copied, not stored by reference, so they can be freed after + * this call. + * NULL may be specified to revert to the default tables. + * + * \param[in] _buf #th_huff_code[#TH_NHUFFMAN_TABLES][#TH_NDCT_TOKENS] + * \retval TH_EFAULT \a _enc_ctx is NULL. + * \retval TH_EINVAL Encoding has already begun or one or more of the given + * tables is not full or prefix-free, \a _buf is + * NULL and \a _buf_sz is not zero, or \a _buf is + * non-NULL and \a _buf_sz is not + * sizeof(#th_huff_code)*#TH_NHUFFMAN_TABLES*#TH_NDCT_TOKENS. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_HUFFMAN_CODES (0) +/**Sets the quantization parameters to use. + * The parameters are copied, not stored by reference, so they can be freed + * after this call. + * NULL may be specified to revert to the default parameters. + * + * \param[in] _buf #th_quant_info + * \retval TH_EFAULT \a _enc_ctx is NULL. + * \retval TH_EINVAL Encoding has already begun, \a _buf is + * NULL and \a _buf_sz is not zero, + * or \a _buf is non-NULL and + * \a _buf_sz is not sizeof(#th_quant_info). + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_QUANT_PARAMS (2) +/**Sets the maximum distance between key frames. + * This can be changed during an encode, but will be bounded by + * 1<. + * If it is set before encoding begins, th_info#keyframe_granule_shift will + * be enlarged appropriately. + * + * \param[in] _buf ogg_uint32_t: The maximum distance between key + * frames. + * \param[out] _buf ogg_uint32_t: The actual maximum distance set. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(ogg_uint32_t). + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE (4) +/**Disables any encoder features that would prevent lossless transcoding back + * to VP3. + * This primarily means disabling block-adaptive quantization and always coding + * all four luma blocks in a macro block when 4MV is used. + * It also includes using the VP3 quantization tables and Huffman codes; if you + * set them explicitly after calling this function, the resulting stream will + * not be VP3-compatible. + * If you enable VP3-compatibility when encoding 4:2:2 or 4:4:4 source + * material, or when using a picture region smaller than the full frame (e.g. + * a non-multiple-of-16 width or height), then non-VP3 bitstream features will + * still be disabled, but the stream will still not be VP3-compatible, as VP3 + * was not capable of encoding such formats. + * If you call this after encoding has already begun, then the quantization + * tables and codebooks cannot be changed, but the frame-level features will + * be enabled or disabled as requested. + * + * \param[in] _buf int: a non-zero value to enable VP3 compatibility, + * or 0 to disable it (the default). + * \param[out] _buf int: 1 if all bitstream features required for + * VP3-compatibility could be set, and 0 otherwise. + * The latter will be returned if the pixel format is not + * 4:2:0, the picture region is smaller than the full frame, + * or if encoding has begun, preventing the quantization + * tables and codebooks from being set. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int). + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_VP3_COMPATIBLE (10) +/**Gets the maximum speed level. + * Higher speed levels favor quicker encoding over better quality per bit. + * Depending on the encoding mode, and the internal algorithms used, quality + * may actually improve, but in this case bitrate will also likely increase. + * In any case, overall rate/distortion performance will probably decrease. + * The maximum value, and the meaning of each value, may change depending on + * the current encoding mode (VBR vs. constant quality, etc.). + * + * \param[out] _buf int: The maximum encoding speed level. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int). + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_GET_SPLEVEL_MAX (12) +/**Sets the speed level. + * The current speed level may be retrieved using #TH_ENCCTL_GET_SPLEVEL. + * + * \param[in] _buf int: The new encoding speed level. + * 0 is slowest, larger values use less CPU. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int), or the + * encoding speed level is out of bounds. + * The maximum encoding speed level may be + * implementation- and encoding mode-specific, and can be + * obtained via #TH_ENCCTL_GET_SPLEVEL_MAX. + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_SET_SPLEVEL (14) +/**Gets the current speed level. + * The default speed level may vary according to encoder implementation, but if + * this control code is not supported (it returns #TH_EIMPL), the default may + * be assumed to be the slowest available speed (0). + * The maximum encoding speed level may be implementation- and encoding + * mode-specific, and can be obtained via #TH_ENCCTL_GET_SPLEVEL_MAX. + * + * \param[out] _buf int: The current encoding speed level. + * 0 is slowest, larger values use less CPU. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int). + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_GET_SPLEVEL (16) +/**Sets the number of duplicates of the next frame to produce. + * Although libtheora can encode duplicate frames very cheaply, it costs some + * amount of CPU to detect them, and a run of duplicates cannot span a + * keyframe boundary. + * This control code tells the encoder to produce the specified number of extra + * duplicates of the next frame. + * This allows the encoder to make smarter keyframe placement decisions and + * rate control decisions, and reduces CPU usage as well, when compared to + * just submitting the same frame for encoding multiple times. + * This setting only applies to the next frame submitted for encoding. + * You MUST call th_encode_packetout() repeatedly until it returns 0, or the + * extra duplicate frames will be lost. + * + * \param[in] _buf int: The number of duplicates to produce. + * If this is negative or zero, no duplicates will be produced. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int), or the + * number of duplicates is greater than or equal to the + * maximum keyframe interval. + * In the latter case, NO duplicate frames will be produced. + * You must ensure that the maximum keyframe interval is set + * larger than the maximum number of duplicates you will + * ever wish to insert prior to encoding. + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_SET_DUP_COUNT (18) +/**Modifies the default bitrate management behavior. + * Use to allow or disallow frame dropping, and to enable or disable capping + * bit reservoir overflows and underflows. + * See \ref encctlcodes "the list of available flags". + * The flags are set by default to + * #TH_RATECTL_DROP_FRAMES|#TH_RATECTL_CAP_OVERFLOW. + * + * \param[in] _buf int: Any combination of + * \ref ratectlflags "the available flags": + * - #TH_RATECTL_DROP_FRAMES: Enable frame dropping. + * - #TH_RATECTL_CAP_OVERFLOW: Don't bank excess bits for later + * use. + * - #TH_RATECTL_CAP_UNDERFLOW: Don't try to make up shortfalls + * later. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int) or rate control + * is not enabled. + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_SET_RATE_FLAGS (20) +/**Sets the size of the bitrate management bit reservoir as a function + * of number of frames. + * The reservoir size affects how quickly bitrate management reacts to + * instantaneous changes in the video complexity. + * Larger reservoirs react more slowly, and provide better overall quality, but + * require more buffering by a client, adding more latency to live streams. + * By default, libtheora sets the reservoir to the maximum distance between + * keyframes, subject to a minimum and maximum limit. + * This call may be used to increase or decrease the reservoir, increasing or + * decreasing the allowed temporary variance in bitrate. + * An implementation may impose some limits on the size of a reservoir it can + * handle, in which case the actual reservoir size may not be exactly what was + * requested. + * The actual value set will be returned. + * + * \param[in] _buf int: Requested size of the reservoir measured in + * frames. + * \param[out] _buf int: The actual size of the reservoir set. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(int), or rate control + * is not enabled. The buffer has an implementation + * defined minimum and maximum size and the value in _buf + * will be adjusted to match the actual value set. + * \retval TH_EIMPL Not supported by this implementation in the current + * encoding mode.*/ +#define TH_ENCCTL_SET_RATE_BUFFER (22) +/**Enable pass 1 of two-pass encoding mode and retrieve the first pass metrics. + * Pass 1 mode must be enabled before the first frame is encoded, and a target + * bitrate must have already been specified to the encoder. + * Although this does not have to be the exact rate that will be used in the + * second pass, closer values may produce better results. + * The first call returns the size of the two-pass header data, along with some + * placeholder content, and sets the encoder into pass 1 mode implicitly. + * This call sets the encoder to pass 1 mode implicitly. + * Then, a subsequent call must be made after each call to + * th_encode_ycbcr_in() to retrieve the metrics for that frame. + * An additional, final call must be made to retrieve the summary data, + * containing such information as the total number of frames, etc. + * This must be stored in place of the placeholder data that was returned + * in the first call, before the frame metrics data. + * All of this data must be presented back to the encoder during pass 2 using + * #TH_ENCCTL_2PASS_IN. + * + * \param[out] char *_buf: Returns a pointer to internal storage + * containing the two pass metrics data. + * This storage is only valid until the next call, or until the + * encoder context is freed, and must be copied by the + * application. + * \retval >=0 The number of bytes of metric data available in the + * returned buffer. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL \a _buf_sz is not sizeof(char *), no target + * bitrate has been set, or the first call was made after + * the first frame was submitted for encoding. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_2PASS_OUT (24) +/**Submits two-pass encoding metric data collected the first encoding pass to + * the second pass. + * The first call must be made before the first frame is encoded, and a target + * bitrate must have already been specified to the encoder. + * It sets the encoder to pass 2 mode implicitly; this cannot be disabled. + * The encoder may require reading data from some or all of the frames in + * advance, depending on, e.g., the reservoir size used in the second pass. + * You must call this function repeatedly before each frame to provide data + * until either a) it fails to consume all of the data presented or b) all of + * the pass 1 data has been consumed. + * In the first case, you must save the remaining data to be presented after + * the next frame. + * You can call this function with a NULL argument to get an upper bound on + * the number of bytes that will be required before the next frame. + * + * When pass 2 is first enabled, the default bit reservoir is set to the entire + * file; this gives maximum flexibility but can lead to very high peak rates. + * You can subsequently set it to another value with #TH_ENCCTL_SET_RATE_BUFFER + * (e.g., to set it to the keyframe interval for non-live streaming), however, + * you may then need to provide more data before the next frame. + * + * \param[in] _buf char[]: A buffer containing the data returned by + * #TH_ENCCTL_2PASS_OUT in pass 1. + * You may pass NULL for \a _buf to return an upper + * bound on the number of additional bytes needed before the + * next frame. + * The summary data returned at the end of pass 1 must be at + * the head of the buffer on the first call with a + * non-NULL \a _buf, and the placeholder data + * returned at the start of pass 1 should be omitted. + * After each call you should advance this buffer by the number + * of bytes consumed. + * \retval >0 The number of bytes of metric data required/consumed. + * \retval 0 No more data is required before the next frame. + * \retval TH_EFAULT \a _enc_ctx is NULL. + * \retval TH_EINVAL No target bitrate has been set, or the first call was + * made after the first frame was submitted for + * encoding. + * \retval TH_ENOTFORMAT The data did not appear to be pass 1 from a compatible + * implementation of this library. + * \retval TH_EBADHEADER The data was invalid; this may be returned when + * attempting to read an aborted pass 1 file that still + * has the placeholder data in place of the summary + * data. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_2PASS_IN (26) +/**Sets the current encoding quality. + * This is only valid so long as no bitrate has been specified, either through + * the #th_info struct used to initialize the encoder or through + * #TH_ENCCTL_SET_BITRATE (this restriction may be relaxed in a future + * version). + * If it is set before the headers are emitted, the target quality encoded in + * them will be updated. + * + * \param[in] _buf int: The new target quality, in the range 0...63, + * inclusive. + * \retval 0 Success. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL A target bitrate has already been specified, or the + * quality index was not in the range 0...63. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_QUALITY (28) +/**Sets the current encoding bitrate. + * Once a bitrate is set, the encoder must use a rate-controlled mode for all + * future frames (this restriction may be relaxed in a future version). + * If it is set before the headers are emitted, the target bitrate encoded in + * them will be updated. + * Due to the buffer delay, the exact bitrate of each section of the encode is + * not guaranteed. + * The encoder may have already used more bits than allowed for the frames it + * has encoded, expecting to make them up in future frames, or it may have + * used fewer, holding the excess in reserve. + * The exact transition between the two bitrates is not well-defined by this + * API, but may be affected by flags set with #TH_ENCCTL_SET_RATE_FLAGS. + * After a number of frames equal to the buffer delay, one may expect further + * output to average at the target bitrate. + * + * \param[in] _buf long: The new target bitrate, in bits per second. + * \retval 0 Success. + * \retval TH_EFAULT \a _enc_ctx or \a _buf is NULL. + * \retval TH_EINVAL The target bitrate was not positive. + * \retval TH_EIMPL Not supported by this implementation.*/ +#define TH_ENCCTL_SET_BITRATE (30) + +/*@}*/ + + +/**\name TH_ENCCTL_SET_RATE_FLAGS flags + * \anchor ratectlflags + * These are the flags available for use with #TH_ENCCTL_SET_RATE_FLAGS.*/ +/*@{*/ +/**Drop frames to keep within bitrate buffer constraints. + * This can have a severe impact on quality, but is the only way to ensure that + * bitrate targets are met at low rates during sudden bursts of activity.*/ +#define TH_RATECTL_DROP_FRAMES (0x1) +/**Ignore bitrate buffer overflows. + * If the encoder uses so few bits that the reservoir of available bits + * overflows, ignore the excess. + * The encoder will not try to use these extra bits in future frames. + * At high rates this may cause the result to be undersized, but allows a + * client to play the stream using a finite buffer; it should normally be + * enabled.*/ +#define TH_RATECTL_CAP_OVERFLOW (0x2) +/**Ignore bitrate buffer underflows. + * If the encoder uses so many bits that the reservoir of available bits + * underflows, ignore the deficit. + * The encoder will not try to make up these extra bits in future frames. + * At low rates this may cause the result to be oversized; it should normally + * be disabled.*/ +#define TH_RATECTL_CAP_UNDERFLOW (0x4) +/*@}*/ + + + +/**The quantization parameters used by VP3.*/ +extern const th_quant_info TH_VP31_QUANT_INFO; + +/**The Huffman tables used by VP3.*/ +extern const th_huff_code + TH_VP31_HUFF_CODES[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS]; + + + +/**\name Encoder state + The following data structure is opaque, and its contents are not publicly + defined by this API. + Referring to its internals directly is unsupported, and may break without + warning.*/ +/*@{*/ +/**The encoder context.*/ +typedef struct th_enc_ctx th_enc_ctx; +/*@}*/ + + + +/**\defgroup encfuncs Functions for Encoding*/ +/*@{*/ +/**\name Functions for encoding + * You must link to libtheoraenc and libtheoradec + * if you use any of the functions in this section. + * + * The functions are listed in the order they are used in a typical encode. + * The basic steps are: + * - Fill in a #th_info structure with details on the format of the video you + * wish to encode. + * - Allocate a #th_enc_ctx handle with th_encode_alloc(). + * - Perform any additional encoder configuration required with + * th_encode_ctl(). + * - Repeatedly call th_encode_flushheader() to retrieve all the header + * packets. + * - For each uncompressed frame: + * - Submit the uncompressed frame via th_encode_ycbcr_in() + * - Repeatedly call th_encode_packetout() to retrieve any video data packets + * that are ready. + * - Call th_encode_free() to release all encoder memory.*/ +/*@{*/ +/**Allocates an encoder instance. + * \param _info A #th_info struct filled with the desired encoding parameters. + * \return The initialized #th_enc_ctx handle. + * \retval NULL If the encoding parameters were invalid.*/ +extern th_enc_ctx *th_encode_alloc(const th_info *_info); +/**Encoder control function. + * This is used to provide advanced control the encoding process. + * \param _enc A #th_enc_ctx handle. + * \param _req The control code to process. + * See \ref encctlcodes "the list of available control codes" + * for details. + * \param _buf The parameters for this control code. + * \param _buf_sz The size of the parameter buffer.*/ +extern int th_encode_ctl(th_enc_ctx *_enc,int _req,void *_buf,size_t _buf_sz); +/**Outputs the next header packet. + * This should be called repeatedly after encoder initialization until it + * returns 0 in order to get all of the header packets, in order, before + * encoding actual video data. + * \param _enc A #th_enc_ctx handle. + * \param _comments The metadata to place in the comment header, when it is + * encoded. + * \param _op An ogg_packet structure to fill. + * All of the elements of this structure will be set, + * including a pointer to the header data. + * The memory for the header data is owned by + * libtheoraenc, and may be invalidated when the + * next encoder function is called. + * \return A positive value indicates that a header packet was successfully + * produced. + * \retval 0 No packet was produced, and no more header packets remain. + * \retval TH_EFAULT \a _enc, \a _comments, or \a _op was NULL.*/ +extern int th_encode_flushheader(th_enc_ctx *_enc, + th_comment *_comments,ogg_packet *_op); +/**Submits an uncompressed frame to the encoder. + * \param _enc A #th_enc_ctx handle. + * \param _ycbcr A buffer of Y'CbCr data to encode. + * If the width and height of the buffer matches the frame size + * the encoder was initialized with, the encoder will only + * reference the portion inside the picture region. + * Any data outside this region will be ignored, and need not map + * to a valid address. + * Alternatively, you can pass a buffer equal to the size of the + * picture region, if this is less than the full frame size. + * When using subsampled chroma planes, odd picture sizes or odd + * picture offsets may require an unexpected chroma plane size, + * and their use is generally discouraged, as they will not be + * well-supported by players and other media frameworks. + * See Section 4.4 of + * the Theora + * specification for details if you wish to use them anyway. + * \retval 0 Success. + * \retval TH_EFAULT \a _enc or \a _ycbcr is NULL. + * \retval TH_EINVAL The buffer size matches neither the frame size nor the + * picture size the encoder was initialized with, or + * encoding has already completed.*/ +extern int th_encode_ycbcr_in(th_enc_ctx *_enc,th_ycbcr_buffer _ycbcr); +/**Retrieves encoded video data packets. + * This should be called repeatedly after each frame is submitted to flush any + * encoded packets, until it returns 0. + * The encoder will not buffer these packets as subsequent frames are + * compressed, so a failure to do so will result in lost video data. + * \note Currently the encoder operates in a one-frame-in, one-packet-out + * manner. + * However, this may be changed in the future. + * \param _enc A #th_enc_ctx handle. + * \param _last Set this flag to a non-zero value if no more uncompressed + * frames will be submitted. + * This ensures that a proper EOS flag is set on the last packet. + * \param _op An ogg_packet structure to fill. + * All of the elements of this structure will be set, including a + * pointer to the video data. + * The memory for the video data is owned by + * libtheoraenc, and may be invalidated when the next + * encoder function is called. + * \return A positive value indicates that a video data packet was successfully + * produced. + * \retval 0 No packet was produced, and no more encoded video data + * remains. + * \retval TH_EFAULT \a _enc or \a _op was NULL.*/ +extern int th_encode_packetout(th_enc_ctx *_enc,int _last,ogg_packet *_op); +/**Frees an allocated encoder instance. + * \param _enc A #th_enc_ctx handle.*/ +extern void th_encode_free(th_enc_ctx *_enc); +/*@}*/ +/*@}*/ + + + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/libs/libtheora-1.1/lib/Makefile.am b/libs/libtheora-1.1/lib/Makefile.am new file mode 100644 index 00000000..bcd8e67c --- /dev/null +++ b/libs/libtheora-1.1/lib/Makefile.am @@ -0,0 +1,177 @@ +INCLUDES = -I$(top_srcdir)/include +AM_CFLAGS = $(OGG_CFLAGS) $(CAIRO_CFLAGS) + +EXTRA_DIST = \ + cpu.c \ + encoder_disabled.c \ + x86/mmxencfrag.c \ + x86/mmxfdct.c \ + x86/sse2fdct.c \ + x86/x86enc.c \ + x86/x86enc.h \ + x86/mmxfrag.c \ + x86/mmxfrag.h \ + x86/mmxidct.c \ + x86/mmxloop.h \ + x86/mmxstate.c \ + x86/x86int.h \ + x86/x86state.c \ + x86_vc + +lib_LTLIBRARIES = libtheoradec.la libtheoraenc.la libtheora.la + +if THEORA_DISABLE_ENCODE +encoder_uniq_sources = \ + encoder_disabled.c + +encoder_sources = \ + $(encoder_uniq_sources) +else +encoder_uniq_x86_sources = \ + x86/mmxencfrag.c \ + x86/mmxfdct.c \ + x86/x86enc.c + +encoder_uniq_x86_64_sources = \ + x86/sse2fdct.c + +encoder_shared_x86_sources = \ + x86/mmxfrag.c \ + x86/mmxidct.c \ + x86/mmxstate.c \ + x86/x86state.c + +encoder_shared_x86_64_sources = + +if CPU_x86_64 +encoder_uniq_arch_sources = \ + $(encoder_uniq_x86_sources) \ + $(encoder_uniq_x86_64_sources) +encoder_shared_arch_sources = \ + $(encoder_shared_x86_sources) \ + $(encoder_shared_x86_64_sources) +else +if CPU_x86_32 +encoder_uniq_arch_sources = $(encoder_uniq_x86_sources) +encoder_shared_arch_sources = $(encoder_shared_x86_sources) +else +encoder_uniq_arch_sources = +encoder_shared_arch_sources = +endif +endif + +encoder_uniq_sources = \ + analyze.c \ + fdct.c \ + encfrag.c \ + encapiwrapper.c \ + encinfo.c \ + encode.c \ + enquant.c \ + huffenc.c \ + mathops.c \ + mcenc.c \ + rate.c \ + tokenize.c \ + $(encoder_uniq_arch_sources) + +encoder_sources = \ + apiwrapper.c \ + fragment.c \ + idct.c \ + internal.c \ + state.c \ + quant.c \ + $(encoder_shared_arch_sources) \ + $(encoder_uniq_sources) + +endif + +decoder_x86_sources = \ + x86/mmxidct.c \ + x86/mmxfrag.c \ + x86/mmxstate.c \ + x86/x86state.c +if CPU_x86_64 +decoder_arch_sources = $(decoder_x86_sources) +else +if CPU_x86_32 +decoder_arch_sources = $(decoder_x86_sources) +else +decoder_arch_sources = +endif +endif + +decoder_sources = \ + apiwrapper.c \ + bitpack.c \ + decapiwrapper.c \ + decinfo.c \ + decode.c \ + dequant.c \ + fragment.c \ + huffdec.c \ + idct.c \ + info.c \ + internal.c \ + quant.c \ + state.c \ + $(decoder_arch_sources) + +noinst_HEADERS = \ + cpu.h \ + internal.h \ + encint.h \ + enquant.h \ + huffenc.h \ + mathops.h \ + modedec.h \ + x86/x86enc.h \ + apiwrapper.h \ + bitpack.h \ + dct.h \ + decint.h \ + dequant.h \ + huffdec.h \ + huffman.h \ + ocintrin.h \ + quant.h \ + x86/mmxfrag.h \ + x86/mmxloop.h \ + x86/x86int.h + +libtheoradec_la_SOURCES = \ + $(decoder_sources) \ + Version_script-dec theoradec.exp +libtheoradec_la_LDFLAGS = \ + -version-info @THDEC_LIB_CURRENT@:@THDEC_LIB_REVISION@:@THDEC_LIB_AGE@ \ + @THEORADEC_LDFLAGS@ @CAIRO_LIBS@ \ + -no-undefined + +libtheoraenc_la_SOURCES = \ + $(encoder_sources) \ + Version_script-enc theoraenc.exp +libtheoraenc_la_LDFLAGS = \ + -version-info @THENC_LIB_CURRENT@:@THENC_LIB_REVISION@:@THENC_LIB_AGE@ \ + @THEORAENC_LDFLAGS@ $(OGG_LIBS) \ + -no-undefined +libtheoraenc_la_LIBADD = libtheoradec.la + +libtheora_la_SOURCES = \ + $(decoder_sources) \ + $(encoder_uniq_sources) \ + Version_script theora.exp +libtheora_la_LDFLAGS = \ + -version-info @TH_LIB_CURRENT@:@TH_LIB_REVISION@:@TH_LIB_AGE@ \ + @THEORA_LDFLAGS@ @CAIRO_LIBS@ $(OGG_LIBS) \ + -no-undefined + +debug: + $(MAKE) all CFLAGS="@DEBUG@" + +profile: + $(MAKE) all CFLAGS="@PROFILE@" + +# contstruct various symbol export list files +.def.exp : defexp.awk + awk -f defexp.awk $< > $@ diff --git a/libs/libtheora-1.1/lib/Version_script b/libs/libtheora-1.1/lib/Version_script new file mode 100644 index 00000000..2ecb5e43 --- /dev/null +++ b/libs/libtheora-1.1/lib/Version_script @@ -0,0 +1,53 @@ +# +# Export file for libtheora +# +# Only the symbols listed in the global section will be callable from +# applications linking to the libraries. +# + +# We use something that looks like a versioned so filename here +# to define the old API because of a historical confusion. This +# label must be kept to maintain ABI compatibility. + +libtheora.so.1.0 +{ + global: + theora_version_string; + theora_version_number; + + theora_encode_init; + theora_encode_YUVin; + theora_encode_packetout; + theora_encode_header; + theora_encode_comment; + theora_encode_tables; + + theora_decode_header; + theora_decode_init; + theora_decode_packetin; + theora_decode_YUVout; + + theora_control; + + theora_packet_isheader; + theora_packet_iskeyframe; + + theora_granule_shift; + theora_granule_frame; + theora_granule_time; + + theora_info_init; + theora_info_clear; + + theora_clear; + + theora_comment_init; + theora_comment_add; + theora_comment_add_tag; + theora_comment_query; + theora_comment_query_count; + theora_comment_clear; + + local: + *; +}; diff --git a/libs/libtheora-1.1/lib/Version_script-dec b/libs/libtheora-1.1/lib/Version_script-dec new file mode 100644 index 00000000..cab36839 --- /dev/null +++ b/libs/libtheora-1.1/lib/Version_script-dec @@ -0,0 +1,82 @@ +# +# Export file for libtheoradec +# +# Only the symbols listed in the global section will be callable from +# applications linking to the libraries. +# + +# The 1.x API +libtheoradec_1.0 +{ + global: + th_version_string; + th_version_number; + + th_decode_headerin; + th_decode_alloc; + th_setup_free; + th_decode_ctl; + th_decode_packetin; + th_decode_ycbcr_out; + th_decode_free; + + th_packet_isheader; + th_packet_iskeyframe; + + th_granule_frame; + th_granule_time; + + th_info_init; + th_info_clear; + + th_comment_init; + th_comment_add; + th_comment_add_tag; + th_comment_query; + th_comment_query_count; + th_comment_clear; + + local: + *; +}; + +# The deprecated legacy api from the libtheora alpha releases. +# We use something that looks like a versioned so filename here +# to define the old API because of a historical confusion. This +# label must be kept to maintain ABI compatibility. + +libtheora.so.1.0 +{ + global: + theora_version_string; + theora_version_number; + + theora_decode_header; + theora_decode_init; + theora_decode_packetin; + theora_decode_YUVout; + + theora_control; + + theora_packet_isheader; + theora_packet_iskeyframe; + + theora_granule_shift; + theora_granule_frame; + theora_granule_time; + + theora_info_init; + theora_info_clear; + + theora_clear; + + theora_comment_init; + theora_comment_add; + theora_comment_add_tag; + theora_comment_query; + theora_comment_query_count; + theora_comment_clear; + + local: + *; +}; diff --git a/libs/libtheora-1.1/lib/Version_script-enc b/libs/libtheora-1.1/lib/Version_script-enc new file mode 100644 index 00000000..37699edd --- /dev/null +++ b/libs/libtheora-1.1/lib/Version_script-enc @@ -0,0 +1,43 @@ +# +# Export file for libtheora +# +# Only the symbols listed in the global section will be callable from +# applications linking to the libraries. +# + +# The 1.x encoder API +libtheoraenc_1.0 +{ + global: + th_encode_alloc; + th_encode_ctl; + th_encode_flushheader; + th_encode_ycbcr_in; + th_encode_packetout; + th_encode_free; + + TH_VP31_QUANT_INFO; + TH_VP31_HUFF_CODES; + + local: + *; +}; + +# The encoder portion of the deprecated alpha release api. +# We use something that looks like a versioned so filename here +# to define the old API because of a historical confusion. This +# label must be kept to maintain ABI compatibility. + +libtheora.so.1.0 +{ + global: + theora_encode_init; + theora_encode_YUVin; + theora_encode_packetout; + theora_encode_header; + theora_encode_comment; + theora_encode_tables; + + local: + *; +}; diff --git a/libs/libtheora-1.1/lib/analyze.c b/libs/libtheora-1.1/lib/analyze.c new file mode 100644 index 00000000..8a366c7a --- /dev/null +++ b/libs/libtheora-1.1/lib/analyze.c @@ -0,0 +1,2701 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: mode selection code + last mod: $Id$ + + ********************************************************************/ +#include +#include +#include "encint.h" +#include "modedec.h" + + + +typedef struct oc_fr_state oc_fr_state; +typedef struct oc_qii_state oc_qii_state; +typedef struct oc_enc_pipeline_state oc_enc_pipeline_state; +typedef struct oc_rd_metric oc_rd_metric; +typedef struct oc_mode_choice oc_mode_choice; + + + +/*There are 8 possible schemes used to encode macro block modes. + Schemes 0-6 use a maximally-skewed Huffman code to code each of the modes. + The same set of Huffman codes is used for each of these 7 schemes, but the + mode assigned to each codeword varies. + Scheme 0 writes a custom mapping from codeword to MB mode to the bitstream, + while schemes 1-6 have a fixed mapping. + Scheme 7 just encodes each mode directly in 3 bits.*/ + +/*The mode orderings for the various mode coding schemes. + Scheme 0 uses a custom alphabet, which is not stored in this table. + This is the inverse of the equivalent table OC_MODE_ALPHABETS in the + decoder.*/ +static const unsigned char OC_MODE_RANKS[7][OC_NMODES]={ + /*Last MV dominates.*/ + /*L P M N I G GM 4*/ + {3,4,2,0,1,5,6,7}, + /*L P N M I G GM 4*/ + {2,4,3,0,1,5,6,7}, + /*L M P N I G GM 4*/ + {3,4,1,0,2,5,6,7}, + /*L M N P I G GM 4*/ + {2,4,1,0,3,5,6,7}, + /*No MV dominates.*/ + /*N L P M I G GM 4*/ + {0,4,3,1,2,5,6,7}, + /*N G L P M I GM 4*/ + {0,5,4,2,3,1,6,7}, + /*Default ordering.*/ + /*N I M L P G GM 4*/ + {0,1,2,3,4,5,6,7} +}; + + + +/*Initialize the mode scheme chooser. + This need only be called once per encoder.*/ +void oc_mode_scheme_chooser_init(oc_mode_scheme_chooser *_chooser){ + int si; + _chooser->mode_ranks[0]=_chooser->scheme0_ranks; + for(si=1;si<8;si++)_chooser->mode_ranks[si]=OC_MODE_RANKS[si-1]; +} + +/*Reset the mode scheme chooser. + This needs to be called once for each frame, including the first.*/ +static void oc_mode_scheme_chooser_reset(oc_mode_scheme_chooser *_chooser){ + int si; + memset(_chooser->mode_counts,0,OC_NMODES*sizeof(*_chooser->mode_counts)); + /*Scheme 0 starts with 24 bits to store the mode list in.*/ + _chooser->scheme_bits[0]=24; + memset(_chooser->scheme_bits+1,0,7*sizeof(*_chooser->scheme_bits)); + for(si=0;si<8;si++){ + /*Scheme 7 should always start first, and scheme 0 should always start + last.*/ + _chooser->scheme_list[si]=7-si; + _chooser->scheme0_list[si]=_chooser->scheme0_ranks[si]=si; + } +} + + +/*This is the real purpose of this data structure: not actually selecting a + mode scheme, but estimating the cost of coding a given mode given all the + modes selected so far. + This is done via opportunity cost: the cost is defined as the number of bits + required to encode all the modes selected so far including the current one + using the best possible scheme, minus the number of bits required to encode + all the modes selected so far not including the current one using the best + possible scheme. + The computational expense of doing this probably makes it overkill. + Just be happy we take a greedy approach instead of trying to solve the + global mode-selection problem (which is NP-hard). + _mb_mode: The mode to determine the cost of. + Return: The number of bits required to code this mode.*/ +static int oc_mode_scheme_chooser_cost(oc_mode_scheme_chooser *_chooser, + int _mb_mode){ + int scheme0; + int scheme1; + int best_bits; + int mode_bits; + int si; + int scheme_bits; + scheme0=_chooser->scheme_list[0]; + scheme1=_chooser->scheme_list[1]; + best_bits=_chooser->scheme_bits[scheme0]; + mode_bits=OC_MODE_BITS[scheme0+1>>3][_chooser->mode_ranks[scheme0][_mb_mode]]; + /*Typical case: If the difference between the best scheme and the next best + is greater than 6 bits, then adding just one mode cannot change which + scheme we use.*/ + if(_chooser->scheme_bits[scheme1]-best_bits>6)return mode_bits; + /*Otherwise, check to see if adding this mode selects a different scheme as + the best.*/ + si=1; + best_bits+=mode_bits; + do{ + /*For any scheme except 0, we can just use the bit cost of the mode's rank + in that scheme.*/ + if(scheme1!=0){ + scheme_bits=_chooser->scheme_bits[scheme1]+ + OC_MODE_BITS[scheme1+1>>3][_chooser->mode_ranks[scheme1][_mb_mode]]; + } + else{ + int ri; + /*For scheme 0, incrementing the mode count could potentially change the + mode's rank. + Find the index where the mode would be moved to in the optimal list, + and use its bit cost instead of the one for the mode's current + position in the list.*/ + /*We don't recompute scheme bits; this is computing opportunity cost, not + an update.*/ + for(ri=_chooser->scheme0_ranks[_mb_mode];ri>0&& + _chooser->mode_counts[_mb_mode]>= + _chooser->mode_counts[_chooser->scheme0_list[ri-1]];ri--); + scheme_bits=_chooser->scheme_bits[0]+OC_MODE_BITS[0][ri]; + } + if(scheme_bits=8)break; + scheme1=_chooser->scheme_list[si]; + } + while(_chooser->scheme_bits[scheme1]-_chooser->scheme_bits[scheme0]<=6); + return best_bits-_chooser->scheme_bits[scheme0]; +} + +/*Incrementally update the mode counts and per-scheme bit counts and re-order + the scheme lists once a mode has been selected. + _mb_mode: The mode that was chosen.*/ +static void oc_mode_scheme_chooser_update(oc_mode_scheme_chooser *_chooser, + int _mb_mode){ + int ri; + int si; + _chooser->mode_counts[_mb_mode]++; + /*Re-order the scheme0 mode list if necessary.*/ + for(ri=_chooser->scheme0_ranks[_mb_mode];ri>0;ri--){ + int pmode; + pmode=_chooser->scheme0_list[ri-1]; + if(_chooser->mode_counts[pmode]>=_chooser->mode_counts[_mb_mode])break; + /*Reorder the mode ranking.*/ + _chooser->scheme0_ranks[pmode]++; + _chooser->scheme0_list[ri]=pmode; + } + _chooser->scheme0_ranks[_mb_mode]=ri; + _chooser->scheme0_list[ri]=_mb_mode; + /*Now add the bit cost for the mode to each scheme.*/ + for(si=0;si<8;si++){ + _chooser->scheme_bits[si]+= + OC_MODE_BITS[si+1>>3][_chooser->mode_ranks[si][_mb_mode]]; + } + /*Finally, re-order the list of schemes.*/ + for(si=1;si<8;si++){ + int sj; + int scheme0; + int bits0; + sj=si; + scheme0=_chooser->scheme_list[si]; + bits0=_chooser->scheme_bits[scheme0]; + do{ + int scheme1; + scheme1=_chooser->scheme_list[sj-1]; + if(bits0>=_chooser->scheme_bits[scheme1])break; + _chooser->scheme_list[sj]=scheme1; + } + while(--sj>0); + _chooser->scheme_list[sj]=scheme0; + } +} + + + +/*The number of bits required to encode a super block run. + _run_count: The desired run count; must be positive and less than 4130.*/ +static int oc_sb_run_bits(int _run_count){ + int i; + for(i=0;_run_count>=OC_SB_RUN_VAL_MIN[i+1];i++); + return OC_SB_RUN_CODE_NBITS[i]; +} + +/*The number of bits required to encode a block run. + _run_count: The desired run count; must be positive and less than 30.*/ +static int oc_block_run_bits(int _run_count){ + return OC_BLOCK_RUN_CODE_NBITS[_run_count-1]; +} + + + +/*State to track coded block flags and their bit cost.*/ +struct oc_fr_state{ + ptrdiff_t bits; + unsigned sb_partial_count:16; + unsigned sb_full_count:16; + unsigned b_coded_count_prev:8; + unsigned b_coded_count:8; + unsigned b_count:8; + signed int sb_partial:2; + signed int sb_full:2; + signed int b_coded_prev:2; + signed int b_coded:2; +}; + + + +static void oc_fr_state_init(oc_fr_state *_fr){ + _fr->bits=0; + _fr->sb_partial_count=0; + _fr->sb_full_count=0; + _fr->b_coded_count_prev=0; + _fr->b_coded_count=0; + _fr->b_count=0; + _fr->sb_partial=-1; + _fr->sb_full=-1; + _fr->b_coded_prev=-1; + _fr->b_coded=-1; +} + + +static void oc_fr_state_advance_sb(oc_fr_state *_fr, + int _sb_partial,int _sb_full){ + ptrdiff_t bits; + int sb_partial_count; + int sb_full_count; + bits=_fr->bits; + /*Extend the sb_partial run, or start a new one.*/ + sb_partial_count=_fr->sb_partial; + if(_fr->sb_partial==_sb_partial){ + if(sb_partial_count>=4129){ + bits++; + sb_partial_count=0; + } + else bits-=oc_sb_run_bits(sb_partial_count); + } + else sb_partial_count=0; + sb_partial_count++; + bits+=oc_sb_run_bits(sb_partial_count); + if(!_sb_partial){ + /*Extend the sb_full run, or start a new one.*/ + sb_full_count=_fr->sb_full_count; + if(_fr->sb_full==_sb_full){ + if(sb_full_count>=4129){ + bits++; + sb_full_count=0; + } + else bits-=oc_sb_run_bits(sb_full_count); + } + else sb_full_count=0; + sb_full_count++; + bits+=oc_sb_run_bits(sb_full_count); + _fr->sb_full=_sb_full; + _fr->sb_full_count=sb_full_count; + } + _fr->bits=bits; + _fr->sb_partial=_sb_partial; + _fr->sb_partial_count=sb_partial_count; +} + +/*Flush any outstanding block flags for a SB (e.g., one with fewer than 16 + blocks).*/ +static void oc_fr_state_flush_sb(oc_fr_state *_fr){ + ptrdiff_t bits; + int sb_partial; + int sb_full=sb_full; + int b_coded_count; + int b_coded; + int b_count; + b_count=_fr->b_count; + if(b_count>0){ + bits=_fr->bits; + b_coded=_fr->b_coded; + b_coded_count=_fr->b_coded_count; + if(b_coded_count>=b_count){ + /*This SB was fully coded/uncoded; roll back the partial block flags.*/ + bits-=oc_block_run_bits(b_coded_count); + if(b_coded_count>b_count)bits+=oc_block_run_bits(b_coded_count-b_count); + sb_partial=0; + sb_full=b_coded; + b_coded=_fr->b_coded_prev; + b_coded_count=_fr->b_coded_count_prev; + } + else{ + /*It was partially coded.*/ + sb_partial=1; + /*sb_full is unused.*/ + } + _fr->bits=bits; + _fr->b_coded_count=b_coded_count; + _fr->b_coded_count_prev=b_coded_count; + _fr->b_count=0; + _fr->b_coded=b_coded; + _fr->b_coded_prev=b_coded; + oc_fr_state_advance_sb(_fr,sb_partial,sb_full); + } +} + +static void oc_fr_state_advance_block(oc_fr_state *_fr,int _b_coded){ + ptrdiff_t bits; + int b_coded_count; + int b_count; + int sb_partial; + int sb_full=sb_full; + bits=_fr->bits; + /*Extend the b_coded run, or start a new one.*/ + b_coded_count=_fr->b_coded_count; + if(_fr->b_coded==_b_coded)bits-=oc_block_run_bits(b_coded_count); + else b_coded_count=0; + b_coded_count++; + b_count=_fr->b_count+1; + if(b_count>=16){ + /*We finished a superblock.*/ + if(b_coded_count>=16){ + /*It was fully coded/uncoded; roll back the partial block flags.*/ + if(b_coded_count>16)bits+=oc_block_run_bits(b_coded_count-16); + sb_partial=0; + sb_full=_b_coded; + _b_coded=_fr->b_coded_prev; + b_coded_count=_fr->b_coded_count_prev; + } + else{ + bits+=oc_block_run_bits(b_coded_count); + /*It was partially coded.*/ + sb_partial=1; + /*sb_full is unused.*/ + } + _fr->bits=bits; + _fr->b_coded_count=b_coded_count; + _fr->b_coded_count_prev=b_coded_count; + _fr->b_count=0; + _fr->b_coded=_b_coded; + _fr->b_coded_prev=_b_coded; + oc_fr_state_advance_sb(_fr,sb_partial,sb_full); + } + else{ + bits+=oc_block_run_bits(b_coded_count); + _fr->bits=bits; + _fr->b_coded_count=b_coded_count; + _fr->b_count=b_count; + _fr->b_coded=_b_coded; + } +} + +static void oc_fr_skip_block(oc_fr_state *_fr){ + oc_fr_state_advance_block(_fr,0); +} + +static void oc_fr_code_block(oc_fr_state *_fr){ + oc_fr_state_advance_block(_fr,1); +} + +static int oc_fr_cost1(const oc_fr_state *_fr){ + oc_fr_state tmp; + ptrdiff_t bits; + *&tmp=*_fr; + oc_fr_skip_block(&tmp); + bits=tmp.bits; + *&tmp=*_fr; + oc_fr_code_block(&tmp); + return (int)(tmp.bits-bits); +} + +static int oc_fr_cost4(const oc_fr_state *_pre,const oc_fr_state *_post){ + oc_fr_state tmp; + *&tmp=*_pre; + oc_fr_skip_block(&tmp); + oc_fr_skip_block(&tmp); + oc_fr_skip_block(&tmp); + oc_fr_skip_block(&tmp); + return (int)(_post->bits-tmp.bits); +} + + + +struct oc_qii_state{ + ptrdiff_t bits; + unsigned qi01_count:14; + signed int qi01:2; + unsigned qi12_count:14; + signed int qi12:2; +}; + + + +static void oc_qii_state_init(oc_qii_state *_qs){ + _qs->bits=0; + _qs->qi01_count=0; + _qs->qi01=-1; + _qs->qi12_count=0; + _qs->qi12=-1; +} + + +static void oc_qii_state_advance(oc_qii_state *_qd, + const oc_qii_state *_qs,int _qii){ + ptrdiff_t bits; + int qi01; + int qi01_count; + int qi12; + int qi12_count; + bits=_qs->bits; + qi01=_qii+1>>1; + qi01_count=_qs->qi01_count; + if(qi01==_qs->qi01){ + if(qi01_count>=4129){ + bits++; + qi01_count=0; + } + else bits-=oc_sb_run_bits(qi01_count); + } + else qi01_count=0; + qi01_count++; + bits+=oc_sb_run_bits(qi01_count); + qi12_count=_qs->qi12_count; + if(_qii){ + qi12=_qii>>1; + if(qi12==_qs->qi12){ + if(qi12_count>=4129){ + bits++; + qi12_count=0; + } + else bits-=oc_sb_run_bits(qi12_count); + } + else qi12_count=0; + qi12_count++; + bits+=oc_sb_run_bits(qi12_count); + } + else qi12=_qs->qi12; + _qd->bits=bits; + _qd->qi01=qi01; + _qd->qi01_count=qi01_count; + _qd->qi12=qi12; + _qd->qi12_count=qi12_count; +} + + + +/*Temporary encoder state for the analysis pipeline.*/ +struct oc_enc_pipeline_state{ + int bounding_values[256]; + oc_fr_state fr[3]; + oc_qii_state qs[3]; + /*Condensed dequantization tables.*/ + const ogg_uint16_t *dequant[3][3][2]; + /*Condensed quantization tables.*/ + const oc_iquant *enquant[3][3][2]; + /*Skip SSD storage for the current MCU in each plane.*/ + unsigned *skip_ssd[3]; + /*Coded/uncoded fragment lists for each plane for the current MCU.*/ + ptrdiff_t *coded_fragis[3]; + ptrdiff_t *uncoded_fragis[3]; + ptrdiff_t ncoded_fragis[3]; + ptrdiff_t nuncoded_fragis[3]; + /*The starting fragment for the current MCU in each plane.*/ + ptrdiff_t froffset[3]; + /*The starting row for the current MCU in each plane.*/ + int fragy0[3]; + /*The ending row for the current MCU in each plane.*/ + int fragy_end[3]; + /*The starting superblock for the current MCU in each plane.*/ + unsigned sbi0[3]; + /*The ending superblock for the current MCU in each plane.*/ + unsigned sbi_end[3]; + /*The number of tokens for zzi=1 for each color plane.*/ + int ndct_tokens1[3]; + /*The outstanding eob_run count for zzi=1 for each color plane.*/ + int eob_run1[3]; + /*Whether or not the loop filter is enabled.*/ + int loop_filter; +}; + + +static void oc_enc_pipeline_init(oc_enc_ctx *_enc,oc_enc_pipeline_state *_pipe){ + ptrdiff_t *coded_fragis; + unsigned mcu_nvsbs; + ptrdiff_t mcu_nfrags; + int hdec; + int vdec; + int pli; + int qii; + int qti; + /*Initialize the per-plane coded block flag trackers. + These are used for bit-estimation purposes only; the real flag bits span + all three planes, so we can't compute them in parallel.*/ + for(pli=0;pli<3;pli++)oc_fr_state_init(_pipe->fr+pli); + for(pli=0;pli<3;pli++)oc_qii_state_init(_pipe->qs+pli); + /*Set up the per-plane skip SSD storage pointers.*/ + mcu_nvsbs=_enc->mcu_nvsbs; + mcu_nfrags=mcu_nvsbs*_enc->state.fplanes[0].nhsbs*16; + hdec=!(_enc->state.info.pixel_fmt&1); + vdec=!(_enc->state.info.pixel_fmt&2); + _pipe->skip_ssd[0]=_enc->mcu_skip_ssd; + _pipe->skip_ssd[1]=_pipe->skip_ssd[0]+mcu_nfrags; + _pipe->skip_ssd[2]=_pipe->skip_ssd[1]+(mcu_nfrags>>hdec+vdec); + /*Set up per-plane pointers to the coded and uncoded fragments lists. + Unlike the decoder, each planes' coded and uncoded fragment list is kept + separate during the analysis stage; we only make the coded list for all + three planes contiguous right before the final packet is output + (destroying the uncoded lists, which are no longer needed).*/ + coded_fragis=_enc->state.coded_fragis; + for(pli=0;pli<3;pli++){ + _pipe->coded_fragis[pli]=coded_fragis; + coded_fragis+=_enc->state.fplanes[pli].nfrags; + _pipe->uncoded_fragis[pli]=coded_fragis; + } + memset(_pipe->ncoded_fragis,0,sizeof(_pipe->ncoded_fragis)); + memset(_pipe->nuncoded_fragis,0,sizeof(_pipe->nuncoded_fragis)); + /*Set up condensed quantizer tables.*/ + for(pli=0;pli<3;pli++){ + for(qii=0;qii<_enc->state.nqis;qii++){ + int qi; + qi=_enc->state.qis[qii]; + for(qti=0;qti<2;qti++){ + _pipe->dequant[pli][qii][qti]=_enc->state.dequant_tables[qi][pli][qti]; + _pipe->enquant[pli][qii][qti]=_enc->enquant_tables[qi][pli][qti]; + } + } + } + /*Initialize the tokenization state.*/ + for(pli=0;pli<3;pli++){ + _pipe->ndct_tokens1[pli]=0; + _pipe->eob_run1[pli]=0; + } + /*Initialize the bounding value array for the loop filter.*/ + _pipe->loop_filter=!oc_state_loop_filter_init(&_enc->state, + _pipe->bounding_values); +} + +/*Sets the current MCU stripe to super block row _sby. + Return: A non-zero value if this was the last MCU.*/ +static int oc_enc_pipeline_set_stripe(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,int _sby){ + const oc_fragment_plane *fplane; + unsigned mcu_nvsbs; + int sby_end; + int notdone; + int vdec; + int pli; + mcu_nvsbs=_enc->mcu_nvsbs; + sby_end=_enc->state.fplanes[0].nvsbs; + notdone=_sby+mcu_nvsbsstate.fplanes+pli; + _pipe->sbi0[pli]=fplane->sboffset+(_sby>>vdec)*fplane->nhsbs; + _pipe->fragy0[pli]=_sby<<2-vdec; + _pipe->froffset[pli]=fplane->froffset + +_pipe->fragy0[pli]*(ptrdiff_t)fplane->nhfrags; + if(notdone){ + _pipe->sbi_end[pli]=fplane->sboffset+(sby_end>>vdec)*fplane->nhsbs; + _pipe->fragy_end[pli]=sby_end<<2-vdec; + } + else{ + _pipe->sbi_end[pli]=fplane->sboffset+fplane->nsbs; + _pipe->fragy_end[pli]=fplane->nvfrags; + } + vdec=!(_enc->state.info.pixel_fmt&2); + } + return notdone; +} + +static void oc_enc_pipeline_finish_mcu_plane(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,int _pli,int _sdelay,int _edelay){ + int refi; + /*Copy over all the uncoded fragments from this plane and advance the uncoded + fragment list.*/ + _pipe->uncoded_fragis[_pli]-=_pipe->nuncoded_fragis[_pli]; + oc_state_frag_copy_list(&_enc->state,_pipe->uncoded_fragis[_pli], + _pipe->nuncoded_fragis[_pli],OC_FRAME_SELF,OC_FRAME_PREV,_pli); + _pipe->nuncoded_fragis[_pli]=0; + /*Perform DC prediction.*/ + oc_enc_pred_dc_frag_rows(_enc,_pli, + _pipe->fragy0[_pli],_pipe->fragy_end[_pli]); + /*Finish DC tokenization.*/ + oc_enc_tokenize_dc_frag_list(_enc,_pli, + _pipe->coded_fragis[_pli],_pipe->ncoded_fragis[_pli], + _pipe->ndct_tokens1[_pli],_pipe->eob_run1[_pli]); + _pipe->ndct_tokens1[_pli]=_enc->ndct_tokens[_pli][1]; + _pipe->eob_run1[_pli]=_enc->eob_run[_pli][1]; + /*And advance the coded fragment list.*/ + _enc->state.ncoded_fragis[_pli]+=_pipe->ncoded_fragis[_pli]; + _pipe->coded_fragis[_pli]+=_pipe->ncoded_fragis[_pli]; + _pipe->ncoded_fragis[_pli]=0; + /*Apply the loop filter if necessary.*/ + refi=_enc->state.ref_frame_idx[OC_FRAME_SELF]; + if(_pipe->loop_filter){ + oc_state_loop_filter_frag_rows(&_enc->state,_pipe->bounding_values, + refi,_pli,_pipe->fragy0[_pli]-_sdelay,_pipe->fragy_end[_pli]-_edelay); + } + else _sdelay=_edelay=0; + /*To fill borders, we have an additional two pixel delay, since a fragment + in the next row could filter its top edge, using two pixels from a + fragment in this row. + But there's no reason to delay a full fragment between the two.*/ + oc_state_borders_fill_rows(&_enc->state,refi,_pli, + (_pipe->fragy0[_pli]-_sdelay<<3)-(_sdelay<<1), + (_pipe->fragy_end[_pli]-_edelay<<3)-(_edelay<<1)); +} + + + +/*Cost information about the coded blocks in a MB.*/ +struct oc_rd_metric{ + int uncoded_ac_ssd; + int coded_ac_ssd; + int ac_bits; + int dc_flag; +}; + + + +static int oc_enc_block_transform_quantize(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,int _pli,ptrdiff_t _fragi,int _overhead_bits, + oc_rd_metric *_mo,oc_token_checkpoint **_stack){ + OC_ALIGN16(ogg_int16_t dct[64]); + OC_ALIGN16(ogg_int16_t data[64]); + ogg_uint16_t dc_dequant; + const ogg_uint16_t *dequant; + const oc_iquant *enquant; + ptrdiff_t frag_offs; + int ystride; + const unsigned char *src; + const unsigned char *ref; + unsigned char *dst; + int frame_type; + int nonzero; + unsigned uncoded_ssd; + unsigned coded_ssd; + int coded_dc; + oc_token_checkpoint *checkpoint; + oc_fragment *frags; + int mb_mode; + int mv_offs[2]; + int nmv_offs; + int ac_bits; + int borderi; + int qti; + int qii; + int pi; + int zzi; + int v; + int val; + int d; + int s; + int dc; + frags=_enc->state.frags; + frag_offs=_enc->state.frag_buf_offs[_fragi]; + ystride=_enc->state.ref_ystride[_pli]; + src=_enc->state.ref_frame_data[OC_FRAME_IO]+frag_offs; + borderi=frags[_fragi].borderi; + qii=frags[_fragi].qii; + if(qii&~3){ +#if !defined(OC_COLLECT_METRICS) + if(_enc->sp_level>=OC_SP_LEVEL_EARLY_SKIP){ + /*Enable early skip detection.*/ + frags[_fragi].coded=0; + return 0; + } +#endif + /*Try and code this block anyway.*/ + qii&=3; + frags[_fragi].qii=qii; + } + mb_mode=frags[_fragi].mb_mode; + ref=_enc->state.ref_frame_data[ + _enc->state.ref_frame_idx[OC_FRAME_FOR_MODE(mb_mode)]]+frag_offs; + dst=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[OC_FRAME_SELF]] + +frag_offs; + /*Motion compensation:*/ + switch(mb_mode){ + case OC_MODE_INTRA:{ + nmv_offs=0; + oc_enc_frag_sub_128(_enc,data,src,ystride); + }break; + case OC_MODE_GOLDEN_NOMV: + case OC_MODE_INTER_NOMV:{ + nmv_offs=1; + mv_offs[0]=0; + oc_enc_frag_sub(_enc,data,src,ref,ystride); + }break; + default:{ + const oc_mv *frag_mvs; + frag_mvs=(const oc_mv *)_enc->state.frag_mvs; + nmv_offs=oc_state_get_mv_offsets(&_enc->state,mv_offs,_pli, + frag_mvs[_fragi][0],frag_mvs[_fragi][1]); + if(nmv_offs>1){ + oc_enc_frag_copy2(_enc,dst, + ref+mv_offs[0],ref+mv_offs[1],ystride); + oc_enc_frag_sub(_enc,data,src,dst,ystride); + } + else oc_enc_frag_sub(_enc,data,src,ref+mv_offs[0],ystride); + }break; + } +#if defined(OC_COLLECT_METRICS) + { + unsigned satd; + switch(nmv_offs){ + case 0:satd=oc_enc_frag_intra_satd(_enc,src,ystride);break; + case 1:{ + satd=oc_enc_frag_satd_thresh(_enc,src,ref+mv_offs[0],ystride,UINT_MAX); + }break; + default:{ + satd=oc_enc_frag_satd_thresh(_enc,src,dst,ystride,UINT_MAX); + } + } + _enc->frag_satd[_fragi]=satd; + } +#endif + /*Transform:*/ + oc_enc_fdct8x8(_enc,dct,data); + /*Quantize the DC coefficient:*/ + qti=mb_mode!=OC_MODE_INTRA; + enquant=_pipe->enquant[_pli][0][qti]; + dc_dequant=_pipe->dequant[_pli][0][qti][0]; + v=dct[0]; + val=v<<1; + s=OC_SIGNMASK(val); + val+=dc_dequant+s^s; + val=((enquant[0].m*(ogg_int32_t)val>>16)+val>>enquant[0].l)-s; + dc=OC_CLAMPI(-580,val,580); + nonzero=0; + /*Quantize the AC coefficients:*/ + dequant=_pipe->dequant[_pli][qii][qti]; + enquant=_pipe->enquant[_pli][qii][qti]; + for(zzi=1;zzi<64;zzi++){ + v=dct[OC_FZIG_ZAG[zzi]]; + d=dequant[zzi]; + val=v<<1; + v=abs(val); + if(v>=d){ + s=OC_SIGNMASK(val); + /*The bias added here rounds ties away from zero, since token + optimization can only decrease the magnitude of the quantized + value.*/ + val+=d+s^s; + /*Note the arithmetic right shift is not guaranteed by ANSI C. + Hopefully no one still uses ones-complement architectures.*/ + val=((enquant[zzi].m*(ogg_int32_t)val>>16)+val>>enquant[zzi].l)-s; + data[zzi]=OC_CLAMPI(-580,val,580); + nonzero=zzi; + } + else data[zzi]=0; + } + /*Tokenize.*/ + checkpoint=*_stack; + ac_bits=oc_enc_tokenize_ac(_enc,_pli,_fragi,data,dequant,dct,nonzero+1, + _stack,qti?0:3); + /*Reconstruct. + TODO: nonzero may need to be adjusted after tokenization.*/ + if(nonzero==0){ + ogg_int16_t p; + int ci; + /*We round this dequant product (and not any of the others) because there's + no iDCT rounding.*/ + p=(ogg_int16_t)(dc*(ogg_int32_t)dc_dequant+15>>5); + /*LOOP VECTORIZES.*/ + for(ci=0;ci<64;ci++)data[ci]=p; + } + else{ + data[0]=dc*dc_dequant; + oc_idct8x8(&_enc->state,data,nonzero+1); + } + if(!qti)oc_enc_frag_recon_intra(_enc,dst,ystride,data); + else{ + oc_enc_frag_recon_inter(_enc,dst, + nmv_offs==1?ref+mv_offs[0]:dst,ystride,data); + } + frame_type=_enc->state.frame_type; +#if !defined(OC_COLLECT_METRICS) + if(frame_type!=OC_INTRA_FRAME) +#endif + { + /*In retrospect, should we have skipped this block?*/ + oc_enc_frag_sub(_enc,data,src,dst,ystride); + coded_ssd=coded_dc=0; + if(borderi<0){ + for(pi=0;pi<64;pi++){ + coded_ssd+=data[pi]*data[pi]; + coded_dc+=data[pi]; + } + } + else{ + ogg_int64_t mask; + mask=_enc->state.borders[borderi].mask; + for(pi=0;pi<64;pi++,mask>>=1)if(mask&1){ + coded_ssd+=data[pi]*data[pi]; + coded_dc+=data[pi]; + } + } + /*Scale to match DCT domain.*/ + coded_ssd<<=4; + /*We actually only want the AC contribution to the SSD.*/ + coded_ssd-=coded_dc*coded_dc>>2; +#if defined(OC_COLLECT_METRICS) + _enc->frag_ssd[_fragi]=coded_ssd; + } + if(frame_type!=OC_INTRA_FRAME){ +#endif + uncoded_ssd=_pipe->skip_ssd[_pli][_fragi-_pipe->froffset[_pli]]; + if(uncoded_ssdlambda&& + /*Don't allow luma blocks to be skipped in 4MV mode when VP3 + compatibility is enabled.*/ + (!_enc->vp3_compatible||mb_mode!=OC_MODE_INTER_MV_FOUR||_pli)){ + /*Hm, not worth it; roll back.*/ + oc_enc_tokenlog_rollback(_enc,checkpoint,(*_stack)-checkpoint); + *_stack=checkpoint; + frags[_fragi].coded=0; + return 0; + } + } + else _mo->dc_flag=1; + _mo->uncoded_ac_ssd+=uncoded_ssd; + _mo->coded_ac_ssd+=coded_ssd; + _mo->ac_bits+=ac_bits; + } + oc_qii_state_advance(_pipe->qs+_pli,_pipe->qs+_pli,qii); + frags[_fragi].dc=dc; + frags[_fragi].coded=1; + return 1; +} + +static int oc_enc_mb_transform_quantize_luma(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,unsigned _mbi,int _mode_overhead){ + /*Worst case token stack usage for 4 fragments.*/ + oc_token_checkpoint stack[64*4]; + oc_token_checkpoint *stackptr; + const oc_sb_map *sb_maps; + signed char *mb_modes; + oc_fragment *frags; + ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t *uncoded_fragis; + ptrdiff_t nuncoded_fragis; + oc_rd_metric mo; + oc_fr_state fr_checkpoint; + oc_qii_state qs_checkpoint; + int mb_mode; + int ncoded; + ptrdiff_t fragi; + int bi; + *&fr_checkpoint=*(_pipe->fr+0); + *&qs_checkpoint=*(_pipe->qs+0); + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + mb_modes=_enc->state.mb_modes; + frags=_enc->state.frags; + coded_fragis=_pipe->coded_fragis[0]; + ncoded_fragis=_pipe->ncoded_fragis[0]; + uncoded_fragis=_pipe->uncoded_fragis[0]; + nuncoded_fragis=_pipe->nuncoded_fragis[0]; + mb_mode=mb_modes[_mbi]; + ncoded=0; + stackptr=stack; + memset(&mo,0,sizeof(mo)); + for(bi=0;bi<4;bi++){ + fragi=sb_maps[_mbi>>2][_mbi&3][bi]; + frags[fragi].mb_mode=mb_mode; + if(oc_enc_block_transform_quantize(_enc, + _pipe,0,fragi,oc_fr_cost1(_pipe->fr+0),&mo,&stackptr)){ + oc_fr_code_block(_pipe->fr+0); + coded_fragis[ncoded_fragis++]=fragi; + ncoded++; + } + else{ + *(uncoded_fragis-++nuncoded_fragis)=fragi; + oc_fr_skip_block(_pipe->fr+0); + } + } + if(_enc->state.frame_type!=OC_INTRA_FRAME){ + if(ncoded>0&&!mo.dc_flag){ + int cost; + /*Some individual blocks were worth coding. + See if that's still true when accounting for mode and MV overhead.*/ + cost=mo.coded_ac_ssd+_enc->lambda*(mo.ac_bits + +oc_fr_cost4(&fr_checkpoint,_pipe->fr+0)+_mode_overhead); + if(mo.uncoded_ac_ssd<=cost){ + /*Taking macroblock overhead into account, it is not worth coding this + MB.*/ + oc_enc_tokenlog_rollback(_enc,stack,stackptr-stack); + *(_pipe->fr+0)=*&fr_checkpoint; + *(_pipe->qs+0)=*&qs_checkpoint; + for(bi=0;bi<4;bi++){ + fragi=sb_maps[_mbi>>2][_mbi&3][bi]; + if(frags[fragi].coded){ + *(uncoded_fragis-++nuncoded_fragis)=fragi; + frags[fragi].coded=0; + } + oc_fr_skip_block(_pipe->fr+0); + } + ncoded_fragis-=ncoded; + ncoded=0; + } + } + /*If no luma blocks coded, the mode is forced.*/ + if(ncoded==0)mb_modes[_mbi]=OC_MODE_INTER_NOMV; + /*Assume that a 1MV with a single coded block is always cheaper than a 4MV + with a single coded block. + This may not be strictly true: a 4MV computes chroma MVs using (0,0) for + skipped blocks, while a 1MV does not.*/ + else if(ncoded==1&&mb_mode==OC_MODE_INTER_MV_FOUR){ + mb_modes[_mbi]=OC_MODE_INTER_MV; + } + } + _pipe->ncoded_fragis[0]=ncoded_fragis; + _pipe->nuncoded_fragis[0]=nuncoded_fragis; + return ncoded; +} + +static void oc_enc_sb_transform_quantize_chroma(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,int _pli,int _sbi_start,int _sbi_end){ + const oc_sb_map *sb_maps; + oc_sb_flags *sb_flags; + ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t *uncoded_fragis; + ptrdiff_t nuncoded_fragis; + int sbi; + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + sb_flags=_enc->state.sb_flags; + coded_fragis=_pipe->coded_fragis[_pli]; + ncoded_fragis=_pipe->ncoded_fragis[_pli]; + uncoded_fragis=_pipe->uncoded_fragis[_pli]; + nuncoded_fragis=_pipe->nuncoded_fragis[_pli]; + for(sbi=_sbi_start;sbi<_sbi_end;sbi++){ + /*Worst case token stack usage for 1 fragment.*/ + oc_token_checkpoint stack[64]; + oc_rd_metric mo; + int quadi; + int bi; + memset(&mo,0,sizeof(mo)); + for(quadi=0;quadi<4;quadi++)for(bi=0;bi<4;bi++){ + ptrdiff_t fragi; + fragi=sb_maps[sbi][quadi][bi]; + if(fragi>=0){ + oc_token_checkpoint *stackptr; + stackptr=stack; + if(oc_enc_block_transform_quantize(_enc, + _pipe,_pli,fragi,oc_fr_cost1(_pipe->fr+_pli),&mo,&stackptr)){ + coded_fragis[ncoded_fragis++]=fragi; + oc_fr_code_block(_pipe->fr+_pli); + } + else{ + *(uncoded_fragis-++nuncoded_fragis)=fragi; + oc_fr_skip_block(_pipe->fr+_pli); + } + } + } + oc_fr_state_flush_sb(_pipe->fr+_pli); + sb_flags[sbi].coded_fully=_pipe->fr[_pli].sb_full; + sb_flags[sbi].coded_partially=_pipe->fr[_pli].sb_partial; + } + _pipe->ncoded_fragis[_pli]=ncoded_fragis; + _pipe->nuncoded_fragis[_pli]=nuncoded_fragis; +} + +/*Mode decision is done by exhaustively examining all potential choices. + Obviously, doing the motion compensation, fDCT, tokenization, and then + counting the bits each token uses is computationally expensive. + Theora's EOB runs can also split the cost of these tokens across multiple + fragments, and naturally we don't know what the optimal choice of Huffman + codes will be until we know all the tokens we're going to encode in all the + fragments. + So we use a simple approach to estimating the bit cost and distortion of each + mode based upon the SATD value of the residual before coding. + The mathematics behind the technique are outlined by Kim \cite{Kim03}, but + the process (modified somewhat from that of the paper) is very simple. + We build a non-linear regression of the mappings from + (pre-transform+quantization) SATD to (post-transform+quantization) bits and + SSD for each qi. + A separate set of mappings is kept for each quantization type and color + plane. + The mappings are constructed by partitioning the SATD values into a small + number of bins (currently 24) and using a linear regression in each bin + (as opposed to the 0th-order regression used by Kim). + The bit counts and SSD measurements are obtained by examining actual encoded + frames, with appropriate lambda values and optimal Huffman codes selected. + EOB bits are assigned to the fragment that started the EOB run (as opposed to + dividing them among all the blocks in the run; though the latter approach + seems more theoretically correct, Monty's testing showed a small improvement + with the former, though that may have been merely statistical noise). + + @ARTICLE{Kim03, + author="Hyun Mun Kim", + title="Adaptive Rate Control Using Nonlinear Regression", + journal="IEEE Transactions on Circuits and Systems for Video Technology", + volume=13, + number=5, + pages="432--439", + month=May, + year=2003 + }*/ + +/*Computes (_ssd+_lambda*_rate)/(1<>OC_BIT_SCALE)+((_rate)>>OC_BIT_SCALE)*(_lambda) \ + +(((_ssd)&(1<>1)>>OC_BIT_SCALE) + +/*Estimate the R-D cost of the DCT coefficients given the SATD of a block after + prediction.*/ +static unsigned oc_dct_cost2(unsigned *_ssd, + int _qi,int _pli,int _qti,int _satd){ + unsigned rmse; + int bin; + int dx; + int y0; + int z0; + int dy; + int dz; + /*SATD metrics for chroma planes vary much less than luma, so we scale them + by 4 to distribute them into the mode decision bins more evenly.*/ + _satd<<=_pli+1&2; + bin=OC_MINI(_satd>>OC_SAD_SHIFT,OC_SAD_BINS-2); + dx=_satd-(bin<>OC_SAD_SHIFT),0); + *_ssd=rmse*rmse>>2*OC_RMSE_SCALE-OC_BIT_SCALE; + return OC_MAXI(y0+(dy*dx>>OC_SAD_SHIFT),0); +} + +/*Select luma block-level quantizers for a MB in an INTRA frame.*/ +static unsigned oc_analyze_intra_mb_luma(oc_enc_ctx *_enc, + const oc_qii_state *_qs,unsigned _mbi){ + const unsigned char *src; + const ptrdiff_t *frag_buf_offs; + const oc_sb_map *sb_maps; + oc_fragment *frags; + ptrdiff_t frag_offs; + ptrdiff_t fragi; + oc_qii_state qs[4][3]; + unsigned cost[4][3]; + unsigned ssd[4][3]; + unsigned rate[4][3]; + int prev[3][3]; + unsigned satd; + unsigned best_cost; + unsigned best_ssd; + unsigned best_rate; + int best_qii; + int qii; + int lambda; + int ystride; + int nqis; + int bi; + frag_buf_offs=_enc->state.frag_buf_offs; + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ystride=_enc->state.ref_ystride[0]; + fragi=sb_maps[_mbi>>2][_mbi&3][0]; + frag_offs=frag_buf_offs[fragi]; + satd=oc_enc_frag_intra_satd(_enc,src+frag_offs,ystride); + nqis=_enc->state.nqis; + lambda=_enc->lambda; + for(qii=0;qiistate.qis[qii],0,0,satd) + +(qs[0][qii].bits-_qs->bits<>2][_mbi&3][bi]; + frag_offs=frag_buf_offs[fragi]; + satd=oc_enc_frag_intra_satd(_enc,src+frag_offs,ystride); + for(qii=0;qiistate.qis[qii],0,0,satd); + best_ssd=ssd[bi-1][0]+cur_ssd; + best_rate=rate[bi-1][0]+cur_rate + +(qt[0].bits-qs[bi-1][0].bits<state.frags; + for(bi=3;;){ + fragi=sb_maps[_mbi>>2][_mbi&3][bi]; + frags[fragi].qii=best_qii; + if(bi--<=0)break; + best_qii=prev[bi][best_qii]; + } + return best_cost; +} + +/*Select a block-level quantizer for a single chroma block in an INTRA frame.*/ +static unsigned oc_analyze_intra_chroma_block(oc_enc_ctx *_enc, + const oc_qii_state *_qs,int _pli,ptrdiff_t _fragi){ + const unsigned char *src; + oc_fragment *frags; + ptrdiff_t frag_offs; + oc_qii_state qt[3]; + unsigned cost[3]; + unsigned satd; + unsigned best_cost; + int best_qii; + int qii; + int lambda; + int ystride; + int nqis; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ystride=_enc->state.ref_ystride[_pli]; + frag_offs=_enc->state.frag_buf_offs[_fragi]; + satd=oc_enc_frag_intra_satd(_enc,src+frag_offs,ystride); + nqis=_enc->state.nqis; + lambda=_enc->lambda; + best_qii=0; + for(qii=0;qiistate.qis[qii],_pli,0,satd) + +(qt[qii].bits-_qs->bits<state.frags; + frags[_fragi].qii=best_qii; + return best_cost; +} + +static void oc_enc_sb_transform_quantize_intra_chroma(oc_enc_ctx *_enc, + oc_enc_pipeline_state *_pipe,int _pli,int _sbi_start,int _sbi_end){ + const oc_sb_map *sb_maps; + ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + int sbi; + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + coded_fragis=_pipe->coded_fragis[_pli]; + ncoded_fragis=_pipe->ncoded_fragis[_pli]; + for(sbi=_sbi_start;sbi<_sbi_end;sbi++){ + /*Worst case token stack usage for 1 fragment.*/ + oc_token_checkpoint stack[64]; + int quadi; + int bi; + for(quadi=0;quadi<4;quadi++)for(bi=0;bi<4;bi++){ + ptrdiff_t fragi; + fragi=sb_maps[sbi][quadi][bi]; + if(fragi>=0){ + oc_token_checkpoint *stackptr; + oc_analyze_intra_chroma_block(_enc,_pipe->qs+_pli,_pli,fragi); + stackptr=stack; + oc_enc_block_transform_quantize(_enc, + _pipe,_pli,fragi,0,NULL,&stackptr); + coded_fragis[ncoded_fragis++]=fragi; + } + } + } + _pipe->ncoded_fragis[_pli]=ncoded_fragis; +} + +/*Analysis stage for an INTRA frame.*/ +void oc_enc_analyze_intra(oc_enc_ctx *_enc,int _recode){ + oc_enc_pipeline_state pipe; + const unsigned char *map_idxs; + int nmap_idxs; + oc_sb_flags *sb_flags; + signed char *mb_modes; + const oc_mb_map *mb_maps; + oc_fragment *frags; + unsigned stripe_sby; + unsigned mcu_nvsbs; + int notstart; + int notdone; + int refi; + int pli; + _enc->state.frame_type=OC_INTRA_FRAME; + oc_enc_tokenize_start(_enc); + oc_enc_pipeline_init(_enc,&pipe); + /*Choose MVs and MB modes and quantize and code luma. + Must be done in Hilbert order.*/ + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + nmap_idxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + _enc->state.ncoded_fragis[0]=0; + _enc->state.ncoded_fragis[1]=0; + _enc->state.ncoded_fragis[2]=0; + sb_flags=_enc->state.sb_flags; + mb_modes=_enc->state.mb_modes; + mb_maps=(const oc_mb_map *)_enc->state.mb_maps; + frags=_enc->state.frags; + notstart=0; + notdone=1; + mcu_nvsbs=_enc->mcu_nvsbs; + for(stripe_sby=0;notdone;stripe_sby+=mcu_nvsbs){ + unsigned sbi; + unsigned sbi_end; + notdone=oc_enc_pipeline_set_stripe(_enc,&pipe,stripe_sby); + sbi_end=pipe.sbi_end[0]; + for(sbi=pipe.sbi0[0];sbistate.curframe_num>0)oc_mcenc_search(_enc,mbi); + oc_analyze_intra_mb_luma(_enc,pipe.qs+0,mbi); + mb_modes[mbi]=OC_MODE_INTRA; + oc_enc_mb_transform_quantize_luma(_enc,&pipe,mbi,0); + /*Propagate final MB mode and MVs to the chroma blocks.*/ + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_maps[mbi][pli][bi]; + frags[fragi].mb_mode=OC_MODE_INTRA; + } + } + } + oc_enc_pipeline_finish_mcu_plane(_enc,&pipe,0,notstart,notdone); + /*Code chroma planes.*/ + for(pli=1;pli<3;pli++){ + oc_enc_sb_transform_quantize_intra_chroma(_enc,&pipe, + pli,pipe.sbi0[pli],pipe.sbi_end[pli]); + oc_enc_pipeline_finish_mcu_plane(_enc,&pipe,pli,notstart,notdone); + } + notstart=1; + } + /*Finish filling in the reference frame borders.*/ + refi=_enc->state.ref_frame_idx[OC_FRAME_SELF]; + for(pli=0;pli<3;pli++)oc_state_borders_fill_caps(&_enc->state,refi,pli); + _enc->state.ntotal_coded_fragis=_enc->state.nfrags; +} + + + +/*Cost information about a MB mode.*/ +struct oc_mode_choice{ + unsigned cost; + unsigned ssd; + unsigned rate; + unsigned overhead; + unsigned char qii[12]; +}; + + + +static void oc_mode_set_cost(oc_mode_choice *_modec,int _lambda){ + _modec->cost=OC_MODE_RD_COST(_modec->ssd, + _modec->rate+_modec->overhead,_lambda); +} + +/*A set of skip SSD's to use to disable early skipping.*/ +static const unsigned OC_NOSKIP[12]={ + UINT_MAX,UINT_MAX,UINT_MAX,UINT_MAX, + UINT_MAX,UINT_MAX,UINT_MAX,UINT_MAX, + UINT_MAX,UINT_MAX,UINT_MAX,UINT_MAX +}; + +/*The estimated number of bits used by a coded chroma block to specify the AC + quantizer. + TODO: Currently this is just 0.5*log2(3) (estimating about 50% compression); + measurements suggest this is in the right ballpark, but it varies somewhat + with lambda.*/ +#define OC_CHROMA_QII_RATE ((0xCAE00D1DU>>31-OC_BIT_SCALE)+1>>1) + +static void oc_analyze_mb_mode_luma(oc_enc_ctx *_enc, + oc_mode_choice *_modec,const oc_fr_state *_fr,const oc_qii_state *_qs, + const unsigned _frag_satd[12],const unsigned _skip_ssd[12],int _qti){ + oc_fr_state fr; + oc_qii_state qs; + unsigned ssd; + unsigned rate; + int overhead; + unsigned satd; + unsigned best_ssd; + unsigned best_rate; + int best_overhead; + int best_fri; + int best_qii; + unsigned cur_cost; + unsigned cur_ssd; + unsigned cur_rate; + int cur_overhead; + int lambda; + int nqis; + int nskipped; + int bi; + int qii; + lambda=_enc->lambda; + nqis=_enc->state.nqis; + /*We could do a trellis optimization here, but we don't make final skip + decisions until after transform+quantization, so the result wouldn't be + optimal anyway. + Instead we just use a greedy approach; for most SATD values, the + differences between the qiis are large enough to drown out the cost to + code the flags, anyway.*/ + *&fr=*_fr; + *&qs=*_qs; + ssd=rate=overhead=nskipped=0; + for(bi=0;bi<4;bi++){ + oc_fr_state ft[2]; + oc_qii_state qt[3]; + unsigned best_cost; + satd=_frag_satd[bi]; + *(ft+0)=*&fr; + oc_fr_code_block(ft+0); + oc_qii_state_advance(qt+0,&qs,0); + best_overhead=(ft[0].bits-fr.bits<state.qis[0],0,_qti,satd) + +(qt[0].bits-qs.bits<state.qis[qii],0,_qti,satd) + +(qt[qii].bits-qs.bits<qii[bi]=best_qii; + } + _modec->ssd=ssd; + _modec->rate=rate; + _modec->overhead=OC_MAXI(overhead,0); +} + +static void oc_analyze_mb_mode_chroma(oc_enc_ctx *_enc, + oc_mode_choice *_modec,const oc_fr_state *_fr,const oc_qii_state *_qs, + const unsigned _frag_satd[12],const unsigned _skip_ssd[12],int _qti){ + unsigned ssd; + unsigned rate; + unsigned satd; + unsigned best_ssd; + unsigned best_rate; + int best_qii; + unsigned cur_cost; + unsigned cur_ssd; + unsigned cur_rate; + int lambda; + int nblocks; + int nqis; + int pli; + int bi; + int qii; + lambda=_enc->lambda; + nqis=_enc->state.nqis; + ssd=_modec->ssd; + rate=_modec->rate; + /*Because (except in 4:4:4 mode) we aren't considering chroma blocks in coded + order, we assume a constant overhead for coded block and qii flags.*/ + nblocks=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + nblocks=(nblocks-4>>1)+4; + bi=4; + for(pli=1;pli<3;pli++){ + for(;bistate.qis[0],pli,_qti,satd) + +OC_CHROMA_QII_RATE; + best_cost=OC_MODE_RD_COST(ssd+best_ssd,rate+best_rate,lambda); + best_qii=0; + for(qii=1;qiistate.qis[qii],0,_qti,satd) + +OC_CHROMA_QII_RATE; + cur_cost=OC_MODE_RD_COST(ssd+cur_ssd,rate+cur_rate,lambda); + if(cur_costqii[bi]=best_qii; + } + nblocks=(nblocks-4<<1)+4; + } + _modec->ssd=ssd; + _modec->rate=rate; +} + +static void oc_skip_cost(oc_enc_ctx *_enc,oc_enc_pipeline_state *_pipe, + unsigned _mbi,unsigned _ssd[12]){ + OC_ALIGN16(ogg_int16_t buffer[64]); + const unsigned char *src; + const unsigned char *ref; + int ystride; + const oc_fragment *frags; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *sb_map; + const oc_mb_map_plane *mb_map; + const unsigned char *map_idxs; + int map_nidxs; + ogg_int64_t mask; + unsigned uncoded_ssd; + int uncoded_dc; + unsigned dc_dequant; + int dc_flag; + int mapii; + int mapi; + int pli; + int bi; + ptrdiff_t fragi; + ptrdiff_t frag_offs; + int borderi; + int pi; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[OC_FRAME_PREV]]; + ystride=_enc->state.ref_ystride[0]; + frags=_enc->state.frags; + frag_buf_offs=_enc->state.frag_buf_offs; + sb_map=_enc->state.sb_maps[_mbi>>2][_mbi&3]; + dc_dequant=_enc->state.dequant_tables[_enc->state.qis[0]][0][1][0]; + for(bi=0;bi<4;bi++){ + fragi=sb_map[bi]; + frag_offs=frag_buf_offs[fragi]; + oc_enc_frag_sub(_enc,buffer,src+frag_offs,ref+frag_offs,ystride); + borderi=frags[fragi].borderi; + uncoded_ssd=uncoded_dc=0; + if(borderi<0){ + for(pi=0;pi<64;pi++){ + uncoded_ssd+=buffer[pi]*buffer[pi]; + uncoded_dc+=buffer[pi]; + } + } + else{ + ogg_int64_t mask; + mask=_enc->state.borders[borderi].mask; + for(pi=0;pi<64;pi++,mask>>=1)if(mask&1){ + uncoded_ssd+=buffer[pi]*buffer[pi]; + uncoded_dc+=buffer[pi]; + } + } + /*Scale to match DCT domain.*/ + uncoded_ssd<<=4; + /*We actually only want the AC contribution to the SSD.*/ + uncoded_ssd-=uncoded_dc*uncoded_dc>>2; + /*DC is a special case; if there's more than a full-quantizer improvement + in the effective DC component, always force-code the block.*/ + dc_flag=abs(uncoded_dc)>dc_dequant<<1; + uncoded_ssd|=-dc_flag; + _pipe->skip_ssd[0][fragi-_pipe->froffset[0]]=_ssd[bi]=uncoded_ssd; + } + mb_map=(const oc_mb_map_plane *)_enc->state.mb_maps[_mbi]; + map_nidxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + map_nidxs=(map_nidxs-4>>1)+4; + mapii=4; + for(pli=1;pli<3;pli++){ + ystride=_enc->state.ref_ystride[pli]; + dc_dequant=_enc->state.dequant_tables[_enc->state.qis[0]][pli][1][0]; + for(;mapiistate.borders[borderi].mask; + for(pi=0;pi<64;pi++,mask>>=1)if(mask&1){ + uncoded_ssd+=buffer[pi]*buffer[pi]; + uncoded_dc+=buffer[pi]; + } + } + /*Scale to match DCT domain.*/ + uncoded_ssd<<=4; + /*We actually only want the AC contribution to the SSD.*/ + uncoded_ssd-=uncoded_dc*uncoded_dc>>2; + /*DC is a special case; if there's more than a full-quantizer improvement + in the effective DC component, always force-code the block.*/ + dc_flag=abs(uncoded_dc)>dc_dequant<<1; + uncoded_ssd|=-dc_flag; + _pipe->skip_ssd[pli][fragi-_pipe->froffset[pli]]=_ssd[mapii]=uncoded_ssd; + } + map_nidxs=(map_nidxs-4<<1)+4; + } +} + +static void oc_mb_intra_satd(oc_enc_ctx *_enc,unsigned _mbi, + unsigned _frag_satd[12]){ + const unsigned char *src; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *sb_map; + const oc_mb_map_plane *mb_map; + const unsigned char *map_idxs; + int map_nidxs; + int mapii; + int mapi; + int ystride; + int pli; + int bi; + ptrdiff_t fragi; + ptrdiff_t frag_offs; + frag_buf_offs=_enc->state.frag_buf_offs; + sb_map=_enc->state.sb_maps[_mbi>>2][_mbi&3]; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ystride=_enc->state.ref_ystride[0]; + for(bi=0;bi<4;bi++){ + fragi=sb_map[bi]; + frag_offs=frag_buf_offs[fragi]; + _frag_satd[bi]=oc_enc_frag_intra_satd(_enc,src+frag_offs,ystride); + } + mb_map=(const oc_mb_map_plane *)_enc->state.mb_maps[_mbi]; + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + map_nidxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + /*Note: This assumes ref_ystride[1]==ref_ystride[2].*/ + ystride=_enc->state.ref_ystride[1]; + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_map[pli][bi]; + frag_offs=frag_buf_offs[fragi]; + _frag_satd[mapii]=oc_enc_frag_intra_satd(_enc,src+frag_offs,ystride); + } +} + +static void oc_cost_intra(oc_enc_ctx *_enc,oc_mode_choice *_modec, + unsigned _mbi,const oc_fr_state *_fr,const oc_qii_state *_qs, + const unsigned _frag_satd[12],const unsigned _skip_ssd[12]){ + oc_analyze_mb_mode_luma(_enc,_modec,_fr,_qs,_frag_satd,_skip_ssd,0); + oc_analyze_mb_mode_chroma(_enc,_modec,_fr,_qs,_frag_satd,_skip_ssd,0); + _modec->overhead+= + oc_mode_scheme_chooser_cost(&_enc->chooser,OC_MODE_INTRA)<lambda); +} + +static void oc_cost_inter(oc_enc_ctx *_enc,oc_mode_choice *_modec, + unsigned _mbi,int _mb_mode,const signed char *_mv, + const oc_fr_state *_fr,const oc_qii_state *_qs,const unsigned _skip_ssd[12]){ + unsigned frag_satd[12]; + const unsigned char *src; + const unsigned char *ref; + int ystride; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *sb_map; + const oc_mb_map_plane *mb_map; + const unsigned char *map_idxs; + int map_nidxs; + int mapii; + int mapi; + int mv_offs[2]; + int dx; + int dy; + int pli; + int bi; + ptrdiff_t fragi; + ptrdiff_t frag_offs; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[ + _enc->state.ref_frame_idx[OC_FRAME_FOR_MODE(_mb_mode)]]; + ystride=_enc->state.ref_ystride[0]; + frag_buf_offs=_enc->state.frag_buf_offs; + sb_map=_enc->state.sb_maps[_mbi>>2][_mbi&3]; + dx=_mv[0]; + dy=_mv[1]; + _modec->rate=_modec->ssd=0; + if(oc_state_get_mv_offsets(&_enc->state,mv_offs,0,dx,dy)>1){ + for(bi=0;bi<4;bi++){ + fragi=sb_map[bi]; + frag_offs=frag_buf_offs[fragi]; + frag_satd[bi]=oc_enc_frag_satd2_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ref+frag_offs+mv_offs[1],ystride,UINT_MAX); + } + } + else{ + for(bi=0;bi<4;bi++){ + fragi=sb_map[bi]; + frag_offs=frag_buf_offs[fragi]; + frag_satd[bi]=oc_enc_frag_satd_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ystride,UINT_MAX); + } + } + mb_map=(const oc_mb_map_plane *)_enc->state.mb_maps[_mbi]; + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + map_nidxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + /*Note: This assumes ref_ystride[1]==ref_ystride[2].*/ + ystride=_enc->state.ref_ystride[1]; + if(oc_state_get_mv_offsets(&_enc->state,mv_offs,1,dx,dy)>1){ + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_map[pli][bi]; + frag_offs=frag_buf_offs[fragi]; + frag_satd[mapii]=oc_enc_frag_satd2_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ref+frag_offs+mv_offs[1],ystride,UINT_MAX); + } + } + else{ + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_map[pli][bi]; + frag_offs=frag_buf_offs[fragi]; + frag_satd[mapii]=oc_enc_frag_satd_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ystride,UINT_MAX); + } + } + oc_analyze_mb_mode_luma(_enc,_modec,_fr,_qs,frag_satd,_skip_ssd,1); + oc_analyze_mb_mode_chroma(_enc,_modec,_fr,_qs,frag_satd,_skip_ssd,1); + _modec->overhead+= + oc_mode_scheme_chooser_cost(&_enc->chooser,_mb_mode)<lambda); +} + +static void oc_cost_inter_nomv(oc_enc_ctx *_enc,oc_mode_choice *_modec, + unsigned _mbi,int _mb_mode,const oc_fr_state *_fr,const oc_qii_state *_qs, + const unsigned _skip_ssd[12]){ + static const oc_mv OC_MV_ZERO; + oc_cost_inter(_enc,_modec,_mbi,_mb_mode,OC_MV_ZERO,_fr,_qs,_skip_ssd); +} + +static int oc_cost_inter1mv(oc_enc_ctx *_enc,oc_mode_choice *_modec, + unsigned _mbi,int _mb_mode,const signed char *_mv, + const oc_fr_state *_fr,const oc_qii_state *_qs,const unsigned _skip_ssd[12]){ + int bits0; + oc_cost_inter(_enc,_modec,_mbi,_mb_mode,_mv,_fr,_qs,_skip_ssd); + bits0=OC_MV_BITS[0][_mv[0]+31]+OC_MV_BITS[0][_mv[1]+31]; + _modec->overhead+=OC_MINI(_enc->mv_bits[0]+bits0,_enc->mv_bits[1]+12) + -OC_MINI(_enc->mv_bits[0],_enc->mv_bits[1])<lambda); + return bits0; +} + +/*A mapping from oc_mb_map (raster) ordering to oc_sb_map (Hilbert) ordering.*/ +static const unsigned char OC_MB_PHASE[4][4]={ + {0,1,3,2},{0,3,1,2},{0,3,1,2},{2,3,1,0} +}; + +static void oc_cost_inter4mv(oc_enc_ctx *_enc,oc_mode_choice *_modec, + unsigned _mbi,oc_mv _mv[4],const oc_fr_state *_fr,const oc_qii_state *_qs, + const unsigned _skip_ssd[12]){ + unsigned frag_satd[12]; + oc_mv lbmvs[4]; + oc_mv cbmvs[4]; + const unsigned char *src; + const unsigned char *ref; + int ystride; + const ptrdiff_t *frag_buf_offs; + oc_mv *frag_mvs; + const oc_mb_map_plane *mb_map; + const unsigned char *map_idxs; + int map_nidxs; + int nqis; + int mapii; + int mapi; + int mv_offs[2]; + int dx; + int dy; + int pli; + int bi; + ptrdiff_t fragi; + ptrdiff_t frag_offs; + int bits0; + int bits1; + unsigned satd; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[OC_FRAME_PREV]]; + ystride=_enc->state.ref_ystride[0]; + frag_buf_offs=_enc->state.frag_buf_offs; + frag_mvs=_enc->state.frag_mvs; + mb_map=(const oc_mb_map_plane *)_enc->state.mb_maps[_mbi]; + _modec->rate=_modec->ssd=0; + for(bi=0;bi<4;bi++){ + fragi=mb_map[0][bi]; + dx=_mv[bi][0]; + dy=_mv[bi][1]; + /*Save the block MVs as the current ones while we're here; we'll replace + them if we don't ultimately choose 4MV mode.*/ + frag_mvs[fragi][0]=(signed char)dx; + frag_mvs[fragi][1]=(signed char)dy; + frag_offs=frag_buf_offs[fragi]; + if(oc_state_get_mv_offsets(&_enc->state,mv_offs,0,dx,dy)>1){ + satd=oc_enc_frag_satd2_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ref+frag_offs+mv_offs[1],ystride,UINT_MAX); + } + else{ + satd=oc_enc_frag_satd_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ystride,UINT_MAX); + } + frag_satd[OC_MB_PHASE[_mbi&3][bi]]=satd; + } + oc_analyze_mb_mode_luma(_enc,_modec,_fr,_qs,frag_satd, + _enc->vp3_compatible?OC_NOSKIP:_skip_ssd,1); + /*Figure out which blocks are being skipped and give them (0,0) MVs.*/ + bits0=0; + bits1=0; + nqis=_enc->state.nqis; + for(bi=0;bi<4;bi++){ + if(_modec->qii[OC_MB_PHASE[_mbi&3][bi]]>=nqis){ + memset(lbmvs+bi,0,sizeof(*lbmvs)); + } + else{ + memcpy(lbmvs+bi,_mv+bi,sizeof(*lbmvs)); + bits0+=OC_MV_BITS[0][_mv[bi][0]+31]+OC_MV_BITS[0][_mv[bi][1]+31]; + bits1+=12; + } + } + (*OC_SET_CHROMA_MVS_TABLE[_enc->state.info.pixel_fmt])(cbmvs, + (const oc_mv *)lbmvs); + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + map_nidxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + /*Note: This assumes ref_ystride[1]==ref_ystride[2].*/ + ystride=_enc->state.ref_ystride[1]; + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_map[pli][bi]; + dx=cbmvs[bi][0]; + dy=cbmvs[bi][1]; + frag_offs=frag_buf_offs[fragi]; + /*TODO: We could save half these calls by re-using the results for the Cb + and Cr planes; is it worth it?*/ + if(oc_state_get_mv_offsets(&_enc->state,mv_offs,pli,dx,dy)>1){ + satd=oc_enc_frag_satd2_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ref+frag_offs+mv_offs[1],ystride,UINT_MAX); + } + else{ + satd=oc_enc_frag_satd_thresh(_enc,src+frag_offs, + ref+frag_offs+mv_offs[0],ystride,UINT_MAX); + } + frag_satd[mapii]=satd; + } + oc_analyze_mb_mode_chroma(_enc,_modec,_fr,_qs,frag_satd,_skip_ssd,1); + _modec->overhead+= + oc_mode_scheme_chooser_cost(&_enc->chooser,OC_MODE_INTER_MV_FOUR) + +OC_MINI(_enc->mv_bits[0]+bits0,_enc->mv_bits[1]+bits1) + -OC_MINI(_enc->mv_bits[0],_enc->mv_bits[1])<lambda); +} + +int oc_enc_analyze_inter(oc_enc_ctx *_enc,int _allow_keyframe,int _recode){ + oc_set_chroma_mvs_func set_chroma_mvs; + oc_enc_pipeline_state pipe; + oc_qii_state intra_luma_qs; + oc_mv last_mv; + oc_mv prior_mv; + ogg_int64_t interbits; + ogg_int64_t intrabits; + const unsigned char *map_idxs; + int nmap_idxs; + unsigned *coded_mbis; + unsigned *uncoded_mbis; + size_t ncoded_mbis; + size_t nuncoded_mbis; + oc_sb_flags *sb_flags; + signed char *mb_modes; + const oc_sb_map *sb_maps; + const oc_mb_map *mb_maps; + oc_mb_enc_info *embs; + oc_fragment *frags; + oc_mv *frag_mvs; + unsigned stripe_sby; + unsigned mcu_nvsbs; + int notstart; + int notdone; + unsigned sbi; + unsigned sbi_end; + int refi; + int pli; + set_chroma_mvs=OC_SET_CHROMA_MVS_TABLE[_enc->state.info.pixel_fmt]; + _enc->state.frame_type=OC_INTER_FRAME; + oc_mode_scheme_chooser_reset(&_enc->chooser); + oc_enc_tokenize_start(_enc); + oc_enc_pipeline_init(_enc,&pipe); + if(_allow_keyframe)oc_qii_state_init(&intra_luma_qs); + _enc->mv_bits[0]=_enc->mv_bits[1]=0; + interbits=intrabits=0; + last_mv[0]=last_mv[1]=prior_mv[0]=prior_mv[1]=0; + /*Choose MVs and MB modes and quantize and code luma. + Must be done in Hilbert order.*/ + map_idxs=OC_MB_MAP_IDXS[_enc->state.info.pixel_fmt]; + nmap_idxs=OC_MB_MAP_NIDXS[_enc->state.info.pixel_fmt]; + coded_mbis=_enc->coded_mbis; + uncoded_mbis=coded_mbis+_enc->state.nmbs; + ncoded_mbis=0; + nuncoded_mbis=0; + _enc->state.ncoded_fragis[0]=0; + _enc->state.ncoded_fragis[1]=0; + _enc->state.ncoded_fragis[2]=0; + sb_flags=_enc->state.sb_flags; + mb_modes=_enc->state.mb_modes; + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + mb_maps=(const oc_mb_map *)_enc->state.mb_maps; + embs=_enc->mb_info; + frags=_enc->state.frags; + frag_mvs=_enc->state.frag_mvs; + notstart=0; + notdone=1; + mcu_nvsbs=_enc->mcu_nvsbs; + for(stripe_sby=0;notdone;stripe_sby+=mcu_nvsbs){ + notdone=oc_enc_pipeline_set_stripe(_enc,&pipe,stripe_sby); + sbi_end=pipe.sbi_end[0]; + for(sbi=pipe.sbi0[0];sbisp_levelsp_levellambda*3; + if(modes[OC_MODE_INTER_MV_FOUR].cost>2][mbi&3][bi]; + frags[fragi].qii=modes[mb_mode].qii[bi]; + } + if(oc_enc_mb_transform_quantize_luma(_enc,&pipe,mbi, + modes[mb_mode].overhead>>OC_BIT_SCALE)>0){ + int orig_mb_mode; + orig_mb_mode=mb_mode; + mb_mode=mb_modes[mbi]; + switch(mb_mode){ + case OC_MODE_INTER_MV:{ + memcpy(prior_mv,last_mv,sizeof(prior_mv)); + /*If we're backing out from 4MV, find the MV we're actually + using.*/ + if(orig_mb_mode==OC_MODE_INTER_MV_FOUR){ + for(bi=0;;bi++){ + fragi=mb_maps[mbi][0][bi]; + if(frags[fragi].coded){ + memcpy(last_mv,frag_mvs[fragi],sizeof(last_mv)); + dx=frag_mvs[fragi][0]; + dy=frag_mvs[fragi][1]; + break; + } + } + mb_mv_bits_0=OC_MV_BITS[0][dx+31]+OC_MV_BITS[0][dy+31]; + } + /*Otherwise we used the original analysis MV.*/ + else{ + memcpy(last_mv, + embs[mbi].analysis_mv[0][OC_FRAME_PREV],sizeof(last_mv)); + } + _enc->mv_bits[0]+=mb_mv_bits_0; + _enc->mv_bits[1]+=12; + }break; + case OC_MODE_INTER_MV_LAST2:{ + oc_mv tmp_mv; + memcpy(tmp_mv,prior_mv,sizeof(tmp_mv)); + memcpy(prior_mv,last_mv,sizeof(prior_mv)); + memcpy(last_mv,tmp_mv,sizeof(last_mv)); + }break; + case OC_MODE_GOLDEN_MV:{ + _enc->mv_bits[0]+=mb_gmv_bits_0; + _enc->mv_bits[1]+=12; + }break; + case OC_MODE_INTER_MV_FOUR:{ + oc_mv lbmvs[4]; + oc_mv cbmvs[4]; + memcpy(prior_mv,last_mv,sizeof(prior_mv)); + for(bi=0;bi<4;bi++){ + fragi=mb_maps[mbi][0][bi]; + if(frags[fragi].coded){ + memcpy(last_mv,frag_mvs[fragi],sizeof(last_mv)); + memcpy(lbmvs[bi],frag_mvs[fragi],sizeof(lbmvs[bi])); + _enc->mv_bits[0]+=OC_MV_BITS[0][frag_mvs[fragi][0]+31] + +OC_MV_BITS[0][frag_mvs[fragi][1]+31]; + _enc->mv_bits[1]+=12; + } + /*Replace the block MVs for not-coded blocks with (0,0).*/ + else memset(lbmvs[bi],0,sizeof(lbmvs[bi])); + } + (*set_chroma_mvs)(cbmvs,(const oc_mv *)lbmvs); + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_maps[mbi][pli][bi]; + frags[fragi].mb_mode=mb_mode; + frags[fragi].qii=modes[OC_MODE_INTER_MV_FOUR].qii[mapii]; + memcpy(frag_mvs[fragi],cbmvs[bi],sizeof(frag_mvs[fragi])); + } + }break; + } + coded_mbis[ncoded_mbis++]=mbi; + oc_mode_scheme_chooser_update(&_enc->chooser,mb_mode); + interbits+=modes[mb_mode].rate+modes[mb_mode].overhead; + } + else{ + *(uncoded_mbis-++nuncoded_mbis)=mbi; + mb_mode=OC_MODE_INTER_NOMV; + dx=dy=0; + } + /*Propagate final MB mode and MVs to the chroma blocks. + This has already been done for 4MV mode, since it requires individual + block motion vectors.*/ + if(mb_mode!=OC_MODE_INTER_MV_FOUR){ + for(mapii=4;mapii>2; + bi=mapi&3; + fragi=mb_maps[mbi][pli][bi]; + frags[fragi].mb_mode=mb_mode; + /*If we switched from 4MV mode to INTER_MV mode, then the qii + values won't have been chosen with the right MV, but it's + probaby not worth re-estimating them.*/ + frags[fragi].qii=modes[mb_mode].qii[mapii]; + frag_mvs[fragi][0]=(signed char)dx; + frag_mvs[fragi][1]=(signed char)dy; + } + } + } + oc_fr_state_flush_sb(pipe.fr+0); + sb_flags[sbi].coded_fully=pipe.fr[0].sb_full; + sb_flags[sbi].coded_partially=pipe.fr[0].sb_partial; + } + oc_enc_pipeline_finish_mcu_plane(_enc,&pipe,0,notstart,notdone); + /*Code chroma planes.*/ + for(pli=1;pli<3;pli++){ + oc_enc_sb_transform_quantize_chroma(_enc,&pipe, + pli,pipe.sbi0[pli],pipe.sbi_end[pli]); + oc_enc_pipeline_finish_mcu_plane(_enc,&pipe,pli,notstart,notdone); + } + notstart=1; + } + /*Finish filling in the reference frame borders.*/ + refi=_enc->state.ref_frame_idx[OC_FRAME_SELF]; + for(pli=0;pli<3;pli++)oc_state_borders_fill_caps(&_enc->state,refi,pli); + /*Finish adding flagging overhead costs to inter bit counts to determine if + we should have coded a key frame instead.*/ + if(_allow_keyframe){ + if(interbits>intrabits)return 1; + /*Technically the chroma plane counts are over-estimations, because they + don't account for continuing runs from the luma planes, but the + inaccuracy is small.*/ + for(pli=0;pli<3;pli++)interbits+=pipe.fr[pli].bits<mv_bits[0],_enc->mv_bits[1])<chooser.scheme_bits[_enc->chooser.scheme_list[0]]<intrabits)return 1; + } + _enc->ncoded_mbis=ncoded_mbis; + /*Compact the coded fragment list.*/ + { + ptrdiff_t ncoded_fragis; + ncoded_fragis=_enc->state.ncoded_fragis[0]; + for(pli=1;pli<3;pli++){ + memmove(_enc->state.coded_fragis+ncoded_fragis, + _enc->state.coded_fragis+_enc->state.fplanes[pli].froffset, + _enc->state.ncoded_fragis[pli]*sizeof(*_enc->state.coded_fragis)); + ncoded_fragis+=_enc->state.ncoded_fragis[pli]; + } + _enc->state.ntotal_coded_fragis=ncoded_fragis; + } + return 0; +} + +#if defined(OC_COLLECT_METRICS) +# include +# include + +/*TODO: It may be helpful (for block-level quantizers especially) to separate + out the contributions from AC and DC into separate tables.*/ + +# define OC_ZWEIGHT (0.25) + +static void oc_mode_metrics_add(oc_mode_metrics *_metrics, + double _w,int _satd,int _rate,double _rmse){ + double rate; + /*Accumulate statistics without the scaling; this lets us change the scale + factor yet still use old data.*/ + rate=ldexp(_rate,-OC_BIT_SCALE); + if(_metrics->fragw>0){ + double dsatd; + double drate; + double drmse; + double w; + dsatd=_satd-_metrics->satd/_metrics->fragw; + drate=rate-_metrics->rate/_metrics->fragw; + drmse=_rmse-_metrics->rmse/_metrics->fragw; + w=_metrics->fragw*_w/(_metrics->fragw+_w); + _metrics->satd2+=dsatd*dsatd*w; + _metrics->satdrate+=dsatd*drate*w; + _metrics->rate2+=drate*drate*w; + _metrics->satdrmse+=dsatd*drmse*w; + _metrics->rmse2+=drmse*drmse*w; + } + _metrics->fragw+=_w; + _metrics->satd+=_satd*_w; + _metrics->rate+=rate*_w; + _metrics->rmse+=_rmse*_w; +} + +static void oc_mode_metrics_merge(oc_mode_metrics *_dst, + const oc_mode_metrics *_src,int _n){ + int i; + /*Find a non-empty set of metrics.*/ + for(i=0;i<_n&&_src[i].fragw<=0;i++); + if(i>=_n){ + memset(_dst,0,sizeof(*_dst)); + return; + } + memcpy(_dst,_src+i,sizeof(*_dst)); + /*And iterate over the remaining non-empty sets of metrics.*/ + for(i++;i<_n;i++)if(_src[i].fragw>0){ + double wa; + double wb; + double dsatd; + double drate; + double drmse; + double w; + wa=_dst->fragw; + wb=_src[i].fragw; + dsatd=_src[i].satd/wb-_dst->satd/wa; + drate=_src[i].rate/wb-_dst->rate/wa; + drmse=_src[i].rmse/wb-_dst->rmse/wa; + w=wa*wb/(wa+wb); + _dst->fragw+=_src[i].fragw; + _dst->satd+=_src[i].satd; + _dst->rate+=_src[i].rate; + _dst->rmse+=_src[i].rmse; + _dst->satd2+=_src[i].satd2+dsatd*dsatd*w; + _dst->satdrate+=_src[i].satdrate+dsatd*drate*w; + _dst->rate2+=_src[i].rate2+drate*drate*w; + _dst->satdrmse+=_src[i].satdrmse+dsatd*drmse*w; + _dst->rmse2+=_src[i].rmse2+drmse*drmse*w; + } +} + +/*Compile collected SATD/rate/RMSE metrics into a form that's immediately + useful for mode decision.*/ +static void oc_enc_mode_metrics_update(oc_enc_ctx *_enc,int _qi){ + int pli; + int qti; + oc_restore_fpu(&_enc->state); + /*Convert raw collected data into cleaned up sample points.*/ + for(pli=0;pli<3;pli++){ + for(qti=0;qti<2;qti++){ + double fragw; + int bin0; + int bin1; + int bin; + fragw=0; + bin0=bin1=0; + for(bin=0;bin=OC_ZWEIGHT){ + fragw-=OC_MODE_METRICS[_qi][pli][qti][bin0++].fragw; + } + /*Merge statistics and fit lines.*/ + oc_mode_metrics_merge(&metrics, + OC_MODE_METRICS[_qi][pli][qti]+bin0,bin1-bin0); + if(metrics.fragw>0&&metrics.satd2>0){ + double a; + double b; + double msatd; + double mrate; + double mrmse; + double rate; + double rmse; + msatd=metrics.satd/metrics.fragw; + mrate=metrics.rate/metrics.fragw; + mrmse=metrics.rmse/metrics.fragw; + /*Compute the points on these lines corresponding to the actual bin + value.*/ + b=metrics.satdrate/metrics.satd2; + a=mrate-b*msatd; + rate=ldexp(a+b*(bin<>1); + return -_extra_bits; +} + +/*Handles the pure zero run tokens.*/ +static ptrdiff_t oc_token_skip_zrl(int _token,int _extra_bits){ + return _extra_bits+1; +} + +/*Handles a normal coefficient value token.*/ +static ptrdiff_t oc_token_skip_val(void){ + return 1; +} + +/*Handles a category 1A zero run/coefficient value combo token.*/ +static ptrdiff_t oc_token_skip_run_cat1a(int _token){ + return _token-OC_DCT_RUN_CAT1A+2; +} + +/*Handles category 1b, 1c, 2a, and 2b zero run/coefficient value combo tokens.*/ +static ptrdiff_t oc_token_skip_run(int _token,int _extra_bits){ + int run_cati; + int ncoeffs_mask; + int ncoeffs_adjust; + run_cati=_token-OC_DCT_RUN_CAT1B; + ncoeffs_mask=OC_BYTE_TABLE32(3,7,0,1,run_cati); + ncoeffs_adjust=OC_BYTE_TABLE32(7,11,2,3,run_cati); + return (_extra_bits&ncoeffs_mask)+ncoeffs_adjust; +} + +/*A jump table for computing the number of coefficients or blocks to skip for + a given token value. + This reduces all the conditional branches, etc., needed to parse these token + values down to one indirect jump.*/ +static const oc_token_skip_func OC_TOKEN_SKIP_TABLE[TH_NDCT_TOKENS]={ + oc_token_skip_eob, + oc_token_skip_eob, + oc_token_skip_eob, + oc_token_skip_eob, + oc_token_skip_eob, + oc_token_skip_eob, + oc_token_skip_eob6, + oc_token_skip_zrl, + oc_token_skip_zrl, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_val, + (oc_token_skip_func)oc_token_skip_run_cat1a, + (oc_token_skip_func)oc_token_skip_run_cat1a, + (oc_token_skip_func)oc_token_skip_run_cat1a, + (oc_token_skip_func)oc_token_skip_run_cat1a, + (oc_token_skip_func)oc_token_skip_run_cat1a, + oc_token_skip_run, + oc_token_skip_run, + oc_token_skip_run, + oc_token_skip_run +}; + +/*Determines the number of blocks or coefficients to be skipped for a given + token value. + _token: The token value to skip. + _extra_bits: The extra bits attached to this token. + Return: A positive value indicates that number of coefficients are to be + skipped in the current block. + Otherwise, the negative of the return value indicates that number of + blocks are to be ended. + 0 will never be returned, so that at least one coefficient in one + block will always be decoded for every token.*/ +static ptrdiff_t oc_dct_token_skip(int _token,int _extra_bits){ + return (*OC_TOKEN_SKIP_TABLE[_token])(_token,_extra_bits); +} + + + +void oc_enc_mode_metrics_collect(oc_enc_ctx *_enc){ + static const unsigned char OC_ZZI_HUFF_OFFSET[64]={ + 0,16,16,16,16,16,32,32, + 32,32,32,32,32,32,32,48, + 48,48,48,48,48,48,48,48, + 48,48,48,48,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64 + }; + const oc_fragment *frags; + const unsigned *frag_satd; + const unsigned *frag_ssd; + const ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t fragii; + double fragw; + int qti; + int qii; + int qi; + int pli; + int zzi; + int token; + int eb; + oc_restore_fpu(&_enc->state); + /*Load any existing mode metrics if we haven't already.*/ + if(!oc_has_mode_metrics){ + FILE *fmetrics; + memset(OC_MODE_METRICS,0,sizeof(OC_MODE_METRICS)); + fmetrics=fopen("modedec.stats","rb"); + if(fmetrics!=NULL){ + fread(OC_MODE_METRICS,sizeof(OC_MODE_METRICS),1,fmetrics); + fclose(fmetrics); + } + for(qi=0;qi<64;qi++)oc_enc_mode_metrics_update(_enc,qi); + oc_has_mode_metrics=1; + } + qti=_enc->state.frame_type; + frags=_enc->state.frags; + frag_satd=_enc->frag_satd; + frag_ssd=_enc->frag_ssd; + coded_fragis=_enc->state.coded_fragis; + ncoded_fragis=fragii=0; + /*Weight the fragments by the inverse frame size; this prevents HD content + from dominating the statistics.*/ + fragw=1.0/_enc->state.nfrags; + for(pli=0;pli<3;pli++){ + ptrdiff_t ti[64]; + int eob_token[64]; + int eob_run[64]; + /*Set up token indices and eob run counts. + We don't bother trying to figure out the real cost of the runs that span + coefficients; instead we use the costs that were available when R-D + token optimization was done.*/ + for(zzi=0;zzi<64;zzi++){ + ti[zzi]=_enc->dct_token_offs[pli][zzi]; + if(ti[zzi]>0){ + token=_enc->dct_tokens[pli][zzi][0]; + eb=_enc->extra_bits[pli][zzi][0]; + eob_token[zzi]=token; + eob_run[zzi]=-oc_dct_token_skip(token,eb); + } + else{ + eob_token[zzi]=OC_NDCT_EOB_TOKEN_MAX; + eob_run[zzi]=0; + } + } + /*Scan the list of coded fragments for this plane.*/ + ncoded_fragis+=_enc->state.ncoded_fragis[pli]; + for(;fragii0){ + /*We've reached the end of the block.*/ + eob_run[zzi]--; + break; + } + huffi=_enc->huff_idxs[qti][zzi>0][pli+1>>1] + +OC_ZZI_HUFF_OFFSET[zzi]; + if(eob_token[zzi]huff_codes[huffi][eob_token[zzi]].nbits + +OC_DCT_TOKEN_EXTRA_BITS[eob_token[zzi]]; + eob_token[zzi]=OC_NDCT_EOB_TOKEN_MAX; + } + token=_enc->dct_tokens[pli][zzi][ti[zzi]]; + eb=_enc->extra_bits[pli][zzi][ti[zzi]]; + ti[zzi]++; + skip=oc_dct_token_skip(token,eb); + if(skip<0){ + eob_token[zzi]=token; + eob_run[zzi]=-skip; + } + else{ + /*A regular DCT value token; accumulate the bits for it.*/ + frag_bits+=_enc->huff_codes[huffi][token].nbits + +OC_DCT_TOKEN_EXTRA_BITS[token]; + zzi+=skip; + } + } + mb_mode=frags[fragi].mb_mode; + qi=_enc->state.qis[frags[fragi].qii]; + satd=frag_satd[fragi]<<(pli+1&2); + bin=OC_MINI(satd>>OC_SAD_SHIFT,OC_SAD_BINS-1); + oc_mode_metrics_add(OC_MODE_METRICS[qi][pli][mb_mode!=OC_MODE_INTRA]+bin, + fragw,satd,frag_bits<state.nqis;qii++){ + oc_enc_mode_metrics_update(_enc,_enc->state.qis[qii]); + } +} + +void oc_enc_mode_metrics_dump(oc_enc_ctx *_enc){ + FILE *fmetrics; + int qi; + /*Generate sample points for complete list of QI values.*/ + for(qi=0;qi<64;qi++)oc_enc_mode_metrics_update(_enc,qi); + fmetrics=fopen("modedec.stats","wb"); + if(fmetrics!=NULL){ + fwrite(OC_MODE_METRICS,sizeof(OC_MODE_METRICS),1,fmetrics); + fclose(fmetrics); + } + fprintf(stdout, + "/*File generated by libtheora with OC_COLLECT_METRICS" + " defined at compile time.*/\n" + "#if !defined(_modedec_H)\n" + "# define _modedec_H (1)\n" + "\n" + "\n" + "\n" + "# if defined(OC_COLLECT_METRICS)\n" + "typedef struct oc_mode_metrics oc_mode_metrics;\n" + "# endif\n" + "typedef struct oc_mode_rd oc_mode_rd;\n" + "\n" + "\n" + "\n" + "/*The number of extra bits of precision at which to store rate" + " metrics.*/\n" + "# define OC_BIT_SCALE (%i)\n" + "/*The number of extra bits of precision at which to store RMSE metrics.\n" + " This must be at least half OC_BIT_SCALE (rounded up).*/\n" + "# define OC_RMSE_SCALE (%i)\n" + "/*The number of bins to partition statistics into.*/\n" + "# define OC_SAD_BINS (%i)\n" + "/*The number of bits of precision to drop" + " from SAD scores to assign them to a\n" + " bin.*/\n" + "# define OC_SAD_SHIFT (%i)\n" + "\n" + "\n" + "\n" + "# if defined(OC_COLLECT_METRICS)\n" + "struct oc_mode_metrics{\n" + " double fragw;\n" + " double satd;\n" + " double rate;\n" + " double rmse;\n" + " double satd2;\n" + " double satdrate;\n" + " double rate2;\n" + " double satdrmse;\n" + " double rmse2;\n" + "};\n" + "\n" + "\n" + "int oc_has_mode_metrics;\n" + "oc_mode_metrics OC_MODE_METRICS[64][3][2][OC_SAD_BINS];\n" + "# endif\n" + "\n" + "\n" + "\n" + "struct oc_mode_rd{\n" + " ogg_int16_t rate;\n" + " ogg_int16_t rmse;\n" + "};\n" + "\n" + "\n" + "# if !defined(OC_COLLECT_METRICS)\n" + "static const\n" + "# endif\n" + "oc_mode_rd OC_MODE_RD[64][3][2][OC_SAD_BINS]={\n", + OC_BIT_SCALE,OC_RMSE_SCALE,OC_SAD_BINS,OC_SAD_SHIFT); + for(qi=0;qi<64;qi++){ + int pli; + fprintf(stdout," {\n"); + for(pli=0;pli<3;pli++){ + int qti; + fprintf(stdout," {\n"); + for(qti=0;qti<2;qti++){ + int bin; + static const char *pl_names[3]={"Y'","Cb","Cr"}; + static const char *qti_names[2]={"INTRA","INTER"}; + fprintf(stdout," /*%s qi=%i %s*/\n", + pl_names[pli],qi,qti_names[qti]); + fprintf(stdout," {\n"); + fprintf(stdout," "); + for(bin=0;bin +#include +#include +#include "apiwrapper.h" + + + +const char *theora_version_string(void){ + return th_version_string(); +} + +ogg_uint32_t theora_version_number(void){ + return th_version_number(); +} + +void theora_info_init(theora_info *_ci){ + memset(_ci,0,sizeof(*_ci)); +} + +void theora_info_clear(theora_info *_ci){ + th_api_wrapper *api; + api=(th_api_wrapper *)_ci->codec_setup; + memset(_ci,0,sizeof(*_ci)); + if(api!=NULL){ + if(api->clear!=NULL)(*api->clear)(api); + _ogg_free(api); + } +} + +void theora_clear(theora_state *_th){ + /*Provide compatibility with mixed encoder and decoder shared lib versions.*/ + if(_th->internal_decode!=NULL){ + (*((oc_state_dispatch_vtable *)_th->internal_decode)->clear)(_th); + } + if(_th->internal_encode!=NULL){ + (*((oc_state_dispatch_vtable *)_th->internal_encode)->clear)(_th); + } + if(_th->i!=NULL)theora_info_clear(_th->i); + memset(_th,0,sizeof(*_th)); +} + +int theora_control(theora_state *_th,int _req,void *_buf,size_t _buf_sz){ + /*Provide compatibility with mixed encoder and decoder shared lib versions.*/ + if(_th->internal_decode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_decode)->control)(_th, + _req,_buf,_buf_sz); + } + else if(_th->internal_encode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_encode)->control)(_th, + _req,_buf,_buf_sz); + } + else return TH_EINVAL; +} + +ogg_int64_t theora_granule_frame(theora_state *_th,ogg_int64_t _gp){ + /*Provide compatibility with mixed encoder and decoder shared lib versions.*/ + if(_th->internal_decode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_decode)->granule_frame)( + _th,_gp); + } + else if(_th->internal_encode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_encode)->granule_frame)( + _th,_gp); + } + else return -1; +} + +double theora_granule_time(theora_state *_th, ogg_int64_t _gp){ + /*Provide compatibility with mixed encoder and decoder shared lib versions.*/ + if(_th->internal_decode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_decode)->granule_time)( + _th,_gp); + } + else if(_th->internal_encode!=NULL){ + return (*((oc_state_dispatch_vtable *)_th->internal_encode)->granule_time)( + _th,_gp); + } + else return -1; +} + +void oc_theora_info2th_info(th_info *_info,const theora_info *_ci){ + _info->version_major=_ci->version_major; + _info->version_minor=_ci->version_minor; + _info->version_subminor=_ci->version_subminor; + _info->frame_width=_ci->width; + _info->frame_height=_ci->height; + _info->pic_width=_ci->frame_width; + _info->pic_height=_ci->frame_height; + _info->pic_x=_ci->offset_x; + _info->pic_y=_ci->offset_y; + _info->fps_numerator=_ci->fps_numerator; + _info->fps_denominator=_ci->fps_denominator; + _info->aspect_numerator=_ci->aspect_numerator; + _info->aspect_denominator=_ci->aspect_denominator; + switch(_ci->colorspace){ + case OC_CS_ITU_REC_470M:_info->colorspace=TH_CS_ITU_REC_470M;break; + case OC_CS_ITU_REC_470BG:_info->colorspace=TH_CS_ITU_REC_470BG;break; + default:_info->colorspace=TH_CS_UNSPECIFIED;break; + } + switch(_ci->pixelformat){ + case OC_PF_420:_info->pixel_fmt=TH_PF_420;break; + case OC_PF_422:_info->pixel_fmt=TH_PF_422;break; + case OC_PF_444:_info->pixel_fmt=TH_PF_444;break; + default:_info->pixel_fmt=TH_PF_RSVD; + } + _info->target_bitrate=_ci->target_bitrate; + _info->quality=_ci->quality; + _info->keyframe_granule_shift=_ci->keyframe_frequency_force>0? + OC_MINI(31,oc_ilog(_ci->keyframe_frequency_force-1)):0; +} + +int theora_packet_isheader(ogg_packet *_op){ + return th_packet_isheader(_op); +} + +int theora_packet_iskeyframe(ogg_packet *_op){ + return th_packet_iskeyframe(_op); +} + +int theora_granule_shift(theora_info *_ci){ + /*This breaks when keyframe_frequency_force is not positive or is larger than + 2**31 (if your int is more than 32 bits), but that's what the original + function does.*/ + return oc_ilog(_ci->keyframe_frequency_force-1); +} + +void theora_comment_init(theora_comment *_tc){ + th_comment_init((th_comment *)_tc); +} + +char *theora_comment_query(theora_comment *_tc,char *_tag,int _count){ + return th_comment_query((th_comment *)_tc,_tag,_count); +} + +int theora_comment_query_count(theora_comment *_tc,char *_tag){ + return th_comment_query_count((th_comment *)_tc,_tag); +} + +void theora_comment_clear(theora_comment *_tc){ + th_comment_clear((th_comment *)_tc); +} + +void theora_comment_add(theora_comment *_tc,char *_comment){ + th_comment_add((th_comment *)_tc,_comment); +} + +void theora_comment_add_tag(theora_comment *_tc, char *_tag, char *_value){ + th_comment_add_tag((th_comment *)_tc,_tag,_value); +} diff --git a/libs/libtheora-1.1/lib/apiwrapper.h b/libs/libtheora-1.1/lib/apiwrapper.h new file mode 100644 index 00000000..588f78e6 --- /dev/null +++ b/libs/libtheora-1.1/lib/apiwrapper.h @@ -0,0 +1,54 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: apiwrapper.h 13596 2007-08-23 20:05:38Z tterribe $ + + ********************************************************************/ + +#if !defined(_apiwrapper_H) +# define _apiwrapper_H (1) +# include +# include +# include "theora/theoradec.h" +# include "theora/theoraenc.h" +# include "internal.h" + +typedef struct th_api_wrapper th_api_wrapper; +typedef struct th_api_info th_api_info; + +/*Provide an entry point for the codec setup to clear itself in case we ever + want to break pieces off into a common base library shared by encoder and + decoder. + In addition, this makes several other pieces of the API wrapper cleaner.*/ +typedef void (*oc_setup_clear_func)(void *_ts); + +/*Generally only one of these pointers will be non-NULL in any given instance. + Technically we do not even really need this struct, since we should be able + to figure out which one from "context", but doing it this way makes sure we + don't flub it up.*/ +struct th_api_wrapper{ + oc_setup_clear_func clear; + th_setup_info *setup; + th_dec_ctx *decode; + th_enc_ctx *encode; +}; + +struct th_api_info{ + th_api_wrapper api; + theora_info info; +}; + + +void oc_theora_info2th_info(th_info *_info,const theora_info *_ci); + +#endif diff --git a/libs/libtheora-1.1/lib/bitpack.c b/libs/libtheora-1.1/lib/bitpack.c new file mode 100644 index 00000000..8195003b --- /dev/null +++ b/libs/libtheora-1.1/lib/bitpack.c @@ -0,0 +1,111 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE OggTheora SOURCE CODE IS (C) COPYRIGHT 1994-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: packing variable sized words into an octet stream + last mod: $Id: bitpack.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include +#include "bitpack.h" + +/*We're 'MSb' endian; if we write a word but read individual bits, + then we'll read the MSb first.*/ + +void oc_pack_readinit(oc_pack_buf *_b,unsigned char *_buf,long _bytes){ + memset(_b,0,sizeof(*_b)); + _b->ptr=_buf; + _b->stop=_buf+_bytes; +} + +static oc_pb_window oc_pack_refill(oc_pack_buf *_b,int _bits){ + const unsigned char *ptr; + const unsigned char *stop; + oc_pb_window window; + int available; + window=_b->window; + available=_b->bits; + ptr=_b->ptr; + stop=_b->stop; + while(available<=OC_PB_WINDOW_SIZE-8&&ptrptr=ptr; + if(_bits>available){ + if(ptr>=stop){ + _b->eof=1; + available=OC_LOTS_OF_BITS; + } + else window|=*ptr>>(available&7); + } + _b->bits=available; + return window; +} + +int oc_pack_look1(oc_pack_buf *_b){ + oc_pb_window window; + int available; + window=_b->window; + available=_b->bits; + if(available<1)_b->window=window=oc_pack_refill(_b,1); + return window>>OC_PB_WINDOW_SIZE-1; +} + +void oc_pack_adv1(oc_pack_buf *_b){ + _b->window<<=1; + _b->bits--; +} + +/*Here we assume that 0<=_bits&&_bits<=32.*/ +long oc_pack_read(oc_pack_buf *_b,int _bits){ + oc_pb_window window; + int available; + long result; + window=_b->window; + available=_b->bits; + if(_bits==0)return 0; + if(available<_bits){ + window=oc_pack_refill(_b,_bits); + available=_b->bits; + } + result=window>>OC_PB_WINDOW_SIZE-_bits; + available-=_bits; + window<<=1; + window<<=_bits-1; + _b->bits=available; + _b->window=window; + return result; +} + +int oc_pack_read1(oc_pack_buf *_b){ + oc_pb_window window; + int available; + int result; + window=_b->window; + available=_b->bits; + if(available<1){ + window=oc_pack_refill(_b,1); + available=_b->bits; + } + result=window>>OC_PB_WINDOW_SIZE-1; + available--; + window<<=1; + _b->bits=available; + _b->window=window; + return result; +} + +long oc_pack_bytes_left(oc_pack_buf *_b){ + if(_b->eof)return -1; + return _b->stop-_b->ptr+(_b->bits>>3); +} diff --git a/libs/libtheora-1.1/lib/bitpack.h b/libs/libtheora-1.1/lib/bitpack.h new file mode 100644 index 00000000..649c6f04 --- /dev/null +++ b/libs/libtheora-1.1/lib/bitpack.h @@ -0,0 +1,60 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE OggTheora SOURCE CODE IS (C) COPYRIGHT 1994-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: packing variable sized words into an octet stream + last mod: $Id: bitwise.c 7675 2004-09-01 00:34:39Z xiphmont $ + + ********************************************************************/ +#if !defined(_bitpack_H) +# define _bitpack_H (1) +# include +# include + + + +typedef size_t oc_pb_window; +typedef struct oc_pack_buf oc_pack_buf; + + + +# define OC_PB_WINDOW_SIZE ((int)sizeof(oc_pb_window)*CHAR_BIT) +/*This is meant to be a large, positive constant that can still be efficiently + loaded as an immediate (on platforms like ARM, for example). + Even relatively modest values like 100 would work fine.*/ +# define OC_LOTS_OF_BITS (0x40000000) + + + +struct oc_pack_buf{ + oc_pb_window window; + const unsigned char *ptr; + const unsigned char *stop; + int bits; + int eof; +}; + +void oc_pack_readinit(oc_pack_buf *_b,unsigned char *_buf,long _bytes); +int oc_pack_look1(oc_pack_buf *_b); +void oc_pack_adv1(oc_pack_buf *_b); +/*Here we assume 0<=_bits&&_bits<=32.*/ +long oc_pack_read(oc_pack_buf *_b,int _bits); +int oc_pack_read1(oc_pack_buf *_b); +/* returns -1 for read beyond EOF, or the number of whole bytes available */ +long oc_pack_bytes_left(oc_pack_buf *_b); + +/*These two functions are implemented locally in huffdec.c*/ +/*Read in bits without advancing the bitptr. + Here we assume 0<=_bits&&_bits<=32.*/ +/*static int oc_pack_look(oc_pack_buf *_b,int _bits);*/ +/*static void oc_pack_adv(oc_pack_buf *_b,int _bits);*/ + +#endif diff --git a/libs/libtheora-1.1/lib/cpu.c b/libs/libtheora-1.1/lib/cpu.c new file mode 100644 index 00000000..f7f8d428 --- /dev/null +++ b/libs/libtheora-1.1/lib/cpu.c @@ -0,0 +1,226 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + CPU capability detection for x86 processors. + Originally written by Rudolf Marek. + + function: + last mod: $Id: cpu.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include "cpu.h" + +#if !defined(OC_X86_ASM) +static ogg_uint32_t oc_cpu_flags_get(void){ + return 0; +} +#else +# if !defined(_MSC_VER) +# if defined(__amd64__)||defined(__x86_64__) +/*On x86-64, gcc seems to be able to figure out how to save %rbx for us when + compiling with -fPIC.*/ +# define cpuid(_op,_eax,_ebx,_ecx,_edx) \ + __asm__ __volatile__( \ + "cpuid\n\t" \ + :[eax]"=a"(_eax),[ebx]"=b"(_ebx),[ecx]"=c"(_ecx),[edx]"=d"(_edx) \ + :"a"(_op) \ + :"cc" \ + ) +# else +/*On x86-32, not so much.*/ +# define cpuid(_op,_eax,_ebx,_ecx,_edx) \ + __asm__ __volatile__( \ + "xchgl %%ebx,%[ebx]\n\t" \ + "cpuid\n\t" \ + "xchgl %%ebx,%[ebx]\n\t" \ + :[eax]"=a"(_eax),[ebx]"=r"(_ebx),[ecx]"=c"(_ecx),[edx]"=d"(_edx) \ + :"a"(_op) \ + :"cc" \ + ) +# endif +# else +/*Why does MSVC need this complicated rigamarole? + At this point I honestly do not care.*/ + +/*Visual C cpuid helper function. + For VS2005 we could as well use the _cpuid builtin, but that wouldn't work + for VS2003 users, so we do it in inline assembler.*/ +static void oc_cpuid_helper(ogg_uint32_t _cpu_info[4],ogg_uint32_t _op){ + _asm{ + mov eax,[_op] + mov esi,_cpu_info + cpuid + mov [esi+0],eax + mov [esi+4],ebx + mov [esi+8],ecx + mov [esi+12],edx + } +} + +# define cpuid(_op,_eax,_ebx,_ecx,_edx) \ + do{ \ + ogg_uint32_t cpu_info[4]; \ + oc_cpuid_helper(cpu_info,_op); \ + (_eax)=cpu_info[0]; \ + (_ebx)=cpu_info[1]; \ + (_ecx)=cpu_info[2]; \ + (_edx)=cpu_info[3]; \ + }while(0) + +static void oc_detect_cpuid_helper(ogg_uint32_t *_eax,ogg_uint32_t *_ebx){ + _asm{ + pushfd + pushfd + pop eax + mov ebx,eax + xor eax,200000h + push eax + popfd + pushfd + pop eax + popfd + mov ecx,_eax + mov [ecx],eax + mov ecx,_ebx + mov [ecx],ebx + } +} +# endif + +static ogg_uint32_t oc_parse_intel_flags(ogg_uint32_t _edx,ogg_uint32_t _ecx){ + ogg_uint32_t flags; + /*If there isn't even MMX, give up.*/ + if(!(_edx&0x00800000))return 0; + flags=OC_CPU_X86_MMX; + if(_edx&0x02000000)flags|=OC_CPU_X86_MMXEXT|OC_CPU_X86_SSE; + if(_edx&0x04000000)flags|=OC_CPU_X86_SSE2; + if(_ecx&0x00000001)flags|=OC_CPU_X86_PNI; + if(_ecx&0x00000100)flags|=OC_CPU_X86_SSSE3; + if(_ecx&0x00080000)flags|=OC_CPU_X86_SSE4_1; + if(_ecx&0x00100000)flags|=OC_CPU_X86_SSE4_2; + return flags; +} + +static ogg_uint32_t oc_parse_amd_flags(ogg_uint32_t _edx,ogg_uint32_t _ecx){ + ogg_uint32_t flags; + /*If there isn't even MMX, give up.*/ + if(!(_edx&0x00800000))return 0; + flags=OC_CPU_X86_MMX; + if(_edx&0x00400000)flags|=OC_CPU_X86_MMXEXT; + if(_edx&0x80000000)flags|=OC_CPU_X86_3DNOW; + if(_edx&0x40000000)flags|=OC_CPU_X86_3DNOWEXT; + if(_ecx&0x00000040)flags|=OC_CPU_X86_SSE4A; + if(_ecx&0x00000800)flags|=OC_CPU_X86_SSE5; + return flags; +} + +static ogg_uint32_t oc_cpu_flags_get(void){ + ogg_uint32_t flags; + ogg_uint32_t eax; + ogg_uint32_t ebx; + ogg_uint32_t ecx; + ogg_uint32_t edx; +# if !defined(__amd64__)&&!defined(__x86_64__) + /*Not all x86-32 chips support cpuid, so we have to check.*/ +# if !defined(_MSC_VER) + __asm__ __volatile__( + "pushfl\n\t" + "pushfl\n\t" + "popl %[a]\n\t" + "movl %[a],%[b]\n\t" + "xorl $0x200000,%[a]\n\t" + "pushl %[a]\n\t" + "popfl\n\t" + "pushfl\n\t" + "popl %[a]\n\t" + "popfl\n\t" + :[a]"=r"(eax),[b]"=r"(ebx) + : + :"cc" + ); +# else + oc_detect_cpuid_helper(&eax,&ebx); +# endif + /*No cpuid.*/ + if(eax==ebx)return 0; +# endif + cpuid(0,eax,ebx,ecx,edx); + /* l e t n I e n i u n e G*/ + if(ecx==0x6C65746E&&edx==0x49656E69&&ebx==0x756E6547|| + /* 6 8 x M T e n i u n e G*/ + ecx==0x3638784D&&edx==0x54656E69&&ebx==0x756E6547){ + /*Intel, Transmeta (tested with Crusoe TM5800):*/ + cpuid(1,eax,ebx,ecx,edx); + flags=oc_parse_intel_flags(edx,ecx); + } + /* D M A c i t n e h t u A*/ + else if(ecx==0x444D4163&&edx==0x69746E65&&ebx==0x68747541|| + /* C S N y b e d o e G*/ + ecx==0x43534e20&&edx==0x79622065&&ebx==0x646f6547){ + /*AMD, Geode:*/ + cpuid(0x80000000,eax,ebx,ecx,edx); + if(eax<0x80000001)flags=0; + else{ + cpuid(0x80000001,eax,ebx,ecx,edx); + flags=oc_parse_amd_flags(edx,ecx); + } + /*Also check for SSE.*/ + cpuid(1,eax,ebx,ecx,edx); + flags|=oc_parse_intel_flags(edx,ecx); + } + /*Technically some VIA chips can be configured in the BIOS to return any + string here the user wants. + There is a special detection method that can be used to identify such + processors, but in my opinion, if the user really wants to change it, they + deserve what they get.*/ + /* s l u a H r u a t n e C*/ + else if(ecx==0x736C7561&&edx==0x48727561&&ebx==0x746E6543){ + /*VIA:*/ + /*I only have documentation for the C7 (Esther) and Isaiah (forthcoming) + chips (thanks to the engineers from Centaur Technology who provided it). + These chips support Intel-like cpuid info. + The C3-2 (Nehemiah) cores appear to, as well.*/ + cpuid(1,eax,ebx,ecx,edx); + flags=oc_parse_intel_flags(edx,ecx); + if(eax>=0x80000001){ + /*The (non-Nehemiah) C3 processors support AMD-like cpuid info. + We need to check this even if the Intel test succeeds to pick up 3DNow! + support on these processors. + Unlike actual AMD processors, we cannot _rely_ on this info, since + some cores (e.g., the 693 stepping of the Nehemiah) claim to support + this function, yet return edx=0, despite the Intel test indicating + MMX support. + Therefore the features detected here are strictly added to those + detected by the Intel test.*/ + /*TODO: How about earlier chips?*/ + cpuid(0x80000001,eax,ebx,ecx,edx); + /*Note: As of the C7, this function returns Intel-style extended feature + flags, not AMD-style. + Currently, this only defines bits 11, 20, and 29 (0x20100800), which + do not conflict with any of the AMD flags we inspect. + For the remaining bits, Intel tells us, "Do not count on their value", + but VIA assures us that they will all be zero (at least on the C7 and + Isaiah chips). + In the (unlikely) event a future processor uses bits 18, 19, 30, or 31 + (0xC0C00000) for something else, we will have to add code to detect + the model to decide when it is appropriate to inspect them.*/ + flags|=oc_parse_amd_flags(edx,ecx); + } + } + else{ + /*Implement me.*/ + flags=0; + } + return flags; +} +#endif diff --git a/libs/libtheora-1.1/lib/cpu.h b/libs/libtheora-1.1/lib/cpu.h new file mode 100644 index 00000000..d450185e --- /dev/null +++ b/libs/libtheora-1.1/lib/cpu.h @@ -0,0 +1,34 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + function: + last mod: $Id: cpu.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_x86_cpu_H) +# define _x86_cpu_H (1) +#include "internal.h" + +#define OC_CPU_X86_MMX (1<<0) +#define OC_CPU_X86_3DNOW (1<<1) +#define OC_CPU_X86_3DNOWEXT (1<<2) +#define OC_CPU_X86_MMXEXT (1<<3) +#define OC_CPU_X86_SSE (1<<4) +#define OC_CPU_X86_SSE2 (1<<5) +#define OC_CPU_X86_PNI (1<<6) +#define OC_CPU_X86_SSSE3 (1<<7) +#define OC_CPU_X86_SSE4_1 (1<<8) +#define OC_CPU_X86_SSE4_2 (1<<9) +#define OC_CPU_X86_SSE4A (1<<10) +#define OC_CPU_X86_SSE5 (1<<11) + +#endif diff --git a/libs/libtheora-1.1/lib/dct.h b/libs/libtheora-1.1/lib/dct.h new file mode 100644 index 00000000..091f5c26 --- /dev/null +++ b/libs/libtheora-1.1/lib/dct.h @@ -0,0 +1,31 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: dct.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*Definitions shared by the forward and inverse DCT transforms.*/ +#if !defined(_dct_H) +# define _dct_H (1) + +/*cos(n*pi/16) (resp. sin(m*pi/16)) scaled by 65536.*/ +#define OC_C1S7 ((ogg_int32_t)64277) +#define OC_C2S6 ((ogg_int32_t)60547) +#define OC_C3S5 ((ogg_int32_t)54491) +#define OC_C4S4 ((ogg_int32_t)46341) +#define OC_C5S3 ((ogg_int32_t)36410) +#define OC_C6S2 ((ogg_int32_t)25080) +#define OC_C7S1 ((ogg_int32_t)12785) + +#endif diff --git a/libs/libtheora-1.1/lib/decapiwrapper.c b/libs/libtheora-1.1/lib/decapiwrapper.c new file mode 100644 index 00000000..d3e666cf --- /dev/null +++ b/libs/libtheora-1.1/lib/decapiwrapper.c @@ -0,0 +1,193 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: decapiwrapper.c 13596 2007-08-23 20:05:38Z tterribe $ + + ********************************************************************/ + +#include +#include +#include +#include "apiwrapper.h" +#include "decint.h" +#include "theora/theoradec.h" + +static void th_dec_api_clear(th_api_wrapper *_api){ + if(_api->setup)th_setup_free(_api->setup); + if(_api->decode)th_decode_free(_api->decode); + memset(_api,0,sizeof(*_api)); +} + +static void theora_decode_clear(theora_state *_td){ + if(_td->i!=NULL)theora_info_clear(_td->i); + memset(_td,0,sizeof(*_td)); +} + +static int theora_decode_control(theora_state *_td,int _req, + void *_buf,size_t _buf_sz){ + return th_decode_ctl(((th_api_wrapper *)_td->i->codec_setup)->decode, + _req,_buf,_buf_sz); +} + +static ogg_int64_t theora_decode_granule_frame(theora_state *_td, + ogg_int64_t _gp){ + return th_granule_frame(((th_api_wrapper *)_td->i->codec_setup)->decode,_gp); +} + +static double theora_decode_granule_time(theora_state *_td,ogg_int64_t _gp){ + return th_granule_time(((th_api_wrapper *)_td->i->codec_setup)->decode,_gp); +} + +static const oc_state_dispatch_vtable OC_DEC_DISPATCH_VTBL={ + (oc_state_clear_func)theora_decode_clear, + (oc_state_control_func)theora_decode_control, + (oc_state_granule_frame_func)theora_decode_granule_frame, + (oc_state_granule_time_func)theora_decode_granule_time, +}; + +static void th_info2theora_info(theora_info *_ci,const th_info *_info){ + _ci->version_major=_info->version_major; + _ci->version_minor=_info->version_minor; + _ci->version_subminor=_info->version_subminor; + _ci->width=_info->frame_width; + _ci->height=_info->frame_height; + _ci->frame_width=_info->pic_width; + _ci->frame_height=_info->pic_height; + _ci->offset_x=_info->pic_x; + _ci->offset_y=_info->pic_y; + _ci->fps_numerator=_info->fps_numerator; + _ci->fps_denominator=_info->fps_denominator; + _ci->aspect_numerator=_info->aspect_numerator; + _ci->aspect_denominator=_info->aspect_denominator; + switch(_info->colorspace){ + case TH_CS_ITU_REC_470M:_ci->colorspace=OC_CS_ITU_REC_470M;break; + case TH_CS_ITU_REC_470BG:_ci->colorspace=OC_CS_ITU_REC_470BG;break; + default:_ci->colorspace=OC_CS_UNSPECIFIED;break; + } + switch(_info->pixel_fmt){ + case TH_PF_420:_ci->pixelformat=OC_PF_420;break; + case TH_PF_422:_ci->pixelformat=OC_PF_422;break; + case TH_PF_444:_ci->pixelformat=OC_PF_444;break; + default:_ci->pixelformat=OC_PF_RSVD; + } + _ci->target_bitrate=_info->target_bitrate; + _ci->quality=_info->quality; + _ci->keyframe_frequency_force=1<<_info->keyframe_granule_shift; +} + +int theora_decode_init(theora_state *_td,theora_info *_ci){ + th_api_info *apiinfo; + th_api_wrapper *api; + th_info info; + api=(th_api_wrapper *)_ci->codec_setup; + /*Allocate our own combined API wrapper/theora_info struct. + We put them both in one malloc'd block so that when the API wrapper is + freed, the info struct goes with it. + This avoids having to figure out whether or not we need to free the info + struct in either theora_info_clear() or theora_clear().*/ + apiinfo=(th_api_info *)_ogg_calloc(1,sizeof(*apiinfo)); + if(apiinfo==NULL)return OC_FAULT; + /*Make our own copy of the info struct, since its lifetime should be + independent of the one we were passed in.*/ + *&apiinfo->info=*_ci; + /*Convert the info struct now instead of saving the the one we decoded with + theora_decode_header(), since the user might have modified values (i.e., + color space, aspect ratio, etc. can be specified from a higher level). + The user also might be doing something "clever" with the header packets if + they are not using an Ogg encapsulation.*/ + oc_theora_info2th_info(&info,_ci); + /*Don't bother to copy the setup info; th_decode_alloc() makes its own copy + of the stuff it needs.*/ + apiinfo->api.decode=th_decode_alloc(&info,api->setup); + if(apiinfo->api.decode==NULL){ + _ogg_free(apiinfo); + return OC_EINVAL; + } + apiinfo->api.clear=(oc_setup_clear_func)th_dec_api_clear; + _td->internal_encode=NULL; + /*Provide entry points for ABI compatibility with old decoder shared libs.*/ + _td->internal_decode=(void *)&OC_DEC_DISPATCH_VTBL; + _td->granulepos=0; + _td->i=&apiinfo->info; + _td->i->codec_setup=&apiinfo->api; + return 0; +} + +int theora_decode_header(theora_info *_ci,theora_comment *_cc,ogg_packet *_op){ + th_api_wrapper *api; + th_info info; + int ret; + api=(th_api_wrapper *)_ci->codec_setup; + /*Allocate an API wrapper struct on demand, since it will not also include a + theora_info struct like the ones that are used in a theora_state struct.*/ + if(api==NULL){ + _ci->codec_setup=_ogg_calloc(1,sizeof(*api)); + if(_ci->codec_setup==NULL)return OC_FAULT; + api=(th_api_wrapper *)_ci->codec_setup; + api->clear=(oc_setup_clear_func)th_dec_api_clear; + } + /*Convert from the theora_info struct instead of saving our own th_info + struct between calls. + The user might be doing something "clever" with the header packets if they + are not using an Ogg encapsulation, and we don't want to break this.*/ + oc_theora_info2th_info(&info,_ci); + /*We rely on the fact that theora_comment and th_comment structures are + actually identical. + Take care not to change this fact unless you change the code here as + well!*/ + ret=th_decode_headerin(&info,(th_comment *)_cc,&api->setup,_op); + /*We also rely on the fact that the error return code values are the same, + and that the implementations of these two functions return the same set of + them. + Note that theora_decode_header() really can return OC_NOTFORMAT, even + though it is not currently documented to do so.*/ + if(ret<0)return ret; + th_info2theora_info(_ci,&info); + return 0; +} + +int theora_decode_packetin(theora_state *_td,ogg_packet *_op){ + th_api_wrapper *api; + ogg_int64_t gp; + int ret; + if(!_td||!_td->i||!_td->i->codec_setup)return OC_FAULT; + api=(th_api_wrapper *)_td->i->codec_setup; + ret=th_decode_packetin(api->decode,_op,&gp); + if(ret<0)return OC_BADPACKET; + _td->granulepos=gp; + return 0; +} + +int theora_decode_YUVout(theora_state *_td,yuv_buffer *_yuv){ + th_api_wrapper *api; + th_dec_ctx *decode; + th_ycbcr_buffer buf; + int ret; + if(!_td||!_td->i||!_td->i->codec_setup)return OC_FAULT; + api=(th_api_wrapper *)_td->i->codec_setup; + decode=(th_dec_ctx *)api->decode; + if(!decode)return OC_FAULT; + ret=th_decode_ycbcr_out(decode,buf); + if(ret>=0){ + _yuv->y_width=buf[0].width; + _yuv->y_height=buf[0].height; + _yuv->y_stride=buf[0].stride; + _yuv->uv_width=buf[1].width; + _yuv->uv_height=buf[1].height; + _yuv->uv_stride=buf[1].stride; + _yuv->y=buf[0].data; + _yuv->u=buf[1].data; + _yuv->v=buf[2].data; + } + return ret; +} diff --git a/libs/libtheora-1.1/lib/decinfo.c b/libs/libtheora-1.1/lib/decinfo.c new file mode 100644 index 00000000..72dfbac2 --- /dev/null +++ b/libs/libtheora-1.1/lib/decinfo.c @@ -0,0 +1,246 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: decinfo.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include +#include "decint.h" + + + +/*Unpacks a series of octets from a given byte array into the pack buffer. + No checking is done to ensure the buffer contains enough data. + _opb: The pack buffer to read the octets from. + _buf: The byte array to store the unpacked bytes in. + _len: The number of octets to unpack.*/ +static void oc_unpack_octets(oc_pack_buf *_opb,char *_buf,size_t _len){ + while(_len-->0){ + long val; + val=oc_pack_read(_opb,8); + *_buf++=(char)val; + } +} + +/*Unpacks a 32-bit integer encoded by octets in little-endian form.*/ +static long oc_unpack_length(oc_pack_buf *_opb){ + long ret[4]; + int i; + for(i=0;i<4;i++)ret[i]=oc_pack_read(_opb,8); + return ret[0]|ret[1]<<8|ret[2]<<16|ret[3]<<24; +} + +static int oc_info_unpack(oc_pack_buf *_opb,th_info *_info){ + long val; + /*Check the codec bitstream version.*/ + val=oc_pack_read(_opb,8); + _info->version_major=(unsigned char)val; + val=oc_pack_read(_opb,8); + _info->version_minor=(unsigned char)val; + val=oc_pack_read(_opb,8); + _info->version_subminor=(unsigned char)val; + /*verify we can parse this bitstream version. + We accept earlier minors and all subminors, by spec*/ + if(_info->version_major>TH_VERSION_MAJOR|| + _info->version_major==TH_VERSION_MAJOR&& + _info->version_minor>TH_VERSION_MINOR){ + return TH_EVERSION; + } + /*Read the encoded frame description.*/ + val=oc_pack_read(_opb,16); + _info->frame_width=(ogg_uint32_t)val<<4; + val=oc_pack_read(_opb,16); + _info->frame_height=(ogg_uint32_t)val<<4; + val=oc_pack_read(_opb,24); + _info->pic_width=(ogg_uint32_t)val; + val=oc_pack_read(_opb,24); + _info->pic_height=(ogg_uint32_t)val; + val=oc_pack_read(_opb,8); + _info->pic_x=(ogg_uint32_t)val; + val=oc_pack_read(_opb,8); + _info->pic_y=(ogg_uint32_t)val; + val=oc_pack_read(_opb,32); + _info->fps_numerator=(ogg_uint32_t)val; + val=oc_pack_read(_opb,32); + _info->fps_denominator=(ogg_uint32_t)val; + if(_info->frame_width==0||_info->frame_height==0|| + _info->pic_width+_info->pic_x>_info->frame_width|| + _info->pic_height+_info->pic_y>_info->frame_height|| + _info->fps_numerator==0||_info->fps_denominator==0){ + return TH_EBADHEADER; + } + /*Note: The sense of pic_y is inverted in what we pass back to the + application compared to how it is stored in the bitstream. + This is because the bitstream uses a right-handed coordinate system, while + applications expect a left-handed one.*/ + _info->pic_y=_info->frame_height-_info->pic_height-_info->pic_y; + val=oc_pack_read(_opb,24); + _info->aspect_numerator=(ogg_uint32_t)val; + val=oc_pack_read(_opb,24); + _info->aspect_denominator=(ogg_uint32_t)val; + val=oc_pack_read(_opb,8); + _info->colorspace=(th_colorspace)val; + val=oc_pack_read(_opb,24); + _info->target_bitrate=(int)val; + val=oc_pack_read(_opb,6); + _info->quality=(int)val; + val=oc_pack_read(_opb,5); + _info->keyframe_granule_shift=(int)val; + val=oc_pack_read(_opb,2); + _info->pixel_fmt=(th_pixel_fmt)val; + if(_info->pixel_fmt==TH_PF_RSVD)return TH_EBADHEADER; + val=oc_pack_read(_opb,3); + if(val!=0||oc_pack_bytes_left(_opb)<0)return TH_EBADHEADER; + return 0; +} + +static int oc_comment_unpack(oc_pack_buf *_opb,th_comment *_tc){ + long len; + int i; + /*Read the vendor string.*/ + len=oc_unpack_length(_opb); + if(len<0||len>oc_pack_bytes_left(_opb))return TH_EBADHEADER; + _tc->vendor=_ogg_malloc((size_t)len+1); + if(_tc->vendor==NULL)return TH_EFAULT; + oc_unpack_octets(_opb,_tc->vendor,len); + _tc->vendor[len]='\0'; + /*Read the user comments.*/ + _tc->comments=(int)oc_unpack_length(_opb); + len=_tc->comments; + if(len<0||len>(LONG_MAX>>2)||len<<2>oc_pack_bytes_left(_opb)){ + _tc->comments=0; + return TH_EBADHEADER; + } + _tc->comment_lengths=(int *)_ogg_malloc( + _tc->comments*sizeof(_tc->comment_lengths[0])); + _tc->user_comments=(char **)_ogg_malloc( + _tc->comments*sizeof(_tc->user_comments[0])); + for(i=0;i<_tc->comments;i++){ + len=oc_unpack_length(_opb); + if(len<0||len>oc_pack_bytes_left(_opb)){ + _tc->comments=i; + return TH_EBADHEADER; + } + _tc->comment_lengths[i]=len; + _tc->user_comments[i]=_ogg_malloc((size_t)len+1); + if(_tc->user_comments[i]==NULL){ + _tc->comments=i; + return TH_EFAULT; + } + oc_unpack_octets(_opb,_tc->user_comments[i],len); + _tc->user_comments[i][len]='\0'; + } + return oc_pack_bytes_left(_opb)<0?TH_EBADHEADER:0; +} + +static int oc_setup_unpack(oc_pack_buf *_opb,th_setup_info *_setup){ + int ret; + /*Read the quantizer tables.*/ + ret=oc_quant_params_unpack(_opb,&_setup->qinfo); + if(ret<0)return ret; + /*Read the Huffman trees.*/ + return oc_huff_trees_unpack(_opb,_setup->huff_tables); +} + +static void oc_setup_clear(th_setup_info *_setup){ + oc_quant_params_clear(&_setup->qinfo); + oc_huff_trees_clear(_setup->huff_tables); +} + +static int oc_dec_headerin(oc_pack_buf *_opb,th_info *_info, + th_comment *_tc,th_setup_info **_setup,ogg_packet *_op){ + char buffer[6]; + long val; + int packtype; + int ret; + val=oc_pack_read(_opb,8); + packtype=(int)val; + /*If we're at a data packet and we have received all three headers, we're + done.*/ + if(!(packtype&0x80)&&_info->frame_width>0&&_tc->vendor!=NULL&&*_setup!=NULL){ + return 0; + } + /*Check the codec string.*/ + oc_unpack_octets(_opb,buffer,6); + if(memcmp(buffer,"theora",6)!=0)return TH_ENOTFORMAT; + switch(packtype){ + /*Codec info header.*/ + case 0x80:{ + /*This should be the first packet, and we should not already be + initialized.*/ + if(!_op->b_o_s||_info->frame_width>0)return TH_EBADHEADER; + ret=oc_info_unpack(_opb,_info); + if(ret<0)th_info_clear(_info); + else ret=3; + }break; + /*Comment header.*/ + case 0x81:{ + if(_tc==NULL)return TH_EFAULT; + /*We shoud have already decoded the info header, and should not yet have + decoded the comment header.*/ + if(_info->frame_width==0||_tc->vendor!=NULL)return TH_EBADHEADER; + ret=oc_comment_unpack(_opb,_tc); + if(ret<0)th_comment_clear(_tc); + else ret=2; + }break; + /*Codec setup header.*/ + case 0x82:{ + oc_setup_info *setup; + if(_tc==NULL||_setup==NULL)return TH_EFAULT; + /*We should have already decoded the info header and the comment header, + and should not yet have decoded the setup header.*/ + if(_info->frame_width==0||_tc->vendor==NULL||*_setup!=NULL){ + return TH_EBADHEADER; + } + setup=(oc_setup_info *)_ogg_calloc(1,sizeof(*setup)); + if(setup==NULL)return TH_EFAULT; + ret=oc_setup_unpack(_opb,setup); + if(ret<0){ + oc_setup_clear(setup); + _ogg_free(setup); + } + else{ + *_setup=setup; + ret=1; + } + }break; + default:{ + /*We don't know what this header is.*/ + return TH_EBADHEADER; + }break; + } + return ret; +} + + +/*Decodes one header packet. + This should be called repeatedly with the packets at the beginning of the + stream until it returns 0.*/ +int th_decode_headerin(th_info *_info,th_comment *_tc, + th_setup_info **_setup,ogg_packet *_op){ + oc_pack_buf opb; + if(_op==NULL)return TH_EBADHEADER; + if(_info==NULL)return TH_EFAULT; + oc_pack_readinit(&opb,_op->packet,_op->bytes); + return oc_dec_headerin(&opb,_info,_tc,_setup,_op); +} + +void th_setup_free(th_setup_info *_setup){ + if(_setup!=NULL){ + oc_setup_clear(_setup); + _ogg_free(_setup); + } +} diff --git a/libs/libtheora-1.1/lib/decint.h b/libs/libtheora-1.1/lib/decint.h new file mode 100644 index 00000000..17de16c1 --- /dev/null +++ b/libs/libtheora-1.1/lib/decint.h @@ -0,0 +1,107 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: decint.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#if !defined(_decint_H) +# define _decint_H (1) +# include "theora/theoradec.h" +# include "internal.h" +# include "bitpack.h" + +typedef struct th_setup_info oc_setup_info; +typedef struct th_dec_ctx oc_dec_ctx; + +# include "huffdec.h" +# include "dequant.h" + +/*Constants for the packet-in state machine specific to the decoder.*/ + +/*Next packet to read: Data packet.*/ +#define OC_PACKET_DATA (0) + + + +struct th_setup_info{ + /*The Huffman codes.*/ + oc_huff_node *huff_tables[TH_NHUFFMAN_TABLES]; + /*The quantization parameters.*/ + th_quant_info qinfo; +}; + + + +struct th_dec_ctx{ + /*Shared encoder/decoder state.*/ + oc_theora_state state; + /*Whether or not packets are ready to be emitted. + This takes on negative values while there are remaining header packets to + be emitted, reaches 0 when the codec is ready for input, and goes to 1 + when a frame has been processed and a data packet is ready.*/ + int packet_state; + /*Buffer in which to assemble packets.*/ + oc_pack_buf opb; + /*Huffman decode trees.*/ + oc_huff_node *huff_tables[TH_NHUFFMAN_TABLES]; + /*The index of the first token in each plane for each coefficient.*/ + ptrdiff_t ti0[3][64]; + /*The number of outstanding EOB runs at the start of each coefficient in each + plane.*/ + ptrdiff_t eob_runs[3][64]; + /*The DCT token lists.*/ + unsigned char *dct_tokens; + /*The extra bits associated with DCT tokens.*/ + unsigned char *extra_bits; + /*The number of dct tokens unpacked so far.*/ + int dct_tokens_count; + /*The out-of-loop post-processing level.*/ + int pp_level; + /*The DC scale used for out-of-loop deblocking.*/ + int pp_dc_scale[64]; + /*The sharpen modifier used for out-of-loop deringing.*/ + int pp_sharp_mod[64]; + /*The DC quantization index of each block.*/ + unsigned char *dc_qis; + /*The variance of each block.*/ + int *variances; + /*The storage for the post-processed frame buffer.*/ + unsigned char *pp_frame_data; + /*Whether or not the post-processsed frame buffer has space for chroma.*/ + int pp_frame_state; + /*The buffer used for the post-processed frame. + Note that this is _not_ guaranteed to have the same strides and offsets as + the reference frame buffers.*/ + th_ycbcr_buffer pp_frame_buf; + /*The striped decode callback function.*/ + th_stripe_callback stripe_cb; +# if defined(HAVE_CAIRO) + /*Output metrics for debugging.*/ + int telemetry; + int telemetry_mbmode; + int telemetry_mv; + int telemetry_qi; + int telemetry_bits; + int telemetry_frame_bytes; + int telemetry_coding_bytes; + int telemetry_mode_bytes; + int telemetry_mv_bytes; + int telemetry_qi_bytes; + int telemetry_dc_bytes; + unsigned char *telemetry_frame_data; +# endif +}; + +#endif diff --git a/libs/libtheora-1.1/lib/decode.c b/libs/libtheora-1.1/lib/decode.c new file mode 100644 index 00000000..41d02202 --- /dev/null +++ b/libs/libtheora-1.1/lib/decode.c @@ -0,0 +1,2943 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: decode.c 16581 2009-09-25 22:56:16Z gmaxwell $ + + ********************************************************************/ + +#include +#include +#include +#include "decint.h" +#if defined(OC_DUMP_IMAGES) +# include +# include "png.h" +#endif +#if defined(HAVE_CAIRO) +# include +#endif + + +/*No post-processing.*/ +#define OC_PP_LEVEL_DISABLED (0) +/*Keep track of DC qi for each block only.*/ +#define OC_PP_LEVEL_TRACKDCQI (1) +/*Deblock the luma plane.*/ +#define OC_PP_LEVEL_DEBLOCKY (2) +/*Dering the luma plane.*/ +#define OC_PP_LEVEL_DERINGY (3) +/*Stronger luma plane deringing.*/ +#define OC_PP_LEVEL_SDERINGY (4) +/*Deblock the chroma planes.*/ +#define OC_PP_LEVEL_DEBLOCKC (5) +/*Dering the chroma planes.*/ +#define OC_PP_LEVEL_DERINGC (6) +/*Stronger chroma plane deringing.*/ +#define OC_PP_LEVEL_SDERINGC (7) +/*Maximum valid post-processing level.*/ +#define OC_PP_LEVEL_MAX (7) + + + +/*The mode alphabets for the various mode coding schemes. + Scheme 0 uses a custom alphabet, which is not stored in this table.*/ +static const unsigned char OC_MODE_ALPHABETS[7][OC_NMODES]={ + /*Last MV dominates */ + { + OC_MODE_INTER_MV_LAST,OC_MODE_INTER_MV_LAST2,OC_MODE_INTER_MV, + OC_MODE_INTER_NOMV,OC_MODE_INTRA,OC_MODE_GOLDEN_NOMV,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + }, + { + OC_MODE_INTER_MV_LAST,OC_MODE_INTER_MV_LAST2,OC_MODE_INTER_NOMV, + OC_MODE_INTER_MV,OC_MODE_INTRA,OC_MODE_GOLDEN_NOMV,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + }, + { + OC_MODE_INTER_MV_LAST,OC_MODE_INTER_MV,OC_MODE_INTER_MV_LAST2, + OC_MODE_INTER_NOMV,OC_MODE_INTRA,OC_MODE_GOLDEN_NOMV,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + }, + { + OC_MODE_INTER_MV_LAST,OC_MODE_INTER_MV,OC_MODE_INTER_NOMV, + OC_MODE_INTER_MV_LAST2,OC_MODE_INTRA,OC_MODE_GOLDEN_NOMV, + OC_MODE_GOLDEN_MV,OC_MODE_INTER_MV_FOUR + }, + /*No MV dominates.*/ + { + OC_MODE_INTER_NOMV,OC_MODE_INTER_MV_LAST,OC_MODE_INTER_MV_LAST2, + OC_MODE_INTER_MV,OC_MODE_INTRA,OC_MODE_GOLDEN_NOMV,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + }, + { + OC_MODE_INTER_NOMV,OC_MODE_GOLDEN_NOMV,OC_MODE_INTER_MV_LAST, + OC_MODE_INTER_MV_LAST2,OC_MODE_INTER_MV,OC_MODE_INTRA,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + }, + /*Default ordering.*/ + { + OC_MODE_INTER_NOMV,OC_MODE_INTRA,OC_MODE_INTER_MV,OC_MODE_INTER_MV_LAST, + OC_MODE_INTER_MV_LAST2,OC_MODE_GOLDEN_NOMV,OC_MODE_GOLDEN_MV, + OC_MODE_INTER_MV_FOUR + } +}; + + +/*The original DCT tokens are extended and reordered during the construction of + the Huffman tables. + The extension means more bits can be read with fewer calls to the bitpacker + during the Huffman decoding process (at the cost of larger Huffman tables), + and fewer tokens require additional extra bits (reducing the average storage + per decoded token). + The revised ordering reveals essential information in the token value + itself; specifically, whether or not there are additional extra bits to read + and the parameter to which those extra bits are applied. + The token is used to fetch a code word from the OC_DCT_CODE_WORD table below. + The extra bits are added into code word at the bit position inferred from the + token value, giving the final code word from which all required parameters + are derived. + The number of EOBs and the leading zero run length can be extracted directly. + The coefficient magnitude is optionally negated before extraction, according + to a 'flip' bit.*/ + +/*The number of additional extra bits that are decoded with each of the + internal DCT tokens.*/ +static const unsigned char OC_INTERNAL_DCT_TOKEN_EXTRA_BITS[15]={ + 12,4,3,3,4,4,5,5,8,8,8,8,3,3,6 +}; + +/*Whether or not an internal token needs any additional extra bits.*/ +#define OC_DCT_TOKEN_NEEDS_MORE(token) \ + (token<(sizeof(OC_INTERNAL_DCT_TOKEN_EXTRA_BITS)/ \ + sizeof(*OC_INTERNAL_DCT_TOKEN_EXTRA_BITS))) + +/*This token (OC_DCT_REPEAT_RUN3_TOKEN) requires more than 8 extra bits.*/ +#define OC_DCT_TOKEN_FAT_EOB (0) + +/*The number of EOBs to use for an end-of-frame token. + Note: We want to set eobs to PTRDIFF_MAX here, but that requires C99, which + is not yet available everywhere; this should be equivalent.*/ +#define OC_DCT_EOB_FINISH (~(size_t)0>>1) + +/*The location of the (6) run legth bits in the code word. + These are placed at index 0 and given 8 bits (even though 6 would suffice) + because it may be faster to extract the lower byte on some platforms.*/ +#define OC_DCT_CW_RLEN_SHIFT (0) +/*The location of the (12) EOB bits in the code word.*/ +#define OC_DCT_CW_EOB_SHIFT (8) +/*The location of the (1) flip bit in the code word. + This must be right under the magnitude bits.*/ +#define OC_DCT_CW_FLIP_BIT (20) +/*The location of the (11) token magnitude bits in the code word. + These must be last, and rely on a sign-extending right shift.*/ +#define OC_DCT_CW_MAG_SHIFT (21) + +/*Pack the given fields into a code word.*/ +#define OC_DCT_CW_PACK(_eobs,_rlen,_mag,_flip) \ + ((_eobs)<state,_info,3); + if(ret<0)return ret; + ret=oc_huff_trees_copy(_dec->huff_tables, + (const oc_huff_node *const *)_setup->huff_tables); + if(ret<0){ + oc_state_clear(&_dec->state); + return ret; + } + /*For each fragment, allocate one byte for every DCT coefficient token, plus + one byte for extra-bits for each token, plus one more byte for the long + EOB run, just in case it's the very last token and has a run length of + one.*/ + _dec->dct_tokens=(unsigned char *)_ogg_malloc((64+64+1)* + _dec->state.nfrags*sizeof(_dec->dct_tokens[0])); + if(_dec->dct_tokens==NULL){ + oc_huff_trees_clear(_dec->huff_tables); + oc_state_clear(&_dec->state); + return TH_EFAULT; + } + for(qi=0;qi<64;qi++)for(pli=0;pli<3;pli++)for(qti=0;qti<2;qti++){ + _dec->state.dequant_tables[qi][pli][qti]= + _dec->state.dequant_table_data[qi][pli][qti]; + } + oc_dequant_tables_init(_dec->state.dequant_tables,_dec->pp_dc_scale, + &_setup->qinfo); + for(qi=0;qi<64;qi++){ + int qsum; + qsum=0; + for(qti=0;qti<2;qti++)for(pli=0;pli<3;pli++){ + qsum+=_dec->state.dequant_tables[qti][pli][qi][12]+ + _dec->state.dequant_tables[qti][pli][qi][17]+ + _dec->state.dequant_tables[qti][pli][qi][18]+ + _dec->state.dequant_tables[qti][pli][qi][24]<<(pli==0); + } + _dec->pp_sharp_mod[qi]=-(qsum>>11); + } + memcpy(_dec->state.loop_filter_limits,_setup->qinfo.loop_filter_limits, + sizeof(_dec->state.loop_filter_limits)); + _dec->pp_level=OC_PP_LEVEL_DISABLED; + _dec->dc_qis=NULL; + _dec->variances=NULL; + _dec->pp_frame_data=NULL; + _dec->stripe_cb.ctx=NULL; + _dec->stripe_cb.stripe_decoded=NULL; +#if defined(HAVE_CAIRO) + _dec->telemetry=0; + _dec->telemetry_bits=0; + _dec->telemetry_qi=0; + _dec->telemetry_mbmode=0; + _dec->telemetry_mv=0; + _dec->telemetry_frame_data=NULL; +#endif + return 0; +} + +static void oc_dec_clear(oc_dec_ctx *_dec){ +#if defined(HAVE_CAIRO) + _ogg_free(_dec->telemetry_frame_data); +#endif + _ogg_free(_dec->pp_frame_data); + _ogg_free(_dec->variances); + _ogg_free(_dec->dc_qis); + _ogg_free(_dec->dct_tokens); + oc_huff_trees_clear(_dec->huff_tables); + oc_state_clear(&_dec->state); +} + + +static int oc_dec_frame_header_unpack(oc_dec_ctx *_dec){ + long val; + /*Check to make sure this is a data packet.*/ + val=oc_pack_read1(&_dec->opb); + if(val!=0)return TH_EBADPACKET; + /*Read in the frame type (I or P).*/ + val=oc_pack_read1(&_dec->opb); + _dec->state.frame_type=(int)val; + /*Read in the qi list.*/ + val=oc_pack_read(&_dec->opb,6); + _dec->state.qis[0]=(unsigned char)val; + val=oc_pack_read1(&_dec->opb); + if(!val)_dec->state.nqis=1; + else{ + val=oc_pack_read(&_dec->opb,6); + _dec->state.qis[1]=(unsigned char)val; + val=oc_pack_read1(&_dec->opb); + if(!val)_dec->state.nqis=2; + else{ + val=oc_pack_read(&_dec->opb,6); + _dec->state.qis[2]=(unsigned char)val; + _dec->state.nqis=3; + } + } + if(_dec->state.frame_type==OC_INTRA_FRAME){ + /*Keyframes have 3 unused configuration bits, holdovers from VP3 days. + Most of the other unused bits in the VP3 headers were eliminated. + I don't know why these remain.*/ + /*I wanted to eliminate wasted bits, but not all config wiggle room + --Monty.*/ + val=oc_pack_read(&_dec->opb,3); + if(val!=0)return TH_EIMPL; + } + return 0; +} + +/*Mark all fragments as coded and in OC_MODE_INTRA. + This also builds up the coded fragment list (in coded order), and clears the + uncoded fragment list. + It does not update the coded macro block list nor the super block flags, as + those are not used when decoding INTRA frames.*/ +static void oc_dec_mark_all_intra(oc_dec_ctx *_dec){ + const oc_sb_map *sb_maps; + const oc_sb_flags *sb_flags; + oc_fragment *frags; + ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t prev_ncoded_fragis; + unsigned nsbs; + unsigned sbi; + int pli; + coded_fragis=_dec->state.coded_fragis; + prev_ncoded_fragis=ncoded_fragis=0; + sb_maps=(const oc_sb_map *)_dec->state.sb_maps; + sb_flags=_dec->state.sb_flags; + frags=_dec->state.frags; + sbi=nsbs=0; + for(pli=0;pli<3;pli++){ + nsbs+=_dec->state.fplanes[pli].nsbs; + for(;sbi=0){ + frags[fragi].coded=1; + frags[fragi].mb_mode=OC_MODE_INTRA; + coded_fragis[ncoded_fragis++]=fragi; + } + } + } + } + _dec->state.ncoded_fragis[pli]=ncoded_fragis-prev_ncoded_fragis; + prev_ncoded_fragis=ncoded_fragis; + } + _dec->state.ntotal_coded_fragis=ncoded_fragis; +} + +/*Decodes the bit flags indicating whether each super block is partially coded + or not. + Return: The number of partially coded super blocks.*/ +static unsigned oc_dec_partial_sb_flags_unpack(oc_dec_ctx *_dec){ + oc_sb_flags *sb_flags; + unsigned nsbs; + unsigned sbi; + unsigned npartial; + unsigned run_count; + long val; + int flag; + val=oc_pack_read1(&_dec->opb); + flag=(int)val; + sb_flags=_dec->state.sb_flags; + nsbs=_dec->state.nsbs; + sbi=npartial=0; + while(sbiopb); + full_run=run_count>=4129; + do{ + sb_flags[sbi].coded_partially=flag; + sb_flags[sbi].coded_fully=0; + npartial+=flag; + sbi++; + } + while(--run_count>0&&sbiopb); + flag=(int)val; + } + else flag=!flag; + } + /*TODO: run_count should be 0 here. + If it's not, we should issue a warning of some kind.*/ + return npartial; +} + +/*Decodes the bit flags for whether or not each non-partially-coded super + block is fully coded or not. + This function should only be called if there is at least one + non-partially-coded super block. + Return: The number of partially coded super blocks.*/ +static void oc_dec_coded_sb_flags_unpack(oc_dec_ctx *_dec){ + oc_sb_flags *sb_flags; + unsigned nsbs; + unsigned sbi; + unsigned run_count; + long val; + int flag; + sb_flags=_dec->state.sb_flags; + nsbs=_dec->state.nsbs; + /*Skip partially coded super blocks.*/ + for(sbi=0;sb_flags[sbi].coded_partially;sbi++); + val=oc_pack_read1(&_dec->opb); + flag=(int)val; + do{ + int full_run; + run_count=oc_sb_run_unpack(&_dec->opb); + full_run=run_count>=4129; + for(;sbiopb); + flag=(int)val; + } + else flag=!flag; + } + while(sbistate.nsbs)oc_dec_coded_sb_flags_unpack(_dec); + if(npartial>0){ + val=oc_pack_read1(&_dec->opb); + flag=!(int)val; + } + else flag=0; + sb_maps=(const oc_sb_map *)_dec->state.sb_maps; + sb_flags=_dec->state.sb_flags; + frags=_dec->state.frags; + sbi=nsbs=run_count=0; + coded_fragis=_dec->state.coded_fragis; + uncoded_fragis=coded_fragis+_dec->state.nfrags; + prev_ncoded_fragis=ncoded_fragis=nuncoded_fragis=0; + for(pli=0;pli<3;pli++){ + nsbs+=_dec->state.fplanes[pli].nsbs; + for(;sbi=0){ + int coded; + if(sb_flags[sbi].coded_fully)coded=1; + else if(!sb_flags[sbi].coded_partially)coded=0; + else{ + if(run_count<=0){ + run_count=oc_block_run_unpack(&_dec->opb); + flag=!flag; + } + run_count--; + coded=flag; + } + if(coded)coded_fragis[ncoded_fragis++]=fragi; + else *(uncoded_fragis-++nuncoded_fragis)=fragi; + frags[fragi].coded=coded; + } + } + } + } + _dec->state.ncoded_fragis[pli]=ncoded_fragis-prev_ncoded_fragis; + prev_ncoded_fragis=ncoded_fragis; + } + _dec->state.ntotal_coded_fragis=ncoded_fragis; + /*TODO: run_count should be 0 here. + If it's not, we should issue a warning of some kind.*/ +} + + + +typedef int (*oc_mode_unpack_func)(oc_pack_buf *_opb); + +static int oc_vlc_mode_unpack(oc_pack_buf *_opb){ + long val; + int i; + for(i=0;i<7;i++){ + val=oc_pack_read1(_opb); + if(!val)break; + } + return i; +} + +static int oc_clc_mode_unpack(oc_pack_buf *_opb){ + long val; + val=oc_pack_read(_opb,3); + return (int)val; +} + +/*Unpacks the list of macro block modes for INTER frames.*/ +static void oc_dec_mb_modes_unpack(oc_dec_ctx *_dec){ + const oc_mb_map *mb_maps; + signed char *mb_modes; + const oc_fragment *frags; + const unsigned char *alphabet; + unsigned char scheme0_alphabet[8]; + oc_mode_unpack_func mode_unpack; + size_t nmbs; + size_t mbi; + long val; + int mode_scheme; + val=oc_pack_read(&_dec->opb,3); + mode_scheme=(int)val; + if(mode_scheme==0){ + int mi; + /*Just in case, initialize the modes to something. + If the bitstream doesn't contain each index exactly once, it's likely + corrupt and the rest of the packet is garbage anyway, but this way we + won't crash, and we'll decode SOMETHING.*/ + /*LOOP VECTORIZES*/ + for(mi=0;miopb,3); + scheme0_alphabet[val]=OC_MODE_ALPHABETS[6][mi]; + } + alphabet=scheme0_alphabet; + } + else alphabet=OC_MODE_ALPHABETS[mode_scheme-1]; + if(mode_scheme==7)mode_unpack=oc_clc_mode_unpack; + else mode_unpack=oc_vlc_mode_unpack; + mb_modes=_dec->state.mb_modes; + mb_maps=(const oc_mb_map *)_dec->state.mb_maps; + nmbs=_dec->state.nmbs; + frags=_dec->state.frags; + for(mbi=0;mbiopb)]; + /*There were none: INTER_NOMV is forced.*/ + else mb_modes[mbi]=OC_MODE_INTER_NOMV; + } + } +} + + + +typedef int (*oc_mv_comp_unpack_func)(oc_pack_buf *_opb); + +static int oc_vlc_mv_comp_unpack(oc_pack_buf *_opb){ + long bits; + int mask; + int mv; + bits=oc_pack_read(_opb,3); + switch(bits){ + case 0:return 0; + case 1:return 1; + case 2:return -1; + case 3: + case 4:{ + mv=(int)(bits-1); + bits=oc_pack_read1(_opb); + }break; + /*case 5: + case 6: + case 7:*/ + default:{ + mv=1<>1); + bits&=1; + }break; + } + mask=-(int)bits; + return mv+mask^mask; +} + +static int oc_clc_mv_comp_unpack(oc_pack_buf *_opb){ + long bits; + int mask; + int mv; + bits=oc_pack_read(_opb,6); + mv=(int)bits>>1; + mask=-((int)bits&1); + return mv+mask^mask; +} + +/*Unpacks the list of motion vectors for INTER frames, and propagtes the macro + block modes and motion vectors to the individual fragments.*/ +static void oc_dec_mv_unpack_and_frag_modes_fill(oc_dec_ctx *_dec){ + const oc_mb_map *mb_maps; + const signed char *mb_modes; + oc_set_chroma_mvs_func set_chroma_mvs; + oc_mv_comp_unpack_func mv_comp_unpack; + oc_fragment *frags; + oc_mv *frag_mvs; + const unsigned char *map_idxs; + int map_nidxs; + oc_mv last_mv[2]; + oc_mv cbmvs[4]; + size_t nmbs; + size_t mbi; + long val; + set_chroma_mvs=OC_SET_CHROMA_MVS_TABLE[_dec->state.info.pixel_fmt]; + val=oc_pack_read1(&_dec->opb); + mv_comp_unpack=val?oc_clc_mv_comp_unpack:oc_vlc_mv_comp_unpack; + map_idxs=OC_MB_MAP_IDXS[_dec->state.info.pixel_fmt]; + map_nidxs=OC_MB_MAP_NIDXS[_dec->state.info.pixel_fmt]; + memset(last_mv,0,sizeof(last_mv)); + frags=_dec->state.frags; + frag_mvs=_dec->state.frag_mvs; + mb_maps=(const oc_mb_map *)_dec->state.mb_maps; + mb_modes=_dec->state.mb_modes; + nmbs=_dec->state.nmbs; + for(mbi=0;mbi>2][mapi&3]; + if(frags[fragi].coded)coded[ncoded++]=mapi; + } + while(++mapiiopb); + lbmvs[bi][1]=(signed char)(*mv_comp_unpack)(&_dec->opb); + memcpy(frag_mvs[fragi],lbmvs[bi],sizeof(lbmvs[bi])); + } + else lbmvs[bi][0]=lbmvs[bi][1]=0; + } + if(codedi>0){ + memcpy(last_mv[1],last_mv[0],sizeof(last_mv[1])); + memcpy(last_mv[0],lbmvs[coded[codedi-1]],sizeof(last_mv[0])); + } + if(codedi>2][bi]; + frags[fragi].mb_mode=mb_mode; + memcpy(frag_mvs[fragi],cbmvs[bi],sizeof(cbmvs[bi])); + } + } + }break; + case OC_MODE_INTER_MV:{ + memcpy(last_mv[1],last_mv[0],sizeof(last_mv[1])); + mbmv[0]=last_mv[0][0]=(signed char)(*mv_comp_unpack)(&_dec->opb); + mbmv[1]=last_mv[0][1]=(signed char)(*mv_comp_unpack)(&_dec->opb); + }break; + case OC_MODE_INTER_MV_LAST:memcpy(mbmv,last_mv[0],sizeof(mbmv));break; + case OC_MODE_INTER_MV_LAST2:{ + memcpy(mbmv,last_mv[1],sizeof(mbmv)); + memcpy(last_mv[1],last_mv[0],sizeof(last_mv[1])); + memcpy(last_mv[0],mbmv,sizeof(last_mv[0])); + }break; + case OC_MODE_GOLDEN_MV:{ + mbmv[0]=(signed char)(*mv_comp_unpack)(&_dec->opb); + mbmv[1]=(signed char)(*mv_comp_unpack)(&_dec->opb); + }break; + default:memset(mbmv,0,sizeof(mbmv));break; + } + /*4MV mode fills in the fragments itself. + For all other modes we can use this common code.*/ + if(mb_mode!=OC_MODE_INTER_MV_FOUR){ + for(codedi=0;codedi>2][mapi&3]; + frags[fragi].mb_mode=mb_mode; + memcpy(frag_mvs[fragi],mbmv,sizeof(mbmv)); + } + } + } + } +} + +static void oc_dec_block_qis_unpack(oc_dec_ctx *_dec){ + oc_fragment *frags; + const ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t fragii; + ptrdiff_t fragi; + ncoded_fragis=_dec->state.ntotal_coded_fragis; + if(ncoded_fragis<=0)return; + frags=_dec->state.frags; + coded_fragis=_dec->state.coded_fragis; + if(_dec->state.nqis==1){ + /*If this frame has only a single qi value, then just use it for all coded + fragments.*/ + for(fragii=0;fragiiopb); + flag=(int)val; + nqi1=0; + fragii=0; + while(fragiiopb); + full_run=run_count>=4129; + do{ + frags[coded_fragis[fragii++]].qii=flag; + nqi1+=flag; + } + while(--run_count>0&&fragiiopb); + flag=(int)val; + } + else flag=!flag; + } + /*TODO: run_count should be 0 here. + If it's not, we should issue a warning of some kind.*/ + /*If we have 3 different qi's for this frame, and there was at least one + fragment with a non-zero qi, make the second pass.*/ + if(_dec->state.nqis==3&&nqi1>0){ + /*Skip qii==0 fragments.*/ + for(fragii=0;frags[coded_fragis[fragii]].qii==0;fragii++); + val=oc_pack_read1(&_dec->opb); + flag=(int)val; + do{ + int full_run; + run_count=oc_sb_run_unpack(&_dec->opb); + full_run=run_count>=4129; + for(;fragiiopb); + flag=(int)val; + } + else flag=!flag; + } + while(fragiidct_tokens; + frags=_dec->state.frags; + coded_fragis=_dec->state.coded_fragis; + ncoded_fragis=fragii=eobs=ti=0; + for(pli=0;pli<3;pli++){ + ptrdiff_t run_counts[64]; + ptrdiff_t eob_count; + ptrdiff_t eobi; + int rli; + ncoded_fragis+=_dec->state.ncoded_fragis[pli]; + memset(run_counts,0,sizeof(run_counts)); + _dec->eob_runs[pli][0]=eobs; + _dec->ti0[pli][0]=ti; + /*Continue any previous EOB run, if there was one.*/ + eobi=eobs; + if(ncoded_fragis-fragii0)frags[coded_fragis[fragii++]].dc=0; + while(fragiiopb, + _dec->huff_tables[_huff_idxs[pli+1>>1]]); + dct_tokens[ti++]=(unsigned char)token; + if(OC_DCT_TOKEN_NEEDS_MORE(token)){ + eb=(int)oc_pack_read(&_dec->opb, + OC_INTERNAL_DCT_TOKEN_EXTRA_BITS[token]); + dct_tokens[ti++]=(unsigned char)eb; + if(token==OC_DCT_TOKEN_FAT_EOB)dct_tokens[ti++]=(unsigned char)(eb>>8); + eb<<=OC_DCT_TOKEN_EB_POS(token); + } + else eb=0; + cw=OC_DCT_CODE_WORD[token]+eb; + eobs=cw>>OC_DCT_CW_EOB_SHIFT&0xFFF; + if(cw==OC_DCT_CW_FINISH)eobs=OC_DCT_EOB_FINISH; + if(eobs){ + eobi=OC_MINI(eobs,ncoded_fragis-fragii); + eob_count+=eobi; + eobs-=eobi; + while(eobi-->0)frags[coded_fragis[fragii++]].dc=0; + } + else{ + int coeff; + skip=(unsigned char)(cw>>OC_DCT_CW_RLEN_SHIFT); + cw^=-(cw&1<>OC_DCT_CW_MAG_SHIFT; + if(skip)coeff=0; + run_counts[skip]++; + frags[coded_fragis[fragii++]].dc=coeff; + } + } + /*Add the total EOB count to the longest run length.*/ + run_counts[63]+=eob_count; + /*And convert the run_counts array to a moment table.*/ + for(rli=63;rli-->0;)run_counts[rli]+=run_counts[rli+1]; + /*Finally, subtract off the number of coefficients that have been + accounted for by runs started in this coefficient.*/ + for(rli=64;rli-->0;)_ntoks_left[pli][rli]-=run_counts[rli]; + } + _dec->dct_tokens_count=ti; + return eobs; +} + +/*Unpacks the AC coefficient tokens. + This can completely discard coefficient values while unpacking, and so is + somewhat simpler than unpacking the DC coefficient tokens. + _huff_idx: The index of the Huffman table to use for each color plane. + _ntoks_left: The number of tokens left to be decoded in each color plane for + each coefficient. + This is updated as EOB tokens and zero run tokens are decoded. + _eobs: The length of any outstanding EOB run from previous + coefficients. + Return: The length of any outstanding EOB run.*/ +static int oc_dec_ac_coeff_unpack(oc_dec_ctx *_dec,int _zzi,int _huff_idxs[2], + ptrdiff_t _ntoks_left[3][64],ptrdiff_t _eobs){ + unsigned char *dct_tokens; + ptrdiff_t ti; + int pli; + dct_tokens=_dec->dct_tokens; + ti=_dec->dct_tokens_count; + for(pli=0;pli<3;pli++){ + ptrdiff_t run_counts[64]; + ptrdiff_t eob_count; + size_t ntoks_left; + size_t ntoks; + int rli; + _dec->eob_runs[pli][_zzi]=_eobs; + _dec->ti0[pli][_zzi]=ti; + ntoks_left=_ntoks_left[pli][_zzi]; + memset(run_counts,0,sizeof(run_counts)); + eob_count=0; + ntoks=0; + while(ntoks+_eobsopb, + _dec->huff_tables[_huff_idxs[pli+1>>1]]); + dct_tokens[ti++]=(unsigned char)token; + if(OC_DCT_TOKEN_NEEDS_MORE(token)){ + eb=(int)oc_pack_read(&_dec->opb, + OC_INTERNAL_DCT_TOKEN_EXTRA_BITS[token]); + dct_tokens[ti++]=(unsigned char)eb; + if(token==OC_DCT_TOKEN_FAT_EOB)dct_tokens[ti++]=(unsigned char)(eb>>8); + eb<<=OC_DCT_TOKEN_EB_POS(token); + } + else eb=0; + cw=OC_DCT_CODE_WORD[token]+eb; + skip=(unsigned char)(cw>>OC_DCT_CW_RLEN_SHIFT); + _eobs=cw>>OC_DCT_CW_EOB_SHIFT&0xFFF; + if(cw==OC_DCT_CW_FINISH)_eobs=OC_DCT_EOB_FINISH; + if(_eobs==0){ + run_counts[skip]++; + ntoks++; + } + } + /*Add the portion of the last EOB run actually used by this coefficient.*/ + eob_count+=ntoks_left-ntoks; + /*And remove it from the remaining EOB count.*/ + _eobs-=ntoks_left-ntoks; + /*Add the total EOB count to the longest run length.*/ + run_counts[63]+=eob_count; + /*And convert the run_counts array to a moment table.*/ + for(rli=63;rli-->0;)run_counts[rli]+=run_counts[rli+1]; + /*Finally, subtract off the number of coefficients that have been + accounted for by runs started in this coefficient.*/ + for(rli=64-_zzi;rli-->0;)_ntoks_left[pli][_zzi+rli]-=run_counts[rli]; + } + _dec->dct_tokens_count=ti; + return _eobs; +} + +/*Tokens describing the DCT coefficients that belong to each fragment are + stored in the bitstream grouped by coefficient, not by fragment. + + This means that we either decode all the tokens in order, building up a + separate coefficient list for each fragment as we go, and then go back and + do the iDCT on each fragment, or we have to create separate lists of tokens + for each coefficient, so that we can pull the next token required off the + head of the appropriate list when decoding a specific fragment. + + The former was VP3's choice, and it meant 2*w*h extra storage for all the + decoded coefficient values. + + We take the second option, which lets us store just one to three bytes per + token (generally far fewer than the number of coefficients, due to EOB + tokens and zero runs), and which requires us to only maintain a counter for + each of the 64 coefficients, instead of a counter for every fragment to + determine where the next token goes. + + We actually use 3 counters per coefficient, one for each color plane, so we + can decode all color planes simultaneously. + This lets color conversion, etc., be done as soon as a full MCU (one or + two super block rows) is decoded, while the image data is still in cache.*/ + +static void oc_dec_residual_tokens_unpack(oc_dec_ctx *_dec){ + static const unsigned char OC_HUFF_LIST_MAX[5]={1,6,15,28,64}; + ptrdiff_t ntoks_left[3][64]; + int huff_idxs[2]; + ptrdiff_t eobs; + long val; + int pli; + int zzi; + int hgi; + for(pli=0;pli<3;pli++)for(zzi=0;zzi<64;zzi++){ + ntoks_left[pli][zzi]=_dec->state.ncoded_fragis[pli]; + } + val=oc_pack_read(&_dec->opb,4); + huff_idxs[0]=(int)val; + val=oc_pack_read(&_dec->opb,4); + huff_idxs[1]=(int)val; + _dec->eob_runs[0][0]=0; + eobs=oc_dec_dc_coeff_unpack(_dec,huff_idxs,ntoks_left); +#if defined(HAVE_CAIRO) + _dec->telemetry_dc_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + val=oc_pack_read(&_dec->opb,4); + huff_idxs[0]=(int)val; + val=oc_pack_read(&_dec->opb,4); + huff_idxs[1]=(int)val; + zzi=1; + for(hgi=1;hgi<5;hgi++){ + huff_idxs[0]+=16; + huff_idxs[1]+=16; + for(;zzipp_level<=OC_PP_LEVEL_DISABLED){ + if(_dec->dc_qis!=NULL){ + _ogg_free(_dec->dc_qis); + _dec->dc_qis=NULL; + _ogg_free(_dec->variances); + _dec->variances=NULL; + _ogg_free(_dec->pp_frame_data); + _dec->pp_frame_data=NULL; + } + return 1; + } + if(_dec->dc_qis==NULL){ + /*If we haven't been tracking DC quantization indices, there's no point in + starting now.*/ + if(_dec->state.frame_type!=OC_INTRA_FRAME)return 1; + _dec->dc_qis=(unsigned char *)_ogg_malloc( + _dec->state.nfrags*sizeof(_dec->dc_qis[0])); + if(_dec->dc_qis==NULL)return 1; + memset(_dec->dc_qis,_dec->state.qis[0],_dec->state.nfrags); + } + else{ + unsigned char *dc_qis; + const ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t fragii; + unsigned char qi0; + /*Update the DC quantization index of each coded block.*/ + dc_qis=_dec->dc_qis; + coded_fragis=_dec->state.coded_fragis; + ncoded_fragis=_dec->state.ncoded_fragis[0]+ + _dec->state.ncoded_fragis[1]+_dec->state.ncoded_fragis[2]; + qi0=(unsigned char)_dec->state.qis[0]; + for(fragii=0;fragiipp_level<=OC_PP_LEVEL_TRACKDCQI){ + if(_dec->variances!=NULL){ + _ogg_free(_dec->variances); + _dec->variances=NULL; + _ogg_free(_dec->pp_frame_data); + _dec->pp_frame_data=NULL; + } + return 1; + } + if(_dec->variances==NULL){ + size_t frame_sz; + size_t c_sz; + int c_w; + int c_h; + frame_sz=_dec->state.info.frame_width*(size_t)_dec->state.info.frame_height; + c_w=_dec->state.info.frame_width>>!(_dec->state.info.pixel_fmt&1); + c_h=_dec->state.info.frame_height>>!(_dec->state.info.pixel_fmt&2); + c_sz=c_w*(size_t)c_h; + /*Allocate space for the chroma planes, even if we're not going to use + them; this simplifies allocation state management, though it may waste + memory on the few systems that don't overcommit pages.*/ + frame_sz+=c_sz<<1; + _dec->pp_frame_data=(unsigned char *)_ogg_malloc( + frame_sz*sizeof(_dec->pp_frame_data[0])); + _dec->variances=(int *)_ogg_malloc( + _dec->state.nfrags*sizeof(_dec->variances[0])); + if(_dec->variances==NULL||_dec->pp_frame_data==NULL){ + _ogg_free(_dec->pp_frame_data); + _dec->pp_frame_data=NULL; + _ogg_free(_dec->variances); + _dec->variances=NULL; + return 1; + } + /*Force an update of the PP buffer pointers.*/ + _dec->pp_frame_state=0; + } + /*Update the PP buffer pointers if necessary.*/ + if(_dec->pp_frame_state!=1+(_dec->pp_level>=OC_PP_LEVEL_DEBLOCKC)){ + if(_dec->pp_levelpp_frame_buf[0].width=_dec->state.info.frame_width; + _dec->pp_frame_buf[0].height=_dec->state.info.frame_height; + _dec->pp_frame_buf[0].stride=-_dec->pp_frame_buf[0].width; + _dec->pp_frame_buf[0].data=_dec->pp_frame_data+ + (1-_dec->pp_frame_buf[0].height)*(ptrdiff_t)_dec->pp_frame_buf[0].stride; + } + else{ + size_t y_sz; + size_t c_sz; + int c_w; + int c_h; + /*Otherwise, set up pointers to all three PP planes.*/ + y_sz=_dec->state.info.frame_width*(size_t)_dec->state.info.frame_height; + c_w=_dec->state.info.frame_width>>!(_dec->state.info.pixel_fmt&1); + c_h=_dec->state.info.frame_height>>!(_dec->state.info.pixel_fmt&2); + c_sz=c_w*(size_t)c_h; + _dec->pp_frame_buf[0].width=_dec->state.info.frame_width; + _dec->pp_frame_buf[0].height=_dec->state.info.frame_height; + _dec->pp_frame_buf[0].stride=_dec->pp_frame_buf[0].width; + _dec->pp_frame_buf[0].data=_dec->pp_frame_data; + _dec->pp_frame_buf[1].width=c_w; + _dec->pp_frame_buf[1].height=c_h; + _dec->pp_frame_buf[1].stride=_dec->pp_frame_buf[1].width; + _dec->pp_frame_buf[1].data=_dec->pp_frame_buf[0].data+y_sz; + _dec->pp_frame_buf[2].width=c_w; + _dec->pp_frame_buf[2].height=c_h; + _dec->pp_frame_buf[2].stride=_dec->pp_frame_buf[2].width; + _dec->pp_frame_buf[2].data=_dec->pp_frame_buf[1].data+c_sz; + oc_ycbcr_buffer_flip(_dec->pp_frame_buf,_dec->pp_frame_buf); + } + _dec->pp_frame_state=1+(_dec->pp_level>=OC_PP_LEVEL_DEBLOCKC); + } + /*If we're not processing chroma, copy the reference frame's chroma planes.*/ + if(_dec->pp_levelpp_frame_buf+1, + _dec->state.ref_frame_bufs[_dec->state.ref_frame_idx[OC_FRAME_SELF]]+1, + sizeof(_dec->pp_frame_buf[1])*2); + } + return 0; +} + + + +typedef struct{ + int bounding_values[256]; + ptrdiff_t ti[3][64]; + ptrdiff_t eob_runs[3][64]; + const ptrdiff_t *coded_fragis[3]; + const ptrdiff_t *uncoded_fragis[3]; + ptrdiff_t ncoded_fragis[3]; + ptrdiff_t nuncoded_fragis[3]; + const ogg_uint16_t *dequant[3][3][2]; + int fragy0[3]; + int fragy_end[3]; + int pred_last[3][3]; + int mcu_nvfrags; + int loop_filter; + int pp_level; +}oc_dec_pipeline_state; + + + +/*Initialize the main decoding pipeline.*/ +static void oc_dec_pipeline_init(oc_dec_ctx *_dec, + oc_dec_pipeline_state *_pipe){ + const ptrdiff_t *coded_fragis; + const ptrdiff_t *uncoded_fragis; + int pli; + int qii; + int qti; + /*If chroma is sub-sampled in the vertical direction, we have to decode two + super block rows of Y' for each super block row of Cb and Cr.*/ + _pipe->mcu_nvfrags=4<state.info.pixel_fmt&2); + /*Initialize the token and extra bits indices for each plane and + coefficient.*/ + memcpy(_pipe->ti,_dec->ti0,sizeof(_pipe->ti)); + /*Also copy over the initial the EOB run counts.*/ + memcpy(_pipe->eob_runs,_dec->eob_runs,sizeof(_pipe->eob_runs)); + /*Set up per-plane pointers to the coded and uncoded fragments lists.*/ + coded_fragis=_dec->state.coded_fragis; + uncoded_fragis=coded_fragis+_dec->state.nfrags; + for(pli=0;pli<3;pli++){ + ptrdiff_t ncoded_fragis; + _pipe->coded_fragis[pli]=coded_fragis; + _pipe->uncoded_fragis[pli]=uncoded_fragis; + ncoded_fragis=_dec->state.ncoded_fragis[pli]; + coded_fragis+=ncoded_fragis; + uncoded_fragis+=ncoded_fragis-_dec->state.fplanes[pli].nfrags; + } + /*Set up condensed quantizer tables.*/ + for(pli=0;pli<3;pli++){ + for(qii=0;qii<_dec->state.nqis;qii++){ + for(qti=0;qti<2;qti++){ + _pipe->dequant[pli][qii][qti]= + _dec->state.dequant_tables[_dec->state.qis[qii]][pli][qti]; + } + } + } + /*Set the previous DC predictor to 0 for all color planes and frame types.*/ + memset(_pipe->pred_last,0,sizeof(_pipe->pred_last)); + /*Initialize the bounding value array for the loop filter.*/ + _pipe->loop_filter=!oc_state_loop_filter_init(&_dec->state, + _pipe->bounding_values); + /*Initialize any buffers needed for post-processing. + We also save the current post-processing level, to guard against the user + changing it from a callback.*/ + if(!oc_dec_postprocess_init(_dec))_pipe->pp_level=_dec->pp_level; + /*If we don't have enough information to post-process, disable it, regardless + of the user-requested level.*/ + else{ + _pipe->pp_level=OC_PP_LEVEL_DISABLED; + memcpy(_dec->pp_frame_buf, + _dec->state.ref_frame_bufs[_dec->state.ref_frame_idx[OC_FRAME_SELF]], + sizeof(_dec->pp_frame_buf[0])*3); + } +} + +/*Undo the DC prediction in a single plane of an MCU (one or two super block + rows). + As a side effect, the number of coded and uncoded fragments in this plane of + the MCU is also computed.*/ +static void oc_dec_dc_unpredict_mcu_plane(oc_dec_ctx *_dec, + oc_dec_pipeline_state *_pipe,int _pli){ + const oc_fragment_plane *fplane; + oc_fragment *frags; + int *pred_last; + ptrdiff_t ncoded_fragis; + ptrdiff_t fragi; + int fragx; + int fragy; + int fragy0; + int fragy_end; + int nhfrags; + /*Compute the first and last fragment row of the current MCU for this + plane.*/ + fplane=_dec->state.fplanes+_pli; + fragy0=_pipe->fragy0[_pli]; + fragy_end=_pipe->fragy_end[_pli]; + nhfrags=fplane->nhfrags; + pred_last=_pipe->pred_last[_pli]; + frags=_dec->state.frags; + ncoded_fragis=0; + fragi=fplane->froffset+fragy0*(ptrdiff_t)nhfrags; + for(fragy=fragy0;fragy=nhfrags)ur_ref=-1; + else{ + ur_ref=u_frags[fragi+1].coded? + OC_FRAME_FOR_MODE(u_frags[fragi+1].mb_mode):-1; + } + if(frags[fragi].coded){ + int pred; + int ref; + ref=OC_FRAME_FOR_MODE(frags[fragi].mb_mode); + /*We break out a separate case based on which of our neighbors use + the same reference frames. + This is somewhat faster than trying to make a generic case which + handles all of them, since it reduces lots of poorly predicted + jumps to one switch statement, and also lets a number of the + multiplications be optimized out by strength reduction.*/ + switch((l_ref==ref)|(ul_ref==ref)<<1| + (u_ref==ref)<<2|(ur_ref==ref)<<3){ + default:pred=pred_last[ref];break; + case 1: + case 3:pred=frags[fragi-1].dc;break; + case 2:pred=u_frags[fragi-1].dc;break; + case 4: + case 6: + case 12:pred=u_frags[fragi].dc;break; + case 5:pred=(frags[fragi-1].dc+u_frags[fragi].dc)/2;break; + case 8:pred=u_frags[fragi+1].dc;break; + case 9: + case 11: + case 13:{ + pred=(75*frags[fragi-1].dc+53*u_frags[fragi+1].dc)/128; + }break; + case 10:pred=(u_frags[fragi-1].dc+u_frags[fragi+1].dc)/2;break; + case 14:{ + pred=(3*(u_frags[fragi-1].dc+u_frags[fragi+1].dc) + +10*u_frags[fragi].dc)/16; + }break; + case 7: + case 15:{ + int p0; + int p1; + int p2; + p0=frags[fragi-1].dc; + p1=u_frags[fragi-1].dc; + p2=u_frags[fragi].dc; + pred=(29*(p0+p2)-26*p1)/32; + if(abs(pred-p2)>128)pred=p2; + else if(abs(pred-p0)>128)pred=p0; + else if(abs(pred-p1)>128)pred=p1; + }break; + } + pred_last[ref]=frags[fragi].dc+=pred; + ncoded_fragis++; + l_ref=ref; + } + else l_ref=-1; + ul_ref=u_ref; + u_ref=ur_ref; + } + } + } + _pipe->ncoded_fragis[_pli]=ncoded_fragis; + /*Also save the number of uncoded fragments so we know how many to copy.*/ + _pipe->nuncoded_fragis[_pli]= + (fragy_end-fragy0)*(ptrdiff_t)nhfrags-ncoded_fragis; +} + +/*Reconstructs all coded fragments in a single MCU (one or two super block + rows). + This requires that each coded fragment have a proper macro block mode and + motion vector (if not in INTRA mode), and have it's DC value decoded, with + the DC prediction process reversed, and the number of coded and uncoded + fragments in this plane of the MCU be counted. + The token lists for each color plane and coefficient should also be filled + in, along with initial token offsets, extra bits offsets, and EOB run + counts.*/ +static void oc_dec_frags_recon_mcu_plane(oc_dec_ctx *_dec, + oc_dec_pipeline_state *_pipe,int _pli){ + unsigned char *dct_tokens; + const unsigned char *dct_fzig_zag; + ogg_uint16_t dc_quant[2]; + const oc_fragment *frags; + const ptrdiff_t *coded_fragis; + ptrdiff_t ncoded_fragis; + ptrdiff_t fragii; + ptrdiff_t *ti; + ptrdiff_t *eob_runs; + int qti; + dct_tokens=_dec->dct_tokens; + dct_fzig_zag=_dec->state.opt_data.dct_fzig_zag; + frags=_dec->state.frags; + coded_fragis=_pipe->coded_fragis[_pli]; + ncoded_fragis=_pipe->ncoded_fragis[_pli]; + ti=_pipe->ti[_pli]; + eob_runs=_pipe->eob_runs[_pli]; + for(qti=0;qti<2;qti++)dc_quant[qti]=_pipe->dequant[_pli][0][qti][0]; + for(fragii=0;fragiidequant[_pli][frags[fragi].qii][qti]; + /*Decode the AC coefficients.*/ + for(zzi=0;zzi<64;){ + int token; + last_zzi=zzi; + if(eob_runs[zzi]){ + eob_runs[zzi]--; + break; + } + else{ + ptrdiff_t eob; + int cw; + int rlen; + int coeff; + int lti; + lti=ti[zzi]; + token=dct_tokens[lti++]; + cw=OC_DCT_CODE_WORD[token]; + /*These parts could be done branchless, but the branches are fairly + predictable and the C code translates into more than a few + instructions, so it's worth it to avoid them.*/ + if(OC_DCT_TOKEN_NEEDS_MORE(token)){ + cw+=dct_tokens[lti++]<>OC_DCT_CW_EOB_SHIFT&0xFFF; + if(token==OC_DCT_TOKEN_FAT_EOB){ + eob+=dct_tokens[lti++]<<8; + if(eob==0)eob=OC_DCT_EOB_FINISH; + } + rlen=(unsigned char)(cw>>OC_DCT_CW_RLEN_SHIFT); + cw^=-(cw&1<>OC_DCT_CW_MAG_SHIFT; + eob_runs[zzi]=eob; + ti[zzi]=lti; + zzi+=rlen; + dct_coeffs[dct_fzig_zag[zzi]]=(ogg_int16_t)(coeff*(int)ac_quant[zzi]); + zzi+=!eob; + } + } + /*TODO: zzi should be exactly 64 here. + If it's not, we should report some kind of warning.*/ + zzi=OC_MINI(zzi,64); + dct_coeffs[0]=(ogg_int16_t)frags[fragi].dc; + /*last_zzi is always initialized. + If your compiler thinks otherwise, it is dumb.*/ + oc_state_frag_recon(&_dec->state,fragi,_pli, + dct_coeffs,last_zzi,dc_quant[qti]); + } + _pipe->coded_fragis[_pli]+=ncoded_fragis; + /*Right now the reconstructed MCU has only the coded blocks in it.*/ + /*TODO: We make the decision here to always copy the uncoded blocks into it + from the reference frame. + We could also copy the coded blocks back over the reference frame, if we + wait for an additional MCU to be decoded, which might be faster if only a + small number of blocks are coded. + However, this introduces more latency, creating a larger cache footprint. + It's unknown which decision is better, but this one results in simpler + code, and the hard case (high bitrate, high resolution) is handled + correctly.*/ + /*Copy the uncoded blocks from the previous reference frame.*/ + _pipe->uncoded_fragis[_pli]-=_pipe->nuncoded_fragis[_pli]; + oc_state_frag_copy_list(&_dec->state,_pipe->uncoded_fragis[_pli], + _pipe->nuncoded_fragis[_pli],OC_FRAME_SELF,OC_FRAME_PREV,_pli); +} + +/*Filter a horizontal block edge.*/ +static void oc_filter_hedge(unsigned char *_dst,int _dst_ystride, + const unsigned char *_src,int _src_ystride,int _qstep,int _flimit, + int *_variance0,int *_variance1){ + unsigned char *rdst; + const unsigned char *rsrc; + unsigned char *cdst; + const unsigned char *csrc; + int r[10]; + int sum0; + int sum1; + int bx; + int by; + rdst=_dst; + rsrc=_src; + for(bx=0;bx<8;bx++){ + cdst=rdst; + csrc=rsrc; + for(by=0;by<10;by++){ + r[by]=*csrc; + csrc+=_src_ystride; + } + sum0=sum1=0; + for(by=0;by<4;by++){ + sum0+=abs(r[by+1]-r[by]); + sum1+=abs(r[by+5]-r[by+6]); + } + *_variance0+=OC_MINI(255,sum0); + *_variance1+=OC_MINI(255,sum1); + if(sum0<_flimit&&sum1<_flimit&&r[5]-r[4]<_qstep&&r[4]-r[5]<_qstep){ + *cdst=(unsigned char)(r[0]*3+r[1]*2+r[2]+r[3]+r[4]+4>>3); + cdst+=_dst_ystride; + *cdst=(unsigned char)(r[0]*2+r[1]+r[2]*2+r[3]+r[4]+r[5]+4>>3); + cdst+=_dst_ystride; + for(by=0;by<4;by++){ + *cdst=(unsigned char)(r[by]+r[by+1]+r[by+2]+r[by+3]*2+ + r[by+4]+r[by+5]+r[by+6]+4>>3); + cdst+=_dst_ystride; + } + *cdst=(unsigned char)(r[4]+r[5]+r[6]+r[7]*2+r[8]+r[9]*2+4>>3); + cdst+=_dst_ystride; + *cdst=(unsigned char)(r[5]+r[6]+r[7]+r[8]*2+r[9]*3+4>>3); + } + else{ + for(by=1;by<=8;by++){ + *cdst=(unsigned char)r[by]; + cdst+=_dst_ystride; + } + } + rdst++; + rsrc++; + } +} + +/*Filter a vertical block edge.*/ +static void oc_filter_vedge(unsigned char *_dst,int _dst_ystride, + int _qstep,int _flimit,int *_variances){ + unsigned char *rdst; + const unsigned char *rsrc; + unsigned char *cdst; + int r[10]; + int sum0; + int sum1; + int bx; + int by; + cdst=_dst; + for(by=0;by<8;by++){ + rsrc=cdst-1; + rdst=cdst; + for(bx=0;bx<10;bx++)r[bx]=*rsrc++; + sum0=sum1=0; + for(bx=0;bx<4;bx++){ + sum0+=abs(r[bx+1]-r[bx]); + sum1+=abs(r[bx+5]-r[bx+6]); + } + _variances[0]+=OC_MINI(255,sum0); + _variances[1]+=OC_MINI(255,sum1); + if(sum0<_flimit&&sum1<_flimit&&r[5]-r[4]<_qstep&&r[4]-r[5]<_qstep){ + *rdst++=(unsigned char)(r[0]*3+r[1]*2+r[2]+r[3]+r[4]+4>>3); + *rdst++=(unsigned char)(r[0]*2+r[1]+r[2]*2+r[3]+r[4]+r[5]+4>>3); + for(bx=0;bx<4;bx++){ + *rdst++=(unsigned char)(r[bx]+r[bx+1]+r[bx+2]+r[bx+3]*2+ + r[bx+4]+r[bx+5]+r[bx+6]+4>>3); + } + *rdst++=(unsigned char)(r[4]+r[5]+r[6]+r[7]*2+r[8]+r[9]*2+4>>3); + *rdst=(unsigned char)(r[5]+r[6]+r[7]+r[8]*2+r[9]*3+4>>3); + } + cdst+=_dst_ystride; + } +} + +static void oc_dec_deblock_frag_rows(oc_dec_ctx *_dec, + th_img_plane *_dst,th_img_plane *_src,int _pli,int _fragy0, + int _fragy_end){ + oc_fragment_plane *fplane; + int *variance; + unsigned char *dc_qi; + unsigned char *dst; + const unsigned char *src; + ptrdiff_t froffset; + int dst_ystride; + int src_ystride; + int nhfrags; + int width; + int notstart; + int notdone; + int flimit; + int qstep; + int y_end; + int y; + int x; + _dst+=_pli; + _src+=_pli; + fplane=_dec->state.fplanes+_pli; + nhfrags=fplane->nhfrags; + froffset=fplane->froffset+_fragy0*(ptrdiff_t)nhfrags; + variance=_dec->variances+froffset; + dc_qi=_dec->dc_qis+froffset; + notstart=_fragy0>0; + notdone=_fragy_endnvfrags; + /*We want to clear an extra row of variances, except at the end.*/ + memset(variance+(nhfrags&-notstart),0, + (_fragy_end+notdone-_fragy0-notstart)*(nhfrags*sizeof(variance[0]))); + /*Except for the first time, we want to point to the middle of the row.*/ + y=(_fragy0<<3)+(notstart<<2); + dst_ystride=_dst->stride; + src_ystride=_src->stride; + dst=_dst->data+y*(ptrdiff_t)dst_ystride; + src=_src->data+y*(ptrdiff_t)src_ystride; + width=_dst->width; + for(;y<4;y++){ + memcpy(dst,src,width*sizeof(dst[0])); + dst+=dst_ystride; + src+=src_ystride; + } + /*We also want to skip the last row in the frame for this loop.*/ + y_end=_fragy_end-!notdone<<3; + for(;ypp_dc_scale[*dc_qi]; + flimit=(qstep*3)>>2; + oc_filter_hedge(dst,dst_ystride,src-src_ystride,src_ystride, + qstep,flimit,variance,variance+nhfrags); + variance++; + dc_qi++; + for(x=8;xpp_dc_scale[*dc_qi]; + flimit=(qstep*3)>>2; + oc_filter_hedge(dst+x,dst_ystride,src+x-src_ystride,src_ystride, + qstep,flimit,variance,variance+nhfrags); + oc_filter_vedge(dst+x-(dst_ystride<<2)-4,dst_ystride, + qstep,flimit,variance-1); + variance++; + dc_qi++; + } + dst+=dst_ystride<<3; + src+=src_ystride<<3; + } + /*And finally, handle the last row in the frame, if it's in the range.*/ + if(!notdone){ + int height; + height=_dst->height; + for(;ypp_dc_scale[*dc_qi++]; + flimit=(qstep*3)>>2; + oc_filter_vedge(dst+x-(dst_ystride<<3)-4,dst_ystride, + qstep,flimit,variance++); + } + } +} + +static void oc_dering_block(unsigned char *_idata,int _ystride,int _b, + int _dc_scale,int _sharp_mod,int _strong){ + static const unsigned char OC_MOD_MAX[2]={24,32}; + static const unsigned char OC_MOD_SHIFT[2]={1,0}; + const unsigned char *psrc; + const unsigned char *src; + const unsigned char *nsrc; + unsigned char *dst; + int vmod[72]; + int hmod[72]; + int mod_hi; + int by; + int bx; + mod_hi=OC_MINI(3*_dc_scale,OC_MOD_MAX[_strong]); + dst=_idata; + src=dst; + psrc=src-(_ystride&-!(_b&4)); + for(by=0;by<9;by++){ + for(bx=0;bx<8;bx++){ + int mod; + mod=32+_dc_scale-(abs(src[bx]-psrc[bx])<>7); + for(bx=1;bx<7;bx++){ + a=128; + b=64; + w=hmod[(bx<<3)+by]; + a-=w; + b+=w*src[bx-1]; + w=vmod[(by<<3)+bx]; + a-=w; + b+=w*psrc[bx]; + w=vmod[(by+1<<3)+bx]; + a-=w; + b+=w*nsrc[bx]; + w=hmod[(bx+1<<3)+by]; + a-=w; + b+=w*src[bx+1]; + dst[bx]=OC_CLAMP255(a*src[bx]+b>>7); + } + a=128; + b=64; + w=hmod[(7<<3)+by]; + a-=w; + b+=w*src[6]; + w=vmod[(by<<3)+7]; + a-=w; + b+=w*psrc[7]; + w=vmod[(by+1<<3)+7]; + a-=w; + b+=w*nsrc[7]; + w=hmod[(8<<3)+by]; + a-=w; + b+=w*src[7+!(_b&2)]; + dst[7]=OC_CLAMP255(a*src[7]+b>>7); + dst+=_ystride; + psrc=src; + src=nsrc; + nsrc+=_ystride&-(!(_b&8)|by<6); + } +} + +#define OC_DERING_THRESH1 (384) +#define OC_DERING_THRESH2 (4*OC_DERING_THRESH1) +#define OC_DERING_THRESH3 (5*OC_DERING_THRESH1) +#define OC_DERING_THRESH4 (10*OC_DERING_THRESH1) + +static void oc_dec_dering_frag_rows(oc_dec_ctx *_dec,th_img_plane *_img, + int _pli,int _fragy0,int _fragy_end){ + th_img_plane *iplane; + oc_fragment_plane *fplane; + oc_fragment *frag; + int *variance; + unsigned char *idata; + ptrdiff_t froffset; + int ystride; + int nhfrags; + int sthresh; + int strong; + int y_end; + int width; + int height; + int y; + int x; + iplane=_img+_pli; + fplane=_dec->state.fplanes+_pli; + nhfrags=fplane->nhfrags; + froffset=fplane->froffset+_fragy0*(ptrdiff_t)nhfrags; + variance=_dec->variances+froffset; + frag=_dec->state.frags+froffset; + strong=_dec->pp_level>=(_pli?OC_PP_LEVEL_SDERINGC:OC_PP_LEVEL_SDERINGY); + sthresh=_pli?OC_DERING_THRESH4:OC_DERING_THRESH3; + y=_fragy0<<3; + ystride=iplane->stride; + idata=iplane->data+y*(ptrdiff_t)ystride; + y_end=_fragy_end<<3; + width=iplane->width; + height=iplane->height; + for(;ystate.qis[frag->qii]; + var=*variance; + b=(x<=0)|(x+8>=width)<<1|(y<=0)<<2|(y+8>=height)<<3; + if(strong&&var>sthresh){ + oc_dering_block(idata+x,ystride,b, + _dec->pp_dc_scale[qi],_dec->pp_sharp_mod[qi],1); + if(_pli||!(b&1)&&*(variance-1)>OC_DERING_THRESH4|| + !(b&2)&&variance[1]>OC_DERING_THRESH4|| + !(b&4)&&*(variance-nhfrags)>OC_DERING_THRESH4|| + !(b&8)&&variance[nhfrags]>OC_DERING_THRESH4){ + oc_dering_block(idata+x,ystride,b, + _dec->pp_dc_scale[qi],_dec->pp_sharp_mod[qi],1); + oc_dering_block(idata+x,ystride,b, + _dec->pp_dc_scale[qi],_dec->pp_sharp_mod[qi],1); + } + } + else if(var>OC_DERING_THRESH2){ + oc_dering_block(idata+x,ystride,b, + _dec->pp_dc_scale[qi],_dec->pp_sharp_mod[qi],1); + } + else if(var>OC_DERING_THRESH1){ + oc_dering_block(idata+x,ystride,b, + _dec->pp_dc_scale[qi],_dec->pp_sharp_mod[qi],0); + } + frag++; + variance++; + } + idata+=ystride<<3; + } +} + + + +th_dec_ctx *th_decode_alloc(const th_info *_info,const th_setup_info *_setup){ + oc_dec_ctx *dec; + if(_info==NULL||_setup==NULL)return NULL; + dec=_ogg_malloc(sizeof(*dec)); + if(dec==NULL||oc_dec_init(dec,_info,_setup)<0){ + _ogg_free(dec); + return NULL; + } + dec->state.curframe_num=0; + return dec; +} + +void th_decode_free(th_dec_ctx *_dec){ + if(_dec!=NULL){ + oc_dec_clear(_dec); + _ogg_free(_dec); + } +} + +int th_decode_ctl(th_dec_ctx *_dec,int _req,void *_buf, + size_t _buf_sz){ + switch(_req){ + case TH_DECCTL_GET_PPLEVEL_MAX:{ + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + (*(int *)_buf)=OC_PP_LEVEL_MAX; + return 0; + }break; + case TH_DECCTL_SET_PPLEVEL:{ + int pp_level; + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + pp_level=*(int *)_buf; + if(pp_level<0||pp_level>OC_PP_LEVEL_MAX)return TH_EINVAL; + _dec->pp_level=pp_level; + return 0; + }break; + case TH_DECCTL_SET_GRANPOS:{ + ogg_int64_t granpos; + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(ogg_int64_t))return TH_EINVAL; + granpos=*(ogg_int64_t *)_buf; + if(granpos<0)return TH_EINVAL; + _dec->state.granpos=granpos; + _dec->state.keyframe_num=(granpos>>_dec->state.info.keyframe_granule_shift) + -_dec->state.granpos_bias; + _dec->state.curframe_num=_dec->state.keyframe_num + +(granpos&(1<<_dec->state.info.keyframe_granule_shift)-1); + return 0; + }break; + case TH_DECCTL_SET_STRIPE_CB:{ + th_stripe_callback *cb; + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(th_stripe_callback))return TH_EINVAL; + cb=(th_stripe_callback *)_buf; + _dec->stripe_cb.ctx=cb->ctx; + _dec->stripe_cb.stripe_decoded=cb->stripe_decoded; + return 0; + }break; +#ifdef HAVE_CAIRO + case TH_DECCTL_SET_TELEMETRY_MBMODE:{ + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + _dec->telemetry=1; + _dec->telemetry_mbmode=*(int *)_buf; + return 0; + }break; + case TH_DECCTL_SET_TELEMETRY_MV:{ + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + _dec->telemetry=1; + _dec->telemetry_mv=*(int *)_buf; + return 0; + }break; + case TH_DECCTL_SET_TELEMETRY_QI:{ + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + _dec->telemetry=1; + _dec->telemetry_qi=*(int *)_buf; + return 0; + }break; + case TH_DECCTL_SET_TELEMETRY_BITS:{ + if(_dec==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + _dec->telemetry=1; + _dec->telemetry_bits=*(int *)_buf; + return 0; + }break; +#endif + default:return TH_EIMPL; + } +} + +/*We're decoding an INTER frame, but have no initialized reference + buffers (i.e., decoding did not start on a key frame). + We initialize them to a solid gray here.*/ +static void oc_dec_init_dummy_frame(th_dec_ctx *_dec){ + th_info *info; + size_t yplane_sz; + size_t cplane_sz; + int yhstride; + int yheight; + int chstride; + int cheight; + _dec->state.ref_frame_idx[OC_FRAME_GOLD]=0; + _dec->state.ref_frame_idx[OC_FRAME_PREV]=0; + _dec->state.ref_frame_idx[OC_FRAME_SELF]=1; + info=&_dec->state.info; + yhstride=info->frame_width+2*OC_UMV_PADDING; + yheight=info->frame_height+2*OC_UMV_PADDING; + chstride=yhstride>>!(info->pixel_fmt&1); + cheight=yheight>>!(info->pixel_fmt&2); + yplane_sz=yhstride*(size_t)yheight; + cplane_sz=chstride*(size_t)cheight; + memset(_dec->state.ref_frame_data[0],0x80,yplane_sz+2*cplane_sz); +} + +int th_decode_packetin(th_dec_ctx *_dec,const ogg_packet *_op, + ogg_int64_t *_granpos){ + int ret; + if(_dec==NULL||_op==NULL)return TH_EFAULT; + /*A completely empty packet indicates a dropped frame and is treated exactly + like an inter frame with no coded blocks. + Only proceed if we have a non-empty packet.*/ + if(_op->bytes!=0){ + oc_dec_pipeline_state pipe; + th_ycbcr_buffer stripe_buf; + int stripe_fragy; + int refi; + int pli; + int notstart; + int notdone; + oc_pack_readinit(&_dec->opb,_op->packet,_op->bytes); +#if defined(HAVE_CAIRO) + _dec->telemetry_frame_bytes=_op->bytes; +#endif + ret=oc_dec_frame_header_unpack(_dec); + if(ret<0)return ret; + /*Select a free buffer to use for the reconstructed version of this + frame.*/ + if(_dec->state.frame_type!=OC_INTRA_FRAME&& + (_dec->state.ref_frame_idx[OC_FRAME_GOLD]<0|| + _dec->state.ref_frame_idx[OC_FRAME_PREV]<0)){ + /*No reference frames yet!*/ + oc_dec_init_dummy_frame(_dec); + refi=_dec->state.ref_frame_idx[OC_FRAME_SELF]; + } + else{ + for(refi=0;refi==_dec->state.ref_frame_idx[OC_FRAME_GOLD]|| + refi==_dec->state.ref_frame_idx[OC_FRAME_PREV];refi++); + _dec->state.ref_frame_idx[OC_FRAME_SELF]=refi; + } + if(_dec->state.frame_type==OC_INTRA_FRAME){ + oc_dec_mark_all_intra(_dec); + _dec->state.keyframe_num=_dec->state.curframe_num; +#if defined(HAVE_CAIRO) + _dec->telemetry_coding_bytes= + _dec->telemetry_mode_bytes= + _dec->telemetry_mv_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + } + else{ + oc_dec_coded_flags_unpack(_dec); +#if defined(HAVE_CAIRO) + _dec->telemetry_coding_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + oc_dec_mb_modes_unpack(_dec); +#if defined(HAVE_CAIRO) + _dec->telemetry_mode_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + oc_dec_mv_unpack_and_frag_modes_fill(_dec); +#if defined(HAVE_CAIRO) + _dec->telemetry_mv_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + } + oc_dec_block_qis_unpack(_dec); +#if defined(HAVE_CAIRO) + _dec->telemetry_qi_bytes=oc_pack_bytes_left(&_dec->opb); +#endif + oc_dec_residual_tokens_unpack(_dec); + /*Update granule position. + This must be done before the striped decode callbacks so that the + application knows what to do with the frame data.*/ + _dec->state.granpos=(_dec->state.keyframe_num+_dec->state.granpos_bias<< + _dec->state.info.keyframe_granule_shift) + +(_dec->state.curframe_num-_dec->state.keyframe_num); + _dec->state.curframe_num++; + if(_granpos!=NULL)*_granpos=_dec->state.granpos; + /*All of the rest of the operations -- DC prediction reversal, + reconstructing coded fragments, copying uncoded fragments, loop + filtering, extending borders, and out-of-loop post-processing -- should + be pipelined. + I.e., DC prediction reversal, reconstruction, and uncoded fragment + copying are done for one or two super block rows, then loop filtering is + run as far as it can, then bordering copying, then post-processing. + For 4:2:0 video a Minimum Codable Unit or MCU contains two luma super + block rows, and one chroma. + Otherwise, an MCU consists of one super block row from each plane. + Inside each MCU, we perform all of the steps on one color plane before + moving on to the next. + After reconstruction, the additional filtering stages introduce a delay + since they need some pixels from the next fragment row. + Thus the actual number of decoded rows available is slightly smaller for + the first MCU, and slightly larger for the last. + + This entire process allows us to operate on the data while it is still in + cache, resulting in big performance improvements. + An application callback allows further application processing (blitting + to video memory, color conversion, etc.) to also use the data while it's + in cache.*/ + oc_dec_pipeline_init(_dec,&pipe); + oc_ycbcr_buffer_flip(stripe_buf,_dec->pp_frame_buf); + notstart=0; + notdone=1; + for(stripe_fragy=0;notdone;stripe_fragy+=pipe.mcu_nvfrags){ + int avail_fragy0; + int avail_fragy_end; + avail_fragy0=avail_fragy_end=_dec->state.fplanes[0].nvfrags; + notdone=stripe_fragy+pipe.mcu_nvfragsstate.fplanes+pli; + /*Compute the first and last fragment row of the current MCU for this + plane.*/ + frag_shift=pli!=0&&!(_dec->state.info.pixel_fmt&2); + pipe.fragy0[pli]=stripe_fragy>>frag_shift; + pipe.fragy_end[pli]=OC_MINI(fplane->nvfrags, + pipe.fragy0[pli]+(pipe.mcu_nvfrags>>frag_shift)); + oc_dec_dc_unpredict_mcu_plane(_dec,&pipe,pli); + oc_dec_frags_recon_mcu_plane(_dec,&pipe,pli); + sdelay=edelay=0; + if(pipe.loop_filter){ + sdelay+=notstart; + edelay+=notdone; + oc_state_loop_filter_frag_rows(&_dec->state,pipe.bounding_values, + refi,pli,pipe.fragy0[pli]-sdelay,pipe.fragy_end[pli]-edelay); + } + /*To fill the borders, we have an additional two pixel delay, since a + fragment in the next row could filter its top edge, using two pixels + from a fragment in this row. + But there's no reason to delay a full fragment between the two.*/ + oc_state_borders_fill_rows(&_dec->state,refi,pli, + (pipe.fragy0[pli]-sdelay<<3)-(sdelay<<1), + (pipe.fragy_end[pli]-edelay<<3)-(edelay<<1)); + /*Out-of-loop post-processing.*/ + pp_offset=3*(pli!=0); + if(pipe.pp_level>=OC_PP_LEVEL_DEBLOCKY+pp_offset){ + /*Perform de-blocking in one plane.*/ + sdelay+=notstart; + edelay+=notdone; + oc_dec_deblock_frag_rows(_dec,_dec->pp_frame_buf, + _dec->state.ref_frame_bufs[refi],pli, + pipe.fragy0[pli]-sdelay,pipe.fragy_end[pli]-edelay); + if(pipe.pp_level>=OC_PP_LEVEL_DERINGY+pp_offset){ + /*Perform de-ringing in one plane.*/ + sdelay+=notstart; + edelay+=notdone; + oc_dec_dering_frag_rows(_dec,_dec->pp_frame_buf,pli, + pipe.fragy0[pli]-sdelay,pipe.fragy_end[pli]-edelay); + } + } + /*If no post-processing is done, we still need to delay a row for the + loop filter, thanks to the strange filtering order VP3 chose.*/ + else if(pipe.loop_filter){ + sdelay+=notstart; + edelay+=notdone; + } + /*Compute the intersection of the available rows in all planes. + If chroma is sub-sampled, the effect of each of its delays is + doubled, but luma might have more post-processing filters enabled + than chroma, so we don't know up front which one is the limiting + factor.*/ + avail_fragy0=OC_MINI(avail_fragy0,pipe.fragy0[pli]-sdelay<stripe_cb.stripe_decoded!=NULL){ + /*The callback might want to use the FPU, so let's make sure they can. + We violate all kinds of ABI restrictions by not doing this until + now, but none of them actually matter since we don't use floating + point ourselves.*/ + oc_restore_fpu(&_dec->state); + /*Make the callback, ensuring we flip the sense of the "start" and + "end" of the available region upside down.*/ + (*_dec->stripe_cb.stripe_decoded)(_dec->stripe_cb.ctx,stripe_buf, + _dec->state.fplanes[0].nvfrags-avail_fragy_end, + _dec->state.fplanes[0].nvfrags-avail_fragy0); + } + notstart=1; + } + /*Finish filling in the reference frame borders.*/ + for(pli=0;pli<3;pli++)oc_state_borders_fill_caps(&_dec->state,refi,pli); + /*Update the reference frame indices.*/ + if(_dec->state.frame_type==OC_INTRA_FRAME){ + /*The new frame becomes both the previous and gold reference frames.*/ + _dec->state.ref_frame_idx[OC_FRAME_GOLD]= + _dec->state.ref_frame_idx[OC_FRAME_PREV]= + _dec->state.ref_frame_idx[OC_FRAME_SELF]; + } + else{ + /*Otherwise, just replace the previous reference frame.*/ + _dec->state.ref_frame_idx[OC_FRAME_PREV]= + _dec->state.ref_frame_idx[OC_FRAME_SELF]; + } + /*Restore the FPU before dump_frame, since that _does_ use the FPU (for PNG + gamma values, if nothing else).*/ + oc_restore_fpu(&_dec->state); +#if defined(OC_DUMP_IMAGES) + /*Don't dump images for dropped frames.*/ + oc_state_dump_frame(&_dec->state,OC_FRAME_SELF,"dec"); +#endif + return 0; + } + else{ + if(_dec->state.ref_frame_idx[OC_FRAME_GOLD]<0|| + _dec->state.ref_frame_idx[OC_FRAME_PREV]<0){ + int refi; + /*No reference frames yet!*/ + oc_dec_init_dummy_frame(_dec); + refi=_dec->state.ref_frame_idx[OC_FRAME_PREV]; + _dec->state.ref_frame_idx[OC_FRAME_SELF]=refi; + memcpy(_dec->pp_frame_buf,_dec->state.ref_frame_bufs[refi], + sizeof(_dec->pp_frame_buf[0])*3); + } + /*Just update the granule position and return.*/ + _dec->state.granpos=(_dec->state.keyframe_num+_dec->state.granpos_bias<< + _dec->state.info.keyframe_granule_shift) + +(_dec->state.curframe_num-_dec->state.keyframe_num); + _dec->state.curframe_num++; + if(_granpos!=NULL)*_granpos=_dec->state.granpos; + return TH_DUPFRAME; + } +} + +int th_decode_ycbcr_out(th_dec_ctx *_dec,th_ycbcr_buffer _ycbcr){ + if(_dec==NULL||_ycbcr==NULL)return TH_EFAULT; + oc_ycbcr_buffer_flip(_ycbcr,_dec->pp_frame_buf); +#if defined(HAVE_CAIRO) + /*If telemetry ioctls are active, we need to draw to the output buffer. + Stuff the plane into cairo.*/ + if(_dec->telemetry){ + cairo_surface_t *cs; + unsigned char *data; + unsigned char *y_row; + unsigned char *u_row; + unsigned char *v_row; + unsigned char *rgb_row; + int cstride; + int w; + int h; + int x; + int y; + int hdec; + int vdec; + w=_ycbcr[0].width; + h=_ycbcr[0].height; + hdec=!(_dec->state.info.pixel_fmt&1); + vdec=!(_dec->state.info.pixel_fmt&2); + /*Lazy data buffer init. + We could try to re-use the post-processing buffer, which would save + memory, but complicate the allocation logic there. + I don't think anyone cares about memory usage when using telemetry; it is + not meant for embedded devices.*/ + if(_dec->telemetry_frame_data==NULL){ + _dec->telemetry_frame_data=_ogg_malloc( + (w*h+2*(w>>hdec)*(h>>vdec))*sizeof(*_dec->telemetry_frame_data)); + if(_dec->telemetry_frame_data==NULL)return 0; + } + cs=cairo_image_surface_create(CAIRO_FORMAT_RGB24,w,h); + /*Sadly, no YUV support in Cairo (yet); convert into the RGB buffer.*/ + data=cairo_image_surface_get_data(cs); + if(data==NULL){ + cairo_surface_destroy(cs); + return 0; + } + cstride=cairo_image_surface_get_stride(cs); + y_row=_ycbcr[0].data; + u_row=_ycbcr[1].data; + v_row=_ycbcr[2].data; + rgb_row=data; + for(y=0;y>hdec]-363703744)/1635200; + g=(3827562*y_row[x]-1287801*u_row[x>>hdec] + -2672387*v_row[x>>hdec]+447306710)/3287200; + b=(952000*y_row[x]+1649289*u_row[x>>hdec]-225932192)/817600; + rgb_row[4*x+0]=OC_CLAMP255(b); + rgb_row[4*x+1]=OC_CLAMP255(g); + rgb_row[4*x+2]=OC_CLAMP255(r); + } + y_row+=_ycbcr[0].stride; + u_row+=_ycbcr[1].stride&-((y&1)|!vdec); + v_row+=_ycbcr[2].stride&-((y&1)|!vdec); + rgb_row+=cstride; + } + /*Draw coded identifier for each macroblock (stored in Hilbert order).*/ + { + cairo_t *c; + const oc_fragment *frags; + oc_mv *frag_mvs; + const signed char *mb_modes; + oc_mb_map *mb_maps; + size_t nmbs; + size_t mbi; + int row2; + int col2; + int qim[3]={0,0,0}; + if(_dec->state.nqis==2){ + int bqi; + bqi=_dec->state.qis[0]; + if(_dec->state.qis[1]>bqi)qim[1]=1; + if(_dec->state.qis[1]state.nqis==3){ + int bqi; + int cqi; + int dqi; + bqi=_dec->state.qis[0]; + cqi=_dec->state.qis[1]; + dqi=_dec->state.qis[2]; + if(cqi>bqi&&dqi>bqi){ + if(dqi>cqi){ + qim[1]=1; + qim[2]=2; + } + else{ + qim[1]=2; + qim[2]=1; + } + } + else if(cqistate.frags; + frag_mvs=_dec->state.frag_mvs; + mb_modes=_dec->state.mb_modes; + mb_maps=_dec->state.mb_maps; + nmbs=_dec->state.nmbs; + row2=0; + col2=0; + for(mbi=0;mbi>1)&1))*16-16; + x=(col2>>1)*16; + cairo_set_line_width(c,1.); + /*Keyframe (all intra) red box.*/ + if(_dec->state.frame_type==OC_INTRA_FRAME){ + if(_dec->telemetry_mbmode&0x02){ + cairo_set_source_rgba(c,1.,0,0,.5); + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,1.,0,0,.25); + cairo_fill(c); + } + } + else{ + const signed char *frag_mv; + ptrdiff_t fragi; + for(bi=0;bi<4;bi++){ + fragi=mb_maps[mbi][0][bi]; + if(fragi>=0&&frags[fragi].coded){ + frag_mv=frag_mvs[fragi]; + break; + } + } + if(bi<4){ + switch(mb_modes[mbi]){ + case OC_MODE_INTRA:{ + if(_dec->telemetry_mbmode&0x02){ + cairo_set_source_rgba(c,1.,0,0,.5); + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,1.,0,0,.25); + cairo_fill(c); + } + }break; + case OC_MODE_INTER_NOMV:{ + if(_dec->telemetry_mbmode&0x01){ + cairo_set_source_rgba(c,0,0,1.,.5); + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,0,0,1.,.25); + cairo_fill(c); + } + }break; + case OC_MODE_INTER_MV:{ + if(_dec->telemetry_mbmode&0x04){ + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_set_source_rgba(c,0,1.,0,.5); + cairo_stroke(c); + } + if(_dec->telemetry_mv&0x04){ + cairo_move_to(c,x+8+frag_mv[0],y+8-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+8+frag_mv[0]*.66,y+8-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+8+frag_mv[0]*.33,y+8-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+8,y+8); + cairo_stroke(c); + } + }break; + case OC_MODE_INTER_MV_LAST:{ + if(_dec->telemetry_mbmode&0x08){ + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_set_source_rgba(c,0,1.,0,.5); + cairo_move_to(c,x+13.5,y+2.5); + cairo_line_to(c,x+2.5,y+8); + cairo_line_to(c,x+13.5,y+13.5); + cairo_stroke(c); + } + if(_dec->telemetry_mv&0x08){ + cairo_move_to(c,x+8+frag_mv[0],y+8-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+8+frag_mv[0]*.66,y+8-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+8+frag_mv[0]*.33,y+8-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+8,y+8); + cairo_stroke(c); + } + }break; + case OC_MODE_INTER_MV_LAST2:{ + if(_dec->telemetry_mbmode&0x10){ + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_set_source_rgba(c,0,1.,0,.5); + cairo_move_to(c,x+8,y+2.5); + cairo_line_to(c,x+2.5,y+8); + cairo_line_to(c,x+8,y+13.5); + cairo_move_to(c,x+13.5,y+2.5); + cairo_line_to(c,x+8,y+8); + cairo_line_to(c,x+13.5,y+13.5); + cairo_stroke(c); + } + if(_dec->telemetry_mv&0x10){ + cairo_move_to(c,x+8+frag_mv[0],y+8-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+8+frag_mv[0]*.66,y+8-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+8+frag_mv[0]*.33,y+8-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+8,y+8); + cairo_stroke(c); + } + }break; + case OC_MODE_GOLDEN_NOMV:{ + if(_dec->telemetry_mbmode&0x20){ + cairo_set_source_rgba(c,1.,1.,0,.5); + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,1.,1.,0,.25); + cairo_fill(c); + } + }break; + case OC_MODE_GOLDEN_MV:{ + if(_dec->telemetry_mbmode&0x40){ + cairo_rectangle(c,x+2.5,y+2.5,11,11); + cairo_set_source_rgba(c,1.,1.,0,.5); + cairo_stroke(c); + } + if(_dec->telemetry_mv&0x40){ + cairo_move_to(c,x+8+frag_mv[0],y+8-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+8+frag_mv[0]*.66,y+8-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+8+frag_mv[0]*.33,y+8-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+8,y+8); + cairo_stroke(c); + } + }break; + case OC_MODE_INTER_MV_FOUR:{ + if(_dec->telemetry_mbmode&0x80){ + cairo_rectangle(c,x+2.5,y+2.5,4,4); + cairo_rectangle(c,x+9.5,y+2.5,4,4); + cairo_rectangle(c,x+2.5,y+9.5,4,4); + cairo_rectangle(c,x+9.5,y+9.5,4,4); + cairo_set_source_rgba(c,0,1.,0,.5); + cairo_stroke(c); + } + /*4mv is odd, coded in raster order.*/ + fragi=mb_maps[mbi][0][0]; + if(frags[fragi].coded&&_dec->telemetry_mv&0x80){ + frag_mv=frag_mvs[fragi]; + cairo_move_to(c,x+4+frag_mv[0],y+12-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+4+frag_mv[0]*.66,y+12-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+4+frag_mv[0]*.33,y+12-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+4,y+12); + cairo_stroke(c); + } + fragi=mb_maps[mbi][0][1]; + if(frags[fragi].coded&&_dec->telemetry_mv&0x80){ + frag_mv=frag_mvs[fragi]; + cairo_move_to(c,x+12+frag_mv[0],y+12-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+12+frag_mv[0]*.66,y+12-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+12+frag_mv[0]*.33,y+12-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+12,y+12); + cairo_stroke(c); + } + fragi=mb_maps[mbi][0][2]; + if(frags[fragi].coded&&_dec->telemetry_mv&0x80){ + frag_mv=frag_mvs[fragi]; + cairo_move_to(c,x+4+frag_mv[0],y+4-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+4+frag_mv[0]*.66,y+4-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+4+frag_mv[0]*.33,y+4-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+4,y+4); + cairo_stroke(c); + } + fragi=mb_maps[mbi][0][3]; + if(frags[fragi].coded&&_dec->telemetry_mv&0x80){ + frag_mv=frag_mvs[fragi]; + cairo_move_to(c,x+12+frag_mv[0],y+4-frag_mv[1]); + cairo_set_source_rgba(c,1.,1.,1.,.9); + cairo_set_line_width(c,3.); + cairo_line_to(c,x+12+frag_mv[0]*.66,y+4-frag_mv[1]*.66); + cairo_stroke_preserve(c); + cairo_set_line_width(c,2.); + cairo_line_to(c,x+12+frag_mv[0]*.33,y+4-frag_mv[1]*.33); + cairo_stroke_preserve(c); + cairo_set_line_width(c,1.); + cairo_line_to(c,x+12,y+4); + cairo_stroke(c); + } + }break; + } + } + } + /*qii illustration.*/ + if(_dec->telemetry_qi&0x2){ + cairo_set_line_cap(c,CAIRO_LINE_CAP_SQUARE); + for(bi=0;bi<4;bi++){ + ptrdiff_t fragi; + int qiv; + int xp; + int yp; + xp=x+(bi&1)*8; + yp=y+8-(bi&2)*4; + fragi=mb_maps[mbi][0][bi]; + if(fragi>=0&&frags[fragi].coded){ + qiv=qim[frags[fragi].qii]; + cairo_set_line_width(c,3.); + cairo_set_source_rgba(c,0.,0.,0.,.5); + switch(qiv){ + /*Double plus:*/ + case 2:{ + if((bi&1)^((bi&2)>>1)){ + cairo_move_to(c,xp+2.5,yp+1.5); + cairo_line_to(c,xp+2.5,yp+3.5); + cairo_move_to(c,xp+1.5,yp+2.5); + cairo_line_to(c,xp+3.5,yp+2.5); + cairo_move_to(c,xp+5.5,yp+4.5); + cairo_line_to(c,xp+5.5,yp+6.5); + cairo_move_to(c,xp+4.5,yp+5.5); + cairo_line_to(c,xp+6.5,yp+5.5); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,0.,1.,1.,1.); + } + else{ + cairo_move_to(c,xp+5.5,yp+1.5); + cairo_line_to(c,xp+5.5,yp+3.5); + cairo_move_to(c,xp+4.5,yp+2.5); + cairo_line_to(c,xp+6.5,yp+2.5); + cairo_move_to(c,xp+2.5,yp+4.5); + cairo_line_to(c,xp+2.5,yp+6.5); + cairo_move_to(c,xp+1.5,yp+5.5); + cairo_line_to(c,xp+3.5,yp+5.5); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,0.,1.,1.,1.); + } + }break; + /*Double minus:*/ + case -2:{ + cairo_move_to(c,xp+2.5,yp+2.5); + cairo_line_to(c,xp+5.5,yp+2.5); + cairo_move_to(c,xp+2.5,yp+5.5); + cairo_line_to(c,xp+5.5,yp+5.5); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,1.,1.,1.,1.); + }break; + /*Plus:*/ + case 1:{ + if(bi&2==0)yp-=2; + if(bi&1==0)xp-=2; + cairo_move_to(c,xp+4.5,yp+2.5); + cairo_line_to(c,xp+4.5,yp+6.5); + cairo_move_to(c,xp+2.5,yp+4.5); + cairo_line_to(c,xp+6.5,yp+4.5); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,.1,1.,.3,1.); + break; + } + /*Fall through.*/ + /*Minus:*/ + case -1:{ + cairo_move_to(c,xp+2.5,yp+4.5); + cairo_line_to(c,xp+6.5,yp+4.5); + cairo_stroke_preserve(c); + cairo_set_source_rgba(c,1.,.3,.1,1.); + }break; + default:continue; + } + cairo_set_line_width(c,1.); + cairo_stroke(c); + } + } + } + col2++; + if((col2>>1)>=_dec->state.nhmbs){ + col2=0; + row2+=2; + } + } + /*Bit usage indicator[s]:*/ + if(_dec->telemetry_bits){ + int widths[6]; + int fpsn; + int fpsd; + int mult; + int fullw; + int padw; + int i; + fpsn=_dec->state.info.fps_numerator; + fpsd=_dec->state.info.fps_denominator; + mult=(_dec->telemetry_bits>=0xFF?1:_dec->telemetry_bits); + fullw=250.f*h*fpsd*mult/fpsn; + padw=w-24; + /*Header and coded block bits.*/ + if(_dec->telemetry_frame_bytes<0|| + _dec->telemetry_frame_bytes==OC_LOTS_OF_BITS){ + _dec->telemetry_frame_bytes=0; + } + if(_dec->telemetry_coding_bytes<0|| + _dec->telemetry_coding_bytes>_dec->telemetry_frame_bytes){ + _dec->telemetry_coding_bytes=0; + } + if(_dec->telemetry_mode_bytes<0|| + _dec->telemetry_mode_bytes>_dec->telemetry_frame_bytes){ + _dec->telemetry_mode_bytes=0; + } + if(_dec->telemetry_mv_bytes<0|| + _dec->telemetry_mv_bytes>_dec->telemetry_frame_bytes){ + _dec->telemetry_mv_bytes=0; + } + if(_dec->telemetry_qi_bytes<0|| + _dec->telemetry_qi_bytes>_dec->telemetry_frame_bytes){ + _dec->telemetry_qi_bytes=0; + } + if(_dec->telemetry_dc_bytes<0|| + _dec->telemetry_dc_bytes>_dec->telemetry_frame_bytes){ + _dec->telemetry_dc_bytes=0; + } + widths[0]=padw*(_dec->telemetry_frame_bytes-_dec->telemetry_coding_bytes)/fullw; + widths[1]=padw*(_dec->telemetry_coding_bytes-_dec->telemetry_mode_bytes)/fullw; + widths[2]=padw*(_dec->telemetry_mode_bytes-_dec->telemetry_mv_bytes)/fullw; + widths[3]=padw*(_dec->telemetry_mv_bytes-_dec->telemetry_qi_bytes)/fullw; + widths[4]=padw*(_dec->telemetry_qi_bytes-_dec->telemetry_dc_bytes)/fullw; + widths[5]=padw*(_dec->telemetry_dc_bytes)/fullw; + for(i=0;i<6;i++)if(widths[i]>w)widths[i]=w; + cairo_set_source_rgba(c,.0,.0,.0,.6); + cairo_rectangle(c,10,h-33,widths[0]+1,5); + cairo_rectangle(c,10,h-29,widths[1]+1,5); + cairo_rectangle(c,10,h-25,widths[2]+1,5); + cairo_rectangle(c,10,h-21,widths[3]+1,5); + cairo_rectangle(c,10,h-17,widths[4]+1,5); + cairo_rectangle(c,10,h-13,widths[5]+1,5); + cairo_fill(c); + cairo_set_source_rgb(c,1,0,0); + cairo_rectangle(c,10.5,h-32.5,widths[0],4); + cairo_fill(c); + cairo_set_source_rgb(c,0,1,0); + cairo_rectangle(c,10.5,h-28.5,widths[1],4); + cairo_fill(c); + cairo_set_source_rgb(c,0,0,1); + cairo_rectangle(c,10.5,h-24.5,widths[2],4); + cairo_fill(c); + cairo_set_source_rgb(c,.6,.4,.0); + cairo_rectangle(c,10.5,h-20.5,widths[3],4); + cairo_fill(c); + cairo_set_source_rgb(c,.3,.3,.3); + cairo_rectangle(c,10.5,h-16.5,widths[4],4); + cairo_fill(c); + cairo_set_source_rgb(c,.5,.5,.8); + cairo_rectangle(c,10.5,h-12.5,widths[5],4); + cairo_fill(c); + } + /*Master qi indicator[s]:*/ + if(_dec->telemetry_qi&0x1){ + cairo_text_extents_t extents; + char buffer[10]; + int p; + int y; + p=0; + y=h-7.5; + if(_dec->state.qis[0]>=10)buffer[p++]=48+_dec->state.qis[0]/10; + buffer[p++]=48+_dec->state.qis[0]%10; + if(_dec->state.nqis>=2){ + buffer[p++]=' '; + if(_dec->state.qis[1]>=10)buffer[p++]=48+_dec->state.qis[1]/10; + buffer[p++]=48+_dec->state.qis[1]%10; + } + if(_dec->state.nqis==3){ + buffer[p++]=' '; + if(_dec->state.qis[2]>=10)buffer[p++]=48+_dec->state.qis[2]/10; + buffer[p++]=48+_dec->state.qis[2]%10; + } + buffer[p++]='\0'; + cairo_select_font_face(c,"sans", + CAIRO_FONT_SLANT_NORMAL,CAIRO_FONT_WEIGHT_BOLD); + cairo_set_font_size(c,18); + cairo_text_extents(c,buffer,&extents); + cairo_set_source_rgb(c,1,1,1); + cairo_move_to(c,w-extents.x_advance-10,y); + cairo_show_text(c,buffer); + cairo_set_source_rgb(c,0,0,0); + cairo_move_to(c,w-extents.x_advance-10,y); + cairo_text_path(c,buffer); + cairo_set_line_width(c,.8); + cairo_set_line_join(c,CAIRO_LINE_JOIN_ROUND); + cairo_stroke(c); + } + cairo_destroy(c); + } + /*Out of the Cairo plane into the telemetry YUV buffer.*/ + _ycbcr[0].data=_dec->telemetry_frame_data; + _ycbcr[0].stride=_ycbcr[0].width; + _ycbcr[1].data=_ycbcr[0].data+h*_ycbcr[0].stride; + _ycbcr[1].stride=_ycbcr[1].width; + _ycbcr[2].data=_ycbcr[1].data+(h>>vdec)*_ycbcr[1].stride; + _ycbcr[2].stride=_ycbcr[2].width; + y_row=_ycbcr[0].data; + u_row=_ycbcr[1].data; + v_row=_ycbcr[2].data; + rgb_row=data; + /*This is one of the few places it's worth handling chroma on a + case-by-case basis.*/ + switch(_dec->state.info.pixel_fmt){ + case TH_PF_420:{ + for(y=0;y>1]=OC_CLAMP255(u); + v_row[x>>1]=OC_CLAMP255(v); + } + y_row+=_ycbcr[0].stride<<1; + u_row+=_ycbcr[1].stride; + v_row+=_ycbcr[2].stride; + rgb_row+=cstride<<1; + } + }break; + case TH_PF_422:{ + for(y=0;y>1]=OC_CLAMP255(u); + v_row[x>>1]=OC_CLAMP255(v); + } + y_row+=_ycbcr[0].stride; + u_row+=_ycbcr[1].stride; + v_row+=_ycbcr[2].stride; + rgb_row+=cstride; + } + }break; + /*case TH_PF_444:*/ + default:{ + for(y=0;y +#include +#include +#include "dequant.h" +#include "decint.h" + +int oc_quant_params_unpack(oc_pack_buf *_opb,th_quant_info *_qinfo){ + th_quant_base *base_mats; + long val; + int nbase_mats; + int sizes[64]; + int indices[64]; + int nbits; + int bmi; + int ci; + int qti; + int pli; + int qri; + int qi; + int i; + val=oc_pack_read(_opb,3); + nbits=(int)val; + for(qi=0;qi<64;qi++){ + val=oc_pack_read(_opb,nbits); + _qinfo->loop_filter_limits[qi]=(unsigned char)val; + } + val=oc_pack_read(_opb,4); + nbits=(int)val+1; + for(qi=0;qi<64;qi++){ + val=oc_pack_read(_opb,nbits); + _qinfo->ac_scale[qi]=(ogg_uint16_t)val; + } + val=oc_pack_read(_opb,4); + nbits=(int)val+1; + for(qi=0;qi<64;qi++){ + val=oc_pack_read(_opb,nbits); + _qinfo->dc_scale[qi]=(ogg_uint16_t)val; + } + val=oc_pack_read(_opb,9); + nbase_mats=(int)val+1; + base_mats=_ogg_malloc(nbase_mats*sizeof(base_mats[0])); + if(base_mats==NULL)return TH_EFAULT; + for(bmi=0;bmiqi_ranges[qti]+pli; + if(i>0){ + val=oc_pack_read1(_opb); + if(!val){ + int qtj; + int plj; + if(qti>0){ + val=oc_pack_read1(_opb); + if(val){ + qtj=qti-1; + plj=pli; + } + else{ + qtj=(i-1)/3; + plj=(i-1)%3; + } + } + else{ + qtj=(i-1)/3; + plj=(i-1)%3; + } + *qranges=*(_qinfo->qi_ranges[qtj]+plj); + continue; + } + } + val=oc_pack_read(_opb,nbits); + indices[0]=(int)val; + for(qi=qri=0;qi<63;){ + val=oc_pack_read(_opb,oc_ilog(62-qi)); + sizes[qri]=(int)val+1; + qi+=(int)val+1; + val=oc_pack_read(_opb,nbits); + indices[++qri]=(int)val; + } + /*Note: The caller is responsible for cleaning up any partially + constructed qinfo.*/ + if(qi>63){ + _ogg_free(base_mats); + return TH_EBADHEADER; + } + qranges->nranges=qri; + qranges->sizes=qrsizes=(int *)_ogg_malloc(qri*sizeof(qrsizes[0])); + if(qranges->sizes==NULL){ + /*Note: The caller is responsible for cleaning up any partially + constructed qinfo.*/ + _ogg_free(base_mats); + return TH_EFAULT; + } + memcpy(qrsizes,sizes,qri*sizeof(qrsizes[0])); + qrbms=(th_quant_base *)_ogg_malloc((qri+1)*sizeof(qrbms[0])); + if(qrbms==NULL){ + /*Note: The caller is responsible for cleaning up any partially + constructed qinfo.*/ + _ogg_free(base_mats); + return TH_EFAULT; + } + qranges->base_matrices=(const th_quant_base *)qrbms; + do{ + bmi=indices[qri]; + /*Note: The caller is responsible for cleaning up any partially + constructed qinfo.*/ + if(bmi>=nbase_mats){ + _ogg_free(base_mats); + return TH_EBADHEADER; + } + memcpy(qrbms[qri],base_mats[bmi],sizeof(qrbms[qri])); + } + while(qri-->0); + } + _ogg_free(base_mats); + return 0; +} + +void oc_quant_params_clear(th_quant_info *_qinfo){ + int i; + for(i=6;i-->0;){ + int qti; + int pli; + qti=i/3; + pli=i%3; + /*Clear any duplicate pointer references.*/ + if(i>0){ + int qtj; + int plj; + qtj=(i-1)/3; + plj=(i-1)%3; + if(_qinfo->qi_ranges[qti][pli].sizes== + _qinfo->qi_ranges[qtj][plj].sizes){ + _qinfo->qi_ranges[qti][pli].sizes=NULL; + } + if(_qinfo->qi_ranges[qti][pli].base_matrices== + _qinfo->qi_ranges[qtj][plj].base_matrices){ + _qinfo->qi_ranges[qti][pli].base_matrices=NULL; + } + } + if(qti>0){ + if(_qinfo->qi_ranges[1][pli].sizes== + _qinfo->qi_ranges[0][pli].sizes){ + _qinfo->qi_ranges[1][pli].sizes=NULL; + } + if(_qinfo->qi_ranges[1][pli].base_matrices== + _qinfo->qi_ranges[0][pli].base_matrices){ + _qinfo->qi_ranges[1][pli].base_matrices=NULL; + } + } + /*Now free all the non-duplicate storage.*/ + _ogg_free((void *)_qinfo->qi_ranges[qti][pli].sizes); + _ogg_free((void *)_qinfo->qi_ranges[qti][pli].base_matrices); + } +} diff --git a/libs/libtheora-1.1/lib/dequant.h b/libs/libtheora-1.1/lib/dequant.h new file mode 100644 index 00000000..4e0c5c71 --- /dev/null +++ b/libs/libtheora-1.1/lib/dequant.h @@ -0,0 +1,27 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: dequant.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_dequant_H) +# define _dequant_H (1) +# include "quant.h" +# include "bitpack.h" + +int oc_quant_params_unpack(oc_pack_buf *_opb, + th_quant_info *_qinfo); +void oc_quant_params_clear(th_quant_info *_qinfo); + +#endif diff --git a/libs/libtheora-1.1/lib/encapiwrapper.c b/libs/libtheora-1.1/lib/encapiwrapper.c new file mode 100644 index 00000000..874f1244 --- /dev/null +++ b/libs/libtheora-1.1/lib/encapiwrapper.c @@ -0,0 +1,168 @@ +#include +#include +#include +#include "apiwrapper.h" +#include "encint.h" +#include "theora/theoraenc.h" + + + +static void th_enc_api_clear(th_api_wrapper *_api){ + if(_api->encode)th_encode_free(_api->encode); + memset(_api,0,sizeof(*_api)); +} + +static void theora_encode_clear(theora_state *_te){ + if(_te->i!=NULL)theora_info_clear(_te->i); + memset(_te,0,sizeof(*_te)); +} + +static int theora_encode_control(theora_state *_te,int _req, + void *_buf,size_t _buf_sz){ + return th_encode_ctl(((th_api_wrapper *)_te->i->codec_setup)->encode, + _req,_buf,_buf_sz); +} + +static ogg_int64_t theora_encode_granule_frame(theora_state *_te, + ogg_int64_t _gp){ + return th_granule_frame(((th_api_wrapper *)_te->i->codec_setup)->encode,_gp); +} + +static double theora_encode_granule_time(theora_state *_te,ogg_int64_t _gp){ + return th_granule_time(((th_api_wrapper *)_te->i->codec_setup)->encode,_gp); +} + +static const oc_state_dispatch_vtable OC_ENC_DISPATCH_VTBL={ + (oc_state_clear_func)theora_encode_clear, + (oc_state_control_func)theora_encode_control, + (oc_state_granule_frame_func)theora_encode_granule_frame, + (oc_state_granule_time_func)theora_encode_granule_time, +}; + +int theora_encode_init(theora_state *_te,theora_info *_ci){ + th_api_info *apiinfo; + th_info info; + ogg_uint32_t keyframe_frequency_force; + /*Allocate our own combined API wrapper/theora_info struct. + We put them both in one malloc'd block so that when the API wrapper is + freed, the info struct goes with it. + This avoids having to figure out whether or not we need to free the info + struct in either theora_info_clear() or theora_clear().*/ + apiinfo=(th_api_info *)_ogg_malloc(sizeof(*apiinfo)); + if(apiinfo==NULL)return TH_EFAULT; + /*Make our own copy of the info struct, since its lifetime should be + independent of the one we were passed in.*/ + *&apiinfo->info=*_ci; + oc_theora_info2th_info(&info,_ci); + apiinfo->api.encode=th_encode_alloc(&info); + if(apiinfo->api.encode==NULL){ + _ogg_free(apiinfo); + return OC_EINVAL; + } + apiinfo->api.clear=(oc_setup_clear_func)th_enc_api_clear; + /*Provide entry points for ABI compatibility with old decoder shared libs.*/ + _te->internal_encode=(void *)&OC_ENC_DISPATCH_VTBL; + _te->internal_decode=NULL; + _te->granulepos=0; + _te->i=&apiinfo->info; + _te->i->codec_setup=&apiinfo->api; + /*Set the precise requested keyframe frequency.*/ + keyframe_frequency_force=_ci->keyframe_auto_p? + _ci->keyframe_frequency_force:_ci->keyframe_frequency; + th_encode_ctl(apiinfo->api.encode, + TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE, + &keyframe_frequency_force,sizeof(keyframe_frequency_force)); + /*TODO: Additional codec setup using the extra fields in theora_info.*/ + return 0; +} + +int theora_encode_YUVin(theora_state *_te,yuv_buffer *_yuv){ + th_api_wrapper *api; + th_ycbcr_buffer buf; + int ret; + api=(th_api_wrapper *)_te->i->codec_setup; + buf[0].width=_yuv->y_width; + buf[0].height=_yuv->y_height; + buf[0].stride=_yuv->y_stride; + buf[0].data=_yuv->y; + buf[1].width=_yuv->uv_width; + buf[1].height=_yuv->uv_height; + buf[1].stride=_yuv->uv_stride; + buf[1].data=_yuv->u; + buf[2].width=_yuv->uv_width; + buf[2].height=_yuv->uv_height; + buf[2].stride=_yuv->uv_stride; + buf[2].data=_yuv->v; + ret=th_encode_ycbcr_in(api->encode,buf); + if(ret<0)return ret; + _te->granulepos=api->encode->state.granpos; + return ret; +} + +int theora_encode_packetout(theora_state *_te,int _last_p,ogg_packet *_op){ + th_api_wrapper *api; + api=(th_api_wrapper *)_te->i->codec_setup; + return th_encode_packetout(api->encode,_last_p,_op); +} + +int theora_encode_header(theora_state *_te,ogg_packet *_op){ + oc_enc_ctx *enc; + th_api_wrapper *api; + int ret; + api=(th_api_wrapper *)_te->i->codec_setup; + enc=api->encode; + /*If we've already started encoding, fail.*/ + if(enc->packet_state>OC_PACKET_EMPTY||enc->state.granpos!=0){ + return TH_EINVAL; + } + /*Reset the state to make sure we output an info packet.*/ + enc->packet_state=OC_PACKET_INFO_HDR; + ret=th_encode_flushheader(api->encode,NULL,_op); + return ret>=0?0:ret; +} + +int theora_encode_comment(theora_comment *_tc,ogg_packet *_op){ + oggpack_buffer opb; + void *buf; + int packet_state; + int ret; + packet_state=OC_PACKET_COMMENT_HDR; + oggpackB_writeinit(&opb); + ret=oc_state_flushheader(NULL,&packet_state,&opb,NULL,NULL, + th_version_string(),(th_comment *)_tc,_op); + if(ret>=0){ + /*The oggpack_buffer's lifetime ends with this function, so we have to + copy out the packet contents. + Presumably the application knows it is supposed to free this. + This part works nothing like the Vorbis API, and the documentation on it + has been wrong for some time, claiming libtheora owned the memory.*/ + buf=_ogg_malloc(_op->bytes); + if(buf==NULL){ + _op->packet=NULL; + ret=TH_EFAULT; + } + else{ + memcpy(buf,_op->packet,_op->bytes); + _op->packet=buf; + ret=0; + } + } + oggpack_writeclear(&opb); + return ret; +} + +int theora_encode_tables(theora_state *_te,ogg_packet *_op){ + oc_enc_ctx *enc; + th_api_wrapper *api; + int ret; + api=(th_api_wrapper *)_te->i->codec_setup; + enc=api->encode; + /*If we've already started encoding, fail.*/ + if(enc->packet_state>OC_PACKET_EMPTY||enc->state.granpos!=0){ + return TH_EINVAL; + } + /*Reset the state to make sure we output a setup packet.*/ + enc->packet_state=OC_PACKET_SETUP_HDR; + ret=th_encode_flushheader(api->encode,NULL,_op); + return ret>=0?0:ret; +} diff --git a/libs/libtheora-1.1/lib/encfrag.c b/libs/libtheora-1.1/lib/encfrag.c new file mode 100644 index 00000000..e3a6a572 --- /dev/null +++ b/libs/libtheora-1.1/lib/encfrag.c @@ -0,0 +1,388 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: encfrag.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include +#include "encint.h" + + +void oc_enc_frag_sub(const oc_enc_ctx *_enc,ogg_int16_t _diff[64], + const unsigned char *_src,const unsigned char *_ref,int _ystride){ + (*_enc->opt_vtable.frag_sub)(_diff,_src,_ref,_ystride); +} + +void oc_enc_frag_sub_c(ogg_int16_t _diff[64],const unsigned char *_src, + const unsigned char *_ref,int _ystride){ + int i; + for(i=0;i<8;i++){ + int j; + for(j=0;j<8;j++)_diff[i*8+j]=(ogg_int16_t)(_src[j]-_ref[j]); + _src+=_ystride; + _ref+=_ystride; + } +} + +void oc_enc_frag_sub_128(const oc_enc_ctx *_enc,ogg_int16_t _diff[64], + const unsigned char *_src,int _ystride){ + (*_enc->opt_vtable.frag_sub_128)(_diff,_src,_ystride); +} + +void oc_enc_frag_sub_128_c(ogg_int16_t *_diff, + const unsigned char *_src,int _ystride){ + int i; + for(i=0;i<8;i++){ + int j; + for(j=0;j<8;j++)_diff[i*8+j]=(ogg_int16_t)(_src[j]-128); + _src+=_ystride; + } +} + +unsigned oc_enc_frag_sad(const oc_enc_ctx *_enc,const unsigned char *_x, + const unsigned char *_y,int _ystride){ + return (*_enc->opt_vtable.frag_sad)(_x,_y,_ystride); +} + +unsigned oc_enc_frag_sad_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride){ + unsigned sad; + int i; + sad=0; + for(i=8;i-->0;){ + int j; + for(j=0;j<8;j++)sad+=abs(_src[j]-_ref[j]); + _src+=_ystride; + _ref+=_ystride; + } + return sad; +} + +unsigned oc_enc_frag_sad_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref,int _ystride, + unsigned _thresh){ + return (*_enc->opt_vtable.frag_sad_thresh)(_src,_ref,_ystride,_thresh); +} + +unsigned oc_enc_frag_sad_thresh_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + unsigned sad; + int i; + sad=0; + for(i=8;i-->0;){ + int j; + for(j=0;j<8;j++)sad+=abs(_src[j]-_ref[j]); + if(sad>_thresh)break; + _src+=_ystride; + _ref+=_ystride; + } + return sad; +} + +unsigned oc_enc_frag_sad2_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref1, + const unsigned char *_ref2,int _ystride,unsigned _thresh){ + return (*_enc->opt_vtable.frag_sad2_thresh)(_src,_ref1,_ref2,_ystride, + _thresh); +} + +unsigned oc_enc_frag_sad2_thresh_c(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + unsigned sad; + int i; + sad=0; + for(i=8;i-->0;){ + int j; + for(j=0;j<8;j++)sad+=abs(_src[j]-(_ref1[j]+_ref2[j]>>1)); + if(sad>_thresh)break; + _src+=_ystride; + _ref1+=_ystride; + _ref2+=_ystride; + } + return sad; +} + +static void oc_diff_hadamard(ogg_int16_t _buf[64],const unsigned char *_src, + const unsigned char *_ref,int _ystride){ + int i; + for(i=0;i<8;i++){ + int t0; + int t1; + int t2; + int t3; + int t4; + int t5; + int t6; + int t7; + int r; + /*Hadamard stage 1:*/ + t0=_src[0]-_ref[0]+_src[4]-_ref[4]; + t4=_src[0]-_ref[0]-_src[4]+_ref[4]; + t1=_src[1]-_ref[1]+_src[5]-_ref[5]; + t5=_src[1]-_ref[1]-_src[5]+_ref[5]; + t2=_src[2]-_ref[2]+_src[6]-_ref[6]; + t6=_src[2]-_ref[2]-_src[6]+_ref[6]; + t3=_src[3]-_ref[3]+_src[7]-_ref[7]; + t7=_src[3]-_ref[3]-_src[7]+_ref[7]; + /*Hadamard stage 2:*/ + r=t0; + t0+=t2; + t2=r-t2; + r=t1; + t1+=t3; + t3=r-t3; + r=t4; + t4+=t6; + t6=r-t6; + r=t5; + t5+=t7; + t7=r-t7; + /*Hadamard stage 3:*/ + _buf[0*8+i]=(ogg_int16_t)(t0+t1); + _buf[1*8+i]=(ogg_int16_t)(t0-t1); + _buf[2*8+i]=(ogg_int16_t)(t2+t3); + _buf[3*8+i]=(ogg_int16_t)(t2-t3); + _buf[4*8+i]=(ogg_int16_t)(t4+t5); + _buf[5*8+i]=(ogg_int16_t)(t4-t5); + _buf[6*8+i]=(ogg_int16_t)(t6+t7); + _buf[7*8+i]=(ogg_int16_t)(t6-t7); + _src+=_ystride; + _ref+=_ystride; + } +} + +static void oc_diff_hadamard2(ogg_int16_t _buf[64],const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride){ + int i; + for(i=0;i<8;i++){ + int t0; + int t1; + int t2; + int t3; + int t4; + int t5; + int t6; + int t7; + int r; + /*Hadamard stage 1:*/ + r=_ref1[0]+_ref2[0]>>1; + t4=_ref1[4]+_ref2[4]>>1; + t0=_src[0]-r+_src[4]-t4; + t4=_src[0]-r-_src[4]+t4; + r=_ref1[1]+_ref2[1]>>1; + t5=_ref1[5]+_ref2[5]>>1; + t1=_src[1]-r+_src[5]-t5; + t5=_src[1]-r-_src[5]+t5; + r=_ref1[2]+_ref2[2]>>1; + t6=_ref1[6]+_ref2[6]>>1; + t2=_src[2]-r+_src[6]-t6; + t6=_src[2]-r-_src[6]+t6; + r=_ref1[3]+_ref2[3]>>1; + t7=_ref1[7]+_ref2[7]>>1; + t3=_src[3]-r+_src[7]-t7; + t7=_src[3]-r-_src[7]+t7; + /*Hadamard stage 2:*/ + r=t0; + t0+=t2; + t2=r-t2; + r=t1; + t1+=t3; + t3=r-t3; + r=t4; + t4+=t6; + t6=r-t6; + r=t5; + t5+=t7; + t7=r-t7; + /*Hadamard stage 3:*/ + _buf[0*8+i]=(ogg_int16_t)(t0+t1); + _buf[1*8+i]=(ogg_int16_t)(t0-t1); + _buf[2*8+i]=(ogg_int16_t)(t2+t3); + _buf[3*8+i]=(ogg_int16_t)(t2-t3); + _buf[4*8+i]=(ogg_int16_t)(t4+t5); + _buf[5*8+i]=(ogg_int16_t)(t4-t5); + _buf[6*8+i]=(ogg_int16_t)(t6+t7); + _buf[7*8+i]=(ogg_int16_t)(t6-t7); + _src+=_ystride; + _ref1+=_ystride; + _ref2+=_ystride; + } +} + +static void oc_intra_hadamard(ogg_int16_t _buf[64],const unsigned char *_src, + int _ystride){ + int i; + for(i=0;i<8;i++){ + int t0; + int t1; + int t2; + int t3; + int t4; + int t5; + int t6; + int t7; + int r; + /*Hadamard stage 1:*/ + t0=_src[0]+_src[4]; + t4=_src[0]-_src[4]; + t1=_src[1]+_src[5]; + t5=_src[1]-_src[5]; + t2=_src[2]+_src[6]; + t6=_src[2]-_src[6]; + t3=_src[3]+_src[7]; + t7=_src[3]-_src[7]; + /*Hadamard stage 2:*/ + r=t0; + t0+=t2; + t2=r-t2; + r=t1; + t1+=t3; + t3=r-t3; + r=t4; + t4+=t6; + t6=r-t6; + r=t5; + t5+=t7; + t7=r-t7; + /*Hadamard stage 3:*/ + _buf[0*8+i]=(ogg_int16_t)(t0+t1); + _buf[1*8+i]=(ogg_int16_t)(t0-t1); + _buf[2*8+i]=(ogg_int16_t)(t2+t3); + _buf[3*8+i]=(ogg_int16_t)(t2-t3); + _buf[4*8+i]=(ogg_int16_t)(t4+t5); + _buf[5*8+i]=(ogg_int16_t)(t4-t5); + _buf[6*8+i]=(ogg_int16_t)(t6+t7); + _buf[7*8+i]=(ogg_int16_t)(t6-t7); + _src+=_ystride; + } +} + +unsigned oc_hadamard_sad_thresh(const ogg_int16_t _buf[64],unsigned _thresh){ + unsigned sad; + int t0; + int t1; + int t2; + int t3; + int t4; + int t5; + int t6; + int t7; + int r; + int i; + sad=0; + for(i=0;i<8;i++){ + /*Hadamard stage 1:*/ + t0=_buf[i*8+0]+_buf[i*8+4]; + t4=_buf[i*8+0]-_buf[i*8+4]; + t1=_buf[i*8+1]+_buf[i*8+5]; + t5=_buf[i*8+1]-_buf[i*8+5]; + t2=_buf[i*8+2]+_buf[i*8+6]; + t6=_buf[i*8+2]-_buf[i*8+6]; + t3=_buf[i*8+3]+_buf[i*8+7]; + t7=_buf[i*8+3]-_buf[i*8+7]; + /*Hadamard stage 2:*/ + r=t0; + t0+=t2; + t2=r-t2; + r=t1; + t1+=t3; + t3=r-t3; + r=t4; + t4+=t6; + t6=r-t6; + r=t5; + t5+=t7; + t7=r-t7; + /*Hadamard stage 3:*/ + r=abs(t0+t1); + r+=abs(t0-t1); + r+=abs(t2+t3); + r+=abs(t2-t3); + r+=abs(t4+t5); + r+=abs(t4-t5); + r+=abs(t6+t7); + r+=abs(t6-t7); + sad+=r; + if(sad>_thresh)break; + } + return sad; +} + +unsigned oc_enc_frag_satd_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref,int _ystride, + unsigned _thresh){ + return (*_enc->opt_vtable.frag_satd_thresh)(_src,_ref,_ystride,_thresh); +} + +unsigned oc_enc_frag_satd_thresh_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + ogg_int16_t buf[64]; + oc_diff_hadamard(buf,_src,_ref,_ystride); + return oc_hadamard_sad_thresh(buf,_thresh); +} + +unsigned oc_enc_frag_satd2_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref1, + const unsigned char *_ref2,int _ystride,unsigned _thresh){ + return (*_enc->opt_vtable.frag_satd2_thresh)(_src,_ref1,_ref2,_ystride, + _thresh); +} + +unsigned oc_enc_frag_satd2_thresh_c(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + ogg_int16_t buf[64]; + oc_diff_hadamard2(buf,_src,_ref1,_ref2,_ystride); + return oc_hadamard_sad_thresh(buf,_thresh); +} + +unsigned oc_enc_frag_intra_satd(const oc_enc_ctx *_enc, + const unsigned char *_src,int _ystride){ + return (*_enc->opt_vtable.frag_intra_satd)(_src,_ystride); +} + +unsigned oc_enc_frag_intra_satd_c(const unsigned char *_src,int _ystride){ + ogg_int16_t buf[64]; + oc_intra_hadamard(buf,_src,_ystride); + return oc_hadamard_sad_thresh(buf,UINT_MAX) + -abs(buf[0]+buf[1]+buf[2]+buf[3]+buf[4]+buf[5]+buf[6]+buf[7]); +} + +void oc_enc_frag_copy2(const oc_enc_ctx *_enc,unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride){ + (*_enc->opt_vtable.frag_copy2)(_dst,_src1,_src2,_ystride); +} + +void oc_enc_frag_copy2_c(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride){ + int i; + int j; + for(i=8;i-->0;){ + for(j=0;j<8;j++)_dst[j]=_src1[j]+_src2[j]>>1; + _dst+=_ystride; + _src1+=_ystride; + _src2+=_ystride; + } +} + +void oc_enc_frag_recon_intra(const oc_enc_ctx *_enc, + unsigned char *_dst,int _ystride,const ogg_int16_t _residue[64]){ + (*_enc->opt_vtable.frag_recon_intra)(_dst,_ystride,_residue); +} + +void oc_enc_frag_recon_inter(const oc_enc_ctx *_enc,unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]){ + (*_enc->opt_vtable.frag_recon_inter)(_dst,_src,_ystride,_residue); +} diff --git a/libs/libtheora-1.1/lib/encinfo.c b/libs/libtheora-1.1/lib/encinfo.c new file mode 100644 index 00000000..0f4f5276 --- /dev/null +++ b/libs/libtheora-1.1/lib/encinfo.c @@ -0,0 +1,121 @@ +#include +#include +#include "internal.h" +#include "enquant.h" +#include "huffenc.h" + + + +/*Packs a series of octets from a given byte array into the pack buffer. + _opb: The pack buffer to store the octets in. + _buf: The byte array containing the bytes to pack. + _len: The number of octets to pack.*/ +static void oc_pack_octets(oggpack_buffer *_opb,const char *_buf,int _len){ + int i; + for(i=0;i<_len;i++)oggpackB_write(_opb,_buf[i],8); +} + + + +int oc_state_flushheader(oc_theora_state *_state,int *_packet_state, + oggpack_buffer *_opb,const th_quant_info *_qinfo, + const th_huff_code _codes[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS], + const char *_vendor,th_comment *_tc,ogg_packet *_op){ + unsigned char *packet; + int b_o_s; + if(_op==NULL)return TH_EFAULT; + switch(*_packet_state){ + /*Codec info header.*/ + case OC_PACKET_INFO_HDR:{ + if(_state==NULL)return TH_EFAULT; + oggpackB_reset(_opb); + /*Mark this packet as the info header.*/ + oggpackB_write(_opb,0x80,8); + /*Write the codec string.*/ + oc_pack_octets(_opb,"theora",6); + /*Write the codec bitstream version.*/ + oggpackB_write(_opb,TH_VERSION_MAJOR,8); + oggpackB_write(_opb,TH_VERSION_MINOR,8); + oggpackB_write(_opb,TH_VERSION_SUB,8); + /*Describe the encoded frame.*/ + oggpackB_write(_opb,_state->info.frame_width>>4,16); + oggpackB_write(_opb,_state->info.frame_height>>4,16); + oggpackB_write(_opb,_state->info.pic_width,24); + oggpackB_write(_opb,_state->info.pic_height,24); + oggpackB_write(_opb,_state->info.pic_x,8); + oggpackB_write(_opb,_state->info.pic_y,8); + oggpackB_write(_opb,_state->info.fps_numerator,32); + oggpackB_write(_opb,_state->info.fps_denominator,32); + oggpackB_write(_opb,_state->info.aspect_numerator,24); + oggpackB_write(_opb,_state->info.aspect_denominator,24); + oggpackB_write(_opb,_state->info.colorspace,8); + oggpackB_write(_opb,_state->info.target_bitrate,24); + oggpackB_write(_opb,_state->info.quality,6); + oggpackB_write(_opb,_state->info.keyframe_granule_shift,5); + oggpackB_write(_opb,_state->info.pixel_fmt,2); + /*Spare configuration bits.*/ + oggpackB_write(_opb,0,3); + b_o_s=1; + }break; + /*Comment header.*/ + case OC_PACKET_COMMENT_HDR:{ + int vendor_len; + int i; + if(_tc==NULL)return TH_EFAULT; + vendor_len=strlen(_vendor); + oggpackB_reset(_opb); + /*Mark this packet as the comment header.*/ + oggpackB_write(_opb,0x81,8); + /*Write the codec string.*/ + oc_pack_octets(_opb,"theora",6); + /*Write the vendor string.*/ + oggpack_write(_opb,vendor_len,32); + oc_pack_octets(_opb,_vendor,vendor_len); + oggpack_write(_opb,_tc->comments,32); + for(i=0;i<_tc->comments;i++){ + if(_tc->user_comments[i]!=NULL){ + oggpack_write(_opb,_tc->comment_lengths[i],32); + oc_pack_octets(_opb,_tc->user_comments[i],_tc->comment_lengths[i]); + } + else oggpack_write(_opb,0,32); + } + b_o_s=0; + }break; + /*Codec setup header.*/ + case OC_PACKET_SETUP_HDR:{ + int ret; + oggpackB_reset(_opb); + /*Mark this packet as the setup header.*/ + oggpackB_write(_opb,0x82,8); + /*Write the codec string.*/ + oc_pack_octets(_opb,"theora",6); + /*Write the quantizer tables.*/ + oc_quant_params_pack(_opb,_qinfo); + /*Write the huffman codes.*/ + ret=oc_huff_codes_pack(_opb,_codes); + /*This should never happen, because we validate the tables when they + are set. + If you see, it's a good chance memory is being corrupted.*/ + if(ret<0)return ret; + b_o_s=0; + }break; + /*No more headers to emit.*/ + default:return 0; + } + /*This is kind of fugly: we hand the user a buffer which they do not own. + We will overwrite it when the next packet is output, so the user better be + done with it by then. + Vorbis is little better: it hands back buffers that it will free the next + time the headers are requested, or when the encoder is cleared. + Hopefully libogg2 will make this much cleaner.*/ + packet=oggpackB_get_buffer(_opb); + /*If there's no packet, malloc failed while writing.*/ + if(packet==NULL)return TH_EFAULT; + _op->packet=packet; + _op->bytes=oggpackB_bytes(_opb); + _op->b_o_s=b_o_s; + _op->e_o_s=0; + _op->granulepos=0; + _op->packetno=*_packet_state+3; + return ++(*_packet_state)+3; +} diff --git a/libs/libtheora-1.1/lib/encint.h b/libs/libtheora-1.1/lib/encint.h new file mode 100644 index 00000000..23fb520d --- /dev/null +++ b/libs/libtheora-1.1/lib/encint.h @@ -0,0 +1,490 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: encint.h 16753 2009-12-19 00:52:46Z tterribe $ + + ********************************************************************/ +#if !defined(_encint_H) +# define _encint_H (1) +# include "theora/theoraenc.h" +# include "internal.h" +# include "ocintrin.h" +# include "mathops.h" +# include "enquant.h" +# include "huffenc.h" +/*# define OC_COLLECT_METRICS*/ + + + +typedef oc_mv oc_mv2[2]; + +typedef struct oc_enc_opt_vtable oc_enc_opt_vtable; +typedef struct oc_mb_enc_info oc_mb_enc_info; +typedef struct oc_mode_scheme_chooser oc_mode_scheme_chooser; +typedef struct oc_iir_filter oc_iir_filter; +typedef struct oc_frame_metrics oc_frame_metrics; +typedef struct oc_rc_state oc_rc_state; +typedef struct th_enc_ctx oc_enc_ctx; +typedef struct oc_token_checkpoint oc_token_checkpoint; + + + +/*Constants for the packet-out state machine specific to the encoder.*/ + +/*Next packet to emit: Data packet, but none are ready yet.*/ +#define OC_PACKET_EMPTY (0) +/*Next packet to emit: Data packet, and one is ready.*/ +#define OC_PACKET_READY (1) + +/*All features enabled.*/ +#define OC_SP_LEVEL_SLOW (0) +/*Enable early skip.*/ +#define OC_SP_LEVEL_EARLY_SKIP (1) +/*Disable motion compensation.*/ +#define OC_SP_LEVEL_NOMC (2) +/*Maximum valid speed level.*/ +#define OC_SP_LEVEL_MAX (2) + + +/*The bits used for each of the MB mode codebooks.*/ +extern const unsigned char OC_MODE_BITS[2][OC_NMODES]; + +/*The bits used for each of the MV codebooks.*/ +extern const unsigned char OC_MV_BITS[2][64]; + +/*The minimum value that can be stored in a SB run for each codeword. + The last entry is the upper bound on the length of a single SB run.*/ +extern const ogg_uint16_t OC_SB_RUN_VAL_MIN[8]; +/*The bits used for each SB run codeword.*/ +extern const unsigned char OC_SB_RUN_CODE_NBITS[7]; + +/*The bits used for each block run length (starting with 1).*/ +extern const unsigned char OC_BLOCK_RUN_CODE_NBITS[30]; + + + +/*Encoder specific functions with accelerated variants.*/ +struct oc_enc_opt_vtable{ + unsigned (*frag_sad)(const unsigned char *_src, + const unsigned char *_ref,int _ystride); + unsigned (*frag_sad_thresh)(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); + unsigned (*frag_sad2_thresh)(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); + unsigned (*frag_satd_thresh)(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); + unsigned (*frag_satd2_thresh)(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); + unsigned (*frag_intra_satd)(const unsigned char *_src,int _ystride); + void (*frag_sub)(ogg_int16_t _diff[64],const unsigned char *_src, + const unsigned char *_ref,int _ystride); + void (*frag_sub_128)(ogg_int16_t _diff[64], + const unsigned char *_src,int _ystride); + void (*frag_copy2)(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride); + void (*frag_recon_intra)(unsigned char *_dst,int _ystride, + const ogg_int16_t _residue[64]); + void (*frag_recon_inter)(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]); + void (*fdct8x8)(ogg_int16_t _y[64],const ogg_int16_t _x[64]); +}; + + +void oc_enc_vtable_init(oc_enc_ctx *_enc); + + + +/*Encoder-specific macroblock information.*/ +struct oc_mb_enc_info{ + /*Neighboring macro blocks that have MVs available from the current frame.*/ + unsigned cneighbors[4]; + /*Neighboring macro blocks to use for MVs from the previous frame.*/ + unsigned pneighbors[4]; + /*The number of current-frame neighbors.*/ + unsigned char ncneighbors; + /*The number of previous-frame neighbors.*/ + unsigned char npneighbors; + /*Flags indicating which MB modes have been refined.*/ + unsigned char refined; + /*Motion vectors for a macro block for the current frame and the + previous two frames. + Each is a set of 2 vectors against OC_FRAME_GOLD and OC_FRAME_PREV, which + can be used to estimate constant velocity and constant acceleration + predictors. + Uninitialized MVs are (0,0).*/ + oc_mv2 analysis_mv[3]; + /*Current unrefined analysis MVs.*/ + oc_mv unref_mv[2]; + /*Unrefined block MVs.*/ + oc_mv block_mv[4]; + /*Refined block MVs.*/ + oc_mv ref_mv[4]; + /*Minimum motion estimation error from the analysis stage.*/ + ogg_uint16_t error[2]; + /*MB error for half-pel refinement for each frame type.*/ + unsigned satd[2]; + /*Block error for half-pel refinement.*/ + unsigned block_satd[4]; +}; + + + +/*State machine to estimate the opportunity cost of coding a MB mode.*/ +struct oc_mode_scheme_chooser{ + /*Pointers to the a list containing the index of each mode in the mode + alphabet used by each scheme. + The first entry points to the dynamic scheme0_ranks, while the remaining 7 + point to the constant entries stored in OC_MODE_SCHEMES.*/ + const unsigned char *mode_ranks[8]; + /*The ranks for each mode when coded with scheme 0. + These are optimized so that the more frequent modes have lower ranks.*/ + unsigned char scheme0_ranks[OC_NMODES]; + /*The list of modes, sorted in descending order of frequency, that + corresponds to the ranks above.*/ + unsigned char scheme0_list[OC_NMODES]; + /*The number of times each mode has been chosen so far.*/ + int mode_counts[OC_NMODES]; + /*The list of mode coding schemes, sorted in ascending order of bit cost.*/ + unsigned char scheme_list[8]; + /*The number of bits used by each mode coding scheme.*/ + ptrdiff_t scheme_bits[8]; +}; + + +void oc_mode_scheme_chooser_init(oc_mode_scheme_chooser *_chooser); + + + +/*A 2nd order low-pass Bessel follower. + We use this for rate control because it has fast reaction time, but is + critically damped.*/ +struct oc_iir_filter{ + ogg_int32_t c[2]; + ogg_int64_t g; + ogg_int32_t x[2]; + ogg_int32_t y[2]; +}; + + + +/*The 2-pass metrics associated with a single frame.*/ +struct oc_frame_metrics{ + /*The log base 2 of the scale factor for this frame in Q24 format.*/ + ogg_int32_t log_scale; + /*The number of application-requested duplicates of this frame.*/ + unsigned dup_count:31; + /*The frame type from pass 1.*/ + unsigned frame_type:1; +}; + + + +/*Rate control state information.*/ +struct oc_rc_state{ + /*The target average bits per frame.*/ + ogg_int64_t bits_per_frame; + /*The current buffer fullness (bits available to be used).*/ + ogg_int64_t fullness; + /*The target buffer fullness. + This is where we'd like to be by the last keyframe the appears in the next + buf_delay frames.*/ + ogg_int64_t target; + /*The maximum buffer fullness (total size of the buffer).*/ + ogg_int64_t max; + /*The log of the number of pixels in a frame in Q57 format.*/ + ogg_int64_t log_npixels; + /*The exponent used in the rate model in Q8 format.*/ + unsigned exp[2]; + /*The number of frames to distribute the buffer usage over.*/ + int buf_delay; + /*The total drop count from the previous frame. + This includes duplicates explicitly requested via the + TH_ENCCTL_SET_DUP_COUNT API as well as frames we chose to drop ourselves.*/ + ogg_uint32_t prev_drop_count; + /*The log of an estimated scale factor used to obtain the real framerate, for + VFR sources or, e.g., 12 fps content doubled to 24 fps, etc.*/ + ogg_int64_t log_drop_scale; + /*The log of estimated scale factor for the rate model in Q57 format.*/ + ogg_int64_t log_scale[2]; + /*The log of the target quantizer level in Q57 format.*/ + ogg_int64_t log_qtarget; + /*Will we drop frames to meet bitrate target?*/ + unsigned char drop_frames; + /*Do we respect the maximum buffer fullness?*/ + unsigned char cap_overflow; + /*Can the reservoir go negative?*/ + unsigned char cap_underflow; + /*Second-order lowpass filters to track scale and VFR.*/ + oc_iir_filter scalefilter[2]; + int inter_count; + int inter_delay; + int inter_delay_target; + oc_iir_filter vfrfilter; + /*Two-pass mode state. + 0 => 1-pass encoding. + 1 => 1st pass of 2-pass encoding. + 2 => 2nd pass of 2-pass encoding.*/ + int twopass; + /*Buffer for current frame metrics.*/ + unsigned char twopass_buffer[48]; + /*The number of bytes in the frame metrics buffer. + When 2-pass encoding is enabled, this is set to 0 after each frame is + submitted, and must be non-zero before the next frame will be accepted.*/ + int twopass_buffer_bytes; + int twopass_buffer_fill; + /*Whether or not to force the next frame to be a keyframe.*/ + unsigned char twopass_force_kf; + /*The metrics for the previous frame.*/ + oc_frame_metrics prev_metrics; + /*The metrics for the current frame.*/ + oc_frame_metrics cur_metrics; + /*The buffered metrics for future frames.*/ + oc_frame_metrics *frame_metrics; + int nframe_metrics; + int cframe_metrics; + /*The index of the current frame in the circular metric buffer.*/ + int frame_metrics_head; + /*The frame count of each type (keyframes, delta frames, and dup frames); + 32 bits limits us to 2.268 years at 60 fps.*/ + ogg_uint32_t frames_total[3]; + /*The number of frames of each type yet to be processed.*/ + ogg_uint32_t frames_left[3]; + /*The sum of the scale values for each frame type.*/ + ogg_int64_t scale_sum[2]; + /*The start of the window over which the current scale sums are taken.*/ + int scale_window0; + /*The end of the window over which the current scale sums are taken.*/ + int scale_window_end; + /*The frame count of each type in the current 2-pass window; this does not + include dup frames.*/ + int nframes[3]; + /*The total accumulated estimation bias.*/ + ogg_int64_t rate_bias; +}; + + +void oc_rc_state_init(oc_rc_state *_rc,oc_enc_ctx *_enc); +void oc_rc_state_clear(oc_rc_state *_rc); + +void oc_enc_rc_resize(oc_enc_ctx *_enc); +int oc_enc_select_qi(oc_enc_ctx *_enc,int _qti,int _clamp); +void oc_enc_calc_lambda(oc_enc_ctx *_enc,int _frame_type); +int oc_enc_update_rc_state(oc_enc_ctx *_enc, + long _bits,int _qti,int _qi,int _trial,int _droppable); +int oc_enc_rc_2pass_out(oc_enc_ctx *_enc,unsigned char **_buf); +int oc_enc_rc_2pass_in(oc_enc_ctx *_enc,unsigned char *_buf,size_t _bytes); + + + +/*The internal encoder state.*/ +struct th_enc_ctx{ + /*Shared encoder/decoder state.*/ + oc_theora_state state; + /*Buffer in which to assemble packets.*/ + oggpack_buffer opb; + /*Encoder-specific macroblock information.*/ + oc_mb_enc_info *mb_info; + /*DC coefficients after prediction.*/ + ogg_int16_t *frag_dc; + /*The list of coded macro blocks, in coded order.*/ + unsigned *coded_mbis; + /*The number of coded macro blocks.*/ + size_t ncoded_mbis; + /*Whether or not packets are ready to be emitted. + This takes on negative values while there are remaining header packets to + be emitted, reaches 0 when the codec is ready for input, and becomes + positive when a frame has been processed and data packets are ready.*/ + int packet_state; + /*The maximum distance between keyframes.*/ + ogg_uint32_t keyframe_frequency_force; + /*The number of duplicates to produce for the next frame.*/ + ogg_uint32_t dup_count; + /*The number of duplicates remaining to be emitted for the current frame.*/ + ogg_uint32_t nqueued_dups; + /*The number of duplicates emitted for the last frame.*/ + ogg_uint32_t prev_dup_count; + /*The current speed level.*/ + int sp_level; + /*Whether or not VP3 compatibility mode has been enabled.*/ + unsigned char vp3_compatible; + /*Whether or not any INTER frames have been coded.*/ + unsigned char coded_inter_frame; + /*Whether or not previous frame was dropped.*/ + unsigned char prevframe_dropped; + /*Stores most recently chosen Huffman tables for each frame type, DC and AC + coefficients, and luma and chroma tokens. + The actual Huffman table used for a given coefficient depends not only on + the choice made here, but also its index in the zig-zag ordering.*/ + unsigned char huff_idxs[2][2][2]; + /*Current count of bits used by each MV coding mode.*/ + size_t mv_bits[2]; + /*The mode scheme chooser for estimating mode coding costs.*/ + oc_mode_scheme_chooser chooser; + /*The number of vertical super blocks in an MCU.*/ + int mcu_nvsbs; + /*The SSD error for skipping each fragment in the current MCU.*/ + unsigned *mcu_skip_ssd; + /*The DCT token lists for each coefficient and each plane.*/ + unsigned char **dct_tokens[3]; + /*The extra bits associated with each DCT token.*/ + ogg_uint16_t **extra_bits[3]; + /*The number of DCT tokens for each coefficient for each plane.*/ + ptrdiff_t ndct_tokens[3][64]; + /*Pending EOB runs for each coefficient for each plane.*/ + ogg_uint16_t eob_run[3][64]; + /*The offset of the first DCT token for each coefficient for each plane.*/ + unsigned char dct_token_offs[3][64]; + /*The last DC coefficient for each plane and reference frame.*/ + int dc_pred_last[3][3]; +#if defined(OC_COLLECT_METRICS) + /*Fragment SATD statistics for MB mode estimation metrics.*/ + unsigned *frag_satd; + /*Fragment SSD statistics for MB mode estimation metrics.*/ + unsigned *frag_ssd; +#endif + /*The R-D optimization parameter.*/ + int lambda; + /*The huffman tables in use.*/ + th_huff_code huff_codes[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS]; + /*The quantization parameters in use.*/ + th_quant_info qinfo; + oc_iquant *enquant_tables[64][3][2]; + oc_iquant_table enquant_table_data[64][3][2]; + /*An "average" quantizer for each quantizer type (INTRA or INTER) and qi + value. + This is used to paramterize the rate control decisions. + They are kept in the log domain to simplify later processing. + Keep in mind these are DCT domain quantizers, and so are scaled by an + additional factor of 4 from the pixel domain.*/ + ogg_int64_t log_qavg[2][64]; + /*The buffer state used to drive rate control.*/ + oc_rc_state rc; + /*Table for encoder acceleration functions.*/ + oc_enc_opt_vtable opt_vtable; +}; + + +void oc_enc_analyze_intra(oc_enc_ctx *_enc,int _recode); +int oc_enc_analyze_inter(oc_enc_ctx *_enc,int _allow_keyframe,int _recode); +#if defined(OC_COLLECT_METRICS) +void oc_enc_mode_metrics_collect(oc_enc_ctx *_enc); +void oc_enc_mode_metrics_dump(oc_enc_ctx *_enc); +#endif + + + +/*Perform fullpel motion search for a single MB against both reference frames.*/ +void oc_mcenc_search(oc_enc_ctx *_enc,int _mbi); +/*Refine a MB MV for one frame.*/ +void oc_mcenc_refine1mv(oc_enc_ctx *_enc,int _mbi,int _frame); +/*Refine the block MVs.*/ +void oc_mcenc_refine4mv(oc_enc_ctx *_enc,int _mbi); + + + +/*Used to rollback a tokenlog transaction when we retroactively decide to skip + a fragment. + A checkpoint is taken right before each token is added.*/ +struct oc_token_checkpoint{ + /*The color plane the token was added to.*/ + unsigned char pli; + /*The zig-zag index the token was added to.*/ + unsigned char zzi; + /*The outstanding EOB run count before the token was added.*/ + ogg_uint16_t eob_run; + /*The token count before the token was added.*/ + ptrdiff_t ndct_tokens; +}; + + + +void oc_enc_tokenize_start(oc_enc_ctx *_enc); +int oc_enc_tokenize_ac(oc_enc_ctx *_enc,int _pli,ptrdiff_t _fragi, + ogg_int16_t *_qdct,const ogg_uint16_t *_dequant,const ogg_int16_t *_dct, + int _zzi,oc_token_checkpoint **_stack,int _acmin); +void oc_enc_tokenlog_rollback(oc_enc_ctx *_enc, + const oc_token_checkpoint *_stack,int _n); +void oc_enc_pred_dc_frag_rows(oc_enc_ctx *_enc, + int _pli,int _fragy0,int _frag_yend); +void oc_enc_tokenize_dc_frag_list(oc_enc_ctx *_enc,int _pli, + const ptrdiff_t *_coded_fragis,ptrdiff_t _ncoded_fragis, + int _prev_ndct_tokens1,int _prev_eob_run1); +void oc_enc_tokenize_finish(oc_enc_ctx *_enc); + + + +/*Utility routine to encode one of the header packets.*/ +int oc_state_flushheader(oc_theora_state *_state,int *_packet_state, + oggpack_buffer *_opb,const th_quant_info *_qinfo, + const th_huff_code _codes[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS], + const char *_vendor,th_comment *_tc,ogg_packet *_op); + + + +/*Encoder-specific accelerated functions.*/ +void oc_enc_frag_sub(const oc_enc_ctx *_enc,ogg_int16_t _diff[64], + const unsigned char *_src,const unsigned char *_ref,int _ystride); +void oc_enc_frag_sub_128(const oc_enc_ctx *_enc,ogg_int16_t _diff[64], + const unsigned char *_src,int _ystride); +unsigned oc_enc_frag_sad(const oc_enc_ctx *_enc,const unsigned char *_src, + const unsigned char *_ref,int _ystride); +unsigned oc_enc_frag_sad_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_sad2_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref1, + const unsigned char *_ref2,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_satd_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_satd2_thresh(const oc_enc_ctx *_enc, + const unsigned char *_src,const unsigned char *_ref1, + const unsigned char *_ref2,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_intra_satd(const oc_enc_ctx *_enc, + const unsigned char *_src,int _ystride); +void oc_enc_frag_copy2(const oc_enc_ctx *_enc,unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride); +void oc_enc_frag_recon_intra(const oc_enc_ctx *_enc, + unsigned char *_dst,int _ystride,const ogg_int16_t _residue[64]); +void oc_enc_frag_recon_inter(const oc_enc_ctx *_enc,unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]); +void oc_enc_fdct8x8(const oc_enc_ctx *_enc,ogg_int16_t _y[64], + const ogg_int16_t _x[64]); + +/*Default pure-C implementations.*/ +void oc_enc_vtable_init_c(oc_enc_ctx *_enc); + +void oc_enc_frag_sub_c(ogg_int16_t _diff[64], + const unsigned char *_src,const unsigned char *_ref,int _ystride); +void oc_enc_frag_sub_128_c(ogg_int16_t _diff[64], + const unsigned char *_src,int _ystride); +void oc_enc_frag_copy2_c(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride); +unsigned oc_enc_frag_sad_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride); +unsigned oc_enc_frag_sad_thresh_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_sad2_thresh_c(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_satd_thresh_c(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_satd2_thresh_c(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_intra_satd_c(const unsigned char *_src,int _ystride); +void oc_enc_fdct8x8_c(ogg_int16_t _y[64],const ogg_int16_t _x[64]); + +#endif diff --git a/libs/libtheora-1.1/lib/encode.c b/libs/libtheora-1.1/lib/encode.c new file mode 100644 index 00000000..a2c3c04c --- /dev/null +++ b/libs/libtheora-1.1/lib/encode.c @@ -0,0 +1,1627 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: encode.c 16744 2009-11-30 07:57:27Z tterribe $ + + ********************************************************************/ +#include +#include +#include "encint.h" +#if defined(OC_X86_ASM) +# include "x86/x86enc.h" +#endif + + + +/*The default quantization parameters used by VP3.1.*/ +static const int OC_VP31_RANGE_SIZES[1]={63}; +static const th_quant_base OC_VP31_BASES_INTRA_Y[2]={ + { + 16, 11, 10, 16, 24, 40, 51, 61, + 12, 12, 14, 19, 26, 58, 60, 55, + 14, 13, 16, 24, 40, 57, 69, 56, + 14, 17, 22, 29, 51, 87, 80, 62, + 18, 22, 37, 58, 68,109,103, 77, + 24, 35, 55, 64, 81,104,113, 92, + 49, 64, 78, 87,103,121,120,101, + 72, 92, 95, 98,112,100,103, 99 + }, + { + 16, 11, 10, 16, 24, 40, 51, 61, + 12, 12, 14, 19, 26, 58, 60, 55, + 14, 13, 16, 24, 40, 57, 69, 56, + 14, 17, 22, 29, 51, 87, 80, 62, + 18, 22, 37, 58, 68,109,103, 77, + 24, 35, 55, 64, 81,104,113, 92, + 49, 64, 78, 87,103,121,120,101, + 72, 92, 95, 98,112,100,103, 99 + } +}; +static const th_quant_base OC_VP31_BASES_INTRA_C[2]={ + { + 17, 18, 24, 47, 99, 99, 99, 99, + 18, 21, 26, 66, 99, 99, 99, 99, + 24, 26, 56, 99, 99, 99, 99, 99, + 47, 66, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99 + }, + { + 17, 18, 24, 47, 99, 99, 99, 99, + 18, 21, 26, 66, 99, 99, 99, 99, + 24, 26, 56, 99, 99, 99, 99, 99, + 47, 66, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99 + } +}; +static const th_quant_base OC_VP31_BASES_INTER[2]={ + { + 16, 16, 16, 20, 24, 28, 32, 40, + 16, 16, 20, 24, 28, 32, 40, 48, + 16, 20, 24, 28, 32, 40, 48, 64, + 20, 24, 28, 32, 40, 48, 64, 64, + 24, 28, 32, 40, 48, 64, 64, 64, + 28, 32, 40, 48, 64, 64, 64, 96, + 32, 40, 48, 64, 64, 64, 96,128, + 40, 48, 64, 64, 64, 96,128,128 + }, + { + 16, 16, 16, 20, 24, 28, 32, 40, + 16, 16, 20, 24, 28, 32, 40, 48, + 16, 20, 24, 28, 32, 40, 48, 64, + 20, 24, 28, 32, 40, 48, 64, 64, + 24, 28, 32, 40, 48, 64, 64, 64, + 28, 32, 40, 48, 64, 64, 64, 96, + 32, 40, 48, 64, 64, 64, 96,128, + 40, 48, 64, 64, 64, 96,128,128 + } +}; + +const th_quant_info TH_VP31_QUANT_INFO={ + { + 220,200,190,180,170,170,160,160, + 150,150,140,140,130,130,120,120, + 110,110,100,100, 90, 90, 90, 80, + 80, 80, 70, 70, 70, 60, 60, 60, + 60, 50, 50, 50, 50, 40, 40, 40, + 40, 40, 30, 30, 30, 30, 30, 30, + 30, 20, 20, 20, 20, 20, 20, 20, + 20, 10, 10, 10, 10, 10, 10, 10 + }, + { + 500,450,400,370,340,310,285,265, + 245,225,210,195,185,180,170,160, + 150,145,135,130,125,115,110,107, + 100, 96, 93, 89, 85, 82, 75, 74, + 70, 68, 64, 60, 57, 56, 52, 50, + 49, 45, 44, 43, 40, 38, 37, 35, + 33, 32, 30, 29, 28, 25, 24, 22, + 21, 19, 18, 17, 15, 13, 12, 10 + }, + { + 30,25,20,20,15,15,14,14, + 13,13,12,12,11,11,10,10, + 9, 9, 8, 8, 7, 7, 7, 7, + 6, 6, 6, 6, 5, 5, 5, 5, + 4, 4, 4, 4, 3, 3, 3, 3, + 2, 2, 2, 2, 2, 2, 2, 2, + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0 + }, + { + { + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTRA_Y}, + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTRA_C}, + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTRA_C} + }, + { + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTER}, + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTER}, + {1,OC_VP31_RANGE_SIZES,OC_VP31_BASES_INTER} + } + } +}; + +/*The current default quantization parameters.*/ +static const int OC_DEF_QRANGE_SIZES[3]={32,16,15}; +static const th_quant_base OC_DEF_BASES_INTRA_Y[4]={ + { + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + 15, 15, 15, 15, 15, 15, 15, 15, + }, + { + 15, 12, 12, 15, 18, 20, 20, 21, + 13, 13, 14, 17, 18, 21, 21, 20, + 14, 14, 15, 18, 20, 21, 21, 21, + 14, 16, 17, 19, 20, 21, 21, 21, + 16, 17, 20, 21, 21, 21, 21, 21, + 18, 19, 20, 21, 21, 21, 21, 21, + 20, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21 + }, + { + 16, 12, 11, 16, 20, 25, 27, 28, + 13, 13, 14, 18, 21, 28, 28, 27, + 14, 13, 16, 20, 25, 28, 28, 28, + 14, 16, 19, 22, 27, 29, 29, 28, + 17, 19, 25, 28, 28, 30, 30, 29, + 20, 24, 27, 28, 29, 30, 30, 29, + 27, 28, 29, 29, 30, 30, 30, 30, + 29, 29, 29, 29, 30, 30, 30, 29 + }, + { + 16, 11, 10, 16, 24, 40, 51, 61, + 12, 12, 14, 19, 26, 58, 60, 55, + 14, 13, 16, 24, 40, 57, 69, 56, + 14, 17, 22, 29, 51, 87, 80, 62, + 18, 22, 37, 58, 68,109,103, 77, + 24, 35, 55, 64, 81,104,113, 92, + 49, 64, 78, 87,103,121,120,101, + 72, 92, 95, 98,112,100,103, 99 + } +}; +static const th_quant_base OC_DEF_BASES_INTRA_C[4]={ + { + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19, + 19, 19, 19, 19, 19, 19, 19, 19 + }, + { + 18, 18, 21, 25, 26, 26, 26, 26, + 18, 20, 22, 26, 26, 26, 26, 26, + 21, 22, 25, 26, 26, 26, 26, 26, + 25, 26, 26, 26, 26, 26, 26, 26, + 26, 26, 26, 26, 26, 26, 26, 26, + 26, 26, 26, 26, 26, 26, 26, 26, + 26, 26, 26, 26, 26, 26, 26, 26, + 26, 26, 26, 26, 26, 26, 26, 26 + }, + { + 17, 18, 22, 31, 36, 36, 36, 36, + 18, 20, 24, 34, 36, 36, 36, 36, + 22, 24, 33, 36, 36, 36, 36, 36, + 31, 34, 36, 36, 36, 36, 36, 36, + 36, 36, 36, 36, 36, 36, 36, 36, + 36, 36, 36, 36, 36, 36, 36, 36, + 36, 36, 36, 36, 36, 36, 36, 36, + 36, 36, 36, 36, 36, 36, 36, 36 + }, + { + 17, 18, 24, 47, 99, 99, 99, 99, + 18, 21, 26, 66, 99, 99, 99, 99, + 24, 26, 56, 99, 99, 99, 99, 99, + 47, 66, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99, + 99, 99, 99, 99, 99, 99, 99, 99 + } +}; +static const th_quant_base OC_DEF_BASES_INTER[4]={ + { + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21, + 21, 21, 21, 21, 21, 21, 21, 21 + }, + { + 18, 18, 18, 21, 23, 24, 25, 27, + 18, 18, 21, 23, 24, 25, 27, 28, + 18, 21, 23, 24, 25, 27, 28, 29, + 21, 23, 24, 25, 27, 28, 29, 29, + 23, 24, 25, 27, 28, 29, 29, 29, + 24, 25, 27, 28, 29, 29, 29, 30, + 25, 27, 28, 29, 29, 29, 30, 30, + 27, 28, 29, 29, 29, 30, 30, 30 + }, + { + 17, 17, 17, 20, 23, 26, 28, 32, + 17, 17, 20, 23, 26, 28, 32, 34, + 17, 20, 23, 26, 28, 32, 34, 37, + 20, 23, 26, 28, 32, 34, 37, 37, + 23, 26, 28, 32, 34, 37, 37, 37, + 26, 28, 32, 34, 37, 37, 37, 41, + 28, 32, 34, 37, 37, 37, 41, 42, + 32, 34, 37, 37, 37, 41, 42, 42 + }, + { + 16, 16, 16, 20, 24, 28, 32, 40, + 16, 16, 20, 24, 28, 32, 40, 48, + 16, 20, 24, 28, 32, 40, 48, 64, + 20, 24, 28, 32, 40, 48, 64, 64, + 24, 28, 32, 40, 48, 64, 64, 64, + 28, 32, 40, 48, 64, 64, 64, 96, + 32, 40, 48, 64, 64, 64, 96,128, + 40, 48, 64, 64, 64, 96,128,128 + } +}; + +const th_quant_info TH_DEF_QUANT_INFO={ + { + 365,348,333,316,300,287,277,265, + 252,240,229,219,206,197,189,180, + 171,168,160,153,146,139,132,127, + 121,115,110,107,101, 97, 94, 89, + 85, 83, 78, 73, 72, 67, 66, 62, + 60, 59, 56, 53, 52, 48, 47, 43, + 42, 40, 36, 35, 34, 33, 31, 30, + 28, 25, 24, 22, 20, 17, 14, 10 + }, + { + 365,348,333,316,300,287,277,265, + 252,240,229,219,206,197,189,180, + 171,168,160,153,146,139,132,127, + 121,115,110,107,101, 97, 94, 89, + 85, 83, 78, 73, 72, 67, 66, 62, + 60, 59, 56, 53, 52, 48, 47, 43, + 42, 40, 36, 35, 34, 33, 31, 30, + 28, 25, 24, 22, 20, 17, 14, 10 + }, + { + 30,25,20,20,15,15,14,14, + 13,13,12,12,11,11,10,10, + 9, 9, 8, 8, 7, 7, 7, 7, + 6, 6, 6, 6, 5, 5, 5, 5, + 4, 4, 4, 4, 3, 3, 3, 3, + 2, 2, 2, 2, 2, 2, 2, 2, + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0 + }, + { + { + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTRA_Y}, + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTRA_C}, + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTRA_C} + }, + { + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTER}, + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTER}, + {3,OC_DEF_QRANGE_SIZES,OC_DEF_BASES_INTER} + } + } +}; + + + +/*The Huffman codes used for macro block modes.*/ + +const unsigned char OC_MODE_BITS[2][OC_NMODES]={ + /*Codebook 0: a maximally skewed prefix code.*/ + {1,2,3,4,5,6,7,7}, + /*Codebook 1: a fixed-length code.*/ + {3,3,3,3,3,3,3,3} +}; + +static const unsigned char OC_MODE_CODES[2][OC_NMODES]={ + /*Codebook 0: a maximally skewed prefix code.*/ + {0x00,0x02,0x06,0x0E,0x1E,0x3E,0x7E,0x7F}, + /*Codebook 1: a fixed-length code.*/ + {0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07} +}; + + +/*The Huffman codes used for motion vectors.*/ + +const unsigned char OC_MV_BITS[2][64]={ + /*Codebook 0: VLC code.*/ + { + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,7,7,7,7,7,7,7,7,6,6,6,6,4,4,3, + 3, + 3,4,4,6,6,6,6,7,7,7,7,7,7,7,7,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8 + }, + /*Codebook 1: (5 bit magnitude, 1 bit sign). + This wastes a code word (0x01, negative zero), or a bit (0x00, positive + zero, requires only 5 bits to uniquely decode), but is hopefully not used + very often.*/ + { + 6,6,6,6,6,6,6,6,6,6,6,6,6,6,6, + 6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6, + 6, + 6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6, + 6,6,6,6,6,6,6,6,6,6,6,6,6,6,6 + } +}; + +static const unsigned char OC_MV_CODES[2][64]={ + /*Codebook 0: VLC code.*/ + { + 0xFF,0xFD,0xFB,0xF9,0xF7,0xF5,0xF3, + 0xF1,0xEF,0xED,0xEB,0xE9,0xE7,0xE5,0xE3, + 0xE1,0x6F,0x6D,0x6B,0x69,0x67,0x65,0x63, + 0x61,0x2F,0x2D,0x2B,0x29,0x09,0x07,0x02, + 0x00, + 0x01,0x06,0x08,0x28,0x2A,0x2C,0x2E,0x60, + 0x62,0x64,0x66,0x68,0x6A,0x6C,0x6E,0xE0, + 0xE2,0xE4,0xE6,0xE8,0xEA,0xEC,0xEE,0xF0, + 0xF2,0xF4,0xF6,0xF8,0xFA,0xFC,0xFE + }, + /*Codebook 1: (5 bit magnitude, 1 bit sign).*/ + { + 0x3F,0x3D,0x3B,0x39,0x37,0x35,0x33, + 0x31,0x2F,0x2D,0x2B,0x29,0x27,0x25,0x23, + 0x21,0x1F,0x1D,0x1B,0x19,0x17,0x15,0x13, + 0x11,0x0F,0x0D,0x0B,0x09,0x07,0x05,0x03, + 0x00, + 0x02,0x04,0x06,0x08,0x0A,0x0C,0x0E,0x10, + 0x12,0x14,0x16,0x18,0x1A,0x1C,0x1E,0x20, + 0x22,0x24,0x26,0x28,0x2A,0x2C,0x2E,0x30, + 0x32,0x34,0x36,0x38,0x3A,0x3C,0x3E + } +}; + + + +/*Super block run coding scheme: + Codeword Run Length + 0 1 + 10x 2-3 + 110x 4-5 + 1110xx 6-9 + 11110xxx 10-17 + 111110xxxx 18-33 + 111111xxxxxxxxxxxx 34-4129*/ +const ogg_uint16_t OC_SB_RUN_VAL_MIN[8]={1,2,4,6,10,18,34,4130}; +static const unsigned OC_SB_RUN_CODE_PREFIX[7]={ + 0,4,0xC,0x38,0xF0,0x3E0,0x3F000 +}; +const unsigned char OC_SB_RUN_CODE_NBITS[7]={1,3,4,6,8,10,18}; + + +/*Writes the bit pattern for the run length of a super block run to the given + oggpack_buffer. + _opb: The buffer to write to. + _run_count: The length of the run, which must be positive. + _flag: The current flag. + _done: Whether or not more flags are to be encoded.*/ +static void oc_sb_run_pack(oggpack_buffer *_opb,ptrdiff_t _run_count, + int _flag,int _done){ + int i; + if(_run_count>=4129){ + do{ + oggpackB_write(_opb,0x3FFFF,18); + _run_count-=4129; + if(_run_count>0)oggpackB_write(_opb,_flag,1); + else if(!_done)oggpackB_write(_opb,!_flag,1); + } + while(_run_count>=4129); + if(_run_count<=0)return; + } + for(i=0;_run_count>=OC_SB_RUN_VAL_MIN[i+1];i++); + oggpackB_write(_opb,OC_SB_RUN_CODE_PREFIX[i]+_run_count-OC_SB_RUN_VAL_MIN[i], + OC_SB_RUN_CODE_NBITS[i]); +} + + + +/*Block run coding scheme: + Codeword Run Length + 0x 1-2 + 10x 3-4 + 110x 5-6 + 1110xx 7-10 + 11110xx 11-14 + 11111xxxx 15-30*/ +const unsigned char OC_BLOCK_RUN_CODE_NBITS[30]={ + 2,2,3,3,4,4,6,6,6,6,7,7,7,7,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9 +}; +static const ogg_uint16_t OC_BLOCK_RUN_CODE_PATTERN[30]={ + 0x000,0x001,0x004,0x005,0x00C,0x00D,0x038, + 0x039,0x03A,0x03B,0x078,0x079,0x07A,0x07B,0x1F0, + 0x1F1,0x1F2,0x1F3,0x1F4,0x1F5,0x1F6,0x1F7,0x1F8, + 0x1F9,0x1FA,0x1FB,0x1FC,0x1FD,0x1FE,0x1FF +}; + + +/*Writes the bit pattern for the run length of a block run to the given + oggpack_buffer. + _opb: The buffer to write to. + _run_count: The length of the run. + This must be positive, and no more than 30.*/ +static void oc_block_run_pack(oggpack_buffer *_opb,int _run_count){ + oggpackB_write(_opb,OC_BLOCK_RUN_CODE_PATTERN[_run_count-1], + OC_BLOCK_RUN_CODE_NBITS[_run_count-1]); +} + + + +static void oc_enc_frame_header_pack(oc_enc_ctx *_enc){ + /*Mark this as a data packet.*/ + oggpackB_write(&_enc->opb,0,1); + /*Output the frame type (key frame or delta frame).*/ + oggpackB_write(&_enc->opb,_enc->state.frame_type,1); + /*Write out the current qi list.*/ + oggpackB_write(&_enc->opb,_enc->state.qis[0],6); + if(_enc->state.nqis>1){ + oggpackB_write(&_enc->opb,1,1); + oggpackB_write(&_enc->opb,_enc->state.qis[1],6); + if(_enc->state.nqis>2){ + oggpackB_write(&_enc->opb,1,1); + oggpackB_write(&_enc->opb,_enc->state.qis[2],6); + } + else oggpackB_write(&_enc->opb,0,1); + } + else oggpackB_write(&_enc->opb,0,1); + if(_enc->state.frame_type==OC_INTRA_FRAME){ + /*Key frames have 3 unused configuration bits, holdovers from the VP3 days. + Most of the other unused bits in the VP3 headers were eliminated. + Monty kept these to leave us some wiggle room for future expansion, + though a single bit in all frames would have been far more useful.*/ + oggpackB_write(&_enc->opb,0,3); + } +} + +/*Writes the bit flags for whether or not each super block is partially coded + or not. + These flags are run-length encoded, with the flag value alternating between + each run. + Return: The number partially coded SBs.*/ +static unsigned oc_enc_partial_sb_flags_pack(oc_enc_ctx *_enc){ + const oc_sb_flags *sb_flags; + unsigned nsbs; + unsigned sbi; + unsigned npartial; + int flag; + sb_flags=_enc->state.sb_flags; + nsbs=_enc->state.nsbs; + flag=sb_flags[0].coded_partially; + oggpackB_write(&_enc->opb,flag,1); + sbi=npartial=0; + do{ + unsigned run_count; + for(run_count=0;sbiopb,run_count,flag,sbi>=nsbs); + flag=!flag; + } + while(sbistate.sb_flags; + nsbs=_enc->state.nsbs; + /*Skip partially coded super blocks; their flags have already been coded.*/ + for(sbi=0;sb_flags[sbi].coded_partially;sbi++); + flag=sb_flags[sbi].coded_fully; + oggpackB_write(&_enc->opb,flag,1); + do{ + unsigned run_count; + for(run_count=0;sbiopb,run_count,flag,sbi>=nsbs); + flag=!flag; + } + while(sbistate.nsbs)oc_enc_coded_sb_flags_pack(_enc); + sb_maps=(const oc_sb_map *)_enc->state.sb_maps; + sb_flags=_enc->state.sb_flags; + nsbs=_enc->state.nsbs; + frags=_enc->state.frags; + for(sbi=0;sbiopb,flag,1); + run_count=0; + nsbs=sbi=0; + for(pli=0;pli<3;pli++){ + nsbs+=_enc->state.fplanes[pli].nsbs; + for(;sbi=0){ + if(frags[fragi].coded!=flag){ + oc_block_run_pack(&_enc->opb,run_count); + flag=!flag; + run_count=1; + } + else run_count++; + } + } + } + } + } + } + /*Flush any trailing block coded run.*/ + if(run_count>0)oc_block_run_pack(&_enc->opb,run_count); + } +} + +static void oc_enc_mb_modes_pack(oc_enc_ctx *_enc){ + const unsigned char *mode_codes; + const unsigned char *mode_bits; + const unsigned char *mode_ranks; + unsigned *coded_mbis; + size_t ncoded_mbis; + const signed char *mb_modes; + unsigned mbii; + int scheme; + int mb_mode; + scheme=_enc->chooser.scheme_list[0]; + /*Encode the best scheme.*/ + oggpackB_write(&_enc->opb,scheme,3); + /*If the chosen scheme is scheme 0, send the mode frequency ordering.*/ + if(scheme==0){ + for(mb_mode=0;mb_modeopb,_enc->chooser.scheme0_ranks[mb_mode],3); + } + } + mode_ranks=_enc->chooser.mode_ranks[scheme]; + mode_bits=OC_MODE_BITS[scheme+1>>3]; + mode_codes=OC_MODE_CODES[scheme+1>>3]; + coded_mbis=_enc->coded_mbis; + ncoded_mbis=_enc->ncoded_mbis; + mb_modes=_enc->state.mb_modes; + for(mbii=0;mbiiopb,mode_codes[rank],mode_bits[rank]); + } +} + +static void oc_enc_mv_pack(oc_enc_ctx *_enc,int _mv_scheme,int _dx,int _dy){ + oggpackB_write(&_enc->opb, + OC_MV_CODES[_mv_scheme][_dx+31],OC_MV_BITS[_mv_scheme][_dx+31]); + oggpackB_write(&_enc->opb, + OC_MV_CODES[_mv_scheme][_dy+31],OC_MV_BITS[_mv_scheme][_dy+31]); +} + +static void oc_enc_mvs_pack(oc_enc_ctx *_enc){ + const unsigned *coded_mbis; + size_t ncoded_mbis; + const oc_mb_map *mb_maps; + const signed char *mb_modes; + const oc_fragment *frags; + const oc_mv *frag_mvs; + unsigned mbii; + int mv_scheme; + /*Choose the coding scheme.*/ + mv_scheme=_enc->mv_bits[1]<_enc->mv_bits[0]; + oggpackB_write(&_enc->opb,mv_scheme,1); + /*Encode the motion vectors. + Macro blocks are iterated in Hilbert scan order, but the MVs within the + macro block are coded in raster order.*/ + coded_mbis=_enc->coded_mbis; + ncoded_mbis=_enc->ncoded_mbis; + mb_modes=_enc->state.mb_modes; + mb_maps=(const oc_mb_map *)_enc->state.mb_maps; + frags=_enc->state.frags; + frag_mvs=(const oc_mv *)_enc->state.frag_mvs; + for(mbii=0;mbiistate.nqis<=1)return; + ncoded_fragis=_enc->state.ntotal_coded_fragis; + if(ncoded_fragis<=0)return; + coded_fragis=_enc->state.coded_fragis; + frags=_enc->state.frags; + flag=!!frags[coded_fragis[0]].qii; + oggpackB_write(&_enc->opb,flag,1); + nqi0=0; + for(fragii=0;fragiiopb,run_count,flag,fragii>=ncoded_fragis); + flag=!flag; + } + if(_enc->state.nqis<3||nqi0>=ncoded_fragis)return; + for(fragii=0;!frags[coded_fragis[fragii]].qii;fragii++); + flag=frags[coded_fragis[fragii]].qii-1; + oggpackB_write(&_enc->opb,flag,1); + while(fragiiopb,run_count,flag,fragii>=ncoded_fragis); + flag=!flag; + } +} + +/*Counts the tokens of each type used for the given range of coefficient + indices in zig-zag order. + _zzi_start: The first zig-zag index to include. + _zzi_end: The first zig-zag index to not include. + _token_counts_y: Returns the token counts for the Y' plane. + _token_counts_c: Returns the token counts for the Cb and Cr planes.*/ +static void oc_enc_count_tokens(oc_enc_ctx *_enc,int _zzi_start,int _zzi_end, + ptrdiff_t _token_counts_y[32],ptrdiff_t _token_counts_c[32]){ + const unsigned char *dct_tokens; + ptrdiff_t ndct_tokens; + int pli; + int zzi; + ptrdiff_t ti; + memset(_token_counts_y,0,32*sizeof(*_token_counts_y)); + memset(_token_counts_c,0,32*sizeof(*_token_counts_c)); + for(zzi=_zzi_start;zzi<_zzi_end;zzi++){ + dct_tokens=_enc->dct_tokens[0][zzi]; + ndct_tokens=_enc->ndct_tokens[0][zzi]; + for(ti=_enc->dct_token_offs[0][zzi];tidct_tokens[pli][zzi]; + ndct_tokens=_enc->ndct_tokens[pli][zzi]; + for(ti=_enc->dct_token_offs[pli][zzi];tihuff_codes[huffi+huff_offs][token].nbits; + } + } +} + +/*Returns the Huffman index using the fewest number of bits.*/ +static int oc_select_huff_idx(size_t _bit_counts[16]){ + int best_huffi; + int huffi; + best_huffi=0; + for(huffi=1;huffi<16;huffi++)if(_bit_counts[huffi]<_bit_counts[best_huffi]){ + best_huffi=huffi; + } + return best_huffi; +} + +static void oc_enc_huff_group_pack(oc_enc_ctx *_enc, + int _zzi_start,int _zzi_end,const int _huff_idxs[2]){ + int zzi; + for(zzi=_zzi_start;zzi<_zzi_end;zzi++){ + int pli; + for(pli=0;pli<3;pli++){ + const unsigned char *dct_tokens; + const ogg_uint16_t *extra_bits; + ptrdiff_t ndct_tokens; + const th_huff_code *huff_codes; + ptrdiff_t ti; + dct_tokens=_enc->dct_tokens[pli][zzi]; + extra_bits=_enc->extra_bits[pli][zzi]; + ndct_tokens=_enc->ndct_tokens[pli][zzi]; + huff_codes=_enc->huff_codes[_huff_idxs[pli+1>>1]]; + for(ti=_enc->dct_token_offs[pli][zzi];tiopb,huff_codes[token].pattern, + huff_codes[token].nbits); + neb=OC_DCT_TOKEN_EXTRA_BITS[token]; + if(neb)oggpackB_write(&_enc->opb,extra_bits[ti],neb); + } + } + } +} + +static void oc_enc_residual_tokens_pack(oc_enc_ctx *_enc){ + static const unsigned char OC_HUFF_GROUP_MIN[6]={0,1,6,15,28,64}; + static const unsigned char *OC_HUFF_GROUP_MAX=OC_HUFF_GROUP_MIN+1; + ptrdiff_t token_counts_y[32]; + ptrdiff_t token_counts_c[32]; + size_t bits_y[16]; + size_t bits_c[16]; + int huff_idxs[2]; + int frame_type; + int hgi; + frame_type=_enc->state.frame_type; + /*Choose which Huffman tables to use for the DC token list.*/ + oc_enc_count_tokens(_enc,0,1,token_counts_y,token_counts_c); + memset(bits_y,0,sizeof(bits_y)); + memset(bits_c,0,sizeof(bits_c)); + oc_enc_count_bits(_enc,0,token_counts_y,bits_y); + oc_enc_count_bits(_enc,0,token_counts_c,bits_c); + huff_idxs[0]=oc_select_huff_idx(bits_y); + huff_idxs[1]=oc_select_huff_idx(bits_c); + /*Write the DC token list with the chosen tables.*/ + oggpackB_write(&_enc->opb,huff_idxs[0],4); + oggpackB_write(&_enc->opb,huff_idxs[1],4); + _enc->huff_idxs[frame_type][0][0]=(unsigned char)huff_idxs[0]; + _enc->huff_idxs[frame_type][0][1]=(unsigned char)huff_idxs[1]; + oc_enc_huff_group_pack(_enc,0,1,huff_idxs); + /*Choose which Huffman tables to use for the AC token lists.*/ + memset(bits_y,0,sizeof(bits_y)); + memset(bits_c,0,sizeof(bits_c)); + for(hgi=1;hgi<5;hgi++){ + oc_enc_count_tokens(_enc,OC_HUFF_GROUP_MIN[hgi],OC_HUFF_GROUP_MAX[hgi], + token_counts_y,token_counts_c); + oc_enc_count_bits(_enc,hgi,token_counts_y,bits_y); + oc_enc_count_bits(_enc,hgi,token_counts_c,bits_c); + } + huff_idxs[0]=oc_select_huff_idx(bits_y); + huff_idxs[1]=oc_select_huff_idx(bits_c); + /*Write the AC token lists using the chosen tables.*/ + oggpackB_write(&_enc->opb,huff_idxs[0],4); + oggpackB_write(&_enc->opb,huff_idxs[1],4); + _enc->huff_idxs[frame_type][1][0]=(unsigned char)huff_idxs[0]; + _enc->huff_idxs[frame_type][1][1]=(unsigned char)huff_idxs[1]; + for(hgi=1;hgi<5;hgi++){ + huff_idxs[0]+=16; + huff_idxs[1]+=16; + oc_enc_huff_group_pack(_enc, + OC_HUFF_GROUP_MIN[hgi],OC_HUFF_GROUP_MAX[hgi],huff_idxs); + } +} + +static void oc_enc_frame_pack(oc_enc_ctx *_enc){ + oggpackB_reset(&_enc->opb); + /*Only proceed if we have some coded blocks. + If there are no coded blocks, we can drop this frame simply by emitting a + 0 byte packet.*/ + if(_enc->state.ntotal_coded_fragis>0){ + oc_enc_frame_header_pack(_enc); + if(_enc->state.frame_type==OC_INTER_FRAME){ + /*Coded block flags, MB modes, and MVs are only needed for delta frames.*/ + oc_enc_coded_flags_pack(_enc); + oc_enc_mb_modes_pack(_enc); + oc_enc_mvs_pack(_enc); + } + oc_enc_block_qis_pack(_enc); + oc_enc_tokenize_finish(_enc); + oc_enc_residual_tokens_pack(_enc); + } + /*Success: Mark the packet as ready to be flushed.*/ + _enc->packet_state=OC_PACKET_READY; +#if defined(OC_COLLECT_METRICS) + oc_enc_mode_metrics_collect(_enc); +#endif +} + + +void oc_enc_vtable_init_c(oc_enc_ctx *_enc){ + /*The implementations prefixed with oc_enc_ are encoder-specific. + The rest we re-use from the decoder.*/ + _enc->opt_vtable.frag_sad=oc_enc_frag_sad_c; + _enc->opt_vtable.frag_sad_thresh=oc_enc_frag_sad_thresh_c; + _enc->opt_vtable.frag_sad2_thresh=oc_enc_frag_sad2_thresh_c; + _enc->opt_vtable.frag_satd_thresh=oc_enc_frag_satd_thresh_c; + _enc->opt_vtable.frag_satd2_thresh=oc_enc_frag_satd2_thresh_c; + _enc->opt_vtable.frag_intra_satd=oc_enc_frag_intra_satd_c; + _enc->opt_vtable.frag_sub=oc_enc_frag_sub_c; + _enc->opt_vtable.frag_sub_128=oc_enc_frag_sub_128_c; + _enc->opt_vtable.frag_copy2=oc_enc_frag_copy2_c; + _enc->opt_vtable.frag_recon_intra=oc_frag_recon_intra_c; + _enc->opt_vtable.frag_recon_inter=oc_frag_recon_inter_c; + _enc->opt_vtable.fdct8x8=oc_enc_fdct8x8_c; +} + +/*Initialize the macro block neighbor lists for MC analysis. + This assumes that the entire mb_info memory region has been initialized with + zeros.*/ +static void oc_enc_mb_info_init(oc_enc_ctx *_enc){ + oc_mb_enc_info *embs; + const signed char *mb_modes; + unsigned nhsbs; + unsigned nvsbs; + unsigned nhmbs; + unsigned nvmbs; + unsigned sby; + mb_modes=_enc->state.mb_modes; + embs=_enc->mb_info; + nhsbs=_enc->state.fplanes[0].nhsbs; + nvsbs=_enc->state.fplanes[0].nvsbs; + nhmbs=_enc->state.nhmbs; + nvmbs=_enc->state.nvmbs; + for(sby=0;sby>1); + mby=2*sby+(quadi+1>>1&1); + /*Fill in the neighbors with current motion vectors available.*/ + for(ni=0;ni=nhmbs||nmby<0||nmby>=nvmbs)continue; + nmbi=(nmby&~1)*nhmbs+((nmbx&~1)<<1)+OC_MB_MAP[nmby&1][nmbx&1]; + if(mb_modes[nmbi]==OC_MODE_INVALID)continue; + embs[mbi].cneighbors[embs[mbi].ncneighbors++]=nmbi; + } + /*Fill in the neighbors with previous motion vectors available.*/ + for(ni=0;ni<4;ni++){ + nmbx=mbx+PDX[ni]; + nmby=mby+PDY[ni]; + if(nmbx<0||nmbx>=nhmbs||nmby<0||nmby>=nvmbs)continue; + nmbi=(nmby&~1)*nhmbs+((nmbx&~1)<<1)+OC_MB_MAP[nmby&1][nmbx&1]; + if(mb_modes[nmbi]==OC_MODE_INVALID)continue; + embs[mbi].pneighbors[embs[mbi].npneighbors++]=nmbi; + } + } + } + } +} + +static int oc_enc_set_huffman_codes(oc_enc_ctx *_enc, + const th_huff_code _codes[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS]){ + int ret; + if(_enc==NULL)return TH_EFAULT; + if(_enc->packet_state>OC_PACKET_SETUP_HDR)return TH_EINVAL; + if(_codes==NULL)_codes=TH_VP31_HUFF_CODES; + /*Validate the codes.*/ + oggpackB_reset(&_enc->opb); + ret=oc_huff_codes_pack(&_enc->opb,_codes); + if(ret<0)return ret; + memcpy(_enc->huff_codes,_codes,sizeof(_enc->huff_codes)); + return 0; +} + +/*Sets the quantization parameters to use. + This may only be called before the setup header is written. + If it is called multiple times, only the last call has any effect. + _qinfo: The quantization parameters. + These are described in more detail in theoraenc.h. + This can be NULL, in which case the default quantization parameters + will be used.*/ +static int oc_enc_set_quant_params(oc_enc_ctx *_enc, + const th_quant_info *_qinfo){ + int qi; + int pli; + int qti; + if(_enc==NULL)return TH_EFAULT; + if(_enc->packet_state>OC_PACKET_SETUP_HDR)return TH_EINVAL; + if(_qinfo==NULL)_qinfo=&TH_DEF_QUANT_INFO; + /*TODO: Analyze for packing purposes instead of just doing a shallow copy.*/ + memcpy(&_enc->qinfo,_qinfo,sizeof(_enc->qinfo)); + for(qi=0;qi<64;qi++)for(pli=0;pli<3;pli++)for(qti=0;qti<2;qti++){ + _enc->state.dequant_tables[qi][pli][qti]= + _enc->state.dequant_table_data[qi][pli][qti]; + _enc->enquant_tables[qi][pli][qti]=_enc->enquant_table_data[qi][pli][qti]; + } + oc_enquant_tables_init(_enc->state.dequant_tables, + _enc->enquant_tables,_qinfo); + memcpy(_enc->state.loop_filter_limits,_qinfo->loop_filter_limits, + sizeof(_enc->state.loop_filter_limits)); + oc_enquant_qavg_init(_enc->log_qavg,_enc->state.dequant_tables, + _enc->state.info.pixel_fmt); + return 0; +} + +static void oc_enc_clear(oc_enc_ctx *_enc); + +static int oc_enc_init(oc_enc_ctx *_enc,const th_info *_info){ + th_info info; + size_t mcu_nmbs; + ptrdiff_t mcu_nfrags; + int hdec; + int vdec; + int ret; + int pli; + /*Clean up the requested settings.*/ + memcpy(&info,_info,sizeof(info)); + info.version_major=TH_VERSION_MAJOR; + info.version_minor=TH_VERSION_MINOR; + info.version_subminor=TH_VERSION_SUB; + if(info.quality>63)info.quality=63; + if(info.quality<0)info.quality=32; + if(info.target_bitrate<0)info.target_bitrate=0; + /*Initialize the shared encoder/decoder state.*/ + ret=oc_state_init(&_enc->state,&info,4); + if(ret<0)return ret; + _enc->mb_info=_ogg_calloc(_enc->state.nmbs,sizeof(*_enc->mb_info)); + _enc->frag_dc=_ogg_calloc(_enc->state.nfrags,sizeof(*_enc->frag_dc)); + _enc->coded_mbis= + (unsigned *)_ogg_malloc(_enc->state.nmbs*sizeof(*_enc->coded_mbis)); + hdec=!(_enc->state.info.pixel_fmt&1); + vdec=!(_enc->state.info.pixel_fmt&2); + /*If chroma is sub-sampled in the vertical direction, we have to encode two + super block rows of Y' for each super block row of Cb and Cr.*/ + _enc->mcu_nvsbs=1<mcu_nvsbs*_enc->state.fplanes[0].nhsbs*(size_t)4; + mcu_nfrags=4*mcu_nmbs+(8*mcu_nmbs>>hdec+vdec); + _enc->mcu_skip_ssd=(unsigned *)_ogg_malloc( + mcu_nfrags*sizeof(*_enc->mcu_skip_ssd)); + for(pli=0;pli<3;pli++){ + _enc->dct_tokens[pli]=(unsigned char **)oc_malloc_2d(64, + _enc->state.fplanes[pli].nfrags,sizeof(**_enc->dct_tokens)); + _enc->extra_bits[pli]=(ogg_uint16_t **)oc_malloc_2d(64, + _enc->state.fplanes[pli].nfrags,sizeof(**_enc->extra_bits)); + } +#if defined(OC_COLLECT_METRICS) + _enc->frag_satd=_ogg_calloc(_enc->state.nfrags,sizeof(*_enc->frag_satd)); + _enc->frag_ssd=_ogg_calloc(_enc->state.nfrags,sizeof(*_enc->frag_ssd)); +#endif +#if defined(OC_X86_ASM) + oc_enc_vtable_init_x86(_enc); +#else + oc_enc_vtable_init_c(_enc); +#endif + _enc->keyframe_frequency_force=1<<_enc->state.info.keyframe_granule_shift; + _enc->state.qis[0]=_enc->state.info.quality; + _enc->state.nqis=1; + oc_rc_state_init(&_enc->rc,_enc); + oggpackB_writeinit(&_enc->opb); + if(_enc->mb_info==NULL||_enc->frag_dc==NULL||_enc->coded_mbis==NULL|| + _enc->mcu_skip_ssd==NULL||_enc->dct_tokens[0]==NULL|| + _enc->dct_tokens[1]==NULL||_enc->dct_tokens[2]==NULL|| + _enc->extra_bits[0]==NULL||_enc->extra_bits[1]==NULL|| + _enc->extra_bits[2]==NULL +#if defined(OC_COLLECT_METRICS) + ||_enc->frag_satd==NULL||_enc->frag_ssd==NULL +#endif + ){ + oc_enc_clear(_enc); + return TH_EFAULT; + } + oc_mode_scheme_chooser_init(&_enc->chooser); + oc_enc_mb_info_init(_enc); + memset(_enc->huff_idxs,0,sizeof(_enc->huff_idxs)); + /*Reset the packet-out state machine.*/ + _enc->packet_state=OC_PACKET_INFO_HDR; + _enc->dup_count=0; + _enc->nqueued_dups=0; + _enc->prev_dup_count=0; + /*Enable speed optimizations up through early skip by default.*/ + _enc->sp_level=OC_SP_LEVEL_EARLY_SKIP; + /*Disable VP3 compatibility by default.*/ + _enc->vp3_compatible=0; + /*No INTER frames coded yet.*/ + _enc->coded_inter_frame=0; + memcpy(_enc->huff_codes,TH_VP31_HUFF_CODES,sizeof(_enc->huff_codes)); + oc_enc_set_quant_params(_enc,NULL); + return 0; +} + +static void oc_enc_clear(oc_enc_ctx *_enc){ + int pli; + oc_rc_state_clear(&_enc->rc); +#if defined(OC_COLLECT_METRICS) + oc_enc_mode_metrics_dump(_enc); +#endif + oggpackB_writeclear(&_enc->opb); +#if defined(OC_COLLECT_METRICS) + _ogg_free(_enc->frag_ssd); + _ogg_free(_enc->frag_satd); +#endif + for(pli=3;pli-->0;){ + oc_free_2d(_enc->extra_bits[pli]); + oc_free_2d(_enc->dct_tokens[pli]); + } + _ogg_free(_enc->mcu_skip_ssd); + _ogg_free(_enc->coded_mbis); + _ogg_free(_enc->frag_dc); + _ogg_free(_enc->mb_info); + oc_state_clear(&_enc->state); +} + +static void oc_enc_drop_frame(th_enc_ctx *_enc){ + /*Use the previous frame's reconstruction.*/ + _enc->state.ref_frame_idx[OC_FRAME_SELF]= + _enc->state.ref_frame_idx[OC_FRAME_PREV]; + /*Flag motion vector analysis about the frame drop.*/ + _enc->prevframe_dropped=1; + /*Zero the packet.*/ + oggpackB_reset(&_enc->opb); +} + +static void oc_enc_compress_keyframe(oc_enc_ctx *_enc,int _recode){ + if(_enc->state.info.target_bitrate>0){ + _enc->state.qis[0]=oc_enc_select_qi(_enc,OC_INTRA_FRAME, + _enc->state.curframe_num>0); + _enc->state.nqis=1; + } + oc_enc_calc_lambda(_enc,OC_INTRA_FRAME); + oc_enc_analyze_intra(_enc,_recode); + oc_enc_frame_pack(_enc); + /*On the first frame, the previous call was an initial dry-run to prime + feed-forward statistics.*/ + if(!_recode&&_enc->state.curframe_num==0){ + if(_enc->state.info.target_bitrate>0){ + oc_enc_update_rc_state(_enc,oggpackB_bytes(&_enc->opb)<<3, + OC_INTRA_FRAME,_enc->state.qis[0],1,0); + } + oc_enc_compress_keyframe(_enc,1); + } +} + +static void oc_enc_compress_frame(oc_enc_ctx *_enc,int _recode){ + if(_enc->state.info.target_bitrate>0){ + _enc->state.qis[0]=oc_enc_select_qi(_enc,OC_INTER_FRAME,1); + _enc->state.nqis=1; + } + oc_enc_calc_lambda(_enc,OC_INTER_FRAME); + if(oc_enc_analyze_inter(_enc,_enc->rc.twopass!=2,_recode)){ + /*Mode analysis thinks this should have been a keyframe; start over.*/ + oc_enc_compress_keyframe(_enc,1); + } + else{ + oc_enc_frame_pack(_enc); + if(!_enc->coded_inter_frame){ + /*On the first INTER frame, the previous call was an initial dry-run to + prime feed-forward statistics.*/ + _enc->coded_inter_frame=1; + if(_enc->state.info.target_bitrate>0){ + /*Rate control also needs to prime.*/ + oc_enc_update_rc_state(_enc,oggpackB_bytes(&_enc->opb)<<3, + OC_INTER_FRAME,_enc->state.qis[0],1,0); + } + oc_enc_compress_frame(_enc,1); + } + } +} + +/*Set the granule position for the next packet to output based on the current + internal state.*/ +static void oc_enc_set_granpos(oc_enc_ctx *_enc){ + unsigned dup_offs; + /*Add an offset for the number of duplicate frames we've emitted so far.*/ + dup_offs=_enc->prev_dup_count-_enc->nqueued_dups; + /*If the current frame was a keyframe, use it for the high part.*/ + if(_enc->state.frame_type==OC_INTRA_FRAME){ + _enc->state.granpos=(_enc->state.curframe_num+_enc->state.granpos_bias<< + _enc->state.info.keyframe_granule_shift)+dup_offs; + } + /*Otherwise use the last keyframe in the high part and put the current frame + in the low part.*/ + else{ + _enc->state.granpos= + (_enc->state.keyframe_num+_enc->state.granpos_bias<< + _enc->state.info.keyframe_granule_shift) + +_enc->state.curframe_num-_enc->state.keyframe_num+dup_offs; + } +} + + +th_enc_ctx *th_encode_alloc(const th_info *_info){ + oc_enc_ctx *enc; + if(_info==NULL)return NULL; + enc=_ogg_malloc(sizeof(*enc)); + if(enc==NULL||oc_enc_init(enc,_info)<0){ + _ogg_free(enc); + return NULL; + } + return enc; +} + +void th_encode_free(th_enc_ctx *_enc){ + if(_enc!=NULL){ + oc_enc_clear(_enc); + _ogg_free(_enc); + } +} + +int th_encode_ctl(th_enc_ctx *_enc,int _req,void *_buf,size_t _buf_sz){ + switch(_req){ + case TH_ENCCTL_SET_HUFFMAN_CODES:{ + if(_buf==NULL&&_buf_sz!=0|| + _buf!=NULL&&_buf_sz!=sizeof(th_huff_table)*TH_NHUFFMAN_TABLES){ + return TH_EINVAL; + } + return oc_enc_set_huffman_codes(_enc,(const th_huff_table *)_buf); + }break; + case TH_ENCCTL_SET_QUANT_PARAMS:{ + if(_buf==NULL&&_buf_sz!=0|| + _buf!=NULL&&_buf_sz!=sizeof(th_quant_info)){ + return TH_EINVAL; + } + return oc_enc_set_quant_params(_enc,(th_quant_info *)_buf); + }break; + case TH_ENCCTL_SET_KEYFRAME_FREQUENCY_FORCE:{ + ogg_uint32_t keyframe_frequency_force; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(keyframe_frequency_force))return TH_EINVAL; + keyframe_frequency_force=*(ogg_uint32_t *)_buf; + if(keyframe_frequency_force<=0)keyframe_frequency_force=1; + if(_enc->packet_state==OC_PACKET_INFO_HDR){ + /*It's still early enough to enlarge keyframe_granule_shift.*/ + _enc->state.info.keyframe_granule_shift=OC_CLAMPI( + _enc->state.info.keyframe_granule_shift, + OC_ILOG_32(keyframe_frequency_force-1),31); + } + _enc->keyframe_frequency_force=OC_MINI(keyframe_frequency_force, + (ogg_uint32_t)1U<<_enc->state.info.keyframe_granule_shift); + *(ogg_uint32_t *)_buf=_enc->keyframe_frequency_force; + return 0; + }break; + case TH_ENCCTL_SET_VP3_COMPATIBLE:{ + int vp3_compatible; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(vp3_compatible))return TH_EINVAL; + vp3_compatible=*(int *)_buf; + _enc->vp3_compatible=vp3_compatible; + if(oc_enc_set_huffman_codes(_enc,TH_VP31_HUFF_CODES)<0)vp3_compatible=0; + if(oc_enc_set_quant_params(_enc,&TH_VP31_QUANT_INFO)<0)vp3_compatible=0; + if(_enc->state.info.pixel_fmt!=TH_PF_420|| + _enc->state.info.pic_width<_enc->state.info.frame_width|| + _enc->state.info.pic_height<_enc->state.info.frame_height|| + /*If we have more than 4095 super blocks, VP3's RLE coding might + overflow. + We could overcome this by ensuring we flip the coded/not-coded flags on + at least one super block in the frame, but we pick the simple solution + of just telling the user the stream will be incompatible instead. + It's unlikely the old VP3 codec would be able to decode streams at this + resolution in real time in the first place.*/ + _enc->state.nsbs>4095){ + vp3_compatible=0; + } + *(int *)_buf=vp3_compatible; + return 0; + }break; + case TH_ENCCTL_GET_SPLEVEL_MAX:{ + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + *(int *)_buf=OC_SP_LEVEL_MAX; + return 0; + }break; + case TH_ENCCTL_SET_SPLEVEL:{ + int speed; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(speed))return TH_EINVAL; + speed=*(int *)_buf; + if(speed<0||speed>OC_SP_LEVEL_MAX)return TH_EINVAL; + _enc->sp_level=speed; + return 0; + }break; + case TH_ENCCTL_GET_SPLEVEL:{ + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(int))return TH_EINVAL; + *(int *)_buf=_enc->sp_level; + return 0; + } + case TH_ENCCTL_SET_DUP_COUNT:{ + int dup_count; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(dup_count))return TH_EINVAL; + dup_count=*(int *)_buf; + if(dup_count>=_enc->keyframe_frequency_force)return TH_EINVAL; + _enc->dup_count=OC_MAXI(dup_count,0); + return 0; + }break; + case TH_ENCCTL_SET_QUALITY:{ + int qi; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_enc->state.info.target_bitrate>0)return TH_EINVAL; + qi=*(int *)_buf; + if(qi<0||qi>63)return TH_EINVAL; + _enc->state.info.quality=qi; + _enc->state.qis[0]=(unsigned char)qi; + _enc->state.nqis=1; + return 0; + }break; + case TH_ENCCTL_SET_BITRATE:{ + long bitrate; + int reset; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + bitrate=*(long *)_buf; + if(bitrate<=0)return TH_EINVAL; + reset=_enc->state.info.target_bitrate<=0; + _enc->state.info.target_bitrate=bitrate>INT_MAX?INT_MAX:bitrate; + if(reset)oc_rc_state_init(&_enc->rc,_enc); + else oc_enc_rc_resize(_enc); + return 0; + }break; + case TH_ENCCTL_SET_RATE_FLAGS:{ + int set; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(set))return TH_EINVAL; + if(_enc->state.info.target_bitrate<=0)return TH_EINVAL; + set=*(int *)_buf; + _enc->rc.drop_frames=set&TH_RATECTL_DROP_FRAMES; + _enc->rc.cap_overflow=set&TH_RATECTL_CAP_OVERFLOW; + _enc->rc.cap_underflow=set&TH_RATECTL_CAP_UNDERFLOW; + return 0; + }break; + case TH_ENCCTL_SET_RATE_BUFFER:{ + int set; + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_buf_sz!=sizeof(set))return TH_EINVAL; + if(_enc->state.info.target_bitrate<=0)return TH_EINVAL; + set=*(int *)_buf; + _enc->rc.buf_delay=set; + oc_enc_rc_resize(_enc); + *(int *)_buf=_enc->rc.buf_delay; + return 0; + }break; + case TH_ENCCTL_2PASS_OUT:{ + if(_enc==NULL||_buf==NULL)return TH_EFAULT; + if(_enc->state.info.target_bitrate<=0|| + _enc->state.curframe_num>=0&&_enc->rc.twopass!=1|| + _buf_sz!=sizeof(unsigned char *)){ + return TH_EINVAL; + } + return oc_enc_rc_2pass_out(_enc,(unsigned char **)_buf); + }break; + case TH_ENCCTL_2PASS_IN:{ + if(_enc==NULL)return TH_EFAULT; + if(_enc->state.info.target_bitrate<=0|| + _enc->state.curframe_num>=0&&_enc->rc.twopass!=2){ + return TH_EINVAL; + } + return oc_enc_rc_2pass_in(_enc,_buf,_buf_sz); + }break; + default:return TH_EIMPL; + } +} + +int th_encode_flushheader(th_enc_ctx *_enc,th_comment *_tc,ogg_packet *_op){ + if(_enc==NULL)return TH_EFAULT; + return oc_state_flushheader(&_enc->state,&_enc->packet_state,&_enc->opb, + &_enc->qinfo,(const th_huff_table *)_enc->huff_codes,th_version_string(), + _tc,_op); +} + +static void oc_img_plane_copy_pad(th_img_plane *_dst,th_img_plane *_src, + ogg_int32_t _pic_x,ogg_int32_t _pic_y, + ogg_int32_t _pic_width,ogg_int32_t _pic_height){ + unsigned char *dst; + int dstride; + ogg_uint32_t frame_width; + ogg_uint32_t frame_height; + ogg_uint32_t y; + frame_width=_dst->width; + frame_height=_dst->height; + /*If we have _no_ data, just encode a dull green.*/ + if(_pic_width==0||_pic_height==0){ + dst=_dst->data; + dstride=_dst->stride; + for(y=0;ystride; + sstride=_src->stride; + dst_data=_dst->data; + src_data=_src->data; + dst=dst_data+_pic_y*(ptrdiff_t)dstride+_pic_x; + src=src_data+_pic_y*(ptrdiff_t)sstride+_pic_x; + for(y=0;y<_pic_height;y++){ + memcpy(dst,src,_pic_width); + dst+=dstride; + src+=sstride; + } + /*Step 2: Perform a low-pass extension into the padding region.*/ + /*Left side.*/ + for(x=_pic_x;x-->0;){ + dst=dst_data+_pic_y*(ptrdiff_t)dstride+x; + for(y=0;y<_pic_height;y++){ + dst[0]=(dst[1]<<1)+(dst-(dstride&-(y>0)))[1] + +(dst+(dstride&-(y+1<_pic_height)))[1]+2>>2; + dst+=dstride; + } + } + /*Right side.*/ + for(x=_pic_x+_pic_width;x0)))[0] + +(dst+(dstride&-(y+1<_pic_height)))[0]+2>>2; + dst+=dstride; + } + } + /*Top.*/ + dst=dst_data+_pic_y*(ptrdiff_t)dstride; + for(y=_pic_y;y-->0;){ + for(x=0;x0)] + +dst[x+(x+1>2; + } + dst-=dstride; + } + /*Bottom.*/ + dst=dst_data+(_pic_y+_pic_height)*(ptrdiff_t)dstride; + for(y=_pic_y+_pic_height;y0)] + +(dst-dstride)[x+(x+1>2; + } + dst+=dstride; + } + } +} + +int th_encode_ycbcr_in(th_enc_ctx *_enc,th_ycbcr_buffer _img){ + th_ycbcr_buffer img; + int cframe_width; + int cframe_height; + int cpic_width; + int cpic_height; + int cpic_x; + int cpic_y; + int hdec; + int vdec; + int pli; + int refi; + int drop; + /*Step 1: validate parameters.*/ + if(_enc==NULL||_img==NULL)return TH_EFAULT; + if(_enc->packet_state==OC_PACKET_DONE)return TH_EINVAL; + if(_enc->rc.twopass&&_enc->rc.twopass_buffer_bytes==0)return TH_EINVAL; + hdec=!(_enc->state.info.pixel_fmt&1); + vdec=!(_enc->state.info.pixel_fmt&2); + cframe_width=_enc->state.info.frame_width>>hdec; + cframe_height=_enc->state.info.frame_height>>vdec; + cpic_x=_enc->state.info.pic_x>>hdec; + cpic_y=_enc->state.info.pic_y>>vdec; + cpic_width=(_enc->state.info.pic_x+_enc->state.info.pic_width+hdec>>hdec) + -cpic_x; + cpic_height=(_enc->state.info.pic_y+_enc->state.info.pic_height+vdec>>vdec) + -cpic_y; + /*Flip the input buffer upside down.*/ + oc_ycbcr_buffer_flip(img,_img); + if((ogg_uint32_t)img[0].width!=_enc->state.info.frame_width|| + (ogg_uint32_t)img[0].height!=_enc->state.info.frame_height|| + img[1].width!=cframe_width||img[2].width!=cframe_width|| + img[1].height!=cframe_height||img[2].height!=cframe_height){ + /*The buffer does not match the frame size. + Check to see if it matches the picture size.*/ + if((ogg_uint32_t)img[0].width!=_enc->state.info.pic_width|| + (ogg_uint32_t)img[0].height!=_enc->state.info.pic_height|| + img[1].width!=cpic_width||img[2].width!=cpic_width|| + img[1].height!=cpic_height||img[2].height!=cpic_height){ + /*It doesn't; we don't know how to handle it.*/ + return TH_EINVAL; + } + /*Adjust the pointers to address a full frame. + We still only use the picture region, however.*/ + img[0].data-=_enc->state.info.pic_y*(ptrdiff_t)img[0].stride + +_enc->state.info.pic_x; + img[1].data-=cpic_y*(ptrdiff_t)img[1].stride+cpic_x; + img[2].data-=cpic_y*(ptrdiff_t)img[2].stride+cpic_x; + } + /*Step 2: Copy the input to our internal buffer. + This lets us add padding, if necessary, so we don't have to worry about + dereferencing possibly invalid addresses, and allows us to use the same + strides and fragment offsets for both the input frame and the reference + frames.*/ + oc_img_plane_copy_pad(_enc->state.ref_frame_bufs[OC_FRAME_IO]+0,img+0, + _enc->state.info.pic_x,_enc->state.info.pic_y, + _enc->state.info.pic_width,_enc->state.info.pic_height); + for(pli=1;pli<3;pli++){ + oc_img_plane_copy_pad(_enc->state.ref_frame_bufs[OC_FRAME_IO]+pli,img+pli, + cpic_x,cpic_y,cpic_width,cpic_height); + } + /*Step 3: Update the buffer state.*/ + if(_enc->state.ref_frame_idx[OC_FRAME_SELF]>=0){ + _enc->state.ref_frame_idx[OC_FRAME_PREV]= + _enc->state.ref_frame_idx[OC_FRAME_SELF]; + if(_enc->state.frame_type==OC_INTRA_FRAME){ + /*The new frame becomes both the previous and gold reference frames.*/ + _enc->state.keyframe_num=_enc->state.curframe_num; + _enc->state.ref_frame_idx[OC_FRAME_GOLD]= + _enc->state.ref_frame_idx[OC_FRAME_SELF]; + } + } + /*Select a free buffer to use for the reconstructed version of this frame.*/ + for(refi=0;refi==_enc->state.ref_frame_idx[OC_FRAME_GOLD]|| + refi==_enc->state.ref_frame_idx[OC_FRAME_PREV];refi++); + _enc->state.ref_frame_idx[OC_FRAME_SELF]=refi; + _enc->state.curframe_num+=_enc->prev_dup_count+1; + /*Step 4: Compress the frame.*/ + /*Start with a keyframe, and don't allow the generation of invalid files that + overflow the keyframe_granule_shift.*/ + if(_enc->rc.twopass_force_kf||_enc->state.curframe_num==0|| + _enc->state.curframe_num-_enc->state.keyframe_num+_enc->dup_count>= + _enc->keyframe_frequency_force){ + oc_enc_compress_keyframe(_enc,0); + drop=0; + } + else{ + oc_enc_compress_frame(_enc,0); + drop=1; + } + oc_restore_fpu(&_enc->state); + /*drop currently indicates if the frame is droppable.*/ + if(_enc->state.info.target_bitrate>0){ + drop=oc_enc_update_rc_state(_enc,oggpackB_bytes(&_enc->opb)<<3, + _enc->state.frame_type,_enc->state.qis[0],0,drop); + } + else drop=0; + /*drop now indicates if the frame was dropped.*/ + if(drop)oc_enc_drop_frame(_enc); + else _enc->prevframe_dropped=0; + _enc->packet_state=OC_PACKET_READY; + _enc->prev_dup_count=_enc->nqueued_dups=_enc->dup_count; + _enc->dup_count=0; +#if defined(OC_DUMP_IMAGES) + oc_enc_set_granpos(_enc); + oc_state_dump_frame(&_enc->state,OC_FRAME_IO,"src"); + oc_state_dump_frame(&_enc->state,OC_FRAME_SELF,"rec"); +#endif + return 0; +} + +int th_encode_packetout(th_enc_ctx *_enc,int _last_p,ogg_packet *_op){ + if(_enc==NULL||_op==NULL)return TH_EFAULT; + if(_enc->packet_state==OC_PACKET_READY){ + _enc->packet_state=OC_PACKET_EMPTY; + if(_enc->rc.twopass!=1){ + unsigned char *packet; + packet=oggpackB_get_buffer(&_enc->opb); + /*If there's no packet, malloc failed while writing; it's lost forever.*/ + if(packet==NULL)return TH_EFAULT; + _op->packet=packet; + _op->bytes=oggpackB_bytes(&_enc->opb); + } + /*For the first pass in 2-pass mode, don't emit any packet data.*/ + else{ + _op->packet=NULL; + _op->bytes=0; + } + } + else if(_enc->packet_state==OC_PACKET_EMPTY){ + if(_enc->nqueued_dups>0){ + _enc->nqueued_dups--; + _op->packet=NULL; + _op->bytes=0; + } + else{ + if(_last_p)_enc->packet_state=OC_PACKET_DONE; + return 0; + } + } + else return 0; + _last_p=_last_p&&_enc->nqueued_dups<=0; + _op->b_o_s=0; + _op->e_o_s=_last_p; + oc_enc_set_granpos(_enc); + _op->packetno=th_granule_frame(_enc,_enc->state.granpos)+3; + _op->granulepos=_enc->state.granpos; + if(_last_p)_enc->packet_state=OC_PACKET_DONE; + return 1+_enc->nqueued_dups; +} diff --git a/libs/libtheora-1.1/lib/encoder_disabled.c b/libs/libtheora-1.1/lib/encoder_disabled.c new file mode 100644 index 00000000..6092edaf --- /dev/null +++ b/libs/libtheora-1.1/lib/encoder_disabled.c @@ -0,0 +1,67 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: encoder_disabled.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include "apiwrapper.h" +#include "encint.h" + +th_enc_ctx *th_encode_alloc(const th_info *_info){ + return NULL; +} + +void th_encode_free(th_enc_ctx *_enc){} + + +int th_encode_ctl(th_enc_ctx *_enc,int _req,void *_buf,size_t _buf_sz){ + return OC_DISABLED; +} + +int th_encode_flushheader(th_enc_ctx *_enc,th_comment *_tc,ogg_packet *_op){ + return OC_DISABLED; +} + +int th_encode_ycbcr_in(th_enc_ctx *_enc,th_ycbcr_buffer _img){ + return OC_DISABLED; +} + +int th_encode_packetout(th_enc_ctx *_enc,int _last_p,ogg_packet *_op){ + return OC_DISABLED; +} + + + +int theora_encode_init(theora_state *_te,theora_info *_ci){ + return OC_DISABLED; +} + +int theora_encode_YUVin(theora_state *_te,yuv_buffer *_yuv){ + return OC_DISABLED; +} + +int theora_encode_packetout(theora_state *_te,int _last_p,ogg_packet *_op){ + return OC_DISABLED; +} + +int theora_encode_header(theora_state *_te,ogg_packet *_op){ + return OC_DISABLED; +} + +int theora_encode_comment(theora_comment *_tc,ogg_packet *_op){ + return OC_DISABLED; +} + +int theora_encode_tables(theora_state *_te,ogg_packet *_op){ + return OC_DISABLED; +} diff --git a/libs/libtheora-1.1/lib/enquant.c b/libs/libtheora-1.1/lib/enquant.c new file mode 100644 index 00000000..0759c92b --- /dev/null +++ b/libs/libtheora-1.1/lib/enquant.c @@ -0,0 +1,274 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: enquant.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include +#include "encint.h" + + + +void oc_quant_params_pack(oggpack_buffer *_opb,const th_quant_info *_qinfo){ + const th_quant_ranges *qranges; + const th_quant_base *base_mats[2*3*64]; + int indices[2][3][64]; + int nbase_mats; + int nbits; + int ci; + int qi; + int qri; + int qti; + int pli; + int qtj; + int plj; + int bmi; + int i; + i=_qinfo->loop_filter_limits[0]; + for(qi=1;qi<64;qi++)i=OC_MAXI(i,_qinfo->loop_filter_limits[qi]); + nbits=OC_ILOG_32(i); + oggpackB_write(_opb,nbits,3); + for(qi=0;qi<64;qi++){ + oggpackB_write(_opb,_qinfo->loop_filter_limits[qi],nbits); + } + /*580 bits for VP3.*/ + i=1; + for(qi=0;qi<64;qi++)i=OC_MAXI(_qinfo->ac_scale[qi],i); + nbits=OC_ILOGNZ_32(i); + oggpackB_write(_opb,nbits-1,4); + for(qi=0;qi<64;qi++)oggpackB_write(_opb,_qinfo->ac_scale[qi],nbits); + /*516 bits for VP3.*/ + i=1; + for(qi=0;qi<64;qi++)i=OC_MAXI(_qinfo->dc_scale[qi],i); + nbits=OC_ILOGNZ_32(i); + oggpackB_write(_opb,nbits-1,4); + for(qi=0;qi<64;qi++)oggpackB_write(_opb,_qinfo->dc_scale[qi],nbits); + /*Consolidate any duplicate base matrices.*/ + nbase_mats=0; + for(qti=0;qti<2;qti++)for(pli=0;pli<3;pli++){ + qranges=_qinfo->qi_ranges[qti]+pli; + for(qri=0;qri<=qranges->nranges;qri++){ + for(bmi=0;;bmi++){ + if(bmi>=nbase_mats){ + base_mats[bmi]=qranges->base_matrices+qri; + indices[qti][pli][qri]=nbase_mats++; + break; + } + else if(memcmp(base_mats[bmi][0],qranges->base_matrices[qri], + sizeof(base_mats[bmi][0]))==0){ + indices[qti][pli][qri]=bmi; + break; + } + } + } + } + /*Write out the list of unique base matrices. + 1545 bits for VP3 matrices.*/ + oggpackB_write(_opb,nbase_mats-1,9); + for(bmi=0;bmiqi_ranges[qti]+pli; + if(i>0){ + if(qti>0){ + if(qranges->nranges==_qinfo->qi_ranges[qti-1][pli].nranges&& + memcmp(qranges->sizes,_qinfo->qi_ranges[qti-1][pli].sizes, + qranges->nranges*sizeof(qranges->sizes[0]))==0&& + memcmp(indices[qti][pli],indices[qti-1][pli], + (qranges->nranges+1)*sizeof(indices[qti][pli][0]))==0){ + oggpackB_write(_opb,1,2); + continue; + } + } + qtj=(i-1)/3; + plj=(i-1)%3; + if(qranges->nranges==_qinfo->qi_ranges[qtj][plj].nranges&& + memcmp(qranges->sizes,_qinfo->qi_ranges[qtj][plj].sizes, + qranges->nranges*sizeof(qranges->sizes[0]))==0&& + memcmp(indices[qti][pli],indices[qtj][plj], + (qranges->nranges+1)*sizeof(indices[qti][pli][0]))==0){ + oggpackB_write(_opb,0,1+(qti>0)); + continue; + } + oggpackB_write(_opb,1,1); + } + oggpackB_write(_opb,indices[qti][pli][0],nbits); + for(qi=qri=0;qi<63;qri++){ + oggpackB_write(_opb,qranges->sizes[qri]-1,OC_ILOG_32(62-qi)); + qi+=qranges->sizes[qri]; + oggpackB_write(_opb,indices[qti][pli][qri+1],nbits); + } + } +} + +static void oc_iquant_init(oc_iquant *_this,ogg_uint16_t _d){ + ogg_uint32_t t; + int l; + _d<<=1; + l=OC_ILOGNZ_32(_d)-1; + t=1+((ogg_uint32_t)1<<16+l)/_d; + _this->m=(ogg_int16_t)(t-0x10000); + _this->l=l; +} + +/*See comments at oc_dequant_tables_init() for how the quantization tables' + storage should be initialized.*/ +void oc_enquant_tables_init(ogg_uint16_t *_dequant[64][3][2], + oc_iquant *_enquant[64][3][2],const th_quant_info *_qinfo){ + int qi; + int pli; + int qti; + /*Initialize the dequantization tables first.*/ + oc_dequant_tables_init(_dequant,NULL,_qinfo); + /*Derive the quantization tables directly from the dequantization tables.*/ + for(qi=0;qi<64;qi++)for(qti=0;qti<2;qti++)for(pli=0;pli<3;pli++){ + int zzi; + int plj; + int qtj; + int dupe; + dupe=0; + for(qtj=0;qtj<=qti;qtj++){ + for(plj=0;plj<(qtj>1))/qd; + qp+=rq*(ogg_uint32_t)rq; + } + q2+=OC_PCD[_pixel_fmt][pli]*(ogg_int64_t)qp; + } + /*qavg=1.0/sqrt(q2).*/ + _log_qavg[qti][qi]=OC_Q57(48)-oc_blog64(q2)>>1; + } +} diff --git a/libs/libtheora-1.1/lib/enquant.h b/libs/libtheora-1.1/lib/enquant.h new file mode 100644 index 00000000..d62df10d --- /dev/null +++ b/libs/libtheora-1.1/lib/enquant.h @@ -0,0 +1,27 @@ +#if !defined(_enquant_H) +# define _enquant_H (1) +# include "quant.h" + +typedef struct oc_iquant oc_iquant; + +#define OC_QUANT_MAX_LOG (OC_Q57(OC_STATIC_ILOG_32(OC_QUANT_MAX)-1)) + +/*Used to compute x/d via ((x*m>>16)+x>>l)+(x<0)) + (i.e., one 16x16->16 mul, 2 shifts, and 2 adds). + This is not an approximation; for 16-bit x and d, it is exact.*/ +struct oc_iquant{ + ogg_int16_t m; + ogg_int16_t l; +}; + +typedef oc_iquant oc_iquant_table[64]; + + + +void oc_quant_params_pack(oggpack_buffer *_opb,const th_quant_info *_qinfo); +void oc_enquant_tables_init(ogg_uint16_t *_dequant[64][3][2], + oc_iquant *_enquant[64][3][2],const th_quant_info *_qinfo); +void oc_enquant_qavg_init(ogg_int64_t _log_qavg[2][64], + ogg_uint16_t *_dequant[64][3][2],int _pixel_fmt); + +#endif diff --git a/libs/libtheora-1.1/lib/fdct.c b/libs/libtheora-1.1/lib/fdct.c new file mode 100644 index 00000000..7ad17968 --- /dev/null +++ b/libs/libtheora-1.1/lib/fdct.c @@ -0,0 +1,422 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: fdct.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include "encint.h" +#include "dct.h" + + + +/*Performs a forward 8 point Type-II DCT transform. + The output is scaled by a factor of 2 from the orthonormal version of the + transform. + _y: The buffer to store the result in. + Data will be placed the first 8 entries (e.g., in a row of an 8x8 block). + _x: The input coefficients. + Every 8th entry is used (e.g., from a column of an 8x8 block).*/ +static void oc_fdct8(ogg_int16_t _y[8],const ogg_int16_t *_x){ + int t0; + int t1; + int t2; + int t3; + int t4; + int t5; + int t6; + int t7; + int r; + int s; + int u; + int v; + /*Stage 1:*/ + /*0-7 butterfly.*/ + t0=_x[0<<3]+(int)_x[7<<3]; + t7=_x[0<<3]-(int)_x[7<<3]; + /*1-6 butterfly.*/ + t1=_x[1<<3]+(int)_x[6<<3]; + t6=_x[1<<3]-(int)_x[6<<3]; + /*2-5 butterfly.*/ + t2=_x[2<<3]+(int)_x[5<<3]; + t5=_x[2<<3]-(int)_x[5<<3]; + /*3-4 butterfly.*/ + t3=_x[3<<3]+(int)_x[4<<3]; + t4=_x[3<<3]-(int)_x[4<<3]; + /*Stage 2:*/ + /*0-3 butterfly.*/ + r=t0+t3; + t3=t0-t3; + t0=r; + /*1-2 butterfly.*/ + r=t1+t2; + t2=t1-t2; + t1=r; + /*6-5 butterfly.*/ + r=t6+t5; + t5=t6-t5; + t6=r; + /*Stages 3 and 4 are where all the approximation occurs. + These are chosen to be as close to an exact inverse of the approximations + made in the iDCT as possible, while still using mostly 16-bit arithmetic. + We use some 16x16->32 signed MACs, but those still commonly execute in 1 + cycle on a 16-bit DSP. + For example, s=(27146*t5+0x4000>>16)+t5+(t5!=0) is an exact inverse of + t5=(OC_C4S4*s>>16). + That is, applying the latter to the output of the former will recover t5 + exactly (over the valid input range of t5, -23171...23169). + We increase the rounding bias to 0xB500 in this particular case so that + errors inverting the subsequent butterfly are not one-sided (e.g., the + mean error is very close to zero). + The (t5!=0) term could be replaced simply by 1, but we want to send 0 to 0. + The fDCT of an all-zeros block will still not be zero, because of the + biases we added at the very beginning of the process, but it will be close + enough that it is guaranteed to round to zero.*/ + /*Stage 3:*/ + /*4-5 butterfly.*/ + s=(27146*t5+0xB500>>16)+t5+(t5!=0)>>1; + r=t4+s; + t5=t4-s; + t4=r; + /*7-6 butterfly.*/ + s=(27146*t6+0xB500>>16)+t6+(t6!=0)>>1; + r=t7+s; + t6=t7-s; + t7=r; + /*Stage 4:*/ + /*0-1 butterfly.*/ + r=(27146*t0+0x4000>>16)+t0+(t0!=0); + s=(27146*t1+0xB500>>16)+t1+(t1!=0); + u=r+s>>1; + v=r-u; + _y[0]=u; + _y[4]=v; + /*3-2 rotation by 6pi/16*/ + u=(OC_C6S2*t2+OC_C2S6*t3+0x6CB7>>16)+(t3!=0); + s=(OC_C6S2*u>>16)-t2; + v=(s*21600+0x2800>>18)+s+(s!=0); + _y[2]=u; + _y[6]=v; + /*6-5 rotation by 3pi/16*/ + u=(OC_C5S3*t6+OC_C3S5*t5+0x0E3D>>16)+(t5!=0); + s=t6-(OC_C5S3*u>>16); + v=(s*26568+0x3400>>17)+s+(s!=0); + _y[5]=u; + _y[3]=v; + /*7-4 rotation by 7pi/16*/ + u=(OC_C7S1*t4+OC_C1S7*t7+0x7B1B>>16)+(t7!=0); + s=(OC_C7S1*u>>16)-t4; + v=(s*20539+0x3000>>20)+s+(s!=0); + _y[1]=u; + _y[7]=v; +} + +void oc_enc_fdct8x8(const oc_enc_ctx *_enc,ogg_int16_t _y[64], + const ogg_int16_t _x[64]){ + (*_enc->opt_vtable.fdct8x8)(_y,_x); +} + +/*Performs a forward 8x8 Type-II DCT transform. + The output is scaled by a factor of 4 relative to the orthonormal version + of the transform. + _y: The buffer to store the result in. + This may be the same as _x. + _x: The input coefficients. */ +void oc_enc_fdct8x8_c(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + const ogg_int16_t *in; + ogg_int16_t *end; + ogg_int16_t *out; + ogg_int16_t w[64]; + int i; + /*Add two extra bits of working precision to improve accuracy; any more and + we could overflow.*/ + for(i=0;i<64;i++)w[i]=_x[i]<<2; + /*These biases correct for some systematic error that remains in the full + fDCT->iDCT round trip.*/ + w[0]+=(w[0]!=0)+1; + w[1]++; + w[8]--; + /*Transform columns of w into rows of _y.*/ + for(in=w,out=_y,end=out+64;out>2; +} + + + +/*This does not seem to outperform simple LFE border padding before MC. + It yields higher PSNR, but much higher bitrate usage.*/ +#if 0 +typedef struct oc_extension_info oc_extension_info; + + + +/*Information needed to pad boundary blocks. + We multiply each row/column by an extension matrix that fills in the padding + values as a linear combination of the active values, so that an equivalent + number of coefficients are forced to zero. + This costs at most 16 multiplies, the same as a 1-D fDCT itself, and as + little as 7 multiplies. + We compute the extension matrices for every possible shape in advance, as + there are only 35. + The coefficients for all matrices are stored in a single array to take + advantage of the overlap and repetitiveness of many of the shapes. + A similar technique is applied to the offsets into this array. + This reduces the required table storage by about 48%. + See tools/extgen.c for details. + We could conceivably do the same for all 256 possible shapes.*/ +struct oc_extension_info{ + /*The mask of the active pixels in the shape.*/ + short mask; + /*The number of active pixels in the shape.*/ + short na; + /*The extension matrix. + This is (8-na)xna*/ + const ogg_int16_t *const *ext; + /*The pixel indices: na active pixels followed by 8-na padding pixels.*/ + unsigned char pi[8]; + /*The coefficient indices: na unconstrained coefficients followed by 8-na + coefficients to be forced to zero.*/ + unsigned char ci[8]; +}; + + +/*The number of shapes we need.*/ +#define OC_NSHAPES (35) + +static const ogg_int16_t OC_EXT_COEFFS[229]={ + 0x7FFF,0xE1F8,0x6903,0xAA79,0x5587,0x7FFF,0x1E08,0x7FFF, + 0x5587,0xAA79,0x6903,0xE1F8,0x7FFF,0x0000,0x0000,0x0000, + 0x7FFF,0x0000,0x0000,0x7FFF,0x8000,0x7FFF,0x0000,0x0000, + 0x7FFF,0xE1F8,0x1E08,0xB0A7,0xAA1D,0x337C,0x7FFF,0x4345, + 0x2267,0x4345,0x7FFF,0x337C,0xAA1D,0xB0A7,0x8A8C,0x4F59, + 0x03B4,0xE2D6,0x7FFF,0x2CF3,0x7FFF,0xE2D6,0x03B4,0x4F59, + 0x8A8C,0x1103,0x7AEF,0x5225,0xDF60,0xC288,0xDF60,0x5225, + 0x7AEF,0x1103,0x668A,0xD6EE,0x3A16,0x0E6C,0xFA07,0x0E6C, + 0x3A16,0xD6EE,0x668A,0x2A79,0x2402,0x980F,0x50F5,0x4882, + 0x50F5,0x980F,0x2402,0x2A79,0xF976,0x2768,0x5F22,0x2768, + 0xF976,0x1F91,0x76C1,0xE9AE,0x76C1,0x1F91,0x7FFF,0xD185, + 0x0FC8,0xD185,0x7FFF,0x4F59,0x4345,0xED62,0x4345,0x4F59, + 0xF574,0x5D99,0x2CF3,0x5D99,0xF574,0x5587,0x3505,0x30FC, + 0xF482,0x953C,0xEAC4,0x7FFF,0x4F04,0x7FFF,0xEAC4,0x953C, + 0xF482,0x30FC,0x4F04,0x273D,0xD8C3,0x273D,0x1E09,0x61F7, + 0x1E09,0x273D,0xD8C3,0x273D,0x4F04,0x30FC,0xA57E,0x153C, + 0x6AC4,0x3C7A,0x1E08,0x3C7A,0x6AC4,0x153C,0xA57E,0x7FFF, + 0xA57E,0x5A82,0x6AC4,0x153C,0xC386,0xE1F8,0xC386,0x153C, + 0x6AC4,0x5A82,0xD8C3,0x273D,0x7FFF,0xE1F7,0x7FFF,0x273D, + 0xD8C3,0x4F04,0x30FC,0xD8C3,0x273D,0xD8C3,0x30FC,0x4F04, + 0x1FC8,0x67AD,0x1853,0xE038,0x1853,0x67AD,0x1FC8,0x4546, + 0xE038,0x1FC8,0x3ABA,0x1FC8,0xE038,0x4546,0x3505,0x5587, + 0xF574,0xBC11,0x78F4,0x4AFB,0xE6F3,0x4E12,0x3C11,0xF8F4, + 0x4AFB,0x3C7A,0xF88B,0x3C11,0x78F4,0xCAFB,0x7FFF,0x08CC, + 0x070C,0x236D,0x5587,0x236D,0x070C,0xF88B,0x3C7A,0x4AFB, + 0xF8F4,0x3C11,0x7FFF,0x153C,0xCAFB,0x153C,0x7FFF,0x1E08, + 0xE1F8,0x7FFF,0x08CC,0x7FFF,0xCAFB,0x78F4,0x3C11,0x4E12, + 0xE6F3,0x4AFB,0x78F4,0xBC11,0xFE3D,0x7FFF,0xFE3D,0x2F3A, + 0x7FFF,0x2F3A,0x89BC,0x7FFF,0x89BC +}; + +static const ogg_int16_t *const OC_EXT_ROWS[96]={ + OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 0, + OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 0,OC_EXT_COEFFS+ 6, + OC_EXT_COEFFS+ 27,OC_EXT_COEFFS+ 38,OC_EXT_COEFFS+ 43,OC_EXT_COEFFS+ 32, + OC_EXT_COEFFS+ 49,OC_EXT_COEFFS+ 58,OC_EXT_COEFFS+ 67,OC_EXT_COEFFS+ 71, + OC_EXT_COEFFS+ 62,OC_EXT_COEFFS+ 53,OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 15, + OC_EXT_COEFFS+ 14,OC_EXT_COEFFS+ 13,OC_EXT_COEFFS+ 76,OC_EXT_COEFFS+ 81, + OC_EXT_COEFFS+ 86,OC_EXT_COEFFS+ 91,OC_EXT_COEFFS+ 96,OC_EXT_COEFFS+ 98, + OC_EXT_COEFFS+ 93,OC_EXT_COEFFS+ 88,OC_EXT_COEFFS+ 83,OC_EXT_COEFFS+ 78, + OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 15,OC_EXT_COEFFS+ 15,OC_EXT_COEFFS+ 12, + OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 15,OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 15, + OC_EXT_COEFFS+ 15,OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 103,OC_EXT_COEFFS+ 108, + OC_EXT_COEFFS+ 126,OC_EXT_COEFFS+ 16,OC_EXT_COEFFS+ 137,OC_EXT_COEFFS+ 141, + OC_EXT_COEFFS+ 20,OC_EXT_COEFFS+ 130,OC_EXT_COEFFS+ 113,OC_EXT_COEFFS+ 116, + OC_EXT_COEFFS+ 146,OC_EXT_COEFFS+ 153,OC_EXT_COEFFS+ 160,OC_EXT_COEFFS+ 167, + OC_EXT_COEFFS+ 170,OC_EXT_COEFFS+ 163,OC_EXT_COEFFS+ 156,OC_EXT_COEFFS+ 149, + OC_EXT_COEFFS+ 119,OC_EXT_COEFFS+ 122,OC_EXT_COEFFS+ 174,OC_EXT_COEFFS+ 177, + OC_EXT_COEFFS+ 182,OC_EXT_COEFFS+ 187,OC_EXT_COEFFS+ 192,OC_EXT_COEFFS+ 197, + OC_EXT_COEFFS+ 202,OC_EXT_COEFFS+ 207,OC_EXT_COEFFS+ 210,OC_EXT_COEFFS+ 215, + OC_EXT_COEFFS+ 179,OC_EXT_COEFFS+ 189,OC_EXT_COEFFS+ 24,OC_EXT_COEFFS+ 204, + OC_EXT_COEFFS+ 184,OC_EXT_COEFFS+ 194,OC_EXT_COEFFS+ 212,OC_EXT_COEFFS+ 199, + OC_EXT_COEFFS+ 217,OC_EXT_COEFFS+ 100,OC_EXT_COEFFS+ 134,OC_EXT_COEFFS+ 135, + OC_EXT_COEFFS+ 135,OC_EXT_COEFFS+ 12,OC_EXT_COEFFS+ 15,OC_EXT_COEFFS+ 134, + OC_EXT_COEFFS+ 134,OC_EXT_COEFFS+ 135,OC_EXT_COEFFS+ 220,OC_EXT_COEFFS+ 223, + OC_EXT_COEFFS+ 226,OC_EXT_COEFFS+ 227,OC_EXT_COEFFS+ 224,OC_EXT_COEFFS+ 221 +}; + +static const oc_extension_info OC_EXTENSION_INFO[OC_NSHAPES]={ + {0x7F,7,OC_EXT_ROWS+ 0,{0,1,2,3,4,5,6,7},{0,1,2,4,5,6,7,3}}, + {0xFE,7,OC_EXT_ROWS+ 7,{1,2,3,4,5,6,7,0},{0,1,2,4,5,6,7,3}}, + {0x3F,6,OC_EXT_ROWS+ 8,{0,1,2,3,4,5,7,6},{0,1,3,4,6,7,5,2}}, + {0xFC,6,OC_EXT_ROWS+ 10,{2,3,4,5,6,7,1,0},{0,1,3,4,6,7,5,2}}, + {0x1F,5,OC_EXT_ROWS+ 12,{0,1,2,3,4,7,6,5},{0,2,3,5,7,6,4,1}}, + {0xF8,5,OC_EXT_ROWS+ 15,{3,4,5,6,7,2,1,0},{0,2,3,5,7,6,4,1}}, + {0x0F,4,OC_EXT_ROWS+ 18,{0,1,2,3,7,6,5,4},{0,2,4,6,7,5,3,1}}, + {0xF0,4,OC_EXT_ROWS+ 18,{4,5,6,7,3,2,1,0},{0,2,4,6,7,5,3,1}}, + {0x07,3,OC_EXT_ROWS+ 22,{0,1,2,7,6,5,4,3},{0,3,6,7,5,4,2,1}}, + {0xE0,3,OC_EXT_ROWS+ 27,{5,6,7,4,3,2,1,0},{0,3,6,7,5,4,2,1}}, + {0x03,2,OC_EXT_ROWS+ 32,{0,1,7,6,5,4,3,2},{0,4,7,6,5,3,2,1}}, + {0xC0,2,OC_EXT_ROWS+ 32,{6,7,5,4,3,2,1,0},{0,4,7,6,5,3,2,1}}, + {0x01,1,OC_EXT_ROWS+ 0,{0,7,6,5,4,3,2,1},{0,7,6,5,4,3,2,1}}, + {0x80,1,OC_EXT_ROWS+ 0,{7,6,5,4,3,2,1,0},{0,7,6,5,4,3,2,1}}, + {0x7E,6,OC_EXT_ROWS+ 42,{1,2,3,4,5,6,7,0},{0,1,2,5,6,7,4,3}}, + {0x7C,5,OC_EXT_ROWS+ 44,{2,3,4,5,6,7,1,0},{0,1,4,5,7,6,3,2}}, + {0x3E,5,OC_EXT_ROWS+ 47,{1,2,3,4,5,7,6,0},{0,1,4,5,7,6,3,2}}, + {0x78,4,OC_EXT_ROWS+ 50,{3,4,5,6,7,2,1,0},{0,4,5,7,6,3,2,1}}, + {0x3C,4,OC_EXT_ROWS+ 54,{2,3,4,5,7,6,1,0},{0,3,4,7,6,5,2,1}}, + {0x1E,4,OC_EXT_ROWS+ 58,{1,2,3,4,7,6,5,0},{0,4,5,7,6,3,2,1}}, + {0x70,3,OC_EXT_ROWS+ 62,{4,5,6,7,3,2,1,0},{0,5,7,6,4,3,2,1}}, + {0x38,3,OC_EXT_ROWS+ 67,{3,4,5,7,6,2,1,0},{0,5,6,7,4,3,2,1}}, + {0x1C,3,OC_EXT_ROWS+ 72,{2,3,4,7,6,5,1,0},{0,5,6,7,4,3,2,1}}, + {0x0E,3,OC_EXT_ROWS+ 77,{1,2,3,7,6,5,4,0},{0,5,7,6,4,3,2,1}}, + {0x60,2,OC_EXT_ROWS+ 82,{5,6,7,4,3,2,1,0},{0,2,7,6,5,4,3,1}}, + {0x30,2,OC_EXT_ROWS+ 36,{4,5,7,6,3,2,1,0},{0,4,7,6,5,3,2,1}}, + {0x18,2,OC_EXT_ROWS+ 90,{3,4,7,6,5,2,1,0},{0,1,7,6,5,4,3,2}}, + {0x0C,2,OC_EXT_ROWS+ 34,{2,3,7,6,5,4,1,0},{0,4,7,6,5,3,2,1}}, + {0x06,2,OC_EXT_ROWS+ 84,{1,2,7,6,5,4,3,0},{0,2,7,6,5,4,3,1}}, + {0x40,1,OC_EXT_ROWS+ 0,{6,7,5,4,3,2,1,0},{0,7,6,5,4,3,2,1}}, + {0x20,1,OC_EXT_ROWS+ 0,{5,7,6,4,3,2,1,0},{0,7,6,5,4,3,2,1}}, + {0x10,1,OC_EXT_ROWS+ 0,{4,7,6,5,3,2,1,0},{0,7,6,5,4,3,2,1}}, + {0x08,1,OC_EXT_ROWS+ 0,{3,7,6,5,4,2,1,0},{0,7,6,5,4,3,2,1}}, + {0x04,1,OC_EXT_ROWS+ 0,{2,7,6,5,4,3,1,0},{0,7,6,5,4,3,2,1}}, + {0x02,1,OC_EXT_ROWS+ 0,{1,7,6,5,4,3,2,0},{0,7,6,5,4,3,2,1}} +}; + + + +/*Pads a single column of a partial block and then performs a forward Type-II + DCT on the result. + The input is scaled by a factor of 4 and biased appropriately for the current + fDCT implementation. + The output is scaled by an additional factor of 2 from the orthonormal + version of the transform. + _y: The buffer to store the result in. + Data will be placed the first 8 entries (e.g., in a row of an 8x8 block). + _x: The input coefficients. + Every 8th entry is used (e.g., from a column of an 8x8 block). + _e: The extension information for the shape.*/ +static void oc_fdct8_ext(ogg_int16_t _y[8],ogg_int16_t *_x, + const oc_extension_info *_e){ + const unsigned char *pi; + int na; + na=_e->na; + pi=_e->pi; + if(na==1){ + int ci; + /*While the branch below is still correct for shapes with na==1, we can + perform the entire transform with just 1 multiply in this case instead + of 23.*/ + _y[0]=(ogg_int16_t)(OC_DIV2_16(OC_C4S4*(_x[pi[0]]))); + for(ci=1;ci<8;ci++)_y[ci]=0; + } + else{ + const ogg_int16_t *const *ext; + int zpi; + int api; + int nz; + /*First multiply by the extension matrix to compute the padding values.*/ + nz=8-na; + ext=_e->ext; + for(zpi=0;zpi>16)+1>>1; + } + oc_fdct8(_y,_x); + } +} + +/*Performs a forward 8x8 Type-II DCT transform on blocks which overlap the + border of the picture region. + This method ONLY works with rectangular regions. + _border: A description of which pixels are inside the border. + _y: The buffer to store the result in. + This may be the same as _x. + _x: The input pixel values. + Pixel values outside the border will be ignored.*/ +void oc_fdct8x8_border(const oc_border_info *_border, + ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + ogg_int16_t *in; + ogg_int16_t *out; + ogg_int16_t w[64]; + ogg_int64_t mask; + const oc_extension_info *cext; + const oc_extension_info *rext; + int cmask; + int rmask; + int ri; + int ci; + /*Identify the shapes of the non-zero rows and columns.*/ + rmask=cmask=0; + mask=_border->mask; + for(ri=0;ri<8;ri++){ + /*This aggregation is _only_ correct for rectangular masks.*/ + cmask|=((mask&0xFF)!=0)<>=8; + } + /*Find the associated extension info for these shapes.*/ + if(cmask==0xFF)cext=NULL; + else for(cext=OC_EXTENSION_INFO;cext->mask!=cmask;){ + /*If we somehow can't find the shape, then just do an unpadded fDCT. + It won't be efficient, but it should still be correct.*/ + if(++cext>=OC_EXTENSION_INFO+OC_NSHAPES){ + oc_enc_fdct8x8_c(_y,_x); + return; + } + } + if(rmask==0xFF)rext=NULL; + else for(rext=OC_EXTENSION_INFO;rext->mask!=rmask;){ + /*If we somehow can't find the shape, then just do an unpadded fDCT. + It won't be efficient, but it should still be correct.*/ + if(++rext>=OC_EXTENSION_INFO+OC_NSHAPES){ + oc_enc_fdct8x8_c(_y,_x); + return; + } + } + /*Add two extra bits of working precision to improve accuracy; any more and + we could overflow.*/ + for(ci=0;ci<64;ci++)w[ci]=_x[ci]<<2; + /*These biases correct for some systematic error that remains in the full + fDCT->iDCT round trip. + We can safely add them before padding, since if these pixel values are + overwritten, we didn't care what they were anyway (and the unbiased values + will usually yield smaller DCT coefficient magnitudes).*/ + w[0]+=(w[0]!=0)+1; + w[1]++; + w[8]--; + /*Transform the columns. + We can ignore zero columns without a problem.*/ + in=w; + out=_y; + if(cext==NULL)for(ci=0;ci<8;ci++)oc_fdct8(out+(ci<<3),in+ci); + else for(ci=0;ci<8;ci++)if(rmask&(1<>2; +} +#endif diff --git a/libs/libtheora-1.1/lib/fragment.c b/libs/libtheora-1.1/lib/fragment.c new file mode 100644 index 00000000..971d1a41 --- /dev/null +++ b/libs/libtheora-1.1/lib/fragment.c @@ -0,0 +1,87 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: fragment.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include "internal.h" + +void oc_frag_copy(const oc_theora_state *_state,unsigned char *_dst, + const unsigned char *_src,int _ystride){ + (*_state->opt_vtable.frag_copy)(_dst,_src,_ystride); +} + +void oc_frag_copy_c(unsigned char *_dst,const unsigned char *_src,int _ystride){ + int i; + for(i=8;i-->0;){ + memcpy(_dst,_src,8*sizeof(*_dst)); + _dst+=_ystride; + _src+=_ystride; + } +} + +void oc_frag_recon_intra(const oc_theora_state *_state,unsigned char *_dst, + int _ystride,const ogg_int16_t _residue[64]){ + _state->opt_vtable.frag_recon_intra(_dst,_ystride,_residue); +} + +void oc_frag_recon_intra_c(unsigned char *_dst,int _ystride, + const ogg_int16_t _residue[64]){ + int i; + for(i=0;i<8;i++){ + int j; + for(j=0;j<8;j++)_dst[j]=OC_CLAMP255(_residue[i*8+j]+128); + _dst+=_ystride; + } +} + +void oc_frag_recon_inter(const oc_theora_state *_state,unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]){ + _state->opt_vtable.frag_recon_inter(_dst,_src,_ystride,_residue); +} + +void oc_frag_recon_inter_c(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]){ + int i; + for(i=0;i<8;i++){ + int j; + for(j=0;j<8;j++)_dst[j]=OC_CLAMP255(_residue[i*8+j]+_src[j]); + _dst+=_ystride; + _src+=_ystride; + } +} + +void oc_frag_recon_inter2(const oc_theora_state *_state,unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride, + const ogg_int16_t _residue[64]){ + _state->opt_vtable.frag_recon_inter2(_dst,_src1,_src2,_ystride,_residue); +} + +void oc_frag_recon_inter2_c(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t _residue[64]){ + int i; + for(i=0;i<8;i++){ + int j; + for(j=0;j<8;j++)_dst[j]=OC_CLAMP255(_residue[i*8+j]+(_src1[j]+_src2[j]>>1)); + _dst+=_ystride; + _src1+=_ystride; + _src2+=_ystride; + } +} + +void oc_restore_fpu(const oc_theora_state *_state){ + _state->opt_vtable.restore_fpu(); +} + +void oc_restore_fpu_c(void){} diff --git a/libs/libtheora-1.1/lib/huffdec.c b/libs/libtheora-1.1/lib/huffdec.c new file mode 100644 index 00000000..31f48c1b --- /dev/null +++ b/libs/libtheora-1.1/lib/huffdec.c @@ -0,0 +1,489 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: huffdec.c 16702 2009-11-15 00:40:55Z tterribe $ + + ********************************************************************/ + +#include +#include +#include +#include "huffdec.h" +#include "decint.h" + + +/*The ANSI offsetof macro is broken on some platforms (e.g., older DECs).*/ +#define _ogg_offsetof(_type,_field)\ + ((size_t)((char *)&((_type *)0)->_field-(char *)0)) + +/*The number of internal tokens associated with each of the spec tokens.*/ +static const unsigned char OC_DCT_TOKEN_MAP_ENTRIES[TH_NDCT_TOKENS]={ + 1,1,1,4,8,1,1,8,1,1,1,1,1,2,2,2,2,4,8,2,2,2,4,2,2,2,2,2,8,2,4,8 +}; + +/*The map from external spec-defined tokens to internal tokens. + This is constructed so that any extra bits read with the original token value + can be masked off the least significant bits of its internal token index. + In addition, all of the tokens which require additional extra bits are placed + at the start of the list, and grouped by type. + OC_DCT_REPEAT_RUN3_TOKEN is placed first, as it is an extra-special case, so + giving it index 0 may simplify comparisons on some architectures. + These requirements require some substantial reordering.*/ +static const unsigned char OC_DCT_TOKEN_MAP[TH_NDCT_TOKENS]={ + /*OC_DCT_EOB1_TOKEN (0 extra bits)*/ + 15, + /*OC_DCT_EOB2_TOKEN (0 extra bits)*/ + 16, + /*OC_DCT_EOB3_TOKEN (0 extra bits)*/ + 17, + /*OC_DCT_REPEAT_RUN0_TOKEN (2 extra bits)*/ + 88, + /*OC_DCT_REPEAT_RUN1_TOKEN (3 extra bits)*/ + 80, + /*OC_DCT_REPEAT_RUN2_TOKEN (4 extra bits)*/ + 1, + /*OC_DCT_REPEAT_RUN3_TOKEN (12 extra bits)*/ + 0, + /*OC_DCT_SHORT_ZRL_TOKEN (3 extra bits)*/ + 48, + /*OC_DCT_ZRL_TOKEN (6 extra bits)*/ + 14, + /*OC_ONE_TOKEN (0 extra bits)*/ + 56, + /*OC_MINUS_ONE_TOKEN (0 extra bits)*/ + 57, + /*OC_TWO_TOKEN (0 extra bits)*/ + 58, + /*OC_MINUS_TWO_TOKEN (0 extra bits)*/ + 59, + /*OC_DCT_VAL_CAT2 (1 extra bit)*/ + 60, + 62, + 64, + 66, + /*OC_DCT_VAL_CAT3 (2 extra bits)*/ + 68, + /*OC_DCT_VAL_CAT4 (3 extra bits)*/ + 72, + /*OC_DCT_VAL_CAT5 (4 extra bits)*/ + 2, + /*OC_DCT_VAL_CAT6 (5 extra bits)*/ + 4, + /*OC_DCT_VAL_CAT7 (6 extra bits)*/ + 6, + /*OC_DCT_VAL_CAT8 (10 extra bits)*/ + 8, + /*OC_DCT_RUN_CAT1A (1 extra bit)*/ + 18, + 20, + 22, + 24, + 26, + /*OC_DCT_RUN_CAT1B (3 extra bits)*/ + 32, + /*OC_DCT_RUN_CAT1C (4 extra bits)*/ + 12, + /*OC_DCT_RUN_CAT2A (2 extra bits)*/ + 28, + /*OC_DCT_RUN_CAT2B (3 extra bits)*/ + 40 +}; + +/*These three functions are really part of the bitpack.c module, but + they are only used here. + Declaring local static versions so they can be inlined saves considerable + function call overhead.*/ + +static oc_pb_window oc_pack_refill(oc_pack_buf *_b,int _bits){ + const unsigned char *ptr; + const unsigned char *stop; + oc_pb_window window; + int available; + window=_b->window; + available=_b->bits; + ptr=_b->ptr; + stop=_b->stop; + /*This version of _refill() doesn't bother setting eof because we won't + check for it after we've started decoding DCT tokens.*/ + if(ptr>=stop)available=OC_LOTS_OF_BITS; + while(available<=OC_PB_WINDOW_SIZE-8){ + available+=8; + window|=(oc_pb_window)*ptr++<=stop)available=OC_LOTS_OF_BITS; + } + _b->ptr=ptr; + if(_bits>available)window|=*ptr>>(available&7); + _b->bits=available; + return window; +} + + +/*Read in bits without advancing the bit pointer. + Here we assume 0<=_bits&&_bits<=32.*/ +static long oc_pack_look(oc_pack_buf *_b,int _bits){ + oc_pb_window window; + int available; + long result; + window=_b->window; + available=_b->bits; + if(_bits==0)return 0; + if(_bits>available)_b->window=window=oc_pack_refill(_b,_bits); + result=window>>OC_PB_WINDOW_SIZE-_bits; + return result; +} + +/*Advance the bit pointer.*/ +static void oc_pack_adv(oc_pack_buf *_b,int _bits){ + /*We ignore the special cases for _bits==0 and _bits==32 here, since they are + never used actually used. + OC_HUFF_SLUSH (defined below) would have to be at least 27 to actually read + 32 bits in a single go, and would require a 32 GB lookup table (assuming + 8 byte pointers, since 4 byte pointers couldn't fit such a table).*/ + _b->window<<=_bits; + _b->bits-=_bits; +} + + +/*The log_2 of the size of a lookup table is allowed to grow to relative to + the number of unique nodes it contains. + E.g., if OC_HUFF_SLUSH is 2, then at most 75% of the space in the tree is + wasted (each node will have an amortized cost of at most 20 bytes when using + 4-byte pointers). + Larger numbers can decode tokens with fewer read operations, while smaller + numbers may save more space (requiring as little as 8 bytes amortized per + node, though there will be more nodes). + With a sample file: + 32233473 read calls are required when no tree collapsing is done (100.0%). + 19269269 read calls are required when OC_HUFF_SLUSH is 0 (59.8%). + 11144969 read calls are required when OC_HUFF_SLUSH is 1 (34.6%). + 10538563 read calls are required when OC_HUFF_SLUSH is 2 (32.7%). + 10192578 read calls are required when OC_HUFF_SLUSH is 3 (31.6%). + Since a value of 1 gets us the vast majority of the speed-up with only a + small amount of wasted memory, this is what we use.*/ +#define OC_HUFF_SLUSH (1) + + +/*Determines the size in bytes of a Huffman tree node that represents a + subtree of depth _nbits. + _nbits: The depth of the subtree. + If this is 0, the node is a leaf node. + Otherwise 1<<_nbits pointers are allocated for children. + Return: The number of bytes required to store the node.*/ +static size_t oc_huff_node_size(int _nbits){ + size_t size; + size=_ogg_offsetof(oc_huff_node,nodes); + if(_nbits>0)size+=sizeof(oc_huff_node *)*(1<<_nbits); + return size; +} + +static oc_huff_node *oc_huff_node_init(char **_storage,size_t _size,int _nbits){ + oc_huff_node *ret; + ret=(oc_huff_node *)*_storage; + ret->nbits=(unsigned char)_nbits; + (*_storage)+=_size; + return ret; +} + + +/*Determines the size in bytes of a Huffman tree. + _nbits: The depth of the subtree. + If this is 0, the node is a leaf node. + Otherwise storage for 1<<_nbits pointers are added for children. + Return: The number of bytes required to store the tree.*/ +static size_t oc_huff_tree_size(const oc_huff_node *_node){ + size_t size; + size=oc_huff_node_size(_node->nbits); + if(_node->nbits){ + int nchildren; + int i; + nchildren=1<<_node->nbits; + for(i=0;inbits-_node->nodes[i]->depth){ + size+=oc_huff_tree_size(_node->nodes[i]); + } + } + return size; +} + + +/*Unpacks a sub-tree from the given buffer. + _opb: The buffer to unpack from. + _binodes: The nodes to store the sub-tree in. + _nbinodes: The number of nodes available for the sub-tree. + Return: 0 on success, or a negative value on error.*/ +static int oc_huff_tree_unpack(oc_pack_buf *_opb, + oc_huff_node *_binodes,int _nbinodes){ + oc_huff_node *binode; + long bits; + int nused; + if(_nbinodes<1)return TH_EBADHEADER; + binode=_binodes; + nused=0; + bits=oc_pack_read1(_opb); + if(oc_pack_bytes_left(_opb)<0)return TH_EBADHEADER; + /*Read an internal node:*/ + if(!bits){ + int ret; + nused++; + binode->nbits=1; + binode->depth=1; + binode->nodes[0]=_binodes+nused; + ret=oc_huff_tree_unpack(_opb,_binodes+nused,_nbinodes-nused); + if(ret>=0){ + nused+=ret; + binode->nodes[1]=_binodes+nused; + ret=oc_huff_tree_unpack(_opb,_binodes+nused,_nbinodes-nused); + } + if(ret<0)return ret; + nused+=ret; + } + /*Read a leaf node:*/ + else{ + int ntokens; + int token; + int i; + bits=oc_pack_read(_opb,OC_NDCT_TOKEN_BITS); + if(oc_pack_bytes_left(_opb)<0)return TH_EBADHEADER; + /*Find out how many internal tokens we translate this external token into.*/ + ntokens=OC_DCT_TOKEN_MAP_ENTRIES[bits]; + if(_nbinodes<2*ntokens-1)return TH_EBADHEADER; + /*Fill in a complete binary tree pointing to the internal tokens.*/ + for(i=1;inbits=0; + binode->depth=1; + binode->token=token+i; + } + } + return nused; +} + +/*Finds the depth of shortest branch of the given sub-tree. + The tree must be binary. + _binode: The root of the given sub-tree. + _binode->nbits must be 0 or 1. + Return: The smallest depth of a leaf node in this sub-tree. + 0 indicates this sub-tree is a leaf node.*/ +static int oc_huff_tree_mindepth(oc_huff_node *_binode){ + int depth0; + int depth1; + if(_binode->nbits==0)return 0; + depth0=oc_huff_tree_mindepth(_binode->nodes[0]); + depth1=oc_huff_tree_mindepth(_binode->nodes[1]); + return OC_MINI(depth0,depth1)+1; +} + +/*Finds the number of internal nodes at a given depth, plus the number of + leaves at that depth or shallower. + The tree must be binary. + _binode: The root of the given sub-tree. + _binode->nbits must be 0 or 1. + Return: The number of entries that would be contained in a jump table of the + given depth.*/ +static int oc_huff_tree_occupancy(oc_huff_node *_binode,int _depth){ + if(_binode->nbits==0||_depth<=0)return 1; + else{ + return oc_huff_tree_occupancy(_binode->nodes[0],_depth-1)+ + oc_huff_tree_occupancy(_binode->nodes[1],_depth-1); + } +} + +/*Makes a copy of the given Huffman tree. + _node: The Huffman tree to copy. + Return: The copy of the Huffman tree.*/ +static oc_huff_node *oc_huff_tree_copy(const oc_huff_node *_node, + char **_storage){ + oc_huff_node *ret; + ret=oc_huff_node_init(_storage,oc_huff_node_size(_node->nbits),_node->nbits); + ret->depth=_node->depth; + if(_node->nbits){ + int nchildren; + int i; + int inext; + nchildren=1<<_node->nbits; + for(i=0;inodes[i]=oc_huff_tree_copy(_node->nodes[i],_storage); + inext=i+(1<<_node->nbits-ret->nodes[i]->depth); + while(++inodes[i]=ret->nodes[i-1]; + } + } + else ret->token=_node->token; + return ret; +} + +static size_t oc_huff_tree_collapse_size(oc_huff_node *_binode,int _depth){ + size_t size; + int mindepth; + int depth; + int loccupancy; + int occupancy; + if(_binode->nbits!=0&&_depth>0){ + return oc_huff_tree_collapse_size(_binode->nodes[0],_depth-1)+ + oc_huff_tree_collapse_size(_binode->nodes[1],_depth-1); + } + depth=mindepth=oc_huff_tree_mindepth(_binode); + occupancy=1<loccupancy&&occupancy>=1<0){ + size+=oc_huff_tree_collapse_size(_binode->nodes[0],depth-1); + size+=oc_huff_tree_collapse_size(_binode->nodes[1],depth-1); + } + return size; +} + +static oc_huff_node *oc_huff_tree_collapse(oc_huff_node *_binode, + char **_storage); + +/*Fills the given nodes table with all the children in the sub-tree at the + given depth. + The nodes in the sub-tree with a depth less than that stored in the table + are freed. + The sub-tree must be binary and complete up until the given depth. + _nodes: The nodes table to fill. + _binode: The root of the sub-tree to fill it with. + _binode->nbits must be 0 or 1. + _level: The current level in the table. + 0 indicates that the current node should be stored, regardless of + whether it is a leaf node or an internal node. + _depth: The depth of the nodes to fill the table with, relative to their + parent.*/ +static void oc_huff_node_fill(oc_huff_node **_nodes, + oc_huff_node *_binode,int _level,int _depth,char **_storage){ + if(_level<=0||_binode->nbits==0){ + int i; + _binode->depth=(unsigned char)(_depth-_level); + _nodes[0]=oc_huff_tree_collapse(_binode,_storage); + for(i=1;i<1<<_level;i++)_nodes[i]=_nodes[0]; + } + else{ + _level--; + oc_huff_node_fill(_nodes,_binode->nodes[0],_level,_depth,_storage); + _nodes+=1<<_level; + oc_huff_node_fill(_nodes,_binode->nodes[1],_level,_depth,_storage); + } +} + +/*Finds the largest complete sub-tree rooted at the current node and collapses + it into a single node. + This procedure is then applied recursively to all the children of that node. + _binode: The root of the sub-tree to collapse. + _binode->nbits must be 0 or 1. + Return: The new root of the collapsed sub-tree.*/ +static oc_huff_node *oc_huff_tree_collapse(oc_huff_node *_binode, + char **_storage){ + oc_huff_node *root; + size_t size; + int mindepth; + int depth; + int loccupancy; + int occupancy; + depth=mindepth=oc_huff_tree_mindepth(_binode); + occupancy=1<loccupancy&&occupancy>=1<depth=_binode->depth; + oc_huff_node_fill(root->nodes,_binode,depth,depth,_storage); + return root; +} + +/*Unpacks a set of Huffman trees, and reduces them to a collapsed + representation. + _opb: The buffer to unpack the trees from. + _nodes: The table to fill with the Huffman trees. + Return: 0 on success, or a negative value on error.*/ +int oc_huff_trees_unpack(oc_pack_buf *_opb, + oc_huff_node *_nodes[TH_NHUFFMAN_TABLES]){ + int i; + for(i=0;i0)_ogg_free(_dst[i]); + return TH_EFAULT; + } + _dst[i]=oc_huff_tree_copy(_src[i],&storage); + } + return 0; +} + +/*Frees the memory used by a set of Huffman trees. + _nodes: The array of trees to free.*/ +void oc_huff_trees_clear(oc_huff_node *_nodes[TH_NHUFFMAN_TABLES]){ + int i; + for(i=0;inbits!=0){ + bits=oc_pack_look(_opb,_node->nbits); + _node=_node->nodes[bits]; + oc_pack_adv(_opb,_node->depth); + } + return _node->token; +} diff --git a/libs/libtheora-1.1/lib/huffdec.h b/libs/libtheora-1.1/lib/huffdec.h new file mode 100644 index 00000000..e0a06d84 --- /dev/null +++ b/libs/libtheora-1.1/lib/huffdec.h @@ -0,0 +1,92 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: huffdec.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_huffdec_H) +# define _huffdec_H (1) +# include "huffman.h" +# include "bitpack.h" + + + +typedef struct oc_huff_node oc_huff_node; + +/*A node in the Huffman tree. + Instead of storing every branching in the tree, subtrees can be collapsed + into one node, with a table of size 1< +#include +#include +#include "huffenc.h" + + + +/*The default Huffman codes used for VP3.1.*/ +const th_huff_code TH_VP31_HUFF_CODES[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS]={ + { + {0x002D, 6},{0x0026, 7},{0x0166, 9},{0x004E, 8}, + {0x02CE,10},{0x059E,11},{0x027D,11},{0x0008, 5}, + {0x04F9,12},{0x000F, 4},{0x000E, 4},{0x001B, 5}, + {0x0006, 4},{0x0008, 4},{0x0005, 4},{0x001A, 5}, + {0x0015, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x0009, 4},{0x0017, 5},{0x0029, 6}, + {0x0028, 6},{0x00B2, 8},{0x04F8,12},{0x059F,11}, + {0x009E, 9},{0x013F,10},{0x0012, 6},{0x0058, 7} + }, + { + {0x0010, 5},{0x0047, 7},{0x01FF, 9},{0x008C, 8}, + {0x03FC,10},{0x046A,11},{0x0469,11},{0x0022, 6}, + {0x11A1,13},{0x000E, 4},{0x000D, 4},{0x0004, 4}, + {0x0005, 4},{0x0009, 4},{0x0006, 4},{0x001E, 5}, + {0x0016, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x000A, 4},{0x0017, 5},{0x007D, 7}, + {0x007E, 7},{0x011B, 9},{0x08D1,12},{0x03FD,10}, + {0x046B,11},{0x11A0,13},{0x007C, 7},{0x00FE, 8} + }, + { + {0x0016, 5},{0x0020, 6},{0x0086, 8},{0x0087, 8}, + {0x0367,10},{0x06CC,11},{0x06CB,11},{0x006E, 7}, + {0x366D,14},{0x000F, 4},{0x000E, 4},{0x0004, 4}, + {0x0005, 4},{0x000A, 4},{0x0006, 4},{0x001A, 5}, + {0x0011, 5},{0x0007, 4},{0x000C, 4},{0x0001, 3}, + {0x0000, 3},{0x0009, 4},{0x0017, 5},{0x006F, 7}, + {0x006D, 7},{0x0364,10},{0x0D9A,12},{0x06CA,11}, + {0x1B37,13},{0x366C,14},{0x0042, 7},{0x00D8, 8} + }, + { + {0x0000, 4},{0x002D, 6},{0x00F7, 8},{0x0058, 7}, + {0x0167, 9},{0x02CB,10},{0x02CA,10},{0x000E, 6}, + {0x1661,13},{0x0003, 3},{0x0002, 3},{0x0008, 4}, + {0x0009, 4},{0x000D, 4},{0x0002, 4},{0x001F, 5}, + {0x0017, 5},{0x0001, 4},{0x000C, 4},{0x000E, 4}, + {0x000A, 4},{0x0006, 5},{0x0078, 7},{0x000F, 6}, + {0x007A, 7},{0x0164, 9},{0x0599,11},{0x02CD,10}, + {0x0B31,12},{0x1660,13},{0x0079, 7},{0x00F6, 8} + }, + { + {0x0003, 4},{0x003C, 6},{0x000F, 7},{0x007A, 7}, + {0x001D, 8},{0x0020, 9},{0x0072,10},{0x0006, 6}, + {0x0399,13},{0x0004, 3},{0x0005, 3},{0x0005, 4}, + {0x0006, 4},{0x000E, 4},{0x0004, 4},{0x0000, 4}, + {0x0019, 5},{0x0002, 4},{0x000D, 4},{0x0007, 4}, + {0x001F, 5},{0x0030, 6},{0x0011, 8},{0x0031, 6}, + {0x0005, 6},{0x0021, 9},{0x00E7,11},{0x0038, 9}, + {0x01CD,12},{0x0398,13},{0x007B, 7},{0x0009, 7} + }, + { + {0x0009, 4},{0x0002, 5},{0x0074, 7},{0x0007, 6}, + {0x00EC, 8},{0x00D1, 9},{0x01A6,10},{0x0006, 6}, + {0x0D21,13},{0x0005, 3},{0x0006, 3},{0x0008, 4}, + {0x0007, 4},{0x000F, 4},{0x0004, 4},{0x0000, 4}, + {0x001C, 5},{0x0002, 4},{0x0005, 4},{0x0003, 4}, + {0x000C, 5},{0x0035, 7},{0x01A7,10},{0x001B, 6}, + {0x0077, 7},{0x01A5,10},{0x0349,11},{0x00D0, 9}, + {0x0691,12},{0x0D20,13},{0x0075, 7},{0x00ED, 8} + }, + { + {0x000A, 4},{0x000C, 5},{0x0012, 6},{0x001B, 6}, + {0x00B7, 8},{0x016C, 9},{0x0099, 9},{0x005A, 7}, + {0x16D8,13},{0x0007, 3},{0x0006, 3},{0x0009, 4}, + {0x0008, 4},{0x0000, 3},{0x0005, 4},{0x0017, 5}, + {0x000E, 5},{0x0002, 4},{0x0003, 4},{0x000F, 5}, + {0x001A, 6},{0x004D, 8},{0x2DB3,14},{0x002C, 6}, + {0x0011, 6},{0x02DA,10},{0x05B7,11},{0x0098, 9}, + {0x0B6D,12},{0x2DB2,14},{0x0010, 6},{0x0027, 7} + }, + { + {0x000D, 4},{0x000F, 5},{0x001D, 6},{0x0008, 5}, + {0x0051, 7},{0x0056, 8},{0x00AF, 9},{0x002A, 7}, + {0x148A,13},{0x0007, 3},{0x0000, 2},{0x0008, 4}, + {0x0009, 4},{0x000C, 4},{0x0006, 4},{0x0017, 5}, + {0x000B, 5},{0x0016, 5},{0x0015, 5},{0x0009, 5}, + {0x0050, 7},{0x00AE, 9},{0x2917,14},{0x001C, 6}, + {0x0014, 6},{0x0290,10},{0x0523,11},{0x0149, 9}, + {0x0A44,12},{0x2916,14},{0x0053, 7},{0x00A5, 8} + }, + { + {0x0001, 4},{0x001D, 6},{0x00F5, 8},{0x00F4, 8}, + {0x024D,10},{0x0499,11},{0x0498,11},{0x0001, 5}, + {0x0021, 6},{0x0006, 3},{0x0005, 3},{0x0006, 4}, + {0x0005, 4},{0x0002, 4},{0x0007, 5},{0x0025, 6}, + {0x007B, 7},{0x001C, 6},{0x0020, 6},{0x000D, 6}, + {0x0048, 7},{0x0092, 8},{0x0127, 9},{0x000E, 4}, + {0x0004, 4},{0x0011, 5},{0x000C, 6},{0x003C, 6}, + {0x000F, 5},{0x0000, 5},{0x001F, 5},{0x0013, 5} + }, + { + {0x0005, 4},{0x003C, 6},{0x0040, 7},{0x000D, 7}, + {0x0031, 9},{0x0061,10},{0x0060,10},{0x0002, 5}, + {0x00F5, 8},{0x0006, 3},{0x0005, 3},{0x0007, 4}, + {0x0006, 4},{0x0002, 4},{0x0009, 5},{0x0025, 6}, + {0x0007, 6},{0x0021, 6},{0x0024, 6},{0x0010, 6}, + {0x0041, 7},{0x00F4, 8},{0x0019, 8},{0x000E, 4}, + {0x0003, 4},{0x0011, 5},{0x0011, 6},{0x003F, 6}, + {0x003E, 6},{0x007B, 7},{0x0000, 4},{0x0013, 5} + }, + { + {0x000A, 4},{0x0007, 5},{0x0001, 6},{0x0009, 6}, + {0x0131, 9},{0x0261,10},{0x0260,10},{0x0015, 6}, + {0x0001, 7},{0x0007, 3},{0x0006, 3},{0x0008, 4}, + {0x0007, 4},{0x0006, 4},{0x0012, 5},{0x002F, 6}, + {0x0014, 6},{0x0027, 6},{0x002D, 6},{0x0016, 6}, + {0x004D, 7},{0x0099, 8},{0x0000, 7},{0x0004, 4}, + {0x0001, 4},{0x0005, 5},{0x0017, 6},{0x002E, 6}, + {0x002C, 6},{0x0008, 6},{0x0006, 5},{0x0001, 5} + }, + { + {0x0000, 3},{0x000E, 5},{0x0017, 6},{0x002A, 6}, + {0x0010, 7},{0x00F9,10},{0x00F8,10},{0x001E, 7}, + {0x003F, 8},{0x0007, 3},{0x0006, 3},{0x0009, 4}, + {0x0008, 4},{0x0006, 4},{0x000F, 5},{0x0005, 5}, + {0x0016, 6},{0x0029, 6},{0x002B, 6},{0x0015, 6}, + {0x0050, 7},{0x0011, 7},{0x007D, 9},{0x0004, 4}, + {0x0017, 5},{0x0006, 5},{0x0014, 6},{0x002C, 6}, + {0x002D, 6},{0x000E, 6},{0x0009, 6},{0x0051, 7} + }, + { + {0x0002, 3},{0x0018, 5},{0x002F, 6},{0x000D, 5}, + {0x0053, 7},{0x0295,10},{0x0294,10},{0x00A4, 8}, + {0x007C, 8},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x001B, 5},{0x000C, 5},{0x0028, 6}, + {0x006A, 7},{0x001E, 6},{0x001D, 6},{0x0069, 7}, + {0x00D7, 8},{0x007D, 8},{0x014B, 9},{0x0019, 5}, + {0x0016, 5},{0x002E, 6},{0x001C, 6},{0x002B, 6}, + {0x002A, 6},{0x0068, 7},{0x003F, 7},{0x00D6, 8} + }, + { + {0x0002, 3},{0x001B, 5},{0x000C, 5},{0x0018, 5}, + {0x0029, 6},{0x007F, 8},{0x02F0,10},{0x0198, 9}, + {0x0179, 9},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x001A, 5},{0x000D, 5},{0x002A, 6}, + {0x0064, 7},{0x001E, 6},{0x0067, 7},{0x005F, 7}, + {0x00CD, 8},{0x007E, 8},{0x02F1,10},{0x0016, 5}, + {0x000E, 5},{0x002E, 6},{0x0065, 7},{0x002B, 6}, + {0x0028, 6},{0x003E, 7},{0x00BD, 8},{0x0199, 9} + }, + { + {0x0002, 3},{0x0007, 4},{0x0016, 5},{0x0006, 4}, + {0x0036, 6},{0x005C, 7},{0x015D, 9},{0x015C, 9}, + {0x02BF,10},{0x0000, 2},{0x0007, 3},{0x0009, 4}, + {0x0008, 4},{0x0018, 5},{0x0034, 6},{0x002A, 6}, + {0x005E, 7},{0x006A, 7},{0x0064, 7},{0x005D, 7}, + {0x00CB, 8},{0x00AD, 8},{0x02BE,10},{0x0014, 5}, + {0x0033, 6},{0x006E, 7},{0x005F, 7},{0x006F, 7}, + {0x006B, 7},{0x00CA, 8},{0x00AC, 8},{0x015E, 9} + }, + { + {0x000F, 4},{0x001D, 5},{0x0018, 5},{0x000B, 4}, + {0x0019, 5},{0x0029, 6},{0x00D6, 8},{0x0551,11}, + {0x0AA1,12},{0x0001, 2},{0x0000, 2},{0x0009, 4}, + {0x0008, 4},{0x001B, 5},{0x0038, 6},{0x0028, 6}, + {0x0057, 7},{0x006A, 7},{0x0068, 7},{0x0056, 7}, + {0x00E5, 8},{0x0155, 9},{0x0AA0,12},{0x0073, 7}, + {0x0069, 7},{0x00D7, 8},{0x00AB, 8},{0x00E4, 8}, + {0x00A9, 8},{0x0151, 9},{0x0150, 9},{0x02A9,10} + }, + { + {0x0008, 5},{0x0025, 7},{0x017A, 9},{0x02F7,10}, + {0x0BDB,12},{0x17B4,13},{0x2F6B,14},{0x001D, 5}, + {0x2F6A,14},{0x0008, 4},{0x0007, 4},{0x0001, 4}, + {0x0002, 4},{0x000A, 4},{0x0006, 4},{0x0000, 4}, + {0x001C, 5},{0x0009, 4},{0x000D, 4},{0x000F, 4}, + {0x000C, 4},{0x0003, 4},{0x000A, 5},{0x0016, 5}, + {0x0013, 6},{0x005D, 7},{0x0024, 7},{0x00BC, 8}, + {0x005C, 7},{0x05EC,11},{0x000B, 5},{0x005F, 7} + }, + { + {0x000F, 5},{0x0010, 6},{0x004B, 8},{0x00C6, 8}, + {0x031D,10},{0x0C71,12},{0x0C70,12},{0x0001, 4}, + {0x0C73,12},{0x0008, 4},{0x0009, 4},{0x0002, 4}, + {0x0003, 4},{0x000B, 4},{0x0006, 4},{0x0000, 4}, + {0x001C, 5},{0x0005, 4},{0x000D, 4},{0x000F, 4}, + {0x000A, 4},{0x0019, 5},{0x0013, 6},{0x001D, 5}, + {0x0030, 6},{0x0062, 7},{0x0024, 7},{0x004A, 8}, + {0x018F, 9},{0x0C72,12},{0x000E, 5},{0x0011, 6} + }, + { + {0x001B, 5},{0x0003, 6},{0x008D, 8},{0x0040, 7}, + {0x0239,10},{0x0471,11},{0x08E0,12},{0x0003, 4}, + {0x11C3,13},{0x000A, 4},{0x0009, 4},{0x0004, 4}, + {0x0005, 4},{0x000E, 4},{0x0007, 4},{0x0001, 4}, + {0x001E, 5},{0x0006, 4},{0x000C, 4},{0x000B, 4}, + {0x0002, 4},{0x0000, 5},{0x0041, 7},{0x001F, 5}, + {0x0022, 6},{0x0002, 6},{0x008F, 8},{0x008C, 8}, + {0x011D, 9},{0x11C2,13},{0x001A, 5},{0x0021, 6} + }, + { + {0x001F, 5},{0x0003, 6},{0x0003, 7},{0x0043, 7}, + {0x000B, 9},{0x0015,10},{0x0051,12},{0x0003, 4}, + {0x0050,12},{0x000D, 4},{0x000C, 4},{0x0004, 4}, + {0x0006, 4},{0x000E, 4},{0x000A, 4},{0x0001, 4}, + {0x001E, 5},{0x0005, 4},{0x0009, 4},{0x0007, 4}, + {0x0011, 5},{0x0002, 6},{0x0004, 8},{0x0002, 4}, + {0x002D, 6},{0x0020, 6},{0x0042, 7},{0x0001, 7}, + {0x0000, 7},{0x0029,11},{0x0017, 5},{0x002C, 6} + }, + { + {0x0003, 4},{0x001F, 6},{0x003A, 7},{0x005D, 7}, + {0x0173, 9},{0x02E4,10},{0x172D,13},{0x0004, 4}, + {0x172C,13},{0x000F, 4},{0x000E, 4},{0x0009, 4}, + {0x0008, 4},{0x000C, 4},{0x000A, 4},{0x0001, 4}, + {0x0016, 5},{0x0002, 4},{0x0005, 4},{0x001A, 5}, + {0x002F, 6},{0x0038, 7},{0x05CA,11},{0x0006, 4}, + {0x0037, 6},{0x001E, 6},{0x003B, 7},{0x0039, 7}, + {0x00B8, 8},{0x0B97,12},{0x0000, 4},{0x0036, 6} + }, + { + {0x0006, 4},{0x0037, 6},{0x005D, 7},{0x000C, 6}, + {0x00B9, 8},{0x02E3,10},{0x05C4,11},{0x0004, 4}, + {0x1715,13},{0x0000, 3},{0x000F, 4},{0x0008, 4}, + {0x0007, 4},{0x000C, 4},{0x0009, 4},{0x001D, 5}, + {0x0016, 5},{0x001C, 5},{0x001A, 5},{0x000B, 5}, + {0x005E, 7},{0x0170, 9},{0x1714,13},{0x000A, 4}, + {0x000A, 5},{0x0036, 6},{0x005F, 7},{0x001B, 7}, + {0x001A, 7},{0x0B8B,12},{0x0002, 4},{0x0007, 5} + }, + { + {0x000C, 4},{0x000B, 5},{0x0079, 7},{0x0022, 6}, + {0x00F0, 8},{0x0119, 9},{0x0230,10},{0x001D, 5}, + {0x08C4,12},{0x0001, 3},{0x0000, 3},{0x000A, 4}, + {0x0009, 4},{0x000B, 4},{0x0007, 4},{0x001C, 5}, + {0x003D, 6},{0x000D, 5},{0x0008, 5},{0x0015, 6}, + {0x008D, 8},{0x118B,13},{0x118A,13},{0x000D, 4}, + {0x0010, 5},{0x0009, 5},{0x0014, 6},{0x0047, 7}, + {0x00F1, 8},{0x0463,11},{0x001F, 5},{0x000C, 5} + }, + { + {0x0000, 3},{0x001A, 5},{0x0033, 6},{0x000C, 5}, + {0x0046, 7},{0x01E3, 9},{0x03C5,10},{0x0017, 5}, + {0x1E21,13},{0x0002, 3},{0x0001, 3},{0x0009, 4}, + {0x000A, 4},{0x0007, 4},{0x001B, 5},{0x003D, 6}, + {0x001B, 6},{0x0022, 6},{0x0079, 7},{0x00F0, 8}, + {0x1E20,13},{0x1E23,13},{0x1E22,13},{0x000E, 4}, + {0x0016, 5},{0x0018, 5},{0x0032, 6},{0x001A, 6}, + {0x0047, 7},{0x0789,11},{0x001F, 5},{0x0010, 5} + }, + { + {0x001D, 5},{0x0061, 7},{0x004E, 8},{0x009E, 9}, + {0x027C,11},{0x09F5,13},{0x09F4,13},{0x0003, 4}, + {0x0060, 7},{0x0000, 3},{0x000F, 4},{0x000B, 4}, + {0x000A, 4},{0x0009, 4},{0x0005, 4},{0x000D, 5}, + {0x0031, 6},{0x0008, 5},{0x0038, 6},{0x0012, 6}, + {0x0026, 7},{0x013F,10},{0x04FB,12},{0x000D, 4}, + {0x0002, 4},{0x000C, 5},{0x0039, 6},{0x001C, 6}, + {0x000F, 5},{0x001D, 6},{0x0008, 4},{0x0019, 5} + }, + { + {0x0007, 4},{0x0019, 6},{0x00AB, 8},{0x00AA, 8}, + {0x0119,10},{0x0461,12},{0x0460,12},{0x001B, 5}, + {0x0047, 8},{0x0001, 3},{0x0000, 3},{0x000C, 4}, + {0x000B, 4},{0x0009, 4},{0x0005, 4},{0x000D, 5}, + {0x0035, 6},{0x003D, 6},{0x003C, 6},{0x0018, 6}, + {0x0022, 7},{0x008D, 9},{0x0231,11},{0x000E, 4}, + {0x001F, 5},{0x0009, 5},{0x002B, 6},{0x0010, 6}, + {0x0034, 6},{0x0054, 7},{0x0008, 4},{0x0014, 5} + }, + { + {0x000C, 4},{0x0005, 5},{0x0008, 6},{0x005B, 7}, + {0x004D, 9},{0x0131,11},{0x0261,12},{0x001A, 5}, + {0x0012, 7},{0x0000, 3},{0x000F, 4},{0x000A, 4}, + {0x0009, 4},{0x0006, 4},{0x001B, 5},{0x0006, 5}, + {0x001C, 6},{0x002C, 6},{0x0015, 6},{0x005A, 7}, + {0x0027, 8},{0x0099,10},{0x0260,12},{0x000E, 4}, + {0x0004, 4},{0x000F, 5},{0x0007, 5},{0x001D, 6}, + {0x000B, 5},{0x0014, 6},{0x0008, 4},{0x0017, 5} + }, + { + {0x000F, 4},{0x0013, 5},{0x0075, 7},{0x0024, 6}, + {0x0095, 8},{0x0251,10},{0x04A0,11},{0x0010, 5}, + {0x00C8, 8},{0x0002, 3},{0x0001, 3},{0x0001, 4}, + {0x0000, 4},{0x001A, 5},{0x0011, 5},{0x002C, 6}, + {0x0065, 7},{0x0074, 7},{0x004B, 7},{0x00C9, 8}, + {0x0129, 9},{0x0943,12},{0x0942,12},{0x0003, 3}, + {0x000A, 4},{0x001C, 5},{0x0018, 5},{0x0033, 6}, + {0x0017, 5},{0x002D, 6},{0x001B, 5},{0x003B, 6} + }, + { + {0x0003, 3},{0x001A, 5},{0x002D, 6},{0x0038, 6}, + {0x0028, 7},{0x0395,10},{0x0E51,12},{0x0037, 6}, + {0x00E4, 8},{0x0001, 3},{0x0000, 3},{0x001F, 5}, + {0x001E, 5},{0x0017, 5},{0x003A, 6},{0x0073, 7}, + {0x002A, 7},{0x002B, 7},{0x0029, 7},{0x01CB, 9}, + {0x0729,11},{0x1CA1,13},{0x1CA0,13},{0x0004, 3}, + {0x000A, 4},{0x0004, 4},{0x0018, 5},{0x0036, 6}, + {0x000B, 5},{0x002C, 6},{0x0019, 5},{0x003B, 6} + }, + { + {0x0004, 3},{0x0004, 4},{0x003F, 6},{0x0017, 5}, + {0x0075, 7},{0x01F5, 9},{0x07D1,11},{0x0017, 6}, + {0x01F6, 9},{0x0001, 3},{0x0000, 3},{0x001B, 5}, + {0x001A, 5},{0x000A, 5},{0x0032, 6},{0x0074, 7}, + {0x00F8, 8},{0x00F9, 8},{0x01F7, 9},{0x03E9,10}, + {0x0FA0,12},{0x1F43,13},{0x1F42,13},{0x0003, 3}, + {0x000A, 4},{0x001E, 5},{0x001C, 5},{0x003B, 6}, + {0x0018, 5},{0x0016, 6},{0x0016, 5},{0x0033, 6} + }, + { + {0x0004, 3},{0x0007, 4},{0x0018, 5},{0x001E, 5}, + {0x0036, 6},{0x0031, 7},{0x0177, 9},{0x0077, 7}, + {0x0176, 9},{0x0001, 3},{0x0000, 3},{0x001A, 5}, + {0x0019, 5},{0x003A, 6},{0x0019, 6},{0x005C, 7}, + {0x00BA, 8},{0x0061, 8},{0x00C1, 9},{0x0180,10}, + {0x0302,11},{0x0607,12},{0x0606,12},{0x0002, 3}, + {0x000A, 4},{0x001F, 5},{0x001C, 5},{0x0037, 6}, + {0x0016, 5},{0x0076, 7},{0x000D, 5},{0x002F, 6} + }, + { + {0x0000, 3},{0x000A, 4},{0x001A, 5},{0x000C, 4}, + {0x001D, 5},{0x0039, 6},{0x0078, 7},{0x005E, 7}, + {0x0393,11},{0x0002, 3},{0x0001, 3},{0x0016, 5}, + {0x000F, 5},{0x002E, 6},{0x005F, 7},{0x0073, 8}, + {0x00E5, 9},{0x01C8,10},{0x0E4A,13},{0x1C97,14}, + {0x1C96,14},{0x0E49,13},{0x0E48,13},{0x0004, 3}, + {0x0006, 4},{0x001F, 5},{0x001B, 5},{0x001D, 6}, + {0x0038, 6},{0x0038, 7},{0x003D, 6},{0x0079, 7} + }, + { + {0x000B, 5},{0x002B, 7},{0x0054, 8},{0x01B7, 9}, + {0x06D9,11},{0x0DB1,12},{0x0DB0,12},{0x0002, 4}, + {0x00AB, 9},{0x0009, 4},{0x000A, 4},{0x0007, 4}, + {0x0008, 4},{0x000F, 4},{0x000C, 4},{0x0003, 4}, + {0x001D, 5},{0x0004, 4},{0x000B, 4},{0x0006, 4}, + {0x001A, 5},{0x0003, 6},{0x00AA, 9},{0x0001, 4}, + {0x0000, 5},{0x0014, 6},{0x006C, 7},{0x00DA, 8}, + {0x0002, 6},{0x036D,10},{0x001C, 5},{0x0037, 6} + }, + { + {0x001D, 5},{0x0004, 6},{0x00B6, 8},{0x006A, 8}, + {0x05B9,11},{0x16E1,13},{0x16E0,13},{0x0007, 4}, + {0x016F, 9},{0x000C, 4},{0x000D, 4},{0x0009, 4}, + {0x0008, 4},{0x000F, 4},{0x000A, 4},{0x0003, 4}, + {0x0017, 5},{0x0002, 4},{0x0004, 4},{0x001C, 5}, + {0x002C, 6},{0x006B, 8},{0x0B71,12},{0x0005, 4}, + {0x0003, 5},{0x001B, 6},{0x005A, 7},{0x0034, 7}, + {0x0005, 6},{0x02DD,10},{0x0000, 4},{0x000C, 5} + }, + { + {0x0003, 4},{0x007F, 7},{0x00A1, 8},{0x00A0, 8}, + {0x020C,10},{0x0834,12},{0x106B,13},{0x0007, 4}, + {0x0082, 8},{0x000E, 4},{0x000D, 4},{0x000B, 4}, + {0x000C, 4},{0x0000, 3},{0x0009, 4},{0x0002, 4}, + {0x0011, 5},{0x001E, 5},{0x0015, 5},{0x003E, 6}, + {0x0040, 7},{0x041B,11},{0x106A,13},{0x0006, 4}, + {0x000A, 5},{0x0029, 6},{0x007E, 7},{0x0051, 7}, + {0x0021, 6},{0x0107, 9},{0x0004, 4},{0x000B, 5} + }, + { + {0x0007, 4},{0x001B, 6},{0x00F6, 8},{0x00E9, 8}, + {0x03A1,10},{0x0740,11},{0x0E82,12},{0x001F, 5}, + {0x01EF, 9},{0x0001, 3},{0x0002, 3},{0x000B, 4}, + {0x000C, 4},{0x000D, 4},{0x0008, 4},{0x001C, 5}, + {0x0003, 5},{0x0012, 5},{0x0002, 5},{0x0075, 7}, + {0x01D1, 9},{0x1D07,13},{0x1D06,13},{0x000A, 4}, + {0x0013, 5},{0x003B, 6},{0x001A, 6},{0x007A, 7}, + {0x003C, 6},{0x01EE, 9},{0x0000, 4},{0x000C, 5} + }, + { + {0x000D, 4},{0x003D, 6},{0x0042, 7},{0x0037, 7}, + {0x00D9, 9},{0x0362,11},{0x06C6,12},{0x001F, 5}, + {0x0086, 8},{0x0001, 3},{0x0002, 3},{0x000C, 4}, + {0x000B, 4},{0x000A, 4},{0x0001, 4},{0x000F, 5}, + {0x0025, 6},{0x003C, 6},{0x001A, 6},{0x0087, 8}, + {0x01B0,10},{0x0D8F,13},{0x0D8E,13},{0x000E, 4}, + {0x0013, 5},{0x000C, 5},{0x0024, 6},{0x0020, 6}, + {0x0011, 5},{0x006D, 8},{0x0000, 4},{0x000E, 5} + }, + { + {0x0000, 3},{0x0012, 5},{0x0076, 7},{0x0077, 7}, + {0x014D, 9},{0x0533,11},{0x14C9,13},{0x0013, 5}, + {0x00A5, 8},{0x0002, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x0008, 4},{0x001A, 5},{0x002B, 6}, + {0x0075, 7},{0x0074, 7},{0x00A7, 8},{0x0298,10}, + {0x14C8,13},{0x14CB,13},{0x14CA,13},{0x000F, 4}, + {0x001C, 5},{0x0007, 5},{0x002A, 6},{0x0028, 6}, + {0x001B, 5},{0x00A4, 8},{0x0002, 4},{0x0006, 5} + }, + { + {0x0002, 3},{0x001A, 5},{0x002B, 6},{0x003A, 6}, + {0x00ED, 8},{0x0283,10},{0x0A0A,12},{0x0004, 5}, + {0x00A1, 8},{0x0004, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x001F, 5},{0x0006, 5},{0x0077, 7}, + {0x00A3, 8},{0x00A2, 8},{0x0140, 9},{0x1417,13}, + {0x1416,13},{0x0A09,12},{0x0A08,12},{0x0000, 3}, + {0x001E, 5},{0x0007, 5},{0x002A, 6},{0x0029, 6}, + {0x001C, 5},{0x00EC, 8},{0x001B, 5},{0x0005, 5} + }, + { + {0x0002, 3},{0x0002, 4},{0x0018, 5},{0x001D, 5}, + {0x0035, 6},{0x00E4, 8},{0x01CF,11},{0x001D, 7}, + {0x0072, 9},{0x0004, 3},{0x0005, 3},{0x0006, 4}, + {0x0007, 4},{0x0006, 5},{0x0073, 7},{0x0038, 8}, + {0x01CE,11},{0x039B,12},{0x0398,12},{0x0733,13}, + {0x0732,13},{0x0735,13},{0x0734,13},{0x0000, 3}, + {0x001F, 5},{0x001B, 5},{0x0034, 6},{0x000F, 6}, + {0x001E, 5},{0x00E5, 8},{0x0019, 5},{0x0038, 6} + }, + { + {0x0016, 5},{0x0050, 7},{0x0172, 9},{0x02E7,10}, + {0x1732,13},{0x2E67,14},{0x2E66,14},{0x0006, 4}, + {0x0051, 7},{0x0001, 3},{0x0000, 3},{0x000D, 4}, + {0x000C, 4},{0x0009, 4},{0x001C, 5},{0x0009, 5}, + {0x001C, 6},{0x001D, 6},{0x005D, 7},{0x00B8, 8}, + {0x05CD,11},{0x1731,13},{0x1730,13},{0x000F, 4}, + {0x0005, 4},{0x000F, 5},{0x0008, 5},{0x0029, 6}, + {0x001D, 5},{0x002F, 6},{0x0008, 4},{0x0015, 5} + }, + { + {0x0009, 4},{0x0021, 6},{0x0040, 7},{0x00AD, 8}, + {0x02B0,10},{0x1589,13},{0x1588,13},{0x001C, 5}, + {0x005F, 7},{0x0000, 3},{0x000F, 4},{0x000D, 4}, + {0x000C, 4},{0x0006, 4},{0x0011, 5},{0x002A, 6}, + {0x0057, 7},{0x005E, 7},{0x0041, 7},{0x0159, 9}, + {0x0563,11},{0x158B,13},{0x158A,13},{0x0001, 3}, + {0x0005, 4},{0x0014, 5},{0x003B, 6},{0x002E, 6}, + {0x0004, 4},{0x003A, 6},{0x0007, 4},{0x0016, 5} + }, + { + {0x000E, 4},{0x0007, 5},{0x0046, 7},{0x0045, 7}, + {0x0064, 9},{0x032A,12},{0x0657,13},{0x0018, 5}, + {0x000D, 6},{0x0000, 3},{0x000F, 4},{0x000A, 4}, + {0x000B, 4},{0x001A, 5},{0x0036, 6},{0x0047, 7}, + {0x0044, 7},{0x0018, 7},{0x0033, 8},{0x00CB,10}, + {0x0656,13},{0x0329,12},{0x0328,12},{0x0002, 3}, + {0x0006, 4},{0x0019, 5},{0x000E, 5},{0x0037, 6}, + {0x0009, 4},{0x000F, 5},{0x0002, 4},{0x0010, 5} + }, + { + {0x0003, 3},{0x0018, 5},{0x0023, 6},{0x0077, 7}, + {0x0194, 9},{0x1956,13},{0x32AF,14},{0x003A, 6}, + {0x0076, 7},{0x0002, 3},{0x0001, 3},{0x001F, 5}, + {0x001E, 5},{0x0014, 5},{0x0022, 6},{0x0064, 7}, + {0x0197, 9},{0x0196, 9},{0x032B,10},{0x0654,11}, + {0x32AE,14},{0x1955,13},{0x1954,13},{0x0000, 3}, + {0x0009, 4},{0x001C, 5},{0x0015, 5},{0x0010, 5}, + {0x000D, 4},{0x0017, 5},{0x0016, 5},{0x0033, 6} + }, + { + {0x0005, 3},{0x0006, 4},{0x003E, 6},{0x0010, 5}, + {0x0048, 7},{0x093F,12},{0x24FA,14},{0x0032, 6}, + {0x0067, 7},{0x0002, 3},{0x0001, 3},{0x001B, 5}, + {0x001E, 5},{0x0034, 6},{0x0066, 7},{0x0092, 8}, + {0x0126, 9},{0x024E,10},{0x049E,11},{0x49F7,15}, + {0x49F6,15},{0x24F9,14},{0x24F8,14},{0x0000, 3}, + {0x0007, 4},{0x0018, 5},{0x0011, 5},{0x003F, 6}, + {0x000E, 4},{0x0013, 5},{0x0035, 6},{0x0025, 6} + }, + { + {0x0005, 3},{0x0008, 4},{0x0012, 5},{0x001C, 5}, + {0x001C, 6},{0x00EA, 9},{0x1D75,14},{0x001E, 6}, + {0x0066, 7},{0x0001, 3},{0x0002, 3},{0x001B, 5}, + {0x001A, 5},{0x001F, 6},{0x003B, 7},{0x0074, 8}, + {0x01D6,10},{0x03AF,11},{0x1D74,14},{0x1D77,14}, + {0x1D76,14},{0x0EB9,13},{0x0EB8,13},{0x000F, 4}, + {0x0006, 4},{0x0013, 5},{0x003B, 6},{0x003A, 6}, + {0x0000, 3},{0x0018, 5},{0x0032, 6},{0x0067, 7} + }, + { + {0x0004, 3},{0x000A, 4},{0x001B, 5},{0x000C, 4}, + {0x000D, 5},{0x00E6, 8},{0x0684,11},{0x0072, 7}, + {0x00E7, 8},{0x0002, 3},{0x0001, 3},{0x0017, 5}, + {0x0016, 5},{0x0018, 6},{0x00D1, 8},{0x01A0, 9}, + {0x0686,11},{0x0D0F,12},{0x0D0A,12},{0x1A17,13}, + {0x1A16,13},{0x1A1D,13},{0x1A1C,13},{0x000F, 4}, + {0x001D, 5},{0x000E, 5},{0x0035, 6},{0x0038, 6}, + {0x0000, 3},{0x000F, 5},{0x0019, 6},{0x0069, 7} + }, + { + {0x0003, 3},{0x000C, 4},{0x001B, 5},{0x0000, 3}, + {0x0003, 4},{0x002E, 6},{0x0051, 9},{0x00BC, 8}, + {0x0053, 9},{0x0004, 3},{0x0002, 3},{0x0016, 5}, + {0x0015, 5},{0x0015, 7},{0x0050, 9},{0x00A4,10}, + {0x0294,12},{0x052B,13},{0x052A,13},{0x052D,13}, + {0x052C,13},{0x052F,13},{0x052E,13},{0x000E, 4}, + {0x001A, 5},{0x0004, 5},{0x0028, 6},{0x0029, 6}, + {0x000F, 4},{0x000B, 6},{0x005F, 7},{0x00BD, 8} + }, + { + {0x0003, 4},{0x0009, 6},{0x00D0, 8},{0x01A3, 9}, + {0x0344,10},{0x0D14,12},{0x1A2B,13},{0x0004, 4}, + {0x0015, 7},{0x0000, 3},{0x000F, 4},{0x000B, 4}, + {0x000C, 4},{0x000E, 4},{0x0009, 4},{0x001B, 5}, + {0x000A, 5},{0x0014, 5},{0x000D, 5},{0x002A, 6}, + {0x0014, 7},{0x068B,11},{0x1A2A,13},{0x0008, 4}, + {0x000B, 5},{0x002B, 6},{0x000B, 6},{0x0069, 7}, + {0x0035, 6},{0x0008, 6},{0x0007, 4},{0x000C, 5} + }, + { + {0x000A, 4},{0x003C, 6},{0x0032, 7},{0x0030, 7}, + {0x00C5, 9},{0x0621,12},{0x0620,12},{0x001F, 5}, + {0x0033, 7},{0x0001, 3},{0x0000, 3},{0x000E, 4}, + {0x000D, 4},{0x000C, 4},{0x0004, 4},{0x000D, 5}, + {0x0026, 6},{0x0027, 6},{0x0014, 6},{0x0063, 8}, + {0x0189,10},{0x0623,12},{0x0622,12},{0x000B, 4}, + {0x0012, 5},{0x003D, 6},{0x0022, 6},{0x0015, 6}, + {0x000B, 5},{0x0023, 6},{0x0007, 4},{0x0010, 5} + }, + { + {0x000F, 4},{0x000C, 5},{0x0043, 7},{0x0010, 6}, + {0x0044, 8},{0x0114,10},{0x0455,12},{0x0018, 5}, + {0x0023, 7},{0x0001, 3},{0x0000, 3},{0x000E, 4}, + {0x000D, 4},{0x0009, 4},{0x0019, 5},{0x0009, 5}, + {0x0017, 6},{0x0016, 6},{0x0042, 7},{0x008B, 9}, + {0x0454,12},{0x0457,12},{0x0456,12},{0x000B, 4}, + {0x0015, 5},{0x000A, 5},{0x0029, 6},{0x0020, 6}, + {0x000D, 5},{0x0028, 6},{0x0007, 4},{0x0011, 5} + }, + { + {0x0001, 3},{0x001A, 5},{0x0029, 6},{0x002A, 6}, + {0x00A0, 8},{0x0285,10},{0x1425,13},{0x0002, 5}, + {0x0000, 7},{0x0002, 3},{0x0003, 3},{0x000C, 4}, + {0x000B, 4},{0x0008, 4},{0x0012, 5},{0x0001, 6}, + {0x0051, 7},{0x0001, 7},{0x0143, 9},{0x0508,11}, + {0x1424,13},{0x1427,13},{0x1426,13},{0x000F, 4}, + {0x001C, 5},{0x0003, 5},{0x0037, 6},{0x002B, 6}, + {0x0013, 5},{0x0036, 6},{0x001D, 5},{0x0001, 5} + }, + { + {0x0004, 3},{0x001F, 5},{0x003D, 6},{0x0006, 5}, + {0x0016, 7},{0x0053, 9},{0x014A,11},{0x0034, 6}, + {0x002A, 8},{0x0002, 3},{0x0003, 3},{0x000B, 4}, + {0x000C, 4},{0x001C, 5},{0x0037, 6},{0x0017, 7}, + {0x002B, 8},{0x0028, 8},{0x00A4,10},{0x052D,13}, + {0x052C,13},{0x052F,13},{0x052E,13},{0x0000, 3}, + {0x001D, 5},{0x0007, 5},{0x0004, 5},{0x0035, 6}, + {0x0014, 5},{0x0036, 6},{0x0015, 5},{0x003C, 6} + }, + { + {0x0004, 3},{0x000A, 4},{0x0007, 5},{0x001D, 5}, + {0x0009, 6},{0x01F3, 9},{0x07C7,11},{0x0008, 6}, + {0x01F0, 9},{0x0003, 3},{0x0002, 3},{0x000D, 4}, + {0x000C, 4},{0x0017, 5},{0x007D, 7},{0x01F2, 9}, + {0x07C6,11},{0x07C5,11},{0x1F12,13},{0x3E27,14}, + {0x3E26,14},{0x1F11,13},{0x1F10,13},{0x0000, 3}, + {0x001E, 5},{0x0006, 5},{0x0039, 6},{0x0038, 6}, + {0x003F, 6},{0x002C, 6},{0x0005, 5},{0x002D, 6} + }, + { + {0x0002, 3},{0x0007, 4},{0x0018, 5},{0x0003, 4}, + {0x0005, 5},{0x0035, 7},{0x004F, 9},{0x0012, 7}, + {0x04E5,13},{0x0005, 3},{0x0004, 3},{0x000D, 4}, + {0x000E, 4},{0x0033, 6},{0x0026, 8},{0x009D,10}, + {0x04E4,13},{0x04E7,13},{0x04E6,13},{0x04E1,13}, + {0x04E0,13},{0x04E3,13},{0x04E2,13},{0x0000, 3}, + {0x001F, 5},{0x000C, 5},{0x003D, 6},{0x003C, 6}, + {0x0032, 6},{0x0034, 7},{0x001B, 6},{0x0008, 6} + }, + { + {0x0000, 3},{0x0004, 4},{0x001C, 5},{0x000F, 4}, + {0x0002, 4},{0x0007, 5},{0x0075, 7},{0x00E8, 8}, + {0x1D2A,13},{0x0005, 3},{0x0004, 3},{0x000D, 4}, + {0x000C, 4},{0x0077, 7},{0x0E96,12},{0x3A57,14}, + {0x3A56,14},{0x3A5D,14},{0x3A5C,14},{0x3A5F,14}, + {0x3A5E,14},{0x1D29,13},{0x1D28,13},{0x0003, 3}, + {0x0006, 5},{0x000A, 5},{0x002C, 7},{0x0017, 6}, + {0x0076, 7},{0x01D3, 9},{0x03A4,10},{0x002D, 7} + }, + { + {0x000A, 4},{0x0024, 6},{0x00BF, 8},{0x0085, 8}, + {0x0211,10},{0x0842,12},{0x1087,13},{0x0018, 5}, + {0x0020, 6},{0x0001, 3},{0x0002, 3},{0x000E, 4}, + {0x000D, 4},{0x0007, 4},{0x0013, 5},{0x0025, 6}, + {0x005E, 7},{0x0043, 7},{0x00BE, 8},{0x0109, 9}, + {0x1086,13},{0x0841,12},{0x0840,12},{0x000F, 4}, + {0x0001, 4},{0x0011, 5},{0x0000, 5},{0x002E, 6}, + {0x0019, 5},{0x0001, 5},{0x0006, 4},{0x0016, 5} + }, + { + {0x0002, 3},{0x000F, 5},{0x006F, 7},{0x0061, 7}, + {0x0374,10},{0x1BA8,13},{0x3753,14},{0x0012, 5}, + {0x0036, 6},{0x0000, 3},{0x0001, 3},{0x000A, 4}, + {0x000B, 4},{0x001A, 5},{0x0031, 6},{0x0060, 7}, + {0x00DC, 8},{0x01BB, 9},{0x06EB,11},{0x1BAB,13}, + {0x3752,14},{0x3755,14},{0x3754,14},{0x000E, 4}, + {0x0006, 4},{0x0013, 5},{0x000E, 5},{0x003E, 6}, + {0x0008, 4},{0x001E, 5},{0x0019, 5},{0x003F, 6} + }, + { + {0x0003, 3},{0x001C, 5},{0x0025, 6},{0x0024, 6}, + {0x01DA, 9},{0x1DBD,13},{0x3B7C,14},{0x003C, 6}, + {0x003D, 6},{0x0000, 3},{0x0001, 3},{0x000B, 4}, + {0x000A, 4},{0x000B, 5},{0x0077, 7},{0x00EC, 8}, + {0x03B6,10},{0x076E,11},{0x1DBF,13},{0x76FB,15}, + {0x76FA,15},{0x3B79,14},{0x3B78,14},{0x000D, 4}, + {0x001F, 5},{0x0013, 5},{0x000A, 5},{0x0008, 5}, + {0x000C, 4},{0x0008, 4},{0x0009, 5},{0x003A, 6} + }, + { + {0x0005, 3},{0x0003, 4},{0x0004, 5},{0x0010, 5}, + {0x008F, 8},{0x0475,11},{0x11D1,13},{0x0079, 7}, + {0x0027, 6},{0x0002, 3},{0x0003, 3},{0x0001, 4}, + {0x0000, 4},{0x0026, 6},{0x0046, 7},{0x011C, 9}, + {0x0477,11},{0x08ED,12},{0x11D0,13},{0x11D3,13}, + {0x11D2,13},{0x11D9,13},{0x11D8,13},{0x000D, 4}, + {0x001F, 5},{0x0012, 5},{0x0005, 5},{0x003D, 6}, + {0x000C, 4},{0x000E, 4},{0x0022, 6},{0x0078, 7} + }, + { + {0x0005, 3},{0x000C, 4},{0x001B, 5},{0x0000, 4}, + {0x0006, 6},{0x03E2,10},{0x3E3D,14},{0x000F, 7}, + {0x0034, 6},{0x0003, 3},{0x0002, 3},{0x001E, 5}, + {0x001D, 5},{0x007D, 7},{0x01F0, 9},{0x07C6,11}, + {0x3E3C,14},{0x3E3F,14},{0x3E3E,14},{0x3E39,14}, + {0x3E38,14},{0x3E3B,14},{0x3E3A,14},{0x0008, 4}, + {0x001C, 5},{0x0002, 5},{0x003F, 6},{0x0035, 6}, + {0x0009, 4},{0x0001, 3},{0x000E, 7},{0x00F9, 8} + }, + { + {0x0004, 3},{0x000B, 4},{0x0001, 4},{0x000A, 4}, + {0x001E, 6},{0x00E0, 9},{0x0E1E,13},{0x0071, 8}, + {0x0039, 7},{0x0007, 3},{0x0006, 3},{0x000D, 5}, + {0x000C, 5},{0x0020, 7},{0x01C2,10},{0x1C3F,14}, + {0x1C3E,14},{0x0E19,13},{0x0E18,13},{0x0E1B,13}, + {0x0E1A,13},{0x0E1D,13},{0x0E1C,13},{0x0000, 4}, + {0x0009, 5},{0x001D, 6},{0x001F, 6},{0x0011, 6}, + {0x0005, 4},{0x0001, 3},{0x0043, 8},{0x0042, 8} + }, + { + {0x0004, 3},{0x000D, 4},{0x0007, 4},{0x0002, 3}, + {0x0014, 5},{0x016C, 9},{0x16D1,13},{0x02DF,10}, + {0x016E, 9},{0x0000, 2},{0x0007, 3},{0x002C, 6}, + {0x002B, 6},{0x02DE,10},{0x16D0,13},{0x16D3,13}, + {0x16D2,13},{0x2DB5,14},{0x2DB4,14},{0x2DB7,14}, + {0x2DB6,14},{0x16D9,13},{0x16D8,13},{0x000C, 5}, + {0x002A, 6},{0x005A, 7},{0x001B, 6},{0x001A, 6}, + {0x0017, 5},{0x000C, 4},{0x05B7,11},{0x05B5,11} + }, + { + {0x0002, 2},{0x000F, 4},{0x001C, 5},{0x000C, 4}, + {0x003B, 6},{0x01AC, 9},{0x1AD8,13},{0x35B3,14}, + {0x35B2,14},{0x0001, 2},{0x0000, 2},{0x0069, 7}, + {0x0068, 7},{0x35BD,14},{0x35BC,14},{0x35BF,14}, + {0x35BE,14},{0x35B9,14},{0x35B8,14},{0x35BB,14}, + {0x35BA,14},{0x35B5,14},{0x35B4,14},{0x01A9, 9}, + {0x01A8, 9},{0x035A,10},{0x00D7, 8},{0x00D5, 8}, + {0x003A, 6},{0x001B, 5},{0x35B7,14},{0x35B6,14} + }, + { + {0x0000, 3},{0x0010, 5},{0x0072, 7},{0x0071, 7}, + {0x0154, 9},{0x0AAB,12},{0x0AA8,12},{0x0014, 5}, + {0x0070, 7},{0x0002, 3},{0x0003, 3},{0x000C, 4}, + {0x000B, 4},{0x0003, 4},{0x0011, 5},{0x0073, 7}, + {0x0054, 7},{0x00AB, 8},{0x02AB,10},{0x1553,13}, + {0x1552,13},{0x1555,13},{0x1554,13},{0x000D, 4}, + {0x001E, 5},{0x0012, 5},{0x003E, 6},{0x002B, 6}, + {0x0002, 4},{0x003F, 6},{0x001D, 5},{0x0013, 5} + }, + { + {0x0003, 3},{0x001F, 5},{0x0029, 6},{0x003D, 6}, + {0x000C, 7},{0x0069,10},{0x0345,13},{0x0002, 5}, + {0x0028, 6},{0x0002, 3},{0x0001, 3},{0x000E, 4}, + {0x000C, 4},{0x0015, 5},{0x0007, 6},{0x001B, 8}, + {0x006B,10},{0x006A,10},{0x0344,13},{0x0347,13}, + {0x0346,13},{0x01A1,12},{0x01A0,12},{0x000B, 4}, + {0x001A, 5},{0x0012, 5},{0x0000, 5},{0x003C, 6}, + {0x0008, 4},{0x001B, 5},{0x0013, 5},{0x0001, 5} + }, + { + {0x0004, 3},{0x0004, 4},{0x003F, 6},{0x0014, 5}, + {0x0056, 7},{0x015C, 9},{0x15D5,13},{0x003C, 6}, + {0x002A, 6},{0x0000, 3},{0x0001, 3},{0x000E, 4}, + {0x000D, 4},{0x000C, 5},{0x00AF, 8},{0x02BB,10}, + {0x15D4,13},{0x15D7,13},{0x15D6,13},{0x15D1,13}, + {0x15D0,13},{0x15D3,13},{0x15D2,13},{0x000B, 4}, + {0x0019, 5},{0x000D, 5},{0x003E, 6},{0x0031, 6}, + {0x0007, 4},{0x0005, 4},{0x003D, 6},{0x0030, 6} + }, + { + {0x0005, 3},{0x0008, 4},{0x001A, 5},{0x0000, 4}, + {0x0036, 6},{0x0011, 8},{0x0106,12},{0x000A, 7}, + {0x006E, 7},{0x0002, 3},{0x0003, 3},{0x0003, 4}, + {0x0002, 4},{0x006F, 7},{0x0021, 9},{0x020F,13}, + {0x020E,13},{0x0101,12},{0x0100,12},{0x0103,12}, + {0x0102,12},{0x0105,12},{0x0104,12},{0x000C, 4}, + {0x001E, 5},{0x0003, 5},{0x003E, 6},{0x003F, 6}, + {0x0009, 4},{0x000E, 4},{0x000B, 7},{0x0009, 7} + }, + { + {0x0002, 3},{0x000E, 4},{0x001E, 5},{0x000C, 4}, + {0x001F, 5},{0x006E, 7},{0x00AD,10},{0x00AF,10}, + {0x0014, 7},{0x0004, 3},{0x0003, 3},{0x001A, 5}, + {0x0017, 5},{0x002A, 8},{0x0576,13},{0x0AEF,14}, + {0x0AEE,14},{0x0571,13},{0x0570,13},{0x0573,13}, + {0x0572,13},{0x0575,13},{0x0574,13},{0x0003, 4}, + {0x0016, 5},{0x0004, 5},{0x0036, 6},{0x000B, 6}, + {0x000A, 4},{0x0000, 3},{0x006F, 7},{0x00AC,10} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0004, 3},{0x0005, 4},{0x0003, 3},{0x0001, 3}, + {0x0004, 4},{0x002F, 6},{0x0526,11},{0x1495,13}, + {0x00A6, 8},{0x0007, 3},{0x0006, 3},{0x002D, 6}, + {0x002C, 6},{0x1494,13},{0x1497,13},{0x1496,13}, + {0x1491,13},{0x1490,13},{0x1493,13},{0x1492,13}, + {0x293D,14},{0x293C,14},{0x293F,14},{0x0000, 3}, + {0x0028, 6},{0x00A5, 8},{0x0148, 9},{0x00A7, 8}, + {0x002E, 6},{0x0015, 5},{0x0A4E,12},{0x293E,14} + }, + { + {0x0003, 3},{0x0011, 5},{0x0020, 6},{0x0074, 7}, + {0x010D, 9},{0x0863,12},{0x0860,12},{0x000A, 5}, + {0x0075, 7},{0x0001, 3},{0x0000, 3},{0x000B, 4}, + {0x000A, 4},{0x0018, 5},{0x0038, 6},{0x0042, 7}, + {0x010F, 9},{0x010E, 9},{0x0219,10},{0x10C3,13}, + {0x10C2,13},{0x10C5,13},{0x10C4,13},{0x000F, 4}, + {0x0004, 4},{0x0019, 5},{0x000B, 5},{0x0039, 6}, + {0x0009, 4},{0x001B, 5},{0x001A, 5},{0x003B, 6} + }, + { + {0x0005, 3},{0x0001, 4},{0x003E, 6},{0x0001, 5}, + {0x00E2, 8},{0x1C6F,13},{0x38D9,14},{0x0039, 6}, + {0x001F, 6},{0x0002, 3},{0x0001, 3},{0x0009, 4}, + {0x0008, 4},{0x0000, 5},{0x0070, 7},{0x01C7, 9}, + {0x038C,10},{0x071A,11},{0x38D8,14},{0x38DB,14}, + {0x38DA,14},{0x38DD,14},{0x38DC,14},{0x000D, 4}, + {0x001D, 5},{0x000E, 5},{0x003F, 6},{0x003C, 6}, + {0x000C, 4},{0x0006, 4},{0x003D, 6},{0x001E, 6} + }, + { + {0x0006, 3},{0x000B, 4},{0x0011, 5},{0x001E, 5}, + {0x0074, 7},{0x03AA,10},{0x1D5C,13},{0x0001, 6}, + {0x0021, 6},{0x0001, 3},{0x0002, 3},{0x0007, 4}, + {0x0006, 4},{0x003E, 6},{0x00EB, 8},{0x01D4, 9}, + {0x0EAF,12},{0x3ABB,14},{0x3ABA,14},{0x1D59,13}, + {0x1D58,13},{0x1D5B,13},{0x1D5A,13},{0x000A, 4}, + {0x001C, 5},{0x0001, 5},{0x003F, 6},{0x003B, 6}, + {0x0001, 4},{0x0009, 4},{0x0020, 6},{0x0000, 6} + }, + { + {0x0004, 3},{0x000A, 4},{0x0017, 5},{0x0004, 4}, + {0x0016, 6},{0x016A, 9},{0x16B1,13},{0x0017, 7}, + {0x005B, 7},{0x0006, 3},{0x0007, 3},{0x0001, 4}, + {0x0000, 4},{0x000A, 6},{0x02D7,10},{0x0B5A,12}, + {0x16B0,13},{0x16B3,13},{0x16B2,13},{0x2D6D,14}, + {0x2D6C,14},{0x2D6F,14},{0x2D6E,14},{0x0006, 4}, + {0x000A, 5},{0x0004, 5},{0x002C, 6},{0x0017, 6}, + {0x0003, 4},{0x0007, 4},{0x0016, 7},{0x00B4, 8} + }, + { + {0x0005, 3},{0x000D, 4},{0x0005, 4},{0x0009, 4}, + {0x0033, 6},{0x0193, 9},{0x192C,13},{0x0061, 8}, + {0x0031, 7},{0x0000, 2},{0x0007, 3},{0x0010, 5}, + {0x0011, 5},{0x00C8, 8},{0x192F,13},{0x325B,14}, + {0x325A,14},{0x1929,13},{0x1928,13},{0x192B,13}, + {0x192A,13},{0x325D,14},{0x325C,14},{0x0018, 5}, + {0x001A, 6},{0x001B, 6},{0x0065, 7},{0x0019, 6}, + {0x0004, 4},{0x0007, 4},{0x0060, 8},{0x0324,10} + }, + { + {0x0006, 3},{0x0000, 3},{0x0002, 4},{0x000F, 4}, + {0x0039, 6},{0x01D9, 9},{0x1D82,13},{0x0761,11}, + {0x03BE,10},{0x0001, 2},{0x0002, 2},{0x000F, 6}, + {0x000E, 6},{0x0762,11},{0x3B07,14},{0x3B06,14}, + {0x3B1D,14},{0x3B1C,14},{0x3B1F,14},{0x3B1E,14}, + {0x3B19,14},{0x3B18,14},{0x3B1B,14},{0x0038, 6}, + {0x01DE, 9},{0x00ED, 8},{0x03BF,10},{0x00EE, 8}, + {0x003A, 6},{0x0006, 5},{0x0EC0,12},{0x3B1A,14} + }, + { + {0x0000, 2},{0x0002, 3},{0x000F, 5},{0x0006, 4}, + {0x001C, 6},{0x01D0,10},{0x0E8C,13},{0x1D1B,14}, + {0x1D1A,14},{0x0003, 2},{0x0002, 2},{0x00EA, 9}, + {0x00E9, 9},{0x0E89,13},{0x0E88,13},{0x0E8B,13}, + {0x0E8A,13},{0x1D65,14},{0x1D64,14},{0x1D67,14}, + {0x1D66,14},{0x1D61,14},{0x1D60,14},{0x03AD,11}, + {0x1D63,14},{0x1D62,14},{0x1D1D,14},{0x1D1C,14}, + {0x003B, 7},{0x01D7,10},{0x1D1F,14},{0x1D1E,14} + }, + { + {0x0002, 2},{0x000F, 4},{0x001C, 5},{0x000C, 4}, + {0x003B, 6},{0x01AC, 9},{0x1AD8,13},{0x35B3,14}, + {0x35B2,14},{0x0001, 2},{0x0000, 2},{0x0069, 7}, + {0x0068, 7},{0x35BD,14},{0x35BC,14},{0x35BF,14}, + {0x35BE,14},{0x35B9,14},{0x35B8,14},{0x35BB,14}, + {0x35BA,14},{0x35B5,14},{0x35B4,14},{0x01A9, 9}, + {0x01A8, 9},{0x035A,10},{0x00D7, 8},{0x00D5, 8}, + {0x003A, 6},{0x001B, 5},{0x35B7,14},{0x35B6,14} + } +}; + + + +/*A description of a Huffman code value used when encoding the tree.*/ +typedef struct{ + /*The bit pattern, left-shifted so that the MSB of all patterns is + aligned.*/ + ogg_uint32_t pattern; + /*The amount the bit pattern was shifted.*/ + int shift; + /*The token this bit pattern represents.*/ + int token; +}oc_huff_entry; + + + +/*Compares two oc_huff_entry structures by their bit patterns. + _c1: The first entry to compare. + _c2: The second entry to compare. + Return: <0 if _c1<_c2, >0 if _c1>_c2.*/ +static int huff_entry_cmp(const void *_c1,const void *_c2){ + ogg_uint32_t b1; + ogg_uint32_t b2; + b1=((const oc_huff_entry *)_c1)->pattern; + b2=((const oc_huff_entry *)_c2)->pattern; + return b1b2?1:0; +} + +/*Encodes a description of the given Huffman tables. + Although the codes are stored in the encoder as flat arrays, in the bit + stream and in the decoder they are structured as a tree. + This function recovers the tree structure from the flat array and then + writes it out. + Note that the codes MUST form a Huffman code, and not merely a prefix-free + code, since the binary tree is assumed to be full. + _opb: The buffer to store the tree in. + _codes: The Huffman tables to pack. + Return: 0 on success, or a negative value if one of the given Huffman tables + does not form a full, prefix-free code.*/ +int oc_huff_codes_pack(oggpack_buffer *_opb, + const th_huff_code _codes[TH_NHUFFMAN_TABLES][TH_NDCT_TOKENS]){ + int i; + for(i=0;i>1)<<(maxlen+1>>1))-1; + /*Copy over the codes into our temporary workspace. + The bit patterns are aligned, and the original entry each code is from + is stored as well.*/ + for(j=0;jentries[j].shift;bpos--)oggpackB_write(_opb,0,1); + /*Mark this as a leaf node, and write its value.*/ + oggpackB_write(_opb,1,1); + oggpackB_write(_opb,entries[j].token,5); + /*For each 1 branch we've descended, back up the tree until we reach a + 0 branch.*/ + bit=1< +#include "internal.h" +#include "dct.h" + +/*Performs an inverse 8 point Type-II DCT transform. + The output is scaled by a factor of 2 relative to the orthonormal version of + the transform. + _y: The buffer to store the result in. + Data will be placed in every 8th entry (e.g., in a column of an 8x8 + block). + _x: The input coefficients. + The first 8 entries are used (e.g., from a row of an 8x8 block).*/ +static void idct8(ogg_int16_t *_y,const ogg_int16_t _x[8]){ + ogg_int32_t t[8]; + ogg_int32_t r; + /*Stage 1:*/ + /*0-1 butterfly.*/ + t[0]=OC_C4S4*(ogg_int16_t)(_x[0]+_x[4])>>16; + t[1]=OC_C4S4*(ogg_int16_t)(_x[0]-_x[4])>>16; + /*2-3 rotation by 6pi/16.*/ + t[2]=(OC_C6S2*_x[2]>>16)-(OC_C2S6*_x[6]>>16); + t[3]=(OC_C2S6*_x[2]>>16)+(OC_C6S2*_x[6]>>16); + /*4-7 rotation by 7pi/16.*/ + t[4]=(OC_C7S1*_x[1]>>16)-(OC_C1S7*_x[7]>>16); + /*5-6 rotation by 3pi/16.*/ + t[5]=(OC_C3S5*_x[5]>>16)-(OC_C5S3*_x[3]>>16); + t[6]=(OC_C5S3*_x[5]>>16)+(OC_C3S5*_x[3]>>16); + t[7]=(OC_C1S7*_x[1]>>16)+(OC_C7S1*_x[7]>>16); + /*Stage 2:*/ + /*4-5 butterfly.*/ + r=t[4]+t[5]; + t[5]=OC_C4S4*(ogg_int16_t)(t[4]-t[5])>>16; + t[4]=r; + /*7-6 butterfly.*/ + r=t[7]+t[6]; + t[6]=OC_C4S4*(ogg_int16_t)(t[7]-t[6])>>16; + t[7]=r; + /*Stage 3:*/ + /*0-3 butterfly.*/ + r=t[0]+t[3]; + t[3]=t[0]-t[3]; + t[0]=r; + /*1-2 butterfly.*/ + r=t[1]+t[2]; + t[2]=t[1]-t[2]; + t[1]=r; + /*6-5 butterfly.*/ + r=t[6]+t[5]; + t[5]=t[6]-t[5]; + t[6]=r; + /*Stage 4:*/ + /*0-7 butterfly.*/ + _y[0<<3]=(ogg_int16_t)(t[0]+t[7]); + /*1-6 butterfly.*/ + _y[1<<3]=(ogg_int16_t)(t[1]+t[6]); + /*2-5 butterfly.*/ + _y[2<<3]=(ogg_int16_t)(t[2]+t[5]); + /*3-4 butterfly.*/ + _y[3<<3]=(ogg_int16_t)(t[3]+t[4]); + _y[4<<3]=(ogg_int16_t)(t[3]-t[4]); + _y[5<<3]=(ogg_int16_t)(t[2]-t[5]); + _y[6<<3]=(ogg_int16_t)(t[1]-t[6]); + _y[7<<3]=(ogg_int16_t)(t[0]-t[7]); +} + +/*Performs an inverse 8 point Type-II DCT transform. + The output is scaled by a factor of 2 relative to the orthonormal version of + the transform. + _y: The buffer to store the result in. + Data will be placed in every 8th entry (e.g., in a column of an 8x8 + block). + _x: The input coefficients. + Only the first 4 entries are used. + The other 4 are assumed to be 0.*/ +static void idct8_4(ogg_int16_t *_y,const ogg_int16_t _x[8]){ + ogg_int32_t t[8]; + ogg_int32_t r; + /*Stage 1:*/ + t[0]=OC_C4S4*_x[0]>>16; + t[2]=OC_C6S2*_x[2]>>16; + t[3]=OC_C2S6*_x[2]>>16; + t[4]=OC_C7S1*_x[1]>>16; + t[5]=-(OC_C5S3*_x[3]>>16); + t[6]=OC_C3S5*_x[3]>>16; + t[7]=OC_C1S7*_x[1]>>16; + /*Stage 2:*/ + r=t[4]+t[5]; + t[5]=OC_C4S4*(ogg_int16_t)(t[4]-t[5])>>16; + t[4]=r; + r=t[7]+t[6]; + t[6]=OC_C4S4*(ogg_int16_t)(t[7]-t[6])>>16; + t[7]=r; + /*Stage 3:*/ + t[1]=t[0]+t[2]; + t[2]=t[0]-t[2]; + r=t[0]+t[3]; + t[3]=t[0]-t[3]; + t[0]=r; + r=t[6]+t[5]; + t[5]=t[6]-t[5]; + t[6]=r; + /*Stage 4:*/ + _y[0<<3]=(ogg_int16_t)(t[0]+t[7]); + _y[1<<3]=(ogg_int16_t)(t[1]+t[6]); + _y[2<<3]=(ogg_int16_t)(t[2]+t[5]); + _y[3<<3]=(ogg_int16_t)(t[3]+t[4]); + _y[4<<3]=(ogg_int16_t)(t[3]-t[4]); + _y[5<<3]=(ogg_int16_t)(t[2]-t[5]); + _y[6<<3]=(ogg_int16_t)(t[1]-t[6]); + _y[7<<3]=(ogg_int16_t)(t[0]-t[7]); +} + +/*Performs an inverse 8 point Type-II DCT transform. + The output is scaled by a factor of 2 relative to the orthonormal version of + the transform. + _y: The buffer to store the result in. + Data will be placed in every 8th entry (e.g., in a column of an 8x8 + block). + _x: The input coefficients. + Only the first 3 entries are used. + The other 5 are assumed to be 0.*/ +static void idct8_3(ogg_int16_t *_y,const ogg_int16_t _x[8]){ + ogg_int32_t t[8]; + ogg_int32_t r; + /*Stage 1:*/ + t[0]=OC_C4S4*_x[0]>>16; + t[2]=OC_C6S2*_x[2]>>16; + t[3]=OC_C2S6*_x[2]>>16; + t[4]=OC_C7S1*_x[1]>>16; + t[7]=OC_C1S7*_x[1]>>16; + /*Stage 2:*/ + t[5]=OC_C4S4*t[4]>>16; + t[6]=OC_C4S4*t[7]>>16; + /*Stage 3:*/ + t[1]=t[0]+t[2]; + t[2]=t[0]-t[2]; + r=t[0]+t[3]; + t[3]=t[0]-t[3]; + t[0]=r; + r=t[6]+t[5]; + t[5]=t[6]-t[5]; + t[6]=r; + /*Stage 4:*/ + _y[0<<3]=(ogg_int16_t)(t[0]+t[7]); + _y[1<<3]=(ogg_int16_t)(t[1]+t[6]); + _y[2<<3]=(ogg_int16_t)(t[2]+t[5]); + _y[3<<3]=(ogg_int16_t)(t[3]+t[4]); + _y[4<<3]=(ogg_int16_t)(t[3]-t[4]); + _y[5<<3]=(ogg_int16_t)(t[2]-t[5]); + _y[6<<3]=(ogg_int16_t)(t[1]-t[6]); + _y[7<<3]=(ogg_int16_t)(t[0]-t[7]); +} + +/*Performs an inverse 8 point Type-II DCT transform. + The output is scaled by a factor of 2 relative to the orthonormal version of + the transform. + _y: The buffer to store the result in. + Data will be placed in every 8th entry (e.g., in a column of an 8x8 + block). + _x: The input coefficients. + Only the first 2 entries are used. + The other 6 are assumed to be 0.*/ +static void idct8_2(ogg_int16_t *_y,const ogg_int16_t _x[8]){ + ogg_int32_t t[8]; + ogg_int32_t r; + /*Stage 1:*/ + t[0]=OC_C4S4*_x[0]>>16; + t[4]=OC_C7S1*_x[1]>>16; + t[7]=OC_C1S7*_x[1]>>16; + /*Stage 2:*/ + t[5]=OC_C4S4*t[4]>>16; + t[6]=OC_C4S4*t[7]>>16; + /*Stage 3:*/ + r=t[6]+t[5]; + t[5]=t[6]-t[5]; + t[6]=r; + /*Stage 4:*/ + _y[0<<3]=(ogg_int16_t)(t[0]+t[7]); + _y[1<<3]=(ogg_int16_t)(t[0]+t[6]); + _y[2<<3]=(ogg_int16_t)(t[0]+t[5]); + _y[3<<3]=(ogg_int16_t)(t[0]+t[4]); + _y[4<<3]=(ogg_int16_t)(t[0]-t[4]); + _y[5<<3]=(ogg_int16_t)(t[0]-t[5]); + _y[6<<3]=(ogg_int16_t)(t[0]-t[6]); + _y[7<<3]=(ogg_int16_t)(t[0]-t[7]); +} + +/*Performs an inverse 8 point Type-II DCT transform. + The output is scaled by a factor of 2 relative to the orthonormal version of + the transform. + _y: The buffer to store the result in. + Data will be placed in every 8th entry (e.g., in a column of an 8x8 + block). + _x: The input coefficients. + Only the first entry is used. + The other 7 are assumed to be 0.*/ +static void idct8_1(ogg_int16_t *_y,const ogg_int16_t _x[1]){ + _y[0<<3]=_y[1<<3]=_y[2<<3]=_y[3<<3]= + _y[4<<3]=_y[5<<3]=_y[6<<3]=_y[7<<3]=(ogg_int16_t)(OC_C4S4*_x[0]>>16); +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform. + All coefficients but the first 3 in zig-zag scan order are assumed to be 0: + x x 0 0 0 0 0 0 + x 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + _y: The buffer to store the result in. + This may be the same as _x. + _x: The input coefficients.*/ +static void oc_idct8x8_3(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + const ogg_int16_t *in; + ogg_int16_t *end; + ogg_int16_t *out; + ogg_int16_t w[64]; + /*Transform rows of x into columns of w.*/ + idct8_2(w,_x); + idct8_1(w+1,_x+8); + /*Transform rows of w into columns of y.*/ + for(in=w,out=_y,end=out+8;out>4); +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform. + All coefficients but the first 10 in zig-zag scan order are assumed to be 0: + x x x x 0 0 0 0 + x x x 0 0 0 0 0 + x x 0 0 0 0 0 0 + x 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + 0 0 0 0 0 0 0 0 + _y: The buffer to store the result in. + This may be the same as _x. + _x: The input coefficients.*/ +static void oc_idct8x8_10(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + const ogg_int16_t *in; + ogg_int16_t *end; + ogg_int16_t *out; + ogg_int16_t w[64]; + /*Transform rows of x into columns of w.*/ + idct8_4(w,_x); + idct8_3(w+1,_x+8); + idct8_2(w+2,_x+16); + idct8_1(w+3,_x+24); + /*Transform rows of w into columns of y.*/ + for(in=w,out=_y,end=out+8;out>4); +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform. + _y: The buffer to store the result in. + This may be the same as _x. + _x: The input coefficients.*/ +static void oc_idct8x8_slow(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + const ogg_int16_t *in; + ogg_int16_t *end; + ogg_int16_t *out; + ogg_int16_t w[64]; + /*Transform rows of x into columns of w.*/ + for(in=_x,out=w,end=out+8;out>4); +} + +void oc_idct8x8(const oc_theora_state *_state,ogg_int16_t _y[64], + int _last_zzi){ + (*_state->opt_vtable.idct8x8)(_y,_last_zzi); +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform.*/ +void oc_idct8x8_c(ogg_int16_t _y[64],int _last_zzi){ + /*_last_zzi is subtly different from an actual count of the number of + coefficients we decoded for this block. + It contains the value of zzi BEFORE the final token in the block was + decoded. + In most cases this is an EOB token (the continuation of an EOB run from a + previous block counts), and so this is the same as the coefficient count. + However, in the case that the last token was NOT an EOB token, but filled + the block up with exactly 64 coefficients, _last_zzi will be less than 64. + Provided the last token was not a pure zero run, the minimum value it can + be is 46, and so that doesn't affect any of the cases in this routine. + However, if the last token WAS a pure zero run of length 63, then _last_zzi + will be 1 while the number of coefficients decoded is 64. + Thus, we will trigger the following special case, where the real + coefficient count would not. + Note also that a zero run of length 64 will give _last_zzi a value of 0, + but we still process the DC coefficient, which might have a non-zero value + due to DC prediction. + Although convoluted, this is arguably the correct behavior: it allows us to + use a smaller transform when the block ends with a long zero run instead + of a normal EOB token. + It could be smarter... multiple separate zero runs at the end of a block + will fool it, but an encoder that generates these really deserves what it + gets. + Needless to say we inherited this approach from VP3.*/ + /*Then perform the iDCT.*/ + if(_last_zzi<3)oc_idct8x8_3(_y,_y); + else if(_last_zzi<10)oc_idct8x8_10(_y,_y); + else oc_idct8x8_slow(_y,_y); +} diff --git a/libs/libtheora-1.1/lib/info.c b/libs/libtheora-1.1/lib/info.c new file mode 100644 index 00000000..c31e15c2 --- /dev/null +++ b/libs/libtheora-1.1/lib/info.c @@ -0,0 +1,131 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: info.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include +#include "internal.h" + + + +/*This is more or less the same as strncasecmp, but that doesn't exist + everywhere, and this is a fairly trivial function, so we include it. + Note: We take advantage of the fact that we know _n is less than or equal to + the length of at least one of the strings.*/ +static int oc_tagcompare(const char *_s1,const char *_s2,int _n){ + int c; + for(c=0;c<_n;c++){ + if(toupper(_s1[c])!=toupper(_s2[c]))return !0; + } + return _s1[c]!='='; +} + + + +void th_info_init(th_info *_info){ + memset(_info,0,sizeof(*_info)); + _info->version_major=TH_VERSION_MAJOR; + _info->version_minor=TH_VERSION_MINOR; + _info->version_subminor=TH_VERSION_SUB; + _info->keyframe_granule_shift=6; +} + +void th_info_clear(th_info *_info){ + memset(_info,0,sizeof(*_info)); +} + + + +void th_comment_init(th_comment *_tc){ + memset(_tc,0,sizeof(*_tc)); +} + +void th_comment_add(th_comment *_tc,char *_comment){ + char **user_comments; + int *comment_lengths; + int comment_len; + user_comments=_ogg_realloc(_tc->user_comments, + (_tc->comments+2)*sizeof(*_tc->user_comments)); + if(user_comments==NULL)return; + _tc->user_comments=user_comments; + comment_lengths=_ogg_realloc(_tc->comment_lengths, + (_tc->comments+2)*sizeof(*_tc->comment_lengths)); + if(comment_lengths==NULL)return; + _tc->comment_lengths=comment_lengths; + comment_len=strlen(_comment); + comment_lengths[_tc->comments]=comment_len; + user_comments[_tc->comments]=_ogg_malloc(comment_len+1); + if(user_comments[_tc->comments]==NULL)return; + memcpy(_tc->user_comments[_tc->comments],_comment,comment_len+1); + _tc->comments++; + _tc->user_comments[_tc->comments]=NULL; +} + +void th_comment_add_tag(th_comment *_tc,char *_tag,char *_val){ + char *comment; + int tag_len; + int val_len; + tag_len=strlen(_tag); + val_len=strlen(_val); + /*+2 for '=' and '\0'.*/ + comment=_ogg_malloc(tag_len+val_len+2); + if(comment==NULL)return; + memcpy(comment,_tag,tag_len); + comment[tag_len]='='; + memcpy(comment+tag_len+1,_val,val_len+1); + th_comment_add(_tc,comment); + _ogg_free(comment); +} + +char *th_comment_query(th_comment *_tc,char *_tag,int _count){ + long i; + int found; + int tag_len; + tag_len=strlen(_tag); + found=0; + for(i=0;i<_tc->comments;i++){ + if(!oc_tagcompare(_tc->user_comments[i],_tag,tag_len)){ + /*We return a pointer to the data, not a copy.*/ + if(_count==found++)return _tc->user_comments[i]+tag_len+1; + } + } + /*Didn't find anything.*/ + return NULL; +} + +int th_comment_query_count(th_comment *_tc,char *_tag){ + long i; + int tag_len; + int count; + tag_len=strlen(_tag); + count=0; + for(i=0;i<_tc->comments;i++){ + if(!oc_tagcompare(_tc->user_comments[i],_tag,tag_len))count++; + } + return count; +} + +void th_comment_clear(th_comment *_tc){ + if(_tc!=NULL){ + long i; + for(i=0;i<_tc->comments;i++)_ogg_free(_tc->user_comments[i]); + _ogg_free(_tc->user_comments); + _ogg_free(_tc->comment_lengths); + _ogg_free(_tc->vendor); + memset(_tc,0,sizeof(*_tc)); + } +} diff --git a/libs/libtheora-1.1/lib/internal.c b/libs/libtheora-1.1/lib/internal.c new file mode 100644 index 00000000..21fc2488 --- /dev/null +++ b/libs/libtheora-1.1/lib/internal.c @@ -0,0 +1,262 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: internal.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include +#include "internal.h" + + + +/*A map from the index in the zig zag scan to the coefficient number in a + block. + All zig zag indices beyond 63 are sent to coefficient 64, so that zero runs + past the end of a block in bogus streams get mapped to a known location.*/ +const unsigned char OC_FZIG_ZAG[128]={ + 0, 1, 8,16, 9, 2, 3,10, + 17,24,32,25,18,11, 4, 5, + 12,19,26,33,40,48,41,34, + 27,20,13, 6, 7,14,21,28, + 35,42,49,56,57,50,43,36, + 29,22,15,23,30,37,44,51, + 58,59,52,45,38,31,39,46, + 53,60,61,54,47,55,62,63, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64 +}; + +/*A map from the coefficient number in a block to its index in the zig zag + scan.*/ +const unsigned char OC_IZIG_ZAG[64]={ + 0, 1, 5, 6,14,15,27,28, + 2, 4, 7,13,16,26,29,42, + 3, 8,12,17,25,30,41,43, + 9,11,18,24,31,40,44,53, + 10,19,23,32,39,45,52,54, + 20,22,33,38,46,51,55,60, + 21,34,37,47,50,56,59,61, + 35,36,48,49,57,58,62,63 +}; + +/*A map from physical macro block ordering to bitstream macro block + ordering within a super block.*/ +const unsigned char OC_MB_MAP[2][2]={{0,3},{1,2}}; + +/*A list of the indices in the oc_mb.map array that can be valid for each of + the various chroma decimation types.*/ +const unsigned char OC_MB_MAP_IDXS[TH_PF_NFORMATS][12]={ + {0,1,2,3,4,8}, + {0,1,2,3,4,5,8,9}, + {0,1,2,3,4,6,8,10}, + {0,1,2,3,4,5,6,7,8,9,10,11} +}; + +/*The number of indices in the oc_mb.map array that can be valid for each of + the various chroma decimation types.*/ +const unsigned char OC_MB_MAP_NIDXS[TH_PF_NFORMATS]={6,8,8,12}; + +/*The number of extra bits that are coded with each of the DCT tokens. + Each DCT token has some fixed number of additional bits (possibly 0) stored + after the token itself, containing, for example, coefficient magnitude, + sign bits, etc.*/ +const unsigned char OC_DCT_TOKEN_EXTRA_BITS[TH_NDCT_TOKENS]={ + 0,0,0,2,3,4,12,3,6, + 0,0,0,0, + 1,1,1,1,2,3,4,5,6,10, + 1,1,1,1,1,3,4, + 2,3 +}; + + + +int oc_ilog(unsigned _v){ + int ret; + for(ret=0;_v;ret++)_v>>=1; + return ret; +} + + + +/*The function used to fill in the chroma plane motion vectors for a macro + block when 4 different motion vectors are specified in the luma plane. + This version is for use with chroma decimated in the X and Y directions + (4:2:0). + _cbmvs: The chroma block-level motion vectors to fill in. + _lbmvs: The luma block-level motion vectors.*/ +static void oc_set_chroma_mvs00(oc_mv _cbmvs[4],const oc_mv _lbmvs[4]){ + int dx; + int dy; + dx=_lbmvs[0][0]+_lbmvs[1][0]+_lbmvs[2][0]+_lbmvs[3][0]; + dy=_lbmvs[0][1]+_lbmvs[1][1]+_lbmvs[2][1]+_lbmvs[3][1]; + _cbmvs[0][0]=(signed char)OC_DIV_ROUND_POW2(dx,2,2); + _cbmvs[0][1]=(signed char)OC_DIV_ROUND_POW2(dy,2,2); +} + +/*The function used to fill in the chroma plane motion vectors for a macro + block when 4 different motion vectors are specified in the luma plane. + This version is for use with chroma decimated in the Y direction. + _cbmvs: The chroma block-level motion vectors to fill in. + _lbmvs: The luma block-level motion vectors.*/ +static void oc_set_chroma_mvs01(oc_mv _cbmvs[4],const oc_mv _lbmvs[4]){ + int dx; + int dy; + dx=_lbmvs[0][0]+_lbmvs[2][0]; + dy=_lbmvs[0][1]+_lbmvs[2][1]; + _cbmvs[0][0]=(signed char)OC_DIV_ROUND_POW2(dx,1,1); + _cbmvs[0][1]=(signed char)OC_DIV_ROUND_POW2(dy,1,1); + dx=_lbmvs[1][0]+_lbmvs[3][0]; + dy=_lbmvs[1][1]+_lbmvs[3][1]; + _cbmvs[1][0]=(signed char)OC_DIV_ROUND_POW2(dx,1,1); + _cbmvs[1][1]=(signed char)OC_DIV_ROUND_POW2(dy,1,1); +} + +/*The function used to fill in the chroma plane motion vectors for a macro + block when 4 different motion vectors are specified in the luma plane. + This version is for use with chroma decimated in the X direction (4:2:2). + _cbmvs: The chroma block-level motion vectors to fill in. + _lbmvs: The luma block-level motion vectors.*/ +static void oc_set_chroma_mvs10(oc_mv _cbmvs[4],const oc_mv _lbmvs[4]){ + int dx; + int dy; + dx=_lbmvs[0][0]+_lbmvs[1][0]; + dy=_lbmvs[0][1]+_lbmvs[1][1]; + _cbmvs[0][0]=(signed char)OC_DIV_ROUND_POW2(dx,1,1); + _cbmvs[0][1]=(signed char)OC_DIV_ROUND_POW2(dy,1,1); + dx=_lbmvs[2][0]+_lbmvs[3][0]; + dy=_lbmvs[2][1]+_lbmvs[3][1]; + _cbmvs[2][0]=(signed char)OC_DIV_ROUND_POW2(dx,1,1); + _cbmvs[2][1]=(signed char)OC_DIV_ROUND_POW2(dy,1,1); +} + +/*The function used to fill in the chroma plane motion vectors for a macro + block when 4 different motion vectors are specified in the luma plane. + This version is for use with no chroma decimation (4:4:4). + _cbmvs: The chroma block-level motion vectors to fill in. + _lmbmv: The luma macro-block level motion vector to fill in for use in + prediction. + _lbmvs: The luma block-level motion vectors.*/ +static void oc_set_chroma_mvs11(oc_mv _cbmvs[4],const oc_mv _lbmvs[4]){ + memcpy(_cbmvs,_lbmvs,4*sizeof(_lbmvs[0])); +} + +/*A table of functions used to fill in the chroma plane motion vectors for a + macro block when 4 different motion vectors are specified in the luma + plane.*/ +const oc_set_chroma_mvs_func OC_SET_CHROMA_MVS_TABLE[TH_PF_NFORMATS]={ + (oc_set_chroma_mvs_func)oc_set_chroma_mvs00, + (oc_set_chroma_mvs_func)oc_set_chroma_mvs01, + (oc_set_chroma_mvs_func)oc_set_chroma_mvs10, + (oc_set_chroma_mvs_func)oc_set_chroma_mvs11 +}; + + + +void **oc_malloc_2d(size_t _height,size_t _width,size_t _sz){ + size_t rowsz; + size_t colsz; + size_t datsz; + char *ret; + colsz=_height*sizeof(void *); + rowsz=_sz*_width; + datsz=rowsz*_height; + /*Alloc array and row pointers.*/ + ret=(char *)_ogg_malloc(datsz+colsz); + if(ret==NULL)return NULL; + /*Initialize the array.*/ + if(ret!=NULL){ + size_t i; + void **p; + char *datptr; + p=(void **)ret; + i=_height; + for(datptr=ret+colsz;i-->0;p++,datptr+=rowsz)*p=(void *)datptr; + } + return (void **)ret; +} + +void **oc_calloc_2d(size_t _height,size_t _width,size_t _sz){ + size_t colsz; + size_t rowsz; + size_t datsz; + char *ret; + colsz=_height*sizeof(void *); + rowsz=_sz*_width; + datsz=rowsz*_height; + /*Alloc array and row pointers.*/ + ret=(char *)_ogg_calloc(datsz+colsz,1); + if(ret==NULL)return NULL; + /*Initialize the array.*/ + if(ret!=NULL){ + size_t i; + void **p; + char *datptr; + p=(void **)ret; + i=_height; + for(datptr=ret+colsz;i-->0;p++,datptr+=rowsz)*p=(void *)datptr; + } + return (void **)ret; +} + +void oc_free_2d(void *_ptr){ + _ogg_free(_ptr); +} + +/*Fills in a Y'CbCr buffer with a pointer to the image data in the first + buffer, but with the opposite vertical orientation. + _dst: The destination buffer. + This can be the same as _src. + _src: The source buffer.*/ +void oc_ycbcr_buffer_flip(th_ycbcr_buffer _dst, + const th_ycbcr_buffer _src){ + int pli; + for(pli=0;pli<3;pli++){ + _dst[pli].width=_src[pli].width; + _dst[pli].height=_src[pli].height; + _dst[pli].stride=-_src[pli].stride; + _dst[pli].data=_src[pli].data + +(1-_dst[pli].height)*(ptrdiff_t)_dst[pli].stride; + } +} + +const char *th_version_string(void){ + return OC_VENDOR_STRING; +} + +ogg_uint32_t th_version_number(void){ + return (TH_VERSION_MAJOR<<16)+(TH_VERSION_MINOR<<8)+TH_VERSION_SUB; +} + +/*Determines the packet type. + Note that this correctly interprets a 0-byte packet as a video data packet. + Return: 1 for a header packet, 0 for a data packet.*/ +int th_packet_isheader(ogg_packet *_op){ + return _op->bytes>0?_op->packet[0]>>7:0; +} + +/*Determines the frame type of a video data packet. + Note that this correctly interprets a 0-byte packet as a delta frame. + Return: 1 for a key frame, 0 for a delta frame, and -1 for a header + packet.*/ +int th_packet_iskeyframe(ogg_packet *_op){ + return _op->bytes<=0?0:_op->packet[0]&0x80?-1:!(_op->packet[0]&0x40); +} diff --git a/libs/libtheora-1.1/lib/internal.h b/libs/libtheora-1.1/lib/internal.h new file mode 100644 index 00000000..7440c01f --- /dev/null +++ b/libs/libtheora-1.1/lib/internal.h @@ -0,0 +1,509 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: internal.h 16753 2009-12-19 00:52:46Z tterribe $ + + ********************************************************************/ +#if !defined(_internal_H) +# define _internal_H (1) +# include +# include +# if defined(HAVE_CONFIG_H) +# include "config.h" +# endif +# include "theora/codec.h" +# include "theora/theora.h" + +# if defined(_MSC_VER) +/*Disable missing EMMS warnings.*/ +# pragma warning(disable:4799) +/*Thank you Microsoft, I know the order of operations.*/ +# pragma warning(disable:4554) +# endif +/*You, too, gcc.*/ +# if defined(__GNUC_PREREQ) +# if __GNUC_PREREQ(4,2) +# pragma GCC diagnostic ignored "-Wparentheses" +# endif +# endif + +# include "ocintrin.h" +# include "huffman.h" +# include "quant.h" + +/*Some assembly constructs require aligned operands.*/ +# if defined(OC_X86_ASM) +# if defined(__GNUC__) +# define OC_ALIGN8(expr) expr __attribute__((aligned(8))) +# define OC_ALIGN16(expr) expr __attribute__((aligned(16))) +# elif defined(_MSC_VER) +# define OC_ALIGN8(expr) __declspec (align(8)) expr +# define OC_ALIGN16(expr) __declspec (align(16)) expr +# endif +# endif +# if !defined(OC_ALIGN8) +# define OC_ALIGN8(expr) expr +# endif +# if !defined(OC_ALIGN16) +# define OC_ALIGN16(expr) expr +# endif + + + +typedef struct oc_sb_flags oc_sb_flags; +typedef struct oc_border_info oc_border_info; +typedef struct oc_fragment oc_fragment; +typedef struct oc_fragment_plane oc_fragment_plane; +typedef struct oc_base_opt_vtable oc_base_opt_vtable; +typedef struct oc_base_opt_data oc_base_opt_data; +typedef struct oc_state_dispatch_vtable oc_state_dispatch_vtable; +typedef struct oc_theora_state oc_theora_state; + + + +/*This library's version.*/ +# define OC_VENDOR_STRING "Xiph.Org libtheora 1.1 20090822 (Thusnelda)" + +/*Theora bitstream version.*/ +# define TH_VERSION_MAJOR (3) +# define TH_VERSION_MINOR (2) +# define TH_VERSION_SUB (1) +# define TH_VERSION_CHECK(_info,_maj,_min,_sub) \ + ((_info)->version_major>(_maj)||(_info)->version_major==(_maj)&& \ + ((_info)->version_minor>(_min)||(_info)->version_minor==(_min)&& \ + (_info)->version_subminor>=(_sub))) + +/*A keyframe.*/ +#define OC_INTRA_FRAME (0) +/*A predicted frame.*/ +#define OC_INTER_FRAME (1) +/*A frame of unknown type (frame type decision has not yet been made).*/ +#define OC_UNKWN_FRAME (-1) + +/*The amount of padding to add to the reconstructed frame buffers on all + sides. + This is used to allow unrestricted motion vectors without special casing. + This must be a multiple of 2.*/ +#define OC_UMV_PADDING (16) + +/*Frame classification indices.*/ +/*The previous golden frame.*/ +#define OC_FRAME_GOLD (0) +/*The previous frame.*/ +#define OC_FRAME_PREV (1) +/*The current frame.*/ +#define OC_FRAME_SELF (2) + +/*The input or output buffer.*/ +#define OC_FRAME_IO (3) + +/*Macroblock modes.*/ +/*Macro block is invalid: It is never coded.*/ +#define OC_MODE_INVALID (-1) +/*Encoded difference from the same macro block in the previous frame.*/ +#define OC_MODE_INTER_NOMV (0) +/*Encoded with no motion compensated prediction.*/ +#define OC_MODE_INTRA (1) +/*Encoded difference from the previous frame offset by the given motion + vector.*/ +#define OC_MODE_INTER_MV (2) +/*Encoded difference from the previous frame offset by the last coded motion + vector.*/ +#define OC_MODE_INTER_MV_LAST (3) +/*Encoded difference from the previous frame offset by the second to last + coded motion vector.*/ +#define OC_MODE_INTER_MV_LAST2 (4) +/*Encoded difference from the same macro block in the previous golden + frame.*/ +#define OC_MODE_GOLDEN_NOMV (5) +/*Encoded difference from the previous golden frame offset by the given motion + vector.*/ +#define OC_MODE_GOLDEN_MV (6) +/*Encoded difference from the previous frame offset by the individual motion + vectors given for each block.*/ +#define OC_MODE_INTER_MV_FOUR (7) +/*The number of (coded) modes.*/ +#define OC_NMODES (8) + +/*Determines the reference frame used for a given MB mode.*/ +#define OC_FRAME_FOR_MODE(_x) \ + OC_UNIBBLE_TABLE32(OC_FRAME_PREV,OC_FRAME_SELF,OC_FRAME_PREV,OC_FRAME_PREV, \ + OC_FRAME_PREV,OC_FRAME_GOLD,OC_FRAME_GOLD,OC_FRAME_PREV,(_x)) + +/*Constants for the packet state machine common between encoder and decoder.*/ + +/*Next packet to emit/read: Codec info header.*/ +#define OC_PACKET_INFO_HDR (-3) +/*Next packet to emit/read: Comment header.*/ +#define OC_PACKET_COMMENT_HDR (-2) +/*Next packet to emit/read: Codec setup header.*/ +#define OC_PACKET_SETUP_HDR (-1) +/*No more packets to emit/read.*/ +#define OC_PACKET_DONE (INT_MAX) + + + +/*Super blocks are 32x32 segments of pixels in a single color plane indexed + in image order. + Internally, super blocks are broken up into four quadrants, each of which + contains a 2x2 pattern of blocks, each of which is an 8x8 block of pixels. + Quadrants, and the blocks within them, are indexed in a special order called + a "Hilbert curve" within the super block. + + In order to differentiate between the Hilbert-curve indexing strategy and + the regular image order indexing strategy, blocks indexed in image order + are called "fragments". + Fragments are indexed in image order, left to right, then bottom to top, + from Y' plane to Cb plane to Cr plane. + + The co-located fragments in all image planes corresponding to the location + of a single quadrant of a luma plane super block form a macro block. + Thus there is only a single set of macro blocks for all planes, each of which + contains between 6 and 12 fragments, depending on the pixel format. + Therefore macro block information is kept in a separate set of arrays from + super blocks to avoid unused space in the other planes. + The lists are indexed in super block order. + That is, the macro block corresponding to the macro block mbi in (luma plane) + super block sbi is at index (sbi<<2|mbi). + Thus the number of macro blocks in each dimension is always twice the number + of super blocks, even when only an odd number fall inside the coded frame. + These "extra" macro blocks are just an artifact of our internal data layout, + and not part of the coded stream; they are flagged with a negative MB mode.*/ + + + +/*A single quadrant of the map from a super block to fragment numbers.*/ +typedef ptrdiff_t oc_sb_map_quad[4]; +/*A map from a super block to fragment numbers.*/ +typedef oc_sb_map_quad oc_sb_map[4]; +/*A single plane of the map from a macro block to fragment numbers.*/ +typedef ptrdiff_t oc_mb_map_plane[4]; +/*A map from a macro block to fragment numbers.*/ +typedef oc_mb_map_plane oc_mb_map[3]; +/*A motion vector.*/ +typedef signed char oc_mv[2]; + + + +/*Super block information.*/ +struct oc_sb_flags{ + unsigned char coded_fully:1; + unsigned char coded_partially:1; + unsigned char quad_valid:4; +}; + + + +/*Information about a fragment which intersects the border of the displayable + region. + This marks which pixels belong to the displayable region.*/ +struct oc_border_info{ + /*A bit mask marking which pixels are in the displayable region. + Pixel (x,y) corresponds to bit (y<<3|x).*/ + ogg_int64_t mask; + /*The number of pixels in the displayable region. + This is always positive, and always less than 64.*/ + int npixels; +}; + + + +/*Fragment information.*/ +struct oc_fragment{ + /*A flag indicating whether or not this fragment is coded.*/ + unsigned coded:1; + /*A flag indicating that this entire fragment lies outside the displayable + region of the frame. + Note the contrast with an invalid macro block, which is outside the coded + frame, not just the displayable one. + There are no fragments outside the coded frame by construction.*/ + unsigned invalid:1; + /*The index of the quality index used for this fragment's AC coefficients.*/ + unsigned qii:6; + /*The mode of the macroblock this fragment belongs to.*/ + unsigned mb_mode:3; + /*The index of the associated border information for fragments which lie + partially outside the displayable region. + For fragments completely inside or outside this region, this is -1. + Note that the C standard requires an explicit signed keyword for bitfield + types, since some compilers may treat them as unsigned without it.*/ + signed int borderi:5; + /*The prediction-corrected DC component. + Note that the C standard requires an explicit signed keyword for bitfield + types, since some compilers may treat them as unsigned without it.*/ + signed int dc:16; +}; + + + +/*A description of each fragment plane.*/ +struct oc_fragment_plane{ + /*The number of fragments in the horizontal direction.*/ + int nhfrags; + /*The number of fragments in the vertical direction.*/ + int nvfrags; + /*The offset of the first fragment in the plane.*/ + ptrdiff_t froffset; + /*The total number of fragments in the plane.*/ + ptrdiff_t nfrags; + /*The number of super blocks in the horizontal direction.*/ + unsigned nhsbs; + /*The number of super blocks in the vertical direction.*/ + unsigned nvsbs; + /*The offset of the first super block in the plane.*/ + unsigned sboffset; + /*The total number of super blocks in the plane.*/ + unsigned nsbs; +}; + + + +/*The shared (encoder and decoder) functions that have accelerated variants.*/ +struct oc_base_opt_vtable{ + void (*frag_copy)(unsigned char *_dst, + const unsigned char *_src,int _ystride); + void (*frag_recon_intra)(unsigned char *_dst,int _ystride, + const ogg_int16_t _residue[64]); + void (*frag_recon_inter)(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]); + void (*frag_recon_inter2)(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t _residue[64]); + void (*idct8x8)(ogg_int16_t _y[64],int _last_zzi); + void (*state_frag_recon)(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant); + void (*state_frag_copy_list)(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli); + void (*state_loop_filter_frag_rows)(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end); + void (*restore_fpu)(void); +}; + +/*The shared (encoder and decoder) tables that vary according to which variants + of the above functions are used.*/ +struct oc_base_opt_data{ + const unsigned char *dct_fzig_zag; +}; + + +/*State information common to both the encoder and decoder.*/ +struct oc_theora_state{ + /*The stream information.*/ + th_info info; + /*Table for shared accelerated functions.*/ + oc_base_opt_vtable opt_vtable; + /*Table for shared data used by accelerated functions.*/ + oc_base_opt_data opt_data; + /*CPU flags to detect the presence of extended instruction sets.*/ + ogg_uint32_t cpu_flags; + /*The fragment plane descriptions.*/ + oc_fragment_plane fplanes[3]; + /*The list of fragments, indexed in image order.*/ + oc_fragment *frags; + /*The the offset into the reference frame buffer to the upper-left pixel of + each fragment.*/ + ptrdiff_t *frag_buf_offs; + /*The motion vector for each fragment.*/ + oc_mv *frag_mvs; + /*The total number of fragments in a single frame.*/ + ptrdiff_t nfrags; + /*The list of super block maps, indexed in image order.*/ + oc_sb_map *sb_maps; + /*The list of super block flags, indexed in image order.*/ + oc_sb_flags *sb_flags; + /*The total number of super blocks in a single frame.*/ + unsigned nsbs; + /*The fragments from each color plane that belong to each macro block. + Fragments are stored in image order (left to right then top to bottom). + When chroma components are decimated, the extra fragments have an index of + -1.*/ + oc_mb_map *mb_maps; + /*The list of macro block modes. + A negative number indicates the macro block lies entirely outside the + coded frame.*/ + signed char *mb_modes; + /*The number of macro blocks in the X direction.*/ + unsigned nhmbs; + /*The number of macro blocks in the Y direction.*/ + unsigned nvmbs; + /*The total number of macro blocks.*/ + size_t nmbs; + /*The list of coded fragments, in coded order. + Uncoded fragments are stored in reverse order from the end of the list.*/ + ptrdiff_t *coded_fragis; + /*The number of coded fragments in each plane.*/ + ptrdiff_t ncoded_fragis[3]; + /*The total number of coded fragments.*/ + ptrdiff_t ntotal_coded_fragis; + /*The index of the buffers being used for each OC_FRAME_* reference frame.*/ + int ref_frame_idx[4]; + /*The actual buffers used for the previously decoded frames.*/ + th_ycbcr_buffer ref_frame_bufs[4]; + /*The storage for the reference frame buffers.*/ + unsigned char *ref_frame_data[4]; + /*The strides for each plane in the reference frames.*/ + int ref_ystride[3]; + /*The number of unique border patterns.*/ + int nborders; + /*The unique border patterns for all border fragments. + The borderi field of fragments which straddle the border indexes this + list.*/ + oc_border_info borders[16]; + /*The frame number of the last keyframe.*/ + ogg_int64_t keyframe_num; + /*The frame number of the current frame.*/ + ogg_int64_t curframe_num; + /*The granpos of the current frame.*/ + ogg_int64_t granpos; + /*The type of the current frame.*/ + unsigned char frame_type; + /*The bias to add to the frame count when computing granule positions.*/ + unsigned char granpos_bias; + /*The number of quality indices used in the current frame.*/ + unsigned char nqis; + /*The quality indices of the current frame.*/ + unsigned char qis[3]; + /*The dequantization tables, stored in zig-zag order, and indexed by + qi, pli, qti, and zzi.*/ + ogg_uint16_t *dequant_tables[64][3][2]; + OC_ALIGN16(oc_quant_table dequant_table_data[64][3][2]); + /*Loop filter strength parameters.*/ + unsigned char loop_filter_limits[64]; +}; + + + +/*The function type used to fill in the chroma plane motion vectors for a + macro block when 4 different motion vectors are specified in the luma + plane. + _cbmvs: The chroma block-level motion vectors to fill in. + _lmbmv: The luma macro-block level motion vector to fill in for use in + prediction. + _lbmvs: The luma block-level motion vectors.*/ +typedef void (*oc_set_chroma_mvs_func)(oc_mv _cbmvs[4],const oc_mv _lbmvs[4]); + + + +/*A map from the index in the zig zag scan to the coefficient number in a + block.*/ +extern const unsigned char OC_FZIG_ZAG[128]; +/*A map from the coefficient number in a block to its index in the zig zag + scan.*/ +extern const unsigned char OC_IZIG_ZAG[64]; +/*A map from physical macro block ordering to bitstream macro block + ordering within a super block.*/ +extern const unsigned char OC_MB_MAP[2][2]; +/*A list of the indices in the oc_mb_map array that can be valid for each of + the various chroma decimation types.*/ +extern const unsigned char OC_MB_MAP_IDXS[TH_PF_NFORMATS][12]; +/*The number of indices in the oc_mb_map array that can be valid for each of + the various chroma decimation types.*/ +extern const unsigned char OC_MB_MAP_NIDXS[TH_PF_NFORMATS]; +/*A table of functions used to fill in the Cb,Cr plane motion vectors for a + macro block when 4 different motion vectors are specified in the luma + plane.*/ +extern const oc_set_chroma_mvs_func OC_SET_CHROMA_MVS_TABLE[TH_PF_NFORMATS]; + + + +int oc_ilog(unsigned _v); +void **oc_malloc_2d(size_t _height,size_t _width,size_t _sz); +void **oc_calloc_2d(size_t _height,size_t _width,size_t _sz); +void oc_free_2d(void *_ptr); + +void oc_ycbcr_buffer_flip(th_ycbcr_buffer _dst, + const th_ycbcr_buffer _src); + +int oc_state_init(oc_theora_state *_state,const th_info *_info,int _nrefs); +void oc_state_clear(oc_theora_state *_state); +void oc_state_vtable_init_c(oc_theora_state *_state); +void oc_state_borders_fill_rows(oc_theora_state *_state,int _refi,int _pli, + int _y0,int _yend); +void oc_state_borders_fill_caps(oc_theora_state *_state,int _refi,int _pli); +void oc_state_borders_fill(oc_theora_state *_state,int _refi); +void oc_state_fill_buffer_ptrs(oc_theora_state *_state,int _buf_idx, + th_ycbcr_buffer _img); +int oc_state_mbi_for_pos(oc_theora_state *_state,int _mbx,int _mby); +int oc_state_get_mv_offsets(const oc_theora_state *_state,int _offsets[2], + int _pli,int _dx,int _dy); + +int oc_state_loop_filter_init(oc_theora_state *_state,int *_bv); +void oc_state_loop_filter(oc_theora_state *_state,int _frame); +#if defined(OC_DUMP_IMAGES) +int oc_state_dump_frame(const oc_theora_state *_state,int _frame, + const char *_suf); +#endif + +/*Shared accelerated functions.*/ +void oc_frag_copy(const oc_theora_state *_state,unsigned char *_dst, + const unsigned char *_src,int _ystride); +void oc_frag_recon_intra(const oc_theora_state *_state, + unsigned char *_dst,int _dst_ystride,const ogg_int16_t _residue[64]); +void oc_frag_recon_inter(const oc_theora_state *_state,unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]); +void oc_frag_recon_inter2(const oc_theora_state *_state, + unsigned char *_dst,const unsigned char *_src1,const unsigned char *_src2, + int _ystride,const ogg_int16_t _residue[64]); +void oc_idct8x8(const oc_theora_state *_state,ogg_int16_t _y[64],int _last_zzi); +void oc_state_frag_recon(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant); +void oc_state_frag_copy_list(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli); +void oc_state_loop_filter_frag_rows(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end); +void oc_restore_fpu(const oc_theora_state *_state); + +/*Default pure-C implementations.*/ +void oc_frag_copy_c(unsigned char *_dst, + const unsigned char *_src,int _src_ystride); +void oc_frag_recon_intra_c(unsigned char *_dst,int _dst_ystride, + const ogg_int16_t _residue[64]); +void oc_frag_recon_inter_c(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t _residue[64]); +void oc_frag_recon_inter2_c(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t _residue[64]); +void oc_idct8x8_c(ogg_int16_t _y[64],int _last_zzi); +void oc_state_frag_recon_c(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant); +void oc_state_frag_copy_list_c(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli); +void oc_state_loop_filter_frag_rows_c(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end); +void oc_restore_fpu_c(void); + +/*We need a way to call a few encoder functions without introducing a link-time + dependency into the decoder, while still allowing the old alpha API which + does not distinguish between encoder and decoder objects to be used. + We do this by placing a function table at the start of the encoder object + which can dispatch into the encoder library. + We do a similar thing for the decoder in case we ever decide to split off a + common base library.*/ +typedef void (*oc_state_clear_func)(theora_state *_th); +typedef int (*oc_state_control_func)(theora_state *th,int _req, + void *_buf,size_t _buf_sz); +typedef ogg_int64_t (*oc_state_granule_frame_func)(theora_state *_th, + ogg_int64_t _granulepos); +typedef double (*oc_state_granule_time_func)(theora_state *_th, + ogg_int64_t _granulepos); + + +struct oc_state_dispatch_vtable{ + oc_state_clear_func clear; + oc_state_control_func control; + oc_state_granule_frame_func granule_frame; + oc_state_granule_time_func granule_time; +}; + +#endif diff --git a/libs/libtheora-1.1/lib/mathops.c b/libs/libtheora-1.1/lib/mathops.c new file mode 100644 index 00000000..d3fb9091 --- /dev/null +++ b/libs/libtheora-1.1/lib/mathops.c @@ -0,0 +1,296 @@ +#include "mathops.h" +#include + +/*The fastest fallback strategy for platforms with fast multiplication appears + to be based on de Bruijn sequences~\cite{LP98}. + Tests confirmed this to be true even on an ARM11, where it is actually faster + than using the native clz instruction. + Define OC_ILOG_NODEBRUIJN to use a simpler fallback on platforms where + multiplication or table lookups are too expensive. + + @UNPUBLISHED{LP98, + author="Charles E. Leiserson and Harald Prokop", + title="Using de {Bruijn} Sequences to Index a 1 in a Computer Word", + month=Jun, + year=1998, + note="\url{http://supertech.csail.mit.edu/papers/debruijn.pdf}" + }*/ +#if !defined(OC_ILOG_NODEBRUIJN)&& \ + !defined(OC_CLZ32)||!defined(OC_CLZ64)&&LONG_MAX<9223372036854775807LL +static const unsigned char OC_DEBRUIJN_IDX32[32]={ + 0, 1,28, 2,29,14,24, 3,30,22,20,15,25,17, 4, 8, + 31,27,13,23,21,19,16, 7,26,12,18, 6,11, 5,10, 9 +}; +#endif + +int oc_ilog32(ogg_uint32_t _v){ +#if defined(OC_CLZ32) + return (OC_CLZ32_OFFS-OC_CLZ32(_v))&-!!_v; +#else +/*On a Pentium M, this branchless version tested as the fastest version without + multiplications on 1,000,000,000 random 32-bit integers, edging out a + similar version with branches, and a 256-entry LUT version.*/ +# if defined(OC_ILOG_NODEBRUIJN) + int ret; + int m; + ret=_v>0; + m=(_v>0xFFFFU)<<4; + _v>>=m; + ret|=m; + m=(_v>0xFFU)<<3; + _v>>=m; + ret|=m; + m=(_v>0xFU)<<2; + _v>>=m; + ret|=m; + m=(_v>3)<<1; + _v>>=m; + ret|=m; + ret+=_v>1; + return ret; +/*This de Bruijn sequence version is faster if you have a fast multiplier.*/ +# else + int ret; + ret=_v>0; + _v|=_v>>1; + _v|=_v>>2; + _v|=_v>>4; + _v|=_v>>8; + _v|=_v>>16; + _v=(_v>>1)+1; + ret+=OC_DEBRUIJN_IDX32[_v*0x77CB531U>>27&0x1F]; + return ret; +# endif +#endif +} + +int oc_ilog64(ogg_int64_t _v){ +#if defined(OC_CLZ64) + return (OC_CLZ64_OFFS-OC_CLZ64(_v))&-!!_v; +#else +# if defined(OC_ILOG_NODEBRUIJN) + ogg_uint32_t v; + int ret; + int m; + ret=_v>0; + m=(_v>0xFFFFFFFFU)<<5; + v=(ogg_uint32_t)(_v>>m); + ret|=m; + m=(v>0xFFFFU)<<4; + v>>=m; + ret|=m; + m=(v>0xFFU)<<3; + v>>=m; + ret|=m; + m=(v>0xFU)<<2; + v>>=m; + ret|=m; + m=(v>3)<<1; + v>>=m; + ret|=m; + ret+=v>1; + return ret; +# else +/*If we don't have a 64-bit word, split it into two 32-bit halves.*/ +# if LONG_MAX<9223372036854775807LL + ogg_uint32_t v; + int ret; + int m; + ret=_v>0; + m=(_v>0xFFFFFFFFU)<<5; + v=(ogg_uint32_t)(_v>>m); + ret|=m; + v|=v>>1; + v|=v>>2; + v|=v>>4; + v|=v>>8; + v|=v>>16; + v=(v>>1)+1; + ret+=OC_DEBRUIJN_IDX32[v*0x77CB531U>>27&0x1F]; + return ret; +/*Otherwise do it in one 64-bit operation.*/ +# else + static const unsigned char OC_DEBRUIJN_IDX64[64]={ + 0, 1, 2, 7, 3,13, 8,19, 4,25,14,28, 9,34,20,40, + 5,17,26,38,15,46,29,48,10,31,35,54,21,50,41,57, + 63, 6,12,18,24,27,33,39,16,37,45,47,30,53,49,56, + 62,11,23,32,36,44,52,55,61,22,43,51,60,42,59,58 + }; + int ret; + ret=_v>0; + _v|=_v>>1; + _v|=_v>>2; + _v|=_v>>4; + _v|=_v>>8; + _v|=_v>>16; + _v|=_v>>32; + _v=(_v>>1)+1; + ret+=OC_DEBRUIJN_IDX64[_v*0x218A392CD3D5DBF>>58&0x3F]; + return ret; +# endif +# endif +#endif +} + +/*round(2**(62+i)*atanh(2**(-(i+1)))/log(2))*/ +static const ogg_int64_t OC_ATANH_LOG2[32]={ + 0x32B803473F7AD0F4LL,0x2F2A71BD4E25E916LL,0x2E68B244BB93BA06LL, + 0x2E39FB9198CE62E4LL,0x2E2E683F68565C8FLL,0x2E2B850BE2077FC1LL, + 0x2E2ACC58FE7B78DBLL,0x2E2A9E2DE52FD5F2LL,0x2E2A92A338D53EECLL, + 0x2E2A8FC08F5E19B6LL,0x2E2A8F07E51A485ELL,0x2E2A8ED9BA8AF388LL, + 0x2E2A8ECE2FE7384ALL,0x2E2A8ECB4D3E4B1ALL,0x2E2A8ECA94940FE8LL, + 0x2E2A8ECA6669811DLL,0x2E2A8ECA5ADEDD6ALL,0x2E2A8ECA57FC347ELL, + 0x2E2A8ECA57438A43LL,0x2E2A8ECA57155FB4LL,0x2E2A8ECA5709D510LL, + 0x2E2A8ECA5706F267LL,0x2E2A8ECA570639BDLL,0x2E2A8ECA57060B92LL, + 0x2E2A8ECA57060008LL,0x2E2A8ECA5705FD25LL,0x2E2A8ECA5705FC6CLL, + 0x2E2A8ECA5705FC3ELL,0x2E2A8ECA5705FC33LL,0x2E2A8ECA5705FC30LL, + 0x2E2A8ECA5705FC2FLL,0x2E2A8ECA5705FC2FLL +}; + +/*Computes the binary exponential of _z, a log base 2 in Q57 format.*/ +ogg_int64_t oc_bexp64(ogg_int64_t _z){ + ogg_int64_t w; + ogg_int64_t z; + int ipart; + ipart=(int)(_z>>57); + if(ipart<0)return 0; + if(ipart>=63)return 0x7FFFFFFFFFFFFFFFLL; + z=_z-OC_Q57(ipart); + if(z){ + ogg_int64_t mask; + long wlo; + int i; + /*C doesn't give us 64x64->128 muls, so we use CORDIC. + This is not particularly fast, but it's not being used in time-critical + code; it is very accurate.*/ + /*z is the fractional part of the log in Q62 format. + We need 1 bit of headroom since the magnitude can get larger than 1 + during the iteration, and a sign bit.*/ + z<<=5; + /*w is the exponential in Q61 format (since it also needs headroom and can + get as large as 2.0); we could get another bit if we dropped the sign, + but we'll recover that bit later anyway. + Ideally this should start out as + \lim_{n->\infty} 2^{61}/\product_{i=1}^n \sqrt{1-2^{-2i}} + but in order to guarantee convergence we have to repeat iterations 4, + 13 (=3*4+1), and 40 (=3*13+1, etc.), so it winds up somewhat larger.*/ + w=0x26A3D0E401DD846DLL; + for(i=0;;i++){ + mask=-(z<0); + w+=(w>>i+1)+mask^mask; + z-=OC_ATANH_LOG2[i]+mask^mask; + /*Repeat iteration 4.*/ + if(i>=3)break; + z<<=1; + } + for(;;i++){ + mask=-(z<0); + w+=(w>>i+1)+mask^mask; + z-=OC_ATANH_LOG2[i]+mask^mask; + /*Repeat iteration 13.*/ + if(i>=12)break; + z<<=1; + } + for(;i<32;i++){ + mask=-(z<0); + w+=(w>>i+1)+mask^mask; + z=z-(OC_ATANH_LOG2[i]+mask^mask)<<1; + } + wlo=0; + /*Skip the remaining iterations unless we really require that much + precision. + We could have bailed out earlier for smaller iparts, but that would + require initializing w from a table, as the limit doesn't converge to + 61-bit precision until n=30.*/ + if(ipart>30){ + /*For these iterations, we just update the low bits, as the high bits + can't possibly be affected. + OC_ATANH_LOG2 has also converged (it actually did so one iteration + earlier, but that's no reason for an extra special case).*/ + for(;;i++){ + mask=-(z<0); + wlo+=(w>>i)+mask^mask; + z-=OC_ATANH_LOG2[31]+mask^mask; + /*Repeat iteration 40.*/ + if(i>=39)break; + z<<=1; + } + for(;i<61;i++){ + mask=-(z<0); + wlo+=(w>>i)+mask^mask; + z=z-(OC_ATANH_LOG2[31]+mask^mask)<<1; + } + } + w=(w<<1)+wlo; + } + else w=(ogg_int64_t)1<<62; + if(ipart<62)w=(w>>61-ipart)+1>>1; + return w; +} + +/*Computes the binary logarithm of _w, returned in Q57 format.*/ +ogg_int64_t oc_blog64(ogg_int64_t _w){ + ogg_int64_t z; + int ipart; + if(_w<=0)return -1; + ipart=OC_ILOGNZ_64(_w)-1; + if(ipart>61)_w>>=ipart-61; + else _w<<=61-ipart; + z=0; + if(_w&_w-1){ + ogg_int64_t x; + ogg_int64_t y; + ogg_int64_t u; + ogg_int64_t mask; + int i; + /*C doesn't give us 64x64->128 muls, so we use CORDIC. + This is not particularly fast, but it's not being used in time-critical + code; it is very accurate.*/ + /*z is the fractional part of the log in Q61 format.*/ + /*x and y are the cosh() and sinh(), respectively, in Q61 format. + We are computing z=2*atanh(y/x)=2*atanh((_w-1)/(_w+1)).*/ + x=_w+((ogg_int64_t)1<<61); + y=_w-((ogg_int64_t)1<<61); + for(i=0;i<4;i++){ + mask=-(y<0); + z+=(OC_ATANH_LOG2[i]>>i)+mask^mask; + u=x>>i+1; + x-=(y>>i+1)+mask^mask; + y-=u+mask^mask; + } + /*Repeat iteration 4.*/ + for(i--;i<13;i++){ + mask=-(y<0); + z+=(OC_ATANH_LOG2[i]>>i)+mask^mask; + u=x>>i+1; + x-=(y>>i+1)+mask^mask; + y-=u+mask^mask; + } + /*Repeat iteration 13.*/ + for(i--;i<32;i++){ + mask=-(y<0); + z+=(OC_ATANH_LOG2[i]>>i)+mask^mask; + u=x>>i+1; + x-=(y>>i+1)+mask^mask; + y-=u+mask^mask; + } + /*OC_ATANH_LOG2 has converged.*/ + for(;i<40;i++){ + mask=-(y<0); + z+=(OC_ATANH_LOG2[31]>>i)+mask^mask; + u=x>>i+1; + x-=(y>>i+1)+mask^mask; + y-=u+mask^mask; + } + /*Repeat iteration 40.*/ + for(i--;i<62;i++){ + mask=-(y<0); + z+=(OC_ATANH_LOG2[31]>>i)+mask^mask; + u=x>>i+1; + x-=(y>>i+1)+mask^mask; + y-=u+mask^mask; + } + z=z+8>>4; + } + return OC_Q57(ipart)+z; +} diff --git a/libs/libtheora-1.1/lib/mathops.h b/libs/libtheora-1.1/lib/mathops.h new file mode 100644 index 00000000..efbc5377 --- /dev/null +++ b/libs/libtheora-1.1/lib/mathops.h @@ -0,0 +1,141 @@ +#if !defined(_mathops_H) +# define _mathops_H (1) +# include + +# ifdef __GNUC_PREREQ +# if __GNUC_PREREQ(3,4) +# include +/*Note the casts to (int) below: this prevents OC_CLZ{32|64}_OFFS from + "upgrading" the type of an entire expression to an (unsigned) size_t.*/ +# if INT_MAX>=2147483647 +# define OC_CLZ32_OFFS ((int)sizeof(unsigned)*CHAR_BIT) +# define OC_CLZ32(_x) (__builtin_clz(_x)) +# elif LONG_MAX>=2147483647L +# define OC_CLZ32_OFFS ((int)sizeof(unsigned long)*CHAR_BIT) +# define OC_CLZ32(_x) (__builtin_clzl(_x)) +# endif +# if INT_MAX>=9223372036854775807LL +# define OC_CLZ64_OFFS ((int)sizeof(unsigned)*CHAR_BIT) +# define OC_CLZ64(_x) (__builtin_clz(_x)) +# elif LONG_MAX>=9223372036854775807LL +# define OC_CLZ64_OFFS ((int)sizeof(unsigned long)*CHAR_BIT) +# define OC_CLZ64(_x) (__builtin_clzl(_x)) +# elif LLONG_MAX>=9223372036854775807LL|| \ + __LONG_LONG_MAX__>=9223372036854775807LL +# define OC_CLZ64_OFFS ((int)sizeof(unsigned long long)*CHAR_BIT) +# define OC_CLZ64(_x) (__builtin_clzll(_x)) +# endif +# endif +# endif + + + +/** + * oc_ilog32 - Integer binary logarithm of a 32-bit value. + * @_v: A 32-bit value. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * The OC_ILOG_32() or OC_ILOGNZ_32() macros may be able to use a builtin + * function instead, which should be faster. + */ +int oc_ilog32(ogg_uint32_t _v); +/** + * oc_ilog64 - Integer binary logarithm of a 64-bit value. + * @_v: A 64-bit value. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * The OC_ILOG_64() or OC_ILOGNZ_64() macros may be able to use a builtin + * function instead, which should be faster. + */ +int oc_ilog64(ogg_int64_t _v); + + +# if defined(OC_CLZ32) +/** + * OC_ILOGNZ_32 - Integer binary logarithm of a non-zero 32-bit value. + * @_v: A non-zero 32-bit value. + * Returns floor(log2(_v))+1. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * If _v is zero, the return value is undefined; use OC_ILOG_32() instead. + */ +# define OC_ILOGNZ_32(_v) (OC_CLZ32_OFFS-OC_CLZ32(_v)) +/** + * OC_ILOG_32 - Integer binary logarithm of a 32-bit value. + * @_v: A 32-bit value. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + */ +# define OC_ILOG_32(_v) (OC_ILOGNZ_32(_v)&-!!(_v)) +# else +# define OC_ILOGNZ_32(_v) (oc_ilog32(_v)) +# define OC_ILOG_32(_v) (oc_ilog32(_v)) +# endif + +# if defined(CLZ64) +/** + * OC_ILOGNZ_64 - Integer binary logarithm of a non-zero 64-bit value. + * @_v: A non-zero 64-bit value. + * Returns floor(log2(_v))+1. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * If _v is zero, the return value is undefined; use OC_ILOG_64() instead. + */ +# define OC_ILOGNZ_64(_v) (CLZ64_OFFS-CLZ64(_v)) +/** + * OC_ILOG_64 - Integer binary logarithm of a 64-bit value. + * @_v: A 64-bit value. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + */ +# define OC_ILOG_64(_v) (OC_ILOGNZ_64(_v)&-!!(_v)) +# else +# define OC_ILOGNZ_64(_v) (oc_ilog64(_v)) +# define OC_ILOG_64(_v) (oc_ilog64(_v)) +# endif + +# define OC_STATIC_ILOG0(_v) (!!(_v)) +# define OC_STATIC_ILOG1(_v) (((_v)&0x2)?2:OC_STATIC_ILOG0(_v)) +# define OC_STATIC_ILOG2(_v) \ + (((_v)&0xC)?2+OC_STATIC_ILOG1((_v)>>2):OC_STATIC_ILOG1(_v)) +# define OC_STATIC_ILOG3(_v) \ + (((_v)&0xF0)?4+OC_STATIC_ILOG2((_v)>>4):OC_STATIC_ILOG2(_v)) +# define OC_STATIC_ILOG4(_v) \ + (((_v)&0xFF00)?8+OC_STATIC_ILOG3((_v)>>8):OC_STATIC_ILOG3(_v)) +# define OC_STATIC_ILOG5(_v) \ + (((_v)&0xFFFF0000)?16+OC_STATIC_ILOG4((_v)>>16):OC_STATIC_ILOG4(_v)) +# define OC_STATIC_ILOG6(_v) \ + (((_v)&0xFFFFFFFF00000000ULL)?32+OC_STATIC_ILOG5((_v)>>32):OC_STATIC_ILOG5(_v)) +/** + * OC_STATIC_ILOG_32 - The integer logarithm of an (unsigned, 32-bit) constant. + * @_v: A non-negative 32-bit constant. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * This macro is suitable for evaluation at compile time, but it should not be + * used on values that can change at runtime, as it operates via exhaustive + * search. + */ +# define OC_STATIC_ILOG_32(_v) (OC_STATIC_ILOG5((ogg_uint32_t)(_v))) +/** + * OC_STATIC_ILOG_64 - The integer logarithm of an (unsigned, 64-bit) constant. + * @_v: A non-negative 64-bit constant. + * Returns floor(log2(_v))+1, or 0 if _v==0. + * This is the number of bits that would be required to represent _v in two's + * complement notation with all of the leading zeros stripped. + * This macro is suitable for evaluation at compile time, but it should not be + * used on values that can change at runtime, as it operates via exhaustive + * search. + */ +# define OC_STATIC_ILOG_64(_v) (OC_STATIC_ILOG6((ogg_int64_t)(_v))) + +#define OC_Q57(_v) ((ogg_int64_t)(_v)<<57) + +ogg_int64_t oc_bexp64(ogg_int64_t _z); +ogg_int64_t oc_blog64(ogg_int64_t _w); + +#endif diff --git a/libs/libtheora-1.1/lib/mcenc.c b/libs/libtheora-1.1/lib/mcenc.c new file mode 100644 index 00000000..797e81f4 --- /dev/null +++ b/libs/libtheora-1.1/lib/mcenc.c @@ -0,0 +1,767 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id$ + + ********************************************************************/ +#include +#include +#include +#include "encint.h" + + + +typedef struct oc_mcenc_ctx oc_mcenc_ctx; + + + +/*Temporary state used for motion estimation.*/ +struct oc_mcenc_ctx{ + /*The candidate motion vectors.*/ + int candidates[13][2]; + /*The start of the Set B candidates.*/ + int setb0; + /*The total number of candidates.*/ + int ncandidates; +}; + + + +/*The maximum Y plane SAD value for accepting the median predictor.*/ +#define OC_YSAD_THRESH1 (256) +/*The amount to right shift the minimum error by when inflating it for + computing the second maximum Y plane SAD threshold.*/ +#define OC_YSAD_THRESH2_SCALE_BITS (4) +/*The amount to add to the second maximum Y plane threshold when inflating + it.*/ +#define OC_YSAD_THRESH2_OFFSET (64) + +/*The vector offsets in the X direction for each search site in the square + pattern.*/ +static const int OC_SQUARE_DX[9]={-1,0,1,-1,0,1,-1,0,1}; +/*The vector offsets in the Y direction for each search site in the square + pattern.*/ +static const int OC_SQUARE_DY[9]={-1,-1,-1,0,0,0,1,1,1}; +/*The number of sites to search for each boundary condition in the square + pattern. + Bit flags for the boundary conditions are as follows: + 1: -16==dx + 2: dx==15(.5) + 4: -16==dy + 8: dy==15(.5)*/ +static const int OC_SQUARE_NSITES[11]={8,5,5,0,5,3,3,0,5,3,3}; +/*The list of sites to search for each boundary condition in the square + pattern.*/ +static const int OC_SQUARE_SITES[11][8]={ + /* -15.5mb_info; + /*Skip a position to store the median predictor in.*/ + ncandidates=1; + if(embs[_mbi].ncneighbors>0){ + /*Fill in the first part of set A: the vectors from adjacent blocks.*/ + for(i=0;icandidates[ncandidates][0]=embs[nmbi].analysis_mv[0][_frame][0]; + _mcenc->candidates[ncandidates][1]=embs[nmbi].analysis_mv[0][_frame][1]; + ncandidates++; + } + } + /*Add a few additional vectors to set A: the vectors used in the previous + frames and the (0,0) vector.*/ + _mcenc->candidates[ncandidates][0]=OC_CLAMPI(-31,_accum[0],31); + _mcenc->candidates[ncandidates][1]=OC_CLAMPI(-31,_accum[1],31); + ncandidates++; + _mcenc->candidates[ncandidates][0]=OC_CLAMPI(-31, + embs[_mbi].analysis_mv[1][_frame][0]+_accum[0],31); + _mcenc->candidates[ncandidates][1]=OC_CLAMPI(-31, + embs[_mbi].analysis_mv[1][_frame][1]+_accum[1],31); + ncandidates++; + _mcenc->candidates[ncandidates][0]=0; + _mcenc->candidates[ncandidates][1]=0; + ncandidates++; + /*Use the first three vectors of set A to find our best predictor: their + median.*/ + memcpy(a,_mcenc->candidates+1,sizeof(a)); + OC_SORT2I(a[0][0],a[1][0]); + OC_SORT2I(a[0][1],a[1][1]); + OC_SORT2I(a[1][0],a[2][0]); + OC_SORT2I(a[1][1],a[2][1]); + OC_SORT2I(a[0][0],a[1][0]); + OC_SORT2I(a[0][1],a[1][1]); + _mcenc->candidates[0][0]=a[1][0]; + _mcenc->candidates[0][1]=a[1][1]; + /*Fill in set B: accelerated predictors for this and adjacent macro blocks.*/ + _mcenc->setb0=ncandidates; + /*The first time through the loop use the current macro block.*/ + nmbi=_mbi; + for(i=0;;i++){ + _mcenc->candidates[ncandidates][0]=OC_CLAMPI(-31, + 2*embs[_mbi].analysis_mv[1][_frame][0] + -embs[_mbi].analysis_mv[2][_frame][0]+_accum[0],31); + _mcenc->candidates[ncandidates][1]=OC_CLAMPI(-31, + 2*embs[_mbi].analysis_mv[1][_frame][1] + -embs[_mbi].analysis_mv[2][_frame][1]+_accum[1],31); + ncandidates++; + if(i>=embs[_mbi].npneighbors)break; + nmbi=embs[_mbi].pneighbors[i]; + } + /*Truncate to full-pel positions.*/ + for(i=0;icandidates[i][0]=OC_DIV2(_mcenc->candidates[i][0]); + _mcenc->candidates[i][1]=OC_DIV2(_mcenc->candidates[i][1]); + } + _mcenc->ncandidates=ncandidates; +} + +#if 0 +static unsigned oc_sad16_halfpel(const oc_enc_ctx *_enc, + const ptrdiff_t *_frag_buf_offs,const ptrdiff_t _fragis[4], + int _mvoffset0,int _mvoffset1,const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _best_err){ + unsigned err; + int bi; + err=0; + for(bi=0;bi<4;bi++){ + ptrdiff_t frag_offs; + frag_offs=_frag_buf_offs[_fragis[bi]]; + err+=oc_enc_frag_sad2_thresh(_enc,_src+frag_offs,_ref+frag_offs+_mvoffset0, + _ref+frag_offs+_mvoffset1,_ystride,_best_err-err); + } + return err; +} +#endif + +static unsigned oc_satd16_halfpel(const oc_enc_ctx *_enc, + const ptrdiff_t *_frag_buf_offs,const ptrdiff_t _fragis[4], + int _mvoffset0,int _mvoffset1,const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _best_err){ + unsigned err; + int bi; + err=0; + for(bi=0;bi<4;bi++){ + ptrdiff_t frag_offs; + frag_offs=_frag_buf_offs[_fragis[bi]]; + err+=oc_enc_frag_satd2_thresh(_enc,_src+frag_offs,_ref+frag_offs+_mvoffset0, + _ref+frag_offs+_mvoffset1,_ystride,_best_err-err); + } + return err; +} + +static unsigned oc_mcenc_ysad_check_mbcandidate_fullpel(const oc_enc_ctx *_enc, + const ptrdiff_t *_frag_buf_offs,const ptrdiff_t _fragis[4],int _dx,int _dy, + const unsigned char *_src,const unsigned char *_ref,int _ystride, + unsigned _block_err[4]){ + unsigned err; + int mvoffset; + int bi; + mvoffset=_dx+_dy*_ystride; + err=0; + for(bi=0;bi<4;bi++){ + ptrdiff_t frag_offs; + unsigned block_err; + frag_offs=_frag_buf_offs[_fragis[bi]]; + block_err=oc_enc_frag_sad(_enc, + _src+frag_offs,_ref+frag_offs+mvoffset,_ystride); + _block_err[bi]=block_err; + err+=block_err; + } + return err; +} + +static int oc_mcenc_ysatd_check_mbcandidate_fullpel(const oc_enc_ctx *_enc, + const ptrdiff_t *_frag_buf_offs,const ptrdiff_t _fragis[4],int _dx,int _dy, + const unsigned char *_src,const unsigned char *_ref,int _ystride){ + int mvoffset; + int err; + int bi; + mvoffset=_dx+_dy*_ystride; + err=0; + for(bi=0;bi<4;bi++){ + ptrdiff_t frag_offs; + frag_offs=_frag_buf_offs[_fragis[bi]]; + err+=oc_enc_frag_satd_thresh(_enc, + _src+frag_offs,_ref+frag_offs+mvoffset,_ystride,UINT_MAX); + } + return err; +} + +static unsigned oc_mcenc_ysatd_check_bcandidate_fullpel(const oc_enc_ctx *_enc, + ptrdiff_t _frag_offs,int _dx,int _dy, + const unsigned char *_src,const unsigned char *_ref,int _ystride){ + return oc_enc_frag_satd_thresh(_enc, + _src+_frag_offs,_ref+_frag_offs+_dx+_dy*_ystride,_ystride,UINT_MAX); +} + +/*Perform a motion vector search for this macro block against a single + reference frame. + As a bonus, individual block motion vectors are computed as well, as much of + the work can be shared. + The actual motion vector is stored in the appropriate place in the + oc_mb_enc_info structure. + _mcenc: The motion compensation context. + _accum: Drop frame/golden MV accumulators. + _mbi: The macro block index. + _frame: The frame to search, either OC_FRAME_PREV or OC_FRAME_GOLD.*/ +void oc_mcenc_search_frame(oc_enc_ctx *_enc,int _accum[2],int _mbi,int _frame){ + /*Note: Traditionally this search is done using a rate-distortion objective + function of the form D+lambda*R. + However, xiphmont tested this and found it produced a small degredation, + while requiring extra computation. + This is most likely due to Theora's peculiar MV encoding scheme: MVs are + not coded relative to a predictor, and the only truly cheap way to use a + MV is in the LAST or LAST2 MB modes, which are not being considered here. + Therefore if we use the MV found here, it's only because both LAST and + LAST2 performed poorly, and therefore the MB is not likely to be uniform + or suffer from the aperture problem. + Furthermore we would like to re-use the MV found here for as many MBs as + possible, so picking a slightly sub-optimal vector to save a bit or two + may cause increased degredation in many blocks to come. + We could artificially reduce lambda to compensate, but it's faster to just + disable it entirely, and use D (the distortion) as the sole criterion.*/ + oc_mcenc_ctx mcenc; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *fragis; + const unsigned char *src; + const unsigned char *ref; + int ystride; + oc_mb_enc_info *embs; + ogg_int32_t hit_cache[31]; + ogg_int32_t hitbit; + unsigned best_block_err[4]; + unsigned block_err[4]; + unsigned best_err; + int best_vec[2]; + int best_block_vec[4][2]; + int candx; + int candy; + int bi; + embs=_enc->mb_info; + /*Find some candidate motion vectors.*/ + oc_mcenc_find_candidates(_enc,&mcenc,_accum,_mbi,_frame); + /*Clear the cache of locations we've examined.*/ + memset(hit_cache,0,sizeof(hit_cache)); + /*Start with the median predictor.*/ + candx=mcenc.candidates[0][0]; + candy=mcenc.candidates[0][1]; + hit_cache[candy+15]|=(ogg_int32_t)1<state.frag_buf_offs; + fragis=_enc->state.mb_maps[_mbi][0]; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[_frame]]; + ystride=_enc->state.ref_ystride[0]; + /*TODO: customize error function for speed/(quality+size) tradeoff.*/ + best_err=oc_mcenc_ysad_check_mbcandidate_fullpel(_enc, + frag_buf_offs,fragis,candx,candy,src,ref,ystride,block_err); + best_vec[0]=candx; + best_vec[1]=candy; + if(_frame==OC_FRAME_PREV){ + for(bi=0;bi<4;bi++){ + best_block_err[bi]=block_err[bi]; + best_block_vec[bi][0]=candx; + best_block_vec[bi][1]=candy; + } + } + /*If this predictor fails, move on to set A.*/ + if(best_err>OC_YSAD_THRESH1){ + unsigned err; + unsigned t2; + int ncs; + int ci; + /*Compute the early termination threshold for set A.*/ + t2=embs[_mbi].error[_frame]; + ncs=OC_MINI(3,embs[_mbi].ncneighbors); + for(ci=0;ci>OC_YSAD_THRESH2_SCALE_BITS)+OC_YSAD_THRESH2_OFFSET; + /*Examine the candidates in set A.*/ + for(ci=1;cit2){ + /*Examine the candidates in set B.*/ + for(;cit2){ + int best_site; + int nsites; + int sitei; + int site; + int b; + /*Square pattern search.*/ + for(;;){ + best_site=4; + /*Compose the bit flags for boundary conditions.*/ + b=OC_DIV16(-best_vec[0]+1)|OC_DIV16(best_vec[0]+1)<<1| + OC_DIV16(-best_vec[1]+1)<<2|OC_DIV16(best_vec[1]+1)<<3; + nsites=OC_SQUARE_NSITES[b]; + for(sitei=0;sitei>=2; + for(bi=0;bi<4;bi++){ + if(best_block_err[bi]>t2){ + /*Square pattern search. + We do this in a slightly interesting manner. + We continue to check the SAD of all four blocks in the + macro block. + This gives us two things: + 1) We can continue to use the hit_cache to avoid duplicate + checks. + Otherwise we could continue to read it, but not write to it + without saving and restoring it for each block. + Note that we could still eliminate a large number of + duplicate checks by taking into account the site we came + from when choosing the site list. + We can still do that to avoid extra hit_cache queries, and + it might even be a speed win. + 2) It gives us a slightly better chance of escaping local + minima. + We would not be here if we weren't doing a fairly bad job + in finding a good vector, and checking these vectors can + save us from 100 to several thousand points off our SAD 1 + in 15 times. + TODO: Is this a good idea? + Who knows. + It needs more testing.*/ + for(;;){ + int bestx; + int besty; + int bj; + bestx=best_block_vec[bi][0]; + besty=best_block_vec[bi][1]; + /*Compose the bit flags for boundary conditions.*/ + b=OC_DIV16(-bestx+1)|OC_DIV16(bestx+1)<<1| + OC_DIV16(-besty+1)<<2|OC_DIV16(besty+1)<<3; + nsites=OC_SQUARE_NSITES[b]; + for(sitei=0;siteimb_info[_mbi].analysis_mv; + if(_enc->prevframe_dropped){ + accum_p[0]=mvs[0][OC_FRAME_PREV][0]; + accum_p[1]=mvs[0][OC_FRAME_PREV][1]; + } + else accum_p[1]=accum_p[0]=0; + accum_g[0]=mvs[2][OC_FRAME_GOLD][0]; + accum_g[1]=mvs[2][OC_FRAME_GOLD][1]; + mvs[0][OC_FRAME_PREV][0]-=mvs[2][OC_FRAME_PREV][0]; + mvs[0][OC_FRAME_PREV][1]-=mvs[2][OC_FRAME_PREV][1]; + /*Move the motion vector predictors back a frame.*/ + memmove(mvs+1,mvs,2*sizeof(*mvs)); + /*Search the last frame.*/ + oc_mcenc_search_frame(_enc,accum_p,_mbi,OC_FRAME_PREV); + mvs[2][OC_FRAME_PREV][0]=accum_p[0]; + mvs[2][OC_FRAME_PREV][1]=accum_p[1]; + /*GOLDEN MVs are different from PREV MVs in that they're each absolute + offsets from some frame in the past rather than relative offsets from the + frame before. + For predictor calculation to make sense, we need them to be in the same + form as PREV MVs.*/ + mvs[1][OC_FRAME_GOLD][0]-=mvs[2][OC_FRAME_GOLD][0]; + mvs[1][OC_FRAME_GOLD][1]-=mvs[2][OC_FRAME_GOLD][1]; + mvs[2][OC_FRAME_GOLD][0]-=accum_g[0]; + mvs[2][OC_FRAME_GOLD][1]-=accum_g[1]; + /*Search the golden frame.*/ + oc_mcenc_search_frame(_enc,accum_g,_mbi,OC_FRAME_GOLD); + /*Put GOLDEN MVs back into absolute offset form. + The newest MV is already an absolute offset.*/ + mvs[2][OC_FRAME_GOLD][0]+=accum_g[0]; + mvs[2][OC_FRAME_GOLD][1]+=accum_g[1]; + mvs[1][OC_FRAME_GOLD][0]+=mvs[2][OC_FRAME_GOLD][0]; + mvs[1][OC_FRAME_GOLD][1]+=mvs[2][OC_FRAME_GOLD][1]; +} + +#if 0 +static int oc_mcenc_ysad_halfpel_mbrefine(const oc_enc_ctx *_enc,int _mbi, + int _vec[2],int _best_err,int _frame){ + const unsigned char *src; + const unsigned char *ref; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *fragis; + int offset_y[9]; + int ystride; + int mvoffset_base; + int best_site; + int sitei; + int err; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[_framei]]; + frag_buf_offs=_enc->state.frag_buf_offs; + fragis=_enc->state.mb_maps[_mbi][0]; + ystride=_enc->state.ref_ystride[0]; + mvoffset_base=_vec[0]+_vec[1]*ystride; + offset_y[0]=offset_y[1]=offset_y[2]=-ystride; + offset_y[3]=offset_y[5]=0; + offset_y[6]=offset_y[7]=offset_y[8]=ystride; + best_site=4; + for(sitei=0;sitei<8;sitei++){ + int site; + int xmask; + int ymask; + int dx; + int dy; + int mvoffset0; + int mvoffset1; + site=OC_SQUARE_SITES[0][sitei]; + dx=OC_SQUARE_DX[site]; + dy=OC_SQUARE_DY[site]; + /*The following code SHOULD be equivalent to + oc_state_get_mv_offsets(&_mcenc->enc.state,&mvoffset0,&mvoffset1, + (_vec[0]<<1)+dx,(_vec[1]<<1)+dy,ref_ystride,0); + However, it should also be much faster, as it involves no multiplies and + doesn't have to handle chroma vectors.*/ + xmask=OC_SIGNMASK(((_vec[0]<<1)+dx)^dx); + ymask=OC_SIGNMASK(((_vec[1]<<1)+dy)^dy); + mvoffset0=mvoffset_base+(dx&xmask)+(offset_y[site]&ymask); + mvoffset1=mvoffset_base+(dx&~xmask)+(offset_y[site]&~ymask); + err=oc_sad16_halfpel(_enc,frag_buf_offs,fragis, + mvoffset0,mvoffset1,src,ref,ystride,_best_err); + if(err<_best_err){ + _best_err=err; + best_site=site; + } + } + _vec[0]=(_vec[0]<<1)+OC_SQUARE_DX[best_site]; + _vec[1]=(_vec[1]<<1)+OC_SQUARE_DY[best_site]; + return _best_err; +} +#endif + +static unsigned oc_mcenc_ysatd_halfpel_mbrefine(const oc_enc_ctx *_enc, + int _mbi,int _vec[2],unsigned _best_err,int _frame){ + const unsigned char *src; + const unsigned char *ref; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *fragis; + int offset_y[9]; + int ystride; + int mvoffset_base; + int best_site; + int sitei; + int err; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[_frame]]; + frag_buf_offs=_enc->state.frag_buf_offs; + fragis=_enc->state.mb_maps[_mbi][0]; + ystride=_enc->state.ref_ystride[0]; + mvoffset_base=_vec[0]+_vec[1]*ystride; + offset_y[0]=offset_y[1]=offset_y[2]=-ystride; + offset_y[3]=offset_y[5]=0; + offset_y[6]=offset_y[7]=offset_y[8]=ystride; + best_site=4; + for(sitei=0;sitei<8;sitei++){ + int site; + int xmask; + int ymask; + int dx; + int dy; + int mvoffset0; + int mvoffset1; + site=OC_SQUARE_SITES[0][sitei]; + dx=OC_SQUARE_DX[site]; + dy=OC_SQUARE_DY[site]; + /*The following code SHOULD be equivalent to + oc_state_get_mv_offsets(&_mcenc->enc.state,&mvoffset0,&mvoffset1, + (_vec[0]<<1)+dx,(_vec[1]<<1)+dy,ref_ystride,0); + However, it should also be much faster, as it involves no multiplies and + doesn't have to handle chroma vectors.*/ + xmask=OC_SIGNMASK(((_vec[0]<<1)+dx)^dx); + ymask=OC_SIGNMASK(((_vec[1]<<1)+dy)^dy); + mvoffset0=mvoffset_base+(dx&xmask)+(offset_y[site]&ymask); + mvoffset1=mvoffset_base+(dx&~xmask)+(offset_y[site]&~ymask); + err=oc_satd16_halfpel(_enc,frag_buf_offs,fragis, + mvoffset0,mvoffset1,src,ref,ystride,_best_err); + if(err<_best_err){ + _best_err=err; + best_site=site; + } + } + _vec[0]=(_vec[0]<<1)+OC_SQUARE_DX[best_site]; + _vec[1]=(_vec[1]<<1)+OC_SQUARE_DY[best_site]; + return _best_err; +} + +void oc_mcenc_refine1mv(oc_enc_ctx *_enc,int _mbi,int _frame){ + oc_mb_enc_info *embs; + int vec[2]; + embs=_enc->mb_info; + vec[0]=OC_DIV2(embs[_mbi].analysis_mv[0][_frame][0]); + vec[1]=OC_DIV2(embs[_mbi].analysis_mv[0][_frame][1]); + embs[_mbi].satd[_frame]=oc_mcenc_ysatd_halfpel_mbrefine(_enc, + _mbi,vec,embs[_mbi].satd[_frame],_frame); + embs[_mbi].analysis_mv[0][_frame][0]=(signed char)vec[0]; + embs[_mbi].analysis_mv[0][_frame][1]=(signed char)vec[1]; +} + +#if 0 +static int oc_mcenc_ysad_halfpel_brefine(const oc_enc_ctx *_enc, + int _vec[2],const unsigned char *_src,const unsigned char *_ref,int _ystride, + int _offset_y[9],unsigned _best_err){ + int mvoffset_base; + int best_site; + int sitei; + mvoffset_base=_vec[0]+_vec[1]*_ystride; + best_site=4; + for(sitei=0;sitei<8;sitei++){ + unsigned err; + int site; + int xmask; + int ymask; + int dx; + int dy; + int mvoffset0; + int mvoffset1; + site=OC_SQUARE_SITES[0][sitei]; + dx=OC_SQUARE_DX[site]; + dy=OC_SQUARE_DY[site]; + /*The following code SHOULD be equivalent to + oc_state_get_mv_offsets(&_mcenc->enc.state,&mvoffset0,&mvoffset1, + (_vec[0]<<1)+dx,(_vec[1]<<1)+dy,ref_ystride,0); + However, it should also be much faster, as it involves no multiplies and + doesn't have to handle chroma vectors.*/ + xmask=OC_SIGNMASK(((_vec[0]<<1)+dx)^dx); + ymask=OC_SIGNMASK(((_vec[1]<<1)+dy)^dy); + mvoffset0=mvoffset_base+(dx&xmask)+(_offset_y[site]&ymask); + mvoffset1=mvoffset_base+(dx&~xmask)+(_offset_y[site]&~ymask); + err=oc_enc_frag_sad2_thresh(_enc,_src, + _ref+mvoffset0,_ref+mvoffset1,ystride,_best_err); + if(err<_best_err){ + _best_err=err; + best_site=site; + } + } + _vec[0]=(_vec[0]<<1)+OC_SQUARE_DX[best_site]; + _vec[1]=(_vec[1]<<1)+OC_SQUARE_DY[best_site]; + return _best_err; +} +#endif + +static unsigned oc_mcenc_ysatd_halfpel_brefine(const oc_enc_ctx *_enc, + int _vec[2],const unsigned char *_src,const unsigned char *_ref,int _ystride, + int _offset_y[9],unsigned _best_err){ + int mvoffset_base; + int best_site; + int sitei; + mvoffset_base=_vec[0]+_vec[1]*_ystride; + best_site=4; + for(sitei=0;sitei<8;sitei++){ + unsigned err; + int site; + int xmask; + int ymask; + int dx; + int dy; + int mvoffset0; + int mvoffset1; + site=OC_SQUARE_SITES[0][sitei]; + dx=OC_SQUARE_DX[site]; + dy=OC_SQUARE_DY[site]; + /*The following code SHOULD be equivalent to + oc_state_get_mv_offsets(&_enc->state,&mvoffsets,0, + (_vec[0]<<1)+dx,(_vec[1]<<1)+dy); + However, it should also be much faster, as it involves no multiplies and + doesn't have to handle chroma vectors.*/ + xmask=OC_SIGNMASK(((_vec[0]<<1)+dx)^dx); + ymask=OC_SIGNMASK(((_vec[1]<<1)+dy)^dy); + mvoffset0=mvoffset_base+(dx&xmask)+(_offset_y[site]&ymask); + mvoffset1=mvoffset_base+(dx&~xmask)+(_offset_y[site]&~ymask); + err=oc_enc_frag_satd2_thresh(_enc,_src, + _ref+mvoffset0,_ref+mvoffset1,_ystride,_best_err); + if(err<_best_err){ + _best_err=err; + best_site=site; + } + } + _vec[0]=(_vec[0]<<1)+OC_SQUARE_DX[best_site]; + _vec[1]=(_vec[1]<<1)+OC_SQUARE_DY[best_site]; + return _best_err; +} + +void oc_mcenc_refine4mv(oc_enc_ctx *_enc,int _mbi){ + oc_mb_enc_info *embs; + const ptrdiff_t *frag_buf_offs; + const ptrdiff_t *fragis; + const unsigned char *src; + const unsigned char *ref; + int offset_y[9]; + int ystride; + int bi; + ystride=_enc->state.ref_ystride[0]; + frag_buf_offs=_enc->state.frag_buf_offs; + fragis=_enc->state.mb_maps[_mbi][0]; + src=_enc->state.ref_frame_data[OC_FRAME_IO]; + ref=_enc->state.ref_frame_data[_enc->state.ref_frame_idx[OC_FRAME_PREV]]; + offset_y[0]=offset_y[1]=offset_y[2]=-ystride; + offset_y[3]=offset_y[5]=0; + offset_y[6]=offset_y[7]=offset_y[8]=ystride; + embs=_enc->mb_info; + for(bi=0;bi<4;bi++){ + ptrdiff_t frag_offs; + int vec[2]; + frag_offs=frag_buf_offs[fragis[bi]]; + vec[0]=OC_DIV2(embs[_mbi].block_mv[bi][0]); + vec[1]=OC_DIV2(embs[_mbi].block_mv[bi][1]); + embs[_mbi].block_satd[bi]=oc_mcenc_ysatd_halfpel_brefine(_enc,vec, + src+frag_offs,ref+frag_offs,ystride,offset_y,embs[_mbi].block_satd[bi]); + embs[_mbi].ref_mv[bi][0]=(signed char)vec[0]; + embs[_mbi].ref_mv[bi][1]=(signed char)vec[1]; + } +} diff --git a/libs/libtheora-1.1/lib/modedec.h b/libs/libtheora-1.1/lib/modedec.h new file mode 100644 index 00000000..ea12c64a --- /dev/null +++ b/libs/libtheora-1.1/lib/modedec.h @@ -0,0 +1,4027 @@ +/*File generated by libtheora with OC_COLLECT_METRICS defined at compile time.*/ +#if !defined(_modedec_H) +# define _modedec_H (1) + + + +# if defined(OC_COLLECT_METRICS) +typedef struct oc_mode_metrics oc_mode_metrics; +# endif +typedef struct oc_mode_rd oc_mode_rd; + + + +/*The number of extra bits of precision at which to store rate metrics.*/ +# define OC_BIT_SCALE (6) +/*The number of extra bits of precision at which to store RMSE metrics. + This must be at least half OC_BIT_SCALE (rounded up).*/ +# define OC_RMSE_SCALE (5) +/*The number of bins to partition statistics into.*/ +# define OC_SAD_BINS (24) +/*The number of bits of precision to drop from SAD scores to assign them to a + bin.*/ +# define OC_SAD_SHIFT (9) + + + +# if defined(OC_COLLECT_METRICS) +struct oc_mode_metrics{ + double fragw; + double satd; + double rate; + double rmse; + double satd2; + double satdrate; + double rate2; + double satdrmse; + double rmse2; +}; + + +int oc_has_mode_metrics; +oc_mode_metrics OC_MODE_METRICS[64][3][2][OC_SAD_BINS]; +# endif + + + +struct oc_mode_rd{ + ogg_int16_t rate; + ogg_int16_t rmse; +}; + + +# if !defined(OC_COLLECT_METRICS) +static const +# endif +oc_mode_rd OC_MODE_RD[64][3][2][OC_SAD_BINS]={ + { + { + /*Y' qi=0 INTRA*/ + { + { 87, -66},{ 132, 1611},{ 197, 3474},{ 285, 5130}, + { 376, 6419},{ 450, 7545},{ 521, 8587},{ 600, 9587}, + { 689,10498},{ 790,11348},{ 899,12158},{ 1030,12855}, + { 1166,13459},{ 1276,14052},{ 1353,14732},{ 1444,15425}, + { 1535,16101},{ 1609,16856},{ 1697,17532},{ 1823,17995}, + { 1962,18426},{ 2085,18919},{ 2201,19503},{ 2304,20307} + }, + /*Y' qi=0 INTER*/ + { + { 32, -105},{ 40, 1268},{ 54, 2919},{ 91, 4559}, + { 118, 6244},{ 132, 7932},{ 142, 9514},{ 149,10989}, + { 155,12375},{ 161,13679},{ 168,14958},{ 176,16215}, + { 187,17431},{ 196,18623},{ 207,19790},{ 218,20941}, + { 230,22083},{ 246,23213},{ 265,24333},{ 292,25439}, + { 328,26512},{ 372,27538},{ 427,28522},{ 494,29479} + } + }, + { + /*Cb qi=0 INTRA*/ + { + { 1, 6},{ 27, 368},{ 52, 738},{ 67, 1171}, + { 80, 1642},{ 99, 2134},{ 110, 2642},{ 112, 3144}, + { 126, 3578},{ 154, 3967},{ 167, 4387},{ 172, 4839}, + { 191, 5278},{ 208, 5666},{ 220, 6036},{ 223, 6398}, + { 227, 6814},{ 253, 7157},{ 284, 7403},{ 292, 7699}, + { 314, 7983},{ 339, 8203},{ 363, 8460},{ 399, 8919} + }, + /*Cb qi=0 INTER*/ + { + { 68, -55},{ 63, 275},{ 58, 602},{ 53, 936}, + { 50, 1290},{ 54, 1691},{ 58, 2116},{ 62, 2553}, + { 67, 2992},{ 72, 3422},{ 78, 3843},{ 84, 4253}, + { 89, 4658},{ 94, 5062},{ 98, 5455},{ 100, 5848}, + { 102, 6231},{ 104, 6604},{ 104, 6982},{ 105, 7359}, + { 105, 7733},{ 104, 8104},{ 105, 8465},{ 111, 8828} + } + }, + { + /*Cr qi=0 INTRA*/ + { + { 1, 8},{ 23, 375},{ 47, 759},{ 63, 1220}, + { 71, 1693},{ 82, 2171},{ 94, 2652},{ 109, 3103}, + { 125, 3567},{ 133, 3995},{ 151, 4375},{ 168, 4819}, + { 174, 5244},{ 190, 5635},{ 215, 6005},{ 242, 6347}, + { 257, 6758},{ 280, 7068},{ 311, 7336},{ 326, 7652}, + { 346, 7968},{ 372, 8213},{ 388, 8515},{ 408, 9060} + }, + /*Cr qi=0 INTER*/ + { + { 69, 0},{ 60, 314},{ 49, 624},{ 45, 943}, + { 45, 1285},{ 49, 1691},{ 55, 2130},{ 62, 2560}, + { 71, 2973},{ 79, 3385},{ 85, 3800},{ 89, 4207}, + { 92, 4620},{ 95, 5037},{ 96, 5436},{ 97, 5839}, + { 98, 6252},{ 99, 6653},{ 99, 7038},{ 103, 7426}, + { 107, 7810},{ 108, 8178},{ 107, 8539},{ 106, 8937} + } + } + }, + { + { + /*Y' qi=1 INTRA*/ + { + { 81, -71},{ 133, 1610},{ 203, 3460},{ 296, 5083}, + { 392, 6342},{ 467, 7454},{ 541, 8486},{ 625, 9466}, + { 716,10352},{ 823,11181},{ 940,11961},{ 1074,12643}, + { 1211,13233},{ 1324,13807},{ 1408,14489},{ 1504,15167}, + { 1598,15824},{ 1679,16544},{ 1788,17161},{ 1928,17579}, + { 2070,17991},{ 2202,18456},{ 2324,19021},{ 2425,19894} + }, + /*Y' qi=1 INTER*/ + { + { 34, 4},{ 40, 1307},{ 55, 2914},{ 93, 4555}, + { 120, 6243},{ 134, 7912},{ 144, 9468},{ 152,10918}, + { 158,12275},{ 164,13569},{ 171,14846},{ 180,16098}, + { 191,17310},{ 204,18484},{ 216,19636},{ 228,20779}, + { 242,21912},{ 261,23036},{ 286,24146},{ 320,25221}, + { 363,26265},{ 418,27261},{ 485,28203},{ 551,29148} + } + }, + { + /*Cb qi=1 INTRA*/ + { + { 1, 6},{ 28, 367},{ 52, 738},{ 68, 1172}, + { 86, 1644},{ 106, 2135},{ 115, 2642},{ 119, 3141}, + { 132, 3569},{ 157, 3951},{ 172, 4366},{ 177, 4819}, + { 194, 5258},{ 211, 5638},{ 224, 6006},{ 233, 6367}, + { 236, 6784},{ 258, 7121},{ 299, 7357},{ 319, 7637}, + { 337, 7921},{ 358, 8141},{ 381, 8367},{ 401, 8768} + }, + /*Cb qi=1 INTER*/ + { + { 95, -31},{ 81, 295},{ 67, 614},{ 53, 953}, + { 48, 1305},{ 51, 1700},{ 56, 2125},{ 61, 2563}, + { 67, 3008},{ 73, 3435},{ 79, 3844},{ 85, 4251}, + { 90, 4663},{ 95, 5073},{ 98, 5458},{ 100, 5844}, + { 101, 6231},{ 102, 6606},{ 102, 6980},{ 103, 7347}, + { 104, 7726},{ 105, 8096},{ 105, 8453},{ 105, 8789} + } + }, + { + /*Cr qi=1 INTRA*/ + { + { 1, 8},{ 25, 375},{ 50, 759},{ 65, 1221}, + { 74, 1695},{ 86, 2172},{ 101, 2651},{ 117, 3101}, + { 129, 3561},{ 135, 3985},{ 153, 4368},{ 171, 4807}, + { 182, 5223},{ 202, 5608},{ 225, 5964},{ 251, 6300}, + { 271, 6697},{ 295, 6978},{ 324, 7235},{ 348, 7558}, + { 367, 7877},{ 394, 8101},{ 413, 8386},{ 409, 8945} + }, + /*Cr qi=1 INTER*/ + { + { 66, 11},{ 59, 323},{ 51, 631},{ 44, 949}, + { 44, 1292},{ 49, 1703},{ 56, 2140},{ 62, 2566}, + { 69, 2991},{ 77, 3397},{ 84, 3799},{ 89, 4211}, + { 93, 4634},{ 94, 5049},{ 95, 5444},{ 96, 5854}, + { 94, 6260},{ 95, 6640},{ 96, 7032},{ 101, 7423}, + { 104, 7790},{ 105, 8158},{ 109, 8527},{ 108, 8872} + } + } + }, + { + { + /*Y' qi=2 INTRA*/ + { + { 87, -72},{ 139, 1607},{ 213, 3426},{ 315, 4992}, + { 416, 6217},{ 495, 7315},{ 574, 8317},{ 666, 9265}, + { 763,10124},{ 875,10906},{ 1001,11654},{ 1147,12305}, + { 1289,12865},{ 1407,13424},{ 1503,14076},{ 1610,14724}, + { 1720,15342},{ 1815,16020},{ 1937,16579},{ 2084,16981}, + { 2236,17371},{ 2385,17779},{ 2536,18250},{ 2689,18931} + }, + /*Y' qi=2 INTER*/ + { + { 30, -2},{ 40, 1308},{ 57, 2921},{ 96, 4567}, + { 122, 6260},{ 136, 7902},{ 148, 9418},{ 156,10826}, + { 162,12157},{ 169,13448},{ 177,14709},{ 188,15938}, + { 200,17133},{ 213,18295},{ 228,19433},{ 245,20564}, + { 264,21685},{ 289,22790},{ 323,23876},{ 368,24916}, + { 427,25906},{ 499,26837},{ 585,27700},{ 680,28514} + } + }, + { + /*Cb qi=2 INTRA*/ + { + { 1, 6},{ 30, 367},{ 58, 738},{ 77, 1172}, + { 93, 1645},{ 111, 2137},{ 123, 2642},{ 126, 3133}, + { 136, 3553},{ 162, 3934},{ 178, 4352},{ 183, 4803}, + { 199, 5231},{ 220, 5596},{ 235, 5957},{ 245, 6314}, + { 256, 6718},{ 286, 7048},{ 320, 7285},{ 336, 7568}, + { 366, 7829},{ 387, 8045},{ 405, 8261},{ 445, 8550} + }, + /*Cb qi=2 INTER*/ + { + { 115, -61},{ 93, 277},{ 71, 609},{ 54, 963}, + { 49, 1329},{ 53, 1715},{ 58, 2138},{ 63, 2583}, + { 69, 3017},{ 75, 3442},{ 81, 3857},{ 88, 4263}, + { 93, 4667},{ 96, 5065},{ 101, 5451},{ 101, 5832}, + { 102, 6213},{ 103, 6593},{ 103, 6968},{ 104, 7336}, + { 104, 7710},{ 105, 8076},{ 106, 8440},{ 106, 8822} + } + }, + { + /*Cr qi=2 INTRA*/ + { + { 1, 8},{ 27, 375},{ 54, 759},{ 70, 1222}, + { 79, 1696},{ 89, 2173},{ 106, 2652},{ 123, 3098}, + { 135, 3553},{ 143, 3972},{ 161, 4348},{ 181, 4782}, + { 194, 5189},{ 213, 5565},{ 235, 5907},{ 266, 6229}, + { 286, 6618},{ 311, 6897},{ 339, 7152},{ 362, 7454}, + { 392, 7721},{ 416, 7946},{ 429, 8227},{ 458, 8540} + }, + /*Cr qi=2 INTER*/ + { + { 74, 20},{ 63, 330},{ 51, 635},{ 44, 942}, + { 47, 1287},{ 54, 1710},{ 59, 2147},{ 65, 2571}, + { 72, 2996},{ 79, 3413},{ 86, 3820},{ 91, 4230}, + { 93, 4642},{ 95, 5046},{ 95, 5442},{ 95, 5839}, + { 96, 6243},{ 97, 6641},{ 99, 7021},{ 101, 7396}, + { 103, 7764},{ 106, 8138},{ 109, 8507},{ 114, 8851} + } + } + }, + { + { + /*Y' qi=3 INTRA*/ + { + { 91, -67},{ 141, 1606},{ 219, 3405},{ 328, 4929}, + { 433, 6122},{ 515, 7209},{ 598, 8204},{ 693, 9145}, + { 796, 9986},{ 912,10756},{ 1045,11471},{ 1200,12079}, + { 1345,12640},{ 1471,13179},{ 1571,13809},{ 1678,14450}, + { 1798,15047},{ 1905,15701},{ 2043,16205},{ 2202,16569}, + { 2351,16971},{ 2501,17393},{ 2660,17851},{ 2825,18455} + }, + /*Y' qi=3 INTER*/ + { + { 53, -164},{ 38, 1314},{ 59, 2917},{ 99, 4563}, + { 124, 6253},{ 139, 7882},{ 150, 9375},{ 159,10749}, + { 166,12059},{ 173,13349},{ 183,14608},{ 194,15826}, + { 208,17003},{ 223,18150},{ 240,19287},{ 259,20411}, + { 284,21508},{ 317,22593},{ 359,23656},{ 414,24671}, + { 483,25634},{ 569,26519},{ 670,27332},{ 786,28072} + } + }, + { + /*Cb qi=3 INTRA*/ + { + { 1, 5},{ 31, 367},{ 58, 739},{ 78, 1173}, + { 96, 1645},{ 113, 2134},{ 125, 2638},{ 133, 3127}, + { 148, 3542},{ 171, 3915},{ 184, 4328},{ 192, 4776}, + { 209, 5197},{ 230, 5556},{ 245, 5909},{ 252, 6261}, + { 272, 6641},{ 304, 6942},{ 330, 7184},{ 342, 7477}, + { 380, 7736},{ 404, 7962},{ 428, 8151},{ 469, 8430} + }, + /*Cb qi=3 INTER*/ + { + { 86, -29},{ 72, 296},{ 58, 618},{ 46, 964}, + { 47, 1338},{ 51, 1743},{ 56, 2158},{ 63, 2594}, + { 69, 3035},{ 77, 3455},{ 84, 3859},{ 89, 4266}, + { 94, 4673},{ 98, 5074},{ 101, 5460},{ 101, 5842}, + { 101, 6217},{ 101, 6593},{ 102, 6964},{ 104, 7325}, + { 103, 7696},{ 103, 8056},{ 104, 8430},{ 103, 8792} + } + }, + { + /*Cr qi=3 INTRA*/ + { + { 1, 8},{ 27, 374},{ 56, 759},{ 74, 1221}, + { 83, 1696},{ 96, 2173},{ 113, 2650},{ 127, 3091}, + { 140, 3542},{ 151, 3960},{ 164, 4334},{ 188, 4764}, + { 208, 5144},{ 224, 5493},{ 250, 5841},{ 278, 6162}, + { 298, 6548},{ 334, 6816},{ 365, 7045},{ 388, 7343}, + { 419, 7613},{ 443, 7836},{ 455, 8105},{ 484, 8445} + }, + /*Cr qi=3 INTER*/ + { + { 76, 26},{ 65, 332},{ 53, 638},{ 45, 945}, + { 45, 1304},{ 53, 1725},{ 60, 2153},{ 68, 2584}, + { 74, 3007},{ 81, 3425},{ 87, 3844},{ 91, 4253}, + { 94, 4657},{ 95, 5061},{ 94, 5462},{ 94, 5856}, + { 95, 6250},{ 96, 6635},{ 97, 7014},{ 101, 7393}, + { 104, 7761},{ 106, 8137},{ 109, 8506},{ 111, 8823} + } + } + }, + { + { + /*Y' qi=4 INTRA*/ + { + { 80, -67},{ 143, 1603},{ 227, 3378},{ 344, 4861}, + { 454, 6026},{ 537, 7104},{ 626, 8089},{ 725, 9006}, + { 830, 9827},{ 950,10581},{ 1089,11270},{ 1257,11826}, + { 1409,12366},{ 1535,12912},{ 1640,13528},{ 1753,14173}, + { 1884,14756},{ 2007,15368},{ 2148,15852},{ 2307,16212}, + { 2464,16591},{ 2614,17019},{ 2785,17455},{ 2970,17963} + }, + /*Y' qi=4 INTER*/ + { + { 50, -145},{ 38, 1324},{ 61, 2921},{ 102, 4566}, + { 127, 6248},{ 142, 7845},{ 154, 9300},{ 163,10656}, + { 169,11965},{ 177,13246},{ 188,14495},{ 202,15702}, + { 218,16864},{ 236,18003},{ 256,19124},{ 278,20233}, + { 307,21330},{ 347,22398},{ 398,23437},{ 463,24429}, + { 546,25343},{ 649,26170},{ 767,26935},{ 888,27674} + } + }, + { + /*Cb qi=4 INTRA*/ + { + { 1, 5},{ 33, 367},{ 61, 739},{ 80, 1173}, + { 98, 1646},{ 114, 2136},{ 126, 2639},{ 137, 3124}, + { 152, 3535},{ 176, 3903},{ 194, 4307},{ 206, 4753}, + { 222, 5165},{ 242, 5508},{ 260, 5857},{ 272, 6205}, + { 294, 6559},{ 332, 6848},{ 356, 7104},{ 364, 7389}, + { 396, 7637},{ 415, 7878},{ 446, 8064},{ 506, 8294} + }, + /*Cb qi=4 INTER*/ + { + { 86, -15},{ 73, 308},{ 60, 627},{ 46, 967}, + { 47, 1343},{ 51, 1754},{ 56, 2183},{ 63, 2615}, + { 70, 3044},{ 79, 3459},{ 85, 3866},{ 90, 4276}, + { 94, 4686},{ 97, 5088},{ 100, 5467},{ 102, 5837}, + { 102, 6205},{ 101, 6569},{ 103, 6939},{ 104, 7317}, + { 105, 7690},{ 107, 8043},{ 107, 8394},{ 111, 8736} + } + }, + { + /*Cr qi=4 INTRA*/ + { + { 1, 7},{ 28, 375},{ 57, 759},{ 79, 1221}, + { 92, 1697},{ 105, 2174},{ 122, 2648},{ 135, 3085}, + { 146, 3530},{ 157, 3947},{ 171, 4316},{ 195, 4737}, + { 218, 5117},{ 239, 5445},{ 268, 5767},{ 295, 6074}, + { 315, 6460},{ 355, 6735},{ 392, 6933},{ 418, 7218}, + { 448, 7495},{ 471, 7688},{ 481, 7954},{ 504, 8313} + }, + /*Cr qi=4 INTER*/ + { + { 68, 28},{ 57, 334},{ 47, 639},{ 43, 953}, + { 48, 1314},{ 54, 1736},{ 59, 2169},{ 69, 2592}, + { 78, 3017},{ 84, 3434},{ 88, 3850},{ 92, 4260}, + { 95, 4663},{ 96, 5068},{ 95, 5455},{ 95, 5839}, + { 96, 6243},{ 97, 6626},{ 98, 7006},{ 101, 7390}, + { 104, 7755},{ 108, 8115},{ 111, 8471},{ 110, 8825} + } + } + }, + { + { + /*Y' qi=5 INTRA*/ + { + { 84, -69},{ 147, 1599},{ 237, 3350},{ 360, 4796}, + { 475, 5934},{ 562, 6992},{ 657, 7953},{ 765, 8837}, + { 874, 9641},{ 998,10384},{ 1146,11047},{ 1322,11572}, + { 1484,12076},{ 1617,12609},{ 1731,13203},{ 1856,13806}, + { 1995,14367},{ 2132,14936},{ 2289,15386},{ 2460,15721}, + { 2635,16066},{ 2802,16442},{ 2980,16805},{ 3177,17272} + }, + /*Y' qi=5 INTER*/ + { + { 38, -86},{ 37, 1349},{ 64, 2920},{ 105, 4563}, + { 129, 6236},{ 145, 7809},{ 158, 9236},{ 167,10572}, + { 174,11871},{ 182,13141},{ 195,14368},{ 212,15558}, + { 230,16706},{ 250,17828},{ 274,18944},{ 303,20041}, + { 342,21116},{ 394,22152},{ 460,23144},{ 543,24073}, + { 648,24919},{ 773,25673},{ 922,26323},{ 1084,26924} + } + }, + { + /*Cb qi=5 INTRA*/ + { + { 1, 5},{ 34, 367},{ 63, 739},{ 82, 1174}, + { 102, 1647},{ 119, 2137},{ 134, 2639},{ 145, 3121}, + { 161, 3529},{ 189, 3891},{ 207, 4290},{ 216, 4721}, + { 232, 5113},{ 258, 5455},{ 277, 5798},{ 294, 6124}, + { 322, 6427},{ 352, 6697},{ 370, 6982},{ 384, 7283}, + { 423, 7529},{ 448, 7766},{ 478, 7943},{ 527, 8151} + }, + /*Cb qi=5 INTER*/ + { + { 83, -49},{ 69, 284},{ 55, 611},{ 48, 961}, + { 49, 1355},{ 52, 1769},{ 58, 2191},{ 65, 2616}, + { 73, 3041},{ 80, 3460},{ 87, 3868},{ 92, 4276}, + { 95, 4682},{ 98, 5077},{ 100, 5459},{ 102, 5827}, + { 102, 6200},{ 102, 6568},{ 103, 6930},{ 103, 7303}, + { 104, 7672},{ 106, 8032},{ 106, 8391},{ 106, 8727} + } + }, + { + /*Cr qi=5 INTRA*/ + { + { 1, 8},{ 28, 375},{ 57, 760},{ 81, 1222}, + { 99, 1696},{ 111, 2175},{ 125, 2648},{ 140, 3079}, + { 152, 3520},{ 162, 3927},{ 179, 4294},{ 203, 4714}, + { 225, 5080},{ 254, 5389},{ 286, 5703},{ 318, 5997}, + { 342, 6364},{ 380, 6640},{ 416, 6837},{ 445, 7103}, + { 473, 7370},{ 497, 7562},{ 514, 7811},{ 549, 8148} + }, + /*Cr qi=5 INTER*/ + { + { 60, 6},{ 54, 323},{ 46, 638},{ 43, 958}, + { 45, 1329},{ 54, 1749},{ 61, 2175},{ 70, 2600}, + { 79, 3021},{ 85, 3437},{ 89, 3847},{ 93, 4254}, + { 95, 4660},{ 96, 5065},{ 95, 5456},{ 95, 5849}, + { 96, 6243},{ 96, 6621},{ 97, 6996},{ 101, 7366}, + { 104, 7722},{ 107, 8088},{ 111, 8448},{ 119, 8816} + } + } + }, + { + { + /*Y' qi=6 INTRA*/ + { + { 88, -69},{ 151, 1593},{ 251, 3294},{ 387, 4681}, + { 507, 5790},{ 601, 6837},{ 702, 7787},{ 813, 8648}, + { 927, 9427},{ 1059,10152},{ 1213,10787},{ 1399,11284}, + { 1568,11781},{ 1705,12312},{ 1823,12890},{ 1957,13482}, + { 2106,14036},{ 2249,14600},{ 2411,15042},{ 2588,15359}, + { 2772,15699},{ 2947,16062},{ 3127,16429},{ 3320,16849} + }, + /*Y' qi=6 INTER*/ + { + { 44, -80},{ 36, 1346},{ 69, 2919},{ 111, 4563}, + { 136, 6216},{ 154, 7746},{ 168, 9139},{ 178,10461}, + { 185,11747},{ 195,13007},{ 211,14229},{ 230,15408}, + { 250,16547},{ 274,17663},{ 302,18769},{ 339,19851}, + { 386,20907},{ 446,21933},{ 527,22884},{ 631,23746}, + { 760,24512},{ 914,25178},{ 1087,25758},{ 1278,26262} + } + }, + { + /*Cb qi=6 INTRA*/ + { + { 1, 4},{ 36, 367},{ 66, 739},{ 84, 1174}, + { 105, 1648},{ 126, 2139},{ 140, 2639},{ 149, 3116}, + { 164, 3523},{ 194, 3880},{ 217, 4271},{ 226, 4694}, + { 243, 5077},{ 270, 5407},{ 291, 5742},{ 310, 6061}, + { 340, 6340},{ 373, 6609},{ 394, 6890},{ 409, 7189}, + { 444, 7434},{ 469, 7652},{ 499, 7853},{ 559, 8135} + }, + /*Cb qi=6 INTER*/ + { + { 68, -46},{ 60, 291},{ 50, 623},{ 49, 971}, + { 50, 1357},{ 55, 1781},{ 61, 2211},{ 69, 2634}, + { 78, 3052},{ 86, 3466},{ 91, 3882},{ 95, 4292}, + { 98, 4691},{ 101, 5080},{ 102, 5458},{ 103, 5830}, + { 103, 6192},{ 104, 6554},{ 104, 6916},{ 106, 7278}, + { 108, 7641},{ 110, 8004},{ 112, 8371},{ 112, 8758} + } + }, + { + /*Cr qi=6 INTRA*/ + { + { 1, 8},{ 29, 375},{ 59, 760},{ 84, 1223}, + { 99, 1698},{ 112, 2176},{ 129, 2647},{ 143, 3076}, + { 156, 3510},{ 168, 3906},{ 189, 4269},{ 220, 4682}, + { 241, 5047},{ 266, 5342},{ 299, 5649},{ 331, 5954}, + { 357, 6309},{ 393, 6579},{ 431, 6765},{ 467, 6997}, + { 501, 7276},{ 520, 7488},{ 525, 7749},{ 548, 8146} + }, + /*Cr qi=6 INTER*/ + { + { 94, 31},{ 69, 335},{ 47, 641},{ 43, 967}, + { 50, 1350},{ 57, 1772},{ 65, 2197},{ 74, 2625}, + { 83, 3043},{ 90, 3454},{ 94, 3867},{ 97, 4273}, + { 98, 4671},{ 99, 5068},{ 99, 5461},{ 98, 5857}, + { 98, 6245},{ 99, 6610},{ 103, 6975},{ 105, 7345}, + { 108, 7712},{ 111, 8073},{ 113, 8415},{ 119, 8768} + } + } + }, + { + { + /*Y' qi=7 INTRA*/ + { + { 92, -70},{ 156, 1590},{ 261, 3267},{ 403, 4618}, + { 529, 5704},{ 628, 6730},{ 736, 7657},{ 856, 8491}, + { 978, 9246},{ 1118, 9943},{ 1281,10550},{ 1472,11028}, + { 1645,11507},{ 1793,12008},{ 1924,12565},{ 2067,13130}, + { 2229,13638},{ 2388,14160},{ 2558,14584},{ 2744,14886}, + { 2932,15194},{ 3116,15531},{ 3311,15858},{ 3538,16197} + }, + /*Y' qi=7 INTER*/ + { + { 43, -8},{ 36, 1351},{ 71, 2923},{ 112, 4568}, + { 138, 6201},{ 157, 7705},{ 171, 9083},{ 181,10390}, + { 189,11664},{ 202,12910},{ 220,14121},{ 241,15281}, + { 266,16401},{ 295,17507},{ 328,18608},{ 371,19677}, + { 430,20701},{ 508,21676},{ 604,22588},{ 727,23397}, + { 878,24093},{ 1055,24690},{ 1263,25151},{ 1496,25504} + } + }, + { + /*Cb qi=7 INTRA*/ + { + { 1, 5},{ 40, 367},{ 72, 740},{ 89, 1175}, + { 108, 1649},{ 129, 2140},{ 143, 2637},{ 154, 3110}, + { 169, 3507},{ 198, 3860},{ 224, 4237},{ 235, 4652}, + { 253, 5037},{ 282, 5358},{ 307, 5674},{ 329, 5986}, + { 361, 6273},{ 393, 6527},{ 419, 6777},{ 435, 7078}, + { 467, 7342},{ 495, 7554},{ 529, 7757},{ 591, 8053} + }, + /*Cb qi=7 INTER*/ + { + { 79, -33},{ 68, 299},{ 56, 627},{ 50, 978}, + { 51, 1366},{ 55, 1786},{ 61, 2213},{ 70, 2642}, + { 80, 3062},{ 87, 3474},{ 92, 3886},{ 96, 4292}, + { 99, 4684},{ 102, 5072},{ 103, 5450},{ 104, 5814}, + { 104, 6176},{ 104, 6538},{ 107, 6905},{ 110, 7270}, + { 110, 7625},{ 110, 7978},{ 111, 8340},{ 117, 8674} + } + }, + { + /*Cr qi=7 INTRA*/ + { + { 2, 7},{ 31, 375},{ 62, 760},{ 87, 1223}, + { 103, 1698},{ 115, 2175},{ 131, 2644},{ 147, 3066}, + { 161, 3494},{ 175, 3889},{ 199, 4250},{ 229, 4653}, + { 250, 5001},{ 279, 5275},{ 311, 5577},{ 343, 5889}, + { 376, 6227},{ 417, 6486},{ 457, 6689},{ 484, 6925}, + { 518, 7174},{ 544, 7393},{ 549, 7662},{ 577, 8050} + }, + /*Cr qi=7 INTER*/ + { + { 89, 22},{ 62, 332},{ 45, 641},{ 47, 976}, + { 52, 1363},{ 59, 1779},{ 67, 2203},{ 76, 2628}, + { 84, 3046},{ 90, 3460},{ 94, 3875},{ 98, 4272}, + { 99, 4666},{ 98, 5063},{ 98, 5459},{ 98, 5849}, + { 99, 6226},{ 101, 6594},{ 104, 6957},{ 109, 7324}, + { 109, 7686},{ 111, 8042},{ 115, 8379},{ 119, 8699} + } + } + }, + { + { + /*Y' qi=8 INTRA*/ + { + { 91, -69},{ 160, 1585},{ 274, 3226},{ 423, 4538}, + { 557, 5596},{ 664, 6595},{ 778, 7506},{ 905, 8319}, + { 1038, 9035},{ 1186, 9701},{ 1355,10292},{ 1554,10754}, + { 1739,11196},{ 1904,11639},{ 2047,12184},{ 2194,12763}, + { 2361,13256},{ 2529,13753},{ 2709,14155},{ 2902,14433}, + { 3100,14723},{ 3292,15026},{ 3489,15327},{ 3714,15705} + }, + /*Y' qi=8 INTER*/ + { + { 32, -157},{ 33, 1346},{ 74, 2914},{ 116, 4554}, + { 142, 6172},{ 162, 7648},{ 177, 9004},{ 186,10300}, + { 196,11570},{ 210,12808},{ 231,14001},{ 256,15150}, + { 285,16259},{ 319,17352},{ 359,18435},{ 415,19475}, + { 489,20470},{ 584,21400},{ 703,22246},{ 852,22968}, + { 1038,23556},{ 1253,24032},{ 1503,24367},{ 1778,24628} + } + }, + { + /*Cb qi=8 INTRA*/ + { + { 1, 4},{ 42, 367},{ 75, 740},{ 93, 1176}, + { 111, 1649},{ 128, 2139},{ 144, 2635},{ 157, 3103}, + { 174, 3494},{ 206, 3844},{ 233, 4207},{ 251, 4605}, + { 277, 4980},{ 304, 5284},{ 335, 5584},{ 359, 5888}, + { 393, 6152},{ 432, 6398},{ 455, 6656},{ 471, 6956}, + { 502, 7193},{ 528, 7405},{ 562, 7630},{ 603, 7922} + }, + /*Cb qi=8 INTER*/ + { + { 77, -37},{ 68, 299},{ 58, 632},{ 50, 991}, + { 50, 1382},{ 55, 1799},{ 62, 2226},{ 73, 2647}, + { 82, 3066},{ 90, 3480},{ 94, 3891},{ 96, 4296}, + { 98, 4687},{ 101, 5073},{ 103, 5456},{ 104, 5817}, + { 105, 6170},{ 106, 6523},{ 107, 6886},{ 108, 7250}, + { 109, 7600},{ 110, 7955},{ 111, 8305},{ 112, 8641} + } + }, + { + /*Cr qi=8 INTRA*/ + { + { 2, 7},{ 33, 375},{ 64, 760},{ 92, 1224}, + { 111, 1700},{ 122, 2173},{ 137, 2637},{ 156, 3055}, + { 172, 3476},{ 186, 3856},{ 211, 4211},{ 242, 4597}, + { 263, 4939},{ 292, 5214},{ 335, 5489},{ 376, 5772}, + { 406, 6099},{ 440, 6378},{ 483, 6578},{ 517, 6797}, + { 550, 7049},{ 571, 7283},{ 583, 7560},{ 618, 7967} + }, + /*Cr qi=8 INTER*/ + { + { 74, 25},{ 58, 328},{ 43, 637},{ 45, 980}, + { 51, 1371},{ 59, 1788},{ 69, 2207},{ 79, 2630}, + { 86, 3051},{ 91, 3470},{ 95, 3880},{ 97, 4280}, + { 98, 4680},{ 97, 5074},{ 96, 5456},{ 97, 5839}, + { 99, 6219},{ 101, 6583},{ 103, 6945},{ 106, 7312}, + { 110, 7671},{ 114, 8009},{ 115, 8345},{ 117, 8686} + } + } + }, + { + { + /*Y' qi=9 INTRA*/ + { + { 104, -68},{ 164, 1580},{ 288, 3173},{ 448, 4439}, + { 587, 5485},{ 702, 6465},{ 824, 7351},{ 958, 8148}, + { 1096, 8845},{ 1253, 9480},{ 1432,10047},{ 1640,10494}, + { 1835,10926},{ 2015,11350},{ 2166,11871},{ 2321,12428}, + { 2508,12876},{ 2684,13345},{ 2866,13741},{ 3069,13991}, + { 3281,14243},{ 3487,14518},{ 3689,14813},{ 3911,15175} + }, + /*Y' qi=9 INTER*/ + { + { 47, -140},{ 34, 1348},{ 77, 2915},{ 119, 4552}, + { 145, 6150},{ 166, 7600},{ 182, 8936},{ 192,10221}, + { 203,11482},{ 220,12711},{ 244,13886},{ 274,15012}, + { 308,16111},{ 349,17190},{ 401,18244},{ 470,19257}, + { 561,20209},{ 680,21069},{ 830,21822},{ 1010,22463}, + { 1227,22971},{ 1482,23328},{ 1769,23544},{ 2077,23655} + } + }, + { + /*Cb qi=9 INTRA*/ + { + { 1, 5},{ 43, 367},{ 76, 740},{ 95, 1176}, + { 114, 1649},{ 135, 2138},{ 153, 2629},{ 165, 3091}, + { 184, 3481},{ 217, 3831},{ 244, 4187},{ 260, 4572}, + { 290, 4930},{ 320, 5231},{ 351, 5521},{ 379, 5812}, + { 414, 6055},{ 452, 6307},{ 483, 6564},{ 502, 6848}, + { 525, 7115},{ 554, 7321},{ 589, 7533},{ 626, 7833} + }, + /*Cb qi=9 INTER*/ + { + { 101, -43},{ 81, 298},{ 62, 637},{ 49, 989}, + { 51, 1381},{ 56, 1806},{ 65, 2231},{ 74, 2653}, + { 84, 3071},{ 91, 3482},{ 95, 3892},{ 97, 4293}, + { 99, 4684},{ 101, 5066},{ 103, 5437},{ 103, 5793}, + { 103, 6148},{ 104, 6511},{ 105, 6867},{ 107, 7221}, + { 110, 7572},{ 111, 7926},{ 112, 8283},{ 116, 8625} + } + }, + { + /*Cr qi=9 INTRA*/ + { + { 2, 7},{ 35, 375},{ 66, 761},{ 93, 1224}, + { 112, 1700},{ 126, 2173},{ 144, 2633},{ 165, 3047}, + { 183, 3458},{ 199, 3835},{ 224, 4191},{ 257, 4558}, + { 283, 4887},{ 309, 5176},{ 351, 5446},{ 397, 5713}, + { 433, 6017},{ 469, 6283},{ 508, 6480},{ 546, 6687}, + { 579, 6945},{ 600, 7182},{ 610, 7434},{ 623, 7793} + }, + /*Cr qi=9 INTER*/ + { + { 77, 15},{ 57, 330},{ 45, 640},{ 48, 980}, + { 54, 1380},{ 61, 1802},{ 70, 2220},{ 80, 2639}, + { 87, 3057},{ 92, 3474},{ 94, 3882},{ 98, 4282}, + { 98, 4675},{ 97, 5062},{ 97, 5450},{ 98, 5829}, + { 100, 6197},{ 101, 6561},{ 104, 6927},{ 107, 7289}, + { 113, 7638},{ 117, 7978},{ 119, 8311},{ 117, 8629} + } + } + }, + { + { + /*Y' qi=10 INTRA*/ + { + { 101, -69},{ 168, 1574},{ 299, 3143},{ 465, 4386}, + { 610, 5410},{ 736, 6353},{ 866, 7207},{ 1006, 7982}, + { 1153, 8655},{ 1319, 9261},{ 1504, 9812},{ 1719,10248}, + { 1928,10653},{ 2116,11056},{ 2282,11550},{ 2458,12070}, + { 2654,12492},{ 2846,12923},{ 3043,13291},{ 3249,13537}, + { 3466,13764},{ 3682,13999},{ 3896,14268},{ 4145,14548} + }, + /*Y' qi=10 INTER*/ + { + { 48, -94},{ 34, 1355},{ 81, 2920},{ 124, 4545}, + { 151, 6113},{ 174, 7532},{ 190, 8850},{ 201,10125}, + { 214,11379},{ 235,12591},{ 264,13745},{ 299,14859}, + { 338,15948},{ 388,17008},{ 456,18029},{ 546,18988}, + { 661,19877},{ 808,20666},{ 993,21321},{ 1218,21835}, + { 1481,22203},{ 1783,22420},{ 2117,22504},{ 2469,22481} + } + }, + { + /*Cb qi=10 INTRA*/ + { + { 2, 4},{ 44, 367},{ 79, 740},{ 99, 1178}, + { 117, 1652},{ 137, 2141},{ 156, 2630},{ 170, 3089}, + { 192, 3474},{ 227, 3813},{ 259, 4157},{ 282, 4526}, + { 310, 4860},{ 342, 5140},{ 377, 5425},{ 400, 5714}, + { 436, 5952},{ 475, 6194},{ 496, 6468},{ 522, 6748}, + { 559, 6996},{ 587, 7216},{ 617, 7433},{ 673, 7678} + }, + /*Cb qi=10 INTER*/ + { + { 87, -37},{ 72, 301},{ 58, 636},{ 49, 995}, + { 51, 1394},{ 57, 1819},{ 66, 2241},{ 78, 2660}, + { 87, 3074},{ 93, 3482},{ 97, 3891},{ 99, 4294}, + { 101, 4678},{ 103, 5050},{ 105, 5414},{ 106, 5773}, + { 107, 6134},{ 108, 6485},{ 110, 6832},{ 113, 7187}, + { 113, 7547},{ 114, 7887},{ 117, 8230},{ 112, 8590} + } + }, + { + /*Cr qi=10 INTRA*/ + { + { 2, 7},{ 38, 375},{ 69, 761},{ 96, 1224}, + { 116, 1701},{ 131, 2175},{ 148, 2634},{ 168, 3041}, + { 190, 3439},{ 211, 3802},{ 238, 4151},{ 271, 4506}, + { 297, 4824},{ 331, 5103},{ 373, 5360},{ 415, 5632}, + { 459, 5928},{ 500, 6176},{ 535, 6386},{ 573, 6586}, + { 608, 6834},{ 629, 7079},{ 642, 7337},{ 686, 7680} + }, + /*Cr qi=10 INTER*/ + { + { 81, 34},{ 63, 333},{ 50, 633},{ 48, 987}, + { 53, 1397},{ 61, 1820},{ 71, 2237},{ 83, 2651}, + { 91, 3065},{ 95, 3479},{ 98, 3882},{ 100, 4279}, + { 101, 4673},{ 101, 5054},{ 100, 5429},{ 101, 5801}, + { 102, 6173},{ 104, 6541},{ 108, 6904},{ 110, 7264}, + { 114, 7609},{ 119, 7945},{ 123, 8275},{ 128, 8615} + } + } + }, + { + { + /*Y' qi=11 INTRA*/ + { + { 110, -66},{ 176, 1564},{ 316, 3087},{ 492, 4296}, + { 645, 5299},{ 781, 6217},{ 924, 7039},{ 1075, 7776}, + { 1232, 8421},{ 1410, 9005},{ 1607, 9532},{ 1834, 9929}, + { 2053,10300},{ 2249,10697},{ 2427,11184},{ 2619,11682}, + { 2826,12083},{ 3019,12508},{ 3225,12869},{ 3452,13064}, + { 3670,13280},{ 3890,13519},{ 4123,13750},{ 4367,14059} + }, + /*Y' qi=11 INTER*/ + { + { 72, -115},{ 32, 1354},{ 83, 2911},{ 126, 4534}, + { 154, 6080},{ 178, 7475},{ 194, 8779},{ 205,10047}, + { 222,11290},{ 246,12488},{ 281,13621},{ 322,14714}, + { 372,15786},{ 436,16821},{ 519,17813},{ 628,18728}, + { 770,19549},{ 950,20254},{ 1175,20800},{ 1443,21197}, + { 1752,21446},{ 2095,21555},{ 2457,21553},{ 2808,21544} + } + }, + { + /*Cb qi=11 INTRA*/ + { + { 2, 4},{ 45, 367},{ 81, 740},{ 101, 1177}, + { 121, 1650},{ 142, 2136},{ 159, 2621},{ 174, 3075}, + { 199, 3451},{ 234, 3778},{ 265, 4117},{ 297, 4473}, + { 333, 4789},{ 367, 5054},{ 402, 5319},{ 427, 5613}, + { 462, 5871},{ 503, 6107},{ 532, 6336},{ 560, 6584}, + { 601, 6842},{ 631, 7092},{ 662, 7292},{ 721, 7497} + }, + /*Cb qi=11 INTER*/ + { + { 117, -24},{ 93, 308},{ 69, 638},{ 52, 993}, + { 52, 1395},{ 58, 1822},{ 68, 2246},{ 80, 2665}, + { 89, 3082},{ 94, 3492},{ 96, 3900},{ 98, 4299}, + { 101, 4679},{ 103, 5047},{ 104, 5405},{ 106, 5763}, + { 106, 6120},{ 107, 6474},{ 109, 6823},{ 112, 7163}, + { 115, 7516},{ 117, 7868},{ 118, 8213},{ 119, 8561} + } + }, + { + /*Cr qi=11 INTRA*/ + { + { 2, 7},{ 40, 375},{ 75, 761},{ 100, 1224}, + { 119, 1700},{ 137, 2169},{ 154, 2622},{ 178, 3025}, + { 198, 3416},{ 220, 3770},{ 255, 4114},{ 294, 4459}, + { 323, 4756},{ 359, 5028},{ 399, 5292},{ 438, 5556}, + { 483, 5827},{ 518, 6073},{ 551, 6298},{ 598, 6501}, + { 634, 6754},{ 652, 6997},{ 670, 7211},{ 689, 7560} + }, + /*Cr qi=11 INTER*/ + { + { 75, 30},{ 61, 334},{ 51, 639},{ 49, 995}, + { 53, 1403},{ 62, 1821},{ 73, 2237},{ 84, 2654}, + { 91, 3070},{ 95, 3485},{ 96, 3890},{ 98, 4287}, + { 98, 4672},{ 99, 5050},{ 99, 5427},{ 100, 5798}, + { 103, 6169},{ 105, 6528},{ 107, 6881},{ 113, 7233}, + { 118, 7580},{ 121, 7916},{ 125, 8240},{ 130, 8551} + } + } + }, + { + { + /*Y' qi=12 INTRA*/ + { + { 104, -69},{ 182, 1557},{ 335, 3040},{ 521, 4205}, + { 684, 5178},{ 831, 6068},{ 986, 6854},{ 1151, 7559}, + { 1323, 8169},{ 1523, 8704},{ 1736, 9192},{ 1978, 9558}, + { 2213, 9908},{ 2421,10298},{ 2613,10757},{ 2822,11208}, + { 3042,11585},{ 3250,11991},{ 3474,12308},{ 3710,12480}, + { 3939,12687},{ 4174,12902},{ 4416,13102},{ 4672,13369} + }, + /*Y' qi=12 INTER*/ + { + { 52, -91},{ 34, 1355},{ 86, 2911},{ 129, 4518}, + { 159, 6037},{ 184, 7405},{ 200, 8694},{ 213, 9955}, + { 232,11185},{ 263,12360},{ 304,13479},{ 354,14555}, + { 415,15601},{ 495,16608},{ 601,17549},{ 738,18400}, + { 915,19136},{ 1139,19724},{ 1414,20150},{ 1731,20412}, + { 2090,20520},{ 2473,20509},{ 2851,20442},{ 3227,20328} + } + }, + { + /*Cb qi=12 INTRA*/ + { + { 1, 4},{ 46, 367},{ 85, 740},{ 109, 1178}, + { 126, 1650},{ 145, 2134},{ 165, 2617},{ 182, 3061}, + { 209, 3428},{ 245, 3749},{ 281, 4077},{ 316, 4417}, + { 354, 4718},{ 392, 4970},{ 430, 5217},{ 456, 5501}, + { 490, 5771},{ 534, 5996},{ 571, 6207},{ 600, 6458}, + { 644, 6697},{ 675, 6942},{ 707, 7151},{ 766, 7342} + }, + /*Cb qi=12 INTER*/ + { + { 84, -24},{ 73, 311},{ 60, 644},{ 52, 998}, + { 53, 1398},{ 60, 1825},{ 71, 2249},{ 83, 2665}, + { 90, 3081},{ 94, 3490},{ 97, 3893},{ 99, 4286}, + { 102, 4663},{ 104, 5032},{ 105, 5393},{ 106, 5751}, + { 107, 6102},{ 108, 6445},{ 111, 6788},{ 113, 7136}, + { 114, 7483},{ 117, 7828},{ 121, 8163},{ 122, 8496} + } + }, + { + /*Cr qi=12 INTRA*/ + { + { 3, 7},{ 41, 375},{ 78, 761},{ 106, 1225}, + { 124, 1700},{ 140, 2167},{ 163, 2616},{ 188, 3010}, + { 213, 3385},{ 240, 3718},{ 271, 4062},{ 309, 4406}, + { 345, 4691},{ 387, 4956},{ 430, 5212},{ 469, 5467}, + { 513, 5729},{ 554, 5970},{ 587, 6176},{ 633, 6395}, + { 673, 6659},{ 692, 6868},{ 712, 7061},{ 758, 7259} + }, + /*Cr qi=12 INTER*/ + { + { 73, 31},{ 59, 335},{ 48, 638},{ 50, 998}, + { 56, 1410},{ 65, 1827},{ 75, 2240},{ 85, 2657}, + { 92, 3073},{ 95, 3485},{ 97, 3888},{ 99, 4279}, + { 98, 4663},{ 99, 5042},{ 101, 5412},{ 102, 5779}, + { 105, 6142},{ 107, 6498},{ 108, 6848},{ 113, 7198}, + { 118, 7540},{ 121, 7867},{ 127, 8188},{ 132, 8508} + } + } + }, + { + { + /*Y' qi=13 INTRA*/ + { + { 109, -68},{ 187, 1551},{ 347, 3010},{ 541, 4153}, + { 709, 5107},{ 864, 5975},{ 1026, 6745},{ 1194, 7433}, + { 1375, 8021},{ 1581, 8550},{ 1803, 9026},{ 2054, 9371}, + { 2301, 9713},{ 2522,10082},{ 2728,10515},{ 2949,10956}, + { 3184,11297},{ 3408,11653},{ 3643,11946},{ 3886,12100}, + { 4124,12277},{ 4377,12459},{ 4632,12635},{ 4898,12861} + }, + /*Y' qi=13 INTER*/ + { + { 48, -78},{ 35, 1357},{ 89, 2914},{ 133, 4512}, + { 164, 6004},{ 190, 7348},{ 207, 8627},{ 222, 9881}, + { 247,11096},{ 284,12251},{ 333,13350},{ 392,14407}, + { 466,15426},{ 565,16391},{ 696,17279},{ 865,18058}, + { 1085,18689},{ 1358,19156},{ 1684,19456},{ 2050,19605}, + { 2447,19614},{ 2855,19524},{ 3243,19398},{ 3611,19201} + } + }, + { + /*Cb qi=13 INTRA*/ + { + { 2, 4},{ 47, 367},{ 86, 741},{ 108, 1179}, + { 127, 1651},{ 150, 2133},{ 173, 2611},{ 194, 3050}, + { 222, 3417},{ 262, 3733},{ 303, 4048},{ 337, 4375}, + { 378, 4657},{ 420, 4897},{ 456, 5148},{ 486, 5422}, + { 518, 5682},{ 558, 5903},{ 592, 6113},{ 623, 6372}, + { 662, 6628},{ 700, 6833},{ 751, 6989},{ 805, 7147} + }, + /*Cb qi=13 INTER*/ + { + { 94, -34},{ 78, 303},{ 60, 638},{ 51, 994}, + { 54, 1406},{ 61, 1836},{ 73, 2253},{ 84, 2668}, + { 92, 3082},{ 96, 3492},{ 99, 3894},{ 101, 4284}, + { 103, 4659},{ 105, 5023},{ 106, 5376},{ 108, 5726}, + { 109, 6070},{ 110, 6418},{ 113, 6765},{ 117, 7105}, + { 119, 7448},{ 122, 7784},{ 126, 8119},{ 131, 8463} + } + }, + { + /*Cr qi=13 INTRA*/ + { + { 3, 7},{ 43, 375},{ 80, 762},{ 110, 1226}, + { 131, 1701},{ 149, 2166},{ 172, 2610},{ 196, 2999}, + { 221, 3359},{ 254, 3679},{ 292, 4005},{ 332, 4329}, + { 369, 4612},{ 408, 4880},{ 456, 5139},{ 500, 5388}, + { 544, 5631},{ 581, 5877},{ 615, 6101},{ 660, 6316}, + { 692, 6594},{ 714, 6795},{ 736, 6997},{ 789, 7290} + }, + /*Cr qi=13 INTER*/ + { + { 73, 28},{ 61, 336},{ 46, 642},{ 50, 1003}, + { 58, 1414},{ 67, 1832},{ 79, 2245},{ 87, 2660}, + { 93, 3075},{ 97, 3484},{ 99, 3888},{ 100, 4277}, + { 100, 4651},{ 100, 5027},{ 101, 5403},{ 102, 5765}, + { 105, 6116},{ 109, 6470},{ 113, 6825},{ 119, 7163}, + { 124, 7497},{ 127, 7827},{ 131, 8137},{ 135, 8437} + } + } + }, + { + { + /*Y' qi=14 INTRA*/ + { + { 113, -68},{ 191, 1545},{ 358, 2981},{ 559, 4104}, + { 733, 5044},{ 896, 5890},{ 1066, 6636},{ 1241, 7304}, + { 1428, 7886},{ 1642, 8402},{ 1872, 8871},{ 2128, 9219}, + { 2380, 9547},{ 2609, 9908},{ 2825,10321},{ 3055,10728}, + { 3294,11076},{ 3523,11425},{ 3766,11689},{ 4013,11845}, + { 4254,12022},{ 4506,12209},{ 4759,12383},{ 5013,12637} + }, + /*Y' qi=14 INTER*/ + { + { 58, -82},{ 38, 1362},{ 93, 2914},{ 138, 4492}, + { 171, 5962},{ 198, 7289},{ 216, 8559},{ 234, 9804}, + { 263,11005},{ 306,12143},{ 363,13222},{ 434,14259}, + { 523,15255},{ 639,16188},{ 794,17021},{ 1000,17717}, + { 1262,18260},{ 1575,18645},{ 1943,18841},{ 2356,18872}, + { 2782,18802},{ 3194,18682},{ 3576,18559},{ 3923,18447} + } + }, + { + /*Cb qi=14 INTRA*/ + { + { 2, 3},{ 50, 367},{ 91, 741},{ 114, 1180}, + { 134, 1651},{ 157, 2131},{ 181, 2601},{ 208, 3028}, + { 239, 3391},{ 279, 3706},{ 322, 4000},{ 361, 4309}, + { 406, 4587},{ 445, 4822},{ 482, 5067},{ 515, 5344}, + { 546, 5612},{ 589, 5821},{ 626, 6020},{ 655, 6276}, + { 701, 6523},{ 748, 6717},{ 796, 6876},{ 815, 7151} + }, + /*Cb qi=14 INTER*/ + { + { 80, -43},{ 68, 301},{ 56, 644},{ 50, 1004}, + { 54, 1412},{ 63, 1836},{ 75, 2253},{ 87, 2670}, + { 94, 3083},{ 98, 3487},{ 101, 3885},{ 103, 4271}, + { 106, 4645},{ 107, 5004},{ 108, 5358},{ 109, 5705}, + { 112, 6047},{ 115, 6388},{ 118, 6731},{ 121, 7081}, + { 126, 7421},{ 129, 7747},{ 132, 8076},{ 137, 8419} + } + }, + { + /*Cr qi=14 INTRA*/ + { + { 3, 6},{ 45, 375},{ 85, 762},{ 116, 1226}, + { 138, 1700},{ 158, 2163},{ 180, 2602},{ 206, 2985}, + { 236, 3333},{ 270, 3639},{ 310, 3956},{ 359, 4258}, + { 397, 4524},{ 430, 4802},{ 478, 5068},{ 527, 5316}, + { 572, 5560},{ 613, 5802},{ 654, 6012},{ 699, 6216}, + { 734, 6489},{ 755, 6707},{ 775, 6898},{ 841, 7111} + }, + /*Cr qi=14 INTER*/ + { + { 78, 0},{ 59, 322},{ 46, 649},{ 51, 1016}, + { 58, 1422},{ 68, 1839},{ 81, 2253},{ 90, 2666}, + { 95, 3080},{ 98, 3486},{ 101, 3881},{ 102, 4268}, + { 102, 4644},{ 103, 5017},{ 105, 5382},{ 106, 5743}, + { 108, 6093},{ 112, 6442},{ 118, 6791},{ 124, 7130}, + { 127, 7463},{ 133, 7784},{ 138, 8085},{ 142, 8395} + } + } + }, + { + { + /*Y' qi=15 INTRA*/ + { + { 111, -66},{ 197, 1538},{ 370, 2949},{ 579, 4050}, + { 762, 4968},{ 933, 5798},{ 1112, 6520},{ 1299, 7161}, + { 1497, 7725},{ 1723, 8219},{ 1967, 8654},{ 2234, 8990}, + { 2499, 9302},{ 2740, 9637},{ 2968,10039},{ 3215,10414}, + { 3473,10709},{ 3721,11015},{ 3971,11270},{ 4228,11402}, + { 4487,11543},{ 4752,11707},{ 5011,11871},{ 5290,12099} + }, + /*Y' qi=15 INTER*/ + { + { 59, -113},{ 37, 1349},{ 95, 2904},{ 139, 4478}, + { 174, 5929},{ 201, 7244},{ 220, 8505},{ 241, 9736}, + { 275,10922},{ 327,12040},{ 395,13097},{ 477,14114}, + { 585,15071},{ 730,15947},{ 917,16714},{ 1162,17326}, + { 1468,17770},{ 1833,18029},{ 2251,18111},{ 2694,18068}, + { 3125,17968},{ 3529,17845},{ 3908,17713},{ 4260,17587} + } + }, + { + /*Cb qi=15 INTRA*/ + { + { 2, 3},{ 51, 367},{ 94, 741},{ 120, 1180}, + { 140, 1651},{ 160, 2129},{ 184, 2591},{ 213, 3010}, + { 246, 3371},{ 289, 3680},{ 335, 3969},{ 374, 4274}, + { 418, 4546},{ 460, 4783},{ 498, 5019},{ 532, 5280}, + { 565, 5553},{ 608, 5765},{ 647, 5958},{ 683, 6193}, + { 732, 6433},{ 782, 6620},{ 832, 6769},{ 848, 7027} + }, + /*Cb qi=15 INTER*/ + { + { 71, -52},{ 63, 296},{ 54, 644},{ 50, 1010}, + { 53, 1417},{ 64, 1837},{ 77, 2253},{ 88, 2666}, + { 95, 3079},{ 98, 3487},{ 100, 3882},{ 103, 4264}, + { 106, 4633},{ 108, 4991},{ 109, 5343},{ 109, 5693}, + { 112, 6038},{ 114, 6371},{ 119, 6709},{ 123, 7051}, + { 125, 7385},{ 130, 7716},{ 135, 8050},{ 140, 8374} + } + }, + { + /*Cr qi=15 INTRA*/ + { + { 2, 6},{ 47, 375},{ 87, 763},{ 119, 1225}, + { 143, 1699},{ 162, 2158},{ 185, 2595},{ 213, 2971}, + { 246, 3315},{ 279, 3618},{ 320, 3920},{ 372, 4210}, + { 409, 4480},{ 446, 4756},{ 496, 5017},{ 542, 5263}, + { 590, 5487},{ 639, 5721},{ 687, 5923},{ 724, 6132}, + { 753, 6417},{ 781, 6622},{ 805, 6806},{ 856, 6977} + }, + /*Cr qi=15 INTER*/ + { + { 71, 3},{ 61, 326},{ 52, 651},{ 50, 1017}, + { 58, 1422},{ 69, 1837},{ 82, 2251},{ 90, 2668}, + { 95, 3080},{ 98, 3484},{ 101, 3877},{ 102, 4257}, + { 102, 4632},{ 101, 5005},{ 103, 5370},{ 106, 5733}, + { 110, 6082},{ 116, 6424},{ 120, 6774},{ 124, 7106}, + { 130, 7427},{ 135, 7748},{ 141, 8052},{ 147, 8333} + } + } + }, + { + { + /*Y' qi=16 INTRA*/ + { + { 114, -63},{ 206, 1525},{ 396, 2887},{ 618, 3945}, + { 816, 4832},{ 1002, 5626},{ 1196, 6319},{ 1401, 6923}, + { 1616, 7458},{ 1857, 7928},{ 2121, 8334},{ 2405, 8645}, + { 2685, 8934},{ 2938, 9255},{ 3175, 9638},{ 3433, 9990}, + { 3707,10263},{ 3958,10577},{ 4218,10807},{ 4488,10906}, + { 4760,11028},{ 5037,11148},{ 5306,11286},{ 5625,11463} + }, + /*Y' qi=16 INTER*/ + { + { 69, -153},{ 39, 1348},{ 98, 2894},{ 144, 4448}, + { 181, 5872},{ 209, 7167},{ 228, 8422},{ 254, 9644}, + { 297,10810},{ 359,11908},{ 438,12944},{ 539,13930}, + { 672,14842},{ 850,15650},{ 1085,16318},{ 1391,16793}, + { 1769,17082},{ 2200,17198},{ 2659,17174},{ 3116,17072}, + { 3547,16948},{ 3943,16819},{ 4299,16701},{ 4611,16644} + } + }, + { + /*Cb qi=16 INTRA*/ + { + { 3, 4},{ 54, 367},{ 97, 742},{ 122, 1181}, + { 143, 1651},{ 168, 2123},{ 197, 2575},{ 226, 2985}, + { 263, 3338},{ 314, 3631},{ 367, 3903},{ 409, 4200}, + { 453, 4468},{ 491, 4703},{ 528, 4932},{ 566, 5188}, + { 601, 5459},{ 647, 5672},{ 693, 5844},{ 734, 6058}, + { 784, 6305},{ 836, 6460},{ 882, 6602},{ 905, 6891} + }, + /*Cb qi=16 INTER*/ + { + { 75, -64},{ 67, 292},{ 56, 645},{ 51, 1016}, + { 54, 1421},{ 66, 1842},{ 79, 2257},{ 89, 2670}, + { 95, 3082},{ 98, 3488},{ 101, 3879},{ 104, 4258}, + { 106, 4623},{ 108, 4974},{ 109, 5321},{ 113, 5664}, + { 116, 6001},{ 117, 6341},{ 123, 6677},{ 128, 7004}, + { 130, 7336},{ 136, 7671},{ 143, 7996},{ 148, 8310} + } + }, + { + /*Cr qi=16 INTRA*/ + { + { 4, 7},{ 50, 375},{ 90, 763},{ 124, 1225}, + { 148, 1698},{ 168, 2154},{ 195, 2582},{ 227, 2948}, + { 263, 3279},{ 302, 3575},{ 343, 3865},{ 394, 4137}, + { 439, 4402},{ 482, 4672},{ 533, 4925},{ 579, 5165}, + { 626, 5382},{ 675, 5616},{ 725, 5812},{ 769, 5991}, + { 810, 6242},{ 848, 6430},{ 868, 6615},{ 944, 6732} + }, + /*Cr qi=16 INTER*/ + { + { 78, 11},{ 62, 327},{ 49, 650},{ 50, 1025}, + { 59, 1431},{ 72, 1841},{ 83, 2253},{ 90, 2671}, + { 95, 3084},{ 98, 3487},{ 100, 3879},{ 101, 4254}, + { 102, 4625},{ 103, 4994},{ 106, 5355},{ 108, 5708}, + { 111, 6058},{ 115, 6400},{ 121, 6733},{ 128, 7058}, + { 134, 7374},{ 140, 7691},{ 146, 7993},{ 146, 8317} + } + } + }, + { + { + /*Y' qi=17 INTRA*/ + { + { 112, -59},{ 210, 1515},{ 409, 2850},{ 640, 3882}, + { 844, 4748},{ 1038, 5529},{ 1240, 6206},{ 1452, 6803}, + { 1676, 7330},{ 1925, 7792},{ 2194, 8201},{ 2483, 8512}, + { 2766, 8801},{ 3027, 9121},{ 3279, 9482},{ 3548, 9810}, + { 3825,10069},{ 4088,10345},{ 4362,10544},{ 4638,10644}, + { 4915,10744},{ 5196,10850},{ 5471,10981},{ 5802,11136} + }, + /*Y' qi=17 INTER*/ + { + { 70, -147},{ 45, 1349},{ 106, 2894},{ 155, 4425}, + { 195, 5818},{ 225, 7099},{ 247, 8348},{ 278, 9565}, + { 328,10717},{ 399,11794},{ 491,12807},{ 609,13760}, + { 766,14623},{ 984,15349},{ 1274,15902},{ 1642,16256}, + { 2082,16411},{ 2563,16409},{ 3048,16315},{ 3508,16194}, + { 3924,16064},{ 4306,15938},{ 4656,15828},{ 4966,15733} + } + }, + { + /*Cb qi=17 INTRA*/ + { + { 3, 4},{ 57, 367},{ 101, 742},{ 126, 1182}, + { 148, 1650},{ 175, 2118},{ 207, 2565},{ 241, 2966}, + { 279, 3307},{ 331, 3588},{ 389, 3845},{ 435, 4132}, + { 474, 4408},{ 517, 4641},{ 560, 4869},{ 602, 5122}, + { 638, 5389},{ 672, 5610},{ 716, 5787},{ 758, 6002}, + { 817, 6226},{ 869, 6393},{ 916, 6530},{ 950, 6799} + }, + /*Cb qi=17 INTER*/ + { + { 105, -65},{ 86, 288},{ 66, 638},{ 54, 1014}, + { 59, 1427},{ 71, 1844},{ 86, 2257},{ 95, 2668}, + { 100, 3075},{ 103, 3476},{ 106, 3867},{ 110, 4241}, + { 112, 4598},{ 114, 4948},{ 117, 5294},{ 121, 5633}, + { 123, 5968},{ 126, 6301},{ 131, 6637},{ 136, 6968}, + { 144, 7287},{ 152, 7606},{ 158, 7931},{ 162, 8262} + } + }, + { + /*Cr qi=17 INTRA*/ + { + { 4, 6},{ 55, 376},{ 97, 765},{ 128, 1226}, + { 152, 1696},{ 175, 2144},{ 204, 2568},{ 241, 2928}, + { 282, 3250},{ 323, 3530},{ 368, 3811},{ 420, 4089}, + { 463, 4347},{ 505, 4609},{ 562, 4860},{ 609, 5094}, + { 655, 5303},{ 709, 5535},{ 759, 5740},{ 803, 5913}, + { 844, 6153},{ 879, 6350},{ 905, 6527},{ 972, 6637} + }, + /*Cr qi=17 INTER*/ + { + { 88, 8},{ 68, 330},{ 51, 653},{ 54, 1028}, + { 65, 1433},{ 77, 1845},{ 89, 2257},{ 96, 2669}, + { 100, 3081},{ 102, 3481},{ 105, 3867},{ 106, 4245}, + { 108, 4613},{ 110, 4971},{ 112, 5328},{ 115, 5679}, + { 120, 6019},{ 127, 6355},{ 133, 6686},{ 140, 7007}, + { 149, 7316},{ 158, 7618},{ 166, 7924},{ 170, 8232} + } + } + }, + { + { + /*Y' qi=18 INTRA*/ + { + { 122, -58},{ 216, 1506},{ 425, 2815},{ 665, 3822}, + { 882, 4666},{ 1088, 5425},{ 1301, 6084},{ 1529, 6653}, + { 1766, 7162},{ 2026, 7611},{ 2312, 7987},{ 2612, 8278}, + { 2913, 8551},{ 3196, 8840},{ 3454, 9184},{ 3734, 9490}, + { 4030, 9725},{ 4305, 9973},{ 4585,10162},{ 4864,10251}, + { 5150,10324},{ 5443,10420},{ 5727,10536},{ 6053,10682} + }, + /*Y' qi=18 INTER*/ + { + { 66, -143},{ 47, 1351},{ 108, 2886},{ 158, 4401}, + { 200, 5775},{ 232, 7044},{ 256, 8288},{ 292, 9493}, + { 351,10625},{ 434,11679},{ 541,12665},{ 681,13578}, + { 875,14379},{ 1136,15025},{ 1483,15475},{ 1914,15709}, + { 2399,15767},{ 2907,15699},{ 3400,15579},{ 3852,15453}, + { 4259,15332},{ 4630,15221},{ 4976,15121},{ 5294,15061} + } + }, + { + /*Cb qi=18 INTRA*/ + { + { 2, 3},{ 61, 367},{ 107, 743},{ 131, 1182}, + { 155, 1648},{ 183, 2110},{ 220, 2542},{ 260, 2927}, + { 303, 3265},{ 359, 3540},{ 416, 3785},{ 462, 4063}, + { 506, 4334},{ 553, 4567},{ 595, 4797},{ 636, 5049}, + { 676, 5304},{ 717, 5516},{ 759, 5698},{ 801, 5904}, + { 861, 6133},{ 911, 6311},{ 962, 6443},{ 1021, 6645} + }, + /*Cb qi=18 INTER*/ + { + { 126, 5},{ 95, 326},{ 66, 643},{ 55, 1015}, + { 60, 1427},{ 73, 1843},{ 87, 2256},{ 96, 2667}, + { 101, 3073},{ 104, 3470},{ 108, 3853},{ 111, 4226}, + { 114, 4584},{ 117, 4928},{ 119, 5274},{ 122, 5612}, + { 126, 5942},{ 130, 6271},{ 136, 6606},{ 141, 6931}, + { 148, 7247},{ 156, 7568},{ 164, 7891},{ 173, 8211} + } + }, + { + /*Cr qi=18 INTRA*/ + { + { 4, 6},{ 59, 376},{ 104, 765},{ 133, 1226}, + { 156, 1692},{ 184, 2136},{ 218, 2548},{ 260, 2893}, + { 308, 3204},{ 348, 3481},{ 397, 3751},{ 448, 4024}, + { 490, 4281},{ 541, 4523},{ 593, 4776},{ 634, 5022}, + { 685, 5236},{ 748, 5455},{ 812, 5638},{ 856, 5818}, + { 891, 6048},{ 928, 6230},{ 961, 6405},{ 1055, 6449} + }, + /*Cr qi=18 INTER*/ + { + { 81, 34},{ 68, 342},{ 57, 652},{ 59, 1027}, + { 67, 1439},{ 80, 1848},{ 91, 2257},{ 97, 2670}, + { 100, 3076},{ 103, 3473},{ 106, 3857},{ 108, 4231}, + { 109, 4599},{ 110, 4958},{ 113, 5307},{ 119, 5650}, + { 125, 5991},{ 130, 6325},{ 138, 6651},{ 147, 6971}, + { 153, 7278},{ 162, 7578},{ 172, 7874},{ 177, 8156} + } + } + }, + { + { + /*Y' qi=19 INTRA*/ + { + { 128, -55},{ 228, 1495},{ 448, 2775},{ 699, 3758}, + { 931, 4571},{ 1154, 5296},{ 1386, 5914},{ 1636, 6450}, + { 1894, 6930},{ 2177, 7342},{ 2479, 7698},{ 2792, 7976}, + { 3099, 8235},{ 3392, 8517},{ 3658, 8853},{ 3938, 9155}, + { 4242, 9371},{ 4527, 9605},{ 4810, 9781},{ 5089, 9853}, + { 5378, 9920},{ 5674,10009},{ 5972,10110},{ 6336,10196} + }, + /*Y' qi=19 INTER*/ + { + { 69, -147},{ 49, 1353},{ 111, 2883},{ 162, 4381}, + { 205, 5737},{ 237, 6996},{ 264, 8232},{ 307, 9421}, + { 376,10534},{ 472,11567},{ 596,12525},{ 761,13395}, + { 990,14130},{ 1298,14694},{ 1695,15053},{ 2172,15195}, + { 2696,15173},{ 3213,15075},{ 3696,14948},{ 4141,14829}, + { 4541,14721},{ 4910,14609},{ 5245,14506},{ 5536,14399} + } + }, + { + /*Cb qi=19 INTRA*/ + { + { 3, 3},{ 61, 367},{ 109, 743},{ 135, 1182}, + { 161, 1646},{ 191, 2101},{ 229, 2524},{ 273, 2898}, + { 318, 3221},{ 376, 3490},{ 436, 3731},{ 487, 3994}, + { 539, 4251},{ 584, 4485},{ 621, 4721},{ 664, 4967}, + { 709, 5225},{ 752, 5431},{ 801, 5595},{ 846, 5796}, + { 912, 6011},{ 959, 6193},{ 1015, 6321},{ 1121, 6504} + }, + /*Cb qi=19 INTER*/ + { + { 126, 4},{ 97, 329},{ 69, 649},{ 56, 1017}, + { 61, 1432},{ 74, 1846},{ 88, 2255},{ 98, 2663}, + { 103, 3065},{ 106, 3460},{ 110, 3844},{ 114, 4211}, + { 117, 4564},{ 120, 4911},{ 122, 5253},{ 125, 5588}, + { 129, 5916},{ 135, 6241},{ 142, 6567},{ 149, 6885}, + { 155, 7206},{ 163, 7527},{ 174, 7843},{ 188, 8145} + } + }, + { + /*Cr qi=19 INTRA*/ + { + { 5, 6},{ 61, 376},{ 106, 765},{ 135, 1225}, + { 160, 1689},{ 192, 2126},{ 229, 2531},{ 271, 2869}, + { 321, 3168},{ 370, 3433},{ 421, 3704},{ 476, 3965}, + { 520, 4212},{ 572, 4452},{ 629, 4691},{ 671, 4939}, + { 724, 5152},{ 792, 5347},{ 858, 5510},{ 895, 5696}, + { 939, 5905},{ 991, 6056},{ 1027, 6244},{ 1127, 6333} + }, + /*Cr qi=19 INTER*/ + { + { 80, 45},{ 66, 344},{ 55, 654},{ 56, 1030}, + { 66, 1440},{ 80, 1850},{ 91, 2259},{ 98, 2668}, + { 102, 3072},{ 104, 3466},{ 107, 3845},{ 109, 4215}, + { 110, 4578},{ 112, 4933},{ 116, 5283},{ 122, 5625}, + { 129, 5963},{ 136, 6287},{ 143, 6611},{ 151, 6927}, + { 160, 7229},{ 170, 7528},{ 181, 7818},{ 191, 8092} + } + } + }, + { + { + /*Y' qi=20 INTRA*/ + { + { 129, -50},{ 238, 1481},{ 469, 2728},{ 730, 3684}, + { 974, 4473},{ 1213, 5171},{ 1463, 5763},{ 1729, 6281}, + { 2002, 6744},{ 2299, 7146},{ 2613, 7492},{ 2940, 7746}, + { 3265, 7978},{ 3571, 8228},{ 3853, 8543},{ 4156, 8815}, + { 4476, 9001},{ 4775, 9218},{ 5070, 9373},{ 5352, 9446}, + { 5649, 9510},{ 5956, 9580},{ 6268, 9660},{ 6647, 9705} + }, + /*Y' qi=20 INTER*/ + { + { 64, -93},{ 52, 1340},{ 116, 2862},{ 170, 4344}, + { 216, 5678},{ 249, 6928},{ 281, 8155},{ 333, 9326}, + { 418,10410},{ 533,11411},{ 683,12329},{ 890,13127}, + { 1183,13750},{ 1579,14162},{ 2066,14357},{ 2611,14370}, + { 3159,14284},{ 3675,14167},{ 4142,14053},{ 4568,13953}, + { 4961,13852},{ 5320,13755},{ 5649,13675},{ 5933,13610} + } + }, + { + /*Cb qi=20 INTRA*/ + { + { 3, 3},{ 62, 367},{ 112, 743},{ 140, 1183}, + { 165, 1646},{ 196, 2099},{ 235, 2517},{ 284, 2883}, + { 334, 3198},{ 393, 3460},{ 457, 3690},{ 509, 3945}, + { 560, 4198},{ 605, 4435},{ 647, 4658},{ 699, 4888}, + { 742, 5155},{ 788, 5350},{ 835, 5517},{ 880, 5730}, + { 956, 5914},{ 1007, 6060},{ 1053, 6199},{ 1158, 6358} + }, + /*Cb qi=20 INTER*/ + { + { 128, -6},{ 96, 322},{ 66, 653},{ 54, 1025}, + { 63, 1431},{ 79, 1844},{ 91, 2256},{ 99, 2665}, + { 104, 3065},{ 107, 3455},{ 111, 3831},{ 115, 4189}, + { 120, 4539},{ 123, 4885},{ 126, 5219},{ 130, 5548}, + { 135, 5876},{ 141, 6199},{ 149, 6519},{ 156, 6837}, + { 166, 7153},{ 179, 7468},{ 189, 7784},{ 194, 8102} + } + }, + { + /*Cr qi=20 INTRA*/ + { + { 4, 6},{ 63, 376},{ 109, 765},{ 139, 1225}, + { 165, 1689},{ 199, 2124},{ 239, 2523},{ 285, 2852}, + { 340, 3140},{ 388, 3398},{ 438, 3662},{ 499, 3914}, + { 547, 4155},{ 596, 4392},{ 652, 4634},{ 699, 4877}, + { 759, 5074},{ 824, 5257},{ 883, 5428},{ 936, 5589}, + { 986, 5790},{ 1030, 5960},{ 1074, 6119},{ 1172, 6191} + }, + /*Cr qi=20 INTER*/ + { + { 92, 40},{ 70, 345},{ 55, 658},{ 57, 1034}, + { 69, 1441},{ 84, 1852},{ 94, 2261},{ 98, 2669}, + { 102, 3074},{ 105, 3465},{ 107, 3841},{ 110, 4206}, + { 112, 4562},{ 116, 4915},{ 121, 5260},{ 127, 5591}, + { 134, 5920},{ 142, 6246},{ 153, 6562},{ 163, 6870}, + { 173, 7170},{ 186, 7463},{ 198, 7746},{ 199, 8030} + } + } + }, + { + { + /*Y' qi=21 INTRA*/ + { + { 130, -51},{ 244, 1476},{ 483, 2705},{ 756, 3635}, + { 1013, 4396},{ 1266, 5070},{ 1530, 5647},{ 1806, 6153}, + { 2093, 6600},{ 2411, 6976},{ 2739, 7299},{ 3079, 7534}, + { 3422, 7744},{ 3738, 7987},{ 4032, 8274},{ 4348, 8533}, + { 4675, 8721},{ 4989, 8909},{ 5291, 9051},{ 5577, 9111}, + { 5879, 9163},{ 6190, 9228},{ 6506, 9286},{ 6899, 9295} + }, + /*Y' qi=21 INTER*/ + { + { 64, -56},{ 55, 1341},{ 119, 2859},{ 174, 4324}, + { 223, 5640},{ 258, 6880},{ 295, 8096},{ 359, 9246}, + { 460,10302},{ 595,11268},{ 778,12131},{ 1032,12857}, + { 1387,13385},{ 1850,13683},{ 2399,13774},{ 2976,13729}, + { 3527,13619},{ 4034,13504},{ 4492,13401},{ 4912,13291}, + { 5298,13209},{ 5648,13137},{ 5974,13046},{ 6308,12977} + } + }, + { + /*Cb qi=21 INTRA*/ + { + { 4, 3},{ 64, 367},{ 114, 743},{ 141, 1183}, + { 166, 1645},{ 201, 2092},{ 247, 2502},{ 299, 2856}, + { 352, 3158},{ 413, 3412},{ 480, 3642},{ 536, 3893}, + { 588, 4137},{ 637, 4367},{ 678, 4598},{ 725, 4834}, + { 774, 5083},{ 827, 5269},{ 883, 5420},{ 930, 5633}, + { 999, 5829},{ 1057, 5959},{ 1113, 6082},{ 1200, 6265} + }, + /*Cb qi=21 INTER*/ + { + { 109, -8},{ 84, 321},{ 62, 654},{ 54, 1028}, + { 64, 1434},{ 80, 1847},{ 92, 2259},{ 100, 2664}, + { 105, 3060},{ 109, 3445},{ 114, 3815},{ 118, 4172}, + { 122, 4519},{ 126, 4861},{ 128, 5194},{ 133, 5520}, + { 139, 5847},{ 146, 6169},{ 155, 6487},{ 166, 6801}, + { 177, 7114},{ 189, 7423},{ 201, 7729},{ 208, 8035} + } + }, + { + /*Cr qi=21 INTRA*/ + { + { 4, 6},{ 64, 377},{ 111, 766},{ 144, 1225}, + { 174, 1683},{ 206, 2114},{ 248, 2506},{ 302, 2824}, + { 357, 3099},{ 404, 3357},{ 455, 3622},{ 519, 3867}, + { 573, 4098},{ 625, 4331},{ 683, 4571},{ 733, 4802}, + { 793, 4994},{ 863, 5173},{ 926, 5337},{ 978, 5492}, + { 1030, 5685},{ 1079, 5856},{ 1126, 6027},{ 1217, 6159} + }, + /*Cr qi=21 INTER*/ + { + { 82, 29},{ 67, 341},{ 55, 660},{ 58, 1038}, + { 71, 1443},{ 85, 1851},{ 95, 2258},{ 99, 2666}, + { 103, 3069},{ 107, 3456},{ 110, 3826},{ 112, 4188}, + { 114, 4544},{ 118, 4891},{ 124, 5231},{ 132, 5567}, + { 139, 5894},{ 148, 6210},{ 159, 6520},{ 171, 6822}, + { 185, 7111},{ 196, 7403},{ 209, 7691},{ 225, 7945} + } + } + }, + { + { + /*Y' qi=22 INTRA*/ + { + { 128, -45},{ 254, 1463},{ 507, 2662},{ 794, 3562}, + { 1070, 4292},{ 1340, 4941},{ 1622, 5492},{ 1920, 5968}, + { 2229, 6387},{ 2565, 6742},{ 2911, 7047},{ 3263, 7264}, + { 3615, 7464},{ 3944, 7689},{ 4258, 7950},{ 4591, 8183}, + { 4934, 8347},{ 5259, 8517},{ 5573, 8634},{ 5870, 8683}, + { 6186, 8723},{ 6508, 8762},{ 6831, 8801},{ 7232, 8830} + }, + /*Y' qi=22 INTER*/ + { + { 77, -48},{ 57, 1343},{ 122, 2853},{ 180, 4299}, + { 231, 5597},{ 269, 6826},{ 314, 8025},{ 393, 9150}, + { 512,10179},{ 673,11103},{ 894,11908},{ 1207,12542}, + { 1635,12956},{ 2166,13148},{ 2755,13167},{ 3345,13088}, + { 3895,12966},{ 4386,12848},{ 4832,12746},{ 5252,12647}, + { 5634,12563},{ 5978,12497},{ 6299,12412},{ 6633,12338} + } + }, + { + /*Cb qi=22 INTRA*/ + { + { 4, 3},{ 66, 367},{ 122, 744},{ 153, 1182}, + { 177, 1640},{ 213, 2080},{ 263, 2475},{ 323, 2811}, + { 382, 3103},{ 451, 3346},{ 522, 3568},{ 581, 3814}, + { 633, 4054},{ 674, 4288},{ 719, 4523},{ 768, 4756}, + { 823, 4979},{ 883, 5162},{ 937, 5325},{ 996, 5510}, + { 1070, 5687},{ 1129, 5807},{ 1193, 5929},{ 1311, 6099} + }, + /*Cb qi=22 INTER*/ + { + { 107, -5},{ 83, 322},{ 61, 653},{ 55, 1030}, + { 66, 1436},{ 81, 1845},{ 94, 2253},{ 102, 2656}, + { 107, 3050},{ 111, 3435},{ 115, 3804},{ 119, 4158}, + { 124, 4501},{ 128, 4835},{ 132, 5164},{ 138, 5490}, + { 146, 5812},{ 154, 6128},{ 163, 6442},{ 174, 6754}, + { 188, 7060},{ 205, 7361},{ 219, 7662},{ 233, 7953} + } + }, + { + /*Cr qi=22 INTRA*/ + { + { 4, 6},{ 67, 378},{ 118, 767},{ 151, 1222}, + { 182, 1675},{ 221, 2097},{ 269, 2476},{ 329, 2774}, + { 389, 3039},{ 444, 3292},{ 500, 3545},{ 560, 3788}, + { 615, 4020},{ 671, 4251},{ 734, 4484},{ 781, 4712}, + { 850, 4887},{ 925, 5060},{ 981, 5229},{ 1031, 5369}, + { 1092, 5549},{ 1148, 5715},{ 1200, 5861},{ 1291, 5943} + }, + /*Cr qi=22 INTER*/ + { + { 88, 34},{ 69, 340},{ 57, 657},{ 60, 1039}, + { 73, 1445},{ 87, 1851},{ 96, 2257},{ 100, 2662}, + { 103, 3058},{ 107, 3442},{ 111, 3812},{ 115, 4172}, + { 118, 4524},{ 123, 4864},{ 129, 5199},{ 136, 5531}, + { 145, 5855},{ 156, 6168},{ 170, 6468},{ 184, 6765}, + { 193, 7066},{ 207, 7353},{ 222, 7628},{ 230, 7900} + } + } + }, + { + { + /*Y' qi=23 INTRA*/ + { + { 126, -40},{ 257, 1458},{ 521, 2636},{ 825, 3501}, + { 1111, 4207},{ 1391, 4842},{ 1684, 5385},{ 1992, 5858}, + { 2311, 6277},{ 2653, 6626},{ 3005, 6929},{ 3366, 7134}, + { 3729, 7311},{ 4071, 7526},{ 4396, 7770},{ 4734, 7986}, + { 5086, 8131},{ 5421, 8286},{ 5735, 8404},{ 6033, 8456}, + { 6357, 8486},{ 6682, 8525},{ 7003, 8573},{ 7387, 8604} + }, + /*Y' qi=23 INTER*/ + { + { 64, -57},{ 60, 1345},{ 124, 2853},{ 185, 4284}, + { 239, 5565},{ 282, 6783},{ 336, 7967},{ 429, 9069}, + { 568,10063},{ 758,10943},{ 1028,11679},{ 1407,12216}, + { 1909,12520},{ 2502,12616},{ 3126,12573},{ 3722,12461}, + { 4258,12344},{ 4742,12236},{ 5185,12136},{ 5590,12052}, + { 5970,11980},{ 6315,11901},{ 6631,11826},{ 6954,11769} + } + }, + { + /*Cb qi=23 INTRA*/ + { + { 3, 3},{ 70, 367},{ 124, 744},{ 151, 1182}, + { 181, 1637},{ 222, 2071},{ 276, 2460},{ 343, 2785}, + { 403, 3072},{ 468, 3317},{ 542, 3534},{ 605, 3773}, + { 659, 4009},{ 703, 4243},{ 747, 4479},{ 795, 4707}, + { 852, 4923},{ 908, 5105},{ 972, 5254},{ 1043, 5423}, + { 1118, 5594},{ 1172, 5731},{ 1240, 5853},{ 1365, 6005} + }, + /*Cb qi=23 INTER*/ + { + { 109, -10},{ 87, 325},{ 63, 650},{ 57, 1031}, + { 67, 1439},{ 83, 1847},{ 96, 2253},{ 103, 2652}, + { 109, 3041},{ 114, 3421},{ 117, 3789},{ 122, 4141}, + { 128, 4480},{ 134, 4811},{ 139, 5138},{ 144, 5463}, + { 152, 5781},{ 161, 6096},{ 174, 6404},{ 185, 6714}, + { 198, 7023},{ 216, 7320},{ 233, 7621},{ 245, 7935} + } + }, + { + /*Cr qi=23 INTRA*/ + { + { 5, 6},{ 70, 379},{ 122, 768},{ 155, 1222}, + { 187, 1671},{ 231, 2088},{ 283, 2459},{ 346, 2750}, + { 411, 3009},{ 465, 3261},{ 523, 3509},{ 585, 3746}, + { 639, 3980},{ 695, 4219},{ 754, 4449},{ 803, 4671}, + { 873, 4840},{ 953, 5001},{ 1015, 5156},{ 1071, 5286}, + { 1137, 5464},{ 1191, 5629},{ 1249, 5782},{ 1359, 5885} + }, + /*Cr qi=23 INTER*/ + { + { 84, 29},{ 69, 343},{ 58, 660},{ 62, 1041}, + { 75, 1448},{ 88, 1853},{ 97, 2258},{ 102, 2659}, + { 105, 3050},{ 108, 3430},{ 113, 3799},{ 116, 4155}, + { 121, 4505},{ 126, 4845},{ 132, 5176},{ 142, 5504}, + { 153, 5826},{ 165, 6133},{ 180, 6432},{ 197, 6722}, + { 212, 7005},{ 226, 7287},{ 244, 7555},{ 258, 7828} + } + } + }, + { + { + /*Y' qi=24 INTRA*/ + { + { 125, -34},{ 268, 1444},{ 547, 2590},{ 866, 3422}, + { 1172, 4098},{ 1476, 4702},{ 1790, 5222},{ 2117, 5678}, + { 2453, 6080},{ 2811, 6418},{ 3178, 6700},{ 3552, 6895}, + { 3928, 7055},{ 4286, 7243},{ 4627, 7477},{ 4981, 7674}, + { 5344, 7802},{ 5683, 7944},{ 6009, 8043},{ 6313, 8082}, + { 6633, 8111},{ 6959, 8151},{ 7280, 8197},{ 7660, 8221} + }, + /*Y' qi=24 INTER*/ + { + { 62, -63},{ 68, 1345},{ 134, 2840},{ 199, 4245}, + { 256, 5508},{ 304, 6715},{ 371, 7880},{ 484, 8950}, + { 652, 9899},{ 892,10709},{ 1238,11334},{ 1722,11722}, + { 2326,11875},{ 2983,11864},{ 3616,11783},{ 4189,11678}, + { 4707,11570},{ 5178,11476},{ 5617,11395},{ 6017,11319}, + { 6380,11252},{ 6720,11185},{ 7044,11126},{ 7377,11118} + } + }, + { + /*Cb qi=24 INTRA*/ + { + { 4, 3},{ 75, 367},{ 132, 745},{ 159, 1182}, + { 187, 1634},{ 230, 2061},{ 289, 2439},{ 361, 2753}, + { 425, 3034},{ 492, 3278},{ 566, 3490},{ 630, 3720}, + { 686, 3956},{ 732, 4190},{ 777, 4420},{ 829, 4637}, + { 894, 4840},{ 958, 5012},{ 1023, 5155},{ 1090, 5326}, + { 1165, 5502},{ 1226, 5622},{ 1299, 5717},{ 1408, 5887} + }, + /*Cb qi=24 INTER*/ + { + { 110, 35},{ 92, 337},{ 70, 651},{ 63, 1033}, + { 74, 1440},{ 91, 1846},{ 102, 2248},{ 109, 2644}, + { 114, 3031},{ 120, 3404},{ 127, 3762},{ 133, 4109}, + { 138, 4445},{ 144, 4772},{ 151, 5094},{ 159, 5411}, + { 168, 5728},{ 180, 6037},{ 195, 6338},{ 210, 6640}, + { 227, 6944},{ 249, 7236},{ 272, 7528},{ 299, 7809} + } + }, + { + /*Cr qi=24 INTRA*/ + { + { 5, 6},{ 72, 380},{ 124, 770},{ 158, 1222}, + { 195, 1668},{ 240, 2079},{ 297, 2438},{ 367, 2715}, + { 433, 2966},{ 488, 3218},{ 549, 3467},{ 609, 3701}, + { 664, 3935},{ 728, 4165},{ 792, 4379},{ 845, 4586}, + { 917, 4744},{ 995, 4898},{ 1063, 5049},{ 1120, 5187}, + { 1190, 5359},{ 1249, 5522},{ 1304, 5672},{ 1397, 5806} + }, + /*Cr qi=24 INTER*/ + { + { 91, 56},{ 73, 353},{ 61, 664},{ 66, 1045}, + { 80, 1449},{ 95, 1851},{ 103, 2250},{ 107, 2648}, + { 111, 3038},{ 116, 3413},{ 120, 3774},{ 124, 4128}, + { 130, 4471},{ 138, 4802},{ 145, 5130},{ 156, 5453}, + { 171, 5764},{ 187, 6061},{ 204, 6355},{ 220, 6643}, + { 238, 6923},{ 254, 7204},{ 275, 7475},{ 289, 7752} + } + } + }, + { + { + /*Y' qi=25 INTRA*/ + { + { 125, -28},{ 285, 1426},{ 582, 2540},{ 917, 3351}, + { 1244, 3997},{ 1569, 4570},{ 1903, 5071},{ 2258, 5498}, + { 2626, 5866},{ 3002, 6182},{ 3382, 6448},{ 3770, 6623}, + { 4162, 6760},{ 4528, 6934},{ 4882, 7144},{ 5249, 7328}, + { 5610, 7453},{ 5958, 7578},{ 6291, 7672},{ 6597, 7708}, + { 6928, 7715},{ 7258, 7737},{ 7575, 7781},{ 7950, 7829} + }, + /*Y' qi=25 INTER*/ + { + { 64, -16},{ 72, 1348},{ 139, 2832},{ 206, 4218}, + { 268, 5465},{ 322, 6659},{ 403, 7803},{ 540, 8838}, + { 747, 9734},{ 1044,10465},{ 1473,10981},{ 2048,11249}, + { 2717,11311},{ 3397,11257},{ 4025,11161},{ 4589,11052}, + { 5099,10947},{ 5560,10859},{ 5989,10786},{ 6389,10717}, + { 6753,10652},{ 7078,10592},{ 7389,10535},{ 7697,10460} + } + }, + { + /*Cb qi=25 INTRA*/ + { + { 3, 3},{ 78, 368},{ 133, 745},{ 159, 1180}, + { 193, 1627},{ 242, 2046},{ 304, 2411},{ 381, 2714}, + { 456, 2983},{ 527, 3224},{ 598, 3437},{ 667, 3655}, + { 726, 3888},{ 776, 4117},{ 826, 4333},{ 883, 4543}, + { 954, 4727},{ 1019, 4878},{ 1095, 5014},{ 1171, 5187}, + { 1255, 5342},{ 1319, 5458},{ 1396, 5546},{ 1536, 5678} + }, + /*Cb qi=25 INTER*/ + { + { 117, 32},{ 89, 342},{ 67, 660},{ 64, 1037}, + { 77, 1441},{ 93, 1845},{ 105, 2243},{ 113, 2633}, + { 120, 3016},{ 125, 3387},{ 131, 3739},{ 137, 4080}, + { 144, 4416},{ 152, 4741},{ 160, 5057},{ 169, 5369}, + { 180, 5680},{ 193, 5990},{ 209, 6294},{ 227, 6594}, + { 249, 6888},{ 269, 7180},{ 294, 7467},{ 317, 7768} + } + }, + { + /*Cr qi=25 INTRA*/ + { + { 6, 6},{ 74, 380},{ 129, 770},{ 165, 1220}, + { 201, 1658},{ 253, 2061},{ 315, 2410},{ 388, 2676}, + { 462, 2920},{ 523, 3166},{ 584, 3404},{ 647, 3637}, + { 701, 3870},{ 769, 4086},{ 838, 4296},{ 898, 4491}, + { 980, 4627},{ 1065, 4759},{ 1126, 4920},{ 1187, 5058}, + { 1283, 5180},{ 1347, 5332},{ 1404, 5475},{ 1527, 5534} + }, + /*Cr qi=25 INTER*/ + { + { 92, 41},{ 75, 347},{ 64, 664},{ 70, 1045}, + { 85, 1448},{ 98, 1849},{ 105, 2245},{ 110, 2637}, + { 115, 3023},{ 120, 3395},{ 126, 3753},{ 131, 4102}, + { 136, 4439},{ 145, 4768},{ 156, 5094},{ 168, 5410}, + { 184, 5717},{ 203, 6010},{ 221, 6300},{ 239, 6577}, + { 262, 6847},{ 282, 7123},{ 303, 7390},{ 322, 7665} + } + } + }, + { + { + /*Y' qi=26 INTRA*/ + { + { 130, -24},{ 292, 1423},{ 594, 2525},{ 943, 3307}, + { 1289, 3921},{ 1633, 4467},{ 1991, 4943},{ 2368, 5348}, + { 2753, 5696},{ 3148, 5991},{ 3545, 6247},{ 3942, 6415}, + { 4342, 6535},{ 4726, 6690},{ 5093, 6883},{ 5466, 7047}, + { 5840, 7159},{ 6202, 7274},{ 6545, 7351},{ 6855, 7375}, + { 7186, 7384},{ 7517, 7416},{ 7840, 7447},{ 8238, 7450} + }, + /*Y' qi=26 INTER*/ + { + { 52, 16},{ 75, 1336},{ 143, 2815},{ 213, 4191}, + { 278, 5427},{ 339, 6611},{ 436, 7734},{ 600, 8732}, + { 843, 9579},{ 1195,10243},{ 1702,10660},{ 2355,10825}, + { 3070,10820},{ 3755,10743},{ 4372,10643},{ 4925,10538}, + { 5426,10440},{ 5882,10354},{ 6296,10290},{ 6686,10224}, + { 7049,10163},{ 7380,10113},{ 7672,10062},{ 7937,10021} + } + }, + { + /*Cb qi=26 INTRA*/ + { + { 4, 3},{ 79, 368},{ 138, 745},{ 167, 1180}, + { 200, 1623},{ 252, 2034},{ 322, 2389},{ 403, 2682}, + { 480, 2941},{ 558, 3176},{ 631, 3393},{ 700, 3608}, + { 766, 3825},{ 819, 4046},{ 868, 4265},{ 926, 4472}, + { 1002, 4645},{ 1070, 4800},{ 1151, 4924},{ 1242, 5063}, + { 1325, 5221},{ 1393, 5338},{ 1464, 5431},{ 1595, 5559} + }, + /*Cb qi=26 INTER*/ + { + { 98, 33},{ 83, 343},{ 65, 662},{ 65, 1037}, + { 80, 1437},{ 96, 1839},{ 107, 2238},{ 115, 2628}, + { 122, 3007},{ 128, 3373},{ 134, 3722},{ 142, 4060}, + { 149, 4390},{ 158, 4713},{ 167, 5029},{ 178, 5341}, + { 191, 5647},{ 208, 5948},{ 227, 6244},{ 247, 6539}, + { 269, 6833},{ 295, 7114},{ 328, 7388},{ 369, 7658} + } + }, + { + /*Cr qi=26 INTRA*/ + { + { 5, 6},{ 75, 380},{ 133, 769},{ 172, 1217}, + { 212, 1652},{ 266, 2048},{ 333, 2384},{ 412, 2643}, + { 490, 2880},{ 552, 3124},{ 616, 3365},{ 681, 3594}, + { 739, 3816},{ 810, 4024},{ 880, 4224},{ 945, 4405}, + { 1029, 4538},{ 1114, 4674},{ 1183, 4822},{ 1254, 4946}, + { 1346, 5063},{ 1417, 5201},{ 1478, 5345},{ 1597, 5411} + }, + /*Cr qi=26 INTER*/ + { + { 97, 29},{ 75, 342},{ 62, 667},{ 70, 1047}, + { 87, 1447},{ 100, 1846},{ 107, 2242},{ 113, 2633}, + { 118, 3016},{ 123, 3382},{ 128, 3737},{ 135, 4082}, + { 142, 4417},{ 151, 4746},{ 162, 5066},{ 176, 5377}, + { 194, 5679},{ 217, 5963},{ 239, 6244},{ 260, 6522}, + { 284, 6789},{ 309, 7052},{ 335, 7313},{ 355, 7582} + } + } + }, + { + { + /*Y' qi=27 INTRA*/ + { + { 118, -10},{ 308, 1404},{ 630, 2473},{ 997, 3227}, + { 1360, 3819},{ 1719, 4354},{ 2086, 4829},{ 2470, 5233}, + { 2863, 5576},{ 3267, 5870},{ 3677, 6117},{ 4085, 6268}, + { 4499, 6376},{ 4888, 6521},{ 5257, 6705},{ 5638, 6865}, + { 6020, 6962},{ 6394, 7056},{ 6744, 7130},{ 7051, 7158}, + { 7386, 7164},{ 7717, 7185},{ 8042, 7209},{ 8444, 7206} + }, + /*Y' qi=27 INTER*/ + { + { 54, 19},{ 77, 1333},{ 147, 2806},{ 221, 4166}, + { 290, 5390},{ 360, 6564},{ 474, 7665},{ 664, 8630}, + { 949, 9423},{ 1370,10002},{ 1958,10323},{ 2670,10414}, + { 3406,10375},{ 4086,10285},{ 4691,10182},{ 5233,10085}, + { 5724, 9994},{ 6169, 9918},{ 6582, 9863},{ 6962, 9813}, + { 7316, 9759},{ 7645, 9707},{ 7948, 9660},{ 8262, 9623} + } + }, + { + /*Cb qi=27 INTRA*/ + { + { 4, 3},{ 79, 368},{ 137, 745},{ 166, 1180}, + { 200, 1622},{ 253, 2030},{ 324, 2381},{ 407, 2671}, + { 487, 2925},{ 567, 3156},{ 640, 3372},{ 712, 3580}, + { 782, 3792},{ 833, 4015},{ 887, 4227},{ 954, 4422}, + { 1031, 4592},{ 1103, 4738},{ 1187, 4856},{ 1280, 4990}, + { 1371, 5135},{ 1442, 5244},{ 1520, 5321},{ 1684, 5398} + }, + /*Cb qi=27 INTER*/ + { + { 113, 20},{ 90, 338},{ 66, 661},{ 67, 1034}, + { 82, 1438},{ 97, 1842},{ 108, 2238},{ 115, 2624}, + { 123, 3000},{ 130, 3361},{ 138, 3708},{ 146, 4040}, + { 155, 4367},{ 164, 4688},{ 174, 4999},{ 186, 5306}, + { 203, 5609},{ 222, 5908},{ 243, 6202},{ 268, 6494}, + { 295, 6781},{ 326, 7058},{ 367, 7319},{ 420, 7551} + } + }, + { + /*Cr qi=27 INTRA*/ + { + { 5, 6},{ 75, 380},{ 133, 770},{ 173, 1217}, + { 214, 1650},{ 268, 2040},{ 337, 2375},{ 418, 2631}, + { 496, 2862},{ 558, 3104},{ 625, 3346},{ 692, 3571}, + { 753, 3786},{ 825, 3989},{ 896, 4182},{ 969, 4352}, + { 1059, 4479},{ 1144, 4614},{ 1212, 4757},{ 1284, 4871}, + { 1380, 4982},{ 1457, 5125},{ 1528, 5267},{ 1651, 5346} + }, + /*Cr qi=27 INTER*/ + { + { 92, 24},{ 74, 341},{ 61, 669},{ 71, 1049}, + { 88, 1448},{ 100, 1849},{ 107, 2243},{ 113, 2631}, + { 119, 3010},{ 125, 3373},{ 131, 3723},{ 137, 4064}, + { 146, 4396},{ 159, 4720},{ 172, 5033},{ 189, 5340}, + { 210, 5636},{ 233, 5920},{ 256, 6197},{ 282, 6465}, + { 310, 6730},{ 332, 7000},{ 359, 7259},{ 385, 7515} + } + } + }, + { + { + /*Y' qi=28 INTRA*/ + { + { 116, -8},{ 314, 1400},{ 640, 2458},{ 1013, 3197}, + { 1386, 3768},{ 1762, 4279},{ 2151, 4733},{ 2558, 5117}, + { 2970, 5442},{ 3393, 5714},{ 3820, 5935},{ 4243, 6069}, + { 4671, 6161},{ 5074, 6289},{ 5456, 6457},{ 5849, 6598}, + { 6244, 6689},{ 6632, 6777},{ 6984, 6833},{ 7294, 6855}, + { 7625, 6862},{ 7961, 6875},{ 8302, 6890},{ 8720, 6883} + }, + /*Y' qi=28 INTER*/ + { + { 54, 8},{ 81, 1333},{ 154, 2793},{ 231, 4138}, + { 304, 5352},{ 384, 6512},{ 519, 7585},{ 743, 8508}, + { 1082, 9236},{ 1587, 9717},{ 2267, 9928},{ 3034, 9944}, + { 3775, 9878},{ 4438, 9786},{ 5031, 9686},{ 5563, 9601}, + { 6042, 9523},{ 6481, 9456},{ 6890, 9405},{ 7266, 9356}, + { 7614, 9313},{ 7933, 9265},{ 8238, 9220},{ 8545, 9193} + } + }, + { + /*Cb qi=28 INTRA*/ + { + { 3, 3},{ 80, 368},{ 138, 746},{ 168, 1179}, + { 208, 1615},{ 268, 2014},{ 345, 2354},{ 432, 2637}, + { 515, 2884},{ 595, 3108},{ 669, 3323},{ 745, 3533}, + { 818, 3740},{ 876, 3953},{ 932, 4160},{ 1003, 4349}, + { 1088, 4501},{ 1154, 4648},{ 1241, 4768},{ 1349, 4889}, + { 1441, 5023},{ 1524, 5113},{ 1611, 5187},{ 1783, 5283} + }, + /*Cb qi=28 INTER*/ + { + { 117, 29},{ 91, 341},{ 65, 663},{ 68, 1038}, + { 85, 1440},{ 100, 1841},{ 110, 2234},{ 119, 2616}, + { 127, 2985},{ 135, 3342},{ 142, 3685},{ 151, 4015}, + { 162, 4337},{ 174, 4652},{ 186, 4960},{ 201, 5264}, + { 218, 5567},{ 239, 5863},{ 266, 6149},{ 295, 6434}, + { 328, 6715},{ 371, 6976},{ 409, 7239},{ 460, 7477} + } + }, + { + /*Cr qi=28 INTRA*/ + { + { 6, 7},{ 79, 381},{ 138, 771},{ 178, 1215}, + { 222, 1644},{ 285, 2026},{ 359, 2347},{ 441, 2597}, + { 521, 2827},{ 588, 3066},{ 655, 3303},{ 725, 3523}, + { 791, 3728},{ 870, 3920},{ 950, 4103},{ 1030, 4265}, + { 1121, 4388},{ 1198, 4520},{ 1266, 4659},{ 1356, 4759}, + { 1461, 4865},{ 1540, 4993},{ 1619, 5115},{ 1786, 5160} + }, + /*Cr qi=28 INTER*/ + { + { 96, 18},{ 78, 340},{ 66, 672},{ 74, 1051}, + { 90, 1450},{ 103, 1845},{ 110, 2235},{ 116, 2619}, + { 122, 2995},{ 129, 3356},{ 137, 3702},{ 146, 4038}, + { 156, 4365},{ 168, 4684},{ 182, 4995},{ 203, 5297}, + { 227, 5588},{ 253, 5866},{ 282, 6131},{ 311, 6394}, + { 339, 6664},{ 366, 6918},{ 400, 7171},{ 424, 7450} + } + } + }, + { + { + /*Y' qi=29 INTRA*/ + { + { 112, 7},{ 334, 1382},{ 681, 2410},{ 1081, 3112}, + { 1484, 3650},{ 1894, 4128},{ 2316, 4547},{ 2749, 4905}, + { 3188, 5208},{ 3634, 5458},{ 4079, 5666},{ 4517, 5791}, + { 4952, 5870},{ 5359, 5983},{ 5754, 6137},{ 6165, 6268}, + { 6568, 6351},{ 6958, 6423},{ 7320, 6471},{ 7638, 6490}, + { 7979, 6490},{ 8313, 6499},{ 8651, 6517},{ 9085, 6499} + }, + /*Y' qi=29 INTER*/ + { + { 55, 15},{ 85, 1336},{ 160, 2780},{ 242, 4104}, + { 323, 5302},{ 418, 6443},{ 586, 7480},{ 859, 8342}, + { 1278, 8982},{ 1888, 9347},{ 2658, 9457},{ 3457, 9425}, + { 4192, 9343},{ 4842, 9247},{ 5417, 9162},{ 5935, 9086}, + { 6404, 9011},{ 6841, 8952},{ 7241, 8907},{ 7609, 8867}, + { 7953, 8832},{ 8267, 8792},{ 8562, 8740},{ 8836, 8701} + } + }, + { + /*Cb qi=29 INTRA*/ + { + { 5, 3},{ 84, 368},{ 144, 746},{ 176, 1175}, + { 219, 1604},{ 285, 1991},{ 372, 2318},{ 462, 2591}, + { 546, 2833},{ 628, 3058},{ 704, 3274},{ 788, 3473}, + { 870, 3664},{ 935, 3865},{ 995, 4059},{ 1072, 4239}, + { 1167, 4388},{ 1248, 4518},{ 1334, 4634},{ 1429, 4765}, + { 1536, 4884},{ 1628, 4964},{ 1716, 5038},{ 1885, 5128} + }, + /*Cb qi=29 INTER*/ + { + { 126, 25},{ 95, 340},{ 69, 662},{ 71, 1039}, + { 88, 1440},{ 102, 1839},{ 113, 2227},{ 122, 2604}, + { 132, 2969},{ 141, 3320},{ 151, 3659},{ 161, 3985}, + { 172, 4301},{ 186, 4612},{ 200, 4917},{ 219, 5213}, + { 241, 5509},{ 265, 5800},{ 296, 6081},{ 329, 6360}, + { 369, 6633},{ 414, 6899},{ 465, 7148},{ 520, 7387} + } + }, + { + /*Cr qi=29 INTRA*/ + { + { 6, 7},{ 82, 382},{ 142, 772},{ 185, 1211}, + { 233, 1632},{ 303, 2000},{ 388, 2306},{ 475, 2550}, + { 556, 2779},{ 627, 3007},{ 707, 3237},{ 778, 3459}, + { 843, 3654},{ 927, 3834},{ 1012, 4012},{ 1101, 4152}, + { 1197, 4262},{ 1275, 4399},{ 1359, 4511},{ 1455, 4596}, + { 1562, 4708},{ 1644, 4833},{ 1719, 4954},{ 1888, 4988} + }, + /*Cr qi=29 INTER*/ + { + { 101, 28},{ 81, 343},{ 67, 673},{ 75, 1053}, + { 93, 1450},{ 106, 1844},{ 113, 2230},{ 119, 2610}, + { 127, 2980},{ 135, 3334},{ 143, 3676},{ 153, 4007}, + { 165, 4330},{ 180, 4645},{ 201, 4951},{ 224, 5243}, + { 253, 5522},{ 284, 5794},{ 314, 6060},{ 345, 6322}, + { 381, 6578},{ 419, 6828},{ 455, 7073},{ 495, 7316} + } + } + }, + { + { + /*Y' qi=30 INTRA*/ + { + { 112, 8},{ 335, 1380},{ 682, 2401},{ 1083, 3093}, + { 1489, 3619},{ 1902, 4092},{ 2332, 4511},{ 2777, 4865}, + { 3231, 5156},{ 3693, 5394},{ 4153, 5585},{ 4605, 5689}, + { 5049, 5764},{ 5468, 5871},{ 5875, 6004},{ 6295, 6120}, + { 6706, 6201},{ 7099, 6273},{ 7461, 6311},{ 7785, 6320}, + { 8128, 6322},{ 8469, 6331},{ 8806, 6342},{ 9220, 6338} + }, + /*Y' qi=30 INTER*/ + { + { 58, 8},{ 90, 1340},{ 169, 2771},{ 257, 4079}, + { 345, 5266},{ 459, 6387},{ 660, 7383},{ 990, 8180}, + { 1496, 8726},{ 2203, 8992},{ 3029, 9038},{ 3833, 8984}, + { 4549, 8900},{ 5183, 8813},{ 5745, 8735},{ 6250, 8674}, + { 6715, 8619},{ 7138, 8565},{ 7529, 8528},{ 7899, 8495}, + { 8234, 8465},{ 8550, 8429},{ 8856, 8395},{ 9160, 8374} + } + }, + { + /*Cb qi=30 INTRA*/ + { + { 7, 3},{ 88, 369},{ 149, 747},{ 185, 1175}, + { 232, 1599},{ 304, 1976},{ 392, 2293},{ 486, 2557}, + { 573, 2797},{ 656, 3027},{ 735, 3243},{ 819, 3442}, + { 903, 3629},{ 966, 3828},{ 1025, 4027},{ 1105, 4204}, + { 1201, 4343},{ 1282, 4469},{ 1379, 4575},{ 1486, 4689}, + { 1588, 4813},{ 1678, 4900},{ 1767, 4969},{ 1911, 5080} + }, + /*Cb qi=30 INTER*/ + { + { 120, 23},{ 96, 336},{ 72, 661},{ 75, 1043}, + { 91, 1441},{ 105, 1837},{ 117, 2221},{ 127, 2592}, + { 137, 2953},{ 148, 3301},{ 159, 3635},{ 170, 3959}, + { 184, 4271},{ 199, 4578},{ 216, 4879},{ 238, 5175}, + { 262, 5466},{ 294, 5750},{ 332, 6027},{ 373, 6298}, + { 421, 6559},{ 473, 6805},{ 526, 7053},{ 587, 7298} + } + }, + { + /*Cr qi=30 INTRA*/ + { + { 10, 7},{ 89, 384},{ 147, 773},{ 192, 1211}, + { 245, 1627},{ 322, 1984},{ 412, 2280},{ 501, 2520}, + { 583, 2750},{ 654, 2982},{ 736, 3207},{ 810, 3419}, + { 873, 3614},{ 957, 3794},{ 1048, 3965},{ 1139, 4102}, + { 1237, 4208},{ 1327, 4328},{ 1408, 4448},{ 1496, 4545}, + { 1604, 4652},{ 1699, 4760},{ 1780, 4877},{ 1937, 4942} + }, + /*Cr qi=30 INTER*/ + { + { 115, 26},{ 89, 342},{ 70, 672},{ 79, 1055}, + { 96, 1451},{ 108, 1841},{ 116, 2222},{ 124, 2599}, + { 132, 2965},{ 141, 3316},{ 151, 3655},{ 163, 3984}, + { 178, 4301},{ 197, 4609},{ 219, 4909},{ 247, 5195}, + { 280, 5469},{ 317, 5734},{ 351, 5991},{ 383, 6248}, + { 423, 6500},{ 467, 6744},{ 502, 6995},{ 558, 7226} + } + } + }, + { + { + /*Y' qi=31 INTRA*/ + { + { 116, 20},{ 359, 1361},{ 732, 2350},{ 1162, 3010}, + { 1597, 3507},{ 2042, 3950},{ 2503, 4339},{ 2974, 4670}, + { 3446, 4951},{ 3922, 5179},{ 4394, 5357},{ 4858, 5454}, + { 5313, 5519},{ 5734, 5626},{ 6154, 5755},{ 6585, 5859}, + { 7004, 5928},{ 7408, 5998},{ 7775, 6039},{ 8102, 6048}, + { 8442, 6051},{ 8790, 6054},{ 9136, 6057},{ 9554, 6041} + }, + /*Y' qi=31 INTER*/ + { + { 53, 12},{ 90, 1340},{ 169, 2765},{ 259, 4062}, + { 353, 5236},{ 483, 6340},{ 713, 7305},{ 1086, 8059}, + { 1651, 8548},{ 2423, 8751},{ 3288, 8754},{ 4106, 8674}, + { 4827, 8572},{ 5451, 8482},{ 6007, 8407},{ 6514, 8344}, + { 6970, 8282},{ 7397, 8225},{ 7795, 8193},{ 8159, 8161}, + { 8498, 8120},{ 8814, 8093},{ 9127, 8066},{ 9432, 8040} + } + }, + { + /*Cb qi=31 INTRA*/ + { + { 7, 3},{ 88, 369},{ 149, 746},{ 185, 1173}, + { 234, 1595},{ 308, 1967},{ 399, 2278},{ 494, 2537}, + { 583, 2774},{ 669, 2997},{ 755, 3204},{ 847, 3390}, + { 936, 3569},{ 1008, 3759},{ 1078, 3942},{ 1162, 4104}, + { 1262, 4238},{ 1352, 4364},{ 1442, 4470},{ 1557, 4567}, + { 1676, 4674},{ 1759, 4781},{ 1850, 4853},{ 2043, 4897} + }, + /*Cb qi=31 INTER*/ + { + { 121, 23},{ 96, 335},{ 72, 660},{ 74, 1043}, + { 90, 1440},{ 105, 1834},{ 116, 2217},{ 127, 2586}, + { 138, 2945},{ 148, 3293},{ 159, 3626},{ 172, 3945}, + { 185, 4256},{ 202, 4559},{ 223, 4856},{ 245, 5150}, + { 272, 5440},{ 306, 5719},{ 346, 5989},{ 391, 6253}, + { 443, 6511},{ 510, 6743},{ 583, 6965},{ 651, 7182} + } + }, + { + /*Cr qi=31 INTRA*/ + { + { 10, 7},{ 88, 384},{ 147, 773},{ 192, 1209}, + { 247, 1622},{ 326, 1974},{ 417, 2262},{ 509, 2500}, + { 596, 2726},{ 670, 2949},{ 754, 3170},{ 836, 3370}, + { 912, 3548},{ 999, 3724},{ 1093, 3888},{ 1198, 4000}, + { 1304, 4095},{ 1384, 4230},{ 1470, 4347},{ 1577, 4422}, + { 1696, 4513},{ 1798, 4620},{ 1869, 4746},{ 1991, 4798} + }, + /*Cr qi=31 INTER*/ + { + { 113, 32},{ 88, 345},{ 69, 674},{ 79, 1055}, + { 96, 1451},{ 108, 1839},{ 115, 2218},{ 123, 2592}, + { 132, 2957},{ 141, 3308},{ 151, 3643},{ 163, 3968}, + { 179, 4285},{ 200, 4590},{ 225, 4886},{ 254, 5169}, + { 291, 5436},{ 330, 5696},{ 368, 5951},{ 409, 6200}, + { 452, 6448},{ 493, 6695},{ 536, 6940},{ 571, 7204} + } + } + }, + { + { + /*Y' qi=32 INTRA*/ + { + { 123, 26},{ 370, 1356},{ 756, 2321},{ 1211, 2944}, + { 1674, 3408},{ 2148, 3826},{ 2639, 4193},{ 3138, 4504}, + { 3634, 4765},{ 4133, 4973},{ 4625, 5137},{ 5101, 5225}, + { 5567, 5274},{ 6002, 5363},{ 6437, 5482},{ 6885, 5566}, + { 7312, 5625},{ 7723, 5686},{ 8101, 5721},{ 8429, 5732}, + { 8769, 5728},{ 9120, 5726},{ 9472, 5723},{ 9918, 5700} + }, + /*Y' qi=32 INTER*/ + { + { 54, -3},{ 95, 1343},{ 179, 2750},{ 276, 4027}, + { 382, 5185},{ 543, 6256},{ 830, 7161},{ 1301, 7815}, + { 2003, 8172},{ 2883, 8266},{ 3779, 8217},{ 4578, 8127}, + { 5274, 8035},{ 5886, 7952},{ 6430, 7887},{ 6929, 7835}, + { 7380, 7779},{ 7796, 7737},{ 8190, 7705},{ 8552, 7672}, + { 8896, 7640},{ 9210, 7612},{ 9510, 7589},{ 9746, 7552} + } + }, + { + /*Cb qi=32 INTRA*/ + { + { 6, 3},{ 89, 369},{ 153, 746},{ 193, 1167}, + { 247, 1577},{ 330, 1935},{ 429, 2236},{ 528, 2494}, + { 620, 2732},{ 712, 2948},{ 801, 3146},{ 898, 3325}, + { 999, 3489},{ 1078, 3664},{ 1155, 3832},{ 1251, 3985}, + { 1360, 4115},{ 1451, 4236},{ 1549, 4338},{ 1667, 4433}, + { 1797, 4522},{ 1891, 4613},{ 1989, 4687},{ 2162, 4776} + }, + /*Cb qi=32 INTER*/ + { + { 116, -1},{ 98, 321},{ 80, 656},{ 80, 1042}, + { 96, 1438},{ 110, 1827},{ 122, 2205},{ 133, 2570}, + { 144, 2925},{ 157, 3268},{ 170, 3597},{ 185, 3911}, + { 202, 4216},{ 221, 4516},{ 244, 4809},{ 273, 5096}, + { 308, 5376},{ 350, 5644},{ 401, 5907},{ 459, 6160}, + { 520, 6401},{ 592, 6630},{ 676, 6837},{ 758, 7050} + } + }, + { + /*Cr qi=32 INTRA*/ + { + { 12, 7},{ 91, 386},{ 152, 773},{ 201, 1202}, + { 261, 1603},{ 347, 1942},{ 447, 2223},{ 540, 2460}, + { 626, 2684},{ 711, 2901},{ 801, 3115},{ 887, 3312}, + { 969, 3480},{ 1068, 3633},{ 1176, 3779},{ 1283, 3885}, + { 1392, 3969},{ 1485, 4090},{ 1573, 4206},{ 1686, 4274}, + { 1813, 4354},{ 1911, 4459},{ 2004, 4563},{ 2162, 4590} + }, + /*Cr qi=32 INTER*/ + { + { 129, 5},{ 98, 334},{ 75, 673},{ 84, 1055}, + { 101, 1448},{ 113, 1832},{ 121, 2206},{ 129, 2577}, + { 140, 2937},{ 151, 3282},{ 163, 3614},{ 179, 3932}, + { 198, 4240},{ 221, 4542},{ 252, 4830},{ 290, 5102}, + { 329, 5364},{ 373, 5618},{ 420, 5864},{ 468, 6105}, + { 513, 6351},{ 564, 6587},{ 624, 6810},{ 697, 7017} + } + } + }, + { + { + /*Y' qi=33 INTRA*/ + { + { 115, 36},{ 388, 1338},{ 791, 2289},{ 1258, 2899}, + { 1732, 3352},{ 2220, 3760},{ 2730, 4117},{ 3244, 4415}, + { 3751, 4662},{ 4261, 4858},{ 4766, 5012},{ 5249, 5094}, + { 5719, 5141},{ 6159, 5225},{ 6597, 5333},{ 7044, 5416}, + { 7474, 5472},{ 7893, 5531},{ 8268, 5570},{ 8591, 5580}, + { 8931, 5578},{ 9283, 5579},{ 9634, 5582},{10067, 5560} + }, + /*Y' qi=33 INTER*/ + { + { 65, -14},{ 102, 1345},{ 190, 2736},{ 294, 3999}, + { 411, 5146},{ 597, 6192},{ 934, 7045},{ 1488, 7622}, + { 2281, 7895},{ 3213, 7937},{ 4108, 7871},{ 4883, 7784}, + { 5556, 7709},{ 6150, 7643},{ 6685, 7585},{ 7176, 7539}, + { 7620, 7502},{ 8034, 7466},{ 8427, 7435},{ 8793, 7409}, + { 9136, 7386},{ 9446, 7364},{ 9743, 7339},{10025, 7303} + } + }, + { + /*Cb qi=33 INTRA*/ + { + { 5, 3},{ 92, 369},{ 159, 746},{ 203, 1163}, + { 263, 1564},{ 353, 1911},{ 458, 2204},{ 557, 2460}, + { 650, 2697},{ 744, 2913},{ 836, 3110},{ 934, 3292}, + { 1036, 3454},{ 1125, 3616},{ 1204, 3781},{ 1298, 3932}, + { 1410, 4058},{ 1507, 4170},{ 1606, 4265},{ 1725, 4358}, + { 1853, 4445},{ 1955, 4535},{ 2067, 4597},{ 2258, 4663} + }, + /*Cb qi=33 INTER*/ + { + { 109, 37},{ 94, 343},{ 81, 662},{ 85, 1042}, + { 102, 1436},{ 116, 1823},{ 128, 2195},{ 141, 2554}, + { 154, 2906},{ 167, 3246},{ 183, 3570},{ 202, 3881}, + { 220, 4185},{ 241, 4482},{ 268, 4772},{ 302, 5053}, + { 341, 5328},{ 388, 5592},{ 446, 5846},{ 507, 6096}, + { 581, 6328},{ 670, 6534},{ 762, 6731},{ 842, 6922} + } + }, + { + /*Cr qi=33 INTRA*/ + { + { 11, 7},{ 93, 387},{ 158, 774},{ 211, 1197}, + { 278, 1589},{ 372, 1917},{ 475, 2191},{ 569, 2429}, + { 658, 2655},{ 744, 2868},{ 835, 3083},{ 926, 3271}, + { 1010, 3430},{ 1110, 3586},{ 1224, 3724},{ 1336, 3826}, + { 1449, 3908},{ 1547, 4021},{ 1636, 4136},{ 1751, 4200}, + { 1886, 4277},{ 1977, 4384},{ 2070, 4474},{ 2232, 4510} + }, + /*Cr qi=33 INTER*/ + { + { 77, 9},{ 90, 347},{ 80, 674},{ 91, 1053}, + { 107, 1444},{ 119, 1825},{ 127, 2196},{ 137, 2563}, + { 149, 2919},{ 161, 3259},{ 176, 3588},{ 194, 3905}, + { 217, 4209},{ 246, 4504},{ 280, 4786},{ 320, 5055}, + { 364, 5316},{ 409, 5565},{ 460, 5804},{ 517, 6039}, + { 578, 6264},{ 640, 6489},{ 701, 6721},{ 772, 6948} + } + } + }, + { + { + /*Y' qi=34 INTRA*/ + { + { 124, 40},{ 401, 1333},{ 823, 2262},{ 1318, 2842}, + { 1823, 3265},{ 2339, 3650},{ 2872, 3991},{ 3405, 4274}, + { 3926, 4513},{ 4448, 4704},{ 4961, 4845},{ 5450, 4921}, + { 5925, 4971},{ 6372, 5053},{ 6813, 5160},{ 7264, 5242}, + { 7704, 5291},{ 8124, 5346},{ 8500, 5382},{ 8831, 5384}, + { 9178, 5380},{ 9525, 5387},{ 9869, 5389},{10310, 5356} + }, + /*Y' qi=34 INTER*/ + { + { 64, -17},{ 101, 1344},{ 190, 2730},{ 299, 3981}, + { 430, 5110},{ 648, 6127},{ 1036, 6933},{ 1664, 7445}, + { 2535, 7652},{ 3504, 7653},{ 4402, 7572},{ 5173, 7479}, + { 5843, 7400},{ 6441, 7334},{ 6976, 7280},{ 7464, 7231}, + { 7910, 7189},{ 8332, 7157},{ 8730, 7125},{ 9091, 7103}, + { 9422, 7086},{ 9753, 7061},{10067, 7036},{10316, 7029} + } + }, + { + /*Cb qi=34 INTRA*/ + { + { 5, 3},{ 91, 369},{ 158, 746},{ 204, 1162}, + { 266, 1561},{ 358, 1903},{ 466, 2189},{ 570, 2439}, + { 665, 2671},{ 765, 2880},{ 864, 3069},{ 970, 3238}, + { 1079, 3392},{ 1174, 3545},{ 1265, 3693},{ 1360, 3841}, + { 1471, 3968},{ 1572, 4083},{ 1675, 4181},{ 1804, 4255}, + { 1939, 4332},{ 2048, 4411},{ 2155, 4484},{ 2339, 4584} + }, + /*Cb qi=34 INTER*/ + { + { 99, 44},{ 92, 345},{ 82, 661},{ 86, 1043}, + { 101, 1436},{ 116, 1821},{ 128, 2191},{ 140, 2549}, + { 154, 2898},{ 168, 3235},{ 185, 3556},{ 203, 3865}, + { 224, 4166},{ 248, 4457},{ 278, 4741},{ 315, 5021}, + { 361, 5289},{ 416, 5546},{ 483, 5792},{ 559, 6025}, + { 651, 6237},{ 752, 6432},{ 849, 6626},{ 967, 6790} + } + }, + { + /*Cr qi=34 INTRA*/ + { + { 11, 7},{ 93, 387},{ 158, 773},{ 212, 1195}, + { 282, 1584},{ 378, 1909},{ 483, 2179},{ 578, 2414}, + { 671, 2633},{ 766, 2837},{ 866, 3038},{ 960, 3223}, + { 1049, 3376},{ 1158, 3520},{ 1285, 3644},{ 1400, 3740}, + { 1505, 3828},{ 1616, 3928},{ 1713, 4030},{ 1820, 4104}, + { 1957, 4185},{ 2063, 4280},{ 2160, 4355},{ 2320, 4341} + }, + /*Cr qi=34 INTER*/ + { + { 78, 11},{ 89, 347},{ 79, 674},{ 90, 1053}, + { 106, 1444},{ 117, 1823},{ 127, 2192},{ 137, 2558}, + { 149, 2912},{ 163, 3249},{ 178, 3574},{ 197, 3888}, + { 222, 4189},{ 252, 4481},{ 293, 4755},{ 341, 5013}, + { 386, 5268},{ 436, 5512},{ 498, 5743},{ 563, 5970}, + { 622, 6200},{ 694, 6415},{ 776, 6622},{ 871, 6818} + } + } + }, + { + { + /*Y' qi=35 INTRA*/ + { + { 116, 51},{ 433, 1312},{ 881, 2221},{ 1406, 2771}, + { 1948, 3156},{ 2511, 3501},{ 3085, 3811},{ 3654, 4066}, + { 4212, 4273},{ 4763, 4444},{ 5298, 4572},{ 5799, 4638}, + { 6285, 4678},{ 6747, 4746},{ 7203, 4838},{ 7673, 4905}, + { 8124, 4950},{ 8552, 5003},{ 8938, 5027},{ 9275, 5026}, + { 9628, 5019},{ 9981, 5024},{10331, 5030},{10795, 5000} + }, + /*Y' qi=35 INTER*/ + { + { 71, -10},{ 108, 1348},{ 203, 2710},{ 325, 3938}, + { 485, 5040},{ 766, 6000},{ 1267, 6706},{ 2048, 7089}, + { 3037, 7191},{ 4032, 7146},{ 4903, 7061},{ 5648, 6977}, + { 6301, 6912},{ 6884, 6857},{ 7413, 6812},{ 7898, 6775}, + { 8342, 6739},{ 8764, 6710},{ 9160, 6688},{ 9519, 6668}, + { 9859, 6646},{10190, 6625},{10492, 6612},{10755, 6595} + } + }, + { + /*Cb qi=35 INTRA*/ + { + { 6, 3},{ 95, 369},{ 164, 746},{ 214, 1156}, + { 287, 1542},{ 390, 1869},{ 504, 2143},{ 611, 2388}, + { 712, 2613},{ 822, 2811},{ 937, 2987},{ 1055, 3147}, + { 1174, 3285},{ 1286, 3420},{ 1386, 3560},{ 1488, 3698}, + { 1604, 3814},{ 1714, 3916},{ 1825, 4008},{ 1958, 4088}, + { 2101, 4159},{ 2224, 4226},{ 2339, 4292},{ 2538, 4383} + }, + /*Cb qi=35 INTER*/ + { + { 98, 41},{ 90, 348},{ 86, 665},{ 92, 1042}, + { 108, 1432},{ 122, 1812},{ 136, 2175},{ 151, 2528}, + { 165, 2872},{ 182, 3202},{ 202, 3516},{ 225, 3819}, + { 251, 4112},{ 281, 4398},{ 320, 4675},{ 367, 4944}, + { 421, 5204},{ 493, 5450},{ 579, 5679},{ 672, 5892}, + { 785, 6082},{ 906, 6258},{ 1026, 6432},{ 1153, 6592} + } + }, + { + /*Cr qi=35 INTRA*/ + { + { 12, 7},{ 98, 388},{ 166, 773},{ 226, 1187}, + { 306, 1563},{ 411, 1874},{ 524, 2134},{ 622, 2365}, + { 721, 2577},{ 826, 2768},{ 947, 2946},{ 1066, 3106}, + { 1163, 3250},{ 1274, 3395},{ 1417, 3508},{ 1539, 3590}, + { 1639, 3671},{ 1754, 3765},{ 1865, 3855},{ 1979, 3921}, + { 2127, 3998},{ 2249, 4085},{ 2346, 4172},{ 2473, 4210} + }, + /*Cr qi=35 INTER*/ + { + { 86, 12},{ 94, 354},{ 85, 677},{ 96, 1052}, + { 113, 1439},{ 125, 1811},{ 135, 2177},{ 147, 2537}, + { 160, 2884},{ 177, 3215},{ 195, 3535},{ 219, 3842}, + { 252, 4133},{ 292, 4413},{ 339, 4680},{ 396, 4928}, + { 455, 5169},{ 514, 5408},{ 588, 5626},{ 672, 5835}, + { 750, 6051},{ 837, 6257},{ 943, 6442},{ 1073, 6595} + } + } + }, + { + { + /*Y' qi=36 INTRA*/ + { + { 116, 52},{ 432, 1312},{ 881, 2215},{ 1407, 2759}, + { 1948, 3140},{ 2511, 3484},{ 3090, 3789},{ 3672, 4036}, + { 4243, 4236},{ 4803, 4397},{ 5346, 4517},{ 5856, 4581}, + { 6350, 4614},{ 6821, 4675},{ 7286, 4763},{ 7754, 4832}, + { 8201, 4875},{ 8631, 4922},{ 9015, 4948},{ 9351, 4945}, + { 9706, 4941},{10061, 4948},{10408, 4949},{10878, 4923} + }, + /*Y' qi=36 INTER*/ + { + { 63, -16},{ 114, 1332},{ 216, 2690},{ 343, 3914}, + { 515, 5009},{ 829, 5939},{ 1399, 6586},{ 2263, 6901}, + { 3290, 6967},{ 4272, 6920},{ 5115, 6847},{ 5839, 6779}, + { 6478, 6726},{ 7051, 6685},{ 7571, 6649},{ 8050, 6614}, + { 8495, 6587},{ 8908, 6567},{ 9298, 6550},{ 9673, 6530}, + {10005, 6512},{10324, 6499},{10640, 6483},{10936, 6487} + } + }, + { + /*Cb qi=36 INTRA*/ + { + { 6, 3},{ 98, 370},{ 170, 746},{ 225, 1150}, + { 306, 1527},{ 416, 1845},{ 534, 2116},{ 642, 2363}, + { 743, 2591},{ 851, 2794},{ 964, 2972},{ 1081, 3133}, + { 1198, 3275},{ 1311, 3410},{ 1411, 3547},{ 1519, 3680}, + { 1642, 3789},{ 1750, 3892},{ 1860, 3982},{ 1998, 4054}, + { 2141, 4129},{ 2256, 4204},{ 2372, 4278},{ 2567, 4356} + }, + /*Cb qi=36 INTER*/ + { + { 107, 30},{ 96, 346},{ 88, 667},{ 100, 1039}, + { 115, 1426},{ 128, 1804},{ 142, 2164},{ 158, 2512}, + { 176, 2851},{ 195, 3178},{ 218, 3491},{ 243, 3791}, + { 270, 4084},{ 307, 4365},{ 348, 4638},{ 397, 4908}, + { 464, 5157},{ 545, 5392},{ 635, 5620},{ 734, 5831}, + { 854, 6015},{ 993, 6170},{ 1124, 6327},{ 1234, 6502} + } + }, + { + /*Cr qi=36 INTRA*/ + { + { 12, 7},{ 102, 388},{ 172, 773},{ 239, 1182}, + { 328, 1546},{ 439, 1848},{ 554, 2106},{ 651, 2341}, + { 747, 2561},{ 850, 2757},{ 972, 2934},{ 1086, 3097}, + { 1182, 3245},{ 1302, 3382},{ 1447, 3491},{ 1572, 3567}, + { 1677, 3641},{ 1793, 3733},{ 1899, 3828},{ 2013, 3894}, + { 2163, 3967},{ 2283, 4059},{ 2387, 4142},{ 2559, 4145} + }, + /*Cr qi=36 INTER*/ + { + { 98, -10},{ 96, 347},{ 89, 676},{ 102, 1048}, + { 118, 1433},{ 130, 1804},{ 141, 2167},{ 154, 2523}, + { 171, 2866},{ 190, 3194},{ 212, 3508},{ 240, 3809}, + { 276, 4099},{ 320, 4377},{ 372, 4638},{ 428, 4887}, + { 492, 5122},{ 560, 5353},{ 638, 5572},{ 725, 5779}, + { 814, 5985},{ 902, 6192},{ 1013, 6377},{ 1155, 6527} + } + } + }, + { + { + /*Y' qi=37 INTRA*/ + { + { 109, 58},{ 445, 1302},{ 927, 2177},{ 1489, 2689}, + { 2053, 3052},{ 2632, 3387},{ 3230, 3683},{ 3830, 3922}, + { 4417, 4114},{ 4992, 4266},{ 5546, 4375},{ 6067, 4430}, + { 6571, 4459},{ 7046, 4516},{ 7513, 4599},{ 7991, 4663}, + { 8445, 4706},{ 8883, 4749},{ 9273, 4771},{ 9612, 4770}, + { 9970, 4765},{10325, 4773},{10672, 4778},{11106, 4758} + }, + /*Y' qi=37 INTER*/ + { + { 56, -14},{ 114, 1333},{ 218, 2683},{ 354, 3894}, + { 550, 4966},{ 916, 5854},{ 1569, 6437},{ 2520, 6685}, + { 3596, 6704},{ 4585, 6635},{ 5424, 6556},{ 6147, 6489}, + { 6787, 6437},{ 7358, 6395},{ 7876, 6358},{ 8361, 6325}, + { 8807, 6294},{ 9229, 6271},{ 9631, 6253},{10002, 6238}, + {10356, 6228},{10678, 6212},{10975, 6197},{11274, 6185} + } + }, + { + /*Cb qi=37 INTRA*/ + { + { 6, 3},{ 99, 370},{ 171, 746},{ 227, 1149}, + { 309, 1522},{ 421, 1836},{ 541, 2104},{ 652, 2347}, + { 757, 2572},{ 871, 2768},{ 989, 2936},{ 1111, 3087}, + { 1238, 3223},{ 1357, 3352},{ 1465, 3486},{ 1576, 3612}, + { 1709, 3705},{ 1828, 3801},{ 1937, 3895},{ 2076, 3967}, + { 2220, 4035},{ 2345, 4104},{ 2466, 4173},{ 2680, 4265} + }, + /*Cb qi=37 INTER*/ + { + { 111, 27},{ 97, 344},{ 87, 667},{ 99, 1038}, + { 115, 1425},{ 128, 1802},{ 143, 2160},{ 159, 2506}, + { 176, 2843},{ 198, 3167},{ 220, 3477},{ 247, 3774}, + { 280, 4061},{ 321, 4338},{ 368, 4608},{ 427, 4867}, + { 501, 5109},{ 595, 5332},{ 701, 5544},{ 818, 5738}, + { 956, 5905},{ 1105, 6066},{ 1248, 6217},{ 1381, 6353} + } + }, + { + /*Cr qi=37 INTRA*/ + { + { 12, 7},{ 102, 388},{ 173, 773},{ 242, 1180}, + { 331, 1541},{ 444, 1839},{ 562, 2095},{ 662, 2326}, + { 763, 2540},{ 871, 2728},{ 1003, 2892},{ 1130, 3045}, + { 1230, 3188},{ 1350, 3321},{ 1503, 3418},{ 1634, 3492}, + { 1737, 3568},{ 1856, 3653},{ 1970, 3744},{ 2091, 3802}, + { 2247, 3871},{ 2371, 3962},{ 2477, 4041},{ 2655, 4052} + }, + /*Cr qi=37 INTER*/ + { + { 89, -9},{ 97, 347},{ 88, 677},{ 102, 1048}, + { 118, 1432},{ 130, 1802},{ 141, 2163},{ 154, 2517}, + { 172, 2857},{ 192, 3181},{ 216, 3494},{ 246, 3793}, + { 286, 4074},{ 337, 4343},{ 395, 4600},{ 464, 4837}, + { 534, 5066},{ 608, 5289},{ 694, 5501},{ 788, 5704}, + { 893, 5901},{ 1010, 6088},{ 1151, 6249},{ 1331, 6374} + } + } + }, + { + { + /*Y' qi=38 INTRA*/ + { + { 107, 65},{ 476, 1286},{ 968, 2148},{ 1548, 2641}, + { 2141, 2979},{ 2757, 3289},{ 3390, 3564},{ 4020, 3784}, + { 4632, 3957},{ 5224, 4097},{ 5794, 4201},{ 6326, 4250}, + { 6828, 4274},{ 7309, 4322},{ 7790, 4401},{ 8271, 4463}, + { 8729, 4498},{ 9165, 4540},{ 9552, 4566},{ 9901, 4560}, + {10266, 4552},{10617, 4563},{10964, 4572},{11393, 4567} + }, + /*Y' qi=38 INTER*/ + { + { 57, -13},{ 118, 1332},{ 233, 2665},{ 386, 3856}, + { 620, 4899},{ 1070, 5722},{ 1849, 6211},{ 2898, 6384}, + { 3989, 6376},{ 4947, 6311},{ 5754, 6249},{ 6454, 6199}, + { 7077, 6161},{ 7640, 6132},{ 8159, 6101},{ 8639, 6076}, + { 9081, 6054},{ 9502, 6037},{ 9900, 6027},{10274, 6012}, + {10621, 5999},{10938, 5991},{11237, 5977},{11557, 5966} + } + }, + { + /*Cb qi=38 INTRA*/ + { + { 8, 3},{ 104, 370},{ 179, 744},{ 243, 1139}, + { 338, 1498},{ 458, 1801},{ 584, 2060},{ 700, 2297}, + { 812, 2514},{ 935, 2699},{ 1061, 2858},{ 1189, 3007}, + { 1321, 3141},{ 1446, 3266},{ 1563, 3388},{ 1684, 3512}, + { 1816, 3614},{ 1942, 3702},{ 2055, 3793},{ 2201, 3857}, + { 2357, 3923},{ 2477, 3994},{ 2593, 4061},{ 2768, 4178} + }, + /*Cb qi=38 INTER*/ + { + { 118, 24},{ 102, 342},{ 91, 663},{ 101, 1040}, + { 116, 1427},{ 131, 1799},{ 147, 2152},{ 168, 2491}, + { 191, 2822},{ 215, 3139},{ 244, 3441},{ 276, 3731}, + { 316, 4013},{ 363, 4286},{ 423, 4546},{ 495, 4795}, + { 584, 5028},{ 691, 5242},{ 814, 5439},{ 959, 5608}, + { 1119, 5759},{ 1277, 5906},{ 1449, 6035},{ 1655, 6144} + } + }, + { + /*Cr qi=38 INTRA*/ + { + { 12, 6},{ 106, 387},{ 182, 771},{ 261, 1168}, + { 364, 1514},{ 483, 1802},{ 603, 2053},{ 707, 2282}, + { 817, 2489},{ 933, 2670},{ 1074, 2825},{ 1210, 2967}, + { 1320, 3104},{ 1444, 3229},{ 1599, 3324},{ 1735, 3396}, + { 1846, 3464},{ 1971, 3547},{ 2086, 3646},{ 2206, 3711}, + { 2366, 3773},{ 2499, 3859},{ 2603, 3945},{ 2766, 3952} + }, + /*Cr qi=38 INTER*/ + { + { 86, -9},{ 91, 352},{ 85, 680},{ 102, 1053}, + { 119, 1435},{ 132, 1799},{ 146, 2153},{ 162, 2501}, + { 183, 2835},{ 209, 3154},{ 240, 3458},{ 278, 3751}, + { 327, 4025},{ 388, 4284},{ 455, 4532},{ 529, 4766}, + { 616, 4980},{ 711, 5188},{ 815, 5386},{ 920, 5583}, + { 1042, 5770},{ 1186, 5936},{ 1348, 6080},{ 1542, 6196} + } + } + }, + { + { + /*Y' qi=39 INTRA*/ + { + { 103, 66},{ 479, 1283},{ 998, 2125},{ 1610, 2591}, + { 2223, 2913},{ 2855, 3214},{ 3501, 3482},{ 4146, 3698}, + { 4772, 3868},{ 5376, 3999},{ 5956, 4095},{ 6496, 4140}, + { 7008, 4162},{ 7499, 4209},{ 7987, 4282},{ 8478, 4338}, + { 8947, 4374},{ 9385, 4417},{ 9783, 4437},{10143, 4433}, + {10504, 4424},{10866, 4435},{11225, 4444},{11665, 4430} + }, + /*Y' qi=39 INTER*/ + { + { 56, 2},{ 118, 1332},{ 235, 2660},{ 395, 3843}, + { 653, 4867},{ 1153, 5652},{ 2003, 6089},{ 3113, 6214}, + { 4228, 6178},{ 5189, 6102},{ 6002, 6031},{ 6707, 5976}, + { 7336, 5936},{ 7901, 5900},{ 8424, 5870},{ 8915, 5844}, + { 9361, 5822},{ 9784, 5807},{10187, 5794},{10571, 5778}, + {10931, 5763},{11264, 5751},{11582, 5742},{11916, 5730} + } + }, + { + /*Cb qi=39 INTRA*/ + { + { 8, 3},{ 104, 370},{ 179, 744},{ 244, 1138}, + { 340, 1496},{ 461, 1796},{ 588, 2053},{ 705, 2288}, + { 820, 2503},{ 945, 2684},{ 1073, 2840},{ 1210, 2981}, + { 1352, 3106},{ 1480, 3225},{ 1603, 3342},{ 1728, 3464}, + { 1865, 3559},{ 1990, 3645},{ 2106, 3734},{ 2258, 3796}, + { 2413, 3856},{ 2540, 3920},{ 2667, 3986},{ 2887, 4060} + }, + /*Cb qi=39 INTER*/ + { + { 119, 19},{ 103, 340},{ 90, 664},{ 100, 1040}, + { 115, 1426},{ 131, 1797},{ 148, 2148},{ 169, 2486}, + { 192, 2816},{ 217, 3131},{ 247, 3432},{ 282, 3721}, + { 324, 3999},{ 374, 4268},{ 435, 4526},{ 520, 4766}, + { 621, 4990},{ 738, 5194},{ 878, 5376},{ 1035, 5543}, + { 1202, 5686},{ 1374, 5819},{ 1545, 5950},{ 1729, 6064} + } + }, + { + /*Cr qi=39 INTRA*/ + { + { 12, 6},{ 106, 387},{ 182, 771},{ 262, 1167}, + { 365, 1512},{ 486, 1798},{ 608, 2047},{ 713, 2274}, + { 824, 2479},{ 945, 2655},{ 1091, 2804},{ 1231, 2941}, + { 1346, 3073},{ 1475, 3194},{ 1633, 3282},{ 1778, 3345}, + { 1891, 3414},{ 2013, 3501},{ 2138, 3584},{ 2266, 3640}, + { 2428, 3701},{ 2568, 3782},{ 2674, 3863},{ 2816, 3894} + }, + /*Cr qi=39 INTER*/ + { + { 88, -7},{ 92, 352},{ 85, 680},{ 102, 1053}, + { 119, 1434},{ 132, 1797},{ 146, 2151},{ 163, 2498}, + { 185, 2830},{ 211, 3147},{ 243, 3451},{ 285, 3735}, + { 337, 4005},{ 401, 4260},{ 477, 4499},{ 565, 4721}, + { 655, 4937},{ 749, 5148},{ 858, 5344},{ 979, 5529}, + { 1110, 5710},{ 1264, 5871},{ 1460, 5990},{ 1677, 6086} + } + } + }, + { + { + /*Y' qi=40 INTRA*/ + { + { 98, 71},{ 491, 1274},{ 1023, 2103},{ 1641, 2559}, + { 2257, 2877},{ 2898, 3171},{ 3566, 3429},{ 4233, 3629}, + { 4881, 3784},{ 5499, 3906},{ 6088, 3997},{ 6631, 4040}, + { 7145, 4060},{ 7640, 4107},{ 8128, 4178},{ 8618, 4233}, + { 9077, 4267},{ 9514, 4304},{ 9919, 4324},{10277, 4317}, + {10635, 4312},{10985, 4324},{11338, 4331},{11792, 4334} + }, + /*Y' qi=40 INTER*/ + { + { 63, -26},{ 125, 1331},{ 256, 2640},{ 439, 3801}, + { 757, 4782},{ 1391, 5474},{ 2399, 5805},{ 3582, 5870}, + { 4678, 5824},{ 5600, 5763},{ 6386, 5710},{ 7076, 5667}, + { 7693, 5637},{ 8252, 5610},{ 8775, 5586},{ 9255, 5571}, + { 9694, 5556},{10115, 5541},{10530, 5530},{10903, 5522}, + {11242, 5515},{11596, 5501},{11904, 5482},{12205, 5475} + } + }, + { + /*Cb qi=40 INTRA*/ + { + { 8, 3},{ 108, 371},{ 189, 743},{ 265, 1128}, + { 371, 1475},{ 499, 1767},{ 628, 2022},{ 746, 2256}, + { 864, 2467},{ 991, 2647},{ 1124, 2801},{ 1270, 2933}, + { 1412, 3054},{ 1547, 3165},{ 1677, 3277},{ 1804, 3393}, + { 1946, 3483},{ 2078, 3569},{ 2201, 3651},{ 2352, 3711}, + { 2513, 3766},{ 2643, 3826},{ 2775, 3880},{ 3025, 3919} + }, + /*Cb qi=40 INTER*/ + { + { 114, 35},{ 104, 349},{ 96, 667},{ 106, 1040}, + { 121, 1423},{ 138, 1789},{ 158, 2132},{ 184, 2464}, + { 212, 2787},{ 242, 3095},{ 279, 3389},{ 321, 3671}, + { 374, 3941},{ 438, 4199},{ 517, 4446},{ 617, 4673}, + { 740, 4881},{ 891, 5064},{ 1058, 5225},{ 1239, 5372}, + { 1441, 5499},{ 1638, 5610},{ 1840, 5719},{ 2076, 5814} + } + }, + { + /*Cr qi=40 INTRA*/ + { + { 14, 7},{ 114, 389},{ 193, 771},{ 283, 1156}, + { 399, 1488},{ 523, 1768},{ 643, 2018},{ 752, 2245}, + { 865, 2450},{ 984, 2626},{ 1139, 2763},{ 1290, 2887}, + { 1413, 3014},{ 1550, 3128},{ 1711, 3211},{ 1865, 3268}, + { 1981, 3334},{ 2103, 3415},{ 2237, 3486},{ 2365, 3543}, + { 2529, 3610},{ 2666, 3700},{ 2775, 3779},{ 2929, 3803} + }, + /*Cr qi=40 INTER*/ + { + { 89, -8},{ 95, 353},{ 90, 681},{ 107, 1053}, + { 124, 1430},{ 139, 1787},{ 156, 2136},{ 177, 2477}, + { 203, 2803},{ 237, 3112},{ 276, 3406},{ 329, 3683}, + { 395, 3942},{ 475, 4182},{ 567, 4407},{ 665, 4624}, + { 767, 4834},{ 879, 5032},{ 1011, 5213},{ 1169, 5375}, + { 1348, 5525},{ 1547, 5654},{ 1785, 5743},{ 2066, 5787} + } + } + }, + { + { + /*Y' qi=41 INTRA*/ + { + { 98, 71},{ 495, 1272},{ 1040, 2090},{ 1675, 2533}, + { 2302, 2842},{ 2953, 3132},{ 3631, 3381},{ 4309, 3574}, + { 4966, 3726},{ 5593, 3846},{ 6189, 3934},{ 6738, 3972}, + { 7256, 3991},{ 7754, 4036},{ 8250, 4099},{ 8747, 4150}, + { 9207, 4185},{ 9650, 4222},{10057, 4242},{10411, 4237}, + {10771, 4230},{11127, 4244},{11486, 4254},{11933, 4252} + }, + /*Y' qi=41 INTER*/ + { + { 65, -25},{ 125, 1331},{ 260, 2633},{ 457, 3782}, + { 807, 4740},{ 1499, 5397},{ 2562, 5693},{ 3766, 5743}, + { 4859, 5695},{ 5776, 5638},{ 6556, 5590},{ 7243, 5554}, + { 7859, 5529},{ 8417, 5506},{ 8935, 5486},{ 9419, 5473}, + { 9869, 5460},{10296, 5446},{10711, 5436},{11089, 5430}, + {11445, 5421},{11802, 5412},{12129, 5404},{12465, 5393} + } + }, + { + /*Cb qi=41 INTRA*/ + { + { 8, 3},{ 108, 371},{ 189, 743},{ 267, 1126}, + { 374, 1471},{ 504, 1760},{ 635, 2011},{ 758, 2241}, + { 881, 2447},{ 1013, 2621},{ 1147, 2773},{ 1293, 2906}, + { 1441, 3023},{ 1580, 3131},{ 1712, 3243},{ 1844, 3360}, + { 1985, 3451},{ 2114, 3532},{ 2240, 3613},{ 2390, 3680}, + { 2550, 3740},{ 2687, 3800},{ 2825, 3862},{ 3052, 3944} + }, + /*Cb qi=41 INTER*/ + { + { 104, 39},{ 100, 350},{ 95, 667},{ 105, 1040}, + { 121, 1422},{ 137, 1787},{ 159, 2129},{ 185, 2459}, + { 216, 2778},{ 249, 3083},{ 287, 3374},{ 335, 3653}, + { 393, 3920},{ 462, 4175},{ 549, 4414},{ 660, 4636}, + { 791, 4839},{ 952, 5014},{ 1135, 5166},{ 1337, 5297}, + { 1552, 5411},{ 1752, 5530},{ 1972, 5634},{ 2224, 5724} + } + }, + { + /*Cr qi=41 INTRA*/ + { + { 15, 7},{ 115, 389},{ 193, 770},{ 284, 1154}, + { 401, 1484},{ 528, 1761},{ 652, 2005},{ 764, 2228}, + { 882, 2427},{ 1008, 2599},{ 1167, 2734},{ 1320, 2859}, + { 1443, 2990},{ 1580, 3103},{ 1743, 3181},{ 1894, 3241}, + { 2012, 3309},{ 2141, 3385},{ 2272, 3459},{ 2398, 3519}, + { 2566, 3584},{ 2707, 3680},{ 2816, 3762},{ 2991, 3770} + }, + /*Cr qi=41 INTER*/ + { + { 92, -9},{ 98, 354},{ 90, 682},{ 107, 1052}, + { 124, 1429},{ 139, 1786},{ 156, 2132},{ 178, 2471}, + { 207, 2794},{ 241, 3100},{ 285, 3391},{ 345, 3662}, + { 417, 3915},{ 503, 4151},{ 600, 4375},{ 703, 4589}, + { 815, 4791},{ 942, 4981},{ 1088, 5155},{ 1250, 5316}, + { 1432, 5462},{ 1653, 5575},{ 1930, 5639},{ 2250, 5655} + } + } + }, + { + { + /*Y' qi=42 INTRA*/ + { + { 109, 75},{ 534, 1257},{ 1114, 2047},{ 1793, 2456}, + { 2461, 2735},{ 3157, 2994},{ 3879, 3221},{ 4595, 3396}, + { 5282, 3531},{ 5931, 3638},{ 6546, 3714},{ 7105, 3749}, + { 7633, 3766},{ 8147, 3803},{ 8652, 3865},{ 9148, 3915}, + { 9613, 3946},{10075, 3976},{10489, 3997},{10835, 3994}, + {11195, 3985},{11553, 3997},{11909, 4004},{12369, 3990} + }, + /*Y' qi=42 INTER*/ + { + { 69, -23},{ 134, 1332},{ 287, 2611},{ 521, 3730}, + { 970, 4624},{ 1827, 5176},{ 3028, 5382},{ 4262, 5389}, + { 5325, 5338},{ 6214, 5291},{ 6976, 5255},{ 7651, 5228}, + { 8260, 5206},{ 8821, 5190},{ 9343, 5177},{ 9823, 5165}, + {10273, 5152},{10709, 5143},{11121, 5136},{11502, 5129}, + {11857, 5125},{12193, 5115},{12520, 5107},{12802, 5097} + } + }, + { + /*Cb qi=42 INTRA*/ + { + { 9, 3},{ 113, 371},{ 199, 743},{ 279, 1123}, + { 390, 1462},{ 525, 1743},{ 662, 1986},{ 789, 2208}, + { 916, 2406},{ 1057, 2571},{ 1204, 2712},{ 1362, 2835}, + { 1524, 2943},{ 1676, 3040},{ 1815, 3145},{ 1959, 3249}, + { 2117, 3325},{ 2249, 3406},{ 2377, 3488},{ 2537, 3547}, + { 2706, 3597},{ 2854, 3646},{ 2999, 3705},{ 3236, 3759} + }, + /*Cb qi=42 INTER*/ + { + { 114, 44},{ 107, 353},{ 101, 670},{ 111, 1041}, + { 129, 1418},{ 148, 1775},{ 174, 2110},{ 208, 2432}, + { 244, 2746},{ 283, 3046},{ 330, 3330},{ 388, 3602}, + { 460, 3858},{ 546, 4101},{ 655, 4326},{ 793, 4530}, + { 966, 4703},{ 1165, 4851},{ 1388, 4980},{ 1630, 5088}, + { 1869, 5189},{ 2122, 5268},{ 2403, 5328},{ 2667, 5417} + } + }, + { + /*Cr qi=42 INTRA*/ + { + { 15, 7},{ 120, 390},{ 202, 771},{ 298, 1150}, + { 421, 1473},{ 553, 1743},{ 681, 1982},{ 796, 2199}, + { 923, 2388},{ 1062, 2547},{ 1225, 2678},{ 1392, 2792}, + { 1531, 2907},{ 1682, 3007},{ 1856, 3074},{ 2009, 3134}, + { 2138, 3192},{ 2274, 3257},{ 2407, 3333},{ 2536, 3393}, + { 2711, 3455},{ 2875, 3531},{ 3000, 3598},{ 3186, 3599} + }, + /*Cr qi=42 INTER*/ + { + { 87, -4},{ 95, 358},{ 97, 683},{ 113, 1052}, + { 131, 1423},{ 148, 1774},{ 170, 2116},{ 198, 2448}, + { 234, 2762},{ 276, 3062},{ 331, 3343},{ 404, 3603}, + { 494, 3844},{ 598, 4067},{ 715, 4276},{ 842, 4471}, + { 977, 4661},{ 1128, 4840},{ 1311, 4991},{ 1516, 5127}, + { 1759, 5233},{ 2050, 5300},{ 2377, 5323},{ 2710, 5304} + } + } + }, + { + { + /*Y' qi=43 INTRA*/ + { + { 99, 79},{ 557, 1244},{ 1175, 2016},{ 1882, 2408}, + { 2570, 2677},{ 3288, 2926},{ 4030, 3141},{ 4760, 3307}, + { 5458, 3435},{ 6115, 3537},{ 6743, 3608},{ 7312, 3636}, + { 7841, 3652},{ 8357, 3687},{ 8870, 3742},{ 9376, 3788}, + { 9850, 3821},{10315, 3853},{10734, 3873},{11084, 3870}, + {11442, 3862},{11800, 3874},{12160, 3879},{12618, 3876} + }, + /*Y' qi=43 INTER*/ + { + { 69, -22},{ 134, 1331},{ 294, 2601},{ 551, 3703}, + { 1056, 4563},{ 2003, 5061},{ 3276, 5215},{ 4534, 5194}, + { 5599, 5133},{ 6488, 5083},{ 7257, 5044},{ 7938, 5014}, + { 8556, 4992},{ 9124, 4975},{ 9648, 4960},{10138, 4948}, + {10594, 4939},{11039, 4926},{11462, 4919},{11847, 4912}, + {12216, 4904},{12570, 4896},{12883, 4889},{13189, 4879} + } + }, + { + /*Cb qi=43 INTRA*/ + { + { 9, 3},{ 114, 371},{ 202, 740},{ 294, 1110}, + { 417, 1440},{ 558, 1716},{ 700, 1956},{ 833, 2172}, + { 966, 2365},{ 1116, 2524},{ 1269, 2661},{ 1431, 2781}, + { 1599, 2885},{ 1756, 2980},{ 1902, 3082},{ 2051, 3185}, + { 2209, 3261},{ 2337, 3342},{ 2464, 3420},{ 2633, 3475}, + { 2809, 3525},{ 2948, 3579},{ 3094, 3633},{ 3347, 3678} + }, + /*Cb qi=43 INTER*/ + { + { 111, 44},{ 106, 353},{ 102, 670},{ 112, 1040}, + { 128, 1416},{ 148, 1771},{ 176, 2104},{ 211, 2424}, + { 250, 2734},{ 293, 3030},{ 347, 3309},{ 411, 3575}, + { 490, 3828},{ 589, 4064},{ 716, 4278},{ 869, 4472}, + { 1050, 4640},{ 1264, 4781},{ 1512, 4895},{ 1775, 4991}, + { 2042, 5069},{ 2310, 5141},{ 2593, 5207},{ 2912, 5239} + } + }, + { + /*Cr qi=43 INTRA*/ + { + { 15, 7},{ 121, 390},{ 208, 767},{ 315, 1135}, + { 449, 1449},{ 586, 1715},{ 718, 1950},{ 843, 2158}, + { 977, 2342},{ 1120, 2501},{ 1290, 2632},{ 1466, 2739}, + { 1613, 2845},{ 1763, 2945},{ 1937, 3015},{ 2093, 3070}, + { 2225, 3126},{ 2366, 3194},{ 2501, 3267},{ 2634, 3324}, + { 2815, 3385},{ 2964, 3466},{ 3087, 3538},{ 3263, 3555} + }, + /*Cr qi=43 INTER*/ + { + { 84, -4},{ 93, 358},{ 95, 683},{ 113, 1052}, + { 131, 1421},{ 148, 1770},{ 171, 2110},{ 201, 2439}, + { 240, 2750},{ 287, 3046},{ 348, 3322},{ 429, 3576}, + { 527, 3811},{ 641, 4029},{ 767, 4230},{ 904, 4422}, + { 1053, 4603},{ 1225, 4765},{ 1433, 4903},{ 1661, 5030}, + { 1928, 5121},{ 2252, 5160},{ 2604, 5164},{ 2979, 5125} + } + } + }, + { + { + /*Y' qi=44 INTRA*/ + { + { 103, 80},{ 560, 1244},{ 1183, 2009},{ 1891, 2391}, + { 2586, 2649},{ 3324, 2884},{ 4093, 3089},{ 4850, 3243}, + { 5575, 3358},{ 6252, 3452},{ 6886, 3518},{ 7459, 3546}, + { 7993, 3562},{ 8515, 3594},{ 9030, 3645},{ 9534, 3691}, + {10004, 3723},{10469, 3750},{10887, 3765},{11236, 3766}, + {11596, 3762},{11960, 3775},{12317, 3784},{12766, 3789} + }, + /*Y' qi=44 INTER*/ + { + { 77, -24},{ 145, 1332},{ 332, 2580},{ 642, 3649}, + { 1270, 4438},{ 2360, 4860},{ 3685, 4982},{ 4910, 4966}, + { 5929, 4928},{ 6785, 4900},{ 7529, 4880},{ 8198, 4863}, + { 8804, 4850},{ 9361, 4842},{ 9882, 4836},{10371, 4830}, + {10827, 4822},{11262, 4816},{11672, 4811},{12052, 4807}, + {12431, 4806},{12780, 4798},{13095, 4792},{13401, 4791} + } + }, + { + /*Cb qi=44 INTRA*/ + { + { 9, 2},{ 122, 371},{ 214, 741},{ 307, 1109}, + { 433, 1432},{ 576, 1704},{ 718, 1939},{ 855, 2152}, + { 991, 2340},{ 1141, 2497},{ 1298, 2632},{ 1463, 2749}, + { 1636, 2851},{ 1796, 2944},{ 1947, 3041},{ 2101, 3140}, + { 2260, 3219},{ 2392, 3297},{ 2527, 3366},{ 2693, 3424}, + { 2872, 3477},{ 3025, 3525},{ 3175, 3584},{ 3451, 3626} + }, + /*Cb qi=44 INTER*/ + { + { 111, 14},{ 110, 339},{ 109, 671},{ 120, 1040}, + { 139, 1410},{ 162, 1758},{ 197, 2084},{ 243, 2397}, + { 291, 2702},{ 342, 2992},{ 405, 3265},{ 484, 3521}, + { 584, 3760},{ 705, 3983},{ 855, 4185},{ 1048, 4356}, + { 1274, 4500},{ 1531, 4617},{ 1816, 4707},{ 2111, 4783}, + { 2409, 4846},{ 2720, 4901},{ 3044, 4957},{ 3391, 4985} + } + }, + { + /*Cr qi=44 INTRA*/ + { + { 17, 7},{ 128, 392},{ 219, 770},{ 329, 1135}, + { 465, 1442},{ 601, 1703},{ 734, 1935},{ 862, 2142}, + { 998, 2325},{ 1147, 2482},{ 1321, 2606},{ 1496, 2710}, + { 1649, 2813},{ 1809, 2908},{ 1984, 2977},{ 2143, 3032}, + { 2279, 3087},{ 2423, 3152},{ 2559, 3225},{ 2684, 3288}, + { 2866, 3351},{ 3025, 3426},{ 3161, 3492},{ 3372, 3500} + }, + /*Cr qi=44 INTER*/ + { + { 89, 0},{ 101, 352},{ 104, 683},{ 121, 1051}, + { 141, 1414},{ 163, 1757},{ 192, 2092},{ 231, 2415}, + { 278, 2720},{ 336, 3007},{ 412, 3273},{ 510, 3516}, + { 633, 3733},{ 769, 3936},{ 914, 4130},{ 1076, 4307}, + { 1256, 4472},{ 1469, 4617},{ 1723, 4732},{ 2012, 4822}, + { 2347, 4871},{ 2716, 4875},{ 3082, 4866},{ 3422, 4826} + } + } + }, + { + { + /*Y' qi=45 INTRA*/ + { + { 119, 78},{ 610, 1226},{ 1271, 1965},{ 2026, 2319}, + { 2768, 2550},{ 3556, 2757},{ 4369, 2938},{ 5157, 3076}, + { 5901, 3182},{ 6598, 3268},{ 7253, 3326},{ 7844, 3343}, + { 8392, 3356},{ 8922, 3386},{ 9453, 3433},{ 9973, 3474}, + {10457, 3503},{10929, 3530},{11351, 3543},{11709, 3541}, + {12068, 3537},{12434, 3547},{12805, 3555},{13268, 3563} + }, + /*Y' qi=45 INTER*/ + { + { 77, -20},{ 146, 1330},{ 342, 2566},{ 699, 3604}, + { 1439, 4332},{ 2669, 4672},{ 4075, 4727},{ 5318, 4679}, + { 6345, 4630},{ 7209, 4595},{ 7963, 4570},{ 8644, 4551}, + { 9262, 4535},{ 9831, 4525},{10370, 4515},{10872, 4506}, + {11334, 4500},{11783, 4492},{12219, 4489},{12617, 4483}, + {12995, 4477},{13350, 4472},{13674, 4466},{13968, 4468} + } + }, + { + /*Cb qi=45 INTRA*/ + { + { 9, 2},{ 122, 370},{ 219, 735},{ 324, 1096}, + { 465, 1414},{ 619, 1679},{ 771, 1905},{ 920, 2103}, + { 1070, 2276},{ 1236, 2419},{ 1410, 2539},{ 1595, 2644}, + { 1784, 2736},{ 1949, 2831},{ 2104, 2931},{ 2275, 3021}, + { 2443, 3092},{ 2586, 3166},{ 2735, 3234},{ 2904, 3288}, + { 3093, 3338},{ 3262, 3382},{ 3419, 3427},{ 3708, 3456} + }, + /*Cb qi=45 INTER*/ + { + { 103, 0},{ 109, 339},{ 109, 670},{ 119, 1039}, + { 137, 1408},{ 162, 1754},{ 199, 2076},{ 248, 2386}, + { 301, 2684},{ 360, 2967},{ 433, 3234},{ 525, 3481}, + { 640, 3713},{ 780, 3924},{ 956, 4110},{ 1176, 4266}, + { 1438, 4390},{ 1736, 4481},{ 2057, 4553},{ 2385, 4613}, + { 2718, 4656},{ 3056, 4698},{ 3416, 4733},{ 3799, 4755} + } + }, + { + /*Cr qi=45 INTRA*/ + { + { 16, 7},{ 128, 391},{ 225, 763},{ 350, 1120}, + { 500, 1420},{ 649, 1673},{ 792, 1893},{ 929, 2089}, + { 1084, 2257},{ 1250, 2401},{ 1440, 2518},{ 1633, 2614}, + { 1799, 2708},{ 1968, 2798},{ 2151, 2863},{ 2314, 2914}, + { 2453, 2968},{ 2611, 3025},{ 2759, 3095},{ 2887, 3160}, + { 3082, 3210},{ 3259, 3278},{ 3403, 3342},{ 3593, 3354} + }, + /*Cr qi=45 INTER*/ + { + { 92, 0},{ 101, 352},{ 103, 682},{ 120, 1049}, + { 140, 1412},{ 163, 1752},{ 193, 2083},{ 234, 2402}, + { 287, 2702},{ 353, 2983},{ 442, 3240},{ 557, 3471}, + { 694, 3680},{ 846, 3873},{ 1014, 4056},{ 1200, 4224}, + { 1414, 4369},{ 1664, 4495},{ 1946, 4595},{ 2278, 4654}, + { 2654, 4673},{ 3047, 4658},{ 3438, 4627},{ 3825, 4585} + } + } + }, + { + { + /*Y' qi=46 INTRA*/ + { + { 119, 78},{ 610, 1227},{ 1277, 1960},{ 2043, 2309}, + { 2805, 2529},{ 3618, 2719},{ 4452, 2887},{ 5257, 3016}, + { 6017, 3115},{ 6727, 3195},{ 7392, 3248},{ 7984, 3267}, + { 8528, 3281},{ 9059, 3310},{ 9593, 3354},{10119, 3395}, + {10599, 3425},{11064, 3450},{11493, 3464},{11850, 3466}, + {12207, 3462},{12578, 3471},{12948, 3480},{13407, 3487} + }, + /*Y' qi=46 INTER*/ + { + { 74, -14},{ 149, 1326},{ 382, 2538},{ 807, 3541}, + { 1670, 4211},{ 3000, 4499},{ 4416, 4533},{ 5628, 4490}, + { 6628, 4453},{ 7479, 4425},{ 8228, 4406},{ 8902, 4393}, + { 9521, 4380},{10090, 4371},{10623, 4364},{11124, 4356}, + {11586, 4351},{12043, 4344},{12476, 4341},{12863, 4340}, + {13244, 4337},{13610, 4329},{13936, 4324},{14246, 4329} + } + }, + { + /*Cb qi=46 INTRA*/ + { + { 11, 2},{ 132, 371},{ 234, 737},{ 340, 1094}, + { 481, 1405},{ 637, 1667},{ 791, 1891},{ 944, 2084}, + { 1099, 2253},{ 1268, 2392},{ 1444, 2507},{ 1633, 2610}, + { 1825, 2700},{ 1990, 2794},{ 2147, 2895},{ 2321, 2984}, + { 2493, 3053},{ 2640, 3126},{ 2787, 3198},{ 2954, 3253}, + { 3146, 3297},{ 3313, 3344},{ 3473, 3393},{ 3757, 3434} + }, + /*Cb qi=46 INTER*/ + { + { 97, 0},{ 109, 339},{ 108, 669},{ 120, 1035}, + { 142, 1398},{ 173, 1737},{ 221, 2052},{ 281, 2353}, + { 345, 2646},{ 415, 2924},{ 504, 3183},{ 616, 3421}, + { 749, 3643},{ 914, 3842},{ 1123, 4012},{ 1379, 4150}, + { 1685, 4250},{ 2014, 4327},{ 2366, 4382},{ 2731, 4426}, + { 3083, 4470},{ 3445, 4490},{ 3805, 4511},{ 4146, 4539} + } + }, + { + /*Cr qi=46 INTRA*/ + { + { 19, 7},{ 137, 393},{ 237, 765},{ 364, 1116}, + { 516, 1411},{ 665, 1662},{ 809, 1880},{ 951, 2072}, + { 1109, 2236},{ 1278, 2378},{ 1474, 2491},{ 1669, 2584}, + { 1835, 2678},{ 2014, 2766},{ 2203, 2828},{ 2366, 2880}, + { 2506, 2933},{ 2661, 2988},{ 2810, 3053},{ 2941, 3116}, + { 3131, 3175},{ 3310, 3243},{ 3461, 3303},{ 3656, 3321} + }, + /*Cr qi=46 INTER*/ + { + { 91, 1},{ 103, 351},{ 104, 681},{ 121, 1046}, + { 144, 1401},{ 173, 1736},{ 213, 2060},{ 265, 2373}, + { 330, 2666},{ 410, 2938},{ 517, 3185},{ 655, 3404}, + { 815, 3601},{ 989, 3784},{ 1183, 3951},{ 1400, 4104}, + { 1649, 4241},{ 1933, 4352},{ 2261, 4427},{ 2646, 4458}, + { 3057, 4446},{ 3453, 4418},{ 3820, 4385},{ 4171, 4352} + } + } + }, + { + { + /*Y' qi=47 INTRA*/ + { + { 117, 83},{ 670, 1205},{ 1408, 1904},{ 2239, 2219}, + { 3049, 2414},{ 3905, 2584},{ 4775, 2734},{ 5610, 2852}, + { 6393, 2944},{ 7121, 3017},{ 7804, 3066},{ 8407, 3081}, + { 8957, 3093},{ 9498, 3119},{10043, 3160},{10582, 3199}, + {11083, 3226},{11561, 3250},{11993, 3263},{12352, 3264}, + {12711, 3259},{13092, 3266},{13463, 3271},{13918, 3275} + }, + /*Y' qi=47 INTER*/ + { + { 74, -11},{ 148, 1325},{ 404, 2518},{ 910, 3478}, + { 1916, 4080},{ 3369, 4298},{ 4823, 4292},{ 6035, 4238}, + { 7037, 4197},{ 7894, 4168},{ 8650, 4146},{ 9337, 4129}, + { 9968, 4116},{10549, 4105},{11096, 4096},{11605, 4089}, + {12081, 4083},{12547, 4076},{12990, 4070},{13399, 4070}, + {13776, 4065},{14133, 4059},{14486, 4057},{14842, 4053} + } + }, + { + /*Cb qi=47 INTRA*/ + { + { 11, 2},{ 133, 370},{ 242, 731},{ 367, 1077}, + { 524, 1378},{ 692, 1630},{ 860, 1844},{ 1028, 2024}, + { 1203, 2178},{ 1393, 2305},{ 1582, 2413},{ 1787, 2507}, + { 1992, 2590},{ 2175, 2676},{ 2351, 2767},{ 2534, 2851}, + { 2707, 2923},{ 2862, 2994},{ 3021, 3060},{ 3193, 3111}, + { 3396, 3147},{ 3573, 3184},{ 3752, 3220},{ 4038, 3255} + }, + /*Cb qi=47 INTER*/ + { + { 101, 0},{ 107, 339},{ 108, 667},{ 120, 1033}, + { 142, 1394},{ 175, 1729},{ 227, 2040},{ 295, 2335}, + { 369, 2619},{ 452, 2888},{ 556, 3138},{ 686, 3368}, + { 850, 3574},{ 1050, 3758},{ 1299, 3910},{ 1605, 4024}, + { 1950, 4104},{ 2317, 4163},{ 2689, 4210},{ 3077, 4239}, + { 3466, 4258},{ 3840, 4278},{ 4205, 4298},{ 4515, 4340} + } + }, + { + /*Cr qi=47 INTRA*/ + { + { 19, 7},{ 138, 392},{ 248, 758},{ 396, 1094}, + { 563, 1378},{ 723, 1621},{ 881, 1829},{ 1037, 2011}, + { 1214, 2165},{ 1410, 2290},{ 1623, 2393},{ 1834, 2480}, + { 2016, 2564},{ 2203, 2647},{ 2405, 2707},{ 2569, 2757}, + { 2709, 2810},{ 2871, 2860},{ 3027, 2924},{ 3178, 2980}, + { 3375, 3034},{ 3563, 3097},{ 3724, 3151},{ 3952, 3153} + }, + /*Cr qi=47 INTER*/ + { + { 91, 1},{ 100, 351},{ 102, 681},{ 120, 1043}, + { 144, 1397},{ 175, 1729},{ 219, 2049},{ 277, 2356}, + { 353, 2640},{ 451, 2902},{ 579, 3136},{ 739, 3342}, + { 926, 3525},{ 1125, 3698},{ 1343, 3859},{ 1595, 3998}, + { 1881, 4113},{ 2208, 4205},{ 2589, 4253},{ 3014, 4250}, + { 3444, 4220},{ 3838, 4183},{ 4196, 4147},{ 4521, 4116} + } + } + }, + { + { + /*Y' qi=48 INTRA*/ + { + { 107, 87},{ 681, 1200},{ 1456, 1883},{ 2306, 2193}, + { 3122, 2386},{ 3984, 2548},{ 4862, 2693},{ 5704, 2808}, + { 6495, 2899},{ 7232, 2970},{ 7915, 3018},{ 8524, 3034}, + { 9085, 3043},{ 9635, 3068},{10192, 3108},{10735, 3145}, + {11237, 3171},{11719, 3194},{12153, 3207},{12516, 3206}, + {12888, 3202},{13266, 3210},{13637, 3218},{14101, 3219} + }, + /*Y' qi=48 INTER*/ + { + { 83, -18},{ 147, 1328},{ 398, 2519},{ 923, 3468}, + { 1979, 4047},{ 3472, 4246},{ 4936, 4232},{ 6148, 4178}, + { 7150, 4139},{ 8007, 4111},{ 8765, 4091},{ 9458, 4076}, + {10090, 4063},{10676, 4054},{11226, 4045},{11742, 4038}, + {12223, 4033},{12686, 4029},{13127, 4022},{13527, 4015}, + {13915, 4012},{14277, 4007},{14619, 4004},{14966, 4001} + } + }, + { + /*Cb qi=48 INTRA*/ + { + { 11, 2},{ 134, 369},{ 245, 730},{ 373, 1075}, + { 531, 1374},{ 698, 1625},{ 865, 1839},{ 1033, 2019}, + { 1207, 2173},{ 1397, 2300},{ 1588, 2408},{ 1795, 2501}, + { 2003, 2581},{ 2187, 2666},{ 2362, 2757},{ 2548, 2841}, + { 2719, 2912},{ 2876, 2983},{ 3034, 3047},{ 3209, 3097}, + { 3409, 3137},{ 3589, 3178},{ 3762, 3216},{ 4004, 3252} + }, + /*Cb qi=48 INTER*/ + { + { 113, 26},{ 112, 344},{ 111, 668},{ 120, 1032}, + { 141, 1392},{ 173, 1727},{ 224, 2036},{ 290, 2330}, + { 363, 2612},{ 447, 2880},{ 551, 3130},{ 685, 3358}, + { 852, 3563},{ 1061, 3742},{ 1332, 3884},{ 1654, 3993}, + { 2011, 4068},{ 2394, 4120},{ 2782, 4160},{ 3172, 4186}, + { 3557, 4209},{ 3932, 4228},{ 4306, 4237},{ 4675, 4236} + } + }, + { + /*Cr qi=48 INTRA*/ + { + { 18, 7},{ 139, 389},{ 252, 755},{ 404, 1090}, + { 573, 1372},{ 732, 1615},{ 889, 1823},{ 1045, 2005}, + { 1222, 2159},{ 1417, 2285},{ 1631, 2387},{ 1843, 2474}, + { 2027, 2558},{ 2212, 2639},{ 2413, 2697},{ 2578, 2746}, + { 2720, 2798},{ 2887, 2852},{ 3040, 2913},{ 3181, 2970}, + { 3381, 3024},{ 3581, 3081},{ 3743, 3130},{ 3948, 3133} + }, + /*Cr qi=48 INTER*/ + { + { 89, 0},{ 106, 352},{ 105, 682},{ 120, 1044}, + { 144, 1395},{ 174, 1724},{ 215, 2044},{ 270, 2350}, + { 343, 2635},{ 441, 2895},{ 571, 3129},{ 735, 3334}, + { 926, 3518},{ 1139, 3684},{ 1371, 3836},{ 1628, 3977}, + { 1933, 4089},{ 2279, 4164},{ 2672, 4204},{ 3105, 4205}, + { 3533, 4176},{ 3931, 4135},{ 4290, 4089},{ 4624, 4057} + } + } + }, + { + { + /*Y' qi=49 INTRA*/ + { + { 120, 85},{ 706, 1194},{ 1485, 1875},{ 2348, 2187}, + { 3190, 2372},{ 4076, 2521},{ 4967, 2658},{ 5819, 2771}, + { 6611, 2861},{ 7345, 2936},{ 8026, 2990},{ 8626, 3013}, + { 9182, 3030},{ 9723, 3059},{10266, 3100},{10802, 3143}, + {11293, 3179},{11768, 3206},{12201, 3221},{12556, 3225}, + {12914, 3226},{13281, 3237},{13639, 3247},{14089, 3257} + }, + /*Y' qi=49 INTER*/ + { + { 72, -11},{ 155, 1320},{ 458, 2485},{ 1090, 3386}, + { 2284, 3907},{ 3835, 4075},{ 5272, 4064},{ 6449, 4026}, + { 7426, 4003},{ 8267, 3987},{ 9017, 3976},{ 9698, 3967}, + {10328, 3962},{10913, 3959},{11452, 3954},{11961, 3950}, + {12442, 3947},{12904, 3946},{13347, 3945},{13749, 3943}, + {14123, 3941},{14490, 3941},{14826, 3939},{15153, 3937} + } + }, + { + /*Cb qi=49 INTRA*/ + { + { 11, 2},{ 145, 369},{ 262, 729},{ 393, 1070}, + { 557, 1363},{ 731, 1607},{ 907, 1811},{ 1085, 1983}, + { 1268, 2130},{ 1465, 2251},{ 1658, 2359},{ 1868, 2454}, + { 2079, 2534},{ 2264, 2621},{ 2440, 2717},{ 2625, 2802}, + { 2792, 2878},{ 2945, 2954},{ 3106, 3021},{ 3277, 3075}, + { 3466, 3119},{ 3638, 3170},{ 3824, 3213},{ 4100, 3243} + }, + /*Cb qi=49 INTER*/ + { + { 98, -6},{ 113, 343},{ 110, 669},{ 122, 1029}, + { 149, 1380},{ 192, 1706},{ 258, 2007},{ 340, 2293}, + { 426, 2569},{ 525, 2831},{ 653, 3071},{ 814, 3287}, + { 1013, 3478},{ 1262, 3637},{ 1575, 3761},{ 1936, 3851}, + { 2328, 3910},{ 2741, 3949},{ 3163, 3970},{ 3559, 3994}, + { 3936, 4025},{ 4300, 4050},{ 4655, 4060},{ 4962, 4062} + } + }, + { + /*Cr qi=49 INTRA*/ + { + { 19, 7},{ 151, 389},{ 270, 753},{ 427, 1084}, + { 602, 1360},{ 767, 1595},{ 933, 1794},{ 1098, 1968}, + { 1285, 2115},{ 1489, 2237},{ 1699, 2342},{ 1912, 2435}, + { 2101, 2519},{ 2288, 2601},{ 2486, 2663},{ 2651, 2715}, + { 2799, 2769},{ 2958, 2825},{ 3106, 2890},{ 3257, 2948}, + { 3452, 3007},{ 3634, 3075},{ 3786, 3136},{ 3959, 3164} + }, + /*Cr qi=49 INTER*/ + { + { 85, 1},{ 103, 352},{ 104, 681},{ 121, 1039}, + { 152, 1382},{ 195, 1702},{ 248, 2015},{ 316, 2316}, + { 403, 2595},{ 520, 2847},{ 676, 3068},{ 870, 3258}, + { 1091, 3429},{ 1329, 3585},{ 1597, 3725},{ 1894, 3849}, + { 2242, 3940},{ 2656, 3984},{ 3098, 3992},{ 3531, 3981}, + { 3936, 3950},{ 4304, 3915},{ 4646, 3879},{ 4915, 3861} + } + } + }, + { + { + /*Y' qi=50 INTRA*/ + { + { 122, 89},{ 798, 1170},{ 1682, 1812},{ 2613, 2096}, + { 3501, 2260},{ 4430, 2388},{ 5352, 2510},{ 6228, 2613}, + { 7043, 2698},{ 7793, 2770},{ 8486, 2823},{ 9092, 2846}, + { 9652, 2865},{10210, 2895},{10773, 2936},{11315, 2979}, + {11817, 3014},{12297, 3041},{12734, 3057},{13097, 3064}, + {13443, 3067},{13813, 3078},{14190, 3088},{14646, 3103} + }, + /*Y' qi=50 INTER*/ + { + { 73, -11},{ 154, 1318},{ 501, 2457},{ 1281, 3291}, + { 2685, 3719},{ 4356, 3810},{ 5811, 3769},{ 6988, 3726}, + { 7976, 3700},{ 8835, 3682},{ 9606, 3669},{10307, 3659}, + {10953, 3652},{11556, 3645},{12115, 3643},{12641, 3640}, + {13138, 3636},{13613, 3634},{14068, 3629},{14488, 3627}, + {14876, 3625},{15237, 3621},{15585, 3623},{15922, 3629} + } + }, + { + /*Cb qi=50 INTRA*/ + { + { 11, 2},{ 148, 368},{ 278, 724},{ 431, 1052}, + { 613, 1334},{ 806, 1567},{ 1004, 1756},{ 1203, 1915}, + { 1405, 2051},{ 1621, 2163},{ 1833, 2262},{ 2059, 2347}, + { 2280, 2424},{ 2476, 2512},{ 2670, 2598},{ 2864, 2679}, + { 3037, 2754},{ 3201, 2826},{ 3376, 2887},{ 3562, 2936}, + { 3756, 2976},{ 3932, 3022},{ 4117, 3065},{ 4385, 3094} + }, + /*Cb qi=50 INTER*/ + { + { 92, -3},{ 112, 343},{ 109, 669},{ 121, 1027}, + { 149, 1375},{ 196, 1697},{ 270, 1992},{ 366, 2267}, + { 471, 2532},{ 594, 2782},{ 747, 3011},{ 942, 3212}, + { 1189, 3384},{ 1497, 3521},{ 1875, 3613},{ 2297, 3673}, + { 2739, 3710},{ 3195, 3725},{ 3644, 3737},{ 4057, 3751}, + { 4445, 3763},{ 4841, 3769},{ 5211, 3779},{ 5568, 3769} + } + }, + { + /*Cr qi=50 INTRA*/ + { + { 19, 7},{ 155, 388},{ 290, 744},{ 474, 1060}, + { 666, 1324},{ 847, 1549},{ 1033, 1737},{ 1219, 1898}, + { 1428, 2034},{ 1653, 2147},{ 1885, 2245},{ 2115, 2329}, + { 2316, 2410},{ 2517, 2486},{ 2730, 2539},{ 2901, 2586}, + { 3042, 2638},{ 3199, 2693},{ 3366, 2755},{ 3534, 2805}, + { 3738, 2858},{ 3934, 2916},{ 4079, 2975},{ 4257, 2992} + }, + /*Cr qi=50 INTER*/ + { + { 87, 1},{ 102, 353},{ 103, 680},{ 121, 1036}, + { 153, 1377},{ 199, 1694},{ 260, 1999},{ 339, 2291}, + { 446, 2559},{ 590, 2797},{ 780, 3003},{ 1010, 3176}, + { 1267, 3331},{ 1547, 3474},{ 1874, 3594},{ 2245, 3688}, + { 2666, 3742},{ 3130, 3758},{ 3594, 3748},{ 4028, 3711}, + { 4415, 3674},{ 4771, 3641},{ 5122, 3605},{ 5482, 3569} + } + } + }, + { + { + /*Y' qi=51 INTRA*/ + { + { 115, 93},{ 819, 1164},{ 1739, 1806},{ 2695, 2101}, + { 3612, 2257},{ 4552, 2374},{ 5479, 2490},{ 6352, 2593}, + { 7158, 2683},{ 7898, 2761},{ 8580, 2823},{ 9177, 2854}, + { 9728, 2880},{10268, 2917},{10816, 2966},{11350, 3016}, + {11834, 3058},{12311, 3089},{12741, 3109},{13092, 3119}, + {13434, 3126},{13791, 3142},{14156, 3155},{14590, 3171} + }, + /*Y' qi=51 INTER*/ + { + { 58, 0},{ 171, 1307},{ 610, 2407},{ 1563, 3175}, + { 3116, 3545},{ 4789, 3624},{ 6185, 3602},{ 7320, 3583}, + { 8282, 3574},{ 9124, 3569},{ 9878, 3567},{10569, 3565}, + {11207, 3563},{11801, 3564},{12359, 3566},{12884, 3567}, + {13373, 3568},{13841, 3567},{14289, 3566},{14699, 3568}, + {15086, 3568},{15446, 3566},{15788, 3564},{16103, 3568} + } + }, + { + /*Cb qi=51 INTRA*/ + { + { 14, 3},{ 161, 369},{ 297, 722},{ 454, 1047}, + { 639, 1325},{ 833, 1554},{ 1033, 1742},{ 1236, 1897}, + { 1440, 2032},{ 1653, 2148},{ 1860, 2253},{ 2077, 2347}, + { 2288, 2432},{ 2476, 2525},{ 2661, 2621},{ 2841, 2714}, + { 3010, 2797},{ 3170, 2876},{ 3333, 2945},{ 3510, 3000}, + { 3696, 3054},{ 3865, 3114},{ 4046, 3164},{ 4317, 3200} + }, + /*Cb qi=51 INTER*/ + { + { 88, -11},{ 109, 341},{ 109, 668},{ 126, 1019}, + { 168, 1358},{ 233, 1670},{ 329, 1955},{ 451, 2219}, + { 584, 2472},{ 736, 2711},{ 931, 2923},{ 1179, 3104}, + { 1480, 3254},{ 1846, 3368},{ 2265, 3448},{ 2714, 3501}, + { 3180, 3524},{ 3638, 3529},{ 4074, 3543},{ 4485, 3560}, + { 4868, 3571},{ 5238, 3581},{ 5597, 3594},{ 5953, 3591} + } + }, + { + /*Cr qi=51 INTRA*/ + { + { 24, 7},{ 168, 388},{ 309, 742},{ 496, 1054}, + { 688, 1316},{ 873, 1538},{ 1063, 1723},{ 1252, 1882}, + { 1460, 2018},{ 1682, 2134},{ 1907, 2238},{ 2125, 2332}, + { 2317, 2422},{ 2507, 2510},{ 2705, 2575},{ 2869, 2630}, + { 3015, 2684},{ 3178, 2744},{ 3329, 2815},{ 3477, 2878}, + { 3667, 2945},{ 3848, 3016},{ 3997, 3082},{ 4174, 3121} + }, + /*Cr qi=51 INTER*/ + { + { 83, -2},{ 102, 351},{ 102, 680},{ 126, 1029}, + { 172, 1359},{ 238, 1665},{ 321, 1962},{ 422, 2246}, + { 552, 2505},{ 733, 2728},{ 970, 2912},{ 1247, 3069}, + { 1552, 3209},{ 1876, 3338},{ 2251, 3440},{ 2692, 3502}, + { 3161, 3529},{ 3637, 3525},{ 4084, 3509},{ 4487, 3479}, + { 4850, 3444},{ 5181, 3419},{ 5507, 3406},{ 5786, 3398} + } + } + }, + { + { + /*Y' qi=52 INTRA*/ + { + { 117, 93},{ 814, 1168},{ 1729, 1822},{ 2706, 2119}, + { 3655, 2262},{ 4604, 2374},{ 5528, 2490},{ 6394, 2596}, + { 7189, 2691},{ 7921, 2777},{ 8596, 2846},{ 9184, 2885}, + { 9728, 2918},{10260, 2961},{10796, 3014},{11316, 3069}, + {11793, 3115},{12267, 3150},{12692, 3172},{13037, 3185}, + {13367, 3196},{13717, 3214},{14087, 3227},{14521, 3249} + }, + /*Y' qi=52 INTER*/ + { + { 52, 0},{ 169, 1308},{ 668, 2382},{ 1735, 3112}, + { 3384, 3451},{ 5077, 3519},{ 6461, 3506},{ 7587, 3496}, + { 8545, 3494},{ 9384, 3494},{10142, 3498},{10838, 3501}, + {11475, 3503},{12078, 3508},{12640, 3511},{13162, 3513}, + {13654, 3517},{14130, 3521},{14576, 3522},{14980, 3523}, + {15369, 3523},{15737, 3522},{16071, 3521},{16382, 3516} + } + }, + { + /*Cb qi=52 INTRA*/ + { + { 14, 3},{ 163, 369},{ 299, 722},{ 457, 1044}, + { 645, 1319},{ 843, 1545},{ 1050, 1728},{ 1261, 1879}, + { 1468, 2013},{ 1678, 2132},{ 1883, 2240},{ 2093, 2338}, + { 2301, 2428},{ 2488, 2523},{ 2667, 2619},{ 2843, 2718}, + { 3010, 2805},{ 3163, 2887},{ 3323, 2963},{ 3490, 3028}, + { 3665, 3087},{ 3841, 3145},{ 4011, 3197},{ 4289, 3230} + }, + /*Cb qi=52 INTER*/ + { + { 98, -7},{ 109, 342},{ 109, 668},{ 126, 1018}, + { 170, 1355},{ 242, 1663},{ 352, 1941},{ 490, 2195}, + { 642, 2439},{ 823, 2666},{ 1052, 2868},{ 1333, 3039}, + { 1670, 3178},{ 2074, 3280},{ 2524, 3348},{ 2996, 3390}, + { 3469, 3410},{ 3923, 3420},{ 4355, 3434},{ 4771, 3451}, + { 5166, 3468},{ 5532, 3483},{ 5885, 3499},{ 6263, 3501} + } + }, + { + /*Cr qi=52 INTRA*/ + { + { 25, 7},{ 170, 388},{ 312, 741},{ 500, 1051}, + { 694, 1310},{ 883, 1529},{ 1082, 1709},{ 1280, 1864}, + { 1491, 1998},{ 1710, 2117},{ 1932, 2225},{ 2143, 2324}, + { 2328, 2418},{ 2516, 2506},{ 2708, 2578},{ 2870, 2637}, + { 3017, 2693},{ 3170, 2758},{ 3312, 2835},{ 3455, 2901}, + { 3644, 2972},{ 3827, 3049},{ 3968, 3121},{ 4115, 3166} + }, + /*Cr qi=52 INTER*/ + { + { 86, -2},{ 101, 352},{ 100, 680},{ 126, 1028}, + { 175, 1356},{ 247, 1657},{ 341, 1948},{ 458, 2224}, + { 615, 2471},{ 828, 2681},{ 1091, 2857},{ 1395, 3008}, + { 1732, 3140},{ 2095, 3257},{ 2502, 3348},{ 2968, 3402}, + { 3457, 3420},{ 3926, 3413},{ 4360, 3388},{ 4759, 3357}, + { 5128, 3329},{ 5449, 3306},{ 5741, 3295},{ 6071, 3296} + } + } + }, + { + { + /*Y' qi=53 INTRA*/ + { + { 138, 93},{ 850, 1161},{ 1773, 1810},{ 2763, 2103}, + { 3722, 2245},{ 4675, 2360},{ 5600, 2483},{ 6464, 2597}, + { 7255, 2700},{ 7982, 2792},{ 8652, 2867},{ 9237, 2913}, + { 9775, 2950},{10302, 2998},{10834, 3058},{11347, 3121}, + {11826, 3169},{12299, 3207},{12713, 3235},{13054, 3250}, + {13387, 3265},{13744, 3286},{14110, 3302},{14515, 3323} + }, + /*Y' qi=53 INTER*/ + { + { 52, 2},{ 169, 1308},{ 680, 2377},{ 1763, 3103}, + { 3410, 3450},{ 5094, 3531},{ 6469, 3526},{ 7590, 3525}, + { 8547, 3530},{ 9385, 3534},{10139, 3540},{10835, 3548}, + {11479, 3553},{12075, 3559},{12634, 3565},{13159, 3570}, + {13650, 3573},{14124, 3576},{14575, 3580},{14993, 3583}, + {15375, 3584},{15744, 3584},{16091, 3583},{16421, 3586} + } + }, + { + /*Cb qi=53 INTRA*/ + { + { 14, 3},{ 167, 367},{ 317, 717},{ 492, 1033}, + { 687, 1306},{ 887, 1531},{ 1095, 1715},{ 1309, 1866}, + { 1517, 2000},{ 1729, 2119},{ 1932, 2227},{ 2146, 2325}, + { 2358, 2414},{ 2544, 2511},{ 2724, 2611},{ 2902, 2711}, + { 3070, 2800},{ 3227, 2878},{ 3381, 2954},{ 3548, 3021}, + { 3724, 3077},{ 3888, 3140},{ 4065, 3196},{ 4359, 3225} + }, + /*Cb qi=53 INTER*/ + { + { 93, -8},{ 110, 342},{ 108, 668},{ 125, 1018}, + { 170, 1355},{ 242, 1663},{ 353, 1939},{ 494, 2192}, + { 651, 2433},{ 838, 2658},{ 1076, 2856},{ 1368, 3022}, + { 1716, 3158},{ 2123, 3260},{ 2575, 3330},{ 3042, 3373}, + { 3507, 3396},{ 3962, 3413},{ 4394, 3430},{ 4797, 3452}, + { 5169, 3476},{ 5547, 3496},{ 5914, 3510},{ 6235, 3525} + } + }, + { + /*Cr qi=53 INTRA*/ + { + { 25, 7},{ 175, 386},{ 335, 734},{ 541, 1037}, + { 737, 1296},{ 926, 1516},{ 1125, 1696},{ 1324, 1851}, + { 1540, 1984},{ 1763, 2102},{ 1989, 2210},{ 2202, 2310}, + { 2386, 2404},{ 2572, 2495},{ 2768, 2569},{ 2929, 2627}, + { 3071, 2684},{ 3231, 2749},{ 3374, 2825},{ 3514, 2894}, + { 3703, 2963},{ 3882, 3040},{ 4024, 3111},{ 4190, 3150} + }, + /*Cr qi=53 INTER*/ + { + { 87, -1},{ 99, 352},{ 100, 680},{ 125, 1027}, + { 175, 1355},{ 249, 1657},{ 343, 1946},{ 462, 2220}, + { 624, 2465},{ 844, 2671},{ 1122, 2841},{ 1435, 2989}, + { 1768, 3125},{ 2134, 3243},{ 2545, 3334},{ 3002, 3393}, + { 3490, 3412},{ 3965, 3405},{ 4401, 3384},{ 4797, 3359}, + { 5156, 3328},{ 5482, 3297},{ 5800, 3292},{ 6135, 3293} + } + } + }, + { + { + /*Y' qi=54 INTRA*/ + { + { 184, 94},{ 902, 1151},{ 1876, 1776},{ 2881, 2057}, + { 3832, 2200},{ 4785, 2315},{ 5709, 2442},{ 6570, 2562}, + { 7362, 2672},{ 8092, 2771},{ 8760, 2852},{ 9337, 2901}, + { 9874, 2943},{10402, 2995},{10928, 3059},{11443, 3126}, + {11926, 3178},{12396, 3220},{12805, 3251},{13139, 3266}, + {13466, 3280},{13822, 3304},{14184, 3322},{14585, 3342} + }, + /*Y' qi=54 INTER*/ + { + { 60, 5},{ 169, 1308},{ 683, 2375},{ 1791, 3090}, + { 3478, 3412},{ 5184, 3470},{ 6568, 3455},{ 7697, 3446}, + { 8659, 3446},{ 9503, 3447},{10266, 3450},{10971, 3454}, + {11619, 3458},{12223, 3462},{12789, 3467},{13315, 3471}, + {13811, 3475},{14291, 3479},{14743, 3479},{15148, 3481}, + {15535, 3483},{15913, 3481},{16252, 3479},{16569, 3472} + } + }, + { + /*Cb qi=54 INTRA*/ + { + { 13, 2},{ 165, 367},{ 318, 715},{ 498, 1030}, + { 698, 1301},{ 906, 1523},{ 1121, 1703},{ 1336, 1853}, + { 1549, 1984},{ 1765, 2100},{ 1974, 2207},{ 2192, 2306}, + { 2402, 2396},{ 2587, 2493},{ 2773, 2591},{ 2953, 2691}, + { 3119, 2778},{ 3277, 2858},{ 3430, 2940},{ 3603, 3004}, + { 3788, 3059},{ 3950, 3121},{ 4128, 3173},{ 4398, 3215} + }, + /*Cb qi=54 INTER*/ + { + { 100, -3},{ 109, 343},{ 107, 668},{ 125, 1018}, + { 169, 1354},{ 241, 1662},{ 353, 1938},{ 496, 2190}, + { 655, 2431},{ 843, 2655},{ 1082, 2851},{ 1381, 3015}, + { 1739, 3146},{ 2154, 3243},{ 2610, 3310},{ 3094, 3344}, + { 3581, 3358},{ 4034, 3371},{ 4457, 3384},{ 4867, 3399}, + { 5255, 3413},{ 5630, 3425},{ 6003, 3440},{ 6346, 3440} + } + }, + { + /*Cr qi=54 INTRA*/ + { + { 23, 7},{ 174, 386},{ 338, 732},{ 549, 1034}, + { 751, 1289},{ 947, 1506},{ 1150, 1685},{ 1353, 1837}, + { 1572, 1969},{ 1800, 2087},{ 2031, 2192},{ 2248, 2291}, + { 2434, 2387},{ 2622, 2477},{ 2815, 2549},{ 2976, 2607}, + { 3126, 2663},{ 3286, 2727},{ 3427, 2807},{ 3569, 2877}, + { 3761, 2941},{ 3942, 3016},{ 4084, 3093},{ 4226, 3131} + }, + /*Cr qi=54 INTER*/ + { + { 88, -2},{ 99, 351},{ 100, 680},{ 125, 1027}, + { 175, 1354},{ 248, 1656},{ 343, 1945},{ 463, 2219}, + { 626, 2463},{ 850, 2668},{ 1128, 2837},{ 1445, 2983}, + { 1791, 3111},{ 2168, 3224},{ 2597, 3309},{ 3075, 3351}, + { 3560, 3364},{ 4029, 3356},{ 4464, 3335},{ 4858, 3307}, + { 5218, 3275},{ 5547, 3256},{ 5850, 3247},{ 6171, 3214} + } + } + }, + { + { + /*Y' qi=55 INTRA*/ + { + { 178, 95},{ 968, 1137},{ 2000, 1747},{ 3013, 2027}, + { 3966, 2173},{ 4920, 2294},{ 5842, 2427},{ 6702, 2553}, + { 7489, 2668},{ 8213, 2773},{ 8875, 2858},{ 9452, 2913}, + { 9986, 2959},{10504, 3016},{11023, 3085},{11530, 3157}, + {12011, 3213},{12480, 3257},{12882, 3291},{13214, 3310}, + {13542, 3325},{13890, 3350},{14248, 3371},{14671, 3398} + }, + /*Y' qi=55 INTER*/ + { + { 59, 5},{ 170, 1307},{ 725, 2358},{ 1886, 3058}, + { 3589, 3385},{ 5284, 3459},{ 6654, 3458},{ 7771, 3461}, + { 8727, 3470},{ 9564, 3478},{10322, 3488},{11019, 3497}, + {11658, 3505},{12258, 3513},{12819, 3520},{13344, 3527}, + {13840, 3533},{14314, 3537},{14755, 3541},{15161, 3544}, + {15552, 3548},{15916, 3548},{16257, 3548},{16576, 3540} + } + }, + { + /*Cb qi=55 INTRA*/ + { + { 13, 2},{ 167, 366},{ 322, 714},{ 508, 1026}, + { 716, 1292},{ 930, 1511},{ 1148, 1690},{ 1366, 1839}, + { 1578, 1972},{ 1793, 2090},{ 2001, 2199},{ 2217, 2300}, + { 2427, 2393},{ 2609, 2495},{ 2784, 2600},{ 2961, 2704}, + { 3121, 2797},{ 3268, 2884},{ 3423, 2965},{ 3590, 3032}, + { 3764, 3096},{ 3926, 3165},{ 4101, 3223},{ 4405, 3258} + }, + /*Cb qi=55 INTER*/ + { + { 90, -4},{ 109, 344},{ 107, 668},{ 126, 1017}, + { 172, 1351},{ 249, 1657},{ 370, 1928},{ 527, 2174}, + { 702, 2407},{ 909, 2624},{ 1170, 2814},{ 1493, 2970}, + { 1869, 3097},{ 2292, 3192},{ 2752, 3258},{ 3232, 3295}, + { 3709, 3314},{ 4156, 3335},{ 4592, 3355},{ 5004, 3373}, + { 5377, 3389},{ 5737, 3411},{ 6092, 3432},{ 6473, 3423} + } + }, + { + /*Cr qi=55 INTRA*/ + { + { 23, 7},{ 175, 385},{ 342, 730},{ 561, 1028}, + { 771, 1279},{ 973, 1493},{ 1181, 1669},{ 1384, 1822}, + { 1602, 1956},{ 1830, 2076},{ 2057, 2184},{ 2270, 2288}, + { 2452, 2389},{ 2637, 2484},{ 2823, 2559},{ 2983, 2621}, + { 3129, 2682},{ 3280, 2753},{ 3417, 2833},{ 3554, 2904}, + { 3743, 2977},{ 3921, 3060},{ 4055, 3137},{ 4185, 3186} + }, + /*Cr qi=55 INTER*/ + { + { 85, 0},{ 99, 352},{ 100, 679},{ 126, 1025}, + { 178, 1351},{ 256, 1650},{ 359, 1935},{ 493, 2202}, + { 675, 2439},{ 921, 2636},{ 1220, 2799},{ 1552, 2941}, + { 1910, 3068},{ 2303, 3177},{ 2735, 3262},{ 3206, 3311}, + { 3689, 3333},{ 4152, 3327},{ 4588, 3299},{ 4978, 3272}, + { 5325, 3243},{ 5651, 3221},{ 5969, 3210},{ 6218, 3185} + } + } + }, + { + { + /*Y' qi=56 INTRA*/ + { + { 137, 104},{ 1048, 1128},{ 2147, 1760},{ 3261, 2029}, + { 4319, 2131},{ 5310, 2234},{ 6245, 2351},{ 7101, 2464}, + { 7886, 2572},{ 8610, 2675},{ 9270, 2762},{ 9840, 2818}, + {10365, 2869},{10875, 2928},{11393, 2997},{11900, 3071}, + {12371, 3128},{12834, 3172},{13233, 3208},{13562, 3228}, + {13878, 3245},{14221, 3271},{14584, 3292},{15008, 3320} + }, + /*Y' qi=56 INTER*/ + { + { 19, 21},{ 207, 1292},{ 1031, 2252},{ 2553, 2846}, + { 4463, 3085},{ 6137, 3131},{ 7441, 3151},{ 8526, 3172}, + { 9468, 3193},{10301, 3209},{11059, 3224},{11760, 3237}, + {12405, 3249},{13008, 3261},{13570, 3270},{14100, 3278}, + {14597, 3284},{15074, 3289},{15524, 3297},{15929, 3302}, + {16314, 3306},{16675, 3307},{17004, 3305},{17288, 3301} + } + }, + { + /*Cb qi=56 INTRA*/ + { + { 16, 3},{ 188, 367},{ 353, 712},{ 546, 1017}, + { 765, 1275},{ 989, 1484},{ 1221, 1653},{ 1459, 1791}, + { 1681, 1920},{ 1893, 2046},{ 2102, 2160},{ 2323, 2257}, + { 2534, 2347},{ 2720, 2447},{ 2902, 2549},{ 3075, 2654}, + { 3239, 2749},{ 3392, 2835},{ 3544, 2920},{ 3712, 2988}, + { 3882, 3052},{ 4052, 3123},{ 4227, 3181},{ 4483, 3213} + }, + /*Cb qi=56 INTER*/ + { + { 92, -1},{ 111, 343},{ 114, 665},{ 148, 1003}, + { 224, 1321},{ 345, 1609},{ 526, 1858},{ 754, 2077}, + { 1009, 2281},{ 1319, 2464},{ 1702, 2614},{ 2145, 2732}, + { 2625, 2824},{ 3123, 2890},{ 3634, 2933},{ 4137, 2954}, + { 4614, 2965},{ 5052, 2988},{ 5468, 3015},{ 5852, 3035}, + { 6213, 3060},{ 6557, 3081},{ 6906, 3094},{ 7243, 3112} + } + }, + { + /*Cr qi=56 INTRA*/ + { + { 28, 8},{ 195, 385},{ 373, 727},{ 598, 1019}, + { 816, 1263},{ 1033, 1465},{ 1260, 1630},{ 1482, 1773}, + { 1717, 1900},{ 1949, 2018},{ 2178, 2128},{ 2393, 2233}, + { 2570, 2338},{ 2749, 2435},{ 2937, 2514},{ 3097, 2577}, + { 3240, 2638},{ 3398, 2709},{ 3540, 2791},{ 3673, 2865}, + { 3869, 2938},{ 4049, 3019},{ 4179, 3095},{ 4330, 3137} + }, + /*Cr qi=56 INTER*/ + { + { 83, 0},{ 99, 353},{ 103, 676},{ 146, 1010}, + { 232, 1320},{ 355, 1601},{ 512, 1866},{ 713, 2109}, + { 988, 2312},{ 1344, 2471},{ 1750, 2602},{ 2180, 2719}, + { 2642, 2819},{ 3141, 2892},{ 3653, 2939},{ 4159, 2961}, + { 4636, 2961},{ 5072, 2945},{ 5464, 2917},{ 5813, 2895}, + { 6134, 2890},{ 6458, 2883},{ 6735, 2881},{ 6953, 2902} + } + } + }, + { + { + /*Y' qi=57 INTRA*/ + { + { 170, 106},{ 1106, 1120},{ 2246, 1740},{ 3399, 1993}, + { 4482, 2077},{ 5492, 2167},{ 6446, 2273},{ 7324, 2379}, + { 8130, 2482},{ 8866, 2578},{ 9537, 2661},{10119, 2715}, + {10646, 2762},{11161, 2820},{11694, 2886},{12214, 2957}, + {12693, 3013},{13166, 3053},{13569, 3087},{13897, 3106}, + {14224, 3122},{14568, 3148},{14931, 3167},{15390, 3192} + }, + /*Y' qi=57 INTER*/ + { + { 19, 20},{ 205, 1292},{ 1096, 2229},{ 2775, 2766}, + { 4811, 2943},{ 6512, 2964},{ 7832, 2976},{ 8940, 2990}, + { 9903, 3004},{10755, 3017},{11532, 3029},{12243, 3039}, + {12891, 3047},{13502, 3058},{14073, 3065},{14603, 3071}, + {15097, 3078},{15581, 3083},{16036, 3086},{16452, 3090}, + {16855, 3093},{17222, 3094},{17552, 3092},{17851, 3098} + } + }, + { + /*Cb qi=57 INTRA*/ + { + { 16, 3},{ 197, 365},{ 384, 704},{ 603, 1001}, + { 837, 1252},{ 1077, 1455},{ 1326, 1618},{ 1581, 1748}, + { 1819, 1871},{ 2042, 1993},{ 2264, 2104},{ 2500, 2196}, + { 2722, 2280},{ 2916, 2375},{ 3103, 2473},{ 3290, 2575}, + { 3456, 2667},{ 3612, 2748},{ 3775, 2829},{ 3958, 2896}, + { 4145, 2947},{ 4307, 3012},{ 4476, 3070},{ 4733, 3110} + }, + /*Cb qi=57 INTER*/ + { + { 94, -1},{ 111, 344},{ 112, 665},{ 147, 1002}, + { 227, 1319},{ 353, 1604},{ 543, 1849},{ 785, 2062}, + { 1066, 2257},{ 1408, 2430},{ 1827, 2568},{ 2320, 2670}, + { 2848, 2743},{ 3386, 2791},{ 3934, 2812},{ 4453, 2820}, + { 4929, 2830},{ 5368, 2842},{ 5787, 2856},{ 6190, 2875}, + { 6554, 2896},{ 6895, 2913},{ 7229, 2927},{ 7572, 2932} + } + }, + { + /*Cr qi=57 INTRA*/ + { + { 28, 8},{ 207, 383},{ 413, 716},{ 661, 999}, + { 889, 1237},{ 1123, 1433},{ 1365, 1592},{ 1603, 1731}, + { 1853, 1852},{ 2103, 1965},{ 2345, 2072},{ 2571, 2173}, + { 2763, 2271},{ 2949, 2364},{ 3146, 2438},{ 3315, 2497}, + { 3459, 2552},{ 3618, 2616},{ 3767, 2697},{ 3906, 2773}, + { 4099, 2841},{ 4281, 2916},{ 4429, 2987},{ 4569, 3030} + }, + /*Cr qi=57 INTER*/ + { + { 85, 0},{ 99, 352},{ 102, 675},{ 147, 1008}, + { 235, 1317},{ 363, 1597},{ 529, 1858},{ 748, 2094}, + { 1050, 2287},{ 1439, 2436},{ 1877, 2557},{ 2352, 2660}, + { 2869, 2740},{ 3413, 2791},{ 3962, 2815},{ 4485, 2819}, + { 4955, 2816},{ 5382, 2800},{ 5769, 2772},{ 6107, 2748}, + { 6443, 2740},{ 6754, 2739},{ 7029, 2737},{ 7284, 2745} + } + } + }, + { + { + /*Y' qi=58 INTRA*/ + { + { 164, 109},{ 1198, 1111},{ 2396, 1737},{ 3606, 1978}, + { 4727, 2048},{ 5749, 2138},{ 6708, 2243},{ 7584, 2347}, + { 8388, 2449},{ 9122, 2549},{ 9784, 2635},{10354, 2691}, + {10876, 2740},{11385, 2800},{11912, 2869},{12429, 2941}, + {12902, 2997},{13375, 3040},{13779, 3075},{14103, 3096}, + {14435, 3112},{14783, 3140},{15141, 3160},{15599, 3186} + }, + /*Y' qi=58 INTER*/ + { + { 14, 23},{ 210, 1290},{ 1277, 2178},{ 3118, 2677}, + { 5207, 2834},{ 6902, 2857},{ 8218, 2878},{ 9323, 2900}, + {10285, 2919},{11132, 2934},{11899, 2949},{12599, 2961}, + {13235, 2971},{13835, 2982},{14394, 2991},{14917, 2997}, + {15412, 3005},{15882, 3009},{16325, 3013},{16735, 3016}, + {17131, 3018},{17501, 3021},{17824, 3021},{18125, 3016} + } + }, + { + /*Cb qi=58 INTRA*/ + { + { 17, 3},{ 200, 365},{ 389, 703},{ 613, 996}, + { 853, 1243},{ 1095, 1445},{ 1349, 1604},{ 1613, 1731}, + { 1853, 1853},{ 2074, 1978},{ 2292, 2091},{ 2526, 2184}, + { 2750, 2266},{ 2945, 2360},{ 3134, 2458},{ 3320, 2561}, + { 3482, 2654},{ 3641, 2737},{ 3804, 2818},{ 3985, 2881}, + { 4168, 2935},{ 4331, 3003},{ 4499, 3060},{ 4751, 3100} + }, + /*Cb qi=58 INTER*/ + { + { 94, -1},{ 112, 345},{ 112, 665},{ 152, 998}, + { 247, 1307},{ 406, 1580},{ 644, 1810},{ 938, 2007}, + { 1271, 2189},{ 1668, 2348},{ 2151, 2470},{ 2691, 2558}, + { 3249, 2619},{ 3798, 2659},{ 4334, 2682},{ 4849, 2692}, + { 5314, 2700},{ 5747, 2721},{ 6167, 2742},{ 6547, 2765}, + { 6902, 2790},{ 7251, 2804},{ 7583, 2819},{ 7924, 2833} + } + }, + { + /*Cr qi=58 INTRA*/ + { + { 29, 8},{ 210, 382},{ 419, 714},{ 671, 993}, + { 903, 1229},{ 1141, 1422},{ 1390, 1578},{ 1635, 1713}, + { 1889, 1833},{ 2140, 1946},{ 2379, 2055},{ 2604, 2157}, + { 2794, 2256},{ 2977, 2349},{ 3174, 2422},{ 3339, 2482}, + { 3483, 2537},{ 3643, 2604},{ 3790, 2684},{ 3927, 2757}, + { 4112, 2826},{ 4294, 2900},{ 4451, 2975},{ 4600, 3011} + }, + /*Cr qi=58 INTER*/ + { + { 86, 0},{ 99, 352},{ 103, 675},{ 151, 1004}, + { 256, 1306},{ 417, 1573},{ 628, 1819},{ 901, 2040}, + { 1262, 2217},{ 1705, 2353},{ 2191, 2466},{ 2713, 2556}, + { 3268, 2622},{ 3831, 2664},{ 4374, 2682},{ 4881, 2686}, + { 5339, 2685},{ 5747, 2668},{ 6123, 2646},{ 6465, 2630}, + { 6783, 2618},{ 7082, 2623},{ 7366, 2632},{ 7673, 2654} + } + } + }, + { + { + /*Y' qi=59 INTRA*/ + { + { 142, 112},{ 1259, 1100},{ 2552, 1711},{ 3815, 1933}, + { 4955, 1987},{ 5983, 2068},{ 6949, 2165},{ 7832, 2263}, + { 8645, 2359},{ 9392, 2454},{10066, 2536},{10643, 2589}, + {11174, 2636},{11696, 2693},{12230, 2758},{12752, 2826}, + {13239, 2883},{13721, 2926},{14139, 2959},{14479, 2978}, + {14811, 2993},{15166, 3020},{15532, 3039},{16000, 3062} + }, + /*Y' qi=59 INTER*/ + { + { 8, 25},{ 211, 1289},{ 1394, 2144},{ 3421, 2580}, + { 5611, 2689},{ 7316, 2701},{ 8643, 2717},{ 9762, 2734}, + {10735, 2750},{11587, 2763},{12353, 2775},{13056, 2785}, + {13693, 2793},{14288, 2805},{14843, 2814},{15361, 2821}, + {15857, 2827},{16328, 2831},{16763, 2834},{17171, 2838}, + {17568, 2840},{17941, 2842},{18285, 2843},{18586, 2839} + } + }, + { + /*Cb qi=59 INTRA*/ + { + { 17, 3},{ 224, 363},{ 441, 696},{ 689, 982}, + { 945, 1222},{ 1204, 1416},{ 1474, 1571},{ 1751, 1695}, + { 2001, 1816},{ 2228, 1941},{ 2453, 2055},{ 2693, 2147}, + { 2924, 2227},{ 3125, 2321},{ 3321, 2416},{ 3510, 2520}, + { 3676, 2616},{ 3839, 2699},{ 4008, 2778},{ 4193, 2842}, + { 4371, 2898},{ 4535, 2965},{ 4710, 3023},{ 4921, 3068} + }, + /*Cb qi=59 INTER*/ + { + { 95, -5},{ 111, 343},{ 112, 664},{ 157, 995}, + { 258, 1302},{ 429, 1569},{ 691, 1790},{ 1017, 1977}, + { 1387, 2148},{ 1832, 2294},{ 2368, 2401},{ 2961, 2472}, + { 3553, 2518},{ 4133, 2545},{ 4688, 2557},{ 5198, 2563}, + { 5663, 2574},{ 6100, 2590},{ 6511, 2608},{ 6898, 2621}, + { 7274, 2634},{ 7631, 2655},{ 7984, 2669},{ 8361, 2669} + } + }, + { + /*Cr qi=59 INTRA*/ + { + { 31, 8},{ 240, 379},{ 480, 706},{ 748, 978}, + { 993, 1208},{ 1250, 1394},{ 1519, 1543},{ 1779, 1674}, + { 2047, 1792},{ 2307, 1904},{ 2552, 2013},{ 2780, 2116}, + { 2973, 2216},{ 3165, 2309},{ 3362, 2383},{ 3528, 2444}, + { 3677, 2499},{ 3841, 2566},{ 3995, 2646},{ 4139, 2720}, + { 4324, 2793},{ 4504, 2867},{ 4658, 2939},{ 4806, 2975} + }, + /*Cr qi=59 INTER*/ + { + { 89, -3},{ 98, 352},{ 103, 674},{ 156, 1002}, + { 268, 1300},{ 441, 1562},{ 673, 1801},{ 980, 2010}, + { 1385, 2175},{ 1868, 2301},{ 2401, 2402},{ 2984, 2474}, + { 3591, 2520},{ 4179, 2545},{ 4729, 2555},{ 5232, 2553}, + { 5679, 2545},{ 6081, 2530},{ 6447, 2510},{ 6791, 2496}, + { 7101, 2487},{ 7393, 2489},{ 7684, 2499},{ 7950, 2501} + } + } + }, + { + { + /*Y' qi=60 INTRA*/ + { + { 92, 116},{ 1361, 1085},{ 2746, 1686},{ 4050, 1895}, + { 5209, 1939},{ 6244, 2012},{ 7213, 2103},{ 8105, 2197}, + { 8928, 2290},{ 9685, 2381},{10371, 2460},{10952, 2511}, + {11487, 2556},{12026, 2611},{12574, 2674},{13102, 2739}, + {13597, 2793},{14092, 2831},{14523, 2862},{14862, 2881}, + {15198, 2897},{15568, 2923},{15949, 2941},{16416, 2964} + }, + /*Y' qi=60 INTER*/ + { + { 4, 30},{ 215, 1287},{ 1547, 2104},{ 3729, 2491}, + { 5973, 2568},{ 7672, 2577},{ 9001, 2591},{10123, 2606}, + {11094, 2620},{11943, 2632},{12709, 2643},{13409, 2652}, + {14044, 2660},{14641, 2669},{15193, 2677},{15709, 2684}, + {16201, 2689},{16675, 2693},{17118, 2696},{17522, 2701}, + {17920, 2704},{18293, 2706},{18620, 2702},{18923, 2700} + } + }, + { + /*Cb qi=60 INTRA*/ + { + { 18, 3},{ 227, 362},{ 447, 694},{ 708, 974}, + { 981, 1207},{ 1252, 1397},{ 1532, 1547},{ 1822, 1663}, + { 2082, 1780},{ 2316, 1903},{ 2548, 2013},{ 2794, 2101}, + { 3029, 2178},{ 3242, 2266},{ 3445, 2360},{ 3638, 2459}, + { 3816, 2547},{ 3980, 2628},{ 4146, 2708},{ 4344, 2766}, + { 4546, 2812},{ 4725, 2872},{ 4880, 2930},{ 5054, 2966} + }, + /*Cb qi=60 INTER*/ + { + { 97, -4},{ 112, 343},{ 114, 664},{ 162, 993}, + { 273, 1294},{ 472, 1553},{ 774, 1762},{ 1138, 1939}, + { 1543, 2102},{ 2034, 2236},{ 2620, 2329},{ 3244, 2389}, + { 3860, 2423},{ 4443, 2440},{ 4997, 2449},{ 5502, 2455}, + { 5962, 2458},{ 6413, 2466},{ 6836, 2485},{ 7217, 2506}, + { 7592, 2518},{ 7957, 2533},{ 8291, 2543},{ 8574, 2545} + } + }, + { + /*Cr qi=60 INTRA*/ + { + { 32, 8},{ 243, 379},{ 488, 702},{ 771, 968}, + { 1030, 1192},{ 1300, 1373},{ 1581, 1517},{ 1854, 1643}, + { 2127, 1757},{ 2393, 1864},{ 2645, 1968},{ 2879, 2068}, + { 3078, 2166},{ 3277, 2256},{ 3484, 2325},{ 3660, 2381}, + { 3808, 2433},{ 3970, 2496},{ 4138, 2571},{ 4288, 2643}, + { 4475, 2710},{ 4655, 2778},{ 4810, 2843},{ 4959, 2879} + }, + /*Cr qi=60 INTER*/ + { + { 86, -2},{ 99, 352},{ 103, 673},{ 160, 998}, + { 284, 1292},{ 484, 1546},{ 753, 1774},{ 1100, 1973}, + { 1546, 2129},{ 2072, 2246},{ 2652, 2334},{ 3279, 2392}, + { 3911, 2425},{ 4504, 2440},{ 5044, 2443},{ 5536, 2440}, + { 5979, 2430},{ 6381, 2413},{ 6735, 2397},{ 7062, 2382}, + { 7383, 2376},{ 7680, 2375},{ 7962, 2373},{ 8203, 2379} + } + } + }, + { + { + /*Y' qi=61 INTRA*/ + { + { 54, 121},{ 1477, 1069},{ 3061, 1638},{ 4465, 1808}, + { 5649, 1827},{ 6710, 1884},{ 7716, 1958},{ 8648, 2037}, + { 9514, 2116},{10311, 2192},{11033, 2261},{11641, 2305}, + {12202, 2342},{12771, 2387},{13356, 2440},{13924, 2493}, + {14444, 2541},{14951, 2576},{15409, 2600},{15779, 2615}, + {16131, 2626},{16521, 2648},{16921, 2663},{17409, 2694} + }, + /*Y' qi=61 INTER*/ + { + { -1, 32},{ 216, 1286},{ 1806, 2036},{ 4279, 2327}, + { 6629, 2352},{ 8347, 2352},{ 9707, 2357},{10860, 2364}, + {11857, 2372},{12726, 2377},{13508, 2382},{14225, 2387}, + {14877, 2392},{15484, 2398},{16048, 2401},{16581, 2405}, + {17092, 2409},{17573, 2409},{18016, 2410},{18427, 2413}, + {18829, 2415},{19221, 2415},{19578, 2415},{19980, 2413} + } + }, + { + /*Cb qi=61 INTRA*/ + { + { 19, 3},{ 231, 362},{ 456, 693},{ 733, 965}, + { 1032, 1188},{ 1330, 1369},{ 1637, 1508},{ 1956, 1612}, + { 2241, 1718},{ 2496, 1832},{ 2750, 1932},{ 3019, 2007}, + { 3274, 2074},{ 3505, 2154},{ 3725, 2236},{ 3943, 2323}, + { 4138, 2403},{ 4323, 2476},{ 4505, 2543},{ 4706, 2592}, + { 4909, 2630},{ 5109, 2675},{ 5292, 2724},{ 5495, 2768} + }, + /*Cb qi=61 INTER*/ + { + { 91, -2},{ 111, 344},{ 114, 663},{ 166, 989}, + { 291, 1285},{ 522, 1534},{ 875, 1729},{ 1302, 1889}, + { 1786, 2031},{ 2368, 2141},{ 3042, 2207},{ 3734, 2243}, + { 4388, 2259},{ 4982, 2264},{ 5533, 2265},{ 6043, 2262}, + { 6524, 2264},{ 6982, 2274},{ 7422, 2283},{ 7831, 2295}, + { 8198, 2308},{ 8593, 2319},{ 8965, 2329},{ 9258, 2340} + } + }, + { + /*Cr qi=61 INTRA*/ + { + { 33, 9},{ 245, 378},{ 497, 699},{ 801, 958}, + { 1087, 1171},{ 1384, 1342},{ 1692, 1474},{ 1992, 1589}, + { 2290, 1692},{ 2576, 1789},{ 2852, 1884},{ 3109, 1973}, + { 3324, 2061},{ 3544, 2142},{ 3763, 2199},{ 3945, 2244}, + { 4103, 2292},{ 4283, 2349},{ 4469, 2413},{ 4635, 2476}, + { 4836, 2534},{ 5038, 2592},{ 5210, 2649},{ 5358, 2682} + }, + /*Cr qi=61 INTER*/ + { + { 82, 0},{ 97, 353},{ 104, 672},{ 165, 995}, + { 303, 1284},{ 532, 1529},{ 852, 1742},{ 1273, 1921}, + { 1798, 2057},{ 2409, 2154},{ 3090, 2212},{ 3794, 2240}, + { 4460, 2251},{ 5057, 2249},{ 5596, 2249},{ 6085, 2245}, + { 6519, 2234},{ 6908, 2220},{ 7269, 2203},{ 7618, 2196}, + { 7949, 2198},{ 8269, 2195},{ 8554, 2196},{ 8928, 2217} + } + } + }, + { + { + /*Y' qi=62 INTRA*/ + { + { 29, 124},{ 1527, 1067},{ 3221, 1618},{ 4703, 1751}, + { 5909, 1744},{ 7001, 1779},{ 8057, 1829},{ 9049, 1885}, + { 9968, 1943},{10813, 1999},{11572, 2050},{12206, 2082}, + {12801, 2107},{13402, 2140},{14020, 2180},{14625, 2223}, + {15179, 2260},{15718, 2288},{16196, 2305},{16581, 2313}, + {16963, 2324},{17382, 2341},{17800, 2351},{18318, 2376} + }, + /*Y' qi=62 INTER*/ + { + { -8, 36},{ 218, 1284},{ 2073, 1965},{ 4814, 2159}, + { 7237, 2138},{ 8979, 2124},{10378, 2115},{11570, 2109}, + {12601, 2106},{13503, 2103},{14320, 2103},{15064, 2103}, + {15746, 2103},{16384, 2104},{16975, 2105},{17534, 2105}, + {18062, 2106},{18564, 2107},{19035, 2106},{19471, 2107}, + {19890, 2107},{20288, 2107},{20651, 2107},{21012, 2108} + } + }, + { + /*Cb qi=62 INTRA*/ + { + { 21, 3},{ 283, 360},{ 565, 683},{ 907, 938}, + { 1269, 1143},{ 1611, 1311},{ 1949, 1441},{ 2290, 1535}, + { 2596, 1632},{ 2877, 1738},{ 3162, 1828},{ 3458, 1893}, + { 3745, 1948},{ 4011, 2016},{ 4253, 2089},{ 4506, 2164}, + { 4734, 2233},{ 4943, 2294},{ 5162, 2353},{ 5381, 2393}, + { 5593, 2420},{ 5807, 2454},{ 6003, 2496},{ 6210, 2543} + }, + /*Cb qi=62 INTER*/ + { + { 91, -1},{ 110, 344},{ 113, 663},{ 169, 987}, + { 306, 1279},{ 562, 1519},{ 961, 1701},{ 1450, 1845}, + { 2013, 1967},{ 2686, 2053},{ 3437, 2095},{ 4171, 2109}, + { 4841, 2109},{ 5441, 2105},{ 6002, 2097},{ 6542, 2089}, + { 7028, 2087},{ 7491, 2088},{ 7949, 2090},{ 8377, 2089}, + { 8789, 2095},{ 9195, 2103},{ 9569, 2104},{ 9937, 2102} + } + }, + { + /*Cr qi=62 INTRA*/ + { + { 38, 8},{ 308, 374},{ 619, 685},{ 984, 925}, + { 1326, 1126},{ 1662, 1285},{ 1999, 1407},{ 2328, 1512}, + { 2659, 1604},{ 2976, 1691},{ 3285, 1774},{ 3570, 1853}, + { 3815, 1931},{ 4068, 1998},{ 4304, 2044},{ 4491, 2082}, + { 4666, 2124},{ 4870, 2174},{ 5078, 2231},{ 5262, 2285}, + { 5480, 2335},{ 5703, 2378},{ 5905, 2423},{ 6075, 2454} + }, + /*Cr qi=62 INTER*/ + { + { 79, 1},{ 95, 353},{ 102, 671},{ 169, 992}, + { 318, 1277},{ 569, 1515},{ 936, 1716},{ 1428, 1876}, + { 2034, 1993},{ 2738, 2067},{ 3511, 2095},{ 4268, 2094}, + { 4943, 2087},{ 5543, 2079},{ 6074, 2074},{ 6552, 2069}, + { 6985, 2057},{ 7366, 2043},{ 7728, 2030},{ 8086, 2021}, + { 8423, 2017},{ 8752, 2016},{ 9057, 2014},{ 9376, 2008} + } + } + }, + { + { + /*Y' qi=63 INTRA*/ + { + { -59, 134},{ 1734, 1036},{ 3743, 1521},{ 5309, 1618}, + { 6520, 1597},{ 7664, 1609},{ 8809, 1630},{ 9894, 1657}, + {10907, 1687},{11838, 1717},{12673, 1744},{13379, 1758}, + {14038, 1767},{14698, 1784},{15379, 1806},{16062, 1831}, + {16694, 1852},{17300, 1867},{17827, 1878},{18250, 1881}, + {18702, 1884},{19199, 1892},{19665, 1896},{20273, 1908} + }, + /*Y' qi=63 INTER*/ + { + { -7, 33},{ 209, 1285},{ 2309, 1904},{ 5274, 2025}, + { 7801, 1966},{ 9637, 1924},{11126, 1892},{12403, 1868}, + {13515, 1849},{14491, 1834},{15380, 1822},{16197, 1814}, + {16944, 1806},{17645, 1799},{18303, 1794},{18916, 1789}, + {19494, 1785},{20056, 1782},{20568, 1779},{21047, 1776}, + {21508, 1775},{21925, 1772},{22327, 1770},{22678, 1771} + } + }, + { + /*Cb qi=63 INTRA*/ + { + { 20, 3},{ 294, 357},{ 608, 673},{ 1047, 908}, + { 1501, 1090},{ 1898, 1240},{ 2275, 1353},{ 2654, 1427}, + { 3014, 1502},{ 3366, 1579},{ 3726, 1637},{ 4084, 1674}, + { 4425, 1703},{ 4752, 1743},{ 5058, 1791},{ 5377, 1838}, + { 5676, 1877},{ 5946, 1912},{ 6213, 1945},{ 6458, 1969}, + { 6704, 1982},{ 6969, 1997},{ 7210, 2017},{ 7439, 2037} + }, + /*Cb qi=63 INTER*/ + { + { 86, 1},{ 108, 345},{ 111, 663},{ 168, 985}, + { 307, 1276},{ 577, 1513},{ 1007, 1688},{ 1550, 1819}, + { 2189, 1921},{ 2938, 1981},{ 3744, 2002},{ 4512, 2002}, + { 5199, 1996},{ 5824, 1986},{ 6419, 1971},{ 6978, 1954}, + { 7507, 1940},{ 8015, 1932},{ 8502, 1928},{ 8978, 1920}, + { 9410, 1915},{ 9842, 1910},{10262, 1901},{10634, 1896} + } + }, + { + /*Cr qi=63 INTRA*/ + { + { 38, 7},{ 324, 367},{ 677, 670},{ 1136, 892}, + { 1562, 1070},{ 1951, 1209},{ 2326, 1313},{ 2694, 1399}, + { 3074, 1471},{ 3460, 1531},{ 3850, 1575},{ 4214, 1622}, + { 4522, 1679},{ 4819, 1723},{ 5089, 1749},{ 5315, 1769}, + { 5530, 1792},{ 5756, 1825},{ 6006, 1860},{ 6244, 1889}, + { 6514, 1924},{ 6792, 1946},{ 7026, 1962},{ 7191, 1971} + }, + /*Cr qi=63 INTER*/ + { + { 80, 2},{ 95, 354},{ 101, 671},{ 167, 990}, + { 321, 1274},{ 585, 1509},{ 984, 1702},{ 1534, 1849}, + { 2217, 1947},{ 3005, 1995},{ 3839, 1999},{ 4619, 1986}, + { 5310, 1973},{ 5933, 1961},{ 6486, 1952},{ 6988, 1942}, + { 7435, 1927},{ 7817, 1911},{ 8198, 1900},{ 8552, 1895}, + { 8881, 1890},{ 9253, 1883},{ 9598, 1876},{ 9923, 1859} + } + } + } +}; + +#endif diff --git a/libs/libtheora-1.1/lib/ocintrin.h b/libs/libtheora-1.1/lib/ocintrin.h new file mode 100644 index 00000000..6e42594b --- /dev/null +++ b/libs/libtheora-1.1/lib/ocintrin.h @@ -0,0 +1,128 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: ocintrin.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*Some common macros for potential platform-specific optimization.*/ +#include +#if !defined(_ocintrin_H) +# define _ocintrin_H (1) + +/*Some specific platforms may have optimized intrinsic or inline assembly + versions of these functions which can substantially improve performance. + We define macros for them to allow easy incorporation of these non-ANSI + features.*/ + +/*Note that we do not provide a macro for abs(), because it is provided as a + library function, which we assume is translated into an intrinsic to avoid + the function call overhead and then implemented in the smartest way for the + target platform. + With modern gcc (4.x), this is true: it uses cmov instructions if the + architecture supports it and branchless bit-twiddling if it does not (the + speed difference between the two approaches is not measurable). + Interestingly, the bit-twiddling method was patented in 2000 (US 6,073,150) + by Sun Microsystems, despite prior art dating back to at least 1996: + http://web.archive.org/web/19961201174141/www.x86.org/ftp/articles/pentopt/PENTOPT.TXT + On gcc 3.x, however, our assumption is not true, as abs() is translated to a + conditional jump, which is horrible on deeply piplined architectures (e.g., + all consumer architectures for the past decade or more). + Also be warned that -C*abs(x) where C is a constant is mis-optimized as + abs(C*x) on every gcc release before 4.2.3. + See bug http://gcc.gnu.org/bugzilla/show_bug.cgi?id=34130 */ + +/*Modern gcc (4.x) can compile the naive versions of min and max with cmov if + given an appropriate architecture, but the branchless bit-twiddling versions + are just as fast, and do not require any special target architecture. + Earlier gcc versions (3.x) compiled both code to the same assembly + instructions, because of the way they represented ((_b)>(_a)) internally.*/ +#define OC_MAXI(_a,_b) ((_a)-((_a)-(_b)&-((_b)>(_a)))) +#define OC_MINI(_a,_b) ((_a)+((_b)-(_a)&-((_b)<(_a)))) +/*Clamps an integer into the given range. + If _a>_c, then the lower bound _a is respected over the upper bound _c (this + behavior is required to meet our documented API behavior). + _a: The lower bound. + _b: The value to clamp. + _c: The upper boud.*/ +#define OC_CLAMPI(_a,_b,_c) (OC_MAXI(_a,OC_MINI(_b,_c))) +#define OC_CLAMP255(_x) ((unsigned char)((((_x)<0)-1)&((_x)|-((_x)>255)))) +/*This has a chance of compiling branchless, and is just as fast as the + bit-twiddling method, which is slightly less portable, since it relies on a + sign-extended rightshift, which is not guaranteed by ANSI (but present on + every relevant platform).*/ +#define OC_SIGNI(_a) (((_a)>0)-((_a)<0)) +/*Slightly more portable than relying on a sign-extended right-shift (which is + not guaranteed by ANSI), and just as fast, since gcc (3.x and 4.x both) + compile it into the right-shift anyway.*/ +#define OC_SIGNMASK(_a) (-((_a)<0)) +/*Divides an integer by a power of two, truncating towards 0. + _dividend: The integer to divide. + _shift: The non-negative power of two to divide by. + _rmask: (1<<_shift)-1*/ +#define OC_DIV_POW2(_dividend,_shift,_rmask)\ + ((_dividend)+(OC_SIGNMASK(_dividend)&(_rmask))>>(_shift)) +/*Divides _x by 65536, truncating towards 0.*/ +#define OC_DIV2_16(_x) OC_DIV_POW2(_x,16,0xFFFF) +/*Divides _x by 2, truncating towards 0.*/ +#define OC_DIV2(_x) OC_DIV_POW2(_x,1,0x1) +/*Divides _x by 8, truncating towards 0.*/ +#define OC_DIV8(_x) OC_DIV_POW2(_x,3,0x7) +/*Divides _x by 16, truncating towards 0.*/ +#define OC_DIV16(_x) OC_DIV_POW2(_x,4,0xF) +/*Right shifts _dividend by _shift, adding _rval, and subtracting one for + negative dividends first. + When _rval is (1<<_shift-1), this is equivalent to division with rounding + ties away from zero.*/ +#define OC_DIV_ROUND_POW2(_dividend,_shift,_rval)\ + ((_dividend)+OC_SIGNMASK(_dividend)+(_rval)>>(_shift)) +/*Divides a _x by 2, rounding towards even numbers.*/ +#define OC_DIV2_RE(_x) ((_x)+((_x)>>1&1)>>1) +/*Divides a _x by (1<<(_shift)), rounding towards even numbers.*/ +#define OC_DIV_POW2_RE(_x,_shift) \ + ((_x)+((_x)>>(_shift)&1)+((1<<(_shift))-1>>1)>>(_shift)) +/*Swaps two integers _a and _b if _a>_b.*/ +#define OC_SORT2I(_a,_b) \ + do{ \ + int t__; \ + t__=((_a)^(_b))&-((_b)<(_a)); \ + (_a)^=t__; \ + (_b)^=t__; \ + } \ + while(0) + +/*Accesses one of four (signed) bytes given an index. + This can be used to avoid small lookup tables.*/ +#define OC_BYTE_TABLE32(_a,_b,_c,_d,_i) \ + ((signed char) \ + (((_a)&0xFF|((_b)&0xFF)<<8|((_c)&0xFF)<<16|((_d)&0xFF)<<24)>>(_i)*8)) +/*Accesses one of eight (unsigned) nibbles given an index. + This can be used to avoid small lookup tables.*/ +#define OC_UNIBBLE_TABLE32(_a,_b,_c,_d,_e,_f,_g,_h,_i) \ + ((((_a)&0xF|((_b)&0xF)<<4|((_c)&0xF)<<8|((_d)&0xF)<<12| \ + ((_e)&0xF)<<16|((_f)&0xF)<<20|((_g)&0xF)<<24|((_h)&0xF)<<28)>>(_i)*4)&0xF) + + + +/*All of these macros should expect floats as arguments.*/ +#define OC_MAXF(_a,_b) ((_a)<(_b)?(_b):(_a)) +#define OC_MINF(_a,_b) ((_a)>(_b)?(_b):(_a)) +#define OC_CLAMPF(_a,_b,_c) (OC_MINF(_a,OC_MAXF(_b,_c))) +#define OC_FABSF(_f) ((float)fabs(_f)) +#define OC_SQRTF(_f) ((float)sqrt(_f)) +#define OC_POWF(_b,_e) ((float)pow(_b,_e)) +#define OC_LOGF(_f) ((float)log(_f)) +#define OC_IFLOORF(_f) ((int)floor(_f)) +#define OC_ICEILF(_f) ((int)ceil(_f)) + +#endif diff --git a/libs/libtheora-1.1/lib/quant.c b/libs/libtheora-1.1/lib/quant.c new file mode 100644 index 00000000..5bc504e7 --- /dev/null +++ b/libs/libtheora-1.1/lib/quant.c @@ -0,0 +1,119 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: quant.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include +#include "quant.h" +#include "decint.h" + +static const unsigned OC_DC_QUANT_MIN[2]={4<<2,8<<2}; +static const unsigned OC_AC_QUANT_MIN[2]={2<<2,4<<2}; + +/*Initializes the dequantization tables from a set of quantizer info. + Currently the dequantizer (and elsewhere enquantizer) tables are expected to + be initialized as pointing to the storage reserved for them in the + oc_theora_state (resp. oc_enc_ctx) structure. + If some tables are duplicates of others, the pointers will be adjusted to + point to a single copy of the tables, but the storage for them will not be + freed. + If you're concerned about the memory footprint, the obvious thing to do is + to move the storage out of its fixed place in the structures and allocate + it on demand. + However, a much, much better option is to only store the quantization + matrices being used for the current frame, and to recalculate these as the + qi values change between frames (this is what VP3 did).*/ +void oc_dequant_tables_init(ogg_uint16_t *_dequant[64][3][2], + int _pp_dc_scale[64],const th_quant_info *_qinfo){ + /*Coding mode: intra or inter.*/ + int qti; + /*Y', C_b, C_r*/ + int pli; + for(qti=0;qti<2;qti++)for(pli=0;pli<3;pli++){ + /*Quality index.*/ + int qi; + /*Range iterator.*/ + int qri; + for(qi=0,qri=0;qri<=_qinfo->qi_ranges[qti][pli].nranges;qri++){ + th_quant_base base; + ogg_uint32_t q; + int qi_start; + int qi_end; + memcpy(base,_qinfo->qi_ranges[qti][pli].base_matrices[qri], + sizeof(base)); + qi_start=qi; + if(qri==_qinfo->qi_ranges[qti][pli].nranges)qi_end=qi+1; + else qi_end=qi+_qinfo->qi_ranges[qti][pli].sizes[qri]; + /*Iterate over quality indicies in this range.*/ + for(;;){ + ogg_uint32_t qfac; + int zzi; + int ci; + /*In the original VP3.2 code, the rounding offset and the size of the + dead zone around 0 were controlled by a "sharpness" parameter. + The size of our dead zone is now controlled by the per-coefficient + quality thresholds returned by our HVS module. + We round down from a more accurate value when the quality of the + reconstruction does not fall below our threshold and it saves bits. + Hence, all of that VP3.2 code is gone from here, and the remaining + floating point code has been implemented as equivalent integer code + with exact precision.*/ + qfac=(ogg_uint32_t)_qinfo->dc_scale[qi]*base[0]; + /*For postprocessing, not dequantization.*/ + if(_pp_dc_scale!=NULL)_pp_dc_scale[qi]=(int)(qfac/160); + /*Scale DC the coefficient from the proper table.*/ + q=(qfac/100)<<2; + q=OC_CLAMPI(OC_DC_QUANT_MIN[qti],q,OC_QUANT_MAX); + _dequant[qi][pli][qti][0]=(ogg_uint16_t)q; + /*Now scale AC coefficients from the proper table.*/ + for(zzi=1;zzi<64;zzi++){ + q=((ogg_uint32_t)_qinfo->ac_scale[qi]*base[OC_FZIG_ZAG[zzi]]/100)<<2; + q=OC_CLAMPI(OC_AC_QUANT_MIN[qti],q,OC_QUANT_MAX); + _dequant[qi][pli][qti][zzi]=(ogg_uint16_t)q; + } + /*If this is a duplicate of a previous matrix, use that instead. + This simple check helps us improve cache coherency later.*/ + { + int dupe; + int qtj; + int plj; + dupe=0; + for(qtj=0;qtj<=qti;qtj++){ + for(plj=0;plj<(qtj=qi_end)break; + /*Interpolate the next base matrix.*/ + for(ci=0;ci<64;ci++){ + base[ci]=(unsigned char)( + (2*((qi_end-qi)*_qinfo->qi_ranges[qti][pli].base_matrices[qri][ci]+ + (qi-qi_start)*_qinfo->qi_ranges[qti][pli].base_matrices[qri+1][ci]) + +_qinfo->qi_ranges[qti][pli].sizes[qri])/ + (2*_qinfo->qi_ranges[qti][pli].sizes[qri])); + } + } + } + } +} diff --git a/libs/libtheora-1.1/lib/quant.h b/libs/libtheora-1.1/lib/quant.h new file mode 100644 index 00000000..d7a29ef6 --- /dev/null +++ b/libs/libtheora-1.1/lib/quant.h @@ -0,0 +1,33 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: quant.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_quant_H) +# define _quant_H (1) +# include "theora/codec.h" +# include "ocintrin.h" + +typedef ogg_uint16_t oc_quant_table[64]; + + +/*Maximum scaled quantizer value.*/ +#define OC_QUANT_MAX (1024<<2) + + +void oc_dequant_tables_init(ogg_uint16_t *_dequant[64][3][2], + int _pp_dc_scale[64],const th_quant_info *_qinfo); + +#endif diff --git a/libs/libtheora-1.1/lib/rate.c b/libs/libtheora-1.1/lib/rate.c new file mode 100644 index 00000000..c0addd39 --- /dev/null +++ b/libs/libtheora-1.1/lib/rate.c @@ -0,0 +1,1137 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: rate.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include +#include "encint.h" + +/*A rough lookup table for tan(x), 0<=x>24; + if(i>=17)i=16; + t0=OC_ROUGH_TAN_LOOKUP[i]; + t1=OC_ROUGH_TAN_LOOKUP[i+1]; + d=_alpha*36-(i<<24); + return (int)(((ogg_int64_t)t0<<32)+(t1-t0<<8)*(ogg_int64_t)d>>32); +} + +/*Re-initialize the Bessel filter coefficients with the specified delay. + This does not alter the x/y state, but changes the reaction time of the + filter. + Altering the time constant of a reactive filter without alterning internal + state is something that has to be done carefuly, but our design operates at + high enough delays and with small enough time constant changes to make it + safe.*/ +static void oc_iir_filter_reinit(oc_iir_filter *_f,int _delay){ + int alpha; + ogg_int64_t one48; + ogg_int64_t warp; + ogg_int64_t k1; + ogg_int64_t k2; + ogg_int64_t d; + ogg_int64_t a; + ogg_int64_t ik2; + ogg_int64_t b1; + ogg_int64_t b2; + /*This borrows some code from an unreleased version of Postfish. + See the recipe at http://unicorn.us.com/alex/2polefilters.html for details + on deriving the filter coefficients.*/ + /*alpha is Q24*/ + alpha=(1<<24)/_delay; + one48=(ogg_int64_t)1<<48; + /*warp is 7.12*/ + warp=OC_MAXI(oc_warp_alpha(alpha),1); + /*k1 is 9.12*/ + k1=3*warp; + /*k2 is 16.24.*/ + k2=k1*warp; + /*d is 16.15.*/ + d=((1<<12)+k1<<12)+k2+256>>9; + /*a is 0.32, since d is larger than both 1.0 and k2.*/ + a=(k2<<23)/d; + /*ik2 is 25.24.*/ + ik2=one48/k2; + /*b1 is Q56; in practice, the integer ranges between -2 and 2.*/ + b1=2*a*(ik2-(1<<24)); + /*b2 is Q56; in practice, the integer ranges between -2 and 2.*/ + b2=(one48<<8)-(4*a<<24)-b1; + /*All of the filter parameters are Q24.*/ + _f->c[0]=(ogg_int32_t)(b1+((ogg_int64_t)1<<31)>>32); + _f->c[1]=(ogg_int32_t)(b2+((ogg_int64_t)1<<31)>>32); + _f->g=(ogg_int32_t)(a+128>>8); +} + +/*Initialize a 2nd order low-pass Bessel filter with the corresponding delay + and initial value. + _value is Q24.*/ +static void oc_iir_filter_init(oc_iir_filter *_f,int _delay,ogg_int32_t _value){ + oc_iir_filter_reinit(_f,_delay); + _f->y[1]=_f->y[0]=_f->x[1]=_f->x[0]=_value; +} + +static ogg_int64_t oc_iir_filter_update(oc_iir_filter *_f,ogg_int32_t _x){ + ogg_int64_t c0; + ogg_int64_t c1; + ogg_int64_t g; + ogg_int64_t x0; + ogg_int64_t x1; + ogg_int64_t y0; + ogg_int64_t y1; + ogg_int64_t ya; + c0=_f->c[0]; + c1=_f->c[1]; + g=_f->g; + x0=_f->x[0]; + x1=_f->x[1]; + y0=_f->y[0]; + y1=_f->y[1]; + ya=(_x+x0*2+x1)*g+y0*c0+y1*c1+(1<<23)>>24; + _f->x[1]=(ogg_int32_t)x0; + _f->x[0]=_x; + _f->y[1]=(ogg_int32_t)y0; + _f->y[0]=(ogg_int32_t)ya; + return ya; +} + + + +/*Search for the quantizer that matches the target most closely. + We don't assume a linear ordering, but when there are ties we pick the + quantizer closest to the old one.*/ +static int oc_enc_find_qi_for_target(oc_enc_ctx *_enc,int _qti,int _qi_old, + int _qi_min,ogg_int64_t _log_qtarget){ + ogg_int64_t best_qdiff; + int best_qi; + int qi; + best_qi=_qi_min; + best_qdiff=_enc->log_qavg[_qti][best_qi]-_log_qtarget; + best_qdiff=best_qdiff+OC_SIGNMASK(best_qdiff)^OC_SIGNMASK(best_qdiff); + for(qi=_qi_min+1;qi<64;qi++){ + ogg_int64_t qdiff; + qdiff=_enc->log_qavg[_qti][qi]-_log_qtarget; + qdiff=qdiff+OC_SIGNMASK(qdiff)^OC_SIGNMASK(qdiff); + if(qdiffstate.qis[0]; + /*If rate control is active, use the lambda for the _target_ quantizer. + This allows us to scale to rates slightly lower than we'd normally be able + to reach, and give the rate control a semblance of "fractional qi" + precision. + TODO: Add API for changing QI, and allow extra precision.*/ + if(_enc->state.info.target_bitrate>0)lq=_enc->rc.log_qtarget; + else lq=_enc->log_qavg[_qti][qi]; + /*The resulting lambda value is less than 0x500000.*/ + _enc->lambda=(int)oc_bexp64(2*lq-0x4780BD468D6B62BLL); + /*Select additional quantizers. + The R-D optimal block AC quantizer statistics suggest that the distribution + is roughly Gaussian-like with a slight positive skew. + K-means clustering on log_qavg to select 3 quantizers produces cluster + centers of {log_qavg-0.6,log_qavg,log_qavg+0.7}. + Experiments confirm these are relatively good choices. + + Although we do greedy R-D optimization of the qii flags to avoid switching + too frequently, this becomes ineffective at low rates, either because we + do a poor job of predicting the actual R-D cost, or the greedy + optimization is not sufficient. + Therefore adaptive quantization is disabled above an (experimentally + suggested) threshold of log_qavg=7.00 (e.g., below INTRA qi=12 or + INTER qi=20 with current matrices). + This may need to be revised if the R-D cost estimation or qii flag + optimization strategies change.*/ + nqis=1; + if(lq<(OC_Q57(56)>>3)&&!_enc->vp3_compatible){ + qi1=oc_enc_find_qi_for_target(_enc,_qti,OC_MAXI(qi-1,0),0, + lq+(OC_Q57(7)+5)/10); + if(qi1!=qi)_enc->state.qis[nqis++]=qi1; + qi1=oc_enc_find_qi_for_target(_enc,_qti,OC_MINI(qi+1,63),0, + lq-(OC_Q57(6)+5)/10); + if(qi1!=qi&&qi1!=_enc->state.qis[nqis-1])_enc->state.qis[nqis++]=qi1; + } + _enc->state.nqis=nqis; +} + +/*Binary exponential of _log_scale with 24-bit fractional precision and + saturation. + _log_scale: A binary logarithm in Q24 format. + Return: The binary exponential in Q24 format, saturated to 2**47-1 if + _log_scale was too large.*/ +static ogg_int64_t oc_bexp_q24(ogg_int32_t _log_scale){ + if(_log_scale<(ogg_int32_t)23<<24){ + ogg_int64_t ret; + ret=oc_bexp64(((ogg_int64_t)_log_scale<<33)+OC_Q57(24)); + return ret<0x7FFFFFFFFFFFLL?ret:0x7FFFFFFFFFFFLL; + } + return 0x7FFFFFFFFFFFLL; +} + +/*Convenience function converts Q57 value to a clamped 32-bit Q24 value + _in: input in Q57 format. + Return: same number in Q24 */ +static ogg_int32_t oc_q57_to_q24(ogg_int64_t _in){ + ogg_int64_t ret; + ret=_in+((ogg_int64_t)1<<32)>>33; + /*0x80000000 is automatically converted to unsigned on 32-bit systems. + -0x7FFFFFFF-1 is needed to avoid "promoting" the whole expression to + unsigned.*/ + return (ogg_int32_t)OC_CLAMPI(-0x7FFFFFFF-1,ret,0x7FFFFFFF); +} + +/*Binary exponential of _log_scale with 24-bit fractional precision and + saturation. + _log_scale: A binary logarithm in Q57 format. + Return: The binary exponential in Q24 format, saturated to 2**31-1 if + _log_scale was too large.*/ +static ogg_int32_t oc_bexp64_q24(ogg_int64_t _log_scale){ + if(_log_scalerc.bits_per_frame=(_enc->state.info.target_bitrate* + (ogg_int64_t)_enc->state.info.fps_denominator)/ + _enc->state.info.fps_numerator; + /*Insane framerates or frame sizes mean insane bitrates. + Let's not get carried away.*/ + if(_enc->rc.bits_per_frame>0x400000000000LL){ + _enc->rc.bits_per_frame=(ogg_int64_t)0x400000000000LL; + } + else if(_enc->rc.bits_per_frame<32)_enc->rc.bits_per_frame=32; + _enc->rc.buf_delay=OC_MAXI(_enc->rc.buf_delay,12); + _enc->rc.max=_enc->rc.bits_per_frame*_enc->rc.buf_delay; + /*Start with a buffer fullness of 50% plus 25% of the amount we plan to spend + on a single keyframe interval. + We can require fully half the bits in an interval for a keyframe, so this + initial level gives us maximum flexibility for over/under-shooting in + subsequent frames.*/ + _enc->rc.target=(_enc->rc.max+1>>1)+(_enc->rc.bits_per_frame+2>>2)* + OC_MINI(_enc->keyframe_frequency_force,_enc->rc.buf_delay); + _enc->rc.fullness=_enc->rc.target; + /*Pick exponents and initial scales for quantizer selection.*/ + npixels=_enc->state.info.frame_width* + (ogg_int64_t)_enc->state.info.frame_height; + _enc->rc.log_npixels=oc_blog64(npixels); + ibpp=npixels/_enc->rc.bits_per_frame; + if(ibpp<1){ + _enc->rc.exp[0]=59; + _enc->rc.log_scale[0]=oc_blog64(1997)-OC_Q57(8); + } + else if(ibpp<2){ + _enc->rc.exp[0]=55; + _enc->rc.log_scale[0]=oc_blog64(1604)-OC_Q57(8); + } + else{ + _enc->rc.exp[0]=48; + _enc->rc.log_scale[0]=oc_blog64(834)-OC_Q57(8); + } + if(ibpp<4){ + _enc->rc.exp[1]=100; + _enc->rc.log_scale[1]=oc_blog64(2249)-OC_Q57(8); + } + else if(ibpp<8){ + _enc->rc.exp[1]=95; + _enc->rc.log_scale[1]=oc_blog64(1751)-OC_Q57(8); + } + else{ + _enc->rc.exp[1]=73; + _enc->rc.log_scale[1]=oc_blog64(1260)-OC_Q57(8); + } + _enc->rc.prev_drop_count=0; + _enc->rc.log_drop_scale=OC_Q57(0); + /*Set up second order followers, initialized according to corresponding + time constants.*/ + oc_iir_filter_init(&_enc->rc.scalefilter[0],4, + oc_q57_to_q24(_enc->rc.log_scale[0])); + inter_delay=(_enc->rc.twopass? + OC_MAXI(_enc->keyframe_frequency_force,12):_enc->rc.buf_delay)>>1; + _enc->rc.inter_count=0; + /*We clamp the actual inter_delay to a minimum of 10 to work within the range + of values where later incrementing the delay works as designed. + 10 is not an exact choice, but rather a good working trade-off.*/ + _enc->rc.inter_delay=10; + _enc->rc.inter_delay_target=inter_delay; + oc_iir_filter_init(&_enc->rc.scalefilter[1],_enc->rc.inter_delay, + oc_q57_to_q24(_enc->rc.log_scale[1])); + oc_iir_filter_init(&_enc->rc.vfrfilter,4, + oc_bexp64_q24(_enc->rc.log_drop_scale)); +} + +void oc_rc_state_init(oc_rc_state *_rc,oc_enc_ctx *_enc){ + _rc->twopass=0; + _rc->twopass_buffer_bytes=0; + _rc->twopass_force_kf=0; + _rc->frame_metrics=NULL; + _rc->rate_bias=0; + if(_enc->state.info.target_bitrate>0){ + /*The buffer size is set equal to the keyframe interval, clamped to the + range [12,256] frames. + The 12 frame minimum gives us some chance to distribute bit estimation + errors. + The 256 frame maximum means we'll require 8-10 seconds of pre-buffering + at 24-30 fps, which is not unreasonable.*/ + _rc->buf_delay=_enc->keyframe_frequency_force>256? + 256:_enc->keyframe_frequency_force; + /*By default, enforce all buffer constraints.*/ + _rc->drop_frames=1; + _rc->cap_overflow=1; + _rc->cap_underflow=0; + oc_enc_rc_reset(_enc); + } +} + +void oc_rc_state_clear(oc_rc_state *_rc){ + _ogg_free(_rc->frame_metrics); +} + +void oc_enc_rc_resize(oc_enc_ctx *_enc){ + /*If encoding has not yet begun, reset the buffer state.*/ + if(_enc->state.curframe_num<0)oc_enc_rc_reset(_enc); + else{ + int idt; + /*Otherwise, update the bounds on the buffer, but not the current + fullness.*/ + _enc->rc.bits_per_frame=(_enc->state.info.target_bitrate* + (ogg_int64_t)_enc->state.info.fps_denominator)/ + _enc->state.info.fps_numerator; + /*Insane framerates or frame sizes mean insane bitrates. + Let's not get carried away.*/ + if(_enc->rc.bits_per_frame>0x400000000000LL){ + _enc->rc.bits_per_frame=(ogg_int64_t)0x400000000000LL; + } + else if(_enc->rc.bits_per_frame<32)_enc->rc.bits_per_frame=32; + _enc->rc.buf_delay=OC_MAXI(_enc->rc.buf_delay,12); + _enc->rc.max=_enc->rc.bits_per_frame*_enc->rc.buf_delay; + _enc->rc.target=(_enc->rc.max+1>>1)+(_enc->rc.bits_per_frame+2>>2)* + OC_MINI(_enc->keyframe_frequency_force,_enc->rc.buf_delay); + /*Update the INTER-frame scale filter delay. + We jump to it immediately if we've already seen enough frames; otherwise + it is simply set as the new target.*/ + _enc->rc.inter_delay_target=idt=OC_MAXI(_enc->rc.buf_delay>>1,10); + if(idtrc.inter_delay,_enc->rc.inter_count)){ + oc_iir_filter_init(&_enc->rc.scalefilter[1],idt, + _enc->rc.scalefilter[1].y[0]); + _enc->rc.inter_delay=idt; + } + } + /*If we're in pass-2 mode, make sure the frame metrics array is big enough + to hold frame statistics for the full buffer.*/ + if(_enc->rc.twopass==2){ + int cfm; + int buf_delay; + int reset_window; + buf_delay=_enc->rc.buf_delay; + reset_window=_enc->rc.frame_metrics==NULL&&(_enc->rc.frames_total[0]==0|| + buf_delay<_enc->rc.frames_total[0]+_enc->rc.frames_total[1] + +_enc->rc.frames_total[2]); + cfm=_enc->rc.cframe_metrics; + /*Only try to resize the frame metrics buffer if a) it's too small and + b) we were using a finite buffer, or are about to start.*/ + if(cfmrc.frame_metrics!=NULL||reset_window)){ + oc_frame_metrics *fm; + int nfm; + int fmh; + fm=(oc_frame_metrics *)_ogg_realloc(_enc->rc.frame_metrics, + buf_delay*sizeof(*_enc->rc.frame_metrics)); + if(fm==NULL){ + /*We failed to allocate a finite buffer.*/ + /*If we don't have a valid 2-pass header yet, just return; we'll reset + the buffer size when we read the header.*/ + if(_enc->rc.frames_total[0]==0)return; + /*Otherwise revert to the largest finite buffer previously set, or to + whole-file buffering if we were still using that.*/ + _enc->rc.buf_delay=_enc->rc.frame_metrics!=NULL? + cfm:_enc->rc.frames_total[0]+_enc->rc.frames_total[1] + +_enc->rc.frames_total[2]; + oc_enc_rc_resize(_enc); + return; + } + _enc->rc.frame_metrics=fm; + _enc->rc.cframe_metrics=buf_delay; + /*Re-organize the circular buffer.*/ + fmh=_enc->rc.frame_metrics_head; + nfm=_enc->rc.nframe_metrics; + if(fmh+nfm>cfm){ + int shift; + shift=OC_MINI(fmh+nfm-cfm,buf_delay-cfm); + memcpy(fm+cfm,fm,OC_MINI(fmh+nfm-cfm,buf_delay-cfm)*sizeof(*fm)); + if(fmh+nfm>buf_delay)memmove(fm,fm+shift,fmh+nfm-buf_delay); + } + } + /*We were using whole-file buffering; now we're not.*/ + if(reset_window){ + _enc->rc.nframes[0]=_enc->rc.nframes[1]=_enc->rc.nframes[2]=0; + _enc->rc.scale_sum[0]=_enc->rc.scale_sum[1]=0; + _enc->rc.scale_window_end=_enc->rc.scale_window0= + _enc->state.curframe_num+_enc->prev_dup_count+1; + if(_enc->rc.twopass_buffer_bytes){ + int qti; + /*We already read the metrics for the first frame in the window.*/ + *(_enc->rc.frame_metrics)=*&_enc->rc.cur_metrics; + _enc->rc.nframe_metrics++; + qti=_enc->rc.cur_metrics.frame_type; + _enc->rc.nframes[qti]++; + _enc->rc.nframes[2]+=_enc->rc.cur_metrics.dup_count; + _enc->rc.scale_sum[qti]+=oc_bexp_q24(_enc->rc.cur_metrics.log_scale); + _enc->rc.scale_window_end+=_enc->rc.cur_metrics.dup_count+1; + if(_enc->rc.scale_window_end-_enc->rc.scale_window0rc.twopass_buffer_bytes=0; + } + } + } + /*Otherwise, we could shrink the size of the current window, if necessary, + but leaving it like it is lets us adapt to the new buffer size more + gracefully.*/ + } +} + +/*Scale the number of frames by the number of expected drops/duplicates.*/ +static int oc_rc_scale_drop(oc_rc_state *_rc,int _nframes){ + if(_rc->prev_drop_count>0||_rc->log_drop_scale>OC_Q57(0)){ + ogg_int64_t dup_scale; + dup_scale=oc_bexp64((_rc->log_drop_scale + +oc_blog64(_rc->prev_drop_count+1)>>1)+OC_Q57(8)); + if(dup_scale<_nframes<<8){ + int dup_scalei; + dup_scalei=(int)dup_scale; + if(dup_scalei>0)_nframes=((_nframes<<8)+dup_scalei-1)/dup_scalei; + } + else _nframes=!!_nframes; + } + return _nframes; +} + +int oc_enc_select_qi(oc_enc_ctx *_enc,int _qti,int _clamp){ + ogg_int64_t rate_total; + ogg_int64_t rate_bias; + int nframes[2]; + int buf_delay; + int buf_pad; + ogg_int64_t log_qtarget; + ogg_int64_t log_scale0; + ogg_int64_t log_cur_scale; + ogg_int64_t log_qexp; + int exp0; + int old_qi; + int qi; + /*Figure out how to re-distribute bits so that we hit our fullness target + before the last keyframe in our current buffer window (after the current + frame), or the end of the buffer window, whichever comes first.*/ + log_cur_scale=(ogg_int64_t)_enc->rc.scalefilter[_qti].y[0]<<33; + buf_pad=0; + switch(_enc->rc.twopass){ + default:{ + ogg_uint32_t next_key_frame; + /*Single pass mode: assume only forced keyframes and attempt to estimate + the drop count for VFR content.*/ + next_key_frame=_qti?_enc->keyframe_frequency_force + -(_enc->state.curframe_num-_enc->state.keyframe_num):0; + nframes[0]=(_enc->rc.buf_delay-OC_MINI(next_key_frame,_enc->rc.buf_delay) + +_enc->keyframe_frequency_force-1)/_enc->keyframe_frequency_force; + if(nframes[0]+_qti>1){ + nframes[0]--; + buf_delay=next_key_frame+nframes[0]*_enc->keyframe_frequency_force; + } + else buf_delay=_enc->rc.buf_delay; + nframes[1]=buf_delay-nframes[0]; + /*Downgrade the delta frame rate to correspond to the recent drop count + history.*/ + nframes[1]=oc_rc_scale_drop(&_enc->rc,nframes[1]); + }break; + case 1:{ + /*Pass 1 mode: use a fixed qi value.*/ + qi=_enc->state.qis[0]; + _enc->rc.log_qtarget=_enc->log_qavg[_qti][qi]; + return qi; + }break; + case 2:{ + ogg_int64_t scale_sum[2]; + int qti; + /*Pass 2 mode: we know exactly how much of each frame type there is in + the current buffer window, and have estimates for the scales.*/ + nframes[0]=_enc->rc.nframes[0]; + nframes[1]=_enc->rc.nframes[1]; + scale_sum[0]=_enc->rc.scale_sum[0]; + scale_sum[1]=_enc->rc.scale_sum[1]; + /*The window size can be slightly larger than the buffer window for VFR + content; clamp it down, if appropriate (the excess will all be dup + frames).*/ + buf_delay=OC_MINI(_enc->rc.scale_window_end-_enc->rc.scale_window0, + _enc->rc.buf_delay); + /*If we're approaching the end of the file, add some slack to keep us + from slamming into a rail. + Our rate accuracy goes down, but it keeps the result sensible. + We position the target where the first forced keyframe beyond the end + of the file would be (for consistency with 1-pass mode).*/ + buf_pad=OC_MINI(_enc->rc.buf_delay,_enc->state.keyframe_num + +_enc->keyframe_frequency_force-_enc->rc.scale_window0); + if(buf_delayrc.frame_metrics!=NULL){ + int fmi; + int fm_tail; + fm_tail=_enc->rc.frame_metrics_head+_enc->rc.nframe_metrics; + if(fm_tail>=_enc->rc.cframe_metrics)fm_tail-=_enc->rc.cframe_metrics; + for(fmi=fm_tail;;){ + oc_frame_metrics *m; + fmi--; + if(fmi<0)fmi+=_enc->rc.cframe_metrics; + /*Stop before we remove the first frame.*/ + if(fmi==_enc->rc.frame_metrics_head)break; + m=_enc->rc.frame_metrics+fmi; + /*If we find a keyframe, remove it and everything past it.*/ + if(m->frame_type==OC_INTRA_FRAME){ + do{ + qti=m->frame_type; + nframes[qti]--; + scale_sum[qti]-=oc_bexp_q24(m->log_scale); + buf_delay-=m->dup_count+1; + fmi++; + if(fmi>=_enc->rc.cframe_metrics)fmi=0; + m=_enc->rc.frame_metrics+fmi; + } + while(fmi!=fm_tail); + /*And stop scanning backwards.*/ + break; + } + } + } + } + /*If we're not using the same frame type as in pass 1 (because someone + changed the keyframe interval), remove that scale estimate. + We'll add in a replacement for the correct frame type below.*/ + qti=_enc->rc.cur_metrics.frame_type; + if(qti!=_qti){ + nframes[qti]--; + scale_sum[qti]-=oc_bexp_q24(_enc->rc.cur_metrics.log_scale); + } + /*Compute log_scale estimates for each frame type from the pass-1 scales + we measured in the current window.*/ + for(qti=0;qti<2;qti++){ + _enc->rc.log_scale[qti]=nframes[qti]>0? + oc_blog64(scale_sum[qti])-oc_blog64(nframes[qti])-OC_Q57(24): + -_enc->rc.log_npixels; + } + /*If we're not using the same frame type as in pass 1, add a scale + estimate for the corresponding frame using the current low-pass + filter value. + This is mostly to ensure we have a valid estimate even when pass 1 had + no frames of this type in the buffer window. + TODO: We could also plan ahead and figure out how many keyframes we'll + be forced to add in the current buffer window.*/ + qti=_enc->rc.cur_metrics.frame_type; + if(qti!=_qti){ + ogg_int64_t scale; + scale=_enc->rc.log_scale[_qti]rc.log_scale[_qti]+OC_Q57(24)):0x7FFFFFFFFFFFLL; + scale*=nframes[_qti]; + nframes[_qti]++; + scale+=oc_bexp_q24(log_cur_scale>>33); + _enc->rc.log_scale[_qti]=oc_blog64(scale) + -oc_blog64(nframes[qti])-OC_Q57(24); + } + else log_cur_scale=(ogg_int64_t)_enc->rc.cur_metrics.log_scale<<33; + /*Add the padding from above. + This basically reverts to 1-pass estimations in the last keyframe + interval.*/ + if(buf_pad>0){ + ogg_int64_t scale; + int nextra_frames; + /*Extend the buffer.*/ + buf_delay+=buf_pad; + /*Add virtual delta frames according to the estimated drop count.*/ + nextra_frames=oc_rc_scale_drop(&_enc->rc,buf_pad); + /*And blend in the low-pass filtered scale according to how many frames + we added.*/ + scale= + oc_bexp64(_enc->rc.log_scale[1]+OC_Q57(24))*(ogg_int64_t)nframes[1] + +oc_bexp_q24(_enc->rc.scalefilter[1].y[0])*(ogg_int64_t)nextra_frames; + nframes[1]+=nextra_frames; + _enc->rc.log_scale[1]=oc_blog64(scale)-oc_blog64(nframes[1])-OC_Q57(24); + } + }break; + } + /*If we've been missing our target, add a penalty term.*/ + rate_bias=(_enc->rc.rate_bias/(_enc->state.curframe_num+1000))* + (buf_delay-buf_pad); + /*rate_total is the total bits available over the next buf_delay frames.*/ + rate_total=_enc->rc.fullness-_enc->rc.target+rate_bias + +buf_delay*_enc->rc.bits_per_frame; + log_scale0=_enc->rc.log_scale[_qti]+_enc->rc.log_npixels; + /*If there aren't enough bits to achieve our desired fullness level, use the + minimum quality permitted.*/ + if(rate_total<=buf_delay)log_qtarget=OC_QUANT_MAX_LOG; + else{ + static const ogg_int64_t LOG_KEY_RATIO=0x0137222BB70747BALL; + ogg_int64_t log_scale1; + ogg_int64_t rlo; + ogg_int64_t rhi; + log_scale1=_enc->rc.log_scale[1-_qti]+_enc->rc.log_npixels; + rlo=0; + rhi=(rate_total+nframes[_qti]-1)/nframes[_qti]; + while(rlo>1; + log_rpow=oc_blog64(curr)-log_scale0; + log_rpow=(log_rpow+(_enc->rc.exp[_qti]>>1))/_enc->rc.exp[_qti]; + if(_qti)log_rpow+=LOG_KEY_RATIO>>6; + else log_rpow-=LOG_KEY_RATIO>>6; + log_rpow*=_enc->rc.exp[1-_qti]; + rscale=nframes[1-_qti]*oc_bexp64(log_scale1+log_rpow); + rdiff=nframes[_qti]*curr+rscale-rate_total; + if(rdiff<0)rlo=curr+1; + else if(rdiff>0)rhi=curr-1; + else break; + } + log_qtarget=OC_Q57(2)-((oc_blog64(rlo)-log_scale0+(_enc->rc.exp[_qti]>>1))/ + _enc->rc.exp[_qti]<<6); + log_qtarget=OC_MINI(log_qtarget,OC_QUANT_MAX_LOG); + } + /*The above allocation looks only at the total rate we'll accumulate in the + next buf_delay frames. + However, we could overflow the buffer on the very next frame, so check for + that here, if we're not using a soft target.*/ + exp0=_enc->rc.exp[_qti]; + if(_enc->rc.cap_overflow){ + ogg_int64_t margin; + ogg_int64_t soft_limit; + ogg_int64_t log_soft_limit; + /*Allow 3% of the buffer for prediction error. + This should be plenty, and we don't mind if we go a bit over; we only + want to keep these bits from being completely wasted.*/ + margin=_enc->rc.max+31>>5; + /*We want to use at least this many bits next frame.*/ + soft_limit=_enc->rc.fullness+_enc->rc.bits_per_frame-(_enc->rc.max-margin); + log_soft_limit=oc_blog64(soft_limit); + /*If we're predicting we won't use that many...*/ + log_qexp=(log_qtarget-OC_Q57(2)>>6)*exp0; + if(log_scale0-log_qexp>32)* + ((OC_MINI(margin,soft_limit)<<32)/margin); + log_qtarget=((log_qexp+(exp0>>1))/exp0<<6)+OC_Q57(2); + } + } + /*If this was not one of the initial frames, limit the change in quality.*/ + old_qi=_enc->state.qis[0]; + if(_clamp){ + ogg_int64_t log_qmin; + ogg_int64_t log_qmax; + /*Clamp the target quantizer to within [0.8*Q,1.2*Q], where Q is the + current quantizer. + TODO: With user-specified quant matrices, we need to enlarge these limits + if they don't actually let us change qi values.*/ + log_qmin=_enc->log_qavg[_qti][old_qi]-0x00A4D3C25E68DC58LL; + log_qmax=_enc->log_qavg[_qti][old_qi]+0x00A4D3C25E68DC58LL; + log_qtarget=OC_CLAMPI(log_qmin,log_qtarget,log_qmax); + } + /*The above allocation looks only at the total rate we'll accumulate in the + next buf_delay frames. + However, we could bust the budget on the very next frame, so check for that + here, if we're not using a soft target.*/ + /* Disabled when our minimum qi > 0; if we saturate log_qtarget to + to the maximum possible size when we have a minimum qi, the + resulting lambda will interact very strangely with SKIP. The + resulting artifacts look like waterfalls. */ + if(_enc->state.info.quality==0){ + ogg_int64_t log_hard_limit; + /*Compute the maximum number of bits we can use in the next frame. + Allow 50% of the rate for a single frame for prediction error. + This may not be enough for keyframes or sudden changes in complexity.*/ + log_hard_limit=oc_blog64(_enc->rc.fullness+(_enc->rc.bits_per_frame>>1)); + /*If we're predicting we'll use more than this...*/ + log_qexp=(log_qtarget-OC_Q57(2)>>6)*exp0; + if(log_scale0-log_qexp>log_hard_limit){ + /*Force the target to hit our limit exactly.*/ + log_qexp=log_scale0-log_hard_limit; + log_qtarget=((log_qexp+(exp0>>1))/exp0<<6)+OC_Q57(2); + /*If that target is unreasonable, oh well; we'll have to drop.*/ + log_qtarget=OC_MINI(log_qtarget,OC_QUANT_MAX_LOG); + } + } + /*Compute a final estimate of the number of bits we plan to use.*/ + log_qexp=(log_qtarget-OC_Q57(2)>>6)*_enc->rc.exp[_qti]; + _enc->rc.rate_bias+=oc_bexp64(log_cur_scale+_enc->rc.log_npixels-log_qexp); + qi=oc_enc_find_qi_for_target(_enc,_qti,old_qi, + _enc->state.info.quality,log_qtarget); + /*Save the quantizer target for lambda calculations.*/ + _enc->rc.log_qtarget=log_qtarget; + return qi; +} + +int oc_enc_update_rc_state(oc_enc_ctx *_enc, + long _bits,int _qti,int _qi,int _trial,int _droppable){ + ogg_int64_t buf_delta; + ogg_int64_t log_scale; + int dropped; + dropped=0; + /* Drop frames also disabled for now in the case of infinite-buffer + two-pass mode */ + if(!_enc->rc.drop_frames||_enc->rc.twopass&&_enc->rc.frame_metrics==NULL){ + _droppable=0; + } + buf_delta=_enc->rc.bits_per_frame*(1+_enc->dup_count); + if(_bits<=0){ + /*We didn't code any blocks in this frame.*/ + log_scale=OC_Q57(-64); + _bits=0; + } + else{ + ogg_int64_t log_bits; + ogg_int64_t log_qexp; + /*Compute the estimated scale factor for this frame type.*/ + log_bits=oc_blog64(_bits); + log_qexp=_enc->rc.log_qtarget-OC_Q57(2); + log_qexp=(log_qexp>>6)*(_enc->rc.exp[_qti]); + log_scale=OC_MINI(log_bits-_enc->rc.log_npixels+log_qexp,OC_Q57(16)); + } + /*Special two-pass processing.*/ + switch(_enc->rc.twopass){ + case 1:{ + /*Pass 1 mode: save the metrics for this frame.*/ + _enc->rc.cur_metrics.log_scale=oc_q57_to_q24(log_scale); + _enc->rc.cur_metrics.dup_count=_enc->dup_count; + _enc->rc.cur_metrics.frame_type=_enc->state.frame_type; + _enc->rc.twopass_buffer_bytes=0; + }break; + case 2:{ + /*Pass 2 mode:*/ + if(!_trial){ + ogg_int64_t next_frame_num; + int qti; + /*Move the current metrics back one frame.*/ + *&_enc->rc.prev_metrics=*&_enc->rc.cur_metrics; + next_frame_num=_enc->state.curframe_num+_enc->dup_count+1; + /*Back out the last frame's statistics from the sliding window.*/ + qti=_enc->rc.prev_metrics.frame_type; + _enc->rc.frames_left[qti]--; + _enc->rc.frames_left[2]-=_enc->rc.prev_metrics.dup_count; + _enc->rc.nframes[qti]--; + _enc->rc.nframes[2]-=_enc->rc.prev_metrics.dup_count; + _enc->rc.scale_sum[qti]-=oc_bexp_q24(_enc->rc.prev_metrics.log_scale); + _enc->rc.scale_window0=(int)next_frame_num; + /*Free the corresponding entry in the circular buffer.*/ + if(_enc->rc.frame_metrics!=NULL){ + _enc->rc.nframe_metrics--; + _enc->rc.frame_metrics_head++; + if(_enc->rc.frame_metrics_head>=_enc->rc.cframe_metrics){ + _enc->rc.frame_metrics_head=0; + } + } + /*Mark us ready for the next 2-pass packet.*/ + _enc->rc.twopass_buffer_bytes=0; + /*Update state, so the user doesn't have to keep calling 2pass_in after + they've fed in all the data when we're using a finite buffer.*/ + _enc->prev_dup_count=_enc->dup_count; + oc_enc_rc_2pass_in(_enc,NULL,0); + } + }break; + } + /*Common to all passes:*/ + if(_bits>0){ + if(_trial){ + oc_iir_filter *f; + /*Use the estimated scale factor directly if this was a trial.*/ + f=_enc->rc.scalefilter+_qti; + f->y[1]=f->y[0]=f->x[1]=f->x[0]=oc_q57_to_q24(log_scale); + _enc->rc.log_scale[_qti]=log_scale; + } + else{ + /*Lengthen the time constant for the INTER filter as we collect more + frame statistics, until we reach our target.*/ + if(_enc->rc.inter_delay<_enc->rc.inter_delay_target&& + _enc->rc.inter_count>=_enc->rc.inter_delay&&_qti==OC_INTER_FRAME){ + oc_iir_filter_reinit(&_enc->rc.scalefilter[1],++_enc->rc.inter_delay); + } + /*Otherwise update the low-pass scale filter for this frame type, + regardless of whether or not we dropped this frame.*/ + _enc->rc.log_scale[_qti]=oc_iir_filter_update( + _enc->rc.scalefilter+_qti,oc_q57_to_q24(log_scale))<<33; + /*If this frame busts our budget, it must be dropped.*/ + if(_droppable&&_enc->rc.fullness+buf_delta<_bits){ + _enc->rc.prev_drop_count+=1+_enc->dup_count; + _bits=0; + dropped=1; + } + else{ + ogg_uint32_t drop_count; + /*Update a low-pass filter to estimate the "real" frame rate taking + drops and duplicates into account. + This is only done if the frame is coded, as it needs the final + count of dropped frames.*/ + drop_count=_enc->rc.prev_drop_count+1; + if(drop_count>0x7F)drop_count=0x7FFFFFFF; + else drop_count<<=24; + _enc->rc.log_drop_scale=oc_blog64(oc_iir_filter_update( + &_enc->rc.vfrfilter,drop_count))-OC_Q57(24); + /*Initialize the drop count for this frame to the user-requested dup + count. + It will be increased if we drop more frames.*/ + _enc->rc.prev_drop_count=_enc->dup_count; + } + } + /*Increment the INTER frame count, for filter adaptation purposes.*/ + if(_enc->rc.inter_countrc.inter_count+=_qti; + } + /*Increase the drop count.*/ + else _enc->rc.prev_drop_count+=1+_enc->dup_count; + /*And update the buffer fullness level.*/ + if(!_trial){ + _enc->rc.fullness+=buf_delta-_bits; + /*If we're too quick filling the buffer and overflow is capped, + that rate is lost forever.*/ + if(_enc->rc.cap_overflow&&_enc->rc.fullness>_enc->rc.max){ + _enc->rc.fullness=_enc->rc.max; + } + /*If we're too quick draining the buffer and underflow is capped, + don't try to make up that rate later.*/ + if(_enc->rc.cap_underflow&&_enc->rc.fullness<0){ + _enc->rc.fullness=0; + } + /*Adjust the bias for the real bits we've used.*/ + _enc->rc.rate_bias-=_bits; + } + return dropped; +} + +#define OC_RC_2PASS_VERSION (1) +#define OC_RC_2PASS_HDR_SZ (38) +#define OC_RC_2PASS_PACKET_SZ (8) + +static void oc_rc_buffer_val(oc_rc_state *_rc,ogg_int64_t _val,int _bytes){ + while(_bytes-->0){ + _rc->twopass_buffer[_rc->twopass_buffer_bytes++]=(unsigned char)(_val&0xFF); + _val>>=8; + } +} + +int oc_enc_rc_2pass_out(oc_enc_ctx *_enc,unsigned char **_buf){ + if(_enc->rc.twopass_buffer_bytes==0){ + if(_enc->rc.twopass==0){ + int qi; + /*Pick first-pass qi for scale calculations.*/ + qi=oc_enc_select_qi(_enc,0,0); + _enc->state.nqis=1; + _enc->state.qis[0]=qi; + _enc->rc.twopass=1; + _enc->rc.frames_total[0]=_enc->rc.frames_total[1]= + _enc->rc.frames_total[2]=0; + _enc->rc.scale_sum[0]=_enc->rc.scale_sum[1]=0; + /*Fill in dummy summary values.*/ + oc_rc_buffer_val(&_enc->rc,0x5032544F,4); + oc_rc_buffer_val(&_enc->rc,OC_RC_2PASS_VERSION,4); + oc_rc_buffer_val(&_enc->rc,0,OC_RC_2PASS_HDR_SZ-8); + } + else{ + int qti; + qti=_enc->rc.cur_metrics.frame_type; + _enc->rc.scale_sum[qti]+=oc_bexp_q24(_enc->rc.cur_metrics.log_scale); + _enc->rc.frames_total[qti]++; + _enc->rc.frames_total[2]+=_enc->rc.cur_metrics.dup_count; + oc_rc_buffer_val(&_enc->rc, + _enc->rc.cur_metrics.dup_count|_enc->rc.cur_metrics.frame_type<<31,4); + oc_rc_buffer_val(&_enc->rc,_enc->rc.cur_metrics.log_scale,4); + } + } + else if(_enc->packet_state==OC_PACKET_DONE&& + _enc->rc.twopass_buffer_bytes!=OC_RC_2PASS_HDR_SZ){ + _enc->rc.twopass_buffer_bytes=0; + oc_rc_buffer_val(&_enc->rc,0x5032544F,4); + oc_rc_buffer_val(&_enc->rc,OC_RC_2PASS_VERSION,4); + oc_rc_buffer_val(&_enc->rc,_enc->rc.frames_total[0],4); + oc_rc_buffer_val(&_enc->rc,_enc->rc.frames_total[1],4); + oc_rc_buffer_val(&_enc->rc,_enc->rc.frames_total[2],4); + oc_rc_buffer_val(&_enc->rc,_enc->rc.exp[0],1); + oc_rc_buffer_val(&_enc->rc,_enc->rc.exp[1],1); + oc_rc_buffer_val(&_enc->rc,_enc->rc.scale_sum[0],8); + oc_rc_buffer_val(&_enc->rc,_enc->rc.scale_sum[1],8); + } + else{ + /*The data for this frame has already been retrieved.*/ + *_buf=NULL; + return 0; + } + *_buf=_enc->rc.twopass_buffer; + return _enc->rc.twopass_buffer_bytes; +} + +static size_t oc_rc_buffer_fill(oc_rc_state *_rc, + unsigned char *_buf,size_t _bytes,size_t _consumed,size_t _goal){ + while(_rc->twopass_buffer_fill<_goal&&_consumed<_bytes){ + _rc->twopass_buffer[_rc->twopass_buffer_fill++]=_buf[_consumed++]; + } + return _consumed; +} + +static ogg_int64_t oc_rc_unbuffer_val(oc_rc_state *_rc,int _bytes){ + ogg_int64_t ret; + int shift; + ret=0; + shift=0; + while(_bytes-->0){ + ret|=((ogg_int64_t)_rc->twopass_buffer[_rc->twopass_buffer_bytes++])<rc.twopass==0){ + _enc->rc.twopass=2; + _enc->rc.twopass_buffer_fill=0; + _enc->rc.frames_total[0]=0; + _enc->rc.nframe_metrics=0; + _enc->rc.cframe_metrics=0; + _enc->rc.frame_metrics_head=0; + _enc->rc.scale_window0=0; + _enc->rc.scale_window_end=0; + } + /*If we haven't got a valid summary header yet, try to parse one.*/ + if(_enc->rc.frames_total[0]==0){ + if(!_buf){ + int frames_needed; + /*If we're using a whole-file buffer, we just need the first frame. + Otherwise, we may need as many as one per buffer slot.*/ + frames_needed=_enc->rc.frame_metrics==NULL?1:_enc->rc.buf_delay; + return OC_RC_2PASS_HDR_SZ+frames_needed*OC_RC_2PASS_PACKET_SZ + -_enc->rc.twopass_buffer_fill; + } + consumed=oc_rc_buffer_fill(&_enc->rc, + _buf,_bytes,consumed,OC_RC_2PASS_HDR_SZ); + if(_enc->rc.twopass_buffer_fill>=OC_RC_2PASS_HDR_SZ){ + ogg_int64_t scale_sum[2]; + int exp[2]; + int buf_delay; + /*Read the summary header data.*/ + /*Check the magic value and version number.*/ + if(oc_rc_unbuffer_val(&_enc->rc,4)!=0x5032544F|| + oc_rc_unbuffer_val(&_enc->rc,4)!=OC_RC_2PASS_VERSION){ + _enc->rc.twopass_buffer_bytes=0; + return TH_ENOTFORMAT; + } + _enc->rc.frames_total[0]=(ogg_uint32_t)oc_rc_unbuffer_val(&_enc->rc,4); + _enc->rc.frames_total[1]=(ogg_uint32_t)oc_rc_unbuffer_val(&_enc->rc,4); + _enc->rc.frames_total[2]=(ogg_uint32_t)oc_rc_unbuffer_val(&_enc->rc,4); + exp[0]=(int)oc_rc_unbuffer_val(&_enc->rc,1); + exp[1]=(int)oc_rc_unbuffer_val(&_enc->rc,1); + scale_sum[0]=oc_rc_unbuffer_val(&_enc->rc,8); + scale_sum[1]=oc_rc_unbuffer_val(&_enc->rc,8); + /*Make sure the file claims to have at least one frame. + Otherwise we probably got the placeholder data from an aborted pass 1. + Also make sure the total frame count doesn't overflow an integer.*/ + buf_delay=_enc->rc.frames_total[0]+_enc->rc.frames_total[1] + +_enc->rc.frames_total[2]; + if(_enc->rc.frames_total[0]==0||buf_delay<0|| + (ogg_uint32_t)buf_delay<_enc->rc.frames_total[0]|| + (ogg_uint32_t)buf_delay<_enc->rc.frames_total[1]){ + _enc->rc.frames_total[0]=0; + _enc->rc.twopass_buffer_bytes=0; + return TH_EBADHEADER; + } + /*Got a valid header; set up pass 2.*/ + _enc->rc.frames_left[0]=_enc->rc.frames_total[0]; + _enc->rc.frames_left[1]=_enc->rc.frames_total[1]; + _enc->rc.frames_left[2]=_enc->rc.frames_total[2]; + /*If the user hasn't specified a buffer size, use the whole file.*/ + if(_enc->rc.frame_metrics==NULL){ + _enc->rc.buf_delay=buf_delay; + _enc->rc.nframes[0]=_enc->rc.frames_total[0]; + _enc->rc.nframes[1]=_enc->rc.frames_total[1]; + _enc->rc.nframes[2]=_enc->rc.frames_total[2]; + _enc->rc.scale_sum[0]=scale_sum[0]; + _enc->rc.scale_sum[1]=scale_sum[1]; + _enc->rc.scale_window_end=buf_delay; + oc_enc_rc_reset(_enc); + } + _enc->rc.exp[0]=exp[0]; + _enc->rc.exp[1]=exp[1]; + /*Clear the header data from the buffer to make room for packet data.*/ + _enc->rc.twopass_buffer_fill=0; + _enc->rc.twopass_buffer_bytes=0; + } + } + if(_enc->rc.frames_total[0]!=0){ + ogg_int64_t curframe_num; + int nframes_total; + curframe_num=_enc->state.curframe_num; + if(curframe_num>=0){ + /*We just encoded a frame; make sure things matched.*/ + if(_enc->rc.prev_metrics.dup_count!=_enc->prev_dup_count){ + _enc->rc.twopass_buffer_bytes=0; + return TH_EINVAL; + } + } + curframe_num+=_enc->prev_dup_count+1; + nframes_total=_enc->rc.frames_total[0]+_enc->rc.frames_total[1] + +_enc->rc.frames_total[2]; + if(curframe_num>=nframes_total){ + /*We don't want any more data after the last frame, and we don't want to + allow any more frames to be encoded.*/ + _enc->rc.twopass_buffer_bytes=0; + } + else if(_enc->rc.twopass_buffer_bytes==0){ + if(_enc->rc.frame_metrics==NULL){ + /*We're using a whole-file buffer:*/ + if(!_buf)return OC_RC_2PASS_PACKET_SZ-_enc->rc.twopass_buffer_fill; + consumed=oc_rc_buffer_fill(&_enc->rc, + _buf,_bytes,consumed,OC_RC_2PASS_PACKET_SZ); + if(_enc->rc.twopass_buffer_fill>=OC_RC_2PASS_PACKET_SZ){ + ogg_uint32_t dup_count; + ogg_int32_t log_scale; + int qti; + int arg; + /*Read the metrics for the next frame.*/ + dup_count=oc_rc_unbuffer_val(&_enc->rc,4); + log_scale=oc_rc_unbuffer_val(&_enc->rc,4); + _enc->rc.cur_metrics.log_scale=log_scale; + qti=(dup_count&0x80000000)>>31; + _enc->rc.cur_metrics.dup_count=dup_count&0x7FFFFFFF; + _enc->rc.cur_metrics.frame_type=qti; + _enc->rc.twopass_force_kf=qti==OC_INTRA_FRAME; + /*"Helpfully" set the dup count back to what it was in pass 1.*/ + arg=_enc->rc.cur_metrics.dup_count; + th_encode_ctl(_enc,TH_ENCCTL_SET_DUP_COUNT,&arg,sizeof(arg)); + /*Clear the buffer for the next frame.*/ + _enc->rc.twopass_buffer_fill=0; + } + } + else{ + int frames_needed; + /*We're using a finite buffer:*/ + frames_needed=OC_CLAMPI(0,_enc->rc.buf_delay + -(_enc->rc.scale_window_end-_enc->rc.scale_window0), + _enc->rc.frames_left[0]+_enc->rc.frames_left[1] + -_enc->rc.nframes[0]-_enc->rc.nframes[1]); + while(frames_needed>0){ + if(!_buf){ + return OC_RC_2PASS_PACKET_SZ*frames_needed + -_enc->rc.twopass_buffer_fill; + } + consumed=oc_rc_buffer_fill(&_enc->rc, + _buf,_bytes,consumed,OC_RC_2PASS_PACKET_SZ); + if(_enc->rc.twopass_buffer_fill>=OC_RC_2PASS_PACKET_SZ){ + oc_frame_metrics *m; + int fmi; + ogg_uint32_t dup_count; + ogg_int32_t log_scale; + int qti; + /*Read the metrics for the next frame.*/ + dup_count=oc_rc_unbuffer_val(&_enc->rc,4); + log_scale=oc_rc_unbuffer_val(&_enc->rc,4); + /*Add the to the circular buffer.*/ + fmi=_enc->rc.frame_metrics_head+_enc->rc.nframe_metrics++; + if(fmi>=_enc->rc.cframe_metrics)fmi-=_enc->rc.cframe_metrics; + m=_enc->rc.frame_metrics+fmi; + m->log_scale=log_scale; + qti=(dup_count&0x80000000)>>31; + m->dup_count=dup_count&0x7FFFFFFF; + m->frame_type=qti; + /*And accumulate the statistics over the window.*/ + _enc->rc.nframes[qti]++; + _enc->rc.nframes[2]+=m->dup_count; + _enc->rc.scale_sum[qti]+=oc_bexp_q24(m->log_scale); + _enc->rc.scale_window_end+=m->dup_count+1; + /*Compute an upper bound on the number of remaining packets needed + for the current window.*/ + frames_needed=OC_CLAMPI(0,_enc->rc.buf_delay + -(_enc->rc.scale_window_end-_enc->rc.scale_window0), + _enc->rc.frames_left[0]+_enc->rc.frames_left[1] + -_enc->rc.nframes[0]-_enc->rc.nframes[1]); + /*Clear the buffer for the next frame.*/ + _enc->rc.twopass_buffer_fill=0; + _enc->rc.twopass_buffer_bytes=0; + } + /*Go back for more data.*/ + else break; + } + /*If we've got all the frames we need, fill in the current metrics. + We're ready to go.*/ + if(frames_needed<=0){ + int arg; + *&_enc->rc.cur_metrics= + *(_enc->rc.frame_metrics+_enc->rc.frame_metrics_head); + _enc->rc.twopass_force_kf= + _enc->rc.cur_metrics.frame_type==OC_INTRA_FRAME; + /*"Helpfully" set the dup count back to what it was in pass 1.*/ + arg=_enc->rc.cur_metrics.dup_count; + th_encode_ctl(_enc,TH_ENCCTL_SET_DUP_COUNT,&arg,sizeof(arg)); + /*Mark us ready for the next frame.*/ + _enc->rc.twopass_buffer_bytes=1; + } + } + } + } + return (int)consumed; +} diff --git a/libs/libtheora-1.1/lib/state.c b/libs/libtheora-1.1/lib/state.c new file mode 100644 index 00000000..f1aa5890 --- /dev/null +++ b/libs/libtheora-1.1/lib/state.c @@ -0,0 +1,1227 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: state.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include "internal.h" +#if defined(OC_X86_ASM) +#if defined(_MSC_VER) +# include "x86_vc/x86int.h" +#else +# include "x86/x86int.h" +#endif +#endif +#if defined(OC_DUMP_IMAGES) +# include +# include "png.h" +#endif + +/*Returns the fragment index of the top-left block in a macro block. + This can be used to test whether or not the whole macro block is valid. + _sb_map: The super block map. + _quadi: The quadrant number. + Return: The index of the fragment of the upper left block in the macro + block, or -1 if the block lies outside the coded frame.*/ +static ptrdiff_t oc_sb_quad_top_left_frag(oc_sb_map_quad _sb_map[4],int _quadi){ + /*It so happens that under the Hilbert curve ordering described below, the + upper-left block in each macro block is at index 0, except in macro block + 3, where it is at index 2.*/ + return _sb_map[_quadi][_quadi&_quadi<<1]; +} + +/*Fills in the mapping from block positions to fragment numbers for a single + color plane. + This function also fills in the "valid" flag of each quadrant in the super + block flags. + _sb_maps: The array of super block maps for the color plane. + _sb_flags: The array of super block flags for the color plane. + _frag0: The index of the first fragment in the plane. + _hfrags: The number of horizontal fragments in a coded frame. + _vfrags: The number of vertical fragments in a coded frame.*/ +static void oc_sb_create_plane_mapping(oc_sb_map _sb_maps[], + oc_sb_flags _sb_flags[],ptrdiff_t _frag0,int _hfrags,int _vfrags){ + /*Contains the (macro_block,block) indices for a 4x4 grid of + fragments. + The pattern is a 4x4 Hilbert space-filling curve. + A Hilbert curve has the nice property that as the curve grows larger, its + fractal dimension approaches 2. + The intuition is that nearby blocks in the curve are also close spatially, + with the previous element always an immediate neighbor, so that runs of + blocks should be well correlated.*/ + static const int SB_MAP[4][4][2]={ + {{0,0},{0,1},{3,2},{3,3}}, + {{0,3},{0,2},{3,1},{3,0}}, + {{1,0},{1,3},{2,0},{2,3}}, + {{1,1},{1,2},{2,1},{2,2}} + }; + ptrdiff_t yfrag; + unsigned sbi; + int y; + sbi=0; + yfrag=_frag0; + for(y=0;;y+=4){ + int imax; + int x; + /*Figure out how many columns of blocks in this super block lie within the + image.*/ + imax=_vfrags-y; + if(imax>4)imax=4; + else if(imax<=0)break; + for(x=0;;x+=4,sbi++){ + ptrdiff_t xfrag; + int jmax; + int quadi; + int i; + /*Figure out how many rows of blocks in this super block lie within the + image.*/ + jmax=_hfrags-x; + if(jmax>4)jmax=4; + else if(jmax<=0)break; + /*By default, set all fragment indices to -1.*/ + memset(_sb_maps[sbi][0],0xFF,sizeof(_sb_maps[sbi])); + /*Fill in the fragment map for this super block.*/ + xfrag=yfrag+x; + for(i=0;i=0)<nhfrags+_xfrag0+j; + } +} + +/*Fills in the chroma plane fragment maps for a macro block. + This version is for use with chroma decimated in the X and Y directions + (4:2:0). + _mb_map: The macro block map to fill. + _fplanes: The descriptions of the fragment planes. + _xfrag0: The X location of the upper-left hand fragment in the luma plane. + _yfrag0: The Y location of the upper-left hand fragment in the luma plane.*/ +static void oc_mb_fill_cmapping00(oc_mb_map_plane _mb_map[3], + const oc_fragment_plane _fplanes[3],int _xfrag0,int _yfrag0){ + ptrdiff_t fragi; + _xfrag0>>=1; + _yfrag0>>=1; + fragi=_yfrag0*(ptrdiff_t)_fplanes[1].nhfrags+_xfrag0; + _mb_map[1][0]=fragi+_fplanes[1].froffset; + _mb_map[2][0]=fragi+_fplanes[2].froffset; +} + +/*Fills in the chroma plane fragment maps for a macro block. + This version is for use with chroma decimated in the Y direction. + _mb_map: The macro block map to fill. + _fplanes: The descriptions of the fragment planes. + _xfrag0: The X location of the upper-left hand fragment in the luma plane. + _yfrag0: The Y location of the upper-left hand fragment in the luma plane.*/ +static void oc_mb_fill_cmapping01(oc_mb_map_plane _mb_map[3], + const oc_fragment_plane _fplanes[3],int _xfrag0,int _yfrag0){ + ptrdiff_t fragi; + int j; + _yfrag0>>=1; + fragi=_yfrag0*(ptrdiff_t)_fplanes[1].nhfrags+_xfrag0; + for(j=0;j<2;j++){ + _mb_map[1][j]=fragi+_fplanes[1].froffset; + _mb_map[2][j]=fragi+_fplanes[2].froffset; + fragi++; + } +} + +/*Fills in the chroma plane fragment maps for a macro block. + This version is for use with chroma decimated in the X direction (4:2:2). + _mb_map: The macro block map to fill. + _fplanes: The descriptions of the fragment planes. + _xfrag0: The X location of the upper-left hand fragment in the luma plane. + _yfrag0: The Y location of the upper-left hand fragment in the luma plane.*/ +static void oc_mb_fill_cmapping10(oc_mb_map_plane _mb_map[3], + const oc_fragment_plane _fplanes[3],int _xfrag0,int _yfrag0){ + ptrdiff_t fragi; + int i; + _xfrag0>>=1; + fragi=_yfrag0*(ptrdiff_t)_fplanes[1].nhfrags+_xfrag0; + for(i=0;i<2;i++){ + _mb_map[1][i<<1]=fragi+_fplanes[1].froffset; + _mb_map[2][i<<1]=fragi+_fplanes[2].froffset; + fragi+=_fplanes[1].nhfrags; + } +} + +/*Fills in the chroma plane fragment maps for a macro block. + This version is for use with no chroma decimation (4:4:4). + This uses the already filled-in luma plane values. + _mb_map: The macro block map to fill. + _fplanes: The descriptions of the fragment planes.*/ +static void oc_mb_fill_cmapping11(oc_mb_map_plane _mb_map[3], + const oc_fragment_plane _fplanes[3]){ + int k; + for(k=0;k<4;k++){ + _mb_map[1][k]=_mb_map[0][k]+_fplanes[1].froffset; + _mb_map[2][k]=_mb_map[0][k]+_fplanes[2].froffset; + } +} + +/*The function type used to fill in the chroma plane fragment maps for a + macro block. + _mb_map: The macro block map to fill. + _fplanes: The descriptions of the fragment planes. + _xfrag0: The X location of the upper-left hand fragment in the luma plane. + _yfrag0: The Y location of the upper-left hand fragment in the luma plane.*/ +typedef void (*oc_mb_fill_cmapping_func)(oc_mb_map_plane _mb_map[3], + const oc_fragment_plane _fplanes[3],int _xfrag0,int _yfrag0); + +/*A table of functions used to fill in the chroma plane fragment maps for a + macro block for each type of chrominance decimation.*/ +static const oc_mb_fill_cmapping_func OC_MB_FILL_CMAPPING_TABLE[4]={ + oc_mb_fill_cmapping00, + oc_mb_fill_cmapping01, + oc_mb_fill_cmapping10, + (oc_mb_fill_cmapping_func)oc_mb_fill_cmapping11 +}; + +/*Fills in the mapping from macro blocks to their corresponding fragment + numbers in each plane. + _mb_maps: The list of macro block maps. + _mb_modes: The list of macro block modes; macro blocks completely outside + the coded region are marked invalid. + _fplanes: The descriptions of the fragment planes. + _pixel_fmt: The chroma decimation type.*/ +static void oc_mb_create_mapping(oc_mb_map _mb_maps[], + signed char _mb_modes[],const oc_fragment_plane _fplanes[3],int _pixel_fmt){ + oc_mb_fill_cmapping_func mb_fill_cmapping; + unsigned sbi; + int y; + mb_fill_cmapping=OC_MB_FILL_CMAPPING_TABLE[_pixel_fmt]; + /*Loop through the luma plane super blocks.*/ + for(sbi=y=0;y<_fplanes[0].nvfrags;y+=4){ + int x; + for(x=0;x<_fplanes[0].nhfrags;x+=4,sbi++){ + int ymb; + /*Loop through the macro blocks in each super block in display order.*/ + for(ymb=0;ymb<2;ymb++){ + int xmb; + for(xmb=0;xmb<2;xmb++){ + unsigned mbi; + int mbx; + int mby; + mbi=sbi<<2|OC_MB_MAP[ymb][xmb]; + mbx=x|xmb<<1; + mby=y|ymb<<1; + /*Initialize fragment indices to -1.*/ + memset(_mb_maps[mbi],0xFF,sizeof(_mb_maps[mbi])); + /*Make sure this macro block is within the encoded region.*/ + if(mbx>=_fplanes[0].nhfrags||mby>=_fplanes[0].nvfrags){ + _mb_modes[mbi]=OC_MODE_INVALID; + continue; + } + /*Fill in the fragment indices for the luma plane.*/ + oc_mb_fill_ymapping(_mb_maps[mbi],_fplanes,mbx,mby); + /*Fill in the fragment indices for the chroma planes.*/ + (*mb_fill_cmapping)(_mb_maps[mbi],_fplanes,mbx,mby); + } + } + } + } +} + +/*Marks the fragments which fall all or partially outside the displayable + region of the frame. + _state: The Theora state containing the fragments to be marked.*/ +static void oc_state_border_init(oc_theora_state *_state){ + oc_fragment *frag; + oc_fragment *yfrag_end; + oc_fragment *xfrag_end; + oc_fragment_plane *fplane; + int crop_x0; + int crop_y0; + int crop_xf; + int crop_yf; + int pli; + int y; + int x; + /*The method we use here is slow, but the code is dead simple and handles + all the special cases easily. + We only ever need to do it once.*/ + /*Loop through the fragments, marking those completely outside the + displayable region and constructing a border mask for those that straddle + the border.*/ + _state->nborders=0; + yfrag_end=frag=_state->frags; + for(pli=0;pli<3;pli++){ + fplane=_state->fplanes+pli; + /*Set up the cropping rectangle for this plane.*/ + crop_x0=_state->info.pic_x; + crop_xf=_state->info.pic_x+_state->info.pic_width; + crop_y0=_state->info.pic_y; + crop_yf=_state->info.pic_y+_state->info.pic_height; + if(pli>0){ + if(!(_state->info.pixel_fmt&1)){ + crop_x0=crop_x0>>1; + crop_xf=crop_xf+1>>1; + } + if(!(_state->info.pixel_fmt&2)){ + crop_y0=crop_y0>>1; + crop_yf=crop_yf+1>>1; + } + } + y=0; + for(yfrag_end+=fplane->nfrags;fragnhfrags;frag=crop_xf||crop_y0>=crop_yf){ + frag->invalid=1; + } + /*Otherwise, check to see if it straddles the border.*/ + else if(x=crop_x0&&x+j=crop_y0&&y+i=_state->nborders){ + _state->nborders++; + _state->borders[i].mask=mask; + _state->borders[i].npixels=npixels; + } + else if(_state->borders[i].mask!=mask)continue; + frag->borderi=i; + break; + } + } + else frag->borderi=-1; + } + } + } +} + +static int oc_state_frarray_init(oc_theora_state *_state){ + int yhfrags; + int yvfrags; + int chfrags; + int cvfrags; + ptrdiff_t yfrags; + ptrdiff_t cfrags; + ptrdiff_t nfrags; + unsigned yhsbs; + unsigned yvsbs; + unsigned chsbs; + unsigned cvsbs; + unsigned ysbs; + unsigned csbs; + unsigned nsbs; + size_t nmbs; + int hdec; + int vdec; + int pli; + /*Figure out the number of fragments in each plane.*/ + /*These parameters have already been validated to be multiples of 16.*/ + yhfrags=_state->info.frame_width>>3; + yvfrags=_state->info.frame_height>>3; + hdec=!(_state->info.pixel_fmt&1); + vdec=!(_state->info.pixel_fmt&2); + chfrags=yhfrags+hdec>>hdec; + cvfrags=yvfrags+vdec>>vdec; + yfrags=yhfrags*(ptrdiff_t)yvfrags; + cfrags=chfrags*(ptrdiff_t)cvfrags; + nfrags=yfrags+2*cfrags; + /*Figure out the number of super blocks in each plane.*/ + yhsbs=yhfrags+3>>2; + yvsbs=yvfrags+3>>2; + chsbs=chfrags+3>>2; + cvsbs=cvfrags+3>>2; + ysbs=yhsbs*yvsbs; + csbs=chsbs*cvsbs; + nsbs=ysbs+2*csbs; + nmbs=(size_t)ysbs<<2; + /*Check for overflow. + We support the ridiculous upper limits of the specification (1048560 by + 1048560, or 3 TB frames) if the target architecture has 64-bit pointers, + but for those with 32-bit pointers (or smaller!) we have to check. + If the caller wants to prevent denial-of-service by imposing a more + reasonable upper limit on the size of attempted allocations, they must do + so themselves; we have no platform independent way to determine how much + system memory there is nor an application-independent way to decide what a + "reasonable" allocation is.*/ + if(yfrags/yhfrags!=yvfrags||2*cfrags>2!=ysbs){ + return TH_EIMPL; + } + /*Initialize the fragment array.*/ + _state->fplanes[0].nhfrags=yhfrags; + _state->fplanes[0].nvfrags=yvfrags; + _state->fplanes[0].froffset=0; + _state->fplanes[0].nfrags=yfrags; + _state->fplanes[0].nhsbs=yhsbs; + _state->fplanes[0].nvsbs=yvsbs; + _state->fplanes[0].sboffset=0; + _state->fplanes[0].nsbs=ysbs; + _state->fplanes[1].nhfrags=_state->fplanes[2].nhfrags=chfrags; + _state->fplanes[1].nvfrags=_state->fplanes[2].nvfrags=cvfrags; + _state->fplanes[1].froffset=yfrags; + _state->fplanes[2].froffset=yfrags+cfrags; + _state->fplanes[1].nfrags=_state->fplanes[2].nfrags=cfrags; + _state->fplanes[1].nhsbs=_state->fplanes[2].nhsbs=chsbs; + _state->fplanes[1].nvsbs=_state->fplanes[2].nvsbs=cvsbs; + _state->fplanes[1].sboffset=ysbs; + _state->fplanes[2].sboffset=ysbs+csbs; + _state->fplanes[1].nsbs=_state->fplanes[2].nsbs=csbs; + _state->nfrags=nfrags; + _state->frags=_ogg_calloc(nfrags,sizeof(*_state->frags)); + _state->frag_mvs=_ogg_malloc(nfrags*sizeof(*_state->frag_mvs)); + _state->nsbs=nsbs; + _state->sb_maps=_ogg_malloc(nsbs*sizeof(*_state->sb_maps)); + _state->sb_flags=_ogg_calloc(nsbs,sizeof(*_state->sb_flags)); + _state->nhmbs=yhsbs<<1; + _state->nvmbs=yvsbs<<1; + _state->nmbs=nmbs; + _state->mb_maps=_ogg_calloc(nmbs,sizeof(*_state->mb_maps)); + _state->mb_modes=_ogg_calloc(nmbs,sizeof(*_state->mb_modes)); + _state->coded_fragis=_ogg_malloc(nfrags*sizeof(*_state->coded_fragis)); + if(_state->frags==NULL||_state->frag_mvs==NULL||_state->sb_maps==NULL|| + _state->sb_flags==NULL||_state->mb_maps==NULL||_state->mb_modes==NULL|| + _state->coded_fragis==NULL){ + return TH_EFAULT; + } + /*Create the mapping from super blocks to fragments.*/ + for(pli=0;pli<3;pli++){ + oc_fragment_plane *fplane; + fplane=_state->fplanes+pli; + oc_sb_create_plane_mapping(_state->sb_maps+fplane->sboffset, + _state->sb_flags+fplane->sboffset,fplane->froffset, + fplane->nhfrags,fplane->nvfrags); + } + /*Create the mapping from macro blocks to fragments.*/ + oc_mb_create_mapping(_state->mb_maps,_state->mb_modes, + _state->fplanes,_state->info.pixel_fmt); + /*Initialize the invalid and borderi fields of each fragment.*/ + oc_state_border_init(_state); + return 0; +} + +static void oc_state_frarray_clear(oc_theora_state *_state){ + _ogg_free(_state->coded_fragis); + _ogg_free(_state->mb_modes); + _ogg_free(_state->mb_maps); + _ogg_free(_state->sb_flags); + _ogg_free(_state->sb_maps); + _ogg_free(_state->frag_mvs); + _ogg_free(_state->frags); +} + + +/*Initializes the buffers used for reconstructed frames. + These buffers are padded with 16 extra pixels on each side, to allow + unrestricted motion vectors without special casing the boundary. + If chroma is decimated in either direction, the padding is reduced by a + factor of 2 on the appropriate sides. + _nrefs: The number of reference buffers to init; must be 3 or 4.*/ +static int oc_state_ref_bufs_init(oc_theora_state *_state,int _nrefs){ + th_info *info; + unsigned char *ref_frame_data; + size_t ref_frame_data_sz; + size_t ref_frame_sz; + size_t yplane_sz; + size_t cplane_sz; + int yhstride; + int yheight; + int chstride; + int cheight; + ptrdiff_t yoffset; + ptrdiff_t coffset; + ptrdiff_t *frag_buf_offs; + ptrdiff_t fragi; + int hdec; + int vdec; + int rfi; + int pli; + if(_nrefs<3||_nrefs>4)return TH_EINVAL; + info=&_state->info; + /*Compute the image buffer parameters for each plane.*/ + hdec=!(info->pixel_fmt&1); + vdec=!(info->pixel_fmt&2); + yhstride=info->frame_width+2*OC_UMV_PADDING; + yheight=info->frame_height+2*OC_UMV_PADDING; + chstride=yhstride>>hdec; + cheight=yheight>>vdec; + yplane_sz=yhstride*(size_t)yheight; + cplane_sz=chstride*(size_t)cheight; + yoffset=OC_UMV_PADDING+OC_UMV_PADDING*(ptrdiff_t)yhstride; + coffset=(OC_UMV_PADDING>>hdec)+(OC_UMV_PADDING>>vdec)*(ptrdiff_t)chstride; + ref_frame_sz=yplane_sz+2*cplane_sz; + ref_frame_data_sz=_nrefs*ref_frame_sz; + /*Check for overflow. + The same caveats apply as for oc_state_frarray_init().*/ + if(yplane_sz/yhstride!=yheight||2*cplane_szfrag_buf_offs= + _ogg_malloc(_state->nfrags*sizeof(*frag_buf_offs)); + if(ref_frame_data==NULL||frag_buf_offs==NULL){ + _ogg_free(frag_buf_offs); + _ogg_free(ref_frame_data); + return TH_EFAULT; + } + /*Set up the width, height and stride for the image buffers.*/ + _state->ref_frame_bufs[0][0].width=info->frame_width; + _state->ref_frame_bufs[0][0].height=info->frame_height; + _state->ref_frame_bufs[0][0].stride=yhstride; + _state->ref_frame_bufs[0][1].width=_state->ref_frame_bufs[0][2].width= + info->frame_width>>hdec; + _state->ref_frame_bufs[0][1].height=_state->ref_frame_bufs[0][2].height= + info->frame_height>>vdec; + _state->ref_frame_bufs[0][1].stride=_state->ref_frame_bufs[0][2].stride= + chstride; + for(rfi=1;rfi<_nrefs;rfi++){ + memcpy(_state->ref_frame_bufs[rfi],_state->ref_frame_bufs[0], + sizeof(_state->ref_frame_bufs[0])); + } + /*Set up the data pointers for the image buffers.*/ + for(rfi=0;rfi<_nrefs;rfi++){ + _state->ref_frame_data[rfi]=ref_frame_data; + _state->ref_frame_bufs[rfi][0].data=ref_frame_data+yoffset; + ref_frame_data+=yplane_sz; + _state->ref_frame_bufs[rfi][1].data=ref_frame_data+coffset; + ref_frame_data+=cplane_sz; + _state->ref_frame_bufs[rfi][2].data=ref_frame_data+coffset; + ref_frame_data+=cplane_sz; + /*Flip the buffer upside down. + This allows us to decode Theora's bottom-up frames in their natural + order, yet return a top-down buffer with a positive stride to the user.*/ + oc_ycbcr_buffer_flip(_state->ref_frame_bufs[rfi], + _state->ref_frame_bufs[rfi]); + } + _state->ref_ystride[0]=-yhstride; + _state->ref_ystride[1]=_state->ref_ystride[2]=-chstride; + /*Initialize the fragment buffer offsets.*/ + ref_frame_data=_state->ref_frame_data[0]; + fragi=0; + for(pli=0;pli<3;pli++){ + th_img_plane *iplane; + oc_fragment_plane *fplane; + unsigned char *vpix; + ptrdiff_t stride; + ptrdiff_t vfragi_end; + int nhfrags; + iplane=_state->ref_frame_bufs[0]+pli; + fplane=_state->fplanes+pli; + vpix=iplane->data; + vfragi_end=fplane->froffset+fplane->nfrags; + nhfrags=fplane->nhfrags; + stride=iplane->stride; + while(fragiref_frame_idx[OC_FRAME_GOLD]= + _state->ref_frame_idx[OC_FRAME_PREV]= + _state->ref_frame_idx[OC_FRAME_SELF]=-1; + _state->ref_frame_idx[OC_FRAME_IO]=_nrefs>3?3:-1; + return 0; +} + +static void oc_state_ref_bufs_clear(oc_theora_state *_state){ + _ogg_free(_state->frag_buf_offs); + _ogg_free(_state->ref_frame_data[0]); +} + + +void oc_state_vtable_init_c(oc_theora_state *_state){ + _state->opt_vtable.frag_copy=oc_frag_copy_c; + _state->opt_vtable.frag_recon_intra=oc_frag_recon_intra_c; + _state->opt_vtable.frag_recon_inter=oc_frag_recon_inter_c; + _state->opt_vtable.frag_recon_inter2=oc_frag_recon_inter2_c; + _state->opt_vtable.idct8x8=oc_idct8x8_c; + _state->opt_vtable.state_frag_recon=oc_state_frag_recon_c; + _state->opt_vtable.state_frag_copy_list=oc_state_frag_copy_list_c; + _state->opt_vtable.state_loop_filter_frag_rows= + oc_state_loop_filter_frag_rows_c; + _state->opt_vtable.restore_fpu=oc_restore_fpu_c; + _state->opt_data.dct_fzig_zag=OC_FZIG_ZAG; +} + +/*Initialize the accelerated function pointers.*/ +void oc_state_vtable_init(oc_theora_state *_state){ +#if defined(OC_X86_ASM) + oc_state_vtable_init_x86(_state); +#else + oc_state_vtable_init_c(_state); +#endif +} + + +int oc_state_init(oc_theora_state *_state,const th_info *_info,int _nrefs){ + int ret; + /*First validate the parameters.*/ + if(_info==NULL)return TH_EFAULT; + /*The width and height of the encoded frame must be multiples of 16. + They must also, when divided by 16, fit into a 16-bit unsigned integer. + The displayable frame offset coordinates must fit into an 8-bit unsigned + integer. + Note that the offset Y in the API is specified on the opposite side from + how it is specified in the bitstream, because the Y axis is flipped in + the bitstream. + The displayable frame must fit inside the encoded frame. + The color space must be one known by the encoder.*/ + if((_info->frame_width&0xF)||(_info->frame_height&0xF)|| + _info->frame_width<=0||_info->frame_width>=0x100000|| + _info->frame_height<=0||_info->frame_height>=0x100000|| + _info->pic_x+_info->pic_width>_info->frame_width|| + _info->pic_y+_info->pic_height>_info->frame_height|| + _info->pic_x>255||_info->frame_height-_info->pic_height-_info->pic_y>255|| + /*Note: the following <0 comparisons may generate spurious warnings on + platforms where enums are unsigned. + We could cast them to unsigned and just use the following >= comparison, + but there are a number of compilers which will mis-optimize this. + It's better to live with the spurious warnings.*/ + _info->colorspace<0||_info->colorspace>=TH_CS_NSPACES|| + _info->pixel_fmt<0||_info->pixel_fmt>=TH_PF_NFORMATS){ + return TH_EINVAL; + } + memset(_state,0,sizeof(*_state)); + memcpy(&_state->info,_info,sizeof(*_info)); + /*Invert the sense of pic_y to match Theora's right-handed coordinate + system.*/ + _state->info.pic_y=_info->frame_height-_info->pic_height-_info->pic_y; + _state->frame_type=OC_UNKWN_FRAME; + oc_state_vtable_init(_state); + ret=oc_state_frarray_init(_state); + if(ret>=0)ret=oc_state_ref_bufs_init(_state,_nrefs); + if(ret<0){ + oc_state_frarray_clear(_state); + return ret; + } + /*If the keyframe_granule_shift is out of range, use the maximum allowable + value.*/ + if(_info->keyframe_granule_shift<0||_info->keyframe_granule_shift>31){ + _state->info.keyframe_granule_shift=31; + } + _state->keyframe_num=0; + _state->curframe_num=-1; + /*3.2.0 streams mark the frame index instead of the frame count. + This was changed with stream version 3.2.1 to conform to other Ogg + codecs. + We add an extra bias when computing granule positions for new streams.*/ + _state->granpos_bias=TH_VERSION_CHECK(_info,3,2,1); + return 0; +} + +void oc_state_clear(oc_theora_state *_state){ + oc_state_ref_bufs_clear(_state); + oc_state_frarray_clear(_state); +} + + +/*Duplicates the pixels on the border of the image plane out into the + surrounding padding for use by unrestricted motion vectors. + This function only adds the left and right borders, and only for the fragment + rows specified. + _refi: The index of the reference buffer to pad. + _pli: The color plane. + _y0: The Y coordinate of the first row to pad. + _yend: The Y coordinate of the row to stop padding at.*/ +void oc_state_borders_fill_rows(oc_theora_state *_state,int _refi,int _pli, + int _y0,int _yend){ + th_img_plane *iplane; + unsigned char *apix; + unsigned char *bpix; + unsigned char *epix; + int stride; + int hpadding; + hpadding=OC_UMV_PADDING>>(_pli!=0&&!(_state->info.pixel_fmt&1)); + iplane=_state->ref_frame_bufs[_refi]+_pli; + stride=iplane->stride; + apix=iplane->data+_y0*(ptrdiff_t)stride; + bpix=apix+iplane->width-1; + epix=iplane->data+_yend*(ptrdiff_t)stride; + /*Note the use of != instead of <, which allows the stride to be negative.*/ + while(apix!=epix){ + memset(apix-hpadding,apix[0],hpadding); + memset(bpix+1,bpix[0],hpadding); + apix+=stride; + bpix+=stride; + } +} + +/*Duplicates the pixels on the border of the image plane out into the + surrounding padding for use by unrestricted motion vectors. + This function only adds the top and bottom borders, and must be called after + the left and right borders are added. + _refi: The index of the reference buffer to pad. + _pli: The color plane.*/ +void oc_state_borders_fill_caps(oc_theora_state *_state,int _refi,int _pli){ + th_img_plane *iplane; + unsigned char *apix; + unsigned char *bpix; + unsigned char *epix; + int stride; + int hpadding; + int vpadding; + int fullw; + hpadding=OC_UMV_PADDING>>(_pli!=0&&!(_state->info.pixel_fmt&1)); + vpadding=OC_UMV_PADDING>>(_pli!=0&&!(_state->info.pixel_fmt&2)); + iplane=_state->ref_frame_bufs[_refi]+_pli; + stride=iplane->stride; + fullw=iplane->width+(hpadding<<1); + apix=iplane->data-hpadding; + bpix=iplane->data+(iplane->height-1)*(ptrdiff_t)stride-hpadding; + epix=apix-stride*(ptrdiff_t)vpadding; + while(apix!=epix){ + memcpy(apix-stride,apix,fullw); + memcpy(bpix+stride,bpix,fullw); + apix-=stride; + bpix+=stride; + } +} + +/*Duplicates the pixels on the border of the given reference image out into + the surrounding padding for use by unrestricted motion vectors. + _state: The context containing the reference buffers. + _refi: The index of the reference buffer to pad.*/ +void oc_state_borders_fill(oc_theora_state *_state,int _refi){ + int pli; + for(pli=0;pli<3;pli++){ + oc_state_borders_fill_rows(_state,_refi,pli,0, + _state->ref_frame_bufs[_refi][pli].height); + oc_state_borders_fill_caps(_state,_refi,pli); + } +} + +/*Determines the offsets in an image buffer to use for motion compensation. + _state: The Theora state the offsets are to be computed with. + _offsets: Returns the offset for the buffer(s). + _offsets[0] is always set. + _offsets[1] is set if the motion vector has non-zero fractional + components. + _pli: The color plane index. + _dx: The X component of the motion vector. + _dy: The Y component of the motion vector. + Return: The number of offsets returned: 1 or 2.*/ +int oc_state_get_mv_offsets(const oc_theora_state *_state,int _offsets[2], + int _pli,int _dx,int _dy){ + /*Here is a brief description of how Theora handles motion vectors: + Motion vector components are specified to half-pixel accuracy in + undecimated directions of each plane, and quarter-pixel accuracy in + decimated directions. + Integer parts are extracted by dividing (not shifting) by the + appropriate amount, with truncation towards zero. + These integer values are used to calculate the first offset. + + If either of the fractional parts are non-zero, then a second offset is + computed. + No third or fourth offsets are computed, even if both components have + non-zero fractional parts. + The second offset is computed by dividing (not shifting) by the + appropriate amount, always truncating _away_ from zero.*/ +#if 0 + /*This version of the code doesn't use any tables, but is slower.*/ + int ystride; + int xprec; + int yprec; + int xfrac; + int yfrac; + int offs; + ystride=_state->ref_ystride[_pli]; + /*These two variables decide whether we are in half- or quarter-pixel + precision in each component.*/ + xprec=1+(_pli!=0&&!(_state->info.pixel_fmt&1)); + yprec=1+(_pli!=0&&!(_state->info.pixel_fmt&2)); + /*These two variables are either 0 if all the fractional bits are zero or -1 + if any of them are non-zero.*/ + xfrac=OC_SIGNMASK(-(_dx&(xprec|1))); + yfrac=OC_SIGNMASK(-(_dy&(yprec|1))); + offs=(_dx>>xprec)+(_dy>>yprec)*ystride; + if(xfrac||yfrac){ + int xmask; + int ymask; + xmask=OC_SIGNMASK(_dx); + ymask=OC_SIGNMASK(_dy); + yfrac&=ystride; + _offsets[0]=offs-(xfrac&xmask)+(yfrac&ymask); + _offsets[1]=offs-(xfrac&~xmask)+(yfrac&~ymask); + return 2; + } + else{ + _offsets[0]=offs; + return 1; + } +#else + /*Using tables simplifies the code, and there's enough arithmetic to hide the + latencies of the memory references.*/ + static const signed char OC_MVMAP[2][64]={ + { + -15,-15,-14,-14,-13,-13,-12,-12,-11,-11,-10,-10, -9, -9, -8, + -8, -7, -7, -6, -6, -5, -5, -4, -4, -3, -3, -2, -2, -1, -1, 0, + 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, + 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13, 14, 14, 15, 15 + }, + { + -7, -7, -7, -7, -6, -6, -6, -6, -5, -5, -5, -5, -4, -4, -4, + -4, -3, -3, -3, -3, -2, -2, -2, -2, -1, -1, -1, -1, 0, 0, 0, + 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, + 4, 4, 4, 4, 5, 5, 5, 5, 6, 6, 6, 6, 7, 7, 7, 7 + } + }; + static const signed char OC_MVMAP2[2][64]={ + { + -1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, + 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, 0,-1, + 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, + 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1 + }, + { + -1,-1,-1, 0,-1,-1,-1, 0,-1,-1,-1, 0,-1,-1,-1, + 0,-1,-1,-1, 0,-1,-1,-1, 0,-1,-1,-1, 0,-1,-1,-1, + 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, + 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1 + } + }; + int ystride; + int qpx; + int qpy; + int mx; + int my; + int mx2; + int my2; + int offs; + ystride=_state->ref_ystride[_pli]; + qpy=_pli!=0&&!(_state->info.pixel_fmt&2); + my=OC_MVMAP[qpy][_dy+31]; + my2=OC_MVMAP2[qpy][_dy+31]; + qpx=_pli!=0&&!(_state->info.pixel_fmt&1); + mx=OC_MVMAP[qpx][_dx+31]; + mx2=OC_MVMAP2[qpx][_dx+31]; + offs=my*ystride+mx; + if(mx2||my2){ + _offsets[1]=offs+my2*ystride+mx2; + _offsets[0]=offs; + return 2; + } + _offsets[0]=offs; + return 1; +#endif +} + +void oc_state_frag_recon(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant){ + _state->opt_vtable.state_frag_recon(_state,_fragi,_pli,_dct_coeffs, + _last_zzi,_dc_quant); +} + +void oc_state_frag_recon_c(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant){ + unsigned char *dst; + ptrdiff_t frag_buf_off; + int ystride; + int mb_mode; + /*Apply the inverse transform.*/ + /*Special case only having a DC component.*/ + if(_last_zzi<2){ + ogg_int16_t p; + int ci; + /*We round this dequant product (and not any of the others) because there's + no iDCT rounding.*/ + p=(ogg_int16_t)(_dct_coeffs[0]*(ogg_int32_t)_dc_quant+15>>5); + /*LOOP VECTORIZES.*/ + for(ci=0;ci<64;ci++)_dct_coeffs[ci]=p; + } + else{ + /*First, dequantize the DC coefficient.*/ + _dct_coeffs[0]=(ogg_int16_t)(_dct_coeffs[0]*(int)_dc_quant); + oc_idct8x8(_state,_dct_coeffs,_last_zzi); + } + /*Fill in the target buffer.*/ + frag_buf_off=_state->frag_buf_offs[_fragi]; + mb_mode=_state->frags[_fragi].mb_mode; + ystride=_state->ref_ystride[_pli]; + dst=_state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_SELF]]+frag_buf_off; + if(mb_mode==OC_MODE_INTRA)oc_frag_recon_intra(_state,dst,ystride,_dct_coeffs); + else{ + const unsigned char *ref; + int mvoffsets[2]; + ref= + _state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_FOR_MODE(mb_mode)]] + +frag_buf_off; + if(oc_state_get_mv_offsets(_state,mvoffsets,_pli, + _state->frag_mvs[_fragi][0],_state->frag_mvs[_fragi][1])>1){ + oc_frag_recon_inter2(_state, + dst,ref+mvoffsets[0],ref+mvoffsets[1],ystride,_dct_coeffs); + } + else oc_frag_recon_inter(_state,dst,ref+mvoffsets[0],ystride,_dct_coeffs); + } +} + +/*Copies the fragments specified by the lists of fragment indices from one + frame to another. + _fragis: A pointer to a list of fragment indices. + _nfragis: The number of fragment indices to copy. + _dst_frame: The reference frame to copy to. + _src_frame: The reference frame to copy from. + _pli: The color plane the fragments lie in.*/ +void oc_state_frag_copy_list(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli){ + _state->opt_vtable.state_frag_copy_list(_state,_fragis,_nfragis,_dst_frame, + _src_frame,_pli); +} + +void oc_state_frag_copy_list_c(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli){ + const ptrdiff_t *frag_buf_offs; + const unsigned char *src_frame_data; + unsigned char *dst_frame_data; + ptrdiff_t fragii; + int ystride; + dst_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_dst_frame]]; + src_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_src_frame]]; + ystride=_state->ref_ystride[_pli]; + frag_buf_offs=_state->frag_buf_offs; + for(fragii=0;fragii<_nfragis;fragii++){ + ptrdiff_t frag_buf_off; + frag_buf_off=frag_buf_offs[_fragis[fragii]]; + oc_frag_copy(_state,dst_frame_data+frag_buf_off, + src_frame_data+frag_buf_off,ystride); + } +} + +static void loop_filter_h(unsigned char *_pix,int _ystride,int *_bv){ + int y; + _pix-=2; + for(y=0;y<8;y++){ + int f; + f=_pix[0]-_pix[3]+3*(_pix[2]-_pix[1]); + /*The _bv array is used to compute the function + f=OC_CLAMPI(OC_MINI(-_2flimit-f,0),f,OC_MAXI(_2flimit-f,0)); + where _2flimit=_state->loop_filter_limits[_state->qis[0]]<<1;*/ + f=*(_bv+(f+4>>3)); + _pix[1]=OC_CLAMP255(_pix[1]+f); + _pix[2]=OC_CLAMP255(_pix[2]-f); + _pix+=_ystride; + } +} + +static void loop_filter_v(unsigned char *_pix,int _ystride,int *_bv){ + int x; + _pix-=_ystride*2; + for(x=0;x<8;x++){ + int f; + f=_pix[x]-_pix[_ystride*3+x]+3*(_pix[_ystride*2+x]-_pix[_ystride+x]); + /*The _bv array is used to compute the function + f=OC_CLAMPI(OC_MINI(-_2flimit-f,0),f,OC_MAXI(_2flimit-f,0)); + where _2flimit=_state->loop_filter_limits[_state->qis[0]]<<1;*/ + f=*(_bv+(f+4>>3)); + _pix[_ystride+x]=OC_CLAMP255(_pix[_ystride+x]+f); + _pix[_ystride*2+x]=OC_CLAMP255(_pix[_ystride*2+x]-f); + } +} + +/*Initialize the bounding values array used by the loop filter. + _bv: Storage for the array. + Return: 0 on success, or a non-zero value if no filtering need be applied.*/ +int oc_state_loop_filter_init(oc_theora_state *_state,int _bv[256]){ + int flimit; + int i; + flimit=_state->loop_filter_limits[_state->qis[0]]; + if(flimit==0)return 1; + memset(_bv,0,sizeof(_bv[0])*256); + for(i=0;i=0)_bv[127-i-flimit]=i-flimit; + _bv[127-i]=-i; + _bv[127+i]=i; + if(127+i+flimit<256)_bv[127+i+flimit]=flimit-i; + } + return 0; +} + +/*Apply the loop filter to a given set of fragment rows in the given plane. + The filter may be run on the bottom edge, affecting pixels in the next row of + fragments, so this row also needs to be available. + _bv: The bounding values array. + _refi: The index of the frame buffer to filter. + _pli: The color plane to filter. + _fragy0: The Y coordinate of the first fragment row to filter. + _fragy_end: The Y coordinate of the fragment row to stop filtering at.*/ +void oc_state_loop_filter_frag_rows(const oc_theora_state *_state,int _bv[256], + int _refi,int _pli,int _fragy0,int _fragy_end){ + _state->opt_vtable.state_loop_filter_frag_rows(_state,_bv,_refi,_pli, + _fragy0,_fragy_end); +} + +void oc_state_loop_filter_frag_rows_c(const oc_theora_state *_state,int *_bv, + int _refi,int _pli,int _fragy0,int _fragy_end){ + const oc_fragment_plane *fplane; + const oc_fragment *frags; + const ptrdiff_t *frag_buf_offs; + unsigned char *ref_frame_data; + ptrdiff_t fragi_top; + ptrdiff_t fragi_bot; + ptrdiff_t fragi0; + ptrdiff_t fragi0_end; + int ystride; + int nhfrags; + _bv+=127; + fplane=_state->fplanes+_pli; + nhfrags=fplane->nhfrags; + fragi_top=fplane->froffset; + fragi_bot=fragi_top+fplane->nfrags; + fragi0=fragi_top+_fragy0*(ptrdiff_t)nhfrags; + fragi0_end=fragi0+(_fragy_end-_fragy0)*(ptrdiff_t)nhfrags; + ystride=_state->ref_ystride[_pli]; + frags=_state->frags; + frag_buf_offs=_state->frag_buf_offs; + ref_frame_data=_state->ref_frame_data[_refi]; + /*The following loops are constructed somewhat non-intuitively on purpose. + The main idea is: if a block boundary has at least one coded fragment on + it, the filter is applied to it. + However, the order that the filters are applied in matters, and VP3 chose + the somewhat strange ordering used below.*/ + while(fragi0fragi0)loop_filter_h(ref,ystride,_bv); + if(fragi0>fragi_top)loop_filter_v(ref,ystride,_bv); + if(fragi+1info.frame_width; + height=_state->info.frame_height; + iframe=_state->granpos>>_state->info.keyframe_granule_shift; + pframe=_state->granpos-(iframe<<_state->info.keyframe_granule_shift); + sprintf(fname,"%08i%s.png",(int)(iframe+pframe),_suf); + fp=fopen(fname,"wb"); + if(fp==NULL)return TH_EFAULT; + image=(png_bytep *)oc_malloc_2d(height,6*width,sizeof(**image)); + if(image==NULL){ + fclose(fp); + return TH_EFAULT; + } + png=png_create_write_struct(PNG_LIBPNG_VER_STRING,NULL,NULL,NULL); + if(png==NULL){ + oc_free_2d(image); + fclose(fp); + return TH_EFAULT; + } + info=png_create_info_struct(png); + if(info==NULL){ + png_destroy_write_struct(&png,NULL); + oc_free_2d(image); + fclose(fp); + return TH_EFAULT; + } + if(setjmp(png_jmpbuf(png))){ + png_destroy_write_struct(&png,&info); + oc_free_2d(image); + fclose(fp); + return TH_EFAULT; + } + framei=_state->ref_frame_idx[_frame]; + y_row=_state->ref_frame_bufs[framei][0].data; + u_row=_state->ref_frame_bufs[framei][1].data; + v_row=_state->ref_frame_bufs[framei][2].data; + y_stride=_state->ref_frame_bufs[framei][0].stride; + u_stride=_state->ref_frame_bufs[framei][1].stride; + v_stride=_state->ref_frame_bufs[framei][2].stride; + /*Chroma up-sampling is just done with a box filter. + This is very likely what will actually be used in practice on a real + display, and also removes one more layer to search in for the source of + artifacts. + As an added bonus, it's dead simple.*/ + for(imgi=height;imgi-->0;){ + int dc; + y=y_row; + u=u_row; + v=v_row; + for(imgj=0;imgj<6*width;){ + float yval; + float uval; + float vval; + unsigned rval; + unsigned gval; + unsigned bval; + /*This is intentionally slow and very accurate.*/ + yval=(*y-16)*(1.0F/219); + uval=(*u-128)*(2*(1-0.114F)/224); + vval=(*v-128)*(2*(1-0.299F)/224); + rval=OC_CLAMPI(0,(int)(65535*(yval+vval)+0.5F),65535); + gval=OC_CLAMPI(0,(int)(65535*( + yval-uval*(0.114F/0.587F)-vval*(0.299F/0.587F))+0.5F),65535); + bval=OC_CLAMPI(0,(int)(65535*(yval+uval)+0.5F),65535); + image[imgi][imgj++]=(unsigned char)(rval>>8); + image[imgi][imgj++]=(unsigned char)(rval&0xFF); + image[imgi][imgj++]=(unsigned char)(gval>>8); + image[imgi][imgj++]=(unsigned char)(gval&0xFF); + image[imgi][imgj++]=(unsigned char)(bval>>8); + image[imgi][imgj++]=(unsigned char)(bval&0xFF); + dc=(y-y_row&1)|(_state->info.pixel_fmt&1); + y++; + u+=dc; + v+=dc; + } + dc=-((height-1-imgi&1)|_state->info.pixel_fmt>>1); + y_row+=y_stride; + u_row+=dc&u_stride; + v_row+=dc&v_stride; + } + png_init_io(png,fp); + png_set_compression_level(png,Z_BEST_COMPRESSION); + png_set_IHDR(png,info,width,height,16,PNG_COLOR_TYPE_RGB, + PNG_INTERLACE_NONE,PNG_COMPRESSION_TYPE_DEFAULT,PNG_FILTER_TYPE_DEFAULT); + switch(_state->info.colorspace){ + case TH_CS_ITU_REC_470M:{ + png_set_gAMA(png,info,2.2); + png_set_cHRM_fixed(png,info,31006,31616, + 67000,32000,21000,71000,14000,8000); + }break; + case TH_CS_ITU_REC_470BG:{ + png_set_gAMA(png,info,2.67); + png_set_cHRM_fixed(png,info,31271,32902, + 64000,33000,29000,60000,15000,6000); + }break; + default:break; + } + png_set_pHYs(png,info,_state->info.aspect_numerator, + _state->info.aspect_denominator,0); + png_set_rows(png,info,image); + png_write_png(png,info,PNG_TRANSFORM_IDENTITY,NULL); + png_write_end(png,info); + png_destroy_write_struct(&png,&info); + oc_free_2d(image); + fclose(fp); + return 0; +} +#endif + + + +ogg_int64_t th_granule_frame(void *_encdec,ogg_int64_t _granpos){ + oc_theora_state *state; + state=(oc_theora_state *)_encdec; + if(_granpos>=0){ + ogg_int64_t iframe; + ogg_int64_t pframe; + iframe=_granpos>>state->info.keyframe_granule_shift; + pframe=_granpos-(iframe<info.keyframe_granule_shift); + /*3.2.0 streams store the frame index in the granule position. + 3.2.1 and later store the frame count. + We return the index, so adjust the value if we have a 3.2.1 or later + stream.*/ + return iframe+pframe-TH_VERSION_CHECK(&state->info,3,2,1); + } + return -1; +} + +double th_granule_time(void *_encdec,ogg_int64_t _granpos){ + oc_theora_state *state; + state=(oc_theora_state *)_encdec; + if(_granpos>=0){ + return (th_granule_frame(_encdec, _granpos)+1)*( + (double)state->info.fps_denominator/state->info.fps_numerator); + } + return -1; +} diff --git a/libs/libtheora-1.1/lib/theora.def b/libs/libtheora-1.1/lib/theora.def new file mode 100644 index 00000000..22e4d659 --- /dev/null +++ b/libs/libtheora-1.1/lib/theora.def @@ -0,0 +1,56 @@ +LIBRARY libtheora +EXPORTS + theora_version_string + theora_version_number + theora_encode_init + theora_encode_YUVin + theora_encode_packetout + theora_encode_header + theora_encode_comment + theora_encode_tables + theora_decode_header + theora_decode_init + theora_decode_packetin + theora_decode_YUVout + theora_control + theora_packet_isheader + theora_packet_iskeyframe + theora_granule_shift + theora_granule_frame + theora_granule_time + theora_info_init + theora_info_clear + theora_clear + theora_comment_init + theora_comment_add + theora_comment_add_tag + theora_comment_query + theora_comment_query_count + theora_comment_clear + th_version_string + th_version_number + th_decode_headerin + th_decode_alloc + th_setup_free + th_decode_ctl + th_decode_packetin + th_decode_ycbcr_out + th_decode_free + th_packet_isheader + th_packet_iskeyframe + th_granule_frame + th_granule_time + th_info_init + th_info_clear + th_comment_init + th_comment_add + th_comment_add_tag + th_comment_query + th_comment_query_count + th_comment_clear + th_encode_alloc + th_encode_ctl + th_encode_flushheader + th_encode_packetout + th_encode_ycbcr_in + th_encode_free diff --git a/libs/libtheora-1.1/lib/theora.exp b/libs/libtheora-1.1/lib/theora.exp new file mode 100644 index 00000000..b4e0225f --- /dev/null +++ b/libs/libtheora-1.1/lib/theora.exp @@ -0,0 +1,55 @@ +# export list for libtheora +_theora_version_string +_theora_version_number +_theora_encode_init +_theora_encode_YUVin +_theora_encode_packetout +_theora_encode_header +_theora_encode_comment +_theora_encode_tables +_theora_decode_header +_theora_decode_init +_theora_decode_packetin +_theora_decode_YUVout +_theora_control +_theora_packet_isheader +_theora_packet_iskeyframe +_theora_granule_shift +_theora_granule_frame +_theora_granule_time +_theora_info_init +_theora_info_clear +_theora_clear +_theora_comment_init +_theora_comment_add +_theora_comment_add_tag +_theora_comment_query +_theora_comment_query_count +_theora_comment_clear +_th_version_string +_th_version_number +_th_decode_headerin +_th_decode_alloc +_th_setup_free +_th_decode_ctl +_th_decode_packetin +_th_decode_ycbcr_out +_th_decode_free +_th_packet_isheader +_th_packet_iskeyframe +_th_granule_frame +_th_granule_time +_th_info_init +_th_info_clear +_th_comment_init +_th_comment_add +_th_comment_add_tag +_th_comment_query +_th_comment_query_count +_th_comment_clear +_th_encode_alloc +_th_encode_ctl +_th_encode_flushheader +_th_encode_packetout +_th_encode_ycbcr_in +_th_encode_free diff --git a/libs/libtheora-1.1/lib/theoradec.exp b/libs/libtheora-1.1/lib/theoradec.exp new file mode 100644 index 00000000..41dec1c3 --- /dev/null +++ b/libs/libtheora-1.1/lib/theoradec.exp @@ -0,0 +1,43 @@ +# export list for theoradec +_th_version_string +_th_version_number +_th_decode_headerin +_th_decode_alloc +_th_setup_free +_th_decode_ctl +_th_decode_packetin +_th_decode_ycbcr_out +_th_decode_free +_th_packet_isheader +_th_packet_iskeyframe +_th_granule_frame +_th_granule_time +_th_info_init +_th_info_clear +_th_comment_init +_th_comment_add +_th_comment_add_tag +_th_comment_query +_th_comment_query_count +_th_comment_clear +_theora_version_string +_theora_version_number +_theora_decode_header +_theora_decode_init +_theora_decode_packetin +_theora_decode_YUVout +_theora_control +_theora_packet_isheader +_theora_packet_iskeyframe +_theora_granule_shift +_theora_granule_frame +_theora_granule_time +_theora_info_init +_theora_info_clear +_theora_clear +_theora_comment_init +_theora_comment_add +_theora_comment_add_tag +_theora_comment_query +_theora_comment_query_count +_theora_comment_clear diff --git a/libs/libtheora-1.1/lib/theoraenc.exp b/libs/libtheora-1.1/lib/theoraenc.exp new file mode 100644 index 00000000..d278455e --- /dev/null +++ b/libs/libtheora-1.1/lib/theoraenc.exp @@ -0,0 +1,15 @@ +# export list for theoraenc +_th_encode_alloc +_th_encode_ctl +_th_encode_flushheader +_th_encode_ycbcr_in +_th_encode_packetout +_th_encode_free +_TH_VP31_QUANT_INFO +_TH_VP31_HUFF_CODES +_theora_encode_init +_theora_encode_YUVin +_theora_encode_packetout +_theora_encode_header +_theora_encode_comment +_theora_encode_tables diff --git a/libs/libtheora-1.1/lib/tokenize.c b/libs/libtheora-1.1/lib/tokenize.c new file mode 100644 index 00000000..8533b9ff --- /dev/null +++ b/libs/libtheora-1.1/lib/tokenize.c @@ -0,0 +1,1072 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: tokenize.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ +#include +#include +#include "encint.h" + + + +static int oc_make_eob_token(int _run_count){ + if(_run_count<4)return OC_DCT_EOB1_TOKEN+_run_count-1; + else{ + int cat; + cat=OC_ILOGNZ_32(_run_count)-3; + cat=OC_MINI(cat,3); + return OC_DCT_REPEAT_RUN0_TOKEN+cat; + } +} + +static int oc_make_eob_token_full(int _run_count,int *_eb){ + if(_run_count<4){ + *_eb=0; + return OC_DCT_EOB1_TOKEN+_run_count-1; + } + else{ + int cat; + cat=OC_ILOGNZ_32(_run_count)-3; + cat=OC_MINI(cat,3); + *_eb=_run_count-OC_BYTE_TABLE32(4,8,16,0,cat); + return OC_DCT_REPEAT_RUN0_TOKEN+cat; + } +} + +/*Returns the number of blocks ended by an EOB token.*/ +static int oc_decode_eob_token(int _token,int _eb){ + return (0x20820C41U>>_token*5&0x1F)+_eb; +} + +/*TODO: This is now only used during DCT tokenization, and never for runs; it + should be simplified.*/ +static int oc_make_dct_token_full(int _zzi,int _zzj,int _val,int *_eb){ + int neg; + int zero_run; + int token; + int eb; + neg=_val<0; + _val=abs(_val); + zero_run=_zzj-_zzi; + if(zero_run>0){ + int adj; + /*Implement a minor restriction on stack 1 so that we know during DC fixups + that extending a dctrun token from stack 1 will never overflow.*/ + adj=_zzi!=1; + if(_val<2&&zero_run<17+adj){ + if(zero_run<6){ + token=OC_DCT_RUN_CAT1A+zero_run-1; + eb=neg; + } + else if(zero_run<10){ + token=OC_DCT_RUN_CAT1B; + eb=zero_run-6+(neg<<2); + } + else{ + token=OC_DCT_RUN_CAT1C; + eb=zero_run-10+(neg<<3); + } + } + else if(_val<4&&zero_run<3+adj){ + if(zero_run<2){ + token=OC_DCT_RUN_CAT2A; + eb=_val-2+(neg<<1); + } + else{ + token=OC_DCT_RUN_CAT2B; + eb=zero_run-2+(_val-2<<1)+(neg<<2); + } + } + else{ + if(zero_run<9)token=OC_DCT_SHORT_ZRL_TOKEN; + else token=OC_DCT_ZRL_TOKEN; + eb=zero_run-1; + } + } + else if(_val<3){ + token=OC_ONE_TOKEN+(_val-1<<1)+neg; + eb=0; + } + else if(_val<7){ + token=OC_DCT_VAL_CAT2+_val-3; + eb=neg; + } + else if(_val<9){ + token=OC_DCT_VAL_CAT3; + eb=_val-7+(neg<<1); + } + else if(_val<13){ + token=OC_DCT_VAL_CAT4; + eb=_val-9+(neg<<2); + } + else if(_val<21){ + token=OC_DCT_VAL_CAT5; + eb=_val-13+(neg<<3); + } + else if(_val<37){ + token=OC_DCT_VAL_CAT6; + eb=_val-21+(neg<<4); + } + else if(_val<69){ + token=OC_DCT_VAL_CAT7; + eb=_val-37+(neg<<5); + } + else{ + token=OC_DCT_VAL_CAT8; + eb=_val-69+(neg<<9); + } + *_eb=eb; + return token; +} + +/*Token logging to allow a few fragments of efficient rollback. + Late SKIP analysis is tied up in the tokenization process, so we need to be + able to undo a fragment's tokens on a whim.*/ + +static const unsigned char OC_ZZI_HUFF_OFFSET[64]={ + 0,16,16,16,16,16,32,32, + 32,32,32,32,32,32,32,48, + 48,48,48,48,48,48,48,48, + 48,48,48,48,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64 +}; + +static int oc_token_bits(oc_enc_ctx *_enc,int _huffi,int _zzi,int _token){ + return _enc->huff_codes[_huffi+OC_ZZI_HUFF_OFFSET[_zzi]][_token].nbits + +OC_DCT_TOKEN_EXTRA_BITS[_token]; +} + +static void oc_enc_tokenlog_checkpoint(oc_enc_ctx *_enc, + oc_token_checkpoint *_cp,int _pli,int _zzi){ + _cp->pli=_pli; + _cp->zzi=_zzi; + _cp->eob_run=_enc->eob_run[_pli][_zzi]; + _cp->ndct_tokens=_enc->ndct_tokens[_pli][_zzi]; +} + +void oc_enc_tokenlog_rollback(oc_enc_ctx *_enc, + const oc_token_checkpoint *_stack,int _n){ + int i; + for(i=_n;i-->0;){ + int pli; + int zzi; + pli=_stack[i].pli; + zzi=_stack[i].zzi; + _enc->eob_run[pli][zzi]=_stack[i].eob_run; + _enc->ndct_tokens[pli][zzi]=_stack[i].ndct_tokens; + } +} + +static void oc_enc_token_log(oc_enc_ctx *_enc, + int _pli,int _zzi,int _token,int _eb){ + ptrdiff_t ti; + ti=_enc->ndct_tokens[_pli][_zzi]++; + _enc->dct_tokens[_pli][_zzi][ti]=(unsigned char)_token; + _enc->extra_bits[_pli][_zzi][ti]=(ogg_uint16_t)_eb; +} + +static void oc_enc_eob_log(oc_enc_ctx *_enc, + int _pli,int _zzi,int _run_count){ + int token; + int eb; + token=oc_make_eob_token_full(_run_count,&eb); + oc_enc_token_log(_enc,_pli,_zzi,token,eb); +} + + +void oc_enc_tokenize_start(oc_enc_ctx *_enc){ + memset(_enc->ndct_tokens,0,sizeof(_enc->ndct_tokens)); + memset(_enc->eob_run,0,sizeof(_enc->eob_run)); + memset(_enc->dct_token_offs,0,sizeof(_enc->dct_token_offs)); + memset(_enc->dc_pred_last,0,sizeof(_enc->dc_pred_last)); +} + +typedef struct oc_quant_token oc_quant_token; + +/*A single node in the Viterbi trellis. + We maintain up to 2 of these per coefficient: + - A token to code if the value is zero (EOB, zero run, or combo token). + - A token to code if the value is not zero (DCT value token).*/ +struct oc_quant_token{ + unsigned char next; + signed char token; + ogg_int16_t eb; + ogg_uint32_t cost; + int bits; + int qc; +}; + +/*Tokenizes the AC coefficients, possibly adjusting the quantization, and then + dequantizes and de-zig-zags the result. + The DC coefficient is not preserved; it should be restored by the caller.*/ +int oc_enc_tokenize_ac(oc_enc_ctx *_enc,int _pli,ptrdiff_t _fragi, + ogg_int16_t *_qdct,const ogg_uint16_t *_dequant,const ogg_int16_t *_dct, + int _zzi,oc_token_checkpoint **_stack,int _acmin){ + oc_token_checkpoint *stack; + ogg_int64_t zflags; + ogg_int64_t nzflags; + ogg_int64_t best_flags; + ogg_uint32_t d2_accum[64]; + oc_quant_token tokens[64][2]; + ogg_uint16_t *eob_run; + const unsigned char *dct_fzig_zag; + ogg_uint32_t cost; + int bits; + int eob; + int token; + int eb; + int next; + int huffi; + int zzi; + int ti; + int zzj; + int qc; + huffi=_enc->huff_idxs[_enc->state.frame_type][1][_pli+1>>1]; + eob_run=_enc->eob_run[_pli]; + memset(tokens[0],0,sizeof(tokens[0])); + best_flags=nzflags=0; + zflags=1; + d2_accum[0]=0; + zzj=64; + for(zzi=OC_MINI(_zzi,63);zzi>0;zzi--){ + ogg_int32_t lambda; + ogg_uint32_t best_cost; + int best_bits=best_bits; + int best_next=best_next; + int best_token=best_token; + int best_eb=best_eb; + int best_qc=best_qc; + int flush_bits; + ogg_uint32_t d2; + int dq; + int e; + int c; + int s; + int tj; + lambda=_enc->lambda; + qc=_qdct[zzi]; + s=-(qc<0); + qc=qc+s^s; + c=_dct[OC_FZIG_ZAG[zzi]]; + if(qc<=1){ + ogg_uint32_t sum_d2; + int nzeros; + int dc_reserve; + /*The hard case: try a zero run.*/ + if(!qc){ + /*Skip runs that are already quantized to zeros. + If we considered each zero coefficient in turn, we might + theoretically find a better way to partition long zero runs (e.g., + a run of > 17 zeros followed by a 1 might be better coded as a short + zero run followed by a combo token, rather than the longer zero + token followed by a 1 value token), but zeros are so common that + this becomes very computationally expensive (quadratic instead of + linear in the number of coefficients), for a marginal gain.*/ + while(zzi>1&&!_qdct[zzi-1])zzi--; + /*The distortion of coefficients originally quantized to zero is + treated as zero (since we'll never quantize them to anything else).*/ + d2=0; + } + else{ + c=c+s^s; + d2=c*(ogg_int32_t)c; + } + eob=eob_run[zzi]; + nzeros=zzj-zzi; + zzj&=63; + sum_d2=d2+d2_accum[zzj]; + d2_accum[zzi]=sum_d2; + flush_bits=eob>0?oc_token_bits(_enc,huffi,zzi,oc_make_eob_token(eob)):0; + /*We reserve 1 spot for combo run tokens that start in the 1st AC stack + to ensure they can be extended to include the DC coefficient if + necessary; this greatly simplifies stack-rewriting later on.*/ + dc_reserve=zzi+62>>6; + best_cost=0xFFFFFFFF; + for(;;){ + if(nzflags>>zzj&1){ + int cat; + int val; + int val_s; + int zzk; + int tk; + next=tokens[zzj][1].next; + tk=next&1; + zzk=next>>1; + /*Try a pure zero run to this point.*/ + cat=nzeros+55>>6; + token=OC_DCT_SHORT_ZRL_TOKEN+cat; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + d2=sum_d2-d2_accum[zzj]; + cost=d2+lambda*bits+tokens[zzj][1].cost; + if(cost<=best_cost){ + best_next=(zzj<<1)+1; + best_token=token; + best_eb=nzeros-1; + best_cost=cost; + best_bits=bits+tokens[zzj][1].bits; + best_qc=0; + } + if(nzeros<16+dc_reserve){ + val=_qdct[zzj]; + val_s=-(val<0); + val=val+val_s^val_s; + if(val<=2){ + /*Try a +/- 1 combo token.*/ + if(nzeros<6){ + token=OC_DCT_RUN_CAT1A+nzeros-1; + eb=-val_s; + } + else{ + cat=nzeros+54>>6; + token=OC_DCT_RUN_CAT1B+cat; + eb=(-val_s<>1; + token=OC_DCT_RUN_CAT2A+cat; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + val=2+((val+val_s^val_s)>2); + e=(_dct[OC_FZIG_ZAG[zzj]]+val_s^val_s)-_dequant[zzj]*val; + d2=e*(ogg_int32_t)e+sum_d2-d2_accum[zzj]; + cost=d2+lambda*bits+tokens[zzk][tk].cost; + if(cost<=best_cost){ + best_cost=cost; + best_bits=bits+tokens[zzk][tk].bits; + best_next=next; + best_token=token; + best_eb=(-val_s<<1+cat)+(val-2<>1); + best_qc=val+val_s^val_s; + } + } + } + /*zzj can't be coded as a zero, so stop trying to extend the run.*/ + if(!(zflags>>zzj&1))break; + } + /*We could try to consider _all_ potentially non-zero coefficients, but + if we already found a bunch of them not worth coding, it's fairly + unlikely they would now be worth coding from this position; skipping + them saves a lot of work.*/ + zzj=(tokens[zzj][0].next>>1)-(tokens[zzj][0].qc!=0)&63; + if(zzj==0){ + /*We made it all the way to the end of the block; try an EOB token.*/ + if(eob<4095){ + bits=oc_token_bits(_enc,huffi,zzi,oc_make_eob_token(eob+1)) + -flush_bits; + } + else bits=oc_token_bits(_enc,huffi,zzi,OC_DCT_EOB1_TOKEN); + cost=sum_d2+bits*lambda; + /*If the best route so far is still a pure zero run to the end of the + block, force coding it as an EOB. + Even if it's not optimal for this block, it has a good chance of + getting combined with an EOB token from subsequent blocks, saving + bits overall.*/ + if(cost<=best_cost||best_token<=OC_DCT_ZRL_TOKEN&&zzi+best_eb==63){ + best_next=0; + /*This token is just a marker; in reality we may not emit any + tokens, but update eob_run[] instead.*/ + best_token=OC_DCT_EOB1_TOKEN; + best_eb=0; + best_cost=cost; + best_bits=bits; + best_qc=0; + } + break; + } + nzeros=zzj-zzi; + } + tokens[zzi][0].next=(unsigned char)best_next; + tokens[zzi][0].token=(signed char)best_token; + tokens[zzi][0].eb=(ogg_int16_t)best_eb; + tokens[zzi][0].cost=best_cost; + tokens[zzi][0].bits=best_bits; + tokens[zzi][0].qc=best_qc; + zflags|=(ogg_int64_t)1<>zzj&1; + next=(zzj<<1)+tj; + tokens[zzi][1].next=(unsigned char)next; + tokens[zzi][1].token=(signed char)token; + tokens[zzi][1].eb=0; + tokens[zzi][1].cost=d2+lambda*bits+tokens[zzj][tj].cost; + tokens[zzi][1].bits=bits+tokens[zzj][tj].bits; + tokens[zzi][1].qc=1+s^s; + nzflags|=(ogg_int64_t)1<0?oc_token_bits(_enc,huffi,zzi,oc_make_eob_token(eob)):0; + if(qc<=2){ + e=2*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_TWO_TOKEN-s; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e-=dq; + d2=e*(ogg_int32_t)e; + token=OC_ONE_TOKEN-s; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_bits=bits; + best_cost=cost; + qc--; + } + best_eb=0; + } + else if(qc<=3){ + e=3*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT2; + best_eb=-s; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e-=dq; + d2=e*(ogg_int32_t)e; + token=OC_TWO_TOKEN-s; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_eb=0; + best_bits=bits; + best_cost=cost; + qc--; + } + } + else if(qc<=6){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT2+qc-3; + best_eb=-s; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e-=dq; + d2=e*(ogg_int32_t)e; + token=best_token-1; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_bits=bits; + best_cost=cost; + qc--; + } + } + else if(qc<=8){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT3; + best_eb=(-s<<1)+qc-7; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e=6*dq-c; + d2=e*(ogg_int32_t)e; + token=OC_DCT_VAL_CAT2+3; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_eb=-s; + best_bits=bits; + best_cost=cost; + qc=6; + } + } + else if(qc<=12){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT4; + best_eb=(-s<<2)+qc-9; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e=8*dq-c; + d2=e*(ogg_int32_t)e; + token=best_token-1; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_eb=(-s<<1)+1; + best_bits=bits; + best_cost=cost; + qc=8; + } + } + else if(qc<=20){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT5; + best_eb=(-s<<3)+qc-13; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e=12*dq-c; + d2=e*(ogg_int32_t)e; + token=best_token-1; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_eb=(-s<<2)+3; + best_bits=bits; + best_cost=cost; + qc=12; + } + } + else if(qc<=36){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT6; + best_eb=(-s<<4)+qc-21; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e=20*dq-c; + d2=e*(ogg_int32_t)e; + token=best_token-1; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost<=best_cost){ + best_token=token; + best_eb=(-s<<3)+7; + best_bits=bits; + best_cost=cost; + qc=20; + } + } + else if(qc<=68){ + e=qc*dq-c; + d2=e*(ogg_int32_t)e; + best_token=OC_DCT_VAL_CAT7; + best_eb=(-s<<5)+qc-37; + best_bits=flush_bits+oc_token_bits(_enc,huffi,zzi,best_token); + best_cost=d2+lambda*best_bits; + e=36*dq-c; + d2=e*(ogg_int32_t)e; + token=best_token-1; + bits=flush_bits+oc_token_bits(_enc,huffi,zzi,token); + cost=d2+lambda*bits; + if(cost>zzj&1; + next=(zzj<<1)+tj; + tokens[zzi][1].next=(unsigned char)next; + tokens[zzi][1].token=(signed char)best_token; + tokens[zzi][1].eb=best_eb; + tokens[zzi][1].cost=best_cost+tokens[zzj][tj].cost; + tokens[zzi][1].bits=best_bits+tokens[zzj][tj].bits; + tokens[zzi][1].qc=qc+s^s; + nzflags|=(ogg_int64_t)1<state.opt_data.dct_fzig_zag; + zzi=1; + ti=best_flags>>1&1; + bits=tokens[zzi][ti].bits; + do{ + oc_enc_tokenlog_checkpoint(_enc,stack++,_pli,zzi); + eob=eob_run[zzi]; + if(tokens[zzi][ti].token=4095){ + oc_enc_eob_log(_enc,_pli,zzi,eob); + eob=0; + } + eob_run[zzi]=eob; + /*We don't include the actual EOB cost for this block in the return value. + It will be paid for by the fragment that terminates the EOB run.*/ + bits-=tokens[zzi][ti].bits; + zzi=_zzi; + break; + } + /*Emit pending EOB run if any.*/ + if(eob>0){ + oc_enc_eob_log(_enc,_pli,zzi,eob); + eob_run[zzi]=0; + } + oc_enc_token_log(_enc,_pli,zzi,tokens[zzi][ti].token,tokens[zzi][ti].eb); + next=tokens[zzi][ti].next; + qc=tokens[zzi][ti].qc; + zzj=(next>>1)-1&63; + /*TODO: It may be worth saving the dequantized coefficient in the trellis + above; we had to compute it to measure the error anyway.*/ + _qdct[dct_fzig_zag[zzj]]=(ogg_int16_t)(qc*(int)_dequant[zzj]); + zzi=next>>1; + ti=next&1; + } + while(zzi); + *_stack=stack; + return bits; +} + +void oc_enc_pred_dc_frag_rows(oc_enc_ctx *_enc, + int _pli,int _fragy0,int _frag_yend){ + const oc_fragment_plane *fplane; + const oc_fragment *frags; + ogg_int16_t *frag_dc; + ptrdiff_t fragi; + int *pred_last; + int nhfrags; + int fragx; + int fragy; + fplane=_enc->state.fplanes+_pli; + frags=_enc->state.frags; + frag_dc=_enc->frag_dc; + pred_last=_enc->dc_pred_last[_pli]; + nhfrags=fplane->nhfrags; + fragi=fplane->froffset+_fragy0*nhfrags; + for(fragy=_fragy0;fragy<_frag_yend;fragy++){ + if(fragy==0){ + /*For the first row, all of the cases reduce to just using the previous + predictor for the same reference frame.*/ + for(fragx=0;fragx=nhfrags)ur_ref=-1; + else{ + ur_ref=u_frags[fragi+1].coded? + OC_FRAME_FOR_MODE(u_frags[fragi+1].mb_mode):-1; + } + if(frags[fragi].coded){ + int pred; + int ref; + ref=OC_FRAME_FOR_MODE(frags[fragi].mb_mode); + /*We break out a separate case based on which of our neighbors use + the same reference frames. + This is somewhat faster than trying to make a generic case which + handles all of them, since it reduces lots of poorly predicted + jumps to one switch statement, and also lets a number of the + multiplications be optimized out by strength reduction.*/ + switch((l_ref==ref)|(ul_ref==ref)<<1| + (u_ref==ref)<<2|(ur_ref==ref)<<3){ + default:pred=pred_last[ref];break; + case 1: + case 3:pred=frags[fragi-1].dc;break; + case 2:pred=u_frags[fragi-1].dc;break; + case 4: + case 6: + case 12:pred=u_frags[fragi].dc;break; + case 5:pred=(frags[fragi-1].dc+u_frags[fragi].dc)/2;break; + case 8:pred=u_frags[fragi+1].dc;break; + case 9: + case 11: + case 13:{ + pred=(75*frags[fragi-1].dc+53*u_frags[fragi+1].dc)/128; + }break; + case 10:pred=(u_frags[fragi-1].dc+u_frags[fragi+1].dc)/2;break; + case 14:{ + pred=(3*(u_frags[fragi-1].dc+u_frags[fragi+1].dc) + +10*u_frags[fragi].dc)/16; + }break; + case 7: + case 15:{ + int p0; + int p1; + int p2; + p0=frags[fragi-1].dc; + p1=u_frags[fragi-1].dc; + p2=u_frags[fragi].dc; + pred=(29*(p0+p2)-26*p1)/32; + if(abs(pred-p2)>128)pred=p2; + else if(abs(pred-p0)>128)pred=p0; + else if(abs(pred-p1)>128)pred=p1; + }break; + } + frag_dc[fragi]=(ogg_int16_t)(frags[fragi].dc-pred); + pred_last[ref]=frags[fragi].dc; + l_ref=ref; + } + else l_ref=-1; + ul_ref=u_ref; + u_ref=ur_ref; + } + } + } +} + +void oc_enc_tokenize_dc_frag_list(oc_enc_ctx *_enc,int _pli, + const ptrdiff_t *_coded_fragis,ptrdiff_t _ncoded_fragis, + int _prev_ndct_tokens1,int _prev_eob_run1){ + const ogg_int16_t *frag_dc; + ptrdiff_t fragii; + unsigned char *dct_tokens0; + unsigned char *dct_tokens1; + ogg_uint16_t *extra_bits0; + ogg_uint16_t *extra_bits1; + ptrdiff_t ti0; + ptrdiff_t ti1r; + ptrdiff_t ti1w; + int eob_run0; + int eob_run1; + int neobs1; + int token; + int eb; + int token1=token1; + int eb1=eb1; + /*Return immediately if there are no coded fragments; otherwise we'd flush + any trailing EOB run into the AC 1 list and never read it back out.*/ + if(_ncoded_fragis<=0)return; + frag_dc=_enc->frag_dc; + dct_tokens0=_enc->dct_tokens[_pli][0]; + dct_tokens1=_enc->dct_tokens[_pli][1]; + extra_bits0=_enc->extra_bits[_pli][0]; + extra_bits1=_enc->extra_bits[_pli][1]; + ti0=_enc->ndct_tokens[_pli][0]; + ti1w=ti1r=_prev_ndct_tokens1; + eob_run0=_enc->eob_run[_pli][0]; + /*Flush any trailing EOB run for the 1st AC coefficient. + This is needed to allow us to track tokens to the end of the list.*/ + eob_run1=_enc->eob_run[_pli][1]; + if(eob_run1>0)oc_enc_eob_log(_enc,_pli,1,eob_run1); + /*If there was an active EOB run at the start of the 1st AC stack, read it + in and decode it.*/ + if(_prev_eob_run1>0){ + token1=dct_tokens1[ti1r]; + eb1=extra_bits1[ti1r]; + ti1r++; + eob_run1=oc_decode_eob_token(token1,eb1); + /*Consume the portion of the run that came before these fragments.*/ + neobs1=eob_run1-_prev_eob_run1; + } + else eob_run1=neobs1=0; + for(fragii=0;fragii<_ncoded_fragis;fragii++){ + int val; + /*All tokens in the 1st AC coefficient stack are regenerated as the DC + coefficients are produced. + This can be done in-place; stack 1 cannot get larger.*/ + if(!neobs1){ + /*There's no active EOB run in stack 1; read the next token.*/ + token1=dct_tokens1[ti1r]; + eb1=extra_bits1[ti1r]; + ti1r++; + if(token10){ + token=oc_make_eob_token_full(eob_run0,&eb); + dct_tokens0[ti0]=(unsigned char)token; + extra_bits0[ti0]=(ogg_uint16_t)eb; + ti0++; + eob_run0=0; + } + token=oc_make_dct_token_full(0,0,val,&eb); + dct_tokens0[ti0]=(unsigned char)token; + extra_bits0[ti0]=(ogg_uint16_t)eb; + ti0++; + } + else{ + /*Zero DC value; that means the entry in stack 1 might need to be coded + from stack 0. + This requires a stack 1 fixup.*/ + if(neobs1>0){ + /*We're in the middle of an active EOB run in stack 1. + Move it to stack 0.*/ + if(++eob_run0>=4095){ + token=oc_make_eob_token_full(eob_run0,&eb); + dct_tokens0[ti0]=(unsigned char)token; + extra_bits0[ti0]=(ogg_uint16_t)eb; + ti0++; + eob_run0=0; + } + eob_run1--; + } + else{ + /*No active EOB run in stack 1, so we can't extend one in stack 0. + Flush it if we've got it.*/ + if(eob_run0>0){ + token=oc_make_eob_token_full(eob_run0,&eb); + dct_tokens0[ti0]=(unsigned char)token; + extra_bits0[ti0]=(ogg_uint16_t)eb; + ti0++; + eob_run0=0; + } + /*Stack 1 token is one of: a pure zero run token, a single + coefficient token, or a zero run/coefficient combo token. + A zero run token is expanded and moved to token stack 0, and the + stack 1 entry dropped. + A single coefficient value may be transformed into combo token that + is moved to stack 0, or if it cannot be combined, it is left alone + and a single length-1 zero run is emitted in stack 0. + A combo token is extended and moved to stack 0. + During AC coding, we restrict the run lengths on combo tokens for + stack 1 to guarantee we can extend them.*/ + switch(token1){ + case OC_DCT_SHORT_ZRL_TOKEN:{ + if(eb1<7){ + dct_tokens0[ti0]=OC_DCT_SHORT_ZRL_TOKEN; + extra_bits0[ti0]=(ogg_uint16_t)(eb1+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + continue; + } + /*Fall through.*/ + } + case OC_DCT_ZRL_TOKEN:{ + dct_tokens0[ti0]=OC_DCT_ZRL_TOKEN; + extra_bits0[ti0]=(ogg_uint16_t)(eb1+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_ONE_TOKEN: + case OC_MINUS_ONE_TOKEN:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT1A; + extra_bits0[ti0]=(ogg_uint16_t)(token1-OC_ONE_TOKEN); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_TWO_TOKEN: + case OC_MINUS_TWO_TOKEN:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT2A; + extra_bits0[ti0]=(ogg_uint16_t)(token1-OC_TWO_TOKEN<<1); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_DCT_VAL_CAT2:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT2A; + extra_bits0[ti0]=(ogg_uint16_t)((eb1<<1)+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_DCT_RUN_CAT1A: + case OC_DCT_RUN_CAT1A+1: + case OC_DCT_RUN_CAT1A+2: + case OC_DCT_RUN_CAT1A+3:{ + dct_tokens0[ti0]=(unsigned char)(token1+1); + extra_bits0[ti0]=(ogg_uint16_t)eb1; + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_DCT_RUN_CAT1A+4:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT1B; + extra_bits0[ti0]=(ogg_uint16_t)(eb1<<2); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_DCT_RUN_CAT1B:{ + if((eb1&3)<3){ + dct_tokens0[ti0]=OC_DCT_RUN_CAT1B; + extra_bits0[ti0]=(ogg_uint16_t)(eb1+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + continue; + } + eb1=((eb1&4)<<1)-1; + /*Fall through.*/ + } + case OC_DCT_RUN_CAT1C:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT1C; + extra_bits0[ti0]=(ogg_uint16_t)(eb1+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + case OC_DCT_RUN_CAT2A:{ + eb1=(eb1<<1)-1; + /*Fall through.*/ + } + case OC_DCT_RUN_CAT2B:{ + dct_tokens0[ti0]=OC_DCT_RUN_CAT2B; + extra_bits0[ti0]=(ogg_uint16_t)(eb1+1); + ti0++; + /*Don't write the AC coefficient back out.*/ + }continue; + } + /*We can't merge tokens, write a short zero run and keep going.*/ + dct_tokens0[ti0]=OC_DCT_SHORT_ZRL_TOKEN; + extra_bits0[ti0]=0; + ti0++; + } + } + if(!neobs1){ + /*Flush any (inactive) EOB run.*/ + if(eob_run1>0){ + token=oc_make_eob_token_full(eob_run1,&eb); + dct_tokens1[ti1w]=(unsigned char)token; + extra_bits1[ti1w]=(ogg_uint16_t)eb; + ti1w++; + eob_run1=0; + } + /*There's no active EOB run, so log the current token.*/ + dct_tokens1[ti1w]=(unsigned char)token1; + extra_bits1[ti1w]=(ogg_uint16_t)eb1; + ti1w++; + } + else{ + /*Otherwise consume one EOB from the current run.*/ + neobs1--; + /*If we have more than 4095 EOBs outstanding in stack1, flush the run.*/ + if(eob_run1-neobs1>=4095){ + token=oc_make_eob_token_full(4095,&eb); + dct_tokens1[ti1w]=(unsigned char)token; + extra_bits1[ti1w]=(ogg_uint16_t)eb; + ti1w++; + eob_run1-=4095; + } + } + } + /*Save the current state.*/ + _enc->ndct_tokens[_pli][0]=ti0; + _enc->ndct_tokens[_pli][1]=ti1w; + _enc->eob_run[_pli][0]=eob_run0; + _enc->eob_run[_pli][1]=eob_run1; +} + +/*Final EOB run welding.*/ +void oc_enc_tokenize_finish(oc_enc_ctx *_enc){ + int pli; + int zzi; + /*Emit final EOB runs.*/ + for(pli=0;pli<3;pli++)for(zzi=0;zzi<64;zzi++){ + int eob_run; + eob_run=_enc->eob_run[pli][zzi]; + if(eob_run>0)oc_enc_eob_log(_enc,pli,zzi,eob_run); + } + /*Merge the final EOB run of one token list with the start of the next, if + possible.*/ + for(zzi=0;zzi<64;zzi++)for(pli=0;pli<3;pli++){ + int old_tok1; + int old_tok2; + int old_eb1; + int old_eb2; + int new_tok; + int new_eb; + int zzj; + int plj; + ptrdiff_t ti=ti; + int run_count; + /*Make sure this coefficient has tokens at all.*/ + if(_enc->ndct_tokens[pli][zzi]<=0)continue; + /*Ensure the first token is an EOB run.*/ + old_tok2=_enc->dct_tokens[pli][zzi][0]; + if(old_tok2>=OC_NDCT_EOB_TOKEN_MAX)continue; + /*Search for a previous coefficient that has any tokens at all.*/ + old_tok1=OC_NDCT_EOB_TOKEN_MAX; + for(zzj=zzi,plj=pli;zzj>=0;zzj--){ + while(plj-->0){ + ti=_enc->ndct_tokens[plj][zzj]-1; + if(ti>=_enc->dct_token_offs[plj][zzj]){ + old_tok1=_enc->dct_tokens[plj][zzj][ti]; + break; + } + } + if(plj>=0)break; + plj=3; + } + /*Ensure its last token was an EOB run.*/ + if(old_tok1>=OC_NDCT_EOB_TOKEN_MAX)continue; + /*Pull off the associated extra bits, if any, and decode the runs.*/ + old_eb1=_enc->extra_bits[plj][zzj][ti]; + old_eb2=_enc->extra_bits[pli][zzi][0]; + run_count=oc_decode_eob_token(old_tok1,old_eb1) + +oc_decode_eob_token(old_tok2,old_eb2); + /*We can't possibly combine these into one run. + It might be possible to split them more optimally, but we'll just leave + them as-is.*/ + if(run_count>=4096)continue; + /*We CAN combine them into one run.*/ + new_tok=oc_make_eob_token_full(run_count,&new_eb); + _enc->dct_tokens[plj][zzj][ti]=(unsigned char)new_tok; + _enc->extra_bits[plj][zzj][ti]=(ogg_uint16_t)new_eb; + _enc->dct_token_offs[pli][zzi]++; + } +} diff --git a/libs/libtheora-1.1/lib/x86/mmxencfrag.c b/libs/libtheora-1.1/lib/x86/mmxencfrag.c new file mode 100644 index 00000000..c79ff01f --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxencfrag.c @@ -0,0 +1,900 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: dsp_mmx.c 14579 2008-03-12 06:42:40Z xiphmont $ + + ********************************************************************/ +#include +#include "x86enc.h" + +#if defined(OC_X86_ASM) + +unsigned oc_enc_frag_sad_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride){ + ptrdiff_t ystride3; + ptrdiff_t ret; + __asm__ __volatile__( + /*Load the first 4 rows of each block.*/ + "movq (%[src]),%%mm0\n\t" + "movq (%[ref]),%%mm1\n\t" + "movq (%[src],%[ystride]),%%mm2\n\t" + "movq (%[ref],%[ystride]),%%mm3\n\t" + "lea (%[ystride],%[ystride],2),%[ystride3]\n\t" + "movq (%[src],%[ystride],2),%%mm4\n\t" + "movq (%[ref],%[ystride],2),%%mm5\n\t" + "movq (%[src],%[ystride3]),%%mm6\n\t" + "movq (%[ref],%[ystride3]),%%mm7\n\t" + /*Compute their SADs and add them in %%mm0*/ + "psadbw %%mm1,%%mm0\n\t" + "psadbw %%mm3,%%mm2\n\t" + "lea (%[src],%[ystride],4),%[src]\n\t" + "paddw %%mm2,%%mm0\n\t" + "lea (%[ref],%[ystride],4),%[ref]\n\t" + /*Load the next 3 rows as registers become available.*/ + "movq (%[src]),%%mm2\n\t" + "movq (%[ref]),%%mm3\n\t" + "psadbw %%mm5,%%mm4\n\t" + "psadbw %%mm7,%%mm6\n\t" + "paddw %%mm4,%%mm0\n\t" + "movq (%[ref],%[ystride]),%%mm5\n\t" + "movq (%[src],%[ystride]),%%mm4\n\t" + "paddw %%mm6,%%mm0\n\t" + "movq (%[ref],%[ystride],2),%%mm7\n\t" + "movq (%[src],%[ystride],2),%%mm6\n\t" + /*Start adding their SADs to %%mm0*/ + "psadbw %%mm3,%%mm2\n\t" + "psadbw %%mm5,%%mm4\n\t" + "paddw %%mm2,%%mm0\n\t" + "psadbw %%mm7,%%mm6\n\t" + /*Load last row as registers become available.*/ + "movq (%[src],%[ystride3]),%%mm2\n\t" + "movq (%[ref],%[ystride3]),%%mm3\n\t" + /*And finish adding up their SADs.*/ + "paddw %%mm4,%%mm0\n\t" + "psadbw %%mm3,%%mm2\n\t" + "paddw %%mm6,%%mm0\n\t" + "paddw %%mm2,%%mm0\n\t" + "movd %%mm0,%[ret]\n\t" + :[ret]"=a"(ret),[src]"+%r"(_src),[ref]"+r"(_ref),[ystride3]"=&r"(ystride3) + :[ystride]"r"((ptrdiff_t)_ystride) + ); + return (unsigned)ret; +} + +unsigned oc_enc_frag_sad_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + /*Early termination is for suckers.*/ + return oc_enc_frag_sad_mmxext(_src,_ref,_ystride); +} + +/*Assumes the first two rows of %[ref1] and %[ref2] are in %%mm0...%%mm3, the + first two rows of %[src] are in %%mm4,%%mm5, and {1}x8 is in %%mm7. + We pre-load the next two rows of data as registers become available.*/ +#define OC_SAD2_LOOP \ + "#OC_SAD2_LOOP\n\t" \ + /*We want to compute (%%mm0+%%mm1>>1) on unsigned bytes without overflow, but \ + pavgb computes (%%mm0+%%mm1+1>>1). \ + The latter is exactly 1 too large when the low bit of two corresponding \ + bytes is only set in one of them. \ + Therefore we pxor the operands, pand to mask out the low bits, and psubb to \ + correct the output of pavgb.*/ \ + "movq %%mm0,%%mm6\n\t" \ + "lea (%[ref1],%[ystride],2),%[ref1]\n\t" \ + "pxor %%mm1,%%mm0\n\t" \ + "pavgb %%mm1,%%mm6\n\t" \ + "lea (%[ref2],%[ystride],2),%[ref2]\n\t" \ + "movq %%mm2,%%mm1\n\t" \ + "pand %%mm7,%%mm0\n\t" \ + "pavgb %%mm3,%%mm2\n\t" \ + "pxor %%mm3,%%mm1\n\t" \ + "movq (%[ref2],%[ystride]),%%mm3\n\t" \ + "psubb %%mm0,%%mm6\n\t" \ + "movq (%[ref1]),%%mm0\n\t" \ + "pand %%mm7,%%mm1\n\t" \ + "psadbw %%mm6,%%mm4\n\t" \ + "movd %[ret],%%mm6\n\t" \ + "psubb %%mm1,%%mm2\n\t" \ + "movq (%[ref2]),%%mm1\n\t" \ + "lea (%[src],%[ystride],2),%[src]\n\t" \ + "psadbw %%mm2,%%mm5\n\t" \ + "movq (%[ref1],%[ystride]),%%mm2\n\t" \ + "paddw %%mm4,%%mm5\n\t" \ + "movq (%[src]),%%mm4\n\t" \ + "paddw %%mm5,%%mm6\n\t" \ + "movq (%[src],%[ystride]),%%mm5\n\t" \ + "movd %%mm6,%[ret]\n\t" \ + +/*Same as above, but does not pre-load the next two rows.*/ +#define OC_SAD2_TAIL \ + "#OC_SAD2_TAIL\n\t" \ + "movq %%mm0,%%mm6\n\t" \ + "pavgb %%mm1,%%mm0\n\t" \ + "pxor %%mm1,%%mm6\n\t" \ + "movq %%mm2,%%mm1\n\t" \ + "pand %%mm7,%%mm6\n\t" \ + "pavgb %%mm3,%%mm2\n\t" \ + "pxor %%mm3,%%mm1\n\t" \ + "psubb %%mm6,%%mm0\n\t" \ + "pand %%mm7,%%mm1\n\t" \ + "psadbw %%mm0,%%mm4\n\t" \ + "psubb %%mm1,%%mm2\n\t" \ + "movd %[ret],%%mm6\n\t" \ + "psadbw %%mm2,%%mm5\n\t" \ + "paddw %%mm4,%%mm5\n\t" \ + "paddw %%mm5,%%mm6\n\t" \ + "movd %%mm6,%[ret]\n\t" \ + +unsigned oc_enc_frag_sad2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + ptrdiff_t ret; + __asm__ __volatile__( + "movq (%[ref1]),%%mm0\n\t" + "movq (%[ref2]),%%mm1\n\t" + "movq (%[ref1],%[ystride]),%%mm2\n\t" + "movq (%[ref2],%[ystride]),%%mm3\n\t" + "xor %[ret],%[ret]\n\t" + "movq (%[src]),%%mm4\n\t" + "pxor %%mm7,%%mm7\n\t" + "pcmpeqb %%mm6,%%mm6\n\t" + "movq (%[src],%[ystride]),%%mm5\n\t" + "psubb %%mm6,%%mm7\n\t" + OC_SAD2_LOOP + OC_SAD2_LOOP + OC_SAD2_LOOP + OC_SAD2_TAIL + :[ret]"=&a"(ret),[src]"+r"(_src),[ref1]"+%r"(_ref1),[ref2]"+r"(_ref2) + :[ystride]"r"((ptrdiff_t)_ystride) + ); + return (unsigned)ret; +} + +/*Load an 8x4 array of pixel values from %[src] and %[ref] and compute their + 16-bit difference in %%mm0...%%mm7.*/ +#define OC_LOAD_SUB_8x4(_off) \ + "#OC_LOAD_SUB_8x4\n\t" \ + "movd "_off"(%[src]),%%mm0\n\t" \ + "movd "_off"(%[ref]),%%mm4\n\t" \ + "movd "_off"(%[src],%[src_ystride]),%%mm1\n\t" \ + "lea (%[src],%[src_ystride],2),%[src]\n\t" \ + "movd "_off"(%[ref],%[ref_ystride]),%%mm5\n\t" \ + "lea (%[ref],%[ref_ystride],2),%[ref]\n\t" \ + "movd "_off"(%[src]),%%mm2\n\t" \ + "movd "_off"(%[ref]),%%mm7\n\t" \ + "movd "_off"(%[src],%[src_ystride]),%%mm3\n\t" \ + "movd "_off"(%[ref],%[ref_ystride]),%%mm6\n\t" \ + "punpcklbw %%mm4,%%mm0\n\t" \ + "lea (%[src],%[src_ystride],2),%[src]\n\t" \ + "punpcklbw %%mm4,%%mm4\n\t" \ + "lea (%[ref],%[ref_ystride],2),%[ref]\n\t" \ + "psubw %%mm4,%%mm0\n\t" \ + "movd "_off"(%[src]),%%mm4\n\t" \ + "movq %%mm0,"_off"*2(%[buf])\n\t" \ + "movd "_off"(%[ref]),%%mm0\n\t" \ + "punpcklbw %%mm5,%%mm1\n\t" \ + "punpcklbw %%mm5,%%mm5\n\t" \ + "psubw %%mm5,%%mm1\n\t" \ + "movd "_off"(%[src],%[src_ystride]),%%mm5\n\t" \ + "punpcklbw %%mm7,%%mm2\n\t" \ + "punpcklbw %%mm7,%%mm7\n\t" \ + "psubw %%mm7,%%mm2\n\t" \ + "movd "_off"(%[ref],%[ref_ystride]),%%mm7\n\t" \ + "punpcklbw %%mm6,%%mm3\n\t" \ + "lea (%[src],%[src_ystride],2),%[src]\n\t" \ + "punpcklbw %%mm6,%%mm6\n\t" \ + "psubw %%mm6,%%mm3\n\t" \ + "movd "_off"(%[src]),%%mm6\n\t" \ + "punpcklbw %%mm0,%%mm4\n\t" \ + "lea (%[ref],%[ref_ystride],2),%[ref]\n\t" \ + "punpcklbw %%mm0,%%mm0\n\t" \ + "lea (%[src],%[src_ystride],2),%[src]\n\t" \ + "psubw %%mm0,%%mm4\n\t" \ + "movd "_off"(%[ref]),%%mm0\n\t" \ + "punpcklbw %%mm7,%%mm5\n\t" \ + "neg %[src_ystride]\n\t" \ + "punpcklbw %%mm7,%%mm7\n\t" \ + "psubw %%mm7,%%mm5\n\t" \ + "movd "_off"(%[src],%[src_ystride]),%%mm7\n\t" \ + "punpcklbw %%mm0,%%mm6\n\t" \ + "lea (%[ref],%[ref_ystride],2),%[ref]\n\t" \ + "punpcklbw %%mm0,%%mm0\n\t" \ + "neg %[ref_ystride]\n\t" \ + "psubw %%mm0,%%mm6\n\t" \ + "movd "_off"(%[ref],%[ref_ystride]),%%mm0\n\t" \ + "lea (%[src],%[src_ystride],8),%[src]\n\t" \ + "punpcklbw %%mm0,%%mm7\n\t" \ + "neg %[src_ystride]\n\t" \ + "punpcklbw %%mm0,%%mm0\n\t" \ + "lea (%[ref],%[ref_ystride],8),%[ref]\n\t" \ + "psubw %%mm0,%%mm7\n\t" \ + "neg %[ref_ystride]\n\t" \ + "movq "_off"*2(%[buf]),%%mm0\n\t" \ + +/*Load an 8x4 array of pixel values from %[src] into %%mm0...%%mm7.*/ +#define OC_LOAD_8x4(_off) \ + "#OC_LOAD_8x4\n\t" \ + "movd "_off"(%[src]),%%mm0\n\t" \ + "movd "_off"(%[src],%[ystride]),%%mm1\n\t" \ + "movd "_off"(%[src],%[ystride],2),%%mm2\n\t" \ + "pxor %%mm7,%%mm7\n\t" \ + "movd "_off"(%[src],%[ystride3]),%%mm3\n\t" \ + "punpcklbw %%mm7,%%mm0\n\t" \ + "movd "_off"(%[src4]),%%mm4\n\t" \ + "punpcklbw %%mm7,%%mm1\n\t" \ + "movd "_off"(%[src4],%[ystride]),%%mm5\n\t" \ + "punpcklbw %%mm7,%%mm2\n\t" \ + "movd "_off"(%[src4],%[ystride],2),%%mm6\n\t" \ + "punpcklbw %%mm7,%%mm3\n\t" \ + "movd "_off"(%[src4],%[ystride3]),%%mm7\n\t" \ + "punpcklbw %%mm4,%%mm4\n\t" \ + "punpcklbw %%mm5,%%mm5\n\t" \ + "psrlw $8,%%mm4\n\t" \ + "psrlw $8,%%mm5\n\t" \ + "punpcklbw %%mm6,%%mm6\n\t" \ + "punpcklbw %%mm7,%%mm7\n\t" \ + "psrlw $8,%%mm6\n\t" \ + "psrlw $8,%%mm7\n\t" \ + +/*Performs the first two stages of an 8-point 1-D Hadamard transform. + The transform is performed in place, except that outputs 0-3 are swapped with + outputs 4-7. + Outputs 2, 3, 6 and 7 from the second stage are negated (which allows us to + perform this stage in place with no temporary registers).*/ +#define OC_HADAMARD_AB_8x4 \ + "#OC_HADAMARD_AB_8x4\n\t" \ + /*Stage A: \ + Outputs 0-3 are swapped with 4-7 here.*/ \ + "paddw %%mm1,%%mm5\n\t" \ + "paddw %%mm2,%%mm6\n\t" \ + "paddw %%mm1,%%mm1\n\t" \ + "paddw %%mm2,%%mm2\n\t" \ + "psubw %%mm5,%%mm1\n\t" \ + "psubw %%mm6,%%mm2\n\t" \ + "paddw %%mm3,%%mm7\n\t" \ + "paddw %%mm0,%%mm4\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + "paddw %%mm0,%%mm0\n\t" \ + "psubw %%mm7,%%mm3\n\t" \ + "psubw %%mm4,%%mm0\n\t" \ + /*Stage B:*/ \ + "paddw %%mm2,%%mm0\n\t" \ + "paddw %%mm3,%%mm1\n\t" \ + "paddw %%mm6,%%mm4\n\t" \ + "paddw %%mm7,%%mm5\n\t" \ + "paddw %%mm2,%%mm2\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + "paddw %%mm6,%%mm6\n\t" \ + "paddw %%mm7,%%mm7\n\t" \ + "psubw %%mm0,%%mm2\n\t" \ + "psubw %%mm1,%%mm3\n\t" \ + "psubw %%mm4,%%mm6\n\t" \ + "psubw %%mm5,%%mm7\n\t" \ + +/*Performs the last stage of an 8-point 1-D Hadamard transform in place. + Ouputs 1, 3, 5, and 7 are negated (which allows us to perform this stage in + place with no temporary registers).*/ +#define OC_HADAMARD_C_8x4 \ + "#OC_HADAMARD_C_8x4\n\t" \ + /*Stage C:*/ \ + "paddw %%mm1,%%mm0\n\t" \ + "paddw %%mm3,%%mm2\n\t" \ + "paddw %%mm5,%%mm4\n\t" \ + "paddw %%mm7,%%mm6\n\t" \ + "paddw %%mm1,%%mm1\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + "paddw %%mm5,%%mm5\n\t" \ + "paddw %%mm7,%%mm7\n\t" \ + "psubw %%mm0,%%mm1\n\t" \ + "psubw %%mm2,%%mm3\n\t" \ + "psubw %%mm4,%%mm5\n\t" \ + "psubw %%mm6,%%mm7\n\t" \ + +/*Performs an 8-point 1-D Hadamard transform. + The transform is performed in place, except that outputs 0-3 are swapped with + outputs 4-7. + Outputs 1, 2, 5 and 6 are negated (which allows us to perform the transform + in place with no temporary registers).*/ +#define OC_HADAMARD_8x4 \ + OC_HADAMARD_AB_8x4 \ + OC_HADAMARD_C_8x4 \ + +/*Performs the first part of the final stage of the Hadamard transform and + summing of absolute values. + At the end of this part, %%mm1 will contain the DC coefficient of the + transform.*/ +#define OC_HADAMARD_C_ABS_ACCUM_A_8x4(_r6,_r7) \ + /*We use the fact that \ + (abs(a+b)+abs(a-b))/2=max(abs(a),abs(b)) \ + to merge the final butterfly with the abs and the first stage of \ + accumulation. \ + Thus we can avoid using pabsw, which is not available until SSSE3. \ + Emulating pabsw takes 3 instructions, so the straightforward MMXEXT \ + implementation would be (3+3)*8+7=55 instructions (+4 for spilling \ + registers). \ + Even with pabsw, it would be (3+1)*8+7=39 instructions (with no spills). \ + This implementation is only 26 (+4 for spilling registers).*/ \ + "#OC_HADAMARD_C_ABS_ACCUM_A_8x4\n\t" \ + "movq %%mm7,"_r7"(%[buf])\n\t" \ + "movq %%mm6,"_r6"(%[buf])\n\t" \ + /*mm7={0x7FFF}x4 \ + mm0=max(abs(mm0),abs(mm1))-0x7FFF*/ \ + "pcmpeqb %%mm7,%%mm7\n\t" \ + "movq %%mm0,%%mm6\n\t" \ + "psrlw $1,%%mm7\n\t" \ + "paddw %%mm1,%%mm6\n\t" \ + "pmaxsw %%mm1,%%mm0\n\t" \ + "paddsw %%mm7,%%mm6\n\t" \ + "psubw %%mm6,%%mm0\n\t" \ + /*mm2=max(abs(mm2),abs(mm3))-0x7FFF \ + mm4=max(abs(mm4),abs(mm5))-0x7FFF*/ \ + "movq %%mm2,%%mm6\n\t" \ + "movq %%mm4,%%mm1\n\t" \ + "pmaxsw %%mm3,%%mm2\n\t" \ + "pmaxsw %%mm5,%%mm4\n\t" \ + "paddw %%mm3,%%mm6\n\t" \ + "paddw %%mm5,%%mm1\n\t" \ + "movq "_r7"(%[buf]),%%mm3\n\t" \ + +/*Performs the second part of the final stage of the Hadamard transform and + summing of absolute values.*/ +#define OC_HADAMARD_C_ABS_ACCUM_B_8x4(_r6,_r7) \ + "#OC_HADAMARD_C_ABS_ACCUM_B_8x4\n\t" \ + "paddsw %%mm7,%%mm6\n\t" \ + "movq "_r6"(%[buf]),%%mm5\n\t" \ + "paddsw %%mm7,%%mm1\n\t" \ + "psubw %%mm6,%%mm2\n\t" \ + "psubw %%mm1,%%mm4\n\t" \ + /*mm7={1}x4 (needed for the horizontal add that follows) \ + mm0+=mm2+mm4+max(abs(mm3),abs(mm5))-0x7FFF*/ \ + "movq %%mm3,%%mm6\n\t" \ + "pmaxsw %%mm5,%%mm3\n\t" \ + "paddw %%mm2,%%mm0\n\t" \ + "paddw %%mm5,%%mm6\n\t" \ + "paddw %%mm4,%%mm0\n\t" \ + "paddsw %%mm7,%%mm6\n\t" \ + "paddw %%mm3,%%mm0\n\t" \ + "psrlw $14,%%mm7\n\t" \ + "psubw %%mm6,%%mm0\n\t" \ + +/*Performs the last stage of an 8-point 1-D Hadamard transform, takes the + absolute value of each component, and accumulates everything into mm0. + This is the only portion of SATD which requires MMXEXT (we could use plain + MMX, but it takes 4 instructions and an extra register to work around the + lack of a pmaxsw, which is a pretty serious penalty).*/ +#define OC_HADAMARD_C_ABS_ACCUM_8x4(_r6,_r7) \ + OC_HADAMARD_C_ABS_ACCUM_A_8x4(_r6,_r7) \ + OC_HADAMARD_C_ABS_ACCUM_B_8x4(_r6,_r7) \ + +/*Performs an 8-point 1-D Hadamard transform, takes the absolute value of each + component, and accumulates everything into mm0. + Note that mm0 will have an extra 4 added to each column, and that after + removing this value, the remainder will be half the conventional value.*/ +#define OC_HADAMARD_ABS_ACCUM_8x4(_r6,_r7) \ + OC_HADAMARD_AB_8x4 \ + OC_HADAMARD_C_ABS_ACCUM_8x4(_r6,_r7) + +/*Performs two 4x4 transposes (mostly) in place. + On input, {mm0,mm1,mm2,mm3} contains rows {e,f,g,h}, and {mm4,mm5,mm6,mm7} + contains rows {a,b,c,d}. + On output, {0x40,0x50,0x60,0x70}+_off(%[buf]) contains {e,f,g,h}^T, and + {mm4,mm5,mm6,mm7} contains the transposed rows {a,b,c,d}^T.*/ +#define OC_TRANSPOSE_4x4x2(_off) \ + "#OC_TRANSPOSE_4x4x2\n\t" \ + /*First 4x4 transpose:*/ \ + "movq %%mm5,0x10+"_off"(%[buf])\n\t" \ + /*mm0 = e3 e2 e1 e0 \ + mm1 = f3 f2 f1 f0 \ + mm2 = g3 g2 g1 g0 \ + mm3 = h3 h2 h1 h0*/ \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklwd %%mm3,%%mm2\n\t" \ + "punpckhwd %%mm3,%%mm5\n\t" \ + "movq %%mm0,%%mm3\n\t" \ + "punpcklwd %%mm1,%%mm0\n\t" \ + "punpckhwd %%mm1,%%mm3\n\t" \ + /*mm0 = f1 e1 f0 e0 \ + mm3 = f3 e3 f2 e2 \ + mm2 = h1 g1 h0 g0 \ + mm5 = h3 g3 h2 g2*/ \ + "movq %%mm0,%%mm1\n\t" \ + "punpckldq %%mm2,%%mm0\n\t" \ + "punpckhdq %%mm2,%%mm1\n\t" \ + "movq %%mm3,%%mm2\n\t" \ + "punpckhdq %%mm5,%%mm3\n\t" \ + "movq %%mm0,0x40+"_off"(%[buf])\n\t" \ + "punpckldq %%mm5,%%mm2\n\t" \ + /*mm0 = h0 g0 f0 e0 \ + mm1 = h1 g1 f1 e1 \ + mm2 = h2 g2 f2 e2 \ + mm3 = h3 g3 f3 e3*/ \ + "movq 0x10+"_off"(%[buf]),%%mm5\n\t" \ + /*Second 4x4 transpose:*/ \ + /*mm4 = a3 a2 a1 a0 \ + mm5 = b3 b2 b1 b0 \ + mm6 = c3 c2 c1 c0 \ + mm7 = d3 d2 d1 d0*/ \ + "movq %%mm6,%%mm0\n\t" \ + "punpcklwd %%mm7,%%mm6\n\t" \ + "movq %%mm1,0x50+"_off"(%[buf])\n\t" \ + "punpckhwd %%mm7,%%mm0\n\t" \ + "movq %%mm4,%%mm7\n\t" \ + "punpcklwd %%mm5,%%mm4\n\t" \ + "movq %%mm2,0x60+"_off"(%[buf])\n\t" \ + "punpckhwd %%mm5,%%mm7\n\t" \ + /*mm4 = b1 a1 b0 a0 \ + mm7 = b3 a3 b2 a2 \ + mm6 = d1 c1 d0 c0 \ + mm0 = d3 c3 d2 c2*/ \ + "movq %%mm4,%%mm5\n\t" \ + "punpckldq %%mm6,%%mm4\n\t" \ + "movq %%mm3,0x70+"_off"(%[buf])\n\t" \ + "punpckhdq %%mm6,%%mm5\n\t" \ + "movq %%mm7,%%mm6\n\t" \ + "punpckhdq %%mm0,%%mm7\n\t" \ + "punpckldq %%mm0,%%mm6\n\t" \ + /*mm4 = d0 c0 b0 a0 \ + mm5 = d1 c1 b1 a1 \ + mm6 = d2 c2 b2 a2 \ + mm7 = d3 c3 b3 a3*/ \ + +static unsigned oc_int_frag_satd_thresh_mmxext(const unsigned char *_src, + int _src_ystride,const unsigned char *_ref,int _ref_ystride,unsigned _thresh){ + OC_ALIGN8(ogg_int16_t buf[64]); + ogg_int16_t *bufp; + unsigned ret; + unsigned ret2; + bufp=buf; + __asm__ __volatile__( + OC_LOAD_SUB_8x4("0x00") + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2("0x00") + /*Finish swapping out this 8x4 block to make room for the next one. + mm0...mm3 have been swapped out already.*/ + "movq %%mm4,0x00(%[buf])\n\t" + "movq %%mm5,0x10(%[buf])\n\t" + "movq %%mm6,0x20(%[buf])\n\t" + "movq %%mm7,0x30(%[buf])\n\t" + OC_LOAD_SUB_8x4("0x04") + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2("0x08") + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, so + we only have to do half the loads.*/ + "movq 0x10(%[buf]),%%mm1\n\t" + "movq 0x20(%[buf]),%%mm2\n\t" + "movq 0x30(%[buf]),%%mm3\n\t" + "movq 0x00(%[buf]),%%mm0\n\t" + OC_HADAMARD_ABS_ACCUM_8x4("0x28","0x38") + /*Up to this point, everything fit in 16 bits (8 input + 1 for the + difference + 2*3 for the two 8-point 1-D Hadamards - 1 for the abs - 1 + for the factor of two we dropped + 3 for the vertical accumulation). + Now we finally have to promote things to dwords. + We break this part out of OC_HADAMARD_ABS_ACCUM_8x4 to hide the long + latency of pmaddwd by starting the next series of loads now.*/ + "mov %[thresh],%[ret2]\n\t" + "pmaddwd %%mm7,%%mm0\n\t" + "movq 0x50(%[buf]),%%mm1\n\t" + "movq 0x58(%[buf]),%%mm5\n\t" + "movq %%mm0,%%mm4\n\t" + "movq 0x60(%[buf]),%%mm2\n\t" + "punpckhdq %%mm0,%%mm0\n\t" + "movq 0x68(%[buf]),%%mm6\n\t" + "paddd %%mm0,%%mm4\n\t" + "movq 0x70(%[buf]),%%mm3\n\t" + "movd %%mm4,%[ret]\n\t" + "movq 0x78(%[buf]),%%mm7\n\t" + /*The sums produced by OC_HADAMARD_ABS_ACCUM_8x4 each have an extra 4 + added to them, and a factor of two removed; correct the final sum here.*/ + "lea -32(%[ret],%[ret]),%[ret]\n\t" + "movq 0x40(%[buf]),%%mm0\n\t" + "cmp %[ret2],%[ret]\n\t" + "movq 0x48(%[buf]),%%mm4\n\t" + "jae 1f\n\t" + OC_HADAMARD_ABS_ACCUM_8x4("0x68","0x78") + "pmaddwd %%mm7,%%mm0\n\t" + /*There isn't much to stick in here to hide the latency this time, but the + alternative to pmaddwd is movq->punpcklwd->punpckhwd->paddd, whose + latency is even worse.*/ + "sub $32,%[ret]\n\t" + "movq %%mm0,%%mm4\n\t" + "punpckhdq %%mm0,%%mm0\n\t" + "paddd %%mm0,%%mm4\n\t" + "movd %%mm4,%[ret2]\n\t" + "lea (%[ret],%[ret2],2),%[ret]\n\t" + ".p2align 4,,15\n\t" + "1:\n\t" + /*Although it looks like we're using 7 registers here, gcc can alias %[ret] + and %[ret2] with some of the inputs, since for once we don't write to + them until after we're done using everything but %[buf] (which is also + listed as an output to ensure gcc _doesn't_ alias them against it).*/ + /*Note that _src_ystride and _ref_ystride must be given non-overlapping + constraints, otherewise if gcc can prove they're equal it will allocate + them to the same register (which is bad); _src and _ref face a similar + problem, though those are never actually the same.*/ + :[ret]"=a"(ret),[ret2]"=r"(ret2),[buf]"+r"(bufp) + :[src]"r"(_src),[src_ystride]"c"((ptrdiff_t)_src_ystride), + [ref]"r"(_ref),[ref_ystride]"d"((ptrdiff_t)_ref_ystride), + [thresh]"m"(_thresh) + /*We have to use neg, so we actually clobber the condition codes for once + (not to mention cmp, sub, and add).*/ + :"cc" + ); + return ret; +} + +unsigned oc_enc_frag_satd_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + return oc_int_frag_satd_thresh_mmxext(_src,_ystride,_ref,_ystride,_thresh); +} + +/*Our internal implementation of frag_copy2 takes an extra stride parameter so + we can share code with oc_enc_frag_satd2_thresh_mmxext().*/ +static void oc_int_frag_copy2_mmxext(unsigned char *_dst,int _dst_ystride, + const unsigned char *_src1,const unsigned char *_src2,int _src_ystride){ + __asm__ __volatile__( + /*Load the first 3 rows.*/ + "movq (%[src1]),%%mm0\n\t" + "movq (%[src2]),%%mm1\n\t" + "movq (%[src1],%[src_ystride]),%%mm2\n\t" + "lea (%[src1],%[src_ystride],2),%[src1]\n\t" + "movq (%[src2],%[src_ystride]),%%mm3\n\t" + "lea (%[src2],%[src_ystride],2),%[src2]\n\t" + "pxor %%mm7,%%mm7\n\t" + "movq (%[src1]),%%mm4\n\t" + "pcmpeqb %%mm6,%%mm6\n\t" + "movq (%[src2]),%%mm5\n\t" + /*mm7={1}x8.*/ + "psubb %%mm6,%%mm7\n\t" + /*Start averaging %%mm0 and %%mm1 into %%mm6.*/ + "movq %%mm0,%%mm6\n\t" + "pxor %%mm1,%%mm0\n\t" + "pavgb %%mm1,%%mm6\n\t" + /*%%mm1 is free, start averaging %%mm3 into %%mm2 using %%mm1.*/ + "movq %%mm2,%%mm1\n\t" + "pand %%mm7,%%mm0\n\t" + "pavgb %%mm3,%%mm2\n\t" + "pxor %%mm3,%%mm1\n\t" + /*%%mm3 is free.*/ + "psubb %%mm0,%%mm6\n\t" + /*%%mm0 is free, start loading the next row.*/ + "movq (%[src1],%[src_ystride]),%%mm0\n\t" + /*Start averaging %%mm5 and %%mm4 using %%mm3.*/ + "movq %%mm4,%%mm3\n\t" + /*%%mm6 (row 0) is done; write it out.*/ + "movq %%mm6,(%[dst])\n\t" + "pand %%mm7,%%mm1\n\t" + "pavgb %%mm5,%%mm4\n\t" + "psubb %%mm1,%%mm2\n\t" + /*%%mm1 is free, continue loading the next row.*/ + "movq (%[src2],%[src_ystride]),%%mm1\n\t" + "pxor %%mm5,%%mm3\n\t" + "lea (%[src1],%[src_ystride],2),%[src1]\n\t" + /*%%mm2 (row 1) is done; write it out.*/ + "movq %%mm2,(%[dst],%[dst_ystride])\n\t" + "pand %%mm7,%%mm3\n\t" + /*Start loading the next row.*/ + "movq (%[src1]),%%mm2\n\t" + "lea (%[dst],%[dst_ystride],2),%[dst]\n\t" + "psubb %%mm3,%%mm4\n\t" + "lea (%[src2],%[src_ystride],2),%[src2]\n\t" + /*%%mm4 (row 2) is done; write it out.*/ + "movq %%mm4,(%[dst])\n\t" + /*Continue loading the next row.*/ + "movq (%[src2]),%%mm3\n\t" + /*Start averaging %%mm0 and %%mm1 into %%mm6.*/ + "movq %%mm0,%%mm6\n\t" + "pxor %%mm1,%%mm0\n\t" + /*Start loading the next row.*/ + "movq (%[src1],%[src_ystride]),%%mm4\n\t" + "pavgb %%mm1,%%mm6\n\t" + /*%%mm1 is free; start averaging %%mm3 into %%mm2 using %%mm1.*/ + "movq %%mm2,%%mm1\n\t" + "pand %%mm7,%%mm0\n\t" + /*Continue loading the next row.*/ + "movq (%[src2],%[src_ystride]),%%mm5\n\t" + "pavgb %%mm3,%%mm2\n\t" + "lea (%[src1],%[src_ystride],2),%[src1]\n\t" + "pxor %%mm3,%%mm1\n\t" + /*%%mm3 is free.*/ + "psubb %%mm0,%%mm6\n\t" + /*%%mm0 is free, start loading the next row.*/ + "movq (%[src1]),%%mm0\n\t" + /*Start averaging %%mm5 into %%mm4 using %%mm3.*/ + "movq %%mm4,%%mm3\n\t" + /*%%mm6 (row 3) is done; write it out.*/ + "movq %%mm6,(%[dst],%[dst_ystride])\n\t" + "pand %%mm7,%%mm1\n\t" + "lea (%[src2],%[src_ystride],2),%[src2]\n\t" + "pavgb %%mm5,%%mm4\n\t" + "lea (%[dst],%[dst_ystride],2),%[dst]\n\t" + "psubb %%mm1,%%mm2\n\t" + /*%%mm1 is free; continue loading the next row.*/ + "movq (%[src2]),%%mm1\n\t" + "pxor %%mm5,%%mm3\n\t" + /*%%mm2 (row 4) is done; write it out.*/ + "movq %%mm2,(%[dst])\n\t" + "pand %%mm7,%%mm3\n\t" + /*Start loading the next row.*/ + "movq (%[src1],%[src_ystride]),%%mm2\n\t" + "psubb %%mm3,%%mm4\n\t" + /*Start averaging %%mm0 and %%mm1 into %%mm6.*/ + "movq %%mm0,%%mm6\n\t" + /*Continue loading the next row.*/ + "movq (%[src2],%[src_ystride]),%%mm3\n\t" + /*%%mm4 (row 5) is done; write it out.*/ + "movq %%mm4,(%[dst],%[dst_ystride])\n\t" + "pxor %%mm1,%%mm0\n\t" + "pavgb %%mm1,%%mm6\n\t" + /*%%mm4 is free; start averaging %%mm3 into %%mm2 using %%mm4.*/ + "movq %%mm2,%%mm4\n\t" + "pand %%mm7,%%mm0\n\t" + "pavgb %%mm3,%%mm2\n\t" + "pxor %%mm3,%%mm4\n\t" + "lea (%[dst],%[dst_ystride],2),%[dst]\n\t" + "psubb %%mm0,%%mm6\n\t" + "pand %%mm7,%%mm4\n\t" + /*%%mm6 (row 6) is done, write it out.*/ + "movq %%mm6,(%[dst])\n\t" + "psubb %%mm4,%%mm2\n\t" + /*%%mm2 (row 7) is done, write it out.*/ + "movq %%mm2,(%[dst],%[dst_ystride])\n\t" + :[dst]"+r"(_dst),[src1]"+%r"(_src1),[src2]"+r"(_src2) + :[dst_ystride]"r"((ptrdiff_t)_dst_ystride), + [src_ystride]"r"((ptrdiff_t)_src_ystride) + :"memory" + ); +} + +unsigned oc_enc_frag_satd2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + OC_ALIGN8(unsigned char ref[64]); + oc_int_frag_copy2_mmxext(ref,8,_ref1,_ref2,_ystride); + return oc_int_frag_satd_thresh_mmxext(_src,_ystride,ref,8,_thresh); +} + +unsigned oc_enc_frag_intra_satd_mmxext(const unsigned char *_src, + int _ystride){ + OC_ALIGN8(ogg_int16_t buf[64]); + ogg_int16_t *bufp; + unsigned ret; + unsigned ret2; + bufp=buf; + __asm__ __volatile__( + OC_LOAD_8x4("0x00") + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2("0x00") + /*Finish swapping out this 8x4 block to make room for the next one. + mm0...mm3 have been swapped out already.*/ + "movq %%mm4,0x00(%[buf])\n\t" + "movq %%mm5,0x10(%[buf])\n\t" + "movq %%mm6,0x20(%[buf])\n\t" + "movq %%mm7,0x30(%[buf])\n\t" + OC_LOAD_8x4("0x04") + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2("0x08") + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, so + we only have to do half the loads.*/ + "movq 0x10(%[buf]),%%mm1\n\t" + "movq 0x20(%[buf]),%%mm2\n\t" + "movq 0x30(%[buf]),%%mm3\n\t" + "movq 0x00(%[buf]),%%mm0\n\t" + /*We split out the stages here so we can save the DC coefficient in the + middle.*/ + OC_HADAMARD_AB_8x4 + OC_HADAMARD_C_ABS_ACCUM_A_8x4("0x28","0x38") + "movd %%mm1,%[ret]\n\t" + OC_HADAMARD_C_ABS_ACCUM_B_8x4("0x28","0x38") + /*Up to this point, everything fit in 16 bits (8 input + 1 for the + difference + 2*3 for the two 8-point 1-D Hadamards - 1 for the abs - 1 + for the factor of two we dropped + 3 for the vertical accumulation). + Now we finally have to promote things to dwords. + We break this part out of OC_HADAMARD_ABS_ACCUM_8x4 to hide the long + latency of pmaddwd by starting the next series of loads now.*/ + "pmaddwd %%mm7,%%mm0\n\t" + "movq 0x50(%[buf]),%%mm1\n\t" + "movq 0x58(%[buf]),%%mm5\n\t" + "movq 0x60(%[buf]),%%mm2\n\t" + "movq %%mm0,%%mm4\n\t" + "movq 0x68(%[buf]),%%mm6\n\t" + "punpckhdq %%mm0,%%mm0\n\t" + "movq 0x70(%[buf]),%%mm3\n\t" + "paddd %%mm0,%%mm4\n\t" + "movq 0x78(%[buf]),%%mm7\n\t" + "movd %%mm4,%[ret2]\n\t" + "movq 0x40(%[buf]),%%mm0\n\t" + "movq 0x48(%[buf]),%%mm4\n\t" + OC_HADAMARD_ABS_ACCUM_8x4("0x68","0x78") + "pmaddwd %%mm7,%%mm0\n\t" + /*We assume that the DC coefficient is always positive (which is true, + because the input to the INTRA transform was not a difference).*/ + "movzx %w[ret],%[ret]\n\t" + "add %[ret2],%[ret2]\n\t" + "sub %[ret],%[ret2]\n\t" + "movq %%mm0,%%mm4\n\t" + "punpckhdq %%mm0,%%mm0\n\t" + "paddd %%mm0,%%mm4\n\t" + "movd %%mm4,%[ret]\n\t" + "lea -64(%[ret2],%[ret],2),%[ret]\n\t" + /*Although it looks like we're using 7 registers here, gcc can alias %[ret] + and %[ret2] with some of the inputs, since for once we don't write to + them until after we're done using everything but %[buf] (which is also + listed as an output to ensure gcc _doesn't_ alias them against it).*/ + :[ret]"=a"(ret),[ret2]"=r"(ret2),[buf]"+r"(bufp) + :[src]"r"(_src),[src4]"r"(_src+4*_ystride), + [ystride]"r"((ptrdiff_t)_ystride),[ystride3]"r"((ptrdiff_t)3*_ystride) + /*We have to use sub, so we actually clobber the condition codes for once + (not to mention add).*/ + :"cc" + ); + return ret; +} + +void oc_enc_frag_sub_mmx(ogg_int16_t _residue[64], + const unsigned char *_src,const unsigned char *_ref,int _ystride){ + int i; + __asm__ __volatile__("pxor %%mm7,%%mm7\n\t"::); + for(i=4;i-->0;){ + __asm__ __volatile__( + /*mm0=[src]*/ + "movq (%[src]),%%mm0\n\t" + /*mm1=[ref]*/ + "movq (%[ref]),%%mm1\n\t" + /*mm4=[src+ystride]*/ + "movq (%[src],%[ystride]),%%mm4\n\t" + /*mm5=[ref+ystride]*/ + "movq (%[ref],%[ystride]),%%mm5\n\t" + /*Compute [src]-[ref].*/ + "movq %%mm0,%%mm2\n\t" + "punpcklbw %%mm7,%%mm0\n\t" + "movq %%mm1,%%mm3\n\t" + "punpckhbw %%mm7,%%mm2\n\t" + "punpcklbw %%mm7,%%mm1\n\t" + "punpckhbw %%mm7,%%mm3\n\t" + "psubw %%mm1,%%mm0\n\t" + "psubw %%mm3,%%mm2\n\t" + /*Compute [src+ystride]-[ref+ystride].*/ + "movq %%mm4,%%mm1\n\t" + "punpcklbw %%mm7,%%mm4\n\t" + "movq %%mm5,%%mm3\n\t" + "punpckhbw %%mm7,%%mm1\n\t" + "lea (%[src],%[ystride],2),%[src]\n\t" + "punpcklbw %%mm7,%%mm5\n\t" + "lea (%[ref],%[ystride],2),%[ref]\n\t" + "punpckhbw %%mm7,%%mm3\n\t" + "psubw %%mm5,%%mm4\n\t" + "psubw %%mm3,%%mm1\n\t" + /*Write the answer out.*/ + "movq %%mm0,0x00(%[residue])\n\t" + "movq %%mm2,0x08(%[residue])\n\t" + "movq %%mm4,0x10(%[residue])\n\t" + "movq %%mm1,0x18(%[residue])\n\t" + "lea 0x20(%[residue]),%[residue]\n\t" + :[residue]"+r"(_residue),[src]"+r"(_src),[ref]"+r"(_ref) + :[ystride]"r"((ptrdiff_t)_ystride) + :"memory" + ); + } +} + +void oc_enc_frag_sub_128_mmx(ogg_int16_t _residue[64], + const unsigned char *_src,int _ystride){ + ptrdiff_t ystride3; + __asm__ __volatile__( + /*mm0=[src]*/ + "movq (%[src]),%%mm0\n\t" + /*mm1=[src+ystride]*/ + "movq (%[src],%[ystride]),%%mm1\n\t" + /*mm6={-1}x4*/ + "pcmpeqw %%mm6,%%mm6\n\t" + /*mm2=[src+2*ystride]*/ + "movq (%[src],%[ystride],2),%%mm2\n\t" + /*[ystride3]=3*[ystride]*/ + "lea (%[ystride],%[ystride],2),%[ystride3]\n\t" + /*mm6={1}x4*/ + "psllw $15,%%mm6\n\t" + /*mm3=[src+3*ystride]*/ + "movq (%[src],%[ystride3]),%%mm3\n\t" + /*mm6={128}x4*/ + "psrlw $8,%%mm6\n\t" + /*mm7=0*/ + "pxor %%mm7,%%mm7\n\t" + /*[src]=[src]+4*[ystride]*/ + "lea (%[src],%[ystride],4),%[src]\n\t" + /*Compute [src]-128 and [src+ystride]-128*/ + "movq %%mm0,%%mm4\n\t" + "punpcklbw %%mm7,%%mm0\n\t" + "movq %%mm1,%%mm5\n\t" + "punpckhbw %%mm7,%%mm4\n\t" + "psubw %%mm6,%%mm0\n\t" + "punpcklbw %%mm7,%%mm1\n\t" + "psubw %%mm6,%%mm4\n\t" + "punpckhbw %%mm7,%%mm5\n\t" + "psubw %%mm6,%%mm1\n\t" + "psubw %%mm6,%%mm5\n\t" + /*Write the answer out.*/ + "movq %%mm0,0x00(%[residue])\n\t" + "movq %%mm4,0x08(%[residue])\n\t" + "movq %%mm1,0x10(%[residue])\n\t" + "movq %%mm5,0x18(%[residue])\n\t" + /*mm0=[src+4*ystride]*/ + "movq (%[src]),%%mm0\n\t" + /*mm1=[src+5*ystride]*/ + "movq (%[src],%[ystride]),%%mm1\n\t" + /*Compute [src+2*ystride]-128 and [src+3*ystride]-128*/ + "movq %%mm2,%%mm4\n\t" + "punpcklbw %%mm7,%%mm2\n\t" + "movq %%mm3,%%mm5\n\t" + "punpckhbw %%mm7,%%mm4\n\t" + "psubw %%mm6,%%mm2\n\t" + "punpcklbw %%mm7,%%mm3\n\t" + "psubw %%mm6,%%mm4\n\t" + "punpckhbw %%mm7,%%mm5\n\t" + "psubw %%mm6,%%mm3\n\t" + "psubw %%mm6,%%mm5\n\t" + /*Write the answer out.*/ + "movq %%mm2,0x20(%[residue])\n\t" + "movq %%mm4,0x28(%[residue])\n\t" + "movq %%mm3,0x30(%[residue])\n\t" + "movq %%mm5,0x38(%[residue])\n\t" + /*mm2=[src+6*ystride]*/ + "movq (%[src],%[ystride],2),%%mm2\n\t" + /*mm3=[src+7*ystride]*/ + "movq (%[src],%[ystride3]),%%mm3\n\t" + /*Compute [src+4*ystride]-128 and [src+5*ystride]-128*/ + "movq %%mm0,%%mm4\n\t" + "punpcklbw %%mm7,%%mm0\n\t" + "movq %%mm1,%%mm5\n\t" + "punpckhbw %%mm7,%%mm4\n\t" + "psubw %%mm6,%%mm0\n\t" + "punpcklbw %%mm7,%%mm1\n\t" + "psubw %%mm6,%%mm4\n\t" + "punpckhbw %%mm7,%%mm5\n\t" + "psubw %%mm6,%%mm1\n\t" + "psubw %%mm6,%%mm5\n\t" + /*Write the answer out.*/ + "movq %%mm0,0x40(%[residue])\n\t" + "movq %%mm4,0x48(%[residue])\n\t" + "movq %%mm1,0x50(%[residue])\n\t" + "movq %%mm5,0x58(%[residue])\n\t" + /*Compute [src+6*ystride]-128 and [src+7*ystride]-128*/ + "movq %%mm2,%%mm4\n\t" + "punpcklbw %%mm7,%%mm2\n\t" + "movq %%mm3,%%mm5\n\t" + "punpckhbw %%mm7,%%mm4\n\t" + "psubw %%mm6,%%mm2\n\t" + "punpcklbw %%mm7,%%mm3\n\t" + "psubw %%mm6,%%mm4\n\t" + "punpckhbw %%mm7,%%mm5\n\t" + "psubw %%mm6,%%mm3\n\t" + "psubw %%mm6,%%mm5\n\t" + /*Write the answer out.*/ + "movq %%mm2,0x60(%[residue])\n\t" + "movq %%mm4,0x68(%[residue])\n\t" + "movq %%mm3,0x70(%[residue])\n\t" + "movq %%mm5,0x78(%[residue])\n\t" + :[src]"+r"(_src),[ystride3]"=&r"(ystride3) + :[residue]"r"(_residue),[ystride]"r"((ptrdiff_t)_ystride) + :"memory" + ); +} + +void oc_enc_frag_copy2_mmxext(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride){ + oc_int_frag_copy2_mmxext(_dst,_ystride,_src1,_src2,_ystride); +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxfdct.c b/libs/libtheora-1.1/lib/x86/mmxfdct.c new file mode 100644 index 00000000..21187525 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxfdct.c @@ -0,0 +1,665 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 1999-2006 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ********************************************************************/ +/*MMX fDCT implementation for x86_32*/ +/*$Id: fdct_ses2.c 14579 2008-03-12 06:42:40Z xiphmont $*/ +#include "x86enc.h" + +#if defined(OC_X86_ASM) + +# define OC_FDCT_STAGE1_8x4 \ + "#OC_FDCT_STAGE1_8x4\n\t" \ + /*Stage 1:*/ \ + /*mm0=t7'=t0-t7*/ \ + "psubw %%mm7,%%mm0\n\t" \ + "paddw %%mm7,%%mm7\n\t" \ + /*mm1=t6'=t1-t6*/ \ + "psubw %%mm6,%%mm1\n\t" \ + "paddw %%mm6,%%mm6\n\t" \ + /*mm2=t5'=t2-t5*/ \ + "psubw %%mm5,%%mm2\n\t" \ + "paddw %%mm5,%%mm5\n\t" \ + /*mm3=t4'=t3-t4*/ \ + "psubw %%mm4,%%mm3\n\t" \ + "paddw %%mm4,%%mm4\n\t" \ + /*mm7=t0'=t0+t7*/ \ + "paddw %%mm0,%%mm7\n\t" \ + /*mm6=t1'=t1+t6*/ \ + "paddw %%mm1,%%mm6\n\t" \ + /*mm5=t2'=t2+t5*/ \ + "paddw %%mm2,%%mm5\n\t" \ + /*mm4=t3'=t3+t4*/ \ + "paddw %%mm3,%%mm4\n\t" \ + +# define OC_FDCT8x4(_r0,_r1,_r2,_r3,_r4,_r5,_r6,_r7) \ + "#OC_FDCT8x4\n\t" \ + /*Stage 2:*/ \ + /*mm7=t3''=t0'-t3'*/ \ + "psubw %%mm4,%%mm7\n\t" \ + "paddw %%mm4,%%mm4\n\t" \ + /*mm6=t2''=t1'-t2'*/ \ + "psubw %%mm5,%%mm6\n\t" \ + "movq %%mm7,"_r6"(%[y])\n\t" \ + "paddw %%mm5,%%mm5\n\t" \ + /*mm1=t5''=t6'-t5'*/ \ + "psubw %%mm2,%%mm1\n\t" \ + "movq %%mm6,"_r2"(%[y])\n\t" \ + /*mm4=t0''=t0'+t3'*/ \ + "paddw %%mm7,%%mm4\n\t" \ + "paddw %%mm2,%%mm2\n\t" \ + /*mm5=t1''=t1'+t2'*/ \ + "movq %%mm4,"_r0"(%[y])\n\t" \ + "paddw %%mm6,%%mm5\n\t" \ + /*mm2=t6''=t6'+t5'*/ \ + "paddw %%mm1,%%mm2\n\t" \ + "movq %%mm5,"_r4"(%[y])\n\t" \ + /*mm0=t7', mm1=t5'', mm2=t6'', mm3=t4'.*/ \ + /*mm4, mm5, mm6, mm7 are free.*/ \ + /*Stage 3:*/ \ + /*mm6={2}x4, mm7={27146,0xB500>>1}x2*/ \ + "mov $0x5A806A0A,%[a]\n\t" \ + "pcmpeqb %%mm6,%%mm6\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psrlw $15,%%mm6\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddw %%mm6,%%mm6\n\t" \ + /*mm0=0, m2={-1}x4 \ + mm5:mm4=t5''*27146+0xB500*/ \ + "movq %%mm1,%%mm4\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "movq %%mm2,"_r3"(%[y])\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "movq %%mm0,"_r7"(%[y])\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pcmpeqb %%mm2,%%mm2\n\t" \ + /*mm2=t6'', mm1=t5''+(t5''!=0) \ + mm4=(t5''*27146+0xB500>>16)*/ \ + "pcmpeqw %%mm1,%%mm0\n\t" \ + "psrad $16,%%mm4\n\t" \ + "psubw %%mm2,%%mm0\n\t" \ + "movq "_r3"(%[y]),%%mm2\n\t" \ + "psrad $16,%%mm5\n\t" \ + "paddw %%mm0,%%mm1\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + /*mm4=s=(t5''*27146+0xB500>>16)+t5''+(t5''!=0)>>1*/ \ + "paddw %%mm1,%%mm4\n\t" \ + "movq "_r7"(%[y]),%%mm0\n\t" \ + "psraw $1,%%mm4\n\t" \ + "movq %%mm3,%%mm1\n\t" \ + /*mm3=t4''=t4'+s*/ \ + "paddw %%mm4,%%mm3\n\t" \ + /*mm1=t5'''=t4'-s*/ \ + "psubw %%mm4,%%mm1\n\t" \ + /*mm1=0, mm3={-1}x4 \ + mm5:mm4=t6''*27146+0xB500*/ \ + "movq %%mm2,%%mm4\n\t" \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "movq %%mm1,"_r5"(%[y])\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "movq %%mm3,"_r1"(%[y])\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "pxor %%mm1,%%mm1\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pcmpeqb %%mm3,%%mm3\n\t" \ + /*mm2=t6''+(t6''!=0), mm4=(t6''*27146+0xB500>>16)*/ \ + "psrad $16,%%mm4\n\t" \ + "pcmpeqw %%mm2,%%mm1\n\t" \ + "psrad $16,%%mm5\n\t" \ + "psubw %%mm3,%%mm1\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "paddw %%mm1,%%mm2\n\t" \ + /*mm1=t1'' \ + mm4=s=(t6''*27146+0xB500>>16)+t6''+(t6''!=0)>>1*/ \ + "paddw %%mm2,%%mm4\n\t" \ + "movq "_r4"(%[y]),%%mm1\n\t" \ + "psraw $1,%%mm4\n\t" \ + "movq %%mm0,%%mm2\n\t" \ + /*mm7={54491-0x7FFF,0x7FFF}x2 \ + mm0=t7''=t7'+s*/ \ + "paddw %%mm4,%%mm0\n\t" \ + /*mm2=t6'''=t7'-s*/ \ + "psubw %%mm4,%%mm2\n\t" \ + /*Stage 4:*/ \ + /*mm0=0, mm2=t0'' \ + mm5:mm4=t1''*27146+0xB500*/ \ + "movq %%mm1,%%mm4\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "movq %%mm2,"_r3"(%[y])\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "movq "_r0"(%[y]),%%mm2\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "movq %%mm0,"_r7"(%[y])\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + /*mm7={27146,0x4000>>1}x2 \ + mm0=s=(t1''*27146+0xB500>>16)+t1''+(t1''!=0)*/ \ + "psrad $16,%%mm4\n\t" \ + "mov $0x20006A0A,%[a]\n\t" \ + "pcmpeqw %%mm1,%%mm0\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psrad $16,%%mm5\n\t" \ + "psubw %%mm3,%%mm0\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "paddw %%mm1,%%mm0\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddw %%mm4,%%mm0\n\t" \ + /*mm6={0x00000E3D}x2 \ + mm1=-(t0''==0), mm5:mm4=t0''*27146+0x4000*/ \ + "movq %%mm2,%%mm4\n\t" \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "mov $0x0E3D,%[a]\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "movd %[a],%%mm6\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pxor %%mm1,%%mm1\n\t" \ + "punpckldq %%mm6,%%mm6\n\t" \ + "pcmpeqw %%mm2,%%mm1\n\t" \ + /*mm4=r=(t0''*27146+0x4000>>16)+t0''+(t0''!=0)*/ \ + "psrad $16,%%mm4\n\t" \ + "psubw %%mm3,%%mm1\n\t" \ + "psrad $16,%%mm5\n\t" \ + "paddw %%mm1,%%mm2\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "movq "_r5"(%[y]),%%mm1\n\t" \ + "paddw %%mm2,%%mm4\n\t" \ + /*mm2=t6'', mm0=_y[0]=u=r+s>>1 \ + The naive implementation could cause overflow, so we use \ + u=(r&s)+((r^s)>>1).*/ \ + "movq "_r3"(%[y]),%%mm2\n\t" \ + "movq %%mm0,%%mm7\n\t" \ + "pxor %%mm4,%%mm0\n\t" \ + "pand %%mm4,%%mm7\n\t" \ + "psraw $1,%%mm0\n\t" \ + "mov $0x7FFF54DC,%[a]\n\t" \ + "paddw %%mm7,%%mm0\n\t" \ + "movd %[a],%%mm7\n\t" \ + /*mm7={54491-0x7FFF,0x7FFF}x2 \ + mm4=_y[4]=v=r-u*/ \ + "psubw %%mm0,%%mm4\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "movq %%mm4,"_r4"(%[y])\n\t" \ + /*mm0=0, mm7={36410}x4 \ + mm1=(t5'''!=0), mm5:mm4=54491*t5'''+0x0E3D*/ \ + "movq %%mm1,%%mm4\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "punpcklwd %%mm1,%%mm4\n\t" \ + "mov $0x8E3A8E3A,%[a]\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "movq %%mm0,"_r0"(%[y])\n\t" \ + "punpckhwd %%mm1,%%mm5\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pcmpeqw %%mm0,%%mm1\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psubw %%mm3,%%mm1\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddd %%mm6,%%mm4\n\t" \ + "paddd %%mm6,%%mm5\n\t" \ + /*mm0=0 \ + mm3:mm1=36410*t6'''+((t5'''!=0)<<16)*/ \ + "movq %%mm2,%%mm6\n\t" \ + "movq %%mm2,%%mm3\n\t" \ + "pmulhw %%mm7,%%mm6\n\t" \ + "paddw %%mm2,%%mm1\n\t" \ + "pmullw %%mm7,%%mm3\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + "paddw %%mm1,%%mm6\n\t" \ + "movq %%mm3,%%mm1\n\t" \ + "punpckhwd %%mm6,%%mm3\n\t" \ + "punpcklwd %%mm6,%%mm1\n\t" \ + /*mm3={-1}x4, mm6={1}x4 \ + mm4=_y[5]=u=(54491*t5'''+36410*t6'''+0x0E3D>>16)+(t5'''!=0)*/ \ + "paddd %%mm3,%%mm5\n\t" \ + "paddd %%mm1,%%mm4\n\t" \ + "psrad $16,%%mm5\n\t" \ + "pxor %%mm6,%%mm6\n\t" \ + "psrad $16,%%mm4\n\t" \ + "pcmpeqb %%mm3,%%mm3\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "psubw %%mm3,%%mm6\n\t" \ + /*mm1=t7'', mm7={26568,0x3400}x2 \ + mm2=s=t6'''-(36410*u>>16)*/ \ + "movq %%mm4,%%mm1\n\t" \ + "mov $0x340067C8,%[a]\n\t" \ + "pmulhw %%mm7,%%mm4\n\t" \ + "movd %[a],%%mm7\n\t" \ + "movq %%mm1,"_r5"(%[y])\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddw %%mm1,%%mm4\n\t" \ + "movq "_r7"(%[y]),%%mm1\n\t" \ + "psubw %%mm4,%%mm2\n\t" \ + /*mm6={0x00007B1B}x2 \ + mm0=(s!=0), mm5:mm4=s*26568+0x3400*/ \ + "movq %%mm2,%%mm4\n\t" \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "pcmpeqw %%mm2,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "mov $0x7B1B,%[a]\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "movd %[a],%%mm6\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "psubw %%mm3,%%mm0\n\t" \ + "punpckldq %%mm6,%%mm6\n\t" \ + /*mm7={64277-0x7FFF,0x7FFF}x2 \ + mm2=_y[3]=v=(s*26568+0x3400>>17)+s+(s!=0)*/ \ + "psrad $17,%%mm4\n\t" \ + "paddw %%mm0,%%mm2\n\t" \ + "psrad $17,%%mm5\n\t" \ + "mov $0x7FFF7B16,%[a]\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "movd %[a],%%mm7\n\t" \ + "paddw %%mm4,%%mm2\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + /*mm0=0, mm7={12785}x4 \ + mm1=(t7''!=0), mm2=t4'', mm5:mm4=64277*t7''+0x7B1B*/ \ + "movq %%mm1,%%mm4\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "movq %%mm2,"_r3"(%[y])\n\t" \ + "punpcklwd %%mm1,%%mm4\n\t" \ + "movq "_r1"(%[y]),%%mm2\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "mov $0x31F131F1,%[a]\n\t" \ + "punpckhwd %%mm1,%%mm5\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "pcmpeqw %%mm0,%%mm1\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psubw %%mm3,%%mm1\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddd %%mm6,%%mm4\n\t" \ + "paddd %%mm6,%%mm5\n\t" \ + /*mm3:mm1=12785*t4'''+((t7''!=0)<<16)*/ \ + "movq %%mm2,%%mm6\n\t" \ + "movq %%mm2,%%mm3\n\t" \ + "pmulhw %%mm7,%%mm6\n\t" \ + "pmullw %%mm7,%%mm3\n\t" \ + "paddw %%mm1,%%mm6\n\t" \ + "movq %%mm3,%%mm1\n\t" \ + "punpckhwd %%mm6,%%mm3\n\t" \ + "punpcklwd %%mm6,%%mm1\n\t" \ + /*mm3={-1}x4, mm6={1}x4 \ + mm4=_y[1]=u=(12785*t4'''+64277*t7''+0x7B1B>>16)+(t7''!=0)*/ \ + "paddd %%mm3,%%mm5\n\t" \ + "paddd %%mm1,%%mm4\n\t" \ + "psrad $16,%%mm5\n\t" \ + "pxor %%mm6,%%mm6\n\t" \ + "psrad $16,%%mm4\n\t" \ + "pcmpeqb %%mm3,%%mm3\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "psubw %%mm3,%%mm6\n\t" \ + /*mm1=t3'', mm7={20539,0x3000}x2 \ + mm4=s=(12785*u>>16)-t4''*/ \ + "movq %%mm4,"_r1"(%[y])\n\t" \ + "pmulhw %%mm7,%%mm4\n\t" \ + "mov $0x3000503B,%[a]\n\t" \ + "movq "_r6"(%[y]),%%mm1\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psubw %%mm2,%%mm4\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + /*mm6={0x00006CB7}x2 \ + mm0=(s!=0), mm5:mm4=s*20539+0x3000*/ \ + "movq %%mm4,%%mm5\n\t" \ + "movq %%mm4,%%mm2\n\t" \ + "punpcklwd %%mm6,%%mm4\n\t" \ + "pcmpeqw %%mm2,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "mov $0x6CB7,%[a]\n\t" \ + "punpckhwd %%mm6,%%mm5\n\t" \ + "movd %[a],%%mm6\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "psubw %%mm3,%%mm0\n\t" \ + "punpckldq %%mm6,%%mm6\n\t" \ + /*mm7={60547-0x7FFF,0x7FFF}x2 \ + mm2=_y[7]=v=(s*20539+0x3000>>20)+s+(s!=0)*/ \ + "psrad $20,%%mm4\n\t" \ + "paddw %%mm0,%%mm2\n\t" \ + "psrad $20,%%mm5\n\t" \ + "mov $0x7FFF6C84,%[a]\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + "movd %[a],%%mm7\n\t" \ + "paddw %%mm4,%%mm2\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + /*mm0=0, mm7={25080}x4 \ + mm2=t2'', mm5:mm4=60547*t3''+0x6CB7*/ \ + "movq %%mm1,%%mm4\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "movq %%mm2,"_r7"(%[y])\n\t" \ + "punpcklwd %%mm1,%%mm4\n\t" \ + "movq "_r2"(%[y]),%%mm2\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "mov $0x61F861F8,%[a]\n\t" \ + "punpckhwd %%mm1,%%mm5\n\t" \ + "pxor %%mm0,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm5\n\t" \ + "movd %[a],%%mm7\n\t" \ + "pcmpeqw %%mm0,%%mm1\n\t" \ + "psubw %%mm3,%%mm1\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "paddd %%mm6,%%mm4\n\t" \ + "paddd %%mm6,%%mm5\n\t" \ + /*mm3:mm1=25080*t2''+((t3''!=0)<<16)*/ \ + "movq %%mm2,%%mm6\n\t" \ + "movq %%mm2,%%mm3\n\t" \ + "pmulhw %%mm7,%%mm6\n\t" \ + "pmullw %%mm7,%%mm3\n\t" \ + "paddw %%mm1,%%mm6\n\t" \ + "movq %%mm3,%%mm1\n\t" \ + "punpckhwd %%mm6,%%mm3\n\t" \ + "punpcklwd %%mm6,%%mm1\n\t" \ + /*mm1={-1}x4 \ + mm4=u=(25080*t2''+60547*t3''+0x6CB7>>16)+(t3''!=0)*/ \ + "paddd %%mm3,%%mm5\n\t" \ + "paddd %%mm1,%%mm4\n\t" \ + "psrad $16,%%mm5\n\t" \ + "mov $0x28005460,%[a]\n\t" \ + "psrad $16,%%mm4\n\t" \ + "pcmpeqb %%mm1,%%mm1\n\t" \ + "packssdw %%mm5,%%mm4\n\t" \ + /*mm5={1}x4, mm6=_y[2]=u, mm7={21600,0x2800}x2 \ + mm4=s=(25080*u>>16)-t2''*/ \ + "movq %%mm4,%%mm6\n\t" \ + "pmulhw %%mm7,%%mm4\n\t" \ + "pxor %%mm5,%%mm5\n\t" \ + "movd %[a],%%mm7\n\t" \ + "psubw %%mm1,%%mm5\n\t" \ + "punpckldq %%mm7,%%mm7\n\t" \ + "psubw %%mm2,%%mm4\n\t" \ + /*mm2=s+(s!=0) \ + mm4:mm3=s*21600+0x2800*/ \ + "movq %%mm4,%%mm3\n\t" \ + "movq %%mm4,%%mm2\n\t" \ + "punpckhwd %%mm5,%%mm4\n\t" \ + "pcmpeqw %%mm2,%%mm0\n\t" \ + "pmaddwd %%mm7,%%mm4\n\t" \ + "psubw %%mm1,%%mm0\n\t" \ + "punpcklwd %%mm5,%%mm3\n\t" \ + "paddw %%mm0,%%mm2\n\t" \ + "pmaddwd %%mm7,%%mm3\n\t" \ + /*mm0=_y[4], mm1=_y[7], mm4=_y[0], mm5=_y[5] \ + mm3=_y[6]=v=(s*21600+0x2800>>18)+s+(s!=0)*/ \ + "movq "_r4"(%[y]),%%mm0\n\t" \ + "psrad $18,%%mm4\n\t" \ + "movq "_r5"(%[y]),%%mm5\n\t" \ + "psrad $18,%%mm3\n\t" \ + "movq "_r7"(%[y]),%%mm1\n\t" \ + "packssdw %%mm4,%%mm3\n\t" \ + "movq "_r0"(%[y]),%%mm4\n\t" \ + "paddw %%mm2,%%mm3\n\t" \ + +/*On input, mm4=_y[0], mm6=_y[2], mm0=_y[4], mm5=_y[5], mm3=_y[6], mm1=_y[7]. + On output, {_y[4],mm1,mm2,mm3} contains the transpose of _y[4...7] and + {mm4,mm5,mm6,mm7} contains the transpose of _y[0...3].*/ +# define OC_TRANSPOSE8x4(_r0,_r1,_r2,_r3,_r4,_r5,_r6,_r7) \ + "#OC_TRANSPOSE8x4\n\t" \ + /*First 4x4 transpose:*/ \ + /*mm0 = e3 e2 e1 e0 \ + mm5 = f3 f2 f1 f0 \ + mm3 = g3 g2 g1 g0 \ + mm1 = h3 h2 h1 h0*/ \ + "movq %%mm0,%%mm2\n\t" \ + "punpcklwd %%mm5,%%mm0\n\t" \ + "punpckhwd %%mm5,%%mm2\n\t" \ + "movq %%mm3,%%mm5\n\t" \ + "punpcklwd %%mm1,%%mm3\n\t" \ + "punpckhwd %%mm1,%%mm5\n\t" \ + /*mm0 = f1 e1 f0 e0 \ + mm2 = f3 e3 f2 e2 \ + mm3 = h1 g1 h0 g0 \ + mm5 = h3 g3 h2 g2*/ \ + "movq %%mm0,%%mm1\n\t" \ + "punpckldq %%mm3,%%mm0\n\t" \ + "movq %%mm0,"_r4"(%[y])\n\t" \ + "punpckhdq %%mm3,%%mm1\n\t" \ + "movq "_r1"(%[y]),%%mm0\n\t" \ + "movq %%mm2,%%mm3\n\t" \ + "punpckldq %%mm5,%%mm2\n\t" \ + "punpckhdq %%mm5,%%mm3\n\t" \ + "movq "_r3"(%[y]),%%mm5\n\t" \ + /*_y[4] = h0 g0 f0 e0 \ + mm1 = h1 g1 f1 e1 \ + mm2 = h2 g2 f2 e2 \ + mm3 = h3 g3 f3 e3*/ \ + /*Second 4x4 transpose:*/ \ + /*mm4 = a3 a2 a1 a0 \ + mm0 = b3 b2 b1 b0 \ + mm6 = c3 c2 c1 c0 \ + mm5 = d3 d2 d1 d0*/ \ + "movq %%mm4,%%mm7\n\t" \ + "punpcklwd %%mm0,%%mm4\n\t" \ + "punpckhwd %%mm0,%%mm7\n\t" \ + "movq %%mm6,%%mm0\n\t" \ + "punpcklwd %%mm5,%%mm6\n\t" \ + "punpckhwd %%mm5,%%mm0\n\t" \ + /*mm4 = b1 a1 b0 a0 \ + mm7 = b3 a3 b2 a2 \ + mm6 = d1 c1 d0 c0 \ + mm0 = d3 c3 d2 c2*/ \ + "movq %%mm4,%%mm5\n\t" \ + "punpckldq %%mm6,%%mm4\n\t" \ + "punpckhdq %%mm6,%%mm5\n\t" \ + "movq %%mm7,%%mm6\n\t" \ + "punpckhdq %%mm0,%%mm7\n\t" \ + "punpckldq %%mm0,%%mm6\n\t" \ + /*mm4 = d0 c0 b0 a0 \ + mm5 = d1 c1 b1 a1 \ + mm6 = d2 c2 b2 a2 \ + mm7 = d3 c3 b3 a3*/ \ + +/*MMX implementation of the fDCT.*/ +void oc_enc_fdct8x8_mmx(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + ptrdiff_t a; + __asm__ __volatile__( + /*Add two extra bits of working precision to improve accuracy; any more and + we could overflow.*/ + /*We also add biases to correct for some systematic error that remains in + the full fDCT->iDCT round trip.*/ + "movq 0x00(%[x]),%%mm0\n\t" + "movq 0x10(%[x]),%%mm1\n\t" + "movq 0x20(%[x]),%%mm2\n\t" + "movq 0x30(%[x]),%%mm3\n\t" + "pcmpeqb %%mm4,%%mm4\n\t" + "pxor %%mm7,%%mm7\n\t" + "movq %%mm0,%%mm5\n\t" + "psllw $2,%%mm0\n\t" + "pcmpeqw %%mm7,%%mm5\n\t" + "movq 0x70(%[x]),%%mm7\n\t" + "psllw $2,%%mm1\n\t" + "psubw %%mm4,%%mm5\n\t" + "psllw $2,%%mm2\n\t" + "mov $1,%[a]\n\t" + "pslld $16,%%mm5\n\t" + "movd %[a],%%mm6\n\t" + "psllq $16,%%mm5\n\t" + "mov $0x10001,%[a]\n\t" + "psllw $2,%%mm3\n\t" + "movd %[a],%%mm4\n\t" + "punpckhwd %%mm6,%%mm5\n\t" + "psubw %%mm6,%%mm1\n\t" + "movq 0x60(%[x]),%%mm6\n\t" + "paddw %%mm5,%%mm0\n\t" + "movq 0x50(%[x]),%%mm5\n\t" + "paddw %%mm4,%%mm0\n\t" + "movq 0x40(%[x]),%%mm4\n\t" + /*We inline stage1 of the transform here so we can get better instruction + scheduling with the shifts.*/ + /*mm0=t7'=t0-t7*/ + "psllw $2,%%mm7\n\t" + "psubw %%mm7,%%mm0\n\t" + "psllw $2,%%mm6\n\t" + "paddw %%mm7,%%mm7\n\t" + /*mm1=t6'=t1-t6*/ + "psllw $2,%%mm5\n\t" + "psubw %%mm6,%%mm1\n\t" + "psllw $2,%%mm4\n\t" + "paddw %%mm6,%%mm6\n\t" + /*mm2=t5'=t2-t5*/ + "psubw %%mm5,%%mm2\n\t" + "paddw %%mm5,%%mm5\n\t" + /*mm3=t4'=t3-t4*/ + "psubw %%mm4,%%mm3\n\t" + "paddw %%mm4,%%mm4\n\t" + /*mm7=t0'=t0+t7*/ + "paddw %%mm0,%%mm7\n\t" + /*mm6=t1'=t1+t6*/ + "paddw %%mm1,%%mm6\n\t" + /*mm5=t2'=t2+t5*/ + "paddw %%mm2,%%mm5\n\t" + /*mm4=t3'=t3+t4*/ + "paddw %%mm3,%%mm4\n\t" + OC_FDCT8x4("0x00","0x10","0x20","0x30","0x40","0x50","0x60","0x70") + OC_TRANSPOSE8x4("0x00","0x10","0x20","0x30","0x40","0x50","0x60","0x70") + /*Swap out this 8x4 block for the next one.*/ + "movq 0x08(%[x]),%%mm0\n\t" + "movq %%mm7,0x30(%[y])\n\t" + "movq 0x78(%[x]),%%mm7\n\t" + "movq %%mm1,0x50(%[y])\n\t" + "movq 0x18(%[x]),%%mm1\n\t" + "movq %%mm6,0x20(%[y])\n\t" + "movq 0x68(%[x]),%%mm6\n\t" + "movq %%mm2,0x60(%[y])\n\t" + "movq 0x28(%[x]),%%mm2\n\t" + "movq %%mm5,0x10(%[y])\n\t" + "movq 0x58(%[x]),%%mm5\n\t" + "movq %%mm3,0x70(%[y])\n\t" + "movq 0x38(%[x]),%%mm3\n\t" + /*And increase its working precision, too.*/ + "psllw $2,%%mm0\n\t" + "movq %%mm4,0x00(%[y])\n\t" + "psllw $2,%%mm7\n\t" + "movq 0x48(%[x]),%%mm4\n\t" + /*We inline stage1 of the transform here so we can get better instruction + scheduling with the shifts.*/ + /*mm0=t7'=t0-t7*/ + "psubw %%mm7,%%mm0\n\t" + "psllw $2,%%mm1\n\t" + "paddw %%mm7,%%mm7\n\t" + "psllw $2,%%mm6\n\t" + /*mm1=t6'=t1-t6*/ + "psubw %%mm6,%%mm1\n\t" + "psllw $2,%%mm2\n\t" + "paddw %%mm6,%%mm6\n\t" + "psllw $2,%%mm5\n\t" + /*mm2=t5'=t2-t5*/ + "psubw %%mm5,%%mm2\n\t" + "psllw $2,%%mm3\n\t" + "paddw %%mm5,%%mm5\n\t" + "psllw $2,%%mm4\n\t" + /*mm3=t4'=t3-t4*/ + "psubw %%mm4,%%mm3\n\t" + "paddw %%mm4,%%mm4\n\t" + /*mm7=t0'=t0+t7*/ + "paddw %%mm0,%%mm7\n\t" + /*mm6=t1'=t1+t6*/ + "paddw %%mm1,%%mm6\n\t" + /*mm5=t2'=t2+t5*/ + "paddw %%mm2,%%mm5\n\t" + /*mm4=t3'=t3+t4*/ + "paddw %%mm3,%%mm4\n\t" + OC_FDCT8x4("0x08","0x18","0x28","0x38","0x48","0x58","0x68","0x78") + OC_TRANSPOSE8x4("0x08","0x18","0x28","0x38","0x48","0x58","0x68","0x78") + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, + so we only have to do half the stores and loads.*/ + "movq 0x00(%[y]),%%mm0\n\t" + "movq %%mm1,0x58(%[y])\n\t" + "movq 0x10(%[y]),%%mm1\n\t" + "movq %%mm2,0x68(%[y])\n\t" + "movq 0x20(%[y]),%%mm2\n\t" + "movq %%mm3,0x78(%[y])\n\t" + "movq 0x30(%[y]),%%mm3\n\t" + OC_FDCT_STAGE1_8x4 + OC_FDCT8x4("0x00","0x10","0x20","0x30","0x08","0x18","0x28","0x38") + OC_TRANSPOSE8x4("0x00","0x10","0x20","0x30","0x08","0x18","0x28","0x38") + /*mm0={-2}x4*/ + "pcmpeqw %%mm0,%%mm0\n\t" + "paddw %%mm0,%%mm0\n\t" + /*Round the results.*/ + "psubw %%mm0,%%mm1\n\t" + "psubw %%mm0,%%mm2\n\t" + "psraw $2,%%mm1\n\t" + "psubw %%mm0,%%mm3\n\t" + "movq %%mm1,0x18(%[y])\n\t" + "psraw $2,%%mm2\n\t" + "psubw %%mm0,%%mm4\n\t" + "movq 0x08(%[y]),%%mm1\n\t" + "psraw $2,%%mm3\n\t" + "psubw %%mm0,%%mm5\n\t" + "psraw $2,%%mm4\n\t" + "psubw %%mm0,%%mm6\n\t" + "psraw $2,%%mm5\n\t" + "psubw %%mm0,%%mm7\n\t" + "psraw $2,%%mm6\n\t" + "psubw %%mm0,%%mm1\n\t" + "psraw $2,%%mm7\n\t" + "movq 0x40(%[y]),%%mm0\n\t" + "psraw $2,%%mm1\n\t" + "movq %%mm7,0x30(%[y])\n\t" + "movq 0x78(%[y]),%%mm7\n\t" + "movq %%mm1,0x08(%[y])\n\t" + "movq 0x50(%[y]),%%mm1\n\t" + "movq %%mm6,0x20(%[y])\n\t" + "movq 0x68(%[y]),%%mm6\n\t" + "movq %%mm2,0x28(%[y])\n\t" + "movq 0x60(%[y]),%%mm2\n\t" + "movq %%mm5,0x10(%[y])\n\t" + "movq 0x58(%[y]),%%mm5\n\t" + "movq %%mm3,0x38(%[y])\n\t" + "movq 0x70(%[y]),%%mm3\n\t" + "movq %%mm4,0x00(%[y])\n\t" + "movq 0x48(%[y]),%%mm4\n\t" + OC_FDCT_STAGE1_8x4 + OC_FDCT8x4("0x40","0x50","0x60","0x70","0x48","0x58","0x68","0x78") + OC_TRANSPOSE8x4("0x40","0x50","0x60","0x70","0x48","0x58","0x68","0x78") + /*mm0={-2}x4*/ + "pcmpeqw %%mm0,%%mm0\n\t" + "paddw %%mm0,%%mm0\n\t" + /*Round the results.*/ + "psubw %%mm0,%%mm1\n\t" + "psubw %%mm0,%%mm2\n\t" + "psraw $2,%%mm1\n\t" + "psubw %%mm0,%%mm3\n\t" + "movq %%mm1,0x58(%[y])\n\t" + "psraw $2,%%mm2\n\t" + "psubw %%mm0,%%mm4\n\t" + "movq 0x48(%[y]),%%mm1\n\t" + "psraw $2,%%mm3\n\t" + "psubw %%mm0,%%mm5\n\t" + "movq %%mm2,0x68(%[y])\n\t" + "psraw $2,%%mm4\n\t" + "psubw %%mm0,%%mm6\n\t" + "movq %%mm3,0x78(%[y])\n\t" + "psraw $2,%%mm5\n\t" + "psubw %%mm0,%%mm7\n\t" + "movq %%mm4,0x40(%[y])\n\t" + "psraw $2,%%mm6\n\t" + "psubw %%mm0,%%mm1\n\t" + "movq %%mm5,0x50(%[y])\n\t" + "psraw $2,%%mm7\n\t" + "movq %%mm6,0x60(%[y])\n\t" + "psraw $2,%%mm1\n\t" + "movq %%mm7,0x70(%[y])\n\t" + "movq %%mm1,0x48(%[y])\n\t" + :[a]"=&r"(a) + :[y]"r"(_y),[x]"r"(_x) + :"memory" + ); +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxfrag.c b/libs/libtheora-1.1/lib/x86/mmxfrag.c new file mode 100644 index 00000000..2792cd41 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxfrag.c @@ -0,0 +1,293 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxfrag.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*MMX acceleration of fragment reconstruction for motion compensation. + Originally written by Rudolf Marek. + Additional optimization by Nils Pipenbrinck. + Note: Loops are unrolled for best performance. + The iteration each instruction belongs to is marked in the comments as #i.*/ +#include +#include "x86int.h" +#include "mmxfrag.h" + +#if defined(OC_X86_ASM) + +/*Copies an 8x8 block of pixels from _src to _dst, assuming _ystride bytes + between rows.*/ +void oc_frag_copy_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride){ + OC_FRAG_COPY_MMX(_dst,_src,_ystride); +} + +void oc_frag_recon_intra_mmx(unsigned char *_dst,int _ystride, + const ogg_int16_t *_residue){ + __asm__ __volatile__( + /*Set mm0 to 0xFFFFFFFFFFFFFFFF.*/ + "pcmpeqw %%mm0,%%mm0\n\t" + /*#0 Load low residue.*/ + "movq 0*8(%[residue]),%%mm1\n\t" + /*#0 Load high residue.*/ + "movq 1*8(%[residue]),%%mm2\n\t" + /*Set mm0 to 0x8000800080008000.*/ + "psllw $15,%%mm0\n\t" + /*#1 Load low residue.*/ + "movq 2*8(%[residue]),%%mm3\n\t" + /*#1 Load high residue.*/ + "movq 3*8(%[residue]),%%mm4\n\t" + /*Set mm0 to 0x0080008000800080.*/ + "psrlw $8,%%mm0\n\t" + /*#2 Load low residue.*/ + "movq 4*8(%[residue]),%%mm5\n\t" + /*#2 Load high residue.*/ + "movq 5*8(%[residue]),%%mm6\n\t" + /*#0 Bias low residue.*/ + "paddsw %%mm0,%%mm1\n\t" + /*#0 Bias high residue.*/ + "paddsw %%mm0,%%mm2\n\t" + /*#0 Pack to byte.*/ + "packuswb %%mm2,%%mm1\n\t" + /*#1 Bias low residue.*/ + "paddsw %%mm0,%%mm3\n\t" + /*#1 Bias high residue.*/ + "paddsw %%mm0,%%mm4\n\t" + /*#1 Pack to byte.*/ + "packuswb %%mm4,%%mm3\n\t" + /*#2 Bias low residue.*/ + "paddsw %%mm0,%%mm5\n\t" + /*#2 Bias high residue.*/ + "paddsw %%mm0,%%mm6\n\t" + /*#2 Pack to byte.*/ + "packuswb %%mm6,%%mm5\n\t" + /*#0 Write row.*/ + "movq %%mm1,(%[dst])\n\t" + /*#1 Write row.*/ + "movq %%mm3,(%[dst],%[ystride])\n\t" + /*#2 Write row.*/ + "movq %%mm5,(%[dst],%[ystride],2)\n\t" + /*#3 Load low residue.*/ + "movq 6*8(%[residue]),%%mm1\n\t" + /*#3 Load high residue.*/ + "movq 7*8(%[residue]),%%mm2\n\t" + /*#4 Load high residue.*/ + "movq 8*8(%[residue]),%%mm3\n\t" + /*#4 Load high residue.*/ + "movq 9*8(%[residue]),%%mm4\n\t" + /*#5 Load high residue.*/ + "movq 10*8(%[residue]),%%mm5\n\t" + /*#5 Load high residue.*/ + "movq 11*8(%[residue]),%%mm6\n\t" + /*#3 Bias low residue.*/ + "paddsw %%mm0,%%mm1\n\t" + /*#3 Bias high residue.*/ + "paddsw %%mm0,%%mm2\n\t" + /*#3 Pack to byte.*/ + "packuswb %%mm2,%%mm1\n\t" + /*#4 Bias low residue.*/ + "paddsw %%mm0,%%mm3\n\t" + /*#4 Bias high residue.*/ + "paddsw %%mm0,%%mm4\n\t" + /*#4 Pack to byte.*/ + "packuswb %%mm4,%%mm3\n\t" + /*#5 Bias low residue.*/ + "paddsw %%mm0,%%mm5\n\t" + /*#5 Bias high residue.*/ + "paddsw %%mm0,%%mm6\n\t" + /*#5 Pack to byte.*/ + "packuswb %%mm6,%%mm5\n\t" + /*#3 Write row.*/ + "movq %%mm1,(%[dst],%[ystride3])\n\t" + /*#4 Write row.*/ + "movq %%mm3,(%[dst4])\n\t" + /*#5 Write row.*/ + "movq %%mm5,(%[dst4],%[ystride])\n\t" + /*#6 Load low residue.*/ + "movq 12*8(%[residue]),%%mm1\n\t" + /*#6 Load high residue.*/ + "movq 13*8(%[residue]),%%mm2\n\t" + /*#7 Load low residue.*/ + "movq 14*8(%[residue]),%%mm3\n\t" + /*#7 Load high residue.*/ + "movq 15*8(%[residue]),%%mm4\n\t" + /*#6 Bias low residue.*/ + "paddsw %%mm0,%%mm1\n\t" + /*#6 Bias high residue.*/ + "paddsw %%mm0,%%mm2\n\t" + /*#6 Pack to byte.*/ + "packuswb %%mm2,%%mm1\n\t" + /*#7 Bias low residue.*/ + "paddsw %%mm0,%%mm3\n\t" + /*#7 Bias high residue.*/ + "paddsw %%mm0,%%mm4\n\t" + /*#7 Pack to byte.*/ + "packuswb %%mm4,%%mm3\n\t" + /*#6 Write row.*/ + "movq %%mm1,(%[dst4],%[ystride],2)\n\t" + /*#7 Write row.*/ + "movq %%mm3,(%[dst4],%[ystride3])\n\t" + : + :[residue]"r"(_residue), + [dst]"r"(_dst), + [dst4]"r"(_dst+(_ystride<<2)), + [ystride]"r"((ptrdiff_t)_ystride), + [ystride3]"r"((ptrdiff_t)_ystride*3) + :"memory" + ); +} + +void oc_frag_recon_inter_mmx(unsigned char *_dst,const unsigned char *_src, + int _ystride,const ogg_int16_t *_residue){ + int i; + /*Zero mm0.*/ + __asm__ __volatile__("pxor %%mm0,%%mm0\n\t"::); + for(i=4;i-->0;){ + __asm__ __volatile__( + /*#0 Load source.*/ + "movq (%[src]),%%mm3\n\t" + /*#1 Load source.*/ + "movq (%[src],%[ystride]),%%mm7\n\t" + /*#0 Get copy of src.*/ + "movq %%mm3,%%mm4\n\t" + /*#0 Expand high source.*/ + "punpckhbw %%mm0,%%mm4\n\t" + /*#0 Expand low source.*/ + "punpcklbw %%mm0,%%mm3\n\t" + /*#0 Add residue high.*/ + "paddsw 8(%[residue]),%%mm4\n\t" + /*#1 Get copy of src.*/ + "movq %%mm7,%%mm2\n\t" + /*#0 Add residue low.*/ + "paddsw (%[residue]), %%mm3\n\t" + /*#1 Expand high source.*/ + "punpckhbw %%mm0,%%mm2\n\t" + /*#0 Pack final row pixels.*/ + "packuswb %%mm4,%%mm3\n\t" + /*#1 Expand low source.*/ + "punpcklbw %%mm0,%%mm7\n\t" + /*#1 Add residue low.*/ + "paddsw 16(%[residue]),%%mm7\n\t" + /*#1 Add residue high.*/ + "paddsw 24(%[residue]),%%mm2\n\t" + /*Advance residue.*/ + "lea 32(%[residue]),%[residue]\n\t" + /*#1 Pack final row pixels.*/ + "packuswb %%mm2,%%mm7\n\t" + /*Advance src.*/ + "lea (%[src],%[ystride],2),%[src]\n\t" + /*#0 Write row.*/ + "movq %%mm3,(%[dst])\n\t" + /*#1 Write row.*/ + "movq %%mm7,(%[dst],%[ystride])\n\t" + /*Advance dst.*/ + "lea (%[dst],%[ystride],2),%[dst]\n\t" + :[residue]"+r"(_residue),[dst]"+r"(_dst),[src]"+r"(_src) + :[ystride]"r"((ptrdiff_t)_ystride) + :"memory" + ); + } +} + +void oc_frag_recon_inter2_mmx(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t *_residue){ + int i; + /*Zero mm7.*/ + __asm__ __volatile__("pxor %%mm7,%%mm7\n\t"::); + for(i=4;i-->0;){ + __asm__ __volatile__( + /*#0 Load src1.*/ + "movq (%[src1]),%%mm0\n\t" + /*#0 Load src2.*/ + "movq (%[src2]),%%mm2\n\t" + /*#0 Copy src1.*/ + "movq %%mm0,%%mm1\n\t" + /*#0 Copy src2.*/ + "movq %%mm2,%%mm3\n\t" + /*#1 Load src1.*/ + "movq (%[src1],%[ystride]),%%mm4\n\t" + /*#0 Unpack lower src1.*/ + "punpcklbw %%mm7,%%mm0\n\t" + /*#1 Load src2.*/ + "movq (%[src2],%[ystride]),%%mm5\n\t" + /*#0 Unpack higher src1.*/ + "punpckhbw %%mm7,%%mm1\n\t" + /*#0 Unpack lower src2.*/ + "punpcklbw %%mm7,%%mm2\n\t" + /*#0 Unpack higher src2.*/ + "punpckhbw %%mm7,%%mm3\n\t" + /*Advance src1 ptr.*/ + "lea (%[src1],%[ystride],2),%[src1]\n\t" + /*Advance src2 ptr.*/ + "lea (%[src2],%[ystride],2),%[src2]\n\t" + /*#0 Lower src1+src2.*/ + "paddsw %%mm2,%%mm0\n\t" + /*#0 Higher src1+src2.*/ + "paddsw %%mm3,%%mm1\n\t" + /*#1 Copy src1.*/ + "movq %%mm4,%%mm2\n\t" + /*#0 Build lo average.*/ + "psraw $1,%%mm0\n\t" + /*#1 Copy src2.*/ + "movq %%mm5,%%mm3\n\t" + /*#1 Unpack lower src1.*/ + "punpcklbw %%mm7,%%mm4\n\t" + /*#0 Build hi average.*/ + "psraw $1,%%mm1\n\t" + /*#1 Unpack higher src1.*/ + "punpckhbw %%mm7,%%mm2\n\t" + /*#0 low+=residue.*/ + "paddsw (%[residue]),%%mm0\n\t" + /*#1 Unpack lower src2.*/ + "punpcklbw %%mm7,%%mm5\n\t" + /*#0 high+=residue.*/ + "paddsw 8(%[residue]),%%mm1\n\t" + /*#1 Unpack higher src2.*/ + "punpckhbw %%mm7,%%mm3\n\t" + /*#1 Lower src1+src2.*/ + "paddsw %%mm4,%%mm5\n\t" + /*#0 Pack and saturate.*/ + "packuswb %%mm1,%%mm0\n\t" + /*#1 Higher src1+src2.*/ + "paddsw %%mm2,%%mm3\n\t" + /*#0 Write row.*/ + "movq %%mm0,(%[dst])\n\t" + /*#1 Build lo average.*/ + "psraw $1,%%mm5\n\t" + /*#1 Build hi average.*/ + "psraw $1,%%mm3\n\t" + /*#1 low+=residue.*/ + "paddsw 16(%[residue]),%%mm5\n\t" + /*#1 high+=residue.*/ + "paddsw 24(%[residue]),%%mm3\n\t" + /*#1 Pack and saturate.*/ + "packuswb %%mm3,%%mm5\n\t" + /*#1 Write row ptr.*/ + "movq %%mm5,(%[dst],%[ystride])\n\t" + /*Advance residue ptr.*/ + "add $32,%[residue]\n\t" + /*Advance dest ptr.*/ + "lea (%[dst],%[ystride],2),%[dst]\n\t" + :[dst]"+r"(_dst),[residue]"+r"(_residue), + [src1]"+%r"(_src1),[src2]"+r"(_src2) + :[ystride]"r"((ptrdiff_t)_ystride) + :"memory" + ); + } +} + +void oc_restore_fpu_mmx(void){ + __asm__ __volatile__("emms\n\t"); +} +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxfrag.h b/libs/libtheora-1.1/lib/x86/mmxfrag.h new file mode 100644 index 00000000..a3984276 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxfrag.h @@ -0,0 +1,64 @@ +#if !defined(_x86_mmxfrag_H) +# define _x86_mmxfrag_H (1) +# include +# include "x86int.h" + +#if defined(OC_X86_ASM) + +/*Copies an 8x8 block of pixels from _src to _dst, assuming _ystride bytes + between rows.*/ +#define OC_FRAG_COPY_MMX(_dst,_src,_ystride) \ + do{ \ + const unsigned char *src; \ + unsigned char *dst; \ + ptrdiff_t ystride3; \ + src=(_src); \ + dst=(_dst); \ + __asm__ __volatile__( \ + /*src+0*ystride*/ \ + "movq (%[src]),%%mm0\n\t" \ + /*src+1*ystride*/ \ + "movq (%[src],%[ystride]),%%mm1\n\t" \ + /*ystride3=ystride*3*/ \ + "lea (%[ystride],%[ystride],2),%[ystride3]\n\t" \ + /*src+2*ystride*/ \ + "movq (%[src],%[ystride],2),%%mm2\n\t" \ + /*src+3*ystride*/ \ + "movq (%[src],%[ystride3]),%%mm3\n\t" \ + /*dst+0*ystride*/ \ + "movq %%mm0,(%[dst])\n\t" \ + /*dst+1*ystride*/ \ + "movq %%mm1,(%[dst],%[ystride])\n\t" \ + /*Pointer to next 4.*/ \ + "lea (%[src],%[ystride],4),%[src]\n\t" \ + /*dst+2*ystride*/ \ + "movq %%mm2,(%[dst],%[ystride],2)\n\t" \ + /*dst+3*ystride*/ \ + "movq %%mm3,(%[dst],%[ystride3])\n\t" \ + /*Pointer to next 4.*/ \ + "lea (%[dst],%[ystride],4),%[dst]\n\t" \ + /*src+0*ystride*/ \ + "movq (%[src]),%%mm0\n\t" \ + /*src+1*ystride*/ \ + "movq (%[src],%[ystride]),%%mm1\n\t" \ + /*src+2*ystride*/ \ + "movq (%[src],%[ystride],2),%%mm2\n\t" \ + /*src+3*ystride*/ \ + "movq (%[src],%[ystride3]),%%mm3\n\t" \ + /*dst+0*ystride*/ \ + "movq %%mm0,(%[dst])\n\t" \ + /*dst+1*ystride*/ \ + "movq %%mm1,(%[dst],%[ystride])\n\t" \ + /*dst+2*ystride*/ \ + "movq %%mm2,(%[dst],%[ystride],2)\n\t" \ + /*dst+3*ystride*/ \ + "movq %%mm3,(%[dst],%[ystride3])\n\t" \ + :[dst]"+r"(dst),[src]"+r"(src),[ystride3]"=&r"(ystride3) \ + :[ystride]"r"((ptrdiff_t)(_ystride)) \ + :"memory" \ + ); \ + } \ + while(0) + +# endif +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxidct.c b/libs/libtheora-1.1/lib/x86/mmxidct.c new file mode 100644 index 00000000..e65561b7 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxidct.c @@ -0,0 +1,564 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxidct.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*MMX acceleration of Theora's iDCT. + Originally written by Rudolf Marek, based on code from On2's VP3.*/ +#include "x86int.h" +#include "../dct.h" + +#if defined(OC_X86_ASM) + +/*These are offsets into the table of constants below.*/ +/*7 rows of cosines, in order: pi/16 * (1 ... 7).*/ +#define OC_COSINE_OFFSET (0) +/*A row of 8's.*/ +#define OC_EIGHT_OFFSET (56) + + + +/*A table of constants used by the MMX routines.*/ +static const ogg_uint16_t __attribute__((aligned(8),used)) + OC_IDCT_CONSTS[(7+1)*4]={ + (ogg_uint16_t)OC_C1S7,(ogg_uint16_t)OC_C1S7, + (ogg_uint16_t)OC_C1S7,(ogg_uint16_t)OC_C1S7, + (ogg_uint16_t)OC_C2S6,(ogg_uint16_t)OC_C2S6, + (ogg_uint16_t)OC_C2S6,(ogg_uint16_t)OC_C2S6, + (ogg_uint16_t)OC_C3S5,(ogg_uint16_t)OC_C3S5, + (ogg_uint16_t)OC_C3S5,(ogg_uint16_t)OC_C3S5, + (ogg_uint16_t)OC_C4S4,(ogg_uint16_t)OC_C4S4, + (ogg_uint16_t)OC_C4S4,(ogg_uint16_t)OC_C4S4, + (ogg_uint16_t)OC_C5S3,(ogg_uint16_t)OC_C5S3, + (ogg_uint16_t)OC_C5S3,(ogg_uint16_t)OC_C5S3, + (ogg_uint16_t)OC_C6S2,(ogg_uint16_t)OC_C6S2, + (ogg_uint16_t)OC_C6S2,(ogg_uint16_t)OC_C6S2, + (ogg_uint16_t)OC_C7S1,(ogg_uint16_t)OC_C7S1, + (ogg_uint16_t)OC_C7S1,(ogg_uint16_t)OC_C7S1, + 8, 8, 8, 8 +}; + +/*Converts the expression in the argument to a string.*/ +#define OC_M2STR(_s) #_s + +/*38 cycles*/ +#define OC_IDCT_BEGIN \ + "#OC_IDCT_BEGIN\n\t" \ + "movq "OC_I(3)",%%mm2\n\t" \ + "movq "OC_C(3)",%%mm6\n\t" \ + "movq %%mm2,%%mm4\n\t" \ + "movq "OC_J(5)",%%mm7\n\t" \ + "pmulhw %%mm6,%%mm4\n\t" \ + "movq "OC_C(5)",%%mm1\n\t" \ + "pmulhw %%mm7,%%mm6\n\t" \ + "movq %%mm1,%%mm5\n\t" \ + "pmulhw %%mm2,%%mm1\n\t" \ + "movq "OC_I(1)",%%mm3\n\t" \ + "pmulhw %%mm7,%%mm5\n\t" \ + "movq "OC_C(1)",%%mm0\n\t" \ + "paddw %%mm2,%%mm4\n\t" \ + "paddw %%mm7,%%mm6\n\t" \ + "paddw %%mm1,%%mm2\n\t" \ + "movq "OC_J(7)",%%mm1\n\t" \ + "paddw %%mm5,%%mm7\n\t" \ + "movq %%mm0,%%mm5\n\t" \ + "pmulhw %%mm3,%%mm0\n\t" \ + "paddw %%mm7,%%mm4\n\t" \ + "pmulhw %%mm1,%%mm5\n\t" \ + "movq "OC_C(7)",%%mm7\n\t" \ + "psubw %%mm2,%%mm6\n\t" \ + "paddw %%mm3,%%mm0\n\t" \ + "pmulhw %%mm7,%%mm3\n\t" \ + "movq "OC_I(2)",%%mm2\n\t" \ + "pmulhw %%mm1,%%mm7\n\t" \ + "paddw %%mm1,%%mm5\n\t" \ + "movq %%mm2,%%mm1\n\t" \ + "pmulhw "OC_C(2)",%%mm2\n\t" \ + "psubw %%mm5,%%mm3\n\t" \ + "movq "OC_J(6)",%%mm5\n\t" \ + "paddw %%mm7,%%mm0\n\t" \ + "movq %%mm5,%%mm7\n\t" \ + "psubw %%mm4,%%mm0\n\t" \ + "pmulhw "OC_C(2)",%%mm5\n\t" \ + "paddw %%mm1,%%mm2\n\t" \ + "pmulhw "OC_C(6)",%%mm1\n\t" \ + "paddw %%mm4,%%mm4\n\t" \ + "paddw %%mm0,%%mm4\n\t" \ + "psubw %%mm6,%%mm3\n\t" \ + "paddw %%mm7,%%mm5\n\t" \ + "paddw %%mm6,%%mm6\n\t" \ + "pmulhw "OC_C(6)",%%mm7\n\t" \ + "paddw %%mm3,%%mm6\n\t" \ + "movq %%mm4,"OC_I(1)"\n\t" \ + "psubw %%mm5,%%mm1\n\t" \ + "movq "OC_C(4)",%%mm4\n\t" \ + "movq %%mm3,%%mm5\n\t" \ + "pmulhw %%mm4,%%mm3\n\t" \ + "paddw %%mm2,%%mm7\n\t" \ + "movq %%mm6,"OC_I(2)"\n\t" \ + "movq %%mm0,%%mm2\n\t" \ + "movq "OC_I(0)",%%mm6\n\t" \ + "pmulhw %%mm4,%%mm0\n\t" \ + "paddw %%mm3,%%mm5\n\t" \ + "movq "OC_J(4)",%%mm3\n\t" \ + "psubw %%mm1,%%mm5\n\t" \ + "paddw %%mm0,%%mm2\n\t" \ + "psubw %%mm3,%%mm6\n\t" \ + "movq %%mm6,%%mm0\n\t" \ + "pmulhw %%mm4,%%mm6\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + "paddw %%mm1,%%mm1\n\t" \ + "paddw %%mm0,%%mm3\n\t" \ + "paddw %%mm5,%%mm1\n\t" \ + "pmulhw %%mm3,%%mm4\n\t" \ + "paddw %%mm0,%%mm6\n\t" \ + "psubw %%mm2,%%mm6\n\t" \ + "paddw %%mm2,%%mm2\n\t" \ + "movq "OC_I(1)",%%mm0\n\t" \ + "paddw %%mm6,%%mm2\n\t" \ + "paddw %%mm3,%%mm4\n\t" \ + "psubw %%mm1,%%mm2\n\t" \ + "#end OC_IDCT_BEGIN\n\t" \ + +/*38+8=46 cycles.*/ +#define OC_ROW_IDCT \ + "#OC_ROW_IDCT\n" \ + OC_IDCT_BEGIN \ + /*r3=D'*/ \ + "movq "OC_I(2)",%%mm3\n\t" \ + /*r4=E'=E-G*/ \ + "psubw %%mm7,%%mm4\n\t" \ + /*r1=H'+H'*/ \ + "paddw %%mm1,%%mm1\n\t" \ + /*r7=G+G*/ \ + "paddw %%mm7,%%mm7\n\t" \ + /*r1=R1=A''+H'*/ \ + "paddw %%mm2,%%mm1\n\t" \ + /*r7=G'=E+G*/ \ + "paddw %%mm4,%%mm7\n\t" \ + /*r4=R4=E'-D'*/ \ + "psubw %%mm3,%%mm4\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + /*r6=R6=F'-B''*/ \ + "psubw %%mm5,%%mm6\n\t" \ + "paddw %%mm5,%%mm5\n\t" \ + /*r3=R3=E'+D'*/ \ + "paddw %%mm4,%%mm3\n\t" \ + /*r5=R5=F'+B''*/ \ + "paddw %%mm6,%%mm5\n\t" \ + /*r7=R7=G'-C'*/ \ + "psubw %%mm0,%%mm7\n\t" \ + "paddw %%mm0,%%mm0\n\t" \ + /*Save R1.*/ \ + "movq %%mm1,"OC_I(1)"\n\t" \ + /*r0=R0=G.+C.*/ \ + "paddw %%mm7,%%mm0\n\t" \ + "#end OC_ROW_IDCT\n\t" \ + +/*The following macro does two 4x4 transposes in place. + At entry, we assume: + r0 = a3 a2 a1 a0 + I(1) = b3 b2 b1 b0 + r2 = c3 c2 c1 c0 + r3 = d3 d2 d1 d0 + + r4 = e3 e2 e1 e0 + r5 = f3 f2 f1 f0 + r6 = g3 g2 g1 g0 + r7 = h3 h2 h1 h0 + + At exit, we have: + I(0) = d0 c0 b0 a0 + I(1) = d1 c1 b1 a1 + I(2) = d2 c2 b2 a2 + I(3) = d3 c3 b3 a3 + + J(4) = h0 g0 f0 e0 + J(5) = h1 g1 f1 e1 + J(6) = h2 g2 f2 e2 + J(7) = h3 g3 f3 e3 + + I(0) I(1) I(2) I(3) is the transpose of r0 I(1) r2 r3. + J(4) J(5) J(6) J(7) is the transpose of r4 r5 r6 r7. + + Since r1 is free at entry, we calculate the Js first.*/ +/*19 cycles.*/ +#define OC_TRANSPOSE \ + "#OC_TRANSPOSE\n\t" \ + "movq %%mm4,%%mm1\n\t" \ + "punpcklwd %%mm5,%%mm4\n\t" \ + "movq %%mm0,"OC_I(0)"\n\t" \ + "punpckhwd %%mm5,%%mm1\n\t" \ + "movq %%mm6,%%mm0\n\t" \ + "punpcklwd %%mm7,%%mm6\n\t" \ + "movq %%mm4,%%mm5\n\t" \ + "punpckldq %%mm6,%%mm4\n\t" \ + "punpckhdq %%mm6,%%mm5\n\t" \ + "movq %%mm1,%%mm6\n\t" \ + "movq %%mm4,"OC_J(4)"\n\t" \ + "punpckhwd %%mm7,%%mm0\n\t" \ + "movq %%mm5,"OC_J(5)"\n\t" \ + "punpckhdq %%mm0,%%mm6\n\t" \ + "movq "OC_I(0)",%%mm4\n\t" \ + "punpckldq %%mm0,%%mm1\n\t" \ + "movq "OC_I(1)",%%mm5\n\t" \ + "movq %%mm4,%%mm0\n\t" \ + "movq %%mm6,"OC_J(7)"\n\t" \ + "punpcklwd %%mm5,%%mm0\n\t" \ + "movq %%mm1,"OC_J(6)"\n\t" \ + "punpckhwd %%mm5,%%mm4\n\t" \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklwd %%mm3,%%mm2\n\t" \ + "movq %%mm0,%%mm1\n\t" \ + "punpckldq %%mm2,%%mm0\n\t" \ + "punpckhdq %%mm2,%%mm1\n\t" \ + "movq %%mm4,%%mm2\n\t" \ + "movq %%mm0,"OC_I(0)"\n\t" \ + "punpckhwd %%mm3,%%mm5\n\t" \ + "movq %%mm1,"OC_I(1)"\n\t" \ + "punpckhdq %%mm5,%%mm4\n\t" \ + "punpckldq %%mm5,%%mm2\n\t" \ + "movq %%mm4,"OC_I(3)"\n\t" \ + "movq %%mm2,"OC_I(2)"\n\t" \ + "#end OC_TRANSPOSE\n\t" \ + +/*38+19=57 cycles.*/ +#define OC_COLUMN_IDCT \ + "#OC_COLUMN_IDCT\n" \ + OC_IDCT_BEGIN \ + "paddw "OC_8",%%mm2\n\t" \ + /*r1=H'+H'*/ \ + "paddw %%mm1,%%mm1\n\t" \ + /*r1=R1=A''+H'*/ \ + "paddw %%mm2,%%mm1\n\t" \ + /*r2=NR2*/ \ + "psraw $4,%%mm2\n\t" \ + /*r4=E'=E-G*/ \ + "psubw %%mm7,%%mm4\n\t" \ + /*r1=NR1*/ \ + "psraw $4,%%mm1\n\t" \ + /*r3=D'*/ \ + "movq "OC_I(2)",%%mm3\n\t" \ + /*r7=G+G*/ \ + "paddw %%mm7,%%mm7\n\t" \ + /*Store NR2 at I(2).*/ \ + "movq %%mm2,"OC_I(2)"\n\t" \ + /*r7=G'=E+G*/ \ + "paddw %%mm4,%%mm7\n\t" \ + /*Store NR1 at I(1).*/ \ + "movq %%mm1,"OC_I(1)"\n\t" \ + /*r4=R4=E'-D'*/ \ + "psubw %%mm3,%%mm4\n\t" \ + "paddw "OC_8",%%mm4\n\t" \ + /*r3=D'+D'*/ \ + "paddw %%mm3,%%mm3\n\t" \ + /*r3=R3=E'+D'*/ \ + "paddw %%mm4,%%mm3\n\t" \ + /*r4=NR4*/ \ + "psraw $4,%%mm4\n\t" \ + /*r6=R6=F'-B''*/ \ + "psubw %%mm5,%%mm6\n\t" \ + /*r3=NR3*/ \ + "psraw $4,%%mm3\n\t" \ + "paddw "OC_8",%%mm6\n\t" \ + /*r5=B''+B''*/ \ + "paddw %%mm5,%%mm5\n\t" \ + /*r5=R5=F'+B''*/ \ + "paddw %%mm6,%%mm5\n\t" \ + /*r6=NR6*/ \ + "psraw $4,%%mm6\n\t" \ + /*Store NR4 at J(4).*/ \ + "movq %%mm4,"OC_J(4)"\n\t" \ + /*r5=NR5*/ \ + "psraw $4,%%mm5\n\t" \ + /*Store NR3 at I(3).*/ \ + "movq %%mm3,"OC_I(3)"\n\t" \ + /*r7=R7=G'-C'*/ \ + "psubw %%mm0,%%mm7\n\t" \ + "paddw "OC_8",%%mm7\n\t" \ + /*r0=C'+C'*/ \ + "paddw %%mm0,%%mm0\n\t" \ + /*r0=R0=G'+C'*/ \ + "paddw %%mm7,%%mm0\n\t" \ + /*r7=NR7*/ \ + "psraw $4,%%mm7\n\t" \ + /*Store NR6 at J(6).*/ \ + "movq %%mm6,"OC_J(6)"\n\t" \ + /*r0=NR0*/ \ + "psraw $4,%%mm0\n\t" \ + /*Store NR5 at J(5).*/ \ + "movq %%mm5,"OC_J(5)"\n\t" \ + /*Store NR7 at J(7).*/ \ + "movq %%mm7,"OC_J(7)"\n\t" \ + /*Store NR0 at I(0).*/ \ + "movq %%mm0,"OC_I(0)"\n\t" \ + "#end OC_COLUMN_IDCT\n\t" \ + +#define OC_MID(_m,_i) OC_M2STR(_m+(_i)*8)"(%[c])" +#define OC_C(_i) OC_MID(OC_COSINE_OFFSET,_i-1) +#define OC_8 OC_MID(OC_EIGHT_OFFSET,0) + +static void oc_idct8x8_slow(ogg_int16_t _y[64]){ + /*This routine accepts an 8x8 matrix, but in partially transposed form. + Every 4x4 block is transposed.*/ + __asm__ __volatile__( +#define OC_I(_k) OC_M2STR((_k*16))"(%[y])" +#define OC_J(_k) OC_M2STR(((_k-4)*16)+8)"(%[y])" + OC_ROW_IDCT + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) OC_M2STR((_k*16)+64)"(%[y])" +#define OC_J(_k) OC_M2STR(((_k-4)*16)+72)"(%[y])" + OC_ROW_IDCT + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) OC_M2STR((_k*16))"(%[y])" +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT +#undef OC_I +#undef OC_J +#define OC_I(_k) OC_M2STR((_k*16)+8)"(%[y])" +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT +#undef OC_I +#undef OC_J + : + :[y]"r"(_y),[c]"r"(OC_IDCT_CONSTS) + ); +} + +/*25 cycles.*/ +#define OC_IDCT_BEGIN_10 \ + "#OC_IDCT_BEGIN_10\n\t" \ + "movq "OC_I(3)",%%mm2\n\t" \ + "nop\n\t" \ + "movq "OC_C(3)",%%mm6\n\t" \ + "movq %%mm2,%%mm4\n\t" \ + "movq "OC_C(5)",%%mm1\n\t" \ + "pmulhw %%mm6,%%mm4\n\t" \ + "movq "OC_I(1)",%%mm3\n\t" \ + "pmulhw %%mm2,%%mm1\n\t" \ + "movq "OC_C(1)",%%mm0\n\t" \ + "paddw %%mm2,%%mm4\n\t" \ + "pxor %%mm6,%%mm6\n\t" \ + "paddw %%mm1,%%mm2\n\t" \ + "movq "OC_I(2)",%%mm5\n\t" \ + "pmulhw %%mm3,%%mm0\n\t" \ + "movq %%mm5,%%mm1\n\t" \ + "paddw %%mm3,%%mm0\n\t" \ + "pmulhw "OC_C(7)",%%mm3\n\t" \ + "psubw %%mm2,%%mm6\n\t" \ + "pmulhw "OC_C(2)",%%mm5\n\t" \ + "psubw %%mm4,%%mm0\n\t" \ + "movq "OC_I(2)",%%mm7\n\t" \ + "paddw %%mm4,%%mm4\n\t" \ + "paddw %%mm5,%%mm7\n\t" \ + "paddw %%mm0,%%mm4\n\t" \ + "pmulhw "OC_C(6)",%%mm1\n\t" \ + "psubw %%mm6,%%mm3\n\t" \ + "movq %%mm4,"OC_I(1)"\n\t" \ + "paddw %%mm6,%%mm6\n\t" \ + "movq "OC_C(4)",%%mm4\n\t" \ + "paddw %%mm3,%%mm6\n\t" \ + "movq %%mm3,%%mm5\n\t" \ + "pmulhw %%mm4,%%mm3\n\t" \ + "movq %%mm6,"OC_I(2)"\n\t" \ + "movq %%mm0,%%mm2\n\t" \ + "movq "OC_I(0)",%%mm6\n\t" \ + "pmulhw %%mm4,%%mm0\n\t" \ + "paddw %%mm3,%%mm5\n\t" \ + "paddw %%mm0,%%mm2\n\t" \ + "psubw %%mm1,%%mm5\n\t" \ + "pmulhw %%mm4,%%mm6\n\t" \ + "paddw "OC_I(0)",%%mm6\n\t" \ + "paddw %%mm1,%%mm1\n\t" \ + "movq %%mm6,%%mm4\n\t" \ + "paddw %%mm5,%%mm1\n\t" \ + "psubw %%mm2,%%mm6\n\t" \ + "paddw %%mm2,%%mm2\n\t" \ + "movq "OC_I(1)",%%mm0\n\t" \ + "paddw %%mm6,%%mm2\n\t" \ + "psubw %%mm1,%%mm2\n\t" \ + "nop\n\t" \ + "#end OC_IDCT_BEGIN_10\n\t" \ + +/*25+8=33 cycles.*/ +#define OC_ROW_IDCT_10 \ + "#OC_ROW_IDCT_10\n\t" \ + OC_IDCT_BEGIN_10 \ + /*r3=D'*/ \ + "movq "OC_I(2)",%%mm3\n\t" \ + /*r4=E'=E-G*/ \ + "psubw %%mm7,%%mm4\n\t" \ + /*r1=H'+H'*/ \ + "paddw %%mm1,%%mm1\n\t" \ + /*r7=G+G*/ \ + "paddw %%mm7,%%mm7\n\t" \ + /*r1=R1=A''+H'*/ \ + "paddw %%mm2,%%mm1\n\t" \ + /*r7=G'=E+G*/ \ + "paddw %%mm4,%%mm7\n\t" \ + /*r4=R4=E'-D'*/ \ + "psubw %%mm3,%%mm4\n\t" \ + "paddw %%mm3,%%mm3\n\t" \ + /*r6=R6=F'-B''*/ \ + "psubw %%mm5,%%mm6\n\t" \ + "paddw %%mm5,%%mm5\n\t" \ + /*r3=R3=E'+D'*/ \ + "paddw %%mm4,%%mm3\n\t" \ + /*r5=R5=F'+B''*/ \ + "paddw %%mm6,%%mm5\n\t" \ + /*r7=R7=G'-C'*/ \ + "psubw %%mm0,%%mm7\n\t" \ + "paddw %%mm0,%%mm0\n\t" \ + /*Save R1.*/ \ + "movq %%mm1,"OC_I(1)"\n\t" \ + /*r0=R0=G'+C'*/ \ + "paddw %%mm7,%%mm0\n\t" \ + "#end OC_ROW_IDCT_10\n\t" \ + +/*25+19=44 cycles'*/ +#define OC_COLUMN_IDCT_10 \ + "#OC_COLUMN_IDCT_10\n\t" \ + OC_IDCT_BEGIN_10 \ + "paddw "OC_8",%%mm2\n\t" \ + /*r1=H'+H'*/ \ + "paddw %%mm1,%%mm1\n\t" \ + /*r1=R1=A''+H'*/ \ + "paddw %%mm2,%%mm1\n\t" \ + /*r2=NR2*/ \ + "psraw $4,%%mm2\n\t" \ + /*r4=E'=E-G*/ \ + "psubw %%mm7,%%mm4\n\t" \ + /*r1=NR1*/ \ + "psraw $4,%%mm1\n\t" \ + /*r3=D'*/ \ + "movq "OC_I(2)",%%mm3\n\t" \ + /*r7=G+G*/ \ + "paddw %%mm7,%%mm7\n\t" \ + /*Store NR2 at I(2).*/ \ + "movq %%mm2,"OC_I(2)"\n\t" \ + /*r7=G'=E+G*/ \ + "paddw %%mm4,%%mm7\n\t" \ + /*Store NR1 at I(1).*/ \ + "movq %%mm1,"OC_I(1)"\n\t" \ + /*r4=R4=E'-D'*/ \ + "psubw %%mm3,%%mm4\n\t" \ + "paddw "OC_8",%%mm4\n\t" \ + /*r3=D'+D'*/ \ + "paddw %%mm3,%%mm3\n\t" \ + /*r3=R3=E'+D'*/ \ + "paddw %%mm4,%%mm3\n\t" \ + /*r4=NR4*/ \ + "psraw $4,%%mm4\n\t" \ + /*r6=R6=F'-B''*/ \ + "psubw %%mm5,%%mm6\n\t" \ + /*r3=NR3*/ \ + "psraw $4,%%mm3\n\t" \ + "paddw "OC_8",%%mm6\n\t" \ + /*r5=B''+B''*/ \ + "paddw %%mm5,%%mm5\n\t" \ + /*r5=R5=F'+B''*/ \ + "paddw %%mm6,%%mm5\n\t" \ + /*r6=NR6*/ \ + "psraw $4,%%mm6\n\t" \ + /*Store NR4 at J(4).*/ \ + "movq %%mm4,"OC_J(4)"\n\t" \ + /*r5=NR5*/ \ + "psraw $4,%%mm5\n\t" \ + /*Store NR3 at I(3).*/ \ + "movq %%mm3,"OC_I(3)"\n\t" \ + /*r7=R7=G'-C'*/ \ + "psubw %%mm0,%%mm7\n\t" \ + "paddw "OC_8",%%mm7\n\t" \ + /*r0=C'+C'*/ \ + "paddw %%mm0,%%mm0\n\t" \ + /*r0=R0=G'+C'*/ \ + "paddw %%mm7,%%mm0\n\t" \ + /*r7=NR7*/ \ + "psraw $4,%%mm7\n\t" \ + /*Store NR6 at J(6).*/ \ + "movq %%mm6,"OC_J(6)"\n\t" \ + /*r0=NR0*/ \ + "psraw $4,%%mm0\n\t" \ + /*Store NR5 at J(5).*/ \ + "movq %%mm5,"OC_J(5)"\n\t" \ + /*Store NR7 at J(7).*/ \ + "movq %%mm7,"OC_J(7)"\n\t" \ + /*Store NR0 at I(0).*/ \ + "movq %%mm0,"OC_I(0)"\n\t" \ + "#end OC_COLUMN_IDCT_10\n\t" \ + +static void oc_idct8x8_10(ogg_int16_t _y[64]){ + __asm__ __volatile__( +#define OC_I(_k) OC_M2STR((_k*16))"(%[y])" +#define OC_J(_k) OC_M2STR(((_k-4)*16)+8)"(%[y])" + /*Done with dequant, descramble, and partial transpose. + Now do the iDCT itself.*/ + OC_ROW_IDCT_10 + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) OC_M2STR((_k*16))"(%[y])" +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT_10 +#undef OC_I +#undef OC_J +#define OC_I(_k) OC_M2STR((_k*16)+8)"(%[y])" +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT_10 +#undef OC_I +#undef OC_J + : + :[y]"r"(_y),[c]"r"(OC_IDCT_CONSTS) + ); +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform.*/ +void oc_idct8x8_mmx(ogg_int16_t _y[64],int _last_zzi){ + /*_last_zzi is subtly different from an actual count of the number of + coefficients we decoded for this block. + It contains the value of zzi BEFORE the final token in the block was + decoded. + In most cases this is an EOB token (the continuation of an EOB run from a + previous block counts), and so this is the same as the coefficient count. + However, in the case that the last token was NOT an EOB token, but filled + the block up with exactly 64 coefficients, _last_zzi will be less than 64. + Provided the last token was not a pure zero run, the minimum value it can + be is 46, and so that doesn't affect any of the cases in this routine. + However, if the last token WAS a pure zero run of length 63, then _last_zzi + will be 1 while the number of coefficients decoded is 64. + Thus, we will trigger the following special case, where the real + coefficient count would not. + Note also that a zero run of length 64 will give _last_zzi a value of 0, + but we still process the DC coefficient, which might have a non-zero value + due to DC prediction. + Although convoluted, this is arguably the correct behavior: it allows us to + use a smaller transform when the block ends with a long zero run instead + of a normal EOB token. + It could be smarter... multiple separate zero runs at the end of a block + will fool it, but an encoder that generates these really deserves what it + gets. + Needless to say we inherited this approach from VP3.*/ + /*Then perform the iDCT.*/ + if(_last_zzi<10)oc_idct8x8_10(_y); + else oc_idct8x8_slow(_y); +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxloop.h b/libs/libtheora-1.1/lib/x86/mmxloop.h new file mode 100644 index 00000000..2e870c79 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxloop.h @@ -0,0 +1,215 @@ +#if !defined(_x86_mmxloop_H) +# define _x86_mmxloop_H (1) +# include +# include "x86int.h" + +#if defined(OC_X86_ASM) + +/*On entry, mm0={a0,...,a7}, mm1={b0,...,b7}, mm2={c0,...,c7}, mm3={d0,...d7}. + On exit, mm1={b0+lflim(R_0,L),...,b7+lflim(R_7,L)} and + mm2={c0-lflim(R_0,L),...,c7-lflim(R_7,L)}; mm0 and mm3 are clobbered.*/ +#define OC_LOOP_FILTER8_MMX \ + "#OC_LOOP_FILTER8_MMX\n\t" \ + /*mm7=0*/ \ + "pxor %%mm7,%%mm7\n\t" \ + /*mm6:mm0={a0,...,a7}*/ \ + "movq %%mm0,%%mm6\n\t" \ + "punpcklbw %%mm7,%%mm0\n\t" \ + "punpckhbw %%mm7,%%mm6\n\t" \ + /*mm3:mm5={d0,...,d7}*/ \ + "movq %%mm3,%%mm5\n\t" \ + "punpcklbw %%mm7,%%mm3\n\t" \ + "punpckhbw %%mm7,%%mm5\n\t" \ + /*mm6:mm0={a0-d0,...,a7-d7}*/ \ + "psubw %%mm3,%%mm0\n\t" \ + "psubw %%mm5,%%mm6\n\t" \ + /*mm3:mm1={b0,...,b7}*/ \ + "movq %%mm1,%%mm3\n\t" \ + "punpcklbw %%mm7,%%mm1\n\t" \ + "movq %%mm2,%%mm4\n\t" \ + "punpckhbw %%mm7,%%mm3\n\t" \ + /*mm5:mm4={c0,...,c7}*/ \ + "movq %%mm2,%%mm5\n\t" \ + "punpcklbw %%mm7,%%mm4\n\t" \ + "punpckhbw %%mm7,%%mm5\n\t" \ + /*mm7={3}x4 \ + mm5:mm4={c0-b0,...,c7-b7}*/ \ + "pcmpeqw %%mm7,%%mm7\n\t" \ + "psubw %%mm1,%%mm4\n\t" \ + "psrlw $14,%%mm7\n\t" \ + "psubw %%mm3,%%mm5\n\t" \ + /*Scale by 3.*/ \ + "pmullw %%mm7,%%mm4\n\t" \ + "pmullw %%mm7,%%mm5\n\t" \ + /*mm7={4}x4 \ + mm5:mm4=f={a0-d0+3*(c0-b0),...,a7-d7+3*(c7-b7)}*/ \ + "psrlw $1,%%mm7\n\t" \ + "paddw %%mm0,%%mm4\n\t" \ + "psllw $2,%%mm7\n\t" \ + "movq (%[ll]),%%mm0\n\t" \ + "paddw %%mm6,%%mm5\n\t" \ + /*R_i has the range [-127,128], so we compute -R_i instead. \ + mm4=-R_i=-(f+4>>3)=0xFF^(f-4>>3)*/ \ + "psubw %%mm7,%%mm4\n\t" \ + "psubw %%mm7,%%mm5\n\t" \ + "psraw $3,%%mm4\n\t" \ + "psraw $3,%%mm5\n\t" \ + "pcmpeqb %%mm7,%%mm7\n\t" \ + "packsswb %%mm5,%%mm4\n\t" \ + "pxor %%mm6,%%mm6\n\t" \ + "pxor %%mm7,%%mm4\n\t" \ + "packuswb %%mm3,%%mm1\n\t" \ + /*Now compute lflim of -mm4 cf. Section 7.10 of the sepc.*/ \ + /*There's no unsigned byte+signed byte with unsigned saturation op code, so \ + we have to split things by sign (the other option is to work in 16 bits, \ + but working in 8 bits gives much better parallelism). \ + We compute abs(R_i), but save a mask of which terms were negative in mm6. \ + Then we compute mm4=abs(lflim(R_i,L))=min(abs(R_i),max(2*L-abs(R_i),0)). \ + Finally, we split mm4 into positive and negative pieces using the mask in \ + mm6, and add and subtract them as appropriate.*/ \ + /*mm4=abs(-R_i)*/ \ + /*mm7=255-2*L*/ \ + "pcmpgtb %%mm4,%%mm6\n\t" \ + "psubb %%mm0,%%mm7\n\t" \ + "pxor %%mm6,%%mm4\n\t" \ + "psubb %%mm0,%%mm7\n\t" \ + "psubb %%mm6,%%mm4\n\t" \ + /*mm7=255-max(2*L-abs(R_i),0)*/ \ + "paddusb %%mm4,%%mm7\n\t" \ + /*mm4=min(abs(R_i),max(2*L-abs(R_i),0))*/ \ + "paddusb %%mm7,%%mm4\n\t" \ + "psubusb %%mm7,%%mm4\n\t" \ + /*Now split mm4 by the original sign of -R_i.*/ \ + "movq %%mm4,%%mm5\n\t" \ + "pand %%mm6,%%mm4\n\t" \ + "pandn %%mm5,%%mm6\n\t" \ + /*mm1={b0+lflim(R_0,L),...,b7+lflim(R_7,L)}*/ \ + /*mm2={c0-lflim(R_0,L),...,c7-lflim(R_7,L)}*/ \ + "paddusb %%mm4,%%mm1\n\t" \ + "psubusb %%mm4,%%mm2\n\t" \ + "psubusb %%mm6,%%mm1\n\t" \ + "paddusb %%mm6,%%mm2\n\t" \ + +#define OC_LOOP_FILTER_V_MMX(_pix,_ystride,_ll) \ + do{ \ + ptrdiff_t ystride3__; \ + __asm__ __volatile__( \ + /*mm0={a0,...,a7}*/ \ + "movq (%[pix]),%%mm0\n\t" \ + /*ystride3=_ystride*3*/ \ + "lea (%[ystride],%[ystride],2),%[ystride3]\n\t" \ + /*mm3={d0,...,d7}*/ \ + "movq (%[pix],%[ystride3]),%%mm3\n\t" \ + /*mm1={b0,...,b7}*/ \ + "movq (%[pix],%[ystride]),%%mm1\n\t" \ + /*mm2={c0,...,c7}*/ \ + "movq (%[pix],%[ystride],2),%%mm2\n\t" \ + OC_LOOP_FILTER8_MMX \ + /*Write it back out.*/ \ + "movq %%mm1,(%[pix],%[ystride])\n\t" \ + "movq %%mm2,(%[pix],%[ystride],2)\n\t" \ + :[ystride3]"=&r"(ystride3__) \ + :[pix]"r"(_pix-_ystride*2),[ystride]"r"((ptrdiff_t)(_ystride)), \ + [ll]"r"(_ll) \ + :"memory" \ + ); \ + } \ + while(0) + +#define OC_LOOP_FILTER_H_MMX(_pix,_ystride,_ll) \ + do{ \ + unsigned char *pix__; \ + ptrdiff_t ystride3__; \ + ptrdiff_t d__; \ + pix__=(_pix)-2; \ + __asm__ __volatile__( \ + /*x x x x d0 c0 b0 a0*/ \ + "movd (%[pix]),%%mm0\n\t" \ + /*x x x x d1 c1 b1 a1*/ \ + "movd (%[pix],%[ystride]),%%mm1\n\t" \ + /*ystride3=_ystride*3*/ \ + "lea (%[ystride],%[ystride],2),%[ystride3]\n\t" \ + /*x x x x d2 c2 b2 a2*/ \ + "movd (%[pix],%[ystride],2),%%mm2\n\t" \ + /*x x x x d3 c3 b3 a3*/ \ + "lea (%[pix],%[ystride],4),%[d]\n\t" \ + "movd (%[pix],%[ystride3]),%%mm3\n\t" \ + /*x x x x d4 c4 b4 a4*/ \ + "movd (%[d]),%%mm4\n\t" \ + /*x x x x d5 c5 b5 a5*/ \ + "movd (%[d],%[ystride]),%%mm5\n\t" \ + /*x x x x d6 c6 b6 a6*/ \ + "movd (%[d],%[ystride],2),%%mm6\n\t" \ + /*x x x x d7 c7 b7 a7*/ \ + "movd (%[d],%[ystride3]),%%mm7\n\t" \ + /*mm0=d1 d0 c1 c0 b1 b0 a1 a0*/ \ + "punpcklbw %%mm1,%%mm0\n\t" \ + /*mm2=d3 d2 c3 c2 b3 b2 a3 a2*/ \ + "punpcklbw %%mm3,%%mm2\n\t" \ + /*mm3=d1 d0 c1 c0 b1 b0 a1 a0*/ \ + "movq %%mm0,%%mm3\n\t" \ + /*mm0=b3 b2 b1 b0 a3 a2 a1 a0*/ \ + "punpcklwd %%mm2,%%mm0\n\t" \ + /*mm3=d3 d2 d1 d0 c3 c2 c1 c0*/ \ + "punpckhwd %%mm2,%%mm3\n\t" \ + /*mm1=b3 b2 b1 b0 a3 a2 a1 a0*/ \ + "movq %%mm0,%%mm1\n\t" \ + /*mm4=d5 d4 c5 c4 b5 b4 a5 a4*/ \ + "punpcklbw %%mm5,%%mm4\n\t" \ + /*mm6=d7 d6 c7 c6 b7 b6 a7 a6*/ \ + "punpcklbw %%mm7,%%mm6\n\t" \ + /*mm5=d5 d4 c5 c4 b5 b4 a5 a4*/ \ + "movq %%mm4,%%mm5\n\t" \ + /*mm4=b7 b6 b5 b4 a7 a6 a5 a4*/ \ + "punpcklwd %%mm6,%%mm4\n\t" \ + /*mm5=d7 d6 d5 d4 c7 c6 c5 c4*/ \ + "punpckhwd %%mm6,%%mm5\n\t" \ + /*mm2=d3 d2 d1 d0 c3 c2 c1 c0*/ \ + "movq %%mm3,%%mm2\n\t" \ + /*mm0=a7 a6 a5 a4 a3 a2 a1 a0*/ \ + "punpckldq %%mm4,%%mm0\n\t" \ + /*mm1=b7 b6 b5 b4 b3 b2 b1 b0*/ \ + "punpckhdq %%mm4,%%mm1\n\t" \ + /*mm2=c7 c6 c5 c4 c3 c2 c1 c0*/ \ + "punpckldq %%mm5,%%mm2\n\t" \ + /*mm3=d7 d6 d5 d4 d3 d2 d1 d0*/ \ + "punpckhdq %%mm5,%%mm3\n\t" \ + OC_LOOP_FILTER8_MMX \ + /*mm2={b0+R_0'',...,b7+R_7''}*/ \ + "movq %%mm1,%%mm0\n\t" \ + /*mm1={b0+R_0'',c0-R_0'',...,b3+R_3'',c3-R_3''}*/ \ + "punpcklbw %%mm2,%%mm1\n\t" \ + /*mm2={b4+R_4'',c4-R_4'',...,b7+R_7'',c7-R_7''}*/ \ + "punpckhbw %%mm2,%%mm0\n\t" \ + /*[d]=c1 b1 c0 b0*/ \ + "movd %%mm1,%[d]\n\t" \ + "movw %w[d],1(%[pix])\n\t" \ + "psrlq $32,%%mm1\n\t" \ + "shr $16,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride])\n\t" \ + /*[d]=c3 b3 c2 b2*/ \ + "movd %%mm1,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride],2)\n\t" \ + "shr $16,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride3])\n\t" \ + "lea (%[pix],%[ystride],4),%[pix]\n\t" \ + /*[d]=c5 b5 c4 b4*/ \ + "movd %%mm0,%[d]\n\t" \ + "movw %w[d],1(%[pix])\n\t" \ + "psrlq $32,%%mm0\n\t" \ + "shr $16,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride])\n\t" \ + /*[d]=c7 b7 c6 b6*/ \ + "movd %%mm0,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride],2)\n\t" \ + "shr $16,%[d]\n\t" \ + "movw %w[d],1(%[pix],%[ystride3])\n\t" \ + :[pix]"+r"(pix__),[ystride3]"=&r"(ystride3__),[d]"=&r"(d__) \ + :[ystride]"r"((ptrdiff_t)(_ystride)),[ll]"r"(_ll) \ + :"memory" \ + ); \ + } \ + while(0) + +# endif +#endif diff --git a/libs/libtheora-1.1/lib/x86/mmxstate.c b/libs/libtheora-1.1/lib/x86/mmxstate.c new file mode 100644 index 00000000..f8955083 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/mmxstate.c @@ -0,0 +1,188 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxstate.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*MMX acceleration of complete fragment reconstruction algorithm. + Originally written by Rudolf Marek.*/ +#include +#include "x86int.h" +#include "mmxfrag.h" +#include "mmxloop.h" + +#if defined(OC_X86_ASM) + +void oc_state_frag_recon_mmx(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant){ + unsigned char *dst; + ptrdiff_t frag_buf_off; + int ystride; + int mb_mode; + /*Apply the inverse transform.*/ + /*Special case only having a DC component.*/ + if(_last_zzi<2){ + /*Note that this value must be unsigned, to keep the __asm__ block from + sign-extending it when it puts it in a register.*/ + ogg_uint16_t p; + /*We round this dequant product (and not any of the others) because there's + no iDCT rounding.*/ + p=(ogg_int16_t)(_dct_coeffs[0]*(ogg_int32_t)_dc_quant+15>>5); + /*Fill _dct_coeffs with p.*/ + __asm__ __volatile__( + /*mm0=0000 0000 0000 AAAA*/ + "movd %[p],%%mm0\n\t" + /*mm0=0000 0000 AAAA AAAA*/ + "punpcklwd %%mm0,%%mm0\n\t" + /*mm0=AAAA AAAA AAAA AAAA*/ + "punpckldq %%mm0,%%mm0\n\t" + "movq %%mm0,(%[y])\n\t" + "movq %%mm0,8(%[y])\n\t" + "movq %%mm0,16(%[y])\n\t" + "movq %%mm0,24(%[y])\n\t" + "movq %%mm0,32(%[y])\n\t" + "movq %%mm0,40(%[y])\n\t" + "movq %%mm0,48(%[y])\n\t" + "movq %%mm0,56(%[y])\n\t" + "movq %%mm0,64(%[y])\n\t" + "movq %%mm0,72(%[y])\n\t" + "movq %%mm0,80(%[y])\n\t" + "movq %%mm0,88(%[y])\n\t" + "movq %%mm0,96(%[y])\n\t" + "movq %%mm0,104(%[y])\n\t" + "movq %%mm0,112(%[y])\n\t" + "movq %%mm0,120(%[y])\n\t" + : + :[y]"r"(_dct_coeffs),[p]"r"((unsigned)p) + :"memory" + ); + } + else{ + /*Dequantize the DC coefficient.*/ + _dct_coeffs[0]=(ogg_int16_t)(_dct_coeffs[0]*(int)_dc_quant); + oc_idct8x8_mmx(_dct_coeffs,_last_zzi); + } + /*Fill in the target buffer.*/ + frag_buf_off=_state->frag_buf_offs[_fragi]; + mb_mode=_state->frags[_fragi].mb_mode; + ystride=_state->ref_ystride[_pli]; + dst=_state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_SELF]]+frag_buf_off; + if(mb_mode==OC_MODE_INTRA)oc_frag_recon_intra_mmx(dst,ystride,_dct_coeffs); + else{ + const unsigned char *ref; + int mvoffsets[2]; + ref= + _state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_FOR_MODE(mb_mode)]] + +frag_buf_off; + if(oc_state_get_mv_offsets(_state,mvoffsets,_pli, + _state->frag_mvs[_fragi][0],_state->frag_mvs[_fragi][1])>1){ + oc_frag_recon_inter2_mmx(dst,ref+mvoffsets[0],ref+mvoffsets[1],ystride, + _dct_coeffs); + } + else oc_frag_recon_inter_mmx(dst,ref+mvoffsets[0],ystride,_dct_coeffs); + } +} + +/*We copy these entire function to inline the actual MMX routines so that we + use only a single indirect call.*/ + +/*Copies the fragments specified by the lists of fragment indices from one + frame to another. + _fragis: A pointer to a list of fragment indices. + _nfragis: The number of fragment indices to copy. + _dst_frame: The reference frame to copy to. + _src_frame: The reference frame to copy from. + _pli: The color plane the fragments lie in.*/ +void oc_state_frag_copy_list_mmx(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli){ + const ptrdiff_t *frag_buf_offs; + const unsigned char *src_frame_data; + unsigned char *dst_frame_data; + ptrdiff_t fragii; + int ystride; + dst_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_dst_frame]]; + src_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_src_frame]]; + ystride=_state->ref_ystride[_pli]; + frag_buf_offs=_state->frag_buf_offs; + for(fragii=0;fragii<_nfragis;fragii++){ + ptrdiff_t frag_buf_off; + frag_buf_off=frag_buf_offs[_fragis[fragii]]; + OC_FRAG_COPY_MMX(dst_frame_data+frag_buf_off, + src_frame_data+frag_buf_off,ystride); + } +} + +/*Apply the loop filter to a given set of fragment rows in the given plane. + The filter may be run on the bottom edge, affecting pixels in the next row of + fragments, so this row also needs to be available. + _bv: The bounding values array. + _refi: The index of the frame buffer to filter. + _pli: The color plane to filter. + _fragy0: The Y coordinate of the first fragment row to filter. + _fragy_end: The Y coordinate of the fragment row to stop filtering at.*/ +void oc_state_loop_filter_frag_rows_mmx(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end){ + OC_ALIGN8(unsigned char ll[8]); + const oc_fragment_plane *fplane; + const oc_fragment *frags; + const ptrdiff_t *frag_buf_offs; + unsigned char *ref_frame_data; + ptrdiff_t fragi_top; + ptrdiff_t fragi_bot; + ptrdiff_t fragi0; + ptrdiff_t fragi0_end; + int ystride; + int nhfrags; + memset(ll,_state->loop_filter_limits[_state->qis[0]],sizeof(ll)); + fplane=_state->fplanes+_pli; + nhfrags=fplane->nhfrags; + fragi_top=fplane->froffset; + fragi_bot=fragi_top+fplane->nfrags; + fragi0=fragi_top+_fragy0*(ptrdiff_t)nhfrags; + fragi0_end=fragi0+(_fragy_end-_fragy0)*(ptrdiff_t)nhfrags; + ystride=_state->ref_ystride[_pli]; + frags=_state->frags; + frag_buf_offs=_state->frag_buf_offs; + ref_frame_data=_state->ref_frame_data[_refi]; + /*The following loops are constructed somewhat non-intuitively on purpose. + The main idea is: if a block boundary has at least one coded fragment on + it, the filter is applied to it. + However, the order that the filters are applied in matters, and VP3 chose + the somewhat strange ordering used below.*/ + while(fragi0fragi0)OC_LOOP_FILTER_H_MMX(ref,ystride,ll); + if(fragi0>fragi_top)OC_LOOP_FILTER_V_MMX(ref,ystride,ll); + if(fragi+1 +#include "x86enc.h" + +#if defined(OC_X86_64_ASM) + +# define OC_FDCT8x8 \ + /*Note: xmm15={0}x8 and xmm14={-1}x8.*/ \ + "#OC_FDCT8x8\n\t" \ + /*Stage 1:*/ \ + "movdqa %%xmm0,%%xmm11\n\t" \ + "movdqa %%xmm1,%%xmm10\n\t" \ + "movdqa %%xmm2,%%xmm9\n\t" \ + "movdqa %%xmm3,%%xmm8\n\t" \ + /*xmm11=t7'=t0-t7*/ \ + "psubw %%xmm7,%%xmm11\n\t" \ + /*xmm10=t6'=t1-t6*/ \ + "psubw %%xmm6,%%xmm10\n\t" \ + /*xmm9=t5'=t2-t5*/ \ + "psubw %%xmm5,%%xmm9\n\t" \ + /*xmm8=t4'=t3-t4*/ \ + "psubw %%xmm4,%%xmm8\n\t" \ + /*xmm0=t0'=t0+t7*/ \ + "paddw %%xmm7,%%xmm0\n\t" \ + /*xmm1=t1'=t1+t6*/ \ + "paddw %%xmm6,%%xmm1\n\t" \ + /*xmm5=t2'=t2+t5*/ \ + "paddw %%xmm2,%%xmm5\n\t" \ + /*xmm4=t3'=t3+t4*/ \ + "paddw %%xmm3,%%xmm4\n\t" \ + /*xmm2,3,6,7 are now free.*/ \ + /*Stage 2:*/ \ + "movdqa %%xmm0,%%xmm3\n\t" \ + "mov $0x5A806A0A,%[a]\n\t" \ + "movdqa %%xmm1,%%xmm2\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "movdqa %%xmm10,%%xmm6\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + /*xmm2=t2''=t1'-t2'*/ \ + "psubw %%xmm5,%%xmm2\n\t" \ + "pxor %%xmm12,%%xmm12\n\t" \ + /*xmm3=t3''=t0'-t3'*/ \ + "psubw %%xmm4,%%xmm3\n\t" \ + "psubw %%xmm14,%%xmm12\n\t" \ + /*xmm10=t5''=t6'-t5'*/ \ + "psubw %%xmm9,%%xmm10\n\t" \ + "paddw %%xmm12,%%xmm12\n\t" \ + /*xmm4=t0''=t0'+t3'*/ \ + "paddw %%xmm0,%%xmm4\n\t" \ + /*xmm1=t1''=t1'+t2'*/ \ + "paddw %%xmm5,%%xmm1\n\t" \ + /*xmm6=t6''=t6'+t5'*/ \ + "paddw %%xmm9,%%xmm6\n\t" \ + /*xmm0,xmm5,xmm9 are now free.*/ \ + /*Stage 3:*/ \ + /*xmm10:xmm5=t5''*27146+0xB500 \ + xmm0=t5''*/ \ + "movdqa %%xmm10,%%xmm5\n\t" \ + "movdqa %%xmm10,%%xmm0\n\t" \ + "punpckhwd %%xmm12,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + "punpcklwd %%xmm12,%%xmm5\n\t" \ + "pmaddwd %%xmm13,%%xmm5\n\t" \ + /*xmm5=(t5''*27146+0xB500>>16)+t5''*/ \ + "psrad $16,%%xmm10\n\t" \ + "psrad $16,%%xmm5\n\t" \ + "packssdw %%xmm10,%%xmm5\n\t" \ + "paddw %%xmm0,%%xmm5\n\t" \ + /*xmm0=s=(t5''*27146+0xB500>>16)+t5''+(t5''!=0)>>1*/ \ + "pcmpeqw %%xmm15,%%xmm0\n\t" \ + "psubw %%xmm14,%%xmm0\n\t" \ + "paddw %%xmm5,%%xmm0\n\t" \ + "movdqa %%xmm8,%%xmm5\n\t" \ + "psraw $1,%%xmm0\n\t" \ + /*xmm5=t5'''=t4'-s*/ \ + "psubw %%xmm0,%%xmm5\n\t" \ + /*xmm8=t4''=t4'+s*/ \ + "paddw %%xmm0,%%xmm8\n\t" \ + /*xmm0,xmm7,xmm9,xmm10 are free.*/ \ + /*xmm7:xmm9=t6''*27146+0xB500*/ \ + "movdqa %%xmm6,%%xmm7\n\t" \ + "movdqa %%xmm6,%%xmm9\n\t" \ + "punpckhwd %%xmm12,%%xmm7\n\t" \ + "pmaddwd %%xmm13,%%xmm7\n\t" \ + "punpcklwd %%xmm12,%%xmm9\n\t" \ + "pmaddwd %%xmm13,%%xmm9\n\t" \ + /*xmm9=(t6''*27146+0xB500>>16)+t6''*/ \ + "psrad $16,%%xmm7\n\t" \ + "psrad $16,%%xmm9\n\t" \ + "packssdw %%xmm7,%%xmm9\n\t" \ + "paddw %%xmm6,%%xmm9\n\t" \ + /*xmm9=s=(t6''*27146+0xB500>>16)+t6''+(t6''!=0)>>1*/ \ + "pcmpeqw %%xmm15,%%xmm6\n\t" \ + "psubw %%xmm14,%%xmm6\n\t" \ + "paddw %%xmm6,%%xmm9\n\t" \ + "movdqa %%xmm11,%%xmm7\n\t" \ + "psraw $1,%%xmm9\n\t" \ + /*xmm7=t6'''=t7'-s*/ \ + "psubw %%xmm9,%%xmm7\n\t" \ + /*xmm9=t7''=t7'+s*/ \ + "paddw %%xmm11,%%xmm9\n\t" \ + /*xmm0,xmm6,xmm10,xmm11 are free.*/ \ + /*Stage 4:*/ \ + /*xmm10:xmm0=t1''*27146+0xB500*/ \ + "movdqa %%xmm1,%%xmm0\n\t" \ + "movdqa %%xmm1,%%xmm10\n\t" \ + "punpcklwd %%xmm12,%%xmm0\n\t" \ + "pmaddwd %%xmm13,%%xmm0\n\t" \ + "punpckhwd %%xmm12,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + /*xmm0=(t1''*27146+0xB500>>16)+t1''*/ \ + "psrad $16,%%xmm0\n\t" \ + "psrad $16,%%xmm10\n\t" \ + "mov $0x20006A0A,%[a]\n\t" \ + "packssdw %%xmm10,%%xmm0\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddw %%xmm1,%%xmm0\n\t" \ + /*xmm0=s=(t1''*27146+0xB500>>16)+t1''+(t1''!=0)*/ \ + "pcmpeqw %%xmm15,%%xmm1\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "psubw %%xmm14,%%xmm1\n\t" \ + "paddw %%xmm1,%%xmm0\n\t" \ + /*xmm10:xmm4=t0''*27146+0x4000*/ \ + "movdqa %%xmm4,%%xmm1\n\t" \ + "movdqa %%xmm4,%%xmm10\n\t" \ + "punpcklwd %%xmm12,%%xmm4\n\t" \ + "pmaddwd %%xmm13,%%xmm4\n\t" \ + "punpckhwd %%xmm12,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + /*xmm4=(t0''*27146+0x4000>>16)+t0''*/ \ + "psrad $16,%%xmm4\n\t" \ + "psrad $16,%%xmm10\n\t" \ + "mov $0x6CB7,%[a]\n\t" \ + "packssdw %%xmm10,%%xmm4\n\t" \ + "movd %[a],%%xmm12\n\t" \ + "paddw %%xmm1,%%xmm4\n\t" \ + /*xmm4=r=(t0''*27146+0x4000>>16)+t0''+(t0''!=0)*/ \ + "pcmpeqw %%xmm15,%%xmm1\n\t" \ + "pshufd $00,%%xmm12,%%xmm12\n\t" \ + "psubw %%xmm14,%%xmm1\n\t" \ + "mov $0x7FFF6C84,%[a]\n\t" \ + "paddw %%xmm1,%%xmm4\n\t" \ + /*xmm0=_y[0]=u=r+s>>1 \ + The naive implementation could cause overflow, so we use \ + u=(r&s)+((r^s)>>1).*/ \ + "movdqa %%xmm0,%%xmm6\n\t" \ + "pxor %%xmm4,%%xmm0\n\t" \ + "pand %%xmm4,%%xmm6\n\t" \ + "psraw $1,%%xmm0\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddw %%xmm6,%%xmm0\n\t" \ + /*xmm4=_y[4]=v=r-u*/ \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "psubw %%xmm0,%%xmm4\n\t" \ + /*xmm1,xmm6,xmm10,xmm11 are free.*/ \ + /*xmm6:xmm10=60547*t3''+0x6CB7*/ \ + "movdqa %%xmm3,%%xmm10\n\t" \ + "movdqa %%xmm3,%%xmm6\n\t" \ + "punpcklwd %%xmm3,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + "mov $0x61F861F8,%[a]\n\t" \ + "punpckhwd %%xmm3,%%xmm6\n\t" \ + "pmaddwd %%xmm13,%%xmm6\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm6\n\t" \ + /*xmm1:xmm2=25080*t2'' \ + xmm12=t2''*/ \ + "movdqa %%xmm2,%%xmm11\n\t" \ + "movdqa %%xmm2,%%xmm12\n\t" \ + "pmullw %%xmm13,%%xmm2\n\t" \ + "pmulhw %%xmm13,%%xmm11\n\t" \ + "movdqa %%xmm2,%%xmm1\n\t" \ + "punpcklwd %%xmm11,%%xmm2\n\t" \ + "punpckhwd %%xmm11,%%xmm1\n\t" \ + /*xmm10=u=(25080*t2''+60547*t3''+0x6CB7>>16)+(t3''!=0)*/ \ + "paddd %%xmm2,%%xmm10\n\t" \ + "paddd %%xmm1,%%xmm6\n\t" \ + "psrad $16,%%xmm10\n\t" \ + "pcmpeqw %%xmm15,%%xmm3\n\t" \ + "psrad $16,%%xmm6\n\t" \ + "psubw %%xmm14,%%xmm3\n\t" \ + "packssdw %%xmm6,%%xmm10\n\t" \ + "paddw %%xmm3,%%xmm10\n\t" \ + /*xmm2=_y[2]=u \ + xmm10=s=(25080*u>>16)-t2''*/ \ + "movdqa %%xmm10,%%xmm2\n\t" \ + "pmulhw %%xmm13,%%xmm10\n\t" \ + "psubw %%xmm12,%%xmm10\n\t" \ + /*xmm1:xmm6=s*21600+0x2800*/ \ + "pxor %%xmm12,%%xmm12\n\t" \ + "psubw %%xmm14,%%xmm12\n\t" \ + "mov $0x28005460,%[a]\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "movdqa %%xmm10,%%xmm6\n\t" \ + "movdqa %%xmm10,%%xmm1\n\t" \ + "punpcklwd %%xmm12,%%xmm6\n\t" \ + "pmaddwd %%xmm13,%%xmm6\n\t" \ + "mov $0x0E3D,%[a]\n\t" \ + "punpckhwd %%xmm12,%%xmm1\n\t" \ + "pmaddwd %%xmm13,%%xmm1\n\t" \ + /*xmm6=(s*21600+0x2800>>18)+s*/ \ + "psrad $18,%%xmm6\n\t" \ + "psrad $18,%%xmm1\n\t" \ + "movd %[a],%%xmm12\n\t" \ + "packssdw %%xmm1,%%xmm6\n\t" \ + "pshufd $00,%%xmm12,%%xmm12\n\t" \ + "paddw %%xmm10,%%xmm6\n\t" \ + /*xmm6=_y[6]=v=(s*21600+0x2800>>18)+s+(s!=0)*/ \ + "mov $0x7FFF54DC,%[a]\n\t" \ + "pcmpeqw %%xmm15,%%xmm10\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "psubw %%xmm14,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "paddw %%xmm10,%%xmm6\n\t " \ + /*xmm1,xmm3,xmm10,xmm11 are free.*/ \ + /*xmm11:xmm10=54491*t5'''+0x0E3D*/ \ + "movdqa %%xmm5,%%xmm10\n\t" \ + "movdqa %%xmm5,%%xmm11\n\t" \ + "punpcklwd %%xmm5,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + "mov $0x8E3A8E3A,%[a]\n\t" \ + "punpckhwd %%xmm5,%%xmm11\n\t" \ + "pmaddwd %%xmm13,%%xmm11\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm11\n\t" \ + /*xmm7:xmm12=36410*t6''' \ + xmm1=t6'''*/ \ + "movdqa %%xmm7,%%xmm3\n\t" \ + "movdqa %%xmm7,%%xmm1\n\t" \ + "pmulhw %%xmm13,%%xmm3\n\t" \ + "pmullw %%xmm13,%%xmm7\n\t" \ + "paddw %%xmm1,%%xmm3\n\t" \ + "movdqa %%xmm7,%%xmm12\n\t" \ + "punpckhwd %%xmm3,%%xmm7\n\t" \ + "punpcklwd %%xmm3,%%xmm12\n\t" \ + /*xmm10=u=(54491*t5'''+36410*t6'''+0x0E3D>>16)+(t5'''!=0)*/ \ + "paddd %%xmm12,%%xmm10\n\t" \ + "paddd %%xmm7,%%xmm11\n\t" \ + "psrad $16,%%xmm10\n\t" \ + "pcmpeqw %%xmm15,%%xmm5\n\t" \ + "psrad $16,%%xmm11\n\t" \ + "psubw %%xmm14,%%xmm5\n\t" \ + "packssdw %%xmm11,%%xmm10\n\t" \ + "pxor %%xmm12,%%xmm12\n\t" \ + "paddw %%xmm5,%%xmm10\n\t" \ + /*xmm5=_y[5]=u \ + xmm1=s=t6'''-(36410*u>>16)*/ \ + "psubw %%xmm14,%%xmm12\n\t" \ + "movdqa %%xmm10,%%xmm5\n\t" \ + "mov $0x340067C8,%[a]\n\t" \ + "pmulhw %%xmm13,%%xmm10\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddw %%xmm5,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "psubw %%xmm10,%%xmm1\n\t" \ + /*xmm11:xmm3=s*26568+0x3400*/ \ + "movdqa %%xmm1,%%xmm3\n\t" \ + "movdqa %%xmm1,%%xmm11\n\t" \ + "punpcklwd %%xmm12,%%xmm3\n\t" \ + "pmaddwd %%xmm13,%%xmm3\n\t" \ + "mov $0x7B1B,%[a]\n\t" \ + "punpckhwd %%xmm12,%%xmm11\n\t" \ + "pmaddwd %%xmm13,%%xmm11\n\t" \ + /*xmm3=(s*26568+0x3400>>17)+s*/ \ + "psrad $17,%%xmm3\n\t" \ + "psrad $17,%%xmm11\n\t" \ + "movd %[a],%%xmm12\n\t" \ + "packssdw %%xmm11,%%xmm3\n\t" \ + "pshufd $00,%%xmm12,%%xmm12\n\t" \ + "paddw %%xmm1,%%xmm3\n\t" \ + /*xmm3=_y[3]=v=(s*26568+0x3400>>17)+s+(s!=0)*/ \ + "mov $0x7FFF7B16,%[a]\n\t" \ + "pcmpeqw %%xmm15,%%xmm1\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "psubw %%xmm14,%%xmm1\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "paddw %%xmm1,%%xmm3\n\t " \ + /*xmm1,xmm7,xmm10,xmm11 are free.*/ \ + /*xmm11:xmm10=64277*t7''+0x7B1B*/ \ + "movdqa %%xmm9,%%xmm10\n\t" \ + "movdqa %%xmm9,%%xmm11\n\t" \ + "punpcklwd %%xmm9,%%xmm10\n\t" \ + "pmaddwd %%xmm13,%%xmm10\n\t" \ + "mov $0x31F131F1,%[a]\n\t" \ + "punpckhwd %%xmm9,%%xmm11\n\t" \ + "pmaddwd %%xmm13,%%xmm11\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + "paddd %%xmm12,%%xmm11\n\t" \ + /*xmm12:xmm7=12785*t4''*/ \ + "movdqa %%xmm8,%%xmm7\n\t" \ + "movdqa %%xmm8,%%xmm1\n\t" \ + "pmullw %%xmm13,%%xmm7\n\t" \ + "pmulhw %%xmm13,%%xmm1\n\t" \ + "movdqa %%xmm7,%%xmm12\n\t" \ + "punpcklwd %%xmm1,%%xmm7\n\t" \ + "punpckhwd %%xmm1,%%xmm12\n\t" \ + /*xmm10=u=(12785*t4''+64277*t7''+0x7B1B>>16)+(t7''!=0)*/ \ + "paddd %%xmm7,%%xmm10\n\t" \ + "paddd %%xmm12,%%xmm11\n\t" \ + "psrad $16,%%xmm10\n\t" \ + "pcmpeqw %%xmm15,%%xmm9\n\t" \ + "psrad $16,%%xmm11\n\t" \ + "psubw %%xmm14,%%xmm9\n\t" \ + "packssdw %%xmm11,%%xmm10\n\t" \ + "pxor %%xmm12,%%xmm12\n\t" \ + "paddw %%xmm9,%%xmm10\n\t" \ + /*xmm1=_y[1]=u \ + xmm10=s=(12785*u>>16)-t4''*/ \ + "psubw %%xmm14,%%xmm12\n\t" \ + "movdqa %%xmm10,%%xmm1\n\t" \ + "mov $0x3000503B,%[a]\n\t" \ + "pmulhw %%xmm13,%%xmm10\n\t" \ + "movd %[a],%%xmm13\n\t" \ + "psubw %%xmm8,%%xmm10\n\t" \ + "pshufd $00,%%xmm13,%%xmm13\n\t" \ + /*xmm8:xmm7=s*20539+0x3000*/ \ + "movdqa %%xmm10,%%xmm7\n\t" \ + "movdqa %%xmm10,%%xmm8\n\t" \ + "punpcklwd %%xmm12,%%xmm7\n\t" \ + "pmaddwd %%xmm13,%%xmm7\n\t" \ + "punpckhwd %%xmm12,%%xmm8\n\t" \ + "pmaddwd %%xmm13,%%xmm8\n\t" \ + /*xmm7=(s*20539+0x3000>>20)+s*/ \ + "psrad $20,%%xmm7\n\t" \ + "psrad $20,%%xmm8\n\t" \ + "packssdw %%xmm8,%%xmm7\n\t" \ + "paddw %%xmm10,%%xmm7\n\t" \ + /*xmm7=_y[7]=v=(s*20539+0x3000>>20)+s+(s!=0)*/ \ + "pcmpeqw %%xmm15,%%xmm10\n\t" \ + "psubw %%xmm14,%%xmm10\n\t" \ + "paddw %%xmm10,%%xmm7\n\t " \ + +# define OC_TRANSPOSE8x8 \ + "#OC_TRANSPOSE8x8\n\t" \ + "movdqa %%xmm4,%%xmm8\n\t" \ + /*xmm4 = f3 e3 f2 e2 f1 e1 f0 e0*/ \ + "punpcklwd %%xmm5,%%xmm4\n\t" \ + /*xmm8 = f7 e7 f6 e6 f5 e5 f4 e4*/ \ + "punpckhwd %%xmm5,%%xmm8\n\t" \ + /*xmm5 is free.*/ \ + "movdqa %%xmm0,%%xmm5\n\t" \ + /*xmm0 = b3 a3 b2 a2 b1 a1 b0 a0*/ \ + "punpcklwd %%xmm1,%%xmm0\n\t" \ + /*xmm5 = b7 a7 b6 a6 b5 a5 b4 a4*/ \ + "punpckhwd %%xmm1,%%xmm5\n\t" \ + /*xmm1 is free.*/ \ + "movdqa %%xmm6,%%xmm1\n\t" \ + /*xmm6 = h3 g3 h2 g2 h1 g1 h0 g0*/ \ + "punpcklwd %%xmm7,%%xmm6\n\t" \ + /*xmm1 = h7 g7 h6 g6 h5 g5 h4 g4*/ \ + "punpckhwd %%xmm7,%%xmm1\n\t" \ + /*xmm7 is free.*/ \ + "movdqa %%xmm2,%%xmm7\n\t" \ + /*xmm7 = d3 c3 d2 c2 d1 c1 d0 c0*/ \ + "punpcklwd %%xmm3,%%xmm7\n\t" \ + /*xmm2 = d7 c7 d6 c6 d5 c5 d4 c4*/ \ + "punpckhwd %%xmm3,%%xmm2\n\t" \ + /*xmm3 is free.*/ \ + "movdqa %%xmm0,%%xmm3\n\t" \ + /*xmm0 = d1 c1 b1 a1 d0 c0 b0 a0*/ \ + "punpckldq %%xmm7,%%xmm0\n\t" \ + /*xmm3 = d3 c3 b3 a3 d2 c2 b2 a2*/ \ + "punpckhdq %%xmm7,%%xmm3\n\t" \ + /*xmm7 is free.*/ \ + "movdqa %%xmm5,%%xmm7\n\t" \ + /*xmm5 = d5 c5 b5 a5 d4 c4 b4 a4*/ \ + "punpckldq %%xmm2,%%xmm5\n\t" \ + /*xmm7 = d7 c7 b7 a7 d6 c6 b6 a6*/ \ + "punpckhdq %%xmm2,%%xmm7\n\t" \ + /*xmm2 is free.*/ \ + "movdqa %%xmm4,%%xmm2\n\t" \ + /*xmm2 = h1 g1 f1 e1 h0 g0 f0 e0*/ \ + "punpckldq %%xmm6,%%xmm2\n\t" \ + /*xmm4 = h3 g3 f3 e3 h2 g2 f2 e2*/ \ + "punpckhdq %%xmm6,%%xmm4\n\t" \ + /*xmm6 is free.*/ \ + "movdqa %%xmm8,%%xmm6\n\t" \ + /*xmm6 = h5 g5 f5 e5 h4 g4 f4 e4*/ \ + "punpckldq %%xmm1,%%xmm6\n\t" \ + /*xmm8 = h7 g7 f7 e7 h6 g6 f6 e6*/ \ + "punpckhdq %%xmm1,%%xmm8\n\t" \ + /*xmm1 is free.*/ \ + "movdqa %%xmm0,%%xmm1\n\t" \ + /*xmm0 = h0 g0 f0 e0 d0 c0 b0 a0*/ \ + "punpcklqdq %%xmm2,%%xmm0\n\t" \ + /*xmm1 = h1 g1 f1 e1 d1 c1 b1 a1*/ \ + "punpckhqdq %%xmm2,%%xmm1\n\t" \ + /*xmm2 is free.*/ \ + "movdqa %%xmm3,%%xmm2\n\t" \ + /*xmm2 = h2 g2 f2 e2 d2 c2 b2 a2*/ \ + "punpcklqdq %%xmm4,%%xmm2\n\t" \ + /*xmm3 = h3 g3 f3 e3 d3 c3 b3 a3*/ \ + "punpckhqdq %%xmm4,%%xmm3\n\t" \ + /*xmm4 is free.*/ \ + "movdqa %%xmm5,%%xmm4\n\t" \ + /*xmm4 = h4 g4 f4 e4 d4 c4 b4 a4*/ \ + "punpcklqdq %%xmm6,%%xmm4\n\t" \ + /*xmm5 = h5 g5 f5 e5 d5 c5 b5 a5*/ \ + "punpckhqdq %%xmm6,%%xmm5\n\t" \ + /*xmm6 is free.*/ \ + "movdqa %%xmm7,%%xmm6\n\t" \ + /*xmm6 = h6 g6 f6 e6 d6 c6 b6 a6*/ \ + "punpcklqdq %%xmm8,%%xmm6\n\t" \ + /*xmm7 = h7 g7 f7 e7 d7 c7 b7 a7*/ \ + "punpckhqdq %%xmm8,%%xmm7\n\t" \ + /*xmm8 is free.*/ \ + +/*SSE2 implementation of the fDCT for x86-64 only. + Because of the 8 extra XMM registers on x86-64, this version can operate + without any temporary stack access at all.*/ +void oc_enc_fdct8x8_x86_64sse2(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + ptrdiff_t a; + __asm__ __volatile__( + /*Load the input.*/ + "movdqa 0x00(%[x]),%%xmm0\n\t" + "movdqa 0x10(%[x]),%%xmm1\n\t" + "movdqa 0x20(%[x]),%%xmm2\n\t" + "movdqa 0x30(%[x]),%%xmm3\n\t" + "movdqa 0x40(%[x]),%%xmm4\n\t" + "movdqa 0x50(%[x]),%%xmm5\n\t" + "movdqa 0x60(%[x]),%%xmm6\n\t" + "movdqa 0x70(%[x]),%%xmm7\n\t" + /*Add two extra bits of working precision to improve accuracy; any more and + we could overflow.*/ + /*We also add a few biases to correct for some systematic error that + remains in the full fDCT->iDCT round trip.*/ + /*xmm15={0}x8*/ + "pxor %%xmm15,%%xmm15\n\t" + /*xmm14={-1}x8*/ + "pcmpeqb %%xmm14,%%xmm14\n\t" + "psllw $2,%%xmm0\n\t" + /*xmm8=xmm0*/ + "movdqa %%xmm0,%%xmm8\n\t" + "psllw $2,%%xmm1\n\t" + /*xmm8={_x[7...0]==0}*/ + "pcmpeqw %%xmm15,%%xmm8\n\t" + "psllw $2,%%xmm2\n\t" + /*xmm8={_x[7...0]!=0}*/ + "psubw %%xmm14,%%xmm8\n\t" + "psllw $2,%%xmm3\n\t" + /*%[a]=1*/ + "mov $1,%[a]\n\t" + /*xmm8={_x[6]!=0,0,_x[4]!=0,0,_x[2]!=0,0,_x[0]!=0,0}*/ + "pslld $16,%%xmm8\n\t" + "psllw $2,%%xmm4\n\t" + /*xmm9={0,0,0,0,0,0,0,1}*/ + "movd %[a],%%xmm9\n\t" + /*xmm8={0,0,_x[2]!=0,0,_x[0]!=0,0}*/ + "pshufhw $0x00,%%xmm8,%%xmm8\n\t" + "psllw $2,%%xmm5\n\t" + /*%[a]={1}x2*/ + "mov $0x10001,%[a]\n\t" + /*xmm8={0,0,0,0,0,0,0,_x[0]!=0}*/ + "pshuflw $0x01,%%xmm8,%%xmm8\n\t" + "psllw $2,%%xmm6\n\t" + /*xmm10={0,0,0,0,0,0,1,1}*/ + "movd %[a],%%xmm10\n\t" + /*xmm0=_x[7...0]+{0,0,0,0,0,0,0,_x[0]!=0}*/ + "paddw %%xmm8,%%xmm0\n\t" + "psllw $2,%%xmm7\n\t" + /*xmm0=_x[7...0]+{0,0,0,0,0,0,1,(_x[0]!=0)+1}*/ + "paddw %%xmm10,%%xmm0\n\t" + /*xmm1=_x[15...8]-{0,0,0,0,0,0,0,1}*/ + "psubw %%xmm9,%%xmm1\n\t" + /*Transform columns.*/ + OC_FDCT8x8 + /*Transform rows.*/ + OC_TRANSPOSE8x8 + OC_FDCT8x8 + /*TODO: zig-zag ordering?*/ + OC_TRANSPOSE8x8 + /*xmm14={-2,-2,-2,-2,-2,-2,-2,-2}*/ + "paddw %%xmm14,%%xmm14\n\t" + "psubw %%xmm14,%%xmm0\n\t" + "psubw %%xmm14,%%xmm1\n\t" + "psraw $2,%%xmm0\n\t" + "psubw %%xmm14,%%xmm2\n\t" + "psraw $2,%%xmm1\n\t" + "psubw %%xmm14,%%xmm3\n\t" + "psraw $2,%%xmm2\n\t" + "psubw %%xmm14,%%xmm4\n\t" + "psraw $2,%%xmm3\n\t" + "psubw %%xmm14,%%xmm5\n\t" + "psraw $2,%%xmm4\n\t" + "psubw %%xmm14,%%xmm6\n\t" + "psraw $2,%%xmm5\n\t" + "psubw %%xmm14,%%xmm7\n\t" + "psraw $2,%%xmm6\n\t" + "psraw $2,%%xmm7\n\t" + /*Store the result.*/ + "movdqa %%xmm0,0x00(%[y])\n\t" + "movdqa %%xmm1,0x10(%[y])\n\t" + "movdqa %%xmm2,0x20(%[y])\n\t" + "movdqa %%xmm3,0x30(%[y])\n\t" + "movdqa %%xmm4,0x40(%[y])\n\t" + "movdqa %%xmm5,0x50(%[y])\n\t" + "movdqa %%xmm6,0x60(%[y])\n\t" + "movdqa %%xmm7,0x70(%[y])\n\t" + :[a]"=&r"(a) + :[y]"r"(_y),[x]"r"(_x) + :"memory" + ); +} +#endif diff --git a/libs/libtheora-1.1/lib/x86/x86enc.c b/libs/libtheora-1.1/lib/x86/x86enc.c new file mode 100644 index 00000000..43b7be3e --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/x86enc.c @@ -0,0 +1,49 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86state.c 15675 2009-02-06 09:43:27Z tterribe $ + + ********************************************************************/ +#include "x86enc.h" + +#if defined(OC_X86_ASM) + +#include "../cpu.c" + +void oc_enc_vtable_init_x86(oc_enc_ctx *_enc){ + ogg_uint32_t cpu_flags; + cpu_flags=oc_cpu_flags_get(); + oc_enc_vtable_init_c(_enc); + if(cpu_flags&OC_CPU_X86_MMX){ + _enc->opt_vtable.frag_sub=oc_enc_frag_sub_mmx; + _enc->opt_vtable.frag_sub_128=oc_enc_frag_sub_128_mmx; + _enc->opt_vtable.frag_recon_intra=oc_frag_recon_intra_mmx; + _enc->opt_vtable.frag_recon_inter=oc_frag_recon_inter_mmx; + _enc->opt_vtable.fdct8x8=oc_enc_fdct8x8_mmx; + } + if(cpu_flags&OC_CPU_X86_MMXEXT){ + _enc->opt_vtable.frag_sad=oc_enc_frag_sad_mmxext; + _enc->opt_vtable.frag_sad_thresh=oc_enc_frag_sad_thresh_mmxext; + _enc->opt_vtable.frag_sad2_thresh=oc_enc_frag_sad2_thresh_mmxext; + _enc->opt_vtable.frag_satd_thresh=oc_enc_frag_satd_thresh_mmxext; + _enc->opt_vtable.frag_satd2_thresh=oc_enc_frag_satd2_thresh_mmxext; + _enc->opt_vtable.frag_intra_satd=oc_enc_frag_intra_satd_mmxext; + _enc->opt_vtable.frag_copy2=oc_enc_frag_copy2_mmxext; + } + if(cpu_flags&OC_CPU_X86_SSE2){ +# if defined(OC_X86_64_ASM) + /*_enc->opt_vtable.fdct8x8=oc_enc_fdct8x8_x86_64sse2;*/ +# endif + } +} +#endif diff --git a/libs/libtheora-1.1/lib/x86/x86enc.h b/libs/libtheora-1.1/lib/x86/x86enc.h new file mode 100644 index 00000000..06c3908b --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/x86enc.h @@ -0,0 +1,47 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86int.h 15675 2009-02-06 09:43:27Z tterribe $ + + ********************************************************************/ + +#if !defined(_x86_x86enc_H) +# define _x86_x86enc_H (1) +# include "../encint.h" +# include "x86int.h" + +void oc_enc_vtable_init_x86(oc_enc_ctx *_enc); + +unsigned oc_enc_frag_sad_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride); +unsigned oc_enc_frag_sad_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_sad2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_satd_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_satd2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_intra_satd_mmxext(const unsigned char *_src,int _ystride); +void oc_enc_frag_sub_mmx(ogg_int16_t _diff[64], + const unsigned char *_x,const unsigned char *_y,int _stride); +void oc_enc_frag_sub_128_mmx(ogg_int16_t _diff[64], + const unsigned char *_x,int _stride); +void oc_enc_frag_copy2_mmxext(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride); +void oc_enc_fdct8x8_mmx(ogg_int16_t _y[64],const ogg_int16_t _x[64]); +void oc_enc_fdct8x8_x86_64sse2(ogg_int16_t _y[64],const ogg_int16_t _x[64]); + +#endif diff --git a/libs/libtheora-1.1/lib/x86/x86int.h b/libs/libtheora-1.1/lib/x86/x86int.h new file mode 100644 index 00000000..5ca30ac7 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/x86int.h @@ -0,0 +1,42 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86int.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_x86_x86int_H) +# define _x86_x86int_H (1) +# include "../internal.h" + +void oc_state_vtable_init_x86(oc_theora_state *_state); + +void oc_frag_copy_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride); +void oc_frag_recon_intra_mmx(unsigned char *_dst,int _ystride, + const ogg_int16_t *_residue); +void oc_frag_recon_inter_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t *_residue); +void oc_frag_recon_inter2_mmx(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t *_residue); +void oc_idct8x8_mmx(ogg_int16_t _y[64],int _last_zzi); +void oc_state_frag_recon_mmx(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant); +void oc_state_frag_copy_list_mmx(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli); +void oc_state_loop_filter_frag_rows_mmx(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end); +void oc_restore_fpu_mmx(void); + +#endif diff --git a/libs/libtheora-1.1/lib/x86/x86state.c b/libs/libtheora-1.1/lib/x86/x86state.c new file mode 100644 index 00000000..8450b644 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86/x86state.c @@ -0,0 +1,62 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86state.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include "x86int.h" + +#if defined(OC_X86_ASM) + +#include "../cpu.c" + +/*This table has been modified from OC_FZIG_ZAG by baking a 4x4 transpose into + each quadrant of the destination.*/ +static const unsigned char OC_FZIG_ZAG_MMX[128]={ + 0, 8, 1, 2, 9,16,24,17, + 10, 3,32,11,18,25, 4,12, + 5,26,19,40,33,34,41,48, + 27, 6,13,20,28,21,14, 7, + 56,49,42,35,43,50,57,36, + 15,22,29,30,23,44,37,58, + 51,59,38,45,52,31,60,53, + 46,39,47,54,61,62,55,63, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, +}; + +void oc_state_vtable_init_x86(oc_theora_state *_state){ + _state->cpu_flags=oc_cpu_flags_get(); + if(_state->cpu_flags&OC_CPU_X86_MMX){ + _state->opt_vtable.frag_copy=oc_frag_copy_mmx; + _state->opt_vtable.frag_recon_intra=oc_frag_recon_intra_mmx; + _state->opt_vtable.frag_recon_inter=oc_frag_recon_inter_mmx; + _state->opt_vtable.frag_recon_inter2=oc_frag_recon_inter2_mmx; + _state->opt_vtable.idct8x8=oc_idct8x8_mmx; + _state->opt_vtable.state_frag_recon=oc_state_frag_recon_mmx; + _state->opt_vtable.state_frag_copy_list=oc_state_frag_copy_list_mmx; + _state->opt_vtable.state_loop_filter_frag_rows= + oc_state_loop_filter_frag_rows_mmx; + _state->opt_vtable.restore_fpu=oc_restore_fpu_mmx; + _state->opt_data.dct_fzig_zag=OC_FZIG_ZAG_MMX; + } + else oc_state_vtable_init_c(_state); +} +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxencfrag.c b/libs/libtheora-1.1/lib/x86_vc/mmxencfrag.c new file mode 100644 index 00000000..ac9dacf3 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxencfrag.c @@ -0,0 +1,969 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: dsp_mmx.c 14579 2008-03-12 06:42:40Z xiphmont $ + + ********************************************************************/ +#include +#include "x86enc.h" + +#if defined(OC_X86_ASM) + +unsigned oc_enc_frag_sad_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride){ + ptrdiff_t ret; + __asm{ +#define SRC esi +#define REF edx +#define YSTRIDE ecx +#define YSTRIDE3 edi + mov YSTRIDE,_ystride + mov SRC,_src + mov REF,_ref + /*Load the first 4 rows of each block.*/ + movq mm0,[SRC] + movq mm1,[REF] + movq mm2,[SRC][YSTRIDE] + movq mm3,[REF][YSTRIDE] + lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] + movq mm4,[SRC+YSTRIDE*2] + movq mm5,[REF+YSTRIDE*2] + movq mm6,[SRC+YSTRIDE3] + movq mm7,[REF+YSTRIDE3] + /*Compute their SADs and add them in mm0*/ + psadbw mm0,mm1 + psadbw mm2,mm3 + lea SRC,[SRC+YSTRIDE*4] + paddw mm0,mm2 + lea REF,[REF+YSTRIDE*4] + /*Load the next 3 rows as registers become available.*/ + movq mm2,[SRC] + movq mm3,[REF] + psadbw mm4,mm5 + psadbw mm6,mm7 + paddw mm0,mm4 + movq mm5,[REF+YSTRIDE] + movq mm4,[SRC+YSTRIDE] + paddw mm0,mm6 + movq mm7,[REF+YSTRIDE*2] + movq mm6,[SRC+YSTRIDE*2] + /*Start adding their SADs to mm0*/ + psadbw mm2,mm3 + psadbw mm4,mm5 + paddw mm0,mm2 + psadbw mm6,mm7 + /*Load last row as registers become available.*/ + movq mm2,[SRC+YSTRIDE3] + movq mm3,[REF+YSTRIDE3] + /*And finish adding up their SADs.*/ + paddw mm0,mm4 + psadbw mm2,mm3 + paddw mm0,mm6 + paddw mm0,mm2 + movd [ret],mm0 +#undef SRC +#undef REF +#undef YSTRIDE +#undef YSTRIDE3 + } + return (unsigned)ret; +} + +unsigned oc_enc_frag_sad_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + /*Early termination is for suckers.*/ + return oc_enc_frag_sad_mmxext(_src,_ref,_ystride); +} + +#define OC_SAD2_LOOP __asm{ \ + /*We want to compute (mm0+mm1>>1) on unsigned bytes without overflow, but \ + pavgb computes (mm0+mm1+1>>1). \ + The latter is exactly 1 too large when the low bit of two corresponding \ + bytes is only set in one of them. \ + Therefore we pxor the operands, pand to mask out the low bits, and psubb to \ + correct the output of pavgb.*/ \ + __asm movq mm6,mm0 \ + __asm lea REF1,[REF1+YSTRIDE*2] \ + __asm pxor mm0,mm1 \ + __asm pavgb mm6,mm1 \ + __asm lea REF2,[REF2+YSTRIDE*2] \ + __asm movq mm1,mm2 \ + __asm pand mm0,mm7 \ + __asm pavgb mm2,mm3 \ + __asm pxor mm1,mm3 \ + __asm movq mm3,[REF2+YSTRIDE] \ + __asm psubb mm6,mm0 \ + __asm movq mm0,[REF1] \ + __asm pand mm1,mm7 \ + __asm psadbw mm4,mm6 \ + __asm movd mm6,RET \ + __asm psubb mm2,mm1 \ + __asm movq mm1,[REF2] \ + __asm lea SRC,[SRC+YSTRIDE*2] \ + __asm psadbw mm5,mm2 \ + __asm movq mm2,[REF1+YSTRIDE] \ + __asm paddw mm5,mm4 \ + __asm movq mm4,[SRC] \ + __asm paddw mm6,mm5 \ + __asm movq mm5,[SRC+YSTRIDE] \ + __asm movd RET,mm6 \ +} + +/*Same as above, but does not pre-load the next two rows.*/ +#define OC_SAD2_TAIL __asm{ \ + __asm movq mm6,mm0 \ + __asm pavgb mm0,mm1 \ + __asm pxor mm6,mm1 \ + __asm movq mm1,mm2 \ + __asm pand mm6,mm7 \ + __asm pavgb mm2,mm3 \ + __asm pxor mm1,mm3 \ + __asm psubb mm0,mm6 \ + __asm pand mm1,mm7 \ + __asm psadbw mm4,mm0 \ + __asm psubb mm2,mm1 \ + __asm movd mm6,RET \ + __asm psadbw mm5,mm2 \ + __asm paddw mm5,mm4 \ + __asm paddw mm6,mm5 \ + __asm movd RET,mm6 \ +} + +unsigned oc_enc_frag_sad2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + ptrdiff_t ret; + __asm{ +#define REF1 ecx +#define REF2 edi +#define YSTRIDE esi +#define SRC edx +#define RET eax + mov YSTRIDE,_ystride + mov SRC,_src + mov REF1,_ref1 + mov REF2,_ref2 + movq mm0,[REF1] + movq mm1,[REF2] + movq mm2,[REF1+YSTRIDE] + movq mm3,[REF2+YSTRIDE] + xor RET,RET + movq mm4,[SRC] + pxor mm7,mm7 + pcmpeqb mm6,mm6 + movq mm5,[SRC+YSTRIDE] + psubb mm7,mm6 + OC_SAD2_LOOP + OC_SAD2_LOOP + OC_SAD2_LOOP + OC_SAD2_TAIL + mov [ret],RET +#undef REF1 +#undef REF2 +#undef YSTRIDE +#undef SRC +#undef RET + } + return (unsigned)ret; +} + +/*Load an 8x4 array of pixel values from %[src] and %[ref] and compute their + 16-bit difference in mm0...mm7.*/ +#define OC_LOAD_SUB_8x4(_off) __asm{ \ + __asm movd mm0,[_off+SRC] \ + __asm movd mm4,[_off+REF] \ + __asm movd mm1,[_off+SRC+SRC_YSTRIDE] \ + __asm lea SRC,[SRC+SRC_YSTRIDE*2] \ + __asm movd mm5,[_off+REF+REF_YSTRIDE] \ + __asm lea REF,[REF+REF_YSTRIDE*2] \ + __asm movd mm2,[_off+SRC] \ + __asm movd mm7,[_off+REF] \ + __asm movd mm3,[_off+SRC+SRC_YSTRIDE] \ + __asm movd mm6,[_off+REF+REF_YSTRIDE] \ + __asm punpcklbw mm0,mm4 \ + __asm lea SRC,[SRC+SRC_YSTRIDE*2] \ + __asm punpcklbw mm4,mm4 \ + __asm lea REF,[REF+REF_YSTRIDE*2] \ + __asm psubw mm0,mm4 \ + __asm movd mm4,[_off+SRC] \ + __asm movq [_off*2+BUF],mm0 \ + __asm movd mm0,[_off+REF] \ + __asm punpcklbw mm1,mm5 \ + __asm punpcklbw mm5,mm5 \ + __asm psubw mm1,mm5 \ + __asm movd mm5,[_off+SRC+SRC_YSTRIDE] \ + __asm punpcklbw mm2,mm7 \ + __asm punpcklbw mm7,mm7 \ + __asm psubw mm2,mm7 \ + __asm movd mm7,[_off+REF+REF_YSTRIDE] \ + __asm punpcklbw mm3,mm6 \ + __asm lea SRC,[SRC+SRC_YSTRIDE*2] \ + __asm punpcklbw mm6,mm6 \ + __asm psubw mm3,mm6 \ + __asm movd mm6,[_off+SRC] \ + __asm punpcklbw mm4,mm0 \ + __asm lea REF,[REF+REF_YSTRIDE*2] \ + __asm punpcklbw mm0,mm0 \ + __asm lea SRC,[SRC+SRC_YSTRIDE*2] \ + __asm psubw mm4,mm0 \ + __asm movd mm0,[_off+REF] \ + __asm punpcklbw mm5,mm7 \ + __asm neg SRC_YSTRIDE \ + __asm punpcklbw mm7,mm7 \ + __asm psubw mm5,mm7 \ + __asm movd mm7,[_off+SRC+SRC_YSTRIDE] \ + __asm punpcklbw mm6,mm0 \ + __asm lea REF,[REF+REF_YSTRIDE*2] \ + __asm punpcklbw mm0,mm0 \ + __asm neg REF_YSTRIDE \ + __asm psubw mm6,mm0 \ + __asm movd mm0,[_off+REF+REF_YSTRIDE] \ + __asm lea SRC,[SRC+SRC_YSTRIDE*8] \ + __asm punpcklbw mm7,mm0 \ + __asm neg SRC_YSTRIDE \ + __asm punpcklbw mm0,mm0 \ + __asm lea REF,[REF+REF_YSTRIDE*8] \ + __asm psubw mm7,mm0 \ + __asm neg REF_YSTRIDE \ + __asm movq mm0,[_off*2+BUF] \ +} + +/*Load an 8x4 array of pixel values from %[src] into %%mm0...%%mm7.*/ +#define OC_LOAD_8x4(_off) __asm{ \ + __asm movd mm0,[_off+SRC] \ + __asm movd mm1,[_off+SRC+YSTRIDE] \ + __asm movd mm2,[_off+SRC+YSTRIDE*2] \ + __asm pxor mm7,mm7 \ + __asm movd mm3,[_off+SRC+YSTRIDE3] \ + __asm punpcklbw mm0,mm7 \ + __asm movd mm4,[_off+SRC4] \ + __asm punpcklbw mm1,mm7 \ + __asm movd mm5,[_off+SRC4+YSTRIDE] \ + __asm punpcklbw mm2,mm7 \ + __asm movd mm6,[_off+SRC4+YSTRIDE*2] \ + __asm punpcklbw mm3,mm7 \ + __asm movd mm7,[_off+SRC4+YSTRIDE3] \ + __asm punpcklbw mm4,mm4 \ + __asm punpcklbw mm5,mm5 \ + __asm psrlw mm4,8 \ + __asm psrlw mm5,8 \ + __asm punpcklbw mm6,mm6 \ + __asm punpcklbw mm7,mm7 \ + __asm psrlw mm6,8 \ + __asm psrlw mm7,8 \ +} + +/*Performs the first two stages of an 8-point 1-D Hadamard transform. + The transform is performed in place, except that outputs 0-3 are swapped with + outputs 4-7. + Outputs 2, 3, 6 and 7 from the second stage are negated (which allows us to + perform this stage in place with no temporary registers).*/ +#define OC_HADAMARD_AB_8x4 __asm{ \ + /*Stage A: \ + Outputs 0-3 are swapped with 4-7 here.*/ \ + __asm paddw mm5,mm1 \ + __asm paddw mm6,mm2 \ + __asm paddw mm1,mm1 \ + __asm paddw mm2,mm2 \ + __asm psubw mm1,mm5 \ + __asm psubw mm2,mm6 \ + __asm paddw mm7,mm3 \ + __asm paddw mm4,mm0 \ + __asm paddw mm3,mm3 \ + __asm paddw mm0,mm0 \ + __asm psubw mm3,mm7 \ + __asm psubw mm0,mm4 \ + /*Stage B:*/ \ + __asm paddw mm0,mm2 \ + __asm paddw mm1,mm3 \ + __asm paddw mm4,mm6 \ + __asm paddw mm5,mm7 \ + __asm paddw mm2,mm2 \ + __asm paddw mm3,mm3 \ + __asm paddw mm6,mm6 \ + __asm paddw mm7,mm7 \ + __asm psubw mm2,mm0 \ + __asm psubw mm3,mm1 \ + __asm psubw mm6,mm4 \ + __asm psubw mm7,mm5 \ +} + +/*Performs the last stage of an 8-point 1-D Hadamard transform in place. + Ouputs 1, 3, 5, and 7 are negated (which allows us to perform this stage in + place with no temporary registers).*/ +#define OC_HADAMARD_C_8x4 __asm{ \ + /*Stage C:*/ \ + __asm paddw mm0,mm1 \ + __asm paddw mm2,mm3 \ + __asm paddw mm4,mm5 \ + __asm paddw mm6,mm7 \ + __asm paddw mm1,mm1 \ + __asm paddw mm3,mm3 \ + __asm paddw mm5,mm5 \ + __asm paddw mm7,mm7 \ + __asm psubw mm1,mm0 \ + __asm psubw mm3,mm2 \ + __asm psubw mm5,mm4 \ + __asm psubw mm7,mm6 \ +} + +/*Performs an 8-point 1-D Hadamard transform. + The transform is performed in place, except that outputs 0-3 are swapped with + outputs 4-7. + Outputs 1, 2, 5 and 6 are negated (which allows us to perform the transform + in place with no temporary registers).*/ +#define OC_HADAMARD_8x4 __asm{ \ + OC_HADAMARD_AB_8x4 \ + OC_HADAMARD_C_8x4 \ +} + +/*Performs the first part of the final stage of the Hadamard transform and + summing of absolute values. + At the end of this part, mm1 will contain the DC coefficient of the + transform.*/ +#define OC_HADAMARD_C_ABS_ACCUM_A_8x4(_r6,_r7) __asm{ \ + /*We use the fact that \ + (abs(a+b)+abs(a-b))/2=max(abs(a),abs(b)) \ + to merge the final butterfly with the abs and the first stage of \ + accumulation. \ + Thus we can avoid using pabsw, which is not available until SSSE3. \ + Emulating pabsw takes 3 instructions, so the straightforward MMXEXT \ + implementation would be (3+3)*8+7=55 instructions (+4 for spilling \ + registers). \ + Even with pabsw, it would be (3+1)*8+7=39 instructions (with no spills). \ + This implementation is only 26 (+4 for spilling registers).*/ \ + __asm movq [_r7+BUF],mm7 \ + __asm movq [_r6+BUF],mm6 \ + /*mm7={0x7FFF}x4 \ + mm0=max(abs(mm0),abs(mm1))-0x7FFF*/ \ + __asm pcmpeqb mm7,mm7 \ + __asm movq mm6,mm0 \ + __asm psrlw mm7,1 \ + __asm paddw mm6,mm1 \ + __asm pmaxsw mm0,mm1 \ + __asm paddsw mm6,mm7 \ + __asm psubw mm0,mm6 \ + /*mm2=max(abs(mm2),abs(mm3))-0x7FFF \ + mm4=max(abs(mm4),abs(mm5))-0x7FFF*/ \ + __asm movq mm6,mm2 \ + __asm movq mm1,mm4 \ + __asm pmaxsw mm2,mm3 \ + __asm pmaxsw mm4,mm5 \ + __asm paddw mm6,mm3 \ + __asm paddw mm1,mm5 \ + __asm movq mm3,[_r7+BUF] \ +} + +/*Performs the second part of the final stage of the Hadamard transform and + summing of absolute values.*/ +#define OC_HADAMARD_C_ABS_ACCUM_B_8x4(_r6,_r7) __asm{ \ + __asm paddsw mm6,mm7 \ + __asm movq mm5,[_r6+BUF] \ + __asm paddsw mm1,mm7 \ + __asm psubw mm2,mm6 \ + __asm psubw mm4,mm1 \ + /*mm7={1}x4 (needed for the horizontal add that follows) \ + mm0+=mm2+mm4+max(abs(mm3),abs(mm5))-0x7FFF*/ \ + __asm movq mm6,mm3 \ + __asm pmaxsw mm3,mm5 \ + __asm paddw mm0,mm2 \ + __asm paddw mm6,mm5 \ + __asm paddw mm0,mm4 \ + __asm paddsw mm6,mm7 \ + __asm paddw mm0,mm3 \ + __asm psrlw mm7,14 \ + __asm psubw mm0,mm6 \ +} + +/*Performs the last stage of an 8-point 1-D Hadamard transform, takes the + absolute value of each component, and accumulates everything into mm0. + This is the only portion of SATD which requires MMXEXT (we could use plain + MMX, but it takes 4 instructions and an extra register to work around the + lack of a pmaxsw, which is a pretty serious penalty).*/ +#define OC_HADAMARD_C_ABS_ACCUM_8x4(_r6,_r7) __asm{ \ + OC_HADAMARD_C_ABS_ACCUM_A_8x4(_r6,_r7) \ + OC_HADAMARD_C_ABS_ACCUM_B_8x4(_r6,_r7) \ +} + +/*Performs an 8-point 1-D Hadamard transform, takes the absolute value of each + component, and accumulates everything into mm0. + Note that mm0 will have an extra 4 added to each column, and that after + removing this value, the remainder will be half the conventional value.*/ +#define OC_HADAMARD_ABS_ACCUM_8x4(_r6,_r7) __asm{ \ + OC_HADAMARD_AB_8x4 \ + OC_HADAMARD_C_ABS_ACCUM_8x4(_r6,_r7) \ +} + +/*Performs two 4x4 transposes (mostly) in place. + On input, {mm0,mm1,mm2,mm3} contains rows {e,f,g,h}, and {mm4,mm5,mm6,mm7} + contains rows {a,b,c,d}. + On output, {0x40,0x50,0x60,0x70}+_off+BUF contains {e,f,g,h}^T, and + {mm4,mm5,mm6,mm7} contains the transposed rows {a,b,c,d}^T.*/ +#define OC_TRANSPOSE_4x4x2(_off) __asm{ \ + /*First 4x4 transpose:*/ \ + __asm movq [0x10+_off+BUF],mm5 \ + /*mm0 = e3 e2 e1 e0 \ + mm1 = f3 f2 f1 f0 \ + mm2 = g3 g2 g1 g0 \ + mm3 = h3 h2 h1 h0*/ \ + __asm movq mm5,mm2 \ + __asm punpcklwd mm2,mm3 \ + __asm punpckhwd mm5,mm3 \ + __asm movq mm3,mm0 \ + __asm punpcklwd mm0,mm1 \ + __asm punpckhwd mm3,mm1 \ + /*mm0 = f1 e1 f0 e0 \ + mm3 = f3 e3 f2 e2 \ + mm2 = h1 g1 h0 g0 \ + mm5 = h3 g3 h2 g2*/ \ + __asm movq mm1,mm0 \ + __asm punpckldq mm0,mm2 \ + __asm punpckhdq mm1,mm2 \ + __asm movq mm2,mm3 \ + __asm punpckhdq mm3,mm5 \ + __asm movq [0x40+_off+BUF],mm0 \ + __asm punpckldq mm2,mm5 \ + /*mm0 = h0 g0 f0 e0 \ + mm1 = h1 g1 f1 e1 \ + mm2 = h2 g2 f2 e2 \ + mm3 = h3 g3 f3 e3*/ \ + __asm movq mm5,[0x10+_off+BUF] \ + /*Second 4x4 transpose:*/ \ + /*mm4 = a3 a2 a1 a0 \ + mm5 = b3 b2 b1 b0 \ + mm6 = c3 c2 c1 c0 \ + mm7 = d3 d2 d1 d0*/ \ + __asm movq mm0,mm6 \ + __asm punpcklwd mm6,mm7 \ + __asm movq [0x50+_off+BUF],mm1 \ + __asm punpckhwd mm0,mm7 \ + __asm movq mm7,mm4 \ + __asm punpcklwd mm4,mm5 \ + __asm movq [0x60+_off+BUF],mm2 \ + __asm punpckhwd mm7,mm5 \ + /*mm4 = b1 a1 b0 a0 \ + mm7 = b3 a3 b2 a2 \ + mm6 = d1 c1 d0 c0 \ + mm0 = d3 c3 d2 c2*/ \ + __asm movq mm5,mm4 \ + __asm punpckldq mm4,mm6 \ + __asm movq [0x70+_off+BUF],mm3 \ + __asm punpckhdq mm5,mm6 \ + __asm movq mm6,mm7 \ + __asm punpckhdq mm7,mm0 \ + __asm punpckldq mm6,mm0 \ + /*mm4 = d0 c0 b0 a0 \ + mm5 = d1 c1 b1 a1 \ + mm6 = d2 c2 b2 a2 \ + mm7 = d3 c3 b3 a3*/ \ +} + +static unsigned oc_int_frag_satd_thresh_mmxext(const unsigned char *_src, + int _src_ystride,const unsigned char *_ref,int _ref_ystride,unsigned _thresh){ + OC_ALIGN8(ogg_int16_t buf[64]); + ogg_int16_t *bufp; + unsigned ret1; + unsigned ret2; + bufp=buf; + __asm{ +#define SRC esi +#define REF eax +#define SRC_YSTRIDE ecx +#define REF_YSTRIDE edx +#define BUF edi +#define RET eax +#define RET2 edx + mov SRC,_src + mov SRC_YSTRIDE,_src_ystride + mov REF,_ref + mov REF_YSTRIDE,_ref_ystride + mov BUF,bufp + OC_LOAD_SUB_8x4(0x00) + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2(0x00) + /*Finish swapping out this 8x4 block to make room for the next one. + mm0...mm3 have been swapped out already.*/ + movq [0x00+BUF],mm4 + movq [0x10+BUF],mm5 + movq [0x20+BUF],mm6 + movq [0x30+BUF],mm7 + OC_LOAD_SUB_8x4(0x04) + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2(0x08) + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, so + we only have to do half the loads.*/ + movq mm1,[0x10+BUF] + movq mm2,[0x20+BUF] + movq mm3,[0x30+BUF] + movq mm0,[0x00+BUF] + OC_HADAMARD_ABS_ACCUM_8x4(0x28,0x38) + /*Up to this point, everything fit in 16 bits (8 input + 1 for the + difference + 2*3 for the two 8-point 1-D Hadamards - 1 for the abs - 1 + for the factor of two we dropped + 3 for the vertical accumulation). + Now we finally have to promote things to dwords. + We break this part out of OC_HADAMARD_ABS_ACCUM_8x4 to hide the long + latency of pmaddwd by starting the next series of loads now.*/ + mov RET2,_thresh + pmaddwd mm0,mm7 + movq mm1,[0x50+BUF] + movq mm5,[0x58+BUF] + movq mm4,mm0 + movq mm2,[0x60+BUF] + punpckhdq mm0,mm0 + movq mm6,[0x68+BUF] + paddd mm4,mm0 + movq mm3,[0x70+BUF] + movd RET,mm4 + movq mm7,[0x78+BUF] + /*The sums produced by OC_HADAMARD_ABS_ACCUM_8x4 each have an extra 4 + added to them, and a factor of two removed; correct the final sum here.*/ + lea RET,[RET+RET-32] + movq mm0,[0x40+BUF] + cmp RET,RET2 + movq mm4,[0x48+BUF] + jae at_end + OC_HADAMARD_ABS_ACCUM_8x4(0x68,0x78) + pmaddwd mm0,mm7 + /*There isn't much to stick in here to hide the latency this time, but the + alternative to pmaddwd is movq->punpcklwd->punpckhwd->paddd, whose + latency is even worse.*/ + sub RET,32 + movq mm4,mm0 + punpckhdq mm0,mm0 + paddd mm4,mm0 + movd RET2,mm4 + lea RET,[RET+RET2*2] + align 16 +at_end: + mov ret1,RET +#undef SRC +#undef REF +#undef SRC_YSTRIDE +#undef REF_YSTRIDE +#undef BUF +#undef RET +#undef RET2 + } + return ret1; +} + +unsigned oc_enc_frag_satd_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh){ + return oc_int_frag_satd_thresh_mmxext(_src,_ystride,_ref,_ystride,_thresh); +} + + +/*Our internal implementation of frag_copy2 takes an extra stride parameter so + we can share code with oc_enc_frag_satd2_thresh_mmxext().*/ +static void oc_int_frag_copy2_mmxext(unsigned char *_dst,int _dst_ystride, + const unsigned char *_src1,const unsigned char *_src2,int _src_ystride){ + __asm{ + /*Load the first 3 rows.*/ +#define DST_YSTRIDE edi +#define SRC_YSTRIDE esi +#define DST eax +#define SRC1 edx +#define SRC2 ecx + mov DST_YSTRIDE,_dst_ystride + mov SRC_YSTRIDE,_src_ystride + mov DST,_dst + mov SRC1,_src1 + mov SRC2,_src2 + movq mm0,[SRC1] + movq mm1,[SRC2] + movq mm2,[SRC1+SRC_YSTRIDE] + lea SRC1,[SRC1+SRC_YSTRIDE*2] + movq mm3,[SRC2+SRC_YSTRIDE] + lea SRC2,[SRC2+SRC_YSTRIDE*2] + pxor mm7,mm7 + movq mm4,[SRC1] + pcmpeqb mm6,mm6 + movq mm5,[SRC2] + /*mm7={1}x8.*/ + psubb mm7,mm6 + /*Start averaging mm0 and mm1 into mm6.*/ + movq mm6,mm0 + pxor mm0,mm1 + pavgb mm6,mm1 + /*mm1 is free, start averaging mm3 into mm2 using mm1.*/ + movq mm1,mm2 + pand mm0,mm7 + pavgb mm2,mm3 + pxor mm1,mm3 + /*mm3 is free.*/ + psubb mm6,mm0 + /*mm0 is free, start loading the next row.*/ + movq mm0,[SRC1+SRC_YSTRIDE] + /*Start averaging mm5 and mm4 using mm3.*/ + movq mm3,mm4 + /*mm6 [row 0] is done; write it out.*/ + movq [DST],mm6 + pand mm1,mm7 + pavgb mm4,mm5 + psubb mm2,mm1 + /*mm1 is free, continue loading the next row.*/ + movq mm1,[SRC2+SRC_YSTRIDE] + pxor mm3,mm5 + lea SRC1,[SRC1+SRC_YSTRIDE*2] + /*mm2 [row 1] is done; write it out.*/ + movq [DST+DST_YSTRIDE],mm2 + pand mm3,mm7 + /*Start loading the next row.*/ + movq mm2,[SRC1] + lea DST,[DST+DST_YSTRIDE*2] + psubb mm4,mm3 + lea SRC2,[SRC2+SRC_YSTRIDE*2] + /*mm4 [row 2] is done; write it out.*/ + movq [DST],mm4 + /*Continue loading the next row.*/ + movq mm3,[SRC2] + /*Start averaging mm0 and mm1 into mm6.*/ + movq mm6,mm0 + pxor mm0,mm1 + /*Start loading the next row.*/ + movq mm4,[SRC1+SRC_YSTRIDE] + pavgb mm6,mm1 + /*mm1 is free; start averaging mm3 into mm2 using mm1.*/ + movq mm1,mm2 + pand mm0,mm7 + /*Continue loading the next row.*/ + movq mm5,[SRC2+SRC_YSTRIDE] + pavgb mm2,mm3 + lea SRC1,[SRC1+SRC_YSTRIDE*2] + pxor mm1,mm3 + /*mm3 is free.*/ + psubb mm6,mm0 + /*mm0 is free, start loading the next row.*/ + movq mm0,[SRC1] + /*Start averaging mm5 into mm4 using mm3.*/ + movq mm3,mm4 + /*mm6 [row 3] is done; write it out.*/ + movq [DST+DST_YSTRIDE],mm6 + pand mm1,mm7 + lea SRC2,[SRC2+SRC_YSTRIDE*2] + pavgb mm4,mm5 + lea DST,[DST+DST_YSTRIDE*2] + psubb mm2,mm1 + /*mm1 is free; continue loading the next row.*/ + movq mm1,[SRC2] + pxor mm3,mm5 + /*mm2 [row 4] is done; write it out.*/ + movq [DST],mm2 + pand mm3,mm7 + /*Start loading the next row.*/ + movq mm2,[SRC1+SRC_YSTRIDE] + psubb mm4,mm3 + /*Start averaging mm0 and mm1 into mm6.*/ + movq mm6,mm0 + /*Continue loading the next row.*/ + movq mm3,[SRC2+SRC_YSTRIDE] + /*mm4 [row 5] is done; write it out.*/ + movq [DST+DST_YSTRIDE],mm4 + pxor mm0,mm1 + pavgb mm6,mm1 + /*mm4 is free; start averaging mm3 into mm2 using mm4.*/ + movq mm4,mm2 + pand mm0,mm7 + pavgb mm2,mm3 + pxor mm4,mm3 + lea DST,[DST+DST_YSTRIDE*2] + psubb mm6,mm0 + pand mm4,mm7 + /*mm6 [row 6] is done, write it out.*/ + movq [DST],mm6 + psubb mm2,mm4 + /*mm2 [row 7] is done, write it out.*/ + movq [DST+DST_YSTRIDE],mm2 +#undef SRC1 +#undef SRC2 +#undef SRC_YSTRIDE +#undef DST_YSTRIDE +#undef DST + } +} + +unsigned oc_enc_frag_satd2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh){ + OC_ALIGN8(unsigned char ref[64]); + oc_int_frag_copy2_mmxext(ref,8,_ref1,_ref2,_ystride); + return oc_int_frag_satd_thresh_mmxext(_src,_ystride,ref,8,_thresh); +} + +unsigned oc_enc_frag_intra_satd_mmxext(const unsigned char *_src, + int _ystride){ + OC_ALIGN8(ogg_int16_t buf[64]); + ogg_int16_t *bufp; + unsigned ret1; + unsigned ret2; + bufp=buf; + __asm{ +#define SRC eax +#define SRC4 esi +#define BUF edi +#define RET eax +#define RET_WORD ax +#define RET2 ecx +#define YSTRIDE edx +#define YSTRIDE3 ecx + mov SRC,_src + mov BUF,bufp + mov YSTRIDE,_ystride + /* src4 = src+4*ystride */ + lea SRC4,[SRC+YSTRIDE*4] + /* ystride3 = 3*ystride */ + lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] + OC_LOAD_8x4(0x00) + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2(0x00) + /*Finish swapping out this 8x4 block to make room for the next one. + mm0...mm3 have been swapped out already.*/ + movq [0x00+BUF],mm4 + movq [0x10+BUF],mm5 + movq [0x20+BUF],mm6 + movq [0x30+BUF],mm7 + OC_LOAD_8x4(0x04) + OC_HADAMARD_8x4 + OC_TRANSPOSE_4x4x2(0x08) + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, so + we only have to do half the loads.*/ + movq mm1,[0x10+BUF] + movq mm2,[0x20+BUF] + movq mm3,[0x30+BUF] + movq mm0,[0x00+BUF] + /*We split out the stages here so we can save the DC coefficient in the + middle.*/ + OC_HADAMARD_AB_8x4 + OC_HADAMARD_C_ABS_ACCUM_A_8x4(0x28,0x38) + movd RET,mm1 + OC_HADAMARD_C_ABS_ACCUM_B_8x4(0x28,0x38) + /*Up to this point, everything fit in 16 bits (8 input + 1 for the + difference + 2*3 for the two 8-point 1-D Hadamards - 1 for the abs - 1 + for the factor of two we dropped + 3 for the vertical accumulation). + Now we finally have to promote things to dwords. + We break this part out of OC_HADAMARD_ABS_ACCUM_8x4 to hide the long + latency of pmaddwd by starting the next series of loads now.*/ + pmaddwd mm0,mm7 + movq mm1,[0x50+BUF] + movq mm5,[0x58+BUF] + movq mm2,[0x60+BUF] + movq mm4,mm0 + movq mm6,[0x68+BUF] + punpckhdq mm0,mm0 + movq mm3,[0x70+BUF] + paddd mm4,mm0 + movq mm7,[0x78+BUF] + movd RET2,mm4 + movq mm0,[0x40+BUF] + movq mm4,[0x48+BUF] + OC_HADAMARD_ABS_ACCUM_8x4(0x68,0x78) + pmaddwd mm0,mm7 + /*We assume that the DC coefficient is always positive (which is true, + because the input to the INTRA transform was not a difference).*/ + movzx RET,RET_WORD + add RET2,RET2 + sub RET2,RET + movq mm4,mm0 + punpckhdq mm0,mm0 + paddd mm4,mm0 + movd RET,mm4 + lea RET,[-64+RET2+RET*2] + mov [ret1],RET +#undef SRC +#undef SRC4 +#undef BUF +#undef RET +#undef RET_WORD +#undef RET2 +#undef YSTRIDE +#undef YSTRIDE3 + } + return ret1; +} + +void oc_enc_frag_sub_mmx(ogg_int16_t _residue[64], + const unsigned char *_src, const unsigned char *_ref,int _ystride){ + int i; + __asm pxor mm7,mm7 + for(i=4;i-->0;){ + __asm{ +#define SRC edx +#define YSTRIDE esi +#define RESIDUE eax +#define REF ecx + mov YSTRIDE,_ystride + mov RESIDUE,_residue + mov SRC,_src + mov REF,_ref + /*mm0=[src]*/ + movq mm0,[SRC] + /*mm1=[ref]*/ + movq mm1,[REF] + /*mm4=[src+ystride]*/ + movq mm4,[SRC+YSTRIDE] + /*mm5=[ref+ystride]*/ + movq mm5,[REF+YSTRIDE] + /*Compute [src]-[ref].*/ + movq mm2,mm0 + punpcklbw mm0,mm7 + movq mm3,mm1 + punpckhbw mm2,mm7 + punpcklbw mm1,mm7 + punpckhbw mm3,mm7 + psubw mm0,mm1 + psubw mm2,mm3 + /*Compute [src+ystride]-[ref+ystride].*/ + movq mm1,mm4 + punpcklbw mm4,mm7 + movq mm3,mm5 + punpckhbw mm1,mm7 + lea SRC,[SRC+YSTRIDE*2] + punpcklbw mm5,mm7 + lea REF,[REF+YSTRIDE*2] + punpckhbw mm3,mm7 + psubw mm4,mm5 + psubw mm1,mm3 + /*Write the answer out.*/ + movq [RESIDUE+0x00],mm0 + movq [RESIDUE+0x08],mm2 + movq [RESIDUE+0x10],mm4 + movq [RESIDUE+0x18],mm1 + lea RESIDUE,[RESIDUE+0x20] + mov _residue,RESIDUE + mov _src,SRC + mov _ref,REF +#undef SRC +#undef YSTRIDE +#undef RESIDUE +#undef REF + } + } +} + +void oc_enc_frag_sub_128_mmx(ogg_int16_t _residue[64], + const unsigned char *_src,int _ystride){ + __asm{ +#define YSTRIDE edx +#define YSTRIDE3 edi +#define RESIDUE ecx +#define SRC eax + mov YSTRIDE,_ystride + mov RESIDUE,_residue + mov SRC,_src + /*mm0=[src]*/ + movq mm0,[SRC] + /*mm1=[src+ystride]*/ + movq mm1,[SRC+YSTRIDE] + /*mm6={-1}x4*/ + pcmpeqw mm6,mm6 + /*mm2=[src+2*ystride]*/ + movq mm2,[SRC+YSTRIDE*2] + /*[ystride3]=3*[ystride]*/ + lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] + /*mm6={1}x4*/ + psllw mm6,15 + /*mm3=[src+3*ystride]*/ + movq mm3,[SRC+YSTRIDE3] + /*mm6={128}x4*/ + psrlw mm6,8 + /*mm7=0*/ + pxor mm7,mm7 + /*[src]=[src]+4*[ystride]*/ + lea SRC,[SRC+YSTRIDE*4] + /*Compute [src]-128 and [src+ystride]-128*/ + movq mm4,mm0 + punpcklbw mm0,mm7 + movq mm5,mm1 + punpckhbw mm4,mm7 + psubw mm0,mm6 + punpcklbw mm1,mm7 + psubw mm4,mm6 + punpckhbw mm5,mm7 + psubw mm1,mm6 + psubw mm5,mm6 + /*Write the answer out.*/ + movq [RESIDUE+0x00],mm0 + movq [RESIDUE+0x08],mm4 + movq [RESIDUE+0x10],mm1 + movq [RESIDUE+0x18],mm5 + /*mm0=[src+4*ystride]*/ + movq mm0,[SRC] + /*mm1=[src+5*ystride]*/ + movq mm1,[SRC+YSTRIDE] + /*Compute [src+2*ystride]-128 and [src+3*ystride]-128*/ + movq mm4,mm2 + punpcklbw mm2,mm7 + movq mm5,mm3 + punpckhbw mm4,mm7 + psubw mm2,mm6 + punpcklbw mm3,mm7 + psubw mm4,mm6 + punpckhbw mm5,mm7 + psubw mm3,mm6 + psubw mm5,mm6 + /*Write the answer out.*/ + movq [RESIDUE+0x20],mm2 + movq [RESIDUE+0x28],mm4 + movq [RESIDUE+0x30],mm3 + movq [RESIDUE+0x38],mm5 + /*Compute [src+6*ystride]-128 and [src+7*ystride]-128*/ + movq mm2,[SRC+YSTRIDE*2] + movq mm3,[SRC+YSTRIDE3] + movq mm4,mm0 + punpcklbw mm0,mm7 + movq mm5,mm1 + punpckhbw mm4,mm7 + psubw mm0,mm6 + punpcklbw mm1,mm7 + psubw mm4,mm6 + punpckhbw mm5,mm7 + psubw mm1,mm6 + psubw mm5,mm6 + /*Write the answer out.*/ + movq [RESIDUE+0x40],mm0 + movq [RESIDUE+0x48],mm4 + movq [RESIDUE+0x50],mm1 + movq [RESIDUE+0x58],mm5 + /*Compute [src+6*ystride]-128 and [src+7*ystride]-128*/ + movq mm4,mm2 + punpcklbw mm2,mm7 + movq mm5,mm3 + punpckhbw mm4,mm7 + psubw mm2,mm6 + punpcklbw mm3,mm7 + psubw mm4,mm6 + punpckhbw mm5,mm7 + psubw mm3,mm6 + psubw mm5,mm6 + /*Write the answer out.*/ + movq [RESIDUE+0x60],mm2 + movq [RESIDUE+0x68],mm4 + movq [RESIDUE+0x70],mm3 + movq [RESIDUE+0x78],mm5 +#undef YSTRIDE +#undef YSTRIDE3 +#undef RESIDUE +#undef SRC + } +} + +void oc_enc_frag_copy2_mmxext(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride){ + oc_int_frag_copy2_mmxext(_dst,_ystride,_src1,_src2,_ystride); +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxfdct.c b/libs/libtheora-1.1/lib/x86_vc/mmxfdct.c new file mode 100644 index 00000000..dcf17c9f --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxfdct.c @@ -0,0 +1,670 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 1999-2006 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ********************************************************************/ + /*MMX fDCT implementation for x86_32*/ +/*$Id: fdct_ses2.c 14579 2008-03-12 06:42:40Z xiphmont $*/ +#include "x86enc.h" + +#if defined(OC_X86_ASM) + +#define OC_FDCT_STAGE1_8x4 __asm{ \ + /*Stage 1:*/ \ + /*mm0=t7'=t0-t7*/ \ + __asm psubw mm0,mm7 \ + __asm paddw mm7,mm7 \ + /*mm1=t6'=t1-t6*/ \ + __asm psubw mm1, mm6 \ + __asm paddw mm6,mm6 \ + /*mm2=t5'=t2-t5*/ \ + __asm psubw mm2,mm5 \ + __asm paddw mm5,mm5 \ + /*mm3=t4'=t3-t4*/ \ + __asm psubw mm3,mm4 \ + __asm paddw mm4,mm4 \ + /*mm7=t0'=t0+t7*/ \ + __asm paddw mm7,mm0 \ + /*mm6=t1'=t1+t6*/ \ + __asm paddw mm6,mm1 \ + /*mm5=t2'=t2+t5*/ \ + __asm paddw mm5,mm2 \ + /*mm4=t3'=t3+t4*/ \ + __asm paddw mm4,mm3\ +} + +#define OC_FDCT8x4(_r0,_r1,_r2,_r3,_r4,_r5,_r6,_r7) __asm{ \ + /*Stage 2:*/ \ + /*mm7=t3''=t0'-t3'*/ \ + __asm psubw mm7,mm4 \ + __asm paddw mm4,mm4 \ + /*mm6=t2''=t1'-t2'*/ \ + __asm psubw mm6,mm5 \ + __asm movq [Y+_r6],mm7 \ + __asm paddw mm5,mm5 \ + /*mm1=t5''=t6'-t5'*/ \ + __asm psubw mm1,mm2 \ + __asm movq [Y+_r2],mm6 \ + /*mm4=t0''=t0'+t3'*/ \ + __asm paddw mm4,mm7 \ + __asm paddw mm2,mm2 \ + /*mm5=t1''=t1'+t2'*/ \ + __asm movq [Y+_r0],mm4 \ + __asm paddw mm5,mm6 \ + /*mm2=t6''=t6'+t5'*/ \ + __asm paddw mm2,mm1 \ + __asm movq [Y+_r4],mm5 \ + /*mm0=t7', mm1=t5'', mm2=t6'', mm3=t4'.*/ \ + /*mm4, mm5, mm6, mm7 are free.*/ \ + /*Stage 3:*/ \ + /*mm6={2}x4, mm7={27146,0xB500>>1}x2*/ \ + __asm mov A,0x5A806A0A \ + __asm pcmpeqb mm6,mm6 \ + __asm movd mm7,A \ + __asm psrlw mm6,15 \ + __asm punpckldq mm7,mm7 \ + __asm paddw mm6,mm6 \ + /*mm0=0, m2={-1}x4 \ + mm5:mm4=t5''*27146+0xB500*/ \ + __asm movq mm4,mm1 \ + __asm movq mm5,mm1 \ + __asm punpcklwd mm4,mm6 \ + __asm movq [Y+_r3],mm2 \ + __asm pmaddwd mm4,mm7 \ + __asm movq [Y+_r7],mm0 \ + __asm punpckhwd mm5,mm6 \ + __asm pxor mm0,mm0 \ + __asm pmaddwd mm5,mm7 \ + __asm pcmpeqb mm2,mm2 \ + /*mm2=t6'', mm1=t5''+(t5''!=0) \ + mm4=(t5''*27146+0xB500>>16)*/ \ + __asm pcmpeqw mm0,mm1 \ + __asm psrad mm4,16 \ + __asm psubw mm0,mm2 \ + __asm movq mm2, [Y+_r3] \ + __asm psrad mm5,16 \ + __asm paddw mm1,mm0 \ + __asm packssdw mm4,mm5 \ + /*mm4=s=(t5''*27146+0xB500>>16)+t5''+(t5''!=0)>>1*/ \ + __asm paddw mm4,mm1 \ + __asm movq mm0, [Y+_r7] \ + __asm psraw mm4,1 \ + __asm movq mm1,mm3 \ + /*mm3=t4''=t4'+s*/ \ + __asm paddw mm3,mm4 \ + /*mm1=t5'''=t4'-s*/ \ + __asm psubw mm1,mm4 \ + /*mm1=0, mm3={-1}x4 \ + mm5:mm4=t6''*27146+0xB500*/ \ + __asm movq mm4,mm2 \ + __asm movq mm5,mm2 \ + __asm punpcklwd mm4,mm6 \ + __asm movq [Y+_r5],mm1 \ + __asm pmaddwd mm4,mm7 \ + __asm movq [Y+_r1],mm3 \ + __asm punpckhwd mm5,mm6 \ + __asm pxor mm1,mm1 \ + __asm pmaddwd mm5,mm7 \ + __asm pcmpeqb mm3,mm3 \ + /*mm2=t6''+(t6''!=0), mm4=(t6''*27146+0xB500>>16)*/ \ + __asm psrad mm4,16 \ + __asm pcmpeqw mm1,mm2 \ + __asm psrad mm5,16 \ + __asm psubw mm1,mm3 \ + __asm packssdw mm4,mm5 \ + __asm paddw mm2,mm1 \ + /*mm1=t1'' \ + mm4=s=(t6''*27146+0xB500>>16)+t6''+(t6''!=0)>>1*/ \ + __asm paddw mm4,mm2 \ + __asm movq mm1,[Y+_r4] \ + __asm psraw mm4,1 \ + __asm movq mm2,mm0 \ + /*mm7={54491-0x7FFF,0x7FFF}x2 \ + mm0=t7''=t7'+s*/ \ + __asm paddw mm0,mm4 \ + /*mm2=t6'''=t7'-s*/ \ + __asm psubw mm2,mm4 \ + /*Stage 4:*/ \ + /*mm0=0, mm2=t0'' \ + mm5:mm4=t1''*27146+0xB500*/ \ + __asm movq mm4,mm1 \ + __asm movq mm5,mm1 \ + __asm punpcklwd mm4,mm6 \ + __asm movq [Y+_r3],mm2 \ + __asm pmaddwd mm4,mm7 \ + __asm movq mm2,[Y+_r0] \ + __asm punpckhwd mm5,mm6 \ + __asm movq [Y+_r7],mm0 \ + __asm pmaddwd mm5,mm7 \ + __asm pxor mm0,mm0 \ + /*mm7={27146,0x4000>>1}x2 \ + mm0=s=(t1''*27146+0xB500>>16)+t1''+(t1''!=0)*/ \ + __asm psrad mm4,16 \ + __asm mov A,0x20006A0A \ + __asm pcmpeqw mm0,mm1 \ + __asm movd mm7,A \ + __asm psrad mm5,16 \ + __asm psubw mm0,mm3 \ + __asm packssdw mm4,mm5 \ + __asm paddw mm0,mm1 \ + __asm punpckldq mm7,mm7 \ + __asm paddw mm0,mm4 \ + /*mm6={0x00000E3D}x2 \ + mm1=-(t0''==0), mm5:mm4=t0''*27146+0x4000*/ \ + __asm movq mm4,mm2 \ + __asm movq mm5,mm2 \ + __asm punpcklwd mm4,mm6 \ + __asm mov A,0x0E3D \ + __asm pmaddwd mm4,mm7 \ + __asm punpckhwd mm5,mm6 \ + __asm movd mm6,A \ + __asm pmaddwd mm5,mm7 \ + __asm pxor mm1,mm1 \ + __asm punpckldq mm6,mm6 \ + __asm pcmpeqw mm1,mm2 \ + /*mm4=r=(t0''*27146+0x4000>>16)+t0''+(t0''!=0)*/ \ + __asm psrad mm4,16 \ + __asm psubw mm1,mm3 \ + __asm psrad mm5,16 \ + __asm paddw mm2,mm1 \ + __asm packssdw mm4,mm5 \ + __asm movq mm1,[Y+_r5] \ + __asm paddw mm4,mm2 \ + /*mm2=t6'', mm0=_y[0]=u=r+s>>1 \ + The naive implementation could cause overflow, so we use \ + u=(r&s)+((r^s)>>1).*/ \ + __asm movq mm2,[Y+_r3] \ + __asm movq mm7,mm0 \ + __asm pxor mm0,mm4 \ + __asm pand mm7,mm4 \ + __asm psraw mm0,1 \ + __asm mov A,0x7FFF54DC \ + __asm paddw mm0,mm7 \ + __asm movd mm7,A \ + /*mm7={54491-0x7FFF,0x7FFF}x2 \ + mm4=_y[4]=v=r-u*/ \ + __asm psubw mm4,mm0 \ + __asm punpckldq mm7,mm7 \ + __asm movq [Y+_r4],mm4 \ + /*mm0=0, mm7={36410}x4 \ + mm1=(t5'''!=0), mm5:mm4=54491*t5'''+0x0E3D*/ \ + __asm movq mm4,mm1 \ + __asm movq mm5,mm1 \ + __asm punpcklwd mm4,mm1 \ + __asm mov A,0x8E3A8E3A \ + __asm pmaddwd mm4,mm7 \ + __asm movq [Y+_r0],mm0 \ + __asm punpckhwd mm5,mm1 \ + __asm pxor mm0,mm0 \ + __asm pmaddwd mm5,mm7 \ + __asm pcmpeqw mm1,mm0 \ + __asm movd mm7,A \ + __asm psubw mm1,mm3 \ + __asm punpckldq mm7,mm7 \ + __asm paddd mm4,mm6 \ + __asm paddd mm5,mm6 \ + /*mm0=0 \ + mm3:mm1=36410*t6'''+((t5'''!=0)<<16)*/ \ + __asm movq mm6,mm2 \ + __asm movq mm3,mm2 \ + __asm pmulhw mm6,mm7 \ + __asm paddw mm1,mm2 \ + __asm pmullw mm3,mm7 \ + __asm pxor mm0,mm0 \ + __asm paddw mm6,mm1 \ + __asm movq mm1,mm3 \ + __asm punpckhwd mm3,mm6 \ + __asm punpcklwd mm1,mm6 \ + /*mm3={-1}x4, mm6={1}x4 \ + mm4=_y[5]=u=(54491*t5'''+36410*t6'''+0x0E3D>>16)+(t5'''!=0)*/ \ + __asm paddd mm5,mm3 \ + __asm paddd mm4,mm1 \ + __asm psrad mm5,16 \ + __asm pxor mm6,mm6 \ + __asm psrad mm4,16 \ + __asm pcmpeqb mm3,mm3 \ + __asm packssdw mm4,mm5 \ + __asm psubw mm6,mm3 \ + /*mm1=t7'', mm7={26568,0x3400}x2 \ + mm2=s=t6'''-(36410*u>>16)*/ \ + __asm movq mm1,mm4 \ + __asm mov A,0x340067C8 \ + __asm pmulhw mm4,mm7 \ + __asm movd mm7,A \ + __asm movq [Y+_r5],mm1 \ + __asm punpckldq mm7,mm7 \ + __asm paddw mm4,mm1 \ + __asm movq mm1,[Y+_r7] \ + __asm psubw mm2,mm4 \ + /*mm6={0x00007B1B}x2 \ + mm0=(s!=0), mm5:mm4=s*26568+0x3400*/ \ + __asm movq mm4,mm2 \ + __asm movq mm5,mm2 \ + __asm punpcklwd mm4,mm6 \ + __asm pcmpeqw mm0,mm2 \ + __asm pmaddwd mm4,mm7 \ + __asm mov A,0x7B1B \ + __asm punpckhwd mm5,mm6 \ + __asm movd mm6,A \ + __asm pmaddwd mm5,mm7 \ + __asm psubw mm0,mm3 \ + __asm punpckldq mm6,mm6 \ + /*mm7={64277-0x7FFF,0x7FFF}x2 \ + mm2=_y[3]=v=(s*26568+0x3400>>17)+s+(s!=0)*/ \ + __asm psrad mm4,17 \ + __asm paddw mm2,mm0 \ + __asm psrad mm5,17 \ + __asm mov A,0x7FFF7B16 \ + __asm packssdw mm4,mm5 \ + __asm movd mm7,A \ + __asm paddw mm2,mm4 \ + __asm punpckldq mm7,mm7 \ + /*mm0=0, mm7={12785}x4 \ + mm1=(t7''!=0), mm2=t4'', mm5:mm4=64277*t7''+0x7B1B*/ \ + __asm movq mm4,mm1 \ + __asm movq mm5,mm1 \ + __asm movq [Y+_r3],mm2 \ + __asm punpcklwd mm4,mm1 \ + __asm movq mm2,[Y+_r1] \ + __asm pmaddwd mm4,mm7 \ + __asm mov A,0x31F131F1 \ + __asm punpckhwd mm5,mm1 \ + __asm pxor mm0,mm0 \ + __asm pmaddwd mm5,mm7 \ + __asm pcmpeqw mm1,mm0 \ + __asm movd mm7,A \ + __asm psubw mm1,mm3 \ + __asm punpckldq mm7,mm7 \ + __asm paddd mm4,mm6 \ + __asm paddd mm5,mm6 \ + /*mm3:mm1=12785*t4'''+((t7''!=0)<<16)*/ \ + __asm movq mm6,mm2 \ + __asm movq mm3,mm2 \ + __asm pmulhw mm6,mm7 \ + __asm pmullw mm3,mm7 \ + __asm paddw mm6,mm1 \ + __asm movq mm1,mm3 \ + __asm punpckhwd mm3,mm6 \ + __asm punpcklwd mm1,mm6 \ + /*mm3={-1}x4, mm6={1}x4 \ + mm4=_y[1]=u=(12785*t4'''+64277*t7''+0x7B1B>>16)+(t7''!=0)*/ \ + __asm paddd mm5,mm3 \ + __asm paddd mm4,mm1 \ + __asm psrad mm5,16 \ + __asm pxor mm6,mm6 \ + __asm psrad mm4,16 \ + __asm pcmpeqb mm3,mm3 \ + __asm packssdw mm4,mm5 \ + __asm psubw mm6,mm3 \ + /*mm1=t3'', mm7={20539,0x3000}x2 \ + mm4=s=(12785*u>>16)-t4''*/ \ + __asm movq [Y+_r1],mm4 \ + __asm pmulhw mm4,mm7 \ + __asm mov A,0x3000503B \ + __asm movq mm1,[Y+_r6] \ + __asm movd mm7,A \ + __asm psubw mm4,mm2 \ + __asm punpckldq mm7,mm7 \ + /*mm6={0x00006CB7}x2 \ + mm0=(s!=0), mm5:mm4=s*20539+0x3000*/ \ + __asm movq mm5,mm4 \ + __asm movq mm2,mm4 \ + __asm punpcklwd mm4,mm6 \ + __asm pcmpeqw mm0,mm2 \ + __asm pmaddwd mm4,mm7 \ + __asm mov A,0x6CB7 \ + __asm punpckhwd mm5,mm6 \ + __asm movd mm6,A \ + __asm pmaddwd mm5,mm7 \ + __asm psubw mm0,mm3 \ + __asm punpckldq mm6,mm6 \ + /*mm7={60547-0x7FFF,0x7FFF}x2 \ + mm2=_y[7]=v=(s*20539+0x3000>>20)+s+(s!=0)*/ \ + __asm psrad mm4,20 \ + __asm paddw mm2,mm0 \ + __asm psrad mm5,20 \ + __asm mov A,0x7FFF6C84 \ + __asm packssdw mm4,mm5 \ + __asm movd mm7,A \ + __asm paddw mm2,mm4 \ + __asm punpckldq mm7,mm7 \ + /*mm0=0, mm7={25080}x4 \ + mm2=t2'', mm5:mm4=60547*t3''+0x6CB7*/ \ + __asm movq mm4,mm1 \ + __asm movq mm5,mm1 \ + __asm movq [Y+_r7],mm2 \ + __asm punpcklwd mm4,mm1 \ + __asm movq mm2,[Y+_r2] \ + __asm pmaddwd mm4,mm7 \ + __asm mov A,0x61F861F8 \ + __asm punpckhwd mm5,mm1 \ + __asm pxor mm0,mm0 \ + __asm pmaddwd mm5,mm7 \ + __asm movd mm7,A \ + __asm pcmpeqw mm1,mm0 \ + __asm psubw mm1,mm3 \ + __asm punpckldq mm7,mm7 \ + __asm paddd mm4,mm6 \ + __asm paddd mm5,mm6 \ + /*mm3:mm1=25080*t2''+((t3''!=0)<<16)*/ \ + __asm movq mm6,mm2 \ + __asm movq mm3,mm2 \ + __asm pmulhw mm6,mm7 \ + __asm pmullw mm3,mm7 \ + __asm paddw mm6,mm1 \ + __asm movq mm1,mm3 \ + __asm punpckhwd mm3,mm6 \ + __asm punpcklwd mm1,mm6 \ + /*mm1={-1}x4 \ + mm4=u=(25080*t2''+60547*t3''+0x6CB7>>16)+(t3''!=0)*/ \ + __asm paddd mm5,mm3 \ + __asm paddd mm4,mm1 \ + __asm psrad mm5,16 \ + __asm mov A,0x28005460 \ + __asm psrad mm4,16 \ + __asm pcmpeqb mm1,mm1 \ + __asm packssdw mm4,mm5 \ + /*mm5={1}x4, mm6=_y[2]=u, mm7={21600,0x2800}x2 \ + mm4=s=(25080*u>>16)-t2''*/ \ + __asm movq mm6,mm4 \ + __asm pmulhw mm4,mm7 \ + __asm pxor mm5,mm5 \ + __asm movd mm7,A \ + __asm psubw mm5,mm1 \ + __asm punpckldq mm7,mm7 \ + __asm psubw mm4,mm2 \ + /*mm2=s+(s!=0) \ + mm4:mm3=s*21600+0x2800*/ \ + __asm movq mm3,mm4 \ + __asm movq mm2,mm4 \ + __asm punpckhwd mm4,mm5 \ + __asm pcmpeqw mm0,mm2 \ + __asm pmaddwd mm4,mm7 \ + __asm psubw mm0,mm1 \ + __asm punpcklwd mm3,mm5 \ + __asm paddw mm2,mm0 \ + __asm pmaddwd mm3,mm7 \ + /*mm0=_y[4], mm1=_y[7], mm4=_y[0], mm5=_y[5] \ + mm3=_y[6]=v=(s*21600+0x2800>>18)+s+(s!=0)*/ \ + __asm movq mm0,[Y+_r4] \ + __asm psrad mm4,18 \ + __asm movq mm5,[Y+_r5] \ + __asm psrad mm3,18 \ + __asm movq mm1,[Y+_r7] \ + __asm packssdw mm3,mm4 \ + __asm movq mm4,[Y+_r0] \ + __asm paddw mm3,mm2 \ +} + +/*On input, mm4=_y[0], mm6=_y[2], mm0=_y[4], mm5=_y[5], mm3=_y[6], mm1=_y[7]. + On output, {_y[4],mm1,mm2,mm3} contains the transpose of _y[4...7] and + {mm4,mm5,mm6,mm7} contains the transpose of _y[0...3].*/ +#define OC_TRANSPOSE8x4(_r0,_r1,_r2,_r3,_r4,_r5,_r6,_r7) __asm{ \ + /*First 4x4 transpose:*/ \ + /*mm0 = e3 e2 e1 e0 \ + mm5 = f3 f2 f1 f0 \ + mm3 = g3 g2 g1 g0 \ + mm1 = h3 h2 h1 h0*/ \ + __asm movq mm2,mm0 \ + __asm punpcklwd mm0,mm5 \ + __asm punpckhwd mm2,mm5 \ + __asm movq mm5,mm3 \ + __asm punpcklwd mm3,mm1 \ + __asm punpckhwd mm5,mm1 \ + /*mm0 = f1 e1 f0 e0 \ + mm2 = f3 e3 f2 e2 \ + mm3 = h1 g1 h0 g0 \ + mm5 = h3 g3 h2 g2*/ \ + __asm movq mm1,mm0 \ + __asm punpckldq mm0,mm3 \ + __asm movq [Y+_r4],mm0 \ + __asm punpckhdq mm1,mm3 \ + __asm movq mm0,[Y+_r1] \ + __asm movq mm3,mm2 \ + __asm punpckldq mm2,mm5 \ + __asm punpckhdq mm3,mm5 \ + __asm movq mm5,[Y+_r3] \ + /*_y[4] = h0 g0 f0 e0 \ + mm1 = h1 g1 f1 e1 \ + mm2 = h2 g2 f2 e2 \ + mm3 = h3 g3 f3 e3*/ \ + /*Second 4x4 transpose:*/ \ + /*mm4 = a3 a2 a1 a0 \ + mm0 = b3 b2 b1 b0 \ + mm6 = c3 c2 c1 c0 \ + mm5 = d3 d2 d1 d0*/ \ + __asm movq mm7,mm4 \ + __asm punpcklwd mm4,mm0 \ + __asm punpckhwd mm7,mm0 \ + __asm movq mm0,mm6 \ + __asm punpcklwd mm6,mm5 \ + __asm punpckhwd mm0,mm5 \ + /*mm4 = b1 a1 b0 a0 \ + mm7 = b3 a3 b2 a2 \ + mm6 = d1 c1 d0 c0 \ + mm0 = d3 c3 d2 c2*/ \ + __asm movq mm5,mm4 \ + __asm punpckldq mm4,mm6 \ + __asm punpckhdq mm5,mm6 \ + __asm movq mm6,mm7 \ + __asm punpckhdq mm7,mm0 \ + __asm punpckldq mm6,mm0 \ + /*mm4 = d0 c0 b0 a0 \ + mm5 = d1 c1 b1 a1 \ + mm6 = d2 c2 b2 a2 \ + mm7 = d3 c3 b3 a3*/ \ +} + +/*MMX implementation of the fDCT.*/ +void oc_enc_fdct8x8_mmx(ogg_int16_t _y[64],const ogg_int16_t _x[64]){ + ptrdiff_t a; + __asm{ +#define Y eax +#define A ecx +#define X edx + /*Add two extra bits of working precision to improve accuracy; any more and + we could overflow.*/ + /*We also add biases to correct for some systematic error that remains in + the full fDCT->iDCT round trip.*/ + mov X, _x + mov Y, _y + movq mm0,[0x00+X] + movq mm1,[0x10+X] + movq mm2,[0x20+X] + movq mm3,[0x30+X] + pcmpeqb mm4,mm4 + pxor mm7,mm7 + movq mm5,mm0 + psllw mm0,2 + pcmpeqw mm5,mm7 + movq mm7,[0x70+X] + psllw mm1,2 + psubw mm5,mm4 + psllw mm2,2 + mov A,1 + pslld mm5,16 + movd mm6,A + psllq mm5,16 + mov A,0x10001 + psllw mm3,2 + movd mm4,A + punpckhwd mm5,mm6 + psubw mm1,mm6 + movq mm6,[0x60+X] + paddw mm0,mm5 + movq mm5,[0x50+X] + paddw mm0,mm4 + movq mm4,[0x40+X] + /*We inline stage1 of the transform here so we can get better instruction + scheduling with the shifts.*/ + /*mm0=t7'=t0-t7*/ + psllw mm7,2 + psubw mm0,mm7 + psllw mm6,2 + paddw mm7,mm7 + /*mm1=t6'=t1-t6*/ + psllw mm5,2 + psubw mm1,mm6 + psllw mm4,2 + paddw mm6,mm6 + /*mm2=t5'=t2-t5*/ + psubw mm2,mm5 + paddw mm5,mm5 + /*mm3=t4'=t3-t4*/ + psubw mm3,mm4 + paddw mm4,mm4 + /*mm7=t0'=t0+t7*/ + paddw mm7,mm0 + /*mm6=t1'=t1+t6*/ + paddw mm6,mm1 + /*mm5=t2'=t2+t5*/ + paddw mm5,mm2 + /*mm4=t3'=t3+t4*/ + paddw mm4,mm3 + OC_FDCT8x4(0x00,0x10,0x20,0x30,0x40,0x50,0x60,0x70) + OC_TRANSPOSE8x4(0x00,0x10,0x20,0x30,0x40,0x50,0x60,0x70) + /*Swap out this 8x4 block for the next one.*/ + movq mm0,[0x08+X] + movq [0x30+Y],mm7 + movq mm7,[0x78+X] + movq [0x50+Y],mm1 + movq mm1,[0x18+X] + movq [0x20+Y],mm6 + movq mm6,[0x68+X] + movq [0x60+Y],mm2 + movq mm2,[0x28+X] + movq [0x10+Y],mm5 + movq mm5,[0x58+X] + movq [0x70+Y],mm3 + movq mm3,[0x38+X] + /*And increase its working precision, too.*/ + psllw mm0,2 + movq [0x00+Y],mm4 + psllw mm7,2 + movq mm4,[0x48+X] + /*We inline stage1 of the transform here so we can get better instruction + scheduling with the shifts.*/ + /*mm0=t7'=t0-t7*/ + psubw mm0,mm7 + psllw mm1,2 + paddw mm7,mm7 + psllw mm6,2 + /*mm1=t6'=t1-t6*/ + psubw mm1,mm6 + psllw mm2,2 + paddw mm6,mm6 + psllw mm5,2 + /*mm2=t5'=t2-t5*/ + psubw mm2,mm5 + psllw mm3,2 + paddw mm5,mm5 + psllw mm4,2 + /*mm3=t4'=t3-t4*/ + psubw mm3,mm4 + paddw mm4,mm4 + /*mm7=t0'=t0+t7*/ + paddw mm7,mm0 + /*mm6=t1'=t1+t6*/ + paddw mm6,mm1 + /*mm5=t2'=t2+t5*/ + paddw mm5,mm2 + /*mm4=t3'=t3+t4*/ + paddw mm4,mm3 + OC_FDCT8x4(0x08,0x18,0x28,0x38,0x48,0x58,0x68,0x78) + OC_TRANSPOSE8x4(0x08,0x18,0x28,0x38,0x48,0x58,0x68,0x78) + /*Here the first 4x4 block of output from the last transpose is the second + 4x4 block of input for the next transform. + We have cleverly arranged that it already be in the appropriate place, + so we only have to do half the stores and loads.*/ + movq mm0,[0x00+Y] + movq [0x58+Y],mm1 + movq mm1,[0x10+Y] + movq [0x68+Y],mm2 + movq mm2,[0x20+Y] + movq [0x78+Y],mm3 + movq mm3,[0x30+Y] + OC_FDCT_STAGE1_8x4 + OC_FDCT8x4(0x00,0x10,0x20,0x30,0x08,0x18,0x28,0x38) + OC_TRANSPOSE8x4(0x00,0x10,0x20,0x30,0x08,0x18,0x28,0x38) + /*mm0={-2}x4*/ + pcmpeqw mm0,mm0 + paddw mm0,mm0 + /*Round the results.*/ + psubw mm1,mm0 + psubw mm2,mm0 + psraw mm1,2 + psubw mm3,mm0 + movq [0x18+Y],mm1 + psraw mm2,2 + psubw mm4,mm0 + movq mm1,[0x08+Y] + psraw mm3,2 + psubw mm5,mm0 + psraw mm4,2 + psubw mm6,mm0 + psraw mm5,2 + psubw mm7,mm0 + psraw mm6,2 + psubw mm1,mm0 + psraw mm7,2 + movq mm0,[0x40+Y] + psraw mm1,2 + movq [0x30+Y],mm7 + movq mm7,[0x78+Y] + movq [0x08+Y],mm1 + movq mm1,[0x50+Y] + movq [0x20+Y],mm6 + movq mm6,[0x68+Y] + movq [0x28+Y],mm2 + movq mm2,[0x60+Y] + movq [0x10+Y],mm5 + movq mm5,[0x58+Y] + movq [0x38+Y],mm3 + movq mm3,[0x70+Y] + movq [0x00+Y],mm4 + movq mm4,[0x48+Y] + OC_FDCT_STAGE1_8x4 + OC_FDCT8x4(0x40,0x50,0x60,0x70,0x48,0x58,0x68,0x78) + OC_TRANSPOSE8x4(0x40,0x50,0x60,0x70,0x48,0x58,0x68,0x78) + /*mm0={-2}x4*/ + pcmpeqw mm0,mm0 + paddw mm0,mm0 + /*Round the results.*/ + psubw mm1,mm0 + psubw mm2,mm0 + psraw mm1,2 + psubw mm3,mm0 + movq [0x58+Y],mm1 + psraw mm2,2 + psubw mm4,mm0 + movq mm1,[0x48+Y] + psraw mm3,2 + psubw mm5,mm0 + movq [0x68+Y],mm2 + psraw mm4,2 + psubw mm6,mm0 + movq [0x78+Y],mm3 + psraw mm5,2 + psubw mm7,mm0 + movq [0x40+Y],mm4 + psraw mm6,2 + psubw mm1,mm0 + movq [0x50+Y],mm5 + psraw mm7,2 + movq [0x60+Y],mm6 + psraw mm1,2 + movq [0x70+Y],mm7 + movq [0x48+Y],mm1 +#undef Y +#undef A +#undef X + } +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxfrag.c b/libs/libtheora-1.1/lib/x86_vc/mmxfrag.c new file mode 100644 index 00000000..9b45820d --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxfrag.c @@ -0,0 +1,337 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxfrag.c 16578 2009-09-25 19:50:48Z cristianadam $ + + ********************************************************************/ + +/*MMX acceleration of fragment reconstruction for motion compensation. + Originally written by Rudolf Marek. + Additional optimization by Nils Pipenbrinck. + Note: Loops are unrolled for best performance. + The iteration each instruction belongs to is marked in the comments as #i.*/ +#include +#include "x86int.h" +#include "mmxfrag.h" + +#if defined(OC_X86_ASM) + +/*Copies an 8x8 block of pixels from _src to _dst, assuming _ystride bytes + between rows.*/ +void oc_frag_copy_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride){ +#define SRC edx +#define DST eax +#define YSTRIDE ecx +#define YSTRIDE3 esi + OC_FRAG_COPY_MMX(_dst,_src,_ystride); +#undef SRC +#undef DST +#undef YSTRIDE +#undef YSTRIDE3 +} + +void oc_frag_recon_intra_mmx(unsigned char *_dst,int _ystride, + const ogg_int16_t *_residue){ + __asm{ +#define DST edx +#define DST4 esi +#define YSTRIDE eax +#define YSTRIDE3 edi +#define RESIDUE ecx + mov DST,_dst + mov YSTRIDE,_ystride + mov RESIDUE,_residue + lea DST4,[DST+YSTRIDE*4] + lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] + /*Set mm0 to 0xFFFFFFFFFFFFFFFF.*/ + pcmpeqw mm0,mm0 + /*#0 Load low residue.*/ + movq mm1,[0*8+RESIDUE] + /*#0 Load high residue.*/ + movq mm2,[1*8+RESIDUE] + /*Set mm0 to 0x8000800080008000.*/ + psllw mm0,15 + /*#1 Load low residue.*/ + movq mm3,[2*8+RESIDUE] + /*#1 Load high residue.*/ + movq mm4,[3*8+RESIDUE] + /*Set mm0 to 0x0080008000800080.*/ + psrlw mm0,8 + /*#2 Load low residue.*/ + movq mm5,[4*8+RESIDUE] + /*#2 Load high residue.*/ + movq mm6,[5*8+RESIDUE] + /*#0 Bias low residue.*/ + paddsw mm1,mm0 + /*#0 Bias high residue.*/ + paddsw mm2,mm0 + /*#0 Pack to byte.*/ + packuswb mm1,mm2 + /*#1 Bias low residue.*/ + paddsw mm3,mm0 + /*#1 Bias high residue.*/ + paddsw mm4,mm0 + /*#1 Pack to byte.*/ + packuswb mm3,mm4 + /*#2 Bias low residue.*/ + paddsw mm5,mm0 + /*#2 Bias high residue.*/ + paddsw mm6,mm0 + /*#2 Pack to byte.*/ + packuswb mm5,mm6 + /*#0 Write row.*/ + movq [DST],mm1 + /*#1 Write row.*/ + movq [DST+YSTRIDE],mm3 + /*#2 Write row.*/ + movq [DST+YSTRIDE*2],mm5 + /*#3 Load low residue.*/ + movq mm1,[6*8+RESIDUE] + /*#3 Load high residue.*/ + movq mm2,[7*8+RESIDUE] + /*#4 Load high residue.*/ + movq mm3,[8*8+RESIDUE] + /*#4 Load high residue.*/ + movq mm4,[9*8+RESIDUE] + /*#5 Load high residue.*/ + movq mm5,[10*8+RESIDUE] + /*#5 Load high residue.*/ + movq mm6,[11*8+RESIDUE] + /*#3 Bias low residue.*/ + paddsw mm1,mm0 + /*#3 Bias high residue.*/ + paddsw mm2,mm0 + /*#3 Pack to byte.*/ + packuswb mm1,mm2 + /*#4 Bias low residue.*/ + paddsw mm3,mm0 + /*#4 Bias high residue.*/ + paddsw mm4,mm0 + /*#4 Pack to byte.*/ + packuswb mm3,mm4 + /*#5 Bias low residue.*/ + paddsw mm5,mm0 + /*#5 Bias high residue.*/ + paddsw mm6,mm0 + /*#5 Pack to byte.*/ + packuswb mm5,mm6 + /*#3 Write row.*/ + movq [DST+YSTRIDE3],mm1 + /*#4 Write row.*/ + movq [DST4],mm3 + /*#5 Write row.*/ + movq [DST4+YSTRIDE],mm5 + /*#6 Load low residue.*/ + movq mm1,[12*8+RESIDUE] + /*#6 Load high residue.*/ + movq mm2,[13*8+RESIDUE] + /*#7 Load low residue.*/ + movq mm3,[14*8+RESIDUE] + /*#7 Load high residue.*/ + movq mm4,[15*8+RESIDUE] + /*#6 Bias low residue.*/ + paddsw mm1,mm0 + /*#6 Bias high residue.*/ + paddsw mm2,mm0 + /*#6 Pack to byte.*/ + packuswb mm1,mm2 + /*#7 Bias low residue.*/ + paddsw mm3,mm0 + /*#7 Bias high residue.*/ + paddsw mm4,mm0 + /*#7 Pack to byte.*/ + packuswb mm3,mm4 + /*#6 Write row.*/ + movq [DST4+YSTRIDE*2],mm1 + /*#7 Write row.*/ + movq [DST4+YSTRIDE3],mm3 +#undef DST +#undef DST4 +#undef YSTRIDE +#undef YSTRIDE3 +#undef RESIDUE + } +} + +void oc_frag_recon_inter_mmx(unsigned char *_dst,const unsigned char *_src, + int _ystride,const ogg_int16_t *_residue){ + int i; + /*Zero mm0.*/ + __asm pxor mm0,mm0; + for(i=4;i-->0;){ + __asm{ +#define DST edx +#define SRC ecx +#define YSTRIDE edi +#define RESIDUE eax + mov DST,_dst + mov SRC,_src + mov YSTRIDE,_ystride + mov RESIDUE,_residue + /*#0 Load source.*/ + movq mm3,[SRC] + /*#1 Load source.*/ + movq mm7,[SRC+YSTRIDE] + /*#0 Get copy of src.*/ + movq mm4,mm3 + /*#0 Expand high source.*/ + punpckhbw mm4,mm0 + /*#0 Expand low source.*/ + punpcklbw mm3,mm0 + /*#0 Add residue high.*/ + paddsw mm4,[8+RESIDUE] + /*#1 Get copy of src.*/ + movq mm2,mm7 + /*#0 Add residue low.*/ + paddsw mm3,[RESIDUE] + /*#1 Expand high source.*/ + punpckhbw mm2,mm0 + /*#0 Pack final row pixels.*/ + packuswb mm3,mm4 + /*#1 Expand low source.*/ + punpcklbw mm7,mm0 + /*#1 Add residue low.*/ + paddsw mm7,[16+RESIDUE] + /*#1 Add residue high.*/ + paddsw mm2,[24+RESIDUE] + /*Advance residue.*/ + lea RESIDUE,[32+RESIDUE] + /*#1 Pack final row pixels.*/ + packuswb mm7,mm2 + /*Advance src.*/ + lea SRC,[SRC+YSTRIDE*2] + /*#0 Write row.*/ + movq [DST],mm3 + /*#1 Write row.*/ + movq [DST+YSTRIDE],mm7 + /*Advance dst.*/ + lea DST,[DST+YSTRIDE*2] + mov _residue,RESIDUE + mov _dst,DST + mov _src,SRC +#undef DST +#undef SRC +#undef YSTRIDE +#undef RESIDUE + } + } +} + +void oc_frag_recon_inter2_mmx(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t *_residue){ + int i; + /*Zero mm7.*/ + __asm pxor mm7,mm7; + for(i=4;i-->0;){ + __asm{ +#define SRC1 ecx +#define SRC2 edi +#define YSTRIDE esi +#define RESIDUE edx +#define DST eax + mov YSTRIDE,_ystride + mov DST,_dst + mov RESIDUE,_residue + mov SRC1,_src1 + mov SRC2,_src2 + /*#0 Load src1.*/ + movq mm0,[SRC1] + /*#0 Load src2.*/ + movq mm2,[SRC2] + /*#0 Copy src1.*/ + movq mm1,mm0 + /*#0 Copy src2.*/ + movq mm3,mm2 + /*#1 Load src1.*/ + movq mm4,[SRC1+YSTRIDE] + /*#0 Unpack lower src1.*/ + punpcklbw mm0,mm7 + /*#1 Load src2.*/ + movq mm5,[SRC2+YSTRIDE] + /*#0 Unpack higher src1.*/ + punpckhbw mm1,mm7 + /*#0 Unpack lower src2.*/ + punpcklbw mm2,mm7 + /*#0 Unpack higher src2.*/ + punpckhbw mm3,mm7 + /*Advance src1 ptr.*/ + lea SRC1,[SRC1+YSTRIDE*2] + /*Advance src2 ptr.*/ + lea SRC2,[SRC2+YSTRIDE*2] + /*#0 Lower src1+src2.*/ + paddsw mm0,mm2 + /*#0 Higher src1+src2.*/ + paddsw mm1,mm3 + /*#1 Copy src1.*/ + movq mm2,mm4 + /*#0 Build lo average.*/ + psraw mm0,1 + /*#1 Copy src2.*/ + movq mm3,mm5 + /*#1 Unpack lower src1.*/ + punpcklbw mm4,mm7 + /*#0 Build hi average.*/ + psraw mm1,1 + /*#1 Unpack higher src1.*/ + punpckhbw mm2,mm7 + /*#0 low+=residue.*/ + paddsw mm0,[RESIDUE] + /*#1 Unpack lower src2.*/ + punpcklbw mm5,mm7 + /*#0 high+=residue.*/ + paddsw mm1,[8+RESIDUE] + /*#1 Unpack higher src2.*/ + punpckhbw mm3,mm7 + /*#1 Lower src1+src2.*/ + paddsw mm5,mm4 + /*#0 Pack and saturate.*/ + packuswb mm0,mm1 + /*#1 Higher src1+src2.*/ + paddsw mm3,mm2 + /*#0 Write row.*/ + movq [DST],mm0 + /*#1 Build lo average.*/ + psraw mm5,1 + /*#1 Build hi average.*/ + psraw mm3,1 + /*#1 low+=residue.*/ + paddsw mm5,[16+RESIDUE] + /*#1 high+=residue.*/ + paddsw mm3,[24+RESIDUE] + /*#1 Pack and saturate.*/ + packuswb mm5,mm3 + /*#1 Write row ptr.*/ + movq [DST+YSTRIDE],mm5 + /*Advance residue ptr.*/ + add RESIDUE,32 + /*Advance dest ptr.*/ + lea DST,[DST+YSTRIDE*2] + mov _dst,DST + mov _residue,RESIDUE + mov _src1,SRC1 + mov _src2,SRC2 +#undef SRC1 +#undef SRC2 +#undef YSTRIDE +#undef RESIDUE +#undef DST + } + } +} + +void oc_restore_fpu_mmx(void){ + __asm emms; +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxfrag.h b/libs/libtheora-1.1/lib/x86_vc/mmxfrag.h new file mode 100644 index 00000000..45ee93e7 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxfrag.h @@ -0,0 +1,61 @@ +#if !defined(_x86_vc_mmxfrag_H) +# define _x86_vc_mmxfrag_H (1) +# include +# include "x86int.h" + +#if defined(OC_X86_ASM) + +/*Copies an 8x8 block of pixels from _src to _dst, assuming _ystride bytes + between rows.*/ +#define OC_FRAG_COPY_MMX(_dst,_src,_ystride) \ + do{ \ + const unsigned char *src; \ + unsigned char *dst; \ + src=(_src); \ + dst=(_dst); \ + __asm mov SRC,src \ + __asm mov DST,dst \ + __asm mov YSTRIDE,_ystride \ + /*src+0*ystride*/ \ + __asm movq mm0,[SRC] \ + /*src+1*ystride*/ \ + __asm movq mm1,[SRC+YSTRIDE] \ + /*ystride3=ystride*3*/ \ + __asm lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] \ + /*src+2*ystride*/ \ + __asm movq mm2,[SRC+YSTRIDE*2] \ + /*src+3*ystride*/ \ + __asm movq mm3,[SRC+YSTRIDE3] \ + /*dst+0*ystride*/ \ + __asm movq [DST],mm0 \ + /*dst+1*ystride*/ \ + __asm movq [DST+YSTRIDE],mm1 \ + /*Pointer to next 4.*/ \ + __asm lea SRC,[SRC+YSTRIDE*4] \ + /*dst+2*ystride*/ \ + __asm movq [DST+YSTRIDE*2],mm2 \ + /*dst+3*ystride*/ \ + __asm movq [DST+YSTRIDE3],mm3 \ + /*Pointer to next 4.*/ \ + __asm lea DST,[DST+YSTRIDE*4] \ + /*src+0*ystride*/ \ + __asm movq mm0,[SRC] \ + /*src+1*ystride*/ \ + __asm movq mm1,[SRC+YSTRIDE] \ + /*src+2*ystride*/ \ + __asm movq mm2,[SRC+YSTRIDE*2] \ + /*src+3*ystride*/ \ + __asm movq mm3,[SRC+YSTRIDE3] \ + /*dst+0*ystride*/ \ + __asm movq [DST],mm0 \ + /*dst+1*ystride*/ \ + __asm movq [DST+YSTRIDE],mm1 \ + /*dst+2*ystride*/ \ + __asm movq [DST+YSTRIDE*2],mm2 \ + /*dst+3*ystride*/ \ + __asm movq [DST+YSTRIDE3],mm3 \ + } \ + while(0) + +# endif +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxidct.c b/libs/libtheora-1.1/lib/x86_vc/mmxidct.c new file mode 100644 index 00000000..970508f1 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxidct.c @@ -0,0 +1,562 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxidct.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +/*MMX acceleration of Theora's iDCT. + Originally written by Rudolf Marek, based on code from On2's VP3.*/ +#include "x86int.h" +#include "../dct.h" + +#if defined(OC_X86_ASM) + +/*These are offsets into the table of constants below.*/ +/*7 rows of cosines, in order: pi/16 * (1 ... 7).*/ +#define OC_COSINE_OFFSET (0) +/*A row of 8's.*/ +#define OC_EIGHT_OFFSET (56) + + + +/*A table of constants used by the MMX routines.*/ +static const __declspec(align(16))ogg_uint16_t + OC_IDCT_CONSTS[(7+1)*4]={ + (ogg_uint16_t)OC_C1S7,(ogg_uint16_t)OC_C1S7, + (ogg_uint16_t)OC_C1S7,(ogg_uint16_t)OC_C1S7, + (ogg_uint16_t)OC_C2S6,(ogg_uint16_t)OC_C2S6, + (ogg_uint16_t)OC_C2S6,(ogg_uint16_t)OC_C2S6, + (ogg_uint16_t)OC_C3S5,(ogg_uint16_t)OC_C3S5, + (ogg_uint16_t)OC_C3S5,(ogg_uint16_t)OC_C3S5, + (ogg_uint16_t)OC_C4S4,(ogg_uint16_t)OC_C4S4, + (ogg_uint16_t)OC_C4S4,(ogg_uint16_t)OC_C4S4, + (ogg_uint16_t)OC_C5S3,(ogg_uint16_t)OC_C5S3, + (ogg_uint16_t)OC_C5S3,(ogg_uint16_t)OC_C5S3, + (ogg_uint16_t)OC_C6S2,(ogg_uint16_t)OC_C6S2, + (ogg_uint16_t)OC_C6S2,(ogg_uint16_t)OC_C6S2, + (ogg_uint16_t)OC_C7S1,(ogg_uint16_t)OC_C7S1, + (ogg_uint16_t)OC_C7S1,(ogg_uint16_t)OC_C7S1, + 8, 8, 8, 8 +}; + +/*38 cycles*/ +#define OC_IDCT_BEGIN __asm{ \ + __asm movq mm2,OC_I(3) \ + __asm movq mm6,OC_C(3) \ + __asm movq mm4,mm2 \ + __asm movq mm7,OC_J(5) \ + __asm pmulhw mm4,mm6 \ + __asm movq mm1,OC_C(5) \ + __asm pmulhw mm6,mm7 \ + __asm movq mm5,mm1 \ + __asm pmulhw mm1,mm2 \ + __asm movq mm3,OC_I(1) \ + __asm pmulhw mm5,mm7 \ + __asm movq mm0,OC_C(1) \ + __asm paddw mm4,mm2 \ + __asm paddw mm6,mm7 \ + __asm paddw mm2,mm1 \ + __asm movq mm1,OC_J(7) \ + __asm paddw mm7,mm5 \ + __asm movq mm5,mm0 \ + __asm pmulhw mm0,mm3 \ + __asm paddw mm4,mm7 \ + __asm pmulhw mm5,mm1 \ + __asm movq mm7,OC_C(7) \ + __asm psubw mm6,mm2 \ + __asm paddw mm0,mm3 \ + __asm pmulhw mm3,mm7 \ + __asm movq mm2,OC_I(2) \ + __asm pmulhw mm7,mm1 \ + __asm paddw mm5,mm1 \ + __asm movq mm1,mm2 \ + __asm pmulhw mm2,OC_C(2) \ + __asm psubw mm3,mm5 \ + __asm movq mm5,OC_J(6) \ + __asm paddw mm0,mm7 \ + __asm movq mm7,mm5 \ + __asm psubw mm0,mm4 \ + __asm pmulhw mm5,OC_C(2) \ + __asm paddw mm2,mm1 \ + __asm pmulhw mm1,OC_C(6) \ + __asm paddw mm4,mm4 \ + __asm paddw mm4,mm0 \ + __asm psubw mm3,mm6 \ + __asm paddw mm5,mm7 \ + __asm paddw mm6,mm6 \ + __asm pmulhw mm7,OC_C(6) \ + __asm paddw mm6,mm3 \ + __asm movq OC_I(1),mm4 \ + __asm psubw mm1,mm5 \ + __asm movq mm4,OC_C(4) \ + __asm movq mm5,mm3 \ + __asm pmulhw mm3,mm4 \ + __asm paddw mm7,mm2 \ + __asm movq OC_I(2),mm6 \ + __asm movq mm2,mm0 \ + __asm movq mm6,OC_I(0) \ + __asm pmulhw mm0,mm4 \ + __asm paddw mm5,mm3 \ + __asm movq mm3,OC_J(4) \ + __asm psubw mm5,mm1 \ + __asm paddw mm2,mm0 \ + __asm psubw mm6,mm3 \ + __asm movq mm0,mm6 \ + __asm pmulhw mm6,mm4 \ + __asm paddw mm3,mm3 \ + __asm paddw mm1,mm1 \ + __asm paddw mm3,mm0 \ + __asm paddw mm1,mm5 \ + __asm pmulhw mm4,mm3 \ + __asm paddw mm6,mm0 \ + __asm psubw mm6,mm2 \ + __asm paddw mm2,mm2 \ + __asm movq mm0,OC_I(1) \ + __asm paddw mm2,mm6 \ + __asm paddw mm4,mm3 \ + __asm psubw mm2,mm1 \ +} + +/*38+8=46 cycles.*/ +#define OC_ROW_IDCT __asm{ \ + OC_IDCT_BEGIN \ + /*r3=D'*/ \ + __asm movq mm3,OC_I(2) \ + /*r4=E'=E-G*/ \ + __asm psubw mm4,mm7 \ + /*r1=H'+H'*/ \ + __asm paddw mm1,mm1 \ + /*r7=G+G*/ \ + __asm paddw mm7,mm7 \ + /*r1=R1=A''+H'*/ \ + __asm paddw mm1,mm2 \ + /*r7=G'=E+G*/ \ + __asm paddw mm7,mm4 \ + /*r4=R4=E'-D'*/ \ + __asm psubw mm4,mm3 \ + __asm paddw mm3,mm3 \ + /*r6=R6=F'-B''*/ \ + __asm psubw mm6,mm5 \ + __asm paddw mm5,mm5 \ + /*r3=R3=E'+D'*/ \ + __asm paddw mm3,mm4 \ + /*r5=R5=F'+B''*/ \ + __asm paddw mm5,mm6 \ + /*r7=R7=G'-C'*/ \ + __asm psubw mm7,mm0 \ + __asm paddw mm0,mm0 \ + /*Save R1.*/ \ + __asm movq OC_I(1),mm1 \ + /*r0=R0=G.+C.*/ \ + __asm paddw mm0,mm7 \ +} + +/*The following macro does two 4x4 transposes in place. + At entry, we assume: + r0 = a3 a2 a1 a0 + I(1) = b3 b2 b1 b0 + r2 = c3 c2 c1 c0 + r3 = d3 d2 d1 d0 + + r4 = e3 e2 e1 e0 + r5 = f3 f2 f1 f0 + r6 = g3 g2 g1 g0 + r7 = h3 h2 h1 h0 + + At exit, we have: + I(0) = d0 c0 b0 a0 + I(1) = d1 c1 b1 a1 + I(2) = d2 c2 b2 a2 + I(3) = d3 c3 b3 a3 + + J(4) = h0 g0 f0 e0 + J(5) = h1 g1 f1 e1 + J(6) = h2 g2 f2 e2 + J(7) = h3 g3 f3 e3 + + I(0) I(1) I(2) I(3) is the transpose of r0 I(1) r2 r3. + J(4) J(5) J(6) J(7) is the transpose of r4 r5 r6 r7. + + Since r1 is free at entry, we calculate the Js first.*/ +/*19 cycles.*/ +#define OC_TRANSPOSE __asm{ \ + __asm movq mm1,mm4 \ + __asm punpcklwd mm4,mm5 \ + __asm movq OC_I(0),mm0 \ + __asm punpckhwd mm1,mm5 \ + __asm movq mm0,mm6 \ + __asm punpcklwd mm6,mm7 \ + __asm movq mm5,mm4 \ + __asm punpckldq mm4,mm6 \ + __asm punpckhdq mm5,mm6 \ + __asm movq mm6,mm1 \ + __asm movq OC_J(4),mm4 \ + __asm punpckhwd mm0,mm7 \ + __asm movq OC_J(5),mm5 \ + __asm punpckhdq mm6,mm0 \ + __asm movq mm4,OC_I(0) \ + __asm punpckldq mm1,mm0 \ + __asm movq mm5,OC_I(1) \ + __asm movq mm0,mm4 \ + __asm movq OC_J(7),mm6 \ + __asm punpcklwd mm0,mm5 \ + __asm movq OC_J(6),mm1 \ + __asm punpckhwd mm4,mm5 \ + __asm movq mm5,mm2 \ + __asm punpcklwd mm2,mm3 \ + __asm movq mm1,mm0 \ + __asm punpckldq mm0,mm2 \ + __asm punpckhdq mm1,mm2 \ + __asm movq mm2,mm4 \ + __asm movq OC_I(0),mm0 \ + __asm punpckhwd mm5,mm3 \ + __asm movq OC_I(1),mm1 \ + __asm punpckhdq mm4,mm5 \ + __asm punpckldq mm2,mm5 \ + __asm movq OC_I(3),mm4 \ + __asm movq OC_I(2),mm2 \ +} + +/*38+19=57 cycles.*/ +#define OC_COLUMN_IDCT __asm{ \ + OC_IDCT_BEGIN \ + __asm paddw mm2,OC_8 \ + /*r1=H'+H'*/ \ + __asm paddw mm1,mm1 \ + /*r1=R1=A''+H'*/ \ + __asm paddw mm1,mm2 \ + /*r2=NR2*/ \ + __asm psraw mm2,4 \ + /*r4=E'=E-G*/ \ + __asm psubw mm4,mm7 \ + /*r1=NR1*/ \ + __asm psraw mm1,4 \ + /*r3=D'*/ \ + __asm movq mm3,OC_I(2) \ + /*r7=G+G*/ \ + __asm paddw mm7,mm7 \ + /*Store NR2 at I(2).*/ \ + __asm movq OC_I(2),mm2 \ + /*r7=G'=E+G*/ \ + __asm paddw mm7,mm4 \ + /*Store NR1 at I(1).*/ \ + __asm movq OC_I(1),mm1 \ + /*r4=R4=E'-D'*/ \ + __asm psubw mm4,mm3 \ + __asm paddw mm4,OC_8 \ + /*r3=D'+D'*/ \ + __asm paddw mm3,mm3 \ + /*r3=R3=E'+D'*/ \ + __asm paddw mm3,mm4 \ + /*r4=NR4*/ \ + __asm psraw mm4,4 \ + /*r6=R6=F'-B''*/ \ + __asm psubw mm6,mm5 \ + /*r3=NR3*/ \ + __asm psraw mm3,4 \ + __asm paddw mm6,OC_8 \ + /*r5=B''+B''*/ \ + __asm paddw mm5,mm5 \ + /*r5=R5=F'+B''*/ \ + __asm paddw mm5,mm6 \ + /*r6=NR6*/ \ + __asm psraw mm6,4 \ + /*Store NR4 at J(4).*/ \ + __asm movq OC_J(4),mm4 \ + /*r5=NR5*/ \ + __asm psraw mm5,4 \ + /*Store NR3 at I(3).*/ \ + __asm movq OC_I(3),mm3 \ + /*r7=R7=G'-C'*/ \ + __asm psubw mm7,mm0 \ + __asm paddw mm7,OC_8 \ + /*r0=C'+C'*/ \ + __asm paddw mm0,mm0 \ + /*r0=R0=G'+C'*/ \ + __asm paddw mm0,mm7 \ + /*r7=NR7*/ \ + __asm psraw mm7,4 \ + /*Store NR6 at J(6).*/ \ + __asm movq OC_J(6),mm6 \ + /*r0=NR0*/ \ + __asm psraw mm0,4 \ + /*Store NR5 at J(5).*/ \ + __asm movq OC_J(5),mm5 \ + /*Store NR7 at J(7).*/ \ + __asm movq OC_J(7),mm7 \ + /*Store NR0 at I(0).*/ \ + __asm movq OC_I(0),mm0 \ +} + +#define OC_MID(_m,_i) [CONSTS+_m+(_i)*8] +#define OC_C(_i) OC_MID(OC_COSINE_OFFSET,_i-1) +#define OC_8 OC_MID(OC_EIGHT_OFFSET,0) + +static void oc_idct8x8_slow(ogg_int16_t _y[64]){ + /*This routine accepts an 8x8 matrix, but in partially transposed form. + Every 4x4 block is transposed.*/ + __asm{ +#define CONSTS eax +#define Y edx + mov CONSTS,offset OC_IDCT_CONSTS + mov Y,_y +#define OC_I(_k) [Y+_k*16] +#define OC_J(_k) [Y+(_k-4)*16+8] + OC_ROW_IDCT + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) [Y+(_k*16)+64] +#define OC_J(_k) [Y+(_k-4)*16+72] + OC_ROW_IDCT + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) [Y+_k*16] +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT +#undef OC_I +#undef OC_J +#define OC_I(_k) [Y+_k*16+8] +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT +#undef OC_I +#undef OC_J +#undef CONSTS +#undef Y + } +} + +/*25 cycles.*/ +#define OC_IDCT_BEGIN_10 __asm{ \ + __asm movq mm2,OC_I(3) \ + __asm nop \ + __asm movq mm6,OC_C(3) \ + __asm movq mm4,mm2 \ + __asm movq mm1,OC_C(5) \ + __asm pmulhw mm4,mm6 \ + __asm movq mm3,OC_I(1) \ + __asm pmulhw mm1,mm2 \ + __asm movq mm0,OC_C(1) \ + __asm paddw mm4,mm2 \ + __asm pxor mm6,mm6 \ + __asm paddw mm2,mm1 \ + __asm movq mm5,OC_I(2) \ + __asm pmulhw mm0,mm3 \ + __asm movq mm1,mm5 \ + __asm paddw mm0,mm3 \ + __asm pmulhw mm3,OC_C(7) \ + __asm psubw mm6,mm2 \ + __asm pmulhw mm5,OC_C(2) \ + __asm psubw mm0,mm4 \ + __asm movq mm7,OC_I(2) \ + __asm paddw mm4,mm4 \ + __asm paddw mm7,mm5 \ + __asm paddw mm4,mm0 \ + __asm pmulhw mm1,OC_C(6) \ + __asm psubw mm3,mm6 \ + __asm movq OC_I(1),mm4 \ + __asm paddw mm6,mm6 \ + __asm movq mm4,OC_C(4) \ + __asm paddw mm6,mm3 \ + __asm movq mm5,mm3 \ + __asm pmulhw mm3,mm4 \ + __asm movq OC_I(2),mm6 \ + __asm movq mm2,mm0 \ + __asm movq mm6,OC_I(0) \ + __asm pmulhw mm0,mm4 \ + __asm paddw mm5,mm3 \ + __asm paddw mm2,mm0 \ + __asm psubw mm5,mm1 \ + __asm pmulhw mm6,mm4 \ + __asm paddw mm6,OC_I(0) \ + __asm paddw mm1,mm1 \ + __asm movq mm4,mm6 \ + __asm paddw mm1,mm5 \ + __asm psubw mm6,mm2 \ + __asm paddw mm2,mm2 \ + __asm movq mm0,OC_I(1) \ + __asm paddw mm2,mm6 \ + __asm psubw mm2,mm1 \ + __asm nop \ +} + +/*25+8=33 cycles.*/ +#define OC_ROW_IDCT_10 __asm{ \ + OC_IDCT_BEGIN_10 \ + /*r3=D'*/ \ + __asm movq mm3,OC_I(2) \ + /*r4=E'=E-G*/ \ + __asm psubw mm4,mm7 \ + /*r1=H'+H'*/ \ + __asm paddw mm1,mm1 \ + /*r7=G+G*/ \ + __asm paddw mm7,mm7 \ + /*r1=R1=A''+H'*/ \ + __asm paddw mm1,mm2 \ + /*r7=G'=E+G*/ \ + __asm paddw mm7,mm4 \ + /*r4=R4=E'-D'*/ \ + __asm psubw mm4,mm3 \ + __asm paddw mm3,mm3 \ + /*r6=R6=F'-B''*/ \ + __asm psubw mm6,mm5 \ + __asm paddw mm5,mm5 \ + /*r3=R3=E'+D'*/ \ + __asm paddw mm3,mm4 \ + /*r5=R5=F'+B''*/ \ + __asm paddw mm5,mm6 \ + /*r7=R7=G'-C'*/ \ + __asm psubw mm7,mm0 \ + __asm paddw mm0,mm0 \ + /*Save R1.*/ \ + __asm movq OC_I(1),mm1 \ + /*r0=R0=G'+C'*/ \ + __asm paddw mm0,mm7 \ +} + +/*25+19=44 cycles'*/ +#define OC_COLUMN_IDCT_10 __asm{ \ + OC_IDCT_BEGIN_10 \ + __asm paddw mm2,OC_8 \ + /*r1=H'+H'*/ \ + __asm paddw mm1,mm1 \ + /*r1=R1=A''+H'*/ \ + __asm paddw mm1,mm2 \ + /*r2=NR2*/ \ + __asm psraw mm2,4 \ + /*r4=E'=E-G*/ \ + __asm psubw mm4,mm7 \ + /*r1=NR1*/ \ + __asm psraw mm1,4 \ + /*r3=D'*/ \ + __asm movq mm3,OC_I(2) \ + /*r7=G+G*/ \ + __asm paddw mm7,mm7 \ + /*Store NR2 at I(2).*/ \ + __asm movq OC_I(2),mm2 \ + /*r7=G'=E+G*/ \ + __asm paddw mm7,mm4 \ + /*Store NR1 at I(1).*/ \ + __asm movq OC_I(1),mm1 \ + /*r4=R4=E'-D'*/ \ + __asm psubw mm4,mm3 \ + __asm paddw mm4,OC_8 \ + /*r3=D'+D'*/ \ + __asm paddw mm3,mm3 \ + /*r3=R3=E'+D'*/ \ + __asm paddw mm3,mm4 \ + /*r4=NR4*/ \ + __asm psraw mm4,4 \ + /*r6=R6=F'-B''*/ \ + __asm psubw mm6,mm5 \ + /*r3=NR3*/ \ + __asm psraw mm3,4 \ + __asm paddw mm6,OC_8 \ + /*r5=B''+B''*/ \ + __asm paddw mm5,mm5 \ + /*r5=R5=F'+B''*/ \ + __asm paddw mm5,mm6 \ + /*r6=NR6*/ \ + __asm psraw mm6,4 \ + /*Store NR4 at J(4).*/ \ + __asm movq OC_J(4),mm4 \ + /*r5=NR5*/ \ + __asm psraw mm5,4 \ + /*Store NR3 at I(3).*/ \ + __asm movq OC_I(3),mm3 \ + /*r7=R7=G'-C'*/ \ + __asm psubw mm7,mm0 \ + __asm paddw mm7,OC_8 \ + /*r0=C'+C'*/ \ + __asm paddw mm0,mm0 \ + /*r0=R0=G'+C'*/ \ + __asm paddw mm0,mm7 \ + /*r7=NR7*/ \ + __asm psraw mm7,4 \ + /*Store NR6 at J(6).*/ \ + __asm movq OC_J(6),mm6 \ + /*r0=NR0*/ \ + __asm psraw mm0,4 \ + /*Store NR5 at J(5).*/ \ + __asm movq OC_J(5),mm5 \ + /*Store NR7 at J(7).*/ \ + __asm movq OC_J(7),mm7 \ + /*Store NR0 at I(0).*/ \ + __asm movq OC_I(0),mm0 \ +} + +static void oc_idct8x8_10(ogg_int16_t _y[64]){ + __asm{ +#define CONSTS eax +#define Y edx + mov CONSTS,offset OC_IDCT_CONSTS + mov Y,_y +#define OC_I(_k) [Y+_k*16] +#define OC_J(_k) [Y+(_k-4)*16+8] + /*Done with dequant, descramble, and partial transpose. + Now do the iDCT itself.*/ + OC_ROW_IDCT_10 + OC_TRANSPOSE +#undef OC_I +#undef OC_J +#define OC_I(_k) [Y+_k*16] +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT_10 +#undef OC_I +#undef OC_J +#define OC_I(_k) [Y+_k*16+8] +#define OC_J(_k) OC_I(_k) + OC_COLUMN_IDCT_10 +#undef OC_I +#undef OC_J +#undef CONSTS +#undef Y + } +} + +/*Performs an inverse 8x8 Type-II DCT transform. + The input is assumed to be scaled by a factor of 4 relative to orthonormal + version of the transform.*/ +void oc_idct8x8_mmx(ogg_int16_t _y[64],int _last_zzi){ + /*_last_zzi is subtly different from an actual count of the number of + coefficients we decoded for this block. + It contains the value of zzi BEFORE the final token in the block was + decoded. + In most cases this is an EOB token (the continuation of an EOB run from a + previous block counts), and so this is the same as the coefficient count. + However, in the case that the last token was NOT an EOB token, but filled + the block up with exactly 64 coefficients, _last_zzi will be less than 64. + Provided the last token was not a pure zero run, the minimum value it can + be is 46, and so that doesn't affect any of the cases in this routine. + However, if the last token WAS a pure zero run of length 63, then _last_zzi + will be 1 while the number of coefficients decoded is 64. + Thus, we will trigger the following special case, where the real + coefficient count would not. + Note also that a zero run of length 64 will give _last_zzi a value of 0, + but we still process the DC coefficient, which might have a non-zero value + due to DC prediction. + Although convoluted, this is arguably the correct behavior: it allows us to + use a smaller transform when the block ends with a long zero run instead + of a normal EOB token. + It could be smarter... multiple separate zero runs at the end of a block + will fool it, but an encoder that generates these really deserves what it + gets. + Needless to say we inherited this approach from VP3.*/ + /*Perform the iDCT.*/ + if(_last_zzi<10)oc_idct8x8_10(_y); + else oc_idct8x8_slow(_y); +} + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxloop.h b/libs/libtheora-1.1/lib/x86_vc/mmxloop.h new file mode 100644 index 00000000..2561fca2 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxloop.h @@ -0,0 +1,219 @@ +#if !defined(_x86_vc_mmxloop_H) +# define _x86_vc_mmxloop_H (1) +# include +# include "x86int.h" + +#if defined(OC_X86_ASM) + +/*On entry, mm0={a0,...,a7}, mm1={b0,...,b7}, mm2={c0,...,c7}, mm3={d0,...d7}. + On exit, mm1={b0+lflim(R_0,L),...,b7+lflim(R_7,L)} and + mm2={c0-lflim(R_0,L),...,c7-lflim(R_7,L)}; mm0 and mm3 are clobbered.*/ +#define OC_LOOP_FILTER8_MMX __asm{ \ + /*mm7=0*/ \ + __asm pxor mm7,mm7 \ + /*mm6:mm0={a0,...,a7}*/ \ + __asm movq mm6,mm0 \ + __asm punpcklbw mm0,mm7 \ + __asm punpckhbw mm6,mm7 \ + /*mm3:mm5={d0,...,d7}*/ \ + __asm movq mm5,mm3 \ + __asm punpcklbw mm3,mm7 \ + __asm punpckhbw mm5,mm7 \ + /*mm6:mm0={a0-d0,...,a7-d7}*/ \ + __asm psubw mm0,mm3 \ + __asm psubw mm6,mm5 \ + /*mm3:mm1={b0,...,b7}*/ \ + __asm movq mm3,mm1 \ + __asm punpcklbw mm1,mm7 \ + __asm movq mm4,mm2 \ + __asm punpckhbw mm3,mm7 \ + /*mm5:mm4={c0,...,c7}*/ \ + __asm movq mm5,mm2 \ + __asm punpcklbw mm4,mm7 \ + __asm punpckhbw mm5,mm7 \ + /*mm7={3}x4 \ + mm5:mm4={c0-b0,...,c7-b7}*/ \ + __asm pcmpeqw mm7,mm7 \ + __asm psubw mm4,mm1 \ + __asm psrlw mm7,14 \ + __asm psubw mm5,mm3 \ + /*Scale by 3.*/ \ + __asm pmullw mm4,mm7 \ + __asm pmullw mm5,mm7 \ + /*mm7={4}x4 \ + mm5:mm4=f={a0-d0+3*(c0-b0),...,a7-d7+3*(c7-b7)}*/ \ + __asm psrlw mm7,1 \ + __asm paddw mm4,mm0 \ + __asm psllw mm7,2 \ + __asm movq mm0,[LL] \ + __asm paddw mm5,mm6 \ + /*R_i has the range [-127,128], so we compute -R_i instead. \ + mm4=-R_i=-(f+4>>3)=0xFF^(f-4>>3)*/ \ + __asm psubw mm4,mm7 \ + __asm psubw mm5,mm7 \ + __asm psraw mm4,3 \ + __asm psraw mm5,3 \ + __asm pcmpeqb mm7,mm7 \ + __asm packsswb mm4,mm5 \ + __asm pxor mm6,mm6 \ + __asm pxor mm4,mm7 \ + __asm packuswb mm1,mm3 \ + /*Now compute lflim of -mm4 cf. Section 7.10 of the sepc.*/ \ + /*There's no unsigned byte+signed byte with unsigned saturation op code, so \ + we have to split things by sign (the other option is to work in 16 bits, \ + but working in 8 bits gives much better parallelism). \ + We compute abs(R_i), but save a mask of which terms were negative in mm6. \ + Then we compute mm4=abs(lflim(R_i,L))=min(abs(R_i),max(2*L-abs(R_i),0)). \ + Finally, we split mm4 into positive and negative pieces using the mask in \ + mm6, and add and subtract them as appropriate.*/ \ + /*mm4=abs(-R_i)*/ \ + /*mm7=255-2*L*/ \ + __asm pcmpgtb mm6,mm4 \ + __asm psubb mm7,mm0 \ + __asm pxor mm4,mm6 \ + __asm psubb mm7,mm0 \ + __asm psubb mm4,mm6 \ + /*mm7=255-max(2*L-abs(R_i),0)*/ \ + __asm paddusb mm7,mm4 \ + /*mm4=min(abs(R_i),max(2*L-abs(R_i),0))*/ \ + __asm paddusb mm4,mm7 \ + __asm psubusb mm4,mm7 \ + /*Now split mm4 by the original sign of -R_i.*/ \ + __asm movq mm5,mm4 \ + __asm pand mm4,mm6 \ + __asm pandn mm6,mm5 \ + /*mm1={b0+lflim(R_0,L),...,b7+lflim(R_7,L)}*/ \ + /*mm2={c0-lflim(R_0,L),...,c7-lflim(R_7,L)}*/ \ + __asm paddusb mm1,mm4 \ + __asm psubusb mm2,mm4 \ + __asm psubusb mm1,mm6 \ + __asm paddusb mm2,mm6 \ +} + +#define OC_LOOP_FILTER_V_MMX(_pix,_ystride,_ll) \ + do{ \ + /*Used local variable pix__ in order to fix compilation errors like: \ + "error C2425: 'SHL' : non-constant expression in 'second operand'".*/ \ + unsigned char *pix__; \ + unsigned char *ll__; \ + ll__=(_ll); \ + pix__=(_pix); \ + __asm mov YSTRIDE,_ystride \ + __asm mov LL,ll__ \ + __asm mov PIX,pix__ \ + __asm sub PIX,YSTRIDE \ + __asm sub PIX,YSTRIDE \ + /*mm0={a0,...,a7}*/ \ + __asm movq mm0,[PIX] \ + /*ystride3=_ystride*3*/ \ + __asm lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] \ + /*mm3={d0,...,d7}*/ \ + __asm movq mm3,[PIX+YSTRIDE3] \ + /*mm1={b0,...,b7}*/ \ + __asm movq mm1,[PIX+YSTRIDE] \ + /*mm2={c0,...,c7}*/ \ + __asm movq mm2,[PIX+YSTRIDE*2] \ + OC_LOOP_FILTER8_MMX \ + /*Write it back out.*/ \ + __asm movq [PIX+YSTRIDE],mm1 \ + __asm movq [PIX+YSTRIDE*2],mm2 \ + } \ + while(0) + +#define OC_LOOP_FILTER_H_MMX(_pix,_ystride,_ll) \ + do{ \ + /*Used local variable ll__ in order to fix compilation errors like: \ + "error C2443: operand size conflict".*/ \ + unsigned char *ll__; \ + unsigned char *pix__; \ + ll__=(_ll); \ + pix__=(_pix)-2; \ + __asm mov PIX,pix__ \ + __asm mov YSTRIDE,_ystride \ + __asm mov LL,ll__ \ + /*x x x x d0 c0 b0 a0*/ \ + __asm movd mm0,[PIX] \ + /*x x x x d1 c1 b1 a1*/ \ + __asm movd mm1,[PIX+YSTRIDE] \ + /*ystride3=_ystride*3*/ \ + __asm lea YSTRIDE3,[YSTRIDE+YSTRIDE*2] \ + /*x x x x d2 c2 b2 a2*/ \ + __asm movd mm2,[PIX+YSTRIDE*2] \ + /*x x x x d3 c3 b3 a3*/ \ + __asm lea D,[PIX+YSTRIDE*4] \ + __asm movd mm3,[PIX+YSTRIDE3] \ + /*x x x x d4 c4 b4 a4*/ \ + __asm movd mm4,[D] \ + /*x x x x d5 c5 b5 a5*/ \ + __asm movd mm5,[D+YSTRIDE] \ + /*x x x x d6 c6 b6 a6*/ \ + __asm movd mm6,[D+YSTRIDE*2] \ + /*x x x x d7 c7 b7 a7*/ \ + __asm movd mm7,[D+YSTRIDE3] \ + /*mm0=d1 d0 c1 c0 b1 b0 a1 a0*/ \ + __asm punpcklbw mm0,mm1 \ + /*mm2=d3 d2 c3 c2 b3 b2 a3 a2*/ \ + __asm punpcklbw mm2,mm3 \ + /*mm3=d1 d0 c1 c0 b1 b0 a1 a0*/ \ + __asm movq mm3,mm0 \ + /*mm0=b3 b2 b1 b0 a3 a2 a1 a0*/ \ + __asm punpcklwd mm0,mm2 \ + /*mm3=d3 d2 d1 d0 c3 c2 c1 c0*/ \ + __asm punpckhwd mm3,mm2 \ + /*mm1=b3 b2 b1 b0 a3 a2 a1 a0*/ \ + __asm movq mm1,mm0 \ + /*mm4=d5 d4 c5 c4 b5 b4 a5 a4*/ \ + __asm punpcklbw mm4,mm5 \ + /*mm6=d7 d6 c7 c6 b7 b6 a7 a6*/ \ + __asm punpcklbw mm6,mm7 \ + /*mm5=d5 d4 c5 c4 b5 b4 a5 a4*/ \ + __asm movq mm5,mm4 \ + /*mm4=b7 b6 b5 b4 a7 a6 a5 a4*/ \ + __asm punpcklwd mm4,mm6 \ + /*mm5=d7 d6 d5 d4 c7 c6 c5 c4*/ \ + __asm punpckhwd mm5,mm6 \ + /*mm2=d3 d2 d1 d0 c3 c2 c1 c0*/ \ + __asm movq mm2,mm3 \ + /*mm0=a7 a6 a5 a4 a3 a2 a1 a0*/ \ + __asm punpckldq mm0,mm4 \ + /*mm1=b7 b6 b5 b4 b3 b2 b1 b0*/ \ + __asm punpckhdq mm1,mm4 \ + /*mm2=c7 c6 c5 c4 c3 c2 c1 c0*/ \ + __asm punpckldq mm2,mm5 \ + /*mm3=d7 d6 d5 d4 d3 d2 d1 d0*/ \ + __asm punpckhdq mm3,mm5 \ + OC_LOOP_FILTER8_MMX \ + /*mm2={b0+R_0'',...,b7+R_7''}*/ \ + __asm movq mm0,mm1 \ + /*mm1={b0+R_0'',c0-R_0'',...,b3+R_3'',c3-R_3''}*/ \ + __asm punpcklbw mm1,mm2 \ + /*mm2={b4+R_4'',c4-R_4'',...,b7+R_7'',c7-R_7''}*/ \ + __asm punpckhbw mm0,mm2 \ + /*[d]=c1 b1 c0 b0*/ \ + __asm movd D,mm1 \ + __asm mov [PIX+1],D_WORD \ + __asm psrlq mm1,32 \ + __asm shr D,16 \ + __asm mov [PIX+YSTRIDE+1],D_WORD \ + /*[d]=c3 b3 c2 b2*/ \ + __asm movd D,mm1 \ + __asm mov [PIX+YSTRIDE*2+1],D_WORD \ + __asm shr D,16 \ + __asm mov [PIX+YSTRIDE3+1],D_WORD \ + __asm lea PIX,[PIX+YSTRIDE*4] \ + /*[d]=c5 b5 c4 b4*/ \ + __asm movd D,mm0 \ + __asm mov [PIX+1],D_WORD \ + __asm psrlq mm0,32 \ + __asm shr D,16 \ + __asm mov [PIX+YSTRIDE+1],D_WORD \ + /*[d]=c7 b7 c6 b6*/ \ + __asm movd D,mm0 \ + __asm mov [PIX+YSTRIDE*2+1],D_WORD \ + __asm shr D,16 \ + __asm mov [PIX+YSTRIDE3+1],D_WORD \ + } \ + while(0) + +# endif +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/mmxstate.c b/libs/libtheora-1.1/lib/x86_vc/mmxstate.c new file mode 100644 index 00000000..fb1eba0f --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/mmxstate.c @@ -0,0 +1,211 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: mmxstate.c 16584 2009-09-26 19:35:55Z tterribe $ + + ********************************************************************/ + +/*MMX acceleration of complete fragment reconstruction algorithm. + Originally written by Rudolf Marek.*/ +#include +#include "x86int.h" +#include "mmxfrag.h" +#include "mmxloop.h" + +#if defined(OC_X86_ASM) + +void oc_state_frag_recon_mmx(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant){ + unsigned char *dst; + ptrdiff_t frag_buf_off; + int ystride; + int mb_mode; + /*Apply the inverse transform.*/ + /*Special case only having a DC component.*/ + if(_last_zzi<2){ + /*Note that this value must be unsigned, to keep the __asm__ block from + sign-extending it when it puts it in a register.*/ + ogg_uint16_t p; + /*We round this dequant product (and not any of the others) because there's + no iDCT rounding.*/ + p=(ogg_int16_t)(_dct_coeffs[0]*(ogg_int32_t)_dc_quant+15>>5); + /*Fill _dct_coeffs with p.*/ + __asm{ +#define Y eax +#define P ecx + mov Y,_dct_coeffs + movzx P,p + /*mm0=0000 0000 0000 AAAA*/ + movd mm0,P + /*mm0=0000 0000 AAAA AAAA*/ + punpcklwd mm0,mm0 + /*mm0=AAAA AAAA AAAA AAAA*/ + punpckldq mm0,mm0 + movq [Y],mm0 + movq [8+Y],mm0 + movq [16+Y],mm0 + movq [24+Y],mm0 + movq [32+Y],mm0 + movq [40+Y],mm0 + movq [48+Y],mm0 + movq [56+Y],mm0 + movq [64+Y],mm0 + movq [72+Y],mm0 + movq [80+Y],mm0 + movq [88+Y],mm0 + movq [96+Y],mm0 + movq [104+Y],mm0 + movq [112+Y],mm0 + movq [120+Y],mm0 +#undef Y +#undef P + } + } + else{ + /*Dequantize the DC coefficient.*/ + _dct_coeffs[0]=(ogg_int16_t)(_dct_coeffs[0]*(int)_dc_quant); + oc_idct8x8_mmx(_dct_coeffs,_last_zzi); + } + /*Fill in the target buffer.*/ + frag_buf_off=_state->frag_buf_offs[_fragi]; + mb_mode=_state->frags[_fragi].mb_mode; + ystride=_state->ref_ystride[_pli]; + dst=_state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_SELF]]+frag_buf_off; + if(mb_mode==OC_MODE_INTRA)oc_frag_recon_intra_mmx(dst,ystride,_dct_coeffs); + else{ + const unsigned char *ref; + int mvoffsets[2]; + ref= + _state->ref_frame_data[_state->ref_frame_idx[OC_FRAME_FOR_MODE(mb_mode)]] + +frag_buf_off; + if(oc_state_get_mv_offsets(_state,mvoffsets,_pli, + _state->frag_mvs[_fragi][0],_state->frag_mvs[_fragi][1])>1){ + oc_frag_recon_inter2_mmx(dst,ref+mvoffsets[0],ref+mvoffsets[1],ystride, + _dct_coeffs); + } + else oc_frag_recon_inter_mmx(dst,ref+mvoffsets[0],ystride,_dct_coeffs); + } +} + +/*We copy these entire function to inline the actual MMX routines so that we + use only a single indirect call.*/ + +/*Copies the fragments specified by the lists of fragment indices from one + frame to another. + _fragis: A pointer to a list of fragment indices. + _nfragis: The number of fragment indices to copy. + _dst_frame: The reference frame to copy to. + _src_frame: The reference frame to copy from. + _pli: The color plane the fragments lie in.*/ +void oc_state_frag_copy_list_mmx(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli){ + const ptrdiff_t *frag_buf_offs; + const unsigned char *src_frame_data; + unsigned char *dst_frame_data; + ptrdiff_t fragii; + int ystride; + dst_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_dst_frame]]; + src_frame_data=_state->ref_frame_data[_state->ref_frame_idx[_src_frame]]; + ystride=_state->ref_ystride[_pli]; + frag_buf_offs=_state->frag_buf_offs; + for(fragii=0;fragii<_nfragis;fragii++){ + ptrdiff_t frag_buf_off; + frag_buf_off=frag_buf_offs[_fragis[fragii]]; +#define SRC edx +#define DST eax +#define YSTRIDE ecx +#define YSTRIDE3 edi + OC_FRAG_COPY_MMX(dst_frame_data+frag_buf_off, + src_frame_data+frag_buf_off,ystride); +#undef SRC +#undef DST +#undef YSTRIDE +#undef YSTRIDE3 + } +} + +/*Apply the loop filter to a given set of fragment rows in the given plane. + The filter may be run on the bottom edge, affecting pixels in the next row of + fragments, so this row also needs to be available. + _bv: The bounding values array. + _refi: The index of the frame buffer to filter. + _pli: The color plane to filter. + _fragy0: The Y coordinate of the first fragment row to filter. + _fragy_end: The Y coordinate of the fragment row to stop filtering at.*/ +void oc_state_loop_filter_frag_rows_mmx(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end){ + OC_ALIGN8(unsigned char ll[8]); + const oc_fragment_plane *fplane; + const oc_fragment *frags; + const ptrdiff_t *frag_buf_offs; + unsigned char *ref_frame_data; + ptrdiff_t fragi_top; + ptrdiff_t fragi_bot; + ptrdiff_t fragi0; + ptrdiff_t fragi0_end; + int ystride; + int nhfrags; + memset(ll,_state->loop_filter_limits[_state->qis[0]],sizeof(ll)); + fplane=_state->fplanes+_pli; + nhfrags=fplane->nhfrags; + fragi_top=fplane->froffset; + fragi_bot=fragi_top+fplane->nfrags; + fragi0=fragi_top+_fragy0*(ptrdiff_t)nhfrags; + fragi0_end=fragi0+(_fragy_end-_fragy0)*(ptrdiff_t)nhfrags; + ystride=_state->ref_ystride[_pli]; + frags=_state->frags; + frag_buf_offs=_state->frag_buf_offs; + ref_frame_data=_state->ref_frame_data[_refi]; + /*The following loops are constructed somewhat non-intuitively on purpose. + The main idea is: if a block boundary has at least one coded fragment on + it, the filter is applied to it. + However, the order that the filters are applied in matters, and VP3 chose + the somewhat strange ordering used below.*/ + while(fragi0fragi0)OC_LOOP_FILTER_H_MMX(ref,ystride,ll); + if(fragi0>fragi_top)OC_LOOP_FILTER_V_MMX(ref,ystride,ll); + if(fragi+1opt_vtable.frag_sub=oc_enc_frag_sub_mmx; + _enc->opt_vtable.frag_sub_128=oc_enc_frag_sub_128_mmx; + _enc->opt_vtable.frag_recon_intra=oc_frag_recon_intra_mmx; + _enc->opt_vtable.frag_recon_inter=oc_frag_recon_inter_mmx; + _enc->opt_vtable.fdct8x8=oc_enc_fdct8x8_mmx; + } + if(cpu_flags&OC_CPU_X86_MMXEXT){ + _enc->opt_vtable.frag_sad=oc_enc_frag_sad_mmxext; + _enc->opt_vtable.frag_sad_thresh=oc_enc_frag_sad_thresh_mmxext; + _enc->opt_vtable.frag_sad2_thresh=oc_enc_frag_sad2_thresh_mmxext; + _enc->opt_vtable.frag_satd_thresh=oc_enc_frag_satd_thresh_mmxext; + _enc->opt_vtable.frag_satd2_thresh=oc_enc_frag_satd2_thresh_mmxext; + _enc->opt_vtable.frag_intra_satd=oc_enc_frag_intra_satd_mmxext; + _enc->opt_vtable.frag_copy2=oc_enc_frag_copy2_mmxext; + } + if(cpu_flags&OC_CPU_X86_SSE2){ +# if defined(OC_X86_64_ASM) + _enc->opt_vtable.fdct8x8=oc_enc_fdct8x8_x86_64sse2; +# endif + } +} +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/x86enc.h b/libs/libtheora-1.1/lib/x86_vc/x86enc.h new file mode 100644 index 00000000..58148464 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/x86enc.h @@ -0,0 +1,47 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86int.h 15675 2009-02-06 09:43:27Z tterribe $ + + ********************************************************************/ + +#if !defined(_x86_vc_x86enc_H) +# define _x86_vc_x86enc_H (1) +# include "../encint.h" +# include "x86int.h" + +void oc_enc_vtable_init_x86(oc_enc_ctx *_enc); + +unsigned oc_enc_frag_sad_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride); +unsigned oc_enc_frag_sad_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_sad2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_satd_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref,int _ystride,unsigned _thresh); +unsigned oc_enc_frag_satd2_thresh_mmxext(const unsigned char *_src, + const unsigned char *_ref1,const unsigned char *_ref2,int _ystride, + unsigned _thresh); +unsigned oc_enc_frag_intra_satd_mmxext(const unsigned char *_src,int _ystride); +void oc_enc_frag_sub_mmx(ogg_int16_t _diff[64], + const unsigned char *_x,const unsigned char *_y,int _stride); +void oc_enc_frag_sub_128_mmx(ogg_int16_t _diff[64], + const unsigned char *_x,int _stride); +void oc_enc_frag_copy2_mmxext(unsigned char *_dst, + const unsigned char *_src1,const unsigned char *_src2,int _ystride); +void oc_enc_fdct8x8_mmx(ogg_int16_t _y[64],const ogg_int16_t _x[64]); +void oc_enc_fdct8x8_x86_64sse2(ogg_int16_t _y[64],const ogg_int16_t _x[64]); + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/x86int.h b/libs/libtheora-1.1/lib/x86_vc/x86int.h new file mode 100644 index 00000000..5acabbc0 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/x86int.h @@ -0,0 +1,42 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86int.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#if !defined(_x86_vc_x86int_H) +# define _x86_vc_x86int_H (1) +# include "../internal.h" + +void oc_state_vtable_init_x86(oc_theora_state *_state); + +void oc_frag_copy_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride); +void oc_frag_recon_intra_mmx(unsigned char *_dst,int _ystride, + const ogg_int16_t *_residue); +void oc_frag_recon_inter_mmx(unsigned char *_dst, + const unsigned char *_src,int _ystride,const ogg_int16_t *_residue); +void oc_frag_recon_inter2_mmx(unsigned char *_dst,const unsigned char *_src1, + const unsigned char *_src2,int _ystride,const ogg_int16_t *_residue); +void oc_idct8x8_mmx(ogg_int16_t _y[64],int _last_zzi); +void oc_state_frag_recon_mmx(const oc_theora_state *_state,ptrdiff_t _fragi, + int _pli,ogg_int16_t _dct_coeffs[64],int _last_zzi,ogg_uint16_t _dc_quant); +void oc_state_frag_copy_list_mmx(const oc_theora_state *_state, + const ptrdiff_t *_fragis,ptrdiff_t _nfragis, + int _dst_frame,int _src_frame,int _pli); +void oc_state_loop_filter_frag_rows_mmx(const oc_theora_state *_state, + int _bv[256],int _refi,int _pli,int _fragy0,int _fragy_end); +void oc_restore_fpu_mmx(void); + +#endif diff --git a/libs/libtheora-1.1/lib/x86_vc/x86state.c b/libs/libtheora-1.1/lib/x86_vc/x86state.c new file mode 100644 index 00000000..8450b644 --- /dev/null +++ b/libs/libtheora-1.1/lib/x86_vc/x86state.c @@ -0,0 +1,62 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation and contributors http://www.xiph.org/ * + * * + ******************************************************************** + + function: + last mod: $Id: x86state.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include "x86int.h" + +#if defined(OC_X86_ASM) + +#include "../cpu.c" + +/*This table has been modified from OC_FZIG_ZAG by baking a 4x4 transpose into + each quadrant of the destination.*/ +static const unsigned char OC_FZIG_ZAG_MMX[128]={ + 0, 8, 1, 2, 9,16,24,17, + 10, 3,32,11,18,25, 4,12, + 5,26,19,40,33,34,41,48, + 27, 6,13,20,28,21,14, 7, + 56,49,42,35,43,50,57,36, + 15,22,29,30,23,44,37,58, + 51,59,38,45,52,31,60,53, + 46,39,47,54,61,62,55,63, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, + 64,64,64,64,64,64,64,64, +}; + +void oc_state_vtable_init_x86(oc_theora_state *_state){ + _state->cpu_flags=oc_cpu_flags_get(); + if(_state->cpu_flags&OC_CPU_X86_MMX){ + _state->opt_vtable.frag_copy=oc_frag_copy_mmx; + _state->opt_vtable.frag_recon_intra=oc_frag_recon_intra_mmx; + _state->opt_vtable.frag_recon_inter=oc_frag_recon_inter_mmx; + _state->opt_vtable.frag_recon_inter2=oc_frag_recon_inter2_mmx; + _state->opt_vtable.idct8x8=oc_idct8x8_mmx; + _state->opt_vtable.state_frag_recon=oc_state_frag_recon_mmx; + _state->opt_vtable.state_frag_copy_list=oc_state_frag_copy_list_mmx; + _state->opt_vtable.state_loop_filter_frag_rows= + oc_state_loop_filter_frag_rows_mmx; + _state->opt_vtable.restore_fpu=oc_restore_fpu_mmx; + _state->opt_data.dct_fzig_zag=OC_FZIG_ZAG_MMX; + } + else oc_state_vtable_init_c(_state); +} +#endif diff --git a/libs/libtheora-1.1/libtheora.spec.in b/libs/libtheora-1.1/libtheora.spec.in new file mode 100644 index 00000000..798ff98b --- /dev/null +++ b/libs/libtheora-1.1/libtheora.spec.in @@ -0,0 +1,82 @@ +Name: libtheora +Version: @VERSION@ +Release: 0.xiph.0.4.alpha5 +Summary: The Theora Video Compression Codec. + +Group: System Environment/Libraries +License: BSD +URL: http://www.theora.org/ +Vendor: Xiph.org Foundation +Source: http://downloads.xiph.org/releases/theora/%{name}-%{version}.tar.gz +BuildRoot: %{_tmppath}/%{name}-%{version}-root + +BuildRequires: libogg-devel >= 2:1.1 +BuildRequires: libvorbis-devel >= 1:1.0.1 +BuildRequires: SDL-devel + +# this needs to be explicit since vorbis's .so versioning didn't get bumped +# when going from 1.0 to 1.0.1 +Requires: libvorbis >= 1:1.0.1 + +%description +Theora is Xiph.Org's first publicly released video codec, intended +for use within the Ogg's project's Ogg multimedia streaming system. +Theora is derived directly from On2's VP3 codec; Currently the two are +nearly identical, varying only in encapsulating decoder tables in the +bitstream headers, but Theora will make use of this extra freedom +in the future to improve over what is possible with VP3. + +%package devel +Summary: Development tools for Theora applications. +Group: Development/Libraries +Requires: %{name} = %{version}-%{release} +Requires: libogg-devel >= 2:1.1 + +%description devel +The libtheora-devel package contains the header files and documentation +needed to develop applications with Ogg Theora. + +%prep +%setup -q -n %{name}-%{version} + +%build +%configure --enable-shared +make + +%install +rm -rf $RPM_BUILD_ROOT +# make sure our temp doc build dir is removed +rm -rf $(pwd)/__docs + +%makeinstall docdir=$(pwd)/__docs + +find $RPM_BUILD_ROOT -type f -name "*.la" -exec rm -f {} ';' + +%clean +rm -rf $RPM_BUILD_ROOT + +%post -p /sbin/ldconfig + +%postun -p /sbin/ldconfig + +%files +%defattr(-,root,root) +%doc COPYING README +%{_libdir}/libtheora.so.* + +%files devel +%defattr(-,root,root,-) +%doc __docs/* +%{_libdir}/libtheora.a +%{_libdir}/libtheora.so +%dir %{_includedir}/theora +%{_includedir}/theora/codec.h +%{_includedir}/theora/theora.h +%{_includedir}/theora/theoradec.h +%{_libdir}/pkgconfig/theora.pc + +%changelog +* Sat Aug 20 2005 Ralph Giles +- updated version for 1.0alpha5 release +* Thu Jun 10 2004 Thomas Vander Stichele +- transported fedora.us spec file diff --git a/libs/libtheora-1.1/m4/Makefile.am b/libs/libtheora-1.1/m4/Makefile.am new file mode 100644 index 00000000..51d571f7 --- /dev/null +++ b/libs/libtheora-1.1/m4/Makefile.am @@ -0,0 +1,6 @@ +EXTRA_DIST = \ + as-ac-expand.m4 \ + ogg.m4 \ + pkg.m4 \ + sdl.m4 \ + vorbis.m4 diff --git a/libs/libtheora-1.1/m4/as-ac-expand.m4 b/libs/libtheora-1.1/m4/as-ac-expand.m4 new file mode 100644 index 00000000..d6c9e330 --- /dev/null +++ b/libs/libtheora-1.1/m4/as-ac-expand.m4 @@ -0,0 +1,43 @@ +dnl as-ac-expand.m4 0.2.0 +dnl autostars m4 macro for expanding directories using configure's prefix +dnl thomas@apestaart.org + +dnl AS_AC_EXPAND(VAR, CONFIGURE_VAR) +dnl example +dnl AS_AC_EXPAND(SYSCONFDIR, $sysconfdir) +dnl will set SYSCONFDIR to /usr/local/etc if prefix=/usr/local + +AC_DEFUN([AS_AC_EXPAND], +[ + EXP_VAR=[$1] + FROM_VAR=[$2] + + dnl first expand prefix and exec_prefix if necessary + prefix_save=$prefix + exec_prefix_save=$exec_prefix + + dnl if no prefix given, then use /usr/local, the default prefix + if test "x$prefix" = "xNONE"; then + prefix="$ac_default_prefix" + fi + dnl if no exec_prefix given, then use prefix + if test "x$exec_prefix" = "xNONE"; then + exec_prefix=$prefix + fi + + full_var="$FROM_VAR" + dnl loop until it doesn't change anymore + while true; do + new_full_var="`eval echo $full_var`" + if test "x$new_full_var" = "x$full_var"; then break; fi + full_var=$new_full_var + done + + dnl clean up + full_var=$new_full_var + AC_SUBST([$1], "$full_var") + + dnl restore prefix and exec_prefix + prefix=$prefix_save + exec_prefix=$exec_prefix_save +]) diff --git a/libs/libtheora-1.1/m4/ogg.m4 b/libs/libtheora-1.1/m4/ogg.m4 new file mode 100644 index 00000000..db91a6d8 --- /dev/null +++ b/libs/libtheora-1.1/m4/ogg.m4 @@ -0,0 +1,116 @@ +# Configure paths for libogg +# Jack Moffitt 10-21-2000 +# Shamelessly stolen from Owen Taylor and Manish Singh + +dnl XIPH_PATH_OGG([ACTION-IF-FOUND [, ACTION-IF-NOT-FOUND]]) +dnl Test for libogg, and define OGG_CFLAGS and OGG_LIBS +dnl +AC_DEFUN([XIPH_PATH_OGG], +[dnl +dnl Get the cflags and libraries +dnl +AC_ARG_WITH(ogg,AC_HELP_STRING([--with-ogg=PFX],[Prefix where libogg is installed (optional)]), ogg_prefix="$withval", ogg_prefix="") +AC_ARG_WITH(ogg-libraries,AC_HELP_STRING([--with-ogg-libraries=DIR],[Directory where libogg library is installed (optional)]), ogg_libraries="$withval", ogg_libraries="") +AC_ARG_WITH(ogg-includes,AC_HELP_STRING([--with-ogg-includes=DIR],[Directory where libogg header files are installed (optional)]), ogg_includes="$withval", ogg_includes="") +AC_ARG_ENABLE(oggtest,AC_HELP_STRING([--disable-oggtest],[Do not try to compile and run a test Ogg program]),, enable_oggtest=yes) + + if test "x$ogg_libraries" != "x" ; then + OGG_LIBS="-L$ogg_libraries" + elif test "x$ogg_prefix" = "xno" || test "x$ogg_prefix" = "xyes" ; then + OGG_LIBS="" + elif test "x$ogg_prefix" != "x" ; then + OGG_LIBS="-L$ogg_prefix/lib" + elif test "x$prefix" != "xNONE" ; then + OGG_LIBS="-L$libdir" + fi + + if test "x$ogg_prefix" != "xno" ; then + OGG_LIBS="$OGG_LIBS -logg" + fi + + if test "x$ogg_includes" != "x" ; then + OGG_CFLAGS="-I$ogg_includes" + elif test "x$ogg_prefix" = "xno" || test "x$ogg_prefix" = "xyes" ; then + OGG_CFLAGS="" + elif test "x$ogg_prefix" != "x" ; then + OGG_CFLAGS="-I$ogg_prefix/include" + elif test "x$prefix" != "xNONE"; then + OGG_CFLAGS="" + fi + + AC_MSG_CHECKING(for Ogg) + if test "x$ogg_prefix" = "xno" ; then + no_ogg="disabled" + enable_oggtest="no" + else + no_ogg="" + fi + + + if test "x$enable_oggtest" = "xyes" ; then + ac_save_CFLAGS="$CFLAGS" + ac_save_LIBS="$LIBS" + CFLAGS="$CFLAGS $OGG_CFLAGS" + LIBS="$LIBS $OGG_LIBS" +dnl +dnl Now check if the installed Ogg is sufficiently new. +dnl + rm -f conf.oggtest + AC_TRY_RUN([ +#include +#include +#include +#include + +int main () +{ + system("touch conf.oggtest"); + return 0; +} + +],, no_ogg=yes,[echo $ac_n "cross compiling; assumed OK... $ac_c"]) + CFLAGS="$ac_save_CFLAGS" + LIBS="$ac_save_LIBS" + fi + + if test "x$no_ogg" = "xdisabled" ; then + AC_MSG_RESULT(no) + ifelse([$2], , :, [$2]) + elif test "x$no_ogg" = "x" ; then + AC_MSG_RESULT(yes) + ifelse([$1], , :, [$1]) + else + AC_MSG_RESULT(no) + if test -f conf.oggtest ; then + : + else + echo "*** Could not run Ogg test program, checking why..." + CFLAGS="$CFLAGS $OGG_CFLAGS" + LIBS="$LIBS $OGG_LIBS" + AC_TRY_LINK([ +#include +#include +], [ return 0; ], + [ echo "*** The test program compiled, but did not run. This usually means" + echo "*** that the run-time linker is not finding Ogg or finding the wrong" + echo "*** version of Ogg. If it is not finding Ogg, you'll need to set your" + echo "*** LD_LIBRARY_PATH environment variable, or edit /etc/ld.so.conf to point" + echo "*** to the installed location Also, make sure you have run ldconfig if that" + echo "*** is required on your system" + echo "***" + echo "*** If you have an old version installed, it is best to remove it, although" + echo "*** you may also be able to get things to work by modifying LD_LIBRARY_PATH"], + [ echo "*** The test program failed to compile or link. See the file config.log for the" + echo "*** exact error that occured. This usually means Ogg was incorrectly installed" + echo "*** or that you have moved Ogg since it was installed." ]) + CFLAGS="$ac_save_CFLAGS" + LIBS="$ac_save_LIBS" + fi + OGG_CFLAGS="" + OGG_LIBS="" + ifelse([$2], , :, [$2]) + fi + AC_SUBST(OGG_CFLAGS) + AC_SUBST(OGG_LIBS) + rm -f conf.oggtest +]) diff --git a/libs/libtheora-1.1/m4/pkg.m4 b/libs/libtheora-1.1/m4/pkg.m4 new file mode 100644 index 00000000..996e2945 --- /dev/null +++ b/libs/libtheora-1.1/m4/pkg.m4 @@ -0,0 +1,157 @@ +# pkg.m4 - Macros to locate and utilise pkg-config. -*- Autoconf -*- +# +# Copyright © 2004 Scott James Remnant . +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +# +# As a special exception to the GNU General Public License, if you +# distribute this file as part of a program that contains a +# configuration script generated by Autoconf, you may include it under +# the same distribution terms that you use for the rest of that program. + +# PKG_PROG_PKG_CONFIG([MIN-VERSION]) +# ---------------------------------- +AC_DEFUN([PKG_PROG_PKG_CONFIG], +[m4_pattern_forbid([^_?PKG_[A-Z_]+$]) +m4_pattern_allow([^PKG_CONFIG(_PATH)?$]) +AC_ARG_VAR([PKG_CONFIG], [path to pkg-config utility])dnl +if test "x$ac_cv_env_PKG_CONFIG_set" != "xset"; then + AC_PATH_TOOL([PKG_CONFIG], [pkg-config]) +fi +if test -n "$PKG_CONFIG"; then + _pkg_min_version=m4_default([$1], [0.9.0]) + AC_MSG_CHECKING([pkg-config is at least version $_pkg_min_version]) + if $PKG_CONFIG --atleast-pkgconfig-version $_pkg_min_version; then + AC_MSG_RESULT([yes]) + else + AC_MSG_RESULT([no]) + PKG_CONFIG="" + fi + +fi[]dnl +])# PKG_PROG_PKG_CONFIG + +# PKG_CHECK_EXISTS(MODULES, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND]) +# +# Check to see whether a particular set of modules exists. Similar +# to PKG_CHECK_MODULES(), but does not set variables or print errors. +# +# +# Similar to PKG_CHECK_MODULES, make sure that the first instance of +# this or PKG_CHECK_MODULES is called, or make sure to call +# PKG_CHECK_EXISTS manually +# -------------------------------------------------------------- +AC_DEFUN([PKG_CHECK_EXISTS], +[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl +if test -n "$PKG_CONFIG" && \ + AC_RUN_LOG([$PKG_CONFIG --exists --print-errors "$1"]); then + m4_ifval([$2], [$2], [:]) +m4_ifvaln([$3], [else + $3])dnl +fi]) + + +# _PKG_CONFIG([VARIABLE], [COMMAND], [MODULES]) +# --------------------------------------------- +m4_define([_PKG_CONFIG], +[if test -n "$PKG_CONFIG"; then + if test -n "$$1"; then + pkg_cv_[]$1="$$1" + else + PKG_CHECK_EXISTS([$3], + [pkg_cv_[]$1=`$PKG_CONFIG --[]$2 "$3" 2>/dev/null`], + [pkg_failed=yes]) + fi +else + pkg_failed=untried +fi[]dnl +])# _PKG_CONFIG + +# _PKG_SHORT_ERRORS_SUPPORTED +# ----------------------------- +AC_DEFUN([_PKG_SHORT_ERRORS_SUPPORTED], +[AC_REQUIRE([PKG_PROG_PKG_CONFIG]) +if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then + _pkg_short_errors_supported=yes +else + _pkg_short_errors_supported=no +fi[]dnl +])# _PKG_SHORT_ERRORS_SUPPORTED + + +# PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND], +# [ACTION-IF-NOT-FOUND]) +# +# +# Note that if there is a possibility the first call to +# PKG_CHECK_MODULES might not happen, you should be sure to include an +# explicit call to PKG_PROG_PKG_CONFIG in your configure.ac +# +# +# -------------------------------------------------------------- +AC_DEFUN([PKG_CHECK_MODULES], +[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl +AC_ARG_VAR([$1][_CFLAGS], [C compiler flags for $1, overriding pkg-config])dnl +AC_ARG_VAR([$1][_LIBS], [linker flags for $1, overriding pkg-config])dnl + +pkg_failed=no +AC_MSG_CHECKING([for $1]) + +_PKG_CONFIG([$1][_CFLAGS], [cflags], [$2]) +_PKG_CONFIG([$1][_LIBS], [libs], [$2]) + +m4_define([_PKG_TEXT], [Alternatively, you may set the environment variables $1[]_CFLAGS +and $1[]_LIBS to avoid the need to call pkg-config. +See the pkg-config man page for more details.]) + +if test $pkg_failed = yes; then + _PKG_SHORT_ERRORS_SUPPORTED + if test $_pkg_short_errors_supported = yes; then + $1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --errors-to-stdout --print-errors "$2"` + else + $1[]_PKG_ERRORS=`$PKG_CONFIG --errors-to-stdout --print-errors "$2"` + fi + # Put the nasty error message in config.log where it belongs + echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD + + ifelse([$4], , [AC_MSG_ERROR(dnl +[Package requirements ($2) were not met: + +$$1_PKG_ERRORS + +Consider adjusting the PKG_CONFIG_PATH environment variable if you +installed software in a non-standard prefix. + +_PKG_TEXT +])], + [AC_MSG_RESULT([no]) + $4]) +elif test $pkg_failed = untried; then + ifelse([$4], , [AC_MSG_FAILURE(dnl +[The pkg-config script could not be found or is too old. Make sure it +is in your PATH or set the PKG_CONFIG environment variable to the full +path to pkg-config. + +_PKG_TEXT + +To get pkg-config, see .])], + [$4]) +else + $1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS + $1[]_LIBS=$pkg_cv_[]$1[]_LIBS + AC_MSG_RESULT([yes]) + ifelse([$3], , :, [$3]) +fi[]dnl +])# PKG_CHECK_MODULES diff --git a/libs/libtheora-1.1/m4/sdl.m4 b/libs/libtheora-1.1/m4/sdl.m4 new file mode 100644 index 00000000..f5fb1f4d --- /dev/null +++ b/libs/libtheora-1.1/m4/sdl.m4 @@ -0,0 +1,180 @@ +# Configure paths for SDL +# Sam Lantinga 9/21/99 +# stolen from Manish Singh +# stolen back from Frank Belew +# stolen from Manish Singh +# Shamelessly stolen from Owen Taylor + +dnl AM_PATH_SDL([MINIMUM-VERSION, [ACTION-IF-FOUND [, ACTION-IF-NOT-FOUND]]]) +dnl Test for SDL, and define SDL_CFLAGS and SDL_LIBS +dnl +AC_DEFUN([AM_PATH_SDL], +[dnl +dnl Get the cflags and libraries from the sdl-config script +dnl +AC_ARG_WITH(sdl-prefix,[ --with-sdl-prefix=PFX Prefix where SDL is installed (optional)], + sdl_prefix="$withval", sdl_prefix="") +AC_ARG_WITH(sdl-exec-prefix,[ --with-sdl-exec-prefix=PFX Exec prefix where SDL is installed (optional)], + sdl_exec_prefix="$withval", sdl_exec_prefix="") +AC_ARG_ENABLE(sdltest, [ --disable-sdltest Do not try to compile and run a test SDL program], + , enable_sdltest=yes) + + if test x$sdl_exec_prefix != x ; then + sdl_args="$sdl_args --exec-prefix=$sdl_exec_prefix" + if test x${SDL_CONFIG+set} != xset ; then + SDL_CONFIG=$sdl_exec_prefix/bin/sdl-config + fi + fi + if test x$sdl_prefix != x ; then + sdl_args="$sdl_args --prefix=$sdl_prefix" + if test x${SDL_CONFIG+set} != xset ; then + SDL_CONFIG=$sdl_prefix/bin/sdl-config + fi + fi + + AC_REQUIRE([AC_CANONICAL_TARGET]) + PATH="$prefix/bin:$prefix/usr/bin:$PATH" + AC_PATH_PROG(SDL_CONFIG, sdl-config, no, [$PATH]) + min_sdl_version=ifelse([$1], ,0.11.0,$1) + AC_MSG_CHECKING(for SDL - version >= $min_sdl_version) + no_sdl="" + if test "$SDL_CONFIG" = "no" ; then + no_sdl=yes + else + SDL_CFLAGS=`$SDL_CONFIG $sdlconf_args --cflags` + SDL_LIBS=`$SDL_CONFIG $sdlconf_args --libs` + + sdl_major_version=`$SDL_CONFIG $sdl_args --version | \ + sed 's/\([[0-9]]*\).\([[0-9]]*\).\([[0-9]]*\)/\1/'` + sdl_minor_version=`$SDL_CONFIG $sdl_args --version | \ + sed 's/\([[0-9]]*\).\([[0-9]]*\).\([[0-9]]*\)/\2/'` + sdl_micro_version=`$SDL_CONFIG $sdl_config_args --version | \ + sed 's/\([[0-9]]*\).\([[0-9]]*\).\([[0-9]]*\)/\3/'` + if test "x$enable_sdltest" = "xyes" ; then + ac_save_CFLAGS="$CFLAGS" + ac_save_CXXFLAGS="$CXXFLAGS" + ac_save_LIBS="$LIBS" + CFLAGS="$CFLAGS $SDL_CFLAGS" + CXXFLAGS="$CXXFLAGS $SDL_CFLAGS" + LIBS="$LIBS $SDL_LIBS" +dnl +dnl Now check if the installed SDL is sufficiently new. (Also sanity +dnl checks the results of sdl-config to some extent +dnl + rm -f conf.sdltest + AC_TRY_RUN([ +#include +#include +#include +#include "SDL.h" + +char* +my_strdup (char *str) +{ + char *new_str; + + if (str) + { + new_str = (char *)malloc ((strlen (str) + 1) * sizeof(char)); + strcpy (new_str, str); + } + else + new_str = NULL; + + return new_str; +} + +int main (int argc, char *argv[]) +{ + int major, minor, micro; + char *tmp_version; + + /* This hangs on some systems (?) + system ("touch conf.sdltest"); + */ + { FILE *fp = fopen("conf.sdltest", "a"); if ( fp ) fclose(fp); } + + /* HP/UX 9 (%@#!) writes to sscanf strings */ + tmp_version = my_strdup("$min_sdl_version"); + if (sscanf(tmp_version, "%d.%d.%d", &major, &minor, µ) != 3) { + printf("%s, bad version string\n", "$min_sdl_version"); + exit(1); + } + + if (($sdl_major_version > major) || + (($sdl_major_version == major) && ($sdl_minor_version > minor)) || + (($sdl_major_version == major) && ($sdl_minor_version == minor) && ($sdl_micro_version >= micro))) + { + return 0; + } + else + { + printf("\n*** 'sdl-config --version' returned %d.%d.%d, but the minimum version\n", $sdl_major_version, $sdl_minor_version, $sdl_micro_version); + printf("*** of SDL required is %d.%d.%d. If sdl-config is correct, then it is\n", major, minor, micro); + printf("*** best to upgrade to the required version.\n"); + printf("*** If sdl-config was wrong, set the environment variable SDL_CONFIG\n"); + printf("*** to point to the correct copy of sdl-config, and remove the file\n"); + printf("*** config.cache before re-running configure\n"); + return 1; + } +} + +],, no_sdl=yes,[echo $ac_n "cross compiling; assumed OK... $ac_c"]) + CFLAGS="$ac_save_CFLAGS" + CXXFLAGS="$ac_save_CXXFLAGS" + LIBS="$ac_save_LIBS" + fi + fi + if test "x$no_sdl" = x ; then + AC_MSG_RESULT(yes) + ifelse([$2], , :, [$2]) + else + AC_MSG_RESULT(no) + if test "$SDL_CONFIG" = "no" ; then + echo "*** The sdl-config script installed by SDL could not be found" + echo "*** If SDL was installed in PREFIX, make sure PREFIX/bin is in" + echo "*** your path, or set the SDL_CONFIG environment variable to the" + echo "*** full path to sdl-config." + else + if test -f conf.sdltest ; then + : + else + echo "*** Could not run SDL test program, checking why..." + CFLAGS="$CFLAGS $SDL_CFLAGS" + CXXFLAGS="$CXXFLAGS $SDL_CFLAGS" + LIBS="$LIBS $SDL_LIBS" + AC_TRY_LINK([ +#include +#include "SDL.h" + +int main(int argc, char *argv[]) +{ return 0; } +#undef main +#define main K_and_R_C_main +], [ return 0; ], + [ echo "*** The test program compiled, but did not run. This usually means" + echo "*** that the run-time linker is not finding SDL or finding the wrong" + echo "*** version of SDL. If it is not finding SDL, you'll need to set your" + echo "*** LD_LIBRARY_PATH environment variable, or edit /etc/ld.so.conf to point" + echo "*** to the installed location Also, make sure you have run ldconfig if that" + echo "*** is required on your system" + echo "***" + echo "*** If you have an old version installed, it is best to remove it, although" + echo "*** you may also be able to get things to work by modifying LD_LIBRARY_PATH"], + [ echo "*** The test program failed to compile or link. See the file config.log for the" + echo "*** exact error that occured. This usually means SDL was incorrectly installed" + echo "*** or that you have moved SDL since it was installed. In the latter case, you" + echo "*** may want to edit the sdl-config script: $SDL_CONFIG" ]) + CFLAGS="$ac_save_CFLAGS" + CXXFLAGS="$ac_save_CXXFLAGS" + LIBS="$ac_save_LIBS" + fi + fi + SDL_CFLAGS="" + SDL_LIBS="" + ifelse([$3], , :, [$3]) + fi + AC_SUBST(SDL_CFLAGS) + AC_SUBST(SDL_LIBS) + rm -f conf.sdltest +]) diff --git a/libs/libtheora-1.1/m4/vorbis.m4 b/libs/libtheora-1.1/m4/vorbis.m4 new file mode 100644 index 00000000..69715a7d --- /dev/null +++ b/libs/libtheora-1.1/m4/vorbis.m4 @@ -0,0 +1,122 @@ +# Configure paths for libvorbis +# Jack Moffitt 10-21-2000 +# Shamelessly stolen from Owen Taylor and Manish Singh +# thomasvs added check for vorbis_bitrate_addblock which is new in rc3 + +dnl XIPH_PATH_VORBIS([ACTION-IF-FOUND [, ACTION-IF-NOT-FOUND]]) +dnl Test for libvorbis, and define VORBIS_CFLAGS and VORBIS_LIBS +dnl +AC_DEFUN([XIPH_PATH_VORBIS], +[dnl +dnl Get the cflags and libraries +dnl +AC_ARG_WITH(vorbis,[ --with-vorbis=PFX Prefix where libvorbis is installed (optional)], vorbis_prefix="$withval", vorbis_prefix="") +AC_ARG_WITH(vorbis-libraries,[ --with-vorbis-libraries=DIR Directory where libvorbis library is installed (optional)], vorbis_libraries="$withval", vorbis_libraries="") +AC_ARG_WITH(vorbis-includes,[ --with-vorbis-includes=DIR Directory where libvorbis header files are installed (optional)], vorbis_includes="$withval", vorbis_includes="") +AC_ARG_ENABLE(vorbistest, [ --disable-vorbistest Do not try to compile and run a test Vorbis program],, enable_vorbistest=yes) + + if test "x$vorbis_libraries" != "x" ; then + VORBIS_LIBS="-L$vorbis_libraries" + elif test "x$vorbis_prefix" != "x" ; then + VORBIS_LIBS="-L$vorbis_prefix/lib" + elif test "x$prefix" != "xNONE"; then + VORBIS_LIBS="-L$libdir" + fi + + VORBIS_LIBS="$VORBIS_LIBS -lvorbis -lm" + VORBISFILE_LIBS="-lvorbisfile" + VORBISENC_LIBS="-lvorbisenc" + + if test "x$vorbis_includes" != "x" ; then + VORBIS_CFLAGS="-I$vorbis_includes" + elif test "x$vorbis_prefix" != "x" ; then + VORBIS_CFLAGS="-I$vorbis_prefix/include" + elif test "x$prefix" != "xNONE"; then + VORBIS_CFLAGS="" + fi + + + AC_MSG_CHECKING(for Vorbis) + no_vorbis="" + + + if test "x$enable_vorbistest" = "xyes" ; then + ac_save_CFLAGS="$CFLAGS" + ac_save_LIBS="$LIBS" + CFLAGS="$CFLAGS $VORBIS_CFLAGS $OGG_CFLAGS" + LIBS="$LIBS $VORBIS_LIBS $VORBISENC_LIBS $OGG_LIBS" +dnl +dnl Now check if the installed Vorbis is sufficiently new. +dnl + rm -f conf.vorbistest + AC_TRY_RUN([ +#include +#include +#include +#include +#include + +int main () +{ + vorbis_block vb; + vorbis_dsp_state vd; + vorbis_info vi; + + vorbis_info_init (&vi); + vorbis_encode_init (&vi, 2, 44100, -1, 128000, -1); + vorbis_analysis_init (&vd, &vi); + vorbis_block_init (&vd, &vb); + /* this function was added in 1.0rc3, so this is what we're testing for */ + vorbis_bitrate_addblock (&vb); + + system("touch conf.vorbistest"); + return 0; +} + +],, no_vorbis=yes,[echo $ac_n "cross compiling; assumed OK... $ac_c"]) + CFLAGS="$ac_save_CFLAGS" + LIBS="$ac_save_LIBS" + fi + + if test "x$no_vorbis" = "x" ; then + AC_MSG_RESULT(yes) + ifelse([$1], , :, [$1]) + else + AC_MSG_RESULT(no) + if test -f conf.vorbistest ; then + : + else + echo "*** Could not run Vorbis test program, checking why..." + CFLAGS="$CFLAGS $VORBIS_CFLAGS" + LIBS="$LIBS $VORBIS_LIBS $OGG_LIBS" + AC_TRY_LINK([ +#include +#include +], [ return 0; ], + [ echo "*** The test program compiled, but did not run. This usually means" + echo "*** that the run-time linker is not finding Vorbis or finding the wrong" + echo "*** version of Vorbis. If it is not finding Vorbis, you'll need to set your" + echo "*** LD_LIBRARY_PATH environment variable, or edit /etc/ld.so.conf to point" + echo "*** to the installed location Also, make sure you have run ldconfig if that" + echo "*** is required on your system" + echo "***" + echo "*** If you have an old version installed, it is best to remove it, although" + echo "*** you may also be able to get things to work by modifying LD_LIBRARY_PATH"], + [ echo "*** The test program failed to compile or link. See the file config.log for the" + echo "*** exact error that occured. This usually means Vorbis was incorrectly installed" + echo "*** or that you have moved Vorbis since it was installed." ]) + CFLAGS="$ac_save_CFLAGS" + LIBS="$ac_save_LIBS" + fi + VORBIS_CFLAGS="" + VORBIS_LIBS="" + VORBISFILE_LIBS="" + VORBISENC_LIBS="" + ifelse([$2], , :, [$2]) + fi + AC_SUBST(VORBIS_CFLAGS) + AC_SUBST(VORBIS_LIBS) + AC_SUBST(VORBISFILE_LIBS) + AC_SUBST(VORBISENC_LIBS) + rm -f conf.vorbistest +]) diff --git a/libs/libtheora-1.1/macosx/English.lproj/InfoPlist.strings b/libs/libtheora-1.1/macosx/English.lproj/InfoPlist.strings new file mode 100644 index 0000000000000000000000000000000000000000..e5964ff905b6b962803a0b21997fa55fb0135b09 GIT binary patch literal 142 zcmW-a%?g5G5Jk`0r}%K`A|D{!6a+%J@&&{nipnptf_ixMAj8a^dpXR^3pp8qGm(~t zJ6HbnbY@@m#bgp0)u0Z}Qa8Bocy9c}+w>;=+o;T&iFM?}fsb@2*Hd}_p#};&rRJiG J{%CZ2k` + + + + CFBundleDevelopmentRegion + English + CFBundleExecutable + Theora + CFBundleGetInfoString + Theora framework 1.1alpha1svn, Copyright © 2002-2009Xiph.Org Foundation + CFBundleIconFile + + CFBundleIdentifier + org.xiph.theora + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + FMWK + CFBundleSignature + ???? + CFBundleVersion + 1.0d6 + CFBundleShortVersionString + 1.1alpha1svn + NSHumanReadableCopyright + Theora framework 1.1alpha1svn, Copyright © 2002-2009Xiph.Org Foundation + CSResourcesFileMapped + + + diff --git a/libs/libtheora-1.1/macosx/Theora.xcodeproj/project.pbxproj b/libs/libtheora-1.1/macosx/Theora.xcodeproj/project.pbxproj new file mode 100644 index 00000000..380245f4 --- /dev/null +++ b/libs/libtheora-1.1/macosx/Theora.xcodeproj/project.pbxproj @@ -0,0 +1,864 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 42; + objects = { + +/* Begin PBXBuildFile section */ + 084C31FE0FE4E5BD00117FC9 /* apiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31D90FE4E5BD00117FC9 /* apiwrapper.c */; }; + 084C31FF0FE4E5BD00117FC9 /* apiwrapper.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DA0FE4E5BD00117FC9 /* apiwrapper.h */; }; + 084C32000FE4E5BD00117FC9 /* bitpack.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DB0FE4E5BD00117FC9 /* bitpack.c */; }; + 084C32010FE4E5BD00117FC9 /* bitpack.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DC0FE4E5BD00117FC9 /* bitpack.h */; }; + 084C32020FE4E5BD00117FC9 /* dct.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DD0FE4E5BD00117FC9 /* dct.h */; }; + 084C32030FE4E5BD00117FC9 /* decapiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DE0FE4E5BD00117FC9 /* decapiwrapper.c */; }; + 084C32040FE4E5BD00117FC9 /* decinfo.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DF0FE4E5BD00117FC9 /* decinfo.c */; }; + 084C32050FE4E5BD00117FC9 /* decint.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E00FE4E5BD00117FC9 /* decint.h */; }; + 084C32060FE4E5BD00117FC9 /* decode.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E10FE4E5BD00117FC9 /* decode.c */; }; + 084C32070FE4E5BD00117FC9 /* dequant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E20FE4E5BD00117FC9 /* dequant.c */; }; + 084C32080FE4E5BD00117FC9 /* dequant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E30FE4E5BD00117FC9 /* dequant.h */; }; + 084C32090FE4E5BD00117FC9 /* fragment.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E40FE4E5BD00117FC9 /* fragment.c */; }; + 084C320A0FE4E5BD00117FC9 /* huffdec.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E50FE4E5BD00117FC9 /* huffdec.c */; }; + 084C320B0FE4E5BD00117FC9 /* huffdec.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E60FE4E5BD00117FC9 /* huffdec.h */; }; + 084C320C0FE4E5BD00117FC9 /* huffman.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E70FE4E5BD00117FC9 /* huffman.h */; }; + 084C320D0FE4E5BD00117FC9 /* idct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E80FE4E5BD00117FC9 /* idct.c */; }; + 084C320E0FE4E5BD00117FC9 /* info.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E90FE4E5BD00117FC9 /* info.c */; }; + 084C320F0FE4E5BD00117FC9 /* internal.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EA0FE4E5BD00117FC9 /* internal.c */; }; + 084C32100FE4E5BD00117FC9 /* ocintrin.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31EB0FE4E5BD00117FC9 /* ocintrin.h */; }; + 084C32110FE4E5BD00117FC9 /* quant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EC0FE4E5BD00117FC9 /* quant.c */; }; + 084C32120FE4E5BD00117FC9 /* quant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31ED0FE4E5BD00117FC9 /* quant.h */; }; + 084C32130FE4E5BD00117FC9 /* state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EE0FE4E5BD00117FC9 /* state.c */; }; + 084C32140FE4E5BD00117FC9 /* mmxfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F00FE4E5BD00117FC9 /* mmxfrag.c */; }; + 084C32150FE4E5BD00117FC9 /* mmxfrag.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F10FE4E5BD00117FC9 /* mmxfrag.h */; }; + 084C32160FE4E5BD00117FC9 /* mmxidct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F20FE4E5BD00117FC9 /* mmxidct.c */; }; + 084C32170FE4E5BD00117FC9 /* mmxloop.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F30FE4E5BD00117FC9 /* mmxloop.h */; }; + 084C32180FE4E5BD00117FC9 /* mmxstate.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F40FE4E5BD00117FC9 /* mmxstate.c */; }; + 084C32190FE4E5BD00117FC9 /* x86int.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F50FE4E5BD00117FC9 /* x86int.h */; }; + 084C321A0FE4E5BD00117FC9 /* x86state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F60FE4E5BD00117FC9 /* x86state.c */; }; + 084C32210FE4E5BD00117FC9 /* apiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31D90FE4E5BD00117FC9 /* apiwrapper.c */; }; + 084C32220FE4E5BD00117FC9 /* apiwrapper.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DA0FE4E5BD00117FC9 /* apiwrapper.h */; }; + 084C32230FE4E5BD00117FC9 /* bitpack.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DB0FE4E5BD00117FC9 /* bitpack.c */; }; + 084C32240FE4E5BD00117FC9 /* bitpack.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DC0FE4E5BD00117FC9 /* bitpack.h */; }; + 084C32250FE4E5BD00117FC9 /* dct.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DD0FE4E5BD00117FC9 /* dct.h */; }; + 084C32260FE4E5BD00117FC9 /* decapiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DE0FE4E5BD00117FC9 /* decapiwrapper.c */; }; + 084C32270FE4E5BD00117FC9 /* decinfo.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31DF0FE4E5BD00117FC9 /* decinfo.c */; }; + 084C32280FE4E5BD00117FC9 /* decint.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E00FE4E5BD00117FC9 /* decint.h */; }; + 084C32290FE4E5BD00117FC9 /* decode.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E10FE4E5BD00117FC9 /* decode.c */; }; + 084C322A0FE4E5BD00117FC9 /* dequant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E20FE4E5BD00117FC9 /* dequant.c */; }; + 084C322B0FE4E5BD00117FC9 /* dequant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E30FE4E5BD00117FC9 /* dequant.h */; }; + 084C322C0FE4E5BD00117FC9 /* fragment.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E40FE4E5BD00117FC9 /* fragment.c */; }; + 084C322D0FE4E5BD00117FC9 /* huffdec.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E50FE4E5BD00117FC9 /* huffdec.c */; }; + 084C322E0FE4E5BD00117FC9 /* huffdec.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E60FE4E5BD00117FC9 /* huffdec.h */; }; + 084C322F0FE4E5BD00117FC9 /* huffman.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31E70FE4E5BD00117FC9 /* huffman.h */; }; + 084C32300FE4E5BD00117FC9 /* idct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E80FE4E5BD00117FC9 /* idct.c */; }; + 084C32310FE4E5BD00117FC9 /* info.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E90FE4E5BD00117FC9 /* info.c */; }; + 084C32320FE4E5BD00117FC9 /* internal.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EA0FE4E5BD00117FC9 /* internal.c */; }; + 084C32330FE4E5BD00117FC9 /* ocintrin.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31EB0FE4E5BD00117FC9 /* ocintrin.h */; }; + 084C32340FE4E5BD00117FC9 /* quant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EC0FE4E5BD00117FC9 /* quant.c */; }; + 084C32350FE4E5BD00117FC9 /* quant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31ED0FE4E5BD00117FC9 /* quant.h */; }; + 084C32360FE4E5BD00117FC9 /* state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EE0FE4E5BD00117FC9 /* state.c */; }; + 084C32370FE4E5BD00117FC9 /* mmxfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F00FE4E5BD00117FC9 /* mmxfrag.c */; }; + 084C32380FE4E5BD00117FC9 /* mmxfrag.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F10FE4E5BD00117FC9 /* mmxfrag.h */; }; + 084C32390FE4E5BD00117FC9 /* mmxidct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F20FE4E5BD00117FC9 /* mmxidct.c */; }; + 084C323A0FE4E5BD00117FC9 /* mmxloop.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F30FE4E5BD00117FC9 /* mmxloop.h */; }; + 084C323B0FE4E5BD00117FC9 /* mmxstate.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F40FE4E5BD00117FC9 /* mmxstate.c */; }; + 084C323C0FE4E5BD00117FC9 /* x86int.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F50FE4E5BD00117FC9 /* x86int.h */; }; + 084C323D0FE4E5BD00117FC9 /* x86state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F60FE4E5BD00117FC9 /* x86state.c */; }; + 084C32620FE4E5D500117FC9 /* analyze.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32450FE4E5D500117FC9 /* analyze.c */; }; + 084C32630FE4E5D500117FC9 /* encapiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32460FE4E5D500117FC9 /* encapiwrapper.c */; }; + 084C32640FE4E5D500117FC9 /* encfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32470FE4E5D500117FC9 /* encfrag.c */; }; + 084C32650FE4E5D500117FC9 /* encinfo.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32480FE4E5D500117FC9 /* encinfo.c */; }; + 084C32660FE4E5D500117FC9 /* encint.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32490FE4E5D500117FC9 /* encint.h */; }; + 084C32670FE4E5D500117FC9 /* encode.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324A0FE4E5D500117FC9 /* encode.c */; }; + 084C32690FE4E5D500117FC9 /* enquant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324C0FE4E5D500117FC9 /* enquant.c */; }; + 084C326A0FE4E5D500117FC9 /* enquant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C324D0FE4E5D500117FC9 /* enquant.h */; }; + 084C326B0FE4E5D500117FC9 /* fdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324E0FE4E5D500117FC9 /* fdct.c */; }; + 084C326C0FE4E5D500117FC9 /* huffenc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324F0FE4E5D500117FC9 /* huffenc.c */; }; + 084C326D0FE4E5D500117FC9 /* huffenc.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32500FE4E5D500117FC9 /* huffenc.h */; }; + 084C326E0FE4E5D500117FC9 /* mathops.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32510FE4E5D500117FC9 /* mathops.c */; }; + 084C326F0FE4E5D500117FC9 /* mathops.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32520FE4E5D500117FC9 /* mathops.h */; }; + 084C32700FE4E5D500117FC9 /* mcenc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32530FE4E5D500117FC9 /* mcenc.c */; }; + 084C32710FE4E5D500117FC9 /* modedec.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32540FE4E5D500117FC9 /* modedec.h */; }; + 084C32720FE4E5D500117FC9 /* rate.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32550FE4E5D500117FC9 /* rate.c */; }; + 084C32730FE4E5D500117FC9 /* tokenize.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32560FE4E5D500117FC9 /* tokenize.c */; }; + 084C32750FE4E5D500117FC9 /* mmxencfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32590FE4E5D500117FC9 /* mmxencfrag.c */; }; + 084C32760FE4E5D500117FC9 /* mmxfdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325A0FE4E5D500117FC9 /* mmxfdct.c */; }; + 084C32770FE4E5D500117FC9 /* sse2fdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325B0FE4E5D500117FC9 /* sse2fdct.c */; }; + 084C32780FE4E5D500117FC9 /* x86enc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325C0FE4E5D500117FC9 /* x86enc.c */; }; + 084C32790FE4E5D500117FC9 /* x86enc.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C325D0FE4E5D500117FC9 /* x86enc.h */; }; + 084C327D0FE4E5D500117FC9 /* analyze.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32450FE4E5D500117FC9 /* analyze.c */; }; + 084C327E0FE4E5D500117FC9 /* encapiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32460FE4E5D500117FC9 /* encapiwrapper.c */; }; + 084C327F0FE4E5D500117FC9 /* encfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32470FE4E5D500117FC9 /* encfrag.c */; }; + 084C32800FE4E5D500117FC9 /* encinfo.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32480FE4E5D500117FC9 /* encinfo.c */; }; + 084C32810FE4E5D500117FC9 /* encint.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32490FE4E5D500117FC9 /* encint.h */; }; + 084C32820FE4E5D500117FC9 /* encode.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324A0FE4E5D500117FC9 /* encode.c */; }; + 084C32840FE4E5D500117FC9 /* enquant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324C0FE4E5D500117FC9 /* enquant.c */; }; + 084C32850FE4E5D500117FC9 /* enquant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C324D0FE4E5D500117FC9 /* enquant.h */; }; + 084C32860FE4E5D500117FC9 /* fdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324E0FE4E5D500117FC9 /* fdct.c */; }; + 084C32870FE4E5D500117FC9 /* huffenc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C324F0FE4E5D500117FC9 /* huffenc.c */; }; + 084C32880FE4E5D500117FC9 /* huffenc.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32500FE4E5D500117FC9 /* huffenc.h */; }; + 084C32890FE4E5D500117FC9 /* mathops.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32510FE4E5D500117FC9 /* mathops.c */; }; + 084C328A0FE4E5D500117FC9 /* mathops.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32520FE4E5D500117FC9 /* mathops.h */; }; + 084C328B0FE4E5D500117FC9 /* mcenc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32530FE4E5D500117FC9 /* mcenc.c */; }; + 084C328C0FE4E5D500117FC9 /* modedec.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C32540FE4E5D500117FC9 /* modedec.h */; }; + 084C328D0FE4E5D500117FC9 /* rate.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32550FE4E5D500117FC9 /* rate.c */; }; + 084C328E0FE4E5D500117FC9 /* tokenize.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32560FE4E5D500117FC9 /* tokenize.c */; }; + 084C32900FE4E5D500117FC9 /* mmxencfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C32590FE4E5D500117FC9 /* mmxencfrag.c */; }; + 084C32910FE4E5D500117FC9 /* mmxfdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325A0FE4E5D500117FC9 /* mmxfdct.c */; }; + 084C32920FE4E5D500117FC9 /* sse2fdct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325B0FE4E5D500117FC9 /* sse2fdct.c */; }; + 084C32930FE4E5D500117FC9 /* x86enc.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C325C0FE4E5D500117FC9 /* x86enc.c */; }; + 084C32940FE4E5D500117FC9 /* x86enc.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C325D0FE4E5D500117FC9 /* x86enc.h */; }; + 084C32A70FE4E7FE00117FC9 /* apiwrapper.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31D90FE4E5BD00117FC9 /* apiwrapper.c */; }; + 084C32A80FE4E7FF00117FC9 /* apiwrapper.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DA0FE4E5BD00117FC9 /* apiwrapper.h */; }; + 084C32A90FE4E82500117FC9 /* dct.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31DD0FE4E5BD00117FC9 /* dct.h */; }; + 084C32AA0FE4E83100117FC9 /* idct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E80FE4E5BD00117FC9 /* idct.c */; }; + 084C32AB0FE4E83300117FC9 /* internal.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EA0FE4E5BD00117FC9 /* internal.c */; }; + 084C32AC0FE4E83600117FC9 /* fragment.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31E40FE4E5BD00117FC9 /* fragment.c */; }; + 084C32AD0FE4E84800117FC9 /* quant.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31ED0FE4E5BD00117FC9 /* quant.h */; }; + 084C32AE0FE4E84A00117FC9 /* quant.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EC0FE4E5BD00117FC9 /* quant.c */; }; + 084C32AF0FE4E84C00117FC9 /* ocintrin.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31EB0FE4E5BD00117FC9 /* ocintrin.h */; }; + 084C32B00FE4E84F00117FC9 /* state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31EE0FE4E5BD00117FC9 /* state.c */; }; + 084C32B10FE4E85300117FC9 /* x86int.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F50FE4E5BD00117FC9 /* x86int.h */; }; + 084C32B20FE4E85300117FC9 /* x86state.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F60FE4E5BD00117FC9 /* x86state.c */; }; + 084C32B30FE4E85D00117FC9 /* mmxstate.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F40FE4E5BD00117FC9 /* mmxstate.c */; }; + 084C32B40FE4E86A00117FC9 /* mmxfrag.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F00FE4E5BD00117FC9 /* mmxfrag.c */; }; + 084C32B50FE4E86B00117FC9 /* mmxfrag.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F10FE4E5BD00117FC9 /* mmxfrag.h */; }; + 084C32B60FE4E87200117FC9 /* mmxidct.c in Sources */ = {isa = PBXBuildFile; fileRef = 084C31F20FE4E5BD00117FC9 /* mmxidct.c */; }; + 084C32B70FE4E88300117FC9 /* mmxloop.h in Headers */ = {isa = PBXBuildFile; fileRef = 084C31F30FE4E5BD00117FC9 /* mmxloop.h */; }; + 097729950BCAC60000303091 /* codec.h in Headers */ = {isa = PBXBuildFile; fileRef = 097729930BCAC60000303091 /* codec.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 097729960BCAC60000303091 /* theoradec.h in Headers */ = {isa = PBXBuildFile; fileRef = 097729940BCAC60000303091 /* theoradec.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 37C9B0140EBB831F0046849C /* theoraenc.h in Headers */ = {isa = PBXBuildFile; fileRef = 37C9B0130EBB831F0046849C /* theoraenc.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 37CA8E390DD747F1005C8CB6 /* internal.h in Headers */ = {isa = PBXBuildFile; fileRef = 37CA8E380DD747F1005C8CB6 /* internal.h */; }; + 734A751909D76ADD002D8FAE /* Ogg.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 734A751809D76ADD002D8FAE /* Ogg.framework */; }; + 734A75BF09D76BB9002D8FAE /* theora.h in Headers */ = {isa = PBXBuildFile; fileRef = 734A75BE09D76BB9002D8FAE /* theora.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 73514EC90B0C7E5700CEC060 /* cpu.h in Headers */ = {isa = PBXBuildFile; fileRef = 73514EC70B0C7E5700CEC060 /* cpu.h */; }; + 8D07F2BE0486CC7A007CD1D0 /* Theora_Prefix.pch in Headers */ = {isa = PBXBuildFile; fileRef = 32BAE0B70371A74B00C91783 /* Theora_Prefix.pch */; }; + 8D07F2C00486CC7A007CD1D0 /* InfoPlist.strings in Resources */ = {isa = PBXBuildFile; fileRef = 089C1666FE841158C02AAC07 /* InfoPlist.strings */; }; +/* End PBXBuildFile section */ + +/* Begin PBXFileReference section */ + 0844FE7E0FCCC99A004A99B0 /* cpu.c */ = {isa = PBXFileReference; fileEncoding = 30; lastKnownFileType = sourcecode.c.c; name = cpu.c; path = ../lib/cpu.c; sourceTree = SOURCE_ROOT; }; + 084C31D90FE4E5BD00117FC9 /* apiwrapper.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = apiwrapper.c; sourceTree = ""; }; + 084C31DA0FE4E5BD00117FC9 /* apiwrapper.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = apiwrapper.h; sourceTree = ""; }; + 084C31DB0FE4E5BD00117FC9 /* bitpack.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = bitpack.c; sourceTree = ""; }; + 084C31DC0FE4E5BD00117FC9 /* bitpack.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = bitpack.h; sourceTree = ""; }; + 084C31DD0FE4E5BD00117FC9 /* dct.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = dct.h; sourceTree = ""; }; + 084C31DE0FE4E5BD00117FC9 /* decapiwrapper.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = decapiwrapper.c; sourceTree = ""; }; + 084C31DF0FE4E5BD00117FC9 /* decinfo.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = decinfo.c; sourceTree = ""; }; + 084C31E00FE4E5BD00117FC9 /* decint.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = decint.h; sourceTree = ""; }; + 084C31E10FE4E5BD00117FC9 /* decode.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = decode.c; sourceTree = ""; }; + 084C31E20FE4E5BD00117FC9 /* dequant.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = dequant.c; sourceTree = ""; }; + 084C31E30FE4E5BD00117FC9 /* dequant.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = dequant.h; sourceTree = ""; }; + 084C31E40FE4E5BD00117FC9 /* fragment.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = fragment.c; sourceTree = ""; }; + 084C31E50FE4E5BD00117FC9 /* huffdec.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = huffdec.c; sourceTree = ""; }; + 084C31E60FE4E5BD00117FC9 /* huffdec.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = huffdec.h; sourceTree = ""; }; + 084C31E70FE4E5BD00117FC9 /* huffman.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = huffman.h; sourceTree = ""; }; + 084C31E80FE4E5BD00117FC9 /* idct.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = idct.c; sourceTree = ""; }; + 084C31E90FE4E5BD00117FC9 /* info.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = info.c; sourceTree = ""; }; + 084C31EA0FE4E5BD00117FC9 /* internal.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = internal.c; sourceTree = ""; }; + 084C31EB0FE4E5BD00117FC9 /* ocintrin.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = ocintrin.h; sourceTree = ""; }; + 084C31EC0FE4E5BD00117FC9 /* quant.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = quant.c; sourceTree = ""; }; + 084C31ED0FE4E5BD00117FC9 /* quant.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = quant.h; sourceTree = ""; }; + 084C31EE0FE4E5BD00117FC9 /* state.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = state.c; sourceTree = ""; }; + 084C31F00FE4E5BD00117FC9 /* mmxfrag.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mmxfrag.c; sourceTree = ""; }; + 084C31F10FE4E5BD00117FC9 /* mmxfrag.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = mmxfrag.h; sourceTree = ""; }; + 084C31F20FE4E5BD00117FC9 /* mmxidct.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mmxidct.c; sourceTree = ""; }; + 084C31F30FE4E5BD00117FC9 /* mmxloop.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = mmxloop.h; sourceTree = ""; }; + 084C31F40FE4E5BD00117FC9 /* mmxstate.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mmxstate.c; sourceTree = ""; }; + 084C31F50FE4E5BD00117FC9 /* x86int.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = x86int.h; sourceTree = ""; }; + 084C31F60FE4E5BD00117FC9 /* x86state.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = x86state.c; sourceTree = ""; }; + 084C32450FE4E5D500117FC9 /* analyze.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = analyze.c; sourceTree = ""; }; + 084C32460FE4E5D500117FC9 /* encapiwrapper.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encapiwrapper.c; sourceTree = ""; }; + 084C32470FE4E5D500117FC9 /* encfrag.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encfrag.c; sourceTree = ""; }; + 084C32480FE4E5D500117FC9 /* encinfo.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encinfo.c; sourceTree = ""; }; + 084C32490FE4E5D500117FC9 /* encint.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = encint.h; sourceTree = ""; }; + 084C324A0FE4E5D500117FC9 /* encode.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encode.c; sourceTree = ""; }; + 084C324B0FE4E5D500117FC9 /* encoder_disabled.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encoder_disabled.c; sourceTree = ""; }; + 084C324C0FE4E5D500117FC9 /* enquant.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = enquant.c; sourceTree = ""; }; + 084C324D0FE4E5D500117FC9 /* enquant.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = enquant.h; sourceTree = ""; }; + 084C324E0FE4E5D500117FC9 /* fdct.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = fdct.c; sourceTree = ""; }; + 084C324F0FE4E5D500117FC9 /* huffenc.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = huffenc.c; sourceTree = ""; }; + 084C32500FE4E5D500117FC9 /* huffenc.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = huffenc.h; sourceTree = ""; }; + 084C32510FE4E5D500117FC9 /* mathops.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mathops.c; sourceTree = ""; }; + 084C32520FE4E5D500117FC9 /* mathops.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = mathops.h; sourceTree = ""; }; + 084C32530FE4E5D500117FC9 /* mcenc.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mcenc.c; sourceTree = ""; }; + 084C32540FE4E5D500117FC9 /* modedec.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = modedec.h; sourceTree = ""; }; + 084C32550FE4E5D500117FC9 /* rate.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = rate.c; sourceTree = ""; }; + 084C32560FE4E5D500117FC9 /* tokenize.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = tokenize.c; sourceTree = ""; }; + 084C32590FE4E5D500117FC9 /* mmxencfrag.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mmxencfrag.c; sourceTree = ""; }; + 084C325A0FE4E5D500117FC9 /* mmxfdct.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = mmxfdct.c; sourceTree = ""; }; + 084C325B0FE4E5D500117FC9 /* sse2fdct.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = sse2fdct.c; sourceTree = ""; }; + 084C325C0FE4E5D500117FC9 /* x86enc.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = x86enc.c; sourceTree = ""; }; + 084C325D0FE4E5D500117FC9 /* x86enc.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = x86enc.h; sourceTree = ""; }; + 089C1667FE841158C02AAC07 /* English */ = {isa = PBXFileReference; fileEncoding = 10; lastKnownFileType = text.plist.strings; name = English; path = English.lproj/InfoPlist.strings; sourceTree = ""; }; + 097729930BCAC60000303091 /* codec.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = codec.h; path = ../include/theora/codec.h; sourceTree = SOURCE_ROOT; }; + 097729940BCAC60000303091 /* theoradec.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = theoradec.h; path = ../include/theora/theoradec.h; sourceTree = SOURCE_ROOT; }; + 09C8F6430C82FBE500F72188 /* libtheoradec.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libtheoradec.a; sourceTree = BUILT_PRODUCTS_DIR; }; + 32BAE0B70371A74B00C91783 /* Theora_Prefix.pch */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = Theora_Prefix.pch; sourceTree = ""; }; + 37C9B0130EBB831F0046849C /* theoraenc.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = theoraenc.h; path = ../include/theora/theoraenc.h; sourceTree = SOURCE_ROOT; }; + 37CA8E380DD747F1005C8CB6 /* internal.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = internal.h; path = ../lib/internal.h; sourceTree = SOURCE_ROOT; }; + 734A751809D76ADD002D8FAE /* Ogg.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Ogg.framework; path = /Library/Frameworks/Ogg.framework; sourceTree = ""; }; + 734A75BE09D76BB9002D8FAE /* theora.h */ = {isa = PBXFileReference; fileEncoding = 30; lastKnownFileType = sourcecode.c.h; name = theora.h; path = ../include/theora/theora.h; sourceTree = SOURCE_ROOT; }; + 73514EC70B0C7E5700CEC060 /* cpu.h */ = {isa = PBXFileReference; fileEncoding = 30; lastKnownFileType = sourcecode.c.h; name = cpu.h; path = "../lib//cpu.h"; sourceTree = SOURCE_ROOT; }; + 738837100B192732005C7A69 /* libtheoraenc.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libtheoraenc.a; sourceTree = BUILT_PRODUCTS_DIR; }; + 8D07F2C70486CC7A007CD1D0 /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist; path = Info.plist; sourceTree = ""; }; + 8D07F2C80486CC7A007CD1D0 /* Theora.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = Theora.framework; sourceTree = BUILT_PRODUCTS_DIR; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 09C8F6410C82FBE500F72188 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 7388370E0B192732005C7A69 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 8D07F2C30486CC7A007CD1D0 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 734A751909D76ADD002D8FAE /* Ogg.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 034768DDFF38A45A11DB9C8B /* Products */ = { + isa = PBXGroup; + children = ( + 8D07F2C80486CC7A007CD1D0 /* Theora.framework */, + 738837100B192732005C7A69 /* libtheoraenc.a */, + 09C8F6430C82FBE500F72188 /* libtheoradec.a */, + ); + name = Products; + sourceTree = ""; + }; + 084C31D80FE4E5BD00117FC9 /* lib */ = { + isa = PBXGroup; + children = ( + 084C32450FE4E5D500117FC9 /* analyze.c */, + 084C32460FE4E5D500117FC9 /* encapiwrapper.c */, + 084C32470FE4E5D500117FC9 /* encfrag.c */, + 084C32480FE4E5D500117FC9 /* encinfo.c */, + 084C32490FE4E5D500117FC9 /* encint.h */, + 084C324A0FE4E5D500117FC9 /* encode.c */, + 084C324B0FE4E5D500117FC9 /* encoder_disabled.c */, + 084C324C0FE4E5D500117FC9 /* enquant.c */, + 084C324D0FE4E5D500117FC9 /* enquant.h */, + 084C324E0FE4E5D500117FC9 /* fdct.c */, + 084C324F0FE4E5D500117FC9 /* huffenc.c */, + 084C32500FE4E5D500117FC9 /* huffenc.h */, + 084C32510FE4E5D500117FC9 /* mathops.c */, + 084C32520FE4E5D500117FC9 /* mathops.h */, + 084C32530FE4E5D500117FC9 /* mcenc.c */, + 084C32540FE4E5D500117FC9 /* modedec.h */, + 084C32550FE4E5D500117FC9 /* rate.c */, + 084C32560FE4E5D500117FC9 /* tokenize.c */, + 084C31D90FE4E5BD00117FC9 /* apiwrapper.c */, + 084C31DA0FE4E5BD00117FC9 /* apiwrapper.h */, + 084C31DB0FE4E5BD00117FC9 /* bitpack.c */, + 084C31DC0FE4E5BD00117FC9 /* bitpack.h */, + 084C31DD0FE4E5BD00117FC9 /* dct.h */, + 084C31DE0FE4E5BD00117FC9 /* decapiwrapper.c */, + 084C31DF0FE4E5BD00117FC9 /* decinfo.c */, + 084C31E00FE4E5BD00117FC9 /* decint.h */, + 084C31E10FE4E5BD00117FC9 /* decode.c */, + 084C31E20FE4E5BD00117FC9 /* dequant.c */, + 084C31E30FE4E5BD00117FC9 /* dequant.h */, + 084C31E40FE4E5BD00117FC9 /* fragment.c */, + 084C31E50FE4E5BD00117FC9 /* huffdec.c */, + 084C31E60FE4E5BD00117FC9 /* huffdec.h */, + 084C31E70FE4E5BD00117FC9 /* huffman.h */, + 084C31E80FE4E5BD00117FC9 /* idct.c */, + 084C31E90FE4E5BD00117FC9 /* info.c */, + 084C31EA0FE4E5BD00117FC9 /* internal.c */, + 084C31EB0FE4E5BD00117FC9 /* ocintrin.h */, + 084C31EC0FE4E5BD00117FC9 /* quant.c */, + 084C31ED0FE4E5BD00117FC9 /* quant.h */, + 084C31EE0FE4E5BD00117FC9 /* state.c */, + 084C32570FE4E5D500117FC9 /* x86 */, + ); + name = lib; + path = ../lib; + sourceTree = SOURCE_ROOT; + }; + 084C32570FE4E5D500117FC9 /* x86 */ = { + isa = PBXGroup; + children = ( + 084C31F00FE4E5BD00117FC9 /* mmxfrag.c */, + 084C31F10FE4E5BD00117FC9 /* mmxfrag.h */, + 084C31F20FE4E5BD00117FC9 /* mmxidct.c */, + 084C31F30FE4E5BD00117FC9 /* mmxloop.h */, + 084C31F40FE4E5BD00117FC9 /* mmxstate.c */, + 084C31F50FE4E5BD00117FC9 /* x86int.h */, + 084C31F60FE4E5BD00117FC9 /* x86state.c */, + 084C32590FE4E5D500117FC9 /* mmxencfrag.c */, + 084C325A0FE4E5D500117FC9 /* mmxfdct.c */, + 084C325B0FE4E5D500117FC9 /* sse2fdct.c */, + 084C325C0FE4E5D500117FC9 /* x86enc.c */, + 084C325D0FE4E5D500117FC9 /* x86enc.h */, + ); + path = x86; + sourceTree = ""; + }; + 0867D691FE84028FC02AAC07 /* Theora */ = { + isa = PBXGroup; + children = ( + 734A75BD09D76B96002D8FAE /* Headers */, + 08FB77ACFE841707C02AAC07 /* Source */, + 089C1665FE841158C02AAC07 /* Resources */, + 0867D69AFE84028FC02AAC07 /* External Frameworks and Libraries */, + 034768DDFF38A45A11DB9C8B /* Products */, + ); + name = Theora; + sourceTree = ""; + }; + 0867D69AFE84028FC02AAC07 /* External Frameworks and Libraries */ = { + isa = PBXGroup; + children = ( + 734A751809D76ADD002D8FAE /* Ogg.framework */, + ); + name = "External Frameworks and Libraries"; + sourceTree = ""; + }; + 089C1665FE841158C02AAC07 /* Resources */ = { + isa = PBXGroup; + children = ( + 8D07F2C70486CC7A007CD1D0 /* Info.plist */, + 089C1666FE841158C02AAC07 /* InfoPlist.strings */, + ); + name = Resources; + sourceTree = ""; + }; + 08FB77ACFE841707C02AAC07 /* Source */ = { + isa = PBXGroup; + children = ( + 084C31D80FE4E5BD00117FC9 /* lib */, + 0844FE7E0FCCC99A004A99B0 /* cpu.c */, + 73514EC70B0C7E5700CEC060 /* cpu.h */, + 37CA8E380DD747F1005C8CB6 /* internal.h */, + 32BAE0B70371A74B00C91783 /* Theora_Prefix.pch */, + ); + name = Source; + sourceTree = ""; + }; + 734A75BD09D76B96002D8FAE /* Headers */ = { + isa = PBXGroup; + children = ( + 37C9B0130EBB831F0046849C /* theoraenc.h */, + 097729940BCAC60000303091 /* theoradec.h */, + 097729930BCAC60000303091 /* codec.h */, + 734A75BE09D76BB9002D8FAE /* theora.h */, + ); + name = Headers; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXHeadersBuildPhase section */ + 09C8F63F0C82FBE500F72188 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 084C32220FE4E5BD00117FC9 /* apiwrapper.h in Headers */, + 084C32240FE4E5BD00117FC9 /* bitpack.h in Headers */, + 084C32250FE4E5BD00117FC9 /* dct.h in Headers */, + 084C32280FE4E5BD00117FC9 /* decint.h in Headers */, + 084C322B0FE4E5BD00117FC9 /* dequant.h in Headers */, + 084C322E0FE4E5BD00117FC9 /* huffdec.h in Headers */, + 084C322F0FE4E5BD00117FC9 /* huffman.h in Headers */, + 084C32330FE4E5BD00117FC9 /* ocintrin.h in Headers */, + 084C32350FE4E5BD00117FC9 /* quant.h in Headers */, + 084C32380FE4E5BD00117FC9 /* mmxfrag.h in Headers */, + 084C323A0FE4E5BD00117FC9 /* mmxloop.h in Headers */, + 084C323C0FE4E5BD00117FC9 /* x86int.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 7388370C0B192732005C7A69 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 084C32810FE4E5D500117FC9 /* encint.h in Headers */, + 084C32850FE4E5D500117FC9 /* enquant.h in Headers */, + 084C32880FE4E5D500117FC9 /* huffenc.h in Headers */, + 084C328A0FE4E5D500117FC9 /* mathops.h in Headers */, + 084C328C0FE4E5D500117FC9 /* modedec.h in Headers */, + 084C32940FE4E5D500117FC9 /* x86enc.h in Headers */, + 084C32A80FE4E7FF00117FC9 /* apiwrapper.h in Headers */, + 084C32A90FE4E82500117FC9 /* dct.h in Headers */, + 084C32AD0FE4E84800117FC9 /* quant.h in Headers */, + 084C32AF0FE4E84C00117FC9 /* ocintrin.h in Headers */, + 084C32B10FE4E85300117FC9 /* x86int.h in Headers */, + 084C32B50FE4E86B00117FC9 /* mmxfrag.h in Headers */, + 084C32B70FE4E88300117FC9 /* mmxloop.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 8D07F2BD0486CC7A007CD1D0 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 8D07F2BE0486CC7A007CD1D0 /* Theora_Prefix.pch in Headers */, + 734A75BF09D76BB9002D8FAE /* theora.h in Headers */, + 73514EC90B0C7E5700CEC060 /* cpu.h in Headers */, + 097729950BCAC60000303091 /* codec.h in Headers */, + 097729960BCAC60000303091 /* theoradec.h in Headers */, + 37CA8E390DD747F1005C8CB6 /* internal.h in Headers */, + 37C9B0140EBB831F0046849C /* theoraenc.h in Headers */, + 084C31FF0FE4E5BD00117FC9 /* apiwrapper.h in Headers */, + 084C32010FE4E5BD00117FC9 /* bitpack.h in Headers */, + 084C32020FE4E5BD00117FC9 /* dct.h in Headers */, + 084C32050FE4E5BD00117FC9 /* decint.h in Headers */, + 084C32080FE4E5BD00117FC9 /* dequant.h in Headers */, + 084C320B0FE4E5BD00117FC9 /* huffdec.h in Headers */, + 084C320C0FE4E5BD00117FC9 /* huffman.h in Headers */, + 084C32100FE4E5BD00117FC9 /* ocintrin.h in Headers */, + 084C32120FE4E5BD00117FC9 /* quant.h in Headers */, + 084C32150FE4E5BD00117FC9 /* mmxfrag.h in Headers */, + 084C32170FE4E5BD00117FC9 /* mmxloop.h in Headers */, + 084C32190FE4E5BD00117FC9 /* x86int.h in Headers */, + 084C32660FE4E5D500117FC9 /* encint.h in Headers */, + 084C326A0FE4E5D500117FC9 /* enquant.h in Headers */, + 084C326D0FE4E5D500117FC9 /* huffenc.h in Headers */, + 084C326F0FE4E5D500117FC9 /* mathops.h in Headers */, + 084C32710FE4E5D500117FC9 /* modedec.h in Headers */, + 084C32790FE4E5D500117FC9 /* x86enc.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXHeadersBuildPhase section */ + +/* Begin PBXNativeTarget section */ + 09C8F6420C82FBE500F72188 /* libtheoradec (static) */ = { + isa = PBXNativeTarget; + buildConfigurationList = 09C8F6610C82FC3E00F72188 /* Build configuration list for PBXNativeTarget "libtheoradec (static)" */; + buildPhases = ( + 09C8F63F0C82FBE500F72188 /* Headers */, + 09C8F6400C82FBE500F72188 /* Sources */, + 09C8F6410C82FBE500F72188 /* Frameworks */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = "libtheoradec (static)"; + productName = libtheoradec; + productReference = 09C8F6430C82FBE500F72188 /* libtheoradec.a */; + productType = "com.apple.product-type.library.static"; + }; + 7388370F0B192732005C7A69 /* libtheoraenc (static) */ = { + isa = PBXNativeTarget; + buildConfigurationList = 738837110B19277F005C7A69 /* Build configuration list for PBXNativeTarget "libtheoraenc (static)" */; + buildPhases = ( + 7388370C0B192732005C7A69 /* Headers */, + 7388370D0B192732005C7A69 /* Sources */, + 7388370E0B192732005C7A69 /* Frameworks */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = "libtheoraenc (static)"; + productName = theora; + productReference = 738837100B192732005C7A69 /* libtheoraenc.a */; + productType = "com.apple.product-type.library.static"; + }; + 8D07F2BC0486CC7A007CD1D0 /* Theora */ = { + isa = PBXNativeTarget; + buildConfigurationList = 4FADC24208B4156D00ABE55E /* Build configuration list for PBXNativeTarget "Theora" */; + buildPhases = ( + 8D07F2BD0486CC7A007CD1D0 /* Headers */, + 8D07F2BF0486CC7A007CD1D0 /* Resources */, + 8D07F2C10486CC7A007CD1D0 /* Sources */, + 8D07F2C30486CC7A007CD1D0 /* Frameworks */, + 8D07F2C50486CC7A007CD1D0 /* Rez */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Theora; + productInstallPath = "$(HOME)/Library/Frameworks"; + productName = Theora; + productReference = 8D07F2C80486CC7A007CD1D0 /* Theora.framework */; + productType = "com.apple.product-type.framework"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 0867D690FE84028FC02AAC07 /* Project object */ = { + isa = PBXProject; + buildConfigurationList = 4FADC24608B4156D00ABE55E /* Build configuration list for PBXProject "Theora" */; + compatibilityVersion = "Xcode 2.4"; + hasScannedForEncodings = 1; + mainGroup = 0867D691FE84028FC02AAC07 /* Theora */; + productRefGroup = 034768DDFF38A45A11DB9C8B /* Products */; + projectDirPath = ""; + projectRoot = ..; + targets = ( + 8D07F2BC0486CC7A007CD1D0 /* Theora */, + 7388370F0B192732005C7A69 /* libtheoraenc (static) */, + 09C8F6420C82FBE500F72188 /* libtheoradec (static) */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 8D07F2BF0486CC7A007CD1D0 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 8D07F2C00486CC7A007CD1D0 /* InfoPlist.strings in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXRezBuildPhase section */ + 8D07F2C50486CC7A007CD1D0 /* Rez */ = { + isa = PBXRezBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXRezBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 09C8F6400C82FBE500F72188 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 084C32210FE4E5BD00117FC9 /* apiwrapper.c in Sources */, + 084C32230FE4E5BD00117FC9 /* bitpack.c in Sources */, + 084C32260FE4E5BD00117FC9 /* decapiwrapper.c in Sources */, + 084C32270FE4E5BD00117FC9 /* decinfo.c in Sources */, + 084C32290FE4E5BD00117FC9 /* decode.c in Sources */, + 084C322A0FE4E5BD00117FC9 /* dequant.c in Sources */, + 084C322C0FE4E5BD00117FC9 /* fragment.c in Sources */, + 084C322D0FE4E5BD00117FC9 /* huffdec.c in Sources */, + 084C32300FE4E5BD00117FC9 /* idct.c in Sources */, + 084C32310FE4E5BD00117FC9 /* info.c in Sources */, + 084C32320FE4E5BD00117FC9 /* internal.c in Sources */, + 084C32340FE4E5BD00117FC9 /* quant.c in Sources */, + 084C32360FE4E5BD00117FC9 /* state.c in Sources */, + 084C32370FE4E5BD00117FC9 /* mmxfrag.c in Sources */, + 084C32390FE4E5BD00117FC9 /* mmxidct.c in Sources */, + 084C323B0FE4E5BD00117FC9 /* mmxstate.c in Sources */, + 084C323D0FE4E5BD00117FC9 /* x86state.c in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 7388370D0B192732005C7A69 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 084C327D0FE4E5D500117FC9 /* analyze.c in Sources */, + 084C327E0FE4E5D500117FC9 /* encapiwrapper.c in Sources */, + 084C327F0FE4E5D500117FC9 /* encfrag.c in Sources */, + 084C32800FE4E5D500117FC9 /* encinfo.c in Sources */, + 084C32820FE4E5D500117FC9 /* encode.c in Sources */, + 084C32840FE4E5D500117FC9 /* enquant.c in Sources */, + 084C32860FE4E5D500117FC9 /* fdct.c in Sources */, + 084C32870FE4E5D500117FC9 /* huffenc.c in Sources */, + 084C32890FE4E5D500117FC9 /* mathops.c in Sources */, + 084C328B0FE4E5D500117FC9 /* mcenc.c in Sources */, + 084C328D0FE4E5D500117FC9 /* rate.c in Sources */, + 084C328E0FE4E5D500117FC9 /* tokenize.c in Sources */, + 084C32900FE4E5D500117FC9 /* mmxencfrag.c in Sources */, + 084C32910FE4E5D500117FC9 /* mmxfdct.c in Sources */, + 084C32920FE4E5D500117FC9 /* sse2fdct.c in Sources */, + 084C32930FE4E5D500117FC9 /* x86enc.c in Sources */, + 084C32A70FE4E7FE00117FC9 /* apiwrapper.c in Sources */, + 084C32AA0FE4E83100117FC9 /* idct.c in Sources */, + 084C32AB0FE4E83300117FC9 /* internal.c in Sources */, + 084C32AC0FE4E83600117FC9 /* fragment.c in Sources */, + 084C32AE0FE4E84A00117FC9 /* quant.c in Sources */, + 084C32B00FE4E84F00117FC9 /* state.c in Sources */, + 084C32B20FE4E85300117FC9 /* x86state.c in Sources */, + 084C32B30FE4E85D00117FC9 /* mmxstate.c in Sources */, + 084C32B40FE4E86A00117FC9 /* mmxfrag.c in Sources */, + 084C32B60FE4E87200117FC9 /* mmxidct.c in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 8D07F2C10486CC7A007CD1D0 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 084C31FE0FE4E5BD00117FC9 /* apiwrapper.c in Sources */, + 084C32000FE4E5BD00117FC9 /* bitpack.c in Sources */, + 084C32030FE4E5BD00117FC9 /* decapiwrapper.c in Sources */, + 084C32040FE4E5BD00117FC9 /* decinfo.c in Sources */, + 084C32060FE4E5BD00117FC9 /* decode.c in Sources */, + 084C32070FE4E5BD00117FC9 /* dequant.c in Sources */, + 084C32090FE4E5BD00117FC9 /* fragment.c in Sources */, + 084C320A0FE4E5BD00117FC9 /* huffdec.c in Sources */, + 084C320D0FE4E5BD00117FC9 /* idct.c in Sources */, + 084C320E0FE4E5BD00117FC9 /* info.c in Sources */, + 084C320F0FE4E5BD00117FC9 /* internal.c in Sources */, + 084C32110FE4E5BD00117FC9 /* quant.c in Sources */, + 084C32130FE4E5BD00117FC9 /* state.c in Sources */, + 084C32140FE4E5BD00117FC9 /* mmxfrag.c in Sources */, + 084C32160FE4E5BD00117FC9 /* mmxidct.c in Sources */, + 084C32180FE4E5BD00117FC9 /* mmxstate.c in Sources */, + 084C321A0FE4E5BD00117FC9 /* x86state.c in Sources */, + 084C32620FE4E5D500117FC9 /* analyze.c in Sources */, + 084C32630FE4E5D500117FC9 /* encapiwrapper.c in Sources */, + 084C32640FE4E5D500117FC9 /* encfrag.c in Sources */, + 084C32650FE4E5D500117FC9 /* encinfo.c in Sources */, + 084C32670FE4E5D500117FC9 /* encode.c in Sources */, + 084C32690FE4E5D500117FC9 /* enquant.c in Sources */, + 084C326B0FE4E5D500117FC9 /* fdct.c in Sources */, + 084C326C0FE4E5D500117FC9 /* huffenc.c in Sources */, + 084C326E0FE4E5D500117FC9 /* mathops.c in Sources */, + 084C32700FE4E5D500117FC9 /* mcenc.c in Sources */, + 084C32720FE4E5D500117FC9 /* rate.c in Sources */, + 084C32730FE4E5D500117FC9 /* tokenize.c in Sources */, + 084C32750FE4E5D500117FC9 /* mmxencfrag.c in Sources */, + 084C32760FE4E5D500117FC9 /* mmxfdct.c in Sources */, + 084C32770FE4E5D500117FC9 /* sse2fdct.c in Sources */, + 084C32780FE4E5D500117FC9 /* x86enc.c in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXVariantGroup section */ + 089C1666FE841158C02AAC07 /* InfoPlist.strings */ = { + isa = PBXVariantGroup; + children = ( + 089C1667FE841158C02AAC07 /* English */, + ); + name = InfoPlist.strings; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 09C8F6620C82FC3E00F72188 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + COPY_PHASE_STRIP = NO; + GCC_DYNAMIC_NO_PIC = NO; + GCC_ENABLE_FIX_AND_CONTINUE = YES; + GCC_GENERATE_DEBUGGING_SYMBOLS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../../ogg/include, + ); + INSTALL_PATH = /usr/local/lib; + PREBINDING = NO; + PRODUCT_NAME = theoradec; + ZERO_LINK = YES; + }; + name = Debug; + }; + 09C8F6630C82FC3E00F72188 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + COPY_PHASE_STRIP = YES; + GCC_ENABLE_FIX_AND_CONTINUE = NO; + GCC_GENERATE_DEBUGGING_SYMBOLS = NO; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../../ogg/include, + ); + INSTALL_PATH = /usr/local/lib; + PREBINDING = NO; + PRODUCT_NAME = theoradec; + ZERO_LINK = NO; + }; + name = Release; + }; + 4FADC24308B4156D00ABE55E /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + COPY_PHASE_STRIP = NO; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + FRAMEWORK_SEARCH_PATHS = ( + "$(inherited)", + /Library/Frameworks, + ); + FRAMEWORK_VERSION = A; + GCC_ENABLE_FIX_AND_CONTINUE = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PRECOMPILE_PREFIX_HEADER = YES; + GCC_PREFIX_HEADER = Theora_Prefix.pch; + INFOPLIST_FILE = Info.plist; + INSTALL_PATH = /Library/Frameworks; + LIBRARY_STYLE = DYNAMIC; + MACH_O_TYPE = mh_dylib; + OTHER_LDFLAGS_i386 = "-Wl,-read_only_relocs,suppress"; + PRODUCT_NAME = Theora; + WRAPPER_EXTENSION = framework; + ZERO_LINK = YES; + }; + name = Debug; + }; + 4FADC24408B4156D00ABE55E /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + FRAMEWORK_SEARCH_PATHS = ( + "$(inherited)", + /Library/Frameworks, + ); + FRAMEWORK_VERSION = A; + GCC_PRECOMPILE_PREFIX_HEADER = YES; + GCC_PREFIX_HEADER = Theora_Prefix.pch; + INFOPLIST_FILE = Info.plist; + INSTALL_PATH = /Library/Frameworks; + LIBRARY_STYLE = DYNAMIC; + MACH_O_TYPE = mh_dylib; + OTHER_LDFLAGS_i386 = "-Wl,-read_only_relocs,suppress"; + PREBINDING = YES; + PRODUCT_NAME = Theora; + WRAPPER_EXTENSION = framework; + }; + name = Release; + }; + 4FADC24708B4156D00ABE55E /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "$(GCC_PREPROCESSOR_DEFINITIONS)", + __MACOSX__, + ); + GCC_WARN_ABOUT_RETURN_TYPE = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../include, + "../lib/**", + ); + OTHER_CFLAGS = ""; + PREBINDING = NO; + SDKROOT = /Developer/SDKs/MacOSX10.4u.sdk; + }; + name = Debug; + }; + 4FADC24808B4156D00ABE55E /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ARCHS = "$(ARCHS_STANDARD_32_BIT_PRE_XCODE_3_1)"; + ARCHS_STANDARD_32_BIT_PRE_XCODE_3_1 = "ppc i386"; + GCC_OPTIMIZATION_LEVEL = 3; + GCC_PREPROCESSOR_DEFINITIONS = ( + "$(GCC_PREPROCESSOR_DEFINITIONS)", + __MACOSX__, + ); + GCC_WARN_ABOUT_RETURN_TYPE = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../include, + "../lib/**", + ); + OTHER_CFLAGS = ( + "$(OTHER_CFLAGS)", + "-falign-loops=16", + "-fforce-addr", + "-fomit-frame-pointer", + "-finline-functions", + "-funroll-loops", + ); + PER_ARCH_CFLAGS_i386 = "-DOC_X86_ASM"; + PREBINDING = NO; + SDKROOT = /Developer/SDKs/MacOSX10.4u.sdk; + }; + name = Release; + }; + 738837120B19277F005C7A69 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + COPY_PHASE_STRIP = NO; + GCC_DYNAMIC_NO_PIC = NO; + GCC_ENABLE_FIX_AND_CONTINUE = YES; + GCC_GENERATE_DEBUGGING_SYMBOLS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../../ogg/include, + ); + INSTALL_PATH = /usr/local/lib; + PREBINDING = NO; + PRODUCT_NAME = theoraenc; + ZERO_LINK = YES; + }; + name = Debug; + }; + 738837130B19277F005C7A69 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + COPY_PHASE_STRIP = YES; + GCC_ENABLE_FIX_AND_CONTINUE = NO; + GCC_GENERATE_DEBUGGING_SYMBOLS = NO; + HEADER_SEARCH_PATHS = ( + "$(inherited)", + ../../ogg/include, + ); + INSTALL_PATH = /usr/local/lib; + PREBINDING = NO; + PRODUCT_NAME = theoraenc; + ZERO_LINK = NO; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 09C8F6610C82FC3E00F72188 /* Build configuration list for PBXNativeTarget "libtheoradec (static)" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 09C8F6620C82FC3E00F72188 /* Debug */, + 09C8F6630C82FC3E00F72188 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 4FADC24208B4156D00ABE55E /* Build configuration list for PBXNativeTarget "Theora" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 4FADC24308B4156D00ABE55E /* Debug */, + 4FADC24408B4156D00ABE55E /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 4FADC24608B4156D00ABE55E /* Build configuration list for PBXProject "Theora" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 4FADC24708B4156D00ABE55E /* Debug */, + 4FADC24808B4156D00ABE55E /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 738837110B19277F005C7A69 /* Build configuration list for PBXNativeTarget "libtheoraenc (static)" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 738837120B19277F005C7A69 /* Debug */, + 738837130B19277F005C7A69 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 0867D690FE84028FC02AAC07 /* Project object */; +} diff --git a/libs/libtheora-1.1/macosx/Theora_Prefix.pch b/libs/libtheora-1.1/macosx/Theora_Prefix.pch new file mode 100644 index 00000000..ddae8072 --- /dev/null +++ b/libs/libtheora-1.1/macosx/Theora_Prefix.pch @@ -0,0 +1,5 @@ +// +// Prefix header for all source files of the 'Theora' target in the 'Theora' project. +// + +#include diff --git a/libs/libtheora-1.1/symbian/bld.inf b/libs/libtheora-1.1/symbian/bld.inf new file mode 100644 index 00000000..99d97167 --- /dev/null +++ b/libs/libtheora-1.1/symbian/bld.inf @@ -0,0 +1,35 @@ +/* + Copyright (C) 2003 Commonwealth Scientific and Industrial Research + Organisation (CSIRO) Australia + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + - Neither the name of CSIRO Australia nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ORGANISATION OR + CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ + +PRJ_MMPFILES + +theora.mmp diff --git a/libs/libtheora-1.1/symbian/config.h b/libs/libtheora-1.1/symbian/config.h new file mode 100644 index 00000000..df430d4e --- /dev/null +++ b/libs/libtheora-1.1/symbian/config.h @@ -0,0 +1,57 @@ +/* + Copyright (C) 2003 Commonwealth Scientific and Industrial Research + Organisation (CSIRO) Australia + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + - Neither the name of CSIRO Australia nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ORGANISATION OR + CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ + +#ifndef CONFIG_H +#define CONFIG_H + +/* Do not build encoding support */ + +#define THEORA_SUPPORT_ENCODE 0 + +/* Do not build floating point code */ + +#define THEORA_DISABLE_FLOAT 1 + +#ifdef __WINS__ + +/* Disable some warnings */ + +#pragma warning(disable: 4100) /* unreferenced formal parameter */ +//#pragma warning(disable: 4121) /* alignment of a member was sensitive to packing */ +#pragma warning(disable: 4244) /* conversion from '...' to '...', possible loss of data */ +#pragma warning(disable: 4505) /* unreferenced local function has been removed */ +#pragma warning(disable: 4701) /* local variable may be be used without having been initialized */ +#pragma warning(disable: 4761) /* integral size mismatch in argument: conversion supplied */ + +#endif + +#endif /* ! CONFIG_H */ diff --git a/libs/libtheora-1.1/symbian/theora.mmp b/libs/libtheora-1.1/symbian/theora.mmp new file mode 100644 index 00000000..771f25ff --- /dev/null +++ b/libs/libtheora-1.1/symbian/theora.mmp @@ -0,0 +1,41 @@ +/* + Copyright (C) 2003 Commonwealth Scientific and Industrial Research + Organisation (CSIRO) Australia + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + - Neither the name of CSIRO Australia nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ORGANISATION OR + CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ + +TARGET theora.lib +TARGETTYPE lib +UID 0 +MACRO HAVE_CONFIG_H +SOURCEPATH ..\lib +SOURCE blockmap.c comment.c dct.c dct_decode.c decode.c frarray.c frinit.c huffman.c +SOURCE idct.c mcomp.c misc_common.c pb.c pp.c quant.c reconstruct.c scan.c toplevel.c encoder_disabled.c +USERINCLUDE . +SYSTEMINCLUDE \epoc32\include \epoc32\include\libc ..\include ..\..\ogg\include ..\..\ogg\symbian diff --git a/libs/libtheora-1.1/tests/Makefile.am b/libs/libtheora-1.1/tests/Makefile.am new file mode 100644 index 00000000..7c11232a --- /dev/null +++ b/libs/libtheora-1.1/tests/Makefile.am @@ -0,0 +1,69 @@ +INCLUDES = -I$(top_srcdir)/include + +noinst_HEADERS = tests.h + +AM_CFLAGS = $(OGG_CFLAGS) + +THEORADIR = ../lib +THEORA_LIBS = $(THEORADIR)/libtheora.la $(OGG_LIBS) +THEORADEC_LIBS = $(THEORADIR)/libtheoradec.la $(OGG_LIBS) +THEORAENC_LIBS = $(THEORADIR)/libtheoraenc.la \ + $(THEORADIR)/libtheoradec.la $(OGG_LIBS) +test: check + +TESTS_ENVIRONMENT = $(VALGRIND_ENVIRONMENT) + +TESTS_DEC = noop_theora \ + comment comment_theoradec comment_theora + +TESTS_ENC = noop noop_theoraenc \ + granulepos granulepos_theoraenc granulepos_theora + +if THEORA_DISABLE_ENCODE +TESTS = $(TESTS_DEC) +else +TESTS = $(TESTS_DEC) $(TESTS_ENC) +endif + +check_PROGRAMS = $(TESTS) +# dummy call tests for the current api +noop_SOURCES = noop.c +noop_LDADD = $(THEORAENC_LIBS) +noop_CFLAGS = $(OGG_CFLAGS) + +# dummy call tests for the pre-1.0 legacy api with current link line +noop_theoraenc_SOURCES = noop_theora.c +noop_theoraenc_LDADD = $(THEORAENC_LIBS) +noop_theoraenc_CFLAGS = $(OGG_CFLAGS) + +# dummy call tests for the pre-1.0 legacy api with legacy link line +noop_theora_SOURCES = noop_theora.c +noop_theora_LDADD = $(THEORA_LIBS) +noop_theora_CFLAGS = $(OGG_CFLAGS) + +# comment utilities for the current api +comment_SOURCES = comment.c +comment_LDADD = $(THEORADEC_LIBS) +comment_CFLAGS = $(OGG_CFLAGS) + +# comment utilities for the legacy api and current lib +comment_theoradec_SOURCES = comment.c +comment_theoradec_LDADD = $(THEORADEC_LIBS) +comment_theoradec_CFLAGS = $(OGG_CFLAGS) + +# comment utilities for the legacy api and legacy lib +comment_theora_SOURCES = comment_theora.c +comment_theora_LDADD = $(THEORA_LIBS) +comment_theora_CFLAGS = $(OGG_CFLAGS) + +granulepos_SOURCES = granulepos.c +granulepos_LDADD = $(THEORAENC_LIBS) -lm +granulepos_CFLAGS = $(OGG_CFLAGS) + +granulepos_theoraenc_SOURCES = granulepos_theora.c +granulepos_theoraenc_LDADD = $(THEORAENC_LIBS) -lm +granulepos_theoraenc_CFLAGS = $(OGG_CFLAGS) + +granulepos_theora_SOURCES = granulepos_theora.c +granulepos_theora_LDADD = $(THEORA_LIBS) -lm +granulepos_theora_CFLAGS = $(OGG_CFLAGS) diff --git a/libs/libtheora-1.1/tests/comment.c b/libs/libtheora-1.1/tests/comment.c new file mode 100644 index 00000000..3b1a96eb --- /dev/null +++ b/libs/libtheora-1.1/tests/comment.c @@ -0,0 +1,91 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating comment header code + last mod: $Id: comment.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include + +#include +#include "tests.h" + +#define ARTIST1 "Bug-eyed Fish" +#define ARTIST2 "VJ Fugu" +#define COPYRIGHT "Copyright (C) 2005. Some Rights Reserved." +#define LICENSE "Creative Commons Attribution-ShareAlike 2.5" + +static int +test_comments () +{ + th_comment tc; + int n; + char * value; + + INFO ("+ Initializing th_comment"); + th_comment_init (&tc); + + INFO ("+ Adding ARTIST1"); + th_comment_add (&tc, "ARTIST=" ARTIST1); + + INFO ("+ Adding LICENSE by tag"); + th_comment_add_tag (&tc, "LICENSE", LICENSE); + + INFO ("+ Adding ARTIST2 by tag"); + th_comment_add_tag (&tc, "ARTIST", ARTIST2); + + INFO ("+ Querying value of LICENSE"); + value = th_comment_query (&tc, "LICENSE", 0); + printf("foo %s\n", value); + + if (strcmp (value, LICENSE)) + FAIL ("Incorrect value for LICENSE"); + + INFO ("+ Querying count of ARTIST comments"); + n = th_comment_query_count (&tc, "ARTIST"); + + if (n != 2) + FAIL ("Incorrect count of ARTIST comments"); + + INFO ("+ Querying value of ARTIST index 0"); + value = th_comment_query (&tc, "ARTIST", 0); + if (strcmp (value, ARTIST1)) + FAIL ("Incorrect value for ARTIST index 0"); + + INFO ("+ Querying value of ARTIST index 1"); + value = th_comment_query (&tc, "ARTIST", 1); + if (strcmp (value, ARTIST2)) + FAIL ("Incorrect value for ARTIST index 1"); + + INFO ("+ Querying value of ARTIST index 2 (out of bounds)"); + value = th_comment_query (&tc, "ARTIST", 2); + if (value != NULL) + FAIL ("Non-NULL value for ARTIST index 2 (out of bounds)"); + + INFO ("+ Querying value of UNDEF index 7 (tag not defined)"); + value = th_comment_query (&tc, "UNDEF", 7); + if (value != NULL) + FAIL ("Non-NULL value for UNDEF index 7 (tag not defined)"); + + INFO ("+ Clearing th_comment"); + th_comment_clear (&tc); + + return 0; +} + +int main(int argc, char *argv[]) +{ + test_comments (); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/comment_theora.c b/libs/libtheora-1.1/tests/comment_theora.c new file mode 100644 index 00000000..543b9fc4 --- /dev/null +++ b/libs/libtheora-1.1/tests/comment_theora.c @@ -0,0 +1,91 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating comment header code + last mod: $Id: comment_theora.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include + +#include +#include "tests.h" + +#define ARTIST1 "Bug-eyed Fish" +#define ARTIST2 "VJ Fugu" +#define COPYRIGHT "Copyright (C) 2005. Some Rights Reserved." +#define LICENSE "Creative Commons Attribution-ShareAlike 2.5" + +static int +test_comments () +{ + theora_comment tc; + int n; + char * value; + + INFO ("+ Initializing theora_comment"); + theora_comment_init (&tc); + + INFO ("+ Adding ARTIST1"); + theora_comment_add (&tc, "ARTIST=" ARTIST1); + + INFO ("+ Adding LICENSE by tag"); + theora_comment_add_tag (&tc, "LICENSE", LICENSE); + + INFO ("+ Adding ARTIST2 by tag"); + theora_comment_add_tag (&tc, "ARTIST", ARTIST2); + + INFO ("+ Querying value of LICENSE"); + value = theora_comment_query (&tc, "LICENSE", 0); + printf("foo %s\n", value); + + if (strcmp (value, LICENSE)) + FAIL ("Incorrect value for LICENSE"); + + INFO ("+ Querying count of ARTIST comments"); + n = theora_comment_query_count (&tc, "ARTIST"); + + if (n != 2) + FAIL ("Incorrect count of ARTIST comments"); + + INFO ("+ Querying value of ARTIST index 0"); + value = theora_comment_query (&tc, "ARTIST", 0); + if (strcmp (value, ARTIST1)) + FAIL ("Incorrect value for ARTIST index 0"); + + INFO ("+ Querying value of ARTIST index 1"); + value = theora_comment_query (&tc, "ARTIST", 1); + if (strcmp (value, ARTIST2)) + FAIL ("Incorrect value for ARTIST index 1"); + + INFO ("+ Querying value of ARTIST index 2 (out of bounds)"); + value = theora_comment_query (&tc, "ARTIST", 2); + if (value != NULL) + FAIL ("Non-NULL value for ARTIST index 2 (out of bounds)"); + + INFO ("+ Querying value of UNDEF index 7 (tag not defined)"); + value = theora_comment_query (&tc, "UNDEF", 7); + if (value != NULL) + FAIL ("Non-NULL value for UNDEF index 7 (tag not defined)"); + + INFO ("+ Clearing theora_comment"); + theora_comment_clear (&tc); + + return 0; +} + +int main(int argc, char *argv[]) +{ + test_comments (); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/granulepos.c b/libs/libtheora-1.1/tests/granulepos.c new file mode 100644 index 00000000..1c72fe90 --- /dev/null +++ b/libs/libtheora-1.1/tests/granulepos.c @@ -0,0 +1,149 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating encoder granulepos generation + last mod: $Id: granulepos.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include + +#include "tests.h" + +static int ilog(unsigned int v){ + int ret=0; + while(v){ + ret++; + v>>=1; + } + return(ret); +} + +static int +granulepos_test_encode (int frequency) +{ + th_info ti; + th_enc_ctx *te; + int result; + int frame, tframe, keyframe, keydist; + int shift; + double rate, ttime; + th_ycbcr_buffer yuv; + unsigned char *framedata; + ogg_packet op; + long long int last_granule = -1; + +/* INFO ("+ Initializing th_info struct"); */ + th_info_init (&ti); + + ti.frame_width = 32; + ti.frame_height = 32; + ti.pic_width = ti.frame_width; + ti.pic_height = ti.frame_height; + ti.pic_x = 0; + ti.pic_y = 0; + ti.fps_numerator = 16; + ti.fps_denominator = 1; + ti.aspect_numerator = 1; + ti.aspect_denominator = 1; + ti.colorspace = TH_CS_UNSPECIFIED; + ti.pixel_fmt = TH_PF_420; + ti.quality = 16; + ti.keyframe_granule_shift=ilog(frequency); + +/* INFO ("+ Allocating encoder context"); */ + te = th_encode_alloc(&ti); + if (te == NULL) { + INFO ("+ Clearing th_info"); + th_info_clear(&ti); + FAIL ("negative return code initializing encoder"); + } + +/* INFO ("+ Setting up dummy 4:2:0 frame data"); */ + framedata = calloc(ti.frame_height, ti.frame_width); + yuv[0].width = ti.frame_width; + yuv[0].height = ti.frame_height; + yuv[0].stride = ti.frame_width; + yuv[0].data = framedata; + yuv[1].width = ti.frame_width / 2; + yuv[1].height = ti.frame_width / 2; + yuv[1].stride = ti.frame_width; + yuv[1].data = framedata; + yuv[2].width = ti.frame_width / 2; + yuv[2].height = ti.frame_width / 2; + yuv[2].stride = ti.frame_width; + yuv[2].data = framedata; + + INFO ("+ Checking granulepos generation"); + shift = ti.keyframe_granule_shift; + rate = (double)ti.fps_denominator/ti.fps_numerator; + for (frame = 0; frame < frequency * 2 + 1; frame++) { + result = th_encode_ycbcr_in (te, yuv); + if (result < 0) { + printf("th_encode_ycbcr_in() returned %d\n", result); + FAIL ("negative error code submitting frame for compression"); + } + result = th_encode_packetout (te, frame >= frequency * 2, &op); + if (result <= 0) { + printf("th_encode_packetout() returned %d\n", result); + FAIL("failed to retrieve compressed frame"); + } + if ((long long int)op.granulepos < last_granule) + FAIL ("encoder returned a decreasing granulepos value"); + last_granule = op.granulepos; + keyframe = op.granulepos >> shift; + keydist = op.granulepos - (keyframe << shift); + tframe = th_granule_frame (te, op.granulepos); + ttime = th_granule_time(te, op.granulepos); +#if DEBUG + printf("++ frame %d granulepos %lld %d:%d %d %.3lfs\n", + frame, (long long int)op.granulepos, keyframe, keydist, + tframe, th_granule_time (te, op.granulepos)); +#endif + /* granulepos stores the frame count */ + if ((keyframe + keydist) != frame + 1) + FAIL ("encoder granulepos does not map to the correct frame number"); + /* th_granule_frame() returns the frame index */ + if (tframe != frame) + FAIL ("th_granule_frame() returned incorrect results"); + /* th_granule_time() returns the end time */ + if (fabs(rate*(frame+1) - ttime) > 1.0e-6) + FAIL ("th_granule_time() returned incorrect results"); + } + + /* clean up */ +/* INFO ("+ Freeing dummy frame data"); */ + free(framedata); + +/* INFO ("+ Clearing th_info struct"); */ + th_info_clear(&ti); + +/* INFO ("+ Freeing encoder context"); */ + th_encode_free(te); + + return 0; +} + +int main(int argc, char *argv[]) +{ + + granulepos_test_encode (1); + granulepos_test_encode (2); + granulepos_test_encode (3); + granulepos_test_encode (4); + granulepos_test_encode (8); + granulepos_test_encode (64); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/granulepos_theora.c b/libs/libtheora-1.1/tests/granulepos_theora.c new file mode 100644 index 00000000..691775b6 --- /dev/null +++ b/libs/libtheora-1.1/tests/granulepos_theora.c @@ -0,0 +1,154 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating encoder granulepos generation + last mod: $Id: granulepos_theora.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include +#include + +#include "tests.h" + +static int ilog(unsigned int v){ + int ret=0; + while(v){ + ret++; + v>>=1; + } + return(ret); +} + +static int +granulepos_test_encode (int frequency, int auto_p) +{ + theora_info ti; + theora_state th; + int result; + int frame, tframe, keyframe, keydist; + int shift; + double rate, ttime; + yuv_buffer yuv; + unsigned char *framedata; + ogg_packet op; + long long int last_granule = -1; + +/* INFO ("+ Initializing theora_info struct"); */ + theora_info_init (&ti); + + ti.width = 32; + ti.height = 32; + ti.frame_width = ti.width; + ti.frame_height = ti.frame_height; + ti.offset_x = 0; + ti.offset_y = 0; + ti.fps_numerator = 16; + ti.fps_denominator = 1; + ti.aspect_numerator = 1; + ti.aspect_denominator = 1; + ti.colorspace = OC_CS_UNSPECIFIED; + ti.pixelformat = OC_PF_420; + ti.target_bitrate = 0; + ti.quality = 16; + + ti.dropframes_p = 0; + ti.quick_p = 1; + + /* check variations of automatic or forced keyframe choice */ + ti.keyframe_auto_p = auto_p; + /* check with variations of the maximum gap */ + ti.keyframe_frequency = frequency; + ti.keyframe_frequency_force = frequency; + + ti.keyframe_data_target_bitrate = ti.target_bitrate * 1.5; + ti.keyframe_auto_threshold = 80; + ti.keyframe_mindistance = MIN(8, frequency); + ti.noise_sensitivity = 1; + +/* INFO ("+ Initializing theora_state for encoding"); */ + result = theora_encode_init (&th, &ti); + if (result == OC_DISABLED) { + INFO ("+ Clearing theora_state"); + theora_clear (&th); + } else if (result < 0) { + FAIL ("negative return code initializing encoder"); + } + +/* INFO ("+ Setting up dummy 4:2:0 frame data"); */ + framedata = calloc(ti.height, ti.width); + yuv.y_width = ti.width; + yuv.y_height = ti.height; + yuv.y_stride = ti.width; + yuv.y = framedata; + yuv.uv_width = ti.width / 2; + yuv.uv_height = ti.width / 2; + yuv.uv_stride = ti.width; + yuv.u = framedata; + yuv.v = framedata; + + INFO ("+ Checking granulepos generation"); + shift = theora_granule_shift(&ti); + rate = (double)ti.fps_denominator/ti.fps_numerator; + for (frame = 0; frame < frequency * 2 + 1; frame++) { + result = theora_encode_YUVin (&th, &yuv); + if (result < 0) { + printf("theora_encode_YUVin() returned %d\n", result); + FAIL ("negative error code submitting frame for compression"); + } + theora_encode_packetout (&th, frame >= frequency * 2, &op); + if ((long long int)op.granulepos < last_granule) + FAIL ("encoder returned a decreasing granulepos value"); + last_granule = op.granulepos; + keyframe = op.granulepos >> shift; + keydist = op.granulepos - (keyframe << shift); + tframe = theora_granule_frame (&th, op.granulepos); + ttime = theora_granule_time(&th, op.granulepos); +#if DEBUG + printf("++ frame %d granulepos %lld %d:%d %d %.3lfs\n", + frame, (long long int)op.granulepos, keyframe, keydist, + tframe, theora_granule_time (&th, op.granulepos)); +#endif + if ((keyframe + keydist) != frame + 1) + FAIL ("encoder granulepos does not map to the correct frame number"); + if (tframe != frame) + FAIL ("theora_granule_frame returned incorrect results"); + if (fabs(rate*(frame+1) - ttime) > 1.0e-6) + FAIL ("theora_granule_time returned incorrect results"); + } + + /* clean up */ +/* INFO ("+ Freeing dummy frame data"); */ + free (framedata); + +/* INFO ("+ Clearing theora_info struct"); */ + theora_info_clear (&ti); + +/* INFO ("+ Clearing theora_state"); */ + theora_clear (&th); + + return 0; +} + +int main(int argc, char *argv[]) +{ + + granulepos_test_encode (1, 1); + granulepos_test_encode (2, 1); + granulepos_test_encode (3, 1); + granulepos_test_encode (4, 1); + granulepos_test_encode (8, 1); + granulepos_test_encode (64, 1); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/noop.c b/libs/libtheora-1.1/tests/noop.c new file mode 100644 index 00000000..173f1f35 --- /dev/null +++ b/libs/libtheora-1.1/tests/noop.c @@ -0,0 +1,119 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating codec initialization + last mod: $Id: noop.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include +#include + +#include "tests.h" + +static int +noop_test_info () +{ + th_info ti; + + INFO ("+ Initializing th_info struct"); + th_info_init (&ti); + + INFO ("+ Clearing empty th_info struct"); + th_info_clear (&ti); + + return 0; +} + +static int +noop_test_comments () +{ + th_comment tc; + + INFO ("+ Initializing th_comment struct"); + th_comment_init (&tc); + + INFO ("+ Clearing empty th_comment struct") + th_comment_clear (&tc); + + return 0; +} + +static int +noop_test_encode () +{ + th_info ti; + th_enc_ctx *te; + + INFO ("+ Initializing th_info struct"); + th_info_init (&ti); + + INFO ("+ Testing encoder context with empty th_info"); + te = th_encode_alloc(&ti); + if (te != NULL) + FAIL("td_encode_alloc accepted an unconfigured th_info"); + + INFO ("+ Setting 16x16 image size"); + ti.frame_width = 16; + ti.frame_height = 16; + + INFO ("+ Allocating encoder context"); + te = th_encode_alloc(&ti); + if (te == NULL) + FAIL("td_encode_alloc returned a null pointer"); + + INFO ("+ Clearing th_info struct"); + th_info_clear (&ti); + + INFO ("+ Freeing encoder context"); + th_encode_free(te); + + return 0; +} + +static int +noop_test_decode () +{ + th_info ti; + th_dec_ctx *td; + + INFO ("+ Testing decoder context with null info and setup"); + td = th_decode_alloc(NULL, NULL); + if (td != NULL) + FAIL("td_decode_alloc accepted null info pointers"); + + INFO ("+ Initializing th_info struct"); + th_info_init (&ti); + + INFO ("+ Testing decoder context with empty info and null setup"); + td = th_decode_alloc(&ti, NULL); + if (td != NULL) + FAIL("td_decode_alloc accepted null info pointers"); + + INFO ("+ Clearing th_info struct"); + th_info_clear (&ti); + + return 0; +} + +int main(int argc, char *argv[]) +{ + noop_test_info (); + + noop_test_comments (); + + noop_test_encode (); + + noop_test_decode (); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/noop_theora.c b/libs/libtheora-1.1/tests/noop_theora.c new file mode 100644 index 00000000..1c9664bf --- /dev/null +++ b/libs/libtheora-1.1/tests/noop_theora.c @@ -0,0 +1,88 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: routines for validating codec initialization + last mod: $Id: noop_theora.c 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include + +#include "tests.h" + +static int +noop_test_encode () +{ + theora_info ti; + theora_state th; + + INFO ("+ Initializing theora_info struct"); + theora_info_init (&ti); + + INFO ("+ Setting a 16x16 frame"); + ti.width = 16; + ti.height = 16; + + INFO ("+ Initializing theora_state for encoding"); + if (theora_encode_init (&th, &ti) != OC_DISABLED) { + INFO ("+ Clearing theora_state"); + theora_clear (&th); + } + + INFO ("+ Clearing theora_info struct"); + theora_info_clear (&ti); + + return 0; +} + +static int +noop_test_decode () +{ + theora_info ti; + theora_state th; + + INFO ("+ Initializing theora_info struct"); + theora_info_init (&ti); + + INFO ("+ Initializing theora_state for decoding"); + theora_decode_init (&th, &ti); + + INFO ("+ Clearing theora_state"); + theora_clear (&th); + + INFO ("+ Clearing theora_info struct"); + theora_info_clear (&ti); + + return 0; +} + +static int +noop_test_comments () +{ + theora_comment tc; + + theora_comment_init (&tc); + theora_comment_clear (&tc); + + return 0; +} + +int main(int argc, char *argv[]) +{ + /*noop_test_decode ();*/ + + noop_test_encode (); + + noop_test_comments (); + + exit (0); +} diff --git a/libs/libtheora-1.1/tests/tests.h b/libs/libtheora-1.1/tests/tests.h new file mode 100644 index 00000000..cb9647d2 --- /dev/null +++ b/libs/libtheora-1.1/tests/tests.h @@ -0,0 +1,33 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2009 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: common test utilities + last mod: $Id: tests.h 16503 2009-08-22 18:14:02Z giles $ + + ********************************************************************/ + +#include "config.h" + +#include +#include + +#define INFO(str) \ + { printf ("---- %s ...\n", (str)); } + +#define WARN(str) \ + { printf ("%s:%d: warning: %s\n", __FILE__, __LINE__, (str)); } + +#define FAIL(str) \ + { printf ("%s:%d: %s\n", __FILE__, __LINE__, (str)); exit(1); } + +#undef MIN +#define MIN(a,b) ((a)<(b)?(a):(b)) diff --git a/libs/libtheora-1.1/theora-uninstalled.pc.in b/libs/libtheora-1.1/theora-uninstalled.pc.in new file mode 100644 index 00000000..6a8519ed --- /dev/null +++ b/libs/libtheora-1.1/theora-uninstalled.pc.in @@ -0,0 +1,14 @@ +# theora uninstalled pkg-config file + +prefix= +exec_prefix= +libdir=${pcfiledir}/lib +includedir=${pcfiledir}/include + +Name: theora uninstalled +Description: Theora video codec (not installed) +Version: @VERSION@ +Requires: ogg >= 1.1 +Conflicts: +Libs: ${libdir}/libtheora.la +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/theora.pc.in b/libs/libtheora-1.1/theora.pc.in new file mode 100644 index 00000000..d6553dd8 --- /dev/null +++ b/libs/libtheora-1.1/theora.pc.in @@ -0,0 +1,14 @@ +# theora installed pkg-config file + +prefix=@prefix@ +exec_prefix=@exec_prefix@ +libdir=@libdir@ +includedir=@includedir@ + +Name: theora +Description: Theora video codec +Version: @VERSION@ +Requires: ogg >= 1.1 +Conflicts: +Libs: -L${libdir} -ltheora +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/theoradec-uninstalled.pc.in b/libs/libtheora-1.1/theoradec-uninstalled.pc.in new file mode 100644 index 00000000..8bf9df13 --- /dev/null +++ b/libs/libtheora-1.1/theoradec-uninstalled.pc.in @@ -0,0 +1,14 @@ +# theoradec uninstalled pkg-config file + +prefix= +exec_prefix= +libdir=${pcfiledir}/lib +includedir=${pcfiledir}/include + +Name: theora uninstalled +Description: Theora video codec(decoder) (not installed) +Version: @VERSION@ +Requires: ogg >= 1.1 +Conflicts: +Libs: ${libdir}/libtheoradec.la +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/theoradec.pc.in b/libs/libtheora-1.1/theoradec.pc.in new file mode 100644 index 00000000..615718df --- /dev/null +++ b/libs/libtheora-1.1/theoradec.pc.in @@ -0,0 +1,14 @@ +# theoradec installed pkg-config file + +prefix=@prefix@ +exec_prefix=@exec_prefix@ +libdir=@libdir@ +includedir=@includedir@ + +Name: theora +Description: Theora video codec (decoder) +Version: @VERSION@ +Requires: ogg >= 1.1 +Conflicts: +Libs: -L${libdir} -ltheoradec +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/theoraenc-uninstalled.pc.in b/libs/libtheora-1.1/theoraenc-uninstalled.pc.in new file mode 100644 index 00000000..00c62242 --- /dev/null +++ b/libs/libtheora-1.1/theoraenc-uninstalled.pc.in @@ -0,0 +1,14 @@ +# theoraenc uninstalled pkg-config file + +prefix= +exec_prefix= +libdir=${pcfiledir}/lib +includedir=${pcfiledir}/include + +Name: theora uninstalled +Description: Theora video codec (encoder) (not installed) +Version: @VERSION@ +Requires: theoradec, ogg >= 1.1 +Conflicts: +Libs: ${libdir}/libtheoraenc.la +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/theoraenc.pc.in b/libs/libtheora-1.1/theoraenc.pc.in new file mode 100644 index 00000000..007ac8f8 --- /dev/null +++ b/libs/libtheora-1.1/theoraenc.pc.in @@ -0,0 +1,14 @@ +# theoraenc installed pkg-config file + +prefix=@prefix@ +exec_prefix=@exec_prefix@ +libdir=@libdir@ +includedir=@includedir@ + +Name: theora +Description: Theora video codec (encoder) +Version: @VERSION@ +Requires: theoradec, ogg >= 1.1 +Conflicts: +Libs: -L${libdir} -ltheoraenc +Cflags: -I${includedir} diff --git a/libs/libtheora-1.1/win32/VS2005/README b/libs/libtheora-1.1/win32/VS2005/README new file mode 100644 index 00000000..d40e0447 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/README @@ -0,0 +1,22 @@ +libtheora has libogg as a dependency, and for examples, also +libvorbis, therefore you need to have libogg and libvorbis +compiled beforehand. + +Lets say you have libogg, libvorbis and libtheora in the same directory: + +libogg-1.1.4 +libvorbis-1.2.2 +libtheora-1.0 + +Because there is no automatic library detection you have to, +either: + +1. Rename libogg-1.1.4 to libogg, and libvorbis-1.2.2 to libvorbis. + +2. Open libogg.vsprops with a text editor (even notepad.exe +will suffice) and see if LIBOGG_VERSION is set to the correct +version, in this case "1.1.4". + +The same procedure should be done for libvorbis.vsprops and +check LIBVORBIS_VERSION for the correct version, in this +case "1.2.2". diff --git a/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_dynamic.vcproj new file mode 100644 index 00000000..5e8dcb07 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_dynamic.vcproj @@ -0,0 +1,108 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_static.vcproj b/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_static.vcproj new file mode 100644 index 00000000..98023255 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/dump_video/dump_video_static.vcproj @@ -0,0 +1,108 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_dynamic.vcproj new file mode 100644 index 00000000..068d2ed6 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_dynamic.vcproj @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_static.vcproj b/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_static.vcproj new file mode 100644 index 00000000..9c9a0f90 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/encoder_example/encoder_example_static.vcproj @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/libogg.vsprops b/libs/libtheora-1.1/win32/VS2005/libogg.vsprops new file mode 100644 index 00000000..7fe0db78 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libogg.vsprops @@ -0,0 +1,19 @@ + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_dynamic.vcproj new file mode 100644 index 00000000..a74344d5 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_dynamic.vcproj @@ -0,0 +1,688 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_static.vcproj b/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_static.vcproj new file mode 100644 index 00000000..37875319 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libtheora/libtheora_static.vcproj @@ -0,0 +1,690 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2005/libtheora_dynamic.sln b/libs/libtheora-1.1/win32/VS2005/libtheora_dynamic.sln new file mode 100644 index 00000000..866ded7d --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libtheora_dynamic.sln @@ -0,0 +1,82 @@ + +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora", "libtheora\libtheora_dynamic.vcproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video", "dump_video\dump_video_dynamic.vcproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example", "encoder_example\encoder_example_dynamic.vcproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + Debug|Windows Mobile 6 Professional SDK (ARMV4I) = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + Release|Windows Mobile 6 Professional SDK (ARMV4I) = Release|Windows Mobile 6 Professional SDK (ARMV4I) + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2005/libtheora_static.sln b/libs/libtheora-1.1/win32/VS2005/libtheora_static.sln new file mode 100644 index 00000000..4ea995bd --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libtheora_static.sln @@ -0,0 +1,82 @@ + +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video_static", "dump_video\dump_video_static.vcproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora_static", "libtheora\libtheora_static.vcproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example_static", "encoder_example\encoder_example_static.vcproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + Debug|Windows Mobile 6 Professional SDK (ARMV4I) = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + Release|Windows Mobile 6 Professional SDK (ARMV4I) = Release|Windows Mobile 6 Professional SDK (ARMV4I) + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Pocket PC SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Smartphone SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2005/libvorbis.vsprops b/libs/libtheora-1.1/win32/VS2005/libvorbis.vsprops new file mode 100644 index 00000000..1829228a --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2005/libvorbis.vsprops @@ -0,0 +1,19 @@ + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/README b/libs/libtheora-1.1/win32/VS2008/README new file mode 100644 index 00000000..d40e0447 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/README @@ -0,0 +1,22 @@ +libtheora has libogg as a dependency, and for examples, also +libvorbis, therefore you need to have libogg and libvorbis +compiled beforehand. + +Lets say you have libogg, libvorbis and libtheora in the same directory: + +libogg-1.1.4 +libvorbis-1.2.2 +libtheora-1.0 + +Because there is no automatic library detection you have to, +either: + +1. Rename libogg-1.1.4 to libogg, and libvorbis-1.2.2 to libvorbis. + +2. Open libogg.vsprops with a text editor (even notepad.exe +will suffice) and see if LIBOGG_VERSION is set to the correct +version, in this case "1.1.4". + +The same procedure should be done for libvorbis.vsprops and +check LIBVORBIS_VERSION for the correct version, in this +case "1.2.2". diff --git a/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_dynamic.vcproj new file mode 100644 index 00000000..9c527231 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_dynamic.vcproj @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_static.vcproj b/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_static.vcproj new file mode 100644 index 00000000..8b188b6f --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/dump_video/dump_video_static.vcproj @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_dynamic.vcproj new file mode 100644 index 00000000..ec5486c6 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_dynamic.vcproj @@ -0,0 +1,100 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_static.vcproj b/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_static.vcproj new file mode 100644 index 00000000..7026d33e --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/encoder_example/encoder_example_static.vcproj @@ -0,0 +1,100 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/libogg.vsprops b/libs/libtheora-1.1/win32/VS2008/libogg.vsprops new file mode 100644 index 00000000..1355b507 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libogg.vsprops @@ -0,0 +1,19 @@ + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_dynamic.vcproj b/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_dynamic.vcproj new file mode 100644 index 00000000..ce2170fe --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_dynamic.vcproj @@ -0,0 +1,576 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_static.vcproj b/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_static.vcproj new file mode 100644 index 00000000..256fe5ac --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libtheora/libtheora_static.vcproj @@ -0,0 +1,566 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2008/libtheora_dynamic.sln b/libs/libtheora-1.1/win32/VS2008/libtheora_dynamic.sln new file mode 100644 index 00000000..d4bde5de --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libtheora_dynamic.sln @@ -0,0 +1,146 @@ + +Microsoft Visual Studio Solution File, Format Version 10.00 +# Visual Studio 2008 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora", "libtheora\libtheora_dynamic.vcproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video", "dump_video\dump_video_dynamic.vcproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example", "encoder_example\encoder_example_dynamic.vcproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Debug|Windows Mobile 6 Professional SDK (ARMV4I) = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + Debug|x64 = Debug|x64 + Release_SSE|Win32 = Release_SSE|Win32 + Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + Release_SSE|x64 = Release_SSE|x64 + Release_SSE2|Win32 = Release_SSE2|Win32 + Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + Release_SSE2|x64 = Release_SSE2|x64 + Release|Win32 = Release|Win32 + Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release|Windows Mobile 6 Professional SDK (ARMV4I) = Release|Windows Mobile 6 Professional SDK (ARMV4I) + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2008/libtheora_static.sln b/libs/libtheora-1.1/win32/VS2008/libtheora_static.sln new file mode 100644 index 00000000..2b396351 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libtheora_static.sln @@ -0,0 +1,146 @@ + +Microsoft Visual Studio Solution File, Format Version 10.00 +# Visual Studio 2008 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video_static", "dump_video\dump_video_static.vcproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora_static", "libtheora\libtheora_static.vcproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example_static", "encoder_example\encoder_example_static.vcproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Debug|Windows Mobile 6 Professional SDK (ARMV4I) = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + Debug|x64 = Debug|x64 + Release_SSE|Win32 = Release_SSE|Win32 + Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + Release_SSE|x64 = Release_SSE|x64 + Release_SSE2|Win32 = Release_SSE2|Win32 + Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + Release_SSE2|x64 = Release_SSE2|x64 + Release|Win32 = Release|Win32 + Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + Release|Windows Mobile 6 Professional SDK (ARMV4I) = Release|Windows Mobile 6 Professional SDK (ARMV4I) + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Debug|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Build.0 = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).Deploy.0 = Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Build.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Windows Mobile 6 Professional SDK (ARMV4I).Deploy.0 = Release|Windows Mobile 6 Professional SDK (ARMV4I) + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Win32.ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Win32.Build.0 = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|x64.ActiveCfg = Release_SSE|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE|x64.Build.0 = Release_SSE|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Win32.ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Win32.Build.0 = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release_SSE2|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|x64.ActiveCfg = Release_SSE2|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release_SSE2|x64.Build.0 = Release_SSE2|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Pocket PC SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 5.0 Smartphone SDK 2 (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Windows Mobile 6 Professional SDK (ARMV4I).ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2008/libvorbis.vsprops b/libs/libtheora-1.1/win32/VS2008/libvorbis.vsprops new file mode 100644 index 00000000..cd10cf53 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2008/libvorbis.vsprops @@ -0,0 +1,19 @@ + + + + + + diff --git a/libs/libtheora-1.1/win32/VS2010/README b/libs/libtheora-1.1/win32/VS2010/README new file mode 100644 index 00000000..6c62c1a8 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/README @@ -0,0 +1,22 @@ +libtheora has libogg as a dependency, and for examples, also +libvorbis, therefore you need to have libogg and libvorbis +compiled beforehand. + +Lets say you have libogg, libvorbis and libtheora in the same directory: + +libogg-1.1.4 +libvorbis-1.2.2 +libtheora-1.0 + +Because there is no automatic library detection you have to, +either: + +1. Rename libogg-1.1.4 to libogg, and libvorbis-1.2.2 to libvorbis. + +2. Open libogg.props with a text editor (even notepad.exe +will suffice) and see if LIBOGG_VERSION is set to the correct +version, in this case "1.1.4". + +The same procedure should be done for libvorbis.props and +check LIBVORBIS_VERSION for the correct version, in this +case "1.2.2". diff --git a/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_dynamic.vcxproj b/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_dynamic.vcxproj new file mode 100644 index 00000000..e4fa6edd --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_dynamic.vcxproj @@ -0,0 +1,198 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + dump_video + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF} + dump_video + Win32Proj + + + + Application + Unicode + true + + + Application + Unicode + + + Application + Unicode + true + + + Application + Unicode + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + EditAndContinue + + + libogg.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX86 + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX64 + + + + + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level3 + ProgramDatabase + + + libogg.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX86 + + + + + X64 + + + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level3 + ProgramDatabase + + + libogg.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX64 + + + + + + + + + + + + + + {653f3841-3f26-49b9-afcf-091db4b67031} + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_static.vcxproj b/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_static.vcxproj new file mode 100644 index 00000000..5457fad3 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/dump_video/dump_video_static.vcxproj @@ -0,0 +1,198 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF} + dump_video + Win32Proj + + + + Application + Unicode + true + + + Application + Unicode + + + Application + Unicode + true + + + Application + Unicode + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + EditAndContinue + + + libogg_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX86 + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX64 + + + + + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level3 + ProgramDatabase + + + libogg_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX86 + + + + + X64 + + + ..\..\..\include;..\..\..\..\libogg\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level3 + ProgramDatabase + + + libogg_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX64 + + + + + + + + + + + + + + {653f3841-3f26-49b9-afcf-091db4b67031} + false + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_dynamic.vcxproj b/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_dynamic.vcxproj new file mode 100644 index 00000000..2f979567 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_dynamic.vcxproj @@ -0,0 +1,204 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + encoder_example + {AD710263-EBFA-4388-BAA9-AD73C32AFF26} + encoder_example + Win32Proj + + + + Application + Unicode + true + + + Application + Unicode + + + Application + Unicode + true + + + Application + Unicode + + + + + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + EditAndContinue + + + libogg.lib;libvorbis.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX86 + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg.lib;libvorbis.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX64 + + + + + AnySuitable + true + Speed + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level4 + ProgramDatabase + + + libogg.lib;libvorbis.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX86 + + + + + X64 + + + AnySuitable + true + Speed + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level4 + ProgramDatabase + + + libogg.lib;libvorbis.lib;libtheora.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX64 + + + + + + + + + + {653f3841-3f26-49b9-afcf-091db4b67031} + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_static.vcxproj b/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_static.vcxproj new file mode 100644 index 00000000..b90f9137 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/encoder_example/encoder_example_static.vcxproj @@ -0,0 +1,204 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + {AD710263-EBFA-4388-BAA9-AD73C32AFF26} + encoder_example + Win32Proj + + + + Application + Unicode + true + + + Application + Unicode + + + Application + Unicode + true + + + Application + Unicode + + + + + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + true + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + false + + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + EditAndContinue + + + libogg_static.lib;libvorbis_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX86 + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg_static.lib;libvorbis_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + true + Console + false + + + MachineX64 + + + + + AnySuitable + true + Speed + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level4 + ProgramDatabase + + + libogg_static.lib;libvorbis_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX86 + + + + + X64 + + + AnySuitable + true + Speed + ..\..\..\include;..\..\..\..\libogg\include;..\..\..\..\libvorbis\include;%(AdditionalIncludeDirectories) + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + MultiThreadedDLL + + + Level4 + ProgramDatabase + + + libogg_static.lib;libvorbis_static.lib;libtheora_static.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\libvorbis\win32\VS2010\$(Platform)\$(Configuration);..\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + false + Console + true + true + false + + + MachineX64 + + + + + + + + + + {653f3841-3f26-49b9-afcf-091db4b67031} + false + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/libogg.props b/libs/libtheora-1.1/win32/VS2010/libogg.props new file mode 100644 index 00000000..4e1373e1 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libogg.props @@ -0,0 +1,22 @@ + + + + 1.2.0 + + + <_ProjectFileVersion>10.0.30319.1 + + + + ..\..\..\..\libogg-$(LIBOGG_VERSION)\include;..\..\..\..\ogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include;%(AdditionalIncludeDirectories) + + + ..\..\..\..\libogg-$(LIBOGG_VERSION)\win32\VS2010\$(PlatformName)\$(ConfigurationName);..\..\..\..\ogg\win32\VS2010\$(PlatformName)\$(ConfigurationName);..\..\..\..\..\..\..\core\ogg\libogg\win32\VS2010\$(PlatformName)\$(ConfigurationName) + + + + + $(LIBOGG_VERSION) + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_dynamic.vcxproj b/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_dynamic.vcxproj new file mode 100644 index 00000000..4e4688c4 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_dynamic.vcxproj @@ -0,0 +1,285 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + libtheora + {653F3841-3F26-49B9-AFCF-091DB4B67031} + libtheora + Win32Proj + + + + DynamicLibrary + Unicode + true + + + DynamicLibrary + Unicode + + + DynamicLibrary + Unicode + true + + + DynamicLibrary + Unicode + + + + + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + + + + Disabled + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;_DEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;DEBUG;OC_X86_ASM;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + ..\..\..\lib\theora.def + false + + + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;_DEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;DEBUG;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + libogg.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + ..\..\..\lib\theora.def + false + + + + + + + MaxSpeed + AnySuitable + true + Speed + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;OC_X86_ASM;%(PreprocessorDefinitions) + true + + + MultiThreadedDLL + false + + + Level4 + + + CompileAsC + 4244;4267;4057;4100;4245;%(DisableSpecificWarnings) + + + libogg.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + ..\..\..\lib\theora.def + false + + + + + + + X64 + + + MaxSpeed + AnySuitable + true + Speed + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;%(PreprocessorDefinitions) + true + + + MultiThreadedDLL + false + + + Level4 + + + CompileAsC + 4244;4267;4057;4100;4245;%(DisableSpecificWarnings) + + + libogg.lib;%(AdditionalDependencies) + ..\..\..\..\libogg\win32\VS2010\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + ..\..\..\lib\theora.def + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + true + true + true + + + + + + + + + + + + + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_static.vcxproj b/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_static.vcxproj new file mode 100644 index 00000000..af5678aa --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libtheora/libtheora_static.vcxproj @@ -0,0 +1,251 @@ + + + + + Debug + Win32 + + + Debug + x64 + + + Release + Win32 + + + Release + x64 + + + + {653F3841-3F26-49B9-AFCF-091DB4B67031} + libtheora + Win32Proj + + + + StaticLibrary + Unicode + true + + + StaticLibrary + Unicode + + + StaticLibrary + Unicode + true + + + StaticLibrary + Unicode + + + + + + + + + + + + + + + + + + + + + + + + + + + <_ProjectFileVersion>10.0.30319.1 + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + $(SolutionDir)$(Platform)\$(Configuration)\ + $(Platform)\$(Configuration)\ + + + + Disabled + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;_DEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;DEBUG;OC_X86_ASM;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + + + X64 + + + Disabled + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;_DEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;DEBUG;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + + Level3 + ProgramDatabase + + + + + MaxSpeed + AnySuitable + true + Speed + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;OC_X86_ASM;%(PreprocessorDefinitions) + true + + + MultiThreadedDLL + false + + + Level4 + + + CompileAsC + 4244;4267;4057;4100;4245;%(DisableSpecificWarnings) + + + + + X64 + + + MaxSpeed + AnySuitable + true + Speed + ..\..\..\include;..\..\..\lib;..\..\..\..\libogg\include;..\..\..\..\..\..\..\core\ogg\libogg\include\;%(AdditionalIncludeDirectories) + _CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE;WIN32;NDEBUG;_WINDOWS;_USRDLL;LIBTHEORA_EXPORTS;%(PreprocessorDefinitions) + true + + + MultiThreadedDLL + false + + + Level4 + + + CompileAsC + 4244;4267;4057;4100;4245;%(DisableSpecificWarnings) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + true + true + true + + + + + + + + + + + + + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + $(IntDir)%(Filename)1.obj + $(IntDir)%(Filename)1.xdc + + + + + + + + + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/VS2010/libtheora_dynamic.sln b/libs/libtheora-1.1/win32/VS2010/libtheora_dynamic.sln new file mode 100644 index 00000000..e33e9542 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libtheora_dynamic.sln @@ -0,0 +1,46 @@ + +Microsoft Visual Studio Solution File, Format Version 11.00 +# Visual Studio 2010 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora", "libtheora\libtheora_dynamic.vcxproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video", "dump_video\dump_video_dynamic.vcxproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example", "encoder_example\encoder_example_dynamic.vcxproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2010/libtheora_static.sln b/libs/libtheora-1.1/win32/VS2010/libtheora_static.sln new file mode 100644 index 00000000..e6323fa4 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libtheora_static.sln @@ -0,0 +1,46 @@ + +Microsoft Visual Studio Solution File, Format Version 11.00 +# Visual Studio 2010 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "dump_video_static", "dump_video\dump_video_static.vcxproj", "{1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libtheora_static", "libtheora\libtheora_static.vcxproj", "{653F3841-3F26-49B9-AFCF-091DB4B67031}" +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "encoder_example_static", "encoder_example\encoder_example_static.vcxproj", "{AD710263-EBFA-4388-BAA9-AD73C32AFF26}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.ActiveCfg = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|Win32.Build.0 = Debug|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.ActiveCfg = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Debug|x64.Build.0 = Debug|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.ActiveCfg = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|Win32.Build.0 = Release|Win32 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.ActiveCfg = Release|x64 + {1A8CA99D-B6C7-48CB-B263-6CECDADF5FBF}.Release|x64.Build.0 = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.ActiveCfg = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|Win32.Build.0 = Debug|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.ActiveCfg = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Debug|x64.Build.0 = Debug|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.ActiveCfg = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|Win32.Build.0 = Release|Win32 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.ActiveCfg = Release|x64 + {653F3841-3F26-49B9-AFCF-091DB4B67031}.Release|x64.Build.0 = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.ActiveCfg = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|Win32.Build.0 = Debug|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.ActiveCfg = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Debug|x64.Build.0 = Debug|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.ActiveCfg = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|Win32.Build.0 = Release|Win32 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.ActiveCfg = Release|x64 + {AD710263-EBFA-4388-BAA9-AD73C32AFF26}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/libs/libtheora-1.1/win32/VS2010/libvorbis.props b/libs/libtheora-1.1/win32/VS2010/libvorbis.props new file mode 100644 index 00000000..e8ae8d85 --- /dev/null +++ b/libs/libtheora-1.1/win32/VS2010/libvorbis.props @@ -0,0 +1,22 @@ + + + + 1.3.1 + + + <_ProjectFileVersion>10.0.30319.1 + + + + ..\..\..\..\libvorbis-$(LIBVORBIS_VERSION)\include;..\..\..\..\vorbis\include;..\..\..\..\..\..\vorbis\libs\libvorbis\include;%(AdditionalIncludeDirectories) + + + ..\..\..\..\libvorbis-$(LIBVORBIS_VERSION)\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\vorbis\win32\VS2010\$(Platform)\$(Configuration);..\..\..\..\..\..\vorbis\libs\libvorbis\win32\VS2010\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories) + + + + + $(LIBVORBIS_VERSION) + + + \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/build_theora_static.bat b/libs/libtheora-1.1/win32/build_theora_static.bat new file mode 100644 index 00000000..842cef01 --- /dev/null +++ b/libs/libtheora-1.1/win32/build_theora_static.bat @@ -0,0 +1,18 @@ +@echo off +echo ---+++--- Building Theora (Static) ---+++--- + +if .%SRCROOT%==. set SRCROOT=D:\xiph + +set OLDPATH=%PATH% +set OLDINCLUDE=%INCLUDE% +set OLDLIB=%LIB% + +call "c:\program files\microsoft visual studio\vc98\bin\vcvars32.bat" +echo Setting include paths for Theora +set INCLUDE=%INCLUDE%;%SRCROOT%\ogg\include;%SRCROOT%\theora\include +echo Compiling... +msdev theora_static.dsp /useenv /make "theora_static - Win32 Release" /rebuild + +set PATH=%OLDPATH% +set INCLUDE=%OLDINCLUDE% +set LIB=%OLDLIB% diff --git a/libs/libtheora-1.1/win32/build_theora_static_debug.bat b/libs/libtheora-1.1/win32/build_theora_static_debug.bat new file mode 100644 index 00000000..c58edb0d --- /dev/null +++ b/libs/libtheora-1.1/win32/build_theora_static_debug.bat @@ -0,0 +1,18 @@ +@echo off +echo ---+++--- Building Theora (Static) ---+++--- + +if .%SRCROOT%==. set SRCROOT=D:\xiph + +set OLDPATH=%PATH% +set OLDINCLUDE=%INCLUDE% +set OLDLIB=%LIB% + +call "c:\program files\microsoft visual studio\vc98\bin\vcvars32.bat" +echo Setting include paths for Theora +set INCLUDE=%INCLUDE%;%SRCROOT%\ogg\include;%SRCROOT%\theora\include +echo Compiling... +msdev theora_static.dsp /useenv /make "theora_static - Win32 Debug" /rebuild + +set PATH=%OLDPATH% +set INCLUDE=%OLDINCLUDE% +set LIB=%OLDLIB% diff --git a/libs/libtheora-1.1/win32/experimental/dumpvid/dumpvid.dsp b/libs/libtheora-1.1/win32/experimental/dumpvid/dumpvid.dsp new file mode 100644 index 00000000..40c4b07b --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/dumpvid/dumpvid.dsp @@ -0,0 +1,121 @@ +# Microsoft Developer Studio Project File - Name="dumpvid" - Package Owner=<4> +# Microsoft Developer Studio Generated Build File, Format Version 6.00 +# ** DO NOT EDIT ** + +# TARGTYPE "Win32 (x86) Console Application" 0x0103 + +CFG=dumpvid - Win32 Debug +!MESSAGE This is not a valid makefile. To build this project using NMAKE, +!MESSAGE use the Export Makefile command and run +!MESSAGE +!MESSAGE NMAKE /f "dumpvid.mak". +!MESSAGE +!MESSAGE You can specify a configuration when running NMAKE +!MESSAGE by defining the macro CFG on the command line. For example: +!MESSAGE +!MESSAGE NMAKE /f "dumpvid.mak" CFG="dumpvid - Win32 Debug" +!MESSAGE +!MESSAGE Possible choices for configuration are: +!MESSAGE +!MESSAGE "dumpvid - Win32 Release" (based on "Win32 (x86) Console Application") +!MESSAGE "dumpvid - Win32 Debug" (based on "Win32 (x86) Console Application") +!MESSAGE + +# Begin Project +# PROP AllowPerConfigDependencies 0 +# PROP Scc_ProjName "" +# PROP Scc_LocalPath "" +CPP=cl.exe +RSC=rc.exe + +!IF "$(CFG)" == "dumpvid - Win32 Release" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 0 +# PROP BASE Output_Dir "Release" +# PROP BASE Intermediate_Dir "Release" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 0 +# PROP Output_Dir "Release" +# PROP Intermediate_Dir "Release" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /c +# ADD CPP /nologo /MD /W3 /GX /O2 /I "..\..\..\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /FD /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "NDEBUG" +# ADD RSC /l 0x409 /d "NDEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386 +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static.lib ogg_static.lib /nologo /subsystem:console /machine:I386 /nodefaultlib:"LIBCMT" /out:"dump_vid.exe" /libpath:"..\..\Static_Release" /libpath:"..\..\..\..\ogg\win32\Static_Release" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Release" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Release" + +!ELSEIF "$(CFG)" == "dumpvid - Win32 Debug" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 1 +# PROP BASE Output_Dir "Debug" +# PROP BASE Intermediate_Dir "Debug" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 1 +# PROP Output_Dir "Debug" +# PROP Intermediate_Dir "Debug" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /GZ /c +# ADD CPP /nologo /MDd /W3 /Gm /GX /ZI /Od /I "..\..\..\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /FR /FD /GZ /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "_DEBUG" +# ADD RSC /l 0x409 /d "_DEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static_d.lib ogg_static_d.lib /nologo /subsystem:console /debug /machine:I386 /nodefaultlib:"LIBCD" /out:"dump_vid.exe" /pdbtype:sept /libpath:"..\..\Static_Debug" /libpath:"..\..\..\..\ogg\win32\Static_Debug" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Debug" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Debug" +# SUBTRACT LINK32 /nodefaultlib + +!ENDIF + +# Begin Target + +# Name "dumpvid - Win32 Release" +# Name "dumpvid - Win32 Debug" +# Begin Group "Source Files" + +# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" +# Begin Source File + +SOURCE=..\..\..\examples\dump_video.c +# End Source File +# Begin Source File + +SOURCE=..\wincompat\getopt.c +# End Source File +# Begin Source File + +SOURCE=..\wincompat\getopt_long.c +# End Source File +# End Group +# Begin Group "Header Files" + +# PROP Default_Filter "h;hpp;hxx;hm;inl" +# End Group +# Begin Group "Resource Files" + +# PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe" +# End Group +# Begin Group "library" + +# PROP Default_Filter "" +# End Group +# Begin Source File + +SOURCE=.\ReadMe.txt +# End Source File +# End Target +# End Project diff --git a/libs/libtheora-1.1/win32/experimental/encoderwin/ReadMe.txt b/libs/libtheora-1.1/win32/experimental/encoderwin/ReadMe.txt new file mode 100644 index 00000000..478cd4e1 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/encoderwin/ReadMe.txt @@ -0,0 +1,13 @@ +05/30/03 +Updated to use the common encoder_sample.c source in theora/examples. + +05/23/03 + +Very simple port of the sample encoder for Windows, for testing. +Encoder options in the command line are not working, and the frame rate +of video needs to be set in code (like in the simple sample encoder.) + +This example will be updated to a true Win32 app sometime in the future, +hope it is useful for basic testing now. + +mauricio@xiph.org \ No newline at end of file diff --git a/libs/libtheora-1.1/win32/experimental/encoderwin/encoderwin.dsp b/libs/libtheora-1.1/win32/experimental/encoderwin/encoderwin.dsp new file mode 100644 index 00000000..6befa4ec --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/encoderwin/encoderwin.dsp @@ -0,0 +1,121 @@ +# Microsoft Developer Studio Project File - Name="encoderwin" - Package Owner=<4> +# Microsoft Developer Studio Generated Build File, Format Version 6.00 +# ** DO NOT EDIT ** + +# TARGTYPE "Win32 (x86) Console Application" 0x0103 + +CFG=encoderwin - Win32 Debug +!MESSAGE This is not a valid makefile. To build this project using NMAKE, +!MESSAGE use the Export Makefile command and run +!MESSAGE +!MESSAGE NMAKE /f "encoderwin.mak". +!MESSAGE +!MESSAGE You can specify a configuration when running NMAKE +!MESSAGE by defining the macro CFG on the command line. For example: +!MESSAGE +!MESSAGE NMAKE /f "encoderwin.mak" CFG="encoderwin - Win32 Debug" +!MESSAGE +!MESSAGE Possible choices for configuration are: +!MESSAGE +!MESSAGE "encoderwin - Win32 Release" (based on "Win32 (x86) Console Application") +!MESSAGE "encoderwin - Win32 Debug" (based on "Win32 (x86) Console Application") +!MESSAGE + +# Begin Project +# PROP AllowPerConfigDependencies 0 +# PROP Scc_ProjName "" +# PROP Scc_LocalPath "" +CPP=cl.exe +RSC=rc.exe + +!IF "$(CFG)" == "encoderwin - Win32 Release" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 0 +# PROP BASE Output_Dir "Release" +# PROP BASE Intermediate_Dir "Release" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 0 +# PROP Output_Dir "Release" +# PROP Intermediate_Dir "Release" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /c +# ADD CPP /nologo /MD /W3 /GX /O2 /I "..\..\..\include" /I "..\..\..\..\vorbis\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /FD /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "NDEBUG" +# ADD RSC /l 0x409 /d "NDEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386 +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static.lib ogg_static.lib vorbis_static.lib vorbisenc_static.lib /nologo /subsystem:console /machine:I386 /nodefaultlib:"LIBCMT" /out:"encoderwin.exe" /libpath:"..\..\Static_Release" /libpath:"..\..\..\..\ogg\win32\Static_Release" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Release" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Release" + +!ELSEIF "$(CFG)" == "encoderwin - Win32 Debug" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 1 +# PROP BASE Output_Dir "Debug" +# PROP BASE Intermediate_Dir "Debug" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 1 +# PROP Output_Dir "Debug" +# PROP Intermediate_Dir "Debug" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /GZ /c +# ADD CPP /nologo /MDd /W3 /Gm /GX /ZI /Od /I "..\..\..\include" /I "..\..\..\..\vorbis\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /FD /GZ /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "_DEBUG" +# ADD RSC /l 0x409 /d "_DEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static_d.lib ogg_static_d.lib vorbis_static_d.lib vorbisenc_static_d.lib /nologo /subsystem:console /debug /machine:I386 /nodefaultlib:"LIBCD" /out:"encoderwin.exe" /pdbtype:sept /libpath:"..\..\Static_Debug" /libpath:"..\..\..\..\ogg\win32\Static_Debug" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Debug" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Debug" +# SUBTRACT LINK32 /nodefaultlib + +!ENDIF + +# Begin Target + +# Name "encoderwin - Win32 Release" +# Name "encoderwin - Win32 Debug" +# Begin Group "Source Files" + +# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" +# Begin Source File + +SOURCE=..\..\..\examples\encoder_example.c +# End Source File +# Begin Source File + +SOURCE=..\wincompat\getopt.c +# End Source File +# Begin Source File + +SOURCE=..\wincompat\getopt_long.c +# End Source File +# End Group +# Begin Group "Header Files" + +# PROP Default_Filter "h;hpp;hxx;hm;inl" +# End Group +# Begin Group "Resource Files" + +# PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe" +# End Group +# Begin Group "library" + +# PROP Default_Filter "" +# End Group +# Begin Source File + +SOURCE=.\ReadMe.txt +# End Source File +# End Target +# End Project diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avi2vp3.c b/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avi2vp3.c new file mode 100644 index 00000000..1ddfb2a4 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avi2vp3.c @@ -0,0 +1,82 @@ +#include +#include +#ifdef _WIN32 +#include +#else +typedef long DWORD; +#endif + +/*extremely crude app to dump vp3 frames from an avi file*/ +/*filenames are hardcoded*/ + +#include "avilib.h" + +int main(int argc, const char **argv) +{ + + FILE * f = fopen("outfile.vp3", "wb"); + + char * buffer; + int olength; + int length; + avi_t *avifile; + int chunksize; + int frame; + int frames; + int keyframegap = 0; + int maxkeyframegap = 0; + + DWORD initialticks; + + int framew = 0; + int frameh = 0; + double framerate = 0.0f; + double fps_numerator, fps_denominator; + + avifile = AVI_open_input_file("vp31.avi", 1); + frames = AVI_video_frames(avifile); + framew = AVI_video_width(avifile); + frameh = AVI_video_height(avifile); + framerate = AVI_frame_rate(avifile); + chunksize = AVI_max_video_chunk(avifile); + /* avilib only reports the max video chunk size if the file has an + idx table. We fall back to an arbitrary limit otherwise. Better + would be just to handle the chunks dynamically */ + if (chunksize <= 0) chunksize = 131072; + buffer = malloc(chunksize); + printf("Frames(%d) Video(%dx%d) %3.2f fps\n",frames,framew, frameh,framerate); + printf("Video Compressor: %s", AVI_video_compressor(avifile)); + fps_denominator = 1000000.0F; + fps_numerator = framerate * fps_denominator; + + sprintf(buffer,"AVI2VP31R W%d H%d F%.0f:%.0f Ip A0:0\n", framew, frameh, fps_numerator, fps_denominator); + fwrite(buffer, strlen(buffer), 1, f); + + for (frame = 0; frame < frames;) { + int keyframe; + olength = length; + length = AVI_frame_size(avifile, frame++); + if( !length ) { + length = olength; + } + AVI_read_frame(avifile, (char *) buffer, &keyframe); + fwrite("FRAME\n", 6, 1, f); + fwrite(&length, sizeof(int), 1, f); + fwrite(&keyframe, sizeof(int), 1, f); + printf("Frame size(%d) IsKeyframe(%d)\n", length, keyframe); + fwrite(buffer, 1, length, f); + if (!keyframe){ + keyframegap++; + } else { + if (keyframegap>maxkeyframegap) maxkeyframegap=keyframegap; + keyframegap = 0; + } + } + + fclose(f); + printf("Max keyframegap (%d)\n", maxkeyframegap); + + free(buffer); + + exit(0); +} diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avilib.c b/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avilib.c new file mode 100644 index 00000000..c76007da --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/avilib.c @@ -0,0 +1,1839 @@ +/* + * avilib.c + * + * Copyright (C) Thomas Östreich - June 2001 + * multiple audio track support Copyright (C) 2002 Thomas Östreich + * + * Original code: + * Copyright (C) 1999 Rainer Johanni + * + * This file is part of transcode, a linux video stream processing tool + * + * transcode is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2, or (at your option) + * any later version. + * + * transcode is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with GNU Make; see the file COPYING. If not, write to + * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include "avilib.h" +//#include + +#define INFO_LIST + +/* The following variable indicates the kind of error */ + +long AVI_errno; + +#define MAX_INFO_STRLEN 64 +static char id_str[MAX_INFO_STRLEN]; + +#define FRAME_RATE_SCALE 1000000 + +#ifndef PACKAGE +#define PACKAGE "my" +#define VERSION "0.00" +#endif + +#ifndef O_BINARY +/* win32 wants a binary flag to open(); this sets it to null + on platforms that don't have it. */ +#define O_BINARY 0 +#endif + +/******************************************************************* + * * + * Utilities for writing an AVI File * + * * + *******************************************************************/ + +static size_t avi_read(int fd, char *buf, size_t len) +{ + size_t n = 0; + size_t r = 0; + + while (r < len) { + n = read (fd, buf + r, len - r); + + if (n <= 0) + return r; + r += n; + } + + return r; +} + +static size_t avi_write (int fd, char *buf, size_t len) +{ + size_t n = 0; + size_t r = 0; + + while (r < len) { + n = write (fd, buf + r, len - r); + if (n < 0) + return n; + + r += n; + } + return r; +} + +/* HEADERBYTES: The number of bytes to reserve for the header */ + +#define HEADERBYTES 2048 + +/* AVI_MAX_LEN: The maximum length of an AVI file, we stay a bit below + the 2GB limit (Remember: 2*10^9 is smaller than 2 GB) */ + +#define AVI_MAX_LEN (UINT_MAX-(1<<20)*16-HEADERBYTES) + +#define PAD_EVEN(x) ( ((x)+1) & ~1 ) + + +/* Copy n into dst as a 4 byte, little endian number. + Should also work on big endian machines */ + +static void long2str(unsigned char *dst, int n) +{ + dst[0] = (n )&0xff; + dst[1] = (n>> 8)&0xff; + dst[2] = (n>>16)&0xff; + dst[3] = (n>>24)&0xff; +} + +/* Convert a string of 4 or 2 bytes to a number, + also working on big endian machines */ + +static unsigned long str2ulong(unsigned char *str) +{ + return ( str[0] | (str[1]<<8) | (str[2]<<16) | (str[3]<<24) ); +} +static unsigned long str2ushort(unsigned char *str) +{ + return ( str[0] | (str[1]<<8) ); +} + +/* Calculate audio sample size from number of bits and number of channels. + This may have to be adjusted for eg. 12 bits and stereo */ + +static int avi_sampsize(avi_t *AVI, int j) +{ + int s; + s = ((AVI->track[j].a_bits+7)/8)*AVI->track[j].a_chans; + // if(s==0) s=1; /* avoid possible zero divisions */ + if(s<4) s=4; /* avoid possible zero divisions */ + return s; +} + +/* Add a chunk (=tag and data) to the AVI file, + returns -1 on write error, 0 on success */ + +static int avi_add_chunk(avi_t *AVI, unsigned char *tag, unsigned char *data, int length) +{ + unsigned char c[8]; + + /* Copy tag and length int c, so that we need only 1 write system call + for these two values */ + + memcpy(c,tag,4); + long2str(c+4,length); + + /* Output tag, length and data, restore previous position + if the write fails */ + + length = PAD_EVEN(length); + + if( avi_write(AVI->fdes,(char *)c,8) != 8 || + avi_write(AVI->fdes,(char *)data,length) != length ) + { + lseek(AVI->fdes,AVI->pos,SEEK_SET); + AVI_errno = AVI_ERR_WRITE; + return -1; + } + + /* Update file position */ + + AVI->pos += 8 + length; + + //fprintf(stderr, "pos=%lu %s\n", AVI->pos, tag); + + return 0; +} + +static int avi_add_index_entry(avi_t *AVI, unsigned char *tag, long flags, unsigned long pos, unsigned long len) +{ + void *ptr; + + if(AVI->n_idx>=AVI->max_idx) { + ptr = realloc((void *)AVI->idx,(AVI->max_idx+4096)*16); + + if(ptr == 0) { + AVI_errno = AVI_ERR_NO_MEM; + return -1; + } + AVI->max_idx += 4096; + AVI->idx = (unsigned char((*)[16]) ) ptr; + } + + /* Add index entry */ + + // fprintf(stderr, "INDEX %s %ld %lu %lu\n", tag, flags, pos, len); + + memcpy(AVI->idx[AVI->n_idx],tag,4); + long2str(AVI->idx[AVI->n_idx]+ 4,flags); + long2str(AVI->idx[AVI->n_idx]+ 8, pos); + long2str(AVI->idx[AVI->n_idx]+12, len); + + /* Update counter */ + + AVI->n_idx++; + + if(len>AVI->max_len) AVI->max_len=len; + + return 0; +} + +/* + AVI_open_output_file: Open an AVI File and write a bunch + of zero bytes as space for the header. + + returns a pointer to avi_t on success, a zero pointer on error +*/ + +avi_t* AVI_open_output_file(char * filename) +{ + avi_t *AVI; + int i; + + int mask = 0; + + unsigned char AVI_header[HEADERBYTES]; + + /* Allocate the avi_t struct and zero it */ + + AVI = (avi_t *) malloc(sizeof(avi_t)); + if(AVI==0) + { + AVI_errno = AVI_ERR_NO_MEM; + return 0; + } + memset((void *)AVI,0,sizeof(avi_t)); + + /* Since Linux needs a long time when deleting big files, + we do not truncate the file when we open it. + Instead it is truncated when the AVI file is closed */ + + /* mask = umask (0); + umask (mask);*/ + + AVI->fdes = open(filename, O_RDWR|O_CREAT|O_BINARY, 0644 &~ mask); + if (AVI->fdes < 0) + { + AVI_errno = AVI_ERR_OPEN; + free(AVI); + return 0; + } + + /* Write out HEADERBYTES bytes, the header will go here + when we are finished with writing */ + + for (i=0;ifdes,(char *)AVI_header,HEADERBYTES); + if (i != HEADERBYTES) + { + close(AVI->fdes); + AVI_errno = AVI_ERR_WRITE; + free(AVI); + return 0; + } + + AVI->pos = HEADERBYTES; + AVI->mode = AVI_MODE_WRITE; /* open for writing */ + + //init + AVI->anum = 0; + AVI->aptr = 0; + + return AVI; +} + +void AVI_set_video(avi_t *AVI, int width, int height, double fps, char *compressor) +{ + /* may only be called if file is open for writing */ + + if(AVI->mode==AVI_MODE_READ) return; + + AVI->width = width; + AVI->height = height; + AVI->fps = fps; + + if(strncmp(compressor, "RGB", 3)==0) { + memset(AVI->compressor, 0, 4); + } else { + memcpy(AVI->compressor,compressor,4); + } + + AVI->compressor[4] = 0; + + avi_update_header(AVI); +} + +void AVI_set_audio(avi_t *AVI, int channels, long rate, int bits, int format, long mp3rate) +{ + /* may only be called if file is open for writing */ + + if(AVI->mode==AVI_MODE_READ) return; + + //inc audio tracks + AVI->aptr=AVI->anum; + ++AVI->anum; + + if(AVI->anum > AVI_MAX_TRACKS) { + fprintf(stderr, "error - only %d audio tracks supported\n", AVI_MAX_TRACKS); + exit(1); + } + + AVI->track[AVI->aptr].a_chans = channels; + AVI->track[AVI->aptr].a_rate = rate; + AVI->track[AVI->aptr].a_bits = bits; + AVI->track[AVI->aptr].a_fmt = format; + AVI->track[AVI->aptr].mp3rate = mp3rate; + + avi_update_header(AVI); +} + +#define OUT4CC(s) \ + if(nhb<=HEADERBYTES-4) memcpy(AVI_header+nhb,s,4); nhb += 4 + +#define OUTLONG(n) \ + if(nhb<=HEADERBYTES-4) long2str(AVI_header+nhb,n); nhb += 4 + +#define OUTSHRT(n) \ + if(nhb<=HEADERBYTES-2) { \ + AVI_header[nhb ] = (n )&0xff; \ + AVI_header[nhb+1] = (n>>8)&0xff; \ + } \ + nhb += 2 + + +//ThOe write preliminary AVI file header: 0 frames, max vid/aud size +int avi_update_header(avi_t *AVI) +{ + int njunk, sampsize, hasIndex, ms_per_frame, frate, flag; + int movi_len, hdrl_start, strl_start, j; + unsigned char AVI_header[HEADERBYTES]; + long nhb; + + //assume max size + movi_len = AVI_MAX_LEN - HEADERBYTES + 4; + + //assume index will be written + hasIndex=1; + + if(AVI->fps < 0.001) { + frate=0; + ms_per_frame=0; + } else { + frate = (int) (FRAME_RATE_SCALE*AVI->fps + 0.5); + ms_per_frame=(int) (1000000/AVI->fps + 0.5); + } + + /* Prepare the file header */ + + nhb = 0; + + /* The RIFF header */ + + OUT4CC ("RIFF"); + OUTLONG(movi_len); // assume max size + OUT4CC ("AVI "); + + /* Start the header list */ + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + hdrl_start = nhb; /* Store start position */ + OUT4CC ("hdrl"); + + /* The main AVI header */ + + /* The Flags in AVI File header */ + +#define AVIF_HASINDEX 0x00000010 /* Index at end of file */ +#define AVIF_MUSTUSEINDEX 0x00000020 +#define AVIF_ISINTERLEAVED 0x00000100 +#define AVIF_TRUSTCKTYPE 0x00000800 /* Use CKType to find key frames */ +#define AVIF_WASCAPTUREFILE 0x00010000 +#define AVIF_COPYRIGHTED 0x00020000 + + OUT4CC ("avih"); + OUTLONG(56); /* # of bytes to follow */ + OUTLONG(ms_per_frame); /* Microseconds per frame */ + //ThOe ->0 + // OUTLONG(10000000); /* MaxBytesPerSec, I hope this will never be used */ + OUTLONG(0); + OUTLONG(0); /* PaddingGranularity (whatever that might be) */ + /* Other sources call it 'reserved' */ + flag = AVIF_ISINTERLEAVED; + if(hasIndex) flag |= AVIF_HASINDEX; + if(hasIndex && AVI->must_use_index) flag |= AVIF_MUSTUSEINDEX; + OUTLONG(flag); /* Flags */ + OUTLONG(0); // no frames yet + OUTLONG(0); /* InitialFrames */ + + OUTLONG(AVI->anum+1); + + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(AVI->width); /* Width */ + OUTLONG(AVI->height); /* Height */ + /* MS calls the following 'reserved': */ + OUTLONG(0); /* TimeScale: Unit used to measure time */ + OUTLONG(0); /* DataRate: Data rate of playback */ + OUTLONG(0); /* StartTime: Starting time of AVI data */ + OUTLONG(0); /* DataLength: Size of AVI data chunk */ + + + /* Start the video stream list ---------------------------------- */ + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + strl_start = nhb; /* Store start position */ + OUT4CC ("strl"); + + /* The video stream header */ + + OUT4CC ("strh"); + OUTLONG(56); /* # of bytes to follow */ + OUT4CC ("vids"); /* Type */ + OUT4CC (AVI->compressor); /* Handler */ + OUTLONG(0); /* Flags */ + OUTLONG(0); /* Reserved, MS says: wPriority, wLanguage */ + OUTLONG(0); /* InitialFrames */ + OUTLONG(FRAME_RATE_SCALE); /* Scale */ + OUTLONG(frate); /* Rate: Rate/Scale == samples/second */ + OUTLONG(0); /* Start */ + OUTLONG(0); // no frames yet + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(-1); /* Quality */ + OUTLONG(0); /* SampleSize */ + OUTLONG(0); /* Frame */ + OUTLONG(0); /* Frame */ + // OUTLONG(0); /* Frame */ + //OUTLONG(0); /* Frame */ + + /* The video stream format */ + + OUT4CC ("strf"); + OUTLONG(40); /* # of bytes to follow */ + OUTLONG(40); /* Size */ + OUTLONG(AVI->width); /* Width */ + OUTLONG(AVI->height); /* Height */ + OUTSHRT(1); OUTSHRT(24); /* Planes, Count */ + OUT4CC (AVI->compressor); /* Compression */ + // ThOe (*3) + OUTLONG(AVI->width*AVI->height*3); /* SizeImage (in bytes?) */ + OUTLONG(0); /* XPelsPerMeter */ + OUTLONG(0); /* YPelsPerMeter */ + OUTLONG(0); /* ClrUsed: Number of colors used */ + OUTLONG(0); /* ClrImportant: Number of colors important */ + + /* Finish stream list, i.e. put number of bytes in the list to proper pos */ + + long2str(AVI_header+strl_start-4,nhb-strl_start); + + + /* Start the audio stream list ---------------------------------- */ + + for(j=0; janum; ++j) { + + sampsize = avi_sampsize(AVI, j); + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + strl_start = nhb; /* Store start position */ + OUT4CC ("strl"); + + /* The audio stream header */ + + OUT4CC ("strh"); + OUTLONG(56); /* # of bytes to follow */ + OUT4CC ("auds"); + + // ----------- + // ThOe + OUTLONG(0); /* Format (Optionally) */ + // ----------- + + OUTLONG(0); /* Flags */ + OUTLONG(0); /* Reserved, MS says: wPriority, wLanguage */ + OUTLONG(0); /* InitialFrames */ + + // ThOe /4 + OUTLONG(sampsize/4); /* Scale */ + OUTLONG(1000*AVI->track[j].mp3rate/8); + OUTLONG(0); /* Start */ + OUTLONG(4*AVI->track[j].audio_bytes/sampsize); /* Length */ + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(-1); /* Quality */ + + // ThOe /4 + OUTLONG(sampsize/4); /* SampleSize */ + + OUTLONG(0); /* Frame */ + OUTLONG(0); /* Frame */ + // OUTLONG(0); /* Frame */ + //OUTLONG(0); /* Frame */ + + /* The audio stream format */ + + OUT4CC ("strf"); + OUTLONG(16); /* # of bytes to follow */ + OUTSHRT(AVI->track[j].a_fmt); /* Format */ + OUTSHRT(AVI->track[j].a_chans); /* Number of channels */ + OUTLONG(AVI->track[j].a_rate); /* SamplesPerSec */ + // ThOe + OUTLONG(1000*AVI->track[j].mp3rate/8); + //ThOe (/4) + + OUTSHRT(sampsize/4); /* BlockAlign */ + + + OUTSHRT(AVI->track[j].a_bits); /* BitsPerSample */ + + /* Finish stream list, i.e. put number of bytes in the list to proper pos */ + + long2str(AVI_header+strl_start-4,nhb-strl_start); + } + + /* Finish header list */ + + long2str(AVI_header+hdrl_start-4,nhb-hdrl_start); + + + /* Calculate the needed amount of junk bytes, output junk */ + + njunk = HEADERBYTES - nhb - 8 - 12; + + /* Safety first: if njunk <= 0, somebody has played with + HEADERBYTES without knowing what (s)he did. + This is a fatal error */ + + if(njunk<=0) + { + fprintf(stderr,"AVI_close_output_file: # of header bytes too small\n"); + exit(1); + } + + OUT4CC ("JUNK"); + OUTLONG(njunk); + memset(AVI_header+nhb,0,njunk); + + //11/14/01 added id string + + if(njunk > strlen(id_str)+8) { + sprintf(id_str, "%s-%s", PACKAGE, VERSION); + memcpy(AVI_header+nhb, id_str, strlen(id_str)); + } + + nhb += njunk; + + /* Start the movi list */ + + OUT4CC ("LIST"); + OUTLONG(movi_len); /* Length of list in bytes */ + OUT4CC ("movi"); + + /* Output the header, truncate the file to the number of bytes + actually written, report an error if someting goes wrong */ + + if ( lseek(AVI->fdes,0,SEEK_SET)<0 || + avi_write(AVI->fdes,(char *)AVI_header,HEADERBYTES)!=HEADERBYTES || + lseek(AVI->fdes,AVI->pos,SEEK_SET)<0) + { + AVI_errno = AVI_ERR_CLOSE; + return -1; + } + + return 0; +} + +/* + Write the header of an AVI file and close it. + returns 0 on success, -1 on write error. +*/ + +static int avi_close_output_file(avi_t *AVI) +{ + + int ret, njunk, sampsize, hasIndex, ms_per_frame, frate, idxerror, flag; + unsigned long movi_len; + int hdrl_start, strl_start, j; + unsigned char AVI_header[HEADERBYTES]; + long nhb; + +#ifdef INFO_LIST + long info_len; +// time_t calptr; +#endif + + /* Calculate length of movi list */ + + movi_len = AVI->pos - HEADERBYTES + 4; + + /* Try to ouput the index entries. This may fail e.g. if no space + is left on device. We will report this as an error, but we still + try to write the header correctly (so that the file still may be + readable in the most cases */ + + idxerror = 0; + // fprintf(stderr, "pos=%lu, index_len=%ld \n", AVI->pos, AVI->n_idx*16); + ret = avi_add_chunk(AVI, (unsigned char *)"idx1", (void*)AVI->idx, AVI->n_idx*16); + hasIndex = (ret==0); + //fprintf(stderr, "pos=%lu, index_len=%d\n", AVI->pos, hasIndex); + + if(ret) { + idxerror = 1; + AVI_errno = AVI_ERR_WRITE_INDEX; + } + + /* Calculate Microseconds per frame */ + + if(AVI->fps < 0.001) { + frate=0; + ms_per_frame=0; + } else { + frate = (int) (FRAME_RATE_SCALE*AVI->fps + 0.5); + ms_per_frame=(int) (1000000/AVI->fps + 0.5); + } + + /* Prepare the file header */ + + nhb = 0; + + /* The RIFF header */ + + OUT4CC ("RIFF"); + OUTLONG(AVI->pos - 8); /* # of bytes to follow */ + OUT4CC ("AVI "); + + /* Start the header list */ + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + hdrl_start = nhb; /* Store start position */ + OUT4CC ("hdrl"); + + /* The main AVI header */ + + /* The Flags in AVI File header */ + +#define AVIF_HASINDEX 0x00000010 /* Index at end of file */ +#define AVIF_MUSTUSEINDEX 0x00000020 +#define AVIF_ISINTERLEAVED 0x00000100 +#define AVIF_TRUSTCKTYPE 0x00000800 /* Use CKType to find key frames */ +#define AVIF_WASCAPTUREFILE 0x00010000 +#define AVIF_COPYRIGHTED 0x00020000 + + OUT4CC ("avih"); + OUTLONG(56); /* # of bytes to follow */ + OUTLONG(ms_per_frame); /* Microseconds per frame */ + //ThOe ->0 + // OUTLONG(10000000); /* MaxBytesPerSec, I hope this will never be used */ + OUTLONG(0); + OUTLONG(0); /* PaddingGranularity (whatever that might be) */ + /* Other sources call it 'reserved' */ + flag = AVIF_ISINTERLEAVED; + if(hasIndex) flag |= AVIF_HASINDEX; + if(hasIndex && AVI->must_use_index) flag |= AVIF_MUSTUSEINDEX; + OUTLONG(flag); /* Flags */ + OUTLONG(AVI->video_frames); /* TotalFrames */ + OUTLONG(0); /* InitialFrames */ + + OUTLONG(AVI->anum+1); +// if (AVI->track[0].audio_bytes) +// { OUTLONG(2); } /* Streams */ +// else +// { OUTLONG(1); } /* Streams */ + + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(AVI->width); /* Width */ + OUTLONG(AVI->height); /* Height */ + /* MS calls the following 'reserved': */ + OUTLONG(0); /* TimeScale: Unit used to measure time */ + OUTLONG(0); /* DataRate: Data rate of playback */ + OUTLONG(0); /* StartTime: Starting time of AVI data */ + OUTLONG(0); /* DataLength: Size of AVI data chunk */ + + + /* Start the video stream list ---------------------------------- */ + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + strl_start = nhb; /* Store start position */ + OUT4CC ("strl"); + + /* The video stream header */ + + OUT4CC ("strh"); + OUTLONG(56); /* # of bytes to follow */ + OUT4CC ("vids"); /* Type */ + OUT4CC (AVI->compressor); /* Handler */ + OUTLONG(0); /* Flags */ + OUTLONG(0); /* Reserved, MS says: wPriority, wLanguage */ + OUTLONG(0); /* InitialFrames */ + OUTLONG(FRAME_RATE_SCALE); /* Scale */ + OUTLONG(frate); /* Rate: Rate/Scale == samples/second */ + OUTLONG(0); /* Start */ + OUTLONG(AVI->video_frames); /* Length */ + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(-1); /* Quality */ + OUTLONG(0); /* SampleSize */ + OUTLONG(0); /* Frame */ + OUTLONG(0); /* Frame */ + // OUTLONG(0); /* Frame */ + //OUTLONG(0); /* Frame */ + + /* The video stream format */ + + OUT4CC ("strf"); + OUTLONG(40); /* # of bytes to follow */ + OUTLONG(40); /* Size */ + OUTLONG(AVI->width); /* Width */ + OUTLONG(AVI->height); /* Height */ + OUTSHRT(1); OUTSHRT(24); /* Planes, Count */ + OUT4CC (AVI->compressor); /* Compression */ + // ThOe (*3) + OUTLONG(AVI->width*AVI->height*3); /* SizeImage (in bytes?) */ + OUTLONG(0); /* XPelsPerMeter */ + OUTLONG(0); /* YPelsPerMeter */ + OUTLONG(0); /* ClrUsed: Number of colors used */ + OUTLONG(0); /* ClrImportant: Number of colors important */ + + /* Finish stream list, i.e. put number of bytes in the list to proper pos */ + + long2str(AVI_header+strl_start-4,nhb-strl_start); + + /* Start the audio stream list ---------------------------------- */ + + for(j=0; janum; ++j) { + + //if (AVI->track[j].a_chans && AVI->track[j].audio_bytes) + { + + sampsize = avi_sampsize(AVI, j); + + OUT4CC ("LIST"); + OUTLONG(0); /* Length of list in bytes, don't know yet */ + strl_start = nhb; /* Store start position */ + OUT4CC ("strl"); + + /* The audio stream header */ + + OUT4CC ("strh"); + OUTLONG(56); /* # of bytes to follow */ + OUT4CC ("auds"); + + // ----------- + // ThOe + OUTLONG(0); /* Format (Optionally) */ + // ----------- + + OUTLONG(0); /* Flags */ + OUTLONG(0); /* Reserved, MS says: wPriority, wLanguage */ + OUTLONG(0); /* InitialFrames */ + + // ThOe /4 + OUTLONG(sampsize/4); /* Scale */ + OUTLONG(1000*AVI->track[j].mp3rate/8); + OUTLONG(0); /* Start */ + OUTLONG(4*AVI->track[j].audio_bytes/sampsize); /* Length */ + OUTLONG(0); /* SuggestedBufferSize */ + OUTLONG(-1); /* Quality */ + + // ThOe /4 + OUTLONG(sampsize/4); /* SampleSize */ + + OUTLONG(0); /* Frame */ + OUTLONG(0); /* Frame */ + // OUTLONG(0); /* Frame */ + //OUTLONG(0); /* Frame */ + + /* The audio stream format */ + + OUT4CC ("strf"); + OUTLONG(16); /* # of bytes to follow */ + OUTSHRT(AVI->track[j].a_fmt); /* Format */ + OUTSHRT(AVI->track[j].a_chans); /* Number of channels */ + OUTLONG(AVI->track[j].a_rate); /* SamplesPerSec */ + // ThOe + OUTLONG(1000*AVI->track[j].mp3rate/8); + //ThOe (/4) + + OUTSHRT(sampsize/4); /* BlockAlign */ + + + OUTSHRT(AVI->track[j].a_bits); /* BitsPerSample */ + + /* Finish stream list, i.e. put number of bytes in the list to proper pos */ + } + long2str(AVI_header+strl_start-4,nhb-strl_start); + } + + /* Finish header list */ + + long2str(AVI_header+hdrl_start-4,nhb-hdrl_start); + + + // add INFO list --- (0.6.0pre4) + +#ifdef INFO_LIST + OUT4CC ("LIST"); + + //FIXME + info_len = MAX_INFO_STRLEN + 12; + OUTLONG(info_len); + OUT4CC ("INFO"); + +// OUT4CC ("INAM"); +// OUTLONG(MAX_INFO_STRLEN); + +// sprintf(id_str, "\t"); +// memset(AVI_header+nhb, 0, MAX_INFO_STRLEN); +// memcpy(AVI_header+nhb, id_str, strlen(id_str)); +// nhb += MAX_INFO_STRLEN; + + OUT4CC ("ISFT"); + OUTLONG(MAX_INFO_STRLEN); + + sprintf(id_str, "%s-%s", PACKAGE, VERSION); + memset(AVI_header+nhb, 0, MAX_INFO_STRLEN); + memcpy(AVI_header+nhb, id_str, strlen(id_str)); + nhb += MAX_INFO_STRLEN; + +// OUT4CC ("ICMT"); +// OUTLONG(MAX_INFO_STRLEN); + +// calptr=time(NULL); +// sprintf(id_str, "\t%s %s", ctime(&calptr), ""); +// memset(AVI_header+nhb, 0, MAX_INFO_STRLEN); +// memcpy(AVI_header+nhb, id_str, 25); +// nhb += MAX_INFO_STRLEN; +#endif + + // ---------------------------- + + /* Calculate the needed amount of junk bytes, output junk */ + + njunk = HEADERBYTES - nhb - 8 - 12; + + /* Safety first: if njunk <= 0, somebody has played with + HEADERBYTES without knowing what (s)he did. + This is a fatal error */ + + if(njunk<=0) + { + fprintf(stderr,"AVI_close_output_file: # of header bytes too small\n"); + exit(1); + } + + OUT4CC ("JUNK"); + OUTLONG(njunk); + memset(AVI_header+nhb,0,njunk); + + nhb += njunk; + + /* Start the movi list */ + + OUT4CC ("LIST"); + OUTLONG(movi_len); /* Length of list in bytes */ + OUT4CC ("movi"); + + /* Output the header, truncate the file to the number of bytes + actually written, report an error if someting goes wrong */ + + if ( lseek(AVI->fdes,0,SEEK_SET)<0 || + avi_write(AVI->fdes,(char *)AVI_header,HEADERBYTES)!=HEADERBYTES + //|| ftruncate(AVI->fdes,AVI->pos)<0 + ) + { + AVI_errno = AVI_ERR_CLOSE; + return -1; + } + + if(idxerror) return -1; + + return 0; +} + +/* + AVI_write_data: + Add video or audio data to the file; + + Return values: + 0 No error; + -1 Error, AVI_errno is set appropriatly; + +*/ + +static int avi_write_data(avi_t *AVI, char *data, unsigned long length, int audio, int keyframe) +{ + int n; + + unsigned char astr[5]; + + /* Check for maximum file length */ + + if ( (AVI->pos + 8 + length + 8 + (AVI->n_idx+1)*16) > AVI_MAX_LEN ) { + AVI_errno = AVI_ERR_SIZELIM; + return -1; + } + + /* Add index entry */ + + //set tag for current audio track + sprintf((char *)astr, "0%1dwb", AVI->aptr+1); + + if(audio) + n = avi_add_index_entry(AVI,astr,0x00,AVI->pos,length); + else + n = avi_add_index_entry(AVI,(unsigned char *) "00db",((keyframe)?0x10:0x0),AVI->pos,length); + + if(n) return -1; + + /* Output tag and data */ + + if(audio) + n = avi_add_chunk(AVI,(unsigned char *) astr, (unsigned char *)data,length); + else + n = avi_add_chunk(AVI,(unsigned char *)"00db",(unsigned char *)data,length); + + if (n) return -1; + + return 0; +} + +int AVI_write_frame(avi_t *AVI, char *data, long bytes, int keyframe) +{ + unsigned long pos; + + if(AVI->mode==AVI_MODE_READ) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + pos = AVI->pos; + + if(avi_write_data(AVI,data,bytes,0,keyframe)) return -1; + + AVI->last_pos = pos; + AVI->last_len = bytes; + AVI->video_frames++; + return 0; +} + +int AVI_dup_frame(avi_t *AVI) +{ + if(AVI->mode==AVI_MODE_READ) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + if(AVI->last_pos==0) return 0; /* No previous real frame */ + if(avi_add_index_entry(AVI,(unsigned char *)"00db",0x10,AVI->last_pos,AVI->last_len)) return -1; + AVI->video_frames++; + AVI->must_use_index = 1; + return 0; +} + +int AVI_write_audio(avi_t *AVI, char *data, long bytes) +{ + if(AVI->mode==AVI_MODE_READ) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + if( avi_write_data(AVI,data,bytes,1,0) ) return -1; + AVI->track[AVI->aptr].audio_bytes += bytes; + return 0; +} + + +int AVI_append_audio(avi_t *AVI, char *data, long bytes) +{ + + long i, length, pos; + unsigned char c[4]; + + if(AVI->mode==AVI_MODE_READ) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + // update last index entry: + + --AVI->n_idx; + length = str2ulong(AVI->idx[AVI->n_idx]+12); + pos = str2ulong(AVI->idx[AVI->n_idx]+8); + + //update; + long2str(AVI->idx[AVI->n_idx]+12,length+bytes); + + ++AVI->n_idx; + + AVI->track[AVI->aptr].audio_bytes += bytes; + + //update chunk header + lseek(AVI->fdes, pos+4, SEEK_SET); + long2str(c, length+bytes); + avi_write(AVI->fdes,(char *) c, 4); + + lseek(AVI->fdes, pos+8+length, SEEK_SET); + + i=PAD_EVEN(length + bytes); + + bytes = i - length; + avi_write(AVI->fdes, data, bytes); + AVI->pos = pos + 8 + i; + + return 0; +} + + +long AVI_bytes_remain(avi_t *AVI) +{ + if(AVI->mode==AVI_MODE_READ) return 0; + + return ( AVI_MAX_LEN - (AVI->pos + 8 + 16*AVI->n_idx)); +} + +long AVI_bytes_written(avi_t *AVI) +{ + if(AVI->mode==AVI_MODE_READ) return 0; + + return (AVI->pos + 8 + 16*AVI->n_idx); +} + +int AVI_set_audio_track(avi_t *AVI, int track) +{ + + if(track < 0 || track + 1 > AVI->anum) return(-1); + + //this info is not written to file anyway + AVI->aptr=track; + return 0; +} + +int AVI_get_audio_track(avi_t *AVI) +{ + return(AVI->aptr); +} + + +/******************************************************************* + * * + * Utilities for reading video and audio from an AVI File * + * * + *******************************************************************/ + +int AVI_close(avi_t *AVI) +{ + int ret; + + /* If the file was open for writing, the header and index still have + to be written */ + + if(AVI->mode == AVI_MODE_WRITE) + ret = avi_close_output_file(AVI); + else + ret = 0; + + /* Even if there happened an error, we first clean up */ + + close(AVI->fdes); + if(AVI->idx) free(AVI->idx); + if(AVI->video_index) free(AVI->video_index); + //FIXME + //if(AVI->audio_index) free(AVI->audio_index); + free(AVI); + + return ret; +} + + +#define ERR_EXIT(x) \ +{ \ + AVI_close(AVI); \ + AVI_errno = x; \ + return 0; \ +} + +avi_t *AVI_open_input_file(char *filename, int getIndex) +{ + avi_t *AVI=NULL; + + /* Create avi_t structure */ + + AVI = (avi_t *) malloc(sizeof(avi_t)); + if(AVI==NULL) + { + AVI_errno = AVI_ERR_NO_MEM; + return 0; + } + memset((void *)AVI,0,sizeof(avi_t)); + + AVI->mode = AVI_MODE_READ; /* open for reading */ + + /* Open the file */ + + AVI->fdes = open(filename,O_RDONLY|O_BINARY); + if(AVI->fdes < 0) + { + AVI_errno = AVI_ERR_OPEN; + free(AVI); + return 0; + } + + avi_parse_input_file(AVI, getIndex); + + AVI->aptr=0; //reset + + return AVI; +} + +avi_t *AVI_open_fd(int fd, int getIndex) +{ + avi_t *AVI=NULL; + + /* Create avi_t structure */ + + AVI = (avi_t *) malloc(sizeof(avi_t)); + if(AVI==NULL) + { + AVI_errno = AVI_ERR_NO_MEM; + return 0; + } + memset((void *)AVI,0,sizeof(avi_t)); + + AVI->mode = AVI_MODE_READ; /* open for reading */ + + // file alread open + AVI->fdes = fd; + + avi_parse_input_file(AVI, getIndex); + + AVI->aptr=0; //reset + + return AVI; +} + +int avi_parse_input_file(avi_t *AVI, int getIndex) +{ + long i, n, rate, scale, idx_type; + unsigned char *hdrl_data; + long header_offset=0, hdrl_len=0; + long nvi, nai[AVI_MAX_TRACKS], ioff; + long tot[AVI_MAX_TRACKS]; + int j; + int lasttag = 0; + int vids_strh_seen = 0; + int vids_strf_seen = 0; + int auds_strh_seen = 0; + // int auds_strf_seen = 0; + int num_stream = 0; + char data[256]; + + /* Read first 12 bytes and check that this is an AVI file */ + + if( avi_read(AVI->fdes,data,12) != 12 ) ERR_EXIT(AVI_ERR_READ) + + if( strncasecmp(data ,"RIFF",4) !=0 || + strncasecmp(data+8,"AVI ",4) !=0 ) ERR_EXIT(AVI_ERR_NO_AVI) + + /* Go through the AVI file and extract the header list, + the start position of the 'movi' list and an optionally + present idx1 tag */ + + hdrl_data = 0; + + while(1) + { + if( avi_read(AVI->fdes,data,8) != 8 ) break; /* We assume it's EOF */ + + n = str2ulong((unsigned char *) data+4); + n = PAD_EVEN(n); + + if(strncasecmp(data,"LIST",4) == 0) + { + if( avi_read(AVI->fdes,data,4) != 4 ) ERR_EXIT(AVI_ERR_READ) + n -= 4; + if(strncasecmp(data,"hdrl",4) == 0) + { + hdrl_len = n; + hdrl_data = (unsigned char *) malloc(n); + if(hdrl_data==0) ERR_EXIT(AVI_ERR_NO_MEM); + + // offset of header + + header_offset = lseek(AVI->fdes,0,SEEK_CUR); + + if( avi_read(AVI->fdes,(char *)hdrl_data,n) != n ) ERR_EXIT(AVI_ERR_READ) + } + else if(strncasecmp(data,"movi",4) == 0) + { + AVI->movi_start = lseek(AVI->fdes,0,SEEK_CUR); + lseek(AVI->fdes,n,SEEK_CUR); + } + else + lseek(AVI->fdes,n,SEEK_CUR); + } + else if(strncasecmp(data,"idx1",4) == 0) + { + /* n must be a multiple of 16, but the reading does not + break if this is not the case */ + + AVI->n_idx = AVI->max_idx = n/16; + AVI->idx = (unsigned char((*)[16]) ) malloc(n); + if(AVI->idx==0) ERR_EXIT(AVI_ERR_NO_MEM) + if(avi_read(AVI->fdes, (char *) AVI->idx, n) != n ) ERR_EXIT(AVI_ERR_READ) + } + else + lseek(AVI->fdes,n,SEEK_CUR); + } + + if(!hdrl_data ) ERR_EXIT(AVI_ERR_NO_HDRL) + if(!AVI->movi_start) ERR_EXIT(AVI_ERR_NO_MOVI) + + /* Interpret the header list */ + + for(i=0;icompressor,hdrl_data+i+4,4); + AVI->compressor[4] = 0; + + // ThOe + AVI->v_codech_off = header_offset + i+4; + + scale = str2ulong((unsigned char *)hdrl_data+i+20); + rate = str2ulong(hdrl_data+i+24); + if(scale!=0) AVI->fps = (double)rate/(double)scale; + AVI->video_frames = str2ulong(hdrl_data+i+32); + AVI->video_strn = num_stream; + AVI->max_len = 0; + vids_strh_seen = 1; + lasttag = 1; /* vids */ + } + else if (strncasecmp ((char *) hdrl_data+i,"auds",4) ==0 && ! auds_strh_seen) + { + + //inc audio tracks + AVI->aptr=AVI->anum; + ++AVI->anum; + + if(AVI->anum > AVI_MAX_TRACKS) { + fprintf(stderr, "error - only %d audio tracks supported\n", AVI_MAX_TRACKS); + return(-1); + } + + AVI->track[AVI->aptr].audio_bytes = str2ulong(hdrl_data+i+32)*avi_sampsize(AVI, 0); + AVI->track[AVI->aptr].audio_strn = num_stream; + // auds_strh_seen = 1; + lasttag = 2; /* auds */ + + // ThOe + AVI->track[AVI->aptr].a_codech_off = header_offset + i; + + } + else + lasttag = 0; + num_stream++; + } + else if(strncasecmp((char *) hdrl_data+i,"strf",4)==0) + { + i += 8; + if(lasttag == 1) + { + AVI->width = str2ulong(hdrl_data+i+4); + AVI->height = str2ulong(hdrl_data+i+8); + vids_strf_seen = 1; + //ThOe + AVI->v_codecf_off = header_offset + i+16; + + memcpy(AVI->compressor2, hdrl_data+i+16, 4); + AVI->compressor2[4] = 0; + + } + else if(lasttag == 2) + { + AVI->track[AVI->aptr].a_fmt = str2ushort(hdrl_data+i ); + + //ThOe + AVI->track[AVI->aptr].a_codecf_off = header_offset + i; + + AVI->track[AVI->aptr].a_chans = str2ushort(hdrl_data+i+2); + AVI->track[AVI->aptr].a_rate = str2ulong (hdrl_data+i+4); + //ThOe: read mp3bitrate + AVI->track[AVI->aptr].mp3rate = 8*str2ulong(hdrl_data+i+8)/1000; + //:ThOe + AVI->track[AVI->aptr].a_bits = str2ushort(hdrl_data+i+14); + // auds_strf_seen = 1; + } + lasttag = 0; + } + else + { + i += 8; + lasttag = 0; + } + + i += n; + } + + free(hdrl_data); + + if(!vids_strh_seen || !vids_strf_seen) ERR_EXIT(AVI_ERR_NO_VIDS) + + AVI->video_tag[0] = AVI->video_strn/10 + '0'; + AVI->video_tag[1] = AVI->video_strn%10 + '0'; + AVI->video_tag[2] = 'd'; + AVI->video_tag[3] = 'b'; + + /* Audio tag is set to "99wb" if no audio present */ + if(!AVI->track[0].a_chans) AVI->track[0].audio_strn = 99; + + for(j=0; janum; ++j) { + AVI->track[j].audio_tag[0] = (j+1)/10 + '0'; + AVI->track[j].audio_tag[1] = (j+1)%10 + '0'; + AVI->track[j].audio_tag[2] = 'w'; + AVI->track[j].audio_tag[3] = 'b'; + } + + lseek(AVI->fdes,AVI->movi_start,SEEK_SET); + + /* get index if wanted */ + + if(!getIndex) return(0); + + /* if the file has an idx1, check if this is relative + to the start of the file or to the start of the movi list */ + + idx_type = 0; + + if(AVI->idx) + { + long pos, len; + + /* Search the first videoframe in the idx1 and look where + it is in the file */ + + for(i=0;in_idx;i++) + if( strncasecmp((char *) AVI->idx[i],(char *) AVI->video_tag,3)==0 ) break; + if(i>=AVI->n_idx) ERR_EXIT(AVI_ERR_NO_VIDS) + + pos = str2ulong(AVI->idx[i]+ 8); + len = str2ulong(AVI->idx[i]+12); + + lseek(AVI->fdes,pos,SEEK_SET); + if(avi_read(AVI->fdes,data,8)!=8) ERR_EXIT(AVI_ERR_READ) + if( strncasecmp((char *)data,(char *)AVI->idx[i],4)==0 && + str2ulong((unsigned char *)data+4)==len ) + { + idx_type = 1; /* Index from start of file */ + } + else + { + lseek(AVI->fdes,pos+AVI->movi_start-4,SEEK_SET); + if(avi_read(AVI->fdes,data,8)!=8) ERR_EXIT(AVI_ERR_READ) + if( strncasecmp((char *)data,(char *)AVI->idx[i],4)==0 && str2ulong((unsigned char *)data+4)==len ) + { + idx_type = 2; /* Index from start of movi list */ + } + } + /* idx_type remains 0 if neither of the two tests above succeeds */ + } + + if(idx_type == 0) + { + /* we must search through the file to get the index */ + + lseek(AVI->fdes, AVI->movi_start, SEEK_SET); + + AVI->n_idx = 0; + + while(1) + { + if( avi_read(AVI->fdes,data,8) != 8 ) break; + n = str2ulong((unsigned char *)data+4); + + /* The movi list may contain sub-lists, ignore them */ + + if(strncasecmp(data,"LIST",4)==0) + { + lseek(AVI->fdes,4,SEEK_CUR); + continue; + } + + /* Check if we got a tag ##db, ##dc or ##wb */ + + if( ( (data[2]=='d' || data[2]=='D') && + (data[3]=='b' || data[3]=='B' || data[3]=='c' || data[3]=='C') ) + || ( (data[2]=='w' || data[2]=='W') && + (data[3]=='b' || data[3]=='B') ) ) + { + avi_add_index_entry(AVI,(unsigned char *) data,0,lseek(AVI->fdes,0,SEEK_CUR)-8,n); + } + + lseek(AVI->fdes,PAD_EVEN(n),SEEK_CUR); + } + idx_type = 1; + } + + /* Now generate the video index and audio index arrays */ + + nvi = 0; + for(j=0; janum; ++j) nai[j] = 0; + + for(i=0;in_idx;i++) { + + if(strncasecmp((char *)AVI->idx[i],(char *) AVI->video_tag,3) == 0) nvi++; + + for(j=0; janum; ++j) if(strncasecmp((char *)AVI->idx[i], AVI->track[j].audio_tag,4) == 0) nai[j]++; + } + + AVI->video_frames = nvi; + for(j=0; janum; ++j) AVI->track[j].audio_chunks = nai[j]; + +// fprintf(stderr, "chunks = %ld %d %s\n", AVI->track[0].audio_chunks, AVI->anum, AVI->track[0].audio_tag); + + if(AVI->video_frames==0) ERR_EXIT(AVI_ERR_NO_VIDS); + AVI->video_index = (video_index_entry *) malloc(nvi*sizeof(video_index_entry)); + if(AVI->video_index==0) ERR_EXIT(AVI_ERR_NO_MEM); + + for(j=0; janum; ++j) { + if(AVI->track[j].audio_chunks) { + AVI->track[j].audio_index = (audio_index_entry *) malloc(nai[j]*sizeof(audio_index_entry)); + if(AVI->track[j].audio_index==0) ERR_EXIT(AVI_ERR_NO_MEM); + } + } + + nvi = 0; + for(j=0; janum; ++j) nai[j] = tot[j] = 0; + + ioff = idx_type == 1 ? 8 : AVI->movi_start+4; + + for(i=0;in_idx;i++) { + + //video + if(strncasecmp((char *)AVI->idx[i],(char *)AVI->video_tag,3) == 0) { + AVI->video_index[nvi].key = str2ulong(AVI->idx[i]+ 4); + AVI->video_index[nvi].pos = str2ulong(AVI->idx[i]+ 8)+ioff; + AVI->video_index[nvi].len = str2ulong(AVI->idx[i]+12); + nvi++; + } + + //audio + for(j=0; janum; ++j) { + + if(strncasecmp((char *)AVI->idx[i],AVI->track[j].audio_tag,4) == 0) { + AVI->track[j].audio_index[nai[j]].pos = str2ulong(AVI->idx[i]+ 8)+ioff; + AVI->track[j].audio_index[nai[j]].len = str2ulong(AVI->idx[i]+12); + AVI->track[j].audio_index[nai[j]].tot = tot[j]; + tot[j] += AVI->track[j].audio_index[nai[j]].len; + nai[j]++; + } + } + } + + + for(j=0; janum; ++j) AVI->track[j].audio_bytes = tot[j]; + + /* Reposition the file */ + + lseek(AVI->fdes,AVI->movi_start,SEEK_SET); + AVI->video_pos = 0; + + return(0); +} + +long AVI_video_frames(avi_t *AVI) +{ + return AVI->video_frames; +} +int AVI_video_width(avi_t *AVI) +{ + return AVI->width; +} +int AVI_video_height(avi_t *AVI) +{ + return AVI->height; +} +double AVI_frame_rate(avi_t *AVI) +{ + return AVI->fps; +} +char* AVI_video_compressor(avi_t *AVI) +{ + return AVI->compressor2; +} + +long AVI_max_video_chunk(avi_t *AVI) +{ + return AVI->max_len; +} + +int AVI_audio_tracks(avi_t *AVI) +{ + return(AVI->anum); +} + +int AVI_audio_channels(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_chans; +} + +long AVI_audio_mp3rate(avi_t *AVI) +{ + return AVI->track[AVI->aptr].mp3rate; +} + +int AVI_audio_bits(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_bits; +} + +int AVI_audio_format(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_fmt; +} + +long AVI_audio_rate(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_rate; +} + +long AVI_audio_bytes(avi_t *AVI) +{ + return AVI->track[AVI->aptr].audio_bytes; +} + +long AVI_audio_chunks(avi_t *AVI) +{ + return AVI->track[AVI->aptr].audio_chunks; +} + +long AVI_audio_codech_offset(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_codech_off; +} + +long AVI_audio_codecf_offset(avi_t *AVI) +{ + return AVI->track[AVI->aptr].a_codecf_off; +} + +long AVI_video_codech_offset(avi_t *AVI) +{ + return AVI->v_codech_off; +} + +long AVI_video_codecf_offset(avi_t *AVI) +{ + return AVI->v_codecf_off; +} + +long AVI_frame_size(avi_t *AVI, long frame) +{ + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->video_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if(frame < 0 || frame >= AVI->video_frames) return 0; + return(AVI->video_index[frame].len); +} + +long AVI_audio_size(avi_t *AVI, long frame) +{ + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->track[AVI->aptr].audio_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if(frame < 0 || frame >= AVI->track[AVI->aptr].audio_chunks) return 0; + return(AVI->track[AVI->aptr].audio_index[frame].len); +} + +long AVI_get_video_position(avi_t *AVI, long frame) +{ + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->video_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if(frame < 0 || frame >= AVI->video_frames) return 0; + return(AVI->video_index[frame].pos); +} + + +int AVI_seek_start(avi_t *AVI) +{ + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + lseek(AVI->fdes,AVI->movi_start,SEEK_SET); + AVI->video_pos = 0; + return 0; +} + +int AVI_set_video_position(avi_t *AVI, long frame) +{ + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->video_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if (frame < 0 ) frame = 0; + AVI->video_pos = frame; + return 0; +} + +int AVI_set_audio_bitrate(avi_t *AVI, long bitrate) +{ + if(AVI->mode==AVI_MODE_READ) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + + AVI->track[AVI->aptr].mp3rate = bitrate; + return 0; +} + + +long AVI_read_frame(avi_t *AVI, char *vidbuf, int *keyframe) +{ + long n; + + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->video_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if(AVI->video_pos < 0 || AVI->video_pos >= AVI->video_frames) return -1; + n = AVI->video_index[AVI->video_pos].len; + + *keyframe = (AVI->video_index[AVI->video_pos].key==0x10) ? 1:0; + + lseek(AVI->fdes, AVI->video_index[AVI->video_pos].pos, SEEK_SET); + + if (avi_read(AVI->fdes,vidbuf,n) != n) + { + AVI_errno = AVI_ERR_READ; + return -1; + } + + AVI->video_pos++; + + return n; +} + +int AVI_set_audio_position(avi_t *AVI, long byte) +{ + long n0, n1, n; + + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->track[AVI->aptr].audio_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + if(byte < 0) byte = 0; + + /* Binary search in the audio chunks */ + + n0 = 0; + n1 = AVI->track[AVI->aptr].audio_chunks; + + while(n0track[AVI->aptr].audio_index[n].tot>byte) + n1 = n; + else + n0 = n; + } + + AVI->track[AVI->aptr].audio_posc = n0; + AVI->track[AVI->aptr].audio_posb = byte - AVI->track[AVI->aptr].audio_index[n0].tot; + + return 0; +} + +long AVI_read_audio(avi_t *AVI, char *audbuf, long bytes) +{ + long nr, pos, left, todo; + + if(AVI->mode==AVI_MODE_WRITE) { AVI_errno = AVI_ERR_NOT_PERM; return -1; } + if(!AVI->track[AVI->aptr].audio_index) { AVI_errno = AVI_ERR_NO_IDX; return -1; } + + nr = 0; /* total number of bytes read */ + + while(bytes>0) + { + left = AVI->track[AVI->aptr].audio_index[AVI->track[AVI->aptr].audio_posc].len - AVI->track[AVI->aptr].audio_posb; + if(left==0) + { + if(AVI->track[AVI->aptr].audio_posc>=AVI->track[AVI->aptr].audio_chunks-1) return nr; + AVI->track[AVI->aptr].audio_posc++; + AVI->track[AVI->aptr].audio_posb = 0; + continue; + } + if(bytestrack[AVI->aptr].audio_index[AVI->track[AVI->aptr].audio_posc].pos + AVI->track[AVI->aptr].audio_posb; + lseek(AVI->fdes, pos, SEEK_SET); + if (avi_read(AVI->fdes,audbuf+nr,todo) != todo) + { + AVI_errno = AVI_ERR_READ; + return -1; + } + bytes -= todo; + nr += todo; + AVI->track[AVI->aptr].audio_posb += todo; + } + + return nr; +} + +/* AVI_read_data: Special routine for reading the next audio or video chunk + without having an index of the file. */ + +int AVI_read_data(avi_t *AVI, char *vidbuf, long max_vidbuf, + char *audbuf, long max_audbuf, + long *len) +{ + +/* + * Return codes: + * + * 1 = video data read + * 2 = audio data read + * 0 = reached EOF + * -1 = video buffer too small + * -2 = audio buffer too small + */ + + int n; + char data[8]; + + if(AVI->mode==AVI_MODE_WRITE) return 0; + + while(1) + { + /* Read tag and length */ + + if( avi_read(AVI->fdes,data,8) != 8 ) return 0; + + /* if we got a list tag, ignore it */ + + if(strncasecmp(data,"LIST",4) == 0) + { + lseek(AVI->fdes,4,SEEK_CUR); + continue; + } + + n = PAD_EVEN(str2ulong((unsigned char *)data+4)); + + if(strncasecmp(data,AVI->video_tag,3) == 0) + { + *len = n; + AVI->video_pos++; + if(n>max_vidbuf) + { + lseek(AVI->fdes,n,SEEK_CUR); + return -1; + } + if(avi_read(AVI->fdes,vidbuf,n) != n ) return 0; + return 1; + } + else if(strncasecmp(data,AVI->track[AVI->aptr].audio_tag,4) == 0) + { + *len = n; + if(n>max_audbuf) + { + lseek(AVI->fdes,n,SEEK_CUR); + return -2; + } + if(avi_read(AVI->fdes,audbuf,n) != n ) return 0; + return 2; + break; + } + else + if(lseek(AVI->fdes,n,SEEK_CUR)<0) return 0; + } +} + +/* AVI_print_error: Print most recent error (similar to perror) */ + +char *(avi_errors[]) = +{ + /* 0 */ "avilib - No Error", + /* 1 */ "avilib - AVI file size limit reached", + /* 2 */ "avilib - Error opening AVI file", + /* 3 */ "avilib - Error reading from AVI file", + /* 4 */ "avilib - Error writing to AVI file", + /* 5 */ "avilib - Error writing index (file may still be useable)", + /* 6 */ "avilib - Error closing AVI file", + /* 7 */ "avilib - Operation (read/write) not permitted", + /* 8 */ "avilib - Out of memory (malloc failed)", + /* 9 */ "avilib - Not an AVI file", + /* 10 */ "avilib - AVI file has no header list (corrupted?)", + /* 11 */ "avilib - AVI file has no MOVI list (corrupted?)", + /* 12 */ "avilib - AVI file has no video data", + /* 13 */ "avilib - operation needs an index", + /* 14 */ "avilib - Unkown Error" +}; +static int num_avi_errors = sizeof(avi_errors)/sizeof(char*); + +static char error_string[4096]; + +void AVI_print_error(char *str) +{ + int aerrno; + + aerrno = (AVI_errno>=0 && AVI_errno=0 && AVI_errno + * + * This file is part of transcode, a linux video stream processing tool + * + * transcode is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2, or (at your option) + * any later version. + * + * transcode is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with GNU Make; see the file COPYING. If not, write to + * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#ifndef AVILIB_H +#define AVILIB_H + +#define AVI_MAX_TRACKS 8 + +typedef struct +{ + unsigned long key; + unsigned long pos; + unsigned long len; +} video_index_entry; + +typedef struct +{ + unsigned long pos; + unsigned long len; + unsigned long tot; +} audio_index_entry; + +typedef struct track_s +{ + + long a_fmt; /* Audio format, see #defines below */ + long a_chans; /* Audio channels, 0 for no audio */ + long a_rate; /* Rate in Hz */ + long a_bits; /* bits per audio sample */ + long mp3rate; /* mp3 bitrate kbs*/ + + long audio_strn; /* Audio stream number */ + long audio_bytes; /* Total number of bytes of audio data */ + long audio_chunks; /* Chunks of audio data in the file */ + + char audio_tag[4]; /* Tag of audio data */ + long audio_posc; /* Audio position: chunk */ + long audio_posb; /* Audio position: byte within chunk */ + + long a_codech_off; /* absolut offset of audio codec information */ + long a_codecf_off; /* absolut offset of audio codec information */ + + audio_index_entry *audio_index; + +} track_t; + +typedef struct +{ + + long fdes; /* File descriptor of AVI file */ + long mode; /* 0 for reading, 1 for writing */ + + long width; /* Width of a video frame */ + long height; /* Height of a video frame */ + double fps; /* Frames per second */ + char compressor[8]; /* Type of compressor, 4 bytes + padding for 0 byte */ + char compressor2[8]; /* Type of compressor, 4 bytes + padding for 0 byte */ + long video_strn; /* Video stream number */ + long video_frames; /* Number of video frames */ + char video_tag[4]; /* Tag of video data */ + long video_pos; /* Number of next frame to be read + (if index present) */ + + unsigned long max_len; /* maximum video chunk present */ + + track_t track[AVI_MAX_TRACKS]; // up to AVI_MAX_TRACKS audio tracks supported + + unsigned long pos; /* position in file */ + long n_idx; /* number of index entries actually filled */ + long max_idx; /* number of index entries actually allocated */ + + long v_codech_off; /* absolut offset of video codec (strh) info */ + long v_codecf_off; /* absolut offset of video codec (strf) info */ + + unsigned char (*idx)[16]; /* index entries (AVI idx1 tag) */ + video_index_entry *video_index; + + unsigned long last_pos; /* Position of last frame written */ + unsigned long last_len; /* Length of last frame written */ + int must_use_index; /* Flag if frames are duplicated */ + unsigned long movi_start; + + int anum; // total number of audio tracks + int aptr; // current audio working track + +} avi_t; + +#define AVI_MODE_WRITE 0 +#define AVI_MODE_READ 1 + +/* The error codes delivered by avi_open_input_file */ + +#define AVI_ERR_SIZELIM 1 /* The write of the data would exceed + the maximum size of the AVI file. + This is more a warning than an error + since the file may be closed safely */ + +#define AVI_ERR_OPEN 2 /* Error opening the AVI file - wrong path + name or file nor readable/writable */ + +#define AVI_ERR_READ 3 /* Error reading from AVI File */ + +#define AVI_ERR_WRITE 4 /* Error writing to AVI File, + disk full ??? */ + +#define AVI_ERR_WRITE_INDEX 5 /* Could not write index to AVI file + during close, file may still be + usable */ + +#define AVI_ERR_CLOSE 6 /* Could not write header to AVI file + or not truncate the file during close, + file is most probably corrupted */ + +#define AVI_ERR_NOT_PERM 7 /* Operation not permitted: + trying to read from a file open + for writing or vice versa */ + +#define AVI_ERR_NO_MEM 8 /* malloc failed */ + +#define AVI_ERR_NO_AVI 9 /* Not an AVI file */ + +#define AVI_ERR_NO_HDRL 10 /* AVI file has no has no header list, + corrupted ??? */ + +#define AVI_ERR_NO_MOVI 11 /* AVI file has no has no MOVI list, + corrupted ??? */ + +#define AVI_ERR_NO_VIDS 12 /* AVI file contains no video data */ + +#define AVI_ERR_NO_IDX 13 /* The file has been opened with + getIndex==0, but an operation has been + performed that needs an index */ + +/* Possible Audio formats */ + +#ifndef WAVE_FORMAT_PCM +#define WAVE_FORMAT_UNKNOWN (0x0000) +#define WAVE_FORMAT_PCM (0x0001) +#define WAVE_FORMAT_ADPCM (0x0002) +#define WAVE_FORMAT_IBM_CVSD (0x0005) +#define WAVE_FORMAT_ALAW (0x0006) +#define WAVE_FORMAT_MULAW (0x0007) +#define WAVE_FORMAT_OKI_ADPCM (0x0010) +#define WAVE_FORMAT_DVI_ADPCM (0x0011) +#define WAVE_FORMAT_DIGISTD (0x0015) +#define WAVE_FORMAT_DIGIFIX (0x0016) +#define WAVE_FORMAT_YAMAHA_ADPCM (0x0020) +#define WAVE_FORMAT_DSP_TRUESPEECH (0x0022) +#define WAVE_FORMAT_GSM610 (0x0031) +#define IBM_FORMAT_MULAW (0x0101) +#define IBM_FORMAT_ALAW (0x0102) +#define IBM_FORMAT_ADPCM (0x0103) +#endif + +avi_t* AVI_open_output_file(char * filename); +void AVI_set_video(avi_t *AVI, int width, int height, double fps, char *compressor); +void AVI_set_audio(avi_t *AVI, int channels, long rate, int bits, int format, long mp3rate); +int AVI_write_frame(avi_t *AVI, char *data, long bytes, int keyframe); +int AVI_dup_frame(avi_t *AVI); +int AVI_write_audio(avi_t *AVI, char *data, long bytes); +int AVI_append_audio(avi_t *AVI, char *data, long bytes); +long AVI_bytes_remain(avi_t *AVI); +int AVI_close(avi_t *AVI); +long AVI_bytes_written(avi_t *AVI); + +avi_t *AVI_open_input_file(char *filename, int getIndex); +avi_t *AVI_open_fd(int fd, int getIndex); +int avi_parse_input_file(avi_t *AVI, int getIndex); +long AVI_audio_mp3rate(avi_t *AVI); +long AVI_video_frames(avi_t *AVI); +int AVI_video_width(avi_t *AVI); +int AVI_video_height(avi_t *AVI); +double AVI_frame_rate(avi_t *AVI); +char* AVI_video_compressor(avi_t *AVI); + +int AVI_audio_channels(avi_t *AVI); +int AVI_audio_bits(avi_t *AVI); +int AVI_audio_format(avi_t *AVI); +long AVI_audio_rate(avi_t *AVI); +long AVI_audio_bytes(avi_t *AVI); +long AVI_audio_chunks(avi_t *AVI); + +long AVI_max_video_chunk(avi_t *AVI); + +long AVI_frame_size(avi_t *AVI, long frame); +long AVI_audio_size(avi_t *AVI, long frame); +int AVI_seek_start(avi_t *AVI); +int AVI_set_video_position(avi_t *AVI, long frame); +long AVI_get_video_position(avi_t *AVI, long frame); +long AVI_read_frame(avi_t *AVI, char *vidbuf, int *keyframe); + +int AVI_set_audio_position(avi_t *AVI, long byte); +int AVI_set_audio_bitrate(avi_t *AVI, long bitrate); + +long AVI_read_audio(avi_t *AVI, char *audbuf, long bytes); + +long AVI_audio_codech_offset(avi_t *AVI); +long AVI_audio_codecf_offset(avi_t *AVI); +long AVI_video_codech_offset(avi_t *AVI); +long AVI_video_codecf_offset(avi_t *AVI); + +int AVI_read_data(avi_t *AVI, char *vidbuf, long max_vidbuf, + char *audbuf, long max_audbuf, + long *len); + +void AVI_print_error(char *str); +char *AVI_strerror(); +char *AVI_syserror(); + +int AVI_scan(char *name); +int AVI_dump(char *name, int mode); + +char *AVI_codec2str(short cc); +int AVI_file_check(char *import_file); + +void AVI_info(avi_t *avifile); +uint64_t AVI_max_size(); +int avi_update_header(avi_t *AVI); + +int AVI_set_audio_track(avi_t *AVI, int track); +int AVI_get_audio_track(avi_t *AVI); +int AVI_audio_tracks(avi_t *AVI); + + +struct riff_struct +{ + unsigned char id[4]; /* RIFF */ + unsigned long len; + unsigned char wave_id[4]; /* WAVE */ +}; + + +struct chunk_struct +{ + unsigned char id[4]; + unsigned long len; +}; + +struct common_struct +{ + unsigned short wFormatTag; + unsigned short wChannels; + unsigned long dwSamplesPerSec; + unsigned long dwAvgBytesPerSec; + unsigned short wBlockAlign; + unsigned short wBitsPerSample; /* Only for PCM */ +}; + +struct wave_header +{ + struct riff_struct riff; + struct chunk_struct format; + struct common_struct common; + struct chunk_struct data; +}; + + + +struct AVIStreamHeader { + long fccType; + long fccHandler; + long dwFlags; + long dwPriority; + long dwInitialFrames; + long dwScale; + long dwRate; + long dwStart; + long dwLength; + long dwSuggestedBufferSize; + long dwQuality; + long dwSampleSize; +}; + +#endif diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/outfile.vp3 b/libs/libtheora-1.1/win32/experimental/transcoder/avi2vp3/outfile.vp3 new file mode 100644 index 0000000000000000000000000000000000000000..ed74aa99cec181f27f347d4182f56f868105e460 GIT binary patch literal 233132 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

UGE-8B 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�Xtie#FL%6cy8Q7Xg=#g=cr$Iah#jr+0!g) z?r(LTB3M+Fou!Uto*NW6TJ#fkCC?H}yyggsKpb3-XXn;fC87RAvwSWP2XC93wb|pI z9;^W{H!mJJc}mBU*HIrGRYSvMHmK(4(~X+X-zwwF;uJkZtMBr_KI&*~UJ*N2Z-bN& zraj#Lo0sQ^`*+I>`Fp>EcDGOPptE)rnXjIRYSkXbcv#z&gC9My+lZ!c3UNC4bVv9+ z=0!?N|LBa-BlJN{dk8#j>?z_p=2%;NXsy(vB1I|BJ^LVmFoWl&=&mTJjz8$1!l!_Y zy-o8;qDpo47wE#OP>oc$VY3|Anv+V=`KsdnHGv_fY)vAzG3cp$1<7j;m=KoCqu*Xe zlDMX)XcKKKDJIdO%9x52p~_p*<7-=}jKQJNo=hVmQ@dFX=G+B1+~NqA8j#Tyt0o-2m*@n)Ov4P zprXu|NTwrScco-^F?(pX{3#vJANP!>Dkl&jpRKh}ekk40c1K8H6T+|trt!>d)1wXo z19aZ6Y|-ejrq!-(eabt%@4ptgldV-D6{#w2pSg(*bD1#>&lcr@w~n_~soIf|MjGv^ z+YLb}h}h9jOtTSmx>pL1ayl*aF7?rk9fnVcA=Y=MaKsGUVD&oR z!fP6oVAMR;Sl<21yNARka(j#%<9YjB3PoJnK^1fXpSVAm?pSkIg@OBWj7!yZzsnRh z_0JL~y4%!@`jT~H)Stq``7|>b>zS$~ZT{XLwjC}T5tq3Ys;Wf2|K%vx|L$y(=AE~h z)+cCdCYeCiG$4c^0IBzEdM1T`XJD7;&oL;J5p*7?5dbL-L=Ie*IPs3yYbqQJkPq%7 z>v=zS>}e3l#=WH4WaFgLw%u8QkL(B#a&chxwb6uRncQL@xO_k1sTAT-NSUi6CIvs3 ztuf_eq`c8ctLiOx5mwG+_H7`ym#;*`X|sWG74T5>G*NMzUK_d25U7r))HFs}O8;yr z(7AkivNX(Z7u2+?DObn1``aXQtIpL3Z+A{UI-LY^sxB3=@j9n@k-UWUsn*W%_j%5> zHsmN0yP|5%kAWXLp$740K1ubfrsjR7O{}q~r`wBxKvT^zhcF>Hp{e>4Wny8sbz82^ zoV;`h&I}-sR`iE;^}8%$m)Jvi^)hWn= zF~QWq_ayVjmpq}jM-E!)pg!Ih@S?DFGWyF0>nj&OSS*6p^S9pT_X58cn9T3SuR7grv`>I)Q_!iJ(H9Q?NGhctzka6d(yHfE=`CCqQZl7KA zsqT4CCxRcPI8EAHoX2aU@Goypl}lgOF0gFCZ=#zKw^L`x7&uhEU!BNER7g%Y-)MKeOe{dA&zl=YR3c4T)qwWw`H7`1fRB-7fZkM}q zyc_>vJv_8P=v(3cG|m5U zT(l(L)z#Il7e%&%wkl(9NywSQu}SRq^)4cy#K=wb)R~kk4HV?;73CLk{*Z*w59l2G zMD!XnHkm&yyB>UJ_ow#)^b2qo!RDnk9_88|+mE9{u{Qt!{=Tp5F$Z@aw{>UK=rTTc z=(4*B3z*!!NAYGngro$)?3Uclv_b>g+439Eb8x!2i^1=~JNX`N7lNZk%cmYqpjY?1`j*#s~ z?WD=b3|P8u=xxh7{TW~`X!HYgckU@FdG_|KeD&rlxbOK|9#Ap*o)W{v2|e@Y)tT+Bv-ebPS{2f`Wdb%#U2%qHkx|1N(R^FBjc0u~ znV6fv)GmF$fcMj>`NC1oMNT5Gez0{zIbRFA$h$atIt5?)5jGl!`UiWiX*^5WBPwzKV@WzTg{p)GkI6kJi}6d(@50lo0*W_vI6GA}?i2xN;`Dd5wJxS+Cc^J{WJVKt^%t2~OA7{vI9FNabW91d#E_s5iNa|5%$piZ9y zrHvv6JCsTz(&!hrU|+m-C-}taB)PK#hEDYMOxPOT`j^l9aZ>L6PFSW15gOOm$d+J6v<3Fq z7nX4;q+df!FH$a@Y+H6aZ$}2=UtXRzhw}#PH$xCV^tnJ#sXW#-(gl;)3A?FbQY)hT zDg!n$a08YAzw6D}foHdBTK~^w{e3T~vM%@Ay;;*kvNHhdk*Q$kQO{2v3l&=*AeNp8 zIEsa4SFG3O7?~dhD12DJDRL zDqpndRpSP%jCef|@M4QV=$40Y1AH<4&9D-?0t!_=kNZUvIb6&Y8*;a8a32KKeb1q{C8Mg2*}R#tJ$LH;~#w;{FyvD zv9qfZzfown5x}_lJHYmiTp7Y%S?D|&whj1W&9Vk(k^Bo6W0kU&5tn~SZDKGjUKu)I zKRlJHPwusiP5vaGKJ<3);h8~nq&t8M!>A|EE`R1_ChxGjA$IBP&PRVn3GQ^{hl9vh zzEbbQMx(>7$V#^&Pg3u{qp9``k554Msz$~Si2MOp$1+2n;DeQHvOtx2NxwjSr7lfe zM(C9_AMmH5{2zFmuWt~LN!lwUAaSH*K^tpT1=(d&y9{%)6iGw|x-$u?61zxK)3vR1 zX4n?C*3G_2tg#9dLgPz>w?n1rcdBL%0o9BSJ-J`wa%bVX+6AaIol^z=RI$Qd;2bi{ zln9TcM40Sra;E21-ALA~(`w#TiiahldSBc+5n%QSoq+fT{?2#;K$OtSorYMpspRhU zOVS-A`XVdD@+@CNxFssrA;V2%s(I>ok@|9ny6GCcKoJA|F&+jvqf$Ryt7h_7m0Fv- z0GV}M;d!V8OB1wgSwPXk|0Yb&|Di9?q0xLVY4%M12Ni6^<&Aww|Y@O^h08R!1FVSN}@+@wu_^QAU0uJYZ}=%T0) zjkVoE+sV^h6GC5`b#|iFw6(Y5C6L$2&Pt9-QV9aeYb46|yv1j6I}X{rA7>!J5pnWN zfRQY?>tADF)G;_0Da%F`Rwhj zxYQ0Rv;TS$b@~}!0u-sy3zM@*|7hhF)~^YOUWnj=wjI)5hz)(_>+f)#H$3`o$$fwa z<0BsZ1;q6a)Jj&(P#42BI||%4jHZ!kD%to(&(n+IkIur|ShT>{}d2y2532lg{aSaTRhe3d) zH+if@vzrOtbUj}#hDN+dzMx2b*rc2#K6~@h6UslH3AoWi1CuF>ulFaPZs!EAe*!yC zqMPWW#*=JXw%x%Soy^=x&kokKYgd5v*4(7_tcgOKcN&l}IAjiJtswWXES3hUh=k6% zWR=6Xk=m4k$6}0|b{fEul_zNB%jdq&AsmTO{R5#dgVG^eB+s1)Z%ix1`12IOSESCS zWhBG7yG9VWr=$lDfdSxA!v#fU*7~s_*wCbY=NRW*PU~om(nOD|gC^J^sq=JOJ>Y93ZX#>X8NCNc?VDnS7|X-8Y!w%JI_( z3E^Sm(m{%R&+^4x81?f50Tqe_1?wdU6sT zWPudTzOlhb!}?6~#iXLKk$veq4&qx|5GIw`sVekqSBaNK`6MI*iI~umBnuXFv8OLK z@eAa;ulAXDNXeNYk~^Z)lb{MC&AUMo=IjEe?F8SWKYwfi>R_I{2oLtF)&+koZyV&$T7+9`=Y5Pe#71(cbzgJ4 z)nzX1w!M{AWkm&_5O7*{67*Q0wN<|m60g+NW2tZuy7J;IP$Nd{Kgx^Pj&VSaMV4;kb{qK!M0nE9C=(3Q793f!p0ABrbKP;} zml6whZu51&O?V|j8Bu5>n#X6hW#T5Zwdq_|We4R5&-Xysy4z^q(T#DVk)eh-oGLAN z4R8*Wht^|9^l=lm=5tq3QHl0~#l%JO?ghNnE&JprM#JB=2vIx$Og$1PZRK+n3+;DD%j3%-3zkj^e_gjom*tjaniSX)>>uqY91h!P&vv-GZ*38i zySKs4?eE(0g{GX~)5QuMs(>DBGKf@ivx9<%x4q|#T$mb<1+R!&g)iAbJ41OsB z3hMaE?^~A-!UPLd3ziQq%&ZqgJ^x{Fn-lI@>d7vz+H|e0{nW8d19}XgsI{EF0zu)_ zA>;$wMYl;d&Yw(aUKm7LO>@~Tp%7rEC96`cpdNEBTH@N*j#erg{PmSTYnqEH7yIst zug>UlmhzIv?4}ppS%2{Tla0)~>eFN_DzN338Ag>!L8jl=r>)3nr4n7rAIY3>d|IxR{ zhUDmIbEH8V+8ST=RaiyQ0z;vw7KN9C_Yrl>;w+rhnVN3Y>+zRLr2^zPO@Q6p|v!|OXKNN1k&jHUhOAA_gx}^W|l^KTT+mogV@ zwj;`DYszs^vVUOIQdwYs6;)a_07$;Navn7ln{)iy$OTJL(0Y0>N`T|OxOI8SU~z@q zga+8SI}3VJ3|ezat7-zt@(rX%=d@ay;_MA2A-j%(Nybh8RZ zU5S=>h*E^dA{hy0jjba5BT!WU&?teaZ8^+fHsjW|}-a{Mxo%(`%j`=R@7>Rr#%|jJ6C5{!Hwb;U9v}Ig8NpU1bmI zGYH0ScNeI5rF$meur9Anc}~g9SkK~`!d~4`@pM+=RF+2VXyEl~gJ6p9cJI-UynCDc zf^SP&Ug2BC-QC})0_stI2>V}c)AIlET?bm!{=HlFHw7eu?zWL~rfVXsaq1TjE`5`(9%F<5FrF(G}3;+m#9HF)Z zXOB$HWyw9cYoY14=iYZqCJQPD?SiUhYRid2K#~0e8%l67MFip5;t zO#3D8!xqrwwf;qj#LRHOLQ(l|OwMxk{?wD>qY2aiEN5fw@kiKUJ3X_u;FTSqgoo6{ z&rJ3|xpL8PwFTus7!)BoRGV<^0>&icgJnZ5N!zlnsHjLxb~u}r(c%d<#y zo1F%~+_uJ}3|&GC$zzB@(Z_AQpE&tX?)NLo-*0y9GmTMlz@4ThpHWHEZ-oNG{Q1*y zR9PK_UpT0Hkpk?+HBPVvkElInzj}>p<-OPTDrb@%)DDq!?8A$ZJ8rG6A3_NgSQ;x3 zJt{_BA#Y8S;cH*@E#-`zA#{{ZT~ztb8m|O#k+kzY$TxL~>6)5$o9ARK1l|H@_Vby# zRv?is?}7N%Kc%Tm^Qa=*SKgU@Fb~z3_zND>hC7+!9%nmYZA~*}Lj_{@UVXvnkWT!L z?9|ti9RhCpUeRY}6W&yJ&6patt-Y2gcg)Sp$IjqmL2<78 zNbWuSCU-U?Eofb|4R`H0)8B@^_o{=Cqqbq)ZWm2TKFm$ZmEl)&I|503o{)43Kk(H|yBk9Y}GapizIs_Cra9`+Xw_69oJf1bb!~ zfeDO?jdz1jnI5R5=1lw4=WoI5AH?LzlKXJJ@nq+@s#2~8zw^|4H3J&m1sVxN6w~d^ zM11M^nJ_Z~GdLY>Y9uo88iI^E=AICF$ zXwH?DY1?VKmGOg+%)#sczF?>$Ef@2@=E>rx{Sv@fReHp0B093x3&kLHF>@53z^s0* zEC_H-XOvYXE1#NI@|^74H-)kiuOHE#{6H^4FvR9r{jPB=8&p*48a8(LL{k!UEM#!* zEu-VyOl$hLVvc3x-t^DS`FQyc#%1>Bwk6IC2efDt21s>l36C`1Ozx!C#V^;F>r9kE zCwlpw4G2lL#1%%AtdB$RrDF)yQln?nmBh#!7QdWT5WR|B>ukm2HTGQ8283~M`f@I) z1@bnjW5aWqW(ogRJt_~$m``8G?4iD~%B{w& zU3lJzdXh1OoDEnr+s~n%TzZ2q3UrUSScT&TG7lsdl22DJ(`yk@UafioDtdG|>?SGa zVHj)vyi7*YBobj7$<`l_*qhJ%mnNSkE=%9Sw6>$QhtzAmaEofs|z>kz*&-crLSDo)pP$tFf>Vz+pY26XJ}N8Y@DF!no~ZEwB(G zAPP`mhLZ@=rR@P_(VNqR4F`my#B#K580Yy@bz9N`=jYOM=PA)@Xj+M6fmE6=CrHD* zTlqieU)v2ZCR_IrMIT!Hl^qZ}Gfg{vsYJ-i4fW@;Qq|p@o*hfuspWs?mGv~HG`L4x z)i}dN^ghTc-twfFR6tD8iT`&UX#B5&G7vhs%^A6W#}A&#m5pdkM} z?S?;-|911NFBd;nUXrpA1lu%|`o@h!O^+N3+tKu5T&xyw=NZ&x>vf%w@Q+DGhhkAd z`&q_(y=y~Rlu6|Ob4^^Wk|gPHI+C?sdh@K&cxS0wJOnizs+1*9S)l!4R#3($z8`Mf z7Ep(uxaF_0be*%IIHfDer);jQZ!de4)}{=pXq;II+QUG(!V@}(zV>J;=^zq`q>otM zstiQfN*LO7ak_SXnH<3jGf?X zJqv>%(3-__Ve?mK)!UmHA;Tg(z9!$9Z^H7GtrPyqE5ZC&qI$c(N;vdhI$!W3{_5lP zoUpn+M5`cWh7QrVxce~bLK5pLm)*EGM?7bw%P+Rt1L6D$_2vGv%@|U_$`tg7d}UtM zpJKy2>EEgVbW`be$K%OKR^k#be-3f0mHRROy|!}4xpTa@ekhM8dFKPxt_tA`gT>)` z{M}gJB{40SFvrR@MfpR#&t@E2uk~dt8`6!v$ePjZ)w<7h)JH{CZb$iRPt6K|y*V7` z<#ij-gA6$WVBrpz=G!pY{qiw&VV}8tL)X9;d`|rVl`)Z~(*!V_qYk5b5lgeC556a? z*|HaPfoE!kWN%V^yy?|jm69KSTzAQVB;)_7Kf3npZlGy}qj&x%>6M11sJSLT8CR$#s?-oTRUFN&joVx3{T4!W^oKp|BAwo*NT2h zXt7qu{JqLz!^uA5_0#?EF~kf;Jn!h}whk$hb$GN5GDGkc`oDdU>A!q95Q^7ng4Z#y zmN4zw+UgBr)3uiL7Sc#s)Oi+p%t@=G~jt%PcpDggy94pArJ zB5$PMjSqX0H6TkI|cYP0wDQ5^Qt616IZSiZjo4lE6-%mIkW#%i;(Misc@I!i1Ft z#;}?E88t?J?-~Q5X-6K?1ao=d^9Guc%GK6;=0;QE31QfKl@~;%ErecpWngi=Fq?LR zv_@Nyz0VOdjtMV35350OZTKdgLjQu3npUw$&}LI_i8Fqw3o%5iBF9E7d|rhKpS2VQT`-QXQM(Luv?b1fjc3qvpR<5{~G09!BmNW~iL`?I=^isG3z?3q9&<0Ljyn z%Pn`OUit`F{(JWLciC5;uy3vF=|OBhAo%#>K*(Ykt%vd`g<6%Qwi6Ex7SRdSy^h zhc#5Fr4^{_+x+7&Q#D2G%QGIgz6m(>--oGMY70i@yDNNd8-{t6OMZLzK@JM04MA3S>t9KlEh&caMYV<2tdy>!`6K#@~Sg3)w|~ z4HDFFv6r3V^u?7KlkrY#js#0CT9JK_#HWLN){0N`rm}f)sK_23zWzaXS&HeyUQCI_~&$SN+ z-S(Hg5>BX26+rTc6hKVtvsyX>CZ1dGi{@5hQ>-u}LoG7!?IRI51Hv&TK8yUR5lPekL zVuQ;naYO{mc_LFDg({1xXgPR<0gRVatnqXWTSRJ-d022DTpm#Gjv(>l2n?fH94M7B9g~b+l-Ii?&OifKy&%vip_k^|2Y|H2HVyAJH$F~zMXbi(N%y0$IT$78kM4tcyjbLsrf&ZIcANTOh7QGL2mbF7PsYEqKGV{BuM)v)UZYG^8EsGnh>xTy7caV76I!oR3tA8`d zz!vJcq*5*aOh82|=oi1W5;O3pS@A64_|v80jRElvOR3^8TIj~&1u~B^_CFiN+>?!u znh~B6X1z*|W^DbMqxn71-!?NR>SNy&hE8>P6Y5%BB)g3+A#LH4LUnS;7_YFqJGhz~ z^65unQ|Mf}>iAQJ^U|QX7I7vLW4ZzV!e6W`H;jTz>K>w5+6R`}9tW zrk@LZe_p&WD8(@*&0d@>ALfhWf$3`Y+ z(#B&fiQ$Dl86U=3yf7f@krBa^o=2cS%O6~)SziC}GbPAqGL~q3Jl)G^D`SNg;BQ|An|w!QTqR{xMU*racnXFWTKytJY*m2zJT-IBEr=K z`k2&2P9dZM-*O}Fz@iExB1dYFA4pmDrV&ahp4t7&6=Ue;*IlW7?Mry%_QyzlnUhs{ z?#!;z>8iv<1o8vkn8d_ruiXEm;=0qOtJp6nIzOnRYiN=d>tdQAcI)&Roh#hfk@qw1 zcRnVUKt}teOf=g z%Q@E2;Q{Z%F>9AwxA9tQso-I4FRJEViJaOe_we82ba)(@*l5zzfIB;VeYbWW)a27r zHRc`V-&&dmojtB5WSnGn-Ynfw`gz*l?+yu;;VQh&H^oB2-8;yOgJm+FSO!vwYG82~ zOaa#+)SwvGP^$xYYR@o}4{|1|O52-HZXXj89lZ*K8B}7zCS=H{6>_G`IbX+h$&0S8 zA!^*lDW}561-3XI8K-%r++Yxr*m=2GW&5#~_jIn83HR;i&V|Nl1xph3M+wH1ee?*~Bz6m8`uoOam9ey{O!Uq?^Jbjr!cA4mzO6Ay-L3v*j zVd-h6L)7SaVioDVJU`nN|0dug%~W1D?+e7blcIkPUF9$|3Q5A&fdpN|+NieLxB;5N zZb?aDrvz0* zUTxrzyS~9uEsAk7W3IZc_jx{jV5+{CKMQJe`L&Q^c^ydb$3)u7HSDy6*kNy)fB)&( zr;nW0@t~m;29cM5qEe%dEGet;JL+P(DJt877qI;E_x>J1C=@tJE9yEV?^N|}$I%Yc zLsvv1oE51xSMZn`klYPlS>@#y$gebhM3-l#TmI3_&WAoV72TP)ub1WPRZmHy!7J!p zUx;ls-lCu$p2Mj=r|-@xiT_&s{lCon--<&fQa?v1Tju7G2lRc@kqr3`?t8fZKn}b7 zt@~^}@YpRVK^Pd28`5uSBtjV(*>FEQWUz7?wyH{KeVlEztM8)M!wytZ{ z^31^>(~AqUUwxa=c0W4?Zcn-uW?C@HWSE{zKq5fmvYGv0K*X0m`^BLlc?<&?O6k-W zT#@QSH-*irJ@v%b4oHA{UMOeJgZBvF5mSo5b)^b2yCtyfago47R~!*vW3ov@*xw*A z4T=JXaBt)%28ua8K5>_&4PeJr%Bj}!E71^WjE+=s7+Tu#2HmoT0b*(GkMEO^d_)Gh zgA_HU^_fjIy~=g>BC4U`3+)H%8D3iV^!g2ismILqOk|bHW)~qIQPoKYU>BT4`1t|` z0~bmOQ-ugbXX<#HGoi~`O&d!+`4$H6BOG#MjIEDv>V6aK#RzCb(n?$4O8*8e+W=x= z<;k7~BcwIjWjYOaErh0BbR4T{Oo{3)XcIRcGHy-*WgF@kn=3APCSK$i93dda_*ffj zkB=*fli7CRU75Aai&d_(ww#;W-PDk=P9<64Sseu0)C%dJ$|=h)K3dwR`0bvc^=e^X zOmrb#U8qKHkWMyDG%%(l>~GTGBwTu2fm*!4eX;n4TLQg8Tj8n1J0G;$(b^s0Xx6g1?)^b`dYpRCSwEk_7S<)`d*V3usZ2h z_j%eS%S-fnE%;5Zfx4tbM{Bd6wR0RS39A~ zt~^To67*4soAPV+hf6wP1Xp^2@dgnSeY|}8baCux$vpWyy+=1@N$x?~?qDX4+in+Q zj)!M&eA~p2DD*+V#lA@w-e={{DC`FzOyfvTq{7X zW(3b9O_&q}!fn>^ugGeT9aY~yGjyMJ0_I(Bw~bE>C5;P!sE z#k~;Yg8k;8-h9a+t({ZM1;)T`aE?9=efmr*5A&jHyShXe1M)K1pMXBRo-1s8>}o~Y zG3Nb9!#Dt^e@So`Iaa@>9cnp+T9E_=r zc~nXl*2L*jC&^lGu7C>ZVZWMbmJQkrrjFHpS$@+bN_i$vHS>kKJu*CE7d-^e&wLbW z;d@3SQm|!+x%bEbe7;^5L1)^B#IZJa#!UK!O`t+ooR3v~9-m4l-)qUN*}jU5Fcq?H zM#L%`>Vf5k_Xf^WVn_C~I!kSbjYpTtw5vrig1}cF6rLU(N+oKN1g+A$l?%Ub-<9G5 z^R2-yRl$1kcwYY*i}M&Ex_%`8$|YVy04r=-AiLs$6cT z!^3VgI!PI*3nO*wv0R07)yq!qgwvf_hpb<8O#A9pZMG8EWj9(BXOClxPWJ*Eq=U)T zSgz9koBlYwaYqRkSj%)(+eRsw#iH0BrKV)!ZtUj%<#63wm4ITM_SLpJ!9)IU0bC$% z6cxC=l|9f78Xa;}#_|kyW4m9abqg|lk{N#^2@A_GZU5$ThKl&pJ;$&g_c8l-20nU= zPiX{oNkLP}4g1O^mXk8lBA`bH>8ASdczb4sZ@uxL%ear{a|(d6lt;)bP*>OE>RxU! zOMIsBL5MCg^F4ZigaG>OTx~OVRfNaku>AeYqtUmei(n&rFUM`D1`Bb=m@XqBGq8$D zrZ<;ok`>6QbJt?uPQ}zA`}iobV^Ym@J_%^XOrw6RGr1bavk6B

=aQtbMGz`+NRoRuAY*KX;0b+?m-9{&+D88y|n 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

N7h3WCf$A4~cN z@$cnICNuZ9hF)Woi)|JO{KJ)q18jCG)oGDXj{Q6pUF3)%MS`y-gImTvkQxYDI$9E> zeL9V(A8CRK`%%S-lSMs@Yzle1K1|lH$H_NcGsjz@4>YoDwDKVhp&Xi0AJ-%G5DuY# zhHT64N@H^=3At^>+q4~j1+e|*vwt#un=^OtFNxgmzMIBxCZP#5SElY659xnBpa0SF zvVM@r9BF%H@zmlm{WJSuwiF2Y6`n-jH4EHnaaqVfOX2czL0fWBGN8f=2#|RHN$&X1 z4?vd=>BS}Ub>rtoK+6edKLfUNs!w*`HhIy?q>3d-imC0rldB)#?I*^qcXGA zX8eVu@Sq%%`*n&`+>e0i*H&Y3YgcWw_E4oM-elW|OvqRs9^dwcD&&)(6B+5;Zv*=F zRj3xD?XyzxUL8Q9G&O3()##|z4DW+7@t7BPK`g}NI&*8UFYGD^&F3waPf)g{B(7|W zKMG>#P-z646=DO9?yG$9YqUMEjKNoC`i%JL!o&~io$d=lM zXwIFZT_YoJ(03B3J(g1kG6859r3kUNH`saCaR=n(Ohje~*ZE!R4qPyWgPQ}r4o55G z5Q04$wL78L*7^@;@h|mm*k}V~fBRlQO<35W?6v^O%O>b0c-|*JpqEF>3rn>(K;B9> zI5qk^4M%5<^%HbUsM?pc%f#up-;?;AzUm79YzE>>J=39$I>HM?C)|wATf6hCWnsrm z(j(I=b@QdC(vIM@G2W~jgC zF{b=`W+sJit_5qJvcISXUa=B6jPOzYa^#1Om?~bw$>`WGxk9s3a(g8}rLAIKU!BTd z+~UF*zXY>q{pve7W~a|~XvKR&qmYc9RmAEPzPpbEhK0fOm&gGQu~ z=o94NH&30ldMNPBjpoGW-oNJc>b{0NJ-wzbBh84QMmjjw+q3Fnv$yLNc-NXjizWe6 zRIO)kL>n<8_{BIFl8^+hAngo(G9%tVwv!bYYDpr7L3iwm;3G)ZWWVmDfy-)sY8#im z!d;w@X`aml3r!tFT2dG}7Opq+@r6#q2EQ-hQ^b$<$xH53mvOTlM!NQiGbJF~OsJUp zZ*;)BC}IiJb`ls5OT!=e`N^^?=!H)uW zp5pR&DBX_(?-OB&63DS3B>lY`wVlNfub;}A^#VJ!^dNtQ<~=PPLwInWRmvZ3Hz|rX z5sA^RvK;4aT9s9UDLk-?ZXc=H8k&w5tdrzrMos}y-fm(YW`$USgKIMd=rp|F8H{!t zf?9aAC81e&c;++imlnqiD>dxO%!>QeoAj*Ojlg%unC&6&$rSta=XV zNY3%w5^NrLx6DLN%igiaI$=)eq2uh4*<;px@7wSmU>^~hl+oS~(R}{H#yT;;ZMm9?(d)?obGq;* zCZ3nE&_0!uMO<@ZBRjnvDVcPedxqS&M}QiD$Q|F@`QXfuq@4skjq?}?iAmxBwEkuC z!DH3gU*I6uCx?{pU5s!7MGunws{5^><5csgd+S$M`}xjtd8w9ho?*Ip84_6SB2A`Y zET)}Euk4~zyIdXd{nK@5@n1yx|Nn>-JG#1UA9_ylm^S;_Z;^1iO&mmt^vMy>FT>3R zVk`j%9*YBGRX8YOfmg2M<`eMgQwRew+#P_*EiPTkMdG6scoz45Kdv;-MU>V3D^w9r zOl%8%#Z+TIX_JNeFCucQO~?T-m@^t5(W7vsSYy(Pm-@?0KB!xfKiJIE?{# z7TF&U%D@0%XcO@j)665WZFO6oszUTf&dMn8sSD%? zYpv3a+g1U?z>eE=ZLKamRv-FoCF+dF*(~)VA#edEQRoO}R?-YHl4sG)G6^sqWc_$O zMEXvl`Pjs4dPy}9#c&tmE(oHD6Zb)*%~`-t3&e?Cf`<1N#%lW(p(9ovYt9al%{{@!w^ zW2lX8!;Q{T?Tsiv2)SX94aYXocZ7tc1I(0=@g7Kl^w!cUQE9vivwFOI0-D!hY20n5 zam$NV^*6AHJ&{Nv-nLy@OA$5BOrnT+#d1qVW*&nJRF9;O7+u&GvO7B_+Tur>?~CrR zOif2Y&1425$EVYIPjW|gvmOW_#L# z^Bk2=P0S%+vO8<4eI)Mvz?A>Zw5K&C6FhtR<1}5D8)?Y+#DVkYz8x!bK91d=L%Ohw z2da0GCby$jAlf3KTYX_!u5bMaEw#Mak8x{u-OByMPZwEObf2HJWjq@ROt;*{(oCs9 z(LI#9&Pug2Fu85)zA2~E)5k09@A8!9-&+j0jV!;%!f`9EY(UIRFJnri4^56)`KNru z^m`YI>7ETdFLxg|bF8KNR z&dP+yfMf$Q;c|c3_Ptw^cPg{^luz^VuD;OAzmn^}8VH$%kbF(XXfRJt`E9JB1UcL{ zP*zrP4fnV><8yiG&G+;XVnC*LyKL*r!C~x@%2KQlXpKxTbi-VADQ>#Db?DkZHYz4M zM4swMn-o|Q$2RPDR)Vj2BWC5`@pnxk6DMDWtLupThn@M)u1l5?huD?vZRYT^rtY-a zPX;;MyKvUT9hHjjF$npnfgX(Vg|njpXuUUX{KdfmG%`!xQ#A*lbr(F)nedsR{A_8? z{!PzxdUPo=`?OJ4=QiT};u0toC=GOn31 zoOZ!!VpLwfA|rV~jQontE`)E)+BSvT)053o=0t4?&&uq4zo;?thsR;+RqwVo$XwDh zRi0f9f4j^IIQ>$dQ^XahZEf66Cv?QX0LnN15gtN`)Ct+y0RdC1h;(Gs+Do{ZfQr_Uoid;pBkGZ_4hc+F8-cLP4DZpg^ z{^!3>WwWsw^URfhGX?%4Nr{D<_~?2})n?dPegL^7QneA2{%#Kd!HrAa?8Gln&62-h z((TE<1H5kjoUb=2yjPI+$?>)#2yNhBbA?}Y&c*zX8U~ei9gvODx9NDT2S#nI&67M+ zwKRbXkF|QVc(-vCGf_8xpFnw@H=w=IL;k)azT#da=O1w3?>v1ei+mTF(Ryyzev~tgD@g(3q4k+Br)*saa=}=9Fjl6t3qOXXl zlE8#B83V$Yh7HWH&rQBs32U#RCS_Z720wSAseCYt<&AR_Em85}!8K;{7xE#1D$NdyM#iA}dmp{S*5-=MQwCRfot=5F%PM>5c zjPlu$tJvOxGye?llnIA~xSEC$b0RbjZ)2C!wQp6&orodJiF*);(tcGc61QHfm6Zjz z*kryZyKF&LD|^~9^bq(aA4?cWs~@rUQI;X9M;KA$@-T_WdQvokD?h;iQ^o-JZtm|aTyrfLF{`QgtR9$rvOC=^nx9tdz#vIC zT}<9eiPg97vcrDcG!|(i;XnhG6UXn4$=1Yy+xI|mO5n!hxmUrcSY39`T_JfLhojpM zK=VU+<3o)f2=T=)q~kp@4FFD$m$#dQ{NAQ+;AQj#rYBRg|AY^Cd1CUoh~_7I`}Z#M zIX1dBVQw{=z~B5Tlf&x4oh5V29}3S>jp;RhTBpaO-?2aQ&*fwC`SUpouwuqXONx`@ z)lU6p@oyq0Sz|QMC-f}Z)|!d+PUmW`)qmQB=45cYU~r|UKlA*V0D{trTUR@cWG&!e zxg?s>xX)VpdlmE7k?;4p`uC*w#Nxz@!F^B|uP-*&n(WO84+Y^USln&eHPESjW9s}m zL|@E_9cNtswtp$yBq665ft>Fq!t8W((F8(cTda_gTPTXTO(_^c^h_l6713@_PtcvE z;nW(>>q8(S#;W&x_`LGeGBpwZ^hJ?9HcTP|pUgJk%Hzwy)s2hGo880Wpv|DdQ5AIR z;2PUR&}}r!Ol}U0>5n@&P`eQs_W;xc^eylQKd$v*t*gt-6h`~v_3iyvXE*he^c@$I z)5$#Ny&iz$O5?ALGSto;2j7-_CwxB3|GAl+Wx^49jLhsl1=-ZlnRaU&wxhHcQ5uvZ z6)SvzdE@H!x4677UyF`22+H0U?IsTa(<9CCJxTD6kixvAC!R0l1@uC`?Tyl#>3P^o zz598eh*QBw|&la9lu`8b%%5MkXXCW3InQGoc9Q~V#pupiE!iOKCrRp4(@Lj(#k5z={I z#N|xTYOR6hu@b-cTFqm#+m`b0gYt;_%cIUb_R~?kB18Y^Dc5S`n~(T}?N7i&T$S1I zF3Uae4k|V#SkGvYe1MPErIXUz1 z%JH{|+LpDaJX5vn@lM1k8l)j8f`8Hp@PqX>s}M`nSO}G%n1t`;+_q<o*$WvSQDEaPQKH zYhWqJie?d(jR|?|Mb}FW-M`Km6HsPQz{#eKMr#}`R{oks1*jXC%ukXy0^Ml7V~1Nq z=VzYQ)aZxD^1B(O?~wuaQ!6_@^W~#tW)&w1qBh5$+1m5O{d=g?Cs6!dPdV3-%2eN#zIpw7KK%gpuHYu zM$Y)9gpP1R+?+4wYaEgQinOC@*ms_v{oy;yy#Z%4lm5TB$NYt0;$>x^UWwQ3&Wu?Z z=~i1r86}lp8a$At$J7*{A#nPHc8C!*u}FD+`KZPmpU%vyR%ZoxOBKQaZf%eGs>-@j ztQ&5ML&;;eW5FA3jNY?hBe%54VAmt3_+S5-i~nVFjJO@rN9?fbo>Dv}+#8(uK^&cP z0%pb(-VjPrpA1FvLWtyp=lfq!F>fG}Cr^ z|8P3TC&eC0Adv;sV5`JLaRBJc?;5hdN}G-V|m$oYb}#QX6Pl^gLF!s#diy3yq95qj*M3iwfUTnjqM6ozPM& zvsTxF;z()r1-1L~xv0++#t;dJs&kS?;&Q^p-fkJ-b+sr9zR?uh%U4h$0(;GElXb1H zL2sECZ~vaR+2!_3*#NhP3naNg@*#W>kOgE?^KihcT)Ojlnp@}ZtC2@AJ|OIBIG{>& z4U}b>IotX7sO)PllCPzutranwz}^LO^WOew*si~2(5}N^W$93CPy3E?F7N`$s8&f# zkLRfbYuwN8j{cGAZTurrh@3)S^F6;uTJ)TgLW(D|H{S77u;bK;jaXKJS(l%Xx6vw~ z{h2rItpe0$NlsG+fUpCzCi-sgAgqIAq)&l6F;nL7jXdHXudAN?4hTSy;5)Nk9O+%F zsdVeYbdL7mjnh-KR!6Bs;?xCR^(t8#Wz>G92O!mQ&YR+&H3rEaQt+d%|05$VqD)dy zOXHy4M&C`51LjQoQH~xH;AyPloSpA#MjRDTRQ{$Iv85mza={O4$V0&xw5FT77eZX9 zK$G2x5^%laPLaf6OuA?nH0G#?eyFAZ=$vRk);p z7789@M|8|UNCeO@u`MJCAp$!eNqEbal$`Dsw?iFdzSo%7LmM3<8BWEw%f}kh5r#>r zg#Y`(j(Pf$&|{y`7sl?jJh$s~>*&q>UFv5oC)lK5LGX5+?A;XPqZ~VQ8QZnJnuma6 z#lTr&1j3pqtLyo#rL9&WB(ZSRE+`ogi$s{P;^NRrN3^+~kCCHMca1`I6b!uUT$ma_N2_|p)?!vAU;vWW=HnaN-C$*hfY{Q(;bZsW z?WBA(_ejv9Il1P@fXmq=%ydo(js@JFC|==wpG?g{c~LGDxE?xhGqkDtL+1Ri!twV% zY>o-%&sI)nN1R#L)`jB-2>!Ks5>(hOFk+^sa}ghelH+oDAb0=R&bomQ97aDJ2;+hO zZdhXh(!8DwdNQJa&g3~BkI1&S@?v+yVzs+%*(-($OihqxAZm`CRG{TfdLtscHs74M z&C~ZfSMa+#xVTER=H#wFj0gDg#Z~9p7srd>$Er{t{p7%<04tY?;BlzK{6V^?hsT2E zeZfFE`rZE5?+v>u2Vhj!;(*w9l9?t8v;yviq`|Aq0> z=kCv&(INLNN0qo5NKDmypSZR+ak(>1AcA`UhX}mxNOpcpT0nqu9)Uc zkSsBcl}__Ahf1C?$L&ZP~{Euq{i({n7{gVe*o`~0QbiGZuyeu zVL_;%+{u67JT)M4z$dc{8Rf2IVuCw5yW3{X7j8#5jNpeG42PaePL%9I%ZAwR5vVv^ z8MgkL|3)j=7u<`FQODuu_FA)mJo@!4)d(k?w-n^&Hq4fhhU7R}hF>ASD4&{u5tt%+ zc!6~sFa_?R#oybnykz{TPXpExeCYzi6*(L8x3=aW;oS+^f7KV!M+;n8vU+|ob4mC&cv2}&;A zgCerz^xb1axGRA?++ zFmR|j>^btZ>ew0x1Q}9_eVRgd!G#;Ba^h_uu6G7bWe3h8O-|O;?egW-q1LBuMrT!> zYbE{smjj0_4u*K=iXG-3sO#^3j3eH7LFl&svOE82;K};KMsDj+&+O}yr(_d!z?|>bZgJMJ=4!dGt&7;Zh*gh!goDM70tPFTB_G-7dHSJ4(Y~-v&>05J}7hWxqWL^P} zfBAJVI;S1FxDdh!hD4n-E0+|zWmM$8_D~P-@vMnxPp)iO^dd)!_=41-Wmg`cqr~;B zCU;=Wb>zj?tTu-7#F>MA42pOw9f80#|-1jFY z0Bc`dHcNvb`goRXXNND$pYGf$Ys^CyJ4lGZss(g7*^u8%Iiz zc43#(r6-0B1c_4ia4z?b8wGuGlBhg#kGor!e`q%?9fgeuQ$18rxqbCLm4hUeQnw!v ztFSZh(J$d1sT7roQuAVrq82xSh$Z$Ju=0)#^)+2wxlt7KUf8+bl-Z1V+A(t>Oq64vLEqw>b@vW(VV6g z*-HJV!|N>=Y%n-b9qZXG5dO})fvLggawHc z-*6(G{_S5UWQVtfx+7{xwtcVytsVa_BR8@m>mejxhh0=xb8dcWA`!U9T{l&=A#LJ4KrDUtu3i*^5*i~le3t{gH8H&nXy)h2y`rpqLy zna`Ac%|Rb|qE6((t-_Sisu*`p;e`qW4!1Lr)Iv*DH`JK`k1xby?<1*m{@nU@Al%fmSra0qK%Y8V zH*;J7-?%o3KITusj0k9%XohAf-(pEPi<<3jtdch(XY(|8oFMlPaADhtPu{{>cZW1M z;WxjM2fI^GBbi7suR)zvN!C$OU_Ht zqhGGCASNCuZP2PTa$`Fic|@A-F#mYy96+=6ot0*@&$Wy3nz>7qV6`7YoBL5b7Eg-Z zS^4nM5dh_FoqwwCl=Jh?@nVv(kVAh9Rza)%rdh}3VYibldkz&U3Y#ktPv*u1@@%Nq z7>xG=66il-+T5&R*w{3J5R&!QP%ARKIGLpSt~{(0J3i^eNhmBl?v#0~2lJ1J3r!~R zsLxBBqNnLUzP|k|jl-(6d`IY<)-b?WULGOoe?g<;(enJ3Xrsk#0v$Syy{1ilOD%=v zF>Lz)r2`}Fw_LvigDslY=OJ%5*hqjR_h(*^ZG=yp=8#m~kgT<<#ym9&2%$N&X1kkz4a zL<1ttrePHt)OYQM^d%K6NS*HI{AAxU;2jE4ml~O8Z<_oy^8{MKvgw6w6NrAd;eH8_ z1QY$cfWr`m|2g{O_$A)H^4xV%ntZQSidKkZZxgwtO)+~KYrr`$77`!&E-rUZr!()T z2v3P*w-BDmrANI`Y&@<1YM57u7O4ehhtmVmrwfkt3-8Bbmm;bkrxk{XpsfveWlm*i z@-ONXXu4_nB!O4T(bf;6bX^SqDecyQCKVvVnpP1KYrqUGOT@_0em#%&S7ES<6D1Vsv?S3$?)RkAXU zP3;!q$W;bLr14c2iT*RSywPT#v?J`FUcqG|M0QLNEx zS#ciC(i+X4ov8r&8DFcQ9B8ff1J#4@yHBXoG!Cl_r`o5E^~>XPMH(tKSxl|Ro;P)Na;hgTZ6LNMgWjwB@qr&_;p7szG>>l zb!_^jYucCrGMsj+KF}6hXe@0XJGGKWM-3{kI&=!jccjBOQFb4@&j40dA~md+JB0pA zY+hv1{a}oSO~wn&gzj_?#tTQdoAc}**DK;mCJ@%Ml}UFjjR58cfHC+gb6S+Ctl6I@ z<)JdO6v59ebBWd$8G3$(LSV^=-Wpz2!Or&w91(&QTPln^w6MbR!x#%j$EX=Ee&U@w zd}jkI;uxF4#x<<~5avSz=fonwUip5%52BSfk9D}W%d4e$v}0$8k&&zp%h)&katnfG zwCxVv)r8T?Xct>RhqooLls|M*QyLZR%XqP}OU?|nKh77r2eOHkOmCl~%H7f6w}$Ui zZ|Sug(Yc!0TWuLL@8Fl3-?(2XqkFyC@9BVle$r~1H6Y~KN+&As+VEl5?Z3V_6MC;d zcvB}NRNY1M_DibUEfM=-Z#-Tet&|VfeYKaB46=L_$JS^ ze}^66hGZV|xBS+)W^yybm!DytmtYZVi9KG`Kf3dQa76fX4c{nbPH+TFLvHJ&G$6if zW+(XWD$3vd)qF=y8X0TZ{C67{WCOqSNuhm(s{=?MHekwS*yEfmYyQ_C%U=E@az~G$ z3zWnH+z)GrJCh~J*v7_tmTh%E^mMGWxYqOEsKbE9=p(tM{#7JmdYVr3qk|D3nq}Lu z$?`PsqxD>a-xyf7tQhj^=Vf0cOS6*;br(%$YwN1xaeh{OTi2|H{Zv+EaV`nCYwYCh?Ta5IbJ!7X`nT&-wGz}v{5^`2MzoQY9(s0rMG}$ zB4YhGIP<~IXld_0=j*E01GYO&HaV|d=}o=xS8U;y<8m&~Zcz3k5x;w{E%U}W<+wPq z1HQY#p0j8MdHCRkht|Og5>zf0a&y&TW~@qf*c_*J@w;Pk+tErO$RoD}L^>ejVB_+RPIf*jLO zfmdn}V4&3x6Kq8b*M9-;%hUFL*)DR7`o_OSx9(Z#g-e^LWu*Rl3~J1yjfN+9yk-g< z6r5CR2Bw90hs-Yh8bRE}N(Z^fI!Th{C$Jxj_uF!r_!#}1TCsFmS)Ad=zW<~CTywFg z_xj#xuk3hOwz9>Z-oM{-j0y+UcK?7P|Kx5SH1>uMH&^A?jphEE&eehe!D<}E407eL zIE3*CM72C)`>@a@{>Z%Z?Qu&8GLYsIargFy#jN>Aix;_UaW8ASa6i`RZfi675hn$I z9C+muVz|GTxG#$$iZ`sn1YA;u;(nxx!FDUARk6ynvV*cdPeDZbQ>kT%YzClq0nh)e`xchNE&`y`UD@EwonLkUR@0taOz|$Vd ziBq7)566t3umx-`g-?CvlOz^n$^yC+_gGO*hWP%tI1JR~7_3z1or=2DwQ3_#=N#w$ zUD+M>Rbyh-dx2|8;a!ZD{vpE%9|7g87)&>7WZ#~M3A_3dD-J<0K9TKMZQ<}_CVu?}m0>+t_@^^M_~ zHCeQ8-mqiawr#6p+qP|+9kY{8$F^;EY&#vBH*@Eknfu&&&X4oI_S$RLu3Bpcbc#cz zl#M<`X!_SMlZ*M|Frm($G^3%UGyQZ_b~on9tSBu9nhmF|(^rd5_PV>N_Yv-k&f$sq zS#WbYNLOe3v8)!KE{IvZc`eB6P45aBK{^m}7q}~iOs0=E1it-png%wZvT18o;{?2i zDMc9$gK34qXHN!}G!uKwE;%!{^Su;d1MyD7YML@k4>WBr(lOL|CQM-7l0G2otBMA{bJ$`3G4B@@Vd%x zdO0WE*GhVMzw8S8Z0*+$jDC~;4a#zAdDaSal5UpY^VHUq&?8+;I@dm*MKdp6@z5(M zYwr(L9b1o4K1MA4jD5Kjt!>+~-L6J--@7L$a7jIa4|=$sjhm7UY;}O++iQSXz-8kk z(uAWyu*BB@&8N@uIJSUeL%7;n0)fjX;tlj^O9_u^s+Z>@`3{1!znlJSW03nMjb{RV zsVvwCJ(f1o&nKlM3KImbxt$lR!`n^oik(flF$-sy>=Z8N0EpLjPWZfX*~xnk8BP1` z<^Dt$TcSfCw~rsMiT8^!EjGuL2Mc0-55Wb@b#LD9Gkb7)H^ocK&-c%*MPog`qW-cg zoLrZeN15V}J_2l(WALFL!-~u{16cfK9B=L+_pN!1f06p2h6xz7{%^e`faz6;YmbtJN%V)L-HGg-KX*y0>?IhzT`@*}t zTjbu;mq2(5#I+ndN62~f_)j%(9BDq;zPMCgCE1N*Vqi>K;V(&iOwvz%gXPfg*aty> zx3C+T1<6ZaC+W;~t`9Sz0Rd$A0509~%+<=P?*3jjx_-9F>aymExjMW5P5+S#VpOrk z0np8J)m2_vaTWXrg)RT#%P$oE-E(%2yuhMxl1Fdx16=0pyS&Ep0Qg%O`&W{1zwLgk zIuJubN-T$?6yhQJ05BCSizRBTLqK?#keqw)FdsHSkGq+tL??bp4g9sl5-;) z-6asZqI-j}qF&3hJ5p zqrDIl*W7NKX{Eg0dpH-KhM9|tzZ;8LrXsJB4R_guRl}bAI$0l9E01+;K&LAj=B)CJ zAL*@FuU_74*JRy;ij^?X0X6xEE{!X{rr_h0lr&X0Sw)eY4Gx7$g+~F_xHHc2GIaTM zi}hRm?!U^u^PHTVb9+opW+6r@ecO8e09&);rL#uX%dhB+#OIVc=~^BiI;^y^bHt)c zqwEp14ujES;EjMuM#`B6j@E58{4N5{;#!yI*RQ3bNtHSzI{ALXMV3h42m8ZXuXG(U`s$YWyPoAs-1y0f`>P-RW>y>y99k4N zxp_Js*Eh5kDH6)XzK3_fIT*Vkt)Of3E+Aoh<#jK-K7%tYDojOr%I~R;`0aB$$nuSd zHzS65js5A~!x^C&xC;S0arsgB*nO4_u_m*ff5X}7mVBO&2cT2Hp8M=ye&Uy%i;;wD z!rsxnrh)}CMDOa8Bjwtyj`|aj{^pxJz#s^}1h%x9RTOYV(EA2|zofxEPNH!zO1gND z@tV_FWmch*QG95e0GdT-R!#ObVMBp$+NLr4ytkt#*=QrWcylbr%aYHh9nq=leMKEM zZ`T_17$`>*c2>-h4>)=GtQAQ<7WkcPlGWWbIfaC;u2P-=+UOtjy#r#Gn^5skXsS@% zQK-`wNu7&BWz&qv*FB%4dtUWa*=e9x^vFxU>U|r1N1tRY*2b13C>6DEVXw?M;lP}riKPdih)%%5FtgNgdhbP)PcRsD1 zC*+Q#?y5@8{((*b&^}Z`xaq`X>Ez&v6QHl?m6V1Pp(RK$a*AG*TfQY?IK^+{+Z)5; zj4KQ%!~MdmBSr7k=1$_xg$wDD(+DyL4z~%cr@l^$k=UCun%UPiKR(xH5rg3gIav6J z5IrvC8?{y+#F$!fetds_K@B{>Di!B$9edjll1Z{2!+l}FjkDzlIv5CCO&v zHjm1}v*Y>9sk8ZFHvNw#${~eYS&4@p7o<;UeBJ%!WRc~gG{LRJ#tC|7z7k%g0$vC! zzRr01Zghe7F4i|T3!Un}!$cWCc%uMuCD%)$vM zx{E=8CoDbx7)BUYLu(JFiA@Nk$kldjW(+aWPpNM=`Std#G24S_9;@ty#Ev532JMYn zd(=z8W@*i~s?*s?O-y=Hw{FElPw~UgjJoujSbxpe7~53`6;v1IT9Q~)$X+kR$5g5t zi168Bbn>>Rk@h^8!iJmNV|bV6R1$-x(L+~y?*xuGgkRkOn0rWu<2&4$1&7b+vwOEf z;Dfd;W8I(pDin7~-*J9!) z<)lw8{~$8Sq-K<%V6rmiAUD{nCf}fJzUQHkee-cX7kYZ*Abr}!hNpk5cfmTK`L!NS zZun8>xv9h3J;Wao5Yr3%9v@?QlFK%B^68Kl*UB=1b5`~G`CO#?ip#P1)41F#Q_bc| zby(4YObu2;3)bKK^;>kd(C_;uOX&Y1HReBj>ku1hbm-Wg#Scy9&Zi^m2i8Wx={rrp zqI@XG3Fa4G`GyS3Bs!M>x(&uJj`>UN2f|Nb_y_`Hgba9nvFbm$vU~!dy9REic&N%t zB}J}3%ANzE8H3G%9+yqA$15?iL!8jL(m^*?%~?nrFiZ?kp&(4d{Dl_K$6yA{bLAFc zMBdt62gq3JodA}3H7Mj3N%YazoYs#mkvZ-BooHDC?dc?;vwi;BuqXx7{eqK;qvToH za;iB$|6AqtoCFLQL`Z*V?p2kd3TjAp^<93>{k5C2u1 za!sp-t2_*mH~@2TEz&j(Sp?5!tT@ME`Gg^b>G|y(nNbvVSGGYnnp&X>==9ot@rr-M zT7@>q^Y}aYOoCV}Dxpn@lY41Fac93sttN7rE&2S(RKyeHzu!dk78rZmS=M}8541lI zh_b==AGBdrw)|+AZ;# zwE^2J5Cfe)!Sb-B8FjmJ$wttUs=yEe$!#Xniqpe=%tYoY-G`@S9eZNYnv*d!5HTsB_1gay;YWfcQ8sdk%eA`i_;k2C z=|Iq+a(EGb}GM@W3#w!ph8g@T)R{*4k)d5qz*95R4uZ6267gB5nj zaK)dF_QF)jfKwdGjq7!v>8Mz}?4jUZC{z!PxV>~!4z?}*POT#GzQ>pSD+|>6?UR9^#f~&ka%OhvAw?IL45%L;FZZ&PFF!iU+(}p>* zp&huaq&Rf`^1y@Inta3X(J!abKEGEqGP67;H&(9HBtj}2cCD`nkVAs~hJEniAxHbKxgzT;-?)Kfq@%}?NG`86 z@gYhDcxu8Cp&7O0{ zF#@L|O`>#exFxoF^5^@bTMiG|oh!dFCnv#(0M@uIfjn-lJZ{a6;Vn7~?hIGqd@<&p zNN~3f98FsO$d0Trr@U>1nH+3xoGic zMhM`YDsDtv0FTJA&EMp1^p7B*1?hG4ep43}mS{#I`zX^crcV z*21^8hIO+vg-#*4|H?n987lVY7Q1D~2p+#EAWi!<7;jUC&5I5C5TBE zR}H+~vT?UDVJwOc{AWqt8*J?FBLjrpr;Y8Wu$a<-Y=-fzcMQJsNejafzjP||T7Ng# z7|Jnz2q})urs%3l`i0aTF z&6|lbA1G_=xuC+c;DS3p=kfs|7??Fg)36Iz36%u6$L-tP;~@;Pfw>pvn3$c1|sV1bX%=hxC3gO9IwK`T4M zX)bs%UVWdfw6ernjMUJnP2~HwR%xrs$<^N4>ZFe7?oJWxepCC<#X2YWU*28+AG#Ag zzKlh3`1Vlx#9JKM{lMgSJm)T8_tKh+eDhFFA-8vlgLCBqf{4W&g1|AhmD7R&9Z(|s z!Aws<0H5*gX9A8751+T_{o;Pqdv9Iug66Wv4!Zy?ASD0{904un{%}~`L+!gQchuvy zweuyB1;J*IKO>}7Tu*(P5PXJEFmPU6njvYrId!F8dd_y6S741pI8`k43FYRGCL|ck z8V(f?i2uuIpXapgU31;cH}OTasdibUmoj1l@B8Z{r z;MhD=4Do8kMAA5Cvr1*dIls1bXjnu!+RJN@%${^y{4tIGorkONT*vbw&~U9I46O;$ z!y!R5EOm5dxvB-+0~3=^b*(R(u3rn)yz9XyBi3c>Bcf?FY#Vhd0u9^IAMX&g?8 z*2^hpVS^Y+2pr7~>psXK624jw?2H+#rsOE1|A*Xi3@25x4=~ zjZt^mX+j_?O`UYqJ&D#jOBFJ1#!}=xQ+gb8>arPul|kPi4z63s2z4wRWc*kRSV5FKccw9OS8@g;D%*nS~%zQf`gTP zvY(N>J0s=$PinsyXrz5;EHC%Piu)%`n(!@nz!Q%Kgz;>%!+Xz!wV(PC=Aw^x@dL#! z)7dL*B~=44fNQWnBqa1&1N_i8e0cZn(ER@y=(AlZPBL5gTi4xj=$> z)JpJ5ZA&=lY@L(z&h$5a;;l0qY2X5=tdr-=*Dh}WJ*SNx1tYN6Of)vJ6^$zo1;7A}Z4U!?@@=%*+M zE1}ezW0?0*bEvDkhLy{v_#|Bay_$j8ogtdyl!nQE;hN#%Apb3&?LP|gQ$9jA-|$Hz z?Sx5#`KBfO^$rpfotWA5KI`=tCW6#~!$Tdmeg5Osfc_#(XnFPs7iN$X^s+O$S zjq^@A{tc0`>|-kaKD=HkoS_9fB-H}%jBeqov*G}M_l9Y!9%-*dM(l(BQG!6W4KsfV zmGiryCl|(p)zOSXRc+qD_?;yFmt8M895$;uv(br)&hB)->DH!MZiP$*mw|_k#oX3f zC55i3-o~elNQ>olwXITx7kOEn?iSC9HR2hY1#0MeN-#+l9=xnxKWnr^sQcBwd3^sr zNOy!s`d5XW&5uRxA?1Vnr5eRz1Wg{@N(d)PPV2qq7RJhz1Hq)&hX<#2peFML3j#U; zJQ(W>_kp3DC<}f?#gJ1U(}7`gqds|DSA%GmdYe&R_j*p1&``oc0f<5Ip3=#Ss?EoL zBiqgsfc^ID5LzJ#$XI;+&3D#6>cPNc9=K4X#H%sYo*U1QCj4E4=SfRwdwD3$GQ;#R zot($+i%{Um5Za6Gj`X1q3*8@y%~m2rq13bwxoTG&T&z{$cb z_zrV>QEVi|Or8>_=&PA$UFz4ULBZC&0-`PCd9iCXYfGqUmmeSQn5I^~2OxBNP^@UQ z^u9<3=#4E+`vaRGFa5rRa!{l2)MwoC!?TX_Ns)|51*v7daMO&fk16tm0@1ZG_3hePzy2Jdy&240F{m^#;==}pXX#a1g?6i-(aa9^kbq!@@t`9T`F(EY29@|` zWsaaG>e*N=)h%_eJYmiTSV0`zpF%H@&@7y&8AuVLX~6-RxEAD2a>APEggUKNUl@$; zfPMmU5U&$vZJt8ctH-Fma3H|4$`2W>kt&MCm#uNw%;k$$gFYD>qLAZ zQVC>jMYsKp-ZcG()>oH!Q?}fwcP}iJ@tx&x#@`U{v#P{NyhD66^jvix>u^9Jn}F?T za-XX4dk~!3iITI&aL6Lr86eATY5hKS7PE+^@`G@2n3`=6PbiAWPzGL~k78Wc2-dBu z`zIW07w4ZbQ*c*smk})VPmAAR)KY%_&Q^}iw7`j-W&pjjsts-CwVt$F@=kVn0l|ND zHGZ(C_Zqdjs^K}y75J1)k^hK+A`f0GDs(mY%fgFU&80-ht<(M^UNt%^{dA3>1NQTM zV_Rtv*7vtLz#QSDH(rZ1ctK&W7*!vY#anIn-%D z>=`7oNMPbTwC{JQoP=mFX(GK|kc%`*3nC{fhcF61ZblH9<^`9WlEdo)>b03k82IB# zH}aO_XRh9{BdWFx%9Vzl)u1h2OON8PgkHD%B}gT%9kbmNoYvxWeavsw+@BAh^KXJz z`0&!w*y0Vyd z@xF`riQ0e~@^8f7{SWa=F_We3{oAP$A?2J7hkjrtN2B+USuQueLdSqU+{+Z!WP}+$ zkSnfV(DV_x)3ik9=7xw0l=8`k`ac6t{bD%Hlc^poi@6ogRu>MqFWSIL0H|CmeabP6 z+mTv2Zmf$bnNmYJ;%SwjFRkD)oSX_S)ncA@KQ(1A{eoHkv}L)Yv2PgS6_UMwc*wfJ z`CII7mh!7P%L_v~Z;FEruC@Q3*VduDK=Cd)xJXS5`Xd1{MTya{VeX@$jn$~{OGGo z+1xO^JGe2OxXcor>R8&CyO|5qf3h=_aVr1HEASxgYvaON zJ9|P=;R1$#_>(Tu=4&M(lYp&uxul)f-KxPBriD0{FsA|fM{vVV{OJB z%MITac*rgd!so^<8CDaY#rApw*dB|4O{h+{(0Ux_|JN7)KBe%O#t)!7e)?kIkd+U`E*%<`9Q5A})cb_)wM+1@R+qNV=rJr@J$N?!2NGs3h;f z!3ky7jfhN%e3+Is^yxnG9ubb}kRDZ)3xdc@0iHj5!xso*|8nZr_9bALp6)rxd)1G{ zwSS1f+coFu=LYHPmBZOR^IyBgs7{l9QSF15tUb$N#$$npo=ia83N+Ujtm5(DvZ zV`=5auJ$@_&3AFwlGuP+oCjDW$tsy6MzJANzzu>eGk(vE8P3anAT2Q;CA2dWrRBml z&m)13+rLNqHnG|k`pw+l+`94^<;DB`CGaJV6G$IF4#!*_WZ2)I#b_9&P~gdMNADDa ziNz5*Hgn_cK~jCz=&!z4Z!)rVklp1L$qeG^b=Ei}!Qj=pcXQQd$bFaBxTb!Qo+ihr z2C{L677ITY7uiz|zE~~3DY#bE7ryEg zfraJH{FBw?w{U;;>KdMH;4qpuvAMYDaG#flSK8 zZYQBlA^lAng*eBR_r68V?}hf$FR3I=eSp~7i0nr`D_yz7!!PHZSt$JPHtd{^*K8EVwC}2yK;bWZagvy!ATc zkcqis;j^b+js3=!_c49hG@k#I%ZSjP7(io&=`47GJT2p3m7JyuwI}O5ke$!PxibW* zXJM_lm=E`~IEt_s)1Ouh(gid+2udiq>Px{Q(O_^Tikbyy!7NZ!2HBh=g8?bgA?4ke z)#lIDYuYnU!?;Odu|Ww@g$)E#OxHoxWbRFs78&|^ALR3pxQ{96lZ&5%8V|+j;?EQf zGfT0~)sAYKEq01I9oO%6MM3R6FxQW9eouj5)a&BI2i!#V3Puxqi0|v;0x0T47N;Dg z(E+yfS}cOSBD7$F-omES#{{T0+n-xD4&SmHK-%pV7-1jS41$YAKRdfjNqf?WxnChH zoZnb8L2JD_PE@K}uBO*8;-#nNR)|JURuwI-fMgY2WF<&CB>alHCn(Mxv8!K? z-VEIbE?rzxifER|O?UmqK2^vuo;vAQIOH`Lp1kt{QRy?bh=UN=u*H~yuD-g(b|kE6 zqn?;N{7PhudD55Aa8(OUYg^0Z#iZ-3{CU~AIVgInXV#EXY!8Dj_USVp(=yd37|SS= zqgii`TNQaVBUP!3&RIfD_MiIrF|)t%F2uKPi`i1DSqXA|2Jz|ZdOawqdKaf!bdMli zi$2Rv7`i)3`*MC%T~sF$Te+QQUbMKfOKEwToqgZeK;l_xQ5^Da0ZW@7-mSW$B!VjW zH;4aMt>*|&WK4c>@%}Awhqelr(+}j!jG~MnUPLb*!p+G?P?mAZYkJlWO;A1yNi1B@ zGTi7LAO{a01qtwlhfrWFaGVYge&o%`LpR(7nZcKXZ$!OUQPk@!L7Rm@#Dp^XrvI*1 zJ#PYG`O)*fE3w6ERO4aP(7By8{56_hITtecW}a%yESN;To#Jf;7px|Q<6KT9|tW9{8F))*s-tIy_;g#SQDc6bT9 zX8}80_|ovZ?m3*vT@?NOZIOnFSwS(fm0I0yiG+LN{G7E_uscaZs?(GX%Y~E%n6Yjm z!spQvXK_xe73NHMN)3#)VYZ)Yg~;u3WCO(;K%CrivcT*)2N>plmVd#E8_dC+Gu|c{B#+= zki=L@@LKN2VKqI=p1W@cgd`a2MxL9{ho6J^BZMaHCe{@eYY>01WI@u1z_8}^ueTe& zaH|g6nufbzc)pnT#5yc|;a@%Dr#!qwO1t}4DPm-jOB>(<#2yP% zw-y+Ou?;3LCW5P)vqMoMSDeeQ`VZnB^8v#WrNKhTn}PisoFl;ps*3D*G4SS(sYgaw zVYTjk)ak%v2e;8d4jiTziOm~GQB4+qL85^c*xjtYz49mo??s|cnG3u6yCEd8R*os+ z_29~1{mIshyox`UT=YGFmneB2XEjLoap4C6?%|fsYusd?EDjWBbGqNP;Qund*y7H* zM(W5y`Ci%a?|P4JBDvT6J|~g*j~^l9e>m0YZ^ya*-wPU zjK@+7G0NM3Lw(M!Rs{=*XSR$ieiM)Lhc(-wl5!gg{rNS+s&NRK{ie!C0X1P?l3|+D zkgmI+koDL_L%Z#MhKHqx@3n3NX(fvm;=%J*GXg8!r6PIBtU)L|9N=Iz5&79``r*b} z(R>7EvRV00U-c2jU-p%HNDA8t0joKaPZhO_QL_G2G5^^_7xk;_vYbp!1tZg!`cNw|%}xl}I7N+=A)4BB-`yG|G; zLNwzq?qZu1pjPHc@CuYbZGs!qv{|+$yCGzf%Dk2WYnCE6^3N@`6$WWC{J7jn7p0%C zASP3ntgr%pJ<<5Dut}cdz{l?4&O0P^ris8(H%W|QLlEWXj{uM@>&0ylbpQf&KS8qb z>Fhi67F%rZM}I#!$!#rS|AQTBuI&mqiD)O;8Ol_ffJuip)%EV;FrS_tQ{KLJi_9|1 z^EZVuA1#`9-CT)S-98O~YruWKLoZEd@hiqI@2CmVPGUpV-^c`^J=9t%4H#r6Y+emN zKiyBqHL(&)cEqRtmBsA~jJ3L)8+v)b3#IF%MwU7_Js(l-pS~}FP2xv$>D!b1(XDf8 z!1S>^;gU-EX3$vxMXkkJi^EJJ2A_j7=Mxsf|Zn zs}iL=K04sP{pNJw*YDTLb~?4^aE{r?gEsPz`GSvp57HeZs86~aN@4FEFJDgB?a$@F ze1yUg8fa>NfLzp#7q|j%Ua$wpg);1dyYbK~$2$egF-7_C70WluaNz>Pg7KA2SJON&0TlTm0! z{Af3)Ke9_rrgFkQ**ALz;I28oMFu3kEC4u$@OmItv!oo1law2_C!4wbQ0z=aWYexk zpdF|=K`sQL&+4~H@r52c1IT*u2J3lPpge3<{7FPl6UYQR=eT35ek~0#`8l`I>Ge@=@P-OvT zXxMq+<@mouvie=1I5g(}M0L$j6XL6~Gclo5RlK5_7{NDE<-_XE&Hx9`ctulkZAE6v2{kk>eusKAlk}y@0bxbP7R1O6 z>LWjippJY*Z<)dqa*Y!sJcp<0{rP|OKRYD7YQ_c<`<@gOk?RUQfkbBLR32jRNiV(A zVTE*=1Y4A2iguSPeJYX}^;P+m#K$k#RTu4(y>9T}2+8=5X}d9Zb{UxP9596Lg7~rZ z36Vu!eO&aOo_1CWE{!x+Ug{$6YA+HXM{nxtr#HI=po;Tqx)sT$7zyC=$yNKSF=^6| z!;yuhUQ>6f>wbu7nxefw`aKojr;)?rDxs|@wN*20eWrf|UV@vIN*CsY_-DE7U`A`z z&HQt2()lM!bDU0XH8D8XXRpX9qQm9Bp36h{lJ;!y_uPat@*zFXT!Yrva3Ut$OJF+q zNscOnPwrQClN6Xk<_FSugC;5mk&N!Y%QN(bM-&TyN>krasX!|L0fGQ^zKy$MkD@>j zxTmXPlxVTRwsd?Hli} z5vYc3h214T*Ncbi;1DhzcT%q}XlQgd-_@1BixtPOI$@4Qxq6lxKiaX9kIg{2!!c%! zr6qz1Dhbu=3ehgeJ&%FGXxxsF`o-YX1pxT7lp%h^c*p;p^lziX&li+crNTeZb2R{F zT9?NnYb7q(D_8x&cUcb|RH12i(jt$y+j)ELddXBw6dQS3d=kW}5*Ro*<%9-;F)Whkd-KS&Bp_m%W-VtRq!RIkxPLI{CSWYe$p zay)UMnLC{-wVm-(ow08lt9QJ%q)Lq@&phzoT^D0q)N$Q>OJX7tcXB%1UzH{W`fnaH zp|jb1xeH_Kg46fzK#q}3#9Yv07#qWe<I*K=lm1(gIHERr2Sh8}VZZOQbuj8eN< zfD_Li^CdEMafR4KTj!5>t*pA}dj)f6^UKk%gego_gIvlPyTXrlepgPNTZPSx;(5t) zcCp}@^yZBj4xkJbExNY5!sX-c9w%PieCK`sz-^vuZG+7#D!e^9HD{W^8nK0n=|ya` zQaruHzO8nRfSvq_Do#`DfGzVxm}{V!q>41Fe%O!J7ioaJX7J*T zIezU9H>agj%Hqu;sRyyArhaqqF%q=y@q1@EL-4Cc-4^J8>Sy6Ad=+-lO6PilfM1k= zEB8MAz1M2hcIxQ&FY$vf9`3^*hqhID%-ikU=(qmvf&NRwxhVTdldQ?mD zB|}~6z;6@b-O5#8i7oWZk!yY0L|xl8w-^6EpB~qz*sFVZR?E*!;b@od&rdjq&3n{F zhm5h@26_UBx8@SX9eYeLYS1hM=@tzH{h5|#xR5AWib{jtAyc{%uxqjPQjJc_W_on6 zlj=+x6*dbhSPiE_lZ^qARbtTx{m_sFSc49E`y34aR4!@9ht=#xI8T1>wLEhEi$b$G0E4t(AOVke~Z)SPmBe;#Ye z;T7H+x8cmoCCEdsb=N^kB~=&)K6nDTXP|%isX{rJ;<3b#Rfv92*3>{SFFkW%46L3T zx{AEzJwATkI}RVc8RA{-X%POCZw&s)H^1~4xF$CCh#mM?h@WV$RQv$)MUmXmyWvC~ z0}}Y}frpUbQ;SYGz1Ew7UpEB} zG?kl9+@DJ>#0CS11Q*Wk|H)>&I^zC-15lRF1Ef^}sQ;opW|%ES=q~#F@I1oD$pZ`n zTr&{)Z`GF{m15r--Nw&4t&wwGitJ+LuE1;Rp)VuAJ67RBIiA!-1;@vr#k#`q5LtM_ z6@OJ`H#soXl&ps7z}y=JZPj6zu3l8vAbOpxZEU*kU4qSfN`j7UlPwrdB`kz+elTfb=8iAALKdPXvQ|A(e$pG!0r9*`yx#N!CzTzk zkR;J)F`Do==}48Cnsg;Qy5jp?ZD8HfbvQby>lF`sTfqB68fmV(V8%8~8tFK`PDE8^ zo6TTAVZMbRO;kB(4OTF=`0$(`FWTna-D%fn=u|h;jvLMb{9Fv;uoH^*YodXm`}A)Y z3AUvVc$sK1c0*5&fGyU(VO5BD3~aacdjYJf-}xOWdN&2?XmJF$jVPi9(qIoJUDVmS zt9@6BliiK}s6f{I0&W9AGF20k>p`kvtSOwd5jc%q{2NXw?i!z(wT$iuj)k&zlfUCP zNvX^ICtk@v{)x7ke{xNcTrt%99@m*$F_E4uC3B__AAh7jEH9aOe*x6bcG3KOs6N3HI6lJ5Yj-&IE%U2y+UBfLiW#Q9hp?TSQ6xul zC9qkv6ozm*6<*LMuHLfnLy9X`B9j=&=vhOQS%Js4#SDuKm-sG^0;`ds#k7OY z3q!lYy{|c`&Vx#<^B~%1E6jgh32E#hG_O^%-+G-ZdS>so#vl%+I5bnE-RNr2lUR+_ z{4vs^MxpJZzfel>A*NySjIj#2NRh}V0;w%&U0>TCF(tYV6Jqa`MqPkue$BtImYWri zEwyMFs(2((_Kgn()ZAwmP!-h28K}8zKL?ue>Xl6}ci7o|S~i^yis42om@B-ca&Ca* zt|j=ZN3Lwy@8#dM3+6w$r1)!s#UICP6IqGhwLVD6A?n+#$5$+0$1>2F%_pBg-k$CD zLl;UXj*J;1Nf#%S614DB7qZ{mf~SHF3ETc5^n$`Lk&?5fh$8!aOc06UN(KU;Gx)fc z(sP9qkX=H@#mYDCAiMy@X9F+3OwSn*F%>|h3V=`)@UP&iO*uHZL8s)1T%_B_TGlP? zaUah0Qm6rI=A)S146{x%+$4!Y_Y7qG^=c@C4Z)qYdL*7D~$4+7ZcQlUcYL&5AOuO}(3t_z)=7Nqi2`BCaY1(m2)F)tk1 znyp)dd&Oi;0hGSVjGgIh%JH$x8P_=V(w(E}E&Cg>M{z}$IS^t4CxI>*NH@tpDp*Fq zCKhNDv%``cDW3gZ6$R-4=R-)?ROF6@Cr+`Ss%MGRQ)xHR@J|a#v8WyK>yUdGzN|U3e6dZ z>0i1`QzN2lAhR#_Hu_uBr=v0gv$W0=bZIYP^J?XKV*?)eAjJ8WgvM#R0J0w z-!9ew1t|3i-myf8X^n6y{spBpeuXi5!vmUxdCeGr90(9!AGE2 ze+sBMQUFrt6QT)%e^C(XS609bz1OMsBeIWQc#V(G@f*FJ0zolyr3C+Z4n8fSZf$F5 zis$!zU7p{84Rm2tUVlen!XAMN@9fu~>p7};%ma}TlHu@V!n0%DM45qH9RMoUO$z4+ z^oCJI^bGl)Jx>#7qn#%(eSUN}9$Gk|r%*d=`6hO0(w^M2aC%LT8EwP01ly3K%Yx)L zeH%R}ryuB_=e=x4a@N6}wavDw#Lq+pGLvAukxqXRd&1#)q8aT8^%M@K+4mht{Q=$q z=wdZ$!F^Gbe$@=Q$>n{c(9r$@rIsaySvq!)mz^vKq)`M?7AxEIQQah~-y)O1kP%C8 z&l?gGqUe=AyMj8rDhUU&UfRBSEAo= zSrOm7S4DyJ##@!O3s8cJXtr$gooavpb=tPZoYEsZX~ z*O*<-;|m5$uaKi$L(iDA*mymmC%pz{o+aFTx$QfE-W_5-(6U!f6nel*07_I+&g|>> zQy9TNqVP=wrOq0bhCi7$y&pc15I3Y7bf6jq3~CQ*_kQJy+n?e$$OXmxotqaQ)usYK zRS=*G0Q*IFFanlN`Z%nLkb+C_&IhXwcaj+iF# zirjob>!bz5BIFwFBBnnj(Cky*Bi6$VS;o1bK{Le5Cq8+EMrZ(e1ACLKHwg?Czz=p3 zQrc@OVXhkC5L--a^ynASVM)QqH~an^jPI_&@W$&F&g-#@ReCoY>QWOTRa#tVJ-y;H z>2ZeTH@`uP(q#CuP=GvW;I^UBe_EbAyzol^os2Q} z*@n$gO=#?wo09u?f$vSY6JHvReu#w!sbOt&%-jtEzJp0~ zsg$gD#y57)FxL_v3aU%4PFViTm4RJADMF09^TW)~NIkcvYARq=q-x~knfg7&-5>oT3!H_-`QJa9zIOfJd2IckTBd@> zHS7OIph?=SIYLil_2?Bw0vJ~S?~oJD2oMLY=fSHpLk#6>SS_{K zS5S2ySjCD5-h<8SJ>f`bD7T?qY_ie>zL*TyV>(nt(VT|cgYa8{Y@Zz^G(z{xd+x;R z-PXDQfy@RdJ*qdAnO6_I5zDG|Yz6~=14qXCCJZupU}siBt7eM>syK%%NBYs+z=K{X zLd_;5NPMFGdJ5hHxX_H1&YeT?!ArSNO}*C0tkJRr)QrI^Xg5;Ni~pup(=Qa+qvwjz z4F+q|wtq7kb%S8lxb}a;^*>VP{yY7HdC=RX|H);Er7O19#=KDXyF&@suu(7}D z;~8%b2PVqp4T6nd{113g5TJ50i4$^|rQcfRg#sMywXxNl)@mu(!@>>NpG+F-%l!X; zrz^j9`fI3nJA&+YUwnq1(9z=umJ+$Avp6LW^`EqIecnD`GR&u;vaqM&1`Yrd_;@fU zaKnepn&7wySYbje@)jR_T2>8<#C$Lla5(M)Y)^jSD=@OBZ?B;J#dMZ(ahn0hPq`8O z+mI7y0FbYZ1_GeK2)_twK=`Ak!DM`V8}APLbpwX6aFg%W<93VOt;2T#f!Q*D9o83! zoANf~oN9sVJ7VTLh3}Fk`+jz=*ywCpojNG5tG=HaS?WS(y z`f*}xq#`wYFFC)%1wM$CuXS4BV6$qE@qAb`J97QSri&KUR0cS`(QQ0yqwcf%9oN4n zM*Ao1$Svc)C#K^r9GOO5QPfDpJuiejWM4B`DwscYt@n=LjXIr zPNynioe|CXoZR}OC7LnVK}n8Wuc9QlL_b(avjmEAZkXzMqbI7ie|Qs5>B|;_-?{}F z+9EiOXr|#GOgsF8=}JA_uWrbYJ?Na8K2>t~w&0+*=Heq{iC*(QWC6cIaBqYVp^_k2n;(=0Zn~i;RZ_kI0f`QOFhHRIyivfsUQU)jetrKL zuiJt39HF!>vrOw1&SE!3ejbL)YVPQh%@9{as}qUiEl&G?Zn85w3c&93?aPe zbGEkR;xK-|&B9pN(T_|`d2`l}*M?fHPk&B@#f0oa*=^Y2cCpUtwRkVVz7&SE8{4dF zhvQ?dwaX5+Sf~iA%4%OtU+uPs5nm$6jv+cMsOMCJj_Rtlv9**dVcgKpucXC*S4K?o ziOewbDUfCo5gaFYef@v9`U{{qx29_t9^5@R!QDML1h?RB!6mr6yNBSefrQ{raCdii z2DicWo1ByLKKK7$1+xpPsH^DJtGjo1@80Z@Jnvh!j9Z?+9W`xdM@PGO3m=ax7`>TC zgDw}dMvyhJ`$CKA>grUjfZl5<_nxQB!Qn!3EBB|~ECX}==v?Ck!OlNP?xBtd?aKz1 z=I$>%C<3tRL2d+HHx^8#{4gX>w0$%ZAgqYjTJ?pH*?OWX2 zT|C$X&ppQ$jX6fM$CQZ`b6IQUCC%U^TQXQll$C+{ZZJ+b54k4L0XG*}Uy){InxxIsvcJ4T(lAQwy|SQZMl?7g+qyk5N!ym}1L zX)K+!=HYs~^Ng$z@en+q0O)It;ZQEFO5Ls%(C0GWih#k|Ue-Ad$5&KiqLw&nxC~{e zuXJt`?N;~X7Sq`4iN+R(R;P$>T9JVyq@>s@=SjePF9p&p7{G-Smtsp^CfQ-0OOVqg zSQuW&J|#OWPl1CF0a7;3HI=^Ppt9Okv{;ta?|!0-AlDYH*f!ZJEN1c>HeyoAwK#i6 zryAoBaa(qC?u?RH)#WBJU}Pf;74T-Zl#kJ-op~}mvrba0B{Bo4K~fX>n_6htm}W_E zdY^o>)^T7dj`xXzwTe}CVEHgC%zeYYrIRP{Dd#d>)j|0JvJGCcVPERU+QH(d^iuc_ z?1q6}uARp8$3jhS%->cju#b|4n9eQA-n%KT{RXANJ?!(WeQYkX ztbH8hcC~o}3n0Ah)R1Cc6XRhga?krEJ-HhT3F_o`x7F>ZHv%m*%*1t6P65Arzd#&$ zW(2EID;cp{DX0k=lP91~hHs8e27WjLtk4rlpK5n?$jwdif!HRcsKN0Q2*g00)u>jC>cN5hPee*MFGWxwvKy50rM=~in+S2A; zs03YB0Ix`aZ&&wZ6C^wYOXsy_;U=Vytc#0>UjYo6V)_-GV%R@`q5XL~0FV|>7+k)h z)un52Cn)5W?z6mWo&V(|JJ4sy9~jI+yCSH+Qnf1J4+2&dn@BnDY_gJ|5G@FIM+sOS zk3;p?a6kg~0AIL>$qaDlDX)JJp~B98c&S0>9JY7$CfqA*_pxn3>h!LM?G0TJjSPhH zXqO`OcKDryBZ9-O#FF7gOH}XwtR;*Psye;>nlS0D9 zG}_5MEKD-b-2SFkR?V7k0haK;2nYNRC&AVpjBw4+C66C; z+`Ci29;8cRse%|^yty#cg#!$~kOfWWUBDk?MZgI_@WMuLWVUH{5rfcz zX!)U-OJR9~U%x3Acf9dOnum`}#9d5m#hEBp6E~&l4O%J%Aa~0MnDi0#PO249%5}oh zzALETVhUYBtA4G`BfPgp-q+szn%Q7E@-i0K(K6|=8MjrLCrK%NM1@x zzM~lqlUc!t%<}usF85uZVJ6DYh&nt0SRc=?v8gvj;!Iwi>=6dMnisOSJ@X#x!XkZ7Pno^FS-&7BQkAcd z-1#0Eq|lRt${=30E}8t9@3cmj5x=*#>QJyCp>~zSgYU%>30%5`SVZsrz~vwa#e^vk z-Dejt5`P{KH~{uL05yfwxUF3*KHDv=vO+UR|4H8!$Y1F^Y#gtOUfW#efe3pg^qB%+ z(S`&d5t1K3jQ_pE(&p`sUu8xrr&CgWtc~$W*bP*ulI=BF)c|@ zUzOeIG2Y(9#DR*4Ch!036IIifmF0**6rIg@QIXDi*u(NzR8iIzWWcbZgL4Azf6~Da zpR?UE?oarXI3yTi(~v5dslaJ~j6Ezsgir;!A6R7@s34&;=jP8^~p4WD&^LS|XT2Lv%R%bMeiYzNNJ-bKlHR)b9b~B)AWgv-$!rCId~JH`Pt#hbd%J8+Yj7q; zU;ZRG0yCeiRS=-IDqcw=;5_}Y^Rv?-nSb$vXCCXnyqEu9-V?TDqA5rE?142+6L4E8 z$5*r$ubdT-eOcnY?>WK0i3TP=jlI<19TX~BB#5lYMGCMPx-=pZN=E zFu)-?lBF~J0F657@HrP(F<~=&^a2#{k9t8|+yl@7sAd)Pi7?KWLwcLr2c>b)49Le0 zzr7h!%y%Zx0(pQ?RFh2s!(>`Mz+G=9G0>CaOR>*QZC|>VJ{_g@yV}9#;HE7cKR-Cl zcVQ010OdcVEOI9NNmrJIr27~KxAxEZ6hr<&V4q#0Dnki)TjhE#<` z-y6t2#2*88Qg(S%n$XRPgtAZFplUiK((E+#Z zgX-{)i2sz50RUr;k$K6>+1a(Vk9t#ATW!n0a?ctu=1{@b*y#SeGiL#_cFAM>h|iLh z&KYfX_n-QSkz1`3c04(ds=jYx+f@VwitNXX&mV`(h;TWq?cF{G(KGEwe}Qfpq>qc3 z;I*x2jlGeHUN~zL6F~)*d=)`xZLXbv$CW~%Lgn|JZEj1_u>GFGD-FH*QMVMe#?Nn=1yJ{5W8Yw;8AVPj^!S*Tn5N7I z+!5CjSa0vYrtbR)?eZy4b-Nt|7W-#^Blm?nUu=I28kLiIqfD#(Od{;sOH)k|>8p%-t~P>{)cr$RwdLQHXDR{HK<|B!CSU8 zdC&w3b7SED_g@Rv`F}h!2NJeq#9L9dvF$!1EXS(}P#wp4?#C--TWW7V!1X)mnev>ASDNF{tMrr0W1<_Q#p3c6;wG=c*j%zH6ror{bTB8QmllgYPyQtfe?%unuH8 z)h_Y?cmOBlkI$qTV(Ixy&?Ddxe*%gY!TTOUaFe$le4T%=1pHe#=yexpcc$)Zq=+i< zbRVQ{JFavCxem><^>h8`=WX!uT+nyzccGi4ZdVHLAk>S;20@X@iFJ2?^sbFLsEtE^ zNna0N6jrnWL&Tfq_^JJN>$ZxNu7+zjA2o9G>|7CvwewyX{GVtGFlQ{Knqys54knAJCe* zzVtEFZ}3tRUqoEYb-dmpsK zJ!O~O1m91ODc!3=wv_f*rabb{-H1ayoXDrA`sjiWn`L_l_{j08f0rj8a}9 zr_S%E>e?!mjwGA)x-IeSTZl`_HU!J}Uyl0xAF7Vdv8!uRt%+0GJbo}t(0nor0^M$@ z8QChXzum#00{I7j;5k_&Ch&Xm2z^fr?=3*k!GPFAMfrNkNbxSlSVTxlob3XJE<_4! z0tl#5cYo*Xl^ z=h2pNZ$^f!U)U$Z2egb2PbGB0BG@M_$x#JPU*eNbNhyd*S=2OvDXe{pWi1w6@MjPN5n^pvJ;}Ip~1MlS5#&(>& zy~r3Z)v`Ju&EW;QLHM&YbXonbZO-;&KJ7~P7VcxHc>?Rckrx6<*Dh$In?+DFB3RSL z?-3M49FX}a9Uhy)Pd@FvqZOvukMF$p5s`Ls&rwXc26TckCS<`p&W;3r8H2&k0_W3|YT@?iZHz zf<`+)a6(G8j;w9Dxi{wVaO{pmQ6o2w=sq%qu*_U=_;(u(^jFIbpq4V7O6=SPzpdfE zov2w0-*2MzB30M#Q;3n)(%IBCPw-e3g4Yttws`y&Wgn3cRosG{U-&h@bjddJJv`w? zP5VE1(Yyp@mBvg7-kD%0mbpNQC#m0wB^7LIcv#n8;A@==u!t6(bK&KL=i`?)n9UXZ#~k z0K_JEHD+#7b&N4?H+?8(<-w16J!|IofVmrE8>!RG92sYgu2&Gn07|t|L2bYDiUW=H zlRVp`B`8I^E&-%w(9C(D8_}3P5heo@$WP-EgXipiHqdwp6y{qa`_biCH)5rtu}c}O zIR6y)YMAo_yL~=Gn(jv_8j9J{Ee)_{i@+sq%BD(y`sLoAn6d(B=7+k-S1=i&}MMuHE`n&soQntX2U0t{M z#pVOPjSD^lt5mS)ILC??_&p0`(EZRBdXr7DsC4$=ofeAT37@=4nwn$ZIma*~FWtH5 zC~_|({gI82*7PG<a%dDNz%I&h6CtpkCbyWck*kgtr%l(FM*bN@B5#up@#2m}wZ{X6yS!n<}l@caa!i?n^)D^ub2s9*in9pLt#1wIC{vb{n`@fAo? zgj^mGGMiqYj}B>EvUV|E<%mk@!Pp@GOzlET_ZjKD<}<~`l8|`$n#bwy`4X|uE7QDx zrS1im`@a?|>HiS7jqJBOOWdBY0T+Q}r=YUWaMQ*;kG^+AJZ*nZ%&{CI1 z&t|slV!y#NE(9kQ#O0D_H8}v_93qtPdHDoZN%H^@fjAJC0=ejHfMd9?!qo7@5T|He zT|)}s01N=2{ip5$5hb}lJCPdkQ0B#X=FzGDq=#qdR!q!&8bwlU(y~YpGx2rt%*%PS+70YaD$B%st9?Mb4E3TKD z_O{!0ALCJ)8d2+iEdBs`eGo02FGxrnb6mT(XrdH;e%~mw>1d#cjco$Nj&2mq5~-g>6LJ^!JdIiiV45;P4Js_PU&4VuczGT2e29$+BVH@ie8YjJt3)O=)Bxcymtg0; zn)Pv7LA+_ya?Ik57SZap4YYkAY;x?UO(t#q>1<4?%68N6G~n?EbgNhxZ`);!0fA@-Dgxhv0d0?g=|JXXys-k zu?SeqpsGEn0K9Lq;iCg+lw?*{RRS5liZopoz4rnTXt5`wf1vp{T!VJuBu~ z@oaY|A-LVNVDwo&CDMMjTgP%eSH?{pbLHq2x-%#t#mWAern1mXP?#~0P(HV|WBDzv z-SZPsj=p2|M_kb?+u^?P2XqT&51`vc4qog09w@t^9ksAD4(t6K-Cu265mL4mrc*RbvXmpgVsX`Y+@RRGP#ZoKXxvs;Cs@=R280I_bPtCU z(WtaO+&4yJ17^Eox1e>2-Nh(pV!IJpsEneNbPe~_GckXDeusGvOs@ffdn zoj!|HS4Ivifd%?6$NuXC{hQynS9JaMNClq5TW4@r;R*aF!|x9K6P=Nkq4wQ~)dupj z-SCkeJn$eIDcC4|$06;xe_#+L3cL#0JkF60ysfH&#uvGUbaC$ z_!Fc3dC(z50Bo%F6|F1!JN@VS%OwM`-Z4^*AGj9Oj&r#bruq%LxqlzrNcP*sbaTzY zn)HN%oErokrnJK(=L_?I$6=)UBLO)!n*6w`fhew^kuSD;W}V|L@7s=^^{sCd8hZ__ z2k4@yqYL)S?M`>P z@pGA;4%lXCV$!meLW^s7;xqPtGS1RmVq9{|WZQ~O19Uvj+W(8kmL+EEM5}K8B*?1(whb%60)?sIR)+I=P6Za7#MwN)E+!^Nq}2ujCRmO}_g>upza+cMeT(@o$! z)PLyyj|H`}bIer5IHF+m(yC0qhpY7lH)k~g#WEB;_Y;YO9^l$QO}aqub{(rh=tDpW zO(@nTbf`zodb}7ZCC;%0JHmGhLq|BO{gskX)`uL$z)A46MEUlnf=HxNgifx7#a^kLys-N!7i8aI#I$J;BXpNVQQ zzFk zT(Z@f#;|;IwS}s=7=jo&Ph6QU&S3Azq9TOBGOIE{4#Y>g+6*^-?2j8RI@XHIq40Tg za(F~KKI3*-Ticm9r_RMo(*Z_OWFWRio-+YPN_h^2E40UN{TcuAuk5b{1y@Av?5xsT zI*^B0+Q3QJ4{75@o}s`TD?Yge?8_W`u(Ok@${$uFcXCnUjg%Ke4f62Y5(+0Zw9Q|{qn(9n{SP4k42A?Q>EIsa)~X&- zJ(`tXDRGfS8gchzbxpa9oPI7o#JK`Yp%axbwJc0tX0@ zWs~|Anghc7&Q}v_qmFOX?83tHSqBfn2`Hd9#>2p8hhr@v+Oo$Uf*viCteRn?zWMl! z2iMbQ2qMR}=*N!+A(q#yx3iT{iMKb}Z|)bB)V-I@AI^(-_jn)k-y|M{A61hhb(*zs z4{S8DK3zP=eXc^4vQ|%le~F@e4mS@A=biDYVSRC{G`8Un(O0*R(XN}y z@#Jd1%H1a1VXqEU2;1QE;6>x}z6MIgq21jOyE*DE1j@?!8nQl6jgobE7D4%e<@hgh zt^fJH-P&^Si4CNg855%O3P0!y+v4{G9=?HBf-Q@mKeX+pWm$X`tMbXr1{Tpt`^0_? z_&6vY>wyiickQM{9}me6C+(B_HD41l6RQfV{4$55AME^U`%XSo@B+sR?w@wfy4}mBPvOTyZ zc_zG4?|Jl0?)$pGPK9QXE7z-1^Z55m3!%@L!p(xXCO2lKQ}-{t`-H`k7eME4ZxdHIDtF~5XxA^?czA7Ma1t#ss&^so9Q}7tTCL@1!20I% zWWO6=JnI)vsE*2kCGKRaek}gE=50<-qe2A=zD~=@myDvi5%Du#;BTW6jt%@BNd;z( z{*d&3w54uY@f@kXKmpgthgF^FM%HiBZmj?+U%NL`|2v4c-d^BIRF^v@V^BpH#4d>i zhGCkrT~2;+hsmuzZb0?J`>hvqtQe|5+N#aGU(K~a#XpK#tsi9f+I1d6gxc&JT!k8 z81aQ3VYThYYitN(L3IRrQs0>bwk@RkW-RqVTav;GzcYz)le&I(D8-NLONB0^&z#GiBmuxW+v0d#+{MYR$ihSwmDNd#Cb4xe)=vlKKZ8QG^J%p z{!1sV#Y8c6Kce=DiE$#msceVurcQgptV8l(Bk8^K^NatUvzCt6JZP3d1DO6sdJ|D) zux>)tmykUG^VMwBUr>)X*u{S%FwO{c(88*B$1tV+Er!jgZ_a1OoIn%PVQrQsfvu(i zlUtT92IhRbzD)dzS}rOLl}MMF2C$c0AQ!HA2mV!SBNGdxqj67_0TNO#?qF2~K?YSg zlK@@BvjQ3q1{MUAXtx-72jghCoZLwZ-KmvaRYs2-r;9bDFN!8!gZ0-FL*pvg>Scl* zf>>Pj2A355rZ7gv=5AL;hzQcbr5I-IRJy-@SEG*CD?W{R&MZ(A^V25;%20EjLy#(1Fgh zb?F2C+YK72)Rilqs66p5coKG!%>9RU5s{AtD*RfVou8OtLcacPOzEastJ$EN$+1v&X`f{{p0N~a z+g}vN=V_Z;gZ+-_v}N1uJYs(AG8-EI4sK+{IxfcYSr;@SFcQrK=_f?(edZ`(|ic$teo}Haa!cN!+i^vw6p5o57-g0GT#Wcux%ywwI+dk zkLU1Io#bY^#cGhDr2 z2`+adv2G)4YKOx2d2|AergJNw7;QsNB2z1bTwZe@83kUg_K}A(iwx}IR{mApm%#g+ zC&7}}b&@6NE&H0my0W^fb_L-N^4gHZ-*b2+Kf){8Z;Dn=BV+Yy&o6f0QX=uGbCqyt z9nWt@lB>lk2O-Axu0n-RUn5D5CVCh@Nz1h8q4L3w#+mm~G)2eGiT{MV-Lrb3E+<-9 z@7^OwQ4}5#d|b28`v14|6}%qPXW$kIifQr@92y+jXIKKPA32!UsTm3$qx_A>C6aJ{ zqoC|v-thu~6%dv|oXBpF7isnnn0I`ZYIIjHq=6x$=3TZD!Po;;(SSbBa_1057w+_kzb&@ zH$rGyI;ds+RLbV9>0SqK8dilKY}Jqy3>&H?hqp^)8S$hB$2iYwNA0>6)ER4VJ}^G) zh~?r(35%Qh)GJR(RB?Ab5tTtO1D&!VYoo=9ndtrcZ95~v7`eZB_jGiZEHK)1=zm=7?%C-iKR z-kMrC?Rh8j3zw=j&vkd-3*ay3NlGx9b5y2Ch8!4p_|-hW9Y{Q9sXDbtQMIElYOH+w zeqUyZs2!$U%z2u+l!qgPTdgZ zlsP57X4%p#A@;_RY(*c5MP!(TRI6tvv+|_E!owG6%-5aZQHk?Dw$8vH1>?htnhFN~ z%=s^0c;PKF;62;&1Ss`h(ErlS=%7{i@=Dd!+At-LM;f-z*a&NCeT*V1xT#23eK6qq+2PeH|gxw_Y2;{1#LfAzu&+KQ{Q!!(1O%)T8j2gT0V=*>rB z6kg6-v(}ZR%y6n3xU#SiRM7Y{3TYC=Lw2C@=7kfmse>Af)G?4tNev*Y#Hqi(zwe#0bZo#sP6ZMGm9e=wohrSN z;%*0;!Tqvzgs+NE2h*Z~=-HeTBJiT=?oHpK;!Z|{wKSG_XTVXS< z8+f&sbIwExbimQ%RF7qLTE8!;zSM^r&M(M!Av3LgK^v{rHsLQA9Ldc+$SHepUP=wk z<7wI60_}*FmRb7y-#zR44##%6JQEbGDPpv*R0g*CyP_#?<}baG&tV3)MQ96K=D zO?;+dAVJwvC1?$>(vzL%24s0dvc6c|w4f=QgxUlOBJ^mmJ#pdOvK9&ze0A_T!8hZ; z+JN?&5Bu5%YrLtGLTR1zCgzk~i#?E!_l|8xO2N~96zTn{yn2V6JG?4FA~7fVsqQoX zqSbkO#GpLw3>;Q35K2ogd1X#Y9-PA}#V}YV-{$>Q(_QF2!PXwM`9OV{=SbwQ;t;oAa2p%|^?G_rBZ9JDvIE zCw{^$*r~h;t2%fqH}e0=j_PXgyCU99_Dy+;<~abl<`uo&U5NAJoAAWKfpdYc^kleI z{@HFvJ12U387=D+7YTqgyq{-cQM?JfGiC7HVQ1~vdl}A507g+GcLB9lnezpr7D>OJA)4b*3dp<6mz>LsG zgsHx@6M)+)0{$YL^>?DzpI*4#M0(TM2^A{hvm6e5VF;XD59?9eUVvS|sjLJlQF0@B-k=gbG=k3d9xX~CPAlL|l zbNetcf4~H%`U40p-;0tjo3DEs$TKxc4aa@P)rpKUg0II|VSQK*(M2@3J?WEXxyv43 z8butbwA}>?9R3WGY^gVI7}-F3{TRW`DtKq2cw#XSGGQ+h=d#WhA_jc(_kH ziu?Ai(pA%3r=YB`C8;ISj=7^;gCw`PbW!WRtl6gf_$b?TKI#C~7J5$4me4TSTi?2& z+_v0ueh|OlSi6J^wgWPU*Y)?wA`OIEw`19sR;lTU7KNL%K9tRTCcBwl=nxIFMAFb$ z{AN?$No($|tds870AG`m*Sl_%4xM0sGly*dZLTNS)nyX-BT3`dcIYwy+B)=p|JC{1 zt970AUYO-H$(c0%_f0`jv}gSAz%d(Z?qZK3-c;UN2PU?3>u#|@EOaN+nA$|fA>zAj zJPdh6$8xdc4CX;7B#zme)N?1+pjH%;!MmQ$r9&5JVR<*D3>%BRicO^$j4o#DFa6BJ z!gprzBr!G=hSD_P+qW4L?b9!etTwSAFuA3_(nE{j0LtW56R-oQVRFA1vYCpGAj|H3 zcU(Lh&@(Z`(+eML2%suTk#YEqnu1Fg%sdv=0?^c8O023Gp{(zo7{Qaz5x>U8*Mo61 z6jwFuOyqWYDzL=mR&jH1qI_$Z=vi@F?3?>`8!e1tODTo3f?vVaQ-6x2G6jVb7M4T= zDKr>^OWQ0GI_XJNZ&}~V)j5sCT$1n}CDzL^o=oq3gxf3J6%-Buu!()CGFByiOC;8{8K~QUQ9R!^|nw*v*NZl~~|oK&O=XjBd7&5$iKN0P?J*~^goz~4Z*o3!5ZVh0+J$tc(CrptgbbBGiSK20w+^pdFT z3{ct_(7aBHQ$Zxn`u59f=|FBn5KpHVq_?*{x~zojnFr#LX%3IgC~@NtD>{DzmOLwLf0$bK%`}l?yXHaL!(%mF7|;*SVj2CDO0M8t2WJ}F*`wJsw94|=t{m_M z>h~%EQbN3}56{}LzHvQUYPCR)d%iL*ee$KXU*lw;IAPL95(@EW9)O#B0QhwPim^2C zCnNwGcCiz&zM4qXv;1Q2XL5F`JXim&&FLqN{XXxCu}p(6%U3fjcdm^J#Ez~4dktq- zhq30|w#D3s%WVr>PWw8&=DI5W+=3V3jP=br&P>Y*i$$qFor`%|`zTPE%*Q9nuWBTW z&8@>{sDNS55i}{IuknMlTN1`^nTCr9KbiXLtq){g z($Mg0U477Cz$EDD=)?Gnqv!$fMbW3sq@7ZLGa{(vD^)z46P0_RG{y&UB1&2l>1Fy- zMkX8v$$-*2%dE>c#C$m^>g3jlxs`^7SPJQKasbkok3X}rk%k_W8wzF8bUo%vQ04WI zQNHvb=Jf`85YX_Rjq1yec6@Ryk+O8XFQbDkfRpc&NzD2NJ)a@=V@dB6hg{-1K}~$P z{92pBOe^9bs+^!Sj@wD^Gua#Pv!4+k06Et3n-x9l$M8#KAtKO+*=5nBw>Y)|+|1Dj z@X4%a%Ppz?rst@2sk_u6R41#@a5ST{+S7QOqRMdwTBt=d9E6n%;LkJ?e>mnZHMSRft%-chj>oL&9Z$fUm-S@KsSV>e{j(HL0J2oq^K2YT1QD(Us- z{6dcB4)NXCWs-JO1^D3gd14$*N^5;y$cLRowA@bz@r%W91EY^020unqX~?Duq3>Si z-Hknex_|a#Wy5$s5#a;}NuIU&M=!w-DF7e>UerYh?)7HIyu=wc^wU}d#b!X~IXSwm@b zH=gC-=?JWPCVgWKoCZw-@dbT+aSPsrKl?rqz31P?G>WvvY|Tv~m7t5AlUC^om_%=h zYV*?=oGh(F6j$zU5SIKFyz62GX@t?KdXG?U`riCX2A*@;;-DS<2y>-#b}$-39wwOd zij3Ud6kp$iwWmbdP|aBw?jupylsq(49w&8%sFBUV(ea)yEvg`cgyodFF?nYZG6m0p z_Jk->gQx7v*w5$paKeTV5O0Cs42O7y5CRgDL7q=# zr2;FAk@wg>JRpzMs#~2%gi2poPlFLPcr2vq<^o;zM7X=H7y#JxMxUo|j!r~iwR7Ag zr%{DX@Afi8*CBrt8Yn-J@=vVh#=a>4cBKfsJZD*AS(w=DdWI^E z$^3W5@%eu>G?5ByGiUHZT@AN(*mv)9?C`){!vB`vJb^LUFd*-B{HTi3z&49iF`9xl z>`i#!05$PMiGu3quRcB#SreN!+VnMQV@*czU-ZcYZdQqfP@V3^Zi(86g4-P*UF>5qffBiAhvp!e%`)E4qAzIrmD=TZxDq~(FUbCFF#ajP^27)&E<*+2t zQWOTEJ@e0^(c~R&-F=-lF9Y#yBC!`p9LX{d^k1oAzeOeCd!RG z*Cnr$lc8#k`qExz-g+DT+|W(+%u2F8zt?wt3^u)HV~M@(M6bl>Our!}td7>yV>K1{ z?aCM944SPbT)LQ?b25zRSImpebH%2rW@cDjW-cya1%2+W$K#dJ@Z-h&6%_@5af&&_ zh9Z|iz=cZFYwz#RiwUO24zac0U-qyf!IO=xmN7_0r)zh23(mG_4G=K~5x;9d^Jj2I ziPPt+yF?;$rhYvokW8qRj+@fuwmb-}A?2M^y-J?7>|n5mQ=Fh?e1wb&eFq*_2MLtn z!X~59nME6dtnkb7<@zBU4WKQI`G#hSZY9hYT3aX2ecOaeDuO+QSR}6g)3OvE<2yP< zTlR$zdfwSdo!u1nOk;+%d&o#r9ME%4&r{eod@6;a4}BN01O! z9L+IIV<%{18QzgHB?L16d=jjV|3(jZ(En;?G1yk`;PuOJ_&k}m zE_rzDn=5w0{KJBOxsd5Od3Ha{IHgIR2X0f#9KCvC?Gz=v92#`c7qA*r=}`3#gfHVV zn70@Rz>_v4 z<2?K5r679L29#&%oQfPd3;P8ga8 zt}uQXQfQfKf<6bj`n6CCcfEOXtjv5K5QzHVe8=bP>t|i7=1MIZoWqrUGs}F;&;R~& zJtkqJ8c{8Y_PNolR$uom<6O7lDI|R@97;MVPtZ{ytmAAoNBX{Y;y2T#Azmj0OnRaO zs&Dd$X5P_~o?~Udhc_)fGT@+LePli~2~{rf9X>WyeRqWfvjP?4{4VyBjv492-U69bQS?d5f#nNTZXsq@`iht z44dcmyIkm7OL_GZ%RW-CTMhr?w#`0TA8+EQy(e(vVgS^~&3Q^$=$OTwOI49Q>%RIHQ_xs0eHj!31S29V7wrlzk?h zhA>3z$1o}Wui`Sy)J47lGJ1xXLgEQi4EWb0(N~J$D+^6>FXRghP|JKZ{gsj@)Q!pb^|KI$8HVzVS8% zq%h4((ryw9=vKHArV{hc?DS_YHuAm#r2uR-oNqPPMx}l=JEeo3FyDsfP()Q z(J7?skMMx^7(&E?=>q~Fqy?fs`G5($yLRW+f>HGpdf1yB1t^--rMP^QTb`}!N2Dz$q9-CqtYH#j$J2@8q69YgNG_4R8jISY;7sX=tr!t$n2yvi9ug?X~FM403b+% z7tMhU0N^}6v>Y>FlH>l}OARdyB9RR62hES6F@b5Zfc-3gW%5u$dPMPXCCj{6WPt#c z`wYpe0)?W*xcrZO9J78!3-k)kfz~KHHoymPYb;+f|J~N7+ZWoYPmHQSwrBYr+!@}l z?8MJVERo}^ZgQgyBRY*Kjo8H&4=}Y?vKgsSYCBO#+ooxgXZ-1Yj66cQJPj)ZZ2hwh zC=(CPAg!UBF#a5Q5(1VFys@Llj){0-Lpykb(yL4TO%G1)sB$Z}>6tap>#OX>dmQ0+ zAYl6%Bgw#c?A1eTe0A-GWa_3W)zVA|Rx$$}wQzbDz0|Wm8roxE^KnO`k1*|vy(@a? zIzsfvTB<$2M=J57iv?m~2cS4@AYSh3;F0mvh!%WO0#JY*f z>Gd9uD0d7grJ;(X?rEt8bYX8?-q5a?GXvUO22w35$X8XQ@ zX&?B|>Cv80-R5ou5C-Blq9Newm4)j9hdMEMqcydZK3Q4+$PPb~3BqHTc;JxIDwJn!Mec5*Rz>lQ5c@G5bq+ecHptrHPb=2`F zQ(B%FRpVDyyV2!2z`RsG84QsKReKoM@IR=nfwl3k-*ostMwrScf0NfvKakPZ*Z#t5 zHk5h+Yw<4|{>hQq^Y7o){n_J~q1KLMO-Qh!hlPJ#K+83~ewpAA6AF8SMArJ!Al{f* zvJ@?V0EGk+BV`OKrBA-=lt3N!y&KHT zyMPdZdFC{K#lBd0QXi`dZQmI3(UrJo!mHUhTU^&LzHZx1`Ow$+Tf+S2SG;eTB{A{j zodH>sCt(P*{a{&22((|$+cVqUC&ZkUmG$Qx|M7mWyN=BPqT02G4Oq=(a*n>^gHvlE z@0n5aMuYY$x=5Xo39RtB@|4J@l!%#G(3tyL%Q)9c^lfy@7Q4*ZM*loFg>Z5P+nL__ z(fb5{G5+c|4{Hu!ZbqFfmC3G+Mx9C(|-yg4v z47&RHnn3MmwrZNky1b*Do;S35EUva2g4{4QjhNNJNWb>Zu9oo$ZvmeB?*Ff7JhM z=jm?3ddd5+5fix?ff-zYpoeU~1T&VQR08>QC9F~S)W(7#=K}xtqo?8flx@P(#A$f- zZqelj+^k()U!4~0RU4(|YEipDRb_0^_A1Gu*FOZ%%0fg8tTJH~5X3bs*p5@vABzHX zl>uZt^9~dki1wky7MBj82e>&l=QwSU`eY3Qk{dXu`6wtZ@c4diWAg=vgp`7{V>>qb zEHh<1hcKd4G-Tgq%B=I!F8rEb&^VyxU1!^mF!q1f{%k70h{J&k!hEo7D3YVnNW_7l zaN{Ph`Pv1=c$pMj=W!s`Igu7eBsu{y)!PjoihXS?`)e;n~C}vhF)G$b*XNfO=q=yxbs7k1!^4t zrzf%3--|$zQ4Fv{Esi+;Aa6KAkAZ}u{DE8zUI!64Y?aEERC1rBmu!QW!nZy>Gy^l4 z5y)#%nKz9|Mlf^1M+KE(%@E`*Kb|6L-a84n2t0dD|uJO?pQ z{bhd4n*_U(0iJs~r|*)K(8b1@8sqc!g5c7-B;pgx)c>!2lmGc|`CxmrHI|yh<#Q5( zt!-9*`NP>q`u;!dBNn|K=3nT#_HjgaQ~y=(5k8 z5RAiJXO+G=vNRGq>AjcKPKx6OdM06_bq+U&s+aaUI1Biz_e8}25&-Nf06+>n1ptMG z0^aJ%`WHpT&JJ)!!dG&BYI&cK+cG-mA>{d%>l&#T;W=rl4u|Ux34Eb+2+t>@3_)^y zAQO$hU4hx~02BFUIos>S6CX_d4ftC(HaDYNptsQJnQyr6%B?A0;`z!pYr^>1N>A^5 z_~^?Ox-SLtXj5{CO6%6E-K2IEi+*Tgtzua_cJH16;m@Frkj20 z{_K*zbtBA#0vvX4d_}g8Nnbs!Rhh1Smr|*E<=@?xbv04^V1jugdCKLqnBBigdEHE3 zq-HbTXbfRg?z+0>J0kUn7!hdTD=Ar{97d5@3b_eR*%ANQo^(Ham=Ov-|%0%kh zC?Bl2vXaR1e11R3QYe{C;jPv5xI9OTf~F-A6}T+gpo9HEy?#?#ACo}kioZp@pHIT} zFn<3DaLkpYi}n?#sqSY_aE+<697$NIBTgkz60HXuxUn;#|6KMFOmjIMkSY8CYQ79I z^6J9400bfIQk}%hsc((*M=|uKwp)ckLY=Heha**8yv90~kahw}9OT8B`D<^o{p1A? zCIAJdSu9`ZM6wt|I%{N%^m^?1WMbdgCB9DReYs9Z_7CZK3hMiNUeCK;4(eOT)E}vL z)dy-3a2&$_&7~YTPD)(pRjhWcsg|PW6mYO3vPo=LZRUPkqdu8Yw59fdIEF5ODxsGo z!>ldEQvN9+oCbM?y&cam>MpBd+v|es6lLWaF@xVmWwf_|W#%;@&j&=7MQUZs`0X`8}9HK_EkxTxJ zah|`yiGSwax+`D7co4%+O@K1;*`r4o|9=5Ai<#1|f?X^hQlGM3;8?Aq=1ai6jzHeA z{Nq2q(f;TnynILmowE<^4;OvqKg+^SF z{82U1&+g5#duaa5<+aG+N0mJ^N=BEqQDW z>XYB%OzT6jbXcc_O-~}BfX8Ws(7*;Nspf`y-l@f0pbe-0VV2JZI_|SYX4p9fZnnu( z&_`0#U)d+Kd!%bD#QyIuqR&pe*)OiINWA-B&h}4^n}Q=iZVP(H3BIpOI<4ECxV*0z zN7#_=5c_%cOFuv^FG5;RcWzG+0kjkHCaQj^s`z?ic3H z`(_4jSdcsqW8!EK!U2ttByc{x5^)|cQsukfd^0UqKW7fHey{+f z402~A7#m~c)G;yz4)2diHz3fO`%NiGP&kFt|gj7LkSy_Z-OaI@Y~gV5ZXqZ!dLd9 zCuiaW{vH{h5WI$;#^@GUw#Y{hsqmX=;nc*l{=T3bEqdfyf=2 zO(vVEL()w9L>TKoW+g`Idv7Z&-1gn52}*+9daBm<&clZEWe#^|sl7G6t%_8s-teK> z7uj99c#v~l9oh8L?X&FfO;qU3Ufyp*tFcb^)C!bz@p-{j4*GB7jK`9{rkZzgms3hw zm$Kl**zcNbtz{3QPcKmpiMV_cHOiuVTWm;*e3_?6l3Uz6qo}|=Z090vS}0rF1nQ;n z*k4d;R$t%FkB>ao-scEAy*%qiD*CCacVoPv*tu@6{JVa>7_i4@lB}M%KRCU++@8t~ zBdsJz5jmu|y>|8yi{8Zy$58mwArFd-=&L&P;lQOZY%TyF_VGx(Q#>}gS;-;}352Ey z7#Ojr9-;U@1FtKhg>;G}LmLbzg*7NXC{+>y;9XrL9*Hq1DqGw~(GeZqcF<6T>lZ&V zOa(2C2lU6u$Zd*7`-j`k*X!~IO^8~jdO_5QGZ|M=$oTI|aXpGBQY+0iyGerf{0&qNP&wxCb61>3}+aPtzEGBe5r2lH`{TUfj{RXfR-tp~I9 zI^d`mOr4eM*0}4tNu+3A!5=j~5)EN?E z%n?f|!Q8b*NEFoQ+n`62W*j7D{0L1E4=6#>q}cQmG~=ax-Tb#!krnRcv*4B%w>4Pz z@dB0j;E`4sDiyTetGOK+V~|l}l9Sy|DQVUau9Kb0sQ9s}#y#`UavQ)$Wb^W41hh~Ko0h&e!Nic@gShA;p+v4=HS?KK|@s!#<4uF=%&C*9m%@LQJf9 zD6{B%Kq$*BknPm=ccGX)VQ}rvZwmm?DvbJujsg4&Z5?iQEXgV=dQ@>OG~#p8NWt*+ zPV~mY9stt=h~@vYQavT1to{z4lnn|}+uZ~&t1*N#tk_Db>TQwQ@|mslmIfflFbYLe$m-rFw$6j<%XHIyCp1>E7O(2wm^$@9XZJ zb5Wu^k=(sy2m~lT-YSI)0XyyJOj+FWY4G6=0E?Vj>|D}BBm;onA5-hQNDfrDxI+@q4AcS{?aL9yVBLMbAu6p0(^?RkILih;vB)a_ygYlMqXbPb1d(Cwb{x zS`r`CoH0~Nqz2KqQpMwgc&>Pxt}!0ZpWFzFqOb_<`el^T>D(P^%GFe|+{%QS);vmP zo9NC4m*vSt(R;9GPw1gKNj%D@j)dk2_KRm^2(z+qHGQb+F7Xi6M${OnRF6XKq_clo zE9&CK)ii{VIA#=JU(deZ=5aMJ*GL%0+My9Eid&UN@r58rK>ifU^CRVT$z|B@Rd==GciWknb-tCzsPIR}yo;V`?WYNB6hLG+EV4MtY*6&HoKQa?^I{-< zp}0%JjE62I$m$AVZCK=(+TQ$v13xaO5VuICg{@8wCCOk(maN{@c)&Pz?ZO;4FVg6qd#ZFX;I;17 zsN;Qpf2M>HT8d&ZLV_{u3kG($#fJ#mR&|6i-baL?i~?MtdxZl0f%GCly=DnyNKG!$ zj1hgI(~d~_V@`8w+R)sNnoMVOBQjwv(v)eV<)cuHt`Is$Sd(f*pfsX9szv>%(svh$8+DQAvJ&`3-sF zrX|C!7Tcd4s{%`~@J=5B{iHqs9Y4VV9ig01D<5TU=xm=>oYIBn;S%any(Ow zs?2Rvxv|2kE=fm6NAGISX5)?#1t&2235Ke-*U&KJ|3rf6%*7VzN7|7N1wS z4=ySyaw0qkV%DzXyU@85BOu$NAtmpZ`@RRqNQodS>#1qA-$f!4MS;K7?sfa@e{g9re@0G&QiD~Ti<#`BoE z&nm43)hqKs_4*(K6PV!L;Q|qGh3l~)@|DnJOiGv%db{SHHBAErpDywxdf}OCh3PEQ zT5-vG?Am9cg{3`_HN#@5M5V1XIyh(vyyf`ZKWP?YWXjE*Gg$EChy5Yoz+(8uVL4SK z8B1V5z+pLUUSGcm4emln!~lM;i>^YqgE`^Ba{iB}NO#h`M>3-1w@!SRolFgC`;{+= zh;?UQ?&~9 zj3p(zl`0b-X~ZmPkMTAU)$7_ z2JqM&)m&)7!C~6gdTy+EoPD*Y>3e&@vt>7CjNLcd! z{3yedOzuqY`958}=zAc!BPzncNhWi1duUfbT=smQ0Dd~CMV*ZnEg`d-puwptiAb0Y zc#aQ=Qx}V9FmNg+(WTk1qKSNU=dnG~d7z)?xewEy7YfmizDZs;oiQVM-io)e9+|3* zxW=^mHd+t5_zGB{51w%xTc8l}m^oGrgtIj}Kig|vdZ!Fr7|D`on|1%RM_>)=2M#0= z5OF*1815Ku4usQnADzwt5Yqx6O{%K!TVMv|JnT|4tyh}-qtm+7vXlEXyNP(p_=<)F z(1)(0&WE*rF#W*4U2LSX_`KP6n-$NpTD@3r!e;bCQ%f7=xX;V^Q$+)lYB&lJw{r%D zQ0$Mu7Wy%ei zNCi=DzjPOM%WK~-Trd-ZN5kWSQ~DR!Z_N1)#6%`VX@?U-X47UH>7=BjMOSy8WwTNY zY){<>Q{kfC2$xksFf`vtBaiLf5mJu5(nl0IZQdyj46TmddUCzQz7TIq2g{8U!~b3a zuHJ!kR!T5_kN!xEOszHa=3>SWyy`n?-le8o9T0p_GhFt;uwtPUMK>WK`lN;5@DbFP z$-iCqV_uuXuG5ZV95JSk-<=OJ=Jovi@-c781O|y4O!^TCFzm%^FbM_(d&3}vN)j*k z9M>Y4OEebM>R=GlIZbJXCK$f;-C&|p<-bUh4-kW{xsk3%SDHpt&6dHf+HU3S?4V_@MoWELm4HO| zftfRsT8T(bWfe=k8bdk?Dgu*YB{#7x?-Mmh)*=qQQ-*=5giD~$CXUEhhlfc{BE8$L zxn%TWwhpgXmF>JqNleKRfAp72%8r`1cXs~w;50Mydm5l6H(z95Kcsz4bvoJ20O5>?E&6c`B^!Ek zQMpjfZxRvHt@v}VJPsHp2@qTKsp@Kh!2)8e#(%0_t=SgUW2Ty8 z9Nax1NFf!)n%pO#q2xRiCdu2Vlzd@kp@DD#%{W7Wur(|fqBOLnEWL*U(z-?;KP)g^ zX-3C!CwGk%d4H2ym|sb+={z^l4z16H+UKb0m&J+WHiTzVpgdGyz(xAi%w{n92|#&> z>jzg=*4;FJqRrs*EPs!EZ?j1m>5c63czqhuZ^WFZ)P0E*((Ma>@cZ$4eOq>LALCU{PPiM|hzTqgkecGmNie@WhEw8>zifGV!8V7Yb z@qBHVwkURYLe_TQ-mG|Xxa%3>Un@uGFV=(%ZzyZLBdzXC=7vfZ<4^Lfk6~TMN!)!( zeDm-cT}k+r<;IO!@yAQ`cCDYSfSHFYL(rJP`4&HB*hk+L(oDWLed&2dlSuXGN(Oh) zjFIo#yXMr(TiS6un+b-Rk7|}bu0&MzF2TXM#aZ2yI7nFnT$UA)aY^~fJzkOB!nv9=4Jq6?0ng)C1q_^ z9KSt8WHttg&tF6o-Tj&aUg29|?9cSVd`$I4cfPr`F0F9(Sc$oHkE-zBS`+cr^X=S) z5s7HYqXtcf8?buUTXFs8+m8&8TMxBoZ_H6=la&v(&t<-4gHL(7ic)Ulsi_u*x`}Ix zs(S6#ux_mN$HBpATlj4ri~}j?d_N||`!Jyt_U!Eg-|Ss@kcXoA%*RK^&;A`?UweF> z-8;>L*?x9}M>8#_^3T|(wOV`kpDPc|!yV>T*ydNZ)&r?8Ed;w^eOst#p2348WS6i( zET_NsihXK5>^VT2u&4&l9Sh~$BE3&S`m0-lpWK~u>fe?EWxq3L=A@-Lr+GrIHpg)e z2y^k?EkTJzuLM!Rg)|YYot{X(Tt^2{fFpJkWD(&5o9~+!4?gJlCUHb$AP5=C$k!w3iRG|P7&rlAWLyQCVDASojFM`F`K6gYlaYgs>vvgVO<_D#IVQ)px$DG$DT zeiQJcl^Os+nM`1AWAlM5ei3#x6Yo!lKK36it-j>Mki53pgpRlyxGN&+pzm#TeR0`sy^W?kEj*({rGF)aOZ#s}952_>MbC0)I%qw$c04i*Cm%D~=zEZLo zwuD%|WzK4PeT18x8(UpI;&hLPT-$y65ZjP})Td%xwqfb!$MmY8B5? zfqvoZdR&%Pwu#$ig^2q8=x9Ep;L_C-zTb5WrYP3-yIS5j9`Dk|>kGfZ3z{{qkB0Wa zfKCq(?IN19e>Atjk=mf|gSjhP;0m3mcF$p0FtOnquq*BG%fk37%i@-oLh9(qSn>Y! z%qb-wRZ4mXW0f^@-m0*kL+#4}U%Mgl z2<3I@OcB9(WTckA(ljDIQ?`GA`H8kMvG_K@^X@nLOAN_ggk>cIT-*Rij)t=+=$FGS zliJ`i5_+a_Alk|9|VZQha$fecZ(uv8#fNN_JOW3*Ee|bC~|zdVe>2jcEwTO8HoHDk|fO7kFJm?4*ejBFY+ z2?-WoW$e?_I?M8kx`AH}PalodAVF|4g-SXJB3ivMCO-_N)s3;N;AbTiT)5vc{f*X^Exi#NbKrL5{w%vLz~FN?nJ;65B`>+qflkVgPiCL215d zhfZ!A2@}Bk2VPB|Qsx_dj%@``K%Q`+a0(AB&#(tyL%Hl8I)`jAx0>sPZ1FQZHXP5? zFP?8!Nc05CbH-aKS8@5=VL=p?g}fZv;QCbTagwYN=JXjG-{D0HMPU5l$&znS?+|0IM&eJA+ZwAUYkUP`?rae# zG(-OJ|ClN)|DlQhFg)?8Mra&zSyAa>|6(1RU%CGurV20dzMc&S7%L~7_wtC`9Y|~c z%f`>mJbBIuSMc&n77B!6fT0hS%|ns6kZfwnAr4!`1f4V6ISeb*Ug%B4Oa2wizXJjQ z4Xzpm+fNn%F}|}nCuhB&&S~GFF@x>Em@(F3+)`#&*>txQO7}y@aHYLs-SNH7t(E;` zZ6>5Or%HyEm6fyo&e__;wCsaEpZV9_F)-y>`6qS7QLBR0e#`g%83lbFR$V6Y&*I@h zyG$RpuCYQxKe}aM?5nYRs_4j$c)rV&$kL!z?)A0jG*RNBfa%t%H2}i>4Lo1saUZRx? z(IIs!PGEKIM$-lCe??r~46;czXE$LVo>CN#`O+;F3qt>rq|kon5~MXDcU$0n`O>9f zR+Sw%oE@#y*a!gl|eJzZT zpNph1I9#q6ET<_XBTC4ECGnP;96+|ZlCiRuaB!96>KX&${cfIEC{x9jON|`viA@&5 zx=P|a5i$_I_r>gStoI8YE9-~%zmg-b z^CD6w%Vxv!{D-zhbb{`)CN7Y6ggLVlBg?rNV-337+%9taf$%9P;?yTZA2A#g%C+Pv zDk%br`x+p7*Q3=8dTXF)$WYAW=yu@9xfKZ?a?0G47GQ7%k%VQF` zW{*Z$J4zNTHFFxeS}+ekntau3`CZ zI*nrZu+IOD#gBjI8*hnbRi9Jh0vl>m1G#_fbQu_l7lJjKaol-o1?RFbXmB?r2nMLJ zKqIkq_R{xVLXIK0j37l%B3>Xo!@!AYqQDAY2K?2bzjzHqz#XLdC%hJI7y$Xlclr>E z2L-f`efUQtc~RN=3#W>A8>*Lf?KadKk!PUTO#(T-6#O^5p}sJ#6I!^~CJ3&%;cy`7 z!}jv0ZKQC8>4BFyj1ld+mN`-*jira~?X??E_g`g$4f0B}UZ!>h=Q9Tn&T2~#^IS68 z_ksoY%ks-P4eQ}I@OMrJX9s?kvy&$0wKtZ&nJQe!?}ABs9&=egZv+TN&gFUSZEuzc z_2aYP2+`K}a@NwjZ0A3{r`DVp6NJ5YR{6Sg3*2~=)pW(A)^_HMqq z-jeuxz4?i4c%@0z17NLm9r zN?pcTar){YE`i?6b-+x`5z!i0lsIW1qlWf9GiqNK)c*j;BP)g@+NbLASi3?@rmuLD z^zs#VCXYm-qS9JMh;Vj=%rPZ7vm)=`r2DRZ6ITz1gBGe@tdSIp15Mciu19TB%d*mo zj#c2I%02Fq#ZKWp#+)f{s^SYj%R`01x){hpRaYoA^WOIQuw~%Djbics8Sl%M`1bp+ z^aQg#VD=Xj^Kg+1=np${#u!_e0N@BfY^x0s1Pma%(Kn*N3_cJryp<|Lag=ch?u0X9 z5mmsH{kGOIDHsq&gBXLm{nvE-2-()TEVnWkc#LhFxke2^Ld07BPx8P2XE(s-QzK`M z&wuR(OEk_RxASN^?Es%+=l{;9{MUav&$Ev$>mX_+6uwR{x!@)fV-TLO8C{>`P9(VQ zCm*vv5aMXnvYPuSa`3>G!-kD}AARK=3@9524kC2{IZ}9!9*`JKB*AikW!@D4J*Vb& zg_YDZ^%{`vAFD!BDf zOr+8bC_Kv+WkUnj<+Qu5%NmHV7ft%~mW%f*J#zmX$q0yo#m~A|P8fpZ=fvu#F!^vi z5qWJftanX9)_Xmktrz5D6_c*-|2ScN5!>0k#n%d`x!TvPrYzApkq^9X2dcgfc(Q00qGAdam&ekjaYKwsS@D@ z1YI~dt;JBwc|0Wuo$umWa3DI{Mdl}tPz1!^9G0gPD^%i9iR2VWSG<2*k07A*aWbFp z)>GOej6rxn7TTy3X|Mw9vv&|L5gn-=eUjU~dPxR23cH5B!;l3UvI>L2b))tOIoDWHP@;2wfIV`Pqt6UXyX1+mHeag`SSLHqdr>;3imjOB9JIPZNJ zx3%ou2lhTMGFo7NNVGSJD=!Xs&jqII=~cOf?z~3DlG9W($Gk&MB3*jI%-iC z!BF)Nv_3z@_9g>_une_GJq~s>noej{G?ecwAW4nd+Bp3e)eqNbY;-TJkU>eX{+c}^P@4JY*I8DxSUPXl~J!SUs(9_!elGb%7E8$pw4$Vob7+M z>)=1zl?V1qw#JgcIs8f#7;Ymi3V7S2d(~{?fmv_Due7I%p%bepaU!elZD*(gym1|X z2T9-C`y^(wt^pTZN^T7|Tf{b!o|Tye!HMx5e&+6B#%IBaCVUx$a_nH9pURMoT$(<3 za9c#q6Av8|a62iR#gd8W%Zl}}6qMgZv&938p^dAxAN;ol!Ks!y9M-!gA}S5)pUVlJ zFf4muEl;z=Bhh<90aFkpL05h%G|``{9H34#0EWGc6mTfcGHAjgba#bg-LgrCn8{F5 zO!bF@4<9Ib=0m_8ZKeeav?d?a-Sm^nBjCv@tJE#0REkaASd~>-e+{)9ijXxd#y@dQ z*oVen%5xT#n}gUmW$v6gE0g5L%D;-iPew@<3g*2ZHyFI9XN|tzJWmZ}$48OU=wmiLS2mUL<@t@|o@ukWSD9FMmNcGUR1Jc+3!)5?3+Wq`)#54@rRuIai4S>$127oDr`R| zpP>+*p6^v~hL=RSJ|Vcqc+oPt>+N5DL+{!3q|hwy%I;3F5KROANfeeDtDs0xc-uFo zrDt3Hc|Gh{&A()qWpE&^sji>(o)Q?*pHn7^shTu0$t|<%(2ccA zWw#e93EXj*keTZ+CkV3zJw8uwgOg#xEo8UQ;l##G0Yg8+@al{2`!)lP_w&G%Ka=r; zH>Py1k>e8RQ*K=186Os}b&kjLG^y^g0m0mAtC!@^H~&1SD-POvmoa*TXT z6MIl9P`72j4Jsph=-~{ZRRMGeW#82wnG&lMZnsLAmS3$Usq+Z@uE${8{z17i{0qzw z6$ftK8l~i)EM9TFh1}l@RsX=h<>@@XV!TWg|p4+6W*o>YTv;?kA$BjFo2q8hm`B9 z%l5Shih7p~;Xeaf)x^XQz*7049ssGX9`N@G>}^&3EerIpe2LMx#EjVC% znQ?4tWn~2&hRjIT2E3xWueCH&xDN8j6{5)tEP-yA9D|$&UBk~z?ClM6eX2(bUCosy zN)yV0QL*BZg%rk6YH+hg=mc>Y{giN1I@}T@HvRx{jhJiJ z?3>|$;%wE}~A;_PhugP4eE*x|OQ+s<;#=NLE1l%2mr7 zxZqGPSl5a`Cg#_eM?PG`o&~y&AM#oN`O3e+BFtdNF>Lsz6;ZF-DvO{73Y!opU-=*a z$&3w@uHH}+*O!G6Uab_BPyx6fSFw~OI6qVxThmomR+i`*BC9E@tEZ{~u&cp+=xZd@ z01&BIijOjLPzBYnPSwy`HV_~tm0TNOq;x?w%*c6|?hH8tuiGEG7CDClPp{2=Sz&&K z@HAY4-p?5bhKCE=1M3A-^AN`Uzb330aXE<%=~qfPOtEIazM6=KDKLpbc(uO3`kuxwJnj>Z>&3cHz<1n?o1 l6BM_)@MSq5+vN)YXI-Ot&sg2S8|R7OeUr-`4!6qlqya2nYzk7X+jf z3+y8Y0)qJQPVyuE37h=0}PXrgcDXw69f-z5(} zsz!GBoAak`e=HCX;79mJh7a`ePaTHjAB;coAAO)87$7QgA9Wf3`6d4|{LyXs!TRsI ze>&*f{ZA_MOKvt`d?xn zd0Po(8OdzOf6DzQ{f`CyV}buz;6E1lj|Kk!W`RHck zi$C)uhYD_*RCb{SsF~X{d*8wbN>fu33{zCkbWm5+J9>%ZuTz-=C3lIeC{ z=7Ut8ntjqSgi8L!1o0b_w33p4au_~CAF40PKK!Rvai%wtdoNyo^q7AHXV+L@>wqrX zKt+zZ0-2u2ZA;#tkZS@Rn|Ihc!Sw8gXU^apJlB-#bWik!Rwg6oh>mn>7EsvU?mlyM zzWMCHE4f~tSYC-_dgO22NMoLc`kd{VK67+sPBKy8cT@@|3!Da0)cN{9sg#~0{>@$5n%O40pPzi0RJxVZ+YO~8a_n+34dw$uL2$K z6~K$P|E3Z6;sxyZkbmF!le_r%eh@s;GfW_z6N;$|`*kiBS|7`@9GW$?mwBW3v*mAu?};yZWN)2nvt&%*@1TVX zgp))(%Yy81PGp-_51y`(PwHD1)-G9*9wxu!qQr6)1ON;pV~3kUGkyxnkQm0W&09H)A&;A#7nRGiPQV{_lL@@6S_&*aRr(|RQTIqRiIVY+E1mM z#7ScIVaUX+)Am8UtM#b36+5Ygi^Y-c$(}fc34bF}toaGC34$;lFloxn$qtP+sIwBf zJz{BK=u?YF(U88acRoBt8JSrUV7o6Amef?bYP*Eupv%?)=H)slV8lQS>^>+te<>`% ztMb|3;i*iJ?yC zjOuDU`nDPO-7g}3hepJy#l#eC2JKaW83?y&YE|Cj#pFRXwN#Z5(ReJs1(a}feA zM8jodzzpYzVs0=<8WV*GEeQ0IOYSW2y89^C%H&J4MX}v^t4`pdS`~SHhu_Z(9#gGx z@0IH&lpg=3J%)*|RfN;!PlwfX)HWTHXse)c8yW@@I!CHKL-onGNZE*N z)r8~O@I@AJ>I=sIVuk<5C;<^XNPL2v%RvX*A_0W(M?;cBNqgsv?Uwf!!lg;WeRqHz z=*TXMf)euaHu(<1zX>Aq&UB66)C=80;KRQ+xM}YL%^b72OS%W4_WfPv*0m&PK@N%4 zu^e$PoQ82C9v}FUl`Ek^%`iL(5E4*{fI5wPbq|y89H+PTceyfBe}*cG(44#U%msfZ z`}G(Z7N{a=s~i5Ukex|lX+X1^0WNlnt+htGl`TI0oDvOAXPv?ATC=hSQyeLZ0;YC; z;Y*1E#;b12C)U03W3(-6QKnrH|2?@H_!8gfUq@1^c7idzF3LDau2g?pruPF<%H3%; zymRovoOvOjI8X65vQ}=%y&;l3H*rE?as^4*3@~P)!!QyQ4|Tgp9w$4H`b9f2!Eo#AJwXJ78I|xC@pVp?M-3QV!H5baiBO`V1dk+ zNP}^zb*Nmy9gOUe%Io}Y`Tiw&T;dMx-r_rQu1hXXE9TgKNE(^TvgpMoAxZg*lj{Ri zG@%~&ZeEzaR*+MDtC)-y!W79K)z88q1z5Z|)9EB~#}T0XCcHh%fq-(r z3OnWevCE_ZQ^ZQdr7PFM*9bJ-NGTJ?i@|LSIt#w^*lTc@Uo&QH-I7xnsSj$t#NQ~cd}LLbiXzqKBu{pdl_6;#m`#GJNuS^f;#@Ny|a>ip&-?bO>o zC_OqK!Yb2fFSL?fAHwGRXCA3q(?WHnn^lcBWkwnAK2r!|5o<8e6{2;vOhLto6vrs1 z=}5^2;?7N<+>!E8iD~V`A48@5Jl-DASYU-o;d$fHOt^FO^WeFvG@u18sheCOy&?@K zhLM?T8v6#ZSx9F9fkdt^YYWDo-Rxzh$FUUAd~GMYVWaViLl5+q8(Hw zGf{&J^t}#VrNYMt)>PdjAON;JTcefRTgqhjeTd&D!=+@=@>8Ajiw(l{M;+l+3wZur zysWl^^{p_3v~gbQEtlF>*j4uMt? z2j^JNFQT}jJ$jDAPAaFlrNpHnH93++ z|ETUxu_$72H81^2a9y%aj0}C+$&;0`Oue_5{D}%vR6PU%;$DKt&>fRyzH7<$y-pjk z*iHsD35&Oa`Ol^20Ryi4C<`-Z?6!_z zE?GG3hq^d{)h2M{B=_V?ft_0)nBixIZlkrlpQE4byYR-+v4>t!%M+Jm-m21Zhn{4C zB^~7sB^-40ay$7uJH@u^@I5Ijr&c9%x|%oUnqY8WN6BJ}53L$bg_j=)jh2EsbNvY~ ztJ&6Vl%1qeFSfyX1F-=SlqruWw>jomp%jMKYsX{Crfjb+usInohPIZqn)2XQXO0x_ zygi@j{T@&ivW?EMGigksq1C;4lj6)!Qj!(J$fW9s{<%^p>TecbJKn+ot?8k zv<)O(#7GB##`EDDPh=Qlp$^ z3Ck_nY+>iNUWS^P{S8}Dozatahn$=U+YnBbV?S)=I)335S7w;V%w*zpOu9nhY;TXS zi{1!%@39C&Zlt#la-`yWK?6c_30$R)Yb~x*mQ-6Y2?Bz>d8lX(;XQ7i|vp+Dfg|^XkCMRz-Yk4y|yltp*@!dG= z1KsPudFPt;hE}8dMjRZs>jpCg(T;qhmuTPtmmVBjRLS&N&M+Mw1`{u6OM^dGd!rU! zj}Cn#dB~b)de3&@{T+6cw_Yi>ClI5Pri2eEJbX5w3uVtUeXAXn+RL*;_L-?(utkGr zOoKd!`<0WZ8Icaz=sMj&W)*W&Bq3eh0q&VbMk;*NuSiq;fmmIpyPOZ^0z2p1zx)|E z2uO!JP5Q(?qnN>pd)o#6>v%qEc|L2w#&M=9Af2v-;$bQ{_L?H~jZ@$%ltYvc?%^5e z$jxS&h#2!aMT3fnPy!cVJy1hvzKyeySst>JNrN`lmxYYDN-3}5hG7^Je}hO&s4~c; zSr0>F5+BeXVJ$+_spkrnE_b%nNfEl`fn`-yu@@R3spclFXgqyvsUBCmP>p%6jB!Zg zVaEY99A=?Vk#GOuH}2&r5@J#A#OB-{&1$hr07LVbDiT2$B()W7Za09BiX-D~FAM9- zd{`tt)gqdOx`h;?mH7QvUQsa}m!gD;-b0q{Sk+bqYz-jsz@VIF`lpTTmq?X?5-k41 zl=D=+cz--Fe8Ky!tArca2FuBJOc-Gg%~ztMsv&+^p?h)FcmMLV=c>7NI28kMduw4uDf1X z@|@^F7#@qAVV9|0-upBZT|_9E6uQeBK$)%GFo3^cvDo4fz z9TzEch}k-`2Gk`_Y#8!;^@HjnHMC>8?aUt531)BC-HkQ5iN>krdvaD)mWz=<*Zxj; zi7Rg6bK)L5o!DZ(bxgHJSytLugEA5b+Pvs6?kn};u}EON`rE7troLq5!KG-u9|d>yKv_)3{fdIbtc65LOY4yW z*VEy~^327* z$ZINT1ZdH#f>aVbN%+)5p-Wy)bV!cVcE2G3Av#libgIqD$Y>+?QuWw!V-!+Cv*BD^ zqdYpoY@lk@f7YwF5>o7;oTt3E?CVQkSmsQrjKvXBiWp&Ur&QeJxL+cx&<9{vRMBQ$ zw&NopN6QX2?mu?Cx3DOq1lj1k zNYhQGvV#VzUlNL;``T=>k_PIYFVhy8NBxI?9tB zFG){+$ZTgcR*}&0H)L|sy!sgF1$N1o*dC6xrQ$XxP_gSo);7#n=Dkzcm$so~lnwp8 zcy31b3HRQ4DKWek^WtWbNmU9n0d}ZNMNSo`t%*#MMH^#IDcAG+n>8EiU-C79Y|31f zuUk7q_(mpOW*)HZBx|{gL9XffkKX^D&w4XB&`D0}+aSzn%v~~zEIQd zN9_|Sw2w=CTYY3^|887!imnm%Ef%CzZ#fTsv}(b&)hMIYC`-RTilC&+uIRb#~p*d3$t7gCQbXk&l9c+Xc$7t*GH# zz0y@m$xtA4{rri}=e;9FIzbgut$HHY#F$G2b#FBr*nkSYH+bAE6Osdo+|@2#tg7tZ z8GgL*ul!oius3H2G*6v2L9M@!p=Jb*wM^743DL1ik(>Q6#g9f{VY(H=n$7Wz`^f)B z?^Os8kk$|MZprip!#E2wJFml2_Ivt$J=dx| z_ppDhUIMPYf4ZDc# zavd~5s6?~q?aJq5tkALi`#koW5m%w)3cFMZ?7-+{G@9GIc#8Q2k%{`tXNvZmrFwn? zWtz`gv)g%W^UNgT{tZL4iQz1oYc~+A*j>tTxL&J@W-*4YKgPgKI@W5W!BkvrCZXHG zv(FDAbO%E6W}`}gOsmk?vvXQJM~iyBoHmvj7CcEWXP56IGod>d zt~qy5U`cuTQ{1z?w}$iBHFo}V+1(kX?8Y}*v{I`L57JCtN1@-KX{^nwsAoFH-pXgt z$ZCEpO-^=u8ZDMGDU*WVk-bRpdD#v6Qe zB7bOZTHTP)4Uec$Tz`+wK;{K{KP?Y!derhNuI0AW8nYgg_af^^Z}gwp!rr4qx?A%9 z;?!4*NLb&HujH+B9kZ1;Zg?!!DZ&{ks7dDk%e}WQK1!*7>O2(!!7l-9ZhffMecXn zUN36iGA#=nzkpMQcjfwxYd4M|Vj*_%SVNY5eF+6>`f$W-{@qQTdU@GUWxa(Nh~Vit z_lrab^|=L0h@pZ;22cUcY_IO3zt2Qz)&;3+yfh{4A*@T_j$bT1Ders5MczHtk7SF5 zz1*eie5z(1%4BY{<{J3cOxrSWiMvOJ-*>N+KS~$dH6bs+UbrfN5*ayrnmRR1N`CgB zFK%AG-;iv^>Q5?vAVqw)b(>FZmVa8k7VP7XV;6_0SV_i@0UphnhUU?(m>-}PU(0u# zzV%CnB^){6GB?U8dGOm7$REwEh!nq=j*q&NvzschV!!_+gg%46y3=ND_Ew7jY&n&s zQY2Wjj9-h!i8C;;c}f>on4RaTNie+@J66x#LR~nZ8gb1%U=tY&jAjo;oi`@4cQk zSk3%`bCWWmVmIf?m{I)GL1T#wWkl1cYD+$CYtG_EQ)Nuv^tk7w-}u2EtA}qYd78^3 zlX;qp(442NcddGo)$v{a<-Wq92wBZc``bvu3mKU_`_2Sln7Ye%}LSGd4ZP$0fgIc08hD}y}E*17;ur?5RE~WqEDjG7q3}T%sx?4Vw-b5 zUS3l=h}sAshXW+zO7GRBJXI?t_l5kFQl3M}nBt~DiML8kt?wV9w<6}1#+$&Gi2gcv zsTNV5TL`$0@{Xi_M;Kd4&(Ty19lCd*b@x2k9Gj#H+8NsxZH90HU^U+;8!<$jGkTOE zpdG4M+T3XkKjbvNveuN^)ulKk%c*lGG_ zP2%ml+T}O!Yj*cO?MMB>-nv}KaBs8A=D{92D_%Foqt)pB^}~6YIZu{fG?aigI}s`TPqcbx|sSi{1Owsp08m|Q-)=S$V31gL++{D!No4RULzoF zI!@xMkVX2PAc?66LxScf^FGTcRga=#3AYu z-L?;j1YcxCzs|=HgGE~OQLj`Q#?yT-gZt?Lfn{?8g}6t?ns?WV#8=D-e&C}~zxRSb z9=!fCfKM$TiFfj`COLxhtQ{^=76Qb{nElJEDSfO-D*iuSEp@`#*In0H$}K4q{y?T+ zppfP>-d4n6(6W_Ti3jO>#rFCvJ3Q5b&z7%;3#7-y?77wZnYj5I&CvVc{nryG;G21B zqyYPY-L{4yQ;F-R{<^YH5WU7jn65QpS(4>{81iH=YWAoxR)8Z8pZy%}0{9%a%O z^L-xk_z$`Lp+ykwaR30ToiAvt4yp7#`*0gGIj+0rNCgR(Zgn`7{XCM7`gtDC@Xhd%T+;g(0wdRNY$om~23!zlhCrML};qXJi_Y7qBp+ zIaF4lME+_Yd4DWE6&lV`62)n?l8zlEJ&s)F#CzFq)HgmFptlMAx;&~-NXoy4}PshCw9CDiM_zC<8krYM_`{u zpTCOU`74A2-KR?D&qhF9($8EDBP$R#92dZm#ZjtQ(-^qPl1YZM2QY3dRvUF))Q+Oa z1#0Jm%LGZHoP{mFxc3A2RF198($yuD%u+Oq2BM`x?Kn_#6nWJQlo6WPR=5$jBqasquI<80xPGS(oG|N1H+`s+s7gHT8X&MlLBEInkJYi1W zQiV0~1sFr3{Q$u8{5)I}9ad?3?;D5MfAGKrrjwQMB$8w`;SL`HGu;FroKzwZ)VkqR z*p%3VFV794a6L`#nh|*GYVRZtTV~!>zKVn-JvDxLPd(GgDJ2!)PF(@U;-}v2-7W8OR5GBM~yKF)}q424nozz2;Lt!+CFvUdD#iE|oXw#M{mZqZ3Tl zXavEdz_GIQp^v96Eq<)k4h#tc!-s{y%`hbVbA>lGZC{yt$ftnRi^b0(b+{*LRVyo7 zJLa@(*8{XW+M>j^hs=p z%kT;L!?&xVOfS7QSFDs`W@8MLxo~^tdfYNmm{L=yzLb)rpyl%J=yT$WISkcuHnZzR zm18`yvQ1igx{?aq{)6ADKKIU*N#F|Y;(oFPFeRpS?bRl>Ga^lCt|xGV45j0So_g#F zE&Hv6D&qV3fWYqZoo;tkWYBFnE7dnBT*%RE7tDJz%;Zp{AaH)M_$$$Im8#!THgr_E zF@gpLAdHDL7f)hRiJsH@l8c;@qa>qs!C)w4M~Ng0^JQpiu5^E$1%La%mZA@AX~vaJ z4&~Gx^PoxV0L{NySGpNg^zKbJ+BbH&=BRhH#&eG-^W99ojNZZ1*dDJ@(h^^OKUcyF zKUpr*+b*$rpOgQ()B`Y-RIR3?aiituD~Tz4cYF6!%Ds9>;D< zqs8INL7?yYl*tmdZ`gM*7_VSHVTw)lD=T#QfP&XgcOpgaRk@of^J*8YIBxyD2L=^w zCv(XzPC2nOmt8VZkffarvWr0(JS^4@3YDMdXD6DTReZ2luH+S%7jz;wWG^xv#!4de zmEIE4X&SwXNm!*o13o#%{cK{DpS!qVlUc(qQ}7V>w%I=Qc54W#^lhSq7<4hx5Q}KI zd04_~+r{s*)79+a4&*amY~O1kvyO3vty!|ZT*R=+YCACq^Xpw%Inlh=TRx%8t6#+$ z#z$?sPj!ps{%Z5nd&Nt6x zVmxnm!ag$bnSBmI--Yl$t%32cCZYm*AB(`2S_Ds*5-q%>yA8g%yPA736<6b-biJxz z_GUnYYIqEkF=0&1Go2tnPRR^|phq<>+XyYI%VD>l&n^gmK8F)3|@)@=(#$7PSqg_U;6TqiVz~K_&jwns6eL{)`Ti&K4Vr~Bg zeI3_onW?^QYsAe?a#O|PJ@iKT-mAgw&U51ueR#h%+?1$Nc_|Lg4z(-u$GIe6(WQ3I ziL)hvgq?pJTeP=8Ujyfc!N7D1A`5nL)<(%xErSD6flsQq%a4%YG^s#$mYdCkawp-< zPQ{Q<_-F9wW9bG2Ds%=p`8kys^ZA{LiRRkr>2Io0qPE@PPnYF@-Dzp2q+|-_5LqtR z}t z{ZSS~+QgyLn_pZ|ZG<-r-O(SX91i|0`U5>924h>wG!gz#O5a|9fpL0BPp?Au6oXZ#w(h(J0qefKy$f_g+tL z33t1AqjF9S*SJPcZnAS;o(o>#Yi4 zJ@f1a3X`d#3cep7L?MX63nzz76=JZ$=?4I~E|cKt7?I+?j>7ZEj0@VzO>DYB>e5CH zSrtZY*A&z`BdWVAQ?K^2;HZ$81sF@L^_WP~ zFLz6ea()diM9MQgv3m!HA<4>{(QeF5+X%|D+a#o$ulm4y38(qCX78W$TTMwX3t2U| zxeQy2uo84Z{TQ~DVERvQ#nw0AB89;`L5cG)#k$(};h*68OzHrjdCzKsyXd7`R9-z_ z)KQ>ms`#SR&^UuBw3CI_S!Sre$%kI#;edj7vlx77&M|sbl$bPYR4!=Ab^%ZYn89gN zW)6EUH~~6CIPUM9rY`46j61({X-IEu1v*h8TUZRiQ(RTJ3@=Qi)Rik7WG{I-Sn^H` zuT~M}U5S1o&87e01a%xH>cF6|@y*gqd3v(;b%`!&~=!trCx>IQZb-@)S<=H#$v}rB~nG4XSt%p%vXFKJl+KAbXCq z1OUHgNm20#_Xd5>c354Cf{Ak(7_+U;ajbpyE@yF{gq)=F{d3I2)#X z_B7CoEpnsTHjimny}jM{J|C??Yx_0 zSty$?!V%sE#J3)43w95~mT?lCh#{B3(}}PI43}kN2W!}@)BvuLx}fqz zJZ)yD14aUG<5g9?vpjhvmnv`ieHE;z*XOn==nJ6qw=3p8?0$Am+QLjs4pAq=U|?Jg zeKQycJ6^w9HBF3NeqM@dKsnbc1Q=<^J+Z3yjjt(xU^^Y~igy46Mf>WpVq`7VL!3sF zQoXf6Q0Ym<;a%T{F)5irPlM+?81uNo5)bcf=I&=>G6z4l#4f?=%%Hx6@sqcZ0VAnN z>ahCNldZY~6M~Si`SZt8^S=X1R~2|OeR_qL(c;>$8F6*-OOLR|9x1|rr&X5 ztwa9h+OBTbYlz;?`Dc46kQ@TfeWM+n{vu9UTY0pkcw?|eWmD<8zpZMsu2&NGAhdXy4b5V~Dq)VV=eDM|31B+?80&qtcb+htJVAYWVH<+D`MOcxk?H0<;(z^7hc3&N|frzGvm=rGWgS7-IYZa3FVT5 zW88S6N*<)umsxF^yR{i^njj2Jl6+4QCOCC}7!C1K0~SF%VY}?5#Mpn`=WzZ&yz~#m z8y5xNcdar=>Pz5BED7Ain4DlKSeO37hLDz?dYNwQkspwpRp4;NGvJ){C*^|iHJTP! zU|nsX0XUCH)(>%r=i%Y(y{?bFar19b57cS*t?n2AwclQT#1`lc-A|_^@0C@97)X)P ziPU}?07&7h8t+@woos*+kV&k*>|-#6ZfnV(XV#CHi2VcIisB*}{%NPmHp zCmD>nlMJJ%)>=ENHXisrioO@B93-pe zNJU_7(k^?FuJcGQtzU>;=-D(=|7qbI{`4j~>c(dEqFt#xp^dlM9=vf04K@M~rA@=b zuImDBlup6Y8=DkACRzy_=7d_mKH&F>_lRyI~U3Z;ORIY-aF(1;NINa3_Q}# zhL&Qni@u#96wCAh?0D)Vmv*7*4J~B|W9j*8^J?EiJM4}Pdao|ONxAeW1p`RFvB#@D6=3tIvVd;|7U7_r#$+m0WOF8gT``ihG~D;JEWkj6IKlkD~yr`|JkN#kG2pEZw76=9O5dz8D>kt7|gvSf613T=QTyMlkM z$8JByU)o>e4=i;ifT{+gdSLp_`t{Q?=KiKf>EtxZHYO(>>%KLfY}ix}Yiy|sq({V+ zpbJMg9b>06xkswd&fbrc!6v+r{pB)XenHLsX2o8KA-=~Co{pA>ik8pp?AmP=`_wO~ zrY{dAEx-Xpx4DcEu_DWMNAXuKb-S~;Hk-yKiz;TFM zn8~a-oHLjo^bL-)yt{5%Ia?Z^aj3=(d^w?=zm;L2$KNgEq}`DH{N_ceC06eL0e|8W zEhL8u!$AXlGOHfp*RhBcJ-`Re3St-Xw#TaKh_G0nxaT8u*IorwD=1kq)&ytW(ROPwzK;ZRC}=N z`1|!ok+!#s>twB-&d7pmU^8#e~`0zn{ za~14*s;AP+PA2H};k@rHHO*!C>cA>A!Z;f6;xvU3K-=Z%^lV!p*8*2nH4%NHCCxi9 z-G<3RmP0=jEA6Znb=`)$IiUW9R-Iu7sVW~r6DbD17Hek4{gXFxS2jT?fLb5f?bc{u zk_qH$>*3+F>`*18h_^biVi@GJs0*XhHI0nRFL%WWQf^)b>)oO8XGJ!M)EcnbZ;&bL zwO>a3ls#CNUu>&vIsttAIcN|eh4DEf^=5&n1rhJwjka;?<6Qbqw*vt&)(8NfKiA`1K2TdC43vZz)F&>-!>mv29FdoCc{PuvQH{rcEM9D&#!kfViBh)f<3S@FV3#_wL)lWP6b z4Q4b7d>Z~~C!@X#N{gnfoXdkBrOc)`XSZsFV1=pZ*nE2%2%pny!UZj6hCLwTUeUQP`70c@g{6o>Tx+q4|p})deNeJ(Ik7G#(KG< z^d+7nJhZQYcX-{o+Df0S$=2Zc^p^x9C4fl(euCk+tV{Mwu?+pnE9a(DMPJ&S(QA+D zZU{*V1Zehk5a=CeGYfth6sZyN#L08>P?e*FEu;5;)CrB>2f^QQCdk|h-aBn(J6g4h zBl0Q-J%@D$DSX5Fq)4hhk2@J05zr~zMc35c@=GC3o7_ya6vDKFMM#>sq*&Jy#WYn= z{>dVBjv0;^@M_GZQpU%+`rJPCMV3&%Cav#5PrQ6pTEHAE*hPQz6>eor@>upPHZg|> zETXP4_*`<)E)p1~9a8Z_XLK;g+a%i&&kZi63HJKr?#^#P*A|YoAh+(3&Wzo`gy|Fz zIX@!p{Joz)*uofQKTPTw8vY9abZkG>nbR%T@`nq-v1K4vegTb^3aIUUDpJUT#nY?l zghE^*K`HV=uJ#b+@Mpo5P>#F0(t2zyqR$fIRGKGP`}8eUBoevi`$f!0%s+LMgWU&N zj=a7w-q$|UTC4=zLFfd;D$sK>0FGjL-&L1uM-7{ zY6})#wA~{nB#mS?hojV4p%v3wA|MM-O}S8hOr&;PGK)>jB!uws@wj_nz?o7JvJfmq3P;e zyq5CSG7XNkSEg4xEPB^7&mG=KIh6$IkfMa5&Dk>Aq*_>P~PABRz!B+Smhqwzi8A{*SiY0!>(v}+`hn> z+ECzwx0As3q#on&se#x#DCb*s%`oI1k#jMikA_gV<%v2Zs2@Zw6NT@~uzT^s>ABRw zMpC;3LI$NNDp=-H?NqL;Vj%S4m^<$NdzKMlX&iY@%IUo~v#5M|$QM7MFF}*O*+FD) zeO1vqeCqA$B)wEdK@$0i_p>k(AqG4v1>5-g`?2@AM_S9rkzQqvm75=cA?Iw6Q|Q6+YW- zPox3gkv{&%{LgtJi2p&lq_QhQaM^&MqwQP_8d-?0gqqp0(d~dsmb)AIg$YM3Ds0Br zaNS4RSA6lDTnhd>YQGltCyfC2PnTy(MXrvCC0^Cn5k<(BK}_r+_7mR)sKzw2?>LD~ z)9y3%H0U`{9kA@KdXg75j>ij`Ut1uTzf50Z`@(kn7wqt{SW7+K39e;9$RC@- z;xen3usC^HEje03iEJTxE!cVG({%y%WM$KN=e?ZvZg?MVtf-}VuYhJDiEsD%ZARGe zv{NWvCsNDo$@4iTb1pGF=8)ZVv*L@3q-8xAjUa>01)dm6+NQ9Zs39^Fgdy-S$M(3J z=tX62)-p3N!Z}Em#j_BX@FHxmXUR#GHa&BeAAGI08r-+P zxxp|_!uc^6Ho_C`8xDyUy4UrDQ3Hb?CV#*kac9BqE8Vkn$;~U&i2CTX%a`Whv%TSd z9&b{D^Bk^oac-!6V|%L~Z08whx~MrB`{PEHqr%AnE8tN|=v1+n;6uiI?_@hQk{+Xk zaInV116y9t5E-7pmJG|l($%4c3D5W7$MdYsJ*^|U7i14hvH~vNgo9w8dY8 zqfMtrqBuRiZ(R-+ubdY9R7-QQ6O@LP4knAnED*exm&M(+s3hXaq)UWeuclRWP}O$e zv(JvcTjm#$Pt=$O9$ewZYO{Cxo@VVY)OTetYe?qP*v*w}jv{KN4{h${C_&&- zhd$w4nB~v@lHc0JVH#1w3zQJMU?neiq;|pk7f&<<;`pWUr9Ot>9oW;Gs&^k6q2O`;BxdMab4+KmG=sa9tW<3sWBB)$YLv?9qe7It8E?`$Q!=eKDkZGDGU@8ClV-oo z6n^It@^L!~5N@5`L{lYfsxqtUUgJ6-wmQt|m{F7}9xyBq2wJYO3@4d2e@%|7z&$!( zD)(KZ%q5MM8wjCcs?Dj(P0e$?&6NgAF43y~;e^K#hrYz49;?ggvIJvkln`?|pLR}a z>=v8?5{aclDF!Ad046Iyf+SZ=6As0!5LOB}u1}x_{94Ol(d-Z(Sj-P8 z8p|R!?3M*#(Dkh9&u6WWkjs(=eC)sd8=3Va*P}jDT^|Q{#M@P#I+wzAt#6;WdAsfC z6Q>kLz$IQqv=DcojY1PG60VZIj}TL-)j#kXc_c3WOsv?CdrdVC0qDDWjf6!FiA>NZ z5Keeliw-7xMh_W`h?g+nR%hgm4|EP86K&Mi~!n2bs~z*=KK2Cqkq5_sY=->x0^+DhG+n# zAi+~D3c1l_-#QSHtQfx`>V*~*eMn#a3_<@`ug`MI%nhfl81I+SL$zM zPWuO$MS6br)KkTF=?6~VnQ6#2Wn~x!E^ET+yhY5A25_6diCY={1SGyr83ZJy4 zQLqAa1#-?Oat%tdU5C>`yCMxK+&Vg1ZZj7S8!C!AIt~cSO51LL+b?g%*>9|mZtrc> z>7P16hw2huUJpqFmm30Z?wQuHLKLQ+Kxls{n1JavjrWzx0pk`B+++I!L#>kNg+ zU_~!m6y=}^gQJwGEHjLSQ`boMi5rBvGPD~~VDCkDO||-Mt3IyJ#f6KN}gt5&VWk)E{jq5-WRp{4dlwo4_*y|FYXLYk{ zJ366slL?|kkE37Gx=BLvAY@Onq9op@% z&$~L&&f0SU`>YrFQg8}}5cle@qy(pgSOldvzCDcmnUt8Ai1vk!wXLw%c37u*_NgG{ zuojy~MG)x@(s;*6 zxQhUm zG)Z5a(peIr_$xh=zcG8Cfr-uolc+2V%oM;vdyprmCCKMcFt(^9=a8(p+Rg`4&%WosYA$Kr|mjb6kQJ< znq{pk)#l(0)=JO%(*tXve3M3rHFfGa?2-L|OwX^V%a(hib))^L2#yO80louF#pjS2 zq0LYddrl&r_fzd+IZ}Al?CJgPIVJ7sFE=bnC5U+FnKqgBQc0&F@j#v#jUoIBhKr#Tk6nZs z^<7^^vg#;}ZXf5~yvXXD8s0sD8}5dYYi!zP4=;~c(MJD=sdr$^1X{9oW81cEb=a{x zwr$%<$F^GvG*pLn#7J|z1Be#u_#gP$bQ zjfnfs!|WdSwsxv1r*iNX$)|4N9E<_rMNHtk?tStaF76>dq}kiYzJ#9J%Z56G?CJ3n z9)Up$g{y_*>qvN_>7e)V1mmK5Ew~gq_&ymE$wM=dUk+)K)igZUis^SpZLoKHqlv;e zrGLPfbPxskDf)yAq@54-M+nv3L@oHdKqVg=n*hbcyiV%D(q40y1NY>t=iJSO_2lkE zQw?@bxfl#tfU|^FnAU`-wo4==CFx zi8S#i%1x3jm_*fbj&+SkAhkhBDrGZFVqn8$15}(fh5IOk+7Dw9uM;CJ(UnI-dQ%C@ zS34zLU^BiTYHsh%AJS?=k(M(Aa=vT7;wROL5YODGg+n|umBfeo>y$$whL>11U=gAl zOHQ*AQ+cyW^$ZTK(T!@fP&f^SCuT&+Me80en+b%0RYt&c&OqaOKUZ@kcI*m-^&5$^ zP{H~*unNSi^5vXOzspXMX90R9mXptsBkZ#w(8t{pP87Xj$F9(wNSDy9|2&~DG?eTh z{Y}0DefIy=UngeGgm&i7dLUgPlKQ?P$N)XK9H^(X8|qJgNovtcF3>*XOeTC1s8U`& zS36qV%My~Mv<_Ed4w`rqc+{9|Lewz^$i8Qx2!~%l&2C};8sx<>c_O84&n@i#gbTt& zV9JeIaOwX*y#O}UWu<6&AWrl{0peAzsnpR)2c%XG`G~kMgAJq40`!l@UfdEtImJNG zt3?9ad%ya!O=sO7HguvgS6nHUV;`%x{{We8PR`AOT+MFdF(a)2m~l=^FMY|sV$Lrm z@w3D3*Yvh-B6PSfO6w|}02EO-kApK|ImF61F5YsoJwx!%xK|K+|d(Uq2DZA~)*dT_e5%SJ#cwK}+4>wHnj*~K-i`TY) zBBBTU+f}Nn(-Cfo=Zo^=*!b7Ht9)_xhvzsdL5T8D{?jF;^!remb0Bh3Ob&;bYBhOy zzheyb2zYsL!i)@wxka`7n?iN=U@CNdB6f~x@9 z=<}FwQYYEgNh`saUj zd2Z@wYYy^63jL*MD+LTY{{TNtZJALSQWw#BKjE)Xuq&eDmQ`nzvivc)M>`3jNkdMm z;bn=Eqnc=_8hJWC9GAN9Q3GB1Km;_&(!oPp|1$&EkA+&$^kxosR#Fh5Z~zPm{+~+} zG#Lp=>#Lgi{`BudO4$sx6&MgbC`Y6GdfMb#6Ijl{^YQZon4p5`l&>`E;Qa{1c$95w znonEsKiY7;4&z*`8_2Dr0@h!nsgB19ZP*I}D|JKn{bnG)wg75gQK^v}JL;3*!7&Pc z;{xOf^YXwML`n~scPKFFhDuE&(ww$suLq`Kx#~TAMcay-dqM=n0CwjM{Cp=erdWvYThve18|-oH@k{z^CQ9kxWvEzt-wmzVthlKHnx!#NQ9Vt1jV<$k9l#$VahA6a@Q<0{^>a*f94A3um**?MRzBzx};{|Qi@H-fm__@ z%PQvCVn|f)nrmgCF2z{32dG)**^ z323fjW@JudD_iN%Wt#>^`Kjs$j4?_21H6jhO)F2OGE}P9VQ-A#ZU0)DG;@AEgeN=< zE#`RN=dp#(j@@NEM)@4@XA;t41TXjhZVJ%X%s4I>yHICT0-Pqn^mLx_TLx`({aYF! z2pLz%o2wudHRYc&1E6hh?n78^;>6x|tK-|3AXtM6>^w;98Uf6I+MID*t9?jP2)9Oj zufontj3X2-i1{fXKObugjq49Eh(G*+W-8@+00FQhF`sDo%?6l$K2#R*uXI`-tiMzCsDB0I{!k z`VS|)C)bc79*>J02jJ*pa5bTxu8HDL%gu?a>#Gb!O91b}%U{0;9QL-|$3CGghgX;E zZ{eLa#>EqXrG#Fy9diG=IN;Bu%lo*2+$H58hk;BzhXbYilaqhG5cz-hjv|hn{5@3e zcR73v8h>XBFlkQu+swDhP*VQ4Ab#8)-j#|$BOv7d0@+|InnXQd9rH*nh< znG&` zafAa4UXprk=Pl7GEOeJ*WxXtiV|sv-OGh?IAzOa>7f)TXFo2GL5Z3q$qFHog9t;Oa zez-F)(;DRdkse+M;(}U3YipR_=9l!k=BiUjxr)Q&gqHOA(h0+W>I7LWibbcgGICDb zv4sxEyIaX3IQGR>0Xmz!cWIg3fa@^xz3sPk;9Z+rAbq?vJ%0Fi6Zt`>wvD~CH zGsjNd^!fbsbl{pT3kVZY(k!55%e+<=V|NZ>jJndUqXq?&&N3J9_I^pUx*|8$(R#Sq zEX6Rcr?w$+Sw#zS7SuS$il9kIm)!Y)pu_`LbeI@w&bjR!=~9p49&m<@uHXHFC{a|| zWShXW7&Z!}e^jIpteqnrEbz!WSXy=XEJ3kie1OVNnI#EvX>{HHPksFt)wzWwcUKNv zjprWdxRKIEQYhz~vcGTkH{IV5Su-JwQLc4?*kkl;=-y;;60x&np-afh)ZYK~YmJkAjr)ZQVuFYEB`$e%FPBh_bU~e@}orcBgt#%)HqL9H^MPy^Umu_y>a} zdC4kHOVl8hhhH}m$l3m*zGeTVzP><-@g(RmW^sbIP>{PAm6?3H285V=5KO+aY`%~d ziNXZb>t^tGpkv)7ybw{|8f6}s{foD;#A9hCe86%8FzwRovz1-QmPfSKU*g{vSGK+1 zJ>Opivp3y?%z#Lo9m4%Cy_@e7cNWA!{@x==R|A_=cG+;_4PVWOiGIcQ?5a^jO2fEN zCpyln1TQjd0q_b^Omdnr%Xvw|bKCyPdc|26w!k}{u5DtE@;iGv`GDy~ zA{hz3wWLvcUCv`cFpfHSQ}J=5zsGfK=5b>7DlBCQeNzrH8P%@@81`C$#Vwvf%gVSW zP+zu3^I2d|c(mSCfp@xtXrx-wBWJ%+L4@Awp|$+5I=iaruKpAjYdc&G4@OkIE`En> zmFIuRms?ZePiR419kQGsD|6;BbwGxB4&V6B!>KX^5{U`~b>3Q8%xkmNu{3OuUA^4C z+_$RVF7M-7xEB|HY_HWH3rbW?^kcdVz>5Sf=nBFPxo~;)_bl&JDTZ&==;OslKDFXs z_cL>l8p4E9JFD*n>Z9R^vP1aHqIeG2S`jVA{YJ0f-fLb3cYw}RaS%orAa6aczeJkT z`9GKx*bU#bb zHeK5Uaagtx!Pa0Tb3p3&TtLFeGs<)o1+Obn-N<4)qX`E5%En&*o+($H?lkt|g}T%7 zVl+QLf5T{gQd!gT_Frrqf|~#3lTopxM2&LnH06v~l|y9}TPDwbzZ^(T>DSV0F)K|e z!l3i;bH= zDPW*zq?QURZ75)jFU!d^I^u!RlvA2KwlR`Ur*fWoTsNf!C-RXhbQf!It@w=IZuXS5 z`hg>W_Qc-y%&2XoRUyCPk~%xK(NDW26h4$LuDT_F6$O<1tRC2{JRzPf;rT5~#`s zUtSX#A6xrMuW&{{weP=X7=O4l|Lqok^eV1S@<*=>cJT=PHA}1?JsLcE21x{r{O__{ z)7h9GxfYvdaCbwUy=2_sc@OqyVoqOS<+u4`e%Kdc`$X3*6)MkhsWBk)Vufk|znAI6 zhtyxsAAT=iXXt(&ojcs`Tha-o({Ek~jMyc0I!4&&sc*`V%*>HY{+te(p5TH;qQKVI zRZLJb2psB|1aSNx7fMV_e1f4ugfhqviTRd9mLW`7S>&|-r;m|@M7HxmC*w2Xv?b40 zeR>(Etj=$i!o|qxqi%OVvn`87=X@@g*kjcqSn0?}y-jcLlQ)aHzg^e9VLYYbUZ)b2 zM7X935oOYK^A_R(r(j6+l|56M4x_(7YtZc2ym?E#b*zjRMFARbGkCjJIG^&~-2}W+ zfAH|=qjuv5KLfx!GLc;9LQf`wXd&SFUaCg*dmkpQAP~`ms;l&qvK-zsH^jtZLKWdm z!ek7=KZ732unjg2mX z?Q(X0$k&V)Upp*QvI&TPdIfiV!Y5acN@K(fT^*W_IMGHwO;XRv=~OZUeNNP;H$o|0 zBN8QX0AaM!k4vC`IDReltR>6Is7651Z~N10Jl_?dxbVG}oaC)85dc|B}3Wrt7d8qei`bCh&4QXO3F?;;Z2O zkiIKmwypE&wMX+NLJ&!L-qnbllgn+yPWpL``C4BsgwK}z^>vNw+3FYqdv+vMk)BDU zc9f{8+@p5=*dIrIgRFKIK>fK=HTIezjirAvCWYy(oOaXjO_^8;_bc4Vu-hb*l@XR= z?V(%OIwHY)Q-JRZJT}(!+9?;J@%b}qOBi%J>Vy?WUcK6E6h1RD5|dQaGS9WQ6_Tpb z;yoW9Lu>F{4T;CgZ@nr&G@asi;cgxzF6eEsN>*=^qbP$oIV=6;(I_m!xlFfQ@%R&a zG@M}==dwEC)NA!>mAxGeQAgHI8FyC2DPnaB5SFr{i6~LI*L^?7t5#V84f&b^&2_|` za@A3YRzdz!+;N8DSt%Y3a@G+wtIVSFrbnfvOJdP_<^tCo!!OBw;%tviiZR|x(w-`X zuY;j>1WGrfat?F6T7D!M+Qah>xZNgLzb^zozN4Qza8r}ZT_nq-BWAerl%Cg6Y;RfV>S^DbMp zc)maRD)Y{Gj`=>71~!>Yt(q(2?^MUQy6~D{&zY4!YV^My9l>n_4X1t{#zK24(oe^9 z|ufH1m(m6$l-WUdpfLYrN(`VMXuGd}zN}~z} zB(uLq*7JB@dg;kpOz7V-v7GhcP>mEC3lKI>=>QPMtw=pknEOMs1a49s_e~oLvlbD3i_!&(wB1zaiIjI2V07C7%Ge zUw}ofQDvW}i%;>hNAaQ08mVv9@h`yEr}(6=kOdHPcN&ZtR1N}>e$bi-Ou@?hj>nWK z^GhujtKBJ5e#>PTg5QQexPvMEc;h97&9cWdp;c~Nq?TCcQfg5LcMxfG2F;A%N+;bG zU46%ANc@LM??6N%WD}O0K_aNiIli1=)?M3|<8fuwXe)vh`V%(5m2Ov3|QEloD7N!-f zZ45c+o|MDDe)$?*61uLYJF&NW%y2uv7fc&Ui2Sl%yly^cPL1e zd~CJPrOqf4A}V_2@VajCI+D?W*Gg? z0m11w*MoZ~$eXD!GWbUnj=YDr#*V&|xCZGb97q6K=bk7ZaI+ul4oO|?`sqE*Urrr*aqpT-yZ#p zj#(${?@xb|PGnP2^RW9zd=wL0DWdIkQNVaBaYai7RAta%1SHfn&bl5fGL(Ee$ z;~YAW0k$Htx_%Zuc4>~FdgFpqBL3JKnSI#Gl09xI1}H7f=(0d2TDV>vyg}UG*Fyp| zS{eas`mfX14NJo@OHB=3qtqt*kwwvV$;22Xa!I(%{cgMP6wazaKfzc4(`$FkK}W&t zS;1SSo7vdpnD^sssGFhQNlcYnFWqimKS+w#bPlslwP;Q+nIJ0eW@k`vNKLP|U^Y!u z+-|lgN2e$ep3@wzRgKH)>YpyH`7Cm`{#$arVY?C<3&I!V@#nWI*6O8dEv`#PwLGqS z3uY5|t7}&#_?`mIRdvAdKz@G7SYp0Mr*!nBG)rKnacNli4z0G-g5ur&u@%YDy#v_` zySrZ4rw-E9&?fITp+}c^&pRpCVFs1fKljDjYBVaK5GvUr&t@DKbey}alfVA-7SLp;d|&QLJb%cm72a_nxQ~0YqJO_4 zPPB#X;7X^`&7;WD)npYN9suEt5$!7h$EftNrVzOQrWQ;32StP|04+n;IxNXswzDyB z>|Ins*^tjG_a7Bz`;Q8*kRVA$&vG4%K>c`N3ZKD7|GRkJH0d`yudL_v0jzht@^$0& z`yCxQFKHaeg>89Nho!!I%sr=U;bNg)mr6vFW~n?V<=uDPG3BopJr=tS8@C;w)D<)M z>93wOKfVd))_-3gA>WKcLk`xAs5>H*+L3dSWnaZnTD%ca!m8Z>Voo6K=bbtnZs)0$M;`} zoa?Vx`BE1?;crswB?iRA1M!1-pet0|^3xRnF*~yXfbW2~v2e<_qXX)HAT-f=)d`095$`u72e86juvwX090;dy& zqbdyaFi?sRF9k+~cJxf{u}3r6JbczOFmJ>{r(0*<03%Io1Y~e0z+BMps}8k^x*Z+d z`<}IpOT8W?=S_^;uhBTaS2?VvP||=zuwb@9G&%biyz{kFQT_;{v#zx|k6_D)+_)Yq z6}Z#axRBOZ$=?hPOFMx3egUcIJR6_^YW^WqR`~5atVbBM&6!n>vHr=ibbCX3`|a)B zpuS@7SERSNAqTLspYzG(TTLI>fUoZBoNe5!JSjr`{ap+}9Xy#$d=(-{__7G3(#-#6 z#(++#jTQ!xi=j%|%ZGN|dKGnY%liB{a?~K$LxMX;UPd<&>$L9yCbFBg>uNZar-LR8 z75VV7c9j|1y<>R$BJU~-yZtb$PP+BvbICc&FJANJ&S77LnXFsb*~PbTdUnvZ9>&HM z&KF`|CIN7s#8X_k(rf}sn-G^vn7(?+=CMl}W(K|Zm34c2+3!A~vGm3C0K48fJ4G*}f;MwgDD1lxe8fQ@4YGBAco;)<`)bWOxvx$@JQ&VLh>&P}NU}zSI!i_wIJC{N zTDi~p!&SPgEJZ5!3Boi~GfFBdW{0J$^NR1k5~v$d9$-)5_$WbxqnKE>4)CP>pIY{1 z)wR}jKGQ3~Ti`p@!&t$dfco0Msqm#pGbv_hKMu;TR1M2t`x)kN^~L|8P={Jo_Q*wHTvs#C+&?bQDs7?|O0p-(NWpI#VKu%Ci!Se|!<6{f1@*J$Or; zX5C6ZG8etnjv7C)VG+Vi8$g99qOqGP<(%Bds{;>L+b47a%l1trMQ+mQ&pT9W!%opb zQ|#19dTv6-dCxCDmuJ6YZ)lglm{k9xmb?G8gXEJ~IYrj^Q$U8YA0zSwwwVn+{PjyI z!M6r-%Hi5+-3;@bd(J^ImJJge>XNZ)tDd1O^iZfni6 zEmzWw&yr@fjQf5*|7gsJ58(9U<%Nor(-lLQfR)2g;$4^l^mAlHcsc6PyGc zBf&fVqW@2r0pKSwR*NUrbQ@ddjGAT2I`8rZ#QPc~|EU<%HO*Sxd zYnu8iwA^kZWaToa?3LrY>EJqE^Ke${N`js3n@CVS$~FnJv%p2*CL~XF*7`e^Q_6z? zT6;U~Gv1fomqE{OoHPhvU-XZxUb=DYk@~Qen$MmzGaF{w+sloejKcxtSXuXWc34U* z&QW|yF#;|K0(<=;2cT8+S);Sawbs^_OY2>u17?YV8)@J~ ziis2jr_K~FSs9oNuyKyAsI-F`Hr2A8T`_e!LFQ_*wW0p8dKjW_QFg=q z^|!!zfj~1-GNuqYjfsAEgzI5x+*Hq59(Rscr=P}b@|M1l&^l<58d37|qxCkdgb{De z#j1hD2da&0>u+-+<#!3csh>e9X4}=EvHV*sH!jqb!PU&S+vY1O$3~;4522eOW3( zPwZ(EKsM5RS+iP;j~DZzfNO*Nm-EEfOY$=F@!b^C3SBUu0ze=Fflx-+h(V~jT~bRw z(eH4Z#|;}mAM{c^Sdo8zN5d2V(?sX=apT?AD$7$}+gp!_vpje6iUMzs&NJbphg0SQ z-%u}bA0)%&!08SnN|OACU5LRfW=Q-tQB#K8o4aV#?`YkZ;`w>Wa{qdY68auZ`Bbv3 zD|(PL6g=%G2Mxfq@{+o0Indew)*YFVA^YH!s;jwLX-5FclQ+wY-zZVJU?UYSuHst)Gg>`BU)hZ@@ z6)IwX)%sGdW*;nUva%_HIu~}ySv=Euz7QR|Fh5tmCa)6PbmZgH2?bpG!H(CY0<)2M zwLcmhRKrV*h_4Ve7I_hVV}6ATnTV~gVo{M>hKb_LZIzq$D*!AA0Ju^ zR4P!%yBWGzoM<<&S09jh_DM(1f^2VcZi#*l-`6T{7%@jB@?k9Y_n-FlmWCsJ+N#fT zR_eZQT3aK}IE3mO+x(^LS7m<>mF^?qaL#Q8ja}^8TXvvZ>v3UJ!?SDo8vWK%zfl|eS})#tlErT ze;9?eTEj_ylM^?A@}Xn*1C8=f6(Dg4UZ#vXxAbOOJ(aJE|6%nG(FBc3HVPOLN7s^o zE%wWdQtD6|{)c+>C#yIK<>k3*-_R#Db6)jBEy~D}KfS^|O@3zB;qW3sKKTnRFs_c@ zHhh<7?}PG6%RzL%$csKL{odv->9u)vS`cYmWvn+S=*TA0WTGDFcvs@LuwZCY%&(wc zqHmc_g3+urL&g)@WG--@u%e$YDK;7Ca5 zRdl0Qm3AoP75sa#Z@-hXJWSJ51HWOH8W9b^tw4eRVP?ik?|yMQwFhTxdK$y$YII42 zdC{kMuaU?a6U`EHreeOIAKa7is=qwl1wr3}?{j~nQCk=3;O-d?c*8rze5g&K*l=GE z8Yt>Th3 z$g8)*uin=8ZgW29hrwnoyg7nRHR3b{A_RfEdcHmmo`hLL z@iHf3O-zZwH4pbCNv_*krx@v$#W5N{GU(`C*IY?j3D zzKC&S5@aO(eYBohC<6)g`boEB0UbrzQzB2&72HW~Q}%&cqA(LIHj zb_AdG>`hQAz;H3?aX}}W#+N;L`S+r#-cjG)E(kK7hR&|p&GlMMtK)u4tGn(zY!S@R1CC8?9$A@#;oABb3`0P#`&PSa^?7*w5-K96-0a$b|Ro^wjzEi33FS>W?%Qnl} zt?}0gp)*{}*$1G+!0$enlhLvZkSTI_eQ*UD97C0y0qL@%dzcilt?#XzaTZqbCfmcx zxC`;FR+_h@IbXwS#C^9infMr0&Hqs#jUXIiZIl0zQgH*8C48_OBjBcfHA*5M)(6qbIeQ{1iS@@Z~fx z*h+J1k~h&p;s68J8&@0I&&jM@ObP&nqe{k=vw|owI?&lEpN6a=0iAD$&WGkTv@Yxr zf5aOHs`V+U05!zeT@*++$t^F*OB30At^1TPilP{;Txe^AIiZ?v4q#_zW_$b2ScbN@ z7nj(E&7Ewicu`slKUn!cds#Kr_(U*E~B&FJg!mpu}hC!rdaF;PHC|MX;qFgeV$T&M<-!y z8TT{N>9XCu0KCLLFWHl`vQXIv?6Ub^?3VyE1+y} z-$71G3aFomMJAlgYqZ!DK<+yl!tLMs*7z>^gVdTx$oM|>5|dOvoM+sX$ z<&ecFd3IQAwoeyJ{a~M0#xcQ}0Rz+`J^sqixqGl3NKikO-|UFPpq?0AQBXQYG5N!D z+sP!Fj@jel)ZHQ(s?@@32v#oL_6wtWR*7{lz;b2}O*Ry9F9PnGF-pQxNwLb8O>t`5 z0=xM=SGB=`9hCSwQ>+z->?`sr?@KNigl+0^vU}JHniU!>?;;_UDx^n(CK^i3D|Hjg z(Ch6%d0tANE&m?{`SZUDlD|0cJRXzIBEEdKSoy#=6N3P;(jL$VYR1hyT}#I^DIA)W z9;)F!9?;(dLk^ui<+{Cc}bxY?Df)uEMic2c%uHmG+R^$l` z)5HY0;VFKeJU|7x`1K?6)hP1Y^uXe6VHq{#hAQnc_eg}2-*4O1|8PLBG@R1r)jS_t zKreE!=|W_?>cha}a1ZRFYil-hC^RRHcpEcYhF$V9<4RPO=fR4OQT{s4nD29hNVk6VOw1-tvPyLbv}G>{<^0ll%%$!y?3Wrgs@MztdOfx zqf*ZA7L zOc3f%1kc=ui`+OWT4|W6JUUO#%BD_=$CIhquOLwvZ-BnH5=FxEu@uRz1cjy zi!a?NPhbf<2Ea@5lUI~V1d#tkU~{ln=vb_f1}zf%zUQcKG9ziM%gOV#tR z^R#E|Obxv@m=gR9{|FNNWr3k`N)f6^6>A|KgNCGxLj?i{`hf2*AkXvZd_pq!StEa9 z8-iW7@p(tai4i2phF*I;BCJZUy6e~~?=<>_<`n{(B@Ie2K}l3qvX`cQfpo~t!hFOU zM3)syn20Y!2Nf*dSD}SVa~~?47s;7%wrPwN+%QFQ(rO$=X&*u-1+8NN7L$sDX@<= z|Kbf#$4$@mPS!eO$;aVSK4U(yWK;rBWujSK*BD(mE0w-nudrp9sp7r`bBP`Ij?aQO zquw6@s=vxJW?pmlg@ztEQbE2tF%e6i-#e;EpJcA~K~BEE-G^S>!C-6Aat*D;^(f`V zNpsF~)6yTlU>KQNYdj0axC-_SvP13Uu%nksgl5_t7`N<<3|?ntlBPo$cT)PP(mQRp zdW+jnqqgL++siutt8(^TsFoL#NPFJ}IzvcD8#QG*B33%i6pfrVXAu&lNJyKt)Jzf+Az z`%j)wF!SFA&vHnzGUY%zikps0fc%|c?}UYHi21v$fw@h6dw6HwGU?7zW^U*$DSj%NS!}S zcbI&5((jd!04sC>8~2>XEWIeBj(0I);;DZ)2gei$r2Y*?cYR2F4&;KXLq_yTbtV<` zYY;F2xaVhL2B?=mVJweMSWrD)npqqZlcE0@p9S;_Q8uMbn;(dKm0$9YPeM^4p2Z>a zltO(jYA?V21f=*vPa6(C$*2~Oqg@H>@-bSIYzhVk&uCI{gp(pA25kP=zr&)VZ?X>G zAQg)qyLdfRO)KCJ0teDO|NrNevtwi2k4RqO-`S9%c~a}@0q(Cz2tQRe_HIn&)IPK` zt*c&PlL_%E<7pw8AXOd7k586BbICV`pTdNmOeXuE&2ImnY|Q=d zY;^K+XZfFO6aXfSf=BpCKSu;DGoX-w?tAPIHUvax^T)gaH&nS4%zs(${CaX43 z@Th4jRaZUSR((=8d|L55e7k&J^lkt))Gr%4&(gCR%v_ak0xSHXo_Fx&;G8 zFTb>5vG-540?!{Uuu(WpH^somh}drr8{u}^OzdUKc7faXaDJZCFYBk?vxT2|lhiq6 zSvv>&fW(eD~Cz2{vM;+Yv@7>bX-{^33Q zdW?6MxJUwR?1e9nY95P0w%9*t(dqdh3_ifQmj53hX^6^+=Z>wT$vOH7t@ zij}cbCw?y#O1da&4a}+6)v=4oVBxIZK1h`$9Y}{ZR1FnSSf^m*W~{*qgT#DTyjD0I zk9#ki{9Ky zV8*5kX&mT<6crQ4^a7TkR7{~%$3d+y=D5G=IWfrj{_4{FtV?IUNE#ot%e3tC`ZWDv z?XVuy-zdFIAOmF)i9+#)k{_Y)1*v^p3NeghgcMjfW9rEpY{`6JU8;6IZAc&SPGIMv zaB)Pnm}J7ihP6R>d`R%=e|l(t{AGkV4|7{oEH-$Fje^>L{3X#(<`w)`=H)NFt}!oC z&|Wy7y~29yJM}Niz&mp|#p=WoFSp_08x4RV?Vgh5{y|9^IlpquZYlm{r4PSj)U##s zu;|m0>v6c?bKsGf?|UM40EH2_2hoO9yyx$Wl0^8s<)_GXJ&=s74{{=dH~cR##PZ=2 zzQJNFp5{bt4ys&3nKPl0V}wLOM}UXL+ByDYg2(-)HFox$rI5r3C)_vr+noZEndLQa zhWF1y1M1Ok1?^$dL22ql^Az$U#MK5CQo9=1{bU|$WOq9EUvKc;c2l+-IB^xHTxXmZ z)MpV7ptpx6y=+d{mzU)~mjbV!6f{t|cxf5IL3T#%2~s9?hJBwzy&T&#_pIKO1kJsh zK)3?vy8}w=(m7^$;{X;C{ye+XRJ~0*{e%NvJ@L*YqTIgXzk{vB*uZWC&l7mJz8osQ ztK5&dA^iC3sFyGxod%JSq%^W`inR7L8BT6qB(xqKj`~}AhSiV3Sx&#ywQt z{J>twGE*L9$}A#1R05K431WbWD0Z$aeSlbt=l@;?-na(%*D0 z8jdOWWg^sy+e7O{7@+q}gu&N%^3YFqF}JhaF%W`1`o>G|Zx})xZEi$Gr@Og`&8wY6 z#J*vdgp>1o6%uf&52?&wZQ#HQ-_c8YFKPaI&zj~_r+hH+c?nE#ph3jU-h(&23}MP_ z%PzKN5=hc%wqYAX!lvbbWfCB*zmPzx!H%h1F+qq!M1VGP){u{I^I|RnR>~!Ft`|Jw z0|$YhnY#n?mpwza+xhcSWnLt~DPkttP!Fy!(kaxTo}AQXXVLWk>Aj=>G_65u^S1xW0sZyNa<8GNz^s4aoyB zow!X!A`nY!xXeI)EMUO>m~jkB{k?D9)B@X=QaapmO+Z_o-d#Hy%ER$j>zLYYYieO! zyWn2?DR+GPYKs!9O+GBK1KS6)W}f%Sci>@FTq>nd5H;fk@xQV%c+XdYh*#Pc+}zPw zs*gZzkouo`P^PxX*|vyN=(onCNRj~_B_#@B*M0N8gTavl`uA-iQ4Uv}dFrM0-pLLZLRNoRky0+^wsfI0Qfvjd_HH*#ebzi0wjw zbUJ4IK~C?|&V{W>=?T?hA0E@3__;w0e7kpnsTmRK&Nmu9^rvQJ2AVI&a%|#_wRkHe zWPXeLuOx*LI)#qiTaBP{ZJ>LqZW`q^14qHn*AxB~@%h^h=Gmw5W7Ib5`P0KGNMf$e z)SduL731eqU0Nh=?31;FSf9{W#x&LzG!T;geO(&M_f_*}*x*g*2;#(}sARu%*{+ChlLU899dp+Y+k}Wk> zsI+O>MAG?}qw}n1_nph}`fh`E`?aYnx1|0q1PZ7c>DC(<>2Nq#?Pm_eRLk$jh5@=- z9%|w?FQI)_vFM7>F~PNjcf;-&l%Phy3}lwn&xmJo74moA;fsey{>CW|^c=J3$B%sio!@)Eq!hetk6StU zn|$UZh(8stQEVthH@u9{$>eDUp$!tb@daL@jDAmBy_;VUV>c?G~0-GlkA3cemoH(Y*{ zyg)?_-^v@8V$vam;fj+1?08h-^VX5|WsW(P@_zfZ%}9++ZLb{dB9+jprv=;FFJui9 z;1?NSpXyGzF^vKrxZ|9Qp~ITqp&ZYtvZ05akhzE%WOU@MJ@6?BpjFsopmQ|Pys0by zp2eR?_X5K)JDje}rugAzA7fjgC-i$Dr!B>P)X#&lLYSZaKUHiXNp&B5&ba6$6}hd@ zITh|AXTtqaKxy1f0y7YaRgQ1$0RWO8kQ#5x!OdZtn$FjMcO3;bjzEFQBgGY&gIVyj zW{E03mdv#nBH5M(!acbACV3!u(>f@J1W9mDsImJwmhvi)?&g#$U{DVieRN02KoQ($ z=&M)d%FXijSJdM^w96QU$d5W#*-3d#0wNibqHVgmZmVYy>d`c@|DTS{86n4HBWIOs z$+RtTC;Z!8X`j>v-vA`qjlZ|t#*-tQgU~?W zBisDLY@l!1XsqPzyyUm5M5iUZe40H+b2_(6!b0x&u(IFl0y&n20B*C1Dm+d#X|9vT zJ>g<7gjO@|UqK=JyoHj?S{n?pZ3AU780P^fEd+f^qQ&)=D6i1;RyTi?EYX~ZbQXl# zgGxjFBBamKK2Cw%b;eM#aSCa_by?9|*!}68ZZaBo-*g%L4zqeF6EGPUJ{hCvUE)y> z0qz~4hVV@;O`7o?^p$q}u!z$=0WccS3moFhxJipn7FtAS8Z{clK8$^ia~x%uk4?Ne zE>wq?36Kk11AKI*4xv~3-J3YoYdJ9@*KpI2h;WigqGwEy?|t~!S@i^egKkcOP>@T5 zPvc!SaabaKcyfJA0$<+)NX`vXz_D(kKL`nUB?miY!??4|*!+e z&Xc|Opb@Sk7(hTEk60up%Kr|1$}&Kfv(sf^$5ZuPgEUN91vAAV!Pv_cZeKKZ+RKY{ z@FgEpU}h(`PbL4C7??hcl#4tDilacMjzIg@s`#wBs77AhtX2Jg8V5rSW{}8b93XpDzBgG3vxLX#vtV;!= zxxXcPY(U-fAN6`5!%{8L`|=y^pS3!)2UNAluuSh;K>^Xo)sBh!RZCNeB7~FoI)3zH z)B2(oB#lK`g>iG8@5VBiOomM;rKIZqPgFJiL{+W(uWY$eyYeVc=8ap)pP1UcL4?#} z7d+uU#GIp@Lq-(U9rvhV9!>;5fEfo*8` zK%X;|%w+wy@e^qXuG}~P6~e0T%~>0q>DWpo5195U-ScXV?IOL28*)X`K?G5-_&~0- zGk2(wj2Z;PU0Q%w@rLQrt|_S#%?(T{#<=s1H1vOx_@glKH0iI|v4%kwH1FJ9m6b$i zxp+KVidVs^9M{dz?F^>-(mf_Yc!XPliN71Qug}PDyMsfU0v;CCQwBv#Pm$vXZi8~8 z?{dQpe4z*dX03+aJstms0-1g9LL~hy;kcC_a(p0cx3KpOK(6!kb=)l}3b=-d3)X|TL}9kVECP7ChF;vc!D-^zAXB~#T%sO4ZwM;Zy0g8~$` z7+O;7a$mL}Zt8+{q?Fu^nCr5QU?zp@=vH!Rs31l)C#iEo3CLt(Q{j!&hW8A+Tx~&x0f-&Ukv|1Ind7n3pjEDR~h9THn%+T*x&@i=; zuIH4Xc_hI1?KR4m>?N8(KX8;kI3y`K%__!XH`~-iR%wnh^hYE#l;Uk!H>i4+(RvH} zKZj`C_BXPt-Qdt7`sfGQ&)#ien(V&Aqxtr~k08^$e%nu{pJ*a7Rz#MLCLpq;6+K&v zr)vd{nW<4uZRJ2~uOw0%QWP2h{3(;!KDaTV^um0uv*4#6k&v(Mn+T=b5bi1~Ct!ie zv09A8OZP^sVZ$62>^}>@qNcL1gL-I<{?>tiY5!_Bu6DWNE$BLYN4!pO7XZxUUwDOl z7reE5!P$h$&lk=@605Rxo-h65Y#K9!d(P9GHSHTyRy~dqO$~k<&0>Gch)c*YtMWvC zu^8^Uc_J-Gs}HMn=Pb}vcsm{p^273eB~qcw9Jw^%buslEE~yb}*Y606a1T~8$a5hq zWmeu7sv8hM(Rd?<??sbbb@DUz zyG9VX2?-3lR6VMYN7X|vtu{Ud*k&^LFd4$X+tx z!OOds+7uqgHnf(1Kwf_Yv+j&+k|X#Up#^=BN1CSpHu%8>*8NM0hKN-Ua(M1z?D7Z} z!k!q`>%{swNZe2VK8)Y9nW`)zDlQr7(DAV9fApf!(|}-1zlxE4*Ro*fCO$g(hpAIM z!^7w=AI33xUH1&!PG9ITvJ9O~IHo4Q9r^a7Nm1Botqgn|`_%rQt*-_Ns_)vzF4FH| zF(uxd-OM+hT_hwdvhc)txr7nq5kRIsmN?J&2wimwQiQG|T_Bbg-9+R*k#87w%)4=j zoHtce1E2)z0&n*N)UGL{b0k;K+Sf&*ZW+;l;>EYsJxAtkU;Ssp8B=!Fl{mH`?rT+` zKwfAb?h0dYyj3KxT+AUhkMjiVQDx`O2jue?lzu>I_l$xJMo<_h)+qIcAG@@~mzA?> zEyKT&X7tJVN;hto6MMdezcy*5y`g+{-ov^7vwAJ_jCZ)y#b4F+S%%=R>h&lst>WN^ zqXk8wApRy0=sii+Tl>S=Ii#TrC9C)4RH6v`sy>yP`}=C!am+_Fh}J#a=QK7Fk{PZ%>{|TCyw?f z#JlV7*_%4oahLUkuHLBN_n3?Q-T#anp@_RvLy)xKB~9RLA=2@nnsy=BqHG4&rBp1 z%s}xJVk4f5uPNd^aM2H;!=F|M7I1$tF|~@v2m4P&Uf^%;dJFaFnJ_XJiK%UQ)s-Cz zqqd%%-xs;#{&w`n^MA<9hWXX=jeN(A_g_D_NzvYACujlxHW19A7 zExo~zZ-E`$7K0w#I`7Fsi0|Ey{mkE0QBk>C`0U^QZ)Qor*g1VYQ(e*t+`l@CW9zpK z7!^?j|BdY>%}0&vz5SC`EGW$_dER(o+>$Fze1krt2h|L{#xeXS{8Mp+I`wi+#NcrSMU2?+$m z0LuNvmBKG5BV&*6w&6&yWquP@{_0@UT!MDl5Pa>N{{=L3EuLo%b#n)Jlg$<~(04@5 zL$<7qvU5Di8Vz234HrN4a_P?W>`22&ZL&oND&2>iJ1Ut$MzjO-OPqT!1BG$V+Y1cM z&~Rw5CLL}~e77V@nlad@X;%1aZl*1<-1EwGLzuzsx9vzn#r+g|a^YZn+ua zh2|a?0a$~7PVU%sCHi$O{Fpi67k?nU^?(!<0WVrFK*b?^RAU_5;n0aHM>c z1g#WxVEyr(cAzOkd>5n+W1B6hg9Adv&3GxHn&qp=<;k9>@Pt=PAqr?xUSBDVGFO;6 zkJQ*yGpuiwI+RwTsp;PsVfc$XJ|K1sJ|HPsZl9VCch!eI-Ii_jur7aj4`~Ts;q2(a z{mTPX0;`IO7pvdZUpV@#-tqkFe_$w~+46i|i(6iY>F$l`lRUT92df7gw!FD#_=#so zKfFNo%sinAJ-;jgK-4lnc|G)AWkuJ^qwR!$3_W1{bRlqouLkxFLetq^oEl}a1vODa{A za}O?~-qrPrm@=sEJEuD18hQ9*Aae%f#w6UJF^}-7+ocAxyY+9}%)mm~*y-`BhVlFo z!v3C-D1+B}(o%^1ofe`1>e{)dFwq{A+4BooT(wAPV1t& zLdMrjj#0^YJEMW8G%+pFBl{I2^mE9bm;m<{cw>)VMQ02R#F4hMRZ*O#5c$yaLG{J1 zg^n@d3EQHIXB1{+BwDEiqfQCp7%x&AHmb+!CsQ)H;KB(C{sGJz@IJriSa9hAICMAj z!fFOd*b!I1=B{-Iin|uc-d43=2$;eFp7HCpKV1Yce~{z&jj@iAFaHfa@kdR>q38o}oq@I` z#SeO3w`37Za|Fit+FJ8#nYIs9kAW~Qt@%ze@+m=vH~C^1a1he+qVCBl>9uT>f;4ba zn|nTzqjqzPc+P*x>jMRdZ8aMLa}u4fMf7od{^s}fK1@3Td_#i|kaox@1fS3fMJ`F& zy}OwI9Pug%)kz~G8ZyiS_YU{f#Y*A}*lpLxKNAH1OF0O%d}=z~|U=K(%)_knRbHd+C_DvFZNd>Lg3X%P42)@xneJzr|%TotD+p`94)e!+z-kL(saCO`~zV zPDFGpp+To_FTG9#%+3?3llCY>V0`*7vP)X-@+RS?S4j+^?E7TNbtCu6~rOjVv`P|{K&E)7{1-+Q&R%&i4!sqrwy%O!D z2A5ONZZH?c|UFvt`1=bFKqnED$A9tP~iQQ3X}}k0Zj+%kFlUZI&J>wx}xo8(DKHMfZp!C?{AO%#=V10ZA($D&_hAo3(U znzbL|ctlE<>-vf+Zy|&I>|%w08Ii3_i0kzyphM=nTR|>0f!d}mt{_Ydr*Cpn;F5~| z636^}x!U2T+zOPBi>;G8KxN^BpbYP>+sV7q2?||DT)4ZATwe*Ih&I2gN{0gV4J!KJ zWey`aQHuxucBACq7Fe?XL;3%C_kR0NLLxYx;BNiD26Wgs1>}Bb@!l-a@Zi0FM5d=M zMh_b={=f<2Sl+XZ(I!#x?rzIV&Wxf4gNvckRNk}IZSHsKAW{?I1|A#{4! z?hi3@^A9Llt1>}u2myJo&bopkN!$>S>6Dt{V+tTq%vc6f&mwHDAuNfe4;2B8Li?>&$8Be)d_F8`|N>bDAT2)z(1SS_Hzja=)n z-x(u(fO0ELJ=SZM8SJxw%XTY8rw$2M5EbcUB==>};YePP&91L~s?gotprK$75Ov>` zxc5L3R1%`8rbUIZBf&>Oi9luy9H)5Mr`#&b854EFDezt4A4yYzVGesEzi8SSojTPM zZ`QZsI34OsEt8&m-mzZTm3^77G0W{KnbsK*(b4)MgiBfG8eQ(zPt$IYZ(qNvD(={) z_hj1PlzA8QdC6qAza;^1CO%!>u>4Qw#nh+Zclvyh+hpE0yi(Md%HVBN1i>KHg+?7Z z0nG+wLWc_Xg8=c#YDnu|o%R}z(a1uWEtVU|hM!d6U|rr?cCETmlOLRI=q!qLYC~xQ zj&QKnVp`r%YB0cNlLsUfSgz7_GR_-5eg0(Rp$;p`{Cb=jcNtMKeFdCtzriafs+S4>ET(?skA zx5kUBihpZ6GgXVcPoo&mZSjMkyHkBhCXSe{O$%Mt^Ffym7^c&=T)>71)=9wmGj<3o`{OYx{({BiV zrZ5&YGro@_Jr%UBt?b71;F_WC}f(-)Jl&HNxi;~K-xmZ(8 z%GTjrpsd~H$9*T`=?0HG>M4TsRlR$O6wPT2`_6|$62ZT{aX&p*1<5tSFdfV3^E;9= zfJT^L4G_R2my%)#WyZ_nGCq+9gJRD!D-eoTL0S2R7Y{qfdO+OF-`1$C&SC_OX-*rW zotqzzE1eJlrFe`>ksUdu#QJm7mU{ga7l!&Em!MOInlDK@Aa=DPZU99F)KQS!rNLJO z6E**-E{b@FyzW-IL+wXjqmHNV9s}dga1Sp|WD5du!T>%RhK3k-h5k@tK04tHGvD+; zGC-ewus1Cqf311md<3PzZC>$0a zjazdEen0Xh-oKHI^;sGC)JgJPpjS0dD4ihl`TYl{h0w{vfxo&i_3MVeDIq*2p`1;| zg1f)-3rTkh_bJU35qWe@O^ydCOfJ2khzFHJR~?5v;T&HD0ZFbZy=}C0_Q((DW)F@; z*X$EmvLo8I$$R9XkIaTaOrQ5_>)GKtir-2gI}2n7tqa^EgP`L3N8TjbzeBlyUz=wk zyETn@jh2s((bJm(nuC08bb~0NC*6sD!ZjF8BCvDT#)wZz{J@_vm_Ze;Ts5aZfu-hbWAbaujt$QW?0l0XP8|Q!=|~Z9vp);p{}dJn2mnS)s3fNW__Vn+WKS>&_CjJ?82Bvv5LRrxweqhG}cOI^p7<^-W?(dGb zXcIi>vP;S-FW(X8+*sNH?3yJRjcUja6_KZ6B_L}{w)9ROwQ|BwDw}+&VPVR)bf^W02k&2fs_VuyJ2&f3%BR$o5jeD0xW`|GKEfw~YKm)u;FO z_J4S6h;e=rIn@G}#~g-@8X3RaG0^w1zhMGdlZdCQf9$J?5d`3BA|A9fc=+wG2i(eq zrU5C`0}z)=3|=m)EY^r<$P)aR$rp2Wh~u-Crx(q{p;2!$mv)74i=z7_5Y&stD%dQ* zM@s);JeqKiK%ArVo%Xgcy3@JfHVW-2CD)bFzWTPI+!b2Xll;09S7quIc_xeTz2M0! zO9y5YMRpHqQNb}HU_NXtn9^r`Pxrdz8b={0n#Y12>00f@zbWSJEh|XlCw*?Ua8;UE z6#q=OVTAArv?~#>3E={yvsQh$YBo7kFm8AW0$fUiK3`a(6wNVdjvp zxGi(g$d}ZBnlEt~l~MGK2;`fGu6`8Ycp)zfeH@{Umsr}vF080#7s7ELkR7WW-g~0( z_2!aOW1S7B7qoo8Cp9wPt2*i0(IVe+K5~=ytvZ%mad%dQ$kiA_+)VPp( zWtp9cB`frDJ@ z4T$Vdmr)D~~GE>!FJ zY9CCHmhsO{>c8dy{?aU$UNk=7N>}g(x^BDaBPXSuL@!8%RLIHS6mz*?K(Guw<{}p) zvHN$(3*!}1@%a!*6O(OmvBIU$9IAy+UXDnAmuNYKL2{AbbzTnk*xPO*9q>@}FFwGw zw>XWlEHM`A1!$#QTR;+e9fXrMfZy*5BnuMf=bDQ1v`2#~nbi~A zyp|wJ=Msa+e_I~eXjiFr5(`1!|K;4Q80@49X`BdXmJ`#rLqn_aIiAF@uJw7};&mHQ zdG^}gwT#f%ew!h;ck9eYnwPb1Q0DJip$T<3w0r~g&w7pQK|1(=!l{UN+@0$X z3-t@_Pjywg7(yxyV|q-WnUWI;b~hMX_6WaxJiOHs-;#MGP9m6cUyuHk6A>%N5HtXW z>*XJ7jRvbeWm0oDB#N9h5a&&apOE#s7jUb3fZ*1qJxJ-*U^A0*o6!KMwM@SfHj!y8 zOrnqi-V-UmK9DQA6Y#N%uqQard@Y>h!og3o@8R_ex`{ZZ@qKH3evK?9jCNV&OO ztySqA?l*Dyj2{eFeVtLb<5RJMcnX&vQldIQ(5yER58&|Ku;hFSunvCcA)Wto?|n>Y zQ#3d2x_PmdpKVhrSY}ZWUNJA>tn@7-O8?f?F=nBB=+UN-E;ZSCmdjFHr@?HbqG|Yk zQ}-Yu?@%&-MWiA8ggm7=RZ0;Kq2RhzL_ATE-QoK~e!d=>4?hyTE%^R#X4B}OhJ)-j z)8L@ABj z`zMhU09B2oi=~%s(nS?z$>}@XFJEHNtgr2x?CA19eZP(-W1rfF@mDw8$+Fk4loOSSH!ASsv@u)ooGS*%VwPHDs zp)zjJ%=5=@khCwk4Ww;fr9h?PXtIu*(wL1RX6x+ql4F&J?nAr3&Vjy1#I$5Xio_Bv zWoqSCBAy3O@<>={O6OWD^WN^r88Q5A=L^34OB&T0hxuUi{Ndlg)KjyZ&txxnUGeeI zRA>wa<|^f8zlh;hDj`dXpJEah;-D=Y?2O!jKc3_B0xW(@^y1}QDQF6FUH!V}rq<`D zfXYw9zcoLlAWTI1^HPP8kD|}ENE-~vpG;3{C&pI$mX=GPQc0IcHQ2X>N_TqaRo5>h zKe1SfD)v(ci4b8yoYGV2D<*uTGVnu6FkA_7Qm7&nBcq=63!$y32YG}KIDa#&EL)_i zes-vO$q<4Rj|t?q=m#a~lv!u0SwD?NU=@r9R!ZoDN0}gt!_|m139J z1tfEbM$*tvqPVCG4$lKvNz7hLS2gR5FEVHaCNsae`}Y?Z@=lzgc$L5`VS9#QYHji!niLk1a8{n}*hZ^AB7o&rlz&fgv~ z`yz{eeEw%uwvIpL2AKWO5G2^#4APu=@Jc;Gz#+0$!U7|n4klzUBa@L~3ekE043}Hd z6vB2|UzCVy%`5$WbZ&=}?EXZ6&wr!Ir1W#yM_bz6p5D(;$$|TLYmJ?kKwH^`Pd8b~(M~G&W|eHJG*L^hk%2)&@fm~h6w!f}V~)?=U(a{0^|Jxt7~G*w`)I&loASUhNbgANcS}*7YLO z<=@8o_U7Fzl5*Q;b?nJ5n)E|e?EIk(N2Q~n#E7+`MX0rW{QCKj3tRxjogUTF8{FMJ zdc0<4(8_XH+^(M4t(=46M-2^PZ``@?kN@}zT_5nemrr|@4lIX)+$3Z8m^Fhrox1WhV^H zqK4Yv0gL)Ap+?wS(9&5BD*3zB1VE(gU5(~nv=ItTM%>t;5vd$dM;xS zmh(7s*Qr%o zscq^8db*BTS!d#FxC*z|UTscESRIQxue?gIa)Z)^bL>WB``>hc&wl8?C{wq6w!u+Z z2)kvO{pWY_Lt{B8vT#p5U<3rx#p-Npku0!PN5GUnU_1fuZjJ(UNp#{5#*@kJdgzi5 zWbdeA&Z#-=gow@8sL*(-LgmrH*LbMx6mgn-i5?Psghy4K${%6JA*I_rIZYhThoBHz zCI$yYD8mbooG|SCFG80E(;lm{bpeIN9NF6C0chS8RTNkuy0vR2y-x=SACKSI9@|Xq zR9G>jmK25LAvTK5sbHIJ}&^!Q{;cluOgm#c<@gXAy6$;EuUyTgeC(=-JXSCl%A$XoZV z9@{z=>a!XxE8{z)l(Kd4hCJV!d8f^NQ|Z|W4LH5Cp1494zbK`=L0&rI@`uAKmjub| z_7X6H@jO_WZjnWeakZ)7Y0>y5I|n-=8~R0U z3KvxLy^xM=e%)J_Gr-An^7vltp>w2U5{7ZJYwLirDbm+v<+oXrMbe35WSUODJ!<9T zq{@J?VE&XihL(~F@w|*h!?-F}7#{hQ_j(I79RzBm0k`~)F&Z^OifncmwyvwZC18Bfm~z-GXdGtVyVYSUWP^|P-D zZBk(6MSzvn>bs(v9yj*6qth9aN0s4HwzgXdnYW^Ml{hJ`PIz`ty#u3klI!JFH`cy@ z3EL#ZDSWLuUa3vt1#ieX(rDHWZ{<3d(^%=6V|Ia0dEE++`Ac1=MM{lOs9dDRY7J`x~RqFEu7-$H~q)W9SvnnR)oiJ6t}Fvo2XDz9LRPu&|u*of8HP z(_MFl%UX9cQd~ddA?&8^-TwM35A+$aqkno!H9la>ajP2|hcs1P`eSdPn)DWK(moJ! z8`$v2uRTSCnp#QGNDD>;kV$4&dl95xPGnSJ4Py5>#V|DBzAFTz)>EnI zYcigbt;P90bXtoMoB*fQ{Rs(xb_S4H{c8w(QCG^ModOVr>(7vI+T&$kYk z`!+B2c&`o?*_KO4>q|$w&jJ&a)82#q-e=t#R?G^E zEUR^=qwlcy&y@iz&X3zHrQxgdV4Oems&M67n0GtAAB%u0E^RJFXX*4z_}?{@vm+gK zDKL!fPM_f>)9lL=$ts$5Qq9JVq#+-D)?QuhkeD(*oYL8P2ZhSXW1Zglk@xfAl3(XH zXLln5XG#NAvI{X10sTHm?4#EnVLpW5t9fs(-qvZ>iM#qshl}NvyY)sq4K6#mvyL+v zcG{GajfE-?Et1~&h|nVO3OX>tt74C|YpaL6&+|DKU1j&m{I7L`xLA)$472)IxEAem z9q1Z@$eGg4A^PmmJxyL#?D!A6A1AUs)CSN6DFPS5TCbG_oJ=GWfRx`V->2qx^U71P zY@KTauk7-{?7SHD*BP###7k1>Si{_<)H22L>PC^AKHL2MnCs-qTgWTrO90_cSwM651{Avne+U{ zG{+#M6s3+S&#(C>b~^gZWR&@Uu?IRmCb^GNUtwm*cVXlH{4O_=-J|!FzLiUY zn=Y=j3FH!nt~XWFQv-U-B!-NGxkLOfp@uoy3lD%g z6}NTt>b*+`$j0-%gQgM%sap0?cW^P{3Sbt)$)G!$RU;BSymEO400@z}lSZ|FiM=Pt z5SmUI>`DfsBa9|$g=mCirJ%=zMfUG_iW8hrZP;|qoz~f#f0K2*DoQAsLJ|SWgZ!(DX zGpp5E!K#*fyqMN__TAmVb+1A~2xnz5?iXQ^u(?rFr>`iSjS?tx4Y6oWV$UO+n9E6S z2s+=vU>+5@$j$gt7^?BVvI-%Ap{)wxNG}hf80Lfv@2WtidiB%7Q1{Ray?}PmpZWRH z^4xY@F$u`1HM?IOVg!CSxOjvqdBoHucfk}eOGtU)`@pSzzViC;4Pw30aX*AxxqI6@ zS+2r{{~_&{_lTCm+;C??9|D+UEZ*P8z3;df!(fRUfR{gPm7RQh9mNK{v>yA;11}nC zFIf=fL(p|?4to70Q=^(K;OXppe{PARt!wU#@0gNi9^G_()On`V#gSEFqn3*Ej;(}) zn#n4>eb@Er^&=V25ja$>)eou_zsFI3U-03e190gC-F@SE#5qBlYoO6AQc@#e6)_Z%q zyvnb(p1Y5he48d7iW)Mx;j(RY3Zh3R_aVreE1%w;{`iK_ukEcN1%~h9R;FB~9!e=;5RBH?2KNMN zG0obNs=-J<=9@4t-7er$JvY|1^(%Ksp_37UsV6k!a)fJBIIrn|`Z%2`lWmKl>{z)( zD4N~Z0P4?x9pwsEgCAODoNE-JYroJBFP()#$g;dRA5u^6SGYIJ^@fT@SJx+7V@AMN zol>1u{WUe$3b*7n%Nm<&zlZB(kjpb(L%;h0si&naed%`umZF|on9YeV9inrc59Ae^ zGtDz_;tr<-w$58_7%gKS_42DnPI{=gQjj#7TMr;*=hAmZqH!>Btrw?nbg&YNobaLS zSFW$ku(WGLe}Z#L3aIt&3x6}sN%&+0bJ^V6jSUbAKXD zl!U=Pj{hN&OEsV#l>!xczAvoh0FA@vvf@6yP9xpRocXmkhuZ;$^AeBt+e~&Ei;N75 z#kX022xu~UYRXj``g9U?&&yRg{9Gq?QM^i3hgr!-dIlpLt@nCXI5g*<4f3UB#b^4T z=7};|gSt?@Hbr}$UWjoev}TBcCa&ZUp7|^@6LM^Z3bUiEaJxYRJI>3TvWvrx-Xw#v zO5DUAitRJ1r>$Tr$0%p7Rks0rk30nQR#zB2;J;zvtE7?ZUio`8coW+}(H^F5cRMZT zW8!|rJTyP1b};Uwafd}#UDKGu|HzSJ0#$z_V*Uz&HJv(2myBE#w#}EPT9Z0^Dc*>N zF*#ew8^-s`jsvwu?G5FB4R3ejv=ImW{sA;u|``wWx6! z-7(4YYilR><(28eacxszhf{!2g4%C_59tr%NL=c)dIlrsRM%8ScYGOM?TM}?Fq<*H zgZNNV8byRM6mco82U6eqt?rexl1L+%Oh~4=P$wY@S~LN}oHt zpEz0lGt|>OX#z_Kc9Y~q0B&N>cYV^nL85>9I^aLO{Cppf$GASuteZ(rV;|57Tz(KW zQ_%IpA@jAgI`Cz=!t4Vb*h18AfKQo8i)*vlG*(W~moHvcfW9ExE4xA?0 z<|hfJnD&24**r1mR`BGOwB0V?!q5-`GfQ}`Gy{i^NSXwwoaDB5_6n;LhiixU1l{s6 zFUme_{tUf(bMWj7tN(EfztCZjS2eoadN~1d| zFk2DdRo17#4d>?R5B*41*Ms^^1S7!OalU41aU~lD9Z&M%Pu<-_IQyMSXskt+8wKY! zlfyjG*{=Jt`k`nk*>FPMKzm2RYxNHhS%jzy0YVjM3k@^MfEhTQCXar>%JrSRZC_|x9#?+lAAoGTzZmLD zzFn*{&e6s0YRGa=C>t-qjhc*Z(o-bJOOMsN_MqsF@ySlQ+!LO(uyZuWaecOPcu@@z zWZK%>GjufmdA~yVW)7zN-C>Y0YrJr~EbKyH)a2qKoIB~|0<&s!*=dX8;bO&1!BT*c zgoY)9sz@a0o84i3vDS{*L;Yf4ISKJ15F0_+itTCOX!1O*-FR|h4o~h7_<1Vyt}@L$ zx8B%w_4k;d<8HX;^;Z%l-W?O%d6>-}3_ax1DJtE z7aY462*d=5XY8vv z8m^_}5KsZR=M>Lu{PP(~vCYJHOKUPXJ5|S$v6|(6`aJzB^2Pm>i9GMw+^(HlUUbQo zFzPEvyI1@ur-x#g1Np4X(YdMTpvHK!PN;yTJN*799sr31ZkV8@Lx25oT*Xi{#s~1o zI{Wk^+WevT_$`VY(}A7ZBjvw;06p2PxOpqpQZ_FvIfG$IFx{TZ|F-22`!a@#*-sHz6atK}OQGN)LB9MS47miNK ztU&;D*~^G(`ZkUyKH<^CK&!nm40|80u~+%ANput-zDF+6#Mj*V$;Sw*lRbfS)r_sn ziq5dx+Kn|z7sO|Eyz=U8RTrC)Z<|oc+(%r4uJ{qm-nKPUdacFf?y+d#An3c2o3Tq> zs&9>E-&q6d-ut0XsG$PNXM{b7*PZc#hrst z(MTp2Q`$uI9P)a+)$#O)Rj8$q?$1v#a7KKu#y3x2fQJ*mOB5^56#?lTfjl88GemD9 zC}6%%#Gb^!usrf_yF`HDq1;tuV$2!ITRXg=2lA#5I(?l%sdEhs3@7$QiBOaMgS+2?D=cNF0h^Mb7Vu*i8<-hl%2#oXKQSp8BYl zWtqYPf1|j5JHhrxY`m};@Gjbriv#@z9>OP6ByJ^FyP@XGC>`WQSt z9)jMhxet6nf%`?^n_2La(1wDGKFhU0nu4Q~+%_aB+r>SW&U>5kq4@bR<%=$Ew$Tjn zAg6BPWJLOw*b`fuTvFKn?9#{=xI*ab(!fW20`~Z6t;BaCB{#LVAaa4lLUC))t=`h6 zU75QBpqB_dOvI}c6%jW0y&(u)K~~ECFcim6*eqm?aXIJyXc^zo6aoRa zP2?sHul;fVBCPA`DZLz;st`$@aA~w=?LGV`xj`Nt#lQ3O0-stT+j}vtYnLM{UV}S+ zSkI3-WDD!06DN~=@?^vM#LTOg`EZ!s-KWUK!V^D0jy?Ir)TDSA)#1}>uK)R?Ep5I= z^`+GE6;Se`SN!5xa+96^w7YLVtQ|GFUotRFM!qPlHEwHh!-Vpsna-e68^{#3I&~`fsW~v_N`Ypvg}OB?(c;qyX8+$Q&?8*pIr` zd~&NW*7zQOyawB<;L!U`*l@-QZcz-g_tVwrCfwVD*+U5r)C7aOW9k@1t7o1)jE(b^ zeW{M*oEk|ejQO1vdwj8}IfDvc={$|6^qbnydZf3Rbiv%J9ET3nY(HCz@6vl}{kF~X z(%)gdm%iE;cUsI*j-rk%cM}Th`^sj)ZmMUJXQvb3(R}j}!0XRwbs~DOOndOe;0q>wJNX7*z(6_}@MZ7E@ZyCo>bJa<2UK{_oh>jqQzszZLIJxEl$#VGAopI= zIh;7X4Pag~5UtjuHXneOYUFHOP;*HiBl@+E0ge|~)B+4j$2ctWYx&%V`fVQEKMXzD zbF+u-d}P^6bg0?looVL2$iTj2ca3*1;@!5NGC*m0o%}WxVl6PnN7)PMN^CC>& zkSbf#t`snQzs@>9|KS&bVc%1X_MZbKD(?twx*C44pNjFjyWvfew0h#G>_cu+Bx_ANvmrQtK{%*x;J6nQ zw!Z5d2-h;<+r7XPbtT_%u%pP{%co8Gz|lVeYLqiRoE%`TovaSZqA#LFP_OIctNnRK zpL0JX1D-^^l@loWzXELk>4InZ)Erq}b#X&Gw_F~QMi&~S-k*c-wYOu>i(QCbAC=yU zbA0+?l5GcG<41GPH~7zEr};_;`dd=p_<84+(EcA&@A!~u+^vD;C)=FN$;OjwGH0@F z+cnv?ZB4dq+qPY&_w0A?bH3gGz`E}ByR`T*?xM~Fi})*_tLxvsieJCdI773nq=9@1HocG%sz<(XPD(4zn>mRkgf%!Y> z*OP!WyE@!N;9R#!%uBOV?&AI8qg(wuO0h%Mvstmz#nxx~RJD<+Rv>rb3;`3~E{CHq zR^C9xx*T` ziiW?mO5x-}ZM9}&59Rdw!>NSl5krdR7eWd`G9^JqO`wn=vZJuh*7S)HqR)1aYLp=~!5fM_>hG2WHfj-V1oUrX4?+tY_(G0j z(MVsElF%kCX2$aU33#V5^y_~8=`YvzMTBmyROWm}sfBSz*@<_416MXL{1>_xjx9Bq z6o5&mtohIb`;l$LLv0H`l^tz8V!!W$fj7g1&0$fs0a|j%O+*(>x*?l?mt>+$np4OxFLBLXSWM%oxnQTs(JMU{uDidHbq=>&kBJ%0K0A7viseIX`#_ zw|Y6-p13%uJ>8tl&RR?@jvZak)I7G$CofDK$>l9TEY$bN!o03k94~O060x>}O~9}C zsWt~IMx4NrjWzv)T0jDAG0vJ^GqY#{f5*)K2m_MoiGD7)$+YesvQ5HN ztRol}HT2BGE*pcbZ5PEw6J7rO)QVQ2{1MVhHlAnFZxp62?Rrw?+!AM*N!EVS(qQe; z{lh9BPujOjdMdN#FALpddm>O@nb|@z%i+D{~ zpx9xa`OH?mHf-(dYFshjlpNc_(Y+ibQ?2ia8$|hp?;PBdt$~z)m>L5ARX!bC$h}-fQaKf224&Um9=&p+gJw0CHWnl;bIrq zB!Y(i%|d~ttsG(9QvUeWLB>^PU2KoHNsojt#6^q!jV?L$&VI@6;>AW78t`^6B!Cyy`^JTxfGeoG+~ zn{pW*bdjV8eJKoFvVW=x$^c!4G@e~PM%p7~^lg1KCwuEzwd3#}JIQ_Z*6M?*Hq`6f z3D1;zPrg813YpkDs7Si{daCufR*>FhKBhPHSC^8d$nbvsNX9f~WwpTRG%SZ}Kd zFW)2Roclx$K6*Dk_9AhXMIBT={VFWryDfqJ5mYX_1lBuV!V-s}gS!HDvo=DOT(X=u zw$J}P>jA`i~KgCj23Wyb_A$S43=q-Uh>EiS)s9`fCOvg=(G z8e5O&_3UqJ`ae7T`8UU%;kGFbv3ui|$&(~SAw_p^!}%Rh+qgPnSEadL$y!LZ&)}GGtC0npm#gS68dxXl0DavY*V>P$|4EnB z+a?_6<-g0pe=*xeVc#<$TXpDLp5#a$+EL^x1DbIQl!n}gV`=Ux$ zy@_>}Gmb^KlvJ&xEDi!o_f}PHh`#hKP)Ra>%`^P5o*=PaClP- zS9=S+OK0DQXUtB*S3`x#V_VJ~IwdH6HPni;`TqQj7A3R!Fj->+_j3|hVL^_9oFHQ^ zl{mpR>v)Fu%NvUyvGEH+MZKxgLRvkuQ@2xE31V)QA-U{@b3UK!h#YH#E2`eO)nKzq z8jInxHS=pWs#KMf+9L{Dl=!V#SUd4WF7_bfA?(x5w^9}$%3{Ecq`ec zzcC;EgZTSFH#*Lfk-1+fHS`!GG>t4WahRZ_bq)_f9{~D8>=@i(uz{}GnHuQq)T2C8 z>yRh0T26b24?h920N1}cE8#}|p1u0`!YpB)KW^h2g;0>AZYH=TrFBU1hmK=7LNNjO zzxqwqqT4Si*YRP_M~!Gpdzmf?8rd7h}pO?I7sEbrqtL$2zCaj4GzeJ~1kjx5sJ~W*Mw*cosz74yjh z?@8crLnm(uPJRJnW@=gC?WVwI%H)c5@|%Q{5pG{W{RF}5){{0c!fG{SWJO|+-9QTUQ6(H{ahte3-k1z0d z00q_}hOXkz@4Dcuv$WhB~HK^@7g_2E4C z9!1ec^tTd-lQ)uUXkmNtp-^ejc*iHbig*L0X0Fc5-Cvz7ZiOX5{aXT)))sZ?s590| zU29#oIwure^_ptyJx^R*T;%+r=+mnXr382Ddyhxct<<^7L*|6RlXIGUKNO89|9MLk zo4gPxXzfjBobWXhplfDxZ2{S3KNY!AV#OFZqy%q7QH)3&@)Sg{#S+t7vn)iDnmPIY32}#pKDPO*)(ik)8b16!~8y09osvd&Zr`aIHL-q_{AV$E^UF%xzvr)g58;C$&l1GzKga>g9Awb9>j=VY`mpyPtp;Ei`s%bvJ{jB^ zyc(g=`}dLgMrib&c;=&Aa}i3_&NRnRfYOWZdt8r>4wlyvYeq%)Gj^93;CVE9f+cVw zX!VNzY!Q(L%hh3eh66Ixf?TIjy6k5(zkoTu;YTB37adc1U+fyP+Ag@_i!ilC7wp-k zjK*kxmVaVd!~H=nwS(56!KZjHa5MNk{zZmf9ZHRF;mSy9BaX6mE#Bj1_CHAQA9X9k zXcr&NhNX0FyKazqjDQ!PA57fD{LxGEx&G+Z33&L?cx<*2JnX5R4FKKj;&p|~Mjz=? z^1af@;!Xw%K?&N*Ke9oM^Hi-N(-=3%{RRc-P8>`Poxg8buP>CeMCT_HF_irtiVwnO zFy}M3I`@<@Uu-BK@@VD=Xs&lqX(~QE>Acu!G~=E%n&V8iannb_@r?Q4aIdE4%^9yu zvSd*UI@gfHViz}=9>aSt0hsrDINR4p-C>?3 zp5>Kp0wA>KmDqjXVAXP!hI?N-Fi$eG-P~&*xgXKb971=E89J7!x09RRYw=tweJd;C z{b~p*25;$T293QMal|EF@?0Z54R?JWcFL(e#a6qsucDo@YZx(UW)7u0VDxhHN2Obs zhw`9J_7f-fQbtOZ!_3-Y6)L5wSMW>I17L#~WoK@ebqEbmBn+*KtxgY73HK!ZBtYBc_i_8Hq~_lvjN9H<(T=?Rv{ z!2ala8M^xI%PwgsJBWnBh(ER=AjiAjWtWB3wtP{UkBDcV-evW%S-{%)%*4N1IWj>Ia zc<=tHX@U8?56wH~f#u@ux{8c^uH!`cA{s4eCxjXAbva{1PNA+g|lwIBEwS)rUX6ljBcw}BZ zG5WT>1YXcfm~?%2o}I-{$mflrWtjJdQ+y-k?|(ptxtcnR_`r29`PbbL2;FksuI)XP zb|^V&RO%LY8I~TCYQ~!V{E7Oa)o)f=Vc|_o;Nv^#oIP|pJ6ACVXq51wQ zukjOJSx5alc{81}-gCub`rTzbT8>={HTUvf`kK_@litE;<1?$Fv;0278TG_ygK1*} za50FZN`Aco(wZ-TJhV$-OhG1W#m%Z%;KaxjJ!NN%nyJ1quFnv_5kCr>!6g6}!UpVE z5oFb;5`({UGcO;vKnC4Z%)J<`sg)gpIi}y4nPa~75ZPq+yX9C?xab+Aw8Wx{fm`o> zqQZ83PL_SDX9=%amu>9!#TyLE&l3&lSQkt))w42hjY}}Ko>@KC60)-P`S~^PaY4?s zNRyvi@di`iyn6>NWrNI78*XRt4>Q_Ee#Ff~3MhWgI2zdm`=6w!eR}R5U?xn<6ou8+s4_o~z2U zA)%Cie8ec*fdHp2JgEs4uu5>B}?v6L5yczb;Oy{5-?I>}QvEy{xN zQDmrBsy2}v7)UQS1-hXFd7Kwk(ua^NQ~X8v`R)Qw26#n*CiaM`!lG;~@7hM%VtQh} za?NUcU)!)c(>TUE;nPO5d&)n_kJ=1}4n(CJ{mtQ8$uHxa&A&A=tPo0r(bY-f+TUy_ zFcq@?@JKLaZ%YG&AN5Av`Z7MM|7wbaO^DJC9e7;-V2%PwEiN;ekfx*BFwO!xIg>yI&qbgt z<7OM?y@^+JI*}@}gL?rt?V4BC)_v{b;l)y5P>tT{(`RFep2ukw*-Axa@OR7?HxdS3 zNu#SOT{14K%!_7oC>5e1Z*0InKNm9&LUW^tXnBp=-<$1?LkLaI2}u!`-Y`OD&*0z} z!)yI<(Cp?MjI}XT+H$)8_fIKslO)5pgwN)TjB$>F`gHz;7hb${lE3VXR)gB>?;#WU zH(;E zxpQgQ`)~vmgeRQlz;kwzJ#n4Ec*tXNWU*0{B42tE<^J0zLcvg0%5^hA1k1+rLNY{V zE^VgwS_L$7zSd3t);anLt{NpSk{_`yR{* zq8EgOZ0j+cza_|E1SW6Wi;JAd^V}dHkNO&7#@kPaITyr7rP$)uga6-tq7)bq5M~f) z$_}D>a=pzn2Ji9CV{28HRw7!+?w2?MRi2{26IUiMKih!OKG;7*N0qj zZwPiRCub2a{{_2_VL2t6h|5)u74g;hhX!?g3bGPF#t zOj*|a(GF-c(VG75Rv=hZwR1<*N}?Uz+W^l#K2LwnvArU1i5(nYZID($9b1=fbTVuJ zRmDeZ6g^J>^@@1=~R>jCez9lEkyoTsbR^6LJ3UnZoW z`m?S~8(8`$`(;8gj3b@r*78;@sPgrh-EX#Y){9z?Y&5t?DQW_4`Cmnc)clO+`^+9o zF;%QK1TY+9TN}Z{g%rDO0mbM_&121T{gNky8;OG(K2gj(h{lDmxaEPe#+%9KtC@uw zy~j6Y(BPfADr9?}*~Y_KP@dfh(6n-BzB|Dm&>;|Arzw%)VH}B>8Am=r1NL&f@X;av z2Tk_(dxI$JZlM^}=Jky4ea9MIU4Nr?h4{|=0jGe zN|R;XgHfo{kv4QiMX+KQAIgvA1dKDak~TZB74e792qq5vH>zLyG|8354VA74A{L1G zq!mknoESV-USQj#t`daaHvFOsJki4;hZGLpL=>fv@}w@AOCqdL*!$lG1E7+TyT~X$ z#a_UPz)!sNS7iu?f9a||t(hkCTUlHJbGt2?^honOO9x&LB`7IT21+{Pok7lI3-~i{ zW4yKe{OoBIN-03sKaPmBV(WqP)taB2*)T`{#+c8EeuHr5QB$f>cKJu$uH(uU#1kK= zRJ#|2WtfJzuOEnxLyO4J-WgnIL`Gce??64_T+K|kP6dg7m%-!#EoO8`-W?~7Z|;P? zPiu3M+}z{~<_ASsCTI+a#5?MlHi@rC8hTkg(m@gWRjs@{-h17GF(Q9pb<8y77dToT zyQ$)zhl?@CdThrkb&20K@={)<a^aG!MfWwqe9w_iutUB=xWh9@`#cFq=ooi;gr3o>&%srk@$Zz*x_ z*qmBi1e~z02S4j%ITk)D09x}73#IpSr)sRv8S2+{G@#0$zQbq3uOsx?si=?2y0c~` z;2zjNAYyD_f;sWz^SOLOxr`yfNZcsZ|789^KKB{r7E4`dV@L2uT37Y4uYfg)BS1MQ z_imlV-Jbf1OV>xKZI4CCc5<(%*roe9P+CpzSfzs4b6KrpDvtd|)}tXl?CT8eYwa1s z5g-&K#&u89MqRBa!6U6j>6R{^06$<8HPadUuF`phQqag`-lb<`-oRnQ2CR>G!-BS^ zJH|lXN9ZF;Hh2HGE_5f?yxNjiXiT)oSGmITsX;e>9za>wlZ*&m-ejjuW$cO6gAx%Bh7ktPV;*3o^{V7< z&6VEZ;>|AA(}Cnv@2Mr#yO$^Q;=8u7D;U?IOB1uRho)$x%ChKnMXIvCcUcQ?b>J6V zUib#GJ$P({309^-=??a;NGOV(=c@>BCk-ME_zgyc$aQ`f!3`=e(c`WWNCjnJ`3CHL zp;S?_o1P3IpL*|vpiA0-KV=nBp&DFG0&%K(MW7nC#?GbTeEvxlA>EPH&e+ZyHYq z{*AdY@H^hHQRdOy;+3ar;j#9ywU(xVR%K1vx55n%tG#d>Fa4JT<}qQdZrww zYfztM-l0Z%$1#UGgvXx$0^#2at(8;>R-vqB>dMNg?R^Vb7HeB5dhFi-bwEZ3iI&Lg z3V&D9Th%DOL_q^l1?ErguVU?)f@*bL*MCmQtQp(l$FuZZYt-K4b$!dbo6<}s`KmF{ zn5u_5_RQ*ruZYO}O%5MVogOA_Q!f$m+IJ(*i>CqN?14aLE$#rG?9}m&8<`Wr;@h{3 z#9{cuuqwlOJ|pI=uM6x5BTD17O6WLswuPL+*Rul36~7z$WtFz}6Tuy%V$K zMWYZZCTySnJIpmLKj{{u6H!my96y*VYTmX|qb-m+dvDo3W&B-=NT&|1?iTqp^!kW9 z?y4?jIN?>RZhx@{jn8OVQhEAZZHmHq$L+Y>c8w#}#=GxdgOj&37g)q6uCT-m3bDWt zUH6P9X+MdrGFRaMV0_YvoV@}KVfMpu$M3BJ)aRur_tY>d28!c(U;}Gzp~BXK_U5bd zW;aAr4NJ=mMCkwLw*v7fr@?@KYqIZDz`9M+pj+?lE{h9lM@)`BQK9VqsWsSNIX6U? zl0>VB&PI_eQEV z|MPvp5R6}XrzkDVw-N90@L1B8$>zH?SF(W6b--OVL2<+i{l8kx_J6n=i##h1r)RML zd8V$u!(vzKjCrd*^LRUXZ`n;c@@^J6wOtXiG$gNOTEEjxTo^rq#bjNhKBd?CNtCVz z887Hw;!+98cgXg=1hKk!qkAQP_AVkAZc3dthTf#}w|!-Q-69$u5q*8=OqH~@ z*ckwXz0{m>^Z-F1(ae&|q;$=bNs2ZwBA$l{yV!PP}$>Of!F{Pz`_H)w^u?z z;he)dCFvgKvIvG$Q5LqH;6<$)#=a*pnw#BV;RdPWwTEoj*Q9@f?{rqW)lw19<;uv^ z^%$E#riOp>LmspyH5;0mCkpi3MGnNiAFZHI*qZ_7?nJ-5P8_cH*_t~9^ zO?+4U>C;T|sG`n;Ggo_%_YyCQWY=Uo2tn3()pJsy7g}ODN*u+YiOfEjk|iZ)pVa@K zLqFlH=7)t!Ac53gU~5$$8$1wrGVb$8D;Pyq1}ac9Y1KA!N7-?^2C%=5Jh|e#4^_9N zCVw*lCcUO@3X8jO$GviST?&IQYDvE&ws5Y{ftjPZvfBnM~Mgd zl474*C+&5P`q$63qb1MH^d!I?cWNAfJ(ve?@_C|}4wzdz=Z8>@_`LL-y3=f~2+m3-tp`XVR>u6~K?4M>8{6-aA5o9~dF^;Y%eBmT zHeo;W(jE~#LNjF&W`jcK{+&3(3)mu{;ikFcQcAzl{0UUOP}^52AZBl4Y{KR)s_v+{{HZrpz0~=c`hbw1 zrsFvi57-Ujf>fna&HcW=ERO?=x>btCKtq@t3z_;e&utRgqI2e|6mL{6=06S(s_))| zZ$2triSy7K1XXzSmn*OOJGgc<;G2p*~Y59 zs;C=qE5(g1CDcFh29~zp>V0s0H8)Get-WHX3zO%EvvUicFO}kD7By2f6HGm$%pnfm zTc=ScO{q;CZoKz}4?C|JOI`o%fP^ejA5(QdEU?E{}Q;*7vlK!o{@ z$ujWx^?%pQ$&^M7-$&bGmvl>XhcXtFD0DH6q#eOzPKDG~1MA@+MH~t3)@IKrz*|+? z=kC~zG;IrJg17;Rv1Ju}9;8v&D}%xCBu7-+Hwny0lfw4PQqcP=Cf7|IrdxaGfdn?< zFc1XQhL)>)i^fQoi9AVk?|c^TW5vG)ebvnB?CUn5G#<>p9DCutc+)}`{|sDfHZj+x zU5K*C?V}k{6-Yu#k-dOHz$@m81WY7V*rJ$$94-CzMd`NWWA%+zh0-Rf>312WKX;Pk z9yB-VQ&yw{?{fYqP0BR_93Y0jHZSwiRjGEp*w}`ipF66DpSUuhj#<(2on8>D3I8T@ zng8sO_YoW;vAkf1l=YCH$%lZiAXUW#!@wYCH)4i)HWuVfTP8BA0Gy zsKzknZaOG#`hXkm;TqEIfcFr7NCq$P3z#sJMyUD>Y73ApIUC@CuIK9OdjIg%AAVK% zSNbEWLj_X%Td#KOk zWMULh9M#OX_0VUyqCZIr1YGvCW$_!Z4m5};M%jS{>spCV~hLKr;3@0E;x{SIwCjpe&)FY=Jq8 zCwf(v*X7EVH6vVOi5fJcfWe%hZFWi*rp2m^7!)XPfj(PUfQ2k?KC`M&T9jIry!0=w z=HLd@;*?;cp?d%_ybv?LJ=#DSOG=9flaFJO6CLZo%K-|F}7`OSROit=kC4hsucLghIV%gK(!*hSw~5YEl2_uSVx>uzQ@^?N=R(P<8vWpesI6p zW^jJw$?b?MnUEpic3lkCQ4rb6ST2amW8Y6kf+lJ#|6vABI0Eg!fIbSoI{Q7k0TBKk z4Nn~bEx&he1M1ZJF~*AYx8Ug|DgV8)t123ijYE%!0R&)Y6YMLPW#MWb*>z2gAX12+{#k+PPtj4Z-i4pBGen|<@00S(nnaHv0+}u#S zLVs)eY9$=u>{>-ksAaIS6>k=KCL(3&7oh-?XF(YPnQ=F&xjeV{;jkS2WShyqcb^PA z-mo9?lyF*$456^NLGl1R!l*&-QL<|c8iAlkfUhi{T(qv28j9Knz2xA3va2>;(L7s7!0rMB~{pK$tnXv20&M+w;avG-jv3< zrLzX2x{n$%-y_B6Z)XDoeT2wB_(uD|>Rug%TR2Wm@&w|gpJL34I? zZw?Oy4n@Ah*-qg)Rf^IcI!hv;Z9|xZ4C1D-R|o1x$6NXM)g)<2meKw)ntQjWTGfzm z9&c|nUO$pLKDCf`R?Q?I(pDP_w}o6PPMudsHRLKQ)1J<=oJV!wS9nnD!2p~d9Pl#^ zG-k&EOp3?;=Y!0yo=vqi<61}c=d2n_Go9 zL6%!?6$St7ohpQLfB020Yra5pzj&V-TIe)#pwIkL*&z)MdDJ-)c6Vq5R`t_o-LJfh zoyHo=&0U>^2#idT?1#}~Bt^=4_(a)q`ktd+!dq`^o8RF;@VPGX)ecXrsfO=2Q^;SN zltu_rLKq#SO%1biifG*OUc5~K4g2$}svJ+v4IaOyX${RU4Y|qWjuhpc?7parz_rND zLvvrdNYavy=sm&ePYCJtz>djVdM8xzI+itYGv&;0K*!;8nV9@q^21 zxkH-1JZM)$KEDqs{#9a)Q51p^vGQZF6_agj^~xg@aw*Ac9)4K~%ge+oKq;8(W0Eyd z!7t<~JI}!XRDujrZ?etvt)f#JXl!D-O1`NSA3?X98jUfNOz$Z&M_&JbT9X=tF0}Trk{v3 z$*;hPE2FCo1`t1GM#dnUIA%G=?-wmz!Q4`D|D9$4>V@6BwGcs+(tp}%8r4<{Rokz7 zDTPz#^XvHi>X$0s6^QVj0{QyM^}yAuA*?TkKnwL*p120jBaE`-Nj-xDWSOkMX56e2 zg6zN_VF)1I%b({@LU;=`@v-qLgElaLZ+JVA1)fo$es#4fhF4xKP9-CAqrQA! zXE>F*OUNZxTahQ(iT$rb-}S!;D+@Zx)kT(S!o0?|zeI1cO*Y`c8@6V>gwN&s$5wyVeeGM? z-YDFS{^G@yM2jz&(&*u}qOG^*{N2_TqE}NP#HiGc4B|ps%rYlpMmvP``<~7n@IDwzWarZ_WVR| z^E}U$-*E&P$M8o(MYYFF!VUa{rNgkDU@k3g#Oo$)e5J`8_DpGSx?uN@KJ=Kps~Z-1 zldw<40NuKZ#Ok>KX+|Q3d;iCr@sWw#WX89BfA)w^JM4!VWYc!%VY6M|?HI*s0N#;E zm6cv_pzI>q8V;CYB(;s1My@3t{IjGUD# zH!`a?NQ%kDNFRljcf#CX2u^m~+cgti<&@WYIzW4%~I3V#YP&^>`o4jkFZK=`Q&I`$7Ctw9L8B^9=zh|AR` zQmZu7tbFQ#t3pOfwTvwV14Jc;7*a|z<^kr~V==k0h6uzT4$aIA;`N2r>9CgLqH873 zq*EP0wCqMz=GaKU8veHGK%kNulC0U)SU#2`H#bnOp+n!6DdSFPq$QMHfT1fO^c_88 z{S44%p?*@op|haJbd7BQs=p=jillqb`DsLP-9%8SFN$n;ePF3Uy>cW#{5U9?x}AA2 zd8tm_(eJbq_v!`^RHBRqdo!q*>lZ(NX7MM&ICsjnUw{Z{3kXS8 z!YC^bMxrS5Lp{d8sF5%(@1f{zPq~XR^m+_>;oMulv2!2R(T9m#Vj5mr<4>`%4Vd${ zI-Hi~Evjl&mAiZrlL09-e`iMFcve3-#q+W0)_3e!a2=lvTOM()bhnN7M}xsf*8-9G zu=lxg`SKBvi9oV@?R+88N}E=|vJs<@V9a1u1(AP9#psF#BIlr^?fFb4UVl7j zmil_B#hM&Cr*a*}+OQa~qAWPxwz45CGKk;>Mwp7K$W0p0g*<;6ygV8`?Y7yPAKnUp zFyL91wu~GiY&5KXC>4fI{fnmM6=1kN~74GAIXd?UcC@O~Nkrt|l*a~%< zb?2}487rz{#Qcugc^gdN|Bv14*3$+O{G?bvA0T{NCb7&=7f(6NTkds=>H563m(*m3 z^t)w3HceMHKEgQ?iR$tZ{I=vYL+Tq%RfB8|9-uxi>A8%MK&z z@yS9vSBQ2<$va%${c&*;WSZ2Dt@i4xCqFJ47p%b6L@{eXz-$db$8aizlE{rR+b%2l z>W~6s)=|*60DqR8&YynwVtJ{ox^ZkNzhw;*t2uh)vRfleh0siDwLg;x7wyW+LS_Vg z7q7M+cq`;Ivt@$UN95FAzLSw%oaukOkXYl}q*^0;{Vm6RNAA|z8O@{gp!_}}7&}g+ z7hV>rl+JlM@)E>po-Ch+*|e^AW~0$%TNVK3>AM#hn!Y&6V?nL)*WKW3_my5hM(!>Q zrOx6VRp<$=7+HWiX5`@qf1br5f_X^2N@K0mA$7-fDt^Rk>B4pO5UTB5rLsbqmL7*h|1BLpV%Yy~)7~?}AuX)zM0-Cg zZ?aqKh0o7K-{QgS=3^t|K_y$82eY4Zd9Zjbh@ydC-=y$>Qfj4<*j{1j>g2@bKwqry z+-ZT_o;RzT0kI!;*=P549~(q;w}@4aeDYuE1Sd*Y-^1Sy=%-I-{4f-0qhKI&CRSaY zYW7O}V^jJC-qP9jucY?N!aaow^BdVmGgK0*hWZ*{ZmU`vD$DysK3jO*oMN^~SQ3rS z?hVlWODRimlOU!9E=k1l7Ibpk-gaPykZNz1(9)<6WI_WKC8cJnJ<2a^S;qh(8HHD1 zC2PbNRwgs+)1i^1mjwxM=E|9;1D+WA5weChPrq-(^M~4MN+++WXG~ zXK-(MIFA!wB0ga6m+0rpt5|OoxmJt{s#*Ft*$Pa_txM2wp9miJ^{7m?F>#5PX9lyU z@qRAllU3t;z(|#|F63t!j4xO0)Zo3_iBt0OU5(|j6{*T0c@zjgBZAWCtayfiTP^Fhh<(j50Uj>=q|Zcy#J|}I`Va67 z)(WfRrgn)8WcDI89VcKPCgKId6s=P}6h4|Px@aXPK52|?rUS`dbqu220JM2TBl%x> z@5U_R!X59IpC(y#+-#Y$p)&_aQ=%__bDIl2*4c3+Q}?>FcZo1LT$QVt*f})E1;9H# z34L1DdS;8O6(OXW{=jiI%r*$hL(Q9?Hkg!Q<4>6d=!=j|X!N zIE4M@hUkA7$npOu4VL>ECc^*0A}P!Mq;D*m`7ah_Wd#IWlNQ~AF}#Mby_O>RhUToq;oCU+E~SQyi|}s0wyd>WDUESMxupZ?G*#fO%1j)G z(b7GJ^gi5J9nk)8?3aBupf{5~vse_^?G=VX3o@qp}X=S-K+mE2N9YOm4YGW=K0hgC!5hEQ=%rLo|Sy z-@MC~2qxJ^r|y8GOY9>KseImC7E-grix1Pj$b(7lJNdFqKlgY7OzZrj8&=Y9hgWzS zl|;F$23uxu%u)RV9{<}ng)YJu^~faV;f*}z=G@?z6)OjQMsET9&vld~cn|#cE}<>j zRayayL492CKZ_FxIq0g>IdFQ%)bXT-=jdh&jmbw0{PanKyC%rzCG@SenF`CP+H>~8 z4AG-EFXqKVze`n?HHxTAfiXn>KTRJ_(Q~tEo;B}7sMQSY?I`}+oh9`=TdiceX{ODm z0z{9=0n2wQT=U}I_+}%&`noOK`>N5xoPB=9VKsfFmEb&8<0CQ}N9)V^*Me7&^ENaL_z|qyfmKXGTc~S8w-YMOhJE$sJvB{ypW*9gmiBj(06QvWCxJ z;iRT#$*)SOlYOkm=c=9uHm^rN5x5MDr9VLXnPK(EV&MU=OV zsQ5<($Gz|n1n~Lr)ZuZqgAJ87(yz$5cierkGyqg`qw=NP<_ez6U$WlP1`(|*4Ow(@ z;?=bWbf|65#b`KcQ6k>&Eky(NBI}Om{j_V%ckDsJ!i&_TB=hWqLm>of;V{OOYr^)y zJ^8)8-i#qqTco2V!p!c~@oP)qm&`IS5 z7jSuLkz82{@LwP=)f0jZ7K#@#dxX=hl-G%&E8LW8cIQJBd1(!;^8>IAq%;=b!r;O% zIZLBI>2SYeYLo=b2EF`(XnU68`?U2KL_euQ)hjqkRt1q(VeNE?1^&Nmo4}k!B$nHB z@&f|xM1<|#{6)~fM4el@WD0eNt*;@=ZHhxL(NFKOaO9Yd7vf|;04lFixI(eA_-((1 zQ`a=K@lEu0crY}+J+vAmPl37cZC{CP-qZdt2r*LFJ(*dd`1ev^# zVU`JIz-WH6DU6hDJX+WZ5>+oDAyNJ2#}1g`9;-azXEfYw2E$T+X1&5H-St;(%H%dv zRr_ZH**&O?Q~kQZNz~scTd-$F9PJGy(dDp`Q<%?Od=eEakm0R6yU;6Z&qReWOu1hP z_up^WFcX7K1R}bYG` zext0kwKow@M(lgx+Q@xanUt%Mozw!`w*3h1>G03ld9!NlY3t6Md>3*3SlU$XEWhX& z+PvwSIO9uNR!d%RGMRH~Qm_>Ja!cOwQqJ^j^znS&(xPYo*zR%!9&P?e|DE|ma=|)) zg8toOY@`Jm!ruW)q${m}9j}_#u*@ysl9Wk_*l{e&#T@k_#!!cC(=u6&8Mq$(lNvyt8&>-y{)I!^EWq3S@E$$G9Y}OgRQ{@#&OkZX2-|$ zE^)-;EC&?0Fd-0Qk zu3WXXJM6g9&C90EUM-fos|dl#ah7Gm8kqCs=_KhY<`Eu^?|o}MHNQE|9&pe&DUfXH z)nx3a{siG`t;y&qm2cii;=7R%{MF6}VX#=5vntyt=t_K7molNKQ2-6Pdvj$r9up0G zS`4uyMX6Xm3+3m$kIvYa3IoTwY2-Y3a*u{57cz9`#a?aB!nwjh!GmSxiP!7}s{wB;_vhd*mS z79l&b?jyfD-Un)FX;e%8Ysy7ueL_@k_{jGO zT~Q`p+>-Mq8aXutDL^p5l6LfI!i+wCRiDVz_V9J+=`%8IsMd4Py8aem7rDPt4A!;& z@LIs=$o1jjKw7jU_GYQXz+s70ypT@GV*G)s@x!eO2?=COYarC5?LG~^Uq*kLMNlC! zD4-TA4zd0JVe1{EBWs)Q;SMHtGO=yj6JuiAwr$(y#G2T)ZJQI@$(tL$=Xu_>{{5j( zuXVaV^gdO)uBxl9UCROL0t0f%iQJ&Q`Eb0|`d5_6xj(??V!&XUUuke5^Zja2an7eB zrQTmhn3XKFFg=@$Khijg7iGeWWC5JeZXTHAZ+0NeN_A?hrm zO(qBP=xC_xh1Vl3a=ari10gsVC`Gj>!s{~m1|m@{A2M%)7!DR?$mMN3W7Irs@)<~8 z;lCwNitr`E)!8t%D45R)2m3*Om<9(2qe3U%Z!$T!fgR288TB<1$}Rcx!VAsvV0BpR z*CIozP`s*?;%t_~j~*-OPGqnQNcCg?wMzNF>5;~jUGHxQT9>&?Q{D_1vE2kQZ%2zd z$wkWn7960fqY)>ft)UW{(Y1z{DD8~12C?6kby8xyh=&oGz+y-l#`o_*#LI+WT(Le9 z1RQjmT|=V`cN^IxZNU$aZg&Xby6UdWc2L0-_K$qdD89$Btyq=fzzmVjBLazTkJnxI zn7J~KoZ7oEX?@m3AHVX2KAw!L_*KCJBS@izJXeI%p8tQ+Pvtv}GbtD%eRk%aI1O6d2R$YsugP6`@m2f=E%>7r8 zO-(rX=B#!END@>?Zwf1M-Xy7lvc?5@USTmbUP|(Co|xMac#4@wyW-S^bM60)8QaObzBxG-QX^ zd#r^Gu_O9>w5esX;L?>L>;l3s@{HXOL%m8%AtI}Kefvy+BR?Z8%WMFnv0OwkyiG+@T)7 zqhnxZJZIbSw@o;ko9@rxH`)$_pd2vy`6ULN{lSD$4 zZ*O@X2wt4Mw4|r!wtHf6Rg6L{vc9r=WfKU6h}GMoOw?soZ0c)E2K_eX!b+^AyqKM6 zcF~XL`P7>kCdtiq9r1(~)J5LPy2?>zFXBZ*jU(T1svD z_w?>0UxuKohsN($D#^K{^WJXksqT5K&l&c8qgOPP&$=%8$qB8JV(@Bf{0CT=Nf{-r zTt~c4kJ69zlbW+C*y}|4RNypC3KNfM7Iq@-CWW~G&vWAnfv}oN8*oTK4g{M!B^I)Y zK3w|*rY4dp3y9c2a<@FwP{bMT!4^;%2w&D)C9Rv%rt1>==gS8j!)ej z*LW6(bvMccOWU?!qV8c(@wZr~=9F3k?e&({vVZ~vl1PQ$=}N`DnoVf2SMLs2Zr>*y zIay{WWXK#233%RHEsu{Ora^Vs<`j?fC05M~ZxY0HJ=2rfHE?S)RV&$sD-9-8chkn6 z_PLNBKQC~HrIaZ9a`;aTH%gcDko9fXSs?z&d;V6m@{leT{5AfZ_9gjhap8FI1W`rM zvx#STUkNr2>-knox({2InWMXXP74mc?nEpo(AT+U^$LC33n&Djd<7*ykZJTHb}kdV)@7|!J7^}tz#XwvWiQ47G}sWyla+5bT9OO7*i z2wxmKpEZ@`>H9{|_^s6i_WZ0LMD^)Ro71gZ35N;VaEz`S5RBmkiZ@0f`t(D5!P|kq zR`4;uWTm&=v=niud&5O;0=+`oY`rkPwv>`wLRaauIDNi zLVF9fJMGkjxfEoST=`!3s_AS-D0&1pMykAG1|Wv@v&ukyO3xRJqZn0+FO9lSBf%6f z2!^{2F4Jd>NesYtkVTLR_C*szWquIr=l>Ug81&lgxsAu zl}&~P-#_Uv^Em~7-G@=9XIi6E-u07DEli90dFt%ZDlfi$ED)`KD)C6>!5Decm}i4SwnC{mY-^m)C)6Y-Aa_<{8N|=|RrU#Y z=k2X^Yu|J8XN}U5HoVN5`6;`Wrkr{&d-W8n{PiAZugB!Q9SZ0l`u&?@Z!Qs~t1-4r z{+(f9m~pP5`i;C?5xw8S3mWBTR8UJ&G$=mOi1PJu%FE9B?&WFS_uWO)H&mqFqZKz? z%sJ`12P*zBpt(2TdKUD+k8C5(Z2b`Eyqhkw`p{x@5MgvP;?JtdAvhTRjt;t^=N+}@=R4z}cj3!of-9Yu-`b@t{juR06><$;fNwtFI zZdqTE-h~;Uvc&5gx>5q!M~K+EncAYAMIo+SHMRfW$lTpSauCqNM1}3`nz(gU`kXQ- zkC@QIVwtdW!U)6InHc7!+Uc)P_O9NV_ES5S+^_nG{WHt%L5#w#LrtpY!?SD2B>L$S zngf0&ZbJwLEH7Xf&PTy9b}T4tH_Zh?&oMU-LyHtHf~qFH9qtM7aW-_D1{QJ8yQu(4 zyK4u-#8j}q>R_pyi;*!0Rko2G*NJsknxkg-@#q6K<&w>O&tCO|4kt3x(CZ^-@sKJH zV+H!+I_uIg%+1O&gsL~>jZ~qAVdsyV%AfRFdAZ4X1H@R0moA=A-rHa^>Tv9JFM6oK zl#>e6VvT~hVB)=s+?q@&1m8yvSoIz zpTBw@vGWn-rd=AlNe&##{P#P&bevc3*1cvIK3Qdh(Ytr2t4W$_T6ZzAl=9U7B&t9*eK~@jI}$6_{GMqs26vW=bMgcIHIzIpDH#<>%5KI^T58h1>e!4tE}5 zPT{_A#xdKk>N`_dNKeU%E$gJ_$#obpO|Y2Q&+smAj8uWggg;9TB`F@D$<$1_h2Rt% zTV%gE#5ni3bX_8f9q?)scQR1kAaHx^ANY<~uP9(TN})7oG)c~d`Gkp4O@7{$W*@vN z!xRzjejCZDz)0s1GVcBXIt>#NfZcM^M^ae3fpEEhpnA|uQzYt+S@vI++ zzul(w3vII9lSd~!p~bcz@Y)DphGIWil8ZY{{@L_p8CqY{4t1h*uN4%T0Ec^e8a3?B zDmm|(im1ksEC(N z_6`Sv;b(Q|>V_=k?jz&VaJ%);YREdAo=e5uc*KDq zt->=%nIn-i3k8sB`re2;l~DaX!3(CbhVB(*fXCOi{tGPIIT^l!X%sDbcV$Xu;@ztt&zO+X7-zlO zWCwZoz-aJD#5ce|Z{t`7cJ9rg*WP?rw)%pXplqKO+omAWn`m9U)P6doIl&`*dtGk+ zmgN1dKp`xi0yf70I*%BkL@6yxupyJ1QY;_en&1c5*|V(V|5ONk<#7a-?HiF-_`!Na zs+*|ev)j#+@aS)bKE`$3tY)w}N?5hUlv}!rh4J*jx&>=oYjnV{r*wHR8JKt*o#fAs z!%*(#->V_0;Lk?_)o^LT*bHrw@-{v?4#ezwY?g?gv{&i6!wK1X-K!ftfc9+=i!DhD zimp$X-5EhYZO+KUJ%%K1-(I5gr5w=GQcuyhQxrUX293GP^tE+9ma!=Vk8o z2)t;lql<1bh$|KT@mlIHug&*D?wLOHvY+BG?gF5FbrB`#ME3mavdfygUI77}HlpkH zNQAZ3x4r_xsGH&Mgaw~6{XTeVH-nEv-)1dNHrb#D5KGSjty;GF6>p>=7vrF%2yII@4S!n~M|9NqTL}urDJ=*EbmXB#VnEj^<%=X5qgfeQzdw?> zZa>j_Y&Q}gj;p9Jo;P^!56*0UWNxi#Ra&2zm3mG73Yz4BsOT8fle1Vf%j~=_@S=r2 z&?_Fe&2yi{4_+bwZL4RYuZom?TD8!^nQ4;Z?$7Ibc|HFla;jraNG)}US83|YrP44Y zFE$(ZNsB2hy8F~*1S+#{wkk-m{^#ZNxuudckpK7N1>fXAz~R$O$K@GRob8GUivUgi zNiM{6=!1M@-OE#|YRH7*{jRw$A}6Cp_Uj0_(ON0iFw6YrHUG&v zyFu!6dP=O^#SNTswj!EALt`i!576gm@;~8dI50y!y+>JhxsZ!jHJ!^6InnWQIAGE) zxYfxJVakdeY}W10pmqMdJ!SyZG=ULlbz2xQxeypkCZW7y>KlcY%#c>V;0(vNzYTQ~ zF)>xZc~bf9b$ei9;6d5x^K@`PUD)rHuOd=Ch)$0F3YDm`3%{~AGmxqB3SN* z_idTbY1TZNuM)c!f+AxvBw}yad17zwbG3^WUo{c=QYC|G{Y`D9nmP?M9!i0|n}jG& z1nUFjKrEEkJ!FI$BDlzhA#9dxABGF|-;=NfKmb6A7ah1@+Wi<0s>Kzw{Tt}|q%BWy zr?(oiXQoW`$tIrNa1B!8;5Jf;Q-dTU5I`7<){^go$8*R)Q9auO-GTha9w-MnX39on z1yjI$2BTgYzySqv=VybsjmHT^QJvQE5Id|W!oDEgQ@Cpo7h|Y5?T73}!(49pjhzR@ zsVj7%iC&-bkrHoY^fN7gu4U5#Jn>r}6)&(1iew5lljB*m^bDyOiuv8QR(0D?dW1Ef zQGu94sb2;hOLx>S3O@L-@vd!}+8Ch$fLud%T%-CQ^A+H9s55Tsl+K9!7ACKnOI=DPSRZiCS!6VQ! z`aSpo`PLmhsqVsa=a5|yX_;AZ0CnH5$R!)MI9M@gm^?-@FB`sdUwZqSDH8k(#t0eOG&JFq3wbC09T_sav(!=ru z#RsIwn|ph3yKKexEyi1tfT-;2^<)7o``7pXt)T!E-O;%&V-PFa(Z;W@uCXMu>N)dn z#9_LDwUg1*Xxx{Z<{+89cX7#sIB1l-+Ns2>yQCm?P^TS(n_cim_usa@#0y#DaMGPV zLW29>cc9Q`4~QwK|7eO+0y?S(2K`hVt+`lcpN(8OG-;!-i%1kv9Qdn_8kEm)#!(DM zp`uH$p|<)TXI!Wo`&F>@x|`T!kuJ;}o|LkqROQ0$UoU0Xh8x-H?Z_c;SE2A*Z+;+h zz%g?6Bi_0s0-j)o(8p`haHgv&O_y7SfIYwYnvXqmrV@ym7vFtxzPZkK-ae^4m+@}T z6wQA)|F7y%l{Zj+=@Wq0WjpVDDW%%&sK%hId`I%@&VNziFJY1I6M3;a5oYbyk+&RA zEz*hx{7E!!2$#H&RWcqbF=kDRLMk}J<^R5BfZSu@w{1cTKYF+*am}avUQnSf@%}pX zam^*iZBIRN7{1!PDNSOdBlamniBzUKh1w`P_B zj_c6gr;DuO0~@boQSBz|RjKgY*+35-D=M*b9&b|qe;kW!lCwRhh! zc$JW|UmgLf|Df`>-59+A<2hbA@Z|VgWK3~yl}l&x`8)0$%}U)cd?9cTtCN%8+llkH zo&AO4Z*MU8po=?ih_Y9+^r!0@9eEGjyV&<9{r^D`aF4TkRuC<3=H<=+RUPN(2|iE+ z^kX(*a&*pL6cUNAk&XPfDFr>((rnd06n}9ICGc5bI2s$rClL;XCUMhom(_U z$Lei+;YUYtpNiqp*wnyqFs%ueBpSHSyOr9dYyXUD)XQXznz}xGjcPn^Crkd@B@B4!|r^(zuX_Wnk z=V6cKwKGJ` z0SUVAUQk!}uRfsDaZ_5QIx_P>zx zVq)L}tX+EI`3vU6=)}ZiShcSmSK;fH5p4hc-dcjEq~vn~9A5?{qYCjXl_tv6_y0pI zaszdLrQ<-E^i_L12>|kY@YI$Xx*N1}JZ}U6Pp}b&<~laLXvHv~m`{C*+1{RtRfG+K zofvLkujaKaenR$4-3G56FuhOB_x`AX4}XZ$MpnIb? zxVM5Qg*`EBW8%awwMz&=gkY(PVN>_75;ba`WIr}KooFv>oWcpR}$_|I;^*zw{Gok+x-)+ z0mv*nqhD12`CI``JeP_7PjvXYeEkMgrsgWg5BUmiZI6BIuV?`DztMod$6)3Xelgjl z*+DfBnfe53rGL6|WU>{dMSJfK8y@nFr}1ZaYvznGYox7bLZJpBs4r;>qpfI|lyrh5 zOc7a}du9_^T;w?Hh+!c(hhdkVTldo)?3(dM|ED6uMz*U10}BxFN7S#7(@7r^zTo{j z-T9OV{mltCtWX@~32ASi`}elZS6D1T$^4g{%TAk}_533gq3+QG8k4@1IQ;IQc1x1f zpfbYURp~#WtK}F#!O76)l3XCSO?!|&=upuY==7^3nW0xlb224#rK^NV$aXUgie;9; z6x=1zD97M=a8R$~y1zdCm;C{4nIm&hQ-fxjs{#_qpSlR(l0Bhl zxF6AX!{KJWraAh1Mx68p3GigFg=PU1@p9+rh=vI%l-K8etX1Ipsm*SS^2L=5O{T1H zf`+{=2nx|nIW)aOn?#}}mTX_0CluwV3x)`a13F#dmxaym!sTVP+14Xhj6Zc~iE%0O zFQD&%qox!16fR=AT7(U-uu=>Rh!Fu?3qb1#Tc4qzII%3=#H9RM`aW2%Djf;H`hyU0 zGfO$G-C?BBQ;-5!J(Dk}Q7AchsfXaG1Qf2WGF3P>f@$ok+?9>e%2^Zk;loUN26 zC8d9C3FYgb|Mslvw!3QI@=xEYxx#V9{9iPDW%y!=U}N0ixOrlY!m9;ol)n)Ht#Ab+ zFdQVJoqafs)iLXYJruvN1g+OnLLv`r-GrhR2CnFqKV33i$+|ryKB9*VYufa| zkU^?ZNr}t|5&Tdb#2X?P@m#*)_yQooA6#Geqy>n%#P$LKet) z3mM?p5i{|-GL+L~UgJLU=d!0l>zzw6t|0VOK`A3?Gf^G{nQrT@Qr)Vc^8!<^>p{$){m* zs07XIPrMFQegr-^PZ?cvi1{R1Ax9}54s-q!$%rm4{qvE%!?jqu)Ac8IKOqcTiw96+E7#@6z(p1@MmOeWrsG;_zjuE@t0xW1Df`5HBsnvdYGiO43mx z8jLdpP#Jw13e4~~ollw-U)V>ye!lm|J^2ltJHLQZe18NAG+JfCXV7Z4h_OABkXR<# zJ?~>|7@kAn+}cg-KQ&~w1T~}ILbv1NeUR?D5Z14{kSe-RVDp1Zaftum;f~hSf*I(0 zqyEd*f1%Lz|3V>3h2bJ_TH!(DG?{G*8i>b!JkW`$dHKFzs(oapLj->W6 z@ejE6b5ZC0-mAQBiqfTP*wtk`+myh&&Sa{37Q}?HaNS3$o6ijB{pn6IorsRB8BhH2}BKcxS-zptjN|+b6CSvwS9wi zeihItTtZ_hww^KkPwX!OnPXQRSe2FI( zBt-4ADS`no46s6##E7O`e||#xjG@J==NL3qq)|*rr;tNX!)*T=TH_I~c!<%X-vWX$ zK>N({_pt@A^VZ+e>no?eUr4S{2`SaBT4ED;Y)M{tVpkM_0^1*1s97F}OLx!6k)?EV z`J!=KY=CAP;E8MqF3sn=cr<=2XKlfp;1)A|Pi+rRDLTUF3ij(?h9O5-eq0_2?|If}}quyI`GA3h5L zZSr&!LS=!EjBg-4)on*fZ#$|*^!)c?s^y6fxbWZ>B&N!V5>OAyq|i*li| zzdx4OIy&T@ALXQHi`CkVUKJ82Z%J})lda&}Haa>7D?#$G$f(1@Dv+J2wceZXJJo4v zq%05`4psjk#MHu*jYp%4t}w(O_J@uc&KG#JkjE}i`~*S-$q>tHqF4RiA6Ls)>7x`X zht`JR>Ac~}KmzB2!Sspk9#SAZ2C?5^ZV@zI*TOl8IvB{pRRT5rIJL1~g54_)fDk6{ zM4zn9uxv1&$U#C@-eu1oONV@}!9=!Fhs0iU-n=QjL37EW&Rd974yI@~^9Lp^?)Vb; zMn|qv{s(EZ*O6l93p2o!`?S6k>Cp^Al$5hAv;%EZO^tPem%V z=-iDOHV$3a0PC(rYfcJRIfiXQYL@SJNFMBc^U4H`WT~gm!Xm|V5tl8-0p|JMS$AnS zS-Fu6C?o-<<9G^Y0>RoVS8E4UCN6nYKpndW(xmiss(fxEeA${1xGlZ7oUiG)lvUG+ zSas@(6b`(KH}>T$U@d)0t`}RZc_ZAd=^&Nk3rQTRdRo$A_1w8vc}FNZnQVMGzAX3u@?ZY@N%V_BhxYGP*ef9p zkvL*yptCn zj{O94fDx8X#>ir7K?Yv`U{SybD#3qAmDsM(FDtQSN;2Y{ib2@-7{`gI%jQkG{Ekku z>l1e@eiQlZGp{pByb0#`%Lkcg9zX?W1m!3B$4v{JI|b-=xt*LcAP)cv?#NQtGy{r5 zDHO5&t(&z53?k8ALRDgNZDf~ah1`W?wiF?^mqNO5r7Vgc}s4 z2TXKSrdIgPSNLDn^8Lq>6iTl;k*{Q(FX>MqTVv247LK#f6C{5vROp4!mD9i!HX{nO z&%-l2Z|A+BUW*-TM{Nx+f-)fP@djGKb{bDr6t;xv^?f{SO0V+%Uai*x;%QO4%-6cZ*#c@rApx(9m@uY~-#Ja1 z_8KztEPRAML+C|$;rJO5aR;x4>N9guGRkosJhzkoZv$qUY)Q0~yeyPKCI z;@y*rMN*^Q4xr)-WlZsMcdznq3_`wjGHiE>PHaLE zLar~!!*RJ(?GzF#7Cv7X`W)#(W4cXtD}Sc=T?ds-hK}If)DbkrA<%MEb=rGNTz?BP zz$Brc3&>IY?csK5ruO+=Fm#fRvgLK-aTMrb+}oqh%sF}@+m`fIF)MijYUMH)n=-+L z;!v12^PysMW+`-yRm3my;h8LQ0S9qGD-E|AH6t+(i_i9%4mBt1JTgT8hSGrY4l8j^q`Hy>e-rWnloGY@{ zey;tjXo!B~`q*X|qLfb)gD@L}GF%1>lWna(^qe6NkF(M7BmOfLJVX>^fECxPO7OKy zjnP4?2>=XSn}=p>5e4l<)X*S@7#UE}-u4}!Li@bJ-}DKhIDR6urIw@g%rB?<@JWg{ z@>h)GG~Odozjy=Q4wfa1t_#bOTE?t|65yA7fXo}`F*d-y2DBM7kti&UojVTP&Ny-)rC9-rT)R&sH4%vm{ z2iGF5%Orr{a71uTmwjVTiq!FT5^SaDOzth?2=u%Tfc;!86P+y3?O!5EeY{p#!J{5m zPx|(Wj3bPeOY6 =@hV^ry_n>P4I+VaO9Hg49pbVPYmLgN&V2sJWXT0cH#T<|tlu zC0l29g_P;-s2}u6CRL6QhW;nMWXUNUJ@@6$FhpVqnWU=|inijMK^PLyDqxSs-!gn; z7$duTextu;cT*~rV}kpt$Rw^q2c~2?Op8=Mi6SbGEAKn(?3x?8uFxL$(#Qw>=G(eb zi{4>XY&Ko;T_Dsd{6aPsyASFMIXh^Igrqhg?| zF#f5QtkOnv@_VZ&GlB&IF#C$~1%TTgKM&P7es)xmx~i=E`8n-i2aNttTmu-`$-i1_ z+PIM`DTzb?iL}|)Fl|P3NY*YM{f5!=%oTUYH|JuGjvy5sw~aK7qH2%~*aM%8Kz#;i6MjD+NbGP~m$uAyj=}4B&>@!QDHL6XFHBu9 zyhSjY8$90!!kG8$_ZW@k-ls_yv+K0eMlFFa8f#4?GL5o`#9#On&fzd~42Sti$G^GPD=EWTdYzQ z!MKFnA9Ay*e0WY3%(liJOT_Q~8sbMq%AV&<0AP61lrm^Soa;bd;`S`lddj=$Z@0iZ zqyFaZyQqj0eF5o)P7r|F`bFvS2J>CXhDnXQGM_pmZ0>%v@Mn+DJx$oJ#%rE3_4#ct zKTi6aNi>e06Ca=~M-2Q)yU}J%0|smHg`U=ZWFTl0GdI^DxLSVUC^>4 zQl>Ax0y%ts!o%8woAe*T4!6VDoB?OiRde}Xq-)%h={i0*bmDjnZ{uXqpPqEo{u;FT zJ=5H4j$H_+w0ES2N$v4QiHchzh{rBZZ~$QkGY5ZFqUFiP-32Xxgcmdzs_;cuD-V$j zA)=weYPm4vU6@C&v39AA>|vrWrMBb|v9+;2+BXss^_XRH?T+}Tfn_W0GH_%#Fql}| zFnp?7Ii>`Q!1cZBgu$5>?w?p8Xt(fvy+48qY(LS04B!Ph*6I7S(WdzJ-dyKN@qlCI zTy^BBr9f=il^Q%cj}}4$V=IeX!GQ;ZrAb z5z8+8t6RY3g!uo7tFnLF0nl9OT2nr5Bp>JyTgLq(a&w%XxqTchc+%p^y?UXo%8zV} zTr?PJIqvq#WyDIZ)F1TgRlCBQx}*TlMgeX|9;)eL9kt9e7pU-}{5~_56ZQfIIto=k zR8yTi%!*DbfbNPnhb}sw1B973BfcdfdZJuUSX|*jIU1VKwB$v2T>$1-InJO6&Ea(S zILEHG*OT|_X<3-d_CClBxBv`h_@R#9hTPg_>WTu(o&_dfb49F17~41{70`XMzFHd^+lvm45??(sD}2DjRB zLttV+>IP*yXrJ%fAI_M0k2=q1VPO}djObxGYK;hl(iQ6_&>yG$KcTPhM0U@jCJuPEAdq zF{wsJWufsv@qkra)6`a+mq&+i%(BNxUKT2(7($TbmN;hZ?AnXi_=$I=oM)_zt2*QD zsqGFL&Mbh5Cc+~xHej#p9up1Ih&}#U zCVd8TPgLB3jM#CZnG;!elo*4pw3$CP9iFl5bD#ZHVE#|0&|R9ZBDDT1iB1Jaa%kyC z1aG94guZPqZO6bd`iIV4)u$aQktCQ|VG$q9vg=8FBj;lPcqT4Y9fTJ<7_d^lB{%(m z>hpdX#?x6T)g~+k4p#UrlB>{B74WQtHTU@``MxZpY%!+gTwG6iI85Ce`1ZD~ccKte zTsPPxVh%7-~qRqW8mbc2g4eH@u^Dc0!QZfZETciA{ln-%zh` z@w#?Mk<*Hm`=(7ZjIJPG?MDa}pk`P&C*jzogePqB+{{?z~w`(ICr@`kMR=F{<57b`cv&Nq)v8L`Rnq9bCb%AJB)X;!l@+^x)R zAhklD7Ub!1$^~l8CAhiAD%#P-47gj`%U2{Ja3E-fP!Uqpe$cS2&YtYhlmmLbmrbQ` zMf7v24fUU9CzJ&8pb!!y|<3jEdBBcfM5pd)}#@8;_2UDIos-FGK$E7V1{$a6& za;HkgQHcmYudx68ZQnO&w7UaFfeD*X^YrrVC)ve!_-noXZii6-EF-ZLQbVSurV;M@ukMc*O!l~p)!Kn(Kj!Wl%{$nw828hU!nFezG% zLpNF9)Yq=X+M#`X#wf{LD@xkETOB>7`PdNHx(*!W@R9s(Yui2&wNyV{ZV2=r*ek=W zeoz&%JG;_4n_5q>U(T+q^NU+U;0NzA{Ft0}i2=pKK6ncZ%;G17R=87zl}UWq>iA_p zbb2|->iIm8n31D&=5N62UK*4>g~zJoK&avfS26tDny=(}2S=Sk*=Fb9Aj+SOAxwEP z5jv^opOWwteK&EuL3Lq);E+*btOk=Wropz5>k-5>d=u%hN9+ z%eO-Ts7zewsfAgCtL3~NE)_e<=;t9g@H2AKvWrH(@gupx%qD*m*~}ds*4#(#59ka> z?*>=SNe2uYv=3VDLAXo_hE|XI-srCeb$0t<(c*2V_Tf$9B=rYZFe*!it!qzT`#b;- zXF{=ol60h9;ExnO259`>VYm~pLdzQU&H7J>(!k_4#NOXO5_Fzuay@&5-)rs`+1Y`0 zcbBCtc)=^1sFA<1t2yg}1Vb^Su^fF$Ue~fHl7*DwKxxC_aSb8Dyb*c%{OdvUe|r!h zp>+QIswR4QX*+SceRAUI-RshBf!#7j2FkLQD7mbx^QH7U2O}N_V@4gYTooZ!6A>y+ z)9%!iiQRQ!B#Et$&3a3W16VXW*ea-HF=+b=JW6zjHNhQUe%u$VBs$7I zFUBj9$a$wjT9!LS=g-N*DjtIB6Fj=dD+63_YTydkqnVHc; zCyJUa$>pkU4ES*wMtdX(<@1;i9*-InB=&F~eP5SSu8QOki;XT%9vS%Q=DrEi%r%YS znDjDyVy=U5Ux%}1!BTF7ZdA~s@D3@l?}(xZ@1}39q6z(jy9EZ0GCMH6>~Gy=c>s$E zbsGikEj)(4Ijo`YuBt+Y#0rVH5K7!iu9d83P9Tx4et*OyV?TpF2x0yhz&#@+IG%m_h;LhH2{o#Wc0GXvyVB#PtH;K=#(J3XD`oGUtHI%oa zK5o+%?DHy>5EqP@=CkveODK=zTc?%0pYsk~Fw0gJR1E4`TR$v{g)7$8s+eh6&yPee z>ku{3mtVA$an6?WINek8vL}=$)?Ex8Y(Sb@4_24$-{91;bV_bV1!|?ojFf*rQk?FI zAKcFmT&^AUkr#1Y@cC8 zaNhL$eM{{ANK3=}VP!9}cXrjAqg-Z-6=9k+yXMeK5cV_|uf*!b@`7BhX6YYxtD&I2|0-$ndQzh=LvBs6!t+MP;g>EW|xc#4-aAi~4xf zoLCoTeRX%!5ZyLXIp40e#I*&mP>0sfB}XmaQQRS0zvta#$XP7^7$?b}Q|KYu2mMz} z$gd`Cb?~EBWP)ej}k6k^X_CG-!DmdJWJyIN8+{v6czc z)Fj*s7UvGdC6^L7i7z-ZP8Rw3Plmz&rO?pj{jWD44|ajp$iSX$#msY`pG@r3aWD#zA|ov!jmUf=cp`G=2$N|lDmnlhs&-9?j|2~$NnwuL zB=pK}Q}}fn1ds%i0{zGKh}FF*3rm88s>n8U&j@`oM4Io>3k58Wz|sBXWO0(vAG}e( zPfdcMdv`N5U^eV^TWkRw`P3+P${K9MRgML&@fMva_sp-fNq4`%W>=ILpCTXso^)u zvmd8syJLz7d$~f_?>ubwxlOsMy1Kdo8LnIY07M!BH4*7y))A+@-FYv7GrRlR#eMzs z-Td%x$`yyzFuKg8_zpC`aYc&fyR|zuasYJvb_c@KdGL;SjGjkFhnabVeRGxFPiGbo z_CDhLi5ZB-&sK!aE!Q37x*+V?>-ID_;6Cqoem)M@o3QLpKu$o{Gi5Zt8i=Zzi%DtC z2ipt^IBXF`)deqo?bS9$d-0!(H}xIHs>7Af%wwi&tQQi)YDP~WT5n;#4{!#*uqNRl zwMZFMBOee;d2{Rfoi`ud?XSGi1?*1fb) zhK)tLtlI5Q#}vQCq>sLmlX#4ig5*&+Z<6Me=V)G;0k*1ng-uOHNo#46=DC*ED$f8$ zHX5(u(Dwr^1;psukq5^m@AnCev<7+8t0&3S>$=y~&9n>OiRr}`El)M9@;qmgRw-}$ z$6HuOlaplfjj9xJd3RQK)=4h6^wevN9B(NbMR$lB`}(xWjc@IXy#ZnbX*Ft@O~9DZp@n0 z&uz%MZ?efg!sMEWVM&kOSRGd}<74&gP_$T|zhStLT5BX;Vp3O4kqIYag5BGSS%72# z^J%63(bKdoVC#q_v(QNhW6Eyj`?tO;2mny$#g;Mu$N5QhNCEQ=Q7g+~>}9Uc`^V)U zUe>!wJuIT_8yor<)0edS@8ObLBsUl&JBkExurS>rGzH&kEm31oJoS7*LkcB0({$*p zZcNHYNec9_bwa`G^+Ik~eFv;4qDWAW$rUtHG>!5r#*Ef$#EtBd&mlt*&~L~+tor)- zvNka>Z|n&!u&niL@X$M+b`X(Z&;4yvB1mF)<-lyJMOo5A!-cgarlSm0LKF9O5=AycS_g~_Wmgx{l2l1?rD&b4oycWGZuF3}L zcdSqO(E?}#v7oFtD}VROTs-WOVGaFouSe5GaiT}>)?c*O;l9PfqH1u#iLauqSUl5J zK25e9;d$4c-LaT6BLP&FbiunU?V?!pjc;$PxAf+DorE`U1>zizzVJ!@8ZvG+y*U34 zaCyCX7{Ing@Dya8RLa+Pd`T-Ntoa!CV{N$_nY^sbVM1{PV=PlLl5a9pK@z&~rn4Ejk+f%{qCk8du$-8aETsP+p_yR@rscKa@9{+Y0J6M8 z#2MAHHg{lH%LgH!&&6543S9s7%iG3d{!2K_=Rw-H;e)9p5!F!QFfIj*&yR$x>GcV> zc0=sUxeVzFSnj3#gUnDjU5wcTV<)NuUB^IIoJ4z7fY={s9umRH3>%9<6io7r$&=V* zTwTt3;xUF=1^>at!LP+4GElidSi%>XmRagcGq9nc^{KEga$NevLC<^IB-n(BaVITl zvY~lRL#40y-Z_)CoNBV1-5m?_Xy?!C?}TbcuP|n0rv;G#93myq%ymr2Q7FFgq-AeI z4`PEuBTy-Y%*k7%YnceFCtiN=VRBz&5`0x_shO-GDKcP72R*I^Aj{D27D~$Bvyvz- zIyj0=F6LTwzVAMoMAF@1g{ngSSY#*y~zH%-HrFrla>iVVqm3}E?j2R#!MilrJeZ5q3C8|9&66psDYDt4{3F(@&YU$QIrwUM0oa7iKk*}@&OC+qkt zT6}V*EccrBliGmw20 zE;l^bHw4VpFvBOzsjrZIdVNA_itXLm^wJ-5R3i%9aR*~a1eXEAT#I_-fI9vuIFp{87uyYga803iG`Z^4l-^C37WSzz}$J zpubkOsIZGM!*y|4<){7~V-E6M;9Aw8D2+6xcWQVqrp>h!mU~5I`0iW7J_I70V+;G5 zcFU%>BwE8$zEG>h2~{3zk3P9+uY58IvQ0Tcsn{`lPQ>R*WL4+o_Hqq8SB>KO9?K_G5{*PP*2Ux7Y*Fw~+i@_2&qAzs+|JGYPXqNBMd}O6aK43Pp~8 zOhx0(*RJ+Vg>X-DSl4`}ZKv=A_SXyqIy805JR#fptqLx1K5WD%{B}&|BNIN|LY~WU z$C>+VbqZRBOW{P!3N_BsH_`3@Q+K>oIJ!R6|LK4dKi!j7lqy=MdE*SMuKn?pzx=^F z`B14bx5tNvJ;rdP)xryaajm2Q32Oz1m{=l8;#n8V1JZlSj#hY+sIUM0*wq5cq4r{~ z9`#u)qS`cN$|La#_TY%(j8iN;#=5*g^ZFPa5(aT|>1@zWm{dQxq|nOd*#)iRqr%<# zghOvsSG*~H;1h}R7@AJq`S>1MeO>4CWE*0Nd!#Sr>O`K@q#JQvHy`H_U5Hz#k+VLj zF-?E-|$EjGG(Uvx*UEi&iY+b;v)-oOo9 zp^G*2s=N_6I;-at4*c=t`=5M--_l-{7w)4iqo9pY z8}6cFc(apiD?tAf-X>Z9N?ElEk7nf8~SLlrFIXKah|umJsXpdvtJ5T*I765mi7*Q(>}| ze;oTI^>q^m}bX6 z*tYGCZFFp_W7|oG9jjw=#m0)$v2EV$bM`&={)PEGvqp`o`rhFncClL}$XhuqYGosc z04h9)bLR)HL|##EQa>nbj=62&75ROh;?Mg^cKao4*%+4c-GP;S2kRt#Er2>>g=_%B z*%9L0E)Md%E|%LNeTi@t4>B2*NAICBTqD}_hjsW43@SK=0tVEA5#-jP*yjP;n zXoz!0R;}+|gL*|iVU}GaRDCkshg%N!sD76E7xc)i-=y3$_EfLZ_I9xJnQpm14VQkL zNw9F5&skHVUxy`hoQniyGV}yI!?wa+>hnX#P{5t4PYa^yK{8?V6(LcS#1v80uZ>1> zO`HOYu%MzB$tZ->iUeCOOzlu2Y`WsLj{9|oydMNgQ5>8~BZU54HZMQNU>AeKMJ;Hm zusPqWsT+V}ql&7kw(j?V9bC;z{;ZmBVSj~J+RiY&!k|T+sCL_oyy0~al@=&+ zSEsPXfseAedvwMCkL4w5w7`I8UN@@P7*r)$(nZrvt?eFAtKP_8G zaeuEu)xS&<0IaRRU%9zC?2)6>@ifN#Maem>G6Mq-CZiKW+9N~Ycr8H`2jJ0>&b+cG z?c}a#FFLL-j1?WIsx8P=<-V~L-J-l+ua$eV6B4Tr5COH`f%8<3#3$fx!i(#pzsI8i zb}GWrvDN2kH&?xj-`!b1p&^Stl-v1ja3cu049Lhocv<*}M%K^#Fc{xN5?Bw-1GS~!i@JHRJ7*=K4X;sDG7B|IeNpJ6;$DvUb6r$IEZ_^MTAY0cW1%F|~ zuJt#Jb1`n@m0;f@B6LW?v{dp~;Xg()Tjc5U{)KNby8Cj8Lx@oQkV#xX5mOqCsV22Q;TSA)iH z*F5!)&_~Ui{A6r8M(ng?G2Xe*wCuDa(nC1gWBU`VT@eqT^M^7naFjnMbiC(<-;$b! zrbX-fu-opr8iQ+DYAU~bGx>s#Rxds~>q6tTIt8mxX*(x^t!}8`v6=9fF-Co z5TJ+k$Ror!ru~wT?|H(~@-N0KX z%Mm9JoS&RDD%ZAIc;E#G?MRXUHorpw2kuo$U6vg_42Pns2CsU2XM=~~0+T-&vjxI1 zOe6KL8GYyB*bk(yXuNXuDrCyWY*W-{1#eSZ@uu)R?L>-Zt!!++MUnMM{*)kjpuwft z=uG=(%^z0<_-6t1=~5R?*WYS~_w)|6?>w{ztnhPXkNGrJ*!r-rQPXUUO(4=@oaAJT ztbOwv-G|~)26L#{y=F?~A-DhCZfohAz_x@cT#8n_;){jkM^E|QErLr2{{J^mZ)qM{ z2Ai?(iv#%tmuWHuOrCoDkj{;Y{s~E>NRwe+xEkO4?k#K6HGJzLZ$4*uPp2IzN1`&V z6qPMQzhX$A8$|^giq3GjkI}W>tW3~dy_m8~!WgDR?F_Xqn~Ypt^k?mg5}u<^iK?WD zYtwXBEpw|{zi470oAVKShx89uvL4X^BGKWUQ`nx;ZNPX)_N)vMB=W@MX>@7UhB|h| z*aOqT%d4aB&fz+)z;5s+rHuZ|_gDV<^9!B4i1?}1%5TP578>zyUEdJ&I}R(b=nPM7J?XfYNLcBd0J!cv#rFq{>GxYl*?VLgC$U zi*9C4_`Rr8=JYO0%Ai9rqF2F9!10z8=DlC`;huw}1Kq7w5^;@*qE=tk7IY?A2^&u$ zErgPksSzT}dbNXoCMq#_kAKqT%+~x`R}Vwa@vCVsP4>d2(R&Te=`=vD7zb0}H46m; z79QGLyo1dNzIkf){)fkW8P;b&ymX>VCNQ?cd7zC7{dHa2L->$oGzLtjAES$5KcUuAJ2V%lrtqb5u2xpzTW11 z5!b6n{Cqes+(2nHv}pkAl+jJ}T-d zmK&}a^;}jsU6#wq%a8_Ou^##04Wm=hZ}3D>>cwG|%ixs%##}V+B{&>R@_=N;*~*qH zwRi;yH3-!fg>di((DHrbt&MB+lYDPNjch%WrXRjf&!UJFwA39mBgbHCB+iY(r`EyY z=Qhp)OHnN`+rlAR)b=^9 zJa2N<<(d%AZj$C8^)YD|*3Av!2l3(2n-s+%pyDmW+b%(?59#SH&_LCk_M4fB{h>pEbRrBgp~ft5m!=#e_{$-}z^LCJJ}<@mnq5Nu?2DD1&e#h8=5Sq0#qfDY-b4- zn4l&se{bG;^{g)tG(;%9Rf>|INCgce<Ag-8mh`Kl%*&5YH+juOtuVYX@$po5##fmDlGaGXMsIITT0#>jPLiZg}i?c@XkLMcXPkLEWt_|31uNhq1^O} z@X>8>C{9KPUqTIq@+pTfDV3eOXQ(JP>UzZ`_m8Y|Mft|+a}^irHBRLhx0Tp4YY3>& zP15{;W5azu`f!U(Qxu1d%l8(KU?73deP|@}E$Ju|H1e1H<_#eP#!CAE*w+VTf zt9FGZO0()M3cObn^2-<&3u-%CP7FB&rh`8OmDNr%uGw|K-=Plkr!%!gAgU;td?rJV zV&M{(Q*{@`qX)E@r<(EXd-nR)Phq~-UQvoYlgn zljf75J$SRYvZI|YYy8ZrdecO1Mu*RG%5NG&@VHmJYFit?hjcf!GmBak%_qd+WWbl0 zxGhNCzZJ6NlQ!+YyraL57C;DcRAGtkg%KCY{dsLM6J&J-4w)%>cDP_13x;?cfgw9m zNvIg{Q?H}ujKEqyEaODPiW+bN9&zg;S<0rIeQR*d2qaCnrsdf(NCK-t*|@=x_&iX|8J!P zvzF&FTKLs;DY$QJh)&<9-=(kvb98jWG-`;+R7KDc<=5~udw9wyar+OX(eaPi`OM@M zHd#~H@c1D*{)Vg}bdP*|Z~2qS)Pz{`^i#~=DKy6p>+Mms zAuZS|RD*TSn~-`SpE<+R*q(Z^cJTR6C?fRQ;tb+#dY^6dGCi{gENs{JXf-jp!96gj zh=0&mbD;G*T(2U~r!#9BrpYBpZ#XK`F#$xz3fT>tah-201aZBQpb_015YWk|PUK!P z;fL!fUm$(>bpiYxSH!BrdMGfI$kAQ=f47_JUp-fjHFvmL+ro+OILpW|M-6dcxQk~gS=MBh?yIVx`sG~*`PAJIKK@iTuY;`8#iXJzzmh`7&?iO{qd$< zj%VR&glFh^qeN8AjctZBtm7Sa--n>;?CD<@zwwL;Sl!8JPI$Oys+zU8SOBSTP){)` z^JcdB4Q(XM*=qY57i><5c^xH-3B)%Tk|B$DdqDutD=FyW44`PavR?s1>U#$+VR|V~ zbsie8QGZADXb{5t>xgeM!2m{fs%gHV@K1qc5O{$f#QJdApQpgcet~%Wfd?svfHKtoN)g+s={-N>K`eBdLdN&_O2d+a{!+tCu;QXvQTbDx&|MW3c z)NX==I;vJ2s-M{_ryzlX9gwz7E3zF>10Z-?Kt80(kQ_jsVGSMc-v1CeE&=G71fJ*w zz4NR`mO}zqlt$I)5iyD7J&B!nuGbaV(Xh5#vV3tmwacXuujj~nmaEQg_|4p!?G55A zxUQxYxwtm%&(}cc_bL3c+ZeqjSR32d1qiJ56VS#eV|NDNyc5^5FK5uG$oaP%_jatg zZUj=2)!(_QW)7Ji!TR~m4}|{)aN?=G1yr+RNem9?0oxo_vgN{6bjNT zBfL_-@JQcKq>WIvL{BhGS$GO+&`;zFx9q}}R@dHif6(WTsB)r*{5;7(chX9bQ znqS1yMl|niU%j)8qZCFQv<~T*cQJTYs?A)ixB0JgiUt>WXZU~L#C^rpiX>e$9RD-P zxcc9JOA2rO#7$7df(OS`XU8AHK`PnH|J##Gk=QwZp4y(~06)+5OW6C7-0Wq+iq0Jt z#n}@?mq0`c)*~Hhv%D|L%@z6t=yhK_2-38j-db$8R0h&wNPsCK(!bQ>~ zZAz6?Qsqf(2t0IF&UhzO{7tWcg0Vs;gKl{e7cJOoj{DhvIp6UVIy-o?nCHS=R8QI?&Spn zyY5OZZED?Y{bjvN=_IBdOqS>b)35uvxMpGQLrvUPXM33yEexIOm3^t!t%O>zr@|eB zNPw6gPjIw!@V2?kcWHC*#(S8M{XhpI1c8muEtJ#g(A3#camSeElWMX$jCHVQK1WQx z#Em8|j|=$z^CZUflNj-Y6yX%vr8pynHP_(6UYrTiuVY3|)sWBbG}ELhgzj{ad65JgmP763hF-SM*p5?Z_lQ0zYrI@-tJ8zEf0^lyd?d z7hBR9L9x98!leTzSveq#IqnU=bSMt|XS%%Zl9BHD%(ukf(a}Fu1!EPeB4UHVL2m$G zp|>HfyeziyMgwW(4*6X*0Z5ysCL1Cj;uMTg#TcB9QzKz$H-k#e!=Zg!j%*drpt(;^ zyI+}`s#Ct7GO^K@3nKPYqet4CD1HKA?1aRr(D$1>vegq_oR%gn(p_` zlH5yE5{*Ynh*$R^GtXhII$IiiuoA`03OYY@KWS1wX*g(}84{&(Ey2{Y%4zP9Cb*M6 zY2n2#*n1<3cf}l=4~i0!d5TT*bL*MXe*U<8Zm6>RK-w!ZXCxsS59X9`w7Ai4>&%bj zbKmO_0=)0NZ%mt_s$d7W7Dk?T>~N?Ui)s<{6Uty!k_#z0sW%Lb0&sWzS;t zwOQCrL0Nyy6MX(77Piyfn%*+)H{Ou9y!3iWf0VV_#d|ZlPP&xX+{YFg&Rwgz{9v=E z)?ORw^hm5clJ;}eZKsKm#I4j=rN!Hy^#~TqpMTal(FXFl!?Nl55FXBOOFSm`UoMXA zK4%w0)&{9q3?bm6fbmo(+%rFr5%MJ71AD+ir=cNnPAFQ2cEsU*(h%tX;@KE*FLpw3 z1Q_{xy>$CU)6%`#Whdu~waWSEuA~P*s&C%T(RR}0%|)o=zaq1#j0jW)!PLNx_iG^( z&-Yl|SB3r-n4A=tN_d#>RXi2W%0%CcIlo_w>VI||!2Q;(W?;E!V(X`Onf##FF z;{(XT7VVXF3kz832$oI+J`jq)({TU4T|{8;T^CCjrKVd+hvl^_q+XmG3{@#VKUaUL zp-*_i5{!KDV(gIx5S-;^#VG_|&a!ZBp$mzTx8Nj`T(EIU)7mu~t`YujmSRUBh zQGdQ}CL0)2YkGj#Tc;{6C`Aesuu=Z478QvZ~W;kVnYhQLF*Pf9a-3(ACiqD7bS zAm7Xrc91B5@}yLrwH{z&Fo7bWY>)AE7FzgPEBs&ud-=MNq8ZCj?+9_&S^`QQ{rBQg z`O9zRm~m_VZ>3}8!PwQ>`G9cXif*jg3Qtu)?z~;N01VcKdAjW0BLK#GwV%48oCd3n zd60y-KqALi;M*pT&-tdisA5;r;G4KI&1IHzZ74(cLNf2LYJ)^U*?TKmclrXV2k-ey z?*Z!P_CIFD6hzpT8OoNQBbWBQ5jjkWXj#9Js%+pnC8D!h%+H{U0;=_hIezY5dMI+n z1Utn`?02vdULmqh!}U-*-_#VJOM-+k$}cvQ^K4f!dW0eeUQj2)i(sYFanl19TkD;~ zD|`+(LNcgO;^wil&6vm8a?aEqb%GP%LBpfeO(h0rWD?0!#0<^f6B~1t-^q(JlJG`t z5d|xUUwPxhdA3YOqM6yVGwREB*#?Z|sl}GoPOja99{?FSfOO+II&DE%hF4p3-X~p( za7TJk2+_&b`?YjHjSv_f!9G&!(xrGFZJsJ z*z=EMqULE7d(zILG01iJ=K#dDqf6G@MfY>eX3FRORv*T=|2XWT8U_}vtbt7OMB%%n z_5oKTLvmJ^0M4vlvtS-DUgyxb=nF=B2UWrZITjxJ`5jXKlN=dE*jt~BW)8}gErP=c z&GF2S&)U63E6T&`d`p)>*wgH$6>J$sW?#VvK^^Mma*!WMDvPatGOpCqnxvQtrS&UI z06Ho&qz<(`fR#RV%!k=u35jQfL2zLSA9h`|l2hkWqt2py(YHz77*fibr*I(fmaqOaS?}*Fd+kxpo0-h_dG&5h_}a?443LYzcG< zBprYCJ}*b(ZOK0$3@U%0uTv76j!GSx=E5K0GC4jL#1IY1k6{;h?vCkxbS5S)Z(_@y zdA&|ztv=$g&voG+hjy#z`hy>o(A7WxDWib>RW9X&E7r{xP(|Sb80b44ri5V!r)LZ> zP7KVpd`uAMz8Y=ctd#uvfNQ(!K7yAQJ~V26`X9aoQjx{Kz)(vi$nGiB5qt(>HOu=- zNIXB!C*}w#pr?SRUR*=(^z4Y9Q;now@q^m*fnIB%$^w3(#XOYcdZ-@>?*KT*e~ExD zK{)1%S3nA1Jw!=p3)8_9M8O*ZX&UP$t!GyVu6Yb!g)1I7UI7x~E9;99-_40dkZ7&n zZDn`9COrFG2v;A{-3jlvp9V=C6PgU-t=)Z?qG3-&E~okWEpE<--K;L5SlLT3%(?Nu zsX^vdh%BX)Kj!!Ua;R7MMrI9U;x5rMK=f5nbK0%cTMQj1MB|zC+$&te*t!&+7`x1M zDE)P!H;rdLe1`h}{1^_DhD`80&yySXhfMgld)!Zbv!s}~E$2uU$1QHLiBA{RRe1-( z5Kb*o{cduiHv{mM87B3{e0kd#XbI@^KU+dc8^au^mdpbXlVq-LSVg--n_hiI6gfL{ zT5GBp$0Z=zU?D`Hlfm2iJ1ik)n-l!~$1!D6nVab{ncI+11{Ha<-(C-Eg+sG)k361Z za((BSyImYHIbQ5DY4{7G&OQzXQ~JBp;1lT;DiIyjS;ndlo!R`F*i+;1e(-VE6g7!{Mo%j-K& z!uZPF$z!4G&#@1B`~Zj3&vUjNwp3&iqeSu%w@OrzjHr*}*GKA=MDKH37C#-@JA)X_ z9(q4fnj{dEuLg$yda-!iyIF(S3fj*(_J2lAFtw$oa$u;j7&0(_CKhNW{#2im4SgHY z4Xjff>kQ^*2I8>@j5NEf^LPm-Pk>tIeIrx$Cf)STw4H@Dw4`Vg3*}ZM(GoxQ!cKC%jA9eEM%a~q^P9VDu6V_E{5!|V z&1zBE*(P8HZm3I0i9%;eBwwu$l@@{1pRB1yvE>;L1sK^&cXVmtp+m_NA;O)YRwPE0 zwlh3C@TmSpFT&padrq^WY`iq`IP%_2J1HQ2ps^E8Ue`Zie-xIW@+jI>pYDy9z1vV>;Kq#GyeMc8UrieOaEG z4$@$sdaJFThbs{*UdxeOm$W$xep{D4gqcfhyCD&Ku%9CD6qURIOe4J~yIGi|$wKW) zs$u^5dVbO}eZqXDe;MD*^bfOWvTsXUyH3*1967c}Ki(>Uqg!#pT15fMfDO+&{&YK7 zm8smu=PP~?JAM~H34rO#>azMRzV{>Kd%MuU7;y_@#w@Lz{L6G5dp6)f8a~y7I=K<= zSG=6ZbEsbuZk8 zf%VT60FRnK_SEwsz73S~1cA$|vtIpYc2|8nrl?>J!{|qN4fGhtZ^Lo?I<rtT~K0kS#OAaLV$U~l?sO;>#N(WBLK#$D!n%EcsYM`BF2uB_nOaYpx>3}FaOSaPQl}LkOqMmck%n7glP}Xo zh7BriJkK=|ov&1ZYVi?Q>D&!4HZjvSfP7XLG7L<_b_|g46Tcc<7Y(J5#?!2_5XNWESRs(&tk7iuAx2O z4lj-+V_B1$sTcdYgZCl;GUU)@$I90?O!)B3!0V)OAkY609Hjlc=!qgVJPjKXc=qJz z2h`Z+54-ar`h`+|iuCyB_7DvBwBvBL;}08nSGBwU!HM_3Vp*i_^9%nTfae>dxo+hZ zkoEu}*yuX~N%=&awQV?~(m>hy`k=JS;B|;lnD6JgPG%HF>uL8}{@uG=LdJ10+_L+# z63yqfalr~(KDUub2i3&JCp{nB4IMM$tZKhyTTtjAF2v#yno#}SRls7Vemb3hjp*icrDg7Rgm>{P(A?9~b zc;OSm5By~l+@y(UM6;Gbrpp~_RJ5w6&>F^Qf`w67iW5l7T&5FBds;s=Z!z=NZe3|Y zhJeaZ&ukm|Nv-5MFpd4EmyW7qYXYlmceHt|BB>%UbhDe9wD**H@9DslxD}A|6h^pN zUZ2CNP$pWTmiEA{JZOH9hQJO}$j1LB+$Gqa`MasGJf2}fU4&yTbd z`wKBVtMpQ5bn1W%(=QLKeR{?pFbvN5<(0J8HjP1i!pRB6h{IcG@3pW7eEA zwZ%MDo|efPqc!DK>mTaXXL@f)YRGnAdCl+L%S;FlRP$=K%-`wTmb*0~LzJOL3I7LV(w%eJ;*4&>7%Ai7_Ih!g8Rme+HRx2r#r zi9^8P0*15045RYES?tXYp$)g+UWW$>L0v(UZ`(1cuNVAv$5j(idg5GtFv?MB0)d1} z?C>@sU-@~1HciAkG2%$ivrDanw8z7eL?Z^eImmcC0n2OWx{9C%0 zk7j%k`QAR;hg6Bv23-wOhw~A6|KThm7^$)SkU3rA~NeT5%b1rF<2Y(zhAvFHjfkA-Div`UvpdO&jpkEnXH% zPmD64*VaM92vz%Y`g4OyO3e}G`@HsNHgF}F8PWNO|B@$Vo$0dUjWAo23`^p@#b-MG z^20~|Xx2jx-&|@#YqkDkuy(67aI=SOmsI$v<;Y}-F54XO4{wYET*$L*@T}2i-xp-b8LY zGECNk&eD%diK8=q(W6im3KolLZfA8g(X) zVFBUyZtjV3{Ia)4I0~Y4Tee3!$(ZsBgy9qo*M<$A7NCy`tMcC$CS#c5;wydz0*RrT z&1V8aMiH9NXrJb znbKq^Eudy_)(h+OhX2k%eE*|{KUXyD!5X@cSW#FaZ2Q+juAqDo7e8P<1gXMD+KC9? zBL%$#5rx#o1PrD+5Csj{0{`(JUjZ}AfgWtQ)8UA-xpGXL%j+gfeiMEyYO5pw6= zbT{&Q^!QW{TYTKAaOzSE@+MaP0Zq9ee5kDd*kf4ors?d#bmNY3G}A}1;=3oWytn0_ zZ}Rx~;WK=)6O{sEA}ci*5&DC6V|JIW;$Kpk;J}7Uc6I-A zZW?Mf-`F2bu-u?Ii3`+j%iQ=e2!4J5*sWSMTkq;B??}WYHetzJ$ zg`(sjaUq}j^gK?uH0&_8HVK!W0IqO?mylbkDng9&xpSHIQEHE}(MD@^BNk^^%^ciA z-ngVT*&$LO&D7>hlw%w5S{OrdRcc_Jt~249gZ?QS?4~t!-G#8l}jMhvOs$)T-u5> zBMyw`ck9Rk;gG!)!JN|45N)D5L16LwiH(}CzKtaWpAEUe4gLIW3XpGzZ77|+ zT(-4|2*f~<&&j&^i13t8fP>as(4c=Oa7A8mNN>Gk(Y#diBU<3WBHrqaX2SjRK8^1S z2pI`ykCY6+=;bZ+EPhn%gl2GW3Jr5Y=wc<_mw7_0&?% z1}G4o(QWi~iQb!FxnQMZRI(a!6;f6+3un+yDq7eNau&|Rrsi8>$->6{^?wF^mFZF?lI62pf z%(TS{zMImGby>3E%KE07&nSwZ*SxOQnN-J>q4)1IY3!YXAegp_3OGFo*HgM zNr*tnVq+3~Tv%mxoUgo=KakI__nzT2m#>c?hWr><+=ext-Ql4RYC*|$LnEped)~!G z!BiUG<`kJfW#i2D6(-i!R#d7iI5t_c&+&{(D~?bu6Rj0xGm3bBwCt9E zI_gW&R2ReXn3EAYwEvUh{9m?zAT&?|d#UraPo-6Rm|=O+EjpR)Y1b9KlEywSRfRW8 z+@Qg8yhLhyfb9ZK=~*aysX>Els;=V~C*)(ghyw>Il>_CaVuAYK@-?ya~NPspC}XuO&tlx)Y0 zx;10`h7z04{#j#%0(OTGVUq99g!!~dQ>?Vo(eIP!{sUZ} z4u>{LiPUl{R7XwYJ-_I=x|<~7<=!DfFE$^YkW;341T{rI2mTxd)6?(bePc%MW9xF$ zEFrS?1^QJY7;^#7pLiF_ijGi5zxk$cgVA&EsE}&I?L=dhnOg$3Nj}8 zXY)d*%BgwL4-Rm<%BqjagC33&#+XV_>N5up^mbG=k>de3Eq^$l?6rl{8h)=AGZnsa4nKM@!7oES0<3DX-cHlZI{|hf;n<`E2W)w{_bNuj?b>X+fTMYTL{T{57yX~- z*%x#n^=yt>Rqj7$76@WZZbxe6{q&UFaDPagMgdond&QcP>P=f0A+*CJ?_U&pU}HO1 z9vWm1_aAQro&ZFgvp4X!S3Gu-pojd`yGnC%m8Q^W`W-JjVXdG#t6Go5^>y>h84yI%|;bv zz$QYlIEmEqsIbpu_g~j^)RPo5>t?Fb z-xbTY4yIm{QOx*WNqr6Zu#YsNc*a3Zm_uLdz%3!@xQZnPHdDgbWK`Qh-HWs7bO1Nl ziqH2dHs0U6r4ppj{H|mw;thp@HXTZPK>uv!rHXoLUOY1n~D*IPKj@Pm2$EVroF4)F@)GM_z{ZHn~7s=h;LI7;n&v7 zLEHIXP~@BsBG&M$fRbh=)WB{2n)$jLmY>Q^z-w3^}Npdi)j4btoLPEj&zCMS9J=M`rg3f=I`Ls~v zaarS6xnK3#T7Jky<}JojUaPR6R0Sz4&}( zX@*@RvKZaVgqj4piB>hNe;WVjiTi1> zVMsr`1Ur1`rDD)Wf_nD$#ST;saTcbN8_A@faXl39t&Zv+#)zXM6ZyC z{}s%M-b)9OLee#wnf7%H_0H61ZRS%4CalYBXHLeMoe(JV*~7&&TB~pE)?N{NJcI3Z zy&dK7BK93HX$TYs48c^y-a55OO+y5WV7h1T%lQ!yym3}#qvyHjv08^Z4M>|m^zE7a zkBaf8XBe$#6=tb?!k~l5%y#t#afr!oAqTYJvA9~(=J1)7Y$Xg}5YL5y0Yb}GbrZaL zXYN)Gf*Vz=A)geR=C}p@G792J|LKGV;#CJOn%Qn^Y4Ufjr&_XS*&!8UjRN^pvs<58 zj_@&5k@%t>jW}WM_c5|N7B76-#-Z;Vkt*hWK^{u;T8R#xX*Hq3m!tZ=>DR*78nQkp zd=<`)yZPvz0IH9G!fWs+pipeAF6$#ze%HkdV9|Bpz|cg!ZiRWlgR;D0)KA;WngP@4 z?+jn-`w%Ie6@h0d$Z0SmhhzJWUE5;l>JyS9aLA zw>s+&yyvRK-wvLqr{20LX#US@gCWg3Is?)8Jy86Kn&*H=k3{L>LKD(d@Sjaj$4NAO z2`r)WBK|H5>V%)zkuiq5rk*+Em!; z*K&S$P{mhH|5zLOXN3(~pz;>=TkQOK=>j1O(@zMXN5Q3w!VoP|W{#8Y+M$mtZjNr* z6W2uOjwZ)27t;{PP~c{%NvNQ6(8!BCG8wZ1zNyz$Ucgf_uewdW8z&_oO_}XRfJ3+AvmSMHi zC8D>G2K**DkXY#}!f;GB_(!$>IG7eniKe9c7Kl^`ovAZgD*)R=Y!iO+HBctXH%a8R zM^7I8h+2I#ut1ahxWF7O2@G(m|Ba)-)!>E7W8Fo0QrPEfgl_V?1&Y}I$FZ2gGXkr*7l(^nA{?89zvf87dA&lbkz- z8wE1;`L7DKAG`gOsUaUVGRp5+)3XA1w;z|we8zuE{g_5u=JhM1GJee0G-kmB$7x;= z6-UC@be1SZTfy3?Re|*0JKR&KmfgXC1%1{6ztJBC^G7^+3H{?iRy&92Qqf6mK39Sl zX57W7hYP;Bk38xID7VfTwA)2I{_UH%!Fe0WlP2*WOy*A|p-Y)oy>h0__9=LZw zl!2(z77#eNW6|ecvyjBP;KyEGKfIr8;;`JbF>kr5zTZEWpfo#Al(&o^rO`#4ti#{_Dv+Ws#a=@Wa`|B7iLGaHvh4Th4HW86X~pH zHbg9^<2?I=HgW&ie|+iNrv>EX`O#7nc&+}4t&yN0g?hE7G*aD+q!qXtPOpVwakKA! zz1YD^_{>umzaXk1aZqg*>{d%+Y_OAJufUkDIA^LB(J-SoUkWBzI0!U_`0L4?oG&c8 zPI(UD`i7W^)z1mB7Yqbq5nkeEL2(7`iTzC!0`C?RC*V0hAoHTdH192*zyknfOf;yd zcgY`3K$G#WNNYrwrwoV_Ac64F2cV0QF+)prgZzCkTC?h*%a4zW0{>q8czlnvXhHcA z!;7&sH5F$?P(#z0Dk~44n)i*|)cW8+9u*nkwJZMb0_qw*QLoIU6ipjX02a6(IAGfME#yE zm^{G~@6zKU;K|+;Jj$DcphapzF&*Ga|GserB|(OZcTJf%&=QHzxR?|AFn>fD;7Ag;y7h_O8L-E70nJP%q+GlL9XTlaM3_s64aBOvFehuBQOX(Ht}_6 zLEhuX&d5Ivz5rJFG-RM(2ae}N@Oh3ui_GwdmXiHOJrmuA? zX-bEo5vqBn60_wfF7{jwjv!TMrw^P8_(wP0g`McIJ%uX;fR0Bq6bu_i8wjD~8M^2w zP3eop5hq$%*M`ANMMWkmUBl#qy|KuqauTtoB+5n$oeWmPETPL!7VO@EBaa7w~S_bQ!d^4d^)m;#^F6R)`-ES(zU}nzxMhA&(lH-*{ ztU_yC;E zYr4gyyLp*vtT62UEZ>S5E3^mSaNAa$j-@2T3YwJ9?CuDWKVfrvkNXI^176~ z8VJ)6@g>*poKATLd>(!ft9A5(b!)V2_4xE@G_|+;*D^I%`oC*D{+tO})eX%G;f9-iuxI)2D{zCiu#LvUW7e?sB85T^v5gOo;+RKv)M?aC|Pi84k9q_u6n-Nb( zkslkGAQ?oJAz=3piZH+bCJD7+{Hll4Wa1J^JYSdB32l0;w|bDjZ7=H@Vpb+VUZmGY?sw+vA}Eb-NUA3prI7wi25 z!tggVFEsS|xGz!PO{wTb@w#)@o&|4IyYLYV9cE{1p$ms``Bb;am<6-o7x9k%#aFF} zK9yINn%oew9$Ul4FIn~jRfZ;Y88*-46y!$o0qCU>l@{-`nkFxYOaIMB@5H0tTPo2d zE|faP*_Yx=q*Rk*%g@y5G>n=nP>P0gNSh1gn&z5bj76fb8EoXDZefZ000|oe!eHO> z9LR|^h5Ta**dQP&TAeB@eY1vu;QFtk(LQkvR#`=>Afa83*M>R$5 zazf1)0N%eWIQT>}vFg%LS65f-!jmoZA;75Fto4OMNimnAp;LhyqZ=8IqX}R4`E7%b?K2J={l#oO)vs`9sQ%0nVaT7X@00cCckN=pWA?^O z@SR!~dLBetZp@p0+``1on32t@n6u>lk8qwJ4!Ug=pkaod4NQHPKknTzKp{0VtyGIn ziy)}o3W}twXp$&+5z6uArfKwC9UmVba|=X9O}+++oZ{xR47mjpM)JG0p5AIbQo%fgL6;!mc`Y1$LW88CNLZpk>`&Ca8s2HQLPDM53m^` z!F3rQ9U|;Z4?^km>Q?AgI~8r|ZuqcZfBk8fbq%uvbXk+YT-#bGUg5$X4_?b;%Z(^j zd{`(j{W^al+t36i5dDEcSH{A0`{&YvBL9Jo)Aj~#V2&Yx-NIiHH<2m&ywX$hURg14 z%7LFS0OfUVt9uFY%%WNljzS`gH~}Z4+QV4kx1n8K9e&H*`^IEH3(f$vBaO#ZBnn2Q zYHWfhOn^rgMVk=veggDnk8T(rp!N=W+!_D#qF9QBnaGtcsJQTz?ht&Vv!kjnLx`1< zteZT=mb~&#eSNjl)h7RO~cb#mg?0KoMQi<~f@%7!6o_7u= zbLJW^6}#Y&YgP(;-(O4eU=k9}QM17xa+!jJo(c+}JcV98jN9@TI;XEhVdB#jUNeLDOteG55W}~S$EB|qAqKyBgMMNSZm9);D~g^vn9 z8(Q1Q3B@3R7|4Tw_c+qpk5zx6r4qgWkJ+T8q%oBUEMFq3WNuStg2tQ^LaLUeH#Joe zvo9556EsLY)@-{L{otvhmJFIkFVf|y=bPIPbRiaX`Ti4P+-z|@MDyq@^d}BUU)8so zivpyRC}plULN^br^DyN1<*e=~)Ok~&3-kVRvOw^bZnA^ccnta|fUuqIXk4*PD9?JV z4g4THfvUz~hCkiDTYjqH*Aw#;zye*+=|JVu;(2jOscOJvkwOvTD%y2%utJW3gPE)e zM67n)pAH;@gXMrueHDjx#-VS?JZNU>F-4CIT^@_>aF-w`a!O5JO>7>`@{QPV{!mRe z(-|CE$HlFhwDx?zA}{LlxDW3CzYqw&CHtk`0ga^l=SXv*J?NYeNWUERADIiM?t6rE zt5@)W^A6dey_&vhBP|R&&3bj?D-1I!2g+ZcljO1dE!bhPX)~g3FF1YAKT2TUvV(@k z%eJ+$(S*RhOmK~TV=|O@<2&3T8oQ??poe)CRtjGg&`pt-aq%mP~kAvDm zW-gvvG zXDVjQFyRl14r-=$`S`Nt9ZtUWf+vW_@4N5(&}JI^kqR&#rP-nd13lC3H`hTuJz&Op z-6!7eA5KeZ-Enz&gjaGBj5k4YnZ#4 z_Py{IguuymQOnB)m^+a0vvuo#lu=)jH@BqV)I;k z;OY69VqP`;xHS$J_Rzenoz=zAbYO4y$xE7|E`3i}=zbG&nVp zSPa+quaqRn@Soq`?#aGIb6CzY@y`o6*syXjrA8~cf81bz4lQiCt|DI8NCU=mFttbPZVdE}|!+{< z+=zgF_7hlU4?)1zw!eW?{R5IA??E1?Zw0_(D@w3nk>sGWb&Iaua1&M`2dX&jl= znn>A=GV3|s&I2QE`$tMPfYUzng)K9^wwpQL(hF&*iZDJk)PUp!-}3tIVfO~*?lvI9 z%QX9K`Gj!iSbzJ419KV^UOIuE$pcKjD=B$=5qVaW;Ln&z!0!OAdyN*RY$sIZ3;~ZB z8lq6@?pGd%z+{0yxiKK9(9AK#C;M zo%=<(ZlFAYAKe60^%g!Y!w=|ygfhI^Pd%#eHvwH+v*^PoT|vQts)Xo1hERjmkaP!% z#y2#279?-mNU7>@-|F6Jog0_)dvPiyT=WATPGHvkxdHb6-Nir5BT>9tQ2y1$_a~VF zA9{GO^X7HSvS$QvY@02m%+7j?H&qTRPuSYBlDeE`iU5n%pI-R*1gm3|{^tx|@#7M4 zI2Ua6u7U^Whd`yv(BGGp60+@a*=yXT{;iE=RDYQVYI4m(jJnh|2?^I)u<}4#iF+1a z#>Ph$0}^3v_|WPZMUyax<~Vyqe$rf63EHd2sd6s7vWk>6h*Z%SZIM4@zYm}v6paOa zh39n=y~2I`YT(y$F9CRJ1DjqHpIPryP%Fmmem`H)Fvt&~jWo{pl^wMlTN<=A z*PV0s7U~wvV3+?Us*=B_`4)rq-ZBXU>E`BUW-gV}H2N!^Ba-W!!$P1E&6dy-=-o?Q zEZ6(Zzbco3#DdU>>2deJ#6d#a#*4$RGFXmNXK!*il$aL?0tn;v-Kn7lxj|TRg4ka1 zL0)RD=_sgo`{wV{sw=s^eO!^GbkQn}n{g!C+F380Jhk+U-m6!sm$8>3A~C|<6{=>r zfNk|v8(VAftAC>IBoI*&EZWW8*zT#f+qG7_PTy#0$WN+b(L)|LBJ7~yCb70E{p>08Jb8Oid^NERCP$aBXpMoy3%@I=<#^nrfcv=(+_ zF@8tCn@|+h-;x^+z!@1yFHEmzp&>a8&B%AxtR5>ljKs4WPC7W^qIkLXe9WQj%H9JZiIib#eN;2tkmC)_$K= zV)5yIf>@|XBCjZBR%hB-Ibp8yjy~+ZmLe3h5ww}CS7ohaMiSdvtvMtFemZ+q)t#?% ztGWPborN@XHHW6)i>xN5mF~9lw z45CVVhZt0Ik?T(=WB28qTn}!j-R_2psJBL%HrFdxd5{=Kwf#@I+a_}?YLM}R?WDkx z(pujgELk)vz0jke9hu!QTlXPxJkfpyb7L@Ipc1_yNHAYx&IcRmAB^}nq8#j(NjgER zS74fxe#2q4X}Rkh^3(s4>!bu14)GoYV8<&XqXbzZW|$}5ML;2-II}S3-`y7Rk1Df! z&^ezSw6$ih5Fl4{$NRS4%ZyRX-65E!O$PccVFtV*{Z-)4Op>2=L7&M8FkY?P>PIqt zs(wO6c=u2x1>cH@Rt#|;8#3iMuteF>k0U&VhR_VZvyxSZ%cs#nkUeK*jwcXS6?OtU z13bT@IF$h_-Ov9du=>kZb(ip6>n>!D9l|aquYaReo4cfCga`1{%vAkFTUMGWwnfjNqt}PX4uKInrR(s4fD0 zt)J2=FR3Wj_$PId0#Pcrhg^*>3^*CUqiNMRq?rFVS!^uo=!S@`_y)5Ng@u_#JGjD= zDyo&5((7W${>^&)zP5gRm1#<`DI)ThmGTGda1@mme!&`270aDn58cq&9gKz&s0{Tb zpP7RPtBJeid4iLj8umV}H8@eD(JTcfVUY|(HSNRzS&tumG#hS*Z;z;N`AAW3o$R#r z*>!7KBi_8v?t`sIu3X*nujz6$HB{OCgBKk9RIPoC$e=3bj>>|~je7=gDp@i{F{X;w z^&Cbr=%FYQx0vpgLWZ#ff0-dV;135Gt+-7_7Di!HOgxzaI7afrAK_#C;XiMP1s`(a zkLS}u|1ZNo|33{8%Sz*j$g|$#XE(~>;*>p0)~mhCv&#SJi0l}ed&`4gyKL*F@}~W~ zwkP_CpZ4e?Rt*^t;i}5x>W)2r#t`t0QDA>K$+{TWk<{=7^SE4mP~b<33cRU#@qJq9 z(yY+yaZ}lSZ*E@_BmBI2uCerAeYnzxGjRt2`H4?uF9~i>J8Tao9ZK`pd&i`=6^`+C;dLvzOXbGG8PTFO%GNr|R{^&bIWQ0vJtd(9~VPYi}0Q`HJ1*R0v|a$^BLN zLX3Pq4~zuF=?qma6D?DLCKp(2L7|+n>i#PkL=Hs@YD=~Gu_w`!wQxhuX@ji0Ln=$3 z_x6F}7;YG~gKRBR%(+8`gQCxgqUN}3jvXYmqgblhv6c}vQIl8%mY^qZoGd_IeL}1Qa8^WudskrvWZq-gd1T&jz}1-W#lN_jpLI zs@FNwT6wV7kQ9X)t^#%_t{m>4o9F`@No(mUC2p-%0KX2crI{v5x(>VDNa9 zW8SA&;6#D=6Myp?+#7s1K%)nXX*Mq4<5hW+HqFlCG!VnSaY+*~UtO_wxIaq5%b5%s z>N_?hL#))1KRF0%d9YtNNMA&(LjHOd(CmV3Odai@I>rvhx_s+>9gCb1`1_pT^5L0G zxcO%$IPA8;uBY*(koB+?#hA^#I7!)l^FPY`l zjGvv$1pyEE^jn6+#6I1W_WRduwZI3oIq#D3jpp?Gr!|hPHHf0ZZSFSm0;f2G)I_YS z22}-wihE>vTU}@pzjS|Hff#Eu^oEuZIbFr4-nMH2%sPQ>BjegNG$Job!wf757opuoX^MK_}r4j_S|aD8!OU9VE8T zX*wXIedNPh*?qW$+^&mZc7KNSCx|UK4eX>@j}WY?Vg30RC063ojmh0l-9!%ev1UGN zX%sL9#XwXhw4C@iiCE0`O`wD822S1+2{|tuDGhh9qd@ z$rE>B?cvL#>8dBB zne9%?MY4(Q4MmIKMMBUZ$EYr=;?xm;?66fCx8CS+@>BA5W){z-Oi#Q!sU5@0f{<#W zkY#RY@iC~9`xz*?pdKvj+QLfP)I(tZXO!` zty>Z@^PesWC33QcQDgZk0&r5XD7v4Gd*kIO-ZBm+4^`0VnJ2HW>wOnk*qHZR7&`dh z+?q1QHw8+uU2)tP|9U_G8<-O(4T9}D)kcu)z`8?rvWSY-+VvJaoVAP0HNC@CC@+H9 z9W?T&Z8K0DyT_MIi_+xM7)~AbP;&^})6<#JNc*_7H>zgWd{99Z9gBwNG=7MD&@`f3 zGYtot&&v}BX)<7D7%tuo&wY?5<)#ukvH7Ow2D>%V!j!N4&4`pM{0l?Nh}esNU?RLaqvD8(~eZfY_n16_fpCAQbRXRAkzI%HB=)M2XLz}Dbu z;tG+q%pu{){j>8~LXqHdoa74Lqmy*e4hoENWd;Blq!tMkJFuwK!)+jK+|p^BX{=v) zQTbm9qf@g(@YYsq2~uX53XF|osKemjY3cprwP%SW>3VkmZ0khU=_UP*xpM_0nE;Q^ z<%;Wh^qlHcYtK$WY+jxorsS&%Yd+T6(M>v!zp)?SF;o(dIde+FH1Fr_)gTZZHsLk% zSD5cV%Jov5eM?FgX&2QZ!>sT65>A_Br1PnfAidTGf5672Cj(@3EmMX6=Qka~e{-42 zUv&{21iHD^!jdR6%Kih6G+G{I6c8=O?`Y=xM!le=||$^4F@jSFMbWpb&3-BVvpe+MBCQ zCO+Sb&hFzK&z?2FzvmYj?V`Rlw0ukC@^*y$K@j@@Y0qzH#Wvf1J5N0>lzRhoz;h-b zx6PubYu~%!g0D0IGLF>{xq5fv`jV2UtMf%B?!-OFp z`%R*x2s7{j75UVA=aj)-TFewO{auUfNX$!)V|}DWOZS^9vjUlWcZhec1OAy);Dc^T zKHRdq@T*CrMz3=zVewVBSwJ{n8p`WNT7sp67qi_0~7`vq?eF_ zUT?Nu1X>?wr=Jab$pTo&3;GQWkowx!w5zdW%?+%n8s_5@*$6DWEeAC&0(kYD*HNs3 zqO?{)a$g%GYr`3Z4XS5gHNRd>yhT5qdn?&sJ1*y=3Z9Jgdb~1tweYu^K)Eb+^x9sNgNP zTnYz(LBN2)R++g;npGA|$G)Cp64TSOWA9o$G9?xIzlTFQbC9~&RA{a$+(3B46?YtZ z4g1YJk{0i7+xiuGGKAH8@eH#7FBo7G=ouvQj%$Or1q8O9wntL7&VQP3JI#nM*z>`# zE#ODBOiXv?u(W(Y1Ql{>{%KM4037c>(egi6~>e9t?gdc}iEcD}1faVEz@S3C*Wn>&0_>WgIl>vUg4(Lt3EL-crNGS1ksrv>Me|Gn zX}zF1sN`zzfuTO!LzfULILCo+PT=noG#sU%IOp~UR$V7-Cfd(7*k*Y1D(siaJ>rnn zD$%h<2p}evTDvw_+?t(fyn;Lf_Zum|? zH-2XF$QhL$9PkbO=18=>hMe+9>So^c@iUVQEAGdcb_1}z7bqTmJFhy()Yb~Ios53s zeI7N6?};3KV?4=&XT^+ra+fb!7w2TEtP6@rr8kfTnEmuCdzQf{CHD#CNPPV+VPHlV zdTJ%Yqj~0i=g#*(db;8QkciwP{AA;nATLs71B~9>#u9Ee-~T3X9R~kS0)r=3Y7hsF zavQMnU7!c(J@2IK$-hK${fnSfS44rWa zk2{jK(3ek3r7^Tr<`t4*W@84|s?B4eOu#ri_?4l~aqyP7E-A>kFiT$9DFIfX;f}nS z!RvVQK<>M>)-pD6MCWFO)~%XIB492xfOf_0eFl@?mFm};@_eg{*ySKQ93M3%dz zem0$~Vgx zS?(8IF zGIQ(dV+IZeLeWBMbG_zokWsGOkJZe1(rWR49#gtYyC9&6&LfE-uA`A11ebFd%=> z4_1Wk7-C0QRozI)S(0O4_{miQs9B>D!&Ubr{!lJLY5e#t`RY(4gMCZz3iTtH`xA+3 z*(O>%%14;Q%~o})w$zO-c30{xjjV#)5_I!Bxoqi$&_rQm6~#%)%#n9rb3@!h8}`62 zBj##Cyq4}vtpL2B(?d?8!h325A!jq5M3l?%@Cf@B8V`=frzH+6e>p>=h8z-#0a2OA5nwzSG}6+1gp)yzWh5JP`-oD9cdwG|J-AD_G#MVpr|bm$Ku><7`9+$ytw_BR-!n?qV$A{ zSYd&*ds1!jnE2xQbDE9R;6veGT#RLFtmTa63>w(RXJi8xME!Dj;ZnHPTN*H>oa44X z_3lb3#y(5&RDlV^XiSu|3%?e8?cn&_Qd{(#zCc6kVQ*(J;&$9#0B-iHyz_oPfAUPn z;P}P%a5YoSR*?g0y~w0#HY}*K^dFie+dbz^LT9F<_QA|iL3)V7WWQ|%_ol`y?8sHy4h$sraec@5 zgN#qs!-NJuPH7GyBctd=>yYgH{(Y119I zqWrRExp8S71aHA^4+BLwp1+|+b7$QZ^DAlCE>2Nlz9bVoMT#x^AV+u5uP{Aj$IS^k zkRq0M%4DoKxa_|7|1JiAcoveVOMI1obeEp6kJR!D&Y9-m`zu}z$p+lIj*!7o3Lg6} zgo_*DgM3^Hdk>;6Cy4j03El*xOm8N7Fn8+x{B)CkPAoqFLv8&swIrJUN-y1T}Gu-$NI-1}x(*wAYK@ZyI}CKb%hPav*L@=(D}3-wdVe$Lu=rCh1D< zE8-?DHVY*w3GmicE;*B2(sMH&Kl1MfSl;WPCe|l5Upld`>g1#+j<|Te*?s)T0+{Rr zOZ|Q24~eAuh^L@mCO3-* zup!HESx8!Fqc0qc4GT`hLQ{k6r~RjzsTTPQyfVcJ3}bobmvuFzvBC~5NZ#I zSq&39&h2|mdNr|5(5e9Hwb>s38m|Jm7B#_Cx@dK+?;3p9w6RUGBV+JAWFvGdR0|O? zwqC@#QcSiWH@AW4JiFU?Z6}QeZfd!Uc%KRm(dg6z*4xgqyAy~QcyyBZ$R|cV*87?v zjTt#|YhC-;WsuR6%UP3~4UVk0ngK^yPtyG3HX6;X%W) zgC#FS+GKP70yTjnk~w%|g0M{i*?#(@L$}hJE#*ZC8y4001dC1xh9S=0U%qTwK|K-} zIQS;)t8$(^R$DCrk#lo1-n&k#25$2PvU9nwyL`CbGHjjH$Tq*(w^zt|aZ$_p9$psD zjXlH=6vQ*bJu%Ertq{(2#o;^P*|{uPExu<;Tae7T7yqzefbSU{7cs=rt8+JOd~hwn zZZ)}jXP7yad;DZR`$srZOm6kJI9){cR3(sR^lI?5jlB$}8o7oltT~U`=LP(aY6I)4 ziliPl9`!2OQ=6z;v2@VeAFGDHru@8h76C;O-v_Xzon%6W2g8?*IXM}ofbwMUHsMi*4m!8wv4Q?1a(YiCJlI=EIr4= zy>u;%D-$;V(MI!9AKX(B!4-U5+k2IlHc6KYRjjJ4MJ(Ro4lbg3{fv=#nLxBh&VCj` z(hv6oln*54ftKDARFj@up^Y5@aMz-%lJ||(j8*^Gnp+;Rf1%A%s zzl(Pn8g&~@W>i#^`VYo#44zin+PiyPEV=axzH1H z3vTUIlP^ZJs+G^~wWPUS#iXhqzrsFy0)XH&P&Y$b0%nLX$z9)z#{X|f^d3@wV}AGy zrtd&9!osF8(Timk!ZxgXz3D;6Q9ErzmX9dgaG+xtkR1K+VRMtp!lx5tL{aUYIrg5v zQhcZQ5_fUK1F`v9IXpQXsYgM1lZyJS^3>&`KLA2S^tuPK)eJkDQPEin`w#ehGn2lK z*06kjSP({8{HjhX#{7aagz#hqLT_%qK2Yu9;uj=OwVh|4e#<{2^|lwD{1c+cUZ-H{ z*gZ+z8M^~(7+R^hKVu0#ThSO3^&>Y165N-b^I-3YOZp9k+=-GhwqWj3!Yi80$MzN) zzZ(*k%I4UVoNbnyH*=Zt|J^iNA^(S0u%{|*Y#f_CoeNc&MWL(9`MqiEP4wMzS%M zhz+b3R3U_2TqMZwU)}>oQK*Je$DB`DBFq6krr|oy$;^i$6Q5lup5m4Ml!m{ewo;+{ zwY8wZ=k4SEs+2>3qygDLf}LJa=V`SEkvirmwNw!|B6Slx!v*t|-%eKtnnT)c^zGR< zz;1m$z=%(Hn9Iq5U$0?x&Z{x*7s*-~NrlK!j6^sHLosDXPTpXUjZD5nol1@Z$q<mJ+P&%zS$us?W1pL2v+KWSOby;CLp5v?}UM%x}} zJHzt@UgyD~7YF+u3Ae7efF|unJVk5bNSINt>Yh+}aGs;iPH;S6$XvRc2xO47H}wc` zWJEYDElG_~d6aTr@>H{e>47B%HW-ue?}%CoXEPwX2+2o*(6mE#7wUrHjQ4$}0akus z5b&(HP3AiQ{THhl@unG-XWohry?=IQyEN(e4W}st#4QXaG(Q=VFo$Jrtw_D(9fn;j zV}C(l9PN+h>R)Icm#3Gd#$OS4*D!~2Rp>SA4=41rJRG$EUYK@1P3^`WAeoJL(lD;7 zu8)MI%^L%6hdyZRq&5N<@T=U1Hz_Otew2DF&SSEA)TRjDZHsu;hJ}ZrnhUsD+Tvgw zbp0jks_i;c3IR423JmBM@JY?NhvyBlNmneEs`o!qbRE-y2Zh@cGk-cRvWBDBVXV)f z!JyQI4Hp0*Q?mDC0Rjx zp~Zm(yh?lC^F3+dL8wLF>N+rG*KvEUKYeJH9(=N!`w4#e;dy$#`7tUC*LSMdZZK)M z{&A?>Fl)%ut4mYtc3ET@ZcO{Lz_roEsy!I{x2=OM6rI?yf8wR%hL4V+(^0k5yWhi) z7n}fLJXrq=BOjw?a0ZUppi__?juXqojm+QO-)wA8X2R;l@rPdsPuuO@LDZ4evQQ}= z!6di@@U$D>s7r4@kcaZE>ixZm+%NnWf5a&EZ+vu>*Oe1CMxGP137}}A4|R? zcijdBg2jx5j|UW*ppgo0ylGfO7E)bViLp*hRbOTFg}h4!Ke{i}Z4f2%XUoIdVY6Pj&)tS9TWRCt!}DBw?{UoR-#e3E_frdh43KrZx})L4v{pJ${@29vp9U@H-sb%fadFpQd3WxF3)2&0 z!G*Qr2G<)Yz*XuRnLVFtF`u zD~J1svCk`v1wr)LwwbEF=g`@GkGp$G$e+?5n9h6>5$%RV#Lc_dUVtQ7NhL4ZWZ$d5 z!}q&{=o=;D?D^>cgDd|O-Ng$O?dWgjpk@(`kHzJv5Vx2cp}_d}eK$7$#hhr4Xj-R2 zfZm}0--$)=U&790;^-J&teFDDP?B*4&TSk0Si^}o!tqyUjw@k~cj8T2ga2D-W}0B< z41BK{`nsw6Dc^r4R)t^~=mSW>MfPE~vm4t(7&zNAOwjOKpKlEgCtUaRMqIYb`_ePl z3FZ``U6)U3*VWVJWlPHmBVsIu}w9unGQA((R`l>`T$t&d!iWFHd z%fL&?B`DD=>^agRKJ?RGu?}6%&Qy-n4sPPMwTxp}>&~HYyr-1-i}XHc-sfGT^lZ!4 z8edE-MHv(uSV9K)Z$p%VuQtcMIi?X$C_EU-Ba4pSEc1NetUly(o4IKkCW-VDhL7+s z`kx-K+eVWyMpf6#96#EH+OL{JhMs->^B5nnVdE=34{pI!WF>SNZ6v}a=+VWp_@9bCr*kFFBVfQ=-X2X1*c>pp# zVFX^E=!ZT-wK|#Mv=^E6rroX(%tgH6P*_X-Csh?Cz15h$P_Ve(8vVCO+zMbq25{Ro zo%;kcnEPTJkEFl8SHbLJmLQv6pOC;&yi>|JlkM>DpwI9{8kz3kQnAwq>&sZ2A2HVu zr*G=Smn*C_x;oB4wh)I|e`r6shv8<=32ymUblxKgIE)|9OH*J$s^1&t0QMwv$U!!u zT$o*2In-%vNU`6@Q|ZMh)}nccNy2#+r3+p!#7_P4jy~>&s*Ls&X4SSa@d7IfG6`2; zk>0qL`P`Uwv}btU4D0fCOUZThT&NgM5v^JK`AbfQSOVe5Z$;s&5Y!km0&I1cvadX` z4ScHdBZ4R4D46!x@?(iQsOybe$*+dnNhM44+u1^;sZBvjuU{}|6vgrO3seqmZ>}U(SCSVs?Vz#vB9XLydcYa4st?yav zS@hMRO&$=LwU4YH<69*i3be}JIVLFKMCAoctb~QPTN8?T|4h$0KI+cT#a!bO>`cSl z7BFcV_93uLYiA><2=wyTL257w=KS;pbvnz}$~*Rx>|$ah_hQP-+LQq8wqb>U7!|x( zmfPG=1!OfRZZX^2N@OZNY1GA#x7v_5mxjuzeUy;jbEe3()L1Ebdkl)K@by09^@eAr zgeYZp&uzHvwIoMBKY6FW)_ESO0@La+O9)`bur*{OF{U=yBm z-OWt@NXNb3uCC*eMeEy?-sN?E!zms=t~1>Y8o$Y#6C)~cccre zUw+bl_LRGJ>p>s98wzaIw0*#1c-CPuy?#P}G@TnC3{wyd_mfVQ>c*P2iiA`m?h&L^(gmeC%URhE6h%H{r#Y7BjGs7ucb#cldYpHH z`Wxs{*uo#u=R7|-^up#!j@^#&0e>H{@%afq>HUkb+ffe(p4Lx%@BHj1!7}tlFDZmf z__zf3u9F0=GFR(TZQszMAllrLe5%`!BFcgts`*$6m5gX{gUTsL5~-A3<-DRXG4 zlx0Ewy89I66SBrGU0~eiJg)t#$r9x8w<*qOb<%NaQuf@vCfO8$bt{sO&v+VlZAXKc z#L4~Gu*s>N{$^l{eNu4S;ZyzN(&)~)8cAoG^thV>9)!)gy#~>TkPvmwE#=@e_%Z~n zR&Tfbr`CV^P2VZ1`+sKy?tk7-vu9w2suF9MU=t^^-1G34vUf%%FB)nxdcBA34tE6& zswrk_%|tpwEyhn29By6K_GT}0h_;ZaJ!Pj2W~iKme#qhGA;rsWSjg4yN!OxV{7tkF zyWnA$rqM+EmBk>HT!2+Pz@ABhsr-?jGOrTX=2KeGfeGm8df3K{_GbF6PFk=7{+@P! z@Y(aKP-4-ZwSZ8|^jn77$Tvi3#ED&vwk^oV%K*Sksk z2d+Rk47r)>(6YkH?<&^N*I{?)4B8iicV>*iqlj7Y3pL`<#y{z?o58n`TYa-u^zegl zfprEYH{R^>>pOa+Vbt-4w%BosK;&DiJwFW;32eoFl>uDf@Fhp5MA?89YC-4fr%a(^ zeZ=Wc;Pn;;@vh+B$cm%@VI1)MpMc(7-HoMk%HI$a__F~d0&RERky>lgpAy}FW^GM7mi=t+I7ar9#{I;S0|tUO={hI?59;(1sU2$N4L&n zx7|sM59Rfgf9VV%TN_1?+>z$STdIWSc6CN$}I&uJ=wH!QYx0uD%n{=pD9B0&o2IQ;{HkIyj)i( zqv!2OEC%S|f`Zpo3V@>Gnvthl0$(6XHqNf&1rp@Y)t25@K>h279`C9IK54+EPc(cd z!_Ft{geLLRps5D5Fi7rAClXP&Nz!Ibsv2h?nH0M1{aRT+jpVX1!4MLOmr z2N>e0qM?`Tt~WWMQ?WvOwWE&)?O67)vIF&y1fg!Ff>&3sTeL|V9;l*osjJ>_r4TfQ zxE46F*ScpLEm*QRchztS|X z$HmU)XO(2b*4=9kC__P_bLl1DbAla#sXf1Gay0TGuK}WX>$_Anhs;D?H@avzmDuHj ziinbu+zo#;U(Z*t%ZqPtHLd^JMqu`SAMR4 zV;elS5Ol9=a;gQ_i#Pty^>Kd}8`dID#?wy-@EQK3%DLWYwi=gv>k3mX^P8+EJ0kPz zioUjCeQ+bg{y7sVeQ+WqPNf2nzD0gSeSUnb8tZ>rCnv-$%yeXijuRy8-0YcGKhfyZ zC`&wFx%}Lx{AllSGPXN83?V6pk&<%8;5X`+Xf zUJcF$Wf_c_RA5EV|gM|Bjv8D%>KY?5-`1L)Ocd@ibe)eF&*D29zK+!puROd1K@AY`V{ zbQsHquwWjb`u^Z>q*C4M&}g4XM)g=jS|2IjYr4++NN6D8Jy3$Y#QO}<> zQI=U)Sh&)4w&PipEX>a3C|R{|+}GYdK|0WZD&?%Q zy)u9JGY(VZl%*`i{-B!VQhL-y{B$KLAHlQsIyyH&N#L#L!ruWS+>PcK$F0mYyvC?C zIe1p5_s{w)^ope{p=<#DVLHUC*f}YbIC;Yi&>(0 zP12J1Y?FDtqw{AL<)sH@*jN~lwW>bqOP(|1z{>1HTlvfE7JIDqm47s-ANAYZYi9_E zKKkuBxjBrZB<5eAT9^Fe`yG+?6zR1<4ttzjnUYWGzqhjB|FITW?@LJ2M}JcaCU2uP z*J$tWGU&%z%!Z%Lxc1go4D2R%1sD9NKp)_p8GYFbGHz$5c(hMX1*tTD_Vv0djP-i_ zoHsT1DCTn!6l;($>s8jqpBqqVQL}y1a0RagnQhf4F znfyeZtJwyAFnGwVtjR3{^|o4fc9yZUx6*U(TY~$b&j@z%A_ckE)*eJ4B5F&_6gG>y zPoSTE=#mKsKm$Z+0i(e>{j)pdG&-ur?mT2|dFME%d1H`SU>ORx_$7QrBpCbx@) zI?-!UdYsZb-rdD=$Uc+M%<-U>A3#1#$rqK)wKGnAoO7v7o@(w7ysQ(e#KMwIQqoINEoF=4s0JVA&^!J1XCv_Wbsvik!XhiuG%4rt_8?n$_GC5|(7?^9&C(6Fvy+xs!^T(C#&vN)CBL5rgHTn)V)v9=p z@pZkC7BT@nApTLOb#Cs54WJBe9$xA73Q+3EIc0#RDCJx+6W=^lhzzfC9aOc@}{Le95s)f)IW~!HL=WDg&`2mCy_3c(< zTO9;tPV4~5^rQ2%)4w=au}0mwJTsq2ZbbO8Ty>nafY6PgsqilVf$Wd46-K=nm~8Rk z(w?t_vF_;~Btz*rGgC$xLQhJSBO@O#|J1TcK$~RhLJTF*z<=-vK412zY}KL8ilo9r zpcMcstWaBSs}=6_pq%T$(|AEa%j=`%;Kd2s({n;4fi7pG7_TjzA;mc@EzKZhyl^66 zct3Xnj2`ZVZc2@MNd6V`B*U@@(0L0PkLi03VbUK4XH<^`{nXQJ$rXZHeYVKRT|Ztk zv3>vo`G9SsV@Yh-SlXY52LTSuFLDa4KXSObY+~RWTFt$V&$fjprNN5oVK?jN*za|G zPWk%HSdWUkCR%awF{#GyTxAgR=lnY29cp%OXGRi5myElV?9pWPH}q3AKICa{)vRak zt=x6geM9DYjS{C>SY&zIn}hZ{RX|k&a#Rpz8SN@+Z}1Qy#ATyan{zf^?z-%b99lUu zO$NtZmH!V_-xwWfw{0EUwr$%Tr;~J?j%}M2+qP}nHo9Zmwv#XKIp>~xzxq*6jjHj~ z7`1Ayx%OU|d-z=Qf_9mHgI*BSJf-|se$gQJ4>2mX2^>q=;<;ZX;o;%ybmi=s;vGAJb6wVA~+4efuP=FHIdij@yc5>?xp=eIDg1=FT(nt#!Dqi?Wp zP(FAa{zyZSe7B0Aptm8IzCZR!Y1oQMm0Xr(>Us^3Ou>p5gB{n*w0{OUK`)l zm59sm9OnLKdI=H(l$*^TvCx#W&$%4AF$je$4oWGgdl!Vn&A9KvAGC@DA$7rp&8_tk zL-Tt`XXc3&%GJV7v|Xx*b1NKx+~@q71YZklfKcQUi{avYNVo2q_D7PS})p__mN zCqX$YCeg@Lc$hGAzEgS>XHu^iEckE&Rnvd7@8G}L*AbO0S$uH!_Bs-pL%Ormr2cnJ z*5$MFBc-!cf05}0}J#y2=eWn-KKqQGk9knYrSOMyAgw~kN$c^hi7MX+@kb{ z@$OA$c<13rQIsq+bor|oh?YqY_Gh^;U4hq(VukK-O{#q`CwGpX<*}!7oYCT0SNeTx z=6Z432(}9FPErfNYrl#)onf?@Ir{L9zjf+b zu&)-{vh;r#!@dYs;~=?zhf^h8+I)a+>1jfgRSw$yV_tb%b5WKD+cC9EdY@%QdgI^ zP1{#%n1F;$NuJk&I|Ene;8xq)oBU}tZB1m^*~B9=4dQ7&1hD9u2rC`)0HML$SKU^v zkMElhuJC%l_OhXlb#TiX?(;7VdLCTs88++)ttp5ebOn-?mDZ=TST;C7NY2zJsDbM{ zJZeo1UZD^=>TsElZ$sw>T-k1%y0Veqr(pCh)GW18;_%(n9Kppd65lKJebZPw*8}Cx zujr)kW6Hv@k+0g80}~$>3l?slzf)I^X-1#8;McjH0~e+9HWP}`re z(^Ir;t8?r1=&j)wi;pQSnPWd9PSf28{I(on$4JZ_W{xhvH$`l7jVv-dVIwVaL%Q4T z{*5#uON`X6muvoRklY6aqvu-;^K;Ymb``F_lz%4xGglAu$}5mbudvA30zy7@P}C6f zi6^agLKaTa=3tU(n7008%!9YFu`y}YZ=Z6GO@kFsDd?$UA|-F1Tvz}j5gt?Zd%>mh z2pm(b5Ti~Y;6jUa;XS2+1IYpMeN?v?@L-{HdFIVMON$UWeP^-Oe6boNz9CcyqoXMA z?{>7qBt<_;?N!)vb_*%WKuX=2)g)S7nJz`lzM$<^))+O<;}37}Y=~1s1^i+bn+W|! zUH09+!GdXd=tKi-$HqBpfr>Ex80rP{>89skrzBG*u6?-XF=_zU*MH&VC-)Khv9k2* z6fHMKpH<18&Sn(9H%en`olQ}f4(3DIRu({93OMfP2xJ_1C5rgLZ&f%MK#e zcp(3XE`&RELv3>(IawPCh&En4T{f$Qtu%lGUS}|xHI@Z-*nIV(RtD^dqwL6S=!in> zNNd;epe)Xmw+`8StI0xGse9tB{iSP(TJEP@skTc9w9OWY$NCHE+s*b1S(-=VI@*eb zQmTtA+b{Z`m~kV8Elcc|g2S#!;31Bh#@_GQYShb5rbc+tSN=16l>$Kc+ZF2F)G8LL z8BqVN!TUCLX(Bsj!Y5g+)rVNG?8Jqik1KuUtmM<0gY_8D{D7w+{fe0h2lX=!Bl9iI z*38G!vVzser21NqiElVrNbP^f{;X?Nqb3bw9Q^4@o8!T0cmQ+DbP#h_?`ZCVx0rwK zRqMhPMjCo6Hb^Bom}0iyS@=;`R5i$1p6z2_`P)UkxfpCl*7pcP_lAa_BZZkzgiZ-y z8}|ZPJ|b(IrO{z;82g#GF56BuGWOJd9HvI0X+2^vh$sb?Z(}kkzkbbp9RG;cA_+1< zBW7>^8C?=R&=zHuxcg7H-|E8MkynkaW`2o|<-ge*>7N?B)h;e6S+Z0ZTjumGFvXZ! zN`#3Fi{-j!LlodhL#XA@`QarKa@BO10bl|UP!h~8rp%uq?pHc>UM^|6#ShEcDagzr zkcTK)hYoam8fyYuW0=n%S6)$Gm6k0}bZOL(%d~JQ0!u#~ z8_@#eRiM?Oft%Crk`_$ZGjN}GcAGMHclIqUK!JcCTgR!V_Q{xF+@w)SyK$}TLk)s$ z;OxI(Aw(st{0{aI;7fk5Zu=xOxdjHC$gYZMh->_Ia#f75>Sh9Q-+&DtdIbfI@Xhx$^+_120#-uH&cQ2XguiY`6}hCkY~wJCZlrPiX(sT?^NWmr z9&vtlnD!(H&#gHEuv{P_i0BB#65{B9GsV+saE(z(M)_*vmq;Mrsz07HNoamPhcr3+ zdvZ#IxYoY)UKUFf>&h>2=#YFWII*F?oiw^1i$_!#8_rlG!uoYiZFGIUZL>MCr6m|P zV3P6afXbDX^<|M-<`2yQRwYuW-P4VK%2f}z(xgqQUdyCzj}LS0Kz8u~%i)Ld26swX zRnCWZJVrA${}s3=c+7^31jWqglt~RT%R&eXFP^pbtHxjzC(Du#qz+`oBdh(ngn!M6 z_;S!oN=AjuZy6nPB`-Gf3?{?R55HrVsy#!4(9F0kyd)P~gpRzqTB;o8_eA6!a2ck& z8{03i2p?F-_Z_C;wYC(NqbskV ObZ8`=WR>$kqAHYvCgK6^NE3TTyILs067yAZt zb@}|wn+#e^lE%5CuoR4m!8ivK$9<_&_*Y4J&o>=HN@)_*X0XO{CUAbu$_M4f3|9Bt zO*2to>+UJknwkLxnJ?KlBCXM`Fk*b#{f7N(M3%g+cbp&KM78TwWqxwjfu3yE&9@89 z=jfH2Ma75Dz?XX@fLfDs)5m5cNi?Sf%J8y^Q}5<<&awVNz{u>>)7?vPr zfz`AoYvlaW@(bA)EBQoIX|tUwp(jX2Ma;l?xE4@$w8~8`em^lx<-j^u%@dm$l~cnE zO>k>tGaWx7|6DHeiZbqf2ewdtF4TFQAtEVB$=$Vyzs{mBBbxN9>uVeKW$*X*vfkPy zs?TWjuk14*H`nJ~ayRCd4a-;dp;6%Jl!9Re@mZ#uHS-e>u)E+_BWo>yjTF$s?5^Th z_ahUT23oK&Vt1b}@8!3ToMxr!XYrkO#jRaoQOKH60;_5!Rvwj0@E)#r(1!7A%yz(C z>D;%FVn6A++k&|P`7OyuP~J$nmZre(ZXbghWekE$||EsO@O0nC5}fuZJ-C)Tr$ z#Ymp9l@-s__2a9no-HpB)m-WvjtCZ)>|+3i6kwIe{YkYW)Ww^F{7Sdom+~{3zWA;_ zGG4kU0W~8{58A{Bzs@UOdB+@frVW0VDgwLVn|sWbcr}s_T>0qHOl)9rFjj+#i%lY8 zFI2XYcVsp?e<>?~QY~se>Ftw|MRVw7KYHFjNn%vHVBA^~9d4`EVaHESi>?2hJk(yv znwNjVKdxH1yaQNgN_dja)uWdn@@P_)%|0-}^#c7f3w8g`s@AeZDGZzJ(2>U_`8T^! zXXkpe(L_Vo6E7D+AEIscH0T8b`OKfPqss2r)NEZmPo8tcfRf3x+-nn@l-gMy*48IB zz8fX7`c4shc&2YttWp0FjP;6u& z8l3B~G6hEvW57MBSF3g)ZqEv)k&n?uK<$`lAaEv9Fe}T13ZE*U)`b!b_zt9NBxNd7 z<4$-VoL+-2@BssefZKY0fd14)GEXM9H3eGQ368XEo0MPGC2U_ge$%aee#In7*hdW) z>)Ex^fnhEUvegkq$HnJG`_w!BG8hUVf7ZhCx4-#tzkA)gLy~E_j#;9~PsLkre~q@J zA)d8#wJDBL4D1}c3s zB%Ko%hZ->9Sl(P6ULabj&LV{DnsuHyhHF>1Ir4G*v31N>b8{lk%YW1c*XyqTH^xVb z{g*oNhpoM>(cKN1V$M^7UEm@V)Pu0sue_rV4ce%(9_hp3#^n%c#Y00Iud2wE$RYFF z-Oxp2gX^f*ANFl;%ggzdlaniHY2P2Mq@^CAuum>0?A~1+Tz^-a+N-SXlgT()21Z!V zvF1o4Avia;hpK)aRDM*Lt!IhO}4VTsrSi=wSGGDO zSD!=f?lbr}1R8;EQ-czMHdUsuK!v2Ia|}7#;+>?_F!9>qHgE!B8g&*1P&IITTMa%B zc2iljuYV0d06R^4b!*-YR~7;6W%~IJeyIN2u;__eN2+D9_k~wtQJ~ zJob9%AdJh|@6L*G6UHlIMmA!&XfwKd=8pzYJG7O)k&ncDS0}TVK=vw|4;;d# z(2NjBR#dIM~Im*B@c_@DKAS1{Go6xUikM{;aXFK+9%tznM zA?@G0i8zxLUB3V#<3W z0g(Rxo5Q#uXv0TLQqft%n#CIaPl~eb_ea^YFF3L4|`h@y1>2RJa3w@;xC;RLy%@d~b3jl�-NznD^Ok(8ACz{j8)O68x7rHjrt|#pU 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�ssx5B{@fdUyg>TFITubec!NI{N2w2rZb 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 C6oyU! literal 0 HcmV?d00001 diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/readme.txt b/libs/libtheora-1.1/win32/experimental/transcoder/readme.txt new file mode 100644 index 00000000..4f106ce1 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/transcoder/readme.txt @@ -0,0 +1,17 @@ +Quick hack at a transcoder tool from VP3 to Theora + +I actually built the avi2vp3 tool with codeWarrior, but it should compile under +VC as well. I have included a source avi file and the converted .vp3 output. +Output is a file with some header info matching YUVMPEG, and for each frame: + +FRAME header block matching YUV2MPEG +long (Intel aligned) keyframeflag describing in frame is a keyframe +long (Intel aligned) fsize storing frame size in bytes +bytes[fsize] with binary frame data + +The transcode tool is a modification of the current encoder. PUt it into the +win32/experimental subdirectory, and the paths should be correct. It produces +an apparently valid theora stream, but outputs garbage data. The code is packing +the binary frame data in a way that SHOULD work at least imo, but I am probably +missing some initialization issue (or vp3 is not transcodable to theora). + diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/transcoder.dsp b/libs/libtheora-1.1/win32/experimental/transcoder/transcoder.dsp new file mode 100644 index 00000000..863908b3 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/transcoder/transcoder.dsp @@ -0,0 +1,121 @@ +# Microsoft Developer Studio Project File - Name="transcoder" - Package Owner=<4> +# Microsoft Developer Studio Generated Build File, Format Version 6.00 +# ** DO NOT EDIT ** + +# TARGTYPE "Win32 (x86) Console Application" 0x0103 + +CFG=transcoder - Win32 Debug +!MESSAGE This is not a valid makefile. To build this project using NMAKE, +!MESSAGE use the Export Makefile command and run +!MESSAGE +!MESSAGE NMAKE /f "transcoder.mak". +!MESSAGE +!MESSAGE You can specify a configuration when running NMAKE +!MESSAGE by defining the macro CFG on the command line. For example: +!MESSAGE +!MESSAGE NMAKE /f "transcoder.mak" CFG="transcoder - Win32 Debug" +!MESSAGE +!MESSAGE Possible choices for configuration are: +!MESSAGE +!MESSAGE "transcoder - Win32 Release" (based on "Win32 (x86) Console Application") +!MESSAGE "transcoder - Win32 Debug" (based on "Win32 (x86) Console Application") +!MESSAGE + +# Begin Project +# PROP AllowPerConfigDependencies 0 +# PROP Scc_ProjName "" +# PROP Scc_LocalPath "" +CPP=cl.exe +RSC=rc.exe + +!IF "$(CFG)" == "transcoder - Win32 Release" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 0 +# PROP BASE Output_Dir "Release" +# PROP BASE Intermediate_Dir "Release" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 0 +# PROP Output_Dir "Release" +# PROP Intermediate_Dir "Release" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /c +# ADD CPP /nologo /MD /W3 /GX /O2 /I "..\..\..\include" /I "..\..\..\..\vorbis\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" /D GETOPT_API= /FD /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "NDEBUG" +# ADD RSC /l 0x409 /d "NDEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /machine:I386 +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static.lib ogg_static.lib vorbis_static.lib vorbisenc_static.lib /nologo /subsystem:console /machine:I386 /nodefaultlib:"LIBCMT" /out:"transcoder.exe" /libpath:"..\..\Static_Release" /libpath:"..\..\..\..\ogg\win32\Static_Release" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Release" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Release" + +!ELSEIF "$(CFG)" == "transcoder - Win32 Debug" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 1 +# PROP BASE Output_Dir "Debug" +# PROP BASE Intermediate_Dir "Debug" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 1 +# PROP Output_Dir "Debug" +# PROP Intermediate_Dir "Debug" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /Yu"stdafx.h" /FD /GZ /c +# ADD CPP /nologo /MDd /W3 /Gm /GX /ZI /Od /I "..\..\..\include" /I "..\..\..\..\vorbis\include" /I "..\..\..\..\ogg\include" /I "..\wincompat" /D "WIN32" /D "_DEBUG" /D "_CONSOLE" /D "_MBCS" /D GETOPT_API= /FD /GZ /c +# SUBTRACT CPP /YX /Yc /Yu +# ADD BASE RSC /l 0x409 /d "_DEBUG" +# ADD RSC /l 0x409 /d "_DEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib /nologo /subsystem:console /debug /machine:I386 /pdbtype:sept +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib theora_static_d.lib ogg_static_d.lib vorbis_static_d.lib vorbisenc_static_d.lib /nologo /subsystem:console /debug /machine:I386 /nodefaultlib:"LIBCD" /out:"transcoder.exe" /pdbtype:sept /libpath:"..\..\Static_Debug" /libpath:"..\..\..\..\ogg\win32\Static_Debug" /libpath:"..\..\..\..\vorbis\win32\Vorbis_Static_Debug" /libpath:"..\..\..\..\vorbis\win32\VorbisEnc_Static_Debug" +# SUBTRACT LINK32 /nodefaultlib + +!ENDIF + +# Begin Target + +# Name "transcoder - Win32 Release" +# Name "transcoder - Win32 Debug" +# Begin Group "Source Files" + +# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" +# Begin Source File + +SOURCE=..\wincompat\getopt.c +# End Source File +# Begin Source File + +SOURCE=..\wincompat\getopt_long.c +# End Source File +# Begin Source File + +SOURCE=.\transcoder_example.c +# End Source File +# End Group +# Begin Group "Header Files" + +# PROP Default_Filter "h;hpp;hxx;hm;inl" +# End Group +# Begin Group "Resource Files" + +# PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe" +# End Group +# Begin Group "library" + +# PROP Default_Filter "" +# End Group +# Begin Source File + +SOURCE=.\ReadMe.txt +# End Source File +# End Target +# End Project diff --git a/libs/libtheora-1.1/win32/experimental/transcoder/transcoder_example.c b/libs/libtheora-1.1/win32/experimental/transcoder/transcoder_example.c new file mode 100644 index 00000000..7c2dcbf8 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/transcoder/transcoder_example.c @@ -0,0 +1,926 @@ +/******************************************************************** + * * + * THIS FILE IS PART OF THE OggTheora SOFTWARE CODEC SOURCE CODE. * + * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS * + * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE * + * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. * + * * + * THE Theora SOURCE CODE IS COPYRIGHT (C) 2002-2004 * + * by the Xiph.Org Foundation http://www.xiph.org/ * + * * + ******************************************************************** + + function: example encoder application; makes an Ogg Theora/Vorbis + file from YUV4MPEG2 and WAV input + last mod: $Id: transcoder_example.c,v 1.4 2004/03/20 00:14:04 tterribe Exp $ + + ********************************************************************/ + +#define _GNU_SOURCE +#define _REENTRANT +#define _LARGEFILE_SOURCE +#define _LARGEFILE64_SOURCE +#define _FILE_OFFSET_BITS 64 + +#include +#include +#include +#include +#include +#include +#include +#include "theora/theora.h" +#include "vorbis/codec.h" +#include "vorbis/vorbisenc.h" + +#ifdef _WIN32 +/*supply missing headers and functions to Win32. going to hell, I know*/ +#include +#include + +static double rint(double x) +{ + if (x < 0.0) + return (double)(int)(x - 0.5); + else + return (double)(int)(x + 0.5); +} +#endif + +/*Copied from vorbis/sharedbook.c*/ +static int _ilog(unsigned int v){ + int ret=0; + while(v){ + ret++; + v>>=1; + } + return(ret); +} + + +const char *optstring = "o:a:A:v:V:"; +struct option options [] = { + {"output",required_argument,NULL,'o'}, + {"audio-rate-target",required_argument,NULL,'A'}, + {"video-rate-target",required_argument,NULL,'V'}, + {"audio-quality",required_argument,NULL,'a'}, + {"video-quality",required_argument,NULL,'v'}, + {NULL,0,NULL,0} +}; + +typedef struct TC_INSTANCE { + ogg_uint32_t LastKeyFrame ; + ogg_int64_t KeyFrameCount; + int ThisIsFirstFrame; + int ThisIsKeyFrame; + ogg_uint32_t CurrentFrame; + ogg_int64_t granulepos; + int keyframe_granule_shift; + char * in_bytes; + long in_bytecount; + ogg_uint32_t fps_denominator; + ogg_uint32_t fps_numerator; + oggpack_buffer opb_in; + oggpack_buffer opb_out; +} TC_INSTANCE; + +/* You'll go to Hell for using globals. */ + +FILE *audio=NULL; +FILE *video=NULL; + +int audio_ch=0; +int audio_hz=0; + +float audio_q=.1; +int audio_r=-1; + +int video_x=0; +int video_y=0; +int frame_x=0; +int frame_y=0; +int frame_x_offset=0; +int frame_y_offset=0; +int video_hzn=0; +int video_hzd=0; +int video_an=0; +int video_ad=0; + +int video_r=-1; +int video_q=16; + + char *vp3frame[2]; + int framebytecount[2]; + int frameiskey[2]; + + ogg_page audiopage; + ogg_page videopage; + +static void usage(void){ + fprintf(stderr, + "Usage: encoder_example [options] [audio_file] video_file\n\n" + "Options: \n\n" + " -o --output file name for encoded output;\n" + " If this option is not given, the\n" + " compressed data is sent to stdout.\n\n" + " -A --audio-rate-target bitrate target for Vorbis audio;\n" + " use -a and not -A if at all possible,\n" + " as -a gives higher quality for a given\n" + " bitrate.\n\n" + " -V --video-rate-target bitrate target for Theora video\n\n" + " -a --audio-quality Vorbis quality selector from -1 to 10\n" + " (-1 yields smallest files but lowest\n" + " fidelity; 10 yields highest fidelity\n" + " but large files. '2' is a reasonable\n" + " default).\n\n" + " -v --video-quality Theora quality selector fro 0 to 10\n" + " (0 yields smallest files but lowest\n" + " video quality. 10 yields highest\n" + " fidelity but large files).\n\n" + "encoder_example accepts only uncompressed RIFF WAV format audio and\n" + "YUV4MPEG2 uncompressed video.\n\n"); + exit(1); +} + +static void id_file(char *f){ + FILE *test; + unsigned char buffer[80]; + int ret; + + /* open it, look for magic */ + + if(!strcmp(f,"-")){ + /* stdin */ + test=stdin; + }else{ + test=fopen(f,"rb"); + if(!test){ + fprintf(stderr,"Unable to open file %s.\n",f); + exit(1); + } + } + + ret=fread(buffer,1,4,test); + if(ret<4){ + fprintf(stderr,"EOF determining file type of file %s.\n",f); + exit(1); + } + + if(!memcmp(buffer,"RIFF",4)){ + /* possible WAV file */ + + if(audio){ + /* umm, we already have one */ + fprintf(stderr,"Multiple RIFF WAVE files specified on command line.\n"); + exit(1); + } + + /* Parse the rest of the header */ + + ret=fread(buffer,1,4,test); + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + if(!memcmp(buffer,"WAVE",4)){ + + while(!feof(test)){ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + if(!memcmp("fmt",buffer,3)){ + + /* OK, this is our audio specs chunk. Slurp it up. */ + + ret=fread(buffer,1,20,test); + if(ret<20)goto riff_err; + + if(memcmp(buffer+4,"\001\000",2)){ + fprintf(stderr,"The WAV file %s is in a compressed format; " + "can't read it.\n",f); + exit(1); + } + + audio=test; + audio_ch=buffer[6]+(buffer[7]<<8); + audio_hz=buffer[8]+(buffer[9]<<8)+ + (buffer[10]<<16)+(buffer[11]<<24); + + if(buffer[18]+(buffer[19]<<8)!=16){ + fprintf(stderr,"Can only read 16 bit WAV files for now.\n"); + exit(1); + } + + /* Now, align things to the beginning of the data */ + /* Look for 'dataxxxx' */ + while(!feof(test)){ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + if(!memcmp("data",buffer,4)){ + /* We're there. Ignore the declared size for now. */ + ret=fread(buffer,1,4,test); + if(ret<4)goto riff_err; + + fprintf(stderr,"File %s is 16 bit %d channel %d Hz RIFF WAV audio.\n", + f,audio_ch,audio_hz); + + return; + } + } + } + } + } + + fprintf(stderr,"Couldn't find WAVE data in RIFF file %s.\n",f); + exit(1); + + } + if(!memcmp(buffer,"AVI2",4)){ + /* possible AVI2VP31 format file */ + /* read until newline, or 80 cols, whichever happens first */ + int i; + for(i=0;i<79;i++){ + ret=fread(buffer+i,1,1,test); + if(ret<1)goto yuv_err; + if(buffer[i]=='\n')break; + } + if(i==79){ + fprintf(stderr,"Error parsing %s header; not a VP31 raw frames file?\n",f); + } + buffer[i]='\0'; + + if(!memcmp(buffer,"VP31",4)){ + char interlace; + + if(video){ + /* umm, we already have one */ + fprintf(stderr,"Multiple video files specified on command line.\n"); + exit(1); + } + + if(buffer[4]!='R'){ + fprintf(stderr,"Incorrect file ; VP31 raw frames required.\n"); + } + + ret=sscanf(buffer,"VP31R W%d H%d F%d:%d I%c A%d:%d", + &frame_x,&frame_y,&video_hzn,&video_hzd,&interlace, + &video_an,&video_ad); + if(ret<7){ + fprintf(stderr,"Error parsing AVI2VP31R header in file %s.\n",f); + exit(1); + } + + if(interlace!='p'){ + fprintf(stderr,"Input video is interlaced; Theora handles only progressive scan\n"); + exit(1); + } + + video=test; + + fprintf(stderr,"File %s is %dx%d %.02f fps VP31 video.\n", + f,frame_x,frame_y,(double)video_hzn/video_hzd); + + return; + } + } + fprintf(stderr,"Input file %s is neither a WAV nor VP31 file.\n",f); + exit(1); + + riff_err: + fprintf(stderr,"EOF parsing RIFF file %s.\n",f); + exit(1); + yuv_err: + fprintf(stderr,"EOF parsing VP31 file %s.\n",f); + exit(1); + +} + +int spinner=0; +char *spinascii="|/-\\"; +void spinnit(void){ + spinner++; + if(spinner==4)spinner=0; + fprintf(stderr,"\r%c",spinascii[spinner]); +} + +int fetch_and_process_audio(FILE *audio,ogg_page *audiopage, + ogg_stream_state *vo, + vorbis_dsp_state *vd, + vorbis_block *vb, + int audioflag){ + ogg_packet op; + int i,j; + + while(audio && !audioflag){ + /* process any audio already buffered */ + spinnit(); + if(ogg_stream_pageout(vo,audiopage)>0) return 1; + if(ogg_stream_eos(vo))return 0; + + { + /* read and process more audio */ + signed char readbuffer[4096]; + int toread=4096/2/audio_ch; + int bytesread=fread(readbuffer,1,toread*2*audio_ch,audio); + int sampread=bytesread/2/audio_ch; + float **vorbis_buffer; + int count=0; + + if(bytesread<=0){ + /* end of file. this can be done implicitly, but it's + easier to see here in non-clever fashion. Tell the + library we're at end of stream so that it can handle the + last frame and mark end of stream in the output properly */ + vorbis_analysis_wrote(vd,0); + }else{ + vorbis_buffer=vorbis_analysis_buffer(vd,sampread); + /* uninterleave samples */ + for(i=0;iin_bytecount; + + if(!bytes)return(0); + + op->packet=ttc->in_bytes; + op->bytes=bytes; + op->b_o_s=0; + op->e_o_s=last_p; + + op->packetno=ttc->CurrentFrame; + op->granulepos=ttc->granulepos; + + return 1; +} + +void TranscodeKeyFrame(TC_INSTANCE *ttc){ + /* Keep track of the total number of Key Frames Coded */ + ttc->KeyFrameCount += 1; + ttc->LastKeyFrame = 1; +} + +void TranscodeFrame(TC_INSTANCE *ttc){ + ttc->LastKeyFrame++; +} + +void TranscodeFirstFrame(TC_INSTANCE *ttc){ + /* Keep track of the total number of Key Frames Coded. */ + ttc->KeyFrameCount = 1; + ttc->LastKeyFrame = 1; +} + +int theora_transcode_bufferin( TC_INSTANCE *ttc, int isKeyFrame, char * bytes, int bytecount){ + + /*transcode: record keyframe flag*/ + ttc->ThisIsKeyFrame = isKeyFrame; + + /* Special case for first frame */ + if ( ttc->ThisIsFirstFrame ){ + ttc->ThisIsFirstFrame = 0; + ttc->ThisIsKeyFrame = 0; + } else if ( ttc->ThisIsKeyFrame ) { + TranscodeKeyFrame(ttc); + ttc->ThisIsKeyFrame = 0; + } else { + /* Compress the frame. */ + TranscodeFrame( ttc ); + } + /*need to pack info here*/ + { + + int frame_type; + long total_bits; + long total_words; + int frac_bits; + + oggpackB_readinit(&ttc->opb_in,bytes,bytecount); + oggpackB_reset(&ttc->opb_out); + + /*Mark as video frame.*/ + oggpackB_write(&ttc->opb_out,0,1); + /*Copy frame type.*/ + frame_type=oggpackB_read1(&ttc->opb_in); + oggpackB_write(&ttc->opb_out,frame_type,1); + /*Skip an unused bit in the VP32 header.*/ + oggpackB_adv1(&ttc->opb_in); + /*Copy Q multiplier.*/ + oggpackB_write(&ttc->opb_out,oggpackB_read(&ttc->opb_in,6),6); + /*VP3 has no per-block Q multipliers*/ + oggpackB_write(&ttc->opb_out,0,1); + /*If the frame is a base/key/golden frame, copy a few extra bits.*/ + if(frame_type==0){ + /*These 13 bits are not included in a Theora frame header. + They were 0's and VP3 version info in VP32.*/ + oggpackB_adv(&ttc->opb_in,13); + /*Copy the key frame type and the spare configuration bits.*/ + oggpackB_write(&ttc->opb_out,oggpackB_read(&ttc->opb_in,3),3); + } + + /*Copy the rest of the bits over.*/ + total_bits=bytecount*8-oggpack_bits(&ttc->opb_in); + frac_bits=(int)(total_bits&31); + if(frac_bits){ + oggpackB_write(&ttc->opb_out,oggpackB_read(&ttc->opb_in,frac_bits), + frac_bits); + } + total_words=total_bits>>5; + while(total_words-->0){ + oggpackB_write(&ttc->opb_out,oggpackB_read(&ttc->opb_in,32),32); + } + + ttc->in_bytecount = oggpackB_bytes(&ttc->opb_out); + ttc->in_bytes = oggpackB_get_buffer(&ttc->opb_out); + } + + /* Update stats variables. */ + ttc->CurrentFrame++; + + ttc->granulepos= + ((ttc->CurrentFrame-ttc->LastKeyFrame-1)<keyframe_granule_shift)+ + ttc->LastKeyFrame-1; + + return 0; +} + +//static void _tp_writebuffer(oggpack_buffer *opb, const char *buf, const long len) + +int theora_transcoder_init(theora_info * ti, TC_INSTANCE * ttc){ + memset(ttc, 0, sizeof(*ttc)); + ttc->granulepos = -1; + ttc->keyframe_granule_shift=_ilog(ti->keyframe_frequency_force-1); + ttc->LastKeyFrame = 0; + ttc->KeyFrameCount = 0; + ttc->ThisIsFirstFrame = 1; + ttc->ThisIsKeyFrame = 0; + ttc->CurrentFrame = 1; + ttc->in_bytes = 0; + ttc->in_bytecount = 0; + ttc->fps_denominator = ti->fps_denominator; + ttc->fps_numerator = ti->fps_numerator; + oggpackB_writeinit(&ttc->opb_out); + return 0; +} + +int fetch_and_process_video(FILE *video,ogg_page *videopage, + ogg_stream_state *to, + TC_INSTANCE *ttc, + int videoflag){ + /* You'll go to Hell for using static variables */ + static int state=-1; + ogg_packet op; + int i; + int keyframeflag, framelength; + + + if(state==-1){ + /* initialize the double frame buffer */ + state=0; + } + + /* is there a video page flushed? If not, work until there is. */ + while(!videoflag){ + spinnit(); + + if(ogg_stream_pageout(to,videopage)>0) return 1; + if(ogg_stream_eos(to)) return 0; + + { + /* read and process more video */ + /* video strategy reads one frame ahead so we know when we're + at end of stream and can mark last video frame as such + (vorbis audio has to flush one frame past last video frame + due to overlap and thus doesn't need this extra work */ + + /* have two frame buffers full (if possible) before + proceeding. after first pass and until eos, one will + always be full when we get here */ + + for(i=state;i<2;i++){ + char c,frame[6]; + int ret=fread(frame,1,6,video); + + /* match and skip the frame header */ + if(ret<6)break; + if(memcmp(frame,"FRAME",5)){ + fprintf(stderr,"Loss of framing in VP31 input data\n"); + exit(1); + } + if(frame[5]!='\n'){ + int j; + for(j=0;j<79;j++) + if(fread(&c,1,1,video)&&c=='\n')break; + if(j==79){ + fprintf(stderr,"Error parsing VP31 frame header\n"); + exit(1); + } + } + + /*read the length*/ + ret=fread(&framelength, sizeof(int), 1, video); + + /*read the keyframeflag*/ + ret=fread(&keyframeflag, sizeof(int), 1, video); + + vp3frame[i] = malloc(framelength); + framebytecount[i] = framelength; + frameiskey[i] = keyframeflag; + + /* read the frame */ + ret=fread((char *) vp3frame[i], sizeof(char), framelength, video); + if(ret!=framelength) break; + + state++; + } + + if(state<1){ + /* can't get here unless VP31 stream has no video */ + fprintf(stderr,"Video input contains no frames.\n"); + exit(1); + } + + /* Theora is a one-frame-in,one-frame-out system; submit a frame + for compression and pull out the packet */ + + //theora_encode_YUVin(td,&yuv); + theora_transcode_bufferin( ttc, frameiskey[0], vp3frame[0], framebytecount[0]); + + /* if there's only one frame, it's the last in the stream */ + if(state<2) + theora_transcode_packetout(ttc,1,&op); + else + theora_transcode_packetout(ttc,0,&op); + + ogg_stream_packetin(to,&op); + + { + signed char *temp=vp3frame[0]; + vp3frame[0]=vp3frame[1]; + vp3frame[1] = temp; + free(temp); + + framebytecount[0]= framebytecount[1]; + frameiskey[0] = frameiskey[1]; + state--; + } + } + } + return videoflag; +} + +/* returns, in seconds, absolute time of current packet in given + logical stream */ +double transcode_granule_time(TC_INSTANCE *ttc,ogg_int64_t granulepos){ + if(granulepos>=0){ + ogg_int64_t iframe=granulepos>>ttc->keyframe_granule_shift; + ogg_int64_t pframe=granulepos-(iframe<keyframe_granule_shift); + + return (iframe+pframe)* + ((double)ttc->fps_denominator/ttc->fps_numerator); + + } + return(-1); +} + +int main(int argc,char *argv[]){ + int c,long_option_index,ret; + + ogg_stream_state to; /* take physical pages, weld into a logical + stream of packets */ + ogg_stream_state vo; /* take physical pages, weld into a logical + stream of packets */ + ogg_page og; /* one Ogg bitstream page. Vorbis packets are inside */ + ogg_packet op; /* one raw packet of data for decode */ + + theora_state td; + theora_info ti; + theora_comment tc; + + vorbis_info vi; /* struct that stores all the static vorbis bitstream + settings */ + vorbis_comment vc; /* struct that stores all the user comments */ + + vorbis_dsp_state vd; /* central working state for the packet->PCM decoder */ + vorbis_block vb; /* local working space for packet->PCM decode */ + + int audioflag=0; + int videoflag=0; + int akbps=0; + int vkbps=0; + + ogg_int64_t audio_bytesout=0; + ogg_int64_t video_bytesout=0; + double timebase; + + FILE* outfile = stdout; + + TC_INSTANCE ttc; + +#ifdef _WIN32 /* We need to set stdin/stdout to binary mode. Damn windows. */ + /* if we were reading/writing a file, it would also need to in + binary mode, eg, fopen("file.wav","wb"); */ + /* Beware the evil ifdef. We avoid these where we can, but this one we + cannot. Don't add any more, you'll probably go to hell if you do. */ + _setmode( _fileno( stdin ), _O_BINARY ); + _setmode( _fileno( stdout ), _O_BINARY ); +#endif + + while((c=getopt_long(argc,argv,optstring,options,&long_option_index))!=EOF){ + switch(c){ + case 'o': + outfile=fopen(optarg,"wb"); + if(outfile==NULL){ + fprintf(stderr,"Unable to open output file '%s'\n", optarg); + exit(1); + } + break;; + + case 'a': + audio_q=atof(optarg)*.099; + if(audio_q<-.1 || audio_q>1){ + fprintf(stderr,"Illegal audio quality (choose -1 through 10)\n"); + exit(1); + } + audio_r=-1; + break; + + case 'v': + video_q=rint(atof(optarg)*6.3); + if(video_q<0 || video_q>63){ + fprintf(stderr,"Illegal video quality (choose 0 through 10)\n"); + exit(1); + } + video_r=0; + break; + + case 'A': + audio_r=atof(optarg)*1000; + if(audio_q<0){ + fprintf(stderr,"Illegal audio quality (choose > 0 please)\n"); + exit(1); + } + audio_q=-99; + break; + + case 'V': + video_r=rint(atof(optarg)*1000); + if(video_r<45000 || video_r>2000000){ + fprintf(stderr,"Illegal video bitrate (choose 45kbps through 2000kbps)\n"); + exit(1); + } + video_q=0; + break; + default: + usage(); + } + } + + while(optind>4)<<4; + video_y=((frame_y + 15) >>4)<<4; + frame_x_offset=(video_x-frame_x)/2; + frame_y_offset=(video_y-frame_y)/2; + + theora_info_init(&ti); + ti.width=video_x; + ti.height=video_y; + ti.frame_width=frame_x; + ti.frame_height=frame_y; + ti.offset_x=frame_x_offset; + ti.offset_y=frame_y_offset; + ti.fps_numerator=video_hzn; + ti.fps_denominator=video_hzd; + ti.aspect_numerator=video_an; + ti.aspect_denominator=video_ad; + ti.colorspace=OC_CS_UNSPECIFIED; + ti.target_bitrate=video_r; + ti.quality=video_q; + + ti.dropframes_p=0; + ti.quick_p=1; + ti.keyframe_auto_p=1; + ti.keyframe_frequency=32768; + ti.keyframe_frequency_force=32768; + ti.keyframe_data_target_bitrate=video_r*1.5; + ti.keyframe_auto_threshold=80; + ti.keyframe_mindistance=8; + ti.noise_sensitivity=1; + + theora_encode_init(&td,&ti); + theora_transcoder_init(&ti, &ttc); + theora_info_clear(&ti); + + /* initialize Vorbis too, assuming we have audio to compress. */ + if(audio){ + vorbis_info_init(&vi); + if(audio_q>-99) + ret = vorbis_encode_init_vbr(&vi,audio_ch,audio_hz,audio_q); + else + ret = vorbis_encode_init(&vi,audio_ch,audio_hz,-1,audio_r,-1); + if(ret){ + fprintf(stderr,"The Vorbis encoder could not set up a mode according to\n" + "the requested quality or bitrate.\n\n"); + exit(1); + } + + vorbis_comment_init(&vc); + vorbis_analysis_init(&vd,&vi); + vorbis_block_init(&vd,&vb); + } + + /* write the bitstream header packets with proper page interleave */ + + /* first packet will get its own page automatically */ + theora_encode_header(&td,&op); + ogg_stream_packetin(&to,&op); + if(ogg_stream_pageout(&to,&og)!=1){ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + + /* create the remaining theora headers */ + theora_comment_init(&tc); + theora_encode_comment(&tc,&op); + ogg_stream_packetin(&to,&op); + theora_encode_tables(&td,&op); + ogg_stream_packetin(&to,&op); + + if(audio){ + ogg_packet header; + ogg_packet header_comm; + ogg_packet header_code; + + vorbis_analysis_headerout(&vd,&vc,&header,&header_comm,&header_code); + ogg_stream_packetin(&vo,&header); /* automatically placed in its own + page */ + if(ogg_stream_pageout(&vo,&og)!=1){ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + + /* remaining vorbis header packets */ + ogg_stream_packetin(&vo,&header_comm); + ogg_stream_packetin(&vo,&header_code); + } + + /* Flush the rest of our headers. This ensures + the actual data in each stream will start + on a new page, as per spec. */ + while(1){ + int result = ogg_stream_flush(&to,&og); + if(result<0){ + /* can't get here */ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + if(result==0)break; + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + } + if(audio){ + while(1){ + int result=ogg_stream_flush(&vo,&og); + if(result<0){ + /* can't get here */ + fprintf(stderr,"Internal Ogg library error.\n"); + exit(1); + } + if(result==0)break; + fwrite(og.header,1,og.header_len,outfile); + fwrite(og.body,1,og.body_len,outfile); + } + } + + /* setup complete. Raw processing loop */ + fprintf(stderr,"Compressing....\n"); + while(1){ + + + /* is there an audio page flushed? If not, fetch one if possible */ + audioflag=fetch_and_process_audio(audio,&audiopage,&vo,&vd,&vb,audioflag); + + /* is there a video page flushed? If not, fetch one if possible */ + videoflag=fetch_and_process_video(video,&videopage,&to,&ttc,videoflag); + + /* no pages of either? Must be end of stream. */ + if(!audioflag && !videoflag)break; + + /* which is earlier; the end of the audio page or the end of the + video page? Flush the earlier to stream */ + { + int audio_or_video=-1; + double audiotime= + audioflag?vorbis_granule_time(&vd,ogg_page_granulepos(&audiopage)):-1; + double videotime= + videoflag?transcode_granule_time(&ttc,ogg_page_granulepos(&videopage)):-1; + + if(!audioflag){ + audio_or_video=1; + } else if(!videoflag) { + audio_or_video=0; + } else { + if(audiotime +//__FBSDID("$FreeBSD: src/lib/libc/stdlib/getopt.c,v 1.6 2002/03/29 22:43:42 markm Exp $"); + +#include "namespace.h"*/ +#include +#include +#include +/*#include "un-namespace.h"*/ + +/*#include "libc_private.h"*/ + +int opterr = 1, /* if error message should be printed */ + optind = 1, /* index into parent argv vector */ + optopt, /* character checked for validity */ + optreset; /* reset getopt */ +char *optarg; /* argument associated with option */ + +#define BADCH (int)'?' +#define BADARG (int)':' +#define EMSG "" + +/* + * getopt -- + * Parse argc/argv argument vector. + */ +int +getopt(nargc, nargv, ostr) + int nargc; + char * const *nargv; + const char *ostr; +{ + static char *place = EMSG; /* option letter processing */ + char *oli; /* option letter list index */ + + if (optreset || !*place) { /* update scanning pointer */ + optreset = 0; + if (optind >= nargc || *(place = nargv[optind]) != '-') { + place = EMSG; + return (-1); + } + if (place[1] && *++place == '-') { /* found "--" */ + ++optind; + place = EMSG; + return (-1); + } + } /* option letter okay? */ + if ((optopt = (int)*place++) == (int)':' || + !(oli = strchr(ostr, optopt))) { + /* + * if the user didn't specify '-' as an option, + * assume it means -1. + */ + if (optopt == (int)'-') + return (-1); + if (!*place) + ++optind; + if (opterr && *ostr != ':' && optopt != BADCH) + (void)fprintf(stderr, "%s: illegal option -- %c\n", + "progname", optopt); + return (BADCH); + } + if (*++oli != ':') { /* don't need argument */ + optarg = NULL; + if (!*place) + ++optind; + } + else { /* need an argument */ + if (*place) /* no white space */ + optarg = place; + else if (nargc <= ++optind) { /* no arg */ + place = EMSG; + if (*ostr == ':') + return (BADARG); + if (opterr) + (void)fprintf(stderr, + "%s: option requires an argument -- %c\n", + "progname", optopt); + return (BADCH); + } + else /* white space */ + optarg = nargv[optind]; + place = EMSG; + ++optind; + } + return (optopt); /* dump back option letter */ +} diff --git a/libs/libtheora-1.1/win32/experimental/wincompat/getopt.h b/libs/libtheora-1.1/win32/experimental/wincompat/getopt.h new file mode 100644 index 00000000..ef305bf1 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/wincompat/getopt.h @@ -0,0 +1,110 @@ +/* $NetBSD: getopt.h,v 1.4 2000/07/07 10:43:54 ad Exp $ */ +/* $FreeBSD: src/include/getopt.h,v 1.1 2002/09/29 04:14:30 eric Exp $ */ + +/*- + * Copyright (c) 2000 The NetBSD Foundation, Inc. + * All rights reserved. + * + * This code is derived from software contributed to The NetBSD Foundation + * by Dieter Baron and Thomas Klausner. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the NetBSD + * Foundation, Inc. and its contributors. + * 4. Neither the name of The NetBSD Foundation nor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS + * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS + * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef _GETOPT_H_ +#define _GETOPT_H_ + +#ifdef _WIN32 +/* from */ +# ifdef __cplusplus +# define __BEGIN_DECLS extern "C" { +# define __END_DECLS } +# else +# define __BEGIN_DECLS +# define __END_DECLS +# endif +# define __P(args) args +#endif + +/*#ifndef _WIN32 +#include +#include +#endif*/ + +#ifdef _WIN32 +# if !defined(GETOPT_API) +# define GETOPT_API __declspec(dllimport) +# endif +#endif + +/* + * Gnu like getopt_long() and BSD4.4 getsubopt()/optreset extensions + */ +#if !defined(_POSIX_SOURCE) && !defined(_XOPEN_SOURCE) +#define no_argument 0 +#define required_argument 1 +#define optional_argument 2 + +struct option { + /* name of long option */ + const char *name; + /* + * one of no_argument, required_argument, and optional_argument: + * whether option takes an argument + */ + int has_arg; + /* if not NULL, set *flag to val when option found */ + int *flag; + /* if flag not NULL, value to set *flag to; else return value */ + int val; +}; + +__BEGIN_DECLS +GETOPT_API int getopt_long __P((int, char * const *, const char *, + const struct option *, int *)); +__END_DECLS +#endif + +#ifdef _WIN32 +/* These are global getopt variables */ +__BEGIN_DECLS + +GETOPT_API extern int opterr, /* if error message should be printed */ + optind, /* index into parent argv vector */ + optopt, /* character checked for validity */ + optreset; /* reset getopt */ +GETOPT_API extern char* optarg; /* argument associated with option */ + +/* Original getopt */ +GETOPT_API int getopt __P((int, char * const *, const char *)); + +__END_DECLS +#endif + +#endif /* !_GETOPT_H_ */ diff --git a/libs/libtheora-1.1/win32/experimental/wincompat/getopt_long.c b/libs/libtheora-1.1/win32/experimental/wincompat/getopt_long.c new file mode 100644 index 00000000..a74b23e7 --- /dev/null +++ b/libs/libtheora-1.1/win32/experimental/wincompat/getopt_long.c @@ -0,0 +1,547 @@ +/* $NetBSD: getopt_long.c,v 1.15 2002/01/31 22:43:40 tv Exp $ */ +/* $FreeBSD: src/lib/libc/stdlib/getopt_long.c,v 1.2 2002/10/16 22:18:42 alfred Exp $ */ + +/*- + * Copyright (c) 2000 The NetBSD Foundation, Inc. + * All rights reserved. + * + * This code is derived from software contributed to The NetBSD Foundation + * by Dieter Baron and Thomas Klausner. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the NetBSD + * Foundation, Inc. and its contributors. + * 4. Neither the name of The NetBSD Foundation nor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS + * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS + * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ + + +#include +#include +#include + +#ifdef _WIN32 + +/* Windows needs warnx(). We change the definition though: + * 1. (another) global is defined, opterrmsg, which holds the error message + * 2. errors are always printed out on stderr w/o the program name + * Note that opterrmsg always gets set no matter what opterr is set to. The + * error message will not be printed if opterr is 0 as usual. + */ + +#include +#include + +GETOPT_API extern char opterrmsg[128]; +char opterrmsg[128]; /* last error message is stored here */ + +static void warnx(int print_error, const char *fmt, ...) +{ + va_list ap; + va_start(ap, fmt); + if (fmt != NULL) + _vsnprintf(opterrmsg, 128, fmt, ap); + else + opterrmsg[0]='\0'; + va_end(ap); + if (print_error) { + fprintf(stderr, opterrmsg); + fprintf(stderr, "\n"); + } +} + +#endif /*_WIN32*/ + +/* not part of the original file */ +#ifndef _DIAGASSERT +#define _DIAGASSERT(X) +#endif + +#if HAVE_CONFIG_H && !HAVE_GETOPT_LONG && !HAVE_DECL_OPTIND +#define REPLACE_GETOPT +#endif + +#ifdef REPLACE_GETOPT +#ifdef __weak_alias +__weak_alias(getopt,_getopt) +#endif +int opterr = 1; /* if error message should be printed */ +int optind = 1; /* index into parent argv vector */ +int optopt = '?'; /* character checked for validity */ +int optreset; /* reset getopt */ +char *optarg; /* argument associated with option */ +#elif HAVE_CONFIG_H && !HAVE_DECL_OPTRESET +static int optreset; +#endif + +#ifdef __weak_alias +__weak_alias(getopt_long,_getopt_long) +#endif + +#if !HAVE_GETOPT_LONG +#define IGNORE_FIRST (*options == '-' || *options == '+') +#define PRINT_ERROR ((opterr) && ((*options != ':') \ + || (IGNORE_FIRST && options[1] != ':'))) +#define IS_POSIXLY_CORRECT (getenv("POSIXLY_CORRECT") != NULL) +#define PERMUTE (!IS_POSIXLY_CORRECT && !IGNORE_FIRST) +/* XXX: GNU ignores PC if *options == '-' */ +#define IN_ORDER (!IS_POSIXLY_CORRECT && *options == '-') + +/* return values */ +#define BADCH (int)'?' +#define BADARG ((IGNORE_FIRST && options[1] == ':') \ + || (*options == ':') ? (int)':' : (int)'?') +#define INORDER (int)1 + +#define EMSG "" + +static int getopt_internal(int, char * const *, const char *); +static int gcd(int, int); +static void permute_args(int, int, int, char * const *); + +static char *place = EMSG; /* option letter processing */ + +/* XXX: set optreset to 1 rather than these two */ +static int nonopt_start = -1; /* first non option argument (for permute) */ +static int nonopt_end = -1; /* first option after non options (for permute) */ + +/* Error messages */ +static const char recargchar[] = "option requires an argument -- %c"; +static const char recargstring[] = "option requires an argument -- %s"; +static const char ambig[] = "ambiguous option -- %.*s"; +static const char noarg[] = "option doesn't take an argument -- %.*s"; +static const char illoptchar[] = "unknown option -- %c"; +static const char illoptstring[] = "unknown option -- %s"; + + +/* + * Compute the greatest common divisor of a and b. + */ +static int +gcd(a, b) + int a; + int b; +{ + int c; + + c = a % b; + while (c != 0) { + a = b; + b = c; + c = a % b; + } + + return b; +} + +/* + * Exchange the block from nonopt_start to nonopt_end with the block + * from nonopt_end to opt_end (keeping the same order of arguments + * in each block). + */ +static void +permute_args(panonopt_start, panonopt_end, opt_end, nargv) + int panonopt_start; + int panonopt_end; + int opt_end; + char * const *nargv; +{ + int cstart, cyclelen, i, j, ncycle, nnonopts, nopts, pos; + char *swap; + + _DIAGASSERT(nargv != NULL); + + /* + * compute lengths of blocks and number and size of cycles + */ + nnonopts = panonopt_end - panonopt_start; + nopts = opt_end - panonopt_end; + ncycle = gcd(nnonopts, nopts); + cyclelen = (opt_end - panonopt_start) / ncycle; + + for (i = 0; i < ncycle; i++) { + cstart = panonopt_end+i; + pos = cstart; + for (j = 0; j < cyclelen; j++) { + if (pos >= panonopt_end) + pos -= nnonopts; + else + pos += nopts; + swap = nargv[pos]; + /* LINTED const cast */ + ((char **) nargv)[pos] = nargv[cstart]; + /* LINTED const cast */ + ((char **)nargv)[cstart] = swap; + } + } +} + +/* + * getopt_internal -- + * Parse argc/argv argument vector. Called by user level routines. + * Returns -2 if -- is found (can be long option or end of options marker). + */ +static int +getopt_internal(nargc, nargv, options) + int nargc; + char * const *nargv; + const char *options; +{ + char *oli; /* option letter list index */ + int optchar; + + _DIAGASSERT(nargv != NULL); + _DIAGASSERT(options != NULL); + + optarg = NULL; + + /* + * XXX Some programs (like rsyncd) expect to be able to + * XXX re-initialize optind to 0 and have getopt_long(3) + * XXX properly function again. Work around this braindamage. + */ + if (optind == 0) + optind = 1; + + if (optreset) + nonopt_start = nonopt_end = -1; +start: + if (optreset || !*place) { /* update scanning pointer */ + optreset = 0; + if (optind >= nargc) { /* end of argument vector */ + place = EMSG; + if (nonopt_end != -1) { + /* do permutation, if we have to */ + permute_args(nonopt_start, nonopt_end, + optind, nargv); + optind -= nonopt_end - nonopt_start; + } + else if (nonopt_start != -1) { + /* + * If we skipped non-options, set optind + * to the first of them. + */ + optind = nonopt_start; + } + nonopt_start = nonopt_end = -1; + return -1; + } + if ((*(place = nargv[optind]) != '-') + || (place[1] == '\0')) { /* found non-option */ + place = EMSG; + if (IN_ORDER) { + /* + * GNU extension: + * return non-option as argument to option 1 + */ + optarg = nargv[optind++]; + return INORDER; + } + if (!PERMUTE) { + /* + * if no permutation wanted, stop parsing + * at first non-option + */ + return -1; + } + /* do permutation */ + if (nonopt_start == -1) + nonopt_start = optind; + else if (nonopt_end != -1) { + permute_args(nonopt_start, nonopt_end, + optind, nargv); + nonopt_start = optind - + (nonopt_end - nonopt_start); + nonopt_end = -1; + } + optind++; + /* process next argument */ + goto start; + } + if (nonopt_start != -1 && nonopt_end == -1) + nonopt_end = optind; + if (place[1] && *++place == '-') { /* found "--" */ + place++; + return -2; + } + } + if ((optchar = (int)*place++) == (int)':' || + (oli = strchr(options + (IGNORE_FIRST ? 1 : 0), optchar)) == NULL) { + /* option letter unknown or ':' */ + if (!*place) + ++optind; +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(illoptchar, optchar); +#else + warnx(PRINT_ERROR, illoptchar, optchar); +#endif + optopt = optchar; + return BADCH; + } + if (optchar == 'W' && oli[1] == ';') { /* -W long-option */ + /* XXX: what if no long options provided (called by getopt)? */ + if (*place) + return -2; + + if (++optind >= nargc) { /* no arg */ + place = EMSG; +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(recargchar, optchar); +#else + warnx(PRINT_ERROR, recargchar, optchar); +#endif + optopt = optchar; + return BADARG; + } else /* white space */ + place = nargv[optind]; + /* + * Handle -W arg the same as --arg (which causes getopt to + * stop parsing). + */ + return -2; + } + if (*++oli != ':') { /* doesn't take argument */ + if (!*place) + ++optind; + } else { /* takes (optional) argument */ + optarg = NULL; + if (*place) /* no white space */ + optarg = place; + /* XXX: disable test for :: if PC? (GNU doesn't) */ + else if (oli[1] != ':') { /* arg not optional */ + if (++optind >= nargc) { /* no arg */ + place = EMSG; +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(recargchar, optchar); +#else + warnx(PRINT_ERROR, recargchar, optchar); +#endif + optopt = optchar; + return BADARG; + } else + optarg = nargv[optind]; + } + place = EMSG; + ++optind; + } + /* dump back option letter */ + return optchar; +} + +#ifdef REPLACE_GETOPT +/* + * getopt -- + * Parse argc/argv argument vector. + * + * [eventually this will replace the real getopt] + */ +int +getopt(nargc, nargv, options) + int nargc; + char * const *nargv; + const char *options; +{ + int retval; + + _DIAGASSERT(nargv != NULL); + _DIAGASSERT(options != NULL); + + if ((retval = getopt_internal(nargc, nargv, options)) == -2) { + ++optind; + /* + * We found an option (--), so if we skipped non-options, + * we have to permute. + */ + if (nonopt_end != -1) { + permute_args(nonopt_start, nonopt_end, optind, + nargv); + optind -= nonopt_end - nonopt_start; + } + nonopt_start = nonopt_end = -1; + retval = -1; + } + return retval; +} +#endif + +/* + * getopt_long -- + * Parse argc/argv argument vector. + */ +int +getopt_long(nargc, nargv, options, long_options, idx) + int nargc; + char * const *nargv; + const char *options; + const struct option *long_options; + int *idx; +{ + int retval; + + _DIAGASSERT(nargv != NULL); + _DIAGASSERT(options != NULL); + _DIAGASSERT(long_options != NULL); + /* idx may be NULL */ + + if ((retval = getopt_internal(nargc, nargv, options)) == -2) { + char *current_argv, *has_equal; + size_t current_argv_len; + int i, match; + + current_argv = place; + match = -1; + + optind++; + place = EMSG; + + if (*current_argv == '\0') { /* found "--" */ + /* + * We found an option (--), so if we skipped + * non-options, we have to permute. + */ + if (nonopt_end != -1) { + permute_args(nonopt_start, nonopt_end, + optind, nargv); + optind -= nonopt_end - nonopt_start; + } + nonopt_start = nonopt_end = -1; + return -1; + } + if ((has_equal = strchr(current_argv, '=')) != NULL) { + /* argument found (--option=arg) */ + current_argv_len = has_equal - current_argv; + has_equal++; + } else + current_argv_len = strlen(current_argv); + + for (i = 0; long_options[i].name; i++) { + /* find matching long option */ + if (strncmp(current_argv, long_options[i].name, + current_argv_len)) + continue; + + if (strlen(long_options[i].name) == + (unsigned)current_argv_len) { + /* exact match */ + match = i; + break; + } + if (match == -1) /* partial match */ + match = i; + else { + /* ambiguous abbreviation */ +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(ambig, (int)current_argv_len, + current_argv); +#else + warnx(PRINT_ERROR, ambig, (int)current_argv_len, + current_argv); +#endif + optopt = 0; + return BADCH; + } + } + if (match != -1) { /* option found */ + if (long_options[match].has_arg == no_argument + && has_equal) { +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(noarg, (int)current_argv_len, + current_argv); +#else + warnx(PRINT_ERROR, noarg, (int)current_argv_len, + current_argv); +#endif + /* + * XXX: GNU sets optopt to val regardless of + * flag + */ + if (long_options[match].flag == NULL) + optopt = long_options[match].val; + else + optopt = 0; + return BADARG; + } + if (long_options[match].has_arg == required_argument || + long_options[match].has_arg == optional_argument) { + if (has_equal) + optarg = has_equal; + else if (long_options[match].has_arg == + required_argument) { + /* + * optional argument doesn't use + * next nargv + */ + optarg = nargv[optind++]; + } + } + if ((long_options[match].has_arg == required_argument) + && (optarg == NULL)) { + /* + * Missing argument; leading ':' + * indicates no error should be generated + */ +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(recargstring, current_argv); +#else + warnx(PRINT_ERROR, recargstring, current_argv); +#endif + /* + * XXX: GNU sets optopt to val regardless + * of flag + */ + if (long_options[match].flag == NULL) + optopt = long_options[match].val; + else + optopt = 0; + --optind; + return BADARG; + } + } else { /* unknown option */ +#ifndef _WIN32 + if (PRINT_ERROR) + warnx(illoptstring, current_argv); +#else + warnx(PRINT_ERROR, illoptstring, current_argv); +#endif + optopt = 0; + return BADCH; + } + if (long_options[match].flag) { + *long_options[match].flag = long_options[match].val; + retval = 0; + } else + retval = long_options[match].val; + if (idx) + *idx = match; + } + return retval; +} +#endif /* !GETOPT_LONG */ diff --git a/libs/libtheora-1.1/win32/experimental/wincompat/unistd.h b/libs/libtheora-1.1/win32/experimental/wincompat/unistd.h new file mode 100644 index 00000000..e69de29b diff --git a/libs/libtheora-1.1/win32/getopt.c b/libs/libtheora-1.1/win32/getopt.c new file mode 100644 index 00000000..33d299bd --- /dev/null +++ b/libs/libtheora-1.1/win32/getopt.c @@ -0,0 +1,1047 @@ +/* Getopt for GNU. + NOTE: getopt is now part of the C library, so if you don't know what + "Keep this file name-space clean" means, talk to drepper@gnu.org + before changing it! + + Copyright (C) 1987, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99 + Free Software Foundation, Inc. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with the GNU C Library; see the file COPYING.LIB. If not, + write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. */ + +/* This tells Alpha OSF/1 not to define a getopt prototype in . + Ditto for AIX 3.2 and . */ +#ifndef _NO_PROTO +# define _NO_PROTO +#endif + +#ifdef HAVE_CONFIG_H +# include "config.h" +#endif + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems + reject `defined (const)'. */ +# ifndef const +# define const +# endif +#endif + +#include + +/* Comment out all this code if we are using the GNU C Library, and are not + actually compiling the library itself. This code is part of the GNU C + Library, but also included in many other GNU distributions. Compiling + and linking in this code is a waste when using the GNU C library + (especially if it is a shared library). Rather than having every GNU + program understand `configure --with-gnu-libc' and omit the object files, + it is simpler to just do this in the source for each such file. */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +# include +# if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +# define ELIDE_CODE +# endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include + to get __GNU_LIBRARY__ defined. */ +#ifdef __GNU_LIBRARY__ +/* Don't include stdlib.h for non-GNU C libraries because some of them + contain conflicting prototypes for getopt. */ +# include +# include +#endif /* GNU C library. */ + +#ifdef VMS +# include +# if HAVE_STRING_H - 0 +# include +# endif +#endif + +#ifndef _ +/* This is for other GNU distributions with internationalized messages. + When compiling libc, the _ macro is predefined. */ +# ifdef HAVE_LIBINTL_H +# include +# define _(msgid) gettext (msgid) +# else +# define _(msgid) (msgid) +# endif +#endif + +/* This version of `getopt' appears to the caller like standard Unix `getopt' + but it behaves differently for the user, since it allows the user + to intersperse the options with the other arguments. + + As `getopt' works, it permutes the elements of ARGV so that, + when it is done, all the options precede everything else. Thus + all application programs are extended to handle flexible argument order. + + Setting the environment variable POSIXLY_CORRECT disables permutation. + Then the behavior is completely standard. + + GNU application programs can use a third alternative mode in which + they can distinguish the relative order of options and other arguments. */ + +#include "getopt_win.h" + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +/* 1003.2 says this must be 1 before any call. */ +int optind = 1; + +/* Formerly, initialization of getopt depended on optind==0, which + causes problems with re-calling getopt as programs generally don't + know that. */ + +int __getopt_initialized; + +/* The next char to be scanned in the option-element + in which the last option character we returned was found. + This allows us to pick up the scan where we left off. + + If this is zero, or a null string, it means resume the scan + by advancing to the next ARGV-element. */ + +static char *nextchar; + +/* Callers store zero here to inhibit the error message + for unrecognized options. */ + +int opterr = 1; + +/* Set to an option character which was unrecognized. + This must be initialized on some systems to avoid linking in the + system's own getopt implementation. */ + +int optopt = '?'; + +/* Describe how to deal with options that follow non-option ARGV-elements. + + If the caller did not specify anything, + the default is REQUIRE_ORDER if the environment variable + POSIXLY_CORRECT is defined, PERMUTE otherwise. + + REQUIRE_ORDER means don't recognize them as options; + stop option processing when the first non-option is seen. + This is what Unix does. + This mode of operation is selected by either setting the environment + variable POSIXLY_CORRECT, or using `+' as the first character + of the list of option characters. + + PERMUTE is the default. We permute the contents of ARGV as we scan, + so that eventually all the non-options are at the end. This allows options + to be given in any order, even with programs that were not written to + expect this. + + RETURN_IN_ORDER is an option available to programs that were written + to expect options and other ARGV-elements in any order and that care about + the ordering of the two. We describe each non-option ARGV-element + as if it were the argument of an option with character code 1. + Using `-' as the first character of the list of option characters + selects this mode of operation. + + The special argument `--' forces an end of option-scanning regardless + of the value of `ordering'. In the case of RETURN_IN_ORDER, only + `--' can cause `getopt' to return -1 with `optind' != ARGC. */ + +static enum +{ + REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER +} ordering; + +/* Value of POSIXLY_CORRECT environment variable. */ +static char *posixly_correct; + +#ifdef __GNU_LIBRARY__ +/* We want to avoid inclusion of string.h with non-GNU libraries + because there are many ways it can cause trouble. + On some systems, it contains special magic macros that don't work + in GCC. */ +# include +# define my_index strchr +#else + +#include + +/* Avoid depending on library functions or files + whose names are inconsistent. */ + +#ifndef getenv +extern char *getenv (); +#endif + +static char * +my_index (str, chr) + const char *str; + int chr; +{ + while (*str) + { + if (*str == chr) + return (char *) str; + str++; + } + return 0; +} + +/* If using GCC, we can safely declare strlen this way. + If not using GCC, it is ok not to declare it. */ +#ifdef __GNUC__ +/* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h. + That was relevant to code that was here before. */ +# if (!defined __STDC__ || !__STDC__) && !defined strlen +/* gcc with -traditional declares the built-in strlen to return int, + and has done so at least since version 2.4.5. -- rms. */ +extern int strlen (const char *); +# endif /* not __STDC__ */ +#endif /* __GNUC__ */ + +#endif /* not __GNU_LIBRARY__ */ + +/* Handle permutation of arguments. */ + +/* Describe the part of ARGV that contains non-options that have + been skipped. `first_nonopt' is the index in ARGV of the first of them; + `last_nonopt' is the index after the last of them. */ + +static int first_nonopt; +static int last_nonopt; + +#ifdef _LIBC +/* Bash 2.0 gives us an environment variable containing flags + indicating ARGV elements that should not be considered arguments. */ + +/* Defined in getopt_init.c */ +extern char *__getopt_nonoption_flags; + +static int nonoption_flags_max_len; +static int nonoption_flags_len; + +static int original_argc; +static char *const *original_argv; + +/* Make sure the environment variable bash 2.0 puts in the environment + is valid for the getopt call we must make sure that the ARGV passed + to getopt is that one passed to the process. */ +static void +__attribute__ ((unused)) +store_args_and_env (int argc, char *const *argv) +{ + /* XXX This is no good solution. We should rather copy the args so + that we can compare them later. But we must not use malloc(3). */ + original_argc = argc; + original_argv = argv; +} +# ifdef text_set_element +text_set_element (__libc_subinit, store_args_and_env); +# endif /* text_set_element */ + +# define SWAP_FLAGS(ch1, ch2) \ + if (nonoption_flags_len > 0) \ + { \ + char __tmp = __getopt_nonoption_flags[ch1]; \ + __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2]; \ + __getopt_nonoption_flags[ch2] = __tmp; \ + } +#else /* !_LIBC */ +# define SWAP_FLAGS(ch1, ch2) +#endif /* _LIBC */ + +/* Exchange two adjacent subsequences of ARGV. + One subsequence is elements [first_nonopt,last_nonopt) + which contains all the non-options that have been skipped so far. + The other is elements [last_nonopt,optind), which contains all + the options processed since those non-options were skipped. + + `first_nonopt' and `last_nonopt' are relocated so that they describe + the new indices of the non-options in ARGV after they are moved. */ + +#if defined __STDC__ && __STDC__ +static void exchange (char **); +#endif + +static void +exchange (argv) + char **argv; +{ + int bottom = first_nonopt; + int middle = last_nonopt; + int top = optind; + char *tem; + + /* Exchange the shorter segment with the far end of the longer segment. + That puts the shorter segment into the right place. + It leaves the longer segment in the right place overall, + but it consists of two parts that need to be swapped next. */ + +#ifdef _LIBC + /* First make sure the handling of the `__getopt_nonoption_flags' + string can work normally. Our top argument must be in the range + of the string. */ + if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len) + { + /* We must extend the array. The user plays games with us and + presents new arguments. */ + char *new_str = malloc (top + 1); + if (new_str == NULL) + nonoption_flags_len = nonoption_flags_max_len = 0; + else + { + memset (__mempcpy (new_str, __getopt_nonoption_flags, + nonoption_flags_max_len), + '\0', top + 1 - nonoption_flags_max_len); + nonoption_flags_max_len = top + 1; + __getopt_nonoption_flags = new_str; + } + } +#endif + + while (top > middle && middle > bottom) + { + if (top - middle > middle - bottom) + { + /* Bottom segment is the short one. */ + int len = middle - bottom; + register int i; + + /* Swap it with the top part of the top segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[top - (middle - bottom) + i]; + argv[top - (middle - bottom) + i] = tem; + SWAP_FLAGS (bottom + i, top - (middle - bottom) + i); + } + /* Exclude the moved bottom segment from further swapping. */ + top -= len; + } + else + { + /* Top segment is the short one. */ + int len = top - middle; + register int i; + + /* Swap it with the bottom part of the bottom segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[middle + i]; + argv[middle + i] = tem; + SWAP_FLAGS (bottom + i, middle + i); + } + /* Exclude the moved top segment from further swapping. */ + bottom += len; + } + } + + /* Update records for the slots the non-options now occupy. */ + + first_nonopt += (optind - last_nonopt); + last_nonopt = optind; +} + +/* Initialize the internal data when the first call is made. */ + +#if defined __STDC__ && __STDC__ +static const char *_getopt_initialize (int, char *const *, const char *); +#endif +static const char * +_getopt_initialize (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + /* Start processing options with ARGV-element 1 (since ARGV-element 0 + is the program name); the sequence of previously skipped + non-option ARGV-elements is empty. */ + + first_nonopt = last_nonopt = optind; + + nextchar = NULL; + + posixly_correct = getenv ("POSIXLY_CORRECT"); + + /* Determine how to handle the ordering of options and nonoptions. */ + + if (optstring[0] == '-') + { + ordering = RETURN_IN_ORDER; + ++optstring; + } + else if (optstring[0] == '+') + { + ordering = REQUIRE_ORDER; + ++optstring; + } + else if (posixly_correct != NULL) + ordering = REQUIRE_ORDER; + else + ordering = PERMUTE; + +#ifdef _LIBC + if (posixly_correct == NULL + && argc == original_argc && argv == original_argv) + { + if (nonoption_flags_max_len == 0) + { + if (__getopt_nonoption_flags == NULL + || __getopt_nonoption_flags[0] == '\0') + nonoption_flags_max_len = -1; + else + { + const char *orig_str = __getopt_nonoption_flags; + int len = nonoption_flags_max_len = strlen (orig_str); + if (nonoption_flags_max_len < argc) + nonoption_flags_max_len = argc; + __getopt_nonoption_flags = + (char *) malloc (nonoption_flags_max_len); + if (__getopt_nonoption_flags == NULL) + nonoption_flags_max_len = -1; + else + memset (__mempcpy (__getopt_nonoption_flags, orig_str, len), + '\0', nonoption_flags_max_len - len); + } + } + nonoption_flags_len = nonoption_flags_max_len; + } + else + nonoption_flags_len = 0; +#endif + + return optstring; +} + +/* Scan elements of ARGV (whose length is ARGC) for option characters + given in OPTSTRING. + + If an element of ARGV starts with '-', and is not exactly "-" or "--", + then it is an option element. The characters of this element + (aside from the initial '-') are option characters. If `getopt' + is called repeatedly, it returns successively each of the option characters + from each of the option elements. + + If `getopt' finds another option character, it returns that character, + updating `optind' and `nextchar' so that the next call to `getopt' can + resume the scan with the following option character or ARGV-element. + + If there are no more option characters, `getopt' returns -1. + Then `optind' is the index in ARGV of the first ARGV-element + that is not an option. (The ARGV-elements have been permuted + so that those that are not options now come last.) + + OPTSTRING is a string containing the legitimate option characters. + If an option character is seen that is not listed in OPTSTRING, + return '?' after printing an error message. If you set `opterr' to + zero, the error message is suppressed but we still return '?'. + + If a char in OPTSTRING is followed by a colon, that means it wants an arg, + so the following text in the same ARGV-element, or the text of the following + ARGV-element, is returned in `optarg'. Two colons mean an option that + wants an optional arg; if there is text in the current ARGV-element, + it is returned in `optarg', otherwise `optarg' is set to zero. + + If OPTSTRING starts with `-' or `+', it requests different methods of + handling the non-option ARGV-elements. + See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above. + + Long-named options begin with `--' instead of `-'. + Their names may be abbreviated as long as the abbreviation is unique + or is an exact match for some defined option. If they have an + argument, it follows the option name in the same ARGV-element, separated + from the option name by a `=', or else the in next ARGV-element. + When `getopt' finds a long-named option, it returns 0 if that option's + `flag' field is nonzero, the value of the option's `val' field + if the `flag' field is zero. + + The elements of ARGV aren't really const, because we permute them. + But we pretend they're const in the prototype to be compatible + with other systems. + + LONGOPTS is a vector of `struct option' terminated by an + element containing a name which is zero. + + LONGIND returns the index in LONGOPT of the long-named option found. + It is only valid when a long-named option has been found by the most + recent call. + + If LONG_ONLY is nonzero, '-' as well as '--' can introduce + long-named options. */ + +int +_getopt_internal (argc, argv, optstring, longopts, longind, long_only) + int argc; + char *const *argv; + const char *optstring; + const struct option *longopts; + int *longind; + int long_only; +{ + optarg = NULL; + + if (optind == 0 || !__getopt_initialized) + { + if (optind == 0) + optind = 1; /* Don't scan ARGV[0], the program name. */ + optstring = _getopt_initialize (argc, argv, optstring); + __getopt_initialized = 1; + } + + /* Test whether ARGV[optind] points to a non-option argument. + Either it does not have option syntax, or there is an environment flag + from the shell indicating it is not an option. The later information + is only used when the used in the GNU libc. */ +#ifdef _LIBC +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0' \ + || (optind < nonoption_flags_len \ + && __getopt_nonoption_flags[optind] == '1')) +#else +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0') +#endif + + if (nextchar == NULL || *nextchar == '\0') + { + /* Advance to the next ARGV-element. */ + + /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been + moved back by the user (who may also have changed the arguments). */ + if (last_nonopt > optind) + last_nonopt = optind; + if (first_nonopt > optind) + first_nonopt = optind; + + if (ordering == PERMUTE) + { + /* If we have just processed some options following some non-options, + exchange them so that the options come first. */ + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (last_nonopt != optind) + first_nonopt = optind; + + /* Skip any additional non-options + and extend the range of non-options previously skipped. */ + + while (optind < argc && NONOPTION_P) + optind++; + last_nonopt = optind; + } + + /* The special ARGV-element `--' means premature end of options. + Skip it like a null option, + then exchange with previous non-options as if it were an option, + then skip everything else like a non-option. */ + + if (optind != argc && !strcmp (argv[optind], "--")) + { + optind++; + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (first_nonopt == last_nonopt) + first_nonopt = optind; + last_nonopt = argc; + + optind = argc; + } + + /* If we have done all the ARGV-elements, stop the scan + and back over any non-options that we skipped and permuted. */ + + if (optind == argc) + { + /* Set the next-arg-index to point at the non-options + that we previously skipped, so the caller will digest them. */ + if (first_nonopt != last_nonopt) + optind = first_nonopt; + return -1; + } + + /* If we have come to a non-option and did not permute it, + either stop the scan or describe it to the caller and pass it by. */ + + if (NONOPTION_P) + { + if (ordering == REQUIRE_ORDER) + return -1; + optarg = argv[optind++]; + return 1; + } + + /* We have found another option-ARGV-element. + Skip the initial punctuation. */ + + nextchar = (argv[optind] + 1 + + (longopts != NULL && argv[optind][1] == '-')); + } + + /* Decode the current option-ARGV-element. */ + + /* Check whether the ARGV-element is a long option. + + If long_only and the ARGV-element has the form "-f", where f is + a valid short option, don't consider it an abbreviated form of + a long option that starts with f. Otherwise there would be no + way to give the -f short option. + + On the other hand, if there's a long option "fubar" and + the ARGV-element is "-fu", do consider that an abbreviation of + the long option, just like "--fu", and not "-f" with arg "u". + + This distinction seems to be the most useful approach. */ + + if (longopts != NULL + && (argv[optind][1] == '-' + || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1]))))) + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = -1; + int option_index; + + for (nameend = nextchar; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) + == (unsigned int) strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else + /* Second or later nonexact match found. */ + ambig = 1; + } + + if (ambig && !exact) + { + if (opterr) + fprintf (stderr, _("%s: option `%s' is ambiguous\n"), + argv[0], argv[optind]); + nextchar += strlen (nextchar); + optind++; + optopt = 0; + return '?'; + } + + if (pfound != NULL) + { + option_index = indfound; + optind++; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (opterr) + { + if (argv[optind - 1][1] == '-') + /* --option */ + fprintf (stderr, + _("%s: option `--%s' doesn't allow an argument\n"), + argv[0], pfound->name); + else + /* +option or -option */ + fprintf (stderr, + _("%s: option `%c%s' doesn't allow an argument\n"), + argv[0], argv[optind - 1][0], pfound->name); + } + + nextchar += strlen (nextchar); + + optopt = pfound->val; + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (opterr) + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + nextchar += strlen (nextchar); + optopt = pfound->val; + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + + /* Can't find it as a long option. If this is not getopt_long_only, + or the option starts with '--' or is not a valid short + option, then it's an error. + Otherwise interpret it as a short option. */ + if (!long_only || argv[optind][1] == '-' + || my_index (optstring, *nextchar) == NULL) + { + if (opterr) + { + if (argv[optind][1] == '-') + /* --option */ + fprintf (stderr, _("%s: unrecognized option `--%s'\n"), + argv[0], nextchar); + else + /* +option or -option */ + fprintf (stderr, _("%s: unrecognized option `%c%s'\n"), + argv[0], argv[optind][0], nextchar); + } + nextchar = (char *) ""; + optind++; + optopt = 0; + return '?'; + } + } + + /* Look at and handle the next short option-character. */ + + { + char c = *nextchar++; + char *temp = my_index (optstring, c); + + /* Increment `optind' when we start to process its last character. */ + if (*nextchar == '\0') + ++optind; + + if (temp == NULL || c == ':') + { + if (opterr) + { + if (posixly_correct) + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, _("%s: illegal option -- %c\n"), + argv[0], c); + else + fprintf (stderr, _("%s: invalid option -- %c\n"), + argv[0], c); + } + optopt = c; + return '?'; + } + /* Convenience. Treat POSIX -W foo same as long option --foo */ + if (temp[0] == 'W' && temp[1] == ';') + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = 0; + int option_index; + + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (opterr) + { + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, _("%s: option requires an argument -- %c\n"), + argv[0], c); + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + return c; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + + /* optarg is now the argument, see if it's in the + table of longopts. */ + + for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) == strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else + /* Second or later nonexact match found. */ + ambig = 1; + } + if (ambig && !exact) + { + if (opterr) + fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"), + argv[0], argv[optind]); + nextchar += strlen (nextchar); + optind++; + return '?'; + } + if (pfound != NULL) + { + option_index = indfound; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (opterr) + fprintf (stderr, _("\ +%s: option `-W %s' doesn't allow an argument\n"), + argv[0], pfound->name); + + nextchar += strlen (nextchar); + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (opterr) + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + nextchar += strlen (nextchar); + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + nextchar = NULL; + return 'W'; /* Let the application handle it. */ + } + if (temp[1] == ':') + { + if (temp[2] == ':') + { + /* This is an option that accepts an argument optionally. */ + if (*nextchar != '\0') + { + optarg = nextchar; + optind++; + } + else + optarg = NULL; + nextchar = NULL; + } + else + { + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (opterr) + { + /* 1003.2 specifies the format of this message. */ + fprintf (stderr, + _("%s: option requires an argument -- %c\n"), + argv[0], c); + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + nextchar = NULL; + } + } + return c; + } +} + +int +getopt (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + return _getopt_internal (argc, argv, optstring, + (const struct option *) 0, + (int *) 0, + 0); +} + +#endif /* Not ELIDE_CODE. */ + +#ifdef TEST + +/* Compile with -DTEST to make an executable for use in testing + the above definition of `getopt'. */ + +int +main (argc, argv) + int argc; + char **argv; +{ + int c; + int digit_optind = 0; + + while (1) + { + int this_option_optind = optind ? optind : 1; + + c = getopt (argc, argv, "abc:d:0123456789"); + if (c == -1) + break; + + switch (c) + { + case '0': + case '1': + case '2': + case '3': + case '4': + case '5': + case '6': + case '7': + case '8': + case '9': + if (digit_optind != 0 && digit_optind != this_option_optind) + printf ("digits occur in two different argv-elements.\n"); + digit_optind = this_option_optind; + printf ("option %c\n", c); + break; + + case 'a': + printf ("option a\n"); + break; + + case 'b': + printf ("option b\n"); + break; + + case 'c': + printf ("option c with value `%s'\n", optarg); + break; + + case '?': + break; + + default: + printf ("?? getopt returned character code 0%o ??\n", c); + } + } + + if (optind < argc) + { + printf ("non-option ARGV-elements: "); + while (optind < argc) + printf ("%s ", argv[optind++]); + printf ("\n"); + } + + exit (0); +} + +#endif /* TEST */ diff --git a/libs/libtheora-1.1/win32/getopt1.c b/libs/libtheora-1.1/win32/getopt1.c new file mode 100644 index 00000000..39f8383e --- /dev/null +++ b/libs/libtheora-1.1/win32/getopt1.c @@ -0,0 +1,188 @@ +/* getopt_long and getopt_long_only entry points for GNU getopt. + Copyright (C) 1987,88,89,90,91,92,93,94,96,97,98 + Free Software Foundation, Inc. + This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with the GNU C Library; see the file COPYING.LIB. If not, + write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. */ + +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif + +#include "getopt_win.h" + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems + reject `defined (const)'. */ +#ifndef const +#define const +#endif +#endif + +#include + +/* Comment out all this code if we are using the GNU C Library, and are not + actually compiling the library itself. This code is part of the GNU C + Library, but also included in many other GNU distributions. Compiling + and linking in this code is a waste when using the GNU C library + (especially if it is a shared library). Rather than having every GNU + program understand `configure --with-gnu-libc' and omit the object files, + it is simpler to just do this in the source for each such file. */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +#include +#if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +#define ELIDE_CODE +#endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include + to get __GNU_LIBRARY__ defined. */ +#ifdef __GNU_LIBRARY__ +#include +#endif + +#ifndef NULL +#define NULL 0 +#endif + +int +getopt_long (argc, argv, options, long_options, opt_index) + int argc; + char *const *argv; + const char *options; + const struct option *long_options; + int *opt_index; +{ + return _getopt_internal (argc, argv, options, long_options, opt_index, 0); +} + +/* Like getopt_long, but '-' as well as '--' can indicate a long option. + If an option that starts with '-' (not '--') doesn't match a long option, + but does match a short option, it is parsed as a short option + instead. */ + +int +getopt_long_only (argc, argv, options, long_options, opt_index) + int argc; + char *const *argv; + const char *options; + const struct option *long_options; + int *opt_index; +{ + return _getopt_internal (argc, argv, options, long_options, opt_index, 1); +} + + +#endif /* Not ELIDE_CODE. */ + +#ifdef TEST + +#include + +int +main (argc, argv) + int argc; + char **argv; +{ + int c; + int digit_optind = 0; + + while (1) + { + int this_option_optind = optind ? optind : 1; + int option_index = 0; + static struct option long_options[] = + { + {"add", 1, 0, 0}, + {"append", 0, 0, 0}, + {"delete", 1, 0, 0}, + {"verbose", 0, 0, 0}, + {"create", 0, 0, 0}, + {"file", 1, 0, 0}, + {0, 0, 0, 0} + }; + + c = getopt_long (argc, argv, "abc:d:0123456789", + long_options, &option_index); + if (c == -1) + break; + + switch (c) + { + case 0: + printf ("option %s", long_options[option_index].name); + if (optarg) + printf (" with arg %s", optarg); + printf ("\n"); + break; + + case '0': + case '1': + case '2': + case '3': + case '4': + case '5': + case '6': + case '7': + case '8': + case '9': + if (digit_optind != 0 && digit_optind != this_option_optind) + printf ("digits occur in two different argv-elements.\n"); + digit_optind = this_option_optind; + printf ("option %c\n", c); + break; + + case 'a': + printf ("option a\n"); + break; + + case 'b': + printf ("option b\n"); + break; + + case 'c': + printf ("option c with value `%s'\n", optarg); + break; + + case 'd': + printf ("option d with value `%s'\n", optarg); + break; + + case '?': + break; + + default: + printf ("?? getopt returned character code 0%o ??\n", c); + } + } + + if (optind < argc) + { + printf ("non-option ARGV-elements: "); + while (optind < argc) + printf ("%s ", argv[optind++]); + printf ("\n"); + } + + exit (0); +} + +#endif /* TEST */ diff --git a/libs/libtheora-1.1/win32/getopt_win.h b/libs/libtheora-1.1/win32/getopt_win.h new file mode 100644 index 00000000..91eb54e5 --- /dev/null +++ b/libs/libtheora-1.1/win32/getopt_win.h @@ -0,0 +1,169 @@ +/* Declarations for getopt. + Copyright (C) 1989,90,91,92,93,94,96,97,98 Free Software Foundation, Inc. + This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with the GNU C Library; see the file COPYING.LIB. If not, + write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. */ + +#ifndef _GETOPT_H + +#ifndef __need_getopt +# define _GETOPT_H 1 +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +extern char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +extern int optind; + +/* Callers store zero here to inhibit the error message `getopt' prints + for unrecognized options. */ + +extern int opterr; + +/* Set to an option character which was unrecognized. */ + +extern int optopt; + +#ifndef __need_getopt +/* Describe the long-named options requested by the application. + The LONG_OPTIONS argument to getopt_long or getopt_long_only is a vector + of `struct option' terminated by an element containing a name which is + zero. + + The field `has_arg' is: + no_argument (or 0) if the option does not take an argument, + required_argument (or 1) if the option requires an argument, + optional_argument (or 2) if the option takes an optional argument. + + If the field `flag' is not NULL, it points to a variable that is set + to the value given in the field `val' when the option is found, but + left unchanged if the option is not found. + + To have a long-named option do something other than set an `int' to + a compiled-in constant, such as set a value from `optarg', set the + option's `flag' field to zero and its `val' field to a nonzero + value (the equivalent single-letter option character, if there is + one). For long options that have a zero `flag' field, `getopt' + returns the contents of the `val' field. */ + +struct option +{ +# if defined __STDC__ && __STDC__ + const char *name; +# else + char *name; +# endif + /* has_arg can't be an enum because some compilers complain about + type mismatches in all the code that assumes it is an int. */ + int has_arg; + int *flag; + int val; +}; + +/* Names for the values of the `has_arg' field of `struct option'. */ + +# define no_argument 0 +# define required_argument 1 +# define optional_argument 2 +#endif /* need getopt */ + + +/* Get definitions and prototypes for functions to process the + arguments in ARGV (ARGC of them, minus the program name) for + options given in OPTS. + + Return the option character from OPTS just read. Return -1 when + there are no more options. For unrecognized options, or options + missing arguments, `optopt' is set to the option letter, and '?' is + returned. + + The OPTS string is a list of characters which are recognized option + letters, optionally followed by colons, specifying that that letter + takes an argument, to be placed in `optarg'. + + If a letter in OPTS is followed by two colons, its argument is + optional. This behavior is specific to the GNU `getopt'. + + The argument `--' causes premature termination of argument + scanning, explicitly telling `getopt' that there are no more + options. + + If OPTS begins with `--', then non-option arguments are treated as + arguments to the option '\0'. This behavior is specific to the GNU + `getopt'. */ + +#if defined __STDC__ && __STDC__ +# ifdef __GNU_LIBRARY__ +/* Many other libraries have conflicting prototypes for getopt, with + differences in the consts, in stdlib.h. To avoid compilation + errors, only prototype getopt for the GNU C library. */ +extern int getopt (int __argc, char *const *__argv, const char *__shortopts); +# else /* not __GNU_LIBRARY__ */ +extern int getopt (); +# endif /* __GNU_LIBRARY__ */ + +# ifndef __need_getopt +extern int getopt_long (int __argc, char *const *__argv, const char *__shortopts, + const struct option *__longopts, int *__longind); +extern int getopt_long_only (int __argc, char *const *__argv, + const char *__shortopts, + const struct option *__longopts, int *__longind); + +/* Internal only. Users should not call this directly. */ +extern int _getopt_internal (int __argc, char *const *__argv, + const char *__shortopts, + const struct option *__longopts, int *__longind, + int __long_only); +# endif +#else /* not __STDC__ */ +extern int getopt (); +# ifndef __need_getopt +extern int getopt_long (); +extern int getopt_long_only (); + +extern int _getopt_internal (); +# endif +#endif /* __STDC__ */ + +#ifdef __cplusplus +} +#endif + +/* Make sure we later can get all the definitions and declarations. */ +#undef __need_getopt + +#endif /* getopt.h */ diff --git a/libs/libtheora-1.1/win32/theora_static.dsp b/libs/libtheora-1.1/win32/theora_static.dsp new file mode 100644 index 00000000..f794e108 --- /dev/null +++ b/libs/libtheora-1.1/win32/theora_static.dsp @@ -0,0 +1,336 @@ +# Microsoft Developer Studio Project File - Name="theora_static" - Package Owner=<4> +# Microsoft Developer Studio Generated Build File, Format Version 6.00 +# ** DO NOT EDIT ** + +# TARGTYPE "Win32 (x86) Static Library" 0x0104 + +CFG=theora_static - Win32 Debug +!MESSAGE This is not a valid makefile. To build this project using NMAKE, +!MESSAGE use the Export Makefile command and run +!MESSAGE +!MESSAGE NMAKE /f "theora_static.mak". +!MESSAGE +!MESSAGE You can specify a configuration when running NMAKE +!MESSAGE by defining the macro CFG on the command line. For example: +!MESSAGE +!MESSAGE NMAKE /f "theora_static.mak" CFG="theora_static - Win32 Debug" +!MESSAGE +!MESSAGE Possible choices for configuration are: +!MESSAGE +!MESSAGE "theora_static - Win32 Release" (based on "Win32 (x86) Static Library") +!MESSAGE "theora_static - Win32 Debug" (based on "Win32 (x86) Static Library") +!MESSAGE + +# Begin Project +# PROP AllowPerConfigDependencies 0 +# PROP Scc_ProjName "" +# PROP Scc_LocalPath "" +CPP=cl.exe +RSC=rc.exe + +!IF "$(CFG)" == "theora_static - Win32 Release" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 0 +# PROP BASE Output_Dir "Release" +# PROP BASE Intermediate_Dir "Release" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 0 +# PROP Output_Dir "Static_Release" +# PROP Intermediate_Dir "Static_Release" +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_MBCS" /D "_LIB" /YX /FD /c +# ADD CPP /nologo /MT /W3 /GX /O2 /I "..\..\ogg\include" /I "..\..\theora\include" /D "NDEBUG" /D "WIN32" /D "_MBCS" /D "_LIB" /YX /FD /c +# ADD BASE RSC /l 0x409 /d "NDEBUG" +# ADD RSC /l 0x409 /d "NDEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LIB32=link.exe -lib +# ADD BASE LIB32 /nologo +# ADD LIB32 /nologo + +!ELSEIF "$(CFG)" == "theora_static - Win32 Debug" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 1 +# PROP BASE Output_Dir "Debug" +# PROP BASE Intermediate_Dir "Debug" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 1 +# PROP Output_Dir "Static_Debug" +# PROP Intermediate_Dir "Static_Debug" +# PROP Target_Dir "" +# ADD BASE CPP /nologo /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_MBCS" /D "_LIB" /YX /FD /GZ /c +# ADD CPP /nologo /W3 /Gm /GX /ZI /Od /I "..\..\ogg\include" /I "..\..\theora\include" /D "_DEBUG" /D "WIN32" /D "_MBCS" /D "_LIB" /YX /FD /GZ /c +# ADD BASE RSC /l 0x409 /d "_DEBUG" +# ADD RSC /l 0x409 /d "_DEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LIB32=link.exe -lib +# ADD BASE LIB32 /nologo +# ADD LIB32 /nologo /out:"Static_Debug\theora_static_d.lib" + +!ENDIF + +# Begin Target + +# Name "theora_static - Win32 Release" +# Name "theora_static - Win32 Debug" +# Begin Group "Source Files" + +# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" +# Begin Source File + +SOURCE=..\lib\enc\dct.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\dct_decode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\dct_encode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\dct_encode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encapiwrapper.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_huffman.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_idct.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_toplevel.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_quant.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\frarray.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\frinit.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\mathops.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\mcenc.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\mode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\reconstruct.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\x86_32_vs\dsp_mmx.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\x86_32_vs\fdct_mmx.c +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\x86_32_vs\recon_mmx.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\apiwrapper.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\bitpack.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\decapiwrapper.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\decinfo.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\decode.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\dequant.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\fragment.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\huffdec.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\idct.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\info.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\internal.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\quant.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\state.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\x86_vc\mmxfrag.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\x86_vc\mmxidct.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\x86_vc\mmxloopfilter.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\x86_vc\mmxstate.c +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\x86_vc\x86stat.c +# End Source File +# End Group +# Begin Group "Header Files" + +# PROP Default_Filter "h;hpp;hxx;hm;inl" +# Begin Source File + +SOURCE=..\lib\dec\apiwrapper.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\block_inline.h +# End Source File +# Begin Source File + +SOURCE=..\include\theora\codec.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\codec_internal.h +# End Source File +# Begin Source File + +SOURCE=..\lib\cpu.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\dct.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\decint.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\dequant.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\dsp.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_huffman.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\encoder_lookup.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\enquant.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\huffdec.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\huffman.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\hufftables.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\idct.h +# End Source File +# Begin Source File + +SOURCE=..\lib\internal.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\ocintrin.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\pp.h +# End Source File +# Begin Source File + +SOURCE=..\lib\dec\quant.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\quant_lookup.h +# End Source File +# Begin Source File + +SOURCE=..\include\theora\theora.h +# End Source File +# Begin Source File + +SOURCE=..\include\theora\theoradec.h +# End Source File +# Begin Source File + +SOURCE=..\lib\enc\toplevel_lookup.h +# End Source File +# End Group +# End Target +# End Project diff --git a/libs/libtheora-1.1/win32/xmingw32/Makefile b/libs/libtheora-1.1/win32/xmingw32/Makefile new file mode 100644 index 00000000..cf016d4a --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/Makefile @@ -0,0 +1,393 @@ +# NOTE: This Makefile requires GNU make +# Location to put the targets. +TARGETBINDIR = . +TARGETLIBDIR = . +# DLL version information. Currently this must be updated manually. +# Fields are: major, minor, build number, QFE version +VERSION_FIELD = 1,0,0,0 +VERSION_STRING = \\\"1.0\\\" +# Name of the targets +# Hooray for Windows DLL hell. +LIBTHEORAENC_TARGET = libtheoraenc.dll +LIBTHEORAENCD_TARGET = libtheoraencd.dll +LIBTHEORAENC70_TARGET = libtheoraenc70.dll +LIBTHEORAENC70D_TARGET = libtheoraenc70d.dll +LIBTHEORAENC71_TARGET = libtheoraenc71.dll +LIBTHEORAENC71D_TARGET = libtheoraenc71d.dll +LIBTHEORAENC80_TARGET = libtheoraenc80.dll +LIBTHEORAENC80D_TARGET = libtheoraenc80d.dll + +LIBTHEORADEC_TARGET = libtheoradec.dll +LIBTHEORADECD_TARGET = libtheoradecd.dll +LIBTHEORADEC70_TARGET = libtheoradec70.dll +LIBTHEORADEC70D_TARGET = libtheoradec70d.dll +LIBTHEORADEC71_TARGET = libtheoradec71.dll +LIBTHEORADEC71D_TARGET = libtheoradec71d.dll +LIBTHEORADEC80_TARGET = libtheoradec80.dll +LIBTHEORADEC80D_TARGET = libtheoradec80d.dll + +DUMP_VIDEO_TARGET = dump_video.exe +PLAYER_EXAMPLE_TARGET = player_example.exe +ENCODER_EXAMPLE_TARGET = encoder_example.exe + +# The compiler tools to use +# The is no standard mingw prefix, so try to guess +MINGW_PREFIX := $(or $(strip $(foreach exeprefix, \ + i686-mingw32 i686-pc-mingw32 i586-mingw32msvc i386-mingw32 \ + no-mingw32, \ + $(if $(shell which $(exeprefix)-gcc 2>/dev/null), $(exeprefix) )))) +CC = $(MINGW_PREFIX)-gcc +RC = $(MINGW_PREFIX)-windres +DLLTOOL = $(MINGW_PREFIX)-dlltool +LD = $(MINGW_PREFIX)-ld +SDLCONFIG = $(MINGW_PREFIX)-sdl-config +# The command to use to generate dependency information +MAKEDEPEND = ${CC} -MM +#MAKEDEPEND = makedepend -f- -Y -- + +# The location of include files. +# Modify these to point to your Ogg and Vorbis include directories if they are +# not installed in a standard location. +CINCLUDE = -D_REENTRANT +# Extra compilation flags. +# You may get speed increases by including flags such as -O2 or -O3 or +# -ffast-math, or additional flags, depending on your system and compiler. +# The correct -march= flag will also generate much better code +# on newer architectures. +CFLAGS = -Wall -Wno-parentheses -DOC_X86_ASM +RELEASE_CFLAGS = ${CFLAGS} -mtune=native -O3 -fomit-frame-pointer -fforce-addr \ + -finline-functions +# The -g flag will generally include debugging information. +DEBUG_CFLAGS = ${CFLAGS} -g +# Libraries to link with, and the location of library files. +LIBS = -logg -lvorbis -lvorbisenc + +# ANYTHING BELOW THIS LINE PROBABLY DOES NOT NEED EDITING +CINCLUDE := -I../../include ${CINCLUDE} +LIBSRCDIR = ../../lib +BINSRCDIR = ../../examples +WORKDIR = objs + +# C source file lists + +LIBTHEORADEC_CSOURCES = \ +apiwrapper.c \ +bitpack.c \ +decapiwrapper.c \ +decinfo.c \ +decode.c \ +dequant.c \ +fragment.c \ +huffdec.c \ +idct.c \ +info.c \ +internal.c \ +quant.c \ +state.c \ +$(if $(findstring -DOC_X86_ASM,${CFLAGS}), \ +x86/mmxidct.c \ +x86/mmxfrag.c \ +x86/mmxstate.c \ +x86/x86state.c \ +) + +LIBTHEORAENC_CSOURCES = \ +apiwrapper.c \ +fragment.c \ +idct.c \ +internal.c \ +state.c \ +quant.c \ +analyze.c \ +fdct.c \ +encfrag.c \ +encapiwrapper.c \ +encinfo.c \ +encode.c \ +enquant.c \ +huffenc.c \ +mathops.c \ +mcenc.c \ +rate.c \ +tokenize.c \ +$(if $(findstring -DOC_X86_ASM,${CFLAGS}), \ +x86/mmxfrag.c \ +x86/mmxidct.c \ +x86/mmxstate.c \ +x86/x86state.c \ +x86/mmxencfrag.c \ +x86/mmxfdct.c \ +x86/x86enc.c \ +) + + +DUMP_VIDEO_CSOURCES = dump_video.c +ENCODER_EXAMPLE_CSOURCES = encoder_example.c +PLAYER_EXAMPLE_CSOURCES = player_example.c + +# Create object file list. +LIBTHEORADEC_OBJS:= ${LIBTHEORADEC_CSOURCES:%.c=${WORKDIR}/%.o} +LIBTHEORADECD_OBJS:= ${LIBTHEORADEC_CSOURCES:%.c=${WORKDIR}/%.do} +LIBTHEORAENC_OBJS:= ${LIBTHEORAENC_CSOURCES:%.c=${WORKDIR}/%.o} +LIBTHEORAENCD_OBJS:= ${LIBTHEORAENC_CSOURCES:%.c=${WORKDIR}/%.do} +DUMP_VIDEO_OBJS:= ${DUMP_VIDEO_CSOURCES:%.c=${WORKDIR}/%.o} +ENCODER_EXAMPLE_OBJS:= ${ENCODER_EXAMPLE_CSOURCES:%.c=${WORKDIR}/%.o} +PLAYER_EXAMPLE_OBJS:= ${PLAYER_EXAMPLE_CSOURCES:%.c=${WORKDIR}/%.o} +RC_OBJS:= ${LIBTHEORADEC_TARGET} ${LIBTHEORAENC_TARGET} \ + ${LIBTHEORADECD_TARGET} ${LIBTHEORAENCD_TARGET} \ + ${LIBTHEORADEC70_TARGET} ${LIBTHEORAENC70_TARGET} \ + ${LIBTHEORADEC70D_TARGET} ${LIBTHEORAENC70D_TARGET} \ + ${LIBTHEORADEC71_TARGET} ${LIBTHEORAENC71_TARGET} \ + ${LIBTHEORADEC71D_TARGET} ${LIBTHEORAENC71D_TARGET} \ + ${LIBTHEORADEC80_TARGET} ${LIBTHEORAENC80_TARGET} \ + ${LIBTHEORADEC80D_TARGET} ${LIBTHEORAENC80D_TARGET} +RC_OBJS:= ${RC_OBJS:%.dll=${WORKDIR}/%.rco} +ALL_OBJS:= ${LIBTHEORADEC_OBJS} ${LIBTHEORAENC_OBJS} \ + ${LIBTHEORADECD_OBJS} ${LIBTHEORAENCD_OBJS} ${RC_OBJS} \ + ${DUMP_VIDEO_OBJS} ${ENCODER_EXAMPLE_OBJS} #${PLAYER_EXAMPLE_OBJS} +# Create the dependency file list +ALL_DEPS:= ${ALL_OBJS:%.o=%.d} +ALL_DEPS:= ${ALL_DEPS:%.do=%.dd} +ALL_DEPS:= ${ALL_DEPS:%.rco=%.d} +# Prepend source path to file names. +LIBTHEORADEC_CSOURCES:= ${LIBTHEORADEC_CSOURCES:%=${LIBSRCDIR}/%} +LIBTHEORAENC_CSOURCES:= ${LIBTHEORAENC_CSOURCES:%=${LIBSRCDIR}/%} +DUMP_VIDEO_CSOURCES:= ${DUMP_VIDEO_CSOURCES:%=${BINSRCDIR}/%} +ENCODER_EXAMPLE_CSOURCES:= ${ENCODER_EXAMPLE_CSOURCES:%=${BINSRCDIR}/%} +PLAYER_EXAMPLE_CSOURCES:= ${PLAYER_EXAMPLE_CSOURCES:%=${BINSRCDIR}/%} +ALL_CSOURCES:= ${LIBTHEORADEC_CSOURCES} ${LIBTHEORAENC_CSOURCES} \ + ${DUMP_VIDEO_CSOURCES} ${PLAYER_EXAMPLE_CSOURCES} \ + ${ENCODER_EXAMPLE_CSOURCES} +LIBTHEORAENC_RCO:= ${WORKDIR}/${LIBTHEORAENC_TARGET:%.dll=%.rco} +LIBTHEORAENCD_RCO:= ${WORKDIR}/${LIBTHEORAENCD_TARGET:%.dll=%.rco} +LIBTHEORAENC70_RCO:= ${WORKDIR}/${LIBTHEORAENC70_TARGET:%.dll=%.rco} +LIBTHEORAENC70D_RCO:= ${WORKDIR}/${LIBTHEORAENC70D_TARGET:%.dll=%.rco} +LIBTHEORAENC71_RCO:= ${WORKDIR}/${LIBTHEORAENC71_TARGET:%.dll=%.rco} +LIBTHEORAENC71D_RCO:= ${WORKDIR}/${LIBTHEORAENC71D_TARGET:%.dll=%.rco} +LIBTHEORAENC80_RCO:= ${WORKDIR}/${LIBTHEORAENC80_TARGET:%.dll=%.rco} +LIBTHEORAENC80D_RCO:= ${WORKDIR}/${LIBTHEORAENC80D_TARGET:%.dll=%.rco} +LIBTHEORADEC_RCO:= ${WORKDIR}/${LIBTHEORADEC_TARGET:%.dll=%.rco} +LIBTHEORADECD_RCO:= ${WORKDIR}/${LIBTHEORADECD_TARGET:%.dll=%.rco} +LIBTHEORADEC70_RCO:= ${WORKDIR}/${LIBTHEORADEC70_TARGET:%.dll=%.rco} +LIBTHEORADEC70D_RCO:= ${WORKDIR}/${LIBTHEORADEC70D_TARGET:%.dll=%.rco} +LIBTHEORADEC71_RCO:= ${WORKDIR}/${LIBTHEORADEC71_TARGET:%.dll=%.rco} +LIBTHEORADEC71D_RCO:= ${WORKDIR}/${LIBTHEORADEC71D_TARGET:%.dll=%.rco} +LIBTHEORADEC80_RCO:= ${WORKDIR}/${LIBTHEORADEC80_TARGET:%.dll=%.rco} +LIBTHEORADEC80D_RCO:= ${WORKDIR}/${LIBTHEORADEC80D_TARGET:%.dll=%.rco} +# Prepand target path to file names. +LIBTHEORAENC_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC_TARGET} +LIBTHEORAENCD_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENCD_TARGET} +LIBTHEORAENC70_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC70_TARGET} +LIBTHEORAENC70D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC70D_TARGET} +LIBTHEORAENC71_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC71_TARGET} +LIBTHEORAENC71D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC71D_TARGET} +LIBTHEORAENC80_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC80_TARGET} +LIBTHEORAENC80D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORAENC80D_TARGET} +LIBTHEORADEC_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC_TARGET} +LIBTHEORADECD_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADECD_TARGET} +LIBTHEORADEC70_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC70_TARGET} +LIBTHEORADEC70D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC70D_TARGET} +LIBTHEORADEC71_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC71_TARGET} +LIBTHEORADEC71D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC71D_TARGET} +LIBTHEORADEC80_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC80_TARGET} +LIBTHEORADEC80D_TARGET:= ${TARGETLIBDIR}/${LIBTHEORADEC80D_TARGET} +DUMP_VIDEO_TARGET:= ${TARGETBINDIR}/${DUMP_VIDEO_TARGET} +ENCODER_EXAMPLE_TARGET:= ${TARGETBINDIR}/${ENCODER_EXAMPLE_TARGET} +PLAYER_EXAMPLE_TARGET:= ${TARGETBINDIR}/${PLAYER_EXAMPLE_TARGET} +DLL_TARGETS:= ${LIBTHEORADEC_TARGET} ${LIBTHEORAENC_TARGET} \ + ${LIBTHEORADECD_TARGET} ${LIBTHEORAENCD_TARGET} \ + ${LIBTHEORADEC70_TARGET} ${LIBTHEORAENC70_TARGET} \ + ${LIBTHEORADEC70D_TARGET} ${LIBTHEORAENC70D_TARGET} \ + ${LIBTHEORADEC71_TARGET} ${LIBTHEORAENC71_TARGET} \ + ${LIBTHEORADEC71D_TARGET} ${LIBTHEORAENC71D_TARGET} \ + ${LIBTHEORADEC80_TARGET} ${LIBTHEORAENC80_TARGET} \ + ${LIBTHEORADEC80D_TARGET} ${LIBTHEORAENC80D_TARGET} +ALL_TARGETS:= ${DLL_TARGETS} ${DLL_TARGETS:%.dll=%.dll.a} \ + ${DUMP_VIDEO_TARGET} ${ENCODER_EXAMPLE_TARGET} #${PLAYER_EXAMPLE_TARGET} +IMPLIB_TARGETS:= ${DLL_TARGETS:%.dll=%.def} ${DLL_TARGETS:%.dll=%.lib} \ + ${DLL_TARGETS:%.dll=%.exp} + +# Targets: +# Everything (default) +all: ${ALL_TARGETS} + +# These require Microsoft's lib.exe to build, and so are not made by default. +implibs: ${IMPLIB_TARGETS} + +# libtheoradec +${LIBTHEORADEC_TARGET}: ${LIBTHEORADEC_OBJS} ${LIBTHEORADEC_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADEC_OBJS} -logg -lmsvcrt \ + ${LIBTHEORADEC_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADECD_TARGET}: ${LIBTHEORADECD_OBJS} ${LIBTHEORADECD_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADECD_OBJS} -logg -lmsvcrtd \ + ${LIBTHEORADECD_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC70_TARGET}: ${LIBTHEORADEC_OBJS} ${LIBTHEORADEC70_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADEC_OBJS} -logg -lmsvcr70 \ + ${LIBTHEORADEC70_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC70D_TARGET}: ${LIBTHEORADECD_OBJS} ${LIBTHEORADEC70D_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADECD_OBJS} -logg -lmsvcr70d \ + ${LIBTHEORADEC70D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC71_TARGET}: ${LIBTHEORADEC_OBJS} ${LIBTHEORADEC71_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADEC_OBJS} -logg -lmsvcr71 \ + ${LIBTHEORADEC71_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC71D_TARGET}: ${LIBTHEORADECD_OBJS} ${LIBTHEORADEC71D_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADECD_OBJS} -logg -lmsvcr71d \ + ${LIBTHEORADEC71D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC80_TARGET}: ${LIBTHEORADEC_OBJS} ${LIBTHEORADEC80_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADEC_OBJS} -logg -lmsvcr80 \ + ${LIBTHEORADEC80_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def +${LIBTHEORADEC80D_TARGET}: ${LIBTHEORADECD_OBJS} ${LIBTHEORADEC80D_RCO} \ + libtheoradec-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ ${LIBTHEORADECD_OBJS} -logg -lmsvcr80d \ + ${LIBTHEORADEC80D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoradec-all.def + +# libtheoraenc +${LIBTHEORAENC_TARGET}: ${LIBTHEORAENC_OBJS} ${LIBTHEORAENC_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENC_OBJS} ${LIBTHEORADEC_TARGET} -logg -lmsvcrt \ + ${LIBTHEORAENC_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENCD_TARGET}: ${LIBTHEORAENCD_OBJS} ${LIBTHEORAENCD_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENCD_OBJS} ${LIBTHEORADECD_TARGET} -logg -lmsvcrtd \ + ${LIBTHEORAENCD_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC70_TARGET}: ${LIBTHEORAENC_OBJS} ${LIBTHEORAENC70_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENC_OBJS} ${LIBTHEORADEC70_TARGET} -logg -lmsvcr70 \ + ${LIBTHEORAENC70_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC70D_TARGET}: ${LIBTHEORAENCD_OBJS} ${LIBTHEORAENC70D_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENCD_OBJS} ${LIBTHEORADEC70D_TARGET} -logg -lmsvcr70d \ + ${LIBTHEORAENC70D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC71_TARGET}: ${LIBTHEORAENC_OBJS} ${LIBTHEORAENC71_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENC_OBJS} ${LIBTHEORADEC71_TARGET} -logg -lmsvcr71 \ + ${LIBTHEORAENC71_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC71D_TARGET}: ${LIBTHEORAENCD_OBJS} ${LIBTHEORAENC71D_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENCD_OBJS} ${LIBTHEORADEC71D_TARGET} -logg -lmsvcr71d \ + ${LIBTHEORAENC71D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC80_TARGET}: ${LIBTHEORAENC_OBJS} ${LIBTHEORAENC80_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENC_OBJS} ${LIBTHEORADEC80_TARGET} -logg -lmsvcr80 \ + ${LIBTHEORAENC80_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def +${LIBTHEORAENC80D_TARGET}: ${LIBTHEORAENCD_OBJS} ${LIBTHEORAENC80D_RCO} \ + libtheoraenc-all.def + mkdir -p ${TARGETLIBDIR} + ${CC} -shared -o $@ \ + ${LIBTHEORAENCD_OBJS} ${LIBTHEORADEC80D_TARGET} -logg -lmsvcr80d \ + ${LIBTHEORAENC80D_RCO} \ + -Wl,--output-def,${@:.dll=.def},--out-implib,$@.a,libtheoraenc-all.def + +# dump_video +${DUMP_VIDEO_TARGET}: ${DUMP_VIDEO_OBJS} ${LIBTHEORADEC_TARGET} + mkdir -p ${TARGETBINDIR} + ${CC} ${CFLAGS} -o $@ ${DUMP_VIDEO_OBJS} ${LIBS} \ + ${LIBTHEORADEC_TARGET}.a + +# encoder_example +${ENCODER_EXAMPLE_TARGET}: ${ENCODER_EXAMPLE_OBJS} ${LIBTHEORADEC_TARGET} \ + ${LIBTHEORAENC_TARGET} + mkdir -p ${TARGETBINDIR} + ${CC} ${CFLAGS} -o $@ ${ENCODER_EXAMPLE_OBJS} ${LIBS} \ + ${LIBTHEORAENC_TARGET}.a ${LIBTHEORADEC_TARGET}.a + +# player_example +${PLAYER_EXAMPLE_TARGET}: CINCLUDE += $(SDLCONFIG) --cflags +${PLAYER_EXAMPLE_TARGET}: ${PLAYER_EXAMPLE_OBJS} ${LIBTHEORADEC_TARGET} + mkdir -p ${TARGETBINDIR} + ${CC} ${CFLAGS} -o $@ ${PLAYER_EXAMPLE_OBJS} ${LIBS} \ + ${LIBTHEORADEC_TARGET}.a `${SDLCONFIG} --libs` + +# Remove all targets. +clean: + -rm $(sort ${ALL_OBJS} ${ALL_DEPS} ${ALL_TARGETS} ${IMPLIB_TARGETS}) + -rmdir ${WORKDIR}/x86 + -rmdir ${WORKDIR} + +# Make everything depend on changes in the Makefile +${ALL_OBJS} ${ALL_DEPS} ${ALL_TARGETS} : Makefile + +# Specify which targets are phony for GNU make +.PHONY : all clean + +# Rules +# Windows-specific rules +%.dll.a : %.dll +%.def : %.dll +%.exp : %.lib +%.lib : %.def + wine lib /machine:i386 /def:$< +${WORKDIR}/%.d : %.rc + mkdir -p ${dir $@} + ${MAKEDEPEND} -x c-header ${CINCLUDE} $< -MT ${@:%.d=%.rco} > $@ +${WORKDIR}/%.rco : %.rc + mkdir -p ${dir $@} + ${RC} ${CINCLUDE} -DTH_VERSION_FIELD=${VERSION_FIELD} \ + -DTH_VERSION_STRING=${VERSION_STRING} $< $@ +# Normal compilation +${WORKDIR}/%.d : ${LIBSRCDIR}/%.c + mkdir -p ${dir $@} + ${MAKEDEPEND} ${CINCLUDE} ${RELEASE_CFLAGS} $< -MT ${@:%.d=%.o} > $@ +${WORKDIR}/%.d : ${BINSRCDIR}/%.c + mkdir -p ${dir $@} + ${MAKEDEPEND} ${CINCLUDE} ${RELEASE_CFLAGS} $< -MT ${@:%.d=%.o} > $@ +${WORKDIR}/%.o : ${LIBSRCDIR}/%.c + mkdir -p ${dir $@} + ${CC} ${CINCLUDE} ${RELEASE_CFLAGS} -c -o $@ $< +${WORKDIR}/%.o : ${BINSRCDIR}/%.c + mkdir -p ${dir $@} + ${CC} ${CINCLUDE} ${RELEASE_CFLAGS} -c -o $@ $< +# Debug versions +${WORKDIR}/%.dd : ${LIBSRCDIR}/%.c + mkdir -p ${dir $@} + ${MAKEDEPEND} ${CINCLUDE} ${DEBUG_CFLAGS} $< -MT ${@:%.d=%.do} > $@ +${WORKDIR}/%.do : ${LIBSRCDIR}/%.c + mkdir -p ${dir $@} + ${CC} ${CINCLUDE} ${DEBUG_CFLAGS} -c -o $@ $< + +# Include header file dependencies +-include ${ALL_DEPS} diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.def b/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.def new file mode 100644 index 00000000..566eeb30 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.def @@ -0,0 +1,58 @@ +EXPORTS +; Old alpha API + theora_version_string @ 1 + theora_version_number @ 2 + + theora_decode_header @ 3 + theora_decode_init @ 4 + theora_decode_packetin @ 5 + theora_decode_YUVout @ 6 + + theora_control @ 7 + + theora_packet_isheader @ 8 + theora_packet_iskeyframe @ 9 + + theora_granule_shift @ 10 + theora_granule_frame @ 11 + theora_granule_time @ 12 + + theora_info_init @ 13 + theora_info_clear @ 14 + + theora_clear @ 15 + + theora_comment_init @ 16 + theora_comment_add @ 17 + theora_comment_add_tag @ 18 + theora_comment_query @ 19 + theora_comment_query_count @ 20 + theora_comment_clear @ 21 + +; New theora-exp API + th_version_string @ 22 + th_version_number @ 23 + + th_decode_headerin @ 24 + th_decode_alloc @ 25 + th_setup_free @ 26 + th_decode_ctl @ 27 + th_decode_packetin @ 28 + th_decode_ycbcr_out @ 29 + th_decode_free @ 30 + + th_packet_isheader @ 31 + th_packet_iskeyframe @ 32 + + th_granule_frame @ 33 + th_granule_time @ 34 + + th_info_init @ 35 + th_info_clear @ 36 + + th_comment_init @ 37 + th_comment_add @ 38 + th_comment_add_tag @ 39 + th_comment_query @ 40 + th_comment_query_count @ 41 + th_comment_clear @ 42 diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.rc new file mode 100644 index 00000000..f6a5c60b --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec-all.rc @@ -0,0 +1,39 @@ +#include + +/*See "VERSIONINFO Resource" in MSDN, + http://msdn2.microsoft.com/en-us/library/Aa381058.aspx */ +VS_VERSION_INFO VERSIONINFO +FILEVERSION TH_VERSION_FIELD +PRODUCTVERSION TH_VERSION_FIELD +FILEFLAGSMASK VS_FFI_FILEFLAGSMASK +#if defined(_DEBUG) +FILEFLAGS VS_FF_DEBUG +#else +FILEFLAGS 0 +#endif +FILEOS VOS__WINDOWS32 +FILETYPE VFT_DLL +FILESUBTYPE 0 +BEGIN + BLOCK "StringFileInfo" + BEGIN + /*0x040904B0 == US English, Unicode*/ + BLOCK "0x040904B0" + BEGIN + VALUE "Comments","Xiph.Org " TH_DEC_INTERNAL_NAME ".dll" + VALUE "CompanyName","The Xiph.Org Foundation" + VALUE "FileDescription","Xiph.Org Theora Decoder Library" + VALUE "FileVersion",TH_VERSION_STRING + VALUE "InternalName",TH_DEC_INTERNAL_NAME + VALUE "LegalCopyright","Copyright (C) 2002-2007 Xiph.Org Foundation" + VALUE "OriginalFilename",TH_DEC_INTERNAL_NAME ".dll" + VALUE "ProductName","libtheora" + VALUE "ProductVersion",TH_VERSION_STRING + END + END + BLOCK "VarFileInfo" + BEGIN + /*0x0409, 1200 == US English, Unicode*/ + VALUE "Translation",0x0409,1200 + END +END diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec.rc new file mode 100644 index 00000000..3ed5da2a --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec" +#undef _DEBUG +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec70.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec70.rc new file mode 100644 index 00000000..ee82820c --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec70.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec70" +#undef _DEBUG +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec70d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec70d.rc new file mode 100644 index 00000000..783800d1 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec70d.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec70d" +#define _DEBUG (1) +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec71.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec71.rc new file mode 100644 index 00000000..0becd190 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec71.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec71" +#undef _DEBUG +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec71d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec71d.rc new file mode 100644 index 00000000..e1a03980 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec71d.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec71d" +#define _DEBUG (1) +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec80.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec80.rc new file mode 100644 index 00000000..932cce92 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec80.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec80" +#undef _DEBUG +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradec80d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradec80d.rc new file mode 100644 index 00000000..1ff55129 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradec80d.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradec80d" +#define _DEBUG (1) +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoradecd.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoradecd.rc new file mode 100644 index 00000000..5cfaf6e6 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoradecd.rc @@ -0,0 +1,3 @@ +#define TH_DEC_INTERNAL_NAME "libtheoradecd" +#define _DEBUG (1) +#include "libtheoradec-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.def b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.def new file mode 100644 index 00000000..36d2dadb --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.def @@ -0,0 +1,17 @@ +EXPORTS +; Old alpha API + theora_encode_init @ 1 + theora_encode_YUVin @ 2 + theora_encode_packetout @ 3 + theora_encode_header @ 4 + theora_encode_comment @ 5 + theora_encode_tables @ 6 +; New theora-exp API + th_encode_alloc @ 7 + th_encode_ctl @ 8 + th_encode_flushheader @ 9 + th_encode_ycbcr_in @ 10 + th_encode_packetout @ 11 + th_encode_free @ 12 + TH_VP31_QUANT_INFO @ 13 + TH_VP31_HUFF_CODES @ 14 diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.rc new file mode 100644 index 00000000..5c96b09e --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc-all.rc @@ -0,0 +1,39 @@ +#include + +/*See "VERSIONINFO Resource" in MSDN, + http://msdn2.microsoft.com/en-us/library/Aa381058.aspx */ +VS_VERSION_INFO VERSIONINFO +FILEVERSION TH_VERSION_FIELD +PRODUCTVERSION TH_VERSION_FIELD +FILEFLAGSMASK VS_FFI_FILEFLAGSMASK +#if defined(_DEBUG) +FILEFLAGS VS_FF_DEBUG +#else +FILEFLAGS 0 +#endif +FILEOS VOS__WINDOWS32 +FILETYPE VFT_DLL +FILESUBTYPE 0 +BEGIN + BLOCK "StringFileInfo" + BEGIN + /*0x040904B0 == US English, Unicode*/ + BLOCK "0x040904B0" + BEGIN + VALUE "Comments","Xiph.Org " TH_ENC_INTERNAL_NAME ".dll" + VALUE "CompanyName","The Xiph.Org Foundation" + VALUE "FileDescription","Xiph.Org Theora Encoder Library" + VALUE "FileVersion",TH_VERSION_STRING + VALUE "InternalName",TH_ENC_INTERNAL_NAME + VALUE "LegalCopyright","Copyright (C) 2002-2007 Xiph.Org Foundation" + VALUE "OriginalFilename",TH_ENC_INTERNAL_NAME ".dll" + VALUE "ProductName","libtheora" + VALUE "ProductVersion",TH_VERSION_STRING + END + END + BLOCK "VarFileInfo" + BEGIN + /*0x0409, 1200 == US English, Unicode*/ + VALUE "Translation",0x0409,1200 + END +END diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc.rc new file mode 100644 index 00000000..26a356dc --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc" +#undef _DEBUG +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70.rc new file mode 100644 index 00000000..12cf7c17 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc70" +#undef _DEBUG +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70d.rc new file mode 100644 index 00000000..0fdb70b0 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc70d.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc70d" +#define _DEBUG (1) +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71.rc new file mode 100644 index 00000000..86075168 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc71" +#undef _DEBUG +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71d.rc new file mode 100644 index 00000000..3ef2ef16 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc71d.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc71d" +#define _DEBUG (1) +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80.rc new file mode 100644 index 00000000..66ef776f --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc80" +#undef _DEBUG +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80d.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80d.rc new file mode 100644 index 00000000..dcca72c6 --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraenc80d.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraenc80d" +#define _DEBUG (1) +#include "libtheoraenc-all.rc" diff --git a/libs/libtheora-1.1/win32/xmingw32/libtheoraencd.rc b/libs/libtheora-1.1/win32/xmingw32/libtheoraencd.rc new file mode 100644 index 00000000..fe2a56bf --- /dev/null +++ b/libs/libtheora-1.1/win32/xmingw32/libtheoraencd.rc @@ -0,0 +1,3 @@ +#define TH_ENC_INTERNAL_NAME "libtheoraencd" +#define _DEBUG (1) +#include "libtheoraenc-all.rc"