Prawn
Rapida generazione di PDF tramite la libreria Ruby Open Source
API Ruby PDF gratuita che consente ai programmatori di creare e modificare file PDF; inserisci, modifica grafica e disegna testo su una pagina PDF all'interno di Ruby Apps.
Il Portable Document Format (PDF) è un formato di file affidabile e sicuro molto popolare per la presentazione, la condivisione e la stampa di file in tutto il mondo. La libreria Ruby open source Prawn ha fornito funzionalità complete per lavorare con documenti PDF utilizzando la libreria Ruby. La libreria è molto facile da usare e ben documentata, semplificando il lavoro dello sviluppatore. Aiuta gli sviluppatori a creare facilmente un sistema di generazione di documenti PDF altamente flessibile.
La libreria Prawn comprende diverse importanti funzionalità che consentono agli sviluppatori di software di gestire facilmente i propri documenti PDF, come la creazione di PDF da zero, l'incorporamento di immagini PNG e JPG, l'aggiunta di disegni vettoriali a PDF, l'utilizzo di caratteri integrati e TrueType, supporto della crittografia , proteggere il documento PDF utilizzando una password, supporto per il rendering del testo, supporto per i caratteri basati su UTF-8, rendering del testo da destra a sinistra, supporto per i contorni e molto altro.
Iniziare con i gamberi
Per installare il gambero sul tuo sistema, esegui il seguente comando,
Installa Gambero tramite RubyGems
gem install prawn
Crea file PDF tramite Ruby Library
La libreria open source di Ruby Prawn consente agli sviluppatori di software di creare documenti PDF in modo programmatico utilizzando un paio di righe di codice Ruby. La libreria ha fornito 3 modi diversi per la creazione di documenti PDF con impostazioni e caratteri predefiniti. Questi sono tramite assegnazione, blocco implicito o blocco esplicito. Una volta creato, puoi facilmente accedere e modificare ogni parte del tuo documento PDF. Puoi facilmente aggiungere una nuova pagina, impostare le dimensioni della pagina e i margini, modificare gli stili dei caratteri, applicare la formattazione e molto altro.
Crea e renderizza file PDF tramite Ruby
# Using explicit block form and rendering to a file
content = "Hello World"
Prawn::Document.generate "example.pdf" do |pdf|
# self here is left alone
pdf.font "Times-Roman"
pdf.draw_text content, :at => [200,720], :size => 32
end
Inserisci e modifica grafica all'interno di PDF
La libreria Prawn offre agli sviluppatori di software la possibilità di aggiungere disegni vettoriali nei loro documenti PDF utilizzando il codice Ruby. Gli sviluppatori possono facilmente disegnare linee, poligoni, curve, cerchi, ecc. in qualsiasi punto di loro scelta in una pagina PDF. La libreria include diverse funzioni importanti per lavorare con la grafica come colori di riempimento, applicare stili di trattino e pattern, impostare lo spessore della linea e applicarvi il colore, utilizzare la modalità fusione, applicare la trasformazione e la trasparenza e così via.
Utilizzo di immagini nei documenti PDF
La libreria Ruby open source Prawn ha fornito supporto per l'inserimento di immagini nei tuoi file PDF usando i comandi Ruby. Attualmente, la libreria include il supporto per le immagini JPEG e PNG. Sono disponibili diverse funzioni importanti per la gestione delle immagini all'interno di un file PDF, come la regolazione della posizione, il supporto per il ridimensionamento dell'immagine, l'impostazione della larghezza e dell'altezza dell'immagine separatamente, l'adattamento dell'immagine in modo proporzionale e così via.
Genera immagine e ridimensiona per adattarla in PDF tramite Ruby
Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do
pigs = "#{Prawn::DATADIR}/images/pigs.jpg"
image pigs, :at => [50,450], :width => 450
dice = "#{Prawn::DATADIR}/images/dice.png"
image dice, :at => [50, 450], :scale => 0.75
end
Disegno di testo su pagina PDF
La libreria Prawn consente ai professionisti del software di disegnare facilmente testo su una pagina PDF all'interno della loro applicazione Ruby. Puoi facilmente iniziare a disegnare del testo in una posizione specifica di una pagina PDF. Puoi facilmente regolare la posizione del testo, ruotare il testo in base alle tue esigenze, applicare la dimensione del carattere, il supporto di linee singole e multiple e molto altro.
Disegna il testo sulla pagina PDF tramite Ruby Library
def draw_text!(text, options)
unless font.unicode? || font.class.hide_m17n_warning || text.ascii_only?
warn "PDF's built-in fonts have very limited support for " \
"internationalized text.\nIf you need full UTF-8 support, " \
"consider using an external font instead.\n\nTo disable this " \
"warning, add the following line to your code:\n" \
"Prawn::Fonts::AFM.hide_m17n_warning = true\n"
font.class.hide_m17n_warning = true
end
x, y = map_to_absolute(options[:at])
add_text_content(text, x, y, options)
end