# android-trail-drawing

**Repository Path**: mirrors_Orange-OpenSource/android-trail-drawing

## Basic Information

- **Project Name**: android-trail-drawing
- **Description**: Gesture trail drawing library for Android and Java
- **Primary Language**: Unknown
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Build Status](https://travis-ci.org/Orange-OpenSource/android-trail-drawing.svg?branch=master)](https://travis-ci.org/Orange-OpenSource/trail-drawing) 

Trail Drawing library
=====================

![drawing examples](https://github.com/Orange-OpenSource/trail-drawing/blob/master/demo/example.png)

A gesture trail drawing library for Android and Java applications.

It allows to draw thick and thin strokes as if you were used a felt-tip marker. To achieve this, we first used a polygonal chain in order to approximate the hand-drawing trail and to select the most salient points. Next, we used a quadratic Bezier curve approximation to model a smooth curve in place of the original path. This smooth path serves then to guide a virtual felt-tip modeled by a flattened ellipsoid which orientation remains constant during the entire drawing. The main difficulty of this treatment is to perform it online without perceived latency.


# Build the library

It is a maven build, so basically <code>mvn install</code> should do the job. It will install the library in your local repository. You can also retrieve the jar file under the target directory (after the maven build).

The library is published on maven central to ease developers' life. So to use the library in a maven build:
<pre><code>&lt;dependency&gt;
  &lt;groupId&gt;com.orange.dgil.trail&lt;/groupId&gt;
  &lt;artifactId&gt;trail-core-lib&lt;/artifactId&gt;
  &lt;version&gt;1.2.3&lt;/version&gt;
  &lt;scope&gt;compile&lt;/scope&gt;
&lt;/dependency&gt;
</pre></code>

In a gradle build:
<pre><code>dependencies {
  compile "com.orange.dgil.trail:trail-core-lib:1.2.3"
}
</pre></code>

# Demo applications
Can be found in the "demo" directory: android and javafx apps. Basically the javafx application is used to test and debug algorithms.
Above gestures where produced with the android "DroidTest" demo, whose prebuilt apk is here (click on "Raw" to save file): [Demo apk](https://github.com/Orange-OpenSource/trail-drawing/blob/master/demo/DroidDrawingTest.apk)

Both demo apps use gradle for the build.

For "DroidTest", <code>./gradlew assembleDebug</code> will build the apk.

For "JavaFxTest", <code>./gradlew run</code> will build and launch the application. Be sure to use oracle java 8 jvm here.

Happy testing!

# License
Copyright (C) 2014 Orange

The trail drawing library is distributed under the terms and conditions of the Mozilla Public License v2.0, https://www.mozilla.org/MPL/2.0

# Authors
The library is born in 2014 at the Orange Labs in Meylan (french Alps). If Christophe Maldivi and Eric Petit practice cliff climbing together, they also sometimes write software together :)