Skip to content

Commit

Permalink
docs: Clean up 'Using Infinite Maps' page content for clarity (mapedi…
Browse files Browse the repository at this point in the history
  • Loading branch information
jaredcaraway authored Jan 9, 2024
1 parent c462761 commit 4fd5551
Showing 1 changed file with 21 additions and 24 deletions.
45 changes: 21 additions & 24 deletions docs/manual/using-infinite-maps.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,57 +5,54 @@
Using Infinite Maps
===================

Infinite maps give you independence from bounds of the map. The canvas is
"auto-growing", which basically means, that you have an infinite grid which
can be painted upon without worrying about the width and height of the map.
The bounds of a particular layer get expanded whenever tiles are painted
outside the current bounds.
Infinite maps in Tiled free you from the constraints of the fixed-size map.
With an "auto-growing" canvas, you can paint on an infinite grid without being
limited by width and height. This document guides you through creating, editing,
and converting infinite maps in Tiled.

.. figure:: images/infinite/infinite-map-overview.png
:alt: Infinite Maps Overview
:alt: A zoomed-out Tiled window shows a very large infinite map being edited.

Creating an Infinite Map
------------------------

In the order to create an infinite map, make sure the 'Infinite' option is
selected in New Map dialog.
1. Open the New Map dialog (*File -> New -> New Map*).
2. Ensure the 'Infinite' option is selected.

.. figure:: images/infinite/infinite-new.png
:alt: New Infinite Map
:alt: Tiled's New Map dialog window is shown. For the option "Map Size," the Infinite radio button is selected rather than Fixed.
:scale: 66

The newly created map will then have an infinite canvas.
The map you create will have an infinite canvas.

Editing the Infinite Map
Editing an Infinite Map
------------------------

Except for the :ref:`bucket-fill-tool`, all tools works exactly in the
same way as in the fixed-size maps. The Bucket Fill Tool fills the
current bounds of that particular tile layer. These bounds get increased
upon further painting of that tile layer.
Most tools in Tiled work the same way for infinite maps as they do for fixed-size maps.
However, the :ref:`bucket-fill-tool` fills only the current bounds of a tile layer.
As you paint, these bounds expand.

.. figure:: images/infinite/infinite-demo.gif
:alt: Infinite Maps Editing
:alt: An animation shows an infinite Tiled map being edited.

Conversion from Infinite to Finite Map and Vice Versa
Converting Between Infinite And Fixed-Size Maps
-----------------------------------------------------

In the map properties, you can toggle whether the map should be infinite
or not. When converting from infinite to a finite map, the width and
height of the final map are chosen on the basis of bounds of all the
tile layers.
You can toggle between infinite and fixed-size maps in the Map Properties window.
When converting an infinite map to a fixed-size map, Tiled determines the final map's
width and height based on the bounds of all tile layers.

.. figure:: images/infinite/infinite-map-initial.png
:alt: Initial Map
:alt: An initial view of an infinite map being edited in Tiled. The grid extends beyond the bounds of the editing window.

The Initial Infinite Map

.. figure:: images/infinite/infinite-map-conversion.png
:alt: Properties
:alt: Close-up of Map Properties panel showing the Infinite option's checkbox checked.

Unchecking the Infinite property in Map Properties

.. figure:: images/infinite/infinite-map-converted.png
:alt: Final Map
:alt: An infinite map in Tiled has been converted to finite. The grid is fully contained and does not extend beyond the bounds of the editing window.

The Converted Map

0 comments on commit 4fd5551

Please sign in to comment.