{"_id":"5abba5c00117970012ba9b74","category":{"_id":"5abba5c00117970012ba9b70","version":"5abba5c00117970012ba9b6e","project":"55093b151c38c50d00611894","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-03-18T09:01:22.139Z","from_sync":false,"order":1,"slug":"slate-presentation","title":"Slate Presentation"},"project":"55093b151c38c50d00611894","user":"55093a63a4ae180d00c0eaf5","version":{"_id":"5abba5c00117970012ba9b6e","project":"55093b151c38c50d00611894","__v":2,"createdAt":"2018-03-28T14:25:04.622Z","releaseDate":"2018-03-28T14:25:04.622Z","categories":["5abba5c00117970012ba9b6f","5abba5c00117970012ba9b70","5abba5c00117970012ba9b71","5abba5c00117970012ba9b72","5ace17b040606a0003eabc75"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"githubsync":"","__v":0,"updates":["5509ab9f2dd6a11900e6e87c"],"next":{"pages":[],"description":""},"createdAt":"2015-03-18T09:02:43.944Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"## Introduction\n\nThis page presents the Slate, it describes the hardware and its components as well as notions needed to understand the API.\n\n## Hardware components\n\n### The ISKN Slate\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7409e87-How_it_works_2.png\",\n        \"How it works 2.png\",\n        1500,\n        952,\n        \"#f2f1f1\"\n      ],\n      \"sizing\": \"smart\"\n    }\n  ]\n}\n[/block]\nThe Slate is a sensitive surface that can be used to recognise and track objects embedding ISKN certified magnets.\nWith its 32 sensors, the Slate estimates the position (X,Y,Z) and the orientation (Theta,Phi) of the magnetic ring, and deduces the exact position of your pencil tip.\n\nThe main components of the Slate are shown in the following picture:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e1b18b8-schemaEN_01.png\",\n        \"schemaEN_01.png\",\n        1746,\n        1069,\n        \"#222222\"\n      ]\n    }\n  ]\n}\n[/block]\n#### Leds\nThere are two leds :  \n- A led on the front side of the Slate (Front LED), indicating the Slate activity mode.\n- A led on the left side of the Slate (Side LED), indicating the Slate current mode.\n\n#### Buttons\nThere are three buttons on the Slate:\n- ON/OFF button, used to power on the Slate by a long press and to switch the Slate mode (USB mode, Bluetooth mode ans Standalone mode) by a short press.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9edf715-tuto02_turnOn_your_slate_en.gif\",\n        \"tuto02_turnOn_your_slate_en.gif\",\n        700,\n        394,\n        \"#bfbfbf\"\n      ]\n    }\n  ]\n}\n[/block]\n- Top dot button, used by the Imagink application as New Page button. When pressed, the application creates a new page.\n- Top button, used by the Imagink application as New Layer button. When pressed, the application creates a new layer.\nThe Slate buttons may be used for various purposes as the API gives access to button press events.\n\n\n### Pens\n\nA usable object is defined as an object that contains a ISKN certified magnet. \nTherefore, all kind of objects can be used to interact with the Slate and its applications (pens, figurines...).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/yrFE955kSGNnHr12C66B_slate-pen.png\",\n        \"slate-pen.png\",\n        \"543\",\n        \"474\",\n        \"#eef0ec\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nISKN pens are a specific kind of objects. The Slate handles these pens natively and may determines some specific characteristics such as the pen tip position, and its contact status with the paper surface.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/05eb1d8-tuto05_pen_detection_en.gif\",\n        \"tuto05_pen_detection_en.gif\",\n        700,\n        394,\n        \"#e8e8e8\"\n      ]\n    }\n  ]\n}\n[/block]\n## The Magnet\n\nA magnet is a ferromagnetic object that generates a magnetic field. It is characterized by its two poles that form an axis. \nISKN provides special ring shaped magnets which polarity is used to determine its orientation.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ceffd41-pens-eclatee.jpg\",\n        \"pens-eclatee.jpg\",\n        600,\n        176,\n        \"#393b39\"\n      ]\n    }\n  ]\n}\n[/block]\n## Slate reference frame\nIn order to develop applications that use the object or pen tracking ability of the Slate, it is important to know how the positions and orientations are presented.\n\nEvery object is localized using its 3D coordinates x,y and z. The reference point is in the left top-corner of the Slate. The x axis is pointing from left to right (in portrait mode). The y axis is pointing from up to down. Finally the z axis is perpendicular to the frame and is pointing down.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bae36b1-Slate_XYZ.png\",\n        \"Slate_XYZ.png\",\n        1500,\n        999,\n        \"#9f9f9f\"\n      ]\n    }\n  ]\n}\n[/block]\nThe axis of the ring magnet is defined by two angles:\n-Rx: the angle between the magnet axis and the z axis (from 0° to 180°).\n-Ry: the angle between the projection of the manget axis on the xy plane, and the x axis (from -180° to 180°).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/36856da-Slate_RxRy.png\",\n        \"Slate_RxRy.png\",\n        1500,\n        999,\n        \"#9e9e9d\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"iskn-slate-presentation","type":"basic","title":"ISKN SLATE Presentation"}

ISKN SLATE Presentation


## Introduction This page presents the Slate, it describes the hardware and its components as well as notions needed to understand the API. ## Hardware components ### The ISKN Slate [block:image] { "images": [ { "image": [ "https://files.readme.io/7409e87-How_it_works_2.png", "How it works 2.png", 1500, 952, "#f2f1f1" ], "sizing": "smart" } ] } [/block] The Slate is a sensitive surface that can be used to recognise and track objects embedding ISKN certified magnets. With its 32 sensors, the Slate estimates the position (X,Y,Z) and the orientation (Theta,Phi) of the magnetic ring, and deduces the exact position of your pencil tip. The main components of the Slate are shown in the following picture: [block:image] { "images": [ { "image": [ "https://files.readme.io/e1b18b8-schemaEN_01.png", "schemaEN_01.png", 1746, 1069, "#222222" ] } ] } [/block] #### Leds There are two leds : - A led on the front side of the Slate (Front LED), indicating the Slate activity mode. - A led on the left side of the Slate (Side LED), indicating the Slate current mode. #### Buttons There are three buttons on the Slate: - ON/OFF button, used to power on the Slate by a long press and to switch the Slate mode (USB mode, Bluetooth mode ans Standalone mode) by a short press. [block:image] { "images": [ { "image": [ "https://files.readme.io/9edf715-tuto02_turnOn_your_slate_en.gif", "tuto02_turnOn_your_slate_en.gif", 700, 394, "#bfbfbf" ] } ] } [/block] - Top dot button, used by the Imagink application as New Page button. When pressed, the application creates a new page. - Top button, used by the Imagink application as New Layer button. When pressed, the application creates a new layer. The Slate buttons may be used for various purposes as the API gives access to button press events. ### Pens A usable object is defined as an object that contains a ISKN certified magnet. Therefore, all kind of objects can be used to interact with the Slate and its applications (pens, figurines...). [block:image] { "images": [ { "image": [ "https://files.readme.io/yrFE955kSGNnHr12C66B_slate-pen.png", "slate-pen.png", "543", "474", "#eef0ec", "" ] } ] } [/block] ISKN pens are a specific kind of objects. The Slate handles these pens natively and may determines some specific characteristics such as the pen tip position, and its contact status with the paper surface. [block:image] { "images": [ { "image": [ "https://files.readme.io/05eb1d8-tuto05_pen_detection_en.gif", "tuto05_pen_detection_en.gif", 700, 394, "#e8e8e8" ] } ] } [/block] ## The Magnet A magnet is a ferromagnetic object that generates a magnetic field. It is characterized by its two poles that form an axis. ISKN provides special ring shaped magnets which polarity is used to determine its orientation. [block:image] { "images": [ { "image": [ "https://files.readme.io/ceffd41-pens-eclatee.jpg", "pens-eclatee.jpg", 600, 176, "#393b39" ] } ] } [/block] ## Slate reference frame In order to develop applications that use the object or pen tracking ability of the Slate, it is important to know how the positions and orientations are presented. Every object is localized using its 3D coordinates x,y and z. The reference point is in the left top-corner of the Slate. The x axis is pointing from left to right (in portrait mode). The y axis is pointing from up to down. Finally the z axis is perpendicular to the frame and is pointing down. [block:image] { "images": [ { "image": [ "https://files.readme.io/bae36b1-Slate_XYZ.png", "Slate_XYZ.png", 1500, 999, "#9f9f9f" ] } ] } [/block] The axis of the ring magnet is defined by two angles: -Rx: the angle between the magnet axis and the z axis (from 0° to 180°). -Ry: the angle between the projection of the manget axis on the xy plane, and the x axis (from -180° to 180°). [block:image] { "images": [ { "image": [ "https://files.readme.io/36856da-Slate_RxRy.png", "Slate_RxRy.png", 1500, 999, "#9e9e9d" ] } ] } [/block]