Update help

This commit is contained in:
2022-04-26 22:32:38 +02:00
parent ba450ee554
commit adc7d07b75
7 changed files with 129 additions and 37 deletions
+71 -19
View File
@@ -1,21 +1,73 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<h2>Tenmon Help</h2>
<h3>File</h3>
<p>Open file to display it in main window</p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<h3></h3>
<p></p>
<head>
<style type="text/css">
h1, h2, h3, h4 { padding:0px; margin:10px; }
p { padding:0px; margin:5px 5px 10px 5px; }
</style>
</head>
<body>
<h2>Tenmon help</h2>
<p>Tenmon is primary for viewing astro photos and images. It can open following formats
<ul>
<li>FITS 8, 16 bit integer and 32 bit float</li>
<li>XISF 8, 16 bit integer and 32 bit float</li>
<li>JPEG and PNG images</li>
</ul>
</p>
<h3>Main windows</h3>
<p>Main window show loaded images. On the left there is<i>Image info</i> which display detailed about actual image.
<i>File system</i> display all images from current dir.
On top is main menu and under it <i>Stretch panel</i>. All panels can be closed and moved around. Closed panel can be
opened again through menu <i>Docks</i>.
</p>
<h3>Opening and saving images</h3>
<p>To open image select menu <i>File->Open</i>. After file selection this file is displayed in main windows
Panel <i>File system</i> is populated with rest of images in current directory.</p>
<p>Currently displayed image can be saved into different format with <i>File->Save as</i>. There is selection for
of formats JPEG, PNG FITS and XISF. In case of JPEG or PNG first stretch function is applied. FITS and XISF are converted
without format stretch.</p>
<h3>View</h3>
<p>Menu <i>View</i> affect size and scale displayed images. <i>Zoom In/Zoom Out</i> magnify and shrink image.
For this mouse wheel can be also used. <i>Best fit</i> display image so it is shown across whole window.
<i>100%</i> display image in 1:1 scale. <i>Fullscreen</i> show main window on whole screen.
<i>Thumbnails</i> show small thumnails for all images from current dir.
</p>
<h3>Stretch toolbar</h3>
<p>This panel change how images are displayed. First there is slider scale with three points settings.
<br><br><img src=":/about/stretch-panel.png">
<ul>
<li>black point - all pixels with value lower that set will be black</li>
<li>mid point - all pixels with this value will be shown with 50% intensity</li>
<li>white point - all pixels with value above this will be white</li>
</ul>
Next is button that set black and mid point to optimal place so image can be shown with optimal brightness.
Second button reset three values for black, mid and white point to default. Invert colors display image as negative.
Super pixel CFA average two by two pixels into one which is suitable for images from colour camera.
Last button toggle setting optimal stretch for each image individually on load.</p>
<h3>Marking imagesv</h3>
<p>Images can be marked in menu <i>Select</i>. List of marked images can be shown with
<i>Select->Show marked</i>. This dialog serve to clear marks from images. Marked images have * character in
main window title bar. Marked images can be copied or moved to selected directory with <i>File->Copy/Move marked files</i>.
After copy or move list of marked files is cleard. Program will remember list of marked files after quit.</p>
<h3>Database of FITS/XISF files</h3>
<p>Program can search direcory and index meta data from FIST and XISF images into internal database. This database can be then
searched. To index directory with FIST/XISF images select it through <i>File->Index directoryr</i>.
Selected directory is then searched and meta data from FITS and XISF images are stored into database.
To refresh database you can run <i>File->Reindex</i>. This will update any changed meta data and remove any record about
deleted files. To index new files run index directory again.</p>
<p>To show database select <i>Docks->FITS/XISF database</i>. Database is shown as table where each column is different property.
AT bottom of database panel is button to select which propertis are displayed. Next are three combo boxes and text inputs.
Combo box select which property to search and text input what value to search.
<br><img src=":/about/filter.png"><br>
In this example it search for files that have "Bias" in their file name and property OBJECT is M_42 and DATE begin with 2022.
Character % (percent sing) is wildcard represent zero, one or many characters. Character _ (underscore) is second wildcard character that
represent single character. Without wildcard character exact string is searched.</p>
</body>
</html>
+23 -13
View File
@@ -31,9 +31,16 @@ adresári kde sa nachádza zobrazený obrázok.</p>
formát JPEG, PNG, FITS a XISF. V prípade JPEG alebo PNG sa aplikuje funkcia na úpravu úrovní. Pri FITS a XISF
sa dáta skonvertujú bez zmeny úrovní.</p>
<h3>Zobrazenie</h3>
<p>Menu <i>Zobrazenie</i> ovplyvňuje veľkosť a škálu zobrazovaných obrázkov.
<i>Priblížiť/Oddialiť</i> zväčší a zmenší obrázok. Na toto tiež slúži aj kolečko myši. <i>Najlepšia veľkosť</i> zobrazí
obrázok tak aby bol zobrazený na celú plochu. <i>100%</i> zobrazí obrázok v pomere 1:1. <i>Celá obrazovka</i> zobrazí
hlavné okno na celú obrazovku. <i>Náhľady</i> zobrazí malé náhľady pre všetky obrázky z aktuálneho adresára.
</p>
<h3>Panel úrovní</h3>
<p>
Tento panel umožnuje upraviť spôsob ako sa zobrazujú obrazové dáta. Ako prvá je na tomto panely posuvná škála
Tento panel umožňuje upraviť spôsob ako sa zobrazujú obrazové dáta. Ako prvá je na tomto panely posuvná škála
na ktorej sa dajú nastaviť tri body.
<br><br><img src=":/about/stretch-panel.png">
<ul>
@@ -42,27 +49,30 @@ na ktorej sa dajú nastaviť tri body.
<li>biely bod - pixeli nad touto hodnotou budú zobrazené ako biele</li>
</ul>
Nasleduje tlačidlo ktoré nastaví hodnoty čierneho a stredného bodu tak aby bol obrázok zobrazený optimálnym jasom.
Druhé tlačidlo resetuje tieto tri hodnoty na východzie hodnoty. Invertovanie farieb zobrazí obrázok ako negatív.
Druhé tlačidlo resetuje hodnoty pre čierny, stredný a biely bod na východzie hodnoty. Invertovanie farieb zobrazí obrázok ako negatív.
Super pixel CFA spriemeruje dva krát dva pixeli do jedného čo je vhodné pri prezeraní surových obrázkov z farebných kamier.
Posledné tlačidlo zapína a vypína nastavovanie optimálnych hodnôt úrovní pre každý obrázok zvlášť.
</p>
Posledné tlačidlo zapína a vypína nastavovanie optimálnych hodnôt úrovní pre každý obrázok zvlášť.</p>
<h3>Označovanie obrázkov</h3>
<p>Obrázky je možné si označiť cez menu <i>Výber</i>. Zoznam takto označených obrázkov sa dá zobraziť cez
<i>Výber->Ukázať označené</i>. V tomto dialógu sa dá tiež tento zoznam upraviť. Okrem toho sa pri označených
obrázkoch zobrazuje znak * v záhlaví hlavného okna. Takto označené obrázy je potom možné skopírovať alebo
obrázkoch zobrazuje znak * v záhlaví hlavného okna. Takto označené obrázky je potom možné skopírovať alebo
presunúť do vybraného adresára pomocou <i>Súbor->Skopírovať/Presunúť označené súbory</i>. Po skopírovaní alebo
presunutú sa zoznam označených obrázkov vymaže. Program si tento zoznam pamätá aj po svojom ukončení.</p>
<h3>Databáza FITS/XISF súborov</h3>
<p>Program vie prehľadať adresár a zaindexovať meta údaje z FIST a XISF obrázkov do internej databázy v ktorej sa dá
následne vyhľadávať. Najprv je treba zindexovať adresár s FIST/XISF obrázkami <i>Súbor->Indexovať adresár</i>.
Vybraný adresár je prehľadaný a meta údaje z FIST a XISF obrázkov sú uložené do databázy. Ak kontrolu a obnovu datábazy
je možné spustiť reindexáciu <i>Súbor->Reindex</i>. Toto obnový zmenené údaje a odstráni záznamy o už neexistujúcich súboroch.
<p>Program vie prehľadať adresár a indexovať meta údaje z FIST a XISF obrázkov do internej databázy v ktorej sa dá
následne vyhľadávať. Najprv je treba indexovať adresár s FIST/XISF obrázkami <i>Súbor->Indexovať adresár</i>.
Vybraný adresár je prehľadaný a meta údaje z FIST a XISF obrázkov sú uložené do databázy. Na kontrolu a obnovu datábazy
je možné spustiť re-indexáciu <i>Súbor->Reindex</i>. Toto obnoví zmenené údaje a odstráni záznamy o už neexistujúcich súboroch.
Pre indexovanie nových súborov je treba znova pustiť indexáciu.</p>
<p>Pre zobrazenie databázy je treba zobraziť jej panel cez <i>Dokovacie okná</i>
<br><img src=":/about/filter.png">
</p>
<p>Pre zobrazenie databázy je treba zobraziť jej panel cez <i>Dokovacie panely->Databáza FITS/XISF súborov</i>. Databáza je zobrazená vo forme tabuľky
kde sú jednotlivé stĺpcoch zobrazené vybrané vlastnosti. V spodnej časti panelu je tlačidlo ktoré zobrazí dialóg na výber zobrazovaných
sĺpcov. Nasledujú tri výberové a textové polia. Tieto slúžia na vyhľadávanie v databáze. Výberové pole určuje stĺpec v ktorom sa
má vyhľadávať a do textového poľa sa zadáva hodnota na vyhľadanie.
<br><img src=":/about/filter.png"><br>
V nasledovnom príklade sa vyhľadajú súbory ktoré majú v mene súboru "Bias", OBJECT je M_42 a DATE začína reťazcom 2022. Znak % sa berie ako
zástupný znak za hocijaký reťazec znakov aj žiadny. Znak _ je tiež zástupný znak zastupujúci práve jeden znak.
Bez použitia zástupných znakov sa vyhľadá iba presný výskyt.</p>
</body>
</html>
+1 -1
View File
@@ -69,7 +69,7 @@ MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent)
filesystemDock->setObjectName("filesystemDock");
addDockWidget(Qt::LeftDockWidgetArea, filesystemDock);
QDockWidget *databaseViewDock = new QDockWidget(tr("FITS files database"), this);
QDockWidget *databaseViewDock = new QDockWidget(tr("FITS/XISF files database"), this);
databaseViewDock->setWidget(m_databaseView);
databaseViewDock->setObjectName("databaseViewDock");
databaseViewDock->hide();
Binary file not shown.
+16 -1
View File
@@ -67,6 +67,17 @@
<translation>Name</translation>
</message>
</context>
<context>
<name>ImageWidget</name>
<message>
<source>OpenGL error</source>
<translation>OpenGL error</translation>
</message>
<message>
<source>Could not initialize OpenGL 3.3 context. Ensure that proper GPU driver is installed.</source>
<translation>Could not initialize OpenGL 3.3 context. Ensure that proper GPU driver is installed.</translation>
</message>
</context>
<context>
<name>MainWindow</name>
<message>
@@ -87,7 +98,7 @@
</message>
<message>
<source>FITS files database</source>
<translation>FITS files database</translation>
<translation type="vanished">FITS files database</translation>
</message>
<message>
<source>Tenmon</source>
@@ -241,6 +252,10 @@
<source>Reindex files</source>
<translation>Reindex files</translation>
</message>
<message>
<source>FITS/XISF files database</source>
<translation>FITS/XISF files database</translation>
</message>
</context>
<context>
<name>MarkedFiles</name>
Binary file not shown.
+18 -3
View File
@@ -68,6 +68,17 @@
<translation>Meno</translation>
</message>
</context>
<context>
<name>ImageWidget</name>
<message>
<source>OpenGL error</source>
<translation>OpenGL chyba</translation>
</message>
<message>
<source>Could not initialize OpenGL 3.3 context. Ensure that proper GPU driver is installed.</source>
<translation>Nepodarilo sa incializovať OpenGL 3.3 context. Ubezpečte sa že nainštalované ovládače pre GPU.</translation>
</message>
</context>
<context>
<name>MainWindow</name>
<message>
@@ -92,7 +103,7 @@
</message>
<message>
<source>FITS files database</source>
<translation>Databáza FITS súborov</translation>
<translation type="vanished">Databáza FITS súborov</translation>
</message>
<message>
<source>Tenmon</source>
@@ -172,7 +183,7 @@
</message>
<message>
<source>Docks</source>
<translation>Dokovacie okná</translation>
<translation>Dokovacie panely</translation>
</message>
<message>
<source>Open file</source>
@@ -254,6 +265,10 @@
<source>Reindex files</source>
<translation>Reindexuj súbory</translation>
</message>
<message>
<source>FITS/XISF files database</source>
<translation>Databáza FITS/XISF súborov</translation>
</message>
</context>
<context>
<name>MarkedFiles</name>
@@ -356,7 +371,7 @@
<name>StretchToolbar</name>
<message>
<source>Stretch toolbar</source>
<translation>Panel naťahovania</translation>
<translation>Panel úrovní</translation>
</message>
<message>
<source>Auto Stretch F12</source>