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...')
 
 
(10 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.'''
−
 
+
 
−
JASigning is now able to generate a video of an animation.
+
----
−
 
+
[[Main Page|Home]] >> [[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.
+
----
−
 
 
−
Note that currently, and for the foreseeable future, video files are generated only in the <tt>.mov</tt> format.
 
−
 
 
−
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;
 +
== Video Generation using JASigning ==
  
−
== Installing and Using the Video Generation Server ==
+
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.
  
−
=== (A) Install Xuggler ===
+
An earlier system was based on the Xuggler package which is no longer supported. See [[Xuggler Video Generator]].
  
−
* Install the Xuggler library from the [http://www.xuggle.com/xuggler/downloads/ Xuggle download page], following the instructions on that page.
+
== Installing the Video Generation Server ==
−
** In particular, make sure that the <tt>XUGGLE_HOME</tt> environment variable is appropriately defined.
 
−
** '''NB''':
 
−
*** On Mac OS X, Xuggler requires the 64-bit version of Java 6;
 
−
*** On Windows, Xuggler requires a 32-bit version of Java 5 or Java 6.
 
  
 +
* Download the [http://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
 +
* Since use of Java has become very restrictred, you may need to override security settings to run the server and download and run the SiGML Player
  
−
=== (B) Install the JASigning Video Server ===
+
== Launching the Video Generation 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.
+
* Use the '''run-jas-video-gen-server''' script file appropriate to the platform, Mac or Windows, to launch the server
−
** On Mac OS X: check (e.g. using the Java Preferences app) that you have the 64-bit Java SE 6 installed.
+
* The server app should launch with a '''Test''' and '''Quit''' button
−
** On Windows:
+
* '''Test''' runs a test client that uses the server to generate a video from frames held in the '''frames''' subfolder of the VideoGen folder
−
*** 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.
+
* '''Quit''' is used to terminate the server
−
**** 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.
 
  
 +
== Using the SiGML Player to Generate Video Files ==
  
−
=== (C) Launch the Video Server ===
+
* 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 http://vhg.cmp.uea.ac.uk/tech/jas/vhg2022b
−
 
+
* Use the SiGML Player's <code>File->Video Generation...</code> menu item to generate a video of the most recently played signing animation
−
* Use the <tt>run-jas-video-gen-server</tt> script file appropriate to the platform, Mac or Windows, to launch the server.
+
* 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 server app has a <tt>Test</tt> button.
+
* 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
−
** This runs a test client that attempts to use the server to generate a video file using a set of image files.
+
* Some videos may be larger than expected due to high resolution displays such as Apple Retina displays
−
** These files are held in the <tt>frames/</tt> subfolder of the download folder.
 
−
 
 
−
 
 
−
=== (D) 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 (development version), accessible from http://vhg.cmp.uea.ac.uk/tech/jas/dev/.
 
−
** 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.
 
  
 +
== 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
  
 +
== 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
 +
&nbsp;
 
----
 
----
 +
[[Main Page|Home]] >> [[JASigning]]

Latest revision as of 18:52, 3 July 2022

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
  • Since use of Java has become very restrictred, you may need to override security settings to run the server and download and run the SiGML Player

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 http://vhg.cmp.uea.ac.uk/tech/jas/vhg2022b
  • 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

Retrieved from ‘http://vh.cmp.uea.ac.uk/index.php?title=JASigning_Video_Generator&oldid=568’