Skip to content

Commit

Permalink
Update Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Arksine committed Mar 30, 2016
1 parent 609d67f commit f7e4cb4
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 7 deletions.
2 changes: 1 addition & 1 deletion .idea/misc.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 9 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Easycam - Easycap viewer for android
=======

Easycam was created as an alternative to Carcam, an app used for displaying a backup camera in automotive installs. Easycam was built and tested on a Nexus 7 (2012) running Autodroid 1.2. Much of Easycam is based on the excellent android-webcam library developed by the OpenXC project. I'd like to thank OpenXC and Ford Motor Company for releasing such a great piece of open software. Easycam uses Google's libyuv for color conversion.
Easycam was created as an alternative to Carcam, an app used for displaying a backup camera in automotive installs. Easycam was built and tested on a Nexus 7 (2012) running Autodroid 1.2. Much of Easycam is based on the excellent android-webcam library developed by the OpenXC project. I'd like to thank OpenXC and Ford Motor Company for releasing such a great piece of open software.

Supported Devices
========
Expand All @@ -25,7 +25,7 @@ After testing I WAS able to get the Easycap002 to run, but I cannot recommend it
Running the app
========

On first run the settings activity will show. Make absolutely sure you set your TV Standard (region) correctly here. The app will attempt to autodetect the type of device you have and the location of the device file (ie. /dev/video0). This functionality can be toggled in the settings where you can manually enter these options, but it is not recommended to do so unless you have multiple Easycap devices hooked up to your tablet. There are also various visual settings included, which are self explanatory.
On first run the settings activity will show. Make absolutely sure you set your TV Standard (region) correctly here. The app will attempt to autodetect the type of device you have and the location of the device file (ie. /dev/video0). The location option may be toggled for manual entry if you have multiple Easycap devices hooked up to your tablet. There are also various visual settings included, which are self explanatory.

Unlike Carcam, there is no background service that attempts to detect a signal and launch the app. That functionality never worked well for me, as it seemed to cause stability issues rather than function as it should. In my opinion a better way to get this functionality would be to use an Arduino to detect voltage on the reverse wire. Obviously there would be a lot of work to get it working (step down 12v to 5v, protect from voltage spikes, an app to communicate between the Arduino and the tablet), but it
would be much more reliable than having a background loop continuously putting a drain
Expand All @@ -34,8 +34,13 @@ on your tablet's resources, having to deal with deep sleep, etc.
Building Easycam
========

Easycam was built using Android Studio 1.5.1 and targets a minimum of Android API 19, with NDK r10e.
Easycam was built using Android Studio 2.0 beta7 and targets a minimum of Android API 19, with NDK r10e.

Note: If you are having trouble building on windows, it is likely due to a compatibility issue with
llvm-rs-cc.exe in the NDK. This can be resolved by navigating to
<NDKDIR>\toolchains\renderscript\prebuilt\windows-x86_64\bin, right clicking on llvm-rs-cc.exe and
changing the compatibility mode to Windows 7 or Windows XP SP3.

License
=======
Copyright (c) 2014-2015 Eric Callahan licensed under the BSD license.
Copyright (c) 2014-2016 Eric Callahan licensed under the BSD license.
2 changes: 0 additions & 2 deletions easycam/easycam.iml
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,6 @@
<sourceFolder url="file://$MODULE_DIR$/src/androidTest/rs" isTestSource="true" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/assets" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/blame" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/builds" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/bundles" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/classes" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/dependency-cache" />
Expand All @@ -88,7 +87,6 @@
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/jniLibs" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/manifests" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/pre-dexed" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/reload-dex" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/res" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/restart-dex" />
<excludeFolder url="file://$MODULE_DIR$/build/intermediates/rs" />
Expand Down

0 comments on commit f7e4cb4

Please sign in to comment.