Mapping / Tiling / Rotation

   Print  Previous  Next

Overview

MADRIX provides advanced mapping functionality, including mapping, tiling, and rotation.
The following functions are available for the MAS Script Effect as well as Macros for Effects for usage in MADRIX Script.
The Storage Place Macro provides its own functions. Learn more: »Storage Place Macro: Functions

 

Functions

Function

Description

MAS Script

Macros for Effects

Storage Place Macro

Main Output Macro

int MapDlgIsMapped()

Retrieves if the Layer is mapped.

+

+

 

 

void MapDlgGetMapVector(float map[])

Retrieves the map settings for the Layer using relative values. The values are saved in a array (map[]).

 

map[0] = X-coordinate (Position X)
map[1] = Y-coordinate (Position Y)
map[2] = width (Size X)
map[3] = height (Size Y)

+

+

 

 

void MapDlgSetMapVector(float x, float y, float w, float h)

Maps the Layer to a certain area of the matrix using relative values. x and y describe the coordinates. w and h describe width and height, respectively.

+

+

 

 

void MapDlgGetMapVector3D(float map[])

Retrieves the map settings for the Layer in 3D using relative values. The values are saved in an array (map[]).

 

map[0] = X-coordinate (Position X)
map[1] = Y-coordinate (Position Y)
map[2] = Z-coordinate (Position Z)
map[3] = width (Size X)
map[4] = height (Size Y)
map[5] = depth (Size Z)

+

+

 

 

void MapDlgSetMapVector3D(float x, float y, float z, float w, float h, float d)

Maps the Layer to a certain area of the matrix in 3D using relative values. x, y, and z describe the coordinates. w, h, and d describe width, height, and depth.

+

+

 

 

void MapDlgGetMapPixel(int map[])

Retrieves the map settings for the Layer using pixel values. The values are saved in an array (map[]).

 

map[0] = X-coordinate (Position X)
map[1] = Y-coordinate (Position Y)
map[2] = width (Size X)
map[3] = height (Size Y)

+

+

 

 

void MapDlgSetMapPixel(int x, int y, int w, int h)

Maps the Layer to a certain area of the matrix using pixel values. x and y describe the coordinates. w and h describe width and height, respectively.

+

+

 

 

void MapDlgGetMapPixel3D(int map[])

Retrieves the map settings for the Layer in 3D using pixel values. The values are saved in an array (map[]).

 

map[0] = X-coordinate (Position X)
map[1] = Y-coordinate (Position Y)
map[2] = Z-coordinate (Position Z)
map[3] = width (Size X)
map[4] = height (Size Y)
map[5] = depth (Size Z)

+

+

 

 

void MapDlgSetMapPixel3D(int x, int y, int z, int w, int h, int d)

Maps the Layer to a certain area of the matrix in 3D using pixel values. x, y, and z describe the coordinates. w, h, and d describe width, height, and depth.

+

+

 

 

int MapDlgGetMapMode()

Retrieves the currently used Map Mirror Mode of the Layer. See below for a list of constants.

+

+

 

 

void MapDlgSetMapMode(int mode)

Sets the Map Mirror Mode for the Layer. See below for a list of constants.

+

+

 

 

void MapDlgGetTileVector(float tile[])

Retrieves the Tiling settings for the Layer using relative values. The values are saved in an array (tile[]).

 

tile[0] = X-coordinate (Position X)
tile[1] = Y-coordinate (Position Y)
tile[2] = width (Size X)
tile[3] = height (Size Y)

+

+

 

 

void MapDlgSetTileVector(float x, float y, float w, float h)

Tiles the Layer to a certain area of the mapping using relative values. x and y describe the coordinates. w and h describe width and height, respectively.

+

+

 

 

void MapDlgGetTileVector3D(float tile[])

Retrieves the Tiling settings for the Layer in 3D using relative values. The values are saved in an array (tile[]).

 

tile[0] = X-coordinate (Position X)
tile[1] = Y-coordinate (Position Y)
tile[2] = Z-coordinate (Position Z)
tile[3] = width (Size X)
tile[4] = height (Size Y)
tile[5] = depth (Size Z)

+

+

 

 

void MapDlgSetTileVector3D(float x, float y, float z, float w, float h, float d)

Tiles the Layer in a certain area of the mapping in 3D using relative values. Layer indexing (number) starts with 0. x, y, and z describe the coordinates. w, h, and d describe width, height, and depth.

+

+

 

 

void MapDlgGetTilePixel(int tile[])

Retrieves the Tiling settings for the Layer using pixel values. The values are saved in an array (tile[]).

 

tile[0] = X-coordinate (Position X)
tile[1] = Y-coordinate (Position Y)
tile[2] = width (Size X)
tile[3] = height (Size Y)

+

+

 

 

void MapDlgSetTilePixel(int x, int y, int w, int h)

Tiles the Layer in a certain area of the mapping using pixel values. x and y describe the coordinates. w and h describe width and height, respectively.

+

+

 

 

void MapDlgGetTilePixel3D(int tile[])

Retrieves the Tiling settings for the Layer in 3D using pixel values. The values are saved in an array (tile[]).

 

tile[0] = X-coordinate (Position X)
tile[1] = Y-coordinate (Position Y)
tile[2] = Z-coordinate (Position Z)
tile[3] = width (Size X)
tile[4] = height (Size Y)
tile[5] = depth (Size Z)

+

+

 

 

void MapDlgSetTilePixel3D(int x, int y, int z, int w, int h, int d)

Tiles the Layer in a certain area of the mapping using pixel values. x, y and z describe the coordinates. w, h, and d describe width, height, and depth.

+

+

 

 

void MapDlgGetTileOffsetVector(float offset[])

Retrieves the Tiling Offset of the Layer using relative values. The values are saved in an array (offset[]).

 

offset[0] = X-coordinate (Offset X)
offset[1] = Y-coordinate (Offset Y)

+

+

 

 

void MapDlgSetTileOffsetVector(float x, float y)

Sets the Tiling Offset of the Layer using relative values. x describes Offset X, while y represents Offset Y.

+

+

 

 

void MapDlgGetTileOffsetVector3D(float offset[])

Retrieves the Tiling Offset of the Layer in 3D using relative values. The values are saved in an array (offset[]).

 

offset[0] = X-coordinate (Offset X)
offset[1] = Y-coordinate (Offset Y)
offset[2] = Z-coordinate (Offset Z)

+

+

 

 

void MapDlgSetTileOffsetVector3D(float x, float y, float z)

Sets the Tiling Offset of the Layer in 3D using relative values. x describes Offset X, y describes Offset Y, while z represents Offset Z.

+

+

 

 

void MapDlgGetTileOffsetPixel(int offset[])

Retrieves the Tiling Offset of the Layer using pixel values. The values are saved in an array (offset[]).

 

offset[0] = X-coordinate (Offset X)
offset[1] = Y-coordinate (Offset Y)

+

+

 

 

void MapDlgSetTileOffsetPixel(int x, int y)

Sets the Tiling Offset of the Layer using pixel values. x describes Offset X, while y represents Offset Y.

+

+

 

 

void MapDlgGetTileOffsetPixel3D(int offset[])

Retrieves the Tiling Offset of the Layer in 3D using pixel values. The values are saved in an array (offset[]).

 

offset[0] = X-coordinate (Offset X)
offset[1] = Y-coordinate (Offset Y)
offset[2] = Z-coordinate (Offset Z)

+

+

 

 

void MapDlgSetTileOffsetPixel3D(int x, int y, int z)

Sets the Tiling Offset of the Layer in 3D using pixel values. x describes Offset X, y describes Offset Y, while z represents Offset Z.

+

+

 

 

int MapDlgGetTileMode()

Retrieves the currently used Tile Mode of the Layer. See below for a list of Tile Mode constants.

+

+

 

 

void MapDlgSetTileMode(int mode)

Sets the Tile Mode of the Layer. See below for a list of Tile Mode constants.

+

+

 

 

void MapDlgGetRotationVector(float rot[])

Retrieves the Rotation values for axes x, y, and z of the Layer using relative values. The values are saved in an array (rot[]).

 

rot[0] = X-coordinate (X-Axis)
rot[1] = Y-coordinate (Y-Axis)
rot[2] = Z-coordinate (Z-Axis)

+

+

 

 

void MapDlgSetRotationVector(float x, float y, float z)

Sets the Rotation values for axes x, y, and z of the Layer using relative values.

+

+

 

 

void MapDlgGetRotationDegree(int rot[])

Retrieves the Rotation values for axes x, y, and z of the Layer using degree values.The values are saved in an array (rot[]).

 

rot[0] = X-coordinate (X-Axis)
rot[1] = Y-coordinate (Y-Axis)
rot[2] = Z-coordinate (Z-Axis)

+

+

 

 

void MapDlgSetRotationDegree(int x, int y, int z)

Sets the Rotation values for axes x, y, and z of the Layer using degree values.

+

+

 

 

float MapDlgGetRotationXVector()

Retrieves the Rotation for the X-axis of the Layer using relative values.

+

+

 

 

void MapDlgSetRotationXVector(float value)

Sets the Rotation value for the X-axis of the specified Layer using degree values.

+

+

 

 

int MapDlgGetRotationXDegree()

Retrieves the Rotation for the X-axis of the Layer using degree values.

+

+

 

 

void MapDlgSetRotationXDegree(int value)

Sets the Rotation value for the X-axis of the Layer using degree values.

+

+

 

 

int MapDlgGetRotationXMode()

Retrieves the Rotation mode for the X-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

void MapDlgSetRotationXMode(int mode)

Sets the Rotation mode for the X-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

float MapDlgGetRotationYVector()

Retrieves the Rotation for the Y-axis of the Layer using relative values.

+

+

 

 

void MapDlgSetRotationYVector(float value)

Sets the Rotation value for the Y-axis of the Layer using relative values.

+

+

 

 

int MapDlgGetRotationYDegree()

Retrieves the Rotation for the Y-axis of the Layer using degree values.

+

+

 

 

void MapDlgSetRotationYDegree(int value)

Sets the Rotation value for the Y-axis of the Layer using degree values.

+

+

 

 

int MapDlgGetRotationYMode()

Retrieves the Rotation mode for the Y-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

void MapDlgSetRotationYMode(int mode)

Sets the Rotation mode for the Y-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

float MapDlgGetRotationZVector()

Retrieves the Rotation value for the Z-axis of the Layer using relative values.

+

+

 

 

void MapDlgSetRotationZVector(float value)

Sets the Rotation value for the Z-axis of the Layer using relative values.

+

+

 

 

int MapDlgGetRotationZDegree()

Retrieves the Rotation value for the Z-axis of the Layer using degree values.

+

+

 

 

void MapDlgSetRotationZDegree(int value)

Sets the Rotation value for the Z-axis of the Layer using degree values.

+

+

 

 

int MapDlgGetRotationZMode()

Retrieves the Rotation mode for the Z-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

void MapDlgSetRotationZMode(int mode)

Sets the Rotation mode for the Z-axis of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

void MapDlgGetRotationMode(int mode[])

Retrieves the Rotation mode for axes x, y, and z of the Layer. See below for a list of Rotation Mode constants. The values are saved in an array (mode[]).

 

mode[0] = X-coordinate (X-Axis)
mode[1] = Y-coordinate (Y-Axis)
mode[2] = Z-coordinate (Z-Axis)

+

+

 

 

void MapDlgSetRotationMode(int x, int y, int z)

Sets the Rotation Mode for axes x, y, and z of the Layer. See below for a list of Rotation Mode constants.

+

+

 

 

int MapDlgGetAntiAliasing()

Retrieves the Anti-Aliasing mode of the Layer. See below for a list of Anti-Aliasing Mode constants.

+

+

 

 

void MapDlgSetAntiAliasing(int aaLevel)

Sets the Anti-Aliasing mode of the Layer. See below for a list of Anti-Aliasing Mode constants.

+

+

 

 

 

Map Mirror Mode Constants

Constant

Description

int MAP_MIRROR_NONE

Sets no Mirror Mode.

int MAP_MIRROR_H

Mirrors the content of the matrix horizontally.

int MAP_MIRROR_V

Mirrors the content of the matrix vertically.

int MAP_MIRROR_HV

Mirrors the content of the matrix horizontally and vertically.

int MAP_MIRROR_D

Mirrors the content of the matrix in the depth.

int MAP_MIRROR_HD

Mirrors the content of the matrix horizontally and in the depth.

int MAP_MIRROR_VD

Mirrors the content of the matrix vertically and in the depth.

int MAP_MIRROR_HVD

Mirrors the content of the matrix horizontally, vertically, and in the depth.

 

Map Tile Mode Constants

Constant

Description

int MAP_TILE_NONE

Sets no Tile Mode.

int MAP_TILE_REPEAT

Repeats tiles on the mapped matrix.

int MAP_TILE_MIRROR_H

Mirrors tiles horizontally.

int MAP_TILE_MIRROR_V

Mirrors tiles vertically.

int MAP_TILE_MIRROR_HV

Mirrors tiles horizontally and vertically.

int MAP_TILE_MIRROR_D

Mirrors tiles in the depth.

int MAP_TILE_MIRROR_HD

Mirrors tiles horizontally and in the depth.

int MAP_TILE_MIRROR_VD

Mirrors tiles vertically and in the depth.

int MAP_TILE_MIRROR_HVD

Mirrors tiles horizontally, vertically, and in the depth.

 

Map Rotation Mode Constants

Constant

Description

int MAP_ROTATION_FIXED

The rotation value is fixed and not animated.

int MAP_ROTATION_LOOP

The rotation value is used for a looped animation.

 

Map Anti-Aliasing Mode Constants

Constant

Description

int MAP_AA_NONE

Sets no anti-aliasing.

int MAP_AA_2X

Sets simple anti-aliasing (requires some performance).

int MAP_AA_4X

Sets complex anti-aliasing (requires a lot performance).

 

MADRIX Version: 3.6g | Script Version: 2.21
[Ctrl & +/-] = Zoom In/Out | [Ctrl & 0] = 100%
Print   Previous   Next