Difference between revisions of "JASigning Video Generator"

From Virtual Humans
Jump to navigation Jump to search
m
(Updated http to https)
 
(4 intermediate revisions by the same user not shown)
Line 8: Line 8:
 
== Video Generation using 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 <code>.mov</code> format.
+
JASigning is able to generate a video of an animation using a video video generation server application. The server needs to be installed on the same computer system as the main JASigning application being used. Video files are generated as '''.mp4''' files in '''H.264''' format.
  
This page gives information on installing the Video Generation Server and explains how to use the SiGML URL Player application to create videos.
+
This page gives information on installing the Video Generation Server and explains how to use the SiGML Player application to create videos.
  
 
An earlier system was based on the Xuggler package which is no longer supported. See [[Xuggler Video Generator]].
 
An earlier system was based on the Xuggler package which is no longer supported. See [[Xuggler Video Generator]].
  
&nbsp;
 
 
== Installing the Video Generation Server ==
 
== Installing the Video Generation Server ==
  
=== Installation on MacOS X ===
+
* Download the [https://vhg.cmp.uea.ac.uk/tech/jas/vid/javacv-vg-server-1.0-assemble.zip Video Generator installation ZIP file]
 +
* Unpack the ZIP file to a suitable location. It will be unpacked in a folder '''VideoGen'''
 +
* Check (e.g. using the Java Preferences app) that you have a 64-bit Java installation
 +
* If necessary configure the '''run-jas-video-gen-server''' script file for your platform to match the Java installation
 +
* Use of Java has become very restricted. See [[JASigning Platform Issues]]
  
* 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]
+
== Launching the Video Generation Server ==
* 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.
 
  
=== Installation on Windows ===
+
* Use the '''run-jas-video-gen-server''' script file appropriate to the platform, Mac or Windows, to launch the server
 +
* The server app should launch with a '''Test''' and '''Quit''' button
 +
* '''Test''' runs a test client that uses the server to generate a video from frames held in the '''frames''' subfolder of the VideoGen folder
 +
* '''Quit''' is used to terminate the server
  
* Download the [http://vhg.cmp.uea.ac.uk/tech/jas/vid/xuggle-xuggler.3.4.1012-win32-setup.exe Xuggler Library installation program]
+
== Using the SiGML Player to Generate Video Files ==
* 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 [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
 
** 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;
+
* Once the video generation server is running, a video of an animation can be generated using the Java Web Start SiGML Player app, accessible from https://vhg.cmp.uea.ac.uk/tech/jas/vhg2024a or a more recent Legacy Release found at [[CWASA Release Notes]]
== Launching and Using the Video Generation Server ==
+
* Use the SiGML Player's <code>File->Video Generation...</code> menu item to generate a video of the most recently played signing animation
 +
* The SiGML Player accomplishes this by transmitting the animation's frame data to the video generation server, which produces the <code>.mp4</code> file
 +
* The SiGML Player should refuse to attempt video generation if it is not feasible, e.g. when there is no current animation, or when the server is not running
 +
* Some videos may be larger than expected due to high resolution displays such as Apple Retina displays
  
=== Launch the Video Server ===
+
== 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 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 movie with ".frames" appended
 +
* Files are created in XML and Java Properties formats recording settings sent to the server: movie name, width and height, frames per second, and frame count
  
* Use the <code>run-jas-video-gen-server</code> script file appropriate to the platform, Mac or Windows, to launch the server.
+
== Adapting the Video Server ==
** The server app has a <code>Test</code> button
+
* The server uses JavaCV, a Java interface to FFmpeg, and has been built with Maven on NetBeans
** This runs a test client that attempts to use the server to generate a video file using a set of image files
+
* The VideoGen folder contains a NetBeans project containing sources and assembly information
** These files are held in the <code>frames/</code> subfolder of the server folder
+
* In order to support older MacOSX releases, such as High Sierra, older versions of JavaCV are used
** The <code>Quit</code> button is used to terminate the server.
+
* The Netbeans project should assemble a new installation ZIP file but may fail to run the server directly from NetBeans
 
+
&nbsp;
=== 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 <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]]
 
[[Main Page|Home]] >> [[JASigning]]

Latest revision as of 14:57, 29 April 2024

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 able to generate a video of an animation using a video video generation server application. The server needs to be installed on the same computer system as the main JASigning application being used. Video files are generated as .mp4 files in H.264 format.

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

An earlier system was based on the Xuggler package which is no longer supported. See Xuggler Video Generator.

Installing the Video Generation Server

  • Download the Video Generator installation ZIP file
  • Unpack the ZIP file to a suitable location. It will be unpacked in a folder VideoGen
  • Check (e.g. using the Java Preferences app) that you have a 64-bit Java installation
  • If necessary configure the run-jas-video-gen-server script file for your platform to match the Java installation
  • Use of Java has become very restricted. See JASigning Platform Issues

Launching the Video Generation Server

  • Use the run-jas-video-gen-server script file appropriate to the platform, Mac or Windows, to launch the server
  • The server app should launch with a Test and Quit button
  • Test runs a test client that uses the server to generate a video from frames held in the frames subfolder of the VideoGen folder
  • Quit is used to terminate the server

Using the SiGML Player to Generate Video Files

  • Once the video generation server is running, a video of an animation can be generated using the Java Web Start SiGML Player app, accessible from https://vhg.cmp.uea.ac.uk/tech/jas/vhg2024a or a more recent Legacy Release found at CWASA Release Notes
  • Use the SiGML Player's File->Video Generation... menu item to generate a video of the most recently played signing animation
  • The SiGML Player accomplishes this by transmitting the animation's frame data to the video generation server, which produces the .mp4 file
  • The SiGML Player should refuse to attempt video generation if it is not feasible, e.g. when there is no current animation, or when the server is not running
  • Some videos may be larger than expected due to high resolution displays such as Apple Retina displays

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 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 movie with ".frames" appended
  • Files are created in XML and Java Properties formats recording settings sent to the server: movie name, width and height, frames per second, and frame count

Adapting the Video Server

  • The server uses JavaCV, a Java interface to FFmpeg, and has been built with Maven on NetBeans
  • The VideoGen folder contains a NetBeans project containing sources and assembly information
  • In order to support older MacOSX releases, such as High Sierra, older versions of JavaCV are used
  • The Netbeans project should assemble a new installation ZIP file but may fail to run the server directly from NetBeans

 


Home >> JASigning