Browse Source

Docs: add page Recommendations for WebAR

customisations
alemart 9 months ago
parent
commit
71000f64ca
4 changed files with 18 additions and 9 deletions
  1. 1
    8
      docs/faq.md
  2. 3
    1
      docs/guidelines-for-images.md
  3. 12
    0
      docs/recommendations.md
  4. 2
    0
      mkdocs.yml

+ 1
- 8
docs/faq.md View File

10
 
10
 
11
 ## What are your recommendations for WebAR?
11
 ## What are your recommendations for WebAR?
12
 
12
 
13
-For a good experience with WebAR:
14
-
15
-* Don't move the camera nor the target image too quickly. This produces motion blur.
16
-* The target image should appear clearly in the video.
17
-* The physical environment should be properly illuminated.
18
-* If you're scanning the image on a screen, make sure to adjust the brightness. If the screen is too bright (too dark), it will cause overexposure (underexposure) in the video and tracking difficulties - details of the images will be lost. Screen reflections are also undesirable.
19
-* If you print the image, avoid shiny materials (e.g., glossy paper). They may generate artifacts in the image and interfere with the tracking. Prefer non-reflective materials.
20
-* Avoid low-quality cameras. Cameras of common smartphones are okay.
13
+Refer to the [recommendations](./recommendations.md).
21
 
14
 
22
 ## Is this WebXR?
15
 ## Is this WebXR?
23
 
16
 

+ 3
- 1
docs/guidelines-for-images.md View File

53
 
53
 
54
 ### Test it!
54
 ### Test it!
55
 
55
 
56
-In addition to the guidelines presented above, you should always experiment with your images and make sure it all works as intended. Keep in mind that proper lighting of the physical environment is also very important!
56
+In addition to the guidelines presented above, you should always experiment with your images and make sure it all works as intended. Keep in mind that proper lighting of the physical environment is also very important!
57
+
58
+See also: [Recommendations for WebAR](./recommendations.md).

+ 12
- 0
docs/recommendations.md View File

1
+# Recommendations for WebAR
2
+
3
+For a good experience with WebAR:
4
+
5
+* Don't move the camera nor the target image too quickly. This produces motion blur.
6
+* The target image should appear clearly in the video.
7
+* The physical environment should be properly illuminated.
8
+* If you're scanning the image on a screen, make sure to adjust the brightness. If the screen is too bright (too dark), it will cause overexposure (underexposure) in the video and tracking difficulties - details of the images will be lost. Screen reflections are also undesirable.
9
+* If you print the image, avoid shiny materials (e.g., glossy paper). They may generate artifacts in the image and interfere with the tracking. Prefer non-reflective materials.
10
+* Avoid low-quality cameras. Cameras of common smartphones are okay.
11
+
12
+See also: [Guidelines for Images](./guidelines-for-images.md).

+ 2
- 0
mkdocs.yml View File

52
     - 'Demos': 'demos.md'
52
     - 'Demos': 'demos.md'
53
     - 'Learn': 'tutorial/introduction.md'
53
     - 'Learn': 'tutorial/introduction.md'
54
     - 'API Reference': 'api/ar.md'
54
     - 'API Reference': 'api/ar.md'
55
+    - 'Recommendations': 'recommendations.md'
55
     - 'Guidelines for Images': 'guidelines-for-images.md'
56
     - 'Guidelines for Images': 'guidelines-for-images.md'
56
     - 'Support my work': 'support-my-work.md'
57
     - 'Support my work': 'support-my-work.md'
57
     - 'License': 'license.md'
58
     - 'License': 'license.md'
66
     - 'Activate your webcam': 'tutorial/activate-your-webcam.md'
67
     - 'Activate your webcam': 'tutorial/activate-your-webcam.md'
67
     - 'Augment the scene': 'tutorial/augment-the-scene.md'
68
     - 'Augment the scene': 'tutorial/augment-the-scene.md'
68
     - 'Next steps': 'tutorial/next-steps.md'
69
     - 'Next steps': 'tutorial/next-steps.md'
70
+    - 'Recommendations': 'recommendations.md'
69
     - 'Guidelines for Images': 'guidelines-for-images.md'
71
     - 'Guidelines for Images': 'guidelines-for-images.md'
70
     - 'Questions & Answers': 'faq.md'
72
     - 'Questions & Answers': 'faq.md'
71
   - 'API':
73
   - 'API':

Loading…
Cancel
Save