opj_viewer enabled stateless requests
[openjpeg.git] / applications / jpip / README
index 90cc956e75f278a67a6c1b8ac190578b2baa9052..0f053189f7084db93c91d69d986483fb7042de78 100644 (file)
@@ -53,7 +53,7 @@ Neither the author, nor the university accept any responsibility for any kind of
 <Optional>
  - Xerces2 java XML parser on the client for accessing embedded image metadata (http://xerces.apache.org/xerces2-j)
 
-We tested this software with a virtual server running on the same Linux machine as the clients. Currently, it works only on linux or macosx platforms, windows version should come later.
+We tested this software with a virtual server running on the same Linux machine as the clients.
 
 ----------
 4. Building instructions
@@ -90,6 +90,11 @@ Server:
 
  2. Launch opj_server from the server terminal:
     % spawn-fcgi -f ./opj_server -p 3000 -n
+ For shutting down JPIP server:
+     %GET http://hostname/myFCGI?quitJPIP
+     Notice, http://hostname/myFCGI is the HTTP server URI (myFCGI refers to opj_server by the server setting)
+     Requst message "quitJPIP" can be changed in Makfile, modify -DQUIT_SIGNAL=\"quitJPIP\"
 
 Client:
  1. Launch image decoding server, and keep it alive as long as image viewers are open
@@ -109,6 +114,7 @@ Client:
       Scale up request: Enlarge the window
       ROI request:      Select a region by mouse click and drag, then click inside the red frame of the selected region
     <If Xerces2 is installed>
+    % java -jar opj_viewer_xerces.jar http://hostname/myFCGI JP2_filename.jp2
       Annotate image with ROI information in XML metadata: Click button "Region Of Interest"
       Open a new window presenting an aligned image with a locally stored image: Click button "Image Registration" (Under Construction)
 
@@ -126,7 +132,7 @@ An example to encode a TIF image "copenhague1.tif" at resolution 4780x4050, 8bit
     % ./kdu_compress -i copenhague1.tif -o copenhague1.j2k Corder=RPCL  ORGtparts=R Stiles={256,256}
 
  2. JP2 encoding with embedding indexing data
-    % ./index_create copenhague1.j2k copenhague1.jp2 2
+    % ./j2k_to_idxjp2 copenhague1.j2k copenhague1.jp2
 
 <Option>
  3. Embed metadata into JP2 file