sane-test(5) SANE: ,,Scanner Access Now Easy" sane-test(5) NUME sane-test - controlor SANE pentru testarea interfeelor DESCRIERE Biblioteca sane-test implementeaza un controlor SANE (Scanner Access Now Easy) care permite testarea instalarii SANE i a interfeelor SANE. Acesta ofera acces la un numar (aproape) nelimitat de dispozitive virtuale. Nu exista suport pentru scanere sau camere reale. Cu toate acestea, controlorul simuleaza scanarea i configurarea opiunilor. Ideea nu este doar de a gasi erori in interfee, ci i de a arata toate capacitaile SANE. Prin urmare, controlorul sane-test implementeaza funcii i opiuni care nu se gasesc (sau se gasesc rar) in ali controlori. Controlorul este comentat in /etc/sane.d/dll.conf, deci fie caracterul de comentariu trebuie eliminat, fie controlorul trebuie apelat in mod explicit. De exemplu, scanimage -d test sau xscanimage test. OPIUNILE MODULUI DE SCANARE Opiunea mode seleeaza modul de scanare (Gray sau Color). Opiunea depth determina numarul de bii pe eantion (1. 8 sau 16). Reinei ca aceasta valoare se refera la eantion, nu la pixel. Astfel, adancimea=16 are ca rezultat 48 de bii pe pixel in modul color. Cele mai uzuale combinaii sunt: mode=Gray, depth=1 pentru lineart, mode=Gray, depth=8 pentru gri i mode=Color, depth=8 pentru modul color. Combinaia de culoare i modul pe 1 bit este destul de obscura (8 culori), dar este permisa in standardul SANE. Cu toate acestea, semnificaia biilor nu este definita. In prezent, se utilizeaza 1 = intensitate mare i 0 = intensitate mica. Definirea opiunii hand-scanner are ca rezultat faptul ca controlorul-test se comporta ca un scaner manual. Scanerele manuale nu cunosc a priori inalimea imaginii. In schimb, acestea returneaza o inalime de -1. Definirea acestei opiuni permite sa se testeze daca o interfaa poate gestiona corect acest lucru. Aceasta opiune permite, de asemenea, o laime fixa de 11 cm. Definirea opiunii three-pass simuleaza un scaner cu trei treceri. Scanerele color mai vechi trebuiau sa scaneze imaginea o data pentru fiecare culoare (rou/verde/albastru) pentru a obine imaginea completa. Prin urmare, in acest mod sunt transmise trei cadre unice in modul color. Opiunea three-pass-order ofera suport pentru modificarea ordinii celor trei cadre (a se vedea opiunea three-pass de mai sus). O interfaa ar trebui sa suporte toate ordinele. Opiunea resolution stabilete rezoluia imaginii in puncte pe inch. Opiunea source poate fi utilizata pentru a simula un alimentator automat de documente (ADF). Dupa 10 scanari, ADF-ul va fi ,,gol". OPIUNI SPECIALE Opiunea test-picture permite stabilirea imaginii care este returnata catre interfaa. In timp ce ,,Solid white" i ,,Solid black" sunt destul de evidente, celelalte opiuni necesita mai multe explicaii. Modelele de culoare sunt utilizate pentru a determina daca toate modurile i culorile lor sunt reprezentate corect de catre interfaa. Grila ar trebui sa arate la fel in fiecare mod i rezoluie. Un tabel cu toate imaginile de test poate fi gasit la: http://www.meier-geinitz.de/sane/test-backend/test-pictures.html. Daca este definita opiunea invert-endianness, se schimba octeii superior i inferior ai datelor de imagine in modurile pe 16 bii. Aceasta opiune poate fi utilizata pentru a testa modurile pe 16 bii ale interfeelor frontale, de exemplu, pentru a verifica daca interfeele folosesc modul corect de adresare. Daca opiunea read-limit este definita, cantitatea maxima de date transferate la fiecare apel la sane_read() este limitata. Opiunea read-limit-size stabilete limita pentru opiunea read-limit. O limita scazuta incetinete scanarea. Ea poate fi utilizata pentru a detecta erorile din interfaa care apar din cauza unor presupuneri greite privind dimensiunea memoriei tampon sau a unor probleme de sincronizare. Opiunea read-delay permite intarzierea datelor catre interfaa. Opiunea read-delay-duration selecteaza numarul de microsecunde pe care controlorul il ateapta dupa fiecare transfer al unei memorii tampon. Aceasta opiune este utila pentru a gasi erori legate de sincronizare, in special daca este utilizata in reea. In cazul in care opiunea read-return-value este diferita de ,,Default", starea selectata va fi returnata de fiecare apel la sane_read(). Acest lucru este util pentru a testa modul de gestionare a starilor SANE de catre interfaa. Daca opiunea ppl-loss este diferita de 0, aceasta determina numarul de pixeli care sunt "pierdui" la sfaritul fiecarei linii. Asta inseamna ca liniile sunt umplute cu date neutilizate. Opiunea fuzzy-parameters selecteaza ca parametrii fuzzy (inexaci) sa fie returnai atata timp cat scanarea nu a fost iniiata. Aceasta opiune poate fi utilizata pentru a testa daca aplicaia de interfaa utilizeaza parametrii pe care i-a primit inainte de inceperea scanarii (ceea ce nu ar trebui sa faca). Opiunea non-blocking determina daca trebuie sa se utilizeze IO non-blocking (In/Ie fara blocare) pentru sane_read(), daca aceasta este acceptata de interfaa. Daca opiunea select-fd este definita, controlorul ofera un descriptor de fiier selectat pentru a detecta daca sane_read() va returna date. Daca opiunea enable-test-options este definita, este activata o lista destul de mare de opiuni pentru testarea diferitelor tipuri de opiuni SANE. Opiunea print-options poate fi utilizata pentru a imprima o lista cu toate opiunile la ieirea de eroare standard. OPIUNI DE GEOMETRIE Opiunea tl-x determina poziia x din stanga-sus a zonei de scanare. Opiunea tl-y determina poziia y din stanga-sus a zonei de scanare. Opiunea br-x determina poziia x din dreapta jos a zonei de scanare. Opiunea br-y determina poziia y din dreapta jos a zonei de scanare. OPIUNI DE TESTARE BOOLEANA Exista in total 6 opiuni de testare booleane. Fiecare opiune este numerotata. (3/6) inseamna: aceasta este opiunea 3 din 6. Schema de numerotare este menita sa faciliteze detectarea opiunilor care nu sunt afiate de catre interfaa (din cauza lipsei de suport sau a unor erori). Opiunea bool-soft-select-soft-detect (1/6) este o opiune de testare booleana care are capacitai de selectare software i de detectare software (i avansate). Este doar o opiune booleana normala. Opiunea bool-hard-select-soft-detect (2/6) este o opiune de testare booleana care are capacitai de selectare hardware i detectare software (i avansate). Aceasta inseamna ca opiunea nu poate fi definita de catre interfaa, ci de catre utilizator (de exemplu, prin apasarea unui buton de pe dispozitiv). Opiunea bool-hard-select (3/6) este o opiune de testare booleana care are capacitai de selecie hardware (i avansate). Aceasta inseamna ca opiunea nu poate fi definita de catre interfaa, ci de catre utilizator (de exemplu, prin apasarea unui buton de pe dispozitiv) i nu poate fi citita de catre interfaa. Opiunea bool-soft-detect (4/6) este o opiune de testare booleana care are capacitai de detectare software (i avansate). Aceasta inseamna ca opiunea este numai-pentru-citire. Opiunea bool-soft-select-soft-detect-emulated (5/6) este o opiune de testare booleana care are capacitai de selectare software, de detectare software i de emulare (i avansate). Opiunea bool-soft-select-soft-detect-auto (6/6) este o opiune de testare booleana care are capacitai de selectare software, de detectare software i automate (i avansate). Aceasta opiune poate fi definita automat de catre controlor. OPIUNI DE TESTARE CU NUMERE INTREGI Exista in total de 7 opiuni de testare cu numere intregi. Opiunea int (1/7) este o opiune de testare cu numere intregi fara unitate (de masura) i fara set de constrangeri. Opiunea int-constraint-range (2/7) este o opiune de testare cu numere intregi cu unitatea de pixel i interval de constrangere stabilit. Minimul este 4, maximul 192, iar cantitatea este 2. Opiunea int-constraint-word-list (3/7) este o opiune de testare cu numere intregi cu unitatea de bii i cu lista de cuvinte de constrangere stabilita. Opiunea int-constraint-array (4/7) este o opiune de testare cu numere intregi cu unitatea mm i care utilizeaza o matrice fara constrangeri. Opiunea int-constraint-array-constraint-range (5/7) este o opiune de testare cu numere intregi cu unitatea mm i care utilizeaza o matrice cu o restricie de interval. Minimul este 4, maximul 192, iar cantitatea este 2. Opiunea int-constraint-array-constraint-constraint-word-list (6/7) este o opiune de testare cu numere intregi cu unitate de procentaj i care utilizeaza o constrangere de tip matrice sau lista de cuvinte. Opiunea int-inexact (7/7) este o opiune de testare cu numere intregi care incrementeaza valoarea solicitata i returneaza fanionul SANE_INFO_INEXACT. OPIUNI DE TESTARE FIXE Exista 3 opiuni de testare fixe in total. Opiunea fixed (1/3) este o opiune de testare fixa, fara unitate (de masura) i fara set de constrangeri. Opiunea fixed-constraint-range (2/3) este o opiune de testare fixa cu unitate de microsecunda i interval de constrangere stabilit. Minimul este -42,17, maximul 32767,9999, iar cantitatea este 2,0. Opiunea fixed-constraint-word-list (3/3) este o opiune de testare fixa, fara unitate i cu lista de cuvinte de constrangere stabilita. OPIUNI DE TESTARE DE IRURI Exista in total 3 opiuni de testare a irurilor. Opiunea string (1/3) este o opiune de testare a irurilor fara constrangere. Opiunea string-constraint-string-list (2/3) este o opiune de testare a irurilor cu constrangere de lista de iruri. Opiunea string-constraint-long-string-list (3/3) este o opiune de testare a irurilor cu constrangere de lista de iruri. Conine mai multe intrari... OPIUNE DE TESTARE A BUTONULUI Opiunea button (1/1) este o opiune de testare a butonului. Imprima un text... FIIERE /etc/sane.d/test.conf Fiierul de configurare a controlorului (a se vedea, de asemenea, descrierea SANE_CONFIG_DIR de mai jos). Valorile iniiale ale majoritaii opiunilor SANE de baza pot fi configurate in acest fiier. Un ablon care conine toate valorile implicite este furnizat impreuna cu acest controlor. Una dintre cele mai interesante valori poate fi number_of_devices (numar de dispozitive). Ea poate fi utilizata pentru a verifica capacitatea aplicaiei de interfaa de a afia o lista lunga de dispozitive. Valorile de configurare privind rezoluia i geometria pot fi utile pentru a testa modul de gestionare a fiierelor de dimensiuni mari. /usr/lib/sane/libsane-test.a Biblioteca statica care implementeaza acest controlor. /usr/lib/sane/libsane-test.so Biblioteca partajata care implementeaza acest controlor (prezenta pe sistemele care accepta incarcare dinamica). MEDIU SANE_CONFIG_DIR Aceasta variabila de mediu specifica lista de directoare care pot conine fiierul de configurare. Pe sistemele *NIX, directoarele sunt separate prin doua puncte (,,:"), in cazul sistemelor OS/2, ele sunt separate prin punct i virgula (,,;"). Daca aceasta variabila nu este definita, fiierul de configurare este cautat in doua directoare implicite: mai intai, in directorul de lucru curent (,,.") i apoi in /etc/sane.d. Daca valoarea variabilei de mediu se termina cu caracterul separator de directoare, atunci directoarele implicite sunt cautate dupa directoarele specificate explicit. De exemplu, daca se definete SANE_CONFIG_DIR la ,,/tmp/config:", se vor cauta (in aceasta ordine) directoarele tmp/config, . i /etc/sane.d. SANE_DEBUG_TEST Daca biblioteca a fost compilata cu suportul de depanare activat, aceasta variabila de mediu controleaza nivelul de depanare pentru acest controlor. Nivelurile mai mari de depanare cresc cantitatea de detalii informative a ieirii. Exemplu: export SANE_DEBUG_TEST=4 CONSULTAI I sane(7), scanimage(1), xscanimage(1) http://www.meier-geinitz.de/sane/test-backend/ AUTOR Henning Meier-Geinitz ERORI - valorile din fiierul de configurare nu sunt testate pentru corectitudine 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 . 14 iulie 2008 sane-test(5)