Support for inkBook 2
Contact
Requirements
  • Mac OS X 10.5.0 or higher.
  • An InkWell aware input device that properly issues tablet data. All Wacom USB tablets work well.
Inking
In order to ink, handwriting recognition must be turned on in the Ink system preference pane. ("Allow me to write anywhere" does not need to be checked.) inkBook will offer to take you to the Ink system preference if handwriting recognition is not turned on. However, the Ink system preference pane is not available unless you have an ink-aware input device attached.

If you use a mouse, track pad, or other non ink-aware device, inking will not occur. These devices automatically work in the "Edit" mode, allowing you to select and drag objects around. (See the "Ink Modes" section.)

Using your pen on your tablet, simply write on the lined paper. When you pause from writing, your text will be recognized and attached to your ink. Hold the space bar and you will see the recognized text appear in a bubble above each word.

If you tap the pen on the tablet and do not drag the pen across the tablet, inking will not occur. Instead, a click in the "Edit" mode is issued. This makes it easy to select objects without having to set inkBook to the "Edit" mode. Also, if you touch the pen to the tablet and hold it there for a moment before dragging, the "Edit" mode will temporarily be turned on while you drag until you take the pen off the tablet. This allows you to perform a drag selection, or to drag selected ink objects.

Modes
There are five different modes for editing the contents of your inkBook document. You can set which mode to use via the "Mode" menu or "Mode" tool bar control.
  • Ink (i): In this mode, your ink strokes are broken up into words and the recognized word is attached to ink of that word.
  • Sketch (s): In this mode, all of your recent ink strokes are combined together into one object. This object is similar to a graphic image in that there is not a recognized word attached to it. However, the raw ink is maintained and the sketch object can be converted to a text object or combined with other ink.
  • Text (t): In this mode, you can draw text boxes that you can type in.
  • Edit (a): In this mode, inking is disabled and you can select and drag objects around without accidentally drawing.
  • Erase: In this mode, a special type of gesturing is turned on that deletes objects under your ink. You can not directly turn this mode on. It is automatically set when the eraser brush is used. (See the "Brushes" section.)
Gestures
Gestures are a means of giving commands to inkBook with a simple, single stroke of ink. They can save you a lot of time and hassle associated with going to the menu bar or keyboard. Click on the "Gestures" tab of the "Ink" System Preference pane for a demonstration on how to write different gestures.

If you pause after making a single stroke, InkWell will often recognize that as a gesture. When InkWell recognizes a gesture, the ink you just wrote disappears, and inkBook performs the command. If InkWell does not recognize your stroke as a gesture, it will try to recognize it as a character.

By default, inkBook lets InkWell recognize gestures when in inking mode, but not when in sketching mode. You can change this in inkBook's preferences.

inkBook recognizes the following gestures:

  • Undo: This performs the "Undo" command from the "Edit" menu.
  • Cut: This performs the "Cut" command from the "Edit" menu. Place the selected ink objects on the clipboard.
  • Copy: This performs the "Copy" command from the "Edit" menu. Place a copy of the selected ink objects on the clipboard.
  • Paste: This performs the "Paste" command from the "Edit" menu with a slight twist. Paste the contents of the clipboard centered at the location of the beginning of the Paste gesture stroke. inkBook supports the pasting of graphics, PDFs and other inkBook ink objects.
  • Clear: This deletes all of the ink objects under the gesture. This is exactly the same as the delete gesture, just performed with a different stroke.
  • Join: This joins the two ink objects under the locations of the beginning and ending of the join gesture.
  • Horizontal Space: This inserts a page. There are actually two variations of this gesture. A left horizontal space, where the carat is at the beginning of a stroke, and a right horizontal space, where the carat is at the end of the stroke. A left horizontal gesture will insert a blank page before the current page, and a right horizontal gesture will insert a blank page after the current page.
  • Delete: This deletes all of the ink objects under the gesture. This is exactly the same as the clear gesture, just performed with a different stroke.
  • Select All: This performs the "Select All" command from the edit menu.

Brushes
There are a few different brushes that you can "ink" with. Click on the "Pen Case" icon (picture of a cup with pens sticking out) on the document window's tool bar to gain access to the different brushes and settings for each brush.

To switch to a different brush simply click on the name of the brush in the list. There are a group of controls that will appear under the list for the selected brush. You can use these controls to change the settings of the selected brush.

Pencil: This is the default brush. The harder you press the pen to the tablet the darker the mark on the paper will be. You can change the type of "lead" in the pencil from soft to medium to hard. The harder the type of lead used, the harder you have to press to make the darkest line possible. Likewise, if you use a softer type of lead, you need less pressure to make a dark line, however, it may be difficult to draw a light line. You can also change the width of the pencil tip from a very fine point to a large point. Finally, click on the color well to change the color of the lead in the pencil. (Note: If the color palette is already open when you switch to this brush, you will need to click on the color well for this brush to change the color used by this brush.)

Paint Brush: Unlike the pencil, the paint brush always paints the same shade of color. By varying the pressure of the pen on the tablet, you can change the size of the paint brush stroke between the minimum size and the maximum size you set with the slider controls. You can also change the color on the paint brush by clicking on the color well. (Note: If the color palette is already open when you switch to this brush, you will need to click on the color well for this brush to change the color used by this brush.)

Calligraphy Pen: The calligraphy pen is very similar to the paint brush. However, while the the paint brush has a round tip, the calligraphy brush has a flat tip set at a 45 angle. You can use this to draw very pretty letters and words. However, the more ornate the letters of your words are, the less likely that InkWell will recognize it. Like the paint brush, you can set the minimum and maximum size of the tip of the calligraphy pen, and the amount of pressure you apply to the tablet will determine the size of the brush tip, within these boundaries, as you ink. To mimic a true calligraphy pen, and get best results, it is recommended that you keep the minimum and maximum size of the brush tip fairly close together. If you have a tablet that supports tilt, the angle of the calligraphy pen tip is determined by the angle you hold your pen. (Wacom's Intous and Intous2 line of tablets support tilt.) You can also change the color on the calligraphy pen by clicking on the color well. (Note: If the color palette is already open when you switch to this brush, you will need to click on the color well for this brush to change the color used by this brush.)

Highlighter: The highlighter brush works very similarly to a real highlighter. The highlighter has either a wide horizontal tip, or a wide vertical tip. You can set the width of the tip and its direction, however, the highlighter is not pressure sensitive. You can also change the color on the highlighter by clicking on the color well. (Note: If the color palette is already open when you switch to this brush, you will need to click on the color well for this brush to change the color used by this brush.) In addition to the color of the highlighter, you can also set the amount of transparency in the highlighter ink. That is, you can set how "see through" the color is. The highlighter automatically turns off gesture recognition and temporarily puts inkBook into "Sketch" mode. That means that neither inkBook, nor inkWell, will ever try to recognize your highlighter ink as a gesture, or as text immediately after you write it.

Eraser: The eraser is used to delete ink objects. inkBook is not a "painting" application, so you can not erase part of a line. You must erase a complete object at a time. The eraser actually works like the "Clear" or "Delete" gestures. That is, all objects under the eraser markings will get deleted. Often it is quicker and easier to use the clear or delete gesture to remove any unwanted objects. However, if you are using a mode or a tool that does not support gestures, or you have gesture recognition turned off in the preferences, the eraser brush can be very useful. Best of all, you can tell inkBook to temporarily use the eraser brush by simply flipping your pen over. Then, when you flip you pen back to the tip, inkBook will switch back to the last brush you where using. (Note: Your tablet must support recognizing when the pen is flipped. It must also properly report this in the proximity event. Some tablets do not do this correctly. All Wacom tablets support this feature. However, some Wacom transducers will not worked when flipped over. You can set a side switch to "Auto Erase" in the Wacom control panel for such transducers to mimic flipping the pen. inkBook will not notice the difference.)

Creating your own theme
All user themes go into ~/Library/Application Support/inkBook/Themes
(You can also put them in the /Library/....)

An inkBook theme is:
  • A folder that has a .ibtheme extension
  • The folder contains a file called Info.plist
  • The Info.plist is a standard plist file...
The following keys are required:
  • identifier - reverse dns unique id for the theme (uniqueness is enforced.) com.yourco.blah
  • displayName - Name that is used in the UI
Optional keys:
  • backgroundImage - relative path to image in the .ibtheme folder (include file extension)
  • backgroundImageStyle - String, either "tile", "stretch", "border" (tile is default)
  • backgroundColorRed - Number 0.0-1.0 red component of background color (if no image or image has clear spots)
  • backgroundColorGreen - Number 0.0-1.0 green component of background color (if no image or image has clear spots)
  • backgroundColorBlue - Number 0.0-1.0 blue component of background color (if no image or image has clear spots)
  • backgroundImageBorderRect - String "{{left, bottom},{right, top}}" If the style is "border" then this key slices the image into 9 pieces. The 4 corner pices are fixed with and height. The middle pieces are tiled to fit the document size.
  • preferredSize - String "{width, height}" The preferred size of a document that uses this theme. You can also specify "fullscreen", "portrait", "landscape", or "imageSize". Portirait and landscape use the current printer setup adjusted to be either portrait or landscape. imageSize sets the preferred size to the same size of the image specified with the backgroundImage key. If you exclude this key, then the current page setup is used.
All Content Copyright © 2006-2012 Mage Software. All Rights Reserved.