ENH: Return color/font/formatting information for outline/bookmarks

[mtd91429]

Currently, when applying bookmarks to a document through the PdfFileWriter class method addBookmark, one can specify the color, bold, and italic properties of the bookmark using code such as

title = 'a newly added bookmark that is red and bold'
pagenum = 2
# left , top, zoom parameters
fit = '/XYZ' 
fitArgs = [317, 507, 0]
# red, green, blue specified between 0-1
color = (1, 0, 0) #red
bold = True
italic = False

# parent, color, bold, italic, fit, fitArgs
args = [None, color, bold, italic, fit, *fitArgs]
pdf.addBookmark(title, pagenum, *args)

However, when retrieving the bookmarks via the PdfFileReader class method getOutlines the color, bold, and italic formatting information is not returned.

[mtd91429]

With pull request #514, the following code should work.

def detail_outlines(pdf):
    for line in pdf.getOutlines():
        if isinstance(line, list):
            yield extract_outlines(line)
        else:
            title = line.title
            page = line.page.pdf.getDestinationPageNumber(line)
            typ = line.typ
            color = rgb_to_hex([0, 0, 0])
            italic = 'notItalic'
            bold = 'notBold'
            if item.get('/C'):
                color = rgb_to_hex(item.get('/C'))
            if item.get('/F'):
                if item.get('/F') in [1,3]:
                    italic = 'italic'
                if item.get('/F') in [2,3]:
                    bold = 'bold'
            yield f'{title}, {pagenum}, {color}, {italic}, {bold}, {typ}'

def rgb_to_hex(rgb):
    red, green, blue = (int(x*255) for x in rgb)
    hex_string = f'#{red:02X}{green:02X}{blue:02X}'
    return hex_string

detail_outlines(pdf)
>>> 'a newly added bookmark that is red and bold, 2, #FF0000, notItalic, bold, /XYZ'