> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/guide/enterprise/parametric-library/modular.md).

# 부품 에디터

부품 에디터는 아키스케치 에디터에서 사용 가능한 설계형 부품을 생성, 관리할 수 있는 에디터입니다.

## 부품 에디터 진입

부품 상세 페이지 내 \[부품 에디터에서 확인하기] 버튼을 클릭해 해당 부품을 부품 에디터에서 열 수 있습니다.

<figure><img src="/files/p2uQ9LePeQzJ23Db4MvG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QLhOWndkwBC7BAsERWXA" alt=""><figcaption></figcaption></figure>

## 변수 (파라미터)

* 파라메트릭 부품을 구현하기 위한 변수 유형에는 **1)기본 변수, 2)커스텀 변수, 3)내부 변수** 3가지가 있습니다.
* 변수를 생성할때는 아래 항목을 함께 설정합니다.
  * 변수명 (기능 및 용도 이해를 위한 이름)
  * 참조명 (실제 변수 지칭 시 사용되는 고유한 영어 명칭)
  * 변수 타입 (숫자, 문자, 재질)
  * 자료형 (범위, 옵션, 수식)
* 각 변수 타입과 자료형에 따라 옵션값, 기본값 등의 관련 정보를 입력해야 합니다.

### 기본 변수

* 기본 변수는 부품의 너비(W), 깊이(D), 높이(H)에 해당하는 값을 관리하는 변수입니다.
* W,D,H 버튼을 클릭해 각 변수를 추가할 수 있습니다.
* 추가한 기본 변수는 에디터 및 부품 에디터 (다른 부품)에서 직접 입력하여 값을 변경할 수 있습니다.
* 변수 목록 우측 휴지통 버튼을 클릭해 변수를 삭제할 수 있습니다.

<figure><img src="/files/NBmnfisNuy85Qc07v5i0" alt=""><figcaption></figcaption></figure>

### 커스텀 변수

* 커스텀 변수는 기본 변수 외 에디터에서 수정 가능한 값을 관리하는 변수입니다.
* 섹션 우측 상단 \[+]버튼을 클릭해 커스텀 변수를 추가할 수 있습니다.
* \[+] 버튼 좌측의 파일 모양 버튼을 클릭해 엔터프라이즈 변수를 추가할 수 있습니다.
* 추가한 커스텀 변수는 에디터 및 부품 에디티(다른 부품)에서 직접 입력하여 값을 변경할 수 있습니다.
* 변수 목록 우측 휴지통 버튼을 클릭해 변수를 삭제할 수 있습니다.

<figure><img src="/files/5vjG9tH0GfFx6x6jNhQs" alt=""><figcaption></figcaption></figure>

### 내부 변수

* 내부 변수는 부품 에디터 내부에서 반복적으로 사용되는 값을 관리하는 변수입니다.
* 섹션 우측 상단 \[+]버튼을 클릭해 내부 변수를 추가할 수 있습니다.
* 내부 변수는 에디터 및 부품 에디터(다른 부품)에서 직접 입력하여 값을 변경할 수 없습니다.
* 변수 목록 우측 휴지통 버튼을 클릭해 변수를 삭제할 수 있습니다.

<figure><img src="/files/eUylyf4sCfGnHhp2y8tM" alt=""><figcaption></figcaption></figure>

### 수식 입력

* 부품 에디터 내 숫자를 입력하는 모든 란에서 수식을 활용할 수 있습니다.\
  조건식, 변수를 활용한 변형값 등 자유롭게 입력 가능합니다.
* 입력란 우측에 계산기 버튼을 클릭하면 수식을 더 편하게 입력할 수 있는 수식 편집기로 진입할 수 있습니다.
* 수식 편집기에서는 기본적인 수학 기호 뿐만 아니라, 다양한 고급 수학 함수, 문자열 처리 함수 등을 설명과 예시를 확인하면서 사용할 수 있습니다.
* 입력한 수식은 상단

  ‘전체 계산 결과 미리보기’ 버튼을 통해 계산된 결과값을 미리 볼 수 있습니다.

<figure><img src="/files/02xAn1aZPhtGnrUourNJ" alt=""><figcaption></figcaption></figure>

## 스냅

### 스냅 포인트

* 스냅 포인트는 점을 기준으로 제품과 제품을 에디터에서 스냅으로 연결할 수 있게 해주는 기능입니다.
* 섹션 우측 상단 \[+]버튼을 클릭해 스냅 포인트를 추가할 수 있습니다.
* 에디터에서 스냅은 **1) 매칭 키가 동일하고, 2) 스냅타입이 다를 때** 작동합니다.
* 공유 변수 설정 시 스냅 연결된 다른 제품이 동일한 변수 값을 공유하게 됩니다.
* 자동 배치 설정 시 마감 자동 배치 기능을 사용했을 때 해당 부품이 스냅에 자동 배치됩니다.
* 스냅포인트 목록 우측 휴지통 버튼을 클릭해 스냅 포인트를 삭제할 수 있습니다.
* 스냅 포인트는 고정된 색의 점 형태로 부품 에디터에 위치가 표시됩니다.

<figure><img src="/files/6elBU0opRdDhy93LeRId" alt=""><figcaption></figcaption></figure>

### 스냅 라인

* 스냅 라인은 선을 기준으로 제품과 제품을 에디터에서 스냅으로 연결할 수 있게 해주는 기능입니다.
* 섹션 우측 상단 \[+]버튼을 클릭해 스냅 라인을 추가할 수 있습니다.
* 에디터에서 스냅은 &#x31;**) 매칭 키가 동일하고, 2) 스냅타입이 다를 때** 작동합니다.
* 스냅 라인은 각각 시작점은 시작점끼리, 끝점은 끝점끼리 연결됩니다.
* 공유 변수 설정 시 스냅 연결된 다른 제품이 동일한 변수 값을 공유하게 됩니다.
* 자동 배치 설정 시 마감 자동 배치 기능을 사용했을 때 해당 부품이 스냅에 자동 배치됩니다.
* 스냅포인트 목록 우측 휴지통 버튼을 클릭해 스냅 포인트를 삭제할 수 있습니다.
* 스냅 라인은 고정된 색의 선 형태로 부품 에디터에 위치가 표시됩니다.

<figure><img src="/files/rTcZrfVpHHvDB1mG3zNs" alt=""><figcaption></figcaption></figure>

### 스냅 내보내기&불러오기

* 스냅 내보내기 & 불러오기는 다른 부품의 복잡한 스냅 세팅을 그대로 반영할 수 있는 기능입니다.
* \[스냅 내보내기] 클릭 시 스냅 정보가 json 형태로 클립보드에 복사됩니다.
* 스냅 정보를 복사한 상태로 불러올 부품에서‘스냅 불러오기’를 클릭하면 스냅 정보가 반영됩니다.

<figure><img src="/files/rkTDrC4HsiiihJu5qBlY" alt=""><figcaption></figcaption></figure>

## 제품 유형 설정

* 제품 유형 설정에서 제품의 유형을 선택할 수 있습니다.
* ‘벽에 붙는 제품’의 경우 에디터에서 자동으로 벽에만 배치되도록 설정됩니다.

<figure><img src="/files/vadjRIVzPOoDk7R7ZWnZ" alt=""><figcaption></figcaption></figure>

## 바닥 기준 높이 설정

* 바닥 기준 높이 설정 시 에디터에서 배치할 때 해당 높이만큼 바닥에서 띄워진 채로 배치됩니다.
* 바닥 기준 높이도 변수 사용하여 값 설정이 가능합니다.

<figure><img src="/files/icTWy8t6DQWIfkFqt0g8" alt=""><figcaption></figcaption></figure>

## 바운딩 박스

* 바운딩 박스는 에디터에서 수치로 보여지는 제품의 사이즈 측정 기준을 의미합니다.
* 기본적으로 바운딩 박스는 부품의 최외곽을 감싸는 직육면체를 기준으로 자동 설정되어있습니다.
* 섹션 우측 수정 버튼을 클릭해 수동 바운딩 박스를 설정할 수 있습니다.
* 수동 바운딩 박스 설정 시 눈에 보이는 사이즈와 별도의 사이즈 수치 기준을 설정할 수 있습니다.

<figure><img src="/files/TcR96SOeGJu4BQHfCAeg" alt=""><figcaption></figcaption></figure>

## 부품 라이브러리 탭

1\. 부품 에디터에 가져올 부품들을 부품 라이브러리에서 선택할 수 있습니다.

2\. 부품 라이브러리 탭은 좌측 상단의‘부품 라이브러리’를 클릭하여 진입할 수 있습니다.

3\. 부품 썸네일을 클릭 시 부품 에디터에 선택한 부품이 추가됩니다.

<figure><img src="/files/p3er5yv3OOxRc7RUgieJ" alt=""><figcaption></figcaption></figure>

## 부품 관리

* 부품 썸네일을 **마우스 우클릭**할 시 부품 부가 기능이 노출됩니다.
* **\[부품 자산 수정]** 클릭 시 부품 썸네일을 수정할 수 있습니다.
* **\[부품 다시 제작]** 클릭 시 새로운 부품 에디터 탭에서 해당 부품이 열린다.
* **\[선택한 부품 교체]** 클릭 시 부품 에디터에서 선택한 부품과 해당 부품이 교체됩니다.
* **\[부품 코드 추가]** 버튼 클릭 시 부품 코드 추가 모달이 노출됩니다.
* **\[부품 삭제]** 클릭 시 해당 부품이 부품 라이브러리에서 삭제됩니다.
* **\[상품 생성]** 클릭 시 해당 부품을 참조하는 상품이 생성됩니다.

<figure><img src="/files/lKE79ux0RgaQmWLBXFZi" alt=""><figcaption></figcaption></figure>

## 부품 정보

### 별명, 참조 이름, 참조 컴포넌트

* 별명은 해당 부품 내에서 구성 요소 상태창 내 부품들을 구분하기 위한 별명 기능입니다.
* 참조 이름은 다른 부품에서 해당 기능의 변수값을 불러올 때 지칭하기 위한 이름입니다.
* 참조 컴포넌트는 커스텀 변수에서 추가한 컴포넌트 유형의 의 참조명을 입력하면\
  해당 컴포넌트 유형의 변수 값에 따라 모델링이 변경됩니다.

### 애니메이션

* 도어, 서랍 등 여닫기 모션이 필요한 경우 애니메이션 기능을 통해 세팅할 수 있습니다.
* 상단의 DoorL, DoorR등의 버튼을 클릭해 빠르게 유형 별 애니메이션을 적용할 수 있습니다.

### 파라미터 설정, 위치, 회전

* 파라미터 설정은 해당 부품의 기본 변수 및 커스텀 변수 값을 설정할 수 있는 기능입니다.
* 파라미터 설정에서‘배치 시 선택’을 선택 시 배치 모드에서 해당 파라미터를 변경할 수 있습니다.
* 위치, 회전은 해당 부품의 좌표축을 기준으로의 위치와 회전값을 설정할 수 있는 기능입니다.

### 대칭 반전

* 대칭 반전은 해당 부품을 각 축을 기준으로 반전시킬 수 있는 기능입니다.
* 반전하더라도 위치 기준은 동일한 위치에 고정됩니다.

### 숨김 조건

* 숨김 조건 기능은 해당 부품을 특정 조건에 따라 에디터에서 숨겨지게 하는 기능입니다.
* 변수 값을 기준으로 등식이나 부등식을 통해 조건을 설정할 수 있습니다.

### 두께 (패널)

* 패널 부품에만 노출되며, 패널의 두께를 조절할 수 있습니다.

## 패널

패널은 형태 및 두께를 점 단위로 자유롭게 수정 가능한 객체(부품)입니다.

### 패널 추가

* 부품 라이브러리 탭 > \[패널 생성하기] 버튼 클릭 시 부품 에디터에 직육면체 패널이 생성됩니다.
* 생성된 패널은 패널 형태 편집기로 수정할 수 있습니다.

<figure><img src="/files/5FaFClMOx7g6SSyApxnp" alt=""><figcaption></figcaption></figure>

### 패널 편집 (패널 형태 편집기)

* 패널 선택 후 우측 하단 \[패널 형태 편집기 진입] 버튼을 클릭해 진입할 수 있습니다.
* 패널 형태 편집기에서는 각 패널의 포인트를 기준으로 패널 형태를 편집할 수 있습니다.
* 우측의 \[제거], \[추가] 버튼을 통해 해당 포인트를 제거하거나 새로운 포인트를 추가할 수 있습니다.
* \[Import DXF] 버튼을 클릭하면 2D DXF 파일을 선택해 패널을 불러올 수 있습니다.
* 구멍 추가 시 패널을 관통하는 직사각형 구멍이 생성되며, 구멍 별로 포인트를 관리할 수 있습니다.

<figure><img src="/files/V9dWvE0kEvLLdy0NSRFe" alt=""><figcaption></figcaption></figure>

## 구성 요소 상태창

* 구성 요소 상태창에서 해당 부품에 사용된 자식 부품들을 확인할 수 있습니다.
* 우측 눈 모양 아이콘을 통해 부품을 숨길 수 있습니다. (숨김 상태는 부품 에디터에서만 적용됩니다.)

<figure><img src="/files/H6LgoZtPq5yUC8YuaUfH" alt=""><figcaption></figcaption></figure>

## 부품 관리

### 새 부품 생성

* 헤더의 \[새 부품] 클릭 시 새로운 부품을 생성할 수 있습니다.
* 부품 생성 시 부품 타입을 선택할 수 있습니다.
* \[확인] 버튼 클릭 시 새로운 부품을 편집하는 부품 에디터 화면으로 이동합니다.

<figure><img src="/files/lPRmAJ9BowYuOg8peJy1" alt=""><figcaption></figcaption></figure>

### 덮어쓰기

* 헤더의 \[덮어쓰기] 클릭 시 변경사항을 해당 부품에 적용할 수 있습니다.
* 덮어쓰기를 하지 않고 부품 에디터 이탈 시 변경사항이 소실될 수 있습니다.

<figure><img src="/files/2ZflwkhzyzJ0qid86muK" alt=""><figcaption></figcaption></figure>

### 초기화

* \[초기화] 버튼 클릭 시 현재 작업 사항을 모두 초기화할 수 있습니다.

<figure><img src="/files/t4Ok0uaVXIncAqw2gu7L" alt=""><figcaption></figcaption></figure>

### 저장

* 헤더의 \[저장] 버튼 클릭 시 저장 모달이 노출됩니다.
* 부품명 및 부품 타입을 입력할 수 있습니다.
* 저장할 카테고리를 선택하면 해당 카테고리에 부품을 생성/이동할 수 있습니다.
* \[새로 저장하기] 클릭 시 새로운 부품으로 복제해서 저장됩니다.

<figure><img src="/files/KB24hi8V84W077LZX0qb" alt=""><figcaption></figcaption></figure>
