Creating a New Annotation

  1. Select the view (or slide) that you wish to add the annotation to.
  2. Click the "Widgets" button found in the right-hand toolbar, as highlighted in the image below. This produces the annotation side-panel where you can create/edit/delete annotations.
  3. Select "New Annotation" as shown below. The annotation by default is a blue rectangle with the caption "Your text here".
  4. By default, the annotation is placed in the foreground, on top of the items. However, you can change the layer to which it belongs (see "Customizing Your Annotation" below).

 

 


Customizing Your Annotation

The annotation side-panel allows you to customise the annotation using several options. Each edit made to the annotation saves as you go so each edit can be undone independently using the undo/redo buttons on the story toolbar.

Standard Editing Options

When an annotation is selected, all the standard editing options are displayed in the annotation side-panel which allows you to transform the annotation into a powerful addition to the view/slide.

 

Background - Choose the background color for the object. Use "Auto" for a transparent background.

 

Image - Only one image can be added to an annotation. The image will always sit behind the annotation’s text. You can:

  • Browse your image library to select or upload an image (i.e. PNG or JPG).
  • Copy an image (E.g. from a PPT presentation or document) to the Windows clipboard and press the Paste image button to add it to the annotation.

 

When an image is added, further options become available:

  • Remove Image
  • Image Fit
    • o   Fill Space - This option may clip the image to fit into the annotation shape.
    • o   Show all - This is the default and ensures that the aspect ratio of the image is retained and that it fully fits into the annotation. This may leave empty areas within the annotation.
    • o   Stretch to fit - The image stretches to fill the entire annotation space.

 

Text - Edit the display text and use the formatting options to adjust the various factors such as: 

  • Text style - Font type, size, colour, bold, underline and italic
  • Text Format - Vertical alignment - Top, centered, bottom - and Horizontal alignment - left, centered or right.

 

Note: Operations act on the full text block; you cannot apply different options to one part of the text unless you use HTML coding in-line, such as <i> </i> to italicize a section of the text.

Advanced Editing Options

In the annotations side panel, when an annotation(s) is selected, you can see the editing options. By default the advanced options are not expanded. By clicking anywhere on the "Advanced Options" row, you can expand to show the below options.         

                         

                                           

 

Layer – allows you to move the annotation between the layers using the Foreground and Background buttons.

 

Object Appearance

  • Roundness - By default the corners of the annotations are right angles. Specify a percentage up to 100% to round the corners, as a proportion of the shortest side of the annotation object. For square objects a roundness of 100% will result in a circle.
  • Opacity - Adjust the opacity of the object from its default 100% down to 0% (Transparent).
  • Shadow - Adjust the shadow on the object between 0 and 100%.

 

Click Event -

By default, annotations do not have an associated action when clicked. However, you can specify a URL which turns the annotation into a navigation button. Annotations that have been assigned click events turn the cursor arrow to a pointing finger when moused over. 

 

To assign a click event you can:

  1. Paste in a URL or 
  2. Select a view (from your current story) from the ‘Link to a view’ button.

 

Note: References to views, presentations or items in the current story can be expressed as absolute URLs or relative URLs. Even if you are pasting a full absolute URL (for example to link to a presentation in the story) you should consider editing it down to the relative URL.

 

  1. Why use relative URLs? By using relative URLs, when you take a copy of the story, all relative URLs within the copy story will update to point to the appropriate views/presentations/items in that story
  2. Why use absolute URLs? By using absolute URLs, the click events in your story will retain their pointer to the original views/presentations/items in the original story, or to the specified external locations.

 

When you specify a relative URL or an absolute URL to the current story, the ‘open click event in new tab’ option will default to false (but can be set to true to force the URL to open in a new browser tab), whilst any external URL pasted into the click events field will result in the option beings automatically set to true.

 

Embed URL -

Annotations can be used to embed web documents, in a similar way to HTML panels within items. However, by embedding a URL within an annotation you can control the display (size, accompanying text) and location of the web document within a SharpCloud view.

Typically, you will use this option for annotations that have been placed on a Wall view.

You can embed either a SharpCloud view, presentation or item, or an external web document.

 

Note: the URL you pasted will be hosted within an iFrame. Not all web documents/web sites allow themselves to be embedded in this way and this is not within SharpCloud’s control. If you are working on an on-premises or private cloud instance or accessing a story on our public cloud service but from within your firewall, the access controls imposed by your own IT will determine whether you can access the web site.

 

As with click events, you have the option to use either relative or absolute URLs when referencing a view/presentation/item within the current story. As with click events, the same choice applies:

  1. Why use relative URLs? By using relative URLs, when you take a copy of the story, all relative URLs within the copy story will update to point to the appropriate views/presentations/items in that story
  2. Why use absolute URLs? By using absolute URLs, the click events in your story will retain their pointer to the original views/presentations/items in the original story, or to the specified external locations.

 

Margins -

For annotations containing text, images or both, you can specify margins to determine the position of these elements within the annotation. This allows, for example, an image to be given a margin so it does not reach to the side of the annotation.

 

For both text and image margins you can use up to four percentages (comma separated) to create a margin. These margins equate to North, East, South, West (or top, right, bottom, left). 

 

However, there are separate recommendations when using text or images:

Images

  1. If you specify one percentage figure – this will apply to ALL positions and therefore will result in an equal (percentage) border around the whole image
  2. If you specify two percentage figures – this will apply to North & South, and East & West respectively
  3. If you specify three percentage figures – the third will be ignored
  4. If you specify four percentage figures – this will apply to North, East, South and West respectively

Note: The exact visual impact on the image will depend on other settings selected within the annotation side-panel including the image fit setting.

 

Text

  1. If you specify one percentage figure – this will apply to ALL positions and therefore will result in an equal (percentage) border around the whole text
  2. If you specify two percentage figures – we currently recommend that you only use the settings to create East and West margins (e.g. 0,20,0,20)

 

Note: We currently do not recommend using four percentage figures as there are a number of other text style and format settings that can affect the positioning of the text. If you specify three percentage figures the third will be ignored.