rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������4t|�|@X��LP������d�$�D���D�X����������������������$���P����L�x8x4���������������thX�P\ <�8X���`���������<�������|���������D�����<�p��0l�	4���\��� "P%�#�D�d
8<������XT	h4d�����|���0����h�h��`� �t���X���,�������\	d��!���$h 8&�(d'L$! �lD�����������X����4��<�p�8��X�4ި�`���<����`���D�H���������\��p!"8"� �d,�
\�����hXh������0�������h��x�����|��֘�,�����������T�<��<�&�-\/x*�!���H�P�P(D�L
<�����������8�x��������8�t���4��ެ�H�8��H�
X�\x��@|(
���#�(|'�"$�H���h���4����`�@��l�T��,؀�@�L�������������$�8���,�����
�x�Xx����	��
��,8�h�����l�������t�\���h��,�����l�����׈������,�@$<����t��`��$d*�+�$�<�	�
x�D
��(�\���4��������H�$�l������$�L����P���x�����P
|h��\l�\	��� *�,\(����lT������\�
	@�����������(�L�|���h���$���d��0�p����������P��L��|	8	t� "h `D���x�x�@����T���`�8����|������ݰݨ�8���h���@���p�x���\�����|���8�������!�%H%t���	8p,���p�|�@�t�l���������(���������x�������������
$��	������
��� %�,$-�&$T�
������l(�
(
0����`���d�Pٌ��4��������(�D�|�p�8�<��������P�88X
�	�
x�,$d%4"��@����������������@�8����$ܤ�`����|�0�@�x�(�l����������(�P���l�  4��	|
���PX��d��d�l�`������x� ������|��|��<ި�p�,��(�L���0|�l4�t�����
D��#4)|(D!�h(
���l@��4
���P�,���D����L�$�h�@������(���������������,@<l��
�	H���
�
�x�%�%� ��4���������������h�X�d���dܰߌ��h����L�l�����4�����h� ��l�X`���4,�
0	X
��|`,P�P<t��������������H���$�������`ސ��@��x�������������P���$	��@� �#�!��D�
�x
<�
�pp�����T����,�����8�d��d� �d�����p��� �����x��P,��l�\�#�&$�\<4h�@�8|	��
��t�����T�Pް�x����8��x�����X�|�������X���h�<	�hL��
�|
�
d	8
����,������������\�p�h�t�<���@���������8�,���t�������������H����l�h�,�X44��
��,�d��H
������<��\�T���� ���������� ���8����h����������@����Hhl4d0�!X$�(Pl`�(
��L������L�d������,�D�D�L�\�<�����\�T�T������p8��4
���
H@
D
4�,�����<\�D��������8�,�����4�t�(���\�������$������`������d�4�p��P� ���	|������d����L�\�4�$�����,�l�4���4�H���\�H�������h���<�d����(�`
�x����
 xx ��
,$�L������L�l��H����������<�H����t���<�@���H�H����X�4����	�
��HXp�8�$p��(�,T���XPd����\�������|�L�|�t����,����h�����D�p
$��
�
�@	�l`	�D�H �8d��|�h�����P�x�h�D�x�,���D�l��l��X�T���L������������8���@����80	,�� T��\�,p	D
�	d
������0���������,� �p������ �T�����P�<���H��4Pt �� �<x�	�l��(�DD
	���pL,	�	,������������$�<�H�������@������0��(�����|� |	�
�
�
��|�$x���px��|	\�d�0��D<����8����\�����d������l���,�p�����d�����������T�
��4,� P,L�	���t��`	�T���������$�������T��� ���$�x�����L���D�0���������d�������X
p�
t 
����� �	�t
,���(�T�������4���H�4�X�����\������`�<��������`P<<��(��h0
�
��D��	T�T ���t�����|�����(�����������L���x������������X���p��t	�(�	$	�	�	xL(�
|
� �P �
��t���X�D��������P�h���t����,�X������ �p�8�D�|��$�L����h���t<�	p
D�0|
�
��@��`�d	D
(	�����\����4���t�<�����@�������H��������������<|�@����� �`|�����  48�P�P�L|�(���,���������������(�`�������������H�h������`���`��\�\�\
l	�t|��������X���x����p���L� �����t�t�t���D�������x�L�,����������|�@H�`	�	�P��dT��\|	�� h��L�H��d�H�d�D���D�P���8�p����<�l�H�p�����4�X�((8���p�t�`T���
��
�\����l�����\����0���x�������l��������l���������������0���PP������d�	�	4	��������d�|��\�(����0� �<���������T�������������`����������`Hl�@Dp��`4`�X$P4���4����$���L�����p��`�D���X�X����h������X�d�����T���$�,�������4�������L�HX��0���,�p�����|�H�L��������X����D�������������x�h����X��\t\�|�@����0���\t�������,���������|���p�������@�h���H�D�<�����l�p��Dx8XX������T�dl�D�l���L�����x�\�������D���������4�X��������x��h���X�\�4�h�`���|���`\��@\L8\�lh�l���d�L������(���P����,�����d������������|�����th��L�@�����X��L4ll����PH�\D|x��(����������D��h�\�4�D�t�l���,�����p�<���4����t�\��<<,l$���0�t���t���`P������4�\�l�����0�t��������H�p� ���h�����������������@��d� ��l���\�L�P�0����@���������d� �������������\���������������H�L���P�D|���������4�t�,����T���������D�d�L�$�� ����t�8�T��� �l�����l��4����,d���l��@����P��X�p<������L��������0�<�<�T�������x�@�$�8�d���������@���|dpxlXHh�������H������������������������p�0���4�<�@�T���������������������`�������|H(,Hdhdhpt`(������������x���������������x�x�t�p�t�������,48,0LX\`lxx`<  $  0,������������������������������������������������,880  $(0<P\`TH8, ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������   $(( (,$������������������������������������������������������ ,4D\llX<($$(<@0��������������������������������|�x�����������<\X@($,0,<`�����l\D������ $������d�<�8�P�`�`�h�|�����������t�|�����������<��������H(4h�������t������������������������D������������p�����������������������8���(X|h$��������$�8����l�8�����P�������t�H�,����h�8�T���0�����`���h$<t���H<�|,��h<����@��d���4�����0�|��������L�D���t�0�D�����(�d���xdP�������X�4(���p�(��H�l���������������T�����������������l�(�����h�,�,�L�T�0��H�����,<d�P�,�p����(�L��������l����l�l���8�������H�����������X�������`������h4���H�h��t|�8�����<��|����,�������������0���@���h���������`���h�|�@���|�x�@|��4hX��d���|�@������@�\�������`���������x����@�������<�4�<��� ��hH(P|<t�X�������@�����������`���$���h�T�����|�`� �����4������������X���T���L���T��\�t`��l�<��D<���0����������p��0�����<���l�\���������|�$���l�����,\�\����x��� ��0�T@h��������p���D�L�����\�X�������������<�����������,����������( ��8���X|���`P4��L�0���l�(���T���,�x�t��p�(�����������������4�(����������l����� �H\����X@���p��\���`�|�p� ��|�H����l�����$�(�4�X�$��� �@��������x���������,\,�	�	�D��� ��@,x$T�H�0�P���H�P�����@���� ���������`���|�������`��x�����P���d��	<p	�P�0��P���tT���8�D������T�������<�<�p��� � �t�0�����h�h�����|���p�����\p$�x����4|	��������������������,�����(����������`�L�$�������|�@���<�����P���L|	�
x�	t||x�T��t	x����,��,�����p���`�@�D����(����l�������T�����h������4��T��	D
$@\|�T,�Xp���T����������������$���T�8������L���T�L�������t�������8	8p�T�d�lX	`p
t�
@

��\����`�d�0��l�0�t�H�����$���4������8��������p������������l	�
�
�
x�
t4	�X�<	��d
l�	L ����@���<���X�l�@���8�T���(�(�h����t��@���l��������X�l�H�	(����p	����Pl �`��,������t�T�\�8�p���D�d���p��x�T��|��D���@�0����	p0�\�|��	�
�8�0@
 \
�������`������P������h�D�������`�4���P� ����$�0������l�L�X0
x�	���|8��
�
lt����0���|�d������l���������L�P�@�D�`��$���$�X���t���\��t�@�T�T����
 <���
�	T��	�X0`	th
�
��T�h�������x���t�l�|�����@��������������l���< ��$T��	�
�
�L���|��
t�d�\�00��X�x�|�����H������P�H�<�@�����`�(�p� �<�P������,
��
$�`�	$�T
��X���
���|�$��������������������,�������0�������d��� ������|���,
�lph��x��P�0
�
x
�
�
@������H����������T�����,�h�T�p����������d�p����<,��<��	��
������X�
,
\<D��`hl�������t����x�,������\����������,���|������T
����t	X
d	$�	�����P���HP�����8t(���H����L�P�h�����T�8������t�H���H��������(����0��$����8�
��dl���
�����(�����4�����`�P�`� �|���|�X�H�h�8�0����������tp�d��8��t,
,�40�Dd���`
8d	T
���	�������p�����X�4�,�����|���d�,�����4�h���@��|�����
�P�x0�x�����4�|��\��������L�l�x�h�\���|���d�4�L��x�,��$�0�������t����(��x<�	$T\ �<D
�4�l�P�P������L�������h�|�x�������P� �x�������`���T����P�h�D�$��Pp��h����
�P�X�t
���T������\�8��P����$�d����<������������(�d�4����H$�T8�
����!� D�X�0� t���
	l����<�$����H�x����4�x�d�4����<��|��(���4��d<���
H0,�	@
�� ��|�l
4��\�x�������@�p���� ���,��L����L���x�p���H�T���X�����D�����,80��L|� �
t$\���X�������4���\���L�0�����@�P�x��������P�����d������������
H��<�!�$!8�
�
@
p
�08
8�x������T�P������|�L����X�� �$���������`�����lH��0	�	���x�#�%�!���4
l��T��@������������,�hܬ�H��� �������P���p��0�P����
P��\X����
�,��d��l�`�������T�0�T�`�X��$�����0�X�ߜ܀����4�8�`��������������xh�,l��"�#� ���P��@\,�	��������P���,�����,�<�d���<��������h�x���0���0�D�h
|<X��l��h!�(t)\#�\�\T�x	<X0	��T�����l���4�$����`�<���x���,�h�������|�0����@
,�l�(�,|`P
�4�!x!�8�����T���x�����@�h�����8�4��(��ߘ�H���Pߴ��d�8�8�4���\�����������4�`pX���� 
���l��,xh\��X�������@�t���l�t���$�����H�����X��������|�4���(�$�$L	����P%�%����
 �
4TX�������p���4�������������P����0��d�������������\�L�8t@L% % dXh���������P@�t�t�������l��ݨ���H���,�����$�p������p�����H����4����
�
��x�t��T����������h�|����������������h���@��������4�H�����4�����D�0|�"�&p%@T�$< p� D�
x��������P���������������Pބ�,�@�(�,������t
��DL(��
���%�)`' �0H�Xd<�
4P������P����h�(ݬ��D�\�������������T���X��4�4(H`���$���\ �"���<8dx����������@���\�L�������T�h�$�(� �����h� ���8�������4�x������4
x��h!��(
@4P��8Ld��t���p�����D�������T��� �8��d���L��� ���\���L���X	��,�(�\�
0����$�(�%��x$$�	dP��4�	d,���L���L���p����� �t�@�d��\�����T�����t�p����	hL0
�
��
@�t�%�(x%�t�8���,�40�����t����l��ی���`�d����x�`�<�H�h���P�D�������4(��x�l
���t�X��(��4�������d�t�X�T��������,�0�ߠ��4������P�|����8������\hd���$p'0#��
$�
 

��H�T	����$�8���|߈����\�t���l��� �L�`�8����l�h�(��
� |$�T��h'�)$%�L|�����x���0 ����� ����4�0ߔ����8��(�L���t��������h�@��8
�T�d�h��
�<�D�P��@D	����|������������$����t�������$�4���<���x���0�,��������<Td$�D��|08���P�L�������4����t�@���h���������<��� �������`����������D�P	���(@
0��\�"�"�Tl�
@	<�d�@P������X���H�H�l��x�p�h���<�������\�����L�$�d�HT||
�48
8�p`��x ���������<��������|����0�����������x�x��������|�����������p�������
��8
$�|t����������`�d� ���`�0���8��(�|�@�x�L�`��������8���Hp�����@�������X4!L \�8
�d��	�	�4`���X�������h�h���T��H����@������������������4T0���	�
�
�
�
 �d �04������L�8�h8x���������<����0����x������8�@���8�`�0�x��d�D����8$$�
$p,D���(�(� �`�\�$�P�����<���\�����$�8�d�����������������l�����|$@ T���	�	$
0��D��	�l������L�����(���T����D������ ��h��l�X�0���d
0 �p�L�T
����!�P$|D
�	�\���� 
�d�\� � ��0��8���T�L�����H���p��(�`�����|�������X
�t4
�`@�
���t���
����������T�T������d�@�l�����$�H����$�������,���t�L���������X ����l����	|
d|�|$�����,�P�����h�d��������0�����t������\�L����\P�L����p��8��,l�T
4L�
Tl$D�
�
������� ���H�x�8��<�\����D���$������������8�l��
D
H���
�	8
�
������( ��X�\h���4�4��������@�l�0��\�L�P�T�x��8������0���<�t0	����d<0����	��P�<�t�$��8�d�@�$��� �����d�����4����������$�`�����0������x���d�`��P\h���<0
$�x	�pH�	��
t����h�`�`��,���x������`�p������`��@�<�\�����,�d���	x�TD��(��
	$@|���4��T$�����X�d���������4����$�����<�����������L������	�	�

��|�����
�
L
@
���@�$���h���������L����@������h�t�p�����(���������0���x�H��L�
��Xh��	h�,	��x
�`�D����x�8���������������x���h��0�l���,�����0��x��H��\�<	�
 
���` (	$���|T�4	���������������h��\�`�8��x�����8�����`�x���<�����h	d	Pp, �\��
D���| �	�X ������\���������D���������\����d�������(���L���$�x�������
H
H
�
�
�����	�
d
�
��
XP��������L�L�L��d�`���8���<���P����\��������������P�����������
�
D
�
��@�D�$���@����L�����<����`�����@�(���������0���4������p���8�x`��X���
,
�Tx�|�����0�X�����<���4���\����L�d�L�����������l���������$��8�X@�D��@H�4	0
�	�������������8�L�������������8�X�������P�<�����������H���0�<�t�����4����H	��4����h��t��<�L�����X�h�����l���`�����������,�d�`���x���`������t�4$���X�T$���		�0�|4��p8`��������l�P�h�(��� ���x�����L������H�������������H��h\ll@�0�lt�$<���\�8�d���t�������(����`��� �4�4���`�8�d�l���$�@�������l������0P�t��p�tt 4$p8TPt�����<���D����(�0���������$�<�����������<�x��|l���,�t��4��(��d|��@���� T��H�\����`� �x�x���P��$�@�������$���X�����<�L��L<��h��HH�(��(������x8X�4���������������� �@���p�d���|��������X���\��Dh��LLtH��hL����p�t���������T�l���D������������������l���������T�P�������\�8�������$�(���t���hl�Xx����8���D�������@���x���D���������p�T�������(���@�x�0�d��Dt�@����0�T�$����D���$��P�����������D�����4����D��|������d������`H��|\\P��h$���|D�p���4�(�l����������������� ���\�l�t�x������������t�8�0�4� ���p�,�����������4t�����\��8����������|�����<�����|�`�4��$�������� @\T ����d�$H|��T��hhldXp����P����t�(���������(�`�t�t�t�x�l�@��������H�������L����dLP\\d��@@���l$������48(��|�$�����������D������������������������� p������pH,8`�������h$������������������������x�p�d�\�h���������������������������<P\l��x\<(,8<<<DT\P0������������������������������������������������ ,$ (4HPL@0$���������������������������������������������������� $ ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$(,,,,$���������������������������������������������������������������� ,4DTXL4$    ,<@4������������������������������������������������,4$$$,@d��|dPH@0��,4(��������h�\�l���������������������������������Hx�|pllhT8<\�������x8������������������������d�4�$� ����<�������������������������0�����hTh��������<����|�d�@�$�(�X���������T�4� ����������4���������40��������,x��h���$����h@X����@������D���|�p�������� �<�<����P�H�����(�d���<�<P�������<�8@���l|��p�|�����������������0�������������L���������`�$�,�P�T�4�4���lX� (4�D���h������TXh���������|�t���@�t� �l���l�T�<������������������������D�P�����,|�T����hT��hH|�L<8|������4�������@���X�$�(�L�,�����L���X�@���P������ ���`������l�$����,����@�|�8���\���(�������P�0����� �L���\��x������X�Px�4�,���,���8\��L�d�����8�(���@�X���L�,�������l�$�x����,�d�����p�t���x�����x�d������4x�L�����@�`�4���,������T�X�L�x�����\�P�0��������������h�4<�|���(X\�hp���������l��������@����8��D� �L���d����x���������d��`�L�,H�4���t`$�`��$�@��`�$����l������\���P�`���0�������x��������x�x�`���\�<� ��(���L`�`�,$�������T���@�<����8�H�$�����������H�h�(�l�������H�4���l������L�h0� 	�	xPt�X���<�4�|�0�l�D�l����(��4��4������� �d���\���\�h���P������� ��$(d�0��
�	�x�d������8���������������p�d���T�<�,�L�4���t���������p�h��(t�`T0���x<
X
�	����T����P��<�����$�d�D�T���D�8���������������\��0���������L�����L�(
�
�	��������h����(���������������d�������T�����(���d��������\�0l��<t8��8
x
�(	l��h|�����l�����P���T����t����|���8�����@�t�����L�����d���\��ld`�Xx�t��d
�	����� ��������<��� ���X�������`��l��������X�`���8������P�t	
�	x
�l(��h�	x

�	`
�P��d���(���8�l���H�����l�$��x��|���L��������T���4������D����h�	�
�\�LXH
Dh�L����
|
X�p�8���4��<�h�<�L��`��@���`����T�\���l���d�����
t
����,L\����(DX�
\�������@��D��� �(�$�H����H��� ����������p���t����x�,����t0��T���D8 0���X�4������(0�,�L�$��d�������\�����4����`����x��|��`�(�����������8�d�t��X������`<x���,�����8<�0��Dl8��XX�88X<������TX4$��������������������(T`@ ,Pp`@H����hXhd0������84  ,������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$($ �������������������������������������������������������������� $$$$  ��������(�`X|�4�h4�4�����@���t�����(���@�T���|�����8��������,�0���h�4�����p���$����D��X������������h�����D������T�8�l�<�4�������p���x��\�����L��|��<������
,�	4�,�l�X$�'&4 ��x�
�t���t�
H�T����@��0��ݸ�t��P���x�d�<��t�����P����4��8x��d�!�#�#�"�!|x��X��$���T��������L�����D�$�xټ�D�D����� �p�\���p����������x!P$ #pt�X��\�|�p,�,����l����h�t���������<�$��ِ�0�d�8���d��`	H$	h�(�l�
����$<(�%(��X����
�DT4���������\���x�L��@�,�����D�����dߨ����t�$0(�P08,
T
�
��$!�$@"<X���D�����@0���@�8�L�|���D���4�,ހ������ ���,�P����4����t���,��
����<H$h	����h��H0,$�$���h�\�����L�`�P�L��� ����$��d�����,�P������������D�����0 �H "t#��h
<D� 8�X��������p�(������\���$�$���d�l��X�4�����D������
����Dd
��|T�%'�!��l� x8X�d�l���4�h����������d�,����H��h������8���h����x�x
����@�`�h
�\�� ,!��� �	�����\�4����8����d���߼������P�������,����p�D��������L�4p���d�$h���d,X������������8�������������������������D�p�`�<4$�����,	��$��!�'0(|!$@�8�p�
�\
��,���������H�x�������������0���h�\�����D���P4���
��(
dT
�d�$D%0!�0�D�����h���\�������H�$���@��t���l�8���������t�H����$��@���T�,8T�$d��
��l����\�h�����D�����h���\������@��L�����H����$���@�P�������������\	���X� �$X#$H�
�
���$
���<T$d� �������� ������l�4�������ܠ�����H����p
�4
�Tpd�`
D��\!&D$��LH�4�@�D��
@	�`X�,���H����l�$�����$�����8���$�����������X��0���(����	��Tl�����
���$�����D�����������X���`����`���`�l�4������H�X�\�������,����	����Hx8T<	 0������
L�����H������ �`�P�x�4������t�p���t�������,��� P�L���	�|
�d<��(�8�
`\����	��
���D�������x��������@�4���<���� �l�����L���,���������	@�
�
d���������l���P�|�����`��������������(����������������P�������	�t��8�T�x
�h�@���l�d����4���@��x���`�d�L�����4������D���4�����d�$���l�T��
����L�l��H
<Tdl	h	�T��,��(�H�����4�X�� ��@����<����8��x�l�d��x�T�p<Ht<	��8��
x
l�x�L�x��(�$�Xt�X������4�����$������������H�\�����$����`���	`H�t�,hTh�@��T���������(���<���0����T��d�(�x�l����������8�l���������(���\�����	h�,��t\
�0
l�H�`�
������0�p������,�������<���@������p����l���P$ �T(���D���

Pd���
�
���,@��8p�����@����l���l�����H���t�<�d�L�p�@���������$
D
h
�h0�<P�P�hp4����`�(�����d�����X�4�����������0�d�<�\��P���,�<�P�����H
��\hx��	P	
����x�\@�x�p���������t�t�l��������(��l���`������8�������l���|��	`
���4x��<H��|	�����D�� �0����������������4�8���h�������\�@��� �@�|	�T�$t���	�
�\8�8
���0T����h����P�<���,��h�(�4���������4�������<���H���@
�@�
t
`�@
|���
\l
�0
(l���������<���������\���������x����������l�T�@�T���8���T�����(L	H��8����p�h�P��t
��
������,����������������`�(�����$�|��4�<��d����x�p�$d�P�	���h<
(
t�<�@�`���l���l���T����������8���������d�����,������h�x$4
P	\x�TX��	H
��
T��l
�x4���P�L����t���8�`�����T����,�`��������<�@����������x�T������(	
���0	8�0����@�	�
	<�@�����T�������D�����(���`���(�X��@�������p�����h`�d��h��L��\4�
�
�x�@���<|X�����������|�������l�@�t�L�����������������l�<���X�d�,lt�	
8$
l	hP�(���P�$����L�p���4�|�T�4���4����������\��������@���� ��������4\��0�|h��d�t�4l���\�����<���P�����`��8�X�����T������������������,Xt���D�X�����`��	
����4���� �x�������$���$�����8�D�H�`����L���@���t��� ��hP����0D�P�
\
	�t�(� ��0�4���D�L�H��������������(�$�d�����0���������|��@��<d|�\���$@��X��8�p(�\�������$�������H������������0�`�@�t�����x�4���������,���l�p�����H��h �T$�����T��lL`�D�������4�0��H�����d�T�����,�T��������p�0�x����hPt��X�<��T����� ��pXH���������d�d�l�T�`������h��,�������������<���X�� �@�����l��\LL���$8�P�������������x�������`�������L���������L�p���$�d��L�����<�`�\��h(< P����,D���0�XP�l�����d������P�4���H�X�x����|���\���|�����h�����(�t��@�,�����L�<�|T�x����`D�4������<������p���@��p�l�L�X�|�\��������H�������h@�����8P`�tH��t�T���������<�� �(�0������X����� ���<�@���<����\����������4(�������X��dPL`p��T�l���������������x���������|�\�P���4���������h�p���p�0���$���xt��8����048h����<��x�P��������X�������8�������t� ���,����x�����Pd<��������<l��,���L����X($X���|<����T������� �L�X�X�h�������T�����@�h�������<���lX\d\DDh������l������������������l�0�� �,�0�,�@�l�����������������������H��������XHTt������xH������������������������h�d�h�`�T�T�l�����������������������0DP`t��|\D<<<4,0@PTD(���������������������������������������������� $0<@8,$���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $(($  $$����������������������������������������������������(4DXddX@0( (40������������������������������������������������8H@0  $((<`�����xhP(������$(������h�@�@�T�h�t���������������|�|�����������,t������xP4<l��������,������������������������@� �����������h�����������������������4����0TP����������� ������T� ���d�������t�P�@� �����X�p���8�������4���H4p���L����4���t,D���`����t���X��$�t��������� �P�<���p�@�d�����,�`���tL8��������l�<$�����0��T�����������������X�������������������L�����p�4�D�p�t�<��8������(p�p���h����4���@�������H�p���x�t���0�������T�����������X�p�x���L�X��x����X�P���������H��4� �4��T�����������L�d�,��,�\� �l���L�����l���<���������X���`h`�4d�\�,����`�h������L������l�����������P��D���\���8�\�h���TL��$ 8�8d$���������l����x�����d�(�X���`� ����������T�����p���,������0�����,���X��|����(�� P��4D��$P�00���������(�����������x�`�T�������D�0��� �������`��td(��\��`��$Xl���$������|������h�|������� ����������l���X�h�x��$x�����(xd��L�p��X�������p�P�����|���(���������<����$� ����p���0���|�����H���`8�p�\X�P(D���8��H��������������������P����8���T��������P���������������T@H8	x
X
�h���|���������������<���������(�\�������� �<�����\�����D��|,�|���T�<	�	T��T�����4���������x������������������p�������@��������H�p��x�@X���@�����H�	t��p���T�`�����T�t�(���p������������(�����h�P�X������|l��������d�h�	l�P�	����,���,t��4���l��������,���`���0�����t���|������$�����8��d�$���d�8�`	���
4� h,�X|��0�����������������H���������������� �\�|����|��@$�8�`�Tl���$
`$�
�
�	x$��`���������|�|�0�������p����(�$�T�x�\���p�d����x�����x���
0
�
T
��	,���	X	�	�
�H
�h�����������0���X� �����`�,���,��������������TD��X�$L����h\x	�d�<`��H���@�T�T�T�T������0�p����T�H���������x����	�
l	��Td�	�$��,
@�
$T�|���,��P�$���X���,��������4�d���T���d������H�H��������\Td
P
(
�
��
t
������H�
�h��l�H�h�`������������������d������P���������������P�X�l�T
 H���(
h�h	�(0�	
<��d��d�X�����l����D���������T�p������L��\����p$	|�����t�	t
�@D�\8(
l�`��������$�(�������d��H�T���8���������T���p�t����<����@
� ��
 ��	�p4
��������
�D�����������x��d�����$�L��������4����X��������(�H���X���(�@�
��xL���t
`,�
����
�@X
(��`�X���������(�(�t���$�`���8���x�@��`�\�������T���0�����	�
�� xh<�

����$�
�
X8�|��� �@�h�$��t���������������<� �t�P�,��h
���<		l
�
<	��	��\@`�L����H�|��������p������X���,���p���<�4�����0���$���t�0������`�8�,�����\|xh�|�|����(�t���H������,�����������������T��� ���������|@��������p
4�������t�(�	|�D
��|	����� � ����@���x��T������|���p�4�������$
\�
4	����p,,�����t<h�l���d���������0���p�����D��4�(�|�$�����l�����<����������4�$��
����P��t��
�p������ �<�<������x���������D��|���@����`� �������(�`��L
L���(��X��
���hP�������H���8����8�� �������8��������X���������P�XD
�����	�p����4�x���
T	��P
�,Hx�������X��p�x�����D����8���|�8�����������\h�p� 
P
�
��	��
�<�|H,8��<�h�0�����������T���P�|����D�L��l���t�������p����D�\������8�@��8H��T
X	�
�4��tdp���(��<���0���`���4�L�����T�������������������<�D�����x
���p�"D%|!x�@�
P
�
t�P�����X�8���D��l�����<���L�D��t�d���X��X�h�	�|`t�$
��H
��#&("�d�t�
���4����� ����h�t�x����\���`���X���,����p����@��x���L���4�(�(�`�(
T	|L�����P����������0�d������8���|������L�h�l�(����L������|���$����l\��( �$�$L�8�t
���D�d����4����0�H�L���������p����T�Tڬ��,�����p����h
������`8�`�!�(0)@#��Xp
���
\h�����|���D�p��4�������x�\�����,�����d��X�
x�,�\� 0
���"X#���(����������(�������(�d��ݔ��d��8�|����p��������\�$���$�4p�p����D�8���D4��|��d����������p���<�X�L���t�L�����8۔�h���X�0�x����X���P
��x�0 $&�%��4|h�l
,	X�HD
4�������D�lߘ߸�l�H�$���D�l��|������ �������
`ph����h�lD�$�#\tP�L��T����d���0�L����H�����H���T�x���H����t�t������h�����4��,$|�h�<��DT$Ht`l�T�����<�\�������P���H�8�������t܌����$�4���d�|�@������p0���("p&�%�����D$��
�\�(�����,�����d�H��������X���������(��@�@�0\`D�	4�	D�lX|x$*�(�!�\�	8T���<����������������,�T�X�8�@�\������h���\���l������X�T���P��8D #�!p��L<�� �(������������8�������x�D��ߨހ����t� �������������x�L��P���L�� @#�!(40�
�T���X��80��0�D����`�\�d�d���������� � ���(ܸ�\�t������@�������P\�\��$�(�%8�X@
�����@4�d���h��x�|�h�����4����L�����P��@�x���\��X���	����P0d��#�%�"��lL�$���(��4��(���P����\��ۘ�p��P���T��,����d��\��� ���x
��|PP�D�T
<����LT�pH�������l�\���h�T�D�|�� �x��|�H�x������������ �`��������� �( T&`(�#hP�|��h,�������|����T�0������x����������܄�4��|�X���,8 `�D �
����!�(�*�%�� |
�\�|<
�
������l�h���x�L܀߰�T��<�������T�T���X��l������0�
T���dx\p
�
d�\@4 T$`
$0��������\����������0�\���L�t��������4���p������0�@���|$|�P����X$ ��0�����00����4����@��0�<���|������H�H���������|�����	|
l�<��	�|L$�$X8t��$
��	�
�
|D����$�\��`��������h�P�������l���L�,���h�����\
t�4��P
�
\�
�h��l��x�� �0����������������������X�����(�����������@�l��������|����,�\�
�� �4����HXt���0�����4���T�x�p�X�T�d��<���`����4���������� ���L�	�H($�P!� ��|
< 
(
P�	�
h�T
�<�H����<��������������`�x�T������h�h���L�`�p
�
�Hl��!� (�������T�������t���L�@��t�`����<��|�������|�����������<4����\D�p	�
�<H��(��XL��4�(� �������L�(�D� ������������P�����l�H��������������p���d�p|	�	@�
�
��`,4�����h�������|�,���t�d���������\���d�@�L�,�0
��
��L�d
`��<!<8�
L
�LP���	4xX�x�h���$�������H���`�L�T�<�D���t��$� ���l(����
@�
P	�pHL��l�(D������D�����\�����L�T�����(�������4�(��`�L��������d�����8���<	��h
�4�p����	���H�|�t���L�����������l���h����l�����l���t(�d���`�4
����`p
t�0	���	`Dh0��������P�����x����� � �$�@�$��D�����@���\���	��8l	,	�	�
�(��(0
����� p�����������������<����t�X���|�p�h����������P�X��D@
��
P���
 8`���
������h������p�@���4���H����p���p����������������t���H�����`
`X�|(
�(	�	X	,l
\
H�����T�t��H�h�l�H�`�������T�h�\��X�|���������lh�|	�T���D�	@����pP
hd���T�8(�TD��� �������\����x�,�\�������X�0���`�8�p���4� �h���0�
\
L\��	 �Pl0
�	4@�����4����h�P�x���@���<�`����������0�8�����L������H���d�(��(�0
�
x8d�@
���	H\
@X	�x���L���X�����x�H�h��������p����|���t������`�������D��<	�x����X$���P\����H���8�����d�������� �������@��d���@���@�L��	�	�XX$�,4�	�
���D�
�	P����t���<�X�����X�����x��������<�`�����������������h�x��� � ��
|
�
�
��H�4
\ �
0�x
 ��������������T���H���l�p�������P����@�����@�@�T,������L�����	0�
X
�
D$��D���,	�����l�,��H�\���$���������P���\�������d������p���P�� (�$�����

�
P`�T`����D����8�L��������l����������P�,�@�������l���T�d�����H�x�8d� d|�	�

(	�������l� ���0������������t�����`���|�������,�����p��������������P	��d<����\�����t������@�L�����x������������X���d���P�����<��84�8P�0�\,���	L	|��p�� ��� �,�|������x��t�������������l��X���T��� �������H@�����(�����0����������|���X����t�4���p�l�����L�T�(������$���L�X���h�T�8����X�,�@��x��dH���4����<�X�@���0���������8���t�8�@��� ����������`�T���x������|���$�Xd�,�Ph�l��pt�L��h���p�$���$�\�P�x������������d����P�����0�X��$ ��� `�t���|$���d@�,����P�0���8����������������l�������\����<���`L�h8T�|(8������@����������������|�����D���������x�@�d�T���L�������������������8L��TL|DT�����l8l������T�����<�@�����p������������������(���@��X(|X��`,��(h��H�@���$�d����8�t���������x�����(����� ���H������|���$���pT��pT`T ��t(���4��@x��(� �l��������������,���T�h�������@���������D�0�D�H�8�@���\4����������<||p|��T��$����������t�����\�������p�,�����X�������8t��P����t�$`��������P<T����L������H���������4�h�p�h�l�|�x�D���������8�|�����0����T@PhdXh�D@����8��������$ ����������������� �,�X�����������|�������������(t������d8$0X�������L��������������������������x�t�d�\�h����������������� DX\d|��\0 $0D@������������������������������������������������0<4$8L\TD4,( ��������������������������������������������������       ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� (,0<LPD0 (8<0����������������������������������������������48$$(0Hl���hTLD0����,0 ����������d�X�l���������������������������������Lx�|lhldL8<`�������x4������������������������X�(�� � ���D�������������������������p���44��p���������8����x�\�4���8�������|�L�4�$����������8�������,TT$������P���<����@����`4D����P����4���D�(�\������������(�����P�L������D������������l�PL��xP|������@<����������,�������������@���L�|�L����������,����L���������(�������Ld������������|���X�������P�0�����������d�������8(��L�<����t�(t�d\��\L���t�xd����d���`���� ���`�����4��(������0�H��������t�TL��4�� ������p\� ��<p�4|d(���������\�����X�������P����t���������d��������d�����������@���H$�@���������������X�P���,��x�x���l�L�����D�H�t������������8������0�D���0p�\���,�`�|�8���H�����`���������4�0���`�@���������������X����pP�t�|�t�h��� �<h(�<|d@�\����0� ������|�����������d�����p�$�x���������h���|$�l�@����h�D���@�$@��|�L�X�X����������������(�������p�������������h���<�4������h�hDD�p@�4��0���������������X����@�P�(���p���8���\�t�,�T���h����d���@t��L���@@4�	�	\��l@���@�|�|�<�d����,�0�����$�t�L�8�`������h��������<X �P�����$�<��
p$
$��8�P�����t��D��,������L�4�����h�������P����$�p���p���p�T�$��P���h�$�	�	�hX�,�����H����X����������T�P�\����������d�`�\�����������\�����D�l��x8	�
�	��D��$,X����� �H� �8�T���(�8�`������(�� �0�P��4�����\�`����\��4t���|L	l���	��$����@������H�����t�� ��������p��������������h�����<h���@x��4��H�t�
�	,�������������|� �H�\�T������p�����L���������h�����������P��	
�	�	�
,�	�x��@	@
�	�	
�
l�H���|�P�D�����t��H���������@��������t�@��l���lh���X��4d��	�