User Tools

Site Tools


DzTextureLayer

Implements a layer component in a layered texture.

More...

Inherits :

Enumerations

Properties

DAZ Script
BlendModeblendMode

Methods

Signals

voidaboutToChangeMask ( DzTextureMask oldMask, DzTextureMask newMask )
voidblendModeChanged ( BlendMode mode )
voidmaskChanged ( DzTextureMask oldMask, DzTextureMask newMask )

Detailed Description

Layers are used in image editing to manipulate the final values of pixels in an image, in a non-destructive way. Layers exist in a stack. Layers that are higher in the stack impact layers that are lower in the stack. Transparent and/or translucent pixels in one layer allow the pixels in the next lower layer to be revealed.

Layers can also be used to blend the values of pixels together in various ways.

See Also:

Enumerations


: BlendMode

The enumerated values of possible blending operations to be performed.

  • BlendAlpha - A blending operation that uses the alpha channel of the layer to blend it into the values of the lower layers.
  • BlendAdd - An additive image blending operation; the values of the layer are added to the values of the lower layers.
  • BlendSubtract - A subtractive image blending operation; the values of the layer are subtracted from the values of the lower layers.
  • BlendMultiply - A multiplicative image blending operation; the values of the layer are multiplied with the values of the lower layers.

Properties


BlendMode : blendMode

Holds the blend mode of the texture layer.

Methods


void : clearMask()

Removes any mask that may be on this layer.


DzTextureMask : createMask( String maskLabel )

Creates a mask for this texture layer.

Parameter(s):

  • maskLabel - The label of the mask.

Return Value:

  • The mask on this layer, otherwise null. If a mask already exists on this layer, the mask's label is changed to the label specified. If a mask does not exist on this layer, a new mask is created and assigned the label specified.

DzTextureMask : getMask()

Return Value:

  • The mask on this layer (if any), otherwise null.

Boolean : needsRefresh()

Return Value:

  • true if this texture layer has a mask that needs to be refreshed or this layer has been modified on disk since it was last loaded/updated, otherwise false.

See Also:


void : setMask( DzTextureMask mask )

Sets a mask on this texture layer.

Parameter(s):

  • mask - The mask to set.

Signals


void : aboutToChangeMask( DzTextureMask oldMask, DzTextureMask newMask )

Signature:“aboutToChangeMask(DzTextureMask*,DzTextureMask*)”

Emitted just before the mask for the texture layer is changed.

Parameter(s):

  • oldMask - The current texture mask.
  • newMask - The texture mask being assigned.

void : blendModeChanged( BlendMode mode )

Signature:“blendModeChanged(DzTextureLayer::BlendMode)”

Emitted when the blend mode the texture layer has changed.

Parameter(s):

  • mode - The new blend mode.

void : maskChanged( DzTextureMask oldMask, DzTextureMask newMask )

Signature:“maskChanged(DzTextureMask*,DzTextureMask*)”

Emitted when the mask for the texture layer has changed.

Parameter(s):

  • oldMask - The old texture mask.
  • newMask - The new texture mask.