---
name: "MPE_Fill_rectangle"
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_Fill_rectangle"
---

# MPE\_Fill\_rectangle(4)

Draws a filled rectangle on an X11 display

## NAME

MPE\_Fill\_rectangle -  Draws a filled rectangle on an X11 display

## SYNOPSIS

```
#include "mpe.h"
int MPE_Fill_rectangle( handle, x, y, w, h, color )
MPE_XGraph handle;
int        x, y, w, h;
MPE_Color  color;
```

## INPUT PARAMETERS

- **handle**

  \- MPE graphics handle

- **x,y**

  \- pixel position of the upper left (low coordinate) corner of the  rectangle to draw.

- **w,h**

  \- width and height of the rectangle

- **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

This uses the X11 definition of width and height, so you may want to add 1 to both of them.

## 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