readRGB

(削除予定) 点群データからの RGB 値の抽出

readRGB は将来のリリースで削除されます。代わりに rosReadRGB を使用してください。詳細については、ROS メッセージ構造体の関数を参照してください。

構文

rgb = readRGB(pcloud)

説明

rgb = readRGB(pcloud) は、PointCloud2 オブジェクト pcloud のすべての点から [r g b] 値を抽出し、n 個の 3 次元点座標からなる n 行 3 列の行列として返します。点群に RGB フィールドが含まれていない場合、この関数はエラーを表示します。点群データの構造を保持する方法については、点群の構造の保持を参照してください。

例

ROS 点群メッセージからの RGB 値の読み取り

ROS 点群メッセージ ptcloud が含まれるサンプル ROS メッセージを読み込みます。

exampleHelperROSLoadMessages

点群から RGB 値を読み取ります。

rgb = readRGB(ptcloud);

入力引数

pcloud — 点群

PointCloud2 オブジェクト ハンドル

点群。'sensor_msgs/PointCloud2' ROS メッセージの PointCloud2 オブジェクト ハンドルとして指定します。

出力引数

rgb — 点群からの RGB 値のリスト

行列

点群からの RGB 値のリスト。行列として返されます。既定では、これは n 行 3 列の行列です。読み取り中の点群オブジェクトで PreserveStructureOnRead プロパティが true に設定されている場合、点は h×w×3 の行列として返されます。詳細については、点群の構造の保持を参照してください。

ヒント

点群データは、1 次元リストまたは 2 次元イメージの形式で整理できます。2 次元イメージ形式は、通常、深さセンサーまたはステレオ カメラから得られます。入力の PointCloud2 オブジェクトには、true または false (既定) のいずれかである PreserveStructureOnRead プロパティが含まれます。このプロパティを true に設定したとします。

pcloud.PreserveStructureOnRead = true;

ここで、任意の読み取り関数 (readXYZ、readRGB、または readField) を呼び出すと、点群の組織的な構造が保持されます。構造を保持する場合、出力行列のサイズは m×n×d になります。ここで m は高さ、n は幅、d は各点の戻り値の数です。それ以外の場合、すべての点は x 行 d 列のリストとして返されます。この構造は、点群がオーガナイズドの場合にのみ保持することができます。

バージョン履歴

R2019b で導入

R2021a: ROS メッセージ構造体の関数

これで、メッセージ オブジェクトのプロパティと一致するフィールドをもつ構造体としてメッセージを作成できます。通常、構造体を利用すると ROS メッセージの作成、更新、使用のパフォーマンスが向上しますが、設定時にメッセージのフィールドが検証されなくなります。メッセージ タイプと、構造体から取得した対応するフィールド値は、ネットワーク経由で送信されたときに検証されます。

メッセージ構造体を入力としてサポートするため、特殊な ROS メッセージに対して動作する新しい関数が導入されました。これらの新しい関数はメッセージ オブジェクトの既存のオブジェクト関数に基づいていますが、メッセージ オブジェクトの代わりに ROS および ROS 2 のメッセージ構造体を入力としてサポートします。

オブジェクト関数は将来のリリースで削除されます。

メッセージ タイプ	オブジェクト関数名	新規関数名
Image CompressedImage	readImage writeImage	rosReadImage rosWriteImage
LaserScan	readCartesian readScanAngles lidarScan plot	rosReadCartesian rosReadScanAngles rosReadLidarScan rosPlot
PointCloud2	apply readXYZ readRGB readAllFieldNames readField scatter3	rosApplyTransform rosReadXYZ rosReadRGB rosReadAllFieldNames rosReadField rosPlot
Quaternion	readQuaternion	rosReadQuaternion
OccupancyGrid	readBinaryOccupanyGrid readOccupancyGrid writeBinaryOccupanyGrid writeOccupanyGrid	rosReadOccupancyGrid rosReadBinaryOccupancyGrid rosReadOccupancyGrid rosWriteBinaryOccupancyGrid rosWriteOccupancyGrid
Octomap	readOccupancyMap3D	rosReadOccupancyMap3D
PointStamped PoseStamped QuaternionStamped Vector3Stamped TransformStamped	apply	rosApplyTransform
すべてのメッセージ	showdetails	rosShowDetails

参考

PointCloud2 | readXYZ | PointCloud2