# Matplot properties

description of the Matplot entities properties

## Description

The `Matplot` entity is a leaf of the graphics entities hierarchy. It represents 2D plots of surface using colors and images (see `Matplot` and `Matplot1`).

parent:

  this property contains the handle of the parent. The parent of the `Matplot` entity should be of the type `"Axes"`.

children:

  this property contains a vector with the `children` of the handle. However, `Matplot` handles currently do not have any `children`.

visible:

  this field contains the `visible` property value for the entity. It should be `"on"` or `"off"` . By default, the plot is visible, the property's value is `"on"`. If `"off"` the plot is not drawn on the screen.

data:

  this field defines a [`m`x`n`] `color` data matrix using the current colormap. The color associated to `color(i,j)` is used do draw a small square of length 1 with center at location `(x=j,y=(m-i+1))`.

clip_state:

  this field contains the `clip_state` property value for the `Matplot`. It should be :

  - `"off"` this means that the `Matplot` is not clipped.

  - `"clipgrf"` this means that the `Matplot` is clipped outside the `Axes` box.

  - `"on"` this means that the `Matplot` is clipped outside the rectangle given by property `clip_box`.

clip_box:

  this field is to determinate the `clip_box` property. By default its value should be an empty matrix if `clip_state` is `"off"`. Other cases the vector `[x,y,w,h]` (upper-left point width height) defines the portions of the `Matplot` to display, however `clip_state` property value will be changed.

user_data:

  this field can be use to store any scilab variable in the `Matplot` data structure, and to retreive it.

## Examples

    Matplot((1:xget("lastpattern")))
    e=gce(); // get current entity

    e.data=e.data($:-1:1) // reverse order

## See Also

- set
- get
- delete
- grayplot
- Matplot
- Matplot1
- graphics_entities
- grayplot_properties