Uživatelský manuál k programům PVC Finder a PVC Frame Generator Martin Fiala

Uživatelský manuál k programům PVC Finder a PVC Frame Generator.

20.05.2013 © 2013 Martin Fiala

Strana 1

Obsah: 1. Stručná charakteristika programů

3

1.1 Program PVC Finder

3

1.2 Program PVC Frame Generator

3

2. Hardwarové a softwarové požadavky 2.1 Výkonové požadavky PC a OS požadavky

3 3

2.2 Místo na disku

3

2.3 Požadavky na přípojný bod internetového připojení

4

3. Instalace programů

4

3.1 Závislosti na jiném software

4

3.1.1 Program EasyPHP

4

3.1.2 Program ffmpeg

4

3.2 Instalace programů PVC Finder a PVC Frame Generator 4. Nastavení programů a přípojného bodu (routeru) 4.1 Zprovoznění http serveru

7 7

4.1.1 Zjištění IP adresy vašeho přípojného bodu

7

4.1.2 Viditelnost http portu

7

4.1.3 Nastavení port forwardingu na přípojném bodu

8

4.1.4 Konfigurace http serveru

9

4.2 Nastavení povinných parametrů programu PVC Finder

11

4.2.1 Nastavení Identity Key

11

4.2.2 Nastavení IP adresy přípojného bodu

13

5. Použití programů PVC Frame Finder a PVC Frame Generator 5.1 Generátor obrázků PVC Frame Generator

13 13

5.1.1 Spuštění programu

13

5.1.2 Popis GUI

14

5.1.3 Výstup programu

15

5.2 Program PVC Finder

Strana 2

5

15

5.2.1 Spuštění programu

15

5.2.2 První spuštění programu

15

5.2.3 Spuštění nového hledání

16

5.2.4 Spuštění uloženého hledání

20

5.2.5 Nastavení volitelných parametrů hledání

21

5.2.6 Změna Identity Key

23

5.2.7 Zobrazení informací o programu

23

5.2.8 Ukončení programu

23

5.2.9 Informace o možnosti omezení správného fungování programu

24

1.Stručná charakteristika programů 1.1 Program PVC Finder PVC Finder (Pirated Video Copy Finder) je nástrojem pro usnadnění a automatizaci vyhledávání nelegálních kopií video souborů na internetu. Program používá službu Google Images a je na ní zcela závislý. Umožňuje automatizaci vyhledávání za pomoci snímků získaných ze zdrojového video souboru, které program postupně prochází a odesílá službě Google Images a umožňuje tak automatizaci vyhledávání za použití těchto obrázků. Poté probíhá automatické surfování (crawling) získanými (od Googlu) internetovými adresami a vyhledávání podezřelého obsahu a odkazů, vyhodnocení podezřelých nálezů z hlediska pravděpodobnosti výskytu nelegálního obsahu a zobrazení nálezů. Produkt umožňuje najít zejména výskyt souborů ve formátu streamovaného flash videa a aktivní odkazy na soubory uložené pomocí některých ze služeb pro sdílení souborů. Program je spustitelný pouze v operačních systémech MS Windows. Program vyžaduje pro svoji funkci nastavení a provoz http serveru.

1.2 Program PVC Frame Generator PVC Frame Generator je program pro automatické vygenerování a výběr vhodných snímků ze zdrojového video souboru. Program je spustitelný pouze v operačních systémech MS Windows.

2 Hardwarové a softwarové požadavky 2.1 Výkonové požadavky PC a OS požadavky Vhodný je jakýkoli systém, na kterém běží plynule operační systémy Windows XP nebo Windows 7. Program nebyl testován ve Windows Vista, ale teoreticky by měl fungovat i v tomto systému.

2.2 Místo na disku Instalace programů PVC Finder a PVC Frame Generator vyžaduje 55MB volného místa na disku. Jestliže na počítači není nainstalován program EasyPHP, bude nutné provést jeho instalaci, jež zabere cca 180MB v závislosti na verzi programu. Pro použití programu je třeba ještě další místo pro uložení obrázků, které je možné vygenerovat pomocnou aplikací PVC Frame Generator a které bodou použity jako vstupy při vyhledávání. Více informací k tomuto bodu najdete v kapitole 5.1.2. Pokud budou obrázky generovány pomocí aplikace PVC Frame Generator, je nutné provést instalaci programu ffmpeg, která zabere cca 57MB.

Strana 3

2.3 Požadavky na přípojný bod internetového připojení Aby program fungoval, je nezbytně nutné nastavení a spuštění http serveru. Pro splnění tohoto požadavku musí být splněny následující podmínky: 1) Http port 80 nesmí být blokován Vaším poskytovatelem internetového připojení. 2) Na přípojném bodu (routeru) musí být nastavitelný port forwarding. Program by dále nemohl fungovat v případě, že v průběhu hledání dojde ke změně IP adresy přiřazené přípojnému bodu poskytovatelem připojení. Jestliže běžně denně dochází ke změně IP adresy, provoz programu nebude reálně uskutečnitelný.

3. Instalace programů 3.1 Závislosti na jiném software 3.1.1 Program EasyPHP Program PVC Finder potřebuje ke své funkci externí http server a v této verzi (1.0) musí být nainstalován do adresáře, který je http serverem zpřístupňován. Doporučenou a v tomto manuálu dále uvažovanou variantou řešení http serveru je freewarový program EasyPHP, jehož součástí je mimo jiné známý http server Apache. S použitím tohoto programu (EasyPHP-5.3.8.1) byl PVC Finder vyvíjen a testován. Před instalací programu PVC Finder je tedy nutné nainstalovat program EasyPHP. Jeho nejnovější verzi je možné stáhnout na oficiálních stránkách www.easyphp.org. Instalace programu EasyPHP je poměrně přímočará a podrobné informace o ní je možné nalézt na výše uvedené domovské adrese programu.

3.1.2 Program FFMPEG Program PVC Frame Generator sloužící k vygenerování obrázků ze souboru s videem používá program FFMPEG, který umožňuje provádět operace jako je konverze video formátu, extrakce určitých snímků apod. Tento program je nutné stáhnout a nainstalovat do složky ffmpeg do instalačního adresáře programu PVC Frame Generator. Instalace programu PVC Frame Generator (která proběhne při instalaci programu PVC Finder) musí tedy předcházet instalaci programu FFMPEG. Je nutné použít 32-bitovou verzi přeloženou pro Windows OS, jíž je možné aktuálně (2013) zdarma stáhnout na adrese http://ffmpeg.zeranoe.com/builds/. Stažený archiv je dále nutné rozbalit do adresáře pojmenovaného přesně „ffmpeg“ (tzn. bez verze souboru), do instalačního adresáře aplikace PVC Frame Generator. Instalátor programu PVC Finder nainstaluje i aplikaci PVC Frame Generator do stejného adresáře jako PVC Finder, cesta na disku k programu FFMPEG potom tedy bude …/PVC Finder/ffmpeg. FFMPEG musí být nainstalován právě do této složky, jinak nebude program PVC Frame Generator fungovat.

Strana 4

3.2 Instalace programů PVC Finder a PVC Frame Generator Je-li program EasyPHP nainstalován, je možné přistoupit k instalaci programu PVC Finder obsahující i program PVC Frame Generator. Instalační soubor je možné stáhnout po zaplacení produktu na domovských stránkách programu www.pvcfinder.hostuju.cz/pvcfinder.php přímo z těchto stránek. Oba produkty jsou nainstalovány pomocí průvodce. Postup instalace programu PVC Finder a PVC Frame Generator s pomocí průvodce 1. Spusťte soubor s instalací programu PVC Finder za pomoci průvodce (PVCFinder-installer_Code-no.exe). 2. První dialogové okno informuje o skutečnosti, že je nutné nainstalovat program EasyPHP před instalací programu PVC Finder. Klikněte na tlačítko „Ano“ pro pokračování průvodce, jestliže byl program EasyPHP již nainstalován. V opačném případě klikněte na tlačítko „Ne“ a instalátor bude ukončen. 3. Objeví se uvítací stránka instalátoru, klikněte na „Next“. 4. Zobrazí se text licence programu PVC Finder. Jestliže s ním souhlasíte, zatrhněte možnost „I accept the agreement“ a klikněte na tlačítko „Next“. 5. Zobrazí se text licence programu PVC Frame Generator. Jestliže s ním souhlasíte, zatrhněte možnost „I accept the agreement“ a klikněte na tlačítko „Next“. 6. Objeví se dialogové okno pro nastavení adresáře, do kterého se program nainstaluje (obr. 1). Program PVC Finder je v aktuální verzi nutné nainstalovat do složky „www“, která se nachází v instalačním adresáři programu EasyPHP. Předdefinovanou cestu „C:\Program Files (x86)\EasyPHP5.3.8.1\www\PVC Finder“ je třeba změnit tak, aby odpovídala skutečné instalaci EasyPHP na počítači. Nastavení správné cesty je možné provést pomocí tlačítka „Browse“ a následného nalezení složky www na disku nebo přímou editací předdefinované cesty v textovém poli. Po nastavení platné cesty klekněte na tlačítko „Next“. 7. Nyní je možné nastavit název a umístění složky programu v nabídce Start. Můžete editovat název programu v textovém poli nebo použít tlačítko „Browse“ pro zařazení programu do jiné složky než v jaké se aktuálně nachází. Po provedení požadovaných změn klikněte na tlačítko „Next“. 8. V tomto dialogovém okně můžete iniciovat vytvoření zástupce programu na ploše zatržením checkboxu. Jestliže checkbox nezatrhnete, ikona na ploše nebude vytvořena. Po zvolení požadované možnosti klikněte na tlačítko „Next“. 9. Zobrazí se přehled některých navolených instalačních parametrů. Jestliže jsou v pořádku, klikněte na tlačítko „Install“. Spustí se proces extrakce instalačních souborů a jejich kopírování do cílového adresáře (obr. 2). 10. V případě úspěšného dokončení předchozí operace se zobrazí okno informující o úspěšném dokončení instalace, které zároveň nabízí i spuštění programu PVC Finder (obr. 3). V případě, že chcete nyní spustit program, ponechte check box zatržený, v opačném případě jej kliknutím odznačte. Klikněte na tlačítko „Finish“.

Strana 5

Obr. 1. Dialogové okno pro nastavení cílového adresáře instalace. Je třeba nastavit platnou cestu do adresáře www programu EasyPHP. Obr. 2. Dialogové okno zobrazující průběh extrakce a kopírování souborů.

Strana 6

Obr. 3. Okno informující o úspěšné instalaci.

4.Nastavení programů a přípojného bodu (routeru) 4.1 Zprovoznění http serveru Obrázky získané z filmu jsou službě Google Images poskytovány přímo z adresáře na disku počítače s instalací programu PVC Finder pomocí http serveru. Nezbytným krokem pro použití programu PVC Finder je tedy i nastavení http serveru a http server musí být nastartován před spuštěním vyhledávání.

4.1.1 Zjištění IP adresy vašeho přípojného bodu Pro zjištění IP adresy můžete využít službu na adrese http://www.cmyip.com/ nebo jinou z mnoha podobných služeb snadno zjistitelných na internetu. IP adresa by také měla být určitě uvedena v příslušné sekci webového rozhraní přístupového bodu.

4.1.2 Viditelnost http portu Dále je nutné zjistit, jestli váš poskytovatel připojení neblokuje port 80 (standardní port pro web). To je možné ověřit např. na adrese http://www.canyouseeme.org, kde je nutné zadat hodnotu 80 do pole „What port?“ a stisknout tlačítko „Check your port“. Pokud se zobrazí zpráva informující o

Strana 7

úspěchu, port 80 není blokován. V opačném případě se můžete pokusit tuto skutečnost změnit v nastavení vašeho přípojného bodu. Zprovoznění portu 80 je nutné pro používání programu PVC Finder.

4.1.3 Nastavení port forwardingu na přípojném bodu Pro správnou funkci http serveru je nutné, aby přípojný bod přeposílal příchozí pakety na počítač, na kterém budete provozovat http server, proto je nutné zjistit IP adresu vašeho počítače ve vaší lokální síti. Toho lze docílit pomocí příkazu ipconfig příkazové řádky systému Windows.

Postup pro zjištění IP adresy PC v lokální (domácí) síti • • •

Spusťte příkazovou řádku systému Windows. Napiště příkaz ipconfig a potvrďte. Je-li váš počítač připojen k síti, zobrazí se v závislosti na způsobu vašeho připojení (Ethernet, bezdrátové) v příslušné kolonce (obr. 4) IP adresa verze 4 vašeho počítače (v domácí síti to bývá typicky hodnota okolo 10.0.0.1, ale může se lišit).

Tuto adresu je nyní nutné nastavit pro port forwarding na vašem přípojném bodu. Konkrétní způsob nastavení závisí na typu vašeho přípojného bodu a podrobné informace k jeho nastavení by měly být uvedeny v jeho uživatelském manuálu. Postup obvykle sestává v připojení se k vašemu přípojnému bodu pomocí webového prohlížeče a nastavení potřebných vlastností. Ve většině případů se v nastavení v sekci Network vyskytuje položka Port forwarding, kde je třeba nastavit IP adresu vašeho počítače pro službu www. Užitečné informace pro nastavení port forwardingu na vašem přípojném bodu často naleznete pomocí internetového vyhledávače.

Strana 8

Obr. 4. Výpis programu ipconfig v české mutaci Windows 7. IP adresa verze 4 počítače v domácí síti je zde 10.0.0.1

4.1.4 Konfigurace http serveru Postup pro konfiguraci http serveru •

• • • • •

• •

Spustťe program EasyPHP. V pravém dolním rohu hlavního panelu systému Windows by se měla brzy objevit ikona programu EasyPHP. Po najetí kurzorem myši na tuto ikonu by se měla objevit ještě informace started. Klikněte na ikonu programu EasyPHP pravým tlačítkem myši aby se zobrazilo kontextové menu. V kontextovém menu vyberte kliknutím možnost Configuration. V další nabídce vyberte položku Apache a v defaultním textovém editoru se zobrazí soubor httpd.conf. V souboru se defaultně nachází příkaz Listen 127.0.0.1:8888. Nahraďte v tomto příkazu IP adresu local hostu, čili 127.0.0.1, skutečnou IP adresou Vašeho přípojného bodu zjištěnou v kapitole 4.1.1 a číslo portu 8888 nahraďte hodnotou 80. Uložte změny v souboru httpd.conf. Restartujte program EasyPHP (pravý klik na ikonu a volba restart), aby se načetlo nové nastavení http serveru.

Po restartu je možné ověřit, zda http server správně pracuje tak, že do www složky v instalačním adresáři programu EasyPHP nakopírujete nějaký testovací obrázek a potom ho předáte pomocí vašeho internetového prohlížeče službě Google Images, která se nachází na adrese https://www.google.cz/imghp pomocí url obrázku ve tvaru http://vaseipadresa/picture.jpg. Jestliže dojde k vyhledávání

Strana 9

s využitím tohoto obrázku, http server byl úspěšně nastaven. Např. zjistíte-li pomocí návodu v kap. 4.1.1 IP adresu 121.139.45.45, odpovídající url bude http://121.139.45.45/picture.jpg Jestliže dojde k hledání s využitím obrázku, což lze poznat ze stránky s výsledky, kterou vrátí Google, http server byl úspěšně nastaven.

Obr. 5. Ikona spuštěného programu Easy PHP v systému Windows 7.

Obr. 6. Otevření konfiguračního souboru httpd.conf http serveru Apache

Strana 10

Obr. 7. Konfigurační soubor http serveru s dosazením IP adresy zobrazené na obr. 4 a http portu.

Poznámka: V konfiguračním souboru je dále možné omezit přístup k obsahu adresáře www jen pro určité IP adresy. Tímto způsobem je možné umožnit přístup pouze službě Google Images a zamezit tak nechtěným přístupům k obrázkům. Podrobnější informace ke způsobu nastavení můžete nalézt v dokumentaci k programu Apache. Poznámka: Jestliže je v lokální síti připojeno více počítačů, může se IP adresa přidělená počítači po restartu přípojného bodu změnit. Pro funkci http serveru musí být na tuto novou hodnotu aktualizován příkaz Listen v konfiguračním souboru http serveru. Potom musí být aktualizováno i nastavení port forwardingu.

4.2 Nastavení povinných parametrů programu PVC Finder 4.2.1 Nastavení Identity Key Při prvním spuštění programu PVC Finder Vás program vyzve k zadání Vašeho Identity Key řetězce. Identity Key je řetězec znaků sloužících k identifikaci instalace programu. Tento řetězec vám byl zobrazen při koupi programu spolu s možností jeho zaslání na Váš email. Jeho opětovné zaslání na email uvedený při koupi produktu je možné uskutečnit na www stránkách www.pvcfinder.hostuju.cz/identity_key_repeat.php.

Strana 11

Postup pro nastavení Identity Key Spusťte program PVCFinder. Nyní vložte Váš Identity Key do pole označeného „Identity Key entry“ a potvrďte tlačítkem „Enter“. Bez vložení korektního klíče nebude možné program používat. Program nyní ověří váš řetězec, což může trvat několik sekund. V případě neúspěšného ověření zůstane zobrazen modální dialog pro zadání správného Identity Key.

Obr. 8. Okno pro vložení Identity Key řetězce. V případě úspěšného ověření Identity Key se zobrazí okno informující o úspěšném ověření a po potvrzení přečtení této informace tlačítkem „Ok“ se zobrazí hlavní okno aplikace a program se pokusí připojit k databázi. Připojení k databázi je nutné pro správnou funkci programu. V případě, že není možné toto spojení navázat se zobrazí okno s příslušnou zprávou a program se ukončí. V případě, že program naváže úspěšně spojení, se zobrazí hlavní okno aplikace se zeleným nápisem „DB Connected“ vlevo pod hlavním menu. Důvodem pro případné neúspěšné připojení může být špatná konektivita, přetížení databázového serveru atd. Jestliže tento problém přetrvává, informujte nás o něm prosím zasláním e-mailu na adresu [email protected]. Jeho řešení se budeme věnovat hned, jak to bude možné. Poznámka: Pro úspěšné ověření Identity Key a připojení k databázi programu je nutné fungující připojení k internetu. Poznámka: V systému Windows XP se zelená indikace úspěšného připojení k databázi nemusí zobrazit.

Strana 12

Obr. 9. Hlavní okno aplikace PVC Finder s indikací úspěšného připojení k databázi.

4.2.2 Nastavení IP adresy přípojného bodu Dále je nutné sdělit programu PVC Finder IP adresu vašeho přípojení k internetu (pod kterou jste viděni z internetu), která bude použita v odkazech na obrázky na disku, které budou předávány službě Google Images. Postup pro nastavení IP adresy http serveru • V hlavním okně aplikace klikněte na položku „Search“ v hlavním menu. • Vyberte kliknutím možnost „Settings“. • V dialogovém okně nastavte IP adresu v textovém poli označeném Server IP. • Klikněte na tlačítko „Save“.

5. Použití programů PVC Finder a PVC Frame Generator 5.1 Generátor obrázků PVC Frame Generator Klíčovým vstupem programu PVC Finder jsou obrázky získané z filmu, jehož zejména ilegální výskyt na internetu si přejeme zjistit. Pro automatizaci procesu generování a výběru reprezentativních obrázků byla vytvořena jednoduchá aplikace PVC Frame Generator. Tento program umožňuje vybrat vstupní video v jednom z podporovaných formátů a spustit proces generování obrázků. Výstupní složkou programu je pevně nastavena složka s názvem filmpics, která se nachází ve složce s instalací programů PVC Finder a PVC Frame Generator.

5.1.1 Spuštění programu Spustitelný soubor s programem se nazývá PVCFgen.exe a nachází se v adresáři s instalací. Pro spuštění programu je nutné spustit tento soubor jedním ze způsobů, které nabízí systém Windows.

Strana 13

5.1.2 Popis grafického uživatelského rozhraní Hlavní okno aplikace se skládá z trojice tlačítek, dvojice textových polí, progress baru a popisků.

Obr. 10. Okno aplikace PVC Frame Generator. Program se ovládá jednoduše pomocí tlačítek označených řetězci „Choose file“, „Run“ a „Cancel“, které umožňují spouštět následující akce. Výběr souboru Po kliknutí na tlačítko „Choose file“ se zobrazí dialogové okno, které umožní vybrat vstupní video soubor na disku. Po vybrání souboru a potvrzení tlačítkem „Open“ se zobrazí cesta k vybranému souboru v textovém poli značeném „Input file“. Spuštění procesu generování obrázků Po kliknutí na tlačítko „Run“ se zobrazí dialogové okno informující o skutečnosti, že název vstupního souboru bude programem PVC Finder považován za titul filmu a výzva k případné uživatelské změně tohoto titulu. Pokud si přejete změnit název titulu, klikněte na tlačítko „yes“, v opačném případě klikněte na tlačítko „no“. V případě kliknutí na tlačítko „yes“ se zobrazí dialogové okno s editovatelným textovým polem označeným „Title“. Do tohoto pole zadejte požadovaný název filmu a potvrďte ho kliknutím na tlačítko „Enter“. V případě kliknutí na tlačítko „no“ bude jako název filmu použit název vstupního souboru. Korektní (nejlépe originální) titul filmu je klíčovou hledání relevantních výskytů daného filmu na internetu!

informací

pro

proces

Proces generování obrázků je nyní spuštěn a jeho aktuální fáze se zobrazuje v poli „Actual state of frame generating process“. Poznámka: Doba trvání se může lišit v závislosti na výkonu počítače, počtu spuštěných úloh, délce filmu atd, ale při použití aktuálních (2013) běžně dostupných PC by neměla překročit dobu 3h.

Strana 14

Zastavení procesu generování obrázků Proces je možné zastavit ve fázi výběru reprezentativních obrázků kliknutím na tlačítko „Cancel“. Poznámka: Jestli dojde k zavření aplikace před dosažením této fáze, budou soubory s obrázky pouze vygenerovány, ale nebude proveden výběr těch reprezentativních (pro generování je použita externí aplikace ffmpeg). Takto získané obrázky mohou vést ke zvýšenému výskytů nerelevantních výsledků programu PVC Finder. Poznámka: Kliknutí na tlačítko „Cancel“ může způsobit, že program nebude po dobu cca 5 sekund reagovat na žádný jiný uživatelský vstup. Důvodem je čekání na ukončení externí aplikace. Ukončení programu Program se ukončí zavřením okna programu.

5.1.3 Výstup programu Výstupem programu jsou obrázky ve formátu jpg o rozměrech stejných jako rozměry vstupního videa. Tyto obrázky budou uloženy ve složce, jejíž název je totožný s titulem, který byl uživatelem zvolen před spuštěním procesu generování a která se nachází ve složce „filmpics“, která se nachází ve složce s instalací programu PVC Finder. Cesta na disku k vygenerovaným obrázkům bude tedy .../PVC Finder/filmpics/Titul filmu/. Poznámka: Pro vstupní film o stopáži 1h 30m se může počet vygenerovaných obrázků pohybovat v intervalu 900 – 5400. Je tedy nutné počítat s patřičným množstvím volného místa na disku (pro film s rozměry 1280 x 720px průměrně cca 100MB).

5.2 Program PVC Finder 5.2.1 Spuštění programu Spustitelný soubor s programem se nazývá PVCFinder.exe. Soubor je umístěn v adresáři do kterého byl program nainstalován. Pro spuštění programu PVC Finder je nutné spustit tento soubor.

5.2.2 První spuštění programu Součástí programu PVC Finder je i ověření legálnosti použití programu pomocí jednoduchého autentizačního mechanismu. Při prvním spuštění programu je nutné vložit Identity Key, který Vám byl přidělen a sdělen při koupi programu PVC Finder výpisem na obrazovce a zaslán na e-mail uvedený při koupi. Podrobné informace k tomuto bodu se nachází v kap. 4.2.1.

Strana 15

5.2.3 Spuštění nového hledání

•

•

•

Předpokladem pro text této kapitoly a nezbytnou podmínkou pro úspěšné použití programu je, že jsou splněny následující podmínky: Program PVC Finder je spuštěn a v jeho hlavním okně vlevo nahoře je zobrazen zelenou barvou textový řetězec „DB Connected“ indikující úspěšné připojení k databázi. Při neúspěšném připojení se program hned ukončí, jeli tedy zobrazeno okno aplikace, spojení s databází je v pořádku. Další nutnou podmínkou je spuštěný (běžící) a správně nakonfigurovaný http server, tzn. program EasyPHP. Bližší informace k tomuto bodu naleznete v kapitole 4.1.4. V programu PVC Finder je nastavena relevantní IP adresa http serveru (viz 4.2.2).

Poznámka: V systému Windows XP nemusí být zelená indikace připojení k databázi zobrazena, můžete tedy zkusit spustit následující akce nehledě na tuto indikaci. Postup pro spuštění nového hledání 1) Otevření dialogového okna pro nové hledání V hlavním menu vyberte možnost „Search“ V roletovém menu potom možnost „New“. Alternativní způsob spuštění Klávesová kombinace Ctr+N Po uskutečnění jedné z výše popsaných možností se zobrazí okno s titulkem „New search“ skládající se ze dvou list view, šesti tlačítek, textového pole a progress baru. Za pomoci těchto ovládacích prvků je možné vybrat složky s obrázky, které budou použity pro hledání a spustit samotné hledání.

Obr. 11. Dialogové okno "New search" pro výběr složek a spuštění hledání. Strana 16

2) Výběr složek pro vyhledávání V levém list view nadepsaném „Folders to choose obrázky z adresáře PVCFinder/filmpics. Jestliže nebyli, seznam bude prázdný a musíte nejprve přiložené aplikace PVC Frame Generator. Z tohoto seznamu je možné pomocí čtyř tlačítek které se použijí pro vyhledávání - ty se budou vpravo.

from“ se zobrazí seznam složek s zatím žádné obrázky vygenerovány nějaké vygenerovat např. pomocí vpravo od seznamu vybrat složky, zobrazovat v seznamu v list view

Postup pro výběr požadovaných složek • Klikněte na požadovanou položku v levém list view levým tlačítkem myši. Položka se označí. • Klikněte na tlačítko s jednou šipkou doprava („>“). Položka se přesune do pravého list view. Postup pro výběr všech složek • Prvním tlačítkem se dvěma šipkami mířícími doprava (“>>”) je možné vybrat všechny složky z levého seznamu. Zbývající tlačítka umožňují přesouvat položky analogickým způsobem zpět a vyřadit je tak opět z vyhledávání. 3) Spuštění vyhledávání Po výběru požadovaných složek a jejich přesunu z levého seznamu do pravého je možné spustit vyhledávání tlačítkem „Run“. Po spuštění se zobrazí okno, do kterého se budou průběžně vypisovat nalezené url (Report Window). V okně „New search“ se bude zobrazovat v textovém poli označeném „Actually processed“ aktuálně zpracovávaný obrázek. Progress bar bude zobrazovat procento již zpracovaných obrázků. Po dokončení vyhledávání se zobrazí o tomto informující dialogové okno. Doba trvání vyhledávání závisí zejména na nastavení parametrů vyhledávání, počtu výsledků obdržených od služby Google Images, počtu vygenerovaných obrázků, výkonu počítače a rychlosti připojení k internetu. Při použití současných technologických standardů (2013) by se měla pohybovat v řádu hodin.

Strana 17

Obr. 12. Okna programu PVC Finder po spuštění hledání. Postup pro zastavení spuštěného vyhledávání Spuštěné vyhledávání je možné zastavit klepnutím na tlačítko „Cancel“ v okně „New search“. Alternativní způsob 1 Zavření okna „New search“. Alternativní způsob 2 Zavření okna „Search report“. Program se po této akci může za určitých okolností prostřednictvím dialogového okna zeptat, zda si uživatel nepřeje uložit určité mezivýsledky z „Search report“ nebo nabídnout uložení současného stavu vyhledávání pro jeho případné budoucí pokračování. Poznámka: Akce zastavení vyhledávání může způsobit, že program na dobu cca 5 sekund nebude okamžitě reagovat na jiné uživatelské vstupy. Toto chování je způsobené tím, že při zahájení vyhledávání byla spuštěna pomocná externí aplikace, na jejíž ukončení nyní program čeká. Upozornění: Při zavření dialogového okna „New search“ může dojít i k zavření hlavního okna aplikace a tím tedy i celého programu PVC Finder. Toto chování je způsobené chybou v platformě, která byla použita pro realizaci grafického uživatelského rozhraní.

Strana 18

Práce s výsledky v okně „Search report“ Po spuštění vyhledávání se zobrazí okno se seznamem doposud nalezených url. Seznam sestává ze čtyř sloupců - pořadí řádku, typ nálezu, url stránky s nalezeným obsahem a odhadovaná pravděpodobnost relevance nálezu tzn. pravděpodobnost, že na stránce se vyskytuje opravdu flash video s daným filmem nebo jeho částí nebo aktivní odkaz na stažení filmu nebo jeho části. Sloupec typ nálezu může nabývat hodnot "F" nebo "D" podle toho, jestli byl nalezen flash stream nebo odkaz na download souboru.

Obr. 13. Okno "Search report" s výsledky hledání.

Strana 19

Okno dále obsahuje dvě tlačítka, které umožňují spustit následující akce: Uložení výsledků do textového souboru • • •

Klepněte na tlačítko „Save“. Zobrazí se dialogové okno pro zadání názvu souboru, do kterého budou výsledky uloženy. Zadejte název souboru do odpovídajícího textového pole. Klepněte na tlačítko „Save“ v dialogovém okně.

Zkopírování nalezeného url do schránky • •

Klepněte na řádek obsahující požadované url. Klepněte na tlačítko „Copy to Clipb“. Url je nyní uloženo ve schránce.

5.2.4 Spuštění uloženého hledání Program PVC Finder disponuje i funkcí pro navázání na dříve spuštěná hledání, jejichž stav byl v určité fázi uložen. Předpokladem pro text této kapitoly je, že jsou splněny následující podmínky:

•

•

• •

Program PVC Finder je spuštěn a v jeho hlavním okně je zobrazen zelenou barvou textový řetězec „DB Connected“ indikující úspěšné připojení k databázi (při neúspěšném připojení se program hned ukončí, je-li tedy zobrazeno okno aplikace, spojení s databází je v pořádku). Další nutnou podmínkou je spuštěný (běžící) a správně nakonfigurovaný http server, tzn. program EasyPHP. Bližší informace k tomuto bodu naleznete v kapitole 4.1.4. V programu PVC Finder je nastavena relevantní IP adresa http serveru (viz 4.2.2). Je třeba, aby ve složce .../filmpics stále existovali složky s obrázky, které byly vybrány v uloženém hledání.

Poznámka: V systému Windows XP nemusí být zelená indikace připojení k databázi zobrazena, můžete tedy zkusit spustit následující akce nehledě na tuto indikaci. Postup pro spuštění uloženého hledání • •

•

V hlavním menu klepněte na položku „Search“. V roletovém menu klepněte na možnost „Open“ (alternativně klávesová kombinace Ctrl+O). Otevře se stejné okno (s výjimkou záhlaví) jako při spuštění nového hledání (viz 5.2.2), ale levé list view bude prázdné a v pravém list view budou zobrazeny adresáře, které nebyly v původním hledání ještě zcela zpracovány. Klepněte na tlačítko „Run“.

Výsledky a průběh vyhledávání.

Strana 20

hledání

jsou

zobrazovány

stejně

jako

při

volbě

Nové

Zastavení hledání Způsoby zastavení jsou totožné jako ve volbě Nové vyhledávání (viz 5.2.2). Poznámka: V současné verzi programu může uživatel iniciovat uložení aktuálního stavu hledání pouze nepřímo a to tak, že jedním z výše popsaných způsobů hledání předčasně zastaví. Program mu při této příležitosti nabídne mimo jiné uložení aktuálního stavu hledání. Upozornění: Při zavření dialogového okna „Old search“ může dojít i k zavření hlavního okna aplikace a tím tedy i celého programu PVC Finder. Toto chování je způsobené chybou v platformě, která byla použita pro realizaci grafického uživatelského rozhraní.

5.2.5 Nastavení volitelných parametrů hledání Program PVC vyhledávání:

Finder

umožňuje

uživatelské

nastavení

některých

parametrů

1) IP adresu http serveru, pomocí kterého je umožněn přístup k obrázkům. 2) Maximální počet přesměrování, které budou následovány při pokusu o připojení k určitému url. 3) Hloubku zanoření při procházení url získaných ve výsledcích obdržených od služby Google images. 4) Navýšení timeoutu programu pro pokusy o připojení k nalezeným url. 5) Řetězec, který bude použit jako hodnota user-agent v http hlavičce http requestu (hodnota musí být nastavena, aby bylo možné úspěšně použít službu Google Images). 6) Minimální velikost šířky obrázků, které se nebudou ignorovat při procházení url vrácených službou Google Images. 7) Minimální velikost výšky obrázků, které se nebudou ignorovat při procházení url vrácených službou Google Images. Postup pro nastavení parametrů • • •

• •

V hlavním menu vyberte položku „Search“. V roletovém menu položku „Settings“ (alternativně klávesová kombinace Ctrl+S). Zobrazí se dialogové okno, prostřednictvím kterého je možné nastavit jednotlivé parametry zadáním požadované hodnoty do odpovídajícího textového pole. Nastavte požadovaný parametr odpovídající hodnotou. Klepněte na tlačítko „Save“.

Strana 21

Obr. 14. Dialogové okno pro nastavení parametrů hledání. Pro jednotlivé parametry musí být zadány hodnoty odpovídajícího typu: 1) Do pole IP adresa je nutné zadat platnou IP adresu verze 4. Hodnota tedy musí být ve formátu ddd.ddd.ddd.ddd, kde ddd může nabývat hodnot v intervalu 0 – 255. 2) Maximální počet přesměrování je nutné specifikovat kladnou číselnou hodnotou nebo nulou. Implicitně je nastavena hodnota 3. 3) Hloubku zanoření je nutné specifikovat (rozumnou) kladnou číselnou hodnotou. Implicitně je nastavena hodnota 4. 4) Timeout pro pokusy o připojení je nutné specifikovat kladnou číselnou hodnotou nebo nulou. Tato hodnota je programem interpretována jako počet milisekund. 5) Hodnotou musí být textový řetězec. 6) Platnou hodnotou je kladné číslo nebo nula. Tato hodnota je programem interpretována jako minimální počet pixelů pro šířku obrázku. 7) Platnou hodnotou je kladné číslo nebo nula. Tato hodnota je programem interpretována jako minimální počet pixelů pro výšku obrázku. Obnovení defaultního nastavení • •

Otevřete dialogové okno pro nastavení parametrů hledání stejným způsobem jako výše. V dialogovém okně pro nastavení parametrů hledání klepněte na tlačítko „Restore default“

Poznámka: Vymazána bude i IP adresa http serveru. Před spuštěním hledání je nutné opět nastavit platnou IP adresu http serveru.

Strana 22

5.2.6 Změna Identity Key Program umožňuje nastavit nebo popřípadě změnit Identity Key i prostřednictvím hlavního menu. Tato funkce slouží pouze pro řešení situací při problémech s ověřením Identity Key. Standardně by k takovým problémům nemělo docházet. Změna správné hodnoty Identity Key na jinou hodnotu povede k jejímu neúspěšnému ověření, což může způsobit zablokování programu. Pro jeho odblokování bude nutné kontaktovat uživatelskou podporu na emailové adrese [email protected]. Postup pro změnu Identity Key • • • • •

V hlavním menu vyberte možnost „Account“. V roletovém menu klikněte na volbu „Set Identity Key“. Zobrazí se dialogové okno pro vložení Identity Key obsahující textové pole označené “Identity Key entry” pro vložení validního Identity Key. Do tohoto pole je nutné vložit Váš Identity Key a potvrdit kliknutím na tlačítko „Enter“. Program potom ověří správnost vloženého klíče, což může trvat několik sekund.

Poznámka: Pro internetu.

úspěšné

ověření

Identity

Key

je

nutné

fungující

připojení

k

V případě úspěšného ověření Identity Key se zobrazí modální dialog informující o úspěšném ověření a po potvrzení přečtení této informace tlačítkem „Ok“ se zobrazí hlavní okno aplikace. V opačném případě zůstane zobrazen modální dialog pro zadání správného Identity Key.

5.2.7 Zobrazení informací o programu V hlavním menu vyberte možnost „Help“. V roletovém menu klepněte na položku „About“.

5.2.8 Ukončení programu V hlavním menu vyberte položku „Program“. V roletovém menu vyberte položku „Exit“. Alternativní způsob Zavření hlavního okna aplikace. Alternativní způsob2 Klávesová kombinace Alt+F4.

Strana 23

5.2.9 Informace o možnosti omezení správného fungování programu Program PVC Finder je nyní zcela závislý na službě Google Images a jejím rozhraní. Dojde-li ke změnám v tomto rozhraní, existuje možnost, že program přestane částečně nebo i zcela správně pracovat. Pokročilé nastavení pro snadnější přizpůsobení programu změnám ve webovém vyhledávači obrázků je plánováno až pro případné další verze programu. Na triviální změny html jsme schopni reagovat v řádu jednotek dní a vytvořit novou verzi fungujícího programu. Taková verze programu by byla v případě, že jste si již zakoupili některou předchozí verzi programu, zcela zdarma.

Strana 24