Zorac

KPD 2.0 - Advanced Help

Knitting Patterns Database (2020 release)


Knitting Patterns Database (KPD) is an Android App to categorise Adobe Acrobat (PDF) knitting patterns.

KPD 2.0 is a new 2020 updated stand alone App re-coded to make it more compatible with todays devices and Androids ever changing operating system.

KPD 2.0 can be installed alongside your existing Pro Knitting Patterns Database App to facilitate migrating from the old to new version.
This was needed as it became apparent that the new version would force the previous version to be un-installed which would have meant losing all you data and pdf patterns.
Using the "Moving KPD onto a New device" instructions below you can completely migrate all your data and files to KPD 2.0.

Some of the fixes and changes:

Camera - added new android permissions to make camera work again.

View pdf - added new android permissions to allow pdf files to be opened again.

Options menus - added dedicated options button on most activities to facilitate accessing the device's options menu. This is to overcome those devices which do not have a way to show the virtual ... app options menu button.

Sharing permissions update - added new permissions to allow sharing content again.

Removed "set pattern folder location".
KPD will now use either internal or external storage depending on which has the greatest available memory. The option to select different pattern folders is no longer possible due to the new Android permissions structure.

Added user prompts to allow KPD camera and storage permissions to be set at app startup.

Web Page2PDF is back with a new provider.

Thats about it for now!

Each facility in KPD has it's own Android activity, to access additional features and activity help, press your devices Option button or the new floating options button. Depending on your Android version this button could be an icon with three dots, usually at the bottom left or top right of each activity or a dedicated button beneath the screen on some older devices. On some newer devices you have to long press on the 'recent apps' button. The recent apps button usually has two overlapping rectangles displayed on it.

As well as many other features like handy knitting calculators, the main feature is an automated import of pdf pattern files into a database which then enables you to categorise them by:
Pattern Name
Unlimited configurable Craft categories, Knitting, Crochet or Machine
Gender, Men, Women, Child etc.
Garment Type, Jumper, Cardigan, Waistcoat etc.
Yarn, 4Ply, Aran, Chunky etc.
Yarn Weight, 150 grams
Yarn Length, 300 yards
Needle Size, 3mm | UK 11 | US 2 etc.
Gauge/Tension
Star Rating
Notes
When entering values for Weights or Lengths use a numeric value that represents a unit of measurement of your choice (ie ounces, grams / yards, meters), then use that same unit throughout KPD for Weights or Lengths. This will ensure that when filtering or matching 'my yarns' to patterns the compared results are accurate.

When your patterns have been categorised you can then Filter the results which can be displayed as a list or in a gallery of pattern pictures.

The following instructions have been written to try and help users who are relatively new to Android devices, most of you will know much of what is mentioned below however it does provide an overview of the process required to use the KPD App.

Overview of how to get patterns into the App
  1. The first time you open KPD it creates a folder in the Android operating system of your device named "knitting". If your device has more than one storage location KPD will use the one with the largest free space. (The location of this folder is shown at the top of the KPD help page) KPD will use this folder to store any downloaded patterns via it's built in web browser. Note you can also add existing PDF patterns into this folder manually using a file manager app, these will then get imported into the KPD database.
  2. Using the built in KPD web browser (Download Patterns Button) download some patterns.
  3. Close the KPD web browser and press the "Import Patterns" button to import the patterns into the database.
That's it!

When the PDF pattern file is imported the original pattern file-name is used as the name for the pattern in the database and is prefixed with an (*) asterisk so that the new patterns will be identifiable and shown at the top of the patterns list. (Note you can amend the pattern name in the app later if you wish)

You can then press the "My Patterns" button to list the patterns. From the list, when you press a pattern you get options to View the PDF Pattern, Edit the database entry, Delete the pattern from the database and device, mark the pattern as In-Use, open the 'Row Counter with Pattern' and 'Match My Yarns'.

When you select Edit you can change the database fields:
Pattern name, Gender, Garment Type, Yarn Type, Yarn Weight or Length, Knitting Needles, Star Rating, Gauge and Notes.

Once you have updated a few patterns you will be able to use the Filter option to filter the patterns by those fields.
For example, if you wanted to knit a JUMPER for a BABY and you only had 150 grams of 4Ply WOOL and size 11 NEEDLES then you can use Filter to only show you the PDF patterns that meet those requirements. In addition you will also be able to list 'My Yarns' that are suitable for a particular pattern.

Getting Patterns

Most Internet knitting patterns are already in PDF format but for those that are not you can use the 'Page2PDF' option within the KPD browser to convert and download html web pages into PDF files.

When using the built in KPD web browser (Download Patterns Button) some web sites may decide to output their content in mobile rather than desktop format. Mobile format is usually more compressed and sometimes have fewer features. By selecting KPD's "Force Desktop view", accessed in the browser options, KPD will send the request in such a way that the sites server will think that it's sending the page to a desktop screen rather than a smaller Android screen. For example, when visiting the Lionbrand pattern site, their coding detects that you are on the Android operating system and always sends the output in mobile format. Their mobile formatted web pages do NOT have a download pattern link on them so by default KPD will automatically turn on "Force Desktop view" for Lionbrand and turn it off for other sites unless you manually set "Force Desktop view" from the KPD browser options menu.

Putting Patterns into the "knitting" Folder (When not using the built in KPD pattern download browser)

The App only recognises pattern files in PDF format (i.e. have the file extension .pdf) which have been placed into the "knitting" folder as created by the App. Do not create your own knitting folder as this will not be recognised.

Any pdf files added to this folder will be imported into the database when pressing 'Import Patterns'. You can add pdf pattern files from any source, a home computer, the Internet, an email attachment etc.

If you are NOT using the KPD built in web browser to download your patterns you will have to move any downloaded patterns from your devices download folder into the KPD knitting folder using a file manager App like 'My Files' or connect your Android device to a computer.

Most users use file manager app that came with their device, otherwise download one from the Google Play Store. These Apps are very much like "Windows Explorer" which allow you to view the contents of the Android file system to copy and move files. Some device manufactures supply File Explorer Managers with their devices.

Example Process (Not using the KPD Browser)
From your Android phone or tablet find patterns on the Internet using the devices built in Web Browser.
From the web browser download the PDF patterns. Typically these end up being downloaded into a folder called "downloads" in your device.
Next using the File Manager App, navigate to the "downloads" folder and move the pattern files to the folder called "knitting".
Adding the Patterns into the Database

Open KPD and press the "Import Patterns" button. The App then looks in the "knitting" folder for patterns to add to the database and imports them, and at the same time extracts the up to 6 pattern images from the PDF into the KPD pattern gallery.

Editing Patterns and updating the database fields

Press the "My Patterns" button to list all the patterns that have been imported. At the very bottom left of the pattern list view is a small icon with an up/down arrow. Press this to toggle expanding the list view to show additional fields and the default pattern image.
Note that the newly imported patterns are prefixed with an asterisk to identify them as new and not edited. Press a pattern name from the list to bring up a dialog where you can choose to either View, Edit, Delete, open the 'Row Counter' and 'Match My Yarns'.
  • Press View to view the original pattern.
  • Press Edit to edit the database entry to update the fields like Garment type.
  • Press Delete if you wish to delete the pattern.
  • Press Clone if you wish to duplicate a pattern.
  • Press Gallery to open gallery view with the current pattern selected.
  • Press In-Use to toggle the pattern In-Use indicator. (changes the pattern name color from white to red)
  • Press Row Counter to open the pattern and row counter side by side.
  • Press Match My Yarns to list your yarns that can be used with the selected pattern.
Weight
The Weight field is used to enter the weight of yarn required to complete the pattern.

Length
The Length field is used to enter the length of yarn required to complete the pattern.

'Ounces to Grams', 'Grams to Ounces', 'Yards to Meters' & 'Meters to Yards' buttons

When you press any of these buttons the value in either the Weight or Length fields will be converted to the required format.

Cloned (duplicated) Patterns
Use clone pattern when you wish to record different information against a project pattern. For example you may wish to record information when knitting the pattern for a child and an adult where you would use different yarn, needles, gauge etc. for each. Create two clones from the original pattern renaming them to something useful like Sweater Child and Sweater Adult. Now you will be able to set the pattern categories, lengths gauge etc to independent values.
Patterns that have been cloned will be identifiable in the list and gallery views as their pattern names will be yellow in color. If a cloned pattern is both marked in-use (normally colored red) and cloned, then text will be colored orange.
If you forget a cloned pattern's parent, because you have changed the pattern name and image to something completely different, then pressing the clone button on a cloned pattern will take you to it's parent pattern.
Each field, category, image, text in a cloned pattern is completely independent to it's parent, except for the PDF pattern file. Even the "Row counter with pattern" functions independently.
If you try and delete a pattern that has cloned child patterns derived from it, you will be prompted and advised that if you continue all the child clones of the parent pattern will also be deleted. You can of course delete individual cloned copies as required without effecting other clones or their parent.

Auto Complete
Below the edit button is a check-box and the text, "Enable auto complete". When checked and as you press the edit button the App automatically completes some of the edit fields for you. It does this by reading the PDF file to match specific words and phrases. There may be a small delay in opening the editor but this should save significant time instead of having to read the pattern manually to complete the editor fields. When auto complete is unchecked the editor will open without reading the PDF pattern.

Note the "auto complete" action only executes when opening the editor when the pattern is new (prefixed with a asterisk). Once the pattern name is saved without an asterisk "auto complete" does not execute again to prevent overwriting your selections.

Customise Auto Complete

You can customise the words used to match pattern text used by "auto complete" by adding and editing key words in the "auto complete settings" section accessed from within "categories".

When adding new "auto complete" words, avoid using short words like "top" or "men" as these will match other words in the pattern file which in turn will select the wrong category. For shorter words try prefixing or suffixing the word with a space character, that way the word " men " would not match the word "women" accidentally. The matching words and phrases are case insensitive, so the word "JUMPER" would match "jumper" in the PDF pattern.

If you decide to edit the needles categories then ensure you use the keyboard (|) pipe separator character as a delimiter between needles of different measurement equivalents.
i.e. "2.0 mm | UK 14 | US 0"

Add / Edit Categories

When you edit a pattern the categories listed in each field can be edited using the "Categories" option. For example you can add or edit new Genders or Garment types. When editing a category any existing patterns using the pre edited category name will be updated to the new value. If you delete a category, any patterns that were using the category will be set back to blank (Not set to anything).

Backup & Restore


The live knitting patterns database is stored in your devices internal memory where it cannot be accessed even with the android file manager app.
Using the Backup option you can make a copy of the KPD database and preferences file to the KPD knitting folder where it can be accessed and either restored or copied onto another device.

Note that backup does not backup your patterns, extracted pdf images or photos, only the database and associated personal preferences

For example if you purchased a new device you could make a copy using the backup option on the old device, then copy the "knitting" folder containing all the PDF files and the database backup and preferences file onto the new device. Note you would need to open KPD once on the new device to create the KPD knitting folder first, before copying files.

Then after installing the KPD App on the new device you would use the Restore option to import all your patterns without having to re-input all the data again.

Download Patterns Web Browser

KPD has it's own built in web browser (WB) to assist in downloading knitting patterns from the Internet directly into the KPD app. To access the WB press the "Download Patterns" button on the first screen. The WB home page has many of the free pattern web site links listed and by pressing on them you will be taken to their site. At the top of the WB is a standard URL entry field where you can type a URL and press "Go". Beneath the URL entry are links to this document (called On-Line Help) and another to the KPD users forum. Pressing your devices options menu will offer additional features including:
  • Home - Takes you back to the home screen
  • Add Bookmark - Adds a book mark of the web site page you are currently on
  • Bookmarks - Edit / Delete bookmarks
  • Page2PDF - Converts any web page to a PDF document. You use this when the web site that displays your pattern does NOT have a download as PDF option.
  • Close - Closes the WB without having to press your devices back button repeatedly
  • Refresh - Re-loads the current web page
  • Clear Cookies - Clear all cookies
  • Force Desktop view - Some web sites may decide to output their content in mobile rather than desktop format. Mobile format is usually more compressed and sometimes has fewer features. By selecting "Force Desktop view" KPD will send the request in such a way that the sites server will think that it's sending the page to a desktop screen rather than a smaller Android screen. For example, when visiting the Lionbrand pattern site, their coding detects that you are on the Android operating system and always sends the output in mobile format. Their mobile formatted web pages do NOT have a download pattern link on them so by default KPD will automatically turn on "Force Desktop view" for Lionbrand and turn it off for other sites unless you manually set "Force Desktop view"

Once you have found a pattern you like you need to locate a download link to download the pattern. The style and position of these links is dependant on the site you are on but if you look around you can usually find the download link. If not you can always ask a question on the KPD users forum for advice. Just after you press on a download link, if the content is a PDF document, KPD will start the download displaying a green progress bar to let you know the progress of the download. For the progress bar to be accurate, KPD interrogates the download server to get it's file size, if this information is not available, you will be prompted with a message and the download will continue without the standard download progress bar but replaced with an animated bar. All downloads are automatically placed into KPD's knitting folder. You can carry on downloading patterns from different sites and when you are done, press options Close, to close the WB. Then press "Import Patterns" to have KPD add the patterns and images to the database.

My Needles
My Needles is a place to catalogue your own needles. The idea being that if you are at the store or need to know if you have a specific needle for a project you can quickly filter your collection to see if you have the correct size and if it's available (not in use).

Needle size and length can be entered in any format, i.e. UK, mm, cm, US, inch (") etc but for best sorting ensure you enter the numeric size before the format. For example enter size '5 US' and not 'US 5'.

My Yarns
My Yarns is where you can catalogue your yarn stash. Once you add your stash you will be able to list available yarns that are suitable for a chosen pattern. Or list patterns that can be completed using a particular yarn.

When adding My Yarns you can enter the "Ball Weight" with a suffix to help you identify the measurement type, i.e. 100g or 4oz. Likewise when entering "Ball Length" you could add a suffix like yds

In the My Yarns 'list view', a total weight & total length quantity is displayed in brackets which is calculated automatically by multiplying the number of balls "Owned" by the "Ball Weight or Length". It's these total weights that are used when making a pattern match along with other My Yarn fields.
All 7 of the My Yarns categories can be edited using the plus and minus buttons to the side of the lists. For example you can add new Brands or Ranges to match your yarn stash.

As well as the various categories you can also take a photo so that you have a visual reference to what the yarn looks like. You access this by pressing on the yarn in My Yarns and selecting Photo.

You can use your devices camera to scan a Yarn's bar code label to look-up and pre fill My Yarn fields and also shop for yarn stock.

KPD will prompt you to download a free bar code scanning app on first use.

When you scan your yarn label KPD will:

Check if the bar code is valid and is in the on-line code database.

If the code is in the on-line database and has product information, tries to match the product description to the KPD my yarn categories. ie Brand / Range etc.

If the code is in the on-line database and has NO product information, after you manually complete your My Yarn details and press Add, you will have the option to upload your yarn information to the on-line bar code scan database. This will then allow others to match when they scan the same code and over time should build up a comprehensive database of Yarns.

The process of uploading your my yarn details is done in background so that you can continue to use KPD. If you are interested if your yarn was added successfully to the master bar code database then select 'Scan Log' from My Yarns options or just rescan the yarn code.

When you have added all your yarns you will be able to automatically display all the suitable yarns for a pattern and also display all patterns that match a specific yarn.
From the patterns list or gallery views you can choose "Match My Yarns" and the App will display the yarns that are suitable for the selected pattern. The pattern editor fields that are used to make matches are:

Pattern Weight - Display my yarns that have a total weight greater or equal to that specified in the editor for the pattern. (total weight is "owned quantity" multiplied by "ball weight")

Pattern Length - Display my yarns that have a total length greater or equal to that specified in the editor for the pattern. (total length is "owned quantity" multiplied by "ball length")

Pattern yarn (i.e. Double) - Display my yarns that have the same yarns to that specified in the editor for the pattern.

Pattern needles - Display my yarns that have the same needle sizes to that specified in the editor for the pattern.

You can also list patterns that can be knitted using a particular yarn by selecting the option "Match My Patterns" when pressing on a entry in "My Yarns".
When making a "Pattern to My Yarns" or "My Yarns to Pattern" match you are given the choice whether to apply "needles matching", answering no will only match on Weight/Length and yarn type.
If your database entry for a pattern has either multiple needles or yarns specified, the results displayed in the "My Yarns" list reflects all the combinations entered for the pattern.

My Yarns Import
Import 'my yarns' allows you to add multiple 'my yarns' from another database or list. Typically you create a CSV (comma-separated values) file outside of KPD using a program like Excel or a text editor. In this file each new 'my yarn' is on a separate line and each of the 15 'my yarn' category items are separated by a comma.
The KPD color & fibre fields can contain multiple values, if you wish to enter more than one value you separate them with a semicolon. For example, to add two colors for the same yarn you would enter:
Black;Red
The file can have any name but must end with the file extension '.csv' and can be placed in any folder on your Android device.

During the import, categories not already in 'my yarns' will be added automatically except for Needles & Yarns which must exist beforehand. If a Needle or Yarn is not matched then you will be prompted to pick one from a list.

At the start of the import you have the option to 'delete all' or 'append to' any existing 'my yarns'.
When you open Import Yarns, a file called 'ImportHelp.txt' is created in the KPD knitting folder, contained within are all the categories and their values which you can use to copy and paste into your CSV import file.

Gallery View


The images in the Gallery are automatically extracted from the PDF patterns when you press the "Import Patterns" button. Not all images can be extracted successfully due to factors like author permissions and format of the original image. When an image cannot be found or extracted from the PDF the default database (sheep) icon image will be used instead. When this happens you can use the option 'Add image from pattern' to list and then select an image to use from the pattern manually. When no images are found using this method or you decide not to use one of the images listed then the default icon will turn red to indicate that you have already checked this pattern for an image.

As PDF patterns may contain many images the App will use the 6 largest image found. In some cases the extracted image may be upside down, for these, press the image in the gallery and choose rotate from the Image Menu.

Pressing the option 'Locate Pattern in List View' will find and highlight the pattern in the list view where you can then select the normal options like, edit, delete or view. If you then press your back button you will be returned to the Gallery view.
The Gallery view also reflects any filters you may have in place. For example, after filtering patterns by the Gender Baby and pressing the Gallery option, only the baby pattern images are shown.

Pressing an image in the gallery and choosing the 'Image Menu' offers up options to replace an image with one from the pattern, camera or file system. You could use this to take a photo of your finished project and place it in the gallery. After taking the photo via the KPD App you can adjust the image by dragging the blue/orange borders before saving.

Images added to the gallery whether from the camera or from the file system are copied into the "knitting" folder so the originals can be deleted if you wish as some devices make copies.

Other options in this menu are:
  • Share Pattern - Direct e-mail the pattern.
  • Share Image - Share the image from the pattern via facebook, email etc.
  • View the pattern.
  • Delete the pattern image from the gallery.
  • Rename the Pattern
  • Row Counter with Pattern
  • Match with 'My Yarns'

Gallery Image Scale

Gallery images can be scaled in three different ways:
  1. Center Inside - Image aspect ratio is maintained as original, image sizes will be different.
  2. Center Crop - Image is cropped and then centred, sections of the image will not be shown, images will all be the same size.
  3. Fill - Image is stretched to fill, landscape images look distorted, images will all be the same size.
Press the devices options / settings menu icon when in gallery View and select 'Scale' to change.

Extract Gallery Images
Pattern images are required if you wish to view patterns using the "Gallery" view option. Pattern images are automatically extracted and added to the Gallery when you add patterns to the database using the "Import Patterns" button. However if you have lost or deleted some of your pattern images you can use the "Extract Gallery Images" option which will open every pattern PDF to extract the pattern picture. Note that this action will take a considerable amount of time depending on pattern size and device processor (Throughput is approx 170 patterns per minute). You access this option from the first screen via the options button.

Row Counters

There are two versions of the row counter in KPD.
  • The first, accessed from the front screen, is a stand alone counter.
  • The second, accessed from 'My Patterns' view or the Gallery view, is a combined row counter and pattern viewer.
The Stand alone Counter has two row counters where the Pattern with Counter activity has four, their fields are explained next.

The 'Total Number of Rows' field can be used to enter a value that represents the total number of rows for the piece you are knitting. You increment the counter using the larger plus button and when this total is reached you will be notified by a sound & message and the counter cannot not be increased further unless you enter a higher total rows value or set it to blank.

The 'Number of Rows in Repeat' field can be used to enter a value that represents the number of rows required in a repeat section of knitting. For example if you had to repeat a pattern of knitting every 12 rows then enter 12 in this field.

As you increment the counter by pressing the large plus button, as well as the current row showing on the big plus button, the position in the repeat is also displayed below. ie 'Row 6 of Repeat 3'. If you advance a counter too far you can revert back a row at a time using the minus button.

You can leave both the 'Total Number of Rows' and 'Number of Rows in Repeat' values blank and just use the the large plus button to keep a count of rows. However if you set the 'Total Number of Rows' value the App will let you know when you have reached the last row.

If you wish to enter a count for the total number of rows in all repeats then use the 'Total Number of Rows' field which will notify you when you have reached the end of the repeats. Then by either setting 'Total Number of Rows' to a higher value or by setting it to blank you can continue to use the counter for further rows.

All counter values and repeats are remembered between sessions and are unique.

For convenience you can assign labels to each of the counters to help you identify what they are for.

Pressing the Reset button on an individual counter will reset all values and label back to zero or blank for that counter only.

Row Counters - Increase / Decrease Counter
Beneath the first row counter is a special counter to assists in keeping a count of stitches over a pattern repeat. This counter has different fields that are explain next;
  • Link - Link to counter 1. Toggle this when you a ready to start your increase or decreases which syncs with the standard row counter 1
  • Start sts - This is the number of stitches on your needle before commencing increase or decreases.
  • Inc/dec sts - This is the number of stitches to be increase or decreases per repeat. ie input 6 if pattern requires 3 increase or decreases at each end.
    Note to enter a decrease; prefix the number with a minus, for increases just input the number.
  • # of repeats - This is the number of times the pattern repeat is required.
  • Repeat every - This is the row that each repeat is worked. ie 3 would mean repeat every 3rd row.
The counter is linked to counter 1 when you press the 'Link' toggle button. As you press the counter 1 plus button the 'inc/dec' counter will update accordingly until the maximum is reached. At this point you cannot progress the main row counter until you toggle off the 'inc/dec' counter button. The 'inc/dec' display will display the number of stitches you should have on your needles as well as the row and repeat information.

If you press the Counter1 minus button when the 'in/dec' counter is linked, the 'inc/dec' display will reflect the correct position.

When you toggle the link 'inc/dec' counter button, any count of rows already incremented in the main counter will be used as the starting row count for the 'inc/dec' counter. This means you will not loose your overall row position. If you are required to do another 'inc/dec' then once again when you press the link 'inc/dec' toggle button the calculations will use the main current row count as a starting point for the 'inc/dec' repeats.

Counter with Pattern

In an ideal world it would be nice if we could view the PDF pattern using your preferred pdf reader App and the KPD counter side by side, however Android does not currently support multiple Apps or activities on the screen at the same time (except for some Samsung devices and even then you are limited to which Apps can use the feature).
To overcome this we use the 'Counter with Pattern' activity to read the contents of the pdf pattern and then display the text extracted on the left and the KPD counters to the right.

In the pattern viewer there are horizontal & vertical highlight lines to assist marking the current position in the pattern. The horizontal line has a central fixed position so that as you scroll the text vertically, an individual line can be marked. The vertical line can be positioned by long pressing on the screen at the position you wish to mark and after a short pause the line will reposition. The highlight lines and the counter values are maintained per pattern when re-opened.

Between the pattern text and the counters are a series of navigation buttons to adjust the position within the pattern. The smaller two buttons either position the pattern text to the top or bottom of the document. The larger two buttons move the text up or down, a line at a time. The top most button allows you to adjust the position of the split between the pattern text and the counters. Touch and drag left or right to increase or decrease the division or tap to hide/show.

Above the counters is a project timer. Use the timer to keep track of how long you have been working. The timer can be manually controlled or if it is running when you close the pattern, the timer will pause and restart the next time it's opened.

You can re-open a 'Counter with Pattern' pattern from the list or gallery views and also from the 'Row Counter' button on the first screen. This removes the necessity to manually locate the pattern you are currently working on in the list or gallery views.

In the 'counter with pattern' options menu there are options to change the background colour, the size and colour of the pattern text and an option to 'Edit' the pattern text.

Editing Extracted Pattern Text (via Row Counter with Pattern)

From the options menu in the 'Counter with Pattern' activity you can select 'Edit' which will open the 'Edit Pattern' activity. Here you can make changes to the extracted pattern text which gets saved when you press your devices back button. As part of the save operation KPD does some reformatting of the text as it did when the text was initially extracted from the PDF document.
These include:
  1. Adding additional paragraphs where KPD finds the word 'Rows' (Where the first letter is upper-case)
  2. Adding additional paragraphs where it finds periods followed by a space, unless they are preceded by certain characters like 'oz' (ounces) for example.
  3. KPD will also try to colour the text for certain key words like 'Stitches' and 'Rows' and their variants. This feature can be disabled.
  4. Line feeds will be appended to the beginning and end of the pattern text to half the screen height so that every line can be scrolled to the central horizontal highlight bar.
Occasionally KPD is unable to extract the original PDF text, this is due to factors outside our control, like PDF being password protected or the original documents being scanned as an image rather as ASCII text, etc.

When this happens you now have a facility to be able to fix those patterns that do not extract automatically using the editor.

1. Open the PDF pattern in your normal PDF reader, like Adobe.
2. Copy the text.
3. Edit the blank extracted pattern in KPD from the 'Counter with Pattern' options link.
4. Paste text into KPD editor by long pressing until the paste icon appears.
5. Press device back button while in KPD editor to save the pattern text.

Hey presto! You now have the PDF text in 'Counter with Pattern'!

Note: Depending on the layout of the original PDF pattern you may have to copy & paste sections at a time to get round original document column formatting.


Counter with Pattern - Image Place-Holders

The 'Counter with Pattern' and 'Counter with Pattern Edit' activities, by default can have up to 6 pattern images placed throughout the pattern text in approx the same locations as in the original PDF pattern or alternatively they will be at the end of the page. You can add or amend image place-markers between paragraphs, for example to place image1 type [1] at the location where you would like to see the image.

If you type at least one image place-marker any remaining images will not be placed below the text. This way you can control which images you prefer to see in the pattern. To revert to the default behaviour, remove all image place-markers.

Note that the order of the images can be changed either by changing the number in the place-marker or by changing the order in the images menu. So if your place-markers ran sequentially through [1] to [6] then the image order would reflect the order in the image dialogs of Pattern List and Gallery views.

As well as typing the image place-markers manually you can select 'Place Markers' from options to have them entered for you.

Within the 'Place Markers' dialog you have two options:

1. 'Insert All' - All patterns images will be placed at the select cursor position (you can then cut and paste to correct positions), OR
2. 'Insert Next' - On first press, the first pattern image will be placed at the selected cursor position, reposition the cursor at the position for the next image and re open the dialog, pressing 'Insert Next' again will place pattern Image2. Repeat until you're prompted that there are no further images or until you have placed enough images.

Note: When using Insert, all previous place-markers are removed.

Remember, initially as far a possible, the image order is set to replicate the order within the original PDF pattern. The place-marker numbers 1-6 represent the image at position 1-6 in the edit images dialogs. For example, which ever image you place in position 2 in the edit image dialogs will be displayed in this activity where place-marker [2] is located. However to preserve highlighted position in the pattern, the page will not refelct any changes in image order until you either, a) Edit and Save the text, this can be as simple edit like removing a period, or b) Select 'Re Extract Pattern'. This forces the counter with pattern page to be re-drawn replicating the image order selected in the image edit dialogs as long as your place-holders run sequencially 1 through 6.

You will be prompted to save your edits / image place-markers / color preferences, when you exit the activity on pressing the back button.

Moving KPD to a new Device (or migrating to KPD 2.0 on the same device)

If you are lucky enough to get a new device then you will probably want to copy your KPD data onto it, this is the process:
  1. Open KPD on your OLD device.
  2. Select Help from the options menu on the first screen and make a note of the knitting folder location mentioned at the top of the help page.
  3. Select backup from the options menu on the first screen. This will copy two backup files into the KPD knitting folder along with all your patterns and extracted images.
  4. Close OLD KPD.
  1. Install KPD on your NEW device.
  2. Open KPD on your NEW device. This will create the KPD knitting folder in the partition with the largest available space.
  3. Select Help from the options menu on the first screen and make a note of the new knitting folder location.
  4. Close NEW KPD.
  5. Copy the contents of the knitting folder on your OLD device into the knitting folder on your NEW device. Note, do not create any knitting folders but use the ones created by the KPD app. You can do this in many ways, for example one way would be to use the built in file manager app's on both devices. Then with blue-tooth turned on in both devices, copy all the files from the knitting folder on OLD device to the knitting folder on the NEW device. Remember the location of the knitting folders is displayed in the KPD help page on each device and you did make a note of them in these instructions.
  6. Once all the files have been successfully copied, open KPD on the new device and select restore from the options menu on the first screen.
When the restore has finished the top My Patterns button will display the correct number of patterns.
If you require more help or have any suggestions then please email us or visit the KPD forum.


Click this link to get the latest version of KPD 2.0


Copyright © 2012. ZORAC. All rights reserved reserved