rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ ����tP�t������\�� T��������������l�������X�t��������T���l����������H�0���H�,�����@���\�P8�p���t���X��X�p��d�����t�����x���h��,�0������t���P� �(�	�
�T���
t�#0&�$` �����	(TLD\
�
�dD���d����h�L�$���0��x�@��������������������4x��Dth��� �%�%D#� �LX��4���������D�h�`��������ۼ�T�h���$�������0���`�p�\���p�����8�(�!�#&(T%�\l����� `�|��P���<�����$�T�x���X��L�P������������������D
�P����H�	��"�*�.t+H#�|����@�h��
�����L�|�(�x�D�P����@�(�P�������@�P�H�,�`���XH��H�
h
H�
�	���&+�(X#x���X\�����l0X����<���t��ܼ�P����p����������� �H��x������X,t8�	p�����d�l
��$�p����l���0���<�D���������,�� ڜ���X�������\�t��$ �����T��<<� |&�'�!0�
�	�
,�L
����`
��d���(���$��޼�p�<��L����X����P����ި�����l��|��4���
�\D��(|+'$pD(	lH����L�	P�����x��������ڀ�@�����H���|�T��������0��������T�8�$x		P���!��|H��<�������,�|�������t��\���4�l�����$��H���l����x��P�����d���<��"d&�%8��	���T�8�<��`�0��$����\�$�����@�������p����������X�p|
��	0�����L�P�"�*d+@%0,�t<	�x�h(�
�
�����\���d�(� �T�����(���$���0����L��������� XD��L4P��	T��"8$8!�P�����������$�$�����(�D�(�D�<�0܌�l��|����������H������4�,��\�d���|8�!� ��H	��8����@�H�(��0�(��4�l�����X���8���Dޘ�D�$����l�`���		T������D|��D#)�(T!�Xp
P�	�@���
�H������� ����4������(���,��������$�@��00(8�	D 
�`�
p
��H&$&!d��\@��X�h� D,���(��������h���0��,������������8���,�h�t�p�p��L������
��	Px$���P�����p�8�D�������t�,���(���T���0����t߸���P�P�L�D���x����������D	�4<� �#L!�p�
P
��
�,��xl\
��`�������,�,������@�8���d���D���D���8����0���@4�Lh�@�
�
����"�&$�����H����	|
��4������X�8�t�X�P��x�`�d������d��<��D�$����x
 x� 
�
��
�
�	�
�lL x�4P��`����D�l�������l��\�$����l���D�P����8�������t�X�������8�`�������
P��8��l�
�8�$����h�8��t�P���t����<�$�������������`�ttL���p����X
�����$"�����
�l���� 
�hD�4�p�����T�,���D���l�\���P�T��$��8�����4	H��0�p	0l 
<
h��0��ll\4	����L�t����4�����H��|��8���$��<���D�d���@���t�x���,���
,dx�h��
���	8����8$	��X�$�`��H������L��������(�P�L�t����������������\�,���h�H	<��� <���	�(�
�hT�L����d�T������������0�(���X�,�����<����t�x@
�	H���X��	,�L|,<,�T�@\���hx���t�\�(��������������������H�`�����$��� x
X���
�
�
�H	��	������
l�����x�X�������4��\����L���������P������������\� ���������	����<���(�0
�
�
�
8
$tpTl� ������������@�(������`�����8���4��x0x�����	�D�D(
	��T<�h	
0���|�������� �0��P�����|���x���4�����h�����d�	�
�
�
�(�l������ 4T�	p���������|�8���\�l����$���h���8�0�l��8������������L��������T��<t<T�@	
��T�D�
������p������0�|����� �d�����T�������������`�\�����L��`�`�	L�
`�����	�T`� ��\
4�H��h�h���4� ��x��x�����<�d������$�h�|�(�|�p�����xpt$`|�	�
���	���L0���|�����`�|������������x�0�l�\�����`�t���l�`���x��d	��
X	��H	(�D�	T
�0��P
�l(���0�L�X�t�������������������0���h�<�L�l���������p�,���@�	x
<��
��	T`�t��4��	�
�	�D������d����P�����P�(���X������@�p������� �H�8���Dd������D0T���������p�P�@���`���$��`����d���d���(���`���l�@�@��h������	@�`T���4P�<�
�		���������0���d��\���p������ �0������<���8�X�l����l������8�p�����,x�h	�	������PH��	�������<����������\�������,�`���|��������$�H�<�����H0L������h|�	��
|�(��������������������������8��������������������,�\D�tt����(�L�	�
�	H$xhP���D�t��P�������$��������L�@�����|�4�L�x��t����|�(�X�����(4�@�p��\�@\@���X|d,�����l�����t��h�p�L���H���������(��0�t���(�H�����h���<�@�������<�X40tp��(�����(��������������|����H���H�(���`�<��<������\�8lhx�T��XhD�4@�80������dt������<�`���0���������������l��@�|�(�,�(������l�t��@�Ht�,�D���\�p�x�����l�������\�x�p���L��������h����������t��`�� �d�p�\�����<������<8x�0�H<0`�`P�`���T�0����������(���������X�$���T��������������th��L�@������\��������0�4�`L�|��������h�|�,���X�L�� �L�@�����h���<����,������h��XXP�XD��$�<�|�������H�x �������,�<������h��������L�d����@�X������������ $�������pD0(�Xp��D�D�L�4����@�����d���<�������������4���x���������������L�X���h�<`�� ��������8t`�\����p�(���������L�p�P����������P��4����x�����$|��@����0p���8���d���\,l��H������4���������$�4�8�P�|�����`� ���D�p�������P�������lPDd�������X����������������������`� ������4�t�����������������������X�������xH0Dl�������H������������������������������|�h�`�t���������$0$��$DX\h|���lH<84, (<D4������������������������������������������������$ ����,DTPD40(�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ,,,,,($$(,044$��������������������������������������������������������$,8Hdtt`H4,($44$������������������������������������������������8TT@0,4884@h������tT(����������������P�(�$�4�D�L�X�|�������������������������4|�������X8Dp�������| ����������������������|�4������������$�����������������������D���0P@��lh��������(����l�4�������(�|�����`�D�<�$�����L�`���,�������D���d @x���\��\ ��(0���\����P���$�����8����������P�D���l�0�P�����$�d����D�l�������t`P ��$X��h����������������������������������d�,�������H�@�X�X�(��8����� Ph,����D���� @�0�������0���4���\�|��p�������X�����������\������������p0��0������� �������<�������h����� �@�� �d���P�����L�����H��� ���X�,�|�ld  l�@��p�t��x���0������p�t������|����������P����d�D������4���8�t4� �H��������4����������0�\����D�$���������\�����|���`��������<���H���l� ��$|�t<|�h4�XT(��H�<8���������`��(�����X�����������������t�<������<��,��`���4��t��@lT@t�� ����4�@���T�����l����������\��������������������<����0t����t���X$��l�\���P������d��������������l���������������x���,���l�T����|(��p(L@T�L @���|XP�`���@���������������<���@�|�$�\�������P��X���<�HXL�`������hP��4
P
�`�,�0�,�@��������t���$�$���T�$����l�<�@������0�����������L<�l����`0��	dX�	���4d��0���8(���L�l�H�����`�������D�H�p���(�<���T�����,�8�����\����4,T����4�l�P@	�p�D	���H��������������T����������x�T�`������p�d� ��������d���<���L8���	|
�d
0D@`��|�0@���T�,�(�t������d�����<���h���,���`�4�l�����D���d�����d�Td
�
�� `	��H���D�4p<4$���������$�4���H�P�\���d�H��D��������������		���D��P	p�
�\�
x
X	 ���`�(�<� ��l�(�p�h�����<�����<���\�L�`�x�h������������4�`�d����l<
�
L��

H
xD<x	D	� 	�
�X
t�,�����D���4���������\�����@���H���������������<����8����P�|����	�p�X�(�X������X�\�(����������t���������D������������L�8	���t��	4
$�@�
P�
,4<�<����D��T�4���(����h��x�����������8���,���T�|�P������Dx�
`
��
h�
d
�`,�
�
d�
�
���D��8�x�0���\�4����4�X�<����`�,�$�|�0����l���H������`�X�x�$���
X�
�\(4|	X�d���	x�
tx����8�D�8����(�h����������������|�,�H�����t���L��	L���xt4<	���h�H@P
�$�����<<@<H�D�(�\������<�`����l�@� �X��t�����|���8���,�	 l��d������	� �l����h�������x���x�������`������p���@�H�����D���|�`��|��8
�h��t�4
4	h�H�X���
���x�X���(����d���������l��(��<���4�,�$���8����X��|(���X
@�
�\�hD@�
�
��pp�l�8���l�D������\� ���4�L�\�<������`�4�(����,���|
���
�	��	,l	������Lx�T��H�����t���4�t�����L����X����T�P�H�����8�����|�x��h�<��|������x�(X�@P��$ �@�����$������@�4�x�����t���t���|�L�p������������0X�������t\P�\p�TX�LH�d	��	T4�L�\�t�8��������X�|��x�������D���8�T�����	�
�Tp�h
@`�
(p���4�������@������@�����p�,������������8���X�@�X���X�L�L�8�d���(�<d
 P
4���d���
� ���������������������� �P�p���$���0����h�`�������� �H�x���������hLH���
�l(�
x����,� �L���������������t�D���������0�<�t�	x�$��
d
�t� L��0�����<(	�$
��������T�p�d����h��D���|���`������0���H� �0����d
�H
�T(�,T�xD���$�����P�P�������|�`�$�X�@��l�4�����<����������\�|�T�P�,�P��$H��LP<XH	��<��<�(TL�T���d���|�������������8�`����ݴ��������� ���(��L���������l"%D!��|�@	�|
��	����4�������@�`�������t�������8� ��<�<�������@�@
�`	�p
0��#�%�!�L���
T���$(�����`�<�(�$�4�Pܰ�L���@���H�<�(���@�����|�4�T�
��d��D��	�pHdH��D��l���H���P�$�H�h�h���d�,�������ܐ��L�p���8�<���p�$������l���8X�\#H$���
�<�x�d��(�P������l��P�H�4���`�d���<�l�P�P��۸������H������4$
lX\<�
8��P� (�(#��d�@\�	,
�h�����������t���D�$�����$�4�P���`�x�0�T�,�H�������\L<d4�|`�X#�# ��H�x
��H���T�T�����L���������� �8� ��ߜ���������������|�@��<����`�l�@��
�\<�\�����D��X���X���l���P������������|�h�h������8�`������������������� \&(&l�X��x�d	�
�$���$�����t�$��,�����|����H��X���L���x�H�l���d$��Tx
T
d\��h#T#�<����	������L���l� �H�p�P�����8�\��� �d���$�@�d������l���	xx�xL�H
�����p���L������ � �p������������|��,�����d�H����,��XP�8�T�@��	@��pT"�&`%P0�0�h�
��
0��0� �������������4������8���p�ۈݰ�,�������� 4	\hl�L��$�),(|!�@l�<��X�@�\H	4���|�T�l�4���ڀۘ���8���`����(���P�������|�����	�HL�HT��
@�D��#�"�P�@����L����������X�����,�� �\����@ܸ����������8���x�X�������h�@
���D<!�#4!H|�D
����4�8���T���������d�t�����������׈�\�0�@�l�@����xx�����|
��TL�%*�&(���	�������d��� ������`޼�x�����x�@���l�8���8� ��������	��p�
8�����l<%�'�$|��$X8�����l0\������H��\��D�,����������X� ������������8@
������`	�
,x8��((|�
@������������t�T������L����,�(�L��D������������������0
���D$%�&�!|<
D�
t\`�������������D������X���(�P���ݔ�������(����8X�
�h,
L
<����%t'�"����
h�����T	�	`8d�@��L��<߸�d���������t�\���t����D�����T����8���L���XX�������	`�����������T�������T���@���\�h�$�����X���������t�(���������L�x��� 0�t
LT� x4<�����x��X�D�����\��h����4�X�`�d�Tި�T��t�T�0���8��	hT�(�$���8P%�%( �lL4�	l�	d����X�x�@�������D��d�������������x���(���@
0�8�
P
�\$
�
���L��H��l�\�����\���`�`�����0�l����� ��X���������l������������0����p����$�,��$��
d�(T0<����l���p�|����������`���X���x���X����������(�x��0 � �0�h���,#H"���|T���@���`��8�������l���P�d�X���`���t�8��� ���x�$�h�����P��
�Tl
�
T
�``` �($��L�����<���X�x�����(������T�x�����������X����X�8���l���8����t��P�
��P$d�hL �(�0�h�@�(������ �,�������t�������t���`�t������X��T���t�L������xX�`p��	
`�
�d�����$�����`���������8������,������ �P�L������	�	T<`8�
(x������0�
�t��
8�h������D��0������P� �������������� ��������(����
|0x��
��8\����
t�h�d����@�`���|���D���(������t�����8����������������X��������� ����	h�	�
������X	���t��������T�����T���0�����h����T���d���l���<�������	4
�xd����
�
�
	t���,l������ ���H� �d������p���@��t�l�(�$��$���8�4�����
���\p@
x
H����l�T�
�T���|�������t�`�0��T�h���L�X�x�����h����P�@������D����T	��|���L	8�
<`��4
���\�\����(�\�������l�����T����<��T�@�4�\����\�������T��X��x$�
�\|�$�	D$	(
�	`p�
�
��������t���H���l���D��t�x���$�t���@�X�h��0�@���8�H�t�P`	����(�
L	�������4�����,�H��T�T��`�<�����t���$�����D���������0l� 
\�	�	p
�	�@t�d
��(�����,����������|�\���������������T��������L���`� ���l���H�,��8�
������
h	���(	�8	4|
�
X
���|��|������ �����4�t���|���8�p��H����,�x���8��\���<�`���	�<��`�
��H4<4�(	l�x���l���l�L�P��X�(�H�,��t�������@�,������|������	�	,�P�L`����
�`
p	08�������L���p�p�\��t���p�����D���0��l����T�T����������8
�


�
�
����\ 	x
P

�
d�
��<�����������|� �|�|�������������t�,�l���T����������h������T�0���
�h�
�
l0�|��D0H�Xt���(���x�����h���X�\���|��L���,���������,����p(��� ��H�X	x0�
 �Ll��4h���(��\����d���8�d�����t�������t�T�t�8�H� ���������,��X�d<�d�4���	�

	����x��������������4�0� �L�\���������h����D�4�P����x���@�P�����`����$T�,(�TX�@h �8X ��L�D�����T�p�����������������T�0���������<���x� �h��$�����@������		 `�P�d��x���X�� ���<������d����� ���@�<����h���0������T� ���H|D�p�8���������|�� $���T�4�\���p������8�����0�|�������x��������h�t���,�����|�|�����L�L�8�  � ����D�����$�h���d�������L�����4���`�|�8�4�D�\��������D���H���T��Xl�H�\����$(��P|�0 �l���0�����<�x�\�p���������`�L�4�����l�����T�\��,hX�� D��T�,� ������4H���������0����� �����P�� ���t�������$�T�p��X�P�����D�| $���p���������������P�������H�d�������p��d���t���X�h�����d��������h��ld�@x���������4���X������8������l������ �|�T�������L���,�h|h `�L|�<��\���`����P��� ����<�����������l�����$����P�������0��������xl,��\T<���p,���X�Dp�� ��d�������������������`�8�\�������P��������t�4�(�<�@�,�@����\����������H������T��<�$������� �x���|����|�d�L� ��������������� D<����t�(\���l�����dTl����4������D���������@�d�X�H�T�l�p�@��������P�|�����x��xHD\pd\p�<8���|4������84 ��|�(��������,�X������������������������� h������p@(0X�������h ��������������������������|�t�`�T�`�����������������������<P\l���`<$(04,,8HTP0����������������������������������������������(40 (0@P\T@, ��������������������������������������������������  ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������    ��������������������������������������������$0<HTTH0 (48,������������������������������������������������$8<0 ,0<Pp���xdTD0����(0(��������`�T�`�t�������������������������������Lx�tddhdP8<\�������x8������������������������`�0�$� ����<�������������������������t������d`|��������L��������P�$��H�������`�,�������������<�������Dph,������P���$��������L(@����4������(���<�0�p����������L�`�$���p�h�����,�T���$�������������p�������4,���������D������������`���t���l������� ��4����`���������� ����<t���<�4�4�����������L�����x�X�4�����������p�������������� ����l�,�(�d��<0h�\D��`����T���X����,���������$����t����H��������h\��hX�$LT���x`���H� ���,���������|�����P��������@�����X�|��8���D�������,�8�L\p0�H���TD���(�,��������������`�`���8���D�8�X�D�0�����<�T��������������<���������|���H��� <D�H�Tl��L������T�����������P�(��t�������������`��|0H����������<����`���l�8��D|�����P����������������\���l�0���D�������H���| �8X�L��D4(��(�� �������\�4T��L�X���0���P�l����������X��������������T���|�T�,�L����$|���lH����$@�����@�H��T���8�|���`�����x����T�|�D������@��������l�d�H�t�P�l	�	�44x�,�$(��d��l�t�0�L����`�����4�|�|������P�����P�����������@���,�	��|
`�<��@L�������������0���,�(���������,�����L���,�����P��$p�P0��t��	�	�Hd8�\�����������������������������\�D�����\���������X������8����(h|
�
@	�h<��������T���p����4�������@����������l��������x�h���L�L�TL�l���d��p��\�
(<x	����D�d��@X�H���,�����p��������������������\�������X�\�@��d���p �Dx
p�
�	�|8���������0����|���P�T�����D���@�|��h����x�|���<�<�<�|���H���	D
4
�
0p�
H�P�	�
p
 
�
�xPX�����������d���P�t�����`���|���,����<�����P���L������L����8	L
TP�$�
�	�T�`0|�0X
�	�,������l�\����h�x���l�����D�H�|���|�$�D� ���t������	�tP�x�<���LL��
�	�4��4����4L,��@� ������������$�t����������|�\���P�����h���p�84l@���p�h��dD$h�P�����h\��H����� �������,$����P� �$�H���P`����4@����8���0���x��������p��������T�4����������4����|D$@x�L$0��������������������0 ��08  <PH ����������������������������������������������X�d�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������0�,d�|���,�tH@0�x���0�����l��������H���������X���������������L�l��������p� ���@t���H���t(����hD���`�4�8�4��������D�H���<���(�$����x��L�h���$�����
��4���
��x�$`*8)�#���(���8�PlTx�\��L��X�T�T��H�����<�x���,�� �,���X�����\(���P8x<X���&�(4&�"��h$	����|���������D���t����(�ހ������@߰���� ����������D�T�,�0����0��D���Hx $l�T���� ���\���\���4�����T��<��`ߤ��ߠ�`��D���`@	hh�D�  HT�$�'H#����8�T�
HD�D(<�h�t�<��D�l߼�������H���������`�P�����t��@	��,�( 
\`�$��|'�*�&�P\�x �D���$X���8����l����l�Dܴ�(���T�4�x�<� �h��@���L�d�����<x�|��X`h\	��������``
�h�H�`���������p������������ހ�X���4ܨ�������������Dl�����D��|�<4#<$�<�
<
��
��X`����X���\�����D������$��������ۄ�t���������,X
��
����
�
D�\4�%h'�"�p���@`4tX
X
��������h����t�X���x������T��<� ��|�T�4������\TL���H��8��#�#��8$d�
��$���t�D4������������,������L���� �8����������������L��� 0���4TX\p\8��� ,P�4�� �T�d�@���@��0�0��L��h���\�\�(�l�`�8��L�����H��L��|�,,
��X��"�(h'������
���d��4
�d�8�d���8�(�$�<�4�|��������l�x�������`�d�x��|���
X
��

�Dd#�"@���P�l�,�h��$8������������݀�p���������������D�T����|��p�$�
��	T,H�P`4px����p���������4�<���4�x�����Pި��� �\� �l����`���������4��T!D%�#0�

�D4
��
��<
H��4����x���,��$�l���X�(��`����P�h������<���,\x
��<�|
L���!�&�$<����
H�����
����������X�`��������D�X�,�D�p�X����0��0������l��DD��l
� ,�H���x����������\�$�����������0��� ����t����H�������������`�$������	�����@h�h 
(�8H|�x�(���0���p�����t��T�,�(���L����@�������x���������|���8��p
�
TH��!������4��<�����������l�T��� �@�4�|���0��l�,��t�p� ��L�����0���
hl	h��
t�������P\�������P��|�����@�4���� ����������t�����l�����T��(���$	H00,���	��
�����h�D
x��4�8���0��0���������,�D�P�P����8����,��� �h�����`��4�H��|`
@\�������p�	`��\,P8L���X�\��������4������P������� ����H�tH�
�x�p�<�	
�`��$$��
<�`������x�����,�`���@�h����4��<�x������ �|����,������4��������
�\�
dT�����X���T�\�������t����������L�$��������P���H���$��������@�X����
d��@\0���,�D��L�
����P���0������ �d�����d�����,�0����d���X�T�$\��(��h�40@
lhTh`�P��
�	��D��P@p����<�L�h����(�\�d�t�X����������0�\�0�X�(���	���$	��	P
	���
���$H�8p`�����x�p�� ���d�����T�,��4�������h���������������8�x���X����8xP�H���
��8
�
�$�������D�p��������t�t�d�����|�L���0�����������\��|��X���<��(	�l
(�d �	X����	l��H8���������p������������<���l���L����� ����x����
�	�$ ����	�
����`�T�p���@�0����������L�������L�����������T�0�0�����D����0�P�
l

�����
� `|���
�
�
�LDX�8�X���������<���������h���|�`�p�����,����������L�8�h�����d��	T(�
,���lX�t�,X�
�D�X|���D�������������D��(�T�������L�����L��X���������t��|	�\(�p
(
d�`����hT��T��H���4����L�X��`���$�0���X�@�����������h�� 	,t
��x���p
�
�8��|
����p�����|���t������������P����P�������l������������8�4���8��	
x
�\�����(�H	
��h�x������l��`����<�����(����������(� �����4�h����@���L$�D�

8��	�L���D����4x��@�,��������|��������$�P���l�|���`���,���h@���,(�X���	��
��
	�0���8���L�(��������������l��� �d�|�����<����������L�X����ltdL�d�Pt���4	�������8�������@���L�����d����X�8�������x���������X�x�4��������H����P��	P
	�d�(��X\h�(����(�4��P���<���������������|�����X����4�t������Px8����,�d�0
H
���`$|l�$x�|`�D�(�����x�����x�����`�����D���������p���D����8�t���H�Tx�H�D��d�\��|�H�����t���������@����,��0�d�h�H����������4���������x��(0(x$������\��\X�0���T�������������|�`�l����d�X�l�|�����X��d�����������h��4��������4`�,(��������@������������ ����@�����$����8�$�8���l�4��@�l�����T<8���<�D��<�h�x`�����������H�l�\����4�l��8�4�x��<�����D�l�d�����pLxX\���h`������($�t�������P�����h��l���$�����t���������,�������`P��8�0������l$�l�t�||\�$�XDt`����������X�x�4��d�L���D�D��������|�T���H���xT����� 44�< ��h�`�������d��X����P�p�����t�������P���d�t��t�,�H�����������������D���\�80 �,D��@�L�d�\�D�P�����������D�������������P����������������8������\�@h���d����4����L����\��������@�������T�$������D��4���0�������,p�\������0\x�x��8���t<��4���x<����L��������D�\�d�x���������4�� �T���������X����``dT@8\������X������������������h�$��� �(�,�D�|�������������������������L�������l@,<`x�|���p4����������������������������|�t�d�T�L�h������� $������(@L\t��|X8,($ 8<(����������������������������������������������0<@8( $,004<LXTH8( ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  ((,,$ $$(( ��������������������������������������������������$,@\llX@0($0<<(����������������������������������������������<TP8  (00(8`�����pdL ����������������\�4�4�H�T�X�d�|�������������������������4��������lHP|�������| ����������������������x�,�������������p�����������������������@���DdT�ll�������� ����d�0�������(�t���t�D�(� ����d�0�H����p�����@���` H���x�4$�l,�|$4���p$����p���L����P��������� �\�P�����H�`����� �\����0|h$�������`L���4��H�p���������������t�������x�|�h�\���<������l�(� �<�@����0�����4P��p�,�p����,P�T������\�,�\���`�h���8���x�H���x�D�������L�������x��x���H��P�������<��@�D�8��@�������P���t��(������D���0�`����t�<��������,���d���Pll�L���T�����������������P�(����x����������� ����h�L����,�8����|L@@h(�������\�@�������x�,�d����x�`�������`�����t���T�������$�h�(���d� ��8<���,P�(���l�h�8P|� �`�������`��H�$�,���������$��������(���T�����T��@��\��� @��d�$8hx��(�������l���������������<��������x�h���������4pDtT��$���4� ��h8������4���l������������(�����������������h�l���0���P����� ��d������$�T�������h���L������� �����P���(�`��H���������t�����t�(����������H�|�	�	0�D��Td�`�D,x H�����������������l� �d����p�0�����|���(�H���|`�H��T��pL��	td�	t��8h����$���L�\�$���h��������������4���p�����@�8�����4���h$��8D��d�(hd		��h	���T�������4�8��\� �������0�����t�\�t�4��������p�H������D�����x��Dt	`�P�	����8� ���@P���p�<�<�����L�|���h�T���@�|�H�����d�h����D���84�8Dl0���
�
��(�	P�T�h� �@�l��������\�l���,� �0�|���t�$�T�$�4�P���������H|l	�@�@�l�`	��
8
�T0�	�L���������������������|������4��������<��L�P���p�l���P�L0�	 
�
D�
��	L�x�	�$�D
t
��L���h�������t�4���|�������|���d���|�������l�d$��������`T	L��T�D	|������(����8�����l�\�|�����,�����H���������x� �P�����X����	�
	��T`Thl�T
@�8�@
H\
d`����h�@�P�4�D����������,�������x��x�(��������������@�T�d�t\
\
t
x(�
h
�`8�

�
$
�
�,x�8������H� ����`���l������4������`�0�����������hp�����p��
DD���
$48�, ��
�`	@P�$��4����������\�����0����������$�����h�<
h����h	p
�
4�\�
��	��p���������<����8������P���D��������l���<�P���T����0
x�����
��	��`
��������d���X���������T���4�,�t�����L�(�(�p������������\�����|����x�
�0����
`��	��
����
���d�����p�L���(���������8��|�x����T�`�X���4���|��lh�@���	��
t8����
Hh	H����(<��p����`��8�������`���p�����d���d�����P�0���	x\���	�d 	���������L���l����4P���x��������@���������H��������P��d������� ����P�x<P�X�X����p�D��
����������X�@�����������D�����X�\�t���4���<��`$�����|�h @D�d|4�\�
���	0�	�
��X
|�@�D�|�t�T������L�x�X��<�t����t��h���d�L$	0
TH�(XP$L�|P ���`���p���x�����D��������|�4���L��@��D���|�\�P�@���������|�$���H�
$
����|`
���H�����t�����0���d���t��p�������������<�L�������h���8	��,|hl8L
�
P�h���LT���X�� ���t�����<�@�����\��x�x���(�,�p���H����	0l���d�
\
��,#(! ��	�0\�
|
4�t�����d�����������@��l���,������,����t���P��
\ttP��
`,�,!DP���@D����������h�����(�8����T��������������0� ����x�����
�l0@d�D	���T��t���,�T������,������4�H�T��d���X�H�X���X��4���P�����x����\�	�pt��|"D��(
��P
`8<�xH�`T���`�t����d������x�t��������������d���l@	�h�P	���0<
�0�"�$D!��`�`4�����T8�h�,���l�\��4ߌ��� ���p�4���(�|���8���T� �8�0�$�x(�T�xd�(
���,�t�T�
��@�`�l�`��(���t�������`�4���������H����<�4���X�T����P���4�Dp�p�L8$0%�����4�H���`$�������@�`�h�����4���$�T�X�����hڈ����L�����l��,
�
�@��
H��!)�)�#HtD|�PPl
�
�H��|�L����������߬�������4�l���4��������<�|��@DX|��4��
�l�" #�D�@�
��0�4�h��(�T��l������T�ݨ�Dޜ�d��݀�P�x�8�� ���(�|���\�T�\����H|�\\$
����@@T����`�������H����������X��`��߬�T���8�h�|�t�P������h��|	��T("�'�'p � � 
<�����d���$�8�@������@����8���T����l��4��X������t��PLt�
<
�8 �%�$L��h�l��t�h���4L���@�����h�,�|�(��������������\�p�H��d��X����d$x�D�,�T
����L����X�d�8����������������������ߜ�p��ڬ�����t�����P��������	�(��$�)�(h!������p���4P������P��������h�x�X���`��\��ڨ����8��t���
<\�	4�$
(�l�$`*�(8"4$4X
��x�
����$��d�l�<����h��`�p���H�4�X������������`�,�x�
`
�
��"�!��|�������� ���8�(���L�8�����`��݌ݨ�(����������X�@�����t��@�����
��<��!`$�!H�`
 �|pTh���D�����l������(������X�@����ڔ׬�������p���
����T��$���&�*'8�|H
����L,�d	X���8������߄���� ���0����8���߄�p�L������	��<�P	�
P�4
�$�$0'�#D`���H����8�(t��`��l��@���ڐ܌߸��P��T���������(��,���T��l
4��tH4�	4���,��X�D���H�l�P���h���������<��Tߤیڜ�����d������������x
hx�%'d" �8
�
��
8����4	�������T��D���X���l����x�����ܼ�P����������`Pp��<
p
�T���&�( $�p��$p��$�@�	�
�0��� �����ސ�$����8����������<����p�����P�0�<��(�X�$h�< t ���h��
������,����L��������8����D���0�`޼�x�����������D����(��������0@�|
�����X P��@���������d������@�������������ޔ�D�X�,�|������
|L�����
<��l�$�%!�<�� 
���d	�
<�	���(�P����4��p�<��t� �t�������������������D\L@�p
�\��	�	�(�|4��0�(���@���D,���8�$�d���������p�l���P�(���H����`������8�(�����
<���,xt
�DHl�����������������x���H�P�x�|���������޴��������\�t��x����d���������X$|#���
��D	��	4�8�0|�������p���L����� �����4���p�`������p�`��\��
`��0�!!`P�
 l���������4<���d���|����H����$���������H��� ���h�����|��TPHd���l��	��|�Tx4�������,�<�������������0����L�H�����,�8���������|�������t����$x|��
<	\	�L
�P<H����T���L������|���<����������t�`��������h��������|
`T�����D�
p��, ���p�$
|���P��
l4��x��������|������|�\������������x�`�<�h�PT���
���	����P�|�d����D����0���������,��$�T������������������ ���h�������P�,���L���,@�	��	�
���|(��X��8����@���<�������4��������d�����x�������|H��<����L @H��0
$
8
����
H�8��p�L�\�`�L�P������T���������(��@�(�p��L�@���	l(	�4x�	��	�P4�8@T�
�h�����80������4�d���T�h���h�t�����`�|��$�������|�4�H�l4@L��� 
�4���t�
�\���d����P����������@�������������������d�t���������������0��	
��P��
\	���	�	���
<
�
�
������t����������\�,�H�����d�0��|���P�����������| <��	�
`$���L�
	p�P�|H�����������,�� ������<��t���l������x�����d�P@|`�
	��	|	����
@�h@\
`
�8����������T��@�����t���0��|������������������H�t�������(� @�HD
�\����	�	�	��
�
8
h����4���������������8�����`��d��P�����x���H<�L����4��h�	<�\�l
���@4DP���h�����������|�x�����T�`������T���P��(�0���8�l�	L	��lD�P��	�
���\�
�	���������d���T� ���<�\�x�T�����d�����������h��<���<���� ��
�
 
8
�
�
���P 
l<�
H��
\t,�����T�@�,���������L�4���h�����p���|���������x0x�����T�$`$$	�
�@�
�
p0����\@�8����������d���$���������(�T��d���t�8���0�x���@��<��<4��8|$	4�
L
�
����Hl����|�Dd���x������,���H����(� �����������h���0�����X�x�H�(l�$\p�	x
�	�D,,���,���������@�������������X���L�����P�d�p�������@��,�t�����pH�(	
x	l�@x0�`��(8�h �<������l���X��X� �d�d�d�����d���t���`���L���l���x (���`H\�d���	������X��L@���(���P�,�� ���d�t���d���|�4���h���L��t���4���������@$�����,�����t��4���t�|�������\����h����h����������`���\�p�����t�����X� �(��D<@��������t�@��h��0���h��D���\����8��X�4���������d�<�D�p���$�L����p�����X��L<�0L�4|�h���`<,���h�`���h�������L�����4���0����� ���8�h�������T�<0��\�ThP�`�4(`�LxL�(�����h�������������8���<�����(�$�L�������8�$������D���p(l��<<Xh��Ll<X����,��p�8�p���T��T���h��������|�����l���d���0�������t�������������< ��pl���D|����0�������T���0����������x�����|���<���$�0���$� �����p$��Xt���lht�`(�<����|8�<��x��l�������0���(�@�P����0���d�����@����@���\@��|l��d�0��x(��D���8�$�X�����p�x��������L������������� �����������p�x�����X�H���<������8���D@8Pxh�H��4�����������p�����@���������H��0���<���0\�x4������X��8���\��``\H8L����<����t�0���������<�p�t�d�\�h�d�8���������P�������@���|D<Xptt��$L<���` ������,(������l�$������� �4�T�����������t�������������8�������|T8@h�������\��������������������������|�|�t�`�P�`�����������������������(HX`t���h@$(,,( ,HXT4������������������������������������������������ ,  (@X`XD4,$���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $$ ���������������������������������������������������� (0<LL@, 04,������������������������������������������������$<D4 (008Pt���p\PD(���� ����������\�T�d�x�������������������������������Lx�xhhhdL48\�������|<������������������������h�8�$�$� ���D�������������������������0�������P@Tp�������D����|�T�$���0�x�����l�D�0� �����������@�����$X�|D��d���4����(����\8T����<���������4�(�h��������0�`�d�$���t�l����� �T���4�  ��������<�@L���$���|��������������������������������`������|��������������d������0� @h<����������������|���P���������`����������������� \D��T�L����h�l�p��X8XT�8�D(dd��(����P�������@���d�(� �L�@�����h���P�0��� ���`H�����d�����xT��X���������$���|�����D�����0������|�<�����D�l��4���<�x�����@�@ �|��t���tT����H��X�x����������t�l���@���D�$�0����`����@���<���������\�����\�������p��p��� �4�Hp�`���h����L�P�X�����|�P�(�������t�������L���`P�|l������L�L���P���H���@l��d�����L�����X�����������p�����t��h���,�@��������h�����80��<�����@@��\� �\��������P���l�x��� �������,��0��������� ���d�@������\��D��l����4<�(4�����|���H��������X�H���l�X�����������@������4�����������l,t��	�dP\t�d���X��L��<�@��0�l���� ���������,����������d������������0�P��D�P��
L�	�X�,����@�0���@�\� �����$������4���P�H�����L�T�����t�����8�(d����x �,�	�	�0,|d�������������������$���d�\���l������� �������d�(�������(�l����	`
�
<	|<���$���,x4�l���������0�����,�|���4����T�|������L����X�������<����h@	\���	��L�������,���`�|��� ���������������� ����� ��@�������T|P�(��HptP�T�
\
�
,�
 
x	`���<�p������<��� �|����,��p����������4���������T�T�P�t�t������	0

�
�<h
pPp��	�	�	|
����X���(���D���d�(�����������������d���4�$���L��� ����,���������	�