SigServer:SignatureXML
Back to: SigServer:Documentation
Root Element
Each signature is required to have a root element, <signature> in this case. The root tag accepts the attribute quality. It set's the quality when output as JPEG is selected. It may be set to anything between 0 - 100, default 90.
Example
<signature quality="90"> </signature>
The root element has two child elements, <defaults> and <layout>.
Defaults
Inside this element you may override an element's default value.
To override default element values the <defaults> tag is used. Inside the <defaults> tag elements are defined as usual.
Example
<signature> <defaults> <text color="#ff0000" /> <shape type="rectangle" color="#0000ff" /> </defaults> </signature>
This sets the texts' default color to red and the rectangles' to blue.
User defined variables
New way of setting user variables available. Old way deprecated.
Layout
All text, shapes and images are controlled by sub elements to <layout>
.
Image
The <image>
tag allows the user to include an image, chosen from the collection in the library section.
Attribute | Description | Values | Default |
---|---|---|---|
src | Sets which image that should be included. | Any title available in the library | none |
position | Sets the included image's position. | x-posxy-pos | 0x0 |
size | Sets the included image's size. | widthxheight | Image's own size |
display | Sets whether the image is visible or not. | true or false | true |
Shape
Attribute | Description | Values | Default |
---|---|---|---|
type | Defines the type of shape. | rectangle, ellipse, pie, arc or line | none |
position | Sets the shape's position. | x-posxy-pos | 0x0 |
size | Sets the shape's size. | widthxheight | 10x10 |
color | Sets the shape's color. | #<hex> or R, G, B | #000000 |
alpha | Sets the shape's opacity. Doesn't work very well with ellipses | 1-100 | 100 |
hollow | Sets whether the shape should be hollow or not. | true or false | true |
thickness | Sets the border's thickness. Works on lines and hollow shapes. | 1-10 | 1 |
display | Sets whether the shape is visible or not. | true or false | true |
angle (pie and arc only) | Sets the pie's/arc's start and end angle | stop / start-end | 0-90 |
Text
Attribute | Description | Values | Default |
---|---|---|---|
position | Sets the text's position. Relative to the bottom left corner, if nothing else is set in the align attribute. | x-posxy-pos | 0x0 |
size | Sets the text's size. | widthxheight | 10x10 |
color | Sets the text's color. | #<hex> or R, G, B | #000000 |
alpha | Sets the text's opacity. | 1-100 | 100 |
align | Sets the text's alignment. | bottom-left, bottom-right, top-left or top-right | bottom-left |
face | Sets the text's face. | See font list for all font's with recommended size | verdana |
angle | Sets the text's angle. | 0-359 | 0 |
line-space | Sets the spacing between the lines. | number | 1.5 |
thickness | Sets the border's thickness. Works on lines and hollow shapes. | 1-10 | 1 |
display | Sets whether the text is visible or not. | true or false | true |
Line
Attribute | Description | Values | Default |
---|---|---|---|
Same as Text except no 'position' or 'align' attribute. |