Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Dungeon Draw API"

From Roll20 Wiki

Jump to: navigation, search
(Updating URLs in the Code)
(Updating URLs in the Code)
Line 32: Line 32:
  
 
==Updating URLs in the Code==
 
==Updating URLs in the Code==
1) Download Complete Set the pack from the market.
+
1) Download Complete Set the pack from the market.<br />
 
2) Use the Market bulk uploaded<br />
 
2) Use the Market bulk uploaded<br />
 
<br />
 
<br />
3) Open the API editor in one tab
+
3) Open the API editor in one tab.<br />
4) Open the campaign in another tab.
+
4) Open the campaign in another tab.<br />
5) Use the in game image tool to get to your library.
+
5) Use the in game image tool to get to your library.<br />
6) Search for the "key" you want.
+
6) Search for the "key" you want.<br />
 
6) Right click the one you want and copy the URL.<br />
 
6) Right click the one you want and copy the URL.<br />
 
<br />
 
<br />
7) Edit the script.
+
7) Edit the script.<br />
8) Save... script
+
8) Save... script.<br />
9) In the game reload that texture pack and see if it looks right.
+
9) In the game reload that texture pack and see if it looks right.<br />
 
10) Repeat for each key<br />
 
10) Repeat for each key<br />
 
<br />
 
<br />

Revision as of 12:51, 17 June 2015

Contents

Rectangle and Polygon/Line Tools

Circles and freehand not supported.

This script leverages the Rectangle and Polygon/Line Tools to create dungeon maps based on a selected set of tiles in the API. The WIKI provides more information on the Drawing Tools and can be found here: Drawing Tools

  • Rectangle are supported.
  • Polygon/Line are supported
  • Circles and freehand not supported.
  • Using shift helps
  • Also use transparent fill, this will help when closing a polygon path and gives a visual confirmation the path has be accepted by the API.


Recommendations: Hold the Shift key while using the Shapes tool and have the grid enabled. This will cause your shape to snap to the grid. Use transparent fill, this will help when close a polygon path and give a visual confirmation the path has be accepted by the API.

Split the Party & Player's Bookmark

Recommend using the party split feature to select the page you wish to edit.
Avoid this!! Easy mistake is you (GM) being a page different from your party split avatar.

This script leverages the "Split the Party" and "Player's Bookmark" to determine the active page for editing.

Its is prefered that controlling GM drag-and-drop the "Player Avatar" to the page they which to map with Dungeon Draw. All changes by the API will be applied to that page.

If the controlling GM has not done this, the Player's Bookmark will act as the active page.

Caution: Easy mistake is you (GM) being a page different from your party split avatar (notice the BLUE border.)

PageToolbar SplitThePartyExample.gif

See Page Toolbar for more information.

Loading the Script

  1. Getting the scripts installed:
  2. Start a new campaign
  3. Install the three scripts found here: Dungeon Draw Scripts
  4. Enter the API command "!DungeonDrawMenu"

Updating URLs in the Code

1) Download Complete Set the pack from the market.
2) Use the Market bulk uploaded

3) Open the API editor in one tab.
4) Open the campaign in another tab.
5) Use the in game image tool to get to your library.
6) Search for the "key" you want.
6) Right click the one you want and copy the URL.

7) Edit the script.
8) Save... script.
9) In the game reload that texture pack and see if it looks right.
10) Repeat for each key

Its painful and I am sorry for that hopefully we can get access to image tags (be sure to VOTE)

HINT: Take your time. Do one or two, save and refresh the script. Check as you go.

Important Note: Tile DD_016 (the diagonal tile) repeats three times in the array. This tile is not water marked, however if you choose to replace it you will need to place the same URL in each case.

Code and URL shorted in this example
        ....
        {url: 'https.../thumb.jpg?1430172145', key: 'DD_015', value: 85,  mask: 255, dlBits: 85,  diag: false},
        {url: 'https.../thumb.png?1430172900', key: 'DD_016', value: 248, mask: 255, dlBits: 248, diag: true },
        {url: 'https.../thumb.png?1430172900', key: 'DD_016', value: 240, mask: 255, dlBits: 240, diag: true },
        {url: 'https.../thumb.png?1430172900', key: 'DD_016', value: 120, mask: 255, dlBits: 120, diag: true },
        {url: 'https.../thumb.jpg?1426895538', key: 'DD_017', value: 255,  mask: 0,  dlBits: 255, diag: false},
        ....

Overview

Some info

Water Mark Tile replacement

marketstuff