Skip to content

ItemEffect

Defined in: core/items/ieffects.ts:320

new ItemEffect(): ItemEffect

ItemEffect

getBorderEffectColor(): Promise<Color>

Defined in: core/items/ieffects.ts:571

return: Promise

Gets the border effect color. Only relevant when mask effect is set to shape

Promise<Color>

IItemEffect.getBorderEffectColor


getBorderEffectOpacity(): Promise<number>

Defined in: core/items/ieffects.ts:538

return: Promise

Gets the border effect opacity (0 - 100). Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getBorderEffectOpacity


getBorderEffectRadius(): Promise<number>

Defined in: core/items/ieffects.ts:472

return: Promise

Gets the border effect radius (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getBorderEffectRadius


getBorderEffectThickness(): Promise<number>

Defined in: core/items/ieffects.ts:505

return: Promise

Gets the border effect thickness (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getBorderEffectThickness


getFileMask(): Promise<string>

Defined in: core/items/ieffects.ts:808

return: Promise

Determines the image used to mask the source. Only relevant when mask effect is set to file

Promise<string>

IItemEffect.getFileMask


getFilter(): Promise<Filter>

Defined in: core/items/ieffects.ts:856

return: Promise

Gets the post processing shader used

Promise<Filter>

IItemEffect.getFilter


getFilterConfig(): Promise<Object>

Defined in: core/items/ieffects.ts:920

return: Promise

Gets the post-processing shader configurations as an object possibly having properties such as:

  • intensity : percentage of filter applied
  • resourceFile : PNG image used as a reference for LUTs

Promise<Object>

IItemEffect.getFilterConfig


getMaskEffect(): Promise<MaskEffect>

Defined in: core/items/ieffects.ts:417

return: Promise

Determines the mask effect being used

Promise<MaskEffect>

IItemEffect.getMaskEffect


getShadowEffectBlur(): Promise<number>

Defined in: core/items/ieffects.ts:676

return: Promise

Gets the shadow effect blur (0 - 100). Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getShadowEffectBlur


getShadowEffectColor(): Promise<Color>

Defined in: core/items/ieffects.ts:609

Promise<Color>


getShadowEffectOffsetX(): Promise<number>

Defined in: core/items/ieffects.ts:742

return: Promise

Gets the horizontal shadow effect offset (-100 to -100), relative to the size of the source. Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getShadowEffectOffsetX


getShadowEffectOffsetY(): Promise<number>

Defined in: core/items/ieffects.ts:775

return: Promise

Gets the vertical shadow effect offset (-100 to 100), relative to the size of the source. Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getShadowEffectOffsetY


getShadowEffectOpacity(): Promise<number>

Defined in: core/items/ieffects.ts:709

return: Promise

Gets the shadow effect opacity (0 - 100). Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getShadowEffectOpacity


getShadowEffectThickness(): Promise<number>

Defined in: core/items/ieffects.ts:643

return: Promise

Gets the shadow effect thickness (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Promise<number>

IItemEffect.getShadowEffectThickness


isFileMaskingGuideVisible(): Promise<boolean>

Defined in: core/items/ieffects.ts:824

return: Promise

Check whether the file masking guide is visible or not. Only relevant when mask effect is set to file

Promise<boolean>

IItemEffect.isFileMaskingGuideVisible


removeFilter(): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:912

Removes the set post-processing shader used. Similar to setting to NONE

Chainable.

Promise<ItemEffect>

IItemEffect.removeFilter


setBorderEffectColor(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:593

param: (value: Color)

Sets the border effect color. Only relevant when mask effect is set to shape

Chainable.

Color

Promise<ItemEffect>

IItemEffect.setBorderEffectColor


setBorderEffectOpacity(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:553

param: (value: number)

Sets the border effect opacity (0 - 100). Only relevant when mask effect is set to shape

Chainable.

number

Promise<ItemEffect>

IItemEffect.setBorderEffectOpacity


setBorderEffectRadius(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:487

param: (value: number)

Sets the border effect radius (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Chainable.

number

Promise<ItemEffect>

IItemEffect.setBorderEffectRadius


setBorderEffectThickness(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:520

param: (value: number)

Sets the border effect thickness (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Chainable.

Note that since a source occupies its own ‘window’ in the XBC stage, it is specifically made that the edge effects are still within the boundaries of the source, such that increasing border thickness adds the layer inwards instead of outwards.

number

Promise<ItemEffect>

IItemEffect.setBorderEffectThickness


setFileMask(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:816

param: (value: string)

Sets the image to be used used to mask the source. Only relevant when mask effect is set to file

Chainable.

string

Promise<ItemEffect>

IItemEffect.setFileMask


setFilter(value, config?): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:869

param: (value: Filter or transitionString)

Sets the post processing shader to be used for the Item

Chainable.

any

number

string

Promise<ItemEffect>

IItemEffect.setFilter


setMaskEffect(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:437

param: (value: MaskEffect)

Sets the mask effect to any one of three possible choices: Shape/Edge effects, File masking (both bind to stage and bind to source), or None(mask effect disabled).

Chainable.

After setting the mask effect, you may tweak settings specific to that effect.

  • None
  • Shape: methods prefixed with getBorderEffect-*, getShadowEffect-*, setBorderEffect-*, or setShadowEffect-*
  • File: methods getFileMask, setFileMask, showFileMaskingGuide and isFileMaskingGuideVisible

MaskEffect

Promise<ItemEffect>

IItemEffect.setMaskEffect


setShadowEffectBlur(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:691

param: (value: number)

Sets the shadow effect blur (0 - 100). Only relevant when mask effect is set to shape

Chainable.

number

Promise<ItemEffect>

IItemEffect.setShadowEffectBlur


setShadowEffectColor(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:631

Color

Promise<ItemEffect>


setShadowEffectOffsetX(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:757

param: (value: number)

Sets the horizontal shadow effect offset (-100 to 100), relative to the size of the source. Only relevant when mask effect is set to shape

Chainable.

A positive horizontal offset shifts the shadow to the right of the horizontal center at the background, which visually seems to decrease the left portion of the shadow. A negative horizontal offset in turn shifts the shadow to the left, visually decreasing the right portion of the shadow.

number

Promise<ItemEffect>

IItemEffect.setShadowEffectOffsetX


setShadowEffectOffsetY(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:790

param: (value: number)

Sets the vertical shadow effect offset (-100 to 100), relative to the size of the source. Only relevant when mask effect is set to shape

Chainable.

A positive vertical offset shifts the shadow below the vertical center at the background, which visually seems to decrease the top portion of the shadow. A negative vertical offset in turn shifts the shadow above, visually decreasing the bottom portion of the shadow.

number

Promise<ItemEffect>

IItemEffect.setShadowEffectOffsetY


setShadowEffectOpacity(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:724

param: (value: number)

Sets the shadow effect opacity (0 - 100). Only relevant when mask effect is set to shape

Chainable.

number

Promise<ItemEffect>

IItemEffect.setShadowEffectOpacity


setShadowEffectThickness(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:658

param: (value: number)

Sets the shadow effect thickness (0 - 100), relative to the size of the source. Only relevant when mask effect is set to shape

Chainable.

Note that since a source occupies its own ‘window’ in the XBC stage, it is specifically made that the edge effects are still within the boundaries of the source, such that increasing thickness adds the layer inwards instead of outwards.

number

Promise<ItemEffect>

IItemEffect.setShadowEffectThickness


showFileMaskingGuide(value): Promise<ItemEffect>

Defined in: core/items/ieffects.ts:838

param: (value: boolean)

shows or hides the file masking guide. Only relevant when mask effect is set to file

Chainable.

The file masking guide highlights the area of the source that is currently being masked. Please note that resetting mask effect also resets this to false

boolean

Promise<ItemEffect>

IItemEffect.showFileMaskingGuide