# ポイントクラウドのキューブ注釈

3D点群で直方体にラベルを付ける方法は3つあります - *マジックセレクト（ラッソ）*, *ワンクリック注釈* そして *クリックして配置*。ユースケースによっては、他よりも一つの方法が最適な場合があります。以下でそれぞれについて説明します。

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2FCLQKa9zlh5Aj4W0vWAAZ%2FScreenshot%20from%202023-08-19%2012-45-58.png?alt=media&#x26;token=94c0ebbd-b8ab-4d77-ba1e-424da68f7889" alt=""><figcaption><p>描画直方体ツールとその下のラベルセクション</p></figcaption></figure>

### ワンクリック注釈

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2F1y2YgHWiU4LU7XApswqL%2FScreenshot%20from%202023-08-19%2012-41-41.png?alt=media&#x26;token=658a2822-bfbe-4044-9918-f431efa261c9" alt=""><figcaption><p>Draw cuboidツールが選択されていると、ポイントの上をマウスで移動すると小さな黄色い円が表示されます。</p></figcaption></figure>

この方法では、ワンクリックでオブジェクトにラベルを付けることができます！使用方法：

1. 左側のサイドバーからオブジェクトのラベルを選択します。
2. 左側のサイドバーからDraw cuboidツールを選択します。
3. 点群上でマウスを動かすと、ポイントにカーソルを合わせたときに小さな黄色い円が表示されるはずです。
4. オブジェクトに属する点を見つけ、誤って *オブジェクトの後ろの* 点を選択しないようにしてください。
5. キーボードの `ctrl` キーを押しながらその点をクリックします。
6. 直方体が描画されるはずです。

この方法は、クラスタリングを使用してオブジェクトの形状を推定するため、オブジェクトの多くの点が可視である場合に最もよく機能します。オブジェクトが非常にまばらな場合は、他の方法がより適しています。

### マジックセレクト

ワンクリック注釈は、 *クラスタリング* と呼ばれる手法を使用して機能します。

1. 左側のサイドバーからオブジェクトのラベルを選択します。
2. 左側のサイドバーからDraw cuboidツールを選択します。
3. オブジェクトの点が離れている場合など、これが機能しないことがあります。そのような場合は、マジックセレクトツールを使って直方体を描くことができます。手順は次のとおりです： *右クリックを押したまま大まかな輪郭を少し* 点を選択しないようにしてください。
4. 内側に

### 描きます。直方体が描画されるはずです

クリックして配置 `上記の2つの方法のどちらもあまりうまくいかない場合は、点群の任意の場所に指定した寸法の直方体を配置することもできます。これを行うには、単に` Shift

を押しながら点群の任意の場所をクリックします。 `オブジェクトがほぼ同じ大きさであると予想される場合（たとえば倉庫内の箱にラベルを付ける場合など）、ラベルオントロジーの設定時にデフォルト寸法を指定できます。これらの参照サイズが設定されていると、そのラベルのすべての直方体は同じ参照サイズで描画されます。サイズが設定されていない場合は、デフォルトサイズの` 1m x 1m x 1m&#x20;

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2FCac4k5klMYr7o52tBqMp%2Flidar_ontology_label.png?alt=media&#x26;token=5c788a9e-450c-46cb-83ff-bb8ec4599732" alt=""><figcaption></figcaption></figure>

### が使用されます。

直方体の編集

#### **一度描画すると、直方体を編集するためのいくつかのオプションがあります**

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2Foit8qhQCtyQyYhocUaPI%2FScreenshot%20from%202023-08-19%2012-43-59.png?alt=media&#x26;token=ae1fbfcd-0fec-487b-aca9-05b8467d941e" alt=""><figcaption><p>上/側面/正面ビューを使用する</p></figcaption></figure>

オブジェクトの上面、側面、正面ビュー。各平面の角をドラッグして直方体を編集できます。

####

#### **オブジェクトを選択すると、その上面、側面、正面ビューが下部に表示されます。これらの平面の角をクリックしてドラッグすることで直方体の寸法を変更できます。これは描画済みの直方体を更新する最も簡単な方法です**

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2FY8uqq6R1TXBovxDjQyM4%2FScreenshot%20from%202023-08-19%2012-42-26.png?alt=media&#x26;token=a0712d64-00b5-4c22-9f46-c7e01af0db01" alt=""><figcaption><p>リサイズパネルを使用する</p></figcaption></figure>

オブジェクトを選択すると、リサイズパネルが点群の上に表示されます。これを使って直方体のサイズ変更、回転、および移動ができます。

**ステップサイズ**\
時には非常に大きな変更や非常に精密な変更を行いたい場合があります。各セクションの右側にあるテキストボックスを使用して、ボタン押下ごとのステップサイズを変更できます。小さい値に設定すると精密な変更がしやすくなります。ステップサイズを大きくすると、大きな変更を素早く行えます。

**直方体サイズのセクション**\
パネルの最初の2行は直方体の長さ、幅、高さを更新するためのものです。直方体の6つの面それぞれに対して6セットの `+/-` ボタンがあります。例えば、最初の列の第2行にあるボタンのセットは、直方体の底面を指します。

**回転セクション**\
3行目では、直方体をX、Y、Z軸で反時計回り（ `+` ボタン）および時計回り（ `-` ボタン）方向に回転させることができます。任意の時点でリセットボタンをクリックすると、すべての回転がリセットされ、直方体はすべての軸で0°に戻ります。デフォルトのステップサイズは2°です—つまりボタンを一度押すごとに直方体は2°回転します。ステップサイズはテキストボックスに新しい値を入力して変更できます。

**平行移動セクション**\
このセクションでは直方体をX、Y、Z軸に沿って移動できます。

### 前面をマークする

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2Fy7KOu9yodIWMGAkH0M7k%2Fimage.png?alt=media&#x26;token=54f08fc2-a73f-4376-b252-b31df77ea5e4" alt=""><figcaption><p>Forward faceセクションのボタンを使ってオブジェクトの面を変更します</p></figcaption></figure>

直方体の前面（側面）をマークするには、リサイズパネルのForward faceセクションを使用します。一度マークされると、前面がハイライトされます。

#### キーボードショートカットの使用

上で述べたすべての操作は、便利なキーボードショートカットでも実行できます。利用可能なショートカットの一覧は、画像に示されているように上部のショートカットアイコンをクリックすると表示できます。すべてのショートカットの一覧も表示できます [ここ](https://docs.mindkosh.com/ja/3dpointokuraudo/kbdoshtokatto).<br>

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2FKPSX4U0HGTfOlOrOyNMR%2FScreenshot%20from%202023-08-19%2013-58-18.png?alt=media&#x26;token=93e66787-503c-4c85-9d17-536c2c101266" alt=""><figcaption><p>キーボードショートカットアイコン</p></figcaption></figure>
