Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
// SculptForge - open source digital sculpting
// SPDX-License-Identifier: GPL-3.0-or-later
//
// Face groups and visibility UI: the Tools panel section and the classic
// Ctrl+Shift viewport gestures (click to isolate / hide a group or show all,
// drag a rectangle or lasso to hide outside or, with Alt, inside it; the
// shape is tracked and drawn by Selection.cpp). Every action goes through
// the command registry (see core/Face groups.cpp).
#include "app/App.h"
#include "app/Ui.h"
#include "app/I18n.h"
#include "core/FaceGroups.h"
namespace sf {
namespace {
bool ctrlShiftDown(SDL_Keymod mod) {
return (mod & (SDL_KMOD_CTRL | SDL_KMOD_GUI)) != 0 && (mod & SDL_KMOD_SHIFT) != 0;
}
} // namespace
bool App::facegroupMouseDown(float x, float y, SDL_Keymod mod) {
if (cutPolylineMouseDown(x, y, mod)) return true; // Cut Polyline places points (PanelCut.cpp)
if (!ctrlShiftDown(mod) || previewLod_ >= 0) return false;
beginSelection(x, y, SelectTarget::Hide, hideShape_);
return true;
}
void App::facegroupMouseUp() {
const bool alt = (inputMods() & SDL_KMOD_ALT) != 0;
if (!selectMoved_) {
// Click: on a fully visible mesh show only the group under the cursor; on a partly
// hidden one hide it (the group that is all that's left: invert the visibility). Alt always hides it,
// the empty canvas shows everything.
doc_.syncBvh();
RayHit hit;
if (!pick(selectPath_.front().x, selectPath_.front().y, hit)) {
if (doc_.mesh.hasHidden()) runCommand("show_all");
return;
}
const uint32_t group = doc_.mesh.facegroupAt(hit.triangle);
if (facegroupIsolated(doc_.mesh, group)) runCommand("invert_visibility");
else if (alt || doc_.mesh.hasHidden()) runCommand("hide_facegroup", {{"group", double(group)}});
else runCommand("isolate_facegroup", {{"group", double(group)}});
return;
}
// Drag: keep the inside of the rectangle or lasso, or with Alt hide it. A shape around nothing (dragged on
// the background) reverses the visibility instead.
// The mirror image of the shape counts too with X / Y / Z symmetry on, as with MaskLasso / MaskRect (#51).
if (runSelection("hide_rect", "hide_lasso", withSymmetryArgs({{"inside", alt}})) && !lastCommandOk_ && !alt &&
doc_.mesh.hasHidden())
runCommand("invert_visibility");
}
void App::drawFaceGroupsSection() {
ImGui::Checkbox(tr("Show face groups"), &renderSettings_.showFaceGroups);
ImGui::SameLine();
const Mesh& m = doc_.mesh;
const std::array<uint64_t, 6> key = {doc_.undo.revision() + 1, uint64_t(doc_.modified), m.triangles.size(),
m.facegroups.size(), uint64_t(reinterpret_cast<uintptr_t>(m.facegroups.data())),
uint64_t(reinterpret_cast<uintptr_t>(m.hidden.data())) ^ m.hidden.size()};
if (key != visibleGroupsKey_) {
visibleGroupsKey_ = key;
visibleGroups_ = visibleFaceGroupCount(m);
}
ImGui::TextDisabled(tr("%zu"), visibleGroups_);
if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("Visible face groups"));
// Grouping buttons switch the face group colours on so the result is visible.
auto group = [this](const char* command, const Args& args = {}) {
runCommand(command, args);
renderSettings_.showFaceGroups = true;
};
const float half = (ImGui::GetContentRegionAvail().x - ImGui::GetStyle().ItemSpacing.x) * 0.5f;
if (ImGui::Button(tr("By normals"), ImVec2(half, 0)))
group("facegroup_auto_by_normals", {{"angle", double(facegroupAngle_)}});
if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("New group wherever the surface turns more than the angle"));
ImGui::SameLine();
ImGui::SetNextItemWidth(-1);
ui::SliderInside("##pgangle", &facegroupAngle_, 1.0f, 90.0f, "Angle %.0f deg");
if (ImGui::Button(tr("By pieces"), ImVec2(half, 0))) group("facegroup_by_connectivity");
if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("One group per disconnected piece"));
ImGui::SameLine();
if (ImGui::Button(tr("From mask"), ImVec2(half, 0))) group("facegroup_from_mask");
if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("Masked triangles become a new group"));
if (ImGui::Button(tr("Merge visible"), ImVec2(half, 0))) group("facegroup_merge_visible");
ImGui::SameLine();
if (ImGui::Button(tr("Clear groups"), ImVec2(half, 0))) runCommand("facegroup_clear");
ui::ActionButton(*this, "facegroup.uv_groups", ImVec2(half, 0));
}
void App::drawVisibilitySection() {
ui::Segmented(*this, {"select.rect", "select.lasso"});
const float half = (ImGui::GetContentRegionAvail().x - ImGui::GetStyle().ItemSpacing.x) * 0.5f;
ImGui::BeginDisabled(!doc_.mesh.hasHidden());
if (ImGui::Button(tr("Show all"), ImVec2(half, 0))) runCommand("show_all");
ImGui::EndDisabled();
ImGui::SameLine();
if (ImGui::Button(tr("Invert visible"), ImVec2(half, 0))) runCommand("invert_visibility");
ImGui::BeginDisabled(!doc_.mesh.hasHidden());
if (ImGui::Button(tr("Remove Hidden"), ImVec2(half, 0))) runCommand("delete_hidden");
ImGui::EndDisabled();
if (ImGui::IsItemHovered(ImGuiHoveredFlags_AllowWhenDisabled))
ImGui::SetTooltip("%s", tr("Ctrl+Shift+click a group to isolate it, +Alt to hide it, on the background to show all.\n"
"Ctrl+Shift+drag hides outside the rectangle or lasso (Alt: inside)."));
ImGui::SameLine();
ImGui::BeginDisabled(!doc_.mesh.hasMask());
if (ImGui::Button(tr("Delete masked"), ImVec2(half, 0))) runCommand("delete_masked");
ImGui::EndDisabled();
if (ImGui::IsItemHovered(ImGuiHoveredFlags_AllowWhenDisabled))
ImGui::SetTooltip("%s", tr("Delete the masked triangles (average mask above 50%); undo brings them back"));
}
} // namespace sf