Skip to content

rolkar/x3f

Repository files navigation

This project contains tools for manipulating X3F files from Sigma cameras.
See doc/readme.txt and doc/copyright.txt.

-------
COMPILE
-------

Download the code.
run 'make'
<wait>
The bin directory contains binaries that can be run directly from the
command line.

-------------
DISTRIBUTIONS
-------------

Alternatively, you can create binaries for multiple platforms by calling:

    make dist-all

as well as the platform specific calls:

    make dist-osx
    make dist-32
    make dist-64

The distribution will be found in the file

    dist/x3f_tools-<VER>-<PLATFORM>

The <VER> part is either the git hash, or if there is a tag on current
commit, that tag.

-------
VAGRANT
-------

If you don't want to install all the dependencies, you can also
install and run in a vagrant.  Doing so requires downloading Vagrant
from http://www.vagrantup.com.  Once you've done so, the commands to
run the code are:

    vagrant up
    <wait>
    make

-----
TESTS
-----

If you want to run tests, type:

    make check

The tests require that a python virtual environment be installable on
the current system.  That precursor can be met either by installing
`pip` and `virtualenv` on your local box, or by running through the
vagrant.  Once that requirement has been met, the makefile will ensure
that the other packages are installed properly.

The other requirement for the tests is to pull down sample images from
the x3f_test_files repository.  This is a one-time download of about
90 mb of Sigma images that are used to run tests.