arcan(1)

NAME
aloadimage - Trivial image viewer for Arcan servers

SYNOPSIS
aloadimage [global_options] file1 file2 ...

DESCRIPTION
aloadimage displays images over an arcan connection point. Each image is parsed in a separate and sandboxed process. If multiple images are provided, a certain number of items will be processed in advance.

OPTIONS

-a, --aspect
    image into output window, maintain source image aspect radio and pad with a background color.

-S, --server-size
    Scale source images to fit server- suggested content size. This changes the primary type from MEDIA (server side scaling) to APPLICATION (client defined scaling).

-l, --loop
    When the playlist reaches the end, it will loop back from the beginning rather than shutting down.

-t, --step-time
    Set the playlist automatic stepping time (default: 0, manual control). The time unit is in ticks on a 25Hz clock.

-b, --block-input
    Ignore all keyboard and mouse input.

-d, --display connpath
    By default, the ARCAN_CONNPATH environment is used in order to find an arcan instance to connect to. This argument ignores that in favor for the connpath argument.

-p, --padcol ,g,b,a
    When running in a scalemode where source size != destination size and output window cannot be resized, the default behavior is to center image and pad the sides. This argument can override the default colors with the restriction that all four channels should be provided and only decimal encoding in the range 0-255 is accepted.

-m, --limit-mem limit(mb)
    Limit the maximum decoded memory sized allowed for eaching loading process.

-r, --readahead limit(count)
    Set the readahead limit for worker processes preloading playlist contents.

-T, --timeout timeout(seconds)
    Stop/kill a worker process if it fails to decode an image within a certain number of seconds.

-x, --no-sysflt
    (build- option) aloadimage may be built with syscall filtering for worker processes. This may break image loading in some environments/libc implementations and may therefore need to be disabled.

-H, --vr
    attempt to connect as a VR compatible output, requires that the listening end accepts HMD_L/R primary and secondary segment types. Playlist items should be prefixed with the intended dominant eye, e.g. l:image_l.jpg r:image_r.jpg.

-h, --help
    Show a brief summary of commands and usage.

ENVIRONMENT

ARCAN_CONNPATH
    Name of the connection point to use when connecting to arcan.

ARCAN_CONNKEY
    Key to use for authenticating againgst the connection path.

COPYRIGHT
Copyright © 2017-2020 Bjorn Stahl. 3-clause BSD licensed. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

AUTHOR
Bjorn Stahl <contact at arcan-fe dot com>