=================== Mask Prompter 3 =================== Workflow ======================= You create mattes by specifying so-called prompts for the current frame. Prompts can either be points, rectangle masks around an object or textual descriptions of the objects you want to create a matte for. Premiere Pro ======================= The plugin is fully functional on Premiere Pro, except for rectangle masks (use points / text description instead). Text prompts are entered via the new prompt input dialog. Parameters =========== Points (except SAM3) --------------------- Enable "Active" and specify the coordinates of the point. By keyframing the points position you can follow objects. Boxes (except SAM3) ------------------- Add rectangle masks to the layer and assign them to one of the slots. This will create a matte for the object contained inside the rectangle. Text Prompts ------------------- Describe the objects you want to mask by linking in masks and changing the masks name. To key e.g. a horse click "Add Text Input", change the new masks name to "a horse" and link the mask layer in one of the slots. Sometimes the prompting requires some trial and error. You can detect multiple objects by separating words or phrases with a dot. E.g. "horse. red car." will detect both horses and red cars (does not work with SAM3, use multiple text inputs instead). .. video:: https://media-blaceplugins.b-cdn.net/mp3_text_input.mp4 :autoplay: :width: 100% :muted: :nocontrols: :loop: Multiple ^^^^^^^^^^^^^^ If active, will detect all object that match the phrases. Otherwise only one object with the highes similarity score is returned. Detection Threshold (except SAM3) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The lower this value the more objects will be detected, at the cost of more false positives. Scale Rectangles ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Increase the size of the detected rectangles around objects. This also has an influence of the matting results from the matting component. Positive Concepts (SAM3 only) -------------------------------- Add rectangle masks to the layer and assign them to one of the slots. This will create a matte for the object contained inside the rectangle and other similar looking objects. Exclude Points ------------------- Mark areas in the image you want to exclude from the masks. Detection Threshold ------------------- The lower this value the more objects will be detected, at the cost of more false positives. Models ------------------- Select the keying and object detection model. Matte Refinement ------------------- Use HQ for the current state-of-the art model. Filter Width ------------------- The width of the filter around the corners. Use small values to apply minor corrections and larger values if the edges have great variance (e.g. hair in the wind). High Resolution ------------------- Run the edge refinement on a higher resolution (consumes more VRAM). Output ------------------- "Overlay" draws the matte as white overlay on top of the image (set opacity with "Overlay Strength"). "Matte" will output a simple black and white matte and "On Transparent" will give you the keyed object on alpha. "Detection Boxes" and "Detection Boxes On Transparent" will only render the detection boxes from text prompts, but no mattes. Draw Rectangles ------------------- Draw rectangles / bounding boxes around objects detected from the text prompting model. Color (only if rectangles are drawn) ------------------------------------- The color of the rectangles. Thickness (only if rectangles are drawn) ----------------------------------------- The thickness of the rectangles outline. Tips & Tricks ------------------- If you use the "On Transparent" output the resulting matte can directly be postprocessed with After Effects internal effects like "Refine Soft Matte". Backend & Performance ----------------------- .. include:: common-args.rst