Insticksprogram för webbkamera till SalsaJ Användarmanual Arkadiusz Kalicki, Lech Mankiewicz Innehåll Innehåll.. 1 Installation. 2 Hur insticksprogrammet används.. 3 1. Att köra insticksprogrammet (plugin)... 3 2. Kamerainställningar.. 3 3. Att ta bilder... 5 4. Att filma 6 Hotline för webbkameraprogrammet. 7 Kommandon på svenska... 7 Den engelska versionen av manualen finns tillgänglig på http://www.euhou.net under Tools Detta projekt har genomförts med stöd från Europakommissionen. Texten återspeglar enbart författarnas åsikter, och Kommissionen kan inte i något avseende hållas ansvarig för någon användning av denna information som kan uppkomma. Översättning: Christer Nilsson, Vetenskapens Hus Stockholm dec. 2006 1
Installation Installera den senaste versionen av SalsaJ med Webcam plug-in från http:// www.euhou.net/. När du laddar ner SalsaJ, se till att du får med JRE, JMF och Webcam plug-in. Läs igenom instruktionerna för hur SalsaJ ska installeras! Att tänka på: När du kör en kamera som byggts om för långtidsexponeringar under Windows behöver du köra java med AllowIO.exe (se: salsaj.bat, adressen för LPT1-porten är 0x378). Om det inte fungerar, kontrollera att du har PortTalk.sys i C:\Windows\System32\Drivers om den inte finns där, kan du kopiera filen från SalsaJ-mappen till nämnda katalog. För att köra Philips webbkameror under Linux behöver du installera och köra PWC kernel module. För kameror modifierade för långtidsexponeringar behöver du köra parport and parport_pc. 2
Att använda insticksprogrammet (plugin) 1. Att köra tillämpningen Starta SalsaJ med batfilen salsaj.bat och gör menyvalet Plugins/webcam/WebcamPanel. Nu visas webbkamerafönstret (se fig. 1). Du kan välja mellan följande knappar: Image Acquisition (ta en bild), Movie Acquisition (filma), Camera Settings (kamerainställningar) eller Close som stänger fönstret. Fig. 1: webbkamerafönstret 2. Kamerainställningar Fönstret för kamerainställningar visas i fig. 2 nedan. Du kan välja mellan Normal exposure (normalexponering) och Long exposure (längre exponering). Kamerainställningar Fig. 2: 3
Normalexponering Välj detta alternativ när du vill göra normalexponeringar (kortare än 1 sekund) Detta fungerar både för kameror som byggts om för längre exponeringar och för icke ombyggda. Om du inte tänker göra längre exponeringar rekommenderar vi att du inte ansluter kameran till LPT1-porten. Om du har anslutit till denna port måste du initialisera porten även om du bara ska använda Normal exposure. För att initialisera porten, tryck på Long exposure, klicka OK, öppna kamerafönstret igen, klicka på Normal exposure och OK. Knappar i fönstrets vänstra halva (Normalexponering): Video device - välj infångningsrutin (capture device) /förinställt: Microsoft WDM Image Capture (WIN32):0/ Video format - välj bildstorlek, t ex 320 x 240 pixlar Framerate [f/s] - bilder/sekund (b/s). Ditt val skriver över aktuell hastighet för framerate i fönstret Advanced settings. Förinställt: 15 b/s. Show preview bild från kameran i särskilt fönster (förhandsvisning) Advanced settings tar fram fönstret med avancerade kamerainställningar Lång exponering (knappar i högra halvan av fönstret för kamerainställningar) Välj detta alternativ när du vill göra längre exponeringar med en modifierad kamera. Den extra insatta kabeln skall då vara ansluten till datorns skrivarport (finns ofta inte på nyare modeller av bärbara datorer). Control port välj port, normalt LPT1 Port initialization ange portens initialiseringsvärde, förvalt 15 Exposure start ange exponeringens startvärde, förvalt 0 Amp ON mask förstärkning PÅ mask, förvalt 4 Exposure end ange stoppvärde för exponeringen, förvalt 7 Amplifier fungerar bara för kameror som byggts om enligt anvisningar i detta projekt On markeras om du vill koppla in förstärkaren under exponeringen, förvald. OFF (exposure ON) markeras om du vill stänga av förstärkaren för att kunna koppla in den bara under en exponering Video format välj videoformat och bildstorlek Klicka på OK för att bekräfta ändringarna eller på Close om inga ändringar gjorts. Påminnelse: Om du inte planerar göra långa exponeringar behöver du inte ansluta den extra kabeln till LPT1-porten se ovan under Normalexponering! 4
3. Att ta bilder (image acquisition) Fönstret för bildtagning visas i fig. 3. Det används för att spara ner enstaka bilder eller en serie av bilder från kameran för att lagra i något av formaten FITS (.fts), JPEG (.jpg) eller BMP (.bmp). Fig. 3: Fönstret för bildtagning (Image Grabb) Inställningar och knappar: Exposure time exponering i sekunder, aktiv när Long exposure har valts. Interval mellanrum (i sekunder) mellan exponeringarna Number of images ange antalet bilder i serien Now, From, From to seriens varaktighet Now: Exponeringen påbörjas direkt när du trycker på Record -knappen och avslutas när du trycker på Stop -knappen eller när antalet nåtts som angivits i Number of images. From: anger att bildtagningen börjar när du tryckt på Record -knappen och tiden du angivit i rutan From uppnåtts. Exponeringen avbryts då du trycker på Stop eller då antalet bilder som angivits i rutan Number of images har uppnåtts. From to: anger att exponeringen startar när du tryckt på Record -knappen och starttiden (som angivits i rutan From ) uppnåtts och avbryts när du trycker på Stop -knappen eller då tiden som angivits i rutan To har uppnåtts. Antalet som angivits i rutan Number of images gäller inte när du valt From to -alternativet. I rutorna From och To anges start- respektive stopptiderna för exponeringen UT (Universal Time) i ISO 8601-formatet (t ex 2006-09-02T21:20:50). Preview väljes om du vill se vad kameran just ser Record, Stop starta och stoppa exponering 5
Save series to - väljs för att spara exponerade bilder Fits, BMP, JPEG välj bildformat. Om du väljer Fits-formatet sparas dessutom extra information om bilden ( header ). Fits header öppnar fönstret med fits-inställningar, se fig. 4. Folder, file name välj den folder där du vill spara bilderna, välj (generic) filnamn. Star, No of digits bestämmer filnumreringen, t ex betyder 001 att första bilden får nummer 001 och den sista möjliga i serien är nummer 999. Close stäng fönstret Fits header details -fönstret visas i fig. 4 nedan. Det används för att bestämma ett antal nyckelord för Fits header. Fig. 4: Fits header-fönstret Följande värden lagras i Fits header när man väljer Save series to Fits: Center of image Ra, Dec koordinaterna för bildens mittpunkt Pixel size x, y pixelstorlek för kameran i µm (5,6 µm för Philipskameror). Focal length brännvidden för kameraobjektivet, förval: 58 mm (för det projektets medlevererade objektiv). Object name objektets namn, t ex Jupitet Image type objekt, dark (dark frame), eller flat Observer t ex ditt namn Observatory observatoriets namn (om aktuellt) Telescope använt teleskop Epoch observationsepok, t ex Altitude, Longitude, Latitude anger observationsplatsens läge 6
4. Att filma Fönstret som används när du vill ta en filmsekvens visas i fig. 5 nedan. Fig. 5: Att ta en filmsekvens Inställningar, knappar: Save as välj namn och mapp för att spara en tagen filmsekvens Start börja filma Pause gör en paus i filmningen Stop sluta filma Close avsluta filmning och stäng fönstret Hotline för webbkameraprogrammet Om du har några frågor om hur du använder webbkameran tillsammans med SalsaJ, kan du kontakta oss via mejl (euhou@euhou.net) eller ringa oss via Skype (www.skype.com) till adressen lech_mankewicz (en av författarna till denna manual). Kommandon på svenska Du kan definiera namn på kommandon på andra språk i detta insticksprogram genom att skapa och editera en fil WebcamPlugin_xx.properties, där xx = sw för svenska. 7