---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/layer.tile.CanvasTile.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/layer.tile.CanvasTile.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/en/llms.txt

# layer.tile.CanvasTile

Extends [ICanvasTile](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md).

Image canvas tile. Can draw the specified image via the drawImage method for the 2d context of the canvas element.

[Constructor](#constructor-summary) | [Fields](#properties-summary) | [Events](#events-summary) | [Methods](#methods-summary)

## Constructor {#constructor-summary}

```javascript
layer.tile.CanvasTile(url[, options[, renderOptions]])
```

Creates an image canvas tile. Accessible in the storage for tile classes by the key "default#canvas".

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`url`](#param-url)[*](*star) | — | Type: String

URL of the image. ||
|| [`options`](#param-options) | — | Type: Object

Options. ||
|| [`options.notFoundTile`](#param-options.notFoundTile) | null | Type: String\|null

Option that specifies the URL for downloading an image if the tile image didn't load. If the value is null, a standard tile is displayed with a text message. For transparent tiles, the notFoundTile option is not applied, and nothing is shown in place of tiles that didn't load. ||
|| [`options.tileAnimationDuration`](#param-options.tileAnimationDuration) | — | Type: Number

Duration of animation of tile transparency. The default value depends on the browser. ||
|| [`renderOptions`](#param-renderOptions) | — | Type: Object

Rendering parameters. ||
|| [`renderOptions.tileNumber`](#param-renderOptions.tileNumber) | — | Type: Number[] ||
|| [`renderOptions.tileZoom`](#param-renderOptions.tileZoom) | — | Type: Number ||
|#

\* Mandatory parameter/option.

## Fields {#properties-summary}

#|
|| **Name** | **Type** | **Description** ||
|| [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventManager.md) | Event manager.

Inherited from [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventEmitter.md#events). ||
|#

## Events {#events-summary}

#|
|| **Name** | **Description** ||
|| [ready](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#event-ready) | Tile ready event.

Inherited from [ITile](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#event-ready). ||
|#

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [destroy](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#destroy)() | | Destroys the tile.

Inherited from [ITile](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#destroy). ||
|| [isReady](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#isReady)() | Boolean | Checks tile readiness.

Inherited from [ITile](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ITile.md#isReady). ||
|| [renderAt](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt)([context](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt-param-context), [canvasSize](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt-param-canvasSize), [bounds](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt-param-bounds)[, [animate](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt-param-animate)]) | | Draws an image tile in the canvas object's 2d context.

Inherited from [ICanvasTile](https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICanvasTile.md#renderAt). ||
|#