`line`

Desenha uma linha primitiva pelos pontos dados nos eixos atuais.

Categoria: Graphics > Formatting and Annotation

Sintaxe

line(x, y)

Desenha uma linha pelos pontos (x(i), y(i)).

line(x, y, z)

Desenha uma linha em 3-D.

line(___, Name, Value)

Define propriedades como 'Color', 'LineWidth' e 'LineStyle'.

h = line(___)

Retorna o objeto de linha.

Descrição

Diferente de plot, line não limpa os eixos, não redefine os limites de modo especial e não avança a ordem de cores: apenas acrescenta um objeto ao que já existe. Isso é útil para anotar um gráfico com um segmento de referência ou a haste de uma seta.

Se ainda não houver eixos, um é criado. Cada chamada desenha uma única linha, com o primeiro vetor de coordenadas contra o segundo.

Argumentos de entrada

x, y, z: Vetores de coordenadas de mesmo comprimento.
Name, Value: Propriedades da linha, por exemplo 'Color', 'r'.

Argumentos de saída

h: Objeto de linha com as propriedades XData, YData, ZData, Color e outras.

Exemplo

Um segmento sobre um gráfico

plot(0:5, (0:5).^2)
h = line([0 5], [0 25], 'Color', 'r', 'LineStyle', '--');
h.XData
h.YData

Saída

ans = 1×2

     0     5
ans = 1×2

     0    25

Veja também

plot xline yline rectangle text