From 3a5338c29b28f8fb96033912536f67d5e49d0be1 Mon Sep 17 00:00:00 2001
From: "luca.mazzoleni" <luca.mazzoleni@egalware.com>
Date: Wed, 18 Feb 2026 18:40:07 +0100
Subject: [PATCH] - migliorati commenti in LapJoint

---
 LuaLibs/ProcessLapJoint.lua | 28 +++++++++++++++++++---------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/LuaLibs/ProcessLapJoint.lua b/LuaLibs/ProcessLapJoint.lua
index 8ec7293..1ef0bbf 100644
--- a/LuaLibs/ProcessLapJoint.lua
+++ b/LuaLibs/ProcessLapJoint.lua
@@ -6651,7 +6651,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
    end
    -- eventuale forzatura sega a catena
    local bForceChainsaw = ( EgtGetInfo( Proc.Id, Q_FORCE_CHAINSAW, 'i') or 0) > 0
-   -- se è un tunnel provo a vedere se è possibile lavorarlo con la svuotatura o con la sega catena
+
+   -- TUNNEL: svuotatura o sega a catena
    if bClosedOrthoFaces then
       local bTryWithBlades = true
       local dDimMin, dDimMax, dDepth, vtOrtho, nLundIdFace
@@ -6741,7 +6742,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
             end
          end
       end
-   -- altrimenti non è una fessura
+
+   -- NO TUNNEL: tutti gli altri casi
    else
       -- dati della faccia
       local ptC, vtN = EgtSurfTmFacetCenter( Proc.Id, nFacInd, GDB_ID.ROOT)
@@ -6777,6 +6779,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
       if bPrevBhSideMill == nil then
          bPrevBhSideMill = bMakeBySideMill
       end
+
+      -- SIDEMILL (tipo BLOCKHAUS)
       if bMakeBySideMill then
          -- se smusso non è esclusivo
          if nChamfer < 2 then
@@ -6911,7 +6915,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
                end
             end
          end
-      -- altrimenti lavoro con svuotatura
+
+      -- TASCA GENERICA: si cerca il modo migliore di lavorare in base alla forma
       else
          local bSpecial3faces = false
          -- verifico se lavorando la faccia principale rimane esclusa molta sezione trasversale complessiva della feature (da box)
@@ -6941,7 +6946,7 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
             end
          end
          
-         -- se posso in effetti fare fresatura con aggregato flottante
+         -- FRESATURA SPECIALE CON AGGREGATO FLOTTANTE 
          if bPocketFloatingAggregate then
             -- inserisco la lavorazione di svuotatura
             local sName = 'Float_Mill_' .. ( EgtGetName( Proc.Id) or tostring( Proc.Id))
@@ -6964,7 +6969,7 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
             -- imposto uso faccia
             local nFaceUse = BL.GetNearestParalOpposite( vtN)
             EgtSetMachiningParam( MCH_MP.FACEUSE, nFaceUse)
-            -- piccolo offser radiale per essere sicuri di lavorare anche con tasca larga come diametro fresa
+            -- piccolo offset radiale per essere sicuri di lavorare anche con tasca larga come diametro fresa
             EgtSetMachiningParam( MCH_MP.OFFSR, -0.01)
 
             -- imposto posizione braccio porta testa
@@ -6989,7 +6994,7 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
                return false, sErr
             end
 
-         -- se riconosciuta gestione 3 facce (limitatamente per ora alla feature 20)
+         -- CASO SPECIALE 3 FACCE (se rimane esclusa molta sezione trasversale complessiva della feature, solo per feature 20)
          elseif bSpecial3faces and Proc.Prc == 20 then
             -- se smusso non è esclusivo
             if nChamfer < 2 then
@@ -7115,7 +7120,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
                   if not bOk then return false, sWarn end
                end
             end
-         -- altrimenti lavorazione di svuotatura o contornatura
+
+         -- SVUOTATURA O FRESATURA: si valuta se si può fare svuotatura o se provare altro
          else
             local bUseOtherFace
             local bLapJointAngTrasm = false
@@ -7273,7 +7279,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
                   EgtErase( nSurfPartId)
                end
             end
-            -- ricerca lavorazione
+            
+            -- ricerca lavorazione di svuotatura
             local sPocketing
             local _, sMyPocketing, dMyTMaxDepth, dMyTDiam = VerifyPocket( Proc, dDiam, dFacElev + dCollSic, dMaxTotLen, sMchFind, bMillUp, bMillDown)
             if not sMyPocketing and bMillUp then
@@ -7320,7 +7327,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
             local nQAntisplintResult = EgtGetInfo( Proc.Id, Q_ANTISPLINT_TYPE, 'i') or 0
             -- se lavorazione fresa come lama disabilito eventuale antischeggia
             if bSpecialMillOnSide then nQAntisplintResult = 0 end
-            -- se non trovata una svuotatura adatta
+
+            -- NO SVUOTATURA (si deve provare altro)
             if not sPocketing then
                -- se forma a L provo con contornatura
                if bIsL and not bSpecialMillOnSide and not bForceSideMill then
@@ -7666,6 +7674,8 @@ local function MakeMoreFaces( Proc, nPhase, nRawId, nPartId, dOvmHead, bSinglePa
                      end
                   end
                end
+
+            -- SVUOTATURA OK
             else
                -- se devo inserire il chamfer
                if ( ( Proc.Fct == 3 and bIsU) or (Proc.Fct == 2 and bIsL)) and nChamfer > 0 then