kStatus GoSetup_SelectBuiltInEnhancedSurfaceFlatnessFilter	(	GoSetup	setup,
		GoRole	role,
		GoPreFilterType	type,
		GoPreFilterLengthOption	length
	)

Selects one of the builtin enhanced surface flatness filters to use, if device supports enhanced surface flatness filtering.

Check that the device supports it by calling GoSetup_IsEnhancedSurfaceFlatnessFilterSupported(). If enhanced surface flatness filtering is not supported an error code will be returned.

Caller specifies which type of enhanced surface flatness filter to use and the length of the enhanced surface flatness filter (number of filter coefficients).

Do not use this API to enable custom enhanced surface flatness filtering. Use GoSetup_SelectCustomEnhancedSurfaceFlatnessFilter() instead.

Version

Introduced in firmware 6.3.1.83

Parameters

setup	GoSetup object.
role	Determines which device to retrieve the value from. Use GO_ROLE_MAIN or GOROLE_BUDDYIDX(buddyidx). See GoRole for more details.
type	Prefilter type other than GO_PREFILTER_TYPE_CUSTOM.
length	The number of filter coefficients to use in the specified enhanced surface flatness filter mode.

Returns

Operation status.