Giter Site home page Giter Site logo

jbeuckm / appcelerator-urban-image-library Goto Github PK

View Code? Open in Web Editor NEW

This project forked from quickstonesw/appcelerator-urban-image-library

3.0 3.0 2.0 135 KB

An Appcelerator module that allows access to a device's photo library

License: Other

Objective-C 54.65% Python 27.95% JavaScript 17.41%

appcelerator-urban-image-library's Introduction

The Urban Image Photo Library Module
===========================================

The purpose of this library is to provide easy access to the user's photo library.
Not only will it return the photos, but it will also return useful information about 
the photo.  This library will return the following pieces of information about a photo:

1. The full resolution of the image
2. A thumbnail of the image
3. The type of file (image or video)
4. Location information including:
	a. latitude
	b. longitude
	c. altitude
	d. course
	e. horizontal accuracy
	f. vertical accuracy
	g. speed
	h. timestamp
5. If the file is a video it will return the duration
6. Orientation
7. Creation Date
8. Available file formats
9. Ways to access the file

This library also provides a way to return certain groups of photos and to also return a 
section of photos based on start and end parameters.

INSTALL THE URBAN IMAGE MODULE
------------------------------

1. First of all, view the "titanium.xcconfig" file located in the root of the module and make sure the TITANIUM_SDK_VERSION
   refers to a version that you have installed.  The Urban Image module was built using version 1.8.0.1.  It should work on 
   previous versions of the Titanium SDK, but the iOS version needs to be 4.0 or higher due to heavy use of the iOS 
   AssetsLibrary which was made available in version 4.0.

   The second attribute to look at is the TITANIUM_SDK location.  Per instructions in the "Module Development" 
   (https://wiki.appcelerator.org/display/guides/iOS+Module+Development+Guide) guide in section 0 
   "Setting Up your Module Environment" you'll need to determine where your Titanium SDK is installed.  It may be 
   installed in "/Library/Application\ Support/Titanium" or "~/Library/Application\ Support/Titanium".  The default
   location is "/Library/Application\ Support/Titanium".

   Save any changes you've made to the "titanium.xcconfig" file.

2. Run 'build.py' this will create a zip file that can then be installed.

3. Copy the newly created zip file to the place where the Titanium SDK is installed.

   cp qs.urbanimage.library-iphone-1.0.zip /Library/Application\ Support/Titanium
   
   --- or if you Titanium SDK is installed in your home directory ---

   cp qs.urbanimage.library-iphone-1.0.zip ~/Library/Application\ Support/Titanium

4. The instructions in the "Testing your Module in a test application" section of the "Module Development" indicate
   that the Titanium compiler will unzip the newly copied module.  That hasn't been my experience.  I have found that
   it is necessary to manually unzip the module.

   cd /Library/Application\ Support/Titanium" or cd ~/Library/Application\ Support/Titanium depending up 
   on where the SDK is located.

   unzip qs.urbanimage.library-iphone-1.0.zip 

   This will install the module into the appropriate directories.

REGISTER THE URBAN IMAGE MODULE
-------------------------------

Register your module with your application by editing `tiapp.xml` and adding your module.
Example:

<modules>
	<module version="0.1">qs.urbanimage.library</module>
</modules>

When you run your project, the compiler will know to automatically compile in your module
dependencies and copy appropriate image assets into the application.

DOCUMENTATION FOR THE URBAN IMAGE MODULE
----------------------------------------

Documentation for this module can be found in documentation/index.md

EXAMPLE CODE
--------------------------
An example application exists in example/app.js that demonstrates the use of the module.  
The example app displays all of the photos from the photo library along with the creation date.
If the photo has location data stored with it then you can click on the photo and it will plot the
photo's location on a map.

appcelerator-urban-image-library's People

Contributors

danalcraig avatar jbeuckm avatar jwswensen avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.