VMTKSURFACEREMESHING(1)

💖 NAME 💖

vmtksurfaceremeshing — okay bestie, this is the vmtk script that takes your surface and remeshes it into quality triangles ✨ it is literally called vmtksurfaceremeshing, no cap.

✨ DESCRIPTION ✨

So the way this works: it's an automatic piping vmtk script, and yes it does its own option parsing 🎀 the vibe is vmtksurfaceremeshing, and what it actually does is:

vmtksurfaceremeshing : remesh a surface using quality triangles 🔥

That's the whole serve. You feed it a surface, you tell it how big/quality you want your triangles, and it hands you back a fresh, slay-worthy mesh. Let's do the options, because there are so many and honestly each one eats.

🎀 Input arguments 🎀

• -id Id (str,1); default=0 — the script id. It's just here to identify the script, iconic behavior honestly.
• -handle Self (self,1) — a handle to self. Self-care is a handle, keep it.
• -disabled Disabled (bool,1); default=0 — turns off execution and piping. Set it and the whole thing just… doesn't. 💀
• -i Surface (vtkPolyData,1) — the input surface. Your main character.
• -ifile SurfaceInputFileName (str,1) — filename for the default Surface reader, in case you'd rather hand it a file than an object 🍓
• -elementsizemode ElementSizeMode (str,1) in ['area', 'edgelength', 'areaarray', 'edgelengtharray']; default=area — picks how this thing decides your element size. Area, edge length, or the array versions of either. Choose your fighter 💅
• -area TargetArea (float,1) >= 0.0; default=1.0 — your target area. Bigger number = bigger triangles.
• -areaarray TargetAreaArrayName (str,1); default=TargetArea — the name of the array it reads target areas from, when you're going the array route.
• -edgelength TargetEdgeLength (float,1) >= 0.0; default=1.0 — the target edge length, for when you're sizing by edge instead of area 🦋
• -edgelengtharray TargetEdgeLengthArrayName (str,1) — same energy as -areaarray, but for edge lengths.
• -areafactor TargetAreaFactor (float,1) >= 0.0; default=1.0 — multiplies your target area. A lil glow-up factor ✨
• -edgelengthfactor TargetEdgeLengthFactor (float,1) >= 0.0; default=1.0 — the multiplier for target edge length.
• -trianglesplitfactor TriangleSplitFactor (float,1) >= 0.0; default=5.0 — controls triangle splitting. Default is a whole 5.0, we love a dramatic default.
• -maxarea MaxArea (float,1) >= 0.0; default=1e+16 — the biggest area allowed. That default is essentially "the sky is the limit," fr fr.
• -minarea MinArea (float,1) >= 0.0; default=0.0 — the smallest area allowed. Floor's at zero, bestie.
• -iterations NumberOfIterations (int,1) >= 0; default=10 — how many iterations of the remeshing. Ten queen.
• -connectivityiterations NumberOfConnectivityOptimizationIterations (int,1) >= 0; default=20 — extra rounds purely for connectivity optimization. Twenty. It's thorough and we respect it.
• -entityidsarray CellEntityIdsArrayName (str,1); default=None — the name of the cell entity ids array. Defaults to None, as in nothing, as in no array, as in she's free 🙈
• -aspectratio AspectRatioThreshold (float,1) >= 0.0; default=1.2 — the aspect ratio threshold for the quality vibe check.
• -minareafactor MinAreaFactor (float,1) >= 0.0; default=0.5 — the min area factor.
• -internalangletolerance InternalAngleTolerance (float,1) >= 0.0; default=0.0 — how much internal angle weirdness you'll tolerate. Default tolerance is literally zero, she has boundaries 💅
• -normalangletolerance NormalAngleTolerance (float,1) >= 0.0; default=0.2 — tolerance for normal angle differences.
• -collapseangle CollapseAngleThreshold (float,1) >= 0.0; default=0.2 — the threshold angle at which edges get collapsed.
• -relaxation Relaxation (float,1) >= 0.5; default=0.5 — the relaxation value. Note the minimum is 0.5, so you can't relax any harder than that. Slow down, breathe, hydrate 🧚
• -exclude ExcludeEntityIds (int,-1); default=[] — the entity ids to exclude. Default is an empty list, meaning exclude nobody, everyone's invited to the party 🎀
• -preserveboundary PreserveBoundaryEdges (bool,1); default=0 — keep those boundary edges exactly where they are. Off by default, so if you want your borders preserved you have to say so out loud.
• -ofile SurfaceOutputFileName (str,1) — filename for the default Surface writer. Where your gorgeous new mesh goes 🫶

🦋 Output arguments 🦋

• -id Id (str,1); default=0 — script id again. Yes, it appears in both sections. She contains multitudes.
• -handle Self (self,1) — handle to self, output edition.
• -o Surface (vtkPolyData,1) — 🔥 the output surface 🔥 the remeshed, quality-triangle, main-character result. This is the one you've been waiting for, periodt.

heads up bestie: piping is baked in, so these scripts pass surfaces around between each other like it's a group chat ✨

k byeee, that was vmtksurfaceremeshing from the vmtk crew 👑 — this page is version 1.5, dated April 2026, and it's filed under VMTKSURFACEREMESHING(1) in the User Commands section. go remesh something gorgeous, ily, you got this 💖🌈⭐