Search manual:

- Main page
- Introduction
- Hello, world!
- Basics
  - How to write the layout
  - Structure of the data file and the layout rules
  - Outputting objects
  - Grid
  - Areas on the page (PositioningArea)
  - File organization
  - Hyphenation / language settings
  - Using fonts
  - Text formats
  - Text formatting
  - Colors
- Programming
- Image inclusion
- Tables
- Advanced topics
  - Bookmarks
  - Creation of XML structures
  - Print output / crop marks
  - Using CSS with the speedata Publisher
  - Groups (virtual objects)
  - Virtual pages
  - Rotation of contents
  - Sorting data
  - Wrap around images
  - Page types
  - Starting the Publisher via the Hotfolder
  - Lua-Filter / pre-processing
  - Schema validation
  - Quality assurance and PDF comparison
  - Troubleshooting / Debugging
  - Server mode (REST API)
  - Control of the layout when calling the Publisher
  - Create and use images with MetaPost
- Cookbook
  - Thumb index
  - Embed multipage PDF files
  - Layout optimization using groups
  - Imitate bulleted lists
  - Automatically generated directories
  - Create table of contents in one go
  - Page numbers: Page x of y
- Installation instructions
- File name in the Publisher
- speedata Publisher defaults
- Running the speedata publisher on the command line
- How to configure the speedata publisher
- Lenghts and units
- XPath- and Layoutfunctions
- Internal variables
- Associate XML editor with schema
  - Visual Studio Code
  - OxygenXML
  - Atom
- Changelog
- Glossary
- Compatibility with other software
- Command reference
  - A
  - Action
  - AddSearchpath
  - AtPageCreation
  - AtPageShipout
  - AttachFile
  - Attribute
  - B
  - Barcode
  - Bold
  - BoldItalic
  - Bookmark
  - Box
  - Br
  - Case
  - Circle
  - ClearPage
  - Color
  - Column
  - Columns
  - Compatibility
  - Contents
  - Copy-of
  - DefineColor
  - DefineColorprofile
  - DefineFontalias
  - DefineFontfamily
  - DefineGraphic
  - DefineMatter
  - DefineTextformat
  - Element
  - Fallback
  - Fontface
  - ForAll
  - Frame
  - Grid
  - Group
  - Groupcontents
  - HSpace
  - Hyphenation
  - I
  - Image
  - Include
  - Initial
  - InsertPages
  - Italic
  - Layout
  - Li
  - LoadDataset
  - LoadFontfile
  - Loop
  - Makeindex
  - Margin
  - Mark
  - Message
  - NewPage
  - NextFrame
  - NextRow
  - NoBreak
  - Ol
  - Options
  - Otherwise
  - Output
  - Overlay
  - Pageformat
  - Pagetype
  - Paragraph
  - PDFOptions
  - PlaceObject
  - Position
  - PositioningArea
  - PositioningFrame
  - ProcessNode
  - Record
  - Regular
  - Rule
  - SaveDataset
  - SavePages
  - SetGrid
  - SetVariable
  - SortSequence
  - Stylesheet
  - Span
  - Sub
  - Sup
  - Switch
  - Table
  - TableNewPage
  - Tablefoot
  - Tablehead
  - Tablerule
  - Td
  - Text
  - Textblock
  - Tr
  - Trace
  - Transformation
  - U
  - Ul
  - Until
  - URL
  - Value
  - VSpace
  - While

Version 4.8.0
Search manual

- Main page
- Introduction
- Hello, world!
- Basics
  - How to write the layout
  - Structure of the data file and the layout rules
  - Outputting objects
  - Grid
  - Areas on the page (PositioningArea)
  - File organization
  - Hyphenation / language settings
  - Using fonts
  - Text formats
  - Text formatting
  - Colors
- Programming
- Image inclusion
- Tables
- Advanced topics
  - Bookmarks
  - Creation of XML structures
  - Print output / crop marks
  - Using CSS with the speedata Publisher
  - Groups (virtual objects)
  - Virtual pages
  - Rotation of contents
  - Sorting data
  - Wrap around images
  - Page types
  - Starting the Publisher via the Hotfolder
  - Lua-Filter / pre-processing
  - Schema validation
  - Quality assurance and PDF comparison
  - Troubleshooting / Debugging
  - Server mode (REST API)
  - Control of the layout when calling the Publisher
  - Create and use images with MetaPost
- Cookbook
  - Thumb index
  - Embed multipage PDF files
  - Layout optimization using groups
  - Imitate bulleted lists
  - Automatically generated directories
  - Create table of contents in one go
  - Page numbers: Page x of y
- Installation instructions
- File name in the Publisher
- speedata Publisher defaults
- Running the speedata publisher on the command line
- How to configure the speedata publisher
- Lenghts and units
- XPath- and Layoutfunctions
- Internal variables
- Associate XML editor with schema
  - Visual Studio Code
  - OxygenXML
  - Atom
- Changelog
- Glossary
- Compatibility with other software
- Command reference
  - A
  - Action
  - AddSearchpath
  - AtPageCreation
  - AtPageShipout
  - AttachFile
  - Attribute
  - B
  - Barcode
  - Bold
  - BoldItalic
  - Bookmark
  - Box
  - Br
  - Case
  - Circle
  - ClearPage
  - Color
  - Column
  - Columns
  - Compatibility
  - Contents
  - Copy-of
  - DefineColor
  - DefineColorprofile
  - DefineFontalias
  - DefineFontfamily
  - DefineGraphic
  - DefineMatter
  - DefineTextformat
  - Element
  - Fallback
  - Fontface
  - ForAll
  - Frame
  - Grid
  - Group
  - Groupcontents
  - HSpace
  - Hyphenation
  - I
  - Image
  - Include
  - Initial
  - InsertPages
  - Italic
  - Layout
  - Li
  - LoadDataset
  - LoadFontfile
  - Loop
  - Makeindex
  - Margin
  - Mark
  - Message
  - NewPage
  - NextFrame
  - NextRow
  - NoBreak
  - Ol
  - Options
  - Otherwise
  - Output
  - Overlay
  - Pageformat
  - Pagetype
  - Paragraph
  - PDFOptions
  - PlaceObject
  - Position
  - PositioningArea
  - PositioningFrame
  - ProcessNode
  - Record
  - Regular
  - Rule
  - SaveDataset
  - SavePages
  - SetGrid
  - SetVariable
  - SortSequence
  - Stylesheet
  - Span
  - Sub
  - Sup
  - Switch
  - Table
  - TableNewPage
  - Tablefoot
  - Tablehead
  - Tablerule
  - Td
  - Text
  - Textblock
  - Tr
  - Trace
  - Transformation
  - U
  - Ul
  - Until
  - URL
  - Value
  - VSpace
  - While

- Dieses Handbuch auf Deutsch

# PlaceObject

Outputs a rectangular object (image, table, box, barcode or textblock).

## Child elements

`A`, `Barcode`, `Bookmark`, `Box`, `Circle`, `Frame`, `Image`, `Rule`, `Switch`, `Table`, `Textblock`, `Transformation`

## Parent elements

`AtPageCreation`, `AtPageShipout`, `Case`, `ForAll`, `Layout`, `Loop`, `SavePages`, `While`

## Attributes

`allocate` (optional)

  Determines if the area of the object is marked as »allocated«. With `allocate="no"`, the cursor position is not changed.

  `yes`

    Occupy space in the grid (default for grid positioning).

  `no`

    Don’t allocate space in the grid (default for absolute positioning).

`allocate-bottom` (number or length, optional, since version 2.9.6)

  Additional allocation area to the bottom.

`allocate-left` (number or length, optional, since version 2.9.6)

  Additional allocation area to the left.

`allocate-right` (number or length, optional, since version 2.9.6)

  Additional allocation area to the right.

`allocate-top` (number or length, optional, since version 2.9.6)

  Additional allocation area to the top.

`area` (text, optional)

  Name of the (positioning) area, the object is placed in. If no area is given, the object is placed on the main area, the page (this is the area that contains all grid cells).

`background` (optional)

  Fill the background of the object (full grid cells) with a color, given by backgroundcolor.

  `full`

    Fill background with the given color (in backgroundcolor).

  `without`

    Empty background

`backgroundcolor` (text, optional)

  Color of the background if ›background‹ is set to ›full‹.

`border-bottom-left-radius` (length, optional)

  Radius of corner bottom left.

`border-bottom-right-radius` (length, optional)

  Radius of corner bottom right.

`border-top-left-radius` (length, optional)

  Radius of corner top left.

`border-top-right-radius` (length, optional)

  Radius of corner top right.

`column` (number or length, optional)

  If contents is a number: the grid cell from the left margin of the area. If it is a length: the absolute position from the left paper margin. If this attribute is omitted, the system tries to place the object by itself.

`frame` (optional)

  Draw a frame around the object. You need to supply the frame color.

  `solid`

    Draw a frame around the object.

  `without`

    Don’t draw a frame around the object.

`framecolor` (text, optional)

  The color of the frame around the object. Only makes sense in combination with the attribute 'frame'.

`groupname` (text, optional)

  The name of the group that gets output. When given a groupname, PlaceObject should not contain any objects.

`halign` (optional, since version 2.3.55)

  When an object is placed on the grid and it’s width is not a multiple of grid width, there is a space left on the page between the object an the next grid cell. With this attribute you can instruct the software where to place the gap.

  `left`

    The object is aligned at the left.

  `center`

    The object is aligned so that the space to the left is the same as to the right.

  `right`

    The object is aligned to the right.

`hreference` (optional)

  Determines the placement of the object relative to the given column. If 'left' (which is the default), the given column is the left border of the object. If 'right', the column determines the right edge of the object.

  `left`

    The object is placed in given column.

  `center`

    The column determines the center of the object. Works only with absolute positioning.

  `right`

    The given columns determines the right edge of the border.

`keepposition` (optional)

  Don’t move the virtual cursor to the next free space

  `yes`

    Don’t move the virtual cursor.

  `no`

    Move the virtual cursor (default).

`maxheight` (number, optional)

  Only used for multi-page table: the maximum height of tables.

`origin-x` (optional)

  The origin for rotation.

  `left`

    The origin is at the left hand side.

  `center`

    The origin is in the center of the object.

  `right`

    The origin is at the right hand side.

`origin-y` (optional)

  The origin for rotation (on the vertical axis)

  `top`

    Rotation around a point at the top.

  `center`

    Rotate around the vertical center.

  `bottom`

    Rotate around a point at the bottom.

`page` (number, optional)

  The page (later in the PDF), the object should appear on. Number of the keyword »next« for the next page.

`rotate` (number, optional)

  Rotates the object. The amount of movement is defined by the specified angle; if positive, the movement will be clockwise, if negative, it will be counter-clockwise. When the angle is != 0 then grid allocation is turned off.

`row` (number or length, optional)

  The row where the object is placed. If none given, the publisher tries to find a row by itself. You can give a number (in grid cells) or an absolute value (from top left).

`rulewidth` (length, optional)

  The thickness of the frame that is drawn around the object. Only makes sense in combination with the attribute 'frame'.

`valign` (optional)

  When an object is placed on the grid and it’s height is not a multiple of grid height, there is a space left on the page between the object an the next grid cell. With this attribute you can instruct the software where to place the gap.

  `top`

    The object is aligned at the top.

  `middle`

    The object is aligned so that the space at the top is the same as at the bottom.

  `bottom`

    The object is aligned at the bottom.

`vreference` (optional)

  Sets the placement of the object relative to the given row.

  `bottom`

    The row determines the bottom edge of the object.

  `top`

    If 'top' (default), the given row is the top border of the object.

## Example

Positioning inside the grid:

    <Record element="image">
      <PlaceObject column="12" frame="solid" framecolor="red">
        <Image width="10" file="_samplea.pdf"/>
      </PlaceObject>
    </Record>

Absolute positioning (from top left edge):

    <Record element="image">
      <PlaceObject column="1cm" row="4cm" frame="solid" framecolor="red">
        <Image width="10" file="_samplea.pdf"/>
      </PlaceObject>
    </Record>

## Info

The objects can be placed in a grid (when the value in the attributes row and column are numbers) or they can be placed with absolute positions where the origin is at the top and left border of the page.

## See also

The detailed description in Outputting objects.

- PDFOptions
- Position