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.6j | Script Version: 2.22
[Ctrl & +/-] = Zoom In/Out | [Ctrl & 0] = 100%
Print   Previous   Next