mia-meshfilter(1)

📦
version 2.4.7 · 3 versions
, in ubuntu jammy, ubuntu noble

mia-meshfilter(1) 💖

okay bestie, so this is a General Commands Manual page for mia-meshfilter, and it is exactly the little tool you want when you've got a 3D mesh and you need to ✨do stuff✨ to it. Buckle up 🎀

✨ NAME ✨

mia-meshfilter — Run filters on a 3D mesh. 💅

🌸 SYNOPSIS 🌸

mia-meshfilter -i <in-file> -o <out-file> [options]
<PLUGINS:mesh/filter>

🦋 DESCRIPTION 🦋

so basically mia-meshfilter runs a whole series of filters on a given input mesh. the filters are handed to it as extra parameters on the command line, and — this is the important part — they get run in the order in which they are given. no cap, order matters.

to get a list of the available filters you can just run

'mia-plugin-help mesh/filter' from the command line

from the command line. slay. 💜

👑 OPTIONS 👑

  • -i, --in-file=(required, input); io — the input mesh that's about to get filtered. for supported file types see PLUGINS:mesh/io 🌸
  • -o, --out-file=(required, output); io — the output mesh that has been filtered. for supported file types see PLUGINS:mesh/io 🌈

💖 Help & Info 💖

  • -V, --verbose=warning — verbosity of output: it prints messages of the given level and higher priorities. the supported priorities, starting at the 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

🧚 Processing 🧚

  • --threads=-1 — maximum 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). bestie, don't be greedy with threads 💀

🔥 PLUGINS: mesh/filter 🔥

⭐ addscale ⭐

this filter sorts sets the scale parameter for each vertex from a 3D image. the image and the mesh are expected to be in the same physical coordinate space. supported parameters are:

  • img =(required, string) — 3DImage that contains the scale values as a volume image.

⭐ deltribynormal ⭐

this filter deletes all triangles that have a normal that differs by the given angle from the provided direction. supported parameters are:

  • angle = 5; float — tolerance angle (in degree) that the normal can deviate from the provided direction.
  • dir =(required, 3dfvector) — direction the triangle normals are expected to point to. the orientation of the vector is taken into account. 👀

⭐ scale ⭐

this plug-in provides a filter to scale triangulat meshes by a given strategy. supported parameters are:

  • anisoscale = [[1,1,1]]; 3dfvector — ansiotropic scaling parameter.
  • box-end = [[256,256,256]]; 3dfvector — box end for fitbox scaling.
  • box-start = [[0,0,0]]; 3dfvector — box start for fitbox scaling.
  • isoscale = 1; float — isotropic scaling parameter.
  • shift = [[0,0,0]]; 3dfvector — shift mesh after scaling.
  • strategy = iso-linear; dict — isotropic scaling parameter. supported values are:
    • iso-linear ‐ Scale and shirt the mesh by scaling it isotropically as given by parameter 'isoscale' and apply a shift as given by parameter 'shift'
    • aniso-linear ‐ Scale and shirt the mesh by scaling it anisotropically as given by parameter 'anisoscale' and apply a shift as given by parameter 'shift'
    • iso-fitbox ‐ Fit the mesh into the given box by shifting it and apply isotropic scaling. The box is given by the parameters 'box-start' for upper, left, frontal corner, and 'box-end' for the lower, right back corner
    • aniso-fitbox ‐ Fit the mesh into the given box by shifting it and apply anisotropic scaling. The box is given by the parameters 'box-start' for upper, left, frontal corner, and 'box-end' for the lower, right back corner

⭐ selectbig ⭐

this filter selects the component with the highest number of triangles from a mesh that is actually composed of disconnected components. components are considered to be disconnected if they don't share a common edge (they might share a common vertex though)

  • (no parameters)

⭐ vtxsort ⭐

this filter sorts the vertices of a mesh according to the given direction. specifically, the dot product between the given direction and the vertices will be ordered ascending. supported parameters are:

  • dir = [[0,0,1]]; 3dfvector — sorting direction.

🌈 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

🍓 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 💜

Run an isotropic scaling on input.vmesh to fit it into the box defined by the corners <0,0,0> - <128,128,128> and save the result to output.vmesh

mia-meshfilter -i input.vmesh -o output.vmesh
       scale:strategy=iso-fitbox,box-start=[<0,0,0>],box-end=[<128,128,128>]

🫶 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'.

bestie this is the legal bit so like, read it fr fr, it's giving important 📜

okay that's the whole thing 💖 this page is from the USER COMMANDS corner of the manual and it's v2.4.7, so go forth and filter those meshes, main character ✨🎀🦋

📦 where this page comes from