3.7.5.23 Img

LabTalk Object Type:

Internal

The img object provides script access for processing on image window, such as zooming the window, loading an image file, etc.

This object is introduced in Origin 2021b.

Properties:

Property Access Description
img.Current Read/write,
numeric

Get and set the current frame in video/multi-frame stacked image

img.ext$ Read only,
string

Get file type (file extension).

img.filesize Read only,
numeric

Get file size.

img.fps Read only,
numeric

Return the frames per second in video or a multi-frame image.

img.frames Read only,
numeric

Return number of frames in video/multi-frame stacked image.

img.GrayMax Read/Write,
numeric

Set the maximum value of the palette applied to the gray scale image. THe value should be 0 - 255.

img.height Read only,
numeric

Return the image width in pixel.

img.inc Read only,
numeric

Get and set the frame increment when click >> or << button. Default is 1.

img.info Read only,
numeric

Show or Hide the Information Bar at the top of the iamge window. 1 = show, 0 = hide.

img.link Read only,
numeric

Return the linked image type when insert to other window.

0 = no link,
1 = link as image object to a Graph/Worksheet/Matrix/Layout window,
2 = link as background to a Graph window,
3 = link to a worksheet cell,
4 = link to a matrix object.
img.max Read only,
numeric

For GeoTIFF image,return the Max values of the image.

img.mix Read only,
numeric

For GeoTIFF image,return the Mix values of the image.

img.media Read/Write,
numeric

Get or set whether the media type: 1 = single-frame image; 2 = multiple-frame image; 3 = video. Note that when setting media type, you can only switch between single frame and multi-frame.

img.nav Read/write,
numeric

Set or get image window stack navigation mode:

0 = None
1 = Thumbnails
2 = Image
3 = Slider
img.nancolor Read/Write,
numeric

Get/Set color for missing values. See Color List here.

img.palette$ Read/Write,
string

Set or get the color palette applied to a gray scale image. Use img.palette$=""; to remove palette.

For example, img.palette$="blue"; to apply built-in "blue" palette.

img.pause Read/write,
numeric

Pause video on click in video/multi-frame stacked image.

1 = Enable pausing video on mouse click.
0 = Default. Disable pausing video on click. One must click [O] button to pause.
img.path$ Read/write,
string

Get and set the path of the image source file. After setting a new path using this property, you will need to refresh the image window to see the update.

img.pixel Read/write,
numeric

Wether to show image as actual size.

1 = show image as actual size, showing pixels as 1 to 1. This is the default mode when an image window is created.
0 = not show image as actual size. Image will always fit to the window size.
img.savedata Read/write,
numeric

Wether to save the image to the image window.

1 = Save the image to the image window. The window serves as image container.
0 = Link the image to its source file. Only the connection is saved. The image will be excluded when saving the project.

See details about "linked file" vs. "image container" here.

img.unit$ Read/write,
string

Get/set the unit of the GeoTIFF image.

img.width Read only,
numeric

Return the image width in pixel.

img.XY$ Read/Write,
string

Get and set the XY coordinates mapping to the image. The coordinate string should arrange in the series of XFrom XTo YFrom YTo. The default unit of the coordinates is pixel (which can be set by img.XYUnit$).

img.XYUnit$ Read/write,
string

Get and set the unit of actual XY scale.

img.ZUnit$ Read/write,
string

Get and set the unit of image frames (Z dimension) in a multi-frame image. XYZ values of a single frame are the pixel values.

img.ZName$ Read/write,
string

Get and set the Long Name of image frames (Z dimension) in a multi-frame image.

Methods:

Method Description
img.fit(value) Use to fit window size to image.

0 = fit window to image
1 = image fit width of window
2 = image fit Height of Window

img.load(fname$)

Import the specified image file fname$ to the image window.

img.media(value) Return the image type:

0 = None
1 = Single Image
2 = Image Stack
3 = Video
4 = Linked Matrix Object

img.RevPal() Reverse the color palette applied to a gray scale image.
img.transfer(GraphName) Transfer the image inserted to a Graph window to a real Image window or inverse.
  • img.transfer(): Extract the image object inserted in the Graph window to a real Image window.
  • img.transfer(GraphName): Embed the image window to GraphName window as an object.

Refer to "Insert an Image File" document for details.

image.unit() Get and set the unit of an image.
  • img.unit()=; to get whether an image has unit: return 1 if has unit; return 0 if pixels
  • img.unit(0); to clear unit and reset back to pixels
  • i=img.unit(1, A); to convert 1 pixel to actual size, return value of Known Distance and put Unit of Lenght into %A. See details of setting scale of image on this page.

Samples:

Example 1

//Activate Image1 window. Get XY coordinates
string strxy$=img.xy$;
//Activate a Graph window you want to insert the image to
layer.addImg(image1, 8);