Initial commit

.gitignore

@@ -0,0 +1,25 @@
+.classpath
+.project
+.settings
+eclipsebin
+
+bin
+gen
+build
+out
+lib
+
+.idea
+*.iml
+classes
+
+obj
+
+.DS_Store
+
+# Gradle
+.gradle
+jniLibs
+build
+local.properties
+reports

CHANGELOG.md

@@ -0,0 +1,7 @@
+Change Log
+==========
+
+Version 0.1.0 *(2017-02-01)*
+----------------------------
+
+Initial version.

README.md

@@ -0,0 +1,49 @@
+Android Units
+==========
+
+A utility class for converting between different Android display units
+
+
+
+Example Usage
+-------------
+
+How can I get the pixels for the display pixel (dp) measurement I have?
+```java
+float topPaddingOrSomething = AndroidUnits.DENSITY_PIXELS.toPixels(8);
+```
+
+
+Download
+--------
+
+Add via Gradle:
+```groovy
+compile 'com.github.kevelbreh:androidunits:0.1.0'
+```
+or Maven:
+```xml
+<dependency>
+ <groupId>com.github.kevelbre</groupId>
+ <artifactId>androidunits</artifactId>
+ <version>0.1.0</version>
+</dependency>
+```
+
+
+License
+-------
+
+ Copyright 2017 Kevin Woodland
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.

androidunits/build.gradle

@@ -0,0 +1,22 @@
+apply plugin: 'com.android.library'
+apply plugin: 'com.github.dcendents.android-maven'
+
+group='com.github.kevelbreh'
+
+android {
+ compileSdkVersion 25
+ buildToolsVersion "25.0.2"
+
+ defaultConfig {
+ minSdkVersion 9
+ testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+ }
+}
+
+dependencies {
+ compile fileTree(dir: 'libs', include: ['*.jar'])
+ androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
+ exclude group: 'com.android.support', module: 'support-annotations'
+ })
+ testCompile 'junit:junit:4.12'
+}

androidunits/src/androidTest/java/com/github/kevelbreh/androidunits/ExampleInstrumentedTest.java

@@ -0,0 +1,34 @@
+package com.github.kevelbreh.androidunits;
+
+import android.content.res.Resources;
+import android.support.test.runner.AndroidJUnit4;
+
+import android.util.DisplayMetrics;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.assertEquals;
+
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+
+ @Test public void conversions() throws Exception {
+ DisplayMetrics metrics = Resources.getSystem().getDisplayMetrics();
+
+ for (float s = 0; s < 999; s++) {
+ assertEquals(s, AndroidUnit.PIXELS.toPixels(s), 0);
+ assertEquals(s / metrics.density, AndroidUnit.PIXELS.toDisplayPixels(s), 0);
+ assertEquals(s / metrics.scaledDensity, AndroidUnit.PIXELS.toScalePixels(s), 0);
+
+ assertEquals(s * metrics.density, AndroidUnit.DENSITY_PIXELS.toPixels(s), 0);
+ assertEquals(s, AndroidUnit.DENSITY_PIXELS.toDisplayPixels(s), 0);
+ assertEquals(s * (metrics.density / metrics.scaledDensity),
+ AndroidUnit.DENSITY_PIXELS.toScalePixels(s), 0);
+
+ assertEquals(s * metrics.scaledDensity, AndroidUnit.SCALE_PIXELS.toPixels(s), 0);
+ assertEquals(s * (metrics.scaledDensity / metrics.density),
+ AndroidUnit.SCALE_PIXELS.toDisplayPixels(s), 0);
+ assertEquals(s, AndroidUnit.SCALE_PIXELS.toScalePixels(s), 0);
+ }
+ }
+}

androidunits/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest package="com.github.kevelbreh.androidunits">
+ <application/>
+</manifest>

androidunits/src/main/java/com/github/kevelbreh/androidunits/AndroidUnit.java

@@ -0,0 +1,106 @@
+package com.github.kevelbreh.androidunits;
+
+import android.content.Context;
+import android.content.res.Resources;
+import android.util.DisplayMetrics;
+
+/**
+ * {@code AndroidUnit} is a utility to convert between the different display units used when laying
+ * out android views. {@code AndroidUnit} doesn't care about android the {@link Context}.
+ */
+public enum AndroidUnit {
+
+ PIXELS {
+ @Override public float convert(float sourceCount, AndroidUnit sourceUnit) {
+ return sourceUnit.toPixels(sourceCount);
+ }
+
+ @Override public float toPixels(float count) {
+ return count;
+ }
+
+ @Override public float toDisplayPixels(float count) {
+ return count / DISPLAY_METRICS.density;
+ }
+
+ @Override public float toScalePixels(float count) {
+ return count / DISPLAY_METRICS.scaledDensity;
+ }
+ },
+
+ DENSITY_PIXELS {
+ @Override public float convert(float sourceCount, AndroidUnit sourceUnit) {
+ return sourceUnit.toDisplayPixels(sourceCount);
+ }
+
+ @Override public float toPixels(float count) {
+ return count * DISPLAY_METRICS.density;
+ }
+
+ @Override public float toDisplayPixels(float count) {
+ return count;
+ }
+
+ @Override public float toScalePixels(float count) {
+ return count * (DISPLAY_METRICS.scaledDensity / DISPLAY_METRICS.density);
+ }
+ },
+
+ SCALE_PIXELS {
+ @Override public float convert(float sourceCount, AndroidUnit sourceUnit) {
+ return sourceUnit.toScalePixels(sourceCount);
+ }
+
+ @Override public float toPixels(float count) {
+ return count * DISPLAY_METRICS.scaledDensity;
+ }
+
+ @Override public float toDisplayPixels(float count) {
+ return count * (DISPLAY_METRICS.density / DISPLAY_METRICS.scaledDensity);
+ }
+
+ @Override public float toScalePixels(float count) {
+ return count;
+ }
+ };
+
+ private static final DisplayMetrics DISPLAY_METRICS = Resources.getSystem().getDisplayMetrics();
+
+ /**
+ * Converts the given size in the given unit to this unit.
+ *
+ * @param sourceCount the size in the given {@code sourceUnit}.
+ * @param sourceUnit the unit of the {@code sourceCount} argument.
+ * @return the converted size of the unit
+ */
+ public float convert(float sourceCount, AndroidUnit sourceUnit) {
+ throw new AbstractMethodError();
+ }
+
+ /**
+ * Convert from a source unit count to a pixel count
+ * @param count the source unit count
+ * @return the converted source to a pixel count
+ */
+ public float toPixels(float count) {
+ throw new AbstractMethodError();
+ }
+
+ /**
+ * Convert from a source unit count to a density independent pixel count
+ * @param count the source unit count
+ * @return the converted density independent pixel count
+ */
+ public float toDisplayPixels(float count) {
+ throw new AbstractMethodError();
+ }
+
+ /**
+ * Convert from a source unit count to a scaled independent pixel count
+ * @param count the source unit count
+ * @return the converted scaled independent pixel count
+ */
+ public float toScalePixels(float count) {
+ throw new AbstractMethodError();
+ }
+}

build.gradle

@@ -0,0 +1,19 @@
+buildscript {
+ repositories {
+ jcenter()
+ }
+ dependencies {
+ classpath 'com.android.tools.build:gradle:2.2.3'
+ classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
+ }
+}
+
+allprojects {
+ repositories {
+ jcenter()
+ }
+}
+
+task clean(type: Delete) {
+ delete rootProject.buildDir
+}

gradle.properties

@@ -0,0 +1,17 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx1536m
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+#Mon Dec 28 10:00:20 PST 2015
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip