mirror
/
sane-project-backends
kopia lustrzana https://gitlab.com/sane-project/backends
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność

genesys: Remove obsolete comments

merge-requests/105/head
Povilas Kanapickas 2019-07-27 10:12:30 +03:00
rodzic 107019c5de
commit db2bb793d4
9 zmienionych plików z 4 dodań i 36 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

3
backend/genesys.cc
Wyświetl plik

@ -1657,7 +1657,6 @@ genesys_average_data (uint8_t * average_data,
* scans a white area with motor and lamp off to get the per CCD pixel offset
* that will be used to compute shading coefficient
* @param dev scanner's device
* @return SANE_STATUS_GOOD if OK, else an error
*/
static void genesys_dark_shading_calibration(Genesys_Device* dev, const Genesys_Sensor& sensor)
{
@ -2931,7 +2930,6 @@ static void genesys_save_calibration(Genesys_Device* dev, const Genesys_Sensor&
* - gain calibration
* - shading calibration
* @param dev device to calibrate
* @return SANE_STATUS_GOOD if everything when all right, else the error code.
*/
static void genesys_flatbed_calibration(Genesys_Device* dev, Genesys_Sensor& sensor)
{
@ -3064,7 +3062,6 @@ static void genesys_flatbed_calibration(Genesys_Device* dev, Genesys_Sensor& sen
* During calibration a predefined calibration sheet with specific black and white
* areas is used.
* @param dev device to calibrate
* @return SANE_STATUS_GOOD if everything when all right, else the error code.
*/
static void genesys_sheetfed_calibration(Genesys_Device* dev, Genesys_Sensor& sensor)
{

5
backend/genesys_conv.cc
Wyświetl plik

@ -313,7 +313,6 @@ static void genesys_shrink_lines_1(uint8_t* src_data, uint8_t* dst_data,
/** Look in image for likely left/right/bottom paper edges, then crop image.
* Since failing to crop isn't fatal, we always return SANE_STATUS_GOOD .
*/
static SANE_Status
genesys_crop(Genesys_Scanner *s)
@ -360,8 +359,6 @@ genesys_crop(Genesys_Scanner *s)
/** Look in image for likely upper and left paper edges, then rotate
* image so that upper left corner of paper is upper left of image.
* @return since failure doens't prevent scanning, we always return
* SANE_STATUS_GOOD
*/
static SANE_Status
genesys_deskew(Genesys_Scanner *s, const Genesys_Sensor& sensor)
@ -408,8 +405,6 @@ genesys_deskew(Genesys_Scanner *s, const Genesys_Sensor& sensor)
}
/** remove lone dots
* @return since failure doens't prevent scanning, we always return
* SANE_STATUS_GOOD
*/
static SANE_Status
genesys_despeck(Genesys_Scanner *s)

7
backend/genesys_gl124.cc
Wyświetl plik

@ -908,7 +908,6 @@ static void gl124_setup_sensor(Genesys_Device * dev,
* must be halved
* @param color_filter color channel to use as gray data
* @param flags optical flags (@see )
* @return SANE_STATUS_GOOD if OK
*/
static void gl124_init_optical_regs_scan(Genesys_Device* dev, const Genesys_Sensor& sensor,
Genesys_Register_Set* reg, unsigned int exposure_time,
@ -1578,7 +1577,6 @@ static void gl124_stop_action(Genesys_Device* dev)
* target resolution
* @param *dev device to set up
* @param resolution dpi of the target scan
* @return SANE_STATUS_GOOD unless REG32 cannot be read
*/
static void gl124_setup_scan_gpio(Genesys_Device* dev, int resolution)
{
@ -1673,7 +1671,6 @@ static void gl124_end_scan(Genesys_Device* dev, Genesys_Register_Set* reg, SANE_
/** rewind scan
* Move back by the same amount of distance than previous scan.
* @param dev device to rewind
* @returns SANE_STATUS_GOOD on success
*/
static void gl124_rewind(Genesys_Device* dev)
{
@ -1709,7 +1706,7 @@ static void gl124_rewind(Genesys_Device* dev)
* @param dev device to park
* @param wait_until_home true to make the function waiting for head
* to be home before returning, if fals returne immediately
* @returns SANE_STATUS_GOO on success */
*/
static void gl124_slow_back_home(Genesys_Device* dev, SANE_Bool wait_until_home)
{
DBG_HELPER_ARGS(dbg, "wait_until_home = %d", wait_until_home);
@ -2307,7 +2304,6 @@ static void gl124_send_shading_data(Genesys_Device* dev, const Genesys_Sensor& s
* This functions moves scanning head to calibration area
* by doing a 600 dpi scan
* @param dev scanner device
* @return SANE_STATUS_GOOD on success, else the error code
*/
static SANE_Status
move_to_calibration_area (Genesys_Device * dev, const Genesys_Sensor& sensor,
@ -2887,7 +2883,6 @@ static void gl124_init_regs_for_warmup(Genesys_Device* dev, const Genesys_Sensor
/** @brief default GPIO values
* set up GPIO/GPOE for idle state
* @param dev device to set up
* @return SANE_STATUS_GOOD unless a GPIO register cannot be written
*/
static void gl124_init_gpio(Genesys_Device* dev)
{

13
backend/genesys_gl646.cc
Wyświetl plik

@ -350,8 +350,6 @@ static int get_cksel(int sensor_id, int required, unsigned channels)
* @param regs register set to fill
* @param slope_table1 first motor table to fill
* @param slope_table2 second motor table to fill
* @return SANE_STATUS_GOOD if registers could be set, SANE_STATUS_INVAL if
* conditions can't be met.
* @note No harcoded SENSOR or MOTOR 'names' should be present and
* registers are set from settings tables and flags related
* to the hardware capabilities.
@ -1346,7 +1344,6 @@ static void gl646_set_ad_fe(Genesys_Device* dev, uint8_t set)
* @param dev device to set up
* @param set action from AFE_SET, AFE_INIT and AFE_POWERSAVE
* @param dpi resolution of the scan since it affects settings
* @return SANE_STATUS_GOOD if evrithing OK
*/
static void gl646_wm_hp3670(Genesys_Device* dev, const Genesys_Sensor& sensor, uint8_t set, int dpi)
{
@ -1399,7 +1396,7 @@ static void gl646_wm_hp3670(Genesys_Device* dev, const Genesys_Sensor& sensor, u
* @param dev device to set
* @param set action to execute
* @param dpi dpi to setup the AFE
* @return error or SANE_STATUS_GOOD */
*/
static void gl646_set_fe(Genesys_Device* dev, const Genesys_Sensor& sensor, uint8_t set, int dpi)
{
DBG_HELPER_ARGS(dbg, "%s,%d", set == AFE_INIT ? "init" :
@ -1498,7 +1495,7 @@ static void gl646_set_fe(Genesys_Device* dev, const Genesys_Sensor& sensor, uint
* parameter to work effectively, hence the redirection
* @param dev device to set
* @param set action to execute
* @return error or SANE_STATUS_GOOD */
*/
static void gl646_public_set_fe(Genesys_Device* dev, const Genesys_Sensor& sensor, uint8_t set)
{
gl646_set_fe(dev, sensor, set, dev->settings.yres);
@ -1509,7 +1506,6 @@ static void gl646_public_set_fe(Genesys_Device* dev, const Genesys_Sensor& senso
* limited to AFE for now.
* @param dev scanner's device
* @param enable SANE_TRUE to enable power saving, SANE_FALSE to leave it
* @return allways SANE_STATUS_GOOD
*/
static void gl646_save_power(Genesys_Device* dev, SANE_Bool enable)
{
@ -2135,7 +2131,6 @@ static void gl646_slow_back_home(Genesys_Device* dev, SANE_Bool wait_until_home)
* Automatically set top-left edge of the scan area by scanning an
* area at 300 dpi from very top of scanner
* @param dev device stucture describing the scanner
* @return SANE_STATUS_GOOD in cas of success, else failure code
*/
static void gl646_search_start_position(Genesys_Device* dev)
{
@ -2219,7 +2214,6 @@ static void gl646_init_regs_for_coarse_calibration(Genesys_Device* dev,
* We scan a full scan width area by the shading line number for the device
* at either at full sensor's resolution or half depending upon half_ccd
* @param dev scanner's device
* @return SANE_STATUS_GOOD if success, else error code
*/
static void gl646_init_regs_for_shading(Genesys_Device* dev, const Genesys_Sensor& sensor,
Genesys_Register_Set& regs)
@ -2775,7 +2769,6 @@ static void ad_fe_offset_calibration(Genesys_Device* dev, const Genesys_Sensor&
* genesys_search_start() must have been called so that the offsets and margins
* are already known.
* @param dev scanner's device
* @return SANE_STATUS_GOOD if success, else error code is failure
*/
static void gl646_offset_calibration(Genesys_Device* dev, const Genesys_Sensor& sensor,
Genesys_Register_Set& regs)
@ -3292,7 +3285,6 @@ static void gl646_repark_head(Genesys_Device* dev)
* initialize ASIC : registers, motor tables, and gamma tables
* then ensure scanner's head is at home
* @param dev device description of the scanner to initailize
* @return SANE_STATUS_GOOD if success, error code if failure
*/
static void gl646_init(Genesys_Device* dev)
{
@ -3962,7 +3954,6 @@ gl646_is_compatible_calibration (Genesys_Device * dev, const Genesys_Sensor& sen
* @param dev scanner device
* @param forward SANE_TRUE if searching forward, SANE_FALSE if searching backward
* @param black SANE_TRUE if searching for a black strip, SANE_FALSE for a white strip
* @return SANE_STATUS_GOOD if a matching strip is found, SANE_STATUS_UNSUPPORTED if not
*/
static void gl646_search_strip(Genesys_Device* dev, const Genesys_Sensor& sensor, SANE_Bool forward,
SANE_Bool black)

2
backend/genesys_gl841.cc
Wyświetl plik

@ -940,7 +940,6 @@ static void gl841_init_motor_regs_off(Genesys_Register_Set* reg, unsigned int sc
* Write motor frequency data table.
* @param dev device to set up motor
* @param ydpi motor target resolution
* @return SANE_STATUS_GOOD on success
*/
static SANE_Status gl841_write_freq(Genesys_Device *dev, unsigned int ydpi)
{
@ -4370,7 +4369,6 @@ static void gl841_update_hardware_sensors(Genesys_Scanner* s)
* @param dev scanner device
* @param forward SANE_TRUE if searching forward, SANE_FALSE if searching backward
* @param black SANE_TRUE if searching for a black strip, SANE_FALSE for a white strip
* @return SANE_STATUS_GOOD if a matching strip is found, SANE_STATUS_UNSUPPORTED if not
*/
static void gl841_search_strip(Genesys_Device* dev, const Genesys_Sensor& sensor, SANE_Bool forward,
SANE_Bool black)

2
backend/genesys_gl843.cc
Wyświetl plik

@ -1037,7 +1037,6 @@ static void gl843_init_motor_regs_scan(Genesys_Device* dev,
* @param ccd_size_divisor SANE_TRUE specifies how much x coordinates must be shrunk
* @param color_filter to choose the color channel used in gray scans
* @param flags to drive specific settings such no calibration, XPA use ...
* @return SANE_STATUS_GOOD if OK
*/
static void gl843_init_optical_regs_scan(Genesys_Device* dev, const Genesys_Sensor& sensor,
Genesys_Register_Set* reg, unsigned int exposure,
@ -3659,7 +3658,6 @@ static void gl843_move_to_ta(Genesys_Device* dev)
* @param dev scanner device
* @param forward SANE_TRUE if searching forward, SANE_FALSE if searching backward
* @param black SANE_TRUE if searching for a black strip, SANE_FALSE for a white strip
* @return SANE_STATUS_GOOD if a matching strip is found, SANE_STATUS_UNSUPPORTED if not
*/
static void gl843_search_strip(Genesys_Device* dev, const Genesys_Sensor& sensor, SANE_Bool forward,
SANE_Bool black)

1
backend/genesys_gl846.cc
Wyświetl plik

@ -2352,7 +2352,6 @@ static void gl846_update_hardware_sensors(Genesys_Scanner* s)
* @param dev scanner device
* @param forward SANE_TRUE if searching forward, SANE_FALSE if searching backward
* @param black SANE_TRUE if searching for a black strip, SANE_FALSE for a white strip
* @return SANE_STATUS_GOOD if a matching strip is found, SANE_STATUS_UNSUPPORTED if not
*/
static void gl846_search_strip(Genesys_Device* dev, const Genesys_Sensor& sensor, SANE_Bool forward,
SANE_Bool black)

4
backend/genesys_gl847.cc
Wyświetl plik

@ -1478,7 +1478,6 @@ static void gl847_end_scan(Genesys_Device* dev, Genesys_Register_Set* reg, SANE_
/** rewind scan
* Move back by the same amount of distance than previous scan.
* @param dev device to rewind
* @returns SANE_STATUS_GOOD on success
*/
#if 0 /* disabled to fix #7 */
static void gl847_rewind(Genesys_Device* dev)
@ -1514,7 +1513,7 @@ static void gl847_rewind(Genesys_Device* dev)
* @param dev device to park
* @param wait_until_home true to make the function waiting for head
* to be home before returning, if fals returne immediately
* @returns SANE_STATUS_GOO on success */
*/
static void gl847_slow_back_home(Genesys_Device* dev, SANE_Bool wait_until_home)
{
DBG_HELPER_ARGS(dbg, "wait_until_home = %d", wait_until_home);
@ -2454,7 +2453,6 @@ static void gl847_update_hardware_sensors(Genesys_Scanner* s)
* @param dev scanner device
* @param forward SANE_TRUE if searching forward, SANE_FALSE if searching backward
* @param black SANE_TRUE if searching for a black strip, SANE_FALSE for a white strip
* @return SANE_STATUS_GOOD if a matching strip is found, SANE_STATUS_UNSUPPORTED if not
*/
static void gl847_search_strip(Genesys_Device* dev, const Genesys_Sensor& sensor, SANE_Bool forward,
SANE_Bool black)

3
backend/genesys_low.cc
Wyświetl plik

@ -569,7 +569,6 @@ void sanei_genesys_set_buffer_address(Genesys_Device* dev, uint32_t addr)
* @param dev device owning the AFE
* @param addr register address to read
* @param data placeholder for the result
* @return SANE_STATUS_GOOD is OK, else the error code
*/
void sanei_genesys_fe_read_data (Genesys_Device* dev, uint8_t addr, uint16_t* data)
{
@ -1074,7 +1073,6 @@ std::vector<uint16_t> get_gamma_table(Genesys_Device* dev, const Genesys_Sensor&
* @param max value for gamma
* @param size of the gamma table
* @param gamma allocated gamma buffer to fill
* @returns SANE_STATUS_GOOD or SANE_STATUS_NO_MEM
*/
void sanei_genesys_generate_gamma_buffer(Genesys_Device* dev,
const Genesys_Sensor& sensor,
@ -1191,7 +1189,6 @@ void sanei_genesys_send_gamma_table(Genesys_Device* dev, const Genesys_Sensor& s
*
* @param dev device to initialize
* @param max_regs umber of maximum used registers
* @return SANE_STATUS_GOOD in case of success
*/
void sanei_genesys_asic_init(Genesys_Device* dev, int /*max_regs*/)
{