openmicroscopy/openmicroscopy — pull request #1194 by sbesson (2013-05-21 09:00:08+00:00)
Title: Add function to retrieve plane information from an image

See https://www.openmicroscopy.org/community/viewtopic.php?f=4&t=4842

Can be tested with the following scenarios:
- Return information for all planes

```
planeInfo = getPlaneInfo(session, imageId);
planeInfo = getPlaneInfo(session, getImages(session, imageId));
```

- Return information for the given (z, c, t) plane

```
planeInfo = getPlaneInfo(session, imageId, z, c, t);
planeInfo = getPlaneInfo(session, getImages(session, imageId), z, c, t);
```

- Return information for given planes arrays

```
planeInfo = getPlaneInfo(session, imageId, [], c, t);
planeInfo = getPlaneInfo(session, imageId, z, [], t);
planeInfo = getPlaneInfo(session, imageId, z, t, []);
planeInfo = getPlaneInfo(session, getImages(session, imageId), [], c, t);
planeInfo = getPlaneInfo(session, getImages(session, imageId), z, [], t);
planeInfo = getPlaneInfo(session, getImages(session, imageId), z, c, []);
```

- Throw exception
```
planeInfo = getPlaneInfo(session, -1);
planeInfo = getPlaneInfo(session, imageId, -1, c, t);
planeInfo = getPlaneInfo(session, imageId, z, -1, t);
planeInfo = getPlaneInfo(session, imageId, z, c, -1);
planeInfo = getPlaneInfo(session, imageId, sizeZ, c, t);
planeInfo = getPlaneInfo(session, imageId, z, sizeC, t);
planeInfo = getPlaneInfo(session, imageId, z, c, sizeT);
```