/ Operator Details
§ 12.11.68 - Place
Scripting command: place [mode=0...9] [under=0...1] [aspectcorrect=0...1] [alphalevel=0...255]
All available scripting operations are listed on the Script
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.
When ✓ Move
is not checked, this operation obeys the ✓ M/Alpha
setting in the Areatools
. In that case, if ✓ M/Alpha
is checked, then the placed origin
image will be modified by the action
image's alpha where that alpha channel is not fully opaque. If you want the origin
image to smoothly blend into the action
image, see to it that ✓ M/Alpha
is checked. This way the action
image's alpha channel will control the resulting transparency, while the origin
image's alpha channel will control the mix.
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.
Document Keyboard Navigation
, Previous Page
. Next Page
This manual was generated with wtfm
wtfm uses aa_macro and SqLite
wtfm and aa_macro are coded in python 2.7
This Documentation and Associated Application Executables are Public Domain