Editor/Tileset/TilesetEditorContent.cs

The TilesetEditorContent is a UI widget that displays and manages the properties and tiles of a tileset resource. It allows users to configure tile data, apply global tags, and define rectangle coordinates on the tileset image.

File Access
using Editor;
using Saandy.Tilemapper;
using Sandbox;

namespace Saandy.Editor.Tilemapper;

public sealed class TilesetEditorContent : Widget
{
	private Asset _asset;
	private TilesetResource _tileset;

	private ControlSheet _sheet;
	private TilesetGlobalTagsWidget _globalTagsWidget;
	private TilesetRectOrderWidget _rectWidget;

	public TilesetEditorContent( Widget parent ) : base( parent )
	{
		Layout = Layout.Row();
		Layout.Margin = 8;
		Layout.Spacing = 8;

		MinimumWidth = 920;
		VerticalSizeMode = SizeMode.Flexible;
		HorizontalSizeMode = SizeMode.Flexible;
	}

	public void SetAsset( Asset asset )
	{
		_asset = asset;
		_tileset = asset?.LoadResource<TilesetResource>();

		Rebuild();
	}

	[EditorEvent.Hotload]
	private void OnHotload()
	{
		if ( _asset != null )
			_tileset = _asset.LoadResource<TilesetResource>();

		Rebuild();
	}

	private void Rebuild()
	{
		if ( Layout == null )
			return;

		Layout.Clear( true );

		if ( _tileset == null )
		{
			Layout.Add( new Label( "No TilesetResource loaded.", this ) );
			return;
		}

		var splitter = Layout.Add( new Splitter( this ) { IsHorizontal = true }, 1 );
		var settingsScroll = new ScrollArea( splitter )
		{
			MinimumWidth = 260,
			Width = 420,
			HorizontalSizeMode = SizeMode.Flexible,
			HorizontalScrollbarMode = ScrollbarMode.Off,
			VerticalScrollbarMode = ScrollbarMode.Auto
		};
		splitter.AddWidget( settingsScroll );
		splitter.SetStretch( 0, 0 );
		// Let property rows follow the splitter width instead of keeping a wider,
		// horizontally scrolled canvas underneath the workspace.
		var settings = new Widget( settingsScroll )
		{
			Layout = Layout.Column(),
			HorizontalSizeMode = SizeMode.Flexible,
			VerticalSizeMode = SizeMode.CanGrow
		};
		settings.Layout.Margin = 8;
		settings.Layout.Spacing = 12;
		settingsScroll.Canvas = settings;

		var workspaceScroll = new ScrollArea( splitter )
		{
			MinimumWidth = 280,
			HorizontalSizeMode = SizeMode.Flexible,
			VerticalSizeMode = SizeMode.Flexible,
			HorizontalScrollbarMode = ScrollbarMode.Auto,
			VerticalScrollbarMode = ScrollbarMode.Auto
		};
		splitter.AddWidget( workspaceScroll );
		splitter.SetStretch( 1, 1 );
		var workspace = new Widget( workspaceScroll ) { Layout = Layout.Column(), MinimumWidth = 560, VerticalSizeMode = SizeMode.CanGrow };
		workspace.Layout.Margin = 8;
		workspace.Layout.Spacing = 8;
		workspaceScroll.Canvas = workspace;
		var title = new Label( "Tileset Editor", settings );
		title.SetStyles( "font-size: 22px; font-weight: 700; margin-bottom: 8px;" );
		settings.Layout.Add( title );

		var brushTemplate = TileBrushEditorTemplates.Get( _tileset.BrushType );

		var brushInfo = new Label(
			brushTemplate != null
				? $"{brushTemplate.Title}: {brushTemplate.Description}"
				: "No brush template selected.",
			settings
		);
		brushInfo.WordWrap = true;
		brushInfo.SetStyles( "color: #ddd; margin-bottom: 6px;" );
		settings.Layout.Add( brushInfo );

		var serializedObject = _tileset.GetSerialized();

		_sheet = new ControlSheet();
		_sheet.AddObject( serializedObject, prop =>
		{
			if ( prop.HasAttribute<HideAttribute>() )
				return false;

			if ( prop.Name == nameof( TilesetResource.Tiles ) )
				return false;

			if ( prop.Name == nameof( TilesetResource.GlobalTags ) )
				return false;

			return prop.HasAttribute<PropertyAttribute>();
		} );

		serializedObject.OnPropertyChanged += prop =>
		{
			if ( prop != null && prop.Name == nameof( TilesetResource.FilePath ) )
			{
				_tileset.ClearTextureCache();
				_rectWidget?.Refresh();
				MarkChanged();
				return;
			}

			if ( prop != null && prop.Name == nameof( TilesetResource.BrushType ) )
			{
				MarkChanged();
				Rebuild();
				return;
			}

			MarkChanged();
		};

		settings.Layout.Add( _sheet );

		_globalTagsWidget = new TilesetGlobalTagsWidget( settings, _tileset, MarkChanged );
		settings.Layout.Add( _globalTagsWidget );

		_rectWidget = new TilesetRectOrderWidget( _tileset, brushTemplate, MarkChanged )
		{
			MinimumWidth = 560
		};

		var buttonRow = workspace.Layout.Add( Layout.Row() );
		buttonRow.Spacing = 6;

		var generateButton = new Button( "Generate Grid Rects", "grid_on", this );
		generateButton.ToolTip = "Replace the current rectangles with a grid using Tile Size and Tile Separation.";
		generateButton.Clicked = () =>
		{
			_tileset.GenerateTilesFromGrid();

			MarkChanged();

			_rectWidget?.Refresh();
			_rectWidget?.LoadTemplateFromCurrentOrder();
		};
		buttonRow.Add( generateButton );

		var clearButton = new Button( "Clear Tiles", "delete", this );
		clearButton.Clicked = () =>
		{
			_tileset.ClearTiles();

			MarkChanged();

			_rectWidget?.Refresh();
			_rectWidget?.ClearTemplate();
		};
		buttonRow.Add( clearButton );

		var rectActionRow = workspace.Layout.Add( Layout.Row() );
		rectActionRow.Spacing = 6;

		var addRectButton = new Button( "Add Rect", "add", this );
		addRectButton.ToolTip = "Drag a rectangle on the source image, then add it as a tile.";
		addRectButton.Clicked = () => _rectWidget?.AddPendingRect();
		rectActionRow.Add( addRectButton );

		var deleteTileButton = new Button( "Delete Selected Rect", "delete", this );
		deleteTileButton.Clicked = () => _rectWidget?.DeleteSelectedTile();
		rectActionRow.Add( deleteTileButton );

		if ( _rectWidget.HasTemplate )
		{
			var loadOrderButton = new Button( "Load Current Order", "refresh", this );
			loadOrderButton.Clicked = () => _rectWidget?.LoadTemplateFromCurrentOrder();
			rectActionRow.Add( loadOrderButton );

			var applyOrderButton = new Button( "Apply Template Order", "done", this );
			applyOrderButton.ToolTip = "Save the tiles in the order assigned to the brush template slots.";
			applyOrderButton.Clicked = () => _rectWidget?.ApplyTemplateOrder();
			rectActionRow.Add( applyOrderButton );
		}

		workspace.Layout.Add( _rectWidget, 1 );

		settings.Layout.Add( new Label( "Changes are saved automatically.", settings ) );
		settings.Layout.AddStretchCell();
	}

	private void MarkChanged()
	{
		if ( _tileset == null )
			return;

		_tileset.InternalUpdateTiles();
		_tileset.StateHasChanged();

		SaveAsset();

		Update();
	}

	private void SaveAsset()
	{
		if ( _asset == null || _tileset == null )
			return;

		_asset.SaveToDisk( _tileset );
	}
}