Geek Gadgets 1/ADE-1.bin/ade-bin/x11r6.1/man/cat1/xieperf.0

Text File | 1996-10-17 | 39.3 KB | 1,057 lines

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   over-
             ride_redirect  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 spec-
             ified by _x_i_e_p_e_r_f

       --sshhoowwtteecchhss    Display a comprehensive list of  techniques,
             by      category,   indicating   which  of  the



X Version 11           Release 6.1                3





xieperf(1)                           xieperf(1)


             techniques are supported by the XIE  server.

       --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



X Version 11           Release 6.1                4





xieperf(1)                           xieperf(1)


             set to the default.

       --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.




X Version 11           Release 6.1                5





xieperf(1)                           xieperf(1)


       --QQuueerryyPPhhoottoommaapp
             Query Photomap resource test.

       --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.




X Version 11           Release 6.1                6





xieperf(1)                           xieperf(1)


       --iimmppoorrttcclliieennttrrooii22
             ImportClientROI with 100 rectangles.

       --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



X Version 11           Release 6.1                7





xieperf(1)                           xieperf(1)


             Same  as the ExportClientHistogram test, but
             using a Control Plane to identify    the  area
             of interest.

       --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



X Version 11           Release 6.1                8





xieperf(1)                           xieperf(1)


             destination.

       --ccoonnssttrraaiinnpphhoottoo11
             Constrain    HardClip technique test, photomap
             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.



X Version 11           Release 6.1                9





xieperf(1)                           xieperf(1)


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

       --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.



X Version 11           Release 6.1                   10





xieperf(1)                           xieperf(1)


             Destination      window      colormap     is
             RGB_DEFAULT_MAP standard colormap.

       --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,         Con-
             strain(ClipScale), 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.




X Version 11           Release 6.1                   11





xieperf(1)                           xieperf(1)


       --ggeeoommeettrryy2299 tthhrroouugghh --ggeeoommeettrryy4422
             Geometry element tests, including rotations,
             scales,  and  mirroring.  BilinearInterpola-
             tion 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.





X Version 11           Release 6.1                   12





xieperf(1)                           xieperf(1)


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

       --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



X Version 11           Release 6.1                   13





xieperf(1)                           xieperf(1)


             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.
             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



X Version 11           Release 6.1                   14





xieperf(1)                           xieperf(1)


             function inner loop.

       --mmooddiiffyy55         This test    creates     a  rather  long  flo  of
             arithmetic elements, each which does nothing
             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.



X Version 11           Release 6.1                   15





xieperf(1)                           xieperf(1)


       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 alto-
       gether.    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