KPD - Advanced Help

Knitting Patterns Database

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

Each facility in KPD has it's own Android activity, to access additional features and activity help, press your devices Option 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 pattern files into a database which then enables you to categorise them by:
Pattern Name
Craft, Knitting, Crochet or Machine (Pro version has unlimited configurable craft categories)
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.
Star Rating
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 external storage, 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 "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 browser App like 'ES-File Explorer' or connect your Android device to a computer.

Most users use a free App like "ES File Explorer" or "Astro File Manager" both available for free from 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 Android File Explorer 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 at the same time extracting the main pattern image from the PDF into the gallery. (Note that the Pro version extracts the largest 6 images)

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.
The Weight field is used to enter the weight of yarn required to complete the pattern.

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 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 browser.
Using the Backup option you can make a copy of the KPD database and preferences file to your external memory 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 or replaced your external memory you would 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 / memory card.

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.

While restoring the KPD database the App looks for the database backup file in the current knitting folder location. If you have changed device and the new knitting folder location is on a different path you can use the "Pick a backup file" option to manually locate it.

This can happen because:
  1. You have never created a backup using the "Backup" option in this App
  2. You have installed the App on a new device and the knitting folder is in a different location to the Apps default location.
  3. You have pressed "Clear Data" in Android settings / applications for this App
If you have manually moved your files to a new device and the location of the KPD knitting folder differs to where it was on the old device, after the restore, you can use the option "Set Pattern Folder Location" to change it. "Set Pattern Folder Location" is accessed from the options menu on the first screen.

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.

In the Pro version 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 that all Pro KPD users can access.

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:
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 largest image found in the Free version and the 6 largest images in the Pro version. 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 (3 in Pro).
  • 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 third, is a legacy version, 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
In the Pro version 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 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. At the bottom is a button marked with the letter 'W' which toggles word wrap. When not wrapped you can touch drag the pattern text left and right. Note that the Pro version supports zooming so does not require the word wrap button, this is because as you zoom the text automatically wraps to fit your screen.

In the Pro version 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. Note the Pro version which supports zooming does not require some of these features.

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 in KPD Pro)
  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 (KPD Pro Only)

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.

Android KitKat 4.4 update

To improve security Android has changed the way app's can write files to "secondary external storage" sdcards. (that is sdcards where you also have an 'internal' external storage location, making the sdcard a "secondary external storage" location)

If your KPD knitting folder is NOT set to a secondary external storage location then you will not be effected.

Previously, any app could write to any folder in "secondary external storage" but after the KitKat update this will no longer be the case and apps will only be able to write to one "application specific" folder. This folder is named "/some_secondary_mount_point_name/Android/data/com.zorac.knittingpro/files/knitting" for the Pro version and "/some_secondary_mount_point_name/Android/data/com.zorac.knitting/files/knitting" for the add supported version.

The "some_secondary_mount_point_name" location and name changes by device manufacturer and model. In some cases this will be a section of internal memory that your device manufacturer has set aside to be used as external storage, or it could be a removable sdcard.

For example on a Galaxy Note II the "application specific" folder is: "/mnt/extSdCard/Android/data/com.zorac.knittingpro/files" whe there is a removable sdcard. (for KPD pro)

Read permissions will be retained but write permissions are removed to all files & folders except the apps own 'application specific' folder.

The has led to many apps failing when they try to write to secondary external storage as they previously did, this includes most file manager apps unless they were supplied with your device.

In the case of KPD we write files to the knitting folder when you download patterns, extract images, take my yarn photos, do KPD backups etc. After the Kitkat update KPD will no longer be able to write to the knitting folder in it's current location if that was in secondary external storage. (when a removable sd card)

In addition and contrary to how Android behaved prior to the KitKat update, if you delete an app that has written / saved files to your "secondary external storage" or press "Clear Data", those files will be deleted as part of the app UN-install process. Previously, when an app was UN-installed, any files it created were retained.

So if you UN-install KPD or want to press "Clear Data" with the view to re-installing it, as some users have done previously, expecting your pattern files and KPD backup files to be present in secondary external storage, then this is no longer the case.

If you want to ensure you can recover your patterns and KPD backup files after UN-installing and re-installing KPD, or in fact any other app that saves files to "secondary external storage", then you will have to remember, prior to un installing, to copy them to a saved location.

For KPD you would copy everything from "some_secondary_mount_point_name/Android/data/com.zorac.knittingpro/files/knitting" to another location, UN-install, re-install, copy back from saved location back to "some_secondary_mount_point_name/Android/data/com.zorac.knittingpro/files/knitting".

The same for any other app that uses a "secondary external storage" sdcard, but then the folder in question would change to: "some_secondary_mount_point_name/Android/data/com.another_app_developer.name_of_app/some_folder_name"

Files that write to Internal storage or primary external storage are not effected.

So what happens with KPD if I do upgrade to KITKAT?
Good question, well we have added some code that executes the very first time you run KPD when the Android operating system has changed to KITKAT or higher to see if we can still write to the existing KPD knitting folder location. If we can no longer write to that folder then we create the "application specific" folder and copy all the files from the old knitting folder to the "application specific" folder. If KPD finds more than one secondary storage locations available then it will pick the one with the most free available space.

Ideally we would move the files from the old knitting folder to the "application specific" folder but due to the new KITKAT permission we no longer have the rights to delete files from the old knitting folder, so a move would fail. Instead we have to copy the files which means you will end up with two copies.

To be able to delete the old knitting folder and files you will have to use the file manager app supplied with your device. 3rd party file manager apps like Astro or ES file manager will fall foul of the new kitkat security and also not be able to delete the files. ONLY delete the old knitting folder when you are 100% sure KPD is using the new folder and is working successfully!

Note: The location of the current KPD "knitting" folder is displayed when you open KPD help from the options menu on the 1st screen.

Set / Change KPD Pattern Folder Location

As from KPD version 5.2.9 (released 24th Nov 13) the creation of the KPD knitting folder will automatically be created in the device partition that has the most available free space, if there is more than one available.

Previously when KPD was first installed it used Android's "external storage" location to create the "knitting" folder in. On many devices this was some form of removable SD card, though it could actually be just another partition of the "Internal device storage" designated as serving in the role of "external storage".
Your device may only have one storage location available in which case it will be non removable but still be referenced as "external storage" by Android operating system. Other devices have both this "internal storage" and "removable storage", usually in the form of a removable sdcard.

Unfortunately this has led to much confusion as both are referred to as "external storage" even though one is actually non removable and is built into the device. This is compounded by the names used to reference these storage areas. The names used differ by device manufacturer, the none removable "external storage" is quite often called sdcard, which to many indicates that its a removable card, but this may not the case, it's just the name used. On other devices, the partition or mount point called "sdcard" is in fact a removable sdcard.

Using a File Browser App like the one mentioned earlier, if you navigate up the folder tree and then into the folder "/mnt" (short for mount) you will see all the mount points / folders that are in your particular device. For example you could see something similar to this:
In this example the device has two locations where we can store the "knitting folder", "sdcard" which is the devices partition of the "Internal device storage" designated as serving in the role of "external storage" and "extSdCard" a removable sdcard.

When any App wants to write to the "external storage" location, if there is more than one, it will default to the internal device's "external storage", designated as serving in the role of "external storage". This may not be the best place to store lots of files as can be more limited in size than other partitions. But as from KPD version 5.2.9 the creation of the KPD knitting folder will automatically be created in the device partition that has the most available free space, if there is more than one available.

Clear as mud!

BTW - The physical path to the KPD "knitting" folder is shown at the top of the App's help page.

You can change the location of where KPD stores the knitting folder if you have another storage location available on your Android device that you have permissions to read and write to.
For example on some tablets you may have two sdcard locations, one built into the device that is the default location when you first use the KPD App and another sdcard location which may be a removable sdcard.

Due to internal sdcard storage size restrictions you may wish to set the "knitting" folder used by KPD to a different location. After selecting "set pattern folder location" from the options menu of the first screen you will be presented with a folder choosing dialog where you choose the new location for the "knitting" folder and optionally an option to move the patterns to the new location and update the internal database.

The external storage folder names differ by device manufacturer, for example some devices have non removable internal storage named "/mnt/sdcard" and removable storage named "/mnt/extSdCard".
App developers are not allowed to access every folder on a device so you will find that you can only use certain folders, usually containing the word sdcard. Check with your device manufacturer if you are unsure.

Like some other Apps, as well as moving KPD knitting pattern folder to another storage location you can also move the actual App itself to external memory using the options in Android.

Remember to occasionally use the backup option to save your precious patterns database, especially if you edit many patterns. That way if your device stops working or due to some other technical issue you will be able to restore everything back to the last backup date.

Updating Pro KPD from Ad supported version

If you have previously been using the Ad supported version of KPD you may wish to import your existing patterns and App preferences into the Pro version.
  1. Open the Ad supported version of KPD and choose the 'Backup' option from the options menu on the first screen and close the app.
  2. Open Pro KPD version and from the options menu select 'Restore'.
Note: If you changed the default location of the app's 'knitting' folder in the Ad supported version then you can either:

Use the restore 'Pick File' option and browse to the knitting folder location
Prior to restoring, change the knitting folder location in the Pro version to match the Ad supported version. You change the folder location by selecting 'Set Pattern Folder Location' from the options menu.

The folder location currently being used by the app can be seen at the top of the Help page.

Once you start using the Pro version, you must un-install the Ad Supported version. (But NOT if your Android version is 4.4 or higher and your KPD knitting folder location is on a removable SD card)
If you try and run both of them on the same device with the same "knitting folder" location set, you will run into problems.

Moving KPD to a new 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 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 install a file manager app on both devices like the free "ES File Manager". 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. If the OLD and NEW knitting folder locations match, when you made a note of them above, then press the "Restore" button, if different press the "Pick File" button to navigate to the folder containing the backup.
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 to get KPD Pro this link

Copyright © 2012. ZORAC. All rights reserved reserved