Method finalize

pdf2docx/table/Border.py:243–293

Finalize the position of all borders. Args: strokes (Shapes): A group of explicit border strokes. fills (Shapes): A group of explicit cell shadings. .. note:: A border is finalized in priority below: * Follow expl

(self, strokes:Shapes, fills:Shapes)

    '''Collection of ``Border`` instances.'''

    def finalize(self, strokes:Shapes, fills:Shapes):
        '''Finalize the position of all borders.
        
        Args:
            strokes (Shapes): A group of explicit border strokes.
            fills (Shapes): A group of explicit cell shadings.

        .. note::
            A border is finalized in priority below:
            
            * Follow explicit stroke/border.
            * Follow explicit fill/shading.
            * Align h-borders or v-borders as more as possible to simplify the table structure.            
        '''
        # add dummy borders to be finalized by explicit strokes/fillings
        self._add_full_dummy_borders()

        # finalize borders by explicit strokes in first priority
        self._finalize_by_strokes(strokes)

        # finalize borders by explicit fillings in second priority
        tmp_strokes = []
        for fill in fills:
            # ignore determined filling or filling in white bg-color
            if fill.is_determined or fill.color == rgb_value((1,1,1)): continue

            x0, y0, x1, y1 = fill.bbox
            tmp_strokes.extend([
                Stroke().update_bbox((x0, y0, x1, y0)), # top
                Stroke().update_bbox((x0, y1, x1, y1)), # bottom
                Stroke().update_bbox((x0, y0, x0, y1)), # left
                Stroke().update_bbox((x1, y0, x1, y1))  # right
            ])
        self._finalize_by_strokes(tmp_strokes)

        # finalize borders by their layout finally (use an average position):
        # - un-finalized, and
        # - not reference-only borders        
        borders = list(filter(lambda border: not (border.finalized or border.is_reference), self._instances))

        # h-borders
        # NOTE: exclude the top and bottom boundary borders, since they'll be adjusted by
        # principle that minimizing the table region.
        h_borders = list(filter(
            lambda border: border.is_horizontal and 
                    not (border.is_top or border.is_bottom), borders))
        self._finalize_by_layout(h_borders)

        # v-borders
        v_borders = list(filter(lambda border: border.is_vertical, borders))
        self._finalize_by_layout(v_borders)

    
    def _finalize_by_strokes(self, strokes:list):