Back to [[110:orbitgis:datasets:legend:index|]]
====== Labeling ====== A Label is the **"Text display" of one Attribute Value**. \\ Labels and [[110:orbitgis:datasets:legend:pie_chart:index|PieCharts]] are the Legend Layout Component. {{orbitgis:entrance_icon_2.png?nolink&30|}} \\ Right-Click on the dataset in the [[110:orbitgis:datasetlist:index|Dataset List]]: [[110:orbitgis:datasetlist:dataset:context_menu|Context Menu]] > [[110:orbitgis:datasets:index|Dataset Properties]] > [[110:orbitgis:datasets:legend:index|Legend and Labeling]] > Labeling ===== Overview ==== [[110:orbitgis:datasets:legend:labels#Label Setup|{{label_setup.png?|}}]] ^ Labels ^^ | [[110:orbitgis:datasets:legend:labels#Label Setup]] | Choose the attribute to be labeled. Resolve collisions or activate dynamic positions. | | [[110:orbitgis:datasets:legend:labels#Text Appearance]] | Change the settings that specify the appearance of labels | \\ \\ ===== Label Setup ===== {{label_setup.png?nolink|}} ^ Label Setup ^^ | Show the Labels | Tick to activate the labels. | | Resolve Collisions? | Tick to resolve collisions. | | Dynamic Positioning | Tick to activate dynamic positioning. | | Label this value | Select an attribute to label. | **Note:** When an attribute is chosen to be labeled, only the first value will appear. Some dataformats such as OVF can have more than one values, a shapefile can only contain one. **Resolve Collisions** \\ Some labels will disappear to improve the readability of the text. \\ ^ Resolve Collisions? = False ^ Resolve Collisions? = True ^ | {{label_coldyn_col_false.png?nolink445|}} | {{label_coldyn_col_true.png?nolink445|}} | **Dynamic positions** \\ Some labels will be displaced from their original position (see [[110:orbitgis:datasets:legend:labels#Label Hotspot|Hotspot]]) to fit within the mapcanvas. Dynamic positions are visible for objects that are not completely lying within the mapcanvas. \\ ^ Dynamic Positions = False ^ Dynamic Positions = True ^ | {{label_coldyn_dyn_false.png?nolink445|}} | {{label_coldyn_dyn_true.png?nolink445|}} | \\ \\ ===== Text Appearance ===== ^ Text Appearance ^^^ | [[110:orbitgis:datasets:legend:labels#Label Font|{{label_index_font.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Font]] | Choose the label font and font style (bold or italic). | | [[110:orbitgis:datasets:legend:labels#Label Style|{{label_index_style.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Style]] | Labels displayed as plain text or text in a box. | | [[110:orbitgis:datasets:legend:labels#Label Transparency|{{label_index_transparency.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Transparency]] | Set the transparency of the labels. | | [[110:orbitgis:datasets:legend:labels#Label Orientation|{{label_index_orientation.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Orientation]] | Choose the orientation: absolute (horizontal) or relative. | | [[110:orbitgis:datasets:legend:labels#Label Hotspot|{{label_index_hotspot.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Hotspot]] | Set the position of the label compared to the center of the spatial object. | | [[110:orbitgis:datasets:legend:labels#Label Halo|{{label_index_halo.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Halo]] | Add a margin to the label text to improve the readability of the text. | | [[110:orbitgis:datasets:legend:labels#Label Shadow|{{label_index_shadow.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Shadow]] | Project a shadow from the label | | [[110:orbitgis:datasets:legend:labels#Label Content|{{label_index_content.png|}}]] | [[110:orbitgis:datasets:legend:labels#Label Content]] | Display an image url as label or set the amount of decimal values to numerical attribute values | ==== Label Font ==== {{label_text_font.png?nolink|}} ^ Label Font ^^ | Font Name | Select a font. | | Font Style | Select a font style (plain, bold, italic, bold-italic). | | Font Color | [[110:orbitgis:datasets:legend:parameters:color|Choose a color]] for the label text. | | Font Size | Enter a font size and select a [[110:orbitgis:datasets:legend:parameters:size|size unit]]. | | Line Spacing | | **Font Name** {{label_text_font_name.png?nolink|}} The available fonts are those which are incorporated within the operating system. * Windows: Control Panel > Fonts * Mac: Font book Consequently the use and visibility of fonts is depending of the used operating system. **Font Style** The Font Styles are: * Plain * **Bold** * //Italic// * **//Bold-Italic//** [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Style ==== {{label_text_style.png?nolink|}} ^ Label Style ^^ | Style | Select a text frame style (text, text box (round), text callout (round). | | Box Fill | Choose a fill color for a text box or text callout using the [[110:orbitgis:datasets:legend:parameters:color|Color Picker]]. | | Box Outline | Choose an outline color for a text box or text callout using the Color Picker. | **Note:** When **Text** is selected near Style, the colors chosen for Box Fill or Box Outline have no influence. [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Transparency ==== {{label_text_transparency.png?nolink|}} ^ Label Transparency ^^ | Transparency | Set the transparency percentage of the label from opaque to completely transparent. | [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Orientation ==== {{label_text_orientation.png?nolink|}} ^ Label Orientation ^^ | 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**, **relative** or **curved** as seen from the line object. | **Orientation Type** === === ^ absolute ^ relative ^ | {{orbitgis:datasets:legend:label_text_orientation_absolute.png?nolink430}} | {{orbitgis:datasets:legend:label_text_orientation_relative.png?nolink430}} | ^ curved ^ ^ | {{orbitgis:datasets:legend:label_text_orientation_curv.png?nolink430}} | Note that labels with a **//curved//** Orientation Type can only be displayed if the label value doesn't exceed the length of the line segment. | [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Hotspot ==== {{label_text_hotspot.png?nolink|}} ^ Label Hotspot ^^ | 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 [[110:orbitgis:datasets:legend:parameters:size|size unit]]. | **Hotspot** \\ A hotspot sets the position of the label compared to the center of the spatial object. \\ The selected location (on the circle) is the centroid or axis of the object. The point in the middle refers to the location of the labels. === === ^ Hotspot ^ example ^ | {{label_text_hotspot_central_h.png?nolink|}} | {{label_text_hotspot_central_m.png?nolink470|}} | | {{label_text_hotspot_above_h.png?nolink|}} | {{label_text_hotspot_above_m.png?nolink470|}} | | {{label_text_hotspot_under_h.png?nolink|}} | {{label_text_hotspot_under_m.png?nolink470|}} | [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Halo ==== {{label_text_halo.png?nolink|}} ^ Label Halo ^^ | Visibility | Tick to activate the Halo of the label text. | | Color | [[110:orbitgis:datasets: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. | **Halo** \\ A halo improves the readability of the text by adding a small border around the text. \\ It is only useful to set a halo when 'Text' is selected near Label Style. === === ^ No Halo ^ With Halo ^ | {{label_text_halo_e_0.png?nolink|}}| {{label_text_halo_e_1.png?nolink|}} | | {{label_text_halo_e_line_0.png?nolink|}} | {{label_text_halo_e_line_1.png?nolink|}} | [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Shadow ==== {{label_text_shadow.png?nolink|}} See [[110:orbitgis:datasets:legend:parameters:shadow|shadow settings]]. [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\ ==== Label Content ==== {{label_text_content.png?nolink|}} ^ Label Content ^^ | 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 [[110:orbitgis:datasets:contents:naming#Hyperlink|an image url]]. | | Thumbnail size | Only available by labeling an image url. \\ Set the size of the thumbnail. | [[110:orbitgis:datasets:legend:labels#text_appearance|↑ Back to top]] \\