receive_display



receive_display  -h
receive_display [-s]  [-p portnum]
receive_display [-r resource]  [-fwidth,height]


Description

receive_display is the output display program for the RIVA renderer. It uses either socket or router connection to receive images from the renderer. If receive_display runs without any arguments, it defaults to a socket connection, port 7000, with border. receive_display quits upon the keystroke 'q'. The connection specified by receive_display must agree with that of hfb_host.

Options

-s
Use socket connection (default). Image size will be sent by the renderer if using socket.
-p portnum
Specifies a socket port number. If not specified, port number 7000 is used. Must agree with the port number used when running hfb_host (defined using switch -t).
-r resource
Use router connection. Resource name must be specified with resource.  The resource name must agree with the resource name of the output destination defined in flitrc.
-f width, height
When using router connection, buffer size must be specified with this parameter. Must agree with what's defined in flitrc.
-h
Display usage message.

Usage

For receive_display with a socket connection,
% receive_display -s 
connected to port 7000
Go for it
Be sure to wait for the "Go for it" message. The window for receive_display will appear when hfb_host is started. Size for the receive_display window will be determined by the renderer. If using a socket connection, receive_display must be started before hfb_host. The corresponding command to run hfb_host would look something like
hfb_host -c flit -p 8 -i earth.set -D socketlow -n RENDERER -o output/earth
For receive_display with a router connection,
% receive_display -r RenderTest -f 640,512
Using Router to communicate with RIVA.
Resource Name: RenderTest
Function Name: render_image
Image size: 640,512
Ready to read from hfb_host...
The window for receive_display will appear immediately, with the specified size. The resource name for receive_display is the one specified in flitrc. For the router connection, receive_display can be started at any time, and can be killed and restarted while the renderer is running. The corresponding command for hfb_host would look something like:
hfb_host -c flit -p 8 -i earthnew.set -D routerlow -n RENDERER -o output/earth

See Also

  Renderer Reference
Privacy / Copyrights
FIRST GOV   NASA Home Page This page, http://pat.jpl.nasa.gov/RIVA//public/RIVA/r_d.html, is maintained by Peggy Li and was last modified Friday, 15-Aug-2003 11:54:23 PDT, CL 03-2169
spacer