www-apps/phpSANE-0.8.0
[anomen-overlay.git] / www-apps / phpSANE / dev / doc / README_PL.txt
blobb4dd57d35c724a0c80a6986047b9f47eae9c5baf
1    phpSANE   (Version 0.6.0)
2   ~~~~~~~~~
4 phpSANE jest interface'em do obsługi skanera napisanym w języku PHP
5 wystarczy że skaner podłączony jest do komputera gdzie masz zainstalowany
6 serwer www wraz z php, a użytkownik końcowy wystarczy że skorzysta
7 z przeglądarki www - oro sposób na 'udostępnienie' dowolnego skanera w sieci
8 lokalnej.
10 Copyright (C) 2009  David Froehlich <dfroe@gmx.de>
11                     and John Walsh <john.walsh@mini-net.co.uk>
12                     and Wojciech Bronisz <wojtek@bronisz.eu>
14 This program is free software; you can redistribute it and/or modify it under
15 the terms of the GNU General Public License as published by the Free Software
16 Foundation; either version 2 of the License, or (at your option) any later
17 version.
18 This program is distributed in the hope that it will be useful, but
19 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
21 details.
22 You should have received a copy of the GNU General Public License along
23 with this program; if not, write to the Free Software Foundation, Inc., 59
24 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
27 ------------------------------------------------------------------------
29 Requirements:
30 ^^^^^^^^^^^^^
31 * SANE
32 * netpbm
33 * Apache web-server with PHP-support
34 * gocr (optional)
37 ------------------------------------------------------------------------
39 Installation:
40 ^^^^^^^^^^^^^
41 Just copy the phpSANE-directory into your www-root.
42 Then you can scan by opening phpsane.php in your web-browser.
45 ------------------------------------------------------------------------
47 FAQ:
48 ^^^^
50 Q: How do I check if my scanner is working ?
52 A: Before trying phpSANE, it is a good idea to make sure that your
53 scanner is detected and working from the local machine. To do this,
54 just use one of the scanner applications :-
56 Application Menu->Graphics->Scanner Tool
57 Application Menu->Graphics->The GIMP, File->Aquire->XSane: Device Dialog...
59 If your scanner does not work directly from your machine, then it will
60 not work through phpSANE.
62 ----------
64 Q: My scanner isn't found by phpSANE ?
65 Q: My scanner is detected, but when I preview or scan, the image file
66 is empty ?
68 A: this is probably a permissions problem, try :-
70 chmod +s /usr/bin/scanimage
71 chmod 775 WWW_PHPSANE_DIR/tmp
73 WWW_PHPSANE_DIR = the www file area you put phpSANE at.
75 ie. Make sure that your apache user is able to scan with scanimage,
76 and your apache user must have write-access to the phpSANE tmp directory.
78 ----------
80 Q: phpSANE is showing my scanner by a different name/model ?
82 A: In different regions of the world, a scanner may be sold by different
83 model names and numbers, but the internal hardware is exactly the same.
84 So it may be that to the SANE project, the scanner is recognised by a
85 different name to the one that you know your scanner as. For example,
86 the Epson Perfection range of scanners are sold in Japan under the
87 model names GT-****.
89 ----------
91 Q: phpSANE is working, but when I 'Scan', nothing happens ?
93 A: There could be two things wrong :-
95 a) the 'Scan Area' could be invalid,
96 ie. you have not selected an area to scan.
98 b) when a scan completes, a new window is opened with the scan
99 results to allow you to save it - this may be blocked by a
100 'pop-up' blocker.
102 ----------
104 Q: phpSANE is working fine, but how do I restrict access to it to my
105 internal network only ?
106 A: in httpd.conf :-
108 <Directory "WWW_PHPSANE_DIR/">
109     DirectoryIndex phpsane.php
110     Order Deny,Allow
111     Deny from all
112     Allow from 127.0.0.0/8
113     Allow from 192.168.1.0/24
114 </Directory>
116 ------------------------------------------------------------------------