====== Legend Editor : Labeling ======

Open the Legend Editor Labeling
  * from menu : Datasets > Legend Editors... > Labeling
  * right-click menu in the Dataset List : right-click dataset > Legend Editor... > Labeling

{{labeling.png}}

  * Orbit GIS uses a technique called 'Layout Component' to graphically display any non spacial attribute.
  * The most easy way to create a graphic representation of an attribute, is using it's value as a label on the map view. For example an attribute containing the street name, or a city name.
  * Orbit GIS allows to define a single label per model.
  * The labeling tab provides a wide range of possibilities to edit the graphic appearance of the label (font, style, transparency, orientation, positioning, halo and shadow).


==== Placing Labels ====

{{labeling_label_setup.png}}

^ Parameter ^ Comment ^
| Show the labels | Tick to activate the labeling of an attribute |
| Resolve Collisions ? | Resolve collisions of labels by hiding some of them |
| Label this value | Select the attribute to label | 







==== Editing the Appearance of the Labels ====

{{labeling_text_appearance.png}}

It is possible to specify each of these graphic parameters, press Apply tot see the result on the Map View.

=== Font ===

{{labeling_text_appearance_font.png}}

^ Parameter ^ Comment ^
| Font Name | Select a [[..:..:..:datasets:properties:legend:parameters:font|font]]. |
| Font Style | Select a [[..:..:..:datasets:properties:legend:parameters:font|font style]] (plain, bold, italic, bold-italic). |
| Font Color | [[..:..:..:datasets:properties:legend:parameters:color|Choose a color]] for the label text. |
| Font Size | Enter a font size and select a [[..:..:..:datasets:properties:legend:parameters:size|size unit]] (point on screen, mm on paper, meter on scale). |
| Line Spacing |  |

=== Style ===

{{labeling_text_appearance_style.png}}

^ Parameter ^ Comment ^
| Style | Select a text frame style (text, text box (round), text callout (round). |
| Box Fill | [[..:..:..:datasets:properties:legend:parameters:color|Choose a fill color]] for the text frame. |
| Box Outline | [[..:..:..:datasets:properties:legend:parameters:color|Choose an outline color]] for the text frame. |

=== Transparency ===

{{labeling_text_appearance_transparency.png}}

^ Parameter ^ Comment ^
| Transparency | Set the transparency percentage of the label from opaque to completely transparent. |

=== Orientation ===

{{labeling_text_appearance_orientation.png}}

^ Parameter ^ Comment ^
| Orientation | Set the label orientation. |
| Orientation Reset | Reset the label orientation to horizontal. |
| Orientation Type | Only available for line objects \\ Select if the orientation is absolute or relative as seen from the line object. |

=== Hotspot ===

{{labeling_text_appearance_hotspot.png}}

^ Parameter ^ Comment ^
| Hotspot | Set the label location compared to the centroid or axis of the object, the standard point of implantation of the label. |
| Hotspot Margin | Enter the deviation distance of the label location compared to the centroid or axis of the object and select a [[..:..:..:datasets:properties:legend:parameters:size|size unit]]. |

=== Halo ===

{{labeling_text_appearance_halo.png}}

^ Parameter ^ Comment ^
| Visibility | Tick to activate the Halo of the label text. See [[..:..:..:datasets:properties:legend:parameters:halo]]. |
| Color | [[..:..:..:datasets:properties:legend:parameters:color|Choose a color]] for the halo of the label text. |
| Transparency  | Set the transparency percentage of the halo of the label from opaque to completely transparent. |

=== Shadow ===

{{labeling_text_appearance_shadow_drop.png}}

^ Parameter ^ Comment ^
| Visibility | Tick to activate the shadow of the label. See [[..:..:..:datasets:properties:legend:parameters:shadow|shadow visuals]]. |
| Style | Choose between drop or perspective shadow. See [[..:..:..:datasets:properties:legend:parameters:shadow#Style|shadow style]]. |
| Direction | Set the drop shadow direction. |
| Direction Reset | Reset the drop shadow direction to the default value. |
| Distance | Set the visual distance between the label and his shadow (see [[..:..:..:datasets:properties:legend:parameters:shadow#Drop shadow distance|shadow distance]]) and select a [[..:..:..:datasets:properties:legend:parameters:size|size unit]]. |
| Color | [[..:..:..:datasets:properties:legend:parameters:color|Choose a color]] for the shadow of the label. |
| Transparency | Set the transparency percentage of the shadow from opaque to completely transparent. |
| Blur | Set the blur or fading of the shadow, from no blur to maximal blur. See [[..:..:..:datasets:properties:legend:parameters:shadow#Blur|shadow blur]]. |

{{labeling_text_appearance_shadow_perspective.png}}

^ Parameter ^ Comment ^
| Style | Choose between drop or perspective shadow. See [[..:..:..:datasets:properties:legend:parameters:shadow#Style|shadow style]]. |
| Light angle | Set the angle of light incidence. |
| Length | Set the length of the perspective shadow. See [[..:..:..:datasets:properties:legend:parameters:shadow#Perspective shadow length|shadow length]]. |


=== Content ===

{{labeling_text_appearance_content.png}}

^ Parameter ^ Comment ^
| Decimals | Only available for labeling float attributes. \\ Set the number of decimals to round off in the label. |
| Render as Image | Only available by labeling [[an image url]]. |
| Thumbnail size | Only available by labeling [[an image url]]. \\ Set the size of the thumbnail.  |