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���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������       ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������XlP�������pD��XtX4$���h�T��� ���x�����L�����������H���H�l�������D�@��t��x� � ��l��<���`������\<\��P��|���4����d� ����l����������������`���`���`�|�<���0
��
�	�����(L�x��P����������(�8�T��������,��8�8�,�p���p���� �������`��4�	`���������������8`|�����H�\�(�4���������H0\��X�h�����<�8�$�0\p	0�p��	LDp���4x (����X�(���T���8���t�l�d���\�l�d��,�8���$��4H�Xl�\� 	�0 $(��\����X�������\�`�����T�`�����L�|�����������p����,�8�T������`�
��`�lL������"$�!��Lh`����,�����������T�<��0���|���٘�Tި��`�t����`�<�x��������T�
�"�!� � � h ��D\0 0!P0��H$l�(��H�P�������,���0�$����<�0��� �ـ�0���,L\	t�(�`�	0��x"l'4*�'� |������
<84������H���(�D�\ތ�@�������������ڤ�8� �d������	����
D
�@��H$%*P+(P"(l��@
�X��l4�p�T������l�lܠ������8������P�D������������������P��<$h���x�H�\��
��H���\�H���4���� ����� �����`�|����������H�����LP$�0��$`�����p� ��
�� ���t��@�t����������|���H�������4����������d��H�	���h
�,�,�!�%�$x��h
h
�
��4 �	,��h������<��P������(�����������h�X�����������t�\L�,d�\x@�4#D"�|(X	����@�������H�������T������� �H߼�������H�`�L���T����
������T�
(
 �|,�4��Pd�x��0�����x��� ���t���������������������4�t(\��8�x@txP��"P'�&\���(��
�@�`@�$�H�h�`�h��߸�D�����������x����|݄�x��d�H���x,
��`@Xh	�l�"�'�&�  ������P0�
�	���8�x��|�T܀ݰ�d�d��`���|��������t����H����	�D����
�	�\0�@����h�����������P�`�<�0�D�D�L����h�����0�������������D(����d	�����lpp
�	�
0
�	0
���� ���<���P�T�H�$����� �D��t�0���H��8��������
D
�,8��L��4�l�����$�
8�h��P	��h�<���d�������0�$�X�L�����|����X������H�p� $���
	�
P
hd
�����0T����
p�4�X�����T�(���d�����H��(��H����0�����L�������$�t���@���
���xdh��
x�
���4t�8��	x��<�`���L�$�������0������T���������������4<���h����0��x��hX�l
 �
��d�$�@H�����p����p�8�l��l��d������<��t�T��������$�$�X�
��
����P`$���t�����0L��P�����x�L�P�$����T��P���D��h�D����4��4���D��
�`��T0�$$P4$�|���,�������<��L����(���`�`�����������������������4� �$����||����\�|(t
��
t
PT����0��h������`���$�L�x���\�0���h����,��l�\�d���P�h�����(\�
t<�<T���`�
D4	 ���|

�`����\�����@�����h������h�d�<���������������p�	@���
�
���	x�	�
<�,\h������(��������,�����������8�|�(���|��H���\������� �8� �|���� L<$�p���0��l<�h�``�x�H�p�@���������@�����������@�l��l�4���x��L\��t�����(���
|��@<�

��L���
L
|T�������l������@���`���X���t���L����(�H�<�X�$�<x���|�\�t�	�
|8�X��
��T8x����P�H�L0���d���H� ���`���X���@����������p���H�h�����h
L4
X
�<�,l	
���
��
�	������P�t�����L���h���������t���D������x�����\��������������X�
�
(�d
��� �d��
	x�����`���P����l���P�$��L��`���`��`�T���d���DH�8$0<�`	���|
d
���(��d�dd�8��������l�L�8���������$�$������� �`�������H���4��
x	H t�������
4
�|�(
P,(��H�������@�t���������8�x���L�h����$�����8����8�0�������
H
t
���D	h`��	�	�	
`D�
����4�������d��X�l�h�,�X���d�P�<�|����P� �P��������<L�������
�pl
�
��@4��@Pp��$�D����@�H�t��������x�������H���`�������X����$H�\p���@l	dh
<H
�lt�l���d��0��������h�\�P��������p���l�H��x�$�,�<������$0T��`��,x���H�4D�$<������������\�����l��8�l��������<�x���\���<�����0�����������	�
 �	D�d�� 0�$��T�������\�������0���������`���L���H����������h�X���p�$�p�(
�
L	H���,�� l�<�p�����@�L�������8�\�����<���\�����p�<�(����L��P4����� @\��X�h$�l$��H�(������`�|��h�������(�����������,�@�(��������L���(�|�l�������d(,�dL����(��H(P�X��������������P����8������������<���\��d�����h�t0`�0(�����d8� ��(�������P�����������l�p��H�d���d���\�l�����T�D���`� ��� �L���`�Pp@H��`�0�������d����� �������P����������T�p���T�x�������������,�p�|�����xHpLX��4P�������0���(� �0�����D��� �l���(�������d��������h�X�\���Hp����8<��4��������l4�<0����@���L�|�����`��X�0������0���8�������T����p��hX����4HL�0�T4�4��X�,��,���P����@�����T�l�������\���P�P���`�(�L�����������l<��PHd`�h�D����,X��|�������p�t������x�4�$����������4���������������L�� ���8��L���0�|�����PtH�<����x�H������H�����l�$���������H�$�T���D�������TpH������T���(��� ���h8<���l4����<��������8�P�T�h�������p�$����T�������h��������p`��(����|$������������������p�0�� �,�0�0�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��H�X�|�x�L�<�`�����D�����������������\��x���P���L�p�d�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��<�P<���D��\0PT�x������������8�H���<��������������L�0����h��������@���d�����T��0p����0��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�,����xH���|���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��H���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��T���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���@�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�H\���L�
T��txp��`d�x���,��h�������� ���8����������������t�x�D�<���`�0�,�(�L�� ��������h��D����
�t���p�|��h�D������$�4�<�8�\�������$��,������|�	����4����	T,�T#"|�PT�����
�	4���\��4�t����@������4���D��� ��$������X�`p�0���H
��<
��@t���\�������� �0����D�L�0������������,�@�������P���\����P�������X�����<P
$��4�X ��  ������� �����,���p�H��8�(�8���x���P���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�4
�
@ ��h(��0t�h��L�@�,����l�X�T������L�ټ�@�x���t���`�`��l�\���������� %`'T"���
���	�	�`�@�	H����,�p���T�����<���p��\�t��\���P�T���t�0���������X(��l&(#t  Tl
���|���<X�����H���,����0�����$���X���L�����������(�������(�4,���
�l������X��
�����X�h���t����������������,�t�t� ������������L�0���4�x�,��@
X�( !p���	�(�T
�t��������8���\������������D�$��X�����(�,������	�	T�$T	�
|P|��%�%L �� L�
HX� 
��
�x�������t��\���������t����`�l�0��t��8�����p4�
L0�	X�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��x	�
L�`����,�h���T�����������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��`����T��������h�L�p�`�����0�T�P�����,�@�<��\�l�������XP`
H
���h�$�	xt�t0
�\
�T������|P����@���8�X�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�,�(�h�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�������$�����d�`��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�������<���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������<8����(����������<�|�����������������������T������|P,(Lx������t0������������������������x�l�d�P�D�P�x�������������������������,DTh���hL888<84DT`X< ����������������������������������������������$,($4HXTD4( ������������������������������������������������������(,($  $ ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������   ������������������������������������������������������$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�T����T�������|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
�
l	pX�����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
���� �`���p� �D������P��������p�����d������$���h��pp�p��0�8 	L
,