## Class: QPixmap

> The QPixmap class helps hold an image in the form of off-screen image representation.

**This class is a JS wrapper around Qt's [QPixmap class](https://doc.qt.io/qt-5/qpixmap.html)**

A `QPixmap` provides ability to store an image in the memory.

**QPixmap inherits from [Component](api/Component.md)**

### Example

```javascript
const { QPixmap } = require("@nodegui/nodegui");

const imageUrl = "path/to/png";
const pixMap = new QPixmap(imageUrl);
```

### `new QPixmap(imageUrl?)`

- `imageUrl` string (_optional_). Absolute path of the image that needs to be loaded in the memory.

### Static Methods

QPixmap can access all the static methods defined in [Component](api/Component.md)

### Instance Properties

QPixmap can access all the instance properties defined in [Component](api/Component.md)

### Instance Methods

QPixmap can access all the instance methods defined in [Component](api/Component.md)

Additionally it also has the following instance methods:

#### `pixMap.load(imageUrl)`

loads an image from the url into memory as a Pixmap.
returns true if load was successful otherwise returns false.

- `imageUrl` string (_optional_). Absolute path of the image that needs to be loaded in the memory.

#### `pixMap.save(fileName, format)`

Saves the pixmap to the file with the given fileName using the specified image file format and quality factor. Returns `true` if successful; otherwise returns false.

The quality factor must be in the range `[0,100]` or -1. Specify 0 to obtain small compressed files, 100 for large uncompressed files, and -1 to use the default settings.

If format is 0, an image format will be chosen from fileName's suffix.

See also [Reading and Writing Image Files.](https://doc.qt.io/qt-5/qpixmap.html#reading-and-writing-image-files).

- `fileName` string.  
- `format` string. (_optional_).

#### `pixMap.scaled(width, height, aspectRatioMode?)`

Scales the pixmap to provided height and width with respect to aspectRatioMode.
This method doesnt mutate this pixmap and rather returns a new pixmap with new height and width.

- `width` number. Width in pixels for new pixmap.
- `height` number. Height in pixels for new pixmap.
- `aspectRatioMode` AspectRatioMode (_optional_). Specifies how scaling should happen. [AspectRatio is an enum from Qt](api/QtEnums.md)