# title

display a title on a graphic window

## Calling Sequence

    title(my_title)
                title(my_title,<Property>)
                title(<axes_handle>,<my_title>,<Property>)

## Arguments

my_title

  a string, it's the title to display

<Property>

  This optional argument represents a sequence of couple statements `{PropertyName,PropertyValue}` that defines global objects' properties applied to the created title.

<axes_handle>

  This optional argument forces the title to appear inside the selected axes given by `axes_handle` rather than the current axes (see gca).

## Description

`title` displays a title on a graphic window.

The `Property` arguments should be used to customize the title. Here is a complete list of the available options.

Property :

  `backgroundcolor :` this field contains the color used to fill the box if any. Its value should be a color index (relative to the current colormap).

  `color :` this field contains the color used to display the title text. Its value should be a color index (relative to the current colormap).

  `edgecolor :` this field contains the color used to display the line around the box if any. Its value should be a color index (relative to the current colormap).

  `fontname :` ten differents font names are available (case unsensitive string or related id number): "courrier" | 0, "symbol" | 1, "times" | 2, "times italic" | 3, "times bold" | 4, "times bold italic" | 5, "helvetica" | 6, "helvetica italic" | 7, "helvetica bold" | 8, "helvetica bold italic" | 9.

  `fontsize :` the fontsize property is used to specify the size of the font. It must be an integer >= 0.

  `position :` this 2d vector allows you to place manually the title on the screen. The position is stored in the data units of the axes.

  `rotation :` this scalar allows you to turn the title. The font is turned inverse clockise with the angle given in degrees.

  `visible :` this field contains the visible property value for the title. It should be "on" or "off". By default, the label is visible, the value's property is "on" . If "off" the title is not displayed on the screen.

## Examples

    // display a title with several properties
    title('my title');
    // change the color for the font
    title('my title','color','blue');
    // change the color for the around the box
    title('my title','edgecolor','red');
    // change the position of the title
    title('my title','position',[0.3 0.8]);
    // change the size of the font
    title('my title','fontsize',3);
    // a rotation
    title('my title','rotation',90);

    // We can do all these modifications with just the below instruction:
    title('my title','color','blue','edgecolor','red','fontsize',3,'rotation',90,'position',[0.3 0.8]);

title('my title','color','blue','edgecolor','red','fontsize',3,'rotation',90,'position',[0.3 0.8]);

## See Also

- label_properties
- titlepage
- xtitle