rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������|Dx��4��\lx�t� ����L��d���L��������x���4�����@�<�x��\�8�����`���������T���(���p����,���l		���$d �0 H��������d��@�������P��������h�������@������<���	�$��
�`�T%�)<(�#���h
 0����
�	@�������X��ވ�\ڴ��������D�����������<�h������H �\\�L\T��`"l'<'$4!�PD�|�� �X�$�����H�D� ���|�x���L�L�4���(���(�@��������� �h����T�$��	0hl��!�#!�TH
�txD�( �����������d����d���|�\�������ּ�$�����\�p���p�������l�Lx��  �(�,|)� ��4<�t��p�
�L�����D�޸���D�|�h�H�,�����T�|�����t��� �l�H	��

�	T
��	<"�%�#��� �
$d�$�t��|@�`����,���݌�������|����`�8�D�|������\�����l�
l�����4�	��
�4|X����`��4�@��L�H�4�D������h�����$�,�X�ؤް������p��h������`�H(����#�)�*l$��|8

�L|�,	��������h��܀��|�x�����@�L������,���d�$(
X(@l�`�	<
x(T#�+�-p(�8,�\	0 ���4�h	h����D�`����t�p��x��t�h�`�0��T����x���������L�\��x�|�T
�	P�� �"� ���	<���������,���������4����|ۈ��� �������������D�������H�������H,"0&l&H x
|
��� 0�`�4�����@���P�0����t���l��|���ٌؘ߼��������
D��	 ������((�#\+�+\%����
D������X
�@
�8�����\�����ٌ�d�����@��h���p���� ��@���p�p ����T	l
��#T$0!��@�P`�L�T�|���d���8� ���������8������݀������h�d���H����������T�X�h�T� !T (�h	X�P��@L���0X�d�����t��p�@�8����� ����D�D���<�$�H�P����(�$�
�	|��X���8t���#�)�(\!4���l	P�
8��
H��8�@�8���|������4�������4��T�d���p�l��@l����
	�
���
�
hX�%�%�  ��(��D�D��������������X�0�d�ܐ���8�� �@�h�4����@���T��x�t���@�����tT��
��|8\X��l�<��������,�����������p�d��,�x�$ߘ���l�������@�4��������	�p�X!`$$"L� �
�Dh
�Pl��
�����h�d�0������������P��$�l��d����$���`��T @`��
�p�t"h&�#�8���0�l�8X	��
�,�����������4������$�X��������\�|���(���D�L,
�l<�\
�
��
�
�	�
� 0l�X�ht��$���������8�@�(����4�����h�����t�`���@�(������<������@�T�,�p80��
l�(H��d�
4����p�X�����������`�x�������������d�x���hTL D��D��p
��x�`� ���h��
� ��l�t �$�������p�8������ �8����\��L�L�4�x������x��d�
`	�
H
�	�
��8��8T\L	L����������<�d�D�x�,�\��(�d���x�h��� �(������@�������t
$�d��h���	���p�(�@���0���,�,� �4�����P���L���D�0�����������$�|��`����x���TT	�<x���x��`	x�T�
�\0hx����@�����<��P��`�l���������h���L��������  8D
�	�����P	�
HTDx��h4�\D�D��l|hd,������������t��d����`����d�H�\�P������L�4�	�� 8�
\T

��	|0��<���p�@�x�D�������x���D��p���<� �X������L�����0�������0�������d�	H8h�0�HP
,� X
d
�

�������p�h�(��x�����l�\�H���`����$����h�T����� ���t��lP�P	�
������	�d���@�|	��X�4�x�����`������H�����������p��������@�P���H�	�
�
0`$������\�4x���	� ����\�d@��,���l��������@���8�����@���������P�����������p�h��T|h��<	����
<��
�  �����h�,�8�p�t���X���P�����x���L�`�(����������p�D���0��	T�
0�@ `	t<T�t|�	�H
��`��(���@�P�@��(�������0�L���p�$�D���@�������(��������d
�
�����	���\0���8l���d� �D������h�������t� �h�l�����`�h���h�`���t��X	�|	� 	d	@$�H�	4
��
��`
��L���4�4�� �����P�X���\���������p���(��,�d� �$�L���������t�<���xX4
�
�
<
(
������`�	�
�	�t����������|�0�����D����@�����`���<��������P�\���t�����P��, �t\P�����T�X��D���t��� ����������|��H���,�P���(��L������l��( h��X�0h�X
d	����������p���|����h�����x��������������L�������T�0�����������������	,
4	���P(���X|	�|���0�������������t�����L�������\�������(������lpx��|�x�TDtl�
\8
�8��L`l|���(�p�<�t�����������X�������|����$��8���������(���HPT��T|�X��	������\��4�@�������0�(�L������d���(����������D�����0���������dl�x$���P�<����L�HH�����4�T�P������@�L���������d���(����\����L��0�����t�������P�xTT����4�$�������p���������X�T�����0�t�4����D����0�,�������|�������t�l�\lHpX��������8Tl������L������������p�����T��H���0�,�0��,�������,�DxL��8�,\���X����\���������t�L�|�����8���������L�`���t����l���$�����L�`�8�l�t�(�������@,hxDtT0P�D(��`�@�4���|�|����4�������t�`�4���`����� �<�������`��,����8L,��\�|������0��@ H8h������������`�$�x�T��$�T�L��������t�P���L����p��$���0@@�H,��t�h���|���<��(������8�P�`�����@�������0���l���$���@�X�������������������pH4�0T��<�@�X�P�,�,�h���������H�������������T����������������x�<�D���hPp������������4lT�L����l�0��������l���h�0��������d�4�T���,�������$p�x0��4l���(���H����P(l��P������D��������<�P�T�h�������l�(���H�p�������T����ttpdLDd�������P������������������������d�(��� �$�(�@�x�����������������������d��������X<D`|�xx��x<������������t�������������|�x�x�p�`�\�p�������$, ��$DX\hx��xT4,0, $88$���������������������������������������������� 0@@4$ $((,0<LXTH<0(������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ $($  $����������������������������������������������������$,8Hdtp\@0,(,<<(����������������������������������|�x�����������@\`H4,4888Dl������x\,����������������\�0�(�8�H�L�T�p�������������������������(t������|L,<t��������(����������������������|�0�������������t�����������������������<���8\H�pt�������0������L�����D�����|�D� ������x�P�p���H�����T���h,$P����X���@��L����\��H����`���0�����8�x�������@��������l������0�p����t��`8<<����\D���(l�,�L�����l�`�������H�|���p�t���p�h���P�$�����p�(� �@�D����0����� 4D|�x�8����Tx0@�������X��H���`�p���<�������8�����������p�������P�d��x���X,��4�|�������dpd4��@�������������D�X���$�H��4�`� �����X���D��0���Hp\t(PX�H��\�p����(���(����4������@�h�`���h�h�������@�0������ �����������$`8������������������<�t����`�P��������@�����`���`�0�@��D�����������<��( �������@�dT0�� <�����(�X�,������������H������������d�X���t�P�����P����\��T����d|�,8���8T�������D�,���(�����X�p�������@���X�@������<���������D�d�l���L8��L��8��� ����@������D����$���P���$�8������$�,������x���,��p�`���$�h��(,��H���x�P<0��0���(�������l���h�p���l���L��L���������T�����t�@���<��0�P@��d��H
8
x ��88�P����,�H�<�@���������T�$�����������|�X��������������`,�,�L����	�p�	D\��$�����8L���H�d�<���H�����������������L���d�t����0�����P����x|���08��@�$��	t	�(	�	��X�������`�p�H���D���<� �H�����<�8�\������������`������L������,(���	�
��	����x���T������x���X��������8�����H����|�t���|����x<��x���dL�(
�
Tt�	��d�h��,�@8D�@���������|�� �������������,�h�@�H�H�����������T	����0|x	��
(
�<�
�	0�(���������������8�T��h��� ��0���4����h���`�D���t�����������p 
p
l�
��	�$L�	�		d	�
�
��d����,����<���<�\���P���������t�������p�$���t��l�d�xP�	���t
�	�0`8�@�4��`�����h�H�h��x������������(�8����,�0���8���P� l
�dH4<0��(�$�
�0�	l��������$�� ���l���,���,���`�������D���P���8������$���������d

�h
(@
0
�\ �
<
�
0
,
l�l�h�d���<�����8���`���<������p�l����P� �����t�8�@L��� ���
\ 8��h
Lt��T@�d
�
�������h���4�L���� ���\���������`��(�� ���h	�
H����h	�	T
��l���
�|����,8�������x���X�������`����H�<�$�\��������,�p��� ��	��@�p�0	TX<
���P<4l�
�D����t������l�������P������p�����\������<�t�0�����t��d�����	���(��4l	�P��l`l�@H�4�,�����H�����0���������X�l�H�����X�D�,x��X$���l 
�
��|P�
D$x�� 4�����L�L����<���P�����������P����x��D�0�x�����
����	@	x
�
d	�$	��p���$h
�4� ��� �D����<�X���8�������������|�������|�������X�������|
����� <�P��L�xt\D���T�T����4�������<�P����T��������@� �� ������H,��0����$�p����|��,	�
84`
����p�����d�(�,�p��L����|�x�T�D�|�@���D������L
��
,	hhxL��<�����H�
�<|���D�x�����L���|���t�`����l������H�����l�(��L�\�t���l�,�l�	�����H�dl��������`�t����������x���8���D������\��T�����x����������h�@<`�����
��<�
���
�H�p���H�t��L������H���p�4�\����������4�����8x0
D@�����
�
H<0�D"��pP(
�����
D�8�X� �������������(��L���D�(��L�p��� ����D���
��@�
�

�
\�����,
�D���T�`���t�����p�4�����x�X��(���<���\���(���`�<�4�@��������x
��x�\��

t��(8��0����p���H���(�����P�$�l�0�����4�D�h� ����(������\����D`�$0�8"%t!p�P4�
\�x�T�04l`���������������<���,����8��h����h����|��,	�L�XP
���#�%"��(��
�x�������H���,�����|���|�hޠ�������p������<���0�����������������,4
���|��������l�����X�,������p�������|��ߐ��ۨ۰���d������P�4���������������LX$|% ||x���0��,���D� ���|��t�t��������������<�L������`�
PX	���	4|��!H)l*�$�`<
�XP	���
<�����������p��ެ��,�\�x��T�@�����p���t�L���||||�X(�(
pH�$,%X!�����@����� ��� ���d���(�������۬�H�L���������h��|�d��<���<��x���,�0Px����x�$��H����|���H��$����|�\�H���<���|��ټڀ���t����������
���D�!�'H'x ����
�$	��D�����������ߐ�D��H����`������ ��T�h�T������
��,@|�|@<
���$�#��$D<	��0����0Th�8���L�L�X���ܸ���� ����x�x������������ � ��$\��X4l� �
L�d��T�����<�0���p��D����`������������0�0�T�`��P�����p�X�D���|��(��	X4��T#�' &�\�8X��0 �\�$�������X�P�l����t��D�����������8�d���`���
|�
��T�����H%�*�(�!$���	���8�8�
\�������\���X���� �����������$���l�x�t����l	X0d���<�l	L
P8(#�!<�����\�l���������������t���H��d�H�0��݀�����x��������������������
H��\"��`
�0P�L�H�$����L� �������h�D�8�h�H���p�@���pݨ���������D��
�l��(�0 �l���%8)�%�8����(d��Tt	l������0���|�8���T���t�D�p������H��\� �,�$�t�8�
d�t�
��
�
�x �#4'X$8���Hh�����(�t�8���8���<����������(��`�,�����8��\��D����d�T��X	�
`����l��H��$���H���l����L���l���t�T������,٬ބ������(������������\���
84 X$%'\"$��
�pd
(
|H@p�
��$�\�������H���4���0�d����`�|�P���4����
x8\��<
\
,�8�%�' #`�t�X
�PxP
|
ph��(������ޤ����D�4�������0���x�����\�,���
(<�x|D��88���tLlH�
0���X�(���������|�`���X��(��t�@��,�,��������`�P������p���X,�t((|�����l�P�@x�8H�<�<�����,��D���D���t�@�P���\����t�L�`���x�(�X���	��T�8	�
�,L$�$������hl�8
`
���������4�h�$����|���������� �,����\�0���`�X�pD�������	L
��@xX��L\|(���������������0����������0���H�,������� �����P���������� `D<�H��	��0���@p(��4���(����D������H����P��������0������������x(�X����P�
��D�$($���
8
�@���
��t0������|���p� �h�@��\�l���$��\����4���\�p���4���0�Hd	<t
��P�!!`x�X�
8�����������t���(�X���p����\�h������������d�T���� ���p����T�h\��Pd�x�������P������������,� �4������T�� ��4���8������,��� �����t����$44����x�
T	�	�D
��|��t���@���h� ����0������P�L����`��x�������������@�
|0L����<�|�� �@��p
�DL�	�$H���������h��l�H�4�t��|�T�P�P�����8�����`�@0h�D���	L��@�@L`0<�
H���T�(���4����`� �x���$��������P�D��8�<�<�����d��������������X@����	p�	�
����L	���@��������8�0�D�4����������`�p�`���\��d��x���D���8��P��D0��L
�
�
X
x��L(�
l��x�<���������|����P����|����\�����H�(�������
tD
� Tp	P	�	
�����,������<,�� �����,�p���<���\�l�����`���������������� ��t	8�������D
t(���0�H(`�\�L�8�D���<����$�����������4�����4��������������T�0����L	L
��@0D�
	x�P
L
8	<	��h�������(���������x�4��L��x������h�`�h�d�$tt�lD�	d
�
Tp0$�|
t	��dt��@�����L���@��� ����|������0�x�������������������
��`	p	��L	lt�d�
�
h������P�T���p���� �X����� �4������8�$�d�l�����D�����|��������(�0��|
D	�$��|	$	\	�
���	\H�P�����H�������d�T�t���@�4���t������l�x�������@��0����0�xt	 ��P(0$�4����X�H�����������\�X�������t������P���L������t�����8	���@<�d��`	�
L�
��
�	����� � ��(�\�$���\�������D�@�d�����h���@��� ����(���p�� ��T
|
�	�	�
�
	4<�`4
ph
�
0T
<�������|�X� �����`������H�����l�$�P����H�����������,�t���P�\�tL	�
��0�����l�d	�t���������`���H�������8���������H����\����������,�|��L��4�4	\$�
8�l�`����P��p������D�����t�$������$��������p�d� �����L�H���x�d��x�\�`��P�	�

	�t��������\�<�d���d�H�$�<�D����������T��H���L�h����������d��X�x�T��xD($���d��(@������t���\�x���t��� ���L�X�4�������������������\0�PD�����<��ht	�H`,��x�<�X� �|�@�0����x����D��0������h������L���H�����,$���$������h��������H�������<�H���0���l�|�����\�x�p��|�\�����������T���l�@�����P4���d�t�t���p�H��xp�����d���0�����������(�8�����������|�h��������P� �����DT����@�lx�0��x� l�@8�����H�����0�������L��D�x������<���X���`����\P�����8,�\���p�������`$@��������,������������P�8�X���������p��������(�(�P4�8h4�����x���L����T�����T�(�|�D�������H�T������X�P����$�������8��0���`���X�����xL����4�L�����x��P���l��������D��������������������l���T��0t`�d��lL$���t�@����l �4����0�p�t������������(����@���X�����,����H�����(4�`DPD��p4��t ��(P|���h��������������������x���������h������|�D�H�d�`�H�X����X���������0d`\t�|L��$������������X�����(�������p�,����l��������Hxp,������T��@�������h@0T����d����@���������4�d�p�t�������T���������@�x�����4����XDP\XTl�LL$����<������8<,����4���������0�X�����������|�|�����������`������tH(0X�������t(��������������������������t�d�T�H�T�������������������������0DTh���lD,,44,$4L\\@����������������������������������������������$ �� 4HTPD4( ��������������������������������������������������   ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  ����������������������������������������������������$08DPXP8$,40���������������������������������������������� <@,((,Dl���pXL@,����(4(��������X�H�X�t�������������������������������H|�|hhldL0,P�������x4������������������������X�$������4������������������������� �������XD`��������P������l�D�$� �P���������L�(������|�x���(�������<hd$������@���(����,����@4����8������4���L�D������������L�\� ���l�p����D�p���L�DD�������<�8@��lx�������� ������������(������������`�������|�������������tX������$����<tx�� ������������������(�����l����������X��������� ��0�,����D��tX��T0P\@(d�L,t���<���<�x������P���p�(��4� �����d���P�8���@����d�����X������h��|8�������$���������T����� �������`�,�����`��� �P���,�`�����|<4����d�L���0���<,�@�������������������d� �������`� �t��� �8�p���������� �t�������(�$��L������<�4X�h��x����T�p����� �,�����`�������p��������h�,$�0P�����t���(�4�d�dL�l<x ��\�������t���D�|�x�������������� ����8�<�����������4��((,��4�����4,��`�0� l������<���8�D�����������l�������������X���P�L�D�0�`(@��������4��PpH����|���h���,�������������\�����\�p��8���8�������$�������D�X���\	�	�<P��,,P�X�<����������P�����,�4�L������������������� ���Th���$tH`��T	�p
4�\�\�����4dp|����x�(���,�h�������0�����x���\����������4����h�`���H����,�	
,	xH�8������d��� �`�p�`���h�H�P���D�<����������`�������d� ����$�P��L��,
�
x	�� ,<�\@���T�8�t�������x���d���X�|���h�h����������T�P�������@�T���d@���X�tT	,t�t�($ ��������X���(��0��������|�<���<�8�X�\����������P��Dx����(h�t�
�	�����0�����8� �������H�`�������,��4�@������������,�T����t�8���
�
�
��p	�����	�	�	�
�|L(T��������� �������H��������,�@�p���(�,�x�����t��dX\��������	�
�t�X(�	P�l,TL�<
�	��X��������������8�����P�����X�|�P�d����������<�,	�@��h��h|<4��8���������(,�<�����0�x�$���x��0�T���������������x���X���4�� $�����(�H��0P���DT��l ,HtD�h�4LlL<(�lT�(�p������x��������tL�0�4������l�0���\�������d��������$��`4 0D\|tL(��������������x�`�L�P�X�T�H�P�l�����������t�X�@�H�`�p�����������������������������������������������������t�\�@�0�4�<�@�<�4�4�8�<�<�@�@�D�D�H�T�X�\�d�d�p���������������������������������������������������x�|�x�|�x�������������|�|�|�����������������������������������������������������������������������������������������������������������������������  $$$$$$$((($$(((($$   $    $$ $($$($$(((,,,(($$$   ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������   �������������������������������������������������������������������|�������x@��,��H`��X���������D�����������8����������x��� ���$�p���H�p���h�h���4\�	�
l
|���h����p�H��4���|������������(�����������h���(���\�
��
�	��4�	��<tl#�&t%@ �Dx\
�0��`x�X	������L�h��ڰ�8��D�|�����D��� ���l���\��(� �@@���<	��<#�$�#@"��$h������t�\�����L�l�������8�(ؘٜ�0�h�4�0�����������l�0�x�(������
��L h! #l$�!x$�
���d�4  ���\�������`���H�����P�d�X�(��߈��l�h��0���������0�$���|,8 �'�*�&�h�����$4�x�����`����|�8�Lߤ����D������D����������8��\<0����
L
�
t��$'�"L(d�
� �d�L0D���`����d��ی���`�����D�l����X��������P����������(
���P���D��P����x��(�������������x�����P�0����������,���������$�����H��!<#|l�
�tdXHT@H,< �0�<�����L�8���,�8��<�p�����������8�l���h��t�
`	$�\|
�lH�t')�#�tD�  ��� ����d���H������ ��X�\����������H� ���X���(��h��� `��tH�L�,#�#t �H��	��H�,�����p�����d������H�T�@�8�P�|�0���d����������,�t������� ��h8�$����x����H�������l�l�������$�D�����D���d���������L�\�������4��`����|%P%���T���<(L�0X��(�P�X�t�D���$�@�l�h����������h�l������H�P�����(
x	��

��\��%�$�`� ��l�� �X������������(��p�,���D��x�8�0�������t�h��������L��	�h4�`�lH�
�	T���� �8T�`�|�P�����X���h�������(�h�8�,ߐ܄ވ�8�\�8��������@h���\�P 
 8\�� X$x"h0
���
txh������P���8�����`�x���d������H�Hݤ�P��������L�
�����L��
�L�"�&\$��$T�
�$��PL��	����������H����h��H����T���4��P�$��D�L���X��X�����8�\\�`�<\�
h �������h���H����l���$�\�l�H�H�$������4�L���`��$�������������`
��\�����8@
�Hx�L\@\$��L�d���L��t��`�8�����@�������������d���@���������
4��<�x!<�$8�h
�,$0������H���X��@�������������|��L�H���|���d���4�l
t�	�L�
�
���@�������H���$�X�T���P���,�8���h���d���x�d����(�����p�X���T�����$�	hT�p�pL��
�P������,�
L��D�@�,�D��,�l�L�������8���D�4����<�4����������������0���X	<�����l���
���P��|��\������<�8����(��� ���l����T��L�L������
�pT�@��
L�T�4� 0�p
x�@�\��0t|h�P�t���(�@�L����� ���P��p�\�$�����`��� � �`�|D����\��8���H���X��@���������|�4������@�x��h���������D�l�0�������L�x�����T4���4`�
���	�8
h�48X�
�H��������t������$�$�X����8�(���,����4�h����� ����\���	��
p4�$���
��(�����0<����������x��|����p������������$�0������<	�
 \�d�	�	�L
4Dp��TX�����H��<�������������0��T���t��4������l�$�$����������Tl
t@�����	��|
(�(�$���������l�����L�����L��`�$�<����8����P�������������P������<��h	�\
�����p		�	�	���(�
�L���L�0������x�������<������t�|����H�����`����4���t�`�@8�	 �p��
@	�����H���P�p�8���0�t�D���d�T�D������������<���T���� �@�	�4�	�	�X
�P��h�
�
�
�Lx��`�,��4����������4�4���������H�L�������0�D���H���h�8�����
 Dx8�\x|0	
\	h��
H�
�X�����(��������<��������� �T������ ������X\$`���<���0��p8	�8X,��L�\P�����p�l�D�$���d�D�����T�\�4������x������������0<�@���\���	
88
tp

	4��l�l��������� ��������@��������x�`�L�(�����x�����@�������l� �P	�	�	�(lT����l�(
�
�	��� ���������d�����@�l��� ���<������t�����X�D���,���p���d(\�
t
�P
<
P����p���,�����\�������4����4�d�h�4�p��t���������$���4���``t�����	��
TD
���,�����d���������������������p����������h�l���x�P��<�x��txhP�@\����T��	�T�l�<��$����4���4���,�4������|�t��h�x�0�L�\���������d���`���(���t��	
�����\p$D�hx��������L���X�����0������������$���@���\��������T�8��0<�\� �	D
���LhD��<l`���d�d�p����������������(��������������x��T��$�<t\���\��`��D�L��`�h�,���p��������������<���<�T��D�l�h�D����������4���������T��(���T,(`<<�L������0���,�l�T�$�L���X����x�\���$�d�������H��0���H��0L�4�,��d����t<������l��t<����h�P����������H������T�p������T�X�t� ���,�\����P`�4 �4$X�<�L �h0����h�d��l�t�h���l��D�P�����������������T���\���(�X�H�x�\��@�Pd�l�<�H �\0@��������������d��H������������$���������������pt��p��X�$�P0lt����8@�4HL�������,�������4���p�8�,�D�0����������X���d����D�����D`�l<��h�T��� ���| �����<�T�����X�������<���,�,���,����`���������|������P���xPH$�<l��l�x�������|�����������@�������������d������������������H�\���|Tx���t�������HpH�0��|�X��������8�������<�������P�$�L���8�������4��t ����(d���@���X���L@���d0����<���������(�4�4�H�h���x�8�������(�X�x�����H����px��ld�� <(���x$��������������d� ������(�\�������������������������0l������xP<Lp��|����P������������������������������x�h�`�t����������������������� 8DThx�pT@40,($$0<@4����������������������������������������������(0$$,<LPH<,$��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$$,,$  $$,, ������������������������������������������������������$,0@XhhX<,$$$44 ������������������������������������|�����������,HH4  ,48Hp�����xhL(������(,������\�4�0�H�\�d�p�������������|�������������,x�������X@L|�������| ����������������������<������������t�����������������������0���4XL�xx��������0������`������0�x���l�8� � ����|�D�\���(�x�����$���XP���h� �H��t4���T����l���8�����L����������X�P�����P�x����4�h����T��8(8����P4����D��`�����������������d�������������p���8������P���D�T�$���8�����(8L��x�$��p����L|,L@t������4���(���D�X���D�������4���p�������@�p�����d�`��p���L��0������|`@��|�����@��X������������� �H�,�,�h���`�����|�����`���0�����D�8�h�txh�D��0hLt�\�����l������\�X�����p���P�����������X��0�p�H������0���0�@��DLp0h�D��(����,�����l�����T���0���`����p���H�P��������$���l�d�$�@�����t���l�$��T`�<�D�t�D��DXPh�����D�|�L�(��������������h�`�������h�x�,�����(�x����(��X�4�L�� �$,�Dl������������X����������������� �����������0��������8PH�P��H���\8������l�����<�$����������������,��(�H�L�8������(�p�����L�d���T�d��L����X<L����d8x��������������������l���L��L��������������x�0h`,�8���4D�����`
$
4���p�(D�(������\�������t�\�@��`�����`��� �����d�x���D�x��H�x`DD��	L�	�0��d�@�����pd����(�l�L��,�H�|�l����h�������d�l�p�������������d<H�h��( ���@\	,	���( ����l��@�4�t�$�����������h�(�<�x�P�P�@�,� �����@���p��P�����0� 
�$
p�	`t�t�T��d��$D�������t���`���L� ��p���������@���h���p��������t�����P,
�
l���`�|����0|HHH�X��0�,� ������������������`���<�H�d����������(���T�0`�	0H
X�
8
$
	�P����������@��8���0���T���<��������������\�����8�L�P�d�$�d
�
l�
��	X�����(�4
4�	��$���8�����4����h�������4��������4����������d�Xh���|�D`H4�	�H �D
�	�l��P�tP��X,4���������@�<���������$�����������(���0��L
	�4����8l�\��h
� ,�$���� ��0���T�\���x��|�X������������D�����L���l�0�� �X��
t
(��
�
���T(��
�
�(t���l��<�����������t�|���`��l������P��L����������������,�0���@�p�	�`���4	��
�P������h�0����T�P�x���������\�t�T�$�$�� ��X�4<	�t�`D��	������
,�
D�0�d����4 H�P��������`����`�������8�����(��������	\� l
T
�
��	���
d�\����`���X���������L���<����d�H�����������4�0���������H���x���	�Xl�$|���	��� ���l
���l�|�|����������0���<���p��P� �x����8������8�������	��
��0L��h
�4�T�L�t��,H������������8�h�L�`�\�,���d�������X�@�|����D��x		<
�
(	�8	������(�8
�0� ���$�8��������D���D�����t�d���L�X�4�X�@������� ��,����8�4�
�p�h4P���|4
$(h���$X��|����������4�H�p�`���@���d�����l�����������<�p����P�$xX
T4�������``�x	�t	�d$
0D��0�$��4��H���<�������|�����@���X��$�h�H
�
�d�� $8����@@�����P���`����l����d�����T� �������l�����d�H�d��t�H�T�@�� �p�lx�d
�����|�l���$�H���@����$�t���\�x�����H����L������`���,�x��� �t������������XL8�` |�dD����l
|L���`�\�����@�H�0��� �����X������@��|�p�T�,�D��	��(�����	��
����!�����d
�hP	��	������T�|�T�D��������(�P���l�����������8�������pL��
`�H
�L
`	��8�d�p���Dp�����P�T���P���������T������0���<���h�@������$�����0���\�D��|t(�P(p���	P�|D�$����@����,�����������T���������x������������<���8�D�� ���	<`H�!�$!�H
��8
�Ht<�����,�����8��H�����l��(�@���������t��|���(
l�H
��
��$�&H"���0`
pD�x��L�HL����p��� ��|ڰ��D����d�(� ������$�L�T�0��@�����������

�8�������
���������t�0���P�����|���$�d����0ۈ��4��� ��4������h���,������ �$�%���
p��8�(`�|���d�l� �H�<�|�|�|���(�4���X����ڄ������<�p�`
�
��x��	�
���!)*�$�P���
T@�	��
�8X����D�p��|�����4�<�0�����H��t�����4�����$ �����
�
��0�"@#D lHLH	����������������L�P�����,���Tߔ�\��ޤ���0�����<������L�0�,�Pt����X����\�`P�T����������������P����$�������|�0ܠ���������p�l���������\ H!'�& �p��
�	��|�0��������ޤޠ������X�P�����h�8�,��l����H�`�
���
�	T�T0
X� L&&!����<	�������Dx��0��������(�8ܸ�@�h���L�,�X��� �H���<�8�����,����|�\\����P�`������<���������T��� �����<�8�����ـ���H�l���X��8�����4������T8�p�!�%|$<@���l����l�(�������p�x��L�(�|��� �����L���T܀����d���$h��
\��\��|@ $ )l'� �@ P�dp\@
�@��0����������P��l����L�<������������������8��
�
�
�(�!� ���������x�X�$�T���|�t���`������0��ܘ�����,��d�l�������<���T����$
�P"$%p"8�(�L�(���h���������@�������h���|���$۸נ۸���H������
������t�
�d�d4&L*�&X��X|	d���T�T	P��D���������$���\��������t�\��� ���������	,�4�
�
��
�
|X�@#8&d#`���Px�(�D���d�L�H������� ��ݰ���� ����(���h�����4���L��T��<
�\��T�XL���4HD��$4��������t�\�l���H����$�t���@������t�����D���T��L`�������\
X�dh$`&�!t��
�� t`���@���,���8�X���(�����D��4����t����������<��
X(tl����H�L�&(#�P��h0|tP
�
X�H���<������\�8��@���@������h�����h�����p���PtL��l���8� � p����	l�x�H����|�����<���d����8���\�8�@��ް����� �l�t�l�(���P�����t�T����  �
$
��T��L|P���4�<��������<��������H�����t�4���8�����������H8��4����
���8�!�"��48X|���\
�
	���(���H������������\����P�@�$�x���,�l���h���L$��
�
�(�
D�����|�Pp���x����(�����������l��x������ ��$�(�,����X�8���P��� ���X�� �TT(�	�	��� |��(������������D�4�������x�d�P��\����l�<�\���X<� D�d�����`��h"�!$�\
�l
L�P�
P�H�d�`�4���d��h��d�|����L���D�������l�T�\���T������D|��
�
T
�\��  ����
���`�h� L���D��H�������������d��(�,�@������,��������LT�dL��
�hX����,��
���|���l���������� �,����H�<���@�|������@���,�����\���������h�Xd��	�	�xd�
�0 p��������t�T�,����,�L������8� ������<�,� ��p	��	��l�
x�0P� �\��@
l�`��px�	�`��p�l�`�x��������������������������D������$����x
�`D
\	X��4�LL�p�h������<���������h�X����������������t�,�0� ���p���x�(�,�������@����l�	((	l
p�8`p<�	���@���������T��������������,���������D���(�h��Tl`������`�
 <���h�	�	�	$����P`�0��h���0��T������T�������������(��8�������
�	$�t 	X

l
�
�����$�
|	���4���$<�������h���L����������0������,����@�0��	�@Dh D�Xl8
��d���x����x���������`�(�4����D���h�T��\���������d����������0����xD�
@�d |�
L	���	�	���
8L��0�0���,�����l��D������p�P���0����L��P����������$��Ll�	�����dp
	48`�����������������\������X��8�������0�P�D��X���|������@��
��4		Tl�	�
t�L�4
L
����d�<�d���������L�d���0�����8��h�t�8�4���������<�������p0��� ��(
�t��T	D

8
��
`
�	d$�����L�(����@�������$���h���������������0�<���l���8�4�D��\40@< <0�D��tX�0�h��4�0���<�����������������H���������P����L4	(	��`$�hX�����
��
�	,@0������L \���L� ���<�x�L�����t��� �4��x����T�X���h�$�(��p
�
(

�
h
���P��	 �
xx
(��������$�(�$���������,���p����\�X�8����T���h�l�X�X$x���������x\	�
�\�
�
dXL,t�Ph	�h|������l���<���<�������`�����t�����`�H�����\���|@���$�$�<�`	�4x
�Ht� T����@�T���`���t���4���@�������������H�P������x���4�t�xD�X�d�,�	�
$
0	�������������������������L�(�H���<��������X�|��������H���X����h���`x< ����4|�0H��l�x��8�����,���`���������������T���`���D������(���|���h$ �D���	��,��� |D�� �p�,������D�����(���������d��������T�����X���8P(�L����@ �����`�����,�������h����P���\���T��������P�d������� �4������\����TTt�p�x d84��h��P���`�L���<���`�������������t�D�����X�T�t����h����H����|�������@p�d��� xh,8��<\�����H���t��H�<�x�<�0�����d�D���p���0�H���������xx�����t��� ��D$�����|������h� �d���x���|����p�p���X��(�X�$�t����������,�p4Hd @��|����������������h�8���X�������<�`�����D�@��������������������� �l��T�|����@x����L�T�������T�����P�H�����p�������@�|�����������t���` ��H��<�X��|xD\���h�,����d4�H����4�l�p������������0����D���T�����0�����$���td�xp��0��h$��d �X|��� �l�����h�t�������������������������������`�L�l���|�D�8���t<����� ���8`TP|��$`��X�<�$���������d���t��������h������d����������D�x ������h��`�$�4����@(P����0������$���������4�X�\�X�h�����D��������H�������4����XL\lh`|� TL����8������,(��������x� ������$�,�8�`�����������|�������������(p������pD(4\�������h ��������������������������p�l�h�T�D�P�x���������������������(L`ht���tD$(,0$$8LH,������������������������������������������������ 0, 4LXTH<0(��������������������������������������������������    �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $$$  ������������������������������������������������������$,4@HLD0  480����������������������������������������������$8<($(,0Dd���dL@4����( ��������`�T�d�|�������������������������������T��|lhplL00X��������8������������������������T� ��������(�x�����������������������,�������`Tp��������T������t�@���L�������x�D�$������h�h����t�����<hh8����L���(����<����@8����L���� ���0�(�l��������� �L�P����X�T�����(�d���D�48�������D�@L��dt��������(,����������������������p������p�������������pP������ ��0��4lp�����������������x�������T�,�����������l������������������`�8�,�h��`P|�dP�tL����P���P��� �@���|�����8�$�4������l���h�H���8���tL���d`�,\x���|X��h����������x��������|�����\����(���h��$�|��� �@����8�����|<8����H�H���PH��T(� �x�������������h�h���D��h�H�D����\����0�l����������p��x�������P�,��`��� T�L�<d�h��x���4�������������T�(���8�H���x������@���8l���0�����L@�4��|��P�����(�\t���������@���@�H�|�H�h���� ���,���\�������0����`�@,�(�����l �������������p������\���$��X���p�����0���������`�P�0���H�<�(��@$����8�h�\@�4��DX �����D�\�(����������� ����(���<�4������8������H�$����������$���d	�	�dPx��8� �$�� �,�����$����$�������`�|���������$������T�l� �x�������T��
l(
 ���8�h������t��(������4�����������`�����������(��������h����@0p�`@�h<	�	�xpd ��l������8����������T�8�8���������������D��������P�������X��4Tp|	�
,�	�|�<���<(�8�X�|�p�����0���0����0�����0�4�T�@�� ��l��\�tHp���8��\XP,	h�tl	X�dLl��������D�����4���8��l���l�<��p���h���������8�������LP�p��� ��t@����Dd
�	� ��(����x4��������4�������H�0�h�D������������������p���D��t,	�	�	D
��
���	�
L

�
�T4L��h�����\�����H������d�<���8�p����H�l��������|�����`��d�D�l�	�