compose-audio-controls

KO | EN

gitlite — search

#react #llm #golang #go #rust #docker #nodejs #java #awesome #cli #kubernetes #awesome-list #pytorch #security

compose-audio-controls

(★ 13)

audio controls for Jetpack Compose and Compose for Multiplatform

compose-audio-controls 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Compose Audio Controls

![demoapp sshot](https://raw.githubusercontent.com/atsushieno/compose-audio-controls/main/docs/images/demoapp-sshot.png)

It is a repository for Jetpack Compose / Compose for Multiplatform widgets
for audio apps.

## ImageStripKnob

![ImageStripKnob demoapp](https://raw.githubusercontent.com/atsushieno/compose-audio-controls/main/docs/images/ImageStripKnob.png)

[`ImageStripKnob`](https://atsushieno.github.io/compose-audio-controls/compose-audio-controls/org.androidaudioplugin.composeaudiocontrols/-image-strip-knob.html) is a knob audio control based on an image strip.

### KnobMan image strip

It makes use of [KnobMan](https://www.kvraudio.com/product/knobman-by-g200kg) image resource. If you are curious what this means, go to [Knob Gallery](https://www.g200kg.com/en/webknobman/gallery.php). You can use these knobs without coding anything. It is a cheap trick, but offers what people really need. It is used by wide range of people in audio app industry (such as [Kontakt](https://www.native-instruments.com/en/products/komplete/samplers/kontakt-7/) instrument, Web audio/music app developers who use [webaudio-controls](http://g200kg.github.io/webaudio-controls/docs/)). It gives you a lot of choices:

![KnobGallery sshot](https://raw.githubusercontent.com/atsushieno/compose-audio-controls/main/docs/images/KnobGallery-sshot.png)

### Knob UI implementation

It respects "Consider making touch targets at least 48x48dp" principle in the [Android Accessibility Help](https://support.google.com/accessibility/android/answer/7101858?hl=en) guideline. You can override it at your own risk though.

We know what musicians actually want: it is a simple single-fingered vertically draggable knob. No pinching like real knobs required.

Sometimes we want fine-tuning. If you hold 1000 milliseconds (by default) it will enter "fine mode" where the value changes are multiplied by 0.1. It will happen at any time until you release your finger or mouse pointer.

A value label tooltip will be shown when you drag over the knob. Your finger may be hiding it though; you can move the finger to left or right without changing value (to make it possible, we assign no horizontal control, at least for now). The tooltip is customizible - you can pass any `@Composable`.

It should be noted that `ImageStripKnob` is NOT a Material Design based component. You would be able to add some animation effects by your own (we also welcome contribution if it's optional and looking generally useful).

### Usage example

```kotlin
var paramValue by remember { mutableStateOf(0f) }
Text("Parameter $paramIndex: ")
ImageStripKnob(
    drawableResId = R.drawable.knob_image,
    value = paramValue,
    onValueChange = {v ->
        paramValue = v
        println("value at $paramIndex changed: $v")
        })
```

Noted that support for Android resource ID is specific to Android platform. If your project is Kotlin Multiplatform, use `ImageBitmap` instead.

## DiatonicKeyboard

![DiatonicKeyboard sshot](https://raw.githubusercontent.com/atsushieno/compose-audio-controls/main/docs/images/DiatonicKeyboard.png)

[`DiatonicKeyboard`](https://atsushieno.github.io/compose-audio-controls/compose-audio-controls/org.androidaudioplugin.composeaudiocontrols/-diatonic-keyboard.html) is a diatonic music keyboard control.

In addition, [`DiatonicKeyboardWithControllers`](https://atsushieno.github.io/compose-audio-controls/compose-audio-controls/org.androidaudioplugin.composeaudiocontrols/-diatonic-keyboard-with-controllers.html) adds some controllers for the parameters (explained below) to the keyboard. It takes extra space, but makes it more convenient.

Its event handlers receive note number (and additional information in the next versions, unused argument so far).

It supports touch motions. There are two modes regarding how they are handled, up to "moveAction" 
parameter:

- `NoteChange`: when it is dragged to another note region, a note off for current note and a new note on will be sent.
- `NoteExpression`: when it is dragged, it will trigger `onNoteExpression` callback, for horizontal and vertical dragging, plus the pointer "pressure" if it is supported by device.

Take it like, it works as an MPE (or MIDI 2.0) keyboard too.
Note that note changes and note expressions are exclusive behaviors (we cannot do both).
Note expression support works only if it is explicitly enabled.

The default note expression ranges on screen is 160.dp, 80dp on all directions (L <-> R, T <-> B).
The value sent to `onExpression` event handler ranges between `-1.0f..1.0f`.
It is up to you what kind of controls to assign, on X axis, Y axis, and pressure.

### DiatonicKeyboard UI implementation

It is designed to be touchable on screen but not to become small as a musical keyboard.
One optimization made there is different pointer treat on touches and mouse/stylus.
For touches, the target note is calculated based on the nearest to the center of the keys.
On the other hand, if the input type is mouse or stylus, it expects exact insets.

### Usage example

```kotlin
val noteOnStates = remember { List(128) { 0 }.toMutableStateList() }
DiatonicKeyboard(noteOnStates.toList(),
    // you will also insert actual musical operations within these lambdas
    onNoteOn = { note, _ ->
        noteOnStates[note] = 1
        println("note on: $note")
    },
    onNoteOff = { note, _ ->
        noteOnStates[note] = 0
        println("note off: $note")
    }
)
```

## Using compose-audio-controls

Add the following `implementation` line to your dependencies list:

```groovy
dependencies {
    implementation 'org.androidaudioplugin:compose-audio-controls:+' //replace `+` with your own
}
```

The API reference is published at https://atsushieno.github.io/compose-audio-controls/ (updated for every new release tagging)

## Showcases

[Resident MIDI Keyboard](https://github.com/atsushieno/resident-midi-keyboard) is a straightforward usage example of `DianoticKeyboardWithControllers`. (It used to be part of this project, but now has its own home.)

[AAP (Audio Plugins For Android)](https://github.com/atsushieno/aap-core) makes use of the keyboard and knob as part of the default native (Compose) UI.

## License

compose-audio-controls is released under the MIT license.

The sample app contains some public-domain images from KnobGallery.

compose-audio-controls

compose-audio-controls 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

compose-audio-controls

compose-audio-controls 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README