PIC to 3D Mesh Blender Add-on Documentation

Overview

PIC to 3D Mesh is a Blender add-on that facilitates the generation of 3D meshes from images or pictures directly within Blender. This add-on leverages the capabilities of the https://www.csm.ai/ service to convert images into 3D meshes.

Installation

1. Download the "PIC_to_3D_Mesh.zip" file containing the add-on.
2. Launch Blender.
3. Go to Edit > Preferences.
4. Click on the Add-ons tab.
5. Click the Install... button and navigate to the location of the downloaded zip file.
6. Select the zip file and click Install Add-on.
7. Enable the add-on by ticking the checkbox next to "PIC to 3D Mesh" in the add-ons list.
8. Click Save Preferences to confirm the installation.

Usage

1. Setting Up API Key and Image URL

Before using the add-on, you need to set up your API key and provide the URL of the image you want to convert into a 3D mesh.

1. Go to Edit > Preferences.
2. Navigate to the Add-ons tab.
3. Locate "PIC to 3D Mesh" in the add-ons list and expand it.
4. Enter your API key in the "API Key" field. If you don't have an API key, you can obtain one by going to www.csm.ai ,creating a account and generating a API key from your account profile page.
5. Provide the URL of the image you want to convert in the "Image URL" field.
6. Click Save Preferences to save your settings.

2. Generating a Session

To generate a new session for 3D mesh generation:

1. Ensure that you have set up your API key and image URL as described in the previous section.
2. Open the PIC to 3DMesh Panel in the Blender interface.
3. Click on the Create Session button.
4. Wait for the session creation process to complete. Upon successful creation, you will receive a session code.

3. Generating a 3D Mesh

Once you have generated a session, you can proceed to generate the 3D mesh from the selected image.

1. Ensure that you have a valid session code generated from the previous step.
2. Click on the Generate Mesh button in the PIC to 3DMesh Panel.
3. The add-on will initiate the mesh generation process. Depending on the complexity of the image, this process may take some time.
4. Once the mesh generation is successful, you will receive a notification.

4. Refining the Mesh (Optional)

After generating the initial mesh, you have the option to refine it for better quality.

1. Click on the Refine Mesh button in the PIC to 3DMesh Panel.
2. The add-on will start refining the mesh. This process may also take some time.
3. Upon successful refinement, you will receive a notification.

5. Importing the 3D Mesh

Once the mesh is generated and optionally refined, you can import it into Blender for further editing and manipulation.

1. Click on the Import Mesh button in the PIC to 3DMesh Panel.
2. The add-on will download the generated mesh in GLB format and import it into Blender.
3. You can now work with the imported mesh in the Blender workspace.

6. Loading an Existing Session

If you have previously generated sessions and want to load them again:

1. Ensure that you have your API key set up.
2. Enter the session code in the "Session Code" field in the PIC to 3DMesh Panel.
3. Click on the Load Session button.
4. The add-on will fetch the session information associated with the provided session code and load it into Blender.

Additional Notes

• If you encounter any errors or issues during the process, refer to the error messages displayed in the Blender interface for troubleshooting.
• Make sure you have a stable internet connection throughout the process, as the add-on relies on external API calls for mesh generation.
• For best results, use high-quality images with clear details and sufficient contrast.

Input image guide

The generated 3D models with the free csm plan fall under the CC BY 4.0 Deed license

The service provided by csm and their conditions may be subject to change.

If the addon stops working for some reason due to changes made by https://www.csm.ai ,please contact me ASAP so i can revise the code (if possible) so that it continues to work.

Credits

• Author: alexdepario
• API Service: https://www.csm.ai/

Version Information

• Add-on Name: PIC to 3D Mesh
• Blender Compatibility: 3.0 and above
• Version: 1.0