{"_id":"55093f331c38c50d006118a5","project":"55093b151c38c50d00611894","__v":9,"category":{"_id":"55093ee2961f17170070abb9","__v":1,"pages":["55093f331c38c50d006118a5"],"project":"55093b151c38c50d00611894","version":"55093b161c38c50d00611897","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-03-18T09:01:22.139Z","from_sync":false,"order":1,"slug":"slate-presentation","title":"Slate Presentation"},"user":"55093a63a4ae180d00c0eaf5","version":{"_id":"55093b161c38c50d00611897","project":"55093b151c38c50d00611894","__v":4,"createdAt":"2015-03-18T08:45:10.369Z","releaseDate":"2015-03-18T08:45:10.368Z","categories":["55093b161c38c50d00611898","55093ee2961f17170070abb9","55093ee9961f17170070abba","55093ef52ee8bf2b00491916"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["5509ab9f2dd6a11900e6e87c"],"next":{"pages":[],"description":""},"createdAt":"2015-03-18T09:02:43.944Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"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[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/S4bDa3M7Rl6vGrqgHkFT_notice-part.jpg\",\n        \"notice-part.jpg\",\n        \"1037\",\n        \"500\",\n        \"#4a8e65\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\n### The ISKN Slate\n\nThe Slate is a sensitive surface that can be used to recognize and track objects embedding ISKN certified magnets.\n\nThe main components of the Slate are:\n\n#### Leds\nThere are two leds on the left side of the Slate :\n- A RGB led indicating the Slate current mode.\n- A white led indicating the Slate activity.\n\n#### Switch\nThere is a three positions switch on the left side of the Slate :\n- The bottom position is the OFF mode.\n- The middle position is the STAND ALONE mode. In this mode, the Slate saves the sketches in its internal memory or in an SD card.\n- The upper position is the LIVE MODE. In this mode, the Slate waits for a PC or tablet to connect through USB or Bluetooth Low Energy.\n\n#### Buttons\nThere are two buttons on the left side of the Slate:\n- Button 1, used by the iSketchnote application as New Page button. When pressed, the application creates a new page.\n- Button 2, used by the iSketchnote application as New Layer button. When pressed, the application creates a new layer.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/zN1D5jNXRvW5Vm7jDnri_slate-buttons.png\",\n        \"slate-buttons.png\",\n        \"752\",\n        \"57\",\n        \"#f58341\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\nThe Button 1 is also used to refresh the Slate when is pressed continuously at least for 2 seconds.\n\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]\n\n\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## 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/bcNYTo9WSAy7hIwiC1sh_pens-eclatee.jpg\",\n        \"pens-eclatee.jpg\",\n        \"600\",\n        \"176\",\n        \"#3c3d3d\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\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/7vKbvpPGT7S1w8k4vz4C_slate%20reference.png\",\n        \"slate reference.png\",\n        \"516\",\n        \"283\",\n        \"#ed6e2b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\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/2rwlqrDYQLm8xFv98bks_slate-angles.png\",\n        \"slate-angles.png\",\n        \"944\",\n        \"540\",\n        \"#94816b\",\n        \"\"\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 [block:image] { "images": [ { "image": [ "https://files.readme.io/S4bDa3M7Rl6vGrqgHkFT_notice-part.jpg", "notice-part.jpg", "1037", "500", "#4a8e65", "" ] } ] } [/block] ### The ISKN Slate The Slate is a sensitive surface that can be used to recognize and track objects embedding ISKN certified magnets. The main components of the Slate are: #### Leds There are two leds on the left side of the Slate : - A RGB led indicating the Slate current mode. - A white led indicating the Slate activity. #### Switch There is a three positions switch on the left side of the Slate : - The bottom position is the OFF mode. - The middle position is the STAND ALONE mode. In this mode, the Slate saves the sketches in its internal memory or in an SD card. - The upper position is the LIVE MODE. In this mode, the Slate waits for a PC or tablet to connect through USB or Bluetooth Low Energy. #### Buttons There are two buttons on the left side of the Slate: - Button 1, used by the iSketchnote application as New Page button. When pressed, the application creates a new page. - Button 2, used by the iSketchnote application as New Layer button. When pressed, the application creates a new layer. [block:image] { "images": [ { "image": [ "https://files.readme.io/zN1D5jNXRvW5Vm7jDnri_slate-buttons.png", "slate-buttons.png", "752", "57", "#f58341", "" ] } ] } [/block] The Button 1 is also used to refresh the Slate when is pressed continuously at least for 2 seconds. 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. ## 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/bcNYTo9WSAy7hIwiC1sh_pens-eclatee.jpg", "pens-eclatee.jpg", "600", "176", "#3c3d3d", "" ] } ] } [/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/7vKbvpPGT7S1w8k4vz4C_slate%20reference.png", "slate reference.png", "516", "283", "#ed6e2b", "" ] } ] } [/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/2rwlqrDYQLm8xFv98bks_slate-angles.png", "slate-angles.png", "944", "540", "#94816b", "" ] } ] } [/block]