Commit b3566631 authored by Jim Nelson's avatar Jim Nelson

#337: Added README, INSTALL, etc. files. #378: More thorough About box. ...

#337: Added README, INSTALL, etc. files.  #378: More thorough About box.  #389: Icon licensing information added to AUTHORS.  #413: Copyright/licensing added to all source files.
parent 28070155
Jim Nelson <jim@yorba.org>
Some of Shotwell's icons are copyright their respective authors:
* Human
http://commons.wikimedia.org/wiki/Human_icons
Licensed under Creative Commons Attribution ShareAlike 2.5
* Breathe Icon Set
https://launchpad.net/breathe-icon-set
Licensed under Creative Commons Attribution ShareAlike 3.0
This diff is collapsed.
Shotwell Installation
---------------------
To build and install Shotwell, type the following commands:
$ ./configure
$ make
$ make install
* By default, Shotwell will install under /usr/local. The configure script
can customize the prefix directory. Run ./configure --help for
instructions and other installation options.
* You may need to execute "make install" as root (i.e. sudo make install)
if installing to system directories.
* If you wish to try Shotwell before installing it, you may execute it
directly from its build directory. Note that certain desktop integration
(such as being listed in an application menu) requires full installation.
Once installed, Shotwell will be available on your desktop Applications
menu under Graphics or Photography.
Copyright 2009 Yorba Foundation
Jim Nelson
email: jim@yorba.org
Shotwell 0.1.0 - 25 June 2009
-----------------------------
- Initial release. Features include:
* Importing photos from file manager or camera via libgphoto.
* Photos automatically sorted into time-grouped events.
* Thumbnails viewable at various sizes.
* Sort by photo name or date of exposure.
* Fullscreen mode.
* Photos may be rotated or cropped.
* Export photos as stored or at varying dimensions and JPEG quality.
* Desktop integration with Applications menu and media device handling.
Shotwell Photo Organizer
------------------------
* Introduction
Shotwell is a digital photo organizer designed for the GNOME desktop
environment. It allows you to import photos from disk or camera,
organize them in various ways, view them in full-window or fullscreen
mode, and export them to share with others.
As this is an early release, not all features normally associated with
photo organizers are implemented. Visit http://www.yorba.org/shotwell for
the current state of its development and to make sure you're running the
latest version.
* Installation & Licensing
Please consult the INSTALL and COPYING files for more information.
* Quick Start
When you first run Shotwell, you'll be presented with an empty window and
two views: Photos and Events. Your first task will be to begin populating
your photo library.
There are two ways to import photos: via drag-and-drop and from a digital
camera.
* Drag-and-drop: Simply drag photos from your file manager and drop them
onto the Shotwell window. You may drag files or directories. The photos
will be imported into the library.
* Camera: Connect your digital camera to your computer. Shotwell will
detect it and list it in the sidebar. When you select the camera, Shotwell
will load previews of each photo. You may choose specific photos to
import or to import them all.
Shotwell uses gphoto to communicate with digital cameras. If your camera
does not appear in Shotwell's sidebar or there is a problem importing
photos, visit http://www.gphoto.org to see if it is supported.
Once your photos are in Shotwell's library, you can view, edit, and export
them. More features are planned, so check http://www.yorba.org/shotwell
regularly for updates.
* Contacting Yorba
Yorba: http://www.yorba.org
Shotwell project page: http://www.yorba.org/shotwell
Shotwell documentation: http://trac.yorba.org:8000/wiki/PhotoOrganizer
We also encourage you to join the Shotwell mailing list. Send an email
with a subject: of "subscribe" (no quotes) to shotwell@lists.yorba.org.
Copyright 2009 Yorba Foundation
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class FullscreenWindow : Gtk.Window {
public static const int TOOLBAR_INVOCATION_MSEC = 250;
......@@ -211,12 +216,12 @@ public class FullscreenWindow : Gtk.Window {
public class AppWindow : Gtk.Window {
public static const string TITLE = "Shotwell";
public static const string SUBTITLE = "Photo Organizer";
public static const string VERSION = "0.1";
public static const string VERSION = "0.1.0";
public static const string COPYRIGHT = "Copyright (c) 2009 Yorba Foundation";
public static const string DATA_DIR = ".shotwell";
public static const string PHOTOS_DIR = "Pictures";
public static const string YORBA_LABEL = "Visit the Yorba Foundation web site";
public static const string YORBA_LABEL = "Visit the Yorba web site";
public static const string YORBA_URL = "http://www.yorba.org";
public static const string APP_URL = "http://www.yorba.org";
public static const string HELP_URL = "http://trac.yorba.org:8000/wiki/PhotoOrganizer";
......@@ -400,9 +405,6 @@ public class AppWindow : Gtk.Window {
private Hal.Context hal_context = new Hal.Context();
private DBus.Connection hal_conn = null;
// NOTE: When new pages are added, they should be added as well to report_backing_changed(),
// and on_remove, if appropriate.
//
// Static (default) pages
private CollectionPage collection_page = null;
private EventsDirectoryPage events_directory_page = null;
......@@ -544,6 +546,7 @@ public class AppWindow : Gtk.Window {
"comments", SUBTITLE,
"copyright", COPYRIGHT,
"website", YORBA_URL,
"license", Resources.LICENSE,
"website-label", YORBA_LABEL,
"authors", AUTHORS,
"logo", Resources.get_icon(Resources.ICON_ABOUT_LOGO, -1)
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public abstract class BatchImportJob {
public abstract string get_identifier();
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public enum BoxLocation {
OUTSIDE,
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public abstract class LayoutItem : Gtk.Alignment {
public static const int LABEL_PADDING = 4;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class CollectionPage : CheckerboardPage {
public static const int SORT_BY_MIN = 0;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class DatabaseTable {
/***
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
namespace Debug {
private bool info_enabled = false;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public enum ScaleConstraint {
ORIGINAL,
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class DirectoryItem : LayoutItem {
public static const Gdk.InterpType INTERP = Gdk.InterpType.BILINEAR;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
namespace Exif {
// "Exif"
public static const uint8[] SIGNATURE = { 0x45, 0x78, 0x69, 0x66 };
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
namespace ExportUI {
private static File current_export_dir = null;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public errordomain GPhotoError {
LIBRARY
}
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
class ImportPreview : LayoutItem {
public int fsid;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public enum Orientation {
MIN = 1,
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class PageMarker {
public Gtk.Widget notebook_page;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public enum ImportResult {
SUCCESS,
FILE_ERROR,
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class CropToolWindow : Gtk.Window {
public static const int CONTROL_SPACING = 8;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
// defined by ./configure and included by gcc -D
extern const string PREFIX;
namespace Resources {
public static const string LICENSE = """
Shotwell is free software; you can redistribute it and/or modify it under the
terms of the GNU Lesser General Public License as published by the Free
Software Foundation; either version 2.1 of the License, or (at your option)
any later version.
Shotwell is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
more details.
You should have received a copy of the GNU Lesser General Public License
along with Shotwell; if not, write to the Free Software Foundation, Inc.,
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
""";
public const string CLOCKWISE = "shotwell-rotate-clockwise";
public const string COUNTERCLOCKWISE = "shotwell-rotate-counterclockwise";
public const string MIRROR = "shotwell-mirror";
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public abstract class Comparator<G> {
public abstract int64 compare(G a, G b);
}
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class Thumbnail : LayoutItem {
// cannot use consts in ThumbnailCache for some reason
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public class ThumbnailCache : Object {
public static const Gdk.InterpType DEFAULT_INTERP = Gdk.InterpType.HYPER;
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
/*
* FStream is a patch of the GLib FileStream object. FileStream does not offer fread() and fwrite()
* wrappers, which is needed for Exif (and possibly other) functions. Rather than patching GLib,
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
#ifndef GPHOTO_H
#define GPHOTO_H
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
Gdk.Color parse_color(string spec) {
return fetch_color(spec);
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
[CCode (
cprefix = "Exif",
lower_case_cprefix="exif_"
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
[CCode (
cprefix="GP",
lower_case_cprefix="gp_"
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
enum ShotwellCommand {
// user-defined commands must be positive ints
......
/* Copyright 2009 Yorba Foundation
*
* This software is licensed under the GNU LGPL (version 2.1 or later).
* See the COPYING file in this distribution.
*/
public uint int64_hash(void *p) {
// Rotating XOR hash
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment