Minimal Example
from sikuligo import Pattern, Screen
screen = Screen()
try:
match = screen.click(Pattern("assets/pattern.png").exact())
print(f"clicked match target at ({match.target_x}, {match.target_y})")
finally:
screen.close()
What The Main Objects Do
Screen()starts in auto mode and returns a live screen session.Pattern("...")describes the image target and matching rules.Matchexposes geometry, score, and resolved target coordinates.screen.region(x, y, w, h)creates a bounded search area when you do not want to search the full screen.
Common Variations
Search Before Clicking
from sikuligo import Pattern, Screen
screen = Screen()
try:
match = screen.find(Pattern("assets/pattern.png").exact())
print(match.score)
finally:
screen.close()
Use A Region
from sikuligo import Pattern, Screen
screen = Screen()
try:
region = screen.region(100, 100, 800, 600)
match = region.wait(Pattern("assets/pattern.png"), timeout_millis=3000)
print(match.target_x, match.target_y)
finally:
screen.close()