Operators Dialog / Operator Details

§ 12.11.68 - Place

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

Note: All available scripting operations are listed on the Script operator page.

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.

Tip: 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
t TOC i Index k Keyboard o Operators g Glossary c Changes

Valid HTML 4.01 Loose
 

This manual was generated with wtfm
wtfm uses aa_macro and SqLite
wtfm and aa_macro are coded in python 2.7
iToolBox 3.10
This Documentation and Associated Application Executables are Public Domain
Please consider supporting my iToolBox development efforts with a small PayPal donation.