rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������H�`������T8�	\����������t�����8�� �x�T�D������������@�,�D��H�(l�,��xx�
�(0,��	��<Ph����pH\��(�����T�(�����p��������X�l��X�L���(��������������X|��\0��Tx#�$t$#� �p<�
�
d	�l�����l�p�D��P����������T�H�h�������<��h�(���`��t��x,DP����#�&h'�&�$� ��h�H�������D�P������\�� ؐ�0�8ݴ�h�����������(���p����D|\��$\Hh4����t�\D�(�@������T��D����t�`���X���`��0��X�T����<�	t	�D	�x���,�#�&(&�!t��4
�	�����p��������������������,�����`��X�X�\���$��L
��l�<d
P�x���h�T
`�������`���p���������������������,�\���x�(����������x0��$x��l
�
 H��D!< �����T������l����D�|���������t�l֐�4����� ��0��,�@�l����l� !4&�(P'�!���(	T	`(8@�4�
���`���$�`�(�,���H��`�p�0����$���d�����x�(�h���8�@
|	 
��8�!D(�*�($#��P
��������@����������d��h�0����T����4�������\��� ��(� L!(#"���t��
�x!�$&�$PT���`���$������������`�������p�����8�|��������D�<�$�<����DL��!�%�%"Tx�����
�48D���
,���X����H���������p���L���x��������p����,x�����\
��0\#�&�'`%D d���X\
�	D
�
h	p��d� ��<��$ט֘�D�t�D�|�x���h�T��0��l�P���������0���DD��,t���t`�dP8��d�������`�L�L�0���������������P�����������������<�
\l
�p�P�H\h<\p,p����P�4�������P����l���������� �����P�����|����������p�

l��\ ��h�<���
���$�P�������x���$���h�p��������T�8ܔ�|�@�P��H�lx	� 	��T|�\�L��l�h�����\0��$xL���P�����D����4�����������\���D� �(�l�@��LD�	��4
�	��
X$�����	,����� �����L�,�P����������P���4���������h�������������	<��(D! �����@t��L��
�|�x���@�����X������0�H�����������l�d�(
4��\�T(�0�� 0�������4�������\������������h�`�<������t������������|������8���� ����`,T	������d�t�
��� ����4�`�$��T������������d�X�������,���$���D�(�d��\�hX� �0��	�	��,
t�P�0�����d�����0�p���������0�����8������$�T|�
,��T|�0
������<
�8l��$�	X��������$���x�D������`�8���H�����|������4���|������	L�0�\��L @��� ���������D�0�h�,�����������������P������p��d�,�(�p������
�D��X�<����x�
p
�Dt���,�$�����d�l������X��L�<�� ����@���������������0����D�H�H8
0	�\	�
 �
H

�������(�����������������������L��(������p8H��l��4���p��4h
�l�\��<����p���x��	�	��D����P���p���t�T���L�D���L�t�t�,���$�P�H�`���� ������\,8T��l�`������d��������@�8��������8�����������t�$�L����������4������4�8(@
�	l
 ��� �	�\����������x���,�P�������d���h�������|�<����H|``�d4�d8� �$D�0(
\�	l��	D
t	x`�D�L�H��|������������d��@�x�4���������D���H��P���
h
��@��0�
�(@�4�����T�h�L���������p�����4����������� �����(�P�d�X�<�
@��L�$4
$
�
�
�
@�
��
4<��� �P�4���,�������������T������D�X�d�d�@���d�������P X
���
�x�|
|	�lh��� ���\��$���t��������d�,����������H� ��������d ���$��H��$�
H�
$8�
X	t��H l���L��l������t���\�������8��8�p�������������<P�	��8
(	��d�Hx�
h
�X�

|<�DL���<�0���L�������@�|� �P�����T�����D���x�,���L�����(�����|�P����	�
L�
�L�p�L� ,�PH����p���,����������T�8�����t�����������<�����xP����8x��T	8�
H
dd	80l�����`���������H��(���`�\���l���|���@������H�8�(����	L	��<�,`�h<< d�<���$�����t�������d�����L���������8�h�����������������d�h���� ���t� Px(�0��DT�@�0������������������������p�������������@�d�������,x���	l��`�$��<��p��������������h���D�$�x�����l�����\�����T���������`p�p�4Xt�X48����x�$� ���������@�T�������� �,������������<������L�����|�(���D�8dL0T�D��<$�4$��0�H����d�����`�X���p� ��8���\�����\�T�8�����L�h�,l�PXT �H Dd��T������<�������������|�8�p�0���\���$�`��������$�d�����`<p����L8��<8������8��������d������8�����P�D�4���d�������,�`���\�X��� ����������08$ ,T��H�� �L�P��,���|P��|���|����(��������`������� �0�,� �4���(����t0�L��d������D��4`X<8x����������|�d� ����T���l�L�X��������H���|�����0|�`�P�`��lD� ��0x�xT��������P������@���d�������L���`���`��,���l�D����|� �|@(@��tXl@�8��h @t��� ����0�����������,���8����H�`�D�����������`����4� D(�|���8�D\X,�0x��\� ������L�h�L���|����h�8��8�������d�������������@��H����h8(0DT`ltd(�8��H��������������(�0������|�D���4�p���,�����0Xd\H84Dh�� \���X$��tH00<HL@,����T�������������,�@�P�\�X�H�4�(�0�L�|�����Dl���p\Xd|��� 40��x@��������������������d�(�����������(�\�������������������������,`��������xx���������H������������������������|�d�\�\�d�p�������($����������@`ptpl`D(0@LPTTH(��������������������������������������������$$������,DT``\PD8(������������������������������������������������������������$00,00(����  (,(��������������������������������������������������������������$  �������������������������������������������� (($��������������������������������������������������������������������$,,($��������������������������������������������0<DPPL<( (08<<(��������������������������������������������@`x�t\D0$$$0Lp����tP0�������� ,$������|�T�<�D�`�����������������������������4x�������lPDH`������X����d�P�P�d�������������x�L�(���� �D�|���������������X�����xH40<Tl���t<������X�0���0�\�������t�\�,�����������,�x���X���\0 4Px�`���D��L8h�tP ����l�$��������8�\�t�����d�0����������L�����(p��tX8$,\��0LL8��l4(@D8��P���P���������l���8�l�l�L�4�,�0�4�8�X���|T�Tpx|`�����(8LltD�L��t�@� �����D�p�t�4���|�,���`�����<����� �|���L���L,|�<��X��8|�T��D8`���(��h����X������(�H�<����������D������<���0������0��T�l��Tl$|��D����|�����������8���l���t����������H�����\���$�����L�d�����0�|�4LtP�����d���h� ���p�h���X�����|���(�l�T�����d�����t�<�@���������������h��XX��h��$<�(08\����d,�(�T�����T�P���<��������������������,�0�$���8����p��TX��D��<�t���8�T<Pd�����8�P�x������h����p���d�x����@�\�����������$,���������� ��\��D�������,���d�T�h�T�������L�������������@�H�������(�l�p�4��������d��l����h�DLH�\�4�$����h�h��L�����������H���(�`���0�@��������$��| ��D\� h�x<T(�8x4�,4T������(�p�������l���@����P��� �X�0�(��|�������\�D�(�\P�lT	P	���8X0D��������\���������x���h�h�0������T�0�t�h�`0$����������d�L�D�$�	p
�
�
�
,	��8`�4�,��h@�\�l����h�X�����$���d�X�������� ��D�����h�������\�� ����t��	T
�
�
	x���\�� p�xl��\��� ���(�p�������X�T������l��P�����|����h4���(�|xD��D<8	�	$	,P���d�tl8����p���h�����|�����8�����L�p�p���$�`��T���0�0� X���4<�4��P\	HH@�(�
���d�@�`����������� ������@�l�t�$�L����t���P�H�x�(��,��0��T�`		dT8	�
@L
�	0	�����$�����������@����L� �@����������`�$�X��h�����\�$���dX�����
��

  	L�H	8	�p@	$	H(�����t�������X���0�L�������,���h��� �,���,�����@��L0��	�`�4�h��
������l�������H�l���T�����h�����,���$�P�������H���t����l
�
�`�
x���D��	�
4
�
�
���x�p�T���������H������@���<��,������������(�X����������Tx
��8(d4�<l`0�	��
�	8������x���t�t��T�<��������������d�����������(�,���d����
�T�
�<�t0�
���$��,�h���H������T�,�@���������,�(��������� ��������������T	H
�D
�

���
< 
\
\	<�4����|����L��� �l����P�H�T���|���h���L������t�����������,�ll��
�	�h��,�,
x
��\���D�h����������t���`���t�0�\�L�$���������H���h���(���x�$
DDP4<���P�<��`	Pht	�	p� �H�������H�<���<���T�\��\�����t�t��4����� �����\��L��8
�
����x
��
�
�
�Pt	\0	�L\����8�p����p�P�4�H�|�,��������h�x�t����8�0�|�H����l44
8,P���D� t$�4������X� �����,�l�P�d���h�������d��0�������������������D8d
h
xD(��������4
�
�4��� ��������l��\���H�����l�d�p��|������P�p
�p

	P
���
D��<(�����
�`��0������h����D�T�H�h��8����@�X�<��0�l���������p�`�
x��P��
P0L
D�t|4	���t�D�����������������h�@�������(�<�������h�,���L����0�$��$�|
���\��h���D���p�����d�$�$����8�����ߔߜ�l�0�H�(���	�
�
h	���D	��������@D
�P����
$
p��8��������� �8��(�l��\�8�����H������0�@�xp�
�
�����d�d8��!!d(p

�\����t����l���������h�P�����d��������,����������0�  x���
��x�
�0 ���d`
<������0����P�����������8�������<�l���p�X���Hx������(�����@H���d�x������
@ �
�\�d�4�|���0�d��8�p��� �$���D�� ��D�4���(���(<��@����pH���8�8 `	XL�x�x
�	���L������(�<�����\� �x�4�$����d�D�t�8����8�d�|�H�P�L��
��0�
��D��4��,�����|�����`�x�����(���0����<�P���l������\���(���T�
������ �L�$|L�ll�H�<�@(�D����������������D�����l�(�$ߘ�����������h��t���d��@\T�04�`�h `h����4����T�`������������ ��t�(����������D�p��P��T p��TH(��d����\$�H
������4�����������(�p�(����d��������h�����l�������4�
���p�@� ��8�p<H�<���	���t����������`���p�����x��������l���hx��@������(��8 �"h"l���X�
0p0�|,���L� ���h�4�|����4��D�0���<�������,���x���|h�0�T��|�p� �l��H��� ��� ����0�����������������\���4�8�(�d���4�8���$�x�X$0(�����\���`TH�@������,����x�,��D�(��p�$������H�0�`���h�`����������`�X��p|t���!�$�"d�(\|�<x�������������<�0��@�l����`� ���@�P����`�<�`�xt��
	<
T
��``�� ����00
�
���	p8�������P�4������d������t�����l�x�������� L
�`\
�h�T��������dL�	���x�x�@���`�X���h�H���H�4�4����������8��P��h� ���L�8�������� ���\���|`���0���,�����T���P��$�D���(�������������<�\��T8��t
����Ht�lD�� ����d
�
8��0�|��0���4�d��,�`�0������t�x����t�`�h��|�����|L�h	��\�L��� T��DH0	`�����������x�`�@���`�������$����(��� �<�<��L�h���4�\���D
P�� �L����$��P���
4�$�P�X���$�����P�����L�d� �8����L��������4�`��L��8��
���$@�!,  x��0@x�	4$@������x�`���@�0�\���������|�,�����d��x�H�<�����l�`�	��`��#($� l��h�
|��`l���\����$�����H�l���0��`��(�����T��t�`��������
lh���������L <��P	�p������T�������P��� � �����t��۰�|����T���t�P�����������|����
 �h
h(|p�
�X��T���l� ���������d��X�<�d����������d�
��H	h�	�P�!l!�tL����,	�	4�����|���X�ޤ��ް����|���,�H�����8��\���d�l�@���<h@���������H�X
,4�H�p�������P���������������\�����`�`��������������4�p�	0�\0����� 
�Lt@,���L�����l�����H��4�|�|�X�������8�x�d�<��x�L�,���T�@��l����P,��8x|�L��	|	<
�
�
��l
�	��������,�4�|����������d��t�������@�$�(���8���
$x`�@X���X���\�����|$8,���4�������X�����������8�t������������`���h�|�P$
0x,��(��L����8�<�,��������t������D����@�$�@�l����\������L�|�,�$���x��\�	��
tX��$�(d�th�<P���$�� �4�����$�|���@����P�h����H�������X�����X�������4���$���
�tX����D�h(�X@ \���������������h��d�,�p�p��T�������H����������h\(
��D�$	���
�
���P	��D0�P���\���<�����4�,�0���������x�������X�D�4���h���$�������
t��TH�HL0
��
�,d0\�x�T�`�t�������X���\���������L�X�H�������0�����@�h��T�
 @<����0��T
��	�`h��x��������x��\�X����������L�4�����t�H��������	�0$�
D�
�X�8�T�ptLL��������\�����L�$�������\���t�D�h��h����������|�����H�h�(���@�����plt
���0@����L��������T�@���@����<����8�x�<����x�D�x� ���� ������<����<4
�,�4��
��D
�
�
d�H
�
���\���d��������d�����l����@��� ���d����X�`D�(��L�����@
0x
4<4�0
`	$ (�T,	�
�
��������(���X�����d�8���$�������T�0�\��d�L��x���h�
4��t���0X
X
��H
�4Lx�x����X�\<�<|����`�8������D�p����P����������������t�Xx�
��4
�
0L`@���<	�
�
H	,tP��������p������T�����,���|���<�<�h���D����������l���x�
<<0l�04L�h�x������@�@���|�����l�����(���@��������������t�T8(4�\L,�8��
����	��D��������<���l�,�x���������$�x�<�0���X���H������������x�	�
���
0(�,�d<��d�	l
�	\@����,�`���,���L��d���h�� ���|�<��P�,�8�$�������h���`�(�p�8	�	�
���	`����l�X�`X�|8����x���P�������\�d�������������������������Td���D��	(�\
H	�,��(H����������������������@�$������\�P�l�0�h������� �P���(��$4��X�4	H
�
\���
�����������\�p����P��`���������@�P�l���l������T���8��p�$X	t
�
h
 	��PD$��hH�(�|�<����@�d������d�����`�����T�����H�h�d������������t����xh	�	�	��@8`����`,��L���4���h���4���t�<���������4���P���d�d�����l$�T4�\D8�����L����d�P�L��������|���d�������<��������(�����������0���<�h���x���48�d0�p��$���0,����|�<����,�T�����P�T�L���������D��`���l���4� T0��H�������X���(�p�������|�x�H���p��������,��P����h�x�0���x���\���\��������4�DH�p����PX\��@����PL��8�����������������4����������4�h�$����������x�0�D���44�`�lt�h����d�����L����t�P�|��������l������������������\�����������d�@�,���@�8��x4DX\������h��������t�����p�|�����d�(�,���<���L����<$���Hd|�8���h$��t��HL`@��d������h�����h���������������$��������d�������D��d8`T8D�ll$���H�@����������4� �$����D�����8�t���`�H�l�������\�4�h���T������8��tHH\`@X�����h8�P��X�(� ��������,�$�����T�8�D�P�T�d��������(@d���hp��$<DPhpT����t`PXttD����X�8�����������H�\�P�D�P�\�T�4��$�T�����Ht�����pp�����@D,���<������������������P�������������<�x���������������������`���������xx��������P��������������������������p�`�`�h�t������� ����������(Pp���|pX<($(00,4@@8�������������������������������������������� $$ $0<@@@DD<4$����������������������������������������������(0,$ $(,$���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $  $$$������������������������������������������$8HT\`d\L4$  $((,080����������������������������������������������$4<<4$ 0@HT\hpp\< ��������(0,��������������������������������������������$,<P\XTPXl��������X0������������������������H����������8���������������|�t�|�����P�� <HD�����������X����\�@�,�(�<�X�x���h�<����������������T�������$P���<d|xX(����\D<0������`����l�<�4�@�T�h�����������������������\���D���(84D`px��|T�x<������x�|���p�<�����������x�x������$�����4�L�l���d,�X������\�� <Ll��Tl��,���l�����t��������d�$�����p�P�l������p������������� �d�`���8�TLhp\L`��|�H��,���D�����|��� �l�������t��p���l���D������dD�4�P�x|���d�LP�\��@�0����H��p,�������T��������0�L�t�������8���`���������d����P�p��P��$�XX��(�����������x����@�����H� �4�X�����l�D�������4�P�`�T�H�|�����@�, �P�H��H@\l<���$�l����T���L�(�0�<�<�4�0�(��������H�D�l���x�L���T|�t$���D ��,��h ��X���������@�$�X���������������,�����(�<�H�(��������$�L���<��0�<�x��<x�|���,���0�@���t���������@������P���4���d�4�������$���X�p���x�\�X���t����t�����4��������x����������h�������h��d���t�H��P�P�`���T���������4h�`\��t��(�,���������<�<�����������<���$�����|����������p������H�X8��\��0D�H\���0�$�����������<���D�$���X������������d�����D�P�������X�lxl��h��������@��Tp����d�|���������p�`�,�(�X����� ��������h�4������p���<�8��������D	��8�PLP��\$�(����@�P���l�`�������<���H�����X���������<���,���H�,�H�x�	�
�
�	�\��\���x@�����D����������L�p�����h�@��p�0�����$�4������X��\p�l��	��
Dl0\�
�`����T���\�`���`���D�����@�h������������������P������������d�L
�x����
(	�\<	�	

�	@	�H(@���������T���������x���|�4�����|�����\��������h�H���P	�
�
��L�
(	@�	�����H��d�d������l�4��@�0���������D���d����\���@�T������� 	
�
�
 0�P	�d�|���T0��h�X������������x��d�����l�������T�������|�������P<�D�H��`�L�Tl�\<`|�������T���(���$����������D���4�(�D�4� ��$�P�|���T����|�����h@�X�������p����D�l���<�������<����<x�d� ��������T�X����L��PDx�  ,��|�xH$$<X���������H4H\dhhD������������D���` ��������4x�������lLD`|������d@ ������������������(4(��������0HT\`P8 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������d�d��$`�4�\$t�����$�D�d�<�|��������\�d�����l�8�T�����<�����H�T�P����p�TT	`
�
�
�

l�(����84$�0���L�P���D�����@��������T�T�0������� ��`�����������h��`�x\"x#�"T!0�����
h
$	L��<��������P������X�����h��<�p�������$�����
�
|����X���|#�%4&�$�"�X�H�����t�l�����D���d��݀ٔ� �����D�����������������������(048�T�xd pHL�8���\�p�L������|���H�H���L�p�X�0�p��p�����\
�X	$h�
H�(  �$\'(&!�$Tl�
�
�p� ��8�(�,������ߘ��8�X�������|�����x��l�`�X|l��l���h����@X�
��H�����,�P�����T���8�����`�������h�p�������������(�����,���0�D��H$�(��� �8�������0������������ �l����|��(�t�����������T������� ������������8������$l@�D�����<������l��T���8��T��X�t�������p�����dPh
x��0"�&4'�#��4���	l
p
��4
�d�\���t��<�������������$��x�t����H����DH���H� �\�8H�Pp�	�P���p�l�����x�����0�`� �<�������h�(�������D���l�h�����<�Pl!�"!�d� �,X��x�X
H���������P��������������L���8����������`�\����	��
��h���(4d\(���H@�� �����0�@�\�t�8������\�����D�,������`���,����$	x��|Hd
�
�T
X�� $�$`#�! ��
� �����������������t��$�(�D�d���D�H��,������d�|�4���(�L�����
L�\P�����
$t0�d|@p������������d��L���$�<��������D�h�$���L�����@�X�(�X�����,8�`
�	,
0
��X�����8�$����d�|�����`��X�d�l��0��t���|����X���
����	
�	\��8�L�
d�����l��$���h�<�����������\�L���L�����(����������d������d
�
t���x\���`h0���
���������������P���$�l��P������,�p�X���������l�t�������l	,�l|��hd,T,�`t�|�(t X�@���p���<������4���T�0�p�\������t����4�`�����������$����LT"� 0X� X�
�0TP�	�t����������<�����,�$����`���0�����x���(��(���\����@�(,����T
TH	`,�4����8�T�8�D��� ��\��8���������(������l����������8����x�P���(����d���������h�$�8������T�p���\�D���|�,��d��4���t�,�
�� D�\��L��
	X����d(���������l�����l���4���������|�`��������4� 8t(D	���T���l��	�(8T�t���D����<��p������$���L�������T�T�X���L�(�������H����
|�
	��
��l$��X������T���P��P���������<�`�t�|�d�8���0� � ��0��p� ����`����lP	����(�P�<T�|�H	H��
\�	�\�4����X���h�x��������������������������x��T������(d`D��
�p��P�����D��D���l��������4����D��P�@���4������<��t	8
`t
P4�
X
D
�8`����T��	Tt���4����|�h���H�\��������x��(������`�<���������h� �����$���d
�����
�
T4�|�HD��
����t�P������x�,�����<�@�����D�����P�@�`���T�	4	��t	�X��8\,H��
,�		����4�d��8�x��������X�(�D�l����4�|�`�@�����,������@�p����Td
4�
�h�TP�
`
���� �D����P����8���<�,��<����h�\����$���T�L�����p��	��
x H ��
lx��L�d�	h�4��L������������`��\��l�4�H�x�H�T�����L�8������`�\��@��
l
�l|���00Pt���|xx�\�����(��������������(�����0����T���4��������	�`����	�	
l|
�,
�
$	l�t|���`|������t�D������p� �������d�x���`���,�����������<,	4��4���l	�@�
	��`t����T�p���,����������h�`���t��������<�����4�����@�t�p�����T�����L	l�
�H
�
�����p
H
����4����������������L���H�d�0�����8�|���\�����h��x��l�\����l
�
�
`h�`���� 0������D������t��p�4�����(����<�`�����<���<�������t�`��H@Ld
|`
��
�X�48���TL�4��������0���L���h������L�D������@����������������D��0<�P0x����h�p���T���d��������h�d�����������L����H�������l����t������4������	 
4	�\�0�����$�t|���$���p�t���4�P��� ���(�p��\�������\�X����\�� @`T��|� <��
H
4	x��L��@X��p��\������� �x���������X�$���P��<�\��l�L�H�,�,����Td$d�PTT�t@x��D|d��\�x����������X�����d�\��L���D���������P�P��������(�X����� ����04�P������8�����l$������8��l��� ����<���� �,����������<���T D��x�l��\t���\|���H`T�x����((����������D�������d�4���0�x���t�t�����h�h���h����p8T��(���H��$�����L�� �\����@��l�����T�����������x��P�\�T�h�������������@�H`8��p������P�������8���T�,�<�t�������l���l�0�� �4�t�����l��\�������������4�h,�L����(�d<Hd����@�(�`���\�$�$�`���,�|���X�����@�����L�p��������P�L��4����@���LL�|���`40Pll@���� ���0����������`�������������d� ��0�����T���(�����d`x��t�4P<�H�T������������������D���d��������D��������������p�d�|���0�4�HT0�l��||����x��(���D������L��������������t�h������l���0�����������<����P$��L������������������@��������������4�t���������`�X�\�d�h�|�����4h�������||��������l<������������������������d�T�L�H�P�\�t�����������������������$@\p||tldP<($0DPTPD<(����������������������������������������������,@P`ptt`D(��������������������������������������������������$,( (440 ������������������������������������������������������$,,( ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������(($������������������������������������������������������0DPTLH@4( 0<@@@0��������|�x���������������������������������$<HD<, Dd����hL0������0<4������\�L�P�\�l�����������������������������0�������tL@Pp������|@������������������������`�,�������������(�`�������������������8x�� ���ldlx�����L����X�8�(����D�x�������X�8�$����������<�������<\`H0(Dx��\�����P(��xLDXhT����d�@�������������������0�$�������<�p�����d�<<000(�X�������t��T� ����������������l�������������� ����X�|���������������,�8��(PX$�t\|�������8���l�,�����\�(�8�t�����8�������h�������<���@�������\x�D��X�,hP��4��xPPhp0���@���T���X������P�h�\�L�\�p�d�0�����\���������,hX,$X�8h�D@�d��<��x��4\�H����D��������0������� �d�����|���\�(�H����� ����������@d� P�p�T�h��d\���\�0�0���8� �@�D�|�����(���������X����H�T��L�|��t�����,\���D����X����Dx,088���`�h������������,�@�$�0����������(�T���`���0���x\\�����|��`����X��xH�����\�4��������� ���l��������@������D�,����t4p0�`�h�8�p�L�t��d�������x����(�����X�����4���������h�p�������L���P<�l����@$��ht��,�d�,L�T,�,�L���4�H�����T�����d���x��������� ����������4������h�� \���\T�����l��p�0����������������L�l�P�,� �����l��������L�<�@�����,�������	�	�	��$���$� ���@��<������D�d��� �P����������������`�(�������h$ @�$@Lh���\�4��l��,�������l�(�,��������x�H����P�P����� ������\�@�d�D�d�������X0�t�d
4�
�	`T��X0�|	D����4�L���������L���h�������(�����D��������l����P��lt��p�	t
�
�	�@�dD�,�H����������$���D�`�<�<�l�X���������,���4����4���t�4��� 	�	t
p
�	8 l�P@	l	<	�@���������������������������H�h����������dd�X���P�
��X
x
��
�0 ��������\�T�������,����4���T�T�4�������H��������@��� ���L�$�tD��h	8��,(	���P���<� ���������X�X��������D�0�(�������T���X���H���4hh��H� ���h�	���t���
\4�4����d���������`��������h�\��<��d�<�T���p��� �H�|�������$��������t	td
��D�
`8
�����(�@���\�����h���������X�T�8��D�h�$�@� 0�\�����DH
L�
�	�L�pT��	P`	��h������0����������������h���4�\���|�P���Lh@��@�@
�lL
@d��	H�D�d����\��������x���L�����p�X�$�,���,�x�4���\�������P\	�
�h��l
���T
��

HHX	 ��,��`�����������x���8�����$��������$������l�H�P�(�L���8���	<�
���8
���	�l0
�
�
�
�|D�h�x���t��x�h���(���<�d��������l�$�L���h�DT,��`�h����
|
��4�x,�
�

�p��	4
lpT�L��|�����������H��4�������(������� ������D�48��
|�@�P��8���l	 ��0��P�������`�(���$�H�x���0�������|���`�$�H�L���h���	�P�����pXDX�P�h����($�����4�l���������������p��X���h�t��������T���@�h
�8p�������0T�
�d
�
���X@���d������x������x�(����l�P����������|
�
�\Dh�4���lx�pP

�d
���Xh4$�L�(�����t�$�\��l�����D�������h�����D�������
8��8
X
P
h��l��� �	`�������������|�����T�d�l���p�X�T�D����P���h���P���D�H���<�T�����
Tth,����

�	(
P�
�x$�� h�\�$�8�H������h�����,�����x���������$�8�	`\�hT�<
��<�$@ d�����
�4	�������������|���\���p���L�d���$�4��0���4���
t
��0	��	`
@��<x|l�
H�������$���������P�����L��p��� �X��0�0���4���4�������\�P������|�`�\�����8���
���h������p�����4����������X��h�� ���X���`����$����h	�
��`��D���HP��PHx
�

T�T���,�L�H��������������P�P�\�����\����l���H�������D���x
��$<�|d��|������������������|�@�H�����,���$�����X�h�4�8���� �(��L�xt�
H ��0Px�����@�l���
|P,���� ���@�l���l����������T��(�P���������,������P�8�h4t �"\!��0���lD������X���L�X��0�,�������X�x���8���h��\�$���$���8|HP��X��
�,������\��
p�
��4�4�(���d�|����D���,�h�����L� �,��d��\���P�0�������,	�
���|��4����
4D����<�������@���d����X�P��(��|������h�����������p���
��lD���|0��<��`���d��������,�<��X��8��L������@���(���T�h�0���X����PD<�$��"`%�$4 ��t�(��8�,�0P�����P����޸������0�������,�(�����d�,�����
\
h
��
,8X�l���`t|��h��$0�L������x���tߨ�4���H������\�T��8���d�`����,�����x�(�4��,�l�<@�	��4�l���\��������4���x�X����0�T��X�����D������T��P
�x�������D��
(�
�x<���4�������`���������������D��h����d
�h
��	�d
l
�l4�� �#�#!�,�P
<
<��

�(����d����l���@�Lܴ�p�����(���d�(������8��� �X�
dL�\��(P(����H��`�|��������������� ��\���������������������@����������`|	$�$�L0 ����`�\�0\�����T�(�H�h��x���$����������������<�<�@������x\P0�(�0L����Tdd�<T������P���(�$��h��@��t���p�������x�T�P�<������<\�
���	�
H<��,lx L,� D
dh����@��T�H�������l����(�p��(�����h�P�����X�����h���H��|`t����,h�d������hP�
0�������������@���4��������X�D���t��������P������\T`,D!h<�t�(H�@
����T������t�,���������L�t��������H�p���T���4�`����h� �P ��	���ld�"#d�@t(�����\�4����,���p����x޴�$�X��P������������ ���D�8��(�p��|X�$4P�l8�t0�|���d����x�������L��������T��0�L�$��,������`$�����	��`(���4��`l
tP
�`h0�	H$�����P�0�(�������t�T����H���������4���p��@�
@
�	�
���( l (������d���������@� ��������l���8���h�d���������lt
��� ������ �����8
(�4�@���h� ���<����$�\����8�D����������d����������@�������
�$x�����0
�L���� 4\�������H���,�@�H��d���P�0�X�D���`�d�X�L�����P����`�������|�$(��t����P
\�
�
�
<4$�
���������,��(�L�P����D�D�� ��|�����P�����D����	��t�
4�L�p������\�(����0�����<�����L��������0������p������T���P�@��
��
H�\����d�PP8D��� �`�����0���|�d���(�`������$�x�@��h������H����p�x���P	h
��p��d��D��pH�$	�0���������X�|���$�t��$�����`�L�����X�|�$��(���4$�l
�
��,,�$L
<x�	��$T
�
��4�����h�����������������p�����������(���4��\�
D
���l
�
H	�H�
�
�<L$�@hltx���d�� ���\�8�H�,�D�d���D�`�\�\�8�������p��������� �@����|	`

���
�
�	�����4�l�$��������T���T�$���$�����t�`�������X�0�����p�� h�xt<���h|@P�l��
`�@���P�����x������|�����T�|�T���������������P�X�����@� �\�8

<
��
�t8�����x\X|t��������h�P�����0����8�,�4����|���������8�����,�L��8�
P$���d
t	\	X
,4���T��	�t���L�H�������P�l�����<�p�T��|��x���L���0�\�|�@�d���������t ��D���
��
�H�	����\�l�����x���������X�l�@���X�������������`�4����Th@�	p�
��l\T4`�|t
��T���������x��������@�����L�\������|�T�8������t��d��4���(
�
�
�@
@@��
D	����0�����@����������X�T�T���������`���� �H���� �������h�D�P�0	$
�x�p��`0��H�d	0������������l������\�`��l�������\�\���Hdh���(����	 �
Dd��(	(������8��������������d��������T�d�(���L�T����l� �H���L l��<����X	�
`4
pH
���4���`�x��x�T�x���,�����l���d�|�8��������������8�\����D
��
P���h
�8
�	�
@T�
�	�	X	(l�����T����H�������������x���������,�H�0�D�����L�<��0��`�
�
h��
�
��
�	�	d
`
h	�4����D�\�4��������,���,�$�����\�,�d��$���x����������8����$	�	�
P
X�
�,����T������������<�`�����P�\���8�0��������<���(�|��@��$����tT��(\�	�		�Ph8p04�@�,�L�$��������h�,�d����������t�0���4���x�������<�����h�<��tH�DhP	�	�	L	��������`�����p�������l�����8�(���d����x�H�����|�����X������`@�d��x	p
h
�	<�X��������������d����t�����L�T�H��������L�@�������h���`� (� l�T4,$d0��|l�lh���P�������D�h�|���`���<�d�����������������$�`���t�0�D����������<D�p�T�H�X,����(�D���(��������\���4����������������8�D���p�|����������������� �|0��,�`t�d8�8���\@�������X�����\����(����h���� ����� ���������$������0�����<,���P�������p��`��T���p�`���d���$���8���t���0���x������0�x�����hx88(���0�4�x������\����(�������������$�$�T�����\��0��� �\�4�����T\��L������P�t�pdL�TX\Xt�`�@H0����p�������|�4���p�4�����D���L���L����8���|,x<�X`�,t��x�� x��<��8����,��4�����������$�������$�x�����8�������,�����L����h������pD$@��$��xH�x��������t�\�h�\����\�@�`�x�|�h�h�����8�D�(� �<�p���������@�HX`lxh8�����������D����H�(�����8�d�p�d�H�(������������<�������0Pd\D0,P����,LH$���t8������������t�0������������$�D�`�\�@� ��,�X�������`���|px||x��������P��������������������X�$���������������,�h�����������<p��������xp|���|���l8������������������������������x�p�t���������,Ldp|���pL44<HLHL`lhL ������������������������������������������������$0<HPTL8$������������������������������������������������  ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ (( ��������������������������������������������������(8@LX``T@0((($  (,, ��������������������������������������������������(480(,8DPT\l|�xdL<40$����������p�\�P�L�T�d�x������������������������� @`|�����||���������xP$��������������������t�L�,�����,�P�x�������������������0l���00 ������������T������l�L�8�4�@�X�`�L�$�����������������0�|����� 4@<,0P��4Pl�xP����x\LLXP$����p�T�@�$���,�X�����������|�P�����������D�����TphTPl����@�����L��0����8@8$����0���$��������@��������������<���`���d�@����T`��(8Pd4��H��t�4����������8����(�����l�<��0���D�������@\H������4��T�\xT�������tt|T�X����h�<���������������X���������D�<���������T���\�xlp����0�p���|dD��8���x,����<����x������������L����������������@���p�H�� ThL���D�\���LT������\���$���(��������X���P�����`�8���`�����l���������l���$��h�`��`Dp� 0,X T00��D���d�����L���h�D���\�4� ���$���\������`�����t�<�����t�<� �P��d�h�04�`D�|��� �$�P����T���$�0�\������|���d����T�0T��DlT�$�(H�$����X���������h���p��������T�x����T�����h�����(�l���h���|�Ld��H�<0�dL�����d<�����D���<����,�p���l�l����������X�����,����<4��������� <��\H��xH�����������X���D����l���|��������� � �0���8����D�p�����X��xH������p������4�����������������|���t���������0�d�4���@���������8d��P�dtL�((�����8p�������L�8� ����������t�\��H�����\���l�������X���P�@����������D�	��
<	��x��4(�XPH�h����������P�X���������������������������hh�dt�$����
��
�P
�l�L�|H|���������p�X�������D�����x�h����������d������DH���0��� 	�	�	T
tpp�
��p�(��$�L�`���T�H�����D�0�x���P�D�8�p�P���������������8������H�����4
���
�	�	�	�	�X�hPP�X���T�`�4���,��P�D�T�����x��������H�����D��H���h�h�����������lh	x