Skip to content
Lis Carter edited this page Sep 18, 2026 · 1 revision

Holes

Languages: English · Русский · 中文


🇬🇧 English

These parameters are responsible for processing holes. Holes are transparent areas inside the opaque body: gaps between leaves, openings in cloth, cells of a grate.

The hole settings are intentionally separated from the area settings. It is often necessary to keep the body coarse (fewer triangles on large leaves) while keeping the holes detailed (small gaps must keep their shape). Or the other way around.

Simplify Tolerance (Holes)

What it does. The same as Simplify Tolerance (Areas), but for hole contours. Controls how much the holes are simplified.

How it affects things. Same principles: larger — coarser and faster, smaller — more precise and slower.

How to tune it. If you want the holes to stay detailed regardless of the body settings — set a small value and leave it. If you want to save triangles — set a larger value. The Sync holes to areas button will copy the value from Areas into here. Large values may skip some openings and fail to cut them out, while low values will add more vertices to the final mesh but make it neater. Tune the value to suit your goals.

Min Contour Area UV (Holes)

What it does. The same as Min Contour Area UV (Areas), but for holes. Discards holes that are too small.

Why it is needed. Small holes in geometry are expensive. Each hole requires its own boolean operation, and boolean operations are capricious. If there are many tiny holes, processing slows down and the result may become unstable. It is better to simply not cut such holes out.

How to tune it. The default value is 0.1. If the boolean operation hangs or produces artifacts — increase it.

Hole Thickness

What it does. Sets the thickness given to flat hole contours before the boolean operation.

Why it is needed. A hole in plan view is a flat shape. To subtract it from the body with a boolean operation, it needs to be given volume. The addon does this by adding thickness in both directions: half forward, half backward.

How it affects things.

  • Too small a value — the boolean operation may not work correctly and leave artifacts.
  • Too large a value — the holes will end up bigger than they should be. On a thin body they may cut out more than needed.
  • Zero — the hole gets no thickness, the boolean operation won't work.

How to tune it. The default value of 0.01 suits models in the "one-to-three-meter" scale. If your model is small (for example, a 20 cm twig) — decrease to 0.001. If it is large (a 10-meter tree) — increase it.

Important. It is measured in scene units, not in UV. That is, the scale of the object directly affects how this parameter behaves. Since the parameter is relative, it has to be tuned individually for each scene.

Sync holes to areas (button)

What it does. With one click, copies the values from Simplify Tolerance (Areas) into Simplify Tolerance (Holes) and from Min Contour Area UV (Areas) into Min Contour Area UV (Holes).

When to use it. If you don't want to bother with separate settings for holes and want them to be processed the same way as the body.


🇷🇺 Русский

Эти параметры отвечают за обработку дырок. Дырки — это прозрачные области внутри непрозрачного тела: просветы между листьями, отверстия в ткани, ячейки решётки.

Настройки дырок отделены от настроек областей намеренно. Часто нужно, чтобы тело было грубым (меньше треугольников на крупных листьях), а дырки — детальными (мелкие просветы должны сохранить форму). Или наоборот.

Simplify Tolerance (Holes)

Что делает. То же самое, что Simplify Tolerance (Areas), но для контуров дырок. Управляет тем, насколько сильно упрощаются дырки.

Как влияет. Те же принципы: больше — грубее и быстрее, меньше — точнее и медленнее.

Как подобрать. Если хотите, чтобы дырки оставались детальными независимо от настроек тела — задайте маленькое значение и не трогайте. Если хотите сэкономить треугольники — задайте значение побольше. Кнопка Sync holes to areas скопирует сюда значение из Areas. Большие значения могут пропустить некоторые отверстия и не вырезать их, а низкие значения добавят больше вершин в финальный меш, но сделают его более аккуратным. Подбирайте значение под свои цели.

Min Contour Area UV (Holes)

Что делает. То же самое, что Min Contour Area UV (Areas), но для дырок. Отбрасывает слишком мелкие дырки.

Зачем это нужно. Мелкие дырки в геометрии — это дорого. Каждая дырка требует отдельной булевой операции, а булевы операции капризны. Если дырок много и они крошечные, обработка замедлится, а результат может стать нестабильным. Лучше такие дырки просто не вырезать.

Как подобрать. Значение по умолчанию — 0.1. Если булева операция зависает или даёт артефакты — увеличьте.

Hole Thickness

Что делает. Задаёт толщину, которая придаётся плоским контурам дырок перед булевой операцией.

Зачем это нужно. Дырка в плане — это плоская фигура. Чтобы вычесть её из тела булевой операцией, ей нужно придать объём. Плагин делает это, добавляя толщину в обе стороны: половину вперёд, половину назад.

Как влияет.

  • Слишком маленькое значение — булева операция может не сработать корректно, оставить артефакты.
  • Слишком большое значение — дырки получатся больше, чем должны. При тонком теле могут вырезать больше, чем надо.
  • Ноль — дырка не получит толщины, булева операция не сработает.

Как подобрать. Значение по умолчанию 0.01 подходит для моделей в масштабе «метр-два-три метра». Если ваша модель мелкая (например, веточка длиной 20 см) — уменьшите до 0.001. Если крупная (дерево на 10 метров) — увеличьте.

Важно. Измеряется в единицах сцены, а не в UV. То есть масштаб объекта напрямую влияет на то, как ведёт себя этот параметр. Так как параметр относительный, подбирать его придётся индивидуально для каждой сцены.

Sync holes to areas (кнопка)

Что делает. Одним нажатием копирует значения из Simplify Tolerance (Areas) в Simplify Tolerance (Holes) и из Min Contour Area UV (Areas) в Min Contour Area UV (Holes).

Когда использовать. Если вы не хотите возиться с отдельными настройками для дырок и хотите, чтобы они обрабатывались так же, как тело.


🇨🇳 中文

这些参数负责孔洞的处理。孔洞是实体内部的不透明区域中的透明部分:树叶之间的缝隙、布料上的开口、栅栏的格子。

孔洞的设置刻意与实体的设置分开。通常需要让实体粗糙(大叶片上三角形更少),而孔洞精细(细小的缝隙需要保持形状)。或者反过来。

Simplify Tolerance (Holes)

作用。 与 Simplify Tolerance (Areas) 相同,但作用于孔洞轮廓。控制孔洞被简化到什么程度。

影响。 相同的原则:值越大——越粗糙、越快,值越小——越精确、越慢。

如何调整。 如果你希望孔洞不管实体的设置如何都保持精细——设置一个较小的值然后不要动它。如果你想节省三角形——设置一个较大的值。Sync holes to areas 按钮会把 Areas 的值复制到这里。较大的值可能会漏掉一些开口而不去切割它们,而较小的值会给最终网格添加更多顶点,但会让它更整齐。根据自己的目标来调整这个值。

Min Contour Area UV (Holes)

作用。 与 Min Contour Area UV (Areas) 相同,但作用于孔洞。丢弃过小的孔洞。

为什么需要。 几何体中的小孔洞代价很高。每个孔洞都需要单独的布尔运算,而布尔运算是很挑剔的。如果孔洞很多又很小,处理会变慢,结果也可能变得不稳定。这样的孔洞干脆不切更好。

如何调整。 默认值是 0.1。如果布尔运算卡住或产生伪影——增大它。

Hole Thickness

作用。 设置在布尔运算之前赋予平面孔洞轮廓的厚度。

为什么需要。 孔洞在平面上是一个扁平的形状。要用布尔运算把它从实体中减去,就必须给它体积。插件通过向两个方向添加厚度来实现这一点:一半向前,一半向后。

影响。

  • 值太小——布尔运算可能无法正确工作,留下伪影。
  • 值太大——孔洞会比应有的更大。在薄的实体上可能会切掉超过需要的部分。
  • 零——孔洞不会获得厚度,布尔运算不会工作。

如何调整。 默认值 0.01 适用于「一到三米」尺度的模型。如果你的模型很小(例如一根 20 厘米的树枝)——减小到 0.001。如果很大(一棵 10 米的树)——增大它。

重要。 它以场景单位为单位,而不是 UV。也就是说,物体的尺度会直接影响这个参数的表现。由于这个参数是相对的,需要针对每个场景单独调整。

Sync holes to areas(按钮)

作用。 一键把 Simplify Tolerance (Areas) 的值复制到 Simplify Tolerance (Holes),把 Min Contour Area UV (Areas) 的值复制到 Min Contour Area UV (Holes)。

何时使用。 如果你不想为孔洞单独折腾设置,希望它们和实体一样处理。

Clone this wiki locally