Line 1: |
Line 1: |
| Returns a dummy [[:Category:gc|graphics context]].<br /> | | Returns a dummy [[:Category:gc|graphics context]].<br /> |
| | | |
− | As a consequence, you are able to use the functions made for the "normal" [[:Category:gc|gc]] | + | As a consequence, you are able to use the functions made for the "normal" [[:Category:gc|gc]]. |
| | | |
| It is typically used to measure pixel lengths and heights of strings when a normal graphics context is not available.<br /> | | It is typically used to measure pixel lengths and heights of strings when a normal graphics context is not available.<br /> |
| This may be the case when creating new text elements when the script app is initialized.<br /> | | This may be the case when creating new text elements when the script app is initialized.<br /> |
− | A graphics context is available only during paint events, and that may be too late to create and size the containers for text fields. | + | A graphics context is available only during paint events, and that may be too late to create and size the containers for text fields.<br /> |
| This graphics context cannot be used to draw graphics since it is not tied to a window. It can however do that if this gc is used in a function called within [[on.paint]]. | | This graphics context cannot be used to draw graphics since it is not tied to a window. It can however do that if this gc is used in a function called within [[on.paint]]. |
| <br /> | | <br /> |
| | | |
− | Here is an example of using the dummy graphics context to get the pixel length and height of a string. | + | Here is an example of using the dummy graphics context to get the pixel length and height of a string : |
| <syntaxhighlight>local gc = platform.gc() -- Get the dummy graphics context | | <syntaxhighlight>local gc = platform.gc() -- Get the dummy graphics context |
| gc:begin() -- Makes it the current graphics context | | gc:begin() -- Makes it the current graphics context |
Line 20: |
Line 20: |
| | | |
| {{Since|3.0}} | | {{Since|3.0}} |
| + | {{ObsoleteSince|3.2}} |
| | | |
| [[Category:platform]] | | [[Category:platform]] |