Once installed & enabled, the following options are available in Add-on preferences for I2M:
1. Tab Location
: Override the default "kei2m" tab name to relocate the add-on on the n-panel.
RGB instead of Alpha option
2. Click the LEFT button
(with the "Use RGB instead of Alpha" text) to activate this option.
3. Click the RIGHT button
(the color field) to specifiy which color is to be used instead of Alpha.
4. Material Cap
: Limits the amount of materials that can be generated by the Color 2 Material
Tip: You can mouse-over almost any item, such as buttons, for tooltips.
A simple "First Time" process to get you started:
1. Select which type of Mesh
you want to create. Use the default "Plane".
2. Click the Load Image(s) folder button
3. In the pop-up browser; Select an image
with an Alpha-channel in PNG, TIF, EXR, HDR or TGA format, and Load Image(s)
4. Click the "Image To Mesh" button
to generate a mesh from the loaded image(s).
A mesh object should now be generated at location 0,0,0.
If not, you can use the support form
, assuming you have read & followed all the information in this guide. Include any image used as an attachment, if possible.
The generated object will have UV texture projection
This is useful for further modeling without having to deal with UV's.
Geo Type Mode
Which type of geo conversion to use:
: Uses front image slot to generate a single plane of geometry.
: A Screw Modifier revolves one side of an image (front image slot), to a cylindrical shape.
: Uses 2-3 images (front + right/top) to carve out a rough 3d shape using Intersect, with 3 optional additional images for full texture projection coverage. Very basic, do not expect wonders!
Color 2 Material
: A Planar Mode that splits the mesh by color, and assigns materials based on the colors.
These modes share most of the their options.
All the shared options are included in the Plane Geo Type
The Screw & Boolean sections only contain mode-specific options.
Settings - Plane Geo Type
You can now tweak the settings in the Redo Panel
Determines the cut off point off the alpha value, in percent.
Do not use as slider! Use numerical keyboard input.
Tip: Should the Tolerance & Expand options be insufficient, you may need to manually adjust the alpha in an image editing app.
Expands or Contracts alpha cut-off point beyond the original image alpha borders.
In pixels (roughly). Zero to disable.
Tip: Tweak Opacity Tolerance value first - only use Expand Border if necessary.
The Work Resolution in tandem with Mesh Reduction
, are probably the most important settings.
Work Resolution refers to the internal pixel resolution used by I2M, which will probably be lower than the actual resolution of the image - for performance reasons. Keep this value as low as you can. Increase as a final step to ensure you have the necessary detail level.
NOTE: The last used Work Resolution will be used for any additional image(s) as well, unless you click the "Reset To Defaults" button or load a new scene.
Any value above 0 overrides the Work Resolution. The one value is used for both X&Y. Use with caution.
(Default): Automatically fits all resolutions to 1 Blender Unit (1 meter).
: Set custom mesh size/width.
: Calculate size based on set custom pixel size/width. Video example.
Vertex Color Mode
Aka 'Retro Pixel Graphics Mode': Each Work Resolution pixel makes up one face, like with Mesh Reduction set to "None", but uses Vertex Color
instead of texture(s). The shading mode will be set to display Vertex Maps automatically.
When using Vertex Color Mode, this options is available to adjust the color range, effectively limiting the "palette"
0 = No limit (full rgb) in Vertex Color Mode (Also Faster). Sensitive: Try steps of 0.05 (Also, very slow! Do not use as slider! Use numerical keyboard input!
This will determine how the contour and interior of the mesh is processed:
Tip: In most browsers, you can enlarge any image in this guide by Right Mouse button clicking the image and choosing "Open In New Tab".
: Reduces the interior surface, but not the contour.
(Default): Reduces both interior surface and contour.
: Reduces both and also applies a dissolve process to non-border edges. Slow.
: No reduction - Every pixel
(of the work resolution) becomes a quad.
Note: The complexity of the Alpha will also
have an effect on the processing time. High frequency detail / noise will increase processing time & mesh complexity. This is an example of complex alpha.
Sets object to smooth shade & Auto-smooth.
Will add Quick-n-Dirty Roughness and Bump nodes to the generated object's material - in addition to color. Based on the color input.
Apply All Modifiers
Applies the Screw (if used) & UV Projection Modifiers and removes created Empties. Leave off to leave modifier live (for live uv projection modeling etc).
Reset to defaults.
Settings - Screw Geo Type
A Screw Modifier revolves one side of an image (front image slot), to a cylindrical shape. (The image should be centered. Only one half will be used for mesh generation. UV will still be projected using the whole image.)
Tip: Use Dissolve Mesh Reduction
for a cleaner screw mesh result.
: Stretches the UV-projection to compensate for curvature issues.
Flip Screw Source-Side
: Screw will use either left or right side of the image to revolve around.
See Planar Geo Type
above for shared options.
Settings - Boolean Geo Type
Uses 2-3 images (front + right/top) to carve out a rough 3d shape using Intersect, with 3 optional additional images for full texture projection coverage. Very basic, do not expect wonders!
Note: Boolean Geo Type will automatically be set if you load more than one image slot.
: Check this to enable Auto-Fill slots by suffixes when loading. You only need to select the Front image to load all images in the same folder with the same name & valid suffixes: _front, _right, _top, _back, _left, _bottom.
Front Texture Only
: Will only use the Front image for texture projection.
See Planar Geo Type
above for shared options.
Color 2 Material Mode
Splits the mesh by the (single Plane) image colors, and assigns a unique material per color.
Material limit is set in I2M Add-on prefs.
Will only work with clearly distinct & separated colors. Best with no color gradients, including anti-aliasing.
: Will clean-up / smooth the color split boundaries.
Batch Process Folder
Click button to open a browser, select a folder to batch with the current/previous I2M settings.
Be sure to have set up I2M options as you want them (via a single operation first), before batching.
Does not work with Boolean Geo Type.