<?xml version="1.0"?>
<!DOCTYPE kpartgui>
<effect tag="mask_start" id="mask_start-shape" dependency="shape">
    <name>Shape Alpha (Mask)</name>
    <description>This filter makes a snapshot of the frame before an alpha channel (transparency) is created based on another resource. Use it together with the mask_apply effect, that uses a transition to composite the current frame's image over the snapshot. The typical use case is to add effects in the following sequence: this effect, zero or more effects, mask_apply.</description>
    <author>Charles Yates, Dan Dennedy</author>
    <parameter type="fixed" name="filter" value="shape">
        <name>Filter</name>
    </parameter>
    <parameter type="urllist" paramlist="%maskPaths" name="filter.resource" filter="Video files (*)">
        <name>Image or video resource</name>
    </parameter>
    <parameter type="keyframe" name="filter.mix" max="100" min="0" default="70" suffix="%" relative="true">
        <name>Threshold</name>
        <comment>Convert alpha or luma values below this level as opaque and above this level as transparent. This is mostly useful for luma wipe images.</comment>
    </parameter>
    <parameter type="constant" name="filter.softness" max="1" min="0" default="0.1" decimals="2">
        <name>Softness</name>
        <comment>When using mix (threshold) how soft to make the edge around the threshold. 0.0 = no softness, 1.0 = too soft.</comment>
    </parameter>
    <parameter type="bool" name="filter.invert" default="0" min="0" max="1">
        <name>Invert</name>
        <comment>Use the inverse of the alpha channel.</comment>
    </parameter>
    <parameter type="bool" name="filter.use_luminance" default="0" min="0" max="1">
        <name>Use Luma</name>
        <comment>Use the image luma instead of the alpha channel.</comment>
    </parameter>
    <parameter type="bool" name="filter.use_mix" default="1" min="0" max="1">
        <name>Use Threshold</name>
        <comment>Whether to apply a threshold filter to the luma or alpha or not. If not, luma or alpha value of the resource (File) is copied to the alpha channel.</comment>
    </parameter>
    <parameter type="position" name="in" default="%in" min="0" max="1000000">
        <name>Offset</name>
        <comment>Start position for the mask file.</comment>
    </parameter>
    <parameter type="position" name="out" default="-1" min="-1" max="1000000">
        <name>Out</name>
        <comment>End position for the mask file.</comment>
    </parameter>
    <parameter type="fixed" name="filter.audio_match" default="0" />
</effect>
