CamView for Wheesy and Jessie

CamPY for LinuxCNC - Camera Edge Finder

This will show you how to install on Debian Wheezy with LCNC 2.7.x and up

1.    Install Prerequisites
--------------------------------------------------------------------------------
Copy the zip file to the folder:  /home/user_name/linuxcnc/configs  

Right click on the zip file and select:  "Extract here"
You can now safely delete the zip file.

Open the CamPY directory, right click in the window and select "Open Terminal Here"

You need to install these modules if not allready installed, the commands are:
(copy and paste one at a time to the newly opened terminal window)

    sudo apt-get install python-lxml
    sudo apt-get install qv4l2
    sudo apt-get install python-opencv
    sudo apt-get install v4l-utils
    sudo apt-get install v4l2ucp

2.    Test Camera
--------------------------------------------------------------------------------
In the terminal type:  qv4l2  This will open a new window that you can use to test
your camera.    

3.    Run Install Script
--------------------------------------------------------------------------------
To place the required links and configuration lines into the appropriate system files,
paste the following into the terminal:

    sudo python CamPY_setup.py

This should complete with output simillar to the following:

********************************************************************************
qv4l2 is installed
python-opencv is installed
v4l-utils is installed
v4l2ucp is installed

wait, processing...
link to camview.py already exists in  /usr/lib/pymodules/python2.7/gladevcp

"from camview import CamView" already exists in /usr/share/pyshared/gladevcp/hal_pythonplugin.py

link to camview.py already exists in  /usr/share/pyshared/gladevcp

glade-widget-class named CamView added to /usr/share/glade3/catalogs/hal_python.xml

glade-widget-class-ref named CamView added to /usr/share/glade3/catalogs/hal_python.xml

/usr/share/glade3/catalogs/hal_python.xml saved
********************************************************************************

4.a.    Gmoccapy Ini File Edit.
--------------------------------------------------------------------------------
Open the gmoccapy.ini file in your machine's config folder and under the
[DISPLAY]  section paste these lines:

EMBED_TAB_NAME = Camera
EMBED_TAB_LOCATION = ntb_preview
EMBED_TAB_COMMAND = gladevcp -x {XID} camview.glade

Save and close the file.

4.b.    Axis Ini File Edit.
--------------------------------------------------------------------------------
Open the axis.ini file in your machine's config folder and under the
[DISPLAY]  section paste these lines:

EMBED_TAB_NAME = Camera
EMBED_TAB_COMMAND = gladevcp -x {XID} camview.glade

Save and close the file.

5.    Copy Files To Your Config.
--------------------------------------------------------------------------------
Open the CamPY folder in your configs folder and copy the following file to your
machine's config folder:

camview.glade

6.    Finishing Touches.
--------------------------------------------------------------------------------
The camview.py file has some hard coded MDI mode G code subroutines to automaticly
move between the spindle location and the camera location.  It takes the X and Y
coordinates from tool # 99 in the tool table.  You will need to set your offsets
into this tool to make these buttons to work correctly.

The camview.glade file has some editable fields, you may edit the following fields
in the camview.glade file that is in your machine's config folder:
(edit the file by right click on file and select: Open With "Mousepad")

        <property name="camera">0</property>
        <property name="draw_color">#FFFF00000000</property>
        <property name="frame_width">640</property>
    <property name="frame_height">480</property>
    <property name="circle_size">150</property>
    <property name="number_of_circles">5</property>
    <property name="radius_difference">10</property>
    <property name="autosize">False</property>
    <property name="cam_settings"></property>

Most of these fields should be self explanatory, the "draw_color" currently only
works with 'FFFF' or '0000' values, ie: FFFF0000FFFF would be ok, FFFF1111FFFF would
be the same as FFFFFFFFFFFF.  The "cam_settings" is for adding additional options to
the v4l2-ctl module.  See the forum for help with this.


Many Thanks from  Jacob Bogenschutz (bogie6040)  to the following:

Norbert Schechner (newbynobi)
Fernand Veilleux (FernV)
Slavko Kocjancic (eslavko)

They deserve all the credit, I just tweeked on they're stuff and put it together.