OGRE 3D Visualiser

Classes
class	cv::ovis::WindowScene

Enumerations
enum	cv::ovis::EntityProperty {   cv::ovis::ENTITY_MATERIAL,   cv::ovis::ENTITY_SCALE,   cv::ovis::ENTITY_AABB_WORLD }
enum	cv::ovis::MaterialProperty {   cv::ovis::MATERIAL_POINT_SIZE,   cv::ovis::MATERIAL_LINE_WIDTH,   cv::ovis::MATERIAL_OPACITY,   cv::ovis::MATERIAL_EMISSIVE,   cv::ovis::MATERIAL_TEXTURE0,   cv::ovis::MATERIAL_TEXTURE = MATERIAL_TEXTURE0,   cv::ovis::MATERIAL_TEXTURE1,   cv::ovis::MATERIAL_TEXTURE2,   cv::ovis::MATERIAL_TEXTURE3 }
enum	cv::ovis::SceneSettings {   cv::ovis::SCENE_SEPERATE = 1,   cv::ovis::SCENE_INTERACTIVE = 2,   cv::ovis::SCENE_SHOW_CS_CROSS = 4,   cv::ovis::SCENE_AA = 8 }

Functions
void	cv::ovis::addResourceLocation (const String &path)
void	cv::ovis::createGridMesh (const String &name, const Size2f &size, const Size &segments=Size(1, 1))
void	cv::ovis::createPlaneMesh (const String &name, const Size2f &size, InputArray image=noArray())
void	cv::ovis::createPointCloudMesh (const String &name, InputArray vertices, InputArray colors=noArray())
Ptr< WindowScene >	cv::ovis::createWindow (const String &title, const Size &size, int flags=SCENE_INTERACTIVE|SCENE_AA)
void	cv::ovis::setMaterialProperty (const String &name, int prop, const Scalar &value)
void	cv::ovis::setMaterialProperty (const String &name, int prop, const String &value)
void	cv::ovis::setMaterialProperty (const String &name, const String &prop, const Scalar &value)
void	cv::ovis::updateTexture (const String &name, InputArray image)
int	cv::ovis::waitKey (int delay=0)

Detailed Description

Enumeration Type Documentation

enum cv::ovis::EntityProperty

Enumerator
ENTITY_MATERIAL
ENTITY_SCALE
ENTITY_AABB_WORLD

enum cv::ovis::MaterialProperty

Enumerator
MATERIAL_POINT_SIZE
MATERIAL_LINE_WIDTH
MATERIAL_OPACITY
MATERIAL_EMISSIVE
MATERIAL_TEXTURE0
MATERIAL_TEXTURE
MATERIAL_TEXTURE1
MATERIAL_TEXTURE2
MATERIAL_TEXTURE3

enum cv::ovis::SceneSettings

Enumerator
SCENE_SEPERATE	the window will use a seperate scene. The scene will be shared otherwise.
SCENE_INTERACTIVE	allow the user to control the camera.
SCENE_SHOW_CS_CROSS	draw coordinate system crosses for debugging
SCENE_AA	Apply anti-aliasing. The first window determines the setting for all windows.

Function Documentation

void cv::ovis::addResourceLocation

(

const String &

path

)

Add an additional resource location that is search for meshes, textures and materials

must be called before the first createWindow. If give path does not exist, retries inside Ogre Media Directory.

Parameters

path	folder or Zip archive.

void cv::ovis::createGridMesh	(	const String &	name,
		const Size2f &	size,
		const Size &	segments = Size(1, 1)
	)

creates a grid

creates a material with the same name

Parameters

name	name of the mesh
size	extents of the grid
segments	number of segments per side

void cv::ovis::createPlaneMesh	(	const String &	name,
		const Size2f &	size,
		InputArray	image = noArray()
	)

create a 2D plane, X right, Y down, Z up

creates a material and a texture with the same name

Parameters

name	name of the mesh
size	size in world units
image	optional texture

void cv::ovis::createPointCloudMesh	(	const String &	name,
		InputArray	vertices,
		InputArray	colors = noArray()
	)

creates a point cloud mesh

creates a material with the same name

Parameters

name	name of the mesh
vertices	float vector of positions
colors	uchar vector of colors

Ptr<WindowScene> cv::ovis::createWindow	(	const String &	title,
		const Size &	size,
		int	flags = SCENE_INTERACTIVE|SCENE_AA
	)

create a new rendering window/ viewport

Parameters

title	window title
size	size of the window
flags	a combination of SceneSettings

Furthermore, the behavior is controlled by the following environment variables

• OPENCV_OVIS_VERBOSE_LOG: print all of OGRE log output
• OPENCV_OVIS_RENDERSYSTEM: the name of the OGRE RenderSystem to use
• OPENCV_OVIS_NOVSYNC: disable VSYNC for all windows

void cv::ovis::setMaterialProperty	(	const String &	name,
		int	prop,
		const Scalar &	value
	)

set the property of a material to the given value

Parameters

name	material name
prop	MaterialProperty
value	the value

void cv::ovis::setMaterialProperty	(	const String &	name,
		int	prop,
		const String &	value
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void cv::ovis::setMaterialProperty	(	const String &	name,
		const String &	prop,
		const Scalar &	value
	)

set the shader property of a material to the given value

Parameters

name	material name
prop	property name
value	the value

void cv::ovis::updateTexture	(	const String &	name,
		InputArray	image
	)

updates an existing texture

A new texture can be created with createPlaneMesh

Parameters

name	name of the texture
image	the image data

int cv::ovis::waitKey

(

int

delay = 0

)

update all windows and wait for keyboard event

Parameters

delay

0 is the special value that means "forever". Any positive number returns after sync to blank (typically 16ms).

Returns

the code of the pressed key or -1 if no key was pressed