Points in PSP are tuples written in (x,y) format. The point being how far from the left (x) and how far from the top (y) you click. So exactly as the API documentation says. This setting is the point of the mouse click. And whatever layer has the first visible pixel in that location is the layer that's selected.
There isn't a great way to determine a safe location on a layer to select because some layers will have pockets of transparent areas. There is a way, but it's not built-in to the API. So it's best to use a trick of the move tool. When using the move tool if you hold SHIFT it'll ignore where you click and just move the currently selected layer. So holding SHIFT does something to the command.
If you want to see how different hotkeys like SHIFT and CTRL affect the command you can use the History Palette.
In PSP show the history palette (View -> Palettes -> History). Then perform an action, right-click on the action in the history palette and hit "Copy". Then in notepad or whatever editor you're using. Paste it in, you'll see the command that reflects that action and all of it's parameters.
If you hold SHIFT while using the Move tool and then copy the result you'll notice something interesting LayerSelectPoint is set to None. So we can assume that setting LayerSelectPoint to None will ignore where you click.
EDIT: I would like to add there are several methods for moving a recently pasted layer into position. Mover is the easiest, and probably the fastest in most cases but there are others. Two for general movement, and then the align objects commands if you want to use another layer to align to.
1)
Pick tool - this command lets you identify the location of the 4 corners of the layer and where you want them placed. This can result in the image being rotated, skewed, stretched, or just moved. Since this is a transformation command, however, it can be slower on large layers than on smaller ones.
Set all parameters above the "Handle" parameters to None and then just set the (x,y) location of the handles. Note that the handles start in the bottom-left corner of the layer and go clockwise.
2)
PasteAsNewSelection - This creates a floating selection, and drops the middle of the layer at the offset you decide. I believe the Offset parameter is measured fromm the center of the canvas. So if you grab the layer properties of the bottom layer you want to align it with, and the center point of the canvas, you can calculate where you want to drop the layer. THen you just need to call "SelectPromote" command to promote it to a full layer. If you unfloat the selection it'll merge into the layer below it.
3)
Align commands - These are the VectorAlign commands found in the API. They are called "VectorAlign" because once upon a time they were only available while editing vector objects. Now you can use them on all layers. The big thing is you have to have two layers selected to use them. Which means also using the "VectorSelectionUpdate" command. The Path command is a relative path for getting to the layer you want from the layer you're currently on. Here's an example where I select the layer beneath my current layer, then align their top and left values so they start at the same location on the canvas.
Code: Select all
# Vector Selection Update
App.Do( Environment, 'VectorSelectionUpdate', {
'Path': (0,-1,[],False),
'Type': App.Constants.ObjectSelection.AddToSelection,
'GeneralSettings': {
'ExecutionMode': App.Constants.ExecutionMode.Silent,
'AutoActionMode': App.Constants.AutoActionMode.Default,
'Version': ((25,0,0),1)
}
})
# Vector Align Top
App.Do( Environment, 'VectorAlignTop', {
'GeneralSettings': {
'ExecutionMode': App.Constants.ExecutionMode.Default,
'AutoActionMode': App.Constants.AutoActionMode.Match,
'Version': ((25,0,0),1)
}
})
# Vector Align Left
App.Do( Environment, 'VectorAlignLeft', {
'GeneralSettings': {
'ExecutionMode': App.Constants.ExecutionMode.Default,
'AutoActionMode': App.Constants.AutoActionMode.Match,
'Version': ((25,0,0),1)
}
})
