rvoip-codec-core 0.3.8

G.711 and optional G.729/Opus/AMR audio codec implementations for RVOIP
Documentation
��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������XlP�������x���t8�(�L�������h�|�h�4�L�����,���<���t���<���0��|�p�`����(�(����l�����$��(�|x����x��|T�\hL�|�d��������x�8�����$�|�|����`���$�8���$��
|
��$(L�	T���%�(�&0"p�0������
 ���|�����݌�����8���\��|������`�8�,���@��X
 l|X(��H �H$�%t$("t�P�	��0�T�x����������,������ݬ��x��ڴ�P��t�0�4����������d����D�p d"$�#��( �P\�4X$�0���X���`���L���|������P��8�\�(ٴܠ�8�P������� X��P���h�0
``<"()�+�(�!XTP�`�,��T�����<��`ڔ�D����0�����\�����@���T�����<�����$�(�	4	���
��#\#d 4�8����� ����|������4�ߘ�P���@���d���L��������h�<��L�d��T�|p`t
� 
t�<����	��l����D����`��������0����H�xۜ���d�x���P,�(���D���
���0!�&((�"`��	�	d($
@$d��	�8�p�t��@ߘ���l������������l�x������\�l���4������P	�
8
���&�)�%d$��
������	�L
�`�d�����٨�(��\���8������\���P����0����L�x��h8T��8
lXh(!���|�,���\�<����������X����������ۨ��ڀ�p���8�th����(�@������d� ���"H&&����	d�`�$Phl����4�<���t����������������`���x�وج���X��������	���h\����#�*�+�%�pH�
��T�L��
P<���t��� ��,�L؄�X��������X����L����`�l� ����<���d���
�
P�#�$(!d,88��P�����������X�x�<����0�4�D�,�P�X�����<�,�P��h�X�����D���8��dP(8 Tt��	H �,�����������D� �$���p��P�\���l������d�h٨���H����h��	h��|���H8%�*�)p"p��
T	X\T4
\�dDd�t���������h��L��@��@�����hߜ�d�4�|�p������x
�|
��
�
P '4'4"t�$(�@���x�@�����<��������,�hߐ�������������$�d�t�����t��4�(�,��\
�
0@�0�\X|��x�(�<�������`�������H��x�p���xޜ�����������������\�(�XH�h�$!�#�!d\��
��

�����X`<�`�����$���P��������D�t���H����p�t�������h���
�dH��(\	����"�&p$`�4��X�\��	����������X���������\�������������l�����t�\� �,�	x��l
�
�H
�

HP�| t�X��
p�`��h�8���T�0����`������x��L����`��t�����X����������L�p�Ld�D(	��0�d��
�<�������L�<�4��l�������0� ������d������(� @\4(����x�	$L4���!DPx�

	x� X
�H
�4����,�$�H��P� ����,�@�0���0���8�(�<���\������d�
��
\8
X
d��<�8����	x8�����dT��x�������|���X�������������������,�T��,���`�	\Lh�< 
tl	���T�������D���t���\������P����������d� �d����������H�l�`�x�`�4���`�	t��Hx��@d	�	�	����X���@����8����|�x������������p����(�����8�x�4x��
8
l���l��
���x�@�������H0|��D(�d�����������������x� �|���������X����$�������@
�������	T����@
������X���8���x����,�������,��l�(�X����p���t�����L����������	�
@h�4��h���	�
`
�
�
�lp
D,���l�\�<�@����0��������(�l�x���<�����h��\�(�x(x�����	|��8�`�<
L	�t�h�	4
 ��������������x�d�|���d���X��������P�X���	��
X�H�,|�L�Pl�(�L��<� ��$���������0�����,��$������(������d���,���<� ���(�����8L��P	
�`��
8	�T��p��������������������X���<������|������l�L�X��tX�(�h��D
� ��txt�
x8T���
l4���(�8�`������������\���l�D�����4�|�d��������hpx�,,P���`
�
��t��	������0��(����P�|���$�������|������������������@�������L�p8	��
\	�,	�	��`�$
�
\�(��
��t���4�4� ����|����t��H������,�d���d���L�(�$�l�L�\�0����`�<4,
�
�
 0
 
�����p�	h
	0���0�(���������0���\�����$����`�(��x�4�d�H�����ptl\��D�h��L0�pxd����,�\�4�P�<���P���|������������t��������H�0��$��\�������(,$P���\`H�,�
�	�TL���������T����� ����p�����<�d������L��h�����x�T�,��������������h�	�	$
,	�H$��4����$	�d|��$���������,��|�$� �����0���4�|�������8�@�����@Tt��\�0�\|�|`
<8
�P��p�hL@l<�4���,�����������t��������X����������������������@p����D���	�������������\�����������������8�`��������@���h�<����������|x�X�`d��<����XxT�����@�����H���`�p�8������T������� �0�|���8�����8��`�����������l$�@ $��p \@d0(P���\�������������l�l�P�h��� ���T�4�,��\�P�����`�ddl4��4<�p���L,�\��L�������4�T���8��������������t�$�X���P�P�P�4�P�������Dt8t�T�,D���,d���4������x�����T�$�L�T����p�x�l���H�h���t�������T����d���\���l��������8<|�<|d@X�XP�P���H�8�����l������������l�T�0���t��������������T��H����<0|�0�P8|�����L8�0TPx��������l���,���D�8���H�H��� �������d��`����p��L��Tll�d8��x�d�������L��4������0�P�d�����H�������<���d�x����L�d�����������l������`���P���`���|�x�|�d�4�,�h�����|���`�����������P���|���������������P�d���d�$L���|�������4p\�t����<���������D�`�H�$��$������@�X���$�t�����p��@D|��� ���0���t4����`�t0������|���������<�P�T�l�������t�(��$�\�������p����t|�xXDh�������D������������������������\����,�8�@�X��������������������� h��������P0<Xtthlt�h0��������������������������������|�l�d�x�������,4,(HX`l����hH80(,0$������������������������������������������������0<4$  $,8L\d\PD<0 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ $$  $$���������������������������������������������������������� (8D\hhX<($ ,<<$������������������������������������������������Hd\D0,440,<h�����thD������ ������X�0�,�@�T�d�p���������������������������@��������dP`��������� ����������������������`���������������`�����������������������H��(H\D��l`x�������,����X�(�������L���������l�P����p�4�@����\�����D���p0 @t���h��d$��X��0����X,��p���������`�������\��������P�T�������,���|,�t8����l``0��<��<�X���������������h�������|���������|�D�������P�<�H�<����(������0`|D���T����(�\��������x������|���D�����h�����������`�����p�P��|���`��,�`�H�����P�T������<�����4���0���<�<����������8���p�����l���D������|���X���X<@�4�t\t������8����p��0����������@�L���L�<�����,�������0�8�H���,��\@Dt4x��(�������l����������t�@���D���l�L��������d�����L�������������,�����4��`�T$h�H�pl (��\����X���������l���������0�����X�T�4���������|�$$Tx8��8D��h�DT�p���������l�h��(���8�<���<�(�t�,�(������H���t�8���<���`�0�����Dx�(TD������� ���������|�����d���H�H���L��������h�P�<�4� ����������|������@��l�L0d`�$����dT��t���������������������0��� �������|�������������HpL�|���(4���4D	�
T
\�L������t���x�����p����0�����(��������������l�<�4�����$����@��P�\$t@	�
�
l	�8��T����<<$����t���������x�`�� �h���@�d������� ������(���T��\h0l(���x�$		��	4`p������������������������X�����������������x�@�������l�$���8��d��	���8	8l�8�D���($DD�����������X���������������`����`�\���T������P��0P��8\�	
��$	�l8�TPx������������,�<�����8�����������\�T��������������	�p,���(�hx	�LT�
X	�4��`�����<�T���L���$����|�����L�� �8���0�����|���t�������(	�
�
D�p
,�hX�,	 	�P	�
�
|$l����t�d�����������������|�P���@���L��T�L�0�����0������������
��p�����TTh�d�$D������\�\�����H�����P���p���<������p���H�8���H	�����$�TX	D
��0
X�
d	 @�d�X��l����������D�������������������X�,�����t�������
�0�
H�
�
�D$�
L
|
t<X
�
��������x����L�������\�H�L�h�t����4�,������������������TX�
�
��� �	d	�	� �8�
��@������0���|���������������l�T�$���0�@�P������ ,��8��H���	l
h
Lx<8��l0
$�d�H����0�8�|���4�@������p���h����d��������x������ @
84\��0
l�	�l 
�T�4,H�T
�t������P���D���������L�h��L������X�������P�������(�H���0�h��
��x���T`
X���
�
�	�	�@(H�X�����8�������`������t�����$�����|���(�����,(H���<�
H�
\��($\L��T	l�|\ x�������������<�h���0����0�$�H�0�D���H�$����	(�T�	�	�
D�	D	4�X�<�p�
�x�D���H������������h�����������$����<�������,���������,pl���h�\��	�(d���HX(�����D���,������,������0�|�����������(�`� ����D����������4L��P�H�P����
X	�
����
dP�����$������<�������@�d�x�T��H�������	�
\
�	@,�4T�tH��$(�	�����L���������� ���@�T�����,�p������D��� ���L����d�P���0��t`<<�����l�@�P�8���P���P����p���������d���d����� ���X�������������@�	���@�tX��
tD4��`�H��P�����X���@����P�X����L�0������� �@�l�������
����\8�
�
�����!���H��
�	�H�t	�	������\��0�H������<��p�����T������`�L�(�X���`�P�
,�
���
�4�P����������P������D�d��0������H�d��$�8�h������X�8������������\�$,�(�P�8
\	��Th��x�������P�4�����p�L�����������l��8�������0���`�0�d���� ����d��!8$�0XH
|
 �H���Th8���x��������L�����t�����$�(�l���h��h��@�,�HP�����	0
�L�\��$�%!��T�
T����ht�(����$���\��dިܠ�4�����8����d�������������HP
��|�0|���
��`|$h�8��D����� ���\�X�t���P�<�t���@ߤ�x��ۀ�����������D�@�t�X��x��T
(D ,�$x&$!��
��,0�xH@|	h�`������������0����P�t���@�����H���0���@����0$��	xT���!L)@*4$tL�<�
t�(
d���X������ۀ������h�@����@�H�8������d�����lT�h�|�����#�# th�	��,�<���T�(���4�����$����Dް�ި޴�0�p��l��� �4�|�����������d�(<�����H�L<���D��h��l� �����|���l���,���d�����(�T�t��pڤ�����������pp���8�p�T�D �%�%8��|hl�	4
4��������(�����4���<������d�����`���4�T��4�$���<���4��D���\ �%�$�|���	��(�d��P�d������������@�|ޠ��`����D��������,�|�������P4Ht���0��L�������d����<���|�t���p��� �t�������$۠����|������\���p�$������\	d4,�� �$8#��x
�
���40xlx\4����,�����x�$�|��8���,�h���4�D����X���X�D����P�	�(8
$���#p(�&T < �	���h�P
 �,���0�\����`�\��p�D������L���D�`�l��������(��	��0��<4�@|�� ����������������������|�����8����P���x� �\�������(���`�������|��	�H���"D \	
0�(d��H(d�������h�t���L�(����������8�P�x�,���|�����x�� 	4����(t�,�%t)8&\����hddP���D�d������������D�p����$�\�����0�����������|
�$���8\�
��`�#d&#��$�P
���H�L�p�D�\�x�����d���������t����������0�����8��������\(�$�T�P�8$������� T�
���P���l���X�x�x���h��(��@����ڤ٨�������4�(l(�L���@�
�dh�%T'#`�dh�
t,�x�x	� ������������L�������`��ܨ�������|�t�0�`�HX�4�8 �')P$p��xp��\
L
�pD���h�����P�����$����H���,���P����\�����8� \`t<(�8�l\4�������� �0���������,�D����h������|�t�߀�l��x���P�������d�P�x�t����88�dTt��������|����D�4�X��x���<�4���������� �����$������X���@��	,��8	�
x0��!X"�H|��x
h�
�������D���T���D��������t���|�����4�h���@����l$����@x
0p��4�`����8��������X�4�����L����P�x����������X�l�4�����l�P�8��8�D���
�$|�T,�|�
�
H�H��$�Xh�d�����d�8�D�������,�0�D�l����@���0�����������8�����Pp�t�!� �l
� 
(
L�	�p�p�D��p�|����,��T������D������(�h����P�����
�t
LD�	�pL8T��`d��L@� d�4�p�$�L��������,��d�x�D�x��� �����t���t�������<����$�	
����t���xl�$�X�x���$�\���������X��������(�\��P����������d���p�<�\��h Hp`�\��P�
L
`x
�� �|����d������ ����H��������4�����`��h�����H�����Tl�
H8����<�
T��@�d|��
�
H����\�	�\����0��������X�����p�x�����,����T�0���t8���
�
�$	�,���x 40	���������4������� �(� ���p���P�X����$�����x���(�,���`�����d�8���p���
|\
,d��l|�<	�@�P�������,�X�������\�@�|�\�\� �p�������������8����� ������0�
P$������
�
D�	p��	(
X$L���,���@� �8���$�������������8����������<�@��
��
``�
(
�
�
�0��
 lh|���X�����D��0�������H��4���d�h�������P�,������t�����	�@Th��h$8�	|
\�,�D@
���p�����<���4�\����d���L�0�D�����p���<�������8�����0�p�� ���	�
$�����<�x	
�	�	�T�p\\�����h�������<�h���H��h�8����8�P�|���������H�,���t��	4\@�\
�L��T���4���������8��H�p�P���L�L�(���D���������������(��
��	���l	@pP	8
P�0�
$
p�	����@���������t�l���4����������0���T�������� �d���x�t�@����\�\��
D0
�  
H	�$�	 
�	 
�h
|
d
��X���X�@�<��D�������(����4���,���,�����d���4�p\ h������P
�����|8�xh���l��D�4���������|���������������h��@�������������hl�X�P	X
����
P	��������������������P���4�0�����\�T�����8���(����8���������X�t
�
�	�	x
�
���L��	�
�

x
<
� �������P�@�4�������������T��x���������������8(���0���l��L
l�
�
|��t�$�(�P	xLp����������������d�|��|���<�\������T�����,���`<�0L8��X	8T
�
h�,��Ld����0h���D�`�(��� ���p���P�|�h�0�������P�4���x���l�����D�h(��<�(l��	�
�	��LD�$����(��`�(�����4�8���h�d���(���������������D���$�����t����t����l���T�P\��44� ��������L���������$��������,�L��H�����4������|��4��hh��Xd�		<l�@��0���,���(���P�,������@�t���������H���\�������<���H�<�������0����0(�$�������X�h��������X�4���8�0���������|�,�l�����������8����������|0�p��`�T4D��8|`����L�H��P���$�x������0�����������h�����\�����P�H�������\�dt��LpL\$����4�\�������<�������X�(�4�@�������T���4���|�D�P��H�|���@�� x��� ��8L�X�4$\����� ���(�����H������H�4�L���t���������(�H���8d�L,�$pd,D����l�$��������������������|�T��� �������X�d�<��������������,��0���h���l��`��PHl(\����(�� ���4���@�x�����H�,�������@�4�0���$���t������h���h ���$������H�L0��\x�T�@�� �`�,���4�|���������� �H�d����0���T����� �����,���lL���dHH,���l��|@�,l��X�T�������������������,���t�p�t�|���$���h�������h�d�d�P�0�<���P��������P\l���,`��,�����������t�����0�������X������@���������Hpd������L��`�����xdH(<���p����0����������X�l�h�h�t�l�8���������$�l�����,����P4@T\`x�LL ���l(��������,8, ����8�������$�8�d�����������x�|�����������h������d4(P�������T������������������������t�|�x�h�X�d���������������������$H\hp���pH0048,(4HTL,����������������������������������������������,88$  (<P\XD0 ������������������������������������������������������(0,$  �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $$(($   ��������������������������������������������������$,8HTXH0 $04(����������������������������������������������,@@,$,08Pt���hPD4������ ����������h�`�l�|�������������������������������T���lltpX<8`�������x8������������������������X�(�� ����8�������������������������$�������dTt��������X������p�@���H�������p�D�(������t�x����t������� HD������D���p��| ����pTh����\����L�����p�����������@�P����d�`������ �`������������|� �(,���|x��������(������������,�������������X���h���8��������������`4���������,������8@`������������<������`������T��,�����������������$�$����L��l�|�hPx�X<ttX����X���P����8���������`�<�<��d���������������pT���dP�$h������P������x����h�8���x�<�����D�������<�����8�X�������<�����p�t�|�4������(�,���������������P�`���t�H�������l�\����|�������4�(�D�(���L�������(�`��`��T���X�8������<�������(�,�@����,���p�<�������t�������T���tX�PH|������` p���`���4t�����l �������0�D������T�(�0���4������P���@�p�$���0�8�LL�$�������X��� `���������0�������\�0�T���d�����`���������<����(�����|�`���t��XP�$�0����0��`|P���,���0�<���(�������X���D���(���4�D��H���H����������T��|�h���p(P���pl��`4��������<�0��������������<�����h���h���X�����������<�� �0��l
�
H	<�����h����8dX��������������������������`���������������d����\�PH�T<��$�	8
d	�H������X�<���T�������0�H���x�P���,�<�����$�����T�,�P������������DXD�
�
x	�,l�t�\8D�8�� �t������|�������h�����4�$�|�����������D�������$����\XT8	�@��
��@���8���D���`���(��������|�����p�4���L�<�D� �D�������<�t��88��h�p �
�
\�
�	��`����t�@�����x�T���8�l��T���� ����0�����������������|���h���
�
�
��x	�8�l�	�	�	�
�t���d���`�������H���d����X���h�����`�������`�����\ �������	�
���D�
�	�P����x|	������D���@�����\����<����(����d�\������ ��H�����T���\
�� 
��
������@����������8�|�d���8���x�������P�p����0���,��,��p�<�l��PD�hD��DH��|���|�����$l�8�4�@���(x�����X���<P�x�8|�<����\���x�����������$��Tt�(������$dx@�����l�00����p48l��hH<8<@00DDLD@<,<H<00<T\L8(0$����������������������������������������������������������������������������������������������������������������������������������������������������������������t�p�p�x�x�l�p���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������  ��������@0�4,(\|�`T�|��X�����$�����������H��t����h�\���L��@���8����������� �������������(�t�|�t�  \���4l��������������l��������������<�l������d�D
�(����@8�� (�+�)�$����XT�,���@��l�<�\��ܸش�(��(�������������8��`��l��|40 �� LL�$tX%t(�'%|!� 
���|���|�������P�������ݐ��֤�\�@�`��������������������D��,#t%@&�#0�8� ��|l���������|�L����<�P�����p�����|�|����\�����(\���p���<����8�&$*�%�h�
`�	�h�	� �@��4������L�t��(�d����l�T�X� �T���,���D��4����4�	�	��T�#�&�#� ���h��0��8����d�����d���`ڰ�����h��(�(�H���h��D����@����� ����t�x�\�\\| X<��H��������x�P���������(��P�`�H���0���\�\���x�\���������4���0�p ��<"x$ \X
�x�
hp,��4����$��P�H�����4������8�t���d��|�T��� ���������
���������&'�!�t�����\
4
� ���D�T�������D���\��p��D����P�����$�\���0�D�������t0�
�
� �!dt��|X
��$�D���d�|���0�H�����T������X�<�L�l�t�`�����H���h�������$���,����,x0��8\��\<P,�����@������d�D������d�<�����h�ۀ��D�H�����|t���`�dt��p"�'`'� (��\
(	��	xH,��\�������Dܔ�p����4�|������l�$��(���������$�P�P
	�D,$�#t�$����L�X�|�������0� � �0�8�`�`���� ��������<�$�`�����x���d��	����l���,�	d��p�D��L�,������$����X�D�$���H������݌�t���,��h�����|���t�$���P
�xD�!@%�#T�L
0
�T@@�
X��
p���������������� �����T��X�t���8���������|
�
4�H���Xp��!�&�$4����\���X�
(	X����|����`�p��ߜ����H�d�����p�,�t��T��(��D���������d�l	((�<Ltt�X<
4��������$�������4�������$���|�,���@�(����������������8������	l��`�
0�,����@\�����4�L��������T������������$�T����8��$�H�����t����
�
� p�� d�ht@

 ����,4��P�,�d�����$���d� ������d�d���h�@�����(l4
��
<
H�
, d ��h�`�
���x������8���`������D������t�<�t� �d����T���t�<���������
<,D��h0��	d��x�|�$�4
���P�t���<�����T������h�|�$�|����������<���h��������,� `4H�<	�	�
	L	��h������\�������t��p��(�0�|��������(�����������0���
�	����0�D
��������d
�D�����P@�0��������<�����D�������� �P���8������L�,pHt�p���D�4�� $��D�|�<�P�����h������x�D�`������P�|�����l���@�x�@���4���D����,�L8�
P���
D�
����
���\������������������p��@�L� �T����\�����4�	�	��xP��	8T
|<�� ����
�P����	� t���`�������4�$��H���\��h�x��� �����������D
4��P
�	�
H	��d
���`��8D�����\���l�����(�L�����h�\�������x������4�$�\�X������� �|�0����l��<�X��0��8�l\�@�P����������@���x�(��\����$�,����D���P�������8��|���h���x	������4	��	�	�H
�<���|�����d��@��(�|�|��������� �����4���H�t��lp$��($|H$(P���
4��	�4���p����X�����d�x���P�������8���H�0����8�������L��	�d�
�
�����0�
X��
�
<l
�	����������������@���`�����T�����$���0����������X�<���,����	 �`H��\`���4x�	(�	�����x�d������p� ���$���������t��h��4������`�H���L�	�dH<4\�		L$������`������l����l�8�t�������������4�������X�,�d���|(\
�	��\�Th��	L
�$��$�	@`\�������$�\�������p�� �P�� ������0�x�p���8����������������,��	�	<
d<���`| ��	
4x�H�������P��������������d���|�����P�(�x�T���<�4���4���(�h�(�
D
<�
H�<�`48����x�� ��0�������������������<�x�X�@����X�h���<���D������$4	���
��<��T��\��H�����������������H�8������������������\������t���TL���PTP�<�@�$�� �4��4�p�<�P��������X��d���@�0���`��������d���T�����l��(�d���L<�l��
 �	���D�h�4���p���X�h�x���������|�����������0���t��T���|�������0��� ��
�
<	��L���4�8dD���\�\�D�����X�l���h�h�������h�������������d���$�t�@��h�������(�l���P�p�(���@�����d�����x�d�$���8�8��<�t�\���|���0���X������P���� t�,�D8(�T0����x��|����(�����8�(��8���L�$�,�����X�t��������p��<����PX���t�L��\���������\�4d<��x`���4�0�����������,���������,��<�\�T�l��`���$������4���H(h��L�dl���8�8��d�p�L���(���(�D�����P��$���p�������T�x�l�����0� �TD��(H������D$4��������(��������(�����D��$���x��$��<�0�������xp��X�<�����@�0�P(\@h����T`�����t�����L�d� ������x�l���t��H�����t�X������x���$p�tx��H�������H��|H(��|����� ��X�������\�������T���|���������0�����$����`���,��4L��(�,�H�@�$�,�x���������@���������l���@������������������H�`����`��@�����`�T� ��p�P���������p���`����������L��<���4������� |��8��D����x��@����X��Ht\��������4��������@�L�H�`���������L�(�@�x���������d�������t@$@��������T������������������������p�(������4�l�������������������������D�������|D$,DX``dx|h4����������������������������������t�p���������������0DP`t���`D440$,@H8 ������������������������������������������������$ ,,08HXXL8($$���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� $( (,��������������������������������������������������������$,<XddX@4($(8<,����������������������������������������������0D<,$((0Hh�����t`D ������ ������l�D�@�P�\�h�p���������������������������<��������X<Dp��������$����������������������l����������������h�����������������������D���0TH����������0������X������0�x���x�@� � ������H�T����d�����l��t<@t����0����T4(��8(x��T �����d���L����������X�\����\�p������H���pxxD $,���`�( �����8��T�x���������������P�����������������`������H�����$�H�8�$�d��� 4Ht�x�T$����� D�L�������8��0���<�P���L�������@���x�������<�t�����p������l0��D�������xp0��L�T8X��@�������������4�\�0��,�D��D�p��x�L���������������8���XP<�$X�L�Ld������4����<�H�����X���4����������������4��\����,���0�0�T���\4������$�����$�H��������� ����4�(�����x�����x��������4�<�����d������,��8�TD��X��X8�����(������$������T�����`���������`�H�(�������$���P�$$@X ��0l��x�$H��T����0l�������|���T�����D�8�\�,�P���x�8�8�0�������������`D�h��hT����x@��0����l�H���������,������l����������`�����h�X�����\�(�l�4�t���T����HH���h@8��D���<�����������`����x���4������D�<����<�\���0TX�L��������\H�	�	���T�� �L��\� ��|���x����� ���P��L�(��|���������$��<��x�D��tP�X	4D
xpx�������p�����h���@�����D� �����l���0����T����T�p�����������44t��P4��l8��	x		<	l	dx\��������`�����(����� �,�`�����$�$�L������������������`��t�����,�lD�	�$
�@
0P4�\�D�,��@���T�d���x��H�������T�����`���L�������4������lH�(D��x�$$
�
��p	�0�D����P  �$�������h�$��d�����L�T�@�����P�<�H�������h��Xl	�@�x0���� 	T�
���
�	����T�����������l�����(��l���`�8����������� �d���X�����l� <	�
�
d�

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

x,��H���X�<���`�t������4�X��(�L����(���T�� ���Ptl	�� 
�
l`Dl$D�
�$�8���� �D(T���t�x����P���������(�P�������$�8�����d��4�
th0
`
0�
�
�����x�(�$P�l���l�p�4���$���X����0������`��$��@��|�������������,,��HH���
�$��
@�
@T��
�p����T���,��$�d�������h�x� �������������x�h�������8�|	�� `H�p��$	X�����0\����������D�������|���@�x������T����������(�	��4�	�	t�	0T	X�@�d 
4�������h��x�����X�<�L����L����@��\��������t�(�l�0�L�8������@
0L0< ��tp0T�p0����\�<���<�T������P�����t���P���d�L�<�P����p���p� ���������������l��x	@��P�
�T�0�@�L�������H����\�8���H������4����H�4��	@
��X������0��(d�X
4L�`���������p���\������x�����L�h������x������H�X�d�L�DH@P��`
H
�P��8��P�,`���d���\�P�l�����������8�<��������\��,����������8�l�����L���4 ��@��h�dP�<h`H
��@���0�����$�����D������t�\� �����<�<���8�0����<��	�@�t�	�
H�8#!�`�h����	�(Hl4���D������D�X����P�|�`�0��������������������t
�
``l	�����T���l� ���t�����8�@�|�0��l�����D��t�@���P��<�������d��������l������\H�L�0�0@
�	H��T,���D 0��4�D�`�`��|� ����h�p�����`�H��ޘ���������L���L����P	�DX8!0%�"4�t�p�X�dt��,
������������ ���������������(�`�h�����l��h�
T���	$
|�
P�$|'$$(����\x������� ������,�������p���������\������������P��8���(�
��X�t��H\�	��|������T����h�x���d�l��������P�4���,���P��L�t�x�������p�4�������� ��(����#�#�4D
�
�p��
h|xl����x����p� �����������4�$�D�xۘ�����h�������p`�h(
��$� �' (�!T���
�|��	T	D������X�T��ۤ�����`�x����x�|�� �4�������d���XLt��x
��t""����� 
����\���`�0������(���`������D��ވ�(�4� ���������h�d��������TD0P���(d4��|�8�������H������(���������t��������8۔�`������x��`��D�@��,	D��$�$|\��<P	�
�H
�t�x��\�@�t� �l�0�������D���h�����4��P�L�$��������	@
�
,�L0��#�"(p(|���h���h���(��4��T��Dܜ������`�@�@�����������|�@�D�H���H�T������P����D��L�����l���,���@�H��������<���,ݘ���������|������Dp�������
hX��!&%���\(�X�4����8�����P�$�$���������P�����4���݄��L�P��������
��@<(���h!�&�%HX@@4�	H�X	�p����t�h���ܨ������<���D�������x���������P��	��h$�0\,�
�@��0 ��Ph�
x����H������4�l���\�d���x�����0�T���t�������,���������d�����\����� ���X
��|�����
�����L�L���������t�@�$������$�$݌�\�,��������d�	8h���h��T|%�(&��0������HX������$�,������ބ��\���D�����������D�<��p�xX�� �
L�x@�  %�'x$0T����@�����,���������������H߰�4�(�����������T�$�� ���0�H�
�<hhH,��	<
�T8(�(T@ �����4��|��L�����������������������x����D�0�������l
����P$&� |L�
�t
�
��,,0	������8���t����������h��H����`���D�L��p���< � ��h
Xd��X@&(#`�|��4������	P
�8��t�L���D�4�d�����������h�d�����L���t����� �p�X\�����L��P� 4lX	��D����T�����,���D���������`�t�|�<������0�������������p�`��`���4�`����,�DH���D�����,��������\��\�8�p� ���tެ�T������ H	�
(D\@	8P`�#�%�!|(�T�
$�X	�4
L ������P�����T�`�D���(�4�l����d������`�����4�L
�h
`�
����� ��\l������������<������P��H�@��H�P���������� ���L�l��,�������H�hpXp�$��X|
t<T$�����`����(�����h����\�������4��\߀�������� ���������X���x���\ ��\t
��
�
�
��Pl�$�d�H�8��@�������x������D�<���`��\��@�`����@���<l	|�H�
��d ������
�l��������@�t�(�����p�\�`����\��x��\�\������P����0����L�0��d�L
��d�,�@�x(�P�0���<� �d����������P����x�(���T�����������X�H�����0���8D0\ ��d��
�	�	 (
X��
�,�	���p��$�d�������,�H�\�T���|�H���`�T������������ �8��H�	l������
l�	x����
����������t���P��� ��d���`�d��������D�,�P����\<l
���
`�	LL��,���0��������@�t�l��� �������t�8�t� �\�������p���x���d���X�����`�$�8�� �
`L	�
������,
t���������<��x���X�D��� �H���p���l���t�h�T�������D(d�����	
X�hx�`	�	�	�H��
�
\�����`�������|���$�L�L�P��8���\�d������t�����X
�
�D�	�
D���(�l�\�d
T����@�p�����������������T�����t�D�����D����|���0���h���<���
����Lh<
��`L���p����d���\�`���|�<�\��<����\����0�@�<�8�x�������l����D������D��
X�0(�t
 	 
0�
	�d

�
�
�\�������L��������t������d����l�8��4�4�@�����t�(�<D	T

���hD�`	�������P|�����p�$������@���D���d�����H���D����8�������$x���
�
<�
 	��	T��,x�
�
�����T���������������@����������T��8�����(�<�t� �����������P(���
��t	�8 <	�	\	�	`x
p
�	$������ ������� ���d�|�����x���,�\�$�������P����@�l������	P��������`8��8(����� ���|�x��������$���X����� �����H�����P��	�	h�X<��X	�
4 8L@0
�t(���|�����T���(�$�����0��������\���L�(���H�H��T�����@�@��D
�

(
�
�
(	\t��H
�\�
\�����X�� �`�D������ �H��������$��������h���<� �$��<0�������p�dX	�
��<�L<�<���T�	�����D������P��� ���`���T��������P���t�8�d�������d�� t��@���
<
0����@� L�H�$X�X���|�����T�|���������t�|�������T�����H��`�`��|,�`��|�	�

�8,������x�8�� �������h�������@���L����$�����,�`�������t�������$���`xX	����H��8�������8��������`��|���4�������h�`���L�X���4���\���0�x�����L@�d��t	��@��0����,�������x�p���@�������4�X�4��������������h�(�������<�0@����L�T@�4��(���0�t�����<��������0�|������<���p�����������h�����x����P���p8�8�$D��@l��8x�������<���������������x���������T�H�h�����d�0�|�����4�p����H�@��������X����X�����|���������<�������p�h�\�0�(������8�H`���H��h���Hp�Pd�����������<��p�����h�`�4���p���������H���L����,���D�����������t����pp$��l@L<�H���������L���$���$����8�������L�����@�L�@�������8�����`�L�����`���0��������H����� ����@��������h�l� �������l���0�,�������X���X��d$h�x�(��,���d�T�@ld��<����<���l���x���8�P�x�������0�������p���L���x\4�x@@D �x(���H�4t��@�8�t�������������t���<�������������$���H�����|�d�p�����|�|���d����������$PPH`�d�@��<� ���������`���p��������p�@��(��� �������8TP������T��H���H�|dhldh���4����\���������`�����h�`�d�T����������T�������@���p80Hdlh��H<���d,������(TX8������x�$������0�@�L�h�����������p�x�����������$p������|T<Hp�������l(����������������������x�t�t�d�\�l�����������������(H\hx���tP448<80<P`\<������������������������������������������������,(,DTTH80(����������������������������������������������$(((($    ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������     $$$��������������������������������������������������$,4@LPD0$480��������������������������������������������������,4( (0Dh���hP@8,08,��������h�\�h���������������������|�����������P|�|ppthP88`�������|8����������������������d�,�������,�|�����������������������$x�������P<X��������<����p�\�8���8���������@�������x�p���4�������H��P��`���x��� ����D x���L���� ������8����������@�X����X�P�����,�h���X�dp4�������P�DH��hp������XT(�����������������p��|���H�������� � �P���������X�h�����4LDl��$�0�����������(�\���p�\�8�������|�t�0�x�t���������4�D�����D�4�p��\<`lD0d�XD����T���8�d�������L�����d�\�x�X�����T�\���������pX��(���Hx����x��<����� ���d���\� �p��������8���x����D�p��������P�����T�<4����l��(�`D����P�p�|������������p���H���<��������d���$�D���`����������8�����D���0�����4�h���<����0�h������d���������h�h���$�����������<�|�,����`�`l������(�l��8����X��l�X�������@�����P�����������X���<�������p�������\����l��8�|0LX(�l����x�8�� t������|���t�h�����������`�������������t��t�P�0��8���p���( ����(�����������0�����0�$������������D�\��<����|���`�����t�D������`��H�	x	D�P��$�����8�p�h�����L�P�0�������8�4�X���8�|���4�|�����������hl�P`T��0\L
�
d	X�\�����,xp@�(�����������0�P���������������T���0���L�(�����T� (8<��t��H(
<
(	D$�Px�4����X�����������������|������0�$��������x���������x�h���`����L��	�
8�	���� �$��4�t�������|���d�����L�����P��������\�H��$�4���������0���<(��@	��
�
�th��� �,��@,<�H����8���X������|�d������p�������P�����`���p��pd�`��8T�
�	��<������P�,���������,��������l�������L�������t�`�������8�L���4	�	�	�	l�	�dT�(	x
@
�	H
8�
`��������X���@�����<�����x��(���d�8�P�\����D�������t��l�	�