Home

Awesome

Piano Chart View

License: MIT

Introduction

Elementary and clean Android View for displaying piano chord and scale charts in music theory apps for pianists.

Sample

Installation

Step 1

Add the JitPack repository to your build file

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

Step 2

Add the dependency

	dependencies {
		compile 'com.github.Andy671:PianoChartView:v0.6.6'
	}

Usage

Creating from xml:

In your <b>layout.xml</b>

xmlns:custom="http://schemas.android.com/apk/res-auto"

<!-- Custom arguments are optional - if you don't override them it uses default values -->
 <com.kekstudio.pianochartview.PianoChartView
        android:id="@+id/piano_chart_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"

       	custom:checkedKeysColor="@android:color/white"
       	custom:lightKeysColor="@color/colorCustomLight"
        custom:darkKeysColor="@color/colorCustomDark"
        custom:size="Small"
        custom:checkedKeys="@array/some_integer_array"/>

In your <b>arrays.xml</b>

<!-- Numbers = keys on keyboard -->
    <integer-array name="some_integer_array">
        <item>5</item>
        <item>7</item>
        <item>11</item>
        <item>1</item>
    </integer-array>

In your <b>colors.xml</b>

    <color name="colorCustomLight">#C8E6C9</color>
    <color name="colorCustomDark">#1B5E20</color>

Editing from code:

 	PianoChartView pianoChartView = (PianoChartView) findViewById(R.id.piano_chart_view_small);
	pianoChartView.setCheckedKeys(new int[]{2, 5, 3, 8, 11, 12});
	pianoChartView.setSize(PianoChartView.Size.Small);
	pianoChartView.setLightKeysColor(Color.parseColor("#CFD8DC"));
	pianoChartView.setDarkKeysColor(Color.parseColor("#607D8B"));
	pianoChartView.setCheckedKeysColor(Color.parseColor("#B2EBF2"));

See sample for more info

XML Attributes

AttributeTypeDefault
lightKeysColorcolorColor.WHITE
darkKeysColorcolorColor.DKGRAY
checkedKeysColorcolor#03A9F4
additionalCheckedKeysColorcolor#03A9F4
checkedKeysreference (int[]){ }
additionalCheckedKeysreference (int[]){ }
namesOfKeysreference (String[]){ }
sizeenum [Large, Small]Large

Public methods

TypeMethod
voidsetCheckedKeys(int[] numbers)
voidsetAdditionalCheckedKeys(int[] numbers)
voidsetNamesOfKeys(String... keyLetters)
voidsetSize(Size size)
voidsetLightKeysColor(int color)
voidsetDarkKeysColor(int color)
voidsetCheckedKeysColor(int color)
voidsetAdditionalCheckedKeysColor(int color)
int[]getCheckedKeys()
int[]getAdditionalCheckedKeys()
SizegetSize()
intgetLightKeysColor()
intgetDarkKeysColor()
intgetCheckedKeysColor()
intgetAdditionalCheckedKeysColor()

Contribution