xlanro00/BP_DP-xlanro00
1
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Updated README and user manual.

Browse Source
This commit is contained in:
Rostislav Lán
2023-04-28 20:04:27 +02:00
parent fe20f7a39a
commit a1b81722c4
3 changed files with 51 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -274,16 +274,24 @@ Optional parameters are height of the papilar lines and base thickness.
# Mapping to existing finger model # Mapping to existing finger model
This section will be added later, (if implemented) mapping of fingerprint to a given finger model. Using `m` mode modifies the preexisting finger model to contain fingerprint.
First optional parameter is papilar line height `height_line`, second is the number of iterations `iter` to make the finger mesh denser. Higher number of itertions results in denser finger mesh and better result.
The last three parameters are axis offsets for the finger, `finger_x`, `finger_y`, `finger_z`.
These control the location of the finger. They need to be set only if the user wants to move core of the print closer to the center of the finger.
* General command form for mapped stl generation * General command form for mapped stl generation
```sh ```sh
python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line height_base finger_file python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line iter finger_x finger_y finger_z
```
* Working example of finger mapping
```sh
python3 src/main.py res/examples/Palec_P4.tif res/examples/Palec_P4.png 600 --config conf/conf.json ridge --stl m 0.2 2 0 0 0
``` ```
# Usage # Usage
usage: main.py [-h] [-m | --mirror | --no-mirror] input_file output_file dpi ([-c | --config config_file preset] | [filters ...]) [-s | --stl_file p height_line height_base | --stl_file c height_line height_base curv_rate_x curv_rate_y | --stl_file m height_line height_base finger_file] usage: main.py [-h] [-m | --mirror | --no-mirror] input_file output_file dpi ([-c | --config config_file preset] | [filters ...]) [-s | --stl_file p height_line height_base | --stl_file c height_line height_base curv_rate_x curv_rate_y | --stl m height_line iter finger_x finger_y finger_z] [-d | --database database_filename]
Program for processing a 2D image into 3D fingerprint. Program for processing a 2D image into 3D fingerprint.

11
doc/manual/manual.html
View File

@ -219,10 +219,12 @@ Woking example
<pre><code>python3 src/main.py res/examples/Palec_P4.tif res/examples/Palec_P4_from_preset.png 600 --config config/config.json git_example --stl p 2 10</code></pre></li> <pre><code>python3 src/main.py res/examples/Palec_P4.tif res/examples/Palec_P4_from_preset.png 600 --config config/config.json git_example --stl p 2 10</code></pre></li>
</ul> </ul>
<h2 id="mapping-to-existing-finger-model">Mapping to existing finger model</h2> <h2 id="mapping-to-existing-finger-model">Mapping to existing finger model</h2>
<p>This section will be added later, (if implemented) mapping of fingerprint to a given finger model.</p> <p>Using <code>m</code> mode modifies the preexisting finger model to contain fingerprint. First optional parameter is papilar line height <code>height_line</code>, second is the number of iterations <code>iter</code> to make the finger mesh denser. Higher number of itertions results in denser finger mesh and better result. The last three parameters are axis offsets for the finger, <code>finger_x</code>, <code>finger_y</code>, <code>finger_z</code>. These control the location of the finger. They need to be set only if the user wants to move core of the print closer to the center of the finger.</p>
<ul> <ul>
<li><p>General command form for mapped stl generation:</p> <li><p>General command form for mapped stl generation</p>
<pre><code>python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line height_base finger_file</code></pre></li> <pre><code>python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line iter finger_x finger_y finger_z</code></pre></li>
<li><p>Working example of finger mapping</p>
<pre><code>python3 src/main.py res/examples/Palec_P4.tif res/examples/Palec_P4.png 600 --config conf/conf.json ridge --stl m 0.2 2 0 0 0</code></pre></li>
</ul> </ul>
<h1 id="usage">Usage</h1> <h1 id="usage">Usage</h1>
<p>When in doubt, you can always check the help with:</p> <p>When in doubt, you can always check the help with:</p>
@ -232,7 +234,8 @@ Woking example
output_file dpi ([-c | --config config_file preset] | output_file dpi ([-c | --config config_file preset] |
[filters ...]) [-s | --stl_file p height_line height_base | [filters ...]) [-s | --stl_file p height_line height_base |
--stl_file c height_line height_base curv_rate_x curv_rate_y | --stl_file c height_line height_base curv_rate_x curv_rate_y |
--stl_file m height_line height_base finger_file] --stl m height_line iter finger_x finger_y finger_z]
[-d | --database database_filename]
Program for processing a 2D image into 3D fingerprint. Program for processing a 2D image into 3D fingerprint.

26
doc/manual/manual.md
View File

@ -311,12 +311,21 @@ Optional parameters are height of the papilar lines and base thickness.
## Mapping to existing finger model ## Mapping to existing finger model
This section will be added later, (if implemented) mapping of fingerprint to a given finger model. Using `m` mode modifies the preexisting finger model to contain fingerprint.
First optional parameter is papilar line height `height_line`, second is the number of iterations `iter` to make the finger mesh denser. Higher number of itertions results in denser finger mesh and better result.
The last three parameters are axis offsets for the finger, `finger_x`, `finger_y`, `finger_z`.
These control the location of the finger. They need to be set only if the user wants to move core of the print closer to the center of the finger.
* General command form for mapped stl generation: * General command form for mapped stl generation
``` ```
python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line height_base finger_file python3 src/main.py input_file output_file dpi --config config_file preset --stl m height_line iter finger_x finger_y finger_z
```
* Working example of finger mapping
```
python3 src/main.py res/examples/Palec_P4.tif res/examples/Palec_P4.png 600 --config conf/conf.json ridge --stl m 0.2 2 0 0 0
``` ```
# Usage # Usage
@ -332,7 +341,8 @@ usage: main.py [-h] [-m | --mirror | --no-mirror] input_file
output_file dpi ([-c | --config config_file preset] | output_file dpi ([-c | --config config_file preset] |
[filters ...]) [-s | --stl_file p height_line height_base | [filters ...]) [-s | --stl_file p height_line height_base |
--stl_file c height_line height_base curv_rate_x curv_rate_y | --stl_file c height_line height_base curv_rate_x curv_rate_y |
--stl_file m height_line height_base finger_file] --stl m height_line iter finger_x finger_y finger_z]
[-d | --database database_filename]
Program for processing a 2D image into 3D fingerprint. Program for processing a 2D image into 3D fingerprint.
@ -437,5 +447,13 @@ options:
In curved generation any negative argument is an error, casts are only for planar mode. In curved generation any negative argument is an error, casts are only for planar mode.
</td> </td>
</tr> </tr>
<tr>
<td>
ERROR: Fingerprint image is outside of the finger model
</td>
<td>
Outside of range of the finger, fingerprint cannot be mapped to nothing. Try to change finger_x, finger_y and finger_z parameters.
</td>
</tr>
</tbody> </tbody>
</table> </table>