Options and output not all picked up.

[dvodvo]

[Sorry for the length, but one successful method execution leads to many issues]

The following method:

   respond_to do |format|
      format.html

      format.pdf do
                 puts roll_width.to_s + ' roll_width'   # renders as:  '80 roll_width'
          pdf_paper_width = mm_to_in( roll_width )
                 puts @height_inches_final.to_s + ' @height_inches_final' # renders as '7.9 @height_inches_final'
          # filename = "#{@txdoc.created_at.to_i}.pdf"
          render ferrum_pdf: {
            url: ops_print_test_url, # Provide a URL to the content
            # html: content, # or provide HTML
            base_url: request.base_url, # Preprocesses `html` to convert relative paths and protocols. Example: "https://example.org"
            wait_for_idle_options: { connections: 0, duration: 0.05, timeout: 5 }, # Used for setting network wait_for_idle options
            authorize: { user: current_user.email, password: current_user.password }, # Used for authenticating with basic auth
            pdf_options: {
              
              # browser: chrome_browser,
              landscape: false, # paper orientation
              scale: 1, # Scale of the webpage rendering
              format: nil,
              paper_width: pdf_paper_width, # 8.5 Paper width in inches
              paper_height: @height_inches_final, # 11 Paper height in inches
              page_ranges: nil, # Paper ranges to print "1-5, 8 11-13"
          
              # Margins (in inches, defaults to 1cm)
              margin_top: 0.4,
              margin_bottom: 0.4,
              margin_left: 0,
              margin_right: 0,
              display_header_footer: false,
              print_background: false, # Print background graphics
              header_template: "", # HTML template for the header
              footer_template: "", # HTML template for the footer
            },
            disposition: :inline,
            filename: "#{@txdoc.created_at.to_i}.pdf"
          }
          FerrumPdf.browser = nil
      end
    end

is yielding many unexpected results and a few additional queries that the ReadMe does not appear to cover.

1 - the output document has a resolution of 612x792, which is at 96 dpi 8.5 x 11 in . It appears width and length are set to default values, irrespective of pdf_options.
.. 1b - I have no idea if this has to do with format: nil, instruction, nor what format

2 - filename remains unaltered as the action_name (which I assume is a consequence of being in a respond_to do |format| block. However...

3 - ferrum provides a way to save the PDF :save_path . However, changing to :disposition: :attachment, does not change the process.
.. 3b - ammending the render block

            base_url: request.base_url, # Preprocesses `html` to convert relative paths and protocols. Example: "https://example.org"
            save_path: "/public/docs/#{@shop.id}/",

also has no effect on the process (pdf filename == action_name, saved in downloads folder)

  rendering and saving with defined path and filname is a must.  Is this possible with ferrum_pdf? If so, how?

4 - The file renders, apparently with Chrome, but without any apparent hooks. My .zshrc file is below. Uncommenting the config.headless = false line in the ferrum_pdf.rb initializer does in practice launch the Chrome browser (reluctantly installed in Apple's desired Applications directory (I prefer a different filing structure). Thus, somehow a gem is picking up system default values and running with it.

5 - If a change is made to the method, or an error occurs, the following error

Ferrum::PendingConnectionsError (Request to http://localhost:3000/ops/print_test reached server, but there are still pending connections: http://localhost:3000/ops/print_test):

is generated and no further renderings are run. Thus, I suspect the FerrumPdf.browser = nil line is misplaced. To have a failsafe mechanism to securely shut down the process, would an after_action be in order?

6 - [file under splitting hairs] the mix of standards (metric, imperial) can be confusing, especially when throwing in pixels in the mix. Interestingly, when it comes to roll paper it appears metric is the standard. Maybe this would be a parameter to set up front (px, mm, in) and have subsequent values simply go with that... "(in inches, defaults to 1cm)" is jarring

7 - page_ranges: nil set to nil. does this mean 'all' too? In the case of roll paper, I also tried page_ranges: "1" which returned the exact same rendered file. I assume this assumption is correct.

.zshrc

export BROWSER_PATH="/opt/homebrew/bin/thorium"
export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

initializer

FerrumPdf.configure do |config|
  config.window_size = [1920, 2880]

  # config.process_timeout = 30 # defaults to 10
  config.browser_path = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'
  # config.headless = false  # debugging

  # For use with Docker, but ensure you trust any sites visited
  # config.browser_options = {
  #   "no-sandbox" => true
  # }
end

other methods useful for reproducing

def mm_to_in( mm )
  mm * 0.03937008
end

  def mm_to_px( mm )
    cm = ( mm.to_d / 10 )
    px = cm * ( 96 / 2.54 ) 
  end

  def px_to_mm ( px )
    millimeters = px * 0.2645833333
  end

[dvodvo]

Bring down the options to barebones:

      format.pdf do
        render ferrum_pdf: {
          url: ops_print_test_url, 
          pdf_options: {
            paper_width: 3.15,
            paper_height: 7.9
          }
        }
      end

still generates a PDF file whose dimensions are 612 x 792