refinements/compat fixes to fisrt-stage cache/timing tests
[xiph/unicode.git] / snatch / FAQ
blobf708b013a1558e2fe4b2a533b66cf409ae2e13d1
1 Q: Does Snatch make perfect copies or grab the actual Real stream?
3 A: No.  It captures the decoded audio and video as Real sends it to
4    the sound device and X server.  The result of grabbing the data
5    will only be as good as RealPlayer's playback; it will be exactly
6    as you see/hear it.
8    Snatch does not touch the Real stream and does not know how to talk
9    to a Real server; it lets the stock RealPlayer do the decoding.
10    Snatch does not modify or patch RealPlayer in any way or defeat any
11    encryption or password mechanisms built into RealPlayer.  Snatch is
12    merely a glorified software camcorder with an easy to use
13    interface.
15 Q: Does Snatch just take lots of fast screen captures?
17 A: No.  Snatch watches events going to and from the X server and
18    captures the appropriate video frames off the wire.  It will not
19    grab at the wrong rate, hose the machine/X server or 'capture'
20    frames that aren't actually displayed.
22 Q: Can I capture with the RealPlayer window hidden or iconified?
24 A: Yes. 
26 Q: Will Snatch try to restart RealPlayer if an error occurs?
28 A: Yes, but mostly for timed recording.  If RealPlayer crashes or
29    aborts streaming due to a network error, Snatch will start a new
30    copy if needed and try to pick up any timed recording where it left
31    off.  If capture is happening in manual mode, Snatch assumes that
32    user is present and can generally handle any problems better than a
33    dumb, automated Robot, and as such won't try to interfere.
35 Q: Is there a 2GB file limit?
37 A: The short answer depends on Linux version.  Snatch uses 64 bit file
38    operations, so there's no limitation there.  Captures on Linux 2.4
39    will go past 2GB smoothly.
41    Many/most machines still running Linux 2.2 can't have > 2GB files
42    as Linux 2.2's ext2fs is limited to 32 bit offsets when running on
43    32 bit machines.  For these machines, if the selected output is a
44    *directory* Snatch will close a grab file when it hits 2GB, open a
45    new file, and continue. If a specific *file* is set for output,
46    Snatch will not be able to continue past 2GB.
48 Q: When I selecting silent video playback, the RealPlayer window
49    mostly stops responding and fills with garbage.  Can I fix this?
51 A: No, it's intentional. 'Silent video' stops all X updates from going
52    to the RealPlayer window; it's meant to squeeze any extra
53    performance possible from a machine with slow graphics hardware or
54    slow processor or both.  Remember that Snatch doesn't capture the
55    Real stream, it captures the video RealPlayer sends to the display.
56    Any dropped frames due to poor machine performace will show up in
57    the output as jerkiness.
59    Although the video requires cycles to display, RealPlayer is also
60    spewing lots of updates to the interface during playback (like the
61    time display, scrolling info, etc).  For best performace,
62    *everything* gets turned off.  In this mode, all interaction with
63    RealPlayer should be made through the Snatch Robot.  Turning off
64    silent video will bring the RealPlayer window back to life.
66 Q: I begin playing/recording with audio playback set to silent, but
67    changing the setting later has no effect until I start a new
68    stream!  Why?
70 A: Snatch doesn't currently try to set up the soundacard for playback
71    after a stream starts because it originally faked successful
72    returns to various sound API ioctl()s that might have failed
73    (requiring RealPlayer to try an alternate setup).  Trying to
74    emulate given settings with on the fly resampling is rather complex
75    given the fairly innocuous nature of this 'bug', and not bothering
76    to fake through it correctly would just crash RealPlayer or garble
77    the output.
79 Q: I'm watching/recording video and switching between audio playback
80    and silent playback. When I turn off silent record, the audio I
81    hear is out of sync!  What gives?
83 A: Right now, Snatch tracks audio sync only for the output file.  It
84    doesn't try to re-sync the sound card if you reenable audio
85    playback during a stream.  The captured file *will be fine*.  I
86    didn't go through the extra trouble mainly because on-the-fly
87    resync would require extra memory, buffering, and I didn't know if
88    anyone cared that much.
90 Q: Can I use libsnatch without the Snatch Robot application?
92 A: Yes, all the configuration a user can effect from the robot can be
93    done via environment variables.  In fact, the shared lib was
94    written and tested and used thoroughly before the Robot was even
95    started.
97 Q: What does Snatch occasionally cause: "undefined symbol:
98    XGetGeometry" or some other undefined symbol?
100 A: RealPlayer is trying to start up external applications; Snatch
101    isn't yet smart enough to know that these external applications are
102    not RealPlayer and thus tries [unsuccessfully] to use the same
103    library capture tricks.  The errors are harmless, but they do mean
104    Real will not be able to spawn web browsers or other 'external
105    synchronized multimedia events'.  I personally don't consider that
106    a huge loss.
108    This also happens for one other common reason: Having EsounD support
109    enabled, but no EsounD daemon running.