PHPackages                             mgrechanik/image-points-searcher - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. mgrechanik/image-points-searcher

ActiveLibrary[Image & Media](/categories/media)

mgrechanik/image-points-searcher
================================

This library allows to find the coordinates of the points you are looking for on an image

1.0.1(2y ago)028BSD-3-ClausePHPPHP ^8.0

Since Nov 8Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mgrechanik/image-points-searcher)[ Packagist](https://packagist.org/packages/mgrechanik/image-points-searcher)[ RSS](/packages/mgrechanik-image-points-searcher/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

Searching for points on image
=============================

[](#searching-for-points-on-image)

[Русская версия](docs/README_ru.md)

Table of contents
-----------------

[](#table-of-contents)

- [Goal](#goal)
- [Demo](#demo)
- [Installing](#installing)
- [Search for points](#search)
- [Display search result](#display-result)

---

Goal
-----

[](#goal-)

This library allows to find the coordinates of the points you are looking for on an image (`jpg` format).

The point is the set of nearby pixels of choosen color.

For example, when you draw a graph on the image, we will find it's vertices.

Out of the box we have two strategies to determite our points.

1. `DifferentColorsStrategy` - when the point is different from background color. Default behavior. See Demo, picture 1.
2. `ChoosenColorStrategy` - when point is defined by it's exact color. See Demo, picture 2.

You can create your own strategy and use it.

Points could be of different size, so they could be easily seen, not just 1px size. We use parameter `Searcher::$margin` to determine all those pixels as one point.

The result of the search work is an array of points, represented by their X and Y coordinates.

We also give you `ImageResult`, who creates the image of the search result:

- We can add labels to points we found
- The borders of the points we found could be shown to better understand search process
- We could draw a path between points

---

Demo
-----

[](#demo-)

Determine points with `DifferentColorsStrategy` strategy , **Picture 1**: [![Determine points on image](https://raw.githubusercontent.com/mgrechanik/image-points-searcher/main/docs/first.jpg "Determine points on image")](https://raw.githubusercontent.com/mgrechanik/image-points-searcher/main/docs/first.jpg)

Determine points with `ChoosenColorStrategy` strategy, **Picture 2**: [![Determine points on image](https://raw.githubusercontent.com/mgrechanik/image-points-searcher/main/docs/second.jpg "Determine points on USA map image")](https://raw.githubusercontent.com/mgrechanik/image-points-searcher/main/docs/second.jpg)

---

Installing
-----------

[](#installing-)

#### Installing through composer:

[](#installing-through-composer)

The preferred way to install this library is through composer.

Either run

```
composer require --prefer-dist mgrechanik/image-points-searcher

```

or add

```
"mgrechanik/image-points-searcher" : "~1.0.0"

```

to the require section of your `composer.json`.

---

Search for points
------------------

[](#search-for-points--)

#### Search for points with `DifferentColorsStrategy` strategy

[](#search-for-points-with-differentcolorsstrategy-strategy)

```
try {
  $searcher = new \mgrechanik\imagepointssearcher\Searcher(
    './images/graph.jpg'
  );
  $count = $searcher->run();
  print 'Found - ' . $count;
  $points = $searcher->getPoints();
  var_dump($points);
} catch (Exception $e) {

}
```

The result will be like this:

```
Found - 2
[
	['x' => 10, 'y' => 10],
	['x' => 80, 'y' => 80],
]

```

#### Search for points with `ChoosenColorStrategy` strategy

[](#search-for-points-with-choosencolorstrategy-strategy)

```
try {
  $searcher = new \mgrechanik\imagepointssearcher\Searcher(
    './images/usa.jpg',
    new \mgrechanik\imagepointssearcher\ChoosenColorStrategy(60, 132, 253)
  );
  $count = $searcher->run();
  print 'Found - ' . $count;
  $points = $searcher->getPoints();
  var_dump($points);
} catch (Exception $e) {

}
```

---

Display search result
----------------------

[](#display-search-result--)

```
$imageResult = new \mgrechanik\imagepointssearcher\ImageResult($searcher);

// We can set colors
$imageResult->setLabelsColor(1, 14, 230);
$imageResult->setLinesColor(255, 33, 73);
$imageResult->setMarginsColor(255, 106, 0);

// Draw default labels
$imageResult->drawLabels();
// Draw labels with the text we want
$imageResult->drawLabels(function($key, $point) { return "{$point['x']},{$point['y']}";});

// Draw borders of the points we found
$imageResult->drawMargins();

// Draw the path between points
$imageResult->drawPath([2,9,20,28,41,48,44]);

// Save the result as the image. See Demo.
$imageResult->save('./images/result.jpg');
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~125 days

Total

2

Last Release

790d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/83919f51df37e9d419895f01a9d4f55ef44c0dc764aec2a57081b6c5e2a3ed8a?d=identicon)[mgrechanik](/maintainers/mgrechanik)

---

Top Contributors

[![mgrechanik](https://avatars.githubusercontent.com/u/5772506?v=4)](https://github.com/mgrechanik "mgrechanik (11 commits)")

---

Tags

phpimagegraphcoordinatestspsearch points on image

### Embed Badge

![Health badge](/badges/mgrechanik-image-points-searcher/health.svg)

```
[![Health](https://phpackages.com/badges/mgrechanik-image-points-searcher/health.svg)](https://phpackages.com/packages/mgrechanik-image-points-searcher)
```

###  Alternatives

[stefangabos/zebra_image

A single-file, lightweight PHP library designed for efficient image manipulation featuring methods for modifying images and applying filters

141110.4k6](/packages/stefangabos-zebra-image)[dantsu/php-image-editor

PHP library to easily edit image with GD extension.

34152.1k2](/packages/dantsu-php-image-editor)[lciolecki/php-image-optimizer

PHP image file optimizer (uses https://github.com/bensquire/php-image-optim)

347.4k](/packages/lciolecki-php-image-optimizer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)