§ 12.11.69 - Place

Scripting command: place [mode=0...9] [under=0...1] [aspectcorrect=0...1] [alphalevel=0...255]

The place operator

The Place operator provides several methods of placing the origin image on, or under, the action image.

If ✓ Under Alpha is checked, the origin image is placed underneath the action image, and so will only be visible where the action image's alpha channel is less than fully opaque and the action image's alpha levels are less opaque than the setting of the Alpha Level slider.

If ✓ Auto Alpha is checked, then the placed image will be resized to fit within the portion of the transparent region that is less opaque than the setting of the Alpha Level slider.

If ✓ Aspect Correct is checked, the origin image will be resized in proportion to its own dimensions, and if the detected low-alpha region is not the same aspect ratio, either there may remain transparent alpha regions where the origin image does not overlap, or part of the origin image may be clipped against the opaque content of the action image.

If ✓ Under Alpha is not checked, then this operator places the origin image into the action image using the origin image's native resolution using the placement specified in the  Mode  ⇳  menu.

If you choose  Free  ⇳ , then the origin image is placed centered over the center of your area selection in the action image. One of the more common Areatools used for this type of placement is the pencil tool, which can center the origin image over a single-click location. Another way this is commonly used is if you want to center some text in a region; often the rectangle tool is best for this. Just pull the rectangle around the region, and the placement will be about the center of the rectangle.

If you choose any other  Mode  ⇳  menu selection, the origin image is placed where the drop down menu indicates into the action image, no matter what kind of area selection you make.

If the placed origin image is larger than the action image, or if the center of the  Free  ⇳  mode placement causes one or more sides of the placed origin image to land outside the action image boundaries, the placed origin image will be clipped.

The ✓ Move option changes how the Place operator works. In this case, the ✓ Red, ✓ Green, ✓ Blue and ✓ Alpha settings control which channels are moved directly from the origin image.

The ✓ Stamp control, when checked, will place the alpha of the origin image directly in the action image, verbatim. There will be no mixing per the action image's alpha channel; the origin's alpha replaces the action's alpha.