USER MANUAL // MoonCAD v1KO (9 CH) · EN (9 CH)

MoonCAD 사용 설명서 · User Manual

MoonCAD v1의 목표 사양(핵심 명령 148개 목표, 정밀 좌표 입력 문법, 3D 솔리드 모델링, AI 코파일럿, DXF 및 DWG 파일 처리와 저장 리포트, 알려진 제한 사항)을 한국어와 영어로 안내합니다.

PART I // KOREAN EDITION

한국어 사용 설명서

1. 시작하기

CH 01 · KO
초안 안내: 이 문서는 MoonCAD v1의 목표 사양을 설명합니다. 에디터 화면과 각 명령은 현재 v1 릴리스를 목표로 개발 중이며, 명령별 구현 현황은 상단 메뉴의 호환성 현황 페이지에서 확인할 수 있습니다.

1.1 MoonCAD 개요

MoonCAD는 웹 브라우저에서 동작하도록 설계된 2D 제도 및 3D 솔리드 모델링 도구입니다. 별도의 프로그램 설치 없이 브라우저에서 도면을 작성하고, DWG 및 DXF 파일을 열람·저장하며, 사람과 같은 명령 엔진을 공유하는 AI 코파일럿과 함께 도면을 완성하는 환경을 목표로 합니다.

1.2 화면 구성 (v1 목표)

에디터는 눈의 피로를 줄이는 어두운 도면 시트 작업 환경을 기본으로 하며 다음 영역으로 구성됩니다.

  • •상단 도구모음 및 파일 탭 (RIBBON, FILETAB): 자주 쓰는 작도·수정·3D·치수 아이콘과 현재 도면 탭 표시줄을 전환합니다(v1에서는 브라우저 탭당 하나의 도면을 열며 FILETAB으로 탭 표시줄을 켜고 끕니다).
  • •중앙 작업 캔버스: 2D 및 3D 도면 공간과 십자선 커서, 우측 상단의 방향 큐브(NAVVCUBE), 좌측 하단의 좌표계 아이콘(UCSICON)이 표시됩니다.
  • •좌·우측 도킹 패널: 레이어 관리자(LAYER), 객체 특성(PROPERTIES), 그리고 우측의 AI 코파일럿 패널(MOONAI)을 열고 닫을 수 있습니다.
  • •하단 명령행 (COMMANDLINE) 및 상태 표시줄: 명령어, 옵션 키워드, 좌표를 직접 입력하고 기록을 확인하며, 스냅·격자·직교 모드를 전환합니다.

1.3 기본 마우스 및 키보드 조작

동작객체 선택 / 좌표 지정
실행 방법마우스 왼쪽 클릭
동작포함 창 선택
실행 방법왼쪽에서 오른쪽으로 드래그 (영역 안에 완전히 들어온 객체만 선택)
동작걸침 창 선택
실행 방법오른쪽에서 왼쪽으로 드래그 (영역 경계에 걸친 객체까지 선택)
동작화면 이동 (PAN)
실행 방법마우스 가운데 휠 버튼 누른 채 드래그
동작화면 확대/축소 (ZOOM)
실행 방법마우스 휠 스크롤 (커서 위치 기준)
동작도면 전체 범위 맞춤
실행 방법마우스 휠 버튼 더블클릭 또는 ZOOM → E
동작3D 시점 회전 (3DORBIT)
실행 방법Shift + 마우스 가운데 휠 드래그 또는 3DORBIT 명령
동작직전 명령 반복
실행 방법명령 대기 상태에서 Enter 또는 Space
동작현재 명령 취소 / 선택 해제
실행 방법Esc

1.4 한글 키보드(한/영) 자동 인식

한국어 사용자가 도면을 그릴 때 겪는 한/영 전환 불편을 줄이기 위해, MoonCAD 명령행은 도면 문자 입력(TEXT, MTEXT 내용 입력 등)을 제외한 모든 명령 및 옵션 단계에서 물리 키 위치와 한글 자모를 영문 명령 철자로 자동 변환합니다. 예를 들어 한글 상태에서 ㅣ를 입력하고 Space를 누르면 바로 L(LINE)로 동작합니다.

2. 기본 2D 작도

CH 02 · KO
초안 안내: 이 문서는 MoonCAD v1의 목표 사양을 설명합니다. 각 작도 명령의 구현 현황은 호환성 현황 페이지에 기록됩니다.

2.1 선과 폴리선 그리기

  • •LINE (단축키 L): 시작점과 다음 끝점을 차례로 찍어 개별 선분을 그립니다. 진행 중 U(취소)를 입력하면 직전 선분만 되돌리며, 두 개 이상의 선분을 그린 뒤 C(닫기)를 입력하면 첫 시작점으로 닫습니다. 첫 프롬프트에서 바로 Enter를 누르면 직전에 그린 선이나 호의 끝점에서 이어서 그립니다.
  • •PLINE (단축키 PL): 여러 직선 구간과 호 구간이 하나의 객체로 연결된 2D 폴리선을 그립니다. 진행 중 A로 호 그리기로 전환하거나 W로 시작·끝 선폭을 지정할 수 있습니다.
  • •RECTANG (단축키 REC): 대각선 방향의 두 모서리 점을 찍거나, D(치수) 옵션으로 가로·세로 길이를 입력하여 닫힌 직사각형 폴리선을 만듭니다. F(모깎기) 또는 C(모따기) 값을 미리 지정할 수 있습니다.
  • •POLYGON (단축키 POL): 3변부터 1024변까지의 정다각형을 만듭니다. 중심점 기준(원에 내접 I / 외접 C) 또는 한 변의 양 끝점(E) 방식으로 작도합니다.

2.2 원, 호, 타원 및 스플라인

  • •CIRCLE (단축키 C): 기본 중심점+반지름(또는 D 지름) 방식 외에도 세 점 통과(3P), 지름의 양 끝점(2P), 두 객체에 접하는 반지름(T) 방식을 지원합니다.
  • •ARC (단축키 A): 기본 3점 호, 시작점-중심점-끝점, 중심점-시작점-각도 등 여러 조합으로 원호를 그립니다.
  • •ELLIPSE (단축키 EL): 첫 번째 축의 양 끝점과 반대 축 반경 거리를 지정하거나, 중심점(C) 기준으로 타원 및 타원호를 작성합니다.
  • •SPLINE (단축키 SPL): 지정한 통과점 또는 제어점을 부드럽게 지나는 곡선을 만듭니다.
  • •XLINE (XL) 및 RAY: 도면 전체를 가로지르는 무한 구성선(XLINE: 수평 H, 수직 V, 각도 A, 이등분 B, 간격 O)과 한쪽 방향으로 뻗어 나가는 반직선(RAY)을 보조선으로 활용합니다.

2.3 해치와 주석, 치수 기입

  • •HATCH (단축키 H): 닫힌 영역 안의 한 점을 클릭하거나 경계 객체를 선택하여 해치 패턴(SOLID, ANSI31 등)을 채웁니다.
  • •TEXT (DT) 및 MTEXT (T, MT): 단일 행 문자와 단락 폭·줄간격·글꼴 스타일을 갖춘 다중 행 문자를 기입합니다. 한글 유니코드 및 기존 한글 인코딩 도면 문자를 지원합니다.
  • •치수 명령 (DIMLINEAR, DIMALIGNED, DIMANGULAR, DIMRADIUS, DIMDIAMETER, DIMBASELINE, DIMCONTINUE): 수평·수직·정렬 거리, 두 직선 사이 각도, 원과 호의 반지름·지름 치수를 도면 치수 스타일(DIMSTYLE)에 맞추어 기입합니다.

3. 좌표 입력 및 스냅 문법

CH 03 · KO
초안 안내: 이 문서는 MoonCAD v1의 좌표 입력 및 객체 스냅 목표 사양을 설명합니다.

3.1 좌표계 및 기본 입력 형식

명령행에서는 공백(Space)이 곧 Enter(입력 확정)로 동작하므로, 좌표 숫자 사이에 공백을 넣지 않고 입력합니다.

입력 형태절대 직교 좌표
예시100,200 또는 100,200,50
의미 및 동작현재 사용자 좌표계(UCS) 원점 (0,0,0) 기준 위치
입력 형태상대 직교 좌표
예시@150,-50 또는 @0,0,25
의미 및 동작직전 지정점으로부터의 상대 이동량 (@ 단독 입력은 @0,0,0과 동일)
입력 형태극좌표 (거리<각도)
예시200<45 또는 @120<135
의미 및 동작거리와 XY 평면 각도(도 단위, 반시계 방향 기본)로 지정
입력 형태원통 좌표
예시@100<30,50
의미 및 동작XY 평면 극좌표 거리·각도와 Z축 높이를 함께 지정
입력 형태구면 좌표
예시@100<45<30
의미 및 동작3차원 거리, XY 평면 방위각, XY 평면으로부터의 고도각 지정
입력 형태세계 좌표계(WCS) 강제
예시*0,0,0 또는 @*50,0
의미 및 동작현재 좌표계 회전과 무관하게 표준 세계 좌표계 기준으로 계산
입력 형태직접 거리 입력
예시커서 방향 지정 후 250
의미 및 동작안내선이 가리키는 방향으로 지정한 거리만큼 떨어진 점
입력 형태각도 고정
예시<30
의미 및 동작다음 한 점을 찍을 때 커서 이동 각도를 30도 직선 위로 고정

3.2 점 필터 및 보조 입력

  • •좌표 성분 필터 (.x, .y, .z, .xy, .xz, .yz): 한 객체의 X좌표와 다른 객체의 Y좌표를 조합해 새로운 점을 찍을 때 사용합니다. 예를 들어 .x를 입력하고 첫 점을 찍으면 나머지 YZ 성분을 찍으라는 안내가 이어집니다.
  • •from (기준점 상대 오프셋): 임의의 기준점을 먼저 찍은 뒤, 그 점으로부터 상대 좌표(@50,30)만큼 떨어진 곳을 실제 입력점으로 삼습니다.
  • •mtp / m2p (두 점의 중점): 별도의 보조선을 그리지 않고도 화면에서 찍은 두 점의 정중앙 위치를 계산합니다.
  • •tk / tracking (일시 추적): 수평·수직 방향을 따라 여러 번 꺾어 이동한 최종 위치를 한 점으로 확정합니다.

3.3 객체 스냅 (OSNAP) 및 기능키

상시 스냅(F3)을 켜두거나, 점 입력 단계에서 스냅 약어를 직접 입력해 다음 한 점에만 일시 적용할 수 있습니다.

  • •주요 스냅 키워드: END(끝점), MID(중간점), CEN(중심점), GCE(도형 중심), NOD(점), QUA(사분점), INT(교차점), EXT(연장선), INS(삽입점), PER(수직점), TAN(접점), NEA(근처점), NON(이번 한 점만 스냅 끔).
  • •기능키 요약: F3(객체 스냅), F7(격자 표시), F8(직교 고정), F9(간격 스냅), F10(극좌표 추적 — F8과 상호 전환), F11(객체 스냅 추적), F12(동적 입력).

4. 레이어 및 객체 특성 관리

CH 04 · KO
초안 안내: 이 문서는 MoonCAD v1의 레이어 및 객체 특성 관리 목표 사양을 설명합니다.

4.1 레이어의 역할

복잡한 건축 평면도나 기계 부품도에서 외형선, 중심선, 은선, 치수선, 문자를 구분해 다루려면 레이어(Layer)를 사용합니다. 모든 도면은 삭제하거나 이름을 바꿀 수 없는 기본 레이어 0을 포함합니다.

4.2 레이어 상태 및 속성 (LAYER / -LAYER)

레이어 특성 관리자(LAYER) 또는 명령행 -LAYER 명령에서 각 레이어의 다음 속성을 조절합니다.

  • •켜기 / 끄기 (ON / OFF): 끈 레이어의 객체는 화면에 보이지 않지만 도면 범위 계산에는 남습니다.
  • •동결 / 해동 (Freeze / Thaw): 동결된 레이어는 화면 표시와 스냅·재생성 대상에서 모두 제외되어 큰 도면을 다룰 때 속도를 높여줍니다. 현재 작업 중인 레이어는 동결할 수 없습니다.
  • •잠금 / 잠금 해제 (Lock / Unlock): 잠긴 레이어의 객체는 화면에 보이고 스냅 기준점으로 참조할 수 있으나, 실수로 이동·수정·삭제할 수 없도록 보호됩니다.
  • •색상 (Color), 선종류 (Linetype), 선가중치 (Lineweight): 객체 특성을 ByLayer로 두면 소속 레이어의 색상과 선종류(실선 CONTINUOUS, 중심선, 파선 등), 선 굵기를 그대로 따릅니다.

4.3 국내 실무 레이어 구성 예시

새 도면을 시작하거나 AI 코파일럿에게 작도를 지시할 때 다음과 같은 레이어 구성을 활용할 수 있습니다(일반적인 국내 제도 관행 예시이며 특정 국가 표준 인증을 의미하지 않습니다).

  • •건축 도면 예시: A-WALL(벽체), A-DOOR(문), A-WIND(창호), A-FURN(가구/집기), A-DIMS(치수), A-TEXT(실명/주석), A-HATCH(바닥/단면 해치)
  • •기계 도면 예시: OUTLINE(외형선), HIDDEN(은선), CENTER(중심선), DIMS(치수선), TEXT(주서/공차), HATCH(단면 해치)

4.4 특성 일치 복사 (MATCHPROP)

MATCHPROP(단축키 MA) 명령을 실행하고 기준 객체를 먼저 클릭한 뒤 대상 객체들을 선택하면, 기준 객체의 레이어·색상·선종류·선 굵기 특성을 한 번에 복사해 적용할 수 있습니다.

5. 도형 수정 및 기하 편집 명령

CH 05 · KO
초안 안내: 이 문서는 MoonCAD v1의 도형 수정 및 기하 편집 목표 사양을 설명합니다.

5.1 기본 이동 및 변환 (MOVE, COPY, ROTATE, SCALE, MIRROR)

MoonCAD는 명령 실행 전에 미리 객체를 선택하는 방식과 명령 실행 후 선택하는 방식을 모두 지원합니다.

  • •MOVE (M) / COPY (CO, CP): 기준점과 목표점을 찍어 객체를 이동하거나 복제합니다. 두 번째 점에서 Enter를 누르면 첫 점의 좌표를 그대로 이동 변위로 사용합니다.
  • •ROTATE (RO): 기준점을 중심으로 지정한 각도만큼 회전합니다. C(복사) 옵션으로 원본을 남기거나, R(참조각) 옵션으로 현재 각도를 새 목표 각도에 맞출 수 있습니다.
  • •SCALE (SC): 기준점을 중심으로 크기를 배율만큼 확대·축소합니다. R(참조길이) 옵션을 쓰면 현재 길이를 원하는 수치로 맞출 수 있습니다.
  • •MIRROR (MI): 두 점으로 정의한 대칭축을 기준으로 객체를 대칭 복사하며, 마지막 단계에서 원본 삭제 여부를 선택합니다.

5.2 정밀 기하 편집 (OFFSET, TRIM, EXTEND, FILLET, CHAMFER)

  • •OFFSET (O): 선, 호, 원, 폴리선을 지정한 거리만큼 평행하게 띄워 복제합니다. 닫힌 폴리선을 안쪽이나 바깥쪽으로 간격 띄우기할 때 겹치는 모서리 구간은 기하 규칙에 따라 자동 정리됩니다.
  • •TRIM (TR) 및 EXTEND (EX): 교차하는 경계를 기준으로 선이나 곡선의 불필요한 구간을 잘라내거나(TRIM), 경계선까지 연장합니다(EXTEND). 두 명령 모두 실행 중 Shift 키를 누른 채 클릭하면 반대 동작(TRIM 중에는 연장, EXTEND 중에는 자르기)으로 바로 전환됩니다.
  • •FILLET (F) 및 CHAMFER (CHA): 두 선분이나 호의 모서리를 지정한 반지름의 둥근 원호로 연결(FILLET)하거나 비스듬한 직선으로 모따기(CHAMFER)합니다. 두 번째 객체를 선택할 때 Shift 키를 누르고 클릭하면 설정된 반지름이나 거리값을 바꾸지 않고도 뾰족한 직각 모서리로 즉시 맞닿게 정리합니다.

5.3 분할, 결합, 신축 및 배열 (BREAK, JOIN, STRETCH, ARRAY*)

  • •BREAK (BR) / BREAKATPOINT: 객체의 두 점 사이 구간을 잘라내거나, @를 두 번째 점으로 입력해 간격 없이 한 점에서 두 조각으로 나눕니다. 원을 끊을 때는 첫 점에서 두 번째 점까지 반시계 방향 구간이 제거됩니다.
  • •JOIN (J): 일직선 위의 선분들, 중심과 반지름이 같은 원호들, 또는 끝점이 맞닿은 선·호·폴리선들을 하나의 연속된 폴리선이나 원으로 합칩니다.
  • •STRETCH (S): 반드시 걸침 창(오른쪽에서 왼쪽으로 드래그)으로 선택한 정점들만 이동시키고, 창 바깥의 끝점은 고정하여 도형을 늘이거나 줄입니다.
  • •배열 (ARRAYRECT, ARRAYPOLAR, ARRAYPATH): 행·열 간격의 직사각형 격자 배열, 중심점 기준 원형 배열, 곡선 경로를 따라 일정한 간격으로 배치하는 경로 배열을 지원합니다.

6. 3D 솔리드 모델링

CH 06 · KO
초안 안내: 이 문서는 MoonCAD v1의 3D 솔리드 모델링 목표 사양을 설명합니다.

6.1 기본 3D 솔리드 생성

MoonCAD는 별도 백그라운드 작업 공간에서 3D 솔리드 연산을 수행하여 화면 조작이 멈추지 않도록 설계되었습니다.

  • •BOX: 바닥 직사각형의 두 모서리(또는 중심점 C)와 높이(Z)를 지정하여 직육면체를 만듭니다.
  • •CYLINDER 및 CONE: 바닥면 중심점, 반지름(또는 지름 D), 높이를 입력하여 원기둥과 원뿔(또는 상단 반지름을 가진 원뿔대)을 만듭니다.
  • •SPHERE, PYRAMID, WEDGE, TORUS: 구, 각뿔, 쐐기 블록, 원환체(튜브) 기본 솔리드를 작성합니다.

6.2 단면 기반 3D 형상 생성 (EXTRUDE, REVOLVE, SWEEP, LOFT, PRESSPULL)

  • •EXTRUDE (EXT): 닫힌 2D 폴리선, 원, 영역을 지정한 높이만큼 돌출시켜 솔리드를 만듭니다. 구배 각도나 경로(Path) 옵션을 지원합니다.
  • •REVOLVE (REV): 2D 단면 프로파일을 지정한 축 둘레로 회전(기본 360도)시켜 회전체 솔리드를 만듭니다.
  • •SWEEP 및 LOFT: 단면을 2D/3D 경로 곡선을 따라 쓸어내거나(SWEEP), 둘 이상의 단면 프로파일을 순서대로 이어 붙입니다(LOFT).
  • •PRESSPULL: 닫힌 2D 평면 영역 내부나 솔리드 면을 클릭해 밀거나 당겨 부피를 더하거나 뺍니다.

6.3 솔리드 편집과 외부 DWG 솔리드 제한 사항

  • •MoonCAD에서 만든 솔리드 편집: MoonCAD에서 새로 생성한 솔리드는 합집합(UNION), 차집합(SUBTRACT), 교집합(INTERSECT), 평면 절단(SLICE), 모서리 둥글리기(FILLETEDGE) 및 모따기(CHAMFEREDGE)로 편집할 수 있습니다.
  • •DWG에서 가져온 솔리드 안내: 외부 DWG 파일에서 불러온 기존 3D 솔리드는 화면에서 형상을 확인하고 저장할 때 원본 데이터를 그대로 유지할 수 있지만, v1에서는 부울 연산이나 모서리 가공으로 직접 편집할 수 없습니다.
  • •MASSPROP 및 STLOUT: 솔리드의 부피·표면적·경계 상자를 계산(MASSPROP)하고, 3D 프린팅 등에 쓰이는 STL 메쉬 파일로 내보냅니다(STLOUT).

7. AI 코파일럿 활용 가이드

CH 07 · KO
초안 안내: 이 문서는 현재 개발 중인 MoonCAD v1의 AI 코파일럿 목표 사양과 사용법을 설명합니다.

7.1 사람과 같은 명령 엔진으로 작도

MoonCAD의 AI 코파일럿(MOONAI 명령 또는 우측 AI 패널)은 도면 데이터를 임의로 고치는 별도 경로를 쓰지 않습니다. 모든 AI 작도 작업은 사용자가 마우스와 명령행으로 실행하는 것과 똑같은 명령 엔진을 거쳐 수행됩니다.

  • •실시간 반투명 미리보기: AI가 도면을 생성하는 동안 만들어지는 형상은 화면에 반투명 미리보기로 먼저 나타나며, 검사를 통과한 도형부터 차례대로 도면에 반영됩니다.
  • •실행 취소 한 번으로 되돌리기: AI가 한 번의 지시로 수십 개의 벽체, 문, 치수, 레이어를 그렸더라도, AI가 한 번에 그린 내용은 실행 취소 한 번으로 되돌립니다. Ctrl+Z(U) 또는 패널의 실행 취소 버튼으로 한 번에 원래 상태로 되돌릴 수 있습니다.
  • •중단 옵션: 작도 도중 언제든 멈출 수 있으며, 지금까지 그려진 도형을 남길지 아니면 이번 작업을 모두 취소할지 선택할 수 있습니다.

7.2 효과적인 프롬프트 작성 요령

  • •단위와 치수를 함께 적어주세요: "가로 6m, 세로 4m 거실과 그 오른쪽에 붙은 3m × 4m 침실 평면도를 그려줘"처럼 치수를 적어주면 현재 도면 단위(기본 mm)로 자동 환산(6000, 4000)하여 정확한 좌표로 그립니다.
  • •레이어 이름을 함께 지정하세요: "외벽은 A-WALL 레이어에, 폭 900mm 문은 A-DOOR 레이어에, 전체 치수는 A-DIMS 레이어에 넣어줘"처럼 지시하면 기존 레이어를 쓰거나 새 레이어를 만들어 정리합니다.
  • •선택한 객체 활용: 화면에서 벽체나 도형을 먼저 선택한 뒤 "이 벽에 선형 치수를 달아줘"라고 말하면 현재 선택한 객체를 기준으로 작업합니다.

7.3 수동 편집 우선 및 보안 원칙

  • •사람의 수동 편집이 항상 우선: AI가 작업하는 도중에 사용자가 직접 특정 객체를 수정하거나 편집하고 있으면, AI는 그 객체를 덮어쓰지 않고 사용자의 편집 내용을 그대로 보존합니다.
  • •개인 API 키 관리: 사용자가 직접 입력한 개인 API 키는 현재 브라우저 탭 메모리에만 보관되며, 서버에 저장되거나 로그에 남지 않습니다.
  • •도면 내 악성 지시문 방어: 외부 도면 파일 안의 문자(TEXT, MTEXT)에 적힌 내용은 명령으로 실행되지 않으며, 기존 도형을 한꺼번에 지우거나 수정할 때는 먼저 사용자의 확인을 받습니다.

7.4 대화로 도면 제작 (음성)

AI 패널의 대화로 도면 제작 버튼을 누르면 말로 도면을 그릴 수 있습니다. 음성 대화는 Gemini 3.8 Live가 맡고, 실제 도면은 패널에서 선택한 모델이 그립니다.

  • •작업 설명: 그리는 동안 AI가 지금 어느 부분(벽, 문, 치수, 도면층 등)을 작업하는지 말로 계속 알려 줍니다. 화면에는 지금 하는 일과 대화 내용이 함께 표시됩니다.
  • •말로 방향 바꾸기: 작업 도중에 말을 끼워 넣으면 AI가 하던 말을 멈추고 듣습니다. 방향을 바꾸라는 말이면 지금까지 그린 도형은 유지한 채 의견을 반영해 이어서 그립니다. "멈춰"라고 하면 멈추고, "되돌려"라고 하면 이번 작업에서 그린 것을 되돌립니다.
  • •도면 상태는 선택한 모델이 판단: "지금 문이 몇 개야?", "잘 그려졌어?"처럼 도면 상태를 물으면 Gemini가 짐작하지 않고, 선택한 모델이 실제 도면을 읽기 전용으로 확인한 답을 그대로 읽어 줍니다. 이 확인은 도면을 바꿀 수 없습니다. 그리는 중에는 정확한 확인이 어려워 작업이 끝난 뒤에 확인해 드립니다.
  • •그리는 모델의 질문에 말로 답하기: 그리는 모델이 "문을 열린 상태로 그릴까요, 문틈만 남길까요?"처럼 물으면 AI가 질문과 선택지를 소리 내어 읽어 주고, 말로 대답하면 그대로 전달됩니다. 화면의 버튼을 눌러도 되고, 먼저 한 쪽의 답이 적용됩니다. 확인이 필요한 삭제·대량 변경의 승인은 안전을 위해 음성으로 할 수 없고 화면 버튼으로만 합니다.
  • •같은 안전장치: 음성으로 시작한 작업도 글로 시작한 작업과 같은 명령 엔진, 같은 확인 절차, 같은 한 번의 실행 취소를 씁니다. 대화 중에도 패널의 중지 버튼과 직접 편집이 그대로 동작합니다.
  • •20초 동안 말이 없으면 자동 종료: 아무 말도 하지 않은 채 20초가 지나면 AI가 "필요하실 때 대화로 도면 제작 버튼을 다시 눌러 말씀해 주세요"라고 안내하고 대화를 끝내며 마이크도 꺼집니다. AI가 말하는 중이거나 도면을 그리는 중에는 시간을 세지 않습니다. 그리는 모델의 질문에 대한 대답을 기다릴 때는 시간을 세며, 종료돼도 그 질문은 화면 버튼으로 계속 답할 수 있습니다.
  • •준비물: 마이크와 브라우저의 마이크 권한이 필요합니다. 서버에 Gemini 키가 없으면 패널의 음성용 Gemini 키에 내 키를 넣으세요. 스피커보다 이어폰을 쓰면 AI가 자기 목소리를 듣고 끊기는 일이 줄어듭니다.
  • •개인정보: 음성 대화를 시작하면 마이크 소리와 작업 진행 내용이 Google Gemini로 전송됩니다. 자세한 내용은 AI 코파일럿 개인정보 안내를 확인하세요.

8. 파일 열기, 저장 및 내보내기

CH 08 · KO
초안 안내: 이 문서는 MoonCAD v1의 DXF·DWG 파일 처리 및 출력 목표 사양을 설명합니다.

8.1 지원 파일 형식 개요

MoonCAD는 DWG 및 DXF 도면 파일을 읽고 쓸 수 있으며, 작업 중인 도면을 보관하기 위한 로컬 프로젝트 파일(.mcdz)과 문서·3D 출력용 형식(PDF, SVG, STL, STEP)을 v1 목표로 제공합니다.

파일 형식DXF 도면
확장자.dxf
주요 용도 및 특징수정하지 않은 원본 데이터를 그대로 보존하는 표준 텍스트 CAD 형식
파일 형식DWG 도면
확장자.dwg
주요 용도 및 특징이진 CAD 도면 열람 및 저장 (저장 시 변경·생략 내역 리포트 제공)
파일 형식MoonCAD 프로젝트
확장자.mcdz
주요 용도 및 특징로컬 압축 프로젝트 파일 (도면 및 작업 상태 보관)
파일 형식벡터 문서 출력
확장자.pdf, .svg
주요 용도 및 특징정밀 축척(1:1 등) 인쇄 및 문서 공유용 벡터 출력
파일 형식3D 메쉬 / 솔리드 교환
확장자.stl, .step
주요 용도 및 특징3D 솔리드 모델의 메쉬 출력 및 솔리드 형상 교환

8.2 DXF 원본 보존과 DWG 저장 리포트

  • •DXF 파일: 아무것도 수정하지 않은 DXF 파일은 원본 그대로 정확히 보존됩니다. 일부 객체만 수정하고 저장할 때도 수정하지 않은 레코드와 확장 데이터는 원래 내용을 그대로 유지합니다.
  • •DWG 파일: DWG로 저장할 때는 엔진이 아직 해석하지 못하는 일부 비그래픽 데이터나 속성이 빠질 수 있어 무손실이 보장되지 않습니다. 대신 MoonCAD는 저장할 때마다 무엇이 변경되거나 제외되었는지 리포트로 투명하게 알려주며, 손실 없는 보관이 필요할 때는 DXF 사본을 함께 저장할 수 있습니다.
  • •가져온 3D 솔리드: 외부 DWG 도면에서 가져온 3D 솔리드는 화면에서 확인하고 저장할 때 그대로 유지할 수 있으나, v1에서는 직접 편집할 수 없습니다. 구버전(R13–R2000) DWG의 3D 솔리드는 화면에 그려지지 않지만 저장 시 파일 안에 그대로 유지되며 저장 리포트에 개수가 집계됩니다. MoonCAD에서 새로 만든 3D 솔리드는 편집할 수 있습니다.

8.3 타사 프로그램에서 열 때의 파일 서명 안내에 대하여

일부 상용 CAD 프로그램은 자체 제작 소프트웨어가 아닌 외부 프로그램에서 저장된 DWG 파일을 열 때 비공식 소프트웨어 저장 안내 메시지를 표시합니다. 이는 해당 프로그램의 자체 서명 확인 기능에 따른 현상이며, MoonCAD는 타사의 파일 서명을 위조하지 않습니다.

8.4 로컬 자동 복구 및 오프라인 보관

작업 중인 변경 내역은 브라우저 내부 저장소에 실시간으로 기록되어, 브라우저 탭이 예기치 않게 닫히더라도 다시 열 때 마지막 작업 상태를 복구할 수 있도록 설계되었습니다.

9. 알려진 제한 사항 및 v1 범위

CH 09 · KO
초안 안내: MoonCAD는 실제로 동작하는 범위와 제한 사항을 숨기지 않고 안내합니다. 아래는 v1 릴리스의 범위와 제한 사항입니다.

9.1 v1 설계상 제한 사항 요약

항목DWG 저장 시 일부 데이터 손실 가능성
v1 동작 및 제한 이유수정하지 않은 DXF는 그대로 보존되지만, DWG 저장은 엔진이 이해하지 못하는 일부 데이터가 빠질 수 있어 무손실이 보장되지 않습니다.
안내 방식저장할 때마다 변경 및 생략 내역 리포트를 표시합니다.
항목가져온 3D 솔리드 편집
v1 동작 및 제한 이유외부 DWG에서 가져온 3D 솔리드는 화면에서 보고 저장 시 그대로 유지할 수 있으나 v1에서는 편집할 수 없습니다. 구버전(R13–R2000) 솔리드는 화면에 표시되지 않지만 저장 시 파일 안에 유지되고 리포트에 개수가 표시됩니다. MoonCAD에서 만든 3D 솔리드는 편집 가능합니다.
안내 방식편집 시도 시 안내 메시지가 표시되며, 구버전 솔리드 개수는 저장 리포트에 기록됩니다.
항목다중 지시선(MLEADER) 작성 제외
v1 동작 및 제한 이유MLEADER는 텍스트·블록 내용, 여러 개의 지시선, 스타일 테이블 등 독자적인 복합 서브시스템이 필요하여 v1 작성 명령에서 제외되었습니다. 인출선 주석은 LEADER와 QLEADER를 사용하며, 열람한 파일에 이미 있는 MLEADER와 MULTILEADER 객체는 화면에 표시되고 원본에 보존되어 저장 시 그대로 유지됩니다.
안내 방식호환성 현황 페이지 및 명령 설명서에 안내됩니다.
항목그룹(GROUP) 선택 모드
v1 동작 및 제한 이유그룹 정의를 새로 만드는 별도 명령이 v1 범위에 없으므로 선택 프롬프트에서 G(그룹) 입력 시 UNSUPPORTED 안내를 반환합니다. 단, 열람한 파일의 기존 GROUP 객체는 저장 시 그대로 보존됩니다.
안내 방식선택 중 G 입력 시 명령행에 안내됩니다.
항목치수·해치·배열의 자동 연관성
v1 동작 및 제한 이유새로 작성하는 치수, 해치, 배열은 일반 도형으로 생성되며, 객체 이동 시 치수가 자동으로 따라 움직이지 않습니다.
안내 방식호환성 현황 페이지에 부분 지원(partial)으로 표기됩니다.
항목브라우저 탭당 단일 도면
v1 동작 및 제한 이유한 브라우저 탭에서 하나의 도면을 열며 여러 도면은 브라우저 탭으로 구분합니다. FILETAB 명령은 상단 도면 탭 표시줄을 켜고 끕니다.
안내 방식본 설명서에 명시되어 있습니다.
항목공개 배포 환경의 AI 키 입력
v1 동작 및 제한 이유서버 액세스 토큰이 설정되지 않은 공개 배포 환경에서는 사용자가 설정 창에서 본인 API 키를 직접 입력하여 AI 코파일럿을 사용합니다.
안내 방식AI 패널(MOONAI) 설정에 안내됩니다.
항목.mcdz 재열기 시 실행 취소 기록
v1 동작 및 제한 이유파일 크기를 작게 유지하기 위해 .mcdz 파일을 닫았다가 다시 열면 이전 실행 취소 기록은 초기화됩니다.
안내 방식본 설명서에 명시되어 있습니다.
항목그립(점 끌기) 편집 모드
v1 동작 및 제한 이유정점 신축(Stretch)과 이동(Move) 그립을 지원하며, 회전·축척·대칭은 ROTATE, SCALE, MIRROR 명령을 직접 사용합니다.
안내 방식호환성 현황 페이지에 부분 지원(partial)으로 표기됩니다.
항목동적 입력 툴팁
v1 동작 및 제한 이유커서 옆 툴팁은 기본 꺼짐 상태이며, 하단 명령행에서 모든 좌표 입력 문법이 동작합니다.
안내 방식호환성 현황 페이지에 부분 지원(partial)으로 표기됩니다.
항목브라우저 지원 범위
v1 동작 및 제한 이유Chromium 기반 브라우저(Chrome, Edge 등)를 기준으로 전체 검증을 수행하며, Firefox와 Safari는 기본 동작만 점검합니다.
안내 방식호환성 현황 페이지에 안내됩니다.
항목클라우드 계정 및 실시간 공동 편집
v1 동작 및 제한 이유서버 계정, 클라우드 저장소, 다중 사용자 동시 편집은 포함하지 않으며 모든 파일은 사용자의 브라우저에 머무릅니다.
안내 방식별도 로그인 없이 바로 사용합니다.

9.2 후속 버전으로 미룬 기능

다음 기능들은 v1(핵심 명령 148개 목표) 범위 밖으로 분류되어 후속 버전에서 다룹니다.

  • •파라메트릭 구속조건: 기하·치수 구속 솔버는 v1에 포함되지 않습니다.
  • •동적 블록 작성 및 조건 변경: 동적 블록은 현재 저장된 블록 형상으로 화면에 표시됩니다.
  • •데스크톱 전용 플러그인: 데스크톱 전용 매크로 언어 및 외부 이진 플러그인은 브라우저에서 실행되지 않으며, 표준 명령 스크립트(.scr)를 지원합니다.
  • •외부 참조(XREF), 래스터 이미지 부착, 시트 세트, 점구름: v1에서는 참조 누락 상태를 알리고 원본 정보를 유지합니다.

9.3 파일 형식 검증 및 투명한 공개 원칙

MoonCAD는 지원 파일 형식(DWG, DXF, PDF, SVG, STL, STEP)에 대해 독립적인 파일 검사 도구와 기하 검증 테스트를 통과한 결과만을 기준으로 지원 여부를 판단하며, 각 명령과 도형 요소의 통과·부분 지원·미구현 상태를 호환성 현황 페이지에 있는 그대로 공개합니다.

PART II // ENGLISH EDITION

English User Manual

1. Getting Started

CH 01 · EN
Draft Notice: This chapter describes the intended v1 specification of MoonCAD. The editor and commands are currently in development for v1; check the Compatibility page in the top navigation for live verification status.

1.1 Overview of MoonCAD

MoonCAD is a browser-based 2D drafting and 3D solid modeling application. It is designed to let you draft by hand, direct an AI copilot over the same command engine, and open or save DWG and DXF files with no desktop installation.

1.2 Workspace Layout (v1 Goal)

The editor uses a dark engineering drawing-sheet layout organized into four main zones:

  • •Top Toolbar & Document Tabs (RIBBON, FILETAB): Quick-launch icons for core draw, modify, annotation, dimension, and 3D solid commands, plus the document tab bar (v1 opens one drawing per browser tab and FILETAB toggles the tab strip).
  • •Central Drawing Viewport: Infinite 2D and 3D canvas with crosshair cursor, top-right Orientation Cube (NAVVCUBE), and bottom-left Coordinate System Icon (UCSICON).
  • •Side Dock Panels: Toggleable panels for the Layer Manager (LAYER), Entity Properties (PROPERTIES), and the AI Copilot (MOONAI).
  • •Bottom Command Line (COMMANDLINE) & Status Bar: Direct keyboard entry for commands, options, and coordinates, paired with status toggles for snaps, grid, ortho, and polar tracking.

1.3 Mouse and Keyboard Controls

ActionPick coordinate / Select entity
InputLeft mouse click
ActionEnclosing Window selection
InputDrag left-to-right (selects entities completely inside box)
ActionCrossing Window selection
InputDrag right-to-left (selects entities inside or touching box)
ActionPan view (PAN)
InputMiddle mouse wheel drag
ActionZoom view (ZOOM)
InputScroll mouse wheel (centered at cursor)
ActionZoom to Extents
InputDouble-click middle mouse wheel or type ZOOM → E
Action3D Orbit (3DORBIT)
InputShift + middle mouse drag, or run 3DORBIT
ActionRepeat last command
InputPress Enter or Space at the idle Command prompt
ActionCancel command / Deselect all
InputPress Esc

1.4 Physical Key Recognition Under Korean IME

To prevent accidental Hangul input when typing command aliases, the command bar reads physical key positions (or maps Hangul characters back to QWERTY) whenever a prompt expects a command name, alias, or keyword option rather than free text content. Typing ㅣ (L) or ㅅㄱ (TR) under a Korean IME immediately runs LINE or TRIM.

2. Drawing Basics

CH 02 · EN
Draft Notice: This chapter describes the intended v1 specification of MoonCAD. Live verification status for each command appears on the Compatibility page.

2.1 Lines, Polylines, and Polygons

  • •LINE (L): Pick a start point and consecutive endpoints to create individual line segments. Enter U to undo the last segment, or C after two or more segments to close back to the start point. Pressing Enter at the first prompt continues from the endpoint of the most recently drawn line or arc.
  • •PLINE (PL): Creates a connected 2D polyline composed of straight and circular arc segments. Switch between Arc (A) and Line modes mid-command, or set segment Width (W) and Halfwidth (H).
  • •RECTANG (REC): Pick two opposite corners or use Dimensions (D), Area (A), or Rotation (R) to construct a closed rectangular polyline, with optional Fillet (F) or Chamfer (C) corners.
  • •POLYGON (POL): Generates an equilateral closed polygon with 3 to 1,024 sides, inscribed in (I) or circumscribed about (C) a reference circle, or defined by one edge (E).

2.2 Circles, Arcs, Ellipses, and Splines

  • •CIRCLE (C): Construct circles by center + radius (or Diameter D), 3 points on the circumference (3P), 2 diameter endpoints (2P), or tangent to two objects with a given radius (Ttr).
  • •ARC (A): Draw circular arcs via 3 points, start–center–end, or center–start–end combinations.
  • •ELLIPSE (EL): Define an ellipse by the two endpoints of its first axis and the half-length of its second axis, or start from Center (C).
  • •SPLINE (SPL): Create smooth curves passing through fit points or guided by control vertices (Method).
  • •XLINE (XL) & RAY: Place infinite construction lines (Hor, Ver, Ang, Bisect, Offset) or semi-infinite rays for layout projection.

2.3 Hatches, Text, and Dimensions

  • •HATCH (H): Fill enclosed regions with patterns (SOLID, ANSI31, etc.) by clicking an internal point or selecting bounding entities.
  • •TEXT (DT) & MTEXT (T, MT): Add single-line annotations or formatted multiline text frames with full Unicode and legacy Korean encoding support.
  • •Dimensions (DIMLINEAR, DIMALIGNED, DIMANGULAR, DIMRADIUS, DIMDIAMETER, DIMBASELINE, DIMCONTINUE): Annotate horizontal/vertical distances, aligned lengths, angles, radii, and diameters formatted by the active DIMSTYLE.

3. Coordinate Input and Snaps

CH 03 · EN
Draft Notice: This chapter documents the coordinate input grammar and object snap behavior targeted by MoonCAD v1.

3.1 Coordinate Entry Formats

At the command line, Space acts as Enter (ending a token), so measured coordinates are typed without spaces.

FormatAbsolute Cartesian
Example100,200 or 100,200,50
MeaningExact X, Y, (Z) in the active User Coordinate System (UCS)
FormatRelative Cartesian
Example@150,-50 or @0,0,25
MeaningOffset relative to the last point (@ alone repeats @0,0,0)
FormatPolar (distance<angle)
Example200<45 or @120<135
MeaningDistance and angle in the XY plane (degrees, CCW by default)
FormatCylindrical
Example@100<30,50
MeaningPolar radius and angle in XY plus Z height
FormatSpherical
Example@100<45<30
Meaning3D distance, XY plane angle, and elevation angle from XY
FormatExplicit WCS (*)
Example*0,0,0 or @*50,0
MeaningForces World Coordinate System regardless of active UCS
FormatDirect Distance
ExampleMove cursor, type 250
MeaningPlaces the point at distance 250 along the guide line direction
FormatAngle Override
Example<30
MeaningLocks cursor movement along 30° for the next point

3.2 Point Filters and Modifiers

  • •Coordinate Filters (.x, .y, .z, .xy, .xz, .yz): Combine coordinates from separate picks—for example, type .x and snap to one endpoint to capture its X value, then pick another point to supply YZ.
  • •from: Pick a temporary reference base point first, then enter a relative offset (such as @50,30) from that base.
  • •mtp / m2p: Computes the exact midpoint between any two picked points without drawing construction lines.
  • •tk / tracking: Step through a sequence of orthogonal temporary tracking points and press Enter to commit the final point.

3.3 Object Snaps (OSNAP) and Function Keys

Toggle running object snaps with F3, or type a snap keyword at any point prompt to override for a single pick:

  • •Snap Tokens: END (Endpoint), MID (Midpoint), CEN (Center), GCE (Geometric Center), NOD (Point Node), QUA (Quadrant), INT (Intersection), EXT (Extension), INS (Insertion), PER (Perpendicular), TAN (Tangent), NEA (Nearest), NON (Suppress snaps for this point).
  • •Function Keys: F3 (Object Snap), F7 (Grid), F8 (Ortho Lock), F9 (Increment Snap), F10 (Polar Tracking—mutually exclusive with F8), F11 (Object Snap Tracking), F12 (Dynamic Input).

4. Layers and Object Properties

CH 04 · EN
Draft Notice: This chapter describes the layer table and property management features targeted for MoonCAD v1.

4.1 Organizing Drawings with Layers

Layers separate wall outlines, centerlines, hidden edges, dimensions, and notes so you can control visibility, color, linetype, and lineweight across complex drawings. Every drawing starts with layer 0, which cannot be deleted or renamed.

4.2 Layer States and Attributes (LAYER / -LAYER)

Use the Layer Properties Manager (LAYER) or the command-line -LAYER command to control:

  • •Visible (ON / OFF): Entities on turned-off layers are hidden on screen but remain part of drawing bounds.
  • •Frozen (Freeze / Thaw): Frozen layers are excluded from both display and regeneration to keep large drawings responsive. The active layer cannot be frozen.
  • •Locked (Lock / Unlock): Locked layers remain visible and snappable, but their entities cannot be modified or erased.
  • •Color, Linetype, and Lineweight: Leaving entity properties set to ByLayer ensures entities inherit their layer's visual styling automatically.

4.3 Common Layer Naming Conventions

When starting a new drawing or prompting the AI copilot without pre-existing layers, these common naming patterns keep drawings clean (representing general drafting practice, not a formal KS standard claim):

  • •Architectural: A-WALL (walls), A-DOOR (doors), A-WIND (windows), A-FURN (furniture), A-DIMS (dimensions), A-TEXT (labels), A-HATCH (hatching)
  • •Mechanical: OUTLINE (visible edges), HIDDEN (hidden lines), CENTER (centerlines), DIMS (dimensions), TEXT (notes), HATCH (section hatching)

4.4 Matching Properties (MATCHPROP)

Run MATCHPROP (MA), pick a source entity, and then select one or more target entities to copy the source's layer, color, linetype, and lineweight in one step.

5. Modify and Geometric Editing Commands

CH 05 · EN
Draft Notice: This chapter documents the modify and geometric editing commands targeted for MoonCAD v1.

5.1 Transforms (MOVE, COPY, ROTATE, SCALE, MIRROR)

MoonCAD supports both selecting objects before running a command and selecting objects when prompted inside the command.

  • •MOVE (M) & COPY (CO, CP): Translate or duplicate selected entities from a base point to a target point. Pressing Enter at the second point uses the first point as a relative displacement vector.
  • •ROTATE (RO): Rotate entities around a base pivot by an angle in degrees, with options to keep a Copy (C) or align a Reference (R) angle.
  • •SCALE (SC): Resize entities uniformly from a base point by a scale factor or Reference (R) length.
  • •MIRROR (MI): Reflect entities across a two-point axis and optionally erase or retain the source entities.

5.2 Precision Geometric Edits (OFFSET, TRIM, EXTEND, FILLET, CHAMFER)

  • •OFFSET (O): Create parallel copies of lines, arcs, circles, ellipses, splines, and polylines at a specified distance or through a picked point (Through).
  • •TRIM (TR) & EXTEND (EX): Cut curves back to intersecting cutting edges (TRIM) or project curves forward to boundary edges (EXTEND). Holding Shift while clicking inside either command temporarily flips its mode (TRIM extends; EXTEND trims).
  • •FILLET (F) & CHAMFER (CHA): Connect two curves with a tangent arc of radius R (FILLET) or bevel two straight lines by distances D1, D2 (CHAMFER). Holding Shift on the second pick applies a sharp zero-radius corner without altering the stored radius or chamfer distances.

5.3 Breaking, Joining, Stretching, and Arrays (BREAK, JOIN, STRETCH, ARRAY*)

  • •BREAK (BR) / BREAKATPOINT: Remove a span between two points on an entity, or pass @ (@0,0) as the second point to split an entity cleanly at a single point with zero gap.
  • •JOIN (J): Merge collinear lines, concentric arcs, or contiguous coplanar polylines and arcs into a single curve.
  • •STRETCH (S): Must be selected with a crossing window or crossing polygon (right-to-left drag). Endpoints and vertices inside the crossing box move while exterior vertices stay anchored.
  • •Arrays (ARRAYRECT, ARRAYPOLAR, ARRAYPATH): Distribute copies across a rectangular row/column grid, around a center pivot, or evenly along a path curve.

6. 3D Solid Modeling

CH 06 · EN
Draft Notice: This chapter describes the 3D solid modeling capabilities targeted for MoonCAD v1.

6.1 3D Solid Primitives

MoonCAD runs 3D solid operations in a background worker thread so the viewport stays responsive while modeling.

  • •BOX: Construct a 3D rectangular box from two base corners (or Center C) and a Z height.
  • •CYLINDER & CONE: Specify a base center, radius (or Diameter D), and height (or Top radius for a frustum).
  • •SPHERE, PYRAMID, WEDGE, TORUS: Generate spheres, polygonal pyramids, sloped wedges, and toroidal rings.

6.2 Profile-Based Solid Creation (EXTRUDE, REVOLVE, SWEEP, LOFT, PRESSPULL)

  • •EXTRUDE (EXT): Extrude closed 2D polylines, circles, or planar profiles along +Z or a specified direction vector, path, or taper angle.
  • •REVOLVE (REV): Revolve a 2D profile around an axis line or coordinate axis (X, Y, Z) by a specified angle (default 360°).
  • •SWEEP & LOFT: Sweep a profile along a 2D/3D path curve (SWEEP) or blend across an ordered sequence of cross-section curves (LOFT).
  • •PRESSPULL: Click inside a bounded 2D planar loop or on an existing solid face to add or subtract volume interactively.

6.3 Editing Solids vs. Imported DWG Solids

  • •Solids Created in MoonCAD: Solids created directly in MoonCAD are editable using boolean commands (UNION, SUBTRACT, INTERSECT), planar SLICE, and edge commands (FILLETEDGE, CHAMFEREDGE).
  • •3D Solids Imported from DWG: 3D solids imported from external DWG files can be viewed in the viewport and kept intact when saving, but they are not editable in v1.
  • •MASSPROP & STLOUT: Inspect solid volume, surface area, and bounding box (MASSPROP) or export triangle .stl meshes (STLOUT).

7. AI Copilot Guide

CH 07 · EN
Draft Notice: This chapter describes the AI copilot workflow currently in development for MoonCAD v1.

7.1 Live Drafting on the Shared Command Engine

The MoonCAD AI copilot (MOONAI command or right-side AI panel) has no private backdoor into the drawing. Every AI drawing action executes through the same command engine used by mouse and keyboard commands.

  • •Translucent Previews: While the AI generates geometry, upcoming shapes appear on a translucent preview layer first, and validated elements are added to the drawing progressively.
  • •One Undo Step per Turn: Even if an AI turn creates dozens of walls, doors, dimensions, and layers, everything the AI drew in that turn is grouped together. Press Ctrl+Z (U) or click the undo button in the AI panel to undo the entire turn at once.
  • •Stop & Keep or Undo: Cancel an active turn at any time and choose whether to keep the geometry drawn so far or undo the turn completely.

7.2 Tips for Effective Prompts

  • •State Dimensions and Units Clearly: Prompts such as "Draw a 6m by 4m living room with an adjacent 3m by 4m bedroom to the right" automatically convert meters to drawing units (6000 by 4000 in mm) and connect corners cleanly.
  • •Name Target Layers: Specify layers explicitly—e.g., "Put walls on A-WALL, a 900mm door on A-DOOR, and overall dimensions on A-DIMS"—so the copilot reuses or creates structured layers.
  • •Reference Active Selections: Select entities on the canvas first and say "Dimension this wall on layer A-DIMS" to operate directly on your current selection.

7.3 Human Priority and Security Controls

  • •Manual Edits Always Win: If you modify an object by hand or hold it in an active manual edit while the AI is working, your manual changes always take priority.
  • •Personal API Key: You can enter your own API key in the current browser tab memory. Keys are never stored or logged on our server.
  • •Untrusted File Text Protection: Text inside imported drawings (TEXT, MTEXT, block attributes) is treated strictly as data, never instructions. Deleting existing objects or making bulk edits asks for your confirmation first.

7.4 Draw by Talking (Voice)

Press Draw by talking in the AI panel to draw with your voice. Gemini 3.8 Live does the talking and listening. The model you picked in the panel does the drawing.

  • •It explains the work: While it draws, the AI keeps telling you which part it is on: walls, doors, dimensions, layers. The panel shows what it is doing now, and the conversation, as text.
  • •Change course by speaking: Talk at any point and the AI stops to listen. If you are changing direction, what is already drawn stays and the work carries on with your input. Say "stop" to stop, or ask it to undo to take back what this job drew.
  • •The chosen model judges the drawing: If you ask about the state of the drawing, such as "How many doors are there now?" or "Did that come out right?", Gemini does not guess. The model you picked checks the real drawing in read-only mode and Gemini reads out its answer as it is. That check cannot change the drawing. While drawing is under way an exact check is not possible, so it is done once the work ends.
  • •Answer the drawing model's questions by voice: When the drawing model asks something like "Draw the doors open, or leave an empty gap in the wall?", the AI reads the question and the choices aloud, and your spoken answer is passed on. You can also click a button on the panel; whichever answer comes first applies. For safety, approving a deletion or a bulk change cannot be done by voice, only with the panel button.
  • •Same safeguards: Voice jobs use the same command engine, the same confirmations, and the same single undo as typed ones. The panel's stop buttons and your own edits work during a call.
  • •Ends after 20 seconds of silence: The timer pauses while the AI speaks or a drawing job runs. After activity ends, the conversation and microphone stop if you say nothing for 20 seconds. The timer runs while a drawing question awaits your answer, which can still be given using the panel buttons after the call ends.
  • •What you need: A microphone and the browser's microphone permission. If the server has no Gemini key, enter your own under Gemini key for voice. Headphones keep the AI from hearing itself and cutting off.
  • •Privacy: Once a call starts, your microphone audio and progress notes from the drawing are sent to Google Gemini. See the AI copilot privacy notice for details.

8. Opening and Saving Files

CH 08 · EN
Draft Notice: This chapter describes the DXF and DWG file handling and export features targeted for MoonCAD v1.

8.1 Supported File Formats

MoonCAD reads and writes DWG and DXF drawings, alongside local project files (.mcdz) and vector/mesh export formats.

FormatDXF Drawing
Extension.dxf
PurposeStandard text CAD exchange format with exact preservation of untouched records
FormatDWG Drawing
Extension.dwg
PurposeBinary CAD drawing read and write, with a change report on every save
FormatMoonCAD Archive
Extension.mcdz
PurposeCompact local project file
FormatVector Sheet Output
Extension.pdf, .svg
Purpose1:1 or scaled engineering plots with preserved vector text
Format3D Mesh / Solid Exchange
Extension.stl, .step
PurposeTriangle meshes and 3D solid exchange

8.2 Exact Unedited DXF & Honest DWG Save Reports

  • •DXF Files: An untouched DXF file is preserved as-is when saved. When you edit part of a DXF drawing, unmodified records and extended entity data are kept from the original file.
  • •DWG Files: Saving DWG is not guaranteed lossless and can lose data that the engines do not yet understand. Instead of hiding this, MoonCAD reports what changed or was omitted on each save, and lets you save a companion .dxf copy whenever lossless preservation is required.
  • •Imported 3D Solids: 3D solids imported from DWG files can be viewed and kept when saving, though they are not editable in v1. Older R13–R2000 3D solids are kept in the file on save and counted in the report, but are not drawn on screen. Solids created in MoonCAD are editable.

8.3 About File Signature Notices in Other CAD Programs

Some commercial CAD applications display a notice when opening a DWG file that was last saved by software outside their own product family. MoonCAD does not forge third-party file signatures; we write standard geometry records and report every change on save.

8.4 Local Crash Recovery

Active edits are saved to your browser's local storage so interrupted sessions can be recovered locally when you reopen the editor.

9. Known Limits and v1 Scope

CH 09 · EN
Draft Notice: MoonCAD states its v1 scope and limits plainly.

9.1 v1 Scope Limits

AreaDWG save data loss & save report
v1 Behavior & ReasonAn untouched DXF is preserved as-is, whereas saving DWG is not guaranteed lossless and can lose data the engines do not understand.
How It Appears to UsersEvery DWG save shows a report of what changed or was omitted.
AreaEditing imported 3D solids
v1 Behavior & Reason3D solids imported from DWG can be viewed and kept when saving, but are not editable in v1. Older R13–R2000 3D solids are kept in the file on save and counted in the report, though not drawn on screen. Solids created in MoonCAD are editable.
How It Appears to UsersAttempting to edit an imported solid shows a clear notice; R13–R2000 solid counts appear in the save report.
AreaMultileader (MLEADER) creation
v1 Behavior & ReasonMLEADER is not included as a creation command in v1 because multileaders require their own style table, multi-leader landing/dogleg layout, and block/text content subsystem; use LEADER and QLEADER for leader callouts. Existing MLEADER and MULTILEADER entities in opened files still display, stay in the origin records, and come back on save.
How It Appears to UsersStated on the Compatibility page and command reference.
AreaGroup (GROUP) selection mode
v1 Behavior & ReasonSelecting by group (G) at selection prompts answers UNSUPPORTED in v1 because no group-creation command is in v1 scope; existing GROUP objects in opened files are preserved on save.
How It Appears to UsersReported on the command line when G is entered during selection.
AreaAssociativity for dimensions, hatches, and arrays
v1 Behavior & ReasonNewly created dimensions, hatches, and arrays are plain geometry and do not automatically update when adjacent objects move.
How It Appears to UsersListed as partial on DIM*, HATCH, and ARRAY* on the Compatibility page.
AreaOne document per browser tab
v1 Behavior & Reasonv1 opens one drawing per browser tab; use browser tabs for multiple drawings. FILETAB toggles the top document tab strip.
How It Appears to UsersDocumented here in the user manual.
AreaPersonal API key on public deployments
v1 Behavior & ReasonOn public deployments without a server access token, the AI copilot runs with the user's own API key entered in the settings dialog.
How It Appears to UsersShown in the AI panel (MOONAI) settings.
AreaUndo history across .mcdz reopens
v1 Behavior & ReasonUndo history survives crash recovery within a session, but resets after closing and reopening a .mcdz file to keep files small.
How It Appears to UsersDocumented here in the user manual.
AreaGrip editing modes
v1 Behavior & ReasonStretch and Move grip modes are supported; use ROTATE, SCALE, and MIRROR commands for rotation, scaling, and mirroring.
How It Appears to UsersListed as partial on the Compatibility page.
AreaDynamic input tooltip
v1 Behavior & ReasonThe floating cursor tooltip is off by default; all coordinate entry rules work in the bottom command bar.
How It Appears to UsersListed as partial on the Compatibility page.
AreaBrowser coverage
v1 Behavior & ReasonFull verification runs on Chromium-based browsers; Firefox and Safari receive basic smoke checks.
How It Appears to UsersStated on the Compatibility page.
AreaCloud accounts & real-time collaboration
v1 Behavior & ReasonNo user accounts, cloud storage, or multi-user servers; files remain local on your machine.
How It Appears to UsersZero sign-up required.

9.2 Deferred Beyond v1

The following capabilities lie outside the 148 core commands targeted for v1:

  • •Parametric Constraints: Geometric and dimensional constraint solvers are deferred to a later release.
  • •Dynamic Block Authoring & Evaluation: Dynamic blocks display their stored block representation.
  • •Desktop Plugin Runtimes: Desktop-only macro languages and binary plugins do not run in the browser; standard .scr command scripts are supported.
  • •External References (XREF), Raster Images, Sheet Sets, Point Clouds: v1 reports missing references and keeps underlying records where supported.

9.3 Format Verification & Public Compatibility Page

MoonCAD checks supported file formats (DWG, DXF, PDF, SVG, STL, STEP) with independent file readers and geometry checkers, and publishes the pass, partial, or absent status of each command and entity type on the Compatibility page.