darktable/doc/man/darktable-generate-cache.pod

82 lines
2.5 KiB
Plaintext

=head1 NAME
darktable-generate-cache - update darktable's thumbnail cache
=head1 SYNOPSIS
darktable-generate-cache [-h, --help; --version] [-m, --max-mip <0-7>] [--core <darktable options>]
=head1 DESCRIPTION
B<darktable> is a digital photography workflow application for B<Linux>, B<Mac OS X> and several other B<Unices>.
It's described further in L<darktable(1)|darktable(1)>.
B<darktable-generate-cache> updates darktable's thumbnail cache.
You can start this program to generate all missing thumbnails in the background when your computer is idle.
=head1 OPTIONS
All parameters are optional.
If started without parameters B<darktable-generate-cache> uses reasonable defaults.
=over
=item B<-h, --help>
Gives usage information and terminates.
=item B<--version>
Gives copyright and version information and terminates.
=item B<< --min-mip <0-7> >>
=item B<< -m, --max-mip <0-7> >>
B<darktable> can handle and store thumbnails with up to eight different resolution steps for each image.
These parameters define which maximum resolution should be generated and default to a range of B<0-2>.
There is normally no need to generate all possible resolutions here; missing ones will be automatically generated by darktable the moment they are needed.
When asked to generate multiple resolutions at once, the lower-resolution images are quickly downsampled from the highest-resolution image.
=item B<< --min-imgid <N> >>
=item B<< --max-imgid <N> >>
Specifies the range of internal image IDs from the database to work on.
If no range is given, B<darktable-generate-cache> will process all images from the entire collection.
=item B<< --core <darktable options> >>
All command line parameters following B<--core> are passed
to the darktable core and handled as standard parameters.
See L<darktable(1)|darktable(1)> for a detailed description of the options.
=back
=head1 SEE ALSO
L<darktable(1)|darktable(1)>
=head1 AUTHORS
The principal developer of darktable is Johannes Hanika.
The (hopefully) complete list of contributors to the project is:
DREGGNAUTHORS -- don't translate this line!
This man page was written by Ulrich Pegelow E<lt>ulrich.pegelow@tongareva.deE<gt> as part of the usermanual.
It was turned into a man page by Tobias Ellinghaus E<lt>me@houz.orgE<gt>.
=head1 COPYRIGHT AND LICENSE
B<Copyright (C)> 2009-2017 by Authors.
B<darktable> is free software; you can redistribute it and/or modify it
under the terms of the GPL v3 or (at your option) any later version.
=for comment
$Date: 2017-01-20$
$Release: 2.3$