# AnySurface



## Cameras

### Consumer USB cameras
Otherwise known as the UVC standard. 
Most platforms can stream the video from a UVC camera, not all have support for changing settings. 

#### Camera Setting Browser Support
| Platform | Supported | Settings |
| :-- | :--: | :--: |
| Android Chrome | ✅ | ✅ |
| Android Firefox | ? | ? |
| Windows Chrome | ✅ | ✅ |
| Windows Firefox | ✅ | ✅ |
| Windows Edge | ✅ | ✅ |
| Linux Chrome | ✅ | partial |
| Linux Firefox | ✅ | partial |
| Mac Chrome | ✅ | ❌ |
| Mac Firefox | ✅ | ❌ |
| iphone | ? | ? |

#### UVC Server
The UVC nodejs server was written to address the shortcomings of the browser support on mac. At the moment it only seems to work with the Elgato camera on mac and linux. [https://github.com/m0ose/uvcc-webserver](https://github.com/m0ose/uvcc-webserver)


### IP Cameras
The Pointgrey camera is accessed using a python server. It serves video and settings to port 8080. [https://github.com/RedfishGroup/laser-server/](https://github.com/RedfishGroup/laser-server/)
Other IP cameras, like Axis Cameras, should be should work using the ip camera interface. 

### Classes 
#### CameraInterface
The camera class is the base class for all cameras. It contains an imageLoader and a settingsInterface. The imageLoader is responsible for loading the image and the settingsInterface is responsible for changing the settings of the camera.

TODO example.



```
             +------------------------------------------+
             |                                          |
             |               Camera Interface           |
             |                                          |
             +----+---------------------------------+---+
                  |                                 |
                  |                                 |
+-----------------+---------+                +------+------------------+
|                           |                |                         |
|      Image Loader         |                |  Settings Interface     |
|                           |                |                         |
|                           |                |                         |
| a IPImageLoader           |                | a IP Settings           |
| b UVCImageLoader          |                | b UVC Settings          |
|                           |                | c Browser               |
|                           |                |                         |
+---------------------------+                +-------------------------+

```

#### ImageLoader
The imageLoader is responsible for loading the image from the camera. It is an abstract class and needs to be implemented for each camera type.
* IP Camera: [IPImageLoader.js](./lib/ImageLoaders/IPImageLoader.js) By default looks for http://127.0.0.1:8080/shot.jpg but can be changed.
* UVC Camera: [USBImageLoader.js](./lib/ImageLoaders/USBImageLoader.js) Uses the browser to load the image.

#### SettingsInterface
The settingsInterface is responsible for changing the settings of the camera. It is an abstract class and needs to be implemented for each camera type.
* IP Camera: [IPLaserServerSettingsInterface.js](./lib/SettingsInterfaces/IPLaserServerSettings.js) Used by the Pointgrey camera.
* UVC Camera: [UVCServerSettings.js](./lib/SettingsInterfaces/UVCServerSettings.js) Uses the UVC server to change the settings.
* Browser: [BrowserUSBSettings.js](./lib/SettingsInterfaces/BrowserUSBSettings.js) Uses the browser to change the settings.

#### Dummy Classes
The classes inherit from the dummy classes. 
* [DummyImageLoader.js](./lib/ImageLoaders/DummyImageLoader.js)
* [DummySettingsInterface.js](./lib/SettingsInterfaces/DummyCameraSettingsInterface.js)

## Brightest Point
Find the brightest point. This is historically the most susceptible to noisy lighting. Anything with a 🕷️ emoji is done in the webworker.
[lib/Laser/findBrightestPoint.js](./lib/Laser/findBrightestPoint.js)

The brightest point is calculated using the following steps:
1. An image is loaded from the camera, and sent to the webworker.
2. 🕷️ If background subtraction is on, the background image is subtracted from the current image.
3. 🕷️ The brightest point in the image is searched for.
4. 🕷️ If background subtraction is on, a percentage of the background image is added to a percentage of the current image.
5. 🕷️ Return the brightest point value and coordinates.
6. Do it again.

# Surface

## Correspondance
A 2D mapping between camera and projector coordinates. This is calculated using Grey Code. [lib/Scan/correspondance.js](./lib/Scan/Correspondance.js)