Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c09a6977 authored by Gilles Debunne's avatar Gilles Debunne
Browse files

Fixes regarding densities in "Providing Resources" documentation page. 

The ratio between densities is not constant.

The Exception for dpi qualifier in point 4 of the algorithm should be detailed.

I understand that if my config is ldpi-trackball-v5
and I have the choice between mdpi and hdpi-trackball-v5, mdpi will be chosen.

Cherry-picked from master CL 59188.

Change-Id: Ibe412a82845527ebdb104605c99c205ca52ab97c
parent 3bf5c4cd

docs/html/guide/topics/resources/providing-resources.jd

+5 −6
Original line number Diff line number Diff line
@@ -450,8 +450,8 @@ application during runtime.</p> 
to match the device density.</li>

        </ul>

        <p><em>Added in API Level 4.</em></p>

        <p>There is thus a 4:3 scaling factor between each density, so a 9x9 bitmap

         in ldpi is 12x12 in mdpi and 16x16 in hdpi.</p>

        <p>There is thus a 3:4:6 scaling ratio between the three densities, so a 9x9 bitmap

         in ldpi is 12x12 in mdpi and 18x18 in hdpi.</p>

        <p>When Android selects which resource files to use,

         it handles screen density differently than the other qualifiers.

         In step 1 of <a href="#BestMatch">How Android finds the best
@@ -895,7 +895,7 @@ drawable-port-ldpi/ 
drawable-port-notouch-12key/

</pre>

<p class="note"><strong>Exception:</strong> Screen pixel density is the one qualifier that is not

eliminated due to a contradiction. Even though the screen density of the device is mdpi,

eliminated due to a contradiction. Even though the screen density of the device is hdpi,

<code>drawable-port-ldpi/</code> is not eliminated because every screen density is

considered to be a match at this point. More information is available in the <a

href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple
@@ -922,8 +922,7 @@ drawable-en-notouch-12key/ 
<strike>drawable-port-notouch-12key/</strike>

</pre>

<p class="note"><strong>Exception:</strong> If the qualifier in question is screen pixel density,

Android

selects the option that most closely matches the device, and the selection process is complete.

Android selects the option that most closely matches the device screen density.

In general, Android prefers scaling down a larger original image to scaling up a smaller

original image. See <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple

Screens</a>.</p>