SaisieMasqQT : Différence entre versions

De MicMac
Aller à : navigation, rechercher
(Mask definition)
 
(19 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
 +
[[Image:picto-liste.png|25px]] [[Command|List of commands]]
 
==Description==
 
==Description==
SaisieMasqQT is the same tool as SaisieMasq, available on all platforms (Linux, Windows, MacOS). SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command mm3d SaisieMasqQT + arguments
+
 
mm3d SaisieMasqQT -l to load last edited file. A visual interface for argument edition is also available with command: mm3d vSaisieMasqQT  
+
SaisieMasqQT is the same tool as [[SaisieMasq]], available on all platforms (Linux, Windows, MacOS). SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command mm3d SaisieMasqQT + arguments mm3d SaisieMasqQT -l to load last edited file. A visual interface for argument edition is also available with command: <pre>mm3d vSaisieMasqQT </pre>
 +
 
 +
SaisieMasqQT has the same arguments as [[SaisieMasq]]. Some light differences with [[SaisieMasq]] processing workflow should be noticed: you need to draw a polygon first, and then apply an action (add to mask, remove from mask, etc.). You can get a complete list of possibles actions typing F1.
 +
 
 +
"Mask" defines the area to be treated, which appears green in the view window (counterintuitively, the area outside the mask is the one actually hidden for treatment).
 +
 
 +
[[Image:SaisieMasqQT_Fontaine.png|thumb|180px|The green area ("mask") is here used for correlation]]
 +
 
 +
Main actions are :
 +
* F2: display image in full screen
 +
* Wheel roll: zoom
 +
* Wheel click: move image
 +
* Shift+wheel click: zoom fast
 +
* Left click: add a point to polygon
 +
* Right click: close polygon
 +
* Space: Add to mask
 +
* Suppr: Remove from mask
 +
* Right click (close to a point): delete point
 +
* Echap: delete polygon
 +
* Shift + click & drag: insert point
 +
* Ctrl+S: save mask image and Xml file
 +
* Ctrl+Q: quit
 +
 
 +
Some parameters can be edited in the Settings menu: image gamma, application language, display settings, etc. These parameters are stored, and are used at next application launch, so set them once to fit your own purpose. As SaisieMasqQT can edit both images and 3d point clouds, application has different behavior, depending on which data you deal with. As a result, Settings menu, and help window dialog (F1), will change depending on the loaded data. Be careful about this!
 +
 
 +
Some special features have been added to SaisieMasqQT, which may differ from original SaisieMasq :
 +
* modify current selection, with Shift+Click to insert a point, or Click+drag to move a point
 +
* modify previous actions, with menu Windows/Show polygons list
 +
* measure image distances, with Rule tool
 +
 
 +
To modify previous actions, you can undo/redo last actions with Ctrl+Z/Shift+Ctrl+Z, and you can edit list of previous actions, with menu Windows/Show polygons list: click on the actions in the list in the right window, then edit polygon (by adding or moving points), or double-click on the action name (column Mode) to change action. Apply changes clicking Return, or go in the Menu Mask edition and select Confirm changes.
 +
 
 +
Note: if you want to change application language, go in the Settings menu, apply changes and restart
 +
application.
  
 
===Syntax===
 
===Syntax===
The global syntax for SaisieMasqQT is <br>
+
SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command :
SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command <code>mm3d SaisieMasqQT + arguments</code>
+
 
 +
<pre>mm3d SaisieMasqQT + arguments</pre>
  
 
===Help===  
 
===Help===  
You can access to the help by typing :<br>
+
You can access to the help by typing :
<br>
+
<pre>mm3d SaisieMasqQT -help</pre>
<code>mm3d SaisieMasqQT -help</code> <br>
+
  
SaisieMasqQT [filename] [option=] <br>
 
  
*<span style="font-family:times roman;"> ''[filename] string : open file (image or ply or camera xml)''</span style>
+
SaisieMasqQT [filename] [option=]
  
Options <br>
+
*[filename] string : open file (image or ply or camera xml)
 +
 
 +
Options
 +
 
 +
*[Name=SzW] Pt2di : set window size (default=[900,700])
 +
*[Name=Post] string : change postfix output file (default=_Masq)
 +
*[Name=Name] string : set output filename (default=input+_Masq)
 +
*[Name=Gama] REAL : apply gamma to image
 +
*[Name=Attr] string : string to add to postfix
  
*<span style="font-family:times roman;"> ''[Name=SzW] Pt2di : set window size (default=[900,700])''</span style>
 
*<span style="font-family:times roman;"> ''[Name=Post] string : change postfix output file (default=_Masq)''</span style>
 
*<span style="font-family:times roman;"> ''[Name=Name] string : set output filename (default=input+_Masq)''</span style>
 
*<span style="font-family:times roman;"> ''[Name=Gama] REAL : apply gamma to image''</span style>
 
*<span style="font-family:times roman;"> ''[Name=Attr] string : string to add to postfix''</span style>
 
<br>
 
 
NB:  
 
NB:  
 
SaisieMasqQT can be run without any argument
 
SaisieMasqQT can be run without any argument
Visual interface for argument edition available with command: mm3d vSaisieMasqQT
+
Visual interface for argument edition available with command: <pre>mm3d vSaisieMasqQT</pre>
 +
 
 +
===Example===
 +
For example, with the Mur Saint-Martin dataset you can launch :
 +
<pre>mm3d SaisieMasqQT IMGP4173.JPG Attr=MonPlan</pre>
 +
 
 +
* '''How to use SaisieMasqQT explained in this tutorial :'''
 +
{{#ev:youtube|https://www.youtube.com/watch?v=dMxhD7UBEGE}}

Version actuelle en date du 22 septembre 2019 à 13:11

Picto-liste.png List of commands

Description

SaisieMasqQT is the same tool as SaisieMasq, available on all platforms (Linux, Windows, MacOS). SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command mm3d SaisieMasqQT + arguments mm3d SaisieMasqQT -l to load last edited file. A visual interface for argument edition is also available with command:
mm3d vSaisieMasqQT 

SaisieMasqQT has the same arguments as SaisieMasq. Some light differences with SaisieMasq processing workflow should be noticed: you need to draw a polygon first, and then apply an action (add to mask, remove from mask, etc.). You can get a complete list of possibles actions typing F1.

"Mask" defines the area to be treated, which appears green in the view window (counterintuitively, the area outside the mask is the one actually hidden for treatment).

The green area ("mask") is here used for correlation

Main actions are :

  • F2: display image in full screen
  • Wheel roll: zoom
  • Wheel click: move image
  • Shift+wheel click: zoom fast
  • Left click: add a point to polygon
  • Right click: close polygon
  • Space: Add to mask
  • Suppr: Remove from mask
  • Right click (close to a point): delete point
  • Echap: delete polygon
  • Shift + click & drag: insert point
  • Ctrl+S: save mask image and Xml file
  • Ctrl+Q: quit

Some parameters can be edited in the Settings menu: image gamma, application language, display settings, etc. These parameters are stored, and are used at next application launch, so set them once to fit your own purpose. As SaisieMasqQT can edit both images and 3d point clouds, application has different behavior, depending on which data you deal with. As a result, Settings menu, and help window dialog (F1), will change depending on the loaded data. Be careful about this!

Some special features have been added to SaisieMasqQT, which may differ from original SaisieMasq :

  • modify current selection, with Shift+Click to insert a point, or Click+drag to move a point
  • modify previous actions, with menu Windows/Show polygons list
  • measure image distances, with Rule tool

To modify previous actions, you can undo/redo last actions with Ctrl+Z/Shift+Ctrl+Z, and you can edit list of previous actions, with menu Windows/Show polygons list: click on the actions in the list in the right window, then edit polygon (by adding or moving points), or double-click on the action name (column Mode) to change action. Apply changes clicking Return, or go in the Menu Mask edition and select Confirm changes.

Note: if you want to change application language, go in the Settings menu, apply changes and restart application.

Syntax

SaisieMasqQT can be run several ways. You can run command mm3d SaisieMasqQT and drag-and-drop files in the application window, or open files from File menu, or you can run command :

mm3d SaisieMasqQT + arguments

Help

You can access to the help by typing :

mm3d SaisieMasqQT -help


SaisieMasqQT [filename] [option=]

  • [filename] string : open file (image or ply or camera xml)

Options

  • [Name=SzW] Pt2di : set window size (default=[900,700])
  • [Name=Post] string : change postfix output file (default=_Masq)
  • [Name=Name] string : set output filename (default=input+_Masq)
  • [Name=Gama] REAL : apply gamma to image
  • [Name=Attr] string : string to add to postfix

NB: SaisieMasqQT can be run without any argument

Visual interface for argument edition available with command:
mm3d vSaisieMasqQT

Example

For example, with the Mur Saint-Martin dataset you can launch :

mm3d SaisieMasqQT IMGP4173.JPG Attr=MonPlan
  • How to use SaisieMasqQT explained in this tutorial :