0000: 44 20 32 30 31 39 2d 30 34 2d 32 36 54 30 36 3a D 2019-04-26T06:
0010: 33 30 3a 34 37 2e 36 36 32 0a 4c 20 75 76 63 0a 30:47.662.L uvc.
0020: 50 20 33 32 38 64 38 61 62 34 33 62 32 61 38 34 P 328d8ab43b2a84
0030: 36 34 33 34 35 61 66 62 64 37 34 62 35 63 62 33 64345afbd74b5cb3
0040: 65 65 39 32 39 38 38 36 33 35 0a 55 20 63 68 77 ee92988635.U chw
0050: 0a 57 20 31 31 32 36 31 0a 3c 68 32 3e 75 76 63 .W 11261.<h2>uvc
0060: 20 63 6f 6d 6d 61 6e 64 3c 2f 68 32 3e 0d 0a 0d command</h2>...
0070: 0a 3c 68 33 3e 4e 61 6d 65 3c 2f 68 33 3e 0d 0a .<h3>Name</h3>..
0080: 0d 0a 3c 62 3e 75 76 63 3c 2f 62 3e 20 2d 20 49 ..<b>uvc</b> - I
0090: 6e 74 65 72 66 61 63 65 20 74 6f 20 55 56 43 20 nterface to UVC
00a0: 63 61 6d 65 72 61 73 20 75 73 69 6e 67 20 3c 74 cameras using <t
00b0: 74 3e 6c 69 62 75 76 63 3c 2f 74 74 3e 0d 0a 0d t>libuvc</tt>...
00c0: 0a 3c 68 33 3e 53 79 6e 6f 70 73 69 73 3c 2f 68 .<h3>Synopsis</h
00d0: 33 3e 0d 0a 0d 0a 3c 74 74 3e 70 61 63 6b 61 67 3>....<tt>packag
00e0: 65 20 72 65 71 75 69 72 65 20 74 63 6c 75 76 63 e require tcluvc
00f0: 3c 2f 74 74 3e 3c 62 72 3e 0d 0a 3c 74 74 3e 75 </tt><br>..<tt>u
0100: 76 63 20 3c 69 3e 6f 70 74 69 6f 6e 3c 2f 69 3e vc <i>option</i>
0110: 20 3f 3c 69 3e 61 72 67 20 2e 2e 2e 3c 2f 69 3e ?<i>arg ...</i>
0120: 3f 3c 2f 74 74 3e 0d 0a 0d 0a 3c 68 33 3e 44 65 ?</tt>....<h3>De
0130: 73 63 72 69 70 74 69 6f 6e 3c 2f 68 33 3e 0d 0a scription</h3>..
0140: 0d 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 70 ..This command p
0150: 72 6f 76 69 64 65 73 20 73 65 76 65 72 61 6c 20 rovides several
0160: 6f 70 65 72 61 74 69 6f 6e 73 20 74 6f 20 69 6e operations to in
0170: 74 65 72 66 61 63 65 20 55 56 43 20 55 53 42 20 terface UVC USB
0180: 63 61 6d 65 72 61 73 20 75 73 69 6e 67 20 74 68 cameras using th
0190: 65 20 69 6e 66 72 61 73 74 72 75 63 74 75 72 65 e infrastructure
01a0: 20 70 72 6f 76 69 64 65 64 20 62 79 20 3c 74 74 provided by <tt
01b0: 3e 6c 69 62 75 76 63 3c 2f 74 74 3e 20 61 6e 64 >libuvc</tt> and
01c0: 20 3c 74 74 3e 6c 69 62 75 73 62 3c 2f 74 74 3e <tt>libusb</tt>
01d0: 20 77 68 69 63 68 20 69 73 20 61 76 61 69 6c 61 which is availa
01e0: 62 6c 65 20 6f 6e 20 63 6f 6d 6d 6f 6e 20 4c 69 ble on common Li
01f0: 6e 75 78 2c 20 46 72 65 65 42 53 44 2c 20 61 6e nux, FreeBSD, an
0200: 64 20 4d 61 63 4f 53 58 20 70 6c 61 74 66 6f 72 d MacOSX platfor
0210: 6d 73 20 61 6e 64 20 73 6f 6d 65 74 69 6d 65 73 ms and sometimes
0220: 20 66 6f 75 6e 64 20 77 6f 72 6b 69 6e 67 20 6f found working o
0230: 6e 20 41 6e 64 72 6f 69 64 20 64 65 76 69 63 65 n Android device
0240: 73 2e 20 3c 74 74 3e 3c 69 3e 6f 70 74 69 6f 6e s. <tt><i>option
0250: 3c 2f 69 3e 3c 2f 74 74 3e 20 69 6e 64 69 63 61 </i></tt> indica
0260: 74 65 73 20 77 68 61 74 20 74 6f 20 63 61 72 72 tes what to carr
0270: 79 20 6f 75 74 2e 20 41 6e 79 20 75 6e 69 71 75 y out. Any uniqu
0280: 65 20 61 62 62 72 65 76 69 61 74 69 6f 6e 20 66 e abbreviation f
0290: 6f 72 20 3c 74 74 3e 3c 69 3e 6f 70 74 69 6f 6e or <tt><i>option
02a0: 3c 2f 69 3e 3c 2f 74 74 3e 20 69 73 20 61 63 63 </i></tt> is acc
02b0: 65 70 74 61 62 6c 65 2e 20 54 68 65 20 76 61 6c eptable. The val
02c0: 69 64 20 6f 70 74 69 6f 6e 73 20 61 72 65 3a 0d id options are:.
02d0: 0a 0d 0a 3c 74 74 3e 75 76 63 20 63 6c 6f 73 65 ...<tt>uvc close
02e0: 20 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 <i>devid</i></t
02f0: 74 3e 0d 0a 0d 0a 20 20 20 20 43 6c 6f 73 65 73 t>.... Closes
0300: 20 74 68 65 20 64 65 76 69 63 65 20 69 64 65 6e the device iden
0310: 74 69 66 69 65 64 20 62 79 20 3c 74 74 3e 3c 69 tified by <tt><i
0320: 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e 20 >devid</i></tt>
0330: 77 68 69 63 68 20 68 61 73 20 62 65 65 6e 20 6f which has been o
0340: 70 65 6e 65 64 20 62 65 66 6f 72 65 20 75 73 69 pened before usi
0350: 6e 67 20 3c 74 74 3e 75 76 63 20 6f 70 65 6e 3c ng <tt>uvc open<
0360: 2f 74 74 3e 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 /tt>.....<tt>uvc
0370: 20 63 6f 6e 76 6d 6f 64 65 20 3c 69 3e 64 65 76 convmode <i>dev
0380: 69 64 3c 2f 69 3e 20 3f 3c 69 3e 66 6c 61 67 3c id</i> ?<i>flag<
0390: 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 /i>?</tt>....
03a0: 20 52 65 70 6f 72 74 73 20 6f 72 20 6d 6f 64 69 Reports or modi
03b0: 66 69 65 73 20 74 68 65 20 63 6f 6e 76 65 72 73 fies the convers
03c0: 69 6f 6e 20 6d 6f 64 65 20 66 6f 72 20 66 72 61 ion mode for fra
03d0: 6d 65 73 20 61 63 71 75 69 72 65 64 20 66 72 6f mes acquired fro
03e0: 6d 20 74 68 65 20 6f 70 65 6e 65 64 20 64 65 76 m the opened dev
03f0: 69 63 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 ice identified b
0400: 79 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f y <tt><i>devid</
0410: 69 3e 3c 2f 74 74 3e 2e 20 43 6f 6e 76 65 72 73 i></tt>. Convers
0420: 69 6f 6e 20 6d 6f 64 65 20 31 20 28 6f 6e 2f 74 ion mode 1 (on/t
0430: 72 75 65 29 20 70 65 72 66 6f 72 6d 73 20 66 72 rue) performs fr
0440: 61 6d 65 20 66 6f 72 6d 61 74 2f 63 6f 6c 6f 72 ame format/color
0450: 20 73 70 61 63 65 20 63 6f 6e 76 65 72 73 69 6f space conversio
0460: 6e 73 20 69 6e 20 74 68 65 20 73 70 65 63 69 61 ns in the specia
0470: 6c 20 55 56 43 20 74 68 72 65 61 64 20 77 68 69 l UVC thread whi
0480: 63 68 20 63 6f 6e 74 72 6f 6c 73 20 74 68 65 20 ch controls the
0490: 55 53 42 20 74 72 61 6e 73 66 65 72 73 2c 20 6d USB transfers, m
04a0: 6f 64 65 20 30 20 28 6f 66 66 2f 66 61 6c 73 65 ode 0 (off/false
04b0: 29 20 64 6f 65 73 20 74 68 69 73 20 69 6e 73 74 ) does this inst
04c0: 65 61 64 20 69 6e 20 74 68 65 20 6e 6f 72 6d 61 ead in the norma
04d0: 6c 20 54 63 6c 20 65 76 65 6e 74 20 6c 6f 6f 70 l Tcl event loop
04e0: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 6d 6f . The default mo
04f0: 64 65 20 69 73 20 31 2e 20 0d 0a 0d 0a 0d 0a 3c de is 1. ......<
0500: 74 74 3e 75 76 63 20 63 6f 75 6e 74 65 72 73 20 tt>uvc counters
0510: 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 <i>devid</i></tt
0520: 3e 0d 0a 0d 0a 20 20 20 20 52 65 70 6f 72 74 73 >.... Reports
0530: 20 61 20 74 68 72 65 65 20 65 6c 65 6d 65 6e 74 a three element
0540: 20 6c 69 73 74 20 6f 66 20 73 74 61 74 69 73 74 list of statist
0550: 69 63 20 63 6f 75 6e 74 65 72 73 20 6f 6e 20 74 ic counters on t
0560: 68 65 20 64 65 76 69 63 65 20 69 64 65 6e 74 69 he device identi
0570: 66 69 65 64 20 62 79 20 3c 74 74 3e 3c 69 3e 64 fied by <tt><i>d
0580: 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e 2e 20 54 evid</i></tt>. T
0590: 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 he first element
05a0: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o
05b0: 66 20 76 69 64 65 6f 20 66 72 61 6d 65 73 20 72 f video frames r
05c0: 65 63 65 69 76 65 64 2c 20 74 68 65 20 73 65 63 eceived, the sec
05d0: 6f 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ond the number o
05e0: 66 20 76 69 64 65 6f 20 66 72 61 6d 65 73 20 70 f video frames p
05f0: 72 6f 63 65 73 73 65 64 20 77 69 74 68 20 3c 74 rocessed with <t
0600: 74 3e 75 76 63 20 69 6d 61 67 65 3c 2f 74 74 3e t>uvc image</tt>
0610: 2c 20 61 6e 64 20 74 68 65 20 74 68 69 72 64 20 , and the third
0620: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 69 the number of vi
0630: 64 65 6f 20 66 72 61 6d 65 73 20 64 72 6f 70 70 deo frames dropp
0640: 65 64 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 64 ed.....<tt>uvc d
0650: 65 76 69 63 65 73 3c 2f 74 74 3e 0d 0a 0d 0a 20 evices</tt>....
0660: 20 20 20 52 65 74 75 72 6e 73 20 64 65 76 69 63 Returns devic
0670: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 68 e information wh
0680: 69 63 68 20 63 61 6e 20 62 65 20 75 73 65 64 20 ich can be used
0690: 66 6f 72 20 3c 74 74 3e 75 76 63 20 6f 70 65 6e for <tt>uvc open
06a0: 3c 2f 74 74 3e 20 61 73 20 61 20 6c 69 73 74 2e </tt> as a list.
06b0: 20 45 61 63 68 20 64 65 76 69 63 65 20 61 64 64 Each device add
06c0: 73 20 74 68 72 65 65 20 65 6c 65 6d 65 6e 74 73 s three elements
06d0: 20 74 6f 20 74 68 65 20 6c 69 73 74 3a 20 74 68 to the list: th
06e0: 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 e first element
06f0: 69 73 20 74 68 65 20 64 65 76 69 63 65 20 6e 61 is the device na
0700: 6d 65 20 61 73 20 61 20 63 6f 6c 6f 6e 20 73 65 me as a colon se
0710: 70 61 72 61 74 65 64 20 73 74 72 69 6e 67 20 77 parated string w
0720: 69 74 68 20 74 77 6f 20 6f 72 20 74 68 72 65 65 ith two or three
0730: 20 66 69 65 6c 64 73 20 62 65 69 6e 67 20 76 65 fields being ve
0740: 6e 64 6f 72 20 49 44 20 28 68 65 78 61 64 65 63 ndor ID (hexadec
0750: 69 6d 61 6c 2c 20 30 78 20 70 72 65 66 69 78 20 imal, 0x prefix
0760: 69 73 20 6f 70 74 69 6f 6e 61 6c 29 2c 20 70 72 is optional), pr
0770: 6f 64 75 63 74 20 49 44 20 28 68 65 78 61 64 65 oduct ID (hexade
0780: 63 69 6d 61 6c 2c 20 30 78 20 70 72 65 66 69 78 cimal, 0x prefix
0790: 20 69 73 20 6f 70 74 69 6f 6e 61 6c 29 2c 20 61 is optional), a
07a0: 6e 64 20 62 75 73 2f 64 65 76 69 63 65 20 6e 75 nd bus/device nu
07b0: 6d 62 65 72 73 20 73 65 70 61 72 61 74 65 64 20 mbers separated
07c0: 62 79 20 61 20 64 6f 74 3b 20 74 68 65 20 73 65 by a dot; the se
07d0: 63 6f 6e 64 20 61 6e 64 20 74 68 69 72 64 20 6c cond and third l
07e0: 69 73 74 20 65 6c 65 6d 65 6e 74 73 20 61 72 65 ist elements are
07f0: 20 74 68 65 20 76 65 6e 64 6f 72 20 6e 61 6d 65 the vendor name
0800: 2c 20 61 6e 64 20 74 68 65 20 70 72 6f 64 75 63 , and the produc
0810: 74 20 6e 61 6d 65 2e 20 54 6f 20 6f 70 65 6e 20 t name. To open
0820: 74 68 65 20 64 65 76 69 63 65 2c 20 69 74 73 20 the device, its
0830: 6e 61 6d 65 20 28 74 68 65 20 63 6f 6c 6f 6e 20 name (the colon
0840: 73 65 70 61 72 61 74 65 64 20 73 74 72 69 6e 67 separated string
0850: 29 20 6d 75 73 74 20 62 65 20 75 73 65 64 2c 20 ) must be used,
0860: 74 68 65 20 6f 74 68 65 72 20 74 77 6f 20 69 74 the other two it
0870: 65 6d 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c ems are availabl
0880: 65 20 66 6f 72 20 70 72 65 73 65 6e 74 61 74 69 e for presentati
0890: 6f 6e 20 70 75 72 70 6f 73 65 73 2e 20 49 66 20 on purposes. If
08a0: 3c 74 74 3e 75 64 65 76 3c 2f 74 74 3e 20 73 75 <tt>udev</tt> su
08b0: 70 70 6f 72 74 20 69 73 20 61 76 61 69 6c 61 62 pport is availab
08c0: 6c 65 20 28 4c 69 6e 75 78 20 73 70 65 63 69 66 le (Linux specif
08d0: 69 63 29 2c 20 74 68 69 73 20 6c 69 73 74 20 69 ic), this list i
08e0: 73 20 72 65 66 72 65 73 68 65 64 20 6f 6e 20 70 s refreshed on p
08f0: 6c 75 67 20 61 6e 64 20 75 6e 70 6c 75 67 20 6f lug and unplug o
0900: 66 20 64 65 76 69 63 65 73 2e 20 4f 74 68 65 72 f devices. Other
0910: 77 69 73 65 2c 20 74 68 65 20 6c 69 73 74 20 69 wise, the list i
0920: 73 20 61 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 s a snapshot of
0930: 73 75 69 74 61 62 6c 65 20 64 65 76 69 63 65 73 suitable devices
0940: 20 63 75 72 72 65 6e 74 6c 79 20 63 6f 6e 6e 65 currently conne
0950: 63 74 65 64 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 cted.....<tt>uvc
0960: 20 66 6f 72 6d 61 74 20 3c 69 3e 64 65 76 69 64 format <i>devid
0970: 3c 2f 69 3e 20 3f 3c 69 3e 69 6e 64 65 78 20 66 </i> ?<i>index f
0980: 70 73 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a ps</i>?</tt>....
0990: 20 20 20 20 52 65 74 75 72 6e 73 20 6f 72 20 63 Returns or c
09a0: 68 61 6e 67 65 73 20 74 68 65 20 66 72 61 6d 65 hanges the frame
09b0: 20 66 6f 72 6d 61 74 20 6f 66 20 74 68 65 20 64 format of the d
09c0: 65 76 69 63 65 20 69 64 65 6e 74 69 66 69 65 64 evice identified
09d0: 20 62 79 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 by <tt><i>devid
09e0: 3c 2f 69 3e 3c 2f 74 74 3e 2e 20 54 68 65 20 6f </i></tt>. The o
09f0: 70 74 69 6f 6e 61 6c 20 70 61 72 61 6d 65 74 65 ptional paramete
0a00: 72 20 3c 74 74 3e 3c 69 3e 69 6e 64 65 78 3c 2f r <tt><i>index</
0a10: 69 3e 3c 2f 74 74 3e 20 69 73 20 61 6e 20 69 6e i></tt> is an in
0a20: 74 65 67 65 72 20 6e 75 6d 62 65 72 20 67 69 76 teger number giv
0a30: 69 6e 67 20 74 68 65 20 69 6e 64 65 78 20 6f 66 ing the index of
0a40: 20 74 68 65 20 66 72 61 6d 65 20 66 6f 72 6d 61 the frame forma
0a50: 74 20 72 65 74 75 72 6e 65 64 20 69 6e 20 3c 74 t returned in <t
0a60: 74 3e 75 76 63 20 6c 69 73 74 66 6f 72 6d 61 74 t>uvc listformat
0a70: 73 3c 2f 74 74 3e 2e 20 54 68 65 20 6f 70 74 69 s</tt>. The opti
0a80: 6f 6e 61 6c 20 70 61 72 61 6d 65 74 65 72 20 3c onal parameter <
0a90: 74 74 3e 3c 69 3e 66 70 73 3c 2f 69 3e 3c 2f 74 tt><i>fps</i></t
0aa0: 74 3e 20 69 73 20 74 68 65 20 66 72 61 6d 65 20 t> is the frame
0ab0: 72 61 74 65 2e 20 49 66 20 6f 6d 69 74 74 65 64 rate. If omitted
0ac0: 2c 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 , the currently
0ad0: 61 63 74 69 76 65 20 69 6e 64 65 78 20 61 6e 64 active index and
0ae0: 20 66 72 61 6d 65 20 72 61 74 65 20 61 72 65 20 frame rate are
0af0: 72 65 74 75 72 6e 65 64 2e 20 43 68 61 6e 67 69 returned. Changi
0b00: 6e 67 20 74 68 65 20 66 72 61 6d 65 20 66 6f 72 ng the frame for
0b10: 6d 61 74 20 61 6e 64 20 72 61 74 65 20 69 73 20 mat and rate is
0b20: 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 69 66 only possible if
0b30: 20 74 68 65 20 64 65 76 69 63 65 20 69 73 20 6e the device is n
0b40: 6f 74 20 63 61 70 74 75 72 69 6e 67 20 69 6d 61 ot capturing ima
0b50: 67 65 73 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 ges.....<tt>uvc
0b60: 67 72 65 79 73 68 69 66 74 20 3c 69 3e 64 65 76 greyshift <i>dev
0b70: 69 64 3c 2f 69 3e 20 3f 3c 69 3e 73 68 69 66 74 id</i> ?<i>shift
0b80: 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 </i>?</tt>....
0b90: 20 20 52 65 74 75 72 6e 73 20 6f 72 20 73 65 74 Returns or set
0ba0: 73 20 74 68 65 20 62 69 74 20 73 68 69 66 74 20 s the bit shift
0bb0: 74 6f 20 62 65 20 61 70 70 6c 69 65 64 20 6f 6e to be applied on
0bc0: 20 67 72 65 79 20 69 6d 61 67 65 73 20 77 69 74 grey images wit
0bd0: 68 20 61 20 62 69 74 20 64 65 70 74 68 20 68 69 h a bit depth hi
0be0: 67 68 65 72 20 74 68 61 6e 20 38 20 77 68 69 63 gher than 8 whic
0bf0: 68 20 61 72 65 20 63 61 70 74 75 72 65 64 20 66 h are captured f
0c00: 72 6f 6d 20 64 65 76 69 63 65 20 3c 74 74 3e 3c rom device <tt><
0c10: 69 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e i>devid</i></tt>
0c20: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 . The default va
0c30: 6c 75 65 20 69 73 20 34 2c 20 77 68 69 63 68 20 lue is 4, which
0c40: 69 73 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 is suitable for
0c50: 67 72 65 79 73 63 61 6c 65 20 63 61 6d 65 72 61 greyscale camera
0c60: 73 20 77 69 74 68 20 31 32 20 62 69 74 20 72 65 s with 12 bit re
0c70: 73 6f 6c 75 74 69 6f 6e 2e 20 54 68 65 20 73 68 solution. The sh
0c80: 69 66 74 20 69 73 20 6e 6f 74 20 61 70 70 6c 69 ift is not appli
0c90: 65 64 20 77 68 65 6e 20 74 68 65 20 3c 74 74 3e ed when the <tt>
0ca0: 69 6d 61 67 65 3c 2f 74 74 3e 20 73 75 62 63 6f image</tt> subco
0cb0: 6d 6d 61 6e 64 20 72 65 74 72 69 65 76 65 73 20 mmand retrieves
0cc0: 72 61 77 20 62 79 74 65 20 61 72 72 61 79 20 64 raw byte array d
0cd0: 61 74 61 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 ata.....<tt>uvc
0ce0: 69 6d 61 67 65 20 3c 69 3e 64 65 76 69 64 3c 2f image <i>devid</
0cf0: 69 3e 20 3f 3c 69 3e 70 68 6f 74 6f 49 6d 61 67 i> ?<i>photoImag
0d00: 65 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 e</i>?</tt>....
0d10: 20 20 20 43 6f 70 69 65 73 20 74 68 65 20 6d 6f Copies the mo
0d20: 73 74 20 72 65 63 65 6e 74 20 63 61 70 74 75 72 st recent captur
0d30: 65 64 20 69 6d 61 67 65 20 6f 66 20 74 68 65 20 ed image of the
0d40: 64 65 76 69 63 65 20 3c 74 74 3e 3c 69 3e 64 65 device <tt><i>de
0d50: 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e 20 69 6e 74 vid</i></tt> int
0d60: 6f 20 74 68 65 20 70 68 6f 74 6f 20 69 6d 61 67 o the photo imag
0d70: 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 e identified by
0d80: 3c 74 74 3e 3c 69 3e 70 68 6f 74 6f 49 6d 61 67 <tt><i>photoImag
0d90: 65 3c 2f 69 3e 3c 2f 74 74 3e 20 61 6e 64 20 72 e</i></tt> and r
0da0: 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 20 eturns non-zero
0db0: 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 7a 65 on success or ze
0dc0: 72 6f 20 69 66 20 6e 6f 20 64 61 74 61 20 74 72 ro if no data tr
0dd0: 61 6e 73 66 65 72 20 68 61 73 20 74 61 6b 65 6e ansfer has taken
0de0: 20 70 6c 61 63 65 2e 20 49 66 20 3c 74 74 3e 3c place. If <tt><
0df0: 69 3e 70 68 6f 74 6f 49 6d 61 67 65 3c 2f 69 3e i>photoImage</i>
0e00: 3c 2f 74 74 3e 20 69 73 20 6f 6d 69 74 74 65 64 </tt> is omitted
0e10: 2c 20 61 20 66 6f 75 72 20 65 6c 65 6d 65 6e 74 , a four element
0e20: 20 6c 69 73 74 20 69 73 20 72 65 74 75 72 6e 65 list is returne
0e30: 64 20 77 69 74 68 20 74 68 65 20 66 69 72 73 74 d with the first
0e40: 20 65 6c 65 6d 65 6e 74 20 62 65 69 6e 67 20 74 element being t
0e50: 68 65 20 69 6d 61 67 65 20 77 69 64 74 68 2c 20 he image width,
0e60: 74 68 65 20 73 65 63 6f 6e 64 20 74 68 65 20 69 the second the i
0e70: 6d 61 67 65 20 68 65 69 67 68 74 2c 20 74 68 65 mage height, the
0e80: 20 74 68 69 72 64 20 74 68 65 20 6e 75 6d 62 65 third the numbe
0e90: 72 20 6f 66 20 62 79 74 65 73 20 70 65 72 20 70 r of bytes per p
0ea0: 69 78 65 6c 2c 20 61 6e 64 20 74 68 65 20 6c 61 ixel, and the la
0eb0: 73 74 20 74 68 65 20 69 6d 61 67 65 27 73 20 52 st the image's R
0ec0: 47 42 20 76 61 6c 75 65 73 20 77 69 74 68 20 33 GB values with 3
0ed0: 20 62 79 74 65 73 20 70 65 72 20 70 69 78 65 6c bytes per pixel
0ee0: 20 69 6e 20 72 65 64 2c 20 67 72 65 65 6e 2c 20 in red, green,
0ef0: 62 6c 75 65 20 6f 72 64 65 72 20 61 73 20 61 20 blue order as a
0f00: 62 79 74 65 20 61 72 72 61 79 2e 20 49 6e 20 74 byte array. In t
0f10: 68 69 73 20 63 61 73 65 20 61 6e 20 65 72 72 6f his case an erro
0f20: 72 20 69 73 20 69 6e 64 69 63 61 74 65 64 20 62 r is indicated b
0f30: 79 20 74 68 72 6f 77 69 6e 67 20 61 6e 20 65 78 y throwing an ex
0f40: 63 65 70 74 69 6f 6e 2e 0d 0a 0d 0a 3c 74 74 3e ception.....<tt>
0f50: 75 76 63 20 69 6e 66 6f 20 3f 3c 69 3e 64 65 76 uvc info ?<i>dev
0f60: 69 64 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a id</i>?</tt>....
0f70: 20 20 20 20 52 65 74 75 72 6e 73 20 69 6e 66 6f Returns info
0f80: 72 6d 61 74 69 6f 6e 20 6f 6e 20 6f 70 65 6e 20 rmation on open
0f90: 64 65 76 69 63 65 73 2e 20 49 66 20 3c 74 74 3e devices. If <tt>
0fa0: 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 <i>devid</i></tt
0fb0: 3e 20 69 73 20 73 70 65 63 69 66 69 65 64 2c 0d > is specified,.
0fc0: 0a 61 20 6c 69 73 74 20 6f 66 20 74 77 6f 20 65 .a list of two e
0fd0: 6c 65 6d 65 6e 74 73 20 69 73 20 72 65 74 75 72 lements is retur
0fe0: 6e 65 64 2c 20 74 68 65 20 66 69 72 73 74 20 62 ned, the first b
0ff0: 65 69 6e 67 20 74 68 65 20 64 65 76 69 63 65 20 eing the device
1000: 6e 61 6d 65 61 6e 64 0d 0a 74 68 65 20 73 65 63 nameand..the sec
1010: 6f 6e 64 20 74 68 65 20 69 6d 61 67 65 20 63 61 ond the image ca
1020: 6c 6c 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 66 llback command f
1030: 6f 72 20 74 68 61 74 20 64 65 76 69 63 65 2c 20 or that device,
1040: 69 2e 65 2e 20 74 68 65 20 73 61 6d 65 0d 0a 61 i.e. the same..a
1050: 72 67 75 6d 65 6e 74 73 20 77 68 69 63 68 20 77 rguments which w
1060: 65 72 65 20 75 73 65 64 20 6f 6e 20 3c 74 74 3e ere used on <tt>
1070: 75 76 63 20 6f 70 65 6e 3c 2f 74 74 3e 2e 20 49 uvc open</tt>. I
1080: 66 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f f <tt><i>devid</
1090: 69 3e 3c 2f 74 74 3e 20 69 73 20 6f 6d 69 74 74 i></tt> is omitt
10a0: 65 64 2c 20 61 20 6c 69 73 74 20 6f 66 20 3c 74 ed, a list of <t
10b0: 74 3e 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 3c 2f t><i>devid</i></
10c0: 74 74 3e 73 2c 20 69 2e 65 2e 20 61 6c 6c 20 63 tt>s, i.e. all c
10d0: 75 72 72 65 6e 74 6c 79 20 6f 70 65 6e 65 64 20 urrently opened
10e0: 64 65 76 69 63 65 73 20 69 73 20 72 65 74 75 72 devices is retur
10f0: 6e 65 64 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 ned.....<tt>uvc
1100: 6c 69 73 74 65 6e 20 3f 3c 69 3e 63 61 6c 6c 62 listen ?<i>callb
1110: 61 63 6b 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d ack</i>?</tt>...
1120: 0a 20 20 20 20 52 65 74 72 69 65 76 65 73 20 6f . Retrieves o
1130: 72 20 73 65 74 73 20 74 68 65 20 63 61 6c 6c 62 r sets the callb
1140: 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 63 61 6c 6c ack command call
1150: 65 64 20 6f 6e 20 70 6c 75 67 20 61 6e 64 20 75 ed on plug and u
1160: 6e 70 6c 75 67 20 6f 66 20 64 65 76 69 63 65 73 nplug of devices
1170: 2e 20 57 68 65 6e 20 61 20 64 65 76 69 63 65 20 . When a device
1180: 69 73 20 70 6c 75 67 67 65 64 20 6f 72 20 75 6e is plugged or un
1190: 70 6c 75 67 67 65 64 20 74 68 61 74 20 63 61 6c plugged that cal
11a0: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
11b0: 20 77 69 74 68 20 74 77 6f 20 61 64 64 69 74 69 with two additi
11c0: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 73 3a 20 onal arguments:
11d0: 74 68 65 20 74 79 70 65 20 6f 66 20 65 76 65 6e the type of even
11e0: 74 20 28 3c 74 74 3e 61 64 64 3c 2f 74 74 3e 20 t (<tt>add</tt>
11f0: 6f 72 20 3c 74 74 3e 72 65 6d 6f 76 65 3c 2f 74 or <tt>remove</t
1200: 74 3e 29 20 61 6e 64 20 74 68 65 20 64 65 76 69 t>) and the devi
1210: 63 65 20 6e 61 6d 65 20 28 73 65 65 20 3c 74 74 ce name (see <tt
1220: 3e 75 76 63 20 64 65 76 69 63 65 73 3c 2f 74 74 >uvc devices</tt
1230: 3e 20 66 6f 72 20 74 68 65 20 6e 61 6d 69 6e 67 > for the naming
1240: 20 63 6f 6e 76 65 6e 74 69 6f 6e 29 20 77 68 69 convention) whi
1250: 63 68 20 77 61 73 20 61 64 64 65 64 20 6f 72 20 ch was added or
1260: 72 65 6d 6f 76 65 64 2e 20 4f 6e 6c 79 20 75 73 removed. Only us
1270: 61 62 6c 65 20 69 66 20 3c 74 74 3e 75 64 65 76 able if <tt>udev
1280: 3c 2f 74 74 3e 20 73 75 70 70 6f 72 74 20 69 73 </tt> support is
1290: 20 61 76 61 69 6c 61 62 6c 65 2e 0d 0a 0d 0a 3c available.....<
12a0: 74 74 3e 75 76 63 20 6c 69 73 74 66 6f 72 6d 61 tt>uvc listforma
12b0: 74 73 20 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 3c ts <i>devid</i><
12c0: 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 52 65 74 75 /tt>.... Retu
12d0: 72 6e 73 20 61 20 64 69 63 74 69 6f 6e 61 72 79 rns a dictionary
12e0: 20 6b 65 79 65 64 20 62 79 20 61 20 66 6f 72 6d keyed by a form
12f0: 61 74 20 69 6e 64 65 78 20 61 73 20 69 6e 74 65 at index as inte
1300: 67 65 72 20 77 69 74 68 20 74 68 65 20 76 61 6c ger with the val
1310: 75 65 73 20 62 65 69 6e 67 20 61 6e 6f 74 68 65 ues being anothe
1320: 72 20 64 69 63 74 69 6f 6e 61 72 79 20 77 69 74 r dictionary wit
1330: 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 h information ab
1340: 6f 75 74 20 74 68 65 20 66 72 61 6d 65 20 73 69 out the frame si
1350: 7a 65 20 61 6e 64 20 72 61 74 65 20 6f 66 20 74 ze and rate of t
1360: 68 65 20 72 65 73 70 65 63 74 69 76 65 20 66 72 he respective fr
1370: 61 6d 65 20 66 6f 72 6d 61 74 2e 20 54 68 65 20 ame format. The
1380: 72 65 74 75 72 6e 65 64 20 69 6e 64 69 63 65 73 returned indices
1390: 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 can be used in
13a0: 69 6e 20 3c 74 74 3e 75 76 63 20 66 6f 72 6d 61 in <tt>uvc forma
13b0: 74 3c 2f 74 74 3e 20 74 6f 20 73 77 69 74 63 68 t</tt> to switch
13c0: 20 74 6f 20 61 6e 6f 74 68 65 72 20 66 72 61 6d to another fram
13d0: 65 20 73 69 7a 65 20 61 6e 64 2f 6f 72 20 74 6f e size and/or to
13e0: 20 63 68 61 6e 67 65 20 74 68 65 20 66 72 61 6d change the fram
13f0: 65 20 72 61 74 65 2e 0d 0a 0d 0a 3c 74 74 3e 75 e rate.....<tt>u
1400: 76 63 20 6d 62 63 6f 70 79 20 3c 69 3e 62 79 74 vc mbcopy <i>byt
1410: 65 61 72 72 61 79 31 20 62 79 74 65 61 72 72 61 earray1 bytearra
1420: 79 32 20 6d 61 73 6b 3c 2f 69 3e 3c 2f 74 74 3e y2 mask</i></tt>
1430: 0d 0a 0d 0a 20 20 20 20 43 6f 70 69 65 73 20 74 .... Copies t
1440: 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 52 47 he content of RG
1450: 42 20 62 79 74 65 20 61 72 72 61 79 20 3c 74 74 B byte array <tt
1460: 3e 3c 69 3e 62 79 74 65 61 72 72 61 79 32 3c 2f ><i>bytearray2</
1470: 69 3e 3c 2f 74 74 3e 20 69 6e 74 6f 20 74 68 65 i></tt> into the
1480: 20 62 79 74 65 20 61 72 72 61 79 20 3c 74 74 3e byte array <tt>
1490: 3c 69 3e 62 79 74 65 61 72 72 61 79 31 3c 2f 69 <i>bytearray1</i
14a0: 3e 3c 2f 74 74 3e 20 75 73 69 6e 67 20 61 6e 20 ></tt> using an
14b0: 52 47 42 20 3c 74 74 3e 3c 69 3e 6d 61 73 6b 3c RGB <tt><i>mask<
14c0: 2f 69 3e 3c 2f 74 74 3e 2e 20 42 6f 74 68 20 62 /i></tt>. Both b
14d0: 79 74 65 20 61 72 72 61 79 73 20 6d 75 73 74 20 yte arrays must
14e0: 68 61 76 65 20 69 64 65 6e 74 69 63 61 6c 20 6c have identical l
14f0: 65 6e 67 74 68 20 77 68 69 63 68 20 6d 75 73 74 ength which must
1500: 20 62 65 20 61 20 6d 75 6c 74 69 70 6c 65 20 6f be a multiple o
1510: 66 20 33 20 28 66 6f 72 20 52 47 42 29 2e 20 54 f 3 (for RGB). T
1520: 68 65 20 6d 61 69 6e 20 70 75 72 70 6f 73 65 20 he main purpose
1530: 6f 66 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 of this command
1540: 69 73 20 74 6f 20 63 6f 6d 62 69 6e 65 20 69 6d is to combine im
1550: 61 67 65 73 20 66 72 6f 6d 20 74 77 6f 20 63 61 ages from two ca
1560: 6d 65 72 61 73 20 69 6e 74 6f 20 61 6e 20 61 6e meras into an an
1570: 61 67 6c 79 70 68 20 33 44 2c 20 77 68 65 72 65 aglyph 3D, where
1580: 20 28 66 6f 72 20 61 20 72 65 64 2d 63 79 61 6e (for a red-cyan
1590: 20 61 6e 61 67 6c 79 70 68 29 20 74 68 65 20 6c anaglyph) the l
15a0: 65 66 74 20 63 61 6d 65 72 61 20 69 6d 61 67 65 eft camera image
15b0: 20 75 73 65 73 20 6d 61 73 6b 20 30 78 46 46 30 uses mask 0xFF0
15c0: 30 30 30 20 28 72 65 64 20 63 6f 6d 70 6f 6e 65 000 (red compone
15d0: 6e 74 29 20 61 6e 64 20 74 68 65 20 72 69 67 68 nt) and the righ
15e0: 74 20 63 61 6d 65 72 61 20 69 6d 61 67 65 20 75 t camera image u
15f0: 73 65 73 20 6d 61 73 6b 20 30 78 30 30 46 46 46 ses mask 0x00FFF
1600: 46 20 28 67 72 65 65 6e 20 61 6e 64 20 62 6c 75 F (green and blu
1610: 65 20 63 6f 6d 70 6f 6e 65 6e 74 73 29 2e 0d 0a e components)...
1620: 0d 0a 3c 74 74 3e 75 76 63 20 6d 63 6f 70 79 20 ..<tt>uvc mcopy
1630: 3c 69 3e 70 68 6f 74 6f 31 20 70 68 6f 74 6f 32 <i>photo1 photo2
1640: 20 6d 61 73 6b 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a mask</i></tt>..
1650: 0d 0a 20 20 20 20 43 6f 70 69 65 73 20 74 68 65 .. Copies the
1660: 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 content of the
1670: 70 68 6f 74 6f 20 69 6d 61 67 65 20 3c 74 74 3e photo image <tt>
1680: 3c 69 3e 70 68 6f 74 6f 32 3c 2f 69 3e 3c 2f 74 <i>photo2</i></t
1690: 74 3e 20 69 6e 74 6f 20 74 68 65 20 70 68 6f 74 t> into the phot
16a0: 6f 20 69 6d 61 67 65 20 3c 74 74 3e 3c 69 3e 70 o image <tt><i>p
16b0: 68 6f 74 6f 31 3c 2f 69 3e 3c 2f 74 74 3e 20 75 hoto1</i></tt> u
16c0: 73 69 6e 67 20 61 6e 20 41 52 47 42 20 3c 74 74 sing an ARGB <tt
16d0: 3e 3c 69 3e 6d 61 73 6b 3c 2f 69 3e 3c 2f 74 74 ><i>mask</i></tt
16e0: 3e 2e 20 42 6f 74 68 20 70 68 6f 74 6f 20 69 6d >. Both photo im
16f0: 61 67 65 73 20 6d 75 73 74 20 68 61 76 65 20 69 ages must have i
1700: 64 65 6e 74 69 63 61 6c 20 77 69 64 74 68 2c 20 dentical width,
1710: 68 65 69 67 68 74 2c 20 61 6e 64 20 64 65 70 74 height, and dept
1720: 68 2e 20 54 68 65 20 6d 61 69 6e 20 70 75 72 70 h. The main purp
1730: 6f 73 65 20 6f 66 20 74 68 69 73 20 63 6f 6d 6d ose of this comm
1740: 61 6e 64 20 69 73 20 74 6f 20 63 6f 6d 62 69 6e and is to combin
1750: 65 20 69 6d 61 67 65 73 20 66 72 6f 6d 20 74 77 e images from tw
1760: 6f 20 63 61 6d 65 72 61 73 20 69 6e 74 6f 20 61 o cameras into a
1770: 6e 20 61 6e 61 67 6c 79 70 68 20 33 44 2c 20 77 n anaglyph 3D, w
1780: 68 65 72 65 20 28 66 6f 72 20 61 20 72 65 64 2d here (for a red-
1790: 63 79 61 6e 20 61 6e 61 67 6c 79 70 68 29 20 74 cyan anaglyph) t
17a0: 68 65 20 6c 65 66 74 20 63 61 6d 65 72 61 20 69 he left camera i
17b0: 6d 61 67 65 20 75 73 65 73 20 6d 61 73 6b 20 30 mage uses mask 0
17c0: 78 30 30 46 46 30 30 30 30 20 28 72 65 64 20 63 x00FF0000 (red c
17d0: 6f 6d 70 6f 6e 65 6e 74 29 20 61 6e 64 20 74 68 omponent) and th
17e0: 65 20 72 69 67 68 74 20 63 61 6d 65 72 61 20 69 e right camera i
17f0: 6d 61 67 65 20 75 73 65 73 20 6d 61 73 6b 20 30 mage uses mask 0
1800: 78 30 30 30 30 46 46 46 46 20 28 67 72 65 65 6e x0000FFFF (green
1810: 20 61 6e 64 20 62 6c 75 65 20 63 6f 6d 70 6f 6e and blue compon
1820: 65 6e 74 73 29 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 ents).....<tt>uv
1830: 63 20 6d 69 72 72 6f 72 20 3c 69 3e 64 65 76 69 c mirror <i>devi
1840: 64 3c 2f 69 3e 20 3f 3c 69 3e 78 20 79 3c 2f 69 d</i> ?<i>x y</i
1850: 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 52 >?</tt>.... R
1860: 65 74 72 69 65 76 65 73 20 6f 72 20 73 65 74 73 etrieves or sets
1870: 20 66 6c 61 67 73 20 74 6f 20 6d 69 72 72 6f 72 flags to mirror
1880: 20 63 61 70 74 75 72 65 64 20 69 6d 61 67 65 73 captured images
1890: 20 61 6c 6f 6e 67 20 74 68 65 20 58 20 6f 72 20 along the X or
18a0: 59 20 61 78 69 73 2e 20 50 61 72 61 6d 65 74 65 Y axis. Paramete
18b0: 72 73 20 3c 74 74 3e 3c 69 3e 78 3c 2f 69 3e 3c rs <tt><i>x</i><
18c0: 2f 74 74 3e 20 61 6e 64 20 3c 74 74 3e 3c 69 3e /tt> and <tt><i>
18d0: 79 3c 2f 69 3e 3c 2f 74 74 3e 20 69 66 20 73 70 y</i></tt> if sp
18e0: 65 63 69 66 69 65 64 20 6d 75 73 74 20 62 65 20 ecified must be
18f0: 62 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 73 2e 0d boolean values..
1900: 0a 0d 0a 3c 74 74 3e 75 76 63 20 6f 70 65 6e 20 ...<tt>uvc open
1910: 3c 69 3e 64 65 76 6e 61 6d 65 20 63 61 6c 6c 62 <i>devname callb
1920: 61 63 6b 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a ack</i></tt>....
1930: 20 20 20 20 4f 70 65 6e 73 20 74 68 65 20 64 65 Opens the de
1940: 76 69 63 65 20 77 69 74 68 20 64 65 76 69 63 65 vice with device
1950: 20 6e 61 6d 65 20 3c 74 74 3e 3c 69 3e 64 65 76 name <tt><i>dev
1960: 6e 61 6d 65 3c 2f 69 3e 3c 2f 74 74 3e 20 61 6e name</i></tt> an
1970: 64 20 65 73 74 61 62 6c 69 73 68 65 73 20 3c 74 d establishes <t
1980: 74 3e 3c 69 3e 63 61 6c 6c 62 61 63 6b 3c 2f 69 t><i>callback</i
1990: 3e 3c 2f 74 74 3e 20 61 73 20 63 6f 6d 6d 61 6e ></tt> as comman
19a0: 64 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 d to be invoked
19b0: 6f 6e 20 63 61 70 74 75 72 65 64 20 69 6d 61 67 on captured imag
19c0: 65 73 20 61 6e 64 20 66 69 6e 61 6c 6c 79 20 72 es and finally r
19d0: 65 74 75 72 6e 73 20 61 20 3c 74 74 3e 3c 69 3e eturns a <tt><i>
19e0: 64 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e 2c 20 devid</i></tt>,
19f0: 69 2e 65 2e 20 61 20 68 61 6e 64 6c 65 20 74 6f i.e. a handle to
1a00: 20 66 75 72 74 68 65 72 20 64 65 61 6c 20 77 69 further deal wi
1a10: 74 68 20 74 68 65 20 64 65 76 69 63 65 2e 20 41 th the device. A
1a20: 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 61 72 n additional par
1a30: 61 6d 65 74 65 72 20 69 73 20 61 70 70 65 6e 64 ameter is append
1a40: 65 64 20 77 68 65 6e 20 3c 74 74 3e 3c 69 3e 63 ed when <tt><i>c
1a50: 61 6c 6c 62 61 63 6b 3c 2f 69 3e 3c 2f 74 74 3e allback</i></tt>
1a60: 20 69 73 20 69 6e 76 6f 6b 65 64 3a 20 74 68 65 is invoked: the
1a70: 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f 69 <tt><i>devid</i
1a80: 3e 3c 2f 74 74 3e 20 6f 66 20 74 68 65 20 64 65 ></tt> of the de
1a90: 76 69 63 65 2e 20 46 6f 72 20 74 68 65 20 66 6f vice. For the fo
1aa0: 72 6d 61 74 20 6f 66 20 3c 74 74 3e 3c 69 3e 64 rmat of <tt><i>d
1ab0: 65 76 6e 61 6d 65 3c 2f 69 3e 3c 2f 74 74 3e 20 evname</i></tt>
1ac0: 73 65 65 20 74 68 65 20 64 65 73 63 72 69 70 74 see the descript
1ad0: 69 6f 6e 20 6f 66 20 3c 74 74 3e 75 76 63 20 64 ion of <tt>uvc d
1ae0: 65 76 69 63 65 73 3c 2f 74 74 3e 2e 0d 0a 0d 0a evices</tt>.....
1af0: 3c 74 74 3e 75 76 63 20 6f 72 69 65 6e 74 61 74 <tt>uvc orientat
1b00: 69 6f 6e 20 3c 69 3e 64 65 76 69 64 3c 2f 69 3e ion <i>devid</i>
1b10: 20 3f 3c 69 3e 64 65 67 72 65 65 73 3c 2f 69 3e ?<i>degrees</i>
1b20: 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 52 65 ?</tt>.... Re
1b30: 74 72 69 65 76 65 73 20 6f 72 20 73 65 74 73 20 trieves or sets
1b40: 74 68 65 20 6f 72 69 65 6e 74 61 74 69 6f 6e 20 the orientation
1b50: 6f 66 20 63 61 70 74 75 72 65 64 20 69 6d 61 67 of captured imag
1b60: 65 73 20 72 65 67 61 72 64 69 6e 67 20 69 6d 61 es regarding ima
1b70: 67 65 20 72 6f 74 61 74 69 6f 6e 2e 20 3c 74 74 ge rotation. <tt
1b80: 3e 3c 69 3e 64 65 67 72 65 65 73 3c 2f 69 3e 3c ><i>degrees</i><
1b90: 2f 74 74 3e 20 69 66 20 73 70 65 63 69 66 69 65 /tt> if specifie
1ba0: 64 20 6d 75 73 74 20 62 65 20 61 6e 20 69 6e 74 d must be an int
1bb0: 65 67 65 72 20 6e 75 6d 62 65 72 2e 0d 0a 0d 0a eger number.....
1bc0: 3c 74 74 3e 75 76 63 20 70 61 72 61 6d 65 74 65 <tt>uvc paramete
1bd0: 72 73 20 3c 69 3e 64 65 76 69 64 3c 2f 69 3e 20 rs <i>devid</i>
1be0: 3f 3c 69 3e 6b 65 79 20 76 61 6c 75 65 20 2e 2e ?<i>key value ..
1bf0: 2e 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d 0a 0d 0a 20 .</i>?</tt>....
1c00: 20 20 20 52 65 74 75 72 6e 73 20 6f 72 20 63 68 Returns or ch
1c10: 61 6e 67 65 73 20 64 65 76 69 63 65 20 70 61 72 anges device par
1c20: 61 6d 65 74 65 72 73 20 66 6f 72 20 74 68 65 20 ameters for the
1c30: 64 65 76 69 63 65 20 69 64 65 6e 74 69 66 69 65 device identifie
1c40: 64 20 62 79 20 3c 74 74 3e 3c 69 3e 64 65 76 69 d by <tt><i>devi
1c50: 64 3c 2f 69 3e 3c 2f 74 74 3e 20 67 69 76 65 6e d</i></tt> given
1c60: 20 61 73 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 as key-value pa
1c70: 69 72 73 2c 20 65 2e 67 2e 20 3c 74 74 3e 62 72 irs, e.g. <tt>br
1c80: 69 67 68 74 6e 65 73 73 20 31 30 30 3c 2f 74 74 ightness 100</tt
1c90: 3e 20 77 69 6c 6c 20 63 68 61 6e 67 65 20 74 68 > will change th
1ca0: 65 20 62 72 69 67 68 74 6e 65 73 73 20 73 65 74 e brightness set
1cb0: 74 69 6e 67 20 6f 66 20 63 61 70 74 75 72 65 64 ting of captured
1cc0: 20 69 6d 61 67 65 73 20 74 6f 20 74 68 65 20 64 images to the d
1cd0: 65 76 69 63 65 20 64 65 70 65 6e 64 65 6e 74 20 evice dependent
1ce0: 76 61 6c 75 65 20 31 30 30 2e 20 54 68 65 20 63 value 100. The c
1cf0: 6f 6d 6d 61 6e 64 20 72 65 74 75 72 6e 73 20 74 ommand returns t
1d00: 68 65 20 63 75 72 72 65 6e 74 20 64 65 76 69 63 he current devic
1d10: 65 20 70 61 72 61 6d 65 74 65 72 73 20 28 61 66 e parameters (af
1d20: 74 65 72 20 74 68 65 20 70 6f 74 65 6e 74 69 61 ter the potentia
1d30: 6c 20 63 68 61 6e 67 65 2c 20 77 68 65 6e 20 6b l change, when k
1d40: 65 79 73 20 61 6e 64 20 76 61 6c 75 65 73 20 77 eys and values w
1d50: 65 72 65 20 67 69 76 65 6e 29 20 61 73 20 61 20 ere given) as a
1d60: 6b 65 79 2d 76 61 6c 75 65 20 6c 69 73 74 20 77 key-value list w
1d70: 68 69 63 68 20 63 61 6e 20 62 65 20 70 72 6f 63 hich can be proc
1d80: 65 73 73 65 64 20 77 69 74 68 20 3c 74 74 3e 61 essed with <tt>a
1d90: 72 72 61 79 20 73 65 74 3c 2f 74 74 3e 20 6f 72 rray set</tt> or
1da0: 20 3c 74 74 3e 64 69 63 74 20 67 65 74 3c 2f 74 <tt>dict get</t
1db0: 74 3e 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 72 t>.....<tt>uvc r
1dc0: 65 63 6f 72 64 20 3c 69 3e 64 65 76 69 64 3c 2f ecord <i>devid</
1dd0: 69 3e 20 66 72 61 6d 65 20 3c 69 3e 77 69 64 74 i> frame <i>widt
1de0: 68 20 68 65 69 67 68 74 20 62 70 70 20 62 79 74 h height bpp byt
1df0: 65 61 72 72 61 79 3c 2f 69 3e 3c 2f 74 74 3e 0d earray</i></tt>.
1e00: 0a 0d 0a 20 20 20 20 54 72 61 6e 73 63 6f 64 65 ... Transcode
1e10: 73 20 74 68 65 20 66 72 61 6d 65 20 64 65 73 63 s the frame desc
1e20: 72 69 62 65 64 20 62 79 20 3c 74 74 3e 3c 69 3e ribed by <tt><i>
1e30: 77 69 64 74 68 3c 2f 69 3e 3c 2f 74 74 3e 2c 20 width</i></tt>,
1e40: 3c 74 74 3e 3c 69 3e 68 65 69 67 68 74 3c 2f 69 <tt><i>height</i
1e50: 3e 3c 2f 74 74 3e 2c 20 3c 74 74 3e 3c 69 3e 62 ></tt>, <tt><i>b
1e60: 70 70 3c 2f 69 3e 3c 2f 74 74 3e 2c 20 61 6e 64 pp</i></tt>, and
1e70: 20 3c 74 74 3e 3c 69 3e 62 79 74 65 61 72 72 61 <tt><i>bytearra
1e80: 79 3c 2f 69 3e 3c 2f 74 74 3e 20 74 6f 20 4a 50 y</i></tt> to JP
1e90: 45 47 20 61 6e 64 20 77 72 69 74 65 73 20 74 68 EG and writes th
1ea0: 65 20 72 65 73 75 6c 74 20 74 6f 20 74 68 65 20 e result to the
1eb0: 72 65 63 6f 72 64 69 6e 67 20 66 69 6c 65 20 6f recording file o
1ec0: 72 20 73 74 72 65 61 6d 2e 20 54 68 65 20 72 65 r stream. The re
1ed0: 63 6f 72 64 69 6e 67 20 6d 75 73 74 20 68 61 76 cording must hav
1ee0: 65 20 62 65 65 6e 20 73 74 61 72 74 65 64 20 77 e been started w
1ef0: 69 74 68 20 74 68 65 20 3c 74 74 3e 2d 75 73 65 ith the <tt>-use
1f00: 72 3c 2f 74 74 3e 20 6f 70 74 69 6f 6e 2e 20 41 r</tt> option. A
1f10: 6e 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 n integer number
1f20: 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 73 20 is returned as
1f30: 72 65 73 75 6c 74 3a 20 31 20 69 6e 64 69 63 61 result: 1 indica
1f40: 74 65 73 20 73 75 63 63 65 73 73 66 75 6c 20 77 tes successful w
1f50: 72 69 74 65 2c 20 30 20 6e 6f 20 77 72 69 74 65 rite, 0 no write
1f60: 20 64 75 65 20 74 6f 20 66 72 61 6d 65 20 72 61 due to frame ra
1f70: 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 2c 20 te constraints,
1f80: 61 6e 64 20 2d 31 20 61 6e 20 65 72 72 6f 72 20 and -1 an error
1f90: 64 75 72 69 6e 67 20 74 68 65 20 77 72 69 74 65 during the write
1fa0: 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 72 65 63 .....<tt>uvc rec
1fb0: 6f 72 64 20 3c 69 3e 64 65 76 69 64 3c 2f 69 3e ord <i>devid</i>
1fc0: 20 70 61 75 73 65 3c 2f 74 74 3e 0d 0a 0d 0a 20 pause</tt>....
1fd0: 20 20 20 50 61 75 73 65 73 20 72 65 63 6f 72 64 Pauses record
1fe0: 69 6e 67 20 74 6f 20 61 20 66 69 6c 65 20 6f 72 ing to a file or
1ff0: 20 73 74 72 65 61 6d 2e 0d 0a 0d 0a 3c 74 74 3e stream.....<tt>
2000: 75 76 63 20 72 65 63 6f 72 64 20 3c 69 3e 64 65 uvc record <i>de
2010: 76 69 64 3c 2f 69 3e 20 72 65 73 75 6d 65 3c 2f vid</i> resume</
2020: 74 74 3e 0d 0a 0d 0a 20 20 20 20 43 6f 6e 74 69 tt>.... Conti
2030: 6e 75 65 73 20 72 65 63 6f 72 64 69 6e 67 20 74 nues recording t
2040: 6f 20 61 20 66 69 6c 65 20 6f 72 20 73 74 72 65 o a file or stre
2050: 61 6d 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 72 am.....<tt>uvc r
2060: 65 63 6f 72 64 20 3c 69 3e 64 65 76 69 64 3c 2f ecord <i>devid</
2070: 69 3e 20 73 74 61 72 74 20 3c 69 3e 6f 70 74 69 i> start <i>opti
2080: 6f 6e 73 20 2e 2e 2e 3c 2f 69 3e 3c 2f 74 74 3e ons ...</i></tt>
2090: 0d 0a 0d 0a 20 20 20 20 53 74 61 72 74 73 20 72 .... Starts r
20a0: 65 63 6f 72 64 69 6e 67 20 74 6f 20 61 20 66 69 ecording to a fi
20b0: 6c 65 20 6f 72 20 73 74 72 65 61 6d 2e 20 3c 74 le or stream. <t
20c0: 74 3e 3c 69 3e 6f 70 74 69 6f 6e 73 3c 2f 69 3e t><i>options</i>
20d0: 3c 2f 74 74 3e 20 63 6f 6e 74 72 6f 6c 20 74 68 </tt> control th
20e0: 65 20 64 61 74 61 20 66 6f 72 6d 61 74 2c 20 66 e data format, f
20f0: 72 61 6d 65 73 20 70 65 72 20 73 65 63 6f 6e 64 rames per second
2100: 2c 20 61 6e 64 20 6f 75 74 70 75 74 20 63 68 61 , and output cha
2110: 6e 6e 65 6c 2e 20 54 68 65 20 6f 70 74 69 6f 6e nnel. The option
2120: 20 3c 74 74 3e 2d 66 70 73 3c 2f 74 74 3e 20 73 <tt>-fps</tt> s
2130: 70 65 63 69 66 69 65 73 20 74 68 65 20 61 70 70 pecifies the app
2140: 72 6f 78 69 6d 61 74 65 20 72 61 74 65 20 69 6e roximate rate in
2150: 20 66 72 61 6d 65 73 20 70 65 72 20 73 65 63 6f frames per seco
2160: 6e 64 20 61 73 20 61 20 66 6c 6f 61 74 69 6e 67 nd as a floating
2170: 20 70 6f 69 6e 74 20 6e 75 6d 62 65 72 2e 20 54 point number. T
2180: 68 65 20 6f 70 74 69 6f 6e 20 3c 74 74 3e 2d 63 he option <tt>-c
2190: 68 61 6e 3c 2f 74 74 3e 20 73 70 65 63 69 66 69 han</tt> specifi
21a0: 65 73 20 74 68 65 20 63 68 61 6e 6e 65 6c 20 74 es the channel t
21b0: 6f 20 77 68 69 63 68 20 74 68 65 20 66 72 61 6d o which the fram
21c0: 65 73 20 61 72 65 20 77 72 69 74 74 65 6e 2e 20 es are written.
21d0: 54 68 69 73 20 63 68 61 6e 6e 65 6c 20 69 73 20 This channel is
21e0: 64 65 74 61 63 68 65 64 20 66 72 6f 6d 20 74 68 detached from th
21f0: 65 20 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65 e Tcl interprete
2200: 72 20 61 6e 64 20 63 6f 6e 74 72 6f 6c 6c 65 64 r and controlled
2210: 20 73 6f 6c 65 6c 79 20 62 79 20 74 68 65 20 20 solely by the
2220: 3c 74 74 3e 75 76 63 20 72 65 63 6f 72 64 3c 2f <tt>uvc record</
2230: 74 74 3e 20 63 6f 6d 6d 61 6e 64 2e 20 54 68 65 tt> command. The
2240: 20 3c 74 74 3e 2d 62 6f 75 6e 64 61 72 79 3c 2f <tt>-boundary</
2250: 74 74 3e 20 6f 70 74 69 6f 6e 20 73 70 65 63 69 tt> option speci
2260: 66 69 65 73 20 61 20 4d 49 4d 45 20 6d 75 6c 74 fies a MIME mult
2270: 69 70 61 72 74 20 62 6f 75 6e 64 61 72 79 20 73 ipart boundary s
2280: 74 72 69 6e 67 20 61 6e 64 20 73 65 6c 65 63 74 tring and select
2290: 73 20 74 68 65 20 4d 49 4d 45 20 74 79 70 65 20 s the MIME type
22a0: 3c 74 74 3e 6d 75 6c 74 69 70 61 72 74 2f 78 2d <tt>multipart/x-
22b0: 6d 69 78 65 64 2d 72 65 70 6c 61 63 65 3c 2f 74 mixed-replace</t
22c0: 74 3e 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 t> suitable for
22d0: 73 74 72 65 61 6d 69 6e 67 20 74 6f 20 61 20 77 streaming to a w
22e0: 65 62 20 62 72 6f 77 73 65 72 2e 20 54 68 65 20 eb browser. The
22f0: 63 6f 6e 74 65 6e 74 20 74 79 70 65 20 64 65 6c content type del
2300: 69 76 65 72 65 64 20 74 6f 20 74 68 65 20 62 72 ivered to the br
2310: 6f 77 73 65 72 20 69 73 20 3c 74 74 3e 69 6d 61 owser is <tt>ima
2320: 67 65 2f 6a 70 65 67 3c 2f 74 74 3e 2e 20 49 66 ge/jpeg</tt>. If
2330: 20 74 68 65 20 3c 74 74 3e 2d 62 6f 75 6e 64 61 the <tt>-bounda
2340: 72 79 3c 2f 74 74 3e 20 6f 70 74 69 6f 6e 20 69 ry</tt> option i
2350: 73 20 6f 6d 69 74 74 65 64 2c 20 74 68 65 20 6f s omitted, the o
2360: 75 74 70 75 74 20 66 6f 72 6d 61 74 20 69 73 20 utput format is
2370: 72 61 77 20 41 56 49 20 61 6e 64 20 72 65 71 75 raw AVI and requ
2380: 69 72 65 73 20 74 68 65 20 63 68 61 6e 6e 65 6c ires the channel
2390: 20 74 6f 20 62 65 20 73 65 65 6b 61 62 6c 65 2e to be seekable.
23a0: 20 54 68 65 20 6f 70 74 69 6f 6e 20 3c 74 74 3e The option <tt>
23b0: 2d 6d 6a 70 65 67 3c 2f 74 74 3e 20 66 6f 72 63 -mjpeg</tt> forc
23c0: 65 73 20 74 68 65 20 72 65 63 6f 72 64 65 64 20 es the recorded
23d0: 64 61 74 61 20 74 6f 20 4a 50 45 47 20 66 6f 72 data to JPEG for
23e0: 6d 61 74 2c 20 69 2e 65 2e 20 61 20 74 72 61 6e mat, i.e. a tran
23f0: 73 63 6f 64 69 6e 67 20 74 6f 20 4a 50 45 47 20 scoding to JPEG
2400: 77 69 6c 6c 20 62 65 20 70 65 72 66 6f 72 6d 65 will be performe
2410: 64 20 69 6e 20 73 6f 66 74 77 61 72 65 2c 20 69 d in software, i
2420: 66 20 74 68 65 20 64 65 76 69 63 65 20 64 6f 65 f the device doe
2430: 73 6e 27 74 0d 0a 61 6c 72 65 61 64 79 20 64 65 sn't..already de
2440: 6c 69 76 65 72 20 61 20 4a 50 45 47 20 73 74 72 liver a JPEG str
2450: 65 61 6d 2e 20 54 68 65 20 6f 70 74 69 6f 6e 20 eam. The option
2460: 3c 74 74 3e 2d 75 73 65 72 3c 2f 74 74 3e 20 74 <tt>-user</tt> t
2470: 75 72 6e 73 20 6f 66 66 20 61 75 74 6f 6d 61 74 urns off automat
2480: 69 63 20 66 72 61 6d 65 20 77 72 69 74 65 20 6f ic frame write o
2490: 70 65 72 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 perations to the
24a0: 20 72 65 63 6f 72 64 69 6e 67 20 66 69 6c 65 20 recording file
24b0: 6f 72 20 73 74 72 65 61 6d 20 77 68 65 6e 20 61 or stream when a
24c0: 20 66 72 61 6d 65 20 69 73 0d 0a 64 65 6c 69 76 frame is..deliv
24d0: 65 72 65 64 20 66 72 6f 6d 20 74 68 65 20 64 65 ered from the de
24e0: 76 69 63 65 2e 20 49 6e 73 74 65 61 64 2c 20 3c vice. Instead, <
24f0: 74 74 3e 75 76 63 20 72 65 63 6f 72 64 20 3c 69 tt>uvc record <i
2500: 3e 64 65 76 69 64 3c 2f 69 3e 20 66 72 61 6d 65 >devid</i> frame
2510: 3c 2f 74 74 3e 20 6d 75 73 74 20 62 65 20 69 6e </tt> must be in
2520: 76 6f 6b 65 64 20 69 6e 20 74 68 65 20 63 61 6c voked in the cal
2530: 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 2e 20 lback function.
2540: 54 68 65 20 3c 74 74 3e 2d 75 73 65 72 3c 2f 74 The <tt>-user</t
2550: 74 3e 20 6f 70 74 69 6f 6e 20 69 6d 70 6c 69 65 t> option implie
2560: 73 20 3c 74 74 3e 2d 6d 6a 70 65 67 3c 2f 74 74 s <tt>-mjpeg</tt
2570: 3e 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 72 65 >.....<tt>uvc re
2580: 63 6f 72 64 20 3c 69 3e 64 65 76 69 64 3c 2f 69 cord <i>devid</i
2590: 3e 20 73 74 61 74 65 3c 2f 74 74 3e 0d 0a 0d 0a > state</tt>....
25a0: 20 20 20 20 52 65 74 75 72 6e 73 20 74 68 65 20 Returns the
25b0: 63 75 72 72 65 6e 74 20 72 65 63 6f 72 64 69 6e current recordin
25c0: 67 20 73 74 61 74 65 20 61 73 20 3c 74 74 3e 73 g state as <tt>s
25d0: 74 6f 70 3c 2f 74 74 3e 2c 20 3c 74 74 3e 72 65 top</tt>, <tt>re
25e0: 63 6f 72 64 69 6e 67 3c 2f 74 74 3e 2c 20 20 3c cording</tt>, <
25f0: 74 74 3e 70 61 75 73 65 3c 2f 74 74 3e 2c 20 6f tt>pause</tt>, o
2600: 72 20 3c 74 74 3e 65 72 72 6f 72 3c 2f 74 74 3e r <tt>error</tt>
2610: 2e 20 54 68 65 20 73 74 61 74 65 20 3c 74 74 3e . The state <tt>
2620: 65 72 72 6f 72 3c 2f 74 74 3e 20 69 6e 64 69 63 error</tt> indic
2630: 61 74 65 73 20 61 20 77 72 69 74 65 20 65 72 72 ates a write err
2640: 6f 72 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 6f or on the file o
2650: 72 20 73 74 72 65 61 6d 2e 20 49 6e 20 74 68 69 r stream. In thi
2660: 73 20 63 61 73 65 20 6e 6f 20 66 75 72 74 68 65 s case no furthe
2670: 72 20 66 72 61 6d 65 73 20 77 69 6c 6c 20 62 65 r frames will be
2680: 20 77 72 69 74 74 65 6e 2e 0d 0a 0d 0a 3c 74 74 written.....<tt
2690: 3e 75 76 63 20 72 65 63 6f 72 64 20 3c 69 3e 64 >uvc record <i>d
26a0: 65 76 69 64 3c 2f 69 3e 20 73 74 6f 70 3c 2f 74 evid</i> stop</t
26b0: 74 3e 0d 0a 0d 0a 20 20 20 20 46 69 6e 69 73 68 t>.... Finish
26c0: 65 73 20 72 65 63 6f 72 64 69 6e 67 20 74 6f 20 es recording to
26d0: 61 20 66 69 6c 65 20 6f 72 20 73 74 72 65 61 6d a file or stream
26e0: 20 61 6e 64 20 63 6c 6f 73 65 73 20 74 68 65 20 and closes the
26f0: 75 6e 64 65 72 6c 79 69 6e 67 20 63 68 61 6e 6e underlying chann
2700: 65 6c 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 63 20 73 el.....<tt>uvc s
2710: 74 61 72 74 20 3c 69 3e 64 65 76 69 64 3c 2f 69 tart <i>devid</i
2720: 3e 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 53 74 ></tt>.... St
2730: 61 72 74 73 20 63 61 70 74 75 72 69 6e 67 20 69 arts capturing i
2740: 6d 61 67 65 73 20 6f 66 20 74 68 65 20 64 65 76 mages of the dev
2750: 69 63 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 ice identified b
2760: 79 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f y <tt><i>devid</
2770: 69 3e 3c 2f 74 74 3e 2e 20 57 68 65 6e 20 61 6e i></tt>. When an
2780: 20 69 6d 61 67 65 20 69 73 20 72 65 61 64 79 2c image is ready,
2790: 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 63 6f the callback co
27a0: 6d 6d 61 6e 64 20 73 65 74 20 6f 6e 20 3c 74 74 mmand set on <tt
27b0: 3e 75 76 63 20 6f 70 65 6e 3c 2f 74 74 3e 20 69 >uvc open</tt> i
27c0: 73 20 69 6e 76 6f 6b 65 64 2e 0d 0a 0d 0a 3c 74 s invoked.....<t
27d0: 74 3e 75 76 63 20 73 74 61 74 65 20 3c 69 3e 64 t>uvc state <i>d
27e0: 65 76 69 64 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d evid</i></tt>...
27f0: 0a 20 20 20 20 52 65 74 75 72 6e 73 20 74 68 65 . Returns the
2800: 20 69 6d 61 67 65 20 63 61 70 74 75 72 65 20 73 image capture s
2810: 74 61 74 65 20 6f 66 20 74 68 65 20 64 65 76 69 tate of the devi
2820: 63 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 ce identified by
2830: 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f 69 <tt><i>devid</i
2840: 3e 3c 2f 74 74 3e 2e 20 54 68 65 20 72 65 73 75 ></tt>. The resu
2850: 6c 74 20 69 73 20 74 68 65 20 73 74 72 69 6e 67 lt is the string
2860: 20 3c 74 74 3e 63 61 70 74 75 72 65 3c 2f 74 74 <tt>capture</tt
2870: 3e 20 69 66 20 74 68 65 20 64 65 76 69 63 65 20 > if the device
2880: 69 73 20 73 74 61 72 74 65 64 2c 20 3c 74 74 3e is started, <tt>
2890: 73 74 6f 70 70 65 64 3c 2f 74 74 3e 20 69 66 20 stopped</tt> if
28a0: 74 68 65 20 64 65 76 69 63 65 20 69 73 20 73 74 the device is st
28b0: 6f 70 70 65 64 2c 20 6f 72 20 3c 74 74 3e 65 72 opped, or <tt>er
28c0: 72 6f 72 3c 2f 74 74 3e 20 69 66 20 61 6e 20 65 ror</tt> if an e
28d0: 72 72 6f 72 20 68 61 73 20 62 65 65 6e 20 64 65 rror has been de
28e0: 74 65 63 74 65 64 20 77 68 69 6c 65 20 69 6d 61 tected while ima
28f0: 67 65 20 63 61 70 74 75 72 65 20 77 61 73 20 61 ge capture was a
2900: 63 74 69 76 65 2e 0d 0a 0d 0a 3c 74 74 3e 75 76 ctive.....<tt>uv
2910: 63 20 73 74 6f 70 20 3c 69 3e 64 65 76 69 64 3c c stop <i>devid<
2920: 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 /i></tt>....
2930: 53 74 6f 70 20 63 61 70 74 75 72 69 6e 67 20 69 Stop capturing i
2940: 6d 61 67 65 73 20 6f 66 20 74 68 65 20 64 65 76 mages of the dev
2950: 69 63 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 ice identified b
2960: 79 20 3c 74 74 3e 3c 69 3e 64 65 76 69 64 3c 2f y <tt><i>devid</
2970: 69 3e 3c 2f 74 74 3e 2e 0d 0a 0d 0a 3c 74 74 3e i></tt>.....<tt>
2980: 75 76 63 20 74 6f 70 68 6f 74 6f 20 3c 69 3e 77 uvc tophoto <i>w
2990: 69 64 74 68 20 68 65 69 67 68 74 20 62 70 70 20 idth height bpp
29a0: 62 79 74 65 61 72 72 61 79 3c 2f 69 3e 20 3f 3c bytearray</i> ?<
29b0: 69 3e 72 6f 74 20 6d 69 72 72 6f 72 78 20 6d 69 i>rot mirrorx mi
29c0: 72 72 6f 72 79 3c 2f 69 3e 3f 3c 2f 74 74 3e 0d rrory</i>?</tt>.
29d0: 0a 0d 0a 20 20 20 20 4d 61 6b 65 73 20 74 68 65 ... Makes the
29e0: 20 52 47 42 20 28 3c 74 74 3e 3c 69 3e 62 70 70 RGB (<tt><i>bpp
29f0: 3c 2f 69 3e 3c 2f 74 74 3e 20 69 73 20 33 29 20 </i></tt> is 3)
2a00: 6f 72 20 67 72 61 79 20 28 3c 74 74 3e 3c 69 3e or gray (<tt><i>
2a10: 62 70 70 3c 2f 69 3e 3c 2f 74 74 3e 20 69 73 20 bpp</i></tt> is
2a20: 31 29 20 62 79 74 65 20 61 72 72 61 79 20 3c 74 1) byte array <t
2a30: 74 3e 3c 69 3e 62 79 74 65 61 72 72 61 79 3c 2f t><i>bytearray</
2a40: 69 3e 3c 2f 74 74 3e 20 6f 66 20 3c 74 74 3e 3c i></tt> of <tt><
2a50: 69 3e 77 69 64 74 68 3c 2f 69 3e 3c 2f 74 74 3e i>width</i></tt>
2a60: 20 74 69 6d 65 73 20 3c 74 74 3e 3c 69 3e 68 65 times <tt><i>he
2a70: 69 67 68 74 3c 2f 69 3e 3c 2f 74 74 3e 20 70 69 ight</i></tt> pi
2a80: 78 65 6c 73 20 69 6e 74 6f 20 61 20 54 6b 20 70 xels into a Tk p
2a90: 68 6f 74 6f 20 69 6d 61 67 65 2e 20 4f 70 74 69 hoto image. Opti
2aa0: 6f 6e 61 6c 6c 79 2c 20 74 68 65 20 64 61 74 61 onally, the data
2ab0: 20 69 73 20 72 6f 74 61 74 65 64 20 62 79 20 3c is rotated by <
2ac0: 74 74 3e 3c 69 3e 72 6f 74 3c 2f 69 3e 3c 2f 74 tt><i>rot</i></t
2ad0: 74 3e 20 64 65 67 72 65 65 73 20 28 70 6f 73 73 t> degrees (poss
2ae0: 69 62 6c 65 20 76 61 6c 75 65 73 20 30 2c 20 39 ible values 0, 9
2af0: 30 2c 20 31 38 30 2c 20 32 37 30 29 20 61 6e 64 0, 180, 270) and
2b00: 2f 6f 72 20 6d 69 72 72 6f 72 65 64 20 61 6c 6f /or mirrored alo
2b10: 6e 67 20 74 68 65 20 58 20 61 6e 64 2f 6f 72 20 ng the X and/or
2b20: 59 20 61 78 69 73 20 61 73 20 73 70 65 63 69 66 Y axis as specif
2b30: 69 65 64 20 62 79 20 74 68 65 20 62 6f 6f 6c 65 ied by the boole
2b40: 61 6e 20 76 61 6c 75 65 73 20 3c 74 74 3e 3c 69 an values <tt><i
2b50: 3e 6d 69 72 72 6f 72 78 3c 2f 69 3e 3c 2f 74 74 >mirrorx</i></tt
2b60: 3e 20 61 6e 64 20 3c 74 74 3e 3c 69 3e 6d 69 72 > and <tt><i>mir
2b70: 72 6f 72 79 3c 2f 69 3e 3c 2f 74 74 3e 2e 0d 0a rory</i></tt>...
2b80: 0d 0a 54 68 65 20 3c 74 74 3e 75 76 63 3c 2f 74 ..The <tt>uvc</t
2b90: 74 3e 20 63 6f 6d 6d 61 6e 64 20 74 72 69 65 73 t> command tries
2ba0: 20 74 6f 20 6c 61 7a 79 20 6c 6f 61 64 20 54 6b to lazy load Tk
2bb0: 2c 20 74 68 75 73 20 61 6c 6c 6f 77 69 6e 67 20 , thus allowing
2bc0: 74 6f 20 75 73 65 20 69 74 20 66 72 6f 6d 20 61 to use it from a
2bd0: 20 6e 6f 72 6d 61 6c 20 3c 74 74 3e 74 63 6c 73 normal <tt>tcls
2be0: 68 3c 2f 74 74 3e 2e 20 4f 6e 6c 79 20 77 68 65 h</tt>. Only whe
2bf0: 6e 20 61 20 70 68 6f 74 6f 20 69 6d 61 67 65 20 n a photo image
2c00: 69 73 20 72 65 71 75 69 72 65 64 20 62 79 20 61 is required by a
2c10: 20 73 75 62 63 6f 6d 6d 61 6e 64 2c 20 54 6b 20 subcommand, Tk
2c20: 6d 75 73 74 20 62 65 20 61 76 61 69 6c 61 62 6c must be availabl
2c30: 65 20 61 6e 64 20 61 6e 20 61 74 74 65 6d 70 74 e and an attempt
2c40: 20 74 6f 20 6c 6f 61 64 20 69 74 20 69 73 20 6d to load it is m
2c50: 61 64 65 2e 0d 0a 0a 5a 20 66 63 34 34 39 64 39 ade....Z fc449d9
2c60: 64 62 30 37 35 63 32 64 37 36 35 65 35 39 66 64 db075c2d765e59fd
2c70: 64 66 61 66 31 62 63 32 36 0a dfaf1bc26.