scanimage(1) SANE: ,,Scanner Access Now Easy" scanimage(1) NUME scanimage - scaneaza o imagine SINOPSIS scanimage [-d dispozitiv] [--format=format-ieire] [-i profil] [-L] [-f format-dispozitiv] [-b [format]] [--batch-start=start] [--batch-count=numar] [--batch-increment=increment] [--batch-double] [--accept-md5-only] [-p] [-o ruta] [-n] [-T] [-A] [-h] [-v] [-B dimensiune] [-V] [opiuni-specifice-dispozitivului] DESCRIERE scanimage este o interfaa de linie de comanda pentru a controla dispozitivele de achiziie de imagini, cum ar fi scanerele plate sau camerele de luat vederi. Dispozitivul este controlat prin intermediul opiunilor din linia de comanda. Dupa procesarea liniei de comanda, scanimage procedeaza in mod normal la achiziia unei imagini. Datele imaginii sunt scrise la ieirea standard intr-unul dintre formatele PNM (portable aNyMaP) (PBM pentru imagini alb-negru, PGM pentru imagini in tonuri de gri i PPM pentru imagini color), in format TIFF (alb-negru, in tonuri de gri sau color), in format PNG sau in format JPEG (nivel de compresie 75). scanimage acceseaza dispozitivele de achiziie a imaginilor prin intermediul interfeei SANE (Scanner Access Now Easy) i, prin urmare, poate fi compatibil cu orice dispozitiv pentru care exista un controlor SANE (incercai apropos sane- pentru a obine o lista a controlorilor disponibili). EXEMPLE Pentru a obine o lista de dispozitive: scanimage -L Pentru a scana cu parametrii implicii in fiierul imagine.pnm: scanimage >imagine.pnm Pentru a scana 100x100 mm in fiierul imagine.tiff (este posibil ca opiunile ,,-x" i ,,-y" sa nu fie disponibile pe toate dispozitivele): scanimage -x 100 -y 100 --format=tiff >imagine.tiff Pentru a afia toate opiunile disponibile: scanimage -h OPIUNI Exista doua seturi de opiuni disponibile atunci cand se executa scanimage. Opiunile care sunt oferite de scanimage insui sunt enumerate mai jos. In plus, fiecare controlor-sane ofera propriul set de opiuni, iar acestea pot fi, de asemenea, specificate. Reinei ca opiunile disponibile de la controlorul-sane pot varia in funcie de dispozitivul de scanare selectat. Adesea, opiunile care sunt similare ca funcie pot fi implementate diferit intre controlori. Un exemplu al acestei diferene este --mode Gray i --mode Grayscale. Acest lucru se poate datora unor preferine diferite ale autorilor controlorilor. Alteori, opiunile sunt definite de dispozitivul de scanare in sine i, prin urmare, nu sunt controlate de codul controlorului. Parametrii sunt separai de un spaiu in cazul opiunilor cu un singur caracter (de exemplu, -d epson) i de un ,,=" in cazul opiunilor cu mai multe caractere (de exemplu, --device-name=epson). -d dispozitiv, --device-name=dispozitiv Specifica dispozitivul de accesat i trebuie sa fie urmata de un nume de dispozitiv SANE, cum ar fi ,,epson:/dev/sg0" sau ,,hp:/dev/usbscanner0". O lista (pariala) a dispozitivelor disponibile poate fi obinuta cu ajutorul opiunii --list-devices (a se vedea mai jos). Daca nu se specifica in mod explicit un nume de dispozitiv, scanimage citete un nume de dispozitiv din variabila de mediu SANE_DEFAULT_DEVICE. Daca aceasta variabila nu este definita, scanimage va incerca sa deschida primul dispozitiv disponibil. --format=format-ieire Selecteaza modul in care datele imaginii sunt scrise la ieirea standard sau in fiierul specificat prin opiunea --output-file. format-ieire poate fi pnm, tiff, png sau jpeg. Daca nu se specifica --format, se scrie implicit PNM. -i profil, --icc-profile=profil Se utilizeaza pentru a include un profil ICC intr-un fiier TIFF. -L, --list-devices Solicita o lista (pariala) a dispozitivelor care sunt disponibile. Este posibil ca lista sa nu fie completa, deoarece unele dispozitive pot fi disponibile, dar nu sunt listate in niciunul dintre fiierele de configurare (care sunt stocate de obicei in directorul /etc/sane.d). Acest lucru se intampla in special atunci cand se acceseaza scanerele prin reea. In cazul in care un dispozitiv nu este listat intr-un fiier de configurare, singura modalitate de a-l accesa este prin numele complet al dispozitivului. Este posibil sa fie necesar sa va consultai cu administratorul de sistem pentru a afla numele unor astfel de dispozitive. -f format, --formatted-device-list=format-dispozitiv Funcioneaza in mod similar cu --list-devices, dar necesita un ir de format. scanimage inlocuiete caracterele de poziie %d %v %m %t %i %n cu numele dispozitivului, numele furnizorului, numele modelului, tipul de scaner, un numar de index i, respectiv, o linie noua. Comanda scanimage -f " scanerul numarul %i dispozitivul %d este un %t, modelul %m, produs de %v " va produce ceva precum: scanerul numarul 0 dispozitivul sharp:/dev/sg1 este un scaner plat, model JX250 SCSI, produs de SHARP Opiunile --batch* ofera caracteristici pentru scanarea documentelor care utilizeaza alimentatoare de documente. -b [format], --batch=[format] Se utilizeaza pentru a specifica formatul numelui de fiier in care va fi scrisa fiecare pagina. Fiecare pagina este scrisa intr-un singur fiier. Daca format nu este specificat, se va utiliza valoarea implicita out%d.pnm (sau out%d.tif pentru --format tiff, out%d.png pentru --format png sau out%d.jpg pentru --format jpeg). Aceasta opiune este incompatibila cu opiunea --output-path. format este dat ca un ir de caractere in stil printf cu un parametru intreg. --batch-start=start Selecteaza numarul de pagina cu care se incepe sa se numeasca fiierele. Daca aceasta opiune nu este data, contorul va incepe de la 1. --batch-count=numar Specifica numarul de pagini pe care se incearca scanarea. Daca nu este specificat, scanimage va continua scanarea pana cand scanerul returneaza o alta stare decat OK. Nu toate scanerele cu alimentator de documente semnalizeaza cand ADF-ul este gol. Utilizai aceasta opiune pentru a evita acestea. --batch-increment=increment Stabilete valoarea cu care este incrementat numarul din numele fiierului. In general, acest lucru se utilizeaza atunci cand scanai documente faa-verso pe un alimentator de documente faa-verso. --batch-double este o comanda specifica furnizata pentru a facilita acest lucru. --batch-double Va fixa automat incrementul la 2. Echivalent cu --batch-increment=2. --batch-prompt Va va solicita sa apasai <> inainte de a scana o pagina. Acest lucru poate fi utilizat pentru scanarea mai multor pagini fara un alimentator automat de documente. --accept-md5-only Accepta numai cererile de autorizare a utilizatorilor care accepta securitatea MD5. Demonul de reea SANE saned(8) este capabil sa faca astfel de cereri. -p, --progress Solicita ca scanimage sa afieze un contor de progres. Acesta arata cat de multe date de imagine din imaginea curenta au fost deja primite (in procente). -o ruta, --output-file=ruta Solicita ca scanimage sa salveze rezultatul scanarii in ruta data. Aceasta opiune este incompatibila cu opiunea --batch. Programul va incerca sa ghiceasca --format din numele fiierului. Daca acest lucru nu este posibil, va imprima un mesaj de eroare i va iei. -n, --dont-scan Solicita ca scanimage sa aplice doar opiunile furnizate de utilizator, dar sa nu efectueze efectiv o scanare. Aceasta opiune poate fi utilizata, de exemplu, pentru a opri lampa scanerului (daca acest lucru este acceptat de controlor). -T, --test Solicita ca scanimage sa efectueze cateva teste simple pentru a se asigura ca dispozitivul (controlorul acestuia) funcioneaza aa cum este definit de API-ul SANE. In special funcia sane_read() este verificata prin acest test. -A, --all-options Solicita ca scanimage sa listeze toate opiunile disponibile expuse de controlor, inclusiv opiunile pentru butoane. Informaiile sunt afiate la ieirea standard i nu se va efectua nicio scanare. -h, --help Solicita informaii de ajutor. Informaiile sunt afiate la ieirea standard i nu se va efectua nicio scanare. -v, --verbose Marete cantitatea de informaii afiate de scanimage. Opiunea poate fi specificata in mod repetat, de fiecare data crescand nivelul de detaliere al mesajelor informative. -B [dimensiune], --buffer-size=dimensiune Modifica dimensiunea memoriei tampon de intrare de la valoarea implicita de 1 Mo la dimensiune Ko. -V, --version Solicita ca scanimage sa afieze numele programului i al pachetului, numarul de versiune al distribuiei SANE cu care a fost livrat i versiunea controlorului pe care il incarca. In cazul in care sunt necesare mai multe informaii despre numerele de versiune ale controlorilor, se poate utiliza variabila DEBUG pentru stratul dll. Exemplu: SANE_DEBUG_DLL=3 scanimage -L. Dupa cum va putei imagina, o mare parte din puterea lui scanimage provine din faptul ca poate controla orice controlor SANE. Astfel, setul exact de opiuni din linia de comanda depinde de capacitaile dispozitivului selectat. Pentru a vedea opiunile pentru un dispozitiv numit dispozitiv, apelai scanimage prin intermediul unei linii de comanda de forma: scanimage --help --device-name dispozitiv Documentaia pentru opiunile specifice dispozitivului afiate de --help este cel mai bine explicata prin cateva exemple: -l 0..218mm [0] Poziia x din stanga-sus a zonei de scanare. Descrierea de mai sus arata ca opiunea -l se ateapta la o valoare a opiunii cuprinsa intre 0 i 218 mm. Valoarea dintre parantezele drepte indica faptul ca valoarea actuala a opiunii este 0 mm. Cei mai muli controlori ofera opiuni geometrice similare pentru poziia y din stanga sus (-t), laimea (-x) i inalimea zonei de scanare (-y).. --brightness -100..100% [0] Controleaza luminozitatea imaginii achiziionate. Descrierea de mai sus arata ca opiunea --brightness se ateapta la o valoare de opiune cuprinsa intre -100 i 100 la suta. Valoarea intre paranteze drepte indica faptul ca valoarea actuala a opiunii este 0 procente. --default-enhancements Stabilete valorile implicite pentru controalele de imbunataire. Descrierea de mai sus arata ca opiunea --default-enhancements nu are nicio valoare de opiune. Ar trebui sa se considere ca are un efect imediat in punctul din linia de comanda in care apare. De exemplu, deoarece aceasta opiune reiniiaza opiunea --brightness, perechea de opiuni --brightness 50 --default-enhancements ar fi, de fapt, o opiune fara efect. --mode Lineart|Gray|Color [Gray] Selecteaza modul de scanare (de exemplu, liniar sau color). Descrierea de mai sus arata ca opiunea --mode accepta un argument care trebuie sa fie unul dintre irurile Lineart, Gray sau Color. Valoarea din cadrul parantezelor drepte indica faptul ca opiunea este in prezent definita la Gray. Pentru comoditate, este permisa prescurtarea valorilor irurilor de caractere, atata timp cat acestea raman unice. De asemenea, nu conteaza majusculele ortografice. De exemplu, definirea opiunii --mode col este identica cu --mode Color. --custom-gamma[=(yes|no)] [inactive] Determina daca trebuie sa se utilizeze un tabel gamma integrat sau unul personalizat. Descrierea de mai sus arata ca opiunea --custom-gamma nu ateapta nici o valoare de opiune, un ir ,,yes" sau un ir ,,no". Specificarea opiunii fara valoare este echivalenta cu specificarea lui ,,yes". Valoarea dintre parantezele drepte indica faptul ca opiunea nu este activa in prezent. Adica, incercarea de a defini opiunea ar avea ca rezultat un mesaj de eroare. Setul de opiuni disponibile depinde, de obicei, de valorile altor opiuni. De exemplu, tabelul --custom-gamma ar putea fi activ numai atunci cand a fost solicitat un mod de scanare in tonuri de gri sau color. Reinei ca opiunea --help este procesata numai dupa ce au fost procesate toate celelalte opiuni. Acest lucru face posibila vizualizarea parametrilor opiunilor pentru un anumit mod prin specificarea opiunilor de mod corespunzatoare impreuna cu opiunea --help. De exemplu, linia de comanda: scanimage --help --mode color Va imprima valorile opiunilor care sunt in vigoare atunci cand este selectat modul de culoare. --gamma-table 0..255,... Tabelul de corecie gamma. In modul color, aceasta opiune afecteaza in mod egal canalele rou, verde i albastru simultan (adica este un tabel gamma de intensitate). Descrierea de mai sus arata ca opiunea --gamma-table se ateapta la zero sau mai multe valori in intervalul 0-255. De exemplu, o valoare legala pentru aceasta opiune ar fi ,,3,4,5,6,7,7,8,8,9,10,11,12". Deoarece este greoaie specificarea vectorilor lungi in aceasta forma, acelai lucru poate fi exprimat prin forma prescurtata ,,[0]3-[9]12". Acest lucru inseamna ca primul element al vectorului este stabilit la 3, al 9-lea element este stabilit la 12, iar valorile intermediare sunt interpolate liniar. Desigur, este posibil sa se specifice mai multe astfel de segmente liniare. De exemplu, ,,[0]3-[2]3-[6]7,[7]10-[9]6" este echivalent cu ,,3,3,3,3,4,5,6,7,7,10,8,6". Programul gamma4scanimage poate fi utilizat pentru a genera astfel de tabele gamma (a se vedea gamma4scanimage(1) pentru detalii). --filename <ir> [/tmp/input.ppm] Numele fiierului cu imaginea care urmeaza sa fie incarcata. Descrierea de mai sus este un exemplu de opiune care accepta o valoare arbitrara de ir de caractere (care se intampla sa fie un nume de fiier). Din nou, valoarea dintre paranteze arata ca opiunea este definita in mod curent la numele de fiier /tmp/input.ppm. MEDIU SANE_DEFAULT_DEVICE Afieaza numele implicit al dispozitivului. FIIERE /etc/sane.d Acest director conine diverse fiiere de configurare. Pentru detalii, va rugam sa consultai paginile de manual enumerate mai jos. ~/.sane/pass Acest fiier conine linii de forma utilizator:parola:resursa scanimage utilizeaza aceste informaii pentru a raspunde automat la cererile de autorizare ale utilizatorilor. Fiierul trebuie sa aiba permisiuni 0600 sau mai stricte. Ar trebui sa utilizai acest fiier impreuna cu opiunea --accept-md5-only pentru a evita atacurile de pe server. Resursa poate conine orice caracter, dar este limitata la 127 de caractere. CONSULTAI I sane(7), gamma4scanimage(1), xscanimage(1), xcam(1), xsane(1), scanadf(1), sane-dll(5), sane-net(5), sane-"backendname"(5) AUTOR David Mosberger, Andreas Beck, Gordon Matzigkeit, Caskey Dickson i muli alii. Pentru intrebari i comentarii, contactai lista de discuii sane-devel ( a se vedea http://www.sane-project.org/mailing-lists.html). ERORI In ceea ce privete opiunile vectoriale, in momentul de faa nu exista nicio indicaie cu privire la numarul de elemente pe care trebuie sa le aiba o valoare vectoriala. TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . 10 iulie 2008 scanimage(1)