Manualinux
http://www.nvu.com http://www.gimp.org InicioPresentaciónActualizacionesManualesDescargasNoticiasAgradecimientoEnlaces

Entornos GráficosAplicaciones

DesarrolloEmuladoresInternetJuegosMultimediaSistema

GráficosSonidoVídeo

Editores Gráficos - PixelitorFiltros 8bf - 20/20 Color MD

Escanear en GNU/Linux - XSane




Escanear en GNU/Linux - XSane




Copyright

Copyright © José Luis Lara Carrascal  2007-2023   http://manualinux.es



Sumario

Introducción
Instalación
Configurar un escáner
Iniciamos XSane
Consejos para escanear documentos
Enlaces




Introducción  

XSane
proporciona una interfaz gráfica a las librerías de dispositivos de digitalización de imágenes: Sane. La tarea de escanear documentos en GNU/Linux nunca ha sido fácil por la falta de soporte de drivers de los fabricantes de estos dispositivos. El proyecto Sane desde su creación ha intentado desarrollar unos drivers alternativos a los de los fabricantes, a los que se les denomina backends, basta decir, que no se llega a implementar todas las características que soportan estos dispositivos cómo es el destramado digital por hardware o una mayor rapidez en la previsualización de los documentos. En algunos casos necesitaremos copiar el archivo firmware, que se instala habitualmente con el programa de escaneado que utiliza el driver original de Windows, al directorio /usr/share/sane/"nombre del backend".

En este manual, además de tratar la instalación de XSane, también explicaré la configuración de un escáner y algunos consejos útiles a la hora de escanear documentos, que puede llegar a convertirse en todo un arte.



Instalación

Dependencias

Herramientas de Compilación


Entre paréntesis la versión con la que se ha compilado XSane para la elaboración de este documento.

* GCC - (13.2.0) o Clang - (16.0.6)
* M4 - (1.4.19)
* Make - (4.4.1)
* Automake - (1.16.5)
* Gettext - (0.22)
* Autoconf - (2.71)
* Pkg-config - (0.29.2)

Librerías de Desarrollo

* Xorg - (7.7 / xorg-server 21.1.8)
* Gimp - (2.10.34)
* GTK+ - (2.24.33)
* Libjpeg-turbo - (3.0.0)
* Liblcms - (2.15)
* Libpng - (1.6.40)
* LibTIFF - (4.5.1)
* Sane-Backends - (1.2.1)
* Zlib - (1.2.13)



Descarga

xsane-0.999.tar.gz  |  xsane-0.999_libpng16.diff

Optimizaciones

$ export {C,CXX}FLAGS='-O3 -march=znver3 -mtune=znver3'

Donde pone znver3 se indica el procesador respectivo de cada sistema seleccionándolo de la siguiente tabla:
Nota informativa sobre las optimizaciones para GCC
* La opción '-march=' establece el procesador mínimo con el que funcionará el programa compilado, la opción '-mtune=' el procesador específico para el que será optimizado. 

* Los valores separados por comas, son equivalentes, es decir, que lo mismo da poner '-march=k8' que '-march=athlon64'.

* En versiones de GCC 3.2 e inferiores se utiliza la opción '-mcpu=' en lugar de '-mtune='.
Nota informativa sobre las optimizaciones para Clang
* La opción '-mtune=' está soportada a partir de la versión 3.4 de Clang.

* Los valores de color azul no son compatibles con Clang.

* Las filas con el fondo de color amarillo son valores exclusivos de Clang y, por lo tanto, no son aplicables con GCC.
Valores CPU
Genéricos
Intel
AMD

Optimizaciones

Optimizaciones adicionales
GCC
Graphite
$ export {C,CXX}FLAGS+=' -ftree-loop-linear -floop-strip-mine -floop-block'
IPA
$ export {C,CXX}FLAGS+=' -fipa-pta'
LTO
$ export AR=gcc-ar RANLIB=gcc-ranlib NM=gcc-nm
$ export {C,CXX}FLAGS+=' -fuse-linker-plugin -flto=auto'
En versiones inferiores a GCC 10, sustituir auto por el número de núcleos que tenga nuestro procesador. Si sólo tiene uno, utilizar el parámetro -flto
Clang
Polly
$ export {C,CXX}FLAGS+=' -O3 -mllvm -polly -mllvm -polly-vectorizer=stripmine'
LTO
$ export AR=llvm-ar RANLIB=llvm-ranlib NM=llvm-nm
$ export {C,CXX}FLAGS+=' -flto'
ThinLTO
$ export AR=llvm-ar RANLIB=llvm-ranlib NM=llvm-nm
$ export {C,CXX}FLAGS+=' -flto=thin'
La aplicación de esta optimización es alternativa a la tradicional LTO, a partir de Clang 3.9 y, por lo tanto, no es combinable con la misma.

Parámetros adicionales

Parámetros adicionales de eliminación de avisos en el proceso de compilación
$ export {C,CXX}FLAGS+=' -w'

Parámetros adicionales de eliminación de errores específicos en el proceso de compilación
Clang 15 y superiores
$ export {C,CXX}FLAGS+=' -Wno-implicit-function-declaration'

Establecer la ruta de búsqueda de directorios de librerías en sistemas de 64 bits multiarquitectura
$ export LDFLAGS+=" -L/usr/lib64 -L/usr/local/lib64 -L/opt/gcc13/lib64"
Cada usuario tendrá que establecer la ruta de búsqueda de directorios, en función de la distribución que utilice.

Establecer el uso de enlazador dinámico para Mold
$ export LDFLAGS+=' -fuse-ld=mold'

Establecer el uso de enlazador dinámico para LLD
Clang
$ export LDFLAGS+=' -fuse-ld=lld'
Optimizaciones complementarias LTO/ThinLTO de LLD
$ export LDFLAGS+=' -Wl,--lto-aa-pipeline=globals-aa -Wl,--lto-newpm-passes=memcpyopt'
Optimizaciones complementarias LTO de LLD
$ export LDFLAGS+=" -Wl,--lto-partitions=$(nproc)"
Optimizaciones complementarias ThinLTO de LLD
$ export LDFLAGS+=" -Wl,--thinlto-jobs=$(nproc)"

Eliminar los símbolos innecesarios para la ejecución del programa
$ export LDFLAGS+=" -Wl,-s"

Establecer la variable de entorno de uso de compilador para Clang
$ export CC=clang CXX=clang++

Extracción y Configuración  Bloc de Notas Información general sobre el uso de los comandos

$ tar zxvf xsane-0.999.tar.gz
$ cd xsane-0.999
$ patch -Np1 -i ../xsane-0.999_libpng16.diff
$ ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man

Explicación de los comandos

patch -Np1 -i ../xsane-0.999_libpng16.diff : Aplicamos este parche personal que posibilita la compilación del paquete con Libpng 1.5 > 1.6. El error que soluciona es el siguiente:

xsane-save.c: En la función 'xsane_save_png_16':
xsane-save.c:5103:23: error: puntero deferenciado a tipo de dato incompleto
   if (setjmp(png_ptr->jmpbuf))
                       ^

--prefix=/usr : Instala XSane en el directorio principal /usr.

--sysconfdir=/etc : Le indicamos la ruta correcta a los archivos de configuración de los backends de Sane, /etc/sane.d, en lugar de /usr/etc/sane.d, que es la predefinida del script de configuración, que toma como referencia la ruta del directorio de instalación del programa.

--mandir=/usr/share/man : Instala la página de manual del programa en /usr/share/man, en lugar de /usr/man.

Compilación

$ make

Parámetros de compilación opcionales

-j$(nproc) : Establece el número de procesos de compilación en paralelo, en función del número de núcleos e hilos que tenga nuestro procesador, tomando como referencia la información mostrada por el sistema con el comando correspondiente. Si nuestro procesador es mononúcleo de un solo hilo, no añadir esta opción.

Instalación como root

$ su
# make install
# ln -sf /usr/bin/xsane $(pkg-config --variable=gimplibdir gimp-2.0)/plug-ins

Explicación de los comandos

ln -sf /usr/bin/xsane $(pkg-config --variable=gimplibdir gimp-2.0)/plug-ins : Crea un enlace simbólico del ejecutable de XSane a la ruta de ubicación del directorio de plugins de Gimp proporcionada por el programa pkg-config.

Borrar las locales adicionales instaladas con la utilidad BleachBit

# bleachbit -c system.localizations

Estadísticas de Compilación e Instalación de XSane

Estadísticas de Compilación e Instalación de XSane
CPU AMD Ryzen 5 5500
MHz 3593.250 (BoostMax=4457.000)
RAM 32 GB
Sistema de archivos XFS
Versión del Kernel 6.4.8-ml SMP PREEMPT_DYNAMIC x86_64
Modo de frecuencia de la CPU powersave (balance performance)
Versión de Glibc 2.38
Enlazador dinámico LLD 16.0.6
Compilador Clang 16.0.6
Parámetros de optimización -03 -march=znver3 -mtune=znver3 -mllvm -polly -mllvm -polly-vectorizer=stripmine -flto=thin -Wl,--lto-aa-pipeline=globals-aa -Wl,--lto-newpm-passes=memcpyopt
Parámetros de compilación -j12
Tiempo de compilación 2"
Archivos instalados 158
Mostrar/Ocultar la lista de archivos instalados
Enlaces simbólicos creados 1
/usr/local/lib64/gimp/2.0/plug-ins/xsane
Ocupación de espacio en disco 4,1 MB

Consumo inicial de CPU y RAM de XSane

Consumo inicial de CPU y RAM de XSane
Programa
CPU RAM
xsane 0 % 59,9 MB
Para medir el consumo de CPU se utiliza el programa top, y para medir el consumo de RAM se utiliza el script de Python, ps_mem.py, creado por Pádraig Brady, que podemos encontrar en este enlace.

Directorio de configuración personal

~/.sane/xsane Es el directorio de configuración personal de XSane en nuestro home.

Desinstalación como root

1) MODO TRADICIONAL

En el directorio de compilación ejecutamos el siguiente comando:

$ su -c "make uninstall"

2) MODO MANUALINUX

El principal inconveniente del comando anterior es que tenemos que tener el directorio de compilación en nuestro sistema para poder desinstalar el programa. En algunos casos esto supone muchos megas de espacio en disco. Con el paquete de scripts que pongo a continuación logramos evitar el único inconveniente que tiene la compilación de programas, y es el tema de la desinstalación de los mismos sin la necesidad de tener obligatoriamente una copia de las fuentes compiladas.

xsane-0.999-scripts.tar.gz

$ su
# tar zxvf xsane-0.999-scripts.tar.gz
# cd xsane-0.999-scripts
# ./Desinstalar_xsane-0.999

Copia de Seguridad como root

Con este otro script creamos una copia de seguridad de los binarios compilados, recreando la estructura de directorios de los mismos en un directorio de copias de seguridad (copibin) que se crea en el directorio /var. Cuando se haya creado el paquete comprimido de los binarios podemos copiarlo como usuario a nuestro home y borrar el que ha creado el script de respaldo, teniendo en cuenta que si queremos volver a restaurar la copia, tendremos que volver a copiarlo al lugar donde se ha creado.

$ su
# tar zxvf xsane-0.999-scripts.tar.gz
# cd xsane-0.999-scripts
# ./Respaldar_xsane-0.999

Restaurar la Copia de Seguridad como root

Y con este otro script (que se copia de forma automática cuando creamos la copia de respaldo del programa) restauramos la copia de seguridad como root cuando resulte necesario.

$ su
# cd /var/copibin/restaurar_copias
# ./Restaurar_xsane-0.999



Configurar un escáner  

En este caso voy a poner como ejemplo un Genius ColorPage Vivid 3xe, lo primero y antes que nada es copiar el archivo firmware al directorio /usr/share/sane/gt68xx. Tendré que crear antes este directorio y luego copiar el archivo de mi partición Windows de la siguiente forma:

$ su
# mkdir -p /usr/share/sane/gt68xx
# cp /mnt/win_c/Archivos\ de\ programa/ScannerU/CCD548.fw /usr/share/gt68xx/ccd548.fw

Este escáner no necesita ninguna configuración especial, por lo tanto no es necesario editar el archivo /etc/sane.d/gt68xx.conf. Al iniciarse el sistema será detectado de forma automática igual que cualquier otro dispositivo usb.



Iniciamos XSane  

Basta escribir el comando xsane en una terminal o en un lanzador para que el programa se inicie de forma individual. Para usarlo cómo plugin del Gimp debemos de seleccionarlo en el menú de este en el apartado: Crear >> XSane: Ventana de diálogo de dispositivo...


Captura - XSane - 01


Captura- XSane - 02


Captura- XSane - 03




Consejos para escanear documentos  

Esto es fruto de mi experiencia a la hora de trabajar con el escáner, y si vamos a escanear revistas o periodicos tendremos que tener en cuenta algunas cosas que pueden darnos unos resultados fantásticos.

1) Para evitar que la parte posterior del documento aparezca impresa de forma ligera en el archivo escaneado, debemos de colocar una cartulina negra detrás de la cara que vamos a escanear para que este efecto desaparezca. Esto es debido a lo fino que es el papel de los documentos impresos, que hace que al aplicarle una luz intensa (lo que hace el escáner), éste aparezca traslúcido en la imagen digitalizada cuando la visualizamos en la pantalla.

2) El desagradable efecto moaré que producen estos documentos impresos cuando se aumenta su resolución de escaneado puede eliminarse de una forma muy rápida y efectiva. Hay que escanear el documento a una resolución máxima de 300pp y luego posteriormente con El Gimp, reducir su tamaño al que tengamos pensado usar. Una vez hecho esto seleccionamos Filtros >> Realzar [Enhance] >> Filtro NL... Con la opción activada: Media seccionada alfa seleccionamos el siguiente ajuste: Alfa - 0,45 | Radio - 0,75 (Se puede jugar con estos valores hasta conseguir el más deseado) y el moaré habrá desaparecido por completo sin desenfocar la imagen que es lo que suelen hacer los filtros de tipo blur. Luego podemos aplicar una máscara de enfoque, esto ya lo dejo al gusto particular de cada uno.



Enlaces  


http://www.xsane.org >> La web archivada de XSane.

http://www.sane-project.org >> La web de Sane.

Lista de Escáneres Soportados


Foro Galería Blog


Actualizado el 05-08-2023

Escanear en GNU/Linux - XSane

Editores Gráficos - PixelitorFiltros 8bf - 20/20 Color MD