Bugs item #3292406, was opened at 2011-04-24 12:56 Message generated for change (Settings changed) made by sistisette You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=507079&aid=3292406...
Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: documentation Group: any operating system
Status: Open
Resolution: Fixed Priority: 5 Private: No Submitted By: Matteo Sisti Sette (sistisette) Assigned to: Nobody/Anonymous (nobody) Summary: pix_snap help patch
Initial Comment: According to pix_snap's help patch, one would expect that all you need to have pix_snap take a snapshot is to send it a "snap" message at an arbitrary moment, but that won't work.
The only way it works, is to send it the snap message just before the gemlist (0 ligical time before), i.e. with a [t a b]. This should definitely be mentioned in the help patch.
The current help patch gives no clue that the attached example test_snap.pd won't work and that in order to make it work you need to do like shown in attached test_snap_2.pd
The attached file snap_bare_minimum.pd shows the bare minimum (i think) which is needed to succesfully take a snapshot and I think something like this should be shown in the help patch.
By the way it would also be worth mentioning that a bang works as a synonim of "snap", though many will guess that.
----------------------------------------------------------------------
Comment By: Matteo Sisti Sette (sistisette)
Date: 2011-04-26 13:49
Message: @nusmuk,: by reporting a bug in the DOCUMENTATION category, I think I only implied that something's wrong with the documentation, not necessarily that something doesn't work. If I misunderstood the correct use of the documentation category and documentation issues are not supposed to be reported in this bugtracker then I apologise
----------------------------------------------------------------------
Comment By: IOhannes m zmölnig (zmoelnig) Date: 2011-04-26 12:28
Message: thanks for the report;
i changed the help-patch to be very similar to the [pix_snap2tex] patch, which mentions, that you need something drawn to the framebuffer in order to be happy.
this also makes for a more interactive experience :-)
----------------------------------------------------------------------
Comment By: Cyrille Henry (nusmuk) Date: 2011-04-24 15:34
Message: When reporting a bug, you did imply that things doesn't work.
----------------------------------------------------------------------
Comment By: Matteo Sisti Sette (sistisette) Date: 2011-04-24 15:25
Message: That's what I meant, that the help patch misses a lot of information. I didn't mean to imply that pix_snap doesn't work as it should.
I am not very good with documentation prose so I don't think I can provide an improved help patch; however I guess the scheme in the attached snap_bare_minimum.pd could be a starting point
----------------------------------------------------------------------
Comment By: Cyrille Henry (nusmuk) Date: 2011-04-24 14:13
Message: if you look at example 07.texture/07.feedback, you'll notice that pix_snap work if you use [t b a] (and not only [t a b])...
if you send color 1 0 0 to the gemwin of your "test_snap.pd", you'll notice that pix_snap does snap a red bufffer : it's because it's working. but when you send a snap message when Gem did not draw an image, the buffer is empty... That is certainly why the help patch says that pix_snap work best in single buffer mode (the buffer is not automatically clear).
So, i think pix_snap is working perfectly, but the help patch is clearly missing lot's of information.
please, fell free to make a nice help patch that could replace the current one.
----------------------------------------------------------------------
You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=507079&aid=3292406...
-
SourceForge.net