## NAME

v.label - makes a label-file from a GRASS vector.
(GRASS Vector Program)

## SYNOPSIS

v.label
v.label help
v.label map=name [type=type] text=name label=name [xoffset=value] [yoffset=value] [reference=name] [font=name] [size=value] [color=name] [width=value] [hcolor=name] [hwidth=value] [background=name] [border=name] [opaque=name] [space=value]

## DESCRIPTION

v.label makes a label-file from a GRASS vector file. Labels are read from text file which contains category and label on each row separated by space. Example of text file:

    1 Kamenice
    2 Cerna Desna
    3 Bila Desna

In current version only lines are labeled and label is created along line.

## PARAMETERS

map
  Name of a vector
text
  Full path to text file containing labels
label
  Name of a paint-label file
xoffset
  Offset label in x-direction
  default: 0
yoffset
  Offset label in y-direction
  default: 0
reference
  Reference position
  options: center,left,right,upper,lower
  default: center
font
  Font
  default: standard
size
  Label size (in map-units)
  options: 1-1000
  default: 100
color
  Text color
  options: aqua,black,blue,brown,cyan,gray,green,grey,indigo, magenta, orange,purple,red,violet,white,yellow
  default: black
width
  Line width of text (only for p.map output)
  options: 1-100
  default: 1
hcolor
  Highlight color for text (only for p.map output)
  options: none,aqua,black,blue,brown,cyan,gray,green,grey, indigo,magenta, orange,purple,red,violet,white,yellow
  default: none
hwidth
  Line width of highlight color (only for p.map output)
  options: 0-100
  default: 0
background
  Background color
  options: none,aqua,black,blue,brown,cyan,gray,green,grey, indigo,magenta, orange,purple,red,violet,white,yellow
  default: none
border
  Border color
  options: none,aqua,black,blue,brown,cyan,gray,green,grey, indigo,magenta, orange,purple,red,violet,white,yellow
  default: none
opaque
  Opaque to vector (only relevant if background color is selected)
  options: yes,no
  default: yes
space
  Space between letters (in map-units)
  options: 1-100000
  default: 100

## NOTE

Rotated labels produced by this module are supported by ps.map only.

## AUTHOR

Philip Verhagen (original s.label)
Radim Blazek