# OEMultiPageImageFile¶

class OEMultiPageImageFile


The OEMultiPageImageFile class supports the creation of multi-page images. The dimensions and orientation of the pages are determined when an OEMultiPageImageFile object is created. Pages are created by calling the OEMultiPageImageFile::NewPage method. See Figure: Schematic representation of an OEMultiPageImageFile object.

Schematic representation of an OEMultiPageImageFile object

Hint

We highly recommend to usage of the more convenient high-level OEReport class when generating multi-page images.

## Constructors¶

OEMultiPageImageFile(double pagewidth, double pageheight)


Creates an OEMultiPageImageFile object with a specified page width and height. Both the width and the height parameters have to be positive (non-zero) numbers.

OEMultiPageImageFile(unsigned int orientation, unsigned int imagesize)


Creates an OEMultiPageImageFile object with the given orientation and size.

orientation
Determine the orientation of the pages. This value has to be from the OEPageOrientation namespace.
imagesize
Determine the width and height of the pages. This value has to be from the OEPageSize namespace.

## GetOrientation¶

unsigned int GetOrientation() const


Returns the orientation of the pages. The return value is taken from the OEPageOrientation namespace.

## GetPage¶

OEImage *GetPage(unsigned int page)
const OEImage *GetPage(unsigned int page) const


Returns the $$p^{th}$$ page .

p
This value has to be in the range from 1 to OEMultiPageImageFile::NumPages().

Note

If $$p$$ page index is out of range, then the OEMultiPageImageFile::GetPage method returns a NULL pointer.

## GetPageHeight¶

double GetPageHeight() const


Returns the height of the pages.

## GetPageWidth¶

double GetPageWidth() const


Returns the width of the pages.

## GetPages¶

OESystem::OEIterBase<OEImage> *GetPages()
OESystem::OEIterBase<const OEImage> *GetPages() const


Returns an iterator over all pages stored in the OEMultiPageImageFile object.

## NewPage¶

OEImage &NewPage()


Returns a new page as an OEImage object.

## NumPages¶

unsigned int NumPages() const


Returns the number of pages stored in the OEMultiPageImageFile object.