blind

suckless command-line video editing utility
git clone git://git.suckless.org/blind
Log | Files | Refs | README | LICENSE

blind-crop.1 (1840B)


      1 .TH BLIND-CROP 1 blind
      2 .SH NAME
      3 blind-crop - Extract subframes for all frames
      4 .SH SYNOPSIS
      5 .B blind-crop
      6 [-s | -S | -t]
      7 .I width
      8 .I height
      9 .I left
     10 .I top
     11 .SH DESCRIPTION
     12 .B blind-crop
     13 reads a video from stdin and prints a cropped
     14 version of the video to stdout. The new video
     15 with have the specified
     16 .I width
     17 and
     18 .IR height ,
     19 and will have the same length as the input video.
     20 The left-most pixels of the subvideo will be
     21 .I left
     22 pixels rightward of the left-most pixels of the
     23 input video. The top-most pixels of the subvideo
     24 will be
     25 .I top
     26 pixels downward of the top-most pixels of the
     27 input video.
     28 .P
     29 The selected subvideo may not extend beyond the
     30 input video.
     31 .SH OPTIONS
     32 .TP
     33 .B -s
     34 Instead of resizing the video, set alpha (and
     35 all colour parameters) to 0 on each pixel outside
     36 the selected region.
     37 .TP
     38 .B -S
     39 Instead of resizing the video, set alpha (and
     40 all colour parameters) to 0 on each pixel inside
     41 the selected region.
     42 .TP
     43 .B -t
     44 Instead of changing the width and height of
     45 the output video, put the subvideo side-by-side.
     46 The subvideo's left-most pixel will be positioned
     47 .I left
     48 pixels rightward of the output video's left-most pixel,
     49 and the subvideo's top-most pixel will be positioned
     50 .I top
     51 pixels downward of the output video's left-most pixel.
     52 .SH REQUIREMENTS
     53 .B blind-crop
     54 requires enough free memory to load two full frames into
     55 memory, one of the size of the source video's frames,
     56 and one of the size of the target video's frames. However,
     57 if
     58 .B -s
     59 or
     60 .B -S
     61 is used, only memory for one full frame, of the size of
     62 the source video's frames, are required. A frame requires
     63 32 bytes per pixel it contains.
     64 .B blind-crop
     65 has not been optimised for memory usage, but instead
     66 for code simplicity.
     67 .SH SEE ALSO
     68 .BR blind (7),
     69 .BR blind-extend (1),
     70 .BR blind-translate (1)
     71 .SH AUTHORS
     72 Mattias Andrée
     73 .RI < maandree@kth.se >