/**
* <summary>
* Changes the electric signal sampling method to use.
* <para>
* The <c>HIGH_RATE</c> method uses the highest sampling frequency, without any filtering.
* The <c>HIGH_RATE_FILTERED</c> method adds a windowed 7-sample median filter.
* The <c>LOW_NOISE</c> method uses a reduced acquisition frequency to reduce noise.
* The <c>LOW_NOISE_FILTERED</c> method combines a reduced frequency with the median filter
* to get measures as stable as possible when working on a noisy signal.
* Remember to call the <c>saveToFlash()</c>
* method of the module if the modification must be kept.
* </para>
* <para>
* </para>
* </summary>
* <param name="newval">
* a value among <c>YGenericSensor.SIGNALSAMPLING_HIGH_RATE</c>,
* <c>YGenericSensor.SIGNALSAMPLING_HIGH_RATE_FILTERED</c>, <c>YGenericSensor.SIGNALSAMPLING_LOW_NOISE</c>,
* <c>YGenericSensor.SIGNALSAMPLING_LOW_NOISE_FILTERED</c> and <c>YGenericSensor.SIGNALSAMPLING_HIGHEST_RATE</c>
* corresponding to the electric signal sampling method to use
* </param>
* <para>
* </para>
* <returns>
* <c>0</c> if the call succeeds.
* </returns>
* <para>
* On failure, throws an exception or returns a negative error code.
* </para>
*/
public int set_signalSampling(int newval)
{
if (_func == null)
{
throw new YoctoApiProxyException("No GenericSensor connected");
}
if (newval == _SignalSampling_INVALID)
{
return(YAPI.SUCCESS);
}
// our enums start at 0 instead of the 'usual' -1 for invalid
return(_func.set_signalSampling(newval - 1));
}