SoTranslateProcessing Class Reference
[GeometricTransforms]

#include <ImageViz/Engines/GeometryAndMatching/GeometricTransforms/SoTranslateProcessing.h>

Inheritance diagram for SoTranslateProcessing:

Public Types
enum	BackgroundMode { FIXED_BACKGROUND = 0, LOOPED_BACKGROUND = 1 }
Public Member Functions
	SoTranslateProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFImageDataAdapter	inImage
SoSFVec3i32	translationVector
SoSFEnum	backgroundMode
SoSFFloat	backgroundValue
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outImage

Detailed Description

SoTranslateProcessing engine

The SoTranslateProcessing engine re-assigns the position of the image on the grid according to user-defined vectors. During a translation, there are usually two phenomena: part of the image is out of the window, while another part has no values, as illustrated in Figure 1.

Figure 1: Translation of an image

A translation is denoted by a vector $(t_x,t_y,t_z)$ . A pixel M of coordinates $(x,y,z)$ is translated to the new coordinates in the output image as:

$\left\{\begin{matrix}x'&=&t_x+x\\y'&=&t_y+y\\z'&=&t_z+z\end{matrix}$

or using matrix notation:

$\begin{bmatrix}x'\\y'\\z'\end{bmatrix} = \begin{bmatrix}t_x\\t_y\\t_z\end{bmatrix} + \begin{bmatrix}x\\y\\z\end{bmatrix}$

The output image is a discrete space of finite dimension where the new coordinates x, y and z may be outside the image.

NOTE: In 2D mode, z component is neglected.

FILE FORMAT/DEFAULT

computeMode	MODE_AUTO
inImage	NULL
translationVector	100 100 100
backgroundMode	FIXED_BACKGROUND
backgroundValue	0.0f

Library references: translate translate3d

Member Enumeration Documentation

enum SoTranslateProcessing::BackgroundMode

There are two possible modes in a SoTranslateProcessing filter:.

Enumerator:

FIXED_BACKGROUND	The information outside of the image area is lost, and a value is assigned to the otherwise blank area. Figure 2: Translation of an image in FIXED_BACKGROUND mode
LOOPED_BACKGROUND	The image is perceived as a cylinder, where the information outside the image area wraps around and is placed in the blank part. Figure 3: Translation of an image in LOOPED_BACKGROUND mode