pxt-calliope/docs/reference/images/width.md
Thomas Denney 807e581c3d Addition of ignore notation
Some snippets are designed to show syntax errors or refer to earlier variables. In this case the automated checker needs to avoid compiling them
2016-08-10 13:43:48 +01:00

1.4 KiB

Width

The width function.

Get the width of an Image in columns.

images.createImage().width();

Parameters

  • none

Returns

  • Number - the number of columns in a image. This function returns 5 if the image has 1 frame, 10 for 2 frames, 15 for 3 frames and so on. Divide the number of columns by 5 to find out how many frames an image has (see example below).

The following example gets the width of img and stores it in the w variable:

~hide

let img = images.createImage(`
. . # . . . . . . .
. # . # . . . # . .
. . # . . . . . . .
. # . # . . . # . .
. . # . . . . . . .
`)

~

let w = img.width()

Example: show each frame

The following example uses the width function with a for loop to show each image frame on the screen:

let img2 = images.createImage(`
. . # . . . # # # # . # # # .
. # # . . . . . . # . . . # .
. . # . . . . . # . . . # . .
. . # . . . . # . . . . . # .
. . # . . . # # # # . # # # .
`)
for (let i = 0; i < img2.width() / 5; i++) {
    img2.showImage(i * 5)
    basic.pause(1000)
}

See also

show image, image, create image, scroll image, show animation