pfsinyuv(1)

1pfsinyuv(1)                 General Commands Manual                pfsinyuv(1)
2
3
4

NAME

6       pfsinyuv  -  Read  frames  from  a  single .yuv file used by many video
7       codecs
8

SYNOPSIS

10       pfsinyuv  [--verbose]  [--quiet]  [--width]  [--height]  [--colorspace]
11       [--noguess]  [--chroma-subsampling]  [--bit-depth]  [--frames] [--help]
12       <file>
13
14

DESCRIPTION

16       Use this command to read an uncompressed yuv file into a pfsstream.
17
18       <file> may contain one or more formatting strings, which  describe  the
19       format of the yuv file. The formating strings are:
20
21       %s     The entire description in the format <width>x<height>_<fps><bit‐
22              depth>_<colorspace>_<chroma-format>,         for         example
23              1920x1080_25_10b_pq2020_420
24
25       %d     Width in pixels
26
27       %d     Height in pixels
28
29       %d     Bit-depth in bits
30
31       %s     Colorspace, such as 'bt709'
32
33       %s     Chroma subsampling format, either '444' or '420'
34

OPTIONS

36       --width, -w
37              Specify the width in pixels of the YUV file
38
39       --height, -h
40              Specify the height in pixels of the YUV file
41
42       --fps, -f
43              Specify the frames per second of the YUV file
44
45       --bit-depth, -b
46              Bit-depth of the integer values stored in the yuv file. A single
47              color component is stored as a byte if bit-depth is 8, or as two
48              bytes otherwise. Default: 10 [bits]
49
50       --chroma-format, -s
51              Specify the chroma format of the YUV file. Can be one of:
52
53              444 Standard 4:4:4 YCbCr format, with no chroma downsampling]
54
55              420 4:2:0 YCbCr format, with both colour channels downsampled by
56              half
57
58       --colorspace, -c Currently it can be either:
59
60              pq2020 for HDR images with BT.2020 colorspace  and  PQ  transfer
61              function, or
62
63              bt709  for LDR images in BT.709 (rec.709) colorspace without any
64              transfer function or
65
66              hlg2020 for HDR images with BT.2020 colorspace and HLG  transfer
67              function.
68
69       If  no  option is specified, colorspace is inferred from the LUMINANNCE
70       tag in the pfsstream: pq2020 if  LUMINANCE  is  ABSOLUTE  or  RELATIVE,
71       bt709 if LUMINANCE is DISPLAY.
72
73       --no-guess, -n
74              Don't try to extract image metadata from the filename
75
76       --frames, -r
77              Read  only  frames  within the range specified as first:last, or
78              first:step:last. The frames are indexed from 1, so that  the  to
79              read the first and second frame one needs to specify 1:2.
80
81       --verbose, -v
82              Print extra information to stderr.
83
84       --quiet, -q
85              Disable  warning  message  about the change in handling absolute
86              values in RGBE files. See IMPORTANT NOTE below.
87
88

EXAMPLES

90       pfsinyuv video_1920x1080_10b_25fps_pq2020_444.yuv --frames 100:-1:0  -v
91       | pfsview
92
93

IMPORTANT NOTE

BUGS

100       Please  report  bugs  and  comments on implementation to the discussion
101       group http://groups.google.com/group/pfstools
102
103
104
105                                                                   pfsinyuv(1)