Wrectangles by David Boudreau
Posted: Fri Apr 06, 2007 8:13 pm
Hey, guys.
David Boudreau, a long time SF fan (he was prominent during the agsf2 days) wrote a little application that he wanted me to check out and play with. It's an interesting tool that basically lets you create "hit boxes" on an existing video clip. You don't actually create a new video, just a 'script" that can be played alongside the video clip. So if you make a script with all the hit boxes and, in the future, text, as long as someone else has the same video clip you have, they can play your hit box script and see the stuff you made by playing the video with his app.
I told him I'd take a look at it and mess with it, but just haven't had the time (being sidelined by a cold doesn't help). So I figured I would post about it here, since there is no place better. ^_^ Anyone who has some free time can mess with it and see what you think.
======================================
You can get it here:
http://www.lowfierce.com/zrandom/wrecta ... sMar25.rar
======================================
Here's a couple of YouTube tutorial links he made:
http://www.youtube.com/watch?v=SFSuA970_AI
http://www.youtube.com/watch?v=kvfOm9_SqSA
======================================
Here's his original e-mail to me:
* * * * *
Hi James,
I'd like to go ahead and send you the Wrectangles program I've been
working on, in my next email right after I send this to introduce it
first (sending attachment separately in case a spam filter snags on a
.rar file- also, please let me know if you'd prefer a .zip file
instead). I'd really like your feedback, as Wrectangles is one way I
hope I can "raise a glass" to "understand the man" for your efforts
with combo video efforts. You tell me if I'm just "sitting and
staring" off into space though. Here is an INTRO, followed by
INSTRUCTIONS:
INTRO:
Ideally, Wrectangles would be an initial step within the larger scope
of providing more complete diagnostics training that would hopefully
make it into inclusion/integration with a commercial release game
training mode itself, which would also involve the analysis and
reporting of a bunch of detailed statistics and ratios, such as "How
many attacks got stuffed per round, 2.2279". (possibly customize
stats into custom ratios reporting... user community encouraged to use
it to find most meaningful statistics, eg which stats tend to be
highest when I win? what is consistent about the best players' stats
to extrapolate trends? etc.)
Diagnostics training would also include the actual hit/vulnerable
locations (not our estimates, which so far we can only estimate with
tools like this one) on frames during matches, as well as an onscreen
display of inputs (i.e. anytime you hold the stick left, that is
indicated in a small area at bottom corner of screen and when you stop
holding left, you can also see that clearly), which may help when
practicing combos (e.g. "why didn't it link that time? oh, because the
button press didn't register there, maybe I tend to be too early on
it")
But that's all still pie-in-the-sky. Here's what Wrectangles is so far:
High Level:
-Now, we can already watch videos of matches, study them to review
errors and misses to improve, or to demonstrate combos, etc.
-Wrectangles intended as a simple tool to provide more capabilites and
provide more options for that process; more granularity... a kind of
"interactive machinima-slash-demotool"
-Combos, setups, precise distancing, zoning/controlling space, and
strategy can be explained, demonstrated, tutorialized and shared in
more detail with Wrectangles.
Workflow (see Instructions below for details before trying):
File-New --> Select source movie file --> Grab some frames
--> Edit (add rects/text) ... save, share file/discuss
File-Open --> Select .wre compilation file --> Review/Re-edit
Benefits:
-Shuttle-jog through clips at various speeds
-Illustrate *and*animate* hit/vulnerable areas of moves
-Explain/make tutorials of combos/setups/shutdowns/zoning /corner traps
-Recognize/Convey subtle differences in distancing more easily and
clearly (than via text alone on forums, for example)
Features:
-Grab short clips from your source videos of rounds (.wmv,.avi,.mpg
DirectShow-able files in 320x240 or 640x480)
-Shuttle Jog capabilities on those frames (control playback speed to
slow down framerate, pause exactly on frames you want to review, and
frame-by-frame advance/rewind)
-Draw rectangles over a move's animation to indicate precise
hit/vulnerable areas for each character, on each frame
-Add text comments, specific to any particular frame
-Note the name/handle of player1, player2
-Save to tiny .wre file to share and discuss analysis with others
that have the same source videos
Limits:
First release, still a little rough around edges: Windows only. Can
only grab max of 1000 frames (about 30 seconds' worth) and that may be
further limited by your cpu/gpu/vram; cannot save compilation file out
to a second avi file yet, just an ASCII file requiring source movie.
Users can then share the ASCII file and other users reprocess clip
from same source movie. Any sound in source won't be in compilation
file. Does not do anything special with codecs or compression;
processes frames in VRAM (your graphics card). If you have the latest
high-end machines, note the 30 seconds limit because it was developed
on an old machine, so this may be lifted.
Cost:
Free. Please share copies with others soon. Ask if interested in source code.
**********************************
INSTRUCTIONS:
Unarchive the attached file (in next email) WrectanglesMar25 and note
two executables and two folders. The Wrect640x480.exe can do both
movie file sizes 320x240 as well as 640x480, so use that generally,
but the 320x240 exe gives a bigger screen when maximized for movie
files in that smaller size). Put some movie file(s) you have (of 320x
or 640x size) in the "SourceMovies" folder, and start the
Wrect640x480.exe. The source movies have to be in the SourceMovies
folder under the exe.
Press space to begin, go File-New and select one of your source
movies. It should begin to play. Hold down the "G" key on your
keyboard for a few seconds (up to about 5 secs' worth is plenty the
first time you try it, later you can go up to 30 seconds, or 1000
frames). As soon as you let go of the G key, it will process by
playing the movie again from the beginning and grab the frames. Let
it play all the way through "Processing..." until you see the
red/blue/green/etc. boxes at the bottom of the screen.
Now you can use P key to toggle pause/play, arrow keys to speed
Up/Down, and while paused, Left/Right to rewind/advance
frame-by-frame.
While PAUSED on a frame, you can draw a rectangle with the mouse (e.g.
draw over an arm punching) in a selected color from the bottom (just
click on one of the colors to choose). You should see the rectangle's
green handles for positioning it (top left) and resizing (bottom
right). To bring a rect into focus, click in its positioning handle.
While you see the handles of a rect, you can extend it to the
subsequent frame by holding Shift key and press right arrow. Start
drawing rects on the first frame of an attack, and then extending
(Shift+rightArrowKey) to the last frame. If you go too many frames,
go to the highlighted rect's last frame it appears on and hold Shift,
and press left arrow key to reduce a frame that that rect appears on.
To actually delete a
rect, highlight it's handle and press Del key. The process isn't
perfect as sometimes the characters move or get pushed but rects stay
in the same spot throughout all frames, so for those times, a
workaround is: multiple rects can be drawn on different frames, so
when the character starts scrolling/gets pushed back, don't
Shift-Right to the next frame, but Right arrow key only and draw a new
rect (the rects can exist on multiple, sequential frames, but each has
only one position). Remember, this is all while PAUSED.
Speed of playback: P key toggles pause/play; paused is equivalent to
a "Drag" parameter of 700, and normal play speed where Drag=30.
Up/Down arrow keys to get in between. (I call it Drag param because
it's the number of milliseconds it waits before proceeding to the next
frame).
You can go File-SaveAs to save (no Save this release). What you are
saving is a .wre file, a "compilation" of the designated source movie
frames and the rects you drew on it. For now don't open any of the
ones you see in the archive I send in the Compilations folder, cause I
didn't include those source movies (to save space in the archive).
Whenever a .wre is openned, it will reprocess from the same source
movie which needs to be in your SourceMovies folder.
Unless it's processing something, you can go File Open to open a .wre
compilation file. It will first process from source movie
automatically and then you can play it back to see it with the rects
on it-- but *animated*. That's basically what it's all about, hope
that's not too complicated.
Next basic feature not yet implemented: the ability to add comments
(text) on any given frame.
P- pause/play
ARROW keys- control speed/frame-by-frame (or -/+ with F/R keys: F/R
keys also does the same as left/right keys, and similarly, numpad's
minus/plus keys same as down/up.)
E- close a source movie (without grabbing anything)
G- grab frames after openning a source movie (file-new)
--David
(XSPR/mrdhalsim)
btw: you can take a look at the .wre file structure in Notepad if
you're curious, but I don't want to mention this because users may
mess something up as you can imagine... as it's not 100% forgiving in
the code but maybe someday it may be... you can see a faint
resemblance to xml structure which may or may not be useful if
interest in this grows....
The last tournament I went to last week was actually a
(pre?)qualifier connected to Tougeki/SBO for AE (2 on 2). I didn't
have a partner, but happened to meet my old friend/rival from A3 days,
443 and recruited him. We got eliminated early by the guys that won
it (single elim), they drove 3 hours for it and one plays with Muteki
Guile. I hadn't practiced much at all, instead working on Wrectangles
since last tournament, and after this tourny finished, gave a demo of
Wrectangles on my laptop and handed out 10 CDs, telling everyone to
share/copy but
unfortuantely my compiler can't handle Japanese/UTF characters and
everything's in English... so not sure on the reception it'll get
here.
btw I can send you/upload somewhere a demo video, of me using
Wrectangles and voiceover of what I'm doing, but the file would be 20
to 30MB.
-David
David Boudreau, a long time SF fan (he was prominent during the agsf2 days) wrote a little application that he wanted me to check out and play with. It's an interesting tool that basically lets you create "hit boxes" on an existing video clip. You don't actually create a new video, just a 'script" that can be played alongside the video clip. So if you make a script with all the hit boxes and, in the future, text, as long as someone else has the same video clip you have, they can play your hit box script and see the stuff you made by playing the video with his app.
I told him I'd take a look at it and mess with it, but just haven't had the time (being sidelined by a cold doesn't help). So I figured I would post about it here, since there is no place better. ^_^ Anyone who has some free time can mess with it and see what you think.
======================================
You can get it here:
http://www.lowfierce.com/zrandom/wrecta ... sMar25.rar
======================================
Here's a couple of YouTube tutorial links he made:
http://www.youtube.com/watch?v=SFSuA970_AI
http://www.youtube.com/watch?v=kvfOm9_SqSA
======================================
Here's his original e-mail to me:
* * * * *
Hi James,
I'd like to go ahead and send you the Wrectangles program I've been
working on, in my next email right after I send this to introduce it
first (sending attachment separately in case a spam filter snags on a
.rar file- also, please let me know if you'd prefer a .zip file
instead). I'd really like your feedback, as Wrectangles is one way I
hope I can "raise a glass" to "understand the man" for your efforts
with combo video efforts. You tell me if I'm just "sitting and
staring" off into space though. Here is an INTRO, followed by
INSTRUCTIONS:
INTRO:
Ideally, Wrectangles would be an initial step within the larger scope
of providing more complete diagnostics training that would hopefully
make it into inclusion/integration with a commercial release game
training mode itself, which would also involve the analysis and
reporting of a bunch of detailed statistics and ratios, such as "How
many attacks got stuffed per round, 2.2279". (possibly customize
stats into custom ratios reporting... user community encouraged to use
it to find most meaningful statistics, eg which stats tend to be
highest when I win? what is consistent about the best players' stats
to extrapolate trends? etc.)
Diagnostics training would also include the actual hit/vulnerable
locations (not our estimates, which so far we can only estimate with
tools like this one) on frames during matches, as well as an onscreen
display of inputs (i.e. anytime you hold the stick left, that is
indicated in a small area at bottom corner of screen and when you stop
holding left, you can also see that clearly), which may help when
practicing combos (e.g. "why didn't it link that time? oh, because the
button press didn't register there, maybe I tend to be too early on
it")
But that's all still pie-in-the-sky. Here's what Wrectangles is so far:
High Level:
-Now, we can already watch videos of matches, study them to review
errors and misses to improve, or to demonstrate combos, etc.
-Wrectangles intended as a simple tool to provide more capabilites and
provide more options for that process; more granularity... a kind of
"interactive machinima-slash-demotool"
-Combos, setups, precise distancing, zoning/controlling space, and
strategy can be explained, demonstrated, tutorialized and shared in
more detail with Wrectangles.
Workflow (see Instructions below for details before trying):
File-New --> Select source movie file --> Grab some frames
--> Edit (add rects/text) ... save, share file/discuss
File-Open --> Select .wre compilation file --> Review/Re-edit
Benefits:
-Shuttle-jog through clips at various speeds
-Illustrate *and*animate* hit/vulnerable areas of moves
-Explain/make tutorials of combos/setups/shutdowns/zoning /corner traps
-Recognize/Convey subtle differences in distancing more easily and
clearly (than via text alone on forums, for example)
Features:
-Grab short clips from your source videos of rounds (.wmv,.avi,.mpg
DirectShow-able files in 320x240 or 640x480)
-Shuttle Jog capabilities on those frames (control playback speed to
slow down framerate, pause exactly on frames you want to review, and
frame-by-frame advance/rewind)
-Draw rectangles over a move's animation to indicate precise
hit/vulnerable areas for each character, on each frame
-Add text comments, specific to any particular frame
-Note the name/handle of player1, player2
-Save to tiny .wre file to share and discuss analysis with others
that have the same source videos
Limits:
First release, still a little rough around edges: Windows only. Can
only grab max of 1000 frames (about 30 seconds' worth) and that may be
further limited by your cpu/gpu/vram; cannot save compilation file out
to a second avi file yet, just an ASCII file requiring source movie.
Users can then share the ASCII file and other users reprocess clip
from same source movie. Any sound in source won't be in compilation
file. Does not do anything special with codecs or compression;
processes frames in VRAM (your graphics card). If you have the latest
high-end machines, note the 30 seconds limit because it was developed
on an old machine, so this may be lifted.
Cost:
Free. Please share copies with others soon. Ask if interested in source code.
**********************************
INSTRUCTIONS:
Unarchive the attached file (in next email) WrectanglesMar25 and note
two executables and two folders. The Wrect640x480.exe can do both
movie file sizes 320x240 as well as 640x480, so use that generally,
but the 320x240 exe gives a bigger screen when maximized for movie
files in that smaller size). Put some movie file(s) you have (of 320x
or 640x size) in the "SourceMovies" folder, and start the
Wrect640x480.exe. The source movies have to be in the SourceMovies
folder under the exe.
Press space to begin, go File-New and select one of your source
movies. It should begin to play. Hold down the "G" key on your
keyboard for a few seconds (up to about 5 secs' worth is plenty the
first time you try it, later you can go up to 30 seconds, or 1000
frames). As soon as you let go of the G key, it will process by
playing the movie again from the beginning and grab the frames. Let
it play all the way through "Processing..." until you see the
red/blue/green/etc. boxes at the bottom of the screen.
Now you can use P key to toggle pause/play, arrow keys to speed
Up/Down, and while paused, Left/Right to rewind/advance
frame-by-frame.
While PAUSED on a frame, you can draw a rectangle with the mouse (e.g.
draw over an arm punching) in a selected color from the bottom (just
click on one of the colors to choose). You should see the rectangle's
green handles for positioning it (top left) and resizing (bottom
right). To bring a rect into focus, click in its positioning handle.
While you see the handles of a rect, you can extend it to the
subsequent frame by holding Shift key and press right arrow. Start
drawing rects on the first frame of an attack, and then extending
(Shift+rightArrowKey) to the last frame. If you go too many frames,
go to the highlighted rect's last frame it appears on and hold Shift,
and press left arrow key to reduce a frame that that rect appears on.
To actually delete a
rect, highlight it's handle and press Del key. The process isn't
perfect as sometimes the characters move or get pushed but rects stay
in the same spot throughout all frames, so for those times, a
workaround is: multiple rects can be drawn on different frames, so
when the character starts scrolling/gets pushed back, don't
Shift-Right to the next frame, but Right arrow key only and draw a new
rect (the rects can exist on multiple, sequential frames, but each has
only one position). Remember, this is all while PAUSED.
Speed of playback: P key toggles pause/play; paused is equivalent to
a "Drag" parameter of 700, and normal play speed where Drag=30.
Up/Down arrow keys to get in between. (I call it Drag param because
it's the number of milliseconds it waits before proceeding to the next
frame).
You can go File-SaveAs to save (no Save this release). What you are
saving is a .wre file, a "compilation" of the designated source movie
frames and the rects you drew on it. For now don't open any of the
ones you see in the archive I send in the Compilations folder, cause I
didn't include those source movies (to save space in the archive).
Whenever a .wre is openned, it will reprocess from the same source
movie which needs to be in your SourceMovies folder.
Unless it's processing something, you can go File Open to open a .wre
compilation file. It will first process from source movie
automatically and then you can play it back to see it with the rects
on it-- but *animated*. That's basically what it's all about, hope
that's not too complicated.
Next basic feature not yet implemented: the ability to add comments
(text) on any given frame.
P- pause/play
ARROW keys- control speed/frame-by-frame (or -/+ with F/R keys: F/R
keys also does the same as left/right keys, and similarly, numpad's
minus/plus keys same as down/up.)
E- close a source movie (without grabbing anything)
G- grab frames after openning a source movie (file-new)
--David
(XSPR/mrdhalsim)
btw: you can take a look at the .wre file structure in Notepad if
you're curious, but I don't want to mention this because users may
mess something up as you can imagine... as it's not 100% forgiving in
the code but maybe someday it may be... you can see a faint
resemblance to xml structure which may or may not be useful if
interest in this grows....
The last tournament I went to last week was actually a
(pre?)qualifier connected to Tougeki/SBO for AE (2 on 2). I didn't
have a partner, but happened to meet my old friend/rival from A3 days,
443 and recruited him. We got eliminated early by the guys that won
it (single elim), they drove 3 hours for it and one plays with Muteki
Guile. I hadn't practiced much at all, instead working on Wrectangles
since last tournament, and after this tourny finished, gave a demo of
Wrectangles on my laptop and handed out 10 CDs, telling everyone to
share/copy but
unfortuantely my compiler can't handle Japanese/UTF characters and
everything's in English... so not sure on the reception it'll get
here.
btw I can send you/upload somewhere a demo video, of me using
Wrectangles and voiceover of what I'm doing, but the file would be 20
to 30MB.
-David