Skip to content
Cineast is a multi-feature content-based mulitmedia retrieval engine. It is capable of retrieving images, audio- and video sequences as well as 3d models based on edge or color sketches, sketch-based motion queries and example objects.
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
adampro-grpc @ 9c686e6
config
cottontaildb-proto @ 141b8d5
docs
generated/main
gradle/wrapper
resources
src/org/vitrivr/cineast
tests/org/vitrivr/cineast
.gitignore
.gitmodules
.travis.yml
CODE_OF_CONDUCT.md
LICENSE
README.md
build.gradle
cineast.json
example_job.json
gradlew
gradlew.bat
settings.gradle

README.md

Build Status

Cineast

Cineast is a multi-feature content-based mulitmedia retrieval engine. It is capable of retrieving images, audio- and video sequences as well as 3d models based on edge or color sketches, sketch-based motion queries and example objects. Cineast is written in Java and uses ADAMpro as a storage backend.

Building Cineast

Cineast can be built using Gradle. Building and running it is as easy as

 git clone --recursive https://github.com/vitrivr/cineast.git cineast
 cd cineast
 ./gradlew deploy
 cd build/libs
 java -jar cineast.jar

Prerequisites

System dependencies

  • git
  • JDK 8 or higher
  • Optionally: You should install Docker which you can use for ADAMpro.

3D rendering

For 3D rendering (required in order to support 3D models) you either need a video card or Mesa 3D. The JOGL library supports both. Rendering on Headless devices has been successfully tested with Xvfb. The following steps are required to enable 3D rendering support on a headless device without video card (Ubuntu 16.04.1 LTS)

  1. Install Mesa 3D (should come pre-installed on Ubuntu). Check with dpkg -l | grep mesa
  2. Install Xvfb:
sudo apt-get install xvfb
  1. Start a new screen:
sudo Xvfb :1 -ac -screen 0 1024x768x24 &
  1. Using the new screen, start Cineast:
DISPLAY=:1 java -jar cineast.jar -3d

The -3d option will perform a 3D test. If it succeeds, cineast should generate a PNG image depicting two coloured triangles on a black background.

Contribution

Contributions are always welcome.

Versioning

Cineast uses semantic versioning. See the releases page.

Code Style

Cineast primarily uses the Google Java Styleguide. Please keep the changes you do in compliance with it.

To automatically apply the styleguide in IntelliJ IDEA import the styleguide in File -> Settings -> Editor -> Code Style -> Java and import the scheme via the gear icon.

You can also use Eclipse for development and use Google's styleguide for eclipse.

You can’t perform that action at this time.