Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.simular.ai/llms.txt

Use this file to discover all available pages before exploring further.

Class: Screenshot

Defined in: index.d.ts:881 Represents a screenshot capture.

Constructors

Constructor

new Screenshot(): Screenshot

Returns

Screenshot

Accessors

dimensions

Get Signature

get dimensions(): [number, number]
Defined in: index.d.ts:910 Returns the screenshot dimensions as [width, height] in pixels.
Returns
[number, number]

Methods

addGrid()

addGrid(width, height): void
Defined in: index.d.ts:889 Draws a cross-hair grid on the image. Grid squares have the specified width and height.

Parameters

width
number
height
number

Returns

void

base64()

base64(): string
Defined in: index.d.ts:917 Returns the image encoded as a base64 data URL. The result includes the MIME prefix, for example data:image/png;base64,... or data:image/jpeg;base64,....

Returns

string

compress()

compress(quality): void
Defined in: index.d.ts:896 Compress the image by converting it to JPEG with the specified quality. The quality is a value between 1 and 100. 1 is the lowest possible quality and 100 is the highest quality.

Parameters

quality
number

Returns

void

ground()

ground(model, concept): [number, number]
Defined in: index.d.ts:939 Locate concept on this screenshot using the given grounding model and return the corresponding global physical pixel coordinates [x, y]. The output can be fed directly to primitives that expect global screen coordinates. Equivalent to model.ground(screenshot, concept).

Parameters

model
GroundingModel
concept
string

Returns

[number, number]

save()

save(path): void
Defined in: index.d.ts:883 Path includes the file name and the extension.

Parameters

path
string

Returns

void

shrink()

shrink(nwidth, nheight): void
Defined in: index.d.ts:908 Resizes this image if it is larger than the desired size. The image’s aspect ratio is preserved. The image is scaled to the maximum possible size that fits within the bounds specified by nwidth and nheight. This method operates on pixel channel values directly without taking into account color space data. We commonly use this to resize the image to 1920x1080.

Parameters

nwidth
number
nheight
number

Returns

void

toGlobalPhysicalPixels()

toGlobalPhysicalPixels(x, y, coordType): [number, number]
Defined in: index.d.ts:930 Converts a point in this screenshot to global physical pixel coordinates. Screenshots may represent only part of a display, and displays may use different scale factors. Use this to map (x, y) to the corresponding global physical pixel position (for example, when moving the mouse to the same on-screen point). See ScreenshotCoordinateType for how coord_type affects interpretation of (x, y).

Parameters

x
number
y
number
coordType
ScreenshotCoordinateType

Returns

[number, number]