stage-js/docs/pages/api/classes/Atlas.md

2D HTML5 Rendering and Layout

# Class: Atlas

Textures are used to clip and resize image objects.

## Extends

- [`ImageTexture`](/api/classes/ImageTexture)

## Constructors

### new Atlas()

> **new Atlas**(`def`): [`Atlas`](/api/classes/Atlas)

#### Parameters

• **def**: [`AtlasDefinition`](/api/interfaces/AtlasDefinition) = `{}`

#### Returns

[`Atlas`](/api/classes/Atlas)

#### Overrides

[`ImageTexture`](/api/classes/ImageTexture).[`constructor`](/api/classes/ImageTexture#constructors)

## Methods

### draw()

#### draw(context)

> **draw**(`context`): `void`

Defer draw spec to texture config. This is used when a sprite draws its textures.

##### Parameters

• **context**: `CanvasRenderingContext2D`

##### Returns

`void`

##### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`draw`](/api/classes/ImageTexture#draw)

#### draw(context, dx, dy, dw, dh)

> **draw**(`context`, `dx`, `dy`, `dw`, `dh`): `void`

This is probably unused.
Note: dx, dy are added to this.dx, this.dy.

##### Parameters

• **context**: `CanvasRenderingContext2D`

• **dx**: `number`

• **dy**: `number`

• **dw**: `number`

• **dh**: `number`

##### Returns

`void`

##### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`draw`](/api/classes/ImageTexture#draw)

#### draw(context, sx, sy, sw, sh, dx, dy, dw, dh)

> **draw**(`context`, `sx`, `sy`, `sw`, `sh`, `dx`, `dy`, `dw`, `dh`): `void`

This is used when a piped texture passes drawing to it backend.
Note: sx, sy, dx, dy are added to this.sx, this.sy, this.dx, this.dy.

##### Parameters

• **context**: `CanvasRenderingContext2D`

• **sx**: `number`

• **sy**: `number`

• **sw**: `number`

• **sh**: `number`

• **dx**: `number`

• **dy**: `number`

• **dw**: `number`

• **dh**: `number`

##### Returns

`void`

##### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`draw`](/api/classes/ImageTexture#draw)

***

### getHeight()

> **getHeight**(): `number`

#### Returns

`number`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`getHeight`](/api/classes/ImageTexture#getheight)

***

### getWidth()

> **getWidth**(): `number`

#### Returns

`number`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`getWidth`](/api/classes/ImageTexture#getwidth)

***

### load()

> **load**(): `Promise`\<`void`\>

#### Returns

`Promise`\<`void`\>

***

### select()

> **select**(`query`?): [`TextureSelection`](/api/classes/TextureSelection)

#### Parameters

• **query?**: `string`

#### Returns

[`TextureSelection`](/api/classes/TextureSelection)

***

### setDestinationCoordinate()

> **setDestinationCoordinate**(`x`, `y`): `void`

#### Parameters

• **x**: `number`

• **y**: `number`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setDestinationCoordinate`](/api/classes/ImageTexture#setdestinationcoordinate)

***

### setDestinationDimension()

> **setDestinationDimension**(`w`, `h`): `void`

#### Parameters

• **w**: `number`

• **h**: `number`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setDestinationDimension`](/api/classes/ImageTexture#setdestinationdimension)

***

### setPadding()

> **setPadding**(`padding`): `void`

Add padding to the image texture. Padding can be negative.

#### Parameters

• **padding**: `number`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setPadding`](/api/classes/ImageTexture#setpadding)

***

### setSourceCoordinate()

> **setSourceCoordinate**(`x`, `y`): `void`

#### Parameters

• **x**: `number`

• **y**: `number`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setSourceCoordinate`](/api/classes/ImageTexture#setsourcecoordinate)

***

### setSourceDimension()

> **setSourceDimension**(`w`, `h`): `void`

#### Parameters

• **w**: `number`

• **h**: `number`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setSourceDimension`](/api/classes/ImageTexture#setsourcedimension)

***

### setSourceImage()

> **setSourceImage**(`image`, `pixelRatio`): `void`

#### Parameters

• **image**: `TextureImageSource`

• **pixelRatio**: `number` = `1`

#### Returns

`void`

#### Inherited from

[`ImageTexture`](/api/classes/ImageTexture).[`setSourceImage`](/api/classes/ImageTexture#setsourceimage)