> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/getting-started/your-very-first-project/basics.md).

# Basics

In this part, you will load a video, add your first blocks, connect sockets, run one frame at a time, and select the golf ball as a reference.

{% stepper %}
{% step %}

### Download the sample video

Download the sample video below.

{% file src="/files/La3aUpMZcBZ3rffKrjGz" %}
{% endstep %}

{% step %}

### Add the Video block

Return to AugeLab Studio and drag the **Video** block from the blocks bar into the scenario.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-dafc80e37c6940d0b30c62b78a64febb25192b9d%2Fvideo-drag-drop-1.webp?alt=media)

Click **Select Video File** inside the block and load the video.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-56117fb139ca99e875cf3dc3ed92de14910aa5ec%2Fvideo-0.png?alt=media)

Disable real-time streaming by clicking **Real-time**.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-bae2ef5b531c7387c19dd1906e373e4d5c2423b8%2Fvideo-2.png?alt=media)
{% endstep %}

{% step %}

### Add Image ROI Select

Go to **Detections/Shapes** in the blocks bar and drag **Image ROI Select** into the scenario.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-3e24a6aa2f9b9fab2e8e4741b728e59dfb65c2c0%2Fvideo-3.png?alt=media)

When it is first added, the block is empty because no image is connected yet.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-c3a13256073cce3f828d696b7273a811887f1b69%2Fvideo-4.png?alt=media)
{% endstep %}

{% step %}

### Connect the blocks

Click the **Image** output socket of the **Video** block.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-ec787e5a37c751fe84fefa2c25bb5693b01cc9f8%2Fvideo-5.png?alt=media)

Move the cursor to the **Image** input socket of **Image ROI Select** and click again to create the connection.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-b17e30540126b616725c611126071374a23a1e57%2Fvideo-6.png?alt=media)
{% endstep %}

{% step %}

### Run one frame

Press **Run Step** from the menu bar to process one video frame.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-9d6b7bd0cad8ae9f318cb28c71d771eded1c8fed%2Fvideo-7.png?alt=media)

You should now see the frame in the ROI block.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-2e8dc28184e89ee006b1597949ac825bc20129ce%2Fvideo-8.png?alt=media)
{% endstep %}

{% step %}

### Select the golf ball

Click, drag, and release around the golf ball to define the ROI.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-fe27fa71eeb889284e76ccb760bd3f0718d5ef4d%2Fvideo-roi-select.webp?alt=media)

This selected area will be used as the reference in the next part.
{% endstep %}

{% step %}

### Move and zoom the scenario

Press and hold the middle mouse button to move around the scenario.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-a59900cb7403e24fba231ad901a853acbe16587f%2Fmiddle-mouse-move.webp?alt=media)

Use the mouse wheel to zoom in and out.

![](https://63608322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH8gla5D8g5pQAK8IzR8%2Fuploads%2Fgit-blob-a12c8578ba53209783b56cfd1003124e87f41d6c%2Fmiddle-mouse-zoom.webp?alt=media)
{% endstep %}
{% endstepper %}

You now know the basics: adding blocks, connecting sockets, running a step, selecting an ROI, and navigating the scenario. Continue with the detection page.
