﻿ Mapping / Tiling / Rotation
 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