xieperf(1)					       xieperf(1)


NNAAMMEE
       xieperf - XIE server extension test and demo program

SSYYNNTTAAXX
       xxiieeppeerrff [-option ...]

DDEESSCCRRIIPPTTIIOONN
       The  _x_i_e_p_e_r_f  program  is  based	 upon R5 _x_1_1_p_e_r_f_(_1_) , and
       while not entirely comprehensive in its	coverage  of  the
       XIE  protocol (see BUGS, below), it is intended to be use-
       ful in the evaluation of XIE implementations in the  areas
       of  protocol  adherance and performance.	 The _x_i_e_p_e_r_f pro-
       gram includes tests which execute  each	of  the	 protocol
       requests	 and  photoflo elements specified by revision 5.0
       of the XIE protocol. In addition, _x_i_e_p_e_r_f provides  a  set
       of  tests  which can be used to validate the detection and
       transmission of XIE protocol request errors, such as  Flo-
       Match, FloValue, and so forth. Finally, _x_i_e_p_e_r_f provides a
       customizable demonstration program for XIE.

       A test is made up of three components executed in sequence
       -  an initialization function, a test function, and an end
       function. The initialization function is	 responsible  for
       allocating  and	populating  test  resources, such as pho-
       tomaps and LUTs, and for creating a stored photoflo  which
       will  be executed by the test function. The test function,
       in most cases, simply executes the stored photoflo  for	a
       specified  number of repetitions.  The end function, which
       is called following the test function, is  used	primarily
       to  destroy  any non-cachable server resources used by the
       test, and to free any memory which was  dynamically  allo-
       cated by the client. Some tests, such as -modify1, -await,
       -abort, and -redefine, perform additional steps within the
       test function inner loop, as required by the element being
       tested, or in an attempt to make the  test  more	 visually
       appealing.

       Evaluating  the	performance of individual XIE elements is
       not as simple as measuring Core X drawing times.	 The  XIE
       protocol requires elements to be embedded within photoflos
       in order	 to  be	 exercised,   and  the	minimum	 possible
       photoflo	 size is two.  This implies that it is impossible
       to measure performance of a single element in isolation	-
       the  time  it  takes  to run the flo depends on what other
       elements exist in the flo.  Extrapolating performance of a
       single  elment  (or technique) in a flo must be done care-
       fully, on a case-by-case basis,	since in general measured
       element	performance  depends  on  input	 image size, data
       type, and other factors,	 all of which can  be  influenced
       by  upstream  flo  elements.  Note further that the number
       and type of elements in a flo can  be  influenced  by  the
       visuals available on the display,  so even flo-flo compar-
       isons on machines with different visuals must be done with
       caution.



X Version 11		   Release 6.1				1





xieperf(1)					       xieperf(1)


       Many  test labels contain an abbreviated pipeline descrip-
       tion. For instance. IP/IL/P/ED  indicates  ImportPhotomap,
       ImportLUT,  Point, and ExportDrawable. Pipelines ending in
       ED (ExportDrawable) often include hidden elements such  as
       BandExtract, ConvertToIndex, Dither, or Point to match the
       flo output to the screen visual.	 Pipelines ending  in  EP
       (ExportPhotomap) will result in a blank window.

       _x_i_e_p_e_r_f	is  compatible with _x_1_1_p_e_r_f_c_o_m_p_(_1_)_, which is used
       to compare the outputs of different  _x_i_e_p_e_r_f  and  _x_1_1_p_e_r_f
       runs  in	 a nice, tabular format. In _x_i_e_p_e_r_f you will need
       to use the -labels option (see OPTIONS, below),	and  pro-
       vide the resulting labels file to _x_1_1_p_e_r_f_c_o_m_p_(_1_) to obtain
       correct output. See the _x_1_1_p_e_r_f_c_o_m_p_(_1_) man pages for  more
       details on this.

OOPPTTIIOONNSS
       _x_i_e_p_e_r_f accepts the options listed below:

       --ddiissppllaayy hhoosstt::ddppyy
		     Specifies which display to use.

       --iimmaaggeess _<_p_a_t_h_>
		     Normally,	_x_i_e_p_e_r_f	 references  image  files
		     located in the directory  ``images'',  which
		     _x_i_e_p_e_r_f  assumes  is located in your current
		     directory. If the	``images''  directory  is
		     not  in  your current directory, or the file
		     has been renamed, use this option to specify
		     its location.

       --ttiimmeeoouutt _<_s_>  Some tests require the reception of an event
		     such as FloNotify to continue, and may cause
		     _x_i_e_p_e_r_f  to  hang should these events not be
		     received. This option  allows  the	 user  to
		     specify  a timeout value which, if exceeded,
		     will cause _x_i_e_p_e_r_f to give up waiting for an
		     event, and continue on with the next test in
		     sequence.	Should an event timeout, a  warn-
		     ing  message  will be printed to stderr. The
		     default timeout value is 60 seconds.

       --ssyynncc	     Runs the tests in synchronous mode.

       --ssccrriipptt _<_f_i_l_e_>
		     Using this option gives the user the ability
		     to	 run  a subset of the available tests and
		     control the number of times  the  tests  are
		     executed  on  an  individual  basis. This is
		     thought to be especially  useful  for  those
		     running  _x_i_e_p_e_r_f for demonstration purposes.
		     Using this option	causes	_x_i_e_p_e_r_f	 to  read
		     commands specified in a script file, or from
		     stdin  if	_<_f_i_l_e_>	is   ``-''.   Tests   are



X Version 11		   Release 6.1				2





xieperf(1)					       xieperf(1)


		     specified	by newline-terminated input lines
		     of the form "command [-reps n ] [ -repeat	m
		     ]".   Characters following and including "#"
		     are treated as comments. See  the	-mkscript
		     option.

       --rreeppeeaatt _<_n_>   Repeats  each  test _n times (by default each
		     test is run 2 times).  This  option  may  be
		     used in script files also, in which case the
		     script file -repeat  overrides  the  command
		     line option.

       --ttiimmee _<_s_>     Specifies	how  long  in  seconds	each test
		     should be run (default 5 seconds).

       --ddeepptthh <<ddeepptthh>>
		     Use a visual with <depth> planes  per  pixel
		     (default is the default visual).

       --GGrraayySSccaallee    Use  a  GrayScale	visual	(default  is  the
		     default visual).

       --PPsseeuuddooCCoolloorr  Use a PseudoColor	visual	(default  is  the
		     default visual).

       --SSttaattiiccGGrraayy   Use  a  StaticGray	 visual	 (default  is the
		     default visual).

       --SSttaattiiccCCoolloorr  Use a StaticColor	visual	(default  is  the
		     default visual).

       --TTrruueeCCoolloorr    Use  a  TrueColor	visual	(default  is  the
		     default visual).

       --DDiirreeccttCCoolloorr  Use a DirectColor	visual	(default  is  the
		     default visual).

       --WWMMSSaaffee	     If	 _x_i_e_p_e_r_f  must be run in a window manager
		     environment, use this flag to  make  _x_i_e_p_e_r_f
		     aware  of	this.  If specified, _x_i_e_p_e_r_f will
		     create a window, identical to  the	 size  of
		     the  root	window,	 and  all further windows
		     created by _x_i_e_p_e_r_f will be	 transient  popup
		     children  of  this	 window.  If this flag is
		     omitted, _x_i_e_p_e_r_f will set the override_redi-
		     rect  attribute  of  all windows to ``True''
		     and will also do evil things such as calling
		     XInstallColormap.	 Using	this  option will
		     cause the window manager to (hopefully) obey
		     window geometry hints specified by _x_i_e_p_e_r_f

       --sshhoowwtteecchhss    Display  a comprehensive list of techniques,
		     by category, indicating which of  the  tech-
		     niques are supported by the XIE server.



X Version 11		   Release 6.1				3





xieperf(1)					       xieperf(1)


       --sshhoowwllaabbeellss   Print  test label to screen prior to calling
		     any of the test code. This allows	the  user
		     to	 know which test is executing in case the
		     test hangs for some reason.

       --sshhoowweevveennttss   Be verbose	 when  running	event  and  error
		     tests.  Also,  can be used to catch and dis-
		     play information  on  any	signals	 received
		     during  execution	of _x_i_e_p_e_r_f that the error
		     events received by	 _x_i_e_p_e_r_f  are  valid  the
		     first  time  the tests are executed on a new
		     platform.

       --eevveennttss	     Run tests which test for event generation.

       --eerrrroorrss	     Run tests which test for error event genera-
		     tion.

       --llooCCaall	     Skip test calibration. This may be used when
		     running _x_i_e_p_e_r_f in situations  where  execu-
		     tion  timing  is  not  important.	Execution
		     times will not be reported by  _x_i_e_p_e_r_f  when
		     this  option  is  enabled.	 The  inner  loop
		     repeat count,  additionally,  is  set  to	a
		     value  of	5  (but	 can be overridden by the
		     -reps option).

       --aallll	     Runs all  tests.  This  may  take	a  while,
		     depending	on the speed of your machine, and
		     its floating point capabilities. This option
		     is ignored if a script file is used.

       --tteessttss	     Generate  a  list of the available tests for
		     the _x_i_e_p_e_r_f program. In _x_1_1_p_e_r_f , this  list
		     is	 normally  displayed  in the usage state-
		     ment.  It	was  yanked  from  the	usage  of
		     _x_i_e_p_e_r_f because it was too lengthy.

       --mmkkssccrriipptt     Generate a script file suitable for use with
		     the script option. If -repeat or  -reps  are
		     also  specified,  they will be automatically
		     placed at the end of  each	 command  in  the
		     script.  The  script is generated to stderr.
		     See the -script command, above.

       --ccaacchhee _<_n_>    Most test flos utilize a  photomap	 resource
		     for  a  source.  A photomap cache of up to n
		     entries is controlled by  _x_i_e_p_e_r_f	to  avoid
		     having  to	 constantly  reload  these images
		     during  test  initialization.   The  default
		     cache  size  is  4. If a value less than the
		     default is specified, the cache size will be
		     set to the default.




X Version 11		   Release 6.1				4





xieperf(1)					       xieperf(1)


       --llaabbeellss	     Generates	just  the  descriptive labels for
		     each test specified. Use -all or  -range  to
		     specify   which   tests  are  included.  See
		     _x_1_1_p_e_r_f_c_o_m_p_(_1_) for more details.

       --DDIISS	     Pretend we are running  _x_i_e_p_e_r_f  while  con-
		     nected  to a DIS-only capable implementation
		     of XIE. This will cause _x_i_e_p_e_r_f  to  execute
		     those tests which only use protocol requests
		     found in the DIS subset of XIE,  and  bypass
		     those  which  are	not  DIS  compatible.  If
		     _x_i_e_p_e_r_f detects a DIS  server,  it	 will  do
		     this   automatically,  and	 this  option  is
		     ignored.  Use -all or -range to specify  the
		     initial range of tests.

       --rraannggee _<_t_e_s_t_1_>[[,,_<_t_e_s_t_2_>]]
		     Runs  all the tests starting from the speci-
		     fied  name	 _t_e_s_t_1	until  the  name   _t_e_s_t_2,
		     including	both  the  specified  tests. Some
		     tests, like the event and error tests,  also
		     require  the  -errors  or -events options to
		     specified.	 This  option  is  ignored  if	a
		     script it used.

       --rreeppss _<_n_>     Fix  the  inner  loop repetitions to n. This
		     indicates how many time the photoflo will be
		     executed  each  time  the	test is run. This
		     option is overridden on a per-test basis  if
		     specified	in  a  script. Typically, _x_i_e_p_e_r_f
		     determines the ideal number of  reps  during
		     each test's calibration period.

       --IImmppoorrttOObbssccuurreeddEEvveenntt tthhrroouugghh --EExxppoorrttAAvvaaiillaabbllee
		     Test  generation of events. Requires -events
		     flag.

       --BBaaddVVaalluuee tthhrroouugghh --FFllooVVaalluueeEErrrroorr
		     Test generation of errors. Requires  -errors
		     flag.   --CCoolloorrLLiisstt	 Create	 and destroy Col-
		     orList resource test.

       --LLUUTT	     Create and destroy LUT resource test.

       --PPhhoottoommaapp     Create and destroy Photomap resource test.

       --RROOII	     Create and destroy ROI resource test.

       --PPhhoottoossppaaccee   Create and destroy Photospace test.

       --PPhhoottoofflloo     Create and destroy Photoflo test.

       --QQuueerryyPPhhoottoommaapp
		     Query Photomap resource test.



X Version 11		   Release 6.1				5





xieperf(1)					       xieperf(1)


       --QQuueerryyCCoolloorrLLiisstt
		     Query ColorList resource test.

       --QQuueerryyTTeecchhnniiqquueessDDeeffaauulltt tthhrroouugghh --QQuueerryyTTeecchhnniiqquueessWWhhiitteeAAdd--
		     jjuusstt
		     Query  techniques as specified by test name.

       --QQuueerryyPPhhoottoofflloo
		     Query photoflo test.

       --PPuurrggeeCCoolloorrLLiisstt
		     PurgeColorList test.

       --AAbboorrtt	     This  tests  creates  a  photoflo	which  is
		     started and blocks for data provided by Put-
		     ClientData(). Instead of sending  the  data,
		     the   test	  uses	XieAbort()  to	stop  the
		     photoflo, and then	 waits	for  PhotofloDone
		     event  to be send by the server. If the test
		     times out waiting for  the	 event,	 a  error
		     message is sent to stderr.

       --AAwwaaiitt	     This  test creates a flo of the form Import-
		     ClientLUT -> ExportLUT, and starts	 the  flo
		     executing.	  _x_i_e_p_e_r_f  then	 forks,	 and  the
		     child process streams the LUT  data  to  the
		     flo  using	 PutClientData,	 while the parent
		     blocks in XieAwait. If the flo  successfully
		     finishes,	XieAwait  will return and the flo
		     state, after query, will  indicate	 that  it
		     has completed. If XieAwait does not complete
		     naturally, or after return from XieAwait the
		     flo is still active, an error is reported to
		     stderr. Note, on a really slow  machine,  it
		     is possible that XieAwait will return before
		     the flo has a  chance  to	finish.	 In  this
		     case,  use	 the  -timeout option to increase
		     the timeout for this test.

       --iimmppoorrttcclliieennttlluutt11
		     ImportClientLUT -> ExportLUT test.

       --iimmppoorrttcclliieennttpphhoottoo11 tthhrroouugghh --iimmppoorrttcclliieennttpphhoottoo99
		     Flos  of  the  form   ImportClientPhoto   ->
		     ExportPhotomap  using  various  decode tech-
		     niques,	e.g.	G32D,	 TIFF2,	   Uncom-
		     pressedTriple, and so forth.

       --iimmppoorrttcclliieennttrrooii11
		     ImportClientROI with 10 rectangles.

       --iimmppoorrttcclliieennttrrooii22
		     ImportClientROI with 100 rectangles.




X Version 11		   Release 6.1				6





xieperf(1)					       xieperf(1)


       --eennccooddeepphhoottoo11 tthhrroouugghh --eennccooddeepphhoottoo1144
		     Flos  of  the form ImportPhotomap -> Export-
		     Photomap using  various  encode  techniques,
		     e.g. G32D, TIFF2, UncompressedTriple, and so
		     forth.  Original encoding is shown	 in  left
		     window,  image  after  encoding  is shown in
		     right window.

       --eennccooddeecclliieennttpphhoottoo11 tthhrroouugghh --eennccooddeecclliieennttpphhoottoo1111
		     Two flos, one of the form ImportPhotomap  ->
		     ExportClientPhoto, and the other of the form
		     ImportClientPhoto ->  ExportPhotomap,  where
		     ExportClientPhoto in the first flo uses var-
		     ious encode techniques,  e.g.  G32D,  TIFF2,
		     UncompressedTriple,  and so forth. The image
		     before encoding is	 displayed  in	the  left
		     window,  while  the  right	 window shows the
		     image which was encoded in the first flo and
		     read back in the second flo.

       --eexxppoorrttcclliieennttlluutt11
		     ExportClientLUT  test. LUT is displayed in a
		     histogram window.

       --eexxppoorrttcclliieennttrrooii11
		     ExportClientROI  test,  10	 ROIs.	The  ROIs
		     which are sent to the server are represented
		     by the filled rectangles. The ROIs which are
		     received  back from the server by the client
		     are drawn as white bordered non-filled rect-
		     angles.   The  resulting  output illustrates
		     how the server combined the rectangles  sent
		     to it.

       --eexxppoorrttcclliieennttrrooii22
		     Same  as  exportclientroi1, except using 100
		     rectangles.

       --eexxppoorrttcclliieenntthhiissttooggrraamm11 tthhrroouugghh --eexxppoorrttcclliieenntthhiissttooggrraamm44
		     ExportClientHistogram  tests  using  various
		     images. The histogram is displayed in a win-
		     dow which overlaps the image.

       --eexxppoorrttcclliieenntthhiissttooggrraammrrooii11 tthhrroouugghh --eexxppoorrttcclliieenntthhiissttooggrraamm--
		     rrooii44
		     Same  as the ExportClientHistogram test, but
		     using a ROI to identify the area  of  inter-
		     est.

       --eexxppoorrttcclliieenntthhiissttooggrraammccppllaannee11   tthhrroouugghh	--eexxppoorrttcclliieenntthhiiss--
		     ttooggrraammcc-- ppllaannee44
		     Same  as the ExportClientHistogram test, but
		     using a Control Plane to identify	the  area
		     of interest.



X Version 11		   Release 6.1				7





xieperf(1)					       xieperf(1)


       --iimmppoorrttlluutt11   Test ImportLUT element, LUT size is 256.

       --iimmppoorrttpphhoottoo11 ImportPhotomap   ->   ExportPhotomap,   with
		     source and destination equal.

       --iimmppoorrttpphhoottoo22 ImportPhotomap  ->	 ExportDrawable,   window
		     destination.

       --iimmppoorrttrrooii11   ImportROI	 ->   ExportROI,  10  rectangles,
		     source and destination ROIs equal.

       --iimmppoorrttrrooii22   ImportROI	->  ExportROI,	100   rectangles,
		     source and destination ROIs equal.

       --iimmppoorrttddrraawwaabbllee11
		     ImportDrawable  -> ExportDrawable, Source is
		     pixmap, destination is window.

       --iimmppoorrttddrraawwaabbllee22
		     ImportDrawable -> ExportDrawable, Source and
		     destination is window.

       --iimmppoorrttddrraawwaabbllee33
		     ImportDrawable  ->	 ExportDrawable, Destina-
		     tion window obscured by source window.

       --iimmppoorrttddrraawwaabbllee44
		     ImportDrawable  ->	 ExportDrawable,   Source
		     window obscured by destination window.

       --iimmppoorrttddrraawwaabbllee55
		     ImportDrawablePlane  -> ExportDrawablePlane,
		     pixmap, source = destination.

       --iimmppoorrttddrraawwaabbllee66
		     ImportDrawablePlane ->  ExportDrawablePlane,
		     window, source = destination.

       --iimmppoorrttddrraawwaabbllee77
		     ImportDrawablePlane  -> ExportDrawablePlane,
		     window, source obscures destination.

       --iimmppoorrttddrraawwaabbllee88
		     ImportDrawablePlane ->  ExportDrawablePlane,
		     window, destination obscures source.

       --ccoonnssttrraaiinn11   Constrain	HardClip technique test, drawable
		     destination.

       --ccoonnssttrraaiinn22   Constrain ClipScale technique test, drawable
		     destination.

       --ccoonnssttrraaiinnpphhoottoo11
		     Constrain	HardClip technique test, photomap



X Version 11		   Release 6.1				8





xieperf(1)					       xieperf(1)


		     destination.

       --ccoonnssttrraaiinnpphhoottoo22
		     Constrain ClipScale technique test, photomap
		     destination.

       --ccoonnvvoollvvee11    Boxcar  3x3  convolution  test. Smoothing or
		     lowpass filter.

       --ccoonnvvoollvvee22    Boxcar 5x5 convolution  test.  Smoothing  or
		     lowpass filter.

       --ccoonnvvoollvvee33    LaPlacian	3x3  convolution  test.	 Edge  or
		     highpass filter.

       --ccoonnvvoollvvee44    LaPlacian	5x5  convolution  test.	 Edge  or
		     highpass filter.

       --ccoonnvvoollvveerrooii11 LaPlacian 3x3 convolution test, with ROI.

       --ccoonnvvoollvveerrooii22 LaPlacian 5x5 convolution test, with ROI.

       --ccoonnvvoollvveeccppllaannee11
		     LaPlacian 3x3 convolution test, with Control
		     Plane.

       --ccoonnvvoollvveeccppllaannee22
		     LaPlacian 5x5 convolution test, with Control
		     Plane.

       --mmaatthh11 tthhrroouugghh --mmaatthhccppllaannee77
		     Various  tests  which exercise the Math ele-
		     ment, some	 tests	using  ROIs  and  control
		     planes.

       --aarriitthhmmeettiiccddyyaaddiicc11 tthhrroouugghh --aarriitthhmmeettiiccddyyaaddiicc55
		     Arithmetic element tests, using photomaps as
		     the operands.

       --aarriitthhmmeettiiccmmoonnaaddiicc11 tthhrroouugghh --aarriitthhmmeettiiccmmoonnaaddiicc99
		     Arithmetic element tests, photomap and  con-
		     stant operands.

       --aarriitthhmmeettiiccddyyaaddiiccrrooii11 tthhrroouugghh --aarriitthhmmeettiiccddyyaaddiiccrrooii55
		     Arithmetic element tests, using photomaps as
		     the operands, with ROIs.

       --aarriitthhmmeettiiccmmoonnaaddiiccrrooii11 tthhrroouugghh --aarriitthhmmeettiiccmmoonnaaddiiccrrooii99
		     Arithmetic element tests, photomap and  con-
		     stant operands, with ROIs.

       --aarriitthhmmeettiiccddyyaaddiiccccppllaannee11 tthhrroouugghh --aarriitthhmmeettiiccddyyaaddiiccccppllaannee55
		     Arithmetic element tests, using photomaps as
		     the operands, with Control Planes.



X Version 11		   Release 6.1				9





xieperf(1)					       xieperf(1)


       --aarriitthhmmeettiiccmmoonnaaddiiccccppllaannee11 tthhrroouugghh --aarriitthhmmeettiiccmmoonnaaddiicccc--
		     ppllaannee99
		     Arithmetic	 element tests, photomap and con-
		     stant operands, with Control Planes.

       --aarriitthhmmeettiiccffllooaattddyyaaddiicc11 tthhoouugghh --aarriitthhmmeettiiccffllooaattddyyaaddiicc55
		     Arithmetic element tests, using photomaps as
		     the operands, unconstrained.

       --aarriitthhmmeettiiccffllooaattmmoonnaaddiicc11 tthhoouugghh --aarriitthhmmeettiiccffllooaattmmoonnaaddiicc99
		     Arithmetic	 element tests, photomap and con-
		     stant operands, unconstrained.

       --aarriitthhmmeettiiccrrooiiffllooaattddyyaaddiicc11 ttoo --aarriitthhmmeettiiccrrooiiffllooaattddyyaaddiicc55
		     Arithmetic element tests, photomaps  as  the
		     operands, ROIs, unconstrained.

       --aarriitthhmmeettiiccrrooiiffllooaattmmoonnaaddiicc11 ttoo --......rriitthhmmeettiiccrrooiiffllooaatt--
		     mmoonnaaddiicc99
		     Arithmetic element tests, photomap and  con-
		     stant operands, ROIs, unconstrained.

       --bbaanndd11	     BandSelect	 element  test.	 Image	input  is
		     triple band. If visual of _x_i_e_p_e_r_f window  is
		     a	color  visual, then three BandSelect ele-
		     ments are used  to	 extract  the  indivudual
		     bands,  they  are	combined once again using
		     BandCombine, and  displayed  using	 Convert-
		     ToIndex.  If  the	visual is not color, e.g.
		     GrayScale or StaticGray, then the flo simply
		     uses  one	BandSelect  element  to extract a
		     single band for display.

       --bbaanndd22	     BandCombine test. Input bands are made of of
		     three  separate single band photomaps. These
		     are combined using	 a  BandCombine	 element,
		     which  is	followed  by  a	 BandExtract  and
		     ExportDrawable. CCIR 601-1 coefficients.

       --bbaanndd33	     BandExtract test. Input  is  a  triple  band
		     photomap. CCIR 601-1 coefficients.	 Destina-
		     tion window colormap is gray ramp.

       --bbaanndd44	     BandExtract test. Input  is  a  triple  band
		     photomap. CCIR 601-1 coefficients.	 Destina-
		     tion window colormap is  RGB_BEST_MAP  stan-
		     dard colormap.

       --bbaanndd55	     BandExtract  test.	 Input	is  a triple band
		     photomap. CCIR 601-1 coefficients.	 Destina-
		     tion   window  colormap  is  RGB_DEFAULT_MAP
		     standard colormap.





X Version 11		   Release 6.1			       10





xieperf(1)					       xieperf(1)


       --ccoommppaarreeddyyaaddiicc11 tthhrroouugghh --ccoommppaarreeddyyaaddiicc66
		     Test various Compare operators  with  dyadic
		     photomap operands.

       --ccoommppaarreemmoonnaaddiicc11 tthhrroouugghh --ccoommppaarreemmoonnaaddiicc66
		     Test  various  compare  operators	with pho-
		     tomap, constant operands.

       --ccoommppaarreerrooiiddyyaaddiicc11 tthhrroouugghh --ccoommppaarreerrooiiddyyaaddiicc66
		     Test various Compare operators  with  dyadic
		     photomap operands, using ROIs.

       --ccoommppaarreerrooiimmoonnaaddiicc11 tthhrroouugghh --ccoommppaarreerrooiimmoonnaaddiicc66
		     Test  various  compare  operators	with pho-
		     tomap, constant operands, using ROIs.

       --ccoommppaarreeccppllaanneeddyyaaddiicc11 tthhrroouugghh --ccoommppaarreeccppllaanneeddyyaaddiicc66
		     Test various Compare operators  with  dyadic
		     photomap operands, Control Planes.

       --ccoommppaarreeccppllaanneemmoonnaaddiicc11 tthhrroouugghh --ccoommppaarreeccppllaanneemmoonnaaddiicc66
		     Test  various  compare  operators	with pho-
		     tomap, constant operands, Control Planes.

       --mmaattcchhhhiissttooggrraamm11 tthhrroouugghh --mmaattcchhhhiissttooggrraamm1188
		     MatchHistogram element tests, using  various
		     images and histogram matching techniques.

       --mmaattcchhhhiissttooggrraammrrooii11 tthhrroouugghh --mmaattcchhhhiissttooggrraammrrooii66
		     A selection of MatchHistogram element tests,
		     with ROIs.

       --mmaattcchhhhiissttooggrraammccppllaannee11 tthhrroouugghh --mmaattcchhhhiissttooggrraammccppllaannee66
		     A selection of MatchHistogram element tests,
		     with Control Planes.

       --uunnccoonnssttrraaiinn11 ImportPhotomap, Unconstrain, Constrain(Clip-
		     Scale), ExportDrawable test.

       --ppaasstteeuupp11 tthhrroouugghh --ppaasstteeuupp22
		     PasteUp element tests.

       --ggeeoommeettrryy11 tthhrroouugghh --ggeeoommeettrryy1144
		     Geometry element tests, including rotations,
		     scales,   and   mirroring.	  NearestNeighbor
		     technique.

       --ggeeoommeettrryy1155 tthhrroouugghh --ggeeoommeettrryy2288
		     Geometry element tests, including rotations,
		     scales, and mirroring.  AntiAlias technique.

       --ggeeoommeettrryy2299 tthhrroouugghh --ggeeoommeettrryy4422
		     Geometry element tests, including rotations,
		     scales,		and	       mirroring.



X Version 11		   Release 6.1			       11





xieperf(1)					       xieperf(1)


		     BilinearInterpolation technique.

       --ggeeoommgg3311ddssccaallee11 tthhrroouugghh --ggeeoommeettrryyffaaxxrraaddiioo11
		     Tests to exercise the various  FAX	 decoders
		     and the Geometry element.

       --ddiitthheerr11	     Dither  test,  ErrorDiffusion  dither  tech-
		     nique, ExportDrawable.

       --ddiitthheerr22	     Dither  test,  ErrorDiffusion  dither  tech-
		     nique, ExportDrawablePlane.

       --ddiitthheerr33	     Dither  test,  Ordered(4)	dither technique,
		     ExportDrawable.

       --ddiitthheerr44	     Dither test,  Ordered(4)  dither  technique,
		     ExportDrawablePlane.

       --ddiitthheerr55	     Dither  test,  Ordered(8)	dither technique,
		     ExportDrawable.

       --ddiitthheerr66	     Dither test,  Ordered(8)  dither  technique,
		     ExportDrawablePlane.

       --ddiitthheerr77	     Dither   test,   Default  dither  technique,
		     ExportDrawable.

       --ddiitthheerr88	     Dither  test,  Default   dither   technique,
		     ExportDrawablePlane.

       --llooggiiccaallmmoonnaaddiicc11 tthhrroouugghh --llooggiiccaallmmoonnaaddiicc1166
		     Logical  element, photomap and a constant of
		     0 as operands, various operators.

       --llooggiiccaallddyyaaddiicc11 tthhrroouugghh --llooggiiccaallddyyaaddiicc1166
		     Logical element tests, dyadic  photomaps  as
		     operands, various operators.

       --llooggiiccaallmmoonnaaddiiccrrooii11 tthhrroouugghh --llooggiiccaallmmoonnaaddiiccrrooii1166
		     Logical  element, photomap and constant of 0
		     operands, various operators, ROIs.

       --llooggiiccaallddyyaaddiiccrrooii11 tthhrroouugghh --llooggiiccaallddyyaaddiiccrrooii1166
		     Logical   element,	  dyadic   photomaps   as
		     operands, various operators, ROIs.

       --llooggiiccaallmmoonnaaddiiccccppllaannee11 tthhrroouugghh --llooggiiccaallmmoonnaaddiiccccppllaannee1166
		     Logical  element, photomap and constant of 0
		     operands, various operators, Control Planes.

       --llooggiiccaallddyyaaddiiccccppllaannee11 tthhrroouugghh --llooggiiccaallddyyaaddiiccccppllaannee1166
		     Logical   element,	  dyadic   photomaps   as
		     operands, various operators, Control Planes.




X Version 11		   Release 6.1			       12





xieperf(1)					       xieperf(1)


       --bblleenndd11	     Blend  element  test.  Monadic  source,  0.1
		     source constant. Alpha constant of 0.5.

       --bblleenndd22	     Blend element test.  Dyadic  sources.  Alpha
		     constant of 0.5.

       --bblleennddrrooii11    Blend  test. Monadic source, 0.1 source con-
		     stant. Alpha constant of 0.5. ROIs.

       --bblleennddrrooii22    Blend element test.  Dyadic  sources.  Alpha
		     constant of 0.5. Uses ROIs.

       --bblleennddccppllaannee11 Blend  test. Monadic source, 0.1 source con-
		     stant. Alpha constant of 0.5. Control Plane.

       --bblleennddccppllaannee22 Blend  element  test.  Dyadic sources. Alpha
		     constant of 0.5. Control Plane.

       --bblleennddaallpphhaa11  Blend test. Monadic source, 220 source  con-
		     stant. Alpha plane is a photomap.

       --bblleennddaallpphhaa22  Blend test. Dyadic sources. Alpha plane is a
		     constant 220.

       --bblleennddaallpphhaarrooii11
		     Blend test. Monadic source, 220 source  con-
		     stant. Alpha plane photomap. ROIs.

       --bblleennddaallpphhaarrooii22
		     Blend test. Dyadic sources. Alpha plane is a
		     constant 220. ROIs.

       --ttrriipplleeppooiinntt11 tthhrroouugghh --ttrriipplleeppooiinntt22
		     Illustrate use of point  and  Standard  col-
		     ormaps for rendering triple band images.

       --ffuunnnnyyeennccooddee11 tthhrroouugghh --ffuunnnnyyeennccooddee88
		     These  tests  are	design to perform limited
		     exercising of XIE's  capability  of  dealing
		     with  various  encodings of flo source data.
		     The test init function  obtains  a	 photomap
		     using  ICP	 ->  EP.  A series of independent
		     permanent flo pairs, one of the form  IP  ->
		     EP,  and  the  other of the basic form IP ->
		     ED, are constructed. The encoding parameters
		     for  the  ExportPhotomap (EP) element in the
		     first flo are derived from	 test  configura-
		     tion.  The	 number	 of  flo pairs created is
		     also dependent upon test configuration.  The
		     tests  can	 be  configured	 so that the test
		     init function will constrain the input  pho-
		     tomap  to a specified number of levels, on a
		     per-band basis, so that word-sized and quad-
		     sized  pixels  are	 passed through the flos.



X Version 11		   Release 6.1			       13





xieperf(1)					       xieperf(1)


		     Some tests below take advantage of this. See
		     tests.c for test configuration, and hints on
		     how to add similar tests.

       --ppooiinntt11 tthhrroouugghh --ppooiinntt33
		     Simple Point element tests. Drawable  desti-
		     nation.   --ppooiinnttrrooii11  Simple  Point  element
		     test which uses ROIs. Drawable  destination.

       --ppooiinnttccppllaannee11 Simple  Point element test which uses a Con-
		     trol Plane. Drawable destination.

       --ppooiinnttpphhoottoo11  Simple Point element test. Photomap destina-
		     tion.

       --ppooiinnttrrooiipphhoottoo11
		     Simple Point element test which uses a ROIs.
		     Photomap destination.

       --ppooiinnttccppllaanneepphhoottoo11
		     Simple Point element test which uses a  Con-
		     trol Plane. Photomap destination.

       --rreeddeeffiinnee     Two flographs are created which are the same
		     in structure, expect for the x and y offsets
		     specified	for  the  ExportDrawable flo ele-
		     ments. The	 test  init  function  creates	a
		     photoflo  based  upon  one	 of  the two flo-
		     graphs.  The inner loop of the test function
		     uses   XieRedefinePhotoflo()   to	alternate
		     between each of  the  flographs.  Make  sure
		     that  your	 ineer loop reps are 2 or greater
		     in order to exercise this	test  fully  (see
		     -reps).

       --mmooddiiffyy11	     Test  XieModifyPhotoflo() by adjust ROI off-
		     sets and size.

       --mmooddiiffyy22	     Test XieModifyPhotoflo() by changing the LUT
		     input to a Point element.

       --mmooddiiffyy33	     Test XieModifyPhotoflo() by changing Export-
		     Drawable x and y offsets.

       --mmooddiiffyy44	     This test	creates	 a  rather  long  flo  of
		     arithmetic elements, each which does nothing
		     more than add 1 to a small image.	The  test
		     init function scales the input photomap. The
		     ExportDrawable x and y  offset  is	 modified
		     randomly  during  each iteration of the test
		     function inner loop.

       --mmooddiiffyy55	     This test	creates	 a  rather  long  flo  of
		     arithmetic elements, each which does nothing



X Version 11		   Release 6.1			       14





xieperf(1)					       xieperf(1)


		     more than add 1 to a large image.	Each rep,
		     the  Geometry and ExportDrawable elements at
		     the end of the flo are  modifed  to  crop	a
		     small  piece of the input into its appropri-
		     ate place in the larger image.

       --rrggbb11 tthhrroouugghh --rrggbb1166
		     These tests all  basically	 take  an  Uncom-
		     pressedTriple  image  as  input,  send it to
		     ConvertFromRGB which converts the	image  to
		     some  configured  colorspace,  and then send
		     the converted image on to ConvertToRGB prior
		     to	 display. The original image is displayed
		     in the lefthand window, and the image  which
		     has  passed  through the flo is shown in the
		     righthand window. The goal of these test  is
		     to	 show that ConvertFromRGB -> ConvertToRGB
		     is lossless.

       --ccoonnvveerrttttooiinnddeexxppiixxeell
		     ConvertToIndex test, TripleBand BandByPixel.

       --ccoonnvveerrttttooiinnddeexxppllaannee
		     ConvertToIndex test, TripleBand BandByPlane.

       --ccoonnvveerrttffrroommiinnddeexx
		     The test init function uses a flo containing
		     ConvertToIndex  to	 display  an image in the
		     left window. The  test  function  uses  this
		     drawable  as  input to a flo which does Con-
		     vertFromIndex ->  ConvertToIndex  and  sends
		     the resulting image to the right window. The
		     result should be lossless.

       --ccoommpplleexx	     A somewhat	 large	flo  which  uses  control
		     planes,  LUTs, Point, PasteUp, Logical, Con-
		     strain,  Dither,  Geometry,  MatchHistogram,
		     BandCombine,  and	BandSelect  elements. See
		     the Postscript  file  ''complex.ps''  for	a
		     rendition of the photoflo which is executed.

XX DDEEFFAAUULLTTSS
       There are no X defaults used by this program.

SSEEEE AALLSSOO
       X(1), x11perf(1), x11perfcomp(1)

BBUUGGSS
       There should be a IMAGES environment variable  to  augment
       the -images option.

       Many  tests  only  scratch  the	surface	 of possible test
       cases.  Some of the options available for certain flo ele-
       ments   are   either   inadequately   tested,  or  ignored



X Version 11		   Release 6.1			       15





xieperf(1)					       xieperf(1)


       altogether.  There  are	insufficent  tests  for	 bitonal,
       large pixel, or triple band tests.

       Some  of	 the  test  names  are inconsistently cased, e.g.
       -Abort and -dither1.

       Some tests are hopelessly slow when run	against	 machines
       with slow FPUs.

       Bitonal	images	are for the most part displayed using the
       ExportDrawable flo element,  however,  ExportDrawablePlane
       would be a better choice.

AAUUTTHHOORR
       Syd Logan, AGE Logic, Inc.










































X Version 11		   Release 6.1			       16