<custom>
    <property type="integer" internalkey="AUDIO_CBUFFER_SIZE" key="audiocbuffersize" format="definewithvalue" name="Audio Buffer Size" defaultvalue="320">
        <description>
            <![CDATA[
            <B>Set audio output buffer size</B>
            <P>Set the size of the audio output buffer, measured in number of audio samples not bytes.</P>
            <P>Recommended value - 320 words.</P>
            ]]>
       </description>
    </property>      
    <property type="integer" internalkey="CODEC_CBUFFER_SIZE" key="codeccbuffersize" format="definewithvalue" name="Codec Buffer Size" defaultvalue="4096">
        <description>
            <![CDATA[
            <B>Set codec input buffer size</B>
            <P>Set the size of the codec input buffer, measured in number of 16 bit words ie 1 word = 2 bytes.</P>
            <P>This parameter impacts the robustness of the decoder to jitter and its latency. Larger values are more
            robust to jitter but have larger latency whilst smaller values have lower latency but are less robust to
            jitter in the data rate achieved by the source.</P>
            <P>Recommended values are:</P>
            <P>Maximum range and robustness - 4096 words</P>
            <P>Standard Latency - 2048 words</P>
            <P>Low Latency - 1024 words</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="COMFORT_NOISE_GAIN" key="comfortnoisegain" format="definewithvalue" name="Comfort Noise Gain" defaultvalue="0.0">
        <description>
            <![CDATA[
            <B>Set Comfort Noise Gain</B>
            <P>When the data supplied to the decoder fails for some reason, eg out of Bluetooth range, the volume of comfort
            noise that should be played. Set to 0.0 to output silence in the abscence of data. Range (0.0 - 1.0).</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="GOOD_WORKING_BUFFER_LEVEL" key="goodworkingbufferlevel" format="definewithvalue" name="Good Working Buffer Level" defaultvalue="0.65">
        <description>
            <![CDATA[
            <B>Set the Good Working Buffer Level</B>
            <P>Input codec buffer level required before decoding starts. Decreasing this value will reduce the latency 
            of the decoder but will also reduce the tolerance to jitter in the average data rate. This should be modified
            in parallel with considerations of the size of input codec cbuffer, see stream_decode.asm documentation.</P>
            <P>Recommended value - 0.65 (65% of the buffer size)</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="POORLINK_DETECT_LEVEL" key="poorlinkdetectlevel" format="definewithvalue" name="Poor link detect buffer level" defaultvalue="0.50">
        <description>
            <![CDATA[
            <B>Set the Poor Link Detect Buffer Level</B>
            <P>If the decoder runs out of data it will look back through its history for the recorded buffer level. If the
            buffer level was below this value it will flag poorlink.</P>
            <P>This form of checking is required to differentiate poorlink conditions from normal operation such as end of 
            track.</P>
            <P>Recommended values are:</P>
            <P>Maximum range and robustness - 0.5 (50% of the good working buffer level)</P>
            <P>Standard Latency - 0.7 (70% of the good working buffer level)</P>
            <P>Low Latency - 0.7 (70% of the good working buffer level)</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="POORLINK_PERIOD" key="poorlinkperiod" format="definewithvalue" name="Poor link period &#0181;s" defaultvalue="1000000">
        <description>
            <![CDATA[
            <B>Set the Poor Link Period</B>
            <P>When poorlink has been flagged the decoder will not release the flag until a good data rate has been
            continuously sustained for this duration, measured in micro-seconds.</P>
            <P>Recommended value - 1000000 &#0181;s</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="ZERO_DATA_RATE_STOPPING" key="zerodataratestopping" format="definewithvalue" name="Zero data rate period playing->stopping &#0181;s" defaultvalue="150000">
        <description>
            <![CDATA[
            <B>Set the Zero Data Rate Period (Playing->Stopping)</B>
            <P>During the "playing" state if no data is received for this duration of time the decoder enters the
            "buffering" state. It assumes the source has "paused" and so should output silence until the good working
            buffer level is restored.</P>
            <P>Recommended value - 150000 &#0181;s</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="ZERO_DATA_RATE_BUFFERING" key="zerodataratebuffering" format="definewithvalue" name="Zero data rate period buffering->playing &#0181;s" defaultvalue="200000">
        <description>
            <![CDATA[
            <B>Set the Zero Data Rate Period (Buffering -> Playing)</B>
            <P>If the input buffer has some data in it, and the decoder is in the "buffering" state for this period of time
            without receiving any further data, then the decoder plays out the input buffer. This is mode of operation is
            required so that small audio clips which would otherwise not reach the good working buffer level are played
            out as they are received (i.e. not queued up until the good working level is reached).</P>
            <P>Recommended value - 200000 &#0181;s</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="WARP_RATE_HIGH_COEFFICIENT" key="warpratehighcoefficient" format="definewithvalue" name="Warp rate (high) coefficient" defaultvalue="0.015">
        <description>
            <![CDATA[
            <B>Set the Warp Rate (High) Coefficient</B>
            <P>A measure of the amount of warp to apply when the buffer level is out by quite a lot, 
            see stream_decode.asm documentation.</P>
            <P>Recommended value - 0.015 (1.5% per 1kb difference)</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="WARP_RATE_LOW_COEFFICIENT" key="warpratelowcoefficient" format="definewithvalue" name="Warp rate (low) coefficient" defaultvalue="0.002">
        <description>
            <![CDATA[
            <B>Set the Warp Rate (Low) Coefficient</B>
            <P>A measure of the amount of warp to apply when the buffer level is quite close to the
            ideal, see stream_decode.asm documentation.</P>
            <P>Recommended value - 0.002 (0.2% per 1kb difference)</P>
            ]]>
       </description>
    </property>      
    <property type="integer" internalkey="WARP_RATE_TRANSITION_LEVEL_WORDS" key="warpratetransitionlevelwords" format="definewithvalue" name="Warp rate transition level (words)" defaultvalue="100">
        <description>
            <![CDATA[
            <B>Set the Warp Rate Transition level</B>
            <P>Set transistion point from using the WARP_RATE_LOW_COEFFICIENT to the 
            WARP_RATE_HIGH_COEFFICIENT, see stream_decode.asm documentation.</P>
            <P>Recommended value - 100 words</P>
            ]]>
       </description>
    </property>      
    <property type="text" internalkey="WARP_RATE_MAX_RAMP" key="warpratemaxramp" format="definewithvalue" name="Warp rate max ramp" defaultvalue="0.005">
        <description>
            <![CDATA[
            <B>Set the Maximum Ramp of the Warp Rate</B>
            <P>Sets the maximum rate at which the warp will be adjusted per second, see stream_decode.asm documentation.</P>
            <P>Recommended value - 0.005 (0.5% per second)</P>
            ]]>
       </description>
    </property>      
    <property type="list" internalkey="WARP_FILTER_COEFS" key="warpfilter" format="definewithvalue" name="Warp filter quality" defaultvalue="1">
        <option internalval="cbops.warp_and_shift.medium_quality_filter_coefs -DWARP_FILTER_LENGTH=cbops.warp_and_shift.medium_quality_filter_data_size">Medium quality</option>
        <option internalval="cbops.warp_and_shift.high_quality_filter_coefs -DWARP_FILTER_LENGTH=cbops.warp_and_shift.high_quality_filter_data_size">High quality</option>
        <option internalval="cbops.warp_and_shift.very_high_quality_filter_coefs -DWARP_FILTER_LENGTH=cbops.warp_and_shift.very_high_quality_filter_data_size">Very high quality</option>
        <option fake="">Custom</option>
        <description>
           <![CDATA[
           <B>Set the Quality of the Warp Filter used</B>
           <P>Selects from different filters available, the high quality ones consume more MIPS.
           If you choose 'Custom' you must define WARP_FILTER_COEFS and WARP_FILTER_LENGTH:
           <BR><CODE>.define WARP_FILTER_COEFS  your_filter_coeffs</CODE>
           <BR><CODE>.define WARP_FILTER_LENGTH your_filter_buffer_length</CODE></P>
           <P>applicable to your filter in the application yourself, see cbops_warp_and_shift.asm</P>
           <P>Recommended value - High quality</P>
           ]]>
        </description>
    </property>
    <property type="list" key="debugmode" format="define" name="Debug mode" defaultvalue="0">
        <option internalval="DEBUG_ON">On</option>
        <option fake="">Off</option>
        <description>
           <![CDATA[
           <B>Set <I>application</I> debug mode</B>
           <P>Specify whether the <I>application</I> is in debug mode. Note this does not necessarily mean the libraries
           will be in debug mode. However if any library debug features are to be used it <B>must</B> be set.</P>
           ]]>
        </description>
    </property>
</custom>