Inking Onenote For Mac

admin
-->

Inking has been added to OneNote for Mac: Today, we’re launching ink in OneNote for Mac for the first time, bringing to life one of our top user requests. Now you can write, draw and highlight. Handwrite your notes, annotate documents, or sketch out your next big idea. Get creative with a variety of tools and effects. The natural feel of pen and paper meets the power of digital ink. OneNote takes its appearance based on your system preferences in MacOS. If you want to use Dark Mode with OneNote, your Mac must be running with MacOS. Get OneNote for free! Works on Windows 7 or later and OS X Yosemite 10.10 or later.

Applies to Consumer notebooks on OneDrive Enterprise notebooks on Microsoft 365

You can use img, object, and iframe elements to add images, videos, and files to a OneNote page when you're creating or updating the page.

  • Use img to render an image on the page.
  • Use iframe to embed a video on the page.
  • Use object to add a file attachment to the page.

Adding images

Images can be added by URL reference or by sending raw data. Microsoft Graph supports the following methods of adding images, logos, and photos to OneNote pages.

Use img with src='https://image-url' and specify the URL of a publicly accessible image. Renders the image on the OneNote page.

Use img with src='name:image-block-name' and send the image file in a data part of a multipart request. Renders the image on the OneNote page.

Use img with data-render-src='https://webpage-url' and specify the URL of a webpage. Renders a snapshot of the whole webpage on the OneNote page.

Use img with data-render-src='name:html-block-name' and send HTML in the data part of a multipart request. Renders the HTML as an image on the OneNote page.

Use <img /> and send the PDF file in the data part of a multipart request. Renders each PDF page as a separate image on the OneNote page.

Use object with data='name:file-block-name' type='media-type' and send an image file in the data part of a multipart request. Adds a file attachment to the OneNote page and displays a file icon.

Note:To get images on a OneNote page, first send a GET request for the page content. This returns the URLs to the image resources on the page. You then separate GET requests to the image resources.

Image attributes

An img element can optionally include alt, height, and width attributes, and the style attributes max-width and max-height.

Inking Onenote For Mac

Image media types

Microsoft Graph supports TIFF, PNG, GIF, JPEG, and BMP image types. To capture an image that uses a different format that you don't want to convert, send the binary data in a multipart request. You don't need to use Base64 or otherwise encode the binary data that you send.

Note:The API detects the original input image type, and returns it as the data-fullres-src-type attribute in the output HTML. The API also returns the image type of the optimized image in data-src-type.

See limitations that apply when creating pages that contain media.

Add a public image from the web

In the input HTML of your request, include <img src='https://..' /> and specify the URL of a publicly accessible image for the src attribute.

Add an image using binary data

In the input HTML of your request's Presentation part, include <img src='name:part-name' />, where part-name is the unique identifier for the data part in your multipart request that contains the binary image data. Just send the binary data, don't use Base64 or otherwise encode it.

Add a webpage snapshot

You can use Microsoft Graph to snapshot entire webpages and insert them into new pages. This method is useful to archive webpages or capture complex webpages that have features that OneNote doesn't support (like some CSS).

In the input HTML of your request, include <img src='https://..' /> and specify the URL of the webpage you want to insert for the src attribute.

Add an image rendered from HTML

When you pass the HTML as a />, where part-name is the unique identifier for the data part in your multipart request that contains the HTML.

Add an image file as an attachment

Shortcut

In the input HTML of your request's Presentation part, include <object data='name:part-name' type='media-type/media-subtype' />, where part-name is the unique identifier for the data part in your multipart request that contains the binary image data. Just send the binary data, don't use Base64 or otherwise encode it.

Learn more about file media types.

Adding videos

You can embed videos in OneNote pages using <iframe /> in the input HTML.

Supported video sites

  • Dailymotion
  • Office Mix
  • Sway
  • Sketchfab
  • TED
  • YouTube
  • Vimeo
  • Vine

iframe attributes

data-original-src

Required. The URL of the video.

Example: data-original-src='https://www.youtube.com/watch?v=3Ztr44aKmQ8'

Inking Onenote For Mac Shortcut

width

Optional. The width of the iframe that contains the video. Default is 480.

Example: width='300'

height

Optional. The height of the iframe that contains the video. Default is 360.

Example: height='300'

Example

In the input HTML of your request, include <iframe /> and specify the URL of the video for the data-original-src attribute.

Adding files

You can add file attachments to OneNote pages using an object element in the input HTML. If you're adding a PDF file, you can use an img element to render the PDF pages as images.

Use <object ../> and send the file in a data part of a multipart request. Adds a file attachment that displays a file icon on the OneNote page.

Use <img /> and send a PDF file in the data part of a multipart request. Renders each PDF page as a separate image on the OneNote page.

File attributes

The object element requires the following attributes.

data-attachment

The file name and extension to display on the OneNote page.

Example: data-attachment='filename.docx'

data

The name of the body part in the multipart request that contains the binary file data. Microsoft Graph does not support passing a URL reference here.

Example: data='name:part-name'

type

The file media type, used to determine the file icon to use on the page, and which application starts when the user activates the file on the device from OneNote.

Example: type='application/pdf'

Ms Onenote For Mac

File media types

Microsoft Graph uses predefined file-types icon for attached files, or a generic icon when the API doesn't recognize the file type. The following table shows some common file types that are recognized by the API.

  • application/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • image/png
  • image/jpeg
  • image/gif
  • audio/wav
  • video/mp4
  • application/msword
  • application/mspowerpoint
  • application/excel

See limitations that apply when creating pages that contain media.

Add a file attachment

Free

In the input HTML of your request's Presentation part, include <object data='name:part-name' type='media-type/media-subtype' />, where part-name is the unique identifier for the data part in your multipart request that contains the binary file data. Just send the binary data, don't use Base64 or otherwise encode it.

Add images of PDF file contents

In the input HTML of your request's Presentation part, include <img .. />, where part-name is the unique identifier for the data part in your multipart request that contains the binary file data. Just send the binary data, don't use Base64 or otherwise encode it.

Size limitations for POST pages requests

When sending image and file data, be aware of these limitations:

  • The Microsoft Graph REST API has a 4 MB request limit. Anything above this will fail with the error message 'request too large (413)'.

  • The request limit of the underlying OneNote REST API is higher, but you cannot access it via the Microsoft Graph API.

    • The total POST size limit is ~70 MB, including images, files, and other data. The actual limit is affected by downstream encoding, so there's no fixed byte-count limit. Requests that exceed the limit might produce unreliable results.
    • The limit for each data part is 25 MB, including the part headers. Data parts that exceed the limit are rejected by Microsoft Graph.
  • The maximum number of images per page is 150. When using the src='https://..' attribute, the API ignores img tags beyond the limit.

  • The maximum number of data parts is 6 per POST, including the required Presentation part.

  • Each request can contain up to five img elements that use data-render-src and one object elements that uses data-render-src. Additional image and file references are ignored.

  • The maximum number of images in a single POST is 30, no matter which method you use to send them to the API. Additional images are ignored. If you want to capture a webpage that contains a lot of images, consider capturing the whole page as a snapshot.

When to use HTML versuss just not the same.
  • Snapshot-in-time for historical or archival purposes is usually best done with the data-render-src method.

  • Marking-up a web page design for revisions is one place the data-render-src truly shines. Using OneNote's inking capabilities, you can draw on the image to indicate changes or call out important areas. Having the web page as an image makes that a lot easier.

  • Very large images, or images in formats that OneNote doesn't directly accept, can sometimes be thumbnailed and converted with the data-render-src attribute more easily than by doing it in your own code. Even if the image is also available online, embedding the data in your POST can sometimes make the captured page available to OneNote users sooner, by reducing the total number of round-trips needed to build the OneNote page.

  • Sometimes, the best way to determine which method will work best for your users is to try it both ways as you develop your app.

    Permissions

    To create or update OneNote pages, you'll need to request appropriate permissions. Choose the lowest level that your app needs to do its work.

    Permissions for POST pages

    • Notes.Create
    • Notes.ReadWrite
    • Notes.ReadWrite.All

    Permissions for PATCH pages

    • Notes.ReadWrite
    • Notes.ReadWrite.All

    For more information about permission scopes and how they work, see OneNote permission scopes.

    See also

    While Macs don’t have a touchscreen, you can use your mouse or trackpad with OneNote for Mac to write notes, highlight portions of text, or draw shapes anywhere on a page.

    Note: OneNote for Mac doesn't currently support converting handwriting to text.

    Do the following:

    Inking onenote for mac versions
    1. On the ribbon, click the Draw tab.

      Note: If you don’t see the Draw tab, you may need to update to the latest version of OneNote for Mac. Check for updates

    2. Select the drawing tool you want to use. There’s a Pen, a Marker, and a Highlighter.

    3. After you’ve chosen your preferred drawing tool, customize your drawing style by doing any of the following: H force keygen download for windows.

      • Select a basic drawing color by clicking one of the four color dots

      • Select a custom color by clicking the arrow next to the Ink Color button and choosing the exact color you want to use. After selecting a custom color, clicking the Ink Color button will apply that color to any other ink strokes you have selected. To change your custom color selection, click the arrow next to the button again.

      • Select the stroke thickness for your selected drawing tool by clicking one of the wavy line samples. You can make a new selection at any time to begin drawing with a different stroke thickness.

    4. To erase any parts of a drawing, click the arrow to the right of the Eraser tool, choose the eraser size that you want, and then draw over the ink strokes that you want to erase.

    5. To select any parts of a drawing, either to modify or move them, click the Lasso Select button, drag a selection around the ink strokes you want, and then Control-click the selection for more options.

    6. To erase any parts of a drawing, tap the Eraser tool, and then drag the eraser over the ink strokes that you want to remove.

    7. To stop drawing at any time, click the Text Mode button on the far left of the Draw tab.

      Tip: To return to text mode quickly, on the keyboard, press the Esc key.