✂️ Robert's Image Cropper

Basic Usage:

1. Click "📁 Select Images" to upload one or more images.
2. Choose "Single Mode" for individual cropping or "Bulk Mode" for multiple images.
3. Adjust "Crop Size" (width and height) as needed.
4. **NEW:** Check "1:1 Pixel Crop" if you want the output to be exactly the "Crop Size" dimensions, directly sampling those pixels from the original image at a 1:1 ratio. The preview overlay will also adjust to show this true pixel scale. If unchecked, the output will also match "Crop Size" dimensions but will resample a larger area of the original image for higher visual quality, and the preview overlay will reflect the output dimensions.
5. Select a crop "Shape": "Square", "Circle", or "Custom Mask". **NOTE:** If you select "Custom Mask" and upload a mask, the "Crop Size" will automatically update to match the mask's dimensions.
6. Drag the image on the canvas to position it within the crop overlay.
7. Click "✂️ Crop Current" to crop the active image (or press Enter). In Bulk Mode, use "Next" or the → arrow key to go through images.
8. In Bulk Mode, after cropping all (or pressing Enter for "Crop All"), click "💾 Download All" to get a zip file containing all cropped images. In Single Mode, the image downloads immediately.

Using Custom Mask:

1. Select the "🎭 Custom Mask" shape. The "🎭 Upload Mask" button will appear.
2. Click "🎭 Upload Mask" to select a black and white image (PNG recommended) to use as your mask. White areas will be visible, black areas transparent. **The Crop Size will automatically update to the dimensions of your uploaded mask.**
3. Adjust the image and crop size as usual on the canvas.
4. Click "✂️ Crop Current" to apply the mask and crop.

For best results with custom masks, use simple, high-contrast black and white images. The mask will be scaled to your defined output size (which is always your "Crop Size" dimensions). All bulk-cropped files will be named `originalnamecrop.png` (e.g., `image.jpg` becomes `imagecrop.png`).