1

/* $Id$ */

     2

     3

/** @file viewport.cpp */

     4

     5

#include "stdafx.h"

     6

#include "openttd.h"

     7

#include "debug.h"

     8

#include "functions.h"

     9

#include "gui.h"

    10

#include "spritecache.h"

    11

#include "strings.h"

    12

#include "table/sprites.h"

    13

#include "table/strings.h"

    14

#include "landscape.h"

    15

#include "map.h"

    16

#include "viewport.h"

    17

#include "vehicle.h"

    18

#include "station.h"

    19

#include "gfx.h"

    20

#include "town.h"

    21

#include "signs.h"

    22

#include "waypoint.h"

    23

#include "variables.h"

    24

#include "train.h"

    25

#include "roadveh.h"

    26

#include "vehicle_gui.h"

    27

#include "blitter/factory.hpp"

    28

#include "transparency.h"

    29

    30

#define VIEWPORT_DRAW_MEM (65536 * 2)

    31

    32

ZoomLevel _saved_scrollpos_zoom;

    33

    34

/**

    35

 * The maximum number of viewports depends on the maximum number

    36

 * of windows. Technically is could be the maximum number of

    37

 * windows, but there is always at least one window that does

    38

 * not need a viewport. Not having 'support' for that viewport

    39

 * saves some time and memory.

    40

 * For the introduction GUI and create game GUIs there is no

    41

 * need for more than one viewport, however in the normal game

    42

 * and scenario editor one can make a lot of viewports. For the

    43

 * normal game one always has a main toolbar and a status bar,

    44

 * however the statusbar does not exist on the scenario editor.

    45

 *

    46

 * This means that we can only safely assume that there is one

    47

 * window without viewport.

    48

 */

    49

static ViewPort _viewports[MAX_NUMBER_OF_WINDOWS - 1];

    50

static uint32 _active_viewports;    ///< bitmasked variable where each bit signifies if a viewport is in use or not

    51

assert_compile(lengthof(_viewports) < sizeof(_active_viewports) * 8);

    52

    53

/* The in-game coordiante system looks like this *

    54

 *                                               *

    55

 *                    ^ Z                        *

    56

 *                    |                          *

    57

 *                    |                          *

    58

 *                    |                          *

    59

 *                    |                          *

    60

 *                 /     \                       *

    61

 *              /           \                    *

    62

 *           /                 \                 *

    63

 *        /                       \              *

    64

 *   X <                             > Y         *

    65

 */

    66

    67

struct StringSpriteToDraw {

    68

	uint16 string;

    69

	uint16 color;

    70

	StringSpriteToDraw *next;

    71

	int32 x;

    72

	int32 y;

    73

	uint64 params[2];

    74

	uint16 width;

    75

};

    76

    77

struct TileSpriteToDraw {

    78

	SpriteID image;

    79

	SpriteID pal;

    80

	const SubSprite *sub;           ///< only draw a rectangular part of the sprite

    81

	TileSpriteToDraw *next;

    82

	int32 x;

    83

	int32 y;

    84

	byte z;

    85

};

    86

    87

struct ChildScreenSpriteToDraw {

    88

	SpriteID image;

    89

	SpriteID pal;

    90

	const SubSprite *sub;           ///< only draw a rectangular part of the sprite

    91

	int32 x;

    92

	int32 y;

    93

	ChildScreenSpriteToDraw *next;

    94

};

    95

    96

struct ParentSpriteToDraw {

    97

	SpriteID image;                 ///< sprite to draw

    98

	SpriteID pal;                   ///< palette to use

    99

	const SubSprite *sub;           ///< only draw a rectangular part of the sprite

   100

   101

	int32 x;                        ///< screen X coordinate of sprite

   102

	int32 y;                        ///< screen Y coordinate of sprite

   103

   104

	int32 left;                     ///< minimal screen X coordinate of sprite (= x + sprite->x_offs), reference point for child sprites

   105

	int32 top;                      ///< minimal screen Y coordinate of sprite (= y + sprite->y_offs), reference point for child sprites

   106

   107

	int32 xmin;                     ///< minimal world X coordinate of bounding box

   108

	int32 xmax;                     ///< maximal world X coordinate of bounding box

   109

	int32 ymin;                     ///< minimal world Y coordinate of bounding box

   110

	int32 ymax;                     ///< maximal world Y coordinate of bounding box

   111

	int zmin;                       ///< minimal world Z coordinate of bounding box

   112

	int zmax;                       ///< maximal world Z coordinate of bounding box

   113

   114

	ChildScreenSpriteToDraw *child; ///< head of child list;

   115

	bool comparison_done;           ///< Used during sprite sorting: true if sprite has been compared with all other sprites

   116

};

   117

   118

/* Quick hack to know how much memory to reserve when allocating from the spritelist

   119

 * to prevent a buffer overflow. */

   120

#define LARGEST_SPRITELIST_STRUCT ParentSpriteToDraw

   121

assert_compile(sizeof(LARGEST_SPRITELIST_STRUCT) >= sizeof(StringSpriteToDraw));

   122

assert_compile(sizeof(LARGEST_SPRITELIST_STRUCT) >= sizeof(TileSpriteToDraw));

   123

assert_compile(sizeof(LARGEST_SPRITELIST_STRUCT) >= sizeof(ChildScreenSpriteToDraw));

   124

assert_compile(sizeof(LARGEST_SPRITELIST_STRUCT) >= sizeof(ParentSpriteToDraw));

   125

   126

/* Enumeration of multi-part foundations */

   127

enum FoundationPart {

   128

	FOUNDATION_PART_NONE     = 0xFF,  ///< Neither foundation nor groundsprite drawn yet.

   129

	FOUNDATION_PART_NORMAL   = 0,     ///< First part (normal foundation or no foundation)

   130

	FOUNDATION_PART_HALFTILE = 1,     ///< Second part (halftile foundation)

   131

	FOUNDATION_PART_END

   132

};

   133

   134

struct ViewportDrawer {

   135

	DrawPixelInfo dpi;

   136

   137

	byte *spritelist_mem;

   138

	const byte *eof_spritelist_mem;

   139

   140

	StringSpriteToDraw **last_string, *first_string;

   141

	TileSpriteToDraw **last_tile, *first_tile;

   142

   143

	ChildScreenSpriteToDraw **last_child;

   144

   145

	ParentSpriteToDraw **parent_list;

   146

	ParentSpriteToDraw * const *eof_parent_list;

   147

   148

	byte combine_sprites;

   149

   150

	ParentSpriteToDraw *foundation[FOUNDATION_PART_END];                   ///< Foundation sprites.

   151

	FoundationPart foundation_part;                                        ///< Currently active foundation for ground sprite drawing.

   152

	ChildScreenSpriteToDraw **last_foundation_child[FOUNDATION_PART_END];  ///< Tail of ChildSprite list of the foundations.

   153

	Point foundation_offset[FOUNDATION_PART_END];                          ///< Pixeloffset for ground sprites on the foundations.

   154

};

   155

   156

static ViewportDrawer *_cur_vd;

   157

   158

TileHighlightData _thd;

   159

static TileInfo *_cur_ti;

   160

   161

extern void SmallMapCenterOnCurrentPos(Window *w);

   162

   163

static Point MapXYZToViewport(const ViewPort *vp, uint x, uint y, uint z)

   164

{

   165

	Point p = RemapCoords(x, y, z);

   166

	p.x -= vp->virtual_width / 2;

   167

	p.y -= vp->virtual_height / 2;

   168

	return p;

   169

}

   170

   171

void InitViewports()

   172

{

   173

	memset(_viewports, 0, sizeof(_viewports));

   174

	_active_viewports = 0;

   175

}

   176

   177

void DeleteWindowViewport(Window *w)

   178

{

   179

	ClrBit(_active_viewports, w->viewport - _viewports);

   180

	w->viewport->width = 0;

   181

	w->viewport = NULL;

   182

}

   183

   184

void AssignWindowViewport(Window *w, int x, int y,

   185

	int width, int height, uint32 follow_flags, ZoomLevel zoom)

   186

{

   187

	ViewPort *vp;

   188

	Point pt;

   189

	uint32 bit;

   190

   191

	for (vp = _viewports, bit = 0; ; vp++, bit++) {

   192

		assert(vp != endof(_viewports));

   193

		if (vp->width == 0) break;

   194

	}

   195

	SetBit(_active_viewports, bit);

   196

   197

	vp->left = x + w->left;

   198

	vp->top = y + w->top;

   199

	vp->width = width;

   200

	vp->height = height;

   201

   202

	vp->zoom = zoom;

   203

   204

	vp->virtual_width = ScaleByZoom(width, zoom);

   205

	vp->virtual_height = ScaleByZoom(height, zoom);

   206

   207

	if (follow_flags & 0x80000000) {

   208

		const Vehicle *veh;

   209

   210

		WP(w, vp_d).follow_vehicle = (VehicleID)(follow_flags & 0xFFFF);

   211

		veh = GetVehicle(WP(w, vp_d).follow_vehicle);

   212

		pt = MapXYZToViewport(vp, veh->x_pos, veh->y_pos, veh->z_pos);

   213

	} else {

   214

		uint x = TileX(follow_flags) * TILE_SIZE;

   215

		uint y = TileY(follow_flags) * TILE_SIZE;

   216

   217

		WP(w, vp_d).follow_vehicle = INVALID_VEHICLE;

   218

		pt = MapXYZToViewport(vp, x, y, GetSlopeZ(x, y));

   219

	}

   220

   221

	WP(w, vp_d).scrollpos_x = pt.x;

   222

	WP(w, vp_d).scrollpos_y = pt.y;

   223

	WP(w, vp_d).dest_scrollpos_x = pt.x;

   224

	WP(w, vp_d).dest_scrollpos_y = pt.y;

   225

   226

	w->viewport = vp;

   227

	vp->virtual_left = 0;//pt.x;

   228

	vp->virtual_top = 0;//pt.y;

   229

}

   230

   231

static Point _vp_move_offs;

   232

   233

static void DoSetViewportPosition(Window* const *wz, int left, int top, int width, int height)

   234

{

   235

   236

	for (; wz != _last_z_window; wz++) {

   237

		const Window *w = *wz;

   238

   239

		if (left + width > w->left &&

   240

				w->left + w->width > left &&

   241

				top + height > w->top &&

   242

				w->top + w->height > top) {

   243

   244

			if (left < w->left) {

   245

				DoSetViewportPosition(wz, left, top, w->left - left, height);

   246

				DoSetViewportPosition(wz, left + (w->left - left), top, width - (w->left - left), height);

   247

				return;

   248

			}

   249

   250

			if (left + width > w->left + w->width) {

   251

				DoSetViewportPosition(wz, left, top, (w->left + w->width - left), height);

   252

				DoSetViewportPosition(wz, left + (w->left + w->width - left), top, width - (w->left + w->width - left) , height);

   253

				return;

   254

			}

   255

   256

			if (top < w->top) {

   257

				DoSetViewportPosition(wz, left, top, width, (w->top - top));

   258

				DoSetViewportPosition(wz, left, top + (w->top - top), width, height - (w->top - top));

   259

				return;

   260

			}

   261

   262

			if (top + height > w->top + w->height) {

   263

				DoSetViewportPosition(wz, left, top, width, (w->top + w->height - top));

   264

				DoSetViewportPosition(wz, left, top + (w->top + w->height - top), width , height - (w->top + w->height - top));

   265

				return;

   266

			}

   267

   268

			return;

   269

		}

   270

	}

   271

   272

	{

   273

		int xo = _vp_move_offs.x;

   274

		int yo = _vp_move_offs.y;

   275

   276

		if (abs(xo) >= width || abs(yo) >= height) {

   277

			/* fully_outside */

   278

			RedrawScreenRect(left, top, left + width, top + height);

   279

			return;

   280

		}

   281

   282

		GfxScroll(left, top, width, height, xo, yo);

   283

   284

		if (xo > 0) {

   285

			RedrawScreenRect(left, top, xo + left, top + height);

   286

			left += xo;

   287

			width -= xo;

   288

		} else if (xo < 0) {

   289

			RedrawScreenRect(left+width+xo, top, left+width, top + height);

   290

			width += xo;

   291

		}

   292

   293

		if (yo > 0) {

   294

			RedrawScreenRect(left, top, width+left, top + yo);

   295

		} else if (yo < 0) {

   296

			RedrawScreenRect(left, top + height + yo, width+left, top + height);

   297

		}

   298

	}

   299

}

   300

   301

static void SetViewportPosition(Window *w, int x, int y)

   302

{

   303

	ViewPort *vp = w->viewport;

   304

	int old_left = vp->virtual_left;

   305

	int old_top = vp->virtual_top;

   306

	int i;

   307

	int left, top, width, height;

   308

   309

	vp->virtual_left = x;

   310

	vp->virtual_top = y;

   311

   312

	/* viewport is bound to its left top corner, so it must be rounded down (UnScaleByZoomLower)

   313

	 * else glitch described in FS#1412 will happen (offset by 1 pixel with zoom level > NORMAL)

   314

	 */

   315

	old_left = UnScaleByZoomLower(old_left, vp->zoom);

   316

	old_top = UnScaleByZoomLower(old_top, vp->zoom);

   317

	x = UnScaleByZoomLower(x, vp->zoom);

   318

	y = UnScaleByZoomLower(y, vp->zoom);

   319

   320

	old_left -= x;

   321

	old_top -= y;

   322

   323

	if (old_top == 0 && old_left == 0) return;

   324

   325

	_vp_move_offs.x = old_left;

   326

	_vp_move_offs.y = old_top;

   327

   328

	left = vp->left;

   329

	top = vp->top;

   330

	width = vp->width;

   331

	height = vp->height;

   332

   333

	if (left < 0) {

   334

		width += left;

   335

		left = 0;

   336

	}

   337

   338

	i = left + width - _screen.width;

   339

	if (i >= 0) width -= i;

   340

   341

	if (width > 0) {

   342

		if (top < 0) {

   343

			height += top;

   344

			top = 0;

   345

		}

   346

   347

		i = top + height - _screen.height;

   348

		if (i >= 0) height -= i;

   349

   350

		if (height > 0) DoSetViewportPosition(FindWindowZPosition(w) + 1, left, top, width, height);

   351

	}

   352

}

   353

   354

   355

ViewPort *IsPtInWindowViewport(const Window *w, int x, int y)

   356

{

   357

	ViewPort *vp = w->viewport;

   358

   359

	if (vp != NULL &&

   360

	    IsInsideMM(x, vp->left, vp->left + vp->width) &&

   361

			IsInsideMM(y, vp->top, vp->top + vp->height))

   362

		return vp;

   363

   364

	return NULL;

   365

}

   366

   367

static Point TranslateXYToTileCoord(const ViewPort *vp, int x, int y)

   368

{

   369

	Point pt;

   370

	int a,b;

   371

	uint z;

   372

   373

	if ( (uint)(x -= vp->left) >= (uint)vp->width ||

   374

				(uint)(y -= vp->top) >= (uint)vp->height) {

   375

				Point pt = {-1, -1};

   376

				return pt;

   377

	}

   378

   379

	x = (ScaleByZoom(x, vp->zoom) + vp->virtual_left) >> 2;

   380

	y = (ScaleByZoom(y, vp->zoom) + vp->virtual_top) >> 1;

   381

   382

	a = y-x;

   383

	b = y+x;

   384

   385

	/* we need to move variables in to the valid range, as the

   386

	 * GetTileZoomCenterWindow() function can call here with invalid x and/or y,

   387

	 * when the user tries to zoom out along the sides of the map */

   388

	a = Clamp(a, 0, (int)(MapMaxX() * TILE_SIZE) - 1);

   389

	b = Clamp(b, 0, (int)(MapMaxY() * TILE_SIZE) - 1);

   390

   391

	/* (a, b) is the X/Y-world coordinate that belongs to (x,y) if the landscape would be completely flat on height 0.

   392

	 * Now find the Z-world coordinate by fix point iteration.

   393

	 * This is a bit tricky because the tile height is non-continuous at foundations.

   394

	 * The clicked point should be approached from the back, otherwise there are regions that are not clickable.

   395

	 * (FOUNDATION_HALFTILE_LOWER on SLOPE_STEEP_S hides north halftile completely)

   396

	 * So give it a z-malus of 4 in the first iterations.

   397

	 */

   398

	z = 0;

   399

	for (int i = 0; i < 5; i++) z = GetSlopeZ(a + max(z, 4u) - 4, b + max(z, 4u) - 4) / 2;

   400

	for (uint malus = 3; malus > 0; malus--) z = GetSlopeZ(a + max(z, malus) - malus, b + max(z, malus) - malus) / 2;

   401

	for (int i = 0; i < 5; i++) z = GetSlopeZ(a + z, b + z) / 2;

   402

   403

	pt.x = a + z;

   404

	pt.y = b + z;

   405

   406

	return pt;

   407

}

   408

   409

/* When used for zooming, check area below current coordinates (x,y)

   410

 * and return the tile of the zoomed out/in position (zoom_x, zoom_y)

   411

 * when you just want the tile, make x = zoom_x and y = zoom_y */

   412

static Point GetTileFromScreenXY(int x, int y, int zoom_x, int zoom_y)

   413

{

   414

	Window *w;

   415

	ViewPort *vp;

   416

	Point pt;

   417

   418

	if ( (w = FindWindowFromPt(x, y)) != NULL &&

   419

			 (vp = IsPtInWindowViewport(w, x, y)) != NULL)

   420

				return TranslateXYToTileCoord(vp, zoom_x, zoom_y);

   421

   422

	pt.y = pt.x = -1;

   423

	return pt;

   424

}

   425

   426

Point GetTileBelowCursor()

   427

{

   428

	return GetTileFromScreenXY(_cursor.pos.x, _cursor.pos.y, _cursor.pos.x, _cursor.pos.y);

   429

}

   430

   431

   432

Point GetTileZoomCenterWindow(bool in, Window * w)

   433

{

   434

	int x, y;

   435

	ViewPort * vp;

   436

   437

	vp = w->viewport;

   438

   439

	if (in) {

   440

		x = ((_cursor.pos.x - vp->left) >> 1) + (vp->width >> 2);

   441

		y = ((_cursor.pos.y - vp->top) >> 1) + (vp->height >> 2);

   442

	} else {

   443

		x = vp->width - (_cursor.pos.x - vp->left);

   444

		y = vp->height - (_cursor.pos.y - vp->top);

   445

	}

   446

	/* Get the tile below the cursor and center on the zoomed-out center */

   447

	return GetTileFromScreenXY(_cursor.pos.x, _cursor.pos.y, x + vp->left, y + vp->top);

   448

}

   449

   450

/** Update the status of the zoom-buttons according to the zoom-level

   451

 * of the viewport. This will update their status and invalidate accordingly

   452

 * @param w Window pointer to the window that has the zoom buttons

   453

 * @param vp pointer to the viewport whose zoom-level the buttons represent

   454

 * @param widget_zoom_in widget index for window with zoom-in button

   455

 * @param widget_zoom_out widget index for window with zoom-out button */

   456

void HandleZoomMessage(Window *w, const ViewPort *vp, byte widget_zoom_in, byte widget_zoom_out)

   457

{

   458

	w->SetWidgetDisabledState(widget_zoom_in, vp->zoom == ZOOM_LVL_MIN);

   459

	w->InvalidateWidget(widget_zoom_in);

   460

   461

	w->SetWidgetDisabledState(widget_zoom_out, vp->zoom == ZOOM_LVL_MAX);

   462

	w->InvalidateWidget(widget_zoom_out);

   463

}

   464

   465

/**

   466

 * Draws a ground sprite at a specific world-coordinate.

   467

 *

   468

 * @param image the image to draw.

   469

 * @param pal the provided palette.

   470

 * @param x position x of the sprite.

   471

 * @param y position y of the sprite.

   472

 * @param z position z of the sprite.

   473

 * @param sub Only draw a part of the sprite.

   474

 *

   475

 */

   476

void DrawGroundSpriteAt(SpriteID image, SpriteID pal, int32 x, int32 y, byte z, const SubSprite *sub)

   477

{

   478

	ViewportDrawer *vd = _cur_vd;

   479

	TileSpriteToDraw *ts;

   480

   481

	assert((image & SPRITE_MASK) < MAX_SPRITES);

   482

   483

	if (vd->spritelist_mem >= vd->eof_spritelist_mem) {

   484

		DEBUG(sprite, 0, "Out of sprite memory");

   485

		return;

   486

	}

   487

	ts = (TileSpriteToDraw*)vd->spritelist_mem;

   488

   489

	vd->spritelist_mem += sizeof(TileSpriteToDraw);

   490

   491

	ts->image = image;

   492

	ts->pal = pal;

   493

	ts->sub = sub;

   494

	ts->next = NULL;

   495

	ts->x = x;

   496

	ts->y = y;

   497

	ts->z = z;