[PDFBOX-4496] OCG enablement with string parameter is not well defined

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0.14
• Fix Version/s: 2.0.15, 3.0.0 PDFBox
• Component/s: PDModel
• Labels: OCGs
• Assignee: Tilman Hausherr
• Reporter: Stefan Ziel
• Created: 26/Mar/19 15:36
• Updated: 12/Apr/19 14:39
• Resolved: 29/Mar/19 19:54

Description

The class

 org.apache.pdfbox.pdmodel.graphics.optionalcontent.PDOptionalContentProperties

contains two methods

 setGroupEnabled(String, boolean)

and

 isGroupEnabled(String)

accessing the OCG's state using a name as parameter.
As there can exist various OCG with the same name this access is not well defined.
The current implementation accesses the first group with this name it can find.

To make the setter work a solution would be a loop over all groups with the given name and add them to ON or OFF. Consider to rename it to

setGroupsEnabledByName

The getter should return some error state if the groups diverge in state - or better drop it ...