2017

USING QUARKXPRESS SERVER
92 | A Guide to QuarkXPress Server 2017
layout
The layout render modifier lets you render a specific layout.
Invalid parameter
value.
HTTP Error #500 This alert displays if you do not
specify additional attributes or specify attributes
with invalid values in an addlayer or
layerattribute request.
This layer has been
locked and cannot be
modified.
HTTP Error #500 This alert displays if you try to
add or modify an item on a locked layer.
L
ogs
S
ee “Understanding logging.”
Example GET URL
To render a single layer, use a URL like the
following:http://localhost:8080/doc.qxp?layer=layer1 To add a layer, use a
URL like the following:http://localhost:8080/qxpdoc/doc.qxp?addlayer=
NewLayer&visible=yes&suppressoutput=yes&locked=no To delete a layer,
use a URL like the following:
http://localhost:8080/qxpdoc/doc.qxp?deletelayer=Layer1 To render all
layers in a project, use a URL like the following:
http://localhost:8080/qxpdoc/doc.qxp?alllayers=true To set layer
attributes, use a URL like the
following:http://localhost:8080/qxpdoc/doc.qxp?layerattribute=
Layer1&name=Layer2&visible=true&keeprunaround=true
Example, object model
To add a new layer to a project, use code like the following:Layer layer =
new Layer(); layer.name = “New Layer”; layer.operation = “CREATE”;
RGBColor rgbcolor = new RGBColor(); layer.RGBColor = rgbcolor;
layout.layer = new Layer[]{layer};To edit the properties of an existing layer,
use the following object hierarchy:ModifierRequest < Project < Layout <
LayerTo delete a layer, set its operation attribute to “DELETE”.
Notes
You cannot add, modify, or delete multiple layers in a single request.You
cannot print layers whose visible and suppressoutput properties are set to
false.You can render a hidden or suppressed layer by referencing it with
the layer parameter. Suppressed layers are rendered for the jpeg, png, and
qxpdoc render types, but not for the pdf, postscript, and eps render
types.You can use the deconstruct and getdocinfo request handlers to
view information about the layers in a project.When you add a layer
using addlayer, any unspecified attributes use the settings in the
QuarkXPress Server layer preferences (Administration > Preferences >
Renderer > Layers).If the visible property is set to false, the suppressoutput
property is automatically set to true.
Parameters layout String
Lets you specify which
layout to render. The
first layout is layout 1.
Compatible with eps, jpeg, png, postscript, raw, pdf, screenpdf
Alerts
The requested layout
does not exist.
HTTP Error #500This alert displays if you supply
an invalid layout value.
Logs See “Understanding logging.”
Example GET URL
To render a layout by its layer ID, use a URL like the
following:http://localhost:8080/png/sample.qxp?layout=2 To render a