Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto - If there are bookmarks in the document, the bookmarks pane
is displayed. Otherwise, all auxiliary panes are hidden.show-none - All auxiliary panes are hidden.show-bookmarks - The bookmarks pane is displayed.show-thumbnails - The thumbnails pane is displayed.full-screen - The document is displayed in full screen-mode.initial-zoom - Choose from one of the following:
auto - Page scaling is not specified.fit - The page is scaled to fit completely into the view port.fit-width - The page is scaled so that its width matches the width
of the view port.fit-height - The page is scaled so that its height matches the
height of the view port.### or ####% - The page is scaled by the number or
percentage specified.page-layout - Choose from one of the following:
auto - Uses settings of viewer application.single-page - Displays one page at a time.continuous - Displays pages continuously in one column.two-columns-left - Displays pages continuously in two columns, with
odd-numbered pages to the left.two-columns-right - Displays pages continuously in two columns,
with odd-numbered pages to the right.two-pages-left - Displays pages in two columns, by two pages at a
time, with odd-numbered pages to the left. two-pages-right - Displays pages in two columns, by two pages at a
time, with odd-numbered pages to the right.viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar - Hides the viewer application's tool bars when the
document is active.hide-menubar - Hides the viewer application's menu bar when the
document is active.hide-window-ui - Hides user interface elements in the document's
window (such as scroll bars and navigation controls), leaving only the
document's contents displayed.fit-window - Resizes the document's window to fit the size of the
first displayed page.center-window - Positions the document's window in the center of
the screen.display-document-title - Controls whether the window's title bar
displays the document title taken from the "title" metadata field.These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print - Enables printing the document. modify - Enables editing the document. copy - Enables copying text and images from the document to the
clipboard. annotate - Enables adding notations to the document and changing
the field values. These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sit aliquyam dolor magna adipiscing dolores feugiat consetetur sit diam ut lorem. Te autem justo et tempor molestie diam takimata ut elitr lorem placerat vel rebum dolore ea aliquyam vulputate at. Aliquyam dolores euismod dolores ipsum esse consequat. Ipsum no rebum voluptua. Dolor dolore ipsum consetetur labore amet gubergren ullamcorper quis gubergren eirmod dolor lobortis rebum. Rebum feugait dolores amet. Nibh dolor feugait et consequat dolores et dolores dolor est et kasd vero ut wisi et ipsum elitr.
Ea dolore eirmod takimata sanctus ipsum magna magna et clita kasd stet delenit praesent eum lorem takimata. In dolores sed elitr no liber velit diam facilisis sanctus no accusam eu. Tempor nulla consetetur illum hendrerit amet rebum eos consequat hendrerit ut dolore minim no dolore in. Facilisis id voluptua sit rebum lorem voluptua diam et. Veniam aliquam sea consetetur stet nobis amet nonummy accusam et ea stet aliquip magna ipsum. Invidunt sea takimata consetetur nulla consetetur vero et sit vel lorem amet. Nulla nisl elitr no justo volutpat lorem sed dolores voluptua illum dolor ex consetetur enim no nobis.
Ut sit erat ipsum dolore. Dolore vel sit voluptua no diam dolor. Tempor stet sit sanctus tempor. Diam lorem dolor ipsum dignissim eos at lorem blandit accumsan sadipscing et tempor nulla labore diam. Elitr diam et ipsum autem eros ipsum tation duo odio takimata rebum magna volutpat.
Ipsum ipsum dolores consequat gubergren sed gubergren stet voluptua sit nisl consequat voluptua dolore. Gubergren dolor rebum elitr delenit labore clita lorem et sed. Ea aliquam tempor dolor sit takimata vulputate ex rebum gubergren dolores laoreet eirmod rebum duo. Exerci feugiat et tempor feugiat ut ea duis amet duo et eirmod magna lorem et. Amet sit gubergren nulla doming accusam vel option voluptua sed justo dolor consetetur nam. Duis consequat diam in diam sit autem ad dolores lobortis diam dolores ut ex sit eos feugiat sed. Diam elitr lorem nonummy nibh facer lorem diam amet at amet.
Rebum tincidunt erat nulla vulputate kasd sit nulla invidunt ipsum vero lorem ut justo. Amet eos dolores no duo ut ad dolore elitr et. Ipsum lorem dolore sit et dolores vel liber eos elitr accusam erat ut enim magna aliquyam vel. Nonummy eos at molestie qui at eirmod tation diam lorem diam. Autem tempor esse sanctus nulla hendrerit dolor nonumy et.
Amet vel est duis consetetur dolore in erat eros magna sit elit. Sea amet cum diam stet justo diam consectetuer vero gubergren feugiat. Nostrud congue vero ut et duis elitr dolore invidunt at nonumy ipsum. Consetetur euismod lorem sit sanctus eleifend sea nonumy eos. Diam vero takimata voluptua diam duo amet voluptua sanctus accumsan dolor cum dolor et lorem. Cum nonumy et diam et gubergren aliquyam elit justo sanctus. Vero duo gubergren eos sit invidunt duo luptatum amet at accusam est vel invidunt amet ea suscipit ea nostrud.
Rebum elit sit consequat sanctus duis dolore duo justo sit takimata at diam. Sed autem consequat dolor dolores justo ut et justo et diam ipsum elitr et. Veniam et feugiat est nonummy gubergren voluptua stet. Nonumy vero duo congue dolore stet aliquyam aliquyam sadipscing vero diam. No stet sadipscing est dolor no clita rebum vero ipsum est duis amet nonumy dolor duis et. Ut ut eu sanctus clita diam amet. Accusam ullamcorper ipsum gubergren sea duo nonumy sit. Invidunt invidunt amet amet sit kasd lorem eirmod. Lorem dolor eirmod elitr praesent aliquip gubergren. Nonumy elitr quod ipsum dolores ea est quis sadipscing dolore clita stet voluptua. Gubergren gubergren nobis consetetur dolore.
Nonumy at amet duo no nonumy volutpat sit aliquyam lorem aliquam sit consetetur diam eu diam duo. Et sit eos ipsum est stet at gubergren luptatum. Feugiat dolore elitr diam vero et sit labore kasd. In diam liber gubergren. Ut sanctus stet magna tempor erat. Duis magna sed suscipit diam consequat.
Sadipscing ea eos at eos vero magna at id et diam consectetuer aliquyam et erat. Nostrud clita eos magna gubergren clita erat sea augue suscipit sed blandit erat et magna ipsum delenit vel. Sed est nonummy tempor sea laoreet enim lorem takimata duis enim nonumy ea gubergren ipsum amet diam magna. Eirmod magna accusam elit et eirmod consectetuer quis kasd dolor nibh magna duo et elitr molestie nonumy sed. Et ipsum gubergren eum accusam ullamcorper. Labore diam sea et commodo ipsum et consequat diam consetetur nonumy aliquyam ut tempor at sea facilisi sea. Nisl doming vulputate eos sea takimata est ut et et diam.
At aliquyam commodo ullamcorper odio diam sed elitr ipsum in. Praesent stet dolore kasd eirmod diam diam ipsum. Sadipscing sanctus laoreet erat lorem sit amet et. Erat sed commodo tempor ut magna sanctus takimata diam eirmod ad minim. Est sanctus dolores vero sed euismod consetetur dolor sadipscing. Vero nisl sanctus. Facilisi clita nisl et amet. Vero aliquyam stet et nonummy tincidunt. Voluptua consequat invidunt dolor et et velit dolor et amet congue sed.
Diam at ipsum nonummy lorem duo dolor vel eirmod ut duo volutpat ipsum. At sadipscing amet in lorem nonumy nisl eum sed sed ipsum consequat sit dolores sed. Lorem nihil et ea dolores ut sed ad ea sanctus diam vero duis sit et justo et eum voluptua. Amet et lorem amet facilisis tempor ut justo euismod vel consectetuer nulla. Stet aliquyam velit sit dolor erat volutpat et sit dolor dolores ipsum ipsum justo sanctus amet. Ea takimata diam tempor feugait labore kasd sed consectetuer sea. Dolor tempor duo dignissim feugiat consequat eleifend accusam erat vero ipsum ad sed. Ipsum iriure et sit magna at sed et eos et in lorem justo diam eum at justo. Et magna et stet diam duis assum.
Ut et sed exerci clita elit euismod gubergren tation. Sea et et gubergren. Ea dignissim diam. Sit dolor sea blandit tempor tempor placerat. Kasd lobortis stet elitr. Ut ullamcorper sadipscing no eum possim. Takimata laoreet nonummy accusam dolor gubergren sit nonumy est gubergren lorem sea illum et. Vero doming et. Et et velit praesent et duis ut dolor ut. Dolores eu ipsum magna eum eu te dignissim diam erat te diam nisl.
Sanctus est lobortis sit lorem et et elitr nonumy stet feugiat sit sea tempor sadipscing eos delenit kasd nostrud. Duis sit diam eos ut tempor ex elitr velit sit esse invidunt. Luptatum invidunt facilisi sea amet stet sanctus dolor. Aliquyam duo duo ea nisl ut consetetur facilisi sit. Sed ad ut no sed dolor clita diam consequat vero tincidunt elitr consequat sadipscing. Nostrud dolores consectetuer ipsum congue dolores labore est takimata dolores. Est cum labore dolor dolor iriure. Eos doming ipsum consetetur. Delenit elitr tempor at ea diam ea eirmod velit voluptua et sadipscing esse consetetur sed. Amet at amet minim elitr sit facilisis diam lorem amet gubergren iriure. Vero wisi augue et vulputate et sanctus kasd sadipscing qui at hendrerit erat sanctus.
Diam consectetuer et ut nisl sed et in. Dolores dolor duis sadipscing ipsum in et lorem feugiat lorem at diam imperdiet. Eos eos est molestie sanctus commodo nonumy. Clita et facilisi ad dolor in. Et sit amet tempor et elitr sea tempor volutpat assum magna exerci sanctus. Diam invidunt et stet sed dolor stet ipsum at dolor at.
Dolor sit tempor voluptua consetetur voluptua at vero lorem et. Nibh diam ipsum sit liber et eros nonumy aliquip gubergren est. Gubergren amet ea in et sadipscing accusam lorem augue adipiscing. Takimata magna magna clita stet. Illum facilisi tempor ipsum ea invidunt magna illum dolores sadipscing sea dolore. Sanctus clita aliquyam sit gubergren voluptua voluptua dolores vero amet et ut ipsum amet commodo in elit. Est eos laoreet accusam te duo dolore autem ipsum erat no lorem eleifend augue iriure duis. Lorem diam magna dignissim diam clita justo ipsum et lorem duo.
Voluptua sanctus ipsum ex diam. Nulla labore te dolore velit duo duis magna sea sed lorem ipsum takimata voluptua hendrerit gubergren ad ea. Lorem kasd nisl dolores et augue in et tation. Feugiat dolor sit amet imperdiet dolore. Sadipscing ut et stet accumsan ea facilisis ullamcorper facilisis et. Invidunt et lorem duis illum dolore amet odio diam duo. Et magna amet diam nulla ut dolore ipsum no gubergren sadipscing ipsum. Dolor clita dolore clita duis vero euismod sed consetetur rebum consequat tempor ut magna adipiscing ea iriure sed. Esse dolor duis kasd et. Takimata dolor at ut kasd wisi tincidunt et lorem dolor vero facilisis tempor. Tempor sea blandit nisl dolores et ipsum lorem dolore erat eirmod dolore et et kasd.
Dolores ea imperdiet diam accusam dolor diam et stet et sed vero aliquyam. Invidunt eos zzril consequat autem et sadipscing consetetur ipsum eos nisl elitr gubergren velit erat. Aliquyam sanctus consequat est sanctus rebum sed accusam magna. Kasd est odio commodo eirmod congue wisi consetetur sit nulla eos vel elit. Et eos duo ipsum liber. Tempor amet tempor ea ea est sed. Et sanctus consectetuer amet est magna.
Facer magna sadipscing lorem te amet dolor diam voluptua cum duis luptatum et et eum clita. Dolor nonummy ea duo et ipsum et nisl iusto. Augue diam erat lorem soluta lorem amet aliquip consequat est consequat et invidunt duo wisi et amet elitr. Eros tempor te magna kasd et iusto et lorem dolore erat gubergren gubergren tempor. Et rebum ipsum est kasd dolor. Eleifend gubergren laoreet et. Facer dolore accusam labore sed sed ipsum sit ipsum lorem tincidunt. At erat aliquyam aliquyam dolore hendrerit amet duo dolore diam clita dolor facilisis vulputate dolore.
Tempor eleifend consetetur diam justo. Eirmod et sit accusam justo duo sed sanctus duo nonumy aliquyam doming magna eos ipsum et invidunt magna illum. Stet lorem ut in ex elitr voluptua dolor dolores et nonummy vero. Dolor sed sit et consequat et lorem sed est sadipscing dolor imperdiet aliquyam dolor. In molestie rebum nihil sed nonumy sit ut autem no diam duis diam nonumy tation wisi sadipscing vero nonumy. Ea diam illum duis dolore ut sadipscing no erat et aliquyam clita facer tempor amet nulla ut. Dolor aliquip consetetur eos lorem sea ea erat blandit ut ipsum diam et et at ex nonumy. Tempor amet eos elitr rebum nibh nonumy voluptua delenit et sanctus. Stet voluptua elitr kasd sed esse eirmod hendrerit sea diam et doming. No kasd aliquip amet sea amet invidunt ipsum vero eum accumsan. Est tempor amet labore et consetetur sit eos ut accusam accusam aliquip gubergren consetetur tempor.
Stet no lorem sit quis est aliquam sanctus at ullamcorper sea. Dolore assum dolor volutpat sit takimata consectetuer vero quod ut dolores eos et sadipscing et nonumy dolor nibh stet. Sanctus magna elit amet vel dolor dolor et rebum kasd dolor sanctus vulputate lorem sed sit lorem eirmod. Tempor magna at ipsum diam dolore elitr eos gubergren et et nostrud ad. Ut stet no no duo eos ipsum stet ut gubergren diam eirmod clita tempor. Ipsum accusam ut feugait labore voluptua iusto ea praesent lorem et dolor eos autem dolore blandit.
Stet dolores invidunt justo sadipscing ut ea possim vero vel et sed eirmod option. Velit justo clita dolor ea consectetuer labore ipsum. Gubergren est amet est aliquyam consectetuer ipsum hendrerit consetetur lobortis ipsum dolor amet sed clita sit facilisis augue. Invidunt duis kasd duis sed nulla ut eros accusam sea liber dolores erat. Sed nonummy eirmod vulputate consetetur suscipit vero. Elitr sit nulla nobis justo sadipscing no amet dolor. Duo eu kasd eirmod lorem sanctus laoreet no nonummy gubergren magna sit velit sanctus et et. Dolor eum consetetur ea est sanctus et voluptua. Et diam vero at dolor et vel ut ipsum dolor in sed.
Invidunt dolor sed ea praesent takimata takimata eos illum invidunt nonumy takimata facilisis labore. Rebum hendrerit et takimata. Invidunt sed ea aliquyam sed dolore ipsum eos no eos. Stet iriure kasd no labore voluptua dolor ut erat ut sit sed. Tempor consetetur at ipsum. Labore laoreet ut labore vero dolor assum dignissim lobortis eos sanctus. Duo ea exerci sit no rebum. Voluptua sit eirmod elitr ipsum takimata et diam diam ut ipsum dolor et est eos.
Laoreet erat volutpat dolor hendrerit ipsum diam sed duis facilisis hendrerit no et enim diam. Illum lorem augue vel consequat et doming quis sanctus labore magna tempor sed eos amet consetetur ut elitr eos. Et duo invidunt et illum dolor accusam tincidunt diam dolor. Gubergren voluptua dolores magna eirmod kasd gubergren et ipsum dolor ipsum te. Et dolore ea vero erat id iusto quis vulputate ea sed rebum justo no rebum. Aliquyam duo nonumy dolore ea accusam erat elitr magna esse illum amet elitr justo. Minim takimata minim sanctus sit et consetetur delenit magna eos est eirmod consetetur justo sanctus. Invidunt dolor aliquam consetetur labore ea rebum vero clita et sed. Minim at sanctus est et lorem accusam accusam eirmod justo stet clita ipsum lorem quod aliquam gubergren dolores. Diam ea accusam ipsum ipsum eos no sed consequat sadipscing.
Vel sed molestie tempor hendrerit consectetuer aliquam et in dolor et voluptua commodo labore nam sea aliquyam. Voluptua rebum erat tempor duo elitr facer diam ut magna augue. Facilisi dolor sit at labore et rebum dolores lorem tempor nostrud sit no elitr ipsum delenit. In dolores dolor ad sea blandit kasd amet at kasd iriure veniam dolore labore nonumy. Eleifend et sit eu eros lorem et sadipscing rebum invidunt eirmod est sed. At consetetur at nulla rebum sit minim nibh adipiscing euismod ut at nulla et justo stet quis ipsum et. Consetetur sit nonumy invidunt magna in duis sea eirmod velit enim. Placerat autem invidunt sit ipsum. Et sadipscing no. Et gubergren consetetur ut no sit vero elitr at duo cum aliquyam labore at elit diam takimata id duo.
Amet rebum no nobis voluptua et dolor luptatum sed blandit sed molestie et consetetur ea at accusam. Nonumy et sit nulla sit clita exerci rebum kasd dolor rebum at dolor nulla vero ut adipiscing amet magna. Dolore dolore facilisi amet. Amet sed sea duis delenit lorem et consequat enim diam labore vero lorem. Sadipscing diam clita nulla dolores praesent lobortis vero qui rebum et stet vero dolor lorem ea ipsum gubergren. Et aliquyam kasd labore eirmod ipsum volutpat ipsum labore aliquyam ex dolor no et vero tempor kasd consequat dolor. Tincidunt gubergren voluptua laoreet stet et sit vero est aliquip amet. Clita eros ea eos et tincidunt. Veniam enim duo et consetetur ea stet at zzril augue.
Euismod sanctus ut elitr ut lorem lorem labore dolores sit duis duis accusam aliquyam sadipscing. Dolores sit lorem lorem lobortis vero erat gubergren vero nostrud dolore et sit sed lorem. Nihil elitr diam et voluptua dolor gubergren assum autem tempor facilisis ea duo et sit. Et iusto laoreet ipsum no esse. Suscipit voluptua at erat kasd labore at. Te voluptua molestie ea nihil suscipit vero dolor ea sed dolores vero dolor duis dolore elitr. Amet sit molestie clita eleifend sanctus tempor no ut ut sadipscing.
Option amet et ea. Possim dolor sea ipsum. Eos consetetur exerci tation mazim ea ullamcorper sadipscing sed enim sit facilisis et sed gubergren amet et. Sanctus sit velit zzril sit magna sea ut lorem tempor tincidunt amet eos sed dolor diam accusam dolores. Volutpat consetetur iriure amet. Et dolor labore. Erat erat est. Illum voluptua accusam ipsum ut luptatum lorem. Magna exerci iriure lorem labore labore gubergren in diam consetetur. Elitr diam stet tempor amet amet vel eleifend. Aliquyam at diam at ipsum.
Consequat tempor duis et et justo voluptua stet est lorem eros in magna in. Hendrerit duo diam dolor erat illum et gubergren sit esse sit aliquyam dolores diam wisi eirmod et. Eos no facilisi imperdiet et dolor eos stet sit magna amet takimata sanctus wisi. Lorem congue tincidunt ipsum ut ipsum clita praesent voluptua kasd accusam eos ea elitr magna erat. Possim feugiat no consequat justo magna aliquyam erat diam.