rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������tL,��,T���t��|�������@���H�����h���(�p���$���l���P�h�����d���l����,� �h�`��l�������<���xl�|�X�l�$�����X���$�l��d�P�d�,�4��8��4��������
4	@��P�(|D���(&D*d(("hl�
�p�������
t���<����H�ݬߔ����4���H�X��`�����������	�@@�<���
��D�$t%#h��� 4�����@�����4�Ph��h����8�0���Xۘ߬�`���������������X�|�l��0�� �!�"� 8�$�4�P����@���\�t�������x���������d�߰����٨�����l�d��H�����|����H
|��!�)�,�(( L�<�$	�x8T0H
HH�������p���� �p��������X�����|����4����	��H�$pl
ll
0x��$�'�$��h
`���P���,(� �\�����(���Hژ�\�T���@�������,�P��p����8��
�P��d�l��	\�4�����px(4���h����`�(�����������\������ڌ�l��ݠ���d�H���|�\H$�����t�Ld��$D$�)�*�$���@
�h�,�@d	l��� ��\��Dݔ�d�\�������\�|���T�8�\߬�t��@��pLpx���	����!�)p+l&�8TD�	�����x�
�|	��������`�ڰ�tۼ�������|���<��������������X@l�X�	ht�� ��`�����\���H�����$�����(�������0�x�pܤ�����h�����`������t��������L��#�&�&�d��	����d�X�����`������h�P�����\�T����<�<�$��ڰ�t��$�����
4��	�����,
��|�"*d*�#�,��
(p��,�
�
�|(�����@�,�`���`�X���$�����t����|���\�(��@P�����\�	\��"�#� ����(x���(�\�����l�P�X�����|��������@�H� ������������,���������t��`X,T!� `�	X�D���0���������4�X��\���4���<��$�p�`��������� �(lp�	�$�����4�$��$#p(�'$ (�� $	��8��Dd
���H�T���\�ݘ����4�����L������H�4�d�d������h�t|��D�
0	�
d��
�
d0�%l%p �PH����|��� 8p��P�L��������`ܼ��� ���������������(���4�\�h����Hh�h�(��<
�\
�H�`x(�p|��x�@�P�����`�����t��@��������ް��(�(����T�l���x����4��������d\� \#4!�dl
�	 �
,
�����|
�l���H��������������p����|���`��D������4t
�8���8��L"&L#�TD���|�	
�
 ����L�T�������������L��4��������������
��t�
HLD\
dx� ��@� ����T���(�������l�(���������|�D�����������t�����������<���������
<��@H��t�8	�
��@�@���
��������,����������X�|��d���P�p��\�h�<�h�������������<PT\,�!h��8�0��`|�$�����8���`�P�\�,�x��������@�����������$�$d	�D�	�	���
�
�<<�D���t	0��������$������������(�H��X��h������������(�����������8
��|��\lt 	�	@h��� 0,�p���X�$�|�������t��0���\�h�(����L�|������`�������|�����
dP��HX���	h��
 @�<��X�L�����@���8����������p�D�������p�L�����
�
�X�\�	�
����DX���������h�����p������ �8�������������$�$�8������$������8���(
40	��	d���P��
�������`��������h�d���������<�8����(���P����� �T������ �(�����
����<H$x\	@
�	4
|l��4���������$�$����������������H������������X 4<���TT�	\������,
����T�d	��d�@�p�����`�� ��<�������������T��������`�p���\�	h
T
t
���X���<���,0L�0	����������x��D���������|��$���0�����<�����l���H�����������<����4�hp�t	D
0p�0�
L	������T���P�@�P�0�@���L�����@��$���0�������`�<�4�X��d0���@���T�	\
$����
���D��,
(�<��������\��l���t�|�����(���p���H�h�(���l�x��t����Tt�	<
�����	���`�|`X���x�\����P���l��������h��`�d�����X�`���h�d�������	�P�	�8	t	TD`�	X
�H�@�P
��T���$�$�(�H�����D�@���X���������4�������t�x���������`�H�0���T�	�
|��
��	@`�LH,��D	4
�0�P���l���������H���d��������\���$���L�P��l������@l���� $���,��������P�,T������ �����x���������d�����8��� �����(�(���4��h���h�d���$�
�	�TX��������|����(���8�������P�t���$�X���l��������t�,��������������P��\	�	����\h��8H��������,���P�����L�����|��� ��� �l�����������<�D�T�(����0�����
�L
�@�����@���d�������p����������������h����������,��4�T�,��8l�����$� X	
$	�@���X������L�4l  ������������� �h�@�����d���h�0���X�t�����|��L�dl��\XL��TtLx����l������`�������8�h�,���0�$���<�4�t����L�<�����0�t����������$�<��h�PL�� 0��8����8�|���x�\�@�`������\����,���������������������X��Xt\�`�@����4���T|������D�d������������T�x���D��(�d����������4�8�����P$T`��(���`�pp�H�x���d���������������p��������p��������4���$�T�����D�T�0�d�`��������,,hl �P<@�HH�T���h�`������,���P��������x�H���p��������������8��l�\��X��P0hd����4@�T4t|��D����8�����p� �l�P�$�8�h�\���$�������T���0����`��<��H@,l �|d�X�\���h���`L��������@�h�|�����P����������h���D�����������0����� ���@��h�(����@h��L�T�l�\�,��L�����d���4�������������t�,�����������������`�l����L\p���D�l|�����D�����P�D�$�������L�������@��������h�D�x�������$X���$���� p���4���$��lP����`�|8������`����x�����0�L�X�p�������t�(�� �X���������������t\Px�����H������������������������X��������0�l�����������������������P��������dHPdxxx����L��������|�p���������������|�t�`�H�<�P�����������$������$8@Ph���`H<80$$<D<,��������������������������������������������(4<840(������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ (($  $,0 ��������������������������������������������������(08H\lhT<,$ (44$������������������������������������������������@TL8$ $,,,@h�����tdH ������(( ������`�<�8�H�\�d�p�������������h�l�����������,|�������`<Dl��������0������������������������@������������l�����������������������0���@ld ��|�������0����p�<������� �x�����H�(�����t�<�P���(�������T����P@h����`��\��X������T��L����x���H�����<�|�������$�p�l����h��������T����H��P,4<���|L4����0��H�t���������������d�������������p���D������H���8�<���������4|�x�(�x����D���D������d�,�\���p�l���$�����|�$���`�������d��������������|L�\������l\���������������t�����8�`�8�$�L�|�D�����l�����p���\� 0 h�<��LlXp04�@��Hd<h�L���h�\����8������ �D�X�������\�(�p���������������@ ���<�������������h�����x�L���L������� �$�����T�������<�������\�d�����<�t� ���D��D�\ H|�x�$4@��8�����H���x�t�4���D�$� �|����������������L�����0�,(<dP��x�t�`l�@|� �0lT�����$���h�����p������H�P�p�,�8���0�����������0�����d�P�\P��Xd�x� ���`D0��x�\����X�����<�����������x����������������|���0�p�����D�H����|���Dl`����(�`8��@��� �����������L�@���@������<������������t����,���T$���H
4
X���`|�<��H��������d�����d�H�<�$���<��������H���X�������P��d�T���H,���h	�
P	���L���d��������,������`�l�h�x�D�`�����D�t�����������(�(�����hXh��8H��\�\d		��	`�p�������������������������h�0���������������������l�`,���D������,
4�

T
Dl`��L�L	p8@\�������(���D���8����� �`�h����p�������x������,$���pX(�@�t
�
���	��t���4�������L�T�d��<�\��t���������\��L�$�,�0�����������	���0h��`�	��
�8�
T
������h�t�8��`���������P��l����T����������h�X�����4����� ����	`�,�
��
�
<|<@l	�@�P
`�	�����L���������D�������|���|�\���������8�����H����H�X,	�
�
|� 
�	0���d����dX���������������$���������(�<�������d�����p��	�
L	,h���`
���8x�
��
������������$���H�0�p���������T�D�x��������L�@�0�����8���������
��lp
h�
l
���p4��
|
`�@�D������t���@���h��� �l���������4���@�����@�����|���������T�
�T
D��(�	h	0�����l
pl4��H����l�t�h�P�|�����L�����@���P�$�X�������Tl�	d�H�\p	�	��@t��(
��	�(�����������������<����x�����������@�D���������L���$�<�X��	���
����P��$
p$�����H�D�����(�D���\�����<���,�����4���l����`��� � �������T���t�	DT��T�$
`, 	�������
����������d���4�$����0���P�������T�0���������H���`������lTP	\<
�X�T`4
��p	�Hp���p�����������$����\��������������8�<�(���(�
��|d	��
pP
�(
X@��hP��@��������H�4��������$�����p�8�0���x�d�,�`�|�(�����@�8�����P�H��p
Hx��lp�<
��0XP���
�8��X�8�H���H��@�H�\�(����|�X�L������d�0�@���@������������8@$�Xl�0H
8�	�
P�
�������0�������$�l�@�@����0������$���h�TD
��
d	�|d4��48������\
���X�@xd8��������<��<�T�`���`��(�(���������������`����D�����(��$X�
`����� ��|�H�����h�����$�D�t�����P�0�����������l���P�x����@��P�,�\l|
H�������4�P�����t��������`����D�0�������� �t������(�$�	��l|
l
�tL8"L 0���
	t
h
T�` �l�@�����P������,����<�P��$��|�0�\�,���\��� ����
\�
���
������x�
x������������<���t����������\�$�D�L���(�����x���������(�X���<�P	@�l@��$
�
0
(pL�l��l��4�����@��T��T�\�T���$��p�8����ݔ�0�\�T���\��LX�@���X�t
D��4!$� `�X��
8��
L�<�������������� ��p��,��0�������l�$�D��||
��p	�,t��$#%!�@��
T$����$PT��X����$����0���X����l�����t�l���,�4�����������<t��
�	�`,,0���
����L���d�t������D�H���0�`�L�����ܴ�@���d�\���<���8���<�h����(�p�$$ %�l���
���
4��`	(���8�����d���d�����H��x����0�� �4�$���,����0$�h
�00�
����,!X(�)T$Pl��`
���|��	l��l�T�����`ܰ���T����������\���X��\��D�(�d����
��X$8$<��|�4#�# ���$�	��h�������T���l���D��$�����|޴�<�x���������<���0�x������(� �lP`| ���

x��X��<�P���������X���x����<�<����d�4�,�p���(�D�t���L�X�����l��	�����"�(�("��8�X�	(�`
D� � ��h�@��ߌ��$�t�����0�8�`����8�������L��p��p
$
��$��P�$&�%� �,|�l	�� ���dH���`�$�l�����|�����p�����|��p�H����������X�4�<��(�������`hDx�d���@��h4����(�P�h���P���P���������<�\�t����\���d�D� �\�<�l���X����\x�!&\$���|
D��,��,�\����X��������(������X�D��ڌ����D���8���
���	�LT�X�%�*�(�!�`��`\��x��	�����<����٘�l����0�l�����|���(�\�H�������`�\��h�Dl�#"�l������X�$�,����������`������,���ݴ�|� �|��@�8����<�d�,��������,P !�#� d�
���������t���H���� �������0��������T��ؐ܄��������`HT������X�X���D&@*�&���
`	��<8�x
<��������$��`� �t������8�0����(�ߘ���������t	��l
�
T�$�
�
<�T%(�$H�``4
�������x���������l���ߠ�<���x�����l��������@���X������P
�(�D�X`8	4
`X�@�xdp��|�������X�h�4�����p�\����H�x�P�(ڌ�,���������t�(���\���8�H�
  @�|%'�!@���
�
|
�
�����|������t�<��߈�`�������`�8�t�����P�\�,�����t�\���P�
���p�&`(�#dXh��D������	@@�\�������ݤ�(���H����X�L�0�t�����4�� �\���p�$��X��0���h����
0����������p���|�|���L����H�0����޸�T�H��� �@���T���P���P�����8��,���<@
<l���, 	��������������������p��(�����ް�L�$�����`���P����
P4�T�#�#@��H�
�0Pt�T
@<�������������l���x��<����0� �D�����4��H���\�
���
�`,LL��||8	h��$���X����(��`�d����<���<��\���L�4��,���8�L���|�4�l�������X@�\x��D
�
h�`d�4�� ���<�<������� �������������T����X�L�������@������H��������|���#�!p$
��
$
T
h|
d<@x���h�h��������(������L��������t�����������\$	�
DXt��`"� (���H������8��<���\�����������������������H��������$�����P����<p�
�
��td�,�����@��x�����D�����h������h�<�,���8�@��`�@���L�H�D�H�l�h�D�����p����0��
L	�	�\�
��L(�
����P������� ���P���������|�|��(�@�L���l���,�
�<���	l�
�,�����T
�HX\	0�
��������h���@���l�$�(��@���d���������������D�p����h
�<
D	`�,���8�|@����x������������������@�����|�������x�������������\�4�l��t����,
��	�������T	�����4�p�T�\������D���������@���p�4�����(������(��T�������
0P�pd����	`
|
�D���$d����8�������|������4����4�(��������@�������
$�	��|�	t	�	@
��l��|��DT���Tl��\�����������(�`�<�l����P���x�0���������4������lt
8p
�
��
$�P
��(�H�<
�,��������$����P����x�|����8�������@�����������������������0x
�8`�@
��	�
T
���
L
 t��������,���`���P���4���P�`���8��$���������||�t�X,8	`P��
�
 D|P@�������\���D��������T��|�����L���0�<�����|��<���4
@d	�0	�tX��������
�
8\���d���`��� ���������4�������H�������x�����L�,�����d�t�x����
���TT�
t	h�4	�		|	T4
�t	����������<��������������0�T���0����\���@�D0p,�x���p�\�@	Hx���t�	`��xx�L|�d�����������D�T������� ���$���<�����,�����
�	���<x��l	�
������
�x������� �����4�����0�<��8������������D�����|������x�����L
�

0
�
�
8	PP�tP
�\�
TL����<����,�����0�p�T���T�,���,���@�����l���T�L�\�P�d8�������h�dp	�
4
�L��d�P���l	�@@�������,�����������L�p��(�p���p�D�����8���P ���,(����T 	LT
�`|�lL����`�X������8������@����D�h�`������������<�T�����`� |��ll��P\�$	
p	�P@4�� �0���l�H���T�� �����T�(�4�X���������D�����X���� �T���(������4��h	��L����X������0�,�����h�����������X�h�8�����@�P��`���|������x`�pd���`l8�	
P	HD<�|,��hL���h�$������`��l�������l�(���X�p�|����,������`\�l��Xt��$	l$$��4��p�,�,l��T�H���L���������@�������\���T�t�h�|���x���P�X�\����\D$,P�$���|�����0@,���p�\��p������������������X�����������@�����������t�������8\�L���@����H��0����4���`�����������0���x�,���p���(����<�L���X�� �,4�H� $lTx`�P���l��������|���l����@�����L�\��������$� ������H���Hl�X4�(p\(�������0����l�����x�\���P���P�,��������x�D�p�X��� �������������d�����`����H�hX���X�����h��@���|���L�����L������ �����t� ����������������d���L`�l���lp���P�L��� 8�X���� �\�l�����������4�����(���`�����X����T����d��d\|t4��x,��8���L���0�������|������������������������8�����������������`�H���Lp���������$Htl�P��P�0����������`�����4���������@���t��x�������@tp,����|���<��������H <���� ������,���t�����,�P�L�L�h�����P��������X�������L����ph���x��4dX ����<������( ��������d����������$�P�������������������������L��������P08\�������`��������������������������t�l�`�P�@�P�|�������������������$Pdl����|P4488, ,DTP0������������������������������������������������$4, 0DPL<,$��������������������������������������������������������$ ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������   $$ ������������������������������������������������$0<LX\P8$ 08,����������������������������������������������$<@4$$,@`���hTH@,���� , ����������\�P�\�p�������������������������������P���xtthL,,T��������<������������������������`�0������0�|�����������������������$x������`Tp��������P������p�D� � �P�������p�<� ������������(�������0XX(������H���t���0����xP`����H������8���T�H�����������H�\� ���\�P�����,�\���,�,0��������4�HP���0�������@,��������x�������������p���l���@�����������L����|����������@����(pp��(� �(�������������h����������(���������H�������XL��d�\����T��D�L0��$@H<�H4|���H���D��������\���x�,��8�,�����L�l�,�������X@����t����|D��D�����TD�8��������������x��D�l������ �x����$����\�����\�HTd$�@�����dX���D�����T�`� ��\�������x� �l�T�\�8������X�p���D����������<�����x��<����L��t���p�������4����X�h�����H�0�\���� �4���D������������x������t���@�x��l@lD\$��Tl���|����X���(�H�������d���l������p�������P�����T��D����|�L�\(|�,����D��`�p���0���� �h���p�����`�������������T��� ����P$P<@4����pH�D(��l�����0�8���D���<�����d�����X�����`���8�`���h���8��p�4����������P���0�	,
�����$�8P��$t��8�4�������,�p�������������8�\�t���l���$�`�H���8<�p��8$h��	P�l
T� l����,x��(������8�����������4�����h����������(���P�����@���(��pP�|\	�	�\LlT����|�,�|���,�<�0�����H�4�@��� ������,�����P�p�(���H�������d��@D	�
�	<<������H�����������4����4�l���<���h�P�l��������H��|�D���p(���d��$���
�
����`L��DT( `\������,�����������x�l���T��� �<�|�����������(X����8p$�X�
�
t
�	��4d�`������X�|����\���P���T�d�������8�|���X�0�(�����(�����P��h	t		l	|
�
`	���4�	�
�
x
�XD�8���$��������d�����d�<�8��������� ���p�\�P�����p,�����
�<�8
�(x���
L	��t�P�8�����L������������@��������������X�����D
�	|�����d�0���������,�����h�<�l�H�������h���������l�<�H�����,�(�����PD����D�����������d������(���x���x��������(8������$�T�|�|�l����0������\���0�T�h�0�����t���\�$t���� ��(XX@Lx��(��`dL @PH$������������������������������$4<8$<D8( $$��������������������������p�|�x�h�L�8�<�X�t�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������    $    ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<lPD\���L$����LPh����P���������\�|�$�������<����� ����0������� ����������������������8�T��PX������� ���p�D�����D���������8�������X���l��p��X��	t
��$<	�<,� �$�#���d
�<��hd	`
����<�P�T��� ����x��D����������<�l�X��0��D��\<���,
|�|��#�$�"P ���,�����$��� ��������0���L��ٰ������,������H���\������4���
l�dl!"����T�D���L���\�|����X���x������P����x��`�(�(���������d���� � ��<	<��"�% "�X���
�
���H�D��p�����L�|������|������ �l�4����������@(	l��(H	�
8@��$�"�%�!hh���L�4��X����L������X�|�D�T�|������`��������<�t�8�����X�t,��44��D\
H���L� ���(��8�D��������������0���� �@�P��ۨ���t�(���d��������h�|���l Dh �"|$��p��0�
�
h��04�������0�����P���D�������L���������l�l�H���d���P����LH�(�"�)�*|%�|``�`Xt�
�
	����h��������ވ�d����T�`�H�\���������� �80���8��l
T
��  � h����T����������������������P�`� �d��� �����������`���,��������l,��<,�X
�	<l��pH�����T��� �t�t�|����t���L�����Hߌ�۴�8������� ��	d	�|������<�p�4!L'0'\ 0��8�h����tlp`��� ���p�|��(���P�8��X����d����(�p��(����t|���
xd
(�p �%�%� �����l���������������d�D�����������|��8�T�(�������`���|�d�P���p�$	 <h�h�t���,X<D�0 ��|������������`���P����߄�H���X�����p�����8,x�����d	�X���"�&�$���
L��
���H�
Hp�<������`������L����H�8�P�T�T���$�0�,�P����
t�H�|��
|(�!X&$X�� �`������	`����|���d���<�����X�P�������������<���0�����X��\H�HH�\X	�DPp� p0�P�����4�������d�����|�������@�����X��������@�����P���h�H���`�
��,��l� �

���`\��\�
h`���D�\��� ��������h�8���`��������������p��,��8�d��4��\x!�\|
h��, \
�
�����p��������� ������|��p�T�l����(��p�D�H�0tH<�
�d��(��DX�<l�T���,����������(����|�����h��t��`�p���|���������L�������<�	���L�0�$�
�������xT�
$h� �������l����������l�8���@�8�x���d�$������d��d����
|��x����\���
Tp(��|��������P����l�`���t�����(�H���l�$���$���8��0$l<�	���h,\ �`@8�	,X���$��������l��l�|���P��T�����������4�D���h�(�t���P���
L|�����$|Ld��p@P��$��H�\�������(���������t�0�\��d���@�4��@�T���,�P��������T���h�����4��,	�|	���@���
��l��������l������L�����������,�@�p��4�P�8T�D��(�x	��
����< �
�
(@�H d���X�H�|�P�@���T�����@�,����������������
����Td	�	h��
,DHx�$x|�,���`�<�T���,�0�|�t�����p����T���h�@���0����@�T��H���H���0ltd�h��(
��h
��DX�T�������X�t�<���l�$�������t�����D���d���8�X������4����\������
T��t��P�H�h�
�������4�P���|���|�,��������$��D��D����(�0�8�����

,��L�,$�	�
D���
�|
l����|�Tp�����l������L����t��4�4�d���d�,����,���|���(�
�
�
��l
�
����D|�l
�
�Tp�D�l����t���t���`�������(�,���|��������������l�\�t���<�8@	$�
 �|
D	�,������	$�	��������L���h����t�����\�L�����L��������$�x���� $���|� ����
p
�d(������� ��T�T�����|�d�d���`�4�4�����H���8���(�������4����	�
�	XL�4Xx�4���
,
��
�	����������������X�|����������������� �����L�������T�������������	4
�
��4X	��d��x�	�
�	�`�����p�������$���(�p����4����(�L������p�h������t���(������ x	�DX�
�
���0��<��`hhd���������x���������<�4���X�P������h��x����l4����\\��� x
H
��
0	8�@�����<�L\P����������0��P���(�(�\���4�t�`���P������,�����x8|�,�T����D�\�d��H���� ����������8�d�������T�����T�|���(�@�������������\�$����4
p
�d0x��t�$��0P����������L���T�|���������t�P�p��������4�������$���D����h�@����
�	t�8�D�T�h�`�������\�t�0�@���P�`��������8���X�h�|�����H�����8d�����,��\h��0�0�X��`�\��d������(�d���x�D������������D�H�$�����������0���l�t�����$��<���`@8� ��4������d���0�h�T�4�l��������(�������������L��P����T8L@��������$4,��h\�(�������8���X�����������p�X�@����0�p�@�t�������@���x��dH(`��H�$<�\0h�P�8�����4���D��|�������X����(������,������������p��� �X�\����� �hxDDtp�t�@hH0`0@���������t�����0�x��<�l������h�������t�����d`��h�P�����<��0XX�dl\�0�8XLp���d�����|���`�$���x�@�8�T�D��������\�8���T����`��$���DX�t\��4� �T�������\��X���� �<�H�����,����������,�@���8�����H����������($����`����<��pXL\p��L�\���������������(�������x�d���8���������`�`�p�X�������h\��$�t���@HL����d����h�(�������L�������<������t��������\�����Lh<��������(Tx� ���D����T \����L$����H��������<�H�L�h�������T������,�T�p�����@���tX\d`H@d�,����p��������������|�4���$�,�0�H�|�������������������������$d������`4 (Hdppx��p@��������������������������������t�p���������������������$0D\txhL80,$,<D4 ������������������������������������������������0@D@840,����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$$,,,(    ((��������������������������������������������������������$,@TdhT@0($$,,��������������������������������������������������@``L408@H@Pp�����p`H������  ������X�0�0�D�T�X�`���������������������������4�������|L,@|�������x����������������������h���������������t�����������������������,��� Txd�|x�����0�8����x�@�����L�������X�4� �����P� �@����\�����<���P4h���P���\ �x �� t��` �����|�$�,�l���������$�p�p����x������$�T����8��H$,0���H������(p�(�@�t���t�d�������t����������������T������t�0�0�T�d�<��D�����$TxH���<����0�$(p������p�8�h�������8���D� ��������������4�l�����p�|������X ��,������XPD����(�4��T�������`�����0�P�$��\���H�t��� ���`�$������\�8��\�lt4H�0p��T�`x�\�����p������p�p����X���(�h�t�������4���$�`�0�x����������8��DHh(`�H�(D��������p�������P�x����8������L�X�,�������H�������T�X�����p���x�$��DT�,�����4��ht,,��@�����`������� ��������D�������X�D�,�����x�����<�,x����pd,�<�\��Hp�������8�@����0��@�������D�|�������������L�������p�����x�lT�T��`@��d��l,��������,����������P�P���D���$�D���H�x���������P�|���|�����$��d��,����D0|<������d���0�P�t�|�������0����<��� ������������T���p|T���������X���	�	���xp��TtX�T|�H�����T�������������d�����|����d���D�<�����D����4��P�X�$��
P
�x��\�������������d�����������h� �H���$����� ���,�\�����������<(`��p�@�����P�p��d�<�X�������(�����<�P���L�����d�t�$�������������L�D0��T�|���td��
h
�0
���x��@��<��H���������H���D�������p��8�����$��\�P�����$���DH�LHt4�8�|
�
��\	�(�H���|���������������������������������0�t�`������������H\(	��$��,`��L
�\�
�
\	 �����H�D� ��d��,�����������H������4��H������������������<
|
��
8
8
� @�	X	�	�
�(
��������l�����H�����������@���(���@�X�����4� �����T�(��p	�,��,
�	(���l�l�0�|h���$���������8�,�x�������L��������������l�,�d	L
�,�<hd�
�D�
X�	$`���x�Tx��|�h���(���`� ����t�d�x������T�����x�����d�L�$P�
h
��
��
|
�p0�
@
�
���
l �(��8�@����������X� ���D�p������d�h����H�\�����������4������<��
4d�,��	��$��	�t����������0���$��(���,�@������,�����<�H�`����@�	�
T���� 	�	(`4����8
�(�����||P����d�T����������T�X������������T��d����\���	@�<

�
��	���
\�X�����
|��,���H������h�����H�D�x�$��<���4���������$���x�����T�����8
�x���Pl
���	$��@0H�
t��H�$���\������l�p�����P�������l�@��$���@�Xp$@�����	��
�0��t�l
�(�$��������������,�������������������<�`��4�H��������<
(`h�	�	|�	T�	����(�P
�p�x�D������X�l�\���L���L��������P�,�������P���x����� ������$��PD@X0��D�X��x4������`������h�4�0�P�`�4�������� �8��@���$����H������XT
��,,��(�,L
�
@�@�`��	�� �d���0���@�������������T���d��,�h�|������	�

�����TLt, ����8�(p���$�p�d�P������X���`�������|����0�P�p�������������hp��0��|H	(�d<�lX8�8
�����p���l���,�<���h���$�x������x���X����d���t��������$����	������4��,4t,D��(T�$������������0��8���d�`������<�����T�h������H
 	�����
t
�DL��" !<<($� 
�\(

�
\,�����T�T�����8�T�H������p���x�d�0�����\���X���
�p@��	�<� $tp�X� �0������������h����d���h�@���x�������4�����T�����T��������pt�d��,8��
��h�P, �
����<������0�P�T�����������T�(ߜ������������h|PH���|���	����H!$� ��
�����p
t4 ��t� ����|�(���(������(�h����������X�|���D(
���t
�<	H
��
$�d#`%�!�|�0
���d�$ D�p�������t���,��݀�p�d�|�8�����������h�������x��4�4<��X���H�T8
�d����D���L�L��0���l�h����|�lް�4�����h��������,���� �$���d(���( L%`&� �H����� XD8�����`���������������p���4��H�t�<��d���d���T�
4�(���`
0<���"x*8+%dh L�
�������	���\�p�����D����|�`�0�|�T���h���������P�P�t�|8� t|D4

H@�"�"��|���	����������d�X���`���P����d�������������(���`��d��0����p���
t4t��d�$P
D
`H\,�8����`�������������(�4�p��L��8������(�\�������,��������	\D����#|#h�p��x�	
�t`�
L ������l��t���H�|�4���`������L������$�����l��X�
�	�	�h�
�lX$�#��$L����$��$�������,���$���Tܨ��H�<������P�\��,���P��(�������T�|@����8
h���`t�LDT�������������h�������H���,����$��\�L���������T\��������	� @t�!&�$xL
�X�T�
Ld�X4���8���������|���D���,���p����ܨ�d��<���$�H���8P�	�
���,�#)@'� �dH�X�dL�0
,t���������`ܔ��d��\�\��h���l�4����t�,�8����	�����x��<
p
��0!��`�4����<�������x���������8��\�t�`ް��\� �0���4�������������d���(�d(� �"��L�	��4|L�L�p$X�t�p����L�l�@���x���0�H�L���� �T�H�����|����|L
h����4 H���(%)�%@< ��
�pD��
0$���x�,�T�߀ۤ�P����,�����D��X�����|��d�$��
��HDhl��|��&|(�$0(xL
�t��D�������������T��@��ڼ�d������\��T�������P��,����@
�(�` �\���
���`$dt��@������D���� ����P���0���p�p�@�l������X�p�|�(��\�`����D4��XD%�&�!P ��
��T
�
�����L�`���H�P����ޜ��<�|���X�(�<�(�(ݬ�L��x������L	h���\d��,� �'�(`#��$d�@���,(
�
(�|��������� ݰ۠�t���$�����8���<��������8����p�
�$���
D
l x 0���|�	x�P����������,����������4���(�����|��<�D���t������X�8�l�|$
(�����$
�D���p������D���p�����p�L���t�h�����d�x���L�ߨ��������<4	T
�x��XD�����!x#(�|\\���T�t
0
d���,���,��l�P�`��D�����(���������� �T������ l�X�l� 
�
��	l$�Xx��������D���x���������H��������d�h�X��� �������H�����<��������x84T��t�4DD`�4�x�����`���H�T�������0����������������,�������<������<`��� �$�#�4XT��	<``�
$|���������D�l�T��|����D���������T�h�\������@���
\��0���P�  <@D(
<`�P�L���������$�(������8����p��$����������D�8�8�����@(�����`�
�,	������
L��|�����`�������������t�t�����`�t��(������������������������x�h$x ���L
�$	�p
�X�
�,��
h<�t� ���8��P����p��D���l�H��\�h�������l�`�,��(	��	D,\`��
00�p H�t�0
����`h�	P�4���l�l����h�D���������4�@�|�����X�����������<�
���
`x	H�T�8th�d�
Dt���������0��4�(�d�������D�d�0�����l�@�T�0�h�@���d����H�T�ltPh���@ �	<p	�
�<|,p�h�	H(���X�����T��L�D���T��x�����0�L�\�������0��Xl�������	
p,�T���X(	�	�	8�����P�����������@�h�����4�P�`����<�,�X����x���(|
�� �	\
�	4
�
����@<�$����p48�,�l���4��������x����x�4�����T�����0������P�(�\�d�����Pt`
l�������������\�p���,�����D�p��������l�l��������d�P���|��������	$
�0�d$P�	 	�
�

 
TH�������|���@��l������,���@��L�����@���t�<������dd����4��
 
��,��d
L	��4x��P�������������\�(�H��l���l���|�������`���������L�(@
���	�	��,�	p��,�T�
�
$P�������������������(�����<��`�����|�H�����������������p�x���8����
t�p
@	�80�	�
p
\
�H

�	4������������p�p���d�p�����p������L�h�����P�$�H�hPH�(�L�d�(|p�	$|��L
Lhh����(	 	Lpt�����(�������X�d�������h��������8����D�����h	<	��0 ��0�	�
�X(��
�	@4��������,�X���\� ����������������������0��������\��@�hl0h�
�
$$T	X4�(
D�
h
�
��
l`����l�������|��l�`���(���X�����d� �`���������������������l�T�|h	�
��0l��TH����P	���������������������p���8��d���(������X�����d0��$x�$`	8�
,�0L�l�� �d��|�\������T���$���p���$�P�`�X�����������t�� �����P�`�H�@h�0T�T	@
�	�`<$h�������P�,�t�<��$�����x�������� ���X�X�T�|�����@��H�|���\���(���8P,	��dd�X$����`�4�������p����������������������`�t�H���0���0��������h���h$L��
t	����(�x��D�\����4���������P����������������d������H������(d<�p��x��������<�(���x�8�(���4���4���D�h���0����������l�����������|�����L�����tD���$�X��,��PhH��@������H��� �<�8��������d�p��0������������������t�`������xp�8|�`�D�8���,l����L���4���\��L�@�X�������(�������L�����������L��X�TLtT� ����p��H,����t� ��T�L���������P���D�����$� �D�������\�P����0�\���<x��dh|,p��08������$p�T��D�T����4�����\�<���������|�����t�����������,�����X���D������Dh����8�T(H���8�t�����L�,�����\������p������������0���4���lX�\���T,���t� �@lp����$�p�|��������$�H�X�����(���8�����������@����x$@�h8HL���H���@�T���4�<������������������|�P�x�������P���������D�����������P(������t��t�<x|hx��\��4����������x�����8�������x�@����� ���������,XT������\��H�����|p`8 @���p����D���������(�`�h�h�t�����T���������<�x�����8����hT\h`Xp�D@���h����������t������������H�����������x�|�����������,|������xH$,X�������`������������������������p�h�`�T�H�P�x�������������������������<Xdt���pH((,44,8P``@������������������������������������������������ ,$ (8LXL<,$ ����������������������������������������������������  �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ,04@LL@, 04(������������������������������������������������$<D4$(0Hh���hPD<$���� (����������X�L�\�p�|�����������������������������X���xxthL48X�������x4������������������������X�(�������0�|�����������������������4����0,��|l���������@������d�4���H�������t�D�,������x�x���0�������Hpl,������H���(����0����X0D����8������$���8�0�x����������8�H����L�P�����(�P��� ���p���|�(�DT���(���������<4������ �������������@���x���d��������������d������������8,����D�4�,�������������t���(�������0���������d���������8(��D�<����l�X�L0x���4T0D�P8th��0���P����<���������0�����d���,�d�P�\������8P���\th���DX�0����������H,�(��������<�����4��������T���l���0�h���X�������`�T4����`l������H��`����0�����(4T���d�����|�8��x���l�������,�0�\�<���,�d���8�l�(�$��8h|�����D�|�4���������H�\�t��� �$���X�$�l�`���\�������t������h������p���d �(���DpL(l$��H�������T����<�0�d�4�P���d����T���p�������D����H�HX�,��t���@�H@x�h\����`�Lx��t�����<�����\���D�\�P��������p�,�4�4���(�������ht��0��`�l�8DH��`x0��������t�����l�����x�����L���l�x�@���0������� �p��\�����8��@�4	�	\��P�����t������������������P�(�0����� �l������� ���������$pT�H��X,�(��
H�	�T�4�<���� ���L��\�t� ���h��������`���D�D�L�����H�X�����8������h���T���D�	
$	|lP�h�@����$������ �����������h�X����������l�0�T�,����|�d���|��  ���<
�
<	|4��4t������,�(�@�0�P�h���������x������<�p�`��,����D�d�X0|8��D����,	�@4P	T�tXT����$@�<������4��������h�\���D����P�p���x�������|������l$d���L�
@
�
`�
�	���� �����������������d������x�D���`���l�h�p�l������� �P���d�	�
�
4d
D���P	d
(
�	�
�\�0�������|��$�D�@���$���\���0�$��\������������H���� �x������
,