rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������8�,|���lD�|�p$��L�$�����d�����x�H������l���h�H���t���L���d�L�����������d��������,,�\�	�
D
��X�0d�8��dX�����P��$��x�������,���d���|�t����p����|�	D
�D����$� "P%0$(�t
@x0t�h�t����$����������������,���������������������x(
��hx	��	��d��"�&'�"� l$�������t���l������������ڼ���4��<�p�����h�D�������d������H��!�%�' (�%� P����d�t!�"D"�d�
p���<�H���p�����0�$���d���X�����������(����T0��|�HH
�L"'T'�"�<�
 
0��PH�$8	8�(�t�t��l�@�,��L��(���������,�T�p�d�X����8�����t,

 ,�&�)($"$��
|���X�$���|�d4�������,�(ج�@�x�P��p�0���X���\�@�d�x���h�4$h�"4$�" �|�����l!�!D!`(
�(�l�p���|������l���l���,�d������p�t��l��`��p�����P�<�l #x&(&� 8|�	<p��	4���L	\��������܀���`��l�8�L������P�4����������	����|�4�
d
����'�*�'� ���t<<� ���T	p������������8ل��������D���d�������t������ `� �P,���h��"�"H!�������0��� ��� �0�4�`����<��ۀ���Dܸ�T����@�����0�����|�P <l� �"p!��L��	�P\@��������,��D����������� ���ڬ���P�������P
� d�D	x
H�(�")$*P%���
XH��D���	�`	�L����@���`��xܤ����������T����x����@���������(D���
�$&�'�$\!��T��x�������0��<���|���$�L�0ܜݤ�d���\��8���\����$����������h$�p��`�H��
 ���P��������t�p�����\������4������d�$ی�$�<���������H���h�X�� ��@L%8*\)P"� �
�	����,�P������4������4�8�$�L�����������$�p����L�����H	p	�	�
��|! (�(\$dtX�Pd����Xh �|��D�,�8� �8��ܠ�X������|���0���t�h��D����H�<�����P(�0 <
�L@��@����00�,���\�h�����t������T������(�,ބ�L�@�l�|�l������������|�8�
� � �"�D
�	��
�
P<��(p�$�l���������(��L�����x�H�p�����p�������4<4
H�	 X���p��X�$"�%T$,,H,��@����L
H�����H�<����\�8���X���(������X�4�`�|�$���<4	������
(��$�"< ����t	8��`���(�������@�`�����(� ��`�����t�����x���D�X����4�D�`����
�,��d|<�
8���8���@
t������t�����(���L�`���l����l��������(�������Dx�����P�0
@���"�$�!844�t�$�\�xP�����t��l�D���D��\���<��<�<�������(������h	8����`
�
x
|,��(!��`8������@��,h������������@���������������x����������D���x�
���4lT4�
�	����0P��	�����������8����T�p���8�(�h��\�����|������H�,����������������P�p �p�8`�
 		08L� ��8������H�@�d����X���`�`�X�4��(�<�d�@�������	��l�$8
x�\��|0��������\P����l����������,��X�T��\�,������p���d��������`��
H
h\
@H��dP��Lt����\���������������p�����d���L���<� �8���������x��8���������	0h�<��hh�$,
��
�
��|��\�(���d�����<�<�L�D�H�d����D�����l�l�<�p�������P��d� ��� `8��pd��
��	 X�8��
@,	����H�����<�(�\���8�������`�,���������@����D$	
d
�
H,��x��H���\�<	���������������x��\�D�T�|����x�����\����D�@�4������l�
,dP�
4���x	�
p�����
��\���T���x���������������0���,����0�l�\�D�P�<����T���������4���	�T��l��Tl8	����
�h�������T���D������������t� �����|�����8�����	��$���d	D����$t�	(D�����������������4���d��������H�������4�L���������p����\	�$d	0,D����
d,��
��������t�����<�T��<�������������D��(�X�����������(�\���|������
�L�
��
�
��(��� 	�	t�@������@�H����h�����d�x�8����p�`���������`DPD\D�4P�Pd�	D��@����D���<���,P�����X���P�|�T��H���\�t���������������x���H�(0,`� ����L�
�	�d����������d���(|������@�`���0�l���|�����(�����x��������h�(����D��	�	���P��d�84�h�<����������8�����L���$��,�,���4����� �������������(�0�������T@	�
`�	,��`��8��p��@�������@�T���������<�L�T�h��������������@4����PdH �<���	 	�������������p�����������8���p������P����4���X�����l���4�������P����8��x�\0���x�������������\��(��|���P���l���������������������������$��,����X�4��\ ��D��l�h�l�T�|����������������$�d�@�L�L���t�<�t�D�$4,4��hxl�lh`P���D��`����4 ����������L�L��d���X����D�����������X�� ����l�t��<�|�� x���4T�X���H(��l�x�p���h�����������,�������h����4�l���0�P�����8�� \P���p�����t4�����|� ���������0��������P���X���4�P��������(���L����$�l�\�P|l�D$����t��L\����T�����8�T����(�8�0�P���d����������`��|�$�l�8DhT0pDL��T�t<��������0�`�����������\�T�������p� �������0���4�����$�t�$,,���TH$�0��l�LH$�,d���(�(����,�p���,����������������p����������������l�D�\���`�(Hp����,�0H8 4l�p�X����p�@��������x���x�(���������p�,�8���,�������d��8����Ht|��`��d���x40|���XD0��<���(�P�`�d�t�������t�0��� �<�T�p�����L�����|xtl|������T����������������������p�,����(�,�<�h�������������������������Tppx���xXPh��������\��������x�t�������������������\�4�0�T�����������44��$@P`x�����hXL<, $8DH@0���������������������������������������������������������� $4@@88440 ������������������������������������ $(,,($ ����������������������������������������������$$  $$ ������������������������������������������  (( ��������������������������������������������������������������������������������������������������������������������������������������(,,00,$(,(������������������������������������������������������ ,<P\`P8($ (80������������������������������������������������@PH0  (,0@`����p`T8������������x�T�T�l���������������������������������,d�������|t���������T��|�p�x���������������l� ���������������h�������������������D���0L@�����������x��h�L�4���$�`�������\�$��������h�����d�����X���\,(P���d���t���@��,p�p ����l����D��4������������ ����x�d����X�����P�4P,�����d\�T�����\���@��<�l�l�P�P�������X���$��������,���T�������T�`�����������d<�8@<Xd ��t�8�����������������T�,�`���x���,����������,���������\�������X��L�����`�,D�p�� T���4��D�<l��$����P����,��� �,�����������p���������l����d��@����8H��`���4��l����Dpt����<�T���������H�����,�����d�����<����h���������Hd�����TP�@xpT`t$,�@�@�����������,���0�������,�����T�$������L���@�������h��P��������T(����p�(���P�h���������@�\�X���x������\�������P����������������@���T,(\x\@����h�h��@�����������(���`�����P�\���t�H�l�������X�����D���,x���0d�Tdt���8�<��$����<���$�x�8�x����@� ���0�����������\�@�\�L����X���H�������|$�X��d@����0H���0�����������|���|���L�����T��X������� �|���$�X����� $����H$$xt	<	��(���L0������l�����������������h�D������,�h���h�����T�0��x,TTl��lxhP0	�
`
	���$��p��� ���(����`�L�8�� ���� ���L���@���<���|��� ���@HX���`�\���l\P		��	�t p�(��P��H�����������d�8��4�4�|���X�l���4�h�h��,(��P�4���	|���
���0��0<�||���@��������|�D���L�|�`���h�����d��p�d���T�@�0\,������,X�T	�|��	@P�x\�P@p�X��$��l���p�|������������������|�4����������,	��,��������
�8
�	x����(����X�������$��8��� �X����,�������h�@�(�`�h��������@$	�
�
D��
�
�����	T	t��	@
��$���\�D���h��$�����|���0��������|�$������$�����<d`�t|@	H
���(l�
�
	��lH���PD�������,���d�P����@��������L��������4������P����P��H����X�
��08$d	� �������tT��������h���`������������0�h�<�@������l�����4�
�p
��	����d4��P�@��t,�,�����T����|���D������������d������|���������������x�4@	l

��,�tx�,<��\
��
������,�`��������������h�L�H����4�l��$�����d��d�l��X�
�@���X���p�@8�x������D��P��<�����`�0���������t��4�|��D���P
��\H8�L04����	������������,�D�|�`�(���<�d�$��$�X�X�h���,� �@�D���<���T�x���	T�4�\��
��,t
�
�	$	\�|
@��(�H�p���$�������`�d�<���d��x�$����$��X���|���tt��8�\	P��0lh�0d	�`�t���
<
�T� �h�������|������� ���|�@�$���L�|�(����
<p�
�
��
 ��@ �l\�X@��������T�@���$�����������x�4�`�������D���<���h���8�\�������|���
�� x��l�,���H������������h�$�@� ������x�����h���,����,���d�p�L�p���D��4��\��
��t�Pl@4
�������������������h����x���l���d�����<�������
$�t�`��$��8���x$4<���XD|���L�������0�<����|����|����l���X�������X�T�0�(H� |�\���$LP�������������,�����$���\�������@������l�X��P�����\������\� ��TxX�<��tp��\���h�t�P����H���x��x�p��������4��d�������l�T��$����t	T
�D�x00<D!�Lt,Tht��L�4
�
�t�t�0�h�l�(��0�������@����t���L������������	����h,�,�4�� ��84 �����P������������l���4�@�l�|���l�D�����p���@�������@�h���@���
����DT�X�d
\�(�8|�	��@���L�� �x�L��������������������|��T��������0�,�������<L8�`"�$� ����$�`@	������(�@���,�h����t����������$�� �0�����T���,$��d�|	x
\��l%@&�!�T<(�	T�����,d��(���8�$���p������l�p���L��0��`������,�t��������h80�
d
��4h8�d(h��d�$��������h���<�������� �`�d�����L��T����� �������H�D���0h
����!�!d0���
tt�
,X`���l������4�x�|�X�|�|�h�<�X�`�����pڸ���������4
�
d	\H ��
�
����'�)�$�8�$xl4�
� X�����|����T�4�@��L���x�L������������p��P��`���p�p����!�"�p|�������������������������,�l�x݄�����<������0�H�D���|�0�x���D��P���0PDxh��������������<�x����t���h�����P�,���h�8�t�L���D�0���|$lL��� x�("x&�%��l����
P\|`X
H<������D�|ޠ����p�����������l�����l��x	8�T�d�x�d
�
|0�� �H4�88
��8h�p�����������ݘ��H���������D�H���t�����H�(�����������lP\t��Tl��h���`���D�������L�\�0����$�0��D�`������X�,�����$�`����d�H��!( �(
l
�������� �����\����x�`�8�,������������P�8���@��������`
����D������$�)�'� 4�T�xH���
�����������ۨ���4�,����h�0�T�l�d���<����4������8
��\	d�T��
t
L�<!�������p���4������������D���D���(�����ޘ���\�������8�����l����DL��,, p"h��@
\�|ld$|
���������������$������,�T�D��P����X���@���\H����`(	 H��%'H"��PL
P	$
�
	�h�����������ܜ�4�|��d��������������P�$��
( ���
��d,� x"%�"�,��������$���T�(���������L�l�P�dڔ���p܀�����<���D�����P������������h�8Ht���L p\4�T������l�<�������T�X�d��P�h��������<�p�p���X�`(��H�l����t�!|'`*�&H��8���
$��(�
���D�@����߄������L����������$�P�H�����$�<d�h	�X�	�
4�  ,'�(h$`Xd�,
�h���L��	,��H����h��8�������X��l����������������
�@���4�
�
������4�d���������������$� ������Dߴ�,�p�|���������L�������8���T�����d�0P��|�@�	�hl�HD�\��x�������P��8��X��������8�4�0�,�������������d��	��P�"|#�XD���
( 
0�
��p��x���D����d��P�p�x�l��P�����h�p���T�<��\dH�(��T�����tL� ��������$L���h�����0�`��L�H�L��H��`�L�t�������h�h��`�������4���t\�0 �h����h0l8������p�8�H��(����p���,�� �l�����x������l���������l����������p�"�!���
$	�
|H�l
��<(��\�<�T�x����X��p����D�(�p���T����������p�`��h
�
h����p
@�� �dp�
�
���H��4@���8�D����(�l�X��|�\�x��d�����������������`���t����Td4
�	t
\dL�Xh��8���\���T���T�����\�x���(� ��$��� �|����T�|`���4�`,<��x�\p�P@
�X
<
��
D|� 
$��h�t���T�|�����$���D�d����4� ����(���@��@�@
4��
`T���H��#�!�DL$�T��t�(�(�(������`������$�t���,�0����(�,������H���D�	\p 
�
��
 �
��(�����xH���0���P�����<�H������X����\�������|����,����������4���T�	�\\P�d$	��@��x,l�@�p��������8��p�,�������������H���<����(�������
�P�(d	�L��(�t�	|�$��������0����d��������\���`�����4�4�����4�����
h|
���	��
@
�
��`d�t�
����($�D(���(�����p��������������H���x� �P�H�d�(���<�p���
� ����x,p
����H��|
������������x����� �P�X���<���T�|�����l�X���������<�l��������D�	��
@���,
�� 	 
l	lL��DP���������������H����L�������������8�|�L�4�0�X��D���l	,����d	<t(�D�t�t���h�����������X�L���|�t�����T���������4���d�
X�
�
�
��D
��D,�
x
�h����������l���������� �(�8���������������$���������t�th	$
�Hd0�8	�x	
p	|t�	�
<H����`�������������,�L���������������$���\�X�0�����	�����p��
T	8����4�����������x�(���P�����t���L����4������p�����l	
t�<�\��L
��\���
0	�h���@��`X���D����|����L�X�@���D�������$�������x������|����
h8L��
����``
��D
�
`����`�������D���@�\��D���t������������l���x�T���H���p���4���P��x�
tH
|�
�
�`d(��|�	(	�P������T����h��T���������t�<���8�����t������� ���� �|
LH�
�D�|t���� �T��������`�h�p�������@�`�l����������$���<����tL���l0T��x8��x|������,���,�x�T�P�����@���8�D�L�L���X�0�������,�����(� l������� 4��	D	`���������H��P�L���(��������x�L�@�l�X�`���������<�����d�������P�D�P�x�Hp��\��
�	���x8$��T���D�l�������8����l���|�����������H��� �,���L���D������XX,��|x\$	�	�t�0�(���<���|XL�8�����������p�$������T�������������,�����|�t�H�<�4������l0d,|D|X�`�����������P�������@���(�x�����������������\�X�p�4�H�<8�����0�@l��,���dPd�@�\d\�<�x������|�4���$����������������`�0�0���$���H� dx���d��|��,X�����D,��L����P�����,���h�����������h�$���p�������$���,���@��P��|p�`��x��x�d�t��Ld��������|�����x���������h�8�����l�`��h������D�4����d�Ttp���Pt�8L8@��x8D���(����������`�p����4����0�����4�H�p�L���T�@`T����d�H��(\�<���Xh�D�d���(����\�������`���D�X�X�l���`��������|�(���,�P���hTXT@L� ���L��$x��P�,�L�x���x�p�|���\���<������������H���X�������|�������������@�Dt�� �t�0,@|�<�4����x�0�������(�\�T����������T�$� �h���X�������0$��������t��H��4���L��|���|<��`�����x����,�0�<�h�����d�������H�p�����8����\P\`P@\�XP���d������04 ��x����������(�L�����������t�|�����������8����|xt`< ,T�����xl@��������������������������h�T�\�l�l�h�t�������������������������Hhttx��x\<48HLD8488(��������������������������������������������,@D4 4HPD4( ������  ���������������������������������� $ ��  $ ���������������������������������������� �������������������������������������������������������� ����������������������������������������������������������  ������������������������������������������������$($$$$   $$����������������������������������������������������������������$08HT\XH4($  ,0,������������������������������������������������$0$ ,04Ll���td\L4������������p�d�l�x�|�����������������������������<h||x|�xdLH`��������T����������������������p�L�@�<�0�$�(�H�������������������������8����DD�tl��������D����t�H�������T���p�@��������������D�������4X\0����0���<���t�����dt��������X����D�@�������������������H�T����D�`������������������`L�����DD$ $��H��� �����������$����D�(���������������H��L������0��4������P|��X�8�4��� �t���������L�����x�4��0�����p�����������p�����|D�X��<���������P��������@�h���� ����������<���� �����0���,��(���h(��|�P����p�����<D ��0�����������$�p�$� ��X� ���X�X�x�x�l���l���������H�X�0�t����h\��������������P������������P������4�x��X���������x���l���x��,�������p���$�������d���D���4�8�P���0�0�X��������t���P��\���H��������|�,�8`��4�,���0��x��lD���������@�����<�4������t�8�@�<����,�<���l�x��L�D�\�d����|�p@�@\��\���h�����t�0�P�|���|�x��� �8�h�L��t��������� ��������4�d�d�\�x8Lp�,�H�����DL�HP�� �d������`���,����<�\��|��@� ���������`�����P�8���l�`������,��X��D	����P8�,���L�������������X���8��������X�X�h�@�H�\�������8��L�H`hd
�	� ���T4P��|�`�8�`�����t���<�\������H�����������������8������`8���8 ��	�	4	t,�������X�����\�����d������x�����8�L�0�����|����� �\�P���p�8���D�l��D��h	,

l��|`X`�(p,�(������T�L�\����x��������L�x�����8�@���D�D���,��`����\���Tt	��
�
�����������L�������P�(���`�h�D�(�t��(�����������t�����D�$�D�``�<�d�H|�	H
<`
�	l@\��������p�����`���X�8�����0�x�������L���\������0�D�0���P�`���	�
(�	p0(�<�t 	
8Td	x�0�������������������`�����t�d�8��������������������<���P@��@���
�	�$���<�
$
����T�t���x����� ���l�����L���|�T�X�D����� �����P�0	H	�8$p(���``�P��	�\�8�<8D0���H���d�P��T�����<�8������h�L���������������������P�0D ��\4@�<T���L������x���\���x����H��������D|(Hl���������$�����X�������d���T�(|dTL8��h�$0 ,��\�`���@<<��x�|�|�P���@���������������,����$�P�t���x�l�����h�0���D�|������������xP,(X����@L��L,$����h�p���������t�`�t�\�<�H�p�����������������������88($(,�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $$$$���������8Ld�d�d\4<@|H��$ ���������������D���x���H�\������p�L�l�������H���0�8����,��������x$x���\� \�4��|XP�������4������H�L���\�p��h�������@�\�L�$�0�h	$�������
L4�P!4 ������4�@��dH
4�d���������x�����p�T���L�X��������������	������p	|�|p� �$�$l p<l$����������8�<��$����(���|��x۸������$�������������X�Hd!�"<"���0(��h�l � � l���������,����������|������4�T�8���P��������� ��8����
�t!�&()�'$�0�����<����\ ���p���<�@�D������`�$�8�4�4�<�L�d���(���
�l
�
H����
����\`�L����H������������8��D���H��ݘ�h�$���t��P����P�l���4���,������X������p�0��H,�x���������t���t�4�����P���|�h���0�H��l�|�,p������p ��X\h$�($)$tT�d ���`��������l�T�<�$�������H���� �����`�d�����H�@\
|��L�(���8��4!�)X,�'h�$
�@�����`��t�0<���������L�D����������h���@����t�������	<L�|��
�
P,d�������������t�����������l���L�<�x�ݸ�P���|�`���h�h���\����X���t�t����!"���HH
�l���X���P����(����������P�������d��H������H��0�H���	X
��<����
�dP` �$$��x�
 �	��
\�0
�X�d�������p���`���<������<������D����X��D
���
��T�
�8�D� P'�'t#�l�H	<H�d��0����������x�`�d�ܬ�����H���D�(�4����� �x�����h��PH�$|�lD��	���\��0 �dt����������������P�X����������t�`������d�L���`@��P������,$8@4,! ��$
$

�(�H����H�����T�L����(�h�x�\�� ����T����h�l�������8��
�8�	0�
��T d$h"�\T$T<�p
`
L���8����<���X��x����D���$�0��P�����\����4��T\��p
8	��
x����8��d
�������L����������t�T��|�$����<���x����������l�x����������
xTp�$��
(\	t�,�TP
L�h� ���|����d�����l�x���<�\����,�h���(��,���l�`���p�0����,l �����
D���$ T�����|��L��$��|�����\�����d����|�|�x���(��<��
���
�����`4p`D	<��h�������|�D�����X��(�|�����������������8��(�H���L�
P(��� ,�|	p��0�X�0,	���� ������d�D�x�8�����,����Tް�p�����H�����x�(�$����0�`�P$,$ ��8�|�ht
8($�|�@�T����8�t�H��,���������������p���4�\�����
4p�xXT	D
LX|P��$�,���X����0@0�����������������X�����l������������t� ����P�Lp�
�D��
�
��������P��������T�4����������4�P���D���0������0����L�����D���(�HD�L\h`�
���	Ld,XD�X\
l����T�������<�`�������(����P������\�P��,� ��
�
,��T��
�H�,��(
��
4	,X�`
LP
H�������\�@�����p�L������,� �X�����8�0���\|	L(8
0�
T(�	�L��T���
D`��`�t���������<�����D��p��t�\�h�����h���H�����������h�����|D
�t���� p�	�

<
�T��
�����H�8��������P���D�������d�l���d�X�����L�l��� ��H�����h	l|dx���X	,	�80
<
D
�	�������@�������<������<�h���@������D�$���h��Pl���d@@��@TT��� (<�
,������@��(� �T��������t��8����<����0��H�����h���������`�	t
T
�
�L�
 4�P��<H����8���@�4���(�\�h�P���,���(��,����\��D�������<��|�4D��`8��
�L
�l8d
�lx	�8��
0(4��� �|�D�d�D�p�����������@������H������`��������(��<�tlT	�H��
�
���H��@�(8����$�L���,��X�������8�x������� �4�L�� �
P�$xdt�������
4	����@��������|��L�����p����D�������t�����4�$�x�d�l�0���������T���	�4�,���<�����	���  ��p���L��<���0���`��������������������H��h,��,������	
�`
�
0�@�� $8�$D4`@����t����X�l�@���������������`���������8���`���	
0�T
���<�����������,t����������,�����������\�������h�P��d��� T<����0�@�X�h��0���������X������0�����$�����������������d�p�������� �������������h
�
P	�`t���4X�|0�<��������T�����d�p�<�0�L����<���d�@���0�t�������x��4t�<�xpT�4	$�4
<`��P<p�T�������������4���8��L�������D���<�����l�x�8����(��|@���� ���4���|��`�`�D���X�X���,���d�����������t�����p��������t������������T@�,x�dX`�x�,lLP�XL,,(������������\���X�@�p��������$���������D�D���0���0T�L$���|tT�`������`DD����,�<��$�8�L���h�\��������D�,�`���������D�L�L<��4$���xT���@�d,����L�8��t����������,�8�����d�h���������L�����h�����X�0XP�����������Hp@���4�l�<� ���������T���,�h���P�8������������������(|t����88��t|P���������d4��D���8���T���,���P�@���������X���8�\���������tT��8��Xt���`��8�\������d�l����|���$�d���p�������D���H�D���8����T�����������8����(�D�0�$��((\��<�`�L� �,���������D��������������4��@,������L��,x�l�������T�L���L������,�������������������d��������`�����d��D h���d����@��|`�����X8$����,����8�h�|�|�����������X�(�,�H�d�p�|�����L��hLHH4��@�������l$��������,0��x�P�H�H�@�<�T���������������������8Xp�����`<8<@HTt���|H��������������������������x�d�X�T�X�p�������  ����(Ld|����tP<4, $0,�������������������������������������������� ,40,8L`lpppxxhP8,$����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������    $($(0$�������������������������������������������������� 08@Hdtp`H84,( 00����������������������������������x�x����������� <<4$$0<DL\x������xhH$,,��������h�<�4�D�\�l�p�����������|�d�h�����������4���������hp��������p0����������������������t�0������������h���������������������t�$<TD�|���������`����|�x�p�\�H�P�|�������<���������������h���������(XT����D����\�p�����xTh���4������d�����8�8�h�����p�t���������t�h�����8�T�|���\�����$���|������0h����������`�L�������h������������l������L�X�,��8�x���d�8�\���(x��X������l0T8h�����x�(�D���p����`�����������������D�t�����`��\@���@�t������x(���t�p���t�@����������h������������������8���t�������P��T4p�$�L�$��@�����@����8��d� ���� �����|���4�p�h�|�����\�\���`�T���@�����<�4x����� �(�h@���$�8$���������\��� ���X�X�����l�,�����H��� �$�h�<�0�`���X���t�����\��p�hH,����HP�����T���������T�d�,�4�����l����������l���|���`�$�(��h���$���$�������t�\,@h���8������<�����X�l���P�\����������|�T���$���hP�4�l|��,4,���`�` ��\���,��� ������p�����8���H�������x�L�D�`�@�|��l��`�$� ��,���lP� �T���\`��T���t����������t�p���(���0���h�,�����D�$���D�����H�������������4	,
�	l`���H�8 �x L����4�x��������<��D�t������������x�<�������H����X��<@4h	�
�
�	hD,����� ��|��l��t���8�����P���x���������t�����D�\�����d��l���\���h��H�84���	4		 		��4�� �����\���4�l���T��\����`���<�����x� � �t�T����t�p�|�h�����x���	\
p8�,	,$��� ���,Pd�0�������x��������4�p���X���d��� ���d���������t����@��`
�
`|�|� 0 �|��p$��d������h�� �<����������\��������H���D����������$��H$	����
�
�
H
������ ���������4�,�����x�<�����h���0���������L�\����\�H�`�\d���	4`��	L ���@��d�,8����X�D�����,�<��������D�L�0��X�8�������T���dt�������dp	8�
���\
0
�0��L|tx�<����4�����������`��������d� �|�x�����l��X�(�	4
	��<�	�	<
$`L$p4DL	TT�h�������d��������L�8���\�l��T�\����(�����x�0���8�����X������t	�
\

�
��,
��4

��
L

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

�X�
�`P��,8D�lt<4�p�����d�p�@�����T�`�l���������������h�t�0�0�(�������@,
L�h�,���0�L�(X��\`����������(� �����<�����\�t�,�\���X���(�����������L���,�
x0�����T�
$
�t	�$	`��
<	t����|��\����D������ ��������8�4���d�@�� �`
���X$	�	����(�hx\�\����Xp���<�����(�,������4����l�`�\�H�L�H�<����X���(���`|��HT���$
�8����� dl$��������|�H���h�h���<��D�|����� �� �t�l�`���8���0�X�	��p����`H�
lD��L�P
H	l����8��T���H�<���T��T�<���<�8������x����`8�
�
�����	x|8`H� �0��`D	\�������0L����4�l���<�4�t���<�����(������l���������4����l	l8���
\�pP|
<��XlT0���	4����D�������@��������D��� ��޸��8�d� ���x�����(���,�8������h
 �\�t����h\d��4hx`x���,���x������<�p����$���������l���(8��p
	�dHP
,��  !�"T �����`���\���x�4�\���x�|���������8�(�\������޸�h����������$�@�
4	4��t�#�%�"�������� T	�	��xt������t۬�0ޤ� ����<�\� �������P��`�X�<���T�L�
H�
(`��(,l0������|�������������(��������۠�H�� �@�l���L������@�����|��<���"�%�$�,����
4��
T��
������$�������@�������8�d��������l�l��8������
hHPd������"d)�)�#� ��	�������	�t�l�(����`��H�,���P��`���,����`���l���X�H�H�t�Lp��p�DD �%T%� ��t\�����<���������T�8���\� ��ޔ�t���0ܨ�����X�p��h�\�`���������� �Dd|p l���<hTP
� �������H����0��������\��(�����<���l�<���������x��x
�xp p&h&��������
��0�l���,��H���P���P��� �`�����������L��@���t������H�\`�`���!@!�|XT�Ht�(��d�p�������<�P��p�`�x����(���<����0�t�����0���DT@�����H��
d���@��LP	l���������d�l���T��P�T�(�8�h�$��ۄ�@�D������4�\�������T�p�(�
dT�4#L&�$��4������L���,�h�����<������d�(�����������d���X�p�����
�\�	�
L�P�!'\&� x�<P����4ht�0�����(����\�X�$������(�|���h����L�,�P���`	<�P���4��h�p$D<8��	��0���h�@����t���8���\��Pݰ���ܼ� ��8���� �\���d�X��X�t�
,l�h� #\!�\��x��4pT��,�T�����������p������,�d��4�xܬ�4���H���p�����$�
�����d\��`p"�&<$�p���
�
T��
��(	�L���������D�����(���@�� ���l����x���(������dXH�
�
��L���$�&�"�8XL������T l�����H������� �\�������$��������D��������p���X�������t\0��
�
�8th���@
x��� �|����t��������\�d���`����ڜ�0�X��������t����L�L�H��<�%X(t$���
�
���,hL
@�����4�����������L���$�`���H��@�����������D�
,P�P
��,�'�*|'���lxd4�\0
����4�h�����h�8�(���$�������������P�,�����
4�����$
D������`�
�X��������(���T���x�0��������l�������h�� ���d�������P���D�D�P��`�����
\�8|��p�p���,������D���������������X�P�����|�����@�����P�(�\����&�'�#��\��t
�	$	`4� ����0����������D�(�,��`�<�������4�����8���\D(�	�
�0lxh!#� �``h�	�������H�,�0�������h���D�4ߠ܈�8���p�4��0�P��������x�4�<����<ht(��@ 
L���h��$\�������D������<�T��\���X������T���P�4�����@�x�,T�@����|4
�\<p�t�
�	�	 8
�
l�@��d�����p���P�0�,�8���H��4��D����P����h�d���\�h�
�H�
`
�
�
H
l
<,T��� �h4�\�,����h�|�����p�P�D�,��������l��������l���$�|X
��,8���
<	�	�d�������DP�`���p� ���<��,�����0�`����<�x�x�t������������P�x���<�4\t
���4L����
�T
0
��	\
��
�����������8�H���h��P�4����l����������,�����
�D@
�|�	��
�
t��  �8������ �d���h������������D�,�H�p��8���H���(�`���`�H�����8$0<��
|
`
��x
��ltt$�l��������d�����|�����@��p�@�<������p�x�|�h�`�����\����������t�h��, 4T�l�����4�\HL��d�d������������p�����l���,�p��@���������$�,����L����H�
��
�L����	\	8	����	�
��@���@������|��������D��$�4����(���������t�	<�	����`	,
d����D�T`�`8�l���0��������$��p��������P�����d�`�P�t�h�x�����|�����h��
0
 $�h�
p�
���D�������������<�������������,���D�D�<�p�@�<���\�4�����h��\��\ 
<t4�04�$
���
��
�	�
�@
�
T��l�������P�d�|������������ ������x��|�d���l�p���HP8���	(�$(l�����	�����X���P�$���d���T�����,���h�����(��`���t�������p����
�	
�	(���	�
$��XlD
x
����\�T�����t�����L�\��������t�X������\�����`���T�,�X���(�h���� pL
����	�
�� �
,�
�
�
������4���(�h���������������4���X����d���<�lh��$����,���	�����X
�	�`������|�	��,���L����P������<��������X��X�l�� ��������T����H����
�����������p����0�@����d���0�����t�����0�t��������T���X��P	� �\h�
D`�l �	h��p<����`�����L�x�|���x�����H��D���0���� �t���\�L�������(�����������	@(
��
�
\�`x�hX	�H�t���,��8�8�|�������h�X���8���@����������$�h���hpX�HH�P������

�
``0�P������d�@�p�����������,������8���������|�l��\�4�x����D0�8x��t���	\
�	�T�������������x���\��4���D�,������D��<�����d������H�x���P����,<�(D(	�$��`�D@�h�<`�P�|�0�X�����������P�|��l���@�������,�8���H�������,x��|�,D����	X	P,���\�d��H���������0���p��d���L�d�L�T�P��\�����d�����0�������h��tX\X@	�	���,|��$������HX�����|���d�T���`�t�����l�����D�0��������|���d������,�8���h��X���x��p��$������\�\�L�X�X�����8������l�����l�����X��|����������Dd�����L�|��,�d�(P��T�T����������x���T�4�l���\�������t��������p�|�0t$�4�l,pTXx(�@4L�T���������� �|�d��������0�������(���P���H�L���(�t���x����P44hX�|�$�lP�|4������L�P�P�$����\��������h�������������X���������$��p�������@�@�����tT�8`��t���4���(���t��������d������|�������\�����8��T��������\�\��40`(�td8`��00D���P���0�������T�������������H���L�p��������d��l�4�� hP���d�D��4�4�\�l�T�8�<�\�t�H���D���������������� �x�������������������|�Lht����,�����$|�8�����|�T��������`�����H���������H�����D���h�������0P<����|���8��H���h�dD\h``���T�X��x��������|�����T�@�H�4���x�,�4�����<�`�����D|h,@lx|��X�|P44��P0,0,��������X�$��������������0�8�H�T�h���������@l�����������������lH������������������������h�X�T�T�T�T�`�������������������������,LXX\htp\D<H`ll\XXP8���������������������������������������������������������� ,4@<, ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$08<DHD4(44 ������������������������������������������������,0 ��(Dd���hXL<,,0(������p�d�l�x�|�����������������|�����������Lt��xldXLDHd��������L����������������������h�<�$�����(�d�����������������������`������pl��������4����l�D�����<�������h�<�,������������T�����(P���`��d���d��H����pP<L���`����`� ���X���T����������0�<����������X�����,�$��`��4����`<��������((�������d�������������8���0�`�D��������������T��D��������l���(|���h�4��������X���������H�����X���������`������������� ��t�<��H���L��@TX��4|���,���L���P�T���p���������x�P���$�����D�0������@8���,0t$����@�X��|���` d�(����������,�l������,���,���������h�P��$0���0l�(��x����pL�l���������������$4h�������,���,���0���d�������x���������8�H�\�pH�H�p����H���L������X�����4����������������\�t�4�h���,������<�D�D0@��L�`\8t�X��`H x���������T�h�D�d�����H�������������P���|8�|�l�T\����T�px�p�������������@�l���L���<�,�H�`����8��������������h�������������h����0\�4p�x�(8�(P dH�p�d�D���D�����<�`�����8���,���������`� ���p�\���d�d� ������l$X�l	\���P<��� ��H��,�@��T�t���|�D����p�����(���X���t�����|��������� �\�|���X�	�	��D���($t�$P@���0��������D�$�d��8���`����L�������������T������$���D0,L�xT	����0�,��H���x�������H����������� ���������H���l�|����������������� �P`��	P
	�����|�L$���0<������l�t���������|��D���,���T���4���X�<�������@� �\<����	�@
��
��P\����l��4�L�h�\�<�������4���H�����<����������T��������� �<4����HT`
D
�,
�		�l�(�xH�����4�@����������������(���4��������P���������<�<�Th��
�(
4�`�� D�0��
�
(�����x�h���������|�����|�,��|����d�p�L����x�����$�X��������8��	|