summaryrefslogtreecommitdiff
path: root/help/C/formats.page
diff options
context:
space:
mode:
Diffstat (limited to 'help/C/formats.page')
-rwxr-xr-xhelp/C/formats.page35
1 files changed, 35 insertions, 0 deletions
diff --git a/help/C/formats.page b/help/C/formats.page
new file mode 100755
index 0000000..5b9b19d
--- /dev/null
+++ b/help/C/formats.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="formats">
+
+ <info>
+ <link type="guide" xref="index"/>
+ <desc>Shotwell supports JPEG, PNG, TIFF, BMP and RAW photo files as well as video files.</desc>
+
+ <link type="next" xref="running" />
+ </info>
+
+ <title>Supported photo and video formats</title>
+
+ <p>Shotwell supports JPEG, PNG, TIFF, BMP and <link type="guide" xref="other-raw">RAW</link> photo files. Shotwell does not yet support other graphics format such as GIF.</p>
+
+<p>Shotwell's RAW format support is currently limited. When you view a RAW photo, you are actually viewing a JPEG derived from the RAW photo, not the RAW image itself. Additionally, the RAW editing pipeline is not fully 16-bit - you can only export edited photos as 8-bit files. All supported formats can be used for export (JPEG, PNG, TIFF, BMP).</p>
+
+<p>For more information about RAW-format photos in Shotwell, please see
+the <link type="guide" xref="other-raw">RAW</link> section.
+</p>
+
+<p>Shotwell also supports video files in any format supported by the GStreamer media library on the system where
+Shotwell is running. This typically includes the following formats among others:</p>
+<list>
+<item><p>Container formats: Ogg, QuickTime, MP4, AVI.</p></item>
+<item><p>Codecs: Theora, Quicktime, MPEG-4, Motion JPEG. <em>Note that some operating systems may not include all
+codecs listed here due to legal or licensing restrictions.</em></p></item>
+</list>
+
+<p>Shotwell supports both photos and videos, but for simplicity, this documentation uses just the term "photos"
+in most places. Many operations in Shotwell apply to both photos and videos, however. In particular, events,
+flagging, rating, tagging, and publishing work both for photos and for videos.</p>
+
+</page>
+