iJewel3DDocs

Appearance

Contact supportSign in
EditPlayground

FAQ: Materials & Diamonds ​

Frequently asked questions about materials, diamonds, and textures in iJewel Playground.

How do I change the rotation of a brushed metal texture?

Go to Picking → Physical Material → Map Sampler and adjust the Rotation property. The Map Sampler settings are available for any texture map (albedo, roughness, metalness, normal, etc.). Note that your model needs proper UV coordinates for this to work — make sure the Triplanar extension is disabled.

Video Tutorial

Watch Fix Brushed Textures | UV Unwrap Solution if your brushed textures look incorrect — this covers UV unwrapping and disabling Triplanar.

How do I get a deeper/clearer engraving?

Use the Simple Text modifier along with Parallax Mapping:

Step 1 of 3
  1. Go to Modifiers → Simple Text → Add Text and type your engraving. Make sure to click Apply
  2. Enable Modifiers → Parallax Mapping
  3. To control the depth, adjust bumpScale in Picking → Physical Material → Bump/Normal
My diamond looks white/plain instead of sparkly. What's wrong?

This is typically caused by a missing or inappropriate environment map for the diamond material. Try:

Step 1 of 4
  1. Make sure an HDRI environment map is loaded in Scene → Background / Environment
  2. Check the Gem Env setting — if it's set to None, the diamond won't reflect anything. Select an appropriate diamond environment map
  3. Adjust the Bloom parameters in Post Processing — this adds the sparkle/glow effect
  4. Try adjusting envRotation values in the diamond material settings
Can I apply a different HDRI specifically for diamonds?

Yes. You can set separate environment map slots for Gem/Diamond materials. Additionally, you can create a custom HDR map specifically optimized for diamond sparkle.

Video Tutorial

Watch Creating Custom HDR for Diamonds for a detailed walkthrough.

Why do my diamonds have pixelated seams?

Pixelated seams on diamonds are usually related to normal map resolution. The diamond mesh may have low-resolution normals or overlapping/broken geometry. Check the following:

Step 1 of 3
  1. Make sure your diamond mesh has clean, non-overlapping geometry
  2. Check that normals are correct — avoid modifiers like mirroring that can create overlapping meshes
  3. Use the diamond models provided by iJewel, which are optimized for the renderer
Unnatural black shadows appear inside my marquise-cut diamond. How do I fix this?

This is often caused by incorrect normals or broken/overlapping meshes in the diamond geometry. This can happen when you use modifiers like mirroring in 3D software. Try:

Step 1 of 4
  1. Recalculate normals in your 3D software before exporting — see the Fix Wrong Normals tutorial
  2. Check for overlapping or intersecting geometry
  3. Try different HDRI environments — some environment maps produce better results with certain cuts
  4. Use the diamond models provided by iJewel, which are verified to work correctly
How can I reduce diamond sparkle frequency in videos?

Diamond sparkle is mainly controlled by the Gem HDR environment maps. To reduce sparkle frequency:

Step 1 of 3
  1. Try using different HDRI maps in the Gem Env setting
  2. Adjust the Bloom parameters in Post Processing
  3. Modify the envRotation values in the diamond material
Can I apply a different HDRI to diamonds and metal separately?

Yes. In Playground, you can set separate environment map slots for Metal and Gem/Diamond materials. Go to Scene → Background / Environment and look for the Metal Env and Gem Env options. This lets you use a studio HDRI for metal reflections and a different, more sparkly HDRI for diamond refraction.

How do I create material variations and save them?
Step 1 of 5
  1. Click on an object in the viewport to select it
  2. In the Configurators tab, click Add Variation — this adds a material variation icon
  3. Modify the material properties (color, roughness, metalness, etc.) for each variation
  4. Repeat for multiple objects and variations
  5. To save all variations, click the three dots (⋯) above the Material Configurator UI and click Download Preset — this saves to a JSON file that can be reused across models with matching object/material names

Video Tutorials

My model's file size is too large because of textures. How do I check which textures are heavy?

Go to Picking → Physical Material and check the different texture maps (Albedo, Roughness, Metalness, Normal, etc.). You can download individual texture images to check their sizes. Large texture maps are usually the main contributor to file size — consider reducing their resolution before re-importing.

The model looks fine in Playground but terrible in Shopify. Why?

Shopify's default 3D viewer does not support iJewel's advanced lighting, diamond rendering, or post-processing effects. To get the same quality on your website, embed your model using the iJewel Viewer SDK or use iframe embedding.

I click "+ Add current material", and a new tab opens in place of a variation. Why?

The material tabs in the configurator are grouped by layer name. A new tab opens when the layer name of the material is different from the open tab. To add the current material as a variation:

Step 1 of 3
  1. Download the material as a .pmat file
  2. Upload it under Materials
  3. Select it in Add Configuration
Can I put a PNG logo or an image on the ring?

Yes. Open the Engraving tab, select the part of the model, and click + Add Engraving. Switch Content to Image and upload a PNG, JPG or SVG file. Remove background is on by default and makes a plain background see-through. Use Place, Move, Rotate and Size to position the image.

My bumpScale goes back to 1.00 after I save. How do I keep my value?
Step 1 of 4
  1. Select the object and open Physical Material in Picking
  2. Clear the Legacy Bump Scale checkbox below the bump scale value
  3. Set bumpScale again. The value range changes, so the new value can differ from the old one
  4. Save the project
I change the Repeat of a texture, and nothing happens. Why?

Triplanar is on, and it ignores the Repeat and Offset values. Turn Triplanar off in Physical Material.

If the texture then disappears, the model has no UV map. Open Picking → Auto UV Mapping, enable it, and select a mode and an axis. See Auto UV Mapping.

How do I make a watch crystal or a large glass part?

Use a Physical Material, not a diamond material:

Step 1 of 3
  1. Set Roughness and Metalness to 0
  2. Turn on Transmission
  3. Set a Thickness value

See Transmission.

How do I render a rose cut, an old mine cut, or a scanned stone?

The diamond material follows the geometry of the stone. Model the cut with its real facets in your CAD program, and the stone renders with that cut. A rose cut, for example, has a flat base and a low crown.

A scanned stone has smooth surfaces and no real facets. Give it real facets in your CAD program before you apply a diamond material.

Can I make a two-tone stone?

Yes. Two colors in one stone are possible when each color is a separate mesh. Upload the stone without a diamond material. Then:

Step 1 of 3
  1. Select the first mesh, go to Picking → Diamonds, and click Make Diamond. Enter a cache key, for example 1
  2. Select the second mesh and do the same with the same cache key
  3. Give each mesh its own color in Diamond Material
I apply a material to one part, and other parts change too. Why?

A material applies to all parts that have the same material name. If the metal and the stones are on one layer in your CAD file, they change together.

Correct this in your CAD file, then upload the model again:

Step 1 of 3
  1. Put the metal on one layer
  2. Put each stone shape and each stone color on its own layer
  3. Delete copies of a part that sit on top of each other

In Blender, give each part its own material. See How should I name layers for the layer names.

How do I show the same diamonds on my own website?
Step 1 of 4
  1. Export the model as GLB from Playground. The GLB keeps the diamond materials in the WEBGI_materials_diamond extension.
  2. Export the scene settings as a .vjson file.
  3. In your viewer, add the diamond plugin (DiamondPlugin). Without this plugin, the viewer cannot make diamond materials.
  4. Load the GLB, then load the same .vjson file.

See Export Models and Export Scene Settings.

Useful Video Tutorials ​