Skip to main content
K.Daube
Community Expert
Community Expert
April 3, 2023
Question

FDK documentation

  • April 3, 2023
  • 1 reply
  • 360 views

In the post FDK Question - Programmatic Alt Image Text Description Insertion a property of Anchored Frames is mentioned. However, I do not find any documentation about this.

Question from an uninformed person:

FP_ObjectAttributes is listed in the constants (fapidefs.h FDK header file) - but it is not mentioned at all in the FDK Programmers Reference (FM-15, 16, 17).

In FM  help / UG only the Alternate and Actual texts are mentioned - and no explanation, what's the difference of these two is. No hint, what the items in the Object Attributes dialogue for "New or changed Attribute" are good for.

► Can somebody explain me the difference betwen Alternate and Actual text?

► Can somebody explain me    the purpose of the second halve of the dialogue ("New or changed Attribute")?

This topic has been closed for replies.

1 reply

frameexpert
Community Expert
Community Expert
April 3, 2023

Hi Klause, My guess is that some of these may carry through to output formats such as HTML, etc. One suggestion might be to set some of these values in a sample document, then produce various outputs and see if the values land somewhere that may reveal their intended use. -Rick

K.Daube
Community Expert
K.DaubeCommunity ExpertAuthor
Community Expert
April 3, 2023

Thank you for your answer, Rick - i did this test:

Alternate: In tagged PDF text ends up as 'tool tip' for the included graphic. In HTML (both standard or responsive) it becomes part of the frame div:

<div align="left"><img alt="Alternate: Empty Frame Test" id="image1" src="assets/debug-helper-cb.png" />
</div>

Actual: does not show up in tagged PDF or any HTML.

The other attributes (given by Name and Definition) do not show up anywhere in these tests - maybe used only in connection with Structured FM.

Bob_Niland
Community Expert
Community Expert
April 3, 2023

re: Alternate: In tagged PDF text ends up as 'tool tip' for the included graphic.

That's a bit odd, but encouraging, as this is the first report I've seen of anything in FM presenting as an arbitrary authored PDF tooltip.

re: … img alt="Alternate: Empty Frame Test"…
And odd, because per the W3C, alt= is intended for: “The alt attribute provides alternative information for an image if a user for some reason cannot view it (because of slow connection, an error in the src attribute, or if the user uses a screen reader).

For deliberate/helpful tooltips in PDF & HTML, the attribute desired would be title=, available even if the image is present.

It wouldn't surprise me if being able to set tooltips is necessary feature for PDF/A-1b & PDF/A-2b annotations.