# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English version of the page.

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

## Creating Line Animations

This example shows how to use `animatedline` to create an animation of a line that gets longer in every frame.

### Create an Animated Line

The `animatedline` function creates an object that is designed specifically for line animations. Initially, the animated line object is empty, so MATLAB� does not plot the line.

```N = 30; x = linspace(0,20,N); y = x - 0.05*x.^2; figure l = animatedline ```
```l = AnimatedLine with properties: Color: [0 0 0] LineStyle: '-' LineWidth: 0.5000 Marker: 'none' MarkerSize: 6 MarkerFaceColor: 'none' MaximumNumPoints: 1000000 Use GET to show all properties ```

### Add Points to Animated Line

Use `addpoints` to add an additional point or vector of points to the animated line. MATLAB adds the additional points onto your animated line making your line longer.

```addpoints(l,x(1:5),y(1:5)) % add first 5 points to the line ```

### Create Line Animation

Use `addpoints` within a loop to create a line animation. To control the speed of your line animation, use `pause` after you add a point or a set of points. To prevent the limits of the axes from changing with each added set of points, set the x and y limits before the loop.

```xlim([0 20]) % set x limits ylim([0 5]) % set y limits for ix = 5:5:N-5 addpoints(l,x(ix+1:ix+5),y(ix+1:ix+5)) % add the next 5 points drawnow % refresh the image on screen pause(0.2) % control animation speed snapnow % (required for published document only) end ```

### Customize Animated Line Appearance

The `animatedline` function accepts optional input arguments to specify the properties of the line, such as `Color`, `Marker`, and `LineStyle`. To change the properties of the animated line after its created, use dot notation syntax `object.PropertyName`.

```l2 = animatedline('Color','r'); addpoints(l2,x(1:5),y(1:5)) l2.Marker = '*'; ```

### Get Points from Animated Line

Use the function `getpoints` to return the coordinates of all the points in the animated line.

```[x,y] = getpoints(l2) ```
```x = 0 0.6897 1.3793 2.0690 2.7586 y = 0 0.6659 1.2842 1.8549 2.3781 ```

### Get All Properties of Animated Line

Graphics objects in MATLAB have many properties. To see all the properties of an animated line object, use the `get` command.

```get(l2) ```
``` AlignVertexCenters: 'off' Annotation: [1x1 matlab.graphics.eventdata.Annotation] BeingDeleted: 'off' BusyAction: 'queue' ButtonDownFcn: '' Children: [0x0 GraphicsPlaceholder] Clipping: 'on' Color: [1 0 0] CreateFcn: '' DeleteFcn: '' DisplayName: '' HandleVisibility: 'on' HitTest: 'on' Interruptible: 'on' LineStyle: '-' LineWidth: 0.5000 Marker: '*' MarkerEdgeColor: 'auto' MarkerFaceColor: 'none' MarkerSize: 6 MaximumNumPoints: 1000000 Parent: [1x1 Axes] PickableParts: 'visible' Selected: 'off' SelectionHighlight: 'on' Tag: '' Type: 'animatedline' UIContextMenu: [0x0 GraphicsPlaceholder] UserData: [] Visible: 'on' ```