idml 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb1bde51604723b865996a34842c6a5216b3c0ce4f55947902aa9dd92358ed25
-  data.tar.gz: a1e6ed580c3d0fee769287d3619c33fa6e18ed79ee332d1aa0a7976b1352b760
+  metadata.gz: b5306c44be037a52666aa508b9cdb76978561403d72bc43896ea8575b3f61340
+  data.tar.gz: 1d46f1c6de5f53f564f69ccfc41349d48d12b5f3522b7dfae1d01dc79f92ae00
 SHA512:
-  metadata.gz: 989af27c2ad974dac8d370e335e923b70727a0c32991fe67011c2231cd5b526fdf59e73d571df8423ae69e9e27a5fa03dd69cf94a732ec76138cb34188af0792
-  data.tar.gz: d3daaccd0d51e4a78b825f5ea2f7baf6a3c23c11df1c33eb793b649c23b18bac2255de8e3fc3e3e7d62addac871b77f20879931dac73d6f14fec6fe54c10caea
+  metadata.gz: 4d6830d86be109139a52ee6c2d780f31c33488eee4090b6a64ca938c871fd78429d9da7dbd9b7911d2a814e6908c1a05d53b6083abbb6b74c9d04fec141fcf18
+  data.tar.gz: '0886ff7d2aea4389f5bd0779151be35e6dd40473c2bec635ca4ff25f10321b196c09b171d104f405c4133ab699cfc008773a11533ad43fd870e755cd29b2e168'

data/TODO.pdf/118-table-band-fills.md

@@ -0,0 +1,33 @@
+# TODO PDF 118: Table alternating row/column band fills
+
+## Status: COMPLETE — implemented 2026-08-18
+
+## Problem
+
+IDML tables declare table-level alternating fills —
+StartRowFillColor/Count + EndRowFillColor/Count (row banding),
+StartColumnFillColor/Count + EndColumnFillColor/Count (column
+banding), ColumnFillsPriority (true = column banding wins),
+SkipFirst/LastAlternatingFillRows/Columns (edge suppression), and
+per-band tints. All attributes are modeled (TODO 104) but the
+renderer only honored per-Cell FillColor, so banded tables (zebra
+stripes, ledger shading) rendered without their backgrounds.
+
+## What was done
+
+- `SchemaLayout#band_fill(col, row)` computes the effective band
+  color + tint for a cell position: row banding by default; column
+  banding when ColumnFillsPriority is true or row banding is
+  unconfigured; SkipFirst/Last offsets suppress banding at the
+  table edges; "Color/None" band colors render nothing.
+- `TableRenderer` paints the band rect behind each cell BEFORE the
+  cell's own background — an explicit Cell FillColor overrides the
+  band, matching InDesign.
+- `each_cell` now also yields the cell's column/row indices.
+
+## Acceptance criteria
+
+- [x] Rows alternate Start/End colors in the declared counts.
+- [x] Cell-level fill overrides the band.
+- [x] Column banding wins when ColumnFillsPriority is true.
+- [x] SkipFirstAlternatingFillRows suppresses leading bands.

data/lib/idml/render/renderers/table_renderer.rb

@@ -70,7 +70,10 @@ module Idml
         # derived from `column_count` attribute or max col + 1.
         def self.render_schema_faithful(canvas, table, box, context)
           layout = SchemaLayout.new(table: table, box: box)
-          layout.each_cell do |cell_x, cell_y, cell_w, cell_h, cell|
+          layout.each_cell do |cell_x, cell_y, cell_w, cell_h, cell,
+                               col_idx, row_idx|
+            render_band_background(canvas, cell, layout, col_idx, row_idx,
+                                   cell_x, cell_y, cell_w, cell_h, context)
             render_cell_background(canvas, cell, cell_x, cell_y, cell_w, cell_h,
                                    context)
             render_cell_border(canvas, cell_x, cell_y, cell_w, cell_h)
@@ -79,6 +82,27 @@ module Idml
         end
         private_class_method :render_schema_faithful
 
+        # Table-level alternating band fill behind a cell. An
+        # explicit Cell FillColor wins; Color/None bands and zero
+        # tints render nothing.
+        def self.render_band_background(canvas, cell, layout, col_idx,
+                                        row_idx, x, y, w, h, context)
+          return if cell_fill_color(cell, context)
+
+          name, tint = layout.band_fill(col_idx, row_idx)
+          return unless name
+          return if name == "Color/None"
+
+          color = context.color_resolver&.resolve(name)
+          return unless color
+
+          color = ColorHelper.apply_tint(color, tint)
+          canvas.fill_color(ColorHelper.to_canvas(color))
+          canvas.rectangle(x, y, w, h)
+          canvas.fill
+        end
+        private_class_method :render_band_background
+
         def self.render_cell_background(canvas, cell, x, y, w, h, context)
           color = cell_fill_color(cell, context)
           return unless color
@@ -244,7 +268,7 @@ module Idml
 
                 yield cell_x(col_idx), cell_y(row_idx, col_span, row_span),
                       cell_w(col_idx, col_span), cell_h(row_idx, row_span),
-                      cell
+                      cell, col_idx, row_idx
               end
             end
           end
@@ -269,6 +293,79 @@ module Idml
             table.row
           end
 
+          # Table-level alternating band fill for a cell position:
+          # [color_name, tint] or nil. Row banding by default; column
+          # banding when ColumnFillsPriority is true or rows are
+          # unconfigured.
+          def band_fill(col, row)
+            column_band = column_band_fill(col)
+            return column_band if column_band &&
+              (table.column_fills_priority || row_band_fill(row).nil?)
+
+            row_band_fill(row)
+          end
+
+          def row_band_fill(row)
+            band_pair(table.start_row_fill_color, table.start_row_fill_count,
+                      table.end_row_fill_color, table.end_row_fill_count,
+                      table.start_row_fill_tint, table.end_row_fill_tint,
+                      row, row_count,
+                      table.skip_first_alternating_fill_rows,
+                      table.skip_last_alternating_fill_rows)
+          end
+          private :row_band_fill
+
+          def column_band_fill(col)
+            band_pair(table.start_column_fill_color,
+                      table.start_column_fill_count,
+                      table.end_column_fill_color,
+                      table.end_column_fill_count,
+                      table.start_column_fill_tint,
+                      table.end_column_fill_tint,
+                      col, col_count,
+                      table.skip_first_alternating_fill_columns,
+                      table.skip_last_alternating_fill_columns)
+          end
+          private :column_band_fill
+
+          # Alternating band for one axis: the first `start_count`
+          # positions take the start color, the next `end_count` the
+          # end color, repeating from after the skipped edge rows.
+          # Zero-count cycles band nothing.
+          def band_pair(start_color, start_count, end_color, end_count,
+                        start_tint, end_tint, index, total,
+                        skip_first, skip_last)
+            return nil unless start_color
+            return nil if suppressed?(index, total, skip_first, skip_last)
+
+            cycle = band_cycle(start_count, end_count)
+            return nil unless cycle.positive?
+
+            if in_start_band?(index, skip_first, cycle, start_count)
+              [start_color, start_tint]
+            else
+              [end_color, end_tint]
+            end
+          end
+          private :band_pair
+
+          def band_cycle(start_count, end_count)
+            (start_count || 1) + (end_count || 1)
+          end
+          private :band_cycle
+
+          def in_start_band?(index, skip_first, cycle, start_count)
+            ((index - (skip_first || 0)) % cycle) < (start_count || 1)
+          end
+          private :in_start_band?
+
+          # Banding suppressed at the leading/trailing edges.
+          def suppressed?(index, total, skip_first, skip_last)
+            index < (skip_first || 0) ||
+              index >= total - (skip_last || 0)
+          end
+          private :suppressed?
+
           def cells
             table.cell
           end

data/lib/idml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Idml
-  VERSION = "0.9.2"
+  VERSION = "0.9.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.3
 platform: ruby
 authors:
 - Ribose
@@ -175,6 +175,7 @@ files:
 - TODO.pdf/116-applied-style-resolution.md
 - TODO.pdf/116-justification-last-line.md
 - TODO.pdf/117-endnote-support.md
+- TODO.pdf/118-table-band-fills.md
 - TODO.pdf/12-idml-to-pdf-pipeline.md
 - TODO.pdf/13-cjk-text-layout.md
 - TODO.pdf/14-page-item-element-models.md