---
name: "MPE_Draw_line"
section: "4"
platform: "linux"
package: "mpi-doc"
version: "1.2.7-9.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/MPE_Draw_line"
---

# MPE\_Draw\_line(4)

Draws a line on an X11 display

## NAME

MPE\_Draw\_line -  Draws a line on an X11 display

## SYNOPSIS

```
#include "mpe.h"
int MPE_Draw_line( handle, x1, y_1, x2, y_2, color )
MPE_XGraph handle;
int        x1, y_1, x2, y_2;
MPE_Color  color;
```

## INPUT PARAMETERS

- **handle**

  \- MPE graphics handle

- **x1,y\_1**

  \- pixel position of one end of the line to draw.  Coordinates are  upper-left origin (standard X11)

- **x2,y\_2**

  \- pixel position of the other end of the line to draw.  Coordinates  are upper-left origin (standard X11)

- **color**

  \- Color  **index** value.  See  *MPE\_MakeColorArray* .

  By default, the colors *MPE\_WHITE* ,  *MPE\_BLACK* ,  *MPE\_RED* ,  *MPE\_YELLOW* ,  *MPE\_GREEN* ,  *MPE\_CYAN* , *MPE\_BLUE* ,   *MPE\_MAGENTA* ,  *MPE\_AQUAMARINE* ,  *MPE\_FORESTGREEN* ,  *MPE\_ORANGE* ,  *MPE\_VIOLET* ,  *MPE\_BROWN* ,  *MPE\_PINK* ,  *MPE\_CORAL* and  *MPE\_GRAY* are defined.

## NOTES FOR FORTRAN INTERFACE

The Fortran interface to this routine is different from its C counterpart and it has an additional argument, ierr, at the end of the argument list, i.e. the returned function value (the error code) in C interface is returned as the additional argument in Fortran interface.  The Fortran interface is invoked with the CALL statement.

All MPI and MPE objects, MPI\_Comm, MPE\_XGraph and MPE\_Color, are of type INTEGER in Fortran.

## LOCATION

mpe\_graphics.c