RNOPDF

ABOUT
-----

 RNOPDF is a compact PDF viewer having a minimal GUI with easy control options.
 It can be handy for quick viewing of PDF files if configured as the default
 PDF viewer on your operating system.


FEATURES
--------

 - Easy zooming using a mouse
 - Search text in documents
 - Supports document bookmarks
 - Recent file(s) list that also remembers previously viewed pages
 - Preloads the next page for faster viewing
 - Can export pages as PNG or JPEG images in various resolutions
 - Can sharpen exported images
 - Can export pages as text files
 - Fullscreen mode option
 - Rotate options
 - Keyboard and mouse controllable
 - Drag & drop loading
 - ARexx support on Amiga compatible platforms
 - Hollywood source code included


INSTALLATION
------------

 - Copy the whole directory anywhere you want and just launch the program
 - (AmigaOS4) If the program fails to start, copy .hwp and .ext files to
   LIBS:Hollywood/


KNOWN ISSUES
------------

 - AmigaOS3 versions of RNOPDF may crash with certain PDF files if used under
   WinUAE 4.2.0 or older, or with other emulators using older WinUAE cores,
   due to a bug in WinUAE's 68020 emulation.
 - PDF files that don't have correct media box setting(s) fail to display their
   background colour correctly. This will be fixed in the next Polybios version


CONTROLS
--------

 Right/Cmd+N  . . . . - Loads the next page
 Left/Cmd+P . . . . . - Loads the previous page
 Home/Cmd+T . . . . . - Loads the first page
 End/Cmd+L  . . . . . - Loads the last page
 PageUp/Cmd+"-" . . . - Jumps 10 pages back
 PageDown/Cmd+"+" . . - Jumps 10 pages forward
 Cmd+J  . . . . . . . - Jumps to a selected page
 Cmd+B  . . . . . . . - Jumps back to the previously viewed page
 Cmd+M  . . . . . . . - Opens the bookmarks requester
 Cmd+S  . . . . . . . - Opens the search requester
 Cmd+X  . . . . . . . - Searches for the next occurrence of a searched string
 Cmd+Z  . . . . . . . - Searches for a previous occurrence of a searched string
 Held LMB/MMB/Shift . - Zooms the page
 Rotate mouse wheel . - Loads the next or previous page
 Double-click . . . . - Toggles fullscreen mode On/Off
 Cmd+F  . . . . . . . - Toggles fullscreen mode On/Off
 Esc  . . . . . . . . - Exits fullscreen mode
 Cmd+O  . . . . . . . - Opens a new PDF file
 Cmd+I  . . . . . . . - Shows information about the current document
 Cmd+1  . . . . . . . - Resizes the window to the original PDF size
 Cmd+2  . . . . . . . - Resizes the window 2 times the original PDF size
 Cmd+3  . . . . . . . - Resizes the window 3 times the original PDF size
 Cmd+4  . . . . . . . - Resizes the window 4 times the original PDF size
 Cmd+5  . . . . . . . - Exports the current page as a text file
 Cmd+6  . . . . . . . - Exports all pages as one continuous text file
 Cmd+7  . . . . . . . - Exports the current page as a PNG image
 Cmd+8  . . . . . . . - Exports all pages as PNG images
 Cmd+9  . . . . . . . - Exports the current page as a JPEG image
 Cmd+0  . . . . . . . - Exports all pages as JPEG images
 Cmd+C  . . . . . . . - Copies the current page to the clipboard as text
 Cmd+E  . . . . . . . - Copies the current page to the clipboard as an image
 Cmd+Q  . . . . . . . - Quits the program


SETTINGS
--------

 Resize automatically . - Resizes the window to match the page size(s) when a
                          new PDF is loaded
 Preload next page  . . - Preloads the next page for faster viewing
 Remember recent files  - Saves the recent file(s) list when quitting
 Show links . . . . . . - Draws rectangles around links on pages
 Flush Polybios.ext . . - Flushes Polybios.ext at exit (frees 6MB of memory,
                          but slows down re-launching of the program)
 Zoom level . . . . . . - Sets the zoom level
 Zoom key . . . . . . . - Sets the zoom key
 Rotate . . . . . . . . - Sets the image rotation


COMMAND LINE OPTIONS AND ICON TOOLTYPES
---------------------------------------

 RNOPDF uses non-standard command line arguments. Arguments must be given
 in the form of (note the "-" prefix): -argument parameter

 Allowed arguments:
 -file <file> . . . . . - Opens a PDF file at startup
 -defdir <dir>  . . . . - Sets the initial directory to open files
 -winsize <n> . . . . . - Resizes the window by factor <n>

 Example:
 RNOPDF -file "Work:Documents/Some Book.pdf"


 The same arguments can be used as icon tooltypes, by omitting the "-" prefix.

 Examples:
 DEFDIR=Work:Documents
 FILE=Work:Documents/Book.pdf
 WINSIZE=1.5


AREXX
-----

 Program's ARexx port is RNOPDF.1 (and .2, .3 etc. for multiple instances)
 and supported commands are:

 OPEN <file> . . . . . . . - Opens a new PDF file
 FIRST . . . . . . . . . . - Loads the first page
 PREV  . . . . . . . . . . - Loads the previous page
 NEXT  . . . . . . . . . . - Loads the next page
 LAST  . . . . . . . . . . - Loads the last page
 PAGE <n>  . . . . . . . . - Loads the supplied page number
 SEARCH <keyword>  . . . . - Searches text
 FULLSCREEN  . . . . . . . - Toggles fullscreen mode
 EXPORT <f> <n> <s> <d>  . - Saves the displayed page as an image, <f> is
                             format (PNG or JPEG), <n> is image width, <s> is
                             to enable sharpening (0 or 1), <d> is a destination
                             directory
 EXPORTALL <f> <n> <s> <d> - Saves all pages as images, <f> is format (PNG or
                             JPEG), <n> is image width, <s> is to enable
                             sharpening (0 or 1), <d> is a destination directory
 RESIZE <ON|OFF> . . . . . - Sets the "Resize automatically" setting
 PRELOAD <ON|OFF>  . . . . - Sets the "Preload next page" setting
 RECENT <ON|OFF> . . . . . - Sets the "Remember recent files" setting
 FLUSH <ON|OFF>  . . . . . - Sets the "Flush Polybios.ext" setting
 ZOOM <n>  . . . . . . . . - Sets the "Zoom level" setting, <n> is 2, 3, or 4
 ZOOMKEY <key> . . . . . . - Sets the "Zoom key", <key> is SHIFT, CONTROL, or
ALT
 ROTATE <n>  . . . . . . . - Sets the "Rotate" setting, <n> is -90, 0, 90, or
180
 ICONIFY . . . . . . . . . - Iconifies the program
 UNICONIFY . . . . . . . . - Un-iconifies the program
 TOGGLEICONIFY . . . . . . - Toggles the iconify state
 QUIT  . . . . . . . . . . - Quits the program
 HELP  . . . . . . . . . . - Returns a list of the supported commands
 GET <FILE|PAGE|PAGES> . . - Returns the requested value

 Example (MorphOS only):
 RXCmd RNOPDF.1 "GET PAGE"

 Example (all Amiga compatibles):
 RX "ADDRESS RNOPDF.1;GET PAGE"


HISTORY
-------

 Version 1.6:
 - Fixed the search requester behaviour
 - Fixed a window positioning issue on OS3 versions
 - Better OpenURL implementation
 - Added a French catalog (thanks Yannick!)
 - Added a German catalog (thanks Stefan!)
 - Made the source code a bit more readable

 Version 1.5:
 - Added the JPEG support for exporting
 - Exporting can be aborted with the Esc key
 - More options when exporting via ARexx
 - Added "Search next" and "Search previous" options
 - More complete localisation support
 - Added an Italian catalog (thanks Luca!)
 - Older versions of reqtools.library work too (v38)
 - Added window resizing options in the Control menu

 Version 1.4:
 - Exported images can be sharpened
 - Improved exporting to custom sizes
 - Added the WINSIZE tooltype/argument
 - Localisation support
 - Fixed pathless file arguments
 - Other small fixes

 Version 1.3:
 - Added search functionality
 - Supports links in documents
 - Supports bookmarks in documents
 - Added text exporting options
 - Can open password protected files
 - Can display documents' meta-data and other information
 - Can flush Polybios.ext from memory at exit on Amiga compatibles
 - Added fullscreen mode
 - Improved compatibility with PDF files, due to endianness fixes in Polybios
 - Logo remains visible if the program fails to load a PDF file
 - "Jump back" option to swap between the current and a previously viewed page

 Version 1.2:
 - Added rotate options
 - Pages can be exported to custom resolutions

 Version 1.1:
 - Accepts a file argument and can be used as a default tool in project icons


WEB
---

 - Please visit https://jpv.amigaaa.com/ for screenshots, support, donations,
   and other software I created
 - This program is made with Hollywood: https://www.hollywood-mal.com/


THANKS TO
---------

 - Densho/RNO for the logo
 - Neil Pearson for proof-reading and testing


DISCLAIMER
----------

 This software is made available to you as Freeware and you may use this
 software in whatever way you wish, but the author accepts no liability for
 any damage caused to your system or other connected peripherals by using
 this software.

 Please consider the time and effort I put in to create this utility for your
 use and enjoyment. If you feel it is useful to you, please send a donation
 that represents the benefit you gain from using it to me at the address found
 in this ReadMe.txt file (Uploader) or click the Donate button at
 https://jpv.amigaaa.com/