Difference between revisions of "JASigning Video Generator"

From Virtual Humans
Jump to navigation Jump to search
(Created page with ''''The software described on this page is (c) UEA and is for evaluation use only. Please contact the Virtual Humans Group and UEA if you wish to use this facility for other purpo...')
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''The software described on this page is (c) UEA and is for evaluation use only. Please contact the Virtual Humans Group and UEA if you wish to use this facility for other purposes.'''
+
'''The software described on this page is © UEA and is for evaluation use only. Please contact the Virtual Humans Group at UEA [mailto:VirtualSigning@cmp.uea.ac.uk VirtualSigning@cmp.uea.ac.uk] if you wish to use this facility for other purposes.'''
 +
 
 +
----
 +
[[Main Page|Home]] >> [[JASigning]]
 +
----
  
JASigning is now able to generate a video of an animation.
+
 
 +
== Video Generation using JASigning ==
  
But to do this it needs a video generation server application, and the supporting Xuggler video processing library, to be installed on the same computer system as the main JASigning instance in question.
+
JASigning is now able to generate a video of an animation using a video video generation server application. The server needs the supporting Xuggler video processing library to be installed on the same computer system as the main JASigning application being used. Video files are generated only in the <code>.mov</code> format.
  
Note that currently, and for the foreseeable future, video files are generated only in the <tt>.mov</tt> format.
+
This page gives information on installing the Video Generation Server and explains how to use the SiGML URL Player application to create videos.
 
 
See the [http://vhg.cmp.uea.ac.uk/tech/jas/vid/ Video Generation page] for the server application download and instructions on its use (an earlier draft of which are reproduced below).
 
  
 
&nbsp;
 
&nbsp;
 +
== Installing the Video Generation Server ==
  
== Installing and Using the Video Generation Server ==
+
=== Installation on MacOS X ===
  
 +
* Download the [http://vhg.cmp.uea.ac.uk/tech/jas/vid/xuggle-xuggler.3.4.1012-i386-apple-darwin9.8.0.sh Xuggler Library installation script]
 +
* Run the installation script to install the Xuggler 3.4 library
 +
** Start the Terminal application and move to the directory containing the script
 +
** Enter <code>sudo sh xuggle-xuggler.3.4.1012-i386-apple-darwin9.8.0.sh</code>
 +
** Authentication is needed to install in the standard location <code>/usr/local/xuggler</code>
 +
** Follow the instructions given, in particular, so that the <code>XUGGLE_HOME</code> environment variable is appropriately defined
 +
* Download the JASigning [http://vhg.cmp.uea.ac.uk/tech/jas/vid/ja-vg-server.zip Video Generation Server] ZIP archive, and unzip it in any convenient location
 +
** Check (e.g. using the Java Preferences app) that you have the 64-bit Java SE 6 installed.
  
=== (A) Install Xuggler ===
+
=== Installation on Windows ===
  
* Install the Xuggler library from the [http://www.xuggle.com/xuggler/downloads/ Xuggle download page], following the instructions on that page.
+
* Download the [http://vhg.cmp.uea.ac.uk/tech/jas/vid/xuggle-xuggler.3.4.1012-win32-setup.exe Xuggler Library installation program]
** In particular, make sure that the <tt>XUGGLE_HOME</tt> environment variable is appropriately defined.
+
* Run the downloaded program to install the Xuggler 3.4 library
** '''NB''':
+
** On Windows, Xuggler requires a 32-bit version of Java 6 or Java 7
*** On Mac OS X, Xuggler requires the 64-bit version of Java 6;
+
* Download the JASigning [http://vhg.cmp.uea.ac.uk/tech/jas/vid/ja-vg-server.zip Video Generation Server] ZIP archive, and unzip it in any convenient location
*** On Windows, Xuggler requires a 32-bit version of Java 5 or Java 6.
+
** Batch Script <code>run-jas-video-gen-server-win-jre6.bat</code> sets <code>JAVA_X86_HOME</code> to the normal location for Java 6
 +
** Batch Script <code>run-jas-video-gen-server-win-jre7.bat</code> should be suitable for Java 7
 +
** If necessary, use a text editor such as Notepad to ensure that the <code>JAVA_X86_HOME</code> setting matches the actual location of your 32-bit Java Runtime Environment installation
 +
** The JRE location can be found using the 32-bit Java Control Panel, ''Java'' tab. On 64-bit Windows systems, select ''View 32-bit Control Panel Items'' from the main Control Panel window to see the 32-bit version
  
 +
&nbsp;
 +
== Launching and Using the Video Generation Server ==
  
=== (B) Install the JASigning Video Server ===
+
=== Launch the Video Server ===
 
 
* Download the JASigning [http://vhg.cmp.uea.ac.uk/tech/jas/vid/ja-vg-server.zip video generation server] ZIP archive, and unzip it in any convenient location.
 
** On Mac OS X: check (e.g. using the Java Preferences app) that you have the 64-bit Java SE 6 installed.
 
** On Windows:
 
*** Use a text editor such as Notepad to inspect the <tt>run-jas-video-gen-server-win.bat</tt> script file and check that its <tt>JAVA_X86_HOME</tt> setting matches the actual location of your 32-bit Java Runtime Environment installation.
 
**** The latter can be checked using the 32-bit Java Control Panel, ''Java'' tab.
 
**** To find the 32-bit Java Control Panel on 64-bit Windows systems, select ''View 32-bit Control Panel Items'' from the main Control Panel window.
 
*** If the script's <tt>JAVA_X86_HOME</tt> setting does ''not'' match your installation, then edit your copy of the script file to ensure that it does.
 
 
 
 
 
=== (C) Launch the Video Server ===
 
 
 
* Use the <tt>run-jas-video-gen-server</tt> script file appropriate to the platform, Mac or Windows, to launch the server.
 
** The server app has a <tt>Test</tt> button.
 
** This runs a test client that attempts to use the server to generate a video file using a set of image files.
 
** These files are held in the <tt>frames/</tt> subfolder of the download folder.
 
 
 
  
=== (D) Use the SiGML URL Player to Generate Video Files ===
+
* Use the <code>run-jas-video-gen-server</code> script file appropriate to the platform, Mac or Windows, to launch the server.
 +
** The server app has a <code>Test</code> button
 +
** This runs a test client that attempts to use the server to generate a video file using a set of image files
 +
** These files are held in the <code>frames/</code> subfolder of the server folder
 +
** The <code>Quit</code> button is used to terminate the server.
  
* Once the video generation server is running on the local system, a video of a signing animation can be generated using the JASigning SiGML URL Player app (development version), accessible from http://vhg.cmp.uea.ac.uk/tech/jas/dev/.
+
=== Use the SiGML URL Player to Generate Video Files ===
** Use the SiGML URL Player's <tt>File->Video Generation...</tt> menu item to generate a video of the most recently played signing animation.
 
** The SiGML URL Player accomplishes this by transmitting the animation's frame data to the video generation server, which produces the <tt>.mov</tt> file.
 
** The SiGML URL Player should refuse to attempt video generation if it is not feasible, e.g. when there is no current animation, or when the video generation server app is not running.
 
  
 +
* Once the video generation server is running on the local system, a video of a signing animation can be generated using the JASigning SiGML URL Player app, accessible from http://vhg.cmp.uea.ac.uk/tech/jas/std/
 +
** Use the SiGML URL Player's <code>File->Video Generation...</code> menu item to generate a video of the most recently played signing animation
 +
** The SiGML URL Player accomplishes this by transmitting the animation's frame data to the video generation server, which produces the <code>.mov</code> file
 +
** The SiGML URL Player should refuse to attempt video generation if it is not feasible, e.g. when there is no current animation, or when the video generation server app is not running
  
 +
=== Configuring the Video Server ===
 +
* The <code>Log</code> checkbox can be used to provide more verbose logging of server operation.
 +
* The <code>Video</code> checkbox, selected by default, causes a QuickTime movie to be generated in a specified location.
 +
* The <code>Frames</code> checkbox causes a folder to be created containing a set of <code>PNG</code> images for the frames sent to the server:
 +
** Frames are placed in a folder whose name is the same as the QuickTime movie with ".frames" appended.
 +
** Files are created in XML and Java Properties formats recording the settings sent to the server: movie name, width and height in pixels, frames per second, and total frame count.
 
----
 
----
 +
[[Main Page|Home]] >> [[JASigning]]

Revision as of 15:27, 22 December 2014

The software described on this page is © UEA and is for evaluation use only. Please contact the Virtual Humans Group at UEA VirtualSigning@cmp.uea.ac.uk if you wish to use this facility for other purposes.  


Home >> JASigning


 

Video Generation using JASigning

JASigning is now able to generate a video of an animation using a video video generation server application. The server needs the supporting Xuggler video processing library to be installed on the same computer system as the main JASigning application being used. Video files are generated only in the .mov format.

This page gives information on installing the Video Generation Server and explains how to use the SiGML URL Player application to create videos.

 

Installing the Video Generation Server

Installation on MacOS X

  • Download the Xuggler Library installation script
  • Run the installation script to install the Xuggler 3.4 library
    • Start the Terminal application and move to the directory containing the script
    • Enter sudo sh xuggle-xuggler.3.4.1012-i386-apple-darwin9.8.0.sh
    • Authentication is needed to install in the standard location /usr/local/xuggler
    • Follow the instructions given, in particular, so that the XUGGLE_HOME environment variable is appropriately defined
  • Download the JASigning Video Generation Server ZIP archive, and unzip it in any convenient location
    • Check (e.g. using the Java Preferences app) that you have the 64-bit Java SE 6 installed.

Installation on Windows

  • Download the Xuggler Library installation program
  • Run the downloaded program to install the Xuggler 3.4 library
    • On Windows, Xuggler requires a 32-bit version of Java 6 or Java 7
  • Download the JASigning Video Generation Server ZIP archive, and unzip it in any convenient location
    • Batch Script run-jas-video-gen-server-win-jre6.bat sets JAVA_X86_HOME to the normal location for Java 6
    • Batch Script run-jas-video-gen-server-win-jre7.bat should be suitable for Java 7
    • If necessary, use a text editor such as Notepad to ensure that the JAVA_X86_HOME setting matches the actual location of your 32-bit Java Runtime Environment installation
    • The JRE location can be found using the 32-bit Java Control Panel, Java tab. On 64-bit Windows systems, select View 32-bit Control Panel Items from the main Control Panel window to see the 32-bit version

 

Launching and Using the Video Generation Server

Launch the Video Server

  • Use the run-jas-video-gen-server script file appropriate to the platform, Mac or Windows, to launch the server.
    • The server app has a Test button
    • This runs a test client that attempts to use the server to generate a video file using a set of image files
    • These files are held in the frames/ subfolder of the server folder
    • The Quit button is used to terminate the server.

Use the SiGML URL Player to Generate Video Files

  • Once the video generation server is running on the local system, a video of a signing animation can be generated using the JASigning SiGML URL Player app, accessible from http://vhg.cmp.uea.ac.uk/tech/jas/std/
    • Use the SiGML URL Player's File->Video Generation... menu item to generate a video of the most recently played signing animation
    • The SiGML URL Player accomplishes this by transmitting the animation's frame data to the video generation server, which produces the .mov file
    • The SiGML URL Player should refuse to attempt video generation if it is not feasible, e.g. when there is no current animation, or when the video generation server app is not running

Configuring the Video Server

  • The Log checkbox can be used to provide more verbose logging of server operation.
  • The Video checkbox, selected by default, causes a QuickTime movie to be generated in a specified location.
  • The Frames checkbox causes a folder to be created containing a set of PNG images for the frames sent to the server:
    • Frames are placed in a folder whose name is the same as the QuickTime movie with ".frames" appended.
    • Files are created in XML and Java Properties formats recording the settings sent to the server: movie name, width and height in pixels, frames per second, and total frame count.

Home >> JASigning