1. Introduction

IKoni is an all-in-one tool for image matting, cropping, and icon generation, quickly extracting images and generating application icons of various sizes, with support for iOS 18+ icon generation. Whether you need to remove image backgrounds or create standard macOS or iOS icon sets for your applications, IKoni makes it easy.

2. Feature Overview

• Image Matting: Automatically identify the main subject in the image, remove the background, and generate images with transparent backgrounds
• macOS Icon Generation: Generate standard macOS application icons (.icns format)
• iOS Icon Generation: Generate standard iOS application icon sets (AppIcon.appiconset)
• iOS 18+ Support: Support for generating iOS 18+ dark mode icons
• Rounded Corner Cropping: Support for rounded corner cropping and custom size output to meet icon requirements for different scenarios

3. Getting Started

3.1 Loading Images

You can load images into IKoni in two ways:

• Drag and Drop: Directly drag and drop image files into the image area of the main interface
• Select Image: Click the "Select Image" button in the image area to choose an image from the file browser

Supported image formats: PNG, JPEG, TIFF

3.2 Setting Output Path

Before performing any operation, you need to specify where the output files will be saved:

• The program will automatically try to set a default path (usually in your Pictures/IKoni folder)
• If you need to change it, click the "Browse..." button to select another folder

4. Using Features

4.1 Image Matting

The image matting feature can automatically identify the main subject in the image and remove the background:

1. Load the image you want to process
2. Confirm that the output path is set
3. Click the "Mat Image" button
4. Wait for the processing to complete (processing time depends on the size and complexity of the image)
5. After processing is complete, you can view the result in the preview area and click the "View in Finder" button to find the saved file

The matting result will be saved in PNG format, preserving transparency information.

4.2 Generating macOS Icons

This feature creates standard macOS application icons:

1. Load the image you want to use as an icon
2. Confirm that the output path is set
3. Click the "Generate macOS Icon" button
4. Wait for the processing to complete
5. After processing is complete, an icon.icns file will be created in the specified output path

The generated .icns file contains icons in the following sizes: 16x16, 32x32, 64x64, 128x128, 256x256, 512x512, and 1024x1024, as well as their @2x versions.

4.3 Generating iOS Icons

This feature creates iOS application icon sets that comply with Apple's specifications:

1. Load the image you want to use as an icon
2. Confirm that the output path is set
3. Click the "Generate iOS Icon" button
4. Wait for the processing to complete
5. After processing is complete, a folder named AppIcon.appiconset will be created in the specified output path

The generated icon set contains all the sizes needed for iOS devices, including icons for iPhone, iPad, and the App Store, as well as their @2x and @3x versions. This icon set can be dragged directly into the Assets.xcassets of your Xcode project.

4.4 iOS 18+ Dark Mode Icons

This feature supports generating dark mode icons compatible with iOS 18+:

1. Load the image you want to use as an icon
2. Confirm that the output path is set
3. Check the "Generate Dark Mode Icons" option in the settings
4. Click the "Generate iOS Icon" button
5. After processing is complete, dark mode icon variants will be included in the generated AppIcon.appiconset

The generated dark mode icons can help your application provide a better visual experience when users enable dark mode.

4.5 Rounded Corner Cropping and Custom Sizes

This feature allows you to customize the corner radius and size of your output icons:

1. Load the image you want to process
2. Adjust the "Corner Radius" slider in the settings panel
3. If you need a custom size, enter the desired width and height in the "Custom Size" area
4. Click the "Apply" button to preview the effect
5. Once you are satisfied with the result, click the "Export" button to save it

This feature is particularly suitable for icon requirements with specific sizes or corner styles, such as website icons, custom application icons, etc.

5. Best Practices

5.1 Image Selection Recommendations

• Use high-quality, high-resolution original images
• Choose images with clear subjects and high contrast with the background for the best matting results
• For icon generation, it is recommended to use square images with a resolution of at least 1024x1024

5.2 Matting Tips

• For complex images, you may need to pre-process them in an image editing software to enhance the contrast between the subject and the background
• If the automatic matting result is not ideal, try adjusting the image lighting or contrast and try again
• Processed images will be saved in PNG format, preserving the transparent background

6. Frequently Asked Questions

Q: Why is the matting result not ideal?

A: The matting effect is influenced by image quality, subject clarity, and background complexity. For complex images, you may need to use professional image editing software for manual matting.

Q: Where are the generated icons?

A: Icons are saved in the output path you specified. macOS icons are saved as icon.icns files, and iOS icons are saved in the AppIcon.appiconset folder. After processing is complete, you can click the "View in Finder" button to directly open the output folder.

Q: How do I use the generated iOS icons in my Xcode project?

A: Drag the generated AppIcon.appiconset folder into the Assets.xcassets of your Xcode project, and Xcode will automatically recognize it as an icon set.

Q: Why can't the program access certain folders?

A: For security reasons, macOS restricts applications from accessing certain system folders. Please choose folders under your user directory, such as Documents, Downloads, or Pictures.

7. Contact Us

If you have any questions, suggestions, or feedback, please contact us through the following channels: