mia-meshdi...o-stackmask(1)

📦
version 2.4.7 · 3 versions
, in debian bookworm, ubuntu jammy

💅 mia-meshdistance-to-stackmask — the manual, but make it cute ✨

okay bestie, so this is the manual page for mia-meshdistance-to-stackmask(1), a lil General Commands Manual situation, and honestly? it's giving "measure the vibes between a blob and a triangle soup." let's get into it 🫶

🌸 NAME 🌸

mia-meshdistance-to-stackmask — Evaluate the distance between a binary shape given as reference and a mesh.

like. it takes your shape. it takes your mesh. it tells you how far apart they are. iconic behavior fr fr 💖

✨ SYNOPSIS ✨

mia-meshdistance-to-stackmask -i <in-mesh> -r <ref-mask> -o <out-mesh>
[options]

🦋 DESCRIPTION 🦋

mia-meshdistance-to-stackmask... wait no, mia-meshdistance-to-stackmask — okay so this program takes a binary mask and a triangular mesh as input, and then it evaluates the distance of the mesh vertices to the binary mask, and then it stores the result in a new mesh. that's it. that's the whole vibe. no cap. 💫

🎀 OPTIONS 🎀

  • -i, --in-mesh=(input, required); io — your input mesh, babes. required, so don't skip it. for supported file types see PLUGINS:mesh/io ⭐
  • -r, --ref-mask=(input, required); io — the reference binary mask. also required, also not optional, also the moment. for supported file types see PLUGINS:2dimage/io 🌸
  • -o, --out-mesh=(required, output); io — the output mesh, where the ✨result✨ goes. required. for supported file types see PLUGINS:mesh/io 💖

🙋 Help & Info 🙋

  • -V, --verbose=warning — verbosity of output, print messages of given level and higher priorities. the default is warning, if you were wondering. 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
bestie the ordering matters, lowkey. lowest → highest. fatal is the "I only want to hear about total catastrophe" setting 💀
  • --copyright — print copyright information 👑
  • -h, --help — print this help 🫶
  • -?, --usage — print a short help ✨
  • --version — print the version number and exit 🌈

🧚 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). 🔥
so -1 is the default, and -1 also means "figure it out yourself, queen." if you go over your logical core count you're just doing cardio for no reason ngl.

🌈 PLUGINS: 2dimage/io 🌈

  • bmp — BMP 2D-image input/output support. The plug-in supports reading and writing of binary images and 8-bit gray scale images. read-only support is provided for 4-bit gray scale images. The color table is ignored and the pixel values are taken as literal gray scale values. 💅
    • Recognized file extensions: .BMP, .bmp
    • Supported element types:
      • binary data, unsigned 8 bit
  • datapool — Virtual IO to and from the internal data pool 🌀
    • Recognized file extensions: .@
  • dicom — 2D image io for DICOM 🩺
    • Recognized file extensions: .DCM, .dcm
    • Supported element types:
      • signed 16 bit, unsigned 16 bit
  • exr — a 2dimage io plugin for OpenEXR images ✨
    • Recognized file extensions: .EXR, .exr
    • Supported element types:
      • unsigned 32 bit, floating point 32 bit
  • jpg — a 2dimage io plugin for jpeg gray scale images 📸
    • Recognized file extensions: .JPEG, .JPG, .jpeg, .jpg
    • Supported element types:
      • unsigned 8 bit
  • png — a 2dimage io plugin for png images 🌸
    • Recognized file extensions: .PNG, .png
    • Supported element types:
      • binary data, unsigned 8 bit, unsigned 16 bit
  • raw — RAW 2D-image output support 🧱
    • Recognized file extensions: .RAW, .raw
    • Supported element types:
      • binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit
  • tif — TIFF 2D-image input/output support 🖼️
    • Recognized file extensions: .TIF, .TIFF, .tif, .tiff
    • Supported element types:
      • binary data, unsigned 8 bit, unsigned 16 bit, unsigned 32 bit
  • vista — a 2dimage io plugin for vista images 💜
    • Recognized file extensions: .-, .V, .VISTA, .v, .vista
    • Supported element types:
      • binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

🧊 PLUGINS: mesh/io 🧊

  • datapool — Virtual IO to and from the internal data pool 🌀
    • Recognized file extensions: .@
  • off — plugin to load/store some Geomview OFF files. Supported is only the ASCII format 3D meshes with normales and per-vertex RGB colors. Alpha values and texture coordinates, as well as per face properties are ignored. Polygons are read and triangulated. 🔺
    • Recognized file extensions: .OFF, .off
yes it says "normales" and no we are not fixing it, we are respecting the heritage 💅
  • ply — Ply triangle mesh input/output support 🧵
    • Recognized file extensions: .PLY, .ply
  • stl — STL mesh io plugin 🏗️
    • Recognized file extensions: .STL, .stl
  • vista — Vista/Simbio triangle mesh input/output support 👑
    • Recognized file extensions: .-, .V, .VMESH, .v, .vmesh
  • vtk — A subset of VTK mesh in-and output: Triangle meshes are written, and triangle meshes and triangle strips are read. Additional per-vertex attributes are supported: 'normals', 'colors' for three component colors, and 'scale' for a scalar value attached to each vertex. The data is written by the vtkPolyDataWriter in binary format. 🌟
    • Recognized file extensions: .VTK, .VTKMESH, .vtk, .vtkmesh

🔥 EXAMPLE 🔥

Evaluate the distance of the mask given in the images maskXXXX.png to the mesh given in mesh.v and save the result to mesh-dist.v

mia-meshdistance-to-stackmask -i mesh.v -r maskXXXX.png -o mesh-dist.v

look at her go. main character energy, honestly. 🌈

💖 AUTHOR(s) 💖

Gert Wollny

This software is Copyright (c) 1999‐2015 Leipzig, Germany and Madrid, Spain. It comes with ABSOLUTELY NO WARRANTY and you may redistribute it under the terms of the GNU GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the option '--copyright'.

ok bestie, real talk for one sec: ABSOLUTELY NO WARRANTY is not a joke and not a vibe, it's literally in there. and the GPLv3-or-later thing means you can pass it around, but read the license, fr fr. 🙈

and that's the whole page, bestie!! this was USER COMMANDS, version v2.4.7, manual page for mia-meshdistance-to-stackmask(1) 🦋 — thanks for reading the whole thing, you ate that. go measure some distances. periodt. 💅✨🎀

📦 where this page comes from