The Image Compositing Socket Daemon

It's beast I can tell you, once tamed,…

DRAFT
see also sodankylä project and ics.

icsd

run

icsd --help

HTTP interface

ics was intended to react on HTTP parameters only; allowing the base-URL to be independent of the query parameters.

For debug purposes a couple of locations sneaked in:

Location parametersDescription
/stream (A),(B),[D] request rendered video data
/status none display server, decoder & cache status in xHTML
/info (A),[F] return txt or JSON information about the given file/decoder/frame.
/index/.* none (special) lists directories/files under doc-root
.* (A),(B),[C] query frame as image

Parameter can be appended as raw URL encodeded query arguments or specified via HTTP POST header.

  • (A): file=<filename> - path relative to /ics/ document-root.
  • (B): frame=<framenumber 0..N> - frame to display or frame to start streaming.
  • (B): optionally w=<int> and/or h=<int>. Negative numbers imply auto-scaling to aspect-ratio and -1,-1 (the default) mean original size.
  • (C): format=(jpeg,jpg,png,ppm,raw,rgb,rgba) - default is 'jpeg'

only affecting streaming/export

  • (D): container=(avi,flv,ogg,mpeg,mpg,rm,vob) - default is 'avi'
  • (D): nosound=1 - default is 0 (with sound)
  • (D): duration=<video-frame-count> - how long -1: until end of session; default: 100 frames.
  • (D): save_as=<filename> - override HTTP Content-Type to application/octet-stream.

only affecting info

  • (F): optionally format=json

Examples

http://localhost:1554/?frame=800&file=test.avi&format=png&h=200
http://localhost:1554/stream?frame=2350&file=1%2FJoe_Wright%2FAtonement_%282007%29%2FAtonement.avi&duration=1500&container=ogg&.ogg

integration and communication with other tools

 
wiki/icsd.txt · Last modified: 30.04.2012 16:29 by 81.57.94.90