> 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/kegaido/parametric-library/modular.md).

# 部品エディタ

パーツエディターは、アーキスケッチエディターで使用可能な設計用パーツを作成・管理できるエディターです。

## パーツエディターに入る

パーツ詳細ページ内の［パーツエディターで確認する］ボタンをクリックすると、該当パーツをパーツエディターで開けます。

<figure><img src="/files/3048190bfb608c07f9521b30b1291c53468c4d91" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/38bcd6adde7fff403d2e5f9fd5cd73617f1fc361" alt=""><figcaption></figcaption></figure>

## 変数（パラメータ）

* パラメトリックパーツを実装するための変数の種類には **1）基本変数、2）カスタム変数、3）内部変数** の3種類があります。
* 変数を作成するときは、以下の項目をあわせて設定します。
  * 変数名（機能と用途を理解するための名前）
  * 参照名（実際に変数を指すときに使われる固有の英語名）
  * 変数タイプ（数値、文字、素材）
  * データ型（範囲、オプション、式）
* 各変数タイプとデータ型に応じて、オプション値や初期値などの関連情報を入力する必要があります。

### 基本変数

* 基本変数は、パーツの幅（W）、奥行き（D）、高さ（H）に該当する値を管理する変数です。
* W、D、Hボタンをクリックして各変数を追加できます。
* 追加した基本変数は、エディターおよびパーツエディター（別のパーツ）で直接入力して値を変更できます。
* 変数一覧の右側にあるゴミ箱ボタンをクリックして変数を削除できます。

<figure><img src="/files/7acd7c37186d34c446644ff8c574a2028df3d4e2" alt=""><figcaption></figcaption></figure>

### カスタム変数

* カスタム変数は、基本変数以外にエディターで修正可能な値を管理する変数です。
* セクション右上の［+］ボタンをクリックしてカスタム変数を追加できます。
* ［+］ボタンの左側にあるファイル形のボタンをクリックして、エンタープライズ変数を追加できます。
* 追加したカスタム変数は、エディターおよびパーツエディター（別のパーツ）で直接入力して値を変更できます。
* 変数一覧の右側にあるゴミ箱ボタンをクリックして変数を削除できます。

<figure><img src="/files/5732ea4c8c0171d2e8b1071f67fbfc797e176a16" alt=""><figcaption></figcaption></figure>

### 内部変数

* 内部変数は、パーツエディター内部で繰り返し使用される値を管理する変数です。
* セクション右上の［+］ボタンをクリックして内部変数を追加できます。
* 内部変数は、エディターおよびパーツエディター（別のパーツ）で直接入力して値を変更することはできません。
* 変数一覧の右側にあるゴミ箱ボタンをクリックして変数を削除できます。

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

### 式の入力

* パーツエディター内の数値を入力するすべての欄で式を活用できます。\
  条件式、変数を活用した変化値などを自由に入力できます。
* 入力欄の右側にある計算機ボタンをクリックすると、式をより簡単に入力できる式エディターに入れます。
* 式エディターでは、基本的な数学記号だけでなく、さまざまな高度な数学関数や文字列処理関数などを、説明や例を確認しながら使用できます。
* 入力した式は上部の

  ［全計算結果プレビュー］ボタンから計算結果をプレビューできます。

<figure><img src="/files/03f67eda5c3c28cc42a665cfa0efa888bc481e1b" alt=""><figcaption></figcaption></figure>

## スナップ

### スナップポイント

* スナップポイントは、点を基準に製品同士をエディターでスナップ接続できるようにする機能です。
* セクション右上の［+］ボタンをクリックしてスナップポイントを追加できます。
* エディターでのスナップは **1）マッチングキーが同じで、2）スナップタイプが異なるとき** に動作します。
* 共有変数を設定すると、スナップ接続された他の製品と同じ変数値を共有するようになります。
* 自動配置設定時に、仕上げの自動配置機能を使用すると、該当パーツがスナップに自動配置されます。
* スナップポイント一覧の右側にあるゴミ箱ボタンをクリックして、スナップポイントを削除できます。
* スナップポイントは、固定色の点としてパーツエディター内に位置が表示されます。

<figure><img src="/files/3fc2a3b51df23f5e4a9b56d821532c2e8c7445f1" alt=""><figcaption></figcaption></figure>

### スナップライン

* スナップラインは、線を基準に製品同士をエディターでスナップ接続できるようにする機能です。
* セクション右上の［+］ボタンをクリックしてスナップラインを追加できます。
* エディターでのスナップは&#x31;**）マッチングキーが同じで、2）スナップタイプが異なるとき** に動作します。
* スナップラインは、それぞれ始点は始点どうし、終点は終点どうしが接続されます。
* 共有変数を設定すると、スナップ接続された他の製品と同じ変数値を共有するようになります。
* 自動配置設定時に、仕上げの自動配置機能を使用すると、該当パーツがスナップに自動配置されます。
* スナップポイント一覧の右側にあるゴミ箱ボタンをクリックして、スナップポイントを削除できます。
* スナップラインは、固定色の線としてパーツエディター内に位置が表示されます。

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

### スナップのエクスポート＆インポート

* スナップのエクスポート＆インポートは、他のパーツの複雑なスナップ設定をそのまま反映できる機能です。
* ［スナップをエクスポート］をクリックすると、スナップ情報がjson形式でクリップボードにコピーされます。
* スナップ情報をコピーした状態で読み込むパーツで［スナップをインポート］をクリックすると、スナップ情報が反映されます。

<figure><img src="/files/73dde192871718c59262dbb9a145b23f89a97fc6" alt=""><figcaption></figcaption></figure>

## 製品タイプ設定

* 製品タイプ設定で製品のタイプを選択できます。
* 「壁に付く製品」の場合、エディターで自動的に壁にのみ配置されるよう設定されます。

<figure><img src="/files/9821afcd49ee01423e99a278744ad11b6ea77f99" alt=""><figcaption></figcaption></figure>

## 床基準高さ設定

* 床基準高さを設定すると、エディターで配置する際にその高さ分だけ床から浮いた状態で配置されます。
* 床基準高さも変数を使用して値を設定できます。

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

## バウンディングボックス

* バウンディングボックスは、エディターで数値として表示される製品サイズの測定基準を意味します。
* 基本的にバウンディングボックスは、パーツの最外郭を囲む直方体を基準に自動設定されています。
* セクション右側の編集ボタンをクリックして、手動バウンディングボックスを設定できます。
* 手動バウンディングボックス設定時は、見た目のサイズとは別のサイズ数値基準を設定できます。

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

## パーツライブラリタブ

1\. パーツエディターに取り込むパーツをパーツライブラリから選択できます。

2\. パーツライブラリタブは、左上の［パーツライブラリ］をクリックして入れます。

3\. パーツのサムネイルをクリックすると、選択したパーツがパーツエディターに追加されます。

<figure><img src="/files/0db5e6b86860d4408de8c302da24a7dc7c5bae61" alt=""><figcaption></figcaption></figure>

## パーツ管理

* パーツのサムネイルを **右クリック**すると、パーツの追加機能が表示されます。
* **［パーツ資産を編集］** をクリックすると、パーツのサムネイルを編集できます。
* **［パーツを再作成］** をクリックすると、新しいパーツエディタータブで該当パーツが開きます。
* **［選択したパーツを置換］** をクリックすると、パーツエディターで選択したパーツと該当パーツが置き換えられます。
* **［パーツコードを追加］** ボタンをクリックすると、パーツコード追加モーダルが表示されます。
* **［パーツ削除］** をクリックすると、該当パーツがパーツライブラリから削除されます。
* **［商品作成］** をクリックすると、該当パーツを参照する商品が作成されます。

<figure><img src="/files/91b3e398e1f8880747637313e80abfe73d28ecd3" alt=""><figcaption></figcaption></figure>

## パーツ情報

### 別名、参照名、参照コンポーネント

* 別名は、該当パーツ内で構成要素の状態ウィンドウ内のパーツを区別するための別名機能です。
* 参照名は、他のパーツで該当機能の変数値を読み込む際に参照するための名前です。
* 参照コンポーネントは、カスタム変数で追加したコンポーネントタイプの参照名を入力すると\
  そのコンポーネントタイプの変数値に応じてモデリングが変更されます。

### アニメーション

* 扉や引き出しなどの開閉モーションが必要な場合は、アニメーション機能で設定できます。
* 上部のDoorL、DoorRなどのボタンをクリックして、タイプ別のアニメーションを素早く適用できます。

### パラメータ設定、位置、回転

* パラメータ設定は、該当パーツの基本変数およびカスタム変数の値を設定できる機能です。
* パラメータ設定で［配置時に選択］を選ぶと、配置モードで該当パラメータを変更できます。
* 位置、回転は、該当パーツの座標軸を基準とした位置と回転値を設定できる機能です。

### 対称反転

* 対称反転は、該当パーツを各軸を基準に反転できる機能です。
* 反転しても、位置基準は同じ位置に固定されます。

### 非表示条件

* 非表示条件機能は、該当パーツを特定の条件に応じてエディターで非表示にする機能です。
* 変数値を基準に、等式や不等式で条件を設定できます。

### 厚さ（パネル）

* パネルパーツにのみ表示され、パネルの厚さを調整できます。

## パネル

パネルは、形状および厚さをポイント単位で自由に修正できるオブジェクト（パーツ）です。

### パネル追加

* パーツライブラリタブ > ［パネル作成］ボタンをクリックすると、パーツエディターに直方体パネルが作成されます。
* 作成されたパネルは、パネル形状エディターで修正できます。

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

### パネル編集（パネル形状エディター）

* パネルを選択後、右下の［パネル形状エディターに入る］ボタンをクリックして入れます。
* パネル形状エディターでは、各パネルのポイントを基準にパネル形状を編集できます。
* 右側の［削除］、［追加］ボタンで、該当ポイントを削除したり新しいポイントを追加したりできます。
* ［Import DXF］ボタンをクリックすると、2D DXFファイルを選択してパネルを読み込めます。
* 穴を追加すると、パネルを貫通する長方形の穴が作成され、穴ごとにポイントを管理できます。

<figure><img src="/files/19d778f218d65499664014a60b5b6fa80650de90" alt=""><figcaption></figcaption></figure>

## 構成要素の状態ウィンドウ

* 構成要素の状態ウィンドウで、該当パーツに使用された子パーツを確認できます。
* 右側の目アイコンでパーツを非表示にできます。（非表示状態はパーツエディターでのみ適用されます。）

<figure><img src="/files/592bfffe72c03c5b95910ffdb8ddd14bc6e77287" alt=""><figcaption></figcaption></figure>

## パーツ管理

### 新規パーツ作成

* ヘッダーの［新規パーツ］をクリックすると、新しいパーツを作成できます。
* パーツ作成時にパーツタイプを選択できます。
* ［確認］ボタンをクリックすると、新しいパーツを編集するパーツエディター画面に移動します。

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

### 上書き

* ヘッダーの［上書き］をクリックすると、変更内容を該当パーツに適用できます。
* 上書きせずにパーツエディターを離れると、変更内容が失われることがあります。

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

### 初期化

* ［初期化］ボタンをクリックすると、現在の作業内容をすべて初期化できます。

<figure><img src="/files/8a5e7e6f4fe3f9fbd895af96f350e5e9051bfecb" alt=""><figcaption></figcaption></figure>

### 保存

* ヘッダーの［保存］ボタンをクリックすると、保存モーダルが表示されます。
* パーツ名およびパーツタイプを入力できます。
* 保存するカテゴリを選択すると、そのカテゴリにパーツを作成／移動できます。
* ［新規保存］をクリックすると、新しいパーツとして複製して保存されます。

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.archisketch.com/guide/kegaido/parametric-library/modular.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
