Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

pcshow

3 次元点群のプロット

説明

pcshow(ptCloud) は、点群オブジェクトに保存されている位置と色を使用して点を表示します。

pcshow(xyzPoints) は、xyzPoints 行列によって指定された点を表示します。

pcshow(xyzPoints,color) は、color によって指定された色を使用して xyzPoints 行列に含まれる点を表示します。

pcshow(xyzPoints,colorMap) は、colorMap によって指定された色を使用して xyzPoints 行列に含まれる点を表示します。

pcshow(filename) は、filename で指定されたファイルに保存された点群を表示します。

pcshow(___,Name,Value) は、前述の構文のいずれかを使用し、Name,Value ペアの引数を 1 つ以上指定したオプションを追加で使用します。

ax = pcshow(___) はプロットの座標軸を返します。

すべて折りたたむ

600 行 600 列の面で構成される球体を生成します。

numFaces = 600;
[x,y,z] = sphere(numFaces);

既定のカラーマップを使用して球体をプロットします。

figure;
pcshow([x(:),y(:),z(:)]);
title('Sphere with Default Color Map');
xlabel('X');
ylabel('Y');
zlabel('Z');

Figure contains an axes object. The axes object with title Sphere with Default Color Map contains an object of type scatter.

テクスチャ マッピングに使用するイメージを読み込み、表示します。

I = im2double(imread('visionteam1.jpg'));
imshow(I);

Figure contains an axes object. The axes object contains an object of type image.

座標をマッピングするためにイメージのサイズを変更して反転します。

J = flipud(imresize(I,size(x)));

色のテクスチャを使用して球体をプロットします。

pcshow([x(:),y(:),z(:)],reshape(J,[],3));
title('Sphere with Color Texture');
xlabel('X');
ylabel('Y');
zlabel('Z');

Figure contains an axes object. The axes object with title Sphere with Color Texture contains an object of type scatter.

入力引数

すべて折りたたむ

点群。pointCloud オブジェクトとして指定します。オブジェクトには、点群をレンダリングする位置、強度、および RGB カラーが含まれます。

点群プロパティ色のレンダリング結果
Location のみ z 値を現在のカラーマップの色値にマッピングします。
Location および Intensity強度を現在のカラーマップの色値にマッピングします。
Location および Color指定された色を使用します。
LocationIntensity および Color指定された色を使用します。

点群のファイル名。文字ベクトルまたは string スカラーとして指定します。このファイルは pcread でサポートされていなければなりません。pcshowpcread を呼び出してファイルから点群を読み取りますが、データを MATLAB® ワークスペースに保存しません。

点群の x、y および z 位置。M 行 3 列または M x N x 3 の数値行列として指定します。xyzPoints 数値行列には、M 個または M x N 個の点 [x,y,z] が含まれます。行列の z 値は、一般的に深度または高度に対応し、各点の色を決定します。入力色 C を指定しない場合、関数は z 値を現在のカラーマップの色にマッピングします。

点群内の点の色。1 行 3 列の RGB ベクトル、M 行 3 列の行列、M x N x 3 の行列、色の省略名、または色の完全名として指定します。カラー値の詳細については、カラー値の表を参照してください。

すべての点に同じ色を指定したり、点ごとに異なる色を指定したりできます。colorsingle または double に設定すると、RGB 値の範囲が [0, 1] になります。coloruint8 に設定すると、値の範囲が [0, 255] になります。

点の入力色の選択C の有効値
xyzPointsすべての点に同じ色を適用

1 行 3 列の RGB ベクトル、またはカラー値の表にリストされている色の名前または省略名。

点ごとに異なる色を適用各点の RGB 値が含まれる M 行 3 列の行列または M x N x 3 の行列。

点群の点の色。次のいずれかとして指定します。

  • M 行 1 列のベクトル

  • M 行 N 列の行列

点の入力色の選択C の有効値
xyzPoints点ごとに異なる色を適用ベクトルまたは M 行 N 列の行列。行列には、現在の colormap の色へ線形にマッピングされた値が含まれていなければなりません。

名前と値の引数

例: 'VerticalAxisDir','Up' は、縦軸の方向を上向きに設定します。

オプションの引数 Name,Value のコンマ区切りペアを指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を、任意の順番で指定できます。

マーカーの直径。正のスカラーとして指定します。値は点のマーカーのおおよその直径を指定します。MATLAB グラフィックスで定義されている単位は点です。マーカーのサイズを 6 より大きくすると、レンダリングのパフォーマンスが低下する可能性があります。

背景色。RGB 3 成分または 16 進数カラー コードとして指定するか、色の完全名または省略名を文字ベクトルとして指定します。

縦軸。'X''Y'、または 'Z' として指定します。保存されている Figure を再度読み込む場合、Figure でいずれかの操作を行うと縦軸が z 軸にリセットされます。

縦軸の方向。'Up' または 'Down' として指定します。保存されている Figure を再度読み込む場合、Figure でいずれかの操作を行うと方向が上方向にリセットされます。

可視化を表示する座標軸。Axes オブジェクトとして指定します。Axes オブジェクトを作成するには、関数 axes を使用します。新しい Figure に可視化を表示するには、'Parent' を未指定のままにします。

出力引数

すべて折りたたむ

プロットの座標軸。axes グラフィックス オブジェクトとして返されます。

点群ビューアーの既定の回転中心を、軸中心または点に対して回転するよう設定できます。Computer Vision Toolbox の基本設定で既定の動作を設定します。

詳細

すべて折りたたむ

カラー値

色の名前省略名RGB 3 成分外観
'red''r'[1 0 0]

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

ヒント

  • マウスをクリックして回転、パン、ズームインまたはズームアウトをするときに、pcshow は、パフォーマンスを向上させるために、レンダリングされた点群を自動的にダウンサンプリングします。マウスのスクロール機能を使用したズームインまたはズームアウトには、ダウンサンプリングが適用されません。データ ヒントを使用する場合、ダウンサンプリングは適用されません。ダウンサンプリングは点群のレンダリングのみを目的として行われ、保存された点には影響しません。

  • 点データを表示するか、色表示値を変更するには、座標軸のツール バーの上にカーソルを置き、次のオプションのいずれかを選択します。

    機能説明
    データヒント

    [データ ヒント] をクリックして、点群 Figure の任意の点のデータ点値を表示します。通常の点群では、[データ ヒント] は x、y、z の値を表示します。深度イメージと LIDAR に対する追加のデータ プロパティは次のとおりです。

    点群データデータ値のプロパティ
    深度イメージ (RGB-D センサー)色、行、列
    LIDAR強度、範囲、方位角、仰角、行、列

    背景色

    [回転] をクリックし、背景オプションのために Figure 内で右クリックします。

    カラーマップ値

    [回転] をクリックし、カラーマップ オプションのために Figure 内で右クリックします。表示される点群のタイプに応じて、利用できる座標と範囲値についてカラーマップ値を変更できます。

    表示

    [回転] をクリックして点群 Figure の表示角を XZ、ZX、YZ、ZY、XY、または YX 平面に変更します。[表示の復元] をクリックして、表示角をリセットします。

  • pcplayer は、Renderer figure プロパティに対してのみ 'opengl' オプションをサポートします。

バージョン履歴

R2015b で導入