<div dir="ltr">Hi David,<br><br><div class="gmail_extra"><div class="gmail_quote">On Fri, Mar 14, 2014 at 3:07 PM, Chrest, David <span dir="ltr"><<a href="mailto:davidc@rti.org" target="_blank">davidc@rti.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div link="blue" vlink="purple" lang="EN-US"><div><p class="MsoNormal">In the Labels section of a layer properties window, there is a button in the upper left called “Automated placement settings (apply to all layers).”<u></u><u></u></p>
<p class="MsoNormal">What exactly does this do? Search method, Number of candidates, show all labels and features for all layers, show candidates (for debugging), show shadow rectangles (for debugging)? I couldn’t find much documentation on this. Thanks for any help.</p>
</div></div></blockquote><div><br></div><div>All of those settings relate to the automated label placement (PAL) library [0] used to automatically derive optimal label (and diagram) placements, except 'Show shadow rectangles' which is just for debugging. There are definitely some missing descriptions in the online docs for these settings.<br>
</div><div><br></div><div>* Search method - is the method (i.e. algorithm) used by PAL to arrive at a placement solution. Play around with these to see possibly different results or performance by placement engine.<br><br>
</div><div>* Number of candidates - are the total possible candidates for a label/diagram placement (per spatial geometry type) before cost analysis is applied and overlaps calculated. More candidates will decrease performance, but provide a wider range of placements, with less candidates resulting in the opposite. The defaults may not be adequate for your project.<br>
<br></div><div>* Show partial labels - is a newer setting (QGIS 2.0+) that allows labels that extend beyond the map canvas extent (i.e. partially showing inside it) to be drawn. If unchecked, any label touched by the extent will not be shown. This aids the production of map raster tiles, where you don't want a partial label to show up on different part of different tiles. However, the current implementation does not increase the number of candidates, i.e. it will not move a extent-bisecting label to just within the extent; so, those labels will just not be shown, resulting in fewer labels.<br>
<br></div><div>* Show all labels and features for all layers - will turn off PAL's hiding of labels deemed of low cost or that have too many overlaps. All labels, regardless of whether they collide (overlap) will be shown. Sometimes you just want to show all labels. This is also available as a per-layer option in the Labeling dialog of QGIS 2.0+.<br>
<br></div><div>* Show candidates - will show the rectangles of possible label placement candidates (relative to number chosen). With curved labels this shows rectangles per character. When labeling doesn't work as expected, turn this on to see where labels might show up. There is currently no means of forcing a label to use a particular candidate however. You can 'pin' the label and/or move it to a preferred location when using data defined labeling tools.<br>
<br></div><div>* Show shadow rectangles - is a newer setting (QGIS 2.0+) that will draw the bounding box of any drop shadow created for a label component. This helps debug the code that creates the shadows, which are auto-generated raster images. If your drop shadows exhibit odd artifacts or are unduly clipped, turning this on and providing a screenshot will help debug the error.<br>
<br></div><div>Note that prior to QGIS 2.0 these settings were global (app-wide), then with 2.0 and 2.2 they are capable of being saved with the project (as well as global), and with 2.3+ they are only per project, since there is no longer an app-wide QgsPalLabeling instance (only instantiated when a sequential or parallel rendering job is run with the new multi-threaded rendering engine).<br>
</div><div><br>[0] <a href="https://github.com/qgis/QGIS/tree/master/src/core/pal">https://github.com/qgis/QGIS/tree/master/src/core/pal</a><br><br></div><div>Regards,<br><br>Larry Shaffer<br>Dakota Cartography<br>Black Hills, South Dakota<br>
 <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div link="blue" vlink="purple" lang="EN-US"><div><p class="MsoNormal">David Chrest<u></u><u></u></p>
<p class="MsoNormal">Research GIS Analyst<u></u><u></u></p><p class="MsoNormal">RTI International<u></u><u></u></p><p class="MsoNormal">3040 Cornwallis Rd, PO Box 12194<u></u><u></u></p><p class="MsoNormal">Research Triangle Park, NC  27709-2194<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p></div></div><br>_______________________________________________<br>
Qgis-user mailing list<br>
<a href="mailto:Qgis-user@lists.osgeo.org">Qgis-user@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-user" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-user</a><br></blockquote></div><br></div></div>