SCE Image

   Print  Previous  Next

Functions Provided By SCE Image

The following table provides an overview over all functions the effect provides.

This Effect uses Directions. Learn more »Using Direction
This Effect uses Look-At Types. Learn more »Using Look-At Types
This Effect uses the BPM control. Learn more »Using BPM Control
This Effect uses the Color Controls. Learn more »Using Color Controls
This Effect uses the Position Controls. Learn more »Using Position Controls
 
This Effect uses the Image List. Learn more »Using Image Table
 

 Function

Description

void SetExtrusion(float value)

Sets the Extrusion value in percent of the matrix size (depending on the current look-at type).

float GetExtrusion()

Returns the current Extrusion value in percent of the matrix size (depending on the current look-at type).

void SetPixelExtrusion(int value)

Sets the Extrusion value in pixels.

int GetPixelExtrusion()

Returns the current Extrusion value in pixels.

void SetRotation(int angle)

Sets the Rotation globally for all images of the Image List. It is possible to rotate the images by multiples of 90°. This function is equal to the rotation button provided by the GUI of the effect. Valid values for angle are 0, 90, 180, and 270.

int GetRotation()

Returns the currently set Rotation.

void SetTiling(int enable)

Disables Tile Mode if enable is set to FALSE, otherwise the Tile Mode will be enabled via TRUE.

int GetTiling()

Returns TRUE if Tile Mode is enabled, otherwise FALSE.

void ToggleTiling()

Enables Tile Mode or uses the default setting, depending on the current state.

void SetSeamless(int enable)

Disables Seamless if enable is FALSE, otherwise it will be enabled.

int GetSeamless()

Returns TRUE if Seamless is enabled, otherwise FALSE.

void ToggleSeamless()

Enables Seamless or uses the default setting, depending on the current state.

float GetImageWidth()

Returns the image width of the current image in percent of the matrix width.

float GetImageHeight()

Returns the image height of the current image in percent of the matrix height.

float GetImageDepth()

Returns the image depth of the current image in percent of the matrix depth.

int GetImagePixelWidth()

Returns the image width of the current image in pixels.

int GetImagePixelHeight()

Returns the image height of the current image in pixels.

int GetImagePixelDepth()

Returns the image depth of the current imagein pixel.

float GetCurrentPositionX()

Returns the X-position of the current image in percent of the matrix width.

float GetCurrentPositionY()

Returns the Y-position of the current image in percent of the matrix height.

float GetCurrentPositionZ()

Returns the Z-position of the current image in percent of the matrix depth.

int GetCurrentPixelPositionX()

Returns the X-position of the current image in pixels.

int GetCurrentPixelPositionY()

Returns the Y-position of the current image in pixels.

int GetCurrentPixelPositionZ()

Returns the Z-position of the current image in pixels.

void SetPlaybackRate(float value)

Sets the Playback Rate of the image list. E.g., a value of 2.0 means that the image list will be running 2x faster than the original speed.

float GetPlaybackRate()

Returns the current Playback Rate of image list.

void SetCurrentImage(int index)

Sets the specified image, using the index, as the currently displayed image.

int GetCurrentImage()

Return the currently displayed image.

void SetStretchMode(int mode)

Returns the Stretch mode. See below for details.

int GetStretchMode()

Returns the Stretch mode. See below for details.

void SetGrayscale(int enable)

Disables Grayscale if enable is set to FALSE. Otherwise it can be enabled using TRUE.

int GetGrayscale()

Returns TRUE if Grayscale mode is enabled, otherwise FALSE.

void ToggleGrayscale()

Enables Grayscale mode or uses the default setting, depending on the current state.

void SetGreyscale(int enable)

Is the same as SetGrayscale(int enable).

int GetGreyscale()

Is the same as GetGreyscale().

void ToggleGreyscale()

Is the same as ToggleGreyscale().

void SetRgbw(int enable)

Disables the RGB-To-RGBW mode if enable is FALSE. Otherwise it can be enabled using TRUE.

int GetRgbw()

Returns TRUE if RGB-To-RGBW mode is enabled, otherwise FALSE.

void ToggleRgbw()

Enables RGB-To-RGBW mode or uses the default setting, depending on the current state.

void SetFilteringMode(int mode)

Sets the Filtering mode. See below for details.

int GetFilteringMode()

Returns the Filtering mode. See below for details.

 

Stretch Mode Constants

Value

Description

int STRETCH_MODE_NONE

Sets the stretch mode to None (no stretching).

int STRETCH_MODE_MATRIX

Sets the stretch mode to Matrix (stretches to the current aspect ratio of the matrix).

int STRETCH_MODE_ORIGINAL

Sets the stretch mode to Original (stretches to the original aspect ratio of the source).

int STRETCH_MODE_4_TO_3

Sets the stretch mode to 4:3.

int STRETCH_MODE_16_TO_9

Sets the stretch mode to 16:9.

 

Filtering Mode Constants

Value

Description

int FILTERING_MODE_NEAREST_NEIGHBOR

Sets the Filtering Mode to None (no filtering).

int FILTERING_MODE_LINEAR

Sets the Filtering Mode to Linear (may require additional performance).

 

MADRIX 2.X To MADRIX 3.X Migration Hints

The MADRIX 2.X effect SCE Bitmap has been renamed to SCE Image in MADRIX 3.X. The following functions and constants are not supported anymore. Please follow the hints to migrate your macros.

Function / Constant

Description

void SetAnimationSpeed(float value)

Use void SetPlaybackRate(float value) instead.

float GetAnimationSpeed()

Use float GetPlaybackRate() instead.

int GetImageCount()

Use int GetImageListCount() instead. Learn more »Using Image Table

void SetTile(int enable)

Use void SetTiling(int enable) instead.

int GetTile()        

Use int GetTiling() instead.

void SetGrey(int enable)

Use void SetGrayscale(int enable) instead.

int GetGrey()

int GetGrayscale() instead.

void SetRgbToRgbw(int enable)        

void SetRgbw(int enable) instead.

int GetRgbToRgbw()        

Use int GetRgbw() instead.

color GetFilterColor()        

Use color GetColor() instead.

void SetFilterColor(color)

Use void SetColor(color) instead.

int GetPixelImageWidth()

Use int GetImagePixelWidth() instead.

int GetPixelImageWidth()

Use int GetImagePixelHeight() instead.

 

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