[[TOC(heading=Inhoudsopgave)]]
[[TOC(heading=Hoofdstukken, sectionindex, compact, Documentatie/Beheershandleiding/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, Documentatie/)]]
[[TOC(heading=Releases, compact, titleindex, depth=1, Releases/*)]]

= Scannen en Foto's =

== Scan-Module Aanzetten ==

De scan-module is `f080_scan_twain`. Voeg dit toe aan de adaptatie-init bij de `import`s en ook in `start()`. De module heeft geen parameters. Nadat de module aangezet is, is het nodig om de sjablonen-codetabel te synchroniseren om de nieuwe sjablonen (voor scans in dossier, behandeltraject en bezoek) toe te voegen. De eenvoudigste manier om dat te doen is:

{{{
Python27\python.exe script.py codetabel --load sjabloon
}}}

Hierna is de module klaar voor gebruik.

(NB. Er komt nog wel een module-parameter, om evt. de backend (WIA of TWAIN) te kunnen selecteren; als je onder Linux wilt testen wordt de SANE-backend gebruikt en moet je die configureren voor het soort apparaat dat je hebt.)

== Scan-Module Gebruiken ==

Bij de correspondentie voor de patiënt, bij zorgtrajecten en bij bezoeken kan je nu kiezen voor ''SCAN'' en ''FOTO''. Effectief zijn die hetzelfde -- ze roepen een scanner of camera aan -- maar de FOTO-opties voegen maar een plaatje toe (als JPEG-bestand) terwijl de SCAN-opties een map aanmaken waar meerdere scan-pagina's in opgeslagen kunnen worden.

Na het kiezen van ''SCAN'' of ''FOTO'' wordt het standaard correspondentie-dialoog getoond met thema-keuzes, maar nu met extra velden:
 - ''Korte omschrijving'' Geef hier minstens een woord op voor de omschijving. Dit wordt gebruikt om de bestandsnaam of de naam van de bestandsmap te bepalen. Als je een bestaande omschrijving (die al in gebruik is bij de patient) gebruikt, worden bestanden toegevoegd aan de scan.
 - ''Kies scanner'' Een vinkje om aan te geven dat er een andere scanner of camera gebruikt moet worden. Als er geen geselecteerd is, dan moet er altijd gekozen worden. Een eenmaal gekozen scanner wordt onthouden, totdat dit vinkje weer eens aangezet wordt.
 - ''Scanner instellingen'' Een vinkje om aan te geven dat de instellingen gewijzigd moeten worden. OpenAC probeert meestal A4 op 100dpi te scannen, maar met dit vinkje kunnen die instellingen worden overschreven. Welke instellingen veranderd kunnen worden hangt af van de driver van de scanner of camera. De instellingen worden niet onthouden door OpenAC.
 - ''Pagina-invoer'' (alleen bij scanners) Hiermee is te kiezen of de invoer op een glasplaat-scanner ligt, of in een document-feeder zit. In de praktijk is dit alleen nuttig om de feeder uit te zetten (en maar een enkele pagina te scannen) met een scanner met document-feeder.


Nadat de korte omschrijving is ingevuld en op OK wordt geklikt, volgt eventueel een dialoog om de scanner te selecteren uit een lijst. Daarna kunnen eventueel apparaat-instellingen worden gewijzigd, en wordt de scan uitgevoerd.




=== Een Foto Maken ===

Indien een foto wordt gemaakt, slaat OpenAC een enkele foto op als JPEG bestand. Dit verschijnt ook als link in de correspondentie. Klik op de link om de foto te tonen in een paint of foto-viewer programma. De foto's worden als gewoon bestand opgeslagen, in de OpenAC bestanden-map (bijvoorbeeld met de naam ''ACT-000009-2015-05-17-15.30.08-portret.jpg'').

Een tweede foto met dezelfde omschrijving heeft normaliter een andere timestamp en wordt als ander bestand opgeslagen. Gebruik eventueel het prullenbakje om overbodige foto's te verwijderen.

=== Foto Tonen in Dossier ===

Naast de patiëntgegevens bovenaan het dossier -- nummer, naam, geboortedatum en aantekeningen -- kan een plaatje worden vertoond.

[[Image(dossierfoto.png, align=center, class=inline)]]

Welk plaatje wordt vertoond kan worden ingesteld door de model-klasse voor Patient aan te passen en de methode `displayfoto()` aan te passen. De functie moet een bestandsnaam teruggeven. Er is een demonstratie-implementatie en twee implementaties die nuttig zijn voor productie.

 - `displayfoto_geslacht` Deze implementatie, voor demonstratie-doeleinden, plaatst een venus- of mars-teken afhankelijk van het geslacht van de patiënt.
 - `displayfoto_fotosjabloon` Deze implementatie laat het meest recente bestand zien dat is toegevoegd met sjabloon ''FOTO-dossier''. Dit is nuttig als de scan-module in gebruik is en dat sjabloon wordt gebruikt voor de foto's.
 - `displayfoto_fotobestand` Deze implementatie laat het meest recente bestand zien dat is toegevoegd met een bestandsnaam dat eindigt op ''foto.jpg''. Dit is bruikbaar als een extern fotoprogramma wordt gebruikt in combinatie met de OpenAC-spooler die bestanden aan het dossier toevoegt.

Om een van deze implementaties te gebruiken, heb je een `model.py` nodig in de adaptatie (of een `model/` directory). Zet bovenaan het bestand waar de Patient-klasse gedefinieerd wordt, deze import:

{{{
from kern.s040_dossier import foto
}}}

Voeg deze methode toe aan de model-klasse Patient:

{{{
    def displayfoto(self):
        return foto.displayfoto_geslacht(self)
}}}

(Vul hier in de implementatie die gewenst is: in het voorbeeld wordt de demo-functie gebruikt die niet zinvol is voor productie.)


=== Een Scan Maken ===

Een scan kan meerdere pagina's bevatten. Elke pagina wordt opgeslagen in een apart bestand (meestal een JPEG bestand van de gescande pagina), en alle pagina's van een scan-sessie zitten samen in een  map. De scan-mappen worden aangemaakt in een speciale map ''scans'' binnen de OpenAC bestanden-map. Scans verschijnen in het dossier als link met uitgang ''.scan'' en een naam gebaseerd op de omschrijving die is opgegeven.

Als een tweede scan gemaakt wordt met dezelfde omschrijving, worden de pagina's van de tweede scan toegevoegd aan de eerste scan en verschijnt er geen extra link. Hiermee kan met een glasplaat-scanner toch een meerbladig document worden gescand en opgenomen als een enkele bestandslink in het dossier.

Een scanner met document-feeder kan meerdere pagina's achter elkaar scannen; deze worden allemaal opgenomen als een enkel scan-document in het dossier.

Als een scan-link wordt aangeklikt, worden de scans geopend in een OpenAC-eigen meerbladige-scanviewer. Hiermee kan eenvoudig worden gebladerd door de afbeeldingen (pagina's) van de scan.




== Scanners ==

De scan-module is getest met de volgende scanners:

 - Epson RX420 (een multifunctie printer/scanner) met Windows Vista
 - Kodak i1150 (een scanner met document-feeder) met Windows 7
 - Canon DR-C125 (een scanner met document-feeder) met Windows 7
 - Geintegreerde webcam met Linux