notebooks/Path-Overview.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Path Overview\n",
    "`Path` contains `Lines` and `Curves` which can be stroked or filled. `Contour` is composed of a series of connected `Lines` and `Curves`. `Path` may contain zero, one, or more `Contours`. Each `Line` and `Curve` are described by `Verb`, `Points`, and optional `Path_Conic_Weight`.\n",
    "\n",
    "Each pair of connected `Lines` and `Curves` share common `Point`; for instance, `Path` containing two connected `Lines` are described the `Path_Verb` sequence: `Path.kMove`, `Path.kLine`, `Path.kLine`; and a `Point` sequence with three entries, sharing the middle entry as the end of the first Line and the start of the second Line.\n",
    "\n",
    "`Path` components `Arc`, `Rect`, `Round_Rect`, `Circle`, and `Oval` are composed of `Lines` and `Curves` with as many `Verbs` and `Points` required for an exact description. Once added to `Path`, these components may lose their identity; although `Path` can be inspected to determine if it describes a single `Rect`, `Oval`, `Round_Rect`, and so on.\n",
    "\n",
    "### Example"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import skia\n",
    "from IPython.display import display, Image\n",
    "\n",
    "def show(draw):\n",
    "    surface = skia.Surface(256, 192)\n",
    "    draw(surface.getCanvas())\n",
    "    image = surface.makeImageSnapshot()\n",
    "    display(Image(data=image.encodeToData()))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "def draw(canvas: skia.Canvas):\n",
    "    paint = skia.Paint()\n",
    "    paint.setAntiAlias(True)\n",
    "    path = skia.Path()\n",
    "    path.moveTo(124, 108)\n",
    "    path.lineTo(172, 24)\n",
    "    path.addCircle(50, 50, 30)\n",
    "    path.moveTo(36, 148)\n",
    "    path.quadTo(66, 188, 120, 136)\n",
    "    canvas.drawPath(path, paint)\n",
    "    paint.setStyle(skia.Paint.kStroke_Style);\n",
    "    paint.setColor(skia.ColorBLUE)\n",
    "    paint.setStrokeWidth(3)\n",
    "    canvas.drawPath(path, paint)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`Path` contains three Contours: `Line`, `Circle`, and `Quad`. `Line` is stroked but not filled. `Circle` is stroked and filled; `Circle` stroke forms a loop. `Quad` is stroked and filled, but since it is not closed, `Quad` does not stroke a loop."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "show(draw)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`Path` contains a `Path_Fill_Type` which determines whether overlapping `Contours` form fills or holes. `Path_Fill_Type` also determines whether area inside or outside `Lines` and `Curves` is filled."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [],
   "source": [
    "def draw(canvas: skia.Canvas):\n",
    "    paint = skia.Paint()\n",
    "    paint.setAntiAlias(True)\n",
    "    path = skia.Path()\n",
    "    path.moveTo(36, 48)\n",
    "    path.quadTo(66, 88, 120, 36)\n",
    "    canvas.drawPath(path, paint)\n",
    "    paint.setStyle(skia.Paint.kStroke_Style)\n",
    "    paint.setColor(skia.ColorBLUE)\n",
    "    paint.setStrokeWidth(8)\n",
    "    canvas.translate(0, 50)\n",
    "    canvas.drawPath(path, paint)\n",
    "    paint.setStyle(skia.Paint.kStrokeAndFill_Style)\n",
    "    paint.setColor(skia.ColorRED)\n",
    "    canvas.translate(0, 50)\n",
    "    canvas.drawPath(path, paint)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`Path` is drawn filled, then stroked, then stroked and filled."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "show(draw)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`Path` contents are never shared. Copying `Path` by value effectively creates a new `Path` independent of the original. Internally, the copy does not duplicate its contents until it is edited, to reduce memory use and improve performance."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "`Contour` contains one or more `Verbs`, and as many `Points` as are required to satisfy `Path_Verb_Array`. First `Path_Verb` in `Path` is always `PathVerb.kMove` each `PathVerb.kMove` that follows starts a new `Contour`.\n",
    "\n",
    "### Example"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "def draw(canvas: skia.Canvas):\n",
    "    font = skia.Font()\n",
    "    paint = skia.Paint()\n",
    "    paint.setAntiAlias(True)\n",
    "    canvas.drawString(\"1st contour\", 150, 100, font, paint)\n",
    "    canvas.drawString(\"2nd contour\", 130, 160, font, paint)\n",
    "    canvas.drawString(\"3rd contour\", 40, 30, font, paint)\n",
    "    paint.setStyle(skia.Paint.kStroke_Style)\n",
    "    path = skia.Path()\n",
    "    path.moveTo(124, 108)\n",
    "    path.lineTo(172, 24)\n",
    "    path.moveTo(36, 148)\n",
    "    path.quadTo(66, 188, 120, 136)\n",
    "    path.close()\n",
    "    path.conicTo(70, 20, 110, 40, 0.6)\n",
    "    canvas.drawPath(path, paint)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Each `Path.moveTo` starts a new `Contour`, and content after `Path.close()` also starts a new `Contour`. Since `Path.conicTo` is not preceded by `Path.moveTo`, the first `Point` of the third `Contour` starts at the last `Point` of the second `Contour`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "show(draw)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If final `PathVerb` in `Contour` is `PathVerb.kClose`, `Line` connects `Path_Last_Point` in `Contour` with first `Point`. A closed `Contour`, stroked, draws `Paint_Stroke_Join` at `Path_Last_Point` and first `Point`. Without `PathVerb.kClose` as final `Verb`, `Path_Last_Point` and first `Point` are not connected; `Contour` remains open. An open `Contour`, stroked, draws `Paint_Stroke_Cap` at `Path_Last_Point` and first `Point`.\n",
    "\n",
    "### Example"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "def draw(canvas: skia.Canvas):\n",
    "    paint = skia.Paint()\n",
    "    paint.setAntiAlias(True)\n",
    "    paint.setStyle(skia.Paint.kStroke_Style)\n",
    "    paint.setStrokeWidth(8)\n",
    "    path = skia.Path()\n",
    "    path.moveTo(36, 48)\n",
    "    path.quadTo(66, 88, 120, 36)\n",
    "    canvas.drawPath(path, paint)\n",
    "    path.close()\n",
    "    canvas.translate(0, 50)\n",
    "    canvas.drawPath(path, paint)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`Path` is drawn stroked, with an open `Contour` and a closed `Contour`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "show(draw)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "`Contour` length is distance traveled from first `Point` to `Path_Last_Point`, plus, if `Contour` is closed, distance from `Path_Last_Point` to first `Point`. Even if `Contour` length is zero, stroked `Lines` are drawn if `Paint_Stroke_Cap` makes them visible.\n",
    "\n",
    "### Example"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAQAAAADACAYAAADr7b1mAAAABHNCSVQICAgIfAhkiAAAATpJREFUeJzt2MEJwkAQBdCvlW0J6djYgZ3EDuJBIV6SwGLcRN+DQGDhM5f5h0kAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgC10SS5JhiTj679UZo0rH7AjXeaXtVTkKQA4kD7zy9pX5CkAOJClZR0+nKcA4M259QArTq0HgF+2hwK4LrzdvjYF0IQjIPy5Ls+D3z3T8a9UZikAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAANjQA0qJVdjqWRx8AAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<IPython.core.display.Image object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "def draw(canvas: skia.Canvas):\n",
    "    paint = skia.Paint()\n",
    "    paint.setAntiAlias(True)\n",
    "    paint.setStyle(skia.Paint.kStroke_Style)\n",
    "    paint.setStrokeWidth(8)\n",
    "    paint.setStrokeCap(skia.Paint.kRound_Cap)\n",
    "    path = skia.Path()\n",
    "    path.moveTo(36, 48)\n",
    "    path.lineTo(36, 48)\n",
    "    canvas.drawPath(path, paint)\n",
    "    path.reset()\n",
    "    paint.setStrokeCap(skia.Paint.kSquare_Cap)\n",
    "    path.moveTo(56, 48)\n",
    "    path.close()\n",
    "    canvas.drawPath(path, paint)\n",
    "    \n",
    "show(draw)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}