Nodes/Avatar Graph/Mesh Mark Freestyle Edge
ComfyUI Node

Mesh Mark Freestyle Edge

A line-art flag most Avatar Graph users will never need

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Mesh Mark Freestyle Edge
  • BPY_OBJ
  • BPY_OBJ
clearfalse

Worth saying plainly: this isn't part of Avatar Graph's own documented rigging workflow. It's one of the many raw Blender mesh operators the pack auto-generates node wrappers for (see generate_blender_types.py in the README's Development section), and Freestyle specifically belongs to Blender's own NPR line-rendering system - not the real-time avatar runtime this pack actually ships. If you only want the standard "drag an image in, get a blinking, lipsyncing avatar" workflow, you'll never touch this node.

How it works

It wraps Blender's mesh.mark_freestyle_edge operator. Freestyle is Blender's stylized line-rendering feature - when enabled in a Blender render, it can draw visible outline strokes based on angle, silhouette, or, relevantly here, edges you've explicitly flagged by hand. This node sets that per-edge flag on the current selection, independent of any automatic angle-based line detection. It has no effect at all unless the mesh is later rendered through Blender's Freestyle system specifically - it does nothing to Avatech's own avatar viewer or a GLB/GLTF export.

The inputs and outputs that matter

  • BPY_OBJ (optional) - the mesh, with the edges to flag already selected.
  • clear (default false) - removes the Freestyle flag from the selected edges instead of adding it.

Output is a single BPY_OBJ, unchanged geometrically - only the per-edge flag differs.

How to install it

ComfyUI Manager: search "Avatar Graph" and install. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui

then pip install -r requirements.txt and restart. Needs Blender's bpy module, pinned to Python 3.10.x - a dedicated conda environment on macOS/Linux, or Avatech's prebuilt Python-3.10 ComfyUI zip on Windows with the pack installed through Manager afterward.

Common issues & troubleshooting

Nothing visibly changes after running this node. That's expected almost all the time - this only sets a flag Blender's Freestyle render engine reads, and Avatar Graph's own real-time avatar preview and its GLB/GLTF export path don't use Freestyle at all. Unless you're specifically rendering this mesh through Blender's Freestyle line-art system elsewhere, this node has no visible effect and that's correct behavior, not a broken node.

You landed on this node expecting outline/toon-style rendering in your avatar output. That's not what this does within Avatar Graph's pipeline - the pack's own rendering is its real-time Shape Flow viewer, which doesn't read Freestyle marks. If you're after stylized outlines on your character, that's a separate concern from anything in this node's control.

A bpy import failure at ComfyUI startup is the pack's Python-version pin, not this operator - confirm a clean Python 3.10.x environment with requirements.txt installed without errors.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
clearoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ