blob: 5811ca0fd2660163e18464ee199f2bb026f40605 [file] [log] [blame]
/*
* Copyright (C) 2015 The Android Open Source Project
*
* 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.
*/
package android.graphics;
import android.graphics.Paint;
import android.test.InstrumentationTestCase;
import android.test.suitebuilder.annotation.SmallTest;
import java.util.Arrays;
import java.util.HashSet;
/**
* PaintTest tests {@link Paint}.
*/
public class PaintTest extends InstrumentationTestCase {
private static final String FONT_PATH = "fonts/HintedAdvanceWidthTest-Regular.ttf";
static void assertEquals(String message, float[] expected, float[] actual) {
if (expected.length != actual.length) {
fail(message + " expected array length:<" + expected.length + "> but was:<"
+ actual.length + ">");
}
for (int i = 0; i < expected.length; ++i) {
if (expected[i] != actual[i]) {
fail(message + " expected array element[" +i + "]:<" + expected[i] + ">but was:<"
+ actual[i] + ">");
}
}
}
static class HintingTestCase {
public final String mText;
public final float mTextSize;
public final float[] mWidthWithoutHinting;
public final float[] mWidthWithHinting;
public HintingTestCase(String text, float textSize, float[] widthWithoutHinting,
float[] widthWithHinting) {
mText = text;
mTextSize = textSize;
mWidthWithoutHinting = widthWithoutHinting;
mWidthWithHinting = widthWithHinting;
}
}
// Following test cases are only valid for HintedAdvanceWidthTest-Regular.ttf in assets/fonts.
HintingTestCase[] HINTING_TESTCASES = {
new HintingTestCase("H", 11f, new float[] { 7f }, new float[] { 13f }),
new HintingTestCase("O", 11f, new float[] { 7f }, new float[] { 13f }),
new HintingTestCase("H", 13f, new float[] { 8f }, new float[] { 14f }),
new HintingTestCase("O", 13f, new float[] { 9f }, new float[] { 15f }),
new HintingTestCase("HO", 11f, new float[] { 7f, 7f }, new float[] { 13f, 13f }),
new HintingTestCase("OH", 11f, new float[] { 7f, 7f }, new float[] { 13f, 13f }),
new HintingTestCase("HO", 13f, new float[] { 8f, 9f }, new float[] { 14f, 15f }),
new HintingTestCase("OH", 13f, new float[] { 9f, 8f }, new float[] { 15f, 14f }),
};
@SmallTest
public void testHintingWidth() {
final Typeface fontTypeface = Typeface.createFromAsset(
getInstrumentation().getContext().getAssets(), FONT_PATH);
Paint paint = new Paint();
paint.setTypeface(fontTypeface);
for (int i = 0; i < HINTING_TESTCASES.length; ++i) {
HintingTestCase testCase = HINTING_TESTCASES[i];
paint.setTextSize(testCase.mTextSize);
float[] widths = new float[testCase.mText.length()];
paint.setHinting(Paint.HINTING_OFF);
paint.getTextWidths(String.valueOf(testCase.mText), widths);
assertEquals("Text width of '" + testCase.mText + "' without hinting is not expected.",
testCase.mWidthWithoutHinting, widths);
paint.setHinting(Paint.HINTING_ON);
paint.getTextWidths(String.valueOf(testCase.mText), widths);
assertEquals("Text width of '" + testCase.mText + "' with hinting is not expected.",
testCase.mWidthWithHinting, widths);
}
}
private static class HasGlyphTestCase {
public final int mBaseCodepoint;
public final HashSet<Integer> mVariationSelectors;
public HasGlyphTestCase(int baseCodepoint, Integer[] variationSelectors) {
mBaseCodepoint = baseCodepoint;
mVariationSelectors = new HashSet<>(Arrays.asList(variationSelectors));
}
}
private static String codePointsToString(int[] codepoints) {
StringBuilder sb = new StringBuilder();
for (int codepoint : codepoints) {
sb.append(Character.toChars(codepoint));
}
return sb.toString();
}
public void testHasGlyph_variationSelectors() {
final Typeface fontTypeface = Typeface.createFromAsset(
getInstrumentation().getContext().getAssets(), "fonts/hasGlyphTestFont.ttf");
Paint p = new Paint();
p.setTypeface(fontTypeface);
// Usually latin letters U+0061..U+0064 and Mahjong Tiles U+1F000..U+1F003 don't have
// variation selectors. This test may fail if system pre-installed fonts have a variation
// selector support for U+0061..U+0064 and U+1F000..U+1F003.
HasGlyphTestCase[] HAS_GLYPH_TEST_CASES = {
new HasGlyphTestCase(0x0061, new Integer[] {0xFE00, 0xE0100, 0xE0101, 0xE0102}),
new HasGlyphTestCase(0x0062, new Integer[] {0xFE01, 0xE0101, 0xE0102, 0xE0103}),
new HasGlyphTestCase(0x0063, new Integer[] {}),
new HasGlyphTestCase(0x0064, new Integer[] {0xFE02, 0xE0102, 0xE0103}),
new HasGlyphTestCase(0x1F000, new Integer[] {0xFE00, 0xE0100, 0xE0101, 0xE0102}),
new HasGlyphTestCase(0x1F001, new Integer[] {0xFE01, 0xE0101, 0xE0102, 0xE0103}),
new HasGlyphTestCase(0x1F002, new Integer[] {}),
new HasGlyphTestCase(0x1F003, new Integer[] {0xFE02, 0xE0102, 0xE0103}),
};
for (HasGlyphTestCase testCase : HAS_GLYPH_TEST_CASES) {
for (int vs = 0xFE00; vs <= 0xE01EF; ++vs) {
// Move to variation selector supplements after variation selectors.
if (vs == 0xFF00) {
vs = 0xE0100;
}
final String signature =
"hasGlyph(U+" + Integer.toHexString(testCase.mBaseCodepoint) +
" U+" + Integer.toHexString(vs) + ")";
final String testString =
codePointsToString(new int[] {testCase.mBaseCodepoint, vs});
if (testCase.mVariationSelectors.contains(vs)) {
assertTrue(signature + " is expected to be true", p.hasGlyph(testString));
} else {
assertFalse(signature + " is expected to be false", p.hasGlyph(testString));
}
}
}
}
public void testGetTextRunAdvances() {
{
// LTR
String text = "abcdef";
assertGetTextRunAdvances(text, 0, text.length(), 0, text.length(), false, true);
assertGetTextRunAdvances(text, 1, text.length() - 1, 0, text.length(), false, false);
}
{
// RTL
final String text =
"\u0645\u0627\u0020\u0647\u064A\u0020\u0627\u0644\u0634" +
"\u0641\u0631\u0629\u0020\u0627\u0644\u0645\u0648\u062D" +
"\u062F\u0629\u0020\u064A\u0648\u0646\u064A\u0643\u0648" +
"\u062F\u061F";
assertGetTextRunAdvances(text, 0, text.length(), 0, text.length(), true, true);
assertGetTextRunAdvances(text, 1, text.length() - 1, 0, text.length(), true, false);
}
}
private void assertGetTextRunAdvances(String str, int start, int end,
int contextStart, int contextEnd, boolean isRtl, boolean compareWithOtherMethods) {
Paint p = new Paint();
final int count = end - start;
final float[][] advanceArrays = new float[4][count];
final float advance = p.getTextRunAdvances(str, start, end, contextStart, contextEnd,
isRtl, advanceArrays[0], 0);
char chars[] = str.toCharArray();
final float advance_c = p.getTextRunAdvances(chars, start, count, contextStart,
contextEnd - contextStart, isRtl, advanceArrays[1], 0);
assertEquals(advance, advance_c, 1.0f);
for (int c = 1; c < count; ++c) {
final float firstPartAdvance = p.getTextRunAdvances(str, start, start + c,
contextStart, contextEnd, isRtl, advanceArrays[2], 0);
final float secondPartAdvance = p.getTextRunAdvances(str, start + c, end,
contextStart, contextEnd, isRtl, advanceArrays[2], c);
assertEquals(advance, firstPartAdvance + secondPartAdvance, 1.0f);
final float firstPartAdvance_c = p.getTextRunAdvances(chars, start, c,
contextStart, contextEnd - contextStart, isRtl, advanceArrays[3], 0);
final float secondPartAdvance_c = p.getTextRunAdvances(chars, start + c,
count - c, contextStart, contextEnd - contextStart, isRtl,
advanceArrays[3], c);
assertEquals(advance, firstPartAdvance_c + secondPartAdvance_c, 1.0f);
assertEquals(firstPartAdvance, firstPartAdvance_c, 1.0f);
assertEquals(secondPartAdvance, secondPartAdvance_c, 1.0f);
for (int i = 1; i < advanceArrays.length; i++) {
for (int j = 0; j < count; j++) {
assertEquals(advanceArrays[0][j], advanceArrays[i][j], 1.0f);
}
}
// Compare results with measureText, getRunAdvance, and getTextWidths.
if (compareWithOtherMethods && start == contextStart && end == contextEnd) {
assertEquals(advance, p.measureText(str, start, end), 1.0f);
assertEquals(advance, p.getRunAdvance(
str, start, end, contextStart, contextEnd, isRtl, end), 1.0f);
final float[] widths = new float[count];
p.getTextWidths(str, start, end, widths);
for (int i = 0; i < count; i++) {
assertEquals(advanceArrays[0][i], widths[i], 1.0f);
}
}
}
}
public void testGetTextRunAdvances_invalid() {
Paint p = new Paint();
String text = "test";
try {
p.getTextRunAdvances((String)null, 0, 0, 0, 0, false, null, 0);
fail("Should throw an IllegalArgumentException.");
} catch (IllegalArgumentException e) {
}
try {
p.getTextRunAdvances((CharSequence)null, 0, 0, 0, 0, false, null, 0);
fail("Should throw an IllegalArgumentException.");
} catch (IllegalArgumentException e) {
}
try {
p.getTextRunAdvances((char[])null, 0, 0, 0, 0, false, null, 0);
fail("Should throw an IllegalArgumentException.");
} catch (IllegalArgumentException e) {
}
try {
p.getTextRunAdvances(text, 0, text.length(), 0, text.length(), false,
new float[text.length() - 1], 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
try {
p.getTextRunAdvances(text, 0, text.length(), 0, text.length(), false,
new float[text.length()], 1);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
// 0 > contextStart
try {
p.getTextRunAdvances(text, 0, text.length(), -1, text.length(), false, null, 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
// contextStart > start
try {
p.getTextRunAdvances(text, 0, text.length(), 1, text.length(), false, null, 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
// start > end
try {
p.getTextRunAdvances(text, 1, 0, 0, text.length(), false, null, 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
// end > contextEnd
try {
p.getTextRunAdvances(text, 0, text.length(), 0, text.length() - 1, false, null, 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
// contextEnd > text.length
try {
p.getTextRunAdvances(text, 0, text.length(), 0, text.length() + 1, false, null, 0);
fail("Should throw an IndexOutOfBoundsException.");
} catch (IndexOutOfBoundsException e) {
}
}
public void testMeasureTextBidi() {
Paint p = new Paint();
{
String bidiText = "abc \u0644\u063A\u0629 def";
p.setBidiFlags(Paint.BIDI_LTR);
float width = p.measureText(bidiText, 0, 4);
p.setBidiFlags(Paint.BIDI_RTL);
width += p.measureText(bidiText, 4, 7);
p.setBidiFlags(Paint.BIDI_LTR);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
{
String bidiText = "abc \u0644\u063A\u0629 def";
p.setBidiFlags(Paint.BIDI_DEFAULT_LTR);
float width = p.measureText(bidiText, 0, 4);
width += p.measureText(bidiText, 4, 7);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
{
String bidiText = "abc \u0644\u063A\u0629 def";
p.setBidiFlags(Paint.BIDI_FORCE_LTR);
float width = p.measureText(bidiText, 0, 4);
width += p.measureText(bidiText, 4, 7);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
{
String bidiText = "\u0644\u063A\u0629 abc \u0644\u063A\u0629";
p.setBidiFlags(Paint.BIDI_RTL);
float width = p.measureText(bidiText, 0, 4);
p.setBidiFlags(Paint.BIDI_LTR);
width += p.measureText(bidiText, 4, 7);
p.setBidiFlags(Paint.BIDI_RTL);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
{
String bidiText = "\u0644\u063A\u0629 abc \u0644\u063A\u0629";
p.setBidiFlags(Paint.BIDI_DEFAULT_RTL);
float width = p.measureText(bidiText, 0, 4);
width += p.measureText(bidiText, 4, 7);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
{
String bidiText = "\u0644\u063A\u0629 abc \u0644\u063A\u0629";
p.setBidiFlags(Paint.BIDI_FORCE_RTL);
float width = p.measureText(bidiText, 0, 4);
width += p.measureText(bidiText, 4, 7);
width += p.measureText(bidiText, 7, bidiText.length());
assertEquals(width, p.measureText(bidiText), 1.0f);
}
}
public void testSetGetWordSpacing() {
Paint p = new Paint();
assertEquals(0.0f, p.getWordSpacing()); // The default value should be 0.
p.setWordSpacing(1.0f);
assertEquals(1.0f, p.getWordSpacing());
p.setWordSpacing(-2.0f);
assertEquals(-2.0f, p.getWordSpacing());
}
}