beta
cables is under heavy development.
There might be one or another bug, please let us know about it!
cables DocumentationHow To UseWorking with filesKeyboard ShortcutsUser Interface WalkthroughBeginner TutorialBeginner 1: Drawing A CircleBeginner 2: TransformationsBeginner 3: ColorMore TransformationsintermediateImage CompositionsPost-Processing 3D Scenescommunicationcables APICommunication with an Arduino via SerialCommunicating with Arduino over MQTTExporting And EmbeddingHow to serve files externally and fix CORS headersExporting PatchesExport using the cables command line interfaceExport via IframeExport creating a standalone executableExport to github (pages)Export and deploy to netlifyExport a ZIP fileExternal triggers / functionsUsing variablesPreviewing / uploading exported cables patchescoding opsCreating AttachmentsGeneral op/Port CallbacksPortsDynamic PortsArray PortsBoolean portsInteger Number PortsObject PortsString portsTrigger PortsFloating Point Number PortsGUI/UI attributesHello Op - Part 1LibrariesDeveloping OpsGuidelinesObject PortsWriting ShadersWeb Audio Op DevelopmentHTML and CSS in cablesLightingLightsShadowsWorking with audioBasic Audio SetupWorking with EffectsReal-Time Audio Analyzation & Audio VisualizationOffline Audio Visualization & AnalyzationFAQEmbeddingHow to integrate my cables patch into my CMS (webflow/wix/squarespace/...)?getting a warning when running the patch in electronHow to remove grey rectangles on touch (mobile)?Why doesn't the DownloadTexture op work on iOS?How to disable page scrolling on mobile?Mobile tippsTransparent CanvasFeatures and SupportWill there be support for (animated) GIFs?Hot to report a bug in cablesGeneral questionsLicences and paymentWhat licence do i need to use cables?Will I have to pay for it in the future?How is my work licenced when using cables?Does cables support midi and OSC?ShadertoyTechnical questionsUI / EditorGuide to VR in cablesWebGL1 and WebGL2

Beginner 1: Drawing A Circle

First, we need a project to work with.If you're on the main webpage click the Create tab and then Empty Project.
If you're already in a patch click in the top left tab and select New patch then empty.

To draw a circle, we need two operators:

  1. The MainLoop-op
  2. A Circle-op

1.Add the WebGL-op

  • To create an operator press [esc] – the Select Operator-dialog shows up
  • Now type Main
  • The first entry in the list should be Ops.Gl.MainLoop
  • Press [enter] or click the + button to create the operator

2. Add The Circle Operator

  • To create a new operator and automatically connect it to another op you can pull the yellow output port on the left side with your mouse (drag it out of the operator and release your mouse button).

  • The Select Operator-dialog will appear
  • Type circle, now the entry Ops.Gl.Meshes.Circle should be selected
  • Press [enter] or click the + button to create it

Now it should look like this:

3. Parameters

  • The renderer canvas (on the right side) now shows a circle
  • The parameter panel shows all parameters to tweak the circle
  • Play around with the parameters, for example drag the slider innerradius

Part 2

Continue to Part 2 of the tutorial-series to learn how to use transformations.


help cables get better and edit this file on github