Browser Requirements
KoolViewer requires a WebGL-canvas compatible browser：
- Chrome 50+
- Firefox 45+
- Opera 37+
- Safari 9+
- Microsoft Edge 20+
- Internet Explorer 11
Mobile Device Requirements
3d-viewer adapts mobile phones and Pad devices, and supports the following devices that meet the following requirements:
iOS device: (> iPhone6; >= iPad air)
- Hardware requirements: memory > 2G;
- System requirements: iOS 12.0 and above
Android device
- Hardware requirements: memory > 2G;
- System requirements: Android 4.1 and above
Model requirements
Base model requirements：
| requirements | description |
|---|---|
| Number of Polygons | The number of triangular faces of a single model should be between 15W and 60W. Reduce the number of unnecessary polys (eg, invisible faces, small pieces). Use bump mappings, normal mappings and subdivisions as mush as possible. The number of faces in the model directly determines the display quality of the 3DViewer. How to make a realistic model with a low number of faces is the first standard to be followed in modeling. |
| Flatten UVMapping | If a model which has no control of the number of polys does not divide the UV or just be given a random UV, there will be a problem. That is, once the texture has some sort of patterns, the gap will be obvious and the pattern will not be connected。 So be sure to expand the UV |
| Uneven UV Size | The UV distribution needs to be uniform and the same texture cannot be one big and one small. Like the one on the left, there will be a problem with the wrong ratio. |
| No Broken Faces or Obvious Gaps | Broken face will lead to the wrong modeling, so it is necessary to do the complete bed frame modeling. Easy to result in UV errors and texture stretching in 3D Viewer when rendering textures. |
| Boolean Operation | As for the model in the left example pic, it is best to do some Boolean operations to remove some overlapping faces, which can improve the efficiency of UV expansion (improve the resolution of texture maps). |
| Normal Issues | The normal must not be reversed when modeling, otherwise the Model-Viewer display and the USDZ AR display will have problems, causing the display to be completely black. |
| Bake Support | Due to the limitation of baking, try to set the material properties by VrayMtl material. for transparent objects is accomplished by setting RefractionMap, don't use the attribute of Opacity. |
| Z-Fighting | The model has two or even more faces that overlap and need to be cleaned up,Otherwise, the generated model-viewer will have problems with overlap, noise, and flickering. |
Material requirements
| requirements | description |
|---|---|
| Material Accuracy | Check if the material is right before submitting the model. As shown in the two figures, the understanding of the cloth on the left side may be a bit misunderstood. But the figure on the right side clearly tells us that it is a cloth material. |
| Material Type | Only support VrayMtl, Vray2SidedMtl, VrayBlendMtl, VraylightMtl currently. Do not use the standard material that comes with 3ds Max. |
| Solid Color | The model must have a corresponding material. If the model has no material but color, its diffuse will be completely black.The model without the material is unreasonable. |
Texture requirements
| requirements | description |
|---|---|
| Bitmap Path | The texture path should be correct and cannot be missing.Compressing with the zip tool is prone to path loss. It should be packaged using Applicaiton>Save As > Archive in 3ds Max. Read official help doc To Archive a File. |
| Texture Dimensions | Try using dimensions with even-numbered endings, such as 1024*1024, 2048*2048, 600*800. Do not use the dimension like 2301, which ends in uneven number. The texture dimensions should not be too small or too large. 600~2048 is ok. The file size can be larger, the upper limit is 5MB. Just like the left 2 pictures, they are both 1024. But one is 333KB, one is 666KB. The bigger, the clearer. The texture size should be controlled within 399KB~2MB. |
| Texture Cannot Be Missing | The model which loses the texture will also lose the texture effect after rendering. |
Resource archive
| issue | description |
|---|---|
| archive | Max files need to be archived. Check if there are any missing files (materials, textures). |
| Replaceable Materials | 3D Viewer team should know how many replaceable materials for the model and their corresponding components. It would be better if photos attached. |