Beyond Linux® From Scratch (Edição systemd ) - Versão 12.0

Capítulo 49. Digitalizando

SANE-1.0.32

Introdução ao SANE

SANE é a abreviação de Scanner Access Now Easy. O acesso à digitalizadora, entretanto, está longe de ser fácil, já que cada fornecedor(a) tem os próprios protocolos deles(as). O único protocolo conhecido que deveria trazer alguma unidade a esse caos é a interface TWAIN, mas isso é muito impreciso para permitir uma estrutura de digitalização estável. Portanto, SANE vem com o próprio protocolo dele e os controladores do(a) fornecedor(a) não podem ser usados.

SANE é dividido em estruturas de retaguarda e estruturas de interação direta com o(a) usuário(a). As estruturas de retaguarda são controladores para as digitalizadoras e câmeras suportadas. As estruturas de interação direta com o(a) usuário(a) são interfaces de usuário(a) para acessar as estruturas de retaguarda.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.0.

Informações do Pacote de Estruturas de Retaguarda

Transferências Adicionais (Estruturas de Interação Direta com o(a) Usuário(a))

[Nota]

Nota

O local de desenvolvedor(a) para esses arquivos está em https://gitlab.com/sane-project, mas os URLs dos arquivos usam md5sums incorporados. Por conveniência, os pacotes foram copiados para o local acima.

Dependências do SANE

Opcionais (Estruturas de Retaguarda)

Avahi-0.8, Cups-2.4.6, libjpeg-turbo-3.0.0, libtiff-4.5.1, libusb-1.0.26, v4l-utils-1.24.1, Net-SNMP, libieee1284, libgphoto2 e texlive-20230313 (ou install-tl-unx)

Opcionais (Estruturas de Interação Direta com o(a) Usuário(a))

um ambiente gráfico, GTK+-2.24.33 e Gimp-2.10.34

Configuração do Núcleo, Controladores e Pacotes Adicionais

Para acessar tua digitalizadora, você provavelmente precisará dos controladores de núcleo relacionados e (ou) pacotes adicionais de suporte. Uma digitalizadora SCSI precisará de controladores SCSI; uma digitalizadora de porta paralela precisa de suporte a porta paralela (você deveria usar modos EPP aprimorados) e talvez libieee1284, e uma digitalizadora USB precisará do pacote libusb-1.0.26. Para dispositivos HP, você possivelmente precise do hplip. Certifique-se de ter os controladores necessários configurados corretamente para acessar os dispositivos.

Instalação do SANE

Instalação das Estrutura de Retaguarda do SANE

O processo de segundo plano do SANE deveria executar com o próprio grupo dele. Crie esse grupo emitindo os seguintes comandos como o(a) usuário(a) root: 

groupadd -g 70 scanner
[Nota]

Nota

O configure assume que o(a) usuário(a) construindo estruturas de retaguarda do SANE é um(a) membro(a) do grupo scanner para testar a existência desse grupo. Portanto, o(a) usuário(a) construindo o pacote deveria ser adicionado(a) ao grupo scanner. Como o(a) usuário(a) root: 

usermod -G scanner -a nome_usuário(a)

Depois de adicionar o grupo scanner como acima, você precisará sair e entrar novamente para ativá-lo.

Para uma digitalizadora USB, se você estiver vinculando ao libusb-1.0.26, inclua a chave de configuração --enable-libusb_1_0. Instale as estruturas de retaguarda do SANE executando os seguintes comandos: 

sg scanner -c "                  \
./configure --prefix=/usr        \
            --sysconfdir=/etc    \
            --localstatedir=/var \
            --with-group=scanner \
            --with-lockdir=/run/lock \
            --docdir=/usr/share/doc/sane-backends-1.0.32" &&
make

Para testar os resultados, emita: make check.

Agora, como o(a) usuário(a) root: 

make install                                         &&
install -m 644 -v tools/udev/libsane.rules           \
                  /etc/udev/rules.d/65-scanner.rules &&
mkdir -p          /run/lock/sane &&
chgrp -v scanner  /run/lock/sane

Com a digitalizadora ligada, execute scanimage -L e o nome e local do dispositivo deveriam aparecer. Claro, você precisa dos controladores de dispositivo configurados para a finalidade de executar esse teste.

Instalação das Estruturas do SANE de Interação Direta com o(a) Usuário(a)

O pacote de estruturas do SANE de interação direta com o(a) usuário(a) inclui as estruturas gráficas de interação direta com o(a) usuário(a) xscanimage e xcam, e uma estrutura de linha de comando de interação direta com o(a) usuário(a) scanadf. Você não precisa desse pacote se pretende usar uma das estruturas gráficas de interação direta com o(a) usuário(a) mais avançadas, como XSane-0.999. Para uma lista de pacotes de estruturas de interação direta com o(a) usuário(a), veja-se http://www.sane-project.org/sane-frontends.html.

Para instalar as estruturas do SANE de interação direta com o(a) usuário(a), use os seguintes comandos: 

tar -xf ../sane-frontends-1.0.14.tar.gz &&
cd sane-frontends-1.0.14                &&

sed -i -e "/SANE_CAP_ALWAYS_SETTABLE/d" src/gtkglue.c &&
./configure --prefix=/usr --mandir=/usr/share/man &&
make

Esse pacote não vem com uma suíte de teste.

Agora, como o(a) usuário(a) root: 

make install &&
install -v -m644 doc/sane.png xscanimage-icon-48x48-2.png \
    /usr/share/sane

Se o GIMP foi vinculado na construção e você desejar que o GIMP use o xscanimage como um plugin de digitalização, emita o seguinte comando como o(a) usuário(a) root: 

ln -v -s ../../../../bin/xscanimage /usr/lib/gimp/2.0/plug-ins
[Nota]

Nota

Se o plugin xscanimage estiver desabilitado no menu do GIMP, para a finalidade de habilitá-lo, "crie" uma imagem em branco usando o menu ou Ctrl-N. Depois disso, ele estará habilitado.

Explicações do Comando

sg scanner -c "...": executa o comando entre aspas duplas com o grupo principal scanner. Isso possivelmente seja necessário se o(a) usuário(a) tiver sido adicionado(a) recentemente ao grupo scanner e não tiver feito logout e login.

--sysconfdir=/etc: Essa chave instala os arquivos de configuração em /etc/sane.d em vez de /usr/etc/sane.d.

--with-group=scanner: Esse parâmetro faz com que o diretório criado para os arquivos de travagem seja de titularidade de propriedade de grupo pelo grupo scanner, em vez do grupo padrão uucp.

exit: Esse comando é usado para sair do shell criado pelo comando su.

Configurando o SANE

Arquivos de Configuração

/etc/sane.d/*.conf

Informação de Configuração

Configuração da Estrutura de Retaguarda

Os arquivos de configuração de estrutura de retaguarda estão localizados em /etc/sane.d. Informações para configurar as várias estruturas de retaguarda podem ser encontradas usando-se a página de manual(5) para a estrutura de retaguarda desejada. Execute man sane-<estrutura de retaguarda>, substituindo a estrutura de retaguarda desejada.

Adicione quaisquer usuários(as) desejados(as) ao grupo scanner.

Se você quiser acessar uma digitalizadora na rede de intercomunicação, inclua duas linhas em net.conf, como usuário(a) root (certifique-se de substituir <ip_servidor> pelo valor atual, abaixo): 

cat >> /etc/sane.d/net.conf << "EOF"
connect_timeout = 60
<ip_servidor>
EOF

No lado do servidor, inclua o IP do cliente na lista de acesso de /etc/sane.d/saned.conf, reinicie o processo de segundo plano saned e certifique-se de que o firewall, se houver, está aberto ao cliente.

Configuração da Estrutura de Interação Direta com o(a) Usuário(a)

Se você usa um ambiente de área de trabalho, como Gnome ou KDE, você possivelmente deseje criar um arquivo xscanimage.desktop, de forma que o xscanimage apareça nos menus do painel. Como o(a) usuário(a) root: 

mkdir -pv /usr/share/{applications,pixmaps}               &&

cat > /usr/share/applications/xscanimage.desktop << "EOF" &&
[Desktop Entry]
Encoding=UTF-8
Name=Digitalização - XScanImage
Comment=Adquirir imagens a partir de uma digitalizadora
Exec=xscanimage
Icon=xscanimage
Terminal=false
Type=Application
Categories=Application;Graphics
EOF

ln -svf ../sane/xscanimage-icon-48x48-2.png /usr/share/pixmaps/xscanimage.png
Informação Geral

Para informações gerais acerca de como configurar e usar o SANE, veja-se man sane. Para informações acerca de dispositivos USB de digitalização, execute man sane-usb. Para informações relativas a dispositivos SCSI, execute man sane-scsi.

Configuração e instalação do processo de segundo plano 'saned'

O processo de segundo plano saned não é destinado a ser usado por clientes não confiáveis. Você deveria fornecer proteção Técnicas de Firewall para garantir que somente clientes confiáveis acessem o processo de segundo plano. Devido aos complexos requisitos de segurança para garantir que somente clientes confiáveis acessem o processo de segundo plano, o BLFS não fornece instruções para configurar o processo de segundo plano saned. Algumas informações boas (mas desatualizadas) para configurar e proteger o processo de segundo plano saned podem ser encontradas em https://penguin-breeder.org/sane/saned/.

Conteúdo

Estruturas de Retaguarda:

Aplicativos Instalados: gamma4scanimage, sane-config, saned, sane-find-scanner e scanimage
Bibliotecas Instaladas: libsane.so e numerosos módulos de estrutura de retaguarda da digitalizadora
Diretórios Instalados: /etc/sane.d, /usr/{include,lib,share}/sane e /usr/share/doc/sane-1.0.32

Estruturas de Interação Direta com o(a) Usuário(a):

Aplicativos Instalados: scanadf, xcam e xscanimage
Biblioteca Instalada: Plugin do GIMP incorporado ao xscanimage
Diretórios Instalados: Nenhum(a)

Descrições Curtas

gamma4scanimage

cria uma tabela gama no formato esperado pelo scanimage

sane-config

é uma ferramenta usada para determinar os sinalizadores do compilador e do vinculador que deveriam ser usados para compilar e vincular o SANE

saned

é o processo de segundo plano do SANE que permite que clientes remotos acessem dispositivos de aquisição de imagens disponíveis no dispositivo local

sane-find-scanner

é uma ferramenta de linha de comando para localizar digitalizadoras SCSI e USB e determinar os arquivos de dispositivos delas. O objetivo principal dela é o de garantir que as digitalizadoras possam ser detectadas pelas estruturas de retaguarda do SANE

scanadf

é uma interface de linha de comando para controlar dispositivos de aquisição de imagens equipados com um alimentador automático de documentos (ADF)

scanimage

é uma interface de linha de comando para digitalização a partir de dispositivos de aquisição de imagens, como digitalizadoras de mesa ou câmeras. Também é usada para listar os dispositivos de estrutura de retaguarda disponíveis

xcam

é uma interface de câmera gráfica para interação direta com o(a) usuário(a) para SANE

xscanimage

é uma interface gráfica de usuário(a) para digitalização

libsane.so

é a interface de programação de aplicativos usada para comunicação entre estruturas de interação direta com o(a) usuário(a) e estruturas de retaguarda

libsane-*.so

módulos são plug-ins de estrutura de retaguarda de biblioteca de digitalização usados para interfacear com dispositivos de digitalização. Veja-se http://www.sane-project.org/sane-supported-devices.html para uma lista de estruturas de retaguarda suportadas