AGS 4: script functions for getting local object coordinates

[ivan-mogilko]

Because in AGS 4.0 game objects may be rotated, it becomes difficult for the user to script getting relative object's pixel from the known screen/room coordinates. We should add member functions, similar to ScreenToRoomPoint, but they will convert from the coordinate space in which the object is positioned (screen or room respectively) to object's relative coordinate; and the one that does opposite conversion.

[ericoporto]

This concept is interesting but it looks really hard to come up with a good name. Just to see if I got it right, if you want to get the position of a pixel in the object surface but in the screen, you would use this, and conversely, if you have a pixel position in the screen but want to know it relatively to an object "surface" coordinate system, then you would use the other method?

If either point map to a point outside of the boundaries - either the object or the screen - this would return null?

[ivan-mogilko]

Yes, that sounds right. Just a small note: for room elements it converts from room coords to object local coords. So if you wish to begin with screen coordinates, then you have to do it in two steps: screen -> room -> object.

Names could be like RoomToObjectPoint, and similar, for consistency with existing ones:
https://adventuregamestudio.github.io/ags-manual/Screen.html#screenroomtoscreenpoint