abeLayerAvoid

abeLayerAvoid(
o_abeLayer1 
o_abeLayer2 
o_abeOutputLayer 
[ ?queue g_queue ]
[ ?islandBased g_islandBased ]
)
=> t / nil

Description

Adds shapes on the output layer for shapes on layer1 that are completely outside of, and have no abutting edges with, shapes on layer2.

Arguments

o_abeLayer1	ID of ABE layer1.
o_abeLayer2	ID of ABE layer2.
o_abeOutputLayer	Adds shapes to the ABE layer.
?queue g_queue	Adds the function to the queue if set to t, rather than running it immediately. Functions in the queue are not run until abeRunQueue is issued.
?islandBased g_islandBased
	Includes all the full islands that are not touching the ABE layer2.

Values Returned

t	The function was run or queued successfully.
nil	The function was not successful because ABE is not initialized or there was an argument error.

Examples

Adds shapes to the result ABE layer where a1 ABE layer shapes are completely outside of, and have no abutting edges with, shapes on the a2 ABE layer.

abeLayerAvoid( a1 a2 result )

When ?islandBased is specified, it includes entire islands to the outputLayer ABE layer where m1layer ABE layer islands are completely outside and not touching the m2layer ABE layer. The shapes with green outlines and diagonal stripes are the resulting shapes from the ABE layer.

Related Topics

abeRunQueue

Support for Multithreading in ABE Functions

Return to top