Pool & Billiards Online FAQ

Here you can find answers to questions about how the board works. Use the links or search box below to find your way around.

- Software Guide Index

Software Guide Index

Quick Sheet
Please print out this single page software quick reference sheet, it will help you understand CueTable software quickly

CueTable Blog
We have started a Development Blog recording the current project works

More Help
If you have any software questions about CueTable, please submit them to our Online Support forum

Software Guide in Different Languages

Demo Video

Click Here to view this video in high resolution.

1, Software Basics

Starting the Program

You can open CueTable software by clicking on this icon (Draw Pool Layouts) located at the top of all pages from CueTable.com. The software will then open in a new window.

*If you place your mouse over the button (without clicking) for 2 seconds, you will see its label pops up, saying "Draw Pool Layouts".

Adobe Shockwave Player

Just in case you don't see a pool table in the new window, you will need to install Adobe Shockwave Players to your brower. Download the Full Installer from here and install (< 1 min): http://www.adobe.com/shockwave/download/alternates/#sp

*If you have other troubles opening the table, please check System Requirement Page to make sure your browser has been properly set up.

Scaling the Software Window Size

Once the software is open, resize the browser window to a desired size. CueTable is made to scale up to 100% of the window so you can obtain the maximum viewing area possible.


Mouse Terminology Used Here

Shift-Click: hold down shift key while clicking the mouse
Control-Click: hold down control key while clicking the mouse (for PC users)
Command-Click: hold down control key while clicking the mouse (for Mac users)
Double-Click: having two mouse clicks with very short intervals in between the clicks
Click+Drag: click an hold the mouse down on an item and move it to another location


A hotkey is a keyboard shortcut to trigger functions. For example, go to the table and press <tab > and you will see a row of button showing up. In this case, <tab > is the hotkey for Tools function. The HotKey function is case sensitive, pressing upper cased <Q> is very different from pressing lower cased <q>.

*Make sure the caps lock is off if you want to use hotkeys.



2, Moving Balls

Using The Mouse To Move Balls

Click and Drag 1 ball onto the table, put it inside of the rack triangle. Now, drag it to a place below the table and release the mouse; the ball returns to the ball bin by itself. You can also remove the ball by doing Control+Click (for PC users) or Command+Click (for Mac users).

Using HotKeys To Move Balls

Move your mouse cursor inside of the triangle and press <1>. You will find 1 ball shows up at the mouse location. You can use arrow keys on your keyboard to move it at much finer resolution. To remove it, press <delete>.



Press <1>, <2>, <3>,... <0> to set location for 1 to 10 ball
Press <q>, <w>, <e>, <r>, <t> to set location for 11 to 15 ball
Press <y>, <u>, <i> to set location for cue ball, cue ball A, cue ball B

For finer movements, you can use the arrow keys -<Up>, <Down>, <Left>, <Right> on your keyboard to move a selected ball by 1 pixel at a time. You can also hold down onto the <Shift> key and press the arrow key to move a select ball by 10 pixels.

Other Hotkeys For Balls

TableClear -press <Clear>
Rack 8 -press < * >
Rack 9 -press < ( >
Break 8 -press < & >
Break 9 -press < ) >



3, Drawing Lines With Mouse Clicks

Drawing Straight Lines

Double-click on the cue ball and move the mouse around, you will see a line coming out of the ball with a pointing arrow attached at the end. Click on a spot inside the table to make a pivot point, make sure you see the arrowhead blinks as you hold down the mouse. Click around a few more times.

To stop, Double-Click anywhere or click below of the table.



To extend a line, Double-Click on its arrowhead to start drawing the line again.

Drawing Curve Lines

When drawing a line, Shift-Click on a spot will draw a starting point for a curve.

*You can use the Ghostball function if you would like to change the shape of a line.

Moving A Ball Away From Its Path

To move a ball away from its path, you can either, ctrl-click or cmd-click on the ball, press <delete> key, or move the cursor somewhere else and press the associated hotkey for that ball.


4, Drawing Lines With Keyboard Hotkeys

Drawing Straight Lines

This is the more flexible way to draw lines. Let's try drawing a line to show cue ball hitting 1 ball into a pocket.

First, place1 ball inside the rack triangle and the cue ball near the center of the table. Move the cursor near the aiming spot. You can adjust it later so don't be too precise for now. Press <a> or <=> , a line with a point arrow attached to the end will show up. Move the cursor to where the cue ball will hit the cushion and press <a> or <=>. Move the cursor to where the cue ball will stop, press <a> or <=> again. Click on the 1 ball, move the cursor to a pocket and press <a> or <=>. Now you should have a basic simple diagram.

We have designed two HotKeys: <a> and <=>keys, so both left-handed and right-handed users can add points with ease.



You can always use the Ghostball function (see below) if you would like to change the shape of a line.

Drawing Curve Lines

Let's try drawing a curve line with mouse and keyboard.

Click on the cue ball, move the cursor to another spot for a new point. Instead of pressing <a> or <=>, press <c> this time. Move the cursor again, press <c> once more. You have just drawn a curve.

Deleting Lines

Use these buttons to delete either one line or all lines.

Moving A Ball To The End Of Path

MoveToEnd 1<k> , MoveToEndALL<K>
Use these two buttons set the balls to the beginning or the end of its path. They are very useful when creating a shot-by-shot story.


5, Ghost Ball (Line Indicator / Modifier)

Ghost Ball Intro

"Ghost ball" in billiard world commonly is referred as "an imaginary ball used for aiming in a given shot". In CueTable we have played around the idea and expanded it. Now there are more than one ghost ball for all the ball (14 to be exact).

Ghostballs serve many purposes in CueTable software: to illustrate a ball's traveling path, to indicate points on that path, to act as modifiers for those points and to show the ball spin at that particular point.

Toggle Ghostballs On/Off

Ghostball 1<h>
Ghostball All<H>

Click on a ball and then click on Ghostball 1<h>, you will see some ghostball indicators showing up at each pivot point of that path. To do it for all lines, use Ghostball All<H>.


Changing Line Shape

Click+Drag them around to change the path. Press the arrow keys on your keyboard to move it by pixels.

Setting Curves On A Line

You can change a straight line into a curve line and vice versa. First, turn on ghostball function for the path. Shift-click on any ghostball to make changes.

Adding Or Subtracting Points

Click on a ghostball or the arrowhead, move the cursor to another spot on the table and press <a> or <=> key. You have just added a new point after the previous point.

To remove any point, click on the according ghostball and press <->. You can also Control+Click on it to remove it (Command+Click for Mac users).

Showing Ball Spin Symbols

Click on a ghost ball and then click on BallSpin<f> to turn on a Spin Symbol. Contiue clicking will taggle the icon into different symblos: natural speed spin, high speed spin, a clockwise spin arrow, counter-clockwise spin symbol.

You can Shift-Click+Drag on a Spin Symbol to rotate it to desired angle.


6, Adding More Description To A Layout

Add Text Descriptions

We have created four text fields for you to type in text message.

Click on the AddText<T> when the mouse cursor is within the table, a text box will show up and read to be fill in. Type in some info about the shot, click outside of the box when done, drag the text around to a desirable place. To delete, drag it off the table or press <delete>.

There are a few characters we are using in the program for encoding and decoding reasons

"esc" : will stop the program from running
"&" (shift-7): will be read as RETURN
"@" (shift-2) and "#" (shift-3): will be read as Page Break
"_" (under score): will be read as SPACE
"&ZZ" : will be read as the end of TextBox

Showing A Pool Cue

Click on a ball and then click on PoolCue<Q>. You will see the pool cue show up at a shooting location if there is a line for the ball. Otherwise, it will line up between the ball and the mouse location.

Click+Drag the cue to move it around. Shift+Drag its handle to rotate the cue. To remove it , click on PoolCue<Q> again.


Showing Cue Ball Control

Click on CueBallEnglish<B>. At bottom left of the table you will see a big cue ball showing up, with a blue dot on it and a cue tip next to it. These symbols are for describing details such as cue ball English and pool cue elevation.

You can drag to blue dot around or click anywhere on the big cue ball to show English. Shift-drag the cue tip to show a profile view (viewing from the side) of cue elevation.

To turn this off, click on CueBallEnglish<B> again.

Showing Tangent Line

Tangent line is the line drawn from the contact point that's perpendicular to the line connecting the centers of two touching balls This tool is a great visual aide frequently used in studying how English affects cue ball path in position play.

Let's try placing 1 ball and cue ball close together on the table. Click on cue ball once and then click on TangentLine<J> to show it. You can also manually drag it around or shift-drag its arrow head to rotate. To turn it off, just click on the TangentLine button again, or simply drag it off the table. This function will also work between a Ghostball and a pool ball.


7, Saving Multiple Pages / Import Layouts Manually

Multiple Pages In One URL

CueTable is capable of saving several layouts in one text string. With sequential pages you can tell an interesting story, create puzzles and show comparisons. In this chapter, we will work on a simple exercise to help you understand how to use the page tools. You can save up to 9 pages of layouts in one string of data codes.

Saving Layout On Current Page

Bring cue ball, 1 ball and 2 ball onto the table, draw lines to show cue ball hits 1 ball into a pocket. Click on SavePage<S>. You have just saved page #1.

Saving Layout To A New Page

Click on MoveToEndALL<K>, remove 1 ball and src="clear all lines. Draw new lines to show cue ball hits the 2 into a pocket. click on AddToNewPage<D> when done. You have just saved the layout onto a new page.


you are on page 2 / 2 as shown in the page indicator. Use the arrow next to the page number <page up>, <page down> button to navigate.

CueTable is capable of saving several layouts in one text string, so you can us sequential pages to tell an interesting story. Up to 9 pages of layouts can be saved in one URL string.

Cut / Insert Layouts At The Current Page

To cut (extract ) a single page off total pages, use CutPage<X>.

To insert a single page data from the computer clipboard onto a new page, use InsertPage<V>.

Import Layouts Onto CueTable

If you have the link but no network connection, you can use ImportData<I>.

For the die-hard WeiTable fan, you can copy any WeiTable data starting "Start(...." and use ImportData<I> to display the layout .


8, Display Layout In Forum Posts / Email Layouts

Adding A Layout To A Post

1, Once you have drawn your layout, click on CopyLayoutURL<E> in the lower right corner.
2, Go to the forum post editor
3, Do a computer paste (Ctrl-V or Comd-V).
4, Highlight the entire URL text you just pasted.
5, 6, Click on the layout button in the editor to wrap CueTable tags around the Layout URL.
7, Submit the post now. The layout will be shown automatically on a CueTable Player in your post.

*When posting in CueTable.com, you will not need to do step 4 , 5, 6. Our sever can automatically translate your layout URL into a layout diagram. However, it is a good idea to wrap the tags when you have a really long URL. This will avoid the html break-ups.

Editing A Layout From A Post On CueTable.com

1, Re-arrange the objects on the layout.
2, Click on Export Layout URL in the lower right corner once, go to your post and do Menu > Edit > Paste.

Send A Layout In An Email

1, Once you have drawn your layout, click on CopyLayoutURL<E> in the lower right corner.
2, Go to the email editor
3, Do a computer paste (Ctrl-V or Comd-V).
4, Send it to your friend.
5, When your friend click on the URL, your layout will show up.



Special CueTable Player For Other Forums On The Web

We have created a special version of the CueTable called CueTable Player. This player only displays the layout without editing functionalities. It is also suitable for multiple posts in a discussion thread because it runs faster and loads quicker.

The player also reads WeiTable layout data from the html codes. All the existing WeiTable layouts in the forum will be displayed.

Editing A Layout From A Post on Other Forums Than CueTable.com

1, Click on the Edit <A> button located at the lower right side of the CueTable Player. This will open it in the regular CueTable software.
2, From here, you can then adjust ball position or change things around. Save the changes and paste it in reply post.


9, Adding CueTable Layout To Your Blog / Web Page

Add Layout Html To A Post

It is quite simple to add a layout to your blog:

1, Once you have drawn your layout, click on CopyLayoutHtml<M> in the lower right corner.
2, Go to the blog html editor
3, Do a computer paste (Ctrl-V or Comd-V)
4, Add any additional text
5, Submit and check the result


Html Specification

The copied html codes uses <iframe> tags to embed CueTable object:

<iframe src=
"http://CueTable.com/P/Player/?@3HGys3IMGd4PFdI@" noresize="noresize" marginheight="0" marginwidth="0" frameborder="no" width="600" height="400"></iframe>

The layout embed html works in both Blogger and WordPress blogs. It also works in personal html web pages. Just in case the content area is not wide enough, you can lower the width and height value, just keep it around 3:2 ratio. For example, try using width="480" height="360" if your blog content area is less than 600px wide.

*For more info on blogging with CueTable, please check CueTable Blog Intro on Blogger.com


10, Imaging / Printing

Export Table Layouts For Printing

We highly recommend using Microsoft Word on PC (TextEdit on Mac) because these software can include several pictures in one single document.

If you'd like to print a layout in full page size, open Menu: File: Page Setup. Set the print orientation to Horizontal (or Landscape) and set the printing size to Fit to Page

Save Table Layouts Into Images

Press on the ScreenCapture<P>. It will take a snapshot of the table onto computer clipboard.

Your can then go to any imaging software (Paint for PC, Preview for Mac) and save it in a picture format (GIF, JPG, TIF, PNG, etc.)


Changing Table Appearance

Clicking on Black&White<W> will switch the table between color and black & white mode. black & white mode is excellent for printing.

Clicking on ToggleGrid<G> will turn the grid lines on or off.

*You must export the layout into a image software in order to print. It is not possible to print it directly from a web browser .


A, Software Button & Short Cut Reference

Quick Reference Sheet

To learn CueTable faster, download CueTable Quick Reference Sheet here: http://cuetable.com/FreeStuffs/CueTableQuickReferenceSheet.pdf

Button Description

Tools<tab> Opens/Closes all tool windows around the table.
OpenHowTo<?> Opens CueTable Howto Page in a new browser window.
TableClear<clear> Clears everything off the table.
Rack 8 < * >
Rack 9 < ( >

Creates a 8 ball / 9 ball rack layout.
Break 8 < & >
Break 9 < ) >

Creates a random 8 ball/9 ball layout after the break shot. THis is a fun thing to do when you feel like a quick run-out exercise.
LineMode<b> Toggles the last edited line between thin line, thick line and shaded box region. It also indicates the color for the line.
Delete 1 Line<n>

Removes last selected line/all lines
MoveToEnd 1<k>

Move the ball/balls to the end point of last selected line/all lines
Ghostball 1<h>
Ghostball All<H>

Shows/Hides Ghostball for last selected line/all lines.
CueBallEnglish<B> Shows/Hides cue ball english indicator .
PoolCue<Q> Shows/Hides pool cue.
TangentLine<J> Shows/Hides tangent line symbol for the last selected ball or ghostball. The last ball or ghostball must be contacting another ball for this function to work.
AddText<T> Adds an editable text box to the table. Click outside the TextBox to stop editing. Click+Drag to move it around. Shift-Click to edit it again. Press <delete> or move it off the table to delete. There are 4 text boxes available.
ImportData<I> Reads data that's previously copied onto computer's clipboard. It will read data strings created by either CueTable or WeiTable. an security alert will show when this is used, press "OK" to continue.
CopyLayoutURL<E> Encodes all page data and generates a single URL link to the clipboard to be pasted later. If you are editing multiple pages, be sure to SavePage first to make sure all the changes are recorded.
SavePage<S> Saves the table layout and comments to the current page. It also copies the single page layout onto the clipboard.
AddToNewPage<D> Saves the table layout and comments to a new page. It also copies the single page layout onto the clipboard.
CutPage<X> Cuts the current page off. It also copies the single page layout onto the clipboard.
InsertPage<V> Inserts a copied layout onto a new page.
ScreenCapture<P> Takes a snapshot of the table layout to the clipboard. You can then paste it in a paint software for print or design use.
ToggleB/WMode<W> Toggles Black&White mode on and off; useful for printing or studying the layout.
GridSwitch<G> Toggles the grid on and off; useful for printing or studying the layout.


Ball Starts or restarts drawing line. Double-click again to stop drawing.
Arrowhead Starts drawing the line again from the arrowhead location. Double-click anywhere to stop drawing
Ghostball Toggle through different ball spin symbols



Sets the line mode for associated line.

Arrow Head Toggles the ghostballs on/off.
Ghostball Toggles its point to curve/straight mode.
Spin Indicator Rotates the symbol.
Text Box Makes it editable.
Pool Cue, Cue Tip, Tangent Line Rotates the symbol.

Control+Clicking (For PC), Comand+Clicking (For Mac)

Ball, Text Box,Pool Cue, Tangent Line Removes it off table.
Ghostball Removes it off table and deletes its point.
Arrow Head Deletes the line.

General HotKeys

<clear> Clears everything off the table without effecting the saved pages.
<tab> Opens toolboxes around the table.
<?> Opens CueTable HowTo page in a new window.
<page up>, <Page Down> Moves up or down the pages.

HotKeys for moving balls

<1>, <2>, <3>... <9>, <0> Moves 1, 2, 3...9, 10 ball to the mouse location.
Moves 11, 12, 13, 14, 15 ball, cue ball, cue ball A, cue ball B to the mouse location.
arrow keys Moves the last picked ball by 1 pixel.
shift+ arrow keys Moves the last picked ball by 5 pixel.
<delete> Moves last picked ball off the table.

HotKeys for drawing lines

<a> or <=> Adds a pivot point.
< - >
Deletes selected pivot point.
arrow keys Moves selected pivot point by 1 pixel.
shift+ arrow keys Moves selected pivot point by 5 pixel.

Deletes a ghost ball if it is clicked on. Deletes the line if its arrow head is clicked on.


B, Blank Table Layout Template

Here are some free table layout templates in PDF format for you to bring to the pool room the next time.

Right-Click or Control-Click on one of the icons and choose "Save Link As..." to save it to your computer. They are pre-made PDFs to fit on regular 8.5 x 11 papers. If you'd like to have them in different sizes, use the scale function in Page SetUp menu.

For Pocket Billiard


For 3 Cushion Billiard


C, System Requirement

Operating System

PC Win98, WinXP, Windows Vista (32 bit)
Mac OS X
Linux Wine 0.9 ( More Info )


PC - Pentium3 400mhz with 256MB of RAM
Mac - G3 400mhz with 256MB of RAM

Display 1024 x 768 Recommended

Network Connection to the internet is needed. CueTable's size is under 150k. Loading takes 5 sec on WIFI connection.

Browsers Tested

Internet Explorer 7.0

Mozilla Firefox 2.0
Netscape Navigator 7.1
Opera 8

Mozilla Firefox 2.0

Safari 2.03
Internet Explorer 5.2

Opera 8.5


Browser Plug-In's

Adobe Shockwave Player
CueTable is a shockwave movie created with Adobe Director. Shockwave has been one of greatest free web plug-in's for multimedia use over past 14 years. To install full version of Adobe Shockwave, please visit http://www.adobe.com/shockwave/download

478 million Web users have installed Adobe Shockwave Player around the world. They now have access to some of the best the Web has to offer - including 3D games and entertainment, interactive demonstrations, and online learning applications.

Safety Note
Please note we take internet security seriously. We at CueTable will not leave or install any spywares, preference files or cookies onto your computer. Abusolutely nothing at all.

CueTable's hosting html page ueses JavaScript to pass the attached parameters in the url to dynamically display layouts recorded by others.

CueTable Online Tech Support

If you run into any technical problems using CueTable on your computer, please submit your questions here:



D, Common Tech Isssues

Common Issues

Software Inactive
Please be aware that pressing escape key will instantly halt all program functions. You will have to restart CueTable again by clicking on the web browser's refresh/reload button.

URL data strings get too long
Sometimes the URL data strings can get really long. ShorterLink.com can take a long web URL into a database and provide an "indexed URL" for them. It is free for non-commercial use.

Here is an example: http://shorterlink.com/?H4PR6A

Slower Hardware Response

If you notice an unusual slow-down in the graphic performance, try one of the followings:

- Wait for the feedback message after moving a ball or adding a point.
- Make sure the key is pressed for at least half a second when using hotkeys.
- Have just one CueTable running at a time.

Security Alert

When you are trying to bring in table layouts using ImportData<I>, a security alert will show up:

"Do you want to provide the contents of your clipboard to this movie?"

This safety question is to protect you from revealling any personal information by accident. Please rest assured. Internet security is a very sensitive issue. We at CueTable will not gather any secrets from our users. We will not leave or install any spywares, preference files or cookies onto your computer either.


Activate ActiveX in Internet Explorer

In the middle of May 2006. Microsoft has "Updated" their browser. People now have to activate the Active-X Control when opening any interactive media (including WeiTable and CueTable) in Internet Explorer. This does not happen on any other browsers such as Firefox or Netscape. For more info on ActiveX please check:

- How to Disable Active Content in Internet Explorer
-Microsoft IE ActiveX Update
- ActivateActiveX
- http://msdn.microsoft.com/workshop/author/ dhtml/overview/activating_activex.asp
- http://www.adobe.com/devnet/activecontent/ #captivate_before.
- http://www.adobe.com/cfusion/knowledgebase /index.cfm?id=tn_8151
- http://support.microsoft.com/kb/q157044/

CPU Hogging

The Windows Task Manager CPU usage meter shows 100% utilization when CueTable is running. This affect is see since CueTable contains Flash content. Our tests have shown that it doesn't occupy all the CPU's processing power or prevent you from running other software.

CueTable Online Tech Support

If you run into any technical problems using CueTable on your computer, please submit your questions here:



Search FAQ

Select this option if you would like your search to look in the text of FAQ items as well as their titles.

Select an option here to specify how you would like your search query to be treated. 'Any words' will return the most numerous but possibly least relevant results, while 'Complete phrase' will return only results that contain exactly what you are searching for.