From 685dcbf18dc64ab9e348d9899c7108b3c71ce217 Mon Sep 17 00:00:00 2001 From: "Earle F. Philhower, III" Date: Thu, 17 Aug 2017 18:22:19 -0700 Subject: [PATCH] Add FLAC support to the framework via libflac-1.3.2 Ported libFLAC v1.3.2 to the ESP8266. Moved CRC constants to PROGMEM and the error strings. Still to be done would be decreasing the output buffer to an int16_t and moving a larce number of "const int" to enums since "const int" eats 4 bytes per variable. --- README.md | 4 +- .../PlayFLACFromPROGMEMToDAC.ino | 31 + examples/PlayFLACFromPROGMEMToDAC/sample.h | 5707 +++++++++++++++++ src/AudioGeneratorFLAC.cpp | 183 + src/AudioGeneratorFLAC.h | 88 + src/libflac/AUTHORS | 58 + src/libflac/COPYING.FDL | 397 ++ src/libflac/COPYING.GPL | 339 + src/libflac/COPYING.LGPL | 504 ++ src/libflac/COPYING.Xiph | 29 + src/libflac/FLAC/all.h | 371 ++ src/libflac/FLAC/assert.h | 46 + src/libflac/FLAC/callback.h | 185 + src/libflac/FLAC/export.h | 97 + src/libflac/FLAC/format.h | 1025 +++ src/libflac/FLAC/metadata.h | 2182 +++++++ src/libflac/FLAC/ordinals.h | 86 + src/libflac/FLAC/stream_decoder.h | 1560 +++++ src/libflac/FLAC/stream_encoder.h | 1790 ++++++ src/libflac/README | 254 + src/libflac/README.ESP8266 | 3 + src/libflac/bitmath.c | 73 + src/libflac/bitreader.c | 1106 ++++ src/libflac/bitwriter.c | 881 +++ src/libflac/config.h | 242 + src/libflac/cpu.c | 294 + src/libflac/crc.c | 145 + src/libflac/fixed.c | 395 ++ src/libflac/float.c | 302 + src/libflac/format.c | 589 ++ src/libflac/lpc.c | 1357 ++++ src/libflac/md5.c | 516 ++ src/libflac/memory.c | 218 + src/libflac/private/FLAC | 1 + src/libflac/private/all.h | 50 + src/libflac/private/bitmath.h | 212 + src/libflac/private/bitreader.h | 91 + src/libflac/private/bitwriter.h | 104 + src/libflac/private/cpu.h | 186 + src/libflac/private/crc.h | 64 + src/libflac/private/fixed.h | 107 + src/libflac/private/float.h | 95 + src/libflac/private/format.h | 45 + src/libflac/private/lpc.h | 250 + src/libflac/private/macros.h | 72 + src/libflac/private/md5.h | 50 + src/libflac/private/memory.h | 58 + src/libflac/private/metadata.h | 46 + src/libflac/private/ogg_decoder_aspect.h | 80 + src/libflac/private/ogg_encoder_aspect.h | 63 + src/libflac/private/ogg_helper.h | 44 + src/libflac/private/ogg_mapping.h | 64 + src/libflac/private/share | 1 + src/libflac/private/stream_encoder.h | 67 + src/libflac/private/stream_encoder_framing.h | 46 + src/libflac/private/window.h | 74 + src/libflac/protected/FLAC | 1 + src/libflac/protected/all.h | 39 + src/libflac/protected/stream_decoder.h | 60 + src/libflac/protected/stream_encoder.h | 118 + src/libflac/share/alloc.h | 219 + src/libflac/share/compat.h | 209 + src/libflac/share/endswap.h | 84 + src/libflac/share/getopt.h | 184 + src/libflac/share/grabbag.h | 30 + src/libflac/share/grabbag/Makefile.am | 8 + src/libflac/share/grabbag/Makefile.in | 486 ++ src/libflac/share/grabbag/cuesheet.h | 43 + src/libflac/share/grabbag/file.h | 65 + src/libflac/share/grabbag/picture.h | 54 + src/libflac/share/grabbag/replaygain.h | 73 + src/libflac/share/grabbag/seektable.h | 39 + src/libflac/share/macros.h | 45 + src/libflac/share/private.h | 45 + src/libflac/share/replaygain_analysis.h | 59 + src/libflac/share/replaygain_synthesis.h | 52 + src/libflac/share/safe_str.h | 69 + src/libflac/share/utf8.h | 25 + src/libflac/share/win_utf8_io.h | 58 + src/libflac/share/windows_unicode_filenames.h | 67 + src/libflac/stream_decoder.c | 3458 ++++++++++ src/libflac/window.c | 282 + 82 files changed, 28798 insertions(+), 1 deletion(-) create mode 100644 examples/PlayFLACFromPROGMEMToDAC/PlayFLACFromPROGMEMToDAC.ino create mode 100644 examples/PlayFLACFromPROGMEMToDAC/sample.h create mode 100644 src/AudioGeneratorFLAC.cpp create mode 100644 src/AudioGeneratorFLAC.h create mode 100644 src/libflac/AUTHORS create mode 100644 src/libflac/COPYING.FDL create mode 100644 src/libflac/COPYING.GPL create mode 100644 src/libflac/COPYING.LGPL create mode 100644 src/libflac/COPYING.Xiph create mode 100644 src/libflac/FLAC/all.h create mode 100644 src/libflac/FLAC/assert.h create mode 100644 src/libflac/FLAC/callback.h create mode 100644 src/libflac/FLAC/export.h create mode 100644 src/libflac/FLAC/format.h create mode 100644 src/libflac/FLAC/metadata.h create mode 100644 src/libflac/FLAC/ordinals.h create mode 100644 src/libflac/FLAC/stream_decoder.h create mode 100644 src/libflac/FLAC/stream_encoder.h create mode 100644 src/libflac/README create mode 100644 src/libflac/README.ESP8266 create mode 100644 src/libflac/bitmath.c create mode 100644 src/libflac/bitreader.c create mode 100644 src/libflac/bitwriter.c create mode 100644 src/libflac/config.h create mode 100644 src/libflac/cpu.c create mode 100644 src/libflac/crc.c create mode 100644 src/libflac/fixed.c create mode 100644 src/libflac/float.c create mode 100644 src/libflac/format.c create mode 100644 src/libflac/lpc.c create mode 100644 src/libflac/md5.c create mode 100644 src/libflac/memory.c create mode 120000 src/libflac/private/FLAC create mode 100644 src/libflac/private/all.h create mode 100644 src/libflac/private/bitmath.h create mode 100644 src/libflac/private/bitreader.h create mode 100644 src/libflac/private/bitwriter.h create mode 100644 src/libflac/private/cpu.h create mode 100644 src/libflac/private/crc.h create mode 100644 src/libflac/private/fixed.h create mode 100644 src/libflac/private/float.h create mode 100644 src/libflac/private/format.h create mode 100644 src/libflac/private/lpc.h create mode 100644 src/libflac/private/macros.h create mode 100644 src/libflac/private/md5.h create mode 100644 src/libflac/private/memory.h create mode 100644 src/libflac/private/metadata.h create mode 100644 src/libflac/private/ogg_decoder_aspect.h create mode 100644 src/libflac/private/ogg_encoder_aspect.h create mode 100644 src/libflac/private/ogg_helper.h create mode 100644 src/libflac/private/ogg_mapping.h create mode 120000 src/libflac/private/share create mode 100644 src/libflac/private/stream_encoder.h create mode 100644 src/libflac/private/stream_encoder_framing.h create mode 100644 src/libflac/private/window.h create mode 120000 src/libflac/protected/FLAC create mode 100644 src/libflac/protected/all.h create mode 100644 src/libflac/protected/stream_decoder.h create mode 100644 src/libflac/protected/stream_encoder.h create mode 100644 src/libflac/share/alloc.h create mode 100644 src/libflac/share/compat.h create mode 100644 src/libflac/share/endswap.h create mode 100644 src/libflac/share/getopt.h create mode 100644 src/libflac/share/grabbag.h create mode 100644 src/libflac/share/grabbag/Makefile.am create mode 100644 src/libflac/share/grabbag/Makefile.in create mode 100644 src/libflac/share/grabbag/cuesheet.h create mode 100644 src/libflac/share/grabbag/file.h create mode 100644 src/libflac/share/grabbag/picture.h create mode 100644 src/libflac/share/grabbag/replaygain.h create mode 100644 src/libflac/share/grabbag/seektable.h create mode 100644 src/libflac/share/macros.h create mode 100644 src/libflac/share/private.h create mode 100644 src/libflac/share/replaygain_analysis.h create mode 100644 src/libflac/share/replaygain_synthesis.h create mode 100644 src/libflac/share/safe_str.h create mode 100644 src/libflac/share/utf8.h create mode 100644 src/libflac/share/win_utf8_io.h create mode 100644 src/libflac/share/windows_unicode_filenames.h create mode 100644 src/libflac/stream_decoder.c create mode 100644 src/libflac/window.c diff --git a/README.md b/README.md index 5ab3126..b288a93 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # ESP8266Audio -Arduino library for parsing and decoding MOD, WAV, and MP3 files and playing them on an I2S DAC or even using a software-simulated delta-sigma DAC with dynamic 32x oversampling +Arduino library for parsing and decoding MOD, WAV, MP3, and FLAC files and playing them on an I2S DAC or even using a software-simulated delta-sigma DAC with dynamic 32x oversampling ## Disclaimer All this code is released under the GPL, and all of it is to be used at your own risk. If you find any bugs, please let me know via the GitHub issue tracker or drop me an email. The MOD and MP3 routines were taken from StellaPlayer and libMAD respectively. The software I2S delta-sigma 32x oversampling DAC was my own creation, and sounds quite good if I do say so myself. @@ -62,6 +62,8 @@ AudioGeneratorMOD: Reads and plays Amiga ModTracker files (.MOD). Use a 160MHz AudioGeneratorMP3: Reads and plays MP3 format files (.MP3) using a ported libMAD library. Use a 160MHz clock to ensure enough compute power to decode 128KBit 44.1KHz without hiccups. For complete porting history with the gory details, look at https://github.com/earlephilhower/libmad-8266 +AudioGeneratorFLAC: Plays FLAC files via ported libflac-1.3.2. On the order of 30KB heap and minimal stack required as-is. + ## AudioOutput classes AudioOutput: Base class for all output drivers. Takes a sample at a time and returns true/false if there is buffer space for it. If it returns false, it is the calling object's (AudioGenerator's) job to keep the data that didn't fit and try again later. diff --git a/examples/PlayFLACFromPROGMEMToDAC/PlayFLACFromPROGMEMToDAC.ino b/examples/PlayFLACFromPROGMEMToDAC/PlayFLACFromPROGMEMToDAC.ino new file mode 100644 index 0000000..e8907ad --- /dev/null +++ b/examples/PlayFLACFromPROGMEMToDAC/PlayFLACFromPROGMEMToDAC.ino @@ -0,0 +1,31 @@ +#include +#include +#include +#include + +#include "sample.h" + +AudioOutputI2SDAC *out; +AudioFileSourcePROGMEM *file; +AudioGeneratorFLAC *flac; + +void setup() +{ + Serial.begin(115200); + Serial.println("Starting up...\n"); + file = new AudioFileSourcePROGMEM( sample_flac, sizeof(sample_flac) ); + out = new AudioOutputI2SDAC(); + flac = new AudioGeneratorFLAC(); + flac->begin(file, out); +} + +void loop() +{ + if (flac->isRunning()) { + if (!flac->loop()) flac->stop(); + } else { + Serial.printf("FLAC done\n"); + delay(1000); + } +} + diff --git a/examples/PlayFLACFromPROGMEMToDAC/sample.h b/examples/PlayFLACFromPROGMEMToDAC/sample.h new file mode 100644 index 0000000..ec4c3f9 --- /dev/null +++ b/examples/PlayFLACFromPROGMEMToDAC/sample.h @@ -0,0 +1,5707 @@ +const unsigned char sample_flac[] PROGMEM = { + 0x66, 0x4c, 0x61, 0x43, 0x00, 0x00, 0x00, 0x22, 0x04, 0x80, 0x04, 0x80, + 0x00, 0x02, 0x93, 0x00, 0x08, 0x15, 0x02, 0xb1, 0x10, 0xf0, 0x00, 0x00, + 0x92, 0x66, 0x23, 0xb7, 0xc1, 0x81, 0xbb, 0xd2, 0xde, 0x0c, 0xb4, 0x82, + 0x18, 0xbd, 0xe5, 0x2c, 0x0b, 0x1d, 0x04, 0x00, 0x00, 0x2a, 0x0b, 0x00, + 0x00, 0x00, 0x4c, 0x61, 0x76, 0x66, 0x35, 0x32, 0x2e, 0x36, 0x34, 0x2e, + 0x32, 0x01, 0x00, 0x00, 0x00, 0x13, 0x00, 0x00, 0x00, 0x65, 0x6e, 0x63, + 0x6f, 0x64, 0x65, 0x72, 0x3d, 0x4c, 0x61, 0x76, 0x66, 0x35, 0x32, 0x2e, + 0x36, 0x34, 0x2e, 0x32, 0x81, 0x00, 0x20, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0xff, 0xf8, 0x3d, 0x08, 0x00, 0x2b, 0x11, 0x68, + 0x4e, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0x00, 0xff, 0x00, 0x00, + 0x00, 0xff, 0x00, 0xff, 0x00, 0xe7, 0x26, 0x69, 0xe5, 0x16, 0x51, 0x1c, + 0xdb, 0x47, 0xe3, 0x7f, 0x5e, 0x9e, 0xc0, 0xf9, 0xf7, 0x09, 0x1c, 0x94, + 0xd3, 0x84, 0x8b, 0xaf, 0x1c, 0x98, 0x6d, 0x52, 0xdb, 0x27, 0x24, 0xbd, + 0x4b, 0x4a, 0xb7, 0x10, 0x51, 0x77, 0xa1, 0x1e, 0xc7, 0xd2, 0xd0, 0xe2, + 0x0a, 0xff, 0x8d, 0x83, 0xc6, 0xa4, 0x11, 0x22, 0xf7, 0x52, 0x58, 0x0a, + 0x2a, 0x47, 0xba, 0x47, 0x7d, 0xb3, 0x83, 0xc5, 0xc3, 0x9e, 0xa0, 0x2d, + 0xb2, 0x7b, 0x75, 0xec, 0xc6, 0x21, 0x3e, 0x17, 0x21, 0xc0, 0x48, 0x0b, + 0x99, 0x8e, 0x50, 0xfc, 0xdb, 0x74, 0xca, 0x83, 0xce, 0xcb, 0x32, 0x77, + 0x93, 0xcb, 0xb8, 0xaa, 0x40, 0xaa, 0x4c, 0x94, 0x16, 0x56, 0x72, 0x46, + 0x4e, 0xd1, 0x8a, 0x66, 0xa7, 0x7c, 0xb2, 0x0b, 0xf3, 0x76, 0x11, 0xe9, + 0xe9, 0x2a, 0xd7, 0xb2, 0x70, 0x24, 0xad, 0xbc, 0x59, 0x18, 0xa4, 0x81, + 0xe3, 0xff, 0x5e, 0x77, 0x8a, 0xb5, 0xb2, 0xa5, 0x54, 0x8d, 0x5f, 0x2f, + 0x97, 0xcb, 0xe5, 0xf1, 0x83, 0x6b, 0xa2, 0x1e, 0x13, 0x14, 0xfe, 0xca, + 0x1f, 0x6a, 0x14, 0xbe, 0xa8, 0x2a, 0x67, 0x23, 0x30, 0x4b, 0x1f, 0xa8, + 0x71, 0x5d, 0x40, 0x70, 0x5b, 0x22, 0x0e, 0x35, 0xc6, 0x44, 0xd1, 0x70, + 0x49, 0x5a, 0x01, 0xe3, 0x61, 0xf3, 0x07, 0x8b, 0x86, 0xf7, 0xa4, 0x0e, + 0x48, 0x44, 0xe9, 0x01, 0xb8, 0xd1, 0xe5, 0x2a, 0x55, 0x31, 0x2e, 0x1b, + 0x72, 0x34, 0x9a, 0x3d, 0x70, 0x92, 0x24, 0x60, 0x9d, 0x9a, 0x23, 0x29, + 0xd9, 0xc2, 0xe5, 0x3c, 0x0b, 0x95, 0x89, 0x89, 0x54, 0xa9, 0x1b, 0x40, + 0x40, 0x88, 0x60, 0x97, 0x4b, 0x9f, 0x83, 0xf6, 0xa0, 0xee, 0xdf, 0x68, + 0xa1, 0xec, 0xa5, 0xc8, 0x91, 0x40, 0xa1, 0x15, 0xbe, 0xe2, 0x94, 0xc2, + 0x25, 0x70, 0x92, 0x24, 0x60, 0x9d, 0x9a, 0x79, 0xbc, 0xfa, 0x45, 0x87, + 0xe3, 0x7d, 0x5f, 0x15, 0xf2, 0x44, 0xef, 0x82, 0x49, 0x68, 0x34, 0x61, + 0x6a, 0x23, 0xb7, 0x95, 0xd4, 0x45, 0x93, 0xd5, 0x20, 0x92, 0xd2, 0xb0, + 0x6a, 0xdc, 0xa5, 0x1a, 0x7b, 0xf1, 0x42, 0x6c, 0x98, 0xd9, 0x52, 0x93, + 0x52, 0x25, 0x17, 0xfa, 0xd8, 0xcc, 0x1d, 0x76, 0x4d, 0x0e, 0xba, 0x52, + 0x54, 0x8f, 0x3a, 0xbc, 0xa5, 0x93, 0x4a, 0xa6, 0xf9, 0x59, 0x46, 0x2f, + 0x3f, 0x6f, 0xb5, 0xb1, 0xad, 0x2f, 0x31, 0x6c, 0x29, 0x9d, 0x1f, 0x46, + 0x90, 0xa5, 0x1c, 0x88, 0xd6, 0x4f, 0x0a, 0x73, 0x54, 0xe8, 0x87, 0x84, + 0xc5, 0x40, 0xbe, 0x89, 0x74, 0x31, 0xad, 0x61, 0xaa, 0x28, 0xf2, 0xad, + 0x6c, 0x6b, 0x58, 0x62, 0xa3, 0x0d, 0x7e, 0xb5, 0x61, 0x7f, 0x48, 0x13, + 0xe8, 0xef, 0x40, 0xd4, 0x25, 0x44, 0x9a, 0xa4, 0xc9, 0x36, 0xdf, 0xbf, + 0x24, 0x5b, 0x71, 0x5a, 0x42, 0x35, 0xf9, 0x6e, 0xc7, 0x34, 0xef, 0x85, + 0x02, 0x7d, 0x7d, 0x06, 0x60, 0x17, 0x98, 0x69, 0xf4, 0xc5, 0xf5, 0x06, + 0x3d, 0xe5, 0xaf, 0xae, 0xf8, 0x35, 0x13, 0xfe, 0x5c, 0x0f, 0xb5, 0x67, + 0x80, 0xc3, 0xbd, 0x65, 0xe7, 0xf8, 0xdf, 0x4b, 0xcd, 0xbb, 0x70, 0xec, + 0xa5, 0x8c, 0x03, 0xe6, 0xa2, 0x1b, 0x94, 0x5a, 0xe1, 0x94, 0x52, 0xff, + 0xdf, 0x36, 0x0c, 0xa8, 0xc4, 0x7a, 0xc5, 0xc4, 0xa9, 0x7d, 0x1a, 0xd8, + 0xda, 0x2c, 0x2a, 0x9c, 0xc5, 0x4e, 0xbe, 0x24, 0x0f, 0x0b, 0x13, 0x18, + 0x29, 0xe5, 0x4a, 0xc5, 0x6c, 0x5c, 0xc5, 0x84, 0xc6, 0xbe, 0xaa, 0x86, + 0xd5, 0x4d, 0xc4, 0x49, 0x97, 0x5b, 0xe2, 0xf6, 0xca, 0xfd, 0x2b, 0xac, + 0x88, 0x9b, 0x25, 0x01, 0x81, 0x14, 0x20, 0x34, 0xaf, 0xc1, 0x3e, 0xd1, + 0x90, 0x56, 0xe8, 0xe1, 0xfe, 0xc2, 0xa4, 0xc8, 0xf8, 0x7c, 0x28, 0xf2, + 0x2a, 0xf5, 0x10, 0xb0, 0xc1, 0x00, 0x89, 0xdf, 0xfd, 0xc7, 0xd4, 0x92, + 0x2e, 0x72, 0x00, 0x82, 0xcc, 0x0c, 0x31, 0x81, 0x55, 0x9b, 0xb5, 0x58, + 0xfe, 0x4e, 0xbe, 0x86, 0x88, 0xd0, 0xe8, 0xb4, 0x70, 0x84, 0x7e, 0x70, + 0xcd, 0x02, 0x63, 0xf4, 0x20, 0x40, 0xb5, 0x94, 0x34, 0xed, 0xcf, 0x7a, + 0x6a, 0x45, 0x03, 0xdc, 0xd2, 0xa4, 0xd8, 0x99, 0xf9, 0xce, 0x2a, 0x42, + 0x5c, 0x55, 0x57, 0x13, 0xa0, 0x39, 0x2f, 0xb3, 0x98, 0xc1, 0x0a, 0x9b, + 0x59, 0x21, 0x40, 0x92, 0xb8, 0xeb, 0x62, 0x53, 0x5c, 0xa3, 0x2d, 0x80, + 0x85, 0x61, 0x16, 0xdc, 0x52, 0xb6, 0x29, 0xd9, 0xa2, 0x96, 0x61, 0xd8, + 0xf7, 0xd5, 0x07, 0x26, 0xc4, 0x79, 0x8e, 0x31, 0xa4, 0x51, 0xbd, 0x64, + 0xdf, 0xdc, 0x08, 0xa8, 0xb9, 0x8f, 0x31, 0x8f, 0x71, 0x55, 0x5e, 0xf9, + 0xdd, 0x08, 0x02, 0xdc, 0xb9, 0x41, 0x61, 0xc0, 0xfb, 0x15, 0x95, 0xf2, + 0x87, 0xc6, 0xb2, 0x5e, 0x2b, 0xd1, 0xc9, 0xa9, 0x0d, 0x14, 0xee, 0xe1, + 0x56, 0x7b, 0x1d, 0x7d, 0x7a, 0x18, 0x5a, 0xb7, 0xeb, 0x00, 0x8d, 0xb3, + 0x37, 0x72, 0xbd, 0x3e, 0x90, 0xa3, 0x47, 0x96, 0x37, 0x33, 0x61, 0x36, + 0xb7, 0xcf, 0x9a, 0x19, 0x62, 0x45, 0xcc, 0x3d, 0x86, 0x9d, 0xd3, 0x11, + 0xe7, 0x4f, 0x5e, 0x99, 0xdd, 0x17, 0x52, 0xf8, 0x49, 0x4c, 0x38, 0xec, + 0xf3, 0x8b, 0xba, 0xc5, 0x1e, 0x3e, 0x6b, 0xc9, 0x29, 0x9f, 0x2f, 0xf4, + 0xf6, 0x14, 0x8c, 0x0e, 0x2b, 0x25, 0x44, 0x50, 0x94, 0xab, 0x74, 0xaf, + 0xc9, 0x91, 0x93, 0xd5, 0x4a, 0x35, 0x2f, 0xa3, 0x84, 0x1f, 0x58, 0x3a, + 0x92, 0x23, 0xd6, 0xa4, 0x1d, 0xc5, 0x54, 0x44, 0xce, 0xdf, 0x96, 0x21, + 0xf4, 0xd1, 0xb7, 0xc5, 0x75, 0xc9, 0x2e, 0x60, 0xef, 0xaa, 0x2c, 0xaf, + 0xd5, 0xda, 0x06, 0x9b, 0x62, 0xeb, 0x02, 0xf0, 0xeb, 0x6f, 0x68, 0xde, + 0x28, 0xba, 0xb5, 0xbf, 0x5a, 0x70, 0xb8, 0x54, 0x54, 0x04, 0xbd, 0x20, + 0x3e, 0x1f, 0x1b, 0xef, 0xd3, 0x6c, 0x39, 0x2e, 0x84, 0xa8, 0x44, 0xa0, + 0x86, 0x4d, 0x14, 0xfd, 0x1e, 0xd1, 0xef, 0xd5, 0x59, 0x69, 0x8d, 0x2a, + 0x25, 0xfa, 0x6c, 0x99, 0xb1, 0xb3, 0xa8, 0x84, 0xf5, 0x3b, 0xd2, 0x70, + 0x18, 0xd1, 0xd7, 0x50, 0x8e, 0x62, 0xfb, 0x07, 0x43, 0xcc, 0xb9, 0xa4, + 0x7e, 0x1e, 0xaf, 0x49, 0x4e, 0x54, 0x00, 0x90, 0x3c, 0x84, 0x5c, 0x1b, + 0x84, 0xd8, 0x82, 0x40, 0xda, 0xb7, 0x18, 0xc0, 0xb2, 0xaf, 0x2c, 0x4c, + 0x14, 0xb0, 0x17, 0x99, 0x61, 0xcb, 0x08, 0x19, 0xd2, 0x28, 0xb8, 0xf8, + 0x7d, 0x1d, 0x25, 0x3e, 0xc8, 0x5a, 0xa0, 0x07, 0xa3, 0xf0, 0xdb, 0xbf, + 0x85, 0x3d, 0xba, 0x97, 0x34, 0xe1, 0xf0, 0x13, 0xf2, 0xa2, 0x26, 0x82, + 0x0a, 0x4f, 0x22, 0xd2, 0x14, 0x4d, 0xf4, 0x5a, 0x56, 0x25, 0x67, 0x2b, + 0x9f, 0x85, 0xdb, 0xb3, 0x11, 0x08, 0xb9, 0x79, 0x14, 0x5b, 0xec, 0x94, + 0x36, 0x56, 0x6a, 0xe4, 0xb2, 0x9a, 0x27, 0x28, 0x71, 0x92, 0x90, 0xcb, + 0x57, 0x60, 0x29, 0x3a, 0x80, 0x20, 0x75, 0x46, 0xb5, 0x5d, 0x56, 0xd7, + 0x5c, 0xe1, 0xe4, 0x7b, 0x0c, 0x74, 0x44, 0xf0, 0x52, 0x84, 0x0b, 0x25, + 0xd0, 0x37, 0xd1, 0xbb, 0x67, 0x97, 0xfc, 0xf0, 0x81, 0x89, 0xc3, 0x50, + 0xea, 0xd2, 0xad, 0xf1, 0xd9, 0x2f, 0xcd, 0x9a, 0x38, 0xa1, 0x68, 0x8e, + 0x91, 0x17, 0x7b, 0xca, 0xa6, 0xa3, 0xde, 0xde, 0x45, 0xce, 0x8e, 0x91, + 0x8b, 0xc1, 0x86, 0x1a, 0x85, 0xa4, 0xa1, 0xc9, 0xc5, 0xeb, 0xde, 0xf4, + 0x0f, 0x68, 0x88, 0xe1, 0xb7, 0xe3, 0x18, 0x5a, 0xb3, 0xbd, 0x73, 0x03, + 0x46, 0x70, 0x79, 0xb6, 0x84, 0x86, 0x66, 0x51, 0x72, 0xe8, 0xcb, 0x29, + 0x1e, 0x8c, 0x82, 0x1b, 0xa6, 0xb0, 0x88, 0x80, 0x8e, 0xa5, 0xa4, 0x84, + 0x9c, 0x98, 0x86, 0x6b, 0x8a, 0x4f, 0x54, 0xb2, 0x22, 0xcf, 0xc6, 0x4e, + 0x47, 0x08, 0x22, 0x9a, 0x95, 0xdb, 0xaa, 0xa7, 0x29, 0xa5, 0x40, 0x8e, + 0x02, 0xf9, 0x6f, 0x1c, 0xca, 0x7c, 0x60, 0xe3, 0xb0, 0x0f, 0x21, 0xfa, + 0x8e, 0x88, 0x73, 0xcd, 0x4a, 0xc6, 0x14, 0x2c, 0x43, 0x4e, 0x5e, 0x1e, + 0x4c, 0x07, 0x52, 0x6f, 0xbd, 0x34, 0xd3, 0x19, 0xfb, 0xed, 0x6b, 0x3a, + 0x71, 0x92, 0x48, 0x77, 0xdb, 0x43, 0x77, 0x11, 0x47, 0xe3, 0x73, 0xe1, + 0xe5, 0x46, 0x01, 0x23, 0x40, 0xc5, 0xc6, 0x8e, 0x9d, 0xca, 0x12, 0xa0, + 0x69, 0x9b, 0xf5, 0x88, 0x9b, 0x89, 0xeb, 0x2a, 0x88, 0xe2, 0x69, 0x05, + 0xe5, 0x45, 0x6c, 0x4f, 0x82, 0xcd, 0x2e, 0x21, 0x62, 0x42, 0x97, 0x99, + 0x39, 0x43, 0x48, 0xf4, 0x17, 0xf5, 0xa9, 0xe2, 0xcc, 0x56, 0x0a, 0xff, + 0xe0, 0xf1, 0x8d, 0x1e, 0x42, 0x06, 0x90, 0x56, 0x8a, 0x2c, 0x05, 0x79, + 0x7f, 0xe3, 0x3c, 0x87, 0xd8, 0x2a, 0xa7, 0x1a, 0x52, 0xc9, 0xf4, 0x49, + 0xda, 0x95, 0xaa, 0xad, 0xb7, 0x26, 0x67, 0x9b, 0x93, 0xfa, 0x77, 0x0a, + 0x7d, 0xaa, 0x16, 0xd2, 0x6e, 0xcb, 0x1f, 0x1e, 0x5f, 0xf7, 0x04, 0xc7, + 0xc0, 0xb2, 0x5a, 0x12, 0xa8, 0x2c, 0xe6, 0x3b, 0xec, 0x26, 0xa5, 0x18, + 0xa7, 0x6c, 0x10, 0xc0, 0xa2, 0xab, 0x76, 0xd1, 0x5d, 0x4a, 0xb5, 0xba, + 0xfc, 0x74, 0x02, 0x71, 0x48, 0x61, 0x81, 0xab, 0xad, 0x28, 0x05, 0x49, + 0xf4, 0x31, 0xfd, 0x0b, 0xca, 0xa3, 0x75, 0xcf, 0x72, 0x92, 0xec, 0x1c, + 0x6c, 0xde, 0x69, 0x8a, 0x41, 0x81, 0x2c, 0xc2, 0x39, 0xc2, 0xb8, 0x82, + 0x64, 0x18, 0x53, 0x3f, 0x90, 0x20, 0x8b, 0xc5, 0x08, 0xcb, 0xf0, 0x50, + 0xb5, 0x80, 0x83, 0x19, 0xbf, 0xfe, 0x5d, 0x40, 0x32, 0x10, 0x04, 0xf9, + 0xf7, 0x1d, 0x58, 0xae, 0x28, 0x33, 0x42, 0x8d, 0x33, 0xbc, 0x04, 0x0d, + 0x06, 0xe6, 0x36, 0x10, 0x82, 0x1a, 0xcb, 0xff, 0xbd, 0xee, 0xe6, 0x61, + 0xf1, 0x69, 0x28, 0x3c, 0xc4, 0xf1, 0xf2, 0xd3, 0x7b, 0x4c, 0xab, 0x6d, + 0x69, 0x7b, 0x65, 0x4e, 0x35, 0xc1, 0x39, 0xa2, 0x96, 0x3d, 0x72, 0x7e, + 0xb5, 0xf5, 0xc9, 0xa2, 0xce, 0xcc, 0x12, 0x58, 0x41, 0xda, 0x33, 0xbf, + 0xf7, 0x22, 0x14, 0xee, 0xe2, 0x1a, 0x87, 0xbf, 0x6e, 0x71, 0x8c, 0x3a, + 0x5d, 0x25, 0xef, 0x08, 0xa0, 0x41, 0xac, 0x88, 0xf2, 0x3b, 0xe0, 0x45, + 0xd2, 0x8b, 0xd3, 0x0b, 0x58, 0xda, 0xa6, 0xd0, 0xdc, 0x59, 0x86, 0xe8, + 0xbe, 0x25, 0xbf, 0x53, 0x12, 0x55, 0x50, 0x4a, 0x37, 0xc3, 0x66, 0x45, + 0x0c, 0x90, 0x3c, 0xba, 0x2d, 0xa2, 0x1d, 0x95, 0xac, 0xfc, 0x62, 0x64, + 0xd7, 0xc5, 0x6b, 0x89, 0x11, 0x12, 0x3b, 0xdf, 0x88, 0xeb, 0x16, 0xbf, + 0x6d, 0x71, 0x85, 0x75, 0x0a, 0x0f, 0xce, 0x89, 0xad, 0x62, 0x13, 0xb7, + 0xa3, 0xa3, 0xae, 0x70, 0x2f, 0x05, 0x58, 0x15, 0x14, 0x71, 0x58, 0x2c, + 0x09, 0x3c, 0x68, 0xa1, 0x30, 0xc7, 0x85, 0xae, 0xe2, 0xc4, 0x11, 0x18, + 0xd0, 0x52, 0xe8, 0xfe, 0xa6, 0xe5, 0x4c, 0xa3, 0xc1, 0x72, 0x83, 0x89, + 0x8b, 0x82, 0x60, 0x19, 0xbe, 0xe0, 0x9b, 0x49, 0x6b, 0x4d, 0xd3, 0x5a, + 0x4d, 0xc0, 0xa4, 0xb2, 0xff, 0xf8, 0x3d, 0x08, 0x01, 0x2b, 0x11, 0x03, + 0x4e, 0x01, 0x00, 0xff, 0x00, 0xfd, 0x00, 0x02, 0x00, 0x08, 0x00, 0x0a, + 0x00, 0x09, 0x00, 0x08, 0x00, 0xe6, 0xaa, 0xdb, 0xa3, 0x10, 0x92, 0x1f, + 0xf4, 0x17, 0xc6, 0x90, 0xbb, 0xff, 0xba, 0xbc, 0x9c, 0x05, 0x5a, 0x2a, + 0x05, 0xc1, 0xcc, 0x69, 0x35, 0xb7, 0xd3, 0xf0, 0xc2, 0xa2, 0x28, 0xe1, + 0x2e, 0x86, 0xf7, 0x6c, 0x8b, 0x33, 0x7f, 0x4e, 0x06, 0x43, 0x4e, 0x8b, + 0xd1, 0x99, 0x0d, 0x4b, 0xad, 0x6c, 0xf4, 0x6b, 0x2a, 0x5d, 0x56, 0x23, + 0x79, 0x25, 0x99, 0x16, 0xf3, 0xe1, 0x8a, 0xcf, 0x41, 0x28, 0x36, 0x6a, + 0xee, 0xb3, 0x2a, 0x36, 0x43, 0xdb, 0x9f, 0xf8, 0x3b, 0xea, 0x74, 0x23, + 0x4b, 0x05, 0x42, 0xec, 0x97, 0xf4, 0x99, 0xa5, 0x4a, 0x94, 0x47, 0x43, + 0x72, 0x1a, 0x58, 0xc7, 0xfc, 0xb3, 0x93, 0xc4, 0x1d, 0x21, 0xc1, 0xd0, + 0x80, 0xb3, 0xf5, 0x29, 0x2a, 0x41, 0x05, 0x92, 0xe4, 0x1e, 0x5c, 0x4f, + 0x31, 0x49, 0x81, 0x0e, 0x25, 0xa8, 0x8e, 0x3f, 0x11, 0xb3, 0x35, 0xd1, + 0x4a, 0x94, 0xa1, 0x6a, 0x96, 0x0e, 0xf9, 0x75, 0x3f, 0xf0, 0x21, 0xa5, + 0xd3, 0x07, 0x9d, 0x25, 0x08, 0x87, 0xd0, 0xc3, 0x8f, 0xae, 0xf9, 0x5c, + 0x64, 0xe7, 0x24, 0x0b, 0x85, 0x5e, 0x24, 0x7d, 0xea, 0x30, 0x76, 0x34, + 0x34, 0xb3, 0x07, 0x2c, 0x11, 0x35, 0x6b, 0x6c, 0x0a, 0xd5, 0x91, 0x8d, + 0x60, 0x46, 0x27, 0x49, 0x72, 0x43, 0x88, 0x40, 0x08, 0xef, 0x9a, 0x8f, + 0x03, 0x25, 0xd3, 0xf7, 0x35, 0x24, 0xac, 0x31, 0xc4, 0xb1, 0x8f, 0xe0, + 0x49, 0x26, 0x86, 0x8a, 0x74, 0x1f, 0x4b, 0x24, 0x81, 0x49, 0xb2, 0x8f, + 0x1d, 0xa7, 0x19, 0x8b, 0x23, 0xf7, 0xaa, 0xf8, 0xd1, 0xf2, 0x72, 0x17, + 0xde, 0xc5, 0xdb, 0x40, 0x6f, 0x33, 0x91, 0x78, 0x49, 0x1a, 0xa9, 0xae, + 0xac, 0x99, 0x78, 0x3b, 0x23, 0xb3, 0xf4, 0xaf, 0xc8, 0x09, 0x9f, 0x51, + 0x30, 0x3d, 0xfb, 0xda, 0xf3, 0x35, 0x33, 0xf1, 0x61, 0x06, 0xf0, 0x86, + 0xa5, 0xd2, 0xf4, 0x33, 0x0d, 0xd2, 0x49, 0xf7, 0x7f, 0xd1, 0x31, 0x79, + 0xd4, 0x3a, 0xc3, 0x68, 0xc6, 0x02, 0x25, 0x0c, 0x26, 0x0c, 0xe5, 0xe6, + 0x83, 0x0c, 0x80, 0xbc, 0xe0, 0xf5, 0x80, 0x81, 0xcd, 0x0a, 0xc8, 0x70, + 0x6e, 0xac, 0x38, 0xd0, 0x62, 0x8c, 0xc4, 0x20, 0x45, 0x89, 0x79, 0x01, + 0xcc, 0x4d, 0x38, 0x24, 0x52, 0x23, 0x01, 0xb0, 0x4b, 0x26, 0x9e, 0x8f, + 0x45, 0xee, 0x4f, 0x9b, 0xe4, 0xc5, 0x1d, 0xb5, 0x02, 0xd3, 0x72, 0x78, + 0xe1, 0x16, 0xbb, 0xa1, 0x03, 0x12, 0x6c, 0x33, 0x54, 0x9c, 0x24, 0xbc, + 0x3d, 0xef, 0xe9, 0x48, 0xe3, 0x3a, 0x00, 0x34, 0xab, 0x70, 0xa2, 0x6e, + 0x6c, 0x14, 0x9f, 0x7b, 0xb5, 0x4c, 0xd5, 0xaf, 0xaa, 0x52, 0xe5, 0x8f, + 0xfb, 0x0a, 0x2c, 0x25, 0x5c, 0x72, 0x4d, 0xd0, 0x99, 0x8d, 0x61, 0xc6, + 0x45, 0x28, 0xa8, 0x08, 0xbc, 0x99, 0xa2, 0x81, 0x13, 0xa5, 0xd8, 0xa4, + 0x06, 0x82, 0x9c, 0x71, 0xce, 0x7d, 0x6a, 0xeb, 0xe2, 0xc5, 0xd6, 0xca, + 0x84, 0x5f, 0x5c, 0xd1, 0x10, 0x78, 0x64, 0xfb, 0xa3, 0x53, 0xb1, 0x5f, + 0xdd, 0x03, 0xfb, 0xd3, 0x6e, 0x33, 0x1e, 0xd4, 0x0e, 0x23, 0xb2, 0x0a, + 0x06, 0x38, 0xcd, 0xe7, 0xb8, 0x0a, 0xc5, 0x9a, 0xde, 0x42, 0xbe, 0x1f, + 0x22, 0xbf, 0x02, 0xa0, 0xee, 0x02, 0xfc, 0xbd, 0x6d, 0x45, 0xa3, 0x93, + 0x74, 0xc2, 0x5d, 0x2c, 0xa6, 0x8b, 0xbb, 0xbe, 0x52, 0x29, 0x88, 0x6c, + 0x20, 0x14, 0x40, 0x1c, 0x67, 0x09, 0xb2, 0x67, 0x44, 0x35, 0x1d, 0xaa, + 0x2a, 0x90, 0x80, 0x92, 0x81, 0x97, 0x2d, 0xb6, 0xd0, 0xff, 0x50, 0x9f, + 0x87, 0x6f, 0x84, 0x7e, 0x7c, 0xb1, 0xfe, 0x67, 0xe6, 0xcc, 0x15, 0xf2, + 0x24, 0xa0, 0x9d, 0x99, 0x5d, 0x48, 0x7a, 0x71, 0xc5, 0x1f, 0x62, 0x1e, + 0x80, 0x41, 0x94, 0x7f, 0x40, 0x77, 0xe9, 0x4d, 0xa7, 0xf5, 0x27, 0x66, + 0xac, 0x3c, 0x87, 0x34, 0xb7, 0xbd, 0x76, 0x6b, 0xbd, 0x6b, 0xfe, 0x38, + 0xdb, 0xd7, 0xfa, 0xb1, 0x1d, 0x3a, 0x33, 0xa9, 0xc7, 0xbb, 0xd1, 0x53, + 0x7d, 0x8a, 0xdd, 0x27, 0x88, 0x9d, 0x2d, 0xc5, 0x3b, 0xc5, 0x1b, 0xca, + 0xbe, 0x73, 0xe9, 0x6f, 0x17, 0x04, 0xab, 0x24, 0xe7, 0xdf, 0xc2, 0x0f, + 0xf9, 0xdb, 0xe2, 0x49, 0xc2, 0x79, 0x4e, 0x41, 0x7f, 0xeb, 0xa7, 0xae, + 0xe6, 0x0c, 0x56, 0xe8, 0xa5, 0xd2, 0x22, 0x3e, 0x14, 0x60, 0x37, 0x33, + 0xd5, 0x6e, 0x5a, 0x35, 0xd6, 0xf1, 0xa0, 0x96, 0x45, 0x93, 0x67, 0x87, + 0xbf, 0xcf, 0x1e, 0x75, 0x63, 0xd8, 0x68, 0x1a, 0x75, 0x1c, 0x6b, 0x5c, + 0xe4, 0x09, 0xc7, 0xd4, 0x9b, 0xc5, 0x2d, 0x8c, 0xfe, 0xc4, 0x12, 0x5a, + 0xe4, 0x32, 0x4f, 0x1c, 0x0f, 0xf0, 0xcc, 0xa2, 0xd0, 0x62, 0x2c, 0x18, + 0x3a, 0xf6, 0xe5, 0xf5, 0xdf, 0x05, 0xfb, 0x11, 0x70, 0xfc, 0x00, 0x88, + 0xf2, 0x50, 0xce, 0xb0, 0x0c, 0x36, 0x10, 0x4e, 0xe5, 0xca, 0x42, 0x95, + 0x2b, 0xd8, 0x2e, 0xb3, 0xaa, 0x2c, 0x22, 0xd4, 0xef, 0x3d, 0x7a, 0xa4, + 0x63, 0x3b, 0xab, 0xc3, 0x42, 0x64, 0xd3, 0x8e, 0x89, 0x04, 0xe4, 0x31, + 0xde, 0x96, 0xef, 0x0c, 0xba, 0x52, 0xec, 0x35, 0xb3, 0xf4, 0xbf, 0xb7, + 0x94, 0xaa, 0x27, 0x41, 0x3a, 0xc8, 0xc8, 0xe6, 0x8b, 0xfa, 0x8f, 0x23, + 0xd9, 0xef, 0x8e, 0x15, 0x83, 0x66, 0xc2, 0x12, 0x58, 0xaf, 0x7d, 0x5a, + 0x7a, 0xe0, 0x9a, 0xbd, 0x45, 0x3e, 0x60, 0xc5, 0xa7, 0x59, 0x65, 0x4d, + 0x23, 0xcc, 0xe5, 0x99, 0x66, 0xd7, 0x92, 0x60, 0xe5, 0xaa, 0x20, 0x75, + 0x5b, 0x9a, 0x3d, 0x0d, 0xd7, 0x65, 0x20, 0x57, 0xa3, 0xb3, 0x93, 0x4b, + 0xde, 0x17, 0x5b, 0x57, 0xb6, 0xfd, 0x56, 0x5c, 0x92, 0xd3, 0xc9, 0x3a, + 0xb1, 0xcc, 0xba, 0xe1, 0x69, 0x34, 0x8a, 0x8e, 0xc8, 0xc1, 0xde, 0xf0, + 0xc3, 0xbb, 0xa6, 0x47, 0xde, 0x80, 0xce, 0x5a, 0xd0, 0x67, 0x77, 0x87, + 0x6e, 0x66, 0x32, 0xf5, 0x56, 0x79, 0xb6, 0xff, 0x0b, 0x12, 0x76, 0xd2, + 0xc4, 0x09, 0xe1, 0xd4, 0x78, 0x5c, 0xed, 0x38, 0xf2, 0xb7, 0x68, 0xa4, + 0x61, 0x16, 0x3c, 0x35, 0x93, 0x3b, 0xed, 0x86, 0x3f, 0x6c, 0xa2, 0xfb, + 0x44, 0xa1, 0xbb, 0xab, 0xde, 0x41, 0x1c, 0x4a, 0xca, 0x04, 0xb4, 0xe6, + 0x4a, 0x09, 0x02, 0xb5, 0x1f, 0x5b, 0xfb, 0xa7, 0xf9, 0x30, 0x4f, 0x20, + 0x4c, 0x1e, 0xff, 0x29, 0x7c, 0x44, 0x61, 0x5b, 0x30, 0x66, 0x9f, 0xc2, + 0x79, 0x2c, 0xac, 0x39, 0x46, 0xc1, 0x36, 0x57, 0x8c, 0xe3, 0xd5, 0x09, + 0xf4, 0xef, 0x4e, 0x0f, 0x69, 0xc2, 0x3f, 0x2b, 0x32, 0x86, 0xa6, 0xa3, + 0xa5, 0xea, 0xe1, 0x33, 0x1e, 0x22, 0x6d, 0x84, 0x7b, 0xdc, 0xd5, 0xc5, + 0xdd, 0xee, 0x69, 0x35, 0xc6, 0xd9, 0x1a, 0x6e, 0xd6, 0xea, 0x22, 0xed, + 0x90, 0x17, 0xf3, 0x98, 0x7d, 0x20, 0xbe, 0xc7, 0xa0, 0x20, 0xdb, 0xa7, + 0x25, 0x17, 0xe0, 0x4f, 0x4f, 0xad, 0x78, 0x2d, 0x2a, 0x0c, 0x04, 0x48, + 0x97, 0x6c, 0xc1, 0x81, 0xe2, 0x9c, 0xf4, 0xf0, 0x92, 0x99, 0x1f, 0x6c, + 0xb9, 0x22, 0x3c, 0x47, 0x03, 0x6d, 0x88, 0xe2, 0xc5, 0x13, 0xb0, 0x65, + 0xab, 0x29, 0x30, 0x72, 0x61, 0x50, 0x18, 0xe5, 0xc0, 0xad, 0x39, 0xca, + 0xd8, 0xd7, 0x04, 0xd5, 0x65, 0x97, 0x40, 0x57, 0x5d, 0x6d, 0xf9, 0x53, + 0x02, 0x26, 0x8f, 0x91, 0x79, 0x76, 0x06, 0xe8, 0xbd, 0xa3, 0x84, 0x61, + 0x99, 0x22, 0xab, 0xe9, 0x68, 0xae, 0xd9, 0x27, 0xe8, 0xc6, 0xbd, 0xe2, + 0xb3, 0xc8, 0x01, 0x4c, 0xe0, 0x0d, 0xaf, 0xd4, 0x0c, 0x4b, 0xf7, 0x81, + 0xb2, 0x11, 0xf4, 0x54, 0x30, 0xf3, 0x60, 0xbe, 0xc0, 0xa2, 0x40, 0x6e, + 0xb1, 0x1c, 0x85, 0xdc, 0x66, 0xff, 0x32, 0x04, 0x6a, 0xbb, 0x85, 0x48, + 0x0d, 0x5e, 0x3f, 0x11, 0x21, 0xc8, 0x78, 0xed, 0x05, 0x95, 0x01, 0x62, + 0xd2, 0xfd, 0xf6, 0x06, 0xaf, 0xbd, 0x39, 0xc0, 0x2b, 0x5a, 0x01, 0xa2, + 0x11, 0x05, 0x20, 0x0d, 0x1f, 0x84, 0x6f, 0x7e, 0xe2, 0x03, 0xcb, 0x7a, + 0xb9, 0x3e, 0x9a, 0x71, 0x29, 0x04, 0x50, 0xee, 0x2f, 0xbe, 0xc8, 0x51, + 0x36, 0x01, 0xa3, 0xb8, 0xdc, 0xbb, 0xa5, 0x81, 0xe4, 0x22, 0x56, 0xaf, + 0x17, 0xb6, 0x2e, 0xba, 0x62, 0x56, 0xad, 0xaa, 0x4f, 0x08, 0x34, 0x75, + 0x07, 0x6d, 0x11, 0x72, 0xe7, 0x09, 0xc9, 0xc3, 0xc9, 0xb9, 0x1d, 0xa7, + 0x02, 0x46, 0x6d, 0x0c, 0x25, 0x25, 0xed, 0x56, 0x03, 0x43, 0xcb, 0xa2, + 0xa2, 0xd4, 0x61, 0x27, 0xb1, 0xeb, 0x94, 0x65, 0x84, 0x13, 0x39, 0x76, + 0x47, 0x9a, 0x7a, 0xd9, 0x12, 0x62, 0x6a, 0x56, 0xe4, 0xc4, 0xaf, 0xf5, + 0xaa, 0x83, 0xe9, 0x0d, 0x77, 0xe2, 0x3f, 0x0a, 0x54, 0xa1, 0x1c, 0x0a, + 0x48, 0x7c, 0x2b, 0x55, 0x68, 0xdb, 0x47, 0xf7, 0x09, 0xcd, 0x17, 0xa7, + 0x02, 0x33, 0xe1, 0xea, 0x72, 0x90, 0xd9, 0xd2, 0xa9, 0x23, 0x76, 0xc9, + 0xbf, 0x66, 0x94, 0x13, 0x8a, 0xe9, 0x08, 0x32, 0x62, 0x10, 0x17, 0x8b, + 0xd5, 0x94, 0x8c, 0xee, 0x47, 0xb2, 0x18, 0x37, 0x8b, 0x01, 0x17, 0x1f, + 0xf3, 0x49, 0xe6, 0x07, 0x25, 0x9e, 0x9d, 0x20, 0x95, 0x44, 0xa9, 0x14, + 0x35, 0xe9, 0x71, 0x81, 0x8d, 0x64, 0xc7, 0x03, 0x68, 0xb2, 0xaf, 0xcc, + 0xf2, 0x5e, 0x5b, 0xd9, 0x4f, 0x3c, 0x84, 0x8b, 0x35, 0xd2, 0x39, 0x4d, + 0x4a, 0xf9, 0xa1, 0xfe, 0x2a, 0x57, 0xc6, 0x05, 0x56, 0x35, 0x89, 0xef, + 0x56, 0xb5, 0x42, 0xda, 0xee, 0x49, 0xb1, 0xa9, 0xbc, 0x57, 0xc7, 0x1d, + 0x12, 0xee, 0xd5, 0x44, 0xe5, 0xad, 0x99, 0x91, 0xdf, 0x97, 0x26, 0xf5, + 0xa8, 0x81, 0xdd, 0x50, 0x63, 0x0e, 0xee, 0x27, 0x55, 0xc0, 0xe9, 0x09, + 0xf1, 0x88, 0x24, 0x45, 0x4b, 0x98, 0xb9, 0x3d, 0xa2, 0xea, 0x48, 0xe4, + 0x35, 0xda, 0xa8, 0x08, 0xc1, 0x18, 0x3e, 0xe1, 0x7b, 0x9f, 0x70, 0xb8, + 0x6d, 0xdf, 0xd8, 0x8f, 0xd6, 0x4b, 0x42, 0x36, 0x38, 0xf9, 0x1e, 0x3f, + 0xd4, 0x3a, 0x4a, 0x2f, 0x9d, 0x46, 0x96, 0xbd, 0x94, 0x12, 0x8d, 0x6a, + 0x5c, 0x24, 0x02, 0xc9, 0x02, 0x95, 0x5f, 0x4d, 0x35, 0x8f, 0xa5, 0x66, + 0x78, 0x63, 0xe6, 0x7d, 0xe2, 0xed, 0x81, 0x29, 0x62, 0x6e, 0x38, 0x16, + 0x70, 0xb9, 0xc2, 0x40, 0x3f, 0xc6, 0xe2, 0x04, 0x1d, 0xd7, 0xbd, 0xf0, + 0x30, 0x84, 0xb2, 0x10, 0x72, 0xe0, 0x1f, 0xc7, 0xf6, 0x4f, 0x43, 0x50, + 0x3a, 0xf1, 0x0c, 0x47, 0xeb, 0x55, 0x4b, 0xc4, 0xa4, 0x0e, 0xd5, 0xd9, + 0xcc, 0xc6, 0x55, 0xe8, 0x78, 0xdb, 0x54, 0x09, 0xc5, 0xe9, 0x7b, 0x5e, + 0xcf, 0xfa, 0xb7, 0xd5, 0x82, 0x5b, 0xa6, 0x8c, 0x26, 0x72, 0x3e, 0x2b, + 0xb1, 0xcb, 0xa4, 0xf5, 0x0e, 0x18, 0x09, 0x0a, 0x16, 0x28, 0xb1, 0x68, + 0xfe, 0x3c, 0x57, 0x66, 0x03, 0x3a, 0x88, 0x65, 0xea, 0xe9, 0x02, 0x13, + 0x93, 0x06, 0x8f, 0xb2, 0xf6, 0x50, 0x4f, 0x98, 0x6d, 0x93, 0x18, 0x91, + 0x89, 0xc0, 0x5d, 0x4c, 0xf8, 0x75, 0x44, 0x14, 0x20, 0x63, 0x80, 0x71, + 0x87, 0x28, 0x67, 0x56, 0x13, 0x9c, 0x04, 0xa8, 0x54, 0xa1, 0x45, 0x2d, + 0xba, 0xce, 0x4f, 0x7d, 0x87, 0x1e, 0xba, 0x0b, 0xc6, 0x7f, 0xb3, 0xe1, + 0x66, 0x16, 0x9d, 0x8c, 0x86, 0x38, 0xc8, 0x77, 0x11, 0x33, 0x98, 0x00, + 0x25, 0x7e, 0xbe, 0xd4, 0x22, 0x59, 0xec, 0x85, 0x48, 0x64, 0x89, 0x66, + 0x43, 0x59, 0x83, 0x4d, 0xc6, 0x34, 0x5b, 0x2c, 0xaa, 0x1f, 0x7f, 0x18, + 0x21, 0x1d, 0x54, 0x21, 0xcc, 0x08, 0x6c, 0x2c, 0x0a, 0x2b, 0xda, 0x21, + 0xc0, 0xb0, 0x1d, 0x10, 0x86, 0x8a, 0xa0, 0x53, 0x50, 0x78, 0x09, 0x6a, + 0xeb, 0x1d, 0x45, 0xcd, 0x03, 0xf7, 0x17, 0xa0, 0x45, 0x2b, 0x5b, 0x35, + 0x13, 0x8a, 0xa8, 0x2b, 0xfa, 0x2c, 0x48, 0xb4, 0x50, 0x78, 0xe5, 0x3c, + 0xe2, 0xc8, 0xf5, 0x1e, 0x0a, 0x95, 0x65, 0xd1, 0x4f, 0xa7, 0x5b, 0x28, + 0xd6, 0x7a, 0x26, 0x72, 0x05, 0x3d, 0xbb, 0xd4, 0xfb, 0xcb, 0x5c, 0x50, + 0xac, 0x54, 0x2d, 0x9b, 0x88, 0x2e, 0x95, 0x46, 0x32, 0x99, 0x54, 0x5a, + 0xbb, 0x32, 0xdf, 0x14, 0xe9, 0x5c, 0x08, 0x1f, 0xe8, 0x99, 0xf9, 0xed, + 0x1a, 0xd8, 0x39, 0x61, 0xc1, 0x34, 0xa0, 0x4b, 0x07, 0x00, 0x10, 0xb0, + 0xb3, 0x9e, 0x20, 0xaa, 0xb0, 0x02, 0x28, 0x9a, 0x84, 0x34, 0x41, 0x93, + 0xd0, 0xb5, 0x30, 0x57, 0x00, 0xd0, 0xfa, 0xe3, 0x09, 0xa3, 0x67, 0xb4, + 0x6e, 0xbc, 0x02, 0x51, 0x67, 0xc6, 0x42, 0x4a, 0xfb, 0x05, 0xd6, 0xed, + 0x48, 0x3e, 0xc5, 0x0f, 0x65, 0xfc, 0x17, 0xbe, 0x9b, 0xc0, 0xe6, 0xe3, + 0x0d, 0x61, 0x01, 0x99, 0xa1, 0x03, 0x83, 0xe7, 0x74, 0x3e, 0xa6, 0xcc, + 0xae, 0x93, 0x42, 0x6a, 0x28, 0x84, 0xe1, 0x3a, 0x80, 0xdb, 0x2b, 0xff, + 0xf8, 0x3d, 0x08, 0x02, 0x2b, 0x11, 0xbe, 0x4e, 0x05, 0x00, 0x0a, 0x00, + 0x0c, 0x00, 0x0b, 0x00, 0x0c, 0x00, 0x11, 0x00, 0x13, 0x00, 0x12, 0x00, + 0xe7, 0x3b, 0x7f, 0xd8, 0xe2, 0x78, 0x0c, 0xbb, 0x9e, 0xf7, 0x9f, 0x97, + 0x7e, 0xb1, 0xfb, 0x72, 0x09, 0x19, 0xfc, 0xd9, 0x3c, 0x08, 0xd8, 0x58, + 0xca, 0xba, 0xc6, 0x0b, 0x6f, 0xcd, 0x63, 0xf2, 0xab, 0x19, 0x96, 0xc0, + 0xad, 0x32, 0x1f, 0x53, 0x31, 0x81, 0x1a, 0xa1, 0x1a, 0x75, 0x9a, 0x82, + 0x28, 0x6e, 0xcb, 0x68, 0xcc, 0x58, 0xc9, 0xc8, 0x58, 0xc5, 0xf5, 0xdb, + 0x16, 0x3d, 0xf0, 0x57, 0xc1, 0x19, 0xe6, 0xda, 0xf2, 0x43, 0xd2, 0x83, + 0x38, 0xb4, 0xb1, 0x1a, 0x98, 0x29, 0x78, 0x21, 0x9d, 0x04, 0xe9, 0xc2, + 0x82, 0x5d, 0x25, 0x90, 0x70, 0xf0, 0x0e, 0xa4, 0x06, 0x2f, 0xd9, 0xc7, + 0x94, 0xef, 0x59, 0xec, 0x82, 0x40, 0x16, 0x59, 0xd9, 0xa0, 0xf8, 0xb8, + 0x7d, 0xd2, 0x93, 0xee, 0xb3, 0x96, 0x38, 0x80, 0xb3, 0xf0, 0x1d, 0x67, + 0xfc, 0x5c, 0x8f, 0x06, 0x2d, 0x2f, 0x11, 0x26, 0xd2, 0x4b, 0x9b, 0x97, + 0x3b, 0xe0, 0xd2, 0x09, 0x59, 0x3e, 0x2e, 0x24, 0xd5, 0x0f, 0x2a, 0xad, + 0x8e, 0x9a, 0xc4, 0x64, 0xfe, 0x87, 0x40, 0xc8, 0x79, 0xd9, 0xfc, 0x70, + 0x4e, 0x16, 0xdc, 0x37, 0xd4, 0x52, 0x08, 0xd9, 0xb4, 0x2d, 0x4b, 0xc0, + 0xae, 0x0b, 0x34, 0x95, 0x70, 0x0e, 0x62, 0x26, 0x06, 0x5c, 0x4f, 0xce, + 0x6a, 0x46, 0x42, 0xf6, 0xe2, 0x9f, 0x91, 0xfd, 0xdb, 0x0a, 0xa2, 0x25, + 0x73, 0x6a, 0x22, 0x10, 0xe7, 0x0f, 0x03, 0x1a, 0x16, 0x86, 0x7d, 0x16, + 0x2e, 0x9a, 0xd3, 0x60, 0x76, 0x59, 0xd3, 0x0e, 0x60, 0x51, 0x70, 0x4e, + 0x71, 0xc1, 0x67, 0x2a, 0xeb, 0x73, 0xba, 0x28, 0xb7, 0xf1, 0x79, 0x44, + 0x61, 0xde, 0x6f, 0x0e, 0x5c, 0x23, 0x28, 0x32, 0x6d, 0x3f, 0x07, 0xfb, + 0xb0, 0x5b, 0x02, 0x60, 0x40, 0x95, 0xe4, 0x71, 0x54, 0x94, 0xab, 0x9f, + 0xcf, 0xf0, 0xf3, 0xc4, 0x97, 0x14, 0xc9, 0xe0, 0xcc, 0xa3, 0x2c, 0x78, + 0x78, 0x4a, 0x71, 0x14, 0xda, 0xb6, 0xe4, 0xdc, 0xf0, 0xf2, 0x9b, 0x00, + 0x4a, 0x34, 0xf7, 0xb8, 0x32, 0x8a, 0x3c, 0x8f, 0xc2, 0x28, 0x50, 0x5d, + 0x45, 0x32, 0x5d, 0x87, 0xdb, 0x48, 0xcc, 0xc8, 0xae, 0xbc, 0x98, 0x15, + 0xab, 0x19, 0xa2, 0xe9, 0x26, 0xfd, 0x8d, 0xb0, 0x2f, 0xd7, 0xd8, 0xad, + 0x9f, 0xc7, 0x8f, 0x9b, 0xa6, 0x88, 0x5b, 0x87, 0x3c, 0x62, 0x48, 0x51, + 0xd3, 0x36, 0x35, 0xc3, 0x22, 0x88, 0x78, 0xa6, 0x53, 0x2b, 0x89, 0x46, + 0x6c, 0x11, 0xb1, 0xb4, 0x9d, 0x5e, 0xf5, 0xd0, 0xb0, 0x2b, 0x53, 0x64, + 0x7d, 0x69, 0x80, 0xed, 0xbe, 0xac, 0x5b, 0x90, 0x4e, 0xb7, 0x59, 0xc3, + 0x72, 0xc8, 0x0d, 0xcc, 0xdc, 0x2e, 0xfd, 0xb0, 0x3c, 0x9d, 0xb4, 0xb2, + 0xc4, 0xfb, 0x2e, 0x44, 0xb6, 0x9a, 0x63, 0x54, 0xfc, 0x2a, 0xc3, 0x4b, + 0x52, 0x04, 0xdb, 0xea, 0x3d, 0xad, 0x9f, 0x04, 0x85, 0x16, 0x7c, 0x56, + 0xed, 0x32, 0xbe, 0x9f, 0xf3, 0x28, 0xd2, 0x98, 0xac, 0x0b, 0x46, 0x54, + 0x8f, 0x61, 0xba, 0x06, 0xee, 0x6a, 0xc3, 0xa7, 0x21, 0x25, 0x41, 0x46, + 0x92, 0xe1, 0xca, 0xc5, 0xad, 0xd5, 0xa0, 0x0e, 0xd4, 0xc3, 0x86, 0x0e, + 0xfd, 0xac, 0x9c, 0x46, 0x96, 0x28, 0x61, 0xd4, 0x9f, 0xd7, 0xb1, 0x79, + 0x95, 0xf3, 0xbb, 0xdf, 0x9a, 0xd8, 0xbc, 0x21, 0xcf, 0xa3, 0xdb, 0xef, + 0x55, 0xd1, 0x84, 0xf8, 0x6e, 0xa2, 0x4b, 0x75, 0xad, 0x0a, 0xf2, 0xa4, + 0xa3, 0x0e, 0x1d, 0x29, 0x20, 0xcb, 0xe3, 0x7b, 0xa4, 0xe8, 0x8d, 0x6b, + 0xfc, 0x5b, 0x97, 0x94, 0x47, 0xcf, 0x75, 0x49, 0x2d, 0x03, 0x2c, 0xa5, + 0xaf, 0xa9, 0x31, 0x5b, 0x29, 0xa6, 0xbd, 0x29, 0xcd, 0xe5, 0x93, 0xa0, + 0xad, 0xeb, 0x4a, 0x14, 0x60, 0xf8, 0x10, 0x49, 0x96, 0x96, 0xbc, 0x90, + 0x8d, 0x71, 0x18, 0x30, 0x47, 0x75, 0x1b, 0xd2, 0xfe, 0x50, 0x5e, 0xc9, + 0x65, 0x50, 0xcf, 0xfa, 0xfe, 0xf6, 0x89, 0x2f, 0x5d, 0xf7, 0xef, 0x16, + 0xd3, 0x83, 0x8b, 0x3f, 0x37, 0x53, 0xd4, 0x40, 0xa1, 0x9f, 0x1b, 0x4d, + 0x1c, 0x2e, 0xdc, 0x40, 0xa5, 0x1a, 0x6f, 0xe9, 0x7b, 0x3a, 0x9f, 0x87, + 0xe8, 0x99, 0xc1, 0xed, 0x2c, 0x50, 0x9e, 0x01, 0x23, 0x06, 0x60, 0x24, + 0x25, 0xa2, 0x0d, 0x90, 0xa3, 0x89, 0x1f, 0x31, 0x9f, 0x4d, 0x13, 0x24, + 0x7d, 0x58, 0x09, 0xf8, 0x44, 0xe2, 0x6f, 0xc5, 0xb1, 0x31, 0x7c, 0x18, + 0xd2, 0xb8, 0xd8, 0x26, 0xd9, 0xff, 0x12, 0x80, 0xc6, 0x5e, 0x93, 0x0d, + 0xcd, 0x6e, 0x6b, 0xdb, 0x12, 0xe3, 0x16, 0xcd, 0xc5, 0x51, 0x04, 0xc5, + 0x86, 0x75, 0xf3, 0x14, 0xed, 0x11, 0x5a, 0xa8, 0x1b, 0x1a, 0xb6, 0xc1, + 0xa8, 0x1f, 0xca, 0x93, 0x5c, 0xb4, 0x41, 0xbd, 0x81, 0x16, 0xcd, 0x0a, + 0x2e, 0xc8, 0x93, 0x90, 0x57, 0x9c, 0xe2, 0xef, 0xea, 0x22, 0x0e, 0xeb, + 0x13, 0x2f, 0xcc, 0x9a, 0xbe, 0x88, 0x8e, 0xf3, 0x15, 0x08, 0x8a, 0xe8, + 0x72, 0x71, 0xc5, 0xca, 0x35, 0xeb, 0x47, 0xd2, 0x3a, 0x53, 0x30, 0x7c, + 0x5f, 0x51, 0xe3, 0x05, 0x64, 0x7e, 0x54, 0xe1, 0xbd, 0x48, 0x96, 0xb5, + 0xbb, 0x92, 0x35, 0x8f, 0xdc, 0xb8, 0xe6, 0xae, 0x68, 0xe1, 0x0a, 0x31, + 0xa6, 0x60, 0xb2, 0x8e, 0xe0, 0x93, 0x25, 0x07, 0x3b, 0x81, 0x75, 0x68, + 0x52, 0x25, 0x51, 0xed, 0xce, 0x15, 0x94, 0x6c, 0x49, 0x36, 0x79, 0x01, + 0x48, 0xdd, 0x0c, 0x41, 0xe8, 0x28, 0xe4, 0x15, 0xdf, 0x17, 0xb5, 0x01, + 0x42, 0x08, 0xfb, 0xe2, 0x25, 0x73, 0xf3, 0xcc, 0xa9, 0x5b, 0x0a, 0x81, + 0xa5, 0xce, 0x76, 0x2d, 0xc4, 0x10, 0xe9, 0x45, 0x4c, 0x76, 0x8b, 0xb7, + 0xc9, 0x0b, 0xaa, 0x66, 0x69, 0xa4, 0xe8, 0x4e, 0x74, 0x60, 0xca, 0xde, + 0x38, 0xad, 0xe1, 0x78, 0xfd, 0x76, 0x7d, 0xd1, 0x01, 0x70, 0x2e, 0x8a, + 0x6d, 0xe5, 0x6a, 0x13, 0x2c, 0xd4, 0x08, 0xc6, 0x24, 0xe6, 0xc2, 0xe2, + 0x4e, 0x91, 0x86, 0x66, 0x16, 0x11, 0x55, 0x41, 0x91, 0x2c, 0xa2, 0x07, + 0xd9, 0x5e, 0xff, 0xc5, 0x30, 0x34, 0x6d, 0x32, 0x06, 0xc4, 0x91, 0xc1, + 0x5a, 0x25, 0x68, 0x17, 0xfe, 0xbd, 0xb6, 0xb2, 0x67, 0xa3, 0xf6, 0xa7, + 0xcd, 0x26, 0x16, 0xfa, 0x98, 0xa3, 0xb2, 0xa8, 0xc1, 0x41, 0x47, 0xd0, + 0xf6, 0xd5, 0x89, 0x85, 0xff, 0x1b, 0x0f, 0x36, 0x3e, 0x53, 0x72, 0x14, + 0x88, 0x75, 0x75, 0x06, 0x61, 0x56, 0xe2, 0x95, 0xa7, 0x18, 0xcc, 0xf5, + 0x05, 0x8c, 0x75, 0xb0, 0xbc, 0x4c, 0xb6, 0x08, 0xd7, 0x24, 0x65, 0x1b, + 0x8f, 0xa6, 0xe2, 0xb3, 0x66, 0x03, 0x9e, 0x72, 0x68, 0x22, 0xb4, 0x25, + 0xaf, 0x20, 0x91, 0xc0, 0xbf, 0x65, 0x24, 0x9e, 0x23, 0xc3, 0xf7, 0x47, + 0x54, 0xd6, 0xf2, 0x58, 0xfc, 0x76, 0x9a, 0xab, 0x57, 0x14, 0xfb, 0x1c, + 0xc7, 0xed, 0x38, 0xcb, 0xa6, 0x20, 0x9a, 0x56, 0xc5, 0xe4, 0x3f, 0xc3, + 0x2e, 0x62, 0xc2, 0xec, 0x27, 0x71, 0x1b, 0xfb, 0x5a, 0x5e, 0xaa, 0x13, + 0x8b, 0xb2, 0xc4, 0x5c, 0x8f, 0x5f, 0x64, 0xce, 0xef, 0x63, 0x0e, 0x86, + 0x1c, 0x6c, 0x0c, 0xee, 0x12, 0xfd, 0x26, 0xf1, 0x72, 0x1a, 0xac, 0x30, + 0xce, 0x9c, 0x1f, 0x2d, 0x8d, 0x58, 0x39, 0x24, 0xac, 0x39, 0xb4, 0x65, + 0xaa, 0xd5, 0x84, 0x2f, 0x29, 0x88, 0xb4, 0xcc, 0x12, 0x79, 0x4f, 0x51, + 0xd3, 0x1c, 0x56, 0x83, 0xe0, 0x22, 0x7e, 0xc7, 0x9c, 0x7d, 0x8b, 0x3c, + 0xaa, 0x55, 0x65, 0x6e, 0xdf, 0x73, 0x92, 0x93, 0x95, 0xe6, 0x57, 0x32, + 0xbf, 0xed, 0xff, 0x53, 0x4a, 0x83, 0x96, 0xda, 0x8b, 0x4f, 0x0d, 0xf5, + 0x23, 0x64, 0x0d, 0xaa, 0x5a, 0xa7, 0x51, 0x32, 0x0c, 0x46, 0xad, 0xc2, + 0x70, 0x27, 0x4d, 0x3c, 0x45, 0x1b, 0x52, 0x8a, 0x13, 0x1d, 0x64, 0x92, + 0xdc, 0x82, 0x58, 0xbd, 0x3e, 0xbb, 0x0d, 0x25, 0x20, 0xbc, 0x09, 0xc0, + 0xa3, 0x04, 0xd6, 0x69, 0xcf, 0x35, 0x2c, 0x1a, 0xfa, 0xbc, 0x2d, 0x9a, + 0xa9, 0x9e, 0x31, 0x81, 0xd4, 0xa0, 0x91, 0x6a, 0x71, 0xd6, 0x1f, 0xbc, + 0x48, 0xc5, 0x72, 0xa4, 0xdf, 0x81, 0x73, 0x08, 0x1c, 0xee, 0xf5, 0x77, + 0x00, 0xdb, 0xa6, 0x82, 0x27, 0xc0, 0x13, 0x02, 0xa0, 0xdb, 0xcb, 0x6b, + 0x5d, 0x68, 0x2c, 0x56, 0xa0, 0x08, 0x7a, 0x2d, 0x08, 0x34, 0x9a, 0xe7, + 0x9d, 0x58, 0x7b, 0x93, 0xd0, 0x21, 0xb0, 0x2e, 0x71, 0x6a, 0x00, 0x21, + 0x40, 0xbb, 0x44, 0x8e, 0x20, 0xa7, 0x25, 0x46, 0xfd, 0x3c, 0x90, 0x92, + 0x92, 0x54, 0x4d, 0x33, 0x33, 0xa8, 0x21, 0x7d, 0x3f, 0xbc, 0x37, 0xb2, + 0x26, 0xdd, 0xb7, 0xd5, 0xbf, 0xc5, 0x6d, 0x4d, 0x5a, 0x5a, 0xf8, 0xd0, + 0xad, 0xd5, 0x09, 0x01, 0x89, 0x93, 0x2a, 0xf6, 0x16, 0xae, 0x5c, 0x2e, + 0xcc, 0xdb, 0x3a, 0x65, 0x88, 0xff, 0x91, 0x08, 0x26, 0x12, 0x24, 0xdc, + 0x17, 0xcd, 0x91, 0xf9, 0x3a, 0x70, 0xc9, 0x16, 0x37, 0x48, 0x1c, 0xeb, + 0xa5, 0x0b, 0x01, 0x86, 0x64, 0xed, 0x25, 0x83, 0xa8, 0x71, 0x41, 0xb2, + 0x95, 0xdf, 0xa3, 0x34, 0x09, 0x27, 0x04, 0xca, 0x98, 0x47, 0x61, 0xc0, + 0x28, 0x60, 0xad, 0x12, 0xd2, 0x2f, 0x68, 0xfc, 0x03, 0x6b, 0x31, 0xb4, + 0x5b, 0xcf, 0xc4, 0xd5, 0xbe, 0x4b, 0x97, 0xee, 0x92, 0x89, 0x2a, 0x21, + 0xd9, 0xfb, 0x7d, 0x8b, 0xef, 0xda, 0x8e, 0xac, 0xd8, 0xab, 0xd4, 0x12, + 0xcb, 0x07, 0xed, 0x28, 0x42, 0x62, 0x51, 0x57, 0x5b, 0xd9, 0x39, 0x12, + 0x16, 0xab, 0x5d, 0xd0, 0xc3, 0xcc, 0xf1, 0xdd, 0x03, 0xdd, 0xc3, 0x99, + 0x54, 0x77, 0xc7, 0xba, 0x79, 0x02, 0x91, 0x07, 0x34, 0xb1, 0x17, 0x92, + 0xee, 0xe2, 0x24, 0x80, 0x9a, 0x90, 0x7e, 0xe9, 0xef, 0x80, 0xf3, 0x0a, + 0x27, 0x0c, 0xa5, 0xff, 0x43, 0x13, 0x07, 0x04, 0xf3, 0x08, 0x6d, 0x21, + 0xc7, 0x43, 0xf5, 0xc7, 0xa9, 0xc4, 0xc0, 0x51, 0x66, 0x37, 0xe0, 0xbf, + 0x47, 0x92, 0x5f, 0x49, 0x64, 0x9a, 0x62, 0x04, 0x96, 0xa9, 0x45, 0xd5, + 0xfb, 0x92, 0x6c, 0x21, 0x01, 0x9e, 0x3c, 0xf3, 0x74, 0x85, 0xeb, 0x85, + 0x08, 0x80, 0x6a, 0xe7, 0x52, 0x2e, 0xf8, 0xc8, 0xab, 0x37, 0x30, 0x0e, + 0xdd, 0xbe, 0x06, 0x83, 0x02, 0x24, 0xf7, 0x35, 0xf4, 0x2a, 0x72, 0x25, + 0xb5, 0x89, 0x07, 0xeb, 0x1a, 0x99, 0x1d, 0x63, 0x9e, 0x7f, 0xb2, 0xed, + 0xe4, 0x52, 0x98, 0x0d, 0xa8, 0xc2, 0x5d, 0x97, 0x30, 0x69, 0x7a, 0x36, + 0x1c, 0xa8, 0x41, 0x87, 0x4b, 0x3e, 0x7e, 0xa9, 0xb2, 0xac, 0xc8, 0x58, + 0x83, 0x05, 0x9e, 0xe4, 0xe0, 0xf6, 0x05, 0xb5, 0x1a, 0x82, 0x28, 0x8f, + 0x7e, 0x67, 0x19, 0x7a, 0x2d, 0xa1, 0x55, 0x16, 0x46, 0x2b, 0x36, 0x8d, + 0x18, 0x14, 0x70, 0x4f, 0xaa, 0x5f, 0x42, 0x52, 0x97, 0x6f, 0xbe, 0xf3, + 0x94, 0x5e, 0xe3, 0x36, 0x96, 0xce, 0x47, 0x35, 0x75, 0x3e, 0x97, 0xe2, + 0x2a, 0x8b, 0xc3, 0x94, 0x38, 0x99, 0x64, 0x52, 0xaf, 0x3c, 0xbf, 0x54, + 0x10, 0x87, 0x74, 0x45, 0x92, 0xc7, 0x81, 0x01, 0xd3, 0x42, 0x6e, 0xe3, + 0x3d, 0xaf, 0xe2, 0x3b, 0xdc, 0xf4, 0x3f, 0xc4, 0x84, 0x47, 0x27, 0x46, + 0x21, 0x3e, 0x20, 0xea, 0xd4, 0x61, 0x33, 0xca, 0x55, 0xb6, 0xa2, 0x46, + 0xe7, 0x2c, 0xe4, 0x59, 0x95, 0x16, 0x83, 0xbe, 0x92, 0xdc, 0x15, 0xde, + 0xbb, 0x4d, 0x02, 0x4d, 0x93, 0xf2, 0x45, 0xb7, 0x9a, 0x78, 0x63, 0x55, + 0x08, 0xa2, 0x06, 0xb0, 0x1c, 0xe3, 0x70, 0xf6, 0x72, 0x76, 0x7a, 0xf4, + 0xc6, 0xbd, 0x9a, 0xef, 0x3d, 0xff, 0xba, 0x34, 0x41, 0x19, 0x7c, 0x83, + 0x5b, 0xa5, 0xa9, 0x63, 0xe0, 0x1d, 0x6c, 0x46, 0x0d, 0x22, 0x4c, 0x80, + 0xad, 0xf5, 0x64, 0x6e, 0x93, 0xd3, 0xdf, 0x0b, 0x07, 0x65, 0xe4, 0x83, + 0x3d, 0xd4, 0xc4, 0x6d, 0x9b, 0x52, 0xf9, 0xbf, 0x5f, 0x40, 0x68, 0x0c, + 0xff, 0xf8, 0x3d, 0x08, 0x03, 0x2b, 0x11, 0xd5, 0x4e, 0x1d, 0x00, 0x21, + 0x00, 0x1c, 0x00, 0x28, 0x00, 0x29, 0x00, 0x18, 0x00, 0x10, 0x00, 0x19, + 0x00, 0xe6, 0xaf, 0x8d, 0x95, 0xac, 0xcb, 0xd7, 0x4a, 0xf0, 0xa7, 0xaf, + 0xfa, 0x7f, 0xf2, 0x7c, 0x7d, 0x0b, 0x45, 0xb8, 0x11, 0x92, 0x5a, 0x93, + 0xe7, 0xd7, 0xf8, 0x04, 0x86, 0xcf, 0xe7, 0xcc, 0x56, 0xd1, 0xd1, 0xcf, + 0xe9, 0xab, 0x1b, 0xf1, 0x0a, 0xf6, 0xf1, 0x7c, 0x57, 0xeb, 0x16, 0x49, + 0xcd, 0x70, 0x6a, 0xd5, 0x71, 0x5e, 0xdc, 0xd5, 0xf9, 0xf2, 0x50, 0xde, + 0xb8, 0x87, 0x0d, 0x14, 0x7d, 0x3c, 0xca, 0x10, 0x48, 0x75, 0xcd, 0xd2, + 0x6d, 0xc6, 0xae, 0x0e, 0x51, 0xde, 0xa4, 0x92, 0xc5, 0x61, 0x55, 0xf7, + 0x83, 0x31, 0x98, 0x4a, 0x26, 0x26, 0x7c, 0x35, 0xcb, 0x4c, 0x71, 0x08, + 0x29, 0xa5, 0x6b, 0xe0, 0x4b, 0x9c, 0x93, 0xb4, 0x9d, 0x57, 0x99, 0xdd, + 0x53, 0x26, 0x5c, 0xc7, 0x62, 0xd6, 0xa2, 0x0a, 0xcd, 0x43, 0xa0, 0xa5, + 0xb6, 0xec, 0x61, 0xe1, 0x6a, 0xa3, 0x08, 0x8a, 0x61, 0x42, 0x66, 0xa9, + 0x6a, 0x38, 0xdc, 0x1b, 0x54, 0x84, 0x28, 0x6d, 0x5a, 0xce, 0x56, 0xf6, + 0x62, 0xdd, 0xe0, 0xe6, 0x8d, 0x13, 0x09, 0x95, 0x12, 0xcb, 0x53, 0xab, + 0x51, 0x56, 0x7c, 0x33, 0xe0, 0xba, 0xf7, 0xda, 0xaf, 0xd8, 0xcb, 0x88, + 0x8c, 0x37, 0x55, 0xf0, 0xe4, 0xb9, 0x33, 0x4b, 0x50, 0x8f, 0x2a, 0x69, + 0xaf, 0x2d, 0x57, 0x7c, 0xd7, 0xa1, 0x8d, 0x24, 0x76, 0xf3, 0x11, 0x57, + 0xe1, 0x94, 0x1a, 0x26, 0xa7, 0x6d, 0xb4, 0xb4, 0x67, 0x61, 0x54, 0x41, + 0xd5, 0x08, 0xb2, 0x8e, 0x55, 0x1d, 0x6e, 0x46, 0xd2, 0xbc, 0x49, 0xa5, + 0x04, 0x33, 0x7c, 0xeb, 0xec, 0x58, 0x96, 0xc7, 0xfa, 0x93, 0x3a, 0x94, + 0xee, 0x0b, 0x64, 0xf0, 0x44, 0x17, 0x9a, 0x01, 0x3b, 0x30, 0x8c, 0x48, + 0xbf, 0x8e, 0x00, 0x82, 0x91, 0xc8, 0xe9, 0xff, 0x3e, 0x9f, 0x27, 0x6c, + 0x89, 0x74, 0xeb, 0x45, 0x9e, 0x4c, 0x9d, 0x30, 0x10, 0x56, 0x2f, 0x39, + 0xb3, 0xe6, 0x1a, 0x10, 0xfc, 0x29, 0x30, 0x39, 0x10, 0x2e, 0xb0, 0x85, + 0xef, 0xcb, 0x5f, 0x44, 0xb7, 0xdf, 0x22, 0xec, 0xbb, 0xfb, 0xa4, 0xff, + 0xbc, 0xe8, 0x89, 0xe4, 0x33, 0x2d, 0xe6, 0x91, 0x63, 0x42, 0x17, 0x36, + 0xb8, 0xee, 0x68, 0x43, 0xd7, 0xd7, 0x69, 0x74, 0xe4, 0xe4, 0x33, 0x1d, + 0xa1, 0xea, 0xb9, 0x6e, 0x1f, 0x4c, 0xe2, 0xa1, 0xb8, 0x26, 0xcb, 0x95, + 0xc7, 0x44, 0x4d, 0xdd, 0xcc, 0xbb, 0x4f, 0xe1, 0xf5, 0xb9, 0xe4, 0x82, + 0x75, 0x51, 0x70, 0xa7, 0xea, 0x77, 0xd1, 0x55, 0xfc, 0x3b, 0x69, 0xa2, + 0xe3, 0xce, 0x86, 0xaf, 0x8e, 0xbc, 0x7b, 0xba, 0xe7, 0x31, 0x76, 0xe9, + 0x06, 0x2b, 0x63, 0x0d, 0xb0, 0xf4, 0x2f, 0x6e, 0xdf, 0xe2, 0xae, 0x35, + 0xae, 0x5f, 0x1c, 0x6f, 0xa1, 0xa3, 0x6b, 0x6b, 0x7a, 0xf6, 0x34, 0x03, + 0x7f, 0x2a, 0x36, 0xf8, 0x32, 0x77, 0xd9, 0xb2, 0x06, 0x88, 0xab, 0xdd, + 0x4d, 0xe8, 0xcb, 0xee, 0x59, 0x35, 0x37, 0x7c, 0x05, 0x02, 0x03, 0xb2, + 0x40, 0xaa, 0x92, 0x15, 0x40, 0xf4, 0xc6, 0x18, 0x03, 0x7b, 0x71, 0x70, + 0xa5, 0xbf, 0xa1, 0x78, 0x7a, 0xa4, 0xbb, 0xe5, 0xfb, 0xde, 0x02, 0x68, + 0xf5, 0x16, 0xf9, 0x61, 0x0b, 0xa7, 0x6f, 0xd5, 0x6e, 0x96, 0x9e, 0x49, + 0xd2, 0x7a, 0x95, 0x49, 0x76, 0x39, 0x27, 0xe4, 0x99, 0x6d, 0x87, 0x6d, + 0x68, 0x49, 0x53, 0x59, 0x27, 0xa5, 0xaa, 0x9b, 0xe6, 0x56, 0x38, 0xb7, + 0xdc, 0x40, 0x13, 0x23, 0xab, 0xa1, 0x2f, 0x46, 0x8c, 0x04, 0x3e, 0x49, + 0x68, 0x59, 0xcb, 0xba, 0x8e, 0x21, 0xf5, 0x88, 0x25, 0x7d, 0x97, 0x40, + 0x63, 0x5b, 0x14, 0xc7, 0x17, 0xc5, 0x99, 0x65, 0x7a, 0x9e, 0x8d, 0x88, + 0xc5, 0xa7, 0x30, 0x5c, 0x08, 0x49, 0xc4, 0x46, 0x27, 0x3b, 0xe0, 0x0b, + 0x43, 0x08, 0x92, 0x14, 0x16, 0x0d, 0x5e, 0x74, 0x89, 0x42, 0x52, 0xa7, + 0x5f, 0x6f, 0xc5, 0x4e, 0x13, 0xff, 0x98, 0x8e, 0x61, 0x7e, 0xb3, 0x6d, + 0xcd, 0xa2, 0xe4, 0x24, 0x25, 0xd1, 0xb4, 0x18, 0xd3, 0xd2, 0xe2, 0x6f, + 0x8a, 0x8d, 0x5a, 0x0f, 0xd6, 0x0d, 0xf3, 0xa0, 0x51, 0x0a, 0x8f, 0x5c, + 0x57, 0x6e, 0x81, 0x4c, 0x30, 0xe7, 0x69, 0x0c, 0x5b, 0x36, 0x69, 0x3e, + 0xfd, 0x51, 0xc6, 0x08, 0xf4, 0xa3, 0x72, 0x33, 0x38, 0xc2, 0xf3, 0x96, + 0x66, 0x17, 0xc2, 0x1e, 0x06, 0x96, 0xf3, 0x85, 0x3f, 0x71, 0x00, 0x27, + 0x1c, 0xe0, 0x56, 0x86, 0x3e, 0x25, 0x32, 0x36, 0xf9, 0x19, 0x15, 0x68, + 0xc9, 0x8d, 0x88, 0x2e, 0x3e, 0x3b, 0x84, 0x0d, 0x86, 0xa3, 0x94, 0xe7, + 0x3c, 0xda, 0x91, 0x04, 0xe9, 0xf2, 0x63, 0xca, 0xb9, 0x20, 0x0f, 0x6b, + 0xc6, 0x20, 0x08, 0x33, 0x78, 0x82, 0x85, 0xeb, 0xb7, 0x2a, 0x1e, 0x92, + 0x25, 0x69, 0x39, 0x64, 0x92, 0xfc, 0x12, 0x13, 0x57, 0xe5, 0xde, 0x11, + 0xad, 0x03, 0x6d, 0x72, 0x49, 0x34, 0x87, 0xb5, 0xba, 0xa5, 0xc5, 0x9a, + 0x0d, 0x13, 0x16, 0x06, 0xd3, 0x16, 0xbd, 0x25, 0x6a, 0x72, 0x0c, 0x84, + 0xf3, 0x94, 0x05, 0x90, 0x9c, 0x9d, 0xec, 0x68, 0x19, 0xc8, 0x26, 0x8e, + 0xd9, 0x99, 0x06, 0x5f, 0x24, 0xd6, 0x20, 0x0d, 0xe0, 0x72, 0x19, 0xdf, + 0x7b, 0x7e, 0xea, 0xcc, 0xc8, 0x23, 0x36, 0x37, 0x62, 0x56, 0x62, 0xc5, + 0x2a, 0x62, 0x6d, 0x08, 0xe0, 0x46, 0x4b, 0x07, 0xb8, 0x11, 0xe5, 0xb8, + 0xd6, 0xc1, 0x6a, 0x6b, 0xe5, 0x1a, 0xf0, 0x42, 0x3e, 0xd2, 0x6b, 0x8c, + 0x09, 0xb8, 0x8c, 0xf5, 0xb4, 0x58, 0x76, 0x8a, 0xbc, 0xa6, 0xd6, 0xee, + 0x81, 0x15, 0x64, 0x36, 0xd0, 0xd7, 0x1d, 0x4e, 0xa9, 0xd6, 0x6b, 0x6c, + 0xfa, 0x7a, 0xcc, 0xb8, 0x52, 0x36, 0x5d, 0xe0, 0x0b, 0xac, 0x91, 0xc6, + 0x61, 0x8f, 0x53, 0x49, 0x47, 0xbd, 0xd5, 0xb9, 0xbb, 0x2c, 0xc5, 0x43, + 0xe3, 0x97, 0xa4, 0xe0, 0x70, 0x43, 0x22, 0xa4, 0x35, 0x55, 0x61, 0x0d, + 0x43, 0x6e, 0xa4, 0xb0, 0xd8, 0xac, 0x6b, 0xb8, 0x14, 0x9b, 0x12, 0x44, + 0x9a, 0xcc, 0x4d, 0x27, 0x5e, 0x5c, 0x04, 0x0f, 0xa6, 0x42, 0x5e, 0x52, + 0x52, 0x2d, 0x16, 0xb6, 0x48, 0x81, 0xee, 0xf2, 0x1b, 0x2c, 0xac, 0x26, + 0x74, 0x90, 0x56, 0x6c, 0x23, 0x78, 0xeb, 0xc5, 0x1a, 0xd9, 0x37, 0x07, + 0x8b, 0x90, 0x90, 0xe1, 0xee, 0xba, 0x12, 0x8c, 0x70, 0x0c, 0x76, 0x13, + 0xba, 0xdd, 0xa2, 0xec, 0x32, 0xe4, 0x88, 0x19, 0x00, 0x7a, 0x2f, 0x18, + 0x93, 0x95, 0x25, 0x6a, 0x89, 0x80, 0x6a, 0x47, 0xbe, 0x02, 0x37, 0x21, + 0xaa, 0xea, 0x65, 0xca, 0xbc, 0x58, 0x1d, 0x28, 0x09, 0xae, 0xfd, 0xff, + 0x6f, 0xeb, 0x3f, 0x8a, 0x68, 0x21, 0xb1, 0x38, 0x36, 0xf3, 0xca, 0x8f, + 0xc6, 0x72, 0x78, 0xba, 0xbf, 0xdf, 0x90, 0xe8, 0x26, 0x6b, 0x90, 0xf7, + 0xba, 0x16, 0xe8, 0x41, 0xe7, 0x4a, 0x2b, 0xb1, 0xd3, 0x30, 0xbf, 0xc6, + 0x6c, 0xd4, 0xa7, 0xbe, 0xac, 0x90, 0xf4, 0xf7, 0xc5, 0x16, 0xd8, 0xb5, + 0x04, 0x45, 0xce, 0xbf, 0xd0, 0xe8, 0x5c, 0x31, 0x05, 0xc5, 0x2d, 0x32, + 0xcb, 0x9c, 0x64, 0x46, 0x16, 0xc6, 0x9b, 0x12, 0xe3, 0x17, 0x0c, 0x88, + 0x21, 0xe3, 0xe7, 0xc4, 0x29, 0x01, 0xa1, 0x28, 0x20, 0x17, 0x8f, 0x3c, + 0xf1, 0xad, 0x52, 0x02, 0xa9, 0xd5, 0x4e, 0x45, 0x1c, 0xf8, 0xd8, 0xab, + 0x2b, 0xd5, 0x6b, 0x96, 0x76, 0x62, 0x93, 0xb5, 0xac, 0x10, 0x88, 0xcf, + 0x15, 0x3d, 0x4b, 0x77, 0xb2, 0x15, 0xad, 0xd7, 0x10, 0x40, 0xb2, 0xd2, + 0x4a, 0x35, 0xcd, 0x46, 0x91, 0x0b, 0x30, 0x16, 0x87, 0x55, 0x85, 0xa0, + 0x52, 0x59, 0xac, 0x67, 0x42, 0x66, 0xd9, 0x86, 0xbf, 0xa5, 0x5f, 0x92, + 0x9b, 0x1c, 0x95, 0x23, 0x96, 0x10, 0xad, 0x1d, 0x4a, 0xc4, 0x48, 0x1a, + 0x33, 0x5e, 0x05, 0xec, 0x02, 0xf7, 0x40, 0x10, 0x96, 0x03, 0xcc, 0x3d, + 0x40, 0x78, 0x4f, 0xeb, 0x89, 0x00, 0x84, 0x23, 0x1f, 0x4a, 0x3d, 0x08, + 0xfc, 0x52, 0xe4, 0xcc, 0x01, 0x6e, 0x27, 0x0a, 0x59, 0x52, 0xe0, 0xdc, + 0x23, 0xf7, 0x43, 0x1c, 0x5b, 0xc1, 0x92, 0x46, 0x2b, 0xe9, 0x38, 0x4c, + 0x15, 0x9d, 0x8f, 0xe5, 0xf6, 0x07, 0x38, 0x1d, 0x24, 0x25, 0xf2, 0x34, + 0xe3, 0x9d, 0x06, 0x47, 0xc1, 0x7e, 0xc1, 0x28, 0xc7, 0x51, 0x41, 0x2b, + 0x72, 0xf1, 0x60, 0xcd, 0xed, 0x16, 0xc7, 0x9e, 0x81, 0x76, 0x4e, 0xcb, + 0xa2, 0x19, 0x00, 0xe9, 0xf5, 0x59, 0x1f, 0x15, 0xd9, 0xa2, 0x71, 0x19, + 0x0d, 0xb2, 0xe2, 0x2d, 0x5d, 0x5c, 0x67, 0x58, 0x2c, 0xa7, 0x97, 0x13, + 0xc9, 0x24, 0xee, 0xb1, 0x19, 0xe1, 0x0c, 0x7f, 0x21, 0xff, 0xd0, 0xb9, + 0xcb, 0xb0, 0xe6, 0x2b, 0x9a, 0xc8, 0x78, 0x56, 0x8a, 0x22, 0x19, 0xfc, + 0x2b, 0x72, 0xcb, 0x8b, 0xc2, 0xe3, 0xb8, 0xb5, 0x9c, 0x69, 0x63, 0xb4, + 0x8c, 0x88, 0x6c, 0x3d, 0xe8, 0x64, 0xc0, 0x22, 0x81, 0x09, 0x6b, 0xbf, + 0x6a, 0x88, 0x41, 0x54, 0x6d, 0x9c, 0x41, 0x20, 0x95, 0x10, 0xa9, 0x9a, + 0x5c, 0xd2, 0x12, 0xe1, 0xe1, 0x7f, 0x56, 0xb6, 0x88, 0xd4, 0x15, 0x9d, + 0xdc, 0x51, 0x9a, 0x7b, 0x53, 0x53, 0x70, 0xb9, 0xb1, 0x40, 0x97, 0x0a, + 0x73, 0x91, 0x4d, 0x76, 0x47, 0x72, 0xe8, 0xb3, 0xb7, 0x27, 0x49, 0xcd, + 0xa6, 0x5c, 0xbc, 0x42, 0xf5, 0xdf, 0x28, 0xdb, 0x3d, 0xaa, 0xd1, 0x55, + 0xc6, 0xae, 0x38, 0x38, 0x46, 0xa1, 0x52, 0xd5, 0xda, 0x62, 0x28, 0xad, + 0x84, 0xad, 0x16, 0x88, 0x7f, 0xdc, 0xbe, 0x10, 0x5f, 0x2e, 0x29, 0x5e, + 0x13, 0xdb, 0x26, 0x9b, 0xa7, 0xdd, 0x21, 0x36, 0x77, 0x51, 0x6a, 0x88, + 0xdf, 0x36, 0x15, 0xa2, 0xcf, 0x8d, 0x2b, 0x59, 0xcb, 0xa2, 0x2d, 0x1f, + 0x32, 0xef, 0xa5, 0xd0, 0x27, 0x55, 0x12, 0x4e, 0x58, 0xc8, 0xad, 0xe2, + 0xef, 0xfb, 0x15, 0x10, 0x8d, 0xad, 0x24, 0x75, 0x69, 0x8e, 0xb9, 0x53, + 0xd2, 0x52, 0x1e, 0x32, 0x76, 0xaf, 0x6c, 0x77, 0xa3, 0x95, 0x93, 0xeb, + 0xb3, 0xd9, 0x9a, 0xf0, 0x71, 0xea, 0x83, 0xf5, 0xbc, 0x6b, 0xde, 0xdc, + 0xa6, 0x63, 0x43, 0x8b, 0xb9, 0xa4, 0x23, 0x1d, 0x7a, 0x30, 0x81, 0x08, + 0x39, 0x38, 0x6c, 0xf7, 0xe0, 0x34, 0x69, 0x2a, 0xf0, 0x4f, 0x16, 0xdc, + 0x78, 0xb4, 0xb1, 0x1f, 0xa9, 0xdd, 0x03, 0xec, 0x84, 0xb7, 0x86, 0x30, + 0xb0, 0xa2, 0xca, 0x83, 0xb5, 0x68, 0x0c, 0x3d, 0xc1, 0x9e, 0xe2, 0xa7, + 0x66, 0x79, 0xfb, 0xdc, 0xe0, 0x5e, 0x03, 0x52, 0xba, 0x0a, 0xce, 0xc5, + 0x78, 0x44, 0xe8, 0xc8, 0x67, 0x82, 0x25, 0xd8, 0xe0, 0x93, 0xff, 0xbb, + 0xb0, 0xb8, 0x85, 0xa7, 0xf1, 0xf2, 0xc2, 0xeb, 0x7e, 0xb9, 0xf4, 0x3e, + 0xd5, 0x38, 0xd2, 0x53, 0x2c, 0xc9, 0x2d, 0xfc, 0xc4, 0x61, 0xba, 0x57, + 0x1c, 0xf7, 0x39, 0xc8, 0x39, 0xbe, 0x42, 0x43, 0x8d, 0x5f, 0xb5, 0x0b, + 0x48, 0x3f, 0x26, 0x19, 0x89, 0x54, 0xb9, 0xaa, 0xbb, 0x09, 0x9a, 0x4c, + 0x82, 0x47, 0xe9, 0x7b, 0x9b, 0x27, 0x19, 0x90, 0x6a, 0x87, 0x6a, 0x75, + 0xf4, 0x05, 0x0f, 0xe5, 0x06, 0x4b, 0xa4, 0xdb, 0x07, 0x72, 0x9e, 0x14, + 0xab, 0x9a, 0x3e, 0x0e, 0x36, 0x6f, 0x4f, 0xe5, 0x16, 0x91, 0x1d, 0x1d, + 0xf7, 0x51, 0x92, 0x8a, 0x5c, 0x64, 0x1d, 0x3f, 0x06, 0xff, 0x85, 0xb0, + 0xe8, 0x89, 0x52, 0xd3, 0x3f, 0x43, 0x2c, 0x2b, 0x67, 0x51, 0x94, 0x72, + 0xa5, 0xfa, 0x02, 0x60, 0x44, 0xad, 0xfd, 0x96, 0xbe, 0xc2, 0xd6, 0x2e, + 0xda, 0xf6, 0xc9, 0x13, 0x84, 0x10, 0x58, 0x8d, 0xe9, 0x82, 0x20, 0xca, + 0x07, 0xd8, 0x30, 0x40, 0x86, 0x72, 0x5b, 0xab, 0x64, 0x23, 0x99, 0x4b, + 0x21, 0x75, 0x49, 0xf2, 0xd5, 0x5e, 0x2b, 0x14, 0x59, 0xb8, 0x96, 0x4d, + 0x27, 0x92, 0x81, 0x60, 0xe9, 0x33, 0x98, 0x6b, 0x8e, 0x9e, 0x81, 0x17, + 0x72, 0x4a, 0x53, 0x6c, 0xb6, 0x38, 0x5f, 0x13, 0xd4, 0xcf, 0x67, 0xbf, + 0x77, 0x8f, 0xdf, 0x26, 0x96, 0x8c, 0xfb, 0x89, 0x15, 0xd6, 0x41, 0x75, + 0xea, 0x94, 0x66, 0x5c, 0x67, 0x09, 0x4a, 0xda, 0xca, 0x24, 0x0d, 0x08, + 0x54, 0xcd, 0x10, 0x3f, 0xa5, 0x1f, 0x35, 0x75, 0x01, 0x90, 0xff, 0x7a, + 0xde, 0x2e, 0xaa, 0x2e, 0x57, 0x8a, 0xae, 0x69, 0x90, 0x3e, 0x94, 0x72, + 0x5e, 0x9c, 0x68, 0x63, 0x4c, 0xc1, 0xd0, 0x64, 0x2a, 0x37, 0x20, 0xc3, + 0x16, 0xf1, 0x86, 0x5a, 0x02, 0x59, 0xc8, 0x9f, 0x04, 0x68, 0x58, 0x82, + 0xb5, 0x3e, 0x85, 0x1b, 0x0b, 0x83, 0x04, 0x0e, 0x82, 0x9c, 0x25, 0xe4, + 0x55, 0x5e, 0xe3, 0x3e, 0xd0, 0x77, 0xf9, 0x07, 0x63, 0x06, 0x20, 0x81, + 0xa7, 0x76, 0x79, 0x3c, 0x58, 0x26, 0xc7, 0x22, 0x32, 0xb6, 0x2f, 0xd3, + 0x8c, 0xee, 0x62, 0x69, 0x20, 0xc6, 0xc4, 0x2a, 0x61, 0x1e, 0xa9, 0xde, + 0xec, 0x8c, 0xde, 0x44, 0xc4, 0x2a, 0xef, 0x46, 0xf8, 0xcf, 0x7d, 0xd8, + 0x4f, 0x2e, 0x6c, 0x2f, 0x94, 0xad, 0x15, 0x2c, 0x3d, 0x84, 0x73, 0x3d, + 0xc3, 0x6e, 0x9f, 0x14, 0xb3, 0x45, 0x9a, 0x89, 0xf5, 0x44, 0x11, 0x0d, + 0x69, 0x08, 0x49, 0x2e, 0xf4, 0x31, 0xcb, 0xf2, 0xd3, 0x45, 0xea, 0xdd, + 0xe2, 0xba, 0xad, 0x2d, 0x68, 0x97, 0xf1, 0xb4, 0x3a, 0x1c, 0x10, 0x55, + 0x86, 0x58, 0x0f, 0xd8, 0x13, 0x27, 0x6b, 0xd9, 0x1c, 0xfc, 0xba, 0x68, + 0x86, 0x4f, 0x92, 0x43, 0x89, 0x26, 0xa8, 0x79, 0xdc, 0x80, 0xee, 0x49, + 0xe4, 0x17, 0x29, 0xcf, 0x16, 0xef, 0x8f, 0x94, 0xb9, 0xfa, 0x44, 0x74, + 0x90, 0x79, 0x9f, 0xef, 0x66, 0x91, 0x27, 0x23, 0xc9, 0xb0, 0xd2, 0x05, + 0x62, 0x25, 0xc9, 0x92, 0xb8, 0x8e, 0x44, 0x92, 0xdc, 0xc7, 0x09, 0xdb, + 0x4a, 0xf7, 0x72, 0x1d, 0xb6, 0x97, 0xfc, 0x65, 0x3b, 0x2c, 0xe2, 0x30, + 0x94, 0x86, 0xa0, 0xf3, 0xc1, 0x2d, 0xdf, 0x9f, 0x9b, 0x4c, 0x2a, 0x40, + 0x17, 0x36, 0xb0, 0x01, 0xcf, 0x54, 0x2d, 0xcf, 0x94, 0x56, 0xfb, 0x89, + 0xb3, 0xc4, 0x87, 0x85, 0x8c, 0x5c, 0x20, 0x1f, 0x09, 0x35, 0x0d, 0xf6, + 0xc3, 0x0c, 0xc9, 0xa2, 0x71, 0x19, 0x0c, 0x26, 0xf7, 0x3c, 0x7c, 0x54, + 0x38, 0x99, 0x26, 0xfb, 0x9c, 0x9a, 0x31, 0x58, 0xa9, 0x10, 0x4b, 0x1b, + 0xff, 0xf8, 0x3d, 0x08, 0x04, 0x2b, 0x11, 0xc3, 0x48, 0xf0, 0x00, 0xed, + 0x00, 0xf7, 0x00, 0xfc, 0x00, 0xfa, 0x00, 0xe7, 0x7c, 0x71, 0x00, 0xba, + 0xa0, 0x80, 0x05, 0x78, 0xff, 0xc0, 0xe8, 0xe2, 0x19, 0x50, 0x57, 0xc0, + 0xaa, 0x81, 0x4a, 0x01, 0x4a, 0x00, 0xb9, 0x47, 0x14, 0x8f, 0x25, 0x70, + 0x3b, 0x41, 0xd0, 0x97, 0x8d, 0x0d, 0x66, 0xb9, 0x06, 0x83, 0x28, 0x9f, + 0x1d, 0xca, 0x46, 0xb1, 0x1f, 0xbc, 0xb2, 0xe8, 0x86, 0x52, 0x30, 0x4e, + 0xd0, 0xb2, 0x65, 0xcd, 0x3e, 0xb9, 0xef, 0xc1, 0xa6, 0x5b, 0xe4, 0xf2, + 0x62, 0xfe, 0xa0, 0x6b, 0x49, 0x45, 0xc5, 0xbd, 0xb3, 0x85, 0x7e, 0xb9, + 0x8a, 0xf8, 0x44, 0x01, 0xc1, 0x09, 0x34, 0xf4, 0x0c, 0xdc, 0x8a, 0x82, + 0xbb, 0x20, 0xe0, 0x45, 0x03, 0x43, 0x17, 0xd1, 0xcb, 0x0c, 0x88, 0x38, + 0xa3, 0xeb, 0x3e, 0xe7, 0x58, 0x60, 0xe2, 0x98, 0x1f, 0x9a, 0x5e, 0x45, + 0xb6, 0x04, 0xf6, 0x59, 0xc6, 0x6c, 0x45, 0xfc, 0x47, 0xfc, 0x54, 0xed, + 0xef, 0xe2, 0x6f, 0xb3, 0x0d, 0xb6, 0x2f, 0x8e, 0x0a, 0x26, 0x9a, 0x6b, + 0xb5, 0x2a, 0x20, 0xdf, 0xf8, 0xfb, 0xef, 0xd7, 0x03, 0x8a, 0x0c, 0x4e, + 0xc2, 0x75, 0x79, 0x56, 0xe9, 0xda, 0x08, 0xb2, 0x79, 0x4e, 0x59, 0xfd, + 0xa0, 0xd7, 0x49, 0x0d, 0x44, 0x9b, 0x84, 0x29, 0xcd, 0xc7, 0x6f, 0xf2, + 0xef, 0x2e, 0x15, 0x6b, 0x8a, 0x26, 0x18, 0x56, 0x28, 0x75, 0xca, 0x97, + 0xe9, 0x88, 0xbe, 0x8e, 0x96, 0x84, 0xad, 0xad, 0xd9, 0xf7, 0x4a, 0x2f, + 0xeb, 0x4b, 0xc9, 0x57, 0xf9, 0x07, 0x09, 0xd3, 0x49, 0xb7, 0xe6, 0x17, + 0x9a, 0x16, 0x41, 0xec, 0xd3, 0xce, 0x74, 0x55, 0x96, 0x5e, 0xd2, 0xaa, + 0x34, 0x16, 0x3f, 0x97, 0x1b, 0x3b, 0x49, 0x0c, 0xcf, 0xb3, 0x25, 0xc5, + 0x30, 0x0a, 0x4d, 0x89, 0x13, 0x90, 0xee, 0x4a, 0xc6, 0xa7, 0x2b, 0x6d, + 0x29, 0x24, 0x9c, 0xca, 0xc7, 0x90, 0x8a, 0x73, 0xb4, 0x20, 0x0c, 0xd5, + 0x81, 0xd6, 0xe0, 0x81, 0x86, 0x24, 0xf2, 0x67, 0xc7, 0x7c, 0xee, 0x4c, + 0x22, 0x3d, 0xc0, 0x09, 0x10, 0x4a, 0x08, 0xfd, 0x06, 0x93, 0x92, 0xa5, + 0x2b, 0x2d, 0xe8, 0xd3, 0x4d, 0xea, 0xf0, 0x1f, 0x39, 0x58, 0x9a, 0x2d, + 0x8a, 0x2c, 0x1e, 0x9e, 0x85, 0x3a, 0xf1, 0x13, 0xc1, 0xcd, 0xac, 0x23, + 0x11, 0x4d, 0xa6, 0x85, 0x35, 0x50, 0xe1, 0xe5, 0x22, 0x3e, 0xd8, 0x75, + 0x0d, 0x6d, 0x31, 0xb8, 0x5d, 0xf1, 0xe1, 0x7a, 0x94, 0xb4, 0x9d, 0x09, + 0x53, 0x47, 0xdb, 0x25, 0x8b, 0xf8, 0x23, 0xe3, 0x79, 0x5a, 0x22, 0xeb, + 0x50, 0x81, 0x7d, 0x3a, 0xc0, 0xd0, 0x32, 0x66, 0x6e, 0x25, 0xa5, 0xcc, + 0xe2, 0x90, 0x70, 0xb4, 0x42, 0x7c, 0x41, 0xac, 0x48, 0xfc, 0x04, 0x88, + 0x71, 0x35, 0xf1, 0xa1, 0x0b, 0x52, 0x93, 0x48, 0x51, 0x90, 0xab, 0xe1, + 0xca, 0xf6, 0xb8, 0xeb, 0x47, 0x36, 0x61, 0xa4, 0x36, 0x40, 0x64, 0x0f, + 0x94, 0xfa, 0x3d, 0xf9, 0xb1, 0xa5, 0xe1, 0x7e, 0xa0, 0x48, 0xb9, 0x1a, + 0x33, 0x31, 0xc0, 0x61, 0x48, 0x59, 0x83, 0xfb, 0xc8, 0xd0, 0x99, 0x9f, + 0x02, 0xa1, 0x5c, 0x67, 0xbb, 0x43, 0x66, 0x37, 0x67, 0x1b, 0x14, 0x5a, + 0x2e, 0xbb, 0xe6, 0x92, 0x3b, 0x5e, 0x0a, 0xfb, 0x5a, 0x37, 0x05, 0x55, + 0xd8, 0xf3, 0x6d, 0x9a, 0x8f, 0xbf, 0xa2, 0xcc, 0x30, 0x53, 0x15, 0xfa, + 0x53, 0xb2, 0x7b, 0xc2, 0x69, 0x87, 0x97, 0x61, 0xf8, 0x6a, 0x8f, 0x6e, + 0xed, 0x55, 0x48, 0x21, 0xb3, 0xab, 0x07, 0xf2, 0x4a, 0xdf, 0x4b, 0x46, + 0xc8, 0x76, 0x60, 0xab, 0x4a, 0x89, 0xa7, 0xd2, 0xd3, 0xa2, 0xfb, 0x18, + 0xa9, 0xc4, 0xc4, 0x04, 0x3c, 0x5e, 0x91, 0x11, 0x78, 0xf1, 0x11, 0x07, + 0xdc, 0x8c, 0x7d, 0xf5, 0x5e, 0x94, 0xfa, 0xde, 0x6b, 0x8e, 0x61, 0xa6, + 0x8a, 0x82, 0x53, 0x2a, 0x04, 0xff, 0xf0, 0x37, 0xf3, 0x7e, 0x44, 0x8c, + 0x82, 0x03, 0x11, 0x3f, 0x89, 0xcb, 0x15, 0xa6, 0x04, 0x78, 0x8a, 0x6d, + 0xda, 0xe1, 0x8d, 0x7d, 0xdb, 0x41, 0xfa, 0x1a, 0x03, 0x4f, 0x6c, 0x33, + 0xe7, 0x86, 0x62, 0x9e, 0xdf, 0xaf, 0x96, 0x1c, 0x46, 0xe2, 0xcb, 0x6c, + 0xed, 0xde, 0x54, 0xbd, 0xb8, 0x6b, 0x3d, 0x76, 0x43, 0xac, 0xa1, 0xb2, + 0x41, 0xaf, 0x6e, 0x1f, 0xb5, 0xa4, 0x4d, 0x18, 0xa6, 0x12, 0x3e, 0xc3, + 0xbe, 0x2f, 0x0b, 0x87, 0xfc, 0xbb, 0xae, 0xdb, 0xf1, 0x88, 0xad, 0xa6, + 0x74, 0x4f, 0x3e, 0xcb, 0x27, 0xac, 0x0c, 0xd3, 0xf0, 0x56, 0xcc, 0x7b, + 0x25, 0x6c, 0xec, 0x16, 0xc8, 0x81, 0x35, 0xc4, 0x2d, 0x2d, 0x16, 0xa6, + 0xe2, 0xf3, 0x53, 0x1c, 0x93, 0x79, 0x3c, 0xed, 0xa5, 0xf6, 0x4c, 0x66, + 0x7a, 0x48, 0xfa, 0xa7, 0x8c, 0x4b, 0xe7, 0x8e, 0xd5, 0xe5, 0x3f, 0x01, + 0x09, 0xb6, 0xd8, 0x63, 0xd9, 0x5b, 0x02, 0xf4, 0x5e, 0x5a, 0x32, 0xc9, + 0x51, 0x05, 0x78, 0x48, 0x9e, 0x32, 0x84, 0x2a, 0xeb, 0x2e, 0x85, 0x4d, + 0xf8, 0x5a, 0x3f, 0x20, 0x35, 0x6f, 0x0a, 0xd0, 0xc2, 0xcf, 0xd9, 0xd2, + 0x6b, 0x2b, 0xa4, 0xc9, 0xe0, 0xe4, 0xa5, 0x8f, 0xaa, 0x84, 0x68, 0x44, + 0x45, 0x5b, 0x2b, 0xae, 0xc9, 0xd5, 0x15, 0x94, 0x3e, 0xa1, 0x9d, 0xdf, + 0x7d, 0xc7, 0xa6, 0x28, 0xba, 0xd7, 0xa2, 0xaa, 0xaf, 0xa2, 0xac, 0xb5, + 0xd4, 0x55, 0x8d, 0x0c, 0xea, 0x1a, 0x13, 0x66, 0x9d, 0xf1, 0xeb, 0x9b, + 0x41, 0x20, 0x84, 0xbb, 0x1f, 0xf2, 0x4a, 0x6a, 0xe8, 0xd5, 0x57, 0x1d, + 0x23, 0xa8, 0xaf, 0x39, 0x83, 0x0f, 0x46, 0xd6, 0xee, 0xde, 0x97, 0xf4, + 0x16, 0x86, 0xac, 0x5c, 0xac, 0x98, 0xcd, 0xa5, 0x79, 0xbe, 0x51, 0x2f, + 0xfe, 0x8d, 0x7b, 0x74, 0x98, 0xe6, 0x6b, 0x8f, 0xd5, 0x32, 0x42, 0x6c, + 0xa3, 0xbb, 0xd4, 0x62, 0x9a, 0xb5, 0xdb, 0xb5, 0x28, 0xdc, 0x95, 0xa7, + 0x6b, 0xc7, 0x6e, 0x65, 0xcc, 0x7a, 0x68, 0x57, 0x69, 0x91, 0x3d, 0xa2, + 0x6d, 0xb4, 0x51, 0x1b, 0x51, 0x89, 0x2b, 0xcf, 0xc1, 0xd1, 0x0a, 0x54, + 0x9e, 0x1b, 0xb2, 0x89, 0x89, 0xbc, 0x91, 0xb8, 0xae, 0xe7, 0x9e, 0x43, + 0x9c, 0xc4, 0xa9, 0x0e, 0xed, 0xda, 0xa2, 0x8d, 0x70, 0x38, 0xd9, 0x8c, + 0x0f, 0x01, 0xe7, 0x58, 0x8f, 0x02, 0xe5, 0x40, 0x22, 0xcd, 0x64, 0xa6, + 0xd6, 0x53, 0xa1, 0xed, 0x6a, 0x12, 0xd6, 0xfe, 0x02, 0xb9, 0x4e, 0x07, + 0x1e, 0x00, 0xd8, 0x1e, 0x50, 0xd8, 0xb3, 0xc1, 0x61, 0x18, 0xbb, 0x5b, + 0x76, 0x37, 0xc1, 0x4f, 0x64, 0xd7, 0xbd, 0xca, 0x00, 0xbf, 0x1b, 0x90, + 0xf0, 0x39, 0x4c, 0x06, 0x8e, 0x31, 0x9b, 0x53, 0x5b, 0xf0, 0xc7, 0x71, + 0xbf, 0xc6, 0x44, 0xfc, 0x57, 0xa0, 0x8a, 0x03, 0xce, 0xb1, 0x23, 0xe9, + 0xd0, 0xdc, 0x95, 0xea, 0xf9, 0xbf, 0x31, 0x9b, 0xa8, 0x0e, 0x44, 0xf4, + 0x8f, 0xc8, 0x64, 0x85, 0x60, 0x83, 0x29, 0x09, 0x53, 0x06, 0xbf, 0x4b, + 0x83, 0xf8, 0xea, 0x0e, 0xcf, 0xfd, 0xae, 0x12, 0xc0, 0xd0, 0x02, 0x3a, + 0x63, 0xe0, 0x34, 0x27, 0xa3, 0x0a, 0x0a, 0x40, 0xe2, 0xf3, 0xd8, 0x56, + 0x49, 0x1a, 0x12, 0x55, 0x8e, 0x7d, 0xda, 0x06, 0x10, 0x65, 0x87, 0x4c, + 0x60, 0x08, 0xca, 0x27, 0x13, 0x05, 0x13, 0x1b, 0x3e, 0x25, 0x00, 0x2a, + 0xa0, 0x49, 0x1f, 0x3d, 0x50, 0xa7, 0xb4, 0x40, 0xa1, 0xa9, 0x86, 0xd2, + 0xca, 0x2d, 0x50, 0xe7, 0x2e, 0xae, 0x1a, 0xc8, 0x49, 0x81, 0x02, 0x17, + 0xbe, 0x9c, 0x93, 0x63, 0xdb, 0xfc, 0x0f, 0x96, 0xaf, 0xf1, 0x9b, 0x2b, + 0x34, 0xff, 0x79, 0xc6, 0x13, 0x5d, 0x7a, 0x73, 0x61, 0x1d, 0xde, 0x54, + 0x83, 0xbb, 0x97, 0xe7, 0x3c, 0x5d, 0x1d, 0xda, 0x3c, 0xa2, 0x43, 0x7a, + 0x5e, 0x92, 0x77, 0x8d, 0xb0, 0xaf, 0x10, 0x82, 0xeb, 0x56, 0x58, 0x6a, + 0xed, 0x63, 0xee, 0x99, 0xff, 0xeb, 0xf2, 0xc7, 0xb5, 0x92, 0x5d, 0x77, + 0x45, 0xa6, 0x7f, 0xd3, 0xea, 0x4b, 0x08, 0xcb, 0x89, 0xd9, 0x6e, 0xc7, + 0xe5, 0xd0, 0x90, 0xde, 0x39, 0xd1, 0xaa, 0x86, 0xc8, 0x83, 0x48, 0x1b, + 0xab, 0x83, 0xcc, 0xb3, 0x82, 0x92, 0xc8, 0xf6, 0x82, 0x50, 0x26, 0x7e, + 0xf0, 0xa3, 0xfe, 0x05, 0x57, 0xe0, 0x74, 0xcc, 0x1b, 0x22, 0x2d, 0x5e, + 0xbf, 0xac, 0x51, 0x91, 0x9a, 0xea, 0x35, 0xfc, 0x57, 0x4d, 0x48, 0x55, + 0xb7, 0x10, 0x8f, 0x5e, 0x75, 0x81, 0x3f, 0x6d, 0xd9, 0x97, 0x86, 0x52, + 0xe4, 0xb8, 0x27, 0xe7, 0x30, 0xf9, 0xf6, 0xb7, 0xa1, 0x08, 0x3c, 0x32, + 0x9c, 0x86, 0x47, 0x6d, 0x45, 0xb6, 0x7d, 0x04, 0x8e, 0xfa, 0xbb, 0x3c, + 0x39, 0x11, 0x8c, 0x51, 0x0f, 0xcc, 0xdc, 0x26, 0x6a, 0xae, 0x35, 0xa7, + 0x03, 0x79, 0x30, 0x45, 0x15, 0xec, 0xb7, 0xb7, 0x99, 0x5b, 0xe6, 0x87, + 0x34, 0x60, 0xe1, 0x35, 0x52, 0x0a, 0xdd, 0x3a, 0x1a, 0x18, 0xb7, 0x25, + 0x5a, 0x2e, 0x77, 0x04, 0x51, 0x31, 0x29, 0x36, 0x49, 0xb5, 0x03, 0x63, + 0x1c, 0x04, 0xa0, 0x3f, 0x10, 0xa9, 0x1c, 0xd2, 0xf7, 0xb6, 0x44, 0x5c, + 0x2d, 0x5c, 0x96, 0x3b, 0x1c, 0x6d, 0x8c, 0x95, 0x15, 0xf3, 0xc3, 0x27, + 0x24, 0x43, 0xf4, 0x53, 0xe5, 0x8b, 0xf8, 0x0d, 0x06, 0xcc, 0x37, 0xec, + 0x45, 0x12, 0xaf, 0x23, 0xc8, 0x55, 0xe8, 0x9b, 0x53, 0x3a, 0x08, 0x8c, + 0x8d, 0x71, 0x36, 0xe4, 0x71, 0xaa, 0x62, 0xab, 0x41, 0xa1, 0x7f, 0x2c, + 0x03, 0xcf, 0x5b, 0x08, 0x41, 0x45, 0xba, 0x74, 0x3d, 0xbf, 0x09, 0x65, + 0x5d, 0x7c, 0x41, 0xa5, 0x80, 0x39, 0xa8, 0xef, 0x23, 0xb9, 0x80, 0x49, + 0x67, 0x22, 0x3f, 0x0f, 0x6c, 0x48, 0xe1, 0x90, 0x08, 0xf4, 0x5c, 0xe0, + 0xf9, 0x16, 0xd8, 0x91, 0xc6, 0x41, 0x2d, 0x8a, 0x3f, 0x1c, 0xaf, 0x2a, + 0xaa, 0x3c, 0x83, 0x59, 0xbf, 0xea, 0x38, 0xe1, 0xe0, 0xb7, 0x11, 0x32, + 0x70, 0x7f, 0x0d, 0x90, 0xcc, 0x1c, 0xe3, 0xb2, 0x45, 0xd2, 0xba, 0x98, + 0xbb, 0xbc, 0x07, 0x9b, 0xaa, 0x1b, 0x0a, 0xe7, 0x1c, 0x87, 0x5f, 0x1e, + 0xf9, 0xf2, 0xd8, 0xa3, 0x86, 0x07, 0x4b, 0x20, 0xb3, 0x15, 0x68, 0x37, + 0xb5, 0xb5, 0xfc, 0xe6, 0x42, 0x42, 0x31, 0x1b, 0x44, 0xb4, 0xf8, 0x8a, + 0xf2, 0x0a, 0x07, 0x28, 0x26, 0x5a, 0x0b, 0xb6, 0x1d, 0x0b, 0xf9, 0x17, + 0xd1, 0x1d, 0x9b, 0x68, 0xc7, 0x3c, 0x04, 0xaa, 0xcd, 0x89, 0x08, 0xd2, + 0xc4, 0x18, 0xf5, 0x6b, 0x54, 0x5a, 0xc5, 0x00, 0x29, 0xb9, 0xa7, 0x47, + 0x08, 0xa6, 0x94, 0x75, 0xcf, 0x30, 0x11, 0x9a, 0x4b, 0xfd, 0xf0, 0x9f, + 0x3e, 0xc2, 0x52, 0x04, 0xe9, 0xe0, 0x48, 0x9d, 0xf1, 0xdc, 0xb6, 0x4c, + 0xd6, 0x87, 0xd3, 0x1f, 0x31, 0xe6, 0x04, 0x23, 0xb8, 0x8c, 0xc7, 0x5a, + 0x88, 0xbd, 0x7a, 0x99, 0x80, 0xbb, 0x33, 0xd4, 0xaf, 0x59, 0xeb, 0xea, + 0xf8, 0xdc, 0x6a, 0xdf, 0xe9, 0x7d, 0xa1, 0x16, 0x92, 0x84, 0x38, 0x4d, + 0x91, 0x4f, 0xa7, 0xa2, 0x62, 0xcc, 0x06, 0x46, 0x34, 0x9d, 0xca, 0xe5, + 0x22, 0x60, 0x49, 0xc6, 0x64, 0x19, 0x97, 0xd4, 0xd1, 0x40, 0xd9, 0x02, + 0xf1, 0xb4, 0x3e, 0x91, 0xf3, 0x3e, 0x98, 0x66, 0xe4, 0x1f, 0x15, 0xce, + 0xc6, 0x47, 0x77, 0xb2, 0x21, 0xa3, 0x50, 0xbf, 0xef, 0x1b, 0xa6, 0xc7, + 0x14, 0x43, 0xac, 0x65, 0xe4, 0x51, 0x8e, 0xf4, 0x10, 0xe4, 0xbb, 0xd4, + 0x45, 0xac, 0xe5, 0x05, 0x69, 0xc4, 0x6d, 0x1e, 0x42, 0x0f, 0x8c, 0xc5, + 0xa2, 0x89, 0x1a, 0xdc, 0x97, 0x2d, 0x6c, 0x8a, 0xc6, 0x43, 0xcb, 0x45, + 0x3a, 0x71, 0x7e, 0x96, 0x45, 0x29, 0x57, 0xff, 0x5c, 0x91, 0x15, 0xf5, + 0x4a, 0x39, 0x7e, 0x43, 0x67, 0xac, 0x48, 0xb3, 0xdc, 0x14, 0xd4, 0xac, + 0xc0, 0xc4, 0x0e, 0xe7, 0x03, 0xdd, 0x19, 0xd1, 0xe2, 0x8a, 0x5c, 0x17, + 0x3e, 0x24, 0xec, 0x4d, 0xd6, 0x80, 0x3b, 0x1b, 0xbe, 0xce, 0xbe, 0x1c, + 0x64, 0x67, 0xa9, 0xc1, 0x11, 0xd7, 0x74, 0xea, 0x2a, 0x09, 0x3e, 0xb6, + 0xe0, 0x72, 0xe4, 0xff, 0xf8, 0x3d, 0x08, 0x05, 0x2b, 0x11, 0xa8, 0x4e, + 0xff, 0x00, 0xfc, 0x00, 0xfe, 0x00, 0x02, 0x00, 0xff, 0x00, 0xfb, 0x00, + 0x04, 0x00, 0x00, 0x00, 0xe6, 0xa6, 0x82, 0xd6, 0xaa, 0x28, 0xe8, 0x21, + 0x37, 0x8d, 0x9f, 0xc5, 0xa1, 0xdd, 0xbc, 0xe2, 0x09, 0x7e, 0x76, 0x1b, + 0x20, 0x08, 0x61, 0x42, 0x00, 0xa8, 0xa1, 0xa0, 0x3f, 0x8a, 0x2d, 0xa9, + 0x89, 0x24, 0xff, 0x84, 0x25, 0x10, 0xc2, 0x53, 0xc9, 0xd1, 0xcc, 0xcc, + 0x17, 0x0b, 0x45, 0x64, 0xa7, 0x39, 0x35, 0x94, 0xa3, 0x1b, 0x3c, 0xe4, + 0x61, 0x88, 0x6b, 0x13, 0x8d, 0xc5, 0x83, 0x84, 0x7e, 0x5e, 0x50, 0x8a, + 0xb6, 0x77, 0x29, 0xe0, 0x54, 0x39, 0x27, 0x4e, 0x14, 0x3d, 0x2f, 0xbc, + 0xb7, 0x99, 0x9e, 0xb8, 0xf8, 0xa4, 0x8b, 0x75, 0xbe, 0xf8, 0x51, 0x52, + 0xe1, 0x2c, 0xf4, 0xec, 0x23, 0x50, 0x49, 0x7c, 0x8e, 0x99, 0xac, 0x59, + 0x2d, 0x71, 0x8a, 0xfc, 0x3b, 0x66, 0xab, 0xd0, 0x3d, 0x0f, 0x99, 0xbf, + 0x07, 0x8b, 0x4e, 0x69, 0x3c, 0x6d, 0x64, 0xf6, 0xae, 0x50, 0xf8, 0x23, + 0x30, 0x27, 0xc0, 0x32, 0x3a, 0xf7, 0x02, 0x6b, 0x01, 0x39, 0xd8, 0x30, + 0x11, 0x58, 0x3a, 0xbc, 0x9b, 0x16, 0xe0, 0x55, 0xdc, 0x08, 0x29, 0x41, + 0xc1, 0x68, 0x5e, 0xcf, 0x2e, 0xf6, 0xb7, 0x4a, 0x33, 0x5c, 0x38, 0x3b, + 0x36, 0x84, 0x18, 0x3c, 0x2b, 0x2f, 0x87, 0xa6, 0x32, 0xec, 0xa5, 0xc4, + 0xae, 0x50, 0xb1, 0xb9, 0x13, 0x12, 0x28, 0xcc, 0x43, 0xf5, 0x11, 0xa3, + 0xa8, 0xd7, 0x05, 0x32, 0x37, 0x5c, 0xd6, 0x31, 0xc3, 0x42, 0xe0, 0x46, + 0x26, 0x3f, 0x8c, 0xa0, 0x4d, 0xcc, 0xc8, 0x59, 0x70, 0x95, 0x81, 0xf5, + 0xcc, 0x1d, 0x27, 0xfb, 0x3f, 0x26, 0xfd, 0xb9, 0xfa, 0x11, 0x17, 0x74, + 0x20, 0x71, 0xec, 0x76, 0xa9, 0x25, 0x19, 0x25, 0x19, 0xd5, 0xda, 0x78, + 0x19, 0xee, 0xdd, 0xed, 0x92, 0x37, 0xdb, 0x47, 0x57, 0xc0, 0xc2, 0x54, + 0x6b, 0x7b, 0x32, 0xe3, 0x6b, 0x1b, 0xbe, 0x96, 0xa7, 0x11, 0xeb, 0x94, + 0x4c, 0xad, 0xcc, 0x56, 0x0f, 0x95, 0xd5, 0x67, 0x8e, 0x41, 0xbd, 0x24, + 0x1c, 0x8a, 0x28, 0xc9, 0x1e, 0xad, 0x57, 0x61, 0x42, 0xe1, 0xea, 0x4a, + 0xe9, 0x30, 0xe2, 0x1a, 0xee, 0x5e, 0x03, 0x3e, 0x76, 0xa5, 0x7a, 0xa1, + 0x64, 0x8e, 0x81, 0x90, 0x54, 0x93, 0x38, 0xec, 0xc2, 0xef, 0xf5, 0x50, + 0x5b, 0x7f, 0x0d, 0x71, 0x6c, 0x96, 0x9f, 0x51, 0xef, 0xdd, 0xa2, 0xe1, + 0x8f, 0x24, 0x8c, 0x60, 0x7b, 0x64, 0xd4, 0xc9, 0x5e, 0x53, 0x47, 0x47, + 0x4e, 0xf3, 0x95, 0xd2, 0x46, 0x1d, 0xa2, 0xc2, 0xc6, 0xba, 0xff, 0x82, + 0x4b, 0xd0, 0x30, 0xb4, 0x7f, 0xea, 0x9a, 0xda, 0x84, 0x2e, 0x5c, 0x33, + 0x28, 0x63, 0x63, 0x17, 0xa0, 0x48, 0xce, 0xc3, 0x86, 0xf9, 0x64, 0x4a, + 0x20, 0x2f, 0x3c, 0x78, 0xc1, 0xa3, 0x58, 0x99, 0x96, 0x98, 0xed, 0x08, + 0x17, 0x09, 0xd8, 0x56, 0x2a, 0x61, 0x32, 0x2d, 0x8d, 0x25, 0x32, 0x17, + 0xe6, 0xa5, 0x7e, 0x6c, 0x33, 0xe1, 0x1b, 0x6e, 0x01, 0x75, 0x54, 0x72, + 0x73, 0xf1, 0xbb, 0x89, 0x7a, 0x8f, 0x45, 0x05, 0x38, 0x61, 0x45, 0x6d, + 0x52, 0x29, 0xb4, 0x89, 0x9e, 0x08, 0x9a, 0x72, 0xe3, 0x2c, 0xbe, 0x91, + 0x9c, 0x4e, 0xdc, 0x4a, 0x1f, 0x24, 0x97, 0x4e, 0xc3, 0xaf, 0xb0, 0x0d, + 0xff, 0xa4, 0xa9, 0x05, 0x3b, 0x34, 0x5e, 0x8c, 0x7c, 0xf3, 0x47, 0x14, + 0xff, 0x2e, 0x20, 0xc3, 0xb6, 0xbe, 0x54, 0xa1, 0xba, 0xf4, 0x80, 0xae, + 0xd9, 0xb2, 0xe8, 0x9e, 0x2c, 0xcc, 0x76, 0x81, 0x7b, 0x9b, 0xc6, 0x59, + 0x14, 0x10, 0x53, 0xd7, 0xac, 0x4b, 0x23, 0x2d, 0xac, 0xf7, 0x3a, 0x54, + 0x99, 0x91, 0xef, 0x91, 0xaf, 0x0e, 0xb0, 0xd7, 0xc3, 0xdc, 0xe8, 0x65, + 0xdc, 0xf1, 0x63, 0x98, 0xed, 0xcc, 0xb7, 0x88, 0x69, 0x64, 0x4d, 0x53, + 0x00, 0x82, 0x23, 0xad, 0x18, 0x0f, 0xe9, 0x7c, 0xe6, 0x31, 0x9c, 0x35, + 0xfb, 0x3d, 0xe8, 0xaa, 0x36, 0xbc, 0x12, 0xa5, 0xf4, 0xc9, 0x78, 0xf3, + 0x3b, 0x02, 0xc8, 0x7c, 0xc2, 0x9c, 0xa4, 0x07, 0xa3, 0xcf, 0x99, 0x32, + 0x5a, 0x92, 0x5d, 0xe0, 0xb5, 0x9a, 0x10, 0xc3, 0xc8, 0x7b, 0xbc, 0x55, + 0x48, 0xc9, 0x24, 0x06, 0x4d, 0x74, 0x26, 0x95, 0x4f, 0x8e, 0x4b, 0x64, + 0xc2, 0x33, 0x95, 0xb5, 0x33, 0x14, 0x12, 0xbf, 0x10, 0x00, 0xe8, 0x48, + 0x58, 0xc9, 0xee, 0x0f, 0x00, 0xaa, 0x88, 0x55, 0x82, 0xab, 0xd9, 0xf9, + 0x8d, 0x08, 0xd4, 0x1b, 0xf0, 0x60, 0xf4, 0xc5, 0x6d, 0xed, 0xae, 0x04, + 0x8a, 0x88, 0x6c, 0xe9, 0xda, 0xbc, 0x6f, 0x79, 0xb2, 0x02, 0x7f, 0x65, + 0x19, 0x79, 0xab, 0x16, 0x5a, 0xfc, 0x15, 0x8a, 0x11, 0x3f, 0x68, 0x7c, + 0x7d, 0xa3, 0x34, 0x0c, 0x2e, 0x14, 0x12, 0xb2, 0xdc, 0x10, 0xf9, 0x75, + 0x3e, 0x74, 0x36, 0xff, 0x10, 0xed, 0x82, 0xdb, 0xad, 0x91, 0x63, 0x28, + 0x1a, 0xa8, 0x69, 0xa6, 0x05, 0x66, 0x4a, 0x62, 0x76, 0x3b, 0x54, 0xa4, + 0x55, 0xb2, 0x6d, 0x26, 0x28, 0x27, 0xa1, 0x43, 0xcc, 0x15, 0xa9, 0xfc, + 0x8c, 0xe9, 0x0a, 0xfe, 0xa9, 0xe2, 0x8f, 0x87, 0xfa, 0xd6, 0x4d, 0xdd, + 0x93, 0x28, 0xd5, 0x84, 0xa7, 0xac, 0xbb, 0xa2, 0x11, 0xa2, 0xbb, 0x64, + 0x3f, 0xde, 0x20, 0x37, 0x1e, 0xed, 0xb4, 0xfb, 0x6b, 0x0c, 0xe4, 0xdd, + 0x73, 0xe9, 0x87, 0x6b, 0xe2, 0x32, 0xeb, 0x78, 0xe6, 0x3a, 0x85, 0xd8, + 0x86, 0x98, 0x9e, 0xe1, 0x79, 0x6d, 0x6e, 0x98, 0xa0, 0x83, 0x02, 0xff, + 0xe1, 0x1d, 0xc0, 0x45, 0x6d, 0x41, 0x75, 0x89, 0x08, 0xd7, 0x5d, 0x02, + 0x57, 0x43, 0x62, 0xda, 0x25, 0x9c, 0x3f, 0x9c, 0xf9, 0x78, 0x0a, 0x4b, + 0xc3, 0xd4, 0xd8, 0xfc, 0xeb, 0x27, 0xf8, 0x21, 0x94, 0x17, 0x83, 0x58, + 0xfc, 0x39, 0x30, 0x04, 0x96, 0x51, 0x1c, 0xec, 0x40, 0xca, 0x24, 0xa7, + 0x6f, 0x54, 0x4c, 0x7b, 0x2f, 0x74, 0x97, 0x5b, 0x66, 0x0e, 0x40, 0x2d, + 0x5a, 0x7c, 0xea, 0x15, 0x52, 0x3d, 0x21, 0xb9, 0xbe, 0xef, 0x2e, 0x23, + 0x51, 0x60, 0x8e, 0xc6, 0x5b, 0xf9, 0x16, 0x7a, 0x7b, 0x4b, 0x24, 0x80, + 0x4e, 0x64, 0x05, 0x2f, 0xb5, 0x5d, 0x22, 0xef, 0x80, 0x50, 0x57, 0x78, + 0x23, 0x52, 0x42, 0x5b, 0x75, 0x36, 0x3a, 0xee, 0x89, 0x66, 0xd1, 0x83, + 0x27, 0x7d, 0xc3, 0x16, 0xa5, 0x44, 0xee, 0xdf, 0x0c, 0x0c, 0x23, 0xe1, + 0x4d, 0xb3, 0x3c, 0xf8, 0x77, 0x65, 0xb1, 0xfe, 0xcc, 0x6e, 0xb2, 0x5e, + 0x1a, 0x26, 0xd4, 0x72, 0x24, 0x96, 0xce, 0xc5, 0x05, 0x67, 0x9d, 0x97, + 0xb4, 0x48, 0xf9, 0x7b, 0x21, 0x5b, 0xc1, 0x85, 0x3e, 0xf0, 0x47, 0x66, + 0x26, 0x60, 0x88, 0x43, 0xe6, 0x15, 0x53, 0x1e, 0xfd, 0x11, 0x04, 0xc6, + 0x8e, 0xd6, 0x74, 0x02, 0x5a, 0x03, 0xf5, 0x7a, 0x42, 0xbd, 0xcd, 0xc2, + 0x3b, 0x59, 0xff, 0xc9, 0x85, 0x2d, 0xb2, 0xb5, 0x74, 0x96, 0x5e, 0x1c, + 0x29, 0x86, 0x4d, 0x45, 0x08, 0xd3, 0xfa, 0xe5, 0x60, 0xc6, 0xde, 0x6e, + 0x42, 0x0d, 0x8e, 0x67, 0x75, 0x81, 0x38, 0x20, 0xde, 0x8c, 0x47, 0x68, + 0xda, 0x2a, 0x7d, 0x84, 0x43, 0xd2, 0x49, 0xf1, 0xf7, 0x34, 0x25, 0x54, + 0x51, 0x54, 0x3a, 0xaf, 0x21, 0xcf, 0x72, 0x81, 0x0e, 0x0e, 0x8b, 0x5f, + 0x8b, 0xa4, 0xbd, 0xb3, 0x38, 0xc0, 0x88, 0x1b, 0x20, 0x2e, 0xe2, 0xe5, + 0x4f, 0x36, 0x12, 0xb5, 0xb6, 0xc2, 0x64, 0xde, 0x08, 0x91, 0x8f, 0x51, + 0x01, 0x15, 0x49, 0x18, 0xdd, 0x38, 0x4e, 0x0b, 0x67, 0xfb, 0xdf, 0xe4, + 0x97, 0xed, 0x5a, 0xed, 0x2b, 0x2c, 0xcb, 0x9a, 0x41, 0xf3, 0x7c, 0x4e, + 0x37, 0x66, 0x54, 0x43, 0x47, 0xad, 0x92, 0x4d, 0xfe, 0x1c, 0x10, 0xe2, + 0x98, 0x82, 0x8a, 0x84, 0xdb, 0xc7, 0x89, 0xa4, 0x47, 0x22, 0x2a, 0x02, + 0x2a, 0x36, 0x94, 0xfd, 0xa0, 0xec, 0x1b, 0x61, 0x4e, 0xbc, 0x93, 0x59, + 0x36, 0xe9, 0x41, 0x8a, 0x94, 0x20, 0x49, 0x70, 0x7a, 0x9b, 0x91, 0x53, + 0x56, 0x14, 0x68, 0x92, 0xd2, 0xb5, 0x0b, 0x17, 0x82, 0x4e, 0x91, 0x18, + 0x6a, 0x27, 0xdc, 0x49, 0x88, 0x87, 0xf0, 0xd9, 0x66, 0xd1, 0x9d, 0xcd, + 0x0a, 0xd0, 0xae, 0x5b, 0xf0, 0x3e, 0x0e, 0x23, 0x9b, 0x8f, 0xad, 0x5c, + 0xeb, 0x88, 0xfe, 0xd1, 0x4f, 0xe7, 0x32, 0xc9, 0xfe, 0xd8, 0x7e, 0xdb, + 0xeb, 0x4b, 0x13, 0x8a, 0x37, 0x72, 0x7d, 0x84, 0x42, 0xb1, 0x13, 0x8d, + 0x0c, 0x1b, 0x41, 0x1a, 0x3b, 0x26, 0x8f, 0x59, 0xa9, 0xbf, 0x44, 0x93, + 0x92, 0x13, 0x59, 0x33, 0x1e, 0x76, 0xf9, 0xe1, 0xa7, 0xa0, 0x2e, 0xd5, + 0xca, 0x12, 0xd5, 0x76, 0x10, 0xd9, 0x6b, 0x7c, 0x72, 0x6c, 0xd6, 0x1f, + 0x3d, 0x99, 0x59, 0xb6, 0xb1, 0xcd, 0x57, 0x1b, 0xbc, 0xbf, 0xe6, 0xf9, + 0x51, 0xca, 0x9b, 0x0b, 0xa3, 0x58, 0x57, 0xc5, 0x7e, 0xdb, 0xa0, 0x6e, + 0xbb, 0xc9, 0x23, 0xbf, 0xaf, 0x40, 0x27, 0x5c, 0x33, 0x6c, 0x99, 0x01, + 0x18, 0xc8, 0x75, 0x4d, 0xe0, 0xdd, 0xc3, 0xbf, 0x2b, 0x1f, 0x54, 0x7a, + 0xd9, 0x93, 0x38, 0xb4, 0x6c, 0x64, 0xa7, 0xdd, 0x0f, 0x38, 0x51, 0xc1, + 0x0c, 0xe5, 0x14, 0xf5, 0x19, 0xb0, 0x0d, 0xf6, 0xff, 0x44, 0x8a, 0x2a, + 0x90, 0x8f, 0xc4, 0xd9, 0x4e, 0x4d, 0x1d, 0x31, 0x10, 0xdc, 0xee, 0x82, + 0xb7, 0xd9, 0xb7, 0xd2, 0xfe, 0xe9, 0x29, 0x35, 0xf6, 0xf8, 0x93, 0x53, + 0x91, 0x8a, 0xcf, 0x75, 0x3d, 0xb5, 0x4f, 0x03, 0x34, 0x95, 0x24, 0x32, + 0x3b, 0xa9, 0x0b, 0xd4, 0xfb, 0x1e, 0xa7, 0x39, 0x4f, 0x71, 0x7a, 0x37, + 0x7d, 0xd4, 0xfb, 0x4d, 0xc4, 0x55, 0x8b, 0x3e, 0x05, 0x83, 0x44, 0xd5, + 0x90, 0xb2, 0xe2, 0x29, 0x1c, 0x38, 0x4b, 0xa1, 0xcd, 0x18, 0x51, 0x8f, + 0xd2, 0x05, 0x57, 0xd8, 0x92, 0x66, 0xf5, 0x46, 0x42, 0xb0, 0xf0, 0x3d, + 0x88, 0x49, 0x23, 0x83, 0xaf, 0x32, 0x32, 0x24, 0x36, 0xd6, 0x27, 0x94, + 0xb7, 0x26, 0x4f, 0xd5, 0x4c, 0x5b, 0xc5, 0xc2, 0x67, 0x45, 0x09, 0x43, + 0x92, 0xd2, 0x91, 0x0d, 0xa1, 0xd4, 0xbf, 0x50, 0xa8, 0x46, 0x27, 0xab, + 0x3b, 0x6b, 0x5d, 0xbc, 0x0d, 0x79, 0x0d, 0x20, 0x49, 0x80, 0x30, 0xe8, + 0x04, 0xfd, 0x66, 0x80, 0x3e, 0x93, 0x37, 0x97, 0x0c, 0x17, 0xa8, 0x00, + 0x56, 0x84, 0x05, 0x50, 0x56, 0x90, 0x89, 0xf1, 0xcd, 0x81, 0xb9, 0x32, + 0xad, 0xa8, 0x53, 0xe6, 0x32, 0x78, 0x29, 0x8d, 0x08, 0x06, 0x75, 0x21, + 0x39, 0x85, 0x7a, 0x4d, 0xc2, 0x23, 0x03, 0x2c, 0x06, 0xfa, 0x5f, 0xd8, + 0x3c, 0x36, 0xd0, 0xad, 0x8b, 0xd9, 0x1f, 0xd9, 0x3f, 0x38, 0x46, 0x61, + 0xfa, 0x40, 0xe3, 0xa2, 0xc0, 0xdc, 0x8d, 0x4a, 0x81, 0x22, 0x90, 0xde, + 0x3a, 0x53, 0x94, 0xcc, 0xce, 0x4b, 0xb9, 0xe2, 0xcc, 0x5b, 0x95, 0x33, + 0xca, 0x6e, 0x49, 0xf6, 0xdd, 0x7b, 0x30, 0xa9, 0x28, 0xe6, 0x30, 0xf1, + 0x88, 0x8c, 0xfe, 0x12, 0xad, 0x70, 0xc4, 0xcc, 0xd2, 0xdf, 0x38, 0x25, + 0x30, 0x4b, 0x03, 0x7e, 0x76, 0xe8, 0xfe, 0x68, 0x7a, 0x6d, 0x43, 0x76, + 0x5c, 0x19, 0x14, 0x62, 0x4c, 0xca, 0xcb, 0x86, 0xf8, 0x6d, 0x4d, 0x3f, + 0x61, 0x63, 0x45, 0x6c, 0x82, 0x25, 0x30, 0xe1, 0x44, 0xde, 0xfe, 0x01, + 0xde, 0x2c, 0xd0, 0xcc, 0xc8, 0x42, 0xd6, 0x60, 0xcf, 0xeb, 0x77, 0x7b, + 0x0e, 0xdb, 0xe2, 0xf2, 0xb6, 0xe4, 0xba, 0xa1, 0x2f, 0xa2, 0x02, 0x7b, + 0x3f, 0x06, 0x88, 0x0e, 0xf2, 0xf0, 0x4b, 0xd9, 0x1a, 0xa3, 0xd8, 0x9d, + 0x34, 0xd9, 0x39, 0x5a, 0x05, 0xd8, 0x18, 0x99, 0xc8, 0x64, 0xdf, 0xa7, + 0x7b, 0x04, 0xae, 0x53, 0xb7, 0x29, 0x4a, 0xe8, 0x28, 0xf6, 0xe9, 0xd0, + 0xae, 0xef, 0xd4, 0xa9, 0x98, 0x54, 0xdd, 0xac, 0x1c, 0xb9, 0xa1, 0x21, + 0x47, 0x81, 0x6b, 0xc2, 0xaf, 0x7f, 0xb8, 0xda, 0xc5, 0x86, 0x54, 0x7f, + 0x30, 0xc7, 0xb5, 0x7a, 0x34, 0xc4, 0xd5, 0xf7, 0xd8, 0xf5, 0x3c, 0x12, + 0xe0, 0x1f, 0xa6, 0xb2, 0xf6, 0x8f, 0x24, 0x2d, 0x40, 0xfe, 0xc7, 0x5c, + 0xb2, 0x35, 0xd8, 0x9b, 0xa6, 0x44, 0x8d, 0xed, 0x0d, 0x46, 0xf4, 0x59, + 0x74, 0x2b, 0xe5, 0x90, 0x6e, 0xe0, 0x46, 0x63, 0xf3, 0xd5, 0xd2, 0x93, + 0x0d, 0x5a, 0xa2, 0x76, 0x68, 0x30, 0x38, 0xad, 0x24, 0x0f, 0x40, 0xcd, + 0x8b, 0xc9, 0xad, 0xb3, 0xd0, 0xef, 0xee, 0xc6, 0x33, 0x09, 0x2b, 0x62, + 0x5f, 0xb6, 0x76, 0xd3, 0xf0, 0x02, 0x73, 0xa7, 0xee, 0x70, 0xd2, 0x4c, + 0xc3, 0x4e, 0x2d, 0xa3, 0x1a, 0x51, 0xe7, 0xbb, 0x81, 0xde, 0xfc, 0xeb, + 0x92, 0x4b, 0xbf, 0xb2, 0xb5, 0xff, 0xa4, 0xae, 0x87, 0xe1, 0xcb, 0x40, + 0xb1, 0xb6, 0x37, 0x2b, 0x1a, 0x28, 0x11, 0x1f, 0x55, 0x6b, 0x3c, 0x34, + 0x08, 0x5b, 0x48, 0x7b, 0x0c, 0x48, 0x16, 0xf4, 0xe8, 0x03, 0xc3, 0xda, + 0xac, 0x04, 0x8e, 0x16, 0xfc, 0x60, 0x5c, 0x74, 0x26, 0x62, 0xcf, 0xf1, + 0xdc, 0x81, 0x16, 0xff, 0xf8, 0x3d, 0x08, 0x06, 0x2b, 0x11, 0x15, 0x48, + 0x05, 0x00, 0x12, 0x00, 0x0e, 0x00, 0x00, 0x00, 0xff, 0x00, 0xe6, 0x1e, + 0x83, 0xbd, 0x06, 0x77, 0x43, 0x81, 0xf0, 0x23, 0xf0, 0x2c, 0xe4, 0xd9, + 0x98, 0xa1, 0x47, 0x07, 0x48, 0x14, 0x07, 0x2c, 0xa9, 0x97, 0xdc, 0xf9, + 0x70, 0x08, 0x53, 0x32, 0xd2, 0xb6, 0x4a, 0xb6, 0xcc, 0xb9, 0x03, 0xb0, + 0x2c, 0x7f, 0xc9, 0x12, 0x64, 0xef, 0xe7, 0xa0, 0x67, 0x19, 0x7e, 0x79, + 0xc7, 0xa1, 0xf3, 0x55, 0xd6, 0xfc, 0xda, 0xab, 0x3c, 0x08, 0xab, 0x8b, + 0xc9, 0xa5, 0x75, 0x0f, 0xca, 0x15, 0x65, 0xfc, 0xaa, 0xa2, 0x68, 0x63, + 0x0a, 0x2a, 0xe7, 0x76, 0xe4, 0x06, 0x1e, 0x53, 0xad, 0x2a, 0x2b, 0x5e, + 0xa4, 0x46, 0x8e, 0x44, 0xd2, 0x43, 0x38, 0xcf, 0xc1, 0xa2, 0x82, 0x16, + 0x60, 0x92, 0x3c, 0xa8, 0x4b, 0xfe, 0xa0, 0x69, 0x05, 0xb4, 0x11, 0x2b, + 0x18, 0x8e, 0xb1, 0xec, 0x11, 0xe1, 0x08, 0x74, 0x93, 0x85, 0xfe, 0xa3, + 0xe2, 0x74, 0xf9, 0x2f, 0x71, 0x14, 0x77, 0x09, 0xf7, 0x47, 0x12, 0x1f, + 0xe3, 0xc4, 0xfc, 0x9c, 0x98, 0x7f, 0xaa, 0xbd, 0xfd, 0xf5, 0xbf, 0x6b, + 0xa7, 0xdb, 0xff, 0xae, 0x20, 0x13, 0x11, 0x4c, 0xc5, 0x0c, 0xbb, 0x15, + 0xa9, 0x54, 0xcc, 0x72, 0x69, 0xb8, 0x7c, 0xb4, 0xf6, 0xa0, 0xa5, 0xb3, + 0x89, 0xb5, 0xa1, 0x89, 0x81, 0x30, 0x33, 0xf2, 0x55, 0x90, 0x9e, 0x15, + 0x3a, 0x78, 0x89, 0x4f, 0x28, 0x7b, 0x2b, 0x1a, 0x9c, 0xd0, 0x5d, 0x43, + 0xad, 0xfa, 0x29, 0x8b, 0xb1, 0xef, 0xaa, 0x46, 0xbb, 0x43, 0x55, 0x94, + 0xcd, 0x83, 0xb1, 0x9f, 0xc1, 0x1f, 0x46, 0x57, 0x7f, 0x69, 0xa9, 0x7f, + 0x30, 0x58, 0xf4, 0x70, 0xfd, 0xca, 0xa9, 0x18, 0xea, 0xf5, 0xf1, 0x11, + 0x5b, 0x83, 0x32, 0xbd, 0xb0, 0x8a, 0xa9, 0x92, 0x64, 0x06, 0xc1, 0xcd, + 0xa3, 0x96, 0xab, 0xc5, 0x1c, 0xfe, 0x80, 0x67, 0xff, 0xbf, 0x39, 0xfa, + 0xe5, 0xbf, 0x47, 0x34, 0xe4, 0xb6, 0x82, 0x43, 0x49, 0x64, 0x9a, 0xdb, + 0xa2, 0xb5, 0xe4, 0xaa, 0x91, 0x6c, 0x51, 0xe9, 0x1a, 0x89, 0xff, 0xf8, + 0xe8, 0x5e, 0xa0, 0x0f, 0xad, 0x56, 0xd7, 0xf9, 0xa7, 0xd9, 0x2d, 0xa8, + 0x06, 0xa3, 0x89, 0xbc, 0x9e, 0xd9, 0xf7, 0x96, 0x44, 0x13, 0xa4, 0xd1, + 0xf8, 0xff, 0xdc, 0xa5, 0xba, 0x12, 0xb6, 0xdd, 0xb7, 0xa4, 0xd9, 0x19, + 0x98, 0x68, 0xad, 0xac, 0x3b, 0x89, 0xaa, 0x0d, 0xd7, 0x86, 0xf9, 0xae, + 0x13, 0x98, 0x21, 0x74, 0x6b, 0x5f, 0x1f, 0xbd, 0xf9, 0x87, 0x1f, 0x9a, + 0x76, 0xb3, 0x12, 0x14, 0xe0, 0xfb, 0x56, 0x12, 0x68, 0xfc, 0xa1, 0xa3, + 0xe9, 0x11, 0x50, 0xc9, 0x2f, 0xf2, 0x86, 0x9f, 0xc3, 0x0e, 0xcd, 0x45, + 0x21, 0xda, 0x8b, 0x1f, 0xc0, 0xd6, 0x91, 0x53, 0xd5, 0x88, 0x51, 0x82, + 0xb2, 0xd2, 0x15, 0xc4, 0x94, 0x60, 0xec, 0x49, 0xe5, 0xa6, 0x3b, 0xdc, + 0xbc, 0xb4, 0xd1, 0x95, 0x0b, 0xa9, 0x71, 0xef, 0x59, 0xaa, 0xc1, 0x82, + 0x4b, 0xe7, 0x86, 0xee, 0x05, 0xdf, 0xf2, 0x10, 0x52, 0xad, 0x3a, 0x73, + 0x2f, 0xac, 0x28, 0x81, 0x8c, 0xf9, 0xcf, 0x75, 0xba, 0x2b, 0xee, 0x8a, + 0x74, 0xf2, 0x57, 0x25, 0xbf, 0xdc, 0x90, 0xab, 0x25, 0x74, 0x03, 0xae, + 0x45, 0xa6, 0x2f, 0x74, 0x9e, 0xea, 0xd9, 0x84, 0x78, 0x21, 0xdb, 0xce, + 0xff, 0x87, 0xd4, 0x18, 0x26, 0x3c, 0xad, 0x04, 0xdf, 0xcd, 0x7e, 0x06, + 0x43, 0x95, 0x02, 0x59, 0x6d, 0x3d, 0x51, 0xf4, 0x4a, 0x54, 0xb6, 0x9d, + 0xca, 0x2f, 0x2a, 0xd9, 0xcc, 0x2e, 0xf7, 0x7c, 0xca, 0x22, 0x1e, 0x5f, + 0xf3, 0xa0, 0x8a, 0x55, 0xda, 0x38, 0x25, 0x0b, 0x08, 0x69, 0xae, 0x48, + 0x72, 0x47, 0xcb, 0xea, 0xba, 0x70, 0x73, 0x09, 0x7e, 0x75, 0xfa, 0x24, + 0x89, 0x30, 0x7f, 0xf8, 0x97, 0x81, 0x3d, 0x52, 0xcc, 0x9b, 0x7d, 0xc4, + 0x92, 0x95, 0x0c, 0x94, 0x2d, 0xb3, 0x54, 0xef, 0x35, 0x8c, 0x90, 0x2b, + 0x96, 0xb9, 0x45, 0x10, 0x90, 0xcc, 0x41, 0x93, 0xf4, 0xc4, 0xf2, 0x40, + 0x91, 0xbd, 0xc8, 0x9e, 0xba, 0x3b, 0x8d, 0x2d, 0x2b, 0xc0, 0x49, 0x78, + 0xde, 0x3f, 0x70, 0x45, 0xdd, 0xb5, 0x2c, 0x9c, 0x4b, 0x3d, 0xe4, 0x36, + 0xcf, 0x59, 0x94, 0x67, 0x37, 0xb0, 0x3d, 0x54, 0x3b, 0xb7, 0x82, 0xef, + 0xcb, 0xf4, 0x6a, 0x73, 0x80, 0x14, 0x30, 0xac, 0x46, 0x16, 0x27, 0xe4, + 0x9a, 0x38, 0x8d, 0x42, 0x4e, 0xf1, 0x5b, 0x3c, 0xaa, 0xca, 0x6a, 0xab, + 0xae, 0x81, 0x4f, 0x14, 0x38, 0x82, 0xab, 0x48, 0x55, 0x64, 0xa1, 0xe2, + 0xeb, 0x01, 0x9c, 0x47, 0xe9, 0x90, 0xda, 0x8d, 0x92, 0x0c, 0xbf, 0x35, + 0x62, 0x8c, 0xd3, 0x54, 0x15, 0x7e, 0xc5, 0xdf, 0xb0, 0x67, 0x3e, 0x93, + 0x29, 0xd1, 0x51, 0xb8, 0x5d, 0xfc, 0x36, 0x3f, 0x01, 0x56, 0x9b, 0x1b, + 0x36, 0x17, 0x09, 0x96, 0x03, 0xe5, 0xb1, 0x52, 0x98, 0xff, 0x0e, 0xc4, + 0xbd, 0xaa, 0x51, 0xaf, 0x8a, 0x2c, 0xf1, 0x47, 0x80, 0xe1, 0xf3, 0x2e, + 0x72, 0xb8, 0xfa, 0x87, 0x89, 0x98, 0x00, 0xa1, 0x81, 0x27, 0x88, 0xb7, + 0xac, 0x1e, 0x71, 0xa8, 0x8b, 0x72, 0xa3, 0x25, 0xe0, 0x46, 0x12, 0x17, + 0xcd, 0xd0, 0x3c, 0x4d, 0xcd, 0xa6, 0x83, 0x93, 0xad, 0x84, 0x8e, 0x7e, + 0x93, 0xf3, 0xf3, 0x08, 0x3a, 0xa6, 0x5e, 0x8a, 0xae, 0x8b, 0x86, 0x7a, + 0xc7, 0xc0, 0x49, 0xfd, 0x76, 0x76, 0xc3, 0x42, 0x5c, 0xd6, 0x9b, 0x32, + 0x5c, 0xfe, 0xd2, 0xd2, 0x6c, 0x87, 0xa3, 0xd2, 0x4c, 0xea, 0x54, 0x5a, + 0x09, 0xe5, 0xe1, 0x85, 0xd3, 0x9d, 0x40, 0x37, 0xf5, 0x3f, 0x0d, 0xb5, + 0xd2, 0x76, 0x26, 0xa9, 0x85, 0x99, 0x3d, 0x49, 0x7e, 0x19, 0xa3, 0x01, + 0x5e, 0x9a, 0xeb, 0x28, 0xa6, 0xc5, 0x24, 0xd1, 0x20, 0x39, 0x01, 0x10, + 0x35, 0xe2, 0x8b, 0xd3, 0x52, 0xa2, 0x7b, 0x64, 0x6f, 0x1f, 0x55, 0xe9, + 0x47, 0x2b, 0xc8, 0x43, 0x7c, 0xf1, 0x69, 0xb4, 0x0e, 0xca, 0xa5, 0xa2, + 0xf0, 0xb4, 0x11, 0x7b, 0x74, 0x73, 0xfb, 0xed, 0x52, 0x73, 0x9f, 0x9e, + 0xd8, 0x17, 0xe7, 0xdc, 0x8e, 0xf6, 0x6e, 0x6a, 0x01, 0x6a, 0xfb, 0xa5, + 0xe3, 0x13, 0xb9, 0x62, 0xb0, 0x8d, 0x82, 0x66, 0x00, 0x92, 0x10, 0xac, + 0xd7, 0xe7, 0x63, 0x02, 0x93, 0x3f, 0x44, 0x7f, 0xc3, 0xf0, 0x31, 0x0f, + 0x20, 0xe2, 0x00, 0xb6, 0x37, 0x7e, 0x69, 0x64, 0x0c, 0xb4, 0xc9, 0x96, + 0xa5, 0xaf, 0x7f, 0x28, 0xa5, 0x91, 0x38, 0xa5, 0xdd, 0x5e, 0x34, 0x5c, + 0x8c, 0x8c, 0xc6, 0x01, 0xb2, 0x1c, 0xc5, 0x4d, 0xf0, 0xa0, 0xbe, 0x8e, + 0x2c, 0x7b, 0x85, 0x4b, 0x5b, 0xb9, 0x78, 0xca, 0x2b, 0x61, 0x29, 0x27, + 0x62, 0x0b, 0x5e, 0x20, 0x47, 0x9f, 0x8b, 0x50, 0xfd, 0xb0, 0x48, 0xec, + 0x52, 0x98, 0x07, 0xc6, 0x79, 0x3b, 0xb5, 0x94, 0x62, 0xe1, 0x3c, 0x60, + 0xf0, 0x72, 0x6a, 0x52, 0x66, 0xfc, 0x5b, 0x36, 0xd8, 0xd2, 0xd5, 0xbc, + 0x8e, 0x71, 0xf2, 0x72, 0x6b, 0x51, 0xf1, 0x3d, 0xae, 0xf8, 0xd6, 0xe2, + 0x80, 0xaf, 0xa7, 0x04, 0xae, 0x37, 0x4f, 0xe7, 0x41, 0x38, 0xb7, 0x08, + 0xa8, 0x68, 0x48, 0x42, 0x55, 0x65, 0xd3, 0xb6, 0x64, 0xd4, 0x24, 0x4a, + 0xc8, 0xef, 0x35, 0x61, 0x24, 0xe0, 0xdc, 0xc3, 0x32, 0x72, 0x99, 0x39, + 0xb4, 0x1f, 0x06, 0xb1, 0x6b, 0x8b, 0xf5, 0xf0, 0x92, 0x5b, 0x42, 0x55, + 0x3f, 0xc0, 0x10, 0x16, 0xb9, 0xe6, 0xd1, 0x14, 0x90, 0x0d, 0x87, 0x06, + 0x99, 0x89, 0xcc, 0xdf, 0x36, 0xcb, 0x2d, 0xfc, 0x6d, 0xf0, 0xca, 0xc4, + 0x07, 0xa7, 0xce, 0xc1, 0x1e, 0x2b, 0x2b, 0x69, 0x6c, 0x6a, 0xd2, 0xee, + 0x56, 0x6c, 0x41, 0x51, 0x6b, 0xa5, 0xb0, 0x8b, 0x49, 0x7c, 0xa2, 0x2b, + 0x24, 0x99, 0x63, 0x87, 0xae, 0x38, 0xc0, 0xa2, 0x8c, 0x09, 0x97, 0xad, + 0xa6, 0x6b, 0x02, 0x89, 0x2b, 0x3a, 0x27, 0x9c, 0x99, 0xd0, 0x2c, 0xb5, + 0x34, 0xef, 0xa3, 0x79, 0x7e, 0x00, 0x6b, 0xb6, 0x39, 0x67, 0xb7, 0xeb, + 0x35, 0xf5, 0x6d, 0x6a, 0x77, 0xc5, 0xf4, 0x16, 0x34, 0x7f, 0x45, 0x0d, + 0x5d, 0x57, 0x41, 0x5c, 0x6a, 0xab, 0x54, 0xba, 0xfc, 0x66, 0x5d, 0x58, + 0x55, 0x53, 0x4f, 0xb8, 0x25, 0xfe, 0x8a, 0x11, 0x22, 0x93, 0xbe, 0xda, + 0x68, 0x49, 0xa5, 0x2c, 0x43, 0x6f, 0xb7, 0x39, 0xcd, 0x21, 0x0a, 0xe3, + 0x9c, 0x9a, 0x04, 0xdd, 0x0e, 0xea, 0x84, 0x1c, 0xe0, 0xe6, 0xdd, 0x76, + 0xeb, 0x78, 0xd1, 0xbb, 0x4d, 0xfa, 0xa4, 0xfd, 0xc2, 0x40, 0x7c, 0x2d, + 0x67, 0x1a, 0x17, 0x70, 0xf9, 0x71, 0xf0, 0x81, 0x4d, 0x52, 0xeb, 0x8a, + 0xb1, 0x62, 0xa9, 0xb4, 0x61, 0x16, 0xc9, 0x75, 0xa0, 0x2c, 0x64, 0xd1, + 0x10, 0xe4, 0x88, 0x31, 0x87, 0x04, 0x24, 0x8e, 0x58, 0x27, 0x20, 0x84, + 0xdf, 0xa8, 0x28, 0xde, 0x61, 0x10, 0xba, 0x45, 0x06, 0x61, 0x30, 0x87, + 0x45, 0x19, 0xc8, 0x32, 0xa4, 0x5e, 0x3c, 0xfe, 0xb9, 0x82, 0x9f, 0x36, + 0x40, 0xa0, 0x42, 0x6e, 0x09, 0x18, 0xe5, 0x4c, 0xe8, 0xa7, 0x77, 0x67, + 0x1a, 0x0d, 0x04, 0xdd, 0xac, 0xb3, 0x4e, 0xae, 0x5e, 0xea, 0xcc, 0x5e, + 0xfe, 0x93, 0x1e, 0xf2, 0x43, 0xaa, 0x55, 0x3c, 0xef, 0x9e, 0xb3, 0xe9, + 0xca, 0xee, 0xd1, 0xb1, 0x55, 0x0c, 0x71, 0x9d, 0xa7, 0x32, 0x0f, 0x1f, + 0xe0, 0x98, 0xcf, 0x3d, 0x0f, 0x27, 0xc6, 0x6b, 0xf5, 0xd2, 0xa8, 0x75, + 0x13, 0xb8, 0x4b, 0x24, 0x7c, 0xaf, 0x52, 0x6c, 0x6f, 0xba, 0x11, 0xcc, + 0x91, 0x85, 0x86, 0x59, 0xbe, 0xb6, 0x51, 0x4a, 0xe2, 0x61, 0x2e, 0x87, + 0xf1, 0x23, 0xbb, 0x2c, 0x92, 0x79, 0x2e, 0xa5, 0x2c, 0x0b, 0x09, 0x89, + 0xdb, 0xd1, 0xfb, 0xc9, 0xa6, 0x48, 0xf2, 0xad, 0xfb, 0x21, 0x2a, 0xf0, + 0xb6, 0xdc, 0x9a, 0xdc, 0x75, 0xfb, 0x5c, 0x13, 0x47, 0xc7, 0x59, 0xee, + 0xb6, 0xb2, 0x16, 0x1b, 0x50, 0xf4, 0xb0, 0x7a, 0x29, 0xd4, 0x21, 0x86, + 0x4c, 0xfb, 0xcb, 0xc8, 0xda, 0x10, 0xc4, 0x19, 0x9c, 0x03, 0x41, 0xc3, + 0xef, 0x02, 0xd3, 0xe3, 0x4a, 0x7b, 0x59, 0x99, 0xac, 0xce, 0xbf, 0x3c, + 0x1b, 0x03, 0xc7, 0xce, 0x97, 0x77, 0xa6, 0x66, 0x20, 0x13, 0xa6, 0x7c, + 0xb7, 0x9c, 0x1c, 0x20, 0x6b, 0xc5, 0xb6, 0x77, 0x76, 0x1a, 0x92, 0x40, + 0x68, 0x34, 0x26, 0x2d, 0xc9, 0x7f, 0x09, 0x24, 0x54, 0x5a, 0xa2, 0x49, + 0x95, 0xd5, 0x7f, 0x9b, 0x85, 0xed, 0xee, 0x8a, 0x0a, 0x59, 0xea, 0x25, + 0x32, 0x88, 0x31, 0x65, 0xc7, 0x82, 0xc1, 0x6d, 0xa6, 0x27, 0x77, 0xa9, + 0x88, 0xef, 0xad, 0xf2, 0x84, 0x49, 0x15, 0xfa, 0xdd, 0x82, 0xde, 0xa2, + 0x04, 0x46, 0x99, 0x62, 0x59, 0xd6, 0x7b, 0xa5, 0x49, 0xbe, 0x56, 0x2e, + 0x39, 0x6c, 0x88, 0xa2, 0x3e, 0xe9, 0xb1, 0xe8, 0x86, 0x32, 0xee, 0x73, + 0x79, 0x3f, 0x3c, 0xc6, 0x69, 0x3e, 0x5c, 0x96, 0x08, 0x7e, 0xb2, 0xb5, + 0xeb, 0xa1, 0xf8, 0xfe, 0x12, 0xa2, 0xa5, 0x2a, 0x91, 0x0a, 0x52, 0xb7, + 0x52, 0x68, 0xd4, 0x5c, 0x28, 0x76, 0xce, 0xbc, 0xc6, 0x41, 0xd5, 0x79, + 0x16, 0xec, 0x7b, 0x26, 0x28, 0x82, 0xa0, 0x42, 0x98, 0x0c, 0xbf, 0x29, + 0xe8, 0xa6, 0xae, 0x99, 0x8b, 0xb0, 0x65, 0x40, 0xd7, 0xe1, 0xd4, 0x31, + 0xb9, 0xe5, 0xad, 0x79, 0x31, 0x94, 0x16, 0xd4, 0x93, 0xfc, 0x0a, 0xb4, + 0x91, 0x2a, 0x41, 0x2e, 0x20, 0xa7, 0x18, 0xc0, 0xef, 0x89, 0x95, 0x6d, + 0x53, 0x34, 0x04, 0x04, 0x2f, 0xc1, 0xea, 0xdd, 0x67, 0x95, 0x0c, 0x26, + 0x0b, 0xa6, 0x8c, 0x32, 0x58, 0x8f, 0x16, 0xba, 0xab, 0x65, 0x7b, 0xc9, + 0x26, 0xf5, 0xf3, 0x1b, 0x7a, 0x37, 0x80, 0x54, 0x7c, 0xba, 0x73, 0x2f, + 0x04, 0x23, 0xb8, 0x0e, 0x3a, 0xea, 0x8a, 0x15, 0xec, 0x3b, 0x51, 0xb5, + 0xfd, 0x77, 0x72, 0xfe, 0x5f, 0x79, 0x35, 0x72, 0xc9, 0x4f, 0xb6, 0xae, + 0xa4, 0x2e, 0x41, 0xf3, 0xfa, 0x6a, 0x28, 0x8f, 0x32, 0x33, 0x39, 0x4b, + 0x42, 0xc3, 0x35, 0x4b, 0x5e, 0xbc, 0x6b, 0x0c, 0xd7, 0x7b, 0x7a, 0x8e, + 0x8b, 0x77, 0x24, 0x05, 0x38, 0x48, 0x87, 0x52, 0x33, 0x8a, 0xcd, 0xe1, + 0xa2, 0x70, 0xf8, 0x32, 0x50, 0xd2, 0x28, 0xa9, 0xee, 0x09, 0xd7, 0xe6, + 0x65, 0xf6, 0xe1, 0x6d, 0x72, 0x5c, 0xb4, 0x54, 0x64, 0x65, 0x4e, 0xee, + 0x2f, 0xf6, 0x89, 0x1b, 0x21, 0xe8, 0xe0, 0x3f, 0x24, 0x97, 0x70, 0x58, + 0xa7, 0x6c, 0xb9, 0x74, 0x23, 0xc8, 0x11, 0xa0, 0x2c, 0x7f, 0x41, 0x9e, + 0x6a, 0xbd, 0x20, 0x8c, 0x50, 0xac, 0xea, 0x3c, 0xcd, 0x02, 0x2d, 0x42, + 0xc3, 0x8f, 0x7d, 0x09, 0x51, 0x33, 0x3f, 0x9a, 0x11, 0x84, 0x5d, 0x28, + 0x49, 0x74, 0xa7, 0x1b, 0xb8, 0xff, 0x0e, 0x63, 0xf0, 0xe9, 0xf6, 0x05, + 0x30, 0x60, 0xa3, 0x30, 0x89, 0x78, 0x1a, 0xa8, 0xf6, 0xfa, 0xf7, 0xff, + 0xfd, 0x45, 0x24, 0x95, 0x75, 0x89, 0xef, 0xf0, 0x9b, 0x8c, 0xab, 0x75, + 0x39, 0x9f, 0xab, 0x04, 0x54, 0x75, 0x06, 0x13, 0xb1, 0x57, 0xac, 0xf4, + 0x26, 0xdf, 0x04, 0x9b, 0xbe, 0x69, 0x4f, 0x13, 0x6d, 0x1e, 0x79, 0x39, + 0x4d, 0xaa, 0xc4, 0x7b, 0xe8, 0xfa, 0x0a, 0x6c, 0x65, 0x3b, 0x16, 0xa0, + 0xd6, 0x0f, 0xe6, 0x62, 0x04, 0x2a, 0x90, 0xa8, 0xf5, 0x56, 0x57, 0x38, + 0x7d, 0x8f, 0x96, 0x11, 0x68, 0x94, 0xf5, 0x53, 0x5b, 0xee, 0x97, 0x7b, + 0xf7, 0x80, 0x09, 0xf6, 0x81, 0x76, 0xbd, 0x34, 0xf5, 0x9c, 0x48, 0x21, + 0x88, 0x25, 0x12, 0xcf, 0x9d, 0xf5, 0xcb, 0x9d, 0xcb, 0x59, 0xf5, 0x6c, + 0xd6, 0x11, 0x5c, 0x01, 0x85, 0xe0, 0x0e, 0xe6, 0xff, 0xf8, 0x3d, 0x08, + 0x07, 0x2b, 0x11, 0x7e, 0x4e, 0xd0, 0x00, 0xbf, 0x00, 0xed, 0x00, 0xfe, + 0x00, 0xe0, 0x00, 0xee, 0x00, 0x31, 0x00, 0x3b, 0x00, 0xe6, 0xae, 0xf3, + 0xa8, 0xbe, 0xd0, 0x77, 0x28, 0x18, 0x4b, 0x1f, 0xdc, 0xdd, 0xfa, 0x82, + 0x1f, 0x01, 0x60, 0x7d, 0x99, 0x46, 0x21, 0x73, 0x65, 0x80, 0x20, 0xf4, + 0xa7, 0xc3, 0xd7, 0x30, 0x05, 0x08, 0x82, 0xe2, 0x45, 0xf5, 0x85, 0x38, + 0xca, 0xf9, 0x41, 0x83, 0xee, 0x85, 0x77, 0x2a, 0x20, 0x26, 0x4b, 0x8f, + 0x64, 0x8c, 0x48, 0xab, 0xb8, 0x84, 0x9c, 0x3e, 0xe3, 0x1a, 0x98, 0x0c, + 0x86, 0x49, 0x85, 0x06, 0xab, 0xa5, 0x7c, 0x75, 0xaa, 0x25, 0x16, 0xe0, + 0x92, 0xae, 0x1c, 0xe4, 0x25, 0x46, 0xfc, 0x79, 0x09, 0x70, 0x03, 0xb7, + 0x84, 0x7a, 0x2e, 0x09, 0x2a, 0x57, 0xf7, 0xc3, 0x24, 0xc5, 0xba, 0xec, + 0x82, 0xb8, 0x1d, 0x90, 0x1a, 0xd2, 0x8e, 0x2b, 0x29, 0xaf, 0xda, 0x0e, + 0xbb, 0x3c, 0xff, 0x9d, 0xd7, 0x3a, 0x70, 0x59, 0xf8, 0x95, 0xc3, 0xd5, + 0x91, 0x4b, 0x44, 0x4b, 0x99, 0xfa, 0x25, 0xab, 0xa9, 0x92, 0x47, 0xa8, + 0xdb, 0x5c, 0x67, 0x86, 0xfb, 0x08, 0x51, 0x70, 0x51, 0x16, 0xa5, 0x78, + 0x55, 0xbd, 0x67, 0x59, 0xb3, 0x22, 0xe5, 0xe9, 0x6f, 0xfe, 0x58, 0xb7, + 0x76, 0x30, 0x23, 0x4c, 0x14, 0xfc, 0x66, 0xf8, 0x5c, 0xc8, 0x04, 0x7a, + 0xaf, 0x98, 0x76, 0x26, 0xfc, 0x0b, 0xe2, 0x0a, 0x9c, 0x4c, 0xf4, 0x9a, + 0x81, 0x1f, 0xed, 0x99, 0x29, 0x1f, 0xe0, 0x4d, 0x9a, 0x51, 0x50, 0x27, + 0xd1, 0xc9, 0x7f, 0x7e, 0x0c, 0x8b, 0x0b, 0xc9, 0xa9, 0x26, 0x6f, 0x09, + 0xd4, 0x2a, 0xbb, 0x5f, 0x0b, 0x58, 0x7f, 0x07, 0xcc, 0x09, 0x25, 0x83, + 0xc2, 0x11, 0x22, 0xb0, 0x08, 0x10, 0x69, 0xc8, 0x6b, 0x10, 0x61, 0xcd, + 0x26, 0x9e, 0xbf, 0x6a, 0xce, 0x6d, 0x83, 0x74, 0x71, 0x67, 0xf7, 0xac, + 0x22, 0x3c, 0x4c, 0xbc, 0x7c, 0x91, 0x1e, 0x50, 0xd4, 0xc3, 0x92, 0x7d, + 0x1b, 0x0a, 0x4d, 0x26, 0x01, 0x93, 0x7d, 0xc8, 0x47, 0xfc, 0xe5, 0x5d, + 0x9e, 0x54, 0x53, 0x72, 0xf2, 0x5e, 0xac, 0x22, 0x8d, 0x58, 0x0d, 0xe7, + 0xcb, 0x5a, 0x54, 0x80, 0x7d, 0xa4, 0x95, 0x66, 0x0a, 0x49, 0x1b, 0x8c, + 0x1b, 0x83, 0xc0, 0x54, 0x92, 0x6e, 0x06, 0x80, 0xee, 0xc7, 0x79, 0xf0, + 0xec, 0xd6, 0x5d, 0xa2, 0xb0, 0x5f, 0x30, 0xd2, 0x19, 0x86, 0x52, 0x8c, + 0x29, 0x25, 0xad, 0xc3, 0xca, 0xc5, 0x77, 0xd3, 0x1a, 0xaf, 0x40, 0x02, + 0x0a, 0x45, 0x8b, 0x9c, 0xd5, 0x48, 0x81, 0x70, 0xc6, 0xf5, 0x80, 0x18, + 0x2c, 0x7a, 0x8b, 0x03, 0x43, 0x68, 0xc4, 0xbb, 0xbb, 0xe1, 0x84, 0xa2, + 0x93, 0x1c, 0x5a, 0x12, 0x14, 0x30, 0xdf, 0x0d, 0x42, 0x21, 0xde, 0x8b, + 0xc6, 0x3b, 0x90, 0x25, 0x00, 0x8b, 0xc7, 0x29, 0x27, 0xe3, 0xd7, 0x39, + 0x70, 0x4d, 0x68, 0x8b, 0x64, 0xe1, 0x04, 0x25, 0x67, 0x09, 0x10, 0xde, + 0x25, 0xaf, 0x28, 0x93, 0x23, 0xf5, 0x10, 0xba, 0xd1, 0xa6, 0xc9, 0xf1, + 0x29, 0x88, 0x68, 0x69, 0x20, 0x82, 0x03, 0x73, 0x2d, 0x7b, 0x33, 0xa1, + 0xf5, 0x05, 0x26, 0x5d, 0x15, 0xbc, 0xce, 0x97, 0x1a, 0x88, 0xa1, 0x8a, + 0x3e, 0x19, 0x3b, 0xc9, 0x5e, 0x4b, 0x2e, 0xd3, 0x4e, 0xd7, 0x68, 0xf9, + 0x9a, 0x6d, 0xbb, 0xaa, 0x2b, 0x03, 0x30, 0xbb, 0x76, 0xbd, 0x92, 0x49, + 0x88, 0x6f, 0x92, 0x47, 0xda, 0xa9, 0x99, 0x20, 0xcd, 0xdc, 0x77, 0xb6, + 0xd1, 0x70, 0x1d, 0xb0, 0x1c, 0x5f, 0x81, 0xce, 0xf3, 0x5e, 0xd5, 0x1a, + 0x6f, 0xd6, 0x0e, 0x30, 0x45, 0x15, 0xad, 0x98, 0xa0, 0xe3, 0xd7, 0xc0, + 0x23, 0x5f, 0x38, 0xc3, 0xcc, 0x9e, 0xbd, 0x6e, 0x81, 0xb9, 0x9d, 0x65, + 0x18, 0xc0, 0x77, 0x0b, 0xcf, 0xf4, 0x7b, 0xcd, 0x0a, 0x12, 0x6e, 0x2b, + 0xf6, 0xb6, 0x35, 0x53, 0x66, 0x76, 0x84, 0xbb, 0xcf, 0x8f, 0x2b, 0xb0, + 0xa0, 0x7d, 0xa6, 0x62, 0xaa, 0x42, 0xa4, 0xe5, 0x52, 0x9d, 0x13, 0x06, + 0x65, 0xd0, 0x4f, 0x52, 0x5c, 0x85, 0x69, 0x50, 0x4a, 0x7c, 0xbe, 0xf5, + 0xf3, 0x35, 0xee, 0x83, 0xd1, 0x08, 0xc9, 0x0b, 0x91, 0x3a, 0x79, 0x71, + 0x3f, 0x8f, 0x92, 0x56, 0x8e, 0x18, 0x6f, 0xdf, 0x0f, 0xfc, 0xd4, 0x68, + 0x3c, 0xb4, 0x9c, 0xfd, 0x2a, 0xbf, 0xcd, 0xff, 0xc3, 0xa3, 0x82, 0xc9, + 0xa7, 0xc4, 0x82, 0x64, 0xa7, 0xfd, 0xab, 0xaa, 0x7e, 0xa5, 0x32, 0xe6, + 0x1b, 0x5e, 0xf9, 0x69, 0x1f, 0x6b, 0xac, 0xf8, 0xe2, 0xc5, 0x7a, 0x97, + 0x4a, 0x03, 0x01, 0x9f, 0xf8, 0x41, 0x64, 0x39, 0x28, 0x66, 0xc7, 0xd6, + 0x2b, 0xa9, 0xca, 0x8d, 0x60, 0x07, 0x0f, 0x7d, 0x24, 0xaa, 0x17, 0x9f, + 0x1b, 0x8e, 0xb6, 0x26, 0xbc, 0x0a, 0x7f, 0x1d, 0x82, 0x1b, 0x38, 0x20, + 0x11, 0x32, 0x0a, 0x0e, 0x21, 0x61, 0x49, 0xa1, 0x79, 0x6b, 0xcf, 0x2d, + 0x2c, 0x47, 0x06, 0xcd, 0x33, 0xba, 0x82, 0x21, 0xa4, 0x99, 0xf1, 0x13, + 0x27, 0xe2, 0xee, 0x0d, 0x5d, 0x29, 0x78, 0x43, 0xe7, 0x8c, 0x26, 0xfe, + 0xe7, 0x95, 0x2a, 0x8d, 0xc4, 0x95, 0x8b, 0xee, 0x25, 0x98, 0x57, 0x94, + 0x97, 0xdf, 0x95, 0xe4, 0xdf, 0xd6, 0x50, 0x4d, 0x1d, 0x04, 0x35, 0xd3, + 0x1f, 0x11, 0x9b, 0x84, 0x07, 0xd1, 0xcc, 0x5b, 0x80, 0x66, 0x46, 0x40, + 0xeb, 0x66, 0x4a, 0xa0, 0x2d, 0x5d, 0xfd, 0x77, 0x0f, 0x24, 0x64, 0xd5, + 0x97, 0x7d, 0x4e, 0x11, 0x91, 0xd0, 0xac, 0xd9, 0x22, 0x25, 0x7c, 0x38, + 0xa6, 0x76, 0xb3, 0x53, 0xb4, 0x43, 0x6d, 0xa6, 0xb3, 0xd9, 0x5e, 0xc9, + 0xdc, 0x8c, 0x94, 0x41, 0x65, 0xb8, 0x54, 0x93, 0xfe, 0x36, 0xbd, 0xbd, + 0x0c, 0x23, 0xec, 0x8a, 0xfb, 0x91, 0x88, 0x76, 0x80, 0x54, 0x56, 0x4b, + 0x6d, 0x8c, 0x23, 0xb6, 0xc2, 0x13, 0x94, 0x52, 0xb8, 0x04, 0x48, 0xe6, + 0xb1, 0x52, 0x1d, 0x48, 0xf2, 0xe4, 0xd8, 0x19, 0xe4, 0x5c, 0x38, 0x22, + 0x4d, 0x54, 0x43, 0xe2, 0x42, 0x42, 0x2b, 0x26, 0x9c, 0x14, 0xa4, 0x99, + 0x12, 0x22, 0x44, 0x90, 0xfa, 0x2e, 0xdc, 0xa0, 0x92, 0x04, 0x0d, 0xa8, + 0x6a, 0x9c, 0x0e, 0x5b, 0xf4, 0x4f, 0x52, 0xc1, 0x47, 0xc4, 0x2a, 0x7f, + 0x81, 0x1a, 0x56, 0x71, 0x88, 0x59, 0xa3, 0xe9, 0x11, 0x5a, 0x90, 0x44, + 0x2f, 0x68, 0x64, 0xa4, 0x33, 0xce, 0xeb, 0xd8, 0x46, 0x89, 0xfc, 0x6c, + 0xb2, 0xbc, 0xcd, 0xb4, 0xd9, 0x02, 0xd2, 0x39, 0x07, 0x27, 0x75, 0x06, + 0x34, 0xb0, 0xac, 0x48, 0xd3, 0x62, 0x04, 0xa9, 0x53, 0xfd, 0xa6, 0x7f, + 0x6f, 0x39, 0x21, 0x12, 0x75, 0x2a, 0x93, 0x5e, 0x61, 0x6f, 0x21, 0x6a, + 0x1e, 0x71, 0x2e, 0x83, 0x19, 0x20, 0x63, 0x20, 0x23, 0x1f, 0x92, 0xb1, + 0xae, 0x50, 0x20, 0xa5, 0x0f, 0x92, 0xc2, 0x49, 0xa5, 0xdd, 0xe0, 0x2c, + 0x44, 0x69, 0x3f, 0x2e, 0xed, 0x22, 0xa8, 0x33, 0x20, 0x0d, 0x2d, 0x32, + 0x8c, 0x70, 0x97, 0x21, 0xf5, 0x92, 0x09, 0x0c, 0xa0, 0x36, 0xcc, 0x8c, + 0xb5, 0xee, 0xca, 0x75, 0x09, 0x15, 0x80, 0xd8, 0xfd, 0x96, 0x4c, 0x6f, + 0x3d, 0x88, 0x3f, 0xe0, 0xb9, 0xca, 0xc8, 0x6e, 0xf3, 0x31, 0x71, 0x07, + 0x7e, 0x07, 0x46, 0x9a, 0x1b, 0xf6, 0x84, 0xde, 0x1d, 0x21, 0x0b, 0xa9, + 0x10, 0xca, 0x6b, 0xcd, 0x42, 0x59, 0x46, 0x0a, 0x5c, 0x42, 0x13, 0x79, + 0xad, 0x02, 0x95, 0xd4, 0xef, 0xdd, 0x3d, 0x4b, 0x58, 0xa8, 0x16, 0x48, + 0x7c, 0xea, 0xd6, 0xbb, 0xee, 0xd3, 0x23, 0xf7, 0x39, 0x76, 0xa2, 0xb5, + 0x20, 0x43, 0x4f, 0x27, 0x66, 0x7e, 0x77, 0x77, 0x8d, 0x43, 0x4c, 0xeb, + 0xd7, 0x27, 0xa1, 0xbf, 0xdd, 0x27, 0x8d, 0x48, 0xe7, 0xa7, 0xdc, 0x4b, + 0xb8, 0x6f, 0x90, 0xa8, 0x0a, 0xc4, 0xdb, 0x3d, 0xb4, 0xe2, 0x79, 0x5c, + 0xb1, 0x49, 0xee, 0xbc, 0xcd, 0xf8, 0xb2, 0xcd, 0x62, 0xb0, 0x5b, 0xed, + 0x4b, 0x2c, 0xf0, 0x6b, 0x8e, 0x16, 0x25, 0x5d, 0xe8, 0x12, 0xcc, 0x2e, + 0x3c, 0x22, 0xb5, 0x45, 0xd0, 0xbc, 0x86, 0x92, 0xb0, 0x8a, 0x90, 0x4d, + 0x1f, 0x99, 0x90, 0xb6, 0xac, 0xbc, 0xc4, 0x4d, 0xe2, 0xa4, 0xdc, 0x25, + 0x51, 0x4e, 0x75, 0x41, 0xee, 0xc8, 0xda, 0x7c, 0xbf, 0xfa, 0x12, 0xf2, + 0xc8, 0xac, 0x80, 0x88, 0xe9, 0xbc, 0x36, 0x4b, 0x5a, 0x2b, 0x7a, 0x10, + 0x81, 0x9f, 0x4b, 0xcc, 0x84, 0x49, 0x43, 0x4a, 0x67, 0x10, 0x2c, 0x72, + 0xc2, 0xf7, 0x77, 0xb1, 0x2a, 0x57, 0xef, 0xb2, 0xe7, 0xbc, 0x1b, 0xbf, + 0x24, 0x26, 0x89, 0xb3, 0xf3, 0x35, 0xd2, 0xd4, 0x8a, 0x51, 0x0e, 0xb8, + 0x16, 0x92, 0xc2, 0xc7, 0x4f, 0x2a, 0xaa, 0x9b, 0x64, 0x8b, 0xd2, 0x4e, + 0x78, 0xe1, 0x59, 0x0b, 0xb9, 0x7f, 0xc5, 0x0d, 0xe7, 0x16, 0x95, 0xc9, + 0xbe, 0x12, 0x24, 0x0b, 0xfe, 0x14, 0xbe, 0xb9, 0x4e, 0xf1, 0xf5, 0x3c, + 0x0c, 0xe0, 0x6a, 0x18, 0x63, 0x92, 0x28, 0x7a, 0x52, 0x35, 0x95, 0x4b, + 0xd0, 0x4f, 0x25, 0x6f, 0xa2, 0xac, 0x64, 0x4d, 0x30, 0xa9, 0x22, 0x5b, + 0x8a, 0x42, 0x56, 0x65, 0x38, 0x23, 0x1a, 0x7d, 0xb5, 0x3f, 0xc5, 0x3d, + 0xb4, 0x91, 0xff, 0x0d, 0x0b, 0x9d, 0xae, 0x8f, 0x3b, 0x05, 0xe0, 0x90, + 0xc4, 0x96, 0xb7, 0x42, 0x52, 0x91, 0x19, 0xa7, 0xa6, 0x15, 0xd3, 0x2f, + 0x44, 0x68, 0x16, 0x72, 0xbb, 0xe5, 0xa6, 0x3e, 0xbd, 0xd4, 0xd4, 0x53, + 0x53, 0xc9, 0xd4, 0xdc, 0x28, 0x44, 0x4b, 0x37, 0xe0, 0x5c, 0xed, 0xb1, + 0x26, 0xaa, 0xd0, 0xfe, 0x1a, 0xba, 0x90, 0x1e, 0x8e, 0xed, 0x35, 0xc2, + 0x55, 0x16, 0x30, 0xbd, 0x4b, 0xca, 0x31, 0xb0, 0xb8, 0x9c, 0xd2, 0xf4, + 0x9e, 0xad, 0x1b, 0x42, 0x65, 0x7f, 0xb6, 0x61, 0x0e, 0x9b, 0x78, 0xed, + 0x51, 0x48, 0x0b, 0xec, 0x2a, 0x35, 0x84, 0xdb, 0xb1, 0xcd, 0xeb, 0xf3, + 0xb8, 0xed, 0x95, 0xeb, 0x6b, 0x14, 0xd1, 0x95, 0x7b, 0x47, 0x0d, 0xf1, + 0xe8, 0xc9, 0x17, 0x45, 0x0a, 0x90, 0xfd, 0xb1, 0x2a, 0x0e, 0xf0, 0xfb, + 0xaf, 0xab, 0x08, 0x83, 0x76, 0xfd, 0x4f, 0x30, 0x71, 0xac, 0xb1, 0x6f, + 0x61, 0xdb, 0x72, 0x61, 0xfd, 0xcc, 0x20, 0x29, 0x5f, 0x7c, 0xc5, 0x6b, + 0x32, 0x22, 0xfe, 0x7b, 0x1a, 0xfe, 0x47, 0x4d, 0xa3, 0x73, 0xe1, 0xf9, + 0x4e, 0x39, 0xb5, 0xc2, 0xb5, 0xe4, 0xdf, 0x60, 0x2a, 0x3e, 0x05, 0x60, + 0x02, 0xa3, 0xab, 0x22, 0x2c, 0xa3, 0x45, 0x4e, 0x19, 0x3f, 0x45, 0x9e, + 0xa9, 0x43, 0xb8, 0xba, 0x21, 0x88, 0x89, 0x36, 0x3e, 0x21, 0x61, 0xb5, + 0xeb, 0xbe, 0xb8, 0x78, 0x64, 0xdf, 0x8a, 0xb0, 0xac, 0xf4, 0x58, 0x5c, + 0xaa, 0x53, 0xfa, 0x29, 0x01, 0x4b, 0x23, 0x62, 0xf5, 0x25, 0xc1, 0xa5, + 0xda, 0x29, 0x3f, 0x95, 0x23, 0xe3, 0xdc, 0xfc, 0xd2, 0xba, 0x61, 0x95, + 0x3a, 0x2a, 0xdc, 0x7d, 0xfa, 0xd5, 0x38, 0x3e, 0x98, 0x27, 0x79, 0xe7, + 0xe5, 0xc6, 0x12, 0x53, 0x87, 0xc9, 0xb4, 0x32, 0xb5, 0xad, 0x15, 0xd7, + 0xc9, 0x75, 0x55, 0x8e, 0x0b, 0x3d, 0x5c, 0x35, 0x4f, 0x39, 0x57, 0x1a, + 0x16, 0x40, 0x3a, 0x2c, 0x60, 0x42, 0x62, 0xda, 0x62, 0x6f, 0xd2, 0xb8, + 0x50, 0x56, 0xcb, 0x6f, 0x1d, 0x9c, 0x1a, 0x9a, 0x9a, 0xb8, 0x5c, 0x85, + 0x5c, 0x71, 0xb3, 0x4d, 0x20, 0x2c, 0x34, 0x51, 0x07, 0xdd, 0x9f, 0xca, + 0x1d, 0x60, 0x39, 0xd5, 0x24, 0x4c, 0x54, 0x4f, 0xbb, 0xd6, 0xc3, 0xb0, + 0x81, 0x5d, 0xa2, 0x45, 0x34, 0x36, 0xf7, 0x61, 0xcd, 0x27, 0x14, 0x97, + 0xed, 0x6f, 0xde, 0x78, 0x7f, 0x0b, 0x63, 0x23, 0x1f, 0xcb, 0x72, 0x7c, + 0x0b, 0x6d, 0x33, 0x96, 0xf1, 0xed, 0xa2, 0x7d, 0x74, 0xc9, 0x18, 0x3b, + 0xf5, 0x2a, 0x9c, 0xbb, 0xdf, 0xcc, 0x88, 0x3a, 0xc4, 0xdc, 0x46, 0xf7, + 0xf7, 0xe5, 0x5c, 0xc0, 0x6a, 0x32, 0x19, 0xa2, 0xc6, 0xcb, 0xea, 0x7b, + 0x5b, 0x16, 0xa2, 0x01, 0xc2, 0x2c, 0xb0, 0xc0, 0x27, 0x3e, 0xb7, 0xea, + 0x75, 0xd6, 0x0a, 0x9b, 0x8e, 0x7b, 0xa1, 0x08, 0xdf, 0x8f, 0x9e, 0x7e, + 0x45, 0xfc, 0x8c, 0x6e, 0xf1, 0x22, 0x64, 0xfb, 0x3e, 0x75, 0x70, 0x14, + 0xff, 0xa3, 0x0d, 0x05, 0xb2, 0xeb, 0xb3, 0x9b, 0x5b, 0xa4, 0x87, 0xde, + 0xf9, 0x9f, 0x0f, 0x86, 0x29, 0x1c, 0xb8, 0x64, 0x83, 0xb0, 0xec, 0xa7, + 0xa7, 0xa6, 0xca, 0xa2, 0x2b, 0x1c, 0xca, 0xed, 0x46, 0x44, 0xea, 0xf4, + 0xc1, 0xd1, 0x15, 0x06, 0xe6, 0xb2, 0x7c, 0x72, 0x8a, 0xff, 0x23, 0x67, + 0xf9, 0x4b, 0x06, 0x38, 0xf6, 0x9b, 0x10, 0x45, 0x25, 0xf0, 0xae, 0x8b, + 0x6e, 0x65, 0x8f, 0x8a, 0x2b, 0xb4, 0xea, 0x3f, 0x84, 0xb9, 0x28, 0x80, + 0x88, 0x56, 0xf6, 0x85, 0xae, 0xdf, 0xe4, 0x2c, 0xf0, 0xba, 0xe1, 0xbc, + 0x77, 0x32, 0xab, 0x0e, 0x92, 0x94, 0x8a, 0x90, 0x88, 0x37, 0xe0, 0x94, + 0x1b, 0x43, 0xb2, 0x6c, 0x56, 0x64, 0xca, 0x1a, 0xda, 0x45, 0xd1, 0x15, + 0xa5, 0x00, 0x6f, 0x1d, 0x84, 0xd2, 0x45, 0xa6, 0x37, 0x65, 0xf5, 0x1d, + 0x23, 0xb2, 0xa5, 0x18, 0x17, 0x5a, 0xa0, 0x28, 0x12, 0xbf, 0x94, 0xe1, + 0x7e, 0x7c, 0xc7, 0x28, 0xd8, 0xc0, 0x52, 0xb3, 0x92, 0x67, 0x6f, 0x11, + 0xa1, 0xc3, 0x08, 0x27, 0xb9, 0x4d, 0x44, 0x57, 0x9e, 0x03, 0x10, 0xa0, + 0x6c, 0x89, 0x5c, 0xcc, 0x03, 0x94, 0xe8, 0x9d, 0x95, 0x8c, 0xc6, 0xcd, + 0xfd, 0xde, 0xa7, 0x5b, 0x8d, 0xfd, 0x85, 0xf5, 0xf9, 0x96, 0x0d, 0xda, + 0x64, 0x25, 0xf2, 0xc7, 0x90, 0xa0, 0xfb, 0xb8, 0x7f, 0x1d, 0xe1, 0x5d, + 0x87, 0x10, 0x50, 0x81, 0x1f, 0x5a, 0x2b, 0x04, 0x8d, 0x90, 0x37, 0xf4, + 0xf5, 0xa6, 0x4e, 0xd6, 0xca, 0x81, 0xba, 0x1e, 0x43, 0x2a, 0x00, 0x68, + 0xa4, 0xff, 0xf8, 0x3d, 0x08, 0x08, 0x2b, 0x11, 0x39, 0x4e, 0xfe, 0x00, + 0x03, 0x00, 0xff, 0x00, 0xff, 0x00, 0x02, 0x00, 0xfa, 0x00, 0xff, 0x00, + 0x00, 0x00, 0xe7, 0x16, 0xc1, 0xaa, 0x78, 0x8c, 0x07, 0x96, 0x4f, 0x9e, + 0xf1, 0x69, 0x20, 0xd2, 0x4c, 0x34, 0x85, 0x5a, 0x3e, 0xa3, 0xba, 0xda, + 0xb0, 0xcb, 0xef, 0xf7, 0x1b, 0x59, 0x50, 0x33, 0x28, 0xd7, 0x04, 0x37, + 0xe0, 0x6e, 0xa0, 0x52, 0x9c, 0xc5, 0xba, 0x8f, 0x1e, 0x96, 0x59, 0x75, + 0xef, 0xc9, 0x00, 0x12, 0x5f, 0x29, 0x6f, 0x5a, 0xc6, 0xa4, 0xe8, 0xf9, + 0xcd, 0x49, 0xda, 0x55, 0x24, 0xa1, 0xee, 0xee, 0xb1, 0x76, 0x6d, 0xc8, + 0x9d, 0xdb, 0xf2, 0x32, 0x99, 0x22, 0xb5, 0xce, 0x42, 0x2d, 0x6b, 0xc5, + 0x63, 0x76, 0x65, 0x6d, 0xc4, 0x44, 0x18, 0xa2, 0x30, 0x8e, 0x37, 0x51, + 0x8f, 0x70, 0x85, 0xe5, 0x02, 0x79, 0x9e, 0x38, 0xda, 0x18, 0x07, 0xca, + 0x26, 0x66, 0x98, 0x84, 0x13, 0xcb, 0x11, 0x4c, 0xb1, 0x46, 0xa8, 0x07, + 0x35, 0x3e, 0x80, 0xa7, 0xe1, 0x03, 0x20, 0x7f, 0x03, 0xde, 0xc4, 0x57, + 0x45, 0xa6, 0x6f, 0xe2, 0x0e, 0xbb, 0xf1, 0x02, 0x45, 0xe1, 0x2f, 0xbf, + 0x91, 0x4f, 0xd7, 0xed, 0x01, 0xe0, 0x44, 0xf2, 0x68, 0x36, 0x35, 0x50, + 0xc2, 0x4e, 0xe1, 0x66, 0x73, 0x60, 0xcb, 0xbf, 0x8b, 0x70, 0x6c, 0xb4, + 0x42, 0x3e, 0x05, 0x89, 0x8b, 0x0e, 0x78, 0x26, 0xe1, 0x76, 0x28, 0x2b, + 0x7f, 0xe4, 0xda, 0x3a, 0x17, 0x7f, 0x9b, 0x49, 0x34, 0xaf, 0x7d, 0xda, + 0xbc, 0x4c, 0x7f, 0x4f, 0xfe, 0x73, 0xbb, 0x85, 0xf6, 0x2b, 0xc8, 0xcc, + 0x7f, 0xc9, 0x74, 0x2e, 0x59, 0x6c, 0x1d, 0x9a, 0xd8, 0x13, 0x12, 0xd5, + 0xff, 0x44, 0x66, 0x91, 0x67, 0x5c, 0x20, 0x29, 0xa7, 0xa4, 0xcd, 0xe7, + 0x21, 0x85, 0xaa, 0xc9, 0x73, 0xdd, 0xbe, 0x16, 0xb6, 0x29, 0x9f, 0x21, + 0xf1, 0xd2, 0x01, 0x76, 0x3d, 0x12, 0x2b, 0x39, 0x81, 0x36, 0x86, 0xb5, + 0x7a, 0x8e, 0xd5, 0xea, 0x7b, 0x94, 0xa5, 0x41, 0xd5, 0x3c, 0x81, 0x34, + 0x89, 0x3a, 0x20, 0x27, 0x5b, 0x26, 0xe1, 0x17, 0x54, 0xab, 0x0e, 0xcd, + 0x82, 0x87, 0xca, 0x25, 0xff, 0x70, 0x3c, 0xe4, 0xa0, 0xec, 0xef, 0x1c, + 0x76, 0x9b, 0x79, 0xf7, 0x24, 0xf5, 0xa3, 0xea, 0xa3, 0xde, 0x56, 0x09, + 0x3a, 0xec, 0x1c, 0xa4, 0x90, 0x4c, 0x72, 0xf9, 0xcb, 0x8f, 0x37, 0x66, + 0x45, 0xc3, 0xbf, 0xf4, 0x57, 0xa6, 0xb6, 0x2a, 0x2f, 0xe1, 0xa4, 0x47, + 0xe4, 0x84, 0x83, 0xb1, 0xb0, 0x76, 0x7c, 0x25, 0xda, 0x1d, 0x0b, 0xbf, + 0xfc, 0xbb, 0x30, 0x8f, 0x7e, 0xe3, 0x01, 0x36, 0x3f, 0x7c, 0xb2, 0x0a, + 0x64, 0xa9, 0xaf, 0xf1, 0x09, 0x9f, 0xf4, 0xab, 0x98, 0xa0, 0xf9, 0x2f, + 0xb5, 0x59, 0x76, 0x7e, 0x63, 0xc6, 0x92, 0xb7, 0xd2, 0x41, 0x9e, 0xa6, + 0x99, 0x50, 0x8a, 0x43, 0x89, 0xe4, 0xd8, 0x76, 0x62, 0x62, 0xad, 0xc4, + 0xb9, 0x56, 0x0c, 0xf5, 0x02, 0x64, 0x29, 0xfd, 0xa7, 0x8c, 0x65, 0xe3, + 0x66, 0x0e, 0x46, 0x7e, 0xd4, 0xc1, 0x45, 0xcb, 0xbd, 0xeb, 0xdf, 0x9e, + 0x5e, 0x4f, 0x37, 0xc4, 0x7d, 0x53, 0xff, 0xe4, 0x8c, 0x6d, 0x88, 0x1e, + 0x7f, 0x11, 0xe0, 0x7d, 0x56, 0x8c, 0x9f, 0x1e, 0x76, 0x48, 0x92, 0x97, + 0x79, 0x01, 0x15, 0x64, 0x1a, 0xe1, 0xa2, 0x7e, 0xde, 0x8e, 0x1e, 0xf6, + 0xd6, 0x28, 0x30, 0x44, 0xc2, 0xbf, 0xcd, 0xca, 0x21, 0x37, 0x88, 0x0e, + 0xcd, 0x21, 0xff, 0xc0, 0x2e, 0x5c, 0xee, 0x52, 0x01, 0x91, 0x8a, 0x7b, + 0xcf, 0x7a, 0x78, 0xc5, 0xe5, 0x9f, 0x10, 0x91, 0xbf, 0x1f, 0x85, 0x7a, + 0x2f, 0xa0, 0xcb, 0x94, 0x25, 0x2c, 0x0e, 0xb3, 0x40, 0x55, 0x1b, 0x98, + 0x92, 0xb7, 0x7b, 0xf1, 0xe3, 0x07, 0x26, 0x18, 0x10, 0x78, 0x25, 0x55, + 0x89, 0x75, 0xdd, 0x05, 0xda, 0x64, 0xc9, 0xff, 0xcc, 0x4d, 0x9c, 0x8e, + 0x3e, 0x12, 0xe1, 0x5b, 0xac, 0x0c, 0x40, 0xf3, 0xf1, 0x04, 0x62, 0x7b, + 0x05, 0x53, 0x1c, 0x63, 0xd5, 0x1a, 0x07, 0x6b, 0x89, 0x90, 0xc6, 0x7c, + 0x71, 0xb6, 0x9c, 0x60, 0x96, 0x56, 0x20, 0xd5, 0xf1, 0x9f, 0x98, 0xfa, + 0x46, 0xa4, 0x73, 0x64, 0x7f, 0xe2, 0x56, 0x43, 0xf9, 0x23, 0x65, 0x48, + 0x77, 0xe6, 0x3e, 0x26, 0xa6, 0xae, 0x1c, 0x08, 0xd0, 0x0a, 0x9c, 0x09, + 0x04, 0x74, 0xcb, 0xb0, 0x4a, 0xf7, 0xe8, 0x27, 0x8d, 0x8e, 0x85, 0x71, + 0x13, 0x39, 0x3f, 0xb4, 0xc5, 0x22, 0x4e, 0x76, 0x53, 0x97, 0x32, 0xa1, + 0xa8, 0xa4, 0x90, 0x3d, 0x40, 0x8d, 0x63, 0xdf, 0x69, 0xff, 0xa8, 0x56, + 0x84, 0xa4, 0xc4, 0x5f, 0x07, 0xa9, 0x81, 0x8b, 0xb6, 0x50, 0x49, 0x48, + 0xb6, 0x20, 0x58, 0x54, 0xaa, 0xbc, 0x18, 0x74, 0x44, 0x81, 0x09, 0xd5, + 0xdc, 0x1b, 0xb6, 0xda, 0x9d, 0x05, 0x15, 0xab, 0x92, 0x73, 0x22, 0x3d, + 0xf1, 0xbc, 0x4e, 0x29, 0xf6, 0x20, 0x6d, 0x91, 0x87, 0x96, 0x2a, 0xd8, + 0x38, 0x20, 0x05, 0x4b, 0x61, 0x3c, 0xe4, 0xc2, 0xda, 0xdd, 0x2c, 0x20, + 0x24, 0x55, 0x79, 0x3f, 0xcc, 0xa2, 0x09, 0x09, 0x81, 0xeb, 0x98, 0xbd, + 0xc0, 0xd5, 0x94, 0xcb, 0x06, 0x4c, 0x80, 0x3f, 0xb0, 0xea, 0x2f, 0x1d, + 0x10, 0x6c, 0x1f, 0x9a, 0xf6, 0xdf, 0xa1, 0x69, 0xd4, 0x53, 0xe0, 0xae, + 0x9e, 0x6a, 0x16, 0xb4, 0x1f, 0x6d, 0x38, 0xb5, 0x53, 0xf3, 0x31, 0x71, + 0x0b, 0xb1, 0xed, 0x92, 0x9a, 0x1e, 0x1a, 0x89, 0x54, 0x91, 0x82, 0x3b, + 0x91, 0x49, 0x15, 0xae, 0xc9, 0x18, 0xa9, 0x19, 0x65, 0x45, 0xcc, 0x5d, + 0x02, 0x3a, 0xbe, 0x55, 0xb4, 0x7c, 0x9e, 0x4e, 0x38, 0x3d, 0x83, 0xee, + 0xec, 0x18, 0x81, 0x4b, 0xa2, 0xb0, 0x51, 0x58, 0xdb, 0x46, 0xc8, 0x43, + 0x10, 0x50, 0x27, 0x1e, 0xec, 0xb4, 0xed, 0x00, 0x23, 0xf1, 0x52, 0x47, + 0xad, 0x6e, 0x00, 0xba, 0xfb, 0xd7, 0x2a, 0xf7, 0x18, 0xe0, 0xea, 0x97, + 0x78, 0xad, 0xd6, 0x66, 0xf6, 0x5b, 0x4f, 0xe8, 0x24, 0x99, 0x15, 0xe4, + 0xdf, 0x05, 0x63, 0x44, 0x75, 0x97, 0x34, 0x1d, 0xed, 0x86, 0x25, 0xf6, + 0x94, 0xba, 0x55, 0x6c, 0x01, 0x8f, 0x62, 0x01, 0x44, 0xa4, 0x5d, 0xe0, + 0x86, 0x44, 0x54, 0x12, 0x88, 0x94, 0x9b, 0xfa, 0xba, 0x8c, 0x01, 0x38, + 0xb8, 0x29, 0x66, 0x6f, 0xa5, 0x3a, 0x91, 0x37, 0x1d, 0xe2, 0xab, 0x76, + 0xb2, 0x92, 0xb7, 0x62, 0xeb, 0xfd, 0xf3, 0xbe, 0xbc, 0x3f, 0xbb, 0x62, + 0xdf, 0xc6, 0xe4, 0xee, 0xba, 0x18, 0xff, 0x54, 0xb2, 0xa1, 0x12, 0xe0, + 0xb7, 0x76, 0x01, 0xef, 0x18, 0x00, 0xa0, 0xc3, 0xa1, 0xdd, 0x1c, 0x03, + 0x5c, 0x50, 0x6e, 0x38, 0x9d, 0x5f, 0x54, 0xee, 0x98, 0xd8, 0xb1, 0xd6, + 0x37, 0x1d, 0xd2, 0x5d, 0xbd, 0xa6, 0x21, 0xca, 0xf5, 0xad, 0xa5, 0x22, + 0x22, 0xd1, 0x7a, 0x84, 0xf1, 0x04, 0x49, 0x67, 0xba, 0x20, 0x0e, 0x88, + 0x29, 0x10, 0xc4, 0xd6, 0xd5, 0x00, 0x40, 0xe6, 0xa2, 0x83, 0x08, 0xd8, + 0x11, 0xaa, 0xcd, 0x96, 0xaf, 0xe3, 0xb4, 0x16, 0xbe, 0xb8, 0x77, 0xca, + 0x29, 0x41, 0x6b, 0xa6, 0xc8, 0xaa, 0x89, 0xf2, 0x68, 0x15, 0x6d, 0x0c, + 0x5b, 0x39, 0x82, 0xa7, 0x70, 0x0d, 0xed, 0xd6, 0x9e, 0xce, 0xb7, 0x4a, + 0x78, 0x91, 0xee, 0x81, 0x13, 0x94, 0x25, 0x50, 0xce, 0x48, 0x8a, 0xc9, + 0x34, 0xe2, 0x44, 0x68, 0x4c, 0x6e, 0x96, 0x19, 0x2b, 0x18, 0x58, 0xc8, + 0xae, 0x30, 0x39, 0x1c, 0x23, 0x63, 0xc5, 0x2e, 0xf1, 0x0a, 0x65, 0x89, + 0x4f, 0x93, 0xfd, 0x6a, 0x12, 0xc1, 0x46, 0x1b, 0xc0, 0xc7, 0x27, 0x91, + 0x0a, 0x8c, 0xc5, 0x2a, 0x92, 0xba, 0xfa, 0x97, 0xa3, 0xcb, 0x90, 0x47, + 0x77, 0x71, 0x9d, 0x9c, 0xb7, 0xc8, 0x16, 0x35, 0x2b, 0x37, 0xe3, 0xd4, + 0x9a, 0x48, 0x27, 0x7b, 0x1c, 0x94, 0x87, 0xc9, 0x70, 0x02, 0x45, 0x1e, + 0xa8, 0x47, 0x68, 0x9d, 0xc4, 0x90, 0xe7, 0xf0, 0x9a, 0x0d, 0xfe, 0xc9, + 0x60, 0x63, 0x7c, 0xce, 0xfa, 0x69, 0x2f, 0x6c, 0x15, 0x40, 0x6d, 0xbf, + 0x7c, 0xfa, 0xee, 0x11, 0xa3, 0x31, 0x54, 0xe4, 0xf2, 0x6e, 0xe6, 0x1f, + 0x99, 0x43, 0xa6, 0x30, 0xda, 0x48, 0xb6, 0x8a, 0xa0, 0x84, 0x44, 0x22, + 0x93, 0x36, 0xca, 0xd9, 0xc5, 0xc0, 0x47, 0x4b, 0x85, 0xb5, 0x55, 0xf5, + 0xf1, 0x9b, 0x79, 0xd5, 0x41, 0xb6, 0xa4, 0xf3, 0x8d, 0xc0, 0x05, 0x5b, + 0xba, 0x8f, 0xff, 0x0f, 0x59, 0xae, 0x65, 0x0d, 0x16, 0x0d, 0x71, 0xdf, + 0x9e, 0x24, 0x5f, 0x59, 0xb8, 0x98, 0x2d, 0xf3, 0x17, 0xd3, 0x70, 0xda, + 0xbf, 0x8d, 0x55, 0xa4, 0x94, 0x6c, 0x3c, 0xc0, 0x7b, 0x77, 0xa7, 0xa9, + 0xb3, 0x4d, 0xfa, 0x13, 0x24, 0xb9, 0x6a, 0x5b, 0x2a, 0x4b, 0xd4, 0xd4, + 0x1d, 0x99, 0x62, 0x3c, 0xd1, 0x24, 0x2e, 0x3f, 0x8d, 0x83, 0x95, 0xe9, + 0x88, 0x25, 0xff, 0x2c, 0x62, 0xe3, 0xc1, 0xb3, 0x57, 0x9e, 0xec, 0x6d, + 0x7e, 0x6e, 0x68, 0x68, 0x6f, 0x4a, 0x80, 0x36, 0x0a, 0xd1, 0x53, 0x9a, + 0x43, 0x52, 0x3f, 0x6f, 0xa6, 0x67, 0xe3, 0x58, 0xa6, 0x39, 0x1a, 0xa5, + 0x93, 0x49, 0x66, 0xe3, 0xa5, 0x08, 0xb3, 0xd5, 0x7f, 0x03, 0xd3, 0x99, + 0x89, 0x65, 0x9e, 0x22, 0x91, 0xc2, 0xdc, 0xab, 0x52, 0x9e, 0xeb, 0x5c, + 0x34, 0x03, 0x5c, 0x94, 0x4b, 0xc2, 0xd5, 0x67, 0x46, 0xc6, 0x74, 0x47, + 0xe4, 0x00, 0x44, 0x36, 0xef, 0x54, 0xf7, 0x8e, 0x49, 0x77, 0xa7, 0x22, + 0x13, 0xc4, 0x90, 0x85, 0xb6, 0x96, 0xb5, 0x18, 0xd7, 0x91, 0x22, 0x17, + 0xed, 0xac, 0xf6, 0x46, 0xb5, 0x7b, 0xa9, 0x54, 0xce, 0xe2, 0xa3, 0xf7, + 0xe9, 0x73, 0x9e, 0x83, 0xe9, 0x5b, 0x37, 0xb0, 0xde, 0x2d, 0xe6, 0xf3, + 0x7b, 0x95, 0x15, 0xc1, 0xdb, 0x91, 0x71, 0xdd, 0x95, 0x4a, 0xd5, 0xb1, + 0x3a, 0x3e, 0x66, 0x93, 0xff, 0x69, 0xa7, 0x3e, 0xe9, 0x47, 0x59, 0x06, + 0x2b, 0xf1, 0x4b, 0xfe, 0x66, 0xab, 0x0d, 0x14, 0xe9, 0xe7, 0xcf, 0x9e, + 0x3f, 0xb4, 0x6a, 0x20, 0xf2, 0x84, 0xbc, 0x26, 0xf0, 0xbd, 0x46, 0xc8, + 0x13, 0x1c, 0x9b, 0x67, 0x00, 0x38, 0xb9, 0xa8, 0x8d, 0xb2, 0x64, 0x47, + 0x5b, 0x6a, 0x44, 0x0f, 0x56, 0x64, 0xd9, 0x48, 0x0a, 0xce, 0x54, 0x7a, + 0x9a, 0xbd, 0x7d, 0xf6, 0x9d, 0x91, 0x71, 0xea, 0x73, 0xd5, 0x8b, 0x8f, + 0x7c, 0x1e, 0xbf, 0x56, 0xac, 0xb3, 0xc5, 0x5a, 0xf8, 0xd2, 0xdd, 0xb5, + 0x67, 0xbf, 0x0d, 0xb0, 0xac, 0x7d, 0xee, 0x3d, 0xfb, 0x57, 0x5b, 0xd4, + 0x55, 0x83, 0x4f, 0xb0, 0x4b, 0x1b, 0x38, 0x97, 0xbd, 0x89, 0x78, 0x7c, + 0xa3, 0xe3, 0x0a, 0x72, 0x30, 0x30, 0xbd, 0xc7, 0x3e, 0x12, 0xfc, 0x5b, + 0x13, 0xb8, 0x9e, 0x3c, 0x98, 0x44, 0x7b, 0x3b, 0x73, 0x32, 0xb9, 0x72, + 0x72, 0xe7, 0xce, 0x8e, 0xe0, 0xee, 0x55, 0xa4, 0xb3, 0x21, 0x27, 0xf9, + 0x64, 0x8b, 0x3a, 0x60, 0x06, 0xd9, 0x7f, 0x74, 0xe7, 0x7e, 0x56, 0x52, + 0xd4, 0x62, 0x6c, 0x76, 0x75, 0x9a, 0xe9, 0xdf, 0x7a, 0xc9, 0x2f, 0x62, + 0x20, 0xc5, 0xcb, 0x8c, 0xbf, 0x12, 0x4a, 0x36, 0xac, 0xf8, 0x31, 0x71, + 0x62, 0x7d, 0xc5, 0xd9, 0x93, 0x92, 0xad, 0x36, 0x91, 0xaa, 0xfd, 0xa1, + 0xb6, 0x5c, 0xa8, 0xc6, 0x9e, 0x38, 0x38, 0xb4, 0xc1, 0x70, 0x02, 0xc4, + 0x82, 0xf8, 0x87, 0x6f, 0x04, 0x16, 0x0a, 0x78, 0x10, 0xd4, 0x29, 0xd0, + 0x51, 0xe1, 0xc9, 0xc6, 0x50, 0x2b, 0xd1, 0x67, 0x93, 0xc9, 0x6e, 0x0a, + 0x53, 0x47, 0xb9, 0x6d, 0x25, 0x5f, 0xb8, 0x1c, 0x8c, 0x12, 0x71, 0xc4, + 0x0e, 0x96, 0xf2, 0xf9, 0xb5, 0x14, 0xab, 0x65, 0xc0, 0x6c, 0xd9, 0x59, + 0xaa, 0x15, 0x65, 0x1e, 0xf2, 0x6d, 0x97, 0x1c, 0xe3, 0xc6, 0x8f, 0x6f, + 0x3a, 0x18, 0xa7, 0x36, 0x39, 0x69, 0xf6, 0x53, 0xe9, 0x0a, 0x56, 0x6f, + 0x32, 0xa8, 0xe3, 0x26, 0x88, 0x36, 0x0b, 0x5e, 0xb6, 0x1a, 0x0c, 0xf3, + 0xa3, 0xcb, 0x96, 0xfc, 0xbc, 0x27, 0xc9, 0x11, 0x70, 0x4f, 0x01, 0xac, + 0x85, 0xa5, 0x1a, 0x7c, 0xf7, 0xc2, 0x14, 0x12, 0x0c, 0xbb, 0x2f, 0xb8, + 0xc8, 0x2a, 0xe2, 0x9b, 0x58, 0xc7, 0x84, 0xe9, 0xe9, 0xea, 0xb4, 0x26, + 0xbe, 0x8d, 0x2f, 0x2b, 0xb7, 0x4a, 0x6f, 0x52, 0xa5, 0xf6, 0x34, 0x72, + 0xce, 0x32, 0xa7, 0xde, 0xf0, 0xec, 0x1d, 0x72, 0x32, 0xa6, 0xe8, 0xb9, + 0x74, 0x19, 0xb7, 0x35, 0xa2, 0x5c, 0x56, 0x4a, 0xcc, 0x53, 0x4b, 0x4b, + 0x5b, 0x32, 0xd4, 0xca, 0x96, 0x4a, 0x96, 0xc2, 0x4a, 0x79, 0x56, 0xe4, + 0xef, 0xaa, 0x87, 0xf4, 0xed, 0xc1, 0x06, 0xfe, 0xb5, 0x45, 0x40, 0xf9, + 0x4a, 0xff, 0xf8, 0x3d, 0x08, 0x09, 0x2b, 0x11, 0x52, 0x4c, 0xfe, 0x00, + 0x01, 0x00, 0x03, 0x00, 0x05, 0x00, 0x06, 0x00, 0x09, 0x00, 0x0a, 0x00, + 0xe6, 0xa4, 0xf2, 0xce, 0xf2, 0x68, 0x38, 0x35, 0xf6, 0xf6, 0x31, 0x34, + 0x7d, 0x62, 0x84, 0xbc, 0x0a, 0xc7, 0xab, 0x21, 0x9e, 0xa8, 0xda, 0xe8, + 0x0f, 0x0d, 0x74, 0x71, 0xec, 0xaf, 0xc8, 0x88, 0x85, 0x87, 0x8e, 0x50, + 0x04, 0x2e, 0x8a, 0xee, 0xeb, 0x67, 0x2f, 0xa3, 0x58, 0x84, 0x9d, 0x0b, + 0xea, 0x85, 0x9b, 0x7c, 0x64, 0x98, 0x6c, 0xb9, 0x37, 0xfc, 0x95, 0x63, + 0x09, 0x58, 0x9a, 0x72, 0x3f, 0xe5, 0x49, 0x6b, 0x64, 0x15, 0x4a, 0xa2, + 0xf1, 0xc8, 0x52, 0x04, 0xfd, 0x8c, 0xee, 0xad, 0x38, 0x5d, 0x8b, 0xae, + 0x89, 0x40, 0x89, 0xb7, 0x96, 0x2a, 0x49, 0x0a, 0xa9, 0x3a, 0xcd, 0x29, + 0xdc, 0x04, 0xa7, 0xfa, 0xb4, 0x80, 0xea, 0x5c, 0x7e, 0x53, 0x0c, 0xc9, + 0xc2, 0x22, 0x65, 0x24, 0x15, 0x3f, 0x29, 0xbd, 0x84, 0x86, 0x89, 0x41, + 0xab, 0xa9, 0x71, 0xde, 0x65, 0x03, 0xb0, 0xd1, 0x70, 0x43, 0x1c, 0x0a, + 0xab, 0x77, 0x21, 0xb3, 0x22, 0xab, 0xd8, 0x4d, 0xcc, 0xe2, 0x62, 0xa6, + 0x50, 0x16, 0x7e, 0x95, 0xa7, 0xf0, 0x50, 0x30, 0x8f, 0x02, 0x8a, 0xb9, + 0xe3, 0x07, 0xc5, 0xbe, 0xc8, 0x58, 0x51, 0x6f, 0x01, 0x6d, 0x6e, 0x30, + 0x90, 0xf1, 0xb6, 0x83, 0x18, 0x81, 0x48, 0xe7, 0x01, 0x3b, 0x54, 0x99, + 0x33, 0xe1, 0x83, 0x21, 0xd0, 0xdd, 0xc6, 0xec, 0x02, 0x9d, 0x3e, 0xd8, + 0x86, 0x01, 0x5f, 0xcf, 0x98, 0x5a, 0x71, 0x2d, 0x2a, 0x19, 0x09, 0x4e, + 0xec, 0x3c, 0xa9, 0x2c, 0x0a, 0xa4, 0xaa, 0xa3, 0xaf, 0x3f, 0xec, 0x78, + 0xda, 0x1c, 0x21, 0xe6, 0xcc, 0x1c, 0x15, 0xac, 0x5d, 0x28, 0xe1, 0x7a, + 0x92, 0xf0, 0xc2, 0x73, 0x92, 0xab, 0x2d, 0x1a, 0x66, 0x45, 0xa3, 0xa8, + 0x19, 0x99, 0xd2, 0x44, 0x76, 0x11, 0x77, 0x49, 0x64, 0xf7, 0x89, 0x84, + 0xbc, 0x52, 0xe0, 0x08, 0x92, 0xaf, 0x0c, 0xfb, 0x02, 0x4d, 0x88, 0x59, + 0xb5, 0xf2, 0x36, 0x3f, 0x98, 0xb8, 0xe9, 0x4d, 0x35, 0x7a, 0x5c, 0x10, + 0xda, 0x51, 0x59, 0xd7, 0x98, 0x0f, 0x57, 0x44, 0xc2, 0xea, 0x85, 0x06, + 0x3f, 0x49, 0x3c, 0x97, 0x89, 0x7c, 0xc4, 0x6a, 0x4a, 0x94, 0x00, 0xde, + 0x0a, 0x2b, 0x4a, 0xab, 0xf4, 0x92, 0x81, 0xe8, 0x9b, 0x16, 0x11, 0x0f, + 0xc9, 0x65, 0x6b, 0x46, 0x59, 0xa1, 0xbf, 0xde, 0x91, 0x15, 0x66, 0x54, + 0x25, 0x22, 0x41, 0x7e, 0xca, 0x7c, 0x4c, 0x3e, 0x88, 0x9a, 0x42, 0xb8, + 0x96, 0x00, 0xdb, 0xf0, 0x62, 0x62, 0x41, 0x25, 0xae, 0xd4, 0x04, 0x7d, + 0x63, 0xb0, 0x2f, 0x52, 0x70, 0x0f, 0x35, 0xff, 0x00, 0xd2, 0xcb, 0x23, + 0x36, 0x56, 0xad, 0xd5, 0x42, 0x9a, 0x39, 0x53, 0x5a, 0xc2, 0x44, 0x83, + 0x90, 0xca, 0xb6, 0x6a, 0x27, 0x58, 0x9e, 0xf1, 0x26, 0x20, 0x60, 0x60, + 0xb5, 0x9b, 0x8a, 0x64, 0x96, 0x8c, 0x15, 0xd5, 0x02, 0x08, 0x29, 0x10, + 0xaf, 0x10, 0xae, 0xed, 0xf8, 0x55, 0xd7, 0xe5, 0xe1, 0xf6, 0x3a, 0x13, + 0x46, 0x69, 0xeb, 0x80, 0xda, 0x57, 0xbe, 0x50, 0x33, 0x10, 0x58, 0x8d, + 0x97, 0x34, 0xc9, 0xfe, 0x9f, 0x65, 0xbf, 0x7f, 0xf1, 0x6c, 0x46, 0xf6, + 0x66, 0x6d, 0xc3, 0x50, 0x7c, 0xaa, 0x20, 0xfe, 0xfb, 0x4a, 0x46, 0x72, + 0xc5, 0xce, 0xa5, 0x16, 0x3f, 0x30, 0xb3, 0x95, 0x08, 0x50, 0xc3, 0x3d, + 0x17, 0x06, 0xf5, 0xb2, 0x24, 0x39, 0x2b, 0xe4, 0x58, 0xa5, 0x3d, 0xeb, + 0x33, 0x49, 0x03, 0xf2, 0x2a, 0x68, 0x6c, 0x9f, 0x20, 0x0d, 0x4b, 0x3f, + 0xf1, 0xf5, 0xc8, 0x48, 0x8d, 0x6c, 0x54, 0x52, 0xf3, 0xcf, 0x38, 0x9d, + 0x50, 0x26, 0x03, 0x2c, 0x70, 0xe7, 0x40, 0x7b, 0x75, 0x24, 0x0c, 0xf4, + 0xcc, 0x7b, 0x07, 0xf6, 0x07, 0xd3, 0x65, 0x8d, 0x4e, 0x31, 0x17, 0x20, + 0x8a, 0xca, 0x20, 0xf3, 0x56, 0x2e, 0xd2, 0x95, 0x74, 0xc1, 0x58, 0xc6, + 0x0b, 0x0f, 0x8b, 0xd1, 0x35, 0x9f, 0x87, 0x6e, 0xed, 0xf6, 0xef, 0x9f, + 0x71, 0x97, 0xec, 0x40, 0x8b, 0xb4, 0x95, 0x22, 0xbc, 0xbc, 0x8c, 0xbb, + 0x97, 0x04, 0x7e, 0x15, 0xed, 0xc1, 0x66, 0xf8, 0xaf, 0x18, 0xeb, 0xa2, + 0xc1, 0x44, 0x1c, 0x1e, 0x4a, 0xa8, 0x53, 0x79, 0xc6, 0x32, 0xf9, 0xb4, + 0x46, 0xc7, 0xa6, 0xe2, 0x29, 0x92, 0xd3, 0x11, 0xa0, 0xa8, 0xf4, 0x4c, + 0xe8, 0xb6, 0xe6, 0x64, 0x8c, 0x70, 0x21, 0xbe, 0x13, 0x0e, 0x6a, 0x4d, + 0xa2, 0x7f, 0x30, 0xa9, 0x7d, 0xc3, 0x17, 0xaa, 0xaf, 0x6c, 0xed, 0x04, + 0xcd, 0xa3, 0xe8, 0x92, 0x31, 0x4f, 0xfe, 0x33, 0x09, 0x0a, 0x01, 0xd9, + 0x1c, 0x49, 0x4e, 0x07, 0x3a, 0x0d, 0x3a, 0x31, 0x2d, 0xf7, 0x54, 0xb0, + 0x40, 0xd4, 0x38, 0xb1, 0x97, 0x28, 0xaa, 0xce, 0x5f, 0x14, 0xc2, 0xa7, + 0x89, 0x16, 0x83, 0x5b, 0x63, 0x89, 0x13, 0x75, 0xa7, 0x60, 0x10, 0xfa, + 0xf8, 0x1f, 0x38, 0x2d, 0x85, 0x57, 0x69, 0x5f, 0xd5, 0xc9, 0x77, 0xae, + 0x43, 0xcd, 0x31, 0x2b, 0x2e, 0xf1, 0x4a, 0x90, 0xfb, 0xca, 0x34, 0xbd, + 0x85, 0x71, 0xe5, 0xbf, 0xf0, 0x61, 0x71, 0xd0, 0xe3, 0x57, 0x2a, 0x94, + 0x96, 0xf6, 0xa7, 0x1b, 0xa0, 0x88, 0x66, 0xc1, 0xe9, 0x93, 0x6c, 0x9d, + 0x35, 0x12, 0x48, 0x7b, 0x84, 0x4a, 0x05, 0x6c, 0xd5, 0x45, 0x51, 0xab, + 0xc8, 0x64, 0x59, 0x7c, 0xc4, 0xc6, 0x28, 0x46, 0x17, 0x30, 0x4e, 0x9b, + 0x99, 0x5f, 0x71, 0x7b, 0x06, 0x95, 0x01, 0x1b, 0x2d, 0xde, 0x41, 0xf9, + 0x4c, 0xa1, 0xc7, 0x59, 0x59, 0x55, 0x4e, 0x70, 0x4a, 0x21, 0xba, 0x19, + 0xee, 0x7e, 0x30, 0x1d, 0xac, 0xd0, 0x46, 0x84, 0x67, 0x91, 0x51, 0x0d, + 0x2a, 0x74, 0xaa, 0x2b, 0x7e, 0xfc, 0xa5, 0xd0, 0xb8, 0xb8, 0xda, 0xc6, + 0x03, 0x53, 0xe5, 0xf2, 0x8a, 0x53, 0x98, 0x82, 0xfc, 0xf6, 0x16, 0x78, + 0xf5, 0xd7, 0xb3, 0x3f, 0xba, 0x8f, 0x78, 0x0e, 0x5b, 0xfc, 0xf0, 0x0b, + 0x58, 0x32, 0x85, 0x1e, 0xc9, 0xee, 0xe0, 0xf8, 0xea, 0xbb, 0x8e, 0x13, + 0xd8, 0xb1, 0x92, 0x98, 0x3d, 0xca, 0x74, 0xe1, 0x5b, 0x68, 0x53, 0x70, + 0x73, 0x46, 0x08, 0x51, 0x54, 0x0b, 0xf1, 0x6c, 0xf1, 0xa3, 0x8a, 0x32, + 0x26, 0x13, 0x37, 0x87, 0x52, 0x56, 0xb6, 0x1c, 0xbf, 0xb4, 0x4d, 0x58, + 0xb0, 0xf8, 0x16, 0x2e, 0x3c, 0xd1, 0xc2, 0x9c, 0x68, 0x37, 0xf1, 0x22, + 0x90, 0xb7, 0xdb, 0x24, 0x36, 0x21, 0xfa, 0x94, 0xc1, 0x0d, 0x39, 0x98, + 0x6b, 0xa1, 0xa4, 0x0d, 0xfa, 0xf6, 0x1a, 0x14, 0x04, 0x3c, 0xe1, 0x3a, + 0x86, 0xd1, 0xea, 0x16, 0xd5, 0x7f, 0x92, 0x2a, 0xa4, 0x76, 0x49, 0x42, + 0x29, 0xc1, 0x76, 0x8e, 0xe4, 0xed, 0xb1, 0x42, 0x8d, 0xab, 0x8d, 0x8e, + 0x70, 0xed, 0x3d, 0x61, 0xe6, 0x1b, 0xef, 0x90, 0x45, 0x43, 0xf7, 0x0e, + 0xa8, 0xde, 0xee, 0x68, 0x51, 0x84, 0xc6, 0xbc, 0xc0, 0x6e, 0xaf, 0x38, + 0x97, 0xc5, 0xce, 0xfb, 0x01, 0x8a, 0xc9, 0x38, 0x3b, 0xf9, 0xfb, 0x04, + 0x14, 0x18, 0x45, 0x24, 0xd9, 0xd0, 0xc4, 0x25, 0x06, 0x1e, 0x96, 0xa9, + 0xc2, 0x7d, 0x21, 0xa7, 0x14, 0xcd, 0xe5, 0xa4, 0x3a, 0xa0, 0x58, 0xc5, + 0x65, 0xb6, 0xcc, 0x8a, 0x8b, 0x47, 0x1a, 0x42, 0x58, 0xff, 0x8a, 0x50, + 0x12, 0xa4, 0xa3, 0x49, 0x65, 0x52, 0x21, 0xfe, 0x0d, 0xb9, 0x00, 0x3f, + 0x55, 0x12, 0xc1, 0x92, 0x61, 0x41, 0x4e, 0xb9, 0x7c, 0xdb, 0x23, 0xa5, + 0xcb, 0x0e, 0x3d, 0x9d, 0x4a, 0xca, 0xb2, 0xe4, 0x45, 0x69, 0x1d, 0x44, + 0xd7, 0x2e, 0x17, 0x59, 0xb4, 0xf9, 0x6f, 0xf3, 0x5b, 0x45, 0xa7, 0x6a, + 0x4a, 0xce, 0xab, 0x9a, 0xc3, 0x96, 0x73, 0xfb, 0x63, 0x36, 0xcd, 0xe5, + 0x10, 0xf1, 0x3c, 0x9d, 0x49, 0x5e, 0x96, 0xf2, 0x82, 0xff, 0x6e, 0xd2, + 0xba, 0x14, 0x8e, 0xf8, 0x9d, 0x5f, 0x1b, 0x85, 0xc6, 0xbb, 0x8a, 0xb4, + 0xa5, 0xe2, 0x57, 0xfb, 0x49, 0x20, 0x8a, 0x35, 0x3b, 0x8e, 0xa0, 0x45, + 0xc6, 0x9f, 0xc8, 0x91, 0x82, 0xed, 0xf5, 0x86, 0xde, 0x99, 0x1d, 0xac, + 0x14, 0xfe, 0xac, 0xa1, 0x39, 0x2a, 0x51, 0x77, 0x8f, 0xd0, 0x4a, 0xbb, + 0xae, 0x85, 0x41, 0xbf, 0x65, 0x7d, 0x8e, 0x80, 0x4b, 0x0e, 0x28, 0x07, + 0x8f, 0x12, 0x0d, 0xcf, 0x05, 0x94, 0x4e, 0xb6, 0xb8, 0x0f, 0x58, 0x49, + 0xe2, 0x09, 0xa1, 0x5f, 0xce, 0x9b, 0xb7, 0x6c, 0x7f, 0x65, 0xb3, 0x9c, + 0xa5, 0x2a, 0x5d, 0x20, 0xf9, 0x3b, 0x65, 0x15, 0xc4, 0xa8, 0xf8, 0x1b, + 0xf6, 0x17, 0x68, 0x84, 0xbc, 0xc3, 0x0d, 0xda, 0x27, 0x10, 0x91, 0x05, + 0x2c, 0xc8, 0x75, 0xef, 0xdb, 0x62, 0xa6, 0x29, 0xde, 0x2a, 0x4d, 0x79, + 0xc0, 0xf8, 0xc2, 0x4f, 0x9c, 0x6d, 0xa9, 0x56, 0xb3, 0xdd, 0x89, 0x2f, + 0x30, 0xbe, 0x69, 0x4e, 0x5e, 0x04, 0xaa, 0x70, 0x5e, 0xda, 0x7a, 0x6e, + 0xae, 0xbe, 0x79, 0x63, 0x3f, 0x33, 0xa2, 0xfa, 0xdb, 0x1c, 0x82, 0xac, + 0x9d, 0x73, 0x58, 0x19, 0x6a, 0xcd, 0x46, 0xa8, 0x99, 0x13, 0x2b, 0xf6, + 0xc6, 0x42, 0x75, 0x35, 0xc6, 0x8c, 0x3d, 0x28, 0xe4, 0xff, 0xef, 0x4c, + 0x57, 0x9a, 0x4f, 0x9b, 0xf7, 0x35, 0x2a, 0x42, 0xfe, 0x2b, 0xe6, 0x7d, + 0xc2, 0x0b, 0x99, 0xf2, 0xd6, 0x93, 0xa7, 0xa3, 0xd4, 0xf5, 0xc2, 0x75, + 0x17, 0x66, 0xd8, 0xc6, 0x63, 0xf8, 0x71, 0x44, 0xce, 0x7c, 0x82, 0xeb, + 0xcf, 0xec, 0x70, 0x40, 0xcf, 0xe6, 0xae, 0x83, 0x54, 0x7f, 0x9c, 0x22, + 0x18, 0x6c, 0x66, 0x04, 0xef, 0x5e, 0x2f, 0x64, 0x83, 0x69, 0x5f, 0xdd, + 0xe8, 0x56, 0x86, 0x96, 0xeb, 0x1a, 0x21, 0x4e, 0xe9, 0x77, 0x79, 0xfc, + 0x59, 0xc2, 0x53, 0xff, 0x27, 0x36, 0x79, 0x9e, 0x7b, 0x64, 0x90, 0xdd, + 0x9e, 0x38, 0x1a, 0x8f, 0xd4, 0xfb, 0x1d, 0x06, 0x6d, 0x5f, 0xc4, 0x52, + 0x45, 0x97, 0x24, 0xaa, 0x8a, 0x07, 0xe7, 0x7f, 0xf4, 0xeb, 0x95, 0x9f, + 0x12, 0xc2, 0x4d, 0x8f, 0x1f, 0xdd, 0x35, 0x4a, 0xaf, 0xcd, 0x30, 0xf4, + 0x15, 0xab, 0x3c, 0x6f, 0xbd, 0x6f, 0x71, 0xb3, 0xc4, 0x9d, 0x42, 0xf2, + 0xcb, 0xf9, 0xe6, 0x46, 0x10, 0x3d, 0x34, 0x16, 0xa7, 0x16, 0xb2, 0x8b, + 0xe5, 0x4b, 0xc8, 0xa5, 0x7b, 0x85, 0x0b, 0x5d, 0x84, 0xcd, 0xcf, 0x47, + 0x22, 0x47, 0xa1, 0xbf, 0x63, 0xdc, 0xb3, 0x06, 0xac, 0x48, 0xb8, 0xaa, + 0x07, 0xef, 0x99, 0x37, 0x84, 0x78, 0xfa, 0x81, 0xb8, 0x5a, 0x87, 0x78, + 0x02, 0xb9, 0xbf, 0xd4, 0xc4, 0xce, 0xa4, 0xa0, 0x3f, 0x65, 0x85, 0x9a, + 0xc2, 0xa0, 0x0d, 0xc8, 0x44, 0xac, 0x08, 0x22, 0xe7, 0xc5, 0x90, 0x43, + 0x41, 0x7b, 0x37, 0xf5, 0xb4, 0x14, 0x89, 0x33, 0x5e, 0x96, 0xd8, 0x4e, + 0x08, 0x16, 0x82, 0xf1, 0xd0, 0x06, 0x38, 0x2a, 0x19, 0x93, 0x67, 0x5a, + 0xe4, 0x49, 0xd7, 0x0c, 0x3e, 0x53, 0x76, 0xf7, 0x0c, 0x33, 0x8a, 0xa7, + 0x4d, 0x75, 0x3d, 0x78, 0x1b, 0x49, 0xcd, 0x6d, 0x97, 0x56, 0x2a, 0x9f, + 0x0e, 0xc6, 0xa1, 0x92, 0x75, 0xcb, 0x1f, 0x53, 0x00, 0xb6, 0xed, 0x4e, + 0xa6, 0xad, 0x2d, 0x09, 0x70, 0x84, 0x26, 0x81, 0x45, 0xf4, 0xd1, 0xd7, + 0xd6, 0x4c, 0x95, 0xa6, 0xac, 0xb2, 0xd0, 0x67, 0x21, 0x73, 0x41, 0x82, + 0xf0, 0x83, 0x3c, 0x28, 0xc0, 0xca, 0xa0, 0x88, 0xb3, 0x71, 0x2e, 0xc9, + 0x90, 0xc5, 0xe1, 0x2e, 0xd1, 0xbd, 0x7d, 0xba, 0x2d, 0xeb, 0xd2, 0x6b, + 0x99, 0x89, 0xa8, 0xfb, 0x77, 0xe4, 0xfd, 0xb0, 0x75, 0xeb, 0x67, 0x12, + 0xd3, 0x71, 0x9a, 0xa1, 0x77, 0x01, 0x81, 0x0d, 0xd1, 0xfb, 0x8a, 0x23, + 0xe2, 0x60, 0x61, 0x32, 0x2a, 0x39, 0xc9, 0xe9, 0xcd, 0xb9, 0x36, 0xa2, + 0x03, 0x2b, 0xcd, 0xab, 0x89, 0x51, 0x19, 0x5d, 0xd1, 0x4b, 0xb6, 0x60, + 0x0d, 0x29, 0x53, 0x3b, 0x6d, 0xbe, 0xed, 0x0f, 0xf7, 0x56, 0xea, 0x8d, + 0xa1, 0x47, 0xb0, 0xb0, 0xd6, 0xce, 0x6c, 0x95, 0x22, 0x74, 0x07, 0x08, + 0x77, 0x98, 0x7a, 0xd1, 0x36, 0x60, 0x40, 0xce, 0x92, 0x80, 0x77, 0x11, + 0xa6, 0xc0, 0xad, 0x71, 0xc0, 0x2e, 0xb3, 0x03, 0xfe, 0x10, 0x10, 0x4f, + 0x66, 0x58, 0x87, 0x0d, 0xb1, 0x38, 0x94, 0xc7, 0x47, 0x15, 0xff, 0xd4, + 0x15, 0x56, 0x5a, 0xbe, 0x04, 0x2e, 0x10, 0xe4, 0x45, 0xff, 0x97, 0x36, + 0xd0, 0xf3, 0x18, 0x07, 0x3e, 0x4a, 0x40, 0xac, 0x3a, 0xf5, 0x25, 0x48, + 0x4f, 0x17, 0xe7, 0xdb, 0xab, 0x65, 0xf1, 0x69, 0xed, 0x90, 0x5f, 0x5e, + 0x4d, 0x95, 0x53, 0x47, 0xdb, 0xfd, 0x1f, 0x07, 0xd4, 0xc5, 0xad, 0x15, + 0x2e, 0x90, 0x5a, 0xb2, 0xcd, 0xcb, 0x19, 0xa9, 0xb2, 0x32, 0xc8, 0x7d, + 0x38, 0x89, 0x40, 0x79, 0xb6, 0x9f, 0x3b, 0xbc, 0x7a, 0xd5, 0x3b, 0x80, + 0xb0, 0xab, 0xff, 0xf8, 0x3d, 0x08, 0x0a, 0x2b, 0x11, 0xef, 0x4e, 0xe9, + 0x00, 0xf0, 0x00, 0xfc, 0x00, 0x00, 0x00, 0x07, 0x00, 0x05, 0x00, 0x0a, + 0x00, 0x0f, 0x00, 0xe6, 0xad, 0x67, 0x90, 0xb6, 0xee, 0x72, 0xf8, 0x69, + 0x92, 0xbe, 0xb8, 0x60, 0xfc, 0x3b, 0x6b, 0x01, 0x65, 0x1b, 0x3e, 0x44, + 0x28, 0xa0, 0xcf, 0x90, 0xcc, 0xe1, 0x53, 0x6c, 0x94, 0xd4, 0xa4, 0x41, + 0xb0, 0xe9, 0xa4, 0xfa, 0x19, 0x4d, 0x7c, 0x25, 0xfa, 0xb2, 0xdb, 0x80, + 0x2a, 0xf5, 0xb4, 0x4d, 0xa5, 0xb9, 0xf4, 0xb7, 0x2a, 0x1f, 0x56, 0xbb, + 0xa5, 0x38, 0x44, 0xcc, 0xae, 0x09, 0x67, 0x32, 0x40, 0xb9, 0xc5, 0x68, + 0xe5, 0x17, 0x3e, 0xe4, 0xee, 0xd0, 0xd5, 0x5d, 0x30, 0xd0, 0x9e, 0xee, + 0x3a, 0x60, 0xc3, 0x50, 0xbd, 0x7e, 0xda, 0x08, 0x38, 0x21, 0x60, 0x1e, + 0x5a, 0x35, 0x71, 0x46, 0x9f, 0x06, 0x67, 0x82, 0xc6, 0x46, 0x22, 0x08, + 0x31, 0x10, 0x84, 0xd2, 0xd6, 0x91, 0x39, 0x82, 0x47, 0x69, 0x9c, 0x9f, + 0x97, 0xa8, 0x53, 0x96, 0x07, 0x44, 0x91, 0x15, 0xf1, 0x6a, 0x60, 0x75, + 0x36, 0x5f, 0x8e, 0xae, 0xac, 0x60, 0x88, 0xed, 0x21, 0xbd, 0x54, 0xc8, + 0x55, 0x77, 0xa4, 0x63, 0xbd, 0x55, 0x47, 0xcd, 0x0f, 0x40, 0x62, 0x83, + 0x75, 0xb7, 0x63, 0x25, 0x0d, 0x10, 0xa8, 0x73, 0x82, 0xfb, 0x69, 0x35, + 0xae, 0x01, 0x04, 0x4f, 0xc0, 0x04, 0x56, 0xff, 0x0f, 0xa3, 0xaf, 0xef, + 0x33, 0xb4, 0x5e, 0x17, 0xac, 0x9f, 0xb9, 0xae, 0x56, 0xac, 0xfa, 0x99, + 0x30, 0x13, 0xa8, 0x9f, 0x0f, 0x0e, 0xde, 0x16, 0x60, 0x45, 0xd5, 0x90, + 0x20, 0x7a, 0x35, 0xde, 0x4d, 0xf1, 0xaa, 0xee, 0x40, 0x6f, 0xea, 0x2d, + 0x77, 0xa7, 0xad, 0x36, 0xb2, 0xd1, 0xf7, 0xc5, 0x5e, 0xcb, 0x42, 0xfb, + 0x60, 0xf8, 0x59, 0x48, 0x5a, 0x2e, 0xdd, 0x75, 0xfa, 0x37, 0x3e, 0x97, + 0x03, 0x31, 0x76, 0x29, 0x75, 0x11, 0x75, 0x73, 0xa9, 0x52, 0xf2, 0x67, + 0x4c, 0x49, 0x89, 0xc0, 0x67, 0xa7, 0x8a, 0x52, 0x9b, 0x30, 0xb1, 0x53, + 0xd5, 0xc7, 0x5f, 0x0d, 0xee, 0x28, 0x6c, 0x47, 0xba, 0x82, 0x0d, 0x9a, + 0x5f, 0xbe, 0x66, 0x85, 0x07, 0x30, 0xa4, 0xa9, 0x25, 0x5b, 0xa6, 0x13, + 0x50, 0x4b, 0xa0, 0x28, 0x9f, 0x49, 0x37, 0xf4, 0xac, 0x8d, 0xe0, 0x45, + 0x8a, 0x01, 0x86, 0x34, 0x8a, 0x82, 0xd9, 0x52, 0x9f, 0x85, 0x76, 0xdd, + 0x01, 0x1e, 0x4d, 0xa2, 0x4e, 0xdc, 0x31, 0x74, 0xf6, 0x03, 0x5f, 0x67, + 0x2d, 0x66, 0xcc, 0xfe, 0x53, 0x2d, 0x2b, 0x31, 0xa7, 0x0c, 0x10, 0xdb, + 0xa4, 0xb5, 0x40, 0x72, 0xa9, 0x55, 0x04, 0x59, 0xdb, 0xf9, 0x9f, 0xf2, + 0x44, 0x4e, 0xbc, 0xa9, 0x5c, 0x49, 0x36, 0xf7, 0xb3, 0x64, 0x58, 0xd7, + 0x42, 0x88, 0x9f, 0x98, 0x8d, 0xd4, 0x87, 0x65, 0x4d, 0x89, 0xde, 0xb6, + 0x1f, 0x3c, 0xc2, 0x89, 0x05, 0xf5, 0x84, 0xb0, 0x2e, 0x63, 0xe5, 0x55, + 0xf5, 0xd6, 0x14, 0x21, 0x31, 0x93, 0x79, 0x97, 0xd0, 0xf3, 0x5a, 0x72, + 0x09, 0x93, 0xf6, 0x54, 0x54, 0x39, 0x7b, 0x43, 0x7d, 0xce, 0x0e, 0x68, + 0x5c, 0xe1, 0x2b, 0x0e, 0x28, 0x2d, 0xd6, 0x02, 0xaa, 0x5e, 0x72, 0x65, + 0xce, 0xd5, 0x22, 0x3d, 0xc6, 0xc4, 0xf2, 0xf4, 0x27, 0x1b, 0xc8, 0xce, + 0xb2, 0xc1, 0x6f, 0x65, 0xb9, 0xe1, 0x95, 0x02, 0xf9, 0xc1, 0x54, 0x21, + 0xe1, 0x43, 0x52, 0x89, 0xbd, 0x19, 0x76, 0x5b, 0xf2, 0x53, 0x09, 0x9e, + 0x7f, 0x1b, 0x34, 0x08, 0x64, 0x08, 0x5b, 0x0a, 0x78, 0x30, 0x7c, 0x5c, + 0x15, 0xc0, 0x92, 0xb4, 0x3a, 0x07, 0xb7, 0x3a, 0xea, 0x64, 0xfb, 0x03, + 0x59, 0x79, 0x16, 0xbd, 0x04, 0x83, 0x3b, 0xbe, 0xb1, 0xca, 0x51, 0x15, + 0xa8, 0xde, 0x6e, 0xe7, 0xdb, 0x56, 0x30, 0x5d, 0x54, 0x08, 0xf6, 0x84, + 0x31, 0x38, 0x75, 0x99, 0x08, 0x9d, 0x8a, 0x35, 0x87, 0xa0, 0x91, 0xe1, + 0xb2, 0x96, 0x88, 0xda, 0x68, 0xd2, 0x36, 0x6a, 0xb6, 0xdd, 0x99, 0xb5, + 0x23, 0xcd, 0x3d, 0xaa, 0xc8, 0x3e, 0x5f, 0x88, 0x5e, 0x52, 0x57, 0x1e, + 0x22, 0x4d, 0x3e, 0x28, 0xb9, 0x1a, 0xc2, 0x9f, 0x13, 0x3f, 0x46, 0x07, + 0x72, 0xf5, 0xda, 0x25, 0x0a, 0x1f, 0xbc, 0x1b, 0x51, 0xa0, 0xff, 0x7b, + 0x99, 0xf5, 0x69, 0x73, 0xcd, 0x34, 0x7c, 0xe6, 0x46, 0x01, 0x91, 0x71, + 0xc1, 0x06, 0xd5, 0xfc, 0xa4, 0xfc, 0x82, 0x63, 0x7e, 0x12, 0xcf, 0x47, + 0x1f, 0xea, 0xbc, 0x05, 0x57, 0xd5, 0x6b, 0xa4, 0x70, 0x94, 0xb7, 0x27, + 0x2f, 0xf6, 0xfb, 0xa5, 0x0b, 0x89, 0x60, 0xce, 0xc4, 0xb9, 0x76, 0x52, + 0x61, 0xd6, 0x17, 0x53, 0x9c, 0x53, 0xc0, 0x63, 0xc8, 0x34, 0x0c, 0x6f, + 0xd0, 0x5a, 0x11, 0x1d, 0x25, 0xd2, 0xa7, 0x90, 0xd9, 0x4c, 0xee, 0xce, + 0xbf, 0x84, 0x77, 0xc1, 0x32, 0x66, 0x0c, 0x28, 0xfc, 0x94, 0x87, 0xec, + 0x7a, 0xbd, 0xad, 0xa4, 0x6d, 0xe2, 0x95, 0x69, 0x45, 0x18, 0x1e, 0x44, + 0x0e, 0x95, 0x8b, 0xb6, 0xcd, 0xc4, 0x47, 0xa4, 0xfd, 0xde, 0xc6, 0x04, + 0x31, 0xc6, 0x60, 0x33, 0x3b, 0xa6, 0xb3, 0x6b, 0x03, 0x32, 0x01, 0x0d, + 0x74, 0x65, 0xd0, 0x5d, 0x33, 0x02, 0x1b, 0x43, 0xd9, 0xec, 0xdd, 0x59, + 0xdc, 0x2a, 0x56, 0x3f, 0x78, 0xaf, 0xe5, 0xa2, 0x6c, 0x83, 0x82, 0x8a, + 0x5a, 0x7c, 0xbf, 0x33, 0xc7, 0x9e, 0x7f, 0x41, 0x75, 0x1e, 0xd1, 0x5d, + 0x03, 0xa8, 0xc9, 0xe4, 0x50, 0x45, 0xfd, 0x34, 0x12, 0x2d, 0xeb, 0x19, + 0xff, 0x01, 0x59, 0xdc, 0x4d, 0x05, 0x8d, 0xf8, 0xa8, 0x9f, 0xea, 0xb0, + 0x88, 0xa8, 0x44, 0x0d, 0x3c, 0xb9, 0x43, 0xab, 0x77, 0x0d, 0xf4, 0x6b, + 0xd4, 0x5c, 0xcf, 0xc1, 0x77, 0x2b, 0xa5, 0x7e, 0x61, 0x08, 0xa8, 0x5a, + 0x68, 0x7f, 0x8a, 0x77, 0x9b, 0x3a, 0x1c, 0x37, 0xdd, 0x13, 0xc3, 0x65, + 0x57, 0x87, 0x6a, 0xf5, 0x4b, 0x15, 0xdd, 0x9c, 0x42, 0xdd, 0xec, 0xc0, + 0xc5, 0xfa, 0x04, 0x9d, 0x02, 0xff, 0x40, 0xd3, 0xd0, 0x10, 0x90, 0xf6, + 0x88, 0x5c, 0x1e, 0x77, 0xc1, 0x9b, 0x54, 0xe8, 0x8e, 0xb3, 0x1c, 0x91, + 0x2c, 0xd2, 0xfb, 0xd7, 0xb7, 0xf5, 0x1d, 0xc7, 0x1e, 0x78, 0xb0, 0x91, + 0xb8, 0xb3, 0x46, 0xe5, 0xfb, 0x37, 0xe2, 0x30, 0xc3, 0xc5, 0xdd, 0xd5, + 0xd8, 0x46, 0xee, 0x37, 0x15, 0xe1, 0xa5, 0x21, 0x76, 0xa2, 0x50, 0xbe, + 0xa2, 0x6a, 0x7e, 0xf1, 0xbf, 0x6a, 0xde, 0xd5, 0x49, 0xac, 0xae, 0x9d, + 0x78, 0x5f, 0x9f, 0xb3, 0xe8, 0x44, 0x64, 0xf7, 0xf8, 0xc2, 0xd8, 0x99, + 0x66, 0x9e, 0x57, 0x7f, 0x8b, 0xa2, 0xcd, 0x43, 0xe0, 0x9c, 0xf6, 0xce, + 0xdc, 0x83, 0x6f, 0x4c, 0x24, 0xd5, 0x0f, 0x8d, 0x5b, 0x4a, 0x74, 0x28, + 0xa1, 0xa7, 0x14, 0x9e, 0x61, 0x95, 0x09, 0xfd, 0x8a, 0x6e, 0x2c, 0x19, + 0x12, 0x44, 0xa8, 0x29, 0xc1, 0x35, 0x38, 0xea, 0x43, 0xe2, 0x7b, 0x4a, + 0x42, 0xf9, 0x1a, 0x97, 0xcd, 0xd8, 0xf0, 0x97, 0x39, 0x1e, 0x47, 0x2b, + 0xbe, 0x5d, 0x98, 0x6a, 0x5a, 0x6c, 0x2d, 0xc0, 0x97, 0x79, 0x8e, 0xab, + 0x6b, 0xc4, 0xa5, 0x45, 0xf5, 0x3c, 0x45, 0x87, 0xc8, 0x01, 0x47, 0xd4, + 0x63, 0xd7, 0x8b, 0x11, 0xec, 0x31, 0xf4, 0x3f, 0x11, 0x07, 0x5e, 0x9a, + 0xd1, 0x14, 0x54, 0x1f, 0xc0, 0xa5, 0x70, 0xa3, 0x70, 0x4b, 0xa8, 0x67, + 0xb0, 0x62, 0xd0, 0x2a, 0xdc, 0x2d, 0x62, 0xa3, 0x2d, 0x6f, 0x91, 0xc1, + 0x4e, 0x97, 0x96, 0xb2, 0x4b, 0x2d, 0xca, 0x5d, 0x61, 0xf1, 0xa0, 0x48, + 0x80, 0x96, 0x95, 0xc1, 0xe4, 0x6d, 0x47, 0x10, 0x01, 0xee, 0x85, 0x1d, + 0x84, 0x25, 0xeb, 0x18, 0x21, 0xc1, 0x7d, 0xa3, 0x25, 0xaf, 0xe5, 0x89, + 0x06, 0x1f, 0x91, 0xe0, 0x58, 0xb3, 0x94, 0x2d, 0xb6, 0x24, 0x3e, 0xb6, + 0x03, 0x3a, 0x29, 0x8b, 0x9a, 0xc2, 0xef, 0x91, 0x20, 0x3f, 0xb9, 0x2b, + 0x65, 0xa8, 0xd5, 0x60, 0x74, 0x5d, 0x85, 0xf5, 0x6c, 0x3d, 0x2b, 0x8d, + 0x8d, 0x7d, 0x62, 0x40, 0xfc, 0xff, 0x24, 0x4c, 0xc6, 0xef, 0xef, 0xe9, + 0xea, 0xd9, 0xc0, 0x66, 0x2a, 0x3e, 0xa9, 0x02, 0x92, 0xb3, 0xaa, 0xcb, + 0xbc, 0x6a, 0x63, 0x7a, 0x74, 0xb2, 0xeb, 0xad, 0x57, 0x70, 0x1e, 0x25, + 0xc1, 0x71, 0xd7, 0xb2, 0x4a, 0x9b, 0x9a, 0xb4, 0x60, 0x10, 0x02, 0x9f, + 0x02, 0x34, 0xf0, 0xbd, 0x20, 0x91, 0x97, 0xb3, 0x12, 0x3a, 0xce, 0x98, + 0xba, 0x4d, 0x34, 0x69, 0xca, 0xa6, 0xe2, 0x31, 0xf7, 0x98, 0x10, 0x23, + 0x73, 0xa8, 0xe6, 0xd3, 0xa5, 0x3c, 0xe9, 0x9c, 0x47, 0x3d, 0x95, 0x39, + 0xc5, 0x76, 0xd1, 0xba, 0x99, 0x76, 0x8d, 0xc7, 0x81, 0xeb, 0x46, 0x7c, + 0x83, 0x99, 0x43, 0x3c, 0xcb, 0x9a, 0x02, 0x45, 0x04, 0x75, 0x86, 0xa7, + 0x37, 0x20, 0xb8, 0xf1, 0x23, 0x21, 0x3f, 0x02, 0x7c, 0x32, 0x40, 0xd3, + 0x43, 0xdc, 0x4e, 0xc9, 0x9d, 0x30, 0x48, 0x87, 0x3f, 0xf1, 0x99, 0x0f, + 0xa3, 0xe0, 0x5d, 0x50, 0x84, 0x86, 0xcb, 0x3a, 0x2e, 0x75, 0x57, 0x29, + 0xf2, 0x79, 0x3a, 0x0f, 0xe4, 0x4f, 0x01, 0x31, 0x46, 0xb6, 0xb2, 0x32, + 0x49, 0x09, 0x26, 0x23, 0x23, 0xd1, 0x85, 0xe4, 0xf4, 0x2e, 0xfa, 0xe3, + 0x72, 0xae, 0xd5, 0x63, 0x80, 0x27, 0x65, 0x8f, 0x1b, 0x4e, 0xbb, 0x63, + 0x79, 0x51, 0x62, 0x33, 0xde, 0x15, 0x13, 0x29, 0x71, 0xb0, 0x8d, 0xe5, + 0xef, 0x44, 0xa5, 0x7d, 0xa4, 0xfb, 0xe4, 0xce, 0xce, 0xb6, 0x82, 0xf3, + 0x13, 0x1d, 0x3a, 0x15, 0x73, 0xe7, 0x2a, 0x78, 0x94, 0xd7, 0x2d, 0x79, + 0xce, 0xf2, 0xab, 0x76, 0x39, 0x2c, 0xea, 0xe5, 0x48, 0xf6, 0xc5, 0x5b, + 0xae, 0x5e, 0x0c, 0xd0, 0x65, 0x41, 0xeb, 0x9a, 0xc1, 0x2f, 0x37, 0xea, + 0x4c, 0x0a, 0x99, 0xb6, 0xd3, 0x59, 0x98, 0xb4, 0x9e, 0xb4, 0x21, 0xf0, + 0xba, 0x33, 0x69, 0x93, 0x3a, 0xaf, 0xf7, 0xc6, 0xd6, 0xb2, 0x83, 0xd8, + 0x6e, 0x57, 0x84, 0x85, 0x7d, 0x2a, 0x0a, 0x09, 0x3d, 0xc4, 0x22, 0x10, + 0x6b, 0x5b, 0xc3, 0x80, 0x44, 0x61, 0x54, 0xa0, 0x11, 0x02, 0x77, 0xcd, + 0xbe, 0x80, 0xa1, 0x20, 0x6f, 0x38, 0x01, 0xc1, 0x16, 0xfb, 0x84, 0x63, + 0xbe, 0xf9, 0x54, 0x3c, 0x49, 0xa6, 0x43, 0x45, 0x10, 0x4e, 0x1d, 0x52, + 0x2b, 0xf4, 0xba, 0x2e, 0x38, 0x43, 0x35, 0xef, 0x0a, 0x6b, 0x2f, 0x8d, + 0x37, 0xc6, 0x18, 0x88, 0xa2, 0x30, 0xe8, 0x39, 0x4b, 0x4e, 0x44, 0xa0, + 0xb2, 0xb8, 0x9d, 0x02, 0xc0, 0x1e, 0x5c, 0x5c, 0x87, 0xdb, 0x15, 0xbf, + 0x33, 0x68, 0x2d, 0x47, 0x2d, 0xdf, 0x68, 0x73, 0xd9, 0xc7, 0xf3, 0x85, + 0x29, 0xb6, 0xbf, 0x36, 0x67, 0x09, 0x37, 0x71, 0x7e, 0x3a, 0xee, 0xe4, + 0x0c, 0x85, 0x97, 0x44, 0x72, 0x2e, 0xf1, 0xf6, 0x8b, 0xfb, 0x8e, 0x2d, + 0xd4, 0xbe, 0x22, 0x51, 0x2f, 0xd3, 0x4e, 0x12, 0x2a, 0xcb, 0x67, 0x16, + 0xce, 0xbe, 0x01, 0xe7, 0x34, 0x77, 0xe6, 0x7e, 0x05, 0xec, 0x32, 0xa5, + 0xe8, 0x06, 0x4e, 0xe4, 0x65, 0x1e, 0x85, 0x44, 0x12, 0xf5, 0xcd, 0x8f, + 0x20, 0xb0, 0x74, 0x66, 0x50, 0x6e, 0xeb, 0x4e, 0xee, 0xc1, 0x29, 0xa7, + 0xe2, 0xc8, 0x85, 0x97, 0x92, 0xc6, 0xf6, 0x29, 0x56, 0xf7, 0x5f, 0x34, + 0x6b, 0x05, 0x84, 0x29, 0x46, 0xfa, 0xac, 0x09, 0x76, 0xd2, 0x92, 0x5e, + 0xf1, 0xe2, 0x7b, 0xc5, 0x1d, 0x52, 0x63, 0xf7, 0x36, 0xe6, 0xd6, 0xdf, + 0xb6, 0x24, 0xc0, 0x6a, 0x30, 0x37, 0x5c, 0x02, 0x52, 0x4d, 0x3e, 0xa3, + 0x4e, 0x81, 0x06, 0x52, 0x09, 0x20, 0x04, 0xce, 0x02, 0xf2, 0xf1, 0x58, + 0x9c, 0x31, 0x5e, 0x8a, 0x60, 0x0e, 0x14, 0xe4, 0x32, 0x6d, 0xf9, 0x94, + 0x15, 0x83, 0x48, 0x4e, 0x13, 0x37, 0x9b, 0x4b, 0x45, 0xf7, 0x0a, 0xf5, + 0xb3, 0xf1, 0x5a, 0xa2, 0x7f, 0x86, 0xba, 0x6e, 0x30, 0x4c, 0x40, 0xaa, + 0xa2, 0x0c, 0x94, 0x57, 0x74, 0xa4, 0x69, 0x3f, 0xfc, 0xde, 0x84, 0x48, + 0xa7, 0xfc, 0x51, 0x7f, 0x60, 0x88, 0x0f, 0x69, 0xf9, 0x77, 0xf9, 0x67, + 0xa6, 0x6e, 0x7d, 0x2f, 0x9f, 0x2f, 0xd6, 0xf7, 0xe6, 0x57, 0xb5, 0x4c, + 0x11, 0x7e, 0x4c, 0x34, 0xcc, 0xe0, 0x75, 0x28, 0x62, 0xf7, 0xf2, 0x27, + 0x42, 0x18, 0xa0, 0xab, 0xf4, 0xf1, 0x2e, 0x75, 0x5b, 0x4f, 0x14, 0x56, + 0x9b, 0x75, 0x1c, 0x91, 0x1a, 0x95, 0xfe, 0xdf, 0xb4, 0x2e, 0x74, 0x54, + 0x9b, 0x86, 0x5c, 0x72, 0x80, 0x67, 0x96, 0xc9, 0xa3, 0x31, 0xa2, 0xf5, + 0xcd, 0x2e, 0xd9, 0xf3, 0x4f, 0x49, 0x6d, 0x44, 0x6a, 0x46, 0xdb, 0x2e, + 0xcb, 0xde, 0xc9, 0x85, 0xcd, 0x57, 0xf7, 0xa5, 0x03, 0x99, 0x18, 0x47, + 0x89, 0xe5, 0x84, 0x1c, 0xaf, 0x73, 0x9e, 0xa3, 0x4f, 0x37, 0x35, 0xd7, + 0x79, 0xeb, 0xe5, 0x4b, 0xbb, 0xe2, 0xf3, 0x5b, 0xed, 0xd5, 0xbf, 0x40, + 0x02, 0x59, 0x87, 0xb2, 0xee, 0x98, 0x04, 0x24, 0x84, 0x9e, 0x18, 0x6f, + 0xb5, 0x00, 0xa8, 0x00, 0x24, 0x68, 0x7c, 0x50, 0xd4, 0xd1, 0x99, 0xc0, + 0x45, 0x7a, 0x30, 0x12, 0xd6, 0x94, 0xc7, 0x77, 0x42, 0x19, 0xaf, 0x00, + 0x70, 0xcd, 0xc8, 0x01, 0x5b, 0xb3, 0x8d, 0xb0, 0xd3, 0x98, 0x0a, 0x76, + 0xa1, 0xc5, 0x90, 0x08, 0x08, 0x67, 0xaa, 0x4f, 0xca, 0xf0, 0x08, 0xc0, + 0x0f, 0x68, 0xf7, 0xb0, 0x27, 0x90, 0x1d, 0x7e, 0xb2, 0xc0, 0x77, 0xce, + 0xcc, 0x03, 0x54, 0xef, 0x3b, 0xc3, 0xc4, 0xef, 0xa7, 0x48, 0x1b, 0x7e, + 0x89, 0x03, 0x80, 0xc3, 0x62, 0xc4, 0xef, 0x1a, 0x66, 0x16, 0x71, 0xb7, + 0x67, 0xc0, 0x3f, 0x8c, 0xf7, 0xa2, 0x31, 0x76, 0x86, 0x06, 0x16, 0x24, + 0xb8, 0xa5, 0xbe, 0x29, 0xd6, 0x59, 0x0c, 0xab, 0x2f, 0x76, 0xfc, 0x07, + 0x39, 0x86, 0xbe, 0x02, 0x95, 0xc1, 0xf3, 0xc1, 0xf1, 0x61, 0x27, 0x47, + 0x73, 0x9b, 0xdc, 0xcb, 0x64, 0x15, 0x06, 0x09, 0x74, 0x18, 0xed, 0x8a, + 0x63, 0x8f, 0xe7, 0xec, 0x09, 0x63, 0x37, 0xc0, 0x57, 0xc8, 0xea, 0xfe, + 0xff, 0xf8, 0x3d, 0x08, 0x0b, 0x2b, 0x11, 0x84, 0x4e, 0x07, 0x00, 0x00, + 0x00, 0xfa, 0x00, 0xfc, 0x00, 0xf8, 0x00, 0xec, 0x00, 0xe6, 0x00, 0xe6, + 0x00, 0xe6, 0xb2, 0xe5, 0xb1, 0x1c, 0x9e, 0x93, 0x82, 0xc7, 0x3a, 0xa1, + 0x3d, 0xbd, 0x90, 0x82, 0xf9, 0x05, 0x62, 0x17, 0x95, 0x07, 0xdb, 0x06, + 0xc7, 0xb7, 0xf9, 0x4f, 0x64, 0x72, 0x66, 0xeb, 0xc5, 0xcd, 0x6e, 0x0c, + 0x6b, 0x10, 0x54, 0x59, 0x0a, 0x34, 0x30, 0x2b, 0x8c, 0x1e, 0x83, 0x35, + 0xca, 0x85, 0xa3, 0x62, 0xcf, 0x87, 0x3c, 0x01, 0x34, 0x63, 0x49, 0xe0, + 0xac, 0x1e, 0x14, 0xa7, 0xe1, 0xc6, 0xe1, 0x1c, 0xc7, 0x29, 0x33, 0xf7, + 0xf8, 0xe2, 0x79, 0xf7, 0x3f, 0xaa, 0x2a, 0xc1, 0xc8, 0xa4, 0x85, 0x25, + 0xab, 0xf2, 0x69, 0x28, 0xb7, 0xb3, 0x13, 0x54, 0xdd, 0xd0, 0x4f, 0x4d, + 0x0a, 0xf8, 0xd2, 0xb1, 0xca, 0x0a, 0x40, 0x1d, 0xd7, 0x8d, 0x13, 0x0a, + 0x60, 0xf2, 0x20, 0xf5, 0xa0, 0x8a, 0x68, 0x55, 0x8d, 0xc4, 0xe2, 0x99, + 0x87, 0x24, 0xff, 0xb3, 0x55, 0x74, 0x06, 0x40, 0x3a, 0x9b, 0xa5, 0x7f, + 0x3c, 0xd5, 0x17, 0xaf, 0xbe, 0x6f, 0xd9, 0x33, 0x39, 0xea, 0x28, 0xe0, + 0xf3, 0x4b, 0x10, 0xc9, 0x7f, 0x89, 0xcf, 0xf9, 0xbc, 0xc4, 0x79, 0x5e, + 0xd6, 0x6c, 0x4a, 0xa7, 0x6a, 0xfa, 0xda, 0xdb, 0xbd, 0x81, 0x59, 0xd4, + 0xbb, 0x3f, 0x5e, 0xea, 0xc2, 0xd1, 0x2a, 0x76, 0x01, 0x64, 0x0a, 0x1b, + 0x91, 0x0d, 0x16, 0xa8, 0xaf, 0xe1, 0xac, 0x1d, 0x28, 0xd3, 0xe5, 0xe1, + 0x5d, 0xdd, 0xf6, 0xf4, 0x87, 0xfa, 0x91, 0xd0, 0xa8, 0xe3, 0x5b, 0x63, + 0x9b, 0x6c, 0xb2, 0x1d, 0xa8, 0xd6, 0xc2, 0x97, 0x3f, 0xcf, 0xce, 0xcf, + 0x74, 0xa4, 0x05, 0xa7, 0xff, 0x25, 0x9f, 0x83, 0xd6, 0x18, 0x35, 0xed, + 0xb8, 0xa4, 0x8d, 0x36, 0xc4, 0x1a, 0x04, 0xf8, 0x10, 0x7a, 0x4c, 0x72, + 0x8c, 0x30, 0x85, 0x8f, 0xeb, 0x31, 0x10, 0x16, 0x98, 0xec, 0x39, 0xf5, + 0xfc, 0xd5, 0xda, 0xd0, 0x2e, 0xff, 0x93, 0x94, 0x67, 0xa8, 0x97, 0xaf, + 0xb8, 0x45, 0xf1, 0xa7, 0xe8, 0xfb, 0xff, 0x79, 0x59, 0x8e, 0x24, 0x5d, + 0x65, 0xa9, 0x9a, 0xca, 0x58, 0x2a, 0x02, 0x8f, 0x50, 0xdc, 0x95, 0x9c, + 0x41, 0xff, 0x74, 0xf7, 0x64, 0x96, 0xbb, 0x7f, 0x06, 0x2c, 0x14, 0x17, + 0x45, 0x6a, 0x91, 0x42, 0x68, 0x82, 0x78, 0xb1, 0xc7, 0x84, 0xce, 0xa9, + 0xea, 0x10, 0x1d, 0x66, 0xaf, 0xe2, 0xd2, 0x60, 0x99, 0x92, 0xba, 0x1e, + 0x4e, 0xb2, 0x90, 0xc9, 0x02, 0xe4, 0x96, 0x8b, 0x27, 0x26, 0x84, 0x6b, + 0x6d, 0x0a, 0x69, 0xd4, 0xd6, 0x5f, 0x1a, 0xe4, 0xb5, 0xa4, 0x69, 0xfb, + 0x3b, 0xa4, 0x46, 0x91, 0xda, 0x34, 0x80, 0xba, 0x0f, 0x53, 0xd4, 0xdc, + 0xf4, 0x73, 0x00, 0xa1, 0x1e, 0xaa, 0x94, 0xcb, 0x31, 0x1a, 0xaf, 0x04, + 0x34, 0xa7, 0x55, 0xfc, 0x05, 0x25, 0x74, 0xbb, 0x30, 0xba, 0xc4, 0x86, + 0xdb, 0xde, 0x49, 0x7c, 0x3a, 0xdf, 0xd4, 0x28, 0x4b, 0xb4, 0x52, 0x41, + 0x4e, 0x93, 0xc2, 0xaa, 0xf9, 0xed, 0x2a, 0x8e, 0x7f, 0xb5, 0xcd, 0xdf, + 0xcb, 0xa7, 0xc8, 0xb6, 0x56, 0x30, 0xd7, 0x50, 0x92, 0x11, 0x68, 0x56, + 0xf7, 0x3e, 0xbd, 0x48, 0x59, 0xc0, 0x66, 0x80, 0xd3, 0x11, 0x35, 0xcc, + 0x93, 0x23, 0x96, 0x2e, 0xf2, 0x7f, 0x68, 0x63, 0x44, 0xb7, 0x63, 0x15, + 0x0c, 0x61, 0xb9, 0xcc, 0x05, 0x52, 0x5d, 0x6e, 0xee, 0x6d, 0x2d, 0xb4, + 0xf8, 0x9e, 0x07, 0x65, 0x75, 0xc4, 0x5e, 0x12, 0x94, 0xb7, 0x9a, 0x38, + 0x0a, 0x21, 0x44, 0x5c, 0xd5, 0x15, 0xd5, 0x0a, 0xfe, 0x90, 0x4b, 0x49, + 0x8a, 0x66, 0x06, 0xed, 0xd9, 0xae, 0xc2, 0x41, 0x18, 0x73, 0xb6, 0x6b, + 0x34, 0xcf, 0xc4, 0x33, 0x2d, 0x04, 0x4c, 0xeb, 0xd5, 0x0e, 0xa6, 0xcb, + 0x62, 0xd5, 0x1d, 0x53, 0x00, 0x98, 0x88, 0x9e, 0xe2, 0x1f, 0x38, 0xe9, + 0x6e, 0xdd, 0xa7, 0x6c, 0xe0, 0x62, 0xb6, 0x10, 0x9b, 0x68, 0x40, 0xd2, + 0x58, 0x2c, 0x07, 0xcf, 0xd2, 0x1d, 0xc5, 0x8b, 0xe0, 0xad, 0xc9, 0x0f, + 0xf9, 0x92, 0xc2, 0x63, 0x1b, 0x35, 0x0c, 0x57, 0xdc, 0x8c, 0x6c, 0xc4, + 0x3a, 0x49, 0xcd, 0x0a, 0xea, 0x6c, 0xcd, 0xd1, 0xc9, 0xe2, 0x94, 0x29, + 0x23, 0x8e, 0xd3, 0xb9, 0x0b, 0x6b, 0x1f, 0x9c, 0xe8, 0x4f, 0x34, 0xc8, + 0xbc, 0xd5, 0x59, 0x62, 0x77, 0x6b, 0xc1, 0xd7, 0xe0, 0xe2, 0xc8, 0x7a, + 0x19, 0xfc, 0x3c, 0x88, 0x3f, 0x52, 0xf2, 0xc4, 0x42, 0x25, 0x07, 0xfa, + 0x3f, 0xf1, 0x9c, 0x45, 0xf6, 0x24, 0x4b, 0x24, 0xcc, 0x41, 0x6e, 0xc9, + 0x80, 0xdf, 0x60, 0x24, 0x23, 0x51, 0x8b, 0x8e, 0xb3, 0x98, 0x55, 0xfe, + 0x05, 0x55, 0xc0, 0xcf, 0x82, 0x97, 0xc1, 0x2e, 0xa4, 0x98, 0x36, 0x94, + 0x03, 0x02, 0x9e, 0x35, 0xb8, 0x71, 0xf1, 0x47, 0x9b, 0x8f, 0xee, 0xa1, + 0xe6, 0xb1, 0xec, 0xcb, 0xd9, 0x1a, 0xca, 0xa6, 0x4b, 0x16, 0xbf, 0x28, + 0x49, 0xbd, 0x45, 0x9b, 0x99, 0x4a, 0x56, 0xad, 0x08, 0x71, 0x43, 0xd0, + 0x36, 0x1f, 0x1d, 0x3e, 0x70, 0xfa, 0xf2, 0x22, 0x2a, 0xb9, 0x3f, 0xab, + 0x82, 0x33, 0x16, 0x49, 0x8e, 0x5b, 0x6e, 0xaf, 0x0a, 0x6e, 0x85, 0x1b, + 0xfa, 0x63, 0x36, 0x51, 0x64, 0x90, 0xa4, 0xd5, 0x12, 0xee, 0xc3, 0xe6, + 0x92, 0xb9, 0xb9, 0xc4, 0x91, 0xee, 0x16, 0xab, 0xf8, 0x67, 0xcd, 0x75, + 0x07, 0x1b, 0x46, 0x23, 0x95, 0xce, 0xfe, 0x76, 0xf8, 0x83, 0x84, 0x7a, + 0x85, 0x92, 0xea, 0x3b, 0x0b, 0x52, 0xdf, 0x03, 0x19, 0xad, 0x9e, 0xad, + 0xe2, 0xe4, 0x8a, 0x76, 0x92, 0x5a, 0x14, 0x6d, 0x28, 0x16, 0xa1, 0x34, + 0x86, 0xd1, 0x06, 0xa5, 0xbd, 0x42, 0x3c, 0x09, 0x46, 0x45, 0x20, 0x51, + 0x20, 0xfa, 0x95, 0x78, 0xa3, 0xaf, 0xed, 0xf3, 0x7c, 0x7f, 0x5f, 0x18, + 0x4e, 0x36, 0x93, 0x08, 0x67, 0x47, 0xed, 0x42, 0xcb, 0x6c, 0xb4, 0x88, + 0x76, 0x9d, 0xe7, 0x0b, 0x8e, 0x0a, 0x59, 0x94, 0x1f, 0x88, 0xc5, 0x81, + 0x7d, 0x84, 0xb4, 0x35, 0xda, 0x9f, 0x41, 0x18, 0x6c, 0xc0, 0xe3, 0x44, + 0xf9, 0x4b, 0x88, 0xb9, 0x8a, 0x38, 0x28, 0x5f, 0xfa, 0x55, 0x9f, 0x66, + 0x28, 0x58, 0x58, 0x94, 0x31, 0xac, 0xa2, 0xe0, 0xb2, 0x15, 0xfa, 0xb4, + 0x47, 0x4a, 0x25, 0x2e, 0xdd, 0x81, 0xb6, 0x51, 0xc7, 0xe0, 0x94, 0xb8, + 0xc6, 0x0f, 0x69, 0xc5, 0xad, 0xba, 0x8c, 0x72, 0xbf, 0x41, 0x5b, 0xfe, + 0x1e, 0x9a, 0xe7, 0x71, 0xc2, 0x02, 0x2d, 0xd3, 0x53, 0x5f, 0xeb, 0x2d, + 0xe7, 0xe0, 0x04, 0x92, 0x9f, 0x09, 0xcf, 0xdc, 0xb3, 0x8f, 0xde, 0xd1, + 0x5f, 0x05, 0x05, 0x19, 0xc7, 0x30, 0xc8, 0xbe, 0xbc, 0x4b, 0xbc, 0xc4, + 0xe7, 0x37, 0x5e, 0x93, 0xea, 0xdf, 0xd7, 0x38, 0x12, 0xcd, 0xad, 0x08, + 0x42, 0x7c, 0xe1, 0x85, 0xe3, 0xc1, 0xe3, 0x05, 0xf3, 0x09, 0x4e, 0x21, + 0xf4, 0xdd, 0x59, 0xc0, 0xd1, 0xe0, 0x50, 0x80, 0xaf, 0x92, 0x33, 0x5e, + 0x59, 0x08, 0x5d, 0x20, 0x92, 0xad, 0xb5, 0xd4, 0x26, 0x86, 0x3f, 0x44, + 0x3c, 0x5a, 0x8e, 0xa4, 0xe3, 0xc4, 0x2d, 0xe9, 0x6c, 0x26, 0xb2, 0x58, + 0x3d, 0xae, 0xad, 0xb9, 0xb3, 0x84, 0xee, 0x08, 0x90, 0xa1, 0x3b, 0x6b, + 0x74, 0x6a, 0x1f, 0x73, 0x61, 0x89, 0x2b, 0xa0, 0x11, 0x17, 0x00, 0xaa, + 0xc2, 0xe2, 0xd0, 0x45, 0x13, 0x12, 0xf5, 0xe8, 0x6a, 0x41, 0xe6, 0x4a, + 0x3b, 0xb7, 0x7c, 0xfe, 0x51, 0x73, 0x0a, 0x39, 0xba, 0x51, 0x4b, 0x67, + 0xe0, 0xb4, 0xfc, 0xb8, 0x31, 0x4e, 0x31, 0x6c, 0x9d, 0x7c, 0xb2, 0xde, + 0x0a, 0x64, 0x93, 0x49, 0x61, 0xd1, 0xc3, 0x22, 0x1a, 0x5e, 0xe8, 0xdd, + 0x44, 0x6d, 0x10, 0x1b, 0xfb, 0xf6, 0x62, 0x59, 0x26, 0x2d, 0x6e, 0xc1, + 0x50, 0x67, 0x27, 0xdb, 0x5c, 0x9b, 0x95, 0x53, 0x3a, 0x45, 0xa2, 0xda, + 0x21, 0x5e, 0x95, 0x1f, 0xd4, 0x51, 0x84, 0x48, 0xb5, 0xae, 0x14, 0x3d, + 0x02, 0xa7, 0xdd, 0x61, 0xcd, 0xeb, 0xf0, 0xe8, 0xbc, 0x00, 0xe8, 0x56, + 0xe0, 0x78, 0x50, 0xc0, 0x6a, 0x38, 0xb7, 0x46, 0xc3, 0x36, 0xb1, 0x90, + 0x01, 0xb2, 0x8b, 0xea, 0x12, 0x79, 0x50, 0x9c, 0x36, 0xcd, 0x89, 0xe6, + 0xba, 0x69, 0x7e, 0x44, 0x0a, 0xcf, 0xe5, 0x4a, 0x10, 0xd2, 0x85, 0xb2, + 0x5f, 0xfc, 0x38, 0xe9, 0xbd, 0x33, 0xd1, 0xc1, 0x35, 0x5e, 0xc5, 0x01, + 0xa4, 0x97, 0xfb, 0x22, 0x0a, 0x8c, 0xa2, 0x8d, 0xaa, 0x99, 0x6e, 0xf7, + 0x26, 0xe5, 0xef, 0xb5, 0x4e, 0xba, 0xab, 0x7d, 0x52, 0xe0, 0xc0, 0x37, + 0x6d, 0x27, 0xef, 0x68, 0x42, 0x97, 0x99, 0x84, 0x44, 0x4d, 0x4f, 0x3b, + 0x35, 0xe3, 0x4e, 0x4c, 0x84, 0xdc, 0x03, 0xdc, 0x61, 0x3e, 0x1c, 0xa3, + 0x7d, 0x2e, 0x04, 0xc9, 0xc9, 0x3a, 0x46, 0x62, 0xcd, 0x71, 0xa6, 0x4a, + 0x40, 0xba, 0xc8, 0xa2, 0xf4, 0x21, 0xc1, 0xe3, 0xec, 0x13, 0x90, 0x89, + 0x48, 0xad, 0x93, 0xe2, 0x54, 0x12, 0xd9, 0x8d, 0x79, 0x95, 0x59, 0x4e, + 0xfa, 0xbe, 0x8f, 0x76, 0x97, 0x04, 0x16, 0xb1, 0x74, 0xe1, 0x7c, 0x0d, + 0x91, 0xfc, 0x2f, 0x9a, 0xbf, 0x9b, 0x73, 0xc7, 0xc5, 0x05, 0x62, 0x4f, + 0xbf, 0x12, 0x8f, 0xa1, 0x8e, 0xd7, 0x74, 0x4b, 0x5a, 0x70, 0x89, 0x42, + 0xf5, 0xe3, 0x61, 0x06, 0x03, 0xd9, 0x17, 0x6c, 0x38, 0xf5, 0xe0, 0xfc, + 0xdc, 0x79, 0x18, 0xd2, 0x3c, 0x29, 0x3a, 0x69, 0x2c, 0xdf, 0xb9, 0x74, + 0x0e, 0xb0, 0xee, 0x4b, 0xd1, 0x80, 0x6d, 0x77, 0x60, 0xad, 0x3c, 0x6d, + 0x52, 0x52, 0x88, 0x25, 0xc6, 0xb0, 0x9f, 0x0c, 0xd0, 0x34, 0x92, 0x51, + 0xb8, 0x33, 0x3d, 0xe0, 0x99, 0x3e, 0xd8, 0xa9, 0x56, 0xab, 0x6a, 0xe7, + 0x37, 0xd0, 0x2c, 0x56, 0x54, 0x04, 0x88, 0xa4, 0xe7, 0x5e, 0xd5, 0xdd, + 0x7d, 0xdd, 0x5f, 0xaa, 0x49, 0xab, 0x73, 0x35, 0x79, 0x79, 0x22, 0x8d, + 0x30, 0x72, 0xee, 0x7a, 0x29, 0x01, 0x84, 0xf1, 0xe6, 0xee, 0xc8, 0x32, + 0x86, 0x89, 0x68, 0x82, 0xb1, 0x18, 0xd9, 0xbc, 0xd9, 0x69, 0x85, 0x70, + 0xa7, 0xfd, 0x95, 0xc5, 0xb1, 0x5b, 0xc6, 0xbd, 0xce, 0x85, 0xec, 0xdc, + 0x1d, 0xfd, 0x6c, 0x1c, 0xc6, 0x62, 0x3f, 0x91, 0x03, 0xf0, 0xad, 0xfb, + 0x45, 0x1b, 0xed, 0x62, 0xa0, 0x24, 0x0e, 0xfe, 0xba, 0x70, 0xae, 0x68, + 0x58, 0x79, 0xbd, 0x0c, 0x9f, 0xaa, 0x37, 0xaf, 0x24, 0x63, 0x3f, 0x25, + 0x89, 0x45, 0xe3, 0x3a, 0x97, 0x6f, 0x3c, 0x86, 0x9a, 0x46, 0x04, 0x9e, + 0xe2, 0xe8, 0x71, 0x6e, 0xbc, 0xe2, 0x1b, 0x0e, 0x54, 0xaa, 0xba, 0xae, + 0x11, 0x66, 0x87, 0x22, 0x9f, 0x1b, 0x3e, 0x55, 0x29, 0xa2, 0x8a, 0x21, + 0xc7, 0xca, 0xb0, 0x85, 0xdf, 0x57, 0x31, 0x74, 0xed, 0x80, 0xc6, 0xd3, + 0x14, 0x9d, 0xde, 0xc3, 0x4c, 0x5f, 0xaa, 0xd6, 0xcd, 0x89, 0x2b, 0x63, + 0xcc, 0x73, 0x85, 0x51, 0x1e, 0x0e, 0x8a, 0x37, 0x82, 0x6e, 0x99, 0xf5, + 0x70, 0x21, 0xb5, 0x65, 0x59, 0x2c, 0xf1, 0xbb, 0xec, 0xf0, 0x74, 0x48, + 0x53, 0x79, 0xe5, 0xa1, 0xbc, 0xa3, 0xca, 0x7e, 0xab, 0x99, 0x64, 0xa4, + 0x1a, 0x98, 0x42, 0xa7, 0x14, 0xa4, 0x5b, 0xca, 0x56, 0x28, 0xa3, 0xc3, + 0x6b, 0x5a, 0x51, 0x9e, 0x7b, 0xdc, 0x43, 0xdd, 0xc5, 0x4d, 0x9f, 0x9d, + 0x76, 0xad, 0x46, 0x74, 0x86, 0x8f, 0x36, 0x36, 0x94, 0xe1, 0xde, 0x8d, + 0x47, 0x3f, 0x4c, 0x70, 0xca, 0x7b, 0xcf, 0xc7, 0x26, 0xfb, 0x0e, 0x2e, + 0x7c, 0x1b, 0x20, 0xcf, 0x86, 0x44, 0xfc, 0x4b, 0x6f, 0x7d, 0xad, 0x16, + 0xa8, 0x9f, 0x10, 0x4c, 0x3b, 0x69, 0x4a, 0xe5, 0x6e, 0x1c, 0x6d, 0xd3, + 0x3b, 0x29, 0x05, 0x61, 0x2c, 0x12, 0x12, 0x23, 0x12, 0xd7, 0x2e, 0x9e, + 0x28, 0xe3, 0x50, 0x87, 0x1f, 0x90, 0x6d, 0x08, 0x93, 0x6a, 0x20, 0x13, + 0x89, 0xd9, 0x54, 0xa2, 0xad, 0x47, 0xa6, 0x3e, 0xc9, 0x34, 0x82, 0x5c, + 0x7b, 0x24, 0x51, 0x09, 0x55, 0xf6, 0x62, 0xec, 0xe8, 0xd2, 0x76, 0x54, + 0x42, 0xce, 0x34, 0x24, 0x38, 0xdb, 0x00, 0x4c, 0x72, 0x35, 0x10, 0x4e, + 0xd3, 0x0c, 0x7b, 0x27, 0x8f, 0x46, 0x89, 0xce, 0x37, 0xa6, 0xca, 0xdf, + 0xfe, 0xc8, 0x16, 0x9a, 0xc2, 0x48, 0x90, 0x4b, 0x89, 0xc2, 0x4f, 0x46, + 0xe1, 0x1f, 0xe2, 0x90, 0x62, 0x2d, 0x2b, 0x03, 0x05, 0xac, 0x88, 0x6b, + 0x25, 0x80, 0x93, 0x93, 0x64, 0x15, 0x3a, 0x49, 0x47, 0x3f, 0x41, 0x71, + 0xbd, 0x5c, 0x58, 0x97, 0x7b, 0xff, 0x96, 0xca, 0x66, 0x8b, 0x5c, 0xac, + 0xcc, 0xd4, 0x76, 0xd7, 0x79, 0xd5, 0x0c, 0xdb, 0xb7, 0x09, 0x8a, 0x82, + 0xc9, 0x27, 0x26, 0x25, 0x46, 0xbb, 0x46, 0xc4, 0xab, 0xab, 0x08, 0x6f, + 0xac, 0x39, 0x7c, 0x6f, 0xa4, 0xe9, 0xea, 0xc9, 0xd2, 0xd9, 0x49, 0x73, + 0x05, 0x93, 0xfe, 0x52, 0x56, 0xb1, 0x6d, 0x3a, 0x1d, 0x93, 0xa6, 0x8b, + 0x06, 0x4a, 0xc2, 0x5b, 0x24, 0x49, 0xd4, 0xbb, 0x5b, 0xf4, 0x00, 0xee, + 0x9c, 0xff, 0xf8, 0x3d, 0x08, 0x0c, 0x2b, 0x11, 0x92, 0x4c, 0x16, 0x00, + 0x14, 0x00, 0x13, 0x00, 0x12, 0x00, 0x11, 0x00, 0x10, 0x00, 0x0c, 0x00, + 0xe7, 0x25, 0xe7, 0xfa, 0xe4, 0x35, 0xc4, 0x98, 0x87, 0xe2, 0x6f, 0xc3, + 0x3d, 0xfe, 0x03, 0x92, 0xfb, 0xd6, 0x47, 0x5e, 0xea, 0xc9, 0x85, 0x93, + 0xfd, 0x52, 0x68, 0xf1, 0xf0, 0x01, 0xb0, 0x23, 0x14, 0xb3, 0x36, 0xc0, + 0x3f, 0x40, 0xb8, 0x20, 0xe7, 0xce, 0xed, 0x63, 0x66, 0xe6, 0x6f, 0x22, + 0xa7, 0xdf, 0xdf, 0xa8, 0xfe, 0xc5, 0x87, 0x24, 0x89, 0xe4, 0x18, 0xa8, + 0x32, 0xf0, 0xe4, 0xdb, 0xc8, 0x41, 0x64, 0x66, 0xc4, 0x7b, 0x37, 0x28, + 0x24, 0xe7, 0xa5, 0xd6, 0x1b, 0x91, 0x90, 0x3b, 0xa1, 0xbf, 0x34, 0x05, + 0x48, 0x12, 0xc1, 0x5c, 0x1e, 0x90, 0xbb, 0x81, 0x5a, 0x1d, 0x43, 0x16, + 0xa1, 0x3a, 0xa6, 0xd9, 0xf5, 0xe5, 0x71, 0x59, 0x0a, 0x46, 0x88, 0x41, + 0xe5, 0x9c, 0x59, 0x18, 0x8d, 0x3d, 0x70, 0x98, 0x79, 0xba, 0x8f, 0xe5, + 0xf0, 0xa9, 0x36, 0x1a, 0xa4, 0x52, 0x0a, 0x97, 0x4a, 0xaf, 0x2d, 0xa3, + 0x55, 0x69, 0x0d, 0xde, 0xcf, 0x69, 0x96, 0xb4, 0x7f, 0x0e, 0x7e, 0x4a, + 0x6c, 0x10, 0xe1, 0xa6, 0x1a, 0x94, 0x77, 0x00, 0x12, 0x96, 0x42, 0x63, + 0xc3, 0xfa, 0x75, 0x1c, 0x94, 0xdc, 0x35, 0xe1, 0x8c, 0x25, 0x27, 0xb9, + 0x36, 0x20, 0xc2, 0x6a, 0x09, 0x43, 0xfc, 0xc0, 0x0a, 0x99, 0x04, 0xa8, + 0x84, 0xc0, 0x74, 0xa2, 0x29, 0xcb, 0x54, 0x4c, 0x43, 0xf1, 0xa3, 0x13, + 0x45, 0x93, 0x47, 0xcb, 0xf7, 0x09, 0xac, 0x92, 0xc8, 0x7e, 0x60, 0x77, + 0x6b, 0x00, 0x8f, 0x8c, 0xbd, 0xa8, 0xce, 0xb1, 0xdb, 0xf1, 0x2a, 0x45, + 0x7d, 0xb4, 0x91, 0x2b, 0x95, 0x7c, 0x75, 0xd8, 0xa2, 0xba, 0x9a, 0x04, + 0xb8, 0xbd, 0x4f, 0x65, 0xcc, 0x8e, 0x95, 0x6b, 0x6a, 0x48, 0x90, 0x88, + 0x63, 0x2b, 0x6a, 0x4d, 0xf7, 0xbe, 0x86, 0xf0, 0xaa, 0xbd, 0x62, 0xfc, + 0x62, 0x03, 0x9e, 0x48, 0x73, 0xd2, 0xc0, 0x40, 0xc1, 0xc3, 0x6f, 0x0c, + 0x2a, 0x62, 0xe7, 0xa5, 0xcf, 0xc1, 0xf6, 0xe1, 0xba, 0xe2, 0x8f, 0x88, + 0x48, 0x33, 0xaa, 0xd0, 0xd6, 0x74, 0xb1, 0x96, 0x95, 0x27, 0xf8, 0xdf, + 0xca, 0x86, 0x80, 0xad, 0x48, 0x34, 0xf4, 0xcf, 0xf4, 0xa2, 0xe0, 0xa5, + 0x37, 0x0a, 0x1b, 0xdb, 0xaf, 0x2d, 0x95, 0xc3, 0x2f, 0x60, 0x73, 0xae, + 0xe2, 0x21, 0x72, 0x14, 0x67, 0xc9, 0x21, 0xfa, 0x52, 0x24, 0xdc, 0x4a, + 0x02, 0xb6, 0x8c, 0xde, 0x13, 0xa0, 0x35, 0xc9, 0xf0, 0xdf, 0x36, 0xec, + 0x1e, 0xc1, 0x95, 0xe8, 0x0c, 0x8a, 0x2c, 0xb0, 0xff, 0x76, 0x9d, 0xf0, + 0x2f, 0xe6, 0xbf, 0xaf, 0xf9, 0xfa, 0x82, 0x6c, 0x95, 0x2e, 0xa5, 0x07, + 0x93, 0x51, 0x4c, 0xeb, 0xd5, 0x24, 0xb5, 0x02, 0x29, 0xb8, 0x62, 0x1b, + 0xb4, 0x83, 0x05, 0x12, 0x89, 0xcb, 0x88, 0x0c, 0xcb, 0x54, 0xa9, 0x56, + 0xb5, 0xf2, 0x91, 0x32, 0x38, 0xc1, 0x32, 0xb4, 0x7a, 0x9d, 0x9c, 0xb1, + 0x40, 0xe4, 0xa4, 0x3b, 0x04, 0x8c, 0x3a, 0x81, 0xd8, 0x7b, 0x72, 0x8d, + 0x5f, 0xa5, 0x6c, 0x6b, 0x47, 0x54, 0x48, 0xdc, 0xa6, 0x9e, 0x40, 0xa7, + 0xea, 0xc2, 0x18, 0x80, 0xe9, 0xca, 0xd6, 0x7c, 0x90, 0x1b, 0xa7, 0xdd, + 0xa7, 0xf7, 0xdb, 0x90, 0x90, 0x0f, 0xa8, 0xca, 0x26, 0xc8, 0x02, 0x69, + 0x7a, 0xc2, 0xae, 0x57, 0x4d, 0xb1, 0x87, 0x16, 0x3b, 0xae, 0xce, 0x0e, + 0x0e, 0x05, 0xe9, 0x63, 0x84, 0x0f, 0xb1, 0x94, 0xd9, 0x3d, 0xbd, 0x76, + 0xd7, 0x8f, 0x23, 0x24, 0xa2, 0x12, 0x8e, 0x3e, 0x8b, 0xb8, 0x67, 0x00, + 0xc2, 0xd7, 0x44, 0xf9, 0x78, 0xe0, 0x54, 0xd2, 0xb3, 0x63, 0x72, 0xa6, + 0x2c, 0xb3, 0xa1, 0xf3, 0xbd, 0x9d, 0xa7, 0x32, 0xbe, 0x95, 0xe9, 0x61, + 0xa8, 0x8d, 0x3b, 0xd4, 0x7a, 0x46, 0xf0, 0x82, 0x97, 0x2d, 0x79, 0x0e, + 0x92, 0x10, 0xb2, 0x3d, 0x35, 0x87, 0x72, 0x59, 0x8a, 0x8b, 0x82, 0x2b, + 0x52, 0x95, 0x9d, 0x26, 0xcc, 0x0e, 0xe0, 0xc2, 0x88, 0x04, 0x9f, 0xe5, + 0x14, 0xed, 0xe1, 0x1a, 0xe8, 0x82, 0xc9, 0x02, 0x7b, 0x38, 0x21, 0x27, + 0xba, 0x3a, 0xd0, 0xe2, 0xf5, 0xa7, 0x69, 0xd4, 0x91, 0xa9, 0xa7, 0x1d, + 0xdb, 0x32, 0x45, 0x1d, 0x49, 0xcb, 0x88, 0xa5, 0x3a, 0xce, 0x36, 0xa9, + 0xaf, 0xec, 0xf1, 0xf2, 0x53, 0xd7, 0x52, 0x95, 0x78, 0xf6, 0xf5, 0x73, + 0x46, 0xa5, 0x88, 0x19, 0x32, 0xf9, 0xd4, 0xa1, 0x05, 0x06, 0x55, 0xf2, + 0x95, 0xa5, 0x5b, 0xd1, 0x4c, 0x1e, 0xa1, 0x1c, 0x31, 0x31, 0xa0, 0x54, + 0x2f, 0xa0, 0xad, 0x02, 0x5e, 0x15, 0xcc, 0x19, 0x66, 0xa5, 0x99, 0x9f, + 0xb4, 0x91, 0xbc, 0x37, 0xb0, 0xbb, 0xa1, 0x4b, 0xa0, 0xa5, 0xd2, 0xb9, + 0x02, 0x79, 0xcd, 0xb9, 0x18, 0xc8, 0x94, 0xc6, 0xfa, 0xac, 0xd3, 0xa4, + 0x9e, 0xc6, 0x7e, 0x05, 0x2a, 0xd1, 0x33, 0x4e, 0x48, 0x57, 0x72, 0x82, + 0x11, 0x96, 0xdd, 0x85, 0xd7, 0x1c, 0x16, 0xb0, 0x98, 0xf3, 0xc2, 0x7a, + 0xc5, 0xb3, 0x69, 0xf3, 0x32, 0x95, 0xf3, 0xbf, 0x1e, 0xac, 0x4b, 0xa8, + 0x16, 0x8d, 0x0c, 0x48, 0x42, 0xbb, 0x4a, 0x99, 0xf7, 0x66, 0x2b, 0xb5, + 0xa1, 0xe3, 0x99, 0x7a, 0x78, 0x45, 0x78, 0xbc, 0x25, 0x60, 0x53, 0x31, + 0x83, 0x38, 0x8f, 0x2e, 0x34, 0x96, 0xf3, 0xb8, 0x9c, 0x13, 0x47, 0x72, + 0xa8, 0x0f, 0xcf, 0x21, 0x9a, 0x39, 0x73, 0x98, 0xdc, 0x9a, 0x42, 0x1f, + 0xb1, 0x3d, 0x4f, 0xad, 0x4d, 0x8c, 0x76, 0xc5, 0x31, 0x6a, 0x40, 0x96, + 0x46, 0xd0, 0x8e, 0x48, 0x3b, 0x4d, 0x43, 0x1a, 0x61, 0x67, 0x5b, 0x99, + 0x56, 0x83, 0x83, 0xc4, 0xfd, 0x5e, 0xe2, 0xd6, 0x34, 0x27, 0xa2, 0x28, + 0xf5, 0x1e, 0xba, 0xe1, 0x47, 0x8c, 0x96, 0xf3, 0x6c, 0xf5, 0x54, 0xd4, + 0xf4, 0xf7, 0xeb, 0x44, 0xdb, 0x25, 0xd5, 0x1d, 0xac, 0xf7, 0x2b, 0x16, + 0xaf, 0xaa, 0x03, 0xd1, 0x98, 0x0a, 0x8d, 0xf0, 0x88, 0x04, 0xbc, 0x0f, + 0x41, 0x9b, 0xef, 0x12, 0x95, 0xb5, 0x91, 0x4e, 0x32, 0x62, 0xec, 0x63, + 0x18, 0x2d, 0x8c, 0x5e, 0x44, 0xfe, 0xd5, 0x60, 0x54, 0x7c, 0x90, 0x33, + 0x0a, 0x6d, 0x3f, 0x44, 0x52, 0x8a, 0xef, 0x41, 0x9d, 0xf7, 0xf3, 0xa2, + 0x55, 0xba, 0x86, 0x03, 0xa5, 0xb8, 0x49, 0x93, 0xa0, 0x53, 0xb5, 0x92, + 0xd7, 0x5b, 0xe4, 0xfa, 0xe0, 0x2b, 0xe2, 0x13, 0x4e, 0xbd, 0xdf, 0xdb, + 0x04, 0x19, 0xaf, 0x05, 0xec, 0xd3, 0xea, 0x4b, 0xf9, 0xce, 0x98, 0xb9, + 0xbf, 0x98, 0x24, 0x1b, 0xfa, 0x66, 0xd7, 0x42, 0x69, 0x36, 0x9a, 0x2e, + 0x0f, 0x25, 0x46, 0x5f, 0xcb, 0x39, 0x5d, 0x70, 0xad, 0x37, 0xb2, 0xd1, + 0xf2, 0x90, 0x5d, 0x45, 0xd5, 0x21, 0x67, 0x37, 0xdd, 0xb8, 0xf7, 0xbd, + 0x41, 0xe8, 0xca, 0xaa, 0x73, 0x95, 0xa3, 0x58, 0x75, 0x26, 0xde, 0x1f, + 0x66, 0x7c, 0xa0, 0x6c, 0xa1, 0x92, 0xe6, 0x12, 0xaa, 0xa0, 0x94, 0x91, + 0xbd, 0x51, 0x4a, 0x5e, 0x73, 0xf1, 0xc4, 0x27, 0x35, 0x3d, 0x22, 0x39, + 0x84, 0x2b, 0x0a, 0xf3, 0x49, 0x7d, 0x39, 0x33, 0xbd, 0xb1, 0xe8, 0x3c, + 0x48, 0xef, 0x87, 0x42, 0x42, 0x75, 0x2b, 0x59, 0x7e, 0x6c, 0x9f, 0xec, + 0x57, 0x0c, 0x85, 0xbb, 0x2f, 0x22, 0x4e, 0x70, 0x97, 0x6e, 0x0b, 0x40, + 0xaa, 0x4d, 0xa2, 0x48, 0xe1, 0x4a, 0x5a, 0xe4, 0x6a, 0x99, 0x79, 0x33, + 0xea, 0xef, 0xb0, 0x17, 0x50, 0x57, 0xaa, 0x6e, 0xe4, 0x7b, 0x58, 0x9e, + 0x40, 0x88, 0xde, 0x7f, 0x2e, 0xc0, 0x3f, 0x7a, 0x63, 0x7a, 0x4b, 0xbf, + 0xa2, 0x46, 0xa7, 0xdd, 0x08, 0x96, 0xfe, 0xe4, 0xf7, 0x9d, 0x5b, 0x22, + 0x7c, 0x45, 0xe5, 0x14, 0x98, 0x64, 0xca, 0x14, 0xba, 0xf3, 0x8c, 0xde, + 0x24, 0x4f, 0x0c, 0xb6, 0xc9, 0xf3, 0xc6, 0x9e, 0xdf, 0x12, 0xdc, 0xe9, + 0x33, 0x16, 0xe4, 0x33, 0x58, 0x3f, 0x5c, 0xd7, 0xc7, 0xaf, 0x6b, 0xaf, + 0x09, 0x42, 0x30, 0x75, 0x7f, 0xa1, 0x31, 0xcd, 0x76, 0xe3, 0x8b, 0xa1, + 0xed, 0x96, 0x8c, 0xf2, 0x08, 0x55, 0x95, 0xc9, 0xf6, 0xe6, 0x58, 0xa8, + 0x73, 0x34, 0xeb, 0x1f, 0x52, 0x0b, 0x1a, 0xf1, 0xce, 0x13, 0x3a, 0xbe, + 0xb1, 0x96, 0x22, 0x69, 0xd9, 0xd2, 0x94, 0x21, 0xfd, 0x31, 0x4b, 0x59, + 0xbc, 0xec, 0xfd, 0x39, 0x9f, 0x5e, 0x1c, 0x0e, 0xd1, 0xe6, 0xfc, 0x53, + 0x48, 0xb5, 0x89, 0xe1, 0x8b, 0xf9, 0xf7, 0x64, 0xfb, 0x11, 0xee, 0x08, + 0xbb, 0x47, 0x4e, 0x59, 0xa6, 0x18, 0xbd, 0xc6, 0x63, 0xc5, 0x9d, 0x64, + 0x8e, 0x75, 0x08, 0xfe, 0x08, 0x60, 0x38, 0xfd, 0x08, 0xf2, 0x3c, 0xdf, + 0x17, 0x65, 0xfa, 0x95, 0xcf, 0x2f, 0x8a, 0xc2, 0x71, 0xb6, 0x36, 0xfe, + 0x93, 0x04, 0xa6, 0xb2, 0x27, 0x2a, 0x2f, 0xdd, 0x40, 0xbb, 0xea, 0xed, + 0xc3, 0xdb, 0xd6, 0xa9, 0xea, 0x6a, 0xb7, 0x7a, 0xc4, 0xc4, 0x56, 0xfe, + 0xa0, 0xd6, 0xb7, 0x6e, 0xf5, 0x35, 0xeb, 0x54, 0xa9, 0x38, 0xab, 0xfb, + 0x52, 0xcd, 0x52, 0x2f, 0x89, 0x09, 0xa9, 0x53, 0x43, 0xa9, 0x06, 0x41, + 0xc5, 0x46, 0xeb, 0x1b, 0xf9, 0xde, 0x15, 0x6e, 0xd0, 0xd8, 0xb0, 0x99, + 0x76, 0xc1, 0xda, 0x55, 0xce, 0xbc, 0x9f, 0x28, 0x1a, 0xb9, 0xc3, 0x60, + 0xb9, 0xa9, 0x58, 0xb0, 0x42, 0x2e, 0xe3, 0x19, 0xb7, 0xda, 0xed, 0x44, + 0x6e, 0x34, 0xe2, 0xae, 0xc1, 0xa7, 0x24, 0xb2, 0x90, 0xf3, 0x27, 0x9d, + 0x63, 0x5e, 0x37, 0x32, 0x7b, 0x85, 0x64, 0x2f, 0x1f, 0xbe, 0x23, 0xc5, + 0x1d, 0xad, 0xb8, 0x48, 0xd4, 0xd1, 0xd8, 0x0b, 0x22, 0xb0, 0x8b, 0x4a, + 0xb3, 0x91, 0xcd, 0xf6, 0xf3, 0x3b, 0x45, 0xf7, 0xdb, 0x2f, 0xf7, 0x30, + 0xa1, 0x41, 0x62, 0x00, 0x6c, 0xe4, 0x85, 0x55, 0x1e, 0xc8, 0x67, 0x85, + 0x95, 0x30, 0x87, 0x5b, 0x54, 0x16, 0xd0, 0xb3, 0xfe, 0x6f, 0x75, 0x63, + 0x95, 0x2f, 0x26, 0x17, 0xc6, 0xba, 0xd9, 0xd1, 0xcd, 0x73, 0x93, 0x42, + 0xcd, 0xe8, 0x84, 0xe7, 0x1d, 0xbc, 0xd9, 0x16, 0xe0, 0xf3, 0x42, 0xf3, + 0xfe, 0x04, 0xac, 0xe5, 0x40, 0xb3, 0x80, 0x54, 0xb1, 0x8a, 0x44, 0x6e, + 0xa0, 0x0e, 0x98, 0x00, 0x27, 0x30, 0x7e, 0x80, 0x48, 0xc0, 0x22, 0x13, + 0x65, 0xa7, 0xe3, 0xb3, 0x1b, 0xcc, 0x48, 0x80, 0x60, 0xe5, 0xfb, 0x33, + 0x98, 0x73, 0x5f, 0x8c, 0xf3, 0x42, 0x2a, 0x2f, 0x40, 0xbc, 0xf7, 0xbc, + 0x50, 0xd1, 0x06, 0x8d, 0xe4, 0x65, 0x14, 0x6a, 0x0d, 0x1e, 0x93, 0x43, + 0x73, 0x29, 0x61, 0x2c, 0xe9, 0x2a, 0x00, 0x88, 0x31, 0x08, 0x43, 0x94, + 0xfa, 0x82, 0x30, 0x0f, 0x25, 0x66, 0xc5, 0xd1, 0x7a, 0x94, 0x89, 0x7c, + 0x90, 0x5f, 0x06, 0x95, 0x59, 0x43, 0x76, 0xbc, 0x17, 0x09, 0xb7, 0xaa, + 0x84, 0x81, 0x05, 0xb4, 0x9b, 0xa2, 0x00, 0x17, 0x9c, 0x9c, 0x6d, 0x74, + 0x65, 0x11, 0x72, 0x15, 0x0f, 0xcd, 0xa4, 0x2f, 0xa7, 0x2c, 0x5a, 0x71, + 0x0a, 0x09, 0x13, 0x39, 0x02, 0xa7, 0x94, 0x9d, 0xa6, 0x17, 0xd3, 0xae, + 0x08, 0xbb, 0x7c, 0xe9, 0xe4, 0xbd, 0x2e, 0x36, 0x37, 0x1a, 0xe8, 0x6d, + 0x5a, 0xf0, 0x42, 0x18, 0x95, 0x8c, 0x5e, 0xb9, 0x39, 0xa0, 0x48, 0x9b, + 0x24, 0x4a, 0xce, 0xba, 0x8a, 0xd7, 0xa7, 0x8b, 0x32, 0x22, 0x80, 0x90, + 0x1b, 0x4e, 0x5b, 0x8c, 0x2e, 0x32, 0x72, 0x4c, 0xb5, 0x94, 0x13, 0x79, + 0xf5, 0x7c, 0x30, 0x7c, 0xbc, 0x48, 0x8e, 0x8f, 0xfa, 0xa6, 0x16, 0x98, + 0x37, 0x2b, 0xe0, 0x1e, 0x3f, 0xc1, 0x4d, 0x68, 0x86, 0x44, 0xa2, 0x45, + 0xf0, 0xfa, 0x44, 0x92, 0x44, 0xd4, 0xc2, 0x7f, 0x4d, 0x62, 0xf8, 0xeb, + 0xfc, 0x6d, 0xbc, 0x22, 0xd2, 0x84, 0xa5, 0xc0, 0x0b, 0xb1, 0x91, 0x6b, + 0xb7, 0x02, 0x73, 0xb8, 0x2d, 0x83, 0xa8, 0xdd, 0xd0, 0xfa, 0x37, 0x95, + 0x12, 0x50, 0x32, 0xf9, 0x80, 0x0e, 0xa8, 0xff, 0xf8, 0x3d, 0x08, 0x0d, + 0x2b, 0x11, 0xf9, 0x4e, 0xfc, 0x00, 0xfb, 0x00, 0xfd, 0x00, 0xfb, 0x00, + 0xfe, 0x00, 0xfe, 0x00, 0xfd, 0x00, 0xfe, 0x00, 0xe6, 0xb3, 0xd2, 0x8c, + 0x74, 0xe3, 0xea, 0xfc, 0xf0, 0xfd, 0xdf, 0xe3, 0xff, 0x6a, 0xfc, 0xe2, + 0x0b, 0x5b, 0x15, 0x4e, 0x08, 0x62, 0x4f, 0x21, 0x09, 0x5c, 0x49, 0x11, + 0xf2, 0x55, 0x33, 0xda, 0xce, 0x1e, 0x77, 0xa0, 0x89, 0x21, 0x99, 0x07, + 0xdf, 0x22, 0xa6, 0x2f, 0x82, 0xfa, 0x81, 0x23, 0xdf, 0x89, 0xfb, 0xd6, + 0x4a, 0x67, 0x2c, 0x2a, 0xcc, 0x64, 0x5a, 0x89, 0x77, 0x6f, 0xc5, 0x5a, + 0xb7, 0x1c, 0x4c, 0x3a, 0x16, 0x26, 0x12, 0x28, 0x12, 0xe6, 0x30, 0xf8, + 0x8d, 0x15, 0x2f, 0x59, 0xdd, 0x67, 0x27, 0x0d, 0x96, 0xcc, 0xc7, 0x7b, + 0x93, 0xa1, 0x4e, 0x8a, 0x3c, 0x34, 0xb3, 0xc7, 0x3e, 0xdc, 0xd4, 0x50, + 0x4a, 0xf2, 0x14, 0x56, 0xbc, 0x9b, 0x1c, 0xfa, 0x81, 0x1c, 0x03, 0xcf, + 0xee, 0x31, 0xe9, 0xac, 0x2b, 0xa4, 0x6b, 0x9a, 0xef, 0x71, 0xfc, 0xcd, + 0x45, 0xa0, 0xb4, 0xf6, 0x17, 0xaa, 0x68, 0x21, 0x02, 0x2a, 0x02, 0xc6, + 0x98, 0xa3, 0xa7, 0x0a, 0x49, 0xaa, 0xf4, 0x22, 0x38, 0xad, 0xbd, 0x8a, + 0x71, 0x49, 0xd6, 0x89, 0xf2, 0x86, 0xa9, 0xe3, 0x05, 0x0f, 0x7b, 0x8a, + 0x41, 0xb6, 0x1e, 0x67, 0xaf, 0x85, 0x25, 0x44, 0xc2, 0xbe, 0xb1, 0x98, + 0x68, 0x8a, 0xc5, 0x3a, 0xa6, 0xb6, 0x09, 0x17, 0x7d, 0xb4, 0xc9, 0xe8, + 0xf7, 0x62, 0xf7, 0xf0, 0x26, 0x15, 0x78, 0x46, 0x75, 0x4a, 0x29, 0x71, + 0x82, 0x74, 0x86, 0x36, 0x5f, 0x59, 0x41, 0x3f, 0xe0, 0x3e, 0x35, 0x26, + 0x14, 0x21, 0x9e, 0x2f, 0x90, 0xed, 0x2f, 0x88, 0x58, 0x91, 0x02, 0x8e, + 0xde, 0x15, 0x58, 0xca, 0xe9, 0x9d, 0xf2, 0x1b, 0x46, 0x9f, 0xea, 0xdb, + 0xa5, 0xa5, 0xfa, 0xfe, 0x72, 0xef, 0x8a, 0x36, 0x48, 0x42, 0x01, 0x5c, + 0x43, 0x58, 0x05, 0x99, 0x12, 0xc0, 0x94, 0xfc, 0x8a, 0x5c, 0xe2, 0x55, + 0xd8, 0x26, 0x59, 0x40, 0x8a, 0xe6, 0x58, 0xe2, 0x35, 0xbc, 0x31, 0x55, + 0x59, 0x92, 0x66, 0x2a, 0xaa, 0x0f, 0x7b, 0x1c, 0x9b, 0x8d, 0xa0, 0xa6, + 0x6b, 0xac, 0x8c, 0xf5, 0x21, 0xed, 0x8b, 0xf9, 0x97, 0xa9, 0xd4, 0x85, + 0xf3, 0x9a, 0xb8, 0x25, 0x60, 0xe6, 0xf8, 0x42, 0xd2, 0x0c, 0x04, 0x23, + 0xe2, 0x49, 0xb9, 0x0a, 0xa0, 0xd7, 0x58, 0x77, 0x2b, 0x00, 0x40, 0x15, + 0x84, 0xa1, 0xd1, 0xa3, 0x26, 0x8e, 0x4b, 0x84, 0xcb, 0x09, 0xfd, 0xf7, + 0x3f, 0x16, 0x8a, 0xd1, 0x0a, 0xf5, 0x98, 0x2e, 0x3a, 0x2c, 0xe1, 0x1d, + 0x7d, 0xa0, 0x94, 0x15, 0x70, 0x38, 0xf5, 0x7e, 0x1b, 0x1e, 0x84, 0xc6, + 0xd8, 0x23, 0x4c, 0x97, 0x72, 0x54, 0x59, 0x18, 0xe9, 0x49, 0x3d, 0x34, + 0x52, 0x57, 0xd2, 0x13, 0xda, 0x68, 0x97, 0x7b, 0x36, 0x86, 0x89, 0xbe, + 0xce, 0xc7, 0x54, 0xc9, 0x49, 0xb2, 0x75, 0x4a, 0xd2, 0xca, 0xa8, 0xbc, + 0x99, 0xd6, 0x4c, 0x6d, 0x8b, 0xda, 0x9f, 0x55, 0xc1, 0x89, 0x05, 0xba, + 0x36, 0xc4, 0xb1, 0xaa, 0xb3, 0x7b, 0x89, 0xa7, 0x0a, 0xc9, 0x38, 0x92, + 0x98, 0x67, 0x76, 0x48, 0xd4, 0x57, 0x6c, 0x32, 0x87, 0x04, 0xf0, 0x2e, + 0x9e, 0x54, 0x0a, 0x19, 0xae, 0xe0, 0xd5, 0x55, 0xca, 0x25, 0xac, 0x55, + 0x64, 0xfe, 0x15, 0x87, 0xa9, 0x8b, 0x11, 0xcb, 0x0b, 0x22, 0x5e, 0x25, + 0x63, 0x70, 0x85, 0xa8, 0x2e, 0x65, 0xa8, 0x2d, 0xcd, 0x4c, 0x34, 0x8f, + 0xad, 0x52, 0xeb, 0x9c, 0xec, 0x8f, 0x85, 0xb5, 0x42, 0x91, 0x03, 0xd0, + 0x69, 0x86, 0xd0, 0x83, 0x50, 0x1b, 0x98, 0xa7, 0xc9, 0x20, 0xf0, 0x25, + 0xd0, 0xb2, 0xa1, 0x0a, 0x30, 0x7f, 0x68, 0x29, 0x53, 0xa3, 0x55, 0x9f, + 0x88, 0x1c, 0x77, 0x70, 0xf2, 0xd0, 0x08, 0x5b, 0xbc, 0x22, 0xde, 0x8d, + 0x60, 0xba, 0x6b, 0xa9, 0x6f, 0xc4, 0x01, 0x2d, 0x2e, 0x5a, 0x85, 0x2d, + 0x71, 0x05, 0x1a, 0x15, 0x96, 0xab, 0xa0, 0x35, 0x5d, 0xa1, 0x77, 0x02, + 0xd3, 0xa3, 0xe5, 0x09, 0x6d, 0x1e, 0xcf, 0x60, 0xbf, 0xb5, 0x6b, 0x58, + 0x88, 0x0b, 0xc2, 0xd2, 0xe9, 0x10, 0x49, 0x69, 0xa4, 0x10, 0xe2, 0x23, + 0xc0, 0x37, 0xa3, 0xf6, 0x2f, 0x26, 0x4c, 0x61, 0x1f, 0xdb, 0x92, 0xc1, + 0xf7, 0x57, 0x5a, 0xba, 0xda, 0xf8, 0xdb, 0x23, 0x64, 0x2f, 0xbe, 0xb3, + 0xd0, 0x5d, 0x5e, 0x74, 0xb3, 0x45, 0xc1, 0xb5, 0x4b, 0x00, 0xb5, 0x03, + 0x00, 0x70, 0x68, 0x88, 0xf3, 0x20, 0x7e, 0xd9, 0x7b, 0x4f, 0x34, 0xa3, + 0xad, 0xd2, 0x22, 0xce, 0x58, 0x96, 0x61, 0x42, 0x6f, 0xd0, 0x41, 0x2f, + 0xea, 0x28, 0x3d, 0x32, 0x29, 0x7a, 0xb8, 0x62, 0xa2, 0x9d, 0xf3, 0x93, + 0xf6, 0xd6, 0x7c, 0x88, 0x55, 0x00, 0x86, 0xcf, 0xd7, 0xb5, 0x4f, 0x83, + 0x2a, 0xcd, 0xc8, 0x03, 0x18, 0x56, 0x85, 0x9e, 0x45, 0xcd, 0xf6, 0xb3, + 0x8a, 0x9b, 0x69, 0xc3, 0x9d, 0x04, 0x5f, 0x03, 0xe6, 0x45, 0x3e, 0xbd, + 0xdc, 0x12, 0xd2, 0x4b, 0x74, 0x06, 0x18, 0xc4, 0x0e, 0xb8, 0x8e, 0x19, + 0xea, 0x27, 0x2b, 0x48, 0x42, 0x3f, 0xc0, 0x82, 0xb9, 0x82, 0x24, 0xf6, + 0xc8, 0x87, 0x64, 0xd3, 0x09, 0xe8, 0x13, 0x53, 0x5f, 0x2d, 0x28, 0xb6, + 0x39, 0xb2, 0x48, 0xfb, 0x80, 0x90, 0x9a, 0x34, 0xaa, 0x99, 0x89, 0xa7, + 0x55, 0x66, 0x8e, 0x0f, 0x39, 0x64, 0x12, 0xc4, 0xf4, 0xca, 0x79, 0x18, + 0x89, 0x07, 0xb1, 0x0c, 0x2c, 0x60, 0xef, 0xf9, 0xab, 0x16, 0x34, 0x35, + 0x89, 0x4a, 0x13, 0x73, 0x4e, 0xfd, 0x8b, 0x35, 0xe8, 0x8a, 0xb5, 0x77, + 0x61, 0xd6, 0x1a, 0x29, 0xb6, 0x27, 0x55, 0xbf, 0xa9, 0x89, 0xe1, 0x05, + 0x1f, 0xe8, 0xe8, 0xd1, 0x5e, 0x71, 0x79, 0x28, 0x4c, 0x02, 0x8f, 0x53, + 0x3a, 0x53, 0x7d, 0x25, 0x25, 0x92, 0x79, 0x1c, 0xe1, 0x5d, 0xb3, 0xfb, + 0x24, 0xca, 0x8b, 0xa7, 0x75, 0xe6, 0x60, 0x05, 0x92, 0xba, 0x8d, 0xb8, + 0x6a, 0xde, 0x51, 0x81, 0x2d, 0x45, 0x81, 0xf2, 0xd3, 0xeb, 0xc9, 0x3c, + 0xea, 0x4f, 0x34, 0xcc, 0x14, 0x5a, 0x5a, 0x65, 0x50, 0x2b, 0xcf, 0x7e, + 0x79, 0xb0, 0x01, 0x57, 0x1c, 0x16, 0xa8, 0x33, 0x12, 0x8b, 0x5d, 0xd0, + 0xff, 0x89, 0xbf, 0xc1, 0x46, 0x8f, 0x7b, 0xca, 0x6c, 0x24, 0xe8, 0x07, + 0x34, 0xeb, 0x26, 0x2b, 0x70, 0x54, 0x81, 0x81, 0xb6, 0x26, 0xcf, 0x14, + 0x17, 0xa7, 0x41, 0x87, 0x71, 0x04, 0x7e, 0x23, 0xf4, 0x51, 0x70, 0xf7, + 0xdb, 0x99, 0xb1, 0xc7, 0x54, 0xcb, 0x3c, 0xb9, 0x1e, 0xb6, 0x09, 0xcc, + 0xff, 0xf3, 0x24, 0x7e, 0x0b, 0x1a, 0xb7, 0x8b, 0xc9, 0xf1, 0x06, 0x4d, + 0x2a, 0xcd, 0x50, 0xa4, 0x91, 0xbf, 0x2c, 0xf5, 0x27, 0x91, 0x43, 0x59, + 0xc7, 0x92, 0xe2, 0x21, 0x29, 0x43, 0xe6, 0x00, 0x63, 0xcb, 0x89, 0x05, + 0x4d, 0xf6, 0x8d, 0x68, 0xf5, 0x5a, 0xd2, 0x89, 0x99, 0x8b, 0x2b, 0x6c, + 0x32, 0xa4, 0x50, 0x91, 0x0f, 0x72, 0xd0, 0x8d, 0xb6, 0x68, 0xa4, 0x24, + 0x7b, 0x73, 0xe7, 0xe3, 0xab, 0x84, 0x79, 0x5f, 0x34, 0xec, 0x3b, 0xd2, + 0xb4, 0xb9, 0x09, 0x08, 0x01, 0xf6, 0xd7, 0x50, 0xb4, 0x72, 0x01, 0xb9, + 0xb1, 0xa8, 0xf5, 0x04, 0x5c, 0xe9, 0x99, 0x8b, 0x69, 0x66, 0x96, 0x2b, + 0xd1, 0x67, 0xda, 0x42, 0x12, 0x19, 0x19, 0xc4, 0xa0, 0x6c, 0xa1, 0xdd, + 0xe8, 0x95, 0x93, 0x8e, 0x24, 0xc9, 0xba, 0xc6, 0xd7, 0xb1, 0xf6, 0x4d, + 0x93, 0x92, 0xc0, 0xba, 0x0e, 0x4a, 0xcd, 0x17, 0x9a, 0x89, 0xad, 0x5f, + 0xce, 0x03, 0xd1, 0x88, 0x30, 0x83, 0x6e, 0x76, 0xe9, 0x1a, 0x12, 0x36, + 0xd0, 0x33, 0x23, 0x68, 0x27, 0x52, 0x8f, 0x89, 0xa3, 0xc5, 0x9a, 0xc6, + 0xa8, 0x20, 0x91, 0x24, 0x25, 0xca, 0xc5, 0x2f, 0x4a, 0x9a, 0x77, 0xbb, + 0x09, 0x0a, 0x46, 0xa0, 0x3a, 0x3b, 0x06, 0x59, 0xa3, 0x0f, 0x8c, 0x28, + 0x7f, 0xfd, 0x32, 0x11, 0x19, 0x1c, 0xbc, 0xd4, 0xa4, 0xc6, 0x48, 0x9b, + 0x00, 0x8d, 0x2b, 0x45, 0xdd, 0xa7, 0x50, 0x98, 0xa3, 0x12, 0xb3, 0x0a, + 0x16, 0xf2, 0x36, 0xd8, 0x64, 0x03, 0x88, 0xe2, 0xbc, 0xe4, 0x77, 0x76, + 0x4c, 0x2d, 0xc5, 0xde, 0x60, 0xe0, 0xcd, 0xc7, 0xa8, 0x65, 0xf8, 0x57, + 0x44, 0x64, 0x09, 0xc0, 0xd4, 0x77, 0x21, 0x3f, 0x93, 0xdc, 0x5d, 0xd1, + 0x32, 0x34, 0x3f, 0x2c, 0xcf, 0x24, 0xa8, 0xc8, 0x28, 0x77, 0x3c, 0x87, + 0x37, 0x73, 0x49, 0xb8, 0x7e, 0x00, 0x8c, 0xe9, 0x60, 0xb5, 0xea, 0xa9, + 0x41, 0xcb, 0x94, 0xe0, 0x25, 0x96, 0x0f, 0xb8, 0x1d, 0x64, 0x0c, 0xc0, + 0xa3, 0xe0, 0xc3, 0x97, 0x5e, 0xa4, 0x25, 0x53, 0x05, 0x5f, 0xcc, 0x5b, + 0x70, 0x85, 0xb1, 0x93, 0xea, 0x62, 0x77, 0x9d, 0x90, 0xee, 0x57, 0x9b, + 0xd1, 0x6b, 0xbd, 0xb9, 0x76, 0x97, 0x62, 0x61, 0x27, 0xb9, 0x25, 0x58, + 0xf3, 0x12, 0x93, 0x27, 0x65, 0x21, 0x5f, 0xbb, 0x7d, 0x11, 0x4b, 0xa0, + 0x87, 0xb5, 0x14, 0xb5, 0x32, 0x11, 0xaa, 0xc9, 0x5b, 0xa6, 0xc3, 0x29, + 0xbc, 0x44, 0xfe, 0x2e, 0xd8, 0x3a, 0xbd, 0xdc, 0xe5, 0x7d, 0x19, 0x51, + 0x9e, 0xdd, 0x03, 0x8b, 0x8c, 0x0c, 0xd9, 0xab, 0xbd, 0x56, 0x9f, 0x46, + 0xf8, 0x8b, 0x47, 0xe0, 0x02, 0x1d, 0x97, 0x12, 0x62, 0xa4, 0xfa, 0x78, + 0x41, 0x7b, 0x40, 0xa8, 0x06, 0x82, 0x04, 0x5b, 0x8a, 0x37, 0x0c, 0x34, + 0x4e, 0x6a, 0x69, 0x13, 0x96, 0x5c, 0x99, 0xe5, 0xb2, 0x00, 0xe9, 0x57, + 0xc7, 0xaa, 0x55, 0x3c, 0xc1, 0x15, 0xad, 0xbd, 0xfe, 0x9d, 0xa6, 0xc7, + 0xa8, 0x15, 0x65, 0xfa, 0xec, 0x4e, 0x6e, 0xc4, 0x95, 0xca, 0xbd, 0x8a, + 0x55, 0xd2, 0xd9, 0x6a, 0x7d, 0xbe, 0xf8, 0xd7, 0x72, 0x13, 0x47, 0x58, + 0x74, 0x47, 0x4b, 0x77, 0x19, 0x2a, 0x43, 0x30, 0x82, 0x70, 0xbf, 0x21, + 0x34, 0xa7, 0x32, 0x23, 0xed, 0x7b, 0x93, 0x1e, 0x4b, 0xe7, 0x3b, 0x45, + 0x2f, 0x28, 0x22, 0x02, 0x39, 0x78, 0x09, 0x85, 0xa8, 0x58, 0x7f, 0xdc, + 0xd3, 0xe3, 0x6e, 0x42, 0xbc, 0xed, 0x68, 0xa9, 0xf5, 0x14, 0xaf, 0x31, + 0x20, 0xbc, 0x0c, 0x41, 0xd8, 0x19, 0x3d, 0x3b, 0x4e, 0x76, 0xd8, 0x32, + 0x04, 0x23, 0xe6, 0xff, 0xb9, 0xa1, 0x85, 0xa1, 0x52, 0x39, 0x28, 0xb9, + 0x05, 0x6a, 0x5b, 0xb7, 0xe8, 0x74, 0x9f, 0x8a, 0x38, 0xe0, 0x61, 0x62, + 0x67, 0x69, 0xdb, 0xad, 0xc6, 0x6a, 0xae, 0xdc, 0x20, 0x62, 0x00, 0x65, + 0x3d, 0xaa, 0xde, 0xb8, 0x29, 0xd8, 0x48, 0xa1, 0x52, 0xb1, 0xeb, 0xe4, + 0xce, 0x30, 0xc6, 0xaa, 0x85, 0x38, 0x13, 0xe6, 0xb0, 0xb7, 0xc0, 0xf1, + 0xe0, 0xd3, 0x52, 0x34, 0x5c, 0xa4, 0x20, 0x93, 0x44, 0x9f, 0x22, 0xa0, + 0xb1, 0x56, 0xe4, 0x68, 0x2f, 0x75, 0x3a, 0x65, 0x4a, 0xa6, 0x46, 0xdd, + 0x42, 0x64, 0xe4, 0xeb, 0x3b, 0xa6, 0x7b, 0x69, 0xe7, 0x4c, 0xb4, 0xb7, + 0xc2, 0x55, 0x1b, 0x05, 0x3f, 0xb6, 0x3c, 0x94, 0x65, 0x6e, 0x50, 0x70, + 0x41, 0x09, 0x93, 0x4d, 0x49, 0xb1, 0x08, 0x3c, 0xce, 0x68, 0xd2, 0xea, + 0x92, 0x77, 0xaa, 0xaf, 0xdd, 0x50, 0x23, 0xc5, 0x52, 0x69, 0x93, 0x50, + 0x3b, 0x25, 0x94, 0x94, 0xa5, 0x44, 0x3a, 0xaa, 0x49, 0x8b, 0xc8, 0xb2, + 0xc6, 0xea, 0x33, 0x99, 0xb1, 0x90, 0x05, 0x8c, 0x55, 0x0b, 0x9a, 0xff, + 0xda, 0xd0, 0x29, 0xea, 0x99, 0x91, 0x62, 0xb4, 0x80, 0x3e, 0x5f, 0x96, + 0xb6, 0xf3, 0x82, 0xc6, 0x81, 0x26, 0x7f, 0xd7, 0xa1, 0x6d, 0x8c, 0xa0, + 0x08, 0xe6, 0x82, 0x6e, 0xc7, 0xc6, 0xff, 0x2d, 0x39, 0x22, 0xdf, 0x6a, + 0x2b, 0xa4, 0xb8, 0xed, 0xf3, 0x12, 0xb1, 0x69, 0x7e, 0xe4, 0x98, 0xfa, + 0xad, 0x43, 0x85, 0x4c, 0x2a, 0x8f, 0x54, 0x89, 0x5a, 0x5e, 0xfc, 0xa0, + 0xf3, 0x33, 0x61, 0x83, 0x88, 0x12, 0xd6, 0x1d, 0xb4, 0xce, 0x8a, 0x6d, + 0xe0, 0xff, 0x65, 0x84, 0x36, 0x16, 0xa2, 0x49, 0x1a, 0x28, 0x88, 0xd9, + 0x02, 0x76, 0x96, 0x0b, 0x89, 0x26, 0xa9, 0xd8, 0xf4, 0x04, 0xa8, 0x50, + 0x58, 0xe9, 0x98, 0x42, 0x20, 0xd9, 0x1f, 0x1d, 0x9f, 0x60, 0x22, 0xed, + 0xf3, 0x82, 0x61, 0x70, 0xa9, 0x11, 0x97, 0x13, 0x27, 0x70, 0x84, 0xae, + 0x0c, 0xe1, 0x39, 0x18, 0x66, 0x18, 0x48, 0x41, 0xd7, 0x6a, 0x88, 0x4b, + 0x5c, 0x8a, 0x7c, 0x3d, 0x45, 0x22, 0x86, 0x38, 0x5b, 0xed, 0x34, 0xfa, + 0xde, 0xb1, 0x8c, 0x90, 0xcc, 0x2d, 0x3b, 0x61, 0x6f, 0xc8, 0x94, 0xdd, + 0x82, 0xe2, 0x57, 0xe6, 0xdd, 0x2a, 0x89, 0x5e, 0xd9, 0xb7, 0x76, 0x57, + 0xe5, 0x90, 0xaf, 0xec, 0x19, 0xf7, 0xd6, 0xaf, 0x4f, 0xbb, 0x0e, 0xdc, + 0x0b, 0x31, 0x82, 0x5b, 0xb7, 0x4c, 0x09, 0x31, 0x74, 0x00, 0xec, 0xea, + 0x5a, 0xe0, 0xa0, 0xc0, 0x2b, 0xba, 0x34, 0x55, 0x4d, 0x22, 0xa9, 0x3e, + 0x00, 0xde, 0x30, 0xe0, 0xc9, 0x6b, 0xac, 0x93, 0x49, 0x10, 0xc3, 0x6d, + 0x75, 0x73, 0x6d, 0x9c, 0xa4, 0x38, 0x26, 0xd4, 0x65, 0xb6, 0x49, 0xe7, + 0x58, 0xc2, 0x03, 0x9b, 0x2a, 0xe6, 0x99, 0x7c, 0x42, 0x06, 0x1a, 0xe9, + 0xda, 0xd1, 0x4a, 0xea, 0xba, 0x38, 0xd0, 0xf4, 0x35, 0xec, 0xf4, 0x3b, + 0xda, 0x46, 0xf4, 0x23, 0x7f, 0x1e, 0x75, 0xfa, 0xea, 0x54, 0x96, 0x1b, + 0xdc, 0x8f, 0x7a, 0xa6, 0x9b, 0x6e, 0xbc, 0x7f, 0xed, 0x0e, 0xdb, 0xd2, + 0xf8, 0xc2, 0xfc, 0xe3, 0x22, 0x02, 0xf5, 0x0e, 0x11, 0x24, 0xc3, 0xc5, + 0x50, 0x62, 0x5e, 0xe3, 0x0a, 0xc7, 0xd1, 0x12, 0x3a, 0xad, 0x67, 0xd0, + 0xbe, 0x90, 0x87, 0x3f, 0xe4, 0x57, 0x7d, 0x02, 0x32, 0xb7, 0xba, 0x35, + 0xad, 0x71, 0x09, 0xd3, 0x45, 0xc2, 0x07, 0x67, 0xa3, 0x31, 0x0d, 0xc4, + 0x56, 0x1a, 0xcd, 0xb6, 0xaa, 0xa3, 0x2e, 0x3f, 0x36, 0x65, 0x8c, 0xd8, + 0xe8, 0x52, 0xab, 0x11, 0x2b, 0x6b, 0xca, 0x71, 0x0a, 0x5a, 0xad, 0xb2, + 0xbd, 0x93, 0x40, 0xd8, 0x88, 0x22, 0xd2, 0x0c, 0x30, 0x3a, 0x60, 0xcb, + 0xf9, 0x90, 0xb5, 0xec, 0x3b, 0x84, 0xc2, 0x0a, 0xda, 0x49, 0xf3, 0x50, + 0xc5, 0x72, 0xda, 0x70, 0x19, 0x97, 0x52, 0x88, 0xc4, 0xa3, 0x7f, 0x28, + 0x98, 0xc2, 0xf8, 0x7f, 0x7c, 0xf2, 0x55, 0xee, 0x19, 0x5a, 0x05, 0xe7, + 0xc0, 0x2a, 0xea, 0xff, 0xf8, 0x3d, 0x08, 0x0e, 0x2b, 0x11, 0x44, 0x4e, + 0xca, 0x00, 0x01, 0x00, 0x26, 0x00, 0x14, 0x00, 0xfc, 0x00, 0x0b, 0x00, + 0x10, 0x00, 0x18, 0x00, 0xe6, 0x19, 0x18, 0xc3, 0x02, 0x84, 0x8f, 0x4b, + 0xf9, 0x0c, 0x0f, 0x1f, 0x80, 0xb7, 0xfd, 0x7f, 0x81, 0x9e, 0x36, 0x71, + 0x40, 0x85, 0x83, 0x8b, 0xd9, 0x33, 0x54, 0x9f, 0xeb, 0xc8, 0x08, 0x75, + 0xf9, 0x8e, 0x3c, 0x1e, 0x95, 0xab, 0x4b, 0xca, 0x62, 0x3b, 0xf3, 0xb8, + 0x59, 0x77, 0x5d, 0x80, 0x16, 0xa9, 0xb9, 0x76, 0x71, 0x70, 0xd5, 0x59, + 0x79, 0x31, 0xca, 0x7b, 0xf3, 0x53, 0x5c, 0x52, 0xdb, 0x81, 0x39, 0xbc, + 0xb0, 0x03, 0x06, 0xd2, 0xcf, 0xf0, 0x02, 0x88, 0xb4, 0xb6, 0xae, 0x3c, + 0x4f, 0xe4, 0xbe, 0x98, 0x4c, 0x61, 0xfe, 0x77, 0x2b, 0xc4, 0x6e, 0xea, + 0xc9, 0x15, 0x8c, 0x27, 0xd3, 0x63, 0x32, 0x96, 0x6e, 0x44, 0x82, 0x29, + 0xb7, 0xba, 0xc4, 0x65, 0xf1, 0x2e, 0x3d, 0xfe, 0x2c, 0x74, 0xc6, 0x4b, + 0x3a, 0x3f, 0xa1, 0x99, 0x6a, 0x73, 0xe9, 0xb3, 0x60, 0x88, 0xd1, 0x78, + 0x0e, 0x0d, 0x82, 0x52, 0x18, 0x00, 0x3e, 0xf0, 0x19, 0xed, 0x47, 0x90, + 0xe7, 0x20, 0x58, 0x3c, 0x49, 0x72, 0xd3, 0xa9, 0xba, 0x55, 0xe3, 0x21, + 0xe9, 0xb3, 0xcc, 0x24, 0xdc, 0x86, 0x88, 0x53, 0x7f, 0x6c, 0x55, 0x56, + 0xdd, 0x6e, 0x89, 0x93, 0x5f, 0x14, 0x48, 0x16, 0xa6, 0xc4, 0x5a, 0xa6, + 0xdd, 0x09, 0x93, 0x39, 0x0a, 0x48, 0x44, 0x32, 0x78, 0x8e, 0xf1, 0x29, + 0xa4, 0x45, 0x0b, 0xbf, 0x56, 0x59, 0x81, 0xc4, 0xbc, 0x44, 0x48, 0x1a, + 0xc5, 0xc0, 0x23, 0x07, 0xf6, 0x79, 0xc7, 0xdd, 0x03, 0x11, 0x67, 0x6c, + 0xee, 0x9f, 0x7b, 0x33, 0xd9, 0x6d, 0x5f, 0xf0, 0x1c, 0xef, 0xaa, 0x25, + 0x88, 0x1f, 0xad, 0x79, 0x3c, 0x58, 0x2b, 0x50, 0xc2, 0x7c, 0x54, 0xc8, + 0x40, 0xa1, 0xe7, 0xe8, 0xcc, 0xc3, 0x1e, 0x03, 0x7b, 0xb1, 0xee, 0xb5, + 0x83, 0x6b, 0x3e, 0xcd, 0x7d, 0x76, 0x92, 0x8f, 0xcc, 0x12, 0x80, 0x3b, + 0x58, 0x45, 0xc6, 0x5d, 0x73, 0xc7, 0xde, 0xe6, 0x76, 0x28, 0x95, 0xa4, + 0x08, 0x54, 0xeb, 0xf2, 0x83, 0x49, 0x93, 0x4d, 0x3a, 0xd2, 0xf0, 0x16, + 0xf3, 0x4c, 0x31, 0x3f, 0x8a, 0xa2, 0x62, 0x11, 0x81, 0x15, 0xb0, 0x28, + 0xd6, 0x20, 0x90, 0x28, 0x70, 0x61, 0x4d, 0x4c, 0xbe, 0x37, 0x6d, 0xdb, + 0xf6, 0x4f, 0xcd, 0x85, 0x4e, 0x86, 0xff, 0x46, 0x46, 0x83, 0x67, 0x7d, + 0x04, 0xae, 0x3b, 0x2b, 0x12, 0x68, 0x4b, 0x35, 0x3f, 0xfe, 0xb8, 0xf2, + 0xac, 0x24, 0xfc, 0xc3, 0x89, 0xbb, 0x5b, 0x56, 0x97, 0xbe, 0xd6, 0x84, + 0x9e, 0x5a, 0x48, 0x79, 0x19, 0x25, 0x3c, 0x2d, 0x10, 0xd8, 0xe3, 0x33, + 0xc3, 0x16, 0xf0, 0xde, 0x72, 0xbe, 0x2b, 0xa8, 0x2f, 0x3d, 0x57, 0x46, + 0xcb, 0x6e, 0xe0, 0xef, 0x3b, 0x39, 0x11, 0xd2, 0x64, 0x35, 0x93, 0xf4, + 0x59, 0xe8, 0xe4, 0xc2, 0xee, 0xe4, 0x92, 0xa9, 0x88, 0xf3, 0x31, 0xeb, + 0x29, 0x3d, 0x92, 0x2a, 0x41, 0x2f, 0x12, 0xd6, 0x74, 0x67, 0x12, 0x4c, + 0xa3, 0x09, 0x13, 0x29, 0x89, 0x30, 0x86, 0x90, 0x76, 0xa5, 0x27, 0xcb, + 0x7d, 0x08, 0x74, 0x4e, 0xdd, 0x8a, 0x7d, 0x3c, 0xef, 0x01, 0x34, 0x84, + 0x5d, 0xd7, 0x0b, 0xe8, 0x33, 0xfa, 0xe9, 0xd0, 0x31, 0x30, 0xe2, 0x1c, + 0x40, 0x93, 0xd0, 0x8a, 0xfa, 0xfe, 0x91, 0xdb, 0xe7, 0x96, 0xa8, 0x66, + 0x19, 0x33, 0x7b, 0xce, 0x93, 0xc6, 0xaf, 0x68, 0x3c, 0x6e, 0x14, 0x0f, + 0x0d, 0xe4, 0x31, 0x00, 0x21, 0x47, 0x43, 0x5f, 0xea, 0x63, 0x0b, 0x48, + 0x2b, 0x02, 0x69, 0x54, 0x86, 0xfb, 0x26, 0x83, 0x7e, 0x66, 0xdd, 0x97, + 0x27, 0x3c, 0x58, 0xf8, 0xae, 0xca, 0x55, 0x59, 0x5c, 0x1c, 0xb6, 0xc2, + 0x75, 0xca, 0x57, 0x8d, 0xb8, 0x89, 0x63, 0x2b, 0x40, 0x90, 0xf5, 0xae, + 0xca, 0x17, 0x4a, 0x26, 0x3a, 0x6f, 0xf0, 0x25, 0xa5, 0xc0, 0xa4, 0x9f, + 0xa1, 0x1f, 0x61, 0x88, 0x5b, 0x90, 0x6e, 0xf6, 0x47, 0xff, 0x52, 0x8d, + 0xa3, 0x9a, 0x96, 0xad, 0x82, 0x75, 0x07, 0x9f, 0xad, 0xde, 0xe5, 0xb2, + 0x24, 0xdd, 0x67, 0x8f, 0x9f, 0xaa, 0x54, 0xc3, 0x63, 0xe1, 0x9f, 0x3d, + 0x73, 0xa5, 0xa5, 0x89, 0xae, 0x4c, 0x58, 0xfe, 0xe2, 0x10, 0x45, 0x68, + 0xea, 0xb5, 0xb5, 0x8d, 0xad, 0x96, 0xa1, 0xa9, 0x05, 0x77, 0x3c, 0x1e, + 0xd8, 0x27, 0x48, 0xd8, 0x1d, 0x82, 0xa7, 0x1a, 0x65, 0x5b, 0xc0, 0xcb, + 0xf7, 0xd0, 0xa6, 0x7b, 0x89, 0x56, 0x6f, 0xd7, 0x47, 0x11, 0x67, 0xc8, + 0x64, 0x49, 0x33, 0xb9, 0x90, 0xfd, 0x68, 0xf1, 0xe3, 0xb0, 0x2d, 0xac, + 0x7d, 0x6c, 0x16, 0x23, 0x23, 0x0e, 0x14, 0x68, 0x6f, 0x30, 0xc7, 0xd9, + 0xe7, 0x96, 0xc9, 0x99, 0x4e, 0x19, 0xf1, 0x1c, 0xc0, 0x4a, 0x67, 0xc9, + 0x08, 0xc9, 0xa1, 0x3e, 0xc2, 0x8f, 0x79, 0x12, 0x34, 0x53, 0xa5, 0x58, + 0xb4, 0xe1, 0xd3, 0xb1, 0x47, 0x00, 0xbb, 0x23, 0xa1, 0x67, 0x56, 0xd4, + 0x02, 0x2b, 0xa9, 0xdf, 0x8f, 0x4b, 0x8b, 0x1c, 0x55, 0x8f, 0xdd, 0x5e, + 0xaa, 0x6e, 0xcb, 0x41, 0xd6, 0x86, 0x5e, 0x29, 0x93, 0x14, 0xad, 0x2d, + 0xd4, 0xda, 0xd7, 0x80, 0x50, 0xa7, 0xf0, 0x2d, 0x4c, 0x37, 0x49, 0x4d, + 0x1d, 0xc2, 0x98, 0xf5, 0xd3, 0x67, 0xba, 0xe2, 0x79, 0xfc, 0xf9, 0xc9, + 0x61, 0xf6, 0x91, 0xa8, 0x69, 0xc7, 0x5b, 0x10, 0xda, 0x2c, 0x40, 0xb3, + 0x1a, 0xb2, 0xb1, 0x68, 0x82, 0xba, 0x17, 0x9a, 0xc4, 0xfd, 0xa3, 0x50, + 0x04, 0xbd, 0xfd, 0xdd, 0xa9, 0x37, 0x5a, 0xfa, 0x88, 0x42, 0xbd, 0x77, + 0x7a, 0xa4, 0x52, 0x2f, 0xa3, 0x93, 0x33, 0x88, 0x0e, 0x9b, 0xa3, 0x09, + 0x31, 0x0c, 0xdb, 0x5e, 0xff, 0xe6, 0xd2, 0x1c, 0xa0, 0xbf, 0x3b, 0xb0, + 0xf3, 0x09, 0xec, 0xe4, 0x69, 0x18, 0x0d, 0xaf, 0xae, 0xaa, 0x24, 0xf0, + 0x52, 0x90, 0x4f, 0x7f, 0xe3, 0xe8, 0x94, 0x71, 0x73, 0xd1, 0xa8, 0x73, + 0x4b, 0x5e, 0x2b, 0xfd, 0x01, 0xea, 0x2a, 0xba, 0xe9, 0xde, 0x4a, 0x69, + 0xb3, 0x5a, 0x04, 0xb0, 0xe3, 0xb3, 0xdb, 0x03, 0x32, 0x2d, 0xd3, 0x71, + 0xc1, 0x51, 0x10, 0x4c, 0xba, 0x35, 0xe1, 0x04, 0x75, 0xc3, 0x91, 0x74, + 0xc4, 0x69, 0x78, 0xe4, 0x74, 0x91, 0x34, 0xa5, 0x22, 0xc2, 0x18, 0x91, + 0xc2, 0x79, 0x69, 0xcb, 0x51, 0xa4, 0x70, 0x50, 0xd5, 0x44, 0x27, 0x6c, + 0x50, 0x4a, 0xcc, 0x7a, 0xd8, 0xe9, 0xff, 0xe2, 0x49, 0x0c, 0xb9, 0x61, + 0x43, 0x91, 0xdb, 0x95, 0x94, 0xaa, 0x00, 0x5f, 0x75, 0x5e, 0xf2, 0xa9, + 0x8a, 0x1e, 0x56, 0x65, 0x07, 0x26, 0x41, 0x53, 0xaa, 0x72, 0x1a, 0xf4, + 0xf1, 0xad, 0xd0, 0xd5, 0x24, 0x2e, 0x12, 0xd7, 0xea, 0x0b, 0x11, 0xea, + 0xfa, 0x8f, 0x35, 0x98, 0x21, 0xb4, 0x57, 0x4e, 0x4f, 0xcd, 0x12, 0x8f, + 0x8c, 0xbd, 0x7d, 0x91, 0x70, 0xa5, 0x9f, 0x7b, 0xaa, 0x45, 0xae, 0x3e, + 0xaf, 0x4b, 0xa7, 0x6e, 0x52, 0x88, 0x20, 0x04, 0x04, 0x4f, 0x42, 0xef, + 0x23, 0x35, 0x43, 0x31, 0x07, 0x18, 0xfd, 0xeb, 0x2a, 0x25, 0x0a, 0x08, + 0x80, 0xf7, 0x41, 0x15, 0x03, 0xae, 0xfe, 0x60, 0x36, 0xdf, 0x72, 0x09, + 0x7b, 0x79, 0x83, 0xb1, 0x6e, 0x0e, 0xc8, 0x45, 0xab, 0x18, 0x20, 0x94, + 0xd8, 0x4c, 0x14, 0x6e, 0x16, 0xe3, 0x42, 0x96, 0x5a, 0x3a, 0xa6, 0x87, + 0x40, 0x1a, 0x08, 0xeb, 0xb9, 0x7f, 0xee, 0xde, 0x7d, 0x32, 0x44, 0x4d, + 0x23, 0x57, 0x16, 0x58, 0x65, 0x5e, 0xa6, 0x3d, 0x40, 0x85, 0x19, 0x61, + 0x3b, 0xe0, 0xde, 0x18, 0x63, 0xad, 0x83, 0xd5, 0xd7, 0xea, 0x29, 0x16, + 0xc9, 0x29, 0xf6, 0x4f, 0xcb, 0x07, 0xec, 0x61, 0x6f, 0x8c, 0x2f, 0xf0, + 0x5a, 0x4f, 0x8d, 0x92, 0x56, 0x91, 0xd2, 0x4f, 0x92, 0xe8, 0xa6, 0x55, + 0x69, 0xa1, 0x61, 0x2d, 0x9a, 0xa1, 0xf7, 0xc2, 0x46, 0x70, 0x2d, 0xd5, + 0x0d, 0xe6, 0xab, 0x7f, 0x05, 0x28, 0x40, 0xc3, 0x5b, 0x38, 0x7a, 0xee, + 0x81, 0xc4, 0x38, 0xba, 0xa5, 0xa4, 0xf4, 0x86, 0xa2, 0x29, 0x0d, 0x7a, + 0x53, 0xf5, 0x89, 0x1d, 0x64, 0xb3, 0x02, 0xd6, 0xe0, 0xd8, 0xd8, 0x20, + 0x09, 0x2f, 0x82, 0x0f, 0x40, 0xc3, 0xb9, 0x0f, 0x68, 0xff, 0x4d, 0x8f, + 0x3c, 0x25, 0xa8, 0x8d, 0xd3, 0xd7, 0xce, 0xac, 0x82, 0x5f, 0xea, 0x01, + 0x7b, 0xaf, 0xba, 0x05, 0x5e, 0xec, 0x7a, 0xc3, 0x2c, 0x0b, 0x4e, 0xb7, + 0x13, 0xf5, 0x73, 0x95, 0x53, 0x30, 0xb7, 0x12, 0xb6, 0xed, 0x3f, 0x4a, + 0x4c, 0xd1, 0xd2, 0x2f, 0x25, 0x22, 0x9f, 0xa0, 0xbb, 0x5a, 0x29, 0x4f, + 0xbb, 0x23, 0x73, 0xa1, 0x46, 0x1d, 0xa2, 0x43, 0xae, 0x26, 0xbc, 0xf8, + 0x44, 0xe9, 0xbb, 0x56, 0x9b, 0xb7, 0x4d, 0xb5, 0xb1, 0x18, 0x5a, 0x42, + 0xa6, 0xd9, 0xd6, 0x0d, 0x7b, 0x35, 0xd8, 0xfb, 0xba, 0x1a, 0x68, 0x28, + 0xfa, 0xbe, 0x82, 0x00, 0xeb, 0x95, 0x5c, 0x6b, 0xe2, 0x59, 0x43, 0x5d, + 0x32, 0x58, 0x14, 0xfe, 0x54, 0x75, 0x46, 0xc8, 0x91, 0xc4, 0x4f, 0x65, + 0xfe, 0x6f, 0x9b, 0xda, 0x11, 0x11, 0x4d, 0xd9, 0x03, 0x6e, 0x69, 0xa1, + 0x52, 0x4f, 0xa8, 0xd8, 0xb5, 0xa1, 0xe4, 0xc3, 0xae, 0x39, 0xf7, 0xe9, + 0x7d, 0x92, 0xe8, 0x4f, 0xf0, 0x1a, 0x2b, 0x08, 0x48, 0x96, 0xfa, 0x13, + 0x28, 0xf3, 0xf9, 0x75, 0x7c, 0x84, 0xb0, 0x4c, 0x84, 0xdc, 0xae, 0xcb, + 0x6b, 0x05, 0x71, 0xd7, 0x0e, 0x24, 0xc7, 0x37, 0xda, 0x28, 0xca, 0xaf, + 0x63, 0xad, 0xbf, 0xeb, 0x7d, 0x4e, 0x7b, 0xb7, 0x98, 0x92, 0x6a, 0x54, + 0x5b, 0xee, 0x91, 0xa7, 0x19, 0x10, 0xca, 0xea, 0xf9, 0x10, 0xc6, 0x60, + 0xcb, 0x82, 0x56, 0xa0, 0x7a, 0x03, 0x3a, 0xbc, 0x34, 0x6b, 0x3b, 0x0d, + 0x37, 0x16, 0x49, 0xe2, 0xbd, 0xd5, 0x2a, 0x40, 0x8f, 0x54, 0xcd, 0x7f, + 0xbf, 0xec, 0xad, 0x2c, 0x1b, 0x8f, 0xa9, 0xd4, 0x13, 0x08, 0x11, 0x24, + 0x82, 0xa8, 0xad, 0x1a, 0x5e, 0x2c, 0x11, 0x22, 0x19, 0xb4, 0x3f, 0xb3, + 0x14, 0xcb, 0x26, 0xad, 0xcc, 0x6a, 0xff, 0x5f, 0x61, 0x73, 0xcb, 0xa8, + 0xdf, 0xb2, 0xbe, 0x39, 0x56, 0x81, 0x05, 0x24, 0xa0, 0xf8, 0xcb, 0x6e, + 0xf4, 0xaa, 0x21, 0x98, 0x45, 0xb1, 0xf8, 0x4f, 0x7a, 0x26, 0x3a, 0x30, + 0xf7, 0x42, 0xff, 0x89, 0x25, 0x5a, 0x33, 0xe1, 0x61, 0xa2, 0x71, 0xc0, + 0xa8, 0xd8, 0xb3, 0x49, 0x37, 0x42, 0x70, 0x99, 0x2c, 0x32, 0xd2, 0x87, + 0xd1, 0xee, 0xa1, 0xab, 0x96, 0xe6, 0x12, 0xe1, 0x29, 0x73, 0x05, 0x42, + 0x54, 0xb4, 0xe1, 0x6d, 0x74, 0xe6, 0x41, 0x5a, 0x19, 0x8b, 0xae, 0xdf, + 0xec, 0xdc, 0x5b, 0x6c, 0xb1, 0x28, 0xf0, 0x42, 0xf4, 0xb0, 0x07, 0xd7, + 0xb5, 0xc9, 0xb9, 0xb6, 0x37, 0xb4, 0x0e, 0x40, 0x69, 0x36, 0x81, 0x3b, + 0x44, 0x5f, 0xca, 0x01, 0x73, 0xc2, 0x2e, 0xfb, 0x88, 0xfc, 0x72, 0xba, + 0x8e, 0x4d, 0xb3, 0x0c, 0xf4, 0xab, 0x66, 0x86, 0x43, 0xcd, 0x5a, 0x07, + 0x1f, 0xd8, 0x70, 0x4b, 0xee, 0x70, 0x4a, 0xc5, 0xf3, 0xff, 0x6e, 0x0b, + 0x09, 0xee, 0xa2, 0x98, 0xc8, 0xdc, 0xc2, 0xe9, 0x72, 0xa9, 0xe0, 0xa2, + 0x71, 0x26, 0xb7, 0xe8, 0x14, 0x03, 0x75, 0xc2, 0xa4, 0xfc, 0xa2, 0xa1, + 0xdd, 0x95, 0xa9, 0x14, 0xa4, 0xfa, 0x65, 0x1d, 0x53, 0xf1, 0x90, 0x87, + 0xa8, 0xe1, 0xc1, 0xfa, 0x52, 0xc9, 0x88, 0x1f, 0xd2, 0x1e, 0x3e, 0x2a, + 0x47, 0x5b, 0x48, 0xf4, 0x15, 0xa4, 0x03, 0x87, 0x63, 0x1a, 0x62, 0x12, + 0x06, 0xf0, 0x2d, 0x20, 0x28, 0x82, 0x31, 0x9d, 0x02, 0x86, 0x1e, 0x58, + 0x62, 0x6c, 0x7c, 0x8c, 0xdf, 0xe9, 0x4d, 0xcb, 0xf8, 0xe9, 0xde, 0x37, + 0xa2, 0x88, 0xa3, 0xa0, 0x67, 0x9a, 0xf5, 0x78, 0x66, 0x06, 0x82, 0xf3, + 0x9b, 0x20, 0x86, 0xfb, 0x8f, 0x84, 0x0b, 0x2d, 0x1a, 0xb3, 0x21, 0x2d, + 0x11, 0x54, 0xe6, 0xb5, 0x44, 0xe1, 0x90, 0x9a, 0xbb, 0x2b, 0x5d, 0x96, + 0xdc, 0x24, 0x59, 0xc3, 0xb1, 0xbc, 0x6e, 0x96, 0xe6, 0xd7, 0x6e, 0x09, + 0x1f, 0xc1, 0x26, 0xca, 0x9e, 0x2f, 0x85, 0x10, 0x9a, 0x79, 0xea, 0xce, + 0xd2, 0xbd, 0x0e, 0x92, 0xdb, 0x54, 0x24, 0x91, 0x1d, 0xf5, 0x28, 0x30, + 0xd3, 0x1a, 0x1d, 0x65, 0x8f, 0x2b, 0xa6, 0x56, 0x38, 0xf1, 0xf8, 0x37, + 0xbc, 0x3c, 0xd6, 0x39, 0x98, 0x57, 0x74, 0x49, 0xb0, 0xd4, 0xf9, 0x31, + 0x46, 0xf2, 0xdf, 0x7c, 0x16, 0x43, 0x0c, 0xd2, 0x0b, 0x8f, 0x91, 0xbe, + 0x2a, 0xc6, 0x5c, 0xa1, 0xd5, 0xbd, 0x18, 0x2a, 0x78, 0xec, 0xd8, 0x4d, + 0xc1, 0x48, 0x61, 0xd0, 0x90, 0xb7, 0x8b, 0x6f, 0x46, 0x42, 0x35, 0x48, + 0x59, 0x4c, 0xe1, 0x02, 0xb6, 0x4b, 0x48, 0xcd, 0x63, 0x25, 0x01, 0x10, + 0xd4, 0xb7, 0x13, 0x25, 0x46, 0x45, 0xbb, 0xd6, 0x3b, 0x9e, 0xb5, 0x59, + 0x0e, 0x81, 0x47, 0x07, 0xe2, 0xe9, 0x96, 0x65, 0x9d, 0xc7, 0xe2, 0xeb, + 0xd2, 0x6b, 0xe0, 0xee, 0xfa, 0x91, 0xc9, 0xe6, 0x9a, 0xe2, 0x34, 0x6e, + 0x02, 0x25, 0x03, 0xe2, 0x61, 0xa7, 0x67, 0x51, 0x4e, 0x93, 0x22, 0x00, + 0xdb, 0x58, 0x3c, 0xc4, 0x3b, 0x1a, 0x15, 0x38, 0x17, 0xdd, 0x12, 0x4a, + 0x0d, 0x72, 0x8e, 0x9f, 0x19, 0xa7, 0xd4, 0x1d, 0x70, 0xef, 0x89, 0x68, + 0x60, 0x61, 0xcc, 0xa2, 0x61, 0x12, 0x3f, 0x77, 0x10, 0x5f, 0x3e, 0x94, + 0x2c, 0x52, 0x59, 0xd8, 0xc7, 0x43, 0x83, 0xab, 0xde, 0x6a, 0x5a, 0x72, + 0x8b, 0x5a, 0x13, 0x9d, 0x05, 0x46, 0x85, 0xad, 0x4e, 0x79, 0x5f, 0x7a, + 0xf6, 0xf1, 0x2f, 0x97, 0x1b, 0x13, 0x8f, 0xad, 0xfc, 0xa2, 0xce, 0x75, + 0xc3, 0xe4, 0x0b, 0x14, 0x50, 0x6c, 0x13, 0xa0, 0x42, 0x14, 0x0b, 0x07, + 0xe1, 0x58, 0x24, 0xb9, 0x0c, 0x7f, 0xa9, 0xb3, 0x4e, 0x1d, 0xba, 0x41, + 0xdf, 0xd0, 0x2f, 0x3c, 0x0d, 0x83, 0xce, 0x11, 0x0a, 0x39, 0x2a, 0x94, + 0xd1, 0xd7, 0xc4, 0xb4, 0x89, 0x70, 0xc4, 0xe5, 0xce, 0xbb, 0x8b, 0xdb, + 0xce, 0x41, 0xa1, 0xe6, 0x32, 0x0c, 0xee, 0xbe, 0x40, 0x81, 0xec, 0x17, + 0x57, 0x9f, 0x03, 0x3a, 0x51, 0x83, 0x30, 0x8e, 0x91, 0x62, 0x37, 0x55, + 0x96, 0x24, 0x72, 0xba, 0xe7, 0x24, 0x8d, 0x93, 0x12, 0xb7, 0x34, 0x25, + 0x30, 0x7d, 0xfb, 0xd9, 0x3b, 0x23, 0x6d, 0xe6, 0xd7, 0x4f, 0x68, 0x79, + 0x31, 0x96, 0xab, 0x72, 0xc4, 0x28, 0xfe, 0x67, 0x38, 0x30, 0xde, 0x35, + 0x90, 0xdc, 0xda, 0xbd, 0x2e, 0x4b, 0x2e, 0x60, 0xaf, 0x7a, 0x69, 0x54, + 0xce, 0x29, 0x9d, 0xe0, 0x13, 0x3c, 0x16, 0xcf, 0xfc, 0x36, 0x14, 0x44, + 0x4a, 0x9f, 0x0d, 0x58, 0xa2, 0xdc, 0xea, 0x50, 0x6c, 0x76, 0xb9, 0x91, + 0x39, 0x62, 0x5d, 0x74, 0x06, 0xdb, 0x09, 0xe8, 0x0e, 0x4a, 0x82, 0x08, + 0xac, 0x17, 0x04, 0x38, 0x80, 0x93, 0x6b, 0xff, 0xf8, 0x3d, 0x08, 0x0f, + 0x2b, 0x11, 0x2f, 0x4e, 0x20, 0x00, 0xbf, 0x00, 0x9a, 0x00, 0xef, 0x00, + 0x00, 0x00, 0xe0, 0x00, 0xff, 0x00, 0xfe, 0x00, 0xe6, 0xaa, 0xc3, 0xa7, + 0xe8, 0xba, 0x63, 0x56, 0xc8, 0xd5, 0xbf, 0xf6, 0x1f, 0xb3, 0xfb, 0x7f, + 0x05, 0x85, 0xb5, 0xeb, 0x36, 0x9f, 0xec, 0x77, 0x89, 0x2f, 0x12, 0xf3, + 0xb4, 0x17, 0xe2, 0xd3, 0x9f, 0x23, 0x3e, 0xe2, 0xd1, 0xde, 0x91, 0x67, + 0x32, 0xbc, 0x22, 0xa5, 0x55, 0x6f, 0x42, 0xbe, 0x3d, 0xdc, 0x97, 0x6f, + 0xa8, 0xb5, 0xd3, 0x60, 0xd0, 0x80, 0xee, 0xe8, 0xf2, 0x42, 0xc3, 0x2d, + 0xb4, 0x5c, 0xaa, 0xf5, 0x98, 0x20, 0xda, 0x77, 0x62, 0x63, 0xcb, 0x04, + 0x3a, 0x08, 0xa6, 0x66, 0xc7, 0xae, 0x54, 0x1d, 0xbb, 0xb2, 0xee, 0x33, + 0x4d, 0x51, 0xc7, 0xd3, 0x45, 0x53, 0x3b, 0x8f, 0x62, 0xf2, 0xed, 0x27, + 0x16, 0xc2, 0xce, 0x76, 0x7d, 0x31, 0x01, 0xd5, 0x82, 0x3c, 0xd7, 0x9e, + 0x42, 0x02, 0x90, 0xdb, 0x06, 0x73, 0xd3, 0x13, 0xf0, 0xd6, 0x98, 0x9d, + 0xc9, 0xb2, 0x47, 0xfc, 0x5f, 0x4e, 0xd0, 0x04, 0x47, 0x91, 0xe5, 0xc0, + 0xd0, 0x68, 0x0c, 0x03, 0x95, 0xa4, 0x07, 0x46, 0x9b, 0x53, 0xf2, 0x47, + 0xc5, 0xc3, 0x1f, 0xd2, 0x80, 0x62, 0x9d, 0xc4, 0x81, 0xaa, 0x9d, 0x7d, + 0xb5, 0x33, 0x97, 0x44, 0x61, 0x94, 0xd6, 0xfe, 0x5a, 0xd2, 0x75, 0x7f, + 0x48, 0xfd, 0xe6, 0x16, 0x3f, 0x8d, 0x3e, 0x8e, 0x4a, 0xdc, 0x04, 0xb8, + 0x42, 0xa0, 0x3d, 0x89, 0x88, 0xd5, 0xcf, 0x5b, 0x48, 0x33, 0x11, 0x14, + 0xc4, 0xd9, 0xd3, 0x7a, 0x64, 0xe3, 0x0e, 0x58, 0x34, 0x62, 0xdb, 0x65, + 0x78, 0x70, 0xa7, 0x9e, 0xe0, 0xb8, 0x1b, 0x19, 0xab, 0xf8, 0xae, 0xeb, + 0x10, 0x08, 0x35, 0x3b, 0xcb, 0x83, 0x3a, 0x17, 0x10, 0xfb, 0xec, 0x1c, + 0x5c, 0x58, 0x04, 0x28, 0x8b, 0xdd, 0xe4, 0x95, 0x92, 0xbe, 0x96, 0xab, + 0x42, 0x57, 0xb5, 0x4e, 0xf9, 0xd1, 0x4f, 0xea, 0x61, 0x7f, 0xf9, 0xcc, + 0x45, 0x40, 0x2a, 0x14, 0xe8, 0xea, 0x51, 0x4a, 0xef, 0xba, 0xb0, 0x58, + 0xee, 0x5e, 0x0c, 0x08, 0x09, 0x5f, 0x15, 0x19, 0x00, 0xdb, 0xea, 0x40, + 0x81, 0xb2, 0xec, 0x61, 0x98, 0x46, 0x18, 0x0f, 0x06, 0x57, 0x2f, 0xca, + 0x8f, 0xea, 0x97, 0x41, 0x4a, 0x1a, 0xea, 0xd9, 0x29, 0x95, 0x53, 0xb8, + 0x90, 0xf9, 0xab, 0x20, 0xbb, 0x4a, 0x2b, 0xc6, 0x40, 0xe0, 0xfc, 0x80, + 0xd1, 0x58, 0xf1, 0x88, 0x1f, 0x9a, 0x88, 0x9b, 0x3d, 0xa7, 0x0d, 0x0b, + 0x8c, 0xed, 0x4c, 0xa7, 0xb2, 0x89, 0x88, 0xa6, 0x1a, 0x91, 0x3b, 0x7d, + 0x42, 0x0c, 0x4f, 0x65, 0x51, 0x3d, 0x8e, 0xa4, 0xa6, 0x64, 0xab, 0xaf, + 0x31, 0x26, 0xff, 0x3b, 0xfc, 0xc1, 0x19, 0xc9, 0xf0, 0x64, 0x60, 0x94, + 0x89, 0x67, 0xb7, 0x75, 0xcb, 0x44, 0xfa, 0x05, 0xe1, 0x62, 0x25, 0x31, + 0x65, 0x8a, 0x19, 0x49, 0xac, 0x21, 0xc5, 0xb4, 0x86, 0x26, 0x92, 0xfa, + 0x94, 0xb5, 0xa7, 0x4a, 0x38, 0x0a, 0x4e, 0x1a, 0x9a, 0x5a, 0x30, 0xd5, + 0x1f, 0xff, 0x28, 0xf9, 0x50, 0xdd, 0xe4, 0x72, 0x7f, 0x96, 0x23, 0x2b, + 0x86, 0x50, 0x00, 0xdb, 0x48, 0x57, 0x14, 0x6e, 0xf8, 0xba, 0xd1, 0xef, + 0x81, 0xe1, 0x10, 0xfc, 0x26, 0xa0, 0xaa, 0xbf, 0x2a, 0x12, 0x08, 0x6e, + 0x77, 0xca, 0x7d, 0xf4, 0xdd, 0x26, 0x7e, 0x20, 0xbe, 0x53, 0x6c, 0x69, + 0xa8, 0xcb, 0x48, 0xf9, 0x1a, 0xbd, 0x0b, 0x27, 0xb8, 0xce, 0x3c, 0xe2, + 0xbd, 0xf2, 0x46, 0x86, 0xbd, 0x6b, 0xb9, 0x6e, 0x1b, 0x87, 0x3f, 0x38, + 0xc9, 0x14, 0x2a, 0x15, 0xfd, 0x69, 0xa9, 0x1c, 0x04, 0x48, 0xcb, 0xb4, + 0x58, 0x0a, 0x6b, 0x7d, 0xda, 0xfd, 0xfd, 0x96, 0x27, 0x4b, 0x07, 0xbd, + 0xd3, 0xb1, 0x77, 0x88, 0x4b, 0xae, 0xba, 0xe7, 0x8b, 0xc3, 0xa6, 0xc4, + 0xf7, 0x0c, 0x08, 0xff, 0x10, 0xbe, 0x0f, 0x71, 0x59, 0x4a, 0xef, 0xc6, + 0x8e, 0xd3, 0x5c, 0xfb, 0xb4, 0x1b, 0x6e, 0x34, 0xda, 0x95, 0x46, 0xb0, + 0xbd, 0x77, 0x0d, 0xd4, 0x4e, 0x9a, 0x2b, 0xc8, 0xb9, 0x45, 0xb6, 0xc6, + 0x69, 0xca, 0x23, 0x77, 0xf9, 0x91, 0x3c, 0x22, 0x75, 0xc1, 0xff, 0x50, + 0x6c, 0xb4, 0x66, 0xa8, 0xc3, 0xb1, 0xe6, 0x60, 0x41, 0xa4, 0x15, 0xe0, + 0xaf, 0x07, 0x02, 0x38, 0x73, 0xbe, 0x1b, 0xe1, 0x14, 0xed, 0xf9, 0x10, + 0xd2, 0xe8, 0xa3, 0xc2, 0xa8, 0x04, 0x22, 0xd0, 0x2b, 0x8b, 0xdf, 0xbc, + 0xe7, 0xb1, 0xbf, 0x53, 0x20, 0x61, 0x08, 0xb7, 0xce, 0xba, 0x38, 0x87, + 0xea, 0xc5, 0x73, 0x64, 0x40, 0x3c, 0x9a, 0x42, 0xc3, 0x5e, 0x9b, 0xe5, + 0x64, 0xa7, 0xc8, 0xef, 0x7f, 0x25, 0xe9, 0xc6, 0x06, 0xaf, 0x33, 0x2b, + 0xde, 0x22, 0xd7, 0x0b, 0x45, 0xd2, 0x1a, 0xb7, 0x99, 0x35, 0x74, 0x7f, + 0x32, 0xb0, 0x9f, 0xc9, 0x47, 0x3f, 0xdf, 0xf5, 0xc0, 0xc2, 0x4a, 0xb2, + 0x09, 0x87, 0x05, 0xe3, 0x45, 0x52, 0xa5, 0xb0, 0xba, 0xeb, 0x7a, 0x8d, + 0x80, 0x20, 0x9b, 0x9c, 0xe7, 0x30, 0x39, 0x95, 0x17, 0xd4, 0xf2, 0x90, + 0x5e, 0xf5, 0x7e, 0xe3, 0x14, 0xb4, 0xa5, 0xa5, 0x5e, 0x7e, 0xb1, 0xbf, + 0x7f, 0x38, 0xb4, 0xc4, 0x66, 0x83, 0xe5, 0x21, 0xf7, 0x53, 0x19, 0xe0, + 0x4f, 0xa3, 0x86, 0x2b, 0xd6, 0x14, 0x43, 0x04, 0x12, 0x1f, 0xcb, 0x89, + 0x8d, 0xa8, 0x57, 0xa7, 0xd1, 0x23, 0xa5, 0x73, 0x5b, 0x92, 0x40, 0xca, + 0x44, 0x42, 0xcf, 0xb8, 0xc6, 0xa3, 0xf6, 0x34, 0x58, 0xe6, 0x70, 0xe7, + 0x3f, 0x50, 0xc4, 0x16, 0x4f, 0x17, 0x12, 0xaf, 0xc7, 0x9e, 0xa1, 0x75, + 0xc5, 0x2b, 0x72, 0x33, 0x54, 0x8d, 0x5f, 0xb2, 0x61, 0x9c, 0xa8, 0xf1, + 0x2a, 0xa6, 0xc4, 0xab, 0x2d, 0xc0, 0xbf, 0x8e, 0xc9, 0x2f, 0x0b, 0x70, + 0x49, 0x5f, 0x68, 0xc5, 0x13, 0x9c, 0xf6, 0x45, 0x5f, 0xa3, 0x73, 0xba, + 0x10, 0x2b, 0x64, 0xd8, 0x7a, 0xe4, 0xd9, 0xc6, 0x6a, 0xce, 0xf7, 0xb3, + 0x84, 0x92, 0x55, 0xa5, 0x6d, 0x48, 0xcc, 0x62, 0x8e, 0xa9, 0x41, 0x58, + 0x39, 0xbd, 0xcc, 0xee, 0xb9, 0x15, 0x72, 0xe9, 0xf0, 0x5f, 0xc3, 0xf8, + 0x08, 0x71, 0x52, 0x4e, 0x60, 0x11, 0x88, 0xbe, 0xbc, 0x30, 0x8e, 0xa9, + 0x78, 0xf0, 0x20, 0xc2, 0x0c, 0x23, 0x8b, 0x6d, 0x12, 0x7e, 0x5f, 0x30, + 0x42, 0x9c, 0x2f, 0x6c, 0xdb, 0x05, 0x96, 0x44, 0xb7, 0x7c, 0xbd, 0x32, + 0x01, 0xae, 0x3b, 0xa8, 0x0a, 0xfc, 0x8b, 0xf7, 0x0e, 0xed, 0x0b, 0x8e, + 0xa2, 0x9b, 0x05, 0xe4, 0xb2, 0xd3, 0xbe, 0x12, 0x87, 0x81, 0x90, 0xde, + 0x6b, 0x85, 0x88, 0xa3, 0xcf, 0xea, 0xb5, 0x33, 0xd4, 0xd0, 0xca, 0x27, + 0xa4, 0x40, 0x23, 0x3c, 0xe2, 0x25, 0x9f, 0xec, 0x75, 0x7f, 0xd4, 0x63, + 0x0c, 0xfc, 0x25, 0x13, 0x1e, 0x7b, 0x19, 0xe2, 0xda, 0xa1, 0x29, 0xe4, + 0x7f, 0x27, 0x02, 0x0f, 0x67, 0xa2, 0xfc, 0xa6, 0xbe, 0x6a, 0x15, 0x3f, + 0xc5, 0x39, 0xec, 0x52, 0x8f, 0x55, 0x3b, 0x76, 0x9f, 0x03, 0x51, 0xcb, + 0xb8, 0x65, 0x0f, 0x4e, 0x57, 0x2e, 0x5a, 0x9a, 0x36, 0xb5, 0xa9, 0xbf, + 0xca, 0x0f, 0x06, 0x39, 0x79, 0xdb, 0x1d, 0x94, 0x61, 0x31, 0x27, 0x4b, + 0x09, 0x59, 0xdb, 0x83, 0xf9, 0x32, 0xb4, 0x5b, 0x05, 0x89, 0x89, 0x13, + 0xb0, 0x14, 0x3f, 0x03, 0x39, 0x22, 0x05, 0x43, 0x9e, 0x45, 0xb7, 0x70, + 0x90, 0x3a, 0xe1, 0x7f, 0xe6, 0x57, 0x59, 0x59, 0x5b, 0x9a, 0xb5, 0x6d, + 0xd7, 0x96, 0xdf, 0x63, 0x7c, 0x69, 0x3a, 0xc4, 0x2b, 0x15, 0xb2, 0x09, + 0xb7, 0x72, 0x1b, 0x11, 0x65, 0xad, 0xaf, 0x7f, 0x52, 0x37, 0xa4, 0x45, + 0xbb, 0xa2, 0x8e, 0xb1, 0x15, 0x81, 0x57, 0x5b, 0xfe, 0x6b, 0x1e, 0xb2, + 0x05, 0x1d, 0x15, 0xf4, 0x5b, 0x10, 0x80, 0xfb, 0x40, 0xdf, 0x50, 0x7f, + 0x16, 0x94, 0xaa, 0x02, 0xe4, 0xda, 0xab, 0x6f, 0x34, 0xb8, 0xd8, 0x28, + 0x1d, 0x77, 0xfe, 0x6b, 0x83, 0xc1, 0x41, 0x14, 0x1b, 0xca, 0x63, 0xd9, + 0xbb, 0xe6, 0x71, 0x02, 0xb3, 0x57, 0x74, 0x65, 0xf2, 0x70, 0xed, 0x7b, + 0x19, 0x3a, 0xc7, 0x86, 0x06, 0xe3, 0x62, 0x4e, 0xcf, 0xab, 0x08, 0x50, + 0x66, 0x39, 0x35, 0xda, 0x84, 0x0a, 0xee, 0xcd, 0x96, 0x0b, 0x7a, 0x12, + 0x7b, 0xb4, 0x3b, 0x85, 0x10, 0x7f, 0x2f, 0x40, 0x26, 0x52, 0xcb, 0x00, + 0x2e, 0x9c, 0x0c, 0x4d, 0x00, 0xbd, 0x26, 0xb3, 0x0f, 0xaf, 0x6a, 0x51, + 0xce, 0x99, 0x6e, 0x06, 0x61, 0x85, 0x95, 0x6e, 0x16, 0xb5, 0xdc, 0xd0, + 0x01, 0xc2, 0xfa, 0x74, 0x77, 0x80, 0xdd, 0xe7, 0x57, 0x84, 0x8f, 0xdf, + 0x18, 0x29, 0x84, 0xc3, 0x81, 0x9e, 0xa4, 0xfb, 0x08, 0xd9, 0xcc, 0x10, + 0x90, 0x54, 0x67, 0x8b, 0x96, 0x23, 0xc1, 0xb6, 0x01, 0xba, 0x76, 0xab, + 0xbf, 0x41, 0x62, 0xcf, 0x18, 0x40, 0x52, 0x52, 0x76, 0xb5, 0x57, 0x50, + 0x74, 0x54, 0x72, 0x8d, 0x32, 0xfc, 0xdd, 0x5c, 0xa7, 0xb5, 0xa6, 0x36, + 0x37, 0xa9, 0xa2, 0xa3, 0x84, 0xd1, 0x93, 0x70, 0x52, 0x48, 0xd9, 0x90, + 0x4e, 0x50, 0x09, 0x39, 0xb2, 0x46, 0xc6, 0x37, 0xf5, 0x70, 0x42, 0xb6, + 0x8a, 0xfd, 0x5d, 0x49, 0xaa, 0x93, 0x99, 0x5a, 0x4d, 0x26, 0xc7, 0x4c, + 0x4b, 0xb1, 0x63, 0x4b, 0xa6, 0xf8, 0x8a, 0xc7, 0x53, 0x62, 0xc4, 0xef, + 0x75, 0xe1, 0x9e, 0x0a, 0xd9, 0x4d, 0xa5, 0x9b, 0x50, 0x67, 0x30, 0x1f, + 0x68, 0xe2, 0x10, 0x42, 0xab, 0x77, 0x4d, 0x44, 0x2c, 0xc0, 0x36, 0x4c, + 0xb6, 0x8d, 0x04, 0x1e, 0xca, 0x27, 0xf7, 0x3a, 0x44, 0xc1, 0x29, 0x14, + 0xcc, 0x00, 0x5b, 0x4f, 0x6c, 0xd4, 0x74, 0x49, 0xba, 0x9d, 0xa5, 0xc5, + 0xdd, 0x8a, 0xb1, 0xc8, 0x27, 0xd2, 0xb5, 0x94, 0xb0, 0xaa, 0x81, 0x40, + 0x1b, 0x7e, 0xd5, 0xea, 0xad, 0xaf, 0xde, 0x5b, 0x26, 0x0d, 0xc6, 0x65, + 0x44, 0x7b, 0xb5, 0x09, 0x31, 0xe2, 0x97, 0xaa, 0xc3, 0xa9, 0x94, 0x03, + 0x42, 0x4e, 0x6a, 0x49, 0xa6, 0x81, 0x23, 0xff, 0x68, 0x68, 0xe4, 0x8d, + 0xad, 0x83, 0x89, 0x4a, 0x5d, 0x78, 0x7e, 0xe2, 0x20, 0x37, 0x34, 0xa6, + 0x5b, 0x68, 0x16, 0x67, 0x0e, 0xf8, 0xbd, 0x86, 0x9d, 0x19, 0x48, 0x7c, + 0x8f, 0x32, 0xd3, 0x6a, 0x20, 0x71, 0x32, 0x2e, 0x8c, 0xce, 0x96, 0x2d, + 0x24, 0x8c, 0x8e, 0x4a, 0xdd, 0xa2, 0x85, 0x2e, 0x52, 0x66, 0x99, 0xba, + 0xd2, 0xf2, 0x54, 0x51, 0x4b, 0xf0, 0xb1, 0xf0, 0xf7, 0xd0, 0x8a, 0xbe, + 0x07, 0x5d, 0x27, 0x1d, 0x25, 0xfc, 0x56, 0xaf, 0xdc, 0x3c, 0x10, 0x96, + 0xf4, 0x1b, 0xfd, 0x46, 0x3c, 0x88, 0x4b, 0xbc, 0x1a, 0x1b, 0x89, 0x43, + 0x14, 0x8a, 0x2b, 0x3c, 0x67, 0x8e, 0x9e, 0xfb, 0xc1, 0xfe, 0xdf, 0xb9, + 0x46, 0xf0, 0xe6, 0xd7, 0x40, 0xb0, 0x3e, 0x96, 0x10, 0x99, 0x3c, 0x08, + 0x13, 0x73, 0x41, 0x3d, 0x65, 0xaa, 0x73, 0x8e, 0xc3, 0x2d, 0x14, 0x61, + 0xd3, 0x93, 0xc5, 0x48, 0x13, 0xaa, 0x5f, 0xc4, 0x94, 0x24, 0x52, 0x99, + 0xfa, 0xd7, 0x93, 0xa8, 0x49, 0x70, 0xa0, 0x01, 0x7a, 0xc1, 0x47, 0xa8, + 0x35, 0x7a, 0xb4, 0x3f, 0xf9, 0xda, 0xc9, 0x48, 0xc4, 0x79, 0x0e, 0x24, + 0xfc, 0x8e, 0x39, 0x8a, 0x2d, 0xbe, 0x4b, 0x31, 0xf3, 0x22, 0xa4, 0xc1, + 0xd8, 0xc5, 0xa8, 0x19, 0x24, 0x57, 0x82, 0x29, 0xa8, 0xa9, 0x3d, 0xa6, + 0xfa, 0x1f, 0xce, 0xa6, 0x94, 0x12, 0xac, 0xb5, 0x01, 0x18, 0xed, 0x89, + 0x95, 0x9f, 0x2e, 0x0a, 0x02, 0x65, 0x00, 0x93, 0x61, 0xf4, 0x86, 0x1d, + 0x34, 0xf7, 0xce, 0xb5, 0x22, 0x93, 0x90, 0x9b, 0x32, 0x7d, 0xf0, 0x99, + 0x00, 0x0b, 0xf6, 0x7c, 0x69, 0x95, 0x1f, 0xc2, 0xb7, 0x8f, 0x08, 0x10, + 0x1e, 0x23, 0x83, 0x82, 0xc3, 0x03, 0x85, 0x3c, 0xc8, 0x2e, 0x20, 0x0f, + 0x26, 0x5f, 0xab, 0xf0, 0x51, 0xb7, 0x89, 0x51, 0x94, 0x5d, 0xdd, 0x5d, + 0xa7, 0x29, 0xb9, 0xf9, 0x08, 0x84, 0xf0, 0x04, 0x75, 0x78, 0xca, 0x8b, + 0x9a, 0x89, 0xbe, 0x31, 0x31, 0x8d, 0x40, 0x52, 0xc7, 0x45, 0x1e, 0xa0, + 0x7d, 0x70, 0xdc, 0x89, 0x9a, 0xe3, 0x94, 0x14, 0xe3, 0xc4, 0x77, 0x12, + 0x83, 0x0f, 0x2a, 0xe6, 0x7a, 0x3d, 0x13, 0xa7, 0x9c, 0xe3, 0xd7, 0xca, + 0x2d, 0xf5, 0x27, 0x6d, 0x23, 0xc6, 0xec, 0xc9, 0xc1, 0x1c, 0x1b, 0x05, + 0x96, 0xfb, 0xab, 0x28, 0x3c, 0x7d, 0xc3, 0xd3, 0x70, 0xad, 0xf4, 0x5c, + 0x48, 0xf9, 0xac, 0x84, 0xd6, 0x66, 0x00, 0x15, 0x84, 0x5a, 0x43, 0xed, + 0xfc, 0xae, 0xde, 0x85, 0x2a, 0xec, 0x95, 0xaf, 0xc4, 0x90, 0x30, 0xf7, + 0x46, 0xfc, 0x69, 0x9a, 0xbe, 0x69, 0x34, 0x50, 0x17, 0xd0, 0x9a, 0xf9, + 0x34, 0xce, 0x07, 0x71, 0x0a, 0x98, 0x0e, 0x96, 0x04, 0xaa, 0x04, 0x6f, + 0x5c, 0xb2, 0x20, 0x9c, 0x39, 0x0b, 0xf6, 0xf9, 0x60, 0xa0, 0x90, 0xb9, + 0x78, 0xbd, 0xa1, 0xd1, 0x3e, 0x14, 0xc4, 0xa1, 0x69, 0x72, 0x45, 0xe7, + 0xff, 0xf0, 0x49, 0xaa, 0x12, 0xcd, 0x7a, 0x4d, 0x68, 0x33, 0x9c, 0x92, + 0x54, 0x67, 0x1c, 0x62, 0x53, 0x09, 0x55, 0xa9, 0xc0, 0x4f, 0xaf, 0x0d, + 0x14, 0xc5, 0x24, 0x73, 0xeb, 0xfb, 0xc9, 0xd5, 0x92, 0x5d, 0x1c, 0xa3, + 0xde, 0x69, 0xd8, 0xf3, 0x18, 0xb7, 0x2a, 0x8c, 0x50, 0xde, 0xd1, 0x0e, + 0xef, 0x63, 0x7a, 0xdb, 0x99, 0x47, 0xe9, 0x2c, 0xd1, 0x7f, 0xda, 0xa1, + 0x85, 0x59, 0x70, 0xf4, 0xef, 0x7e, 0x2a, 0xea, 0xbe, 0x6e, 0xf2, 0x22, + 0xa1, 0x27, 0x82, 0x32, 0xed, 0x9f, 0x45, 0xd4, 0x85, 0x9f, 0x93, 0x02, + 0x83, 0x36, 0xe8, 0x47, 0x82, 0xd3, 0xe3, 0x98, 0x26, 0xe9, 0x43, 0x2a, + 0x8f, 0x98, 0xa4, 0x69, 0x30, 0x24, 0x18, 0xa8, 0x81, 0x64, 0xcf, 0xd8, + 0x22, 0x61, 0xaa, 0xc6, 0x22, 0x4b, 0xbe, 0x78, 0xf4, 0x72, 0xf3, 0xdb, + 0xde, 0x77, 0xc7, 0x2e, 0x93, 0x8c, 0x03, 0xba, 0xa2, 0xd8, 0x2b, 0xe2, + 0xa8, 0x0b, 0x2a, 0xf4, 0xd0, 0x61, 0x1a, 0x00, 0x2b, 0x99, 0xfa, 0x13, + 0x40, 0xb6, 0x82, 0x78, 0x16, 0x84, 0x72, 0x7d, 0x5c, 0x4d, 0xd3, 0x36, + 0x8c, 0xfd, 0xf3, 0xdc, 0x59, 0xf8, 0xe7, 0x48, 0x30, 0x78, 0x7e, 0xab, + 0x01, 0x84, 0x98, 0x53, 0xf0, 0xa8, 0x6c, 0x2e, 0x55, 0xa4, 0x49, 0x09, + 0x41, 0x6e, 0x82, 0x51, 0x1d, 0xc4, 0xf8, 0x00, 0x32, 0xc2, 0xff, 0xf8, + 0x3d, 0x08, 0x10, 0x2b, 0x11, 0xca, 0x4a, 0x15, 0x00, 0x1c, 0x00, 0x0e, + 0x00, 0x0e, 0x00, 0x16, 0x00, 0x10, 0x00, 0xe6, 0xb6, 0x0d, 0x8e, 0xfe, + 0xea, 0xf2, 0xc2, 0xc0, 0xea, 0xaf, 0x3e, 0x80, 0x67, 0x4e, 0xab, 0x51, + 0x58, 0xb9, 0xba, 0xa3, 0xb0, 0x8e, 0x8e, 0xc1, 0xbf, 0xa7, 0x9e, 0x0e, + 0xcf, 0xc0, 0x7e, 0x19, 0x0d, 0x46, 0xca, 0x09, 0x63, 0xff, 0x70, 0x3b, + 0xa2, 0xb6, 0x82, 0x6f, 0xff, 0xb9, 0xff, 0x8a, 0x88, 0xcf, 0x1b, 0xac, + 0xe1, 0xf0, 0x7b, 0x72, 0xd6, 0x6e, 0x85, 0x91, 0x05, 0xa0, 0xaa, 0x90, + 0x8a, 0x9e, 0xfd, 0xf1, 0x4e, 0xb5, 0x09, 0xbc, 0x50, 0x87, 0x9b, 0x0d, + 0x09, 0x7d, 0xa0, 0xe8, 0x95, 0xf6, 0xc0, 0x65, 0x8c, 0x93, 0x86, 0x6e, + 0x51, 0xa0, 0x48, 0xa4, 0x51, 0x72, 0x1a, 0x87, 0x6c, 0xc2, 0x1b, 0xe0, + 0x38, 0x10, 0x42, 0x3f, 0x17, 0xcc, 0x84, 0x9d, 0xec, 0x05, 0x09, 0x50, + 0xdc, 0x54, 0xa2, 0xe3, 0x79, 0x6a, 0x4d, 0xe8, 0x81, 0x68, 0xbd, 0x0b, + 0xb7, 0x4f, 0x47, 0x2e, 0x56, 0xc6, 0x2e, 0x3c, 0x98, 0x33, 0xe3, 0xe0, + 0xe3, 0xc8, 0xa9, 0x80, 0x88, 0xb9, 0xd6, 0x22, 0x22, 0x79, 0x51, 0xf5, + 0xbf, 0x03, 0xb7, 0x29, 0xc4, 0x0e, 0xe8, 0xaf, 0x25, 0xc3, 0x09, 0xc3, + 0x4d, 0x1d, 0x53, 0xe6, 0x58, 0x9f, 0x74, 0x61, 0xe4, 0xaf, 0x92, 0xd3, + 0xed, 0xe3, 0x48, 0x07, 0x6f, 0x92, 0x43, 0x84, 0xb4, 0x54, 0x19, 0x1b, + 0x61, 0xad, 0x57, 0x65, 0xdc, 0xff, 0x1e, 0xb7, 0xfc, 0x76, 0x9d, 0x57, + 0x50, 0x8e, 0xc3, 0x09, 0xd1, 0xd0, 0x83, 0xb6, 0xb4, 0x54, 0xe8, 0xbd, + 0x78, 0xab, 0x29, 0x6b, 0x69, 0x6d, 0xad, 0xbd, 0x4d, 0x69, 0xc7, 0x74, + 0x61, 0x42, 0xaa, 0xc3, 0x5a, 0x93, 0x5b, 0x56, 0x4a, 0xb9, 0xa4, 0x7c, + 0xf2, 0x89, 0xb4, 0xa4, 0x39, 0x3a, 0xbc, 0x54, 0x50, 0x16, 0x05, 0x08, + 0x43, 0xef, 0x10, 0x05, 0x6e, 0x9e, 0x09, 0x6b, 0x47, 0xec, 0xdc, 0x94, + 0x0c, 0x52, 0xa0, 0x35, 0x37, 0x31, 0x22, 0xa2, 0xd0, 0x63, 0xed, 0xc0, + 0xa6, 0xeb, 0x5f, 0x28, 0x72, 0x34, 0x9c, 0xe9, 0x4a, 0xe6, 0xee, 0x3b, + 0x1f, 0x5d, 0x3d, 0xe2, 0x4a, 0xfe, 0xc3, 0x99, 0x19, 0x2b, 0x5c, 0x8c, + 0x29, 0x6a, 0x74, 0x6d, 0xfc, 0xa9, 0x7b, 0x66, 0x28, 0x8c, 0xf3, 0x17, + 0x80, 0xc3, 0xf4, 0x58, 0x6f, 0xbe, 0xbe, 0x40, 0xe9, 0x81, 0x64, 0x48, + 0x74, 0xe3, 0x12, 0xc1, 0xf3, 0x2b, 0x54, 0xc5, 0xfc, 0xc5, 0xc2, 0xea, + 0xd5, 0xd3, 0xb1, 0xaa, 0x31, 0x9c, 0x96, 0xac, 0x8a, 0xbc, 0xaa, 0x3c, + 0xaf, 0x0d, 0xba, 0x5b, 0x0b, 0x6a, 0x76, 0x73, 0x65, 0x27, 0x2e, 0xe4, + 0x56, 0xeb, 0x0a, 0x29, 0x6c, 0xcf, 0x41, 0x4c, 0x84, 0x4a, 0x17, 0x5a, + 0x65, 0x03, 0x53, 0x73, 0xaa, 0xe0, 0xaf, 0x1b, 0x39, 0xa1, 0x4c, 0x5e, + 0x68, 0x5f, 0x7a, 0x86, 0x54, 0x5e, 0xc9, 0x50, 0xdd, 0x00, 0x42, 0xbc, + 0x1c, 0x23, 0xd0, 0xa0, 0x10, 0x3e, 0xfa, 0x41, 0x1c, 0x51, 0x0c, 0xab, + 0x50, 0x9c, 0x57, 0xb8, 0x55, 0x0e, 0x5c, 0x0a, 0xf3, 0x69, 0xeb, 0x63, + 0x42, 0x61, 0x33, 0x5a, 0x01, 0x49, 0xf9, 0x86, 0xb6, 0x48, 0x66, 0x88, + 0xd3, 0x68, 0xad, 0x5a, 0x9a, 0xe3, 0x24, 0xf4, 0x95, 0xe9, 0x93, 0x1a, + 0x5c, 0x61, 0xac, 0x7f, 0xc0, 0x23, 0x05, 0xeb, 0xa7, 0xab, 0x98, 0xf6, + 0x2f, 0xdc, 0x53, 0x69, 0x50, 0xc7, 0xdb, 0x5c, 0xfa, 0x46, 0x43, 0xf7, + 0x92, 0x03, 0x4f, 0x4b, 0xc6, 0xb8, 0x33, 0x5d, 0x25, 0x15, 0xb5, 0xb1, + 0xda, 0x79, 0x5f, 0xf9, 0xcd, 0xdc, 0x6b, 0xe9, 0xf6, 0x66, 0xb9, 0x29, + 0x8a, 0x04, 0x0c, 0xb3, 0x78, 0xd4, 0x65, 0x09, 0x91, 0xa4, 0x23, 0x2e, + 0x8e, 0x94, 0x61, 0x36, 0x21, 0x01, 0x4b, 0x96, 0x41, 0xc6, 0x24, 0x3b, + 0x67, 0xb6, 0xe4, 0x9c, 0x69, 0x08, 0x92, 0x15, 0x81, 0xaf, 0xc3, 0x87, + 0x44, 0x1d, 0xa9, 0xc6, 0x7b, 0x50, 0x58, 0xd0, 0x49, 0x34, 0x1e, 0x15, + 0xe0, 0x38, 0x0a, 0x67, 0x55, 0x65, 0x23, 0xb2, 0x4c, 0xc9, 0x17, 0x1a, + 0x75, 0xb5, 0x5a, 0x75, 0xf6, 0xe7, 0xad, 0x28, 0x8a, 0x77, 0x94, 0x81, + 0x16, 0x5e, 0xe8, 0xb9, 0x0e, 0x93, 0xe8, 0x76, 0x1c, 0x41, 0x20, 0xce, + 0x59, 0xb4, 0x41, 0xd4, 0x37, 0x6e, 0x42, 0xf9, 0xfc, 0xfa, 0x7d, 0x52, + 0x57, 0x6d, 0x21, 0x3f, 0x70, 0xf6, 0x05, 0x55, 0xfd, 0xdb, 0x73, 0x86, + 0x80, 0x84, 0xe7, 0x8d, 0x1f, 0x55, 0xeb, 0x59, 0x65, 0x18, 0x99, 0x67, + 0x60, 0x96, 0xe7, 0x7d, 0x2c, 0x4d, 0xb3, 0x8f, 0x48, 0xc4, 0xa2, 0x77, + 0x7e, 0x59, 0x3b, 0x86, 0x9e, 0x74, 0x55, 0xd3, 0xe1, 0x19, 0x67, 0x7b, + 0x88, 0x6e, 0xdb, 0x91, 0x82, 0xb2, 0x42, 0x63, 0x41, 0x44, 0x12, 0xcd, + 0xab, 0x3d, 0x0c, 0x30, 0xd3, 0x6f, 0x82, 0x4a, 0x34, 0xd1, 0x23, 0xf4, + 0xb8, 0xb9, 0x51, 0xc5, 0x0d, 0x31, 0x5b, 0xb5, 0x69, 0x3e, 0xa0, 0x46, + 0xce, 0x62, 0xe3, 0x15, 0x10, 0x71, 0x58, 0x8b, 0x90, 0xc3, 0x10, 0xba, + 0xe8, 0x07, 0x58, 0xca, 0x87, 0x17, 0xb0, 0x27, 0xb4, 0xb5, 0xf8, 0x2a, + 0x0d, 0x10, 0x47, 0xe8, 0xcf, 0x31, 0x90, 0x33, 0x7d, 0x65, 0x9f, 0x60, + 0xaf, 0xb4, 0x6d, 0x5a, 0x85, 0x5c, 0xe5, 0x2d, 0xd0, 0xb4, 0xf8, 0x62, + 0x5e, 0xfb, 0xc5, 0x38, 0x41, 0x6f, 0x61, 0xdf, 0x79, 0xb9, 0x04, 0x7c, + 0xe1, 0xe1, 0x16, 0xd7, 0x42, 0xd0, 0x4e, 0x0e, 0x55, 0x19, 0x7e, 0x2e, + 0x4c, 0xb7, 0xfd, 0x22, 0xed, 0xc6, 0x42, 0x32, 0x35, 0xc8, 0x23, 0x68, + 0x50, 0x34, 0x1d, 0xb3, 0x1d, 0xb7, 0x82, 0x86, 0xad, 0xa0, 0x0b, 0x06, + 0x9a, 0xa2, 0xba, 0x2a, 0xeb, 0x0e, 0x5c, 0x46, 0x5c, 0x87, 0x48, 0xbb, + 0x8d, 0x80, 0x54, 0x52, 0x18, 0xe4, 0xce, 0x18, 0x81, 0x46, 0xcd, 0x7a, + 0xa2, 0x64, 0xe7, 0xda, 0x2b, 0x4f, 0xa9, 0x34, 0xc8, 0x34, 0xa3, 0xf6, + 0x65, 0x64, 0x7d, 0x9d, 0xda, 0x4d, 0x47, 0xb5, 0x99, 0x8c, 0x3a, 0x72, + 0xf8, 0xb8, 0xd5, 0xce, 0x64, 0x71, 0x84, 0x78, 0xdc, 0xd7, 0x2c, 0x37, + 0x7c, 0xf7, 0x20, 0xd7, 0xe8, 0xf0, 0x2c, 0xe3, 0xc6, 0x8f, 0x04, 0x98, + 0xe5, 0x30, 0x20, 0x44, 0x32, 0x20, 0xd7, 0x1a, 0x5b, 0x39, 0x84, 0x0c, + 0x37, 0xa8, 0xdc, 0x84, 0xb3, 0x2c, 0x33, 0x31, 0xbc, 0xf4, 0x67, 0x04, + 0x86, 0x42, 0xc5, 0xa7, 0x11, 0x59, 0xeb, 0xc4, 0x41, 0x13, 0xf8, 0xed, + 0x27, 0x21, 0x59, 0xc4, 0x0a, 0x07, 0x22, 0xd7, 0xce, 0x6f, 0xf1, 0xec, + 0x42, 0xfd, 0x98, 0xc2, 0x5a, 0x10, 0x88, 0x16, 0x1e, 0x0a, 0x43, 0xcd, + 0x59, 0x7c, 0x91, 0x28, 0x68, 0xe9, 0xa4, 0x6f, 0x36, 0x06, 0xa8, 0x1d, + 0xa7, 0xe1, 0x3e, 0xb4, 0x52, 0xcd, 0x25, 0xa1, 0xb3, 0x8d, 0x37, 0x96, + 0x64, 0xb1, 0x5f, 0x9d, 0x2a, 0x4e, 0xde, 0x3e, 0x72, 0xbb, 0x90, 0xb3, + 0x6a, 0xa6, 0x9d, 0xa5, 0x40, 0x25, 0x29, 0xa7, 0x9d, 0x50, 0x13, 0x5e, + 0x2a, 0x28, 0x7e, 0xf0, 0x45, 0xe3, 0x1e, 0x88, 0x3a, 0x4e, 0xe2, 0x2a, + 0x98, 0x6e, 0x43, 0x22, 0xb8, 0x2d, 0x9a, 0x59, 0x03, 0xaf, 0x81, 0x0c, + 0x64, 0xbe, 0xc0, 0xeb, 0x6d, 0x39, 0xd7, 0xee, 0x97, 0x84, 0x96, 0xf4, + 0x2c, 0x1f, 0x62, 0x13, 0x6a, 0x06, 0x8e, 0x4d, 0x12, 0x0d, 0x47, 0x92, + 0x5f, 0x2b, 0x94, 0xa0, 0x3a, 0x2e, 0xef, 0x9b, 0x7d, 0x40, 0x69, 0xf4, + 0xae, 0xa8, 0x36, 0xaf, 0x5b, 0xd1, 0x04, 0xde, 0xa2, 0x24, 0x9e, 0x50, + 0x09, 0x23, 0xe2, 0x1c, 0x42, 0x96, 0xe8, 0xb1, 0x9e, 0xce, 0x97, 0xcb, + 0x20, 0x0d, 0x4f, 0x17, 0x26, 0x6b, 0x51, 0x10, 0x22, 0x05, 0x3c, 0x6f, + 0x84, 0xca, 0xcd, 0x2f, 0xb9, 0x09, 0x0e, 0x92, 0xf0, 0x21, 0xf9, 0x66, + 0xa2, 0x82, 0xbe, 0xbc, 0x25, 0x1f, 0x34, 0x2d, 0x97, 0x27, 0x9a, 0x1b, + 0xb8, 0x43, 0x14, 0xfb, 0xf2, 0x9f, 0xe5, 0x93, 0x79, 0x78, 0xf1, 0x3a, + 0xce, 0x2a, 0x35, 0x5b, 0xbd, 0x4f, 0x88, 0xe1, 0xee, 0x16, 0xff, 0xf6, + 0x5d, 0xa1, 0xce, 0x4c, 0x13, 0xe2, 0xff, 0x83, 0xb2, 0x18, 0x00, 0x9e, + 0x1f, 0xf0, 0xaf, 0x3b, 0x04, 0xe9, 0x3b, 0xbc, 0xe0, 0x38, 0xbd, 0x2a, + 0x32, 0x33, 0x60, 0x58, 0x0c, 0x08, 0x33, 0x0e, 0x69, 0xe7, 0xc1, 0xcb, + 0x21, 0xe6, 0x67, 0xa9, 0x17, 0x95, 0xb7, 0x27, 0xae, 0xc8, 0x32, 0xde, + 0xa6, 0x29, 0x02, 0xfc, 0xa7, 0x0f, 0x31, 0xc8, 0xc1, 0x88, 0xa9, 0xa9, + 0xef, 0xb2, 0x3d, 0xe6, 0x23, 0xfa, 0x56, 0xf2, 0xaf, 0xcc, 0x3d, 0xfc, + 0x5e, 0x72, 0x6a, 0xe9, 0xe9, 0x96, 0x4c, 0x8a, 0x02, 0x68, 0xba, 0x38, + 0x5b, 0x00, 0x5a, 0x62, 0x4c, 0x2a, 0x55, 0x20, 0x7f, 0x9c, 0xb8, 0x79, + 0x13, 0x7b, 0xad, 0x8a, 0xc6, 0xe4, 0x93, 0x09, 0x7d, 0x2f, 0xe2, 0x92, + 0x96, 0x44, 0xe5, 0xe0, 0x5c, 0x6f, 0x00, 0x08, 0x4d, 0x11, 0x44, 0x4e, + 0xfa, 0x9e, 0xd1, 0x58, 0xe3, 0xcb, 0xd4, 0xbb, 0x6f, 0x6c, 0x56, 0x9a, + 0xef, 0x7a, 0x6e, 0x5d, 0x05, 0x8c, 0x80, 0x45, 0x77, 0x8d, 0x36, 0x53, + 0xaa, 0x07, 0x8c, 0x98, 0x86, 0xd6, 0x12, 0xe9, 0x48, 0x71, 0x5e, 0x26, + 0x2f, 0x18, 0xbc, 0x95, 0xb0, 0x21, 0x88, 0x43, 0x5c, 0x3d, 0xa3, 0x96, + 0x27, 0x43, 0x29, 0x2e, 0x97, 0xe9, 0x0f, 0xc1, 0xdf, 0x02, 0xcc, 0xc7, + 0xdb, 0xde, 0x3c, 0x7a, 0xce, 0x94, 0x3c, 0xef, 0x81, 0x99, 0x1b, 0x35, + 0xc8, 0xab, 0xe5, 0xa2, 0xf1, 0xf2, 0x92, 0xb4, 0xa5, 0x95, 0x48, 0x69, + 0xa3, 0xea, 0x8f, 0xef, 0xa3, 0x38, 0xcc, 0xce, 0xc5, 0x64, 0x48, 0x73, + 0x97, 0x3c, 0xc0, 0x84, 0xa0, 0x33, 0xbe, 0x4a, 0x10, 0x81, 0x32, 0x12, + 0x11, 0xc3, 0xcd, 0x4e, 0x79, 0x70, 0x76, 0xa1, 0xbc, 0xb4, 0x72, 0x22, + 0xd5, 0x73, 0xd9, 0x4d, 0xe2, 0xd8, 0x92, 0xc9, 0x39, 0xb6, 0x6c, 0x3e, + 0x9a, 0xc4, 0x76, 0xa0, 0xec, 0x64, 0x99, 0x67, 0x35, 0x88, 0x15, 0x37, + 0x5f, 0xcf, 0x5f, 0xeb, 0x09, 0xcb, 0x93, 0x9c, 0xd5, 0xa2, 0xd5, 0x9a, + 0xc7, 0x54, 0x1f, 0xa2, 0x6c, 0xe8, 0x62, 0x64, 0x86, 0xb2, 0xc1, 0x19, + 0x92, 0xec, 0xc3, 0x52, 0x1c, 0xfb, 0xfb, 0x25, 0x13, 0xfa, 0x88, 0x14, + 0x30, 0x7f, 0x7c, 0x2a, 0x33, 0x17, 0x11, 0x2b, 0x25, 0x27, 0xe5, 0x3b, + 0xa4, 0x40, 0x48, 0x6a, 0x4a, 0x5b, 0x8b, 0x52, 0x91, 0xac, 0xb2, 0x94, + 0x6f, 0xd9, 0x2f, 0x6e, 0x90, 0x5a, 0x56, 0x09, 0x1f, 0x0a, 0xd1, 0xfe, + 0x7c, 0x38, 0xdb, 0x7e, 0x63, 0xdc, 0xac, 0x7a, 0xc8, 0x22, 0xa8, 0xd4, + 0x48, 0x31, 0xfc, 0xcd, 0x8f, 0x75, 0x49, 0x8b, 0x41, 0x23, 0x43, 0xb8, + 0x50, 0x28, 0xed, 0xf0, 0x26, 0xd4, 0x97, 0x31, 0x86, 0xdd, 0xe2, 0x53, + 0x65, 0x40, 0x66, 0x2d, 0x2c, 0x72, 0x89, 0x12, 0x20, 0xbc, 0xd5, 0x1e, + 0xc1, 0x94, 0x23, 0x50, 0xb8, 0xcd, 0x6a, 0x62, 0xdc, 0x00, 0x26, 0x09, + 0xb5, 0x48, 0x4b, 0x40, 0x2d, 0x10, 0x7f, 0x11, 0xb2, 0x8f, 0x0f, 0x52, + 0xb6, 0xa1, 0x5d, 0x01, 0x58, 0x71, 0x60, 0xe6, 0xe3, 0xd0, 0x48, 0xc7, + 0xb1, 0x44, 0x35, 0xf0, 0x9e, 0xbc, 0xdb, 0xe9, 0x99, 0xa8, 0xe4, 0x51, + 0x05, 0xec, 0x05, 0xee, 0x45, 0x14, 0x3e, 0x7d, 0x53, 0xd0, 0xd6, 0xcc, + 0x60, 0xc7, 0x44, 0x1b, 0x67, 0xa9, 0xab, 0x7d, 0x03, 0x51, 0xc9, 0x90, + 0x35, 0x62, 0xff, 0xa3, 0xce, 0x72, 0xd0, 0x7e, 0x97, 0xf1, 0xdd, 0x93, + 0x91, 0xb9, 0xdc, 0x80, 0xd6, 0x2a, 0xf9, 0xe6, 0xb6, 0x58, 0x07, 0x33, + 0xd3, 0x1f, 0x54, 0xb8, 0xc4, 0xa8, 0x89, 0x20, 0x9a, 0xfa, 0x21, 0xdf, + 0x34, 0xa4, 0x3d, 0x8a, 0x3c, 0x09, 0xd8, 0x8a, 0x18, 0x60, 0xa4, 0x62, + 0x23, 0x94, 0x77, 0x6c, 0x52, 0x0e, 0x7b, 0x5e, 0x83, 0x6e, 0xf5, 0x2b, + 0x02, 0x70, 0x27, 0x81, 0x92, 0xfe, 0x3b, 0xa6, 0xf7, 0x91, 0x10, 0xd4, + 0x06, 0x18, 0xf1, 0xf3, 0xb2, 0x59, 0x4a, 0x76, 0x54, 0xab, 0x95, 0x19, + 0xe1, 0x20, 0x2f, 0x2d, 0xb4, 0xad, 0x62, 0xd1, 0xb4, 0x35, 0x68, 0xa8, + 0x73, 0x2b, 0xda, 0xc4, 0x45, 0x47, 0xd8, 0xe4, 0x53, 0x36, 0x3a, 0x6b, + 0x6b, 0x8e, 0x2e, 0xa0, 0x45, 0xeb, 0x6a, 0x1e, 0xd1, 0x5d, 0xab, 0x74, + 0xc2, 0xcc, 0x43, 0xe1, 0xe7, 0xba, 0x4e, 0x5a, 0x4d, 0x83, 0x0e, 0xc5, + 0x8c, 0x41, 0xb9, 0x25, 0xdc, 0x29, 0xe9, 0xfe, 0xdf, 0xd4, 0x38, 0x6b, + 0x90, 0xd2, 0x2d, 0xc6, 0x9a, 0x59, 0xde, 0xa2, 0x36, 0x60, 0x84, 0xf3, + 0xc7, 0x43, 0xd0, 0xdb, 0x26, 0xdb, 0x56, 0xb7, 0x54, 0x77, 0xb1, 0x46, + 0xec, 0xf2, 0x2f, 0xa8, 0x75, 0x65, 0x74, 0x24, 0xa7, 0x2c, 0x49, 0xb1, + 0xb7, 0x2e, 0x1c, 0xa8, 0x51, 0x9b, 0x44, 0xe8, 0x21, 0xd5, 0xe5, 0x06, + 0xfb, 0xc8, 0xd9, 0xce, 0xc6, 0x36, 0x85, 0x3d, 0x70, 0x83, 0x1b, 0xce, + 0x78, 0x4a, 0x4a, 0x07, 0x31, 0x98, 0x93, 0x50, 0xb9, 0xa0, 0xa5, 0xcd, + 0xb5, 0x63, 0x38, 0xef, 0x11, 0x91, 0x81, 0xcb, 0xf3, 0x26, 0x71, 0x18, + 0xd3, 0x35, 0xb2, 0x2b, 0xd7, 0x6a, 0x54, 0x60, 0xef, 0x18, 0xc1, 0x19, + 0x56, 0x8b, 0x77, 0xbd, 0x10, 0xfa, 0xc3, 0x0b, 0x64, 0xe8, 0x0a, 0xb6, + 0xc7, 0x48, 0xaa, 0x61, 0x66, 0x8a, 0xaa, 0x82, 0x4f, 0x74, 0x43, 0x18, + 0xc8, 0xfd, 0x7f, 0x85, 0xd9, 0x74, 0x1f, 0x98, 0x60, 0x60, 0xea, 0x19, + 0x57, 0x85, 0x07, 0x7e, 0xbe, 0xc3, 0x02, 0x74, 0xb3, 0x2d, 0xf4, 0x72, + 0x0f, 0x0f, 0xfe, 0x9d, 0xef, 0x19, 0x07, 0xbe, 0x70, 0xa0, 0x5c, 0x19, + 0xfe, 0x96, 0xb6, 0x75, 0xfd, 0x55, 0x7c, 0x68, 0x3d, 0x3e, 0x52, 0x06, + 0x4d, 0x68, 0x25, 0xe6, 0x54, 0x73, 0xfa, 0x4d, 0x1d, 0x4a, 0x2f, 0xff, + 0xff, 0x0b, 0xb9, 0xfe, 0x23, 0xe6, 0xdb, 0x4f, 0x1a, 0xd8, 0x92, 0xe8, + 0xb3, 0xab, 0x43, 0xe4, 0x1a, 0x4b, 0x0a, 0x0b, 0x06, 0x97, 0x86, 0xd6, + 0x72, 0xc4, 0x4e, 0xc0, 0x22, 0xcb, 0x63, 0xce, 0x3e, 0xb5, 0xc7, 0x89, + 0x05, 0x88, 0x75, 0x75, 0x30, 0x2b, 0xdd, 0x6d, 0xef, 0xe2, 0x71, 0xe8, + 0x54, 0x27, 0x0a, 0x9d, 0x58, 0x7f, 0x0b, 0x1e, 0x0b, 0x68, 0x21, 0x8b, + 0xf7, 0xa5, 0x52, 0xd8, 0x8e, 0x24, 0x0c, 0x49, 0x90, 0x36, 0x12, 0x44, + 0x2c, 0x2b, 0x54, 0xf7, 0xba, 0x23, 0x9f, 0xcf, 0x23, 0xbc, 0x07, 0x25, + 0x81, 0xc4, 0x31, 0xc3, 0xc5, 0x79, 0xc9, 0x0f, 0xa1, 0x59, 0x0a, 0x08, + 0x0f, 0xc1, 0xe8, 0xc3, 0x01, 0x7e, 0x71, 0x31, 0x91, 0x09, 0x19, 0x21, + 0x9f, 0x59, 0xb8, 0xe2, 0xb7, 0xaf, 0xb9, 0x74, 0xf7, 0x6d, 0x4a, 0xbf, + 0xb3, 0xca, 0xe9, 0x51, 0x97, 0xe6, 0x29, 0xca, 0x1c, 0x27, 0x04, 0x9f, + 0x25, 0x8a, 0x3b, 0x96, 0xc0, 0xcd, 0x44, 0x30, 0x23, 0x18, 0xca, 0x5e, + 0xdc, 0x6d, 0xdd, 0x89, 0x84, 0x8c, 0x79, 0xdb, 0xc3, 0xf4, 0x3a, 0xce, + 0xcf, 0xa8, 0xa3, 0xf7, 0xff, 0xf8, 0x3d, 0x08, 0x11, 0x2b, 0x11, 0xa1, + 0x4c, 0xfe, 0x00, 0x26, 0x00, 0x34, 0x00, 0x2c, 0x00, 0x2b, 0x00, 0x2c, + 0x00, 0x17, 0x00, 0xe6, 0xaa, 0xdd, 0xac, 0x4e, 0xc7, 0x07, 0x37, 0x30, + 0x63, 0x5f, 0xf6, 0xbe, 0xf0, 0x80, 0xcf, 0x9c, 0xfa, 0xb7, 0xa3, 0xf3, + 0x5e, 0xa3, 0xf3, 0xd9, 0xf6, 0x29, 0x42, 0xe6, 0xce, 0xed, 0xbc, 0x13, + 0x9a, 0x73, 0xe0, 0xa1, 0x86, 0xb3, 0x21, 0xa1, 0xe4, 0xbb, 0x21, 0xe3, + 0x5c, 0x7f, 0xe3, 0xc3, 0xc2, 0x07, 0x20, 0xd2, 0x8b, 0xf6, 0xda, 0x21, + 0x90, 0xa4, 0xb4, 0xc2, 0x1b, 0xc0, 0x86, 0x74, 0xb4, 0xc9, 0x7a, 0xc0, + 0x68, 0x9f, 0x6d, 0x3a, 0xaa, 0xd6, 0x90, 0x48, 0x87, 0x17, 0x4e, 0x70, + 0xd6, 0x12, 0x89, 0x09, 0x43, 0x9c, 0x33, 0xee, 0x3a, 0x12, 0x4c, 0x18, + 0x97, 0x06, 0x21, 0x54, 0x9f, 0x86, 0x77, 0x08, 0x9f, 0xb2, 0xbc, 0x14, + 0x9e, 0xad, 0x7b, 0x7e, 0x4f, 0xc9, 0x52, 0x97, 0x78, 0x07, 0x94, 0x46, + 0x80, 0x51, 0x09, 0x40, 0xfe, 0x4a, 0x13, 0xfb, 0xa9, 0x6d, 0x38, 0x28, + 0x1c, 0xfc, 0x0b, 0xa8, 0x3d, 0x0e, 0x46, 0x89, 0x3f, 0x83, 0x71, 0x9a, + 0xc2, 0x20, 0x41, 0x2a, 0xa4, 0x28, 0xfb, 0x9f, 0x41, 0x8c, 0x5b, 0xf4, + 0x4b, 0x9b, 0xf0, 0xb9, 0xd1, 0x29, 0x2f, 0x95, 0x8c, 0x53, 0xf9, 0xdd, + 0x95, 0x1e, 0x0d, 0x0e, 0x7c, 0x28, 0x9a, 0x54, 0x5d, 0x26, 0xd7, 0xc8, + 0x7a, 0x08, 0x51, 0xe8, 0x47, 0xc8, 0x6d, 0xa0, 0xce, 0x38, 0x34, 0x7a, + 0x63, 0xac, 0x51, 0x1b, 0xf5, 0x29, 0x3c, 0x21, 0x34, 0x0e, 0x4f, 0x13, + 0x5c, 0x16, 0x9d, 0x28, 0xcb, 0x2c, 0xf5, 0x46, 0xd3, 0xd2, 0xc4, 0xcd, + 0xa2, 0x9a, 0x3a, 0x46, 0x34, 0xf5, 0x58, 0xbb, 0x38, 0xef, 0xce, 0x30, + 0xd0, 0x88, 0x41, 0xd4, 0x90, 0x17, 0x30, 0x19, 0xaa, 0x43, 0x9d, 0xa9, + 0x19, 0x8a, 0x0f, 0x35, 0x1c, 0x8e, 0x48, 0xe8, 0xa0, 0xe4, 0x25, 0x12, + 0x1b, 0x7a, 0xdc, 0x6a, 0x2e, 0x1a, 0x30, 0x41, 0x9c, 0xb7, 0x66, 0x93, + 0x81, 0x4e, 0x76, 0x10, 0xc2, 0x76, 0x2d, 0xff, 0xa2, 0xb8, 0x40, 0xe9, + 0x3b, 0xa3, 0x0e, 0x1e, 0x63, 0x61, 0x5b, 0x6a, 0x6c, 0xec, 0xf0, 0x01, + 0xf7, 0x69, 0x57, 0x3b, 0x20, 0x49, 0x4e, 0x2d, 0x3a, 0x3f, 0x12, 0x69, + 0xa2, 0x6c, 0xea, 0x29, 0x3c, 0xf3, 0x85, 0x97, 0xac, 0xc9, 0x9d, 0x6a, + 0x43, 0xef, 0xef, 0xff, 0x55, 0xac, 0x25, 0xf8, 0x2e, 0xc4, 0xf0, 0x40, + 0x1f, 0x75, 0x1a, 0x2b, 0xa2, 0x81, 0x9d, 0x26, 0xda, 0x35, 0xda, 0x17, + 0x82, 0x1a, 0xd8, 0xd7, 0x58, 0x44, 0x55, 0x31, 0x5f, 0x83, 0xe4, 0xdd, + 0x47, 0x6b, 0xed, 0x8e, 0xf7, 0x2a, 0x02, 0x36, 0xc2, 0x10, 0xe7, 0x33, + 0xd2, 0xb6, 0xef, 0xa1, 0xbe, 0x31, 0x9b, 0x6f, 0x3d, 0x6a, 0xaf, 0xd1, + 0x7a, 0x9f, 0x4f, 0x0c, 0x57, 0x28, 0x2b, 0x38, 0xe4, 0xf7, 0x83, 0x10, + 0x84, 0x7c, 0x5f, 0x18, 0xa2, 0xdc, 0xba, 0xcb, 0x61, 0xb9, 0x33, 0xad, + 0xa6, 0xd7, 0xac, 0xdc, 0x8d, 0x5b, 0x5d, 0xc5, 0xf4, 0xaa, 0x14, 0x64, + 0xfc, 0x95, 0xec, 0xab, 0xbb, 0x47, 0x8b, 0xad, 0xf0, 0x3f, 0xd2, 0x8c, + 0x96, 0x92, 0x4c, 0x64, 0x82, 0xed, 0x2c, 0x45, 0x33, 0x9a, 0x90, 0xde, + 0x72, 0x13, 0x4d, 0x80, 0xbb, 0x8b, 0x95, 0xc7, 0xd2, 0x14, 0x52, 0x94, + 0x0d, 0xe7, 0x07, 0x32, 0xe7, 0x74, 0x95, 0x36, 0x06, 0x04, 0x50, 0x16, + 0xac, 0x2c, 0x9e, 0x12, 0x4f, 0x4e, 0xb4, 0xa5, 0xd4, 0x0d, 0x0e, 0x5b, + 0x13, 0x22, 0x3d, 0xed, 0x78, 0x03, 0x55, 0xea, 0xb6, 0x94, 0xef, 0x24, + 0x39, 0x86, 0xa8, 0x80, 0x5f, 0xd1, 0xe9, 0x02, 0x74, 0x62, 0x4f, 0x61, + 0xb9, 0x1c, 0x1b, 0xd4, 0x2e, 0xef, 0xe8, 0x91, 0x4a, 0x35, 0xdb, 0x27, + 0xa1, 0x5e, 0x67, 0x44, 0x77, 0x04, 0x02, 0xb6, 0x04, 0xcd, 0x12, 0x7a, + 0x28, 0x4d, 0x5e, 0xde, 0x37, 0xa4, 0xba, 0x9f, 0x5e, 0x25, 0x13, 0x8c, + 0xeb, 0x14, 0xea, 0xa0, 0xaa, 0x9a, 0x7b, 0x57, 0x68, 0xda, 0x9b, 0x1b, + 0xe5, 0xf7, 0xef, 0x2b, 0x09, 0x2c, 0x55, 0x21, 0x8f, 0xf0, 0xfa, 0x20, + 0xc8, 0x6e, 0x93, 0x99, 0xaa, 0xbb, 0xca, 0xc2, 0x18, 0xdc, 0x4c, 0x27, + 0x73, 0x48, 0x0c, 0xe3, 0xec, 0xcf, 0x15, 0x81, 0x9e, 0x8c, 0x92, 0xcf, + 0x08, 0x91, 0x99, 0x98, 0x8f, 0xdb, 0x7f, 0x70, 0xc5, 0x50, 0xa2, 0xb2, + 0xe0, 0x20, 0xb2, 0x7a, 0x30, 0x90, 0x21, 0xc9, 0xd7, 0x35, 0xdf, 0x74, + 0x11, 0xa4, 0xf7, 0x41, 0x82, 0x54, 0x09, 0x68, 0x58, 0xb0, 0xc8, 0xdb, + 0x82, 0xd3, 0x2a, 0x5f, 0x16, 0xf8, 0x5c, 0x1c, 0xc4, 0x49, 0xdc, 0x36, + 0xac, 0xe0, 0x7a, 0xa8, 0x1c, 0xe1, 0x2d, 0x93, 0xf1, 0x47, 0x33, 0xf7, + 0xae, 0xcb, 0x7a, 0x2c, 0x26, 0x1b, 0xa5, 0x54, 0xb5, 0xa1, 0x1e, 0x6f, + 0xbf, 0x54, 0x9e, 0x7e, 0x8b, 0x5f, 0xaf, 0xcd, 0x68, 0x84, 0x33, 0x38, + 0x81, 0x73, 0x6d, 0x85, 0xd5, 0xe4, 0x98, 0xce, 0xe4, 0xed, 0x4b, 0xb9, + 0xc4, 0x3a, 0xd2, 0x38, 0x94, 0x99, 0x53, 0xd4, 0x78, 0xd9, 0x65, 0x5b, + 0xb2, 0xdf, 0xf1, 0x87, 0xa4, 0x64, 0x5f, 0x31, 0x77, 0xc3, 0x9a, 0x8b, + 0xdc, 0x61, 0xa7, 0x6f, 0x40, 0x7d, 0x4b, 0x83, 0xdc, 0x7c, 0x99, 0xa5, + 0xed, 0xd2, 0xe8, 0xc1, 0x71, 0xb6, 0x86, 0xcb, 0x8d, 0xb3, 0x88, 0x49, + 0x91, 0x70, 0xb1, 0x8d, 0x51, 0xbe, 0x36, 0x3a, 0xcd, 0x69, 0xce, 0xd3, + 0x99, 0xc3, 0x7b, 0x90, 0xe4, 0x5f, 0x9c, 0x3b, 0x35, 0x4a, 0x17, 0x9b, + 0xaf, 0xe0, 0x63, 0x14, 0xb8, 0x7a, 0xcf, 0x35, 0x7f, 0x47, 0x46, 0x9a, + 0x9a, 0x3a, 0xa5, 0xa2, 0x5d, 0x66, 0x8d, 0xd1, 0xe7, 0xb7, 0x4f, 0x7a, + 0xb1, 0x25, 0xc1, 0x66, 0xd4, 0x90, 0xca, 0xa1, 0x35, 0xd4, 0x6a, 0xfb, + 0xc2, 0xc5, 0x52, 0xbe, 0x70, 0x9f, 0x46, 0x0c, 0x3c, 0x12, 0x8a, 0xff, + 0x3d, 0x75, 0x5f, 0x60, 0xcd, 0x17, 0xa5, 0xb8, 0xfd, 0xdc, 0x19, 0xe3, + 0x22, 0x20, 0x33, 0x38, 0x1a, 0xc7, 0xd9, 0x19, 0x13, 0x24, 0x48, 0xe5, + 0x21, 0x0e, 0xc4, 0xf6, 0x6d, 0x5a, 0x9b, 0xd2, 0x2a, 0xa2, 0x15, 0x59, + 0x39, 0xf9, 0x27, 0xeb, 0xae, 0xf9, 0x5d, 0x3e, 0x52, 0x59, 0xf1, 0x77, + 0x24, 0x20, 0x89, 0x99, 0x2b, 0xa4, 0x33, 0x36, 0xe2, 0x3a, 0xf5, 0x16, + 0x8c, 0xb7, 0x3f, 0xf1, 0x82, 0x1a, 0x19, 0xea, 0x1a, 0xdd, 0xfa, 0xfe, + 0xc3, 0xe1, 0x0f, 0x9a, 0xb6, 0x39, 0x9d, 0x0c, 0x5d, 0x78, 0xb6, 0x3f, + 0x7f, 0x47, 0x9e, 0x51, 0x77, 0x74, 0x68, 0xc8, 0xfa, 0xfd, 0x98, 0x88, + 0xcc, 0x9b, 0xd1, 0x25, 0xd0, 0xca, 0x1d, 0x91, 0xc8, 0x40, 0x8c, 0x29, + 0xa5, 0x2d, 0x14, 0xce, 0x3c, 0xd0, 0x99, 0xda, 0xc7, 0xfa, 0x62, 0xf7, + 0x81, 0x2a, 0xe5, 0xe9, 0xba, 0xfd, 0xc2, 0xe5, 0xb5, 0xf7, 0x4e, 0xc3, + 0x0d, 0x41, 0xb5, 0x3d, 0xa2, 0x0c, 0x12, 0x12, 0x9f, 0xb8, 0xaa, 0xa7, + 0xef, 0xad, 0xf4, 0x2d, 0x00, 0x2d, 0x0c, 0x69, 0x19, 0x80, 0x1a, 0x45, + 0xdc, 0x65, 0x2b, 0x7b, 0x7f, 0x43, 0x15, 0x55, 0x85, 0xb3, 0x27, 0x57, + 0x0b, 0xac, 0x5d, 0x7a, 0x22, 0x5f, 0x09, 0x11, 0x59, 0x01, 0xad, 0xae, + 0xfe, 0x6a, 0x68, 0xb6, 0x61, 0xb4, 0xb1, 0x47, 0xd2, 0x99, 0x9f, 0xb6, + 0xf2, 0xef, 0xb0, 0x0e, 0x5a, 0x71, 0x4a, 0x18, 0x20, 0x4c, 0x94, 0x36, + 0x68, 0x22, 0x7b, 0xa2, 0xc4, 0x7f, 0xa4, 0x85, 0xef, 0x4e, 0x67, 0xb4, + 0x0a, 0x31, 0x5b, 0x0d, 0x54, 0x8a, 0x13, 0x4f, 0x9c, 0xd5, 0x9f, 0x29, + 0x1c, 0x4e, 0xc4, 0xd4, 0x8f, 0x1b, 0x64, 0x18, 0xb0, 0x77, 0x6f, 0x33, + 0x5d, 0x94, 0xce, 0x3a, 0x51, 0xad, 0x68, 0x9c, 0xaf, 0x3b, 0x0c, 0xde, + 0x43, 0x09, 0x17, 0x6c, 0xd9, 0x8c, 0x34, 0x14, 0xc7, 0x97, 0x3c, 0xc3, + 0x77, 0xec, 0x94, 0xe5, 0x26, 0x48, 0xcb, 0xac, 0x57, 0x6f, 0xff, 0x8c, + 0xb8, 0x82, 0xa7, 0xe2, 0x0b, 0xd1, 0x1b, 0xd3, 0x39, 0xc9, 0xd9, 0xae, + 0x4d, 0x8b, 0x51, 0xa9, 0x5a, 0x43, 0x05, 0xa5, 0x6b, 0xde, 0x72, 0xae, + 0xb3, 0xed, 0x4a, 0x53, 0x59, 0x6d, 0x68, 0xe8, 0x30, 0x71, 0xe2, 0x6e, + 0x69, 0x3c, 0x44, 0x44, 0xac, 0x78, 0xb5, 0x34, 0x81, 0x26, 0xe6, 0x44, + 0xde, 0x56, 0x64, 0xdb, 0xfd, 0x0b, 0xa6, 0x84, 0xea, 0x77, 0x34, 0xe5, + 0x23, 0xd4, 0x62, 0xda, 0x5b, 0xc7, 0xa5, 0x62, 0xba, 0x68, 0xa9, 0x9d, + 0x0f, 0xc5, 0xdb, 0x38, 0x44, 0x0b, 0xfe, 0x6c, 0x8d, 0x4f, 0x71, 0x89, + 0x52, 0x92, 0x99, 0x67, 0x0d, 0x24, 0x0b, 0xd8, 0x11, 0x2a, 0xde, 0xd5, + 0x5a, 0xdf, 0x46, 0x4d, 0x16, 0xe4, 0xb2, 0x6e, 0x6e, 0x10, 0x87, 0xc5, + 0xe5, 0x26, 0xf5, 0x1a, 0xf8, 0xeb, 0xa7, 0x4b, 0x3b, 0xaa, 0xbe, 0x90, + 0x78, 0x92, 0xee, 0xa1, 0x7b, 0x6a, 0x25, 0x5f, 0x9c, 0x2a, 0xec, 0xaf, + 0xca, 0xb1, 0xc4, 0x4b, 0x7b, 0x17, 0x4b, 0x12, 0x6f, 0x75, 0xc6, 0xa1, + 0xe6, 0x00, 0xba, 0x11, 0x57, 0xdd, 0x46, 0x56, 0x52, 0x26, 0x1f, 0x83, + 0x23, 0x31, 0x23, 0x82, 0x46, 0x5d, 0xe9, 0x5a, 0xca, 0x6f, 0x25, 0xc5, + 0x10, 0x56, 0x2b, 0x52, 0x73, 0x9c, 0x45, 0x6a, 0xd0, 0xd8, 0xc7, 0xb7, + 0xf0, 0x86, 0x32, 0x4c, 0x08, 0xd7, 0x87, 0x13, 0xc6, 0xee, 0x1f, 0x0b, + 0xb9, 0xb9, 0x50, 0x8e, 0x09, 0xb2, 0xe4, 0x69, 0x55, 0x62, 0x74, 0x0e, + 0xdf, 0x15, 0x25, 0x9c, 0xde, 0x9e, 0x55, 0x13, 0xa7, 0x8f, 0xb1, 0x24, + 0x36, 0xd9, 0x57, 0xad, 0x68, 0xb1, 0xfe, 0xeb, 0xb6, 0x96, 0x28, 0x3e, + 0xea, 0xfe, 0x44, 0xf7, 0xf3, 0xa7, 0xed, 0x85, 0x2b, 0x9b, 0x8a, 0xb9, + 0x86, 0x9b, 0x3f, 0x07, 0x5b, 0x49, 0x06, 0x70, 0x7e, 0x79, 0xd5, 0xda, + 0xe2, 0x54, 0xd4, 0x8b, 0xba, 0xed, 0x77, 0x99, 0xb1, 0x1e, 0xf6, 0xfc, + 0x15, 0xa9, 0x2f, 0x5d, 0xc5, 0x99, 0xfc, 0x3a, 0x86, 0x4f, 0x5e, 0x2d, + 0x99, 0xa2, 0x68, 0x22, 0xc4, 0x57, 0x14, 0x90, 0xfb, 0x8a, 0xa6, 0x07, + 0x11, 0x8e, 0xc8, 0xf3, 0x08, 0x08, 0x91, 0xb0, 0x09, 0xe8, 0x87, 0x02, + 0xb3, 0xf4, 0x17, 0x67, 0x82, 0xa1, 0xfe, 0x2c, 0xf8, 0xe5, 0x05, 0x27, + 0x41, 0xb3, 0x6c, 0xb2, 0x9b, 0xb9, 0x42, 0xb4, 0xb2, 0xa3, 0x55, 0xba, + 0xd0, 0x50, 0x74, 0xec, 0x21, 0x9e, 0x9a, 0xbe, 0x18, 0x1f, 0x6f, 0x2e, + 0xd0, 0xd8, 0xe9, 0xa9, 0xfe, 0x58, 0x6c, 0x33, 0x8d, 0xd6, 0x02, 0xdd, + 0xcf, 0xb1, 0x35, 0xbe, 0x97, 0x50, 0xbd, 0xe2, 0x11, 0x6e, 0x86, 0x27, + 0xe7, 0xc5, 0x8a, 0xe8, 0xde, 0xa1, 0xe2, 0x87, 0x93, 0xb1, 0x5b, 0xb3, + 0xee, 0xf9, 0xe1, 0xf6, 0x79, 0xd7, 0x6d, 0xf4, 0x42, 0xfc, 0x1b, 0xc1, + 0xa4, 0xc9, 0x4d, 0x5e, 0x83, 0xc5, 0x92, 0x03, 0x53, 0xe5, 0xc8, 0xa2, + 0x33, 0xb1, 0x2f, 0x23, 0xdf, 0x6b, 0x25, 0xf6, 0xc8, 0x97, 0x63, 0xb5, + 0x03, 0x0d, 0xab, 0xd7, 0xa2, 0x54, 0xf0, 0x03, 0xc7, 0xe7, 0x3d, 0x1f, + 0xe8, 0xb6, 0x24, 0x03, 0xe0, 0x84, 0x85, 0x43, 0x78, 0x0a, 0x88, 0x0e, + 0x44, 0xf9, 0x4c, 0x7c, 0x9a, 0xa1, 0x5e, 0x49, 0xc7, 0x30, 0xcd, 0xe4, + 0x05, 0x84, 0xa6, 0xf6, 0x82, 0xd7, 0x76, 0xa4, 0xea, 0x5c, 0x95, 0xfb, + 0x99, 0x84, 0x17, 0x53, 0xa8, 0x19, 0xd5, 0xd5, 0xed, 0xa1, 0xed, 0xb8, + 0xc7, 0x8d, 0xbf, 0x1a, 0x3b, 0x96, 0x31, 0x7d, 0xf5, 0x9b, 0xe8, 0x71, + 0xf5, 0xcc, 0xb0, 0x16, 0x8c, 0x6b, 0x1d, 0x18, 0x09, 0x82, 0xf5, 0xa1, + 0x34, 0x32, 0x03, 0x48, 0x1c, 0x2f, 0x21, 0xc9, 0xc5, 0x96, 0x77, 0x80, + 0x99, 0x6e, 0x59, 0x20, 0x6f, 0xb5, 0x24, 0x53, 0x37, 0xee, 0xc7, 0xbf, + 0xb9, 0x5a, 0xe5, 0x46, 0xe2, 0x0d, 0x53, 0x83, 0xaa, 0xf2, 0xfd, 0x79, + 0xb5, 0xee, 0xee, 0xa6, 0x67, 0xfe, 0xc4, 0x45, 0x0f, 0xf6, 0xd0, 0x87, + 0x7c, 0x57, 0xaa, 0xb9, 0x52, 0xb4, 0xff, 0xa2, 0x88, 0x6b, 0xf2, 0x34, + 0x71, 0x59, 0xa0, 0x27, 0x16, 0x86, 0x24, 0x15, 0x77, 0x3f, 0xce, 0x8b, + 0x28, 0x13, 0xea, 0x0d, 0x23, 0x94, 0xfc, 0xe4, 0x21, 0xe6, 0xeb, 0xc5, + 0x8d, 0xc3, 0xa7, 0x5e, 0x3f, 0x1c, 0x2b, 0x9e, 0x35, 0x34, 0xe4, 0xda, + 0x20, 0x1f, 0x5f, 0x59, 0x1d, 0xf7, 0x12, 0x7a, 0xfc, 0x8e, 0x8e, 0xa4, + 0xa8, 0x55, 0x05, 0x5e, 0x86, 0xb0, 0xcc, 0xcc, 0xb9, 0x0b, 0x76, 0xd5, + 0x75, 0x3d, 0xfc, 0xbc, 0x73, 0xbb, 0x2e, 0x98, 0x78, 0x05, 0xf3, 0xa7, + 0x40, 0xdb, 0x7a, 0xfa, 0x72, 0x7e, 0x44, 0x17, 0x8a, 0x68, 0xe3, 0x42, + 0x10, 0xf6, 0x04, 0xa3, 0xbc, 0x20, 0xb0, 0x48, 0x88, 0xb3, 0x24, 0x64, + 0xc9, 0xf2, 0x93, 0x78, 0x7c, 0xc6, 0x63, 0x76, 0x03, 0x74, 0x99, 0x88, + 0x32, 0xcc, 0xfd, 0x01, 0xe5, 0x3a, 0x02, 0x1b, 0xa2, 0xaa, 0x4c, 0x87, + 0xf0, 0x61, 0x14, 0x4d, 0xef, 0x40, 0xde, 0x73, 0x0e, 0xfc, 0x74, 0x6a, + 0x85, 0x70, 0xd4, 0x5c, 0xf0, 0xed, 0x07, 0x00, 0x81, 0x3c, 0x9c, 0xbc, + 0x8e, 0x20, 0x7b, 0xf1, 0x8a, 0x95, 0x35, 0x8e, 0x3b, 0x42, 0xd5, 0x9e, + 0x71, 0x73, 0x30, 0x92, 0x62, 0x8c, 0x34, 0x54, 0xd3, 0xdb, 0x72, 0x8f, + 0x98, 0xea, 0x91, 0xbb, 0x51, 0x59, 0xda, 0x3f, 0x5a, 0x0e, 0x26, 0x15, + 0xe9, 0x73, 0xa5, 0x34, 0xf5, 0x5e, 0x84, 0x1f, 0x54, 0x79, 0x68, 0xca, + 0x64, 0x82, 0x63, 0x5f, 0x09, 0xc0, 0x6e, 0x11, 0x3c, 0x2a, 0xbc, 0x75, + 0xce, 0xdb, 0x64, 0x43, 0x60, 0xed, 0x14, 0x22, 0xb0, 0x72, 0x92, 0xfd, + 0x1b, 0xa9, 0xb3, 0x4d, 0xbb, 0x8c, 0xb1, 0xc5, 0x14, 0x8e, 0x7f, 0x99, + 0x3d, 0xe5, 0x2d, 0xaa, 0xf3, 0xb5, 0xde, 0xfb, 0x61, 0xc3, 0xfa, 0x03, + 0x6b, 0x97, 0xcb, 0x75, 0x4f, 0x97, 0xc7, 0x2b, 0x59, 0x52, 0xbb, 0x9c, + 0x4b, 0xab, 0x5c, 0xd9, 0x2e, 0x84, 0xe5, 0x88, 0x0c, 0x30, 0x49, 0xff, + 0x44, 0x49, 0x39, 0x1e, 0xfc, 0x52, 0xc4, 0x4e, 0xec, 0xb8, 0x48, 0x69, + 0x01, 0x0e, 0x62, 0xe3, 0xa7, 0x0d, 0x09, 0x7f, 0x5b, 0x39, 0x82, 0x92, + 0xb4, 0xe4, 0xd4, 0x10, 0xd9, 0xee, 0xa6, 0x77, 0x27, 0x77, 0x34, 0xa6, + 0xd7, 0x7f, 0xd2, 0x33, 0xef, 0x5f, 0x0e, 0x53, 0x96, 0xa4, 0x72, 0x27, + 0xc6, 0x38, 0xc1, 0x42, 0xd4, 0xcd, 0x6d, 0x56, 0x7f, 0xfe, 0x75, 0x50, + 0xb7, 0xe4, 0x7e, 0xe3, 0xf9, 0x34, 0x6c, 0xfd, 0xdf, 0x0a, 0xa3, 0xeb, + 0x41, 0x3e, 0x68, 0x76, 0x9a, 0xee, 0x76, 0x8b, 0x5e, 0x3f, 0x95, 0xda, + 0xf9, 0xf3, 0x3d, 0xa0, 0xd7, 0xf4, 0x8e, 0xc2, 0xcf, 0xe7, 0xf6, 0xf9, + 0x93, 0xcd, 0x5a, 0x6f, 0x69, 0xc6, 0xcc, 0x7f, 0x32, 0xaf, 0x6a, 0xd5, + 0x2b, 0x50, 0x80, 0x19, 0xec, 0xff, 0xf8, 0x3d, 0x08, 0x12, 0x2b, 0x11, + 0x1c, 0x48, 0xdd, 0x00, 0xed, 0x00, 0xf7, 0x00, 0xfb, 0x00, 0x01, 0x00, + 0xe6, 0xb4, 0xad, 0x9c, 0xf4, 0xc3, 0xe2, 0xfe, 0x10, 0x4d, 0xc0, 0x31, + 0x52, 0x0b, 0x18, 0x53, 0x72, 0xb2, 0xec, 0xae, 0x31, 0xd8, 0xaa, 0x61, + 0xbb, 0xa2, 0x68, 0xc0, 0xa0, 0x8d, 0x0c, 0x06, 0x40, 0xaf, 0xc0, 0x91, + 0xb8, 0x29, 0xb8, 0x51, 0x43, 0x80, 0x7b, 0x6f, 0x0b, 0xf3, 0x86, 0xc7, + 0x84, 0x07, 0x43, 0x1c, 0x8a, 0x93, 0x7b, 0xec, 0x95, 0x2a, 0x69, 0x1f, + 0x9f, 0x1f, 0x6b, 0x91, 0x62, 0x7b, 0x64, 0x94, 0x17, 0x9f, 0xfd, 0xa9, + 0x8e, 0xb2, 0xca, 0xa6, 0x03, 0x74, 0x70, 0x33, 0xda, 0xae, 0xa0, 0xdd, + 0xe5, 0x2e, 0xcd, 0xd3, 0x94, 0x97, 0x92, 0x18, 0x9f, 0x16, 0xf3, 0x4b, + 0xef, 0x30, 0x7c, 0x6a, 0xc9, 0xf2, 0x25, 0xb0, 0x4f, 0x2a, 0xb4, 0x9c, + 0xf7, 0x91, 0x52, 0xcd, 0x11, 0xe2, 0x35, 0x98, 0xc6, 0x3d, 0x46, 0x30, + 0x4b, 0xa6, 0xc3, 0x2f, 0x23, 0x0a, 0x94, 0x15, 0x03, 0xd5, 0xf9, 0x66, + 0xf9, 0xdc, 0x93, 0x5d, 0x91, 0xea, 0x09, 0x07, 0x1b, 0x2c, 0x6d, 0x4d, + 0x76, 0x51, 0xd3, 0x80, 0x91, 0x7b, 0xd5, 0x9d, 0xf6, 0xba, 0x70, 0x4d, + 0x51, 0x33, 0xa3, 0xe0, 0xa0, 0x69, 0xbc, 0xc2, 0x00, 0x0a, 0x3c, 0x1a, + 0x65, 0x3c, 0xfd, 0x98, 0xd1, 0x5e, 0x48, 0xba, 0x98, 0x01, 0x97, 0x9d, + 0x85, 0xc3, 0x20, 0xc1, 0x28, 0x04, 0xf9, 0x54, 0x13, 0xd8, 0x9a, 0xd5, + 0x82, 0x16, 0xe0, 0x84, 0xf8, 0xa4, 0xc1, 0xac, 0x17, 0x62, 0x88, 0xed, + 0x86, 0x12, 0xc4, 0x72, 0x55, 0xfb, 0xc8, 0x46, 0xce, 0x55, 0x0d, 0x11, + 0xa0, 0x0b, 0x5c, 0x05, 0xcd, 0xd5, 0x4a, 0x69, 0xcc, 0xe6, 0x61, 0x68, + 0xc6, 0x98, 0x3f, 0x59, 0x8f, 0x22, 0x3e, 0x06, 0x25, 0xc8, 0x69, 0x89, + 0xa0, 0xbf, 0x79, 0xe2, 0xeb, 0x9c, 0x0b, 0x94, 0xc3, 0x4e, 0x20, 0x87, + 0xc7, 0xf6, 0xa3, 0x8b, 0x13, 0x62, 0x45, 0x70, 0xbb, 0x94, 0x6a, 0x5f, + 0xa4, 0x74, 0xa1, 0x59, 0xbb, 0xba, 0x78, 0x48, 0x82, 0x22, 0xd9, 0x97, + 0x7d, 0x26, 0xeb, 0x5a, 0x18, 0x7d, 0x48, 0x33, 0x42, 0x8b, 0xe5, 0x15, + 0x16, 0xe2, 0xb0, 0x51, 0x5c, 0x15, 0x1d, 0x03, 0x22, 0x45, 0x5c, 0x36, + 0x66, 0x06, 0x02, 0xbf, 0x3a, 0x60, 0xd0, 0x82, 0x5f, 0x61, 0xd1, 0x78, + 0xea, 0x28, 0x65, 0x71, 0x6f, 0x28, 0x9c, 0x1e, 0xf9, 0x99, 0x9f, 0x1e, + 0xc2, 0x73, 0x7c, 0x1b, 0x42, 0x55, 0x2b, 0x94, 0xfe, 0x3c, 0x32, 0x21, + 0x1e, 0x4b, 0xcd, 0xde, 0x97, 0x3c, 0xad, 0xa2, 0xe9, 0x90, 0x5b, 0xaa, + 0x1b, 0xf2, 0xdd, 0x36, 0xb2, 0xa6, 0x46, 0xd1, 0xc9, 0x0d, 0x5b, 0x4a, + 0x29, 0x2a, 0xf4, 0x4a, 0x50, 0xee, 0xd9, 0xff, 0x13, 0x70, 0xad, 0x20, + 0x3f, 0x15, 0xdb, 0x96, 0x4f, 0xa1, 0xed, 0x7d, 0xc5, 0xfc, 0x7e, 0xdf, + 0xa5, 0xb6, 0xe2, 0x1e, 0xca, 0xb1, 0x02, 0x8e, 0xeb, 0xf2, 0xa7, 0xa6, + 0x87, 0xdb, 0x8b, 0xb9, 0x64, 0x5f, 0x51, 0xc6, 0x29, 0x3f, 0x6e, 0x8d, + 0x9a, 0x55, 0xaa, 0x47, 0x55, 0x0e, 0x3b, 0x0a, 0x39, 0x82, 0xaf, 0xe0, + 0xae, 0xb0, 0xf5, 0x84, 0xe0, 0x2a, 0x88, 0x92, 0xa1, 0x2c, 0x27, 0xdd, + 0x8e, 0x34, 0xb5, 0xcd, 0x9c, 0x12, 0x65, 0xc1, 0x1a, 0x47, 0x62, 0xde, + 0xcb, 0x60, 0x5b, 0xa1, 0x07, 0x61, 0xc6, 0xaf, 0xe8, 0x94, 0x6f, 0x84, + 0xd2, 0xd3, 0xa7, 0x22, 0x7e, 0xb0, 0x69, 0xee, 0x9c, 0xa6, 0x6d, 0x9b, + 0x91, 0xb3, 0x8e, 0x81, 0x0b, 0xe2, 0x66, 0xb9, 0x6c, 0xa2, 0x0c, 0x30, + 0x90, 0xa8, 0xc6, 0xa1, 0xe7, 0xf7, 0x99, 0x15, 0xb8, 0x4e, 0xb4, 0xcd, + 0xfb, 0xc7, 0x68, 0x2a, 0xa7, 0x55, 0xd5, 0x3c, 0x1e, 0x9c, 0xc8, 0xb4, + 0x5b, 0x9e, 0x84, 0xd1, 0x5e, 0x83, 0xef, 0xd6, 0xd3, 0xab, 0x7b, 0xb5, + 0x9c, 0x3d, 0xa5, 0x80, 0xde, 0xbb, 0xe6, 0x68, 0x41, 0xe8, 0x31, 0x65, + 0x24, 0x56, 0x22, 0xc2, 0xa6, 0xef, 0x0b, 0x0d, 0xb4, 0x23, 0x40, 0x4d, + 0x64, 0x19, 0x0b, 0x1d, 0xda, 0x0a, 0xc8, 0x27, 0xd6, 0x5f, 0x31, 0x47, + 0x21, 0x46, 0x8d, 0xde, 0x11, 0xd3, 0x8e, 0x7e, 0x60, 0x9a, 0x16, 0x0a, + 0x3c, 0x37, 0xb3, 0x76, 0x8a, 0xe7, 0x39, 0x90, 0x15, 0x03, 0x09, 0x4b, + 0xc5, 0xd0, 0x5b, 0x3c, 0xa0, 0x42, 0x17, 0x03, 0x36, 0x35, 0x8a, 0xc4, + 0x3c, 0xce, 0x55, 0x63, 0x7f, 0xcc, 0x66, 0x60, 0x58, 0xd2, 0xbe, 0x18, + 0xa5, 0x46, 0x1a, 0x56, 0xda, 0x29, 0xc5, 0xbb, 0x84, 0xee, 0x5e, 0x9d, + 0xac, 0x85, 0x92, 0xc2, 0x6c, 0xcb, 0xb5, 0x0f, 0x18, 0x66, 0xb1, 0x66, + 0xfa, 0xac, 0xd1, 0x30, 0x2d, 0xd5, 0x52, 0xe1, 0x66, 0x52, 0x88, 0xf8, + 0xf4, 0xe0, 0x3a, 0x46, 0x38, 0xa9, 0xed, 0xd6, 0x18, 0x17, 0xb7, 0x81, + 0x9f, 0x5f, 0x66, 0x69, 0xf3, 0x88, 0x88, 0x78, 0x84, 0x46, 0xf0, 0x45, + 0x02, 0x6d, 0x41, 0x05, 0x31, 0xcf, 0x70, 0x51, 0xa9, 0x51, 0x4e, 0xd3, + 0x9f, 0x48, 0x63, 0x58, 0x3e, 0xc1, 0x7e, 0x77, 0x37, 0xd5, 0xe0, 0x10, + 0x8f, 0x0b, 0xa5, 0x63, 0xdb, 0x9e, 0x73, 0x67, 0x0c, 0x2b, 0x14, 0xcd, + 0x27, 0x26, 0x12, 0x31, 0xf2, 0x39, 0xda, 0xdd, 0xa4, 0x6f, 0xf5, 0x83, + 0xb3, 0xe3, 0x19, 0x13, 0x76, 0xb0, 0x72, 0x0d, 0xc5, 0x11, 0x02, 0x67, + 0x1d, 0x2d, 0x05, 0x69, 0x42, 0x74, 0x9a, 0x68, 0x98, 0xa1, 0x05, 0xf1, + 0xb4, 0xdb, 0x4c, 0xdb, 0x12, 0x38, 0x24, 0x02, 0x7a, 0xa4, 0x8b, 0xb7, + 0x89, 0x05, 0x44, 0xea, 0xe7, 0x74, 0xe5, 0x1d, 0x25, 0x7d, 0xa4, 0x5a, + 0x15, 0x73, 0xd5, 0x33, 0xe1, 0x4a, 0x35, 0xba, 0x4b, 0x29, 0xad, 0x05, + 0x14, 0x1c, 0xdc, 0x40, 0x56, 0x1e, 0xee, 0xe5, 0x1a, 0x5d, 0xac, 0xa2, + 0x4c, 0x02, 0x35, 0x9e, 0x2e, 0x0a, 0xe1, 0xbb, 0x96, 0x04, 0xf2, 0x91, + 0x67, 0x51, 0xda, 0x7a, 0x43, 0xad, 0xc2, 0x2b, 0x19, 0x88, 0x4d, 0x45, + 0x53, 0x85, 0x03, 0xcc, 0x22, 0x38, 0xac, 0x9e, 0x8b, 0x06, 0xe1, 0x0a, + 0x24, 0xc5, 0xce, 0x45, 0x9c, 0x91, 0x9b, 0xc8, 0xd3, 0x3a, 0x0c, 0xc4, + 0xe5, 0x59, 0xf9, 0x26, 0x49, 0x88, 0xa6, 0x7d, 0x19, 0xa5, 0xcf, 0xc9, + 0xc7, 0x8a, 0x6f, 0x79, 0xff, 0x65, 0x05, 0x28, 0x93, 0x52, 0x9b, 0x0a, + 0xc2, 0xe2, 0x72, 0xf4, 0x39, 0x95, 0xe3, 0x93, 0x6a, 0xd2, 0xcd, 0x98, + 0x84, 0x12, 0x04, 0x0b, 0x8a, 0xec, 0x0b, 0x7d, 0x3b, 0x5e, 0x6a, 0x8d, + 0x62, 0xb4, 0xae, 0x35, 0x6f, 0xba, 0x79, 0xc6, 0x8d, 0x17, 0xf1, 0x29, + 0x19, 0xfd, 0x74, 0x53, 0x96, 0x29, 0xcd, 0x20, 0x2a, 0x6b, 0xc8, 0xd3, + 0xe1, 0x88, 0x79, 0x67, 0xc4, 0x57, 0xb5, 0xa7, 0xa1, 0x05, 0x87, 0x65, + 0xc8, 0xe4, 0x74, 0x94, 0x06, 0x68, 0xac, 0xaa, 0x63, 0xba, 0xda, 0xf1, + 0xec, 0xee, 0x09, 0x10, 0x28, 0x19, 0xa2, 0x76, 0xf8, 0xf3, 0xe5, 0x10, + 0x96, 0x08, 0x5c, 0xd1, 0x18, 0x72, 0x15, 0xea, 0x5b, 0x0c, 0x8a, 0xd0, + 0xb5, 0x15, 0xe8, 0x0f, 0x1b, 0x3c, 0x51, 0xb3, 0xf8, 0x9b, 0x40, 0x1f, + 0x4d, 0xce, 0x69, 0x92, 0x70, 0x7b, 0x53, 0x2a, 0xaf, 0x7a, 0x12, 0x97, + 0x4c, 0x9d, 0x37, 0xb5, 0x26, 0x49, 0xc5, 0xe0, 0x7b, 0xfb, 0xac, 0x62, + 0x31, 0x05, 0x7f, 0xdf, 0xf9, 0x64, 0x4d, 0x63, 0xf9, 0x76, 0x92, 0xfd, + 0x99, 0xe2, 0x12, 0x76, 0x9d, 0xa5, 0xb2, 0x3b, 0x34, 0x3b, 0x92, 0x9a, + 0x20, 0x34, 0xbc, 0xc1, 0x2f, 0x23, 0x63, 0x0e, 0x21, 0x74, 0x67, 0x49, + 0x80, 0x90, 0xbd, 0x8f, 0x28, 0x05, 0xf9, 0x1e, 0x53, 0xed, 0x85, 0xf0, + 0x01, 0x54, 0xc3, 0xe3, 0x56, 0xa5, 0x63, 0x51, 0x09, 0x0b, 0xc2, 0x3c, + 0x96, 0x64, 0xa8, 0xb9, 0xbb, 0xad, 0x45, 0x52, 0x12, 0xc0, 0x0f, 0x32, + 0x91, 0x36, 0x2c, 0xea, 0x29, 0xc7, 0x12, 0xe0, 0x95, 0x8e, 0xc9, 0x09, + 0x82, 0x47, 0xdd, 0xbe, 0x45, 0xdb, 0xaf, 0x32, 0xff, 0xb2, 0x66, 0x2d, + 0x09, 0xc2, 0x31, 0x1d, 0x6f, 0xab, 0xf7, 0x3b, 0x25, 0x17, 0x4e, 0xb5, + 0x79, 0x00, 0xd2, 0x8a, 0xe9, 0x0b, 0x91, 0x17, 0xd2, 0xd6, 0x29, 0x1b, + 0x2c, 0x51, 0xaa, 0x2f, 0x72, 0xe4, 0x69, 0xef, 0xf9, 0x2b, 0x39, 0x97, + 0x1f, 0x9d, 0xe6, 0x9d, 0xfd, 0x65, 0x06, 0x5b, 0x98, 0xfd, 0x6a, 0xfa, + 0xa9, 0x0c, 0xf1, 0x2d, 0xce, 0xa5, 0xe2, 0x08, 0x86, 0x85, 0x60, 0xc2, + 0xec, 0x15, 0x72, 0x86, 0x7d, 0x03, 0xdd, 0x86, 0x18, 0xce, 0x39, 0xa9, + 0x8a, 0x55, 0xce, 0xb8, 0x61, 0x52, 0x1e, 0x75, 0x27, 0xf4, 0xe3, 0x89, + 0xbb, 0x02, 0xd1, 0x42, 0x86, 0x3c, 0x3d, 0xd2, 0xc0, 0xba, 0x4c, 0xca, + 0x4a, 0xcb, 0x90, 0xb5, 0x12, 0x18, 0xab, 0xb9, 0x01, 0x44, 0xf8, 0x90, + 0x64, 0x97, 0xd2, 0x32, 0x0f, 0x15, 0xa0, 0x62, 0xea, 0x14, 0xa3, 0x72, + 0xc6, 0x84, 0xb2, 0x3f, 0xc9, 0x68, 0xa9, 0x2a, 0xaf, 0x29, 0x7f, 0xbb, + 0x3e, 0xa8, 0x17, 0x66, 0x0e, 0x81, 0x34, 0x6d, 0xa7, 0x7e, 0xb1, 0x22, + 0xaa, 0x8a, 0x5b, 0x21, 0xef, 0x4c, 0xe6, 0xbf, 0xc7, 0x2a, 0x22, 0x62, + 0x76, 0xb9, 0x49, 0x8e, 0x2f, 0xe7, 0x01, 0xf5, 0x98, 0x13, 0x72, 0x10, + 0x55, 0x1d, 0x61, 0x3e, 0xb9, 0x67, 0x67, 0x1d, 0xc4, 0x47, 0xaf, 0xba, + 0x07, 0x5c, 0x32, 0x78, 0x87, 0x29, 0xd0, 0xab, 0xcc, 0xcf, 0xf6, 0x38, + 0xeb, 0x16, 0x2c, 0xb6, 0x27, 0x60, 0xf0, 0xe2, 0xbd, 0xfb, 0x43, 0xd9, + 0x90, 0xaf, 0x6b, 0xd5, 0xec, 0x18, 0x95, 0xe5, 0x27, 0xa0, 0x8b, 0x84, + 0x1d, 0x0f, 0x25, 0x37, 0xcd, 0x66, 0x32, 0x28, 0x02, 0xea, 0xfa, 0x31, + 0xa7, 0x95, 0x31, 0x39, 0xbe, 0xcc, 0xf7, 0xe5, 0x26, 0xe2, 0xad, 0x5b, + 0x42, 0xac, 0xf2, 0xbe, 0x26, 0x82, 0x0f, 0x56, 0x5b, 0x4e, 0xc4, 0xa3, + 0x63, 0x0b, 0x44, 0xf8, 0xe9, 0x84, 0xd3, 0x54, 0x29, 0x74, 0xac, 0x87, + 0xff, 0x1d, 0x33, 0x76, 0x07, 0x1f, 0xd6, 0x38, 0x98, 0xf9, 0xc9, 0x04, + 0x7f, 0x5c, 0x75, 0x02, 0x6d, 0xa3, 0x54, 0x15, 0xe4, 0x2c, 0xea, 0x2a, + 0x98, 0x48, 0x7c, 0x02, 0x79, 0xcc, 0x1f, 0x42, 0x5c, 0xaf, 0x54, 0x84, + 0x09, 0x6b, 0xda, 0xed, 0x9b, 0x84, 0x58, 0xdd, 0xac, 0x3b, 0x08, 0x42, + 0xbe, 0xc1, 0x47, 0x3d, 0x02, 0x18, 0x2a, 0x23, 0x89, 0xa3, 0x90, 0x65, + 0x49, 0x99, 0xc1, 0x88, 0xcc, 0x8f, 0x00, 0x19, 0x50, 0x9f, 0xce, 0x9a, + 0xae, 0xf8, 0x56, 0xb6, 0x13, 0x1d, 0xcb, 0x51, 0x6d, 0xc4, 0xc7, 0xf5, + 0xa1, 0xf9, 0x9b, 0x98, 0xc1, 0xa8, 0x96, 0x6c, 0x75, 0x6f, 0x57, 0xe5, + 0xc9, 0x9a, 0x6e, 0xf9, 0xd8, 0xc6, 0x11, 0xc8, 0x73, 0x36, 0xc6, 0x4b, + 0x5d, 0xb9, 0x94, 0xfd, 0x7b, 0x2f, 0xe3, 0xff, 0x3b, 0x55, 0x54, 0x26, + 0x6d, 0x92, 0x10, 0x28, 0xbb, 0x25, 0x06, 0x29, 0x85, 0x5c, 0x74, 0x39, + 0xc8, 0x57, 0x9a, 0x00, 0xbd, 0xb4, 0x17, 0x0a, 0x9f, 0x2e, 0x75, 0xc6, + 0xa2, 0xc1, 0xab, 0x9b, 0x08, 0xb8, 0xe4, 0xdc, 0xc5, 0xb3, 0x4f, 0x05, + 0xcf, 0x42, 0x88, 0x4a, 0xf8, 0xbf, 0xbb, 0xb8, 0x91, 0xb9, 0xfe, 0x06, + 0xdb, 0x32, 0xdb, 0x0f, 0x13, 0x05, 0xaf, 0xba, 0x40, 0x55, 0x7a, 0xe0, + 0x04, 0x25, 0xe6, 0xd7, 0xca, 0x63, 0x70, 0xaa, 0x2b, 0x95, 0x1a, 0xce, + 0xfb, 0x89, 0x12, 0x87, 0x55, 0x10, 0x52, 0x3e, 0x29, 0x83, 0xd0, 0xa9, + 0x05, 0x48, 0x69, 0x5c, 0x68, 0xe4, 0x44, 0xf4, 0xb9, 0xe0, 0xf2, 0x1c, + 0x35, 0x4d, 0xc6, 0xb0, 0xfb, 0x06, 0x02, 0x06, 0x3f, 0xa6, 0x96, 0x18, + 0x57, 0x6a, 0xd6, 0xc1, 0x52, 0x11, 0xbc, 0xd2, 0x22, 0x4f, 0xd4, 0xc5, + 0x1b, 0xe0, 0x64, 0x30, 0x02, 0x10, 0x47, 0x92, 0x30, 0x5e, 0x7b, 0xd1, + 0xb2, 0xc7, 0x9b, 0xd5, 0xa5, 0xfb, 0x13, 0xea, 0xf9, 0x0c, 0x1b, 0x66, + 0x19, 0xcf, 0x08, 0x7a, 0x3e, 0xb0, 0x72, 0x5d, 0xeb, 0x12, 0xbe, 0xe7, + 0x79, 0x51, 0x28, 0xd3, 0xaa, 0xd7, 0x42, 0x76, 0x07, 0x92, 0x24, 0x48, + 0xce, 0xc6, 0x62, 0x54, 0xf7, 0x92, 0x2a, 0xe2, 0x6e, 0x8e, 0xb3, 0xd0, + 0xbb, 0x16, 0x32, 0xf7, 0x61, 0xd4, 0x24, 0x1b, 0xca, 0x5a, 0xb8, 0xd6, + 0x8f, 0x2c, 0xc9, 0x12, 0x20, 0x5a, 0xd5, 0xa0, 0xa3, 0x0a, 0x09, 0xc7, + 0xb8, 0x76, 0x8f, 0x3f, 0xb3, 0xd2, 0xbb, 0x69, 0x96, 0xca, 0x24, 0x76, + 0x01, 0x21, 0xa0, 0x38, 0x42, 0xc7, 0x29, 0x7e, 0xa1, 0x84, 0x1f, 0x11, + 0x2c, 0xab, 0x43, 0x70, 0xe9, 0x53, 0x4d, 0x51, 0xa1, 0x16, 0x4a, 0x46, + 0xf8, 0xd0, 0xf9, 0x6c, 0xe5, 0x3c, 0xd9, 0xcb, 0xd1, 0xc8, 0xaf, 0x90, + 0x62, 0xf4, 0x46, 0x10, 0xbe, 0x11, 0x6e, 0xdd, 0xb2, 0xd0, 0xf4, 0x44, + 0xef, 0xf9, 0x88, 0xb0, 0xcb, 0xac, 0x71, 0xf8, 0xad, 0xd7, 0xe7, 0x8d, + 0xe9, 0x2b, 0x3b, 0x6b, 0x48, 0xe1, 0xb0, 0xf2, 0x7b, 0xb7, 0xa4, 0x5c, + 0x38, 0xe8, 0xee, 0xa5, 0xb9, 0x21, 0x46, 0x76, 0xb5, 0x6e, 0x7e, 0xaa, + 0x9f, 0x3b, 0xd0, 0xe2, 0x27, 0xf2, 0xa1, 0xa3, 0x15, 0x0a, 0xef, 0xe4, + 0xbf, 0x59, 0x2b, 0x27, 0xfd, 0x3d, 0x43, 0xd9, 0x5c, 0x5a, 0xe4, 0x10, + 0x00, 0x62, 0xd4, 0x14, 0x37, 0x42, 0x59, 0xd6, 0x41, 0xbd, 0xf5, 0x2d, + 0x1f, 0x81, 0x1f, 0x68, 0x09, 0xbb, 0x65, 0x63, 0x05, 0xe0, 0x8d, 0x23, + 0xac, 0xe8, 0x8d, 0xa3, 0xc8, 0x43, 0xd7, 0x4f, 0xe7, 0x8b, 0xae, 0x2a, + 0x65, 0x2c, 0x27, 0x55, 0x43, 0xe3, 0x21, 0xf5, 0x75, 0x26, 0x4e, 0xd1, + 0xda, 0xd3, 0x4a, 0x7c, 0xae, 0xc8, 0x16, 0xd2, 0xbc, 0x33, 0x53, 0xcb, + 0x27, 0x6c, 0x26, 0xe3, 0xc9, 0x4a, 0xbf, 0x76, 0x46, 0xa5, 0xe8, 0x0b, + 0xd2, 0x21, 0xc6, 0xf7, 0xd5, 0x01, 0x51, 0x9b, 0x6f, 0xd6, 0xb2, 0xe4, + 0xd8, 0xd6, 0xb0, 0xdf, 0xda, 0x9d, 0xea, 0x61, 0x15, 0xce, 0x36, 0x7f, + 0x7d, 0x5e, 0x08, 0x91, 0xf1, 0xa1, 0x3b, 0xd7, 0x32, 0x1c, 0xf8, 0x30, + 0x31, 0xd8, 0x16, 0x8f, 0x0a, 0x1d, 0xbe, 0xcd, 0x51, 0xe7, 0x1e, 0xf6, + 0x73, 0x0e, 0x02, 0xaf, 0x40, 0xdb, 0x02, 0x8e, 0xe4, 0x8c, 0x86, 0x2a, + 0x8b, 0x6d, 0xdb, 0x45, 0xcd, 0xa1, 0x6a, 0x1d, 0xcb, 0x3d, 0x60, 0xdf, + 0xdc, 0xe8, 0xc1, 0x1d, 0x47, 0x2d, 0xd8, 0x57, 0xe1, 0xc9, 0x85, 0x5f, + 0x56, 0xef, 0x21, 0xb7, 0xd1, 0x7a, 0x80, 0x8b, 0x77, 0x7c, 0x44, 0x73, + 0xac, 0xcd, 0xb9, 0xdd, 0xa2, 0x3b, 0xfa, 0xa1, 0x79, 0x6a, 0xd1, 0x9c, + 0x43, 0x9c, 0x2e, 0x07, 0x2f, 0x6d, 0xa5, 0xb6, 0x7b, 0x55, 0x9b, 0x42, + 0x27, 0x9c, 0x30, 0x1e, 0x42, 0xde, 0xce, 0x86, 0x39, 0x11, 0x35, 0x27, + 0xcf, 0x61, 0x74, 0x10, 0x7b, 0xe2, 0x5c, 0x2e, 0x2f, 0xf0, 0x11, 0x3f, + 0xf8, 0x33, 0x5c, 0x02, 0x93, 0xae, 0x2f, 0x8b, 0xfb, 0x08, 0xcb, 0xa2, + 0xe7, 0xe9, 0x04, 0x04, 0x40, 0x59, 0xe2, 0x69, 0xaa, 0x73, 0x13, 0x66, + 0x66, 0xd0, 0xb7, 0x6d, 0xdc, 0x2a, 0xa8, 0xf3, 0xaa, 0x54, 0x8e, 0x82, + 0x08, 0x84, 0x8f, 0x96, 0x12, 0x84, 0x15, 0x01, 0x60, 0x92, 0xff, 0xf8, + 0x3d, 0x08, 0x13, 0x2b, 0x11, 0x77, 0x4e, 0xf0, 0x00, 0xe7, 0x00, 0xef, + 0x00, 0xec, 0x00, 0xd8, 0x00, 0xdf, 0x00, 0x1f, 0x00, 0x44, 0x00, 0xe6, + 0xb3, 0x3b, 0x9e, 0x3a, 0xdb, 0x86, 0x7e, 0x59, 0x7a, 0x4e, 0x06, 0x83, + 0x2a, 0x3c, 0xb3, 0x81, 0x99, 0x9c, 0x28, 0x00, 0x91, 0x4a, 0x26, 0xdf, + 0x47, 0x79, 0xcd, 0x82, 0xbc, 0xdc, 0x49, 0xae, 0xce, 0x51, 0x47, 0x2d, + 0x34, 0xc2, 0xba, 0x08, 0x2d, 0x69, 0xfe, 0x9e, 0x36, 0x5a, 0x8f, 0x2f, + 0xb2, 0xe6, 0x22, 0x66, 0xdd, 0xb5, 0x2c, 0x13, 0x55, 0x39, 0xd7, 0xa6, + 0x12, 0x73, 0x5e, 0x75, 0xf3, 0x7c, 0x04, 0xaf, 0x99, 0x53, 0x04, 0x40, + 0xfe, 0xba, 0x10, 0x5a, 0x3e, 0x16, 0x8b, 0x58, 0x94, 0x99, 0x3f, 0x20, + 0x17, 0x68, 0x5a, 0x5d, 0x05, 0xa7, 0xdf, 0x86, 0x82, 0x0e, 0xb4, 0xda, + 0xba, 0x13, 0x29, 0x13, 0xa3, 0xd0, 0xc2, 0xc1, 0xbc, 0x10, 0xc6, 0xb3, + 0x3b, 0x4f, 0x7b, 0xfe, 0x95, 0x4f, 0x54, 0xee, 0x53, 0xe6, 0x28, 0xb3, + 0x9a, 0xc0, 0xe7, 0xf6, 0x68, 0x89, 0xcb, 0x45, 0xed, 0xa0, 0x04, 0x2a, + 0x71, 0x80, 0x77, 0xe7, 0xeb, 0xb9, 0xfc, 0xfa, 0x66, 0x9d, 0x53, 0x06, + 0x49, 0x89, 0x5c, 0x34, 0x13, 0x5e, 0x0b, 0xe3, 0x8d, 0x09, 0x13, 0xb5, + 0xfb, 0x1c, 0xd9, 0x8e, 0x5d, 0x17, 0x2d, 0x4f, 0xd5, 0x72, 0x38, 0x4b, + 0x99, 0xeb, 0xda, 0xda, 0xc8, 0xa2, 0xc0, 0xc3, 0xe8, 0x80, 0xeb, 0x38, + 0xed, 0x59, 0x11, 0x26, 0x06, 0x06, 0x97, 0x73, 0x02, 0xac, 0xc8, 0x15, + 0x6c, 0x2d, 0x54, 0xa7, 0xa9, 0x19, 0x01, 0xce, 0x24, 0x06, 0xdc, 0xc1, + 0x7b, 0x48, 0xee, 0x1a, 0x7a, 0x8d, 0x35, 0x2f, 0x27, 0xe6, 0x81, 0x97, + 0x2d, 0xce, 0x92, 0xbf, 0xbf, 0x59, 0x85, 0xf4, 0xb5, 0x94, 0x3b, 0xa0, + 0x18, 0xa4, 0x21, 0x95, 0xed, 0xff, 0x39, 0xa9, 0x41, 0xfb, 0x77, 0x7e, + 0x0f, 0x82, 0xee, 0x0e, 0xc4, 0x5f, 0x3f, 0xda, 0xda, 0xb4, 0x49, 0x23, + 0xed, 0xff, 0xb7, 0x2e, 0x86, 0x0b, 0xfa, 0xbb, 0x13, 0x81, 0xf2, 0x02, + 0x35, 0x2a, 0x21, 0x15, 0x0c, 0x53, 0xd5, 0x77, 0x55, 0x60, 0xa6, 0xe3, + 0xe3, 0x07, 0xf8, 0xd0, 0xaa, 0x98, 0x32, 0x1c, 0xb6, 0xf8, 0x18, 0x67, + 0x4c, 0x29, 0x49, 0x2f, 0xcc, 0x8c, 0x3d, 0xc6, 0xd0, 0x9f, 0x60, 0x14, + 0xb8, 0x66, 0xbe, 0xee, 0xc1, 0x74, 0x0c, 0x4e, 0xa4, 0x8b, 0xcd, 0x46, + 0xe2, 0x50, 0x53, 0x11, 0x90, 0x4d, 0xb6, 0x40, 0x87, 0x85, 0xa3, 0x61, + 0x62, 0x41, 0x8f, 0xdf, 0xa6, 0x0c, 0x11, 0x88, 0x45, 0x13, 0xff, 0x74, + 0x30, 0x1f, 0x54, 0x7b, 0xe4, 0x11, 0x74, 0x37, 0x9b, 0xd4, 0x65, 0x71, + 0x69, 0xde, 0x58, 0xee, 0xb6, 0x52, 0xdb, 0x29, 0x7d, 0xd6, 0x71, 0x12, + 0x25, 0x7c, 0x56, 0xa9, 0x60, 0x84, 0xaf, 0x4a, 0x7c, 0x32, 0x0c, 0xde, + 0xce, 0x4b, 0x18, 0x16, 0x41, 0xe0, 0x86, 0xed, 0x96, 0xdd, 0xcf, 0x73, + 0xbc, 0xa5, 0x9a, 0x59, 0xf7, 0x3d, 0x1e, 0xf6, 0x1e, 0xc6, 0x02, 0xd0, + 0xf9, 0xa3, 0xfa, 0x17, 0xe3, 0xcc, 0x65, 0xa6, 0x1b, 0x88, 0xc0, 0x29, + 0x41, 0x50, 0xbc, 0x60, 0x14, 0xe8, 0x1a, 0xd0, 0x3a, 0x8b, 0x5e, 0xa4, + 0xca, 0xda, 0x65, 0x31, 0x99, 0xc4, 0xa2, 0x07, 0xe1, 0x8d, 0xa4, 0xd7, + 0xb6, 0x52, 0xc6, 0xea, 0x83, 0x78, 0x49, 0xa0, 0xf3, 0x1a, 0xef, 0xe9, + 0x0d, 0xc2, 0x27, 0x04, 0x93, 0x52, 0x44, 0xca, 0x6e, 0xd9, 0x71, 0x89, + 0x52, 0x9b, 0x29, 0x39, 0xa9, 0x95, 0xf5, 0x6c, 0xa8, 0x93, 0xa8, 0xf9, + 0xaf, 0xb0, 0xda, 0xdb, 0x62, 0xfd, 0x65, 0x3f, 0x10, 0x27, 0xdb, 0x40, + 0x4c, 0xae, 0x7e, 0x41, 0x86, 0x97, 0xbb, 0xeb, 0xcd, 0x16, 0xce, 0x31, + 0x03, 0xd3, 0xa3, 0x56, 0x22, 0x66, 0x5d, 0x74, 0x17, 0xcb, 0x7e, 0xba, + 0x40, 0xa0, 0xe0, 0x72, 0x46, 0x6e, 0x37, 0x96, 0xc4, 0x2b, 0xa0, 0x64, + 0x77, 0x8b, 0x57, 0xec, 0x85, 0x8b, 0x5e, 0x4b, 0x2d, 0x2d, 0xa6, 0xbd, + 0x78, 0xac, 0x80, 0x56, 0x66, 0x81, 0x0f, 0x47, 0xee, 0x68, 0x84, 0x95, + 0x7f, 0x97, 0x0a, 0x61, 0xf0, 0xdc, 0xe2, 0x11, 0xe6, 0x2a, 0x14, 0xa1, + 0xc9, 0xba, 0x1a, 0x89, 0xc9, 0xd1, 0xc2, 0x06, 0x6b, 0x91, 0x31, 0x0f, + 0x5f, 0xe8, 0x5c, 0x2b, 0xda, 0xd1, 0x5c, 0x41, 0x50, 0x51, 0xa7, 0xb5, + 0xf4, 0x91, 0x81, 0x5b, 0x92, 0x43, 0xfb, 0xb3, 0x3d, 0x8b, 0x19, 0x75, + 0xc1, 0x54, 0xdd, 0x74, 0x36, 0x38, 0x0c, 0x60, 0x0b, 0x25, 0x0e, 0x81, + 0x81, 0xa6, 0x30, 0xa8, 0x32, 0xb2, 0x6a, 0xb0, 0xad, 0x0a, 0xdd, 0xb8, + 0x38, 0xf4, 0x55, 0xab, 0x65, 0xbb, 0x82, 0x1d, 0xc8, 0x65, 0xf5, 0xc8, + 0x37, 0xea, 0x07, 0xff, 0x49, 0x4c, 0x18, 0x9e, 0xf9, 0xfe, 0x8d, 0xc5, + 0x4f, 0x98, 0xd5, 0xbb, 0x40, 0xbe, 0x8e, 0xe0, 0x17, 0xc5, 0x0a, 0x2c, + 0x3e, 0x36, 0x28, 0x14, 0x75, 0xca, 0xfd, 0x8f, 0x7b, 0x56, 0x2e, 0xac, + 0xa9, 0xfb, 0xb3, 0xb0, 0x12, 0xa1, 0x34, 0x95, 0x72, 0xf2, 0x70, 0xc2, + 0x5b, 0xe2, 0x5c, 0x87, 0xf4, 0x50, 0xd5, 0xaf, 0x3a, 0x7a, 0x35, 0x30, + 0x51, 0xd9, 0x38, 0x18, 0x6c, 0xd1, 0xc1, 0x48, 0xf7, 0xe3, 0x79, 0x5e, + 0xe8, 0x5c, 0xb5, 0x48, 0xfb, 0x27, 0x2e, 0x34, 0xfa, 0x96, 0xa9, 0x21, + 0x22, 0xba, 0x69, 0x7e, 0xa3, 0xc2, 0x58, 0xd8, 0x2d, 0x99, 0x7b, 0xfb, + 0xca, 0x1b, 0xa4, 0x88, 0xb6, 0xf3, 0x54, 0xf4, 0x24, 0x93, 0x98, 0xc7, + 0xc5, 0xa7, 0x0c, 0xc4, 0xe9, 0xe2, 0xa5, 0xce, 0xd2, 0xad, 0x4e, 0x95, + 0x5f, 0xbe, 0x25, 0x34, 0x29, 0x1e, 0x63, 0x90, 0x8e, 0x36, 0x78, 0x51, + 0x96, 0xaa, 0x39, 0xfa, 0x5f, 0xac, 0x9c, 0x2d, 0xf5, 0x7e, 0x35, 0x96, + 0x84, 0x9d, 0x12, 0xda, 0x3e, 0x34, 0x62, 0x25, 0x13, 0x35, 0x46, 0xf8, + 0xfa, 0x92, 0x67, 0x76, 0x12, 0xa7, 0xfb, 0x82, 0x69, 0xfd, 0x33, 0x72, + 0xcd, 0x5d, 0x5f, 0x56, 0xc0, 0x50, 0xab, 0xe0, 0x99, 0x9b, 0xfc, 0xeb, + 0x13, 0x92, 0xc0, 0x1f, 0xb7, 0x8c, 0x4b, 0x3a, 0xe1, 0x76, 0x42, 0xba, + 0x57, 0xcf, 0xfd, 0x91, 0x4f, 0xc5, 0x8e, 0x6c, 0xe9, 0x40, 0x15, 0x8d, + 0x73, 0x50, 0x24, 0x6c, 0xc0, 0xad, 0x0d, 0x49, 0xee, 0x37, 0xcf, 0x40, + 0x52, 0xd5, 0x75, 0x7f, 0xdf, 0x31, 0xa3, 0x2a, 0x38, 0x0a, 0xd0, 0x78, + 0xf1, 0xab, 0x8f, 0xe5, 0x6f, 0xaf, 0x0f, 0xed, 0x97, 0x5a, 0x0f, 0xe0, + 0x29, 0x04, 0x2e, 0x01, 0x77, 0xa5, 0xa6, 0x64, 0x42, 0xda, 0x5f, 0xe6, + 0xeb, 0x3e, 0xba, 0xe9, 0x2b, 0x6a, 0x01, 0x7a, 0x46, 0x28, 0xa8, 0x63, + 0xfd, 0xb4, 0x96, 0xaa, 0x2b, 0x2c, 0x74, 0xde, 0x2b, 0xb9, 0x88, 0x5f, + 0x0a, 0xa1, 0x8f, 0xd1, 0x97, 0x48, 0x3e, 0xa7, 0x45, 0x33, 0x3c, 0x6f, + 0x01, 0x07, 0x2a, 0xa4, 0xdd, 0x13, 0x25, 0x9d, 0x94, 0x6a, 0x74, 0x76, + 0xa7, 0x1a, 0xb7, 0xb5, 0x5b, 0x59, 0x0f, 0x8c, 0x2d, 0xab, 0x4b, 0xed, + 0xb0, 0x3b, 0x27, 0x81, 0x53, 0xed, 0xe8, 0xda, 0x23, 0xd0, 0xe3, 0x02, + 0x31, 0xc2, 0x6e, 0x9a, 0xcd, 0x3d, 0x78, 0x90, 0x1d, 0xe8, 0xe7, 0x87, + 0xe4, 0x2f, 0xf4, 0x49, 0xc3, 0x0b, 0xa6, 0x5c, 0x1a, 0x71, 0x51, 0xa6, + 0x45, 0x8c, 0xb1, 0xd9, 0x1e, 0xc4, 0x51, 0x14, 0x63, 0x59, 0x93, 0x5b, + 0x6f, 0x25, 0x9b, 0x5a, 0x37, 0x13, 0x54, 0x57, 0xe0, 0x39, 0x99, 0xcc, + 0xf8, 0x0b, 0x0c, 0x87, 0xa3, 0xfd, 0xac, 0x91, 0xe0, 0xd6, 0x3c, 0x35, + 0x53, 0xc5, 0x04, 0xa3, 0x18, 0x70, 0x65, 0xe7, 0xec, 0xcf, 0x5f, 0x17, + 0x37, 0xae, 0xe6, 0x3d, 0x04, 0x40, 0x47, 0xa4, 0x92, 0x18, 0x89, 0x9b, + 0xb0, 0x79, 0xbe, 0x4d, 0x35, 0x32, 0x15, 0x69, 0xf1, 0x4e, 0x4d, 0x31, + 0xa9, 0x85, 0x19, 0x8a, 0x45, 0x43, 0x01, 0x4d, 0x66, 0x01, 0x9d, 0x27, + 0xbf, 0xd2, 0xd3, 0x4a, 0x52, 0x44, 0x06, 0xc6, 0x9f, 0x52, 0x92, 0xef, + 0x9e, 0x55, 0x81, 0x8a, 0x42, 0x6f, 0x2e, 0x84, 0x6f, 0x8d, 0x3b, 0x29, + 0xce, 0xe1, 0xc7, 0x42, 0xfd, 0x71, 0xd8, 0x4f, 0x69, 0x7e, 0x72, 0x4a, + 0xad, 0x91, 0xed, 0x14, 0x24, 0x1c, 0x60, 0xa4, 0x09, 0x52, 0xa1, 0x61, + 0x01, 0xe2, 0x31, 0x69, 0x4e, 0x26, 0x4a, 0x05, 0x84, 0x93, 0x31, 0xaa, + 0xb6, 0x28, 0xf1, 0x00, 0xae, 0xfc, 0xa7, 0x10, 0x32, 0xa9, 0x6a, 0x25, + 0xc3, 0x1e, 0xc2, 0xb6, 0xf3, 0x8b, 0x52, 0x56, 0x93, 0xab, 0x14, 0xca, + 0x4a, 0x0b, 0xa2, 0x10, 0x84, 0x5b, 0x92, 0x5a, 0xff, 0x13, 0xb9, 0x66, + 0x14, 0xb4, 0x85, 0xa6, 0x59, 0x23, 0x19, 0x8a, 0xd6, 0x87, 0x75, 0x0d, + 0x62, 0x96, 0xaa, 0x11, 0x5d, 0xed, 0x56, 0x97, 0x14, 0x09, 0xe5, 0x05, + 0xb6, 0xb6, 0x5c, 0x88, 0x1f, 0x00, 0x72, 0x13, 0x33, 0x7f, 0x33, 0xcc, + 0x9d, 0x2e, 0x56, 0xfc, 0x92, 0x80, 0x13, 0x47, 0x0c, 0x3e, 0x94, 0xcd, + 0x2d, 0xf0, 0x69, 0x77, 0x2c, 0x29, 0x3b, 0x04, 0x53, 0x92, 0x82, 0x2b, + 0x4f, 0x93, 0x1b, 0x87, 0xc2, 0x8f, 0xe3, 0x9b, 0xbe, 0x62, 0x84, 0x53, + 0xe9, 0xaa, 0x01, 0x7b, 0x74, 0x24, 0x48, 0xd9, 0xaa, 0x98, 0x94, 0x1a, + 0x01, 0xcb, 0x77, 0x8b, 0x90, 0x2d, 0x88, 0xdc, 0x85, 0xf4, 0x5b, 0x73, + 0x14, 0xe2, 0x59, 0x62, 0xa7, 0x35, 0xfb, 0x3a, 0x39, 0x40, 0x8d, 0x4f, + 0xf3, 0x2d, 0x03, 0xbf, 0xd7, 0x68, 0x3b, 0x17, 0x44, 0x72, 0xd5, 0xde, + 0x83, 0x3e, 0x91, 0xf7, 0x1e, 0xb8, 0x8c, 0x20, 0xa0, 0xcb, 0x18, 0xc2, + 0x52, 0x5f, 0x9f, 0x7b, 0x54, 0x16, 0xe7, 0x45, 0x89, 0xf7, 0x34, 0xc7, + 0xe0, 0xc5, 0x96, 0xa0, 0xae, 0x63, 0x9e, 0xf3, 0xec, 0x37, 0x03, 0x23, + 0xb4, 0xdb, 0xcc, 0xcf, 0x24, 0xef, 0x9c, 0xc2, 0x30, 0xd7, 0x96, 0x39, + 0x36, 0xc6, 0xea, 0xb8, 0x2e, 0x8d, 0xbf, 0x61, 0x0a, 0x87, 0x84, 0x27, + 0xe4, 0xa9, 0x22, 0x30, 0x31, 0x60, 0xe3, 0xc8, 0x56, 0x1b, 0x54, 0x45, + 0xf0, 0x28, 0xf4, 0x43, 0x0a, 0xc1, 0xec, 0xbc, 0xc0, 0x6f, 0x5e, 0x3f, + 0xd2, 0x77, 0xc9, 0xa6, 0x24, 0xb2, 0xf3, 0x34, 0xa8, 0xaa, 0x6e, 0x73, + 0x07, 0xa9, 0xc4, 0x3b, 0xb2, 0x37, 0x19, 0x96, 0xb7, 0xa3, 0x0c, 0xcf, + 0xb8, 0x14, 0x17, 0x5a, 0x5c, 0xd9, 0x61, 0x47, 0x3b, 0xea, 0xea, 0xbc, + 0x13, 0xd2, 0x87, 0xe8, 0xc2, 0x8e, 0x5c, 0xca, 0x00, 0x93, 0xc6, 0x2f, + 0x71, 0x20, 0xff, 0x27, 0x99, 0x9a, 0xb4, 0x98, 0xbb, 0x7b, 0x11, 0x26, + 0xaa, 0xd2, 0x3e, 0x20, 0x5c, 0xce, 0xa3, 0xe9, 0xac, 0xf4, 0x6a, 0x57, + 0x55, 0xc6, 0xa4, 0xd5, 0x2c, 0x1e, 0xea, 0x14, 0x02, 0x80, 0xbb, 0x0a, + 0xca, 0x22, 0xcd, 0x7a, 0x2e, 0x24, 0x18, 0x53, 0xf6, 0xe4, 0x20, 0x54, + 0x41, 0x79, 0xb3, 0xb3, 0xb9, 0xe2, 0x7b, 0x4f, 0x7f, 0x88, 0xd3, 0x56, + 0x2f, 0xf1, 0x5c, 0x33, 0xf0, 0x94, 0xba, 0xe3, 0x8a, 0xef, 0x48, 0x1e, + 0x79, 0x99, 0x90, 0xbd, 0x80, 0x95, 0xeb, 0x5c, 0xcd, 0x6a, 0x85, 0x7a, + 0x8e, 0xb6, 0xae, 0x96, 0x99, 0x3a, 0x64, 0x1d, 0xa8, 0x19, 0x94, 0x5a, + 0xdf, 0x85, 0x7b, 0x02, 0xf3, 0xe0, 0x9b, 0x09, 0x6e, 0x19, 0xc6, 0x24, + 0x82, 0x1e, 0x24, 0x62, 0xb4, 0x41, 0xe6, 0xc5, 0x7a, 0x9d, 0xfc, 0x43, + 0x3f, 0xc9, 0xcc, 0x1c, 0x16, 0x11, 0xbe, 0x59, 0xee, 0x52, 0x32, 0x13, + 0xbf, 0xb3, 0x46, 0x11, 0x22, 0x87, 0xb9, 0x0b, 0x49, 0x04, 0xbe, 0x82, + 0x85, 0xcf, 0xdf, 0xe2, 0x76, 0x55, 0xc1, 0x83, 0x42, 0x9c, 0xf5, 0x5a, + 0x67, 0xce, 0x86, 0x2e, 0xe2, 0x3f, 0x98, 0x1e, 0xbd, 0x2b, 0x67, 0x55, + 0x16, 0xaf, 0x9e, 0x85, 0xf8, 0xbf, 0xf3, 0x38, 0xac, 0xd1, 0x0e, 0x98, + 0xed, 0x4b, 0x1c, 0x0f, 0xff, 0x64, 0x2a, 0xff, 0x6b, 0xd9, 0x99, 0x48, + 0x27, 0x6f, 0x47, 0x21, 0xb9, 0x56, 0xdc, 0x88, 0x82, 0x8a, 0x84, 0x19, + 0xdb, 0xa6, 0xde, 0x34, 0x59, 0xe6, 0xc4, 0xe6, 0xc7, 0x77, 0xec, 0x27, + 0x44, 0x31, 0x01, 0x7f, 0x5a, 0xb3, 0xe9, 0x11, 0x6e, 0x2e, 0x2c, 0x6b, + 0xe2, 0x90, 0x6c, 0x8d, 0x41, 0x11, 0x4a, 0xb5, 0x70, 0xf6, 0x03, 0xfc, + 0xe2, 0x31, 0x44, 0x87, 0xe1, 0x58, 0xbd, 0x3b, 0x1c, 0x4e, 0x11, 0x6b, + 0x30, 0x05, 0x17, 0xc1, 0xff, 0x30, 0x90, 0x90, 0x5d, 0xe8, 0x8e, 0x1d, + 0xc1, 0x86, 0x31, 0xc3, 0x7a, 0x81, 0x70, 0x18, 0x02, 0x37, 0x43, 0xe2, + 0x61, 0x42, 0xa7, 0x69, 0x0e, 0xc3, 0xa8, 0xef, 0x7e, 0x8c, 0xc1, 0x72, + 0x34, 0xef, 0x59, 0xc9, 0xee, 0xc7, 0x95, 0x24, 0x0c, 0x0a, 0xbe, 0x32, + 0xb1, 0x68, 0xa6, 0x12, 0xc7, 0x88, 0x74, 0x5d, 0x04, 0x30, 0x74, 0xd3, + 0x8d, 0x08, 0x26, 0x6a, 0x29, 0x34, 0xd6, 0xf3, 0xef, 0x50, 0x7f, 0xb9, + 0x0a, 0xcd, 0xa4, 0xd4, 0x18, 0x81, 0xd0, 0x52, 0x61, 0xe7, 0x66, 0x93, + 0xd5, 0x7b, 0x55, 0xbb, 0x14, 0x6e, 0x71, 0x48, 0x72, 0x48, 0xe5, 0x10, + 0x3c, 0xbe, 0x24, 0x3a, 0x44, 0x6c, 0xfa, 0x83, 0xf3, 0xec, 0x83, 0x63, + 0x9c, 0x4f, 0xd8, 0x51, 0xcd, 0xdc, 0x72, 0xa0, 0xea, 0x67, 0x3d, 0x0c, + 0x20, 0x78, 0xab, 0x5b, 0x70, 0x71, 0x93, 0xf1, 0x9b, 0xcd, 0xf4, 0x3e, + 0xc0, 0x82, 0xce, 0x5f, 0x8c, 0x20, 0x4a, 0x6e, 0x76, 0xfb, 0xe8, 0xff, + 0x6f, 0xd3, 0xc5, 0xdc, 0x72, 0x3f, 0x2c, 0xe1, 0x61, 0x10, 0x1a, 0x43, + 0xb6, 0x04, 0x71, 0x00, 0xe7, 0xa2, 0x63, 0x8a, 0xa0, 0xee, 0x27, 0x6b, + 0x08, 0x95, 0xb3, 0x25, 0x87, 0xb5, 0xfc, 0x33, 0x68, 0x25, 0x8e, 0xe5, + 0x2f, 0x4b, 0x5b, 0x20, 0x08, 0x9f, 0x0c, 0x33, 0x81, 0xeb, 0xb0, 0xad, + 0xd8, 0x39, 0xac, 0x62, 0xe8, 0xab, 0xea, 0xd4, 0x30, 0x24, 0xff, 0xa0, + 0x95, 0x3f, 0xd8, 0x94, 0xb3, 0x24, 0x78, 0x56, 0x3b, 0x27, 0x42, 0x38, + 0xe7, 0x06, 0x4f, 0x92, 0x2b, 0xb2, 0x86, 0xe3, 0x09, 0x34, 0x8c, 0xb2, + 0x4c, 0xd6, 0x44, 0x66, 0xc9, 0xcf, 0xa6, 0xcc, 0x12, 0xd2, 0x6b, 0x70, + 0x58, 0x1f, 0x3f, 0x8f, 0xdb, 0x2f, 0xbd, 0xff, 0xe2, 0x5b, 0x49, 0xb6, + 0x31, 0xd1, 0x77, 0x0c, 0x78, 0xea, 0x64, 0xcf, 0x51, 0x5f, 0xeb, 0x40, + 0x96, 0x7b, 0xd8, 0x9a, 0x30, 0x57, 0xb7, 0x73, 0x8d, 0xe1, 0x57, 0x3d, + 0x8f, 0x31, 0x27, 0x64, 0x07, 0xbd, 0xc0, 0xbb, 0x1b, 0x3f, 0x00, 0x6c, + 0x21, 0x80, 0x5d, 0x72, 0x1e, 0xe1, 0xd6, 0x8a, 0xdb, 0x29, 0x0a, 0xb0, + 0x20, 0xa9, 0xc0, 0x8a, 0xb4, 0xe0, 0x83, 0x4c, 0x21, 0x9d, 0x33, 0x9d, + 0xd0, 0xd8, 0x32, 0x8c, 0xc1, 0x4f, 0xa1, 0xd6, 0x19, 0xb4, 0x6a, 0xcb, + 0x29, 0x3f, 0xe4, 0x30, 0xd9, 0xd1, 0x54, 0xe6, 0x72, 0xdd, 0x57, 0x7a, + 0x30, 0xb9, 0x51, 0x12, 0x62, 0x63, 0x90, 0xbd, 0x54, 0x19, 0x68, 0x87, + 0x34, 0x57, 0xf6, 0xc3, 0x20, 0x9e, 0x52, 0x3c, 0x42, 0xa1, 0x6b, 0x52, + 0xdc, 0xdf, 0xbb, 0x10, 0x8b, 0x8a, 0x24, 0xf5, 0xd5, 0x60, 0x0e, 0xa6, + 0x80, 0x83, 0xda, 0x7b, 0x01, 0xbb, 0x63, 0x6c, 0x46, 0xdb, 0xc0, 0x27, + 0x17, 0xff, 0xf8, 0x3d, 0x08, 0x14, 0x2b, 0x11, 0x61, 0x4e, 0x10, 0x00, + 0x1a, 0x00, 0xf0, 0x00, 0xd7, 0x00, 0xff, 0x00, 0x25, 0x00, 0x14, 0x00, + 0x1e, 0x00, 0xe7, 0x39, 0xfc, 0xc1, 0x22, 0x98, 0xcb, 0xd5, 0xb8, 0xd3, + 0x2e, 0xa9, 0xc2, 0xe1, 0xf7, 0x49, 0x07, 0x97, 0xde, 0x04, 0xa0, 0x46, + 0x6d, 0xe7, 0x57, 0xad, 0x38, 0xc3, 0x6f, 0x4a, 0xf6, 0xea, 0xa5, 0x8f, + 0x04, 0x99, 0x7f, 0x5c, 0x60, 0x2f, 0xb0, 0x1c, 0xbc, 0x2d, 0x1c, 0x48, + 0x55, 0x13, 0x61, 0xb6, 0x61, 0x1a, 0x83, 0xdd, 0x07, 0x24, 0xa4, 0xf6, + 0xfd, 0xe8, 0xcc, 0x99, 0xca, 0x7b, 0xa6, 0x4d, 0x51, 0x3f, 0x31, 0x2d, + 0xf0, 0xe0, 0x3b, 0xfb, 0x7d, 0xb8, 0x92, 0x8d, 0x3d, 0xfb, 0xbc, 0x7a, + 0x48, 0x67, 0x51, 0x3f, 0xf0, 0x3a, 0x9b, 0x15, 0x20, 0x76, 0x28, 0x80, + 0x56, 0xa0, 0x90, 0x82, 0xe2, 0x51, 0x3d, 0xb1, 0x97, 0xf4, 0xba, 0x8d, + 0xa7, 0x11, 0xac, 0x58, 0x98, 0xb2, 0x68, 0x32, 0x0b, 0xfd, 0xd4, 0x3b, + 0x30, 0x13, 0x88, 0x06, 0x45, 0x45, 0xa6, 0x52, 0xe7, 0x80, 0x4c, 0x76, + 0xc9, 0xb3, 0x09, 0xbc, 0x19, 0xcc, 0xa2, 0xae, 0x9a, 0x4c, 0x65, 0x04, + 0x09, 0x05, 0x12, 0x08, 0xff, 0x42, 0x2b, 0xef, 0x33, 0xf7, 0x81, 0xf2, + 0x13, 0x39, 0x41, 0xfc, 0xf9, 0x64, 0xf1, 0x3b, 0x13, 0x67, 0xe4, 0x3e, + 0x6e, 0xe7, 0x67, 0xda, 0xd4, 0xa7, 0xfc, 0x4f, 0x90, 0x4b, 0x74, 0x1b, + 0xd7, 0x40, 0xa8, 0x3e, 0x7c, 0x4d, 0xd1, 0xd3, 0x61, 0x08, 0x29, 0x79, + 0x8b, 0xa5, 0xbe, 0x32, 0x11, 0x2c, 0x14, 0xb2, 0x63, 0xa3, 0xe4, 0x02, + 0xc2, 0xe1, 0x8e, 0xf4, 0xd6, 0x22, 0x75, 0xaf, 0x9c, 0x8f, 0x2b, 0x8a, + 0x09, 0xb6, 0xb6, 0x0f, 0x9d, 0x4f, 0x07, 0x70, 0x21, 0x04, 0xae, 0x36, + 0xbf, 0x6e, 0x8b, 0x60, 0x48, 0x70, 0x5d, 0x08, 0x43, 0xc0, 0xa0, 0xf6, + 0x7b, 0xe3, 0x86, 0xf4, 0x93, 0xde, 0x08, 0xfa, 0x4a, 0x39, 0x35, 0x77, + 0xad, 0xc8, 0xd3, 0xad, 0x16, 0x93, 0xea, 0x4a, 0xec, 0x57, 0x95, 0x8f, + 0x2a, 0x4b, 0x93, 0x72, 0x6b, 0x7b, 0xd0, 0x86, 0xf0, 0xc1, 0xc8, 0x15, + 0x5e, 0x42, 0xb0, 0x0f, 0x5b, 0x62, 0xa8, 0x41, 0x69, 0x87, 0x02, 0x87, + 0x66, 0xac, 0xc8, 0xa8, 0x03, 0xce, 0xcb, 0xb9, 0x2a, 0x9c, 0x40, 0x3c, + 0x60, 0x9f, 0x7f, 0x8a, 0xcc, 0x5a, 0xa7, 0x74, 0xcd, 0x6f, 0x85, 0x24, + 0x56, 0x6d, 0x81, 0xd7, 0x4b, 0xa2, 0xf7, 0x31, 0xcf, 0x93, 0xb1, 0xfb, + 0x95, 0x60, 0x83, 0x60, 0x94, 0x23, 0x2a, 0x10, 0xb4, 0xfe, 0x6e, 0xac, + 0x0a, 0x81, 0x3c, 0xfd, 0x71, 0x0b, 0x41, 0x64, 0x6f, 0x44, 0x7d, 0x33, + 0x9d, 0x2c, 0x36, 0xb0, 0x82, 0x4b, 0x8d, 0x84, 0xf6, 0xd1, 0x75, 0x9b, + 0x13, 0x88, 0x74, 0x96, 0x45, 0x0d, 0xad, 0xa0, 0x02, 0x63, 0x42, 0xf7, + 0x91, 0x9e, 0x2e, 0xf9, 0x55, 0xb7, 0x6e, 0xec, 0x6a, 0x7e, 0x30, 0xfa, + 0xd3, 0xe2, 0x5c, 0x58, 0x4e, 0xf4, 0x94, 0x5d, 0x10, 0x9f, 0x7a, 0xee, + 0xd2, 0x99, 0xd5, 0xb5, 0x3f, 0xeb, 0xdf, 0x7e, 0x9d, 0x5e, 0x8a, 0x15, + 0xd1, 0xa6, 0x5a, 0xd7, 0xd5, 0x34, 0x04, 0x2a, 0x8c, 0x45, 0x03, 0x2d, + 0x8f, 0x7f, 0xfc, 0xd6, 0x21, 0xab, 0x2f, 0x33, 0xe5, 0x35, 0x8d, 0x81, + 0x23, 0xc3, 0x45, 0xfb, 0x0c, 0x7a, 0x56, 0x62, 0x48, 0x21, 0x29, 0x76, + 0x4a, 0x7d, 0x62, 0x22, 0x0b, 0xc9, 0x1c, 0x83, 0x6d, 0xb8, 0x4b, 0x65, + 0xb0, 0x9d, 0x7d, 0x84, 0xc6, 0x48, 0x91, 0x91, 0x35, 0x67, 0x57, 0xfe, + 0x89, 0x79, 0xf9, 0xbb, 0x2c, 0x35, 0x27, 0x73, 0x51, 0x94, 0xd4, 0xa9, + 0x59, 0xee, 0x51, 0x52, 0x04, 0x70, 0x84, 0x12, 0x57, 0xf9, 0x7e, 0xdb, + 0x06, 0x1a, 0x48, 0xad, 0x35, 0x19, 0x65, 0x01, 0x4d, 0xfe, 0xf4, 0xa8, + 0xec, 0x76, 0x2b, 0x76, 0x0d, 0x5a, 0xe1, 0xf6, 0xb7, 0xf0, 0x9a, 0xb0, + 0x55, 0xb7, 0x8c, 0xca, 0x8a, 0x9b, 0x1f, 0x56, 0x41, 0xb6, 0xb5, 0x6b, + 0x6d, 0x4c, 0x1c, 0xde, 0x85, 0xae, 0x86, 0x23, 0xe7, 0xa6, 0xe0, 0xf0, + 0x49, 0x5e, 0xca, 0x59, 0x28, 0x7a, 0x6a, 0x1f, 0x44, 0x95, 0x6c, 0xc9, + 0xe0, 0xee, 0x32, 0x72, 0xf0, 0x85, 0x73, 0x56, 0x4d, 0x1e, 0x1f, 0xd4, + 0xd1, 0x6c, 0x9e, 0xa6, 0x91, 0x04, 0x2c, 0xde, 0x26, 0xd1, 0x3f, 0x6c, + 0xbe, 0x0f, 0x08, 0xe7, 0xd0, 0xc8, 0xfa, 0xe8, 0x68, 0x03, 0x7e, 0x34, + 0x6e, 0xf2, 0xa3, 0x01, 0x1d, 0x9a, 0x89, 0x1e, 0x5e, 0x4c, 0x5a, 0x10, + 0x98, 0xf1, 0x37, 0xe4, 0x81, 0x10, 0x7d, 0xf0, 0x37, 0x57, 0x30, 0xd2, + 0xfd, 0x83, 0xe5, 0x54, 0xa8, 0x61, 0xf2, 0xd0, 0x28, 0x20, 0x3e, 0xb0, + 0x9e, 0xe9, 0x03, 0x64, 0x0f, 0x92, 0x17, 0x8e, 0x98, 0x06, 0xec, 0x5d, + 0xbe, 0xa1, 0xb9, 0x08, 0xf6, 0x11, 0x23, 0xa2, 0xd7, 0xca, 0xc6, 0x32, + 0x11, 0x4a, 0x50, 0x36, 0x96, 0x0f, 0xb3, 0x34, 0x86, 0xde, 0x4c, 0xcc, + 0x74, 0x73, 0x44, 0xab, 0xe2, 0x0b, 0xbb, 0x16, 0x8b, 0xad, 0x7b, 0x10, + 0x95, 0xd5, 0x33, 0xbf, 0x1f, 0x67, 0x6f, 0x06, 0x2a, 0xfa, 0x1c, 0x9c, + 0x4b, 0x82, 0xf3, 0x5d, 0x9b, 0x19, 0xd9, 0xc3, 0x44, 0x65, 0x53, 0x51, + 0x73, 0xf7, 0x9b, 0x19, 0xda, 0x48, 0xb8, 0x48, 0xbb, 0xa4, 0x7c, 0x43, + 0x63, 0x8e, 0xf2, 0xef, 0x86, 0x5f, 0xc5, 0x9c, 0xda, 0xfa, 0xe2, 0x5b, + 0x4d, 0x4d, 0x4e, 0x0c, 0x46, 0x51, 0xea, 0x09, 0x6b, 0xa5, 0x17, 0x93, + 0x05, 0x83, 0xea, 0x63, 0xc7, 0x6f, 0x12, 0xb5, 0x15, 0x5a, 0xc7, 0x5a, + 0xe6, 0xb7, 0xe1, 0x01, 0xb5, 0xec, 0xd3, 0x02, 0x82, 0xd9, 0xdf, 0x3b, + 0x4b, 0x64, 0x01, 0xe8, 0x22, 0xc9, 0x2b, 0x9e, 0x30, 0xc4, 0x57, 0xe1, + 0x27, 0x88, 0x34, 0xf6, 0xd2, 0xe1, 0x7c, 0x09, 0x3c, 0xa8, 0x75, 0xc8, + 0x93, 0x8f, 0xa0, 0xbf, 0xad, 0x4e, 0xa2, 0xb5, 0xf6, 0x41, 0xa4, 0x0c, + 0x06, 0xcc, 0x6b, 0x66, 0x3f, 0xec, 0x62, 0xf0, 0x96, 0x1d, 0x29, 0xf1, + 0xbe, 0xb1, 0x8b, 0xef, 0x87, 0xb6, 0x1a, 0x52, 0xa1, 0x19, 0xed, 0xcc, + 0x4d, 0xe6, 0xe2, 0xd8, 0xde, 0x29, 0xc9, 0xcf, 0xd4, 0xeb, 0xa5, 0x45, + 0x33, 0x3f, 0xd1, 0x8c, 0x48, 0xbb, 0x38, 0x55, 0xe5, 0x70, 0x49, 0x2d, + 0x56, 0x9a, 0xe1, 0x59, 0x2d, 0xd7, 0xfc, 0x49, 0x61, 0x0d, 0xba, 0x70, + 0x4d, 0x0f, 0x99, 0xe2, 0xa8, 0xc1, 0x4e, 0x30, 0x60, 0x41, 0x6c, 0x4f, + 0x06, 0x99, 0xec, 0x8c, 0x39, 0x7e, 0xc7, 0x79, 0x4f, 0xc9, 0x40, 0xdb, + 0xde, 0xe7, 0x90, 0xef, 0xfd, 0xb1, 0xc1, 0x09, 0xbe, 0xb4, 0xdc, 0xdc, + 0x3c, 0xa8, 0xd9, 0x73, 0xe6, 0x59, 0xa7, 0x1b, 0x24, 0x18, 0xfc, 0xba, + 0xf6, 0xe7, 0x5c, 0x54, 0xa6, 0xc5, 0xe0, 0x5c, 0x0d, 0xac, 0xc7, 0x63, + 0x60, 0xbb, 0x4e, 0xa4, 0x0f, 0x29, 0x3f, 0xd7, 0x64, 0xc5, 0x78, 0x5d, + 0x37, 0x17, 0x9a, 0x65, 0x9b, 0x38, 0xba, 0x15, 0x39, 0x81, 0xfd, 0xdb, + 0x73, 0x1b, 0x10, 0xc1, 0x52, 0xa0, 0x84, 0x79, 0xcd, 0x07, 0x28, 0x7e, + 0xa7, 0x6f, 0x13, 0x00, 0x1c, 0xde, 0xce, 0x3f, 0x9b, 0xc4, 0x2c, 0x33, + 0x58, 0x54, 0x97, 0x4d, 0x2c, 0xad, 0xa3, 0xd0, 0x93, 0xbd, 0xac, 0x61, + 0x71, 0x87, 0x7a, 0x52, 0x7f, 0xaf, 0x70, 0x76, 0x57, 0x0d, 0x14, 0x25, + 0x45, 0x1a, 0x54, 0xcb, 0x3c, 0x3c, 0x9b, 0x99, 0xd5, 0x2d, 0x1e, 0x04, + 0xac, 0x2c, 0x77, 0xcb, 0xb7, 0xe4, 0x7c, 0xe3, 0xd0, 0xf3, 0x3a, 0xb8, + 0x2a, 0xf4, 0x66, 0x07, 0xb8, 0x29, 0xdd, 0x59, 0x3e, 0x0d, 0x83, 0xbf, + 0xeb, 0x54, 0x85, 0x34, 0x2f, 0xb3, 0xf7, 0x22, 0x6c, 0xfd, 0x77, 0x4c, + 0x46, 0x69, 0xc8, 0xad, 0x52, 0x4e, 0xc9, 0x4a, 0x8e, 0x9f, 0x84, 0xd9, + 0xe9, 0x57, 0x26, 0x1d, 0x52, 0xc2, 0x9b, 0x86, 0xc3, 0x74, 0x36, 0x5e, + 0xdf, 0x91, 0x56, 0xa1, 0xb9, 0xdf, 0x27, 0x55, 0xc4, 0x7e, 0x5d, 0x16, + 0x9a, 0x35, 0x8b, 0xe3, 0x2c, 0x7d, 0xe5, 0x3c, 0x33, 0x33, 0x13, 0x2f, + 0xed, 0x6d, 0xb6, 0xac, 0x7b, 0x8d, 0x1f, 0x0f, 0x48, 0x66, 0x9f, 0x29, + 0x83, 0x1e, 0xea, 0xe4, 0x83, 0x6e, 0xb4, 0x82, 0x5f, 0x3f, 0x4e, 0x41, + 0x32, 0x8b, 0x39, 0x5f, 0x32, 0xdb, 0x0e, 0x78, 0x50, 0x8e, 0x96, 0xdb, + 0x72, 0x66, 0xcd, 0x46, 0x52, 0xef, 0x0a, 0xee, 0xcf, 0x51, 0x47, 0xa3, + 0xd2, 0xb1, 0x04, 0xf5, 0x55, 0x96, 0x82, 0x82, 0x88, 0x8b, 0x34, 0xa1, + 0x6a, 0xd9, 0x00, 0x41, 0xc2, 0xc3, 0xc6, 0x2a, 0xcb, 0xf9, 0x29, 0x32, + 0xd9, 0x90, 0xaa, 0x18, 0xf8, 0x1b, 0xfa, 0x43, 0x0b, 0xba, 0x23, 0x72, + 0x6d, 0x3a, 0x3c, 0x92, 0x45, 0x78, 0x53, 0xb5, 0xe9, 0x9d, 0xb6, 0x6d, + 0xdc, 0xca, 0x9b, 0x59, 0xac, 0x85, 0xc5, 0x6f, 0x03, 0x40, 0x4e, 0x47, + 0xd6, 0x26, 0xd9, 0x5d, 0x9b, 0x2d, 0xb8, 0x45, 0x88, 0x95, 0x2d, 0x2d, + 0x2b, 0x57, 0x82, 0x56, 0x6d, 0x22, 0xcc, 0x44, 0xe1, 0x9f, 0x69, 0xa4, + 0x78, 0x6d, 0x2b, 0x55, 0xf5, 0x06, 0x25, 0xa6, 0xd4, 0x7b, 0xe9, 0x32, + 0x30, 0x1f, 0x09, 0x84, 0x26, 0x99, 0x2d, 0x5d, 0xb9, 0xeb, 0xc9, 0x99, + 0x4c, 0x89, 0xb1, 0x11, 0x1b, 0xaf, 0x3f, 0x2f, 0x42, 0x4b, 0x0e, 0xff, + 0x4a, 0xdc, 0x03, 0x55, 0x20, 0x92, 0x7a, 0xc2, 0x99, 0xc9, 0x27, 0xb9, + 0xc6, 0x71, 0xf7, 0xa1, 0xe1, 0xe9, 0x12, 0x67, 0x62, 0x2d, 0xd0, 0x20, + 0xb1, 0xf8, 0x96, 0x97, 0xa6, 0xa9, 0x19, 0x3f, 0x1c, 0x92, 0x64, 0x4c, + 0x66, 0x46, 0x62, 0x30, 0x5f, 0xc9, 0x8e, 0x91, 0x5b, 0xd2, 0x59, 0xfb, + 0x5f, 0xf5, 0xb3, 0x47, 0x0d, 0xc4, 0x7f, 0x39, 0x95, 0x44, 0x56, 0xf0, + 0x5d, 0x0b, 0x49, 0x66, 0x20, 0xf6, 0x52, 0xa8, 0x97, 0xb6, 0x40, 0x03, + 0xfc, 0xc4, 0x57, 0x75, 0x6a, 0x7b, 0xf4, 0x67, 0x9b, 0x89, 0x54, 0x77, + 0xa1, 0x19, 0xe4, 0x22, 0x0a, 0x0d, 0x9b, 0xab, 0xc4, 0x27, 0x34, 0xb7, + 0x4f, 0x5b, 0x9d, 0x16, 0xec, 0xdb, 0x34, 0x9a, 0x7d, 0xb1, 0x69, 0xbf, + 0x69, 0xc5, 0x4a, 0x3d, 0xca, 0xff, 0xfa, 0x20, 0xf5, 0x30, 0xcf, 0x9b, + 0x3b, 0x30, 0xa4, 0xb1, 0xef, 0x47, 0x6d, 0xde, 0x0c, 0x27, 0x6b, 0x49, + 0x42, 0x04, 0xb9, 0x9c, 0x5c, 0xcf, 0xf6, 0x26, 0xa9, 0x13, 0x26, 0xd5, + 0x79, 0x09, 0x24, 0x82, 0x8d, 0x5c, 0x37, 0x36, 0xfd, 0x0d, 0x04, 0x0d, + 0x53, 0xc6, 0x45, 0xa7, 0x54, 0xf1, 0x0a, 0xb1, 0xd7, 0x6e, 0x92, 0x6f, + 0x88, 0xa5, 0xc7, 0x2e, 0x2d, 0x87, 0x6e, 0xcf, 0x9c, 0xba, 0x94, 0xf4, + 0x9c, 0x4c, 0x78, 0xa0, 0x83, 0x0b, 0x1e, 0x5c, 0x13, 0xd5, 0x6f, 0x4c, + 0xdc, 0xb6, 0x51, 0xee, 0x58, 0x8c, 0x5c, 0x2e, 0x27, 0x88, 0xe9, 0x33, + 0xd1, 0xd7, 0xa7, 0x2e, 0xc7, 0x14, 0x09, 0xeb, 0x44, 0x7e, 0xe9, 0xdc, + 0x95, 0x7d, 0x83, 0x39, 0xc5, 0x65, 0x78, 0x6a, 0xf8, 0x8b, 0x74, 0x75, + 0x74, 0xdb, 0xed, 0x82, 0x2a, 0xef, 0x4c, 0xec, 0x41, 0x7a, 0xee, 0xac, + 0xff, 0xc4, 0xb0, 0x8e, 0x65, 0x78, 0xb1, 0xc1, 0xa4, 0xaf, 0xf7, 0x29, + 0xd1, 0x46, 0x12, 0x77, 0x01, 0xde, 0x84, 0x67, 0x5e, 0xaa, 0x72, 0x76, + 0x0d, 0x5b, 0xaa, 0x91, 0x5c, 0xfe, 0x6d, 0x9e, 0x94, 0xd3, 0x22, 0xbb, + 0x3c, 0x9c, 0x76, 0x16, 0x49, 0x67, 0x3a, 0xa3, 0x18, 0xac, 0x17, 0x33, + 0xab, 0xf3, 0xe5, 0xcb, 0xc8, 0x67, 0x3a, 0x7e, 0xf4, 0x72, 0xcc, 0x6c, + 0xcf, 0x85, 0x78, 0x84, 0xec, 0xee, 0x64, 0x2f, 0x88, 0x25, 0xdf, 0x28, + 0x92, 0x1d, 0xc1, 0xb8, 0x31, 0x23, 0xab, 0xce, 0x18, 0x9d, 0x7d, 0xe0, + 0x51, 0xdc, 0xa7, 0x27, 0x44, 0x0c, 0x21, 0x84, 0x74, 0x09, 0xc9, 0xc4, + 0x32, 0x2b, 0x36, 0xc3, 0xa4, 0x71, 0x9a, 0xc2, 0x17, 0x35, 0x17, 0x75, + 0xb3, 0x6a, 0x73, 0xa8, 0x63, 0x35, 0x6b, 0x86, 0xcc, 0xfc, 0x81, 0xdc, + 0x14, 0xe0, 0x24, 0x44, 0x91, 0xdd, 0xea, 0x2e, 0x8f, 0x28, 0xa2, 0x27, + 0x4c, 0xe7, 0xd1, 0x3b, 0x45, 0xbd, 0xc8, 0x43, 0x5f, 0xa5, 0xda, 0x8f, + 0xdb, 0xcc, 0xe3, 0x30, 0x88, 0xa6, 0x4a, 0x3f, 0xd1, 0x30, 0xc8, 0x2f, + 0xc4, 0x10, 0x6d, 0xd6, 0x22, 0x13, 0xd9, 0x88, 0x18, 0x4b, 0x25, 0x1c, + 0x4e, 0xa4, 0xc6, 0x62, 0x4e, 0x28, 0x47, 0xdf, 0x17, 0x04, 0xc8, 0x17, + 0xb2, 0xa8, 0x9d, 0xff, 0xb9, 0xc2, 0xba, 0xc7, 0xad, 0xd6, 0x7f, 0x56, + 0x32, 0x55, 0x45, 0x32, 0x18, 0xe1, 0xca, 0x70, 0xea, 0x88, 0xb5, 0x55, + 0xf6, 0x0f, 0x08, 0x99, 0x58, 0xbb, 0x65, 0x16, 0xd5, 0xd9, 0xc5, 0x85, + 0x74, 0x26, 0xb2, 0x30, 0x57, 0xb2, 0x24, 0x75, 0xd5, 0x44, 0x22, 0xe9, + 0x31, 0xff, 0xcb, 0xd6, 0x41, 0x4f, 0xb5, 0xee, 0x5b, 0xfa, 0x66, 0x32, + 0x6e, 0xf8, 0x57, 0x4f, 0x26, 0xfe, 0x7f, 0x62, 0x86, 0x4e, 0x62, 0x17, + 0xae, 0x6b, 0xf5, 0xf4, 0xf9, 0xe8, 0xfc, 0x11, 0x06, 0x83, 0xb0, 0x4e, + 0x56, 0xe6, 0x9a, 0x1c, 0x1c, 0x20, 0xdb, 0x85, 0xd2, 0xc2, 0xa6, 0x03, + 0xa3, 0xb5, 0x60, 0xeb, 0x63, 0x86, 0x21, 0xf4, 0xc4, 0x88, 0xdb, 0x03, + 0xde, 0xda, 0xb7, 0x0e, 0x4e, 0x98, 0x85, 0xa8, 0x63, 0x95, 0xd4, 0xdd, + 0x31, 0x86, 0x61, 0xd1, 0x4f, 0x30, 0x46, 0x54, 0x45, 0xf4, 0x7e, 0x89, + 0x2d, 0xd6, 0x8a, 0x86, 0x45, 0x15, 0x5d, 0x32, 0x42, 0xed, 0x9a, 0x1f, + 0xa4, 0x5e, 0x02, 0x0f, 0x0f, 0x2c, 0x23, 0xa2, 0x26, 0x0b, 0x44, 0x6b, + 0xcd, 0x6b, 0x1c, 0xcc, 0x80, 0xca, 0x11, 0x98, 0xb1, 0xbe, 0xb9, 0xcc, + 0x3c, 0xd7, 0x2e, 0xd1, 0x11, 0x88, 0x2c, 0x6d, 0x15, 0x41, 0xa4, 0x3b, + 0x74, 0x48, 0x09, 0xa5, 0x12, 0x52, 0xfb, 0x75, 0x10, 0xe1, 0x62, 0x91, + 0xf7, 0x7a, 0x90, 0xd8, 0x32, 0x59, 0x31, 0x92, 0x52, 0xbe, 0xbb, 0x3b, + 0x77, 0x98, 0xb8, 0x68, 0xab, 0x8e, 0x28, 0x62, 0x91, 0xde, 0x86, 0x5b, + 0xb6, 0x13, 0xd9, 0x01, 0x3a, 0xff, 0x3a, 0xa4, 0xf4, 0x9b, 0xca, 0x84, + 0x01, 0xf8, 0x25, 0xab, 0xbd, 0xf2, 0x40, 0xcf, 0xf2, 0x20, 0x81, 0x98, + 0xff, 0xf8, 0x3d, 0x08, 0x15, 0x2b, 0x11, 0x0a, 0x4c, 0xed, 0x00, 0xff, + 0x00, 0x1b, 0x00, 0x0f, 0x00, 0x01, 0x00, 0x19, 0x00, 0x25, 0x00, 0xe6, + 0xb3, 0x54, 0x92, 0xe2, 0xe2, 0x5e, 0xe6, 0x00, 0xd6, 0x5f, 0xe3, 0x5e, + 0xa5, 0x43, 0xc9, 0x7c, 0x0f, 0x6a, 0x73, 0x45, 0x9a, 0x3a, 0x22, 0x3b, + 0x5f, 0xca, 0xb1, 0x61, 0xa8, 0x9f, 0xaa, 0xa0, 0xc8, 0xf2, 0xa1, 0xa8, + 0x4d, 0x9b, 0xa0, 0x74, 0xd8, 0xd7, 0x33, 0x5b, 0xd4, 0x71, 0x2e, 0xd5, + 0x68, 0xb5, 0x72, 0x86, 0xba, 0x35, 0x68, 0xd1, 0x74, 0x6e, 0x95, 0xf1, + 0xa8, 0xb2, 0xc8, 0x0d, 0xef, 0xdf, 0xa5, 0xc4, 0x4c, 0x6c, 0x91, 0x45, + 0x0e, 0x10, 0x9a, 0x81, 0xe1, 0x1f, 0x65, 0xda, 0x81, 0x92, 0xb4, 0xea, + 0x49, 0xfa, 0x93, 0x87, 0x5d, 0xae, 0x92, 0xee, 0xe3, 0x33, 0xc5, 0xb8, + 0xf4, 0x6f, 0xeb, 0x2c, 0xcf, 0x8d, 0x76, 0xdf, 0x46, 0xf5, 0x56, 0xbf, + 0x49, 0xbf, 0xd7, 0xa0, 0xcd, 0x7f, 0xa0, 0x88, 0xc8, 0x65, 0x33, 0xc0, + 0x52, 0xa0, 0x59, 0xd7, 0x10, 0x84, 0xc3, 0x9b, 0xe4, 0x33, 0xd4, 0xa6, + 0x32, 0x51, 0x05, 0x52, 0x14, 0x63, 0x12, 0x34, 0x67, 0xc9, 0x26, 0x04, + 0xd2, 0xaa, 0x88, 0xa8, 0x7c, 0xa0, 0x66, 0xdf, 0x42, 0x83, 0xe3, 0xcd, + 0x17, 0x86, 0x41, 0x4c, 0x12, 0xd9, 0xc4, 0x68, 0xa5, 0x18, 0xe9, 0x9c, + 0x40, 0xa3, 0x04, 0x25, 0x2c, 0xc9, 0x3f, 0xf9, 0x56, 0x4a, 0x83, 0x9a, + 0x91, 0xb9, 0x8d, 0x25, 0xa5, 0xda, 0xf3, 0x27, 0xa2, 0xa7, 0xa5, 0x7f, + 0x7c, 0x48, 0x46, 0x65, 0xa7, 0xe0, 0x8d, 0xea, 0x36, 0x37, 0xb2, 0xfe, + 0x36, 0x57, 0x0d, 0x07, 0x20, 0xb3, 0xa7, 0xe9, 0x47, 0x22, 0x18, 0x4e, + 0x98, 0x94, 0xe1, 0x74, 0x67, 0x4a, 0x29, 0xc7, 0x9a, 0xc6, 0xaa, 0x31, + 0x9a, 0xc2, 0x76, 0xa8, 0x95, 0xd1, 0xb0, 0xf6, 0x22, 0xca, 0x47, 0x39, + 0xf2, 0xee, 0xd8, 0x70, 0x4d, 0x5f, 0x82, 0x01, 0x68, 0x66, 0xbb, 0x95, + 0x28, 0xac, 0x8a, 0x02, 0xa8, 0xfd, 0xbf, 0x6d, 0x64, 0x85, 0x52, 0x0e, + 0x0d, 0xd8, 0x7b, 0x45, 0x41, 0x02, 0x9c, 0xab, 0x11, 0xa7, 0x7b, 0x20, + 0x09, 0x25, 0xef, 0x26, 0x50, 0xae, 0xe3, 0x89, 0xb7, 0xb4, 0xd5, 0x36, + 0x8a, 0x58, 0x19, 0x7c, 0x88, 0x7b, 0x8c, 0x09, 0x2d, 0x93, 0xa2, 0x6e, + 0x49, 0xdf, 0x41, 0x25, 0xc8, 0x64, 0xcb, 0xde, 0x86, 0xd1, 0x6c, 0xc6, + 0xbc, 0x43, 0xf4, 0xc8, 0xba, 0x4d, 0xc2, 0xb2, 0x8d, 0xf0, 0x4f, 0xea, + 0x9a, 0x85, 0x0b, 0x7e, 0x9c, 0x6e, 0x23, 0xab, 0x4a, 0x03, 0x8f, 0x98, + 0x96, 0xbb, 0x6a, 0xfa, 0xbf, 0xdd, 0xc9, 0x1b, 0xb9, 0x0f, 0xbd, 0x5d, + 0xba, 0x9e, 0x89, 0xb1, 0xa9, 0x26, 0x68, 0xcd, 0x9e, 0x1f, 0xd9, 0x56, + 0x2f, 0x05, 0x09, 0xb0, 0xb1, 0x2e, 0x6d, 0xd7, 0x9a, 0x99, 0xa6, 0x6c, + 0x70, 0x99, 0x31, 0x34, 0xe4, 0x77, 0xb9, 0x7d, 0x12, 0xf5, 0x79, 0x15, + 0xe6, 0x40, 0x62, 0xfe, 0x91, 0x61, 0xf6, 0x8d, 0x8c, 0x17, 0x49, 0xb8, + 0x8e, 0xb5, 0x3a, 0x1f, 0x9f, 0x48, 0x02, 0xa9, 0xf9, 0x31, 0x20, 0x8f, + 0x09, 0xa2, 0xff, 0x08, 0x3b, 0x30, 0x20, 0xba, 0x0e, 0x0f, 0x26, 0x22, + 0x89, 0x42, 0xd4, 0x26, 0xe1, 0x7e, 0x88, 0x90, 0x29, 0xa4, 0xce, 0x73, + 0x5a, 0x85, 0x63, 0x7f, 0xa9, 0xb0, 0xfe, 0x6f, 0xde, 0x30, 0x3f, 0x0c, + 0xfd, 0xaa, 0x65, 0x4d, 0xea, 0xbd, 0x03, 0x2b, 0xd4, 0xe8, 0x89, 0xc0, + 0x10, 0xf8, 0x29, 0x18, 0x4a, 0x12, 0xd1, 0xb2, 0xa1, 0xe8, 0x1f, 0xbc, + 0xa9, 0xa9, 0x08, 0x85, 0x57, 0x96, 0x41, 0xbf, 0x34, 0xbc, 0xdb, 0x31, + 0x9d, 0xc7, 0x62, 0x66, 0x36, 0xc1, 0x00, 0xa8, 0x24, 0xc6, 0x02, 0x6a, + 0xfe, 0x91, 0xa6, 0x17, 0x06, 0xd7, 0x69, 0x0a, 0x3d, 0x6d, 0xbb, 0x35, + 0xed, 0xe1, 0x31, 0x43, 0x39, 0xd6, 0xb9, 0x72, 0xb2, 0xa3, 0x86, 0x9c, + 0x1d, 0xa0, 0xfe, 0xb1, 0x86, 0xbb, 0xde, 0x25, 0x4a, 0xa6, 0xfb, 0x36, + 0x64, 0x27, 0xbd, 0xd1, 0x19, 0xe8, 0x61, 0x87, 0x25, 0x48, 0x14, 0x78, + 0x61, 0xf5, 0xe2, 0x7f, 0x1e, 0x56, 0x4d, 0x86, 0x5a, 0xf5, 0x3d, 0xf3, + 0x6a, 0xf6, 0x56, 0xa0, 0xbb, 0x22, 0x99, 0xdb, 0x1d, 0xe4, 0x7a, 0x4b, + 0xad, 0x47, 0xd1, 0x6c, 0x32, 0xf8, 0x7c, 0xf9, 0xdf, 0xd2, 0x49, 0xff, + 0xb1, 0xbf, 0xe8, 0xe9, 0xdb, 0xee, 0xd4, 0x78, 0x02, 0x2d, 0x47, 0x6d, + 0x59, 0xba, 0x09, 0xa3, 0xbc, 0x3b, 0x31, 0x7e, 0x41, 0x23, 0x81, 0x7e, + 0xf2, 0x35, 0x9c, 0x81, 0x12, 0x55, 0x1c, 0x99, 0xe6, 0x1e, 0x7d, 0x2c, + 0xc0, 0xcf, 0x24, 0xa4, 0x63, 0xf5, 0xdd, 0xaa, 0x2b, 0x78, 0x64, 0xa2, + 0x43, 0xde, 0xc7, 0x10, 0xa4, 0x5f, 0x93, 0x78, 0xc5, 0x38, 0x5f, 0x0c, + 0xb9, 0x64, 0xf3, 0x39, 0xa0, 0xe5, 0x38, 0x37, 0x2f, 0xeb, 0xf2, 0x5c, + 0xba, 0xfc, 0x76, 0x80, 0xcf, 0x30, 0x4f, 0x0e, 0xc8, 0xe5, 0x08, 0x0d, + 0xbe, 0xcc, 0xc2, 0x5d, 0xe4, 0xfb, 0x3d, 0x9d, 0x20, 0x24, 0x55, 0x59, + 0xef, 0x94, 0xdd, 0x1d, 0xfe, 0x41, 0xf0, 0x1b, 0xb8, 0xb8, 0xb4, 0x49, + 0x54, 0x94, 0xcb, 0x97, 0xad, 0xe3, 0xa7, 0xe5, 0x6c, 0x65, 0xa4, 0x69, + 0x02, 0xb2, 0x24, 0x13, 0xce, 0xd7, 0x72, 0x54, 0x42, 0x20, 0xae, 0x85, + 0x8d, 0x2d, 0x93, 0xd6, 0x19, 0x10, 0x2a, 0xf7, 0xdc, 0x2f, 0x3e, 0xfa, + 0x7b, 0xef, 0x99, 0x46, 0x53, 0xcf, 0x15, 0xe5, 0xbb, 0xfd, 0x78, 0x30, + 0xd0, 0x41, 0x99, 0xa9, 0x31, 0x3e, 0x72, 0x07, 0x04, 0x1d, 0xcc, 0x31, + 0xab, 0x64, 0xa8, 0x90, 0x82, 0x04, 0x9f, 0x90, 0x6f, 0xc7, 0xce, 0x58, + 0xe3, 0xdd, 0xdd, 0x69, 0xad, 0x60, 0x80, 0xc9, 0x50, 0x8a, 0xc7, 0x9e, + 0x81, 0x72, 0x75, 0x2d, 0xd2, 0x08, 0x3f, 0x68, 0xe1, 0x74, 0xcb, 0x5f, + 0xde, 0x78, 0x83, 0xd1, 0x2c, 0xf4, 0x29, 0xae, 0xff, 0xd1, 0x46, 0x0a, + 0x99, 0x48, 0xd2, 0xd0, 0x5d, 0x79, 0xc6, 0x2c, 0xa1, 0xe4, 0xbf, 0x45, + 0x42, 0x8d, 0x56, 0xb3, 0xc9, 0xeb, 0x11, 0x6c, 0xb6, 0xfe, 0xb0, 0x19, + 0xa8, 0x27, 0xee, 0xe8, 0xce, 0x7a, 0x70, 0xcf, 0x07, 0x01, 0x71, 0xd1, + 0xc4, 0x69, 0x3f, 0x3a, 0x0d, 0x41, 0xc2, 0x3e, 0xa8, 0xa1, 0xa7, 0x93, + 0x02, 0x1d, 0xfd, 0x2f, 0x8f, 0x4e, 0x52, 0x06, 0xcd, 0x3d, 0x94, 0xf1, + 0x9f, 0x23, 0xbc, 0xab, 0xf9, 0xb5, 0xe0, 0x9e, 0xfc, 0x8d, 0x8b, 0xde, + 0x70, 0x29, 0xa1, 0x89, 0xd6, 0x49, 0xe5, 0xcb, 0x67, 0x78, 0x30, 0x1e, + 0x88, 0xe4, 0x05, 0x76, 0x17, 0x7f, 0x6c, 0xe4, 0xc9, 0x7e, 0x81, 0x4d, + 0x24, 0x6f, 0x47, 0xc0, 0xfb, 0x4f, 0xd7, 0xb0, 0xdb, 0x22, 0x68, 0x63, + 0x37, 0xbf, 0xdb, 0x2c, 0x38, 0x5a, 0xbf, 0xad, 0x4c, 0x1a, 0x22, 0xa1, + 0xd1, 0x68, 0x0b, 0x34, 0xf2, 0x49, 0x6f, 0x3e, 0xf8, 0x32, 0xeb, 0xa6, + 0x1a, 0x99, 0x79, 0x74, 0x10, 0xa0, 0xb8, 0x90, 0xae, 0xbd, 0x87, 0xfd, + 0xd3, 0xe6, 0xe9, 0xf4, 0x5e, 0xa6, 0xf1, 0x8e, 0x09, 0x48, 0x89, 0x0a, + 0x1e, 0x13, 0x09, 0x41, 0x41, 0x9c, 0xcd, 0x36, 0x1b, 0xa2, 0xd1, 0xa8, + 0x38, 0x9d, 0x55, 0x02, 0x79, 0x35, 0xb1, 0xf6, 0xa6, 0x5e, 0xab, 0x8c, + 0xbf, 0x9b, 0x9a, 0x71, 0xeb, 0x27, 0x64, 0x32, 0xb8, 0x68, 0xd4, 0xc2, + 0xed, 0x86, 0x36, 0x2e, 0xce, 0x3e, 0xa1, 0xbd, 0x0c, 0xc8, 0xb6, 0x86, + 0x94, 0xc6, 0x15, 0xa7, 0xe5, 0xbd, 0x93, 0xe7, 0x93, 0xe5, 0x95, 0x0f, + 0x3f, 0x1c, 0xd5, 0x60, 0xa2, 0x9e, 0x55, 0xca, 0x23, 0x34, 0x2e, 0x76, + 0x81, 0xc8, 0x3c, 0x4a, 0xb9, 0x19, 0xc9, 0xae, 0x34, 0x38, 0x9c, 0x67, + 0xa6, 0x9c, 0x3c, 0xee, 0x40, 0x8e, 0xc2, 0x1b, 0x98, 0x29, 0x03, 0xdd, + 0x9b, 0x29, 0xd8, 0xd7, 0x44, 0xe8, 0x4a, 0x54, 0x82, 0x9f, 0x84, 0x19, + 0xa7, 0xbd, 0xd8, 0xe0, 0x98, 0x23, 0xdf, 0x00, 0x2a, 0x8e, 0xe2, 0x5b, + 0xaf, 0x50, 0xef, 0x1f, 0x10, 0xe1, 0xea, 0x0b, 0x9f, 0x11, 0xb0, 0x5a, + 0xca, 0xf2, 0x42, 0x6b, 0x6b, 0x1d, 0x1e, 0x62, 0x07, 0x0b, 0x57, 0x18, + 0x40, 0xa7, 0x15, 0x29, 0xc0, 0x78, 0x59, 0xf9, 0x61, 0x74, 0x99, 0xa1, + 0x91, 0xee, 0x5a, 0x17, 0x28, 0x97, 0xf9, 0x91, 0x33, 0xf9, 0xc4, 0x9e, + 0xec, 0x7f, 0x13, 0x1d, 0x8a, 0xe6, 0xb7, 0xf3, 0x1f, 0x33, 0x3e, 0x79, + 0x92, 0x55, 0xee, 0x5b, 0x88, 0xb6, 0x45, 0xb0, 0xe1, 0x2d, 0x2f, 0x6f, + 0xed, 0xbb, 0x21, 0x7a, 0x93, 0xc8, 0x35, 0x6f, 0x6b, 0x03, 0xc4, 0xb0, + 0xdd, 0xef, 0xcc, 0xea, 0x72, 0xbe, 0xe7, 0x3e, 0xfc, 0xff, 0x7c, 0xdb, + 0x1e, 0xe5, 0x91, 0xfa, 0x51, 0x4a, 0x04, 0x03, 0x27, 0xa1, 0x04, 0x6d, + 0x1e, 0xda, 0x95, 0x48, 0x6c, 0xdd, 0x4a, 0xd1, 0xbe, 0xd4, 0x69, 0x67, + 0xe8, 0x2a, 0x22, 0x9b, 0x5e, 0x71, 0x4a, 0x9c, 0x21, 0xdf, 0x99, 0x8b, + 0xae, 0x95, 0x28, 0xd2, 0x09, 0x11, 0x54, 0x94, 0x89, 0xe0, 0xc4, 0xef, + 0x26, 0x55, 0x1c, 0xdc, 0xfa, 0xbf, 0x05, 0x70, 0xc4, 0x64, 0xb4, 0x22, + 0x0d, 0x02, 0xfd, 0x37, 0xc9, 0x11, 0x60, 0x45, 0x3a, 0x7d, 0x52, 0x8b, + 0x4c, 0xe2, 0x59, 0x53, 0x74, 0x1b, 0xf4, 0x91, 0x89, 0xf4, 0x89, 0xe3, + 0x28, 0x93, 0x4d, 0x79, 0xd6, 0xa1, 0x60, 0x9c, 0xea, 0xe3, 0x38, 0xf2, + 0xbc, 0xc6, 0xa0, 0x80, 0xee, 0xfc, 0xda, 0x66, 0xa6, 0x88, 0x82, 0x37, + 0x06, 0x53, 0x0a, 0x00, 0xec, 0x39, 0x94, 0x12, 0xb8, 0x8f, 0x24, 0x80, + 0x95, 0x5b, 0xe3, 0x75, 0xb7, 0x03, 0xbe, 0x2e, 0x17, 0x46, 0x37, 0xd1, + 0x66, 0x53, 0xe8, 0xa5, 0xeb, 0x04, 0x9f, 0x63, 0x79, 0x33, 0x42, 0xaf, + 0xc6, 0x81, 0x65, 0xcc, 0x68, 0x3b, 0x7e, 0xc2, 0x42, 0xd9, 0xa4, 0x83, + 0x16, 0xa3, 0x91, 0x84, 0x0f, 0x36, 0x8f, 0x54, 0x39, 0x7a, 0xb2, 0xf7, + 0x6b, 0x88, 0x6f, 0x51, 0x80, 0xf4, 0x1c, 0x72, 0xc5, 0xc2, 0x69, 0xec, + 0x89, 0xb3, 0xa4, 0xab, 0xfd, 0x07, 0xd6, 0xa2, 0xce, 0x31, 0x9b, 0x0c, + 0x6b, 0xcf, 0x40, 0xa1, 0x28, 0xd4, 0x8c, 0x65, 0x4e, 0x34, 0x51, 0xc6, + 0x21, 0x86, 0x9f, 0xfc, 0x29, 0x04, 0xa8, 0x04, 0x1c, 0x6e, 0x44, 0x76, + 0xa2, 0xee, 0x24, 0xae, 0xb5, 0x26, 0xa7, 0x33, 0x91, 0x02, 0x3c, 0xf4, + 0xfa, 0xd4, 0xf6, 0x8d, 0xd6, 0x63, 0x91, 0x9b, 0x78, 0x77, 0x92, 0x75, + 0x97, 0xd3, 0x0d, 0xe6, 0x97, 0xa9, 0x7f, 0x28, 0x4e, 0xef, 0xca, 0x38, + 0x99, 0x1d, 0xc7, 0x07, 0x1c, 0x1d, 0x2d, 0xf2, 0x2a, 0x62, 0x7f, 0xc2, + 0x8d, 0xf1, 0x62, 0x84, 0xfd, 0x23, 0xa2, 0xda, 0x52, 0xe2, 0x32, 0xb1, + 0xcc, 0x1b, 0xf4, 0xa8, 0xc9, 0xf8, 0xc2, 0x1f, 0xc3, 0xe0, 0x91, 0x48, + 0xd2, 0x14, 0x22, 0x92, 0x43, 0x3f, 0xa0, 0x41, 0x27, 0x05, 0x64, 0x54, + 0x8c, 0xb8, 0x8d, 0x9c, 0x42, 0xc0, 0xa2, 0xba, 0xb5, 0x58, 0xe0, 0x89, + 0x45, 0x5b, 0xb8, 0xc4, 0x7d, 0xa3, 0xd7, 0xe2, 0xa5, 0xef, 0xba, 0x81, + 0xbd, 0xd5, 0x5d, 0x50, 0xcd, 0x02, 0x8d, 0xaa, 0x69, 0xbf, 0xef, 0x78, + 0x85, 0x2b, 0x1a, 0xc5, 0xab, 0x9a, 0x5a, 0x9e, 0xbe, 0xad, 0x44, 0xb3, + 0xb3, 0x67, 0x4d, 0x7d, 0xd2, 0x83, 0x2f, 0x1f, 0x8f, 0x52, 0x7b, 0x25, + 0x8a, 0x23, 0x82, 0xae, 0xe9, 0x84, 0x88, 0x55, 0x21, 0x97, 0x17, 0x04, + 0x76, 0x8e, 0xee, 0x50, 0xcd, 0x8e, 0xaf, 0x41, 0x02, 0x05, 0x86, 0x20, + 0xf4, 0x9e, 0x86, 0x51, 0x0c, 0xc9, 0x17, 0x22, 0xbe, 0x10, 0xab, 0xc4, + 0x3b, 0x93, 0x9d, 0xe8, 0xc3, 0xdb, 0xa3, 0xd2, 0x92, 0x4d, 0x98, 0x77, + 0xc4, 0x72, 0xfe, 0xe1, 0x3a, 0x19, 0x5e, 0x4a, 0x4c, 0x6b, 0xf5, 0x2c, + 0x78, 0x57, 0x1f, 0x94, 0x6d, 0xdb, 0xe9, 0xd6, 0x25, 0x79, 0xd8, 0x80, + 0xe3, 0xea, 0xa0, 0x08, 0xa6, 0xac, 0x1e, 0x2e, 0xc1, 0x91, 0xe0, 0xcc, + 0x2e, 0x58, 0x4f, 0x98, 0xa4, 0x34, 0x8a, 0xdf, 0x53, 0xc6, 0x6e, 0xbc, + 0x8b, 0x66, 0x9e, 0x4b, 0xae, 0x4c, 0xa6, 0x1b, 0x74, 0xea, 0xb4, 0x7b, + 0xc4, 0x33, 0x7e, 0xaf, 0x4f, 0xbe, 0x13, 0x60, 0xac, 0x54, 0x81, 0x7d, + 0x27, 0x33, 0xc2, 0x5c, 0xcc, 0xf2, 0xfa, 0x5a, 0x91, 0x5c, 0x9b, 0xa2, + 0x4c, 0x40, 0x39, 0xf5, 0xc6, 0x64, 0xaf, 0x86, 0x3d, 0xc8, 0xde, 0xc2, + 0x17, 0xd4, 0x6a, 0x3b, 0x9b, 0x7a, 0xb0, 0x31, 0x07, 0xe5, 0x4d, 0xe5, + 0xe1, 0xfe, 0x1c, 0xfa, 0xa8, 0xd2, 0xf7, 0xf6, 0x4a, 0xb8, 0x28, 0x0e, + 0x99, 0xa1, 0x2b, 0xa3, 0x62, 0xcb, 0x57, 0x8c, 0x76, 0x75, 0x4c, 0xf3, + 0x09, 0x87, 0x93, 0x7e, 0x1c, 0x22, 0xb9, 0x7c, 0x95, 0x24, 0x96, 0x74, + 0x9f, 0xca, 0x6f, 0x60, 0xa6, 0x8d, 0x9d, 0x6a, 0x2a, 0x84, 0xac, 0x59, + 0x0d, 0xce, 0x15, 0xcc, 0x44, 0xc5, 0x3f, 0x25, 0xd2, 0x1a, 0x7a, 0x0c, + 0x7d, 0x38, 0xf4, 0x48, 0xce, 0x88, 0xaa, 0x2f, 0x57, 0x05, 0x7e, 0xcc, + 0xa6, 0xe8, 0x44, 0xb7, 0x54, 0xea, 0x21, 0xe8, 0x13, 0x69, 0x28, 0xe2, + 0xba, 0x04, 0x0c, 0x9e, 0x86, 0xcb, 0xfb, 0x47, 0x90, 0xa1, 0x71, 0x62, + 0x7b, 0x7a, 0xc4, 0x32, 0x3f, 0xc1, 0x63, 0x2f, 0xa4, 0xb0, 0x85, 0x69, + 0x28, 0x71, 0x9d, 0xf2, 0x50, 0x5e, 0xc3, 0xf4, 0x16, 0xef, 0x58, 0x53, + 0x96, 0x91, 0x96, 0x49, 0xab, 0xa6, 0xa8, 0x46, 0x7d, 0x6b, 0x49, 0x1b, + 0xd3, 0x78, 0x56, 0x95, 0x2f, 0xe6, 0x35, 0x56, 0xae, 0x25, 0x03, 0x75, + 0x44, 0xf8, 0x87, 0xa8, 0xa9, 0x51, 0x30, 0xf6, 0xa4, 0xc3, 0x72, 0x5a, + 0x67, 0xa5, 0x64, 0xb5, 0x2a, 0x57, 0x8b, 0x7d, 0x0f, 0xef, 0xd3, 0x48, + 0x4c, 0x65, 0x32, 0xa9, 0x68, 0xf5, 0x46, 0xb8, 0x54, 0xe7, 0x1c, 0xab, + 0x9c, 0x78, 0xd2, 0x0c, 0x2d, 0x81, 0x53, 0xc1, 0x8d, 0xea, 0x9d, 0x4b, + 0x21, 0x99, 0xfd, 0x95, 0x2e, 0xee, 0x94, 0xa8, 0x6d, 0x30, 0x4e, 0x15, + 0xff, 0xf8, 0x3d, 0x08, 0x16, 0x2b, 0x11, 0xb7, 0x44, 0xfc, 0x00, 0xfa, + 0x00, 0xfa, 0x00, 0xe7, 0x27, 0x68, 0xe3, 0x58, 0x55, 0x7c, 0x49, 0xd8, + 0x0b, 0xed, 0x6a, 0x6e, 0xd6, 0x18, 0x3f, 0x90, 0x4b, 0xff, 0x6f, 0x7a, + 0xf5, 0xe6, 0x49, 0x78, 0xf7, 0x4a, 0x6c, 0x83, 0xce, 0xed, 0x4e, 0x1e, + 0x75, 0xc8, 0xfa, 0x13, 0x8a, 0x17, 0x81, 0x30, 0x2b, 0x92, 0xac, 0x08, + 0x00, 0x62, 0x93, 0x40, 0xea, 0xc4, 0x63, 0x66, 0x08, 0x00, 0x94, 0x1d, + 0x44, 0xb3, 0x8e, 0xba, 0xa5, 0x26, 0xa3, 0x65, 0x12, 0xe4, 0x2f, 0xa2, + 0x6c, 0x64, 0x30, 0xda, 0x8c, 0x21, 0x64, 0x7f, 0xb7, 0xf9, 0x0b, 0x83, + 0x34, 0x27, 0x3f, 0x7f, 0x74, 0x5f, 0xcd, 0x5c, 0xa2, 0x61, 0x56, 0xde, + 0xfe, 0x74, 0xb5, 0x83, 0x7c, 0xa5, 0xc7, 0xcd, 0x2a, 0x2e, 0x19, 0x79, + 0x90, 0xfd, 0x1d, 0xe4, 0x43, 0x4b, 0x1c, 0x30, 0x48, 0x24, 0xce, 0xd6, + 0xdc, 0xdb, 0xc6, 0xed, 0xaf, 0xef, 0x78, 0x16, 0x29, 0xc1, 0xf7, 0x61, + 0x8a, 0x99, 0x3e, 0xc8, 0x20, 0x6e, 0x38, 0x42, 0xe9, 0x26, 0xa3, 0x7f, + 0x75, 0xa5, 0x83, 0xe6, 0x12, 0xc7, 0x54, 0x86, 0xf0, 0x4c, 0x6d, 0x56, + 0x67, 0x33, 0xa2, 0xa9, 0xcf, 0x13, 0x8a, 0x17, 0x81, 0x30, 0x2b, 0x91, + 0x56, 0x33, 0x94, 0xa3, 0xad, 0x47, 0x23, 0x56, 0x94, 0x17, 0x11, 0x37, + 0x0a, 0x92, 0xed, 0x95, 0x0b, 0x80, 0x57, 0xc2, 0x4a, 0xb4, 0x78, 0xaf, + 0x34, 0xdb, 0xa8, 0x4a, 0xbc, 0x80, 0x7c, 0x5a, 0xb3, 0x39, 0x38, 0xb5, + 0xef, 0x3d, 0x2a, 0xdf, 0xb3, 0xb8, 0x94, 0xd7, 0xed, 0xf6, 0x08, 0x66, + 0x06, 0xf0, 0x57, 0x42, 0x72, 0x1f, 0x1a, 0x9f, 0xe1, 0xf5, 0x8b, 0xf4, + 0xa9, 0x74, 0xb5, 0x82, 0xc1, 0x84, 0x33, 0xc1, 0x88, 0xc6, 0xf5, 0x54, + 0x73, 0xd3, 0x6b, 0x90, 0xa1, 0x5f, 0x33, 0xa7, 0x54, 0xad, 0xe1, 0x00, + 0x58, 0xd3, 0xa6, 0xac, 0xb1, 0xa0, 0x15, 0xff, 0xd3, 0xc3, 0xd1, 0xd5, + 0x58, 0x40, 0x1c, 0x57, 0x1e, 0x72, 0x0b, 0xe9, 0x36, 0x10, 0xc7, 0x81, + 0x6f, 0x36, 0xef, 0x03, 0x21, 0x6a, 0xa4, 0x75, 0x82, 0x98, 0xea, 0xa3, + 0x47, 0x96, 0x49, 0x1a, 0xde, 0xf6, 0xff, 0x4f, 0x52, 0xf8, 0x38, 0xbd, + 0xd1, 0x3d, 0x63, 0x1b, 0x2d, 0xd8, 0x23, 0xfd, 0xf0, 0x5e, 0xde, 0x27, + 0x0a, 0xf9, 0x9d, 0x39, 0x52, 0x8d, 0x2f, 0x0f, 0xba, 0x9a, 0x89, 0xa5, + 0x97, 0x86, 0x71, 0x37, 0xb2, 0x26, 0x38, 0xb8, 0x13, 0x83, 0x1a, 0x7b, + 0xd7, 0x4e, 0xa9, 0x1d, 0xe3, 0x58, 0xd1, 0x8d, 0x35, 0xbc, 0xe9, 0xb9, + 0xf9, 0x1f, 0x2f, 0x16, 0xa4, 0xba, 0xbb, 0x84, 0xa4, 0xae, 0x7e, 0xa5, + 0x2c, 0x25, 0x73, 0x1e, 0xb8, 0x13, 0x85, 0xca, 0x95, 0xaa, 0x88, 0xef, + 0xa9, 0x5c, 0x3b, 0x69, 0x9a, 0xa1, 0x3c, 0x19, 0x0c, 0x9f, 0xcf, 0xdd, + 0xc8, 0x1c, 0x6b, 0xbb, 0x97, 0xae, 0x6e, 0xb9, 0x10, 0x23, 0xad, 0xc3, + 0x38, 0x80, 0xc7, 0x45, 0xa7, 0x03, 0x54, 0xb6, 0x20, 0x71, 0xce, 0x39, + 0x8e, 0x54, 0xa7, 0x75, 0x68, 0xee, 0x3b, 0x1c, 0xb8, 0xcd, 0xf5, 0x30, + 0x00, 0x80, 0x31, 0x4c, 0x7d, 0xbd, 0x53, 0x20, 0x09, 0xc9, 0x74, 0x23, + 0x50, 0x13, 0xff, 0x58, 0x46, 0xc5, 0x4e, 0xf1, 0x56, 0x46, 0xc8, 0xbb, + 0xf6, 0xe0, 0xa2, 0xfe, 0x81, 0xac, 0x6a, 0xa3, 0x63, 0x90, 0x1e, 0x07, + 0xeb, 0x88, 0x13, 0x68, 0x3f, 0x12, 0x6d, 0x6e, 0x46, 0x8f, 0x28, 0xc8, + 0x4d, 0x18, 0xf0, 0xb7, 0x89, 0x11, 0x1f, 0x26, 0xa4, 0xcc, 0x64, 0x93, + 0x60, 0x5c, 0x57, 0xa4, 0xea, 0xa8, 0x23, 0xcf, 0x2b, 0x17, 0x0b, 0x6f, + 0x28, 0x27, 0x4e, 0x4a, 0x32, 0x11, 0x98, 0x22, 0x04, 0x23, 0x67, 0x74, + 0x4c, 0x46, 0xc1, 0x55, 0x0e, 0x09, 0x7c, 0x23, 0x82, 0x03, 0x69, 0x3d, + 0x1c, 0x99, 0xae, 0x48, 0x63, 0xa6, 0xd5, 0x5f, 0x0e, 0xa4, 0x7f, 0xef, + 0x15, 0x6f, 0x22, 0xa7, 0xc3, 0x4d, 0x71, 0x6b, 0xa3, 0x8b, 0x17, 0xe5, + 0x13, 0xac, 0x79, 0x74, 0x79, 0x58, 0xbc, 0x93, 0x1c, 0xb8, 0x1c, 0x71, + 0x04, 0x1a, 0x8c, 0x99, 0x8d, 0x2a, 0x31, 0xe7, 0x16, 0x2e, 0x26, 0xaa, + 0x78, 0xe0, 0xc9, 0x18, 0x92, 0xd6, 0x3b, 0x7e, 0xc5, 0x46, 0x7c, 0x8b, + 0xfa, 0x1a, 0xcf, 0x26, 0xb2, 0x01, 0x04, 0x00, 0xe3, 0x40, 0x7f, 0xe8, + 0xf3, 0xcb, 0x74, 0x55, 0x93, 0x96, 0x2d, 0x6d, 0x4d, 0x4c, 0x5e, 0xc3, + 0xfa, 0xef, 0xec, 0x3f, 0xae, 0xfe, 0xc0, 0x10, 0x2b, 0x75, 0x5b, 0xc3, + 0xa9, 0x80, 0x40, 0x02, 0x01, 0x75, 0xaa, 0xa3, 0xd1, 0xae, 0x3c, 0xdc, + 0x55, 0xae, 0xa5, 0x56, 0xb1, 0xe4, 0xc7, 0xb1, 0x66, 0x48, 0x2a, 0x82, + 0xd9, 0xfc, 0xf1, 0x16, 0xe9, 0x08, 0x0c, 0x66, 0xf8, 0x7f, 0x18, 0x89, + 0x96, 0x46, 0x6d, 0x6e, 0xf2, 0xb5, 0x3e, 0x1d, 0x4b, 0xff, 0xc3, 0x39, + 0x42, 0x02, 0x34, 0xab, 0x4b, 0x95, 0xe3, 0xc9, 0x72, 0xa7, 0x46, 0xb2, + 0x13, 0x96, 0x2f, 0x24, 0xc7, 0x63, 0xd8, 0xb5, 0xb4, 0x4d, 0x54, 0xf2, + 0x7c, 0xc6, 0xad, 0xb0, 0x4f, 0xec, 0x83, 0x16, 0x62, 0xcd, 0x84, 0xe5, + 0x56, 0x80, 0x40, 0x08, 0x07, 0x19, 0x38, 0x5c, 0x66, 0xfa, 0x98, 0x04, + 0x02, 0x00, 0xff, 0xa7, 0x97, 0x1d, 0x64, 0x02, 0x00, 0x40, 0x38, 0xdc, + 0x77, 0x20, 0x8d, 0x10, 0x19, 0xe2, 0xa6, 0x40, 0x0e, 0x34, 0x07, 0xff, + 0xe1, 0x35, 0x3c, 0x34, 0xd7, 0x16, 0xba, 0x38, 0xb1, 0x71, 0x35, 0x53, + 0xdc, 0x11, 0x17, 0x92, 0x0c, 0x48, 0x98, 0xfb, 0x0d, 0x74, 0xdf, 0x24, + 0x9a, 0xe2, 0xd7, 0x49, 0xd4, 0x2a, 0x7c, 0x34, 0xd4, 0xc5, 0x8a, 0x7a, + 0xf1, 0xc5, 0x39, 0x4e, 0x29, 0x17, 0x7e, 0xdc, 0x1f, 0x41, 0x53, 0xd2, + 0xcf, 0x9a, 0xc3, 0xc9, 0x8f, 0x62, 0xc5, 0xb4, 0x82, 0x4e, 0x75, 0x27, + 0x0c, 0x82, 0x38, 0xcf, 0x1b, 0x5d, 0xe4, 0xc7, 0xb1, 0x79, 0x26, 0x3b, + 0x1e, 0xc5, 0xad, 0xbc, 0xa7, 0x14, 0x7a, 0x0a, 0xa0, 0x6a, 0x31, 0x4c, + 0x63, 0x23, 0x56, 0x1e, 0x21, 0xe9, 0x54, 0x53, 0xc2, 0xa8, 0x0a, 0xbe, + 0xc8, 0x3f, 0xba, 0x52, 0x7c, 0x0c, 0x68, 0x84, 0x46, 0xed, 0xf1, 0x7e, + 0x54, 0xe9, 0x53, 0x13, 0xc6, 0xaf, 0xc2, 0x2d, 0xa1, 0x04, 0xc6, 0x2e, + 0x27, 0xee, 0x5a, 0xd3, 0x73, 0x30, 0x49, 0x5d, 0x0d, 0xaf, 0xbd, 0x6a, + 0x39, 0x6a, 0xcb, 0x1b, 0xfe, 0x23, 0xbc, 0xcd, 0xba, 0x47, 0xa4, 0xac, + 0x1a, 0xb8, 0x7d, 0xdd, 0x17, 0x26, 0x3c, 0xa1, 0xcb, 0xbc, 0xc0, 0x43, + 0x48, 0xac, 0xce, 0x6d, 0xd5, 0xcb, 0x54, 0xd8, 0x62, 0xca, 0xdd, 0xd9, + 0xb8, 0x31, 0x58, 0xac, 0x25, 0x82, 0xfa, 0x4a, 0xfb, 0x5d, 0x90, 0xc0, + 0x44, 0xb5, 0xc9, 0xca, 0xcc, 0x78, 0x63, 0xf5, 0x19, 0x1e, 0x3f, 0xc6, + 0xeb, 0x60, 0xd9, 0x0b, 0xf8, 0xd5, 0xc3, 0x4d, 0x32, 0xa5, 0x50, 0x38, + 0xcc, 0xd1, 0x39, 0x8c, 0x64, 0x97, 0x29, 0x11, 0x9d, 0x07, 0xd2, 0x26, + 0x02, 0x93, 0x13, 0xa3, 0x1f, 0xc6, 0x61, 0x97, 0x1d, 0x21, 0x1b, 0x34, + 0x17, 0x58, 0xd6, 0x6f, 0xfc, 0x78, 0xf9, 0x6e, 0xa9, 0x4c, 0xc6, 0xe5, + 0xe5, 0xbf, 0x35, 0x98, 0xbe, 0xbd, 0x01, 0x30, 0x26, 0x36, 0x5b, 0xa8, + 0x20, 0xb2, 0x11, 0xdb, 0x33, 0x85, 0x76, 0xf5, 0x94, 0x23, 0xa6, 0x0a, + 0xd6, 0x2c, 0x44, 0x02, 0xf0, 0xed, 0xd9, 0x58, 0x5c, 0x98, 0x2a, 0x1e, + 0x2c, 0x73, 0x04, 0x72, 0x73, 0x6c, 0x32, 0x9c, 0x4f, 0xa0, 0xb9, 0xc2, + 0xcc, 0xa1, 0xba, 0xd2, 0xa7, 0x9d, 0xae, 0x35, 0x53, 0x3c, 0x3a, 0x9d, + 0x69, 0x7e, 0x95, 0x2e, 0x97, 0x9f, 0x52, 0x0b, 0x2a, 0x3a, 0x6a, 0x69, + 0xe2, 0xe3, 0x2a, 0x97, 0x65, 0x55, 0x58, 0xc9, 0xd3, 0xe5, 0x9d, 0x25, + 0x54, 0xd8, 0x79, 0xae, 0xe9, 0x1d, 0x6a, 0x79, 0xe3, 0x8e, 0x1e, 0x4a, + 0x98, 0xa3, 0xa5, 0x46, 0x3d, 0xf2, 0xf1, 0x74, 0x93, 0x8e, 0x79, 0x28, + 0x89, 0xe3, 0xa1, 0x72, 0x04, 0xdc, 0xde, 0x52, 0x1a, 0x80, 0x4b, 0xfd, + 0x35, 0xb1, 0x72, 0xe8, 0x66, 0xca, 0xae, 0x89, 0x1b, 0xa1, 0x59, 0xb8, + 0x96, 0x0d, 0x48, 0x99, 0xd5, 0x5a, 0x30, 0x07, 0x9e, 0x04, 0x32, 0xcb, + 0x1f, 0x14, 0x42, 0x08, 0x11, 0x75, 0xd5, 0x6f, 0x16, 0x19, 0x09, 0xc6, + 0x67, 0xfa, 0x35, 0x41, 0x01, 0x71, 0x41, 0xc7, 0x84, 0xfd, 0x35, 0x43, + 0xe2, 0x02, 0x93, 0x92, 0xbb, 0x58, 0x4e, 0xbd, 0x52, 0x1d, 0x11, 0xbe, + 0x11, 0xf2, 0x3a, 0xba, 0x8d, 0x29, 0xd0, 0xc0, 0x61, 0xd3, 0x6b, 0x9a, + 0x4b, 0x1b, 0x88, 0x9f, 0x8b, 0x26, 0xa0, 0xde, 0x4c, 0xf5, 0x32, 0x08, + 0xcb, 0x0e, 0xfb, 0x2d, 0xb4, 0x4a, 0x62, 0xf4, 0x29, 0x21, 0x1b, 0xf0, + 0xbe, 0x04, 0x31, 0xcc, 0x7f, 0xa9, 0xe1, 0x01, 0x23, 0x25, 0xab, 0xed, + 0xaa, 0x6f, 0xac, 0x31, 0xc8, 0x92, 0x5a, 0x67, 0x39, 0x45, 0x44, 0xa8, + 0xd6, 0x3c, 0xe8, 0xaa, 0x51, 0x8f, 0x8f, 0xa7, 0x09, 0x24, 0x1a, 0x66, + 0x75, 0x2f, 0x30, 0xab, 0xbd, 0x90, 0xbf, 0xb5, 0x2e, 0x3d, 0x25, 0x3b, + 0xa5, 0xae, 0x9b, 0xea, 0xe9, 0x98, 0x8f, 0x97, 0x97, 0x75, 0x59, 0x18, + 0xdf, 0x05, 0x29, 0xf7, 0xe5, 0x4e, 0xc1, 0x1c, 0x35, 0xc5, 0x03, 0xb5, + 0x38, 0x76, 0xe5, 0xc6, 0xf2, 0x19, 0xc1, 0x9e, 0x78, 0x6b, 0x7f, 0x6b, + 0x02, 0x87, 0xf8, 0x55, 0x5a, 0xc4, 0xb1, 0x51, 0xfc, 0x64, 0x20, 0x0e, + 0xa2, 0x55, 0x5d, 0x0c, 0x28, 0x1d, 0x58, 0x7a, 0x4a, 0xd3, 0xab, 0xab, + 0xf8, 0x87, 0x3a, 0xc9, 0x69, 0x4e, 0x7e, 0xf3, 0xf8, 0x5a, 0x09, 0x64, + 0x0f, 0x66, 0xec, 0x49, 0x13, 0xf0, 0xd5, 0x13, 0x5f, 0x9c, 0x77, 0x24, + 0xd1, 0xcc, 0x71, 0xbc, 0x48, 0x8a, 0xe5, 0xe1, 0x3a, 0xc0, 0x80, 0xe0, + 0x82, 0x51, 0xd3, 0x67, 0xd5, 0x2f, 0x4a, 0x0e, 0x85, 0x1e, 0x09, 0x68, + 0x7f, 0xd9, 0x98, 0x6c, 0xf1, 0xde, 0x47, 0x97, 0x1a, 0x54, 0xe8, 0xb0, + 0xaf, 0x71, 0xfe, 0xa9, 0x2f, 0x69, 0xf9, 0x3b, 0xa4, 0x42, 0x78, 0x10, + 0x0a, 0x89, 0x03, 0xdb, 0xcb, 0x69, 0x2d, 0x76, 0x14, 0x7a, 0x29, 0xdc, + 0x3b, 0x76, 0x7c, 0xcb, 0x7a, 0x6e, 0xe2, 0xd8, 0xa9, 0x89, 0x1e, 0x26, + 0x91, 0x5a, 0x49, 0x6e, 0x5c, 0xb4, 0x19, 0x4b, 0xd2, 0x53, 0xc7, 0x00, + 0x4c, 0x9c, 0x18, 0x7d, 0x74, 0x64, 0x68, 0x5a, 0x56, 0x02, 0xc8, 0x51, + 0x40, 0xd6, 0x73, 0x7e, 0x45, 0x23, 0x0a, 0x66, 0x32, 0x43, 0xea, 0xaa, + 0xc7, 0x74, 0x79, 0xe0, 0x65, 0xf6, 0x4c, 0xe2, 0xa8, 0xad, 0x9c, 0x6a, + 0x8b, 0xd8, 0xfd, 0x64, 0x33, 0xd2, 0x43, 0x7a, 0xa6, 0xa6, 0x27, 0x3c, + 0x35, 0x0d, 0xfa, 0x7a, 0x9e, 0x67, 0x25, 0x89, 0xa6, 0xbe, 0x8d, 0xa0, + 0xe6, 0xa0, 0x1b, 0x74, 0x0b, 0x4c, 0x08, 0xcd, 0x37, 0x08, 0x66, 0x98, + 0xf7, 0x89, 0xbb, 0x33, 0xb5, 0x27, 0xb3, 0x86, 0x14, 0x47, 0x2d, 0x0f, + 0x78, 0xb9, 0x97, 0x39, 0x8b, 0xa3, 0x39, 0x59, 0x07, 0xf8, 0xbb, 0xee, + 0xfa, 0xc1, 0x6f, 0x99, 0x3c, 0xc9, 0x97, 0xea, 0x9b, 0x5f, 0xf6, 0xe2, + 0xb1, 0xdb, 0x2c, 0xba, 0xdf, 0x25, 0xf3, 0x67, 0xe7, 0xdc, 0x8e, 0xf5, + 0x77, 0x59, 0x24, 0x18, 0x50, 0x62, 0x5f, 0x56, 0xbe, 0xb5, 0x52, 0x3a, + 0xb4, 0x78, 0x4a, 0xf1, 0xf8, 0x9e, 0xf7, 0x78, 0x5b, 0x0f, 0x68, 0x52, + 0xf6, 0x30, 0xab, 0x90, 0xb3, 0x01, 0xec, 0x31, 0x2d, 0xf1, 0x10, 0x82, + 0xff, 0xc6, 0xe1, 0x47, 0x7f, 0xc2, 0x48, 0xc7, 0x32, 0x4b, 0xa5, 0xdf, + 0x90, 0xfa, 0x75, 0xb4, 0x7b, 0x42, 0x58, 0xe7, 0x79, 0x42, 0x67, 0xfe, + 0x5e, 0x3a, 0xfc, 0x85, 0x6c, 0x6f, 0x51, 0xbd, 0x20, 0x7b, 0x58, 0x87, + 0x6d, 0xb0, 0x3e, 0xa8, 0xa8, 0x0e, 0x74, 0xd1, 0xe5, 0x4b, 0xe4, 0xc6, + 0x52, 0x24, 0x8d, 0xa8, 0xfe, 0xd8, 0xa2, 0xf8, 0x17, 0x7d, 0xe4, 0xfa, + 0xdd, 0xec, 0xd2, 0xe7, 0x41, 0xc6, 0x14, 0x4b, 0xd8, 0x8d, 0xa3, 0x8a, + 0xe0, 0x9a, 0x58, 0x3a, 0xf4, 0x20, 0x10, 0x77, 0x0c, 0x20, 0x16, 0x39, + 0x74, 0x91, 0x90, 0xb1, 0xce, 0xff, 0xf8, 0x3d, 0x08, 0x17, 0x2b, 0x11, + 0xdc, 0x4e, 0x14, 0x00, 0x18, 0x00, 0x29, 0x00, 0x03, 0x00, 0xf7, 0x00, + 0x12, 0x00, 0x07, 0x00, 0xdf, 0x00, 0xe6, 0xb0, 0x53, 0x9d, 0x6c, 0xd5, + 0x9e, 0x64, 0x82, 0x12, 0xfd, 0xb0, 0x83, 0x6a, 0x79, 0x9e, 0x81, 0x8d, + 0x95, 0xd0, 0x62, 0x40, 0x59, 0x20, 0x8b, 0x42, 0x5f, 0x62, 0x31, 0xb3, + 0x8b, 0x6f, 0x35, 0xc0, 0x72, 0xd1, 0x7c, 0xcb, 0x55, 0xdc, 0x57, 0xec, + 0xbc, 0xb8, 0xab, 0x1a, 0xb9, 0xad, 0x81, 0x92, 0x69, 0x78, 0x44, 0x92, + 0xff, 0x97, 0xee, 0x73, 0xc3, 0x3c, 0xe6, 0xfa, 0xc9, 0x98, 0xe5, 0x8b, + 0x9f, 0x14, 0x5b, 0xe8, 0x1a, 0xa4, 0x2f, 0xc1, 0x96, 0x43, 0x6c, 0x21, + 0xea, 0x81, 0x7b, 0x4b, 0x8c, 0x16, 0x98, 0x62, 0x70, 0xfc, 0x34, 0xfe, + 0x15, 0x91, 0xb8, 0xad, 0x5d, 0xff, 0xc9, 0x5d, 0x2a, 0xd8, 0x08, 0x75, + 0xf3, 0x37, 0x10, 0x3d, 0xa5, 0x3c, 0x1b, 0x73, 0x55, 0x85, 0xda, 0x7d, + 0x10, 0xc9, 0x20, 0x76, 0x73, 0x5d, 0x23, 0x16, 0xaf, 0x7b, 0xda, 0x74, + 0x4f, 0xd0, 0x34, 0xd3, 0x41, 0x3e, 0xc4, 0xf6, 0x16, 0x6d, 0xe1, 0xf9, + 0x04, 0x19, 0x84, 0x1f, 0x83, 0x9d, 0x53, 0x3c, 0x12, 0xb9, 0x5e, 0x18, + 0x08, 0xe9, 0x57, 0xcc, 0xc7, 0x92, 0x3b, 0x03, 0x75, 0x57, 0xaf, 0x8c, + 0x0c, 0xad, 0x6f, 0x7b, 0x8d, 0xa7, 0x31, 0x3e, 0x3c, 0xc1, 0x0a, 0x53, + 0xfd, 0xa7, 0x8f, 0x01, 0x4c, 0xf9, 0xab, 0xb7, 0x87, 0xf8, 0xd2, 0x3c, + 0xe5, 0x39, 0xcf, 0xfe, 0x95, 0x8f, 0x8f, 0x7e, 0x9f, 0x4c, 0x33, 0xa4, + 0x8e, 0xa2, 0x5e, 0xeb, 0x13, 0x73, 0x56, 0xca, 0x11, 0x44, 0x8e, 0x1a, + 0x8e, 0x30, 0xb0, 0x18, 0x02, 0xf3, 0xa8, 0x94, 0x1b, 0x78, 0x01, 0x7a, + 0xeb, 0x22, 0x91, 0x74, 0x47, 0x30, 0x61, 0xdb, 0xa8, 0xb2, 0x91, 0x94, + 0x16, 0x7b, 0x5b, 0x38, 0x64, 0x71, 0x09, 0x4d, 0xc4, 0xae, 0x77, 0x71, + 0xd5, 0x79, 0xf9, 0xfa, 0x8c, 0x5c, 0x5e, 0x4a, 0x0d, 0xa6, 0x32, 0x73, + 0xd4, 0x40, 0x2c, 0xb3, 0x5b, 0x5b, 0xec, 0xc9, 0x05, 0x7c, 0x57, 0xd2, + 0x2f, 0x83, 0x79, 0x28, 0x5e, 0xd5, 0x85, 0xd0, 0x29, 0x32, 0x99, 0x4a, + 0x2e, 0x4c, 0x20, 0x84, 0xaf, 0x58, 0x8d, 0x69, 0x6a, 0x03, 0x9a, 0x89, + 0xc0, 0x8a, 0xbc, 0x5b, 0x50, 0xd5, 0xf1, 0x69, 0x35, 0xee, 0x91, 0x99, + 0xcb, 0xf3, 0x04, 0x5b, 0x8a, 0x2c, 0x2c, 0x72, 0x77, 0xbc, 0x46, 0xfb, + 0x7c, 0x7a, 0xba, 0x6d, 0xb0, 0x9a, 0x51, 0x6b, 0xc5, 0x10, 0xf7, 0x8a, + 0x45, 0x11, 0x44, 0xa5, 0x79, 0xb0, 0xab, 0x2c, 0xe7, 0x66, 0x50, 0x99, + 0x9c, 0x69, 0xa4, 0x79, 0x0f, 0xac, 0xea, 0x7d, 0x08, 0x93, 0xd1, 0xf3, + 0xe2, 0x67, 0x86, 0xdb, 0x5d, 0x19, 0x16, 0x1a, 0x25, 0x16, 0x36, 0x89, + 0xb1, 0xc7, 0x52, 0xbc, 0xce, 0x8a, 0x45, 0x5e, 0xb1, 0xca, 0x8d, 0x16, + 0x6b, 0x8e, 0xdc, 0x60, 0xf6, 0x63, 0xcb, 0xbf, 0x90, 0xef, 0xe9, 0x3d, + 0x4b, 0xfa, 0x2e, 0x9c, 0xdd, 0x88, 0x6b, 0x2e, 0x4f, 0xe4, 0x75, 0xde, + 0xc0, 0x09, 0xea, 0xac, 0x09, 0x35, 0x3a, 0x45, 0x2c, 0xdf, 0x68, 0xe9, + 0x89, 0x5b, 0xb2, 0x93, 0x4e, 0xb6, 0x1a, 0xb2, 0x3e, 0x18, 0xa4, 0xa8, + 0xc2, 0x19, 0x63, 0xc6, 0x97, 0xf4, 0x30, 0x7a, 0x81, 0xec, 0x2a, 0x99, + 0xc8, 0x55, 0x44, 0xed, 0xaa, 0xdb, 0x4a, 0x33, 0xa4, 0x71, 0x88, 0x5c, + 0x53, 0x0a, 0x26, 0xeb, 0xc5, 0x8b, 0xbf, 0xdf, 0xf9, 0xa2, 0xdd, 0xf4, + 0x27, 0xe3, 0xd7, 0x02, 0xd6, 0xa6, 0x91, 0x48, 0xb0, 0xb1, 0x94, 0xaa, + 0xc9, 0xfa, 0xe6, 0x7e, 0xeb, 0xdd, 0xfa, 0xf8, 0xa6, 0xea, 0xbf, 0x0c, + 0x45, 0x0a, 0x98, 0xd2, 0x28, 0x84, 0x72, 0x47, 0x54, 0x96, 0x31, 0x31, + 0x3e, 0x99, 0x00, 0xbd, 0xa7, 0x51, 0xc4, 0x28, 0x33, 0x2d, 0x8a, 0xb9, + 0x66, 0x53, 0xb6, 0xfa, 0xc4, 0xac, 0xba, 0x65, 0x0e, 0x6a, 0x4b, 0x33, + 0x76, 0x4e, 0xaf, 0x4e, 0x65, 0x2d, 0x62, 0xb5, 0x58, 0x0a, 0xe3, 0x1d, + 0xbf, 0xe5, 0xda, 0xb5, 0x3e, 0xcb, 0xc7, 0x04, 0xeb, 0xa4, 0xa7, 0x10, + 0x8c, 0xc5, 0xc5, 0x2b, 0x3c, 0x76, 0xee, 0x25, 0x14, 0x44, 0x32, 0x4f, + 0x06, 0xea, 0x56, 0x64, 0xfd, 0x2b, 0xfe, 0xa7, 0xeb, 0xbe, 0x55, 0x43, + 0x06, 0xfe, 0x13, 0x72, 0xdb, 0x2d, 0x76, 0x29, 0x6f, 0x66, 0x47, 0x7e, + 0x36, 0x8d, 0x19, 0x9b, 0x90, 0x04, 0x69, 0xf9, 0x40, 0x71, 0xdf, 0x69, + 0x8e, 0x5c, 0xa3, 0x79, 0xdb, 0x54, 0xcf, 0x7f, 0x02, 0x92, 0x4d, 0xd6, + 0x32, 0xf2, 0x82, 0xb7, 0x67, 0xe5, 0x0b, 0x8b, 0xd4, 0x93, 0x0c, 0x10, + 0x66, 0x78, 0x92, 0xe9, 0xe2, 0x96, 0x9a, 0x35, 0x3c, 0xf8, 0x3b, 0xfd, + 0xca, 0xe3, 0x6d, 0xcd, 0xfb, 0x82, 0x57, 0x4e, 0xd0, 0xa6, 0xc5, 0xf7, + 0x77, 0x17, 0x09, 0x8a, 0x72, 0xa0, 0x96, 0x5d, 0x47, 0xdb, 0xe1, 0x4d, + 0x0e, 0x57, 0x8d, 0xd8, 0xae, 0xaa, 0xb6, 0x65, 0xd2, 0xc9, 0xb2, 0xa8, + 0xda, 0xa8, 0x7a, 0xa3, 0x0b, 0x35, 0xb2, 0x6c, 0x9c, 0x3f, 0x7c, 0x14, + 0xfd, 0xdf, 0xb7, 0xad, 0x0f, 0x78, 0x47, 0x3f, 0x5a, 0x63, 0x7a, 0xe2, + 0x85, 0x4c, 0xb3, 0xa7, 0x5a, 0x30, 0x19, 0x44, 0x7f, 0x8a, 0x2c, 0x14, + 0x46, 0xb0, 0x75, 0x74, 0x3b, 0x5c, 0x12, 0xbf, 0x1b, 0x02, 0xaa, 0xf6, + 0x8a, 0x3a, 0xf7, 0x52, 0x93, 0x48, 0x39, 0xbd, 0xcd, 0x2b, 0x5a, 0x32, + 0x34, 0x44, 0xc9, 0x6d, 0xb7, 0x55, 0xec, 0x8a, 0xd4, 0xcf, 0xc8, 0x21, + 0x71, 0x52, 0x68, 0x59, 0xa4, 0xcb, 0xef, 0x0b, 0x5c, 0xd1, 0xb9, 0x9e, + 0x22, 0x79, 0xd6, 0xb6, 0x60, 0x1f, 0xf2, 0xff, 0x5c, 0x2e, 0x97, 0x40, + 0xe1, 0x91, 0x87, 0x77, 0xc5, 0xc6, 0xa8, 0x49, 0x58, 0xfa, 0x5d, 0x7c, + 0xef, 0x0d, 0xc8, 0x52, 0x29, 0x21, 0x01, 0xde, 0x72, 0xab, 0xc7, 0xec, + 0x9d, 0x99, 0xfa, 0xa5, 0x58, 0x76, 0xec, 0x34, 0xc3, 0x31, 0x04, 0x18, + 0xd0, 0x19, 0x8c, 0x2e, 0x37, 0x25, 0x5f, 0x6a, 0xef, 0x9c, 0xf5, 0x38, + 0xd5, 0x13, 0xff, 0x86, 0x08, 0xc5, 0xd4, 0xd2, 0xfc, 0xcc, 0x9c, 0x35, + 0x84, 0xa8, 0x26, 0x8b, 0x1f, 0xbe, 0x1a, 0x3d, 0xa0, 0x90, 0x3f, 0x3d, + 0x13, 0x15, 0x53, 0x68, 0xe7, 0x46, 0xec, 0x12, 0xaf, 0xbd, 0x68, 0xc9, + 0x2a, 0x9b, 0xce, 0x83, 0xe9, 0x09, 0xb7, 0x1e, 0x14, 0x56, 0x25, 0x5e, + 0x58, 0xde, 0xb4, 0xdf, 0xde, 0xa8, 0xe5, 0x20, 0xed, 0x5e, 0xa5, 0xc3, + 0xf7, 0x85, 0x53, 0x41, 0xe4, 0xca, 0xc4, 0xb4, 0x0a, 0x77, 0x4d, 0x2a, + 0xa5, 0x0e, 0x93, 0x1f, 0x18, 0x30, 0x63, 0x16, 0xd4, 0x26, 0xe8, 0x9d, + 0x1e, 0x6d, 0x57, 0xaf, 0x09, 0xdc, 0x97, 0x26, 0x7c, 0xc2, 0x16, 0x06, + 0xfe, 0xf7, 0xaa, 0xb5, 0xcc, 0x60, 0x54, 0xee, 0x20, 0xb2, 0x83, 0x9b, + 0x38, 0x09, 0x28, 0x95, 0xc5, 0x4f, 0xe5, 0x17, 0x19, 0x4d, 0xba, 0xf5, + 0x9e, 0xeb, 0xc5, 0x73, 0xae, 0x8e, 0x53, 0xba, 0x8a, 0xf2, 0x91, 0x45, + 0x45, 0x99, 0x14, 0x4b, 0xac, 0x81, 0x8a, 0x6b, 0xce, 0x43, 0xf1, 0xec, + 0x5b, 0x5b, 0x47, 0x1a, 0x14, 0x9e, 0x2a, 0x7f, 0x44, 0x38, 0x48, 0x7a, + 0x14, 0x0b, 0x6b, 0x4a, 0xb5, 0x4b, 0xc2, 0x35, 0x57, 0xe6, 0xf2, 0x05, + 0x78, 0x79, 0xc3, 0xaa, 0x8f, 0xf4, 0xf4, 0xf8, 0x32, 0x2a, 0x6b, 0xf6, + 0xe9, 0xaf, 0x21, 0xb8, 0x75, 0xa9, 0x76, 0xc9, 0x21, 0xb7, 0x0b, 0xee, + 0x26, 0x0b, 0xa7, 0x3f, 0xa0, 0xec, 0x98, 0x25, 0x4e, 0x5a, 0x53, 0xae, + 0xea, 0x43, 0x0f, 0xcd, 0x5c, 0xa7, 0xbc, 0x36, 0xf6, 0x2b, 0x94, 0x90, + 0x1c, 0xa8, 0xbf, 0x67, 0xe5, 0xc1, 0x3c, 0x4f, 0x13, 0x3d, 0x83, 0x17, + 0x30, 0xd5, 0x3b, 0x3c, 0x4b, 0x19, 0xac, 0x8c, 0x5f, 0x1f, 0x15, 0x1d, + 0xe3, 0x7b, 0x3f, 0x3f, 0x4f, 0x99, 0xa1, 0x5d, 0x76, 0x92, 0x4e, 0x18, + 0xa5, 0xe8, 0x9b, 0x0b, 0xc4, 0x51, 0xb4, 0x30, 0x2d, 0xb7, 0x85, 0x57, + 0x7e, 0x15, 0x6b, 0x12, 0x72, 0x2e, 0xa4, 0xb4, 0xce, 0xf0, 0x38, 0xf9, + 0xcf, 0x0c, 0x68, 0x40, 0x6a, 0xd0, 0x2f, 0x6c, 0x30, 0x01, 0x51, 0x4a, + 0x0d, 0x96, 0xe3, 0x23, 0xc7, 0xf6, 0x29, 0x4d, 0x7c, 0xa6, 0x31, 0xfd, + 0xc9, 0x57, 0x9f, 0x91, 0x79, 0x1d, 0x16, 0x91, 0xe2, 0xd4, 0x06, 0x4c, + 0xba, 0x5c, 0xae, 0x6b, 0x96, 0x55, 0xae, 0xa5, 0x38, 0xc9, 0x75, 0x12, + 0x96, 0xfa, 0x01, 0xd3, 0x3a, 0x4b, 0xaf, 0x78, 0xf9, 0x09, 0x1c, 0x42, + 0x24, 0x95, 0xca, 0xf4, 0x3a, 0xc5, 0x5b, 0x68, 0x73, 0xfd, 0x83, 0x22, + 0x16, 0x25, 0x5f, 0x97, 0x66, 0xa2, 0x72, 0xcd, 0xec, 0xf2, 0xa9, 0xab, + 0xb2, 0xdb, 0x09, 0x69, 0xcf, 0xce, 0x93, 0x73, 0x74, 0x15, 0x2a, 0xd9, + 0xe4, 0xb0, 0xbb, 0x34, 0xa9, 0xfe, 0x91, 0xca, 0x65, 0x9d, 0x85, 0x49, + 0x0d, 0x8f, 0xc9, 0x2c, 0x40, 0x2c, 0x82, 0x30, 0x16, 0xf3, 0x34, 0x48, + 0x57, 0xfc, 0x33, 0xa5, 0x45, 0x87, 0x06, 0xd7, 0x6a, 0x2f, 0x94, 0x4c, + 0x67, 0xc5, 0x8d, 0x70, 0xb4, 0xf4, 0x58, 0x52, 0x8f, 0x44, 0x2c, 0xd5, + 0xf7, 0x29, 0x87, 0x22, 0x14, 0xff, 0x94, 0xbd, 0x41, 0xae, 0x80, 0x68, + 0x1c, 0xb6, 0xd3, 0x1e, 0x85, 0x52, 0x7a, 0xa2, 0x92, 0xd2, 0x56, 0xdd, + 0x73, 0xb2, 0x01, 0x61, 0xc8, 0xb9, 0x88, 0x90, 0xad, 0xb2, 0x96, 0x87, + 0xe7, 0xca, 0x12, 0x04, 0x62, 0xbf, 0xae, 0x50, 0x80, 0x91, 0x19, 0x52, + 0xe7, 0xdf, 0x4c, 0xda, 0x15, 0x89, 0x13, 0xb8, 0xb5, 0xd2, 0x4a, 0x93, + 0x67, 0xc3, 0x28, 0x6d, 0xe5, 0xc3, 0xe7, 0x6e, 0x63, 0xbd, 0x33, 0x4a, + 0x87, 0xb8, 0x8a, 0x57, 0x76, 0x66, 0x4e, 0xdd, 0xd4, 0x7d, 0x3d, 0x72, + 0x5c, 0x99, 0xb9, 0x57, 0x61, 0x15, 0x33, 0xd8, 0x85, 0x0b, 0x8e, 0x8c, + 0x8a, 0x57, 0xda, 0x73, 0x16, 0xd2, 0xbf, 0x1f, 0xaa, 0x56, 0x03, 0x0c, + 0xb6, 0xcb, 0x20, 0x59, 0xfd, 0x2b, 0x52, 0xb8, 0x3c, 0xe3, 0xf9, 0xc1, + 0x8d, 0x98, 0x40, 0x55, 0x74, 0xd5, 0xe0, 0xce, 0xab, 0xa6, 0x05, 0x74, + 0x85, 0x0b, 0x68, 0x45, 0xc7, 0x52, 0xd3, 0x69, 0x84, 0xdb, 0xf8, 0xb3, + 0xaf, 0x5d, 0x75, 0xc4, 0xa9, 0x47, 0xa4, 0x5c, 0x92, 0x2e, 0xe2, 0xd9, + 0x60, 0x46, 0x89, 0x14, 0xfd, 0x11, 0x88, 0xfb, 0x99, 0x0a, 0x74, 0x84, + 0xbd, 0xc3, 0x8f, 0xc9, 0xaf, 0x36, 0x22, 0x63, 0x1a, 0xcd, 0xb4, 0x5b, + 0x75, 0xe0, 0x99, 0x7b, 0xa4, 0x09, 0x4a, 0x5a, 0xb2, 0x2b, 0x5e, 0x05, + 0x0a, 0x07, 0xda, 0xd2, 0xcd, 0x13, 0x57, 0x4a, 0x7f, 0x95, 0x83, 0x08, + 0xb6, 0x6f, 0xd7, 0x5a, 0x07, 0xab, 0xf0, 0xa8, 0x91, 0x4e, 0x19, 0xa9, + 0x8b, 0xc2, 0x48, 0xb5, 0x89, 0xf0, 0xcf, 0x7b, 0x86, 0xcd, 0xcd, 0x96, + 0x20, 0x26, 0xd8, 0x4a, 0x41, 0x71, 0x72, 0x91, 0x4b, 0x65, 0xb1, 0x79, + 0x49, 0x0e, 0x9a, 0x76, 0xd8, 0xc6, 0x25, 0xca, 0xaa, 0x70, 0xa4, 0x09, + 0x2e, 0x35, 0xcf, 0xc9, 0xee, 0x2e, 0x47, 0xab, 0xaa, 0x26, 0xb6, 0x16, + 0x62, 0x16, 0x25, 0x18, 0xf5, 0xce, 0x8f, 0x52, 0x74, 0xe5, 0x4c, 0x9e, + 0x76, 0x36, 0x8c, 0x89, 0x86, 0xb4, 0x81, 0x0f, 0xde, 0x61, 0x7e, 0xfd, + 0xdc, 0x67, 0x1e, 0x9c, 0x84, 0x90, 0xb6, 0x89, 0xd6, 0xbe, 0x32, 0x70, + 0x90, 0x6b, 0x91, 0xd0, 0x6a, 0x28, 0x09, 0xc7, 0x85, 0x25, 0x39, 0x5e, + 0x5b, 0xa5, 0x95, 0x9a, 0x8d, 0x47, 0xe6, 0x91, 0x9b, 0x9b, 0xde, 0x4b, + 0xf8, 0xe9, 0xf3, 0xe9, 0x70, 0x8c, 0x6f, 0xbd, 0xda, 0x5d, 0x68, 0xc1, + 0x40, 0xf4, 0x84, 0xa0, 0x58, 0x3e, 0x3d, 0x6b, 0x90, 0x80, 0x2a, 0x2d, + 0x7d, 0x7d, 0xf6, 0x41, 0x1a, 0x21, 0x5e, 0x48, 0x3c, 0x23, 0x92, 0xaf, + 0x15, 0xd0, 0xad, 0xa6, 0xb3, 0xd5, 0x14, 0xd5, 0xf0, 0x75, 0x33, 0xa7, + 0x53, 0x61, 0x22, 0x46, 0x68, 0x47, 0x9c, 0xaa, 0xa3, 0x47, 0xb2, 0xff, + 0xcb, 0x14, 0x96, 0x4d, 0x37, 0x93, 0x69, 0xcd, 0x16, 0xb8, 0xbe, 0x89, + 0x64, 0x12, 0x71, 0xfc, 0xf5, 0x73, 0xd1, 0xc4, 0x62, 0xce, 0xd9, 0xbb, + 0xa6, 0x86, 0x07, 0x6e, 0x40, 0x84, 0xb5, 0x80, 0x16, 0xbe, 0xca, 0x2c, + 0xb4, 0xb3, 0x28, 0x9a, 0x85, 0xc2, 0xac, 0xdc, 0x4c, 0xfa, 0x94, 0x05, + 0x14, 0x2a, 0x50, 0xf6, 0x09, 0xf8, 0x9f, 0xf8, 0x64, 0x8c, 0x81, 0x55, + 0x38, 0x15, 0x21, 0x37, 0xfe, 0xed, 0xbc, 0x2e, 0xd4, 0x61, 0xaf, 0x2c, + 0x21, 0xe7, 0xf3, 0xa6, 0x2a, 0x27, 0x6b, 0x24, 0xae, 0x92, 0xf4, 0x5e, + 0xed, 0x34, 0x6b, 0x93, 0xe4, 0x46, 0xd3, 0xdc, 0x14, 0x8c, 0x9f, 0x85, + 0x69, 0xb4, 0xaa, 0x5d, 0x2b, 0x96, 0x25, 0x25, 0x39, 0x03, 0xba, 0xf5, + 0x44, 0x99, 0x10, 0xf0, 0x46, 0xf5, 0x1b, 0x07, 0x23, 0x8b, 0x1e, 0xa8, + 0xf6, 0xc0, 0xd7, 0xd8, 0x5e, 0x71, 0x50, 0xc5, 0x41, 0x1a, 0xa5, 0x15, + 0xf9, 0xe4, 0xcf, 0x7c, 0xe6, 0x31, 0x64, 0x21, 0x1f, 0x42, 0xe9, 0x9c, + 0x9f, 0x11, 0x4d, 0x2f, 0x16, 0x84, 0x0c, 0x53, 0xc2, 0xce, 0x4f, 0xa7, + 0x15, 0xca, 0xfd, 0x7a, 0xf2, 0x50, 0x87, 0x9a, 0x83, 0xdf, 0x7a, 0x18, + 0x84, 0x11, 0x8c, 0x02, 0x56, 0xc7, 0x32, 0x0a, 0x79, 0x9f, 0xa5, 0x12, + 0x9f, 0xd9, 0xbd, 0x44, 0x15, 0xb8, 0xf2, 0xf2, 0x12, 0x25, 0x07, 0xf6, + 0x94, 0x32, 0xb7, 0xc0, 0x97, 0xa1, 0xe4, 0xb4, 0x96, 0x33, 0x02, 0xc3, + 0xc6, 0xd7, 0xde, 0x5f, 0xac, 0x15, 0xa7, 0x8d, 0xf9, 0x52, 0xb7, 0x4f, + 0x86, 0x76, 0x85, 0xe9, 0x30, 0x91, 0xbf, 0xcb, 0x32, 0x41, 0x41, 0x24, + 0x75, 0xc4, 0x76, 0x85, 0x68, 0x01, 0x70, 0xa2, 0x08, 0x48, 0xc2, 0x10, + 0xad, 0x3a, 0xb6, 0xc8, 0x5a, 0x8d, 0x35, 0x31, 0x4a, 0x13, 0x7b, 0x09, + 0xf0, 0xd0, 0x19, 0x52, 0x72, 0x28, 0xee, 0x7b, 0xf3, 0x6f, 0x64, 0x50, + 0x2a, 0x6c, 0xd8, 0x91, 0x21, 0x55, 0xe2, 0xdb, 0x6f, 0x86, 0xaa, 0xd7, + 0xd9, 0x5c, 0x5e, 0x15, 0x9c, 0x2f, 0x41, 0xb9, 0x53, 0x1a, 0x14, 0x8e, + 0x70, 0xc2, 0x63, 0x8d, 0xe7, 0xfa, 0x4d, 0x0a, 0xb5, 0x5c, 0x09, 0x67, + 0x47, 0x31, 0x0b, 0x7e, 0x62, 0xa1, 0x57, 0x14, 0x44, 0xff, 0x62, 0x02, + 0xe3, 0xfe, 0xc9, 0xed, 0xdb, 0x30, 0x1f, 0x9c, 0xda, 0x1d, 0x09, 0xb8, + 0x6e, 0xe1, 0xee, 0x31, 0x0c, 0xf2, 0x74, 0x01, 0x32, 0xbf, 0xb6, 0xcf, + 0x5e, 0xbc, 0x0a, 0x42, 0x10, 0x10, 0xb8, 0x9e, 0xb2, 0xaa, 0x4c, 0xd5, + 0xd2, 0x1d, 0xdb, 0xb8, 0x48, 0x4e, 0xc7, 0xd5, 0xef, 0x8f, 0x54, 0xe4, + 0x32, 0x1b, 0x95, 0x79, 0x5d, 0x47, 0xf2, 0xa1, 0x58, 0xa9, 0xf9, 0x8a, + 0x61, 0xbc, 0x75, 0xf1, 0xbd, 0x1d, 0xea, 0x3f, 0x18, 0x5f, 0x63, 0xd3, + 0x96, 0xdd, 0x70, 0xf1, 0x97, 0xa0, 0x05, 0xf1, 0xff, 0xf8, 0x3d, 0x08, + 0x18, 0x2b, 0x11, 0x9b, 0x4c, 0x16, 0x00, 0x17, 0x00, 0x06, 0x00, 0xfb, + 0x00, 0xf5, 0x00, 0xf1, 0x00, 0xfe, 0x00, 0xe6, 0xb4, 0x4e, 0xa1, 0x6c, + 0xd4, 0xba, 0x83, 0x21, 0x7a, 0x5e, 0x61, 0x01, 0x0f, 0x82, 0xb2, 0x75, + 0x8b, 0xa9, 0xb5, 0xa9, 0x4b, 0x77, 0xc2, 0xff, 0x2f, 0xde, 0x1e, 0x1f, + 0xe7, 0x59, 0x5a, 0x5c, 0x77, 0x84, 0x86, 0xc2, 0x1e, 0xe5, 0xee, 0x6a, + 0x33, 0xde, 0x45, 0xc9, 0xe4, 0x41, 0xbd, 0xb6, 0x91, 0xe8, 0x29, 0x87, + 0x17, 0x42, 0xd2, 0xb6, 0xe8, 0xd0, 0x74, 0x04, 0x35, 0x4a, 0x0d, 0xee, + 0x1c, 0xc3, 0x97, 0x80, 0xe5, 0x2c, 0x6e, 0x87, 0xd9, 0x7e, 0xc6, 0x14, + 0x3a, 0xaf, 0x19, 0xbc, 0xec, 0x5e, 0xc5, 0x26, 0x26, 0xaa, 0xab, 0xb5, + 0x16, 0x28, 0x12, 0x1c, 0xe1, 0x2a, 0xc0, 0x2c, 0xf1, 0xb3, 0xb3, 0x1b, + 0x76, 0x8d, 0xe5, 0x21, 0x26, 0x74, 0x51, 0x1f, 0x63, 0xdf, 0xa1, 0x51, + 0xf6, 0xa6, 0x31, 0x66, 0x72, 0x13, 0xfb, 0xdf, 0x31, 0x00, 0x81, 0x6a, + 0x3b, 0x74, 0x38, 0x50, 0xbd, 0x51, 0x53, 0x10, 0xef, 0x84, 0xba, 0x22, + 0xf8, 0xe2, 0x39, 0x95, 0x83, 0xe1, 0xf6, 0x5e, 0x18, 0xa2, 0x66, 0x40, + 0xb0, 0x99, 0x5a, 0xe1, 0xf2, 0x97, 0x21, 0x70, 0x1f, 0xd4, 0xad, 0xd5, + 0x86, 0x69, 0x33, 0x04, 0xc8, 0xfb, 0x6d, 0x89, 0xa8, 0xe5, 0x30, 0x5a, + 0xe6, 0xea, 0x7a, 0x39, 0x7a, 0xe2, 0x0d, 0x5d, 0x96, 0xc8, 0x59, 0x19, + 0xdc, 0xa7, 0x10, 0x7d, 0x29, 0x26, 0x22, 0x26, 0xeb, 0x25, 0x2c, 0x4f, + 0x3a, 0x33, 0xe1, 0x9b, 0x25, 0x20, 0x37, 0xfc, 0x5a, 0x06, 0xcc, 0x73, + 0x74, 0x47, 0x4d, 0xb2, 0xc3, 0x90, 0xcc, 0x1f, 0xd0, 0x8f, 0x72, 0x32, + 0x0f, 0x79, 0x5b, 0x84, 0x88, 0xc5, 0xe9, 0x1e, 0x69, 0x8d, 0x23, 0xfc, + 0xb6, 0xe4, 0xe1, 0x10, 0xba, 0x51, 0xd9, 0x27, 0x2e, 0xed, 0xb9, 0x97, + 0x1e, 0xd1, 0x2d, 0x45, 0xc6, 0xe3, 0xe4, 0x86, 0xf4, 0xb3, 0x2d, 0xe7, + 0xb3, 0xbc, 0x21, 0xa8, 0x42, 0x06, 0xd6, 0xcf, 0x76, 0xdb, 0xbf, 0x20, + 0xec, 0x45, 0x6b, 0x21, 0xfe, 0xbc, 0xa2, 0xb0, 0x4e, 0xe1, 0x6c, 0xc5, + 0x9d, 0x23, 0x06, 0xfc, 0x15, 0xcf, 0x33, 0x9c, 0x10, 0xa8, 0x5a, 0xc2, + 0x2e, 0xfe, 0xd7, 0x92, 0x2f, 0x20, 0xa5, 0x61, 0xfa, 0x28, 0xa2, 0x7c, + 0xe2, 0x27, 0x37, 0x10, 0x8b, 0x91, 0xf5, 0x4a, 0xef, 0x91, 0x71, 0x97, + 0xb4, 0x8e, 0x8a, 0x92, 0xf1, 0x0e, 0x1e, 0x5e, 0x02, 0x9e, 0x54, 0xe1, + 0x08, 0x07, 0x2b, 0x29, 0x0b, 0x90, 0x9c, 0x81, 0xbb, 0xa6, 0x56, 0x7c, + 0xa0, 0xf2, 0x85, 0x93, 0xb0, 0xc9, 0x72, 0xbd, 0x64, 0xb7, 0x49, 0x4f, + 0x62, 0x79, 0x40, 0xeb, 0x35, 0xf1, 0x7c, 0xb4, 0xca, 0x74, 0x10, 0xb0, + 0xb4, 0xc4, 0x34, 0x04, 0x92, 0xd2, 0xe9, 0x19, 0x37, 0xa7, 0x66, 0x73, + 0x09, 0xfd, 0x6c, 0xaf, 0xd5, 0xed, 0x78, 0x92, 0xc1, 0x1d, 0xd2, 0xb7, + 0x50, 0xb5, 0xf0, 0xb7, 0x80, 0x8d, 0xcb, 0xc8, 0x56, 0xf6, 0x13, 0xa6, + 0x80, 0x9f, 0x62, 0x99, 0x09, 0xd8, 0xff, 0x96, 0xbd, 0x40, 0xef, 0x41, + 0x52, 0xc1, 0xc5, 0x6e, 0x67, 0x4a, 0xea, 0x68, 0x4d, 0x8c, 0x74, 0xcb, + 0xd4, 0x5e, 0xde, 0x54, 0xda, 0x8a, 0x7e, 0x14, 0x4b, 0x2f, 0x6c, 0xce, + 0xfb, 0xa8, 0xac, 0xe4, 0x6f, 0x49, 0x0a, 0xf5, 0x06, 0xea, 0xc0, 0x8d, + 0x2b, 0xaf, 0x22, 0xe8, 0xd2, 0x90, 0xb1, 0xcd, 0xf0, 0x09, 0x4a, 0x21, + 0xb5, 0x89, 0x1e, 0x58, 0x22, 0x8b, 0x3c, 0x06, 0xcf, 0x71, 0x6e, 0x78, + 0x32, 0x50, 0x13, 0x45, 0x96, 0x86, 0xee, 0x73, 0xff, 0x10, 0x5e, 0xe4, + 0xf0, 0x5f, 0x6b, 0x3c, 0x25, 0x95, 0x17, 0x2a, 0xd2, 0x87, 0x6e, 0x6f, + 0xb5, 0x6a, 0x80, 0xcd, 0x9b, 0x74, 0xd0, 0xa6, 0xb3, 0xf9, 0x54, 0xba, + 0x78, 0xe2, 0xd3, 0x55, 0x4b, 0xf1, 0x53, 0xb2, 0xf4, 0xad, 0x32, 0x23, + 0x98, 0xaa, 0x15, 0x55, 0xba, 0x23, 0xef, 0x64, 0x69, 0x93, 0x5a, 0xfe, + 0xf4, 0x38, 0xa6, 0x4e, 0xd8, 0x75, 0x5d, 0x22, 0xdf, 0x7f, 0x74, 0xf7, + 0xee, 0xff, 0x60, 0x24, 0x38, 0x51, 0xb1, 0x60, 0x6e, 0xaa, 0x39, 0xf1, + 0xd5, 0x41, 0x9e, 0x1a, 0x34, 0x1a, 0x49, 0xad, 0x7c, 0xd3, 0xfe, 0x28, + 0xd4, 0x90, 0x8d, 0x7a, 0xf0, 0x72, 0x72, 0xd2, 0x49, 0x9b, 0x24, 0xa0, + 0x10, 0x0e, 0xa7, 0xdc, 0xc2, 0x9d, 0xba, 0x61, 0x12, 0xb9, 0x96, 0xfe, + 0xa4, 0xba, 0x60, 0xdf, 0x48, 0xbb, 0xa2, 0x52, 0x5b, 0x37, 0xe9, 0xe3, + 0x7f, 0x9e, 0xc1, 0x43, 0x99, 0xbe, 0x1e, 0xf2, 0xa8, 0x32, 0xaa, 0xaf, + 0x12, 0x67, 0xf3, 0x17, 0xc5, 0x5a, 0xfc, 0x82, 0xf3, 0x0c, 0x52, 0x10, + 0x53, 0x51, 0x37, 0x04, 0x8a, 0x2f, 0x2f, 0x38, 0x2b, 0x8a, 0x50, 0xbe, + 0xf5, 0x74, 0xf0, 0x2b, 0x58, 0x24, 0xb1, 0x9d, 0x98, 0x09, 0xa8, 0x58, + 0x63, 0xbb, 0xef, 0x52, 0xdd, 0xec, 0x79, 0x32, 0xea, 0xb4, 0xfc, 0x3a, + 0x65, 0xf6, 0x71, 0xbc, 0x10, 0x93, 0x76, 0xb9, 0x94, 0xc5, 0x4c, 0xa5, + 0x20, 0xb7, 0xad, 0xe2, 0x08, 0x56, 0x55, 0x0f, 0x59, 0xa6, 0xc2, 0x22, + 0xb0, 0x4a, 0xd4, 0xf3, 0x37, 0x10, 0xff, 0x43, 0xa8, 0xd0, 0xdc, 0x23, + 0xed, 0xe4, 0x67, 0x4f, 0x9c, 0x8e, 0x75, 0x3e, 0x7b, 0x2e, 0xc3, 0x80, + 0xca, 0x3d, 0xbc, 0x80, 0x26, 0xc0, 0xe9, 0x96, 0x06, 0xae, 0xbf, 0xcc, + 0xdf, 0x31, 0x31, 0xa3, 0x2a, 0x55, 0xb2, 0x2b, 0x7c, 0xca, 0x52, 0x13, + 0x8e, 0x7f, 0xb9, 0x8b, 0x65, 0x27, 0x76, 0xcf, 0xb2, 0xf6, 0x0f, 0xc3, + 0x30, 0x8a, 0x61, 0xb2, 0x20, 0x16, 0x47, 0x93, 0xac, 0x09, 0x74, 0x8e, + 0xbb, 0x2b, 0x34, 0x43, 0xc6, 0x9a, 0x22, 0x0a, 0xb2, 0xd1, 0xb5, 0x3e, + 0xe5, 0x7c, 0xd5, 0xea, 0xb9, 0x06, 0x78, 0xf9, 0xfc, 0x17, 0xcc, 0xa2, + 0xba, 0x05, 0x49, 0xbf, 0xe3, 0x4a, 0x2c, 0x4d, 0x95, 0xc3, 0xe2, 0xcc, + 0x09, 0x9e, 0x29, 0x2f, 0xf3, 0x63, 0xf8, 0xf9, 0x18, 0x97, 0xfb, 0xd8, + 0xa6, 0xf1, 0xfa, 0x79, 0x53, 0xbc, 0x93, 0xd0, 0x27, 0x39, 0x50, 0x69, + 0x57, 0x8a, 0x44, 0x27, 0xdb, 0x1a, 0xd8, 0x30, 0x6e, 0x70, 0x5d, 0x74, + 0x22, 0x0e, 0xa8, 0x80, 0x7e, 0xa9, 0x22, 0x49, 0x97, 0x2c, 0x94, 0x29, + 0xf9, 0xda, 0xff, 0xa2, 0x39, 0xeb, 0xb1, 0x19, 0xeb, 0xd8, 0x3f, 0xb5, + 0x88, 0xdb, 0x68, 0x75, 0x0d, 0xe5, 0xa2, 0xcd, 0xd7, 0xa1, 0xfa, 0x4a, + 0x5c, 0x99, 0x8c, 0xe9, 0x48, 0x66, 0x24, 0x3f, 0x97, 0x82, 0x3f, 0x67, + 0x91, 0x88, 0x7f, 0xb3, 0x50, 0xd1, 0x18, 0x94, 0x81, 0x9e, 0xc7, 0x34, + 0x58, 0x7f, 0xf5, 0x4b, 0x74, 0x48, 0xeb, 0xd6, 0xf9, 0x15, 0xac, 0x54, + 0x23, 0xf4, 0x26, 0xb1, 0x33, 0xbb, 0x1b, 0x5d, 0xa8, 0x81, 0x3d, 0xbf, + 0x94, 0x9d, 0x5d, 0x83, 0x49, 0x97, 0x53, 0xfa, 0x2c, 0xe7, 0x84, 0x45, + 0xe0, 0x34, 0x73, 0x85, 0x9f, 0x59, 0x7e, 0x27, 0x25, 0x5b, 0xd6, 0x0c, + 0x52, 0x30, 0x82, 0x1f, 0x41, 0xbd, 0x76, 0xc4, 0x60, 0xa9, 0xb5, 0x12, + 0x9f, 0x9b, 0x79, 0xed, 0x88, 0x67, 0x48, 0x6b, 0x35, 0xde, 0x25, 0xe2, + 0x32, 0xde, 0xa2, 0x0e, 0xd8, 0x3a, 0x45, 0x53, 0x68, 0x8b, 0x3f, 0xe3, + 0xb5, 0x1c, 0xbb, 0x11, 0x2a, 0x08, 0xad, 0x12, 0xff, 0x7a, 0x98, 0x29, + 0x36, 0xbf, 0x2a, 0xbb, 0xa5, 0x6d, 0xe2, 0xe3, 0x76, 0x2b, 0xa2, 0xe3, + 0x1f, 0xd4, 0xa6, 0xaf, 0x18, 0xe1, 0x44, 0x99, 0xe5, 0xfd, 0x44, 0x58, + 0xe8, 0xae, 0x11, 0x8c, 0xa6, 0xe6, 0x05, 0x51, 0xd7, 0x29, 0x40, 0xe9, + 0xd2, 0xfa, 0x01, 0x93, 0x62, 0x90, 0x57, 0x1d, 0x02, 0x23, 0xcd, 0x9e, + 0x97, 0xcc, 0xc8, 0x4a, 0x61, 0xaf, 0xe7, 0xeb, 0x13, 0x4b, 0x6a, 0x44, + 0x65, 0x67, 0x2f, 0xb5, 0xe4, 0xf3, 0xdf, 0x57, 0xcb, 0x22, 0xa6, 0x9f, + 0xd6, 0x3e, 0x0d, 0x63, 0x67, 0x2b, 0xdf, 0x18, 0xf4, 0xf7, 0x2d, 0xf3, + 0x07, 0x45, 0xa1, 0x2b, 0x8b, 0xc5, 0x09, 0xa0, 0xa2, 0xba, 0x62, 0xa8, + 0x84, 0x2e, 0x8e, 0x96, 0xf2, 0xb3, 0xc7, 0x05, 0x0c, 0xb1, 0x7a, 0x45, + 0xe5, 0xcc, 0xf5, 0x2a, 0x8f, 0xdf, 0xff, 0x06, 0x57, 0xb4, 0x85, 0x11, + 0x6c, 0x7e, 0x28, 0xd8, 0x19, 0x47, 0x35, 0xda, 0xda, 0xed, 0x48, 0x6e, + 0x1d, 0xd0, 0x54, 0xc1, 0x33, 0x04, 0x6d, 0xb0, 0x7b, 0xbf, 0xdd, 0xec, + 0x1b, 0x76, 0xfc, 0x71, 0xc9, 0xe9, 0xe4, 0x7a, 0x44, 0x54, 0xe4, 0xa3, + 0x01, 0x2f, 0xe6, 0xcd, 0x29, 0x81, 0xaf, 0x08, 0x63, 0x90, 0xe6, 0x64, + 0xce, 0x88, 0xbc, 0x20, 0x92, 0x61, 0x3e, 0x65, 0x91, 0x48, 0x61, 0x53, + 0xaa, 0x7f, 0x33, 0x4b, 0x52, 0xb1, 0xed, 0xfa, 0x90, 0xcb, 0x50, 0x77, + 0x7a, 0x33, 0x39, 0x83, 0xad, 0x97, 0xa4, 0x2e, 0xc0, 0xa6, 0xce, 0x50, + 0x79, 0xa9, 0x55, 0x6c, 0xed, 0x78, 0x95, 0x10, 0x48, 0xdb, 0xe2, 0x64, + 0x67, 0x54, 0x3d, 0x71, 0x88, 0x88, 0x8f, 0x15, 0x5f, 0x5e, 0xe2, 0x0a, + 0xf8, 0x05, 0x0d, 0x3a, 0xb5, 0x77, 0x06, 0xc2, 0x0e, 0x5e, 0xce, 0x93, + 0xaf, 0xb1, 0x46, 0x4e, 0x7f, 0x51, 0x15, 0x0e, 0xb8, 0x0c, 0x22, 0xd9, + 0xe1, 0x57, 0x97, 0xf5, 0xaa, 0xe6, 0xad, 0x64, 0x98, 0x8e, 0x6f, 0x99, + 0xe8, 0xa3, 0xf5, 0x0b, 0xd7, 0xff, 0x66, 0x20, 0x44, 0xf1, 0x89, 0x32, + 0xd4, 0x73, 0xa7, 0x32, 0xe4, 0x60, 0xf6, 0xa3, 0x67, 0x0f, 0x3d, 0x2a, + 0x47, 0x81, 0x6e, 0x8f, 0x8e, 0x99, 0x6e, 0x84, 0x7b, 0xdb, 0xfa, 0x44, + 0xb7, 0xe6, 0x90, 0x20, 0x70, 0x44, 0x16, 0xa5, 0x95, 0xb5, 0xaf, 0xd9, + 0x6b, 0xf9, 0xa8, 0xdf, 0xbe, 0x53, 0x11, 0x1f, 0xd1, 0x6e, 0xe7, 0x5e, + 0x56, 0x29, 0xba, 0x85, 0x74, 0x41, 0x54, 0x58, 0x39, 0x7c, 0xa5, 0xa1, + 0xf1, 0x34, 0x35, 0xe4, 0xed, 0x2a, 0x72, 0x75, 0x6a, 0xe5, 0x18, 0x3e, + 0x45, 0x84, 0xd2, 0x82, 0x90, 0x89, 0x67, 0x10, 0x38, 0x14, 0xfd, 0x89, + 0x2f, 0xb7, 0xd8, 0x28, 0xf1, 0xbc, 0x07, 0xa1, 0xf6, 0xe3, 0xe2, 0xec, + 0x24, 0x2c, 0xdf, 0x0f, 0xb2, 0x03, 0x8b, 0x68, 0x68, 0x20, 0x7a, 0x97, + 0xa4, 0x18, 0x20, 0x3f, 0x87, 0xda, 0xb8, 0x7d, 0x73, 0xdd, 0xa3, 0x26, + 0x95, 0x7e, 0x2b, 0x72, 0xd0, 0x59, 0x30, 0xe6, 0x2c, 0x73, 0x66, 0x85, + 0xa3, 0x18, 0xdc, 0x1f, 0x74, 0xb1, 0x5c, 0x25, 0x93, 0x39, 0xf8, 0xeb, + 0xde, 0x91, 0xe6, 0x75, 0x0d, 0xeb, 0x6a, 0x10, 0x1f, 0x6e, 0x6b, 0x58, + 0xb9, 0xdd, 0x30, 0x87, 0x7f, 0x5c, 0xf2, 0xfe, 0xee, 0x21, 0x90, 0x63, + 0x9f, 0x54, 0x0e, 0x27, 0xf5, 0x95, 0x18, 0x1d, 0x68, 0xba, 0xe2, 0x47, + 0x33, 0xbd, 0x08, 0x35, 0x2f, 0xec, 0xa4, 0x05, 0xe2, 0x8f, 0xea, 0xd4, + 0x7e, 0x8b, 0xb4, 0x62, 0xff, 0x67, 0x9d, 0xad, 0xac, 0xd3, 0x75, 0x37, + 0x8a, 0x68, 0xed, 0xfe, 0xde, 0xd3, 0xd5, 0xa2, 0xbe, 0x74, 0xe0, 0x26, + 0xcd, 0x01, 0xcb, 0xf4, 0xee, 0x55, 0x6d, 0x9f, 0x02, 0x1f, 0x71, 0xb0, + 0x96, 0x8c, 0xf7, 0xf2, 0x55, 0x09, 0x28, 0xb5, 0xcf, 0xba, 0x4a, 0x89, + 0x5d, 0x0d, 0x4e, 0x17, 0x23, 0x69, 0xce, 0x2a, 0x2d, 0x82, 0x10, 0xdf, + 0xb3, 0x08, 0xb1, 0x02, 0x4f, 0xaf, 0x28, 0x25, 0x55, 0x44, 0xa3, 0xe1, + 0x8c, 0x8e, 0xa6, 0x1a, 0x80, 0xba, 0x59, 0xd7, 0x89, 0xdf, 0x8e, 0x3d, + 0x74, 0xb1, 0x0f, 0x22, 0x0a, 0x2b, 0x07, 0xc3, 0x85, 0x18, 0xf8, 0xc4, + 0x7f, 0x4e, 0xe1, 0x53, 0x01, 0xda, 0xf4, 0x02, 0xba, 0x42, 0x8d, 0xc4, + 0x13, 0x82, 0xc9, 0xca, 0x7b, 0x96, 0x59, 0xd6, 0x19, 0x64, 0x81, 0x09, + 0xfc, 0x06, 0x27, 0xe4, 0xef, 0xe5, 0xe1, 0xcd, 0xfa, 0x72, 0x94, 0xf8, + 0xe4, 0x41, 0x8c, 0x08, 0xfb, 0xa5, 0x14, 0x4b, 0xea, 0xc0, 0x7d, 0x04, + 0x94, 0x77, 0xaf, 0x2e, 0xb1, 0x69, 0x1d, 0x3a, 0x5c, 0x65, 0x37, 0x21, + 0xb9, 0x75, 0x9e, 0x2d, 0xde, 0x2a, 0xc5, 0x86, 0xd8, 0x9f, 0x75, 0x1a, + 0x6e, 0xe2, 0xfe, 0x1b, 0x02, 0x3f, 0x77, 0x7b, 0x96, 0xed, 0x91, 0x01, + 0x30, 0xe6, 0x36, 0x35, 0x21, 0xd5, 0xc2, 0xba, 0x75, 0xd7, 0x65, 0x41, + 0x1f, 0x24, 0x16, 0xdd, 0xda, 0xfa, 0x44, 0x98, 0x81, 0xa5, 0xc2, 0xd1, + 0xe8, 0x51, 0x58, 0xb8, 0x94, 0xdb, 0xf9, 0xb2, 0xeb, 0x97, 0xe7, 0x3a, + 0xf0, 0x27, 0x6e, 0x1a, 0xe8, 0x6c, 0x6b, 0x63, 0xf8, 0x9b, 0xe4, 0x06, + 0xdc, 0x06, 0x54, 0xb5, 0xd2, 0x2d, 0x3b, 0xcd, 0x84, 0xe0, 0x0b, 0x74, + 0xcb, 0xbd, 0xb3, 0x67, 0xc9, 0x22, 0xca, 0x5b, 0x09, 0x32, 0xd3, 0xeb, + 0x51, 0x28, 0x7e, 0xb5, 0xc9, 0x52, 0x78, 0x5f, 0x8d, 0x42, 0xa9, 0xd7, + 0x55, 0xce, 0x22, 0x7c, 0xcb, 0x18, 0xa1, 0x5c, 0x86, 0xa6, 0xf7, 0x19, + 0xfe, 0xf6, 0xd7, 0x37, 0x8d, 0xd8, 0xba, 0x41, 0xe7, 0xa6, 0x3f, 0xbc, + 0xd4, 0xd0, 0x41, 0xf1, 0x3a, 0x53, 0xd9, 0x74, 0x74, 0x6c, 0x39, 0xe6, + 0x96, 0xf8, 0xc6, 0xc8, 0x22, 0x96, 0xd8, 0xa4, 0x86, 0x79, 0x90, 0xd4, + 0x53, 0xa6, 0x01, 0x3c, 0xb8, 0x8d, 0x46, 0x79, 0xac, 0x8c, 0xfb, 0xeb, + 0x16, 0x23, 0xc8, 0xb9, 0x11, 0xe5, 0x11, 0x6d, 0xc1, 0x2c, 0xb4, 0xb3, + 0x64, 0x91, 0x9e, 0xde, 0x7d, 0xf5, 0xaf, 0xad, 0xbb, 0xae, 0x53, 0xb9, + 0xe5, 0x94, 0x02, 0xb4, 0xcf, 0x85, 0x85, 0x25, 0x4d, 0x94, 0x43, 0x21, + 0xd2, 0xb9, 0xb9, 0xa0, 0xc4, 0x77, 0x1a, 0xc5, 0xa7, 0x74, 0x8f, 0x6e, + 0x84, 0x22, 0x37, 0x96, 0x4d, 0xe6, 0x01, 0x75, 0x40, 0x63, 0x2a, 0xd8, + 0x0f, 0x72, 0xe2, 0xe3, 0x4e, 0x08, 0x81, 0x8b, 0x68, 0xa4, 0x9b, 0x1d, + 0x94, 0xa7, 0x2c, 0xf6, 0xcf, 0x2a, 0x70, 0xd8, 0xee, 0xd0, 0x8a, 0xbc, + 0x33, 0xf7, 0x38, 0x80, 0x38, 0x3c, 0xfc, 0x18, 0x46, 0x85, 0xb8, 0x6e, + 0xb9, 0x11, 0x45, 0xb0, 0xd2, 0x82, 0x1e, 0x44, 0x2f, 0xd1, 0x1a, 0xee, + 0x46, 0x9b, 0x58, 0xd5, 0xeb, 0x01, 0xe9, 0x94, 0xad, 0x19, 0xf6, 0x66, + 0xb3, 0x89, 0x6b, 0xce, 0x55, 0x1b, 0xe2, 0x2d, 0xe5, 0xce, 0xc9, 0x50, + 0xf8, 0x7b, 0xcb, 0xd5, 0xe4, 0x66, 0xc5, 0x06, 0xe8, 0xf0, 0x2a, 0x47, + 0xe0, 0x99, 0x21, 0x8a, 0x59, 0x0f, 0x0c, 0x06, 0xcf, 0xef, 0x02, 0x8f, + 0x94, 0xbd, 0xff, 0xa2, 0xbc, 0x28, 0x92, 0x26, 0x73, 0xc7, 0xf4, 0x91, + 0xed, 0x82, 0xa1, 0x49, 0x4d, 0x42, 0x97, 0x7b, 0xcb, 0x80, 0xe2, 0xd6, + 0xff, 0xf8, 0x3d, 0x08, 0x19, 0x2b, 0x11, 0xf0, 0x4c, 0x16, 0x00, 0x13, + 0x00, 0x07, 0x00, 0xf8, 0x00, 0xed, 0x00, 0xef, 0x00, 0xdf, 0x00, 0xe6, + 0xac, 0xb6, 0x9b, 0x34, 0xd4, 0x42, 0x8d, 0xda, 0x06, 0x4d, 0xfc, 0xa2, + 0x6e, 0xc2, 0xc0, 0xce, 0xf8, 0xdc, 0xf9, 0x0d, 0x3e, 0x4b, 0xb4, 0x1f, + 0x08, 0x73, 0x00, 0x86, 0xd3, 0x0c, 0xd6, 0x13, 0x6a, 0x11, 0xd8, 0x01, + 0x23, 0x0e, 0xc6, 0x78, 0xb4, 0x9b, 0x53, 0xb3, 0x66, 0x5c, 0xc5, 0x6b, + 0xd6, 0xa3, 0x1c, 0xa9, 0x57, 0x7b, 0xfe, 0x92, 0xf7, 0x1f, 0x72, 0x36, + 0x29, 0xf5, 0x82, 0x91, 0x56, 0xd3, 0x29, 0x4d, 0x48, 0xa4, 0x66, 0xd5, + 0xbf, 0x2c, 0xba, 0x6f, 0xf4, 0x37, 0xca, 0x3e, 0xc6, 0x2f, 0xd6, 0x41, + 0x55, 0x24, 0xfe, 0xff, 0xaa, 0xb4, 0xce, 0x31, 0x59, 0x62, 0x72, 0x04, + 0xea, 0x02, 0xc1, 0x80, 0xb2, 0xa0, 0x99, 0xc7, 0x4b, 0x7d, 0x55, 0x3e, + 0x71, 0x51, 0x30, 0x75, 0x4f, 0x31, 0xa6, 0x73, 0xeb, 0xf5, 0xd5, 0xe2, + 0x2e, 0x8b, 0x11, 0x08, 0x75, 0x67, 0x11, 0x4e, 0x29, 0x45, 0xbe, 0x68, + 0x41, 0x81, 0x36, 0xd4, 0xde, 0xd6, 0x1d, 0x38, 0x22, 0x0c, 0xa4, 0x8d, + 0xcd, 0x9e, 0x99, 0x24, 0x5f, 0xc4, 0xd8, 0x17, 0xc4, 0xef, 0x1d, 0xcd, + 0xe3, 0x13, 0xf2, 0x2c, 0x7c, 0x08, 0x54, 0x03, 0x74, 0x8d, 0x8f, 0x40, + 0x2c, 0xa4, 0xf2, 0xac, 0x61, 0xde, 0xb2, 0xed, 0xe5, 0x3c, 0x75, 0xbb, + 0x58, 0xb3, 0x9d, 0x95, 0x5f, 0x30, 0x31, 0xbd, 0xd3, 0x88, 0x88, 0xbd, + 0xe4, 0x20, 0xd9, 0x63, 0x9b, 0x08, 0x54, 0xa7, 0xc7, 0x4a, 0x11, 0xdf, + 0xf0, 0x73, 0xdd, 0x6f, 0x50, 0x91, 0xff, 0x9c, 0x55, 0x2f, 0x5f, 0xe0, + 0xbf, 0xdd, 0x5a, 0x1d, 0x4c, 0x29, 0xa4, 0x65, 0xa8, 0x1d, 0xf2, 0x08, + 0xe0, 0x33, 0x6d, 0x6a, 0xd1, 0xd6, 0xc0, 0xfa, 0x69, 0x79, 0xf1, 0x14, + 0xf8, 0x5c, 0xea, 0x37, 0x3b, 0x84, 0xf7, 0x2c, 0x9d, 0x2c, 0xba, 0x74, + 0x33, 0xa1, 0xa8, 0x74, 0x26, 0x8e, 0x76, 0x2d, 0xa0, 0x46, 0xa6, 0xb7, + 0xac, 0x1e, 0x84, 0xf4, 0x44, 0xbe, 0xc8, 0x5e, 0xb9, 0x42, 0x6e, 0x27, + 0x07, 0x1e, 0x3d, 0x22, 0xee, 0x82, 0xb9, 0xf1, 0xee, 0x93, 0x08, 0x4f, + 0x0a, 0xab, 0x02, 0x3e, 0x80, 0x6b, 0x03, 0x17, 0x52, 0xed, 0x25, 0x77, + 0xf7, 0x80, 0x5e, 0xbf, 0x30, 0xb4, 0x95, 0x4a, 0x47, 0x1d, 0x98, 0x1e, + 0x71, 0x3d, 0xea, 0x37, 0x36, 0x39, 0x94, 0x2f, 0x29, 0x3e, 0x53, 0x88, + 0x44, 0xdf, 0x26, 0xf2, 0x7b, 0x75, 0xe4, 0xd6, 0x97, 0x4f, 0x30, 0xd6, + 0xc5, 0x6c, 0x12, 0xb6, 0xe6, 0x94, 0xee, 0x22, 0x5f, 0x6c, 0xac, 0xfe, + 0x4e, 0x92, 0x06, 0x08, 0x7f, 0x02, 0x9f, 0x01, 0x92, 0x29, 0x78, 0xa2, + 0x42, 0x2c, 0xf4, 0xb5, 0x09, 0xa8, 0x72, 0x21, 0x91, 0xd6, 0x7e, 0xb2, + 0xcd, 0xc9, 0x66, 0xba, 0xbf, 0xac, 0xb4, 0x99, 0xc4, 0x28, 0xaf, 0xe3, + 0xb8, 0x22, 0xb1, 0x1c, 0xe8, 0x5b, 0xdc, 0x27, 0xee, 0xc3, 0x20, 0x50, + 0xfd, 0x85, 0x23, 0x34, 0x73, 0x17, 0x08, 0x07, 0xc6, 0xb8, 0xd3, 0x7f, + 0x6f, 0x6f, 0x4a, 0xbc, 0x43, 0x90, 0x03, 0x52, 0x80, 0xc4, 0xb2, 0xe3, + 0xde, 0x05, 0x50, 0xc4, 0x9e, 0x83, 0xf8, 0x30, 0x8c, 0xff, 0x07, 0xd3, + 0xb3, 0x20, 0xcd, 0xed, 0x47, 0x55, 0xd3, 0xe1, 0xb3, 0x03, 0x45, 0x78, + 0x26, 0xa9, 0x4d, 0x55, 0x7a, 0x90, 0x33, 0x24, 0x0e, 0x93, 0x6e, 0xc9, + 0x57, 0xf3, 0xb0, 0xea, 0x8b, 0x67, 0x26, 0xc5, 0x5b, 0xd1, 0x37, 0x54, + 0xc6, 0x56, 0x97, 0x7a, 0x49, 0x61, 0x52, 0x81, 0x21, 0x85, 0xc2, 0x81, + 0xcd, 0x07, 0x4e, 0xa0, 0xec, 0xdb, 0xd9, 0xf4, 0x2f, 0xf3, 0xdc, 0x9f, + 0x31, 0x74, 0x9c, 0x24, 0xdb, 0xa3, 0x05, 0x48, 0x72, 0x0e, 0xa9, 0x63, + 0xb8, 0xef, 0x70, 0x2e, 0xb4, 0x91, 0x5c, 0x03, 0xf3, 0xfc, 0x99, 0xbc, + 0x52, 0xfb, 0xaa, 0xd6, 0x6d, 0xb3, 0x95, 0x40, 0xa7, 0xda, 0x83, 0x68, + 0x69, 0x4c, 0x12, 0xe6, 0xa2, 0xdb, 0x9b, 0xd2, 0x64, 0xb9, 0x00, 0xb4, + 0x20, 0x0d, 0x52, 0x2d, 0x03, 0xbf, 0xc3, 0xe9, 0xc0, 0x34, 0x88, 0xa5, + 0xd0, 0x38, 0xf2, 0xce, 0x88, 0x9e, 0x9d, 0x76, 0xc7, 0xf1, 0xda, 0x28, + 0x30, 0x3b, 0x41, 0x55, 0xdd, 0x27, 0x37, 0x80, 0x11, 0x86, 0x7e, 0x29, + 0x7a, 0x75, 0x65, 0x74, 0xa3, 0xf2, 0x54, 0x66, 0x13, 0x9e, 0x39, 0xec, + 0xae, 0x99, 0xb2, 0xe8, 0x14, 0xd1, 0x37, 0x9e, 0x71, 0x84, 0x3b, 0x0c, + 0xd0, 0x3c, 0x20, 0x05, 0x8c, 0x25, 0xbe, 0x03, 0xe3, 0xa4, 0x65, 0xe3, + 0x9b, 0x0d, 0x88, 0x45, 0xf2, 0x0f, 0xd7, 0xa4, 0xaa, 0x17, 0xf1, 0xe8, + 0x55, 0xf8, 0x10, 0x57, 0x6a, 0xd6, 0xa7, 0x17, 0x4d, 0x67, 0x45, 0xe9, + 0x5a, 0x30, 0xb9, 0xb7, 0x36, 0x7f, 0x34, 0xe9, 0xdf, 0x26, 0xa4, 0x55, + 0xbc, 0x2d, 0x22, 0xf5, 0x75, 0xc8, 0xd9, 0x8a, 0xb8, 0xdd, 0x68, 0xb3, + 0x32, 0x12, 0x0c, 0xe5, 0xc4, 0x04, 0x63, 0x51, 0x37, 0xd8, 0x84, 0x90, + 0xee, 0x0a, 0xe1, 0x29, 0x9a, 0x9f, 0xac, 0x8e, 0xdc, 0x64, 0x5f, 0xeb, + 0x4e, 0x9e, 0x90, 0xe0, 0xa8, 0x75, 0x1e, 0x3c, 0xa7, 0xe9, 0x28, 0xfa, + 0xf5, 0x7a, 0xff, 0x11, 0xee, 0x55, 0x79, 0x6e, 0x23, 0x72, 0x6a, 0xca, + 0xe7, 0x98, 0x83, 0x5c, 0xc1, 0xd0, 0x99, 0x08, 0xfd, 0x72, 0x60, 0xbc, + 0xee, 0xff, 0x3a, 0xda, 0x7d, 0x11, 0xe8, 0xf3, 0x24, 0x08, 0x5e, 0x25, + 0x3e, 0xd2, 0x82, 0x46, 0x30, 0x83, 0x90, 0x63, 0x7b, 0xdd, 0x39, 0xc5, + 0x1d, 0x56, 0xd3, 0xd6, 0x96, 0x95, 0x9f, 0xda, 0x8d, 0xf5, 0xdd, 0x9d, + 0xdf, 0x39, 0x9b, 0x6e, 0xbb, 0xab, 0x4f, 0x0a, 0xef, 0x42, 0x0d, 0xc4, + 0xe9, 0x1a, 0x3b, 0x5a, 0xcb, 0x33, 0x3e, 0xef, 0x16, 0x49, 0x77, 0xa7, + 0x3a, 0xa8, 0xb5, 0xfd, 0x4c, 0x46, 0x5c, 0x95, 0x2f, 0xad, 0x31, 0x97, + 0x49, 0x0d, 0x31, 0x99, 0x1a, 0x9e, 0xf4, 0x96, 0x6b, 0x15, 0x4b, 0x45, + 0x2f, 0x23, 0x7a, 0xf4, 0xab, 0x9a, 0x69, 0x31, 0xfe, 0x7b, 0xaf, 0x5d, + 0x8c, 0x57, 0xb3, 0x61, 0xb8, 0xd1, 0x8f, 0x54, 0x5d, 0x39, 0xc9, 0x79, + 0xd2, 0xe8, 0x02, 0x9c, 0xd6, 0x56, 0xcd, 0x5c, 0xc4, 0xe6, 0x2a, 0xbc, + 0x7e, 0xc7, 0xd8, 0xfe, 0x56, 0x44, 0xd5, 0x53, 0x94, 0xba, 0xe7, 0xb8, + 0x19, 0x2b, 0xf1, 0x96, 0xc6, 0x87, 0xa9, 0x58, 0x5b, 0x24, 0x14, 0x6a, + 0x52, 0x06, 0xf0, 0x6a, 0xb1, 0x52, 0xc9, 0x5d, 0x6a, 0x98, 0xd6, 0xd2, + 0x0c, 0x28, 0xda, 0xc1, 0x10, 0x15, 0xd6, 0x89, 0x9a, 0x4f, 0x24, 0x4b, + 0xb4, 0x0a, 0x22, 0x73, 0xe9, 0x82, 0xb5, 0x54, 0xc6, 0x99, 0x82, 0x5b, + 0x8b, 0x60, 0xe3, 0x25, 0xec, 0xbf, 0x86, 0x4a, 0x9b, 0x5f, 0x82, 0xd4, + 0xd5, 0xd5, 0x75, 0xb4, 0xb4, 0x9b, 0x83, 0x7f, 0xed, 0x0a, 0x20, 0xf3, + 0x9d, 0xc0, 0x62, 0x89, 0x15, 0xab, 0x06, 0xcc, 0xaa, 0xa4, 0xf8, 0xb2, + 0x21, 0x98, 0xe8, 0x31, 0x75, 0xce, 0xda, 0x6b, 0xe6, 0x6d, 0x60, 0xc9, + 0x1a, 0x9d, 0xca, 0xf8, 0x89, 0x92, 0xb4, 0x47, 0x81, 0x64, 0x46, 0x18, + 0xae, 0x8e, 0x71, 0x31, 0xd9, 0x51, 0x7a, 0x7c, 0x85, 0x5c, 0x58, 0x3e, + 0x15, 0x88, 0x7e, 0xfa, 0x82, 0x12, 0xc4, 0xc7, 0x26, 0xe6, 0x3a, 0x16, + 0xc3, 0xa3, 0x87, 0x33, 0xe2, 0x3b, 0x44, 0x7c, 0x68, 0xf1, 0xa2, 0x82, + 0xc9, 0xbb, 0x31, 0x09, 0x40, 0xda, 0x56, 0xa4, 0xd5, 0xe7, 0xa8, 0xa4, + 0x7d, 0x39, 0x57, 0xad, 0x3b, 0x62, 0xcb, 0x53, 0x91, 0x4c, 0xbf, 0x67, + 0x8d, 0xb3, 0x9b, 0x6f, 0x8a, 0x2f, 0x47, 0x72, 0xa1, 0x72, 0x13, 0x56, + 0x16, 0x42, 0x7f, 0x7b, 0x26, 0xaf, 0xf5, 0x9d, 0xda, 0xaf, 0x1b, 0x46, + 0x35, 0xd3, 0xd9, 0x79, 0x99, 0xea, 0x17, 0xf4, 0x3f, 0xc4, 0xf6, 0x50, + 0xb2, 0x55, 0x63, 0xa2, 0x79, 0x0b, 0x2d, 0x0a, 0x6c, 0x0c, 0x2a, 0xa0, + 0x7a, 0x29, 0xbc, 0x92, 0xf1, 0x05, 0x30, 0xaa, 0xb6, 0x17, 0x67, 0x49, + 0x41, 0x6b, 0x89, 0xc3, 0xbc, 0xba, 0x62, 0x19, 0x04, 0x80, 0x6d, 0x4d, + 0x78, 0xdd, 0x26, 0x95, 0x29, 0xe7, 0x3c, 0x63, 0xcc, 0x35, 0x05, 0x27, + 0xd4, 0x1d, 0x45, 0x86, 0xf8, 0x22, 0xce, 0x6d, 0x20, 0x3e, 0x8f, 0x79, + 0x6f, 0xc1, 0xaa, 0xff, 0x32, 0x27, 0xa0, 0x15, 0x18, 0x45, 0x34, 0x14, + 0x78, 0x65, 0xb1, 0x2c, 0x00, 0xee, 0xc8, 0x20, 0x8d, 0x66, 0xc9, 0x78, + 0x65, 0x39, 0xa7, 0xc5, 0x28, 0x11, 0xcf, 0xac, 0xa1, 0x05, 0x57, 0xca, + 0x09, 0x9b, 0x24, 0xc7, 0xd2, 0x9e, 0x9b, 0xd4, 0x90, 0xb6, 0xee, 0x3a, + 0xef, 0x12, 0xed, 0xf3, 0x70, 0x22, 0x66, 0x2f, 0xae, 0xe3, 0x54, 0xde, + 0x4a, 0x41, 0x17, 0xbd, 0xc6, 0xaa, 0x28, 0x3a, 0xdd, 0xfd, 0xf9, 0x55, + 0xe4, 0x90, 0x23, 0x40, 0x35, 0x5c, 0x12, 0x24, 0xbb, 0x59, 0x5a, 0xb8, + 0x01, 0x0e, 0x21, 0x37, 0x6e, 0xb3, 0x13, 0x05, 0xcd, 0x5d, 0x5a, 0xf9, + 0x6c, 0x5f, 0xc6, 0xf0, 0x81, 0xb9, 0x2a, 0x23, 0x6f, 0xee, 0xa4, 0xb2, + 0xfd, 0x52, 0x15, 0xe6, 0xb6, 0x89, 0x45, 0xcd, 0x9c, 0xc7, 0x7f, 0x0c, + 0x49, 0xe6, 0x5a, 0xa5, 0xb1, 0xea, 0xf7, 0x34, 0x04, 0x68, 0x64, 0x78, + 0xcf, 0xeb, 0x61, 0xac, 0x7a, 0x68, 0xd8, 0xaa, 0x64, 0x0c, 0x00, 0xec, + 0x66, 0xe9, 0x63, 0xb2, 0x61, 0x54, 0x13, 0x26, 0x63, 0x54, 0x9f, 0xf2, + 0x2d, 0x89, 0xb5, 0x5e, 0xb1, 0xb7, 0x16, 0xb5, 0x60, 0xf4, 0x5f, 0x7a, + 0x86, 0x58, 0x8a, 0x60, 0xc6, 0x27, 0x0e, 0xd1, 0xbf, 0xf3, 0xd3, 0x33, + 0x1e, 0x53, 0x45, 0x28, 0xba, 0x3a, 0x5f, 0xac, 0xa0, 0x90, 0xfe, 0x9c, + 0xa0, 0x2b, 0x81, 0xdd, 0x65, 0xac, 0xea, 0xf3, 0x8b, 0x10, 0x08, 0x9c, + 0x15, 0x22, 0x25, 0x70, 0x1f, 0xc8, 0xe0, 0x52, 0x30, 0x2c, 0x26, 0x85, + 0x35, 0x93, 0x53, 0x7c, 0x31, 0x0b, 0x64, 0x8a, 0x27, 0x70, 0xbd, 0x38, + 0xc4, 0xf9, 0xde, 0x2d, 0x5a, 0x33, 0xa1, 0x4f, 0x79, 0xd7, 0xb9, 0xba, + 0x6e, 0x46, 0xaa, 0xc6, 0x99, 0xc2, 0x97, 0x4e, 0x94, 0xb4, 0xe2, 0x3c, + 0x07, 0xbc, 0xd1, 0xc2, 0x1b, 0x6b, 0x20, 0xc4, 0xf2, 0xec, 0x4f, 0x0c, + 0x51, 0xc0, 0xfe, 0xd2, 0x06, 0xc8, 0x9a, 0x08, 0x03, 0x1f, 0x0b, 0x03, + 0x5f, 0xc8, 0x61, 0xec, 0x20, 0x89, 0x85, 0xc4, 0xc2, 0x45, 0xb8, 0x38, + 0x06, 0x5e, 0x70, 0xb8, 0x0b, 0x88, 0x6b, 0x1e, 0x99, 0x7c, 0x44, 0x12, + 0x54, 0x3f, 0x22, 0x28, 0x8e, 0xbd, 0x3a, 0x4d, 0xfc, 0x1f, 0xec, 0xa3, + 0x76, 0x43, 0x7b, 0x64, 0xb0, 0xce, 0x95, 0x9c, 0x3b, 0x57, 0x7d, 0x3c, + 0xe5, 0x80, 0x66, 0xdc, 0xef, 0xcd, 0xd2, 0x72, 0x48, 0x32, 0x7c, 0xe9, + 0xf0, 0x14, 0x06, 0x15, 0x26, 0xe2, 0xdb, 0xf4, 0xa3, 0xb2, 0xca, 0x1d, + 0xa2, 0x5c, 0xc3, 0x15, 0xce, 0xa0, 0x90, 0xd9, 0x88, 0xb1, 0xad, 0x72, + 0x34, 0x84, 0xff, 0x65, 0xab, 0xd6, 0xe0, 0x13, 0xfb, 0x97, 0x46, 0x2f, + 0x9f, 0xc5, 0x37, 0x66, 0x27, 0x0c, 0x6c, 0xd4, 0xf8, 0x5b, 0xba, 0x23, + 0x23, 0xb2, 0x32, 0xbb, 0x1c, 0x42, 0x08, 0x8e, 0xc2, 0x09, 0xe0, 0x52, + 0xc0, 0xc2, 0xaa, 0x81, 0x62, 0x40, 0x34, 0x00, 0xdd, 0x3d, 0x40, 0xb1, + 0x24, 0x21, 0x64, 0x30, 0xf6, 0x7d, 0xdb, 0x1e, 0xdd, 0x64, 0x4d, 0xc4, + 0xf0, 0x7a, 0xf2, 0x66, 0x32, 0x27, 0xa8, 0xbc, 0xa5, 0x5f, 0x0b, 0x2b, + 0xc5, 0x79, 0x68, 0x74, 0xcb, 0xe8, 0xc1, 0xb3, 0x22, 0x8a, 0xe2, 0x2e, + 0xeb, 0x68, 0x89, 0xa9, 0xac, 0x57, 0xe1, 0x1e, 0x80, 0x29, 0x27, 0x22, + 0xc7, 0x3c, 0x55, 0x70, 0x3c, 0xd8, 0x09, 0x96, 0x01, 0x1e, 0x6e, 0x5a, + 0x3f, 0xf6, 0x7f, 0x33, 0x6b, 0xcd, 0x48, 0xb6, 0x4c, 0xc2, 0xd4, 0xa4, + 0x10, 0x39, 0x30, 0x2e, 0x42, 0xe7, 0x7d, 0x5c, 0x22, 0x4d, 0x22, 0x10, + 0x17, 0x03, 0x40, 0xf7, 0x5b, 0x69, 0x8d, 0xa3, 0x16, 0xbc, 0x32, 0xe2, + 0x20, 0x83, 0xab, 0x0d, 0x40, 0xc0, 0x8c, 0xf3, 0xec, 0xf4, 0xa7, 0xbf, + 0xac, 0xf9, 0x55, 0xcf, 0x90, 0x86, 0xa0, 0x11, 0xe6, 0x45, 0x9b, 0xd0, + 0x04, 0x32, 0x41, 0xb9, 0xc1, 0xc3, 0xb6, 0xf0, 0x39, 0xe9, 0x09, 0xc4, + 0x3c, 0x93, 0xe9, 0x20, 0xe3, 0xf7, 0xa7, 0x58, 0x39, 0xac, 0xe7, 0xc3, + 0x47, 0x32, 0x00, 0x51, 0x20, 0x8a, 0xab, 0xc4, 0x6b, 0x64, 0x19, 0x55, + 0x30, 0x06, 0x25, 0x62, 0x91, 0x98, 0x75, 0x2f, 0xf3, 0x3b, 0xd4, 0x08, + 0x04, 0x9a, 0x5a, 0xbd, 0x9b, 0x54, 0xc6, 0xaf, 0x0e, 0xc4, 0x00, 0xaf, + 0x00, 0x56, 0xc1, 0x37, 0x9f, 0x99, 0x8b, 0xf1, 0x0b, 0xda, 0xb0, 0xb6, + 0xa0, 0x93, 0x8b, 0xfc, 0x7b, 0xde, 0x39, 0x4b, 0x36, 0x47, 0xca, 0x1c, + 0x3c, 0xe8, 0xcc, 0xb2, 0x34, 0x9b, 0xb2, 0xe6, 0xb5, 0xbc, 0x52, 0xf1, + 0x48, 0xfa, 0x69, 0x21, 0x3e, 0x17, 0x5b, 0xcc, 0x46, 0x87, 0x1d, 0xdd, + 0x51, 0x86, 0x88, 0x98, 0xba, 0x90, 0x11, 0xda, 0x80, 0xf9, 0x1e, 0x61, + 0x3b, 0xc0, 0x68, 0xd0, 0x05, 0xa8, 0x89, 0x07, 0xad, 0xf8, 0x8f, 0xc7, + 0xca, 0xc9, 0xce, 0xb8, 0x9d, 0xd4, 0xb4, 0xa9, 0x57, 0x2b, 0x46, 0xf4, + 0x63, 0x6d, 0xa2, 0xc6, 0xaa, 0xbf, 0xd8, 0x81, 0xd2, 0x82, 0xd1, 0xd6, + 0x90, 0xc3, 0xcf, 0x69, 0xe3, 0x56, 0xa4, 0xd4, 0x79, 0x03, 0x17, 0x00, + 0xc3, 0x4d, 0xa4, 0xf4, 0x61, 0x02, 0xd7, 0x6c, 0xf4, 0x5f, 0x12, 0xb9, + 0x43, 0x38, 0xc0, 0xb6, 0xa0, 0x3a, 0x75, 0xfd, 0xb8, 0xcf, 0x9f, 0xb0, + 0xfe, 0xcb, 0xac, 0xab, 0x94, 0x24, 0x5b, 0x8f, 0x1a, 0xd8, 0xed, 0xdc, + 0xb6, 0x09, 0x9f, 0x85, 0xff, 0x38, 0xdc, 0xb7, 0x97, 0x1e, 0x48, 0xf0, + 0x68, 0x45, 0x8d, 0xfa, 0xb7, 0xdc, 0x04, 0x59, 0xb5, 0x99, 0x13, 0x44, + 0xe1, 0x2a, 0x56, 0x89, 0xef, 0xe2, 0x8c, 0xac, 0x99, 0xca, 0x30, 0x3b, + 0xe4, 0x96, 0x00, 0xb7, 0xf1, 0x90, 0x00, 0x55, 0x98, 0x3f, 0xf1, 0xf6, + 0x74, 0x22, 0xc8, 0xb7, 0xd6, 0x94, 0x0c, 0xf5, 0x9c, 0xd8, 0x17, 0xa3, + 0xa4, 0x5e, 0xf6, 0xe0, 0x0c, 0x43, 0x44, 0x2c, 0x10, 0x59, 0x38, 0x54, + 0x48, 0xaf, 0x12, 0x4d, 0x99, 0x2c, 0xbe, 0x29, 0xf7, 0x1e, 0x83, 0xac, + 0x46, 0x11, 0xa5, 0x7a, 0x9c, 0x6c, 0x64, 0x77, 0xcc, 0xc9, 0x8d, 0xec, + 0xad, 0x5e, 0xa6, 0xd0, 0xcc, 0xc1, 0x1b, 0x42, 0x20, 0x42, 0xdc, 0x42, + 0x2e, 0x40, 0x6b, 0xd3, 0xda, 0x5d, 0x81, 0x15, 0x0b, 0x56, 0x88, 0x0f, + 0xa8, 0xe2, 0x5f, 0xcb, 0xe4, 0xb3, 0xea, 0x3b, 0x05, 0x39, 0x71, 0xe1, + 0x10, 0x17, 0x0a, 0xf6, 0x40, 0x47, 0x69, 0x0d, 0x85, 0xc0, 0x91, 0xe5, + 0x6d, 0x1c, 0x7e, 0x8d, 0x3e, 0xb1, 0xa2, 0xf3, 0xa2, 0x6e, 0x24, 0x89, + 0xaf, 0x9f, 0x43, 0x16, 0xc1, 0xff, 0xf8, 0x3d, 0x08, 0x1a, 0x2b, 0x11, + 0x4d, 0x4e, 0xc0, 0x00, 0xeb, 0x00, 0xfb, 0x00, 0x0e, 0x00, 0x34, 0x00, + 0x30, 0x00, 0x12, 0x00, 0x2e, 0x00, 0xe6, 0xa8, 0xed, 0xab, 0x5c, 0xb7, + 0x12, 0xc9, 0x11, 0x8e, 0x4e, 0x2d, 0xc0, 0xd8, 0xfd, 0x3e, 0x01, 0x85, + 0x41, 0xa9, 0x72, 0x25, 0x6a, 0xc7, 0xe6, 0x47, 0x09, 0x20, 0xdc, 0xf8, + 0xef, 0x42, 0x39, 0xd4, 0x43, 0xb5, 0xc2, 0xff, 0x66, 0x0a, 0x09, 0x1f, + 0x66, 0x40, 0x8c, 0xc5, 0xa6, 0xd6, 0x10, 0x79, 0x5c, 0x81, 0x9b, 0x2a, + 0x3b, 0xf0, 0x4e, 0xc7, 0x62, 0x7b, 0x4f, 0x71, 0xec, 0xe1, 0xff, 0x58, + 0x6a, 0x5f, 0xba, 0x74, 0xd1, 0x38, 0xb1, 0xb1, 0xfb, 0xca, 0x1c, 0x3a, + 0x3b, 0xb8, 0xae, 0xe8, 0x54, 0x1c, 0x69, 0xe8, 0xf2, 0x8c, 0x97, 0xdf, + 0x8c, 0x23, 0x95, 0xbe, 0xa4, 0x5b, 0x19, 0x8b, 0xbd, 0x39, 0xf7, 0xed, + 0x66, 0x09, 0x99, 0x64, 0x53, 0x9c, 0xd6, 0x0f, 0x22, 0x06, 0x23, 0x4f, + 0x92, 0x15, 0x1f, 0x94, 0xa7, 0xd0, 0xfa, 0x13, 0xa7, 0x83, 0xcd, 0x17, + 0xa9, 0xab, 0xd9, 0xcf, 0xd7, 0x9f, 0x94, 0x48, 0x6e, 0x06, 0xb4, 0xfc, + 0x08, 0x58, 0x40, 0x2d, 0x93, 0xd6, 0x0e, 0x4d, 0x1f, 0x0e, 0x32, 0xf3, + 0x60, 0xc8, 0xf6, 0xb0, 0x8d, 0x4f, 0x51, 0x4d, 0x29, 0x9e, 0x48, 0x15, + 0x00, 0xfc, 0x61, 0x33, 0x0d, 0x14, 0x7d, 0xeb, 0x6c, 0x65, 0x20, 0xcf, + 0xae, 0xc1, 0x06, 0xdb, 0xb7, 0x95, 0xe4, 0x0d, 0x96, 0x4b, 0xf2, 0x93, + 0x6f, 0x95, 0x3f, 0x57, 0xec, 0x2c, 0xad, 0x26, 0x6b, 0xfc, 0x88, 0x21, + 0xb4, 0xbc, 0xa6, 0x0e, 0x42, 0xfe, 0xa2, 0x31, 0x85, 0x96, 0x50, 0xc1, + 0x35, 0xdc, 0xbc, 0x32, 0x9d, 0x8a, 0xc3, 0x2a, 0x6f, 0x5b, 0xb3, 0xf8, + 0x9d, 0x50, 0x15, 0x02, 0x8a, 0x07, 0xbf, 0xb4, 0xb7, 0x59, 0x00, 0xc5, + 0x8f, 0x76, 0x1b, 0x5b, 0xf4, 0xa1, 0x2b, 0xfa, 0x44, 0xf0, 0x64, 0x99, + 0x5d, 0x12, 0xeb, 0x82, 0x9a, 0x5e, 0xfc, 0x22, 0xad, 0x5c, 0x60, 0xf5, + 0xd6, 0x4e, 0x50, 0xe5, 0x1b, 0xf3, 0x37, 0x28, 0x17, 0xed, 0x42, 0x98, + 0x95, 0x13, 0x2b, 0x8e, 0xca, 0x24, 0xc8, 0x59, 0xdd, 0x42, 0x02, 0x9d, + 0x48, 0xdc, 0x09, 0x7b, 0x46, 0x72, 0x2c, 0x56, 0x90, 0x2b, 0x06, 0x50, + 0x8e, 0xcd, 0x8a, 0xd1, 0xef, 0x91, 0xa1, 0x18, 0x29, 0x92, 0x1f, 0xe2, + 0x3e, 0x5b, 0xef, 0xa6, 0x95, 0x9a, 0xe7, 0x88, 0x78, 0x89, 0xc4, 0x19, + 0xa6, 0x52, 0xa4, 0xb9, 0x6e, 0xad, 0xec, 0x4c, 0x16, 0x03, 0x16, 0xe0, + 0xa7, 0x40, 0xa4, 0x45, 0x00, 0xdb, 0x48, 0x19, 0x59, 0x0a, 0xa9, 0x47, + 0x64, 0x4d, 0xa1, 0x13, 0x6d, 0x1d, 0x48, 0x2a, 0xa0, 0xe1, 0x49, 0x5a, + 0x9c, 0x2e, 0xd6, 0x8d, 0x87, 0x85, 0xf3, 0xeb, 0x68, 0xb2, 0xbe, 0xb3, + 0xd9, 0xad, 0xea, 0x3b, 0xb3, 0x20, 0xa3, 0xc4, 0x21, 0xc4, 0xee, 0x1d, + 0x68, 0x58, 0x1c, 0xf6, 0x0f, 0x43, 0x8c, 0xee, 0xb2, 0x06, 0x41, 0x41, + 0xb3, 0xef, 0xca, 0x10, 0xb2, 0x64, 0x76, 0x22, 0x26, 0xba, 0xb4, 0x48, + 0x53, 0xeb, 0x8b, 0xd1, 0x07, 0x82, 0xf2, 0x61, 0x62, 0x82, 0x31, 0xef, + 0xdb, 0x1c, 0xee, 0x50, 0x97, 0xce, 0xad, 0xd9, 0x59, 0xfd, 0xa7, 0x07, + 0x6c, 0x53, 0x27, 0xbe, 0x44, 0xf1, 0xc3, 0x0f, 0x50, 0xf1, 0x2d, 0x92, + 0x23, 0xae, 0x57, 0x98, 0x30, 0xdf, 0xb3, 0xa2, 0x32, 0x48, 0x10, 0x11, + 0xa6, 0xc0, 0x61, 0x88, 0x57, 0x4a, 0x9c, 0x56, 0x5d, 0x50, 0xd8, 0x94, + 0x00, 0xb8, 0x61, 0x35, 0x76, 0x4c, 0x48, 0x2f, 0xc1, 0x96, 0xba, 0x33, + 0x1b, 0x5a, 0x9e, 0x6e, 0x24, 0xbd, 0x50, 0xd9, 0xb2, 0xe4, 0x64, 0xd0, + 0x17, 0x5e, 0x89, 0x56, 0x15, 0x04, 0x84, 0x4a, 0xa6, 0x7c, 0x4f, 0x35, + 0x95, 0xd5, 0x33, 0x0e, 0x62, 0xf5, 0x5c, 0xfa, 0xf4, 0xaa, 0x4b, 0xb8, + 0x30, 0xf4, 0x29, 0xfe, 0x64, 0x8b, 0x76, 0x4d, 0x7a, 0x13, 0x3c, 0xa7, + 0x15, 0x7f, 0xa8, 0x88, 0x63, 0xad, 0x7e, 0xfe, 0x0c, 0xc7, 0x63, 0x27, + 0xaa, 0x23, 0xc9, 0x01, 0x1e, 0xfd, 0x42, 0xe7, 0x6b, 0x59, 0xb8, 0x8b, + 0xcd, 0x86, 0x35, 0x02, 0xb4, 0x92, 0xa9, 0x17, 0x69, 0x66, 0x5c, 0x8f, + 0x40, 0x46, 0xbd, 0x09, 0xa1, 0x1c, 0xca, 0x94, 0x88, 0x7e, 0x22, 0x56, + 0xb1, 0x2f, 0x72, 0x1f, 0x8e, 0x2b, 0x68, 0x9d, 0x03, 0x2e, 0xc9, 0x00, + 0xd4, 0xa9, 0xc2, 0x97, 0x2d, 0x78, 0xa1, 0x0b, 0xce, 0x43, 0xf0, 0xed, + 0xd4, 0xd2, 0xe5, 0xb5, 0x71, 0x92, 0x0a, 0x15, 0x1d, 0x5b, 0x26, 0xc0, + 0x45, 0x5f, 0x3f, 0x0d, 0x5a, 0x16, 0xc8, 0xca, 0x58, 0xc8, 0x89, 0x06, + 0x21, 0xa6, 0xfd, 0xc8, 0xaf, 0x1c, 0xfa, 0xa6, 0xef, 0x84, 0xd1, 0x89, + 0xf1, 0xce, 0x7d, 0x38, 0xaf, 0x52, 0x3d, 0x2c, 0xb1, 0xb4, 0xe3, 0xa7, + 0xb6, 0xb5, 0xc9, 0x61, 0xb4, 0x6a, 0xe3, 0x80, 0x82, 0xa2, 0x4c, 0x78, + 0x5d, 0xcd, 0x39, 0xd7, 0x74, 0x49, 0x35, 0x5b, 0x5d, 0xc8, 0x16, 0xc5, + 0x50, 0xee, 0x20, 0x82, 0x13, 0xa1, 0xe1, 0x14, 0x18, 0x40, 0xdb, 0x30, + 0xe2, 0xa9, 0x1f, 0x85, 0xd0, 0x9e, 0xe6, 0xe1, 0x1a, 0xe0, 0x81, 0x57, + 0x71, 0x80, 0xc7, 0xc8, 0x94, 0xe2, 0x2a, 0x78, 0xcb, 0x6c, 0x42, 0x7f, + 0x06, 0xab, 0x3a, 0xe2, 0x7d, 0xbe, 0x92, 0x4b, 0xb0, 0xbe, 0x49, 0x5b, + 0xe5, 0x30, 0xb9, 0x17, 0xad, 0x08, 0xf8, 0x7f, 0x68, 0x10, 0x45, 0x31, + 0xb8, 0x2e, 0x90, 0xe5, 0x78, 0x54, 0x5d, 0x5a, 0xa4, 0xde, 0x5a, 0xeb, + 0xeb, 0x01, 0x53, 0xca, 0xf1, 0x26, 0x5d, 0x1c, 0x72, 0x2b, 0x23, 0x23, + 0x5e, 0xdc, 0x68, 0x59, 0x2a, 0x08, 0xab, 0xa9, 0xef, 0xe2, 0xc2, 0x75, + 0xf7, 0xcf, 0xb9, 0xe7, 0x4d, 0x5d, 0x39, 0xd0, 0x19, 0x0c, 0xb2, 0x80, + 0xf3, 0x0d, 0x7b, 0x08, 0xcc, 0xab, 0x2f, 0x8c, 0x22, 0xf0, 0x68, 0xae, + 0x83, 0xf0, 0x44, 0xab, 0x4a, 0xc6, 0xee, 0x71, 0x19, 0x52, 0xa2, 0xe2, + 0x02, 0x49, 0xa5, 0x17, 0xe0, 0xf8, 0xda, 0xb0, 0x82, 0x99, 0x21, 0x94, + 0x4b, 0x8d, 0x95, 0xfc, 0x66, 0x4b, 0x27, 0x34, 0xc0, 0x81, 0x41, 0x43, + 0x58, 0x88, 0xd6, 0xde, 0xbb, 0x69, 0x7e, 0xa5, 0x22, 0xb0, 0x7a, 0x44, + 0xfc, 0xc0, 0xe3, 0xfc, 0x65, 0xb2, 0x63, 0x3a, 0xe1, 0x99, 0xae, 0x3e, + 0x1f, 0xd5, 0x10, 0x7d, 0x24, 0x2c, 0x7c, 0x86, 0xee, 0xca, 0xdc, 0x15, + 0x00, 0xab, 0xff, 0xfa, 0x19, 0x1d, 0xe5, 0x08, 0x55, 0x8a, 0x6c, 0x8f, + 0x3b, 0x62, 0x1b, 0x94, 0x71, 0xf5, 0xd2, 0x11, 0xd3, 0x92, 0xd9, 0xcc, + 0xd7, 0xef, 0xe4, 0xed, 0x6e, 0x5e, 0xcc, 0xf9, 0xce, 0x02, 0xcb, 0x58, + 0x26, 0x6e, 0xce, 0x55, 0xb8, 0x83, 0x06, 0xd4, 0x1c, 0xd5, 0x3e, 0x6e, + 0xde, 0x3a, 0xfb, 0x92, 0xf9, 0x2c, 0x06, 0x08, 0xe9, 0x3b, 0xde, 0x5c, + 0x1a, 0x98, 0xac, 0x33, 0xc6, 0xa8, 0x51, 0x41, 0xa6, 0xc4, 0xe2, 0xb8, + 0x08, 0xa4, 0x8e, 0xde, 0xb3, 0xa7, 0x9c, 0xf6, 0x82, 0xb3, 0xee, 0xd0, + 0x39, 0x77, 0x56, 0x65, 0x45, 0xe2, 0x54, 0xa8, 0x95, 0x7a, 0x55, 0xc4, + 0x0f, 0xd2, 0x9e, 0x5b, 0xcc, 0xd2, 0xa1, 0x66, 0x49, 0x8e, 0x97, 0x97, + 0x5f, 0x54, 0x97, 0xa0, 0x20, 0x6a, 0x17, 0xd0, 0xea, 0x68, 0xd6, 0xc3, + 0x5a, 0xe2, 0xce, 0x81, 0xd6, 0xb3, 0x58, 0x4e, 0xa3, 0x62, 0xc8, 0xe2, + 0x56, 0x74, 0x62, 0x53, 0x16, 0x65, 0x46, 0xe3, 0x71, 0xfc, 0x6e, 0xcf, + 0xae, 0x66, 0x47, 0xd4, 0xbd, 0x6a, 0x20, 0xbe, 0x05, 0x5d, 0x33, 0xed, + 0x39, 0xa5, 0xc4, 0x5c, 0xc4, 0x86, 0x12, 0x1a, 0xa0, 0x0b, 0x18, 0xe8, + 0x1e, 0xe3, 0xd2, 0x0b, 0x2c, 0xaa, 0x1e, 0x5e, 0x42, 0x4c, 0x91, 0xa4, + 0xd6, 0xfd, 0x7a, 0xa4, 0xd9, 0x29, 0xc3, 0x6b, 0xd8, 0xa0, 0x50, 0xb3, + 0xab, 0xf5, 0x04, 0x82, 0xab, 0x12, 0xfb, 0xfc, 0x86, 0x6b, 0x71, 0xea, + 0x9d, 0x90, 0x9f, 0x76, 0x4e, 0x37, 0x3c, 0x74, 0xf4, 0xdb, 0x2a, 0x34, + 0xe1, 0x32, 0x54, 0x75, 0x78, 0x74, 0x84, 0xc1, 0x0f, 0xd1, 0xba, 0xc8, + 0xdb, 0x99, 0xc8, 0x0f, 0xfe, 0x2f, 0xf8, 0xb4, 0x3b, 0x0a, 0xc7, 0xa4, + 0x43, 0x14, 0x1d, 0x4a, 0x20, 0x61, 0x67, 0xe5, 0xe7, 0xd0, 0x10, 0x93, + 0xc4, 0x56, 0xb5, 0x7e, 0xb2, 0xa1, 0x43, 0x97, 0x33, 0x51, 0xe1, 0x78, + 0xd7, 0xe4, 0x71, 0xd8, 0x96, 0x19, 0x04, 0x75, 0xb6, 0xf2, 0x10, 0x10, + 0x6c, 0x5f, 0xf0, 0x2e, 0x8e, 0x68, 0xbd, 0x60, 0xaa, 0xe5, 0x2c, 0xce, + 0x20, 0xc0, 0x64, 0xba, 0xe4, 0xbb, 0x21, 0xe8, 0xaf, 0x0a, 0x4e, 0xed, + 0x04, 0x46, 0xa8, 0x6a, 0x97, 0x31, 0x60, 0x39, 0xa1, 0x78, 0x89, 0x12, + 0xb4, 0xb3, 0x97, 0x08, 0x71, 0xa4, 0x24, 0xd3, 0x88, 0x72, 0xb3, 0x34, + 0xb6, 0xd5, 0x05, 0xbf, 0xdc, 0x39, 0x6e, 0x7c, 0xaa, 0x60, 0x8e, 0x40, + 0xbf, 0xf8, 0x87, 0x4a, 0x43, 0x4f, 0x5f, 0x3e, 0x12, 0xfc, 0xa1, 0x0b, + 0xea, 0x44, 0x76, 0x71, 0xe1, 0x78, 0x26, 0x14, 0x72, 0x18, 0xdc, 0xd4, + 0x43, 0x12, 0x0e, 0xbe, 0xf1, 0x63, 0x44, 0xd8, 0x37, 0xec, 0x42, 0x9e, + 0xca, 0xa2, 0x9c, 0x01, 0x5d, 0xad, 0x44, 0x94, 0x70, 0xee, 0x9b, 0x29, + 0x76, 0x15, 0x5b, 0x7d, 0x9c, 0x78, 0x33, 0xbc, 0x41, 0xf4, 0x78, 0xa7, + 0x80, 0x2e, 0x21, 0x2d, 0x03, 0xb3, 0x63, 0x3d, 0x0f, 0xd2, 0x72, 0x95, + 0x6c, 0x3c, 0xcd, 0x70, 0xc8, 0x22, 0x98, 0xb1, 0x53, 0x66, 0x4e, 0x8a, + 0xc0, 0x1b, 0x98, 0x13, 0x44, 0x87, 0xf9, 0x04, 0xcc, 0x86, 0x8b, 0x83, + 0xa9, 0x0e, 0x9a, 0xda, 0x64, 0xb2, 0x97, 0x87, 0x73, 0x84, 0xe5, 0x85, + 0x72, 0x80, 0x13, 0x06, 0x6c, 0x5c, 0x28, 0x83, 0x74, 0x72, 0x3b, 0x4d, + 0xb5, 0xce, 0x90, 0xc2, 0x41, 0xe6, 0x0f, 0x79, 0xab, 0xcb, 0xb8, 0xa4, + 0x31, 0x0e, 0xb0, 0x2b, 0x88, 0x4d, 0xc9, 0xb5, 0xbc, 0x9b, 0x43, 0x86, + 0xc7, 0x9f, 0x7f, 0x27, 0x89, 0x03, 0xa2, 0x44, 0xef, 0x05, 0xad, 0x1a, + 0xe9, 0x9a, 0xd5, 0x30, 0x17, 0x5b, 0x15, 0x94, 0xb5, 0xde, 0x44, 0xda, + 0x09, 0x2e, 0x1e, 0xbb, 0x08, 0xc3, 0xfc, 0xf8, 0xb4, 0x60, 0x88, 0xdb, + 0xc6, 0xc5, 0xc7, 0x05, 0x53, 0x85, 0xa9, 0xf3, 0x7d, 0x25, 0x17, 0x12, + 0x8e, 0x79, 0x7e, 0x51, 0x1b, 0xed, 0xa1, 0xc3, 0x86, 0xcf, 0x15, 0x05, + 0xa5, 0x33, 0xdf, 0xd3, 0x0b, 0x30, 0x86, 0x41, 0x2f, 0xb9, 0xae, 0xed, + 0xfa, 0xee, 0x1e, 0x44, 0xf8, 0xd3, 0x3d, 0xa3, 0x68, 0xe4, 0x53, 0x2b, + 0xa3, 0x03, 0x66, 0x9e, 0x47, 0x34, 0x3d, 0x32, 0xb3, 0x68, 0x88, 0x71, + 0xc8, 0x08, 0x88, 0xbe, 0xcf, 0x17, 0x83, 0x26, 0xc2, 0x29, 0x1b, 0x14, + 0x54, 0xa2, 0x2e, 0xd1, 0xfb, 0x8b, 0x7d, 0xee, 0x10, 0x41, 0x27, 0xa9, + 0xcf, 0x62, 0x57, 0x67, 0x26, 0x55, 0x57, 0xa4, 0xdb, 0x31, 0xf1, 0xf6, + 0x2d, 0xf6, 0x82, 0xea, 0x0e, 0x22, 0xca, 0xc9, 0xd9, 0x85, 0xbd, 0xca, + 0x64, 0x8c, 0xb6, 0x70, 0xc7, 0x7d, 0xeb, 0x56, 0x08, 0x55, 0x2e, 0x74, + 0x4c, 0xcf, 0xf8, 0xe6, 0x29, 0x82, 0xa2, 0x1a, 0x0a, 0xdc, 0x87, 0x21, + 0x2a, 0xd2, 0xa6, 0xa6, 0x7e, 0xe3, 0xd2, 0x58, 0xe9, 0x19, 0x63, 0x17, + 0x2e, 0x24, 0xae, 0x36, 0x83, 0x4a, 0xb9, 0x74, 0x65, 0x7a, 0x8f, 0x63, + 0x3d, 0xc7, 0x22, 0x0d, 0x39, 0xf1, 0x03, 0x30, 0xa7, 0xb9, 0xe2, 0x69, + 0xf0, 0x25, 0x5a, 0x69, 0xcb, 0xe5, 0xc6, 0xec, 0x9d, 0xe7, 0xea, 0x9a, + 0xd4, 0xc2, 0x61, 0x8f, 0x7f, 0x72, 0xa2, 0xdf, 0x59, 0x0f, 0x48, 0xaa, + 0x9c, 0x1b, 0x8f, 0x31, 0xc5, 0x03, 0x1e, 0xcc, 0x9e, 0x63, 0x93, 0xbb, + 0x54, 0x36, 0x77, 0x45, 0x4f, 0x00, 0x25, 0x16, 0x51, 0x9f, 0xa4, 0xa8, + 0xe5, 0xe0, 0x4f, 0xac, 0x4a, 0x15, 0xc3, 0x11, 0xf2, 0x83, 0x57, 0xec, + 0x22, 0x2d, 0x70, 0x66, 0x91, 0x55, 0x39, 0xfb, 0xcb, 0x91, 0xa1, 0xc3, + 0x96, 0x9e, 0x12, 0x4f, 0xab, 0xdd, 0xbf, 0x98, 0xc5, 0x46, 0x5b, 0xb3, + 0x08, 0xa5, 0x94, 0x7c, 0xc9, 0xcd, 0xf6, 0x96, 0x01, 0x1f, 0xc5, 0xf9, + 0xee, 0x5d, 0xff, 0xf2, 0x4b, 0x7d, 0x24, 0xd8, 0x81, 0x0c, 0x2b, 0x0b, + 0x6a, 0x99, 0xb5, 0x2a, 0x5a, 0x3f, 0xe0, 0x75, 0xed, 0x19, 0x22, 0x25, + 0x55, 0x4c, 0xba, 0x23, 0xc5, 0x24, 0xda, 0x17, 0x4d, 0x04, 0xec, 0x91, + 0x2b, 0x37, 0xcc, 0xab, 0x9f, 0x94, 0x27, 0xc5, 0xa8, 0x6a, 0xb8, 0x17, + 0xc0, 0x4c, 0x1d, 0x3c, 0xbc, 0x6b, 0xd5, 0xd1, 0xc0, 0xfd, 0xa3, 0xd8, + 0x79, 0x26, 0x12, 0xef, 0x3a, 0xbb, 0x5b, 0xa4, 0xc4, 0xb4, 0xcb, 0x03, + 0x20, 0xa7, 0x1e, 0xda, 0x64, 0xc2, 0xbf, 0xc5, 0x51, 0xcc, 0x50, 0x1a, + 0xe0, 0x73, 0x2e, 0xcc, 0x9c, 0x1e, 0x8d, 0xe3, 0x2c, 0xa4, 0xae, 0x76, + 0x41, 0xa1, 0x69, 0x1e, 0x75, 0x46, 0x32, 0xdd, 0xfc, 0x02, 0x6f, 0xc8, + 0x0a, 0xac, 0x1e, 0x97, 0x61, 0x37, 0x3a, 0x85, 0x23, 0x27, 0x79, 0x74, + 0x4b, 0xdd, 0x2b, 0xd6, 0xca, 0x70, 0xa7, 0x47, 0xb1, 0x7a, 0x0c, 0x27, + 0xb1, 0x0f, 0x89, 0x2a, 0xad, 0x13, 0x77, 0x64, 0xcb, 0xec, 0xdc, 0x27, + 0x7e, 0xf0, 0xf9, 0x6e, 0xfa, 0x04, 0x8c, 0x14, 0xb0, 0xd4, 0x22, 0x83, + 0x90, 0x04, 0x49, 0x41, 0x87, 0x85, 0x46, 0xda, 0x12, 0x3d, 0xf5, 0x93, + 0x97, 0xa1, 0xce, 0x3d, 0x0e, 0xeb, 0xdd, 0xda, 0x09, 0x6d, 0xa2, 0xa7, + 0x73, 0x0e, 0xd3, 0x32, 0xb4, 0x69, 0xbd, 0x76, 0x13, 0x81, 0xb7, 0xb9, + 0x0f, 0xd1, 0xa1, 0x75, 0x7c, 0x11, 0xb2, 0x39, 0x45, 0x8d, 0x8f, 0x58, + 0x29, 0xd4, 0x5b, 0x6c, 0x0b, 0x9a, 0x21, 0x0d, 0xb4, 0x22, 0xd7, 0x99, + 0x9c, 0xb4, 0xa5, 0xbf, 0xa1, 0x60, 0x45, 0xa0, 0x57, 0x89, 0x91, 0x16, + 0x0f, 0xdc, 0x1e, 0x60, 0xa4, 0x87, 0xe9, 0x78, 0xa3, 0x95, 0xb7, 0x6b, + 0x9e, 0x68, 0xb6, 0xcd, 0xef, 0x51, 0xac, 0x44, 0x70, 0x15, 0xcb, 0xab, + 0x2a, 0xa6, 0x3a, 0x66, 0x2e, 0x32, 0x70, 0xf1, 0x53, 0xb2, 0xe8, 0xd5, + 0x9a, 0x77, 0x86, 0x57, 0xa7, 0x3d, 0x9b, 0x42, 0x4d, 0x61, 0xe4, 0xad, + 0x25, 0x5c, 0xc9, 0x51, 0xcf, 0xc7, 0x94, 0x86, 0x3e, 0x21, 0xd8, 0x76, + 0x7b, 0x5a, 0x0a, 0x37, 0x43, 0x14, 0xfb, 0x01, 0x60, 0x4c, 0xd0, 0x7d, + 0xbc, 0x87, 0xa5, 0xfd, 0xc6, 0xe7, 0x76, 0xdb, 0x0b, 0xbe, 0x8e, 0xd9, + 0x8d, 0xc9, 0x01, 0x00, 0xb3, 0x13, 0xc9, 0x70, 0x96, 0xaa, 0x98, 0x11, + 0x22, 0x01, 0x67, 0x5e, 0x85, 0x1a, 0x54, 0x68, 0x9b, 0x40, 0x06, 0xda, + 0xb2, 0xf5, 0xda, 0x04, 0x85, 0x18, 0x67, 0x20, 0x40, 0x38, 0x58, 0xe9, + 0xca, 0x3c, 0x7b, 0xf2, 0x27, 0xef, 0x87, 0x34, 0xda, 0x85, 0xa4, 0xe3, + 0xd6, 0xd9, 0xd9, 0xee, 0x75, 0x79, 0x5d, 0xba, 0xd4, 0x50, 0x3d, 0xeb, + 0xb3, 0xa5, 0x9e, 0x74, 0xfe, 0x4c, 0x2c, 0x69, 0x41, 0x38, 0x73, 0xd8, + 0xda, 0x9f, 0x4f, 0xde, 0xb8, 0xe0, 0x69, 0xbf, 0xff, 0xf8, 0x3d, 0x08, + 0x1b, 0x2b, 0x11, 0x26, 0x4e, 0x20, 0x00, 0x31, 0x00, 0x10, 0x00, 0x20, + 0x00, 0x28, 0x00, 0x01, 0x00, 0x0b, 0x00, 0x03, 0x00, 0xe6, 0xab, 0x32, + 0xa4, 0x74, 0xcc, 0xd6, 0x75, 0x52, 0x21, 0x6d, 0xbb, 0xe1, 0xd3, 0x3c, + 0xbe, 0x01, 0x81, 0x62, 0x8a, 0x88, 0x29, 0x5e, 0x96, 0x0e, 0x6a, 0x8b, + 0x7e, 0xc5, 0xf3, 0x9b, 0x27, 0x53, 0xe0, 0xd8, 0xe1, 0x79, 0xcb, 0x13, + 0x0a, 0x8b, 0xd9, 0x08, 0x41, 0x8c, 0xe0, 0xf6, 0x23, 0x9a, 0x87, 0x04, + 0x5f, 0x7e, 0x99, 0xf8, 0xb1, 0xd5, 0x73, 0xe4, 0x55, 0xc6, 0xb7, 0x9a, + 0x84, 0xf5, 0x26, 0x92, 0x29, 0xe1, 0x9b, 0x97, 0x71, 0xb6, 0x91, 0xff, + 0xfb, 0xa1, 0x3f, 0xcd, 0x7e, 0x43, 0x68, 0xf9, 0x81, 0xf0, 0x59, 0x94, + 0x7f, 0x6a, 0x19, 0x3f, 0x4b, 0xa7, 0x83, 0x25, 0xdb, 0xf6, 0x0c, 0x23, + 0x48, 0xa8, 0x98, 0x64, 0x7e, 0xa8, 0x0b, 0x71, 0x39, 0x57, 0x33, 0x14, + 0x9e, 0x0f, 0xcf, 0x60, 0x89, 0x1b, 0x41, 0x27, 0x51, 0x6c, 0xc2, 0xf5, + 0x44, 0x8b, 0x23, 0xcc, 0x4d, 0xba, 0x82, 0xa5, 0x88, 0x95, 0x61, 0x5d, + 0x04, 0x6f, 0xa2, 0x5f, 0x2e, 0xc6, 0x95, 0xcd, 0x8b, 0x18, 0x9f, 0x1d, + 0x10, 0x0a, 0x09, 0xa9, 0x9e, 0x90, 0x1e, 0x0d, 0x6f, 0xca, 0x30, 0x11, + 0xd1, 0x10, 0x9d, 0xbd, 0xc4, 0x4b, 0xd9, 0x09, 0xc6, 0xbd, 0x95, 0xc4, + 0x81, 0x32, 0xea, 0xbe, 0x60, 0xf1, 0x68, 0xb3, 0x7f, 0xc7, 0xde, 0x97, + 0xae, 0xe2, 0x61, 0x29, 0x44, 0x93, 0xca, 0x25, 0x2d, 0xeb, 0x3f, 0x45, + 0x75, 0xbe, 0x0c, 0x13, 0xf3, 0xc3, 0x5b, 0x6b, 0xa6, 0x4d, 0x7f, 0x0a, + 0x4d, 0x9e, 0xbc, 0xe6, 0x88, 0x69, 0xb9, 0xa4, 0xe0, 0xf1, 0xf0, 0x5f, + 0x0c, 0x22, 0xc2, 0x58, 0x0a, 0x1f, 0x35, 0x07, 0x57, 0x5c, 0x19, 0x56, + 0x93, 0x41, 0x43, 0x41, 0x20, 0x96, 0x9f, 0x04, 0x7d, 0x04, 0xa9, 0x2c, + 0x9c, 0xc6, 0x16, 0x6a, 0x2d, 0x19, 0x8d, 0xcf, 0x7b, 0xec, 0xe8, 0xe0, + 0x53, 0xbf, 0xe3, 0x94, 0xa9, 0xf9, 0xa9, 0x1a, 0x6e, 0x9d, 0x1e, 0x15, + 0xe0, 0x56, 0xe3, 0x4f, 0x4e, 0x4f, 0x23, 0x7f, 0x4e, 0xbc, 0x0e, 0xd4, + 0x85, 0xcc, 0x42, 0x1c, 0x4e, 0x86, 0xd5, 0x76, 0x08, 0xe0, 0xce, 0x45, + 0x39, 0x27, 0x38, 0xf0, 0xfa, 0xe5, 0x00, 0x9a, 0xd5, 0x00, 0x89, 0x90, + 0x58, 0x5d, 0x8a, 0x0a, 0xf7, 0xd9, 0x7e, 0x51, 0x15, 0x7c, 0x3e, 0x84, + 0x3a, 0x86, 0x62, 0x84, 0x8f, 0x6e, 0x4f, 0x42, 0x53, 0xfb, 0xde, 0x3f, + 0x1b, 0x81, 0x34, 0x9f, 0x5f, 0x6c, 0x0a, 0x1f, 0x17, 0x05, 0x0e, 0x7e, + 0xa0, 0x86, 0x1a, 0x44, 0x0f, 0xbc, 0x9b, 0x5c, 0x73, 0x90, 0xe4, 0x67, + 0x4c, 0x0d, 0x9e, 0xeb, 0x58, 0xcc, 0x20, 0x67, 0x7a, 0x99, 0x26, 0xaf, + 0xbe, 0xfb, 0x6c, 0x88, 0x44, 0xd2, 0x2f, 0xa8, 0x22, 0x5e, 0x8d, 0xd5, + 0x8d, 0x15, 0xb4, 0x3a, 0xa6, 0xd9, 0x4b, 0xb5, 0x2e, 0x7a, 0x76, 0xdf, + 0x5f, 0x69, 0x4d, 0x40, 0x32, 0x80, 0xd3, 0xd8, 0x17, 0x67, 0x08, 0x2f, + 0x3a, 0x97, 0x8d, 0x18, 0x59, 0x0c, 0xf3, 0x2b, 0xa4, 0xfb, 0x20, 0x4c, + 0x54, 0x4c, 0xc8, 0x27, 0x80, 0xa7, 0xd3, 0x43, 0x84, 0xb6, 0xb6, 0x8f, + 0xd6, 0xcd, 0x1a, 0xaa, 0x42, 0x67, 0xb3, 0xd2, 0x43, 0x1d, 0xa6, 0x89, + 0xdc, 0x89, 0x53, 0x84, 0xb8, 0x6d, 0x27, 0x7d, 0xeb, 0xe7, 0xbe, 0x62, + 0x96, 0x5e, 0x28, 0xc0, 0x18, 0xdf, 0x78, 0x84, 0x98, 0xa1, 0x54, 0x99, + 0x16, 0x68, 0xe0, 0xb6, 0x31, 0x43, 0xa5, 0x50, 0xf4, 0xda, 0x49, 0x88, + 0x14, 0x48, 0xc2, 0x28, 0xe5, 0x94, 0x4c, 0xe5, 0xd4, 0x84, 0x33, 0xa5, + 0xb8, 0x20, 0x5b, 0xca, 0xeb, 0x47, 0xc5, 0x44, 0x6d, 0x60, 0x06, 0x7f, + 0xfd, 0x47, 0xd6, 0x96, 0xed, 0xe2, 0xae, 0x8f, 0x4c, 0x87, 0xa6, 0x29, + 0x3a, 0x15, 0x63, 0x44, 0x45, 0x9b, 0x44, 0xef, 0x51, 0xc7, 0x15, 0x96, + 0xdb, 0xf1, 0xf8, 0x61, 0xc2, 0x7b, 0x27, 0x8b, 0xe8, 0x0d, 0x89, 0x3a, + 0x70, 0x6a, 0x32, 0x45, 0xfd, 0x65, 0x4d, 0x10, 0xc9, 0x0b, 0x76, 0x48, + 0x6a, 0x58, 0xbc, 0xd0, 0x09, 0xd5, 0xbb, 0x13, 0x8f, 0x62, 0xe2, 0xd0, + 0xa5, 0xbc, 0xbf, 0x9d, 0xbd, 0x1e, 0xc6, 0xe6, 0x17, 0x2f, 0x40, 0xfa, + 0x18, 0x40, 0xe0, 0xef, 0xbc, 0x56, 0x62, 0x70, 0x48, 0xe1, 0x50, 0x45, + 0x49, 0x07, 0x0b, 0xcd, 0x96, 0x04, 0x37, 0xb8, 0x10, 0x28, 0xe5, 0xdc, + 0x4e, 0x2f, 0x4d, 0x33, 0x2c, 0xf5, 0x75, 0x58, 0x41, 0xb9, 0xa3, 0xc5, + 0xa5, 0xf9, 0x56, 0xa9, 0x5c, 0x7d, 0xf4, 0x18, 0x1b, 0xfe, 0xad, 0x93, + 0x75, 0x7e, 0x08, 0x80, 0x29, 0xf0, 0x1e, 0x5d, 0xbf, 0x9a, 0xb9, 0xc7, + 0xb1, 0xd1, 0xbe, 0xdf, 0x43, 0x25, 0xcf, 0xfe, 0x39, 0x13, 0xae, 0x11, + 0x17, 0x01, 0x4a, 0x8c, 0x3a, 0x0b, 0x54, 0x68, 0x45, 0x7a, 0x0f, 0xaa, + 0xce, 0x2f, 0x05, 0xa6, 0x30, 0x91, 0xb3, 0x10, 0x1f, 0x6d, 0xf7, 0x2b, + 0x65, 0x34, 0x55, 0xe5, 0xa4, 0xcf, 0x2b, 0x74, 0x2a, 0xab, 0xa1, 0xf5, + 0xa2, 0x01, 0x21, 0x24, 0xfe, 0x19, 0x65, 0xe5, 0x93, 0x3d, 0xe8, 0x38, + 0x79, 0xc5, 0x22, 0x07, 0x42, 0x9d, 0x3d, 0xe8, 0x53, 0x68, 0x2e, 0xa1, + 0x3d, 0x70, 0xa4, 0x31, 0x9c, 0x52, 0x30, 0x49, 0xae, 0xe0, 0x2e, 0x14, + 0x8b, 0xde, 0x21, 0x5e, 0x79, 0xc7, 0xfd, 0xfd, 0xff, 0x2e, 0x43, 0xc8, + 0xdd, 0x22, 0xe2, 0x87, 0x03, 0xe4, 0xf5, 0x0c, 0x1a, 0x38, 0x42, 0x1d, + 0xc9, 0x2b, 0xd0, 0x53, 0x1e, 0x83, 0xf7, 0x24, 0x6e, 0x29, 0x6e, 0x64, + 0x62, 0x04, 0x72, 0xde, 0x86, 0x37, 0xd4, 0xf3, 0xd1, 0x65, 0x64, 0x31, + 0x25, 0x47, 0x19, 0xb8, 0x71, 0xe8, 0xd6, 0xa7, 0xcf, 0x7f, 0x19, 0x81, + 0x21, 0x2a, 0xff, 0xbd, 0x35, 0x84, 0xeb, 0x52, 0x0c, 0x28, 0x0b, 0xc3, + 0x0f, 0xc0, 0x8d, 0x2d, 0x71, 0x88, 0x29, 0xaa, 0xb6, 0x2f, 0xce, 0x2b, + 0x4e, 0x70, 0xfc, 0x67, 0xe3, 0x79, 0xa3, 0x2b, 0x8f, 0x0a, 0xa0, 0x0a, + 0x45, 0x38, 0x47, 0xd9, 0xab, 0xa7, 0x9f, 0xbe, 0x71, 0xaa, 0xdb, 0xb1, + 0x68, 0xef, 0xdc, 0x24, 0x85, 0x2c, 0xa6, 0x5b, 0x65, 0xd0, 0x9b, 0x05, + 0x1a, 0x7d, 0x92, 0x8b, 0x97, 0xe9, 0x3a, 0x10, 0x3f, 0xf0, 0xd0, 0xe3, + 0xa5, 0x5c, 0x07, 0xda, 0x56, 0xd3, 0x45, 0x28, 0xb7, 0x0f, 0x07, 0x12, + 0xf0, 0xba, 0x80, 0x97, 0x60, 0xbd, 0xbd, 0xb0, 0x9c, 0x4e, 0x1a, 0xec, + 0xd2, 0xc0, 0x85, 0x32, 0x67, 0xb6, 0xf4, 0xa9, 0xef, 0x74, 0xea, 0x82, + 0xc3, 0xa2, 0x92, 0xa4, 0xbb, 0x48, 0xbb, 0xd1, 0x78, 0x91, 0x9c, 0xfe, + 0xed, 0x13, 0xc5, 0x1a, 0x75, 0x1d, 0x94, 0x5e, 0xa3, 0xc2, 0xe0, 0x58, + 0x7c, 0x32, 0xe8, 0x11, 0x2b, 0xc9, 0x45, 0x7e, 0xb5, 0x4c, 0x78, 0x5a, + 0xad, 0x47, 0xee, 0x59, 0x22, 0x2d, 0xf4, 0x60, 0x33, 0xfe, 0xc4, 0xcb, + 0x1b, 0xed, 0xe7, 0x17, 0x67, 0x6d, 0xff, 0x3d, 0x4f, 0xcc, 0x12, 0xd1, + 0x25, 0x16, 0xff, 0x1d, 0x93, 0x8d, 0x7d, 0x93, 0xf4, 0x3e, 0xef, 0x7b, + 0xaa, 0x95, 0x1d, 0xb6, 0x79, 0x58, 0x17, 0x27, 0xd9, 0xfa, 0xfe, 0x42, + 0x5e, 0xff, 0xfa, 0x94, 0x41, 0x4a, 0x4f, 0x0c, 0x58, 0x99, 0xd4, 0x77, + 0x08, 0x84, 0xf1, 0xa4, 0x40, 0x22, 0xd5, 0x35, 0xb9, 0x6e, 0xde, 0x4e, + 0x7e, 0xac, 0x83, 0x90, 0xd6, 0xc6, 0xba, 0xa3, 0xe5, 0x9a, 0xfc, 0x12, + 0xb5, 0x3b, 0x23, 0x37, 0xe6, 0x43, 0xe6, 0x9c, 0x32, 0x3e, 0x1a, 0x34, + 0x79, 0x80, 0x77, 0x44, 0x45, 0x85, 0xba, 0x86, 0x53, 0xfa, 0x22, 0x86, + 0x92, 0x18, 0xc6, 0x26, 0x9b, 0xdb, 0xf6, 0x0f, 0xdb, 0x06, 0xce, 0x88, + 0x7d, 0x33, 0x19, 0x21, 0xab, 0xa9, 0xf4, 0xd6, 0x2b, 0x5e, 0x4d, 0x9e, + 0x82, 0xe8, 0x4f, 0xe0, 0x9a, 0xe3, 0x79, 0xfe, 0x84, 0x05, 0xa4, 0x51, + 0x10, 0x45, 0x86, 0x12, 0xf6, 0x48, 0x19, 0x6e, 0xc2, 0x00, 0xe5, 0x28, + 0x9b, 0x99, 0x5f, 0x4b, 0xc0, 0x9b, 0xcf, 0x36, 0xb5, 0x17, 0xc1, 0x28, + 0x8f, 0x2c, 0x92, 0xb5, 0x59, 0x58, 0x2e, 0x2d, 0x24, 0xe3, 0x30, 0x50, + 0x2b, 0xd2, 0xc2, 0x3c, 0x35, 0x62, 0x63, 0xa5, 0xeb, 0x29, 0x80, 0x3b, + 0xde, 0x68, 0xad, 0xf6, 0xf4, 0x53, 0x8e, 0xe0, 0xb2, 0x1c, 0x84, 0x5c, + 0x3f, 0xea, 0x2e, 0x63, 0x81, 0xc7, 0xe3, 0xfd, 0x66, 0xc6, 0xd1, 0x4c, + 0xa1, 0xc0, 0xa2, 0x29, 0xfb, 0xe5, 0x23, 0x42, 0x44, 0x13, 0x99, 0x76, + 0xfd, 0x8c, 0xe3, 0xf8, 0xc9, 0xaf, 0x2d, 0x21, 0x96, 0xa9, 0x38, 0x7f, + 0x9e, 0xcf, 0x09, 0x9e, 0xd8, 0x85, 0x4d, 0x47, 0x0b, 0x5b, 0x63, 0x7c, + 0xc7, 0x83, 0xa8, 0x30, 0xc0, 0x62, 0x68, 0xb8, 0x0f, 0x78, 0x68, 0xa9, + 0xa2, 0xc5, 0xc1, 0xb5, 0xd7, 0xe6, 0xcd, 0x54, 0x05, 0x43, 0xce, 0xf9, + 0x51, 0xdf, 0x1c, 0x42, 0x26, 0x8f, 0xe0, 0xdf, 0x22, 0xc1, 0x81, 0xce, + 0x44, 0x1e, 0x88, 0x96, 0x5e, 0x6d, 0x74, 0xfc, 0xa6, 0x74, 0x26, 0x0c, + 0x2d, 0x57, 0x51, 0x4c, 0xb7, 0xa9, 0xb2, 0xda, 0x6c, 0xa4, 0xf2, 0x8b, + 0x7e, 0x87, 0x9f, 0x33, 0xe2, 0x52, 0x77, 0x20, 0xc7, 0x51, 0x08, 0x32, + 0x0f, 0xa6, 0x80, 0x4b, 0x9a, 0x0f, 0xec, 0xa9, 0x21, 0x9c, 0x8d, 0xf2, + 0x19, 0xbc, 0x2f, 0xeb, 0x3c, 0xc6, 0x73, 0x86, 0xc9, 0x31, 0xe4, 0x43, + 0x62, 0xd0, 0x72, 0x53, 0xd2, 0x1c, 0x3c, 0xa3, 0x03, 0xb9, 0x8a, 0x0b, + 0x08, 0x62, 0x93, 0xd7, 0x9c, 0x43, 0x3e, 0x79, 0x78, 0xf1, 0x8e, 0x5d, + 0xf5, 0x02, 0xe4, 0x01, 0x46, 0x86, 0x1b, 0x41, 0xce, 0xf1, 0xa4, 0x02, + 0xdf, 0x35, 0x33, 0xb8, 0xb6, 0xb9, 0x1a, 0xe6, 0xab, 0x74, 0xa0, 0x53, + 0x73, 0x0b, 0x33, 0x6d, 0x28, 0x99, 0x66, 0x1e, 0x3e, 0x0b, 0x1e, 0xb9, + 0x10, 0xd4, 0x56, 0x12, 0x3f, 0x66, 0x51, 0x44, 0xf5, 0xaf, 0xf7, 0x6d, + 0x06, 0xb2, 0x9d, 0xbb, 0xef, 0x27, 0x45, 0x5c, 0x66, 0x09, 0x8d, 0x23, + 0x64, 0x23, 0x16, 0x23, 0x3e, 0xde, 0xd1, 0x27, 0xd9, 0x88, 0xdd, 0x00, + 0x83, 0xf4, 0x0d, 0x5d, 0x48, 0x1b, 0xd5, 0x11, 0x92, 0xfa, 0x10, 0x4a, + 0xc2, 0xb7, 0x2e, 0xb1, 0x17, 0xd9, 0xb6, 0x46, 0x23, 0x6e, 0xb7, 0xbe, + 0x6c, 0x82, 0x2f, 0x82, 0x2c, 0xf3, 0xfd, 0x7a, 0x1d, 0xab, 0x37, 0x5d, + 0x8e, 0xda, 0xc5, 0x12, 0x66, 0x82, 0x74, 0xd6, 0xe8, 0x1d, 0x51, 0x2d, + 0xd6, 0xfd, 0x05, 0xda, 0xcc, 0xcf, 0x94, 0xf6, 0x84, 0xb3, 0x24, 0x5f, + 0xa0, 0x08, 0xe8, 0x8b, 0xda, 0x13, 0xd2, 0x31, 0xed, 0x94, 0x08, 0x39, + 0xf0, 0xa9, 0xcd, 0xb5, 0xb9, 0x88, 0x0f, 0xbf, 0x11, 0x2a, 0x5e, 0xd7, + 0x8b, 0xa1, 0xa0, 0xb3, 0x04, 0x55, 0x63, 0x70, 0xe4, 0xac, 0xfc, 0xf1, + 0xa7, 0xa0, 0x16, 0xa0, 0x17, 0xd1, 0x20, 0xb6, 0x56, 0xd4, 0x4c, 0x10, + 0x22, 0xde, 0xe5, 0xe7, 0x13, 0x22, 0x5a, 0x56, 0x11, 0xed, 0xbb, 0xc1, + 0x2e, 0x28, 0x2b, 0x19, 0xa7, 0x22, 0x5e, 0x4a, 0x7f, 0xd3, 0xbb, 0xdb, + 0x3c, 0x92, 0xc6, 0x0a, 0x47, 0x53, 0x72, 0x33, 0x56, 0xdb, 0xcd, 0x05, + 0xdc, 0xf7, 0x95, 0x36, 0x36, 0xfe, 0x7b, 0x74, 0x03, 0x2a, 0xce, 0x2b, + 0x09, 0x9a, 0x88, 0xcf, 0xac, 0x05, 0x99, 0x76, 0xc0, 0x55, 0x64, 0xe3, + 0xa6, 0x55, 0x8a, 0x6e, 0x04, 0x16, 0xce, 0x17, 0x34, 0x90, 0x4c, 0xa1, + 0x30, 0x6f, 0x9b, 0x31, 0x47, 0xd4, 0x24, 0x7e, 0xfb, 0xd5, 0x81, 0x37, + 0x86, 0x84, 0x9f, 0x48, 0xba, 0xf5, 0x5f, 0x34, 0x3d, 0xf1, 0xd7, 0x03, + 0x0e, 0x37, 0x15, 0xe7, 0xb0, 0xe8, 0xf1, 0x77, 0x71, 0xa6, 0x1a, 0x66, + 0xa9, 0x14, 0x5f, 0x9d, 0xe9, 0x8b, 0x9b, 0xbd, 0xad, 0x8b, 0x64, 0x49, + 0x79, 0x76, 0x51, 0x18, 0x40, 0x92, 0x00, 0xc6, 0x75, 0x0e, 0xa8, 0x96, + 0x1e, 0x25, 0xe2, 0x93, 0xd2, 0x71, 0xa4, 0x47, 0x3f, 0x66, 0xf1, 0x19, + 0x71, 0xfa, 0x5e, 0x16, 0x7b, 0xb3, 0x25, 0x7a, 0xfd, 0xf7, 0x81, 0xc2, + 0x0e, 0x05, 0x86, 0x02, 0x49, 0xe4, 0x02, 0x6d, 0xc4, 0x81, 0xec, 0x65, + 0x94, 0x60, 0xbc, 0x49, 0x34, 0x6f, 0x97, 0xc4, 0x16, 0x0a, 0x42, 0x8b, + 0x4e, 0x77, 0x37, 0x31, 0x56, 0xd4, 0x3e, 0xe7, 0x61, 0x3d, 0x1c, 0x1f, + 0x48, 0xbd, 0x6f, 0xe2, 0x32, 0x67, 0xb8, 0xd1, 0xd7, 0x98, 0x92, 0x1d, + 0xe8, 0x47, 0x2f, 0xaf, 0x9f, 0xd7, 0x60, 0x0f, 0xb9, 0x38, 0x7a, 0x11, + 0xcd, 0xcd, 0x89, 0x47, 0xc1, 0x84, 0x53, 0x1d, 0x97, 0xa3, 0x66, 0xcb, + 0x8a, 0x56, 0x63, 0x74, 0xdc, 0x65, 0x81, 0x5c, 0xc2, 0x76, 0x93, 0x54, + 0x90, 0x3e, 0x75, 0x64, 0xa1, 0x7d, 0x3a, 0xbf, 0x55, 0x02, 0xba, 0x04, + 0xf4, 0xcd, 0x42, 0xc5, 0x91, 0xc9, 0x7d, 0x93, 0x5a, 0x4d, 0xa4, 0x3a, + 0x68, 0x17, 0x94, 0x65, 0x50, 0xc2, 0xd8, 0xfa, 0x99, 0x26, 0x86, 0xa1, + 0xe6, 0x34, 0xa3, 0xc4, 0x6e, 0xd2, 0x06, 0x4f, 0x51, 0xc3, 0x94, 0x0f, + 0x17, 0xd0, 0x35, 0x64, 0x80, 0xf6, 0x07, 0x18, 0xa3, 0xa0, 0x95, 0xc3, + 0x73, 0xf1, 0x74, 0x94, 0x7a, 0x14, 0x83, 0x3f, 0xda, 0x88, 0x1a, 0x0c, + 0x3c, 0x1b, 0x8c, 0x06, 0x5c, 0x6c, 0xf7, 0xd4, 0x21, 0xd6, 0x2c, 0x07, + 0x88, 0x2b, 0x9a, 0x1f, 0x49, 0x63, 0x4a, 0x78, 0x95, 0x28, 0x74, 0xb6, + 0x68, 0x89, 0xf3, 0x6e, 0x32, 0x5a, 0xa0, 0xb0, 0xa9, 0x13, 0xdb, 0x4b, + 0x21, 0x25, 0x37, 0x03, 0xfb, 0xe1, 0xd0, 0x32, 0x4d, 0xd4, 0xf4, 0x41, + 0xe9, 0xea, 0x93, 0x35, 0x6b, 0xb5, 0xa2, 0x7b, 0x68, 0xdc, 0xed, 0x30, + 0x4f, 0xed, 0xd4, 0xaa, 0x82, 0x5d, 0x44, 0xcb, 0x47, 0x8f, 0x73, 0x96, + 0xee, 0x03, 0x9f, 0xa4, 0x51, 0x91, 0x8d, 0x24, 0x99, 0x92, 0xe8, 0x18, + 0x11, 0x31, 0x16, 0xee, 0x75, 0x90, 0xe4, 0xa4, 0x54, 0xaf, 0xf3, 0x13, + 0xd8, 0xe5, 0xc8, 0xde, 0x7d, 0x9e, 0xa8, 0x94, 0x3b, 0x2f, 0xa2, 0x46, + 0x30, 0x87, 0x28, 0x26, 0xb3, 0x67, 0xf8, 0x6e, 0xa3, 0x07, 0xf0, 0xaf, + 0xe1, 0x4f, 0x53, 0x1a, 0xa7, 0xb2, 0x4e, 0xae, 0x1b, 0x6b, 0x3d, 0x7d, + 0x09, 0x3a, 0xea, 0x22, 0x35, 0x9f, 0x26, 0x2b, 0x49, 0x45, 0x37, 0xe8, + 0x78, 0x73, 0x21, 0x50, 0x34, 0x5f, 0x76, 0x67, 0x50, 0x97, 0x92, 0x56, + 0x97, 0xad, 0x17, 0xb2, 0xb3, 0x2a, 0x28, 0xbd, 0x92, 0x2f, 0xae, 0x7e, + 0xaa, 0x98, 0xa5, 0x4d, 0xa0, 0x6d, 0xdb, 0x83, 0x24, 0xd2, 0x43, 0x3e, + 0xa2, 0xad, 0x83, 0xd9, 0x61, 0x03, 0x2d, 0x53, 0xb4, 0x5d, 0x4a, 0xd5, + 0xfb, 0x0a, 0x9e, 0xb1, 0xbc, 0xdd, 0xc0, 0x90, 0x13, 0x00, 0x11, 0x9e, + 0x4b, 0x9f, 0x85, 0x71, 0x24, 0xa6, 0x9f, 0x19, 0x22, 0x65, 0x5f, 0x13, + 0x4f, 0x6b, 0x81, 0x9b, 0xc5, 0xb5, 0x36, 0x2a, 0x6a, 0xbb, 0x1a, 0xb0, + 0xdb, 0x92, 0x55, 0x25, 0x0b, 0x41, 0x84, 0xf1, 0x3b, 0x61, 0xb4, 0x53, + 0xfc, 0xd5, 0xc0, 0x75, 0xaa, 0xcf, 0x6e, 0x48, 0x1d, 0x47, 0x41, 0x70, + 0x83, 0x01, 0xc1, 0x02, 0xb8, 0x54, 0x03, 0xd7, 0x68, 0xc3, 0x74, 0xff, + 0xf8, 0x3d, 0x08, 0x1c, 0x2b, 0x11, 0x30, 0x4a, 0xe8, 0x00, 0xe7, 0x00, + 0xfa, 0x00, 0xf7, 0x00, 0xf7, 0x00, 0xfc, 0x00, 0xe6, 0xb1, 0xf6, 0x99, + 0x3c, 0xcd, 0xde, 0xa8, 0x79, 0x63, 0x5f, 0x55, 0x01, 0xe3, 0x5c, 0x2f, + 0x00, 0xa5, 0xe6, 0x95, 0x19, 0x27, 0xe5, 0x3c, 0xe3, 0x60, 0x10, 0x66, + 0x59, 0xe9, 0xef, 0x50, 0xc9, 0x98, 0xa5, 0x80, 0x80, 0x29, 0xd9, 0x26, + 0x84, 0xb7, 0xc7, 0x96, 0x74, 0xf3, 0x3f, 0x12, 0x86, 0x78, 0xfb, 0x96, + 0x5f, 0x8c, 0x8a, 0x7c, 0xc0, 0xa7, 0x4d, 0x6b, 0xee, 0x3f, 0x50, 0xf8, + 0x01, 0xf0, 0x93, 0x1e, 0xe6, 0xa5, 0xf6, 0xb6, 0x69, 0x67, 0xa6, 0xfb, + 0x38, 0xb6, 0x22, 0x18, 0x27, 0x56, 0x84, 0x87, 0x14, 0x11, 0x71, 0xf4, + 0x6b, 0x7c, 0x20, 0xe4, 0x14, 0x57, 0x02, 0x62, 0xcc, 0xbf, 0xe2, 0x7a, + 0x24, 0x35, 0xd2, 0x23, 0xb6, 0xf9, 0xc2, 0xdd, 0x07, 0x56, 0x9c, 0xdc, + 0xda, 0x2b, 0x1d, 0xb6, 0xfb, 0xbe, 0xdd, 0x5d, 0xf8, 0xad, 0x0a, 0xce, + 0x0f, 0xb1, 0xee, 0x5a, 0x54, 0xd3, 0x9a, 0x41, 0xa5, 0xc0, 0x9f, 0x0f, + 0x28, 0x34, 0x6a, 0x08, 0x89, 0x33, 0xff, 0xe1, 0x30, 0x74, 0xad, 0xb7, + 0x36, 0x93, 0x50, 0xe7, 0x51, 0x38, 0x57, 0x31, 0xb6, 0x9f, 0x14, 0xf2, + 0x37, 0x25, 0xff, 0xbc, 0x24, 0x3e, 0x91, 0x3e, 0x4a, 0x79, 0x91, 0x4f, + 0xd5, 0x8d, 0x39, 0x60, 0x39, 0x46, 0x09, 0x97, 0xe3, 0x85, 0x26, 0xb1, + 0x38, 0xd6, 0xb0, 0xf2, 0x29, 0x9a, 0x68, 0xee, 0x8a, 0xd7, 0x14, 0xdc, + 0x37, 0x36, 0x6f, 0x8f, 0x93, 0xc4, 0x4e, 0x60, 0x32, 0x20, 0xa4, 0x9d, + 0x67, 0xd9, 0xc2, 0x66, 0x42, 0x11, 0x3a, 0x7e, 0xd2, 0x89, 0x44, 0xa8, + 0x57, 0x84, 0x0a, 0x13, 0xf5, 0xa6, 0x33, 0x99, 0x28, 0x1b, 0xa6, 0xf7, + 0x42, 0x2d, 0xb2, 0xe3, 0x3f, 0x39, 0x04, 0x64, 0xcc, 0xde, 0xc9, 0xde, + 0x9d, 0x37, 0xfb, 0x25, 0x30, 0x1c, 0x5c, 0x13, 0x9b, 0xce, 0xe1, 0x89, + 0x9a, 0xd0, 0x58, 0x2a, 0x14, 0x0e, 0x8a, 0xa9, 0xa6, 0x0d, 0x06, 0x0e, + 0x70, 0xe1, 0x36, 0xfd, 0x94, 0xd0, 0x53, 0xcb, 0x07, 0x7a, 0x7a, 0x03, + 0x05, 0x96, 0x6a, 0x60, 0x99, 0x4b, 0x7c, 0x82, 0x69, 0x7c, 0xc4, 0xa9, + 0xd8, 0xd9, 0x50, 0x98, 0xb2, 0x50, 0x76, 0x25, 0xd9, 0x26, 0x17, 0x02, + 0xd0, 0x0d, 0xe0, 0x0c, 0x71, 0x7f, 0xee, 0xed, 0xe1, 0xbb, 0x14, 0x84, + 0x83, 0x72, 0xa9, 0xec, 0xcf, 0xae, 0x14, 0x61, 0xa7, 0x41, 0x45, 0xa4, + 0x8f, 0x22, 0x69, 0x71, 0x4b, 0xd6, 0xb1, 0x56, 0xf6, 0xe5, 0x4a, 0x26, + 0x85, 0xc1, 0xca, 0xb1, 0x79, 0xb6, 0xfe, 0x4c, 0x3b, 0xa7, 0xd1, 0x9f, + 0xd7, 0xbe, 0x85, 0xf6, 0x26, 0x4c, 0x3b, 0x4f, 0x98, 0x2b, 0x3a, 0xed, + 0xb9, 0xd2, 0x59, 0x0a, 0x88, 0xbe, 0x9b, 0x7f, 0x33, 0x59, 0xfd, 0x92, + 0x73, 0x2b, 0x4a, 0xef, 0x43, 0xc5, 0x33, 0x1e, 0x30, 0x7a, 0x3a, 0xcc, + 0xb7, 0x99, 0x10, 0xd8, 0x9e, 0x4c, 0x9f, 0x45, 0xc5, 0x4d, 0xe5, 0x10, + 0xe3, 0x86, 0xf9, 0x87, 0x55, 0x6c, 0x71, 0x41, 0xca, 0x63, 0xad, 0xb3, + 0x73, 0xcc, 0xc7, 0xc6, 0x0d, 0xbd, 0x77, 0x36, 0x8c, 0xf1, 0x9b, 0xb5, + 0x1c, 0xb9, 0xf2, 0x17, 0x05, 0x9e, 0x6b, 0x1c, 0x21, 0xaa, 0x9c, 0x3f, + 0x29, 0x2a, 0x5a, 0x05, 0xbb, 0x54, 0x99, 0x80, 0x13, 0x8d, 0xca, 0x33, + 0xb4, 0xcc, 0x34, 0x32, 0x7c, 0x0b, 0xb5, 0x4c, 0xdd, 0xa3, 0x7f, 0x4f, + 0xb5, 0x92, 0x31, 0x5a, 0x2c, 0x35, 0xdd, 0x82, 0x03, 0x00, 0x68, 0x7e, + 0x0c, 0xce, 0x3a, 0x31, 0xc5, 0xf1, 0x87, 0x24, 0x88, 0x68, 0x65, 0x67, + 0xb8, 0x43, 0x5c, 0x0d, 0x88, 0x22, 0x65, 0xb1, 0x90, 0x17, 0x47, 0x2c, + 0x5c, 0xac, 0xe2, 0x10, 0x27, 0xc1, 0x90, 0xaf, 0xec, 0x29, 0xff, 0x7e, + 0x0a, 0xb3, 0xe6, 0x67, 0x53, 0xd6, 0xc9, 0xa1, 0xa9, 0x49, 0x6a, 0x0a, + 0x29, 0x88, 0xb1, 0xeb, 0x59, 0x4f, 0x59, 0x2e, 0x7a, 0xb7, 0xc7, 0x36, + 0xfe, 0xdc, 0x9a, 0xe4, 0xbd, 0xe6, 0x77, 0x8b, 0x8e, 0x32, 0xfe, 0x73, + 0x55, 0xb9, 0x0a, 0x59, 0x02, 0x90, 0xbf, 0x7c, 0xfe, 0x29, 0x3f, 0x6a, + 0xd7, 0xe6, 0x17, 0x8a, 0x58, 0xb2, 0x5c, 0xff, 0x1f, 0xed, 0x05, 0xdf, + 0xeb, 0x82, 0x24, 0xfd, 0x9c, 0xac, 0xb8, 0xaf, 0xd0, 0x17, 0x17, 0xb2, + 0xd0, 0x6b, 0x1c, 0x24, 0xbd, 0xdf, 0x38, 0x9c, 0x0e, 0xc8, 0xf6, 0x8f, + 0x2c, 0x65, 0xa4, 0x9a, 0x4d, 0xa9, 0x21, 0x01, 0x93, 0x0a, 0x46, 0xf4, + 0x4d, 0x8c, 0x1e, 0xe2, 0xe6, 0x5d, 0x25, 0xc4, 0xa8, 0xe8, 0xd8, 0x31, + 0x41, 0x58, 0xe8, 0x9b, 0x56, 0xf8, 0x81, 0xc3, 0x8e, 0x7b, 0xd9, 0x4d, + 0xee, 0xe3, 0x6f, 0xb0, 0x6a, 0x5e, 0x07, 0x04, 0x16, 0x85, 0x2e, 0x3d, + 0xc6, 0xd8, 0xc2, 0xaa, 0x62, 0xf7, 0x46, 0x74, 0x72, 0x93, 0x6a, 0x36, + 0xc9, 0xc6, 0x08, 0x70, 0x88, 0xb6, 0x46, 0x59, 0xa9, 0xfb, 0xa4, 0x89, + 0x76, 0xf2, 0xc0, 0xbc, 0xa5, 0x62, 0xe0, 0x93, 0x18, 0x9f, 0x84, 0xe2, + 0x74, 0xac, 0x1c, 0x96, 0x3d, 0x51, 0x55, 0xb1, 0x0a, 0x2c, 0xed, 0x11, + 0xed, 0x02, 0x6d, 0xee, 0x34, 0x83, 0x22, 0x7a, 0x7a, 0xad, 0xcc, 0xb2, + 0x0d, 0xc7, 0x91, 0x63, 0xd1, 0xfc, 0xca, 0x9f, 0xb5, 0x10, 0x82, 0x74, + 0x23, 0x20, 0xe8, 0x9c, 0x2c, 0xe0, 0xe3, 0xc2, 0x2b, 0x20, 0x64, 0x50, + 0x64, 0x4a, 0x85, 0xc6, 0x1d, 0x33, 0x8c, 0x2d, 0x2e, 0x5d, 0x6d, 0x49, + 0xaa, 0xa2, 0x66, 0xa9, 0xd9, 0x00, 0xe4, 0x27, 0x78, 0x90, 0x20, 0xfb, + 0x33, 0xc4, 0xe9, 0x7b, 0x54, 0x68, 0xc6, 0xb6, 0x36, 0x7f, 0x6d, 0xfa, + 0x43, 0x8b, 0x40, 0xb8, 0x17, 0x02, 0x66, 0xc1, 0x4b, 0xb8, 0x13, 0x7d, + 0x5d, 0xda, 0xd7, 0x85, 0x47, 0x26, 0x71, 0x9a, 0x38, 0x6a, 0xf8, 0xb3, + 0xe3, 0x0d, 0xad, 0x36, 0xbd, 0x70, 0xaa, 0xed, 0xa3, 0x69, 0x5c, 0x2d, + 0x7c, 0xe8, 0x87, 0x5a, 0xb6, 0xea, 0x8b, 0x7c, 0x8b, 0x9f, 0xa1, 0xeb, + 0xde, 0x81, 0xe7, 0x7f, 0xd0, 0x56, 0x16, 0x65, 0x26, 0x30, 0x15, 0x99, + 0x56, 0xad, 0xc7, 0x2c, 0xd5, 0xe6, 0x67, 0xfd, 0xdf, 0x4b, 0xe9, 0x55, + 0x56, 0x74, 0xc5, 0x3a, 0x1a, 0x4c, 0x94, 0x2a, 0x2e, 0xec, 0x1b, 0x36, + 0x15, 0x16, 0x74, 0x39, 0x3f, 0x9d, 0x37, 0xcb, 0xaa, 0x47, 0xcf, 0xd0, + 0xa6, 0x1f, 0x79, 0xa9, 0xa7, 0x4b, 0x2b, 0x31, 0x1b, 0x8f, 0xf6, 0x80, + 0xef, 0x33, 0x2f, 0x94, 0xb7, 0xfe, 0x82, 0xdd, 0xc8, 0xb2, 0x21, 0xab, + 0x40, 0xfc, 0xea, 0x6a, 0x30, 0x7e, 0xe9, 0x1c, 0xf8, 0x7b, 0x5d, 0xa1, + 0x6e, 0x8b, 0x1f, 0xfa, 0x2f, 0xb4, 0x8b, 0x39, 0x28, 0xbd, 0x5a, 0x0c, + 0x80, 0x23, 0xb9, 0x7c, 0x5c, 0xc6, 0x78, 0xb2, 0x90, 0xb9, 0x67, 0x3f, + 0x76, 0x44, 0x36, 0x94, 0xcd, 0x83, 0x6d, 0x94, 0xe7, 0x3c, 0x78, 0xbd, + 0x57, 0x79, 0x54, 0xce, 0x73, 0x6b, 0x11, 0x9d, 0x43, 0x06, 0xbc, 0xb9, + 0xbc, 0xaa, 0x28, 0x72, 0x7c, 0x59, 0x78, 0xe5, 0x1c, 0x01, 0x17, 0x4a, + 0x55, 0x6a, 0x88, 0xc7, 0xbe, 0xbb, 0xcd, 0xf6, 0x92, 0x46, 0x2f, 0xe7, + 0x13, 0x90, 0x61, 0x52, 0x0f, 0xf3, 0x80, 0x4b, 0xd9, 0x46, 0x36, 0x80, + 0x4a, 0x54, 0xe2, 0x58, 0x32, 0x25, 0x67, 0xc8, 0xa1, 0x79, 0x16, 0x75, + 0x96, 0x62, 0x5e, 0x8e, 0xee, 0xd7, 0x76, 0x7d, 0x60, 0x46, 0x91, 0x02, + 0x61, 0xdc, 0xb6, 0x76, 0x74, 0x26, 0x8e, 0x15, 0x14, 0x18, 0x11, 0xf3, + 0x02, 0x5f, 0x48, 0x00, 0x26, 0x00, 0x76, 0x21, 0xf1, 0x9c, 0xf5, 0xd3, + 0x94, 0xb8, 0x23, 0x61, 0x45, 0x80, 0xb2, 0xe7, 0x61, 0xb9, 0x51, 0x14, + 0x7d, 0x54, 0xb4, 0x81, 0x3d, 0xce, 0x90, 0x7b, 0xd8, 0x31, 0xf7, 0x91, + 0x07, 0xb9, 0x9d, 0x5d, 0x9e, 0x8d, 0xf4, 0x93, 0x7c, 0xba, 0xdf, 0x00, + 0xbc, 0x92, 0x07, 0xe5, 0xfa, 0x44, 0x34, 0x42, 0x81, 0xc2, 0x5f, 0xad, + 0x9f, 0x15, 0x22, 0x47, 0xb4, 0xd7, 0xd3, 0x79, 0x86, 0x3d, 0x61, 0x64, + 0xe7, 0x23, 0xa7, 0x4f, 0x6f, 0x10, 0xb6, 0x71, 0xa7, 0x31, 0x88, 0xce, + 0x9d, 0x17, 0x31, 0x6b, 0x23, 0x5d, 0x1d, 0xea, 0x2f, 0x90, 0x61, 0x18, + 0x94, 0xca, 0x51, 0x08, 0xf1, 0x3c, 0xa7, 0x2b, 0x24, 0xb0, 0x71, 0xc6, + 0xe1, 0xf3, 0xc7, 0xca, 0x4a, 0x13, 0xa7, 0x86, 0x6c, 0x68, 0x49, 0xdc, + 0xa9, 0x13, 0x5a, 0x49, 0xad, 0x9f, 0xfa, 0x4f, 0x58, 0xd9, 0x8a, 0xd7, + 0x45, 0xed, 0xb1, 0x50, 0x3f, 0x88, 0xc2, 0x6c, 0x92, 0x65, 0xc6, 0xc3, + 0xa9, 0x9d, 0xd2, 0x5d, 0xf1, 0x6d, 0x50, 0x1e, 0x14, 0xac, 0xb9, 0x84, + 0x87, 0xf2, 0xa3, 0x64, 0xcf, 0x10, 0xa0, 0x7c, 0x89, 0xb6, 0x46, 0x85, + 0x9f, 0x06, 0x60, 0x1e, 0x1d, 0x62, 0x55, 0xe1, 0x11, 0xaf, 0x40, 0x56, + 0x3c, 0x08, 0x35, 0x39, 0x33, 0xd7, 0x07, 0x94, 0x2f, 0x9c, 0x7e, 0x4c, + 0xf0, 0xa7, 0x5c, 0x8e, 0x3f, 0x39, 0xf5, 0x74, 0x3f, 0xae, 0xf8, 0x90, + 0x4a, 0x4e, 0x94, 0xa2, 0x54, 0x29, 0x2c, 0x15, 0xd1, 0x9b, 0x81, 0x39, + 0xf1, 0xb8, 0x98, 0xbe, 0xd1, 0x9a, 0x69, 0xf9, 0xfe, 0x44, 0x62, 0xb6, + 0x6f, 0x65, 0xc1, 0x4f, 0xc3, 0xf2, 0xc7, 0xf5, 0x71, 0x12, 0xb6, 0x97, + 0x4d, 0xec, 0xaa, 0xa3, 0xc5, 0xa2, 0x56, 0xd4, 0x40, 0xb2, 0xcb, 0x1f, + 0xc1, 0x75, 0x11, 0xaa, 0xe6, 0x45, 0x30, 0x40, 0xa8, 0xcc, 0x29, 0xec, + 0x5a, 0x6b, 0xcd, 0x85, 0xff, 0x86, 0xb9, 0x3b, 0x41, 0xe4, 0xdd, 0xc8, + 0x32, 0x9c, 0xd7, 0x46, 0xf3, 0xdc, 0x48, 0x5a, 0xa5, 0x09, 0xc9, 0x2c, + 0x4d, 0x82, 0xf4, 0x8a, 0x3a, 0x30, 0x9a, 0x76, 0xf7, 0xf1, 0x0d, 0xa8, + 0x09, 0xf4, 0x88, 0xed, 0x20, 0x4e, 0x9a, 0x63, 0x32, 0x16, 0x40, 0x36, + 0x12, 0x6d, 0xe3, 0x69, 0x82, 0x48, 0xd5, 0x2c, 0x8b, 0x89, 0x05, 0x75, + 0xb7, 0x05, 0xc1, 0x51, 0x5f, 0x7c, 0x86, 0x4a, 0x69, 0x0e, 0xcc, 0x0d, + 0x0a, 0x71, 0xf8, 0x58, 0x5f, 0xcf, 0x07, 0x10, 0x7e, 0x0c, 0x21, 0x35, + 0x81, 0x74, 0xbd, 0xa4, 0x02, 0x58, 0xf0, 0x3f, 0x71, 0xbe, 0x73, 0x4e, + 0xbb, 0xb3, 0x68, 0x48, 0xb4, 0x5e, 0x7f, 0xca, 0xce, 0x41, 0xc6, 0x4b, + 0xef, 0xfd, 0x36, 0xfa, 0x88, 0x41, 0x52, 0xce, 0x2d, 0x2a, 0xb1, 0x5c, + 0x22, 0x29, 0x36, 0x89, 0x64, 0x95, 0xe4, 0x5b, 0xe5, 0xba, 0x13, 0xec, + 0xbb, 0xaa, 0x49, 0x1c, 0x44, 0x74, 0xef, 0xeb, 0x65, 0x44, 0x36, 0xce, + 0x04, 0x27, 0x11, 0xd3, 0xeb, 0x5a, 0x97, 0x1a, 0xfa, 0x90, 0x17, 0xa6, + 0x22, 0x5a, 0x4e, 0xfe, 0xc6, 0xeb, 0x86, 0x12, 0x65, 0xee, 0x19, 0x58, + 0x2e, 0x88, 0xe2, 0x3b, 0xee, 0x43, 0x49, 0x6f, 0xc0, 0x19, 0xb2, 0x4d, + 0x61, 0x1b, 0x82, 0x16, 0xbd, 0x3f, 0x4b, 0x36, 0x22, 0x24, 0x92, 0xe3, + 0x2a, 0x9b, 0xcc, 0xd3, 0x13, 0xd5, 0x4a, 0xe4, 0x27, 0x23, 0x16, 0x56, + 0x22, 0x3d, 0x76, 0xdd, 0xc2, 0xf0, 0x1f, 0x59, 0xcb, 0x7f, 0x6b, 0xf4, + 0x09, 0x59, 0x09, 0x08, 0x30, 0x02, 0x27, 0x86, 0x54, 0x59, 0x67, 0x12, + 0x22, 0x22, 0x82, 0x57, 0x92, 0xe7, 0x17, 0x17, 0x9c, 0x07, 0x30, 0x42, + 0xeb, 0xf2, 0xbb, 0x44, 0x2b, 0xa9, 0x78, 0x43, 0xac, 0x8a, 0xfe, 0x4f, + 0xd7, 0xbf, 0xbf, 0x9c, 0x9e, 0x6a, 0xc3, 0x29, 0x6a, 0xdc, 0x0f, 0x76, + 0x8e, 0x17, 0x9b, 0x2c, 0xc2, 0x32, 0x14, 0x0a, 0xe6, 0x20, 0x88, 0x2c, + 0xce, 0x7a, 0x60, 0xa4, 0xd0, 0x5f, 0x48, 0xba, 0x99, 0xe5, 0x32, 0x1c, + 0x59, 0xbb, 0x7a, 0x9d, 0xb4, 0x2b, 0xa1, 0xc2, 0xdd, 0x4f, 0x4d, 0x80, + 0x1a, 0xe9, 0x7f, 0x71, 0x81, 0x27, 0x7e, 0x2a, 0x15, 0xc7, 0xf5, 0x63, + 0x78, 0x8e, 0x9f, 0x5f, 0x2c, 0xf2, 0x86, 0xae, 0x9f, 0x2b, 0x6d, 0xb4, + 0x51, 0x1c, 0x9d, 0x1c, 0xf1, 0x51, 0xc3, 0xb4, 0x0b, 0x63, 0x45, 0x80, + 0x2e, 0xa8, 0xce, 0x86, 0x35, 0x3c, 0x38, 0xd5, 0x10, 0x76, 0x93, 0x89, + 0xea, 0xe7, 0x82, 0xf7, 0xa2, 0x75, 0x02, 0x01, 0x3a, 0x77, 0x65, 0x28, + 0x83, 0x1e, 0xfa, 0xa0, 0xf5, 0xc0, 0x1a, 0x98, 0x98, 0x82, 0x33, 0xf4, + 0xf9, 0x95, 0x05, 0x9e, 0x67, 0xa9, 0x8a, 0x1b, 0xb4, 0x3b, 0x7c, 0xc6, + 0xe3, 0xcf, 0xba, 0xb0, 0x2e, 0xbd, 0x3b, 0xd1, 0x6e, 0x6a, 0x9a, 0xc6, + 0x44, 0x93, 0x29, 0xf3, 0x0c, 0x51, 0x06, 0x6b, 0x6b, 0xe8, 0x15, 0xe8, + 0x40, 0x09, 0xc2, 0x22, 0x02, 0x12, 0x89, 0x67, 0xf0, 0x9a, 0xd1, 0x46, + 0x12, 0x2d, 0xe7, 0x67, 0x88, 0xb0, 0xa8, 0xc2, 0x8e, 0x4c, 0x4e, 0x8c, + 0x7b, 0xf9, 0x99, 0xe1, 0xe2, 0xd2, 0xe2, 0x33, 0x91, 0x2d, 0xd2, 0x2b, + 0x0e, 0x98, 0xb7, 0x99, 0xdd, 0x45, 0x2b, 0xfa, 0xe7, 0xde, 0x57, 0xc8, + 0x4e, 0xc2, 0x6e, 0x61, 0xed, 0x78, 0xa1, 0x7b, 0x45, 0xcc, 0x5b, 0x41, + 0x0d, 0x3e, 0x31, 0x2a, 0x58, 0x13, 0xf4, 0x2a, 0x24, 0x66, 0xfc, 0x2b, + 0x42, 0xfd, 0xa1, 0x15, 0x05, 0xfe, 0x47, 0x91, 0x90, 0x13, 0xe4, 0xed, + 0xd0, 0x61, 0x6b, 0x5e, 0x0c, 0xd5, 0x06, 0xd0, 0x94, 0x7e, 0xa0, 0xb1, + 0xcc, 0xf6, 0x7d, 0xe6, 0x05, 0x07, 0x4d, 0xbc, 0x35, 0xaa, 0x28, 0x0a, + 0x66, 0x9d, 0xac, 0x36, 0xd1, 0xd3, 0x5d, 0xb7, 0x12, 0xec, 0x0c, 0x29, + 0xcd, 0x9d, 0x1a, 0xaa, 0xc5, 0x2f, 0x4c, 0x68, 0x4a, 0x0b, 0x52, 0xf0, + 0x57, 0xea, 0x48, 0x3a, 0xc4, 0x12, 0x24, 0xb2, 0x99, 0xa7, 0x37, 0x33, + 0x56, 0x98, 0x36, 0x26, 0x61, 0x31, 0x48, 0x45, 0x80, 0xf4, 0xb0, 0xbb, + 0x72, 0x0f, 0x2c, 0xe6, 0x1a, 0x02, 0xdb, 0x7b, 0x24, 0x42, 0x5d, 0x2d, + 0x83, 0xa8, 0x4b, 0xa7, 0x1b, 0x79, 0xfa, 0x8d, 0x1b, 0xf2, 0x4d, 0xf6, + 0x99, 0xed, 0x6d, 0x92, 0x58, 0x2c, 0xfe, 0xa2, 0x47, 0x54, 0x25, 0x57, + 0xaa, 0x02, 0x54, 0x89, 0x8d, 0x9b, 0x4f, 0x41, 0x6c, 0x08, 0xe4, 0x8a, + 0x94, 0xb6, 0x96, 0xd1, 0xa2, 0xbc, 0x3c, 0x76, 0x1a, 0xb4, 0xdf, 0xea, + 0x35, 0xb6, 0x04, 0xc0, 0x8c, 0x09, 0x0b, 0x85, 0x25, 0x14, 0xc6, 0x61, + 0x92, 0xf2, 0xac, 0xe5, 0x03, 0x74, 0x4b, 0xbe, 0x8b, 0x2a, 0xba, 0x56, + 0x10, 0x57, 0x46, 0x47, 0x3f, 0xe8, 0x27, 0xb0, 0xd0, 0xe0, 0xa5, 0x71, + 0xfb, 0x76, 0xd6, 0x55, 0xbd, 0x89, 0xca, 0x35, 0xb1, 0x7d, 0x6b, 0xe9, + 0x1b, 0xb4, 0x66, 0xaa, 0x45, 0x20, 0x98, 0x7b, 0x57, 0x66, 0x8c, 0xb7, + 0x76, 0x46, 0x3b, 0x9a, 0x65, 0x7d, 0x59, 0xc1, 0x79, 0x0b, 0xf2, 0xc6, + 0x5f, 0x9b, 0x42, 0xd3, 0x95, 0x65, 0x1e, 0x05, 0xc1, 0x3e, 0xe1, 0x25, + 0x35, 0x02, 0xb6, 0x35, 0xc7, 0x01, 0x44, 0x75, 0x6c, 0x80, 0x56, 0xa3, + 0xff, 0xf8, 0x3d, 0x08, 0x1d, 0x2b, 0x11, 0x5b, 0x4e, 0xdf, 0x00, 0xe2, + 0x00, 0xe5, 0x00, 0xf4, 0x00, 0xf5, 0x00, 0xf2, 0x00, 0x0b, 0x00, 0x1f, + 0x00, 0xe6, 0xab, 0xaa, 0xb6, 0x12, 0x99, 0x7b, 0x11, 0xe1, 0x86, 0xbf, + 0xd9, 0x9e, 0xba, 0xfd, 0x4a, 0x87, 0x9b, 0x82, 0x4f, 0x03, 0x68, 0x4c, + 0x85, 0xab, 0xd3, 0x8b, 0x9e, 0x94, 0xef, 0xdf, 0x0f, 0xe1, 0x13, 0xa2, + 0x75, 0xc1, 0x9b, 0x30, 0x21, 0x63, 0x79, 0xe6, 0x9f, 0x0a, 0xc1, 0x89, + 0xdd, 0x0b, 0xa2, 0x46, 0xf7, 0xeb, 0x34, 0x2b, 0xb8, 0x1d, 0xb1, 0x07, + 0xd1, 0xac, 0xd9, 0x5a, 0x81, 0xd3, 0x14, 0xa4, 0x70, 0xd6, 0x93, 0x3b, + 0x9e, 0xd9, 0x4e, 0x0b, 0xf3, 0xd6, 0x2e, 0xf1, 0x96, 0xed, 0xa1, 0xe9, + 0xd9, 0xa5, 0x7b, 0x3f, 0x5e, 0x8b, 0x92, 0x56, 0xd0, 0x82, 0x7a, 0xa0, + 0x85, 0x53, 0xf1, 0x6f, 0xe4, 0xb0, 0x34, 0x6c, 0x78, 0xf2, 0xe9, 0xd7, + 0xff, 0xe4, 0xe4, 0x5c, 0xb4, 0x6a, 0xb9, 0x84, 0x11, 0xac, 0x0e, 0x83, + 0x79, 0x24, 0x28, 0xf8, 0xc1, 0xe0, 0xff, 0xe1, 0x0c, 0xeb, 0x0a, 0x09, + 0xa9, 0xeb, 0x84, 0x57, 0x46, 0xec, 0x1c, 0x6e, 0xe1, 0x80, 0x8d, 0x9a, + 0xd1, 0xb1, 0xdc, 0xe3, 0x45, 0x94, 0xdc, 0xbc, 0x69, 0x31, 0x47, 0xfb, + 0x4a, 0x3d, 0x0d, 0xb1, 0xa5, 0x30, 0x97, 0xe4, 0xf5, 0xf9, 0x66, 0x9e, + 0x5a, 0x98, 0xba, 0x67, 0x70, 0x28, 0x5e, 0xaf, 0x6b, 0x2e, 0x02, 0x78, + 0x30, 0xe1, 0x12, 0x72, 0x85, 0x55, 0x84, 0x79, 0xce, 0x51, 0x90, 0xaa, + 0x29, 0x83, 0x47, 0x56, 0x14, 0x64, 0x6e, 0x55, 0x0d, 0x16, 0x50, 0xfa, + 0xfb, 0x54, 0x75, 0x9c, 0x89, 0x84, 0x92, 0x99, 0xd6, 0x3f, 0xfb, 0xb8, + 0x8e, 0xd2, 0x83, 0x80, 0x1d, 0x7f, 0x70, 0x4d, 0x15, 0x0e, 0xcf, 0x5c, + 0x05, 0x07, 0xa1, 0x39, 0x6b, 0xb6, 0xa0, 0x5c, 0x8d, 0xe4, 0x13, 0xb3, + 0x5b, 0x17, 0x26, 0xa2, 0xd7, 0xd9, 0x64, 0xb1, 0x73, 0x80, 0x80, 0x78, + 0x42, 0x75, 0x5b, 0x0c, 0x5d, 0x63, 0xf6, 0xa4, 0xa9, 0x0f, 0xf9, 0x2d, + 0x36, 0x85, 0x6d, 0x2b, 0x23, 0x96, 0xda, 0xb1, 0x56, 0xc4, 0x33, 0xbd, + 0x53, 0xb5, 0x18, 0x6e, 0x72, 0x42, 0x17, 0xb1, 0x9c, 0x90, 0xc0, 0xbd, + 0x3b, 0x01, 0x3e, 0x2b, 0x91, 0x82, 0xc1, 0x71, 0xc6, 0xc8, 0x24, 0xcb, + 0x72, 0xa1, 0x75, 0x49, 0xbc, 0x13, 0xc2, 0xb3, 0xf6, 0x47, 0xe9, 0x4c, + 0xed, 0x62, 0x3e, 0x4c, 0xdd, 0x7b, 0x62, 0x05, 0xd1, 0x5f, 0xa5, 0xaa, + 0xb5, 0x31, 0xb3, 0x70, 0xd0, 0xab, 0x98, 0x23, 0x43, 0x49, 0x78, 0x19, + 0xaa, 0x1f, 0x06, 0xe2, 0xab, 0x07, 0x68, 0x76, 0xaf, 0xa9, 0x15, 0x80, + 0xa6, 0x90, 0x30, 0xf4, 0x88, 0x55, 0xb9, 0xaf, 0x91, 0x5f, 0x4b, 0x0c, + 0x2c, 0x9d, 0x8b, 0xfa, 0xf1, 0x23, 0x5e, 0x66, 0x46, 0x1c, 0xb1, 0x9b, + 0x27, 0xfb, 0x57, 0xc6, 0xaf, 0xf2, 0x1b, 0x25, 0x82, 0xe2, 0x12, 0x5a, + 0x78, 0x6a, 0xae, 0xa8, 0x8d, 0xa3, 0xd3, 0x2d, 0xe6, 0xcd, 0x03, 0x2d, + 0xc9, 0x79, 0x37, 0x4e, 0xa8, 0x6e, 0x29, 0x08, 0xdd, 0x97, 0xa0, 0x59, + 0x29, 0x11, 0xf3, 0x48, 0x7b, 0x4c, 0x2e, 0xe6, 0xaa, 0xb4, 0xfe, 0x3b, + 0x1e, 0x4a, 0x56, 0xde, 0x7e, 0xa7, 0x4a, 0x2a, 0x7b, 0x4a, 0x0e, 0xb4, + 0x6c, 0x89, 0x3f, 0xc0, 0xd4, 0x5e, 0xbf, 0x62, 0x80, 0x90, 0xb5, 0x55, + 0x81, 0xc6, 0x75, 0x45, 0x21, 0x70, 0x4d, 0x12, 0x7e, 0x4c, 0x28, 0x66, + 0xa7, 0x71, 0x31, 0x29, 0xc1, 0x8a, 0x5e, 0xbb, 0x5a, 0x20, 0xe0, 0x71, + 0x8c, 0x2b, 0x37, 0x13, 0x43, 0x68, 0x99, 0x9d, 0xc7, 0x71, 0x31, 0xe7, + 0x26, 0xdc, 0x9f, 0x4a, 0x58, 0x83, 0x14, 0x30, 0x15, 0xdc, 0x8b, 0xe3, + 0xd5, 0xf8, 0x76, 0xb5, 0x9f, 0x60, 0x28, 0x98, 0xac, 0x1f, 0x45, 0x6e, + 0x61, 0x63, 0xb3, 0x70, 0xea, 0xd6, 0x44, 0x9d, 0xa7, 0x21, 0x7c, 0x46, + 0x42, 0xd3, 0x99, 0x0e, 0xc4, 0xd2, 0x50, 0x00, 0xdb, 0x85, 0xb4, 0xc5, + 0xc6, 0xba, 0x34, 0xaa, 0xe8, 0x4f, 0xb0, 0x55, 0x7a, 0x04, 0x51, 0xa0, + 0xb0, 0x1c, 0xdc, 0x80, 0x17, 0xce, 0x06, 0xd8, 0xdc, 0x9a, 0x43, 0x37, + 0x96, 0x55, 0xc9, 0xfe, 0x12, 0x22, 0x2b, 0x04, 0x8f, 0x43, 0xd2, 0xc4, + 0xb4, 0x24, 0x3d, 0xe0, 0x7b, 0x61, 0x04, 0xdb, 0x70, 0xbe, 0x0c, 0x3e, + 0xcc, 0x59, 0x3d, 0xf9, 0xc6, 0x46, 0xd0, 0xe3, 0xe8, 0x25, 0x76, 0xb1, + 0x57, 0x61, 0x2f, 0xa4, 0x51, 0x92, 0x00, 0x40, 0x1a, 0x81, 0x4b, 0x2e, + 0xd7, 0x2d, 0x6e, 0x93, 0x24, 0xa7, 0xd3, 0x92, 0x13, 0x37, 0x1d, 0x46, + 0x1c, 0x34, 0x4b, 0x21, 0x57, 0x46, 0x59, 0x9f, 0x5e, 0xa3, 0x75, 0x27, + 0x4d, 0x16, 0xed, 0x40, 0x10, 0x9d, 0xb1, 0x9a, 0x2d, 0x8a, 0x4e, 0x94, + 0xfc, 0xfc, 0xcf, 0xf5, 0xe1, 0xb4, 0xf5, 0x43, 0xfb, 0x88, 0x3f, 0x79, + 0x1d, 0xf1, 0x08, 0x96, 0xdd, 0xf4, 0x47, 0x86, 0x68, 0xcf, 0x63, 0x71, + 0x7f, 0xa2, 0x20, 0x22, 0x72, 0x69, 0x72, 0x11, 0x06, 0xdd, 0xad, 0x7c, + 0xd4, 0xa1, 0x9b, 0xbc, 0x55, 0x34, 0xf3, 0xf1, 0x45, 0x50, 0x66, 0xb5, + 0x56, 0xda, 0x5d, 0xe7, 0xd0, 0x21, 0xcf, 0x57, 0x72, 0x74, 0x8f, 0x6b, + 0x7f, 0xc4, 0x62, 0x70, 0xf0, 0x26, 0x56, 0x73, 0xda, 0xb8, 0x70, 0x33, + 0xb7, 0xf4, 0xa6, 0xf6, 0x23, 0x26, 0x74, 0xb4, 0x0f, 0x65, 0xed, 0x0b, + 0x52, 0xe2, 0x6e, 0x43, 0xc8, 0xe4, 0xfc, 0x9a, 0x2d, 0xa4, 0x04, 0xbc, + 0xf5, 0x74, 0xbf, 0x04, 0x02, 0x03, 0x0c, 0x0d, 0x3c, 0x4b, 0x21, 0x1a, + 0xe3, 0x1b, 0x58, 0x44, 0x4b, 0xb9, 0xe0, 0x61, 0x83, 0xbd, 0x48, 0x65, + 0x0c, 0x05, 0xf5, 0x5f, 0x8f, 0xf8, 0x31, 0x52, 0xb4, 0x2a, 0x25, 0xee, + 0x42, 0xb9, 0x20, 0x24, 0x08, 0x51, 0xc4, 0xd9, 0x09, 0x26, 0x5c, 0xfa, + 0xd9, 0xa0, 0xa3, 0x7e, 0xbe, 0x39, 0x80, 0x9c, 0x3a, 0xa0, 0xd6, 0x60, + 0x40, 0x7a, 0x3a, 0x69, 0xc4, 0x20, 0xb4, 0x7e, 0x44, 0x30, 0x05, 0xd3, + 0x4f, 0x9d, 0x3d, 0x85, 0xde, 0x34, 0xa7, 0xa6, 0x18, 0x96, 0x40, 0xc7, + 0xdd, 0x7a, 0xe6, 0x23, 0xb3, 0xbd, 0x2e, 0xe1, 0xa3, 0x05, 0xcb, 0x9a, + 0x98, 0x82, 0x1a, 0x49, 0x63, 0xa4, 0x01, 0x65, 0x1c, 0xa6, 0x11, 0x07, + 0x1a, 0xb1, 0xf2, 0x1a, 0xe8, 0x4c, 0xcc, 0xb7, 0xa7, 0x31, 0x51, 0x3e, + 0xc0, 0x98, 0x44, 0x46, 0x70, 0x22, 0x13, 0xb6, 0x8c, 0xc5, 0x35, 0x48, + 0x3d, 0xcc, 0xc8, 0xa5, 0xf7, 0x9f, 0xfc, 0x47, 0x50, 0xa0, 0x14, 0x39, + 0x54, 0xb1, 0x51, 0x6f, 0x41, 0xd0, 0xea, 0x59, 0x39, 0x00, 0x7c, 0x36, + 0x19, 0x5c, 0x86, 0x44, 0xb5, 0xc4, 0x0c, 0x6d, 0xea, 0x58, 0x51, 0x02, + 0x16, 0x2a, 0x81, 0xef, 0x69, 0xc7, 0x25, 0x26, 0xa4, 0x14, 0x8f, 0x1e, + 0x2e, 0x02, 0xae, 0x6e, 0x62, 0x2d, 0x41, 0x84, 0x99, 0x29, 0x6b, 0xca, + 0xe4, 0x19, 0x93, 0xba, 0x54, 0xd5, 0xaf, 0x52, 0xc7, 0x6b, 0x91, 0xae, + 0xad, 0x13, 0x3c, 0xb3, 0x87, 0xcf, 0x2d, 0xdd, 0xa0, 0x07, 0xc3, 0x4c, + 0x12, 0x3f, 0x17, 0xb5, 0x30, 0xa0, 0xf2, 0x81, 0x79, 0xa9, 0x50, 0xf0, + 0x93, 0x3d, 0xb9, 0x6f, 0xa2, 0x81, 0xbb, 0x97, 0xe9, 0x2f, 0xe8, 0x41, + 0xae, 0xdb, 0x04, 0xb0, 0x34, 0xd0, 0xe7, 0x20, 0x50, 0x6d, 0x06, 0xe0, + 0x16, 0x77, 0x55, 0xde, 0x56, 0xe9, 0xc2, 0x42, 0x94, 0xa5, 0x31, 0x5b, + 0xd6, 0xf9, 0x6a, 0xb5, 0xfe, 0xb3, 0x52, 0xe0, 0xae, 0x42, 0xc4, 0xea, + 0x36, 0x27, 0xbd, 0xf6, 0x9a, 0x75, 0xfe, 0x0a, 0x42, 0x63, 0xa1, 0x40, + 0x5f, 0xf8, 0x43, 0xcd, 0xca, 0xb8, 0x97, 0xc8, 0x1e, 0x2f, 0x66, 0x6a, + 0xa3, 0xb1, 0x23, 0x93, 0x26, 0x27, 0x11, 0x8f, 0x95, 0xab, 0xbb, 0x12, + 0xf5, 0xe2, 0x2a, 0xa2, 0xfb, 0x41, 0x08, 0x1b, 0x58, 0x1a, 0x7a, 0x31, + 0xdf, 0xcb, 0xf3, 0x7f, 0x61, 0xab, 0xd0, 0xd7, 0x87, 0xdc, 0xb4, 0xdc, + 0x22, 0x2d, 0xbd, 0x2b, 0xc1, 0x77, 0x14, 0xee, 0xa0, 0x74, 0x00, 0xb1, + 0x05, 0x97, 0x41, 0xf5, 0x42, 0x9e, 0xc1, 0xd0, 0xb3, 0xfc, 0x95, 0x57, + 0x99, 0x0f, 0xc8, 0x6e, 0xad, 0x0c, 0x0e, 0x93, 0x5e, 0x21, 0x7b, 0xd4, + 0x5c, 0x31, 0x53, 0x42, 0x76, 0x28, 0x6c, 0x91, 0x53, 0x32, 0x9d, 0x34, + 0xf0, 0x5f, 0x38, 0xb5, 0x6d, 0x39, 0xd2, 0x32, 0xf9, 0x55, 0x38, 0x56, + 0x53, 0x66, 0xdc, 0x50, 0xb0, 0xd1, 0x1b, 0x9d, 0xd6, 0xb5, 0xc2, 0x00, + 0xb8, 0x45, 0x2e, 0x89, 0xfb, 0xf1, 0x69, 0x49, 0xfe, 0xa8, 0xc8, 0x18, + 0x7f, 0x5c, 0xb5, 0x31, 0x40, 0xb2, 0x60, 0x74, 0x44, 0xad, 0xaa, 0xd0, + 0x67, 0xd6, 0x93, 0x18, 0x85, 0x83, 0x61, 0x8f, 0xaa, 0xb9, 0xf5, 0xc1, + 0x7f, 0x9b, 0x81, 0x1b, 0x82, 0x80, 0xc5, 0xe0, 0x02, 0x8f, 0xa8, 0x53, + 0x62, 0xc1, 0x39, 0x1b, 0xe0, 0x16, 0xb6, 0x8e, 0x8d, 0xf6, 0xf5, 0xe8, + 0x60, 0xaa, 0x14, 0xb5, 0x0c, 0xe5, 0x7d, 0x89, 0xa9, 0xcc, 0xf8, 0x60, + 0xb0, 0xd6, 0xb0, 0x58, 0x4f, 0xf4, 0x53, 0x69, 0x4b, 0x71, 0x18, 0xc3, + 0xad, 0xb1, 0xd1, 0x59, 0xa7, 0x3d, 0x43, 0xce, 0x0e, 0x9f, 0x21, 0xf1, + 0x82, 0xc4, 0x05, 0x3b, 0x1d, 0xf5, 0x60, 0x8d, 0x35, 0x53, 0x3f, 0x65, + 0x23, 0xa0, 0x28, 0xe5, 0xa6, 0x2c, 0x97, 0x3c, 0x29, 0xeb, 0x0e, 0x59, + 0x30, 0xc9, 0x67, 0xbd, 0xfc, 0x86, 0x5b, 0xab, 0x11, 0x50, 0xa7, 0x2f, + 0x03, 0xd3, 0x4d, 0x58, 0x31, 0xbe, 0x85, 0xad, 0x9f, 0x22, 0xe3, 0x91, + 0xa5, 0x04, 0xf6, 0x89, 0x05, 0x53, 0x7b, 0x9e, 0x51, 0x72, 0x98, 0x3a, + 0xaf, 0x54, 0x9c, 0x28, 0x64, 0xde, 0xea, 0xdc, 0x77, 0xb2, 0x11, 0x60, + 0x5b, 0xa6, 0x1b, 0xa4, 0x54, 0xcc, 0x6d, 0xb1, 0xa3, 0x8d, 0x03, 0x1d, + 0x56, 0x7b, 0x54, 0x3e, 0x06, 0x1c, 0x13, 0x1f, 0x58, 0x62, 0x2d, 0xf0, + 0x2d, 0x55, 0x03, 0xd9, 0x27, 0xa2, 0x33, 0x9d, 0x85, 0x25, 0x90, 0xb0, + 0x60, 0x4c, 0xc8, 0xd8, 0x63, 0xbd, 0x38, 0xd4, 0x04, 0x7b, 0x30, 0x80, + 0xf3, 0x43, 0x1e, 0x12, 0xac, 0x48, 0xc5, 0xab, 0x41, 0x24, 0x8c, 0x00, + 0x7a, 0xe8, 0xd0, 0x19, 0x88, 0xff, 0x89, 0xa6, 0x25, 0xd2, 0xef, 0x08, + 0x5c, 0x29, 0x6e, 0x06, 0x14, 0xce, 0xf4, 0x28, 0x79, 0xf4, 0x91, 0x70, + 0xf0, 0x85, 0xdf, 0x8b, 0xd9, 0xd3, 0x28, 0x9d, 0x50, 0xc1, 0x01, 0x36, + 0x01, 0xb4, 0xc7, 0xd0, 0xcd, 0xdf, 0x97, 0x75, 0x86, 0x74, 0x53, 0xfc, + 0x71, 0xe9, 0x12, 0x8d, 0x85, 0xf9, 0x59, 0xc9, 0x29, 0x61, 0xfc, 0x86, + 0x62, 0x4d, 0x8b, 0x46, 0x8d, 0x7d, 0xbe, 0x74, 0x88, 0x3f, 0x30, 0x96, + 0x20, 0xd5, 0x36, 0xa5, 0x55, 0x90, 0x74, 0xc1, 0x5b, 0xa0, 0xca, 0xe4, + 0x9b, 0x3a, 0x7c, 0xe7, 0x83, 0xf5, 0x91, 0x19, 0xbc, 0x62, 0xb1, 0x49, + 0x9e, 0x2d, 0x44, 0x20, 0x4f, 0x3d, 0x1c, 0x32, 0x8e, 0xda, 0x72, 0x4b, + 0x0c, 0xe5, 0x9f, 0x48, 0x7e, 0x2c, 0x8d, 0xa4, 0x9e, 0x95, 0xb3, 0x97, + 0x3d, 0xf7, 0x50, 0x68, 0x22, 0x6a, 0xc7, 0xec, 0x94, 0xaa, 0x51, 0xc5, + 0x90, 0xa4, 0x72, 0x48, 0x85, 0xf0, 0x48, 0xb6, 0x9b, 0x9e, 0x86, 0x27, + 0xc1, 0x8c, 0xf8, 0x7b, 0xed, 0x81, 0x2b, 0xb1, 0x82, 0x6c, 0x60, 0x6d, + 0xec, 0x29, 0xec, 0x37, 0x76, 0x0d, 0x8c, 0x74, 0x5b, 0x5f, 0x34, 0x3c, + 0x3e, 0x61, 0xc8, 0x88, 0x48, 0xee, 0x53, 0x55, 0x22, 0xa6, 0x29, 0x96, + 0x3b, 0xbb, 0xee, 0x78, 0xa2, 0xc1, 0xac, 0x08, 0xce, 0xf6, 0xa5, 0x71, + 0xba, 0x6b, 0xfb, 0x3a, 0x6e, 0x16, 0x46, 0xea, 0x35, 0x7e, 0x39, 0xff, + 0x0e, 0xd1, 0xb1, 0x2b, 0xa3, 0xe2, 0x54, 0xc6, 0xc5, 0xff, 0x68, 0xa2, + 0x29, 0x30, 0x81, 0x27, 0x6a, 0xb7, 0x30, 0x0d, 0x83, 0xe6, 0xe5, 0x26, + 0x99, 0x16, 0xa7, 0x4f, 0x46, 0xb5, 0xb5, 0xf4, 0x72, 0x2d, 0x8a, 0x22, + 0x4d, 0x6a, 0xc9, 0x94, 0x7e, 0x37, 0x54, 0x18, 0x0b, 0xb7, 0xb4, 0xd9, + 0x03, 0xe3, 0xf2, 0xdb, 0x69, 0x5f, 0x6a, 0xa6, 0x62, 0x08, 0x10, 0xcd, + 0x19, 0x84, 0xfd, 0x3a, 0x61, 0x44, 0x58, 0x48, 0xbf, 0xe4, 0x6e, 0xf0, + 0x95, 0xba, 0x7a, 0x29, 0x4b, 0xd6, 0x14, 0x6c, 0xa4, 0x4c, 0x36, 0xa7, + 0x8e, 0x1b, 0x8d, 0x30, 0x7e, 0x4e, 0xed, 0xf3, 0x11, 0x7d, 0x0a, 0x66, + 0x96, 0xde, 0xbc, 0x91, 0x12, 0xdb, 0x3a, 0x4d, 0x86, 0x71, 0xdc, 0x99, + 0x2d, 0xaf, 0x09, 0xe6, 0xeb, 0x5b, 0xb6, 0x4e, 0x39, 0xdb, 0x35, 0x6a, + 0x9e, 0xc8, 0xa6, 0xf0, 0x72, 0xb0, 0x47, 0x59, 0x01, 0x11, 0x50, 0x8c, + 0x8a, 0x87, 0x77, 0x22, 0x12, 0x1f, 0xdf, 0xd6, 0xa0, 0x57, 0x98, 0xa2, + 0x6b, 0xc6, 0x69, 0xe1, 0xe6, 0x34, 0x6a, 0x72, 0xf5, 0xab, 0xf2, 0x2d, + 0xab, 0xc2, 0x90, 0xfc, 0xb6, 0xe8, 0xd4, 0xc7, 0xab, 0x1e, 0x83, 0x76, + 0xf2, 0x51, 0x8b, 0x81, 0xd2, 0x47, 0x66, 0x9f, 0x66, 0x9f, 0x0c, 0x4c, + 0x1e, 0xfc, 0x2e, 0x12, 0x58, 0x88, 0x3e, 0x5c, 0xa8, 0x50, 0xc3, 0xff, + 0x31, 0x5e, 0x44, 0x48, 0x44, 0x62, 0xff, 0xf8, 0x3d, 0x08, 0x1e, 0x2b, + 0x11, 0xe6, 0x4c, 0x03, 0x00, 0xfe, 0x00, 0xff, 0x00, 0x05, 0x00, 0xfe, + 0x00, 0xfe, 0x00, 0x02, 0x00, 0xe7, 0x4c, 0x4d, 0xba, 0x48, 0x60, 0xbc, + 0x5c, 0x41, 0x9e, 0x72, 0x18, 0x24, 0x32, 0x01, 0xad, 0xe7, 0xd2, 0x78, + 0x6c, 0xa1, 0xad, 0xd0, 0x91, 0x32, 0xf2, 0x44, 0x64, 0xfd, 0x96, 0xfc, + 0x83, 0x99, 0x6a, 0x3c, 0x40, 0x31, 0x02, 0x44, 0xf7, 0x37, 0xe9, 0x2f, + 0x70, 0x55, 0x7e, 0xd2, 0x50, 0x11, 0x08, 0x60, 0x45, 0xfb, 0x48, 0xb4, + 0x4f, 0xcc, 0x5a, 0xe0, 0x50, 0x23, 0xf6, 0x14, 0x7a, 0x7a, 0x5c, 0xcf, + 0xb8, 0x88, 0xd3, 0xad, 0xba, 0xcb, 0xc3, 0xbc, 0x53, 0x52, 0xcd, 0x28, + 0xdf, 0x41, 0x3e, 0x7e, 0x81, 0x10, 0xc5, 0xc0, 0xda, 0xe4, 0xa1, 0x2b, + 0x73, 0x36, 0x0d, 0xb1, 0x23, 0x08, 0x2c, 0x46, 0x0e, 0x5c, 0x58, 0xb5, + 0xbc, 0x31, 0x02, 0x4b, 0xcc, 0x04, 0xfe, 0x82, 0x30, 0xb8, 0xa1, 0xcf, + 0xc3, 0x01, 0xaf, 0xf6, 0xc9, 0xe9, 0xa7, 0x7f, 0x53, 0xf0, 0xf1, 0x63, + 0x05, 0x95, 0x74, 0xb7, 0xa9, 0x12, 0x37, 0x04, 0x3c, 0x38, 0x3d, 0x5d, + 0xa9, 0xa4, 0x14, 0xc6, 0x43, 0x56, 0x72, 0x42, 0x27, 0xa9, 0xac, 0xc9, + 0x4e, 0x36, 0xfd, 0x10, 0x35, 0x57, 0x90, 0xab, 0xf2, 0xd4, 0x67, 0xc0, + 0x5c, 0x15, 0x96, 0x2a, 0x71, 0xab, 0xc9, 0xb0, 0x57, 0xc1, 0xb1, 0x0b, + 0x88, 0xa4, 0xa8, 0xbd, 0x3e, 0x53, 0x96, 0x01, 0xd7, 0x0d, 0x6b, 0xda, + 0x24, 0x95, 0xb3, 0x10, 0xdc, 0xc3, 0x36, 0x8f, 0x0a, 0xab, 0xf9, 0x13, + 0x5e, 0xcd, 0x04, 0xc9, 0x0b, 0xa9, 0xff, 0x05, 0xef, 0x25, 0x99, 0xaf, + 0x58, 0xdc, 0xcc, 0xd0, 0xc6, 0xd9, 0x90, 0x1b, 0xb0, 0x26, 0xcc, 0x70, + 0x32, 0xe0, 0xd8, 0x14, 0x38, 0x9a, 0x53, 0xd6, 0x02, 0xed, 0x94, 0x4a, + 0xf4, 0x49, 0x78, 0xa9, 0x19, 0x8b, 0x8b, 0x89, 0xa0, 0xf5, 0x91, 0x47, + 0x60, 0xdb, 0x45, 0xbb, 0x14, 0xf0, 0x69, 0x05, 0xf7, 0xb4, 0xf9, 0x86, + 0xae, 0x04, 0xcf, 0x08, 0xdb, 0xd5, 0xe4, 0x76, 0xff, 0xf8, 0x50, 0x5d, + 0xd4, 0xc9, 0xa6, 0x38, 0x49, 0xbc, 0xc8, 0xce, 0x25, 0x65, 0xa7, 0x1d, + 0x0f, 0x06, 0xfa, 0xa5, 0xd4, 0x1f, 0x83, 0xec, 0x88, 0x9b, 0x22, 0x0b, + 0xa4, 0x6e, 0xcd, 0x33, 0xc2, 0x21, 0x19, 0x5b, 0x7c, 0xc0, 0x94, 0x88, + 0x10, 0x09, 0xd6, 0x1d, 0x6f, 0x91, 0x0f, 0x18, 0x22, 0x76, 0x17, 0x49, + 0x40, 0x8a, 0x71, 0x80, 0xb3, 0x50, 0xc9, 0x90, 0xc1, 0xe4, 0xc4, 0x41, + 0xcf, 0x63, 0x0a, 0x59, 0xd2, 0xd6, 0x0a, 0xfa, 0xb2, 0xa3, 0x32, 0xc6, + 0xd9, 0x14, 0xa0, 0xc1, 0x67, 0x85, 0x0c, 0x44, 0x22, 0x86, 0xdf, 0xc8, + 0x5c, 0x21, 0x16, 0xd3, 0xc7, 0x64, 0x99, 0xa9, 0x77, 0xc4, 0xe7, 0xaf, + 0xd6, 0xdc, 0x41, 0x2b, 0x9e, 0x08, 0x5c, 0xc6, 0x13, 0x1a, 0x6c, 0x81, + 0xa1, 0xb0, 0xc5, 0xa9, 0xef, 0x9e, 0x73, 0xd0, 0xbb, 0x0c, 0x29, 0xbd, + 0xe3, 0xf9, 0xba, 0xef, 0x27, 0xb5, 0x0c, 0x8f, 0x22, 0xa8, 0x58, 0xf5, + 0xe2, 0x25, 0x97, 0x0d, 0x14, 0xf7, 0x4b, 0xe0, 0x12, 0xe4, 0x40, 0x86, + 0xfa, 0x85, 0x46, 0x93, 0xec, 0xf1, 0x0c, 0x4a, 0x7c, 0x8b, 0xfc, 0x33, + 0xf9, 0x01, 0x0b, 0x34, 0xff, 0x0e, 0x78, 0x21, 0x09, 0x57, 0xc4, 0xa5, + 0x35, 0xd9, 0xcd, 0x87, 0x56, 0x5b, 0x7e, 0xa0, 0xe6, 0xd0, 0x74, 0x2a, + 0x34, 0xbc, 0x52, 0xed, 0x4b, 0x6f, 0x44, 0x65, 0x3a, 0x6e, 0x8f, 0x31, + 0x62, 0xe2, 0x51, 0x56, 0x2e, 0xa2, 0x75, 0x55, 0x3f, 0x14, 0x35, 0x8d, + 0xcc, 0x82, 0xcc, 0x0b, 0xf2, 0xd9, 0x30, 0xb5, 0x95, 0x83, 0x9f, 0xb0, + 0x7c, 0x96, 0xa1, 0x64, 0xc3, 0x87, 0x02, 0x9a, 0x11, 0x4c, 0xc3, 0xf9, + 0x22, 0xc3, 0x49, 0x89, 0xe0, 0x6c, 0x66, 0x8f, 0x7c, 0xc8, 0x36, 0x9a, + 0x6c, 0x2f, 0xe7, 0xab, 0xf1, 0x5c, 0x73, 0xc6, 0x40, 0x25, 0x97, 0x6d, + 0x93, 0xe6, 0xb8, 0x55, 0xe6, 0xa0, 0xfc, 0x87, 0x22, 0x5c, 0xdb, 0x86, + 0xdb, 0x3e, 0x65, 0xbf, 0x04, 0x3e, 0x8c, 0x0a, 0x1b, 0xe9, 0xfa, 0xb3, + 0xd3, 0x69, 0x16, 0x2b, 0xf6, 0x6d, 0x42, 0x54, 0x5b, 0x3b, 0x2e, 0x51, + 0x74, 0xbe, 0x95, 0xc5, 0x3e, 0xc9, 0x43, 0x7f, 0x14, 0x28, 0xc5, 0xee, + 0x72, 0x81, 0xf5, 0x2f, 0x84, 0xae, 0x0c, 0xa6, 0xa7, 0xff, 0x98, 0xde, + 0xb9, 0x9c, 0x9f, 0x62, 0x95, 0x6b, 0xe4, 0x7d, 0x7d, 0x95, 0xfc, 0xb0, + 0x89, 0x19, 0x67, 0x3a, 0xb5, 0x69, 0x9f, 0x86, 0x23, 0x45, 0x63, 0x0d, + 0x27, 0xb6, 0x74, 0x2e, 0x8b, 0x1c, 0x94, 0x57, 0xab, 0xd3, 0x22, 0x19, + 0x56, 0x96, 0xb9, 0x79, 0x41, 0x73, 0x46, 0x5b, 0x89, 0xee, 0x4d, 0x29, + 0x4e, 0xa7, 0x62, 0x25, 0x92, 0x63, 0x3f, 0x98, 0xa3, 0x7e, 0x54, 0x8d, + 0xb7, 0x46, 0x70, 0x88, 0x7b, 0x50, 0x20, 0xdd, 0xd3, 0xcf, 0x30, 0x3b, + 0xd0, 0xb1, 0xd5, 0x11, 0x92, 0x4d, 0x57, 0x18, 0x8e, 0xa4, 0x88, 0x2d, + 0x4e, 0x53, 0x57, 0x00, 0xf2, 0xec, 0xa1, 0xd9, 0x44, 0x3e, 0x64, 0x5f, + 0x0e, 0x27, 0x3c, 0x38, 0xd4, 0x09, 0x23, 0x1d, 0x8a, 0x7b, 0x25, 0x0e, + 0xb9, 0x3c, 0x48, 0xff, 0x31, 0x7d, 0x4a, 0x3b, 0x91, 0x94, 0x9d, 0xf8, + 0xb8, 0x88, 0x3c, 0x4b, 0x44, 0x34, 0x39, 0x8a, 0x1d, 0xf8, 0x73, 0xca, + 0xc4, 0x28, 0x2e, 0x76, 0xb5, 0x25, 0xe5, 0xfc, 0x5c, 0x1f, 0x86, 0xd7, + 0x0d, 0xd4, 0x1e, 0xec, 0x23, 0x80, 0x96, 0xb5, 0xe5, 0x53, 0xdc, 0xdc, + 0x7e, 0x06, 0x4c, 0xb7, 0xb7, 0xa4, 0x90, 0x85, 0x91, 0x20, 0x8c, 0xc1, + 0x43, 0xa1, 0x1d, 0x47, 0xca, 0x71, 0xd2, 0x10, 0x9a, 0x14, 0x4c, 0xe4, + 0xc2, 0x47, 0xcc, 0x99, 0x3e, 0xf8, 0x56, 0xd4, 0xa6, 0x35, 0xba, 0xee, + 0x95, 0x1a, 0xd5, 0x65, 0x44, 0x09, 0x1c, 0x50, 0x8e, 0x03, 0x22, 0xbe, + 0x71, 0x06, 0xae, 0xb9, 0x56, 0x2a, 0xfe, 0xbf, 0x50, 0x1d, 0xcf, 0x1e, + 0x70, 0xc7, 0xfc, 0xed, 0x51, 0x7f, 0x4a, 0x34, 0x7f, 0x1a, 0x9e, 0x36, + 0xa5, 0x87, 0x3b, 0x2a, 0x4c, 0xdf, 0xf4, 0x1d, 0x82, 0x1b, 0xb7, 0x44, + 0x5e, 0x84, 0x0e, 0x29, 0x59, 0x44, 0x53, 0x4f, 0xd5, 0xcc, 0xaf, 0xb8, + 0x4d, 0x53, 0x68, 0x7a, 0x82, 0x8c, 0x35, 0x54, 0xd6, 0x65, 0x25, 0xb7, + 0xb3, 0x54, 0x45, 0x53, 0x13, 0x1a, 0xbe, 0xc8, 0x25, 0x5a, 0x8c, 0x9d, + 0x92, 0xb8, 0xc3, 0x3b, 0xc6, 0x25, 0x4a, 0xa1, 0x43, 0x45, 0x3a, 0x96, + 0x7d, 0x52, 0xa2, 0xe3, 0x13, 0x41, 0x42, 0xb6, 0x09, 0x2a, 0xb8, 0x56, + 0x99, 0xa2, 0x77, 0x16, 0xa0, 0x91, 0x45, 0x7f, 0x89, 0x22, 0x73, 0x8b, + 0x7b, 0xbc, 0x8a, 0xbb, 0x63, 0xe1, 0x19, 0xa2, 0x68, 0x68, 0x30, 0x03, + 0x78, 0x1c, 0x98, 0x23, 0x3b, 0x88, 0xc3, 0x49, 0xf7, 0xf7, 0x33, 0x0e, + 0x71, 0xd4, 0xbd, 0x53, 0x07, 0x3c, 0x77, 0x40, 0xcb, 0x6c, 0x9f, 0xa9, + 0x5f, 0x78, 0x51, 0x15, 0xa6, 0x0d, 0x20, 0x6c, 0x6a, 0x9c, 0x21, 0x99, + 0x7c, 0x49, 0xe2, 0xf8, 0x4a, 0x5c, 0x36, 0x83, 0xca, 0x57, 0xf8, 0x89, + 0x34, 0x7d, 0x1a, 0x65, 0x2a, 0x91, 0x45, 0xe7, 0x31, 0xdb, 0x10, 0x61, + 0x60, 0xe6, 0x1c, 0xd7, 0x02, 0x2a, 0xa1, 0x4c, 0x88, 0x6e, 0x4b, 0xb3, + 0xd3, 0xef, 0xd4, 0xa2, 0x86, 0xc8, 0x76, 0x37, 0xbc, 0x13, 0xfc, 0x97, + 0xa3, 0x36, 0xfb, 0x4a, 0xa6, 0x14, 0xe1, 0x90, 0x88, 0xaf, 0x41, 0x0d, + 0x28, 0xba, 0x3c, 0x46, 0xfe, 0x5f, 0xa6, 0x2a, 0x85, 0x4c, 0x43, 0xe2, + 0x51, 0xff, 0xc6, 0x6c, 0x8a, 0xd0, 0x1f, 0xfc, 0x49, 0x45, 0x38, 0x84, + 0x2a, 0xc9, 0xd0, 0x4b, 0xb1, 0x6c, 0xbd, 0xb2, 0x12, 0xb1, 0x9f, 0x72, + 0xa6, 0xda, 0xbd, 0x1b, 0xf1, 0x78, 0x44, 0xb4, 0xf4, 0x46, 0xf6, 0xf0, + 0xaa, 0x77, 0x43, 0x5c, 0x45, 0x55, 0xdf, 0xe4, 0x6a, 0xda, 0xf6, 0x12, + 0xed, 0x68, 0xfc, 0x5b, 0xd2, 0x1c, 0x78, 0xce, 0xa1, 0x66, 0x20, 0x03, + 0x5a, 0x2a, 0x3d, 0xa8, 0xdd, 0x90, 0x56, 0xc5, 0xf0, 0x90, 0xb8, 0x55, + 0x72, 0x8f, 0xca, 0xdc, 0xe6, 0x4a, 0x62, 0x38, 0x24, 0xf6, 0xf2, 0x7d, + 0x02, 0x32, 0x91, 0xd3, 0x57, 0x4b, 0x6c, 0xc8, 0x33, 0xb2, 0x99, 0x74, + 0x37, 0x08, 0x8b, 0x11, 0xd0, 0x95, 0xb8, 0x60, 0x6a, 0xab, 0x84, 0xc7, + 0xa6, 0x47, 0xe8, 0x77, 0x12, 0x04, 0x92, 0x73, 0x62, 0x48, 0xcf, 0x84, + 0x82, 0xf4, 0x1b, 0x70, 0x8c, 0xaa, 0xe7, 0x66, 0x27, 0x51, 0xe7, 0x94, + 0x2a, 0x62, 0x64, 0xdd, 0x81, 0x30, 0x0b, 0xc4, 0x2a, 0xff, 0x0c, 0xd9, + 0xdb, 0x4e, 0x48, 0x8a, 0x9b, 0x25, 0xc1, 0x5d, 0x52, 0xa1, 0x94, 0x8b, + 0xf0, 0x5c, 0x1f, 0x6d, 0xfe, 0xee, 0x88, 0xb8, 0xa4, 0x4a, 0xe6, 0x57, + 0x41, 0xeb, 0x95, 0xc0, 0x49, 0xda, 0x14, 0x6f, 0xa5, 0xac, 0xf3, 0x61, + 0xbd, 0x10, 0x15, 0x82, 0x9c, 0x96, 0xea, 0x0c, 0x31, 0xdf, 0xcd, 0xaf, + 0xbb, 0xb2, 0xb1, 0x5e, 0x4a, 0xd4, 0x8d, 0x60, 0x3e, 0xbc, 0xa4, 0xdf, + 0xad, 0xd7, 0x3c, 0xeb, 0x14, 0xec, 0xab, 0xcb, 0xaf, 0x44, 0x4a, 0xd4, + 0x6b, 0xd4, 0xc2, 0xee, 0x96, 0x71, 0x85, 0x10, 0x3e, 0xb3, 0x25, 0x34, + 0x34, 0x4e, 0xbb, 0x9a, 0x42, 0xfe, 0xc5, 0x99, 0xb3, 0x5b, 0xee, 0x1b, + 0xcb, 0xb6, 0x5b, 0x8c, 0x13, 0x10, 0x84, 0xca, 0x96, 0xc0, 0x80, 0x0d, + 0x91, 0x4c, 0x60, 0x8c, 0x6e, 0x3e, 0x1d, 0x23, 0xdd, 0xee, 0x88, 0x21, + 0x54, 0xab, 0xbf, 0x4d, 0xbc, 0x4c, 0x2b, 0x78, 0xb5, 0x16, 0xff, 0x91, + 0x44, 0x43, 0x39, 0x3a, 0xb0, 0x5c, 0x0f, 0xc3, 0xd0, 0x91, 0x91, 0x02, + 0xf4, 0x59, 0x6e, 0xfb, 0xc6, 0xdc, 0x95, 0x61, 0x00, 0xef, 0xcc, 0xe9, + 0x36, 0x27, 0x04, 0x13, 0x0c, 0xce, 0xe3, 0x59, 0xc4, 0xa1, 0x32, 0x4c, + 0x8d, 0x47, 0x68, 0xfe, 0x93, 0x7d, 0x7e, 0x32, 0x33, 0xd1, 0x0e, 0x6e, + 0x91, 0xcd, 0x1c, 0xe6, 0x5c, 0x53, 0xcc, 0x7b, 0x57, 0x97, 0xdb, 0x09, + 0x50, 0xe9, 0x07, 0x4c, 0x40, 0xdd, 0xa4, 0xa5, 0x17, 0x2b, 0x87, 0x31, + 0x45, 0x4d, 0x1b, 0xae, 0xd9, 0x18, 0xa0, 0x59, 0x82, 0x3a, 0x80, 0x0c, + 0xd5, 0x93, 0x6d, 0x82, 0xc6, 0x80, 0x2c, 0xf2, 0x3e, 0x5e, 0x45, 0x5c, + 0xc2, 0xd4, 0xf2, 0x3a, 0x59, 0x64, 0xa7, 0xc2, 0xae, 0xc5, 0x72, 0x22, + 0x26, 0x8a, 0xc6, 0x65, 0x23, 0x23, 0x09, 0x7d, 0x7d, 0xca, 0x71, 0x15, + 0xd3, 0x8c, 0xd4, 0x51, 0xf6, 0xe3, 0xcf, 0xa2, 0xd2, 0x4d, 0x51, 0xb1, + 0x07, 0x06, 0xd6, 0x07, 0x4c, 0x83, 0x93, 0x49, 0xb6, 0xb1, 0x33, 0x3f, + 0xb5, 0xbb, 0xaa, 0x51, 0xea, 0xd7, 0x7d, 0xcf, 0x94, 0x49, 0xa5, 0xb8, + 0xf0, 0xfa, 0xa5, 0x76, 0x58, 0x66, 0x93, 0x12, 0xc4, 0x04, 0x1d, 0xff, + 0x16, 0xc3, 0x04, 0x76, 0xad, 0x37, 0x6f, 0x41, 0x31, 0x4a, 0xf5, 0xb9, + 0xdb, 0x9e, 0x2c, 0x62, 0xe9, 0x55, 0x39, 0xfb, 0x08, 0x05, 0x22, 0xcb, + 0xe9, 0x97, 0x4d, 0x27, 0xb8, 0x91, 0x33, 0x90, 0x63, 0xb3, 0x4a, 0x71, + 0xca, 0x15, 0x68, 0xde, 0x33, 0x6e, 0x4d, 0x84, 0x9d, 0xb3, 0x35, 0xe5, + 0x75, 0x53, 0x20, 0x93, 0x4f, 0x56, 0xcc, 0xe9, 0xa3, 0x74, 0xdf, 0x72, + 0xac, 0xc9, 0x15, 0xa2, 0x56, 0x2e, 0xd5, 0x72, 0x9e, 0xfc, 0x34, 0xf8, + 0x5e, 0x5a, 0x66, 0x01, 0xe6, 0x53, 0x11, 0x9d, 0x2d, 0x38, 0xe8, 0xe2, + 0xf3, 0xfa, 0x35, 0x56, 0xa5, 0x46, 0xbb, 0xa2, 0x12, 0x34, 0xa9, 0x91, + 0xd7, 0x47, 0xa8, 0x5e, 0x75, 0x55, 0x88, 0x25, 0x51, 0x5f, 0x18, 0xfc, + 0xac, 0x3a, 0x63, 0x46, 0x41, 0x19, 0xe4, 0x54, 0x95, 0x55, 0xc2, 0x30, + 0xfb, 0x99, 0x22, 0xce, 0x2d, 0x67, 0xb4, 0x94, 0x9e, 0x19, 0x7a, 0x8d, + 0xbe, 0x78, 0x64, 0x6c, 0x1b, 0x93, 0xc9, 0x30, 0x72, 0xbb, 0x95, 0x61, + 0x87, 0x3f, 0x95, 0xa3, 0x47, 0x70, 0x42, 0xd6, 0xf2, 0x76, 0x84, 0x13, + 0x03, 0x28, 0x56, 0x53, 0xe4, 0x6d, 0x12, 0xb0, 0xbd, 0xa5, 0x70, 0xed, + 0x9c, 0xe6, 0xc8, 0xb3, 0x3d, 0x84, 0x77, 0x68, 0x3b, 0x65, 0x91, 0xb4, + 0x2e, 0x2b, 0x41, 0x80, 0x9e, 0xcd, 0xaa, 0x4e, 0x3e, 0xd5, 0x51, 0xaa, + 0xfd, 0x76, 0xf2, 0xa5, 0xae, 0x8f, 0x05, 0x7b, 0x80, 0x59, 0xba, 0xff, + 0xf8, 0x3d, 0x08, 0x1f, 0x2b, 0x11, 0x8d, 0x46, 0x03, 0x00, 0xfd, 0x00, + 0x02, 0x00, 0x01, 0x00, 0xe7, 0xa0, 0x48, 0x09, 0x76, 0x81, 0x09, 0x20, + 0x28, 0xf2, 0x2d, 0x34, 0x41, 0x4c, 0x38, 0xd5, 0x41, 0x56, 0x99, 0x03, + 0x58, 0x41, 0x56, 0xf5, 0x7b, 0xa4, 0x3b, 0xca, 0xb7, 0x6a, 0x9a, 0x88, + 0x4a, 0x88, 0x50, 0xf4, 0x70, 0xa6, 0xbc, 0xb5, 0xb0, 0xbb, 0x5e, 0xa1, + 0x9c, 0xd1, 0x3b, 0xfd, 0x68, 0xd9, 0x54, 0x0b, 0xb4, 0xc4, 0xb4, 0xa0, + 0xc7, 0xe4, 0x46, 0x56, 0x71, 0x4e, 0x9e, 0x01, 0xab, 0x90, 0xda, 0xda, + 0xd4, 0xed, 0x98, 0xe3, 0x75, 0xdd, 0x73, 0x71, 0xc7, 0x7a, 0xe6, 0xc7, + 0x5d, 0x57, 0x83, 0x95, 0x47, 0xd2, 0x52, 0x51, 0x6e, 0xcb, 0x28, 0xad, + 0xfe, 0xe4, 0xc9, 0x93, 0x6d, 0x22, 0x22, 0x42, 0x0d, 0xa9, 0x7a, 0x2e, + 0x6d, 0x80, 0x4f, 0x1c, 0x64, 0x64, 0xe0, 0xfa, 0xf3, 0x1a, 0xd1, 0x45, + 0xb9, 0x48, 0x8a, 0x4e, 0x3c, 0x72, 0x9e, 0xcd, 0x66, 0xac, 0x10, 0xef, + 0x1e, 0xa4, 0xaf, 0xd9, 0x4e, 0x1c, 0x73, 0x23, 0x42, 0x3c, 0x24, 0xf6, + 0xc0, 0x13, 0x8f, 0xc1, 0x37, 0x6a, 0x1f, 0x29, 0x2d, 0xf6, 0x5c, 0x72, + 0x04, 0x42, 0x97, 0x36, 0xf9, 0x69, 0xc5, 0xe3, 0xd8, 0xba, 0x6c, 0x2d, + 0xbe, 0x5e, 0x2c, 0xc7, 0xfd, 0x88, 0x22, 0xd6, 0x32, 0x8e, 0xef, 0xc2, + 0x44, 0x10, 0xd6, 0x52, 0x4d, 0x08, 0x22, 0x44, 0x40, 0x2f, 0xf1, 0x16, + 0x00, 0x10, 0xf1, 0x0f, 0x35, 0x12, 0xf9, 0xf1, 0x2d, 0x20, 0xde, 0x72, + 0x6d, 0x29, 0x33, 0x99, 0xa4, 0x6d, 0x38, 0x7d, 0xba, 0xfe, 0xf9, 0x86, + 0x70, 0xbb, 0x48, 0x42, 0xdb, 0xe7, 0xe5, 0x91, 0x5f, 0xbc, 0x7d, 0x24, + 0x27, 0xb2, 0x06, 0x24, 0x83, 0x91, 0x28, 0xe8, 0x01, 0xd9, 0x95, 0x8f, + 0x56, 0x18, 0x90, 0x44, 0x17, 0x0b, 0xfc, 0x46, 0x78, 0x0b, 0xc2, 0x93, + 0xa4, 0x70, 0xfa, 0x3f, 0xff, 0x28, 0x21, 0x76, 0xc1, 0x1f, 0x39, 0x50, + 0x8d, 0x07, 0x76, 0x08, 0x2d, 0x64, 0x51, 0x49, 0x8b, 0xdb, 0x6c, 0xb5, + 0x85, 0xac, 0x94, 0x6e, 0xa2, 0x8e, 0x6f, 0xa6, 0x3a, 0xee, 0xb9, 0xb8, + 0xe3, 0xc5, 0x0a, 0x4d, 0x9e, 0x8b, 0x28, 0x82, 0x6c, 0x76, 0x5e, 0xba, + 0x2d, 0x57, 0x70, 0x4d, 0x8e, 0xcc, 0x52, 0x38, 0xf6, 0x72, 0x6c, 0x76, + 0x62, 0x9c, 0x70, 0xb3, 0x89, 0xc0, 0xa5, 0x41, 0x6b, 0xd0, 0x49, 0x97, + 0x92, 0x49, 0xa4, 0x5f, 0x7d, 0xab, 0x4c, 0x7a, 0x6b, 0x2d, 0x32, 0x4c, + 0x7b, 0x6d, 0x7a, 0x8f, 0x49, 0x24, 0x81, 0x5b, 0x61, 0x36, 0xdf, 0xb6, + 0x88, 0x8a, 0x3f, 0xff, 0xf8, 0xa4, 0x3f, 0x63, 0x29, 0x22, 0xb8, 0x44, + 0x17, 0x0b, 0xfc, 0x45, 0x80, 0x96, 0x1e, 0xe3, 0xd4, 0xb4, 0xd3, 0x3f, + 0xb2, 0x22, 0xfd, 0xdc, 0x91, 0xb4, 0xc1, 0xb8, 0x73, 0x80, 0x72, 0x2e, + 0x8d, 0x0a, 0x60, 0xcb, 0xff, 0x90, 0x84, 0x58, 0x86, 0xb2, 0x0c, 0x92, + 0xe1, 0x01, 0x32, 0x2b, 0x92, 0x05, 0x30, 0x8b, 0xfe, 0x84, 0x4c, 0xd5, + 0xf7, 0x4f, 0x68, 0xcd, 0x47, 0x20, 0xd8, 0x78, 0x18, 0xee, 0xe2, 0x26, + 0x77, 0x08, 0x8e, 0xcf, 0xfc, 0xcf, 0xbc, 0x88, 0x80, 0x23, 0xe4, 0x44, + 0x01, 0x1e, 0x12, 0x30, 0x42, 0x12, 0x1f, 0xff, 0xfc, 0x51, 0xfb, 0xb5, + 0xa4, 0xd9, 0x4f, 0x6f, 0xb6, 0x16, 0x94, 0x5b, 0xb2, 0xca, 0x2b, 0x62, + 0x09, 0x22, 0x63, 0xcc, 0x94, 0x7f, 0x58, 0xf3, 0x24, 0x81, 0x3d, 0xd8, + 0x3e, 0xe3, 0x22, 0x68, 0x60, 0x81, 0x7f, 0x58, 0xfc, 0x93, 0x08, 0x40, + 0x20, 0x2b, 0x73, 0x23, 0x0a, 0xf7, 0xfb, 0xb9, 0xec, 0x68, 0xfb, 0x8c, + 0x8e, 0x85, 0x80, 0x72, 0x3e, 0x47, 0xfd, 0x1e, 0x03, 0xfc, 0x84, 0xa6, + 0x7d, 0xee, 0xc6, 0x5b, 0x28, 0x89, 0x2d, 0xab, 0xe9, 0x96, 0x7a, 0xd8, + 0x02, 0x45, 0x01, 0x8f, 0xbf, 0xc9, 0x97, 0x99, 0x27, 0x67, 0xd3, 0x59, + 0xac, 0xbe, 0xce, 0xce, 0xc8, 0x6c, 0x85, 0x43, 0x1e, 0x53, 0x25, 0xd2, + 0xfb, 0x21, 0xb2, 0x15, 0x0c, 0x79, 0x4c, 0x97, 0x4e, 0xce, 0xcc, 0x56, + 0x4a, 0xcc, 0xa2, 0x8a, 0xeb, 0xee, 0x1b, 0xaa, 0xc9, 0x24, 0x85, 0x6f, + 0xf6, 0x93, 0x2d, 0x6c, 0xa6, 0x91, 0x7d, 0xf6, 0xe5, 0xa1, 0x6b, 0x19, + 0x47, 0x77, 0xe1, 0x22, 0x21, 0xa8, 0x94, 0x50, 0xc1, 0x44, 0x41, 0xee, + 0x40, 0x55, 0xef, 0xf2, 0x46, 0x64, 0x71, 0xac, 0x22, 0xc0, 0x3e, 0x1f, + 0x85, 0xf0, 0x41, 0x04, 0x10, 0x34, 0x08, 0x10, 0x20, 0x40, 0x80, 0x03, + 0xf9, 0x0a, 0xa4, 0x60, 0x85, 0xb4, 0x41, 0x2b, 0x3f, 0x0d, 0x06, 0x3e, + 0x00, 0xff, 0xc1, 0x82, 0x64, 0xa2, 0x2f, 0xf3, 0x22, 0xaf, 0x20, 0x2a, + 0xf2, 0x03, 0x1a, 0x12, 0xff, 0x0d, 0x8a, 0x60, 0xb2, 0x44, 0x01, 0x80, + 0x5b, 0x1d, 0xd9, 0xb9, 0xb9, 0xb8, 0x28, 0xca, 0x37, 0x83, 0xc0, 0xec, + 0x84, 0x4d, 0x23, 0x43, 0xd7, 0x06, 0x01, 0x6c, 0x44, 0xd2, 0x31, 0x0f, + 0x82, 0x1a, 0xb4, 0xfa, 0x6b, 0x35, 0x92, 0xb3, 0x28, 0x6e, 0x9a, 0x67, + 0xdd, 0x24, 0xa5, 0x10, 0x47, 0x69, 0xfa, 0x96, 0x4a, 0x3b, 0x5c, 0x92, + 0x94, 0x41, 0x1d, 0xa8, 0x29, 0x44, 0x12, 0x48, 0x20, 0x20, 0xbf, 0x97, + 0x0f, 0x6c, 0x7d, 0xef, 0x21, 0xa6, 0x5a, 0x29, 0xff, 0x85, 0xb4, 0x82, + 0x3d, 0x77, 0xfd, 0x24, 0x13, 0xdb, 0xed, 0x5a, 0x5c, 0x1d, 0x35, 0x02, + 0xeb, 0x66, 0x90, 0x1b, 0x3c, 0xf8, 0xb5, 0x11, 0x36, 0x69, 0x92, 0x63, + 0xda, 0x5a, 0xd2, 0xa4, 0xa1, 0xdb, 0x1d, 0xb8, 0xaa, 0xd0, 0xd3, 0x8e, + 0x35, 0x64, 0xac, 0xba, 0xee, 0x2e, 0xf2, 0x39, 0x4a, 0x3a, 0x8f, 0x3a, + 0x9d, 0x1b, 0x82, 0x93, 0x14, 0x38, 0xed, 0x61, 0x2b, 0x47, 0x65, 0x95, + 0x95, 0x95, 0x90, 0x33, 0x3b, 0x67, 0xac, 0xa6, 0x4a, 0x12, 0x49, 0x21, + 0xfe, 0x7e, 0xa5, 0x9d, 0x28, 0xed, 0x24, 0x87, 0x59, 0x08, 0xa4, 0x41, + 0x1d, 0xa8, 0x28, 0x8a, 0x2f, 0xbe, 0xd5, 0xa4, 0x45, 0x8d, 0x23, 0x03, + 0x7e, 0x40, 0x9d, 0x1f, 0xfc, 0x20, 0x08, 0xf0, 0x91, 0x82, 0xfb, 0x3f, + 0x49, 0x28, 0x8a, 0x2f, 0xbe, 0xd5, 0xa5, 0x16, 0x49, 0xbd, 0xa8, 0x93, + 0xd7, 0x1f, 0xb4, 0x9b, 0x28, 0x89, 0x2d, 0xb8, 0x27, 0xad, 0x04, 0xd2, + 0x30, 0x3e, 0x85, 0x2a, 0x84, 0x22, 0x94, 0x08, 0x10, 0x20, 0x44, 0x00, + 0x80, 0x5f, 0xe2, 0x2c, 0x02, 0x1e, 0xf7, 0x7f, 0x92, 0x37, 0x48, 0x91, + 0xe7, 0x87, 0xfc, 0x8f, 0xfa, 0x3e, 0x02, 0x01, 0xe0, 0x07, 0xf9, 0xfa, + 0x96, 0x4a, 0x12, 0x49, 0x28, 0x01, 0xff, 0x18, 0x22, 0x29, 0x00, 0x60, + 0x60, 0x57, 0xb5, 0xf4, 0xf6, 0xa2, 0xd0, 0xab, 0xbd, 0x73, 0x63, 0xae, + 0x6a, 0x26, 0xe4, 0x50, 0x4d, 0x20, 0x11, 0x7e, 0x60, 0x3e, 0x06, 0x4c, + 0x88, 0xde, 0xe0, 0x88, 0x96, 0x48, 0x3f, 0xef, 0x01, 0x01, 0x00, 0x10, + 0x02, 0x01, 0x26, 0x77, 0x77, 0x37, 0x23, 0xd9, 0x5c, 0x68, 0xd2, 0x34, + 0x3f, 0x1e, 0x40, 0x0b, 0xfb, 0x1e, 0xf2, 0x83, 0xef, 0xac, 0xa6, 0x4a, + 0x12, 0x49, 0x28, 0x08, 0x07, 0x80, 0x1f, 0xe8, 0x29, 0x43, 0xf5, 0xda, + 0x96, 0x4a, 0x3b, 0x5c, 0x92, 0x1d, 0x64, 0x22, 0x91, 0x04, 0x92, 0x80, + 0x80, 0x80, 0x0f, 0xfb, 0xc0, 0x0f, 0xf4, 0x14, 0xa1, 0xfa, 0xed, 0x4b, + 0x1d, 0x62, 0x51, 0x41, 0x20, 0x44, 0x19, 0x41, 0x04, 0x10, 0x41, 0x00, + 0x7f, 0xde, 0x02, 0x00, 0x20, 0x3f, 0xc7, 0x73, 0xf9, 0xb8, 0xec, 0x14, + 0x6c, 0x18, 0xc2, 0x79, 0x3e, 0x04, 0x08, 0x10, 0x20, 0x40, 0x0f, 0xf8, + 0x7f, 0xde, 0x02, 0x02, 0x02, 0x02, 0x02, 0x00, 0x20, 0x04, 0x01, 0xd8, + 0xc3, 0x62, 0xe2, 0xe2, 0xe2, 0xe2, 0xe2, 0xe2, 0xe2, 0xe3, 0x2e, 0x2e, + 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x3e, 0xe6, 0xe6, 0xe6, 0xe6, + 0xe6, 0xe0, 0xa3, 0x28, 0xc8, 0xf7, 0x47, 0xc0, 0x40, 0x40, 0x40, 0x40, + 0x0f, 0xf3, 0xf4, 0xe9, 0x72, 0x58, 0xa6, 0x24, 0x92, 0x50, 0x10, 0x10, + 0x10, 0x01, 0x01, 0x0c, 0x02, 0xd9, 0xec, 0xae, 0x57, 0x1a, 0x34, 0x8f, + 0xe1, 0xf0, 0x73, 0xb1, 0xd9, 0xb9, 0xb9, 0xb9, 0xb9, 0xb9, 0xb9, 0xb8, + 0xfb, 0x82, 0x8c, 0xa3, 0x23, 0xd1, 0xf0, 0x10, 0x10, 0x03, 0xfe, 0x17, + 0xd5, 0xa5, 0x16, 0x49, 0xbd, 0xbe, 0xdc, 0xb2, 0xd7, 0x6b, 0x72, 0x99, + 0x28, 0x49, 0x1d, 0xa7, 0xe9, 0xd2, 0xe9, 0xd9, 0xd9, 0x65, 0x95, 0x95, + 0x95, 0x95, 0x95, 0x95, 0x95, 0x95, 0x97, 0xd9, 0xd9, 0x14, 0xc5, 0x33, + 0xb4, 0x92, 0x94, 0x41, 0x24, 0x83, 0xfe, 0x1f, 0xf7, 0x80, 0x80, 0x80, + 0x1f, 0xe7, 0xe9, 0xd2, 0xe9, 0xd9, 0xd9, 0x7d, 0x9d, 0x9d, 0x9d, 0x91, + 0x4c, 0xd9, 0xeb, 0x6c, 0xba, 0x5c, 0x53, 0x14, 0xc4, 0x92, 0x4a, 0x02, + 0x02, 0x02, 0x00, 0x7f, 0xa8, 0x45, 0xa0, 0x44, 0x19, 0x41, 0x04, 0x10, + 0x40, 0xf0, 0x10, 0x10, 0x01, 0x00, 0x20, 0x12, 0x69, 0x17, 0x83, 0xc1, + 0xce, 0xc7, 0x66, 0xe6, 0xe6, 0xe6, 0xe6, 0xe6, 0xe6, 0xe3, 0x2e, 0x2e, + 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x2e, 0x3e, 0xe6, 0xe6, 0xe0, 0xa3, + 0x28, 0xc8, 0xf4, 0x7c, 0x04, 0x00, 0x7f, 0xde, 0x02, 0x00, 0x20, 0x04, + 0x02, 0x4d, 0x22, 0x47, 0xa3, 0xe0, 0x20, 0x80, 0x30, 0x19, 0x33, 0x22, + 0x63, 0x48, 0x24, 0x51, 0x00, 0x22, 0x10, 0x87, 0xbd, 0xc8, 0x0a, 0xbd, + 0xfe, 0xee, 0x22, 0x69, 0x1a, 0x1f, 0x18, 0xf2, 0x00, 0xc0, 0x2d, 0x88, + 0x9f, 0x72, 0xdd, 0xdc, 0xf6, 0x3e, 0xe6, 0xe0, 0xa3, 0x6e, 0x77, 0x37, + 0x1d, 0x82, 0x8c, 0xa3, 0x72, 0x3d, 0x1f, 0x01, 0x00, 0x3f, 0xcf, 0xd3, + 0xa4, 0x96, 0x6c, 0xb3, 0x58, 0xb2, 0x34, 0xac, 0xac, 0xac, 0xac, 0xac, + 0xac, 0xbe, 0xce, 0xce, 0xc8, 0xa6, 0x6c, 0xf5, 0x94, 0xc7, 0x58, 0x94, + 0x50, 0x48, 0x11, 0x06, 0x50, 0x41, 0x04, 0x10, 0x40, 0xf0, 0x03, 0xfd, + 0x05, 0x28, 0x7e, 0xbb, 0x4e, 0x97, 0x4e, 0xcb, 0x2c, 0xac, 0xac, 0xac, + 0xac, 0xac, 0xac, 0xac, 0xac, 0x80, 0x47, 0x8c, 0xff, 0xf8, 0x7d, 0x08, + 0x20, 0x02, 0x65, 0x2b, 0x11, 0x96, 0x44, 0xff, 0x00, 0xff, 0x00, 0xff, + 0x00, 0xe7, 0x21, 0x69, 0x19, 0xf2, 0x36, 0x24, 0x06, 0xbf, 0x7e, 0xfd, + 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0x01, + 0x80, 0x56, 0x02, 0x88, 0xe6, 0x0e, 0x82, 0xb3, 0x70, 0x04, 0x00, 0x92, + 0xca, 0xd7, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, 0x00, 0x02, 0x00, + 0x49, 0x02, 0xd0, 0x3a, 0xb2, 0x81, 0x50, 0x24, 0xb2, 0xb5, 0xc0, 0x81, + 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, 0x02, 0x04, 0x00, 0x08, 0x03, + 0xb1, 0x3b, 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc5, 0x8b, 0x16, 0x2c, 0x58, + 0xb1, 0x62, 0xc5, 0x8b, 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc4, 0x02, 0xe8, + 0xa6, 0xd7, 0x02, 0x00, 0x0f, 0xe3, 0x98, 0x3a, 0x06, 0x92, 0x39, 0x2e, + 0xfd, 0xfb, 0xe0, 0x30, 0x0a, 0xcd, 0xd0, 0x00, 0x7f, 0x09, 0x8d, 0x0d, + 0xd0, 0x20, 0x40, 0x81, 0x02, 0x04, 0x08, 0x00, 0x10, 0x07, 0x62, 0x76, + 0x2c, 0x58, 0xb1, 0x62, 0xc5, 0x8b, 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc5, + 0x8b, 0x10, 0x0b, 0xa1, 0xb0, 0x1d, 0x59, 0x5a, 0xe0, 0x40, 0x81, 0x02, + 0x04, 0x08, 0x00, 0x3f, 0x8e, 0x64, 0xbb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, + 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, + 0xbe, 0x03, 0x00, 0xac, 0xdd, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, + 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, 0x02, 0x04, 0x08, 0x10, 0x20, + 0x40, 0x81, 0x02, 0x00, 0x0f, 0xe1, 0x31, 0xa1, 0xba, 0x00, 0x0f, 0xe3, + 0x98, 0x3a, 0x06, 0x90, 0x78, 0x68, 0x6e, 0x81, 0x02, 0x04, 0x00, 0x08, + 0x01, 0x25, 0x95, 0xae, 0x04, 0x00, 0x08, 0x03, 0xb0, 0x38, 0x86, 0xc2, + 0x51, 0x3b, 0x16, 0x20, 0x17, 0x43, 0x61, 0x28, 0x9d, 0x8b, 0x16, 0x2c, + 0x58, 0xb1, 0x62, 0xc5, 0x8b, 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc5, 0x8b, + 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc5, 0x8b, 0x10, 0x0b, 0xa1, 0xb0, 0x1d, + 0x59, 0x40, 0xa8, 0x12, 0x59, 0x5a, 0xc0, 0x20, 0x04, 0x90, 0x2d, 0x12, + 0x89, 0xd8, 0x80, 0x5d, 0x14, 0xda, 0xe0, 0x40, 0x01, 0xfc, 0x26, 0x34, + 0x01, 0x44, 0x73, 0x25, 0x80, 0xc0, 0x2b, 0x37, 0x40, 0x81, 0x02, 0x04, + 0x08, 0x10, 0x20, 0x00, 0x40, 0x1d, 0x89, 0xd8, 0xb1, 0x62, 0xc4, 0x02, + 0xe8, 0x6c, 0x25, 0x13, 0xb1, 0x62, 0xc5, 0x8b, 0x16, 0x2c, 0x58, 0xb1, + 0x62, 0x01, 0x74, 0x53, 0x6b, 0x81, 0x02, 0x00, 0x0f, 0xe3, 0x98, 0x3a, + 0x06, 0x92, 0x39, 0x2e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, + 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, + 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, + 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, + 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xe0, 0x30, 0x0a, 0xcd, 0xd0, + 0x20, 0x40, 0x81, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, 0x02, 0x04, + 0x08, 0x10, 0x20, 0x00, 0x40, 0x1d, 0x89, 0xd8, 0xb1, 0x62, 0x01, 0x74, + 0x53, 0x6b, 0x81, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, 0x02, 0x04, + 0x08, 0x10, 0x00, 0x20, 0x0e, 0xc4, 0xec, 0x58, 0xb1, 0x62, 0xc5, 0x8b, + 0x16, 0x2c, 0x58, 0xb1, 0x62, 0xc5, 0x8b, 0x10, 0x0b, 0xa1, 0xb0, 0x94, + 0x0e, 0x22, 0x9b, 0x5c, 0x08, 0x00, 0x10, 0x07, 0x60, 0x71, 0x14, 0xda, + 0xc0, 0x7f, 0x1c, 0xc9, 0x60, 0x30, 0x0a, 0xc0, 0x51, 0x1c, 0xc9, 0x60, + 0x30, 0x06, 0x90, 0x78, 0x02, 0xb9, 0x1c, 0x1d, 0x05, 0x66, 0xe8, 0x10, + 0x20, 0x40, 0x81, 0x00, 0x02, 0x00, 0x49, 0x65, 0x6b, 0x81, 0x02, 0x04, + 0x08, 0x10, 0x20, 0x40, 0x81, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x81, + 0x00, 0x07, 0xf0, 0x98, 0x05, 0x72, 0x39, 0x2e, 0xfd, 0xfb, 0xf7, 0xef, + 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, + 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, + 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, + 0xbf, 0x7e, 0xfd, 0xfb, 0xf7, 0xef, 0xdf, 0xbf, 0x7e, 0xfd, 0xfb, 0xe0, + 0x30, 0x06, 0x90, 0x78, 0x68, 0x6e, 0x01, 0xfc, 0x26, 0x34, 0x37, 0x40, + 0x01, 0xfc, 0x26, 0x01, 0x5c, 0x1e, 0x1a, 0x1b, 0x80, 0x7f, 0x1c, 0xc9, + 0x77, 0xc0, 0x60, 0x0d, 0x20, 0xf0, 0x05, 0x70, 0x78, 0x68, 0x6e, 0x81, + 0x02, 0x04, 0x00, 0x1f, 0xc2, 0x63, 0x43, 0x74, 0x08, 0x00, 0x10, 0x02, + 0x48, 0x16, 0x89, 0x40, 0xe2, 0xa4, 0xb6 +}; +unsigned int sample_flac_len = 68443; diff --git a/src/AudioGeneratorFLAC.cpp b/src/AudioGeneratorFLAC.cpp new file mode 100644 index 0000000..c6c729b --- /dev/null +++ b/src/AudioGeneratorFLAC.cpp @@ -0,0 +1,183 @@ +/* + AudioGeneratorFLAC + Audio output generator that plays FLAC audio files + + Copyright (C) 2017 Earle F. Philhower, III + + 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 3 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, see . +*/ + +#include + +AudioGeneratorFLAC::AudioGeneratorFLAC() +{ + flac = NULL; + channels = 0; + sampleRate = 0; + bitsPerSample = 0; + buff[0] = NULL; + buff[1] = NULL; + buffPtr = 0; + buffLen = 0; +} + +AudioGeneratorFLAC::~AudioGeneratorFLAC() +{ + if (flac) + FLAC__stream_decoder_delete(flac); + flac = NULL; +} + +bool AudioGeneratorFLAC::begin(AudioFileSource *source, AudioOutput *output) +{ + if (!source) return false; + file = source; + if (!output) return false; + this->output = output; + if (!file->isOpen()) return false; // Error + + flac = FLAC__stream_decoder_new(); + if (!flac) return false; + + (void)FLAC__stream_decoder_set_md5_checking(flac, false); + + FLAC__StreamDecoderInitStatus ret = FLAC__stream_decoder_init_stream(flac, _read_cb, _seek_cb, _tell_cb, _length_cb, _eof_cb, _write_cb, _metadata_cb, _error_cb, reinterpret_cast(this) ); + if (ret != FLAC__STREAM_DECODER_INIT_STATUS_OK) { + FLAC__stream_decoder_delete(flac); + flac = NULL; + return false; + } + + output->begin(); + running = true; + return true; +} + +// TODO - convert 24bpp to 16bpp +bool AudioGeneratorFLAC::loop() +{ + FLAC__bool ret; + if (!running) return false; + + if (!output->ConsumeSample(lastSample)) return true; // Try and send last buffered sample + + do { + if (buffPtr == buffLen) { + ret = FLAC__stream_decoder_process_single(flac); + if (!ret) { + running = false; + return false; + } else { + // We might be done... + if (FLAC__stream_decoder_get_state(flac)==FLAC__STREAM_DECODER_END_OF_STREAM) { + running = false; + return false; + } + unsigned newsr = FLAC__stream_decoder_get_sample_rate(flac); + unsigned newch = FLAC__stream_decoder_get_channels(flac); + unsigned newbps = FLAC__stream_decoder_get_bits_per_sample(flac); + if (newsr != sampleRate) output->SetRate(sampleRate = newsr); + if (newch != channels) output->SetChannels(channels = newch); + if (newbps != bitsPerSample) output->SetBitsPerSample( bitsPerSample = newbps); + } + } + + // Check for some weird case where above didn't give any data + if (buffPtr == buffLen) { + return true; // At some point the flac better error and we'll retudn + } + + lastSample[AudioOutput::LEFTCHANNEL] = buff[0][buffPtr] & 0xffff; + if (channels==2) lastSample[AudioOutput::RIGHTCHANNEL] = buff[1][buffPtr] & 0xffff; + else lastSample[AudioOutput::RIGHTCHANNEL] = lastSample[AudioOutput::LEFTCHANNEL]; + buffPtr++; + } while (running && output->ConsumeSample(lastSample)); + + return running; +} + +bool AudioGeneratorFLAC::stop() +{ + if (flac) + FLAC__stream_decoder_delete(flac); + flac = NULL; + running = false; + + return true; +} + +bool AudioGeneratorFLAC::isRunning() +{ + return running; +} + + + +FLAC__StreamDecoderReadStatus AudioGeneratorFLAC::read_cb(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes) +{ + (void) decoder; + if (*bytes==0) return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + *bytes = file->read(buffer, sizeof(FLAC__byte) * (*bytes)); + if (*bytes==0) return FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM; + return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE; +} +FLAC__StreamDecoderSeekStatus AudioGeneratorFLAC::seek_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset) +{ + (void) decoder; + if (!file->seek((int32_t)absolute_byte_offset, 0)) return FLAC__STREAM_DECODER_SEEK_STATUS_ERROR; + return FLAC__STREAM_DECODER_SEEK_STATUS_OK; +} +FLAC__StreamDecoderTellStatus AudioGeneratorFLAC::tell_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset) +{ + (void) decoder; + *absolute_byte_offset = file->getPos(); + return FLAC__STREAM_DECODER_TELL_STATUS_OK; +} + +FLAC__StreamDecoderLengthStatus AudioGeneratorFLAC::length_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length) +{ + (void) decoder; + *stream_length = file->getSize(); + return FLAC__STREAM_DECODER_LENGTH_STATUS_OK; +} +FLAC__bool AudioGeneratorFLAC::eof_cb(const FLAC__StreamDecoder *decoder) +{ + (void) decoder; + if (file->getPos() >= file->getSize()) return true; + return false; +} +FLAC__StreamDecoderWriteStatus AudioGeneratorFLAC::write_cb(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 *const buffer[]) +{ + (void) decoder; + // Hackish warning here. FLAC sends the buffer but doesn't free it until the next call to decode_frame, so we stash + // the pointers here and use it in our loop() instead of memcpy()'ing into yet another buffer. + buffLen = frame->header.blocksize; + buff[0] = buffer[0]; + if (frame->header.channels>1) buff[1] = buffer[1]; + else buff[1] = buffer[0]; + buffPtr = 0; + return FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE; +} +void AudioGeneratorFLAC::metadata_cb(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata) +{ + (void) decoder; + (void) metadata; + Serial.printf("Metadata\n"); +} +void AudioGeneratorFLAC::error_cb(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status) +{ + (void) decoder; + Serial.printf("Error:%d\n", status); +} + diff --git a/src/AudioGeneratorFLAC.h b/src/AudioGeneratorFLAC.h new file mode 100644 index 0000000..020d87e --- /dev/null +++ b/src/AudioGeneratorFLAC.h @@ -0,0 +1,88 @@ +/* + AudioGeneratorFLAC + Audio output generator that plays FLAC audio files + + Copyright (C) 2017 Earle F. Philhower, III + + 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 3 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, see . +*/ + +#ifndef _AUDIOGENERATORFLAC_H +#define _AUDIOGENERATORFLAC_H + +#include +extern "C" { + #include "libflac/FLAC/stream_decoder.h" +}; + +class AudioGeneratorFLAC : AudioGenerator +{ + public: + AudioGeneratorFLAC(); + virtual ~AudioGeneratorFLAC() override; + virtual bool begin(AudioFileSource *source, AudioOutput *output) override; + virtual bool loop() override; + virtual bool stop() override; + virtual bool isRunning() override; + + protected: + // FLAC info + uint16_t channels; + uint32_t sampleRate; + uint16_t bitsPerSample; + + // We need to buffer some data in-RAM to avoid doing 1000s of small reads + const int *buff[2]; + uint16_t buffPtr; + uint16_t buffLen; + FLAC__StreamDecoder *flac; + + // FLAC callbacks, need static functions to bounce into c++ from c + static FLAC__StreamDecoderReadStatus _read_cb(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data) { + return static_cast(client_data)->read_cb(decoder, buffer, bytes); + }; + static FLAC__StreamDecoderSeekStatus _seek_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data) { + return static_cast(client_data)->seek_cb(decoder, absolute_byte_offset); + }; + static FLAC__StreamDecoderTellStatus _tell_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data) { + return static_cast(client_data)->tell_cb(decoder, absolute_byte_offset); + }; + static FLAC__StreamDecoderLengthStatus _length_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length, void *client_data) { + return static_cast(client_data)->length_cb(decoder, stream_length); + }; + static FLAC__bool _eof_cb(const FLAC__StreamDecoder *decoder, void *client_data) { + return static_cast(client_data)->eof_cb(decoder); + }; + static FLAC__StreamDecoderWriteStatus _write_cb(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 *const buffer[], void *client_data) { + return static_cast(client_data)->write_cb(decoder, frame, buffer); + }; + static void _metadata_cb(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data) { + static_cast(client_data)->metadata_cb(decoder, metadata); + }; + static void _error_cb(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data) { + static_cast(client_data)->error_cb(decoder, status); + }; + // Actual FLAC callbacks + FLAC__StreamDecoderReadStatus read_cb(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes); + FLAC__StreamDecoderSeekStatus seek_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset); + FLAC__StreamDecoderTellStatus tell_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset); + FLAC__StreamDecoderLengthStatus length_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length); + FLAC__bool eof_cb(const FLAC__StreamDecoder *decoder); + FLAC__StreamDecoderWriteStatus write_cb(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 *const buffer[]); + void metadata_cb(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata); + void error_cb(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status); +}; + +#endif + diff --git a/src/libflac/AUTHORS b/src/libflac/AUTHORS new file mode 100644 index 0000000..8fe9092 --- /dev/null +++ b/src/libflac/AUTHORS @@ -0,0 +1,58 @@ +/* FLAC - Free Lossless Audio Codec + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This file is part the FLAC project. FLAC is comprised of several + * components distributed under different licenses. The codec libraries + * are distributed under Xiph.Org's BSD-like license (see the file + * COPYING.Xiph in this distribution). All other programs, libraries, and + * plugins are distributed under the GPL (see COPYING.GPL). The documentation + * is distributed under the Gnu FDL (see COPYING.FDL). Each file in the + * FLAC distribution contains at the top the terms under which it may be + * distributed. + * + * Since this particular file is relevant to all components of FLAC, + * it may be distributed under the Xiph.Org license, which is the least + * restrictive of those mentioned above. See the file COPYING.Xiph in this + * distribution. + */ + +Current FLAC maintainer: Erik de Castro Lopo + +Original author: Josh Coalson + +Website : https://www.xiph.org/flac/ + +FLAC is an Open Source lossless audio codec originally developed by Josh Coalson +between 2001 and 2009. From 2009 to 2012 FLAC was basically unmaintained. In +2012 the Erik de Castro Lopo became the chief maintainer as part of the +Xiph.Org Foundation. + +Other major contributors and their contributions: + +"lvqcl" +* Visual Studio build system. +* Optimisations in the encoder and decoder. + +"Janne Hyvärinen" +* Visual Studio build system. +* Unicode handling on Windows. + +"Andrey Astafiev" +* Russian translation of the HTML documentation + +"Miroslav Lichvar" +* IA-32 assembly versions of several libFLAC routines + +"Brady Patterson" +* AIFF file support, PPC assembly versions of libFLAC routines + +"Daisuke Shimamura" +* i18n support in the XMMS plugin + +"X-Fixer" +* Configuration system, tag editing, and file info in the Winamp2 plugin + +"Matt Zimmerman" +* Libtool/autoconf/automake make system, flac man page + diff --git a/src/libflac/COPYING.FDL b/src/libflac/COPYING.FDL new file mode 100644 index 0000000..4a0fe1c --- /dev/null +++ b/src/libflac/COPYING.FDL @@ -0,0 +1,397 @@ + GNU Free Documentation License + Version 1.2, November 2002 + + + Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. + 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other +functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The "Document", below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as "you". You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (Thus, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The "Cover Texts" are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +A section "Entitled XYZ" means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as "Acknowledgements", +"Dedications", "Endorsements", or "History".) To "Preserve the Title" +of such a section when you modify the Document means that it remains a +section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + + +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +3. COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + + +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. +B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement. +C. State on the Title page the name of the publisher of the + Modified Version, as the publisher. +D. Preserve all the copyright notices of the Document. +E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +H. Include an unaltered copy of this License. +I. Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. +J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. +K. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein. +L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. +M. Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version. +N. Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section. +O. Preserve any Warranty Disclaimers. + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" +in the various original documents, forming one section Entitled +"History"; likewise combine any sections Entitled "Acknowledgements", +and any sections Entitled "Dedications". You must delete all sections +Entitled "Endorsements". + + +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + + +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an "aggregate" if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + + +8. TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + + +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to +copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this +License will not have their licenses terminated so long as such +parties remain in full compliance. + + +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + + +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with...Texts." line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/src/libflac/COPYING.GPL b/src/libflac/COPYING.GPL new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/src/libflac/COPYING.GPL @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + 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., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/src/libflac/COPYING.LGPL b/src/libflac/COPYING.LGPL new file mode 100644 index 0000000..5ab7695 --- /dev/null +++ b/src/libflac/COPYING.LGPL @@ -0,0 +1,504 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 2.1, February 1999 + + Copyright (C) 1991, 1999 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the Lesser GPL. It also counts + as the successor of the GNU Library Public License, version 2, hence + the version number 2.1.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Lesser General Public License, applies to some +specially designated software packages--typically libraries--of the +Free Software Foundation and other authors who decide to use it. You +can use it too, but we suggest you first think carefully about whether +this license or the ordinary General Public License is the better +strategy to use in any particular case, based on the explanations below. + + When we speak of free software, we are referring to freedom of use, +not price. Our General Public Licenses are designed to make sure that +you have the freedom to distribute copies of free software (and charge +for this service if you wish); that you receive source code or can get +it if you want it; that you can change the software and use pieces of +it in new free programs; and that you are informed that you can do +these things. + + To protect your rights, we need to make restrictions that forbid +distributors to deny you these rights or to ask you to surrender these +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the library or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link other code with the library, you must provide +complete object files to the recipients, so that they can relink them +with the library after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + We protect your rights with a two-step method: (1) we copyright the +library, and (2) we offer you this license, which gives you legal +permission to copy, distribute and/or modify the library. + + To protect each distributor, we want to make it very clear that +there is no warranty for the free library. Also, if the library is +modified by someone else and passed on, the recipients should know +that what they have is not the original version, so that the original +author's reputation will not be affected by problems that might be +introduced by others. + + Finally, software patents pose a constant threat to the existence of +any free program. We wish to make sure that a company cannot +effectively restrict the users of a free program by obtaining a +restrictive license from a patent holder. Therefore, we insist that +any patent license obtained for a version of the library must be +consistent with the full freedom of use specified in this license. + + Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License. This license, the GNU Lesser +General Public License, applies to certain designated libraries, and +is quite different from the ordinary General Public License. We use +this license for certain libraries in order to permit linking those +libraries into non-free programs. + + When a program is linked with a library, whether statically or using +a shared library, the combination of the two is legally speaking a +combined work, a derivative of the original library. The ordinary +General Public License therefore permits such linking only if the +entire combination fits its criteria of freedom. The Lesser General +Public License permits more lax criteria for linking other code with +the library. + + We call this license the "Lesser" General Public License because it +does Less to protect the user's freedom than the ordinary General +Public License. It also provides other free software developers Less +of an advantage over competing non-free programs. These disadvantages +are the reason we use the ordinary General Public License for many +libraries. However, the Lesser license provides advantages in certain +special circumstances. + + For example, on rare occasions, there may be a special need to +encourage the widest possible use of a certain library, so that it becomes +a de-facto standard. To achieve this, non-free programs must be +allowed to use the library. A more frequent case is that a free +library does the same job as widely used non-free libraries. In this +case, there is little to gain by limiting the free library to free +software only, so we use the Lesser General Public License. + + In other cases, permission to use a particular library in non-free +programs enables a greater number of people to use a large body of +free software. For example, permission to use the GNU C Library in +non-free programs enables many more people to use the whole GNU +operating system, as well as its variant, the GNU/Linux operating +system. + + Although the Lesser General Public License is Less protective of the +users' freedom, it does ensure that the user of a program that is +linked with the Library has the freedom and the wherewithal to run +that program using a modified version of the Library. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, whereas the latter must +be combined with the library in order to run. + + GNU LESSER GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library or other +program which contains a notice placed by the copyright holder or +other authorized party saying it may be distributed under the terms of +this Lesser General Public License (also called "this License"). +Each licensee is addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also combine or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (1) uses at run time a + copy of the library already present on the user's computer system, + rather than copying library functions into the executable, and (2) + will operate properly with a modified version of the library, if + the user installs one, as long as the modified version is + interface-compatible with the version that the work was made with. + + c) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + d) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + e) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the materials to be distributed need not include anything that is +normally distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties with +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Lesser General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This 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. + + This 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 this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice + +That's all there is to it! + + diff --git a/src/libflac/COPYING.Xiph b/src/libflac/COPYING.Xiph new file mode 100644 index 0000000..d8295f0 --- /dev/null +++ b/src/libflac/COPYING.Xiph @@ -0,0 +1,29 @@ +Copyright (C) 2000-2009 Josh Coalson +Copyright (C) 2011-2016 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/src/libflac/FLAC/all.h b/src/libflac/FLAC/all.h new file mode 100644 index 0000000..11d47d7 --- /dev/null +++ b/src/libflac/FLAC/all.h @@ -0,0 +1,371 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__ALL_H +#define FLAC__ALL_H + +#include "export.h" + +#include "assert.h" +#include "callback.h" +#include "format.h" +#include "metadata.h" +#include "ordinals.h" +#include "stream_decoder.h" +#include "stream_encoder.h" + +/** \mainpage + * + * \section intro Introduction + * + * This is the documentation for the FLAC C and C++ APIs. It is + * highly interconnected; this introduction should give you a top + * level idea of the structure and how to find the information you + * need. As a prerequisite you should have at least a basic + * knowledge of the FLAC format, documented + * here. + * + * \section c_api FLAC C API + * + * The FLAC C API is the interface to libFLAC, a set of structures + * describing the components of FLAC streams, and functions for + * encoding and decoding streams, as well as manipulating FLAC + * metadata in files. The public include files will be installed + * in your include area (for example /usr/include/FLAC/...). + * + * By writing a little code and linking against libFLAC, it is + * relatively easy to add FLAC support to another program. The + * library is licensed under Xiph's BSD license. + * Complete source code of libFLAC as well as the command-line + * encoder and plugins is available and is a useful source of + * examples. + * + * Aside from encoders and decoders, libFLAC provides a powerful + * metadata interface for manipulating metadata in FLAC files. It + * allows the user to add, delete, and modify FLAC metadata blocks + * and it can automatically take advantage of PADDING blocks to avoid + * rewriting the entire FLAC file when changing the size of the + * metadata. + * + * libFLAC usually only requires the standard C library and C math + * library. In particular, threading is not used so there is no + * dependency on a thread library. However, libFLAC does not use + * global variables and should be thread-safe. + * + * libFLAC also supports encoding to and decoding from Ogg FLAC. + * However the metadata editing interfaces currently have limited + * read-only support for Ogg FLAC files. + * + * \section cpp_api FLAC C++ API + * + * The FLAC C++ API is a set of classes that encapsulate the + * structures and functions in libFLAC. They provide slightly more + * functionality with respect to metadata but are otherwise + * equivalent. For the most part, they share the same usage as + * their counterparts in libFLAC, and the FLAC C API documentation + * can be used as a supplement. The public include files + * for the C++ API will be installed in your include area (for + * example /usr/include/FLAC++/...). + * + * libFLAC++ is also licensed under + * Xiph's BSD license. + * + * \section getting_started Getting Started + * + * A good starting point for learning the API is to browse through + * the modules. Modules are logical + * groupings of related functions or classes, which correspond roughly + * to header files or sections of header files. Each module includes a + * detailed description of the general usage of its functions or + * classes. + * + * From there you can go on to look at the documentation of + * individual functions. You can see different views of the individual + * functions through the links in top bar across this page. + * + * If you prefer a more hands-on approach, you can jump right to some + * example code. + * + * \section porting_guide Porting Guide + * + * Starting with FLAC 1.1.3 a \link porting Porting Guide \endlink + * has been introduced which gives detailed instructions on how to + * port your code to newer versions of FLAC. + * + * \section embedded_developers Embedded Developers + * + * libFLAC has grown larger over time as more functionality has been + * included, but much of it may be unnecessary for a particular embedded + * implementation. Unused parts may be pruned by some simple editing of + * src/libFLAC/Makefile.am. In general, the decoders, encoders, and + * metadata interface are all independent from each other. + * + * It is easiest to just describe the dependencies: + * + * - All modules depend on the \link flac_format Format \endlink module. + * - The decoders and encoders depend on the bitbuffer. + * - The decoder is independent of the encoder. The encoder uses the + * decoder because of the verify feature, but this can be removed if + * not needed. + * - Parts of the metadata interface require the stream decoder (but not + * the encoder). + * - Ogg support is selectable through the compile time macro + * \c FLAC__HAS_OGG. + * + * For example, if your application only requires the stream decoder, no + * encoder, and no metadata interface, you can remove the stream encoder + * and the metadata interface, which will greatly reduce the size of the + * library. + * + * Also, there are several places in the libFLAC code with comments marked + * with "OPT:" where a #define can be changed to enable code that might be + * faster on a specific platform. Experimenting with these can yield faster + * binaries. + */ + +/** \defgroup porting Porting Guide for New Versions + * + * This module describes differences in the library interfaces from + * version to version. It assists in the porting of code that uses + * the libraries to newer versions of FLAC. + * + * One simple facility for making porting easier that has been added + * in FLAC 1.1.3 is a set of \c #defines in \c export.h of each + * library's includes (e.g. \c include/FLAC/export.h). The + * \c #defines mirror the libraries' + * libtool version numbers, + * e.g. in libFLAC there are \c FLAC_API_VERSION_CURRENT, + * \c FLAC_API_VERSION_REVISION, and \c FLAC_API_VERSION_AGE. + * These can be used to support multiple versions of an API during the + * transition phase, e.g. + * + * \code + * #if !defined(FLAC_API_VERSION_CURRENT) || FLAC_API_VERSION_CURRENT <= 7 + * legacy code + * #else + * new code + * #endif + * \endcode + * + * The source will work for multiple versions and the legacy code can + * easily be removed when the transition is complete. + * + * Another available symbol is FLAC_API_SUPPORTS_OGG_FLAC (defined in + * include/FLAC/export.h), which can be used to determine whether or not + * the library has been compiled with support for Ogg FLAC. This is + * simpler than trying to call an Ogg init function and catching the + * error. + */ + +/** \defgroup porting_1_1_2_to_1_1_3 Porting from FLAC 1.1.2 to 1.1.3 + * \ingroup porting + * + * \brief + * This module describes porting from FLAC 1.1.2 to FLAC 1.1.3. + * + * The main change between the APIs in 1.1.2 and 1.1.3 is that they have + * been simplified. First, libOggFLAC has been merged into libFLAC and + * libOggFLAC++ has been merged into libFLAC++. Second, both the three + * decoding layers and three encoding layers have been merged into a + * single stream decoder and stream encoder. That is, the functionality + * of FLAC__SeekableStreamDecoder and FLAC__FileDecoder has been merged + * into FLAC__StreamDecoder, and FLAC__SeekableStreamEncoder and + * FLAC__FileEncoder into FLAC__StreamEncoder. Only the + * FLAC__StreamDecoder and FLAC__StreamEncoder remain. What this means + * is there is now a single API that can be used to encode or decode + * streams to/from native FLAC or Ogg FLAC and the single API can work + * on both seekable and non-seekable streams. + * + * Instead of creating an encoder or decoder of a certain layer, now the + * client will always create a FLAC__StreamEncoder or + * FLAC__StreamDecoder. The old layers are now differentiated by the + * initialization function. For example, for the decoder, + * FLAC__stream_decoder_init() has been replaced by + * FLAC__stream_decoder_init_stream(). This init function takes + * callbacks for the I/O, and the seeking callbacks are optional. This + * allows the client to use the same object for seekable and + * non-seekable streams. For decoding a FLAC file directly, the client + * can use FLAC__stream_decoder_init_file() and pass just a filename + * and fewer callbacks; most of the other callbacks are supplied + * internally. For situations where fopen()ing by filename is not + * possible (e.g. Unicode filenames on Windows) the client can instead + * open the file itself and supply the FILE* to + * FLAC__stream_decoder_init_FILE(). The init functions now returns a + * FLAC__StreamDecoderInitStatus instead of FLAC__StreamDecoderState. + * Since the callbacks and client data are now passed to the init + * function, the FLAC__stream_decoder_set_*_callback() functions and + * FLAC__stream_decoder_set_client_data() are no longer needed. The + * rest of the calls to the decoder are the same as before. + * + * There are counterpart init functions for Ogg FLAC, e.g. + * FLAC__stream_decoder_init_ogg_stream(). All the rest of the calls + * and callbacks are the same as for native FLAC. + * + * As an example, in FLAC 1.1.2 a seekable stream decoder would have + * been set up like so: + * + * \code + * FLAC__SeekableStreamDecoder *decoder = FLAC__seekable_stream_decoder_new(); + * if(decoder == NULL) do_something; + * FLAC__seekable_stream_decoder_set_md5_checking(decoder, true); + * [... other settings ...] + * FLAC__seekable_stream_decoder_set_read_callback(decoder, my_read_callback); + * FLAC__seekable_stream_decoder_set_seek_callback(decoder, my_seek_callback); + * FLAC__seekable_stream_decoder_set_tell_callback(decoder, my_tell_callback); + * FLAC__seekable_stream_decoder_set_length_callback(decoder, my_length_callback); + * FLAC__seekable_stream_decoder_set_eof_callback(decoder, my_eof_callback); + * FLAC__seekable_stream_decoder_set_write_callback(decoder, my_write_callback); + * FLAC__seekable_stream_decoder_set_metadata_callback(decoder, my_metadata_callback); + * FLAC__seekable_stream_decoder_set_error_callback(decoder, my_error_callback); + * FLAC__seekable_stream_decoder_set_client_data(decoder, my_client_data); + * if(FLAC__seekable_stream_decoder_init(decoder) != FLAC__SEEKABLE_STREAM_DECODER_OK) do_something; + * \endcode + * + * In FLAC 1.1.3 it is like this: + * + * \code + * FLAC__StreamDecoder *decoder = FLAC__stream_decoder_new(); + * if(decoder == NULL) do_something; + * FLAC__stream_decoder_set_md5_checking(decoder, true); + * [... other settings ...] + * if(FLAC__stream_decoder_init_stream( + * decoder, + * my_read_callback, + * my_seek_callback, // or NULL + * my_tell_callback, // or NULL + * my_length_callback, // or NULL + * my_eof_callback, // or NULL + * my_write_callback, + * my_metadata_callback, // or NULL + * my_error_callback, + * my_client_data + * ) != FLAC__STREAM_DECODER_INIT_STATUS_OK) do_something; + * \endcode + * + * or you could do; + * + * \code + * [...] + * FILE *file = fopen("somefile.flac","rb"); + * if(file == NULL) do_somthing; + * if(FLAC__stream_decoder_init_FILE( + * decoder, + * file, + * my_write_callback, + * my_metadata_callback, // or NULL + * my_error_callback, + * my_client_data + * ) != FLAC__STREAM_DECODER_INIT_STATUS_OK) do_something; + * \endcode + * + * or just: + * + * \code + * [...] + * if(FLAC__stream_decoder_init_file( + * decoder, + * "somefile.flac", + * my_write_callback, + * my_metadata_callback, // or NULL + * my_error_callback, + * my_client_data + * ) != FLAC__STREAM_DECODER_INIT_STATUS_OK) do_something; + * \endcode + * + * Another small change to the decoder is in how it handles unparseable + * streams. Before, when the decoder found an unparseable stream + * (reserved for when the decoder encounters a stream from a future + * encoder that it can't parse), it changed the state to + * \c FLAC__STREAM_DECODER_UNPARSEABLE_STREAM. Now the decoder instead + * drops sync and calls the error callback with a new error code + * \c FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM. This is + * more robust. If your error callback does not discriminate on the the + * error state, your code does not need to be changed. + * + * The encoder now has a new setting: + * FLAC__stream_encoder_set_apodization(). This is for setting the + * method used to window the data before LPC analysis. You only need to + * add a call to this function if the default is not suitable. There + * are also two new convenience functions that may be useful: + * FLAC__metadata_object_cuesheet_calculate_cddb_id() and + * FLAC__metadata_get_cuesheet(). + * + * The \a bytes parameter to FLAC__StreamDecoderReadCallback, + * FLAC__StreamEncoderReadCallback, and FLAC__StreamEncoderWriteCallback + * is now \c size_t instead of \c unsigned. + */ + +/** \defgroup porting_1_1_3_to_1_1_4 Porting from FLAC 1.1.3 to 1.1.4 + * \ingroup porting + * + * \brief + * This module describes porting from FLAC 1.1.3 to FLAC 1.1.4. + * + * There were no changes to any of the interfaces from 1.1.3 to 1.1.4. + * There was a slight change in the implementation of + * FLAC__stream_encoder_set_metadata(); the function now makes a copy + * of the \a metadata array of pointers so the client no longer needs + * to maintain it after the call. The objects themselves that are + * pointed to by the array are still not copied though and must be + * maintained until the call to FLAC__stream_encoder_finish(). + */ + +/** \defgroup porting_1_1_4_to_1_2_0 Porting from FLAC 1.1.4 to 1.2.0 + * \ingroup porting + * + * \brief + * This module describes porting from FLAC 1.1.4 to FLAC 1.2.0. + * + * There were only very minor changes to the interfaces from 1.1.4 to 1.2.0. + * In libFLAC, \c FLAC__format_sample_rate_is_subset() was added. + * In libFLAC++, \c FLAC::Decoder::Stream::get_decode_position() was added. + * + * Finally, value of the constant \c FLAC__FRAME_HEADER_RESERVED_LEN + * has changed to reflect the conversion of one of the reserved bits + * into active use. It used to be \c 2 and now is \c 1. However the + * FLAC frame header length has not changed, so to skip the proper + * number of bits, use \c FLAC__FRAME_HEADER_RESERVED_LEN + + * \c FLAC__FRAME_HEADER_BLOCKING_STRATEGY_LEN + */ + +/** \defgroup flac FLAC C API + * + * The FLAC C API is the interface to libFLAC, a set of structures + * describing the components of FLAC streams, and functions for + * encoding and decoding streams, as well as manipulating FLAC + * metadata in files. + * + * You should start with the format components as all other modules + * are dependent on it. + */ + +#endif diff --git a/src/libflac/FLAC/assert.h b/src/libflac/FLAC/assert.h new file mode 100644 index 0000000..b546fd0 --- /dev/null +++ b/src/libflac/FLAC/assert.h @@ -0,0 +1,46 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__ASSERT_H +#define FLAC__ASSERT_H + +/* we need this since some compilers (like MSVC) leave assert()s on release code (and we don't want to use their ASSERT) */ +#ifdef DEBUG +#include +#define FLAC__ASSERT(x) assert(x) +#define FLAC__ASSERT_DECLARATION(x) x +#else +#define FLAC__ASSERT(x) +#define FLAC__ASSERT_DECLARATION(x) +#endif + +#endif diff --git a/src/libflac/FLAC/callback.h b/src/libflac/FLAC/callback.h new file mode 100644 index 0000000..f942dd2 --- /dev/null +++ b/src/libflac/FLAC/callback.h @@ -0,0 +1,185 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2004-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__CALLBACK_H +#define FLAC__CALLBACK_H + +#include "ordinals.h" +#include /* for size_t */ + +/** \file include/FLAC/callback.h + * + * \brief + * This module defines the structures for describing I/O callbacks + * to the other FLAC interfaces. + * + * See the detailed documentation for callbacks in the + * \link flac_callbacks callbacks \endlink module. + */ + +/** \defgroup flac_callbacks FLAC/callback.h: I/O callback structures + * \ingroup flac + * + * \brief + * This module defines the structures for describing I/O callbacks + * to the other FLAC interfaces. + * + * The purpose of the I/O callback functions is to create a common way + * for the metadata interfaces to handle I/O. + * + * Originally the metadata interfaces required filenames as the way of + * specifying FLAC files to operate on. This is problematic in some + * environments so there is an additional option to specify a set of + * callbacks for doing I/O on the FLAC file, instead of the filename. + * + * In addition to the callbacks, a FLAC__IOHandle type is defined as an + * opaque structure for a data source. + * + * The callback function prototypes are similar (but not identical) to the + * stdio functions fread, fwrite, fseek, ftell, feof, and fclose. If you use + * stdio streams to implement the callbacks, you can pass fread, fwrite, and + * fclose anywhere a FLAC__IOCallback_Read, FLAC__IOCallback_Write, or + * FLAC__IOCallback_Close is required, and a FILE* anywhere a FLAC__IOHandle + * is required. \warning You generally CANNOT directly use fseek or ftell + * for FLAC__IOCallback_Seek or FLAC__IOCallback_Tell since on most systems + * these use 32-bit offsets and FLAC requires 64-bit offsets to deal with + * large files. You will have to find an equivalent function (e.g. ftello), + * or write a wrapper. The same is true for feof() since this is usually + * implemented as a macro, not as a function whose address can be taken. + * + * \{ + */ + +#ifdef __cplusplus +extern "C" { +#endif + +/** This is the opaque handle type used by the callbacks. Typically + * this is a \c FILE* or address of a file descriptor. + */ +typedef void* FLAC__IOHandle; + +/** Signature for the read callback. + * The signature and semantics match POSIX fread() implementations + * and can generally be used interchangeably. + * + * \param ptr The address of the read buffer. + * \param size The size of the records to be read. + * \param nmemb The number of records to be read. + * \param handle The handle to the data source. + * \retval size_t + * The number of records read. + */ +typedef size_t (*FLAC__IOCallback_Read) (void *ptr, size_t size, size_t nmemb, FLAC__IOHandle handle); + +/** Signature for the write callback. + * The signature and semantics match POSIX fwrite() implementations + * and can generally be used interchangeably. + * + * \param ptr The address of the write buffer. + * \param size The size of the records to be written. + * \param nmemb The number of records to be written. + * \param handle The handle to the data source. + * \retval size_t + * The number of records written. + */ +typedef size_t (*FLAC__IOCallback_Write) (const void *ptr, size_t size, size_t nmemb, FLAC__IOHandle handle); + +/** Signature for the seek callback. + * The signature and semantics mostly match POSIX fseek() WITH ONE IMPORTANT + * EXCEPTION: the offset is a 64-bit type whereas fseek() is generally 'long' + * and 32-bits wide. + * + * \param handle The handle to the data source. + * \param offset The new position, relative to \a whence + * \param whence \c SEEK_SET, \c SEEK_CUR, or \c SEEK_END + * \retval int + * \c 0 on success, \c -1 on error. + */ +typedef int (*FLAC__IOCallback_Seek) (FLAC__IOHandle handle, FLAC__int64 offset, int whence); + +/** Signature for the tell callback. + * The signature and semantics mostly match POSIX ftell() WITH ONE IMPORTANT + * EXCEPTION: the offset is a 64-bit type whereas ftell() is generally 'long' + * and 32-bits wide. + * + * \param handle The handle to the data source. + * \retval FLAC__int64 + * The current position on success, \c -1 on error. + */ +typedef FLAC__int64 (*FLAC__IOCallback_Tell) (FLAC__IOHandle handle); + +/** Signature for the EOF callback. + * The signature and semantics mostly match POSIX feof() but WATCHOUT: + * on many systems, feof() is a macro, so in this case a wrapper function + * must be provided instead. + * + * \param handle The handle to the data source. + * \retval int + * \c 0 if not at end of file, nonzero if at end of file. + */ +typedef int (*FLAC__IOCallback_Eof) (FLAC__IOHandle handle); + +/** Signature for the close callback. + * The signature and semantics match POSIX fclose() implementations + * and can generally be used interchangeably. + * + * \param handle The handle to the data source. + * \retval int + * \c 0 on success, \c EOF on error. + */ +typedef int (*FLAC__IOCallback_Close) (FLAC__IOHandle handle); + +/** A structure for holding a set of callbacks. + * Each FLAC interface that requires a FLAC__IOCallbacks structure will + * describe which of the callbacks are required. The ones that are not + * required may be set to NULL. + * + * If the seek requirement for an interface is optional, you can signify that + * a data sorce is not seekable by setting the \a seek field to \c NULL. + */ +typedef struct { + FLAC__IOCallback_Read read; + FLAC__IOCallback_Write write; + FLAC__IOCallback_Seek seek; + FLAC__IOCallback_Tell tell; + FLAC__IOCallback_Eof eof; + FLAC__IOCallback_Close close; +} FLAC__IOCallbacks; + +/* \} */ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/FLAC/export.h b/src/libflac/FLAC/export.h new file mode 100644 index 0000000..d52f0bb --- /dev/null +++ b/src/libflac/FLAC/export.h @@ -0,0 +1,97 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__EXPORT_H +#define FLAC__EXPORT_H + +/** \file include/FLAC/export.h + * + * \brief + * This module contains #defines and symbols for exporting function + * calls, and providing version information and compiled-in features. + * + * See the \link flac_export export \endlink module. + */ + +/** \defgroup flac_export FLAC/export.h: export symbols + * \ingroup flac + * + * \brief + * This module contains #defines and symbols for exporting function + * calls, and providing version information and compiled-in features. + * + * If you are compiling with MSVC and will link to the static library + * (libFLAC.lib) you should define FLAC__NO_DLL in your project to + * make sure the symbols are exported properly. + * + * \{ + */ + +#if defined(FLAC__NO_DLL) +#define FLAC_API + +#elif defined(_MSC_VER) +#ifdef FLAC_API_EXPORTS +#define FLAC_API __declspec(dllexport) +#else +#define FLAC_API __declspec(dllimport) +#endif + +#elif defined(FLAC__USE_VISIBILITY_ATTR) +#define FLAC_API __attribute__ ((visibility ("default"))) + +#else +#define FLAC_API + +#endif + +/** These #defines will mirror the libtool-based library version number, see + * http://www.gnu.org/software/libtool/manual/libtool.html#Libtool-versioning + */ +#define FLAC_API_VERSION_CURRENT 11 +#define FLAC_API_VERSION_REVISION 0 /**< see above */ +#define FLAC_API_VERSION_AGE 3 /**< see above */ + +#ifdef __cplusplus +extern "C" { +#endif + +/** \c 1 if the library has been compiled with support for Ogg FLAC, else \c 0. */ +extern FLAC_API int FLAC_API_SUPPORTS_OGG_FLAC; + +#ifdef __cplusplus +} +#endif + +/* \} */ + +#endif diff --git a/src/libflac/FLAC/format.h b/src/libflac/FLAC/format.h new file mode 100644 index 0000000..c087d4a --- /dev/null +++ b/src/libflac/FLAC/format.h @@ -0,0 +1,1025 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__FORMAT_H +#define FLAC__FORMAT_H + +#include "export.h" +#include "ordinals.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** \file include/FLAC/format.h + * + * \brief + * This module contains structure definitions for the representation + * of FLAC format components in memory. These are the basic + * structures used by the rest of the interfaces. + * + * See the detailed documentation in the + * \link flac_format format \endlink module. + */ + +/** \defgroup flac_format FLAC/format.h: format components + * \ingroup flac + * + * \brief + * This module contains structure definitions for the representation + * of FLAC format components in memory. These are the basic + * structures used by the rest of the interfaces. + * + * First, you should be familiar with the + * FLAC format. Many of the values here + * follow directly from the specification. As a user of libFLAC, the + * interesting parts really are the structures that describe the frame + * header and metadata blocks. + * + * The format structures here are very primitive, designed to store + * information in an efficient way. Reading information from the + * structures is easy but creating or modifying them directly is + * more complex. For the most part, as a user of a library, editing + * is not necessary; however, for metadata blocks it is, so there are + * convenience functions provided in the \link flac_metadata metadata + * module \endlink to simplify the manipulation of metadata blocks. + * + * \note + * It's not the best convention, but symbols ending in _LEN are in bits + * and _LENGTH are in bytes. _LENGTH symbols are \#defines instead of + * global variables because they are usually used when declaring byte + * arrays and some compilers require compile-time knowledge of array + * sizes when declared on the stack. + * + * \{ + */ + + +/* + Most of the values described in this file are defined by the FLAC + format specification. There is nothing to tune here. +*/ + +/** The largest legal metadata type code. */ +#define FLAC__MAX_METADATA_TYPE_CODE (126u) + +/** The minimum block size, in samples, permitted by the format. */ +#define FLAC__MIN_BLOCK_SIZE (16u) + +/** The maximum block size, in samples, permitted by the format. */ +#define FLAC__MAX_BLOCK_SIZE (65535u) + +/** The maximum block size, in samples, permitted by the FLAC subset for + * sample rates up to 48kHz. */ +#define FLAC__SUBSET_MAX_BLOCK_SIZE_48000HZ (4608u) + +/** The maximum number of channels permitted by the format. */ +#define FLAC__MAX_CHANNELS (8u) + +/** The minimum sample resolution permitted by the format. */ +#define FLAC__MIN_BITS_PER_SAMPLE (4u) + +/** The maximum sample resolution permitted by the format. */ +#define FLAC__MAX_BITS_PER_SAMPLE (32u) + +/** The maximum sample resolution permitted by libFLAC. + * + * \warning + * FLAC__MAX_BITS_PER_SAMPLE is the limit of the FLAC format. However, + * the reference encoder/decoder is currently limited to 24 bits because + * of prevalent 32-bit math, so make sure and use this value when + * appropriate. + */ +#define FLAC__REFERENCE_CODEC_MAX_BITS_PER_SAMPLE (24u) + +/** The maximum sample rate permitted by the format. The value is + * ((2 ^ 16) - 1) * 10; see FLAC format + * as to why. + */ +#define FLAC__MAX_SAMPLE_RATE (655350u) + +/** The maximum LPC order permitted by the format. */ +#define FLAC__MAX_LPC_ORDER (32u) + +/** The maximum LPC order permitted by the FLAC subset for sample rates + * up to 48kHz. */ +#define FLAC__SUBSET_MAX_LPC_ORDER_48000HZ (12u) + +/** The minimum quantized linear predictor coefficient precision + * permitted by the format. + */ +#define FLAC__MIN_QLP_COEFF_PRECISION (5u) + +/** The maximum quantized linear predictor coefficient precision + * permitted by the format. + */ +#define FLAC__MAX_QLP_COEFF_PRECISION (15u) + +/** The maximum order of the fixed predictors permitted by the format. */ +#define FLAC__MAX_FIXED_ORDER (4u) + +/** The maximum Rice partition order permitted by the format. */ +#define FLAC__MAX_RICE_PARTITION_ORDER (15u) + +/** The maximum Rice partition order permitted by the FLAC Subset. */ +#define FLAC__SUBSET_MAX_RICE_PARTITION_ORDER (8u) + +/** The version string of the release, stamped onto the libraries and binaries. + * + * \note + * This does not correspond to the shared library version number, which + * is used to determine binary compatibility. + */ +extern FLAC_API const char *FLAC__VERSION_STRING; + +/** The vendor string inserted by the encoder into the VORBIS_COMMENT block. + * This is a NUL-terminated ASCII string; when inserted into the + * VORBIS_COMMENT the trailing null is stripped. + */ +extern FLAC_API const char *FLAC__VENDOR_STRING; + +/** The byte string representation of the beginning of a FLAC stream. */ +extern FLAC_API const FLAC__byte FLAC__STREAM_SYNC_STRING[4]; /* = "fLaC" */ + +/** The 32-bit integer big-endian representation of the beginning of + * a FLAC stream. + */ +extern FLAC_API const unsigned FLAC__STREAM_SYNC; /* = 0x664C6143 */ + +/** The length of the FLAC signature in bits. */ +extern FLAC_API const unsigned FLAC__STREAM_SYNC_LEN; /* = 32 bits */ + +/** The length of the FLAC signature in bytes. */ +#define FLAC__STREAM_SYNC_LENGTH (4u) + + +/***************************************************************************** + * + * Subframe structures + * + *****************************************************************************/ + +/*****************************************************************************/ + +/** An enumeration of the available entropy coding methods. */ +typedef enum { + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE = 0, + /**< Residual is coded by partitioning into contexts, each with it's own + * 4-bit Rice parameter. */ + + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2 = 1 + /**< Residual is coded by partitioning into contexts, each with it's own + * 5-bit Rice parameter. */ +} FLAC__EntropyCodingMethodType; + +/** Maps a FLAC__EntropyCodingMethodType to a C string. + * + * Using a FLAC__EntropyCodingMethodType as the index to this array will + * give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__EntropyCodingMethodTypeString[]; + + +/** Contents of a Rice partitioned residual + */ +typedef struct { + + unsigned *parameters; + /**< The Rice parameters for each context. */ + + unsigned *raw_bits; + /**< Widths for escape-coded partitions. Will be non-zero for escaped + * partitions and zero for unescaped partitions. + */ + + unsigned capacity_by_order; + /**< The capacity of the \a parameters and \a raw_bits arrays + * specified as an order, i.e. the number of array elements + * allocated is 2 ^ \a capacity_by_order. + */ +} FLAC__EntropyCodingMethod_PartitionedRiceContents; + +/** Header for a Rice partitioned residual. (c.f. format specification) + */ +typedef struct { + + unsigned order; + /**< The partition order, i.e. # of contexts = 2 ^ \a order. */ + + const FLAC__EntropyCodingMethod_PartitionedRiceContents *contents; + /**< The context's Rice parameters and/or raw bits. */ + +} FLAC__EntropyCodingMethod_PartitionedRice; + +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2_PARAMETER_LEN; /**< == 5 (bits) */ +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_RAW_LEN; /**< == 5 (bits) */ + +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER; +/**< == (1<format specification) + */ +typedef struct { + FLAC__EntropyCodingMethodType type; + union { + FLAC__EntropyCodingMethod_PartitionedRice partitioned_rice; + } data; +} FLAC__EntropyCodingMethod; + +extern FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_TYPE_LEN; /**< == 2 (bits) */ + +/*****************************************************************************/ + +/** An enumeration of the available subframe types. */ +typedef enum { + FLAC__SUBFRAME_TYPE_CONSTANT = 0, /**< constant signal */ + FLAC__SUBFRAME_TYPE_VERBATIM = 1, /**< uncompressed signal */ + FLAC__SUBFRAME_TYPE_FIXED = 2, /**< fixed polynomial prediction */ + FLAC__SUBFRAME_TYPE_LPC = 3 /**< linear prediction */ +} FLAC__SubframeType; + +/** Maps a FLAC__SubframeType to a C string. + * + * Using a FLAC__SubframeType as the index to this array will + * give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__SubframeTypeString[]; + + +/** CONSTANT subframe. (c.f. format specification) + */ +typedef struct { + FLAC__int32 value; /**< The constant signal value. */ +} FLAC__Subframe_Constant; + + +/** VERBATIM subframe. (c.f. format specification) + */ +typedef struct { + const FLAC__int32 *data; /**< A pointer to verbatim signal. */ +} FLAC__Subframe_Verbatim; + + +/** FIXED subframe. (c.f. format specification) + */ +typedef struct { + FLAC__EntropyCodingMethod entropy_coding_method; + /**< The residual coding method. */ + + unsigned order; + /**< The polynomial order. */ + + FLAC__int32 warmup[FLAC__MAX_FIXED_ORDER]; + /**< Warmup samples to prime the predictor, length == order. */ + + const FLAC__int32 *residual; + /**< The residual signal, length == (blocksize minus order) samples. */ +} FLAC__Subframe_Fixed; + + +/** LPC subframe. (c.f. format specification) + */ +typedef struct { + FLAC__EntropyCodingMethod entropy_coding_method; + /**< The residual coding method. */ + + unsigned order; + /**< The FIR order. */ + + unsigned qlp_coeff_precision; + /**< Quantized FIR filter coefficient precision in bits. */ + + int quantization_level; + /**< The qlp coeff shift needed. */ + + FLAC__int32 qlp_coeff[FLAC__MAX_LPC_ORDER]; + /**< FIR filter coefficients. */ + + FLAC__int32 warmup[FLAC__MAX_LPC_ORDER]; + /**< Warmup samples to prime the predictor, length == order. */ + + const FLAC__int32 *residual; + /**< The residual signal, length == (blocksize minus order) samples. */ +} FLAC__Subframe_LPC; + +extern FLAC_API const unsigned FLAC__SUBFRAME_LPC_QLP_COEFF_PRECISION_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__SUBFRAME_LPC_QLP_SHIFT_LEN; /**< == 5 (bits) */ + + +/** FLAC subframe structure. (c.f. format specification) + */ +typedef struct { + FLAC__SubframeType type; + union { + FLAC__Subframe_Constant constant; + FLAC__Subframe_Fixed fixed; + FLAC__Subframe_LPC lpc; + FLAC__Subframe_Verbatim verbatim; + } data; + unsigned wasted_bits; +} FLAC__Subframe; + +/** == 1 (bit) + * + * This used to be a zero-padding bit (hence the name + * FLAC__SUBFRAME_ZERO_PAD_LEN) but is now a reserved bit. It still has a + * mandatory value of \c 0 but in the future may take on the value \c 0 or \c 1 + * to mean something else. + */ +extern FLAC_API const unsigned FLAC__SUBFRAME_ZERO_PAD_LEN; +extern FLAC_API const unsigned FLAC__SUBFRAME_TYPE_LEN; /**< == 6 (bits) */ +extern FLAC_API const unsigned FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN; /**< == 1 (bit) */ + +extern FLAC_API const unsigned FLAC__SUBFRAME_TYPE_CONSTANT_BYTE_ALIGNED_MASK; /**< = 0x00 */ +extern FLAC_API const unsigned FLAC__SUBFRAME_TYPE_VERBATIM_BYTE_ALIGNED_MASK; /**< = 0x02 */ +extern FLAC_API const unsigned FLAC__SUBFRAME_TYPE_FIXED_BYTE_ALIGNED_MASK; /**< = 0x10 */ +extern FLAC_API const unsigned FLAC__SUBFRAME_TYPE_LPC_BYTE_ALIGNED_MASK; /**< = 0x40 */ + +/*****************************************************************************/ + + +/***************************************************************************** + * + * Frame structures + * + *****************************************************************************/ + +/** An enumeration of the available channel assignments. */ +typedef enum { + FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT = 0, /**< independent channels */ + FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE = 1, /**< left+side stereo */ + FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE = 2, /**< right+side stereo */ + FLAC__CHANNEL_ASSIGNMENT_MID_SIDE = 3 /**< mid+side stereo */ +} FLAC__ChannelAssignment; + +/** Maps a FLAC__ChannelAssignment to a C string. + * + * Using a FLAC__ChannelAssignment as the index to this array will + * give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__ChannelAssignmentString[]; + +/** An enumeration of the possible frame numbering methods. */ +typedef enum { + FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER, /**< number contains the frame number */ + FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER /**< number contains the sample number of first sample in frame */ +} FLAC__FrameNumberType; + +/** Maps a FLAC__FrameNumberType to a C string. + * + * Using a FLAC__FrameNumberType as the index to this array will + * give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__FrameNumberTypeString[]; + + +/** FLAC frame header structure. (c.f. format specification) + */ +typedef struct { + unsigned blocksize; + /**< The number of samples per subframe. */ + + unsigned sample_rate; + /**< The sample rate in Hz. */ + + unsigned channels; + /**< The number of channels (== number of subframes). */ + + FLAC__ChannelAssignment channel_assignment; + /**< The channel assignment for the frame. */ + + unsigned bits_per_sample; + /**< The sample resolution. */ + + FLAC__FrameNumberType number_type; + /**< The numbering scheme used for the frame. As a convenience, the + * decoder will always convert a frame number to a sample number because + * the rules are complex. */ + + union { + FLAC__uint32 frame_number; + FLAC__uint64 sample_number; + } number; + /**< The frame number or sample number of first sample in frame; + * use the \a number_type value to determine which to use. */ + + FLAC__uint8 crc; + /**< CRC-8 (polynomial = x^8 + x^2 + x^1 + x^0, initialized with 0) + * of the raw frame header bytes, meaning everything before the CRC byte + * including the sync code. + */ +} FLAC__FrameHeader; + +extern FLAC_API const unsigned FLAC__FRAME_HEADER_SYNC; /**< == 0x3ffe; the frame header sync code */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_SYNC_LEN; /**< == 14 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_RESERVED_LEN; /**< == 1 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_BLOCKING_STRATEGY_LEN; /**< == 1 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_BLOCK_SIZE_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_SAMPLE_RATE_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_CHANNEL_ASSIGNMENT_LEN; /**< == 4 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_BITS_PER_SAMPLE_LEN; /**< == 3 (bits) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_ZERO_PAD_LEN; /**< == 1 (bit) */ +extern FLAC_API const unsigned FLAC__FRAME_HEADER_CRC_LEN; /**< == 8 (bits) */ + + +/** FLAC frame footer structure. (c.f. format specification) + */ +typedef struct { + FLAC__uint16 crc; + /**< CRC-16 (polynomial = x^16 + x^15 + x^2 + x^0, initialized with + * 0) of the bytes before the crc, back to and including the frame header + * sync code. + */ +} FLAC__FrameFooter; + +extern FLAC_API const unsigned FLAC__FRAME_FOOTER_CRC_LEN; /**< == 16 (bits) */ + + +/** FLAC frame structure. (c.f. format specification) + */ +typedef struct { + FLAC__FrameHeader header; + FLAC__Subframe subframes[FLAC__MAX_CHANNELS]; + FLAC__FrameFooter footer; +} FLAC__Frame; + +/*****************************************************************************/ + + +/***************************************************************************** + * + * Meta-data structures + * + *****************************************************************************/ + +/** An enumeration of the available metadata block types. */ +typedef enum { + + FLAC__METADATA_TYPE_STREAMINFO = 0, + /**< STREAMINFO block */ + + FLAC__METADATA_TYPE_PADDING = 1, + /**< PADDING block */ + + FLAC__METADATA_TYPE_APPLICATION = 2, + /**< APPLICATION block */ + + FLAC__METADATA_TYPE_SEEKTABLE = 3, + /**< SEEKTABLE block */ + + FLAC__METADATA_TYPE_VORBIS_COMMENT = 4, + /**< VORBISCOMMENT block (a.k.a. FLAC tags) */ + + FLAC__METADATA_TYPE_CUESHEET = 5, + /**< CUESHEET block */ + + FLAC__METADATA_TYPE_PICTURE = 6, + /**< PICTURE block */ + + FLAC__METADATA_TYPE_UNDEFINED = 7, + /**< marker to denote beginning of undefined type range; this number will increase as new metadata types are added */ + + FLAC__MAX_METADATA_TYPE = FLAC__MAX_METADATA_TYPE_CODE, + /**< No type will ever be greater than this. There is not enough room in the protocol block. */ +} FLAC__MetadataType; + +/** Maps a FLAC__MetadataType to a C string. + * + * Using a FLAC__MetadataType as the index to this array will + * give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__MetadataTypeString[]; + + +/** FLAC STREAMINFO structure. (c.f. format specification) + */ +typedef struct { + unsigned min_blocksize, max_blocksize; + unsigned min_framesize, max_framesize; + unsigned sample_rate; + unsigned channels; + unsigned bits_per_sample; + FLAC__uint64 total_samples; + FLAC__byte md5sum[16]; +} FLAC__StreamMetadata_StreamInfo; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN; /**< == 16 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN; /**< == 16 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN; /**< == 24 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN; /**< == 24 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN; /**< == 20 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN; /**< == 3 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN; /**< == 5 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN; /**< == 36 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MD5SUM_LEN; /**< == 128 (bits) */ + +/** The total stream length of the STREAMINFO block in bytes. */ +#define FLAC__STREAM_METADATA_STREAMINFO_LENGTH (34u) + +/** FLAC PADDING structure. (c.f. format specification) + */ +typedef struct { + int dummy; + /**< Conceptually this is an empty struct since we don't store the + * padding bytes. Empty structs are not allowed by some C compilers, + * hence the dummy. + */ +} FLAC__StreamMetadata_Padding; + + +/** FLAC APPLICATION structure. (c.f. format specification) + */ +typedef struct { + FLAC__byte id[4]; + FLAC__byte *data; +} FLAC__StreamMetadata_Application; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_APPLICATION_ID_LEN; /**< == 32 (bits) */ + +/** SeekPoint structure used in SEEKTABLE blocks. (c.f. format specification) + */ +typedef struct { + FLAC__uint64 sample_number; + /**< The sample number of the target frame. */ + + FLAC__uint64 stream_offset; + /**< The offset, in bytes, of the target frame with respect to + * beginning of the first frame. */ + + unsigned frame_samples; + /**< The number of samples in the target frame. */ +} FLAC__StreamMetadata_SeekPoint; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_SAMPLE_NUMBER_LEN; /**< == 64 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_STREAM_OFFSET_LEN; /**< == 64 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_FRAME_SAMPLES_LEN; /**< == 16 (bits) */ + +/** The total stream length of a seek point in bytes. */ +#define FLAC__STREAM_METADATA_SEEKPOINT_LENGTH (18u) + +/** The value used in the \a sample_number field of + * FLAC__StreamMetadataSeekPoint used to indicate a placeholder + * point (== 0xffffffffffffffff). + */ +extern FLAC_API const FLAC__uint64 FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER; + + +/** FLAC SEEKTABLE structure. (c.f. format specification) + * + * \note From the format specification: + * - The seek points must be sorted by ascending sample number. + * - Each seek point's sample number must be the first sample of the + * target frame. + * - Each seek point's sample number must be unique within the table. + * - Existence of a SEEKTABLE block implies a correct setting of + * total_samples in the stream_info block. + * - Behavior is undefined when more than one SEEKTABLE block is + * present in a stream. + */ +typedef struct { + unsigned num_points; + FLAC__StreamMetadata_SeekPoint *points; +} FLAC__StreamMetadata_SeekTable; + + +/** Vorbis comment entry structure used in VORBIS_COMMENT blocks. (c.f. format specification) + * + * For convenience, the APIs maintain a trailing NUL character at the end of + * \a entry which is not counted toward \a length, i.e. + * \code strlen(entry) == length \endcode + */ +typedef struct { + FLAC__uint32 length; + FLAC__byte *entry; +} FLAC__StreamMetadata_VorbisComment_Entry; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_VORBIS_COMMENT_ENTRY_LENGTH_LEN; /**< == 32 (bits) */ + + +/** FLAC VORBIS_COMMENT structure. (c.f. format specification) + */ +typedef struct { + FLAC__StreamMetadata_VorbisComment_Entry vendor_string; + FLAC__uint32 num_comments; + FLAC__StreamMetadata_VorbisComment_Entry *comments; +} FLAC__StreamMetadata_VorbisComment; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_VORBIS_COMMENT_NUM_COMMENTS_LEN; /**< == 32 (bits) */ + + +/** FLAC CUESHEET track index structure. (See the + * format specification for + * the full description of each field.) + */ +typedef struct { + FLAC__uint64 offset; + /**< Offset in samples, relative to the track offset, of the index + * point. + */ + + FLAC__byte number; + /**< The index point number. */ +} FLAC__StreamMetadata_CueSheet_Index; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_OFFSET_LEN; /**< == 64 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_NUMBER_LEN; /**< == 8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_RESERVED_LEN; /**< == 3*8 (bits) */ + + +/** FLAC CUESHEET track structure. (See the + * format specification for + * the full description of each field.) + */ +typedef struct { + FLAC__uint64 offset; + /**< Track offset in samples, relative to the beginning of the FLAC audio stream. */ + + FLAC__byte number; + /**< The track number. */ + + char isrc[13]; + /**< Track ISRC. This is a 12-digit alphanumeric code plus a trailing \c NUL byte */ + + unsigned type:1; + /**< The track type: 0 for audio, 1 for non-audio. */ + + unsigned pre_emphasis:1; + /**< The pre-emphasis flag: 0 for no pre-emphasis, 1 for pre-emphasis. */ + + FLAC__byte num_indices; + /**< The number of track index points. */ + + FLAC__StreamMetadata_CueSheet_Index *indices; + /**< NULL if num_indices == 0, else pointer to array of index points. */ + +} FLAC__StreamMetadata_CueSheet_Track; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_OFFSET_LEN; /**< == 64 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_NUMBER_LEN; /**< == 8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_ISRC_LEN; /**< == 12*8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_TYPE_LEN; /**< == 1 (bit) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_PRE_EMPHASIS_LEN; /**< == 1 (bit) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_RESERVED_LEN; /**< == 6+13*8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_NUM_INDICES_LEN; /**< == 8 (bits) */ + + +/** FLAC CUESHEET structure. (See the + * format specification + * for the full description of each field.) + */ +typedef struct { + char media_catalog_number[129]; + /**< Media catalog number, in ASCII printable characters 0x20-0x7e. In + * general, the media catalog number may be 0 to 128 bytes long; any + * unused characters should be right-padded with NUL characters. + */ + + FLAC__uint64 lead_in; + /**< The number of lead-in samples. */ + + FLAC__bool is_cd; + /**< \c true if CUESHEET corresponds to a Compact Disc, else \c false. */ + + unsigned num_tracks; + /**< The number of tracks. */ + + FLAC__StreamMetadata_CueSheet_Track *tracks; + /**< NULL if num_tracks == 0, else pointer to array of tracks. */ + +} FLAC__StreamMetadata_CueSheet; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_MEDIA_CATALOG_NUMBER_LEN; /**< == 128*8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_LEAD_IN_LEN; /**< == 64 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_IS_CD_LEN; /**< == 1 (bit) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_RESERVED_LEN; /**< == 7+258*8 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_NUM_TRACKS_LEN; /**< == 8 (bits) */ + + +/** An enumeration of the PICTURE types (see FLAC__StreamMetadataPicture and id3 v2.4 APIC tag). */ +typedef enum { + FLAC__STREAM_METADATA_PICTURE_TYPE_OTHER = 0, /**< Other */ + FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON_STANDARD = 1, /**< 32x32 pixels 'file icon' (PNG only) */ + FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON = 2, /**< Other file icon */ + FLAC__STREAM_METADATA_PICTURE_TYPE_FRONT_COVER = 3, /**< Cover (front) */ + FLAC__STREAM_METADATA_PICTURE_TYPE_BACK_COVER = 4, /**< Cover (back) */ + FLAC__STREAM_METADATA_PICTURE_TYPE_LEAFLET_PAGE = 5, /**< Leaflet page */ + FLAC__STREAM_METADATA_PICTURE_TYPE_MEDIA = 6, /**< Media (e.g. label side of CD) */ + FLAC__STREAM_METADATA_PICTURE_TYPE_LEAD_ARTIST = 7, /**< Lead artist/lead performer/soloist */ + FLAC__STREAM_METADATA_PICTURE_TYPE_ARTIST = 8, /**< Artist/performer */ + FLAC__STREAM_METADATA_PICTURE_TYPE_CONDUCTOR = 9, /**< Conductor */ + FLAC__STREAM_METADATA_PICTURE_TYPE_BAND = 10, /**< Band/Orchestra */ + FLAC__STREAM_METADATA_PICTURE_TYPE_COMPOSER = 11, /**< Composer */ + FLAC__STREAM_METADATA_PICTURE_TYPE_LYRICIST = 12, /**< Lyricist/text writer */ + FLAC__STREAM_METADATA_PICTURE_TYPE_RECORDING_LOCATION = 13, /**< Recording Location */ + FLAC__STREAM_METADATA_PICTURE_TYPE_DURING_RECORDING = 14, /**< During recording */ + FLAC__STREAM_METADATA_PICTURE_TYPE_DURING_PERFORMANCE = 15, /**< During performance */ + FLAC__STREAM_METADATA_PICTURE_TYPE_VIDEO_SCREEN_CAPTURE = 16, /**< Movie/video screen capture */ + FLAC__STREAM_METADATA_PICTURE_TYPE_FISH = 17, /**< A bright coloured fish */ + FLAC__STREAM_METADATA_PICTURE_TYPE_ILLUSTRATION = 18, /**< Illustration */ + FLAC__STREAM_METADATA_PICTURE_TYPE_BAND_LOGOTYPE = 19, /**< Band/artist logotype */ + FLAC__STREAM_METADATA_PICTURE_TYPE_PUBLISHER_LOGOTYPE = 20, /**< Publisher/Studio logotype */ + FLAC__STREAM_METADATA_PICTURE_TYPE_UNDEFINED +} FLAC__StreamMetadata_Picture_Type; + +/** Maps a FLAC__StreamMetadata_Picture_Type to a C string. + * + * Using a FLAC__StreamMetadata_Picture_Type as the index to this array + * will give the string equivalent. The contents should not be + * modified. + */ +extern FLAC_API const char * const FLAC__StreamMetadata_Picture_TypeString[]; + +/** FLAC PICTURE structure. (See the + * format specification + * for the full description of each field.) + */ +typedef struct { + FLAC__StreamMetadata_Picture_Type type; + /**< The kind of picture stored. */ + + char *mime_type; + /**< Picture data's MIME type, in ASCII printable characters + * 0x20-0x7e, NUL terminated. For best compatibility with players, + * use picture data of MIME type \c image/jpeg or \c image/png. A + * MIME type of '-->' is also allowed, in which case the picture + * data should be a complete URL. In file storage, the MIME type is + * stored as a 32-bit length followed by the ASCII string with no NUL + * terminator, but is converted to a plain C string in this structure + * for convenience. + */ + + FLAC__byte *description; + /**< Picture's description in UTF-8, NUL terminated. In file storage, + * the description is stored as a 32-bit length followed by the UTF-8 + * string with no NUL terminator, but is converted to a plain C string + * in this structure for convenience. + */ + + FLAC__uint32 width; + /**< Picture's width in pixels. */ + + FLAC__uint32 height; + /**< Picture's height in pixels. */ + + FLAC__uint32 depth; + /**< Picture's color depth in bits-per-pixel. */ + + FLAC__uint32 colors; + /**< For indexed palettes (like GIF), picture's number of colors (the + * number of palette entries), or \c 0 for non-indexed (i.e. 2^depth). + */ + + FLAC__uint32 data_length; + /**< Length of binary picture data in bytes. */ + + FLAC__byte *data; + /**< Binary picture data. */ + +} FLAC__StreamMetadata_Picture; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_TYPE_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_MIME_TYPE_LENGTH_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DESCRIPTION_LENGTH_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_WIDTH_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_HEIGHT_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DEPTH_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_COLORS_LEN; /**< == 32 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DATA_LENGTH_LEN; /**< == 32 (bits) */ + + +/** Structure that is used when a metadata block of unknown type is loaded. + * The contents are opaque. The structure is used only internally to + * correctly handle unknown metadata. + */ +typedef struct { + FLAC__byte *data; +} FLAC__StreamMetadata_Unknown; + + +/** FLAC metadata block structure. (c.f. format specification) + */ +typedef struct { + FLAC__MetadataType type; + /**< The type of the metadata block; used determine which member of the + * \a data union to dereference. If type >= FLAC__METADATA_TYPE_UNDEFINED + * then \a data.unknown must be used. */ + + FLAC__bool is_last; + /**< \c true if this metadata block is the last, else \a false */ + + unsigned length; + /**< Length, in bytes, of the block data as it appears in the stream. */ + + union { + FLAC__StreamMetadata_StreamInfo stream_info; + FLAC__StreamMetadata_Padding padding; + FLAC__StreamMetadata_Application application; + FLAC__StreamMetadata_SeekTable seek_table; + FLAC__StreamMetadata_VorbisComment vorbis_comment; + FLAC__StreamMetadata_CueSheet cue_sheet; + FLAC__StreamMetadata_Picture picture; + FLAC__StreamMetadata_Unknown unknown; + } data; + /**< Polymorphic block data; use the \a type value to determine which + * to use. */ +} FLAC__StreamMetadata; + +extern FLAC_API const unsigned FLAC__STREAM_METADATA_IS_LAST_LEN; /**< == 1 (bit) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_TYPE_LEN; /**< == 7 (bits) */ +extern FLAC_API const unsigned FLAC__STREAM_METADATA_LENGTH_LEN; /**< == 24 (bits) */ + +/** The total stream length of a metadata block header in bytes. */ +#define FLAC__STREAM_METADATA_HEADER_LENGTH (4u) + +/*****************************************************************************/ + + +/***************************************************************************** + * + * Utility functions + * + *****************************************************************************/ + +/** Tests that a sample rate is valid for FLAC. + * + * \param sample_rate The sample rate to test for compliance. + * \retval FLAC__bool + * \c true if the given sample rate conforms to the specification, else + * \c false. + */ +FLAC_API FLAC__bool FLAC__format_sample_rate_is_valid(unsigned sample_rate); + +/** Tests that a blocksize at the given sample rate is valid for the FLAC + * subset. + * + * \param blocksize The blocksize to test for compliance. + * \param sample_rate The sample rate is needed, since the valid subset + * blocksize depends on the sample rate. + * \retval FLAC__bool + * \c true if the given blocksize conforms to the specification for the + * subset at the given sample rate, else \c false. + */ +FLAC_API FLAC__bool FLAC__format_blocksize_is_subset(unsigned blocksize, unsigned sample_rate); + +/** Tests that a sample rate is valid for the FLAC subset. The subset rules + * for valid sample rates are slightly more complex since the rate has to + * be expressible completely in the frame header. + * + * \param sample_rate The sample rate to test for compliance. + * \retval FLAC__bool + * \c true if the given sample rate conforms to the specification for the + * subset, else \c false. + */ +FLAC_API FLAC__bool FLAC__format_sample_rate_is_subset(unsigned sample_rate); + +/** Check a Vorbis comment entry name to see if it conforms to the Vorbis + * comment specification. + * + * Vorbis comment names must be composed only of characters from + * [0x20-0x3C,0x3E-0x7D]. + * + * \param name A NUL-terminated string to be checked. + * \assert + * \code name != NULL \endcode + * \retval FLAC__bool + * \c false if entry name is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_name_is_legal(const char *name); + +/** Check a Vorbis comment entry value to see if it conforms to the Vorbis + * comment specification. + * + * Vorbis comment values must be valid UTF-8 sequences. + * + * \param value A string to be checked. + * \param length A the length of \a value in bytes. May be + * \c (unsigned)(-1) to indicate that \a value is a plain + * UTF-8 NUL-terminated string. + * \assert + * \code value != NULL \endcode + * \retval FLAC__bool + * \c false if entry name is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_value_is_legal(const FLAC__byte *value, unsigned length); + +/** Check a Vorbis comment entry to see if it conforms to the Vorbis + * comment specification. + * + * Vorbis comment entries must be of the form 'name=value', and 'name' and + * 'value' must be legal according to + * FLAC__format_vorbiscomment_entry_name_is_legal() and + * FLAC__format_vorbiscomment_entry_value_is_legal() respectively. + * + * \param entry An entry to be checked. + * \param length The length of \a entry in bytes. + * \assert + * \code value != NULL \endcode + * \retval FLAC__bool + * \c false if entry name is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_is_legal(const FLAC__byte *entry, unsigned length); + +/** Check a seek table to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * seek table. + * + * \param seek_table A pointer to a seek table to be checked. + * \assert + * \code seek_table != NULL \endcode + * \retval FLAC__bool + * \c false if seek table is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_seektable_is_legal(const FLAC__StreamMetadata_SeekTable *seek_table); + +/** Sort a seek table's seek points according to the format specification. + * This includes a "unique-ification" step to remove duplicates, i.e. + * seek points with identical \a sample_number values. Duplicate seek + * points are converted into placeholder points and sorted to the end of + * the table. + * + * \param seek_table A pointer to a seek table to be sorted. + * \assert + * \code seek_table != NULL \endcode + * \retval unsigned + * The number of duplicate seek points converted into placeholders. + */ +FLAC_API unsigned FLAC__format_seektable_sort(FLAC__StreamMetadata_SeekTable *seek_table); + +/** Check a cue sheet to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * cue sheet. + * + * \param cue_sheet A pointer to an existing cue sheet to be checked. + * \param check_cd_da_subset If \c true, check CUESHEET against more + * stringent requirements for a CD-DA (audio) disc. + * \param violation Address of a pointer to a string. If there is a + * violation, a pointer to a string explanation of the + * violation will be returned here. \a violation may be + * \c NULL if you don't need the returned string. Do not + * free the returned string; it will always point to static + * data. + * \assert + * \code cue_sheet != NULL \endcode + * \retval FLAC__bool + * \c false if cue sheet is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_cuesheet_is_legal(const FLAC__StreamMetadata_CueSheet *cue_sheet, FLAC__bool check_cd_da_subset, const char **violation); + +/** Check picture data to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * PICTURE block. + * + * \param picture A pointer to existing picture data to be checked. + * \param violation Address of a pointer to a string. If there is a + * violation, a pointer to a string explanation of the + * violation will be returned here. \a violation may be + * \c NULL if you don't need the returned string. Do not + * free the returned string; it will always point to static + * data. + * \assert + * \code picture != NULL \endcode + * \retval FLAC__bool + * \c false if picture data is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__format_picture_is_legal(const FLAC__StreamMetadata_Picture *picture, const char **violation); + +/* \} */ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/FLAC/metadata.h b/src/libflac/FLAC/metadata.h new file mode 100644 index 0000000..4e18cd6 --- /dev/null +++ b/src/libflac/FLAC/metadata.h @@ -0,0 +1,2182 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__METADATA_H +#define FLAC__METADATA_H + +#include /* for off_t */ +#include "export.h" +#include "callback.h" +#include "format.h" + +/* -------------------------------------------------------------------- + (For an example of how all these routines are used, see the source + code for the unit tests in src/test_libFLAC/metadata_*.c, or + metaflac in src/metaflac/) + ------------------------------------------------------------------*/ + +/** \file include/FLAC/metadata.h + * + * \brief + * This module provides functions for creating and manipulating FLAC + * metadata blocks in memory, and three progressively more powerful + * interfaces for traversing and editing metadata in FLAC files. + * + * See the detailed documentation for each interface in the + * \link flac_metadata metadata \endlink module. + */ + +/** \defgroup flac_metadata FLAC/metadata.h: metadata interfaces + * \ingroup flac + * + * \brief + * This module provides functions for creating and manipulating FLAC + * metadata blocks in memory, and three progressively more powerful + * interfaces for traversing and editing metadata in native FLAC files. + * Note that currently only the Chain interface (level 2) supports Ogg + * FLAC files, and it is read-only i.e. no writing back changed + * metadata to file. + * + * There are three metadata interfaces of increasing complexity: + * + * Level 0: + * Read-only access to the STREAMINFO, VORBIS_COMMENT, CUESHEET, and + * PICTURE blocks. + * + * Level 1: + * Read-write access to all metadata blocks. This level is write- + * efficient in most cases (more on this below), and uses less memory + * than level 2. + * + * Level 2: + * Read-write access to all metadata blocks. This level is write- + * efficient in all cases, but uses more memory since all metadata for + * the whole file is read into memory and manipulated before writing + * out again. + * + * What do we mean by efficient? Since FLAC metadata appears at the + * beginning of the file, when writing metadata back to a FLAC file + * it is possible to grow or shrink the metadata such that the entire + * file must be rewritten. However, if the size remains the same during + * changes or PADDING blocks are utilized, only the metadata needs to be + * overwritten, which is much faster. + * + * Efficient means the whole file is rewritten at most one time, and only + * when necessary. Level 1 is not efficient only in the case that you + * cause more than one metadata block to grow or shrink beyond what can + * be accomodated by padding. In this case you should probably use level + * 2, which allows you to edit all the metadata for a file in memory and + * write it out all at once. + * + * All levels know how to skip over and not disturb an ID3v2 tag at the + * front of the file. + * + * All levels access files via their filenames. In addition, level 2 + * has additional alternative read and write functions that take an I/O + * handle and callbacks, for situations where access by filename is not + * possible. + * + * In addition to the three interfaces, this module defines functions for + * creating and manipulating various metadata objects in memory. As we see + * from the Format module, FLAC metadata blocks in memory are very primitive + * structures for storing information in an efficient way. Reading + * information from the structures is easy but creating or modifying them + * directly is more complex. The metadata object routines here facilitate + * this by taking care of the consistency and memory management drudgery. + * + * Unless you will be using the level 1 or 2 interfaces to modify existing + * metadata however, you will not probably not need these. + * + * From a dependency standpoint, none of the encoders or decoders require + * the metadata module. This is so that embedded users can strip out the + * metadata module from libFLAC to reduce the size and complexity. + */ + +#ifdef __cplusplus +extern "C" { +#endif + + +/** \defgroup flac_metadata_level0 FLAC/metadata.h: metadata level 0 interface + * \ingroup flac_metadata + * + * \brief + * The level 0 interface consists of individual routines to read the + * STREAMINFO, VORBIS_COMMENT, CUESHEET, and PICTURE blocks, requiring + * only a filename. + * + * They try to skip any ID3v2 tag at the head of the file. + * + * \{ + */ + +/** Read the STREAMINFO metadata block of the given FLAC file. This function + * will try to skip any ID3v2 tag at the head of the file. + * + * \param filename The path to the FLAC file to read. + * \param streaminfo A pointer to space for the STREAMINFO block. Since + * FLAC__StreamMetadata is a simple structure with no + * memory allocation involved, you pass the address of + * an existing structure. It need not be initialized. + * \assert + * \code filename != NULL \endcode + * \code streaminfo != NULL \endcode + * \retval FLAC__bool + * \c true if a valid STREAMINFO block was read from \a filename. Returns + * \c false if there was a memory allocation error, a file decoder error, + * or the file contained no STREAMINFO block. (A memory allocation error + * is possible because this function must set up a file decoder.) + */ +FLAC_API FLAC__bool FLAC__metadata_get_streaminfo(const char *filename, FLAC__StreamMetadata *streaminfo); + +/** Read the VORBIS_COMMENT metadata block of the given FLAC file. This + * function will try to skip any ID3v2 tag at the head of the file. + * + * \param filename The path to the FLAC file to read. + * \param tags The address where the returned pointer will be + * stored. The \a tags object must be deleted by + * the caller using FLAC__metadata_object_delete(). + * \assert + * \code filename != NULL \endcode + * \code tags != NULL \endcode + * \retval FLAC__bool + * \c true if a valid VORBIS_COMMENT block was read from \a filename, + * and \a *tags will be set to the address of the metadata structure. + * Returns \c false if there was a memory allocation error, a file + * decoder error, or the file contained no VORBIS_COMMENT block, and + * \a *tags will be set to \c NULL. + */ +FLAC_API FLAC__bool FLAC__metadata_get_tags(const char *filename, FLAC__StreamMetadata **tags); + +/** Read the CUESHEET metadata block of the given FLAC file. This + * function will try to skip any ID3v2 tag at the head of the file. + * + * \param filename The path to the FLAC file to read. + * \param cuesheet The address where the returned pointer will be + * stored. The \a cuesheet object must be deleted by + * the caller using FLAC__metadata_object_delete(). + * \assert + * \code filename != NULL \endcode + * \code cuesheet != NULL \endcode + * \retval FLAC__bool + * \c true if a valid CUESHEET block was read from \a filename, + * and \a *cuesheet will be set to the address of the metadata + * structure. Returns \c false if there was a memory allocation + * error, a file decoder error, or the file contained no CUESHEET + * block, and \a *cuesheet will be set to \c NULL. + */ +FLAC_API FLAC__bool FLAC__metadata_get_cuesheet(const char *filename, FLAC__StreamMetadata **cuesheet); + +/** Read a PICTURE metadata block of the given FLAC file. This + * function will try to skip any ID3v2 tag at the head of the file. + * Since there can be more than one PICTURE block in a file, this + * function takes a number of parameters that act as constraints to + * the search. The PICTURE block with the largest area matching all + * the constraints will be returned, or \a *picture will be set to + * \c NULL if there was no such block. + * + * \param filename The path to the FLAC file to read. + * \param picture The address where the returned pointer will be + * stored. The \a picture object must be deleted by + * the caller using FLAC__metadata_object_delete(). + * \param type The desired picture type. Use \c -1 to mean + * "any type". + * \param mime_type The desired MIME type, e.g. "image/jpeg". The + * string will be matched exactly. Use \c NULL to + * mean "any MIME type". + * \param description The desired description. The string will be + * matched exactly. Use \c NULL to mean "any + * description". + * \param max_width The maximum width in pixels desired. Use + * \c (unsigned)(-1) to mean "any width". + * \param max_height The maximum height in pixels desired. Use + * \c (unsigned)(-1) to mean "any height". + * \param max_depth The maximum color depth in bits-per-pixel desired. + * Use \c (unsigned)(-1) to mean "any depth". + * \param max_colors The maximum number of colors desired. Use + * \c (unsigned)(-1) to mean "any number of colors". + * \assert + * \code filename != NULL \endcode + * \code picture != NULL \endcode + * \retval FLAC__bool + * \c true if a valid PICTURE block was read from \a filename, + * and \a *picture will be set to the address of the metadata + * structure. Returns \c false if there was a memory allocation + * error, a file decoder error, or the file contained no PICTURE + * block, and \a *picture will be set to \c NULL. + */ +FLAC_API FLAC__bool FLAC__metadata_get_picture(const char *filename, FLAC__StreamMetadata **picture, FLAC__StreamMetadata_Picture_Type type, const char *mime_type, const FLAC__byte *description, unsigned max_width, unsigned max_height, unsigned max_depth, unsigned max_colors); + +/* \} */ + + +/** \defgroup flac_metadata_level1 FLAC/metadata.h: metadata level 1 interface + * \ingroup flac_metadata + * + * \brief + * The level 1 interface provides read-write access to FLAC file metadata and + * operates directly on the FLAC file. + * + * The general usage of this interface is: + * + * - Create an iterator using FLAC__metadata_simple_iterator_new() + * - Attach it to a file using FLAC__metadata_simple_iterator_init() and check + * the exit code. Call FLAC__metadata_simple_iterator_is_writable() to + * see if the file is writable, or only read access is allowed. + * - Use FLAC__metadata_simple_iterator_next() and + * FLAC__metadata_simple_iterator_prev() to traverse the blocks. + * This is does not read the actual blocks themselves. + * FLAC__metadata_simple_iterator_next() is relatively fast. + * FLAC__metadata_simple_iterator_prev() is slower since it needs to search + * forward from the front of the file. + * - Use FLAC__metadata_simple_iterator_get_block_type() or + * FLAC__metadata_simple_iterator_get_block() to access the actual data at + * the current iterator position. The returned object is yours to modify + * and free. + * - Use FLAC__metadata_simple_iterator_set_block() to write a modified block + * back. You must have write permission to the original file. Make sure to + * read the whole comment to FLAC__metadata_simple_iterator_set_block() + * below. + * - Use FLAC__metadata_simple_iterator_insert_block_after() to add new blocks. + * Use the object creation functions from + * \link flac_metadata_object here \endlink to generate new objects. + * - Use FLAC__metadata_simple_iterator_delete_block() to remove the block + * currently referred to by the iterator, or replace it with padding. + * - Destroy the iterator with FLAC__metadata_simple_iterator_delete() when + * finished. + * + * \note + * The FLAC file remains open the whole time between + * FLAC__metadata_simple_iterator_init() and + * FLAC__metadata_simple_iterator_delete(), so make sure you are not altering + * the file during this time. + * + * \note + * Do not modify the \a is_last, \a length, or \a type fields of returned + * FLAC__StreamMetadata objects. These are managed automatically. + * + * \note + * If any of the modification functions + * (FLAC__metadata_simple_iterator_set_block(), + * FLAC__metadata_simple_iterator_delete_block(), + * FLAC__metadata_simple_iterator_insert_block_after(), etc.) return \c false, + * you should delete the iterator as it may no longer be valid. + * + * \{ + */ + +struct FLAC__Metadata_SimpleIterator; +/** The opaque structure definition for the level 1 iterator type. + * See the + * \link flac_metadata_level1 metadata level 1 module \endlink + * for a detailed description. + */ +typedef struct FLAC__Metadata_SimpleIterator FLAC__Metadata_SimpleIterator; + +/** Status type for FLAC__Metadata_SimpleIterator. + * + * The iterator's current status can be obtained by calling FLAC__metadata_simple_iterator_status(). + */ +typedef enum { + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK = 0, + /**< The iterator is in the normal OK state */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT, + /**< The data passed into a function violated the function's usage criteria */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ERROR_OPENING_FILE, + /**< The iterator could not open the target file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_A_FLAC_FILE, + /**< The iterator could not find the FLAC signature at the start of the file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_WRITABLE, + /**< The iterator tried to write to a file that was not writable */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_BAD_METADATA, + /**< The iterator encountered input that does not conform to the FLAC metadata specification */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR, + /**< The iterator encountered an error while reading the FLAC file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR, + /**< The iterator encountered an error while seeking in the FLAC file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_WRITE_ERROR, + /**< The iterator encountered an error while writing the FLAC file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_RENAME_ERROR, + /**< The iterator encountered an error renaming the FLAC file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_UNLINK_ERROR, + /**< The iterator encountered an error removing the temporary file */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_MEMORY_ALLOCATION_ERROR, + /**< Memory allocation failed */ + + FLAC__METADATA_SIMPLE_ITERATOR_STATUS_INTERNAL_ERROR + /**< The caller violated an assertion or an unexpected error occurred */ + +} FLAC__Metadata_SimpleIteratorStatus; + +/** Maps a FLAC__Metadata_SimpleIteratorStatus to a C string. + * + * Using a FLAC__Metadata_SimpleIteratorStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__Metadata_SimpleIteratorStatusString[]; + + +/** Create a new iterator instance. + * + * \retval FLAC__Metadata_SimpleIterator* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__Metadata_SimpleIterator *FLAC__metadata_simple_iterator_new(void); + +/** Free an iterator instance. Deletes the object pointed to by \a iterator. + * + * \param iterator A pointer to an existing iterator. + * \assert + * \code iterator != NULL \endcode + */ +FLAC_API void FLAC__metadata_simple_iterator_delete(FLAC__Metadata_SimpleIterator *iterator); + +/** Get the current status of the iterator. Call this after a function + * returns \c false to get the reason for the error. Also resets the status + * to FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK. + * + * \param iterator A pointer to an existing iterator. + * \assert + * \code iterator != NULL \endcode + * \retval FLAC__Metadata_SimpleIteratorStatus + * The current status of the iterator. + */ +FLAC_API FLAC__Metadata_SimpleIteratorStatus FLAC__metadata_simple_iterator_status(FLAC__Metadata_SimpleIterator *iterator); + +/** Initialize the iterator to point to the first metadata block in the + * given FLAC file. + * + * \param iterator A pointer to an existing iterator. + * \param filename The path to the FLAC file. + * \param read_only If \c true, the FLAC file will be opened + * in read-only mode; if \c false, the FLAC + * file will be opened for edit even if no + * edits are performed. + * \param preserve_file_stats If \c true, the owner and modification + * time will be preserved even if the FLAC + * file is written to. + * \assert + * \code iterator != NULL \endcode + * \code filename != NULL \endcode + * \retval FLAC__bool + * \c false if a memory allocation error occurs, the file can't be + * opened, or another error occurs, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_init(FLAC__Metadata_SimpleIterator *iterator, const char *filename, FLAC__bool read_only, FLAC__bool preserve_file_stats); + +/** Returns \c true if the FLAC file is writable. If \c false, calls to + * FLAC__metadata_simple_iterator_set_block() and + * FLAC__metadata_simple_iterator_insert_block_after() will fail. + * + * \param iterator A pointer to an existing iterator. + * \assert + * \code iterator != NULL \endcode + * \retval FLAC__bool + * See above. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_is_writable(const FLAC__Metadata_SimpleIterator *iterator); + +/** Moves the iterator forward one metadata block, returning \c false if + * already at the end. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__bool + * \c false if already at the last metadata block of the chain, else + * \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_next(FLAC__Metadata_SimpleIterator *iterator); + +/** Moves the iterator backward one metadata block, returning \c false if + * already at the beginning. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__bool + * \c false if already at the first metadata block of the chain, else + * \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_prev(FLAC__Metadata_SimpleIterator *iterator); + +/** Returns a flag telling if the current metadata block is the last. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__bool + * \c true if the current metadata block is the last in the file, + * else \c false. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_is_last(const FLAC__Metadata_SimpleIterator *iterator); + +/** Get the offset of the metadata block at the current position. This + * avoids reading the actual block data which can save time for large + * blocks. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval off_t + * The offset of the metadata block at the current iterator position. + * This is the byte offset relative to the beginning of the file of + * the current metadata block's header. + */ +FLAC_API off_t FLAC__metadata_simple_iterator_get_block_offset(const FLAC__Metadata_SimpleIterator *iterator); + +/** Get the type of the metadata block at the current position. This + * avoids reading the actual block data which can save time for large + * blocks. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__MetadataType + * The type of the metadata block at the current iterator position. + */ +FLAC_API FLAC__MetadataType FLAC__metadata_simple_iterator_get_block_type(const FLAC__Metadata_SimpleIterator *iterator); + +/** Get the length of the metadata block at the current position. This + * avoids reading the actual block data which can save time for large + * blocks. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval unsigned + * The length of the metadata block at the current iterator position. + * The is same length as that in the + * metadata block header, + * i.e. the length of the metadata body that follows the header. + */ +FLAC_API unsigned FLAC__metadata_simple_iterator_get_block_length(const FLAC__Metadata_SimpleIterator *iterator); + +/** Get the application ID of the \c APPLICATION block at the current + * position. This avoids reading the actual block data which can save + * time for large blocks. + * + * \param iterator A pointer to an existing initialized iterator. + * \param id A pointer to a buffer of at least \c 4 bytes where + * the ID will be stored. + * \assert + * \code iterator != NULL \endcode + * \code id != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__bool + * \c true if the ID was successfully read, else \c false, in which + * case you should check FLAC__metadata_simple_iterator_status() to + * find out why. If the status is + * \c FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT, then the + * current metadata block is not an \c APPLICATION block. Otherwise + * if the status is + * \c FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR or + * \c FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR, an I/O error + * occurred and the iterator can no longer be used. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_get_application_id(FLAC__Metadata_SimpleIterator *iterator, FLAC__byte *id); + +/** Get the metadata block at the current position. You can modify the + * block but must use FLAC__metadata_simple_iterator_set_block() to + * write it back to the FLAC file. + * + * You must call FLAC__metadata_object_delete() on the returned object + * when you are finished with it. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__StreamMetadata* + * The current metadata block, or \c NULL if there was a memory + * allocation error. + */ +FLAC_API FLAC__StreamMetadata *FLAC__metadata_simple_iterator_get_block(FLAC__Metadata_SimpleIterator *iterator); + +/** Write a block back to the FLAC file. This function tries to be + * as efficient as possible; how the block is actually written is + * shown by the following: + * + * Existing block is a STREAMINFO block and the new block is a + * STREAMINFO block: the new block is written in place. Make sure + * you know what you're doing when changing the values of a + * STREAMINFO block. + * + * Existing block is a STREAMINFO block and the new block is a + * not a STREAMINFO block: this is an error since the first block + * must be a STREAMINFO block. Returns \c false without altering the + * file. + * + * Existing block is not a STREAMINFO block and the new block is a + * STREAMINFO block: this is an error since there may be only one + * STREAMINFO block. Returns \c false without altering the file. + * + * Existing block and new block are the same length: the existing + * block will be replaced by the new block, written in place. + * + * Existing block is longer than new block: if use_padding is \c true, + * the existing block will be overwritten in place with the new + * block followed by a PADDING block, if possible, to make the total + * size the same as the existing block. Remember that a padding + * block requires at least four bytes so if the difference in size + * between the new block and existing block is less than that, the + * entire file will have to be rewritten, using the new block's + * exact size. If use_padding is \c false, the entire file will be + * rewritten, replacing the existing block by the new block. + * + * Existing block is shorter than new block: if use_padding is \c true, + * the function will try and expand the new block into the following + * PADDING block, if it exists and doing so won't shrink the PADDING + * block to less than 4 bytes. If there is no following PADDING + * block, or it will shrink to less than 4 bytes, or use_padding is + * \c false, the entire file is rewritten, replacing the existing block + * with the new block. Note that in this case any following PADDING + * block is preserved as is. + * + * After writing the block, the iterator will remain in the same + * place, i.e. pointing to the new block. + * + * \param iterator A pointer to an existing initialized iterator. + * \param block The block to set. + * \param use_padding See above. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \code block != NULL \endcode + * \retval FLAC__bool + * \c true if successful, else \c false. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_set_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding); + +/** This is similar to FLAC__metadata_simple_iterator_set_block() + * except that instead of writing over an existing block, it appends + * a block after the existing block. \a use_padding is again used to + * tell the function to try an expand into following padding in an + * attempt to avoid rewriting the entire file. + * + * This function will fail and return \c false if given a STREAMINFO + * block. + * + * After writing the block, the iterator will be pointing to the + * new block. + * + * \param iterator A pointer to an existing initialized iterator. + * \param block The block to set. + * \param use_padding See above. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \code block != NULL \endcode + * \retval FLAC__bool + * \c true if successful, else \c false. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_insert_block_after(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding); + +/** Deletes the block at the current position. This will cause the + * entire FLAC file to be rewritten, unless \a use_padding is \c true, + * in which case the block will be replaced by an equal-sized PADDING + * block. The iterator will be left pointing to the block before the + * one just deleted. + * + * You may not delete the STREAMINFO block. + * + * \param iterator A pointer to an existing initialized iterator. + * \param use_padding See above. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_simple_iterator_init() + * \retval FLAC__bool + * \c true if successful, else \c false. + */ +FLAC_API FLAC__bool FLAC__metadata_simple_iterator_delete_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__bool use_padding); + +/* \} */ + + +/** \defgroup flac_metadata_level2 FLAC/metadata.h: metadata level 2 interface + * \ingroup flac_metadata + * + * \brief + * The level 2 interface provides read-write access to FLAC file metadata; + * all metadata is read into memory, operated on in memory, and then written + * to file, which is more efficient than level 1 when editing multiple blocks. + * + * Currently Ogg FLAC is supported for read only, via + * FLAC__metadata_chain_read_ogg() but a subsequent + * FLAC__metadata_chain_write() will fail. + * + * The general usage of this interface is: + * + * - Create a new chain using FLAC__metadata_chain_new(). A chain is a + * linked list of FLAC metadata blocks. + * - Read all metadata into the chain from a FLAC file using + * FLAC__metadata_chain_read() or FLAC__metadata_chain_read_ogg() and + * check the status. + * - Optionally, consolidate the padding using + * FLAC__metadata_chain_merge_padding() or + * FLAC__metadata_chain_sort_padding(). + * - Create a new iterator using FLAC__metadata_iterator_new() + * - Initialize the iterator to point to the first element in the chain + * using FLAC__metadata_iterator_init() + * - Traverse the chain using FLAC__metadata_iterator_next and + * FLAC__metadata_iterator_prev(). + * - Get a block for reading or modification using + * FLAC__metadata_iterator_get_block(). The pointer to the object + * inside the chain is returned, so the block is yours to modify. + * Changes will be reflected in the FLAC file when you write the + * chain. You can also add and delete blocks (see functions below). + * - When done, write out the chain using FLAC__metadata_chain_write(). + * Make sure to read the whole comment to the function below. + * - Delete the chain using FLAC__metadata_chain_delete(). + * + * \note + * Even though the FLAC file is not open while the chain is being + * manipulated, you must not alter the file externally during + * this time. The chain assumes the FLAC file will not change + * between the time of FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg() + * and FLAC__metadata_chain_write(). + * + * \note + * Do not modify the is_last, length, or type fields of returned + * FLAC__StreamMetadata objects. These are managed automatically. + * + * \note + * The metadata objects returned by FLAC__metadata_iterator_get_block() + * are owned by the chain; do not FLAC__metadata_object_delete() them. + * In the same way, blocks passed to FLAC__metadata_iterator_set_block() + * become owned by the chain and they will be deleted when the chain is + * deleted. + * + * \{ + */ + +struct FLAC__Metadata_Chain; +/** The opaque structure definition for the level 2 chain type. + */ +typedef struct FLAC__Metadata_Chain FLAC__Metadata_Chain; + +struct FLAC__Metadata_Iterator; +/** The opaque structure definition for the level 2 iterator type. + */ +typedef struct FLAC__Metadata_Iterator FLAC__Metadata_Iterator; + +typedef enum { + FLAC__METADATA_CHAIN_STATUS_OK = 0, + /**< The chain is in the normal OK state */ + + FLAC__METADATA_CHAIN_STATUS_ILLEGAL_INPUT, + /**< The data passed into a function violated the function's usage criteria */ + + FLAC__METADATA_CHAIN_STATUS_ERROR_OPENING_FILE, + /**< The chain could not open the target file */ + + FLAC__METADATA_CHAIN_STATUS_NOT_A_FLAC_FILE, + /**< The chain could not find the FLAC signature at the start of the file */ + + FLAC__METADATA_CHAIN_STATUS_NOT_WRITABLE, + /**< The chain tried to write to a file that was not writable */ + + FLAC__METADATA_CHAIN_STATUS_BAD_METADATA, + /**< The chain encountered input that does not conform to the FLAC metadata specification */ + + FLAC__METADATA_CHAIN_STATUS_READ_ERROR, + /**< The chain encountered an error while reading the FLAC file */ + + FLAC__METADATA_CHAIN_STATUS_SEEK_ERROR, + /**< The chain encountered an error while seeking in the FLAC file */ + + FLAC__METADATA_CHAIN_STATUS_WRITE_ERROR, + /**< The chain encountered an error while writing the FLAC file */ + + FLAC__METADATA_CHAIN_STATUS_RENAME_ERROR, + /**< The chain encountered an error renaming the FLAC file */ + + FLAC__METADATA_CHAIN_STATUS_UNLINK_ERROR, + /**< The chain encountered an error removing the temporary file */ + + FLAC__METADATA_CHAIN_STATUS_MEMORY_ALLOCATION_ERROR, + /**< Memory allocation failed */ + + FLAC__METADATA_CHAIN_STATUS_INTERNAL_ERROR, + /**< The caller violated an assertion or an unexpected error occurred */ + + FLAC__METADATA_CHAIN_STATUS_INVALID_CALLBACKS, + /**< One or more of the required callbacks was NULL */ + + FLAC__METADATA_CHAIN_STATUS_READ_WRITE_MISMATCH, + /**< FLAC__metadata_chain_write() was called on a chain read by + * FLAC__metadata_chain_read_with_callbacks()/FLAC__metadata_chain_read_ogg_with_callbacks(), + * or + * FLAC__metadata_chain_write_with_callbacks()/FLAC__metadata_chain_write_with_callbacks_and_tempfile() + * was called on a chain read by + * FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg(). + * Matching read/write methods must always be used. */ + + FLAC__METADATA_CHAIN_STATUS_WRONG_WRITE_CALL + /**< FLAC__metadata_chain_write_with_callbacks() was called when the + * chain write requires a tempfile; use + * FLAC__metadata_chain_write_with_callbacks_and_tempfile() instead. + * Or, FLAC__metadata_chain_write_with_callbacks_and_tempfile() was + * called when the chain write does not require a tempfile; use + * FLAC__metadata_chain_write_with_callbacks() instead. + * Always check FLAC__metadata_chain_check_if_tempfile_needed() + * before writing via callbacks. */ + +} FLAC__Metadata_ChainStatus; + +/** Maps a FLAC__Metadata_ChainStatus to a C string. + * + * Using a FLAC__Metadata_ChainStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__Metadata_ChainStatusString[]; + +/*********** FLAC__Metadata_Chain ***********/ + +/** Create a new chain instance. + * + * \retval FLAC__Metadata_Chain* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__Metadata_Chain *FLAC__metadata_chain_new(void); + +/** Free a chain instance. Deletes the object pointed to by \a chain. + * + * \param chain A pointer to an existing chain. + * \assert + * \code chain != NULL \endcode + */ +FLAC_API void FLAC__metadata_chain_delete(FLAC__Metadata_Chain *chain); + +/** Get the current status of the chain. Call this after a function + * returns \c false to get the reason for the error. Also resets the + * status to FLAC__METADATA_CHAIN_STATUS_OK. + * + * \param chain A pointer to an existing chain. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__Metadata_ChainStatus + * The current status of the chain. + */ +FLAC_API FLAC__Metadata_ChainStatus FLAC__metadata_chain_status(FLAC__Metadata_Chain *chain); + +/** Read all metadata from a FLAC file into the chain. + * + * \param chain A pointer to an existing chain. + * \param filename The path to the FLAC file to read. + * \assert + * \code chain != NULL \endcode + * \code filename != NULL \endcode + * \retval FLAC__bool + * \c true if a valid list of metadata blocks was read from + * \a filename, else \c false. On failure, check the status with + * FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_read(FLAC__Metadata_Chain *chain, const char *filename); + +/** Read all metadata from an Ogg FLAC file into the chain. + * + * \note Ogg FLAC metadata data writing is not supported yet and + * FLAC__metadata_chain_write() will fail. + * + * \param chain A pointer to an existing chain. + * \param filename The path to the Ogg FLAC file to read. + * \assert + * \code chain != NULL \endcode + * \code filename != NULL \endcode + * \retval FLAC__bool + * \c true if a valid list of metadata blocks was read from + * \a filename, else \c false. On failure, check the status with + * FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_read_ogg(FLAC__Metadata_Chain *chain, const char *filename); + +/** Read all metadata from a FLAC stream into the chain via I/O callbacks. + * + * The \a handle need only be open for reading, but must be seekable. + * The equivalent minimum stdio fopen() file mode is \c "r" (or \c "rb" + * for Windows). + * + * \param chain A pointer to an existing chain. + * \param handle The I/O handle of the FLAC stream to read. The + * handle will NOT be closed after the metadata is read; + * that is the duty of the caller. + * \param callbacks + * A set of callbacks to use for I/O. The mandatory + * callbacks are \a read, \a seek, and \a tell. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if a valid list of metadata blocks was read from + * \a handle, else \c false. On failure, check the status with + * FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_read_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks); + +/** Read all metadata from an Ogg FLAC stream into the chain via I/O callbacks. + * + * The \a handle need only be open for reading, but must be seekable. + * The equivalent minimum stdio fopen() file mode is \c "r" (or \c "rb" + * for Windows). + * + * \note Ogg FLAC metadata data writing is not supported yet and + * FLAC__metadata_chain_write() will fail. + * + * \param chain A pointer to an existing chain. + * \param handle The I/O handle of the Ogg FLAC stream to read. The + * handle will NOT be closed after the metadata is read; + * that is the duty of the caller. + * \param callbacks + * A set of callbacks to use for I/O. The mandatory + * callbacks are \a read, \a seek, and \a tell. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if a valid list of metadata blocks was read from + * \a handle, else \c false. On failure, check the status with + * FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_read_ogg_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks); + +/** Checks if writing the given chain would require the use of a + * temporary file, or if it could be written in place. + * + * Under certain conditions, padding can be utilized so that writing + * edited metadata back to the FLAC file does not require rewriting the + * entire file. If rewriting is required, then a temporary workfile is + * required. When writing metadata using callbacks, you must check + * this function to know whether to call + * FLAC__metadata_chain_write_with_callbacks() or + * FLAC__metadata_chain_write_with_callbacks_and_tempfile(). When + * writing with FLAC__metadata_chain_write(), the temporary file is + * handled internally. + * + * \param chain A pointer to an existing chain. + * \param use_padding + * Whether or not padding will be allowed to be used + * during the write. The value of \a use_padding given + * here must match the value later passed to + * FLAC__metadata_chain_write_with_callbacks() or + * FLAC__metadata_chain_write_with_callbacks_with_tempfile(). + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if writing the current chain would require a tempfile, or + * \c false if metadata can be written in place. + */ +FLAC_API FLAC__bool FLAC__metadata_chain_check_if_tempfile_needed(FLAC__Metadata_Chain *chain, FLAC__bool use_padding); + +/** Write all metadata out to the FLAC file. This function tries to be as + * efficient as possible; how the metadata is actually written is shown by + * the following: + * + * If the current chain is the same size as the existing metadata, the new + * data is written in place. + * + * If the current chain is longer than the existing metadata, and + * \a use_padding is \c true, and the last block is a PADDING block of + * sufficient length, the function will truncate the final padding block + * so that the overall size of the metadata is the same as the existing + * metadata, and then just rewrite the metadata. Otherwise, if not all of + * the above conditions are met, the entire FLAC file must be rewritten. + * If you want to use padding this way it is a good idea to call + * FLAC__metadata_chain_sort_padding() first so that you have the maximum + * amount of padding to work with, unless you need to preserve ordering + * of the PADDING blocks for some reason. + * + * If the current chain is shorter than the existing metadata, and + * \a use_padding is \c true, and the final block is a PADDING block, the padding + * is extended to make the overall size the same as the existing data. If + * \a use_padding is \c true and the last block is not a PADDING block, a new + * PADDING block is added to the end of the new data to make it the same + * size as the existing data (if possible, see the note to + * FLAC__metadata_simple_iterator_set_block() about the four byte limit) + * and the new data is written in place. If none of the above apply or + * \a use_padding is \c false, the entire FLAC file is rewritten. + * + * If \a preserve_file_stats is \c true, the owner and modification time will + * be preserved even if the FLAC file is written. + * + * For this write function to be used, the chain must have been read with + * FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg(), not + * FLAC__metadata_chain_read_with_callbacks()/FLAC__metadata_chain_read_ogg_with_callbacks(). + * + * \param chain A pointer to an existing chain. + * \param use_padding See above. + * \param preserve_file_stats See above. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if the write succeeded, else \c false. On failure, + * check the status with FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_write(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__bool preserve_file_stats); + +/** Write all metadata out to a FLAC stream via callbacks. + * + * (See FLAC__metadata_chain_write() for the details on how padding is + * used to write metadata in place if possible.) + * + * The \a handle must be open for updating and be seekable. The + * equivalent minimum stdio fopen() file mode is \c "r+" (or \c "r+b" + * for Windows). + * + * For this write function to be used, the chain must have been read with + * FLAC__metadata_chain_read_with_callbacks()/FLAC__metadata_chain_read_ogg_with_callbacks(), + * not FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg(). + * Also, FLAC__metadata_chain_check_if_tempfile_needed() must have returned + * \c false. + * + * \param chain A pointer to an existing chain. + * \param use_padding See FLAC__metadata_chain_write() + * \param handle The I/O handle of the FLAC stream to write. The + * handle will NOT be closed after the metadata is + * written; that is the duty of the caller. + * \param callbacks A set of callbacks to use for I/O. The mandatory + * callbacks are \a write and \a seek. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if the write succeeded, else \c false. On failure, + * check the status with FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_write_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks); + +/** Write all metadata out to a FLAC stream via callbacks. + * + * (See FLAC__metadata_chain_write() for the details on how padding is + * used to write metadata in place if possible.) + * + * This version of the write-with-callbacks function must be used when + * FLAC__metadata_chain_check_if_tempfile_needed() returns true. In + * this function, you must supply an I/O handle corresponding to the + * FLAC file to edit, and a temporary handle to which the new FLAC + * file will be written. It is the caller's job to move this temporary + * FLAC file on top of the original FLAC file to complete the metadata + * edit. + * + * The \a handle must be open for reading and be seekable. The + * equivalent minimum stdio fopen() file mode is \c "r" (or \c "rb" + * for Windows). + * + * The \a temp_handle must be open for writing. The + * equivalent minimum stdio fopen() file mode is \c "w" (or \c "wb" + * for Windows). It should be an empty stream, or at least positioned + * at the start-of-file (in which case it is the caller's duty to + * truncate it on return). + * + * For this write function to be used, the chain must have been read with + * FLAC__metadata_chain_read_with_callbacks()/FLAC__metadata_chain_read_ogg_with_callbacks(), + * not FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg(). + * Also, FLAC__metadata_chain_check_if_tempfile_needed() must have returned + * \c true. + * + * \param chain A pointer to an existing chain. + * \param use_padding See FLAC__metadata_chain_write() + * \param handle The I/O handle of the original FLAC stream to read. + * The handle will NOT be closed after the metadata is + * written; that is the duty of the caller. + * \param callbacks A set of callbacks to use for I/O on \a handle. + * The mandatory callbacks are \a read, \a seek, and + * \a eof. + * \param temp_handle The I/O handle of the FLAC stream to write. The + * handle will NOT be closed after the metadata is + * written; that is the duty of the caller. + * \param temp_callbacks + * A set of callbacks to use for I/O on temp_handle. + * The only mandatory callback is \a write. + * \assert + * \code chain != NULL \endcode + * \retval FLAC__bool + * \c true if the write succeeded, else \c false. On failure, + * check the status with FLAC__metadata_chain_status(). + */ +FLAC_API FLAC__bool FLAC__metadata_chain_write_with_callbacks_and_tempfile(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks, FLAC__IOHandle temp_handle, FLAC__IOCallbacks temp_callbacks); + +/** Merge adjacent PADDING blocks into a single block. + * + * \note This function does not write to the FLAC file, it only + * modifies the chain. + * + * \warning Any iterator on the current chain will become invalid after this + * call. You should delete the iterator and get a new one. + * + * \param chain A pointer to an existing chain. + * \assert + * \code chain != NULL \endcode + */ +FLAC_API void FLAC__metadata_chain_merge_padding(FLAC__Metadata_Chain *chain); + +/** This function will move all PADDING blocks to the end on the metadata, + * then merge them into a single block. + * + * \note This function does not write to the FLAC file, it only + * modifies the chain. + * + * \warning Any iterator on the current chain will become invalid after this + * call. You should delete the iterator and get a new one. + * + * \param chain A pointer to an existing chain. + * \assert + * \code chain != NULL \endcode + */ +FLAC_API void FLAC__metadata_chain_sort_padding(FLAC__Metadata_Chain *chain); + + +/*********** FLAC__Metadata_Iterator ***********/ + +/** Create a new iterator instance. + * + * \retval FLAC__Metadata_Iterator* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__Metadata_Iterator *FLAC__metadata_iterator_new(void); + +/** Free an iterator instance. Deletes the object pointed to by \a iterator. + * + * \param iterator A pointer to an existing iterator. + * \assert + * \code iterator != NULL \endcode + */ +FLAC_API void FLAC__metadata_iterator_delete(FLAC__Metadata_Iterator *iterator); + +/** Initialize the iterator to point to the first metadata block in the + * given chain. + * + * \param iterator A pointer to an existing iterator. + * \param chain A pointer to an existing and initialized (read) chain. + * \assert + * \code iterator != NULL \endcode + * \code chain != NULL \endcode + */ +FLAC_API void FLAC__metadata_iterator_init(FLAC__Metadata_Iterator *iterator, FLAC__Metadata_Chain *chain); + +/** Moves the iterator forward one metadata block, returning \c false if + * already at the end. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__bool + * \c false if already at the last metadata block of the chain, else + * \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_next(FLAC__Metadata_Iterator *iterator); + +/** Moves the iterator backward one metadata block, returning \c false if + * already at the beginning. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__bool + * \c false if already at the first metadata block of the chain, else + * \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_prev(FLAC__Metadata_Iterator *iterator); + +/** Get the type of the metadata block at the current position. + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__MetadataType + * The type of the metadata block at the current iterator position. + */ +FLAC_API FLAC__MetadataType FLAC__metadata_iterator_get_block_type(const FLAC__Metadata_Iterator *iterator); + +/** Get the metadata block at the current position. You can modify + * the block in place but must write the chain before the changes + * are reflected to the FLAC file. You do not need to call + * FLAC__metadata_iterator_set_block() to reflect the changes; + * the pointer returned by FLAC__metadata_iterator_get_block() + * points directly into the chain. + * + * \warning + * Do not call FLAC__metadata_object_delete() on the returned object; + * to delete a block use FLAC__metadata_iterator_delete_block(). + * + * \param iterator A pointer to an existing initialized iterator. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__StreamMetadata* + * The current metadata block. + */ +FLAC_API FLAC__StreamMetadata *FLAC__metadata_iterator_get_block(FLAC__Metadata_Iterator *iterator); + +/** Set the metadata block at the current position, replacing the existing + * block. The new block passed in becomes owned by the chain and it will be + * deleted when the chain is deleted. + * + * \param iterator A pointer to an existing initialized iterator. + * \param block A pointer to a metadata block. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \code block != NULL \endcode + * \retval FLAC__bool + * \c false if the conditions in the above description are not met, or + * a memory allocation error occurs, otherwise \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_set_block(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block); + +/** Removes the current block from the chain. If \a replace_with_padding is + * \c true, the block will instead be replaced with a padding block of equal + * size. You can not delete the STREAMINFO block. The iterator will be + * left pointing to the block before the one just "deleted", even if + * \a replace_with_padding is \c true. + * + * \param iterator A pointer to an existing initialized iterator. + * \param replace_with_padding See above. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__bool + * \c false if the conditions in the above description are not met, + * otherwise \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_delete_block(FLAC__Metadata_Iterator *iterator, FLAC__bool replace_with_padding); + +/** Insert a new block before the current block. You cannot insert a block + * before the first STREAMINFO block. You cannot insert a STREAMINFO block + * as there can be only one, the one that already exists at the head when you + * read in a chain. The chain takes ownership of the new block and it will be + * deleted when the chain is deleted. The iterator will be left pointing to + * the new block. + * + * \param iterator A pointer to an existing initialized iterator. + * \param block A pointer to a metadata block to insert. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__bool + * \c false if the conditions in the above description are not met, or + * a memory allocation error occurs, otherwise \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_insert_block_before(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block); + +/** Insert a new block after the current block. You cannot insert a STREAMINFO + * block as there can be only one, the one that already exists at the head when + * you read in a chain. The chain takes ownership of the new block and it will + * be deleted when the chain is deleted. The iterator will be left pointing to + * the new block. + * + * \param iterator A pointer to an existing initialized iterator. + * \param block A pointer to a metadata block to insert. + * \assert + * \code iterator != NULL \endcode + * \a iterator has been successfully initialized with + * FLAC__metadata_iterator_init() + * \retval FLAC__bool + * \c false if the conditions in the above description are not met, or + * a memory allocation error occurs, otherwise \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_iterator_insert_block_after(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block); + +/* \} */ + + +/** \defgroup flac_metadata_object FLAC/metadata.h: metadata object methods + * \ingroup flac_metadata + * + * \brief + * This module contains methods for manipulating FLAC metadata objects. + * + * Since many are variable length we have to be careful about the memory + * management. We decree that all pointers to data in the object are + * owned by the object and memory-managed by the object. + * + * Use the FLAC__metadata_object_new() and FLAC__metadata_object_delete() + * functions to create all instances. When using the + * FLAC__metadata_object_set_*() functions to set pointers to data, set + * \a copy to \c true to have the function make it's own copy of the data, or + * to \c false to give the object ownership of your data. In the latter case + * your pointer must be freeable by free() and will be free()d when the object + * is FLAC__metadata_object_delete()d. It is legal to pass a null pointer as + * the data pointer to a FLAC__metadata_object_set_*() function as long as + * the length argument is 0 and the \a copy argument is \c false. + * + * The FLAC__metadata_object_new() and FLAC__metadata_object_clone() function + * will return \c NULL in the case of a memory allocation error, otherwise a new + * object. The FLAC__metadata_object_set_*() functions return \c false in the + * case of a memory allocation error. + * + * We don't have the convenience of C++ here, so note that the library relies + * on you to keep the types straight. In other words, if you pass, for + * example, a FLAC__StreamMetadata* that represents a STREAMINFO block to + * FLAC__metadata_object_application_set_data(), you will get an assertion + * failure. + * + * For convenience the FLAC__metadata_object_vorbiscomment_*() functions + * maintain a trailing NUL on each Vorbis comment entry. This is not counted + * toward the length or stored in the stream, but it can make working with plain + * comments (those that don't contain embedded-NULs in the value) easier. + * Entries passed into these functions have trailing NULs added if missing, and + * returned entries are guaranteed to have a trailing NUL. + * + * The FLAC__metadata_object_vorbiscomment_*() functions that take a Vorbis + * comment entry/name/value will first validate that it complies with the Vorbis + * comment specification and return false if it does not. + * + * There is no need to recalculate the length field on metadata blocks you + * have modified. They will be calculated automatically before they are + * written back to a file. + * + * \{ + */ + + +/** Create a new metadata object instance of the given type. + * + * The object will be "empty"; i.e. values and data pointers will be \c 0, + * with the exception of FLAC__METADATA_TYPE_VORBIS_COMMENT, which will have + * the vendor string set (but zero comments). + * + * Do not pass in a value greater than or equal to + * \a FLAC__METADATA_TYPE_UNDEFINED unless you really know what you're + * doing. + * + * \param type Type of object to create + * \retval FLAC__StreamMetadata* + * \c NULL if there was an error allocating memory or the type code is + * greater than FLAC__MAX_METADATA_TYPE_CODE, else the new instance. + */ +FLAC_API FLAC__StreamMetadata *FLAC__metadata_object_new(FLAC__MetadataType type); + +/** Create a copy of an existing metadata object. + * + * The copy is a "deep" copy, i.e. dynamically allocated data within the + * object is also copied. The caller takes ownership of the new block and + * is responsible for freeing it with FLAC__metadata_object_delete(). + * + * \param object Pointer to object to copy. + * \assert + * \code object != NULL \endcode + * \retval FLAC__StreamMetadata* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__StreamMetadata *FLAC__metadata_object_clone(const FLAC__StreamMetadata *object); + +/** Free a metadata object. Deletes the object pointed to by \a object. + * + * The delete is a "deep" delete, i.e. dynamically allocated data within the + * object is also deleted. + * + * \param object A pointer to an existing object. + * \assert + * \code object != NULL \endcode + */ +FLAC_API void FLAC__metadata_object_delete(FLAC__StreamMetadata *object); + +/** Compares two metadata objects. + * + * The compare is "deep", i.e. dynamically allocated data within the + * object is also compared. + * + * \param block1 A pointer to an existing object. + * \param block2 A pointer to an existing object. + * \assert + * \code block1 != NULL \endcode + * \code block2 != NULL \endcode + * \retval FLAC__bool + * \c true if objects are identical, else \c false. + */ +FLAC_API FLAC__bool FLAC__metadata_object_is_equal(const FLAC__StreamMetadata *block1, const FLAC__StreamMetadata *block2); + +/** Sets the application data of an APPLICATION block. + * + * If \a copy is \c true, a copy of the data is stored; otherwise, the object + * takes ownership of the pointer. The existing data will be freed if this + * function is successful, otherwise the original data will remain if \a copy + * is \c true and malloc() fails. + * + * \note It is safe to pass a const pointer to \a data if \a copy is \c true. + * + * \param object A pointer to an existing APPLICATION object. + * \param data A pointer to the data to set. + * \param length The length of \a data in bytes. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_APPLICATION \endcode + * \code (data != NULL && length > 0) || + * (data == NULL && length == 0 && copy == false) \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_application_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, unsigned length, FLAC__bool copy); + +/** Resize the seekpoint array. + * + * If the size shrinks, elements will truncated; if it grows, new placeholder + * points will be added to the end. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param new_num_points The desired length of the array; may be \c 0. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code (object->data.seek_table.points == NULL && object->data.seek_table.num_points == 0) || + * (object->data.seek_table.points != NULL && object->data.seek_table.num_points > 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation error, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_resize_points(FLAC__StreamMetadata *object, unsigned new_num_points); + +/** Set a seekpoint in a seektable. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param point_num Index into seekpoint array to set. + * \param point The point to set. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code object->data.seek_table.num_points > point_num \endcode + */ +FLAC_API void FLAC__metadata_object_seektable_set_point(FLAC__StreamMetadata *object, unsigned point_num, FLAC__StreamMetadata_SeekPoint point); + +/** Insert a seekpoint into a seektable. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param point_num Index into seekpoint array to set. + * \param point The point to set. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code object->data.seek_table.num_points >= point_num \endcode + * \retval FLAC__bool + * \c false if memory allocation error, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_insert_point(FLAC__StreamMetadata *object, unsigned point_num, FLAC__StreamMetadata_SeekPoint point); + +/** Delete a seekpoint from a seektable. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param point_num Index into seekpoint array to set. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code object->data.seek_table.num_points > point_num \endcode + * \retval FLAC__bool + * \c false if memory allocation error, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_delete_point(FLAC__StreamMetadata *object, unsigned point_num); + +/** Check a seektable to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * seektable. + * + * \param object A pointer to an existing SEEKTABLE object. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \retval FLAC__bool + * \c false if seek table is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_is_legal(const FLAC__StreamMetadata *object); + +/** Append a number of placeholder points to the end of a seek table. + * + * \note + * As with the other ..._seektable_template_... functions, you should + * call FLAC__metadata_object_seektable_template_sort() when finished + * to make the seek table legal. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param num The number of placeholder points to append. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_placeholders(FLAC__StreamMetadata *object, unsigned num); + +/** Append a specific seek point template to the end of a seek table. + * + * \note + * As with the other ..._seektable_template_... functions, you should + * call FLAC__metadata_object_seektable_template_sort() when finished + * to make the seek table legal. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param sample_number The sample number of the seek point template. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_point(FLAC__StreamMetadata *object, FLAC__uint64 sample_number); + +/** Append specific seek point templates to the end of a seek table. + * + * \note + * As with the other ..._seektable_template_... functions, you should + * call FLAC__metadata_object_seektable_template_sort() when finished + * to make the seek table legal. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param sample_numbers An array of sample numbers for the seek points. + * \param num The number of seek point templates to append. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_points(FLAC__StreamMetadata *object, FLAC__uint64 sample_numbers[], unsigned num); + +/** Append a set of evenly-spaced seek point templates to the end of a + * seek table. + * + * \note + * As with the other ..._seektable_template_... functions, you should + * call FLAC__metadata_object_seektable_template_sort() when finished + * to make the seek table legal. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param num The number of placeholder points to append. + * \param total_samples The total number of samples to be encoded; + * the seekpoints will be spaced approximately + * \a total_samples / \a num samples apart. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code total_samples > 0 \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points(FLAC__StreamMetadata *object, unsigned num, FLAC__uint64 total_samples); + +/** Append a set of evenly-spaced seek point templates to the end of a + * seek table. + * + * \note + * As with the other ..._seektable_template_... functions, you should + * call FLAC__metadata_object_seektable_template_sort() when finished + * to make the seek table legal. + * + * \param object A pointer to an existing SEEKTABLE object. + * \param samples The number of samples apart to space the placeholder + * points. The first point will be at sample \c 0, the + * second at sample \a samples, then 2*\a samples, and + * so on. As long as \a samples and \a total_samples + * are greater than \c 0, there will always be at least + * one seekpoint at sample \c 0. + * \param total_samples The total number of samples to be encoded; + * the seekpoints will be spaced + * \a samples samples apart. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \code samples > 0 \endcode + * \code total_samples > 0 \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points_by_samples(FLAC__StreamMetadata *object, unsigned samples, FLAC__uint64 total_samples); + +/** Sort a seek table's seek points according to the format specification, + * removing duplicates. + * + * \param object A pointer to a seek table to be sorted. + * \param compact If \c false, behaves like FLAC__format_seektable_sort(). + * If \c true, duplicates are deleted and the seek table is + * shrunk appropriately; the number of placeholder points + * present in the seek table will be the same after the call + * as before. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_SEEKTABLE \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_sort(FLAC__StreamMetadata *object, FLAC__bool compact); + +/** Sets the vendor string in a VORBIS_COMMENT block. + * + * For convenience, a trailing NUL is added to the entry if it doesn't have + * one already. + * + * If \a copy is \c true, a copy of the entry is stored; otherwise, the object + * takes ownership of the \c entry.entry pointer. + * + * \note If this function returns \c false, the caller still owns the + * pointer. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param entry The entry to set the vendor string to. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code (entry.entry != NULL && entry.length > 0) || + * (entry.entry == NULL && entry.length == 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_set_vendor_string(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy); + +/** Resize the comment array. + * + * If the size shrinks, elements will truncated; if it grows, new empty + * fields will be added to the end. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param new_num_comments The desired length of the array; may be \c 0. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code (object->data.vorbis_comment.comments == NULL && object->data.vorbis_comment.num_comments == 0) || + * (object->data.vorbis_comment.comments != NULL && object->data.vorbis_comment.num_comments > 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_resize_comments(FLAC__StreamMetadata *object, unsigned new_num_comments); + +/** Sets a comment in a VORBIS_COMMENT block. + * + * For convenience, a trailing NUL is added to the entry if it doesn't have + * one already. + * + * If \a copy is \c true, a copy of the entry is stored; otherwise, the object + * takes ownership of the \c entry.entry pointer. + * + * \note If this function returns \c false, the caller still owns the + * pointer. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param comment_num Index into comment array to set. + * \param entry The entry to set the comment to. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code comment_num < object->data.vorbis_comment.num_comments \endcode + * \code (entry.entry != NULL && entry.length > 0) || + * (entry.entry == NULL && entry.length == 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_set_comment(FLAC__StreamMetadata *object, unsigned comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy); + +/** Insert a comment in a VORBIS_COMMENT block at the given index. + * + * For convenience, a trailing NUL is added to the entry if it doesn't have + * one already. + * + * If \a copy is \c true, a copy of the entry is stored; otherwise, the object + * takes ownership of the \c entry.entry pointer. + * + * \note If this function returns \c false, the caller still owns the + * pointer. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param comment_num The index at which to insert the comment. The comments + * at and after \a comment_num move right one position. + * To append a comment to the end, set \a comment_num to + * \c object->data.vorbis_comment.num_comments . + * \param entry The comment to insert. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code object->data.vorbis_comment.num_comments >= comment_num \endcode + * \code (entry.entry != NULL && entry.length > 0) || + * (entry.entry == NULL && entry.length == 0 && copy == false) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_insert_comment(FLAC__StreamMetadata *object, unsigned comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy); + +/** Appends a comment to a VORBIS_COMMENT block. + * + * For convenience, a trailing NUL is added to the entry if it doesn't have + * one already. + * + * If \a copy is \c true, a copy of the entry is stored; otherwise, the object + * takes ownership of the \c entry.entry pointer. + * + * \note If this function returns \c false, the caller still owns the + * pointer. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param entry The comment to insert. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code (entry.entry != NULL && entry.length > 0) || + * (entry.entry == NULL && entry.length == 0 && copy == false) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_append_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy); + +/** Replaces comments in a VORBIS_COMMENT block with a new one. + * + * For convenience, a trailing NUL is added to the entry if it doesn't have + * one already. + * + * Depending on the value of \a all, either all or just the first comment + * whose field name(s) match the given entry's name will be replaced by the + * given entry. If no comments match, \a entry will simply be appended. + * + * If \a copy is \c true, a copy of the entry is stored; otherwise, the object + * takes ownership of the \c entry.entry pointer. + * + * \note If this function returns \c false, the caller still owns the + * pointer. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param entry The comment to insert. + * \param all If \c true, all comments whose field name matches + * \a entry's field name will be removed, and \a entry will + * be inserted at the position of the first matching + * comment. If \c false, only the first comment whose + * field name matches \a entry's field name will be + * replaced with \a entry. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code (entry.entry != NULL && entry.length > 0) || + * (entry.entry == NULL && entry.length == 0 && copy == false) \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_replace_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool all, FLAC__bool copy); + +/** Delete a comment in a VORBIS_COMMENT block at the given index. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param comment_num The index of the comment to delete. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code object->data.vorbis_comment.num_comments > comment_num \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_delete_comment(FLAC__StreamMetadata *object, unsigned comment_num); + +/** Creates a Vorbis comment entry from NUL-terminated name and value strings. + * + * On return, the filled-in \a entry->entry pointer will point to malloc()ed + * memory and shall be owned by the caller. For convenience the entry will + * have a terminating NUL. + * + * \param entry A pointer to a Vorbis comment entry. The entry's + * \c entry pointer should not point to allocated + * memory as it will be overwritten. + * \param field_name The field name in ASCII, \c NUL terminated. + * \param field_value The field value in UTF-8, \c NUL terminated. + * \assert + * \code entry != NULL \endcode + * \code field_name != NULL \endcode + * \code field_value != NULL \endcode + * \retval FLAC__bool + * \c false if malloc() fails, or if \a field_name or \a field_value does + * not comply with the Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair(FLAC__StreamMetadata_VorbisComment_Entry *entry, const char *field_name, const char *field_value); + +/** Splits a Vorbis comment entry into NUL-terminated name and value strings. + * + * The returned pointers to name and value will be allocated by malloc() + * and shall be owned by the caller. + * + * \param entry An existing Vorbis comment entry. + * \param field_name The address of where the returned pointer to the + * field name will be stored. + * \param field_value The address of where the returned pointer to the + * field value will be stored. + * \assert + * \code (entry.entry != NULL && entry.length > 0) \endcode + * \code memchr(entry.entry, '=', entry.length) != NULL \endcode + * \code field_name != NULL \endcode + * \code field_value != NULL \endcode + * \retval FLAC__bool + * \c false if memory allocation fails or \a entry does not comply with the + * Vorbis comment specification, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_to_name_value_pair(const FLAC__StreamMetadata_VorbisComment_Entry entry, char **field_name, char **field_value); + +/** Check if the given Vorbis comment entry's field name matches the given + * field name. + * + * \param entry An existing Vorbis comment entry. + * \param field_name The field name to check. + * \param field_name_length The length of \a field_name, not including the + * terminating \c NUL. + * \assert + * \code (entry.entry != NULL && entry.length > 0) \endcode + * \retval FLAC__bool + * \c true if the field names match, else \c false + */ +FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_matches(const FLAC__StreamMetadata_VorbisComment_Entry entry, const char *field_name, unsigned field_name_length); + +/** Find a Vorbis comment with the given field name. + * + * The search begins at entry number \a offset; use an offset of 0 to + * search from the beginning of the comment array. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param offset The offset into the comment array from where to start + * the search. + * \param field_name The field name of the comment to find. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \code field_name != NULL \endcode + * \retval int + * The offset in the comment array of the first comment whose field + * name matches \a field_name, or \c -1 if no match was found. + */ +FLAC_API int FLAC__metadata_object_vorbiscomment_find_entry_from(const FLAC__StreamMetadata *object, unsigned offset, const char *field_name); + +/** Remove first Vorbis comment matching the given field name. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param field_name The field name of comment to delete. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \retval int + * \c -1 for memory allocation error, \c 0 for no matching entries, + * \c 1 for one matching entry deleted. + */ +FLAC_API int FLAC__metadata_object_vorbiscomment_remove_entry_matching(FLAC__StreamMetadata *object, const char *field_name); + +/** Remove all Vorbis comments matching the given field name. + * + * \param object A pointer to an existing VORBIS_COMMENT object. + * \param field_name The field name of comments to delete. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode + * \retval int + * \c -1 for memory allocation error, \c 0 for no matching entries, + * else the number of matching entries deleted. + */ +FLAC_API int FLAC__metadata_object_vorbiscomment_remove_entries_matching(FLAC__StreamMetadata *object, const char *field_name); + +/** Create a new CUESHEET track instance. + * + * The object will be "empty"; i.e. values and data pointers will be \c 0. + * + * \retval FLAC__StreamMetadata_CueSheet_Track* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__StreamMetadata_CueSheet_Track *FLAC__metadata_object_cuesheet_track_new(void); + +/** Create a copy of an existing CUESHEET track object. + * + * The copy is a "deep" copy, i.e. dynamically allocated data within the + * object is also copied. The caller takes ownership of the new object and + * is responsible for freeing it with + * FLAC__metadata_object_cuesheet_track_delete(). + * + * \param object Pointer to object to copy. + * \assert + * \code object != NULL \endcode + * \retval FLAC__StreamMetadata_CueSheet_Track* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__StreamMetadata_CueSheet_Track *FLAC__metadata_object_cuesheet_track_clone(const FLAC__StreamMetadata_CueSheet_Track *object); + +/** Delete a CUESHEET track object + * + * \param object A pointer to an existing CUESHEET track object. + * \assert + * \code object != NULL \endcode + */ +FLAC_API void FLAC__metadata_object_cuesheet_track_delete(FLAC__StreamMetadata_CueSheet_Track *object); + +/** Resize a track's index point array. + * + * If the size shrinks, elements will truncated; if it grows, new blank + * indices will be added to the end. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index of the track to modify. NOTE: this is not + * necessarily the same as the track's \a number field. + * \param new_num_indices The desired length of the array; may be \c 0. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks > track_num \endcode + * \code (object->data.cue_sheet.tracks[track_num].indices == NULL && object->data.cue_sheet.tracks[track_num].num_indices == 0) || + * (object->data.cue_sheet.tracks[track_num].indices != NULL && object->data.cue_sheet.tracks[track_num].num_indices > 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation error, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_resize_indices(FLAC__StreamMetadata *object, unsigned track_num, unsigned new_num_indices); + +/** Insert an index point in a CUESHEET track at the given index. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index of the track to modify. NOTE: this is not + * necessarily the same as the track's \a number field. + * \param index_num The index into the track's index array at which to + * insert the index point. NOTE: this is not necessarily + * the same as the index point's \a number field. The + * indices at and after \a index_num move right one + * position. To append an index point to the end, set + * \a index_num to + * \c object->data.cue_sheet.tracks[track_num].num_indices . + * \param index The index point to insert. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks > track_num \endcode + * \code object->data.cue_sheet.tracks[track_num].num_indices >= index_num \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_insert_index(FLAC__StreamMetadata *object, unsigned track_num, unsigned index_num, FLAC__StreamMetadata_CueSheet_Index index); + +/** Insert a blank index point in a CUESHEET track at the given index. + * + * A blank index point is one in which all field values are zero. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index of the track to modify. NOTE: this is not + * necessarily the same as the track's \a number field. + * \param index_num The index into the track's index array at which to + * insert the index point. NOTE: this is not necessarily + * the same as the index point's \a number field. The + * indices at and after \a index_num move right one + * position. To append an index point to the end, set + * \a index_num to + * \c object->data.cue_sheet.tracks[track_num].num_indices . + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks > track_num \endcode + * \code object->data.cue_sheet.tracks[track_num].num_indices >= index_num \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_insert_blank_index(FLAC__StreamMetadata *object, unsigned track_num, unsigned index_num); + +/** Delete an index point in a CUESHEET track at the given index. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index into the track array of the track to + * modify. NOTE: this is not necessarily the same + * as the track's \a number field. + * \param index_num The index into the track's index array of the index + * to delete. NOTE: this is not necessarily the same + * as the index's \a number field. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks > track_num \endcode + * \code object->data.cue_sheet.tracks[track_num].num_indices > index_num \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_delete_index(FLAC__StreamMetadata *object, unsigned track_num, unsigned index_num); + +/** Resize the track array. + * + * If the size shrinks, elements will truncated; if it grows, new blank + * tracks will be added to the end. + * + * \param object A pointer to an existing CUESHEET object. + * \param new_num_tracks The desired length of the array; may be \c 0. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code (object->data.cue_sheet.tracks == NULL && object->data.cue_sheet.num_tracks == 0) || + * (object->data.cue_sheet.tracks != NULL && object->data.cue_sheet.num_tracks > 0) \endcode + * \retval FLAC__bool + * \c false if memory allocation error, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_resize_tracks(FLAC__StreamMetadata *object, unsigned new_num_tracks); + +/** Sets a track in a CUESHEET block. + * + * If \a copy is \c true, a copy of the track is stored; otherwise, the object + * takes ownership of the \a track pointer. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num Index into track array to set. NOTE: this is not + * necessarily the same as the track's \a number field. + * \param track The track to set the track to. You may safely pass in + * a const pointer if \a copy is \c true. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code track_num < object->data.cue_sheet.num_tracks \endcode + * \code (track->indices != NULL && track->num_indices > 0) || + * (track->indices == NULL && track->num_indices == 0) \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_set_track(FLAC__StreamMetadata *object, unsigned track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy); + +/** Insert a track in a CUESHEET block at the given index. + * + * If \a copy is \c true, a copy of the track is stored; otherwise, the object + * takes ownership of the \a track pointer. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index at which to insert the track. NOTE: this + * is not necessarily the same as the track's \a number + * field. The tracks at and after \a track_num move right + * one position. To append a track to the end, set + * \a track_num to \c object->data.cue_sheet.num_tracks . + * \param track The track to insert. You may safely pass in a const + * pointer if \a copy is \c true. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks >= track_num \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_insert_track(FLAC__StreamMetadata *object, unsigned track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy); + +/** Insert a blank track in a CUESHEET block at the given index. + * + * A blank track is one in which all field values are zero. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index at which to insert the track. NOTE: this + * is not necessarily the same as the track's \a number + * field. The tracks at and after \a track_num move right + * one position. To append a track to the end, set + * \a track_num to \c object->data.cue_sheet.num_tracks . + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks >= track_num \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_insert_blank_track(FLAC__StreamMetadata *object, unsigned track_num); + +/** Delete a track in a CUESHEET block at the given index. + * + * \param object A pointer to an existing CUESHEET object. + * \param track_num The index into the track array of the track to + * delete. NOTE: this is not necessarily the same + * as the track's \a number field. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \code object->data.cue_sheet.num_tracks > track_num \endcode + * \retval FLAC__bool + * \c false if realloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_delete_track(FLAC__StreamMetadata *object, unsigned track_num); + +/** Check a cue sheet to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * cue sheet. + * + * \param object A pointer to an existing CUESHEET object. + * \param check_cd_da_subset If \c true, check CUESHEET against more + * stringent requirements for a CD-DA (audio) disc. + * \param violation Address of a pointer to a string. If there is a + * violation, a pointer to a string explanation of the + * violation will be returned here. \a violation may be + * \c NULL if you don't need the returned string. Do not + * free the returned string; it will always point to static + * data. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \retval FLAC__bool + * \c false if cue sheet is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_is_legal(const FLAC__StreamMetadata *object, FLAC__bool check_cd_da_subset, const char **violation); + +/** Calculate and return the CDDB/freedb ID for a cue sheet. The function + * assumes the cue sheet corresponds to a CD; the result is undefined + * if the cuesheet's is_cd bit is not set. + * + * \param object A pointer to an existing CUESHEET object. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_CUESHEET \endcode + * \retval FLAC__uint32 + * The unsigned integer representation of the CDDB/freedb ID + */ +FLAC_API FLAC__uint32 FLAC__metadata_object_cuesheet_calculate_cddb_id(const FLAC__StreamMetadata *object); + +/** Sets the MIME type of a PICTURE block. + * + * If \a copy is \c true, a copy of the string is stored; otherwise, the object + * takes ownership of the pointer. The existing string will be freed if this + * function is successful, otherwise the original string will remain if \a copy + * is \c true and malloc() fails. + * + * \note It is safe to pass a const pointer to \a mime_type if \a copy is \c true. + * + * \param object A pointer to an existing PICTURE object. + * \param mime_type A pointer to the MIME type string. The string must be + * ASCII characters 0x20-0x7e, NUL-terminated. No validation + * is done. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_PICTURE \endcode + * \code (mime_type != NULL) \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_picture_set_mime_type(FLAC__StreamMetadata *object, char *mime_type, FLAC__bool copy); + +/** Sets the description of a PICTURE block. + * + * If \a copy is \c true, a copy of the string is stored; otherwise, the object + * takes ownership of the pointer. The existing string will be freed if this + * function is successful, otherwise the original string will remain if \a copy + * is \c true and malloc() fails. + * + * \note It is safe to pass a const pointer to \a description if \a copy is \c true. + * + * \param object A pointer to an existing PICTURE object. + * \param description A pointer to the description string. The string must be + * valid UTF-8, NUL-terminated. No validation is done. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_PICTURE \endcode + * \code (description != NULL) \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_picture_set_description(FLAC__StreamMetadata *object, FLAC__byte *description, FLAC__bool copy); + +/** Sets the picture data of a PICTURE block. + * + * If \a copy is \c true, a copy of the data is stored; otherwise, the object + * takes ownership of the pointer. Also sets the \a data_length field of the + * metadata object to what is passed in as the \a length parameter. The + * existing data will be freed if this function is successful, otherwise the + * original data and data_length will remain if \a copy is \c true and + * malloc() fails. + * + * \note It is safe to pass a const pointer to \a data if \a copy is \c true. + * + * \param object A pointer to an existing PICTURE object. + * \param data A pointer to the data to set. + * \param length The length of \a data in bytes. + * \param copy See above. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_PICTURE \endcode + * \code (data != NULL && length > 0) || + * (data == NULL && length == 0 && copy == false) \endcode + * \retval FLAC__bool + * \c false if \a copy is \c true and malloc() fails, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_picture_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, FLAC__uint32 length, FLAC__bool copy); + +/** Check a PICTURE block to see if it conforms to the FLAC specification. + * See the format specification for limits on the contents of the + * PICTURE block. + * + * \param object A pointer to existing PICTURE block to be checked. + * \param violation Address of a pointer to a string. If there is a + * violation, a pointer to a string explanation of the + * violation will be returned here. \a violation may be + * \c NULL if you don't need the returned string. Do not + * free the returned string; it will always point to static + * data. + * \assert + * \code object != NULL \endcode + * \code object->type == FLAC__METADATA_TYPE_PICTURE \endcode + * \retval FLAC__bool + * \c false if PICTURE block is illegal, else \c true. + */ +FLAC_API FLAC__bool FLAC__metadata_object_picture_is_legal(const FLAC__StreamMetadata *object, const char **violation); + +/* \} */ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/FLAC/ordinals.h b/src/libflac/FLAC/ordinals.h new file mode 100644 index 0000000..ea52ea6 --- /dev/null +++ b/src/libflac/FLAC/ordinals.h @@ -0,0 +1,86 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__ORDINALS_H +#define FLAC__ORDINALS_H + +#if defined(_MSC_VER) && _MSC_VER < 1600 + +/* Microsoft Visual Studio earlier than the 2010 version did not provide + * the 1999 ISO C Standard header file . + */ + +typedef __int8 FLAC__int8; +typedef unsigned __int8 FLAC__uint8; + +typedef __int16 FLAC__int16; +typedef __int32 FLAC__int32; +typedef __int64 FLAC__int64; +typedef unsigned __int16 FLAC__uint16; +typedef unsigned __int32 FLAC__uint32; +typedef unsigned __int64 FLAC__uint64; + +#else + +/* For MSVC 2010 and everything else which provides . */ + +#include + +typedef int8_t FLAC__int8; +typedef uint8_t FLAC__uint8; + +typedef int16_t FLAC__int16; +typedef int32_t FLAC__int32; +typedef int64_t FLAC__int64; +typedef uint16_t FLAC__uint16; +typedef uint32_t FLAC__uint32; +typedef uint64_t FLAC__uint64; + +#endif + +typedef int FLAC__bool; + +typedef FLAC__uint8 FLAC__byte; + + +#ifdef true +#undef true +#endif +#ifdef false +#undef false +#endif +#ifndef __cplusplus +#define true 1 +#define false 0 +#endif + +#endif diff --git a/src/libflac/FLAC/stream_decoder.h b/src/libflac/FLAC/stream_decoder.h new file mode 100644 index 0000000..0e80f9b --- /dev/null +++ b/src/libflac/FLAC/stream_decoder.h @@ -0,0 +1,1560 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__STREAM_DECODER_H +#define FLAC__STREAM_DECODER_H + +#include /* for FILE */ +#include "export.h" +#include "format.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +/** \file include/FLAC/stream_decoder.h + * + * \brief + * This module contains the functions which implement the stream + * decoder. + * + * See the detailed documentation in the + * \link flac_stream_decoder stream decoder \endlink module. + */ + +/** \defgroup flac_decoder FLAC/ \*_decoder.h: decoder interfaces + * \ingroup flac + * + * \brief + * This module describes the decoder layers provided by libFLAC. + * + * The stream decoder can be used to decode complete streams either from + * the client via callbacks, or directly from a file, depending on how + * it is initialized. When decoding via callbacks, the client provides + * callbacks for reading FLAC data and writing decoded samples, and + * handling metadata and errors. If the client also supplies seek-related + * callback, the decoder function for sample-accurate seeking within the + * FLAC input is also available. When decoding from a file, the client + * needs only supply a filename or open \c FILE* and write/metadata/error + * callbacks; the rest of the callbacks are supplied internally. For more + * info see the \link flac_stream_decoder stream decoder \endlink module. + */ + +/** \defgroup flac_stream_decoder FLAC/stream_decoder.h: stream decoder interface + * \ingroup flac_decoder + * + * \brief + * This module contains the functions which implement the stream + * decoder. + * + * The stream decoder can decode native FLAC, and optionally Ogg FLAC + * (check FLAC_API_SUPPORTS_OGG_FLAC) streams and files. + * + * The basic usage of this decoder is as follows: + * - The program creates an instance of a decoder using + * FLAC__stream_decoder_new(). + * - The program overrides the default settings using + * FLAC__stream_decoder_set_*() functions. + * - The program initializes the instance to validate the settings and + * prepare for decoding using + * - FLAC__stream_decoder_init_stream() or FLAC__stream_decoder_init_FILE() + * or FLAC__stream_decoder_init_file() for native FLAC, + * - FLAC__stream_decoder_init_ogg_stream() or FLAC__stream_decoder_init_ogg_FILE() + * or FLAC__stream_decoder_init_ogg_file() for Ogg FLAC + * - The program calls the FLAC__stream_decoder_process_*() functions + * to decode data, which subsequently calls the callbacks. + * - The program finishes the decoding with FLAC__stream_decoder_finish(), + * which flushes the input and output and resets the decoder to the + * uninitialized state. + * - The instance may be used again or deleted with + * FLAC__stream_decoder_delete(). + * + * In more detail, the program will create a new instance by calling + * FLAC__stream_decoder_new(), then call FLAC__stream_decoder_set_*() + * functions to override the default decoder options, and call + * one of the FLAC__stream_decoder_init_*() functions. + * + * There are three initialization functions for native FLAC, one for + * setting up the decoder to decode FLAC data from the client via + * callbacks, and two for decoding directly from a FLAC file. + * + * For decoding via callbacks, use FLAC__stream_decoder_init_stream(). + * You must also supply several callbacks for handling I/O. Some (like + * seeking) are optional, depending on the capabilities of the input. + * + * For decoding directly from a file, use FLAC__stream_decoder_init_FILE() + * or FLAC__stream_decoder_init_file(). Then you must only supply an open + * \c FILE* or filename and fewer callbacks; the decoder will handle + * the other callbacks internally. + * + * There are three similarly-named init functions for decoding from Ogg + * FLAC streams. Check \c FLAC_API_SUPPORTS_OGG_FLAC to find out if the + * library has been built with Ogg support. + * + * Once the decoder is initialized, your program will call one of several + * functions to start the decoding process: + * + * - FLAC__stream_decoder_process_single() - Tells the decoder to process at + * most one metadata block or audio frame and return, calling either the + * metadata callback or write callback, respectively, once. If the decoder + * loses sync it will return with only the error callback being called. + * - FLAC__stream_decoder_process_until_end_of_metadata() - Tells the decoder + * to process the stream from the current location and stop upon reaching + * the first audio frame. The client will get one metadata, write, or error + * callback per metadata block, audio frame, or sync error, respectively. + * - FLAC__stream_decoder_process_until_end_of_stream() - Tells the decoder + * to process the stream from the current location until the read callback + * returns FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM or + * FLAC__STREAM_DECODER_READ_STATUS_ABORT. The client will get one metadata, + * write, or error callback per metadata block, audio frame, or sync error, + * respectively. + * + * When the decoder has finished decoding (normally or through an abort), + * the instance is finished by calling FLAC__stream_decoder_finish(), which + * ensures the decoder is in the correct state and frees memory. Then the + * instance may be deleted with FLAC__stream_decoder_delete() or initialized + * again to decode another stream. + * + * Seeking is exposed through the FLAC__stream_decoder_seek_absolute() method. + * At any point after the stream decoder has been initialized, the client can + * call this function to seek to an exact sample within the stream. + * Subsequently, the first time the write callback is called it will be + * passed a (possibly partial) block starting at that sample. + * + * If the client cannot seek via the callback interface provided, but still + * has another way of seeking, it can flush the decoder using + * FLAC__stream_decoder_flush() and start feeding data from the new position + * through the read callback. + * + * The stream decoder also provides MD5 signature checking. If this is + * turned on before initialization, FLAC__stream_decoder_finish() will + * report when the decoded MD5 signature does not match the one stored + * in the STREAMINFO block. MD5 checking is automatically turned off + * (until the next FLAC__stream_decoder_reset()) if there is no signature + * in the STREAMINFO block or when a seek is attempted. + * + * The FLAC__stream_decoder_set_metadata_*() functions deserve special + * attention. By default, the decoder only calls the metadata_callback for + * the STREAMINFO block. These functions allow you to tell the decoder + * explicitly which blocks to parse and return via the metadata_callback + * and/or which to skip. Use a FLAC__stream_decoder_set_metadata_respond_all(), + * FLAC__stream_decoder_set_metadata_ignore() ... or FLAC__stream_decoder_set_metadata_ignore_all(), + * FLAC__stream_decoder_set_metadata_respond() ... sequence to exactly specify + * which blocks to return. Remember that metadata blocks can potentially + * be big (for example, cover art) so filtering out the ones you don't + * use can reduce the memory requirements of the decoder. Also note the + * special forms FLAC__stream_decoder_set_metadata_respond_application(id) + * and FLAC__stream_decoder_set_metadata_ignore_application(id) for + * filtering APPLICATION blocks based on the application ID. + * + * STREAMINFO and SEEKTABLE blocks are always parsed and used internally, but + * they still can legally be filtered from the metadata_callback. + * + * \note + * The "set" functions may only be called when the decoder is in the + * state FLAC__STREAM_DECODER_UNINITIALIZED, i.e. after + * FLAC__stream_decoder_new() or FLAC__stream_decoder_finish(), but + * before FLAC__stream_decoder_init_*(). If this is the case they will + * return \c true, otherwise \c false. + * + * \note + * FLAC__stream_decoder_finish() resets all settings to the constructor + * defaults, including the callbacks. + * + * \{ + */ + + +/** State values for a FLAC__StreamDecoder + * + * The decoder's state can be obtained by calling FLAC__stream_decoder_get_state(). + */ +typedef enum { + + FLAC__STREAM_DECODER_SEARCH_FOR_METADATA = 0, + /**< The decoder is ready to search for metadata. */ + + FLAC__STREAM_DECODER_READ_METADATA, + /**< The decoder is ready to or is in the process of reading metadata. */ + + FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC, + /**< The decoder is ready to or is in the process of searching for the + * frame sync code. + */ + + FLAC__STREAM_DECODER_READ_FRAME, + /**< The decoder is ready to or is in the process of reading a frame. */ + + FLAC__STREAM_DECODER_END_OF_STREAM, + /**< The decoder has reached the end of the stream. */ + + FLAC__STREAM_DECODER_OGG_ERROR, + /**< An error occurred in the underlying Ogg layer. */ + + FLAC__STREAM_DECODER_SEEK_ERROR, + /**< An error occurred while seeking. The decoder must be flushed + * with FLAC__stream_decoder_flush() or reset with + * FLAC__stream_decoder_reset() before decoding can continue. + */ + + FLAC__STREAM_DECODER_ABORTED, + /**< The decoder was aborted by the read or write callback. */ + + FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR, + /**< An error occurred allocating memory. The decoder is in an invalid + * state and can no longer be used. + */ + + FLAC__STREAM_DECODER_UNINITIALIZED + /**< The decoder is in the uninitialized state; one of the + * FLAC__stream_decoder_init_*() functions must be called before samples + * can be processed. + */ + +} FLAC__StreamDecoderState; + +/** Maps a FLAC__StreamDecoderState to a C string. + * + * Using a FLAC__StreamDecoderState as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderStateString[][48]; + + +/** Possible return values for the FLAC__stream_decoder_init_*() functions. + */ +typedef enum { + + FLAC__STREAM_DECODER_INIT_STATUS_OK = 0, + /**< Initialization was successful. */ + + FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER, + /**< The library was not compiled with support for the given container + * format. + */ + + FLAC__STREAM_DECODER_INIT_STATUS_INVALID_CALLBACKS, + /**< A required callback was not supplied. */ + + FLAC__STREAM_DECODER_INIT_STATUS_MEMORY_ALLOCATION_ERROR, + /**< An error occurred allocating memory. */ + + FLAC__STREAM_DECODER_INIT_STATUS_ERROR_OPENING_FILE, + /**< fopen() failed in FLAC__stream_decoder_init_file() or + * FLAC__stream_decoder_init_ogg_file(). */ + + FLAC__STREAM_DECODER_INIT_STATUS_ALREADY_INITIALIZED + /**< FLAC__stream_decoder_init_*() was called when the decoder was + * already initialized, usually because + * FLAC__stream_decoder_finish() was not called. + */ + +} FLAC__StreamDecoderInitStatus; + +/** Maps a FLAC__StreamDecoderInitStatus to a C string. + * + * Using a FLAC__StreamDecoderInitStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderInitStatusString[][64]; + + +/** Return values for the FLAC__StreamDecoder read callback. + */ +typedef enum { + + FLAC__STREAM_DECODER_READ_STATUS_CONTINUE, + /**< The read was OK and decoding can continue. */ + + FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM, + /**< The read was attempted while at the end of the stream. Note that + * the client must only return this value when the read callback was + * called when already at the end of the stream. Otherwise, if the read + * itself moves to the end of the stream, the client should still return + * the data and \c FLAC__STREAM_DECODER_READ_STATUS_CONTINUE, and then on + * the next read callback it should return + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM with a byte count + * of \c 0. + */ + + FLAC__STREAM_DECODER_READ_STATUS_ABORT + /**< An unrecoverable error occurred. The decoder will return from the process call. */ + +} FLAC__StreamDecoderReadStatus; + +/** Maps a FLAC__StreamDecoderReadStatus to a C string. + * + * Using a FLAC__StreamDecoderReadStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderReadStatusString[][48]; + + +/** Return values for the FLAC__StreamDecoder seek callback. + */ +typedef enum { + + FLAC__STREAM_DECODER_SEEK_STATUS_OK, + /**< The seek was OK and decoding can continue. */ + + FLAC__STREAM_DECODER_SEEK_STATUS_ERROR, + /**< An unrecoverable error occurred. The decoder will return from the process call. */ + + FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED + /**< Client does not support seeking. */ + +} FLAC__StreamDecoderSeekStatus; + +/** Maps a FLAC__StreamDecoderSeekStatus to a C string. + * + * Using a FLAC__StreamDecoderSeekStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderSeekStatusString[][48]; + + +/** Return values for the FLAC__StreamDecoder tell callback. + */ +typedef enum { + + FLAC__STREAM_DECODER_TELL_STATUS_OK, + /**< The tell was OK and decoding can continue. */ + + FLAC__STREAM_DECODER_TELL_STATUS_ERROR, + /**< An unrecoverable error occurred. The decoder will return from the process call. */ + + FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED + /**< Client does not support telling the position. */ + +} FLAC__StreamDecoderTellStatus; + +/** Maps a FLAC__StreamDecoderTellStatus to a C string. + * + * Using a FLAC__StreamDecoderTellStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderTellStatusString[][48]; + + +/** Return values for the FLAC__StreamDecoder length callback. + */ +typedef enum { + + FLAC__STREAM_DECODER_LENGTH_STATUS_OK, + /**< The length call was OK and decoding can continue. */ + + FLAC__STREAM_DECODER_LENGTH_STATUS_ERROR, + /**< An unrecoverable error occurred. The decoder will return from the process call. */ + + FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED + /**< Client does not support reporting the length. */ + +} FLAC__StreamDecoderLengthStatus; + +/** Maps a FLAC__StreamDecoderLengthStatus to a C string. + * + * Using a FLAC__StreamDecoderLengthStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderLengthStatusString[][48]; + + +/** Return values for the FLAC__StreamDecoder write callback. + */ +typedef enum { + + FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE, + /**< The write was OK and decoding can continue. */ + + FLAC__STREAM_DECODER_WRITE_STATUS_ABORT + /**< An unrecoverable error occurred. The decoder will return from the process call. */ + +} FLAC__StreamDecoderWriteStatus; + +/** Maps a FLAC__StreamDecoderWriteStatus to a C string. + * + * Using a FLAC__StreamDecoderWriteStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderWriteStatusString[][48]; + + +/** Possible values passed back to the FLAC__StreamDecoder error callback. + * \c FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC is the generic catch- + * all. The rest could be caused by bad sync (false synchronization on + * data that is not the start of a frame) or corrupted data. The error + * itself is the decoder's best guess at what happened assuming a correct + * sync. For example \c FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER + * could be caused by a correct sync on the start of a frame, but some + * data in the frame header was corrupted. Or it could be the result of + * syncing on a point the stream that looked like the starting of a frame + * but was not. \c FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM + * could be because the decoder encountered a valid frame made by a future + * version of the encoder which it cannot parse, or because of a false + * sync making it appear as though an encountered frame was generated by + * a future encoder. + */ +typedef enum { + + FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC, + /**< An error in the stream caused the decoder to lose synchronization. */ + + FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER, + /**< The decoder encountered a corrupted frame header. */ + + FLAC__STREAM_DECODER_ERROR_STATUS_FRAME_CRC_MISMATCH, + /**< The frame's data did not match the CRC in the footer. */ + + FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM + /**< The decoder encountered reserved fields in use in the stream. */ + +} FLAC__StreamDecoderErrorStatus; + +/** Maps a FLAC__StreamDecoderErrorStatus to a C string. + * + * Using a FLAC__StreamDecoderErrorStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char FLAC__StreamDecoderErrorStatusString[][64]; + + +/*********************************************************************** + * + * class FLAC__StreamDecoder + * + ***********************************************************************/ + +struct FLAC__StreamDecoderProtected; +struct FLAC__StreamDecoderPrivate; +/** The opaque structure definition for the stream decoder type. + * See the \link flac_stream_decoder stream decoder module \endlink + * for a detailed description. + */ +typedef struct { + struct FLAC__StreamDecoderProtected *protected_; /* avoid the C++ keyword 'protected' */ + struct FLAC__StreamDecoderPrivate *private_; /* avoid the C++ keyword 'private' */ +} FLAC__StreamDecoder; + +/** Signature for the read callback. + * + * A function pointer matching this signature must be passed to + * FLAC__stream_decoder_init*_stream(). The supplied function will be + * called when the decoder needs more input data. The address of the + * buffer to be filled is supplied, along with the number of bytes the + * buffer can hold. The callback may choose to supply less data and + * modify the byte count but must be careful not to overflow the buffer. + * The callback then returns a status code chosen from + * FLAC__StreamDecoderReadStatus. + * + * Here is an example of a read callback for stdio streams: + * \code + * FLAC__StreamDecoderReadStatus read_cb(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * if(*bytes > 0) { + * *bytes = fread(buffer, sizeof(FLAC__byte), *bytes, file); + * if(ferror(file)) + * return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + * else if(*bytes == 0) + * return FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM; + * else + * return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE; + * } + * else + * return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + * } + * \endcode + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param buffer A pointer to a location for the callee to store + * data to be decoded. + * \param bytes A pointer to the size of the buffer. On entry + * to the callback, it contains the maximum number + * of bytes that may be stored in \a buffer. The + * callee must set it to the actual number of bytes + * stored (0 in case of error or end-of-stream) before + * returning. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__StreamDecoderReadStatus + * The callee's return status. Note that the callback should return + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM if and only if + * zero bytes were read and there is no more data to be read. + */ +typedef FLAC__StreamDecoderReadStatus (*FLAC__StreamDecoderReadCallback)(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data); + +/** Signature for the seek callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_decoder_init*_stream(). The supplied function will be + * called when the decoder needs to seek the input stream. The decoder + * will pass the absolute byte offset to seek to, 0 meaning the + * beginning of the stream. + * + * Here is an example of a seek callback for stdio streams: + * \code + * FLAC__StreamDecoderSeekStatus seek_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * if(file == stdin) + * return FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED; + * else if(fseeko(file, (off_t)absolute_byte_offset, SEEK_SET) < 0) + * return FLAC__STREAM_DECODER_SEEK_STATUS_ERROR; + * else + * return FLAC__STREAM_DECODER_SEEK_STATUS_OK; + * } + * \endcode + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param absolute_byte_offset The offset from the beginning of the stream + * to seek to. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__StreamDecoderSeekStatus + * The callee's return status. + */ +typedef FLAC__StreamDecoderSeekStatus (*FLAC__StreamDecoderSeekCallback)(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data); + +/** Signature for the tell callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_decoder_init*_stream(). The supplied function will be + * called when the decoder wants to know the current position of the + * stream. The callback should return the byte offset from the + * beginning of the stream. + * + * Here is an example of a tell callback for stdio streams: + * \code + * FLAC__StreamDecoderTellStatus tell_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * off_t pos; + * if(file == stdin) + * return FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED; + * else if((pos = ftello(file)) < 0) + * return FLAC__STREAM_DECODER_TELL_STATUS_ERROR; + * else { + * *absolute_byte_offset = (FLAC__uint64)pos; + * return FLAC__STREAM_DECODER_TELL_STATUS_OK; + * } + * } + * \endcode + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param absolute_byte_offset A pointer to storage for the current offset + * from the beginning of the stream. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__StreamDecoderTellStatus + * The callee's return status. + */ +typedef FLAC__StreamDecoderTellStatus (*FLAC__StreamDecoderTellCallback)(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data); + +/** Signature for the length callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_decoder_init*_stream(). The supplied function will be + * called when the decoder wants to know the total length of the stream + * in bytes. + * + * Here is an example of a length callback for stdio streams: + * \code + * FLAC__StreamDecoderLengthStatus length_cb(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * struct stat filestats; + * + * if(file == stdin) + * return FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED; + * else if(fstat(fileno(file), &filestats) != 0) + * return FLAC__STREAM_DECODER_LENGTH_STATUS_ERROR; + * else { + * *stream_length = (FLAC__uint64)filestats.st_size; + * return FLAC__STREAM_DECODER_LENGTH_STATUS_OK; + * } + * } + * \endcode + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param stream_length A pointer to storage for the length of the stream + * in bytes. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__StreamDecoderLengthStatus + * The callee's return status. + */ +typedef FLAC__StreamDecoderLengthStatus (*FLAC__StreamDecoderLengthCallback)(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length, void *client_data); + +/** Signature for the EOF callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_decoder_init*_stream(). The supplied function will be + * called when the decoder needs to know if the end of the stream has + * been reached. + * + * Here is an example of a EOF callback for stdio streams: + * FLAC__bool eof_cb(const FLAC__StreamDecoder *decoder, void *client_data) + * \code + * { + * FILE *file = ((MyClientData*)client_data)->file; + * return feof(file)? true : false; + * } + * \endcode + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__bool + * \c true if the currently at the end of the stream, else \c false. + */ +typedef FLAC__bool (*FLAC__StreamDecoderEofCallback)(const FLAC__StreamDecoder *decoder, void *client_data); + +/** Signature for the write callback. + * + * A function pointer matching this signature must be passed to one of + * the FLAC__stream_decoder_init_*() functions. + * The supplied function will be called when the decoder has decoded a + * single audio frame. The decoder will pass the frame metadata as well + * as an array of pointers (one for each channel) pointing to the + * decoded audio. + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param frame The description of the decoded frame. See + * FLAC__Frame. + * \param buffer An array of pointers to decoded channels of data. + * Each pointer will point to an array of signed + * samples of length \a frame->header.blocksize. + * Channels will be ordered according to the FLAC + * specification; see the documentation for the + * frame header. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + * \retval FLAC__StreamDecoderWriteStatus + * The callee's return status. + */ +typedef FLAC__StreamDecoderWriteStatus (*FLAC__StreamDecoderWriteCallback)(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data); + +/** Signature for the metadata callback. + * + * A function pointer matching this signature must be passed to one of + * the FLAC__stream_decoder_init_*() functions. + * The supplied function will be called when the decoder has decoded a + * metadata block. In a valid FLAC file there will always be one + * \c STREAMINFO block, followed by zero or more other metadata blocks. + * These will be supplied by the decoder in the same order as they + * appear in the stream and always before the first audio frame (i.e. + * write callback). The metadata block that is passed in must not be + * modified, and it doesn't live beyond the callback, so you should make + * a copy of it with FLAC__metadata_object_clone() if you will need it + * elsewhere. Since metadata blocks can potentially be large, by + * default the decoder only calls the metadata callback for the + * \c STREAMINFO block; you can instruct the decoder to pass or filter + * other blocks with FLAC__stream_decoder_set_metadata_*() calls. + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param metadata The decoded metadata block. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + */ +typedef void (*FLAC__StreamDecoderMetadataCallback)(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data); + +/** Signature for the error callback. + * + * A function pointer matching this signature must be passed to one of + * the FLAC__stream_decoder_init_*() functions. + * The supplied function will be called whenever an error occurs during + * decoding. + * + * \note In general, FLAC__StreamDecoder functions which change the + * state should not be called on the \a decoder while in the callback. + * + * \param decoder The decoder instance calling the callback. + * \param status The error encountered by the decoder. + * \param client_data The callee's client data set through + * FLAC__stream_decoder_init_*(). + */ +typedef void (*FLAC__StreamDecoderErrorCallback)(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data); + + +/*********************************************************************** + * + * Class constructor/destructor + * + ***********************************************************************/ + +/** Create a new stream decoder instance. The instance is created with + * default settings; see the individual FLAC__stream_decoder_set_*() + * functions for each setting's default. + * + * \retval FLAC__StreamDecoder* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__StreamDecoder *FLAC__stream_decoder_new(void); + +/** Free a decoder instance. Deletes the object pointed to by \a decoder. + * + * \param decoder A pointer to an existing decoder. + * \assert + * \code decoder != NULL \endcode + */ +FLAC_API void FLAC__stream_decoder_delete(FLAC__StreamDecoder *decoder); + + +/*********************************************************************** + * + * Public class method prototypes + * + ***********************************************************************/ + +/** Set the serial number for the FLAC stream within the Ogg container. + * The default behavior is to use the serial number of the first Ogg + * page. Setting a serial number here will explicitly specify which + * stream is to be decoded. + * + * \note + * This does not need to be set for native FLAC decoding. + * + * \default \c use serial number of first page + * \param decoder A decoder instance to set. + * \param serial_number See above. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_ogg_serial_number(FLAC__StreamDecoder *decoder, long serial_number); + +/** Set the "MD5 signature checking" flag. If \c true, the decoder will + * compute the MD5 signature of the unencoded audio data while decoding + * and compare it to the signature from the STREAMINFO block, if it + * exists, during FLAC__stream_decoder_finish(). + * + * MD5 signature checking will be turned off (until the next + * FLAC__stream_decoder_reset()) if there is no signature in the + * STREAMINFO block or when a seek is attempted. + * + * Clients that do not use the MD5 check should leave this off to speed + * up decoding. + * + * \default \c false + * \param decoder A decoder instance to set. + * \param value Flag value (see above). + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_md5_checking(FLAC__StreamDecoder *decoder, FLAC__bool value); + +/** Direct the decoder to pass on all metadata blocks of type \a type. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \param type See above. + * \assert + * \code decoder != NULL \endcode + * \a type is valid + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond(FLAC__StreamDecoder *decoder, FLAC__MetadataType type); + +/** Direct the decoder to pass on all APPLICATION metadata blocks of the + * given \a id. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \param id See above. + * \assert + * \code decoder != NULL \endcode + * \code id != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond_application(FLAC__StreamDecoder *decoder, const FLAC__byte id[4]); + +/** Direct the decoder to pass on all metadata blocks of any type. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond_all(FLAC__StreamDecoder *decoder); + +/** Direct the decoder to filter out all metadata blocks of type \a type. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \param type See above. + * \assert + * \code decoder != NULL \endcode + * \a type is valid + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore(FLAC__StreamDecoder *decoder, FLAC__MetadataType type); + +/** Direct the decoder to filter out all APPLICATION metadata blocks of + * the given \a id. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \param id See above. + * \assert + * \code decoder != NULL \endcode + * \code id != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore_application(FLAC__StreamDecoder *decoder, const FLAC__byte id[4]); + +/** Direct the decoder to filter out all metadata blocks of any type. + * + * \default By default, only the \c STREAMINFO block is returned via the + * metadata callback. + * \param decoder A decoder instance to set. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if the decoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore_all(FLAC__StreamDecoder *decoder); + +/** Get the current decoder state. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__StreamDecoderState + * The current decoder state. + */ +FLAC_API FLAC__StreamDecoderState FLAC__stream_decoder_get_state(const FLAC__StreamDecoder *decoder); + +/** Get the current decoder state as a C string. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval const char * + * The decoder state as a C string. Do not modify the contents. + */ +FLAC_API const char *FLAC__stream_decoder_get_resolved_state_string(const FLAC__StreamDecoder *decoder); + +/** Get the "MD5 signature checking" flag. + * This is the value of the setting, not whether or not the decoder is + * currently checking the MD5 (remember, it can be turned off automatically + * by a seek). When the decoder is reset the flag will be restored to the + * value returned by this function. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * See above. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_get_md5_checking(const FLAC__StreamDecoder *decoder); + +/** Get the total number of samples in the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the \c STREAMINFO block. A value of \c 0 means "unknown". + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval unsigned + * See above. + */ +FLAC_API FLAC__uint64 FLAC__stream_decoder_get_total_samples(const FLAC__StreamDecoder *decoder); + +/** Get the current number of channels in the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the most recently decoded frame header. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval unsigned + * See above. + */ +FLAC_API unsigned FLAC__stream_decoder_get_channels(const FLAC__StreamDecoder *decoder); + +/** Get the current channel assignment in the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the most recently decoded frame header. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__ChannelAssignment + * See above. + */ +FLAC_API FLAC__ChannelAssignment FLAC__stream_decoder_get_channel_assignment(const FLAC__StreamDecoder *decoder); + +/** Get the current sample resolution in the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the most recently decoded frame header. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval unsigned + * See above. + */ +FLAC_API unsigned FLAC__stream_decoder_get_bits_per_sample(const FLAC__StreamDecoder *decoder); + +/** Get the current sample rate in Hz of the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the most recently decoded frame header. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval unsigned + * See above. + */ +FLAC_API unsigned FLAC__stream_decoder_get_sample_rate(const FLAC__StreamDecoder *decoder); + +/** Get the current blocksize of the stream being decoded. + * Will only be valid after decoding has started and will contain the + * value from the most recently decoded frame header. + * + * \param decoder A decoder instance to query. + * \assert + * \code decoder != NULL \endcode + * \retval unsigned + * See above. + */ +FLAC_API unsigned FLAC__stream_decoder_get_blocksize(const FLAC__StreamDecoder *decoder); + +/** Returns the decoder's current read position within the stream. + * The position is the byte offset from the start of the stream. + * Bytes before this position have been fully decoded. Note that + * there may still be undecoded bytes in the decoder's read FIFO. + * The returned position is correct even after a seek. + * + * \warning This function currently only works for native FLAC, + * not Ogg FLAC streams. + * + * \param decoder A decoder instance to query. + * \param position Address at which to return the desired position. + * \assert + * \code decoder != NULL \endcode + * \code position != NULL \endcode + * \retval FLAC__bool + * \c true if successful, \c false if the stream is not native FLAC, + * or there was an error from the 'tell' callback or it returned + * \c FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_get_decode_position(const FLAC__StreamDecoder *decoder, FLAC__uint64 *position); + +/** Initialize the decoder instance to decode native FLAC streams. + * + * This flavor of initialization sets up the decoder to decode from a + * native FLAC stream. I/O is performed via callbacks to the client. + * For decoding from a plain file via filename or open FILE*, + * FLAC__stream_decoder_init_file() and FLAC__stream_decoder_init_FILE() + * provide a simpler interface. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \param decoder An uninitialized decoder instance. + * \param read_callback See FLAC__StreamDecoderReadCallback. This + * pointer must not be \c NULL. + * \param seek_callback See FLAC__StreamDecoderSeekCallback. This + * pointer may be \c NULL if seeking is not + * supported. If \a seek_callback is not \c NULL then a + * \a tell_callback, \a length_callback, and \a eof_callback must also be supplied. + * Alternatively, a dummy seek callback that just + * returns \c FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param tell_callback See FLAC__StreamDecoderTellCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a tell_callback must also be supplied. + * Alternatively, a dummy tell callback that just + * returns \c FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param length_callback See FLAC__StreamDecoderLengthCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a length_callback must also be supplied. + * Alternatively, a dummy length callback that just + * returns \c FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param eof_callback See FLAC__StreamDecoderEofCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a eof_callback must also be supplied. + * Alternatively, a dummy length callback that just + * returns \c false + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_stream( + FLAC__StreamDecoder *decoder, + FLAC__StreamDecoderReadCallback read_callback, + FLAC__StreamDecoderSeekCallback seek_callback, + FLAC__StreamDecoderTellCallback tell_callback, + FLAC__StreamDecoderLengthCallback length_callback, + FLAC__StreamDecoderEofCallback eof_callback, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Initialize the decoder instance to decode Ogg FLAC streams. + * + * This flavor of initialization sets up the decoder to decode from a + * FLAC stream in an Ogg container. I/O is performed via callbacks to the + * client. For decoding from a plain file via filename or open FILE*, + * FLAC__stream_decoder_init_ogg_file() and FLAC__stream_decoder_init_ogg_FILE() + * provide a simpler interface. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \note Support for Ogg FLAC in the library is optional. If this + * library has been built without support for Ogg FLAC, this function + * will return \c FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER. + * + * \param decoder An uninitialized decoder instance. + * \param read_callback See FLAC__StreamDecoderReadCallback. This + * pointer must not be \c NULL. + * \param seek_callback See FLAC__StreamDecoderSeekCallback. This + * pointer may be \c NULL if seeking is not + * supported. If \a seek_callback is not \c NULL then a + * \a tell_callback, \a length_callback, and \a eof_callback must also be supplied. + * Alternatively, a dummy seek callback that just + * returns \c FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param tell_callback See FLAC__StreamDecoderTellCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a tell_callback must also be supplied. + * Alternatively, a dummy tell callback that just + * returns \c FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param length_callback See FLAC__StreamDecoderLengthCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a length_callback must also be supplied. + * Alternatively, a dummy length callback that just + * returns \c FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param eof_callback See FLAC__StreamDecoderEofCallback. This + * pointer may be \c NULL if not supported by the client. If + * \a seek_callback is not \c NULL then a + * \a eof_callback must also be supplied. + * Alternatively, a dummy length callback that just + * returns \c false + * may also be supplied, all though this is slightly + * less efficient for the decoder. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_stream( + FLAC__StreamDecoder *decoder, + FLAC__StreamDecoderReadCallback read_callback, + FLAC__StreamDecoderSeekCallback seek_callback, + FLAC__StreamDecoderTellCallback tell_callback, + FLAC__StreamDecoderLengthCallback length_callback, + FLAC__StreamDecoderEofCallback eof_callback, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Initialize the decoder instance to decode native FLAC files. + * + * This flavor of initialization sets up the decoder to decode from a + * plain native FLAC file. For non-stdio streams, you must use + * FLAC__stream_decoder_init_stream() and provide callbacks for the I/O. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \param decoder An uninitialized decoder instance. + * \param file An open FLAC file. The file should have been + * opened with mode \c "rb" and rewound. The file + * becomes owned by the decoder and should not be + * manipulated by the client while decoding. + * Unless \a file is \c stdin, it will be closed + * when FLAC__stream_decoder_finish() is called. + * Note however that seeking will not work when + * decoding from \c stdout since it is not seekable. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \code file != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_FILE( + FLAC__StreamDecoder *decoder, + FILE *file, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Initialize the decoder instance to decode Ogg FLAC files. + * + * This flavor of initialization sets up the decoder to decode from a + * plain Ogg FLAC file. For non-stdio streams, you must use + * FLAC__stream_decoder_init_ogg_stream() and provide callbacks for the I/O. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \note Support for Ogg FLAC in the library is optional. If this + * library has been built without support for Ogg FLAC, this function + * will return \c FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER. + * + * \param decoder An uninitialized decoder instance. + * \param file An open FLAC file. The file should have been + * opened with mode \c "rb" and rewound. The file + * becomes owned by the decoder and should not be + * manipulated by the client while decoding. + * Unless \a file is \c stdin, it will be closed + * when FLAC__stream_decoder_finish() is called. + * Note however that seeking will not work when + * decoding from \c stdout since it is not seekable. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \code file != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_FILE( + FLAC__StreamDecoder *decoder, + FILE *file, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Initialize the decoder instance to decode native FLAC files. + * + * This flavor of initialization sets up the decoder to decode from a plain + * native FLAC file. If POSIX fopen() semantics are not sufficient, (for + * example, with Unicode filenames on Windows), you must use + * FLAC__stream_decoder_init_FILE(), or FLAC__stream_decoder_init_stream() + * and provide callbacks for the I/O. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \param decoder An uninitialized decoder instance. + * \param filename The name of the file to decode from. The file will + * be opened with fopen(). Use \c NULL to decode from + * \c stdin. Note that \c stdin is not seekable. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_file( + FLAC__StreamDecoder *decoder, + const char *filename, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Initialize the decoder instance to decode Ogg FLAC files. + * + * This flavor of initialization sets up the decoder to decode from a plain + * Ogg FLAC file. If POSIX fopen() semantics are not sufficient, (for + * example, with Unicode filenames on Windows), you must use + * FLAC__stream_decoder_init_ogg_FILE(), or FLAC__stream_decoder_init_ogg_stream() + * and provide callbacks for the I/O. + * + * This function should be called after FLAC__stream_decoder_new() and + * FLAC__stream_decoder_set_*() but before any of the + * FLAC__stream_decoder_process_*() functions. Will set and return the + * decoder state, which will be FLAC__STREAM_DECODER_SEARCH_FOR_METADATA + * if initialization succeeded. + * + * \note Support for Ogg FLAC in the library is optional. If this + * library has been built without support for Ogg FLAC, this function + * will return \c FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER. + * + * \param decoder An uninitialized decoder instance. + * \param filename The name of the file to decode from. The file will + * be opened with fopen(). Use \c NULL to decode from + * \c stdin. Note that \c stdin is not seekable. + * \param write_callback See FLAC__StreamDecoderWriteCallback. This + * pointer must not be \c NULL. + * \param metadata_callback See FLAC__StreamDecoderMetadataCallback. This + * pointer may be \c NULL if the callback is not + * desired. + * \param error_callback See FLAC__StreamDecoderErrorCallback. This + * pointer must not be \c NULL. + * \param client_data This value will be supplied to callbacks in their + * \a client_data argument. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__StreamDecoderInitStatus + * \c FLAC__STREAM_DECODER_INIT_STATUS_OK if initialization was successful; + * see FLAC__StreamDecoderInitStatus for the meanings of other return values. + */ +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_file( + FLAC__StreamDecoder *decoder, + const char *filename, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +); + +/** Finish the decoding process. + * Flushes the decoding buffer, releases resources, resets the decoder + * settings to their defaults, and returns the decoder state to + * FLAC__STREAM_DECODER_UNINITIALIZED. + * + * In the event of a prematurely-terminated decode, it is not strictly + * necessary to call this immediately before FLAC__stream_decoder_delete() + * but it is good practice to match every FLAC__stream_decoder_init_*() + * with a FLAC__stream_decoder_finish(). + * + * \param decoder An uninitialized decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if MD5 checking is on AND a STREAMINFO block was available + * AND the MD5 signature in the STREAMINFO block was non-zero AND the + * signature does not match the one computed by the decoder; else + * \c true. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_finish(FLAC__StreamDecoder *decoder); + +/** Flush the stream input. + * The decoder's input buffer will be cleared and the state set to + * \c FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC. This will also turn + * off MD5 checking. + * + * \param decoder A decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c true if successful, else \c false if a memory allocation + * error occurs (in which case the state will be set to + * \c FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_flush(FLAC__StreamDecoder *decoder); + +/** Reset the decoding process. + * The decoder's input buffer will be cleared and the state set to + * \c FLAC__STREAM_DECODER_SEARCH_FOR_METADATA. This is similar to + * FLAC__stream_decoder_finish() except that the settings are + * preserved; there is no need to call FLAC__stream_decoder_init_*() + * before decoding again. MD5 checking will be restored to its original + * setting. + * + * If the decoder is seekable, or was initialized with + * FLAC__stream_decoder_init*_FILE() or FLAC__stream_decoder_init*_file(), + * the decoder will also attempt to seek to the beginning of the file. + * If this rewind fails, this function will return \c false. It follows + * that FLAC__stream_decoder_reset() cannot be used when decoding from + * \c stdin. + * + * If the decoder was initialized with FLAC__stream_encoder_init*_stream() + * and is not seekable (i.e. no seek callback was provided or the seek + * callback returns \c FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED), it + * is the duty of the client to start feeding data from the beginning of + * the stream on the next FLAC__stream_decoder_process() or + * FLAC__stream_decoder_process_interleaved() call. + * + * \param decoder A decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c true if successful, else \c false if a memory allocation occurs + * (in which case the state will be set to + * \c FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR) or a seek error + * occurs (the state will be unchanged). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_reset(FLAC__StreamDecoder *decoder); + +/** Decode one metadata block or audio frame. + * This version instructs the decoder to decode a either a single metadata + * block or a single frame and stop, unless the callbacks return a fatal + * error or the read callback returns + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM. + * + * As the decoder needs more input it will call the read callback. + * Depending on what was decoded, the metadata or write callback will be + * called with the decoded metadata block or audio frame. + * + * Unless there is a fatal read error or end of stream, this function + * will return once one whole frame is decoded. In other words, if the + * stream is not synchronized or points to a corrupt frame header, the + * decoder will continue to try and resync until it gets to a valid + * frame, then decode one frame, then return. If the decoder points to + * a frame whose frame CRC in the frame footer does not match the + * computed frame CRC, this function will issue a + * FLAC__STREAM_DECODER_ERROR_STATUS_FRAME_CRC_MISMATCH error to the + * error callback, and return, having decoded one complete, although + * corrupt, frame. (Such corrupted frames are sent as silence of the + * correct length to the write callback.) + * + * \param decoder An initialized decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if any fatal read, write, or memory allocation error + * occurred (meaning decoding must stop), else \c true; for more + * information about the decoder, check the decoder state with + * FLAC__stream_decoder_get_state(). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_process_single(FLAC__StreamDecoder *decoder); + +/** Decode until the end of the metadata. + * This version instructs the decoder to decode from the current position + * and continue until all the metadata has been read, or until the + * callbacks return a fatal error or the read callback returns + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM. + * + * As the decoder needs more input it will call the read callback. + * As each metadata block is decoded, the metadata callback will be called + * with the decoded metadata. + * + * \param decoder An initialized decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if any fatal read, write, or memory allocation error + * occurred (meaning decoding must stop), else \c true; for more + * information about the decoder, check the decoder state with + * FLAC__stream_decoder_get_state(). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_process_until_end_of_metadata(FLAC__StreamDecoder *decoder); + +/** Decode until the end of the stream. + * This version instructs the decoder to decode from the current position + * and continue until the end of stream (the read callback returns + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM), or until the + * callbacks return a fatal error. + * + * As the decoder needs more input it will call the read callback. + * As each metadata block and frame is decoded, the metadata or write + * callback will be called with the decoded metadata or frame. + * + * \param decoder An initialized decoder instance. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if any fatal read, write, or memory allocation error + * occurred (meaning decoding must stop), else \c true; for more + * information about the decoder, check the decoder state with + * FLAC__stream_decoder_get_state(). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_process_until_end_of_stream(FLAC__StreamDecoder *decoder); + +/** Skip one audio frame. + * This version instructs the decoder to 'skip' a single frame and stop, + * unless the callbacks return a fatal error or the read callback returns + * \c FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM. + * + * The decoding flow is the same as what occurs when + * FLAC__stream_decoder_process_single() is called to process an audio + * frame, except that this function does not decode the parsed data into + * PCM or call the write callback. The integrity of the frame is still + * checked the same way as in the other process functions. + * + * This function will return once one whole frame is skipped, in the + * same way that FLAC__stream_decoder_process_single() will return once + * one whole frame is decoded. + * + * This function can be used in more quickly determining FLAC frame + * boundaries when decoding of the actual data is not needed, for + * example when an application is separating a FLAC stream into frames + * for editing or storing in a container. To do this, the application + * can use FLAC__stream_decoder_skip_single_frame() to quickly advance + * to the next frame, then use + * FLAC__stream_decoder_get_decode_position() to find the new frame + * boundary. + * + * This function should only be called when the stream has advanced + * past all the metadata, otherwise it will return \c false. + * + * \param decoder An initialized decoder instance not in a metadata + * state. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c false if any fatal read, write, or memory allocation error + * occurred (meaning decoding must stop), or if the decoder + * is in the FLAC__STREAM_DECODER_SEARCH_FOR_METADATA or + * FLAC__STREAM_DECODER_READ_METADATA state, else \c true; for more + * information about the decoder, check the decoder state with + * FLAC__stream_decoder_get_state(). + */ +FLAC_API FLAC__bool FLAC__stream_decoder_skip_single_frame(FLAC__StreamDecoder *decoder); + +/** Flush the input and seek to an absolute sample. + * Decoding will resume at the given sample. Note that because of + * this, the next write callback may contain a partial block. The + * client must support seeking the input or this function will fail + * and return \c false. Furthermore, if the decoder state is + * \c FLAC__STREAM_DECODER_SEEK_ERROR, then the decoder must be flushed + * with FLAC__stream_decoder_flush() or reset with + * FLAC__stream_decoder_reset() before decoding can continue. + * + * \param decoder A decoder instance. + * \param sample The target sample number to seek to. + * \assert + * \code decoder != NULL \endcode + * \retval FLAC__bool + * \c true if successful, else \c false. + */ +FLAC_API FLAC__bool FLAC__stream_decoder_seek_absolute(FLAC__StreamDecoder *decoder, FLAC__uint64 sample); + +/* \} */ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/FLAC/stream_encoder.h b/src/libflac/FLAC/stream_encoder.h new file mode 100644 index 0000000..40a2fd3 --- /dev/null +++ b/src/libflac/FLAC/stream_encoder.h @@ -0,0 +1,1790 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__STREAM_ENCODER_H +#define FLAC__STREAM_ENCODER_H + +#include /* for FILE */ +#include "export.h" +#include "format.h" +#include "stream_decoder.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +/** \file include/FLAC/stream_encoder.h + * + * \brief + * This module contains the functions which implement the stream + * encoder. + * + * See the detailed documentation in the + * \link flac_stream_encoder stream encoder \endlink module. + */ + +/** \defgroup flac_encoder FLAC/ \*_encoder.h: encoder interfaces + * \ingroup flac + * + * \brief + * This module describes the encoder layers provided by libFLAC. + * + * The stream encoder can be used to encode complete streams either to the + * client via callbacks, or directly to a file, depending on how it is + * initialized. When encoding via callbacks, the client provides a write + * callback which will be called whenever FLAC data is ready to be written. + * If the client also supplies a seek callback, the encoder will also + * automatically handle the writing back of metadata discovered while + * encoding, like stream info, seek points offsets, etc. When encoding to + * a file, the client needs only supply a filename or open \c FILE* and an + * optional progress callback for periodic notification of progress; the + * write and seek callbacks are supplied internally. For more info see the + * \link flac_stream_encoder stream encoder \endlink module. + */ + +/** \defgroup flac_stream_encoder FLAC/stream_encoder.h: stream encoder interface + * \ingroup flac_encoder + * + * \brief + * This module contains the functions which implement the stream + * encoder. + * + * The stream encoder can encode to native FLAC, and optionally Ogg FLAC + * (check FLAC_API_SUPPORTS_OGG_FLAC) streams and files. + * + * The basic usage of this encoder is as follows: + * - The program creates an instance of an encoder using + * FLAC__stream_encoder_new(). + * - The program overrides the default settings using + * FLAC__stream_encoder_set_*() functions. At a minimum, the following + * functions should be called: + * - FLAC__stream_encoder_set_channels() + * - FLAC__stream_encoder_set_bits_per_sample() + * - FLAC__stream_encoder_set_sample_rate() + * - FLAC__stream_encoder_set_ogg_serial_number() (if encoding to Ogg FLAC) + * - FLAC__stream_encoder_set_total_samples_estimate() (if known) + * - If the application wants to control the compression level or set its own + * metadata, then the following should also be called: + * - FLAC__stream_encoder_set_compression_level() + * - FLAC__stream_encoder_set_verify() + * - FLAC__stream_encoder_set_metadata() + * - The rest of the set functions should only be called if the client needs + * exact control over how the audio is compressed; thorough understanding + * of the FLAC format is necessary to achieve good results. + * - The program initializes the instance to validate the settings and + * prepare for encoding using + * - FLAC__stream_encoder_init_stream() or FLAC__stream_encoder_init_FILE() + * or FLAC__stream_encoder_init_file() for native FLAC + * - FLAC__stream_encoder_init_ogg_stream() or FLAC__stream_encoder_init_ogg_FILE() + * or FLAC__stream_encoder_init_ogg_file() for Ogg FLAC + * - The program calls FLAC__stream_encoder_process() or + * FLAC__stream_encoder_process_interleaved() to encode data, which + * subsequently calls the callbacks when there is encoder data ready + * to be written. + * - The program finishes the encoding with FLAC__stream_encoder_finish(), + * which causes the encoder to encode any data still in its input pipe, + * update the metadata with the final encoding statistics if output + * seeking is possible, and finally reset the encoder to the + * uninitialized state. + * - The instance may be used again or deleted with + * FLAC__stream_encoder_delete(). + * + * In more detail, the stream encoder functions similarly to the + * \link flac_stream_decoder stream decoder \endlink, but has fewer + * callbacks and more options. Typically the client will create a new + * instance by calling FLAC__stream_encoder_new(), then set the necessary + * parameters with FLAC__stream_encoder_set_*(), and initialize it by + * calling one of the FLAC__stream_encoder_init_*() functions. + * + * Unlike the decoders, the stream encoder has many options that can + * affect the speed and compression ratio. When setting these parameters + * you should have some basic knowledge of the format (see the + * user-level documentation + * or the formal description). The + * FLAC__stream_encoder_set_*() functions themselves do not validate the + * values as many are interdependent. The FLAC__stream_encoder_init_*() + * functions will do this, so make sure to pay attention to the state + * returned by FLAC__stream_encoder_init_*() to make sure that it is + * FLAC__STREAM_ENCODER_INIT_STATUS_OK. Any parameters that are not set + * before FLAC__stream_encoder_init_*() will take on the defaults from + * the constructor. + * + * There are three initialization functions for native FLAC, one for + * setting up the encoder to encode FLAC data to the client via + * callbacks, and two for encoding directly to a file. + * + * For encoding via callbacks, use FLAC__stream_encoder_init_stream(). + * You must also supply a write callback which will be called anytime + * there is raw encoded data to write. If the client can seek the output + * it is best to also supply seek and tell callbacks, as this allows the + * encoder to go back after encoding is finished to write back + * information that was collected while encoding, like seek point offsets, + * frame sizes, etc. + * + * For encoding directly to a file, use FLAC__stream_encoder_init_FILE() + * or FLAC__stream_encoder_init_file(). Then you must only supply a + * filename or open \c FILE*; the encoder will handle all the callbacks + * internally. You may also supply a progress callback for periodic + * notification of the encoding progress. + * + * There are three similarly-named init functions for encoding to Ogg + * FLAC streams. Check \c FLAC_API_SUPPORTS_OGG_FLAC to find out if the + * library has been built with Ogg support. + * + * The call to FLAC__stream_encoder_init_*() currently will also immediately + * call the write callback several times, once with the \c fLaC signature, + * and once for each encoded metadata block. Note that for Ogg FLAC + * encoding you will usually get at least twice the number of callbacks than + * with native FLAC, one for the Ogg page header and one for the page body. + * + * After initializing the instance, the client may feed audio data to the + * encoder in one of two ways: + * + * - Channel separate, through FLAC__stream_encoder_process() - The client + * will pass an array of pointers to buffers, one for each channel, to + * the encoder, each of the same length. The samples need not be + * block-aligned, but each channel should have the same number of samples. + * - Channel interleaved, through + * FLAC__stream_encoder_process_interleaved() - The client will pass a single + * pointer to data that is channel-interleaved (i.e. channel0_sample0, + * channel1_sample0, ... , channelN_sample0, channel0_sample1, ...). + * Again, the samples need not be block-aligned but they must be + * sample-aligned, i.e. the first value should be channel0_sample0 and + * the last value channelN_sampleM. + * + * Note that for either process call, each sample in the buffers should be a + * signed integer, right-justified to the resolution set by + * FLAC__stream_encoder_set_bits_per_sample(). For example, if the resolution + * is 16 bits per sample, the samples should all be in the range [-32768,32767]. + * + * When the client is finished encoding data, it calls + * FLAC__stream_encoder_finish(), which causes the encoder to encode any + * data still in its input pipe, and call the metadata callback with the + * final encoding statistics. Then the instance may be deleted with + * FLAC__stream_encoder_delete() or initialized again to encode another + * stream. + * + * For programs that write their own metadata, but that do not know the + * actual metadata until after encoding, it is advantageous to instruct + * the encoder to write a PADDING block of the correct size, so that + * instead of rewriting the whole stream after encoding, the program can + * just overwrite the PADDING block. If only the maximum size of the + * metadata is known, the program can write a slightly larger padding + * block, then split it after encoding. + * + * Make sure you understand how lengths are calculated. All FLAC metadata + * blocks have a 4 byte header which contains the type and length. This + * length does not include the 4 bytes of the header. See the format page + * for the specification of metadata blocks and their lengths. + * + * \note + * If you are writing the FLAC data to a file via callbacks, make sure it + * is open for update (e.g. mode "w+" for stdio streams). This is because + * after the first encoding pass, the encoder will try to seek back to the + * beginning of the stream, to the STREAMINFO block, to write some data + * there. (If using FLAC__stream_encoder_init*_file() or + * FLAC__stream_encoder_init*_FILE(), the file is managed internally.) + * + * \note + * The "set" functions may only be called when the encoder is in the + * state FLAC__STREAM_ENCODER_UNINITIALIZED, i.e. after + * FLAC__stream_encoder_new() or FLAC__stream_encoder_finish(), but + * before FLAC__stream_encoder_init_*(). If this is the case they will + * return \c true, otherwise \c false. + * + * \note + * FLAC__stream_encoder_finish() resets all settings to the constructor + * defaults. + * + * \{ + */ + + +/** State values for a FLAC__StreamEncoder. + * + * The encoder's state can be obtained by calling FLAC__stream_encoder_get_state(). + * + * If the encoder gets into any other state besides \c FLAC__STREAM_ENCODER_OK + * or \c FLAC__STREAM_ENCODER_UNINITIALIZED, it becomes invalid for encoding and + * must be deleted with FLAC__stream_encoder_delete(). + */ +typedef enum { + + FLAC__STREAM_ENCODER_OK = 0, + /**< The encoder is in the normal OK state and samples can be processed. */ + + FLAC__STREAM_ENCODER_UNINITIALIZED, + /**< The encoder is in the uninitialized state; one of the + * FLAC__stream_encoder_init_*() functions must be called before samples + * can be processed. + */ + + FLAC__STREAM_ENCODER_OGG_ERROR, + /**< An error occurred in the underlying Ogg layer. */ + + FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR, + /**< An error occurred in the underlying verify stream decoder; + * check FLAC__stream_encoder_get_verify_decoder_state(). + */ + + FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA, + /**< The verify decoder detected a mismatch between the original + * audio signal and the decoded audio signal. + */ + + FLAC__STREAM_ENCODER_CLIENT_ERROR, + /**< One of the callbacks returned a fatal error. */ + + FLAC__STREAM_ENCODER_IO_ERROR, + /**< An I/O error occurred while opening/reading/writing a file. + * Check \c errno. + */ + + FLAC__STREAM_ENCODER_FRAMING_ERROR, + /**< An error occurred while writing the stream; usually, the + * write_callback returned an error. + */ + + FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR + /**< Memory allocation failed. */ + +} FLAC__StreamEncoderState; + +/** Maps a FLAC__StreamEncoderState to a C string. + * + * Using a FLAC__StreamEncoderState as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderStateString[]; + + +/** Possible return values for the FLAC__stream_encoder_init_*() functions. + */ +typedef enum { + + FLAC__STREAM_ENCODER_INIT_STATUS_OK = 0, + /**< Initialization was successful. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR, + /**< General failure to set up encoder; call FLAC__stream_encoder_get_state() for cause. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_UNSUPPORTED_CONTAINER, + /**< The library was not compiled with support for the given container + * format. + */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_CALLBACKS, + /**< A required callback was not supplied. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_NUMBER_OF_CHANNELS, + /**< The encoder has an invalid setting for number of channels. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BITS_PER_SAMPLE, + /**< The encoder has an invalid setting for bits-per-sample. + * FLAC supports 4-32 bps but the reference encoder currently supports + * only up to 24 bps. + */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_SAMPLE_RATE, + /**< The encoder has an invalid setting for the input sample rate. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BLOCK_SIZE, + /**< The encoder has an invalid setting for the block size. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_MAX_LPC_ORDER, + /**< The encoder has an invalid setting for the maximum LPC order. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_QLP_COEFF_PRECISION, + /**< The encoder has an invalid setting for the precision of the quantized linear predictor coefficients. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER, + /**< The specified block size is less than the maximum LPC order. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE, + /**< The encoder is bound to the Subset but other settings violate it. */ + + FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA, + /**< The metadata input to the encoder is invalid, in one of the following ways: + * - FLAC__stream_encoder_set_metadata() was called with a null pointer but a block count > 0 + * - One of the metadata blocks contains an undefined type + * - It contains an illegal CUESHEET as checked by FLAC__format_cuesheet_is_legal() + * - It contains an illegal SEEKTABLE as checked by FLAC__format_seektable_is_legal() + * - It contains more than one SEEKTABLE block or more than one VORBIS_COMMENT block + */ + + FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED + /**< FLAC__stream_encoder_init_*() was called when the encoder was + * already initialized, usually because + * FLAC__stream_encoder_finish() was not called. + */ + +} FLAC__StreamEncoderInitStatus; + +/** Maps a FLAC__StreamEncoderInitStatus to a C string. + * + * Using a FLAC__StreamEncoderInitStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderInitStatusString[]; + + +/** Return values for the FLAC__StreamEncoder read callback. + */ +typedef enum { + + FLAC__STREAM_ENCODER_READ_STATUS_CONTINUE, + /**< The read was OK and decoding can continue. */ + + FLAC__STREAM_ENCODER_READ_STATUS_END_OF_STREAM, + /**< The read was attempted at the end of the stream. */ + + FLAC__STREAM_ENCODER_READ_STATUS_ABORT, + /**< An unrecoverable error occurred. */ + + FLAC__STREAM_ENCODER_READ_STATUS_UNSUPPORTED + /**< Client does not support reading back from the output. */ + +} FLAC__StreamEncoderReadStatus; + +/** Maps a FLAC__StreamEncoderReadStatus to a C string. + * + * Using a FLAC__StreamEncoderReadStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderReadStatusString[]; + + +/** Return values for the FLAC__StreamEncoder write callback. + */ +typedef enum { + + FLAC__STREAM_ENCODER_WRITE_STATUS_OK = 0, + /**< The write was OK and encoding can continue. */ + + FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR + /**< An unrecoverable error occurred. The encoder will return from the process call. */ + +} FLAC__StreamEncoderWriteStatus; + +/** Maps a FLAC__StreamEncoderWriteStatus to a C string. + * + * Using a FLAC__StreamEncoderWriteStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderWriteStatusString[]; + + +/** Return values for the FLAC__StreamEncoder seek callback. + */ +typedef enum { + + FLAC__STREAM_ENCODER_SEEK_STATUS_OK, + /**< The seek was OK and encoding can continue. */ + + FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR, + /**< An unrecoverable error occurred. */ + + FLAC__STREAM_ENCODER_SEEK_STATUS_UNSUPPORTED + /**< Client does not support seeking. */ + +} FLAC__StreamEncoderSeekStatus; + +/** Maps a FLAC__StreamEncoderSeekStatus to a C string. + * + * Using a FLAC__StreamEncoderSeekStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderSeekStatusString[]; + + +/** Return values for the FLAC__StreamEncoder tell callback. + */ +typedef enum { + + FLAC__STREAM_ENCODER_TELL_STATUS_OK, + /**< The tell was OK and encoding can continue. */ + + FLAC__STREAM_ENCODER_TELL_STATUS_ERROR, + /**< An unrecoverable error occurred. */ + + FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED + /**< Client does not support seeking. */ + +} FLAC__StreamEncoderTellStatus; + +/** Maps a FLAC__StreamEncoderTellStatus to a C string. + * + * Using a FLAC__StreamEncoderTellStatus as the index to this array + * will give the string equivalent. The contents should not be modified. + */ +extern FLAC_API const char * const FLAC__StreamEncoderTellStatusString[]; + + +/*********************************************************************** + * + * class FLAC__StreamEncoder + * + ***********************************************************************/ + +struct FLAC__StreamEncoderProtected; +struct FLAC__StreamEncoderPrivate; +/** The opaque structure definition for the stream encoder type. + * See the \link flac_stream_encoder stream encoder module \endlink + * for a detailed description. + */ +typedef struct { + struct FLAC__StreamEncoderProtected *protected_; /* avoid the C++ keyword 'protected' */ + struct FLAC__StreamEncoderPrivate *private_; /* avoid the C++ keyword 'private' */ +} FLAC__StreamEncoder; + +/** Signature for the read callback. + * + * A function pointer matching this signature must be passed to + * FLAC__stream_encoder_init_ogg_stream() if seeking is supported. + * The supplied function will be called when the encoder needs to read back + * encoded data. This happens during the metadata callback, when the encoder + * has to read, modify, and rewrite the metadata (e.g. seekpoints) gathered + * while encoding. The address of the buffer to be filled is supplied, along + * with the number of bytes the buffer can hold. The callback may choose to + * supply less data and modify the byte count but must be careful not to + * overflow the buffer. The callback then returns a status code chosen from + * FLAC__StreamEncoderReadStatus. + * + * Here is an example of a read callback for stdio streams: + * \code + * FLAC__StreamEncoderReadStatus read_cb(const FLAC__StreamEncoder *encoder, FLAC__byte buffer[], size_t *bytes, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * if(*bytes > 0) { + * *bytes = fread(buffer, sizeof(FLAC__byte), *bytes, file); + * if(ferror(file)) + * return FLAC__STREAM_ENCODER_READ_STATUS_ABORT; + * else if(*bytes == 0) + * return FLAC__STREAM_ENCODER_READ_STATUS_END_OF_STREAM; + * else + * return FLAC__STREAM_ENCODER_READ_STATUS_CONTINUE; + * } + * else + * return FLAC__STREAM_ENCODER_READ_STATUS_ABORT; + * } + * \endcode + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param buffer A pointer to a location for the callee to store + * data to be encoded. + * \param bytes A pointer to the size of the buffer. On entry + * to the callback, it contains the maximum number + * of bytes that may be stored in \a buffer. The + * callee must set it to the actual number of bytes + * stored (0 in case of error or end-of-stream) before + * returning. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_set_client_data(). + * \retval FLAC__StreamEncoderReadStatus + * The callee's return status. + */ +typedef FLAC__StreamEncoderReadStatus (*FLAC__StreamEncoderReadCallback)(const FLAC__StreamEncoder *encoder, FLAC__byte buffer[], size_t *bytes, void *client_data); + +/** Signature for the write callback. + * + * A function pointer matching this signature must be passed to + * FLAC__stream_encoder_init*_stream(). The supplied function will be called + * by the encoder anytime there is raw encoded data ready to write. It may + * include metadata mixed with encoded audio frames and the data is not + * guaranteed to be aligned on frame or metadata block boundaries. + * + * The only duty of the callback is to write out the \a bytes worth of data + * in \a buffer to the current position in the output stream. The arguments + * \a samples and \a current_frame are purely informational. If \a samples + * is greater than \c 0, then \a current_frame will hold the current frame + * number that is being written; otherwise it indicates that the write + * callback is being called to write metadata. + * + * \note + * Unlike when writing to native FLAC, when writing to Ogg FLAC the + * write callback will be called twice when writing each audio + * frame; once for the page header, and once for the page body. + * When writing the page header, the \a samples argument to the + * write callback will be \c 0. + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param buffer An array of encoded data of length \a bytes. + * \param bytes The byte length of \a buffer. + * \param samples The number of samples encoded by \a buffer. + * \c 0 has a special meaning; see above. + * \param current_frame The number of the current frame being encoded. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_init_*(). + * \retval FLAC__StreamEncoderWriteStatus + * The callee's return status. + */ +typedef FLAC__StreamEncoderWriteStatus (*FLAC__StreamEncoderWriteCallback)(const FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, unsigned current_frame, void *client_data); + +/** Signature for the seek callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_encoder_init*_stream(). The supplied function will be called + * when the encoder needs to seek the output stream. The encoder will pass + * the absolute byte offset to seek to, 0 meaning the beginning of the stream. + * + * Here is an example of a seek callback for stdio streams: + * \code + * FLAC__StreamEncoderSeekStatus seek_cb(const FLAC__StreamEncoder *encoder, FLAC__uint64 absolute_byte_offset, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * if(file == stdin) + * return FLAC__STREAM_ENCODER_SEEK_STATUS_UNSUPPORTED; + * else if(fseeko(file, (off_t)absolute_byte_offset, SEEK_SET) < 0) + * return FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR; + * else + * return FLAC__STREAM_ENCODER_SEEK_STATUS_OK; + * } + * \endcode + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param absolute_byte_offset The offset from the beginning of the stream + * to seek to. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_init_*(). + * \retval FLAC__StreamEncoderSeekStatus + * The callee's return status. + */ +typedef FLAC__StreamEncoderSeekStatus (*FLAC__StreamEncoderSeekCallback)(const FLAC__StreamEncoder *encoder, FLAC__uint64 absolute_byte_offset, void *client_data); + +/** Signature for the tell callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_encoder_init*_stream(). The supplied function will be called + * when the encoder needs to know the current position of the output stream. + * + * \warning + * The callback must return the true current byte offset of the output to + * which the encoder is writing. If you are buffering the output, make + * sure and take this into account. If you are writing directly to a + * FILE* from your write callback, ftell() is sufficient. If you are + * writing directly to a file descriptor from your write callback, you + * can use lseek(fd, SEEK_CUR, 0). The encoder may later seek back to + * these points to rewrite metadata after encoding. + * + * Here is an example of a tell callback for stdio streams: + * \code + * FLAC__StreamEncoderTellStatus tell_cb(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_byte_offset, void *client_data) + * { + * FILE *file = ((MyClientData*)client_data)->file; + * off_t pos; + * if(file == stdin) + * return FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED; + * else if((pos = ftello(file)) < 0) + * return FLAC__STREAM_ENCODER_TELL_STATUS_ERROR; + * else { + * *absolute_byte_offset = (FLAC__uint64)pos; + * return FLAC__STREAM_ENCODER_TELL_STATUS_OK; + * } + * } + * \endcode + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param absolute_byte_offset The address at which to store the current + * position of the output. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_init_*(). + * \retval FLAC__StreamEncoderTellStatus + * The callee's return status. + */ +typedef FLAC__StreamEncoderTellStatus (*FLAC__StreamEncoderTellCallback)(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_byte_offset, void *client_data); + +/** Signature for the metadata callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_encoder_init*_stream(). The supplied function will be called + * once at the end of encoding with the populated STREAMINFO structure. This + * is so the client can seek back to the beginning of the file and write the + * STREAMINFO block with the correct statistics after encoding (like + * minimum/maximum frame size and total samples). + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param metadata The final populated STREAMINFO block. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_init_*(). + */ +typedef void (*FLAC__StreamEncoderMetadataCallback)(const FLAC__StreamEncoder *encoder, const FLAC__StreamMetadata *metadata, void *client_data); + +/** Signature for the progress callback. + * + * A function pointer matching this signature may be passed to + * FLAC__stream_encoder_init*_file() or FLAC__stream_encoder_init*_FILE(). + * The supplied function will be called when the encoder has finished + * writing a frame. The \c total_frames_estimate argument to the + * callback will be based on the value from + * FLAC__stream_encoder_set_total_samples_estimate(). + * + * \note In general, FLAC__StreamEncoder functions which change the + * state should not be called on the \a encoder while in the callback. + * + * \param encoder The encoder instance calling the callback. + * \param bytes_written Bytes written so far. + * \param samples_written Samples written so far. + * \param frames_written Frames written so far. + * \param total_frames_estimate The estimate of the total number of + * frames to be written. + * \param client_data The callee's client data set through + * FLAC__stream_encoder_init_*(). + */ +typedef void (*FLAC__StreamEncoderProgressCallback)(const FLAC__StreamEncoder *encoder, FLAC__uint64 bytes_written, FLAC__uint64 samples_written, unsigned frames_written, unsigned total_frames_estimate, void *client_data); + + +/*********************************************************************** + * + * Class constructor/destructor + * + ***********************************************************************/ + +/** Create a new stream encoder instance. The instance is created with + * default settings; see the individual FLAC__stream_encoder_set_*() + * functions for each setting's default. + * + * \retval FLAC__StreamEncoder* + * \c NULL if there was an error allocating memory, else the new instance. + */ +FLAC_API FLAC__StreamEncoder *FLAC__stream_encoder_new(void); + +/** Free an encoder instance. Deletes the object pointed to by \a encoder. + * + * \param encoder A pointer to an existing encoder. + * \assert + * \code encoder != NULL \endcode + */ +FLAC_API void FLAC__stream_encoder_delete(FLAC__StreamEncoder *encoder); + + +/*********************************************************************** + * + * Public class method prototypes + * + ***********************************************************************/ + +/** Set the serial number for the FLAC stream to use in the Ogg container. + * + * \note + * This does not need to be set for native FLAC encoding. + * + * \note + * It is recommended to set a serial number explicitly as the default of '0' + * may collide with other streams. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param serial_number See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_ogg_serial_number(FLAC__StreamEncoder *encoder, long serial_number); + +/** Set the "verify" flag. If \c true, the encoder will verify it's own + * encoded output by feeding it through an internal decoder and comparing + * the original signal against the decoded signal. If a mismatch occurs, + * the process call will return \c false. Note that this will slow the + * encoding process by the extra time required for decoding and comparison. + * + * \default \c false + * \param encoder An encoder instance to set. + * \param value Flag value (see above). + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_verify(FLAC__StreamEncoder *encoder, FLAC__bool value); + +/** Set the Subset flag. If \c true, + * the encoder will comply with the Subset and will check the + * settings during FLAC__stream_encoder_init_*() to see if all settings + * comply. If \c false, the settings may take advantage of the full + * range that the format allows. + * + * Make sure you know what it entails before setting this to \c false. + * + * \default \c true + * \param encoder An encoder instance to set. + * \param value Flag value (see above). + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_streamable_subset(FLAC__StreamEncoder *encoder, FLAC__bool value); + +/** Set the number of channels to be encoded. + * + * \default \c 2 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_channels(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set the sample resolution of the input to be encoded. + * + * \warning + * Do not feed the encoder data that is wider than the value you + * set here or you will generate an invalid stream. + * + * \default \c 16 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_bits_per_sample(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set the sample rate (in Hz) of the input to be encoded. + * + * \default \c 44100 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_sample_rate(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set the compression level + * + * The compression level is roughly proportional to the amount of effort + * the encoder expends to compress the file. A higher level usually + * means more computation but higher compression. The default level is + * suitable for most applications. + * + * Currently the levels range from \c 0 (fastest, least compression) to + * \c 8 (slowest, most compression). A value larger than \c 8 will be + * treated as \c 8. + * + * This function automatically calls the following other \c _set_ + * functions with appropriate values, so the client does not need to + * unless it specifically wants to override them: + * - FLAC__stream_encoder_set_do_mid_side_stereo() + * - FLAC__stream_encoder_set_loose_mid_side_stereo() + * - FLAC__stream_encoder_set_apodization() + * - FLAC__stream_encoder_set_max_lpc_order() + * - FLAC__stream_encoder_set_qlp_coeff_precision() + * - FLAC__stream_encoder_set_do_qlp_coeff_prec_search() + * - FLAC__stream_encoder_set_do_escape_coding() + * - FLAC__stream_encoder_set_do_exhaustive_model_search() + * - FLAC__stream_encoder_set_min_residual_partition_order() + * - FLAC__stream_encoder_set_max_residual_partition_order() + * - FLAC__stream_encoder_set_rice_parameter_search_dist() + * + * The actual values set for each level are: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
leveldo mid-side stereoloose mid-side stereoapodizationmax lpc orderqlp coeff precisionqlp coeff prec searchescape codingexhaustive model searchmin residual partition ordermax residual partition orderrice parameter search dist
0 false false tukey(0.5) 0 0 false false false 0 3 0
1 true true tukey(0.5) 0 0 false false false 0 3 0
2 true false tukey(0.5) 0 0 false false false 0 3 0
3 false false tukey(0.5) 6 0 false false false 0 4 0
4 true true tukey(0.5) 8 0 false false false 0 4 0
5 true false tukey(0.5) 8 0 false false false 0 5 0
6 true false tukey(0.5);partial_tukey(2) 8 0 false false false 0 6 0
7 true false tukey(0.5);partial_tukey(2) 12 0 false false false 0 6 0
8 true false tukey(0.5);partial_tukey(2);punchout_tukey(3) 12 0 false false false 0 6 0
+ * + * \default \c 5 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_compression_level(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set the blocksize to use while encoding. + * + * The number of samples to use per frame. Use \c 0 to let the encoder + * estimate a blocksize; this is usually best. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_blocksize(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set to \c true to enable mid-side encoding on stereo input. The + * number of channels must be 2 for this to have any effect. Set to + * \c false to use only independent channel coding. + * + * \default \c false + * \param encoder An encoder instance to set. + * \param value Flag value (see above). + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_do_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value); + +/** Set to \c true to enable adaptive switching between mid-side and + * left-right encoding on stereo input. Set to \c false to use + * exhaustive searching. Setting this to \c true requires + * FLAC__stream_encoder_set_do_mid_side_stereo() to also be set to + * \c true in order to have any effect. + * + * \default \c false + * \param encoder An encoder instance to set. + * \param value Flag value (see above). + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_loose_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value); + +/** Sets the apodization function(s) the encoder will use when windowing + * audio data for LPC analysis. + * + * The \a specification is a plain ASCII string which specifies exactly + * which functions to use. There may be more than one (up to 32), + * separated by \c ';' characters. Some functions take one or more + * comma-separated arguments in parentheses. + * + * The available functions are \c bartlett, \c bartlett_hann, + * \c blackman, \c blackman_harris_4term_92db, \c connes, \c flattop, + * \c gauss(STDDEV), \c hamming, \c hann, \c kaiser_bessel, \c nuttall, + * \c rectangle, \c triangle, \c tukey(P), \c partial_tukey(n[/ov[/P]]), + * \c punchout_tukey(n[/ov[/P]]), \c welch. + * + * For \c gauss(STDDEV), STDDEV specifies the standard deviation + * (0blocksize / (2 ^ order). + * + * Set both min and max values to \c 0 to force a single context, + * whose Rice parameter is based on the residual signal variance. + * Otherwise, set a min and max order, and the encoder will search + * all orders, using the mean of each context for its Rice parameter, + * and use the best. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_min_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set the maximum partition order to search when coding the residual. + * This is used in tandem with + * FLAC__stream_encoder_set_min_residual_partition_order(). + * + * The partition order determines the context size in the residual. + * The context size will be approximately blocksize / (2 ^ order). + * + * Set both min and max values to \c 0 to force a single context, + * whose Rice parameter is based on the residual signal variance. + * Otherwise, set a min and max order, and the encoder will search + * all orders, using the mean of each context for its Rice parameter, + * and use the best. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_max_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value); + +/** Deprecated. Setting this value has no effect. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_rice_parameter_search_dist(FLAC__StreamEncoder *encoder, unsigned value); + +/** Set an estimate of the total samples that will be encoded. + * This is merely an estimate and may be set to \c 0 if unknown. + * This value will be written to the STREAMINFO block before encoding, + * and can remove the need for the caller to rewrite the value later + * if the value is known before encoding. + * + * \default \c 0 + * \param encoder An encoder instance to set. + * \param value See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_total_samples_estimate(FLAC__StreamEncoder *encoder, FLAC__uint64 value); + +/** Set the metadata blocks to be emitted to the stream before encoding. + * A value of \c NULL, \c 0 implies no metadata; otherwise, supply an + * array of pointers to metadata blocks. The array is non-const since + * the encoder may need to change the \a is_last flag inside them, and + * in some cases update seek point offsets. Otherwise, the encoder will + * not modify or free the blocks. It is up to the caller to free the + * metadata blocks after encoding finishes. + * + * \note + * The encoder stores only copies of the pointers in the \a metadata array; + * the metadata blocks themselves must survive at least until after + * FLAC__stream_encoder_finish() returns. Do not free the blocks until then. + * + * \note + * The STREAMINFO block is always written and no STREAMINFO block may + * occur in the supplied array. + * + * \note + * By default the encoder does not create a SEEKTABLE. If one is supplied + * in the \a metadata array, but the client has specified that it does not + * support seeking, then the SEEKTABLE will be written verbatim. However + * by itself this is not very useful as the client will not know the stream + * offsets for the seekpoints ahead of time. In order to get a proper + * seektable the client must support seeking. See next note. + * + * \note + * SEEKTABLE blocks are handled specially. Since you will not know + * the values for the seek point stream offsets, you should pass in + * a SEEKTABLE 'template', that is, a SEEKTABLE object with the + * required sample numbers (or placeholder points), with \c 0 for the + * \a frame_samples and \a stream_offset fields for each point. If the + * client has specified that it supports seeking by providing a seek + * callback to FLAC__stream_encoder_init_stream() or both seek AND read + * callback to FLAC__stream_encoder_init_ogg_stream() (or by using + * FLAC__stream_encoder_init*_file() or FLAC__stream_encoder_init*_FILE()), + * then while it is encoding the encoder will fill the stream offsets in + * for you and when encoding is finished, it will seek back and write the + * real values into the SEEKTABLE block in the stream. There are helper + * routines for manipulating seektable template blocks; see metadata.h: + * FLAC__metadata_object_seektable_template_*(). If the client does + * not support seeking, the SEEKTABLE will have inaccurate offsets which + * will slow down or remove the ability to seek in the FLAC stream. + * + * \note + * The encoder instance \b will modify the first \c SEEKTABLE block + * as it transforms the template to a valid seektable while encoding, + * but it is still up to the caller to free all metadata blocks after + * encoding. + * + * \note + * A VORBIS_COMMENT block may be supplied. The vendor string in it + * will be ignored. libFLAC will use it's own vendor string. libFLAC + * will not modify the passed-in VORBIS_COMMENT's vendor string, it + * will simply write it's own into the stream. If no VORBIS_COMMENT + * block is present in the \a metadata array, libFLAC will write an + * empty one, containing only the vendor string. + * + * \note The Ogg FLAC mapping requires that the VORBIS_COMMENT block be + * the second metadata block of the stream. The encoder already supplies + * the STREAMINFO block automatically. If \a metadata does not contain a + * VORBIS_COMMENT block, the encoder will supply that too. Otherwise, if + * \a metadata does contain a VORBIS_COMMENT block and it is not the + * first, the init function will reorder \a metadata by moving the + * VORBIS_COMMENT block to the front; the relative ordering of the other + * blocks will remain as they were. + * + * \note The Ogg FLAC mapping limits the number of metadata blocks per + * stream to \c 65535. If \a num_blocks exceeds this the function will + * return \c false. + * + * \default \c NULL, 0 + * \param encoder An encoder instance to set. + * \param metadata See above. + * \param num_blocks See above. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * \c false if the encoder is already initialized, else \c true. + * \c false if the encoder is already initialized, or if + * \a num_blocks > 65535 if encoding to Ogg FLAC, else \c true. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_set_metadata(FLAC__StreamEncoder *encoder, FLAC__StreamMetadata **metadata, unsigned num_blocks); + +/** Get the current encoder state. + * + * \param encoder An encoder instance to query. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__StreamEncoderState + * The current encoder state. + */ +FLAC_API FLAC__StreamEncoderState FLAC__stream_encoder_get_state(const FLAC__StreamEncoder *encoder); + +/** Get the state of the verify stream decoder. + * Useful when the stream encoder state is + * \c FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR. + * + * \param encoder An encoder instance to query. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__StreamDecoderState + * The verify stream decoder state. + */ +FLAC_API FLAC__StreamDecoderState FLAC__stream_encoder_get_verify_decoder_state(const FLAC__StreamEncoder *encoder); + +/** Get the current encoder state as a C string. + * This version automatically resolves + * \c FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR by getting the + * verify decoder's state. + * + * \param encoder A encoder instance to query. + * \assert + * \code encoder != NULL \endcode + * \retval const char * + * The encoder state as a C string. Do not modify the contents. + */ +FLAC_API const char *FLAC__stream_encoder_get_resolved_state_string(const FLAC__StreamEncoder *encoder); + +/** Get relevant values about the nature of a verify decoder error. + * Useful when the stream encoder state is + * \c FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR. The arguments should + * be addresses in which the stats will be returned, or NULL if value + * is not desired. + * + * \param encoder An encoder instance to query. + * \param absolute_sample The absolute sample number of the mismatch. + * \param frame_number The number of the frame in which the mismatch occurred. + * \param channel The channel in which the mismatch occurred. + * \param sample The number of the sample (relative to the frame) in + * which the mismatch occurred. + * \param expected The expected value for the sample in question. + * \param got The actual value returned by the decoder. + * \assert + * \code encoder != NULL \endcode + */ +FLAC_API void FLAC__stream_encoder_get_verify_decoder_error_stats(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_sample, unsigned *frame_number, unsigned *channel, unsigned *sample, FLAC__int32 *expected, FLAC__int32 *got); + +/** Get the "verify" flag. + * + * \param encoder An encoder instance to query. + * \assert + * \code encoder != NULL \endcode + * \retval FLAC__bool + * See FLAC__stream_encoder_set_verify(). + */ +FLAC_API FLAC__bool FLAC__stream_encoder_get_verify(const FLAC__StreamEncoder *encoder); + +/** Get the frame header. + * + * \param encoder An initialized encoder instance in the OK state. + * \param buffer An array of pointers to each channel's signal. + * \param samples The number of samples in one channel. + * \assert + * \code encoder != NULL \endcode + * \code FLAC__stream_encoder_get_state(encoder) == FLAC__STREAM_ENCODER_OK \endcode + * \retval FLAC__bool + * \c true if successful, else \c false; in this case, check the + * encoder state with FLAC__stream_encoder_get_state() to see what + * went wrong. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_process(FLAC__StreamEncoder *encoder, const FLAC__int32 * const buffer[], unsigned samples); + +/** Submit data for encoding. + * This version allows you to supply the input data where the channels + * are interleaved into a single array (i.e. channel0_sample0, + * channel1_sample0, ... , channelN_sample0, channel0_sample1, ...). + * The samples need not be block-aligned but they must be + * sample-aligned, i.e. the first value should be channel0_sample0 + * and the last value channelN_sampleM. Each sample should be a signed + * integer, right-justified to the resolution set by + * FLAC__stream_encoder_set_bits_per_sample(). For example, if the + * resolution is 16 bits per sample, the samples should all be in the + * range [-32768,32767]. + * + * For applications where channel order is important, channels must + * follow the order as described in the + * frame header. + * + * \param encoder An initialized encoder instance in the OK state. + * \param buffer An array of channel-interleaved data (see above). + * \param samples The number of samples in one channel, the same as for + * FLAC__stream_encoder_process(). For example, if + * encoding two channels, \c 1000 \a samples corresponds + * to a \a buffer of 2000 values. + * \assert + * \code encoder != NULL \endcode + * \code FLAC__stream_encoder_get_state(encoder) == FLAC__STREAM_ENCODER_OK \endcode + * \retval FLAC__bool + * \c true if successful, else \c false; in this case, check the + * encoder state with FLAC__stream_encoder_get_state() to see what + * went wrong. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_process_interleaved(FLAC__StreamEncoder *encoder, const FLAC__int32 buffer[], unsigned samples); + +/* \} */ + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/README b/src/libflac/README new file mode 100644 index 0000000..dd5e6e7 --- /dev/null +++ b/src/libflac/README @@ -0,0 +1,254 @@ +/* FLAC - Free Lossless Audio Codec + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This file is part the FLAC project. FLAC is comprised of several + * components distributed under different licenses. The codec libraries + * are distributed under Xiph.Org's BSD-like license (see the file + * COPYING.Xiph in this distribution). All other programs, libraries, and + * plugins are distributed under the LGPL or GPL (see COPYING.LGPL and + * COPYING.GPL). The documentation is distributed under the Gnu FDL (see + * COPYING.FDL). Each file in the FLAC distribution contains at the top the + * terms under which it may be distributed. + * + * Since this particular file is relevant to all components of FLAC, + * it may be distributed under the Xiph.Org license, which is the least + * restrictive of those mentioned above. See the file COPYING.Xiph in this + * distribution. + */ + + +FLAC is an Open Source lossless audio codec developed by Josh Coalson from 2001 +to 2009. + +From January 2012 FLAC is being maintained by Erik de Castro Lopo under the +auspices of the Xiph.org Foundation. + +FLAC is comprised of + * `libFLAC', a library which implements reference encoders and + decoders for native FLAC and Ogg FLAC, and a metadata interface + * `libFLAC++', a C++ object wrapper library around libFLAC + * `flac', a command-line program for encoding and decoding files + * `metaflac', a command-line program for viewing and editing FLAC + metadata + * player plugin for XMMS + * user and API documentation + +The libraries (libFLAC, libFLAC++) are +licensed under Xiph.org's BSD-like license (see COPYING.Xiph). All other +programs and plugins are licensed under the GNU General Public License +(see COPYING.GPL). The documentation is licensed under the GNU Free +Documentation License (see COPYING.FDL). + + +=============================================================================== +FLAC - 1.3.2 - Contents +=============================================================================== + +- Introduction +- Prerequisites +- Note to embedded developers +- Building in a GNU environment +- Building with Makefile.lite +- Building with MSVC +- Building on Mac OS X + + +=============================================================================== +Introduction +=============================================================================== + +This is the source release for the FLAC project. See + + doc/html/index.html + +for full documentation. + +A brief description of the directory tree: + + doc/ the HTML documentation + examples/ example programs demonstrating the use of libFLAC and libFLAC++ + include/ public include files for libFLAC and libFLAC++ + man/ the man pages for `flac' and `metaflac' + src/ the source code and private headers + test/ the test scripts + +If you have questions about building FLAC that this document does not answer, +please submit them at the following tracker so this document can be improved: + + https://sourceforge.net/p/flac/support-requests/ + + +=============================================================================== +Prerequisites +=============================================================================== + +To build FLAC with support for Ogg FLAC you must have built and installed +libogg according to the specific instructions below. You must have +libogg 1.1.2 or greater, or there will be seeking problems with Ogg FLAC. + +If you are building on x86 and want the assembly optimizations, you will +need to have NASM >= 0.98.30 installed according to the specific instructions +below. + + +=============================================================================== +Note to embedded developers +=============================================================================== + +libFLAC has grown larger over time as more functionality has been +included, but much of it may be unnecessary for a particular embedded +implementation. Unused parts may be pruned by some simple editing of +configure.ac and src/libFLAC/Makefile.am; the following dependency +graph shows which modules may be pruned without breaking things +further down: + +metadata.h + stream_decoder.h + format.h + +stream_encoder.h + stream_decoder.h + format.h + +stream_decoder.h + format.h + +In other words, for pure decoding applications, both the stream encoder +and metadata editing interfaces can be safely removed. + +There is a section dedicated to embedded use in the libFLAC API +HTML documentation (see doc/html/api/index.html). + +Also, there are several places in the libFLAC code with comments marked +with "OPT:" where a #define can be changed to enable code that might be +faster on a specific platform. Experimenting with these can yield faster +binaries. + + +=============================================================================== +Building in a GNU environment +=============================================================================== + +FLAC uses autoconf and libtool for configuring and building. +Better documentation for these will be forthcoming, but in +general, this should work: + +./configure && make && make check && make install + +The 'make check' step is optional; omit it to skip all the tests, +which can take several hours and use around 70-80 megs of disk space. +Even though it will stop with an explicit message on any failure, it +does print out a lot of stuff so you might want to capture the output +to a file if you're having a problem. Also, don't run 'make check' +as root because it confuses some of the tests. + +NOTE: Despite our best efforts it's entirely possible to have +problems when using older versions of autoconf, automake, or +libtool. If you have the latest versions and still can't get it +to work, see the next section on Makefile.lite. + +There are a few FLAC-specific arguments you can give to +`configure': + +--enable-debug : Builds everything with debug symbols and some +extra (and more verbose) error checking. + +--disable-asm-optimizations : Disables the compilation of the +assembly routines. Many routines have assembly versions for +speed and `configure' is pretty good about knowing what is +supported, but you can use this option to build only from the +C sources. May be necessary for building on OS X (Intel). + +--enable-sse : If you are building for an x86 CPU that supports +SSE instructions, you can enable some of the faster routines +if your operating system also supports SSE instructions. flac +can tell if the CPU supports the instructions but currently has +no way to test if the OS does, so if it does, you must pass +this argument to configure to use the SSE routines. If flac +crashes when built with this option you will have to go back and +configure without --enable-sse. Note that +--disable-asm-optimizations implies --disable-sse. + +--enable-local-xmms-plugin : Installs the FLAC XMMS plugin in +$HOME/.xmms/Plugins, instead of the global XMMS plugin area +(usually /usr/lib/xmms/Input). + +--with-ogg= +--with-xmms-prefix= +--with-libiconv-prefix= +Use these if you have these packages but configure can't find them. + +If you want to build completely from scratch (i.e. starting with just +configure.ac and Makefile.am) you should be able to just run 'autogen.sh' +but make sure and read the comments in that file first. + + +=============================================================================== +Building with Makefile.lite +=============================================================================== + +There is a more lightweight build system for do-it-yourself-ers. +It is also useful if configure isn't working, which may be the +case since lately we've had some problems with different versions +of automake and libtool. The Makefile.lite system should work +on GNU systems with few or no adjustments. + +From the top level just 'make -f Makefile.lite'. You can +specify zero or one optional target from 'release', 'debug', +'test', or 'clean'. The default is 'release'. There is no +'install' target but everything you need will end up in the +obj/ directory. + +If you are not on an x86 system or you don't have nasm, you +may have to change the DEFINES in src/libFLAC/Makefile.lite. If +you don't have nasm, remove -DFLAC__HAS_NASM. If your target is +not an x86, change -DFLAC__CPU_IA32 to -DFLAC__CPU_UNKNOWN. + + +=============================================================================== +Building with MSVC +=============================================================================== + +There are .vcproj projects and a master FLAC.sln solution to build all +the libraries and executables with MSVC 2005 or newer. + +Prerequisite: you must have the Ogg libraries installed as described +later. + +Prerequisite: you must have nasm installed, and nasm.exe must be in +your PATH, or the path to nasm.exe must be added to the list of +directories for executable files in the MSVC global options. + +To build everything, run Visual Studio, do File|Open and open FLAC.sln. +From the dropdown in the toolbar, select "Release" instead of "Debug", +then do Build|Build Solution. + +This will build all libraries both statically (e.g. +objs\release\lib\libFLAC_static.lib) and as DLLs (e.g. +objs\release\lib\libFLAC.dll), and it will build all binaries, statically +linked (e.g. objs\release\bin\flac.exe). + +Everything will end up in the "objs" directory. DLLs and .exe files +are all that are needed and can be copied to an installation area and +added to the PATH. + +By default the code is configured with Ogg support. Before building FLAC +you will need to get the Ogg source distribution +(see http://xiph.org/downloads/), build libogg_static.lib (load +win32\libogg_static.sln, change solution configuration to "Release" and +code generation to "Multi-threaded (/MT)", then build), copy libogg_static.lib +into FLAC's 'objs\release\lib' directory, and copy the entire include\ogg tree +into FLAC's 'include' directory (so that there is an 'ogg' directory in FLAC's +'include' directory with the files ogg.h, os_types.h and config_types.h). + +If you want to build without Ogg support, instead edit all .vcproj files +and remove any "FLAC__HAS_OGG" definitions. + + +=============================================================================== +Building on Mac OS X +=============================================================================== + +If you have Fink or a recent version of OS X with the proper autotools, +the GNU flow above should work. diff --git a/src/libflac/README.ESP8266 b/src/libflac/README.ESP8266 new file mode 100644 index 0000000..e9c9682 --- /dev/null +++ b/src/libflac/README.ESP8266 @@ -0,0 +1,3 @@ +This is LIBFLAC 1.3.2 ported to the ESP8266 by Earle F. Philhower, III +. It's pretty much unchanged from base sourcew, +with some CRC and string constants moved into PROGMEM. diff --git a/src/libflac/bitmath.c b/src/libflac/bitmath.c new file mode 100644 index 0000000..b3f0acc --- /dev/null +++ b/src/libflac/bitmath.c @@ -0,0 +1,73 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include "private/bitmath.h" + +/* An example of what FLAC__bitmath_silog2() computes: + * + * silog2(-10) = 5 + * silog2(- 9) = 5 + * silog2(- 8) = 4 + * silog2(- 7) = 4 + * silog2(- 6) = 4 + * silog2(- 5) = 4 + * silog2(- 4) = 3 + * silog2(- 3) = 3 + * silog2(- 2) = 2 + * silog2(- 1) = 2 + * silog2( 0) = 0 + * silog2( 1) = 2 + * silog2( 2) = 3 + * silog2( 3) = 3 + * silog2( 4) = 4 + * silog2( 5) = 4 + * silog2( 6) = 4 + * silog2( 7) = 4 + * silog2( 8) = 5 + * silog2( 9) = 5 + * silog2( 10) = 5 + */ +unsigned FLAC__bitmath_silog2(FLAC__int64 v) +{ + if(v == 0) + return 0; + + if(v == -1) + return 2; + + v = (v < 0) ? (-(v+1)) : v; + return FLAC__bitmath_ilog2_wide(v)+2; +} diff --git a/src/libflac/bitreader.c b/src/libflac/bitreader.c new file mode 100644 index 0000000..ba2abc9 --- /dev/null +++ b/src/libflac/bitreader.c @@ -0,0 +1,1106 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include +#include "private/bitmath.h" +#include "private/bitreader.h" +#include "private/crc.h" +#include "private/macros.h" +#include "FLAC/assert.h" +#include "share/compat.h" +#include "share/endswap.h" + +/* Things should be fastest when this matches the machine word size */ +/* WATCHOUT: if you change this you must also change the following #defines down to COUNT_ZERO_MSBS2 below to match */ +/* WATCHOUT: there are a few places where the code will not work unless brword is >= 32 bits wide */ +/* also, some sections currently only have fast versions for 4 or 8 bytes per word */ + +#if (ENABLE_64_BIT_WORDS == 0) + +typedef FLAC__uint32 brword; +#define FLAC__BYTES_PER_WORD 4 /* sizeof brword */ +#define FLAC__BITS_PER_WORD 32 +#define FLAC__WORD_ALL_ONES ((FLAC__uint32)0xffffffff) +/* SWAP_BE_WORD_TO_HOST swaps bytes in a brword (which is always big-endian) if necessary to match host byte order */ +#if WORDS_BIGENDIAN +#define SWAP_BE_WORD_TO_HOST(x) (x) +#else +#define SWAP_BE_WORD_TO_HOST(x) ENDSWAP_32(x) +#endif +/* counts the # of zero MSBs in a word */ +#define COUNT_ZERO_MSBS(word) FLAC__clz_uint32(word) +#define COUNT_ZERO_MSBS2(word) FLAC__clz2_uint32(word) + +#else + +typedef FLAC__uint64 brword; +#define FLAC__BYTES_PER_WORD 8 /* sizeof brword */ +#define FLAC__BITS_PER_WORD 64 +#define FLAC__WORD_ALL_ONES ((FLAC__uint64)FLAC__U64L(0xffffffffffffffff)) +/* SWAP_BE_WORD_TO_HOST swaps bytes in a brword (which is always big-endian) if necessary to match host byte order */ +#if WORDS_BIGENDIAN +#define SWAP_BE_WORD_TO_HOST(x) (x) +#else +#define SWAP_BE_WORD_TO_HOST(x) ENDSWAP_64(x) +#endif +/* counts the # of zero MSBs in a word */ +#define COUNT_ZERO_MSBS(word) FLAC__clz_uint64(word) +#define COUNT_ZERO_MSBS2(word) FLAC__clz2_uint64(word) + +#endif + +/* + * This should be at least twice as large as the largest number of words + * required to represent any 'number' (in any encoding) you are going to + * read. With FLAC this is on the order of maybe a few hundred bits. + * If the buffer is smaller than that, the decoder won't be able to read + * in a whole number that is in a variable length encoding (e.g. Rice). + * But to be practical it should be at least 1K bytes. + * + * Increase this number to decrease the number of read callbacks, at the + * expense of using more memory. Or decrease for the reverse effect, + * keeping in mind the limit from the first paragraph. The optimal size + * also depends on the CPU cache size and other factors; some twiddling + * may be necessary to squeeze out the best performance. + */ +static const unsigned FLAC__BITREADER_DEFAULT_CAPACITY = 65536u / FLAC__BITS_PER_WORD; /* in words */ + +struct FLAC__BitReader { + /* any partially-consumed word at the head will stay right-justified as bits are consumed from the left */ + /* any incomplete word at the tail will be left-justified, and bytes from the read callback are added on the right */ + brword *buffer; + unsigned capacity; /* in words */ + unsigned words; /* # of completed words in buffer */ + unsigned bytes; /* # of bytes in incomplete word at buffer[words] */ + unsigned consumed_words; /* #words ... */ + unsigned consumed_bits; /* ... + (#bits of head word) already consumed from the front of buffer */ + unsigned read_crc16; /* the running frame CRC */ + unsigned crc16_align; /* the number of bits in the current consumed word that should not be CRC'd */ + FLAC__BitReaderReadCallback read_callback; + void *client_data; +}; + +static inline void crc16_update_word_(FLAC__BitReader *br, brword word) +{ + register unsigned crc = br->read_crc16; +#if FLAC__BYTES_PER_WORD == 4 + switch(br->crc16_align) { + case 0: crc = FLAC__CRC16_UPDATE((unsigned)(word >> 24), crc); + case 8: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 16) & 0xff), crc); + case 16: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 8) & 0xff), crc); + case 24: br->read_crc16 = FLAC__CRC16_UPDATE((unsigned)(word & 0xff), crc); + } +#elif FLAC__BYTES_PER_WORD == 8 + switch(br->crc16_align) { + case 0: crc = FLAC__CRC16_UPDATE((unsigned)(word >> 56), crc); + case 8: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 48) & 0xff), crc); + case 16: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 40) & 0xff), crc); + case 24: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 32) & 0xff), crc); + case 32: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 24) & 0xff), crc); + case 40: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 16) & 0xff), crc); + case 48: crc = FLAC__CRC16_UPDATE((unsigned)((word >> 8) & 0xff), crc); + case 56: br->read_crc16 = FLAC__CRC16_UPDATE((unsigned)(word & 0xff), crc); + } +#else + for( ; br->crc16_align < FLAC__BITS_PER_WORD; br->crc16_align += 8) + crc = FLAC__CRC16_UPDATE((unsigned)((word >> (FLAC__BITS_PER_WORD-8-br->crc16_align)) & 0xff), crc); + br->read_crc16 = crc; +#endif + br->crc16_align = 0; +} + +static FLAC__bool bitreader_read_from_client_(FLAC__BitReader *br) +{ + unsigned start, end; + size_t bytes; + FLAC__byte *target; + stack(__FUNCTION__, __FILE__, __LINE__); + + /* first shift the unconsumed buffer data toward the front as much as possible */ + if(br->consumed_words > 0) { + start = br->consumed_words; + end = br->words + (br->bytes? 1:0); + memmove(br->buffer, br->buffer+start, FLAC__BYTES_PER_WORD * (end - start)); + + br->words -= start; + br->consumed_words = 0; + } + + /* + * set the target for reading, taking into account word alignment and endianness + */ + bytes = (br->capacity - br->words) * FLAC__BYTES_PER_WORD - br->bytes; + if(bytes == 0) + return false; /* no space left, buffer is too small; see note for FLAC__BITREADER_DEFAULT_CAPACITY */ + target = ((FLAC__byte*)(br->buffer+br->words)) + br->bytes; + + /* before reading, if the existing reader looks like this (say brword is 32 bits wide) + * bitstream : 11 22 33 44 55 br->words=1 br->bytes=1 (partial tail word is left-justified) + * buffer[BE]: 11 22 33 44 55 ?? ?? ?? (shown layed out as bytes sequentially in memory) + * buffer[LE]: 44 33 22 11 ?? ?? ?? 55 (?? being don't-care) + * ^^-------target, bytes=3 + * on LE machines, have to byteswap the odd tail word so nothing is + * overwritten: + */ +#if WORDS_BIGENDIAN +#else + if(br->bytes) + br->buffer[br->words] = SWAP_BE_WORD_TO_HOST(br->buffer[br->words]); +#endif + + /* now it looks like: + * bitstream : 11 22 33 44 55 br->words=1 br->bytes=1 + * buffer[BE]: 11 22 33 44 55 ?? ?? ?? + * buffer[LE]: 44 33 22 11 55 ?? ?? ?? + * ^^-------target, bytes=3 + */ + + /* read in the data; note that the callback may return a smaller number of bytes */ + if(!br->read_callback(target, &bytes, br->client_data)) + return false; + + /* after reading bytes 66 77 88 99 AA BB CC DD EE FF from the client: + * bitstream : 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF + * buffer[BE]: 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF ?? + * buffer[LE]: 44 33 22 11 55 66 77 88 99 AA BB CC DD EE FF ?? + * now have to byteswap on LE machines: + */ +#if WORDS_BIGENDIAN +#else + end = (br->words*FLAC__BYTES_PER_WORD + br->bytes + (unsigned)bytes + (FLAC__BYTES_PER_WORD-1)) / FLAC__BYTES_PER_WORD; + for(start = br->words; start < end; start++) + br->buffer[start] = SWAP_BE_WORD_TO_HOST(br->buffer[start]); +#endif + + /* now it looks like: + * bitstream : 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF + * buffer[BE]: 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF ?? + * buffer[LE]: 44 33 22 11 88 77 66 55 CC BB AA 99 ?? FF EE DD + * finally we'll update the reader values: + */ + end = br->words*FLAC__BYTES_PER_WORD + br->bytes + (unsigned)bytes; + br->words = end / FLAC__BYTES_PER_WORD; + br->bytes = end % FLAC__BYTES_PER_WORD; + + return true; +} + +/*********************************************************************** + * + * Class constructor/destructor + * + ***********************************************************************/ + +FLAC__BitReader *FLAC__bitreader_new(void) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__BitReader *br = calloc(1, sizeof(FLAC__BitReader)); + + /* calloc() implies: + memset(br, 0, sizeof(FLAC__BitReader)); + br->buffer = 0; + br->capacity = 0; + br->words = br->bytes = 0; + br->consumed_words = br->consumed_bits = 0; + br->read_callback = 0; + br->client_data = 0; + */ + return br; +} + +void FLAC__bitreader_delete(FLAC__BitReader *br) +{ + FLAC__ASSERT(0 != br); + + FLAC__bitreader_free(br); + free(br); +} + +/*********************************************************************** + * + * Public class methods + * + ***********************************************************************/ + +FLAC__bool FLAC__bitreader_init(FLAC__BitReader *br, FLAC__BitReaderReadCallback rcb, void *cd) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != br); + + br->words = br->bytes = 0; + br->consumed_words = br->consumed_bits = 0; + br->capacity = FLAC__BITREADER_DEFAULT_CAPACITY; + br->buffer = malloc(sizeof(brword) * br->capacity); + if(br->buffer == 0) + return false; + br->read_callback = rcb; + br->client_data = cd; + + return true; +} + +void FLAC__bitreader_free(FLAC__BitReader *br) +{ + FLAC__ASSERT(0 != br); + + if(0 != br->buffer) + free(br->buffer); + br->buffer = 0; + br->capacity = 0; + br->words = br->bytes = 0; + br->consumed_words = br->consumed_bits = 0; + br->read_callback = 0; + br->client_data = 0; +} + +FLAC__bool FLAC__bitreader_clear(FLAC__BitReader *br) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + br->words = br->bytes = 0; + br->consumed_words = br->consumed_bits = 0; + return true; +} + +void FLAC__bitreader_dump(const FLAC__BitReader *br, FILE *out) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned i, j; + if(br == 0) { + fprintf(out, "bitreader is NULL\n"); + } + else { + fprintf(out, "bitreader: capacity=%u words=%u bytes=%u consumed: words=%u, bits=%u\n", br->capacity, br->words, br->bytes, br->consumed_words, br->consumed_bits); + + for(i = 0; i < br->words; i++) { + fprintf(out, "%08X: ", i); + for(j = 0; j < FLAC__BITS_PER_WORD; j++) + if(i < br->consumed_words || (i == br->consumed_words && j < br->consumed_bits)) + fprintf(out, "."); + else + fprintf(out, "%01u", br->buffer[i] & ((brword)1 << (FLAC__BITS_PER_WORD-j-1)) ? 1:0); + fprintf(out, "\n"); + } + if(br->bytes > 0) { + fprintf(out, "%08X: ", i); + for(j = 0; j < br->bytes*8; j++) + if(i < br->consumed_words || (i == br->consumed_words && j < br->consumed_bits)) + fprintf(out, "."); + else + fprintf(out, "%01u", br->buffer[i] & ((brword)1 << (br->bytes*8-j-1)) ? 1:0); + fprintf(out, "\n"); + } + } +} + +void FLAC__bitreader_reset_read_crc16(FLAC__BitReader *br, FLAC__uint16 seed) +{ + stack(__FUNCTION__, __FILE__, __LINE__); +FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + FLAC__ASSERT((br->consumed_bits & 7) == 0); + + br->read_crc16 = (unsigned)seed; + br->crc16_align = br->consumed_bits; +} + +FLAC__uint16 FLAC__bitreader_get_read_crc16(FLAC__BitReader *br) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + FLAC__ASSERT((br->consumed_bits & 7) == 0); + FLAC__ASSERT(br->crc16_align <= br->consumed_bits); + + /* CRC any tail bytes in a partially-consumed word */ + if(br->consumed_bits) { + const brword tail = br->buffer[br->consumed_words]; + for( ; br->crc16_align < br->consumed_bits; br->crc16_align += 8) + br->read_crc16 = FLAC__CRC16_UPDATE((unsigned)((tail >> (FLAC__BITS_PER_WORD-8-br->crc16_align)) & 0xff), br->read_crc16); + } + return br->read_crc16; +} + +inline FLAC__bool FLAC__bitreader_is_consumed_byte_aligned(const FLAC__BitReader *br) +{ + return ((br->consumed_bits & 7) == 0); +} + +inline unsigned FLAC__bitreader_bits_left_for_byte_alignment(const FLAC__BitReader *br) +{ + return 8 - (br->consumed_bits & 7); +} + +inline unsigned FLAC__bitreader_get_input_bits_unconsumed(const FLAC__BitReader *br) +{ + return (br->words-br->consumed_words)*FLAC__BITS_PER_WORD + br->bytes*8 - br->consumed_bits; +} + +FLAC__bool FLAC__bitreader_read_raw_uint32(FLAC__BitReader *br, FLAC__uint32 *val, unsigned bits) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + FLAC__ASSERT(bits <= 32); + FLAC__ASSERT((br->capacity*FLAC__BITS_PER_WORD) * 2 >= bits); + FLAC__ASSERT(br->consumed_words <= br->words); + + /* WATCHOUT: code does not work with <32bit words; we can make things much faster with this assertion */ + FLAC__ASSERT(FLAC__BITS_PER_WORD >= 32); + + if(bits == 0) { /* OPT: investigate if this can ever happen, maybe change to assertion */ + *val = 0; + return true; + } + + while((br->words-br->consumed_words)*FLAC__BITS_PER_WORD + br->bytes*8 - br->consumed_bits < bits) { + if(!bitreader_read_from_client_(br)) + return false; + } + if(br->consumed_words < br->words) { /* if we've not consumed up to a partial tail word... */ + /* OPT: taking out the consumed_bits==0 "else" case below might make things faster if less code allows the compiler to inline this function */ + if(br->consumed_bits) { + /* this also works when consumed_bits==0, it's just a little slower than necessary for that case */ + const unsigned n = FLAC__BITS_PER_WORD - br->consumed_bits; + const brword word = br->buffer[br->consumed_words]; + if(bits < n) { + *val = (FLAC__uint32)((word & (FLAC__WORD_ALL_ONES >> br->consumed_bits)) >> (n-bits)); /* The result has <= 32 non-zero bits */ + br->consumed_bits += bits; + return true; + } + /* (FLAC__BITS_PER_WORD - br->consumed_bits <= bits) ==> (FLAC__WORD_ALL_ONES >> br->consumed_bits) has no more than 'bits' non-zero bits */ + *val = (FLAC__uint32)(word & (FLAC__WORD_ALL_ONES >> br->consumed_bits)); + bits -= n; + crc16_update_word_(br, word); + br->consumed_words++; + br->consumed_bits = 0; + if(bits) { /* if there are still bits left to read, there have to be less than 32 so they will all be in the next word */ + *val <<= bits; + *val |= (FLAC__uint32)(br->buffer[br->consumed_words] >> (FLAC__BITS_PER_WORD-bits)); + br->consumed_bits = bits; + } + return true; + } + else { /* br->consumed_bits == 0 */ + const brword word = br->buffer[br->consumed_words]; + if(bits < FLAC__BITS_PER_WORD) { + *val = (FLAC__uint32)(word >> (FLAC__BITS_PER_WORD-bits)); + br->consumed_bits = bits; + return true; + } + /* at this point bits == FLAC__BITS_PER_WORD == 32; because of previous assertions, it can't be larger */ + *val = (FLAC__uint32)word; + crc16_update_word_(br, word); + br->consumed_words++; + return true; + } + } + else { + /* in this case we're starting our read at a partial tail word; + * the reader has guaranteed that we have at least 'bits' bits + * available to read, which makes this case simpler. + */ + /* OPT: taking out the consumed_bits==0 "else" case below might make things faster if less code allows the compiler to inline this function */ + if(br->consumed_bits) { + /* this also works when consumed_bits==0, it's just a little slower than necessary for that case */ + FLAC__ASSERT(br->consumed_bits + bits <= br->bytes*8); + *val = (FLAC__uint32)((br->buffer[br->consumed_words] & (FLAC__WORD_ALL_ONES >> br->consumed_bits)) >> (FLAC__BITS_PER_WORD-br->consumed_bits-bits)); + br->consumed_bits += bits; + return true; + } + else { + *val = (FLAC__uint32)(br->buffer[br->consumed_words] >> (FLAC__BITS_PER_WORD-bits)); + br->consumed_bits += bits; + return true; + } + } +} + +FLAC__bool FLAC__bitreader_read_raw_int32(FLAC__BitReader *br, FLAC__int32 *val, unsigned bits) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 uval, mask; + /* OPT: inline raw uint32 code here, or make into a macro if possible in the .h file */ + if(!FLAC__bitreader_read_raw_uint32(br, &uval, bits)) + return false; + /* sign-extend *val assuming it is currently bits wide. */ + /* From: https://graphics.stanford.edu/~seander/bithacks.html#FixedSignExtend */ + mask = 1u << (bits - 1); + *val = (uval ^ mask) - mask; + return true; +} + +FLAC__bool FLAC__bitreader_read_raw_uint64(FLAC__BitReader *br, FLAC__uint64 *val, unsigned bits) +{ + FLAC__uint32 hi, lo; + + if(bits > 32) { + if(!FLAC__bitreader_read_raw_uint32(br, &hi, bits-32)) + return false; + if(!FLAC__bitreader_read_raw_uint32(br, &lo, 32)) + return false; + *val = hi; + *val <<= 32; + *val |= lo; + } + else { + if(!FLAC__bitreader_read_raw_uint32(br, &lo, bits)) + return false; + *val = lo; + } + return true; +} + +inline FLAC__bool FLAC__bitreader_read_uint32_little_endian(FLAC__BitReader *br, FLAC__uint32 *val) +{ + FLAC__uint32 x8, x32 = 0; + + /* this doesn't need to be that fast as currently it is only used for vorbis comments */ + + if(!FLAC__bitreader_read_raw_uint32(br, &x32, 8)) + return false; + + if(!FLAC__bitreader_read_raw_uint32(br, &x8, 8)) + return false; + x32 |= (x8 << 8); + + if(!FLAC__bitreader_read_raw_uint32(br, &x8, 8)) + return false; + x32 |= (x8 << 16); + + if(!FLAC__bitreader_read_raw_uint32(br, &x8, 8)) + return false; + x32 |= (x8 << 24); + + *val = x32; + return true; +} + +FLAC__bool FLAC__bitreader_skip_bits_no_crc(FLAC__BitReader *br, unsigned bits) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + /* + * OPT: a faster implementation is possible but probably not that useful + * since this is only called a couple of times in the metadata readers. + */ + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + if(bits > 0) { + const unsigned n = br->consumed_bits & 7; + unsigned m; + FLAC__uint32 x; + + if(n != 0) { + m = flac_min(8-n, bits); + if(!FLAC__bitreader_read_raw_uint32(br, &x, m)) + return false; + bits -= m; + } + m = bits / 8; + if(m > 0) { + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(br, m)) + return false; + bits %= 8; + } + if(bits > 0) { + if(!FLAC__bitreader_read_raw_uint32(br, &x, bits)) + return false; + } + } + + return true; +} + +FLAC__bool FLAC__bitreader_skip_byte_block_aligned_no_crc(FLAC__BitReader *br, unsigned nvals) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(br)); + + /* step 1: skip over partial head word to get word aligned */ + while(nvals && br->consumed_bits) { /* i.e. run until we read 'nvals' bytes or we hit the end of the head word */ + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + nvals--; + } + if(0 == nvals) + return true; + /* step 2: skip whole words in chunks */ + while(nvals >= FLAC__BYTES_PER_WORD) { + if(br->consumed_words < br->words) { + br->consumed_words++; + nvals -= FLAC__BYTES_PER_WORD; + } + else if(!bitreader_read_from_client_(br)) + return false; + } + /* step 3: skip any remainder from partial tail bytes */ + while(nvals) { + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + nvals--; + } + + return true; +} + +FLAC__bool FLAC__bitreader_read_byte_block_aligned_no_crc(FLAC__BitReader *br, FLAC__byte *val, unsigned nvals) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(br)); + + /* step 1: read from partial head word to get word aligned */ + while(nvals && br->consumed_bits) { /* i.e. run until we read 'nvals' bytes or we hit the end of the head word */ + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + *val++ = (FLAC__byte)x; + nvals--; + } + if(0 == nvals) + return true; + /* step 2: read whole words in chunks */ + while(nvals >= FLAC__BYTES_PER_WORD) { + if(br->consumed_words < br->words) { + const brword word = br->buffer[br->consumed_words++]; +#if FLAC__BYTES_PER_WORD == 4 + val[0] = (FLAC__byte)(word >> 24); + val[1] = (FLAC__byte)(word >> 16); + val[2] = (FLAC__byte)(word >> 8); + val[3] = (FLAC__byte)word; +#elif FLAC__BYTES_PER_WORD == 8 + val[0] = (FLAC__byte)(word >> 56); + val[1] = (FLAC__byte)(word >> 48); + val[2] = (FLAC__byte)(word >> 40); + val[3] = (FLAC__byte)(word >> 32); + val[4] = (FLAC__byte)(word >> 24); + val[5] = (FLAC__byte)(word >> 16); + val[6] = (FLAC__byte)(word >> 8); + val[7] = (FLAC__byte)word; +#else + for(x = 0; x < FLAC__BYTES_PER_WORD; x++) + val[x] = (FLAC__byte)(word >> (8*(FLAC__BYTES_PER_WORD-x-1))); +#endif + val += FLAC__BYTES_PER_WORD; + nvals -= FLAC__BYTES_PER_WORD; + } + else if(!bitreader_read_from_client_(br)) + return false; + } + /* step 3: read any remainder from partial tail bytes */ + while(nvals) { + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + *val++ = (FLAC__byte)x; + nvals--; + } + + return true; +} + +FLAC__bool FLAC__bitreader_read_unary_unsigned(FLAC__BitReader *br, unsigned *val) +#if 0 /* slow but readable version */ +{ + unsigned bit; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + *val = 0; + while(1) { + if(!FLAC__bitreader_read_bit(br, &bit)) + return false; + if(bit) + break; + else + *val++; + } + return true; +} +#else +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned i; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + *val = 0; + while(1) { + while(br->consumed_words < br->words) { /* if we've not consumed up to a partial tail word... */ + brword b = br->buffer[br->consumed_words] << br->consumed_bits; + if(b) { + i = COUNT_ZERO_MSBS(b); + *val += i; + i++; + br->consumed_bits += i; + if(br->consumed_bits >= FLAC__BITS_PER_WORD) { /* faster way of testing if(br->consumed_bits == FLAC__BITS_PER_WORD) */ + crc16_update_word_(br, br->buffer[br->consumed_words]); + br->consumed_words++; + br->consumed_bits = 0; + } + return true; + } + else { + *val += FLAC__BITS_PER_WORD - br->consumed_bits; + crc16_update_word_(br, br->buffer[br->consumed_words]); + br->consumed_words++; + br->consumed_bits = 0; + /* didn't find stop bit yet, have to keep going... */ + } + } + /* at this point we've eaten up all the whole words; have to try + * reading through any tail bytes before calling the read callback. + * this is a repeat of the above logic adjusted for the fact we + * don't have a whole word. note though if the client is feeding + * us data a byte at a time (unlikely), br->consumed_bits may not + * be zero. + */ + if(br->bytes*8 > br->consumed_bits) { + const unsigned end = br->bytes * 8; + brword b = (br->buffer[br->consumed_words] & (FLAC__WORD_ALL_ONES << (FLAC__BITS_PER_WORD-end))) << br->consumed_bits; + if(b) { + i = COUNT_ZERO_MSBS(b); + *val += i; + i++; + br->consumed_bits += i; + FLAC__ASSERT(br->consumed_bits < FLAC__BITS_PER_WORD); + return true; + } + else { + *val += end - br->consumed_bits; + br->consumed_bits = end; + FLAC__ASSERT(br->consumed_bits < FLAC__BITS_PER_WORD); + /* didn't find stop bit yet, have to keep going... */ + } + } + if(!bitreader_read_from_client_(br)) + return false; + } +} +#endif + +FLAC__bool FLAC__bitreader_read_rice_signed(FLAC__BitReader *br, int *val, unsigned parameter) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 lsbs = 0, msbs = 0; + unsigned uval; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + FLAC__ASSERT(parameter <= 31); + + /* read the unary MSBs and end bit */ + if(!FLAC__bitreader_read_unary_unsigned(br, &msbs)) + return false; + + /* read the binary LSBs */ + if(!FLAC__bitreader_read_raw_uint32(br, &lsbs, parameter)) + return false; + + /* compose the value */ + uval = (msbs << parameter) | lsbs; + if(uval & 1) + *val = -((int)(uval >> 1)) - 1; + else + *val = (int)(uval >> 1); + + return true; +} + +/* this is by far the most heavily used reader call. it ain't pretty but it's fast */ +FLAC__bool FLAC__bitreader_read_rice_signed_block(FLAC__BitReader *br, int vals[], unsigned nvals, unsigned parameter) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + /* try and get br->consumed_words and br->consumed_bits into register; + * must remember to flush them back to *br before calling other + * bitreader functions that use them, and before returning */ + unsigned cwords, words, lsbs, msbs, x, y; + unsigned ucbits; /* keep track of the number of unconsumed bits in word */ + brword b; + int *val, *end; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + /* WATCHOUT: code does not work with <32bit words; we can make things much faster with this assertion */ + FLAC__ASSERT(FLAC__BITS_PER_WORD >= 32); + FLAC__ASSERT(parameter < 32); + /* the above two asserts also guarantee that the binary part never straddles more than 2 words, so we don't have to loop to read it */ + + val = vals; + end = vals + nvals; + + if(parameter == 0) { + while(val < end) { + /* read the unary MSBs and end bit */ + if(!FLAC__bitreader_read_unary_unsigned(br, &msbs)) + return false; + + *val++ = (int)(msbs >> 1) ^ -(int)(msbs & 1); + } + + return true; + } + + FLAC__ASSERT(parameter > 0); + + cwords = br->consumed_words; + words = br->words; + + /* if we've not consumed up to a partial tail word... */ + if(cwords >= words) { + x = 0; + goto process_tail; + } + + ucbits = FLAC__BITS_PER_WORD - br->consumed_bits; + b = br->buffer[cwords] << br->consumed_bits; /* keep unconsumed bits aligned to left */ + + while(val < end) { + /* read the unary MSBs and end bit */ + x = y = COUNT_ZERO_MSBS2(b); + if(x == FLAC__BITS_PER_WORD) { + x = ucbits; + do { + /* didn't find stop bit yet, have to keep going... */ + crc16_update_word_(br, br->buffer[cwords++]); + if (cwords >= words) + goto incomplete_msbs; + b = br->buffer[cwords]; + y = COUNT_ZERO_MSBS2(b); + x += y; + } while(y == FLAC__BITS_PER_WORD); + } + b <<= y; + b <<= 1; /* account for stop bit */ + ucbits = (ucbits - x - 1) % FLAC__BITS_PER_WORD; + msbs = x; + + /* read the binary LSBs */ + x = (FLAC__uint32)(b >> (FLAC__BITS_PER_WORD - parameter)); /* parameter < 32, so we can cast to 32-bit unsigned */ + if(parameter <= ucbits) { + ucbits -= parameter; + b <<= parameter; + } else { + /* there are still bits left to read, they will all be in the next word */ + crc16_update_word_(br, br->buffer[cwords++]); + if (cwords >= words) + goto incomplete_lsbs; + b = br->buffer[cwords]; + ucbits += FLAC__BITS_PER_WORD - parameter; + x |= (FLAC__uint32)(b >> ucbits); + b <<= FLAC__BITS_PER_WORD - ucbits; + } + lsbs = x; + + /* compose the value */ + x = (msbs << parameter) | lsbs; + *val++ = (int)(x >> 1) ^ -(int)(x & 1); + + continue; + + /* at this point we've eaten up all the whole words */ +process_tail: + do { + if(0) { +incomplete_msbs: + br->consumed_bits = 0; + br->consumed_words = cwords; + } + + /* read the unary MSBs and end bit */ + if(!FLAC__bitreader_read_unary_unsigned(br, &msbs)) + return false; + msbs += x; + x = ucbits = 0; + + if(0) { +incomplete_lsbs: + br->consumed_bits = 0; + br->consumed_words = cwords; + } + + /* read the binary LSBs */ + if(!FLAC__bitreader_read_raw_uint32(br, &lsbs, parameter - ucbits)) + return false; + lsbs = x | lsbs; + + /* compose the value */ + x = (msbs << parameter) | lsbs; + *val++ = (int)(x >> 1) ^ -(int)(x & 1); + x = 0; + + cwords = br->consumed_words; + words = br->words; + ucbits = FLAC__BITS_PER_WORD - br->consumed_bits; + b = br->buffer[cwords] << br->consumed_bits; + } while(cwords >= words && val < end); + } + + if(ucbits == 0 && cwords < words) { + /* don't leave the head word with no unconsumed bits */ + crc16_update_word_(br, br->buffer[cwords++]); + ucbits = FLAC__BITS_PER_WORD; + } + + br->consumed_bits = FLAC__BITS_PER_WORD - ucbits; + br->consumed_words = cwords; + + return true; +} + +#if 0 /* UNUSED */ +FLAC__bool FLAC__bitreader_read_golomb_signed(FLAC__BitReader *br, int *val, unsigned parameter) +{ + FLAC__uint32 lsbs = 0, msbs = 0; + unsigned bit, uval, k; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + k = FLAC__bitmath_ilog2(parameter); + + /* read the unary MSBs and end bit */ + if(!FLAC__bitreader_read_unary_unsigned(br, &msbs)) + return false; + + /* read the binary LSBs */ + if(!FLAC__bitreader_read_raw_uint32(br, &lsbs, k)) + return false; + + if(parameter == 1u<= d) { + if(!FLAC__bitreader_read_bit(br, &bit)) + return false; + lsbs <<= 1; + lsbs |= bit; + lsbs -= d; + } + /* compose the value */ + uval = msbs * parameter + lsbs; + } + + /* unfold unsigned to signed */ + if(uval & 1) + *val = -((int)(uval >> 1)) - 1; + else + *val = (int)(uval >> 1); + + return true; +} + +FLAC__bool FLAC__bitreader_read_golomb_unsigned(FLAC__BitReader *br, unsigned *val, unsigned parameter) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 lsbs, msbs = 0; + unsigned bit, k; + + FLAC__ASSERT(0 != br); + FLAC__ASSERT(0 != br->buffer); + + k = FLAC__bitmath_ilog2(parameter); + + /* read the unary MSBs and end bit */ + if(!FLAC__bitreader_read_unary_unsigned(br, &msbs)) + return false; + + /* read the binary LSBs */ + if(!FLAC__bitreader_read_raw_uint32(br, &lsbs, k)) + return false; + + if(parameter == 1u<= d) { + if(!FLAC__bitreader_read_bit(br, &bit)) + return false; + lsbs <<= 1; + lsbs |= bit; + lsbs -= d; + } + /* compose the value */ + *val = msbs * parameter + lsbs; + } + + return true; +} +#endif /* UNUSED */ + +/* on return, if *val == 0xffffffff then the utf-8 sequence was invalid, but the return value will be true */ +FLAC__bool FLAC__bitreader_read_utf8_uint32(FLAC__BitReader *br, FLAC__uint32 *val, FLAC__byte *raw, unsigned *rawlen) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 v = 0; + FLAC__uint32 x; + unsigned i; + + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + if(raw) + raw[(*rawlen)++] = (FLAC__byte)x; + if(!(x & 0x80)) { /* 0xxxxxxx */ + v = x; + i = 0; + } + else if(x & 0xC0 && !(x & 0x20)) { /* 110xxxxx */ + v = x & 0x1F; + i = 1; + } + else if(x & 0xE0 && !(x & 0x10)) { /* 1110xxxx */ + v = x & 0x0F; + i = 2; + } + else if(x & 0xF0 && !(x & 0x08)) { /* 11110xxx */ + v = x & 0x07; + i = 3; + } + else if(x & 0xF8 && !(x & 0x04)) { /* 111110xx */ + v = x & 0x03; + i = 4; + } + else if(x & 0xFC && !(x & 0x02)) { /* 1111110x */ + v = x & 0x01; + i = 5; + } + else { + *val = 0xffffffff; + return true; + } + for( ; i; i--) { + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + if(raw) + raw[(*rawlen)++] = (FLAC__byte)x; + if(!(x & 0x80) || (x & 0x40)) { /* 10xxxxxx */ + *val = 0xffffffff; + return true; + } + v <<= 6; + v |= (x & 0x3F); + } + *val = v; + return true; +} + +/* on return, if *val == 0xffffffffffffffff then the utf-8 sequence was invalid, but the return value will be true */ +FLAC__bool FLAC__bitreader_read_utf8_uint64(FLAC__BitReader *br, FLAC__uint64 *val, FLAC__byte *raw, unsigned *rawlen) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint64 v = 0; + FLAC__uint32 x; + unsigned i; + + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + if(raw) + raw[(*rawlen)++] = (FLAC__byte)x; + if(!(x & 0x80)) { /* 0xxxxxxx */ + v = x; + i = 0; + } + else if(x & 0xC0 && !(x & 0x20)) { /* 110xxxxx */ + v = x & 0x1F; + i = 1; + } + else if(x & 0xE0 && !(x & 0x10)) { /* 1110xxxx */ + v = x & 0x0F; + i = 2; + } + else if(x & 0xF0 && !(x & 0x08)) { /* 11110xxx */ + v = x & 0x07; + i = 3; + } + else if(x & 0xF8 && !(x & 0x04)) { /* 111110xx */ + v = x & 0x03; + i = 4; + } + else if(x & 0xFC && !(x & 0x02)) { /* 1111110x */ + v = x & 0x01; + i = 5; + } + else if(x & 0xFE && !(x & 0x01)) { /* 11111110 */ + v = 0; + i = 6; + } + else { + *val = FLAC__U64L(0xffffffffffffffff); + return true; + } + for( ; i; i--) { + if(!FLAC__bitreader_read_raw_uint32(br, &x, 8)) + return false; + if(raw) + raw[(*rawlen)++] = (FLAC__byte)x; + if(!(x & 0x80) || (x & 0x40)) { /* 10xxxxxx */ + *val = FLAC__U64L(0xffffffffffffffff); + return true; + } + v <<= 6; + v |= (x & 0x3F); + } + *val = v; + return true; +} + +/* These functions are declared inline in this file but are also callable as + * externs from elsewhere. + * According to the C99 spec, section 6.7.4, simply providing a function + * prototype in a header file without 'inline' and making the function inline + * in this file should be sufficient. + * Unfortunately, the Microsoft VS compiler doesn't pick them up externally. To + * fix that we add extern declarations here. + */ +extern FLAC__bool FLAC__bitreader_is_consumed_byte_aligned(const FLAC__BitReader *br); +extern unsigned FLAC__bitreader_bits_left_for_byte_alignment(const FLAC__BitReader *br); +extern unsigned FLAC__bitreader_get_input_bits_unconsumed(const FLAC__BitReader *br); +extern FLAC__bool FLAC__bitreader_read_uint32_little_endian(FLAC__BitReader *br, FLAC__uint32 *val); diff --git a/src/libflac/bitwriter.c b/src/libflac/bitwriter.c new file mode 100644 index 0000000..8bb4dc7 --- /dev/null +++ b/src/libflac/bitwriter.c @@ -0,0 +1,881 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include +#include "private/bitwriter.h" +#include "private/crc.h" +#include "private/macros.h" +#include "FLAC/assert.h" +#include "share/alloc.h" +#include "share/compat.h" +#include "share/endswap.h" + +/* Things should be fastest when this matches the machine word size */ +/* WATCHOUT: if you change this you must also change the following #defines down to SWAP_BE_WORD_TO_HOST below to match */ +/* WATCHOUT: there are a few places where the code will not work unless bwword is >= 32 bits wide */ + +#if (ENABLE_64_BIT_WORDS == 0) + +typedef FLAC__uint32 bwword; +#define FLAC__BYTES_PER_WORD 4 /* sizeof bwword */ +#define FLAC__BITS_PER_WORD 32 +/* SWAP_BE_WORD_TO_HOST swaps bytes in a bwword (which is always big-endian) if necessary to match host byte order */ +#if WORDS_BIGENDIAN +#define SWAP_BE_WORD_TO_HOST(x) (x) +#else +#define SWAP_BE_WORD_TO_HOST(x) ENDSWAP_32(x) +#endif + +#else + +typedef FLAC__uint64 bwword; +#define FLAC__BYTES_PER_WORD 8 /* sizeof bwword */ +#define FLAC__BITS_PER_WORD 64 +/* SWAP_BE_WORD_TO_HOST swaps bytes in a bwword (which is always big-endian) if necessary to match host byte order */ +#if WORDS_BIGENDIAN +#define SWAP_BE_WORD_TO_HOST(x) (x) +#else +#define SWAP_BE_WORD_TO_HOST(x) ENDSWAP_64(x) +#endif + +#endif + +/* + * The default capacity here doesn't matter too much. The buffer always grows + * to hold whatever is written to it. Usually the encoder will stop adding at + * a frame or metadata block, then write that out and clear the buffer for the + * next one. + */ +static const unsigned FLAC__BITWRITER_DEFAULT_CAPACITY = 32768u / sizeof(bwword); /* size in words */ +/* When growing, increment 4K at a time */ +static const unsigned FLAC__BITWRITER_DEFAULT_INCREMENT = 4096u / sizeof(bwword); /* size in words */ + +#define FLAC__WORDS_TO_BITS(words) ((words) * FLAC__BITS_PER_WORD) +#define FLAC__TOTAL_BITS(bw) (FLAC__WORDS_TO_BITS((bw)->words) + (bw)->bits) + +struct FLAC__BitWriter { + bwword *buffer; + bwword accum; /* accumulator; bits are right-justified; when full, accum is appended to buffer */ + unsigned capacity; /* capacity of buffer in words */ + unsigned words; /* # of complete words in buffer */ + unsigned bits; /* # of used bits in accum */ +}; + +/* * WATCHOUT: The current implementation only grows the buffer. */ +#ifndef __SUNPRO_C +static +#endif +FLAC__bool bitwriter_grow_(FLAC__BitWriter *bw, unsigned bits_to_add) +{ + unsigned new_capacity; + bwword *new_buffer; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + + /* calculate total words needed to store 'bits_to_add' additional bits */ + new_capacity = bw->words + ((bw->bits + bits_to_add + FLAC__BITS_PER_WORD - 1) / FLAC__BITS_PER_WORD); + + /* it's possible (due to pessimism in the growth estimation that + * leads to this call) that we don't actually need to grow + */ + if(bw->capacity >= new_capacity) + return true; + + /* round up capacity increase to the nearest FLAC__BITWRITER_DEFAULT_INCREMENT */ + if((new_capacity - bw->capacity) % FLAC__BITWRITER_DEFAULT_INCREMENT) + new_capacity += FLAC__BITWRITER_DEFAULT_INCREMENT - ((new_capacity - bw->capacity) % FLAC__BITWRITER_DEFAULT_INCREMENT); + /* make sure we got everything right */ + FLAC__ASSERT(0 == (new_capacity - bw->capacity) % FLAC__BITWRITER_DEFAULT_INCREMENT); + FLAC__ASSERT(new_capacity > bw->capacity); + FLAC__ASSERT(new_capacity >= bw->words + ((bw->bits + bits_to_add + FLAC__BITS_PER_WORD - 1) / FLAC__BITS_PER_WORD)); + + new_buffer = safe_realloc_mul_2op_(bw->buffer, sizeof(bwword), /*times*/new_capacity); + if(new_buffer == 0) + return false; + bw->buffer = new_buffer; + bw->capacity = new_capacity; + return true; +} + + +/*********************************************************************** + * + * Class constructor/destructor + * + ***********************************************************************/ + +FLAC__BitWriter *FLAC__bitwriter_new(void) +{ + FLAC__BitWriter *bw = calloc(1, sizeof(FLAC__BitWriter)); + /* note that calloc() sets all members to 0 for us */ + return bw; +} + +void FLAC__bitwriter_delete(FLAC__BitWriter *bw) +{ + FLAC__ASSERT(0 != bw); + + FLAC__bitwriter_free(bw); + free(bw); +} + +/*********************************************************************** + * + * Public class methods + * + ***********************************************************************/ + +FLAC__bool FLAC__bitwriter_init(FLAC__BitWriter *bw) +{ + FLAC__ASSERT(0 != bw); + + bw->words = bw->bits = 0; + bw->capacity = FLAC__BITWRITER_DEFAULT_CAPACITY; + bw->buffer = malloc(sizeof(bwword) * bw->capacity); + if(bw->buffer == 0) + return false; + + return true; +} + +void FLAC__bitwriter_free(FLAC__BitWriter *bw) +{ + FLAC__ASSERT(0 != bw); + + if(0 != bw->buffer) + free(bw->buffer); + bw->buffer = 0; + bw->capacity = 0; + bw->words = bw->bits = 0; +} + +void FLAC__bitwriter_clear(FLAC__BitWriter *bw) +{ + bw->words = bw->bits = 0; +} + +void FLAC__bitwriter_dump(const FLAC__BitWriter *bw, FILE *out) +{ + unsigned i, j; + if(bw == 0) { + fprintf(out, "bitwriter is NULL\n"); + } + else { + fprintf(out, "bitwriter: capacity=%u words=%u bits=%u total_bits=%u\n", bw->capacity, bw->words, bw->bits, FLAC__TOTAL_BITS(bw)); + + for(i = 0; i < bw->words; i++) { + fprintf(out, "%08X: ", i); + for(j = 0; j < FLAC__BITS_PER_WORD; j++) + fprintf(out, "%01u", bw->buffer[i] & ((bwword)1 << (FLAC__BITS_PER_WORD-j-1)) ? 1:0); + fprintf(out, "\n"); + } + if(bw->bits > 0) { + fprintf(out, "%08X: ", i); + for(j = 0; j < bw->bits; j++) + fprintf(out, "%01u", bw->accum & ((bwword)1 << (bw->bits-j-1)) ? 1:0); + fprintf(out, "\n"); + } + } +} + +FLAC__bool FLAC__bitwriter_get_write_crc16(FLAC__BitWriter *bw, FLAC__uint16 *crc) +{ + const FLAC__byte *buffer; + size_t bytes; + + FLAC__ASSERT((bw->bits & 7) == 0); /* assert that we're byte-aligned */ + + if(!FLAC__bitwriter_get_buffer(bw, &buffer, &bytes)) + return false; + + *crc = (FLAC__uint16)FLAC__crc16(buffer, bytes); + FLAC__bitwriter_release_buffer(bw); + return true; +} + +FLAC__bool FLAC__bitwriter_get_write_crc8(FLAC__BitWriter *bw, FLAC__byte *crc) +{ + const FLAC__byte *buffer; + size_t bytes; + + FLAC__ASSERT((bw->bits & 7) == 0); /* assert that we're byte-aligned */ + + if(!FLAC__bitwriter_get_buffer(bw, &buffer, &bytes)) + return false; + + *crc = FLAC__crc8(buffer, bytes); + FLAC__bitwriter_release_buffer(bw); + return true; +} + +FLAC__bool FLAC__bitwriter_is_byte_aligned(const FLAC__BitWriter *bw) +{ + return ((bw->bits & 7) == 0); +} + +unsigned FLAC__bitwriter_get_input_bits_unconsumed(const FLAC__BitWriter *bw) +{ + return FLAC__TOTAL_BITS(bw); +} + +FLAC__bool FLAC__bitwriter_get_buffer(FLAC__BitWriter *bw, const FLAC__byte **buffer, size_t *bytes) +{ + FLAC__ASSERT((bw->bits & 7) == 0); + /* double protection */ + if(bw->bits & 7) + return false; + /* if we have bits in the accumulator we have to flush those to the buffer first */ + if(bw->bits) { + FLAC__ASSERT(bw->words <= bw->capacity); + if(bw->words == bw->capacity && !bitwriter_grow_(bw, FLAC__BITS_PER_WORD)) + return false; + /* append bits as complete word to buffer, but don't change bw->accum or bw->bits */ + bw->buffer[bw->words] = SWAP_BE_WORD_TO_HOST(bw->accum << (FLAC__BITS_PER_WORD-bw->bits)); + } + /* now we can just return what we have */ + *buffer = (FLAC__byte*)bw->buffer; + *bytes = (FLAC__BYTES_PER_WORD * bw->words) + (bw->bits >> 3); + return true; +} + +void FLAC__bitwriter_release_buffer(FLAC__BitWriter *bw) +{ + /* nothing to do. in the future, strict checking of a 'writer-is-in- + * get-mode' flag could be added everywhere and then cleared here + */ + (void)bw; +} + +inline FLAC__bool FLAC__bitwriter_write_zeroes(FLAC__BitWriter *bw, unsigned bits) +{ + unsigned n; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + + if(bits == 0) + return true; + /* slightly pessimistic size check but faster than "<= bw->words + (bw->bits+bits+FLAC__BITS_PER_WORD-1)/FLAC__BITS_PER_WORD" */ + if(bw->capacity <= bw->words + bits && !bitwriter_grow_(bw, bits)) + return false; + /* first part gets to word alignment */ + if(bw->bits) { + n = flac_min(FLAC__BITS_PER_WORD - bw->bits, bits); + bw->accum <<= n; + bits -= n; + bw->bits += n; + if(bw->bits == FLAC__BITS_PER_WORD) { + bw->buffer[bw->words++] = SWAP_BE_WORD_TO_HOST(bw->accum); + bw->bits = 0; + } + else + return true; + } + /* do whole words */ + while(bits >= FLAC__BITS_PER_WORD) { + bw->buffer[bw->words++] = 0; + bits -= FLAC__BITS_PER_WORD; + } + /* do any leftovers */ + if(bits > 0) { + bw->accum = 0; + bw->bits = bits; + } + return true; +} + +static inline FLAC__bool FLAC__bitwriter_write_raw_uint32_nocheck(FLAC__BitWriter *bw, FLAC__uint32 val, unsigned bits) +{ + register unsigned left; + + /* WATCHOUT: code does not work with <32bit words; we can make things much faster with this assertion */ + FLAC__ASSERT(FLAC__BITS_PER_WORD >= 32); + + if(bw == 0 || bw->buffer == 0) + return false; + + if (bits > 32) + return false; + + if(bits == 0) + return true; + + FLAC__ASSERT((bits == 32) || (val>>bits == 0)); + + /* slightly pessimistic size check but faster than "<= bw->words + (bw->bits+bits+FLAC__BITS_PER_WORD-1)/FLAC__BITS_PER_WORD" */ + if(bw->capacity <= bw->words + bits && !bitwriter_grow_(bw, bits)) + return false; + + left = FLAC__BITS_PER_WORD - bw->bits; + if(bits < left) { + bw->accum <<= bits; + bw->accum |= val; + bw->bits += bits; + } + else if(bw->bits) { /* WATCHOUT: if bw->bits == 0, left==FLAC__BITS_PER_WORD and bw->accum<<=left is a NOP instead of setting to 0 */ + bw->accum <<= left; + bw->accum |= val >> (bw->bits = bits - left); + bw->buffer[bw->words++] = SWAP_BE_WORD_TO_HOST(bw->accum); + bw->accum = val; /* unused top bits can contain garbage */ + } + else { /* at this point bits == FLAC__BITS_PER_WORD == 32 and bw->bits == 0 */ + bw->buffer[bw->words++] = SWAP_BE_WORD_TO_HOST((bwword)val); + } + + return true; +} + +inline FLAC__bool FLAC__bitwriter_write_raw_uint32(FLAC__BitWriter *bw, FLAC__uint32 val, unsigned bits) +{ + /* check that unused bits are unset */ + if((bits < 32) && (val>>bits != 0)) + return false; + + return FLAC__bitwriter_write_raw_uint32_nocheck(bw, val, bits); +} + +inline FLAC__bool FLAC__bitwriter_write_raw_int32(FLAC__BitWriter *bw, FLAC__int32 val, unsigned bits) +{ + /* zero-out unused bits */ + if(bits < 32) + val &= (~(0xffffffff << bits)); + + return FLAC__bitwriter_write_raw_uint32_nocheck(bw, (FLAC__uint32)val, bits); +} + +inline FLAC__bool FLAC__bitwriter_write_raw_uint64(FLAC__BitWriter *bw, FLAC__uint64 val, unsigned bits) +{ + /* this could be a little faster but it's not used for much */ + if(bits > 32) { + return + FLAC__bitwriter_write_raw_uint32(bw, (FLAC__uint32)(val>>32), bits-32) && + FLAC__bitwriter_write_raw_uint32_nocheck(bw, (FLAC__uint32)val, 32); + } + else + return FLAC__bitwriter_write_raw_uint32(bw, (FLAC__uint32)val, bits); +} + +inline FLAC__bool FLAC__bitwriter_write_raw_uint32_little_endian(FLAC__BitWriter *bw, FLAC__uint32 val) +{ + /* this doesn't need to be that fast as currently it is only used for vorbis comments */ + + if(!FLAC__bitwriter_write_raw_uint32_nocheck(bw, val & 0xff, 8)) + return false; + if(!FLAC__bitwriter_write_raw_uint32_nocheck(bw, (val>>8) & 0xff, 8)) + return false; + if(!FLAC__bitwriter_write_raw_uint32_nocheck(bw, (val>>16) & 0xff, 8)) + return false; + if(!FLAC__bitwriter_write_raw_uint32_nocheck(bw, val>>24, 8)) + return false; + + return true; +} + +inline FLAC__bool FLAC__bitwriter_write_byte_block(FLAC__BitWriter *bw, const FLAC__byte vals[], unsigned nvals) +{ + unsigned i; + + /* this could be faster but currently we don't need it to be since it's only used for writing metadata */ + for(i = 0; i < nvals; i++) { + if(!FLAC__bitwriter_write_raw_uint32_nocheck(bw, (FLAC__uint32)(vals[i]), 8)) + return false; + } + + return true; +} + +FLAC__bool FLAC__bitwriter_write_unary_unsigned(FLAC__BitWriter *bw, unsigned val) +{ + if(val < 32) + return FLAC__bitwriter_write_raw_uint32_nocheck(bw, 1, ++val); + else + return + FLAC__bitwriter_write_zeroes(bw, val) && + FLAC__bitwriter_write_raw_uint32_nocheck(bw, 1, 1); +} + +unsigned FLAC__bitwriter_rice_bits(FLAC__int32 val, unsigned parameter) +{ + FLAC__uint32 uval; + + FLAC__ASSERT(parameter < 32); + + /* fold signed to unsigned; actual formula is: negative(v)? -2v-1 : 2v */ + uval = val; + uval <<= 1; + uval ^= (val>>31); + + return 1 + parameter + (uval >> parameter); +} + +#if 0 /* UNUSED */ +unsigned FLAC__bitwriter_golomb_bits_signed(int val, unsigned parameter) +{ + unsigned bits, msbs, uval; + unsigned k; + + FLAC__ASSERT(parameter > 0); + + /* fold signed to unsigned */ + if(val < 0) + uval = (unsigned)(((-(++val)) << 1) + 1); + else + uval = (unsigned)(val << 1); + + k = FLAC__bitmath_ilog2(parameter); + if(parameter == 1u<> k; + bits = 1 + k + msbs; + } + else { + unsigned q, r, d; + + d = (1 << (k+1)) - parameter; + q = uval / parameter; + r = uval - (q * parameter); + + bits = 1 + q + k; + if(r >= d) + bits++; + } + return bits; +} + +unsigned FLAC__bitwriter_golomb_bits_unsigned(unsigned uval, unsigned parameter) +{ + unsigned bits, msbs; + unsigned k; + + FLAC__ASSERT(parameter > 0); + + k = FLAC__bitmath_ilog2(parameter); + if(parameter == 1u<> k; + bits = 1 + k + msbs; + } + else { + unsigned q, r, d; + + d = (1 << (k+1)) - parameter; + q = uval / parameter; + r = uval - (q * parameter); + + bits = 1 + q + k; + if(r >= d) + bits++; + } + return bits; +} +#endif /* UNUSED */ + +FLAC__bool FLAC__bitwriter_write_rice_signed(FLAC__BitWriter *bw, FLAC__int32 val, unsigned parameter) +{ + unsigned total_bits, interesting_bits, msbs; + FLAC__uint32 uval, pattern; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + FLAC__ASSERT(parameter < 32); + + /* fold signed to unsigned; actual formula is: negative(v)? -2v-1 : 2v */ + uval = val; + uval <<= 1; + uval ^= (val>>31); + + msbs = uval >> parameter; + interesting_bits = 1 + parameter; + total_bits = interesting_bits + msbs; + pattern = 1 << parameter; /* the unary end bit */ + pattern |= (uval & ((1<> (31-parameter); /* ...then mask off the bits above the stop bit with val&=mask2 */ + FLAC__uint32 uval; + unsigned left; + const unsigned lsbits = 1 + parameter; + unsigned msbits, total_bits; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + FLAC__ASSERT(parameter < 31); + /* WATCHOUT: code does not work with <32bit words; we can make things much faster with this assertion */ + FLAC__ASSERT(FLAC__BITS_PER_WORD >= 32); + + while(nvals) { + /* fold signed to unsigned; actual formula is: negative(v)? -2v-1 : 2v */ + uval = *vals; + uval <<= 1; + uval ^= (*vals>>31); + + msbits = uval >> parameter; + total_bits = lsbits + msbits; + + if(bw->bits && bw->bits + total_bits < FLAC__BITS_PER_WORD) { /* i.e. if the whole thing fits in the current bwword */ + /* ^^^ if bw->bits is 0 then we may have filled the buffer and have no free bwword to work in */ + bw->bits += total_bits; + uval |= mask1; /* set stop bit */ + uval &= mask2; /* mask off unused top bits */ + bw->accum <<= total_bits; + bw->accum |= uval; + } + else { + /* slightly pessimistic size check but faster than "<= bw->words + (bw->bits+msbits+lsbits+FLAC__BITS_PER_WORD-1)/FLAC__BITS_PER_WORD" */ + /* OPT: pessimism may cause flurry of false calls to grow_ which eat up all savings before it */ + if(bw->capacity <= bw->words + bw->bits + msbits + 1 /* lsbits always fit in 1 bwword */ && !bitwriter_grow_(bw, total_bits)) + return false; + + if(msbits) { + /* first part gets to word alignment */ + if(bw->bits) { + left = FLAC__BITS_PER_WORD - bw->bits; + if(msbits < left) { + bw->accum <<= msbits; + bw->bits += msbits; + goto break1; + } + else { + bw->accum <<= left; + msbits -= left; + bw->buffer[bw->words++] = SWAP_BE_WORD_TO_HOST(bw->accum); + bw->bits = 0; + } + } + /* do whole words */ + while(msbits >= FLAC__BITS_PER_WORD) { + bw->buffer[bw->words++] = 0; + msbits -= FLAC__BITS_PER_WORD; + } + /* do any leftovers */ + if(msbits > 0) { + bw->accum = 0; + bw->bits = msbits; + } + } +break1: + uval |= mask1; /* set stop bit */ + uval &= mask2; /* mask off unused top bits */ + + left = FLAC__BITS_PER_WORD - bw->bits; + if(lsbits < left) { + bw->accum <<= lsbits; + bw->accum |= uval; + bw->bits += lsbits; + } + else { + /* if bw->bits == 0, left==FLAC__BITS_PER_WORD which will always + * be > lsbits (because of previous assertions) so it would have + * triggered the (lsbitsbits); + FLAC__ASSERT(left < FLAC__BITS_PER_WORD); + bw->accum <<= left; + bw->accum |= uval >> (bw->bits = lsbits - left); + bw->buffer[bw->words++] = SWAP_BE_WORD_TO_HOST(bw->accum); + bw->accum = uval; /* unused top bits can contain garbage */ + } + } + vals++; + nvals--; + } + return true; +} + +#if 0 /* UNUSED */ +FLAC__bool FLAC__bitwriter_write_golomb_signed(FLAC__BitWriter *bw, int val, unsigned parameter) +{ + unsigned total_bits, msbs, uval; + unsigned k; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + FLAC__ASSERT(parameter > 0); + + /* fold signed to unsigned */ + if(val < 0) + uval = (unsigned)(((-(++val)) << 1) + 1); + else + uval = (unsigned)(val << 1); + + k = FLAC__bitmath_ilog2(parameter); + if(parameter == 1u<> k; + total_bits = 1 + k + msbs; + pattern = 1 << k; /* the unary end bit */ + pattern |= (uval & ((1u<= d) { + if(!FLAC__bitwriter_write_raw_uint32(bw, r+d, k+1)) + return false; + } + else { + if(!FLAC__bitwriter_write_raw_uint32(bw, r, k)) + return false; + } + } + return true; +} + +FLAC__bool FLAC__bitwriter_write_golomb_unsigned(FLAC__BitWriter *bw, unsigned uval, unsigned parameter) +{ + unsigned total_bits, msbs; + unsigned k; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + FLAC__ASSERT(parameter > 0); + + k = FLAC__bitmath_ilog2(parameter); + if(parameter == 1u<> k; + total_bits = 1 + k + msbs; + pattern = 1 << k; /* the unary end bit */ + pattern |= (uval & ((1u<= d) { + if(!FLAC__bitwriter_write_raw_uint32(bw, r+d, k+1)) + return false; + } + else { + if(!FLAC__bitwriter_write_raw_uint32(bw, r, k)) + return false; + } + } + return true; +} +#endif /* UNUSED */ + +FLAC__bool FLAC__bitwriter_write_utf8_uint32(FLAC__BitWriter *bw, FLAC__uint32 val) +{ + FLAC__bool ok = 1; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + + if((val & 0x80000000) != 0) /* this version only handles 31 bits */ + return false; + + if(val < 0x80) { + return FLAC__bitwriter_write_raw_uint32_nocheck(bw, val, 8); + } + else if(val < 0x800) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xC0 | (val>>6), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (val&0x3F), 8); + } + else if(val < 0x10000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xE0 | (val>>12), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (val&0x3F), 8); + } + else if(val < 0x200000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xF0 | (val>>18), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (val&0x3F), 8); + } + else if(val < 0x4000000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xF8 | (val>>24), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>18)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (val&0x3F), 8); + } + else { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xFC | (val>>30), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>24)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>18)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | ((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (val&0x3F), 8); + } + + return ok; +} + +FLAC__bool FLAC__bitwriter_write_utf8_uint64(FLAC__BitWriter *bw, FLAC__uint64 val) +{ + FLAC__bool ok = 1; + + FLAC__ASSERT(0 != bw); + FLAC__ASSERT(0 != bw->buffer); + + if((val & FLAC__U64L(0xFFFFFFF000000000)) != 0) /* this version only handles 36 bits */ + return false; + + if(val < 0x80) { + return FLAC__bitwriter_write_raw_uint32_nocheck(bw, (FLAC__uint32)val, 8); + } + else if(val < 0x800) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xC0 | (FLAC__uint32)(val>>6), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + else if(val < 0x10000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xE0 | (FLAC__uint32)(val>>12), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + else if(val < 0x200000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xF0 | (FLAC__uint32)(val>>18), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + else if(val < 0x4000000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xF8 | (FLAC__uint32)(val>>24), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>18)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + else if(val < 0x80000000) { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xFC | (FLAC__uint32)(val>>30), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>24)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>18)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + else { + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0xFE, 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>30)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>24)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>18)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>12)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)((val>>6)&0x3F), 8); + ok &= FLAC__bitwriter_write_raw_uint32_nocheck(bw, 0x80 | (FLAC__uint32)(val&0x3F), 8); + } + + return ok; +} + +FLAC__bool FLAC__bitwriter_zero_pad_to_byte_boundary(FLAC__BitWriter *bw) +{ + /* 0-pad to byte boundary */ + if(bw->bits & 7u) + return FLAC__bitwriter_write_zeroes(bw, 8 - (bw->bits & 7u)); + else + return true; +} + +/* These functions are declared inline in this file but are also callable as + * externs from elsewhere. + * According to the C99 spec, section 6.7.4, simply providing a function + * prototype in a header file without 'inline' and making the function inline + * in this file should be sufficient. + * Unfortunately, the Microsoft VS compiler doesn't pick them up externally. To + * fix that we add extern declarations here. + */ +extern FLAC__bool FLAC__bitwriter_write_zeroes(FLAC__BitWriter *bw, unsigned bits); +extern FLAC__bool FLAC__bitwriter_write_raw_uint32(FLAC__BitWriter *bw, FLAC__uint32 val, unsigned bits); +extern FLAC__bool FLAC__bitwriter_write_raw_int32(FLAC__BitWriter *bw, FLAC__int32 val, unsigned bits); +extern FLAC__bool FLAC__bitwriter_write_raw_uint64(FLAC__BitWriter *bw, FLAC__uint64 val, unsigned bits); +extern FLAC__bool FLAC__bitwriter_write_raw_uint32_little_endian(FLAC__BitWriter *bw, FLAC__uint32 val); +extern FLAC__bool FLAC__bitwriter_write_byte_block(FLAC__BitWriter *bw, const FLAC__byte vals[], unsigned nvals); diff --git a/src/libflac/config.h b/src/libflac/config.h new file mode 100644 index 0000000..a5fd247 --- /dev/null +++ b/src/libflac/config.h @@ -0,0 +1,242 @@ +/* config.h. Generated from config.h.in by configure. */ +/* config.h.in. Generated from configure.ac by autoheader. */ + +#define stack(a,b,c) + +/* Define if building universal (internal helper macro) */ +/* #undef AC_APPLE_UNIVERSAL_BUILD */ + +/* Target processor is big endian. */ +#define CPU_IS_BIG_ENDIAN 0 + +/* Target processor is little endian. */ +#define CPU_IS_LITTLE_ENDIAN 1 + +/* Set FLAC__BYTES_PER_WORD to 8 (4 is the default) */ +#define ENABLE_64_BIT_WORDS 0 + +/* define to align allocated memory on 32-byte boundaries */ +#define FLAC__ALIGN_MALLOC_DATA 1 + +/* define if building for ia32/i386 */ +/* #undef FLAC__CPU_IA32 */ + +/* define if building for PowerPC */ +/* #undef FLAC__CPU_PPC */ + +/* define if building for PowerPC with SPE ABI */ +/* #undef FLAC__CPU_PPC_SPE */ + +/* define if building for SPARC */ +/* #undef FLAC__CPU_SPARC */ + +/* define if building for x86_64 */ +#undef FLAC__CPU_X86_64 + +/* define if you have docbook-to-man or docbook2man */ +#undef FLAC__HAS_DOCBOOK_TO_MAN + +/* define if you are compiling for x86 and have the NASM assembler */ +#undef FLAC__HAS_NASM + +/* define if you have the ogg library */ +#define FLAC__HAS_OGG 0 + +/* Set to 1 if is available. */ +#undef FLAC__HAS_X86INTRIN + +/* define to disable use of assembly code */ +#define FLAC__NO_ASM 1 + +/* define if building for Darwin / MacOS X */ +/* #undef FLAC__SYS_DARWIN */ + +/* define if building for Linux */ +#undef FLAC__SYS_LINUX + +/* define to enable use of Altivec instructions */ +#undef FLAC__USE_ALTIVEC + +/* define to enable use of AVX instructions */ +#undef FLAC__USE_AVX + +/* Compiler has the __builtin_bswap16 intrinsic */ +#undef HAVE_BSWAP16 + +/* Compiler has the __builtin_bswap32 intrinsic */ +#undef HAVE_BSWAP32 + +/* Define to 1 if you have the header file. */ +#undef HAVE_BYTESWAP_H + +/* define if you have clock_gettime */ +#undef HAVE_CLOCK_GETTIME + +/* Define to 1 if you have the header file. */ +#undef HAVE_CPUID_H + +/* Define to 1 if C++ supports variable-length arrays. */ +#define HAVE_CXX_VARARRAYS 1 + +/* Define to 1 if C supports variable-length arrays. */ +#define HAVE_C_VARARRAYS 1 + +/* Define to 1 if you have the header file. */ +#undef HAVE_DLFCN_H + +/* Define to 1 if fseeko (and presumably ftello) exists and is declared. */ +#undef HAVE_FSEEKO + +/* Define to 1 if you have the `getopt_long' function. */ +#undef HAVE_GETOPT_LONG + +/* Define if you have the iconv() function and it works. */ +#undef HAVE_ICONV + +/* Define to 1 if you have the header file. */ +#undef HAVE_INTTYPES_H + +/* Define if you have and nl_langinfo(CODESET). */ +#define HAVE_LANGINFO_CODESET 1 + +/* lround support */ +#define HAVE_LROUND 1 + +/* Define to 1 if you have the header file. */ +#undef HAVE_MEMORY_H + +/* Define to 1 if the system has the type `socklen_t'. */ +#undef HAVE_SOCKLEN_T + +/* Define to 1 if you have the header file. */ +#define HAVE_STDINT_H 1 + +/* Define to 1 if you have the header file. */ +#undef HAVE_STDLIB_H + +/* Define to 1 if you have the header file. */ +#define HAVE_STRINGS_H 1 + +/* Define to 1 if you have the header file. */ +#define HAVE_STRING_H 1 + +/* Define to 1 if you have the header file. */ +#undef HAVE_SYS_IOCTL_H + +/* Define to 1 if you have the header file. */ +#undef HAVE_SYS_PARAM_H + +/* Define to 1 if you have the header file. */ +#undef HAVE_SYS_STAT_H + +/* Define to 1 if you have the header file. */ +#undef HAVE_SYS_TYPES_H + +/* Define to 1 if you have the header file. */ +#undef HAVE_TERMIOS_H + +/* Define to 1 if typeof works with your compiler. */ +#define HAVE_TYPEOF 1 + +/* Define to 1 if you have the header file. */ +#undef HAVE_UNISTD_H + +/* Define to 1 if you have the header file. */ +#undef HAVE_X86INTRIN_H + +/* Define as const if the declaration of iconv() needs const. */ +#define ICONV_CONST + +/* Define to the sub-directory where libtool stores uninstalled libraries. */ +#define LT_OBJDIR ".libs/" + +/* Name of package */ +#define PACKAGE "flac" + +/* Define to the address where bug reports for this package should be sent. */ +#define PACKAGE_BUGREPORT "flac-dev@xiph.org" + +/* Define to the full name of this package. */ +#define PACKAGE_NAME "flac" + +/* Define to the full name and version of this package. */ +#define PACKAGE_STRING "flac 1.3.2" + +/* Define to the one symbol short name of this package. */ +#define PACKAGE_TARNAME "flac" + +/* Define to the home page for this package. */ +#define PACKAGE_URL "https://www.xiph.org/flac/" + +/* Define to the version of this package. */ +#define PACKAGE_VERSION "1.3.2" + +/* The size of `off_t', as computed by sizeof. */ +#define SIZEOF_OFF_T 4 + +/* The size of `void*', as computed by sizeof. */ +#define SIZEOF_VOIDP 4 + +/* Define to 1 if you have the ANSI C header files. */ +#define STDC_HEADERS 1 + +/* Enable extensions on AIX 3, Interix. */ +#ifndef _ALL_SOURCE +# define _ALL_SOURCE 1 +#endif +/* Enable GNU extensions on systems that have them. */ +#ifndef _GNU_SOURCE +# define _GNU_SOURCE 1 +#endif +/* Enable threading extensions on Solaris. */ +#ifndef _POSIX_PTHREAD_SEMANTICS +# define _POSIX_PTHREAD_SEMANTICS 1 +#endif +/* Enable extensions on HP NonStop. */ +#ifndef _TANDEM_SOURCE +# define _TANDEM_SOURCE 1 +#endif +/* Enable general extensions on Solaris. */ +#ifndef __EXTENSIONS__ +# define __EXTENSIONS__ 1 +#endif + + +/* Version number of package */ +#define VERSION "1.3.2" + +/* Target processor is big endian. */ +#define WORDS_BIGENDIAN 0 + +/* Enable large inode numbers on Mac OS X 10.5. */ +#ifndef _DARWIN_USE_64_BIT_INODE +# define _DARWIN_USE_64_BIT_INODE 1 +#endif + +/* Number of bits in a file offset, on hosts where this is settable. */ +/* #undef _FILE_OFFSET_BITS */ + +/* Define to 1 to make fseeko visible on some hosts (e.g. glibc 2.2). */ +/* #undef _LARGEFILE_SOURCE */ + +/* Define for large files, on AIX-style hosts. */ +/* #undef _LARGE_FILES */ + +/* Define to 1 if on MINIX. */ +/* #undef _MINIX */ + +/* Define to 2 if the system does not provide POSIX.1 features except with + this defined. */ +/* #undef _POSIX_1_SOURCE */ + +/* Define to 1 if you need to in order for `stat' and other things to work. */ +/* #undef _POSIX_SOURCE */ + +/* Define to `__inline__' or `__inline' if that's what the C compiler + calls it, or to nothing if 'inline' is not supported under any name. */ +#ifndef __cplusplus +/* #undef inline */ +#endif + +/* Define to __typeof__ if your compiler spells it that way. */ +/* #undef typeof */ diff --git a/src/libflac/cpu.c b/src/libflac/cpu.c new file mode 100644 index 0000000..c829780 --- /dev/null +++ b/src/libflac/cpu.c @@ -0,0 +1,294 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include "private/cpu.h" +#include "share/compat.h" +#include +//#include +#include + +#if defined(_MSC_VER) +# include /* for __cpuid() and _xgetbv() */ +#endif + +#if defined __GNUC__ && defined HAVE_CPUID_H +# include /* for __get_cpuid() and __get_cpuid_max() */ +#endif + +#ifdef DEBUG +#include + +#define dfprintf fprintf +#else +/* This is bad practice, it should be a static void empty function */ +#define dfprintf(file, format, ...) +#endif + + +#if defined FLAC__CPU_IA32 +/* these are flags in EDX of CPUID AX=00000001 */ +static const unsigned FLAC__CPUINFO_IA32_CPUID_CMOV = 0x00008000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_MMX = 0x00800000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSE = 0x02000000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSE2 = 0x04000000; +#endif + +#if FLAC__HAS_X86INTRIN || FLAC__AVX_SUPPORTED +/* these are flags in ECX of CPUID AX=00000001 */ +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSE3 = 0x00000001; +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSSE3 = 0x00000200; +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSE41 = 0x00080000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_SSE42 = 0x00100000; + +/* these are flags in ECX of CPUID AX=00000001 */ +static const unsigned FLAC__CPUINFO_IA32_CPUID_OSXSAVE = 0x08000000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_AVX = 0x10000000; +static const unsigned FLAC__CPUINFO_IA32_CPUID_FMA = 0x00001000; +/* these are flags in EBX of CPUID AX=00000007 */ +static const unsigned FLAC__CPUINFO_IA32_CPUID_AVX2 = 0x00000020; +#endif + +#if defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64 +static uint32_t +cpu_xgetbv_x86(void) +{ +#if (defined _MSC_VER || defined __INTEL_COMPILER) && FLAC__HAS_X86INTRIN && FLAC__AVX_SUPPORTED + return (uint32_t)_xgetbv(0); +#elif defined __GNUC__ + uint32_t lo, hi; + asm volatile (".byte 0x0f, 0x01, 0xd0" : "=a"(lo), "=d"(hi) : "c" (0)); + return lo; +#else + return 0; +#endif +} +#endif + +static void +ia32_cpu_info (FLAC__CPUInfo *info) +{ +#if !defined FLAC__CPU_IA32 + (void) info; +#else + FLAC__bool ia32_osxsave = false; + FLAC__uint32 flags_eax, flags_ebx, flags_ecx, flags_edx; + +#if !defined FLAC__NO_ASM && (defined FLAC__HAS_NASM || FLAC__HAS_X86INTRIN) + info->use_asm = true; /* we assume a minimum of 80386 with FLAC__CPU_IA32 */ +#if defined FLAC__HAS_NASM + if(!FLAC__cpu_have_cpuid_asm_ia32()) + return; +#endif + /* http://www.sandpile.org/x86/cpuid.htm */ + if (FLAC__HAS_X86INTRIN) { + FLAC__cpu_info_x86(0, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + info->ia32.intel = (flags_ebx == 0x756E6547 && flags_edx == 0x49656E69 && flags_ecx == 0x6C65746E) ? true : false; /* GenuineIntel */ + FLAC__cpu_info_x86(1, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + } + else { + FLAC__cpu_info_asm_ia32(&flags_edx, &flags_ecx); + } + + info->ia32.cmov = (flags_edx & FLAC__CPUINFO_IA32_CPUID_CMOV ) ? true : false; + info->ia32.mmx = (flags_edx & FLAC__CPUINFO_IA32_CPUID_MMX ) ? true : false; + info->ia32.sse = (flags_edx & FLAC__CPUINFO_IA32_CPUID_SSE ) ? true : false; + info->ia32.sse2 = (flags_edx & FLAC__CPUINFO_IA32_CPUID_SSE2 ) ? true : false; + info->ia32.sse3 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE3 ) ? true : false; + info->ia32.ssse3 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSSE3) ? true : false; + info->ia32.sse41 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE41) ? true : false; + info->ia32.sse42 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE42) ? true : false; + + if (FLAC__HAS_X86INTRIN && FLAC__AVX_SUPPORTED) { + ia32_osxsave = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_OSXSAVE) ? true : false; + info->ia32.avx = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_AVX ) ? true : false; + info->ia32.fma = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_FMA ) ? true : false; + FLAC__cpu_info_x86(7, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + info->ia32.avx2 = (flags_ebx & FLAC__CPUINFO_IA32_CPUID_AVX2 ) ? true : false; + } + + dfprintf(stderr, "CPU info (IA-32):\n"); + dfprintf(stderr, " CMOV ....... %c\n", info->ia32.cmov ? 'Y' : 'n'); + dfprintf(stderr, " MMX ........ %c\n", info->ia32.mmx ? 'Y' : 'n'); + dfprintf(stderr, " SSE ........ %c\n", info->ia32.sse ? 'Y' : 'n'); + dfprintf(stderr, " SSE2 ....... %c\n", info->ia32.sse2 ? 'Y' : 'n'); + dfprintf(stderr, " SSE3 ....... %c\n", info->ia32.sse3 ? 'Y' : 'n'); + dfprintf(stderr, " SSSE3 ...... %c\n", info->ia32.ssse3 ? 'Y' : 'n'); + dfprintf(stderr, " SSE41 ...... %c\n", info->ia32.sse41 ? 'Y' : 'n'); + dfprintf(stderr, " SSE42 ...... %c\n", info->ia32.sse42 ? 'Y' : 'n'); + + if (FLAC__HAS_X86INTRIN && FLAC__AVX_SUPPORTED) { + dfprintf(stderr, " AVX ........ %c\n", info->ia32.avx ? 'Y' : 'n'); + dfprintf(stderr, " FMA ........ %c\n", info->ia32.fma ? 'Y' : 'n'); + dfprintf(stderr, " AVX2 ....... %c\n", info->ia32.avx2 ? 'Y' : 'n'); + } + + /* + * now have to check for OS support of AVX instructions + */ + if (!FLAC__HAS_X86INTRIN || !info->ia32.avx || !ia32_osxsave || (cpu_xgetbv_x86() & 0x6) != 0x6) { + /* no OS AVX support */ + info->ia32.avx = false; + info->ia32.avx2 = false; + info->ia32.fma = false; + } + + if (FLAC__HAS_X86INTRIN && FLAC__AVX_SUPPORTED) { + dfprintf(stderr, " AVX OS sup . %c\n", info->ia32.avx ? 'Y' : 'n'); + } +#else + info->use_asm = false; +#endif +#endif +} + +static void +x86_64_cpu_info (FLAC__CPUInfo *info) +{ +#if !defined FLAC__NO_ASM && FLAC__HAS_X86INTRIN + FLAC__bool x86_osxsave = false; + FLAC__uint32 flags_eax, flags_ebx, flags_ecx, flags_edx; + + info->use_asm = true; + + /* http://www.sandpile.org/x86/cpuid.htm */ + FLAC__cpu_info_x86(0, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + info->x86.intel = (flags_ebx == 0x756E6547 && flags_edx == 0x49656E69 && flags_ecx == 0x6C65746E) ? true : false; /* GenuineIntel */ + FLAC__cpu_info_x86(1, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + info->x86.sse3 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE3 ) ? true : false; + info->x86.ssse3 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSSE3) ? true : false; + info->x86.sse41 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE41) ? true : false; + info->x86.sse42 = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_SSE42) ? true : false; + + if (FLAC__AVX_SUPPORTED) { + x86_osxsave = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_OSXSAVE) ? true : false; + info->x86.avx = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_AVX ) ? true : false; + info->x86.fma = (flags_ecx & FLAC__CPUINFO_IA32_CPUID_FMA ) ? true : false; + FLAC__cpu_info_x86(7, &flags_eax, &flags_ebx, &flags_ecx, &flags_edx); + info->x86.avx2 = (flags_ebx & FLAC__CPUINFO_IA32_CPUID_AVX2 ) ? true : false; + } + + dfprintf(stderr, "CPU info (x86-64):\n"); + dfprintf(stderr, " SSE3 ....... %c\n", info->x86.sse3 ? 'Y' : 'n'); + dfprintf(stderr, " SSSE3 ...... %c\n", info->x86.ssse3 ? 'Y' : 'n'); + dfprintf(stderr, " SSE41 ...... %c\n", info->x86.sse41 ? 'Y' : 'n'); + dfprintf(stderr, " SSE42 ...... %c\n", info->x86.sse42 ? 'Y' : 'n'); + + if (FLAC__AVX_SUPPORTED) { + dfprintf(stderr, " AVX ........ %c\n", info->x86.avx ? 'Y' : 'n'); + dfprintf(stderr, " FMA ........ %c\n", info->x86.fma ? 'Y' : 'n'); + dfprintf(stderr, " AVX2 ....... %c\n", info->x86.avx2 ? 'Y' : 'n'); + } + + /* + * now have to check for OS support of AVX instructions + */ + if (!info->x86.avx || !x86_osxsave || (cpu_xgetbv_x86() & 0x6) != 0x6) { + /* no OS AVX support */ + info->x86.avx = false; + info->x86.avx2 = false; + info->x86.fma = false; + } + + if (FLAC__AVX_SUPPORTED) { + dfprintf(stderr, " AVX OS sup . %c\n", info->x86.avx ? 'Y' : 'n'); + } +#else + /* Silence compiler warnings. */ + (void) info; +#if defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64 + if (0) cpu_xgetbv_x86 (); +#endif +#endif +} + +void FLAC__cpu_info (FLAC__CPUInfo *info) +{ + memset(info, 0, sizeof(*info)); + +#ifdef FLAC__CPU_IA32 + info->type = FLAC__CPUINFO_TYPE_IA32; +#elif defined FLAC__CPU_X86_64 + info->type = FLAC__CPUINFO_TYPE_X86_64; +#else + info->type = FLAC__CPUINFO_TYPE_UNKNOWN; + info->use_asm = false; +#endif + + switch (info->type) { + case FLAC__CPUINFO_TYPE_IA32: + ia32_cpu_info (info); + break; + case FLAC__CPUINFO_TYPE_X86_64: + x86_64_cpu_info (info); + break; + default: + info->use_asm = false; + break; + } +} + +#if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN + +void FLAC__cpu_info_x86(FLAC__uint32 level, FLAC__uint32 *eax, FLAC__uint32 *ebx, FLAC__uint32 *ecx, FLAC__uint32 *edx) +{ +#if defined _MSC_VER || defined __INTEL_COMPILER + int cpuinfo[4]; + int ext = level & 0x80000000; + __cpuid(cpuinfo, ext); + if((unsigned)cpuinfo[0] >= level) { +#if FLAC__AVX_SUPPORTED + __cpuidex(cpuinfo, ext, 0); /* for AVX2 detection */ +#else + __cpuid(cpuinfo, ext); /* some old compilers don't support __cpuidex */ +#endif + + *eax = cpuinfo[0]; *ebx = cpuinfo[1]; *ecx = cpuinfo[2]; *edx = cpuinfo[3]; + + return; + } +#elif defined __GNUC__ && defined HAVE_CPUID_H + FLAC__uint32 ext = level & 0x80000000; + __cpuid(ext, *eax, *ebx, *ecx, *edx); + if (*eax >= level) { + __cpuid_count(level, 0, *eax, *ebx, *ecx, *edx); + + return; + } +#endif + *eax = *ebx = *ecx = *edx = 0; +} + +#endif /* (FLAC__CPU_IA32 || FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN */ diff --git a/src/libflac/crc.c b/src/libflac/crc.c new file mode 100644 index 0000000..3519db6 --- /dev/null +++ b/src/libflac/crc.c @@ -0,0 +1,145 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif +#include +#include + +#include "private/crc.h" + +/* CRC-8, poly = x^8 + x^2 + x^1 + x^0, init = 0 */ + +FLAC__byte const FLAC__crc8_table[256] PROGMEM = { + 0x00, 0x07, 0x0E, 0x09, 0x1C, 0x1B, 0x12, 0x15, + 0x38, 0x3F, 0x36, 0x31, 0x24, 0x23, 0x2A, 0x2D, + 0x70, 0x77, 0x7E, 0x79, 0x6C, 0x6B, 0x62, 0x65, + 0x48, 0x4F, 0x46, 0x41, 0x54, 0x53, 0x5A, 0x5D, + 0xE0, 0xE7, 0xEE, 0xE9, 0xFC, 0xFB, 0xF2, 0xF5, + 0xD8, 0xDF, 0xD6, 0xD1, 0xC4, 0xC3, 0xCA, 0xCD, + 0x90, 0x97, 0x9E, 0x99, 0x8C, 0x8B, 0x82, 0x85, + 0xA8, 0xAF, 0xA6, 0xA1, 0xB4, 0xB3, 0xBA, 0xBD, + 0xC7, 0xC0, 0xC9, 0xCE, 0xDB, 0xDC, 0xD5, 0xD2, + 0xFF, 0xF8, 0xF1, 0xF6, 0xE3, 0xE4, 0xED, 0xEA, + 0xB7, 0xB0, 0xB9, 0xBE, 0xAB, 0xAC, 0xA5, 0xA2, + 0x8F, 0x88, 0x81, 0x86, 0x93, 0x94, 0x9D, 0x9A, + 0x27, 0x20, 0x29, 0x2E, 0x3B, 0x3C, 0x35, 0x32, + 0x1F, 0x18, 0x11, 0x16, 0x03, 0x04, 0x0D, 0x0A, + 0x57, 0x50, 0x59, 0x5E, 0x4B, 0x4C, 0x45, 0x42, + 0x6F, 0x68, 0x61, 0x66, 0x73, 0x74, 0x7D, 0x7A, + 0x89, 0x8E, 0x87, 0x80, 0x95, 0x92, 0x9B, 0x9C, + 0xB1, 0xB6, 0xBF, 0xB8, 0xAD, 0xAA, 0xA3, 0xA4, + 0xF9, 0xFE, 0xF7, 0xF0, 0xE5, 0xE2, 0xEB, 0xEC, + 0xC1, 0xC6, 0xCF, 0xC8, 0xDD, 0xDA, 0xD3, 0xD4, + 0x69, 0x6E, 0x67, 0x60, 0x75, 0x72, 0x7B, 0x7C, + 0x51, 0x56, 0x5F, 0x58, 0x4D, 0x4A, 0x43, 0x44, + 0x19, 0x1E, 0x17, 0x10, 0x05, 0x02, 0x0B, 0x0C, + 0x21, 0x26, 0x2F, 0x28, 0x3D, 0x3A, 0x33, 0x34, + 0x4E, 0x49, 0x40, 0x47, 0x52, 0x55, 0x5C, 0x5B, + 0x76, 0x71, 0x78, 0x7F, 0x6A, 0x6D, 0x64, 0x63, + 0x3E, 0x39, 0x30, 0x37, 0x22, 0x25, 0x2C, 0x2B, + 0x06, 0x01, 0x08, 0x0F, 0x1A, 0x1D, 0x14, 0x13, + 0xAE, 0xA9, 0xA0, 0xA7, 0xB2, 0xB5, 0xBC, 0xBB, + 0x96, 0x91, 0x98, 0x9F, 0x8A, 0x8D, 0x84, 0x83, + 0xDE, 0xD9, 0xD0, 0xD7, 0xC2, 0xC5, 0xCC, 0xCB, + 0xE6, 0xE1, 0xE8, 0xEF, 0xFA, 0xFD, 0xF4, 0xF3 +}; + +/* CRC-16, poly = x^16 + x^15 + x^2 + x^0, init = 0 */ + +unsigned const FLAC__crc16_table[256] PROGMEM = { + 0x0000, 0x8005, 0x800f, 0x000a, 0x801b, 0x001e, 0x0014, 0x8011, + 0x8033, 0x0036, 0x003c, 0x8039, 0x0028, 0x802d, 0x8027, 0x0022, + 0x8063, 0x0066, 0x006c, 0x8069, 0x0078, 0x807d, 0x8077, 0x0072, + 0x0050, 0x8055, 0x805f, 0x005a, 0x804b, 0x004e, 0x0044, 0x8041, + 0x80c3, 0x00c6, 0x00cc, 0x80c9, 0x00d8, 0x80dd, 0x80d7, 0x00d2, + 0x00f0, 0x80f5, 0x80ff, 0x00fa, 0x80eb, 0x00ee, 0x00e4, 0x80e1, + 0x00a0, 0x80a5, 0x80af, 0x00aa, 0x80bb, 0x00be, 0x00b4, 0x80b1, + 0x8093, 0x0096, 0x009c, 0x8099, 0x0088, 0x808d, 0x8087, 0x0082, + 0x8183, 0x0186, 0x018c, 0x8189, 0x0198, 0x819d, 0x8197, 0x0192, + 0x01b0, 0x81b5, 0x81bf, 0x01ba, 0x81ab, 0x01ae, 0x01a4, 0x81a1, + 0x01e0, 0x81e5, 0x81ef, 0x01ea, 0x81fb, 0x01fe, 0x01f4, 0x81f1, + 0x81d3, 0x01d6, 0x01dc, 0x81d9, 0x01c8, 0x81cd, 0x81c7, 0x01c2, + 0x0140, 0x8145, 0x814f, 0x014a, 0x815b, 0x015e, 0x0154, 0x8151, + 0x8173, 0x0176, 0x017c, 0x8179, 0x0168, 0x816d, 0x8167, 0x0162, + 0x8123, 0x0126, 0x012c, 0x8129, 0x0138, 0x813d, 0x8137, 0x0132, + 0x0110, 0x8115, 0x811f, 0x011a, 0x810b, 0x010e, 0x0104, 0x8101, + 0x8303, 0x0306, 0x030c, 0x8309, 0x0318, 0x831d, 0x8317, 0x0312, + 0x0330, 0x8335, 0x833f, 0x033a, 0x832b, 0x032e, 0x0324, 0x8321, + 0x0360, 0x8365, 0x836f, 0x036a, 0x837b, 0x037e, 0x0374, 0x8371, + 0x8353, 0x0356, 0x035c, 0x8359, 0x0348, 0x834d, 0x8347, 0x0342, + 0x03c0, 0x83c5, 0x83cf, 0x03ca, 0x83db, 0x03de, 0x03d4, 0x83d1, + 0x83f3, 0x03f6, 0x03fc, 0x83f9, 0x03e8, 0x83ed, 0x83e7, 0x03e2, + 0x83a3, 0x03a6, 0x03ac, 0x83a9, 0x03b8, 0x83bd, 0x83b7, 0x03b2, + 0x0390, 0x8395, 0x839f, 0x039a, 0x838b, 0x038e, 0x0384, 0x8381, + 0x0280, 0x8285, 0x828f, 0x028a, 0x829b, 0x029e, 0x0294, 0x8291, + 0x82b3, 0x02b6, 0x02bc, 0x82b9, 0x02a8, 0x82ad, 0x82a7, 0x02a2, + 0x82e3, 0x02e6, 0x02ec, 0x82e9, 0x02f8, 0x82fd, 0x82f7, 0x02f2, + 0x02d0, 0x82d5, 0x82df, 0x02da, 0x82cb, 0x02ce, 0x02c4, 0x82c1, + 0x8243, 0x0246, 0x024c, 0x8249, 0x0258, 0x825d, 0x8257, 0x0252, + 0x0270, 0x8275, 0x827f, 0x027a, 0x826b, 0x026e, 0x0264, 0x8261, + 0x0220, 0x8225, 0x822f, 0x022a, 0x823b, 0x023e, 0x0234, 0x8231, + 0x8213, 0x0216, 0x021c, 0x8219, 0x0208, 0x820d, 0x8207, 0x0202 +}; + + +void FLAC__crc8_update(const FLAC__byte data, FLAC__uint8 *crc) +{ + *crc = pgm_read_byte(&FLAC__crc8_table[*crc ^ data]); +} + +void FLAC__crc8_update_block(const FLAC__byte *data, unsigned len, FLAC__uint8 *crc) +{ + while(len--) + *crc = pgm_read_byte(&FLAC__crc8_table[*crc ^ *data++]); +} + +FLAC__uint8 FLAC__crc8(const FLAC__byte *data, unsigned len) +{ + FLAC__uint8 crc = 0; + + while(len--) + crc = pgm_read_byte(&FLAC__crc8_table[crc ^ *data++]); + + return crc; +} + +unsigned FLAC__crc16(const FLAC__byte *data, unsigned len) +{ + unsigned crc = 0; + + while(len--) + crc = ((crc<<8) ^ pgm_read_word(&FLAC__crc16_table[(crc>>8) ^ *data++])) & 0xffff; + + return crc; +} diff --git a/src/libflac/fixed.c b/src/libflac/fixed.c new file mode 100644 index 0000000..ee9bd21 --- /dev/null +++ b/src/libflac/fixed.c @@ -0,0 +1,395 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include +#include "share/compat.h" +#include "private/bitmath.h" +#include "private/fixed.h" +#include "private/macros.h" +#include "FLAC/assert.h" + +#ifdef local_abs +#undef local_abs +#endif +#define local_abs(x) ((unsigned)((x)<0? -(x) : (x))) + +#ifdef FLAC__INTEGER_ONLY_LIBRARY +/* rbps stands for residual bits per sample + * + * (ln(2) * err) + * rbps = log (-----------) + * 2 ( n ) + */ +static FLAC__fixedpoint local__compute_rbps_integerized(FLAC__uint32 err, FLAC__uint32 n) +{ + FLAC__uint32 rbps; + unsigned bits; /* the number of bits required to represent a number */ + int fracbits; /* the number of bits of rbps that comprise the fractional part */ + + FLAC__ASSERT(sizeof(rbps) == sizeof(FLAC__fixedpoint)); + FLAC__ASSERT(err > 0); + FLAC__ASSERT(n > 0); + + FLAC__ASSERT(n <= FLAC__MAX_BLOCK_SIZE); + if(err <= n) + return 0; + /* + * The above two things tell us 1) n fits in 16 bits; 2) err/n > 1. + * These allow us later to know we won't lose too much precision in the + * fixed-point division (err< 0); + bits = FLAC__bitmath_ilog2(err)+1; + if(bits > 16) { + err >>= (bits-16); + fracbits -= (bits-16); + } + rbps = (FLAC__uint32)err; + + /* Multiply by fixed-point version of ln(2), with 16 fractional bits */ + rbps *= FLAC__FP_LN2; + fracbits += 16; + FLAC__ASSERT(fracbits >= 0); + + /* FLAC__fixedpoint_log2 requires fracbits%4 to be 0 */ + { + const int f = fracbits & 3; + if(f) { + rbps >>= f; + fracbits -= f; + } + } + + rbps = FLAC__fixedpoint_log2(rbps, fracbits, (unsigned)(-1)); + + if(rbps == 0) + return 0; + + /* + * The return value must have 16 fractional bits. Since the whole part + * of the base-2 log of a 32 bit number must fit in 5 bits, and fracbits + * must be >= -3, these assertion allows us to be able to shift rbps + * left if necessary to get 16 fracbits without losing any bits of the + * whole part of rbps. + * + * There is a slight chance due to accumulated error that the whole part + * will require 6 bits, so we use 6 in the assertion. Really though as + * long as it fits in 13 bits (32 - (16 - (-3))) we are fine. + */ + FLAC__ASSERT((int)FLAC__bitmath_ilog2(rbps)+1 <= fracbits + 6); + FLAC__ASSERT(fracbits >= -3); + + /* now shift the decimal point into place */ + if(fracbits < 16) + return rbps << (16-fracbits); + else if(fracbits > 16) + return rbps >> (fracbits-16); + else + return rbps; +} + +static FLAC__fixedpoint local__compute_rbps_wide_integerized(FLAC__uint64 err, FLAC__uint32 n) +{ + FLAC__uint32 rbps; + unsigned bits; /* the number of bits required to represent a number */ + int fracbits; /* the number of bits of rbps that comprise the fractional part */ + + FLAC__ASSERT(sizeof(rbps) == sizeof(FLAC__fixedpoint)); + FLAC__ASSERT(err > 0); + FLAC__ASSERT(n > 0); + + FLAC__ASSERT(n <= FLAC__MAX_BLOCK_SIZE); + if(err <= n) + return 0; + /* + * The above two things tell us 1) n fits in 16 bits; 2) err/n > 1. + * These allow us later to know we won't lose too much precision in the + * fixed-point division (err< 0); + bits = FLAC__bitmath_ilog2_wide(err)+1; + if(bits > 16) { + err >>= (bits-16); + fracbits -= (bits-16); + } + rbps = (FLAC__uint32)err; + + /* Multiply by fixed-point version of ln(2), with 16 fractional bits */ + rbps *= FLAC__FP_LN2; + fracbits += 16; + FLAC__ASSERT(fracbits >= 0); + + /* FLAC__fixedpoint_log2 requires fracbits%4 to be 0 */ + { + const int f = fracbits & 3; + if(f) { + rbps >>= f; + fracbits -= f; + } + } + + rbps = FLAC__fixedpoint_log2(rbps, fracbits, (unsigned)(-1)); + + if(rbps == 0) + return 0; + + /* + * The return value must have 16 fractional bits. Since the whole part + * of the base-2 log of a 32 bit number must fit in 5 bits, and fracbits + * must be >= -3, these assertion allows us to be able to shift rbps + * left if necessary to get 16 fracbits without losing any bits of the + * whole part of rbps. + * + * There is a slight chance due to accumulated error that the whole part + * will require 6 bits, so we use 6 in the assertion. Really though as + * long as it fits in 13 bits (32 - (16 - (-3))) we are fine. + */ + FLAC__ASSERT((int)FLAC__bitmath_ilog2(rbps)+1 <= fracbits + 6); + FLAC__ASSERT(fracbits >= -3); + + /* now shift the decimal point into place */ + if(fracbits < 16) + return rbps << (16-fracbits); + else if(fracbits > 16) + return rbps >> (fracbits-16); + else + return rbps; +} +#endif + +#ifndef FLAC__INTEGER_ONLY_LIBRARY +unsigned FLAC__fixed_compute_best_predictor(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]) +#else +unsigned FLAC__fixed_compute_best_predictor(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]) +#endif +{ + FLAC__int32 last_error_0 = data[-1]; + FLAC__int32 last_error_1 = data[-1] - data[-2]; + FLAC__int32 last_error_2 = last_error_1 - (data[-2] - data[-3]); + FLAC__int32 last_error_3 = last_error_2 - (data[-2] - 2*data[-3] + data[-4]); + FLAC__int32 error, save; + FLAC__uint32 total_error_0 = 0, total_error_1 = 0, total_error_2 = 0, total_error_3 = 0, total_error_4 = 0; + unsigned i, order; + + for(i = 0; i < data_len; i++) { + error = data[i] ; total_error_0 += local_abs(error); save = error; + error -= last_error_0; total_error_1 += local_abs(error); last_error_0 = save; save = error; + error -= last_error_1; total_error_2 += local_abs(error); last_error_1 = save; save = error; + error -= last_error_2; total_error_3 += local_abs(error); last_error_2 = save; save = error; + error -= last_error_3; total_error_4 += local_abs(error); last_error_3 = save; + } + + if(total_error_0 < flac_min(flac_min(flac_min(total_error_1, total_error_2), total_error_3), total_error_4)) + order = 0; + else if(total_error_1 < flac_min(flac_min(total_error_2, total_error_3), total_error_4)) + order = 1; + else if(total_error_2 < flac_min(total_error_3, total_error_4)) + order = 2; + else if(total_error_3 < total_error_4) + order = 3; + else + order = 4; + + /* Estimate the expected number of bits per residual signal sample. */ + /* 'total_error*' is linearly related to the variance of the residual */ + /* signal, so we use it directly to compute E(|x|) */ + FLAC__ASSERT(data_len > 0 || total_error_0 == 0); + FLAC__ASSERT(data_len > 0 || total_error_1 == 0); + FLAC__ASSERT(data_len > 0 || total_error_2 == 0); + FLAC__ASSERT(data_len > 0 || total_error_3 == 0); + FLAC__ASSERT(data_len > 0 || total_error_4 == 0); +#ifndef FLAC__INTEGER_ONLY_LIBRARY + residual_bits_per_sample[0] = (float)((total_error_0 > 0) ? log(M_LN2 * (double)total_error_0 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[1] = (float)((total_error_1 > 0) ? log(M_LN2 * (double)total_error_1 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[2] = (float)((total_error_2 > 0) ? log(M_LN2 * (double)total_error_2 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[3] = (float)((total_error_3 > 0) ? log(M_LN2 * (double)total_error_3 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[4] = (float)((total_error_4 > 0) ? log(M_LN2 * (double)total_error_4 / (double)data_len) / M_LN2 : 0.0); +#else + residual_bits_per_sample[0] = (total_error_0 > 0) ? local__compute_rbps_integerized(total_error_0, data_len) : 0; + residual_bits_per_sample[1] = (total_error_1 > 0) ? local__compute_rbps_integerized(total_error_1, data_len) : 0; + residual_bits_per_sample[2] = (total_error_2 > 0) ? local__compute_rbps_integerized(total_error_2, data_len) : 0; + residual_bits_per_sample[3] = (total_error_3 > 0) ? local__compute_rbps_integerized(total_error_3, data_len) : 0; + residual_bits_per_sample[4] = (total_error_4 > 0) ? local__compute_rbps_integerized(total_error_4, data_len) : 0; +#endif + + return order; +} + +#ifndef FLAC__INTEGER_ONLY_LIBRARY +unsigned FLAC__fixed_compute_best_predictor_wide(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]) +#else +unsigned FLAC__fixed_compute_best_predictor_wide(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]) +#endif +{ + FLAC__int32 last_error_0 = data[-1]; + FLAC__int32 last_error_1 = data[-1] - data[-2]; + FLAC__int32 last_error_2 = last_error_1 - (data[-2] - data[-3]); + FLAC__int32 last_error_3 = last_error_2 - (data[-2] - 2*data[-3] + data[-4]); + FLAC__int32 error, save; + /* total_error_* are 64-bits to avoid overflow when encoding + * erratic signals when the bits-per-sample and blocksize are + * large. + */ + FLAC__uint64 total_error_0 = 0, total_error_1 = 0, total_error_2 = 0, total_error_3 = 0, total_error_4 = 0; + unsigned i, order; + + for(i = 0; i < data_len; i++) { + error = data[i] ; total_error_0 += local_abs(error); save = error; + error -= last_error_0; total_error_1 += local_abs(error); last_error_0 = save; save = error; + error -= last_error_1; total_error_2 += local_abs(error); last_error_1 = save; save = error; + error -= last_error_2; total_error_3 += local_abs(error); last_error_2 = save; save = error; + error -= last_error_3; total_error_4 += local_abs(error); last_error_3 = save; + } + + if(total_error_0 < flac_min(flac_min(flac_min(total_error_1, total_error_2), total_error_3), total_error_4)) + order = 0; + else if(total_error_1 < flac_min(flac_min(total_error_2, total_error_3), total_error_4)) + order = 1; + else if(total_error_2 < flac_min(total_error_3, total_error_4)) + order = 2; + else if(total_error_3 < total_error_4) + order = 3; + else + order = 4; + + /* Estimate the expected number of bits per residual signal sample. */ + /* 'total_error*' is linearly related to the variance of the residual */ + /* signal, so we use it directly to compute E(|x|) */ + FLAC__ASSERT(data_len > 0 || total_error_0 == 0); + FLAC__ASSERT(data_len > 0 || total_error_1 == 0); + FLAC__ASSERT(data_len > 0 || total_error_2 == 0); + FLAC__ASSERT(data_len > 0 || total_error_3 == 0); + FLAC__ASSERT(data_len > 0 || total_error_4 == 0); +#ifndef FLAC__INTEGER_ONLY_LIBRARY + residual_bits_per_sample[0] = (float)((total_error_0 > 0) ? log(M_LN2 * (double)total_error_0 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[1] = (float)((total_error_1 > 0) ? log(M_LN2 * (double)total_error_1 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[2] = (float)((total_error_2 > 0) ? log(M_LN2 * (double)total_error_2 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[3] = (float)((total_error_3 > 0) ? log(M_LN2 * (double)total_error_3 / (double)data_len) / M_LN2 : 0.0); + residual_bits_per_sample[4] = (float)((total_error_4 > 0) ? log(M_LN2 * (double)total_error_4 / (double)data_len) / M_LN2 : 0.0); +#else + residual_bits_per_sample[0] = (total_error_0 > 0) ? local__compute_rbps_wide_integerized(total_error_0, data_len) : 0; + residual_bits_per_sample[1] = (total_error_1 > 0) ? local__compute_rbps_wide_integerized(total_error_1, data_len) : 0; + residual_bits_per_sample[2] = (total_error_2 > 0) ? local__compute_rbps_wide_integerized(total_error_2, data_len) : 0; + residual_bits_per_sample[3] = (total_error_3 > 0) ? local__compute_rbps_wide_integerized(total_error_3, data_len) : 0; + residual_bits_per_sample[4] = (total_error_4 > 0) ? local__compute_rbps_wide_integerized(total_error_4, data_len) : 0; +#endif + + return order; +} + +void FLAC__fixed_compute_residual(const FLAC__int32 data[], unsigned data_len, unsigned order, FLAC__int32 residual[]) +{ + const int idata_len = (int)data_len; + int i; + + switch(order) { + case 0: + FLAC__ASSERT(sizeof(residual[0]) == sizeof(data[0])); + memcpy(residual, data, sizeof(residual[0])*data_len); + break; + case 1: + for(i = 0; i < idata_len; i++) + residual[i] = data[i] - data[i-1]; + break; + case 2: + for(i = 0; i < idata_len; i++) + residual[i] = data[i] - 2*data[i-1] + data[i-2]; + break; + case 3: + for(i = 0; i < idata_len; i++) + residual[i] = data[i] - 3*data[i-1] + 3*data[i-2] - data[i-3]; + break; + case 4: + for(i = 0; i < idata_len; i++) + residual[i] = data[i] - 4*data[i-1] + 6*data[i-2] - 4*data[i-3] + data[i-4]; + break; + default: + FLAC__ASSERT(0); + } +} + +void FLAC__fixed_restore_signal(const FLAC__int32 residual[], unsigned data_len, unsigned order, FLAC__int32 data[]) +{ + int i, idata_len = (int)data_len; + + switch(order) { + case 0: + FLAC__ASSERT(sizeof(residual[0]) == sizeof(data[0])); + memcpy(data, residual, sizeof(residual[0])*data_len); + break; + case 1: + for(i = 0; i < idata_len; i++) + data[i] = residual[i] + data[i-1]; + break; + case 2: + for(i = 0; i < idata_len; i++) + data[i] = residual[i] + 2*data[i-1] - data[i-2]; + break; + case 3: + for(i = 0; i < idata_len; i++) + data[i] = residual[i] + 3*data[i-1] - 3*data[i-2] + data[i-3]; + break; + case 4: + for(i = 0; i < idata_len; i++) + data[i] = residual[i] + 4*data[i-1] - 6*data[i-2] + 4*data[i-3] - data[i-4]; + break; + default: + FLAC__ASSERT(0); + } +} diff --git a/src/libflac/float.c b/src/libflac/float.c new file mode 100644 index 0000000..6ca449e --- /dev/null +++ b/src/libflac/float.c @@ -0,0 +1,302 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2004-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include "FLAC/assert.h" +#include "share/compat.h" +#include "private/float.h" + +#ifdef FLAC__INTEGER_ONLY_LIBRARY + +const FLAC__fixedpoint FLAC__FP_ZERO = 0; +const FLAC__fixedpoint FLAC__FP_ONE_HALF = 0x00008000; +const FLAC__fixedpoint FLAC__FP_ONE = 0x00010000; +const FLAC__fixedpoint FLAC__FP_LN2 = 45426; +const FLAC__fixedpoint FLAC__FP_E = 178145; + +/* Lookup tables for Knuth's logarithm algorithm */ +#define LOG2_LOOKUP_PRECISION 16 +static const FLAC__uint32 log2_lookup[][LOG2_LOOKUP_PRECISION] PROGMEM = { + { + /* + * 0 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00000001, + /* lg(4/3) = */ 0x00000000, + /* lg(8/7) = */ 0x00000000, + /* lg(16/15) = */ 0x00000000, + /* lg(32/31) = */ 0x00000000, + /* lg(64/63) = */ 0x00000000, + /* lg(128/127) = */ 0x00000000, + /* lg(256/255) = */ 0x00000000, + /* lg(512/511) = */ 0x00000000, + /* lg(1024/1023) = */ 0x00000000, + /* lg(2048/2047) = */ 0x00000000, + /* lg(4096/4095) = */ 0x00000000, + /* lg(8192/8191) = */ 0x00000000, + /* lg(16384/16383) = */ 0x00000000, + /* lg(32768/32767) = */ 0x00000000 + }, + { + /* + * 4 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00000010, + /* lg(4/3) = */ 0x00000007, + /* lg(8/7) = */ 0x00000003, + /* lg(16/15) = */ 0x00000001, + /* lg(32/31) = */ 0x00000001, + /* lg(64/63) = */ 0x00000000, + /* lg(128/127) = */ 0x00000000, + /* lg(256/255) = */ 0x00000000, + /* lg(512/511) = */ 0x00000000, + /* lg(1024/1023) = */ 0x00000000, + /* lg(2048/2047) = */ 0x00000000, + /* lg(4096/4095) = */ 0x00000000, + /* lg(8192/8191) = */ 0x00000000, + /* lg(16384/16383) = */ 0x00000000, + /* lg(32768/32767) = */ 0x00000000 + }, + { + /* + * 8 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00000100, + /* lg(4/3) = */ 0x0000006a, + /* lg(8/7) = */ 0x00000031, + /* lg(16/15) = */ 0x00000018, + /* lg(32/31) = */ 0x0000000c, + /* lg(64/63) = */ 0x00000006, + /* lg(128/127) = */ 0x00000003, + /* lg(256/255) = */ 0x00000001, + /* lg(512/511) = */ 0x00000001, + /* lg(1024/1023) = */ 0x00000000, + /* lg(2048/2047) = */ 0x00000000, + /* lg(4096/4095) = */ 0x00000000, + /* lg(8192/8191) = */ 0x00000000, + /* lg(16384/16383) = */ 0x00000000, + /* lg(32768/32767) = */ 0x00000000 + }, + { + /* + * 12 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00001000, + /* lg(4/3) = */ 0x000006a4, + /* lg(8/7) = */ 0x00000315, + /* lg(16/15) = */ 0x0000017d, + /* lg(32/31) = */ 0x000000bc, + /* lg(64/63) = */ 0x0000005d, + /* lg(128/127) = */ 0x0000002e, + /* lg(256/255) = */ 0x00000017, + /* lg(512/511) = */ 0x0000000c, + /* lg(1024/1023) = */ 0x00000006, + /* lg(2048/2047) = */ 0x00000003, + /* lg(4096/4095) = */ 0x00000001, + /* lg(8192/8191) = */ 0x00000001, + /* lg(16384/16383) = */ 0x00000000, + /* lg(32768/32767) = */ 0x00000000 + }, + { + /* + * 16 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00010000, + /* lg(4/3) = */ 0x00006a40, + /* lg(8/7) = */ 0x00003151, + /* lg(16/15) = */ 0x000017d6, + /* lg(32/31) = */ 0x00000bba, + /* lg(64/63) = */ 0x000005d1, + /* lg(128/127) = */ 0x000002e6, + /* lg(256/255) = */ 0x00000172, + /* lg(512/511) = */ 0x000000b9, + /* lg(1024/1023) = */ 0x0000005c, + /* lg(2048/2047) = */ 0x0000002e, + /* lg(4096/4095) = */ 0x00000017, + /* lg(8192/8191) = */ 0x0000000c, + /* lg(16384/16383) = */ 0x00000006, + /* lg(32768/32767) = */ 0x00000003 + }, + { + /* + * 20 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x00100000, + /* lg(4/3) = */ 0x0006a3fe, + /* lg(8/7) = */ 0x00031513, + /* lg(16/15) = */ 0x00017d60, + /* lg(32/31) = */ 0x0000bb9d, + /* lg(64/63) = */ 0x00005d10, + /* lg(128/127) = */ 0x00002e59, + /* lg(256/255) = */ 0x00001721, + /* lg(512/511) = */ 0x00000b8e, + /* lg(1024/1023) = */ 0x000005c6, + /* lg(2048/2047) = */ 0x000002e3, + /* lg(4096/4095) = */ 0x00000171, + /* lg(8192/8191) = */ 0x000000b9, + /* lg(16384/16383) = */ 0x0000005c, + /* lg(32768/32767) = */ 0x0000002e + }, + { + /* + * 24 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x01000000, + /* lg(4/3) = */ 0x006a3fe6, + /* lg(8/7) = */ 0x00315130, + /* lg(16/15) = */ 0x0017d605, + /* lg(32/31) = */ 0x000bb9ca, + /* lg(64/63) = */ 0x0005d0fc, + /* lg(128/127) = */ 0x0002e58f, + /* lg(256/255) = */ 0x0001720e, + /* lg(512/511) = */ 0x0000b8d8, + /* lg(1024/1023) = */ 0x00005c61, + /* lg(2048/2047) = */ 0x00002e2d, + /* lg(4096/4095) = */ 0x00001716, + /* lg(8192/8191) = */ 0x00000b8b, + /* lg(16384/16383) = */ 0x000005c5, + /* lg(32768/32767) = */ 0x000002e3 + }, + { + /* + * 28 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ 0x10000000, + /* lg(4/3) = */ 0x06a3fe5c, + /* lg(8/7) = */ 0x03151301, + /* lg(16/15) = */ 0x017d6049, + /* lg(32/31) = */ 0x00bb9ca6, + /* lg(64/63) = */ 0x005d0fba, + /* lg(128/127) = */ 0x002e58f7, + /* lg(256/255) = */ 0x001720da, + /* lg(512/511) = */ 0x000b8d87, + /* lg(1024/1023) = */ 0x0005c60b, + /* lg(2048/2047) = */ 0x0002e2d7, + /* lg(4096/4095) = */ 0x00017160, + /* lg(8192/8191) = */ 0x0000b8ad, + /* lg(16384/16383) = */ 0x00005c56, + /* lg(32768/32767) = */ 0x00002e2b + } +}; + +#if 0 +static const FLAC__uint64 log2_lookup_wide[] = { + { + /* + * 32 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ FLAC__U64L(0x100000000), + /* lg(4/3) = */ FLAC__U64L(0x6a3fe5c6), + /* lg(8/7) = */ FLAC__U64L(0x31513015), + /* lg(16/15) = */ FLAC__U64L(0x17d60497), + /* lg(32/31) = */ FLAC__U64L(0x0bb9ca65), + /* lg(64/63) = */ FLAC__U64L(0x05d0fba2), + /* lg(128/127) = */ FLAC__U64L(0x02e58f74), + /* lg(256/255) = */ FLAC__U64L(0x01720d9c), + /* lg(512/511) = */ FLAC__U64L(0x00b8d875), + /* lg(1024/1023) = */ FLAC__U64L(0x005c60aa), + /* lg(2048/2047) = */ FLAC__U64L(0x002e2d72), + /* lg(4096/4095) = */ FLAC__U64L(0x00171600), + /* lg(8192/8191) = */ FLAC__U64L(0x000b8ad2), + /* lg(16384/16383) = */ FLAC__U64L(0x0005c55d), + /* lg(32768/32767) = */ FLAC__U64L(0x0002e2ac) + }, + { + /* + * 48 fraction bits + */ + /* undefined */ 0x00000000, + /* lg(2/1) = */ FLAC__U64L(0x1000000000000), + /* lg(4/3) = */ FLAC__U64L(0x6a3fe5c60429), + /* lg(8/7) = */ FLAC__U64L(0x315130157f7a), + /* lg(16/15) = */ FLAC__U64L(0x17d60496cfbb), + /* lg(32/31) = */ FLAC__U64L(0xbb9ca64ecac), + /* lg(64/63) = */ FLAC__U64L(0x5d0fba187cd), + /* lg(128/127) = */ FLAC__U64L(0x2e58f7441ee), + /* lg(256/255) = */ FLAC__U64L(0x1720d9c06a8), + /* lg(512/511) = */ FLAC__U64L(0xb8d8752173), + /* lg(1024/1023) = */ FLAC__U64L(0x5c60aa252e), + /* lg(2048/2047) = */ FLAC__U64L(0x2e2d71b0d8), + /* lg(4096/4095) = */ FLAC__U64L(0x1716001719), + /* lg(8192/8191) = */ FLAC__U64L(0xb8ad1de1b), + /* lg(16384/16383) = */ FLAC__U64L(0x5c55d640d), + /* lg(32768/32767) = */ FLAC__U64L(0x2e2abcf52) + } +}; +#endif + +FLAC__uint32 FLAC__fixedpoint_log2(FLAC__uint32 x, unsigned fracbits, unsigned precision) +{ + const FLAC__uint32 ONE = (1u << fracbits); + const FLAC__uint32 *table = log2_lookup[fracbits >> 2]; + + FLAC__ASSERT(fracbits < 32); + FLAC__ASSERT((fracbits & 0x3) == 0); + + if(x < ONE) + return 0; + + if(precision > LOG2_LOOKUP_PRECISION) + precision = LOG2_LOOKUP_PRECISION; + + /* Knuth's algorithm for computing logarithms, optimized for base-2 with lookup tables */ + { + FLAC__uint32 y = 0; + FLAC__uint32 z = x >> 1, k = 1; + while (x > ONE && k < precision) { + if (x - z >= ONE) { + x -= z; + z = x >> k; + y += table[k]; + } + else { + z >>= 1; + k++; + } + } + return y; + } +} + +#endif /* defined FLAC__INTEGER_ONLY_LIBRARY */ diff --git a/src/libflac/format.c b/src/libflac/format.c new file mode 100644 index 0000000..3eaf92e --- /dev/null +++ b/src/libflac/format.c @@ -0,0 +1,589 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include /* for qsort() */ +#include /* for memset() */ +#include "FLAC/assert.h" +#include "FLAC/format.h" +#include "share/alloc.h" +#include "share/compat.h" +#include "private/format.h" +#include "private/macros.h" + +/* PACKAGE_VERSION should come from configure */ +FLAC_API const char *FLAC__VERSION_STRING = PACKAGE_VERSION; + +FLAC_API const char *FLAC__VENDOR_STRING = "reference libFLAC " PACKAGE_VERSION " 20170101"; + +FLAC_API const FLAC__byte FLAC__STREAM_SYNC_STRING[4] = { 'f','L','a','C' }; +FLAC_API const unsigned FLAC__STREAM_SYNC = 0x664C6143; +FLAC_API const unsigned FLAC__STREAM_SYNC_LEN = 32; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN = 16; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN = 16; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN = 24; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN = 24; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN = 20; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN = 3; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN = 5; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN = 36; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_STREAMINFO_MD5SUM_LEN = 128; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_APPLICATION_ID_LEN = 32; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_SAMPLE_NUMBER_LEN = 64; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_STREAM_OFFSET_LEN = 64; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_SEEKPOINT_FRAME_SAMPLES_LEN = 16; /* bits */ + +FLAC_API const FLAC__uint64 FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER = FLAC__U64L(0xffffffffffffffff); + +FLAC_API const unsigned FLAC__STREAM_METADATA_VORBIS_COMMENT_ENTRY_LENGTH_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_VORBIS_COMMENT_NUM_COMMENTS_LEN = 32; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_OFFSET_LEN = 64; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_NUMBER_LEN = 8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_INDEX_RESERVED_LEN = 3*8; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_OFFSET_LEN = 64; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_NUMBER_LEN = 8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_ISRC_LEN = 12*8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_TYPE_LEN = 1; /* bit */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_PRE_EMPHASIS_LEN = 1; /* bit */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_RESERVED_LEN = 6+13*8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_TRACK_NUM_INDICES_LEN = 8; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_MEDIA_CATALOG_NUMBER_LEN = 128*8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_LEAD_IN_LEN = 64; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_IS_CD_LEN = 1; /* bit */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_RESERVED_LEN = 7+258*8; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_CUESHEET_NUM_TRACKS_LEN = 8; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_TYPE_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_MIME_TYPE_LENGTH_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DESCRIPTION_LENGTH_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_WIDTH_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_HEIGHT_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DEPTH_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_COLORS_LEN = 32; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_PICTURE_DATA_LENGTH_LEN = 32; /* bits */ + +FLAC_API const unsigned FLAC__STREAM_METADATA_IS_LAST_LEN = 1; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_TYPE_LEN = 7; /* bits */ +FLAC_API const unsigned FLAC__STREAM_METADATA_LENGTH_LEN = 24; /* bits */ + +FLAC_API const unsigned FLAC__FRAME_HEADER_SYNC = 0x3ffe; +FLAC_API const unsigned FLAC__FRAME_HEADER_SYNC_LEN = 14; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_RESERVED_LEN = 1; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_BLOCKING_STRATEGY_LEN = 1; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_BLOCK_SIZE_LEN = 4; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_SAMPLE_RATE_LEN = 4; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_CHANNEL_ASSIGNMENT_LEN = 4; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_BITS_PER_SAMPLE_LEN = 3; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_ZERO_PAD_LEN = 1; /* bits */ +FLAC_API const unsigned FLAC__FRAME_HEADER_CRC_LEN = 8; /* bits */ + +FLAC_API const unsigned FLAC__FRAME_FOOTER_CRC_LEN = 16; /* bits */ + +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_TYPE_LEN = 2; /* bits */ +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN = 4; /* bits */ +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN = 4; /* bits */ +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2_PARAMETER_LEN = 5; /* bits */ +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_RAW_LEN = 5; /* bits */ + +FLAC_API const unsigned FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER = 15; /* == (1< FLAC__MAX_SAMPLE_RATE) { + return false; + } + else + return true; +} + +FLAC_API FLAC__bool FLAC__format_blocksize_is_subset(unsigned blocksize, unsigned sample_rate) +{ + if(blocksize > 16384) + return false; + else if(sample_rate <= 48000 && blocksize > 4608) + return false; + else + return true; +} + +FLAC_API FLAC__bool FLAC__format_sample_rate_is_subset(unsigned sample_rate) +{ + if( + !FLAC__format_sample_rate_is_valid(sample_rate) || + ( + sample_rate >= (1u << 16) && + !(sample_rate % 1000 == 0 || sample_rate % 10 == 0) + ) + ) { + return false; + } + else + return true; +} + +/* @@@@ add to unit tests; it is already indirectly tested by the metadata_object tests */ +FLAC_API FLAC__bool FLAC__format_seektable_is_legal(const FLAC__StreamMetadata_SeekTable *seek_table) +{ + unsigned i; + FLAC__uint64 prev_sample_number = 0; + FLAC__bool got_prev = false; + + FLAC__ASSERT(0 != seek_table); + + for(i = 0; i < seek_table->num_points; i++) { + if(got_prev) { + if( + seek_table->points[i].sample_number != FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER && + seek_table->points[i].sample_number <= prev_sample_number + ) + return false; + } + prev_sample_number = seek_table->points[i].sample_number; + got_prev = true; + } + + return true; +} + +/* used as the sort predicate for qsort() */ +static int seekpoint_compare_(const FLAC__StreamMetadata_SeekPoint *l, const FLAC__StreamMetadata_SeekPoint *r) +{ + /* we don't just 'return l->sample_number - r->sample_number' since the result (FLAC__int64) might overflow an 'int' */ + if(l->sample_number == r->sample_number) + return 0; + else if(l->sample_number < r->sample_number) + return -1; + else + return 1; +} + +/* @@@@ add to unit tests; it is already indirectly tested by the metadata_object tests */ +FLAC_API unsigned FLAC__format_seektable_sort(FLAC__StreamMetadata_SeekTable *seek_table) +{ + unsigned i, j; + FLAC__bool first; + + FLAC__ASSERT(0 != seek_table); + + if (seek_table->num_points == 0) + return 0; + + /* sort the seekpoints */ + qsort(seek_table->points, seek_table->num_points, sizeof(FLAC__StreamMetadata_SeekPoint), (int (*)(const void *, const void *))seekpoint_compare_); + + /* uniquify the seekpoints */ + first = true; + for(i = j = 0; i < seek_table->num_points; i++) { + if(seek_table->points[i].sample_number != FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER) { + if(!first) { + if(seek_table->points[i].sample_number == seek_table->points[j-1].sample_number) + continue; + } + } + first = false; + seek_table->points[j++] = seek_table->points[i]; + } + + for(i = j; i < seek_table->num_points; i++) { + seek_table->points[i].sample_number = FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER; + seek_table->points[i].stream_offset = 0; + seek_table->points[i].frame_samples = 0; + } + + return j; +} + +/* + * also disallows non-shortest-form encodings, c.f. + * http://www.unicode.org/versions/corrigendum1.html + * and a more clear explanation at the end of this section: + * http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8 + */ +static unsigned utf8len_(const FLAC__byte *utf8) +{ + FLAC__ASSERT(0 != utf8); + if ((utf8[0] & 0x80) == 0) { + return 1; + } + else if ((utf8[0] & 0xE0) == 0xC0 && (utf8[1] & 0xC0) == 0x80) { + if ((utf8[0] & 0xFE) == 0xC0) /* overlong sequence check */ + return 0; + return 2; + } + else if ((utf8[0] & 0xF0) == 0xE0 && (utf8[1] & 0xC0) == 0x80 && (utf8[2] & 0xC0) == 0x80) { + if (utf8[0] == 0xE0 && (utf8[1] & 0xE0) == 0x80) /* overlong sequence check */ + return 0; + /* illegal surrogates check (U+D800...U+DFFF and U+FFFE...U+FFFF) */ + if (utf8[0] == 0xED && (utf8[1] & 0xE0) == 0xA0) /* D800-DFFF */ + return 0; + if (utf8[0] == 0xEF && utf8[1] == 0xBF && (utf8[2] & 0xFE) == 0xBE) /* FFFE-FFFF */ + return 0; + return 3; + } + else if ((utf8[0] & 0xF8) == 0xF0 && (utf8[1] & 0xC0) == 0x80 && (utf8[2] & 0xC0) == 0x80 && (utf8[3] & 0xC0) == 0x80) { + if (utf8[0] == 0xF0 && (utf8[1] & 0xF0) == 0x80) /* overlong sequence check */ + return 0; + return 4; + } + else if ((utf8[0] & 0xFC) == 0xF8 && (utf8[1] & 0xC0) == 0x80 && (utf8[2] & 0xC0) == 0x80 && (utf8[3] & 0xC0) == 0x80 && (utf8[4] & 0xC0) == 0x80) { + if (utf8[0] == 0xF8 && (utf8[1] & 0xF8) == 0x80) /* overlong sequence check */ + return 0; + return 5; + } + else if ((utf8[0] & 0xFE) == 0xFC && (utf8[1] & 0xC0) == 0x80 && (utf8[2] & 0xC0) == 0x80 && (utf8[3] & 0xC0) == 0x80 && (utf8[4] & 0xC0) == 0x80 && (utf8[5] & 0xC0) == 0x80) { + if (utf8[0] == 0xFC && (utf8[1] & 0xFC) == 0x80) /* overlong sequence check */ + return 0; + return 6; + } + else { + return 0; + } +} + +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_name_is_legal(const char *name) +{ + char c; + for(c = *name; c; c = *(++name)) + if(c < 0x20 || c == 0x3d || c > 0x7d) + return false; + return true; +} + +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_value_is_legal(const FLAC__byte *value, unsigned length) +{ + if(length == (unsigned)(-1)) { + while(*value) { + unsigned n = utf8len_(value); + if(n == 0) + return false; + value += n; + } + } + else { + const FLAC__byte *end = value + length; + while(value < end) { + unsigned n = utf8len_(value); + if(n == 0) + return false; + value += n; + } + if(value != end) + return false; + } + return true; +} + +FLAC_API FLAC__bool FLAC__format_vorbiscomment_entry_is_legal(const FLAC__byte *entry, unsigned length) +{ + const FLAC__byte *s, *end; + + for(s = entry, end = s + length; s < end && *s != '='; s++) { + if(*s < 0x20 || *s > 0x7D) + return false; + } + if(s == end) + return false; + + s++; /* skip '=' */ + + while(s < end) { + unsigned n = utf8len_(s); + if(n == 0) + return false; + s += n; + } + if(s != end) + return false; + + return true; +} + +/* @@@@ add to unit tests; it is already indirectly tested by the metadata_object tests */ +FLAC_API FLAC__bool FLAC__format_cuesheet_is_legal(const FLAC__StreamMetadata_CueSheet *cue_sheet, FLAC__bool check_cd_da_subset, const char **violation) +{ + unsigned i, j; + + if(check_cd_da_subset) { + if(cue_sheet->lead_in < 2 * 44100) { + if(violation) *violation = "CD-DA cue sheet must have a lead-in length of at least 2 seconds"; + return false; + } + if(cue_sheet->lead_in % 588 != 0) { + if(violation) *violation = "CD-DA cue sheet lead-in length must be evenly divisible by 588 samples"; + return false; + } + } + + if(cue_sheet->num_tracks == 0) { + if(violation) *violation = "cue sheet must have at least one track (the lead-out)"; + return false; + } + + if(check_cd_da_subset && cue_sheet->tracks[cue_sheet->num_tracks-1].number != 170) { + if(violation) *violation = "CD-DA cue sheet must have a lead-out track number 170 (0xAA)"; + return false; + } + + for(i = 0; i < cue_sheet->num_tracks; i++) { + if(cue_sheet->tracks[i].number == 0) { + if(violation) *violation = "cue sheet may not have a track number 0"; + return false; + } + + if(check_cd_da_subset) { + if(!((cue_sheet->tracks[i].number >= 1 && cue_sheet->tracks[i].number <= 99) || cue_sheet->tracks[i].number == 170)) { + if(violation) *violation = "CD-DA cue sheet track number must be 1-99 or 170"; + return false; + } + } + + if(check_cd_da_subset && cue_sheet->tracks[i].offset % 588 != 0) { + if(violation) { + if(i == cue_sheet->num_tracks-1) /* the lead-out track... */ + *violation = "CD-DA cue sheet lead-out offset must be evenly divisible by 588 samples"; + else + *violation = "CD-DA cue sheet track offset must be evenly divisible by 588 samples"; + } + return false; + } + + if(i < cue_sheet->num_tracks - 1) { + if(cue_sheet->tracks[i].num_indices == 0) { + if(violation) *violation = "cue sheet track must have at least one index point"; + return false; + } + + if(cue_sheet->tracks[i].indices[0].number > 1) { + if(violation) *violation = "cue sheet track's first index number must be 0 or 1"; + return false; + } + } + + for(j = 0; j < cue_sheet->tracks[i].num_indices; j++) { + if(check_cd_da_subset && cue_sheet->tracks[i].indices[j].offset % 588 != 0) { + if(violation) *violation = "CD-DA cue sheet track index offset must be evenly divisible by 588 samples"; + return false; + } + + if(j > 0) { + if(cue_sheet->tracks[i].indices[j].number != cue_sheet->tracks[i].indices[j-1].number + 1) { + if(violation) *violation = "cue sheet track index numbers must increase by 1"; + return false; + } + } + } + } + + return true; +} + +/* @@@@ add to unit tests; it is already indirectly tested by the metadata_object tests */ +FLAC_API FLAC__bool FLAC__format_picture_is_legal(const FLAC__StreamMetadata_Picture *picture, const char **violation) +{ + char *p; + FLAC__byte *b; + + for(p = picture->mime_type; *p; p++) { + if(*p < 0x20 || *p > 0x7e) { + if(violation) *violation = "MIME type string must contain only printable ASCII characters (0x20-0x7e)"; + return false; + } + } + + for(b = picture->description; *b; ) { + unsigned n = utf8len_(b); + if(n == 0) { + if(violation) *violation = "description string must be valid UTF-8"; + return false; + } + b += n; + } + + return true; +} + +/* + * These routines are private to libFLAC + */ +unsigned FLAC__format_get_max_rice_partition_order(unsigned blocksize, unsigned predictor_order) +{ + return + FLAC__format_get_max_rice_partition_order_from_blocksize_limited_max_and_predictor_order( + FLAC__format_get_max_rice_partition_order_from_blocksize(blocksize), + blocksize, + predictor_order + ); +} + +unsigned FLAC__format_get_max_rice_partition_order_from_blocksize(unsigned blocksize) +{ + unsigned max_rice_partition_order = 0; + while(!(blocksize & 1)) { + max_rice_partition_order++; + blocksize >>= 1; + } + return flac_min(FLAC__MAX_RICE_PARTITION_ORDER, max_rice_partition_order); +} + +unsigned FLAC__format_get_max_rice_partition_order_from_blocksize_limited_max_and_predictor_order(unsigned limit, unsigned blocksize, unsigned predictor_order) +{ + unsigned max_rice_partition_order = limit; + + while(max_rice_partition_order > 0 && (blocksize >> max_rice_partition_order) <= predictor_order) + max_rice_partition_order--; + + FLAC__ASSERT( + (max_rice_partition_order == 0 && blocksize >= predictor_order) || + (max_rice_partition_order > 0 && blocksize >> max_rice_partition_order > predictor_order) + ); + + return max_rice_partition_order; +} + +void FLAC__format_entropy_coding_method_partitioned_rice_contents_init(FLAC__EntropyCodingMethod_PartitionedRiceContents *object) +{ + FLAC__ASSERT(0 != object); + + object->parameters = 0; + object->raw_bits = 0; + object->capacity_by_order = 0; +} + +void FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(FLAC__EntropyCodingMethod_PartitionedRiceContents *object) +{ + FLAC__ASSERT(0 != object); + + if(0 != object->parameters) + free(object->parameters); + if(0 != object->raw_bits) + free(object->raw_bits); + FLAC__format_entropy_coding_method_partitioned_rice_contents_init(object); +} + +FLAC__bool FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(FLAC__EntropyCodingMethod_PartitionedRiceContents *object, unsigned max_partition_order) +{ + FLAC__ASSERT(0 != object); + + FLAC__ASSERT(object->capacity_by_order > 0 || (0 == object->parameters && 0 == object->raw_bits)); + + if(object->capacity_by_order < max_partition_order) { + if(0 == (object->parameters = safe_realloc_(object->parameters, sizeof(unsigned)*(1 << max_partition_order)))) + return false; + if(0 == (object->raw_bits = safe_realloc_(object->raw_bits, sizeof(unsigned)*(1 << max_partition_order)))) + return false; + memset(object->raw_bits, 0, sizeof(unsigned)*(1 << max_partition_order)); + object->capacity_by_order = max_partition_order; + } + + return true; +} diff --git a/src/libflac/lpc.c b/src/libflac/lpc.c new file mode 100644 index 0000000..45376fb --- /dev/null +++ b/src/libflac/lpc.c @@ -0,0 +1,1357 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include + +#include "FLAC/assert.h" +#include "FLAC/format.h" +#include "share/compat.h" +#include "private/bitmath.h" +#include "private/lpc.h" +#include "private/macros.h" +#if defined DEBUG || defined FLAC__OVERFLOW_DETECT || defined FLAC__OVERFLOW_DETECT_VERBOSE +#include +#endif + +/* OPT: #undef'ing this may improve the speed on some architectures */ +#define FLAC__LPC_UNROLLED_FILTER_LOOPS + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +#if defined(_MSC_VER) && (_MSC_VER < 1800) +#include +static inline long int lround(double x) { + return (long)(x + _copysign(0.5, x)); +} +#elif !defined(HAVE_LROUND) && defined(__GNUC__) +static inline long int lround(double x) { + return (long)(x + __builtin_copysign(0.5, x)); +} +/* If this fails, we are in the presence of a mid 90's compiler, move along... */ +#endif + +void FLAC__lpc_window_data(const FLAC__int32 in[], const FLAC__real window[], FLAC__real out[], unsigned data_len) +{ + unsigned i; + for(i = 0; i < data_len; i++) + out[i] = in[i] * window[i]; +} + +void FLAC__lpc_compute_autocorrelation(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]) +{ + /* a readable, but slower, version */ +#if 0 + FLAC__real d; + unsigned i; + + FLAC__ASSERT(lag > 0); + FLAC__ASSERT(lag <= data_len); + + /* + * Technically we should subtract the mean first like so: + * for(i = 0; i < data_len; i++) + * data[i] -= mean; + * but it appears not to make enough of a difference to matter, and + * most signals are already closely centered around zero + */ + while(lag--) { + for(i = lag, d = 0.0; i < data_len; i++) + d += data[i] * data[i - lag]; + autoc[lag] = d; + } +#endif + + /* + * this version tends to run faster because of better data locality + * ('data_len' is usually much larger than 'lag') + */ + FLAC__real d; + unsigned sample, coeff; + const unsigned limit = data_len - lag; + + FLAC__ASSERT(lag > 0); + FLAC__ASSERT(lag <= data_len); + + for(coeff = 0; coeff < lag; coeff++) + autoc[coeff] = 0.0; + for(sample = 0; sample <= limit; sample++) { + d = data[sample]; + for(coeff = 0; coeff < lag; coeff++) + autoc[coeff] += d * data[sample+coeff]; + } + for(; sample < data_len; sample++) { + d = data[sample]; + for(coeff = 0; coeff < data_len - sample; coeff++) + autoc[coeff] += d * data[sample+coeff]; + } +} + +void FLAC__lpc_compute_lp_coefficients(const FLAC__real autoc[], unsigned *max_order, FLAC__real lp_coeff[][FLAC__MAX_LPC_ORDER], double error[]) +{ + unsigned i, j; + double r, err, lpc[FLAC__MAX_LPC_ORDER]; + + FLAC__ASSERT(0 != max_order); + FLAC__ASSERT(0 < *max_order); + FLAC__ASSERT(*max_order <= FLAC__MAX_LPC_ORDER); + FLAC__ASSERT(autoc[0] != 0.0); + + err = autoc[0]; + + for(i = 0; i < *max_order; i++) { + /* Sum up this iteration's reflection coefficient. */ + r = -autoc[i+1]; + for(j = 0; j < i; j++) + r -= lpc[j] * autoc[i-j]; + r /= err; + + /* Update LPC coefficients and total error. */ + lpc[i]=r; + for(j = 0; j < (i>>1); j++) { + double tmp = lpc[j]; + lpc[j] += r * lpc[i-1-j]; + lpc[i-1-j] += r * tmp; + } + if(i & 1) + lpc[j] += lpc[j] * r; + + err *= (1.0 - r * r); + + /* save this order */ + for(j = 0; j <= i; j++) + lp_coeff[i][j] = (FLAC__real)(-lpc[j]); /* negate FIR filter coeff to get predictor coeff */ + error[i] = err; + + /* see SF bug https://sourceforge.net/p/flac/bugs/234/ */ + if(err == 0.0) { + *max_order = i+1; + return; + } + } +} + +int FLAC__lpc_quantize_coefficients(const FLAC__real lp_coeff[], unsigned order, unsigned precision, FLAC__int32 qlp_coeff[], int *shift) +{ + unsigned i; + double cmax; + FLAC__int32 qmax, qmin; + + FLAC__ASSERT(precision > 0); + FLAC__ASSERT(precision >= FLAC__MIN_QLP_COEFF_PRECISION); + + /* drop one bit for the sign; from here on out we consider only |lp_coeff[i]| */ + precision--; + qmax = 1 << precision; + qmin = -qmax; + qmax--; + + /* calc cmax = max( |lp_coeff[i]| ) */ + cmax = 0.0; + for(i = 0; i < order; i++) { + const double d = fabs(lp_coeff[i]); + if(d > cmax) + cmax = d; + } + + if(cmax <= 0.0) { + /* => coefficients are all 0, which means our constant-detect didn't work */ + return 2; + } + else { + const int max_shiftlimit = (1 << (FLAC__SUBFRAME_LPC_QLP_SHIFT_LEN-1)) - 1; + const int min_shiftlimit = -max_shiftlimit - 1; + int log2cmax; + + (void)frexp(cmax, &log2cmax); + log2cmax--; + *shift = (int)precision - log2cmax - 1; + + if(*shift > max_shiftlimit) + *shift = max_shiftlimit; + else if(*shift < min_shiftlimit) + return 1; + } + + if(*shift >= 0) { + double error = 0.0; + FLAC__int32 q; + for(i = 0; i < order; i++) { + error += lp_coeff[i] * (1 << *shift); + q = lround(error); + +#ifdef FLAC__OVERFLOW_DETECT + if(q > qmax+1) /* we expect q==qmax+1 occasionally due to rounding */ + fprintf(stderr,"FLAC__lpc_quantize_coefficients: quantizer overflow: q>qmax %d>%d shift=%d cmax=%f precision=%u lpc[%u]=%f\n",q,qmax,*shift,cmax,precision+1,i,lp_coeff[i]); + else if(q < qmin) + fprintf(stderr,"FLAC__lpc_quantize_coefficients: quantizer overflow: q qmax) + q = qmax; + else if(q < qmin) + q = qmin; + error -= q; + qlp_coeff[i] = q; + } + } + /* negative shift is very rare but due to design flaw, negative shift is + * not allowed in the decoder, so it must be handled specially by scaling + * down coeffs + */ + else { + const int nshift = -(*shift); + double error = 0.0; + FLAC__int32 q; +#ifdef DEBUG + fprintf(stderr,"FLAC__lpc_quantize_coefficients: negative shift=%d order=%u cmax=%f\n", *shift, order, cmax); +#endif + for(i = 0; i < order; i++) { + error += lp_coeff[i] / (1 << nshift); + q = lround(error); +#ifdef FLAC__OVERFLOW_DETECT + if(q > qmax+1) /* we expect q==qmax+1 occasionally due to rounding */ + fprintf(stderr,"FLAC__lpc_quantize_coefficients: quantizer overflow: q>qmax %d>%d shift=%d cmax=%f precision=%u lpc[%u]=%f\n",q,qmax,*shift,cmax,precision+1,i,lp_coeff[i]); + else if(q < qmin) + fprintf(stderr,"FLAC__lpc_quantize_coefficients: quantizer overflow: q qmax) + q = qmax; + else if(q < qmin) + q = qmin; + error -= q; + qlp_coeff[i] = q; + } + *shift = 0; + } + + return 0; +} + +#if defined(_MSC_VER) +// silence MSVC warnings about __restrict modifier +#pragma warning ( disable : 4028 ) +#endif + +void FLAC__lpc_compute_residual_from_qlp_coefficients(const FLAC__int32 * flac_restrict data, unsigned data_len, const FLAC__int32 * flac_restrict qlp_coeff, unsigned order, int lp_quantization, FLAC__int32 * flac_restrict residual) +#if defined(FLAC__OVERFLOW_DETECT) || !defined(FLAC__LPC_UNROLLED_FILTER_LOOPS) +{ + FLAC__int64 sumo; + unsigned i, j; + FLAC__int32 sum; + const FLAC__int32 *history; + +#ifdef FLAC__OVERFLOW_DETECT_VERBOSE + fprintf(stderr,"FLAC__lpc_compute_residual_from_qlp_coefficients: data_len=%d, order=%u, lpq=%d",data_len,order,lp_quantization); + for(i=0;i 0); + + for(i = 0; i < data_len; i++) { + sumo = 0; + sum = 0; + history = data; + for(j = 0; j < order; j++) { + sum += qlp_coeff[j] * (*(--history)); + sumo += (FLAC__int64)qlp_coeff[j] * (FLAC__int64)(*history); + if(sumo > 2147483647ll || sumo < -2147483648ll) + fprintf(stderr,"FLAC__lpc_compute_residual_from_qlp_coefficients: OVERFLOW, i=%u, j=%u, c=%d, d=%d, sumo=%" PRId64 "\n",i,j,qlp_coeff[j],*history,sumo); + } + *(residual++) = *(data++) - (sum >> lp_quantization); + } + + /* Here's a slower but clearer version: + for(i = 0; i < data_len; i++) { + sum = 0; + for(j = 0; j < order; j++) + sum += qlp_coeff[j] * data[i-j-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + */ +} +#else /* fully unrolled version for normal use */ +{ + int i; + FLAC__int32 sum; + + FLAC__ASSERT(order > 0); + FLAC__ASSERT(order <= 32); + + /* + * We do unique versions up to 12th order since that's the subset limit. + * Also they are roughly ordered to match frequency of occurrence to + * minimize branching. + */ + if(order <= 12) { + if(order > 8) { + if(order > 10) { + if(order == 12) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[11] * data[i-12]; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 11 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + } + else { + if(order == 10) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 9 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + } + } + else if(order > 4) { + if(order > 6) { + if(order == 8) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 7 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + } + else { + if(order == 6) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 5 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + } + } + else { + if(order > 2) { + if(order == 4) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 3 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + } + else { + if(order == 2) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + residual[i] = data[i] - (sum >> lp_quantization); + } + } + else { /* order == 1 */ + for(i = 0; i < (int)data_len; i++) + residual[i] = data[i] - ((qlp_coeff[0] * data[i-1]) >> lp_quantization); + } + } + } + } + else { /* order > 12 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + switch(order) { + case 32: sum += qlp_coeff[31] * data[i-32]; + case 31: sum += qlp_coeff[30] * data[i-31]; + case 30: sum += qlp_coeff[29] * data[i-30]; + case 29: sum += qlp_coeff[28] * data[i-29]; + case 28: sum += qlp_coeff[27] * data[i-28]; + case 27: sum += qlp_coeff[26] * data[i-27]; + case 26: sum += qlp_coeff[25] * data[i-26]; + case 25: sum += qlp_coeff[24] * data[i-25]; + case 24: sum += qlp_coeff[23] * data[i-24]; + case 23: sum += qlp_coeff[22] * data[i-23]; + case 22: sum += qlp_coeff[21] * data[i-22]; + case 21: sum += qlp_coeff[20] * data[i-21]; + case 20: sum += qlp_coeff[19] * data[i-20]; + case 19: sum += qlp_coeff[18] * data[i-19]; + case 18: sum += qlp_coeff[17] * data[i-18]; + case 17: sum += qlp_coeff[16] * data[i-17]; + case 16: sum += qlp_coeff[15] * data[i-16]; + case 15: sum += qlp_coeff[14] * data[i-15]; + case 14: sum += qlp_coeff[13] * data[i-14]; + case 13: sum += qlp_coeff[12] * data[i-13]; + sum += qlp_coeff[11] * data[i-12]; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[ 9] * data[i-10]; + sum += qlp_coeff[ 8] * data[i- 9]; + sum += qlp_coeff[ 7] * data[i- 8]; + sum += qlp_coeff[ 6] * data[i- 7]; + sum += qlp_coeff[ 5] * data[i- 6]; + sum += qlp_coeff[ 4] * data[i- 5]; + sum += qlp_coeff[ 3] * data[i- 4]; + sum += qlp_coeff[ 2] * data[i- 3]; + sum += qlp_coeff[ 1] * data[i- 2]; + sum += qlp_coeff[ 0] * data[i- 1]; + } + residual[i] = data[i] - (sum >> lp_quantization); + } + } +} +#endif + +void FLAC__lpc_compute_residual_from_qlp_coefficients_wide(const FLAC__int32 * flac_restrict data, unsigned data_len, const FLAC__int32 * flac_restrict qlp_coeff, unsigned order, int lp_quantization, FLAC__int32 * flac_restrict residual) +#if defined(FLAC__OVERFLOW_DETECT) || !defined(FLAC__LPC_UNROLLED_FILTER_LOOPS) +{ + unsigned i, j; + FLAC__int64 sum; + const FLAC__int32 *history; + +#ifdef FLAC__OVERFLOW_DETECT_VERBOSE + fprintf(stderr,"FLAC__lpc_compute_residual_from_qlp_coefficients_wide: data_len=%d, order=%u, lpq=%d",data_len,order,lp_quantization); + for(i=0;i 0); + + for(i = 0; i < data_len; i++) { + sum = 0; + history = data; + for(j = 0; j < order; j++) + sum += (FLAC__int64)qlp_coeff[j] * (FLAC__int64)(*(--history)); + if(FLAC__bitmath_silog2(sum >> lp_quantization) > 32) { + fprintf(stderr,"FLAC__lpc_compute_residual_from_qlp_coefficients_wide: OVERFLOW, i=%u, sum=%" PRId64 "\n", i, (sum >> lp_quantization)); + break; + } + if(FLAC__bitmath_silog2((FLAC__int64)(*data) - (sum >> lp_quantization)) > 32) { + fprintf(stderr,"FLAC__lpc_compute_residual_from_qlp_coefficients_wide: OVERFLOW, i=%u, data=%d, sum=%" PRId64 ", residual=%" PRId64 "\n", i, *data, (int64_t)(sum >> lp_quantization), ((FLAC__int64)(*data) - (sum >> lp_quantization))); + break; + } + *(residual++) = *(data++) - (FLAC__int32)(sum >> lp_quantization); + } +} +#else /* fully unrolled version for normal use */ +{ + int i; + FLAC__int64 sum; + + FLAC__ASSERT(order > 0); + FLAC__ASSERT(order <= 32); + + /* + * We do unique versions up to 12th order since that's the subset limit. + * Also they are roughly ordered to match frequency of occurrence to + * minimize branching. + */ + if(order <= 12) { + if(order > 8) { + if(order > 10) { + if(order == 12) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[11] * (FLAC__int64)data[i-12]; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 11 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 10) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 9 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + } + } + else if(order > 4) { + if(order > 6) { + if(order == 8) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 7 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 6) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 5 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + } + } + else { + if(order > 2) { + if(order == 4) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 3 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 2) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 1 */ + for(i = 0; i < (int)data_len; i++) + residual[i] = data[i] - (FLAC__int32)((qlp_coeff[0] * (FLAC__int64)data[i-1]) >> lp_quantization); + } + } + } + } + else { /* order > 12 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + switch(order) { + case 32: sum += qlp_coeff[31] * (FLAC__int64)data[i-32]; + case 31: sum += qlp_coeff[30] * (FLAC__int64)data[i-31]; + case 30: sum += qlp_coeff[29] * (FLAC__int64)data[i-30]; + case 29: sum += qlp_coeff[28] * (FLAC__int64)data[i-29]; + case 28: sum += qlp_coeff[27] * (FLAC__int64)data[i-28]; + case 27: sum += qlp_coeff[26] * (FLAC__int64)data[i-27]; + case 26: sum += qlp_coeff[25] * (FLAC__int64)data[i-26]; + case 25: sum += qlp_coeff[24] * (FLAC__int64)data[i-25]; + case 24: sum += qlp_coeff[23] * (FLAC__int64)data[i-24]; + case 23: sum += qlp_coeff[22] * (FLAC__int64)data[i-23]; + case 22: sum += qlp_coeff[21] * (FLAC__int64)data[i-22]; + case 21: sum += qlp_coeff[20] * (FLAC__int64)data[i-21]; + case 20: sum += qlp_coeff[19] * (FLAC__int64)data[i-20]; + case 19: sum += qlp_coeff[18] * (FLAC__int64)data[i-19]; + case 18: sum += qlp_coeff[17] * (FLAC__int64)data[i-18]; + case 17: sum += qlp_coeff[16] * (FLAC__int64)data[i-17]; + case 16: sum += qlp_coeff[15] * (FLAC__int64)data[i-16]; + case 15: sum += qlp_coeff[14] * (FLAC__int64)data[i-15]; + case 14: sum += qlp_coeff[13] * (FLAC__int64)data[i-14]; + case 13: sum += qlp_coeff[12] * (FLAC__int64)data[i-13]; + sum += qlp_coeff[11] * (FLAC__int64)data[i-12]; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[ 9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[ 8] * (FLAC__int64)data[i- 9]; + sum += qlp_coeff[ 7] * (FLAC__int64)data[i- 8]; + sum += qlp_coeff[ 6] * (FLAC__int64)data[i- 7]; + sum += qlp_coeff[ 5] * (FLAC__int64)data[i- 6]; + sum += qlp_coeff[ 4] * (FLAC__int64)data[i- 5]; + sum += qlp_coeff[ 3] * (FLAC__int64)data[i- 4]; + sum += qlp_coeff[ 2] * (FLAC__int64)data[i- 3]; + sum += qlp_coeff[ 1] * (FLAC__int64)data[i- 2]; + sum += qlp_coeff[ 0] * (FLAC__int64)data[i- 1]; + } + residual[i] = data[i] - (FLAC__int32)(sum >> lp_quantization); + } + } +} +#endif + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */ + +void FLAC__lpc_restore_signal(const FLAC__int32 * flac_restrict residual, unsigned data_len, const FLAC__int32 * flac_restrict qlp_coeff, unsigned order, int lp_quantization, FLAC__int32 * flac_restrict data) +#if defined(FLAC__OVERFLOW_DETECT) || !defined(FLAC__LPC_UNROLLED_FILTER_LOOPS) +{ + FLAC__int64 sumo; + unsigned i, j; + FLAC__int32 sum; + const FLAC__int32 *r = residual, *history; + +#ifdef FLAC__OVERFLOW_DETECT_VERBOSE + fprintf(stderr,"FLAC__lpc_restore_signal: data_len=%d, order=%u, lpq=%d",data_len,order,lp_quantization); + for(i=0;i 0); + + for(i = 0; i < data_len; i++) { + sumo = 0; + sum = 0; + history = data; + for(j = 0; j < order; j++) { + sum += qlp_coeff[j] * (*(--history)); + sumo += (FLAC__int64)qlp_coeff[j] * (FLAC__int64)(*history); + if(sumo > 2147483647ll || sumo < -2147483648ll) + fprintf(stderr,"FLAC__lpc_restore_signal: OVERFLOW, i=%u, j=%u, c=%d, d=%d, sumo=%" PRId64 "\n",i,j,qlp_coeff[j],*history,sumo); + } + *(data++) = *(r++) + (sum >> lp_quantization); + } + + /* Here's a slower but clearer version: + for(i = 0; i < data_len; i++) { + sum = 0; + for(j = 0; j < order; j++) + sum += qlp_coeff[j] * data[i-j-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + */ +} +#else /* fully unrolled version for normal use */ +{ + int i; + FLAC__int32 sum; + + FLAC__ASSERT(order > 0); + FLAC__ASSERT(order <= 32); + + /* + * We do unique versions up to 12th order since that's the subset limit. + * Also they are roughly ordered to match frequency of occurrence to + * minimize branching. + */ + if(order <= 12) { + if(order > 8) { + if(order > 10) { + if(order == 12) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[11] * data[i-12]; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 11 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + } + else { + if(order == 10) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[9] * data[i-10]; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 9 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[8] * data[i-9]; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + } + } + else if(order > 4) { + if(order > 6) { + if(order == 8) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[7] * data[i-8]; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 7 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[6] * data[i-7]; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + } + else { + if(order == 6) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[5] * data[i-6]; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 5 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[4] * data[i-5]; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + } + } + else { + if(order > 2) { + if(order == 4) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[3] * data[i-4]; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 3 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[2] * data[i-3]; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + } + else { + if(order == 2) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[1] * data[i-2]; + sum += qlp_coeff[0] * data[i-1]; + data[i] = residual[i] + (sum >> lp_quantization); + } + } + else { /* order == 1 */ + for(i = 0; i < (int)data_len; i++) + data[i] = residual[i] + ((qlp_coeff[0] * data[i-1]) >> lp_quantization); + } + } + } + } + else { /* order > 12 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + switch(order) { + case 32: sum += qlp_coeff[31] * data[i-32]; + case 31: sum += qlp_coeff[30] * data[i-31]; + case 30: sum += qlp_coeff[29] * data[i-30]; + case 29: sum += qlp_coeff[28] * data[i-29]; + case 28: sum += qlp_coeff[27] * data[i-28]; + case 27: sum += qlp_coeff[26] * data[i-27]; + case 26: sum += qlp_coeff[25] * data[i-26]; + case 25: sum += qlp_coeff[24] * data[i-25]; + case 24: sum += qlp_coeff[23] * data[i-24]; + case 23: sum += qlp_coeff[22] * data[i-23]; + case 22: sum += qlp_coeff[21] * data[i-22]; + case 21: sum += qlp_coeff[20] * data[i-21]; + case 20: sum += qlp_coeff[19] * data[i-20]; + case 19: sum += qlp_coeff[18] * data[i-19]; + case 18: sum += qlp_coeff[17] * data[i-18]; + case 17: sum += qlp_coeff[16] * data[i-17]; + case 16: sum += qlp_coeff[15] * data[i-16]; + case 15: sum += qlp_coeff[14] * data[i-15]; + case 14: sum += qlp_coeff[13] * data[i-14]; + case 13: sum += qlp_coeff[12] * data[i-13]; + sum += qlp_coeff[11] * data[i-12]; + sum += qlp_coeff[10] * data[i-11]; + sum += qlp_coeff[ 9] * data[i-10]; + sum += qlp_coeff[ 8] * data[i- 9]; + sum += qlp_coeff[ 7] * data[i- 8]; + sum += qlp_coeff[ 6] * data[i- 7]; + sum += qlp_coeff[ 5] * data[i- 6]; + sum += qlp_coeff[ 4] * data[i- 5]; + sum += qlp_coeff[ 3] * data[i- 4]; + sum += qlp_coeff[ 2] * data[i- 3]; + sum += qlp_coeff[ 1] * data[i- 2]; + sum += qlp_coeff[ 0] * data[i- 1]; + } + data[i] = residual[i] + (sum >> lp_quantization); + } + } +} +#endif + +void FLAC__lpc_restore_signal_wide(const FLAC__int32 * flac_restrict residual, unsigned data_len, const FLAC__int32 * flac_restrict qlp_coeff, unsigned order, int lp_quantization, FLAC__int32 * flac_restrict data) +#if defined(FLAC__OVERFLOW_DETECT) || !defined(FLAC__LPC_UNROLLED_FILTER_LOOPS) +{ + unsigned i, j; + FLAC__int64 sum; + const FLAC__int32 *r = residual, *history; + +#ifdef FLAC__OVERFLOW_DETECT_VERBOSE + fprintf(stderr,"FLAC__lpc_restore_signal_wide: data_len=%d, order=%u, lpq=%d",data_len,order,lp_quantization); + for(i=0;i 0); + + for(i = 0; i < data_len; i++) { + sum = 0; + history = data; + for(j = 0; j < order; j++) + sum += (FLAC__int64)qlp_coeff[j] * (FLAC__int64)(*(--history)); + if(FLAC__bitmath_silog2(sum >> lp_quantization) > 32) { + fprintf(stderr,"FLAC__lpc_restore_signal_wide: OVERFLOW, i=%u, sum=%" PRId64 "\n", i, (sum >> lp_quantization)); + break; + } + if(FLAC__bitmath_silog2((FLAC__int64)(*r) + (sum >> lp_quantization)) > 32) { + fprintf(stderr,"FLAC__lpc_restore_signal_wide: OVERFLOW, i=%u, residual=%d, sum=%" PRId64 ", data=%" PRId64 "\n", i, *r, (sum >> lp_quantization), ((FLAC__int64)(*r) + (sum >> lp_quantization))); + break; + } + *(data++) = *(r++) + (FLAC__int32)(sum >> lp_quantization); + } +} +#else /* fully unrolled version for normal use */ +{ + int i; + FLAC__int64 sum; + + FLAC__ASSERT(order > 0); + FLAC__ASSERT(order <= 32); + + /* + * We do unique versions up to 12th order since that's the subset limit. + * Also they are roughly ordered to match frequency of occurrence to + * minimize branching. + */ + if(order <= 12) { + if(order > 8) { + if(order > 10) { + if(order == 12) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[11] * (FLAC__int64)data[i-12]; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 11 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 10) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 9 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[8] * (FLAC__int64)data[i-9]; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + } + } + else if(order > 4) { + if(order > 6) { + if(order == 8) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[7] * (FLAC__int64)data[i-8]; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 7 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[6] * (FLAC__int64)data[i-7]; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 6) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[5] * (FLAC__int64)data[i-6]; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 5 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[4] * (FLAC__int64)data[i-5]; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + } + } + else { + if(order > 2) { + if(order == 4) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[3] * (FLAC__int64)data[i-4]; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 3 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[2] * (FLAC__int64)data[i-3]; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + } + else { + if(order == 2) { + for(i = 0; i < (int)data_len; i++) { + sum = 0; + sum += qlp_coeff[1] * (FLAC__int64)data[i-2]; + sum += qlp_coeff[0] * (FLAC__int64)data[i-1]; + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } + else { /* order == 1 */ + for(i = 0; i < (int)data_len; i++) + data[i] = residual[i] + (FLAC__int32)((qlp_coeff[0] * (FLAC__int64)data[i-1]) >> lp_quantization); + } + } + } + } + else { /* order > 12 */ + for(i = 0; i < (int)data_len; i++) { + sum = 0; + switch(order) { + case 32: sum += qlp_coeff[31] * (FLAC__int64)data[i-32]; + case 31: sum += qlp_coeff[30] * (FLAC__int64)data[i-31]; + case 30: sum += qlp_coeff[29] * (FLAC__int64)data[i-30]; + case 29: sum += qlp_coeff[28] * (FLAC__int64)data[i-29]; + case 28: sum += qlp_coeff[27] * (FLAC__int64)data[i-28]; + case 27: sum += qlp_coeff[26] * (FLAC__int64)data[i-27]; + case 26: sum += qlp_coeff[25] * (FLAC__int64)data[i-26]; + case 25: sum += qlp_coeff[24] * (FLAC__int64)data[i-25]; + case 24: sum += qlp_coeff[23] * (FLAC__int64)data[i-24]; + case 23: sum += qlp_coeff[22] * (FLAC__int64)data[i-23]; + case 22: sum += qlp_coeff[21] * (FLAC__int64)data[i-22]; + case 21: sum += qlp_coeff[20] * (FLAC__int64)data[i-21]; + case 20: sum += qlp_coeff[19] * (FLAC__int64)data[i-20]; + case 19: sum += qlp_coeff[18] * (FLAC__int64)data[i-19]; + case 18: sum += qlp_coeff[17] * (FLAC__int64)data[i-18]; + case 17: sum += qlp_coeff[16] * (FLAC__int64)data[i-17]; + case 16: sum += qlp_coeff[15] * (FLAC__int64)data[i-16]; + case 15: sum += qlp_coeff[14] * (FLAC__int64)data[i-15]; + case 14: sum += qlp_coeff[13] * (FLAC__int64)data[i-14]; + case 13: sum += qlp_coeff[12] * (FLAC__int64)data[i-13]; + sum += qlp_coeff[11] * (FLAC__int64)data[i-12]; + sum += qlp_coeff[10] * (FLAC__int64)data[i-11]; + sum += qlp_coeff[ 9] * (FLAC__int64)data[i-10]; + sum += qlp_coeff[ 8] * (FLAC__int64)data[i- 9]; + sum += qlp_coeff[ 7] * (FLAC__int64)data[i- 8]; + sum += qlp_coeff[ 6] * (FLAC__int64)data[i- 7]; + sum += qlp_coeff[ 5] * (FLAC__int64)data[i- 6]; + sum += qlp_coeff[ 4] * (FLAC__int64)data[i- 5]; + sum += qlp_coeff[ 3] * (FLAC__int64)data[i- 4]; + sum += qlp_coeff[ 2] * (FLAC__int64)data[i- 3]; + sum += qlp_coeff[ 1] * (FLAC__int64)data[i- 2]; + sum += qlp_coeff[ 0] * (FLAC__int64)data[i- 1]; + } + data[i] = residual[i] + (FLAC__int32)(sum >> lp_quantization); + } + } +} +#endif + +#if defined(_MSC_VER) +#pragma warning ( default : 4028 ) +#endif + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +double FLAC__lpc_compute_expected_bits_per_residual_sample(double lpc_error, unsigned total_samples) +{ + double error_scale; + + FLAC__ASSERT(total_samples > 0); + + error_scale = 0.5 / (double)total_samples; + + return FLAC__lpc_compute_expected_bits_per_residual_sample_with_error_scale(lpc_error, error_scale); +} + +double FLAC__lpc_compute_expected_bits_per_residual_sample_with_error_scale(double lpc_error, double error_scale) +{ + if(lpc_error > 0.0) { + double bps = (double)0.5 * log(error_scale * lpc_error) / M_LN2; + if(bps >= 0.0) + return bps; + else + return 0.0; + } + else if(lpc_error < 0.0) { /* error should not be negative but can happen due to inadequate floating-point resolution */ + return 1e32; + } + else { + return 0.0; + } +} + +unsigned FLAC__lpc_compute_best_order(const double lpc_error[], unsigned max_order, unsigned total_samples, unsigned overhead_bits_per_order) +{ + unsigned order, indx, best_index; /* 'index' the index into lpc_error; index==order-1 since lpc_error[0] is for order==1, lpc_error[1] is for order==2, etc */ + double bits, best_bits, error_scale; + + FLAC__ASSERT(max_order > 0); + FLAC__ASSERT(total_samples > 0); + + error_scale = 0.5 / (double)total_samples; + + best_index = 0; + best_bits = (unsigned)(-1); + + for(indx = 0, order = 1; indx < max_order; indx++, order++) { + bits = FLAC__lpc_compute_expected_bits_per_residual_sample_with_error_scale(lpc_error[indx], error_scale) * (double)(total_samples - order) + (double)(order * overhead_bits_per_order); + if(bits < best_bits) { + best_index = indx; + best_bits = bits; + } + } + + return best_index+1; /* +1 since indx of lpc_error[] is order-1 */ +} + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */ diff --git a/src/libflac/md5.c b/src/libflac/md5.c new file mode 100644 index 0000000..3d33e68 --- /dev/null +++ b/src/libflac/md5.c @@ -0,0 +1,516 @@ +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include /* for malloc() */ +#include /* for memcpy() */ + +#include "private/md5.h" +#include "share/alloc.h" +#include "share/endswap.h" + +/* + * This code implements the MD5 message-digest algorithm. + * The algorithm is due to Ron Rivest. This code was + * written by Colin Plumb in 1993, no copyright is claimed. + * This code is in the public domain; do with it what you wish. + * + * Equivalent code is available from RSA Data Security, Inc. + * This code has been tested against that, and is equivalent, + * except that you don't need to include two pages of legalese + * with every copy. + * + * To compute the message digest of a chunk of bytes, declare an + * MD5Context structure, pass it to MD5Init, call MD5Update as + * needed on buffers full of bytes, and then call MD5Final, which + * will fill a supplied 16-byte array with the digest. + * + * Changed so as no longer to depend on Colin Plumb's `usual.h' header + * definitions; now uses stuff from dpkg's config.h. + * - Ian Jackson . + * Still in the public domain. + * + * Josh Coalson: made some changes to integrate with libFLAC. + * Still in the public domain. + */ + +/* The four core functions - F1 is optimized somewhat */ + +/* #define F1(x, y, z) (x & y | ~x & z) */ +#define F1(x, y, z) (z ^ (x & (y ^ z))) +#define F2(x, y, z) F1(z, x, y) +#define F3(x, y, z) (x ^ y ^ z) +#define F4(x, y, z) (y ^ (x | ~z)) + +/* This is the central step in the MD5 algorithm. */ +#define MD5STEP(f,w,x,y,z,in,s) \ + (w += f(x,y,z) + in, w = (w<>(32-s)) + x) + +/* + * The core of the MD5 algorithm, this alters an existing MD5 hash to + * reflect the addition of 16 longwords of new data. MD5Update blocks + * the data and converts bytes into longwords for this routine. + */ +static void FLAC__MD5Transform(FLAC__uint32 buf[4], FLAC__uint32 const in[16]) +{ + register FLAC__uint32 a, b, c, d; + + a = buf[0]; + b = buf[1]; + c = buf[2]; + d = buf[3]; + + MD5STEP(F1, a, b, c, d, in[0] + 0xd76aa478, 7); + MD5STEP(F1, d, a, b, c, in[1] + 0xe8c7b756, 12); + MD5STEP(F1, c, d, a, b, in[2] + 0x242070db, 17); + MD5STEP(F1, b, c, d, a, in[3] + 0xc1bdceee, 22); + MD5STEP(F1, a, b, c, d, in[4] + 0xf57c0faf, 7); + MD5STEP(F1, d, a, b, c, in[5] + 0x4787c62a, 12); + MD5STEP(F1, c, d, a, b, in[6] + 0xa8304613, 17); + MD5STEP(F1, b, c, d, a, in[7] + 0xfd469501, 22); + MD5STEP(F1, a, b, c, d, in[8] + 0x698098d8, 7); + MD5STEP(F1, d, a, b, c, in[9] + 0x8b44f7af, 12); + MD5STEP(F1, c, d, a, b, in[10] + 0xffff5bb1, 17); + MD5STEP(F1, b, c, d, a, in[11] + 0x895cd7be, 22); + MD5STEP(F1, a, b, c, d, in[12] + 0x6b901122, 7); + MD5STEP(F1, d, a, b, c, in[13] + 0xfd987193, 12); + MD5STEP(F1, c, d, a, b, in[14] + 0xa679438e, 17); + MD5STEP(F1, b, c, d, a, in[15] + 0x49b40821, 22); + + MD5STEP(F2, a, b, c, d, in[1] + 0xf61e2562, 5); + MD5STEP(F2, d, a, b, c, in[6] + 0xc040b340, 9); + MD5STEP(F2, c, d, a, b, in[11] + 0x265e5a51, 14); + MD5STEP(F2, b, c, d, a, in[0] + 0xe9b6c7aa, 20); + MD5STEP(F2, a, b, c, d, in[5] + 0xd62f105d, 5); + MD5STEP(F2, d, a, b, c, in[10] + 0x02441453, 9); + MD5STEP(F2, c, d, a, b, in[15] + 0xd8a1e681, 14); + MD5STEP(F2, b, c, d, a, in[4] + 0xe7d3fbc8, 20); + MD5STEP(F2, a, b, c, d, in[9] + 0x21e1cde6, 5); + MD5STEP(F2, d, a, b, c, in[14] + 0xc33707d6, 9); + MD5STEP(F2, c, d, a, b, in[3] + 0xf4d50d87, 14); + MD5STEP(F2, b, c, d, a, in[8] + 0x455a14ed, 20); + MD5STEP(F2, a, b, c, d, in[13] + 0xa9e3e905, 5); + MD5STEP(F2, d, a, b, c, in[2] + 0xfcefa3f8, 9); + MD5STEP(F2, c, d, a, b, in[7] + 0x676f02d9, 14); + MD5STEP(F2, b, c, d, a, in[12] + 0x8d2a4c8a, 20); + + MD5STEP(F3, a, b, c, d, in[5] + 0xfffa3942, 4); + MD5STEP(F3, d, a, b, c, in[8] + 0x8771f681, 11); + MD5STEP(F3, c, d, a, b, in[11] + 0x6d9d6122, 16); + MD5STEP(F3, b, c, d, a, in[14] + 0xfde5380c, 23); + MD5STEP(F3, a, b, c, d, in[1] + 0xa4beea44, 4); + MD5STEP(F3, d, a, b, c, in[4] + 0x4bdecfa9, 11); + MD5STEP(F3, c, d, a, b, in[7] + 0xf6bb4b60, 16); + MD5STEP(F3, b, c, d, a, in[10] + 0xbebfbc70, 23); + MD5STEP(F3, a, b, c, d, in[13] + 0x289b7ec6, 4); + MD5STEP(F3, d, a, b, c, in[0] + 0xeaa127fa, 11); + MD5STEP(F3, c, d, a, b, in[3] + 0xd4ef3085, 16); + MD5STEP(F3, b, c, d, a, in[6] + 0x04881d05, 23); + MD5STEP(F3, a, b, c, d, in[9] + 0xd9d4d039, 4); + MD5STEP(F3, d, a, b, c, in[12] + 0xe6db99e5, 11); + MD5STEP(F3, c, d, a, b, in[15] + 0x1fa27cf8, 16); + MD5STEP(F3, b, c, d, a, in[2] + 0xc4ac5665, 23); + + MD5STEP(F4, a, b, c, d, in[0] + 0xf4292244, 6); + MD5STEP(F4, d, a, b, c, in[7] + 0x432aff97, 10); + MD5STEP(F4, c, d, a, b, in[14] + 0xab9423a7, 15); + MD5STEP(F4, b, c, d, a, in[5] + 0xfc93a039, 21); + MD5STEP(F4, a, b, c, d, in[12] + 0x655b59c3, 6); + MD5STEP(F4, d, a, b, c, in[3] + 0x8f0ccc92, 10); + MD5STEP(F4, c, d, a, b, in[10] + 0xffeff47d, 15); + MD5STEP(F4, b, c, d, a, in[1] + 0x85845dd1, 21); + MD5STEP(F4, a, b, c, d, in[8] + 0x6fa87e4f, 6); + MD5STEP(F4, d, a, b, c, in[15] + 0xfe2ce6e0, 10); + MD5STEP(F4, c, d, a, b, in[6] + 0xa3014314, 15); + MD5STEP(F4, b, c, d, a, in[13] + 0x4e0811a1, 21); + MD5STEP(F4, a, b, c, d, in[4] + 0xf7537e82, 6); + MD5STEP(F4, d, a, b, c, in[11] + 0xbd3af235, 10); + MD5STEP(F4, c, d, a, b, in[2] + 0x2ad7d2bb, 15); + MD5STEP(F4, b, c, d, a, in[9] + 0xeb86d391, 21); + + buf[0] += a; + buf[1] += b; + buf[2] += c; + buf[3] += d; +} + +#if WORDS_BIGENDIAN +//@@@@@@ OPT: use bswap/intrinsics +static void byteSwap(FLAC__uint32 *buf, unsigned words) +{ + register FLAC__uint32 x; + do { + x = *buf; + x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); + *buf++ = (x >> 16) | (x << 16); + } while (--words); +} +static void byteSwapX16(FLAC__uint32 *buf) +{ + register FLAC__uint32 x; + + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf++ = (x >> 16) | (x << 16); + x = *buf; x = ((x << 8) & 0xff00ff00) | ((x >> 8) & 0x00ff00ff); *buf = (x >> 16) | (x << 16); +} +#else +#define byteSwap(buf, words) +#define byteSwapX16(buf) +#endif + +/* + * Update context to reflect the concatenation of another buffer full + * of bytes. + */ +static void FLAC__MD5Update(FLAC__MD5Context *ctx, FLAC__byte const *buf, unsigned len) +{ + FLAC__uint32 t; + + /* Update byte count */ + + t = ctx->bytes[0]; + if ((ctx->bytes[0] = t + len) < t) + ctx->bytes[1]++; /* Carry from low to high */ + + t = 64 - (t & 0x3f); /* Space available in ctx->in (at least 1) */ + if (t > len) { + memcpy((FLAC__byte *)ctx->in + 64 - t, buf, len); + return; + } + /* First chunk is an odd size */ + memcpy((FLAC__byte *)ctx->in + 64 - t, buf, t); + byteSwapX16(ctx->in); + FLAC__MD5Transform(ctx->buf, ctx->in); + buf += t; + len -= t; + + /* Process data in 64-byte chunks */ + while (len >= 64) { + memcpy(ctx->in, buf, 64); + byteSwapX16(ctx->in); + FLAC__MD5Transform(ctx->buf, ctx->in); + buf += 64; + len -= 64; + } + + /* Handle any remaining bytes of data. */ + memcpy(ctx->in, buf, len); +} + +/* + * Start MD5 accumulation. Set bit count to 0 and buffer to mysterious + * initialization constants. + */ +void FLAC__MD5Init(FLAC__MD5Context *ctx) +{ + ctx->buf[0] = 0x67452301; + ctx->buf[1] = 0xefcdab89; + ctx->buf[2] = 0x98badcfe; + ctx->buf[3] = 0x10325476; + + ctx->bytes[0] = 0; + ctx->bytes[1] = 0; + + ctx->internal_buf.p8 = 0; + ctx->capacity = 0; +} + +/* + * Final wrapup - pad to 64-byte boundary with the bit pattern + * 1 0* (64-bit count of bits processed, MSB-first) + */ +void FLAC__MD5Final(FLAC__byte digest[16], FLAC__MD5Context *ctx) +{ + int count = ctx->bytes[0] & 0x3f; /* Number of bytes in ctx->in */ + FLAC__byte *p = (FLAC__byte *)ctx->in + count; + + /* Set the first char of padding to 0x80. There is always room. */ + *p++ = 0x80; + + /* Bytes of padding needed to make 56 bytes (-8..55) */ + count = 56 - 1 - count; + + if (count < 0) { /* Padding forces an extra block */ + memset(p, 0, count + 8); + byteSwapX16(ctx->in); + FLAC__MD5Transform(ctx->buf, ctx->in); + p = (FLAC__byte *)ctx->in; + count = 56; + } + memset(p, 0, count); + byteSwap(ctx->in, 14); + + /* Append length in bits and transform */ + ctx->in[14] = ctx->bytes[0] << 3; + ctx->in[15] = ctx->bytes[1] << 3 | ctx->bytes[0] >> 29; + FLAC__MD5Transform(ctx->buf, ctx->in); + + byteSwap(ctx->buf, 4); + memcpy(digest, ctx->buf, 16); + if (0 != ctx->internal_buf.p8) { + free(ctx->internal_buf.p8); + ctx->internal_buf.p8 = 0; + ctx->capacity = 0; + } + memset(ctx, 0, sizeof(*ctx)); /* In case it's sensitive */ +} + +/* + * Convert the incoming audio signal to a byte stream + */ +static void format_input_(FLAC__multibyte *mbuf, const FLAC__int32 * const signal[], unsigned channels, unsigned samples, unsigned bytes_per_sample) +{ + FLAC__byte *buf_ = mbuf->p8; + FLAC__int16 *buf16 = mbuf->p16; + FLAC__int32 *buf32 = mbuf->p32; + FLAC__int32 a_word; + unsigned channel, sample; + + /* Storage in the output buffer, buf, is little endian. */ + +#define BYTES_CHANNEL_SELECTOR(bytes, channels) (bytes * 100 + channels) + + /* First do the most commonly used combinations. */ + switch (BYTES_CHANNEL_SELECTOR (bytes_per_sample, channels)) { + /* One byte per sample. */ + case (BYTES_CHANNEL_SELECTOR (1, 1)): + for (sample = 0; sample < samples; sample++) + *buf_++ = signal[0][sample]; + return; + + case (BYTES_CHANNEL_SELECTOR (1, 2)): + for (sample = 0; sample < samples; sample++) { + *buf_++ = signal[0][sample]; + *buf_++ = signal[1][sample]; + } + return; + + case (BYTES_CHANNEL_SELECTOR (1, 4)): + for (sample = 0; sample < samples; sample++) { + *buf_++ = signal[0][sample]; + *buf_++ = signal[1][sample]; + *buf_++ = signal[2][sample]; + *buf_++ = signal[3][sample]; + } + return; + + case (BYTES_CHANNEL_SELECTOR (1, 6)): + for (sample = 0; sample < samples; sample++) { + *buf_++ = signal[0][sample]; + *buf_++ = signal[1][sample]; + *buf_++ = signal[2][sample]; + *buf_++ = signal[3][sample]; + *buf_++ = signal[4][sample]; + *buf_++ = signal[5][sample]; + } + return; + + case (BYTES_CHANNEL_SELECTOR (1, 8)): + for (sample = 0; sample < samples; sample++) { + *buf_++ = signal[0][sample]; + *buf_++ = signal[1][sample]; + *buf_++ = signal[2][sample]; + *buf_++ = signal[3][sample]; + *buf_++ = signal[4][sample]; + *buf_++ = signal[5][sample]; + *buf_++ = signal[6][sample]; + *buf_++ = signal[7][sample]; + } + return; + + /* Two bytes per sample. */ + case (BYTES_CHANNEL_SELECTOR (2, 1)): + for (sample = 0; sample < samples; sample++) + *buf16++ = H2LE_16(signal[0][sample]); + return; + + case (BYTES_CHANNEL_SELECTOR (2, 2)): + for (sample = 0; sample < samples; sample++) { + *buf16++ = H2LE_16(signal[0][sample]); + *buf16++ = H2LE_16(signal[1][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (2, 4)): + for (sample = 0; sample < samples; sample++) { + *buf16++ = H2LE_16(signal[0][sample]); + *buf16++ = H2LE_16(signal[1][sample]); + *buf16++ = H2LE_16(signal[2][sample]); + *buf16++ = H2LE_16(signal[3][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (2, 6)): + for (sample = 0; sample < samples; sample++) { + *buf16++ = H2LE_16(signal[0][sample]); + *buf16++ = H2LE_16(signal[1][sample]); + *buf16++ = H2LE_16(signal[2][sample]); + *buf16++ = H2LE_16(signal[3][sample]); + *buf16++ = H2LE_16(signal[4][sample]); + *buf16++ = H2LE_16(signal[5][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (2, 8)): + for (sample = 0; sample < samples; sample++) { + *buf16++ = H2LE_16(signal[0][sample]); + *buf16++ = H2LE_16(signal[1][sample]); + *buf16++ = H2LE_16(signal[2][sample]); + *buf16++ = H2LE_16(signal[3][sample]); + *buf16++ = H2LE_16(signal[4][sample]); + *buf16++ = H2LE_16(signal[5][sample]); + *buf16++ = H2LE_16(signal[6][sample]); + *buf16++ = H2LE_16(signal[7][sample]); + } + return; + + /* Three bytes per sample. */ + case (BYTES_CHANNEL_SELECTOR (3, 1)): + for (sample = 0; sample < samples; sample++) { + a_word = signal[0][sample]; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; + } + return; + + case (BYTES_CHANNEL_SELECTOR (3, 2)): + for (sample = 0; sample < samples; sample++) { + a_word = signal[0][sample]; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; + a_word = signal[1][sample]; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; + } + return; + + /* Four bytes per sample. */ + case (BYTES_CHANNEL_SELECTOR (4, 1)): + for (sample = 0; sample < samples; sample++) + *buf32++ = H2LE_32(signal[0][sample]); + return; + + case (BYTES_CHANNEL_SELECTOR (4, 2)): + for (sample = 0; sample < samples; sample++) { + *buf32++ = H2LE_32(signal[0][sample]); + *buf32++ = H2LE_32(signal[1][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (4, 4)): + for (sample = 0; sample < samples; sample++) { + *buf32++ = H2LE_32(signal[0][sample]); + *buf32++ = H2LE_32(signal[1][sample]); + *buf32++ = H2LE_32(signal[2][sample]); + *buf32++ = H2LE_32(signal[3][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (4, 6)): + for (sample = 0; sample < samples; sample++) { + *buf32++ = H2LE_32(signal[0][sample]); + *buf32++ = H2LE_32(signal[1][sample]); + *buf32++ = H2LE_32(signal[2][sample]); + *buf32++ = H2LE_32(signal[3][sample]); + *buf32++ = H2LE_32(signal[4][sample]); + *buf32++ = H2LE_32(signal[5][sample]); + } + return; + + case (BYTES_CHANNEL_SELECTOR (4, 8)): + for (sample = 0; sample < samples; sample++) { + *buf32++ = H2LE_32(signal[0][sample]); + *buf32++ = H2LE_32(signal[1][sample]); + *buf32++ = H2LE_32(signal[2][sample]); + *buf32++ = H2LE_32(signal[3][sample]); + *buf32++ = H2LE_32(signal[4][sample]); + *buf32++ = H2LE_32(signal[5][sample]); + *buf32++ = H2LE_32(signal[6][sample]); + *buf32++ = H2LE_32(signal[7][sample]); + } + return; + + default: + break; + } + + /* General version. */ + switch (bytes_per_sample) { + case 1: + for (sample = 0; sample < samples; sample++) + for (channel = 0; channel < channels; channel++) + *buf_++ = signal[channel][sample]; + return; + + case 2: + for (sample = 0; sample < samples; sample++) + for (channel = 0; channel < channels; channel++) + *buf16++ = H2LE_16(signal[channel][sample]); + return; + + case 3: + for (sample = 0; sample < samples; sample++) + for (channel = 0; channel < channels; channel++) { + a_word = signal[channel][sample]; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; a_word >>= 8; + *buf_++ = (FLAC__byte)a_word; + } + return; + + case 4: + for (sample = 0; sample < samples; sample++) + for (channel = 0; channel < channels; channel++) + *buf32++ = H2LE_32(signal[channel][sample]); + return; + + default: + break; + } +} + +/* + * Convert the incoming audio signal to a byte stream and FLAC__MD5Update it. + */ +FLAC__bool FLAC__MD5Accumulate(FLAC__MD5Context *ctx, const FLAC__int32 * const signal[], unsigned channels, unsigned samples, unsigned bytes_per_sample) +{ + const size_t bytes_needed = (size_t)channels * (size_t)samples * (size_t)bytes_per_sample; + + /* overflow check */ + if ((size_t)channels > SIZE_MAX / (size_t)bytes_per_sample) + return false; + if ((size_t)channels * (size_t)bytes_per_sample > SIZE_MAX / (size_t)samples) + return false; + + if (ctx->capacity < bytes_needed) { + if (0 == (ctx->internal_buf.p8 = safe_realloc_(ctx->internal_buf.p8, bytes_needed))) { + if (0 == (ctx->internal_buf.p8 = safe_malloc_(bytes_needed))) { + ctx->capacity = 0; + return false; + } + } + ctx->capacity = bytes_needed; + } + + format_input_(&ctx->internal_buf, signal, channels, samples, bytes_per_sample); + + FLAC__MD5Update(ctx, ctx->internal_buf.p8, bytes_needed); + + return true; +} diff --git a/src/libflac/memory.c b/src/libflac/memory.c new file mode 100644 index 0000000..caf1b34 --- /dev/null +++ b/src/libflac/memory.c @@ -0,0 +1,218 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#ifdef HAVE_STDINT_H +#include +#endif + +#include "private/memory.h" +#include "FLAC/assert.h" +#include "share/alloc.h" + +void *FLAC__memory_alloc_aligned(size_t bytes, void **aligned_address) +{ + void *x; + + FLAC__ASSERT(0 != aligned_address); + +#ifdef FLAC__ALIGN_MALLOC_DATA + /* align on 32-byte (256-bit) boundary */ + x = safe_malloc_add_2op_(bytes, /*+*/31L); + *aligned_address = (void*)(((uintptr_t)x + 31L) & -32L); +#else + x = safe_malloc_(bytes); + *aligned_address = x; +#endif + return x; +} + +FLAC__bool FLAC__memory_alloc_aligned_int32_array(size_t elements, FLAC__int32 **unaligned_pointer, FLAC__int32 **aligned_pointer) +{ + FLAC__int32 *pu; /* unaligned pointer */ + union { /* union needed to comply with C99 pointer aliasing rules */ + FLAC__int32 *pa; /* aligned pointer */ + void *pv; /* aligned pointer alias */ + } u; + + FLAC__ASSERT(elements > 0); + FLAC__ASSERT(0 != unaligned_pointer); + FLAC__ASSERT(0 != aligned_pointer); + FLAC__ASSERT(unaligned_pointer != aligned_pointer); + + if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */ + return false; + + pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv); + if(0 == pu) { + return false; + } + else { + if(*unaligned_pointer != 0) + free(*unaligned_pointer); + *unaligned_pointer = pu; + *aligned_pointer = u.pa; + return true; + } +} + +FLAC__bool FLAC__memory_alloc_aligned_uint32_array(size_t elements, FLAC__uint32 **unaligned_pointer, FLAC__uint32 **aligned_pointer) +{ + FLAC__uint32 *pu; /* unaligned pointer */ + union { /* union needed to comply with C99 pointer aliasing rules */ + FLAC__uint32 *pa; /* aligned pointer */ + void *pv; /* aligned pointer alias */ + } u; + + FLAC__ASSERT(elements > 0); + FLAC__ASSERT(0 != unaligned_pointer); + FLAC__ASSERT(0 != aligned_pointer); + FLAC__ASSERT(unaligned_pointer != aligned_pointer); + + if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */ + return false; + + pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv); + if(0 == pu) { + return false; + } + else { + if(*unaligned_pointer != 0) + free(*unaligned_pointer); + *unaligned_pointer = pu; + *aligned_pointer = u.pa; + return true; + } +} + +FLAC__bool FLAC__memory_alloc_aligned_uint64_array(size_t elements, FLAC__uint64 **unaligned_pointer, FLAC__uint64 **aligned_pointer) +{ + FLAC__uint64 *pu; /* unaligned pointer */ + union { /* union needed to comply with C99 pointer aliasing rules */ + FLAC__uint64 *pa; /* aligned pointer */ + void *pv; /* aligned pointer alias */ + } u; + + FLAC__ASSERT(elements > 0); + FLAC__ASSERT(0 != unaligned_pointer); + FLAC__ASSERT(0 != aligned_pointer); + FLAC__ASSERT(unaligned_pointer != aligned_pointer); + + if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */ + return false; + + pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv); + if(0 == pu) { + return false; + } + else { + if(*unaligned_pointer != 0) + free(*unaligned_pointer); + *unaligned_pointer = pu; + *aligned_pointer = u.pa; + return true; + } +} + +FLAC__bool FLAC__memory_alloc_aligned_unsigned_array(size_t elements, unsigned **unaligned_pointer, unsigned **aligned_pointer) +{ + unsigned *pu; /* unaligned pointer */ + union { /* union needed to comply with C99 pointer aliasing rules */ + unsigned *pa; /* aligned pointer */ + void *pv; /* aligned pointer alias */ + } u; + + FLAC__ASSERT(elements > 0); + FLAC__ASSERT(0 != unaligned_pointer); + FLAC__ASSERT(0 != aligned_pointer); + FLAC__ASSERT(unaligned_pointer != aligned_pointer); + + if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */ + return false; + + pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv); + if(0 == pu) { + return false; + } + else { + if(*unaligned_pointer != 0) + free(*unaligned_pointer); + *unaligned_pointer = pu; + *aligned_pointer = u.pa; + return true; + } +} + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +FLAC__bool FLAC__memory_alloc_aligned_real_array(size_t elements, FLAC__real **unaligned_pointer, FLAC__real **aligned_pointer) +{ + FLAC__real *pu; /* unaligned pointer */ + union { /* union needed to comply with C99 pointer aliasing rules */ + FLAC__real *pa; /* aligned pointer */ + void *pv; /* aligned pointer alias */ + } u; + + FLAC__ASSERT(elements > 0); + FLAC__ASSERT(0 != unaligned_pointer); + FLAC__ASSERT(0 != aligned_pointer); + FLAC__ASSERT(unaligned_pointer != aligned_pointer); + + if(elements > SIZE_MAX / sizeof(*pu)) /* overflow check */ + return false; + + pu = FLAC__memory_alloc_aligned(sizeof(*pu) * elements, &u.pv); + if(0 == pu) { + return false; + } + else { + if(*unaligned_pointer != 0) + free(*unaligned_pointer); + *unaligned_pointer = pu; + *aligned_pointer = u.pa; + return true; + } +} + +#endif + +void *safe_malloc_mul_2op_p(size_t size1, size_t size2) +{ + if(!size1 || !size2) + return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */ + if(size1 > SIZE_MAX / size2) + return 0; + return malloc(size1*size2); +} diff --git a/src/libflac/private/FLAC b/src/libflac/private/FLAC new file mode 120000 index 0000000..90e9c10 --- /dev/null +++ b/src/libflac/private/FLAC @@ -0,0 +1 @@ +../FLAC \ No newline at end of file diff --git a/src/libflac/private/all.h b/src/libflac/private/all.h new file mode 100644 index 0000000..7715962 --- /dev/null +++ b/src/libflac/private/all.h @@ -0,0 +1,50 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__ALL_H +#define FLAC__PRIVATE__ALL_H + +#include "bitmath.h" +#include "bitreader.h" +#include "bitwriter.h" +#include "cpu.h" +#include "crc.h" +#include "fixed.h" +#include "float.h" +#include "format.h" +#include "lpc.h" +#include "md5.h" +#include "memory.h" +#include "metadata.h" +#include "stream_encoder_framing.h" + +#endif diff --git a/src/libflac/private/bitmath.h b/src/libflac/private/bitmath.h new file mode 100644 index 0000000..1cd4dda --- /dev/null +++ b/src/libflac/private/bitmath.h @@ -0,0 +1,212 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__BITMATH_H +#define FLAC__PRIVATE__BITMATH_H + +#include + +#include "FLAC/ordinals.h" +#include "FLAC/assert.h" + +#include "share/compat.h" + +#if defined(_MSC_VER) +#include /* for _BitScanReverse* */ +#endif + +/* Will never be emitted for MSVC, GCC, Intel compilers */ +static inline unsigned int FLAC__clz_soft_uint32(FLAC__uint32 word) +{ + static const unsigned char byte_to_unary_table[] PROGMEM = { + 8, 7, 6, 6, 5, 5, 5, 5, 4, 4, 4, 4, 4, 4, 4, 4, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, + 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 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, 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, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + }; + + return word > 0xffffff ? pgm_read_byte(&byte_to_unary_table[word >> 24]) : + word > 0xffff ? pgm_read_byte(&byte_to_unary_table[word >> 16]) + 8 : + word > 0xff ? pgm_read_byte(&byte_to_unary_table[word >> 8]) + 16 : + pgm_read_byte(&byte_to_unary_table[word]) + 24; +} + +static inline unsigned int FLAC__clz_uint32(FLAC__uint32 v) +{ +/* Never used with input 0 */ + FLAC__ASSERT(v > 0); +#if defined(__INTEL_COMPILER) + return _bit_scan_reverse(v) ^ 31U; +#elif defined(__GNUC__) && (__GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)) +/* This will translate either to (bsr ^ 31U), clz , ctlz, cntlz, lzcnt depending on + * -march= setting or to a software routine in exotic machines. */ + return __builtin_clz(v); +#elif defined(_MSC_VER) + { + unsigned long idx; + _BitScanReverse(&idx, v); + return idx ^ 31U; + } +#else + return FLAC__clz_soft_uint32(v); +#endif +} + +/* Used when 64-bit bsr/clz is unavailable; can use 32-bit bsr/clz when possible */ +static inline unsigned int FLAC__clz_soft_uint64(FLAC__uint64 word) +{ + return (FLAC__uint32)(word>>32) ? FLAC__clz_uint32((FLAC__uint32)(word>>32)) : + FLAC__clz_uint32((FLAC__uint32)word) + 32; +} + +static inline unsigned int FLAC__clz_uint64(FLAC__uint64 v) +{ + /* Never used with input 0 */ + FLAC__ASSERT(v > 0); +#if defined(__GNUC__) && (__GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)) + return __builtin_clzll(v); +#elif (defined(__INTEL_COMPILER) || defined(_MSC_VER)) && (defined(_M_IA64) || defined(_M_X64)) + { + unsigned long idx; + _BitScanReverse64(&idx, v); + return idx ^ 63U; + } +#else + return FLAC__clz_soft_uint64(v); +#endif +} + +/* These two functions work with input 0 */ +static inline unsigned int FLAC__clz2_uint32(FLAC__uint32 v) +{ + if (!v) + return 32; + return FLAC__clz_uint32(v); +} + +static inline unsigned int FLAC__clz2_uint64(FLAC__uint64 v) +{ + if (!v) + return 64; + return FLAC__clz_uint64(v); +} + +/* An example of what FLAC__bitmath_ilog2() computes: + * + * ilog2( 0) = assertion failure + * ilog2( 1) = 0 + * ilog2( 2) = 1 + * ilog2( 3) = 1 + * ilog2( 4) = 2 + * ilog2( 5) = 2 + * ilog2( 6) = 2 + * ilog2( 7) = 2 + * ilog2( 8) = 3 + * ilog2( 9) = 3 + * ilog2(10) = 3 + * ilog2(11) = 3 + * ilog2(12) = 3 + * ilog2(13) = 3 + * ilog2(14) = 3 + * ilog2(15) = 3 + * ilog2(16) = 4 + * ilog2(17) = 4 + * ilog2(18) = 4 + */ + +static inline unsigned FLAC__bitmath_ilog2(FLAC__uint32 v) +{ + FLAC__ASSERT(v > 0); +#if defined(__INTEL_COMPILER) + return _bit_scan_reverse(v); +#elif defined(_MSC_VER) + { + unsigned long idx; + _BitScanReverse(&idx, v); + return idx; + } +#else + return FLAC__clz_uint32(v) ^ 31U; +#endif +} + +static inline unsigned FLAC__bitmath_ilog2_wide(FLAC__uint64 v) +{ + FLAC__ASSERT(v > 0); +#if defined(__GNUC__) && (__GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)) + return __builtin_clzll(v) ^ 63U; +/* Sorry, only supported in x64/Itanium.. and both have fast FPU which makes integer-only encoder pointless */ +#elif (defined(__INTEL_COMPILER) || defined(_MSC_VER)) && (defined(_M_IA64) || defined(_M_X64)) + { + unsigned long idx; + _BitScanReverse64(&idx, v); + return idx; + } +#else +/* Brain-damaged compilers will use the fastest possible way that is, + de Bruijn sequences (http://supertech.csail.mit.edu/papers/debruijn.pdf) + (C) Timothy B. Terriberry (tterribe@xiph.org) 2001-2009 CC0 (Public domain). +*/ + { + static const unsigned char 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 + }; + v|= v>>1; + v|= v>>2; + v|= v>>4; + v|= v>>8; + v|= v>>16; + v|= v>>32; + v= (v>>1)+1; + return DEBRUIJN_IDX64[v*FLAC__U64L(0x218A392CD3D5DBF)>>58&0x3F]; + } +#endif +} + +unsigned FLAC__bitmath_silog2(FLAC__int64 v); + +#endif diff --git a/src/libflac/private/bitreader.h b/src/libflac/private/bitreader.h new file mode 100644 index 0000000..7c73165 --- /dev/null +++ b/src/libflac/private/bitreader.h @@ -0,0 +1,91 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__BITREADER_H +#define FLAC__PRIVATE__BITREADER_H + +#include /* for FILE */ +#include "FLAC/ordinals.h" +#include "cpu.h" + +/* + * opaque structure definition + */ +struct FLAC__BitReader; +typedef struct FLAC__BitReader FLAC__BitReader; + +typedef FLAC__bool (*FLAC__BitReaderReadCallback)(FLAC__byte buffer[], size_t *bytes, void *client_data); + +/* + * construction, deletion, initialization, etc functions + */ +FLAC__BitReader *FLAC__bitreader_new(void); +void FLAC__bitreader_delete(FLAC__BitReader *br); +FLAC__bool FLAC__bitreader_init(FLAC__BitReader *br, FLAC__BitReaderReadCallback rcb, void *cd); +void FLAC__bitreader_free(FLAC__BitReader *br); /* does not 'free(br)' */ +FLAC__bool FLAC__bitreader_clear(FLAC__BitReader *br); +void FLAC__bitreader_dump(const FLAC__BitReader *br, FILE *out); + +/* + * CRC functions + */ +void FLAC__bitreader_reset_read_crc16(FLAC__BitReader *br, FLAC__uint16 seed); +FLAC__uint16 FLAC__bitreader_get_read_crc16(FLAC__BitReader *br); + +/* + * info functions + */ +FLAC__bool FLAC__bitreader_is_consumed_byte_aligned(const FLAC__BitReader *br); +unsigned FLAC__bitreader_bits_left_for_byte_alignment(const FLAC__BitReader *br); +unsigned FLAC__bitreader_get_input_bits_unconsumed(const FLAC__BitReader *br); + +/* + * read functions + */ + +FLAC__bool FLAC__bitreader_read_raw_uint32(FLAC__BitReader *br, FLAC__uint32 *val, unsigned bits); +FLAC__bool FLAC__bitreader_read_raw_int32(FLAC__BitReader *br, FLAC__int32 *val, unsigned bits); +FLAC__bool FLAC__bitreader_read_raw_uint64(FLAC__BitReader *br, FLAC__uint64 *val, unsigned bits); +FLAC__bool FLAC__bitreader_read_uint32_little_endian(FLAC__BitReader *br, FLAC__uint32 *val); /*only for bits=32*/ +FLAC__bool FLAC__bitreader_skip_bits_no_crc(FLAC__BitReader *br, unsigned bits); /* WATCHOUT: does not CRC the skipped data! */ /*@@@@ add to unit tests */ +FLAC__bool FLAC__bitreader_skip_byte_block_aligned_no_crc(FLAC__BitReader *br, unsigned nvals); /* WATCHOUT: does not CRC the read data! */ +FLAC__bool FLAC__bitreader_read_byte_block_aligned_no_crc(FLAC__BitReader *br, FLAC__byte *val, unsigned nvals); /* WATCHOUT: does not CRC the read data! */ +FLAC__bool FLAC__bitreader_read_unary_unsigned(FLAC__BitReader *br, unsigned *val); +FLAC__bool FLAC__bitreader_read_rice_signed(FLAC__BitReader *br, int *val, unsigned parameter); +FLAC__bool FLAC__bitreader_read_rice_signed_block(FLAC__BitReader *br, int vals[], unsigned nvals, unsigned parameter); +#if 0 /* UNUSED */ +FLAC__bool FLAC__bitreader_read_golomb_signed(FLAC__BitReader *br, int *val, unsigned parameter); +FLAC__bool FLAC__bitreader_read_golomb_unsigned(FLAC__BitReader *br, unsigned *val, unsigned parameter); +#endif +FLAC__bool FLAC__bitreader_read_utf8_uint32(FLAC__BitReader *br, FLAC__uint32 *val, FLAC__byte *raw, unsigned *rawlen); +FLAC__bool FLAC__bitreader_read_utf8_uint64(FLAC__BitReader *br, FLAC__uint64 *val, FLAC__byte *raw, unsigned *rawlen); +#endif diff --git a/src/libflac/private/bitwriter.h b/src/libflac/private/bitwriter.h new file mode 100644 index 0000000..ef3ad1b --- /dev/null +++ b/src/libflac/private/bitwriter.h @@ -0,0 +1,104 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__BITWRITER_H +#define FLAC__PRIVATE__BITWRITER_H + +#include /* for FILE */ +#include "FLAC/ordinals.h" + +/* + * opaque structure definition + */ +struct FLAC__BitWriter; +typedef struct FLAC__BitWriter FLAC__BitWriter; + +/* + * construction, deletion, initialization, etc functions + */ +FLAC__BitWriter *FLAC__bitwriter_new(void); +void FLAC__bitwriter_delete(FLAC__BitWriter *bw); +FLAC__bool FLAC__bitwriter_init(FLAC__BitWriter *bw); +void FLAC__bitwriter_free(FLAC__BitWriter *bw); /* does not 'free(buffer)' */ +void FLAC__bitwriter_clear(FLAC__BitWriter *bw); +void FLAC__bitwriter_dump(const FLAC__BitWriter *bw, FILE *out); + +/* + * CRC functions + * + * non-const *bw because they have to cal FLAC__bitwriter_get_buffer() + */ +FLAC__bool FLAC__bitwriter_get_write_crc16(FLAC__BitWriter *bw, FLAC__uint16 *crc); +FLAC__bool FLAC__bitwriter_get_write_crc8(FLAC__BitWriter *bw, FLAC__byte *crc); + +/* + * info functions + */ +FLAC__bool FLAC__bitwriter_is_byte_aligned(const FLAC__BitWriter *bw); +unsigned FLAC__bitwriter_get_input_bits_unconsumed(const FLAC__BitWriter *bw); /* can be called anytime, returns total # of bits unconsumed */ + +/* + * direct buffer access + * + * there may be no calls on the bitwriter between get and release. + * the bitwriter continues to own the returned buffer. + * before get, bitwriter MUST be byte aligned: check with FLAC__bitwriter_is_byte_aligned() + */ +FLAC__bool FLAC__bitwriter_get_buffer(FLAC__BitWriter *bw, const FLAC__byte **buffer, size_t *bytes); +void FLAC__bitwriter_release_buffer(FLAC__BitWriter *bw); + +/* + * write functions + */ +FLAC__bool FLAC__bitwriter_write_zeroes(FLAC__BitWriter *bw, unsigned bits); +FLAC__bool FLAC__bitwriter_write_raw_uint32(FLAC__BitWriter *bw, FLAC__uint32 val, unsigned bits); +FLAC__bool FLAC__bitwriter_write_raw_int32(FLAC__BitWriter *bw, FLAC__int32 val, unsigned bits); +FLAC__bool FLAC__bitwriter_write_raw_uint64(FLAC__BitWriter *bw, FLAC__uint64 val, unsigned bits); +FLAC__bool FLAC__bitwriter_write_raw_uint32_little_endian(FLAC__BitWriter *bw, FLAC__uint32 val); /*only for bits=32*/ +FLAC__bool FLAC__bitwriter_write_byte_block(FLAC__BitWriter *bw, const FLAC__byte vals[], unsigned nvals); +FLAC__bool FLAC__bitwriter_write_unary_unsigned(FLAC__BitWriter *bw, unsigned val); +unsigned FLAC__bitwriter_rice_bits(FLAC__int32 val, unsigned parameter); +#if 0 /* UNUSED */ +unsigned FLAC__bitwriter_golomb_bits_signed(int val, unsigned parameter); +unsigned FLAC__bitwriter_golomb_bits_unsigned(unsigned val, unsigned parameter); +#endif +FLAC__bool FLAC__bitwriter_write_rice_signed(FLAC__BitWriter *bw, FLAC__int32 val, unsigned parameter); +FLAC__bool FLAC__bitwriter_write_rice_signed_block(FLAC__BitWriter *bw, const FLAC__int32 *vals, unsigned nvals, unsigned parameter); +#if 0 /* UNUSED */ +FLAC__bool FLAC__bitwriter_write_golomb_signed(FLAC__BitWriter *bw, int val, unsigned parameter); +FLAC__bool FLAC__bitwriter_write_golomb_unsigned(FLAC__BitWriter *bw, unsigned val, unsigned parameter); +#endif +FLAC__bool FLAC__bitwriter_write_utf8_uint32(FLAC__BitWriter *bw, FLAC__uint32 val); +FLAC__bool FLAC__bitwriter_write_utf8_uint64(FLAC__BitWriter *bw, FLAC__uint64 val); +FLAC__bool FLAC__bitwriter_zero_pad_to_byte_boundary(FLAC__BitWriter *bw); + +#endif diff --git a/src/libflac/private/cpu.h b/src/libflac/private/cpu.h new file mode 100644 index 0000000..7c65180 --- /dev/null +++ b/src/libflac/private/cpu.h @@ -0,0 +1,186 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__CPU_H +#define FLAC__PRIVATE__CPU_H + +#include "FLAC/ordinals.h" + +#ifdef HAVE_CONFIG_H +#include +#endif + +#ifndef FLAC__CPU_X86_64 + +#if defined(__amd64__) || defined(__amd64) || defined(__x86_64__) || defined(__x86_64) || defined(_M_X64) || defined(_M_AMD64) +#define FLAC__CPU_X86_64 +#endif + +#endif + +#ifndef FLAC__CPU_IA32 + +#if defined(__i386__) || defined(__i486__) || defined(__i586__) || defined(__i686__) ||defined( __i386) || defined(_M_IX86) +#define FLAC__CPU_IA32 +#endif + +#endif + + +#if FLAC__HAS_X86INTRIN +/* SSE intrinsics support by ICC/MSVC/GCC */ +#if defined __INTEL_COMPILER + #define FLAC__SSE_TARGET(x) + #define FLAC__SSE_SUPPORTED 1 + #define FLAC__SSE2_SUPPORTED 1 + #if (__INTEL_COMPILER >= 1000) /* Intel C++ Compiler 10.0 */ + #define FLAC__SSSE3_SUPPORTED 1 + #define FLAC__SSE4_1_SUPPORTED 1 + #endif + #if (__INTEL_COMPILER >= 1110) /* Intel C++ Compiler 11.1 */ + #define FLAC__AVX_SUPPORTED 1 + #endif + #if (__INTEL_COMPILER >= 1300) /* Intel C++ Compiler 13.0 */ + #define FLAC__AVX2_SUPPORTED 1 + #define FLAC__FMA_SUPPORTED 1 + #endif +#elif defined _MSC_VER + #define FLAC__SSE_TARGET(x) + #define FLAC__SSE_SUPPORTED 1 + #define FLAC__SSE2_SUPPORTED 1 + #if (_MSC_VER >= 1500) /* MS Visual Studio 2008 */ + #define FLAC__SSSE3_SUPPORTED 1 + #define FLAC__SSE4_1_SUPPORTED 1 + #endif + #if (_MSC_FULL_VER >= 160040219) /* MS Visual Studio 2010 SP1 */ + #define FLAC__AVX_SUPPORTED 1 + #endif + #if (_MSC_VER >= 1700) /* MS Visual Studio 2012 */ + #define FLAC__AVX2_SUPPORTED 1 + #define FLAC__FMA_SUPPORTED 1 + #endif +#elif defined __GNUC__ + #if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 9)) /* since GCC 4.9 -msse.. compiler options aren't necessary */ + #define FLAC__SSE_TARGET(x) __attribute__ ((__target__ (x))) + #define FLAC__SSE_SUPPORTED 1 + #define FLAC__SSE2_SUPPORTED 1 + #define FLAC__SSSE3_SUPPORTED 1 + #define FLAC__SSE4_1_SUPPORTED 1 +#ifdef FLAC__USE_AVX + #define FLAC__AVX_SUPPORTED 1 + #define FLAC__AVX2_SUPPORTED 1 + #define FLAC__FMA_SUPPORTED 1 +#endif + #else /* for GCC older than 4.9 */ + #define FLAC__SSE_TARGET(x) + #ifdef __SSE__ + #define FLAC__SSE_SUPPORTED 1 + #endif + #ifdef __SSE2__ + #define FLAC__SSE2_SUPPORTED 1 + #endif + #ifdef __SSSE3__ + #define FLAC__SSSE3_SUPPORTED 1 + #endif + #ifdef __SSE4_1__ + #define FLAC__SSE4_1_SUPPORTED 1 + #endif + #ifdef __AVX__ + #define FLAC__AVX_SUPPORTED 1 + #endif + #ifdef __AVX2__ + #define FLAC__AVX2_SUPPORTED 1 + #endif + #ifdef __FMA__ + #define FLAC__FMA_SUPPORTED 1 + #endif + #endif /* GCC version */ +#endif /* compiler version */ +#endif /* intrinsics support */ + + +#ifndef FLAC__AVX_SUPPORTED +#define FLAC__AVX_SUPPORTED 0 +#endif + +typedef enum { + FLAC__CPUINFO_TYPE_IA32, + FLAC__CPUINFO_TYPE_X86_64, + FLAC__CPUINFO_TYPE_UNKNOWN +} FLAC__CPUInfo_Type; + +typedef struct { + FLAC__bool intel; + + FLAC__bool cmov; + FLAC__bool mmx; + FLAC__bool sse; + FLAC__bool sse2; + + FLAC__bool sse3; + FLAC__bool ssse3; + FLAC__bool sse41; + FLAC__bool sse42; + FLAC__bool avx; + FLAC__bool avx2; + FLAC__bool fma; +} FLAC__CPUInfo_IA32; + +typedef struct { + FLAC__bool intel; + + FLAC__bool sse3; + FLAC__bool ssse3; + FLAC__bool sse41; + FLAC__bool sse42; + FLAC__bool avx; + FLAC__bool avx2; + FLAC__bool fma; +} FLAC__CPUInfo_x86; + + +typedef struct { + FLAC__bool use_asm; + FLAC__CPUInfo_Type type; + FLAC__CPUInfo_IA32 ia32; + FLAC__CPUInfo_x86 x86; +} FLAC__CPUInfo; + +void FLAC__cpu_info(FLAC__CPUInfo *info); + +FLAC__uint32 FLAC__cpu_have_cpuid_asm_ia32(void); + +void FLAC__cpu_info_asm_ia32(FLAC__uint32 *flags_edx, FLAC__uint32 *flags_ecx); + +void FLAC__cpu_info_x86(FLAC__uint32 level, FLAC__uint32 *eax, FLAC__uint32 *ebx, FLAC__uint32 *ecx, FLAC__uint32 *edx); + +#endif diff --git a/src/libflac/private/crc.h b/src/libflac/private/crc.h new file mode 100644 index 0000000..76e9420 --- /dev/null +++ b/src/libflac/private/crc.h @@ -0,0 +1,64 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__CRC_H +#define FLAC__PRIVATE__CRC_H + +#include + +#include "FLAC/ordinals.h" + +/* 8 bit CRC generator, MSB shifted first +** polynomial = x^8 + x^2 + x^1 + x^0 +** init = 0 +*/ +extern FLAC__byte const FLAC__crc8_table[256]; +#define FLAC__CRC8_UPDATE(data, crc) (crc) = pgm_read_byte(&FLAC__crc8_table[(crc) ^ (data)]); +void FLAC__crc8_update(const FLAC__byte data, FLAC__uint8 *crc); +void FLAC__crc8_update_block(const FLAC__byte *data, unsigned len, FLAC__uint8 *crc); +FLAC__uint8 FLAC__crc8(const FLAC__byte *data, unsigned len); + +/* 16 bit CRC generator, MSB shifted first +** polynomial = x^16 + x^15 + x^2 + x^0 +** init = 0 +*/ +extern unsigned const FLAC__crc16_table[256]; + +#define FLAC__CRC16_UPDATE(data, crc) ((((crc)<<8) & 0xffff) ^ pgm_read_word(&FLAC__crc16_table[((crc)>>8) ^ (data)])) +/* this alternate may be faster on some systems/compilers */ +#if 0 +#define FLAC__CRC16_UPDATE(data, crc) ((((crc)<<8) ^ FLAC__crc16_table[((crc)>>8) ^ (data)]) & 0xffff) +#endif + +unsigned FLAC__crc16(const FLAC__byte *data, unsigned len); + +#endif diff --git a/src/libflac/private/fixed.h b/src/libflac/private/fixed.h new file mode 100644 index 0000000..b6c9e6d --- /dev/null +++ b/src/libflac/private/fixed.h @@ -0,0 +1,107 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__FIXED_H +#define FLAC__PRIVATE__FIXED_H + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include "cpu.h" +#include "float.h" +#include "FLAC/format.h" + +/* + * FLAC__fixed_compute_best_predictor() + * -------------------------------------------------------------------- + * Compute the best fixed predictor and the expected bits-per-sample + * of the residual signal for each order. The _wide() version uses + * 64-bit integers which is statistically necessary when bits-per- + * sample + log2(blocksize) > 30 + * + * IN data[0,data_len-1] + * IN data_len + * OUT residual_bits_per_sample[0,FLAC__MAX_FIXED_ORDER] + */ +#ifndef FLAC__INTEGER_ONLY_LIBRARY +unsigned FLAC__fixed_compute_best_predictor(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +unsigned FLAC__fixed_compute_best_predictor_wide(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +# ifndef FLAC__NO_ASM +# if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN +# ifdef FLAC__SSE2_SUPPORTED +unsigned FLAC__fixed_compute_best_predictor_intrin_sse2(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER + 1]); +unsigned FLAC__fixed_compute_best_predictor_wide_intrin_sse2(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER + 1]); +# endif +# ifdef FLAC__SSSE3_SUPPORTED +unsigned FLAC__fixed_compute_best_predictor_intrin_ssse3(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +unsigned FLAC__fixed_compute_best_predictor_wide_intrin_ssse3(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER + 1]); +# endif +# endif +# if defined FLAC__CPU_IA32 && defined FLAC__HAS_NASM +unsigned FLAC__fixed_compute_best_predictor_asm_ia32_mmx_cmov(const FLAC__int32 data[], unsigned data_len, float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +# endif +# endif +#else +unsigned FLAC__fixed_compute_best_predictor(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +unsigned FLAC__fixed_compute_best_predictor_wide(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]); +#endif + +/* + * FLAC__fixed_compute_residual() + * -------------------------------------------------------------------- + * Compute the residual signal obtained from sutracting the predicted + * signal from the original. + * + * IN data[-order,data_len-1] original signal (NOTE THE INDICES!) + * IN data_len length of original signal + * IN order <= FLAC__MAX_FIXED_ORDER fixed-predictor order + * OUT residual[0,data_len-1] residual signal + */ +void FLAC__fixed_compute_residual(const FLAC__int32 data[], unsigned data_len, unsigned order, FLAC__int32 residual[]); + +/* + * FLAC__fixed_restore_signal() + * -------------------------------------------------------------------- + * Restore the original signal by summing the residual and the + * predictor. + * + * IN residual[0,data_len-1] residual signal + * IN data_len length of original signal + * IN order <= FLAC__MAX_FIXED_ORDER fixed-predictor order + * *** IMPORTANT: the caller must pass in the historical samples: + * IN data[-order,-1] previously-reconstructed historical samples + * OUT data[0,data_len-1] original signal + */ +void FLAC__fixed_restore_signal(const FLAC__int32 residual[], unsigned data_len, unsigned order, FLAC__int32 data[]); + +#endif diff --git a/src/libflac/private/float.h b/src/libflac/private/float.h new file mode 100644 index 0000000..12ece60 --- /dev/null +++ b/src/libflac/private/float.h @@ -0,0 +1,95 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2004-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__FLOAT_H +#define FLAC__PRIVATE__FLOAT_H + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include "FLAC/ordinals.h" + +/* + * All the code in libFLAC that uses float and double + * should be protected by checks of the macro + * FLAC__INTEGER_ONLY_LIBRARY. + * + */ +#ifndef FLAC__INTEGER_ONLY_LIBRARY +/* + * FLAC__real is the basic floating point type used in LPC analysis. + * + * WATCHOUT: changing FLAC__real will change the signatures of many + * functions that have assembly language equivalents and break them. + */ +typedef float FLAC__real; +#else +/* + * The convention for FLAC__fixedpoint is to use the upper 16 bits + * for the integer part and lower 16 bits for the fractional part. + */ +typedef FLAC__int32 FLAC__fixedpoint; +extern const FLAC__fixedpoint FLAC__FP_ZERO; +extern const FLAC__fixedpoint FLAC__FP_ONE_HALF; +extern const FLAC__fixedpoint FLAC__FP_ONE; +extern const FLAC__fixedpoint FLAC__FP_LN2; +extern const FLAC__fixedpoint FLAC__FP_E; + +#define FLAC__fixedpoint_trunc(x) ((x)>>16) + +#define FLAC__fixedpoint_mul(x, y) ( (FLAC__fixedpoint) ( ((FLAC__int64)(x)*(FLAC__int64)(y)) >> 16 ) ) + +#define FLAC__fixedpoint_div(x, y) ( (FLAC__fixedpoint) ( ( ((FLAC__int64)(x)<<32) / (FLAC__int64)(y) ) >> 16 ) ) + +/* + * FLAC__fixedpoint_log2() + * -------------------------------------------------------------------- + * Returns the base-2 logarithm of the fixed-point number 'x' using an + * algorithm by Knuth for x >= 1.0 + * + * 'fracbits' is the number of fractional bits of 'x'. 'fracbits' must + * be < 32 and evenly divisible by 4 (0 is OK but not very precise). + * + * 'precision' roughly limits the number of iterations that are done; + * use (unsigned)(-1) for maximum precision. + * + * If 'x' is less than one -- that is, x < (1< +#endif + +#include "cpu.h" +#include "float.h" +#include "FLAC/format.h" + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +/* + * FLAC__lpc_window_data() + * -------------------------------------------------------------------- + * Applies the given window to the data. + * OPT: asm implementation + * + * IN in[0,data_len-1] + * IN window[0,data_len-1] + * OUT out[0,lag-1] + * IN data_len + */ +void FLAC__lpc_window_data(const FLAC__int32 in[], const FLAC__real window[], FLAC__real out[], unsigned data_len); + +/* + * FLAC__lpc_compute_autocorrelation() + * -------------------------------------------------------------------- + * Compute the autocorrelation for lags between 0 and lag-1. + * Assumes data[] outside of [0,data_len-1] == 0. + * Asserts that lag > 0. + * + * IN data[0,data_len-1] + * IN data_len + * IN 0 < lag <= data_len + * OUT autoc[0,lag-1] + */ +void FLAC__lpc_compute_autocorrelation(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +#ifndef FLAC__NO_ASM +# ifdef FLAC__CPU_IA32 +# ifdef FLAC__HAS_NASM +void FLAC__lpc_compute_autocorrelation_asm_ia32(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_4_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_8_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_12_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_16_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +# endif +# endif +# if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN +# ifdef FLAC__SSE_SUPPORTED +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_4_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_8_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_12_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_16_old(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_4_new(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_8_new(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_12_new(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +void FLAC__lpc_compute_autocorrelation_intrin_sse_lag_16_new(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]); +# endif +# endif +#endif + +/* + * FLAC__lpc_compute_lp_coefficients() + * -------------------------------------------------------------------- + * Computes LP coefficients for orders 1..max_order. + * Do not call if autoc[0] == 0.0. This means the signal is zero + * and there is no point in calculating a predictor. + * + * IN autoc[0,max_order] autocorrelation values + * IN 0 < max_order <= FLAC__MAX_LPC_ORDER max LP order to compute + * OUT lp_coeff[0,max_order-1][0,max_order-1] LP coefficients for each order + * *** IMPORTANT: + * *** lp_coeff[0,max_order-1][max_order,FLAC__MAX_LPC_ORDER-1] are untouched + * OUT error[0,max_order-1] error for each order (more + * specifically, the variance of + * the error signal times # of + * samples in the signal) + * + * Example: if max_order is 9, the LP coefficients for order 9 will be + * in lp_coeff[8][0,8], the LP coefficients for order 8 will be + * in lp_coeff[7][0,7], etc. + */ +void FLAC__lpc_compute_lp_coefficients(const FLAC__real autoc[], unsigned *max_order, FLAC__real lp_coeff[][FLAC__MAX_LPC_ORDER], double error[]); + +/* + * FLAC__lpc_quantize_coefficients() + * -------------------------------------------------------------------- + * Quantizes the LP coefficients. NOTE: precision + bits_per_sample + * must be less than 32 (sizeof(FLAC__int32)*8). + * + * IN lp_coeff[0,order-1] LP coefficients + * IN order LP order + * IN FLAC__MIN_QLP_COEFF_PRECISION < precision + * desired precision (in bits, including sign + * bit) of largest coefficient + * OUT qlp_coeff[0,order-1] quantized coefficients + * OUT shift # of bits to shift right to get approximated + * LP coefficients. NOTE: could be negative. + * RETURN 0 => quantization OK + * 1 => coefficients require too much shifting for *shift to + * fit in the LPC subframe header. 'shift' is unset. + * 2 => coefficients are all zero, which is bad. 'shift' is + * unset. + */ +int FLAC__lpc_quantize_coefficients(const FLAC__real lp_coeff[], unsigned order, unsigned precision, FLAC__int32 qlp_coeff[], int *shift); + +/* + * FLAC__lpc_compute_residual_from_qlp_coefficients() + * -------------------------------------------------------------------- + * Compute the residual signal obtained from sutracting the predicted + * signal from the original. + * + * IN data[-order,data_len-1] original signal (NOTE THE INDICES!) + * IN data_len length of original signal + * IN qlp_coeff[0,order-1] quantized LP coefficients + * IN order > 0 LP order + * IN lp_quantization quantization of LP coefficients in bits + * OUT residual[0,data_len-1] residual signal + */ +void FLAC__lpc_compute_residual_from_qlp_coefficients(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_wide(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +#ifndef FLAC__NO_ASM +# ifdef FLAC__CPU_IA32 +# ifdef FLAC__HAS_NASM +void FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_wide_asm_ia32(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +# endif +# endif +# if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN +# ifdef FLAC__SSE2_SUPPORTED +void FLAC__lpc_compute_residual_from_qlp_coefficients_16_intrin_sse2(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_intrin_sse2(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +# endif +# ifdef FLAC__SSE4_1_SUPPORTED +void FLAC__lpc_compute_residual_from_qlp_coefficients_intrin_sse41(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_wide_intrin_sse41(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +# endif +# ifdef FLAC__AVX2_SUPPORTED +void FLAC__lpc_compute_residual_from_qlp_coefficients_16_intrin_avx2(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_intrin_avx2(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +void FLAC__lpc_compute_residual_from_qlp_coefficients_wide_intrin_avx2(const FLAC__int32 *data, unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]); +# endif +# endif +#endif + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */ + +/* + * FLAC__lpc_restore_signal() + * -------------------------------------------------------------------- + * Restore the original signal by summing the residual and the + * predictor. + * + * IN residual[0,data_len-1] residual signal + * IN data_len length of original signal + * IN qlp_coeff[0,order-1] quantized LP coefficients + * IN order > 0 LP order + * IN lp_quantization quantization of LP coefficients in bits + * *** IMPORTANT: the caller must pass in the historical samples: + * IN data[-order,-1] previously-reconstructed historical samples + * OUT data[0,data_len-1] original signal + */ +void FLAC__lpc_restore_signal(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +void FLAC__lpc_restore_signal_wide(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +#ifndef FLAC__NO_ASM +# ifdef FLAC__CPU_IA32 +# ifdef FLAC__HAS_NASM +void FLAC__lpc_restore_signal_asm_ia32(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +void FLAC__lpc_restore_signal_asm_ia32_mmx(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +void FLAC__lpc_restore_signal_wide_asm_ia32(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +# endif /* FLAC__HAS_NASM */ +# endif /* FLAC__CPU_IA32 */ +# if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && FLAC__HAS_X86INTRIN +# ifdef FLAC__SSE2_SUPPORTED +void FLAC__lpc_restore_signal_16_intrin_sse2(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +# endif +# ifdef FLAC__SSE4_1_SUPPORTED +void FLAC__lpc_restore_signal_wide_intrin_sse41(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); +# endif +# endif +#endif /* FLAC__NO_ASM */ + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +/* + * FLAC__lpc_compute_expected_bits_per_residual_sample() + * -------------------------------------------------------------------- + * Compute the expected number of bits per residual signal sample + * based on the LP error (which is related to the residual variance). + * + * IN lpc_error >= 0.0 error returned from calculating LP coefficients + * IN total_samples > 0 # of samples in residual signal + * RETURN expected bits per sample + */ +double FLAC__lpc_compute_expected_bits_per_residual_sample(double lpc_error, unsigned total_samples); +double FLAC__lpc_compute_expected_bits_per_residual_sample_with_error_scale(double lpc_error, double error_scale); + +/* + * FLAC__lpc_compute_best_order() + * -------------------------------------------------------------------- + * Compute the best order from the array of signal errors returned + * during coefficient computation. + * + * IN lpc_error[0,max_order-1] >= 0.0 error returned from calculating LP coefficients + * IN max_order > 0 max LP order + * IN total_samples > 0 # of samples in residual signal + * IN overhead_bits_per_order # of bits overhead for each increased LP order + * (includes warmup sample size and quantized LP coefficient) + * RETURN [1,max_order] best order + */ +unsigned FLAC__lpc_compute_best_order(const double lpc_error[], unsigned max_order, unsigned total_samples, unsigned overhead_bits_per_order); + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */ + +#endif diff --git a/src/libflac/private/macros.h b/src/libflac/private/macros.h new file mode 100644 index 0000000..becc59f --- /dev/null +++ b/src/libflac/private/macros.h @@ -0,0 +1,72 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2012-2016 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. + */ + +#ifndef FLAC__PRIVATE__MACROS_H +#define FLAC__PRIVATE__MACROS_H + +#if defined(__GNUC__) && (__GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 3)) + +#define flac_max(a,b) \ + ({ __typeof__ (a) _a = (a); \ + __typeof__ (b) _b = (b); \ + _a > _b ? _a : _b; }) + +#define MIN_PASTE(A,B) A##B +#define MIN_IMPL(A,B,L) ({ \ + __typeof__(A) MIN_PASTE(__a,L) = (A); \ + __typeof__(B) MIN_PASTE(__b,L) = (B); \ + MIN_PASTE(__a,L) < MIN_PASTE(__b,L) ? MIN_PASTE(__a,L) : MIN_PASTE(__b,L); \ + }) + +#define flac_min(A,B) MIN_IMPL(A,B,__COUNTER__) + +/* Whatever other unix that has sys/param.h */ +#elif defined(HAVE_SYS_PARAM_H) +#include +#define flac_max(a,b) MAX(a,b) +#define flac_min(a,b) MIN(a,b) + +/* Windows VS has them in stdlib.h.. XXX:Untested */ +#elif defined(_MSC_VER) +#include +#define flac_max(a,b) __max(a,b) +#define flac_min(a,b) __min(a,b) +#endif + +#ifndef MIN +#define MIN(x,y) ((x) <= (y) ? (x) : (y)) +#endif + +#ifndef MAX +#define MAX(x,y) ((x) >= (y) ? (x) : (y)) +#endif + +#endif diff --git a/src/libflac/private/md5.h b/src/libflac/private/md5.h new file mode 100644 index 0000000..c665ab3 --- /dev/null +++ b/src/libflac/private/md5.h @@ -0,0 +1,50 @@ +#ifndef FLAC__PRIVATE__MD5_H +#define FLAC__PRIVATE__MD5_H + +/* + * This is the header file for the MD5 message-digest algorithm. + * The algorithm is due to Ron Rivest. This code was + * written by Colin Plumb in 1993, no copyright is claimed. + * This code is in the public domain; do with it what you wish. + * + * Equivalent code is available from RSA Data Security, Inc. + * This code has been tested against that, and is equivalent, + * except that you don't need to include two pages of legalese + * with every copy. + * + * To compute the message digest of a chunk of bytes, declare an + * MD5Context structure, pass it to MD5Init, call MD5Update as + * needed on buffers full of bytes, and then call MD5Final, which + * will fill a supplied 16-byte array with the digest. + * + * Changed so as no longer to depend on Colin Plumb's `usual.h' + * header definitions; now uses stuff from dpkg's config.h + * - Ian Jackson . + * Still in the public domain. + * + * Josh Coalson: made some changes to integrate with libFLAC. + * Still in the public domain, with no warranty. + */ + +#include "FLAC/ordinals.h" + +typedef union { + FLAC__byte *p8; + FLAC__int16 *p16; + FLAC__int32 *p32; +} FLAC__multibyte; + +typedef struct { + FLAC__uint32 in[16]; + FLAC__uint32 buf[4]; + FLAC__uint32 bytes[2]; + FLAC__multibyte internal_buf; + size_t capacity; +} FLAC__MD5Context; + +void FLAC__MD5Init(FLAC__MD5Context *context); +void FLAC__MD5Final(FLAC__byte digest[16], FLAC__MD5Context *context); + +FLAC__bool FLAC__MD5Accumulate(FLAC__MD5Context *ctx, const FLAC__int32 * const signal[], unsigned channels, unsigned samples, unsigned bytes_per_sample); + +#endif diff --git a/src/libflac/private/memory.h b/src/libflac/private/memory.h new file mode 100644 index 0000000..271a692 --- /dev/null +++ b/src/libflac/private/memory.h @@ -0,0 +1,58 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__MEMORY_H +#define FLAC__PRIVATE__MEMORY_H + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include /* for size_t */ + +#include "float.h" +#include "FLAC/ordinals.h" /* for FLAC__bool */ + +/* Returns the unaligned address returned by malloc. + * Use free() on this address to deallocate. + */ +void *FLAC__memory_alloc_aligned(size_t bytes, void **aligned_address); +FLAC__bool FLAC__memory_alloc_aligned_int32_array(size_t elements, FLAC__int32 **unaligned_pointer, FLAC__int32 **aligned_pointer); +FLAC__bool FLAC__memory_alloc_aligned_uint32_array(size_t elements, FLAC__uint32 **unaligned_pointer, FLAC__uint32 **aligned_pointer); +FLAC__bool FLAC__memory_alloc_aligned_uint64_array(size_t elements, FLAC__uint64 **unaligned_pointer, FLAC__uint64 **aligned_pointer); +FLAC__bool FLAC__memory_alloc_aligned_unsigned_array(size_t elements, unsigned **unaligned_pointer, unsigned **aligned_pointer); +#ifndef FLAC__INTEGER_ONLY_LIBRARY +FLAC__bool FLAC__memory_alloc_aligned_real_array(size_t elements, FLAC__real **unaligned_pointer, FLAC__real **aligned_pointer); +#endif +void *safe_malloc_mul_2op_p(size_t size1, size_t size2); + +#endif diff --git a/src/libflac/private/metadata.h b/src/libflac/private/metadata.h new file mode 100644 index 0000000..161947f --- /dev/null +++ b/src/libflac/private/metadata.h @@ -0,0 +1,46 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__METADATA_H +#define FLAC__PRIVATE__METADATA_H + +#include "FLAC/metadata.h" + +/* WATCHOUT: all malloc()ed data in the block is free()ed; this may not + * be a consistent state (e.g. PICTURE) or equivalent to the initial + * state after FLAC__metadata_object_new() + */ +void FLAC__metadata_object_delete_data(FLAC__StreamMetadata *object); + +void FLAC__metadata_object_cuesheet_track_delete_data(FLAC__StreamMetadata_CueSheet_Track *object); + +#endif diff --git a/src/libflac/private/ogg_decoder_aspect.h b/src/libflac/private/ogg_decoder_aspect.h new file mode 100644 index 0000000..218f44e --- /dev/null +++ b/src/libflac/private/ogg_decoder_aspect.h @@ -0,0 +1,80 @@ +/* libFLAC - Free Lossless Audio Codec + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__OGG_DECODER_ASPECT_H +#define FLAC__PRIVATE__OGG_DECODER_ASPECT_H + +#include + +#include "FLAC/ordinals.h" +#include "FLAC/stream_decoder.h" /* for FLAC__StreamDecoderReadStatus */ + +typedef struct FLAC__OggDecoderAspect { + /* these are storage for values that can be set through the API */ + FLAC__bool use_first_serial_number; + long serial_number; + + /* these are for internal state related to Ogg decoding */ + ogg_stream_state stream_state; + ogg_sync_state sync_state; + unsigned version_major, version_minor; + FLAC__bool need_serial_number; + FLAC__bool end_of_stream; + FLAC__bool have_working_page; /* only if true will the following vars be valid */ + ogg_page working_page; + FLAC__bool have_working_packet; /* only if true will the following vars be valid */ + ogg_packet working_packet; /* as we work through the packet we will move working_packet.packet forward and working_packet.bytes down */ +} FLAC__OggDecoderAspect; + +void FLAC__ogg_decoder_aspect_set_serial_number(FLAC__OggDecoderAspect *aspect, long value); +void FLAC__ogg_decoder_aspect_set_defaults(FLAC__OggDecoderAspect *aspect); +FLAC__bool FLAC__ogg_decoder_aspect_init(FLAC__OggDecoderAspect *aspect); +void FLAC__ogg_decoder_aspect_finish(FLAC__OggDecoderAspect *aspect); +void FLAC__ogg_decoder_aspect_flush(FLAC__OggDecoderAspect *aspect); +void FLAC__ogg_decoder_aspect_reset(FLAC__OggDecoderAspect *aspect); + +typedef enum { + FLAC__OGG_DECODER_ASPECT_READ_STATUS_OK = 0, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_END_OF_STREAM, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_LOST_SYNC, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_NOT_FLAC, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_UNSUPPORTED_MAPPING_VERSION, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_ABORT, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_ERROR, + FLAC__OGG_DECODER_ASPECT_READ_STATUS_MEMORY_ALLOCATION_ERROR +} FLAC__OggDecoderAspectReadStatus; + +typedef FLAC__OggDecoderAspectReadStatus (*FLAC__OggDecoderAspectReadCallbackProxy)(const void *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data); + +FLAC__OggDecoderAspectReadStatus FLAC__ogg_decoder_aspect_read_callback_wrapper(FLAC__OggDecoderAspect *aspect, FLAC__byte buffer[], size_t *bytes, FLAC__OggDecoderAspectReadCallbackProxy read_callback, const FLAC__StreamDecoder *decoder, void *client_data); + +#endif diff --git a/src/libflac/private/ogg_encoder_aspect.h b/src/libflac/private/ogg_encoder_aspect.h new file mode 100644 index 0000000..f55ef32 --- /dev/null +++ b/src/libflac/private/ogg_encoder_aspect.h @@ -0,0 +1,63 @@ +/* libFLAC - Free Lossless Audio Codec + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__OGG_ENCODER_ASPECT_H +#define FLAC__PRIVATE__OGG_ENCODER_ASPECT_H + +#include + +#include "FLAC/ordinals.h" +#include "FLAC/stream_encoder.h" /* for FLAC__StreamEncoderWriteStatus */ + +typedef struct FLAC__OggEncoderAspect { + /* these are storage for values that can be set through the API */ + long serial_number; + unsigned num_metadata; + + /* these are for internal state related to Ogg encoding */ + ogg_stream_state stream_state; + ogg_page page; + FLAC__bool seen_magic; /* true if we've seen the fLaC magic in the write callback yet */ + FLAC__bool is_first_packet; + FLAC__uint64 samples_written; +} FLAC__OggEncoderAspect; + +void FLAC__ogg_encoder_aspect_set_serial_number(FLAC__OggEncoderAspect *aspect, long value); +FLAC__bool FLAC__ogg_encoder_aspect_set_num_metadata(FLAC__OggEncoderAspect *aspect, unsigned value); +void FLAC__ogg_encoder_aspect_set_defaults(FLAC__OggEncoderAspect *aspect); +FLAC__bool FLAC__ogg_encoder_aspect_init(FLAC__OggEncoderAspect *aspect); +void FLAC__ogg_encoder_aspect_finish(FLAC__OggEncoderAspect *aspect); + +typedef FLAC__StreamEncoderWriteStatus (*FLAC__OggEncoderAspectWriteCallbackProxy)(const void *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, unsigned current_frame, void *client_data); + +FLAC__StreamEncoderWriteStatus FLAC__ogg_encoder_aspect_write_callback_wrapper(FLAC__OggEncoderAspect *aspect, const FLAC__byte buffer[], size_t bytes, unsigned samples, unsigned current_frame, FLAC__bool is_last_block, FLAC__OggEncoderAspectWriteCallbackProxy write_callback, void *encoder, void *client_data); +#endif diff --git a/src/libflac/private/ogg_helper.h b/src/libflac/private/ogg_helper.h new file mode 100644 index 0000000..4c1000c --- /dev/null +++ b/src/libflac/private/ogg_helper.h @@ -0,0 +1,44 @@ +/* libFLAC - Free Lossless Audio Codec + * Copyright (C) 2004-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__OGG_HELPER_H +#define FLAC__PRIVATE__OGG_HELPER_H + +#include +#include "FLAC/stream_encoder.h" /* for FLAC__StreamEncoder */ + +void simple_ogg_page__init(ogg_page *page); +void simple_ogg_page__clear(ogg_page *page); +FLAC__bool simple_ogg_page__get_at(FLAC__StreamEncoder *encoder, FLAC__uint64 position, ogg_page *page, FLAC__StreamEncoderSeekCallback seek_callback, FLAC__StreamEncoderReadCallback read_callback, void *client_data); +FLAC__bool simple_ogg_page__set_at(FLAC__StreamEncoder *encoder, FLAC__uint64 position, ogg_page *page, FLAC__StreamEncoderSeekCallback seek_callback, FLAC__StreamEncoderWriteCallback write_callback, void *client_data); + +#endif diff --git a/src/libflac/private/ogg_mapping.h b/src/libflac/private/ogg_mapping.h new file mode 100644 index 0000000..1fa022d --- /dev/null +++ b/src/libflac/private/ogg_mapping.h @@ -0,0 +1,64 @@ +/* libFLAC - Free Lossless Audio Codec + * Copyright (C) 2004-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__OGG_MAPPING_H +#define FLAC__PRIVATE__OGG_MAPPING_H + +#include "FLAC/ordinals.h" + +/** The length of the packet type field in bytes. */ +#define FLAC__OGG_MAPPING_PACKET_TYPE_LENGTH (1u) + +extern const unsigned FLAC__OGG_MAPPING_PACKET_TYPE_LEN; /* = 8 bits */ + +extern const FLAC__byte FLAC__OGG_MAPPING_FIRST_HEADER_PACKET_TYPE; /* = 0x7f */ + +/** The length of the 'FLAC' magic in bytes. */ +#define FLAC__OGG_MAPPING_MAGIC_LENGTH (4u) + +extern const FLAC__byte * const FLAC__OGG_MAPPING_MAGIC; /* = "FLAC" */ + +extern const unsigned FLAC__OGG_MAPPING_VERSION_MAJOR_LEN; /* = 8 bits */ +extern const unsigned FLAC__OGG_MAPPING_VERSION_MINOR_LEN; /* = 8 bits */ + +/** The length of the Ogg FLAC mapping major version number in bytes. */ +#define FLAC__OGG_MAPPING_VERSION_MAJOR_LENGTH (1u) + +/** The length of the Ogg FLAC mapping minor version number in bytes. */ +#define FLAC__OGG_MAPPING_VERSION_MINOR_LENGTH (1u) + +extern const unsigned FLAC__OGG_MAPPING_NUM_HEADERS_LEN; /* = 16 bits */ + +/** The length of the #-of-header-packets number bytes. */ +#define FLAC__OGG_MAPPING_NUM_HEADERS_LENGTH (2u) + +#endif diff --git a/src/libflac/private/share b/src/libflac/private/share new file mode 120000 index 0000000..f2d0b20 --- /dev/null +++ b/src/libflac/private/share @@ -0,0 +1 @@ +../share \ No newline at end of file diff --git a/src/libflac/private/stream_encoder.h b/src/libflac/private/stream_encoder.h new file mode 100644 index 0000000..ab1721f --- /dev/null +++ b/src/libflac/private/stream_encoder.h @@ -0,0 +1,67 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__STREAM_ENCODER_H +#define FLAC__PRIVATE__STREAM_ENCODER_H + +#ifdef HAVE_CONFIG_H +#include +#endif + +/* + * This is used to avoid overflow with unusual signals in 32-bit + * accumulator in the *precompute_partition_info_sums_* functions. + */ +#define FLAC__MAX_EXTRA_RESIDUAL_BPS 4 + +#if (defined FLAC__CPU_IA32 || defined FLAC__CPU_X86_64) && defined FLAC__HAS_X86INTRIN +#include "private/cpu.h" +#include "FLAC/format.h" + +#ifdef FLAC__SSE2_SUPPORTED +extern void FLAC__precompute_partition_info_sums_intrin_sse2(const FLAC__int32 residual[], FLAC__uint64 abs_residual_partition_sums[], + unsigned residual_samples, unsigned predictor_order, unsigned min_partition_order, unsigned max_partition_order, unsigned bps); +#endif + +#ifdef FLAC__SSSE3_SUPPORTED +extern void FLAC__precompute_partition_info_sums_intrin_ssse3(const FLAC__int32 residual[], FLAC__uint64 abs_residual_partition_sums[], + unsigned residual_samples, unsigned predictor_order, unsigned min_partition_order, unsigned max_partition_order, unsigned bps); +#endif + +#ifdef FLAC__AVX2_SUPPORTED +extern void FLAC__precompute_partition_info_sums_intrin_avx2(const FLAC__int32 residual[], FLAC__uint64 abs_residual_partition_sums[], + unsigned residual_samples, unsigned predictor_order, unsigned min_partition_order, unsigned max_partition_order, unsigned bps); +#endif + +#endif + +#endif diff --git a/src/libflac/private/stream_encoder_framing.h b/src/libflac/private/stream_encoder_framing.h new file mode 100644 index 0000000..f633a9d --- /dev/null +++ b/src/libflac/private/stream_encoder_framing.h @@ -0,0 +1,46 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__STREAM_ENCODER_FRAMING_H +#define FLAC__PRIVATE__STREAM_ENCODER_FRAMING_H + +#include "FLAC/format.h" +#include "bitwriter.h" + +FLAC__bool FLAC__add_metadata_block(const FLAC__StreamMetadata *metadata, FLAC__BitWriter *bw); +FLAC__bool FLAC__frame_add_header(const FLAC__FrameHeader *header, FLAC__BitWriter *bw); +FLAC__bool FLAC__subframe_add_constant(const FLAC__Subframe_Constant *subframe, unsigned subframe_bps, unsigned wasted_bits, FLAC__BitWriter *bw); +FLAC__bool FLAC__subframe_add_fixed(const FLAC__Subframe_Fixed *subframe, unsigned residual_samples, unsigned subframe_bps, unsigned wasted_bits, FLAC__BitWriter *bw); +FLAC__bool FLAC__subframe_add_lpc(const FLAC__Subframe_LPC *subframe, unsigned residual_samples, unsigned subframe_bps, unsigned wasted_bits, FLAC__BitWriter *bw); +FLAC__bool FLAC__subframe_add_verbatim(const FLAC__Subframe_Verbatim *subframe, unsigned samples, unsigned subframe_bps, unsigned wasted_bits, FLAC__BitWriter *bw); + +#endif diff --git a/src/libflac/private/window.h b/src/libflac/private/window.h new file mode 100644 index 0000000..0562158 --- /dev/null +++ b/src/libflac/private/window.h @@ -0,0 +1,74 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2006-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PRIVATE__WINDOW_H +#define FLAC__PRIVATE__WINDOW_H + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include "float.h" +#include "FLAC/format.h" + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +/* + * FLAC__window_*() + * -------------------------------------------------------------------- + * Calculates window coefficients according to different apodization + * functions. + * + * OUT window[0,L-1] + * IN L (number of points in window) + */ +void FLAC__window_bartlett(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_bartlett_hann(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_blackman(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_blackman_harris_4term_92db_sidelobe(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_connes(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_flattop(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_gauss(FLAC__real *window, const FLAC__int32 L, const FLAC__real stddev); /* 0.0 < stddev <= 0.5 */ +void FLAC__window_hamming(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_hann(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_kaiser_bessel(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_nuttall(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_rectangle(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_triangle(FLAC__real *window, const FLAC__int32 L); +void FLAC__window_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p); +void FLAC__window_partial_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p, const FLAC__real start, const FLAC__real end); +void FLAC__window_punchout_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p, const FLAC__real start, const FLAC__real end); +void FLAC__window_welch(FLAC__real *window, const FLAC__int32 L); + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */ + +#endif diff --git a/src/libflac/protected/FLAC b/src/libflac/protected/FLAC new file mode 120000 index 0000000..90e9c10 --- /dev/null +++ b/src/libflac/protected/FLAC @@ -0,0 +1 @@ +../FLAC \ No newline at end of file diff --git a/src/libflac/protected/all.h b/src/libflac/protected/all.h new file mode 100644 index 0000000..9468bd3 --- /dev/null +++ b/src/libflac/protected/all.h @@ -0,0 +1,39 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PROTECTED__ALL_H +#define FLAC__PROTECTED__ALL_H + +#include "stream_decoder.h" +#include "stream_encoder.h" + +#endif diff --git a/src/libflac/protected/stream_decoder.h b/src/libflac/protected/stream_decoder.h new file mode 100644 index 0000000..5c31c16 --- /dev/null +++ b/src/libflac/protected/stream_decoder.h @@ -0,0 +1,60 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PROTECTED__STREAM_DECODER_H +#define FLAC__PROTECTED__STREAM_DECODER_H + +#include "FLAC/stream_decoder.h" +#if FLAC__HAS_OGG +#include "private/ogg_decoder_aspect.h" +#endif + +typedef struct FLAC__StreamDecoderProtected { + FLAC__StreamDecoderState state; + FLAC__StreamDecoderInitStatus initstate; + unsigned channels; + FLAC__ChannelAssignment channel_assignment; + unsigned bits_per_sample; + unsigned sample_rate; /* in Hz */ + unsigned blocksize; /* in samples (per channel) */ + FLAC__bool md5_checking; /* if true, generate MD5 signature of decoded data and compare against signature in the STREAMINFO metadata block */ +#if FLAC__HAS_OGG + FLAC__OggDecoderAspect ogg_decoder_aspect; +#endif +} FLAC__StreamDecoderProtected; + +/* + * return the number of input bytes consumed + */ +unsigned FLAC__stream_decoder_get_input_bytes_unconsumed(const FLAC__StreamDecoder *decoder); + +#endif diff --git a/src/libflac/protected/stream_encoder.h b/src/libflac/protected/stream_encoder.h new file mode 100644 index 0000000..8850c6b --- /dev/null +++ b/src/libflac/protected/stream_encoder.h @@ -0,0 +1,118 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2001-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__PROTECTED__STREAM_ENCODER_H +#define FLAC__PROTECTED__STREAM_ENCODER_H + +#include "FLAC/stream_encoder.h" +#if FLAC__HAS_OGG +#include "private/ogg_encoder_aspect.h" +#endif + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + +#include "private/float.h" + +#define FLAC__MAX_APODIZATION_FUNCTIONS 32 + +typedef enum { + FLAC__APODIZATION_BARTLETT, + FLAC__APODIZATION_BARTLETT_HANN, + FLAC__APODIZATION_BLACKMAN, + FLAC__APODIZATION_BLACKMAN_HARRIS_4TERM_92DB_SIDELOBE, + FLAC__APODIZATION_CONNES, + FLAC__APODIZATION_FLATTOP, + FLAC__APODIZATION_GAUSS, + FLAC__APODIZATION_HAMMING, + FLAC__APODIZATION_HANN, + FLAC__APODIZATION_KAISER_BESSEL, + FLAC__APODIZATION_NUTTALL, + FLAC__APODIZATION_RECTANGLE, + FLAC__APODIZATION_TRIANGLE, + FLAC__APODIZATION_TUKEY, + FLAC__APODIZATION_PARTIAL_TUKEY, + FLAC__APODIZATION_PUNCHOUT_TUKEY, + FLAC__APODIZATION_WELCH +} FLAC__ApodizationFunction; + +typedef struct { + FLAC__ApodizationFunction type; + union { + struct { + FLAC__real stddev; + } gauss; + struct { + FLAC__real p; + } tukey; + struct { + FLAC__real p; + FLAC__real start; + FLAC__real end; + } multiple_tukey; + } parameters; +} FLAC__ApodizationSpecification; + +#endif // #ifndef FLAC__INTEGER_ONLY_LIBRARY + +typedef struct FLAC__StreamEncoderProtected { + FLAC__StreamEncoderState state; + FLAC__bool verify; + FLAC__bool streamable_subset; + FLAC__bool do_md5; + FLAC__bool do_mid_side_stereo; + FLAC__bool loose_mid_side_stereo; + unsigned channels; + unsigned bits_per_sample; + unsigned sample_rate; + unsigned blocksize; +#ifndef FLAC__INTEGER_ONLY_LIBRARY + unsigned num_apodizations; + FLAC__ApodizationSpecification apodizations[FLAC__MAX_APODIZATION_FUNCTIONS]; +#endif + unsigned max_lpc_order; + unsigned qlp_coeff_precision; + FLAC__bool do_qlp_coeff_prec_search; + FLAC__bool do_exhaustive_model_search; + FLAC__bool do_escape_coding; + unsigned min_residual_partition_order; + unsigned max_residual_partition_order; + unsigned rice_parameter_search_dist; + FLAC__uint64 total_samples_estimate; + FLAC__StreamMetadata **metadata; + unsigned num_metadata_blocks; + FLAC__uint64 streaminfo_offset, seektable_offset, audio_offset; +#if FLAC__HAS_OGG + FLAC__OggEncoderAspect ogg_encoder_aspect; +#endif +} FLAC__StreamEncoderProtected; + +#endif diff --git a/src/libflac/share/alloc.h b/src/libflac/share/alloc.h new file mode 100644 index 0000000..58ef1f1 --- /dev/null +++ b/src/libflac/share/alloc.h @@ -0,0 +1,219 @@ +/* alloc - Convenience routines for safely allocating memory + * Copyright (C) 2007-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +#ifndef FLAC__SHARE__ALLOC_H +#define FLAC__SHARE__ALLOC_H + +#ifdef HAVE_CONFIG_H +# include +#endif + +/* WATCHOUT: for c++ you may have to #define __STDC_LIMIT_MACROS 1 real early + * before #including this file, otherwise SIZE_MAX might not be defined + */ + +#include /* for SIZE_MAX */ +//#if HAVE_STDINT_H +#include /* for SIZE_MAX in case limits.h didn't get it */ +//#endif +#include /* for size_t, malloc(), etc */ +#include "compat.h" + +#ifndef SIZE_MAX +# ifndef SIZE_T_MAX +# ifdef _MSC_VER +# ifdef _WIN64 +# define SIZE_T_MAX FLAC__U64L(0xffffffffffffffff) +# else +# define SIZE_T_MAX 0xffffffff +# endif +# else +# error +# endif +# endif +# define SIZE_MAX SIZE_T_MAX +#endif + +/* avoid malloc()ing 0 bytes, see: + * https://www.securecoding.cert.org/confluence/display/seccode/MEM04-A.+Do+not+make+assumptions+about+the+result+of+allocating+0+bytes?focusedCommentId=5407003 +*/ +static inline void *safe_malloc_(size_t size) +{ + /* malloc(0) is undefined; FLAC src convention is to always allocate */ + if(!size) + size++; + return malloc(size); +} + +static inline void *safe_calloc_(size_t nmemb, size_t size) +{ + if(!nmemb || !size) + return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */ + return calloc(nmemb, size); +} + +/*@@@@ there's probably a better way to prevent overflows when allocating untrusted sums but this works for now */ + +static inline void *safe_malloc_add_2op_(size_t size1, size_t size2) +{ + size2 += size1; + if(size2 < size1) + return 0; + return safe_malloc_(size2); +} + +static inline void *safe_malloc_add_3op_(size_t size1, size_t size2, size_t size3) +{ + size2 += size1; + if(size2 < size1) + return 0; + size3 += size2; + if(size3 < size2) + return 0; + return safe_malloc_(size3); +} + +static inline void *safe_malloc_add_4op_(size_t size1, size_t size2, size_t size3, size_t size4) +{ + size2 += size1; + if(size2 < size1) + return 0; + size3 += size2; + if(size3 < size2) + return 0; + size4 += size3; + if(size4 < size3) + return 0; + return safe_malloc_(size4); +} + +void *safe_malloc_mul_2op_(size_t size1, size_t size2) ; + +static inline void *safe_malloc_mul_3op_(size_t size1, size_t size2, size_t size3) +{ + if(!size1 || !size2 || !size3) + return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */ + if(size1 > SIZE_MAX / size2) + return 0; + size1 *= size2; + if(size1 > SIZE_MAX / size3) + return 0; + return malloc(size1*size3); +} + +/* size1*size2 + size3 */ +static inline void *safe_malloc_mul2add_(size_t size1, size_t size2, size_t size3) +{ + if(!size1 || !size2) + return safe_malloc_(size3); + if(size1 > SIZE_MAX / size2) + return 0; + return safe_malloc_add_2op_(size1*size2, size3); +} + +/* size1 * (size2 + size3) */ +static inline void *safe_malloc_muladd2_(size_t size1, size_t size2, size_t size3) +{ + if(!size1 || (!size2 && !size3)) + return malloc(1); /* malloc(0) is undefined; FLAC src convention is to always allocate */ + size2 += size3; + if(size2 < size3) + return 0; + if(size1 > SIZE_MAX / size2) + return 0; + return malloc(size1*size2); +} + +static inline void *safe_realloc_(void *ptr, size_t size) +{ + void *oldptr = ptr; + void *newptr = realloc(ptr, size); + if(size > 0 && newptr == 0) + free(oldptr); + return newptr; +} +static inline void *safe_realloc_add_2op_(void *ptr, size_t size1, size_t size2) +{ + size2 += size1; + if(size2 < size1) { + free(ptr); + return 0; + } + return realloc(ptr, size2); +} + +static inline void *safe_realloc_add_3op_(void *ptr, size_t size1, size_t size2, size_t size3) +{ + size2 += size1; + if(size2 < size1) + return 0; + size3 += size2; + if(size3 < size2) + return 0; + return realloc(ptr, size3); +} + +static inline void *safe_realloc_add_4op_(void *ptr, size_t size1, size_t size2, size_t size3, size_t size4) +{ + size2 += size1; + if(size2 < size1) + return 0; + size3 += size2; + if(size3 < size2) + return 0; + size4 += size3; + if(size4 < size3) + return 0; + return realloc(ptr, size4); +} + +static inline void *safe_realloc_mul_2op_(void *ptr, size_t size1, size_t size2) +{ + if(!size1 || !size2) + return realloc(ptr, 0); /* preserve POSIX realloc(ptr, 0) semantics */ + if(size1 > SIZE_MAX / size2) + return 0; + return safe_realloc_(ptr, size1*size2); +} + +/* size1 * (size2 + size3) */ +static inline void *safe_realloc_muladd2_(void *ptr, size_t size1, size_t size2, size_t size3) +{ + if(!size1 || (!size2 && !size3)) + return realloc(ptr, 0); /* preserve POSIX realloc(ptr, 0) semantics */ + size2 += size3; + if(size2 < size3) + return 0; + return safe_realloc_mul_2op_(ptr, size1, size2); +} + +#endif diff --git a/src/libflac/share/compat.h b/src/libflac/share/compat.h new file mode 100644 index 0000000..2083f3a --- /dev/null +++ b/src/libflac/share/compat.h @@ -0,0 +1,209 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2012-2016 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. + */ + +/* This is the prefered location of all CPP hackery to make $random_compiler + * work like something approaching a C99 (or maybe more accurately GNU99) + * compiler. + * + * It is assumed that this header will be included after "config.h". + */ + +#ifndef FLAC__SHARE__COMPAT_H +#define FLAC__SHARE__COMPAT_H + +#if defined _WIN32 && !defined __CYGWIN__ +/* where MSVC puts unlink() */ +# include +#else +# include +#endif + +#if defined _MSC_VER || defined __BORLANDC__ || defined __MINGW32__ +#include /* for off_t */ +#define FLAC__off_t __int64 /* use this instead of off_t to fix the 2 GB limit */ +#if !defined __MINGW32__ +#define fseeko _fseeki64 +#define ftello _ftelli64 +#else /* MinGW */ +#if !defined(HAVE_FSEEKO) +#define fseeko fseeko64 +#define ftello ftello64 +#endif +#endif +#else +#define FLAC__off_t off_t +#endif + +#if HAVE_INTTYPES_H +#define __STDC_FORMAT_MACROS +#include +#endif + +#if defined(_MSC_VER) +#define strtoll _strtoi64 +#define strtoull _strtoui64 +#endif + +#if defined(_MSC_VER) +#define inline __inline +#endif + +#if defined __INTEL_COMPILER || (defined _MSC_VER && defined _WIN64) +/* MSVS generates VERY slow 32-bit code with __restrict */ +#define flac_restrict __restrict +#elif defined __GNUC__ +#define flac_restrict __restrict__ +#else +#define flac_restrict +#endif + +#define FLAC__U64L(x) x##ULL + +#if defined _MSC_VER || defined __MINGW32__ +#define FLAC__STRCASECMP _stricmp +#define FLAC__STRNCASECMP _strnicmp +#elif defined __BORLANDC__ +#define FLAC__STRCASECMP stricmp +#define FLAC__STRNCASECMP strnicmp +#else +#define FLAC__STRCASECMP strcasecmp +#define FLAC__STRNCASECMP strncasecmp +#endif + +#if defined _MSC_VER || defined __MINGW32__ || defined __CYGWIN__ || defined __EMX__ +#include /* for _setmode(), chmod() */ +#include /* for _O_BINARY */ +#else +#include /* for chown(), unlink() */ +#endif + +#if defined _MSC_VER || defined __BORLANDC__ || defined __MINGW32__ +#if defined __BORLANDC__ +#include /* for utime() */ +#else +#include /* for utime() */ +#endif +#else +#include /* some flavors of BSD (like OS X) require this to get time_t */ +#include /* for utime() */ +#endif + +#if defined _MSC_VER +# if _MSC_VER >= 1800 +# include +# elif _MSC_VER >= 1600 +/* Visual Studio 2010 has decent C99 support */ +# include +# define PRIu64 "llu" +# define PRId64 "lld" +# define PRIx64 "llx" +# else +# include +# ifndef UINT32_MAX +# define UINT32_MAX _UI32_MAX +# endif + typedef unsigned __int64 uint64_t; + typedef unsigned __int32 uint32_t; + typedef unsigned __int16 uint16_t; + typedef unsigned __int8 uint8_t; + typedef __int64 int64_t; + typedef __int32 int32_t; + typedef __int16 int16_t; + typedef __int8 int8_t; +# define PRIu64 "I64u" +# define PRId64 "I64d" +# define PRIx64 "I64x" +# endif +#endif /* defined _MSC_VER */ + +#ifdef _WIN32 +/* All char* strings are in UTF-8 format. Added to support Unicode files on Windows */ + +#include "share/win_utf8_io.h" +#define flac_printf printf_utf8 +#define flac_fprintf fprintf_utf8 +#define flac_vfprintf vfprintf_utf8 + +#include "share/windows_unicode_filenames.h" +#define flac_fopen flac_internal_fopen_utf8 +#define flac_chmod flac_internal_chmod_utf8 +#define flac_utime flac_internal_utime_utf8 +#define flac_unlink flac_internal_unlink_utf8 +#define flac_rename flac_internal_rename_utf8 +#define flac_stat flac_internal_stat64_utf8 + +#else + +#define flac_printf printf +#define flac_fprintf fprintf +#define flac_vfprintf vfprintf + +#define flac_fopen fopen +#define flac_chmod chmod +#define flac_utime utime +#define flac_unlink unlink +#define flac_rename rename +#define flac_stat stat + +#endif + +#ifdef _WIN32 +#define flac_stat_s __stat64 /* stat struct */ +#define flac_fstat _fstat64 +#else +#define flac_stat_s stat /* stat struct */ +#define flac_fstat fstat +#endif + +#ifndef M_LN2 +#define M_LN2 0.69314718055994530942 +#endif +#ifndef M_PI +#define M_PI 3.14159265358979323846 +#endif + +/* FLAC needs to compile and work correctly on systems with a normal ISO C99 + * snprintf as well as Microsoft Visual Studio which has an non-standards + * conformant snprint_s function. + * + * This function wraps the MS version to behave more like the ISO version. + */ +#include +#ifdef __cplusplus +extern "C" { +#endif +int flac_snprintf(char *str, size_t size, const char *fmt, ...); +int flac_vsnprintf(char *str, size_t size, const char *fmt, va_list va); +#ifdef __cplusplus +}; +#endif + +#endif /* FLAC__SHARE__COMPAT_H */ diff --git a/src/libflac/share/endswap.h b/src/libflac/share/endswap.h new file mode 100644 index 0000000..9088a74 --- /dev/null +++ b/src/libflac/share/endswap.h @@ -0,0 +1,84 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2012-2016 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. + */ + +/* It is assumed that this header will be included after "config.h". */ + +#if HAVE_BSWAP32 /* GCC and Clang */ + +/* GCC prior to 4.8 didn't provide bswap16 on x86_64 */ +#if ! HAVE_BSWAP16 +static inline unsigned short __builtin_bswap16(unsigned short a) +{ + return (a<<8)|(a>>8); +} +#endif + +#define ENDSWAP_16(x) (__builtin_bswap16 (x)) +#define ENDSWAP_32(x) (__builtin_bswap32 (x)) +#define ENDSWAP_64(x) (__builtin_bswap64 (x)) + +#elif defined _MSC_VER /* Windows */ + +#include + +#define ENDSWAP_16(x) (_byteswap_ushort (x)) +#define ENDSWAP_32(x) (_byteswap_ulong (x)) +#define ENDSWAP_64(x) (_byteswap_uint64 (x)) + +#elif defined HAVE_BYTESWAP_H /* Linux */ + +#include + +#define ENDSWAP_16(x) (bswap_16 (x)) +#define ENDSWAP_32(x) (bswap_32 (x)) +#define ENDSWAP_64(x) (bswap_64 (x)) + +#else + +#define ENDSWAP_16(x) ((((x) >> 8) & 0xFF) | (((x) & 0xFF) << 8)) +#define ENDSWAP_32(x) ((((x) >> 24) & 0xFF) | (((x) >> 8) & 0xFF00) | (((x) & 0xFF00) << 8) | (((x) & 0xFF) << 24)) +#define ENDSWAP_64(x) ((ENDSWAP_32(((x) >> 32) & 0xFFFFFFFF)) | (ENDSWAP_32((x) & 0xFFFFFFFF) << 32)) + +#endif + + +/* Host to little-endian byte swapping (for MD5 calculation) */ +#if CPU_IS_BIG_ENDIAN + +#define H2LE_16(x) ENDSWAP_16 (x) +#define H2LE_32(x) ENDSWAP_32 (x) + +#else + +#define H2LE_16(x) (x) +#define H2LE_32(x) (x) + +#endif diff --git a/src/libflac/share/getopt.h b/src/libflac/share/getopt.h new file mode 100644 index 0000000..66aced0 --- /dev/null +++ b/src/libflac/share/getopt.h @@ -0,0 +1,184 @@ +/* + NOTE: + I cannot get the vanilla getopt code to work (i.e. compile only what + is needed and not duplicate symbols found in the standard library) + on all the platforms that FLAC supports. In particular the gating + of code with the ELIDE_CODE #define is not accurate enough on systems + that are POSIX but not glibc. If someone has a patch that works on + GNU/Linux, Darwin, AND Solaris please submit it on the project page: + https://sourceforge.net/p/flac/patches/ + + In the meantime I have munged the global symbols and removed gates + around code, while at the same time trying to touch the original as + little as possible. +*/ +/* 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., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. */ + +#ifndef SHARE__GETOPT_H +#define SHARE__GETOPT_H + +/*[JEC] was:#ifndef __need_getopt*/ +/*[JEC] was:# define _GETOPT_H 1*/ +/*[JEC] was:#endif*/ + +#ifdef __cplusplus +extern "C" { +#endif + +/* For communication from `share__getopt' to the caller. + When `share__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 *share__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 `share__getopt'. + + On entry to `share__getopt', zero means this is the first call; initialize. + + When `share__getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `share__optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +extern int share__optind; + +/* Callers store zero here to inhibit the error message `share__getopt' prints + for unrecognized options. */ + +extern int share__opterr; + +/* Set to an option character which was unrecognized. */ + +extern int share__optopt; + +/*[JEC] was:#ifndef __need_getopt */ +/* Describe the long-named options requested by the application. + The LONG_OPTIONS argument to share__getopt_long or share__getopt_long_only is a vector + of `struct share__option' terminated by an element containing a name which is + zero. + + The field `has_arg' is: + share__no_argument (or 0) if the option does not take an argument, + share__required_argument (or 1) if the option requires an argument, + share__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 `share__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, `share__getopt' + returns the contents of the `val' field. */ + +struct share__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 share__option'. */ + +# define share__no_argument 0 +# define share__required_argument 1 +# define share__optional_argument 2 +/*[JEC] was:#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, `share__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 `share__optarg'. + + If a letter in OPTS is followed by two colons, its argument is + optional. This behavior is specific to the GNU `share__getopt'. + + The argument `--' causes premature termination of argument + scanning, explicitly telling `share__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 + `share__getopt'. */ + +/*[JEC] was:#if defined __STDC__ && __STDC__*/ +/*[JEC] was:# 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 share__getopt (int argc, char *const *argv, const char *shortopts); +/*[JEC] was:# else*/ /* not __GNU_LIBRARY__ */ +/*[JEC] was:extern int getopt ();*/ +/*[JEC] was:# endif*/ /* __GNU_LIBRARY__ */ + +/*[JEC] was:# ifndef __need_getopt*/ +extern int share__getopt_long (int argc, char *const *argv, const char *shortopts, + const struct share__option *longopts, int *longind); +extern int share__getopt_long_only (int argc, char *const *argv, + const char *shortopts, + const struct share__option *longopts, int *longind); + +/* Internal only. Users should not call this directly. */ +extern int share___getopt_internal (int argc, char *const *argv, + const char *shortopts, + const struct share__option *longopts, int *longind, + int long_only); +/*[JEC] was:# endif*/ +/*[JEC] was:#else*/ /* not __STDC__ */ +/*[JEC] was:extern int getopt ();*/ +/*[JEC] was:# ifndef __need_getopt*/ +/*[JEC] was:extern int getopt_long ();*/ +/*[JEC] was:extern int getopt_long_only ();*/ + +/*[JEC] was:extern int _getopt_internal ();*/ +/*[JEC] was:# endif*/ +/*[JEC] was:#endif*/ /* __STDC__ */ + +#ifdef __cplusplus +} +#endif + +/* Make sure we later can get all the definitions and declarations. */ +/*[JEC] was:#undef __need_getopt*/ + +#endif /* getopt.h */ diff --git a/src/libflac/share/grabbag.h b/src/libflac/share/grabbag.h new file mode 100644 index 0000000..92ec998 --- /dev/null +++ b/src/libflac/share/grabbag.h @@ -0,0 +1,30 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef SHARE__GRABBAG_H +#define SHARE__GRABBAG_H + +/* These can't be included by themselves, only from within grabbag.h */ +#include "grabbag/cuesheet.h" +#include "grabbag/file.h" +#include "grabbag/picture.h" +#include "grabbag/replaygain.h" +#include "grabbag/seektable.h" + +#endif diff --git a/src/libflac/share/grabbag/Makefile.am b/src/libflac/share/grabbag/Makefile.am new file mode 100644 index 0000000..22baa15 --- /dev/null +++ b/src/libflac/share/grabbag/Makefile.am @@ -0,0 +1,8 @@ +## Process this file with automake to produce Makefile.in + +EXTRA_DIST = \ + cuesheet.h \ + file.h \ + picture.h \ + replaygain.h \ + seektable.h diff --git a/src/libflac/share/grabbag/Makefile.in b/src/libflac/share/grabbag/Makefile.in new file mode 100644 index 0000000..ae8363d --- /dev/null +++ b/src/libflac/share/grabbag/Makefile.in @@ -0,0 +1,486 @@ +# Makefile.in generated by automake 1.15 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2014 Free Software Foundation, Inc. + +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +am__is_gnu_make = { \ + if test -z '$(MAKELEVEL)'; then \ + false; \ + elif test -n '$(MAKE_HOST)'; then \ + true; \ + elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \ + true; \ + else \ + false; \ + fi; \ +} +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = include/share/grabbag +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/add_cflags.m4 \ + $(top_srcdir)/m4/add_cxxflags.m4 $(top_srcdir)/m4/bswap.m4 \ + $(top_srcdir)/m4/clang.m4 $(top_srcdir)/m4/codeset.m4 \ + $(top_srcdir)/m4/gcc_version.m4 $(top_srcdir)/m4/iconv.m4 \ + $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ + $(top_srcdir)/m4/lib-prefix.m4 $(top_srcdir)/m4/libtool.m4 \ + $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ + $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ + $(top_srcdir)/m4/ogg.m4 $(top_srcdir)/m4/really_gcc.m4 \ + $(top_srcdir)/m4/stack_protect.m4 $(top_srcdir)/m4/xmms.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +am__DIST_COMMON = $(srcdir)/Makefile.in +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCAS = @CCAS@ +CCASDEPMODE = @CCASDEPMODE@ +CCASFLAGS = @CCASFLAGS@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DOCBOOK_TO_MAN = @DOCBOOK_TO_MAN@ +DOXYGEN = @DOXYGEN@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +ENABLE_64_BIT_WORDS = @ENABLE_64_BIT_WORDS@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +FLAC__HAS_OGG = @FLAC__HAS_OGG@ +FLAC__TEST_LEVEL = @FLAC__TEST_LEVEL@ +FLAC__TEST_WITH_VALGRIND = @FLAC__TEST_WITH_VALGRIND@ +GCC_MAJOR_VERSION = @GCC_MAJOR_VERSION@ +GCC_MINOR_VERSION = @GCC_MINOR_VERSION@ +GCC_VERSION = @GCC_VERSION@ +GREP = @GREP@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBICONV = @LIBICONV@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIB_CLOCK_GETTIME = @LIB_CLOCK_GETTIME@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBICONV = @LTLIBICONV@ +LTLIBOBJS = @LTLIBOBJS@ +LT_SYS_LIBRARY_PATH = @LT_SYS_LIBRARY_PATH@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MKDIR_P = @MKDIR_P@ +NASM = @NASM@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OBJ_FORMAT = @OBJ_FORMAT@ +OGG_CFLAGS = @OGG_CFLAGS@ +OGG_LIBS = @OGG_LIBS@ +OGG_PACKAGE = @OGG_PACKAGE@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +XMMS_CFLAGS = @XMMS_CFLAGS@ +XMMS_CONFIG = @XMMS_CONFIG@ +XMMS_DATA_DIR = @XMMS_DATA_DIR@ +XMMS_EFFECT_PLUGIN_DIR = @XMMS_EFFECT_PLUGIN_DIR@ +XMMS_GENERAL_PLUGIN_DIR = @XMMS_GENERAL_PLUGIN_DIR@ +XMMS_INPUT_PLUGIN_DIR = @XMMS_INPUT_PLUGIN_DIR@ +XMMS_LIBS = @XMMS_LIBS@ +XMMS_OUTPUT_PLUGIN_DIR = @XMMS_OUTPUT_PLUGIN_DIR@ +XMMS_PLUGIN_DIR = @XMMS_PLUGIN_DIR@ +XMMS_VERSION = @XMMS_VERSION@ +XMMS_VISUALIZATION_PLUGIN_DIR = @XMMS_VISUALIZATION_PLUGIN_DIR@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +runstatedir = @runstatedir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +EXTRA_DIST = \ + cuesheet.h \ + file.h \ + picture.h \ + replaygain.h \ + seektable.h + +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign include/share/grabbag/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign include/share/grabbag/Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +tags TAGS: + +ctags CTAGS: + +cscope cscopelist: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile +installdirs: +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + cscopelist-am ctags-am distclean distclean-generic \ + distclean-libtool distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + tags-am uninstall uninstall-am + +.PRECIOUS: Makefile + + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/src/libflac/share/grabbag/cuesheet.h b/src/libflac/share/grabbag/cuesheet.h new file mode 100644 index 0000000..b465ae6 --- /dev/null +++ b/src/libflac/share/grabbag/cuesheet.h @@ -0,0 +1,43 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +/* This .h cannot be included by itself; #include "share/grabbag.h" instead. */ + +#ifndef GRABBAG__CUESHEET_H +#define GRABBAG__CUESHEET_H + +#include +#include "FLAC/metadata.h" + +#ifdef __cplusplus +extern "C" { +#endif + +unsigned grabbag__cuesheet_msf_to_frame(unsigned minutes, unsigned seconds, unsigned frames); +void grabbag__cuesheet_frame_to_msf(unsigned frame, unsigned *minutes, unsigned *seconds, unsigned *frames); + +FLAC__StreamMetadata *grabbag__cuesheet_parse(FILE *file, const char **error_message, unsigned *last_line_read, unsigned sample_rate, FLAC__bool is_cdda, FLAC__uint64 lead_out_offset); + +void grabbag__cuesheet_emit(FILE *file, const FLAC__StreamMetadata *cuesheet, const char *file_reference); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/share/grabbag/file.h b/src/libflac/share/grabbag/file.h new file mode 100644 index 0000000..b3f4148 --- /dev/null +++ b/src/libflac/share/grabbag/file.h @@ -0,0 +1,65 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +/* Convenience routines for manipulating files */ + +/* This .h cannot be included by itself; #include "share/grabbag.h" instead. */ + +#ifndef GRABAG__FILE_H +#define GRABAG__FILE_H + +/* needed because of off_t */ +#ifdef HAVE_CONFIG_H +# include +#endif + +#include /* for off_t */ +#include /* for FILE */ +#include "FLAC/ordinals.h" +#include "share/compat.h" + +#ifdef __cplusplus +extern "C" { +#endif + +void grabbag__file_copy_metadata(const char *srcpath, const char *destpath); +FLAC__off_t grabbag__file_get_filesize(const char *srcpath); +const char *grabbag__file_get_basename(const char *srcpath); + +/* read_only == false means "make file writable by user" + * read_only == true means "make file read-only for everyone" + */ +FLAC__bool grabbag__file_change_stats(const char *filename, FLAC__bool read_only); + +/* returns true iff stat() succeeds for both files and they have the same device and inode. */ +/* on windows, uses GetFileInformationByHandle() to compare */ +FLAC__bool grabbag__file_are_same(const char *f1, const char *f2); + +/* attempts to make writable before unlinking */ +FLAC__bool grabbag__file_remove_file(const char *filename); + +/* these will forcibly set stdin/stdout to binary mode (for OSes that require it) */ +FILE *grabbag__file_get_binary_stdin(void); +FILE *grabbag__file_get_binary_stdout(void); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/share/grabbag/picture.h b/src/libflac/share/grabbag/picture.h new file mode 100644 index 0000000..ea308f1 --- /dev/null +++ b/src/libflac/share/grabbag/picture.h @@ -0,0 +1,54 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2006-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * 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., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + */ + +/* This .h cannot be included by itself; #include "share/grabbag.h" instead. */ + +#ifndef GRABBAG__PICTURE_H +#define GRABBAG__PICTURE_H + +#include "FLAC/metadata.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* spec should be of the form "[TYPE]|MIME_TYPE|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE", e.g. + * "|image/jpeg|||cover.jpg" + * "4|image/jpeg||300x300x24|backcover.jpg" + * "|image/png|description|300x300x24/71|cover.png" + * "-->|image/gif||300x300x24/71|http://blah.blah.blah/cover.gif" + * + * empty type means default to FLAC__STREAM_METADATA_PICTURE_TYPE_FRONT_COVER + * empty resolution spec means to get from the file (cannot get used with "-->" linked images) + * spec and error_message must not be NULL + */ +FLAC__StreamMetadata *grabbag__picture_parse_specification(const char *spec, const char **error_message); + +typedef struct PictureResolution +{ uint32_t width, height, depth, colors ; +} PictureResolution ; + +FLAC__StreamMetadata *grabbag__picture_from_specification(int type, const char *mime_type, const char * description, + const PictureResolution * res, const char * filepath, const char **error_message); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/share/grabbag/replaygain.h b/src/libflac/share/grabbag/replaygain.h new file mode 100644 index 0000000..faa3272 --- /dev/null +++ b/src/libflac/share/grabbag/replaygain.h @@ -0,0 +1,73 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +/* + * This wraps the replaygain_analysis lib, which is LGPL. This wrapper + * allows analysis of different input resolutions by automatically + * scaling the input signal + */ + +/* This .h cannot be included by itself; #include "share/grabbag.h" instead. */ + +#ifndef GRABBAG__REPLAYGAIN_H +#define GRABBAG__REPLAYGAIN_H + +#include "FLAC/metadata.h" + +#ifdef __cplusplus +extern "C" { +#endif + +extern const unsigned GRABBAG__REPLAYGAIN_MAX_TAG_SPACE_REQUIRED; + +extern const FLAC__byte * const GRABBAG__REPLAYGAIN_TAG_REFERENCE_LOUDNESS; /* = "REPLAYGAIN_REFERENCE_LOUDNESS" */ +extern const FLAC__byte * const GRABBAG__REPLAYGAIN_TAG_TITLE_GAIN; /* = "REPLAYGAIN_TRACK_GAIN" */ +extern const FLAC__byte * const GRABBAG__REPLAYGAIN_TAG_TITLE_PEAK; /* = "REPLAYGAIN_TRACK_PEAK" */ +extern const FLAC__byte * const GRABBAG__REPLAYGAIN_TAG_ALBUM_GAIN; /* = "REPLAYGAIN_ALBUM_GAIN" */ +extern const FLAC__byte * const GRABBAG__REPLAYGAIN_TAG_ALBUM_PEAK; /* = "REPLAYGAIN_ALBUM_PEAK" */ + +FLAC__bool grabbag__replaygain_is_valid_sample_frequency(unsigned sample_frequency); + +FLAC__bool grabbag__replaygain_init(unsigned sample_frequency); + +/* 'bps' must be valid for FLAC, i.e. >=4 and <= 32 */ +FLAC__bool grabbag__replaygain_analyze(const FLAC__int32 * const input[], FLAC__bool is_stereo, unsigned bps, unsigned samples); + +void grabbag__replaygain_get_album(float *gain, float *peak); +void grabbag__replaygain_get_title(float *gain, float *peak); + +/* These three functions return an error string on error, or NULL if successful */ +const char *grabbag__replaygain_analyze_file(const char *filename, float *title_gain, float *title_peak); +const char *grabbag__replaygain_store_to_vorbiscomment(FLAC__StreamMetadata *block, float album_gain, float album_peak, float title_gain, float title_peak); +const char *grabbag__replaygain_store_to_vorbiscomment_reference(FLAC__StreamMetadata *block); +const char *grabbag__replaygain_store_to_vorbiscomment_album(FLAC__StreamMetadata *block, float album_gain, float album_peak); +const char *grabbag__replaygain_store_to_vorbiscomment_title(FLAC__StreamMetadata *block, float title_gain, float title_peak); +const char *grabbag__replaygain_store_to_file(const char *filename, float album_gain, float album_peak, float title_gain, float title_peak, FLAC__bool preserve_modtime); +const char *grabbag__replaygain_store_to_file_reference(const char *filename, FLAC__bool preserve_modtime); +const char *grabbag__replaygain_store_to_file_album(const char *filename, float album_gain, float album_peak, FLAC__bool preserve_modtime); +const char *grabbag__replaygain_store_to_file_title(const char *filename, float title_gain, float title_peak, FLAC__bool preserve_modtime); + +FLAC__bool grabbag__replaygain_load_from_vorbiscomment(const FLAC__StreamMetadata *block, FLAC__bool album_mode, FLAC__bool strict, double *reference, double *gain, double *peak); +double grabbag__replaygain_compute_scale_factor(double peak, double gain, double preamp, FLAC__bool prevent_clipping); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/share/grabbag/seektable.h b/src/libflac/share/grabbag/seektable.h new file mode 100644 index 0000000..ac294a3 --- /dev/null +++ b/src/libflac/share/grabbag/seektable.h @@ -0,0 +1,39 @@ +/* grabbag - Convenience lib for various routines common to several tools + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +/* Convenience routines for working with seek tables */ + +/* This .h cannot be included by itself; #include "share/grabbag.h" instead. */ + +#ifndef GRABAG__SEEKTABLE_H +#define GRABAG__SEEKTABLE_H + +#include "FLAC/format.h" + +#ifdef __cplusplus +extern "C" { +#endif + +FLAC__bool grabbag__seektable_convert_specification_to_template(const char *spec, FLAC__bool only_explicit_placeholders, FLAC__uint64 total_samples_to_encode, unsigned sample_rate, FLAC__StreamMetadata *seektable_template, FLAC__bool *spec_has_real_points); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/libflac/share/macros.h b/src/libflac/share/macros.h new file mode 100644 index 0000000..20b3ea5 --- /dev/null +++ b/src/libflac/share/macros.h @@ -0,0 +1,45 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2013-2016 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. + */ + +#include + +/* FLAC_CHECK_RETURN : Check the return value of the provided function and + * print an error message if it fails (ie returns a value < 0). + * + * Ideally, a library should not print anything, but this macro is only used + * for things that extremely unlikely to fail, like `chown` to a previoulsy + * saved `uid`. + */ + +#define FLAC_CHECK_RETURN(x) \ + { if ((x) < 0) \ + fprintf (stderr, "%s : %s\n", #x, strerror (errno)) ; \ + } diff --git a/src/libflac/share/private.h b/src/libflac/share/private.h new file mode 100644 index 0000000..f7e3b85 --- /dev/null +++ b/src/libflac/share/private.h @@ -0,0 +1,45 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2013-2016 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. + */ + +#ifndef FLAC__SHARE__PRIVATE_H +#define FLAC__SHARE__PRIVATE_H + +/* + * Unpublished debug routines from libFLAC> This should not be used from any + * client code other than code shipped with the FLAC sources. + */ +FLAC_API FLAC__bool FLAC__stream_encoder_disable_constant_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value); +FLAC_API FLAC__bool FLAC__stream_encoder_disable_fixed_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value); +FLAC_API FLAC__bool FLAC__stream_encoder_disable_verbatim_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value); +FLAC_API FLAC__bool FLAC__stream_encoder_set_do_md5(FLAC__StreamEncoder *encoder, FLAC__bool value); +FLAC_API FLAC__bool FLAC__stream_encoder_get_do_md5(const FLAC__StreamEncoder *encoder); + +#endif /* FLAC__SHARE__PRIVATE_H */ diff --git a/src/libflac/share/replaygain_analysis.h b/src/libflac/share/replaygain_analysis.h new file mode 100644 index 0000000..f06a9b2 --- /dev/null +++ b/src/libflac/share/replaygain_analysis.h @@ -0,0 +1,59 @@ +/* + * ReplayGainAnalysis - analyzes input samples and give the recommended dB change + * Copyright (C) 2001 David Robinson and Glen Sawyer + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + * + * concept and filter values by David Robinson (David@Robinson.org) + * -- blame him if you think the idea is flawed + * coding by Glen Sawyer (glensawyer@hotmail.com) 442 N 700 E, Provo, UT 84606 USA + * -- blame him if you think this runs too slowly, or the coding is otherwise flawed + * minor cosmetic tweaks to integrate with FLAC by Josh Coalson + * + * For an explanation of the concepts and the basic algorithms involved, go to: + * http://www.replaygain.org/ + */ + +#ifndef GAIN_ANALYSIS_H +#define GAIN_ANALYSIS_H + +#include + +#define GAIN_NOT_ENOUGH_SAMPLES -24601 +#define GAIN_ANALYSIS_ERROR 0 +#define GAIN_ANALYSIS_OK 1 + +#define INIT_GAIN_ANALYSIS_ERROR 0 +#define INIT_GAIN_ANALYSIS_OK 1 + +#ifdef __cplusplus +extern "C" { +#endif + +typedef float flac_float_t; /* Type used for filtering */ + +extern flac_float_t ReplayGainReferenceLoudness; /* in dB SPL, currently == 89.0 */ + +int InitGainAnalysis ( long samplefreq ); +int ValidGainFrequency ( long samplefreq ); +int AnalyzeSamples ( const flac_float_t* left_samples, const flac_float_t* right_samples, size_t num_samples, int num_channels ); +flac_float_t GetTitleGain ( void ); +flac_float_t GetAlbumGain ( void ); + +#ifdef __cplusplus +} +#endif + +#endif /* GAIN_ANALYSIS_H */ diff --git a/src/libflac/share/replaygain_synthesis.h b/src/libflac/share/replaygain_synthesis.h new file mode 100644 index 0000000..5f4c3ff --- /dev/null +++ b/src/libflac/share/replaygain_synthesis.h @@ -0,0 +1,52 @@ +/* replaygain_synthesis - Routines for applying ReplayGain to a signal + * Copyright (C) 2002-2009 Josh Coalson + * Copyright (C) 2011-2016 Xiph.Org Foundation + * + * This 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. + * + * This 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 this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +#ifndef FLAC__SHARE__REPLAYGAIN_SYNTHESIS_H +#define FLAC__SHARE__REPLAYGAIN_SYNTHESIS_H + +#include /* for size_t */ +#include "FLAC/format.h" + +#define FLAC_SHARE__MAX_SUPPORTED_CHANNELS FLAC__MAX_CHANNELS + +typedef enum { + NOISE_SHAPING_NONE = 0, + NOISE_SHAPING_LOW = 1, + NOISE_SHAPING_MEDIUM = 2, + NOISE_SHAPING_HIGH = 3 +} NoiseShaping; + +typedef struct { + const float* FilterCoeff; + FLAC__uint64 Mask; + double Add; + float Dither; + float ErrorHistory [FLAC_SHARE__MAX_SUPPORTED_CHANNELS] [16]; /* 16th order Noise shaping */ + float DitherHistory [FLAC_SHARE__MAX_SUPPORTED_CHANNELS] [16]; + int LastRandomNumber [FLAC_SHARE__MAX_SUPPORTED_CHANNELS]; + unsigned LastHistoryIndex; + NoiseShaping ShapingType; +} DitherContext; + +void FLAC__replaygain_synthesis__init_dither_context(DitherContext *dither, int bits, int shapingtype); + +/* scale = (float) pow(10., (double)replaygain * 0.05); */ +size_t FLAC__replaygain_synthesis__apply_gain(FLAC__byte *data_out, FLAC__bool little_endian_data_out, FLAC__bool unsigned_data_out, const FLAC__int32 * const input[], unsigned wide_samples, unsigned channels, const unsigned source_bps, const unsigned target_bps, const double scale, const FLAC__bool hard_limit, FLAC__bool do_dithering, DitherContext *dither_context); + +#endif diff --git a/src/libflac/share/safe_str.h b/src/libflac/share/safe_str.h new file mode 100644 index 0000000..eb974c5 --- /dev/null +++ b/src/libflac/share/safe_str.h @@ -0,0 +1,69 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2013-2016 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. + */ + +/* Safe string handling functions to replace things like strcpy, strncpy, + * strcat, strncat etc. + * All of these functions guarantee a correctly NUL terminated string but + * the string may be truncated if the destination buffer was too short. + */ + +#ifndef FLAC__SHARE_SAFE_STR_H +#define FLAC__SHARE_SAFE_STR_H + +static inline char * +safe_strncat(char *dest, const char *src, size_t dest_size) +{ + char * ret; + + if (dest_size < 1) + return dest; + + ret = strncat(dest, src, dest_size - strlen (dest)); + dest [dest_size - 1] = 0; + + return ret; +} + +static inline char * +safe_strncpy(char *dest, const char *src, size_t dest_size) +{ + char * ret; + + if (dest_size < 1) + return dest; + + ret = strncpy(dest, src, dest_size); + dest [dest_size - 1] = 0; + + return ret; +} + +#endif /* FLAC__SHARE_SAFE_STR_H */ diff --git a/src/libflac/share/utf8.h b/src/libflac/share/utf8.h new file mode 100644 index 0000000..7d6650d --- /dev/null +++ b/src/libflac/share/utf8.h @@ -0,0 +1,25 @@ +#ifndef SHARE__UTF8_H +#define SHARE__UTF8_H + +/* + * Convert a string between UTF-8 and the locale's charset. + * Invalid bytes are replaced by '#', and characters that are + * not available in the target encoding are replaced by '?'. + * + * If the locale's charset is not set explicitly then it is + * obtained using nl_langinfo(CODESET), where available, the + * environment variable CHARSET, or assumed to be US-ASCII. + * + * Return value of conversion functions: + * + * -1 : memory allocation failed + * 0 : data was converted exactly + * 1 : valid data was converted approximately (using '?') + * 2 : input was invalid (but still converted, using '#') + * 3 : unknown encoding (but still converted, using '?') + */ + +int utf8_encode(const char *from, char **to); +int utf8_decode(const char *from, char **to); + +#endif diff --git a/src/libflac/share/win_utf8_io.h b/src/libflac/share/win_utf8_io.h new file mode 100644 index 0000000..13fd118 --- /dev/null +++ b/src/libflac/share/win_utf8_io.h @@ -0,0 +1,58 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2013-2016 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. + */ + +#ifdef _WIN32 + +#ifndef flac__win_utf8_io_h +#define flac__win_utf8_io_h + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +size_t strlen_utf8(const char *str); +int win_get_console_width(void); + +int get_utf8_argv(int *argc, char ***argv); + +int printf_utf8(const char *format, ...); +int fprintf_utf8(FILE *stream, const char *format, ...); +int vfprintf_utf8(FILE *stream, const char *format, va_list argptr); + +#ifdef __cplusplus +} /* extern "C" */ +#endif + +#endif +#endif diff --git a/src/libflac/share/windows_unicode_filenames.h b/src/libflac/share/windows_unicode_filenames.h new file mode 100644 index 0000000..86820ca --- /dev/null +++ b/src/libflac/share/windows_unicode_filenames.h @@ -0,0 +1,67 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2013-2016 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. + */ + +#ifdef _WIN32 + +#ifndef flac__windows_unicode_filenames_h +#define flac__windows_unicode_filenames_h + +#include +#include +#include +#include "FLAC/ordinals.h" + +#ifdef __cplusplus +extern "C" { +#endif + +void flac_internal_set_utf8_filenames(FLAC__bool flag); +FLAC__bool flac_internal_get_utf8_filenames(void); +#define flac_set_utf8_filenames flac_internal_set_utf8_filenames +#define flac_get_utf8_filenames flac_internal_get_utf8_filenames + +FILE* flac_internal_fopen_utf8(const char *filename, const char *mode); +int flac_internal_stat64_utf8(const char *path, struct __stat64 *buffer); +int flac_internal_chmod_utf8(const char *filename, int pmode); +int flac_internal_utime_utf8(const char *filename, struct utimbuf *times); +int flac_internal_unlink_utf8(const char *filename); +int flac_internal_rename_utf8(const char *oldname, const char *newname); + +#include +HANDLE WINAPI flac_internal_CreateFile_utf8(const char *lpFileName, DWORD dwDesiredAccess, DWORD dwShareMode, LPSECURITY_ATTRIBUTES lpSecurityAttributes, DWORD dwCreationDisposition, DWORD dwFlagsAndAttributes, HANDLE hTemplateFile); +#define CreateFile_utf8 flac_internal_CreateFile_utf8 + +#ifdef __cplusplus +} /* extern "C" */ +#endif + +#endif +#endif diff --git a/src/libflac/stream_decoder.c b/src/libflac/stream_decoder.c new file mode 100644 index 0000000..479064c --- /dev/null +++ b/src/libflac/stream_decoder.c @@ -0,0 +1,3458 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2000-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include /* for malloc() */ +#include /* for memset/memcpy() */ +#include /* for stat() */ +#include /* for off_t */ +#include "share/compat.h" +#include "FLAC/assert.h" +#include "share/alloc.h" +#include "protected/stream_decoder.h" +#include "private/bitreader.h" +#include "private/bitmath.h" +#include "private/cpu.h" +#include "private/crc.h" +#include "private/fixed.h" +#include "private/format.h" +#include "private/lpc.h" +#include "private/md5.h" +#include "private/memory.h" +#include "private/macros.h" + + +/* technically this should be in an "export.c" but this is convenient enough */ +FLAC_API int FLAC_API_SUPPORTS_OGG_FLAC = FLAC__HAS_OGG; + + +/*********************************************************************** + * + * Private static data + * + ***********************************************************************/ + +static const FLAC__byte ID3V2_TAG_[3] = { 'I', 'D', '3' }; + +/*********************************************************************** + * + * Private class method prototypes + * + ***********************************************************************/ + +static void set_defaults_(FLAC__StreamDecoder *decoder); +static FILE *get_binary_stdin_(void); +static FLAC__bool allocate_output_(FLAC__StreamDecoder *decoder, unsigned size, unsigned channels); +static FLAC__bool has_id_filtered_(FLAC__StreamDecoder *decoder, FLAC__byte *id); +static FLAC__bool find_metadata_(FLAC__StreamDecoder *decoder); +static FLAC__bool read_metadata_(FLAC__StreamDecoder *decoder); +static FLAC__bool read_metadata_streaminfo_(FLAC__StreamDecoder *decoder, FLAC__bool is_last, unsigned length); +static FLAC__bool read_metadata_seektable_(FLAC__StreamDecoder *decoder, FLAC__bool is_last, unsigned length); +static FLAC__bool read_metadata_vorbiscomment_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_VorbisComment *obj, unsigned length); +static FLAC__bool read_metadata_cuesheet_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_CueSheet *obj); +static FLAC__bool read_metadata_picture_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_Picture *obj); +static FLAC__bool skip_id3v2_tag_(FLAC__StreamDecoder *decoder); +static FLAC__bool frame_sync_(FLAC__StreamDecoder *decoder); +static FLAC__bool read_frame_(FLAC__StreamDecoder *decoder, FLAC__bool *got_a_frame, FLAC__bool do_full_decode); +static FLAC__bool read_frame_header_(FLAC__StreamDecoder *decoder); +static FLAC__bool read_subframe_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode); +static FLAC__bool read_subframe_constant_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode); +static FLAC__bool read_subframe_fixed_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, const unsigned order, FLAC__bool do_full_decode); +static FLAC__bool read_subframe_lpc_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, const unsigned order, FLAC__bool do_full_decode); +static FLAC__bool read_subframe_verbatim_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode); +static FLAC__bool read_residual_partitioned_rice_(FLAC__StreamDecoder *decoder, unsigned predictor_order, unsigned partition_order, FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents, FLAC__int32 *residual, FLAC__bool is_extended); +static FLAC__bool read_zero_padding_(FLAC__StreamDecoder *decoder); +static FLAC__bool read_callback_(FLAC__byte buffer[], size_t *bytes, void *client_data); +#if FLAC__HAS_OGG +static FLAC__StreamDecoderReadStatus read_callback_ogg_aspect_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes); +static FLAC__OggDecoderAspectReadStatus read_callback_proxy_(const void *void_decoder, FLAC__byte buffer[], size_t *bytes, void *client_data); +#endif +static FLAC__StreamDecoderWriteStatus write_audio_frame_to_client_(FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[]); +static void send_error_to_client_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status); +static FLAC__bool seek_to_absolute_sample_(FLAC__StreamDecoder *decoder, FLAC__uint64 stream_length, FLAC__uint64 target_sample); +#if FLAC__HAS_OGG +static FLAC__bool seek_to_absolute_sample_ogg_(FLAC__StreamDecoder *decoder, FLAC__uint64 stream_length, FLAC__uint64 target_sample); +#endif +static FLAC__StreamDecoderReadStatus file_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data); +static FLAC__StreamDecoderSeekStatus file_seek_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data); +static FLAC__StreamDecoderTellStatus file_tell_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data); +static FLAC__StreamDecoderLengthStatus file_length_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length, void *client_data); +static FLAC__bool file_eof_callback_(const FLAC__StreamDecoder *decoder, void *client_data); + +/*********************************************************************** + * + * Private class data + * + ***********************************************************************/ + +typedef struct FLAC__StreamDecoderPrivate { + FLAC__bool is_ogg; + FLAC__StreamDecoderReadCallback read_callback; + FLAC__StreamDecoderSeekCallback seek_callback; + FLAC__StreamDecoderTellCallback tell_callback; + FLAC__StreamDecoderLengthCallback length_callback; + FLAC__StreamDecoderEofCallback eof_callback; + FLAC__StreamDecoderWriteCallback write_callback; + FLAC__StreamDecoderMetadataCallback metadata_callback; + FLAC__StreamDecoderErrorCallback error_callback; + /* generic 32-bit datapath: */ + void (*local_lpc_restore_signal)(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); + /* generic 64-bit datapath: */ + void (*local_lpc_restore_signal_64bit)(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); + /* for use when the signal is <= 16 bits-per-sample, or <= 15 bits-per-sample on a side channel (which requires 1 extra bit): */ + void (*local_lpc_restore_signal_16bit)(const FLAC__int32 residual[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 data[]); + void *client_data; + FILE *file; /* only used if FLAC__stream_decoder_init_file()/FLAC__stream_decoder_init_file() called, else NULL */ + FLAC__BitReader *input; + FLAC__int32 *output[FLAC__MAX_CHANNELS]; + FLAC__int32 *residual[FLAC__MAX_CHANNELS]; /* WATCHOUT: these are the aligned pointers; the real pointers that should be free()'d are residual_unaligned[] below */ + FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents[FLAC__MAX_CHANNELS]; + unsigned output_capacity, output_channels; + FLAC__uint32 fixed_block_size, next_fixed_block_size; + FLAC__uint64 samples_decoded; + FLAC__bool has_stream_info, has_seek_table; + FLAC__StreamMetadata stream_info; + FLAC__StreamMetadata seek_table; + FLAC__bool metadata_filter[128]; /* MAGIC number 128 == total number of metadata block types == 1 << 7 */ + FLAC__byte *metadata_filter_ids; + size_t metadata_filter_ids_count, metadata_filter_ids_capacity; /* units for both are IDs, not bytes */ + FLAC__Frame frame; + FLAC__bool cached; /* true if there is a byte in lookahead */ + FLAC__CPUInfo cpuinfo; + FLAC__byte header_warmup[2]; /* contains the sync code and reserved bits */ + FLAC__byte lookahead; /* temp storage when we need to look ahead one byte in the stream */ + /* unaligned (original) pointers to allocated data */ + FLAC__int32 *residual_unaligned[FLAC__MAX_CHANNELS]; + FLAC__bool do_md5_checking; /* initially gets protected_->md5_checking but is turned off after a seek or if the metadata has a zero MD5 */ + FLAC__bool internal_reset_hack; /* used only during init() so we can call reset to set up the decoder without rewinding the input */ + FLAC__bool is_seeking; + FLAC__MD5Context md5context; + FLAC__byte computed_md5sum[16]; /* this is the sum we computed from the decoded data */ + /* (the rest of these are only used for seeking) */ + FLAC__Frame last_frame; /* holds the info of the last frame we seeked to */ + FLAC__uint64 first_frame_offset; /* hint to the seek routine of where in the stream the first audio frame starts */ + FLAC__uint64 target_sample; + unsigned unparseable_frame_count; /* used to tell whether we're decoding a future version of FLAC or just got a bad sync */ + FLAC__bool got_a_frame; /* hack needed in Ogg FLAC seek routine to check when process_single() actually writes a frame */ +} FLAC__StreamDecoderPrivate; + +/*********************************************************************** + * + * Public static class data + * + ***********************************************************************/ + +FLAC_API const char FLAC__StreamDecoderStateString[][48] = { + "FLAC__STREAM_DECODER_SEARCH_FOR_METADATA", + "FLAC__STREAM_DECODER_READ_METADATA", + "FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC", + "FLAC__STREAM_DECODER_READ_FRAME", + "FLAC__STREAM_DECODER_END_OF_STREAM", + "FLAC__STREAM_DECODER_OGG_ERROR", + "FLAC__STREAM_DECODER_SEEK_ERROR", + "FLAC__STREAM_DECODER_ABORTED", + "FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR", + "FLAC__STREAM_DECODER_UNINITIALIZED" +}; + +FLAC_API const char FLAC__StreamDecoderInitStatusString[][64] = { + "FLAC__STREAM_DECODER_INIT_STATUS_OK", + "FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER", + "FLAC__STREAM_DECODER_INIT_STATUS_INVALID_CALLBACKS", + "FLAC__STREAM_DECODER_INIT_STATUS_MEMORY_ALLOCATION_ERROR", + "FLAC__STREAM_DECODER_INIT_STATUS_ERROR_OPENING_FILE", + "FLAC__STREAM_DECODER_INIT_STATUS_ALREADY_INITIALIZED" +}; + +FLAC_API const char FLAC__StreamDecoderReadStatusString[][48] = { + "FLAC__STREAM_DECODER_READ_STATUS_CONTINUE", + "FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM", + "FLAC__STREAM_DECODER_READ_STATUS_ABORT" +}; + +FLAC_API const char FLAC__StreamDecoderSeekStatusString[][48] = { + "FLAC__STREAM_DECODER_SEEK_STATUS_OK", + "FLAC__STREAM_DECODER_SEEK_STATUS_ERROR", + "FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED" +}; + +FLAC_API const char FLAC__StreamDecoderTellStatusString[][48] = { + "FLAC__STREAM_DECODER_TELL_STATUS_OK", + "FLAC__STREAM_DECODER_TELL_STATUS_ERROR", + "FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED" +}; + +FLAC_API const char FLAC__StreamDecoderLengthStatusString[][48] = { + "FLAC__STREAM_DECODER_LENGTH_STATUS_OK", + "FLAC__STREAM_DECODER_LENGTH_STATUS_ERROR", + "FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED" +}; + +FLAC_API const char FLAC__StreamDecoderWriteStatusString[][48] = { + "FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE", + "FLAC__STREAM_DECODER_WRITE_STATUS_ABORT" +}; + +FLAC_API const char FLAC__StreamDecoderErrorStatusString[][64] = { + "FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC", + "FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER", + "FLAC__STREAM_DECODER_ERROR_STATUS_FRAME_CRC_MISMATCH", + "FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM" +}; + +/*********************************************************************** + * + * Class constructor/destructor + * + ***********************************************************************/ +FLAC_API FLAC__StreamDecoder *FLAC__stream_decoder_new(void) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__StreamDecoder *decoder; + unsigned i; + + FLAC__ASSERT(sizeof(int) >= 4); /* we want to die right away if this is not true */ + + decoder = calloc(1, sizeof(FLAC__StreamDecoder)); + if(decoder == 0) { + return 0; + } + + decoder->protected_ = calloc(1, sizeof(FLAC__StreamDecoderProtected)); + if(decoder->protected_ == 0) { + free(decoder); + return 0; + } + + decoder->private_ = calloc(1, sizeof(FLAC__StreamDecoderPrivate)); + if(decoder->private_ == 0) { + free(decoder->protected_); + free(decoder); + return 0; + } + + decoder->private_->input = FLAC__bitreader_new(); + if(decoder->private_->input == 0) { + free(decoder->private_); + free(decoder->protected_); + free(decoder); + return 0; + } + + decoder->private_->metadata_filter_ids_capacity = 16; + if(0 == (decoder->private_->metadata_filter_ids = malloc((FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8) * decoder->private_->metadata_filter_ids_capacity))) { + FLAC__bitreader_delete(decoder->private_->input); + free(decoder->private_); + free(decoder->protected_); + free(decoder); + return 0; + } + + for(i = 0; i < FLAC__MAX_CHANNELS; i++) { + decoder->private_->output[i] = 0; + decoder->private_->residual_unaligned[i] = decoder->private_->residual[i] = 0; + } + + decoder->private_->output_capacity = 0; + decoder->private_->output_channels = 0; + decoder->private_->has_seek_table = false; + + for(i = 0; i < FLAC__MAX_CHANNELS; i++) + FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&decoder->private_->partitioned_rice_contents[i]); + + decoder->private_->file = 0; + + set_defaults_(decoder); + + decoder->protected_->state = FLAC__STREAM_DECODER_UNINITIALIZED; + + return decoder; +} + +FLAC_API void FLAC__stream_decoder_delete(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned i; + + if (decoder == NULL) + return ; + + FLAC__ASSERT(0 != decoder->protected_); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->private_->input); + + (void)FLAC__stream_decoder_finish(decoder); + + if(0 != decoder->private_->metadata_filter_ids) + free(decoder->private_->metadata_filter_ids); + + FLAC__bitreader_delete(decoder->private_->input); + + for(i = 0; i < FLAC__MAX_CHANNELS; i++) + FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&decoder->private_->partitioned_rice_contents[i]); + + free(decoder->private_); + free(decoder->protected_); + free(decoder); +} + +/*********************************************************************** + * + * Public class methods + * + ***********************************************************************/ + +static FLAC__StreamDecoderInitStatus init_stream_internal_( + FLAC__StreamDecoder *decoder, + FLAC__StreamDecoderReadCallback read_callback, + FLAC__StreamDecoderSeekCallback seek_callback, + FLAC__StreamDecoderTellCallback tell_callback, + FLAC__StreamDecoderLengthCallback length_callback, + FLAC__StreamDecoderEofCallback eof_callback, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data, + FLAC__bool is_ogg +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return FLAC__STREAM_DECODER_INIT_STATUS_ALREADY_INITIALIZED; + + if(FLAC__HAS_OGG == 0 && is_ogg) + return FLAC__STREAM_DECODER_INIT_STATUS_UNSUPPORTED_CONTAINER; + + if( + 0 == read_callback || + 0 == write_callback || + 0 == error_callback || + (seek_callback && (0 == tell_callback || 0 == length_callback || 0 == eof_callback)) + ) + return FLAC__STREAM_DECODER_INIT_STATUS_INVALID_CALLBACKS; + +#if FLAC__HAS_OGG + decoder->private_->is_ogg = is_ogg; + if(is_ogg && !FLAC__ogg_decoder_aspect_init(&decoder->protected_->ogg_decoder_aspect)) + return decoder->protected_->initstate = FLAC__STREAM_DECODER_INIT_STATUS_ERROR_OPENING_FILE; +#endif + + /* + * get the CPU info and set the function pointers + */ + FLAC__cpu_info(&decoder->private_->cpuinfo); + /* first default to the non-asm routines */ + decoder->private_->local_lpc_restore_signal = FLAC__lpc_restore_signal; + decoder->private_->local_lpc_restore_signal_64bit = FLAC__lpc_restore_signal_wide; + decoder->private_->local_lpc_restore_signal_16bit = FLAC__lpc_restore_signal; + /* now override with asm where appropriate */ +#ifndef FLAC__NO_ASM + if(decoder->private_->cpuinfo.use_asm) { +#ifdef FLAC__CPU_IA32 + FLAC__ASSERT(decoder->private_->cpuinfo.type == FLAC__CPUINFO_TYPE_IA32); +#ifdef FLAC__HAS_NASM + decoder->private_->local_lpc_restore_signal_64bit = FLAC__lpc_restore_signal_wide_asm_ia32; /* OPT_IA32: was really necessary for GCC < 4.9 */ + if(decoder->private_->cpuinfo.ia32.mmx) { + decoder->private_->local_lpc_restore_signal = FLAC__lpc_restore_signal_asm_ia32; + decoder->private_->local_lpc_restore_signal_16bit = FLAC__lpc_restore_signal_asm_ia32_mmx; + } + else { + decoder->private_->local_lpc_restore_signal = FLAC__lpc_restore_signal_asm_ia32; + decoder->private_->local_lpc_restore_signal_16bit = FLAC__lpc_restore_signal_asm_ia32; + } +#endif +#if FLAC__HAS_X86INTRIN && ! defined FLAC__INTEGER_ONLY_LIBRARY +# if defined FLAC__SSE2_SUPPORTED && !defined FLAC__HAS_NASM /* OPT_SSE: not better than MMX asm */ + if(decoder->private_->cpuinfo.ia32.sse2) { + decoder->private_->local_lpc_restore_signal_16bit = FLAC__lpc_restore_signal_16_intrin_sse2; + } +# endif +# if defined FLAC__SSE4_1_SUPPORTED + if(decoder->private_->cpuinfo.ia32.sse41) { + decoder->private_->local_lpc_restore_signal_64bit = FLAC__lpc_restore_signal_wide_intrin_sse41; + } +# endif +#endif +#elif defined FLAC__CPU_X86_64 + FLAC__ASSERT(decoder->private_->cpuinfo.type == FLAC__CPUINFO_TYPE_X86_64); + /* No useful SSE optimizations yet */ +#endif + } +#endif + + /* from here on, errors are fatal */ + + if(!FLAC__bitreader_init(decoder->private_->input, read_callback_, decoder)) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return FLAC__STREAM_DECODER_INIT_STATUS_MEMORY_ALLOCATION_ERROR; + } + + decoder->private_->read_callback = read_callback; + decoder->private_->seek_callback = seek_callback; + decoder->private_->tell_callback = tell_callback; + decoder->private_->length_callback = length_callback; + decoder->private_->eof_callback = eof_callback; + decoder->private_->write_callback = write_callback; + decoder->private_->metadata_callback = metadata_callback; + decoder->private_->error_callback = error_callback; + decoder->private_->client_data = client_data; + decoder->private_->fixed_block_size = decoder->private_->next_fixed_block_size = 0; + decoder->private_->samples_decoded = 0; + decoder->private_->has_stream_info = false; + decoder->private_->cached = false; + + decoder->private_->do_md5_checking = decoder->protected_->md5_checking; + decoder->private_->is_seeking = false; + + decoder->private_->internal_reset_hack = true; /* so the following reset does not try to rewind the input */ + if(!FLAC__stream_decoder_reset(decoder)) { + /* above call sets the state for us */ + return FLAC__STREAM_DECODER_INIT_STATUS_MEMORY_ALLOCATION_ERROR; + } + + return FLAC__STREAM_DECODER_INIT_STATUS_OK; +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_stream( + FLAC__StreamDecoder *decoder, + FLAC__StreamDecoderReadCallback read_callback, + FLAC__StreamDecoderSeekCallback seek_callback, + FLAC__StreamDecoderTellCallback tell_callback, + FLAC__StreamDecoderLengthCallback length_callback, + FLAC__StreamDecoderEofCallback eof_callback, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_stream_internal_( + decoder, + read_callback, + seek_callback, + tell_callback, + length_callback, + eof_callback, + write_callback, + metadata_callback, + error_callback, + client_data, + /*is_ogg=*/false + ); +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_stream( + FLAC__StreamDecoder *decoder, + FLAC__StreamDecoderReadCallback read_callback, + FLAC__StreamDecoderSeekCallback seek_callback, + FLAC__StreamDecoderTellCallback tell_callback, + FLAC__StreamDecoderLengthCallback length_callback, + FLAC__StreamDecoderEofCallback eof_callback, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_stream_internal_( + decoder, + read_callback, + seek_callback, + tell_callback, + length_callback, + eof_callback, + write_callback, + metadata_callback, + error_callback, + client_data, + /*is_ogg=*/true + ); +} + +static FLAC__StreamDecoderInitStatus init_FILE_internal_( + FLAC__StreamDecoder *decoder, + FILE *file, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data, + FLAC__bool is_ogg +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != file); + + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return decoder->protected_->initstate = FLAC__STREAM_DECODER_INIT_STATUS_ALREADY_INITIALIZED; + + if(0 == write_callback || 0 == error_callback) + return decoder->protected_->initstate = FLAC__STREAM_DECODER_INIT_STATUS_INVALID_CALLBACKS; + + /* + * To make sure that our file does not go unclosed after an error, we + * must assign the FILE pointer before any further error can occur in + * this routine. + */ + if(file == stdin) + file = get_binary_stdin_(); /* just to be safe */ + + decoder->private_->file = file; + + return init_stream_internal_( + decoder, + file_read_callback_, + decoder->private_->file == stdin? 0: file_seek_callback_, + decoder->private_->file == stdin? 0: file_tell_callback_, + decoder->private_->file == stdin? 0: file_length_callback_, + file_eof_callback_, + write_callback, + metadata_callback, + error_callback, + client_data, + is_ogg + ); +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_FILE( + FLAC__StreamDecoder *decoder, + FILE *file, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_FILE_internal_(decoder, file, write_callback, metadata_callback, error_callback, client_data, /*is_ogg=*/false); +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_FILE( + FLAC__StreamDecoder *decoder, + FILE *file, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_FILE_internal_(decoder, file, write_callback, metadata_callback, error_callback, client_data, /*is_ogg=*/true); +} + +static FLAC__StreamDecoderInitStatus init_file_internal_( + FLAC__StreamDecoder *decoder, + const char *filename, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data, + FLAC__bool is_ogg +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FILE *file; + + FLAC__ASSERT(0 != decoder); + + /* + * To make sure that our file does not go unclosed after an error, we + * have to do the same entrance checks here that are later performed + * in FLAC__stream_decoder_init_FILE() before the FILE* is assigned. + */ + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return decoder->protected_->initstate = FLAC__STREAM_DECODER_INIT_STATUS_ALREADY_INITIALIZED; + + if(0 == write_callback || 0 == error_callback) + return decoder->protected_->initstate = FLAC__STREAM_DECODER_INIT_STATUS_INVALID_CALLBACKS; + + file = filename? flac_fopen(filename, "rb") : stdin; + + if(0 == file) + return FLAC__STREAM_DECODER_INIT_STATUS_ERROR_OPENING_FILE; + + return init_FILE_internal_(decoder, file, write_callback, metadata_callback, error_callback, client_data, is_ogg); +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_file( + FLAC__StreamDecoder *decoder, + const char *filename, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_file_internal_(decoder, filename, write_callback, metadata_callback, error_callback, client_data, /*is_ogg=*/false); +} + +FLAC_API FLAC__StreamDecoderInitStatus FLAC__stream_decoder_init_ogg_file( + FLAC__StreamDecoder *decoder, + const char *filename, + FLAC__StreamDecoderWriteCallback write_callback, + FLAC__StreamDecoderMetadataCallback metadata_callback, + FLAC__StreamDecoderErrorCallback error_callback, + void *client_data +) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + return init_file_internal_(decoder, filename, write_callback, metadata_callback, error_callback, client_data, /*is_ogg=*/true); +} + +FLAC_API FLAC__bool FLAC__stream_decoder_finish(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__bool md5_failed = false; + unsigned i; + + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + + if(decoder->protected_->state == FLAC__STREAM_DECODER_UNINITIALIZED) + return true; + + /* see the comment in FLAC__stream_decoder_reset() as to why we + * always call FLAC__MD5Final() + */ + FLAC__MD5Final(decoder->private_->computed_md5sum, &decoder->private_->md5context); + + free(decoder->private_->seek_table.data.seek_table.points); + decoder->private_->seek_table.data.seek_table.points = 0; + decoder->private_->has_seek_table = false; + + FLAC__bitreader_free(decoder->private_->input); + for(i = 0; i < FLAC__MAX_CHANNELS; i++) { + /* WATCHOUT: + * FLAC__lpc_restore_signal_asm_ia32_mmx() requires that the + * output arrays have a buffer of up to 3 zeroes in front + * (at negative indices) for alignment purposes; we use 4 + * to keep the data well-aligned. + */ + if(0 != decoder->private_->output[i]) { + free(decoder->private_->output[i]-4); + decoder->private_->output[i] = 0; + } + if(0 != decoder->private_->residual_unaligned[i]) { + free(decoder->private_->residual_unaligned[i]); + decoder->private_->residual_unaligned[i] = decoder->private_->residual[i] = 0; + } + } + decoder->private_->output_capacity = 0; + decoder->private_->output_channels = 0; + +#if FLAC__HAS_OGG + if(decoder->private_->is_ogg) + FLAC__ogg_decoder_aspect_finish(&decoder->protected_->ogg_decoder_aspect); +#endif + + if(0 != decoder->private_->file) { + if(decoder->private_->file != stdin) + fclose(decoder->private_->file); + decoder->private_->file = 0; + } + + if(decoder->private_->do_md5_checking) { + if(memcmp(decoder->private_->stream_info.data.stream_info.md5sum, decoder->private_->computed_md5sum, 16)) + md5_failed = true; + } + decoder->private_->is_seeking = false; + + set_defaults_(decoder); + + decoder->protected_->state = FLAC__STREAM_DECODER_UNINITIALIZED; + + return !md5_failed; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_ogg_serial_number(FLAC__StreamDecoder *decoder, long value) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; +#if FLAC__HAS_OGG + /* can't check decoder->private_->is_ogg since that's not set until init time */ + FLAC__ogg_decoder_aspect_set_serial_number(&decoder->protected_->ogg_decoder_aspect, value); + return true; +#else + (void)value; + return false; +#endif +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_md5_checking(FLAC__StreamDecoder *decoder, FLAC__bool value) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + decoder->protected_->md5_checking = value; + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond(FLAC__StreamDecoder *decoder, FLAC__MetadataType type) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + FLAC__ASSERT((unsigned)type <= FLAC__MAX_METADATA_TYPE_CODE); + /* double protection */ + if((unsigned)type > FLAC__MAX_METADATA_TYPE_CODE) + return false; + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + decoder->private_->metadata_filter[type] = true; + if(type == FLAC__METADATA_TYPE_APPLICATION) + decoder->private_->metadata_filter_ids_count = 0; + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond_application(FLAC__StreamDecoder *decoder, const FLAC__byte id[4]) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + FLAC__ASSERT(0 != id); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + + if(decoder->private_->metadata_filter[FLAC__METADATA_TYPE_APPLICATION]) + return true; + + FLAC__ASSERT(0 != decoder->private_->metadata_filter_ids); + + if(decoder->private_->metadata_filter_ids_count == decoder->private_->metadata_filter_ids_capacity) { + if(0 == (decoder->private_->metadata_filter_ids = safe_realloc_mul_2op_(decoder->private_->metadata_filter_ids, decoder->private_->metadata_filter_ids_capacity, /*times*/2))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + decoder->private_->metadata_filter_ids_capacity *= 2; + } + + memcpy(decoder->private_->metadata_filter_ids + decoder->private_->metadata_filter_ids_count * (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8), id, (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8)); + decoder->private_->metadata_filter_ids_count++; + + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_respond_all(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned i; + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + for(i = 0; i < sizeof(decoder->private_->metadata_filter) / sizeof(decoder->private_->metadata_filter[0]); i++) + decoder->private_->metadata_filter[i] = true; + decoder->private_->metadata_filter_ids_count = 0; + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore(FLAC__StreamDecoder *decoder, FLAC__MetadataType type) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + FLAC__ASSERT((unsigned)type <= FLAC__MAX_METADATA_TYPE_CODE); + /* double protection */ + if((unsigned)type > FLAC__MAX_METADATA_TYPE_CODE) + return false; + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + decoder->private_->metadata_filter[type] = false; + if(type == FLAC__METADATA_TYPE_APPLICATION) + decoder->private_->metadata_filter_ids_count = 0; + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore_application(FLAC__StreamDecoder *decoder, const FLAC__byte id[4]) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + FLAC__ASSERT(0 != id); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + + if(!decoder->private_->metadata_filter[FLAC__METADATA_TYPE_APPLICATION]) + return true; + + FLAC__ASSERT(0 != decoder->private_->metadata_filter_ids); + + if(decoder->private_->metadata_filter_ids_count == decoder->private_->metadata_filter_ids_capacity) { + if(0 == (decoder->private_->metadata_filter_ids = safe_realloc_mul_2op_(decoder->private_->metadata_filter_ids, decoder->private_->metadata_filter_ids_capacity, /*times*/2))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + decoder->private_->metadata_filter_ids_capacity *= 2; + } + + memcpy(decoder->private_->metadata_filter_ids + decoder->private_->metadata_filter_ids_count * (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8), id, (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8)); + decoder->private_->metadata_filter_ids_count++; + + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_set_metadata_ignore_all(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + if(decoder->protected_->state != FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + memset(decoder->private_->metadata_filter, 0, sizeof(decoder->private_->metadata_filter)); + decoder->private_->metadata_filter_ids_count = 0; + return true; +} + +FLAC_API FLAC__StreamDecoderState FLAC__stream_decoder_get_state(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->state; +} + +FLAC_API const char *FLAC__stream_decoder_get_resolved_state_string(const FLAC__StreamDecoder *decoder) +{ + return &FLAC__StreamDecoderStateString[decoder->protected_->state][0]; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_get_md5_checking(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->md5_checking; +} + +FLAC_API FLAC__uint64 FLAC__stream_decoder_get_total_samples(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->private_->has_stream_info? decoder->private_->stream_info.data.stream_info.total_samples : 0; +} + +FLAC_API unsigned FLAC__stream_decoder_get_channels(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->channels; +} + +FLAC_API FLAC__ChannelAssignment FLAC__stream_decoder_get_channel_assignment(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->channel_assignment; +} + +FLAC_API unsigned FLAC__stream_decoder_get_bits_per_sample(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->bits_per_sample; +} + +FLAC_API unsigned FLAC__stream_decoder_get_sample_rate(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->sample_rate; +} + +FLAC_API unsigned FLAC__stream_decoder_get_blocksize(const FLAC__StreamDecoder *decoder) +{ + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + return decoder->protected_->blocksize; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_get_decode_position(const FLAC__StreamDecoder *decoder, FLAC__uint64 *position) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != position); + + if(FLAC__HAS_OGG && decoder->private_->is_ogg) + return false; + + if(0 == decoder->private_->tell_callback) + return false; + if(decoder->private_->tell_callback(decoder, position, decoder->private_->client_data) != FLAC__STREAM_DECODER_TELL_STATUS_OK) + return false; + /* should never happen since all FLAC frames and metadata blocks are byte aligned, but check just in case */ + if(!FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)) + return false; + FLAC__ASSERT(*position >= FLAC__stream_decoder_get_input_bytes_unconsumed(decoder)); + *position -= FLAC__stream_decoder_get_input_bytes_unconsumed(decoder); + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_flush(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + + if(!decoder->private_->internal_reset_hack && decoder->protected_->state == FLAC__STREAM_DECODER_UNINITIALIZED) + return false; + + decoder->private_->samples_decoded = 0; + decoder->private_->do_md5_checking = false; + +#if FLAC__HAS_OGG + if(decoder->private_->is_ogg) + FLAC__ogg_decoder_aspect_flush(&decoder->protected_->ogg_decoder_aspect); +#endif + + if(!FLAC__bitreader_clear(decoder->private_->input)) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_reset(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + FLAC__ASSERT(0 != decoder->protected_); + + if(!FLAC__stream_decoder_flush(decoder)) { + /* above call sets the state for us */ + return false; + } + +#if FLAC__HAS_OGG + /*@@@ could go in !internal_reset_hack block below */ + if(decoder->private_->is_ogg) + FLAC__ogg_decoder_aspect_reset(&decoder->protected_->ogg_decoder_aspect); +#endif + + /* Rewind if necessary. If FLAC__stream_decoder_init() is calling us, + * (internal_reset_hack) don't try to rewind since we are already at + * the beginning of the stream and don't want to fail if the input is + * not seekable. + */ + if(!decoder->private_->internal_reset_hack) { + if(decoder->private_->file == stdin) + return false; /* can't rewind stdin, reset fails */ + if(decoder->private_->seek_callback && decoder->private_->seek_callback(decoder, 0, decoder->private_->client_data) == FLAC__STREAM_DECODER_SEEK_STATUS_ERROR) + return false; /* seekable and seek fails, reset fails */ + } + else + decoder->private_->internal_reset_hack = false; + + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_METADATA; + + decoder->private_->has_stream_info = false; + + free(decoder->private_->seek_table.data.seek_table.points); + decoder->private_->seek_table.data.seek_table.points = 0; + decoder->private_->has_seek_table = false; + + decoder->private_->do_md5_checking = decoder->protected_->md5_checking; + /* + * This goes in reset() and not flush() because according to the spec, a + * fixed-blocksize stream must stay that way through the whole stream. + */ + decoder->private_->fixed_block_size = decoder->private_->next_fixed_block_size = 0; + + /* We initialize the FLAC__MD5Context even though we may never use it. This + * is because md5 checking may be turned on to start and then turned off if + * a seek occurs. So we init the context here and finalize it in + * FLAC__stream_decoder_finish() to make sure things are always cleaned up + * properly. + */ + FLAC__MD5Init(&decoder->private_->md5context); + + decoder->private_->first_frame_offset = 0; + decoder->private_->unparseable_frame_count = 0; + + return true; +} + +FLAC_API FLAC__bool FLAC__stream_decoder_process_single(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__bool got_a_frame; + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + + while(1) { + switch(decoder->protected_->state) { + case FLAC__STREAM_DECODER_SEARCH_FOR_METADATA: + if(!find_metadata_(decoder)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_METADATA: + if(!read_metadata_(decoder)) + return false; /* above function sets the status for us */ + else + return true; + case FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC: + if(!frame_sync_(decoder)) + return true; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_FRAME: + if(!read_frame_(decoder, &got_a_frame, /*do_full_decode=*/true)) + return false; /* above function sets the status for us */ + if(got_a_frame) + return true; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_END_OF_STREAM: + case FLAC__STREAM_DECODER_ABORTED: + return true; + default: + FLAC__ASSERT(0); + return false; + } + } +} + +FLAC_API FLAC__bool FLAC__stream_decoder_process_until_end_of_metadata(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + + while(1) { + switch(decoder->protected_->state) { + case FLAC__STREAM_DECODER_SEARCH_FOR_METADATA: + if(!find_metadata_(decoder)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_METADATA: + if(!read_metadata_(decoder)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC: + case FLAC__STREAM_DECODER_READ_FRAME: + case FLAC__STREAM_DECODER_END_OF_STREAM: + case FLAC__STREAM_DECODER_ABORTED: + return true; + default: + FLAC__ASSERT(0); + return false; + } + } +} + +FLAC_API FLAC__bool FLAC__stream_decoder_process_until_end_of_stream(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__bool dummy; + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + + while(1) { + switch(decoder->protected_->state) { + case FLAC__STREAM_DECODER_SEARCH_FOR_METADATA: + if(!find_metadata_(decoder)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_METADATA: + if(!read_metadata_(decoder)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC: + if(!frame_sync_(decoder)) + return true; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_FRAME: + if(!read_frame_(decoder, &dummy, /*do_full_decode=*/true)) + return false; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_END_OF_STREAM: + case FLAC__STREAM_DECODER_ABORTED: + return true; + default: + FLAC__ASSERT(0); + return false; + } + } +} + +FLAC_API FLAC__bool FLAC__stream_decoder_skip_single_frame(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__bool got_a_frame; + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->protected_); + + while(1) { + switch(decoder->protected_->state) { + case FLAC__STREAM_DECODER_SEARCH_FOR_METADATA: + case FLAC__STREAM_DECODER_READ_METADATA: + return false; /* above function sets the status for us */ + case FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC: + if(!frame_sync_(decoder)) + return true; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_READ_FRAME: + if(!read_frame_(decoder, &got_a_frame, /*do_full_decode=*/false)) + return false; /* above function sets the status for us */ + if(got_a_frame) + return true; /* above function sets the status for us */ + break; + case FLAC__STREAM_DECODER_END_OF_STREAM: + case FLAC__STREAM_DECODER_ABORTED: + return true; + default: + FLAC__ASSERT(0); + return false; + } + } +} + +FLAC_API FLAC__bool FLAC__stream_decoder_seek_absolute(FLAC__StreamDecoder *decoder, FLAC__uint64 sample) +{ + stack(__FUNCTION__, __FILE__, __LINE__); +FLAC__uint64 length; + + FLAC__ASSERT(0 != decoder); + + if( + decoder->protected_->state != FLAC__STREAM_DECODER_SEARCH_FOR_METADATA && + decoder->protected_->state != FLAC__STREAM_DECODER_READ_METADATA && + decoder->protected_->state != FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC && + decoder->protected_->state != FLAC__STREAM_DECODER_READ_FRAME && + decoder->protected_->state != FLAC__STREAM_DECODER_END_OF_STREAM + ) + return false; + + if(0 == decoder->private_->seek_callback) + return false; + + FLAC__ASSERT(decoder->private_->seek_callback); + FLAC__ASSERT(decoder->private_->tell_callback); + FLAC__ASSERT(decoder->private_->length_callback); + FLAC__ASSERT(decoder->private_->eof_callback); + + if(FLAC__stream_decoder_get_total_samples(decoder) > 0 && sample >= FLAC__stream_decoder_get_total_samples(decoder)) + return false; + + decoder->private_->is_seeking = true; + + /* turn off md5 checking if a seek is attempted */ + decoder->private_->do_md5_checking = false; + + /* get the file length (currently our algorithm needs to know the length so it's also an error to get FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED) */ + if(decoder->private_->length_callback(decoder, &length, decoder->private_->client_data) != FLAC__STREAM_DECODER_LENGTH_STATUS_OK) { + decoder->private_->is_seeking = false; + return false; + } + + /* if we haven't finished processing the metadata yet, do that so we have the STREAMINFO, SEEK_TABLE, and first_frame_offset */ + if( + decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_METADATA || + decoder->protected_->state == FLAC__STREAM_DECODER_READ_METADATA + ) { + if(!FLAC__stream_decoder_process_until_end_of_metadata(decoder)) { + /* above call sets the state for us */ + decoder->private_->is_seeking = false; + return false; + } + /* check this again in case we didn't know total_samples the first time */ + if(FLAC__stream_decoder_get_total_samples(decoder) > 0 && sample >= FLAC__stream_decoder_get_total_samples(decoder)) { + decoder->private_->is_seeking = false; + return false; + } + } + + { + const FLAC__bool ok = +#if FLAC__HAS_OGG + decoder->private_->is_ogg? + seek_to_absolute_sample_ogg_(decoder, length, sample) : +#endif + seek_to_absolute_sample_(decoder, length, sample) + ; + decoder->private_->is_seeking = false; + return ok; + } +} + +/*********************************************************************** + * + * Protected class methods + * + ***********************************************************************/ + +unsigned FLAC__stream_decoder_get_input_bytes_unconsumed(const FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + FLAC__ASSERT(!(FLAC__bitreader_get_input_bits_unconsumed(decoder->private_->input) & 7)); + return FLAC__bitreader_get_input_bits_unconsumed(decoder->private_->input) / 8; +} + +/*********************************************************************** + * + * Private class methods + * + ***********************************************************************/ + +void set_defaults_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + decoder->private_->is_ogg = false; + decoder->private_->read_callback = 0; + decoder->private_->seek_callback = 0; + decoder->private_->tell_callback = 0; + decoder->private_->length_callback = 0; + decoder->private_->eof_callback = 0; + decoder->private_->write_callback = 0; + decoder->private_->metadata_callback = 0; + decoder->private_->error_callback = 0; + decoder->private_->client_data = 0; + + memset(decoder->private_->metadata_filter, 0, sizeof(decoder->private_->metadata_filter)); + decoder->private_->metadata_filter[FLAC__METADATA_TYPE_STREAMINFO] = true; + decoder->private_->metadata_filter_ids_count = 0; + + decoder->protected_->md5_checking = false; + +#if FLAC__HAS_OGG + FLAC__ogg_decoder_aspect_set_defaults(&decoder->protected_->ogg_decoder_aspect); +#endif +} + +/* + * This will forcibly set stdin to binary mode (for OSes that require it) + */ +FILE *get_binary_stdin_(void) +{ + /* if something breaks here it is probably due to the presence or + * absence of an underscore before the identifiers 'setmode', + * 'fileno', and/or 'O_BINARY'; check your system header files. + */ +#if defined _MSC_VER || defined __MINGW32__ + _setmode(_fileno(stdin), _O_BINARY); +#elif defined __CYGWIN__ + /* almost certainly not needed for any modern Cygwin, but let's be safe... */ + setmode(_fileno(stdin), _O_BINARY); +#elif defined __EMX__ + setmode(fileno(stdin), O_BINARY); +#endif + + return stdin; +} + +FLAC__bool allocate_output_(FLAC__StreamDecoder *decoder, unsigned size, unsigned channels) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned i; + FLAC__int32 *tmp; + + if(size <= decoder->private_->output_capacity && channels <= decoder->private_->output_channels) + return true; + + /* simply using realloc() is not practical because the number of channels may change mid-stream */ + + for(i = 0; i < FLAC__MAX_CHANNELS; i++) { + if(0 != decoder->private_->output[i]) { + free(decoder->private_->output[i]-4); + decoder->private_->output[i] = 0; + } + if(0 != decoder->private_->residual_unaligned[i]) { + free(decoder->private_->residual_unaligned[i]); + decoder->private_->residual_unaligned[i] = decoder->private_->residual[i] = 0; + } + } + + for(i = 0; i < channels; i++) { + /* WATCHOUT: + * FLAC__lpc_restore_signal_asm_ia32_mmx() requires that the + * output arrays have a buffer of up to 3 zeroes in front + * (at negative indices) for alignment purposes; we use 4 + * to keep the data well-aligned. + */ + tmp = safe_malloc_muladd2_(sizeof(FLAC__int32), /*times (*/size, /*+*/4/*)*/); + if(tmp == 0) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + memset(tmp, 0, sizeof(FLAC__int32)*4); + decoder->private_->output[i] = tmp + 4; + + if(!FLAC__memory_alloc_aligned_int32_array(size, &decoder->private_->residual_unaligned[i], &decoder->private_->residual[i])) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + } + + decoder->private_->output_capacity = size; + decoder->private_->output_channels = channels; + + return true; +} + +FLAC__bool has_id_filtered_(FLAC__StreamDecoder *decoder, FLAC__byte *id) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + size_t i; + + FLAC__ASSERT(0 != decoder); + FLAC__ASSERT(0 != decoder->private_); + + for(i = 0; i < decoder->private_->metadata_filter_ids_count; i++) + if(0 == memcmp(decoder->private_->metadata_filter_ids + i * (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8), id, (FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8))) + return true; + + return false; +} + +FLAC__bool find_metadata_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + unsigned i, id; + FLAC__bool first = true; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + for(i = id = 0; i < 4; ) { + if(decoder->private_->cached) { + x = (FLAC__uint32)decoder->private_->lookahead; + decoder->private_->cached = false; + } + else { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + } + if(x == FLAC__STREAM_SYNC_STRING[i]) { + first = true; + i++; + id = 0; + continue; + } + + if(id >= 3) + return false; + + if(x == ID3V2_TAG_[id]) { + id++; + i = 0; + if(id == 3) { + if(!skip_id3v2_tag_(decoder)) + return false; /* skip_id3v2_tag_ sets the state for us */ + } + continue; + } + id = 0; + if(x == 0xff) { /* MAGIC NUMBER for the first 8 frame sync bits */ + decoder->private_->header_warmup[0] = (FLAC__byte)x; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + + /* we have to check if we just read two 0xff's in a row; the second may actually be the beginning of the sync code */ + /* else we have to check if the second byte is the end of a sync code */ + if(x == 0xff) { /* MAGIC NUMBER for the first 8 frame sync bits */ + decoder->private_->lookahead = (FLAC__byte)x; + decoder->private_->cached = true; + } + else if(x >> 1 == 0x7c) { /* MAGIC NUMBER for the last 6 sync bits and reserved 7th bit */ + decoder->private_->header_warmup[1] = (FLAC__byte)x; + decoder->protected_->state = FLAC__STREAM_DECODER_READ_FRAME; + return true; + } + } + i = 0; + if(first) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + first = false; + } + } + + decoder->protected_->state = FLAC__STREAM_DECODER_READ_METADATA; + return true; +} + +FLAC__bool read_metadata_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); +FLAC__bool is_last; + FLAC__uint32 i, x, type, length; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_IS_LAST_LEN)) + return false; /* read_callback_ sets the state for us */ + is_last = x? true : false; + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &type, FLAC__STREAM_METADATA_TYPE_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &length, FLAC__STREAM_METADATA_LENGTH_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(type == FLAC__METADATA_TYPE_STREAMINFO) { + if(!read_metadata_streaminfo_(decoder, is_last, length)) + return false; + + decoder->private_->has_stream_info = true; + if(0 == memcmp(decoder->private_->stream_info.data.stream_info.md5sum, "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0", 16)) + decoder->private_->do_md5_checking = false; + if(!decoder->private_->is_seeking && decoder->private_->metadata_filter[FLAC__METADATA_TYPE_STREAMINFO] && decoder->private_->metadata_callback) + decoder->private_->metadata_callback(decoder, &decoder->private_->stream_info, decoder->private_->client_data); + } + else if(type == FLAC__METADATA_TYPE_SEEKTABLE) { + /* just in case we already have a seek table, and reading the next one fails: */ + decoder->private_->has_seek_table = false; + + if(!read_metadata_seektable_(decoder, is_last, length)) + return false; + + decoder->private_->has_seek_table = true; + if(!decoder->private_->is_seeking && decoder->private_->metadata_filter[FLAC__METADATA_TYPE_SEEKTABLE] && decoder->private_->metadata_callback) + decoder->private_->metadata_callback(decoder, &decoder->private_->seek_table, decoder->private_->client_data); + } + else { + FLAC__bool skip_it = !decoder->private_->metadata_filter[type]; + unsigned real_length = length; + FLAC__StreamMetadata block; + + memset(&block, 0, sizeof(block)); + block.is_last = is_last; + block.type = (FLAC__MetadataType)type; + block.length = length; + + if(type == FLAC__METADATA_TYPE_APPLICATION) { + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, block.data.application.id, FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8)) + return false; /* read_callback_ sets the state for us */ + + if(real_length < FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8) { /* underflow check */ + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR;/*@@@@@@ maybe wrong error? need to resync?*/ + return false; + } + + real_length -= FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8; + + if(decoder->private_->metadata_filter_ids_count > 0 && has_id_filtered_(decoder, block.data.application.id)) + skip_it = !skip_it; + } + + if(skip_it) { + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, real_length)) + return false; /* read_callback_ sets the state for us */ + } + else { + FLAC__bool ok = true; + switch(type) { + case FLAC__METADATA_TYPE_PADDING: + /* skip the padding bytes */ + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, real_length)) + ok = false; /* read_callback_ sets the state for us */ + break; + case FLAC__METADATA_TYPE_APPLICATION: + /* remember, we read the ID already */ + if(real_length > 0) { + if(0 == (block.data.application.data = malloc(real_length))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + ok = false; + } + else if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, block.data.application.data, real_length)) + ok = false; /* read_callback_ sets the state for us */ + } + else + block.data.application.data = 0; + break; + case FLAC__METADATA_TYPE_VORBIS_COMMENT: + if(!read_metadata_vorbiscomment_(decoder, &block.data.vorbis_comment, real_length)) + ok = false; + break; + case FLAC__METADATA_TYPE_CUESHEET: + if(!read_metadata_cuesheet_(decoder, &block.data.cue_sheet)) + ok = false; + break; + case FLAC__METADATA_TYPE_PICTURE: + if(!read_metadata_picture_(decoder, &block.data.picture)) + ok = false; + break; + case FLAC__METADATA_TYPE_STREAMINFO: + case FLAC__METADATA_TYPE_SEEKTABLE: + FLAC__ASSERT(0); + break; + default: + if(real_length > 0) { + if(0 == (block.data.unknown.data = malloc(real_length))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + ok = false; + } + else if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, block.data.unknown.data, real_length)) + ok = false; /* read_callback_ sets the state for us */ + } + else + block.data.unknown.data = 0; + break; + } + if(ok && !decoder->private_->is_seeking && decoder->private_->metadata_callback) + decoder->private_->metadata_callback(decoder, &block, decoder->private_->client_data); + + /* now we have to free any malloc()ed data in the block */ + switch(type) { + case FLAC__METADATA_TYPE_PADDING: + break; + case FLAC__METADATA_TYPE_APPLICATION: + if(0 != block.data.application.data) + free(block.data.application.data); + break; + case FLAC__METADATA_TYPE_VORBIS_COMMENT: + if(0 != block.data.vorbis_comment.vendor_string.entry) + free(block.data.vorbis_comment.vendor_string.entry); + if(block.data.vorbis_comment.num_comments > 0) + for(i = 0; i < block.data.vorbis_comment.num_comments; i++) + if(0 != block.data.vorbis_comment.comments[i].entry) + free(block.data.vorbis_comment.comments[i].entry); + if(0 != block.data.vorbis_comment.comments) + free(block.data.vorbis_comment.comments); + break; + case FLAC__METADATA_TYPE_CUESHEET: + if(block.data.cue_sheet.num_tracks > 0) + for(i = 0; i < block.data.cue_sheet.num_tracks; i++) + if(0 != block.data.cue_sheet.tracks[i].indices) + free(block.data.cue_sheet.tracks[i].indices); + if(0 != block.data.cue_sheet.tracks) + free(block.data.cue_sheet.tracks); + break; + case FLAC__METADATA_TYPE_PICTURE: + if(0 != block.data.picture.mime_type) + free(block.data.picture.mime_type); + if(0 != block.data.picture.description) + free(block.data.picture.description); + if(0 != block.data.picture.data) + free(block.data.picture.data); + break; + case FLAC__METADATA_TYPE_STREAMINFO: + case FLAC__METADATA_TYPE_SEEKTABLE: + FLAC__ASSERT(0); + default: + if(0 != block.data.unknown.data) + free(block.data.unknown.data); + break; + } + + if(!ok) /* anything that unsets "ok" should also make sure decoder->protected_->state is updated */ + return false; + } + } + + if(is_last) { + /* if this fails, it's OK, it's just a hint for the seek routine */ + if(!FLAC__stream_decoder_get_decode_position(decoder, &decoder->private_->first_frame_offset)) + decoder->private_->first_frame_offset = 0; + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + } + + return true; +} + +FLAC__bool read_metadata_streaminfo_(FLAC__StreamDecoder *decoder, FLAC__bool is_last, unsigned length) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + unsigned bits, used_bits = 0; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + decoder->private_->stream_info.type = FLAC__METADATA_TYPE_STREAMINFO; + decoder->private_->stream_info.is_last = is_last; + decoder->private_->stream_info.length = length; + + bits = FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, bits)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.min_blocksize = x; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.max_blocksize = x; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.min_framesize = x; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.max_framesize = x; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.sample_rate = x; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.channels = x+1; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->stream_info.data.stream_info.bits_per_sample = x+1; + used_bits += bits; + + bits = FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN; + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &decoder->private_->stream_info.data.stream_info.total_samples, FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN)) + return false; /* read_callback_ sets the state for us */ + used_bits += bits; + + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, decoder->private_->stream_info.data.stream_info.md5sum, 16)) + return false; /* read_callback_ sets the state for us */ + used_bits += 16*8; + + /* skip the rest of the block */ + FLAC__ASSERT(used_bits % 8 == 0); + length -= (used_bits / 8); + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, length)) + return false; /* read_callback_ sets the state for us */ + + return true; +} + +FLAC__bool read_metadata_seektable_(FLAC__StreamDecoder *decoder, FLAC__bool is_last, unsigned length) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 i, x; + FLAC__uint64 xx; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + decoder->private_->seek_table.type = FLAC__METADATA_TYPE_SEEKTABLE; + decoder->private_->seek_table.is_last = is_last; + decoder->private_->seek_table.length = length; + + decoder->private_->seek_table.data.seek_table.num_points = length / FLAC__STREAM_METADATA_SEEKPOINT_LENGTH; + + /* use realloc since we may pass through here several times (e.g. after seeking) */ + if(0 == (decoder->private_->seek_table.data.seek_table.points = safe_realloc_mul_2op_(decoder->private_->seek_table.data.seek_table.points, decoder->private_->seek_table.data.seek_table.num_points, /*times*/sizeof(FLAC__StreamMetadata_SeekPoint)))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + for(i = 0; i < decoder->private_->seek_table.data.seek_table.num_points; i++) { + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &xx, FLAC__STREAM_METADATA_SEEKPOINT_SAMPLE_NUMBER_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->seek_table.data.seek_table.points[i].sample_number = xx; + + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &xx, FLAC__STREAM_METADATA_SEEKPOINT_STREAM_OFFSET_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->seek_table.data.seek_table.points[i].stream_offset = xx; + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_SEEKPOINT_FRAME_SAMPLES_LEN)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->seek_table.data.seek_table.points[i].frame_samples = x; + } + length -= (decoder->private_->seek_table.data.seek_table.num_points * FLAC__STREAM_METADATA_SEEKPOINT_LENGTH); + /* if there is a partial point left, skip over it */ + if(length > 0) { + /*@@@ do a send_error_to_client_() here? there's an argument for either way */ + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, length)) + return false; /* read_callback_ sets the state for us */ + } + + return true; +} + +FLAC__bool read_metadata_vorbiscomment_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_VorbisComment *obj, unsigned length) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 i; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + /* read vendor string */ + if (length >= 8) { + length -= 8; /* vendor string length + num comments entries alone take 8 bytes */ + FLAC__ASSERT(FLAC__STREAM_METADATA_VORBIS_COMMENT_ENTRY_LENGTH_LEN == 32); + if (!FLAC__bitreader_read_uint32_little_endian(decoder->private_->input, &obj->vendor_string.length)) + return false; /* read_callback_ sets the state for us */ + if (obj->vendor_string.length > 0) { + if (length < obj->vendor_string.length) { + obj->vendor_string.length = 0; + obj->vendor_string.entry = 0; + goto skip; + } + else + length -= obj->vendor_string.length; + if (0 == (obj->vendor_string.entry = safe_malloc_add_2op_(obj->vendor_string.length, /*+*/1))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + if (!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, obj->vendor_string.entry, obj->vendor_string.length)) + return false; /* read_callback_ sets the state for us */ + obj->vendor_string.entry[obj->vendor_string.length] = '\0'; + } + else + obj->vendor_string.entry = 0; + + /* read num comments */ + FLAC__ASSERT(FLAC__STREAM_METADATA_VORBIS_COMMENT_NUM_COMMENTS_LEN == 32); + if (!FLAC__bitreader_read_uint32_little_endian(decoder->private_->input, &obj->num_comments)) + return false; /* read_callback_ sets the state for us */ + + /* read comments */ + if (obj->num_comments > 100000) { + /* Possibly malicious file. */ + obj->num_comments = 0; + return false; + } + if (obj->num_comments > 0) { + if (0 == (obj->comments = safe_malloc_mul_2op_p(obj->num_comments, /*times*/sizeof(FLAC__StreamMetadata_VorbisComment_Entry)))) { + obj->num_comments = 0; + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + for (i = 0; i < obj->num_comments; i++) { + /* Initialize here just to make sure. */ + obj->comments[i].length = 0; + obj->comments[i].entry = 0; + + FLAC__ASSERT(FLAC__STREAM_METADATA_VORBIS_COMMENT_ENTRY_LENGTH_LEN == 32); + if (length < 4) { + obj->num_comments = i; + goto skip; + } + else + length -= 4; + if (!FLAC__bitreader_read_uint32_little_endian(decoder->private_->input, &obj->comments[i].length)) { + obj->num_comments = i; + return false; /* read_callback_ sets the state for us */ + } + if (obj->comments[i].length > 0) { + if (length < obj->comments[i].length) { + obj->num_comments = i; + goto skip; + } + else + length -= obj->comments[i].length; + if (0 == (obj->comments[i].entry = safe_malloc_add_2op_(obj->comments[i].length, /*+*/1))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + obj->num_comments = i; + return false; + } + memset (obj->comments[i].entry, 0, obj->comments[i].length) ; + if (!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, obj->comments[i].entry, obj->comments[i].length)) { + obj->num_comments = i; + goto skip; + } + obj->comments[i].entry[obj->comments[i].length] = '\0'; + } + else + obj->comments[i].entry = 0; + } + } + } + + skip: + if (length > 0) { + /* length > 0 can only happen on files with invalid data in comments */ + if(obj->num_comments < 1) { + free(obj->comments); + obj->comments = NULL; + } + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, length)) + return false; /* read_callback_ sets the state for us */ + } + + return true; +} + +FLAC__bool read_metadata_cuesheet_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_CueSheet *obj) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 i, j, x; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + memset(obj, 0, sizeof(FLAC__StreamMetadata_CueSheet)); + + FLAC__ASSERT(FLAC__STREAM_METADATA_CUESHEET_MEDIA_CATALOG_NUMBER_LEN % 8 == 0); + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, (FLAC__byte*)obj->media_catalog_number, FLAC__STREAM_METADATA_CUESHEET_MEDIA_CATALOG_NUMBER_LEN/8)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &obj->lead_in, FLAC__STREAM_METADATA_CUESHEET_LEAD_IN_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_IS_CD_LEN)) + return false; /* read_callback_ sets the state for us */ + obj->is_cd = x? true : false; + + if(!FLAC__bitreader_skip_bits_no_crc(decoder->private_->input, FLAC__STREAM_METADATA_CUESHEET_RESERVED_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_NUM_TRACKS_LEN)) + return false; /* read_callback_ sets the state for us */ + obj->num_tracks = x; + + if(obj->num_tracks > 0) { + if(0 == (obj->tracks = safe_calloc_(obj->num_tracks, sizeof(FLAC__StreamMetadata_CueSheet_Track)))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + for(i = 0; i < obj->num_tracks; i++) { + FLAC__StreamMetadata_CueSheet_Track *track = &obj->tracks[i]; + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &track->offset, FLAC__STREAM_METADATA_CUESHEET_TRACK_OFFSET_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_TRACK_NUMBER_LEN)) + return false; /* read_callback_ sets the state for us */ + track->number = (FLAC__byte)x; + + FLAC__ASSERT(FLAC__STREAM_METADATA_CUESHEET_TRACK_ISRC_LEN % 8 == 0); + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, (FLAC__byte*)track->isrc, FLAC__STREAM_METADATA_CUESHEET_TRACK_ISRC_LEN/8)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_TRACK_TYPE_LEN)) + return false; /* read_callback_ sets the state for us */ + track->type = x; + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_TRACK_PRE_EMPHASIS_LEN)) + return false; /* read_callback_ sets the state for us */ + track->pre_emphasis = x; + + if(!FLAC__bitreader_skip_bits_no_crc(decoder->private_->input, FLAC__STREAM_METADATA_CUESHEET_TRACK_RESERVED_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_TRACK_NUM_INDICES_LEN)) + return false; /* read_callback_ sets the state for us */ + track->num_indices = (FLAC__byte)x; + + if(track->num_indices > 0) { + if(0 == (track->indices = safe_calloc_(track->num_indices, sizeof(FLAC__StreamMetadata_CueSheet_Index)))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + for(j = 0; j < track->num_indices; j++) { + FLAC__StreamMetadata_CueSheet_Index *indx = &track->indices[j]; + if(!FLAC__bitreader_read_raw_uint64(decoder->private_->input, &indx->offset, FLAC__STREAM_METADATA_CUESHEET_INDEX_OFFSET_LEN)) + return false; /* read_callback_ sets the state for us */ + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_CUESHEET_INDEX_NUMBER_LEN)) + return false; /* read_callback_ sets the state for us */ + indx->number = (FLAC__byte)x; + + if(!FLAC__bitreader_skip_bits_no_crc(decoder->private_->input, FLAC__STREAM_METADATA_CUESHEET_INDEX_RESERVED_LEN)) + return false; /* read_callback_ sets the state for us */ + } + } + } + } + + return true; +} + +FLAC__bool read_metadata_picture_(FLAC__StreamDecoder *decoder, FLAC__StreamMetadata_Picture *obj) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + /* read type */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_PICTURE_TYPE_LEN)) + return false; /* read_callback_ sets the state for us */ + obj->type = x; + + /* read MIME type */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_PICTURE_MIME_TYPE_LENGTH_LEN)) + return false; /* read_callback_ sets the state for us */ + if(0 == (obj->mime_type = safe_malloc_add_2op_(x, /*+*/1))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + if(x > 0) { + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, (FLAC__byte*)obj->mime_type, x)) + return false; /* read_callback_ sets the state for us */ + } + obj->mime_type[x] = '\0'; + + /* read description */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__STREAM_METADATA_PICTURE_DESCRIPTION_LENGTH_LEN)) + return false; /* read_callback_ sets the state for us */ + if(0 == (obj->description = safe_malloc_add_2op_(x, /*+*/1))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + if(x > 0) { + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, obj->description, x)) + return false; /* read_callback_ sets the state for us */ + } + obj->description[x] = '\0'; + + /* read width */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &obj->width, FLAC__STREAM_METADATA_PICTURE_WIDTH_LEN)) + return false; /* read_callback_ sets the state for us */ + + /* read height */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &obj->height, FLAC__STREAM_METADATA_PICTURE_HEIGHT_LEN)) + return false; /* read_callback_ sets the state for us */ + + /* read depth */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &obj->depth, FLAC__STREAM_METADATA_PICTURE_DEPTH_LEN)) + return false; /* read_callback_ sets the state for us */ + + /* read colors */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &obj->colors, FLAC__STREAM_METADATA_PICTURE_COLORS_LEN)) + return false; /* read_callback_ sets the state for us */ + + /* read data */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &(obj->data_length), FLAC__STREAM_METADATA_PICTURE_DATA_LENGTH_LEN)) + return false; /* read_callback_ sets the state for us */ + if(0 == (obj->data = safe_malloc_(obj->data_length))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + if(obj->data_length > 0) { + if(!FLAC__bitreader_read_byte_block_aligned_no_crc(decoder->private_->input, obj->data, obj->data_length)) + return false; /* read_callback_ sets the state for us */ + } + + return true; +} + +FLAC__bool skip_id3v2_tag_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + unsigned i, skip; + + /* skip the version and flags bytes */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 24)) + return false; /* read_callback_ sets the state for us */ + /* get the size (in bytes) to skip */ + skip = 0; + for(i = 0; i < 4; i++) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + skip <<= 7; + skip |= (x & 0x7f); + } + /* skip the rest of the tag */ + if(!FLAC__bitreader_skip_byte_block_aligned_no_crc(decoder->private_->input, skip)) + return false; /* read_callback_ sets the state for us */ + return true; +} + +FLAC__bool frame_sync_(FLAC__StreamDecoder *decoder) +{ + FLAC__uint32 x; + FLAC__bool first = true; + + /* If we know the total number of samples in the stream, stop if we've read that many. */ + /* This will stop us, for example, from wasting time trying to sync on an ID3V1 tag. */ + if(FLAC__stream_decoder_get_total_samples(decoder) > 0) { + if(decoder->private_->samples_decoded >= FLAC__stream_decoder_get_total_samples(decoder)) { + decoder->protected_->state = FLAC__STREAM_DECODER_END_OF_STREAM; + return true; + } + } + + /* make sure we're byte aligned */ + if(!FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__bitreader_bits_left_for_byte_alignment(decoder->private_->input))) + return false; /* read_callback_ sets the state for us */ + } + + while(1) { + if(decoder->private_->cached) { + x = (FLAC__uint32)decoder->private_->lookahead; + decoder->private_->cached = false; + } + else { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + } + if(x == 0xff) { /* MAGIC NUMBER for the first 8 frame sync bits */ + decoder->private_->header_warmup[0] = (FLAC__byte)x; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + + /* we have to check if we just read two 0xff's in a row; the second may actually be the beginning of the sync code */ + /* else we have to check if the second byte is the end of a sync code */ + if(x == 0xff) { /* MAGIC NUMBER for the first 8 frame sync bits */ + decoder->private_->lookahead = (FLAC__byte)x; + decoder->private_->cached = true; + } + else if(x >> 1 == 0x7c) { /* MAGIC NUMBER for the last 6 sync bits and reserved 7th bit */ + decoder->private_->header_warmup[1] = (FLAC__byte)x; + decoder->protected_->state = FLAC__STREAM_DECODER_READ_FRAME; + return true; + } + } + if(first) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + first = false; + } + } + + return true; +} + +FLAC__bool read_frame_(FLAC__StreamDecoder *decoder, FLAC__bool *got_a_frame, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + unsigned channel; + unsigned i; + FLAC__int32 mid, side; + unsigned frame_crc; /* the one we calculate from the input stream */ + FLAC__uint32 x; + + *got_a_frame = false; + + /* init the CRC */ + frame_crc = 0; + frame_crc = FLAC__CRC16_UPDATE(decoder->private_->header_warmup[0], frame_crc); + frame_crc = FLAC__CRC16_UPDATE(decoder->private_->header_warmup[1], frame_crc); + FLAC__bitreader_reset_read_crc16(decoder->private_->input, (FLAC__uint16)frame_crc); + + if(!read_frame_header_(decoder)) + return false; + if(decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC) /* means we didn't sync on a valid header */ + return true; + if(!allocate_output_(decoder, decoder->private_->frame.header.blocksize, decoder->private_->frame.header.channels)) + return false; + for(channel = 0; channel < decoder->private_->frame.header.channels; channel++) { + /* + * first figure the correct bits-per-sample of the subframe + */ + unsigned bps = decoder->private_->frame.header.bits_per_sample; + switch(decoder->private_->frame.header.channel_assignment) { + case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT: + /* no adjustment needed */ + break; + case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + if(channel == 1) + bps++; + break; + case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + if(channel == 0) + bps++; + break; + case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + if(channel == 1) + bps++; + break; + default: + FLAC__ASSERT(0); + } + /* + * now read it + */ + if(!read_subframe_(decoder, channel, bps, do_full_decode)) + return false; + if(decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC) /* means bad sync or got corruption */ + return true; + } + if(!read_zero_padding_(decoder)) + return false; + if(decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC) /* means bad sync or got corruption (i.e. "zero bits" were not all zeroes) */ + return true; + + /* + * Read the frame CRC-16 from the footer and check + */ + frame_crc = FLAC__bitreader_get_read_crc16(decoder->private_->input); + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, FLAC__FRAME_FOOTER_CRC_LEN)) + return false; /* read_callback_ sets the state for us */ + if(frame_crc == x) { + if(do_full_decode) { + /* Undo any special channel coding */ + switch(decoder->private_->frame.header.channel_assignment) { + case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT: + /* do nothing */ + break; + case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) + decoder->private_->output[1][i] = decoder->private_->output[0][i] - decoder->private_->output[1][i]; + break; + case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) + decoder->private_->output[0][i] += decoder->private_->output[1][i]; + break; + case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE: + FLAC__ASSERT(decoder->private_->frame.header.channels == 2); + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) { +#if 1 + mid = decoder->private_->output[0][i]; + side = decoder->private_->output[1][i]; + mid = ((uint32_t) mid) << 1; + mid |= (side & 1); /* i.e. if 'side' is odd... */ + decoder->private_->output[0][i] = (mid + side) >> 1; + decoder->private_->output[1][i] = (mid - side) >> 1; +#else + /* OPT: without 'side' temp variable */ + mid = (decoder->private_->output[0][i] << 1) | (decoder->private_->output[1][i] & 1); /* i.e. if 'side' is odd... */ + decoder->private_->output[0][i] = (mid + decoder->private_->output[1][i]) >> 1; + decoder->private_->output[1][i] = (mid - decoder->private_->output[1][i]) >> 1; +#endif + } + break; + default: + FLAC__ASSERT(0); + break; + } + } + } + else { + /* Bad frame, emit error and zero the output signal */ + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_FRAME_CRC_MISMATCH); + if(do_full_decode) { + for(channel = 0; channel < decoder->private_->frame.header.channels; channel++) { + memset(decoder->private_->output[channel], 0, sizeof(FLAC__int32) * decoder->private_->frame.header.blocksize); + } + } + } + + *got_a_frame = true; + + /* we wait to update fixed_block_size until here, when we're sure we've got a proper frame and hence a correct blocksize */ + if(decoder->private_->next_fixed_block_size) + decoder->private_->fixed_block_size = decoder->private_->next_fixed_block_size; + + /* put the latest values into the public section of the decoder instance */ + decoder->protected_->channels = decoder->private_->frame.header.channels; + decoder->protected_->channel_assignment = decoder->private_->frame.header.channel_assignment; + decoder->protected_->bits_per_sample = decoder->private_->frame.header.bits_per_sample; + decoder->protected_->sample_rate = decoder->private_->frame.header.sample_rate; + decoder->protected_->blocksize = decoder->private_->frame.header.blocksize; + + FLAC__ASSERT(decoder->private_->frame.header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER); + decoder->private_->samples_decoded = decoder->private_->frame.header.number.sample_number + decoder->private_->frame.header.blocksize; + + /* write it */ + if(do_full_decode) { + if(write_audio_frame_to_client_(decoder, &decoder->private_->frame, (const FLAC__int32 * const *)decoder->private_->output) != FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE) { + decoder->protected_->state = FLAC__STREAM_DECODER_ABORTED; + return false; + } + } + + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; +} + +FLAC__bool read_frame_header_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + FLAC__uint64 xx; + unsigned i, blocksize_hint = 0, sample_rate_hint = 0; + FLAC__byte crc8, raw_header[16]; /* MAGIC NUMBER based on the maximum frame header size, including CRC */ + unsigned raw_header_len; + FLAC__bool is_unparseable = false; + + FLAC__ASSERT(FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)); + + /* init the raw header with the saved bits from synchronization */ + raw_header[0] = decoder->private_->header_warmup[0]; + raw_header[1] = decoder->private_->header_warmup[1]; + raw_header_len = 2; + + /* check to make sure that reserved bit is 0 */ + if(raw_header[1] & 0x02) /* MAGIC NUMBER */ + is_unparseable = true; + + /* + * Note that along the way as we read the header, we look for a sync + * code inside. If we find one it would indicate that our original + * sync was bad since there cannot be a sync code in a valid header. + * + * Three kinds of things can go wrong when reading the frame header: + * 1) We may have sync'ed incorrectly and not landed on a frame header. + * If we don't find a sync code, it can end up looking like we read + * a valid but unparseable header, until getting to the frame header + * CRC. Even then we could get a false positive on the CRC. + * 2) We may have sync'ed correctly but on an unparseable frame (from a + * future encoder). + * 3) We may be on a damaged frame which appears valid but unparseable. + * + * For all these reasons, we try and read a complete frame header as + * long as it seems valid, even if unparseable, up until the frame + * header CRC. + */ + + /* + * read in the raw header as bytes so we can CRC it, and parse it on the way + */ + for(i = 0; i < 2; i++) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + if(x == 0xff) { /* MAGIC NUMBER for the first 8 frame sync bits */ + /* if we get here it means our original sync was erroneous since the sync code cannot appear in the header */ + decoder->private_->lookahead = (FLAC__byte)x; + decoder->private_->cached = true; + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + raw_header[raw_header_len++] = (FLAC__byte)x; + } + + switch(x = raw_header[2] >> 4) { + case 0: + is_unparseable = true; + break; + case 1: + decoder->private_->frame.header.blocksize = 192; + break; + case 2: + case 3: + case 4: + case 5: + decoder->private_->frame.header.blocksize = 576 << (x-2); + break; + case 6: + case 7: + blocksize_hint = x; + break; + case 8: + case 9: + case 10: + case 11: + case 12: + case 13: + case 14: + case 15: + decoder->private_->frame.header.blocksize = 256 << (x-8); + break; + default: + FLAC__ASSERT(0); + break; + } + + switch(x = raw_header[2] & 0x0f) { + case 0: + if(decoder->private_->has_stream_info) + decoder->private_->frame.header.sample_rate = decoder->private_->stream_info.data.stream_info.sample_rate; + else + is_unparseable = true; + break; + case 1: + decoder->private_->frame.header.sample_rate = 88200; + break; + case 2: + decoder->private_->frame.header.sample_rate = 176400; + break; + case 3: + decoder->private_->frame.header.sample_rate = 192000; + break; + case 4: + decoder->private_->frame.header.sample_rate = 8000; + break; + case 5: + decoder->private_->frame.header.sample_rate = 16000; + break; + case 6: + decoder->private_->frame.header.sample_rate = 22050; + break; + case 7: + decoder->private_->frame.header.sample_rate = 24000; + break; + case 8: + decoder->private_->frame.header.sample_rate = 32000; + break; + case 9: + decoder->private_->frame.header.sample_rate = 44100; + break; + case 10: + decoder->private_->frame.header.sample_rate = 48000; + break; + case 11: + decoder->private_->frame.header.sample_rate = 96000; + break; + case 12: + case 13: + case 14: + sample_rate_hint = x; + break; + case 15: + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + default: + FLAC__ASSERT(0); + } + + x = (unsigned)(raw_header[3] >> 4); + if(x & 8) { + decoder->private_->frame.header.channels = 2; + switch(x & 7) { + case 0: + decoder->private_->frame.header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE; + break; + case 1: + decoder->private_->frame.header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE; + break; + case 2: + decoder->private_->frame.header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_MID_SIDE; + break; + default: + is_unparseable = true; + break; + } + } + else { + decoder->private_->frame.header.channels = (unsigned)x + 1; + decoder->private_->frame.header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT; + } + + switch(x = (unsigned)(raw_header[3] & 0x0e) >> 1) { + case 0: + if(decoder->private_->has_stream_info) + decoder->private_->frame.header.bits_per_sample = decoder->private_->stream_info.data.stream_info.bits_per_sample; + else + is_unparseable = true; + break; + case 1: + decoder->private_->frame.header.bits_per_sample = 8; + break; + case 2: + decoder->private_->frame.header.bits_per_sample = 12; + break; + case 4: + decoder->private_->frame.header.bits_per_sample = 16; + break; + case 5: + decoder->private_->frame.header.bits_per_sample = 20; + break; + case 6: + decoder->private_->frame.header.bits_per_sample = 24; + break; + case 3: + case 7: + is_unparseable = true; + break; + default: + FLAC__ASSERT(0); + break; + } + + /* check to make sure that reserved bit is 0 */ + if(raw_header[3] & 0x01) /* MAGIC NUMBER */ + is_unparseable = true; + + /* read the frame's starting sample number (or frame number as the case may be) */ + if( + raw_header[1] & 0x01 || + /*@@@ this clause is a concession to the old way of doing variable blocksize; the only known implementation is flake and can probably be removed without inconveniencing anyone */ + (decoder->private_->has_stream_info && decoder->private_->stream_info.data.stream_info.min_blocksize != decoder->private_->stream_info.data.stream_info.max_blocksize) + ) { /* variable blocksize */ + if(!FLAC__bitreader_read_utf8_uint64(decoder->private_->input, &xx, raw_header, &raw_header_len)) + return false; /* read_callback_ sets the state for us */ + if(xx == FLAC__U64L(0xffffffffffffffff)) { /* i.e. non-UTF8 code... */ + decoder->private_->lookahead = raw_header[raw_header_len-1]; /* back up as much as we can */ + decoder->private_->cached = true; + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + decoder->private_->frame.header.number_type = FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER; + decoder->private_->frame.header.number.sample_number = xx; + } + else { /* fixed blocksize */ + if(!FLAC__bitreader_read_utf8_uint32(decoder->private_->input, &x, raw_header, &raw_header_len)) + return false; /* read_callback_ sets the state for us */ + if(x == 0xffffffff) { /* i.e. non-UTF8 code... */ + decoder->private_->lookahead = raw_header[raw_header_len-1]; /* back up as much as we can */ + decoder->private_->cached = true; + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + decoder->private_->frame.header.number_type = FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER; + decoder->private_->frame.header.number.frame_number = x; + } + + if(blocksize_hint) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + raw_header[raw_header_len++] = (FLAC__byte)x; + if(blocksize_hint == 7) { + FLAC__uint32 _x; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &_x, 8)) + return false; /* read_callback_ sets the state for us */ + raw_header[raw_header_len++] = (FLAC__byte)_x; + x = (x << 8) | _x; + } + decoder->private_->frame.header.blocksize = x+1; + } + + if(sample_rate_hint) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + raw_header[raw_header_len++] = (FLAC__byte)x; + if(sample_rate_hint != 12) { + FLAC__uint32 _x; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &_x, 8)) + return false; /* read_callback_ sets the state for us */ + raw_header[raw_header_len++] = (FLAC__byte)_x; + x = (x << 8) | _x; + } + if(sample_rate_hint == 12) + decoder->private_->frame.header.sample_rate = x*1000; + else if(sample_rate_hint == 13) + decoder->private_->frame.header.sample_rate = x; + else + decoder->private_->frame.header.sample_rate = x*10; + } + + /* read the CRC-8 byte */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) + return false; /* read_callback_ sets the state for us */ + crc8 = (FLAC__byte)x; + + if(FLAC__crc8(raw_header, raw_header_len) != crc8) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_BAD_HEADER); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + + /* calculate the sample number from the frame number if needed */ + decoder->private_->next_fixed_block_size = 0; + if(decoder->private_->frame.header.number_type == FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER) { + x = decoder->private_->frame.header.number.frame_number; + decoder->private_->frame.header.number_type = FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER; + if(decoder->private_->fixed_block_size) + decoder->private_->frame.header.number.sample_number = (FLAC__uint64)decoder->private_->fixed_block_size * (FLAC__uint64)x; + else if(decoder->private_->has_stream_info) { + if(decoder->private_->stream_info.data.stream_info.min_blocksize == decoder->private_->stream_info.data.stream_info.max_blocksize) { + decoder->private_->frame.header.number.sample_number = (FLAC__uint64)decoder->private_->stream_info.data.stream_info.min_blocksize * (FLAC__uint64)x; + decoder->private_->next_fixed_block_size = decoder->private_->stream_info.data.stream_info.max_blocksize; + } + else + is_unparseable = true; + } + else if(x == 0) { + decoder->private_->frame.header.number.sample_number = 0; + decoder->private_->next_fixed_block_size = decoder->private_->frame.header.blocksize; + } + else { + /* can only get here if the stream has invalid frame numbering and no STREAMINFO, so assume it's not the last (possibly short) frame */ + decoder->private_->frame.header.number.sample_number = (FLAC__uint64)decoder->private_->frame.header.blocksize * (FLAC__uint64)x; + } + } + + if(is_unparseable) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + + return true; +} + +FLAC__bool read_subframe_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 x; + FLAC__bool wasted_bits; + unsigned i; + + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &x, 8)) /* MAGIC NUMBER */ + return false; /* read_callback_ sets the state for us */ + + wasted_bits = (x & 1); + x &= 0xfe; + + if(wasted_bits) { + unsigned u; + if(!FLAC__bitreader_read_unary_unsigned(decoder->private_->input, &u)) + return false; /* read_callback_ sets the state for us */ + decoder->private_->frame.subframes[channel].wasted_bits = u+1; + if (decoder->private_->frame.subframes[channel].wasted_bits >= bps) + return false; + bps -= decoder->private_->frame.subframes[channel].wasted_bits; + } + else + decoder->private_->frame.subframes[channel].wasted_bits = 0; + + /* + * Lots of magic numbers here + */ + if(x & 0x80) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + else if(x == 0) { + if(!read_subframe_constant_(decoder, channel, bps, do_full_decode)) + return false; + } + else if(x == 2) { + if(!read_subframe_verbatim_(decoder, channel, bps, do_full_decode)) + return false; + } + else if(x < 16) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + else if(x <= 24) { + if(!read_subframe_fixed_(decoder, channel, bps, (x>>1)&7, do_full_decode)) + return false; + if(decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC) /* means bad sync or got corruption */ + return true; + } + else if(x < 64) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + else { + if(!read_subframe_lpc_(decoder, channel, bps, ((x>>1)&31)+1, do_full_decode)) + return false; + if(decoder->protected_->state == FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC) /* means bad sync or got corruption */ + return true; + } + + if(wasted_bits && do_full_decode) { + x = decoder->private_->frame.subframes[channel].wasted_bits; + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) { + uint32_t val = decoder->private_->output[channel][i]; + decoder->private_->output[channel][i] = (val << x); + } + } + + return true; +} + +FLAC__bool read_subframe_constant_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__Subframe_Constant *subframe = &decoder->private_->frame.subframes[channel].data.constant; + FLAC__int32 x; + unsigned i; + FLAC__int32 *output = decoder->private_->output[channel]; + + decoder->private_->frame.subframes[channel].type = FLAC__SUBFRAME_TYPE_CONSTANT; + + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &x, bps)) + return false; /* read_callback_ sets the state for us */ + + subframe->value = x; + + /* decode the subframe */ + if(do_full_decode) { + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) + output[i] = x; + } + + return true; +} + +FLAC__bool read_subframe_fixed_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, const unsigned order, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); +FLAC__Subframe_Fixed *subframe = &decoder->private_->frame.subframes[channel].data.fixed; + FLAC__int32 i32; + FLAC__uint32 u32; + unsigned u; + + decoder->private_->frame.subframes[channel].type = FLAC__SUBFRAME_TYPE_FIXED; + + subframe->residual = decoder->private_->residual[channel]; + subframe->order = order; + + /* read warm-up samples */ + for(u = 0; u < order; u++) { + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &i32, bps)) + return false; /* read_callback_ sets the state for us */ + subframe->warmup[u] = i32; + } + + /* read entropy coding method info */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &u32, FLAC__ENTROPY_CODING_METHOD_TYPE_LEN)) + return false; /* read_callback_ sets the state for us */ + subframe->entropy_coding_method.type = (FLAC__EntropyCodingMethodType)u32; + switch(subframe->entropy_coding_method.type) { + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE: + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2: + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &u32, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN)) + return false; /* read_callback_ sets the state for us */ + if(decoder->private_->frame.header.blocksize >> u32 < order) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + subframe->entropy_coding_method.data.partitioned_rice.order = u32; + subframe->entropy_coding_method.data.partitioned_rice.contents = &decoder->private_->partitioned_rice_contents[channel]; + break; + default: + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + + /* read residual */ + switch(subframe->entropy_coding_method.type) { + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE: + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2: + if(!read_residual_partitioned_rice_(decoder, order, subframe->entropy_coding_method.data.partitioned_rice.order, &decoder->private_->partitioned_rice_contents[channel], decoder->private_->residual[channel], /*is_extended=*/subframe->entropy_coding_method.type == FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2)) + return false; + break; + default: + FLAC__ASSERT(0); + } + + /* decode the subframe */ + if(do_full_decode) { + memcpy(decoder->private_->output[channel], subframe->warmup, sizeof(FLAC__int32) * order); + FLAC__fixed_restore_signal(decoder->private_->residual[channel], decoder->private_->frame.header.blocksize-order, order, decoder->private_->output[channel]+order); + } + + return true; +} + +FLAC__bool read_subframe_lpc_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, const unsigned order, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__Subframe_LPC *subframe = &decoder->private_->frame.subframes[channel].data.lpc; + FLAC__int32 i32; + FLAC__uint32 u32; + unsigned u; + + decoder->private_->frame.subframes[channel].type = FLAC__SUBFRAME_TYPE_LPC; + + subframe->residual = decoder->private_->residual[channel]; + subframe->order = order; + + /* read warm-up samples */ + for(u = 0; u < order; u++) { + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &i32, bps)) + return false; /* read_callback_ sets the state for us */ + subframe->warmup[u] = i32; + } + + /* read qlp coeff precision */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &u32, FLAC__SUBFRAME_LPC_QLP_COEFF_PRECISION_LEN)) + return false; /* read_callback_ sets the state for us */ + if(u32 == (1u << FLAC__SUBFRAME_LPC_QLP_COEFF_PRECISION_LEN) - 1) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + subframe->qlp_coeff_precision = u32+1; + + /* read qlp shift */ + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &i32, FLAC__SUBFRAME_LPC_QLP_SHIFT_LEN)) + return false; /* read_callback_ sets the state for us */ + if(i32 < 0) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + subframe->quantization_level = i32; + + /* read quantized lp coefficiencts */ + for(u = 0; u < order; u++) { + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &i32, subframe->qlp_coeff_precision)) + return false; /* read_callback_ sets the state for us */ + subframe->qlp_coeff[u] = i32; + } + + /* read entropy coding method info */ + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &u32, FLAC__ENTROPY_CODING_METHOD_TYPE_LEN)) + return false; /* read_callback_ sets the state for us */ + subframe->entropy_coding_method.type = (FLAC__EntropyCodingMethodType)u32; + switch(subframe->entropy_coding_method.type) { + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE: + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2: + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &u32, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN)) + return false; /* read_callback_ sets the state for us */ + if(decoder->private_->frame.header.blocksize >> u32 < order) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + subframe->entropy_coding_method.data.partitioned_rice.order = u32; + subframe->entropy_coding_method.data.partitioned_rice.contents = &decoder->private_->partitioned_rice_contents[channel]; + break; + default: + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + return true; + } + + /* read residual */ + switch(subframe->entropy_coding_method.type) { + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE: + case FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2: + if(!read_residual_partitioned_rice_(decoder, order, subframe->entropy_coding_method.data.partitioned_rice.order, &decoder->private_->partitioned_rice_contents[channel], decoder->private_->residual[channel], /*is_extended=*/subframe->entropy_coding_method.type == FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2)) + return false; + break; + default: + FLAC__ASSERT(0); + } + + /* decode the subframe */ + if(do_full_decode) { + memcpy(decoder->private_->output[channel], subframe->warmup, sizeof(FLAC__int32) * order); + if(bps + subframe->qlp_coeff_precision + FLAC__bitmath_ilog2(order) <= 32) + if(bps <= 16 && subframe->qlp_coeff_precision <= 16) + decoder->private_->local_lpc_restore_signal_16bit(decoder->private_->residual[channel], decoder->private_->frame.header.blocksize-order, subframe->qlp_coeff, order, subframe->quantization_level, decoder->private_->output[channel]+order); + else + decoder->private_->local_lpc_restore_signal(decoder->private_->residual[channel], decoder->private_->frame.header.blocksize-order, subframe->qlp_coeff, order, subframe->quantization_level, decoder->private_->output[channel]+order); + else + decoder->private_->local_lpc_restore_signal_64bit(decoder->private_->residual[channel], decoder->private_->frame.header.blocksize-order, subframe->qlp_coeff, order, subframe->quantization_level, decoder->private_->output[channel]+order); + } + + return true; +} + +FLAC__bool read_subframe_verbatim_(FLAC__StreamDecoder *decoder, unsigned channel, unsigned bps, FLAC__bool do_full_decode) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__Subframe_Verbatim *subframe = &decoder->private_->frame.subframes[channel].data.verbatim; + FLAC__int32 x, *residual = decoder->private_->residual[channel]; + unsigned i; + + decoder->private_->frame.subframes[channel].type = FLAC__SUBFRAME_TYPE_VERBATIM; + + subframe->data = residual; + + for(i = 0; i < decoder->private_->frame.header.blocksize; i++) { + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &x, bps)) + return false; /* read_callback_ sets the state for us */ + residual[i] = x; + } + + /* decode the subframe */ + if(do_full_decode) + memcpy(decoder->private_->output[channel], subframe->data, sizeof(FLAC__int32) * decoder->private_->frame.header.blocksize); + + return true; +} + +FLAC__bool read_residual_partitioned_rice_(FLAC__StreamDecoder *decoder, unsigned predictor_order, unsigned partition_order, FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents, FLAC__int32 *residual, FLAC__bool is_extended) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint32 rice_parameter; + int i; + unsigned partition, sample, u; + const unsigned partitions = 1u << partition_order; + const unsigned partition_samples = partition_order > 0? decoder->private_->frame.header.blocksize >> partition_order : decoder->private_->frame.header.blocksize - predictor_order; + const unsigned plen = is_extended? FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2_PARAMETER_LEN : FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN; + const unsigned pesc = is_extended? FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE2_ESCAPE_PARAMETER : FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER; + + /* invalid predictor and partition orders mush be handled in the callers */ + FLAC__ASSERT(partition_order > 0? partition_samples >= predictor_order : decoder->private_->frame.header.blocksize >= predictor_order); + + if(!FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(partitioned_rice_contents, flac_max(6u, partition_order))) { + decoder->protected_->state = FLAC__STREAM_DECODER_MEMORY_ALLOCATION_ERROR; + return false; + } + + sample = 0; + for(partition = 0; partition < partitions; partition++) { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &rice_parameter, plen)) + return false; /* read_callback_ sets the state for us */ + partitioned_rice_contents->parameters[partition] = rice_parameter; + if(rice_parameter < pesc) { + partitioned_rice_contents->raw_bits[partition] = 0; + u = (partition_order == 0 || partition > 0)? partition_samples : partition_samples - predictor_order; + if(!FLAC__bitreader_read_rice_signed_block(decoder->private_->input, residual + sample, u, rice_parameter)) + return false; /* read_callback_ sets the state for us */ + sample += u; + } + else { + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_RAW_LEN)) + return false; /* read_callback_ sets the state for us */ + partitioned_rice_contents->raw_bits[partition] = rice_parameter; + for(u = (partition_order == 0 || partition > 0)? 0 : predictor_order; u < partition_samples; u++, sample++) { + if(!FLAC__bitreader_read_raw_int32(decoder->private_->input, &i, rice_parameter)) + return false; /* read_callback_ sets the state for us */ + residual[sample] = i; + } + } + } + + return true; +} + +FLAC__bool read_zero_padding_(FLAC__StreamDecoder *decoder) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + if(!FLAC__bitreader_is_consumed_byte_aligned(decoder->private_->input)) { + FLAC__uint32 zero = 0; + if(!FLAC__bitreader_read_raw_uint32(decoder->private_->input, &zero, FLAC__bitreader_bits_left_for_byte_alignment(decoder->private_->input))) + return false; /* read_callback_ sets the state for us */ + if(zero != 0) { + send_error_to_client_(decoder, FLAC__STREAM_DECODER_ERROR_STATUS_LOST_SYNC); + decoder->protected_->state = FLAC__STREAM_DECODER_SEARCH_FOR_FRAME_SYNC; + } + } + return true; +} + +FLAC__bool read_callback_(FLAC__byte buffer[], size_t *bytes, void *client_data) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__StreamDecoder *decoder = (FLAC__StreamDecoder *)client_data; + + if( +#if FLAC__HAS_OGG + /* see [1] HACK NOTE below for why we don't call the eof_callback when decoding Ogg FLAC */ + !decoder->private_->is_ogg && +#endif + decoder->private_->eof_callback && decoder->private_->eof_callback(decoder, decoder->private_->client_data) + ) { + *bytes = 0; + decoder->protected_->state = FLAC__STREAM_DECODER_END_OF_STREAM; + return false; + } + else if(*bytes > 0) { + /* While seeking, it is possible for our seek to land in the + * middle of audio data that looks exactly like a frame header + * from a future version of an encoder. When that happens, our + * error callback will get an + * FLAC__STREAM_DECODER_UNPARSEABLE_STREAM and increment its + * unparseable_frame_count. But there is a remote possibility + * that it is properly synced at such a "future-codec frame", + * so to make sure, we wait to see many "unparseable" errors in + * a row before bailing out. + */ + if(decoder->private_->is_seeking && decoder->private_->unparseable_frame_count > 20) { + decoder->protected_->state = FLAC__STREAM_DECODER_ABORTED; + return false; + } + else { + const FLAC__StreamDecoderReadStatus status = +#if FLAC__HAS_OGG + decoder->private_->is_ogg? + read_callback_ogg_aspect_(decoder, buffer, bytes) : +#endif + decoder->private_->read_callback(decoder, buffer, bytes, decoder->private_->client_data) + ; + if(status == FLAC__STREAM_DECODER_READ_STATUS_ABORT) { + decoder->protected_->state = FLAC__STREAM_DECODER_ABORTED; + return false; + } + else if(*bytes == 0) { + if( + status == FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM || + ( +#if FLAC__HAS_OGG + /* see [1] HACK NOTE below for why we don't call the eof_callback when decoding Ogg FLAC */ + !decoder->private_->is_ogg && +#endif + decoder->private_->eof_callback && decoder->private_->eof_callback(decoder, decoder->private_->client_data) + ) + ) { + decoder->protected_->state = FLAC__STREAM_DECODER_END_OF_STREAM; + return false; + } + else + return true; + } + else + return true; + } + } + else { + /* abort to avoid a deadlock */ + decoder->protected_->state = FLAC__STREAM_DECODER_ABORTED; + return false; + } + /* [1] @@@ HACK NOTE: The end-of-stream checking has to be hacked around + * for Ogg FLAC. This is because the ogg decoder aspect can lose sync + * and at the same time hit the end of the stream (for example, seeking + * to a point that is after the beginning of the last Ogg page). There + * is no way to report an Ogg sync loss through the callbacks (see note + * in read_callback_ogg_aspect_()) so it returns CONTINUE with *bytes==0. + * So to keep the decoder from stopping at this point we gate the call + * to the eof_callback and let the Ogg decoder aspect set the + * end-of-stream state when it is needed. + */ +} + +#if FLAC__HAS_OGG +FLAC__StreamDecoderReadStatus read_callback_ogg_aspect_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes) +{ + switch(FLAC__ogg_decoder_aspect_read_callback_wrapper(&decoder->protected_->ogg_decoder_aspect, buffer, bytes, read_callback_proxy_, decoder, decoder->private_->client_data)) { + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_OK: + return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE; + /* we don't really have a way to handle lost sync via read + * callback so we'll let it pass and let the underlying + * FLAC decoder catch the error + */ + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_LOST_SYNC: + return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE; + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_END_OF_STREAM: + return FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM; + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_NOT_FLAC: + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_UNSUPPORTED_MAPPING_VERSION: + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_ABORT: + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_ERROR: + case FLAC__OGG_DECODER_ASPECT_READ_STATUS_MEMORY_ALLOCATION_ERROR: + return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + default: + FLAC__ASSERT(0); + /* double protection */ + return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + } +} + +FLAC__OggDecoderAspectReadStatus read_callback_proxy_(const void *void_decoder, FLAC__byte buffer[], size_t *bytes, void *client_data) +{ + FLAC__StreamDecoder *decoder = (FLAC__StreamDecoder*)void_decoder; + + switch(decoder->private_->read_callback(decoder, buffer, bytes, client_data)) { + case FLAC__STREAM_DECODER_READ_STATUS_CONTINUE: + return FLAC__OGG_DECODER_ASPECT_READ_STATUS_OK; + case FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM: + return FLAC__OGG_DECODER_ASPECT_READ_STATUS_END_OF_STREAM; + case FLAC__STREAM_DECODER_READ_STATUS_ABORT: + return FLAC__OGG_DECODER_ASPECT_READ_STATUS_ABORT; + default: + /* double protection: */ + FLAC__ASSERT(0); + return FLAC__OGG_DECODER_ASPECT_READ_STATUS_ABORT; + } +} +#endif + +FLAC__StreamDecoderWriteStatus write_audio_frame_to_client_(FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[]) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + if(decoder->private_->is_seeking) { + FLAC__uint64 this_frame_sample = frame->header.number.sample_number; + FLAC__uint64 next_frame_sample = this_frame_sample + (FLAC__uint64)frame->header.blocksize; + FLAC__uint64 target_sample = decoder->private_->target_sample; + + FLAC__ASSERT(frame->header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER); + +#if FLAC__HAS_OGG + decoder->private_->got_a_frame = true; +#endif + decoder->private_->last_frame = *frame; /* save the frame */ + if(this_frame_sample <= target_sample && target_sample < next_frame_sample) { /* we hit our target frame */ + unsigned delta = (unsigned)(target_sample - this_frame_sample); + /* kick out of seek mode */ + decoder->private_->is_seeking = false; + /* shift out the samples before target_sample */ + if(delta > 0) { + unsigned channel; + const FLAC__int32 *newbuffer[FLAC__MAX_CHANNELS]; + for(channel = 0; channel < frame->header.channels; channel++) + newbuffer[channel] = buffer[channel] + delta; + decoder->private_->last_frame.header.blocksize -= delta; + decoder->private_->last_frame.header.number.sample_number += (FLAC__uint64)delta; + /* write the relevant samples */ + return decoder->private_->write_callback(decoder, &decoder->private_->last_frame, newbuffer, decoder->private_->client_data); + } + else { + /* write the relevant samples */ + return decoder->private_->write_callback(decoder, frame, buffer, decoder->private_->client_data); + } + } + else { + return FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE; + } + } + else { + /* + * If we never got STREAMINFO, turn off MD5 checking to save + * cycles since we don't have a sum to compare to anyway + */ + if(!decoder->private_->has_stream_info) + decoder->private_->do_md5_checking = false; + if(decoder->private_->do_md5_checking) { + if(!FLAC__MD5Accumulate(&decoder->private_->md5context, buffer, frame->header.channels, frame->header.blocksize, (frame->header.bits_per_sample+7) / 8)) + return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT; + } + return decoder->private_->write_callback(decoder, frame, buffer, decoder->private_->client_data); + } +} + +void send_error_to_client_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + if(!decoder->private_->is_seeking) + decoder->private_->error_callback(decoder, status, decoder->private_->client_data); + else if(status == FLAC__STREAM_DECODER_ERROR_STATUS_UNPARSEABLE_STREAM) + decoder->private_->unparseable_frame_count++; +} + +FLAC__bool seek_to_absolute_sample_(FLAC__StreamDecoder *decoder, FLAC__uint64 stream_length, FLAC__uint64 target_sample) +{ + stack(__FUNCTION__, __FILE__, __LINE__); + FLAC__uint64 first_frame_offset = decoder->private_->first_frame_offset, lower_bound, upper_bound, lower_bound_sample, upper_bound_sample, this_frame_sample; + FLAC__int64 pos = -1; + int i; + unsigned approx_bytes_per_frame; + FLAC__bool first_seek = true; + const FLAC__uint64 total_samples = FLAC__stream_decoder_get_total_samples(decoder); + const unsigned min_blocksize = decoder->private_->stream_info.data.stream_info.min_blocksize; + const unsigned max_blocksize = decoder->private_->stream_info.data.stream_info.max_blocksize; + const unsigned max_framesize = decoder->private_->stream_info.data.stream_info.max_framesize; + const unsigned min_framesize = decoder->private_->stream_info.data.stream_info.min_framesize; + /* take these from the current frame in case they've changed mid-stream */ + unsigned channels = FLAC__stream_decoder_get_channels(decoder); + unsigned bps = FLAC__stream_decoder_get_bits_per_sample(decoder); + const FLAC__StreamMetadata_SeekTable *seek_table = decoder->private_->has_seek_table? &decoder->private_->seek_table.data.seek_table : 0; + + /* use values from stream info if we didn't decode a frame */ + if(channels == 0) + channels = decoder->private_->stream_info.data.stream_info.channels; + if(bps == 0) + bps = decoder->private_->stream_info.data.stream_info.bits_per_sample; + + /* we are just guessing here */ + if(max_framesize > 0) + approx_bytes_per_frame = (max_framesize + min_framesize) / 2 + 1; + /* + * Check if it's a known fixed-blocksize stream. Note that though + * the spec doesn't allow zeroes in the STREAMINFO block, we may + * never get a STREAMINFO block when decoding so the value of + * min_blocksize might be zero. + */ + else if(min_blocksize == max_blocksize && min_blocksize > 0) { + /* note there are no () around 'bps/8' to keep precision up since it's an integer calulation */ + approx_bytes_per_frame = min_blocksize * channels * bps/8 + 64; + } + else + approx_bytes_per_frame = 4096 * channels * bps/8 + 64; + + /* + * First, we set an upper and lower bound on where in the + * stream we will search. For now we assume the worst case + * scenario, which is our best guess at the beginning of + * the first frame and end of the stream. + */ + lower_bound = first_frame_offset; + lower_bound_sample = 0; + upper_bound = stream_length; + upper_bound_sample = total_samples > 0 ? total_samples : target_sample /*estimate it*/; + + /* + * Now we refine the bounds if we have a seektable with + * suitable points. Note that according to the spec they + * must be ordered by ascending sample number. + * + * Note: to protect against invalid seek tables we will ignore points + * that have frame_samples==0 or sample_number>=total_samples + */ + if(seek_table) { + FLAC__uint64 new_lower_bound = lower_bound; + FLAC__uint64 new_upper_bound = upper_bound; + FLAC__uint64 new_lower_bound_sample = lower_bound_sample; + FLAC__uint64 new_upper_bound_sample = upper_bound_sample; + + /* find the closest seek point <= target_sample, if it exists */ + for(i = (int)seek_table->num_points - 1; i >= 0; i--) { + if( + seek_table->points[i].sample_number != FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER && + seek_table->points[i].frame_samples > 0 && /* defense against bad seekpoints */ + (total_samples <= 0 || seek_table->points[i].sample_number < total_samples) && /* defense against bad seekpoints */ + seek_table->points[i].sample_number <= target_sample + ) + break; + } + if(i >= 0) { /* i.e. we found a suitable seek point... */ + new_lower_bound = first_frame_offset + seek_table->points[i].stream_offset; + new_lower_bound_sample = seek_table->points[i].sample_number; + } + + /* find the closest seek point > target_sample, if it exists */ + for(i = 0; i < (int)seek_table->num_points; i++) { + if( + seek_table->points[i].sample_number != FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER && + seek_table->points[i].frame_samples > 0 && /* defense against bad seekpoints */ + (total_samples <= 0 || seek_table->points[i].sample_number < total_samples) && /* defense against bad seekpoints */ + seek_table->points[i].sample_number > target_sample + ) + break; + } + if(i < (int)seek_table->num_points) { /* i.e. we found a suitable seek point... */ + new_upper_bound = first_frame_offset + seek_table->points[i].stream_offset; + new_upper_bound_sample = seek_table->points[i].sample_number; + } + /* final protection against unsorted seek tables; keep original values if bogus */ + if(new_upper_bound >= new_lower_bound) { + lower_bound = new_lower_bound; + upper_bound = new_upper_bound; + lower_bound_sample = new_lower_bound_sample; + upper_bound_sample = new_upper_bound_sample; + } + } + + FLAC__ASSERT(upper_bound_sample >= lower_bound_sample); + /* there are 2 insidious ways that the following equality occurs, which + * we need to fix: + * 1) total_samples is 0 (unknown) and target_sample is 0 + * 2) total_samples is 0 (unknown) and target_sample happens to be + * exactly equal to the last seek point in the seek table; this + * means there is no seek point above it, and upper_bound_samples + * remains equal to the estimate (of target_samples) we made above + * in either case it does not hurt to move upper_bound_sample up by 1 + */ + if(upper_bound_sample == lower_bound_sample) + upper_bound_sample++; + + decoder->private_->target_sample = target_sample; + while(1) { + /* check if the bounds are still ok */ + if (lower_bound_sample >= upper_bound_sample || lower_bound > upper_bound) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } +#ifndef FLAC__INTEGER_ONLY_LIBRARY + pos = (FLAC__int64)lower_bound + (FLAC__int64)((double)(target_sample - lower_bound_sample) / (double)(upper_bound_sample - lower_bound_sample) * (double)(upper_bound - lower_bound)) - approx_bytes_per_frame; +#else + /* a little less accurate: */ + if(upper_bound - lower_bound < 0xffffffff) + pos = (FLAC__int64)lower_bound + (FLAC__int64)(((target_sample - lower_bound_sample) * (upper_bound - lower_bound)) / (upper_bound_sample - lower_bound_sample)) - approx_bytes_per_frame; + else /* @@@ WATCHOUT, ~2TB limit */ + pos = (FLAC__int64)lower_bound + (FLAC__int64)((((target_sample - lower_bound_sample)>>8) * ((upper_bound - lower_bound)>>8)) / ((upper_bound_sample - lower_bound_sample)>>16)) - approx_bytes_per_frame; +#endif + if(pos >= (FLAC__int64)upper_bound) + pos = (FLAC__int64)upper_bound - 1; + if(pos < (FLAC__int64)lower_bound) + pos = (FLAC__int64)lower_bound; + if(decoder->private_->seek_callback(decoder, (FLAC__uint64)pos, decoder->private_->client_data) != FLAC__STREAM_DECODER_SEEK_STATUS_OK) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + if(!FLAC__stream_decoder_flush(decoder)) { + /* above call sets the state for us */ + return false; + } + /* Now we need to get a frame. First we need to reset our + * unparseable_frame_count; if we get too many unparseable + * frames in a row, the read callback will return + * FLAC__STREAM_DECODER_READ_STATUS_ABORT, causing + * FLAC__stream_decoder_process_single() to return false. + */ + decoder->private_->unparseable_frame_count = 0; + if(!FLAC__stream_decoder_process_single(decoder) || + decoder->protected_->state == FLAC__STREAM_DECODER_ABORTED) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + /* our write callback will change the state when it gets to the target frame */ + /* actually, we could have got_a_frame if our decoder is at FLAC__STREAM_DECODER_END_OF_STREAM so we need to check for that also */ +#if 0 + /*@@@@@@ used to be the following; not clear if the check for end of stream is needed anymore */ + if(decoder->protected_->state != FLAC__SEEKABLE_STREAM_DECODER_SEEKING && decoder->protected_->state != FLAC__STREAM_DECODER_END_OF_STREAM) + break; +#endif + if(!decoder->private_->is_seeking) + break; + + FLAC__ASSERT(decoder->private_->last_frame.header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER); + this_frame_sample = decoder->private_->last_frame.header.number.sample_number; + + if (0 == decoder->private_->samples_decoded || (this_frame_sample + decoder->private_->last_frame.header.blocksize >= upper_bound_sample && !first_seek)) { + if (pos == (FLAC__int64)lower_bound) { + /* can't move back any more than the first frame, something is fatally wrong */ + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + /* our last move backwards wasn't big enough, try again */ + approx_bytes_per_frame = approx_bytes_per_frame? approx_bytes_per_frame * 2 : 16; + continue; + } + /* allow one seek over upper bound, so we can get a correct upper_bound_sample for streams with unknown total_samples */ + first_seek = false; + + /* make sure we are not seeking in corrupted stream */ + if (this_frame_sample < lower_bound_sample) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + + /* we need to narrow the search */ + if(target_sample < this_frame_sample) { + upper_bound_sample = this_frame_sample + decoder->private_->last_frame.header.blocksize; +/*@@@@@@ what will decode position be if at end of stream? */ + if(!FLAC__stream_decoder_get_decode_position(decoder, &upper_bound)) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + approx_bytes_per_frame = (unsigned)(2 * (upper_bound - pos) / 3 + 16); + } + else { /* target_sample >= this_frame_sample + this frame's blocksize */ + lower_bound_sample = this_frame_sample + decoder->private_->last_frame.header.blocksize; + if(!FLAC__stream_decoder_get_decode_position(decoder, &lower_bound)) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + approx_bytes_per_frame = (unsigned)(2 * (lower_bound - pos) / 3 + 16); + } + } + + return true; +} + +#if FLAC__HAS_OGG +FLAC__bool seek_to_absolute_sample_ogg_(FLAC__StreamDecoder *decoder, FLAC__uint64 stream_length, FLAC__uint64 target_sample) +{ + FLAC__uint64 left_pos = 0, right_pos = stream_length; + FLAC__uint64 left_sample = 0, right_sample = FLAC__stream_decoder_get_total_samples(decoder); + FLAC__uint64 this_frame_sample = (FLAC__uint64)0 - 1; + FLAC__uint64 pos = 0; /* only initialized to avoid compiler warning */ + FLAC__bool did_a_seek; + unsigned iteration = 0; + + /* In the first iterations, we will calculate the target byte position + * by the distance from the target sample to left_sample and + * right_sample (let's call it "proportional search"). After that, we + * will switch to binary search. + */ + unsigned BINARY_SEARCH_AFTER_ITERATION = 2; + + /* We will switch to a linear search once our current sample is less + * than this number of samples ahead of the target sample + */ + static const FLAC__uint64 LINEAR_SEARCH_WITHIN_SAMPLES = FLAC__MAX_BLOCK_SIZE * 2; + + /* If the total number of samples is unknown, use a large value, and + * force binary search immediately. + */ + if(right_sample == 0) { + right_sample = (FLAC__uint64)(-1); + BINARY_SEARCH_AFTER_ITERATION = 0; + } + + decoder->private_->target_sample = target_sample; + for( ; ; iteration++) { + if (iteration == 0 || this_frame_sample > target_sample || target_sample - this_frame_sample > LINEAR_SEARCH_WITHIN_SAMPLES) { + if (iteration >= BINARY_SEARCH_AFTER_ITERATION) { + pos = (right_pos + left_pos) / 2; + } + else { +#ifndef FLAC__INTEGER_ONLY_LIBRARY + pos = (FLAC__uint64)((double)(target_sample - left_sample) / (double)(right_sample - left_sample) * (double)(right_pos - left_pos)); +#else + /* a little less accurate: */ + if ((target_sample-left_sample <= 0xffffffff) && (right_pos-left_pos <= 0xffffffff)) + pos = (FLAC__int64)(((target_sample-left_sample) * (right_pos-left_pos)) / (right_sample-left_sample)); + else /* @@@ WATCHOUT, ~2TB limit */ + pos = (FLAC__int64)((((target_sample-left_sample)>>8) * ((right_pos-left_pos)>>8)) / ((right_sample-left_sample)>>16)); +#endif + /* @@@ TODO: might want to limit pos to some distance + * before EOF, to make sure we land before the last frame, + * thereby getting a this_frame_sample and so having a better + * estimate. + */ + } + + /* physical seek */ + if(decoder->private_->seek_callback((FLAC__StreamDecoder*)decoder, (FLAC__uint64)pos, decoder->private_->client_data) != FLAC__STREAM_DECODER_SEEK_STATUS_OK) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + if(!FLAC__stream_decoder_flush(decoder)) { + /* above call sets the state for us */ + return false; + } + did_a_seek = true; + } + else + did_a_seek = false; + + decoder->private_->got_a_frame = false; + if(!FLAC__stream_decoder_process_single(decoder) || + decoder->protected_->state == FLAC__STREAM_DECODER_ABORTED) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + if(!decoder->private_->got_a_frame) { + if(did_a_seek) { + /* this can happen if we seek to a point after the last frame; we drop + * to binary search right away in this case to avoid any wasted + * iterations of proportional search. + */ + right_pos = pos; + BINARY_SEARCH_AFTER_ITERATION = 0; + } + else { + /* this can probably only happen if total_samples is unknown and the + * target_sample is past the end of the stream + */ + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + } + /* our write callback will change the state when it gets to the target frame */ + else if(!decoder->private_->is_seeking) { + break; + } + else { + this_frame_sample = decoder->private_->last_frame.header.number.sample_number; + FLAC__ASSERT(decoder->private_->last_frame.header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER); + + if (did_a_seek) { + if (this_frame_sample <= target_sample) { + /* The 'equal' case should not happen, since + * FLAC__stream_decoder_process_single() + * should recognize that it has hit the + * target sample and we would exit through + * the 'break' above. + */ + FLAC__ASSERT(this_frame_sample != target_sample); + + left_sample = this_frame_sample; + /* sanity check to avoid infinite loop */ + if (left_pos == pos) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + left_pos = pos; + } + else if(this_frame_sample > target_sample) { + right_sample = this_frame_sample; + /* sanity check to avoid infinite loop */ + if (right_pos == pos) { + decoder->protected_->state = FLAC__STREAM_DECODER_SEEK_ERROR; + return false; + } + right_pos = pos; + } + } + } + } + + return true; +} +#endif + +FLAC__StreamDecoderReadStatus file_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data) +{ + (void)client_data; + stack(__FUNCTION__, __FILE__, __LINE__); + + if(*bytes > 0) { + *bytes = fread(buffer, sizeof(FLAC__byte), *bytes, decoder->private_->file); + if(ferror(decoder->private_->file)) + return FLAC__STREAM_DECODER_READ_STATUS_ABORT; + else if(*bytes == 0) + return FLAC__STREAM_DECODER_READ_STATUS_END_OF_STREAM; + else + return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE; + } + else + return FLAC__STREAM_DECODER_READ_STATUS_ABORT; /* abort to avoid a deadlock */ +} + +FLAC__StreamDecoderSeekStatus file_seek_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data) +{ + (void)client_data; + stack(__FUNCTION__, __FILE__, __LINE__); + + if(decoder->private_->file == stdin) + return FLAC__STREAM_DECODER_SEEK_STATUS_UNSUPPORTED; + else if(fseeko(decoder->private_->file, (FLAC__off_t)absolute_byte_offset, SEEK_SET) < 0) + return FLAC__STREAM_DECODER_SEEK_STATUS_ERROR; + else + return FLAC__STREAM_DECODER_SEEK_STATUS_OK; +} + +FLAC__StreamDecoderTellStatus file_tell_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data) +{ + FLAC__off_t pos; + (void)client_data; + stack(__FUNCTION__, __FILE__, __LINE__); + + if(decoder->private_->file == stdin) + return FLAC__STREAM_DECODER_TELL_STATUS_UNSUPPORTED; + else if((pos = ftello(decoder->private_->file)) < 0) + return FLAC__STREAM_DECODER_TELL_STATUS_ERROR; + else { + *absolute_byte_offset = (FLAC__uint64)pos; + return FLAC__STREAM_DECODER_TELL_STATUS_OK; + } +} + +FLAC__StreamDecoderLengthStatus file_length_callback_(const FLAC__StreamDecoder *decoder, FLAC__uint64 *stream_length, void *client_data) +{ + struct flac_stat_s filestats; + (void)client_data; + stack(__FUNCTION__, __FILE__, __LINE__); + + if(decoder->private_->file == stdin) + return FLAC__STREAM_DECODER_LENGTH_STATUS_UNSUPPORTED; + else if(flac_fstat(fileno(decoder->private_->file), &filestats) != 0) + return FLAC__STREAM_DECODER_LENGTH_STATUS_ERROR; + else { + *stream_length = (FLAC__uint64)filestats.st_size; + return FLAC__STREAM_DECODER_LENGTH_STATUS_OK; + } +} + +FLAC__bool file_eof_callback_(const FLAC__StreamDecoder *decoder, void *client_data) +{ + (void)client_data; + stack(__FUNCTION__, __FILE__, __LINE__); + + return feof(decoder->private_->file)? true : false; +} diff --git a/src/libflac/window.c b/src/libflac/window.c new file mode 100644 index 0000000..132a3f8 --- /dev/null +++ b/src/libflac/window.c @@ -0,0 +1,282 @@ +/* libFLAC - Free Lossless Audio Codec library + * Copyright (C) 2006-2009 Josh Coalson + * Copyright (C) 2011-2016 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. + */ + +//#ifdef HAVE_CONFIG_H +# include "config.h" +//#endif + +#include +#include "share/compat.h" +#include "FLAC/assert.h" +#include "FLAC/format.h" +#include "private/window.h" + +#ifndef FLAC__INTEGER_ONLY_LIBRARY + + +void FLAC__window_bartlett(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + if (L & 1) { + for (n = 0; n <= N/2; n++) + window[n] = 2.0f * n / (float)N; + for (; n <= N; n++) + window[n] = 2.0f - 2.0f * n / (float)N; + } + else { + for (n = 0; n <= L/2-1; n++) + window[n] = 2.0f * n / (float)N; + for (; n <= N; n++) + window[n] = 2.0f - 2.0f * n / (float)N; + } +} + +void FLAC__window_bartlett_hann(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.62f - 0.48f * fabs((float)n/(float)N-0.5f) - 0.38f * cos(2.0f * M_PI * ((float)n/(float)N))); +} + +void FLAC__window_blackman(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.42f - 0.5f * cos(2.0f * M_PI * n / N) + 0.08f * cos(4.0f * M_PI * n / N)); +} + +/* 4-term -92dB side-lobe */ +void FLAC__window_blackman_harris_4term_92db_sidelobe(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n <= N; n++) + window[n] = (FLAC__real)(0.35875f - 0.48829f * cos(2.0f * M_PI * n / N) + 0.14128f * cos(4.0f * M_PI * n / N) - 0.01168f * cos(6.0f * M_PI * n / N)); +} + +void FLAC__window_connes(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + const double N2 = (double)N / 2.; + FLAC__int32 n; + + for (n = 0; n <= N; n++) { + double k = ((double)n - N2) / N2; + k = 1.0f - k * k; + window[n] = (FLAC__real)(k * k); + } +} + +void FLAC__window_flattop(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(1.0f - 1.93f * cos(2.0f * M_PI * n / N) + 1.29f * cos(4.0f * M_PI * n / N) - 0.388f * cos(6.0f * M_PI * n / N) + 0.0322f * cos(8.0f * M_PI * n / N)); +} + +void FLAC__window_gauss(FLAC__real *window, const FLAC__int32 L, const FLAC__real stddev) +{ + const FLAC__int32 N = L - 1; + const double N2 = (double)N / 2.; + FLAC__int32 n; + + for (n = 0; n <= N; n++) { + const double k = ((double)n - N2) / (stddev * N2); + window[n] = (FLAC__real)exp(-0.5f * k * k); + } +} + +void FLAC__window_hamming(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.54f - 0.46f * cos(2.0f * M_PI * n / N)); +} + +void FLAC__window_hann(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(2.0f * M_PI * n / N)); +} + +void FLAC__window_kaiser_bessel(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.402f - 0.498f * cos(2.0f * M_PI * n / N) + 0.098f * cos(4.0f * M_PI * n / N) - 0.001f * cos(6.0f * M_PI * n / N)); +} + +void FLAC__window_nuttall(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = (FLAC__real)(0.3635819f - 0.4891775f*cos(2.0f*M_PI*n/N) + 0.1365995f*cos(4.0f*M_PI*n/N) - 0.0106411f*cos(6.0f*M_PI*n/N)); +} + +void FLAC__window_rectangle(FLAC__real *window, const FLAC__int32 L) +{ + FLAC__int32 n; + + for (n = 0; n < L; n++) + window[n] = 1.0f; +} + +void FLAC__window_triangle(FLAC__real *window, const FLAC__int32 L) +{ + FLAC__int32 n; + + if (L & 1) { + for (n = 1; n <= (L+1)/2; n++) + window[n-1] = 2.0f * n / ((float)L + 1.0f); + for (; n <= L; n++) + window[n-1] = (float)(2 * (L - n + 1)) / ((float)L + 1.0f); + } + else { + for (n = 1; n <= L/2; n++) + window[n-1] = 2.0f * n / ((float)L + 1.0f); + for (; n <= L; n++) + window[n-1] = (float)(2 * (L - n + 1)) / ((float)L + 1.0f); + } +} + +void FLAC__window_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p) +{ + if (p <= 0.0) + FLAC__window_rectangle(window, L); + else if (p >= 1.0) + FLAC__window_hann(window, L); + else { + const FLAC__int32 Np = (FLAC__int32)(p / 2.0f * L) - 1; + FLAC__int32 n; + /* start with rectangle... */ + FLAC__window_rectangle(window, L); + /* ...replace ends with hann */ + if (Np > 0) { + for (n = 0; n <= Np; n++) { + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * n / Np)); + window[L-Np-1+n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * (n+Np) / Np)); + } + } + } +} + +void FLAC__window_partial_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p, const FLAC__real start, const FLAC__real end) +{ + const FLAC__int32 start_n = (FLAC__int32)(start * L); + const FLAC__int32 end_n = (FLAC__int32)(end * L); + const FLAC__int32 N = end_n - start_n; + FLAC__int32 Np, n, i; + + if (p <= 0.0f) + FLAC__window_partial_tukey(window, L, 0.05f, start, end); + else if (p >= 1.0f) + FLAC__window_partial_tukey(window, L, 0.95f, start, end); + else { + + Np = (FLAC__int32)(p / 2.0f * N); + + for (n = 0; n < start_n && n < L; n++) + window[n] = 0.0f; + for (i = 1; n < (start_n+Np) && n < L; n++, i++) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Np)); + for (; n < (end_n-Np) && n < L; n++) + window[n] = 1.0f; + for (i = Np; n < end_n && n < L; n++, i--) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Np)); + for (; n < L; n++) + window[n] = 0.0f; + } +} + +void FLAC__window_punchout_tukey(FLAC__real *window, const FLAC__int32 L, const FLAC__real p, const FLAC__real start, const FLAC__real end) +{ + const FLAC__int32 start_n = (FLAC__int32)(start * L); + const FLAC__int32 end_n = (FLAC__int32)(end * L); + FLAC__int32 Ns, Ne, n, i; + + if (p <= 0.0f) + FLAC__window_punchout_tukey(window, L, 0.05f, start, end); + else if (p >= 1.0f) + FLAC__window_punchout_tukey(window, L, 0.95f, start, end); + else { + + Ns = (FLAC__int32)(p / 2.0f * start_n); + Ne = (FLAC__int32)(p / 2.0f * (L - end_n)); + + for (n = 0, i = 1; n < Ns && n < L; n++, i++) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Ns)); + for (; n < start_n-Ns && n < L; n++) + window[n] = 1.0f; + for (i = Ns; n < start_n && n < L; n++, i--) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Ns)); + for (; n < end_n && n < L; n++) + window[n] = 0.0f; + for (i = 1; n < end_n+Ne && n < L; n++, i++) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Ne)); + for (; n < L - (Ne) && n < L; n++) + window[n] = 1.0f; + for (i = Ne; n < L; n++, i--) + window[n] = (FLAC__real)(0.5f - 0.5f * cos(M_PI * i / Ne)); + } +} + +void FLAC__window_welch(FLAC__real *window, const FLAC__int32 L) +{ + const FLAC__int32 N = L - 1; + const double N2 = (double)N / 2.; + FLAC__int32 n; + + for (n = 0; n <= N; n++) { + const double k = ((double)n - N2) / N2; + window[n] = (FLAC__real)(1.0f - k * k); + } +} + +#endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */