Translate(3)

Translate3

Multiply the current transformation matrix by a translation matrix

Usage

#include <volpack.h>

vpResult

vpTranslate(vpc, tx, ty, tz)

vpContext *vpc;

double *tx, *ty, *tz;

Arguments

vpc

VolPack context from vpCreateContext.

tx

X component of translation vector.

ty

Y component of translation vector.

tz

Z component of translation vector.

Overview

vpTranslate is used to multiply the current transformation matrix by a 4-by-4 translation matrix. The translation matrix is:

1 0 0 tx

0 1 0 ty

0 0 1 tz

0 0 0 1

Use vpCurrentMatrix to set the current transformation matrix. By default, the transformation matrix is post-multiplied (M = M*T where M is the current matrix and T is the translation matrix). The VP_CONCAT_MODE option to vpSeti can be used to select pre-multiplication.

State variables

The current matrix concatenation parameters can be retrieved with the following state variable codes (see vpGeti(3)): VP_CURRENT_MATRIX, VP_CONCAT_MODE.

Errors

The return value is always VP_OK.

Releases

9 releases since Debian 5.0 (Lenny); the text changed 1 time.

  1. 5.0–10
  2. 11–13

From libvolpack1-dev 1.0b3-10 in Debian 13 (Trixie). Parsed by carta from the page's man source.