Capitolo Multimedia: scanner

    </sect2>
  </sect1>

  <sect1 id="scanners">
    <sect1info>
      <authorgroup>
        <author>
          <firstname>Marc</firstname>
          <surname>Fonvieille</surname>
          <contrib>Scritto da </contrib>
          <!-- 04 August 2004 -->
        </author>
      </authorgroup>
    </sect1info>

    <title>Scanner di immagini</title>
    <indexterm>
      <primary>scanner di immagini</primary>
    </indexterm>

    <sect2>
      <title>Introduzione</title>

      <para>&os;, come ogni moderno sistema operativo, permette di usare
        scanner di immagini.  Un accesso standardizzato allo scanner
        &egrave; fornito dalle
        <acronym role="Application Programming Interface">API</acronym>
        di <application>SANE</application> (Scanner Access Now
        Easy) disponibili nella Collezione di Port di &os;.
        <application>SANE</application> usa anche alcuni
        device driver di &os; per accedere all'hardware
        dello scanner.</para>

      <para>&os; supporta sia scanner SCSI che USB.  Verifica che
        il tuo scanner sia supportato da <application>SANE</application>
        prima di effettuare ogni configurazione.
        <application>SANE</application> ha una lista di
        <ulink 
url="http://sane-project.org/sane-supported-devices.html">device
        supportati</ulink>, lista che ci pu&ograve; fornire informazioni
        riguardo il supporto per uno scanner ed il suo stato.
        La pagina di manuale di	&man.uscanner.4; fornisce una lista di
        scanner USB supportati.</para>
    </sect2>

    <sect2>
      <title>Configurazione del Kernel</title>

      <para>Come gi&agrave; menzionato, sia scanner USB che SCSI
        sono supportati.  A seconda dell'interfaccia del tuo scanner,
        diversi	device driver sono richiesti.</para>

      <sect3 id="scanners-kernel-usb">
        <title>Interfaccia USB</title>

        <para>Il kernel <filename>GENERIC</filename> di default
          include i device drivers necessari per il funzionamento
          degli scanner USB.  In caso tu voglia usare un
          kernel custom accertati che le linee seguenti siano
          presenti nel tuo file di configurazione del kernel:</para>

        <programlisting>device usb
device uhci
device ohci
device uscanner</programlisting>

        <para>A seconda del tipo di chipset USB sulla tua
          motherboard, hai bisogno solo di una fra le opzioni
          <literal>device uhci</literal> e <literal>device ohci</literal>,
          comunque avere entrambe le linee nel proprio file
          di configurazione del kernel non crea problemi.</para>

        <para>Se non intendi ricompilare un kernel custom ed il tuo
          kernel non &egrave; il <filename>GENERIC</filename>, puoi
          direttamente caricare il modulo di device driver di
          &man.uscanner.4; con il comando &man.kldload.8;:</para>

        <screen>&prompt.root; <userinput>kldload 
uscanner</userinput></screen>

        <para>Per caricare il modulo ad ogni avvio di sistema,
          aggiungi le seguenti linee al file
          <filename>/boot/loader.conf</filename>:</para>

        <programlisting>uscanner_load="YES"</programlisting>

        <para>Dopo aver riavviato con il kernel corretto, o dopo
          aver caricato il modulo necessario, inserisci il cavo
          del tuo scanner USB.  Lo scanner dovrebbe apparire
          nel buffer dei messaggi di sistema
          (&man.dmesg.8;) come qualcosa del genere:</para>

        <screen>uscanner0: EPSON EPSON Scanner, rev 1.10/3.02, addr 
2</screen>

        <para>Questo mostra che il nostro scanner usa il
          device node <filename>/dev/uscanner0</filename>.</para>

        <note>
          <para>Su &os;&nbsp;4.X, il demone USB (&man.usbd.8;) deve
            essere in esecuzione per poter vedere alcuni device
            USB.  Per abilitarlo, aggiungi
            <literal>usbd_enable="YES"</literal> al tuo file
            <filename>/etc/rc.conf</filename> e riavvia la macchina
	    .</para>
        </note>
      </sect3>

      <sect3>
        <title>Interfaccia SCSI</title>

      <para>Se il tuo scanner possiede un'interfaccia SCSI,
        &egrave; importante sapere quale SCSI controller board
        intendi usare.  A seconda del chipset SCSI usato,
        dovrai modificare il tuo file di configurazione
        del kernel.  Il kernel <filename>GENERIC</filename> supporta
        i pi&ugrave; comuni controller SCSI.  Accertati di
        leggere il file di <filename>NOTES</filename>
        (<filename>LINT</filename> sotto &os;&nbsp;4.X)
        e aggiungi la linea corretta al tuo
        file di configurazione del kernel.  Oltre al driver
        dell'interfaccia SCSI, devi avere le seguenti
        linee nel file di configurazione
        del kernel:</para>

      <programlisting>device scbus
device pass</programlisting>

      <para>Una volta che il kernel &egrave; stato
        correttamente compilato, dovresti vedere i device
        nel buffer dei messaggi di sistema,
        al momento del boot:</para>

      <screen>pass2 at aic0 bus 0 target 2 lun 0
pass2: &lt;AGFA SNAPSCAN 600 1.10&gt; Fixed Scanner SCSI-2 device
pass2: 3.300MB/s transfers</screen>

      <para>Se il tuo scanner non era acceso al momento
        dell'avvio, &egrave; ancora possibile forzare
        manualmente il riconoscimento attraverso uno
        scan del bus SCSI con il comando &man.camcontrol.8;:</para>

      <screen>&prompt.root; <userinput>camcontrol rescan all</userinput>
Re-scan of bus 0 was successful
Re-scan of bus 1 was successful
Re-scan of bus 2 was successful
Re-scan of bus 3 was successful</screen>

      <para>A questo punto lo scanner apparir&agrave; nella lista
        dei device SCSI:</para>

      <screen>&prompt.root; <userinput>camcontrol devlist</userinput>
&lt;IBM DDRS-34560 S97B&gt;              at scbus0 target 5 lun 0 
(pass0,da0)
&lt;IBM DDRS-34560 S97B&gt;              at scbus0 target 6 lun 0 
(pass1,da1)
&lt;AGFA SNAPSCAN 600 1.10&gt;           at scbus1 target 2 lun 0 (pass3)
&lt;PHILIPS CDD3610 CD-R/RW 1.00&gt;     at scbus2 target 0 lun 0 
(pass2,cd0)</screen>

      <para>Ulteriori dettagli sui devices SCSI sono
        disponibili nelle pagine di manuale
        &man.scsi.4; e &man.camcontrol.8;.</para>
      </sect3>
    </sect2>

    <sect2>
      <title>Configurazione di SANE</title>

      <para>Il sistema <application>SANE</application> &egrave;
        diviso in due parti: il backend
        (<filename role="package">graphics/sane-backends</filename>)
        ed il frontend
        (<filename role="package">graphics/sane-frontends</filename>).
        La parte backend fornisce accesso allo scanner.  La lista di
        <ulink 
url="http://sane-project.org/sane-supported-devices.html">device 
supportati</ulink>
        da <application>SANE</application>
        specifica quale backend supporter&agrave; il tuo
        scanner di immagini.
        &Egrave; necessario determinare il corretto backend per
        per il tuo scanner se intendi usare il tuo device.
        La parte frontend fornisce l'interfaccia grafica
        allo scanning (<application>xscanimage</application>).</para>

      <para>La prima cosa da fare &egrave; installare il port o il pacchetto
        <filename role="package">graphics/sane-backends</filename>.
        Quindi, usa il comando <command>sane-find-scanner</command>
        per verificare il riconoscimento dello scanner da parte
        del sistema <application>SANE</application>:</para>

      <screen>&prompt.root; <userinput>sane-find-scanner -q</userinput>
found SCSI scanner "AGFA SNAPSCAN 600 1.10" at /dev/pass3</screen>

      <para>L'output mostrer&agrave; il tipo di interfaccia dello
        scanner ed il device node usato per connettere lo scanner
        al sistema.  La marca ed il nome del modello potrebbero
        non comparire, non &egrave; importante.</para>

      <note>
        <para>Alcuni scanner USB richiedono il caricamento di
          un firmware, ci&ograve; &egrave; spiegato nella
          pagina di manuale del backend.  &Egrave; utile anche
          leggere le pagine di manuale di
          &man.sane-find-scanner.1; e di &man.sane.7;.</para>
      </note>

      <para>Adesso dobbiamo verificare se lo scanner sar&agrave;
        identificato da	un frontend di scanning.  Di default, il
        backend di <application>SANE</application> fornisce un
        programma da linea di comando chiamato &man.scanimage.1;.
        Questo comando ti permette di elencare i device ed
        effettuare un'acquisizione di immagini da linea di comando.
        L'opzione <option>-L</option> &egrave; usata per ottenere una
        lista di device scanner:</para>

      <screen>&prompt.root; <userinput>scanimage -L</userinput>
device `snapscan:/dev/pass3' is a AGFA SNAPSCAN 600 flatbed scanner</screen>

      <para>Nessun output o un messaggio che dice che nessuno scanner
        &egrave; stato identificato indica che &man.scanimage.1;
        non &egrave; in grado di identificare lo scanner.
        Se ciò succede, dovrai editare il file di configurazione
        del backend ed indicare il device scanner usato.
        La directory
        <filename role="directory">/usr/local/etc/sane.d/</filename>
        contiene tutti i file di configurazione del backend.  Questo
        problema di identificazione avviene con alcuni scanner
        USB.</para>

      <para>Ad esempio, usando <xref linkend="scanners-kernel-usb">,
        <command>sane-find-scanner</command> su uno scanner USB otteniamo
        la seguente informazione:</para>

      <screen>&prompt.root; <userinput>sane-find-scanner -q</userinput>
found USB scanner (UNKNOWN vendor and product) at device 
/dev/uscanner0</screen>
      <para>Lo scanner è riconosciuto correttamente, usa l'interfaccia USB
        ed &egrave; attaccato al device node
        <filename>/dev/uscanner0</filename>.  Ora possiamo testare
        se lo scanner &egrave; correttamente identificato:</para>

      <screen>&prompt.root; <userinput>scanimage -L</userinput>

No scanners were identified. If you were expecting something different,
check that the scanner is plugged in, turned on and detected by the
sane-find-scanner tool (if appropriate). Please read the documentation
which came with this software (README, FAQ, manpages).</screen>

      <para>Dato che lo scanner non è identificato, dovremo editare
        il file <filename>/usr/local/etc/sane.d/epson.conf</filename>
        .  Il modello scanner usato era l'&epson.perfection; 1650,
        cos&igrave; sappiamo che user&agrave; il backend 
<literal>epson</literal>
        .  Accertati di leggere i commenti di aiuto nei file
        di configurazione del backend.  Le modifiche alle linee sono
        abbastanza semplici: commenta tutte le linee che hanno
        un'interfaccia non adato al tuo scanner (nel nostro caso,
        commenteremo tutte le linee che iniziano con la
        parola <literal>scsi</literal> dato che il nostro scanner
        usa l'interfaccia USB), quindi aggiungi alla fine del
        file una linea che specifica l'interfaccia ed il device node
        usato.  In questo caso, aggiungiamo la seguente linea
        :</para>

      <programlisting>usb /dev/uscanner0</programlisting>

      <para>Sei invitato a leggere i commenti presenti
        nel file di configurazione del backend così come le pagine
        di manuale del backend per pi&ugrave; dettagli e per la corretta
        sintassi da usare.  Ora possiamo verificare
        se lo scanner &egrave; identificato:</para>

      <screen>&prompt.root; <userinput>scanimage -L</userinput>
device `epson:/dev/uscanner0' is a Epson GT-8200 flatbed scanner</screen>

      <para>Il nostro scanner USB &egrave; stato riconosciuto.
        Non &egrave; importante	se la marca ed il modello non coincidono.
        Il punto principale a cui prestare attenzione
        &egrave; il campo <literal>`epson:/dev/uscanner0'</literal>,
        che ci d&agrave; il corretto nome del backend ed il corretto
        device node.</para>

      <para>Una volta che il comando <command>scanimage -L</command>
        &egrave; in grado di vedere lo scanner, la configurazione
        &egrave; completa.  Il device
        ora &egrave; in grado di scannerizzare.</para>

      <para>Mentre &man.scanimage.1; ci permette di effettuare
        l'acquisizione di un'immagine dalla linea di comando, &egrave;
        preferibile usare un'interfaccia grafica per effettuare
        scanning di immagini.  <application>SANE</application>
        offre una semplice ma efficace interfaccia grafica:
        <application>xscanimage</application>
        (<filename 
role="package">graphics/sane-frontends</filename>).</para>

      <para><application>Xsane</application>
        (<filename role="package">graphics/xsane</filename>) &egrave;
        un altro comune frontend grafico di scanning.
        Questo frontend offre caratteristiche avanzate
        come varie tecniche di scanning (fotocopia, fax, etc.),
        correzione del colore, scans multipli, etc.  Entrambe
        queste applicazioni sono fruibili come plugin di
        <application>GIMP</application>.</para>
    </sect2>

    <sect2>
      <title>Permettere accesso allo scanner ad altri utenti</title>

      <para>Tutte le operazioni precedenti sono state compiute
        con privilegi di <username>root</username>,
        in ogni caso potresti aver bisogno che altri utenti
        abbiano accesso allo scanner.  L'utente
        necessiter&agrave; permessi di lettura e scrittura
        al device node usato dallo scanner.  Per fare un esempio,
        il nostro scanner USB usa il device node
        <filename>/dev/uscanner0</filename> che appartiene al gruppo
        <groupname>operator</groupname>.  Aggiungere l'utente
        <username>joe</username> al gruppo
        <groupname>operator</groupname> gli permetter&agrave;
        di usare lo scanner:</para>

      <screen>&prompt.root; <userinput>pw groupmod operator -m 
<replaceable>joe</replaceable></userinput></screen>

      <para>Per ulteriori dettagli, leggere la pagina di manuale 
&man.pw.8;.</para>

      <note>
        <para>Chiaramente, per ragioni di sicurezza, dovresti
          pensarci due volte prima di aggiungere un utente a
          qualsiasi gruppo, specialmente al gruppo
          <groupname>operator</groupname>.</para>
      </note>
     </sect2>
   </sect1>
</chapter>