rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������h����,dh<��������LD�T��8���@�����L���d�8�H�,�$�X����|�p��`���$����0������� ����� �$�$�X��8<����D�������<��������D���T��d����x�`���P���(�����	 
�L	�Hd<	�$H �"� ��(��
@<|x0	�h
�
`\�������(�<�T���H��0�h�������ߨ�P���H��(���Hd0<X������!\%�$T!�4t��d�`�l�8����H�����X�x�������������(����$�����������<����������#l%�&�&�#@��l��(�lh�	�d����������8����h�h���0���D����ِ����$�������0	t����� ��
<8� �'*D&�<��
���L	��$4�|,�����L��(�����d�(���p���ݬߜ��4�x�� 	��l�P�T
P��d"�%�#�8�(|`���<�t���X�D����� ���0�|��T��h������������$�p�x����p�|�0�0@
���P�d���
H
8
$�����<�	��H�p������0�d�,���(�8������,�T�����\�T�0�H���� ����� �HL
H��#<)�)�"l�
�	�
X�l
����\�P���p���H�t�������t���������p�\�L��� ������DP��h���
��8"�*h,D'�� ����4��H�
(����L���h�p�H׈��ߐ�,���P���������l��<�������P�P���,
��\!�#|!�D �	�@�d�8�����x�����|�|���P��ߴ���(�Pڼ���x���4��`�����l������P�!�%�%`�`	T<4xt�p$�������X�����T���8�|�t���d������,�<ߐ� �t������������(\T��#|*8+%��P��	�����0�4����4��p�dٰ�@����$�t����\����l�����������`�`���p	 p|$`%�!�h@�������(�H����������������P�D�0��ޜ��t�\�����d��� �p���x���T�P���X�� ��PL�th�T�X������d�@���x���t�X�x��������݀�pڄ�|�l�d�0�\`���p������h��\$�)�(X!x04
�	,�
� l$@�l�4�H�����������X�����P���p�|ހ�L�T���(������T
��
$�$D|h �&&� ���<<\�D�����L��<�8�������<����x�����H�@��@�L������4�D�H�H�����`\�\D��h����d<8�������������h�h���$�L�D�@�p��� ���`�p��4��0���������������	�D�@!$�!���
�
��
����pdp
LX���<� ���0����4���$����������D�p��������d��$
���$8H��\"&D#���
�
��L�@�	D
\l������<�H�\�(�x߀����$�T�����H�����D�d����,��	��(
�
X(
x
�	�
�4!`��H������`���@�x�(�(���p�����������,�4�@��X�����4������|�����X�
���������
��L��4|�lT���������X�|�X��������������P�<����|�`���P�p��LD����D�	�
�0,� �x�,�8|��
x�
d�<�<���,����T�P�4����4�p�d�����<��������������
0��
 �	
H���,�d�	X������L��������|�L�������H�������L������P���L�$�$�H��h
��|�|���	��0�D����	p��P����,�(��t�(������L�4������(������(���L�d�����T���p���(�Tx�L��	�	�	���<����P������(�t�d���h�x��X������ ����������T�p����h
TP �T�T	�
h�|D�Hl�$T�|����$�48�@�|�P�D���L������h�����8���l��`������p���� �
�
��	�p�	|�8T ����H�X���� �������$�����<�����@����$���0���h���������8�L�`���
�\�@h�$�l$
�
l
�
l
,,��(����������|�d���x���4�d�,�H��������t�h�,���L40H��PX��	4���x�`
h	D��x�	�
�| ��H���h������l����(���h��X�`��@���������P��L
�
��� Lp|��0�����	h��������X����������������� ���T��l������4�����(��������(��0����l@DL�d8	8���X�p���p���4�\�p��H�����$�h�����8�����|�0�����������X�����h
\�
\,
D$L�Xh�
��<�8���������l��l���������X���������d�p����|pp|��T
�
�0$�T4
����T���8d���,���,���H����������(�����X�����h�h���X�l��t�|	L�
(	H|�����$	��
t��d
������l�h�h���8�4�������������,������L�`����X�,�<�$� ����$�t	�	�
dx
��	H�<���X�	�
(	`�����������T�<���\�����������L����D�����h���L<\\������`\����� ��D�����x��������D�<�����\�����\�$���h�d���x���4���� ��D<@���l��X�X
d	�\\||�����H��� ���L�|�������8�`�������$���X�����0����� �,�l��������(��(	�	�@�@���8H\ 	\��@�����X��������������x��������8�l�L�l�t�P�����������������(4D

�4��L���H4$X8�\� �l����,�4�@���`����,�X���������������P���P�������T���@�8	
$	l4$0������T��P�������D���4�d� �|�P��� �����P�����4�l�����x���,���,�4���l4$`L�����@�\�h����0�D�,������ �x�<���X�P�t�����l������������������D��X���L�D @�0��������������T�T�L�x���(���D�$���8�(������\`<H\(��40�44���xH�\��l������X��� �X������ ��������8�L�l������������(�(������,`h��(��t�,���4���������|�X����������8�0�������������l���L��8�����|����� �������$@H�@4(d�pT�8�l�8����d�p����<�������l�H����T�����$�P�����`��d�T���t0�������d��(LT���������@�P������������(������d���0����(����x�h�� \hh�d8��(�D��$����d��8������(�T�t�����D���������� �0���\�$�D�����������t������t��D,����<��@�T�����d�P�|�����t���(�������������d������������������t����4l|����l�������4\0���h�T�,�������P�������P�������X�$�P���P�����\���4����\���8���H���\ ����h��`$������0���������,�D�L�d�������`�����8�d�|�����D����ttp\<,L��������`����������������������P������� �<�t����������������������� l��������`DLdx|x����D��������x�t�������������������l�T�L�d�����������$$������ (4Lh��t`PLH@0((4@@0������������������������������������������������(440($ ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ (,$$$���������������������������������������������������������� (8T`\L8,,( $0(��������������������������������������������������@XXD408@<8Dd����|l`L$������������t�P�L�\�l�t�����������������������������,t�����xdD08d��������<������������������������T�0����������h�����������������������,���4XP�����������,����l�<������4�x���t�D���������`�x���8�������(h�xDD���$|��D��P��$���t,����P���������X�x������T�D�����H�`������l��X��`80 ����|H@��x�X��8�t�������������\�����������������T��������l�p�������X�x���$<h�d�<��T����@�,$H�������H��@���H�x�(��������d�����������L�������X������,����L���(���X��@�H<`��h����0�������0�L�����(���D���0���X��|��������t���8t��`\0p`��0p�����X���,����P�T��$����P�p�������`���l���<�,�t����������� ���,�|4<�(�����h�������������������\������h�\�4������������x�x�����@�|�,���L��t��t���td����\d����4�t�h�l�(���������P�������������l�<�������8������4$�����T�������(0���(0���������<�����������,�����8�����p�4��������,�D�0|�d��t��� \��hPdT����,��d�4���������`�������L�`�������X������,�L���\����d��`���,(��<�\X�hP<�@������0�������\��`���p�������@���`��������p�8��\�0�8����� ��	�	�@���p�X��p�P����P�H�������L���|�<���@�����d���D���0���$� �����<�`D04�L	�
�
$	��\�T����T���L0��������������������d�h�����������`��������@��L0@��t���D��	�4�d�,��,�D������������d�����L��������l�����D������8�����������������hh8
�`��L�H��H�,8`��(�L���p���H���`�`�|��������������\����D���PLl<hl�8D8�t
�4��|������p��������4����������$�$�0�����`�0����@�����|����@�P�L0$��
�<
p	P	DT$�������x�������p�,�����|�����x�H�`�d�d�P��������,���$�X�8��4��
�
4|�
�<
���	�h�X
|P
��h������P�����<���8�t���,�����|�,���4�L�����h���t���|���	���h

tH ���X�D8��@��������� ��$�`����������,�����������L�h���	p4<,�\�(�
@pX 
�<
`������h��D�H�,���P�����P������|�h�p���@�x�����`�������8`�4�t�

@
���0|d
��
4��$��X����� ��������������x����H�4����������0���@�l�8����d��<
����h4L
�D��8�����
�`�$�P���(�H�����������t����$� ��������x�H�����LdT@�|�t	�
@H��Td�`
HT	<\�����(��0h� �x�t�L����L�<�,�p����|�X� ���l�T�4�L���0���\��
��Tt
�	p4x�\�t`�������L�������������t�����4��p�H�T�4����p�������p�8���D���`(
`��Ph���,
��
d
���
D|l� �\�����(���X��h��������\�,��0���������t����(,�4����t`
���(�t�T�
D<	`��
�
H
,	���� �0�|�<������������������`������ ����T�� 
�
l
(�
8	��	��xp�t�,������8�ph�����`��4�L�����������l��������h����<� �������4��P
`�`����dP\�
0L@0�tP�
d����������p�@�l�������D� ����H�������(��`���X����p�x�`��T�P�|�p��H4
�
�
�	��
� �,���<�H�H�8���\�4�d���������p�8�`�`�`��p��p|��
�����	�� �H��@�
�����H�H@<�����`���h����,���X������l�4�@�T�T���p�����,�dl,�������
hX
�h��48X������d� ��������,�T���p�`� ���<�$���<������D�x���d���l���	�40� ��@��
P���
���H�\�l����X�������p�D�(��X���� �4������<���H�X���
�
���"�'�%<�@���l�X0�	�t�D������<���0ߠ���������l�d�l��������l�������	�<�����$	�,�x������\�h�P�����p�t�����<� �4���L��$�`��@���������� �(�(�����(���0
�H��|�$d�	��0��@@�����H�0��������D������h�����x���������$������(��Xh��<�@��<	�
(�|�!p$� $��
L�X�\
`�L@�����p���X���P�$�@������������`����X���( �l����	D�����%(( $xDL��
��4x�x��������l���P��߼�d��������h�\�t����������PP��h���h
���@|P�4l4���P���D����l���4�����8�0�T�,ތ���,������������� ���D���pxdT, �$�%� ���
� �4h�L�
�P���`�h��� ��4� ����p��4�����t�X��H�h� �l���T<�����<
0l��!H(�(�"(��TX
8,|<
Dx	�(����������dݐ�t�|�(��X�����������X�,�d���
T��<($t�
�	�<�X$�����������������P������,����� �h������������\��d������	p8��L��
�	<����$04�
H����x�t�,�D��l�l�,�`�p�x�������T�\�D�X����<�H$
��4 
�t�`�#)�(X"|@x�
X	�D$��
h4���8�t���8�T�x��D�P���t��������������(�T�
|l �`����� <%H$\l��P�	pD�t�t���d�����������ܔ�P߄����H�����x�h�<��������p���h(l ��8�l�
�8\T�8�x������`�����|����������\����D߰�|�ݤ�������p�����(P��������X�`,�!�%D$���@@d�x8`D���P�H�L�|�|�x����������|� ��T�p��ݼ߀��X�L�t��@
$��4`�
l�
���"(�&� ��T$LL<��h
 	�l�����l���d��ڰ�����|�h���T�������p���l����� ��
�h�x|��h
�h��� , ,������X���<�d����4�������l���޸��p�`���X�(�@�|�������d�`�����,	����!px�
t���$t�p���������������������������$�h��������P��P�H���P��h	�H��%*�'�X|����T�8`0 ���0�P�ޘ���D�`����T���<��������������$�T�,lXpL
�
L��%\)'L"X(��P���l����8����\�(�����h��ؔ�����|݈�H��d�������������D�T�,�
������48��	t
�(x�4��Xh�t� ���H�8�����d���������$��������X�8�X����������T�d�����X8��#$&�!4�HL
�
d
D
��0�	��|�����$�d��l�$�,��`�<����X�����������T��<	D��
��4@��tp�'�($� ���
 $�$�4P	�	8�����h�����ݔ���p������|�T��������8�p�l�h���T����l���(����
�� � x@h�x�
��|��<�����8��������`�������ݨ�(ܼܐ����������������x�X�����4|��\�x$ ���L�
��h,�|,���H�����D�����������p�`��P�X�P����8�\�����h��������	(8L� � ��t��`PX�
@�
��,����������8�����������l������0�H�\��H��4�l8
�
���
l
���<���
� ������������ ���\�0�T���0���$������p��h�x�8�������P�8�H���,��lPT
�
�������X�l���P������p���������� ���������0�������P��t�������h$�4�� ����
�
�	8	X|��d�`����4����������<�P����t���������x�$���p`P\(
P|8(	�	|
�
P�l �xp��84������L�T�`�8�<���h��h�l����l��,�,�����l�����|�����������������<�
|,	$x�ph40T�������t�(�����L�,�h���@�4�T�0����0�����H�����X����,�l����h�$T����d�\
��
������4�,���p����������������x�l����$������H��0	��	<����	�
�<�\ |����,�H����	`�$4����@�\����������������T�@�h���������T�
 ��$�$�
d�
�D���`lX�
�����������@�����������,�D��|�������p���������p������x����<X�8|��
tD�
X�t�@�	<�X��������`���H�@����������<������T�L���l8P�������h�\4���<
�	4	��`hX��	0����p�������@������@�����������X�p�����t����p�4
��d�	D
�	�
 ��pX���
�(T�`�L������\�`������� �������l��H����t�,���`�������0����
4�h�0H��8	��$�X\�P�tp��<�,�(�|����<�������\�����x����h��p� ���0�����8���������0
�
����,\
��	`0�	�	�x(����|���\�����t��x����<���d�l� �����x��� ���x�L���l\�����	$�
 ������
�	�`�����$������@�t�$�X�����\���d����8���������P���D�	`
�@��\	�4dd	�
@@x0

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

`��� �	xhl������4�<�����x������$�����L���8����t�����l�`�p�T�Ll�����H�P	x
|�
x
�
pT�x�pH�	����,�����$���0�����\�(�����4�D�����|�����<���\h��$��D�d	t �
l(	��l�������P���(����`��� ���(���������l�D�\�����p���P�h������ �X�4���	p
�	��l������@�������,���p�\�����������\�0�����@�d�������(�\��,�0�(�����p0`�8t|	����d4�||���P�p���|�p���������d�����l�D�,�������D������X��hD������t  ��0	�	4	0HH�t\4 ���`���<���d� ����������������l���P�������������H\�@(��$� LP|��p,����P������H� �t���4���|���T�t�������p���������t����������T�P�p$4\�$�D�\� ����$( ��P�����p�����<�l�l�d�,���T���h������������������<�d<����x<����0`�`���D���X��(������������x�@���������������@����`��� �P�0���$��<�h���8��0�X$ ������|�0(���l�<����� �����<���,�,�x�D�@���|���(�D���8�T�`��`T�\4x��4,��L4p���������T������<�����X�D�H������@�������������0X��@���t���d���<\�������dl����������P�������p�8���x�����p�|�@���(�8��8�8���$�(��H��P���,��( hh�H�����0��`��L�����<������������(�p������T�����L���T�����LT�lH`l8��@��P���4p��� �d���|�P�X���������(�������������<�����������D�<�H�@�,�0���4��������p�HXLTl`X��,����������t�����P�����x�d�<�� ��������0PL������H��L�����xldL8P����L������@���������4�l�t�p�|�����`�������T�������D����hXl�|p��$\P���t$������������������p����������(�P�������������������������@��������X8<`�������T��������������������������h�d�`�X�X�l�����������������������,Pdpx��tT4 $,004@PTD$������������������������������������������������ �� 0@TXP@80(  ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ $$  $(,( ��������������������������������������������������(08HTXL4 ,8@0��������������������������������������������������(0(,04Lh���t`P@0080������d�T�\�l�|�����������������|�����������Lx�|ppphT@Hh�������|@������������������������L�������4�t�����������������������8������TD`�������L������t�D���P�������h�8�$������������X�������,TX$����d���d��d�����lH\����<������(���,�(�t����������H�\� ���h�p���$�T�t���4� $�������l�PL���@�����4hP����������0�����������@���d���X�������4�H�,�<����\��������|�����XH����T�<�4��������������� �����l����������D���������$��,�8����`��hpH��4(@,��(�4l���\����,�����\��\�H� �,�L�$�t����������(���P�Xh�@���$,0���XP��d�����������<�������������(�D���p���X�t��<���,�X������8���8Th|xl�|���4�����(�(�������\�l���l�L���������������h�p���P�����$��x��P���8�P���|8��x���0�,��������L���X��������P�8�d��������t�������������T4�X�d�|�x���t�����H���H�$�t��� �������������T���x�H���d��L�\��������t�TL�4���|l � �����l��|�<�0��8�`���l���|�������0�4� ���X�X������������������p��\�lll�\����4h$||D@�x�P�������p����� �,���,���������0���8�����d�4���T�(�<|��\�	
�lPP88�H���,�T����x�����`���d�������T�L�4�D�t���4��������������H<�\(p0`����
�	�@��0 ��0� �8X�����4����8�@�������d�P�0�L�\���������p�������,�� �lL <�(
@
L	p0��������������� ���������l�(�|�����8�T�������������X���x�h��������� 4��	�
�
�	���tP��������d�4���� �����8���������������������������������@��``���	<x�	,h���d�,���\l�$�����$�L��� �@�l����������t���t�������������lLl� 0LH���

T
T`t
<Xp�(�4���`�\���������D�0��h�0�8���������������������\�����P<
�
��4
`h8X�	�
4
�	�
��Lt����D�����\������P�����8����0�x�����L�<�����`����P�����TL	�
h<�P$�	L��x0�<�
8
 $��X�����t�����,�l�����H�������|��@������,���t	�	T��(�T@
(���
0�l	�H���<�(<��������X���H�����������T��������L����<�@����@���d(t$LT��8DXx\L�$�4� �|�x�4������$���t�\��(H��0�x��������0�������8�������������������������\���������|0�d`��`8����<4�T����������������40��������\�0�<�T�����������������x�L�4�0�<�T�����(4$������|�p�����(��������t�\�h�T�X�p���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������       ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������XpP�������pH��XtX4$���l�X��� ���x�����L�����������H���H�l�������D�@��t��x� � ��l��@���\������\<`��X������l��������(�,�t�|��������l�����L���P�\
��L	���
 
�� H�$t'p&�"�,�� ��x
D
��<��4���\�����0�����p���h�T��L���$���X�`�d���T������L��t��H���d$�$�!\�<,�X�����t�x�L���$���p��߀�ߘ�l�|����X�����$��������h��|@ `!�!t �xd,,��H�\�X
P�h�����<������|������P���l�����������0����,p@@������(�
\�  �#�"h���t	`D@h
�d�<l�$�H�� �� �8�P���x��d�����d��|�4����\�lL��,�l�
<�	(<!%�%P$"�L�����������0�\�������L�������0�H��4����`� ��4���������,�p$�0(�\����� � t @!���@���������L��<�t�@�d�����߸��ܬۈ�0���(���X�����d���<4�����P
PT�x�!$� L�
,�����@�
$������|�`�X��|����@�l����0��Dݘ�,������ ���4�d
�����
�D8� 4%�%�!�XP08`H�	��$���� ������������@�X����D����� ����0������l�LpX��X,����8|\� XTH�h�`�������l���t������ ���T�p�����<���0�,�������8�p��(��t�\�$t
��dt��
��� �|����������T���H�\�H��������H����ހ�H��(���@d�
d�	�l�
���!�&�%�P��(�|L���,	���T�����T���D�L��l������L���h�����<����������|����$`��$\#�"�4���	�`����lH`�X���|�x���D�x����������8��������@����l� �h�@D�x�����	�
��t��P���\��h��X�|�`����,����P�@�l��ߌ�����4�����h�,������@�T�4��	��x�8 �$|#�l
�
����
�L�\$�|�$����d��������0�������|������8�4��8�H�$�� @�	��D|����`%@$�8l�������
�0��(���p��������D���� ��d������������`��t�<�
�
8���
�$�<�D���@�L�����������l�X�x����0�D�L������@���4� ���������������	 H�pp�d|�4	H
0
4`D
�
�
�0
p��D�����l�P�4�$���d�X�l�h��d���h���(�h��p�L�X�Lp�	�|���,�,��pl�����0t��L�d
�����(�t�������L�d��������d�0�������|�(�������
p0
(�	��

��$0TX����
�� ����x�\���0�����\�����$�P����D��H������������\�������0�	`�`Lp�|P
H�
�\Pd��XH
t�l���p�����4���<�x�����L�x�p�P���H�\�������������$�@��@���T�P�@P�d�����@
8LL<	(	�4�d� ������@�\�����`�t���P�����x�,�����d�����8X�x��@
 ���������������P�L��T��������L���������p���X�4�������l��L�T������`	<�L0����TXHthp��T	,T�������L�����������t�l���p� �������������x�L�@���H��x�|�
�(H�l,��	L����((P�D���D�������`����d�����,�8�@��8��\�d��h���$	�$��<
��
P��(�xx
���Dx,0
�	xh����������x�,�D���\��l������h������������	h���
�
|P�	�8
�`���Xt���������������<������8������������8��������<�H�0����� �<dH �<dP8��
$����$��0��8��|��������l�(��$�����<���������L���P�Dp|��������<	��
|���
�	���l�H�

@�l�|�x�D������<���t��������<���������t������`�l��<���p��	�
l�0TH
xt��8���P�� ���H���4����`���l��<�p������,������x������� 
hL,
p
�L�(\	
���
�
|�
�	�t����� �D���t�$���L��������t���P���� �4���0�������,����������h�
� 
<| 
����Dp���	����T�����8���(�����L���@���H��d���h���t�l����H�$tDt,T8@P�t	����
l
��x��@�@D���x�����H�,���p������� � �������(�l�������p��`	�
�	d<�������D
���
@���,�������,�\��������������`���<�`���� �����<����D�@�,�����0 
`
�
���L	th��	
�	
d@�
�t�� ���|���P���D�\�T��@���L�<�(�l���L��T�������DT��� ���$

|t
�
 ��L@��DPh���4�����4�<�h��������h�������<���\�������\����(P�h|���Lx	lp
DL
	p|�t���h��0�����x��\�T�H��������h���d�<��p��(�8����� �(0X��h��8����L�4D�(<��� ���������T�����`��0�d���������4�p���T���4�����0�����������	�
(�	L�l��$0�(�X�������X�������,����������\���H���D����������h�X���t�(�t�, 
�
P	L���0$p�<�p�����@�H���|���4�X�����8���X�����l�8�$����H��P4����� D`��\�l(�l$��H�(������d�|��h�������$�����������,�@�(��������H���$�x�h�������d ,,�dL����,��L,T�X����������|���P����4������������8���X��`�����h�x,`�4,�����d8� ��,�������P�����������l�p��H�`���d���\�l�����T�D���`� ��� �P���d�Pp@H��`�4�������d����� �������P����������T�l���T�x�������������,�p�x�����tHpLX��4T�������0���(� �0�����D��� �l���(�������d��������h�X�\���Hp����4<��4��������h4�@4����@���L�|�����`��X�0������0���4�������T����p��h\����4DL�0�T4�4��X�,��,���P����@�����T�l�������\���P�P���`�(�L�����������l<��PHd`�h�D����,X��|�������p�x������x�4�$����������0���������������L�� ���8��L���,�|�����PtH�<����x�H������H�����p�$���������H�$�T���D�������TpH������T���,��� ���h8<���l0����<��������8�P�T�h�������p�$����T�������h��������p`��(����|$������������������p�0�� �0�4�4�H�x�����������������������P�������\0 4Xt|xx�|\ ��������������������������x�h�d�\�T�P�h�������������������(@LXh��|\<,,,( ,@D8��������������������������������������������������$$<PTL@<80$����������������������������������������������  $$ �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $(((,$  $������������������������������������������������������,@P`dX@0$ (48(������������������������������������������������D\XH888<40Hp������pP��������������������\�8�8�L�\�`�h���������������������������D�������tTDX���������,����������|�|���������p�,������������x���������������������L���(D8��dh�������0����l�8��������h���t�@� ������h�0�D����`�����4����xx����p�, �h$��\������@xl0������L���$������`��������H�L�����\�t����0�h����8��\@HL$���|D,���H��D�X�|�x�L�8�`�����D�����������������\��x���P���L�p�`�H�|�$�4X0�������$H�T������x�<�`���T�`���D�������L����������l������������p4���8� H�H\l0��H�(����p������������T�d� ����(���H���d���������\���(� �����T0�(��\,�\h������0��|���D�p�4�0������������X�@�������d�l���T�x����D��<�P8���D��\0PT�x������������8�H���@��������������L�0����h��������@���d�����T��0p����4��l���$����8�����L�������h�x����p�@��p�,�����x�(��������(X������\`���,�\�$���@p�������������h�� �����h�������$�������$����@�����(�H`������`�\(����d����������4�L�P����\�������4������0�D����p�h����h��x4��444��t�($<��D��T���t�������<��������,���\���������|�������8�������@��\X��p�l�	l	�| ��t��p�P��������T�����l�0���l���8��������� �`���D�,����xL���|���p�	x
$
�d��8����`��P���� ���D�P�P������������P�(�d��`���t�x�������T�t ��( ���8TH�\�`����|���������$���X����������������l�4�����<��������D���������Ld	(l�	�@��\�l4t������|���8���X������������4���4�����8�d�������p���D��Hp�	�DP
�
� �H������P�$����|������t�����������x���������P�������l��		��`�������X

d
�	`����l�4���<�p�0�|�d���������p���D�P������������l�������������h	 �d�
�
,���0�H�	�
����p��������P� ���t��D���d���T�����������$�����PT����,�p4�	�h�\|����|xX�,�P�,������X���4�d���������������`���H���������	h�	<�P�|<��
�h�T
��	4���$�����|�p�����������<����������\���<�,�(�\�P�����������0l�L���$����
�
,�
X
(�pd0������,�����`����H�����D�����4�p�������t�����4��X����L�
�p����
��<		0�	��@
l<0�X���D�8�0���d��l�������������������,���	����$	
�,����	$8����,����d������������������T������8���`���h��
��
DP��L	��H
�x`Hh�P�X�H�t������l���,�������P���`��D�D����<�p��P���L�<���������	�
L0��8���8H�
X�
�
�
HH`���������������������T���x����d��l�x�x���p����(��0��P8
P��Hx����	d���D�X	t�����h���d����@�\�0������������0�d�X�������|�
|�	t	�
`�	��
 ��P�pd�
��T���p�(�������@�D�\�x������T��H����h�l���D�P�����������������
��PD����h�p���@�0���t���@�������t���4�@��H�`���<�P�$��$��t�������
�
�@��4D�x

<�
Hh 
<��
H���(�(�p���P�@����D�<�T�������������p����� ��
���4H���
h�\��$���\|�p��D$�@�<�����(��@����p�������(�����X��L������|����|x�D\���L�
T��txp��`d�x���,��h�������� ���8����������������t�x�D�8���`�0�,�(�L�� ��������h��D����
�t���p�|��h�D������$�4�<�8�\�������$��,������|�	����4����	T,�T#"|�PT�����
�	4���\��4�t����@������8���H��� ��$������X�dp�0���H
��<
��@t���\�������� �0����D�L�0������������,�@�������L���\����P�������X�����<P
$��0�X ��  ������� �����,�|�p�H��8�$�8����x���L���H�<\|XD�� ��d�8x"D%�!,���
�\
$�$
������@�@������T�$��t��d��D���� ������d�@���x4<d	
@\
@
��\#�%�"\��\P
�4���������������<����$�4ޘ������4������X����h������,����<�(���H8��`�`�`T��H���t��$�(�X�����L�x�P�0��P�d�����<��p�\�������\���H���@�����"$X����
��D0x��,t����`���H���x����,�T�h�� ����|�ې�0�����P��h����p,	4��� �&l'$"���� $������|��������0�D�`����D��������� ��H�|��`����@ ����dpl\|��  !@��8�
�����L�`�$�������l�������<�(��4�X�$�����\���$���� ���X�h�D�d$����`�<d���$�@�x�x������l��T��|���x����|�x�p�0������0������,���,xtH��h#x#�T�����
�	,��x|����������������T��������l���P��|�@�����p�dL�\|x8 �%�$�LT�0�l����0����� ������������d�h����������������������,���t||0���p(
�
,$��d�(���h���h�,�L������4�,����ߠ�ژ�`������0���P�$��D�X�40�$���%�)8(d �D �@8��4�h
���|�|����p������x��������l��ެ��`�`�������T(h�P���X
����!H(h'� � d��	�\�`��
$0����,�����ڰ�p�P�����\�\���H�����������0�p�`P�$
�
�l"� �D<T��������<����������������޴�0�h�ޠ�H����P�����t�(���@�,���P|0DXt�!��d8
�tT0d$���l�|�`������t����������������P�d�8���8����x�
��	$H�������� '+�'tT8�d	�8�
��
�Th���0���X��l�t��������d���������P����H\���,��4��l t$�'D%� ���\���$���t����0��������L�Xڌۼ��4���P�L�x��@���X�$���X���L��(XH�p�0
�
@ ��h(��0t�h��L�@�(����l�\�T������L�ټ�@�x���t���`�`��l�\���������� %`'T"���
���	�	�`�D�	H����,�p���T�����<���p��\�t��\���P�T���t�0���������X(��l&(#t  Pl
���|���<X�����H���,����0�����$���X���L�����������(�������(�4,���
�l������X��
�����X�h���t����������������,�t�t� ������������L�0���4�x�,��@
X�( !p���	�(�T
�t��������8���\������������D�$��T�����(�,������	�	T�$T	�
|P|��%�%L �� L�
HX� 
��
�x�������t��\���������t����`�l�0��t��8�����p4�
L0�	T�T, � h(��,�������`�����������@���0�(��$��l����d����������������L����@
�h�8�8�x���
���ll�t8
���������@�T������������h�,��������0���������\��t��� ��L
T����,��
�
�
T	x	|
���d�l�h�������������H��������X�H������P�`@L<��
�
�
���@�h�\�
���T�<���$�����8�h�4�<�������\���<�|�l����������D�(�L�����D����������PH(0��
����,���������H����������h����L�����l�d�������@�������tp�l(�L�L�|�
<8���\�������4�H����(�X���<���P���4�� �������PL	
@���

��,�"�8�L���D��|	�
L�`����0�h���P�����������p���l� ��D�\�H�4���
`HD
���
�
�Dl���<����|�X��������x���$�(�p����p��l�X������<����������D�0��� ��\	�l����(
�x	T
$�P�L���������p���T�\�����D�@���p��d����\�d�������,xp�|h����\t�@
�xt�D�
�
0
�D�dX
�
<������h�@����$�����\��������4�\����<�`�\<�	p���	�	
H
D��d8�
$`���0�T����(�(������ ������\��h������X�8���� �������@8	H���
x���@L
�$��4$������\���|���4���(����\�D������H�l�0�,�X���������$��x����<	`�
(�L��$�	p
$
<��	��
�
�p� �H�������������|����h�<��$����L�������4� �hL��d|	�
L
�` ���	L`dt�h��|������0�����������l�0������������ �l�T����(����XHL��
$|�
���P�(�
�
��	|�����|����P������H��8��@�T�����$��0��� ����8�X��@�������x`T��
P�0�	�p�D	�H	��P	���\���,�����������l�������������D��d��,���H�D<�8�����$�l	@`T��$d��`����X�������l�L�p�d�����4�X�P�����,�@�<��\�l�������XP`
H
���h�$�	xt�t0
�\
�P������|P����@���8�T�x�h��� ��L���`���d�����<���������X������
T
4
�
|
�h<�lt	�
�
��
dl�������������@�`��\����������D� �X���<���h����<���<�D����$ 	�
��
P
�
��H��h@�� x����`�0�������\�4�t�\��T���4���p�`�@�l�����\��8l�H��$��$�@	XL
�
�`�T����������\�X��������0�P�l�d�h�t�,�(�l�d�������������������(��<�P��	h
�	� <�d����@������X�����������$��\��������<�T�������<���@�`�����P�������ht$�HL<�0�X��������t���P���0�$�����������x�������l�����0�\��,���$�(�@����	�$p�h��4�����xH���d�`�\�`������������h�0������t���(��������d��H�tTT0�@xP�,X�L��0�������P�������t�������h�����������<�$�T�4�H�������$�����h�`��8<T�h�h�p�p�x� 0$�����0�������L�������T�������\���������������,�P�����pd���@��t�$���@|�`���(��ht�(�,<���|��������������������@�������4���H�x�0�����X�pd��(X4������t�L��0�����0���D��������������@�������,�8���H�d���$��L���Xp�x���HP�����P����P�����t�$�@���X����x���\���x�(� ���x����������H�X��`���$dHh�|����$��`�0D�\H���L���(�|�T�����p���0��������(�x�L�������8���4����p���8���,`�tP�h����\��� ����P�����0��`�����8��������h���P������p�0�������X �4��l ��D���l�t���������|�����d�������|���������@���|���|�����0�<�$�0���h<������L��0|�hP`|d�4��T�D�4��������P�x�L�����\�\�P� ����p��������������������T�8h������������0 �d����0���������D�p�l�d�l�x�h�,��������P�������0���h<8Pdd`|�PL����L������<<����(����������<�|�����������������������T������|P,(Lx������t0������������������������x�l�d�P�D�P�x�������������������������,DTh���hL888<84DT`X< ���������������������������������������������� ,( $4HXTD8( ������������������������������������������������������(,($  $ ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������   ������������������������������������������������������(08HTXP<,$$$ ,0$��������������������������������������������������(0$(04D\|��lXPL< $, ����������t�h�t���������������������������������P|�|tptp\HHl��������P����������������������X�(������0�p�����������������������,����$$��XHh��������0������t�D���L�������d�4� ������������4���������@<����d��� t��h����lDX���� ������$���L�<�t�����������,�8����h�l����L�����@���������T�HX ���$�����t�������������������H����������4���(�������x�8�$�0�4�0�X����X�������|t�H������<\���������<�0�����4���|��������T� �P�����������@pd����X�<�x\���x��`0P�� <��(���X���<�X���������P�0�D�$�����P�t�0������p�0�l�x��X�� ���<��DpP��h����������p�����L�������(��������D���4��� �4�t�\��0��xp����t���dL0���L�������t�$� ���P�p���X�$�����t�$���4�p��D���(�����L�P���4�`���P�h��d���(p���,�\�LT��H���x����P�X�\�������������(���,�������T�����,����������t�@�XX�����0��d�����l����x�p�8�\� �$�������������������x����<�h|<�����l�4,\�������@�$X��l�h���T��������<�������4���`���h�x������l�X�X�D�\���`(d�4��$����������<�����d����$����@�@�������(���H�L�����P���x���h�P<���p�h���|�	|	T($,���t�������������������(�����$�������<�T�$�@��d�`(���4T(d�4xh
�
p	t\�����8������\�`�����������x�h���L�8�8������������p��������|�D�(���p�T	D	L�X���P�t�l���x�������$��� �����4�<�����\�(�����T�P������������������	 
	�4��$�L�����������\�������8������� �8�����$��������@������D$�P���8�$
t
����p�L t<h��\���D����\���� ����X���0�����X�,���P�l���������X��X�����4x�
h��
�	�h�������$���������������d�0������t�|�4�������`��� �$���D�����`8H
�
�
�
��,
�LL	T

�	P
���� �`���t� �D������P��������p�����d������$���h��pp�p��0�8 	L
,