# image.copy

image.copy is a function that is part of image.

The function returns a copy of the input image scaled to fit the specified pixel width and height.
The width and height default to the size of the input image.
The routine raises an error if the new width or height are less than or equal to 0 or greater than 25000.
The routine raises an error if there is insufficient memory to create the new image.

This has been introduced in TI-Nspire OS 3.0 (Changes).

## Syntax

image.copy(image, width, height)

Parameter Type Description
image
TI.Image The original image.
width
number The width of the new image
height
number The height of the new image

## Example

newImage = image.copy(oldImage, 10, 15)

## Good to know

To make a relative scale, use
image.copy(image, scaleX * image.width(image), scaleY * image.height(image))