OpenCAD NC 뷰어 · 해석기

NC 프로그램(G-code·Heidenhain 평문·woodWOP MPR·WangShi PGI·KDT XML)을 브라우저 안에서 읽어 3D 공구 경로로 보여 주는 뷰어 앱과, 그 해석기 라이브러리입니다. 해석기는 DOM·WebGL에 기대지 않아 웹 워커에서 돌고, 결과 장면(Scene3d)은 opencad-viewer3d로 그립니다. 다른 NC 해석 라이브러리를 쓰지 않고 새로 작성했습니다. G-code·Heidenhain 평문·woodWOP MPR은 공개 자료를 보고 작성했습니다. WangShi PGI·KDT XML은 공개 형식 설명서가 없어, 비공개 리더의 형식 설명과 실제 출력 파일을 보고 맞췄습니다. 그 리더의 코드는 옮기지 않았습니다.

• 뷰어(배포 예정): https://gyutae-kim.github.io/opencad-nc/
• 함께 쓰는 저장소: opencad-viewer3d(3D 뷰어 코어) · opencad-step · opencad-skp · OpenCAD 도구 모음

할 수 있는 것

• G-code(ISO·Fanuc·Haas·Siemens·LinuxCNC·GRBL·Mach3 방언 자동 판별): 직선·호·나선, 평면·단위·좌표계, 고정 사이클, 부프로그램, 변수와 IF/WHILE
  • 판별은 괄호 주석을 떼고 봅니다. 낱말에 붙은 주석(N1(…)·T1M6(…)·G0X0(…))과 겹친 주석 "(… (SPOT))"도 주석이고, Siemens 함수 인수(CYCLE81(…)·=AC(…)·SIN(…))와 식 괄호(= 뒤)는 남깁니다. Siemens 표지가 하나뿐이면 Fanuc·LinuxCNC의 뚜렷한 표지 (O 번호 줄·# 변수·M98/G65 P·o-코드 부프로그램)가 없을 때만 Siemens로 읽습니다(표지가 둘 넘거나 %N 머리면 Siemens)
  • Siemens Sinumerik(840D sl·828D 꼴, src/siemens.ts — %N…_MPF 머리·MCALL·CYCLE·T="…"·CR=·AC/IC·GOTOF·DEF·SUPA 등으로 판별): ; 주석, 주소 = 식(X=R1*2), 축별 AC(…)/IC(…), CR=·I=AC(…)·AR=·CIP(I1/J1/K1)·TURN=, 극좌표 G110G112 + AP·RP, 공구 T="이름"·D·M6, R 매개변수·DEF 변수·PROC 매개변수와 식(SIN…ATAN2·POT·TRUNC·ROUND·MIN·MAX·DIV·MOD·비교·AND/OR/NOT), IF … GOTOF/GOTOB/GOTO/GOTOC·IF/ELSE/ENDIF·WHILE·FOR·REPEAT/UNTIL·LOOP·REPEAT 표지 P=, 부프로그램 L123 P3·이름·이름(인수)· CALL "이름"·MCALL 이름(같은 글의 %_N_이름_SPF·PROC나 함께 연 파일), RET·M17, 드릴 사이클 CYCLE8189·840(MCALL 모달, CYCLE83 FDEP·DAM·VARI)·HOLES1·HOLES2, 프레임 TRANS·ATRANS·ROT·AROT·SCALE·ASCALE·MIRROR·AMIRROR·G58·G59(절대 지령은 프레임을 바꿈), G54G57·G505G599, SUPA·G53·G153·G74·G75(기계 좌표 쪽 이동 규칙), G70/G71/G700/G710, G4 F(초)·S(회전), CT(앞 요소에 접하는 원호 — 모달, G0~G3·CIP가 끔), 모서리 다듬기 RND=(둥글리기 반지름)·RNDM=(모달, 0이면 끔 — 직선·원호 블록 모두)· CHF=(모따기 선 길이)·CHR=(모서리에서 자르는 길이) — Siemens 설명서대로 작업 평면 안의 직선·원호 어느 조합이든. 둥글리기는 두 요소에 접하는 호(두 요소를 반지름만큼 옮긴 선·원의 교점 가운데 모서리에 가까운 것이 중심), 원호 위 모따기 점은 모서리에서 현 길이로 잰 거리이고 CHF는 모따기 선 길이가 값과 같아지게 두 거리를 맞춥니다. 원호의 중심은 그대로 두고 끝·시작만 접점으로 옮깁니다. 나선처럼 작업 평면 밖으로 움직이는 모서리, 요소보다 큰 값은 그대로 두고 경고합니다. CYCLE800·POCKET·SLOT·선반 사이클·시스템 변수($…)·배열은 그리지 않고 경고
  • Haas(주석의 HAAS, G187·G103·G154·G110~G129·G150·M130으로 판별 — 선반 프로그램의 G112·G113(극좌표 보간)은 표지가 아니고, M97 P 지역 부프로그램은 어느 방언이든 읽으므로 표지로 보지 않음. 판별하면 띠로 알림): G73/G83의 I·J·K = 첫 절입·줄이는 양·최소 절입, 반복은 L(K는 반복이 아님). Fanuc 계열도 쪼기 사이클에 I·J가 있거나 K가 정수가 아니면 Haas 꼴로 읽고 경고, 다른 사이클의 정수 아닌 K 반복은 한 번으로 보고 경고(K.05를 반복 0번으로 읽어 구멍이 사라지지 않게). 볼트 구멍 패턴 G70(원: I 반지름·J 시작 각·L 개수)·G71(호: + K 각 간격)·G72(직선: I 간격·J 각) — 지금 자리 기준, 지금 고정 사이클을 자리마다 5축 G143(5축 공구 길이 보정)·G234(공구 중심점 제어)는 G43·G43.4처럼 공구 길이 보정을 켜고 같은 블록의 좌표를 이동으로 그림
  • Okuma OSP(CALL O…·VC 변수·G15 H·NLAP·RTS로 판별): G15 Hn은 작업 좌표계 n으로 읽고, CALL·VC 변수·NLAP는 읽지 않아 띠·경고로 알림
  • LinuxCNC 스플라인(G17 평면): G5 3차(I·J = 시작점에서 첫 조정점까지, P·Q = 끝점에서 둘째 조정점까지 — 이어지는 G5가 I·J를 빼면 앞 G5의 -P·-Q로 접선을 이음), G5.1 2차(I·J). 모달 이동 꼴이고, 곡선과의 차이가 0.005 mm 안팎이 되게 이송 직선 조각으로 나눔. 규칙에 어긋난 블록(P·Q 없음, 첫 G5에 I·J 없음, G17 밖, Z)은 끝점까지 직선으로 그리고 경고. 좌표 없는 Fanuc G05(고속 가공 모드)는 무시
  • LinuxCNC NURBS G5.2 … G5.3(LinuxCNC 설명서 "G5.2 G5.3 NURBS Block"): G5.2부터 G5.3 앞까지의 블록이 조정점(X·Y)과 가중치(P, 기본 1)이고 L은 계수(order = 차수 + 1, 기본 3 = 2차 곡선)입니다. 첫 조정점은 G5.2 앞의 지금 자리이고 그 가중치는 여는 G5.2 블록의 P입니다. G5.3에서 조정점 수만큼의 열린 균일 매듭(앞뒤 L개는 0·끝값, 사이는 1씩 — LinuxCNC와 같음)으로 유리 B-스플라인 곡선을 만들어, 곡선과의 차이가 0.005 mm(0.0002 inch) 안이 되게 이송 직선 조각으로 나눠 그립니다(길이·예상 시간·고르기·재생·소재 깎기가 이 조각을 씀). 조각마다 가장 가까운 조정점 블록의 줄에 잇습니다. 이송은 G5.3에서 그릴 때의 F이고, 높이(Z)는 그대로입니다(조정점의 Z는 경고). G91이면 조정점을 모두 곡선 시작점에서 잽니다 — LinuxCNC는 G5.3까지 지금 자리를 바꾸지 않기 때문입니다.
  • 스플라인(G5·G5.1·G5.2/G5.3)은 그린 조각과 함께 곡선 정의(차수·매듭·조정점·가중치)와 조각 끝 매개변수를 해석 결과에 남겨, 측정이 조각이 아닌 곡선 위에서 가운데 점·접선·수직 발·축과 만나는 점을 구합니다(이동·그림은 그대로) G17 밖, X·Y 가운데 하나만 있는 조정점, P가 0 이하, L이 2 이상의 정수가 아니거나 조정점 수보다 큼, G5.3 없이 다른 이동 꼴이 오거나 프로그램이 끝남은 경고하고 조정점을 차례로 직선으로 잇습니다. 컨트롤러가 곡선을 나누는 방법(판마다 다를 수 있음)은 흉내 내지 않습니다
  • 좌표 변환: G68/G69 회전(Mach3 G68 A·B 중심), G51/G50 배율(Fanuc 중심 + P·I·J·K, Mach3 축별 배율), G51.1/G50.1 거울, LinuxCNC G10 L2 R 좌표계 회전 — 원호·고정 사이클 구멍도 함께 옮김. G68.2(P0 Z-X-Z 오일러·P1 X-Y-Z)·Haas G268(Q313·Q123) 기울인 작업 평면: 블록의 X·Y·Z = 원점, I·J·K = 각(이동 아님), 이후 좌표를 기운 평면에서 읽고(원호는 직선 조각) 고정 사이클은 기운 공구 축 방향으로 들어감, G53.1은 그대로, G69(Haas G269)로 끔
  • 기계 좌표 쪽 이동(G53, G28·G30 기준점, Heidenhain M91·M92): 작업 원점의 기계 위치를 모르면 값을 작업 좌표로 읽지 않고 공구 축(선반은 X·Z)을 "안전 높이"(그 축의 경로 최댓값 + 25mm·1inch)로 그리며 X·Y 기계 이동은 제자리에 둔다(경고). 이런 이동, 그 높이에 머무는 이동, 그 높이에서 출발한 급속은 묶음 "기계 원점 쪽 이동(추정)"(주황 점선)으로 따로 그리고 범위·최저 Z 계산에서 뺀다. 그 높이에서 출발한 이송·호·드릴(예: G28 Z0 뒤의 G43 H1 G1 Z-5. 진입)은 보통 이송으로 그리고 안전 확인도 하되 범위에는 끝점만 넣는다 (FLAG_START_EST, 블록 상태에 "출발 높이 추정"). 그 높이에서 출발한 급속은 점선 묶음이지만 끝점은 실제라 범위와 급속 깊이 확인에 넣는다 (G28 뒤 G43 H2 Z-10.처럼 가장 깊은 절삭보다 아래로 급속하면 경고). 고정 사이클이 추정 높이에서 시작하면 처음 높이(G98)로 돌아가는 급속도 같은 추정 높이로 그린다. 라이브러리 옵션 machineOffset(첫 작업 좌표계 원점의 기계 좌표)·referencePoint(또는 machine.offsetMm·referenceMm, 앱 "기계·읽기 설정")를 주면 실제 위치로 그린다
  • 기계·읽기 설정(옵션 machine, mm 기준 — inch 프로그램은 바꿔 씀): 급속 속도 rapidFeedMm, 공구 교환 한 번의 시간 toolChangeSec(예상 시간에 더함), 도그레그 급속 dogleg(여러 축 급속을 축마다 같은 속도로 함께 가다 짧은 축부터 멈추는 꺾인 길로 그리고 가장 긴 축 이동으로 시간 계산), 축별 허용 범위 limitsMm(작업 좌표 기준, 벗어나는 이동을 줄과 함께 경고). G-code blockDelete·checkToolNumbers와 함께 앱 설정에서 고른다
  • 모르는(또는 매개변수만 받는) G 코드가 있는 블록의 좌표(예: G22·G150·G47)는 이동으로 그리지 않고 경고(가짜 급속을 만들지 않음). 같은 블록의 G0G3 이동 꼴·G80 취소·고정 사이클 고르기는 다음 블록에 그대로 남음. G9·G62·G63은 이동 그대로, G60·G27·G29는 끝점까지 급속 한 번, 밀링 G33은 이송 직선, LinuxCNC G33.1 탭은 들어갔다 나옴, Haas G154 P1P99·G110G129는 추가 작업 좌표계(G54.1 P와 같은 번호 — Haas 방언에서만. Fanuc 계열의 G110G129는 사용자 매크로일 수 있어 모르는 G)
  • G16/G15 극좌표(Fanuc): 평면 첫 축 = 반지름, 둘째 축 = 각(도). 반지름을 G90으로 주면 극 원점 = 작업 원점, G91이면 지금 자리, 각은 G91이면 앞 각에 더함 — 이동·고정 사이클 모두(G91 각 + K 반복이면 반복마다 더 돌아 볼트 원)
  • 고정 사이클 위치 결정은 컨트롤러처럼 지금 높이에서 구멍 자리로 옮긴 뒤 R 점으로(R보다 낮은 자리에서 시작하면 그 높이로 옮겨 가는 것을 그대로 보임). 보링: G76 정밀 보링은 바닥에서 시프트 후 급속 복귀, 밀링 G87(Haas는 G77) 뒤 보링은 처음 높이에서 시프트 → 구멍 아래(R)로 → 되돌려 위로 이송 → 시프트 → 늘 처음 높이로. 시프트는 Haas I·J(방향·양) 또는 Fanuc Q(평면 첫 축 + 방향, 소수점 없으면 최소 입력 단위 — 경고). Haas G87·G88은 수동 복귀라 급속 복귀로 그림(경고)
  • Haas·Mach3 원형 포켓 G12(시계)·G13(반시계): I 첫 반지름, K 마무리 반지름, Q 증분, Z 깊이(G91 + L이면 반복마다 더 깊게), 공구 반지름은 D 번호(G10 L12/L13·공구 표) → 지금 공구의 공구 표·주석 지름(inch 프로그램의 "1/2 ENDMILL" 같은 분수 포함)
  • 반경 보정 G41/G42/G40: 프로그램 경로는 그대로 두고, 선택하면 공구 중심 경로를 따로 계산(직선·호 모서리 교점 자르기, 바깥 모서리 호 잇기, 들어가기·나오기, 간섭 경고). 반지름은 D 번호 → 공구 표(선택)·G10 L12/L13(Fanuc)·G10 L1 R(LinuxCNC·Mach3)· G41.1 D 지름·공구 주석 지름(T1 D=10.) 차례로 찾음. 뷰어 앱은 보정 조각(직선·호 — 호 중심·중심각)을 남겨, 측정이 공구 중심 경로의 호 위에서 가운데 점·중심·접선·곡선 위 점을 구합니다. LinuxCNC 방언은 설명서(G-code 절 "G40"·"G41, G42"와 "Cutter Compensation"의 Programming Entry Moves)대로, 보정을 켠 뒤 평면 급속이 이어지면 마지막 급속만 보정 자리로 가므로 앞 급속은 보정 없이 그리고 마지막 급속을 들어가기로 봅니다. 들어가기 이동이 공구 반지름보다 짧거나, G40 뒤 첫 이동이 원호이거나 공구 지름보다 짧은 직선이면(LinuxCNC는 오류로 멈춤) 보정 경로를 그릴 때 경고합니다 (길이는 보정 평면 안 — 밀링·선반 모두. 다른 방언은 보정을 켠 뒤 첫 평면 이동을 들어가기로 봅니다)
  • 선반 공구 끝 R 보정(선반 모드의 G41/G42 — LinuxCNC 설명서 "Cutter Compensation"·Lathe User Information의 "Tool Positions" 그림· G-code 절의 G10 L1·G41.1/G42.1): 공구 끝의 노즈 반지름을 둥근 공구로 보고 밀링과 같은 규칙(들어가기·모서리·나오기)으로 노즈 중심 경로를 구한 뒤, 공구 방향(1~8)이 있으면 경로 전체를 가상 공구 끝(조정점 — X·Z축과 나란하게 노즈 원에 접하는 두 선의 교점)으로 옮겨 그립니다. 들어가기의 시작점과 나오기의 끝점은 보정 없는 프로그램 점입니다. 방향은 그 그림대로 0°가 Z+, 시계 방향 90°가 X+이고 7(0°)·2(45°)·6(90°)·1(135°)·5(180°)·4(225°)·8(270°)·3(315°), 9는 노즈 중심입니다 — 예를 들어 X20 직선을 척 쪽으로 깎는 바깥지름 공구(G42, 방향 4)의 공구 끝 경로는 X20 위에 놓이고, 테이퍼·원호에서만 프로그램 경로에서 벗어납니다. 노즈 반지름과 방향은 G41.1/G42.1 D(지름)·L, 옵션 공구 표(toolTable의 radius·orientation), LinuxCNC G10 L1 P R Q 차례로 찾고, 파일에 없으면 앱의 선반 공구 표(옵션 machine.latheToolsMm — 공구 번호마다 mm)에서 찾습니다. Fanuc 선반처럼 D가 없으면 지금 공구 번호(T0101의 01)로 찾습니다. 방향을 모르거나 0이면(설명서가 정하지 않음) 노즈 중심 경로로 그리고 경고하고, LinuxCNC가 아닌 방언에서 방향을 쓰면 번호를 LinuxCNC 그림대로 읽었다고 경고합니다. 밀링 보정 값은 바뀌지 않습니다
  • 선반 모드(선택): G18, X 지름(LinuxCNC·GRBL은 G7/G8), U·W 증분, T0101, G96/G97 주속 일정(G50 S·G96 D 최고 회전수로 시간 계산), G90/G92/G94 단순 사이클, G70~G73 복합 사이클(거친 깎기·다듬질·형상 반복), G74/G75 쪼아 깎기, G76 나사(여러 번), G32/G33 — XZ 단면 경로(X = 반지름, 회전축 = Z). 뷰어 앱은 고르지 않으면 글로 판별해(lathe: 'auto') 선반처럼 보이면 선반 모드로 읽고 3D 보기 위 띠로 알림("밀링으로 읽기" 단추). 라이브러리 기본(옵션 없음)은 밀링으로 읽고 안내 경고
  • LinuxCNC 선반 G70·G71·G72(LinuxCNC 설명서 G-code 절 "G70 Lathe finishing cycle"·"G71 G72 Lathe roughing cycles"): 윤곽은 o-코드 서브루틴 Q입니다. 서브루틴의 G0은 G1로 보고, G1·G2·G3과 U·W 증분을 읽으며, 이동에 붙은 A는 그 끝 모서리의 둥글리기 반지름, C는 같은 크기 둥글리기와 두 끝이 같은 모따기입니다. 첫 이동의 끝이 윤곽의 시작이고, G71은 Z, G72는 X가 한 방향으로만 바뀌어야 합니다. 블록에 X·Z가 있으면 먼저 그 자리로 급속(시작점)으로 갑니다. G71(바깥·안지름)과 G72(끝면)는 시작점에서 I(기본 1)씩 층으로 깎아 윤곽에서 시작점 쪽으로 D(기본 0)만큼 떨어진 곡선까지 가고, 층 끝에서 R(기본 0.5)만큼 45°로 물러납니다. 끝나면 떨어진 윤곽을 따라가 그 끝에 섭니다. 오목한 곳(포켓)도 깎습니다. G7x.1은 포켓을 빼고 윤곽이 처음 다시 깊어지는 꼭짓점에서 멈추고, G7x.2는 포켓만 깎은 뒤 그 꼭짓점부터 끝까지 따라갑니다. G70은 P(기본 1)번 따라가는데, 차례마다 윤곽에서 (차례 - 1)(D - E)/P + E만큼 떨어진 곡선을 따르고(마지막 차례가 E) 차례 사이에 시작점으로 급속합니다. 떨어진 곡선은 직선을 평행으로 옮기고 원호는 반지름을 바꾸며, 볼록한 모서리는 호로 잇고 오목한 모서리는 교점까지 자릅니다. 설명서의 오류 조건(윤곽이 오고 감, 서브루틴 없음, 반경 보정 중, G18이 아닌 평면)과 설명서에 없는 낱말은 경고합니다. 설명서가 정하지 않은 것(층 사이 물러나는 꼴, 포켓에 들어가는 차례, G7x.1이 멈추는 자리, G7 지름 모드의 D·I·R·E)도 그렇게 그렸다고 경고합니다
  • Fanuc 선반 G 코드 체계 A·B·C(Fanuc 선반 설명서의 G 코드 표, 옵션 latheSystem, 정보 탭 "선반 G 코드"): 기본은 A(위와 같음)이고, B는 G77·G78·G79가 바깥지름·나사·끝면 단순 사이클, G90/G91이 절대·증분, G92가 좌표 설정·최고 회전수, G94/G95가 분당·회전당 이송, G98/G99가 고정 사이클 복귀 높이입니다. C는 B에 더해 G20·G21·G24가 단순 사이클, G70/G71이 inch/mm, G72G78이 복합 사이클(A의 G70G76)입니다. U·W는 B·C에서도 증분으로 읽습니다. 고르지 않으면 단순 사이클이 쓰인 꼴로 판별합니다 — G79나 P·Q 없는 G77·G78이 좌표와 함께 있으면 B, G20·G21·G24가 좌표와 함께(같은 블록에 G0~G3·G32·G33 없이) 있으면 C이고 띠로 알립니다("체계 바꾸기" 단추). A 체계 사이클 꼴(G90·G92·G94 + 좌표 + F)과 섞였거나 G91·낱말 없는 G70·G71처럼 표지만 있으면 A로 읽고 경고와 띠로 알립니다
  • 소수점 없는 값 = 최소 입력 단위(옵션 integerUnits, 정보 탭 "해석 설정"): Fanuc 매개변수 DPI = 0 꼴로 X·Y·Z·U·V·W·I·J·K·R·Q는 mm 0.001·inch 0.0001, A·B·C는 0.001도. 반복 횟수(고정 사이클·M98의 K, L)는 그대로이고, 식·변수가 있는 줄도 소수점 없는 수만 바꾸며 변수·식 값은 그대로 씁니다. 선반 G71~G73 윤곽 블록에도 씁니다. 끈 채 소수점 없는 100 이상 좌표가 절반을 넘으면 경고와 띠("최소 단위로 읽기")
  • 회전축 A·B·C(선택): 각을 X·Y·Z축 둘레로 감아 공작물 기준 공구 끝 경로(각이 바뀌는 이동은 2도씩 나눔, 시간은 직선·각 합성 길이). G43.4/G43.5 공구 끝점 제어 동안은 프로그램 좌표를 그대로 공구 끝 경로로 그림
• Heidenhain 평문(.h): L·C·CR·CT·LP·CP, FK 자유 윤곽(FPOL·FL·FLT·FC·FCT — 한 블록 자료로 정해지는 것), RL/RR 반경 보정(TOOL DEF R + DR), RND R(모서리 둥글리기)·CHF(모따기 — 값은 모서리에서 앞뒤 요소를 따라 자르는 길이, F는 그 부분 이송): 앞 요소 끝을 접점까지 줄이고 호·직선을 넣음(증분 좌표의 기준은 프로그램 모서리 그대로, 좌표 변환 배율은 반지름에도). RND는 작업 평면 안의 직선·원호 어느 조합이든 두 요소에 접하는 호(원호 중심은 그대로)이고, CHF는 Heidenhain 설명서대로 두 직선 사이 모서리에만 써서 원호와 만나면 그대로 둠(경고), 드릴 사이클 200~209·240, 밀링 사이클 208(보어 나선)·251(사각 포켓)·252(원 포켓)·253(홈)·256/257(보스)·232(정면), 점 패턴 220/221, LBL·CALL LBL(구간 반복·부프로그램, 따옴표 표지), Q 변수·FN, 좌표 변환 사이클 7(원점 이동)·8(대칭)·10(회전)·11(배율)·26(축별 배율)과 TRANS DATUM AXIS/RESET(원점 이동 둘레로 원점 → 대칭 → 회전 → 배율 차례, 원호·드릴·밀링 사이클도 함께 옮김 — 대칭은 원호 방향을 뒤집음). PLANE·19 기울인 평면은 경고만
• Heidenhain DIN/ISO(.i, "%이름 G71 *" 머리로 판별 — 띠로 알림): 블록을 평문 블록으로 옮겨 같은 길로 읽음 — G00/G01, G02/G03(I·J·K = 절대 원 중심, R = 반지름), G05·G06(접선), G10G13·G15 극좌표(R·H), G29(마지막 자리를 극으로), G40G42, G90/G91, G30/G31 공작물, G99 T L R 공구 정의, T G17 S 공구 호출, G2xx + Q 줄 사이클과 G79·M99, G83/G84 옛 사이클, G24 R(모따기)·G25 R(둥글리기 — 평문 CHF·RND와 같음), G54(원점 이동)·G28(대칭)·G73(회전)·G72(배율), G98 L n 표지·L n,m 부르기, D00~D13 Q 함수, G04 F 휴지, G38, 끝 %이름
• woodWOP MPR: 공작물, 수직·수평 드릴, 아랫면 드릴(131 UfluBohr — 아래쪽 드릴 장치, 위에서 본 XA·YA에서 아랫면 위로 TI), 윤곽 가공(KR 둥글리기·KF 모따기 포함 — 원호가 낀 모서리도 G-code 원호 모서리와 같은 방법으로 다듬음), 홈, 포켓(모서리 반지름 RD 포함), 자유 형상 포켓, 엣지 밴딩, 꺼진 가공, 변수(뒤에 정의된 변수도 풂), 값 "STANDARD"(F_·S_·TNO 등 기계·공구 기본값)는 식으로 계산하지 않고 기본값으로 읽음, 지원하지 않는 매크로는 위치(XA·YA)만 점으로
  • 엣지 밴딩(188 Easyedge)은 공개 명세가 없어 실제 파일 717개(가공 1,965개)를 보고 뜻을 정했습니다. EA·EE는 윤곽 가공처럼 윤곽 구간(윤곽:요소)을 가리키고, 실제 파일에서는 모두 판 외곽 윤곽의 한 변이었습니다. DK는 띠 두께로 봅니다. 같은 가공의 설명(KM·KAT)에 적힌 띠 두께와 늘 같고, 파일 머리 주석에 변마다 적힌 밴딩 두께와 1,965개 모두 맞았습니다 (두께가 0인 변에는 Easyedge가 없음). 그래서 이 구간의 판 옆면에 두께 DK의 띠를 붙인다고 보고, 묶음 "엣지 밴딩"(청록 선)으로 그립니다. 판 재료에서 먼 쪽으로 DK만큼 띄운 윗변·아랫변과 양 끝 세로선입니다. 띠 쪽은 닫힌 윤곽이 판 가장자리에 닿으면 바깥, 판 안에 떠 있으면(따낸 구멍) 안쪽, 열린 윤곽이면 판 가운데에서 먼 쪽입니다. 공구 경로가 아니라서 윤곽 가공 수·시간·이송 길이에는 넣지 않고, 가공 목록에 "엣지 밴딩 · 두께 1"처럼 보입니다. MDA·MDE(TAN·TAN_AB — 붙이기 시작·끝의 접근 꼴로 보임)·RI·NM은 모든 파일에서 값이 하나뿐이라 뜻을 가릴 수 없어 쓰지 않습니다.
  • 자유 형상 포켓(181 FreiFormTasche)도 공개 명세가 없어 실제 파일 87개(가공 198개)로 정했습니다. EA(윤곽:요소)가 가리키는 윤곽은 모두 닫혀 있었고 (Ø35 원 171개, 직사각형 17개, 직선과 호가 섞인 긴 구멍 10개), 그 안을 깊이 |TI|만큼 판 기둥(묶음 "포켓")으로 그립니다. 원이면 목록에 지름도 보입니다. 실제 파일의 TI는 모두 음수(-2~-18)였고, 이 포켓은 늘 아랫면 드릴(UfluBohr)과 같은 면 묶음에 있었습니다(파일 주석의 면 표시가 같고, Ø35 컵 옆의 Ø3 나사 구멍이 UfluBohr). 이름에 "from below"가 붙은 것도 있습니다. 그래서 TI가 음수면 아랫면(Z 0)에서 위로, 0보다 크면 다른 포켓처럼 윗면에서 아래로 봅니다. 판 두께보다 깊으면 두께까지만 그립니다. AD·AZ·ZU·ZT·XY·HP·SP·ASG·WW·MX 같은 나머지 값은 공구 경로를 정하는 값으로 보이지만, 공구 경로는 그리지 않으므로 쓰지 않습니다.
  • 사각 포켓(112 Tasche)의 RD는 실제 파일 805개로 뜻을 확인했습니다. Tasche 68개 가운데 67개(파일 48개)가 RD를 썼고 값은 4(57개)와 15(10개)였습니다. RD는 늘 짧은 변의 반 이하였고, 반과 같은 10개는 정확히 반(30 × 36 포켓의 R15 — 짧은 변이 반원)이어서 모서리 반지름으로 봅니다. 공구는 모두 기계 기본값(T_="0")이라 공구 지름과는 견줄 수 없었습니다. 그래서 PGI·XML 둥근 사각 포켓처럼 모서리를 1/4 원으로 둥글린 기둥으로 그리고(짧은 변의 반보다 크면 반으로), 측정은 그 모서리 호에서 가운데 점·중심·접선을 줍니다. RD가 없거나 0이면 예전처럼 각진 상자입니다.
• WangShi PGI(.pgi, 뿌리 <pgi>)·KDT XML(.xml, 뿌리 <KDTPanelFormat>): 판재 가공 센터(KDT 등) 프로그램. MPR과 같은 판재 가공 모델로 읽습니다.
  • 판 크기·변수(<params>·<Params>, 값에 W-37·300+(40)/2 같은 식), 직사각형이 아닌 판의 외곽선(bulge 호 포함)
  • 여섯 면 구멍(PGI direction z-·z+·x+·x-·y+·y-, XML TypeNo 1·8·2 + Quadrant), 구멍 줄(no·xi·yi·zi), 노치 벽 위의 옆면 구멍, 공구가 원을 다 채우는 35 mm 도어 컵(T35)
  • 톱 홈(PGI line isSaw, XML 3·13 UseSaw)과 직선 경로, 사각 포켓(가운데·최소 모서리, 둥근 모서리·회전, 옆면 포함), 원형 포켓·원 경로, 라우팅 경로(PGI bulge — ±1은 들어오는 접선을 잇는 호, XML <Arc Radius Direction>, 상대 좌표), 닫힌 empty 경로는 포켓으로
  • 옆면 높이(PGI z·centerZ, XML Z1)는 아랫면에서 잽니다. 윗면·아랫면 위치는 둘 다 위에서 본 (x, y)입니다.
  • 꺼진 가공(enable·Enable 0), 모르는 요소는 위치만 점으로(XML FlatAnglePull·Engraving은 한국어 이름), 깨진 값은 '해석 실패'로 목록에. 문서 순서와 다른 order, 그리지 않는 진입 값(entryL·entryZ·toolExtraOffset), 면에서 벗어난 옆면 구멍은 경고로 알립니다.
  • 형식은 내용(뿌리 요소)으로 정합니다. .xml이라도 <KDTPanelFormat>이 아니면 G-code로 읽지 않고 알리며, woodWOP MPRX(XML)는 MPR로 저장해 열라고 안내합니다.
  • XML은 웹 워커에서 돌도록 직접 읽습니다(src/xml.ts — 요소마다 원본 줄, DOCTYPE·개체 선언은 풀지 않음, 끊긴 문서는 닫힌 요소까지).
• 여러 파일을 한 작업으로(combineNcJob·combineNcFiles·splitNcJob, src/job.ts): 주 프로그램 뒤에 나머지 파일을 표지 줄(G-code (OPENCAD-JOB-FILE 이름), Siemens·Heidenhain ; OPENCAD-JOB-FILE 이름)로 나눠 잇고, 해석기는 표지 줄에서 주 프로그램을 끝내며 부르기를 이은 글 전체에서 찾는다 — Fanuc·Haas M98 P·G65 P(O 줄, 없으면 파일 이름 O1001.nc·1001.nc), LinuxCNC o<이름> call, Siemens L123·이름·이름(인수)·CALL(파일 이름, 파일 머리 %N…_SPF·PROC), Heidenhain CALL PGM·SEL PGM + CALL SELECTED PGM·DIN/ISO %이름(BEGIN PGM·%이름 머리, LBL은 프로그램마다 따로). M99·M17·RET·END PGM 없이 파일 끝에 닿은 부프로그램은 부른 곳으로 돌아간다. 주 프로그램은 고르지 않으면 다른 파일이 부르지 않는 파일 가운데 부르기가 가장 많고 M30·M2로 끝나는 쪽(Siemens는 .MPF). 형식이 다른 파일은 잇지 않음. 찾지 못한 프로그램은 경고와 함께 notices의 missing-program(이름 목록)으로 알리고, O9000번대 G65는 기계에 든 매크로로 보아 건너뜀
• 공구 목록(색·지름), 이송·급속 길이, 예상 시간, 줄 번호 ↔ 이동 연결. 공구 이름은 공구 교환 블록이나 바로 앞(두 줄 안) 주석에서 읽되, 프로그램 머리 주석(O 번호 줄의 주석, 시작 전 첫 주석이라 프로그램 이름이 된 것 — 지름·공구 종류 낱말이 없으면)은 쓰지 않음
• 매크로 식의 FIX·FUP: Fanuc·ISO·Haas는 Fanuc 매크로 B처럼 소수 버림·올림(음수도 절댓값 기준 — FIX[-1.2] = -1, FUP[-1.2] = -2), LinuxCNC는 floor·ceil(FIX[-1.2] = -2, FUP[-1.2] = -1)
• LinuxCNC 이름 변수: 지역 이름 변수(#<이름>)는 주 프로그램과 o-코드 부프로그램마다 따로입니다. 그 범위에 없는 지역 이름 변수를 읽으면 LinuxCNC는 오류로 멈추므로 경고하고 빈 값으로 읽습니다(낱말을 빼고, 식에서는 0). EXISTS[#<이름>]는 경고 없이 0이고, 전역 이름 변수(#<_이름>)는 LinuxCNC가 미리 정한 것(#<_x> 등)이 많아 보지 않습니다
• 안전 확인 경고(줄 번호와 함께): 공구 길이 보정 H·반경 보정 D 번호가 공구 번호와 다름(옵션 checkToolNumbers: false로 끔), 공구 교환 뒤 G43 없이 절삭(프로그램이 G43을 쓸 때 — 밀링 Fanuc 계열), 주축이 멈춘 채(M5·S0) 절삭(주축을 쓰는 프로그램에서, GRBL 빼고), 급속이 가장 깊은 절삭보다 아래로, 공작물(Heidenhain BLK FORM) 윗면보다 낮은 급속 수평 이동
• 100만 줄(30MB) G-code를 약 0.5~0.6초에 읽습니다(선택 기능을 켜지 않으면 예전과 같은 경로).
• 소재 깎기 시뮬레이션(G-code·Heidenhain·판재 MPR·PGI·XML, 3축 높이 지도): 소재 윗면 위 고른 격자의 마디마다 남은 소재 높이를 두고, 공구가 직선·원호·나선·드릴 이동으로 지나간 자리를 공구 단면(평 엔드밀·볼 엔드밀·불 노즈·드릴/V 날)으로 내립니다. 결과는 근사입니다.
  • 수평·수직 이동과 기울어진 평·볼 엔드밀 이동은 닫힌 꼴로 정확하게 구하고, 기울어진 불 노즈·드릴 이동은 황금 분할 탐색으로 구합니다. 원호와 나선은 현의 처짐이 칸 크기의 1/4 안이 되도록 선분으로 나눕니다. 칸보다 작은 모양과 공구 아래로 파인 곳(언더컷)은 나타내지 못합니다.
  • 계산은 웹 워커가 재생 막대를 따라 조금씩 합니다. 앞으로 감으면 이어서 깎고, 되감으면 가까운 저장점(높이 지도 사본)에서 다시 깎습니다. 그물은 64칸 조각으로 나눠 바뀐 조각만 다시 만들고, 깎이지 않은 조각은 꼭짓점을 줄입니다. 화면에도 바뀐 조각 그물만 올립니다 (3D 뷰어 코어 0.11.0 setMesh — 공구 경로는 다시 올리지 않고, 찍은 측정 점·고른 것·단면도 그대로라 측정 중에도 소재가 바로 바뀝니다).
  • 기울어진 면(볼 엔드밀 곡면·드릴 끝·경사 진입)이 있는 조각은 마디 법선(이웃 높이 차분)을 넣어 매끈하게 그립니다. 둘레 칸의 높이 차가 칸 크기의 2.5배(약 68°)를 넘는 벽에 닿은 마디는 법선을 0으로 두어 뷰어가 면 법선으로 그리게 하므로 수직 벽과 그 모서리는 날카롭게 남습니다. 평평한 바닥과 벽뿐인 조각(2.5D 가공)은 법선을 넣지 않아 그물이 커지지 않습니다. 판재는 쓰는 공구가 만들 수 있는 가장 가파른 경사로 문턱을 정합니다: 평 끝 공구(구멍 기본값)와 모양 그대로 내리는 홈·포켓뿐이면 기울어진 면이 없으니 법선을 넣지 않아, 칸이 굵어도 (휴대폰 자동 해상도로 본 큰 판 등) 얕은 구멍·홈의 벽이 날카롭습니다. 구멍을 드릴 끝으로 바꾸면 문턱이 칸 크기의 약 1배(118°)가 되어 원뿔은 매끈하고, 그보다 얕은 홈은 매끈한 오목으로 그려집니다.
  • 소재 기본값은 프로그램의 공작물(Heidenhain BLK FORM)입니다. 없으면 절삭 범위(공구 중심)에 가장 큰 공구 반지름과 여유를 더하고, Z0 아래를 깎으면 Z0을 윗면으로 봅니다. 격자는 긴 변 256~2048칸이고, 자동은 휴대폰 384칸·넓은 화면 1024칸에서 시작해 프로그램이 크면 줄입니다.
  • 공구 지름과 종류는 파일에서 읽습니다(공구 주석의 지름·이름·CR=, Heidenhain TOOL DEF R). 모르는 공구는 평 엔드밀 Ø6 mm(0.25 inch)로 보고, 공구 번호마다 사용자가 바꾼 값을 이 브라우저에 기억합니다.
  • 급속 이동이 소재를 깎으면 그 줄을 알리고 깎인 자리를 빨갛게 그립니다. 해석 경고에 이미 급속 경고가 난 줄은 다시 알리지 않습니다.
  • 3축(공구 방향 Z)만 봅니다. 선반 프로그램, 회전축(A·B·C)을 쓰는 프로그램, 기울인 작업 평면·공구 끝점 제어(G68.2·G268·G43.4·CYCLE800·TRAORI· Heidenhain PLANE·CYCL DEF 19·M128 등), 공구 축이 X·Y인 TOOL CALL이 있는 프로그램은 그리지 않고 까닭을 보입니다.
  • 판재 파일(MPR·PGI·XML)은 판 크기(MPR WerkStck LA·BR·DI 또는 머리의 _BSX·_BSY·_BSZ, PGI·XML 판 정보)를 소재로 하고, 판 윗면에서 위→아래로 하는 가공만 깎습니다. 해석기가 이미 만든 가공(화면에 그리는 구멍·상자·기둥·경로)을 그대로 쓰므로 해석 결과는 바뀌지 않습니다.
    • 수직 구멍은 구멍 지름의 평 끝 공구로 구멍 깊이까지(관통이면 판 바닥까지) 깎습니다(공구 종류는 깎기 탭에서 드릴 끝으로 바꿀 수 있습니다).
    • 홈(Nuten·톱 홈)·포켓(Tasche·사각·원형·경로 포켓)·자유 형상 포켓은 파일이 정한 모양 그대로 바닥 높이까지 내립니다(파일에 공구 지름이 없어 포켓 모서리의 공구 반지름은 나타내지 않습니다 — 화면에 그리는 모양과 같습니다).
    • 윤곽·경로는 해석한 경로(가공 깊이 반영)를 따라가고, 공구 보정(MPR RK=WRKL·WRKR, PGI toolOffset, XML 보정)이 있으면 G41·G42와 같은 계산으로 공구 중심을 반지름만큼 옮깁니다. 공구 지름은 PGI·XML의 공구 폭을 쓰고, 공구 번호만 있는 MPR 윤곽은 기본값이라 깎기 탭에서 지름을 넣습니다.
    • 직사각형이 아닌 판(PGI·XML 외곽선)은 외곽선 밖을 처음부터 비어 있는 곳으로 보고 바닥 색으로 그립니다.
    • 옆면 가공(수평 구멍·옆면 홈·경로), 아랫면 가공(UfluBohr, 아랫면 자유 형상 포켓, PGI·XML 아랫면), 엣지 밴딩(깎기가 아님), 모양을 모르는 매크로는 깎지 않고 "시뮬레이션하지 않은 가공" 목록에 까닭별로 보입니다(누르면 그 가공을 고름). 꺼진 가공은 깎지 않습니다.
    • 가공 목록 차례대로 가공 k개까지만 깎아 볼 수 있습니다(가공 하나씩 따라가기). 지금 가공은 가공 그림·가공 탭·상태 막대에서 강조합니다. 한 걸음씩 갈 때도 재생과 같은 길로 계산해 바뀐 조각 그물만 올립니다.
  • 판 두께(소재 바닥)까지 다 뚫은 곳은 바닥 면을 그리지 않고 비워 둡니다. 관통 구멍·관통 홈·포켓 너머가 위·아래 어느 쪽에서도 보이고, 구멍 벽은 둘레 칸의 면이라 닫힌 그물입니다. 바닥까지 가지 않은 가공과 관통한 곳이 없는 소재는 예전 그림과 같습니다 (G-code도 공작물 바닥까지 깎은 곳은 같음. 직사각형이 아닌 판의 외곽선 밖은 그대로 바닥 색).
  • 합성 프로그램 30만 이동을 끝까지 깎는 데 볼 엔드밀 3D 곡면은 약 2.5초(자동 553칸)·6.3초(1024칸), 평 엔드밀 포켓은 약 1.2초(1024칸) 걸렸습니다. 판 2400 × 1200 MPR(구멍 620개·홈·포켓·윤곽, 이동 약 2천 개)은 1024칸에서 깎기와 그물 만들기를 합쳐 0.03초 안쪽입니다 (, 이 저장소 개발 기기의 Node 한 스레드). 실제 판재 파일 1,759개 가운데 윗면 가공이 있는 722개(MPR·PGI·XML)도 1024칸에서 예외 없이 끝까지 깎았고, 한 파일에 가운데값 약 6 ms, 90%가 16 ms 안쪽이었습니다. 그 가운데 판을 뚫은 곳이 있는 66개도 그물을 만들 때 예외가 없었고, 바닥과 비운 윗면을 합친 넓이가 소재 넓이와 같았습니다.

뷰어 앱 쓰는 법

1. 파일을 창 어디에나 끌어다 놓거나 열기(Ctrl/⌘+O)를 누릅니다. 예제 열기는 코드로 만든 합성 G-code를 엽니다. 파일은 서버로 올리지 않고 이 기기 안에서 읽습니다(해석은 웹 워커). 주 프로그램과 부프로그램 파일을 함께 고르거나 놓으면 한 작업으로 이어 읽습니다(띠 "파일 N개를 한 작업으로 읽었습니다 — 주 프로그램 …"). 다른 파일에 있을 프로그램을 찾지 못하면 띠 "다른 파일의 프로그램 …을(를) 찾지 못했습니다"의 파일 더하기로 그 파일을 골라 더합니다. 작업의 줄 번호(코드 줄 번호 칸·해석 경고·상태·재생 띠)는 원래 파일의 줄로 보입니다("O1001.nc · 4번 줄" — 파일 사이 표지 줄은 번호를 비움). 코드 찾기의 ":120"은 고른 줄이 있는 파일(없으면 주 프로그램)의 120번 줄로 갑니다.
2. 가운데 3D 보기: 왼쪽 끌기 회전, 가운데·오른쪽 끌기 이동, 휠 확대(터치는 한 손가락 회전·두 손가락 이동·핀치). 터치는 10화소(코어 TOUCH_DRAG_START_PX)보다 덜 움직이고 떼면 누르기로 보고(6~9화소 떨려도 모형이 돌지 않음), 누르기·측정 점은 선분에서 14화소(코어 touchPickTolerance 기본값) 안이면 고르며 끝점에서 14화소 안이면 끝점에 붙잡습니다(마우스는 6·10화소 그대로). 보기 도구 막대에 전체 보기, 표준 뷰, 원근/평행, 그리기 모드(음영·음영+모서리·와이어프레임·X-ray), 격자, 뷰 큐브, 좌표축, 단면(끔·X·Y·Z 축 고르기, 위치 슬라이더, 뒤집기 — 새 문서를 열면 꺼짐), 두 점 측정, PNG 저장, 패널 열고 닫기가 있습니다. G-code·Heidenhain의 두 점 측정은 끝점 말고도 G2/G3 원호의 중심(구멍 가운데처럼 빈 자리라도 커서가 오면)과 이동의 가운데 점에 붙습니다. 원호의 가운데 점은 현의 가운데가 아니라 호 위의 점이고(나선은 높이도 반), 중심은 해석기가 읽은 값 그대로입니다. 반경 보정 경로(공구 중심)에서는 보정한 조각의 가운데 점과 호 중심에 붙습니다. 판재 파일(MPR·PGI·XML)은 윤곽(자유 형상 포켓 윤곽 포함)과 판 외곽선의 원호 중심, 지름을 아는 원형 포켓의 중심, 고른 윤곽 요소(직선·호)의 가운데 점에 붙습니다. 측정 중에는 판·포켓·홈·구멍의 모서리선(이미 그려 둔 선)도 고르므로 판 외곽선, 포켓 둘레(둥근 사각 포켓의 모서리 — MPR Tasche의 RD도, 경로 포켓의 호, 원형 포켓 — 옆면에서 판 것도), 구멍 테두리(위·아래 원 — 옆면 구멍도)의 호에서도 호의 가운데 점·중심에 붙습니다. 스플라인(G5·G5.1·G5.2/G5.3)의 가운데 점은 나눈 조각 하나의 가운데가 아니라 곡선 전체의 길이 가운데(곡선 위)입니다. 원호(나선, 반경 보정 경로의 호, 판재 윤곽·판 외곽선·포켓 둘레·구멍 테두리의 호 포함)와 스플라인은 짧은 직선 토막으로 그리므로 그 토막 위를 찍거나 토막에 수직 발을 내리면 원래는 곡선에서 조금 안쪽에 찍혔습니다. 이제 찍힌 점을 정확한 곡선 위로 옮겨(3D 뷰어 코어 0.14.0 다듬기) 거리·dx·dy·dz가 곡선 위 값입니다 — 예를 들어 원호 중심에서 원호 위 아무 점까지 잰 거리가 반지름 그대로이고, 원 밖 점에서 내린 수직 발은 반지름 방향의 원 위 점입니다. 첫 점이 원호에서 멀어 토막마다 내린 발이 모두 토막 밖으로 떨어져도 곡선 위 진짜 발에 붙습니다. 두 경로의 교차점도 원호·스플라인이 끼면 토막끼리 만나는 자리가 아니라 두 곡선이 실제로 만나는 점입니다(3D 뷰어 코어 0.15.0 다듬기 — 직선과 원, 두 원은 식으로, 스플라인·나선이 끼면 두 매개변수 뉴턴으로 풂). 다른 평면의 두 원호처럼 토막끼리는 조금 비켜 지나가도 곡선이 만나면 붙고, 높이가 달라 3D로 만나지 않는 두 경로에는 붙지 않습니다. 판재 파일도 윤곽 경로·구멍 테두리·포켓 둘레·판 외곽선의 호가 다른 경로나 판·포켓·홈의 곧은 모서리선과 만나는 점은 원 위 정확한 교차점입니다 (둥근 포켓의 곧은 변뿐 아니라 각진 포켓·홈 상자·직사각형 판의 모서리도). 어느 형식이든 두 경로가 3D에서 만나는 교차점, 첫 점을 찍은 뒤 커서 둘레 경로로 내린 수직 발에도 붙고, 붙을 점이 없으면 첫 점에서 X·Y·Z축 방향이나 커서가 지나간 경로 선분과 나란한 방향의 점을 잡습니다(3D 뷰어 코어의 추론 붙잡기). 마우스를 올리면 표식 모양으로 종류를 보이고(끝점 네모·가운데 점 세모·중심 ⊕·교차점 ×·수직 발 ⊥, 축 방향은 첫 점에서 축 색 점선, 나란한 방향은 자홍 점선과 ∥), 커서 옆 툴팁에 "끝점"·"X축 방향"·"나란한 방향"처럼 이름을 적습니다. 코어가 그리는 거리 글상자는 툴팁 자리(커서 오른쪽 아래)를 비켜 그리고(3D 뷰어 코어 0.13.0), 글상자가 비킬 곳이 없을 때만 툴팁이 커서 왼쪽이나 위로 비켜 섭니다. 오른쪽 위 뷰 큐브와 3D 보기 위에 뜬 띠(측정 띠·해석 판단 띠·재생 띠)도 비켜 그리므로 두 점이 화면 구석이나 아래쪽에 있어도 거리가 가려지지 않습니다. 겹치지 않으면 자리는 그대로입니다. 결과에는 "중심 → 가운데 점", "끝점 → X축 방향"처럼 두 점의 종류를 적습니다. 방향 잠금(SketchUp 추론 잠금): 첫 점을 찍은 뒤 Shift를 누르고 있으면 지금 방향(축·나란함·수직)을 잠가 그 선 위에만 찍고, 다른 점을 가리키면 그 점을 선으로 옮긴 자리(예: Z축을 잠그고 다른 경로 끝을 가리키면 그 높이)를 찍습니다. 첫 점이 경로 끝이고 그 경로를 따라 다른 끝점·가운데 점·교차점을 가리킬 때도 그 경로 방향(축과 나란하면 그 축)으로 잠급니다 — 경로 몸통을 지나지 않고 끝점으로 바로 가도 됩니다 (3D 뷰어 코어 0.12.0). 상태 줄은 커서 아래에 Shift로 잠글 방향이 있을 때만 "Shift로 X축 방향 잠그기"처럼 알리고, 없으면 "화살표로 방향 잠금"입니다. 화살표 → X · ← Y · ↑ Z축, ↓ 지금 방향(없으면 첫 점 뒤 마지막으로 본 방향)으로 잠그고 같은 키로 풉니다(코드 목록·메뉴·탭에 초점이 있으면 그쪽 키). 잠그면 굵은 안내선과 툴팁·상태 줄의 "X축 방향으로 잠금"으로 알리고, 잠근 선 위에 찍은 결과는 "끝점 → X축 방향 · 잠금"입니다. 둘째 점을 찍거나 지우면 풀립니다. 첫 점이 G2/G3 원호(나선 포함)의 시작이나 끝이고 커서가 그 원호 위(가운데 점·다른 끝 등)에 있으면 Shift·↓·잠금 단추는 그 끝에서의 원호 으로 잠급니다. 첫 점을 원호의 가운데 점이나 원호 위 다른 자리(원호를 나눈 현 위의 아무 점, 현의 끝)에 찍었어도 커서가 그 원호 위에 있으면 그 점의 접선으로 잠급니다. 현 위에 찍은 점은 원호에서 조금 안쪽이라, 원호에서 가장 가까운 자리의 접선을 그 점을 지나게 씁니다. 잠근 방향은 첫 점에서 원호를 따라 커서 쪽으로 나가는 쪽입니다(한 바퀴 원은 가까운 쪽). 판재 파일(MPR·PGI·XML)의 윤곽 가공과 가공 없는 윤곽에 든 호, 판 외곽선·포켓 둘레·구멍 테두리의 호도 끝·가운데 점·호 위 다른 자리에서 같은 접선으로 잠급니다. 보정 경로 보기를 켰을 때 반경 보정 경로(공구 중심 — G41/G42 원호를 공구 반지름만큼 옮긴 호, 바깥 모서리를 도는 호)의 호도 같습니다. 스플라인(G5·G5.1·G5.2/G5.3)도 끝·가운데 점·곡선 위 아무 점에서 그 자리의 정확한 접선으로 잠급니다(조각 위에 찍은 점은 곡선 위 가장 가까운 자리). 원호를 나눈 현 하나의 방향이 아니라 실제 접선이고(나선은 높이 기울기도, G18·G19 평면도 맞음), 툴팁·상태 줄·결과에 "접선 방향"이라 적습니다. 커서 아래가 축·나란함·수직 발이면 그쪽이 먼저입니다. 첫 점이 놓인 곡선은 3D 뷰어 코어 0.16.0이 찍은 점에 실어 주는 선분 식별자로 그 이동(보정 경로면 그 이동의 보정 조각)·윤곽에서 바로 찾으므로, 이동이 아주 많은 프로그램에서도 첫 점을 찍을 때 모든 이동을 다시 훑지 않습니다(원호 20만 개에서 첫 점 한 번 약 31 ms → 0.04 ms). 곡선이 바뀌는 꼭짓점과 원호의 가운데 점·중심은 식별자가 한쪽 이동만 가리키거나 없어서 예전처럼 좌표로 찾습니다. (SketchUp 추론 따라가기 — 3D 뷰어 코어 0.16.0): 끝점·가운데 점·중심·교차점 같은 점 위에 마우스를 0.5초쯤 멈추면 그 점을 기억하고 (최근 셋까지, 작은 십자로 표시), 그 점을 지나는 X·Y·Z축 위에도 붙습니다(툴팁·결과 "끌어온 점에서 X축", 그 점에서 점선). 첫 점을 찍은 뒤에는 첫 점의 축 위에서 기억한 점과 나란한 자리에도 붙는데, 이 점은 첫 점에서 그 축 방향이라 "X축 방향"으로 적고 Shift로 잠글 수 있습니다. 두 점을 기억하면 한 점의 축과 다른 점의 다른 축이 3D로 만나는 점(툴팁·결과 "끌어온 Y축과 X축의 교차" — 첫 점을 찍기 전에도), 끌어온 축이 경로 선분이나 판·포켓·구멍의 모서리선과 만나는 점("끌어온 점에서 X축 · 모서리 위")에도 붙습니다(3D 뷰어 코어 0.17.0). 높이가 달라 3D로 만나지 않는 두 축에는 붙지 않습니다. (3D 뷰어 코어 0.28.0): 끌어온 점이 있으면, 커서가 앞서 지나간 곧은 선분(직선 이송·급속·드릴, 보정 경로의 직선, 판재의 곧은 윤곽 요소와 판·포켓·홈의 곧은 모서리선)과 나란하게 그 점에서 그은 선, 그 선분에 수직으로 그은 선 위에도 붙습니다 (툴팁·결과 "끌어온 점에서 모서리와 나란히"·"끌어온 점에서 모서리에 수직", 기준 선분은 자홍 점선). 원호·나선·스플라인과 보정 경로의 호, 판재 윤곽 호·판 외곽선·포켓 둘레·구멍 테두리의 호를 나눈 짧은 현은 기준이 되지 않아, 곡선 위를 지나가도 앞서 지나간 곧은 선분이 기준으로 남습니다. 기준이 X·Y·Z축과 나란한 판 모서리면 그 선은 끌어온 축과 같아 "끌어온 점에서 X축"으로 붙습니다. 첫 점을 지나는 선이 아니어서 Shift로 잠그지 않습니다. (3D 뷰어 코어 0.18.0): 첫 점을 찍은 뒤 첫 점의 X·Y·Z축이 다른 경로나 판·포켓·구멍의 모서리선과 만나는 점("X축 · 모서리 위"), 첫 점의 축이나 끌어온 축이 공작물(Heidenhain BLK FORM)·판·포켓·홈·구멍·깎기 시뮬레이션 소재의 면을 뚫는 점("X축 · 면 위"·"끌어온 점에서 X축 · 면 위")에도 붙습니다. 첫 점에서 그 축 방향의 점이라 Shift로 그 축에 잠글 수 있습니다. 축이 원호(나선, 반경 보정 경로의 호, 판재 윤곽·판 외곽선·포켓 둘레·구멍 테두리의 호)나 스플라인을 나눈 토막과 만나면 토막 위가 아니라 축과 곡선이 실제로 만나는 점에 붙고(끌어온 축도), 찍힌 점은 축에서 벗어나지 않습니다 (예: 경로 끝에서 X축을 따라 원호까지 잰 dy·dz가 0, 원 위 반지름 그대로). 판재의 구멍 벽·원형 포켓 벽·둥근 사각 포켓 모서리·판 외곽선 둥근 모서리처럼 원기둥 벽을 뚫는 점도 벽을 나눈 삼각형 위가 아니라 축과 원기둥이 실제로 만나는 점입니다(3D 뷰어 코어 0.19.0). 측정 점은 반투명으로 그린 판을 지나 그 뒤 구멍·포켓·홈을 고르므로(3D 뷰어 코어 0.23.0, 포켓·홈은 0.24.0), 판을 숨기지 않아도 판 안 수직·수평 구멍과 포켓·홈의 벽을 뚫는 점에 붙습니다. 판재 구멍은 위·아래가 막힌 기둥으로 그리므로, 위에서 보면 그 윗면을, 비스듬히 보면 판 너머로 보이는 바깥 벽을 고릅니다. 포켓·홈은 반투명으로 그리고, 고를 때는 판 면 자리의 뚜껑만 지나고 벽·바닥에서 멈춥니다(3D 뷰어 코어 0.27.0 — 그림·윤곽선은 그대로). 그래서 판 위에서 포켓·홈의 바닥(위에서 보면 바닥 높이)과 뚜껑 너머로 보이는 안쪽 벽, 포켓 바닥에 뚫은 구멍의 벽을 숨기지 않고 잽니다. 구멍 그물은 판 면에서 시작하므로 포켓 바닥 구멍을 위에서 가리키면 포켓 윗면 높이의 구멍 윗면(중심 점도 그 높이)을 고르고, 구멍 테두리는 포켓 바닥 높이에 따로 없습니다. 포켓 위 테두리(윤곽선)는 예전처럼 고르므로 테두리에서 바닥까지 깊이를 잴 수 있습니다. 뒤에 구멍·포켓·홈이 없는 판 위 자리는 예전과 같습니다. 공작물 상자와 깎기 시뮬레이션 소재의 면은 그린 면 그대로입니다(시뮬레이션 소재의 벽은 격자 한 칸 너비까지만 압니다). 찍은 결과는 "끝점 → X축 · 모서리 위"·"끝점 → Z축 · 면 위"처럼 적습니다. 축이 곡선을 나눈 토막과는 만나지 않고 토막과 곡선 사이만 지나는 자리도 곡선 위 점에 붙습니다(3D 뷰어 코어 0.20.0). 같은 윤곽을 여러 깊이로 깎는 경로에서 위 점에 머물러 끌어온 Z축이 아래 원호를 뚫는 점, 나선 위쪽 점의 Z축이 아래 바퀴를 뚫는 점, 스플라인 위를 지나는 Z축이 그렇습니다. 곡선은 짧은 토막으로 그리므로 이런 축은 토막에서 처짐(5°씩 나눈 원호면 반지름의 0.1% 가까이)만큼 떨어져 지나가, 0.19.0까지는 커서에 가까운 축 위 점에만 붙었습니다. 같은 평면에서 원호 꼭대기를 현과 거의 나란히 스치는 축도 원 위 두 교차에 붙습니다(3D 뷰어 코어 0.22.0·0.23.0 — 반지름 25 원호를 확대 12단으로 재면 8단, 0.20.0은 한 단도 붙지 않았습니다. 남은 단은 축과 현의 틈이 반 화소보다 좁거나 붙잡기 거리보다 넓거나, 꼭짓점이 커서 가까이 있어 끝점이 먼저인 확대입니다). 판 외곽선 둥근 모서리처럼 볼록한 원기둥 벽을 축이 아주 얕게 스쳐, 벽을 나눈 삼각형은 비켜 가고 원기둥만 뚫는 자리도 원기둥 위 점입니다(3D 뷰어 코어 0.22.0). 이런 축이 삼각형 하나 위에서 원기둥을 두 번 뚫어도 두 교차 모두에 붙습니다(3D 뷰어 코어 0.24.0 — 0.23.0까지는 그 삼각형 가운데 쪽 교차 하나만). (3D 뷰어 코어 0.19.0): Shift·화살표·잠금 단추로 방향을 잠근 동안에도 커서 둘레에 점 붙잡기가 없으면, 잠근 선이 경로·모서리선과 만나는 점("잠근 X축 · 모서리 위")이나 소재 면을 뚫는 점("잠근 Z축 · 면 위")에 붙습니다. 축뿐 아니라 나란한 방향·수직 방향· 원호 접선으로 잠근 선도 같고("잠근 접선 방향 · 모서리 위"), 원호·나선·스플라인·원기둥 벽과는 실제로 만나는 점입니다(축이 아닌 잠근 선은 3D 뷰어 코어 0.20.0부터 — 예: 선분 끝에서 Shift로 그 선분 방향에 잠근 선이 원호와 만나는 점, 비스듬히 잠근 선이 판 외곽선 둥근 모서리를 뚫는 점). 첫 점 축이 원호와 만나는 점을 본 뒤 Shift로 그 축에 잠가도 점이 그 자리에 남습니다. 결과는 "끝점 → 잠근 X축 · 모서리 위"처럼 적습니다. 잠근 동안 끌어온 점이 있으면 잠근 선이 그 점의 X·Y·Z축과 만나는 점("잠근 X축 · 끌어온 점에서 Y축")에도 붙고, 축으로 잠갔으면 잠근 축 위에서 끌어온 점과 나란한 자리("잠근 Z축 · 끌어온 점과 나란히")에도 붙습니다(3D 뷰어 코어 0.21.0). 잠근 선 위 점 붙잡기 다음이고 모서리·면보다 먼저입니다. 예: 구멍 중심을 첫 점으로 찍고 다른 구멍 중심에 머문 뒤 → 키로 X축에 잠그면, 그 구멍의 Y축과 만나는 자리를 바로 찍습니다. 붙잡을 점 없이 판재의 구멍 벽·원형 포켓 벽·판 외곽선 둥근 모서리 같은 원기둥 벽을 가리켜도 벽을 나눈 삼각형 위가 아니라 커서 아래 원기둥 위 점을 찍습니다(3D 뷰어 코어 0.21.0 — 판 윗면·곧은 옆면 같은 평면은 그대로). 휴대폰은 길게 눌러 정밀 조준하는 동안 십자선을 점 위에 잠시 멈추면 같은 식으로 기억합니다(길게 누르기는 정밀 조준이 쓰므로 따로 두지 않았습니다). 손가락이 떨려 십자선이 멈추지 않으면 조준하는 동안 측정 띠에 나타나는 를 다른 손가락으로 눌러 십자선 아래 점을 바로 기억합니다(아래 5). 둘째 점을 찍거나 측정을 지우면 잊고, Esc는 첫 점을 찍기 전에도 기억한 점부터 지웁니다. 측정 도구는 파일을 열 때 3D 보기와 함께 받아 두므로 문서가 보이면 바로 켜집니다. 받지 못했으면(연결이 끊김 등) 측정 단추를 누를 때 다시 받습니다. 받는 동안 단추는 눌린 채 흐리게 보이고 상태 줄에 "측정 도구를 받는 중…"이라 적은 뒤, 받으면 측정을 켭니다. 받는 동안 단추를 다시 누르거나 Esc를 누르면 켜지 않습니다. 받지 못하면 연결이 끊겼을 때는 연결된 뒤 다시 누르라고, 연결이 되는데도 못 받으면(앱의 새 버전이 나와 예전 조각이 없음) 새로 고친 뒤 최근 문서에서 다시 열라고 알립니다. 숨긴 공구, 단면에 잘린 쪽, 재생 중 아직 그리지 않은 이동의 중심에는 붙지 않습니다(중심마다 처음 그린 이동 번호를 차례로 두고 재생 자리를 코어 붙잡기 한도로 줍니다 — 재생 중에도 중심 목록을 다시 주지 않습니다). 원호 중심이 아주 많아도 코어가 점 범위 나무로 커서 둘레만 보므로 마우스 이동이 거의 늦어지지 않습니다(중심 10만 개에서 이동 한 번 약 0.2 ms — 모두 훑으면 9 ms). 읽는 동안 덮개의 (또는 Esc)로 멈추면 열려 있던 문서를 그대로 둡니다. 그래픽 문맥을 잃으면(휴대폰에서 앱을 뒤로 보냈다 돌아올 때 등) 되찾을 때까지 3D 보기 가운데에 "그래픽을 다시 준비하는 중…"을 보입니다(3D 뷰어 코어 0.25.0). 해석이 스스로 정한 것(선반 프로그램으로 읽음 · 소수점 없는 큰 좌표가 많음 · 판별한 방언 Siemens·Haas 등)은 3D 보기 위(좁은 화면은 아래) 띠로 알리고, 띠의 단추로 바로 바꿔 다시 읽거나(밀링으로 읽기·최소 단위로 읽기) 정보 탭을 엽니다. ✕로 그 문서에서 닫습니다. 좁은 화면에서는 띠 글을 두 줄까지(띠가 둘 넘거나 재생 띠가 있으면 한 줄) 보이고 글을 누르면 펼치며, 잠깐 뜨는 알림은 아래쪽 띠들 위로 올라가 단추를 가리지 않습니다.

키	하는 일
F	전체 보기
1~7	앞·뒤·왼쪽·오른쪽·위·아래·등각
F7	격자 켜고 끄기
Space	재생 / 멈춤
← →	한 이동씩 앞·뒤로(Shift는 10개). 판재 깎기에서는 한 가공씩(가공 하나씩 따라가기)
↑ ↓	고른 줄을 앞·뒤로(3D 보기·코드 목록에 초점이 있을 때)
Shift(누르고 있기)	측정 첫 점을 찍은 뒤: 지금 방향(축·나란함·수직, 첫 점에서 경로를 따라 가리키면 그 경로 방향, 원호(판재 윤곽·판 외곽선·포켓 둘레·구멍 테두리, 반경 보정 경로의 호 포함)·스플라인의 끝·가운데 점이나 그 위의 점에서 그 곡선 위를 가리키면 접선 방향) 잠금
→ ← ↑ · ↓	측정 첫 점을 찍은 뒤: X·Y·Z축으로 잠금 · 지금 방향 잠금(같은 키로 풀기)
Ctrl/⌘+F · Ctrl/⌘+G	코드에서 찾기 · 다음 찾기
Esc	측정·고른 것 지우기(측정에서 끌어온 점을 기억했으면 그것부터, 읽는 중이면 읽기 멈추기)
Ctrl/⌘+O	파일 열기

주소 인자: ?sample(예제 바로 열기), ?open=<같은 출처 주소>(그 파일을 받아 열기 — 자동 확인용, 다른 사이트 주소는 열지 않음). 공유 받기가 붙이는 ?recent=<id>·?share=<열쇠>·?share-error=<까닭>은 한 번만 쓰고 주소에서 지웁니다. 테마는 시스템 설정을 따르고, 제목 막대 단추로 고른 테마는 이 브라우저에 기억합니다. 자동 확인용으로 window.opencadApp(상태 state, open·openSample·openUrl·reparse·cancel·setSection 등)을 둡니다.

라이브러리로 쓰는 법

import { loadNcFile } from 'opencad-nc';

const { parsed, scene } = loadNcFile('part.nc', bytes); // 형식은 앞부분·확장자로 자동 판별
// parsed.kind: 'gcode' | 'heidenhain' | 'mpr' | 'pgi' | 'xml' (판재 형식은 parsed.part: MprPart)
// scene: Scene3d (opencad-viewer3d의 Viewer3d.setScene에 넘긴다)

형식별 함수(parseGcode, parseHeidenhain, parseMpr, parsePgi, parseKdtXml, ncToScene, mprToScene)와 확장자 목록(NC_EXTENSIONS 등), isPanelKind도 src/index.ts에서 내보냅니다.

선택 기능(기본은 모두 꺼짐 — 켜지 않으면 결과가 예전과 같습니다):

// 선반 모드('auto'면 글로 판별 — Fanuc 선반 G 코드 체계 latheSystem: 'A'|'B'|'C'도 고르지 않으면 판별, p.latheSystem),
// 회전축 감기, 반경 보정용 공구 표(키 = D 번호, LinuxCNC는 공구 번호)
const p = parseGcode(text, { lathe: true, rotary: { A: 'x', stepDeg: 2 }, toolTable: { 1: { diameter: 10 } } });
p.compRuns; // 보정 구간 [{ first, end, side, plane, radius, source, line }]
const scene = ncToScene(p, { compPath: true }); // 선분 묶음 'nc-comp'(묶음 '보정 경로'), meta.compRuns
const cp = ncCompPath(p, { radius: 5 }); // 조각(직선·호) 구조 배열 — compPathSegments(cp)로 선분
// 선반 공구 끝 R 보정: 노즈 반지름과 LinuxCNC 공구 방향(1~8이면 가상 공구 끝 경로, 9는 노즈 중심)
const t = parseGcode(text, { lathe: true, toolTable: { 1: { radius: 0.4, orientation: 3 } } }); // 또는 machine.latheToolsMm(mm, 파일에 없을 때만)
t.compRuns; // [{ …, radius: 0.4, tool: 1, orientation: 3, orientationSource: '공구 표 T1' }]

판재 장면(mprToScene)의 meta.lids는 포켓·홈 그물 id마다 뚜껑(들어가는 판 면 자리의 끝면) 삼각형 구간 { start, count }입니다. 3D 뷰어 코어 setItemPickThrough(id, [lid])에 넘기면 반투명 판 너머 고르기가 뚜껑을 지나 포켓 바닥·벽에서 멈춥니다(뷰어 앱이 그렇게 씁니다).

구조

경로	내용
index.html, public/favicon.svg	뷰어 앱 진입(제목·설명·테마 먼저 정하기, 홈 화면 앱 머리 태그)
site/manifest.webmanifest, public/icon-*.png, public/apple-touch-icon.png	홈 화면에 추가(웹 앱 매니페스트 원본·아이콘 — favicon.svg 그림을 Chrome으로 그려 만듦). 언어별 매니페스트와 파일 연결(share_target·file_handlers)은 tools/site.mjs 설정으로 공용 사이트 도구가 만든다
tools/site.mjs, tools/sw-source.mjs	이 앱의 사이트 설정(앱 정보 원본·파일 연결·서비스 워커 판 이름 짓기 — vite.config.ts와 시험이 같이 씀)과 오프라인 서비스 워커 본문(미리 담은 것 쓰기·공유 받기). 언어 페이지·검색 정보·사이트맵·dist/sw.js는 공용 사이트 도구의 Vite 플러그인이 이 설정으로 만든다
site/i18n-core.mjs, site/i18n.mjs, site/locales/	공용 번역기에 이 앱의 사이트 정보(site/metadata.json)를 넘기고 사전을 넣는다
src/app/	뷰어 앱 화면: app.ts(틀·열기·보기·재생·키), panel.ts(코드·공구·정보·가공·변수 탭), doc.ts(문서 상태·요약 글), protocol.ts·payload.ts·client.ts(워커 메시지·이전 목록), format.ts·keys.ts·theme.ts(글·키·테마), settings.ts(기계·읽기 설정, localStorage), recent.ts(최근 문서·공유 받은 파일, IndexedDB), measure.ts(측정 안내 글·붙잡은 종류 이름 — 첫 화면), measure-tools.ts(문서를 열 때 받는 측정 도구 조각 입구: measure-lock.ts 측정 방향 잠금·잠금 단추·붙잡기 툴팁·코어 거리 글상자 비키기, measure-track.ts 측정 띠의 끌어온 점 단추, snap.ts 원호 중심·이동 가운데 점·판재 윤곽 붙잡기, aim.ts 정밀 조준, tangent.ts 원호(G2/G3·판재 윤곽 호)·스플라인 위 점의 접선 잠금, refine.ts 코어 수직 발·선분 위 점·교차점을 곡선 위로 다듬기와 코어에 주는 붙잡기 선택, intersect.ts 두 요소(원호·스플라인·직선)의 교차점(식·두 매개변수 뉴턴), curve.ts 곡선 위 점 찾기(구간 나눔 + 뉴턴), spline.ts 스플라인 계산), core.ts(3D 뷰어 코어·측정 도구를 문서를 열 때 받기, 받기 전에 측정을 켰을 때 받은 뒤 켜기), styles.css
src/worker/parse.worker.ts	해석 워커: 파일 확인 → 해석 → 장면·패널 자료를 이전 가능한 버퍼로 돌려줌
src/index.ts	공개 입구: 형식 판별, , , ,

개발

npm install
npm run dev        # http://localhost:4401/ (예: /?sample)
npm run typecheck
npm test
npm run build      # tsc --noEmit && vite build → dist/
npm run preview    # 빌드 결과 보기

3D 뷰어 코어는 github:GyuTae-Kim/opencad-viewer3d#v0.28.0(잠금 커밋 c766d37)으로 받습니다. 보기에서 누르기는 0.26.0 onPick의 front로 판 너머 고르기와 가장 앞 고르기를 알림 하나에서 받고, 판재 포켓·홈 뚜껑은 0.27.0 setItemPickThrough로 판 너머 고르기에서 지나가게 합니다. 끌어온 점에서 나란함·수직은 0.28.0 inference.trackDirs의 edge 거르기(src/app/refine.ts의 trackDirEdge — 이동 번호·판재 붙잡기 표로 곡선을 나눈 현을 가름)로 켭니다. 0.26.0의 작은 법선 배열(packNormals)은 아직 쓰지 않습니다(아래 놓기와 같은 까닭으로 NC 장면의 법선이 작습니다). 0.25.0의 놓기(setScene의 release — 올린 뒤 법선·무늬 좌표·무늬 원본을 장면에서 지움)는 쓰지 않습니다. NC 장면에서 놓을 수 있는 것은 그물 법선뿐이고(공구 경로 선분은 위치·색이라 놓을 것이 없고 무늬는 없음) 대부분 깎기 시뮬레이션 소재 조각의 마디 법선입니다. 헤드리스 Chrome에서 GC 뒤 ArrayBuffer 뒷저장의 9% 아래였고(볼 엔드밀 30만 이동 1024칸 140.7 MB 가운데 12.4 MB, 자동 554칸 73.0 MB 가운데 3.6 MB, 공구 경로만이면 0, 판 2400 × 1200 MPR은 판 그물 법선 0.4 MB), 앱이 같은 조각 그물로 장면을 다시 짜 올리므로 놓으면 그때마다 워커에서 법선을 다시 받아야 합니다. 문맥 잃음·되찾음 알림만 써서 되찾을 때까지 3D 보기 가운데에 "그래픽을 다시 준비하는 중…"을 보입니다(장면은 코어가 그대로 다시 올립니다). 코어를 올리면 npm install "opencad-viewer3d@github:GyuTae-Kim/opencad-viewer3d#<태그>"로 받아 package.json·package-lock.json을 함께 바꿉니다(그냥 npm install은 옛 커밋을 남김). 표본·임시 파일은 .runtime/(git 무시)에 둡니다. 앱은 코어 입구(opencad-viewer3d)를 첫 문서를 열 때 src/app/core.ts의 import()로 받습니다(시작 화면 JS를 줄이려고 — 파일을 열기 시작하면 해석과 함께 받고, 오프라인 앱은 서비스 워커가 미리 담아 둡니다). 첫 화면 코드는 코어의 작은 모듈(opencad-viewer3d/camera·viewcube)만 값으로 가져오고 나머지는 import type으로만 씁니다(정밀 조준이 쓰는 pointer는 측정 도구 조각과 함께 받습니다). 측정 도구(src/app/measure-tools.ts 입구 — 방향 잠금·툴팁, 붙잡기 점, 정밀 조준, 끌어온 점 단추, 원호·스플라인 접선, 곡선 위로 다듬기)도 같은 때 core.ts의 import() 하나로 받습니다. 첫 문서는 코어를 받은 뒤 측정 도구를 3초까지 더 기다려 보이고(조각이 작아 보통 먼저 옵니다), 받지 못해도 문서는 엽니다. 앱·패널이 받기 전에도 쓰는 글(안내, 붙잡은 종류 이름)은 measure.ts에 둡니다. tests/app/core-split.test.ts가 main.ts에서 정적 가져오기로 닿는 모듈을 훑어 코어 입구·측정 도구가 첫 화면에 다시 들어오지 않는지 지킵니다. 첫 화면 JS는 끌어오기 요청의 휴대폰 성능 예산(tools/performance-budget.json — 전송 61,440바이트)에 걸리므로, 측정·깎기처럼 문서를 연 뒤에만 쓰는 코드는 이렇게 나눕니다. 지금 첫 화면 JS는 163 KB(gzip 58.3 KB, CI와 같은 opencad-site serve-performance 전송 58,652바이트 — 여유 약 2.8 KB)이고, 측정 도구 조각 47 KB(gzip 17.5 KB)와 코어 조각 267 KB(gzip 89 KB)는 파일을 열 때 받습니다(측정 도구를 나누기 전 첫 화면은 169 KB, gzip 60.7 KB, 전송 60,856바이트). 측정 방향 잠금 시험(tests/app/measure-lock-core.test.ts)은 jsdom에 가짜 WebGL2(tests/app/fake-webgl.ts)를 깔고 진짜 코어 뷰어에 포인터·키를 넣어, 앱의 툴팁·안내·잠금 단추가 코어 판정을 그대로 따르고 코어 거리 글상자가 툴팁·십자선·뷰 큐브·측정 띠를 비키는지 봅니다(그림은 그리지 않습니다). 끌어온 점 단추 시험(tests/app/measure-track-pick-core.test.ts)은 같은 진짜 코어에 앱의 정밀 조준을 붙여, 십자선이 떨려 머무르기가 걸리지 않아도 조준하는 동안 누른 단추가 십자선 아래 점을 기억하고 그 축에 붙는지 봅니다(코어 타이머는 가짜 시계로, 길게 누르기는 시간으로 기다립니다). 잠근 선과 끌어온 축의 교차(), 끌어온 점에서 모서리와 나란함·수직과 기준 현 거르기 (), 판 너머 구멍·포켓 벽(), 볼록한 원기둥 벽을 스치는 축()도 같은 진짜 코어로 봅니다. 보기에서 판 너머 가공 누르기()는 앱 전체를 진짜 코어로 띄우고 해석 워커만 같은 스레드로 바꿉니다. 포켓·홈 뚜껑 너머 재기와 누르기()는 뚜껑을 주지 않은 28차 판정과 견줍니다.

공용 사이트 도구: 다섯 언어 페이지·검색 정보·사이트맵·내용 수정일·언어별 앱 정보·서비스 워커 빌드, 공용 번역기, 언어 메뉴, 서비스 워커 등록·새 판 알림, 방문 통계, 휴대폰 성능 비교는 다른 OpenCAD 앱과 함께 쓰는 opencad-site-kit (github:GyuTae-Kim/opencad-site-kit#v0.1.5, 잠금 커밋 43ec8da, 빌드 때만 써서 devDependencies)에 있습니다. 이 앱에만 있는 값은 tools/site.mjs(앱 정보 원본 site/manifest.webmanifest와 파일 연결, 검색 정보 자리의 앱 정보 링크, 서비스 워커 판 이름 짓기)와 tools/sw-source.mjs(서비스 워커 본문)에 둡니다. check:seo·check:i18n·test:seo·update:content-dates는 도구의 opencad-site 명령입니다. 도구 판을 올릴 때는 빌드 결과를 견줍니다.

npx vite build && cp -R dist .runtime/dist-before                                        # 올리기 전
npm install -D "opencad-site-kit@github:GyuTae-Kim/opencad-site-kit#<태그>"               # package.json·잠금 파일을 함께
npx vite build && npx opencad-site compare-dist .runtime/dist-before dist                 # 바뀐 파일과 처음 다른 곳

도구의 판 설명에 적힌 것 밖의 차이가 없으면, 스크립트가 바뀐 경우 내용 수정일을 갱신하고(아래 "검색·공유 메타데이터와 콘텐츠 수정일") 빌드·시험을 돌립니다.

실제 파일 훑기: 각자 가진 NC 파일 폴더를 앱 워커와 같은 해석 길로 읽어 예외·경고·빈 경로·시간을 모읍니다(파일을 바꾸거나 저장소에 넣지 않습니다).

npm run sweep -- --dirs "<폴더1>:<폴더2>" --out .runtime/sweep/before   # 또는 OPENCAD_SWEEP_DIRS="<폴더1>:<폴더2>"
#   --jobs 4(자식 프로세스 넷으로 나눠 해석) --limit 100(앞의 100개만) --force(같은 --out 덮어쓰기)
npm run sweep:compare -- .runtime/sweep/before .runtime/sweep/after --fail-on-change

폴더를 주지 않으면 쓰는 법만 찍고 끝납니다(CI에서는 돌지 않습니다). 앱이 여는 확장자만 고르고, 내용(sha256)이 같은 파일은 한 번만 읽으며 C 머리 파일(.h)은 뺍니다. <out>/records.jsonl에 파일마다 분류(ok·warn·empty·error)·형식·방언·지표(선분·이동·가공 수, 장면 서명 등)·경고 코드를, summary.json에 분류·형식별 개수, 예외·경고 코드별 개수, 해석 시간 백분위, 품질 지표를 씁니다. 경로는 이 로컬 결과에만 남기고 보고·저장소에는 옮기지 않습니다. sweep:compare는 같은 내용 해시끼리 분류·지표가 바뀐 파일과 새 예외를 보이고, --fail-on-change면 바뀐 것이 있을 때 1로 끝납니다.

깎기 시뮬레이션 재기: 합성 프로그램(볼 엔드밀 3D 곡면 지그재그·평 엔드밀 층 포켓·G83 구멍 격자·판 2400 × 1200 MPR)을 코드로 만들어 끝까지 깎는 시간과 메모리, 그물 크기 가운데 마디 법선(매끈한 음영)이 차지하는 몫을 표로 찍습니다.

npm run sim:bench -- --moves 300000 --res auto,auto-phone,1024,384   # --only raster,pocket,drill,panel

프로그램(30만 이동)	격자	깎기	저장점	깎인 조각 그물(그 가운데 마디 법선)
볼 엔드밀 3D 곡면	자동 553 × 553	2.5초	51 MB	12 MB (3.6 MB)
볼 엔드밀 3D 곡면	1024 × 1024	6.3초	70 MB	41 MB (12 MB)
볼 엔드밀 3D 곡면	휴대폰 자동 256 × 256	0.7초	2 MB	2.6 MB (0.8 MB)
평 엔드밀 포켓	1024 × 725	1.2초	7 MB	20 MB (0)
드릴 구멍 격자(48만 이동)	자동 905 × 900	0.8초	39 MB	32 MB (9.5 MB)
판 2400 × 1200 MPR(이동 1,946개)	자동 1024 × 512	0.01초	0	14 MB (0 — 평 끝 공구뿐)

(2026-10-28, 개발 기기 Node 한 스레드에서 세 번 재어 가장 빠른 값 — 다른 작업이 함께 돌던 때라 조금 느릴 수 있습니다. 판의 그물 만들기는 약 0.02초입니다. 10차에 기계가 매우 바쁠 때(부하 평균 70 안팎) 다시 재면 깎기 시간은 1.11.6배였고, 깎는 코드는 바뀌지 않아 표의 시간은 그대로 둡니다. 그물 크기는 같습니다. 13차에 관통한 곳을 비우도록 그물 만들기를 바꾼 뒤 다시 재면(부하 평균 1143) 깎기 시간은 2.53.6배였고, 깎는 코드는 이때도 바뀌지 않았습니다. 저장점과 그물 크기(꼭짓점·색·법선)는 표와 같습니다. 판 MPR의 관통 구멍(Ø35 20개 — 깊이 25, 판 두께 19)처럼 판을 뚫은 곳은 이제 비워 그리고, 그런 조각(1024칸에서 58개)만 뺀 삼각형 번호를 따로 갖습니다. 판의 조각 그물 만들기를 바꾸기 전 코드와 번갈아 25번씩 재면 가장 빠른 값이 15 ms에서 1618 ms가 되었습니다.)

브라우저에서는 워커가 같은 코드로 계산하고, 화면은 소재가 처음 다 모였을 때만 문서 장면 + 소재 그물을 올린 뒤 바뀐 조각 그물만 바꿉니다(코어 setMesh). 조각이 거의 모두 바뀌었고(색·공구 바꾸기) 공구 경로가 작으면 장면 전체 한 번이 더 싸서 그쪽으로 올립니다(측정 중이면 그래도 조각만). ×100 재생 6초를 GPU가 있는 헤드리스 Chrome(Metal)에서 잰 값(앞 = 장면 전체를 다시 올리던 9차 코드, 같은 코어 0.11.0):

합성 볼 엔드밀 프로그램	격자	한 번 올리기(가운데값 · 최대)	초당 올리기	6초 동안 GPU로 보낸 양	50 ms 넘는 프레임
10만 이동	944 × 944	3.4 · 5.7 ms → 0.8 · 1.8 ms	12 → 60(매 프레임)	1,512 → 634 MB	0 → 0
30만 이동	554 × 554	1.4 · 2.5 ms → 0.4 · 1.0 ms	12 → 60	873 → 345 MB	0 → 0
100만 이동	309 × 309	4.2 · 116 ms → 0.3 · 1.0 ms	11 → 60	1,591 → 192 MB	2 → 0

두 쪽 모두 프레임은 16.7 ms(60 fps)였고, 화면(끝까지·40% 자리, 판 600 × 400 PGI 넓은 화면·375px)은 화소까지 같았습니다. CPU를 4배 늦추면(휴대폰 흉내, 30만 이동) 두 쪽 모두 메인 스레드가 가득 차 평균 약 37~40 fps였고, 새 쪽은 한 번 올리기 6.7 → 2.6 ms로 매 프레임 소재를 바꿉니다.

휴대폰 검사: 끌어오기 요청마다 mobile-validation.yml이 같은 실행기에서 기준(main)과 후보를 빌드해 Lighthouse로 휴대폰 첫 열기를 세 번씩 재고 (압축해서 주는 미리 보기 서버와 중앙값 표는 공용 도구의 opencad-site serve-performance·performance-summary — 기준 빌드 뒤 이 커밋으로 돌아와 npm ci를 다시 해 명령을 찾는다), playwright-cli로 390px 터치 화면에서 파일 고르기 → 도구 막대 → 원호 중심·가운데 점 측정 → 패널 → 최근 문서 → ?sample → 영어 페이지를 확인합니다(tools/mobile-browser-check.js). 끝으로 후보의 가운데값을 tools/performance-budget.json과 견줘(opencad-site check-performance-budget) 넘으면 실패합니다 (성능 90 이상, 접근성·SEO 100, FCP 2000 ms·LCP 2200 ms·TBT 300 ms 이하, 첫 화면 JS 60 KiB 이하 등 — 파일의 note에 잰 값).

배포

main에 올리면 .github/workflows/deploy.yml이 형식 검사 → 시험 → 빌드 뒤 dist/를 gh-pages 가지에 게시합니다 (GitHub Pages: https://gyutae-kim.github.io/opencad-nc/). 끌어오기 요청은 ci.yml이 같은 확인을 하고, mobile-validation.yml이 휴대폰 첫 열기와 터치 흐름을 봅니다.

남은 일

• 5축: 공구 끝점 제어 없는 동시 5축(기계 구조·피벗 길이가 필요), 공구 방향 표시, M128·회전축 감기(Heidenhain). 기울인 작업 평면 가운데 Heidenhain PLANE·CYCL DEF 19·DIN/ISO G80과 Siemens CYCLE800은 아직 경고만(G68.2·G268은 읽음)
• 반경 보정: Fanuc B형·C형 들어가기(교점 방식)·보정 중 평면 바꾸기·G41/G42 방향 바꿀 때의 교점. LinuxCNC 길이 규칙은 보정 평면 안 길이로 보고, G40 뒤 첫 이동이 평면에 수직(Z만)이면 설명서가 길이를 어떻게 재는지 정하지 않아 보지 않습니다. 길이 경고는 보정 경로를 그릴 때(정보 탭 "보정 경로 보기"·compPath)만 나옵니다(반지름을 공구 표·옵션에서 정하므로). 여러 급속 규칙은 설명서가 앞 급속이 어디로 가는지 적지 않아 보정 없는 프로그램 점으로 그립니다. 실제 LinuxCNC와 견줄 일이 남았습니다. 선반 공구 끝 R 보정의 공구 방향 번호는 LinuxCNC 그림 기준이라 Fanuc 등 다른 컨트롤러의 가상 공구 끝 번호와 견주지 않았고(경고), 방향 0의 뜻, 공구 마모 보정·공구 표의 앞뒤 각(I·J), 보정 중 공구 바꾸기는 다루지 않습니다
• 선반: Fanuc G71·G72 II형(오목 윤곽), 나사 사이클의 모따기·절입 각. LinuxCNC G70~G72에서 설명서가 정하지 않은 것(층 사이 물러나는 꼴, 포켓에 들어가는 차례, G7x.1이 멈추는 자리, G7 지름 모드의 거리)은 여기서 정한 대로 그립니다. 실제 컨트롤러와 견줘 맞출 일이 남았습니다. Fanuc G 코드 B·C 체계는 단순 사이클 꼴로만 판별합니다(단순 사이클 없이 G90/G91·복합 사이클만 쓰는 B·C 프로그램은 A로 읽고 알림 — 정보 탭에서 고름)
• Heidenhain: 다음 블록 자료가 필요한 FK(PDX·RX·PAR, FSELECT), 윤곽(SL) 사이클 20~25·270, 회전·배율·대칭 사이클 7.x 밖의 것, PATTERN DEF
• Siemens: 밀링·선반 사이클(POCKET·SLOT·CYCLE95 등) — 경고만. 원호 위 CHR의 길이는 현 길이로 잽니다(호 길이로 재는 컨트롤러라면 큰 모따기에서 조금 다름)
• Okuma OSP: CALL O…·VC 변수·NLAP·RTS — 판별해 띠·경고만(G15 H 좌표계는 읽음)
• Haas G150(범용 포켓)·G47(글자 새기기) 같은 매개변수 G 코드 — 그 블록의 좌표를 이동으로 그리지 않고 경고만
• 여러 파일 작업: 폴더째 열기(브라우저가 폴더 안 파일을 주지 않는 환경이 많음 — 파일을 함께 골라야 함), 기계에 든 O9000번대 매크로의 내용, 경고 글 안에 든 줄 번호(예: 반경 보정 "보정 구간(N번 줄)")는 아직 이은 글의 줄
• Haas G143·G234: 공구 길이 보정 켜기와 같은 블록의 이동만(5축 공구 방향 보정은 그리지 않음)
• 다국어: 그릴 경로가 없는 프로그램을 열 때 알림 끝에 붙이는 첫 해석 경고("해석 경고: …")는 변수 자리에 잡힌 글이라 다른 언어에서도 한국어 그대로입니다
• MPR: 좌표계 표 [K·KO(면 좌표계), BohrUniv 등 나머지 매크로(지금은 목록과 위치 점만). Easyedge·FreiFormTasche·Tasche의 RD는 실제 파일로 추정한 뜻이라 다른 프로그램이 쓴 파일(띠를 윤곽 여러 변에 걸치거나 MDA·MDE·RI를 바꾼 것, TI가 양수인 자유 형상 포켓, 공구 반지름보다 작은 RD)에서는 다를 수 있습니다. 자유 형상 포켓·사각 포켓의 공구 경로(겹침 XY·나선 진입)는 그리지 않고 판 부분만 보입니다
• 소재 깎기 시뮬레이션(지금은 3축 높이 지도 2단계): 5축·기울인 평면(공구 방향이 바뀌는 깎기), 선반(회전체 깎기), 공구 홀더·자루 충돌, 설계 모형과 견주는 잔삭·과삭 비교, 공구 아래로 파인 곳(여러 겹 dexel), 회전축(A·B·C)을 0도로만 쓰는 프로그램도 그리기. 판재: 옆면·아랫면 가공(판을 뒤집거나 옆에서 보는 높이 지도가 필요), 포켓 모서리의 공구 반지름(파일에 공구 지름이 없음 — 공구 표에서 고르게 할 수 있음), 톱 홈의 날 들어가고 나오는 호. 판재 구멍을 드릴 끝으로 바꾸면 칸보다 얕은 홈도 매끈하게 그립니다(높이 차만으로는 원뿔 비탈과 구별하지 못함 — 마디마다 깎은 공구를 기억해야 함). 조각(64칸)을 통째로 다시 올리므로 바뀐 마디 줄만 올리기(코어 vertices 구간)는 쓰지 않습니다
• 측정 접선 잠금·곡선 위로 다듬기: G2/G3 원호(나선 포함)·스플라인(G5·G5.1·G5.2/G5.3), 반경 보정 경로(공구 중심)의 호와 판재 윤곽·판 외곽선·포켓 둘레·구멍 테두리의 호까지입니다. 옆면 윤곽 가공 경로는 해석기가 꺾은선으로 바꿔 두어 꺾은선 그대로입니다. 좌표 변환 사이클·모서리 다듬기·회전축 감기 중에 그린 스플라인은 곡선 정의를 남기지 않아 조각 방향으로 잠급니다
• 측정 끌어온 축: 기억한 점을 지나는 X·Y·Z축, 첫 점 축 위 나란한 자리, 그 축끼리와 경로 선분·모서리선이 만나는 점, 소재 면을 뚫는 점, 잠근 선과 그 축이 만나는 점, 지나간 곧은 선분과 나란한 선·수직인 선까지입니다. 나란한 선·수직인 선이 첫 점 축·다른 끌어온 축·모서리·면과 만나는 점은 3D 뷰어 코어에 순수 계산(trackDirMeetSnap)만 있어 아직 붙지 않습니다. 곡선을 짧은 직선 이송(G1)으로 풀어 쓴 CAM 프로그램이나 회전축 감기로 나눈 경로의 토막은 프로그램에서 곧은 이동이라 나란함·수직의 기준이 됩니다(원호·스플라인 정의가 없어 가르지 못함)
• 측정 축과 모서리·면의 교차: 같은 평면에서 원호 꼭대기를 스치는 축은 축과 현의 틈이 반 화소보다 좁은 확대(크게 당김)에서는 축 위 커서 자리이고, 꼭짓점이 커서에서 붙잡기 거리 안이면 끝점이 먼저입니다( — 반지름 25 원호, 확대 12단 가운데 8단에서 붙음). 포켓·홈은 고를 때 뚜껑만 지나고 바닥에서 멈추므로, 포켓 안에 더 깊은 포켓을 겹쳐 판 곳은 바깥 포켓 바닥에서 멈춥니다(겹친 곳만 지나게 하려면 바닥 삼각형을 나눠야 해 그림이 바뀝니다). 포켓 바닥 구멍의 실제 테두리(포켓 바닥 높이)는 구멍 그물이 판 면에서 시작해 붙잡지 않습니다. 깎기 시뮬레이션 중에는 판을 빼고 소재를 그리므로 예전처럼 겹쳐 그린 포켓·홈 그물을 지나 소재 면을 고릅니다(보기에서 누를 때도 같습니다). 원기둥 벽 위로 다듬는 것은 판재의 구멍·포켓·판 외곽선 둥근 모서리이고, 해석기가 그리는 판재 구멍은 모두 판 면에 수직입니다(기울여 뚫는 BohrUniv 등은 위 MPR 항목처럼 목록과 위치 점만). 깎기 시뮬레이션 소재는 격자 마디가 그물 꼭짓점이라 크게 당기지 않으면 면을 뚫는 점보다 마디 꼭짓점에 먼저 붙고, 벽은 격자 한 칸 너비까지만 압니다 (공구가 지나간 정확한 면을 남기지 않음)

내력

2dcad-viewer의 src/formats/nc/에서 분리했습니다(커밋 d7c584a 기준, 처음 들어온 것은 PR #7). src/view/의 파일은 같은 커밋의 src/app/view3d/에서 옮겼습니다. 2D 뷰어 안에서 NC 파일을 3D 탭으로 열던 화면(코드 보기·공구 목록·재생 패널, 웹 워커 — 같은 커밋의 src/app/view3d/manager.ts·panel.ts 등)은 2D 화면 골격(리본·탭)에 기대지 않게 다시 짜서 src/app/·src/worker/의 혼자 돌아가는 뷰어 앱으로 옮겼습니다.

라이선스

MIT

검색·공유 메타데이터와 콘텐츠 수정일

site/metadata.json을 공통 원본으로 삼아 공용 사이트 도구의 Vite 플러그인이 제목·설명·canonical·Open Graph·Twitter Card·JSON-LD를 초기 HTML에 넣습니다. 같은 원본으로 앱의 공개 주소를 담은 sitemap.xml도 생성합니다. 공유 이미지는 각 앱의 public/og-opencad.jpg이며 앱 파일과 함께 배포합니다. robots.txt는 같은 호스트 루트(https://gyutae-kim.github.io/robots.txt)의 설정이 적용됩니다.

site/content-history.json에는 실제 콘텐츠 수정 시각과 지문을 저장합니다. 초기 HTML 본문·메타데이터·공유 이미지와 빌드된 앱/워커 JavaScript·CSS를 비교하므로 앱 기능이 바뀌면 날짜 갱신이 필요합니다. 수정일 자체와 소스 맵은 비교에서 제외합니다.

1. 콘텐츠를 변경한 실제 UTC 시각을 기록하고 npm run update:content-dates -- --at YYYY-MM-DDTHH:mm:ssZ를 실행합니다.
2. npm run build로 다시 빌드합니다. 변경되지 않은 콘텐츠는 기존 날짜를 유지하며, 날짜가 오래되었거나 잘못된 경우 SEO 검사가 실패해 배포를 막습니다.
3. npm run test:seo와 기존 테스트를 실행하고 메타데이터·수정일 기록을 함께 커밋합니다.

일반 빌드나 배포 시각으로 날짜를 자동 갱신하지 않습니다. sitemap.xml의 lastmod와 앱 구조화 데이터의 dateModified는 동일한 기록을 사용합니다. 배포 뒤에는 앱·사이트맵·공유 이미지의 실제 공개 응답을 확인하고, 포트폴리오 통합 사이트맵의 연결 날짜도 새 앱 사이트맵과 맞춥니다. 사이트맵 게시와 검색엔진의 실제 수집·색인 완료는 별도로 확인합니다.

다국어 UI와 정적 소개

한국어 기본 주소와 영어(/en/), 일본어(/ja/), 중국어 간체(/zh-CN/), 독일어(/de/) 페이지를 제공합니다. 각 언어의 소개 본문과 검색·공유 메타데이터를 빌드할 때 생성하며, hreflang과 사이트맵이 같은 페이지의 언어들을 연결합니다. site/locales/*.json에 한국어 원문과 번역을 저장하고, 브라우저는 선택한 언어의 사전만 내려받습니다. 방문 중 외부 번역 서비스는 호출하지 않습니다.

우측 상단 지구본 아이콘에서 언어를 선택합니다. 방향키로 이동하고 Escape나 바깥 클릭으로 닫을 수 있습니다. 언어 선택은 URL에 반영하며, 열린 문서나 편집 상태를 다시 만들지 않고 화면 문구·접근성 설명·오류·도움말을 갱신합니다. 명령 식별자·입력값·파일명·모델 이름·원본 도면의 문자는 번역하지 않습니다. 새 데이터 이름을 표시하는 요소에는 translate="no"를 지정하고, UI 문구의 {0} 같은 변수 자리를 변경하지 마세요. 여러 줄 메시지와 새 한국어 문구도 번역 사전에 추가해야 합니다. 묶음 이름(급속 이송·구멍·공구 없음·가공 종류 등)은 앱 낱말이라 옮기고, 이름 붙은 공구의 묶음·변수 표의 이름·식·설명은 파일 자료라 그대로 둡니다. 코드 목록은 글을 옮기지 않지만 목록 이름과 경고 줄 번호 칸의 풍선 글(경고가 둘 넘으면 줄마다)은 옮깁니다. ·로 이은 문장은 짧은 변수 문구(예: 줄 {0})가 뒤 조각까지 그대로 잡으면 조각마다 따로 옮깁니다(남는 한국어가 적은 쪽을 고름 — 잡은 파일·공구 이름은 여전히 그대로). 변수 자리가 잡은 값은 옮기지 않으므로, 해석기가 이유 글을 끼우는 경고(예: Heidenhain FK의 "…을 정할 자료가 모자람 — 다음 블록 자료가 필요한 FK는 그리지 않음", MPR 윤곽 모서리 둥글리기·모따기)와 정보 탭 목록에 글 하나로 들어가는 보정 경로 경고("보정 경로: N번 줄: …")는 이유마다 전체 꼴을 사전에 둡니다 (tests/warn-i18n.test.ts가 네 언어에서 한국어가 남지 않는지 봅니다).

npm run test:i18n은 언어 전환과 문서 데이터 보존을, npm run check:i18n은 다섯 언어의 정적 소개·canonical·언어 링크·사전 변수·에셋 경로를 검사합니다. 번역이나 앱을 수정하면 기존 콘텐츠 수정일 갱신 절차를 따른 뒤 다시 빌드합니다. 자동 번역 초안의 주요 메뉴와 제품명은 교정했으며, 긴 기술 설명에는 추가 원어민 감수가 필요합니다.