Download the PHP package reallifekip/grid-map without Composer
On this page you can find all versions of the php package reallifekip/grid-map. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download reallifekip/grid-map
More information about reallifekip/grid-map
Files in reallifekip/grid-map
Package grid-map
Short Description A lightweight grid-based area mapping library for defining rectangular regions in a cell grid.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package grid-map
GridMap
Language: English | 繁體中文
A lightweight, zero-dependency PHP micro-library for grid slicing. It divides a fixed-size plane (e.g., 1920x1080 canvas, video wall, media composition, dashboard, or layout system) into a grid according to specified proportions, then sequentially “fills” rectangular slices into available cells and returns their pixel coordinates and sizes.
GridMap uses a simple row-major first-fit scanning algorithm to find the first available area that can fit a slice of the requested grid width/height. If successful, the area is marked as occupied and the next slice is processed. If a slice cannot fit, an exception is thrown.
✨ Features Overview
- ✅ Single class, easy to understand and integrate
- ✅ No extensions required: pure PHP ≥ 8.0
- ✅ Define slices in “grid units” and automatically convert to pixel coordinates
x,y,width,height - ✅ Deterministic first-fit placement, reproducible results
- ✅ Uses integer division
intdivto avoid floating-point rounding errors - ✅ Automatically detects unplaceable slices and throws clear exceptions
- ✅ Suitable for dynamic layouts, video walls, auto-layout suggestions
- ⚠️ If not fully filled, triggers an
E_USER_NOTICEabout remaining empty cells
📦 Installation
🚀 Quick Start
Example output (actual may vary depending on allocation):
The above width/height are actual pixels, calculated by dividing
(total_canvas / grid_count). For example:1920/24=80,1080/12=90. A 6-grid width = 6 × 80 = 480 pixels; a 6-grid height = 6 × 90 = 540 pixels.
🧠 Core Concept
| Term | Description |
|---|---|
area_w, area_h |
Total canvas size (pixels) |
grids_w, grids_h |
Number of grid divisions (horizontal / vertical) |
slice [cw, ch] |
Slice rectangle defined in grid units, not pixels |
return areas[] |
Each placed slice, with x,y,width,height (px) |
Steps (simplified):
- Compute all grid line coordinates:
cols[x] = intdiv(x * area_w, grids_w),rows[y] = intdiv(y * area_h, grids_h) - Use a 1D array to mark whether each cell is occupied
-
For each slice:
- Scan row-major for the first fitting location
- Check if all covered cells are free
- Mark occupied and convert to pixel rectangle
- Throw exception if slice cannot be placed
- If leftover space exists, trigger an
E_USER_NOTICE(informational, can be ignored or handled)
✅ Example Use Cases
| Use Case | Description |
|---|---|
| Media/Video wall | Automatically arrange multiple video sources |
| Video compositing | Map multiple tracks into fixed canvas coordinates |
| Realtime dashboard | Auto-generate initial layouts for widget cards |
| Game/Level editor | Plan map or scene block placements |
| Ad screen layout | Place multiple ad creatives into grid layout |
🛠️ Advanced Example: Mixed Sizes & Error Handling
⚠️ Notes
- Each slice must be
[cw, ch]of two positive integers cwcannot exceedgrids_w,chcannot exceedgrids_h- Strategy is “first feasible placement”: not optimized for space, just deterministic
- For “optimal packing / rotation / reordering”, preprocess slices (e.g., sort by size)
- Returned array indexes correspond 1-to-1 with input slice order
- To ignore the unfilled notice, define a custom error handler or suppress
E_USER_NOTICE
🔍 Return Data Format
🧪 Testing Suggestions (example)
You may write PHPUnit tests to verify:
- Slice count matches returned array count
- No overlapping rectangles (check original cell intersections)
- When all slices fit, occupied grid count =
grids_w * grids_h - Oversized slices trigger
Exception
📄 License
This package uses the MIT License – Free for commercial use / modification / distribution, just keep copyright notice.
👤 Developer Info
Author: Kip ([email protected]) GitHub: @ReallifeKip
If this project helps you: feel free to Star, share, or suggest improvements!
