The Quark File Comparison Module

Navigation:  Tools Menu >

The Quark File Comparison Module

Previous pageReturn to chapter overviewNext page

To compare 2 QuarkXPress files using the QuarkXPress Files Comparer (available from the Templates menu) :

 

1.Select file 1 and file 2 at the top of the dialog (allowed file extensions are *.QXD and *.QX_, the extension used by Q++ to keep a backup copy of generated diaries). We recommend that the "good copy" or "reference" file be set as file 1 and the one that is potentially different be set as file 2.

 

2.Click on the Compare button at the bottom of the dialog.

 

Once you have clicked on the compare button, a progress dialog comes up informing you of the progress of the scanning of both files and of the subsequent analysis of these scans. When the process is completed, the overall results of the comparison are displayed in the Summary of Comparison tab, using the following color scheme :

 

Important differences which will most likely result in 2 files that look different.

Difference that may not, on its own, mean that the 2 files look different. An example of such differences are the file names, or the folders where the files are saved.

Whenever it could be tested, this attribute was found to be the same. The emphasis here is on the term whenever it could be tested, because there are cases, particularly when comparing textboxes and their contents, when a previous difference in the comparison of an attribute makes it impossible to perform a comparison on another attribute (for example, is a textbox has been deleted, then comparing tithe text inside makes no sense).

No comparison was performed for this specific attribute. Usually this happens for pictureboxes that do not contain any pictures, but if the files being compared are totally different from the very first page onward, then some comparisons may never be performed.

 

 

Overall results of the comparison are grouped into 5 categories (more specifics can be found in the corresponding section of the comparison log).

.

 

Testing Windows File Attributes

File Name

This test compares the filenames (without the path) of the 2 files being compared. Clearly, since you cannot compare the same file, either this element will differ or the folders, below will differ, always. Therefore, a difference here is only denoted by an orange marker.

Folder Location

This test compares the folder locations of the 2 files being compared. A difference here is only denoted by an orange marker, for the reasons given above.

Timestamp

The date and time when the file being scanned was last modified (note that scanning does not modify the timestamp of a file).

Size

The file size. A difference here is almost always a sign that the files being compared are different. The specific sizes of the 2 files can be found in the Comparing File Attributes section of the comparison log.

 

 

Testing QuarkXPress File Attributes

Quark Version

The QuarkXPress file version in which the file was saved (this may be different than, but always less than or equal to, the version of QuarkXPress used to save the file).

Multiple Languages

This tests if both files were single-language, or both were multiple languages (ie. QuarkXPress Passport).

Page Width/Height

The physical page's height and width (these measurements are independent of the units used in the QuarkXPress interface).

Number of Pages

The number of page in the QuarkXPress file, including blank pages (see the Pages group of tests, below, for a finer analysis between the number of blank and non-blank pages).

 

 

Testing Pages

Number of

Non-Blank Pages

The number of pages that are not blank. This is useful when comparing files that are the same save for the addition or omission of blank pages at the front and/or back.

Number of

Blank Pages

The number of pages that are blank. This is useful when comparing files that are the same save for the addition or omission of blank pages at the front and/or back.

First Non-Blank Page

The page number of the first page that is not blank.

Last Non-Blank Page

The page number of the last page that is not blank.

Page Previews

Bit by bit comparison of the bitmap preview made of each scanned page, including blank pages. A difference here is only denoted by an orange marker.

Non-Blank

Page Previews

Bit by bit comparison of the bitmap preview made of each scanned page, starting with the first non-blank page of each file. This test, and the previous one, compares 250 by 250 pixels bitmaps and therefore will not catch every minute difference in the files being compared, however a difference here is a sign that the 2 files being compared are definitely different.

 

 

 

Testing Usage

Defined Colors

The list of colors defined in each file. A difference here is only denoted by an orange marker.

Used Colors

The list of colors actually used in each file. More details can be found in the Usage tab of the comparer dialog.

Used Fonts

The list of fonts used in each file. More details can be found in the Usage tab of the comparer dialog.

Used Images

The list of image files used in pictureboxes of each file. More details can be found in the Usage tab of the comparer dialog.

 

 

Testing Objects' Sequence and Contents

Number of Objects

The total number of objects contained in each scanned file.

Objects Sequence

This test compares all the object ID's and types (line, textbox or picturebox) of all the scanned objects one by one.


If this test is successful, it means that both files contain the same number of objects, and that these objects were created in the same sequence. However, it does not necessarily mean that the objects have the same size or contents, and it does not mean that the objects are on the same page in both files.


If this test fails it means that either both files do not come from the same original GridTemplate, or that some objects were transformed (for example using an image token). The files could still look the same but that would be a coincidence, or due to an overhaul of the file such as would occur when creating a clean copy.

Page and Objects Sequence

This test compares the page/object ID/object type triplets of all the scanned objects one by one.


If this test is successful, it means that both files contain the same number of objects, and that these objects were created in the same sequence and are place on the same pages. However, it does not necessarily mean that the objects have the same size or contents.


If this test fails, and the one above succeeded, then it means that both files don't not have the same number of blank pages.

Objects Positions and Sizes

This test compares the page/object ID/object type triplets of all the scanned objects one by one, as well as their top-left and width/height values.


If this test is successful, it means that both files contain the same objects of the same ID in the same sequence, on the same pages and with the same positions and sizes. However, it does not necessarily mean that the objects have the same contents.


If this test fails, and the one above succeeded, then it means that both files are very similar, but that some objects of one file were moved/resized as compared to the same objects in the other file (probably using a BoxFit token).

Image Filenames

This test compares that any picturebox contains the same filename image in both files, or uses a blank filename.

 

 

Image Folder Location

This test compares that any picturebox contains images located in the same folder for both files, or uses a blank filename.

Image File Timestamp

This test compares that any picturebox image filenames (if not blank) have the same date and time of last modification.

Image File Size

This test compares that any picturebox image filenames (if not blank) have the same file size.

 

 

Textboxes' Plain Text Contents

This test compares the plain text (including returns and tab characters, but not tabulation values) of textboxes of both files, as long as the Page and Objects Sequence above holds true. The moment this sequence is broken a corresponding message is entered in the log.

Textboxes' Formatted Text Contents

This test compares the formatted text (including text and paragraph attributes and the definition of their respective stylesheets) of textboxes of both files, as long as the Page and Objects Sequence above holds true. The moment this sequence is broken a corresponding message is entered in the log.

Other Object Attributes

This test compares other attributes (such as frame and background attributes) of both textboxes and pictureboxes of both files, as long as the Page and Objects Sequence above holds true. The moment this sequence is broken a corresponding message is entered in the log.

 

 

 

More details on all the above tests can be found on the Log, Usage and Objects tabs.


Topic 176230 updated on 09-May-2013.
Topic URL: http://www.qppstudio.net/webhelp/index.html?quarkfilescomparer.htm