Feature Suggestions
If you have suggestions for new features, post them to the forum, where developers and other players will voice their opinions on your idea. Only post them under Requested features if you have first started a forum thread, and definitely don't create a separate page unless it's under your user page.

Mouse placing

This section describes placing. This is when the mouse cursor and the behaviour of mouse clicks are changed. This is mainly used when placing, building and changing things on the map, but also for things like drag'n'drop in vehicle lists etc.

Basics

Placing is initiated by the function:

void SetObjectToPlace(CursorSprite icon, PlaceMode place_mode, byte window_class,uint16 window_num),

or the convenience function:

void SetObjectToPlaceWnd(CursorSprite icon, PlaceMode place_mode, Window *w)

This will:

1. Reset the TileHiglightData (thd), and send the WindowEvent WE_ABORT_PLACE_OBJ to the old window if another place command was running.
2. Change the mouse cursor into icon (if icon is <0, the animated _animcursors[~icon] is selected)

Except for when place_mode == PM_DRAGDROP, the SetObjectToPlace function is normally called by:

bool HandlePlacePushButton(Window *w, int widget, CursorSprite cursor, PlaceMode mode, PlaceProc *placeproc)

placeproc is a callback: void PlaceProc(const TileSelection *), that gets called once the mouse button has been pressed over a map tile (via the windowevent WE_PLACE_OBJ). The TileSelection contains a TileRef and possibly some additional information, like the closest corner, depending on the current placemode.

• TileSelection* as argument to PlaceProc instead of TileRef*

Dragging

Selecting an area by dragging is initiated in the same way as above. Once the mouse button has been pressed, the PlaceProc callback is called and it is here that dragging is initiated by calling:

void VpStartPlaceSizing(const TileSelection *ts, SelectionMode selmode, int user)

During dragging, the WE_PLACE_DRAG window event will be called continuously. In most cases, it just need to do VpSelectTilesWithMethod(ts)

The WE_PLACE_MOUSEUP window event gets called once the mouse button is released.

Both events get the data event.place that contains two TileSelection*:

TileSelection* event.place.tile;        //current
TileSelection* event.place.starttile    //where the dragging started

• TileSelection * instead of TileRef * to VpStartPlaceSizing
• SelectionMode parameter to VpStartPlaceSizing instead of bitsqueezing it into user together with other data
• VpSelectTilesWithMethod no longer takes a SelectionMode as argument
• SelectionMode becomes a named enum

Presizing

Presizing is used by things like tunnels and docks, where the selected area only depends on the start tile. Presizing is initiated by the PM_PRESIZE placemode. When the mouse moves over the viewport, the window event WE_PLACE_PRESIZE gets called continously. In the event handler, the tile selection is updated by calling:

void VpSetPresizeRange(TileSelection *ts_start, TileSelection *ts_end)

• TileSelection * instead of TileRef *
• PM_PRESIZE is new. Previously PM_DRAG was used as a magic number.

Fixed size rectangular areas

Use the placemode PM_RECT followed by a call to:

void SetTileSelectSize(int w, int h);

Displaying catchment area

 void SetTileSelectBigSize(int ox, int oy, int sx, int sy);

The different place modes

Following are the currently implemented placemodes:

• changed PM_POINT into PM_CORNER
• added PM_DRAGDROP (previously undefined value 4 was used)
• added PM_PRESIZE (previously PM_DRAG was used)
• added PM_EDGE, PM_8_POINT, PM_NE_SW, PM_NW_SE