mia-3disosurface-from-stack(1)

Usage

mia-3disosurface-from-stack -i <in-image> -o <out-mesh> [options]

Overview

mia-3disosurface-from-stack This program is used to extract an iso-surface from the input gray scale image given as slices.

Options

File-IO

-i --in-image=(required, input); string: input image filename pattern

-o --out-mesh=(required, output); string: output mesh

Help & Info

-V --verbose=warning: verbosity of output, print messages of given level and higher priorities. Supported priorities starting at lowest level are:

trace ‐ Function call trace

debug ‐ Debug output

info ‐ Low level messages

message ‐ Normal messages

warning ‐ Warnings

fail ‐ Report test failures

error ‐ Report errors

fatal ‐ Report only fatal errors

--copyright: print copyright information

-h --help: print this help

-? --usage: print a short help

--version: print the version number and exit

Image options

-s --iso-value=128: iso-value of iso surface to be extracted

Mesh options

-f --max-faces=-1: maximum number of Faces,

-e --max-edges=-1: maximum number of Edges

-c --max-cost=0.1: maximum cost for edge collaps

-r --ratio=4: ratio of faces(edges) to target number, at which the optimization changes from edge-length to volume-optimized

-w --reverse-winding: reverse the winding of the triangles in order to make normals point away from the high intensity area

Processing

--threads=-1: Maxiumum number of threads to use for processing,This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation).

Examples

Extract the surface from an image set with numbers imageXXXX.png that corresponds to the value 30 and stop optimizing when the mesh consists of less than 100000 triangles.

mia-3disosurface-from-stack -i image0000.png -o mesh.vmesh -s 30 -f 100000

AUTHOR(s)

Gert Wollny

History

Debian 12 (Bookworm): the text shown here
Debian 11 (Bullseye)
Debian 10 (Buster)
Debian 9 (Stretch)
Debian 8 (Jessie)