SaveAsOptionalContentConfigured method

Writes a strictly verified PDF copy whose selected optional-content configuration produces the requested native rendering state

The method stages the current document through PDFium, applies every requested object-number and visibility pair to the selected configuration, appends the smallest required object and cross-reference revision, then reopens the result through strict validation before copying it to the caller's destination

Configuration /ON and /OFF arrays are written for all groups, and existing OCG Usage dictionaries receive an explicit state for Options.Usage because native PDFium rendering gives those values precedence over the configuration arrays

TPdfOptionalContentConfigureOptions.Default selects configuration 0 and View usage, enforces radio groups and removes automatic-state rules which could override the requested result

• Unknown group object numbers, changes to locked groups and radio groups with more than one visible member are rejected before destination output
• Encrypted staged PDFs are rejected because plaintext incremental objects cannot preserve the active encryption handler
• Signed documents require AllowSignedDocument=True because changing visible content can invalidate signature coverage or policy
• The file overload writes a temporary file and atomically replaces the target only after strict verification succeeds

InspectOptionalContent, SaveAs, RenderPageByIndex