Changes

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]].

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

local width = gc:getStringWidth(a_string) -- Gets the pixel length of a_string

local width = gc:getStringWidth(a_string)   -- Gets the pixel length of a_string

local height = gc:getStringHeight(a_string)     -- Gets the pixel height of a_string

local height = gc:getStringHeight(a_string) -- Gets the pixel height of a_string

 

-- do things here --

-- do things here --

gc:finish()                               -- Restores previous graphics context</syntaxhighlight>

gc:finish()                                 -- Restores previous graphics context</syntaxhighlight>

It is important to use [[gc:begin]]() to set up the graphics context before using it in the getString routines and to call [[gc:finish]]() to relinquish it when finished with it.

It is important to use [[gc:begin]]() to set up the graphics context before using it in the getString routines and to call [[gc:finish]]() to relinquish it when finished with it.

{{Since|3.0}}

{{Since|3.0}}

[[Category:gc]]

[[Category:platform]]