3D 可视化器

主题
	Widget

详细说明

本节描述了3D可视化窗口以及用于与其交互的类和方法。

3D可视化窗口（参见 Viz3d）用于显示小部件（参见 Widget），并提供了一些方法来与场景和小部件进行交互。

类
类	cv::viz::Camera
	此类封装了相机的内参。 更多...
类	cv::viz::Color
	此类以BGR顺序表示颜色。 更多...
类	cv::viz::KeyboardEvent
	此类表示键盘事件。 更多...
类	cv::viz::Mesh
	此类封装了网格属性，可以从 ply 文件加载网格。 : 更多...
类	cv::viz::MouseEvent
	此类表示鼠标事件。 更多...
类	cv::viz::Viz3d
	Viz3d 类代表一个3D可视化窗口。此类隐式共享。 更多...

函数
void	cv::viz::computeNormals (const Mesh &mesh, OutputArray normals)
Viz3d	cv::viz::getWindowByName (const String &window_name)
	通过其名称检索窗口。
Viz3d	cv::viz::imshow (const String &window_name, InputArray image, const Size &window_size=Size(-1, -1))
	在指定窗口中显示图像。
template<typename _Tp >
bool	cv::viz::isNan (const Point3_< _Tp > &p)
	检查 float/double 值是否为 nan。
template<typename _Tp , int cn>
bool	cv::viz::isNan (const Vec< _Tp, cn > &v)
	检查 float/double 值是否为 nan。
bool	cv::viz::isNan (double x)
	检查 float/double 值是否为 nan。
bool	cv::viz::isNan (float x)
	检查 float/double 值是否为 nan。
Affine3d	cv::viz::makeCameraPose (const Vec3d &position, const Vec3d &focal_point, const Vec3d &y_dir)
	从位置、焦点和向上向量构造相机位姿（有关更多信息，请参阅 gluLookAt()）。
Affine3d	cv::viz::makeTransformToGlobal (const Vec3d &axis_x, const Vec3d &axis_y, const Vec3d &axis_z, const Vec3d &origin=Vec3d::all(0))
	获取坐标系数据并构建到全局坐标系的变换。
Mat	cv::viz::readCloud (const String &file, OutputArray colors=noArray(), OutputArray normals=noArray())
Mesh	cv::viz::readMesh (const String &file)
	读取网格。目前仅支持 ply 格式，且不支持纹理加载。
bool	cv::viz::readPose (const String &file, Affine3d &pose, const String &tag="pose")
	读/写位姿和轨迹。
void	cv::viz::readTrajectory (OutputArray traj, const String &files_format="pose%05d.xml", int start=0, int end=INT_MAX, const String &tag="pose")
void	cv::viz::unregisterAllWindows ()
	从内部数据库注销所有 Viz 窗口。之后，“getWindowByName()”将创建新窗口，而不是从数据库获取现有窗口。
void	cv::viz::writeCloud (const String &file, InputArray cloud, InputArray colors=noArray(), InputArray normals=noArray(), bool binary=false)
	读/写点云。支持的格式：ply、xyz、obj 和 stl（仅读）。
void	cv::viz::writePose (const String &file, const Affine3d &pose, const String &tag="pose")
void	cv::viz::writeTrajectory (InputArray traj, const String &files_format="pose%05d.xml", int start=0, const String &tag="pose")

函数文档 (Function Documentation)

computeNormals()

void cv::viz::computeNormals	(	const Mesh &	mesh,
		OutputArray	normals )

#include <opencv2/viz/vizcore.hpp>

计算网格的法向量

参数

mesh	输入网格。
normals	网格中每个点的法向量，类型为 CV_64FC3。

getWindowByName()

Viz3d cv::viz::getWindowByName

(

const String &

window_name

)

#include <opencv2/viz/vizcore.hpp>

通过其名称检索窗口。

参数

window_name

要检索的窗口名称。

此函数返回一个具有给定名称的 Viz3d 对象。

注意

如果具有该名称的窗口已存在，则返回该窗口。否则，将创建一个具有给定名称的新窗口并返回。

imshow()

Viz3d cv::viz::imshow	(	const String &	window_name,
		InputArray	图像,
		const Size &	window_size = Size(-1, -1) )

#include <opencv2/viz/vizcore.hpp>

在指定窗口中显示图像。

isNan() [1/4]

template<typename _Tp >

bool cv::viz::isNan ( const Point3_< _Tp > & p )

内联

#include <opencv2/viz/vizcore.hpp>

检查 float/double 值是否为 nan。

参数

p	如果点中 任何 元素为 nan，则返回 true。

此函数的调用图

isNan() [2/4]

template<typename _Tp , int cn>

bool cv::viz::isNan ( const Vec< _Tp, cn > & v )

内联

#include <opencv2/viz/vizcore.hpp>

检查 float/double 值是否为 nan。

参数

v	如果向量中 任何 元素为 nan，则返回 true。

此函数的调用图

isNan() [3/4]

bool cv::viz::isNan ( double x )

内联

#include <opencv2/viz/vizcore.hpp>

检查 float/double 值是否为 nan。

参数

x	如果为 nan，则返回 true。

isNan() [4/4]

bool cv::viz::isNan ( float x )

内联

#include <opencv2/viz/vizcore.hpp>

检查 float/double 值是否为 nan。

参数

x	如果为 nan，则返回 true。

makeCameraPose()

Affine3d cv::viz::makeCameraPose	(	const Vec3d &	position,
		const Vec3d &	focal_point,
		const Vec3d &	y_dir )

#include <opencv2/viz/vizcore.hpp>

从位置、焦点和向上向量构造相机位姿（有关更多信息，请参阅 gluLookAt()）。

参数

position	相机在全局坐标系中的位置。
focal_point	相机在全局坐标系中的焦点。
y_dir	相机在全局坐标系中的向上向量。

此函数返回相机在全局坐标系中的位姿。

makeTransformToGlobal()

Affine3d cv::viz::makeTransformToGlobal	(	const Vec3d &	axis_x,
		const Vec3d &	axis_y,
		const Vec3d &	axis_z,
		const Vec3d &	origin = Vec3d::all(0) )

#include <opencv2/viz/vizcore.hpp>

获取坐标系数据并构建到全局坐标系的变换。

参数

axis_x	X 轴向量在全局坐标系中。
axis_y	Y 轴向量在全局坐标系中。
axis_z	Z 轴向量在全局坐标系中。
origin	坐标系的原点在全局坐标系中。

返回

描述全局坐标系与给定坐标系之间变换的仿射变换。返回的变换可以将其坐标系中的点变换到全局坐标系。

readCloud()

Mat cv::viz::readCloud	(	const String &	file,
		OutputArray	colors = noArray(),
		OutputArray	normals = noArray() )

#include <opencv2/viz/vizcore.hpp>

参数

file	带扩展名的文件名。支持的格式：PLY, XYZ, OBJ 和 STL。
colors	仅用于 PLY 和 STL 格式。
normals	仅用于 PLY, OBJ 和 STL 格式。

返回

包含点坐标的 Mat，深度为 CV_32F 或 CV_64F，通道数为 3 或 4，只有 1 行。

readMesh()

Mesh cv::viz::readMesh

(

const String &

file

)

#include <opencv2/viz/vizcore.hpp>

读取网格。目前仅支持 ply 格式，且不支持纹理加载。

readPose()

bool cv::viz::readPose	(	const String &	file,
		Affine3d &	pose,
		const String &	tag = "pose" )

#include <opencv2/viz/vizcore.hpp>

读/写位姿和轨迹。

参数

file	支持 cv::FileStorage 的文件名。
pose	输出矩阵。
tag	文件中的位姿名称。

readTrajectory()

void cv::viz::readTrajectory	(	OutputArray	traj,
		const String &	files_format = "pose%05d.xml",
		int	start = 0,
		int	end = INT_MAX,
		const String &	tag = "pose" )

#include <opencv2/viz/vizcore.hpp>

接受 vector<Affine3<T>>，其中 T = float/double，并从文件序列加载位姿

参数

traj	包含位姿列表的输出数组。可以是 std::vector<cv::Affine3f>, std::vector<cv::Affine3d> cv::Mat
files_format	用于构造文件名的格式说明符字符串。字符串中唯一的占位符应支持 int。
start	files_format 的起始计数器。必须大于或等于 0。
end (结束迭代器)	files_format 的最终计数器。
tag	文件中的矩阵名称。

unregisterAllWindows()

void cv::viz::unregisterAllWindows

(

)

#include <opencv2/viz/vizcore.hpp>

从内部数据库注销所有 Viz 窗口。之后，“getWindowByName()”将创建新窗口，而不是从数据库获取现有窗口。

writeCloud()

void cv::viz::writeCloud	(	const String &	file,
		InputArray	cloud,
		InputArray	colors = noArray(),
		InputArray	normals = noArray(),
		bool	binary = false )

#include <opencv2/viz/vizcore.hpp>

读/写点云。支持的格式：ply、xyz、obj 和 stl（仅读）。

参数

file	带扩展名的文件名。支持的格式：PLY, XYZ 和 OBJ。
cloud	支持的深度：CV_32F 和 CV_64F。支持的通道数：3 和 4。
colors	仅用于 PLY 格式。支持的深度：CV_8U。支持的通道数：1、3 和 4。
normals	仅用于 PLY 和 OBJ 格式。支持的深度：CV_32F 和 CV_64F。支持的通道数：3 和 4。
binary	仅用于 PLY 格式。

writePose()

void cv::viz::writePose	(	const String &	file,
		const Affine3d &	pose,
		const String &	tag = "pose" )

#include <opencv2/viz/vizcore.hpp>

参数

file	文件名。
pose	输入矩阵。
tag	要保存到给定文件中的位姿名称。

writeTrajectory()

void cv::viz::writeTrajectory	(	InputArray	traj,
		const String &	files_format = "pose%05d.xml",
		int	start = 0,
		const String &	tag = "pose" )

#include <opencv2/viz/vizcore.hpp>

接受 vector<Affine3<T>>，其中 T = float/double，并将其写入具有给定文件名格式的文件序列

参数

traj	包含位姿列表的轨迹。可以是 std::vector<cv::Mat>，每个 cv::Mat 的类型为 CV_32F16 或 CV_64FC16 std::vector<cv::Affine3f>, std::vector<cv::Affine3d> 类型为 CV_32FC16 或 CV_64F16 的 cv::Mat
files_format	用于构造文件名的格式说明符字符串。字符串中唯一的占位符应支持 int。
start	files_format 的起始计数器。
tag	文件中的矩阵名称。