rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������T���D��lx����0����\����X���@��������d���$����� �(�X���@����x�P���������P���$���h�����0�0���	8	���,p,�@4`�� ������H�� �������P��������P����|�� ���t��8���	�� ��
�d�l%�)X(�#���p
4 4���
�	L�������P���|�Lڤ�������8������������L�������, �LP��h$L�P!�&�&�#�!|����������������H�L�x��d�����D�(���4��x�p�0���8�H�l�X�\��t�	���X$!��dd(�����lP��������\������<���\�d���(�D�X�4���۸������l���T����8�8	x����(�,)��x
�$(�	��@�$X�,��l�ߤ���D����$�0�������4���`���p�����@����(
 
��
t`T\�#�'�$�X����@� �4D������(�L��X���L����,���X���T�d�t����� ���`�4�h�X���X��@	T�L����h�
��\�t�\��H������������0�(���ۈؐ�|���(�8����Xx�d����$,��|�#�)�*x$ �
$�
	t
x�0��	��p�������8�0��T�0�H��������x���Xؼވ�<�p�T�H\T�P��L�d
 hD"L+@-�'0������\�h
h�������$���������p��x���,�\�$�t��L�$�D�� ��\�p���X��LH " @�4H���H���H��P�H�,���4���L��,ߔܜ���H�4��������T���x���P�x���8���|��!�%�%t��	���<�t������������T�h�`�D���\���0����ߔ�$�4�`�T�`�|���(�H
���tT4���#4+�+�%<��|
��������TX
X��l������ٸ����,������X��t��p�������D���px��P���H	X
`4X"�#� t<X��$�h�P�(�,�X�P���h���������$��,�4�T��|�������x���H���x����X����l�!P h<�	��,��(�@Lh���p��H��x����L�L���<�� �$���X�P�P����H���0��	�0�������
8��T#)�(`!�PD
�	h�h�p
@��\������hݔ���X�L�\���X�4�h�T���d���8����,��� h
��
\�4�
�h�%�%� H,����h���Ll`�����l�����l��<ܤߴ�����������������(���� ��(�l����\8��<
�<
��<��������������8�X�$�8���0�8�������Xވ�(ߘ��@�<�L�p��������������0	��H� �#�!��0�

DL
���xh8
����������������<������@��x��P��t����p���@lx������
0��X"@&�#h�xP`<,���
�
�$�D��H�P�������L���H�H�X�|�P�����8������D�X8
�H��,
�
�|
�
�	�
�dp t��(�4��������D���������P�$����T�x�t�t���D��������������������d�Tl��\`	(�<H��\x
��p�T�$��P�D�����p��0�d�P�|��@�|�<���������������X�
4l\��"�tt�����@t�x�d�h���t�l��\�@���$�h������X���������4�����P	�X�	�	���
�
�\d��8��d
���(�D�8����h�����P�8�����h��0��X�T�������������������l	���`(x�
PH	��$��l�
������$�T���h���P��8����(�X�T�h�h���|�x�d�������LP(���t�tL
�Dt�dX		H	p�X
���
8�L�4�8���`���������|����8����d��������T����8
H�
4�@x�D�	���@X�,D(�����H��\T�t�H�$����X�����������p�p�x�8�<��$�,�L��\�	$�0H�
0�X	�p@	(�������
�t�D�D��������������D�����8��������������@����P�t���T�x�t���h�	$ ����TD
4�LL
�

�
8
D�x\��t�X��|�4���4�D�l�������p�T�T��`��<��\�d�(4,����4
���$��tLH
�H�hl8��	��t�L�p�d�,��4�t����t������������`�(�(�������8�	�
�
Hx�t�$���\���p	�������d�t`�h���������|�t��������������������\�����d�X�h�,�
�t��l,�lt�$	���,�P|	���t��$�P���� �(�`�(���<��t���8���8����������������x ������,�	l�
��dH
�X<��@x8
@L�D���x����������l����P����������,�@���h�x�������PD@l��	�
��(
��T����L$���h�@��<�����|�<����x����P���������������������	�<�	�X	�	�xD��	<
��
|��(
��T���4�,����l�H�����H��d�����,��@�d���@�|�P�h����������`���p8
�
� 
Hh
T
��(��P��<	`
,	x����������`����H��������P��� ���X�����������t��t����`��@(���� X<@8�(��,�h� ���H���,��0��������D�p���������x�\��0�����d�D����$�x ���
,��
�		������T���,��� ���P���,���t���0�H�H�d��\�������T�$�����0�������t�@p	�	�p��T`�����X`�����,�x�\���t�\�0���$������,���d��������@�<����$����l����������
��
�(�XT@(�tl��`�����x�� �,�4���`�<�l�(������������������ �d8D���tp��`�X	H
�	X\T���@�\��4�������(�� �����<�$�������4�L���<���t�4���x�������HH�H�pp�(�l(d�XH,������h��������x���p��h�@���D�,���4��H������0�����h���(�0�������8��|����<�$4���(����D�t���h�P�(�,��������H�����$�����������������t����x��t����d����$�����Dl������<�d��������x���D�l���@��0�p�$� ��������<�@�����$l8`h�8���$x��������������t�������t������� �l����������`���$�����4�@� �\�d��������( hx0�XTDh�P<�P���\�D�������@���H����������H�����������������0�p��\�X��X�,�\4pd���h�(�@$lp��0�����(�����`��h�T�,�8�d�T��������l�<���@����x��L���8HL�\@�� �,�l���p���,�t������8�H�P�����0�|�����$���d�|����8�X������������<8������lD8$�8L��(�(�<�(���\�����x���@�������������<������������������T�`����Xt��$��������(\@�0����X����������L�l�L����������T� �D���$�|�����4���P X����D���h���` ,h�p4����|�������������,�\���x�D�����D�l�������T��������th������T����������������������\� ���(�,�0�P�����������������������$l��������P<Hh||x|��` ����������x�t�������������x�t�p�d�X�\�x�������$04$$@T`l����`@0( (0 ������������������������������������������������(<<0  $  $8LXTH<80(����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$(,  ((����������������������������������������������������(,4@Td`P8(  $44 ������������������������������������������������<TT@( ,4448`�����thP$������������`�<�<�T�d�h�t���������������������������4|������|L0<p��������,����������������������t�(��������������l�����������������������,���<hX�xp������$�<����p�8�������8�������`�<�,����p�8�L����t�����8���X,h���X��L��l��4����0��|���L����`���������$�`�P���x�<�`����0�d����4xT�������� hP����4��`�����������������D�t���p�l�x�d�`���D������p�<�D�h�p�@��L���(@x�l���d����H�H�������$��� ���H�T���L�������,���h�������H�����$���������X��0������|d����8��D�������`���p��0���8�`��P�t����h�4���4���\�4��T|h�,Pd�l�(�|����d�����t����|���$�������<�t��������������H� �t����������h4��$�@|X<(`0 `�,����$�������d�����X�������|�@���������`�������@�l��x�@���h��d�t(L�H0�$��Th�(�����������|���l�\��������4�(� �����4���H�������LX��D��p����X8Hlh`�������p������@�4����������$���<� �����p����|�T�$�`D���<T�d��h��L(��t�`����P�����X���������������������������t����`�����8�0�x��x������px�PDT����h���\�������������`������,���������p�����T������� ��������H�D�	�	����,P�@�(|0`�H�,�L���L�`����������H���������H��4������d����d�|�T	�
T	����d�(���TLL�<���p�t�D�d�p���`�����$�l�����������x��� �,�����8(�t��l8�p		x��H@��<�P����(��L�������������`�`��8���������T�����T������
t
�0
�\����$4l����x���<����������D�|�D�����L�<�\���4�`���4$������\L
�
���	���(����������������������������������l��������,���������h�p	�h�t��H	p�
�T
8
(	�����������l����H�$�|�,���D���l��l�d������t�@�����H�<�,�T�T��	D�X
��
H
��� l		d��
�
����x���8���L�$����������l�L��`�����4�X���h�H�������l�����	�
�
,�<
�	�T���D8T�x(��(�L���h��������H����,�X�l�<�(����������4� 	�
L	�����0(	,
��P�
��
(	�0���������8�����������4�����<�x���L���������8�@�,���� ��D
\
�
h8p�
\�
D
0�0����P���D�������H������<������d�x����<����@�����t�������@�������	�,	P��,	ld
\
���|�X���@�8�(���X�t�����D�P�����������t�p�t���H8l	L
��xx�t	�
�
` h�0��0�H�����X�,����P�L�|�$���������<�P�l���T���4�l��p������t	t���
@h	xhP
8��h\Ht�h����\�������H������P�P�h�����p�$���(���� ��$����������������$
�`LL��@d���PH�x��
8�������P���`��p�p������d�������\�D������d���t��P`�(���l	��
x�DxP�H
��
�(�$0�|p�����4�<�8���P�������(������ �$�T�����������T
<P8�	T	�
�
d	��	�XX��D� 
������������D�,�0�|����D��������\�P��(��|����`�,�(���P�x�P��h����Pxd�h�8�hx��lt�l�����X�t�(��,��D�l�8���d�����������L�������t<��p������|L���8�X�<X��$�\��	�������x����8��l��`��������\�p�\��P���L�����H
��
\	p@$�
h8
4�<8L\�8��|����D�������<���`��������H����0��|�\�����d�����������hT���	HTt��L�p���p��D�`���������l���,�8� �@�� ��,��@���@�p������`�\���0���	�PH��|Xt�
8L0�px�$ @������4�������������<����t����������4�����pd�
�	$�H��t����`#(!�0��`|L��,	@�
P<L���x���,���\�l���������h���t���h�����������|�h,P0<�
tl\ p�8���`��0�\�d�������� �����x���T������d���@���0���������������XLl���

� h<��,T,�L�����H�d����������|���������������P���H����������P�x48��,�!$ ��
x
@
�
(Ll������D������H����`�������P���X����L��T���`(	D��X8d�\d
�8`"$ 8$���
d����,����������p������������8�t��T�����������0�t�8�H��P,L��
�L|DlH�,
p��x���������H���D���x������߰������0�,�������������p��������X|!�%�&!@x��H�<��xh	���d��t�<����(�`���`�����P���@��������,��`	���,,	�
�h�!�)�*%��l4@
H����T�
8��X��������8���|�D�����(�����������@�����hX(���\��

H��<#�#T 0x��	��H���������������<�4����ݼ�`��ެ�ތ�,��|������4�������$�4��$�$,��pP<�T��0p�8���l�@����������l�T�@�P�H��@���l�x����4�h���������<�	��X(!�'�'� �(H���
h	���tp�������� �|�����,�0�� �P�D������X�L���������DH�X��H�
��t T&�%� Px��L	(|�8�LL�h�����x���(���,���T�,�4��l� ���D��T������P�����p`<|8�hTD
@hTH���`T�`�|�(�@�������h�l����`�,��tݤڌ�����|�0�$����P�t�|��\���p	pT�p"�&�%�P�`�������0����D��`���T�8�������������h�xې� ��������x|ld��8p��$<*�(�!dD���D<�����	�����t�\������<���0��(�L�T�P���p�������������8hD���0
�
@�d#\!�@�P��������������� �����$���dݠ�L�������������@�����x������� ��8,"�$$"��
0��L�t��h|��l�0���� ����������(�d�$�4�h۔���0�(�4�l8���<���<$���'�+�'���d
T`�0����t�����P�|�t�������4��t�l�0��8����(�@���`���p`������p (`�%)�%$  ����D���@�\�\������l����� ��<�x���(��h�������|������������PpH��d���	�
�4�x|0P�X����(�����$� �(��,���0����d��(�xټ�h�L�P�����x��D���x�������
���8 �%4'�!�H
(�xL�$����	<4����������P����h��������T����0�<�0���D������x`���
�
����&($#�p�t �������	�
|H�X������ߐ�T��4�P��0���`�t��$�������d�\�P���
hl�D�t�<`��$����t�	4���@�l�@�T��X�D�$�$���� �@�����ߐ�p�����@�`����� ����x�t�,��P�P�P4
0�8|��4@T@������p�����<���4����l�����p����T�����P���`�,�``<L8����P�
��dxd#$��pp
p�$�	���	�8� �X�(�T�`�D����$�,�l����������D�D���,�����h�`��$`
|�l
lp���H�|������P�������(���l�,�4�x���0��d�,��\��(���T�������h��h�X���h�|<���\��t�
��@
0|PT8����8�����\�h�H�,�<�������<����|��ߘ��|�$������T\�������4���<�"�"�����HT\
p(��������\������h�������D�������`��H��p�t���8�4�X�DPt�
�
�
D�"�!�\�
�@�������40��P�4�(�������������p�T�L������@����L�(��d��L�l��
|D	p���l�$�0���������(������<�@�����T�������l���<����@�������\�����X��������Ld�p
	L	��

|TH�����������P��\���l�����H��`�p��(�������H���`
�������
0Xd���x �t
(�����X
�@��L�����d����8����������� �H��T�h�������D���lh�@
 P�<�4�(��@,
���������$���T������P� �,�d�,���h����������������$������8X	X0T���$�
��	�
������	|t��l�������������`�,���|������h����p����������������t������h
X
 
8�hT`�
D����h����8�H�����0�����(�\���������h���x�������
D�	�d�D

�
<��|�Px
 	0��$����8t�h�p����<�����������$���h�H��������<���,����,�
\hx
$�
<L	�
��H�
HD����\���4���<��h���X�����T������������������D���`����� x4X4D�
<	��
�	dp�
�
�,������h��������4�(���`�T��H���0�x���0����\����4�D�HX�d	@
T
`��l���	�TD�����X��$�D���������p��,�����l����������8�����8�\|��X	@	
�	����
�(�0�

 
���t�T����������x�h������L��0�D��$�0�P���$�d�����L���������0�(���@
�����	4	t	@\
l
,
���h����D������x����� ���L���L�l������ �h�������X�� @�T�$|P�@	�����L4�H��x��p�`���������p�0�������������<�x�T�������@�L���4�����	�	�t�����`	�
���t �	T����\���P��T�����X������������0������(��L���t����H��������
�
H
L
�
�
����@,
�D�
$��
0 ��������H�<�,��������P��X����T�T�@�� �������L�������`���T�d���	�
�x�
�pdX�x4l	�\XX���������L���<�������0�����\���$���x�`����@�����lL��4��\�\	�8�
(�@p(����L��Pd�t�d������d�,����4�(���x�T�l�(�(���������������T��H�(�d��d�	�

�h0<��������H�4�h���L���������<�0�h���|�8��8�����,�|���l������P����@T����H���X�tD��L4�xh���h���`�t���l�����x�����������L�������`���<������H�����4��8��t	��8lH��t�P�@��� �x�0������������(���D�(�����D��� ���l���\�H�dx8���$�T��|h8�L@�D����t�,� x����� ���h�0�\���4�����������0���0�,�������d��$��hp�p�X���|t4pl��(������<�h���d�������t����������������������<�t��<�h���4��(�\��X��`�|H����Pd�����H���\�����D���������l�,���D�t���0����,�|������L�0��(��L,������x��|�(�X���`���<�����,�D���@���T�(�����������4\��@8@�$���������0�����������p�P�����8��������H����@�<���������������������@����$t�\L�X\D����T��(�����h���T�����\�<�����L�������8�����������x���X�|x�<��L�`���d�T|��P�T0�8@�@�����H�\�����������0��������4����������$���t\��hPdX��x,��h��<x��4�<����������������������x���������H���������X�(�8�T�H�����@����������<h\\���8x��`�<�$��������������0�������\������@���t�������0h\������T��T��4����\<T���T������@���������,�`�d�T�\�t�x�D���������@�������0����@0DX\\t� ``0����@������@<$����,�������$�0�T�����������p�t�����������h���|��h< ,X�������t,����������������������|�x�p�`�T�\���������������������������4P\l���hD((0440<P``@ ����������������������������������������������$������0HTTH<0,��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  ���������������������������������������������� (0@HL@0$08,������������������������������������������������ 4<($(0Dd��|`L@4$����(4(��������h�\�h���������������������|�����������P|�|lhlhP88`��������<������������������������T�������4�|����������������������� |������dTp��������@������h�@���H�������t�4�������l�l���$�������8\X ������<���,����8����D @����P����,���@�@��������@�x�|�4���l�h������D���(�8@�������(�(0���px��������������������0������������h�������� ����(�$�� ����d������������4pp�������������|���\�������d�4�����������\���������$�������`�<�T��� �`��P,d�`D�|��<���P����$���������,�����x���,�`�<�@���X���|P���@<�,p����|��H�,��(�<���������P�����H�������d� ��������������\�����D�@�h��H�X���`H���lD�H������������������X��l�X�L����@����0�h��������|��\���p���(�4��L���X��Xt�h������8������������D��������h����x���0���\<����P�h���L�P�4���D�����,����������8��� �l�l������� ������H���t�������`����l�H4�������8��(���������|�l�X����p���t���������p������������d���<�����D<��8��x�`@����LpL����d�`��P���<�����l�����t����8�<���<���D�������h�<���������l����X	�	|4@���� P�$� ��������������l�h��������8�d���`�����������@l0t0���D4��	$x
���tP�������|�\����������0�����D���H�������x����� ���T�����<p��p4��x
�		�|(h0������x������������������� ���H��D������t���@�h�d�X�,�������|��44�$$	�
�	����x<@8l��4�<�|���X���D���(�P���,� �T�p���l������L����������$(40$	\�t�	���PD���lP��(���(���������x��������0���\�������������|���X�<�8lx�p
�
$�
4
�	l���d������X�H����0������� ����(�����������$�L������l����x��	4
�	D
@t�	�PH|	H

�	\
h,T���`����h����D�������|���t����t���P�8��p���\�8����������	�����
�	P� ��x�$	�8���,�D��@������|���(�l���X�<�D�@��������D�d��|�XP�X$���h
��
� ����D�0�`�\�<�����L���������D��`�������D�<�0�����L�X������`h����8������������|htt<�x����8h8�0�L��������\\�t����P�����8�H��������(���@�(���L���P�@����,\\,<l�|`D4X0��������������������������������T�4�4�4�@�L�d�����������������������������������������������������������t�x�l�T�D�P�|�����h�D�(�0�<�<�<�<�X�x�������|�x�������t�t������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $ $$(((((((,((((,,(($         $($(,(,,($(,,00,,(((($          $$$$       ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������     ������������������������������������������������������������������������d���||||�0����T����8������������X������`���0������p�\�L���������L��� ���h����8�D�	�	H	���0l,�D<\ ��������X�$����t�������H���������� �`��������(��,	$$|� D	�
��� �#�"�|��	���d��4
�	��X��d�P�h�T�ޤ����������|�<��X����������
4dP� ������X �%�%�"��4|��H���(�4������,���H�P�����ٜ٨�T�4�,�������������� �H������
x� �!#�$T"`�
�
D��lpH�,$���������<�����������ߔ���L�������\@���P����
8���!�(�+�'��\����8�	4<������`�D����t���x��X�d�������T�8���������H�X�
�X	00
8�(p�#�%"H��� 
��(��t0�p��������X����ڤ�X� �p�(�<�`� �����d�4���������l���`��((�����@T�����8�����H���$���@���$�L���ߜ���T��\������X����l�p����$<��l !P#�<�
����|D|�	�������p����d�@�t����D����d�0�ܜ��|����8����
  
�\@�d�$P� L(x)�#��`�
,0��L
�	�����h�����dݐ�xߤ�t�������T�h���h����������H
���L�H�
`
�
\�4� $�<��P
$�����t�4�\����,���������l�d�H�<�`���L���`� �����X��X����<8p��X��
x	D
����d��PD�����|�0����p���������l������x�8�p�������� 
�	$��p�h`	��D"�'X'@ 4H� h��|T P�	���p�\����ި޴�0���������p�(�h��������L�0��h�
P
��
�t� d&�%, ��H����<�@�DL����0���L�D�������,�p���H�H�(�����H�<�X���������p�������
(�h�`\<$P�<��p���|��������p���4���l����X�h�X�� ����������������t�p��	������#"�<(
h
$|�
�P���
p���D�l����P�p��X�h�L���������݀�T�����(�@@
�
��,��,T�$x"�&|$\d��L
(�����,
������d���l��ݬ����h�X�����T�����H������l�4� �8���$x0�8HX
�
48�|0�|�0
���h���(���0�����|�4�h�@����x�4�����d�H�D���������H�@���l�D	��� �����	��P�����h8d����,���H������������@�t����(����h��������������4�$�HxT!���T�
8�����<����L�����0���d��������0�4�\������\�8��0��������44� 
lh
P
d�
40��$��0TD����������,���D�,�l�X�����h�$�D�$���L�(�����$���p�����
��,�P����
���������
�$�����������L������t�H�|�������(�������$�0���@@����p���
�HX�H��D�xx�	�	h
���t\�X�<�4�h�L�h�8�x�����@��p�t�<�����������`����X�X	�8��t
�0
�d8��8��
4	L�8� D4���������H������������T�T�D���0��@��������
�����$�
�
<<��hP�L,����$���\�<�0�@�$���4�|��8��� �t���,����|�����4�`����������
���H��h
H0p	��$����x�d���H����������������(�`����������\�8������<����\8	H8
�����$l
d((��������,�������H��������������������H��������p���	Ttd|��T	�x���8��D�t�D��(��������(���������(����������4��H�������������|��l���L�lH(	��	p
���`lh�X��P��������������������������h������h�t<�����4���� 	t
����P�4�$�h�	���d��t�0�8�X�,��T�������������0��T�D�(����T���dL
L	(�tTdD�
$`�
��
�t ����tx���d�����������t�����(�P�4�����������L����x���h�|@
8
�|�d�
���`
 ��l
8
�
�$	\L��H������P�������0�������������4���������������@�x���<��������
��� ��D���$�
��
�t����(�������������L�������������0�8�������x�@���@P�dp�P	�x|d(H	\�����@�h�0����0�t�����L����������<����8�4����X�,�T�����	�
0
h��4p�p$
�
 D��P�	0P�� ������|�0�<�����t�������X�4���H��H���D�,�����`���x�pT
p
�
8
	�dPd��`�4
�
X	X�l��t�d���d�,��������������4�����0�������h��h4����������4	�|��
�
����LD$�������h������X��`�p���������@�4�������������<�����d���� �� �	���
T	x\�X�����H|t$�������\���L����������p�L�l�����t������X���tl����\��,	�����h��,����4���@���H�@���������4���������4�h��0�����H�����P����$�$	d
�
���p�`�0�����������0����������������� �|�8���|������XD���,�Th��`L
�
,	t�$�0T�d�� ����x�����x������������������������������<�x��XLh�\��X�4���4�p0���`�x�L�������p�������x����D�h�<�h���|�@���\���0�������`�p����(x��D���p@0�L�l���x����<���H�|�X� �H���X�������H�|�����0��x��8���P�0T�,�l��HhD(��LLhH(�������x�h��(�$����d�<��,�����(�(�x�������l�������� ���4�@��,|(�X8`���(�H��l�t�x�����D�p�t���4�0�4������� ���������`���x�����xH`8L��0��@�D$$h8L���������@����� �������������p������������d�t���d`��T�D�����@���(@8�l|`��D4x���P���,�H�����p�,�|�`�,�4�l�l���<�������h���D���`4�����$<8t�pX�0��P��������`����D�p����$��������`���h���(���l�������,����X������h��p�(����$T��`�l���t�P�H�|�����`���0�������������\����������������x�<�T����Xx�� ��������\�d�<����\���������p���d� ���������@��,��� �t�����`�h����h���4���\���h, P���p4����@��������,�4�0�D�l���x�8�������0�\�t�����4���h`p��ll��0�����4��������������`�$����� �0�`�������������������������0h������pL8Hd|������T������������������������������x�h�`�t���������������������(<DP`txdD,($$  0DD4��������������������������������������������������,88, ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  $(,($   $(,0 ������������������������������������������������������ ,8H`txdH4(( $8<(����������������������������������|�������������4PP<($(00,<`�����xhP ����������������`�4�4�H�X�`�h���������������������������8��������X<L��������p������������������������4�������������|�����������������������<���8\H�lhx�������<������P������,�x���|�P�8�0������D�`���,�|�����4���XL����d���@��\��4���l$����|���H����h���������0�h�T���t�<�`����� �X����(pP������XD����@��l�����������������h�����������������`� �����t�4�0�L�T�(��4������0d�T�$��T����(�h������d�8�h���`�h���\�������4�����������h�����p�H��X���4��T������hP<��������8������������T�d�(��8�`��T���L�����|���P�� ����L|l|80x@��@�p����0��|������d�l��������p����������������0�����4�P���<� �<�4T�X44�����������������T�|����T�,�����d�h�<����������t�h�������h���D���h���t��`�T��TP��0����|���������P���@��X���|�h�����������T�����������(��\l@�������@�4$p���������@�P�����D�D�����������P�����������$�������p� xh���Pt���$��|\@����d��x�H�����X�����������x�����������������l���0�������d�x���X�d��4@$H��|����8t�<��������������P�D���0�����������������D�����L�08 �L�����\��\
X
�8�pP����T\�T�4�D�������t�T�(��� ����������8�����l�p���`���`�tD `,	�
�
�	�4�h�(���HT 8����\�����d�p�d�h�<�d����`�t���������H�<�����P���8�����H8�����H|�\x���|���,�`�T���L���,�(�l������������T�0�(�����H���`��� ����X�	t�(�	�����t���$���@��D������d���`�L�������\���������p����l|�L����|�|
�
����`�X�|��H�4T����x������������������x� ��������D����� ���p	$l��X��,�@
X
`@
��
H
	�P�����X�@��L���������D���<�����@����x�����p�������@���,
p
��
,
\
�|��	T	��<
0�	����H���l��x����$�\��8���d�@���4���H�D��� �����P��l�t���������	���L�4	x4��(��<��DX������\�d������X���(����0����<�|��p�������X	��������(�X
��
�	0����������h�D�����T���������X��$�����|�������$�<����������
�
(
�
��
�
�T�
�
L�
P
0tl��,��������������X�����x�H������(����|�����\�D�Pp�\��t���t��$
4�,	P���d�
�
t��p�<�T����P������X���x��������|�$���$��������`	�
� <|P8��	��|� �\��
PX��l�p�xl���,��$���D������ �����������t������`����H�	0�l�
`
�
��	�l�	XXP4L\��
��H�h���,�����p�� �h���x�L�|���`��X�4���������t�x�4�����p�|�
<�H�(l,
��(�<����
��� ���|���<���d�������8���(�����d���D���8�$p0�d���4
, �d4$�
$�	�����4�0���p�,���P�,�������t�P�4��t� ����� �����	�\Ph		x
,�	@d	�Xd��X��
�p�8����������D�T�����������@�����`���8�,�L�<���D��P�p�<�����p\xTdx�������p�����x������<���$����T�P����l�����X�d�(�<�X�������\��D���4�`h����d�`��\�	T	�
���
8��h�x�0�x���|��D��L�<�(�����|��T��� �x���	�
�HT(00
|
��h`\�8���(��4�����p�\����$����P�����P�|������D���������L����� �H���h��
p�P��X
�$����<�,�t�<�X���@�������<�������<���$�|���|����$����@���	(D(�|h$Xx�
|0|\���
t�����X�d��P����L��h�����������h����X��x�	(`�����
�
�����"t 4��<
l(, 	��	����`������d�\���D�p�����0���X�����d���8� �t� Hp��d
���
`�0�� ��Xp��
4L����$�T���|���T�p�t�$� ��������d���p�4���������$�0������
��PHx��
�
���x�4p������� �h���T��X���l���H����X���8�L�������|�XP��������@�(#�%"�<�
P
�
�P|`�4P`�t����$�,ߨ����`�����D�����<����������	`�`
�	@�
`
 0��#�%"� �D�
���d� ,�$�X���t�(��\�� �l��4���,�������P�H����,�8�L�P���d�������	��,�H8���	��t���4�0����h�(���H���\�����d����ۜ�L��$� �`���D���X�����������$ �$�%` ��<X��x��pP����P�(�������������H����8ڈ� �D��,�D�L���4
$��H
,��|"�)\*X$���D
�P��	L�P
l��8���D�<�@�hې����8�,�`�,��������$��� ����8H0��8��L�
L�X$�$!����@
���H���� �����������d���8�h����ޘ�x����D������l������D��\�d�����`(P�|���L�����\�������0��������T���d���4۠����<�������<��������0�(�|%�$`���@�
��	T P`p���������d�\���T���8�\�|�x���d�`���P�������P��4L���
�
�
�Pd`l &%�Hpx���`����h������T�p�����`�`��ހ��D���@������8��d�0��������d\\l����x�<�T��,����p�����h��,�0�������<���4����H�����X�������p��L�4����\��� 4%t$�������
XHd������p� �����������$�������P�����\�l�<X\(�
p�d|8����!|'`&  \xLTd����
�	$������L�`�<������\������8���4�����H���|���T�T �x �\
0�!� ���������8���x�8�8�������T���\�Lݸ�d�H�`�0�p�`��<���D�T�\�h���,�\����X�<"�$�!|T�4
�����4l�\D������`��t������`�l�X���H��ۜ�\�����������
�\�����
8���<%)�%��H�
��`H��	�@������� �������`����$������������4���������	�$�h� 
T�H���#�&t#H�,<�T���,�����|� ����P��<ް�x�$���@�����(���h���d��������Pd� �8@h\$
D����8�t��� ����(����������������H��ݐ�D�t������8�$0�8�8���d�
���$%D'�"���p�8���l@h�	L4�P�X��������\��������T��\����0�@����|�L���L���(�
�
 �l�X&(p#���@l
�,�	<
(t�D��������@��� ��X�����$��4���p�������������
�,��P<����$,��HX4H�$�`�p����d����������|���d��X�\�|���������4���T�,�������t�
\��$X
��X�x,�p����D���X�����X��@������,�|�D�@�t��D����$�����$�d���H����,D���"T#H <�
���	�
�
	�������L������4�t���8����\���(���(����8��`�`�
���
Lt� , �@� D����<�����x�(���@��4����$�d�8��\���d�|���h���H�|��@�<���p�l�����ddl`L
|��
��h�H,X�8�T����\�<��D�T�t��������d�l���T�����T��������L�T�`�0�4,
0�@H�""���
|�@�	��
X��
D��t�h�\�4��P��h���������0����|��$�L�����4�
8<`	L�p	L
�
\
��� ����d<|���|�����,���������\��������4�����4������0� �x����������l�	��`�D��
� �D���������|����������X����H���4�L�����d�d������d�����������dP�L�p
P
�(P
x@P�l0D���d�����l�,���|�����@������D�,������x�\����x
����0�P�����0�
�
@��(	�
$��������@����4�T�t�$�������0�� ���0���������x� �0���<	`�8l�0,PH|0
����|�`���,�����x�P���$��@��D�0���`�t�������������$���P�0�������x�H$t�t�	`x	�
�������	xp��`��������X�@�4���h������P��������,���`����DTH�������H8������8
�
�
p
\����d��`��������D�$�l���@���$�L��� ��d����8���,�����
4�	�|h		�	
(��p  
��h�����0 ���������h��8�@�����8���(��������� ������L��
���
����H��
`p�<��x
���P�h�,��H���|�8�@�����D���$�d�l�|��`��l�D��<����P�$���������	`
����<@�
�	l�	(�
@	$	h<��(�����p�p���H�� ���D�|�\���T���X���\���X�0�H��h�,���0��	�
dh\���h�	�H�H����\��T�P�����8��t�|��p�����(�\�\�P����<�t�X��$�\
x�	�	<

 L�	��D�L��
�
dx���������H�(�X���������������D�H����|������(�p�������p������|$����
p�
��$(�	x
(
P
��
p
�	L� � �,�@�@��x�����������,�|� ��(�@����0���t���$�p|�����LH��p���h
�����ddP�����d���(��� �P�(�X��������������0�������$�t��p�t��	8	�l���L��l	�
�` ��
\	��������0�@�������|��l�����l����8�$�t�X���$���d�(���`�p�h����|�
�
�	�	0

T���|�
��4��
���������0� ���������� ���d�(����p�<�|���(�@���������p���@���t�����	�
�p�
�
hD@H�<�pT�	���l���t�|���H���`��������������������� �P����t������H��
<
�
|$l�T\�t��X�(�L�@���\������0�����������������|�������h�,��h<�(<�H�T	H
�	��lX�$�(���d�@���D������x�d�|���8����� �(�<����� �|�@�`�������8x��d`	pX���4��T<xP �H�����d���$��������������x�\�������P������X��������@x<���		� @�@�tt�X���l��������\����0��d�t�L���p���<������H�$��������D������,8��$���0�������l�����4���X���L���,�H�0���l�x�����������������8����������D�L�@x����x���Dp���`���@���4�`�t�x�P��������L�x�,�$�4�d���4�\����|\���(��h�(�@��(����<��t��t����4� ���@�������������������|�T����d���p�,�T�(h��xT<lp����������������D���,������������T�T�x���������\���������$�x@0�(l\ ���|����\�l�`�(� ���X�������\������������`�����������������8�\��x�|���D\����<��<���x���T�����8������l������l���4�$�����������t ��(x$`�\��h4��x��h�T����d��@����0�p���������t�����,����@��l�����4�����4����p$��l�t0��L���4�8`���(�p��������������������d�x������������������`�d�x�p�H�@���X$����������(\\Xt�� d��<����������p�����<�������l�8�� ���$�����Hl`������\��T���|�|p\8,H����D����x�,���������8�h�l�d�h�x�x�D��������L�������4����TH`pldx�H@���|0������0,����4������(�,�8�\�����������h�p����������� t������lD(4`�������d����������������������x�l�`�T�L�X���������������������������0HXp���d@,08<84D`llH$���������������������������������������������� (���� 4HPL<, ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  �������������������������������������������������� (08HLD0 08,������������������������������������������������$<D4 ,44<Tt���lTH<$���� , ����������\�P�d�|�������������������������������Hx�xhhlhP44X�������|8������������������������d�0�$�(� ���8�������������������������(����$(�|l���������@����|�d�@���<�������h�0�������t�p���$���������0XT ������L���(����4����h<L����,������$���D�<����������P�X����d�l����H�t���L�<8��������D�PP��x |��������( ������������$������������`���|���X����������������t\�����$��,����8 ||�� �������p���T���X����������(���������H���������<4��d�\����p�$�0���p@L<���\t��X��h�������T���t����������<�T� ���� ���H4��|l�H|������� �<����t�����t����l���p��H�X���������\�$�����T�h������(�h�����h������4�$����t ��Ph�p���������D�������P���,�������\���@�p���P���������p��d�����(t�H��@��l���@�X�Ht���(�����H��������� ��d� ���� ���X�������`���|X�4X�������``�p��@�����x��t�����,�t���@�����������`���|�(�����������@����L�4$��p���td�p�x|��������<������l���l�x���,��������������������|��h�@�(��D���xX��(�4 ����� H0�<���������d�����������8��L�H���0��� �������T�D�����D��l�X	�	�88x� �$4h�P�,������������H�����<�H�p�����$�X�l�|��x����P�X�|���`X <�T�L��
�D��D�PT�8Tt�������P���P�t�����p���8��������<�<�����������X�@D`x��p��\H
�
�	��p�h�������������������������t�����`�D��������x�T������|���H���`���,
�
 	|D��T�D0\d<�����p���<�����\���P���,��0�P�x�<�D���p�����,�H0| ���D(8<<	$l�hx	h�4���@H�� ,��p�����`�@�<�����|������l���������T����������� �`���@�
�@�
�	dX0���8�����p�p�,����T�L������|����L��P���8�����������������lT8
�
�
�
�	h���$
�	�	�
��LX���h�,����\�@��T���L���P��� �`��@�������������P�������L��dt	�
�