Package: pictureshow
Save pictures to PDF from the command line or from your Python programs.Installationpip install pictureshowUsageAs a command line toolusage: pictureshow [options] PICTURE [PICTURE ...] -o PATH

positional arguments:
  PICTURE               one or more picture paths or URLs

options:
  -h, --help            show this help message and exit
  -a, --fill-area       fill drawing area with picture, ignoring the picture's
                        aspect ratio
  -b COLOR, --bg-color COLOR
                        specify page background color as 6-digit hexadecimal
                        RGB, e.g. ff8c00
  -f, --force-overwrite
                        save to output filename even if file exists
  -F MODE, --fail MODE  If set to `skipped`, fail (exit with code 2) if at
                        least one file was skipped due to an error. If set to
                        `no-output` (default), fail if all files were skipped
                        and no PDF file was created; succeed (exit with code
                        0) if at least one file was successfully saved. If set
                        to `no`, succeed even if all files were skipped.
  -L, --landscape       set landscape orientation of page; default is portrait
  -l LAYOUT, --layout LAYOUT
                        specify grid layout (columns x rows) of pictures on
                        page, e.g. 2x3 or 2,3; default is 1x1
  -m MARGIN, --margin MARGIN
                        set width of empty space around drawing areas; default
                        is 72 (72 points = 1 inch)
  -o PATH, --output-file PATH
                        path of the output PDF file (required)
  -p SIZE, --page-size SIZE
                        specify page size; default is A4 (available sizes: A0,
                        A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, B0, B1, B2,
                        B3, B4, B5, B6, B7, B8, B9, B10, C0, C1, C2, C3, C4,
                        C5, C6, C7, C8, C9, C10, LETTER, LEGAL,
                        ELEVENSEVENTEEN, JUNIOR_LEGAL, HALF_LETTER,
                        GOV_LETTER, GOV_LEGAL, TABLOID, LEDGER)
  -q, --quiet           suppress printing to stdout
  -s, --stretch-small   scale small pictures up to fit drawing areas
  -v, --verbose         show details on files skipped due to error
  -V, --version         show program's version number and exitExamplesSave single picture to PDF:$ pictureshow pics/potato.jpg -o potato.pdf
.
Saved 1 picture (1 page) to 'potato.pdf'Save multiple pictures, four pictures per page (two columns, two rows),
set page orientation to landscape:$ pictureshow -l 2x2 -L vegetables/* -o vegetables
..................................................
Saved 50 pictures (13 pages) to 'vegetables.pdf'(Please note that if the output filename has no extension specified,.pdfwill be appended to it. This only applies for the command line tool.)You can also save pictures from URLs:$ pictureshow https://cdn.rebrickable.com/media/thumbs/parts/elements/6136555.jpg/250x250p.jpg https://cdn.rebrickable.com/media/thumbs/parts/elements/4119478.jpg/250x250p.jpg -o carrots
..
Saved 2 pictures (2 pages) to 'carrots.pdf'But please note that this feature is not tested and depends solely on
the underlyingreportlabbackend.As a Python libraryUsing thePictureShowclassExample:frompictureshowimportPictureShowpictures=PictureShow('pics/cucumber.jpg','pics/onion.jpg',)pictures.save_pdf('vegetables.pdf')The customization parameters of thesave_pdfmethod are keyword-only and
their default values correspond to the above shown command line options:PictureShow.save_pdf(output_file,*,force_overwrite=False,page_size='A4',landscape=False,bg_color=None,layout=(1,1),margin=72,stretch_small=False,fill_area=False,)Using thepictures_to_pdfshortcut functionExample:frompictureshowimportpictures_to_pdfpictures_to_pdf('pics/cucumber.jpg','pics/onion.jpg',output_file='vegetables.pdf',)(Please note that contrary to thePictureShow.save_pdfmethod,output_filemust be specified as a keyword argument in the above example, because thepictures_to_pdffunction treats all positional arguments as input files.)The customization parameters of thepictures_to_pdffunction are keyword-only
and their default values correspond to the above shown command line options:pictures_to_pdf(*pic_files,output_file,force_overwrite=False,page_size='A4',landscape=False,bg_color=None,layout=(1,1),margin=72,stretch_small=False,fill_area=False,)