Browse Source

Update Guidelines for Images

customisations
alemart 8 months ago
parent
commit
96304d4fc3

+ 24
- 15
docs/guidelines-for-images.md View File

1
-# Guidelines for Reference Images
1
+# Guidelines for Images
2
 
2
 
3
-Some images are more suitable for tracking than others. For best results, pick images that are distinct, asymmetric and detailed. Let me show you some examples.
3
+Not all images are suitable for tracking. For best results, pick images that are distinct, asymmetric, detailed and that have little or no text.
4
 
4
 
5
 ## Distinct
5
 ## Distinct
6
 
6
 
7
 A distinct image has distinguishable areas - quite unlike a repetitive pattern!
7
 A distinct image has distinguishable areas - quite unlike a repetitive pattern!
8
 
8
 
9
-| Distinct :heavy_check_mark: | Not distinct :x: |
10
-| --------------------------- | ---------------- |
11
-| [![](./img/guidelines-for-images-10.jpg "Based on free image from https://pixabay.com/pt/illustrations/unic%c3%b3rnio-gal%c3%a1xia-fantasia-estrela-3115021/ (Tarishart)")](./img/guidelines-for-images-10.jpg){ ._blank } | [![](./img/guidelines-for-images-1.jpg "Free image from https://www.pexels.com/pt-br/foto/papel-de-parede-abstrato-roxo-e-azul-430207/ (Scott Webb)")](./img/guidelines-for-images-1.jpg){ ._blank } |
12
-| [![](./img/guidelines-for-images-9.jpg "Based on free images from https://pixabay.com/pt/illustrations/o-macaco-chimpanz%c3%a9-macaco-banana-4701265/ (Dmitry Abramov) and https://pixabay.com/pt/vectors/panorama-crep%c3%basculo-luz-noite-c%c3%a9u-1844227/ (Wild0ne)")](./img/guidelines-for-images-9.jpg){ ._blank } | [![](./img/guidelines-for-images-4.jpg "Free image from https://www.pexels.com/pt-br/foto/imagem-completa-da-estrutura-arquitetonica-248921/ (Pixabay)")](./img/guidelines-for-images-4.jpg){ ._blank } |
9
+| Suitable :heavy_check_mark: | Unsuitable :x: |
10
+| --------------------------- | -------------- |
11
+| [![](./img/guidelines-for-images-10.jpg "Based on https://pixabay.com/pt/illustrations/unic%c3%b3rnio-gal%c3%a1xia-fantasia-estrela-3115021/ (Tarishart)")](./img/guidelines-for-images-10.jpg){ ._blank } | [![](./img/guidelines-for-images-1.jpg "Source: https://www.pexels.com/pt-br/foto/papel-de-parede-abstrato-roxo-e-azul-430207/ (Scott Webb)")](./img/guidelines-for-images-1.jpg){ ._blank } |
12
+| [![](./img/guidelines-for-images-9.jpg "Based on https://pixabay.com/pt/illustrations/o-macaco-chimpanz%c3%a9-macaco-banana-4701265/ (Dmitry Abramov) and https://pixabay.com/pt/vectors/panorama-crep%c3%basculo-luz-noite-c%c3%a9u-1844227/ (Wild0ne)")](./img/guidelines-for-images-9.jpg){ ._blank } | [![](./img/guidelines-for-images-4.jpg "Source: https://www.pexels.com/pt-br/foto/imagem-completa-da-estrutura-arquitetonica-248921/ (Pixabay)")](./img/guidelines-for-images-4.jpg){ ._blank } |
13
 
13
 
14
 ## Asymmetric
14
 ## Asymmetric
15
 
15
 
16
 Asymmetric images help the engine determine their orientation. When evaluating symmetry, you must not take colors into account.
16
 Asymmetric images help the engine determine their orientation. When evaluating symmetry, you must not take colors into account.
17
 
17
 
18
-| Asymmetric :heavy_check_mark: | Symmetric :x: |
19
-| ----------------------------- | ------------- |
20
-| [![](./img/guidelines-for-images-12.jpg "Free image from https://www.pexels.com/pt-br/foto/gatinho-branco-e-cinza-cheirando-flor-da-margarida-branca-1472999/ (Alex Bargain)")](./img/guidelines-for-images-12.jpg){ ._blank } | [![](./img/guidelines-for-images-2.jpg "Free image from https://www.pexels.com/pt-br/foto/frutas-citricas-brancas-vermelhas-e-amarelas-1415734/ (Aleksandar Pasaric)")](./img/guidelines-for-images-2.jpg){ ._blank } |
21
-| [![](./img/guidelines-for-images-11.jpg "Based on free image from https://pixabay.com/pt/photos/sof%c3%a1-surreal-olhos-cachorro-arte-749629/ (0fjd125gk87)")](./img/guidelines-for-images-11.jpg){ ._blank } | [![](./img/guidelines-for-images-5.jpg "Free image from https://www.pexels.com/pt-br/foto/lapis-de-cor-amarelo-e-azul-1762851/ (Ann H)")](./img/guidelines-for-images-5.jpg){ ._blank } |
18
+| Suitable :heavy_check_mark: | Unsuitable :x: |
19
+| --------------------------- | -------------- |
20
+| [![](./img/guidelines-for-images-12.jpg "Source: https://www.pexels.com/pt-br/foto/gatinho-branco-e-cinza-cheirando-flor-da-margarida-branca-1472999/ (Alex Bargain)")](./img/guidelines-for-images-12.jpg){ ._blank } | [![](./img/guidelines-for-images-2.jpg "Source: https://www.pexels.com/pt-br/foto/frutas-citricas-brancas-vermelhas-e-amarelas-1415734/ (Aleksandar Pasaric)")](./img/guidelines-for-images-2.jpg){ ._blank } |
21
+| [![](./img/guidelines-for-images-11.jpg "Based on https://pixabay.com/pt/photos/sof%c3%a1-surreal-olhos-cachorro-arte-749629/ (0fjd125gk87)")](./img/guidelines-for-images-11.jpg){ ._blank } | [![](./img/guidelines-for-images-5.jpg "Source: https://www.pexels.com/pt-br/foto/lapis-de-cor-amarelo-e-azul-1762851/ (Ann H)")](./img/guidelines-for-images-5.jpg){ ._blank } |
22
 
22
 
23
 ## Detailed
23
 ## Detailed
24
 
24
 
25
-A detailed image has lots of details with sufficient contrast. There's not much blank space!
25
+A detailed image has lots of different details with sufficient contrast. There isn't much blank space!
26
 
26
 
27
-| Detailed :heavy_check_mark: | Not detailed :x: |
28
-| ---------------------------------- | ----------------------- |
29
-| [![](./img/guidelines-for-images-3.jpg "Free image from https://www.pexels.com/pt-br/foto/pagode-verde-321900/ (Anthony)")](./img/guidelines-for-images-3.jpg){ ._blank } | [![](./img/guidelines-for-images-7.jpg "Free image from https://www.pexels.com/pt-br/foto/6985119/ (Gradienta)")](./img/guidelines-for-images-7.jpg){ ._blank } |
30
-| [![](./img/guidelines-for-images-8.jpg "Free image from https://www.pexels.com/pt-br/foto/fotografia-de-close-up-de-arara-azul-e-amarela-1453550/ (Susanne Jutzeler)")](./img/guidelines-for-images-8.jpg){ ._blank } | [![](./img/guidelines-for-images-6.jpg "Free image from https://unsplash.com/photos/KF-r4-KM9pM (Gian Gomez)")](./img/guidelines-for-images-6.jpg){ ._blank } |
27
+| Suitable :heavy_check_mark: | Unsuitable :x: |
28
+| --------------------------- | -------------- |
29
+| [![](./img/guidelines-for-images-3.jpg "Source: https://www.pexels.com/pt-br/foto/borboleta-flor-broto-flora-5647855/ (Ольга Бочкарева)")](./img/guidelines-for-images-3.jpg){ ._blank } | [![](./img/guidelines-for-images-7.jpg "Source: https://www.pexels.com/pt-br/foto/6985119/ (Gradienta)")](./img/guidelines-for-images-7.jpg){ ._blank } |
30
+| [![](./img/guidelines-for-images-8.jpg "Source: https://www.pexels.com/pt-br/foto/fotografia-de-close-up-de-arara-azul-e-amarela-1453550/ (Susanne Jutzeler)")](./img/guidelines-for-images-8.jpg){ ._blank } | [![](./img/guidelines-for-images-6.jpg "Source: https://unsplash.com/photos/KF-r4-KM9pM (Gian Gomez)")](./img/guidelines-for-images-6.jpg){ ._blank } |
31
+
32
+## Little or no text
33
+
34
+It follows from the other recommendations that images with too much text - particularly small text - are unsuitable for tracking. Feature points will tend to cluster around the letters and will not be distinct enough. A little bit of text is okay.
35
+
36
+| Suitable :heavy_check_mark: | Unsuitable :x: |
37
+| --------------------------- | -------------- |
38
+| [![](./img/guidelines-for-images-14.jpg "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)")](./img/guidelines-for-images-14.jpg){ ._blank } | [![](./img/guidelines-for-images-13.jpg "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)")](./img/guidelines-for-images-13.jpg){ ._blank } |
39
+| [![](./img/guidelines-for-images-16.jpg "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)")](./img/guidelines-for-images-16.jpg){ ._blank } | [![](./img/guidelines-for-images-15.png "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)")](./img/guidelines-for-images-15.png){ ._blank } |
31
 
40
 
32
 ## Other considerations
41
 ## Other considerations
33
 
42
 

BIN
docs/img/guidelines-for-images-13.jpg View File


BIN
docs/img/guidelines-for-images-14.jpg View File


BIN
docs/img/guidelines-for-images-15.png View File


BIN
docs/img/guidelines-for-images-16.jpg View File


BIN
docs/img/guidelines-for-images-3.jpg View File


+ 1
- 1
docs/tutorial/activate-your-webcam.md View File

99
 Here is the reference image in case you need it again:
99
 Here is the reference image in case you need it again:
100
 
100
 
101
 <figure markdown>
101
 <figure markdown>
102
-[![/assets/my-reference-image.webp](../assets/my-reference-image.webp "Based on free image by ArtRose from https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/"){ width=512 }](../assets/my-reference-image.webp){ ._blank }
102
+[![/assets/my-reference-image.webp](../assets/my-reference-image.webp "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)"){ width=512 }](../assets/my-reference-image.webp){ ._blank }
103
 <figcaption>Reference Image</figcaption>
103
 <figcaption>Reference Image</figcaption>
104
 </figure>
104
 </figure>
105
 
105
 

+ 1
- 1
docs/tutorial/set-up-the-tracker.md View File

9
 Not all images are suitable for tracking. Images should be distinct, detailed and asymmetrical. I discuss this in detail in [Guidelines for Images](../guidelines-for-images.md). For now we'll just use the following image:
9
 Not all images are suitable for tracking. Images should be distinct, detailed and asymmetrical. I discuss this in detail in [Guidelines for Images](../guidelines-for-images.md). For now we'll just use the following image:
10
 
10
 
11
 <figure markdown>
11
 <figure markdown>
12
-[![../assets/my-reference-image.webp](../assets/my-reference-image.webp "Based on free image by ArtRose from https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/"){ width=512 }](../assets/my-reference-image.webp){ ._blank }
12
+[![../assets/my-reference-image.webp](../assets/my-reference-image.webp "Based on https://pixabay.com/pt/vectors/bruxa-vassoura-gato-chap%c3%a9u-magia-5635225/ (ArtRose)"){ width=512 }](../assets/my-reference-image.webp){ ._blank }
13
 <figcaption>Reference Image</figcaption>
13
 <figcaption>Reference Image</figcaption>
14
 </figure>
14
 </figure>
15
 
15
 

Loading…
Cancel
Save