lscan

(/tools/hpmatlab/toolbox/matlab/plotxy/lscan.m)

Function Synopsis

[Pos]=lscan(ha,wdt,hgt,tol,stickytol,hl)

Help text

 LSCAN Used by LEGEND to determine a "good" place for
	the legend to appear. LSCAN returns either the
	position (in figure normalized units) the legend should
	appear, or a -1 if no "good" place is found.

       LSCAN searches for the best place on the graph according
       to the following rules.
           1. Legend must obscure as few data points as possible.
              Number of data points the legend may cover before plot
              is "squeezed" can be set with TOL. The default is a 
              large number so to enable squeezing, TOL must 
              be set. A negative TOL will force squeezing.
           2. Regions with neighboring empty space are better.
           3. Top and right are better than bottom and left.
           4. If a legend already exists and has been manually placed,
              then try to put new legend "close" to old one. 

	LSCAN(HA,WDT,HGT,TOL,STICKYTOL,HL) returns a 2 element
 	position vector. WDT and HGT are the Width and Height of
	the legend object in figure normalized units. TOL
 	and STICKYTOL are tolerances for covering up data points.
	HL is the handle of the current legend or -1 if none exist. 

	LSCAN(HA,WDT,HGT,TOL) allows up to TOL data
	points to be covered when selecting the best
	legend location.

Cross-Reference Information

else           /tools/hpmatlab/toolbox/matlab/lang/else.m
elseif         /tools/hpmatlab/toolbox/matlab/lang/elseif.m
end            /tools/hpmatlab/toolbox/matlab/lang/end.m
find           /tools/hpmatlab/toolbox/matlab/ops/find.m
fix            /tools/hpmatlab/toolbox/matlab/elfun/fix.m
for            /tools/hpmatlab/toolbox/matlab/lang/for.m
get            /tools/hpmatlab/toolbox/matlab/graphics/get.m
i              /tools/hpmatlab/toolbox/matlab/elmat/i.m
if             /tools/hpmatlab/toolbox/matlab/lang/if.m
j              /tools/hpmatlab/toolbox/matlab/elmat/j.m
length         /tools/hpmatlab/toolbox/matlab/general/length.m
line           /tools/hpmatlab/toolbox/matlab/plotxy/line.m
max            /tools/hpmatlab/toolbox/matlab/datafun/max.m
min            /tools/hpmatlab/toolbox/matlab/datafun/min.m
nargin         /tools/hpmatlab/toolbox/matlab/elmat/nargin.m
ones           /tools/hpmatlab/toolbox/matlab/elmat/ones.m
return         /tools/hpmatlab/toolbox/matlab/lang/return.m
round          /tools/hpmatlab/toolbox/matlab/elfun/round.m
set            /tools/hpmatlab/toolbox/matlab/graphics/set.m
size           /tools/hpmatlab/toolbox/matlab/general/size.m
sum            /tools/hpmatlab/toolbox/matlab/datafun/sum.m
text           /tools/hpmatlab/toolbox/matlab/plotxy/text.m
type           /tools/hpmatlab/toolbox/matlab/general/type.m
while          /tools/hpmatlab/toolbox/matlab/lang/while.m

legend         /tools/hpmatlab/toolbox/matlab/plotxy/legend.m