Leahnaya/porymap
1
0
Fork 0
mirror of https://github.com/huderlem/porymap.git synced 2026-09-30 20:06:56 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

finish region map editor docs

Browse Source
This commit is contained in:
garak
2019-04-29 20:01:32 -04:00
committed by huderlem
parent 41e17ec69e
commit f805f3af37
15 changed files with 115 additions and 999 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
docs/manual/region-map-editor.html
View File

@@ -264,9 +264,9 @@ the tile selector on the right. You can single-click or drag your mouse around
to paint the selected tile onto the region map image. If you make a mistake, or
are unhappy with what you have done, you can undo (<code class="docutils literal notranslate"><span class="pre">Ctrl+Z</span></code> or <em>Edit -&gt; Undo</em>)
and redo (<code class="docutils literal notranslate"><span class="pre">Ctrl+Y</span></code> or <em>Edit -&gt; Redo</em>) your changes. Right-clicking on the map
image will select the tile under your mouse from the tile selector. If you want
to clear the background image, <em>Edit -&gt; Clear Background Image</em> will set all
tiles to the first tile in the tile selector.</p>
image will select the tile under your mouse from the tile selector.</p>
<p>If you want to clear the background image, <em>Edit -&gt; Clear Background Image</em>
will set all tiles to the first tile in the tile selector.</p>
<div class="figure align-center" id="id5">
<a class="reference internal image-reference" href="../_images/rme-painting-image.gif"><img alt="RME Paint" src="../_images/rme-painting-image.gif" style="width: 730.5px; height: 424.5px;" /></a>
<p class="caption"><span class="caption-text">Drawing on the Region Map Image</span></p>
@@ -274,53 +274,72 @@ tiles to the first tile in the tile selector.</p>
<p>It is likely that you will want to use your own tiles for your region map. You
can import a tile image by navigating to <em>Tools -&gt; Import Region Map Image Tiles</em>.
There are strict requirements for your region map tile image. It must (1) be
indexed with a 256 color palette*, (2) composed of 8x8 pixel tiles, (3) have 256
indexed with a 256 color palette*, (2) be composed of 8x8 pixel tiles, (3) have 256
or fewer tiles.</p>
<p>* while the region map tile image requires a 256-color palette, the image only
uses the 32 colors beginning at index 112 in the palette</p>
<p>* While the region map tile image requires a 256-color palette, the image only
uses the 32 colors beginning at index 112 in the palette.</p>
</div>
<div class="section" id="map-layout-tab">
<span id="id2"></span><h2>Map Layout Tab<a class="headerlink" href="#map-layout-tab" title="Permalink to this headline"></a></h2>
<p>The layout tab is where map sections are placed on the region map. When the
player looks at the region map, the layout determines the map under the cursor.</p>
player looks at the region map in-game, the layout determines the map under the
cursor.</p>
<div class="figure align-center" id="id6">
<a class="reference internal image-reference" href="../_images/rme-layout-tab.png"><img alt="RME Layout" src="../_images/rme-layout-tab.png" style="width: 734.25px; height: 429.75px;" /></a>
<p class="caption"><span class="caption-text">RME Layout Tab</span></p>
</div>
<p>To modify the region map layout, select a position by clicking on the map image
and higlighting a single square. The “Map Section” combobox will be populated
with all of the map sections defined in <cite>include/constants/region_map_sections.h</cite>.
with all of the map sections defined in <code class="docutils literal notranslate"><span class="pre">include/constants/region_map_sections.h</span></code>.
Select the map section you want to associate with the selected position on the
region map. To change the popup name of the map section when you enter the map,
type it into the “Map Name” box. The popup name is tied to the map section, so
each layout square with the same map section will share a name.</p>
<p><em>Edit -&gt; Clear Map Layout</em></p>
<p>When you add new region map sections.
<em>Edit -&gt; Swap</em></p>
<p>If you want to start from a blank layout, <em>Edit -&gt; Clear Map Layout</em> will set
all layout squares to the value of <code class="docutils literal notranslate"><span class="pre">MAPSEC_NONE</span></code>.</p>
<p>When adding new region map sections, the layout will be affected. This is
because the layout is stored as a binary file and uses the raw value of each
map section. In order to fix your layout to account for this, you can swap two
values for the entire layout with <em>Edit -&gt; Swap</em>.</p>
<p>In this example, <code class="docutils literal notranslate"><span class="pre">MAPSEC_NEW_MAPSEC</span></code> is inserted before <code class="docutils literal notranslate"><span class="pre">MAPSEC_NONE</span></code>, and
therefore the layout will link the original value of <code class="docutils literal notranslate"><span class="pre">MAPSEC_NONE</span></code> to the new
map section <code class="docutils literal notranslate"><span class="pre">MAPSEC_NEW_MAPSEC</span></code>. Instances of <code class="docutils literal notranslate"><span class="pre">MAPSEC_NEW_MAPSEC</span></code> are swapped
with <code class="docutils literal notranslate"><span class="pre">MAPSEC_NONE</span></code>.</p>
<div class="figure align-center" id="id7">
<a class="reference internal image-reference" href="../_images/rme-layout-swap.gif"><img alt="RME Swap" src="../_images/rme-layout-swap.gif" style="width: 744.0px; height: 439.5px;" /></a>
<a class="reference internal image-reference" href="../_images/rme-layout-swap.gif"><img alt="RME Swap" src="../_images/rme-layout-swap.gif" style="width: 559.5px; height: 495.0px;" /></a>
<p class="caption"><span class="caption-text">Swapping Map Sections</span></p>
</div>
<p>.</p>
<p>The “Delete Square” button simply resets a single layout square to <code class="docutils literal notranslate"><span class="pre">MAPSEC_NONE</span></code>.</p>
</div>
<div class="section" id="map-entries-tab">
<span id="id3"></span><h2>Map Entries Tab<a class="headerlink" href="#map-entries-tab" title="Permalink to this headline"></a></h2>
<p>The other thing</p>
<p>A region map entry is the area on the region map that spans an entire map section.
This determines, for example, where the player’s head appears on the region map
in-game. Entries are stored at <code class="docutils literal notranslate"><span class="pre">src/data/region_map/region_map_entries.h</span></code>.</p>
<div class="figure align-center" id="id8">
<a class="reference internal image-reference" href="../_images/rme-entries-tab.png"><img alt="RME Entries" src="../_images/rme-entries-tab.png" style="width: 734.25px; height: 429.75px;" /></a>
<p class="caption"><span class="caption-text">RME Entries Tab</span></p>
</div>
<p>.</p>
<p>To edit an entry, select a map section from the “Map Section” combobox. You can
use the “Location” “x” and “y” spinboxes to change the coordinates of the entry.
You can also drag the entry around the map. The “x” and “y” values correspond to
the position of the entry’s top-left square on the region map. The “Dimensions”
“width” and “height” spinboxes will change the size of the map entry.</p>
</div>
<div class="section" id="city-maps">
<h2>City Maps<a class="headerlink" href="#city-maps" title="Permalink to this headline"></a></h2>
<p>city maps</p>
<p>In the bottom half of the region map editor window, city maps can be edited.
You paint on this the same way you paint on the region map background image.</p>
<div class="figure align-center" id="id9">
<a class="reference internal image-reference" href="../_images/rme-painting-city.gif"><img alt="City Paint" src="../_images/rme-painting-city.gif" style="width: 482.4px; height: 408.0px;" /></a>
<p class="caption"><span class="caption-text">Drawing on the City Map</span></p>
</div>
<p><em>Tools -&gt; Import City Map Image Tiles</em></p>
<p>To use custom tiles, there is a tile image importer under
<em>Tools -&gt; Import City Map Image Tiles</em>. These images must (1) be indexed with a
16 color palette, (2) be made up of 8x8 pixel tiles, (3) have 256 or fewer tiles.</p>
<p>You can add a new city map by pressing the <img alt="new-city-map-button" src="../_images/rme-new-city-map-button.png" /> button.</p>
<p>Currently, it is not possible to associate a city map to a region map location,
but that functionality will be added in a future update.</p>
</div>
</div>