GyTfCQ8x

1<p>Tabletop roleplaying games often require notetaking for specific objects in a scene, or landmarks on a map. Foundry Virtual Tabletop supports the use of placing journal entries on the map to serve as map notes. This page details the process of creating and working with Map Notes (a.k.a. Journal Notes) to notate scenes in FVTT.</p>
2<hr>
3<h2>Creating Notes</h2>
4<p>A Map Note is first made by creating its respective <a rel="nofollow" target="_blank" title="Journal Entries" href="../../../article/journal/">Journal Entry</a> in the directory. The Journal Entry can be dragged from the sidebar onto the scene to create the Map Note. Finally, a dialog window should appear, allowing you to configure the note before it is placed.</p>
5<figure><img alt="The Map Note Configuration Dialog" src="https://i.imgur.com/ENPPXCR.png">
6<figcaption>The Map Note Configuration dialog.</figcaption>
7</figure>
8The details of each option are listed below:
9<p><b>Journal Entry:</b> The Journal Entry assigned to the Map Note. Double clicking the Map Note will bring up the Journal Entry.</p>
10<p><b>Text Label:</b>The label the Map Note will display when moused over. If left empty, the label will default to the name of the Journal Entry.</p>
11<p><b>X/Y-Position:</b> The coordinates for the Map Note on the scene. It is worth noting The Map Note can still be dragged and relocated after placing, making these fields more suitable for fine-tuning the placement of pins.</p>
12<p><b>Entry Icon:</b> The display icon for the Map Note.</p>
13<p><b>Icon Size:</b> The size of the Map Note's icon on the Scene. This is equal to the length of one side of the icon, in pixels.</p> 
14<p><b>Icon Tint:</b> The tint color of the Entry Icon. Empty by default.</p>
15<p><b>Font Size:</b> The font size of the Text Label entered.</p>
16<p><b>Text Anchor Point:</b> The placement of the Text Label relative to the Map Note itself.</p><br>
17<p>A Map Note can be configured again by double right-clicking it.</p>
18<hr>
19<h2>Viewing Notes</h2>
20<p>The visibility of Map Notes are determined by its corresponding Journal Entry - if a player has "Limited" permissions to the Journal Entry, they will be able to view the Map Note. <em>Note that if a player only has Limited permission to a Journal Entry, they will see the Map Note pin, but the Journal Entry will not appear in the sidebar.</em> If a Map Note has no Journal Entry associated with it, the note will be visible to all users currently viewing the scene.</p>
21<p>Map Notes are not always seen straight away - depending on the user's settings, they may only appear while the Journal Notes button is selected in the scene control toolbar. If you wish to see available map notes on the scene at all times, simply click on the Journal Notes button (bookmark icon) in the scene control toolbar, and click "Toggle Notes Display" (magnifying glass icon). Once enabled, notes will always be visible. This setting is <em>per user</em> - each player is able to turn on and off Map Note visibility.</p>
22<hr>
23<h2>Deleting Notes</h2>
24<p>A Map Note can be deleted from a Scene by a Gamemaster by mousing over the note and pressing the Delete key. Alternatively, all Map Notes on the current scene can be deleted by clicking the Map Notes button (bookmark icon) in the scene control toolbar, and clicking "Clear Notes" (trash can icon).</p>
25<p>It is worth noting that deleting a Map Note will not delete the Journal Entry it is assigned to.</p>
26<hr>
27<h2>Notes API</h2>
28<p>Module and system developers for FVTT can interact with the Notes Layer and Map Notes functionality through the Javascript API. See the <a href="../../../../../api/Note.html" rel="nofollow" target="_blank" title="Note API Documentation">Note</a> and <a href="../../../../../api/NotesLayer.html" rel="nofollow" target="_blank" title="Notes Layer API Documentation">Notes Layer</a> API documentation for details.</p>