sane-apple(5)          SANE: ,,Scanner Access Now Easy"          sane-apple(5)

NUME
       sane-apple - controlor SANE pentru scanere plate Apple

DESCRIERE
       Biblioteca sane-apple implementeaza un controlor SANE (Scanner Access
       Now Easy) care ofera acces la scanerele plate Apple. In prezent,
       urmatoarele scanere sunt acceptate de acest controlor:

       --------------- ----- ------------------ ---------
       AppleScanner    4bit  16  Tonuri de gri
       OneScanner      8bit  256 Tonuri de gri
       ColorOneScanner 24bit RGB color          3 treceri


       Daca de<?>ine<?>i un scaner Apple, altul decat cele enumerate mai sus,
       care func<?>ioneaza cu acest controlor, va rugam sa ne anun<?>a<?>i
       trimi<?>and numele modelului scanerului, ID-ul SCSI <?>i revizuirea
       firmware-ului la sane-devel@alioth-lists.debian.net. Consulta<?>i
       http://www.sane-project.org/mailing-lists.html pentru detalii despre
       cum sa va abona<?>i la sane-devel.


NUME DE DISPOZITIVE
       Acest controlor a<?>teapta nume de dispozitive de forma:

              special

       Unde special este numele rutei pentru dispozitivul special care
       corespunde unui scaner SCSI. In cazul scanerelor SCSI, numele
       dispozitivului special trebuie sa fie un dispozitiv SCSI generic sau o
       legatura simbolica catre un astfel de dispozitiv. In Linux, un astfel
       de nume de dispozitiv poate fi /dev/sga sau /dev/sge, de exemplu.
       Pentru detalii, consulta<?>i sane-scsi(5).


CONFIGURARE
       Fi<?>ierul apple.conf este o lista de op<?>iuni <?>i nume de
       dispozitive care corespund scanerelor Apple. Liniile goale <?>i liniile
       care incep cu un simbol hash (#) sunt ignorate. Consulta<?>i
       sane-scsi(5) pentru detalii despre ce constituie un nume de dispozitiv
       valid.

       Op<?>iunile sunt de doua feluri: globale <?>i pozi<?>ionale.
       Op<?>iunile globale se aplica tuturor dispozitivelor gestionate de
       controlor, in timp ce op<?>iunile pozi<?>ionale se aplica doar celui
       mai recent dispozitiv men<?>ionat. Re<?>ine<?>i ca acest lucru inseamna
       ca ordinea in care apar op<?>iunile conteaza!


SFATURI PENTRU ADAPTORUL SCSI
       Scanerele SCSI sunt de obicei livrate cu un adaptor ISA SCSI. Din
       nefericire, acest adaptor nu valoreaza prea mult, deoarece nu este
       comandat de intreruperi. Uneori este posibil ca placa furnizata sa
       func<?>ioneze, dar fara o linie de intrerupere, scanarea va incarca
       atat de mult sistemul incat acesta devine aproape inutilizabil pentru
       alte sarcini.

FI<?>IERE
       /etc/sane.d/apple.conf
              Fi<?>ierul de configurare al controlorului (a se vedea, de
              asemenea, descrierea SANE_CONFIG_DIR de mai jos).

       /usr/lib/sane/libsane-apple.a
              Biblioteca statica care implementeaza acest controlor.

       /usr/lib/sane/libsane-apple.so
              Biblioteca partajata care implementeaza acest controlor
              (prezenta pe sistemele care accepta incarcare dinamica).

MEDIU
       SANE_CONFIG_DIR
              Aceasta variabila de mediu este o lista de directoare in care
              SANE cauta fi<?>ierul de configurare. Pe sistemele *NIX, numele
              directoarelor sunt separate prin doua puncte (,,:"), iar sub
              OS/2 prin punct <?>i virgula (,,;"). Daca variabila
              SANE_CONFIG_DIR nu este definita, SANE cauta implicit in
              directorul curent de lucru (,,.") <?>i apoi in /etc/sane.d. Daca
              valoarea variabilei $SANE_CONFIG_DIR se termina cu caracterul
              separator, directoarele implicite sunt cautate dupa lista de
              directoare. De exemplu, daca se define<?>te SANE_CONFIG_DIR la
              ,,/tmp/config:", vor fi cautate directoarele tmp/config, . <?>i
              /etc/sane.d (in aceasta ordine).

       SANE_DEBUG_APPLE
              Controleaza nivelul de depanare. O valoare de 255 afi<?>eaza
              toate informa<?>iile de depanare. Valorile mai mici reduc
              nivelul de detaliere. Necesita o biblioteca compilata cu suport
              pentru depanare.


STAREA ACTUALA
       Controlorul apple este acum la versiunea 0.3 (mar<?>i, 21 iulie 1998).
       Deoarece am doar AppleScanner <?>i nu <?>i celelalte modele
       (OneScanner, ColorOneScanner), nu pot dezvolta/testa decat pentru
       AppleScanner. Cu toate acestea, cu aceasta versiune aproape am
       finalizat partea GUI a tuturor scanerelor. Cea mai mare parte a
       func<?>ionalita<?>ii este acolo. Cel pu<?>in OneScanner ar trebui sa
       scaneze la modurile compatibile ale AppleScanner (LineArt, HalfTone,
       Gray16). Credin<?>a mea personala este ca, cu o u<?>oara atingere de
       depanare, OneScanner ar putea fi de fapt utilizabil. ColorOneScanner
       necesita mai multa munca. AppleScanner este, desigur, aproape complet
       acceptat.


FUNC<?>IONALITATE LIPSA
       In prezent, toate cele trei modele nu au suport pentru
       incarcare/descarcare.

       AppleScanner
              Nu poate incarca/descarca un model de semiton.

       OneScanner
              Nu poate incarca/descarca modele de semitonuri sau vectori de
              calibrare.

       ColorOneScanner
              Nu poate incarca/descarca modele de semitonuri, vectori de
              calibrare, tabele personalizate de corec<?>ie a culorilor (CCT)
              <?>i, de asemenea, tabele gamma personalizate.

       Park/UnPark (OneScanner, ColorOneScanner)
              Unele capacita<?>i lipsesc.

       Func<?>ionalita<?>ile de mai sus lipsesc pentru ca nu am hardware pe
       care sa experimentez. Un alt motiv este lipsa mea de in<?>elegere cu
       privire la modul in care sau daca API SANE ofera mijloace pentru a
       descrie orice tip de matrice in afara de gamma.



CARACTERISTICI NEACCEPTATE
       Urmatoarele ,,caracteristici" nu vor fi acceptate niciodata, cel
       pu<?>in atat timp cat voi men<?>ine controrul sane-apple.

       NoHome (AppleScanner)
              Lampa scanerului ramane aprinsa <?>i ansamblul caruciorului
              ramane in pozi<?>ia in care se opre<?>te la sfar<?>itul
              scanarii. Dupa doua minute, daca scanerul nu prime<?>te o alta
              comanda SCAN, lampa se stinge <?>i caruciorul revine la
              pozi<?>ia ini<?>iala.

       Comprimare (AppleScanner)
              Scanerul poate comprima datele cu algoritmul CCITT Group III
              unidimensional (fax) <?>i algoritmul Skip White Line.

       Ferestre multiple (AppleScanner)
              AppleScanner poate gestiona mai multe ferestre. Ar fi o
              caracteristica interesanta <?>i o provocare pentru mine sa
              programez daca ar putea amesteca diferite op<?>iuni pentru
              diferite ferestre (zone de scanare). In acest fel, ar putea
              scana un document in modul LineArt, dar figurile din acesta in
              modul Gray <?>i la o rezolu<?>ie diferita. Din pacate, acest
              lucru este imposibil.

       Direc<?>ia de scanare (OneScanner)
              Aceasta controleaza direc<?>ia de scanare. (?)

       Butonul de stare/repornire (OneScanner)
              Aceasta op<?>iune controleaza starea butonului pe modelul
              OneScanner. De asemenea, pute<?>i reini<?>ializa starea
              butonului prin software.


ERORI
       Erorile controlorului SANE sunt impar<?>ite in doua clase. Avem erori
       GUI (erori in interfa<?>a grafica cu utilizatorul) <?>i erori specifice
       scanerului.

       <?>tim ca avem o eroare GUI atunci cand un parametru nu apare atunci
       cand ar trebui (activ) sau viceversa. A afla care parametri sunt activi
       in diferite moduri <?>i modele Apple din documenta<?>ie este un
       exerci<?>iu interesant. Este posibil sa fi ratat unele dependen<?>e. De
       exemplu, in ceea ce prive<?>te parametrul prag, Ghidul de programare al
       scanerelor Apple nu spune nimic. Am fost nevoit sa presupun ca este
       valabil numai in modul LineArt.

       Erorile specifice scanerului se datoreaza in principal rotunjirilor
       obligatorii pentru scanare. In documenta<?>ie, intr-un loc se
       precizeaza ca la<?>imea zonei de scanare trebuie sa fie un multiplu de
       octe<?>i. In alt loc, se precizeaza ca la<?>imea zonei de scanare
       trebuie sa fie un multiplu par de octe<?>i. Ca sa vezi...

       Alte surse de erori se datoreaza comunicarii scsi, conectarilor <?>i
       deconectarilor scsi. Cu toate acestea, erorile clasice sunt inca acolo.
       Astfel, este posibil sa intalni<?>i depa<?>iri ale memoriei tampon,
       indicatori nuli, corup<?>ie de memorie <?>i incalcari ale API SANE.

       SIGSEGV la SliceBars
              Cand incerca<?>i sa modifica<?>i zona de scanare din bara de
              modificare, ave<?>i o descarcare brusca a con<?>inutului
              memoriei, ,,dragu<?>a". Nu <?>tiu de ce. Daca selecta<?>i zona
              de scanare din fereastra de previzualizare sau prin tastarea
              manuala a numerelor, totul este in regula. SIGSEGV se intampla
              adanc in biblioteca gtk (gdk). Chiar nu o pot depana.

       Op<?>iuni prea multe
              Este posibil, in special pentru ,,ColorOneScanner", ca panoul de
              op<?>iuni al controlorului sa se extinda dincolo de ecranul dvs.
              Se intampla cu al meu, iar eu folosesc X Server la 1024x768. Ce
              pot sa va spun? Incerca<?>i fonturi mai mici in serverul X sau
              ecrane virtuale.

       Comportament ciudat al SCSI
              Il citez aici pe David Myers...

              >> OS: FreeBSD 2.2.6
              >> CC: egcs-1.02
              Am vrut doar sa urmaresc acest lucru...  Mi-am schimbat recent
              placa SCSI de la Adaptec 2940UW la un chipset Symbios 786
              dual-channel. Cand am pornit SANE cu controlorul dvs., am
              reu<?>it sa scanez bine desenele line art, dar scanarile Gray16
              au dus la un flux de mesaje de eroare SCSI pe consola, in cele
              din urma incheind cu un mesaj care spunea ca scanerul nu elibera
              magistrala SCSI. Este posibil ca Symbios sa fie pur <?>i simplu
              mai pu<?>in tolerant cu hardware-ul vechi, sau sa fie erori in
              controlorul dvs. sau in SANE in sine...


DEPANARE
       Daca intalni<?>i o eroare GUI, va rog sa defini<?>i variabila de mediu
       SANE_DEBUG_APPLE la 255 <?>i sa re-executa<?>i secven<?>a exacta de
       taste <?>i selec<?>ii de meniu pentru a o reproduce. Apoi
       trimite<?>i-mi un raport cu jurnalul ata<?>at.

       Daca ave<?>i un Apple Macintosh cu controlorul AppleScanners instalat,
       mi-ar fi de mare ajutor sa-mi raporta<?>i ce op<?>iuni sunt gri
       (inactive) in ce moduri.

       Daca dori<?>i sa oferi<?>i ajutor, dar nu ave<?>i un scaner, sau nu
       ave<?>i modelul cu care a<?>i dori sa ajuta<?>i, sau sunte<?>i un
       dezvoltator SANE <?>i dori<?>i doar sa arunca<?>i o privire la modul in
       care arata controlorul Apple, merge<?>i la apple.h <?>i #define<?>i
       macroul NEUTRALIZE_BACKEND. Pute<?>i selecta modelul de scaner prin
       macroul APPLE_MODEL_SELECT. Op<?>iunile disponibile sunt APPLESCANNER,
       ONESCANNER <?>i COLORONESCANNER.

       Daca intalni<?>i o eroare de bus SCSI sau imagini taiate <?>i/sau
       deplasate, va rog sa defini<?>i variabila de mediu
       SANE_DEBUG_SANEI_SCSI la 255 inainte de a-mi trimite raportul.


DE FACUT
       Suport fara blocare
              Sa fac din sane-apple un controlor care nu se blocheaza. Suport
              adecvat pentru sane_set_io_mode() <?>i sane_get_select_fd().

       Scanare
              Sa fac scanarea posibila pentru toate modelele in toate modurile
              acceptate.

       Adaugarea altor func<?>ionalita<?>i lipsa.


CONSULTA<?>I <?>I
       sane(7), sane-scsi(5)


AUTOR
       Controlorul sane-apple nu a fost scris in intregime de la zero de catre
       Milon Firikis. Acesta se bazeaza in principal pe controlorul
       sane-mustek(5) de la David Mosberger <?>i Andreas Czechanowski.

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

                                 11 iulie 2008                   sane-apple(5)