2020

Table Of Contents
USING QUARKXPRESS SERVER
Setrendererprefs
The setrendererprefs request handler lets you set rendering preferences. To use
this request handler, issue a getrendererprefs request, determine the name of
the tag that needs to be modified, and then submit a setrendererprefs request
with the using the name of this tag. For example, set color TIFF and gray TIFF
display preferences, you would first submit a getrendererprefs request to the
server, then update these settings and submit a setrendererprefs request to the
server, like so:
http://server:port/setrendererprefs?modify=<QXPSRENDERERPREFERENC
ES>
<DISPLAY><ColorTIFFs>8-bit</ColorTIFFs><GrayTIFFs>16
levels</GrayTIFFs></DISPLAY>
</QXPSRENDERERPREFERENCES>
This request handler sets the preferences for all renderers.
Renderer preferences
The /getrendererprefs handler lets clients remotely retrieve an XML
representation of the current QuarkXPress Server renderer preferences, as described
below. For a detailed description of each preference, see “General Preferences dialog
box” in A Guide to QuarkXPress Server.
The /setrendererprefs handler lets clients remotely control QuarkXPress Server
renderer preferences. For more information, see “Setrendererprefs.”
Namespace setrendererprefs
Response The message “Preferences successfully set.”
Alerts
Incorrect
administrati
on realm
user name
and
password.
HTTP Error #401 This alert displays if you specify an invalid
administrator user name and password. What to do: Use the user
name and password set in the QuarkXPress Server Manager client
Server Configuration dialog box.
Logs See “Understanding logging.”
Example GET
URL
http://localhost:8080/setrendererprefs?modify=
<QXPSRENDERERPREFERENCES><DISPLAY><ColorTIFFs>8-bit</ColorTIFFs>
<GrayTIFFs>16 levels</GrayTIFFs></DISPLAY></QXPSRENDERERPREFERENCES>
Notes
The schema for the returned XML stream can be found at
webapps/ROOT/QuarkXPress Server Renderer/QXPSRendererPreferences.xsd.If a
user name and password have been set in the Server Configuration dialog box,
the browser requests that user name and password when you submit a
setrendererprefs parameter request.
Attribute Type Description
DISPLAY
ColorTIFFs string Set to 8-bit or 24-bit.
GrayTIFFs string Set to 16 levels or 256 levels.
MonitorProfile string Set to one of the options under MonitorProfileList.
A GUIDE TO QUARKXPRESS SERVER 2020 | 179